前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許通過擴展來增強能力。對於需要在對話中訪問本地文檔的開發者，DSH-RAG 提供了一種將本地文件夾轉化爲可檢索知識庫的方案。
是什麼¶
DSH-RAG 是一個本地知識庫插件，由 imkelt 維護。它將明確授權的本地文件夾轉化爲命名化的知識庫，並在用戶顯式調用檢索時提供帶有來源依據的答案。
核心功能¶
DSH-RAG 提供以下能力：
* 命名知識庫：從本地文件夾構建可複用的知識庫。
* 顯式 /rag 檢索：檢索在模型回答前完成，而非依賴模型決定是否調用工具。
* 會話作用域搜索：默認搜索當前 Session 選定的知識庫，支持 @知識庫名稱 的一輪覆蓋。
* 可驗證證據：顯示來源卡片，包含文件名、結構上下文、摘錄及精確頁碼/行號。
* 混合檢索與離線降級：本地多語言 BM25 無需 API Key 或網絡即可工作；可選 SiliconFlow 進行向量化檢索和重排序。
* 本地文檔支持：支持 PDF、DOCX、PPTX、Markdown 和 UTF-8 文本，具備增量索引、取消和恢復掃描能力。
* 雙語與主題感知 UI：跟隨 DSH 的語言設置，適配淺色/深色/系統外觀。
安裝與啓用¶
前置條件：
* Node.js ^22.19.0 或 >=24.0.0
* pnpm 可用且在 PATH 中
* DeepSeek Harness（已測試版本 0.1.1-rc.2）
安裝命令如下：
npx @deepseek-ai/dsh plugin --profile web add @kai232/dsh-rag
安裝後啓動 Web profile。
典型用法¶
基礎用法是 /rag <問題>。
/rag What does the project note say about the launch window?
如果需要臨時切換知識庫範圍，可以使用 @ 選擇器：
/rag @"Project notes" Which Python version does the virtual environment use?
命令會先完成檢索，再將證據傳遞給模型，UI 中會顯示來源卡片。
適用場景與注意¶
- 權限與安全：插件以當前 DSH 進程的權限運行，需確保對目標文件夾有讀寫權限。
- 兼容性：當前在 DeepSeek Harness 0.1.1-rc.2 上驗證，其他版本可能兼容但未測試。
- 許可證：基於 MIT 許可證。
短結尾¶
DSH-RAG 適配了 Web profile 的插件生態，通過顯式命令和來源回溯，降低了本地知識庫接入的門檻。其離線 BM25 檢索能力使其在沒有網絡環境時依然可用。
