dsh-kiwix-wiki
查询本地Kiwix离线维基百科 适合需要在无网环境下查询本地ZIM格式维基百科数据库的用户。
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:MingShi350/kiwix-wiki說明文件
閱讀完整 README ↗配置(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 头部注释)。