前言¶

在 DeepSeek Harness（DSH）裏做長期對話或項目協作時，模型往往只能依賴當前上下文和臨時粘貼的文本，本地文檔、規範、筆記很難穩定進入回答依據。把資料手工複製進每條消息既費事，也難以在回答裏追溯「這句話來自哪份文件」。下面介紹社區插件 dsh-knowbase（npm 包名 @domitor-syh/dsh-knowbase）：在 DSH 側建本地知識庫、按會話選庫，並在對話前用檢索把相關片段交給模型，同時支持引用與原文閱讀。

這是什麼¶

dsh-knowbase 由維護者 domitor-syh 發佈，在 SkillHub 插件目錄 中歸類爲「記憶」。項目自述爲：爲 DSH 提供本地知識庫——把文檔納入知識庫，在對話中自動檢索相關內容，並通過引用查看資料出處。插件當前版本 0.1.0，採用 MIT 許可證；README 標明適配 DSH 0.2.1-rc.5，兼容範圍 >=0.2.0-rc.2 <0.3.0-0。

DSH 生態強調「一切皆插件」；SkillHub 等社區目錄獨立於 DeepSeek / 幻方，並非官方應用商店。安裝前建議自行查看 GitHub 倉庫 源碼與許可證。

核心功能¶

以下能力均來自項目 README，檢索算法說明中註明「正在持續優化中」。

本地資料管理：每個知識庫對應一個文件夾，支持上傳文件、直接放入文件夾後重掃，以及增量更新索引。

多種資料格式：支持 TXT、Markdown、JSON、CSV、源碼等 UTF-8 文本、文本型 PDF，以及 PNG / JPG 圖片的本地中英 OCR（基於 Tesseract.js，語言包在知識庫頁面下載後在本機識別）。

自動檢索：使用中文 n-gram 與 BM25，在對話前檢索相關片段，爲回答提供資料依據。

按會話選庫：在輸入區選擇一個或多個知識庫，選擇隨會話保存；新會話默認未開啓，需按需選擇。

引用與原文閱讀：查看回答使用的來源、複製引用，並在右側閱讀器打開資料、定位對應內容。

檢索測試與統計：在知識庫頁面測試查詢效果；插件詳情頁可按需開啓自動檢索統計。

新資料提案：Agent 可提交文本資料提案，由用戶預覽並批准後保存到知識庫。

界面：中英雙語，跟隨 DSH 系統語言與明暗主題。

安裝與啓用¶

當前 README 給出的安裝方式如下。

Web 端（dsh web，從 npm 安裝）：

dsh plugin --profile web add @domitor-syh/dsh-knowbase

桌面端：在插件管理的安裝入口填寫包名：

@domitor-syh/dsh-knowbase

安裝後，Web 端需重啓 dsh web 並刷新頁面；桌面端需重啓應用。若從 DSH 源碼運行，在 Web 安裝命令前加 pnpm。

典型用法¶

界面流程¶

1. 點擊側欄「知識庫」，選擇「添加知識庫」，填寫名稱和描述。
2. 上傳資料，或打開知識庫文件夾、放入文件後點擊「重掃」。
3. 回到對話，點擊輸入區「知識庫」按鈕，開啓本次會話要使用的庫。
4. 發送問題，插件會檢索所選庫中的相關片段供模型參考。
5. 點擊回答下方的知識庫來源按鈕，查看引用、複製出處，或在右側打開原文。

修改文件夾內資料後，點擊「重掃」更新內容。

圖片文字識別¶

在知識庫頁面「圖片文字識別」區域下載中英語言包，然後重掃圖片資料。

檢索測試¶

在知識庫頁面搜索框輸入問題並選擇檢索範圍，可查看命中的文件、位置和原文片段；展開「檢索詳情」可查看得分與覆蓋率。

會話內命令¶

適用場景與注意¶

適合誰：需要在 DSH 對話中反覆引用本地文檔、規範、筆記或項目資料，並希望回答帶來源、可點開原文的開發者或團隊。

運行與權限：插件隨當前 DSH 進程運行，讀寫知識庫目錄、索引與 OCR 等均在本機完成；安裝前應閱讀倉庫代碼，確認路徑與數據處理符合你的環境策略。

依賴與格式：PDF 需爲可提取文本的類型；圖片 OCR 需先下載語言包。檢索爲 n-gram + BM25，並非向量數據庫方案，選型時需與自身資料規模和語言特點對照 README 中的檢索測試能力。

結尾¶

dsh-knowbase 把「建庫 → 選庫 → 檢索 → 引用」收進 DSH 一條工作流，適合以本地資料爲可信來源的對話場景。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub：domitor-syh/dsh-knowbase。