前言¶
DSH（DeepSeek Harness）插件生態強調「一切皆插件」。dsh-llm-wiki 是一個 DSH 插件，用來讓 agent 直接管理 LLM-Wiki 知識庫。
它把檢索、讀頁、統計、校驗、修復、錯誤本查看和入庫封裝成 7 個 agent 工具，適合需要在會話中查詢知識庫、把源文本入庫，並持續檢查知識庫結構的場景。
這是什麼¶
@detpecca/dsh-llm-wiki 的 owner 是 detpecca，許可證是 MIT。
它通過 DSH 的 subprocess 服務調用 LLM-Wiki 引擎 CLI 的 --json 通道。檢索、編譯、校驗和修復仍由 LLM-Wiki 引擎負責。
插件本體零運行時依賴，是純 ESM，無構建步驟，要求 Node ≥ 18。
核心功能¶
下面介紹 7 個工具：
wiki_search：結構化信號打分檢索（CJK 分詞）。wiki_read：批量讀頁 / 目錄索引，跟隨[[wikilink]]。wiki_stats：頁面/分類/digest/錯誤本統計。wiki_validate：4 類確定性結構校驗。wiki_fix：確定性修復；finalize:true追加 LLM 修復輪。wiki_errorbook：查看 Error Book（自我糾錯記錄）。wiki_ingest：把源文本編譯入庫（算法 1 全流程）。
只有 wiki_ingest 和 wiki_fix 的 finalize:true 需要 LLM 配置；查詢類工具不需要第二套 LLM key。
安裝與啓用¶
先確認環境：
- 已安裝 DeepSeek Harness，
dsh命令可用； - Python ≥ 3.10；
- 可選：OpenAI 兼容 LLM API key。
1、安裝 Python 引擎
這一步用於安裝 LLM-Wiki 引擎。
pip install git+https://github.com/detpecca/LLM-Wiki.git
2、安裝插件
這一步把插件加入指定的 DSH profile。
dsh plugin --profile web add @detpecca/dsh-llm-wiki
3、配置知識庫路徑
安裝後，需要把實際路徑寫進 profile 的 cordis.patch.yml。該文件位於：
$DSH_HOME/profiles/<name>/cordis.patch.yml
如果按 id 覆蓋配置，需要重述全部鍵。這裏要注意：patch 是整行替換，不是深合併。
4、配置 LLM（可選）
只有 wiki_ingest 和 wiki_fix 的 finalize:true 需要 LLM 配置。配置優先級爲：
cordis.patch.yml裏的顯式值；- 環境變量
LLM_WIKI_BASE_URL/LLM_WIKI_API_KEY/LLM_WIKI_MODEL； - 不設置；此時
wiki_ingest/ finalize 會以清晰錯誤失敗。
5、重啓 DSH
經過上面的步驟，agent 即可調用全部 7 個工具。
典型用法¶
以下說法可以直接給 agent：
- 把
D:\notes\transformer.md收錄進我的知識庫，然後校驗一下 - 我知識庫裏關於注意力機制都講了什麼？給出依據頁面
- 檢查一下知識庫結構有沒有問題，有就修好
- 錯誤本里最近記錄了什麼？爲什麼會反覆出現？
適用場景與注意¶
- 適合已經使用 DSH，並且希望 agent 直接管理 LLM-Wiki 知識庫的使用者。
- 查詢類工具不需要第二套 LLM key；
wiki_ingest和wiki_fix的finalize:true需要 LLM 配置。 - 插件以當前
dsh進程權限運行。安裝前應檢查源碼與許可證。 - 子進程輸出上限爲 stdout 2MB、stderr 200KB。
DSH-Wiki已廢棄，請勿再使用。
結尾¶
dsh-llm-wiki 的價值在於把 LLM-Wiki 知識庫的 7 類操作接入 DSH agent，讓查詢、入庫、校驗和修復可以在同一會話中連續完成。
GitHub 倉庫：
https://github.com/detpecca/dsh-llm-wiki
社區目錄頁 URL 未在已覈實資料中給出，因此本文不列出。
