前言¶
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 进程的权限下运行。
