前言¶
在 DSH 里跑智能体时，系统提示往往写在全局配置或单次会话里。团队规范、目录约定、禁止事项若散落在文档或口头约定里，每次开新会话都要重复粘贴，既容易漏项，也难和仓库版本对齐。常见做法是手动把说明贴进 prompt，或在各项目里维护一份「给 AI 看的说明」却缺少统一加载机制。
下面介绍社区插件 dsh-project-agent-instructions（npm 包名 @shihaoshen/dsh-project-agent-instructions）。它在项目目录中查找 .dsh/AGENTS.md（及可选的额外路径），把内容作为独立段落注入每个智能体的 system prompt，并在 DSH Web UI 提供设置页。维护者为 ShihaoShenCreator，在 SkillHub 目录中归类为「工作流」。
这是什么¶
该插件是 DeepSeek Harness（DSH）的 Cordis 插件：从会话工作目录出发，向上遍历祖先目录，找到最近的 .dsh/AGENTS.md，再按配置读取其它相对项目根的路径，最终将合并后的指令文本写入智能体系统提示。项目根或子目录作为工作目录启动的智能体都会生效。
核心功能¶
依据仓库 README 与 package.json（当前版本 1.2.0），已核实能力如下：
- 默认加载
.dsh/AGENTS.md：从工作目录向上查找，支持项目根及上层目录中的文件。 - 额外读取路径：可在设置页配置逗号分隔的、相对项目根的路径；在默认文件之后检查。
.dsh/AGENTS.md始终在列表中且不可从读取列表中移除。 - 体积上限：超过限制时按 UTF-8 安全方式截断后注入，默认上限为 32768 字节。
- 文件监听：指令文件修改后自动生效，无需重启 DSH。
- Web 设置页：路径为 Plugins → 本插件；修改即时应用。
许可证为 MIT。
安装与启用¶
在 DSH Web UI 中打开 Plugins → Add plugin，安装：
@shihaoshen/dsh-project-agent-instructions
也可通过 CLI 的插件管理器针对你的 profile 安装。安装后需重启 DSH，以便 client 模块加载。
典型用法¶
在项目根创建 .dsh/AGENTS.md：
my-project/
└── .dsh/
└── AGENTS.md
当智能体以该项目为工作目录（或其任意子目录）启动时，该文件内容会自动加入 system prompt。可在 AGENTS.md 中写编码规范、测试命令、目录结构说明等团队约定。
若除默认文件外还需加载其它说明（例如 docs/AGENT-RULES.md），在设置页的 Additional read paths 中填写相对项目根的路径，多个路径用逗号分隔。若单文件过大，可调整 Maximum bytes（默认 32768）。
适用场景与注意¶
适合：需要在仓库内固化「给智能体看的项目说明」、希望子目录会话也能继承同一套规则、希望改文件即生效而不反复手工粘贴 prompt 的 DSH 用户。
注意：
- 插件在 DSH 进程权限下读取本地文件；安装前建议查看 GitHub 源码 与 MIT 许可证，确认行为符合预期。
- 注入内容会进入每次 agent 的 system prompt，过长文件会被截断；重要约束应写在前部或控制总体积。
- SkillHub（https://www.skillhub.cn/plugins/ShihaoShenCreator/dsh-project-agent-instructions）为社区插件目录，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」的扩展方式。
结尾¶
dsh-project-agent-instructions 把项目级 .dsh/AGENTS.md 与可选附加路径统一注入 DSH 智能体系统提示，并支持监听与 Web 配置，减少重复粘贴与规范不同步的问题。
- 目录页：https://www.skillhub.cn/plugins/ShihaoShenCreator/dsh-project-agent-instructions
- GitHub：https://github.com/ShihaoShenCreator/dsh-project-agent-instructions
