前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構。在智能體開發與協作中，會話內的臨時文件與知識往往隨着會話結束而失效，導致團隊知識碎片化。dsh-kb 插件旨在解決跨會話、跨人的知識共享與沉澱問題。它提供了一個固定的、可搜索的團隊知識庫，通過側欄入口即可訪問。與僅管理會話工作區的 dsh-file-share 不同，dsh-kb 管理的是長期沉澱的固定知識庫。
核心設計¶
dsh-kb 基於 Karpathy LLM Wiki 模式構建，包含三個核心層級：
- raw（不可變素材）：由用戶上傳的原始文件（如日誌、截圖），服務端強制只進
raw/目錄，拒絕覆蓋。 - wiki（成文知識）：由 Agent 按照約定加工後的結構化文章。
- schema（約定）：定義當前知識庫的加工規則，每庫獨立。
默認存儲路徑爲 ~/.dsh/kb/，包含 raw/、wiki/、index.md（目錄）、log.md（操作流水）以及 schema.md（加工約定）。
主要功能¶
- 全頁知識庫：側欄進入，左側目錄樹（支持 wiki/raw 懶加載），右側閱讀或搜索。
- 多知識庫：支持創建多個知識庫（素材庫或產出庫），可在界面中切換或移除。
- 庫約定可編輯：每個庫可擁有獨立的
schema.md，用於規定頁面規範、目錄用途和加工流程。保存後即刻生效。 - 自動蒸餾：上傳素材後，素材入隊，由 kb-bot 會話按 schema 串行加工成文，也可手動指定。
- 全文搜索：內置零依賴掃描，支持大小寫不敏感的全文檢索與高亮。
- 問 AI：在搜索框輸入問題並點擊「問 AI」，系統自動檢索並引用命中頁面，讓 Agent 帶着依據作答。
- 版本歷史：wiki 頁面自動快照，保留最近 50 個版本，支持查看與回滾。
- 頁面反饋閉環：閱讀頁提供反饋入口，提交後 Agent 可根據反饋自動修正頁面內容。
- 陳舊提示：自動標記超過 90 天未更新的頁面。
- 下載導出：支持將任意文檔下載爲 markdown 或文本格式。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add @weibaohui/dsh-kb -w
安裝完成後，重啓 dsh web 進程使配置生效。
配套 Agent 技能¶
Agent 的加工沉澱能力依賴於配套技能。請在技能市場安裝 skill/dsh-kb/。安裝後，Agent 才具備查詢、兩步加工、矛盾標註及日誌紀律等功能。
使用流程¶
- 瀏覽與檢索：側欄點擊「📚 知識庫」。在頂部搜索框輸入關鍵詞並回車進行全文檢索，或在左側樹中瀏覽目錄。
- 閱讀與跳轉：點擊文件名閱讀，支持
[[鏈接]]內部鏈接跳轉。點擊「@ 給 agent」可將當前條目注入對話框。 - 上傳素材：在
raw/目錄樹中打開任意頁面，點擊右上角「上傳素材」。 - 加工沉澱：在對話中輸入
@raw/xxx.log並指令 Agent「按 schema 加工入庫」。Agent 完成兩步加工後，會在 wiki 中生成成文並更新索引。 - 定製約定：在知識庫頁面點擊頂欄「📐 約定」，編輯當前庫的
schema.md。例如，指定某個庫只收錄「解決方案」形態的文檔，保存後生效。
環境依賴¶
- DeepSeek Harness 版本：需大於等於
0.1.7-rc.2。 - Node 版本：需大於等於
20。 - 定時任務建議：建議在
dsh-tasks中添加每月的 lint 定時項，用於檢查死鏈、孤兒頁和陳舊條目。
與 dsh-file-share 的區別¶
dsh-file-share 管理會話工作區的文件（跟隨會話 cwd），隨會話結束可能失效或被清理。dsh-kb 管理跨會話、跨人的固定知識庫，側重於只讀瀏覽、搜索和 raw 素材上傳，二者互不依賴。
