前言¶
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 检索能力使其在没有网络环境时依然可用。
