前言¶
在 DSH(DeepSeek Harness)里跑智能体时,项目树里往往散落着多份 AGENTS.md、README.md 以及其中的协作约定。规则变多之后,靠人工翻目录或全文关键词匹配,很难在对话里快速对齐「当前仓库到底要求 agent 怎么做」。
下面介绍社区插件 dsh-regras(维护者 songjongdevsecops)。它在工作区目录树范围内,对上述规则类 Markdown 做语义检索,并同时面向 agent 提供工具、面向使用者提供命令,属于社区目录中的「记忆」类插件。
这是什么¶
dsh-regras 是第三方 DeepSeek Harness 插件,由 songjongdevsecops 维护。SkillHub 社区目录对其的定位是:
DeepSeek Harness plugin: semantic search over the AGENTS.md and README.md rules of your workspace tree, with a tool for the agent and a command for you.
换句话说:插件扫描你工作区树里的 AGENTS.md 与 README.md(及其中的规则内容),用语义搜索而不是简单字符串匹配来召回片段;智能体侧可通过插件暴露的工具查询,你也可以在 CLI 侧使用插件提供的命令。
目录页标注当前版本为 v0.1.1(约 4 天前更新),GitHub 星标为 0。DSH 生态奉行「一切皆插件」;SkillHub 等社区目录独立于 DeepSeek / 幻方,并非官方应用商店。
核心功能¶
依据目录页与插件简介,目前可核实的能力如下。
- 工作区规则索引范围:面向工作区目录树中的
AGENTS.md与README.md,聚焦其中承载的 agent / 项目规则文本。 - 语义检索:在上述文件集合上做 semantic search,便于用自然语言意图召回相关段落,而不是只匹配固定关键词。
- 双入口:
- 为 agent 提供可在 Harness 中调用的 tool;
- 为 使用者 提供可在终端执行的 command。
插件 README 在本次资料抓取时未能从 GitHub 读取(仓库 URL 返回 404),因此本文不写具体的工具名、命令名、配置字段或索引实现细节;安装并启用后,应以仓库文档或目录页更新为准。
安装与启用¶
SkillHub 目录页将本插件标记为「可安装」,并显示版本 v0.1.1,但页面正文未给出官方安装命令。
撰写时尝试打开插件 GitHub 仓库 https://github.com/songjongdevsecops/dsh-regras 与 README,均无法获取内容(HTTP 404),因此本文不凭插件名拼接 dsh plugin add github:… 一类命令。
建议按下面步骤自行核对后再安装:
- 打开 SkillHub 目录页 songjongdevsecops/dsh-regras,查看是否补充了安装说明或指向可用源码地址。
- 若 GitHub 恢复可访问,阅读仓库 README 中的安装段落(Bundle 插件通常通过
dsh plugin --profile web add …安装到webprofile,安装后往往需重启dsh web;以 README 为准)。 - 安装前通读源码与许可证,确认插件申请的权限与你的工作区数据范围可接受。
典型用法(能力层面)¶
在缺少 README 细节的前提下,只能根据简介描述可复现的使用思路,而非具体命令行示例。
- 准备规则文件:在工作区各层目录维护
AGENTS.md、README.md,把希望 agent 遵守的约定写清楚。 - 安装并启用插件:按目录页或仓库文档完成安装,确保 agent 侧已注册插件 tool。
- agent 会话中:当问题涉及「项目规范」「目录约定」「某子包 README 里的说明」时,通过插件提供的 tool 做语义检索,用返回片段作为上下文,再继续推理或改代码。
- 终端侧:使用插件为使用者暴露的 command,在不启动完整 Web 会话时,对工作区规则做同样的语义查询(具体子命令以仓库文档为准)。
经过上面的步骤,核心价值是把分散在多目录的规则文档变成可查询的记忆层,减少 agent 漏读或误读本地约定的情况。
适用场景与注意¶
适合谁
- monorepo 或多子项目仓库,
AGENTS.md/README.md分布在不同路径; - 希望 agent 在编码前自动对齐各目录规则,而不是每次把长文档贴进对话;
- 已在用 DSH,并愿意通过社区插件扩展「记忆 / 知识检索」能力。
务必注意
- 插件以当前 dsh 进程的权限运行,能读到的文件范围取决于进程与工作区配置;安装前请审查源码与许可证,不要对不可信仓库盲目安装。
- 语义检索的质量依赖规则文档是否清晰、是否及时更新;文档过时或矛盾时,检索结果也会误导 agent。
- GitHub 源在撰写时不可访问,若你依赖固定安装源,请先确认仓库是否迁移、更名或改为私有,再决定是否使用目录页上的 v0.1.1 条目。
结尾¶
dsh-regras 把工作区里的 AGENTS.md 与 README.md 规则做成可语义检索的记忆层,并分别给 agent 和使用者提供 tool 与 command。若你正在用 DSH 管理多目录协作约定,可以从社区目录页与(在可访问时的)GitHub 仓库入手了解详情。