前言¶
在 DeepSeek Harness（DSH）裏做智能體或長對話時，模型往往只能依賴上下文窗口裏的內容。團隊文檔、本地筆記、PDF 規範散落在目錄裏，外掛檢索又多是單獨產品，很難在「選源 → 提問 → 看引用」一條鏈路裏完成。若再把外部 MCP、skill 或其它插件工具接進來，通常還要爲每家知識庫寫適配器。
dsh-kb 是面向 DSH 的知識源插件：在對話裏選擇本地文件夾或按配置掛接的外部工具，回答時在下方給出可展開的引用，並儘量保留打開原文的能力。下面按定位、功能、安裝與用法說明如何接入。
這是什麼¶
dsh-kb（npm 包名 @local/dsh-kb，版本 0.1.0）由 Trouvaille-xx 維護，屬於 DSH 社區目錄中的「記憶」類插件。它爲 DeepSeek Harness 提供知識源：本地目錄遞歸索引，或通過名稱、工具名、參數模板與結果映射接入已註冊的外部工具（MCP server、skill、其它插件工具等），不在插件內做廠商專用適配。
簡介原文：Knowledge sources for DeepSeek Harness: local folders + configurable external tools, with traceable citations.
核心功能¶
本地文件夾知識源¶
遞歸掃描 Markdown、純文本、PDF、docx；按標題感知分塊；用 SQLite FTS5（trigram）檢索。PDF 引用可帶頁碼。
外部工具知識源（配置式）¶
填寫名稱、已註冊的工具名、參數模板與結果映射即可接入任意外部知識庫，無需在插件裏爲單個廠商寫死邏輯。
會話與界面¶
- 會話級選源：輸入框左側芯片下拉選擇知識源，支持「不使用知識庫」；選擇按會話保存。
- 引用摺疊面板：回答下方顯示「引用 N 條 · 來源」，展開可看片段並打開原文。
- 知識庫管理頁：側欄「知識庫」入口；左側本地 / 外部兩個 tab；右側文件表格（名稱、類型、狀態、更新時間）。
- 設置：分塊參數、向量模型、重排模型（後兩者配置可保存；向量檢索與重排接入見路線圖）。
當前檢索以本地 FTS5 爲主；向量檢索、重排、混合檢索等仍在路線圖中。
安裝與啓用¶
插件以本地路徑方式裝進 DSH profile。官方 README 要求先克隆倉庫並在插件目錄安裝運行時依賴（因 profile 的 pnpm 不會爲 link: 本地包安裝依賴）。
# 1) 克隆到任意目錄
git clone <this-repo> dsh-kb
cd dsh-kb
# 2) 安裝運行時依賴（pdfjs-dist / mammoth）
npm install --omit=dev
# 3) 裝進 DSH profile（路徑用絕對路徑）
dsh plugin --profile <profile> add <absolute-path-to-dsh-kb>
安裝後重啓或熱重載 DSH：側邊欄應出現「知識庫」，輸入框左側出現知識源芯片。
許可證：MIT。
典型用法¶
- 側邊欄打開「知識庫」→ 新建本地知識庫，填寫文件夾絕對路徑 → 自動建立索引。
- 回到對話，點輸入框左側芯片，選擇該知識源。
- 提問；回答下方出現引用面板，PDF 引用會標註頁碼。
外部知識源在管理頁的「外部」tab 中按 README 說明配置工具名與映射後，同樣在芯片裏選用即可。
數據落盤¶
$DSH_HOME/kb/state.json：知識源、會話綁定、引用、文檔清單、配置。$DSH_HOME/kb/local.sqlite：分塊索引（FTS5）。
便於備份或排查索引問題時直接對照這兩處路徑。
適用場景與注意¶
適合誰：需要在 DSH 對話裏固定選用本地文檔庫或已註冊外部檢索工具，並希望在回答下方看到可追溯引用的開發者與個人用戶。
權限與安全：插件在 DSH 進程權限下運行，本地知識庫路徑即其可讀範圍；接入外部工具時會按你的配置調用已註冊工具。安裝前建議閱讀倉庫源碼與 MIT 許可證，確認路徑與工具調用符合你的環境策略。
生態說明：DSH 奉行「一切皆插件」；社區插件目錄（如 skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。本插件當前 GitHub 星標爲 0，功能與版本以倉庫 README 與 package.json（0.1.0）爲準。
路線圖（倉庫公開項）¶
倉庫 README 列出的後續方向包括：向量檢索（OpenAI 兼容 / Ollama / 本地 ONNX）、重排、BM25 + 向量混合檢索、增量索引、Excel / PPT 解析、召回測試面板等；尚未勾選完成，使用前勿當作已上線能力。
結尾¶
dsh-kb 把「選知識源、提問、看引用」收進 DSH 同一套界面：本地目錄走 FTS5 索引，外部能力走配置式工具映射。若要查看目錄簡介或跟進更新，可訪問社區目錄頁 dsh-kb 與源碼倉庫 Trouvaille-xx/dsh-kb。
