MingShi350/kiwix-wiki ↗★ 0

dsh-kiwix-wiki

查询本地Kiwix离线维基百科 适合需要在无网环境下查询本地ZIM格式维基百科数据库的用户。

套件
dsh-kiwix-wiki
相容性
待驗證
Cordis 依賴範圍
^4.0.2 || ^4.0.5-0
版本
1.4.1
授權
MIT
最近更新
2026年10月5日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:MingShi350/kiwix-wiki

配置(Config,均可省略取默认值)

config:
  baseUrl: http://127.0.0.1:8090   # kiwix-serve 地址,随时可改
  defaultBook: zh                  # 建议填别名(zh/en/medicine/simple),自动跟随最新版 ZIM
  timeoutMs: 15000
  maxTextChars: 24000
  catalogTtlMs: 60000              # 书库目录缓存毫秒数;调小可更快发现新加入的 ZIM

baseUrl 默认指向本机 http://127.0.0.1:8090。要连局域网/远端服务器只改这一个键,二选一:

  • 写进 profile patch $DSH_HOME/profiles/ /cordis.patch.yml(优先级最高,推荐);
  • 或用叠加文件、不动 profile:dsh web --patch examples/kiwix-wiki.patch.yml。

两种写法的完整示例见 docs/quickstart.md 第 5 节 与 examples/kiwix-wiki.patch.yml。地址不可达时,报错会直接点名 baseUrl。

ZIM 换版不用改配置:defaultBook 推荐写别名(zh)或去掉日期的系列名(wikipedia_zh_all_maxi), 两者都自动选中该系列最新的那一份 dump。若确实填了带日期的精确名(如 wikipedia_zh_all_maxi_2025-09), 而服务器上只剩新版(…_2026-08),插件会回退到同系列最新 dump,并在结果里带一条 note 说明; 显式传给工具的 book 参数永不替换,找不到就报错并列出可用书库。

零依赖:仅使用 Node 内置 node:http / node:https,无 npm 依赖、无构建步骤 (刻意不用 global fetch,原因见 lib/kiwix.js 头部注释)。