dsh-llm-wiki：让 DeepSeek Harness 的 agent 直接管理 LLM-Wiki 个人知识库

dsh-llm-wiki 是 DeepSeek Harness（DSH）的插件（DSH plugin），由 detpecca 维护，采用 MIT 协议，最近更新于 2026-08。它作为薄适配层，让 agent 直接管理 LLM-Wiki 个人知识库，提供检索、阅读、统计、校验、修复、错误本、入库共 7 个工具，解决知识库与 agent 之间缺乏结构化交互的问题。插件本体零运行时依赖（纯 ESM，无构建步骤），通过 DSH 的 subprocess 服务调用 DSH-Wiki 引擎 CLI 的 --json 通道，引擎负责结构化信号检索（页名/别名/标签/摘要加权打分）和论文算法 1 编译流程，保持唯一权威。

dsh-llm-wiki 这个 DSH plugin 支持哪些核心工具？

插件暴露 7 个工具：wiki_search（结构化信号打分检索，支持 CJK 分词）、wiki_read（批量读页/目录索引，跟随 [[wikilink]]）、wiki_stats（页面/分类/digest/错误本统计）、wiki_validate（4 类确定性结构校验）、wiki_fix（确定性修复，finalize:true 追加 LLM 修复轮）、wiki_errorbook（查看 Error Book 自我纠错记录）、wiki_ingest（把源文本编译入库，需要 LLM key）。其中 wiki_search 的 score 是整数权重累加（页名 8 > 别名 6 > 标签 4 > 摘要 2 > 正文 1），越高越强，非相似度。wiki_validate 检查悬空链接、不完整页面、畸形来源引用、索引不一致，有错误时引擎 exit 1，但插件已按结果而非失败处理。

dsh-llm-wiki 怎么安装和配置？

前置要求：已安装 DeepSeek Harness（dsh 命令可用），Python ≥ 3.10，可选 OpenAI 兼容 LLM API key（仅 wiki_ingest 和 wiki_fix finalize 需要）。先安装 Python 引擎 DSH-Wiki，再安装插件，然后配置知识库路径。安装命令如下：

pip install git+https://github.com/detpecca/DSH-Wiki.git
# 唯一运行时依赖是 pyyaml

dsh plugin --profile web add github:detpecca/dsh-llm-wiki

安装后默认指向 ./wiki，把实际路径写进 profile 的 cordis.patch.yml（$DSH_HOME/profiles/<name>/cordis.patch.yml，$DSH_HOME 默认为 ~/.dsh），按 id 覆盖并重述全部键（patch 是整行替换，不是深合并）。可选配置 LLM 参数（llmWikiBaseUrl、llmWikiApiKey、llmWikiModel），显式配置优先于环境变量。重启 DSH 后 agent 即可调用全部工具。Windows 用户可运行 scripts/install.ps1 一键安装（自动 uv 建 venv、装引擎、dsh plugin add、写配置）。

dsh-llm-wiki 的知识库如何初始化？

知识库为空时，可以让 agent 直接调用 wiki_ingest 编译第一份笔记，或先用引擎 CLI 编译：

python -m llm_wiki --wiki ./wiki ingest my_notes.txt

注意 --wiki 必须放在子命令之前。更多 CLI 用法见 DSH-Wiki README。

dsh-llm-wiki 如何卸载？

卸载命令：

dsh plugin --profile web remove @detpecca/dsh-llm-wiki

dsh-llm-wiki 兼容哪些 DeepSeek Harness 版本和平台？

插件需要 Node ≥ 18，Python ≥ 3.10（供引擎使用），支持 Windows（提供 PowerShell 安装脚本）和类 Unix 系统。它通过 DSH 的 subprocess 服务与引擎交互，不依赖特定 DSH 版本，但要求 dsh 命令可用。

查看更多 DSH 插件，访问 dsh-plugin.org