前言¶
DeepSeek Harness (DSH) 體系通過插件機制擴展智能體的能力邊界。在開發智能體時，經常會遇到需要智能體理解本地代碼庫或項目文檔的場景。如果直接調用外部大模型 API 進行檢索，存在延遲、成本和隱私風險。本地化檢索方案是更務實的選擇。
插件介紹¶
dsh-plugin-rag 是一個本地知識庫 RAG 插件，由 YYTbit 維護。它解決的問題是：無需外部 API 或嵌入模型，直接在本地對項目文件進行 TF-IDF 關鍵詞檢索，讓智能體能夠基於本地數據做出決策。
核心功能¶
- 文件索引：支持索引項目中的 Markdown 文件、各類代碼文件（如 .ts, .js, .py）、配置文件（如 .json, .yaml）以及文檔文件。
- 關鍵詞搜索：提供關鍵詞檢索能力，幫助智能體快速定位相關上下文。
- 純本地 TF-IDF：不依賴外部 API 或嵌入模型，不涉及繁重的依賴，完全在本地進行關鍵詞匹配。
安裝與啓用¶
在 DSH 中安裝該插件，使用官方提供的安裝命令：
dsh plugin --profile your-profile add dsh-plugin-rag
典型用法¶
安裝完成後，可以在命令行中直接使用 rag 命令進行操作：
- 搜索相關文件：
rag "authentication" ./src
- 顯示索引統計信息：
rag --index ./src ./docs
適用場景與注意¶
該插件適合需要在本地代碼庫中查找文檔、代碼片段或配置信息的智能體場景。在安裝使用前，請確保已檢查插件源碼，並瞭解其許可證（MIT）。插件將在當前 DSH 進程的權限下運行。
