前言¶
在 DSH 里，工作区根目录下的 Markdown 文件常被用来给智能体写长期指令。默认情况下，DSH 会同时加载 AGENTS.md、AGENTS.local.md、CLAUDE.md、CLAUDE.local.md 四类文件。若你已经在用 AGENTS.md 体系，或希望与 Claude Code 那套 CLAUDE.md 命名彻底分开，多出来的 CLAUDE.md 仍会被读入，可能带来重复、冲突或维护成本。
Web 与桌面版各自带有内置预设和指令加载逻辑，单靠 profile 配置往往改不了「读哪些文件名」。下面介绍社区插件 dsh-agents-md-only（维护者 RicardoYan，分类：客户端），它通过插件方式收窄 DSH 的工作区指令来源。
这是什么¶
dsh-agents-md-only 是 DeepSeek Harness（DSH）的客户端插件：安装后，DSH 只把 AGENTS.md 与 AGENTS.local.md 当作工作区指令文件，不再读取 CLAUDE.md 与 CLAUDE.local.md。
插件当前版本为 0.1.2，许可证 MIT。源码与说明见 GitHub，也可在 SkillHub 插件目录 查看条目（社区目录站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
根据 README，插件能力可以概括为以下几点：
- 收窄指令文件集合：相对 DSH 默认「四个文件都读」，仅保留
AGENTS.md/AGENTS.local.md。 - 全局生效：对所有预设和会话生效，含子代理；无需额外配置项。
- 文件名与全局路径：工作区内文件名匹配不区分大小写；用户目录下的
~/.dsh/AGENTS.md仍会照常读取。 - 会话中的指令刷新：安装或卸载插件后，若继续已有会话，会一次性收到更新后的完整指令。
- 实现方式：依赖 DSH 内部接口（
dsh-agent-instructions的配置字段），适用 DSH 版本范围为@deepseek-ai/dsh>=0.2.1-rc.1 且 <0.3.0-0。
安装与启用¶
安装前请确认本机 DSH 版本落在上述区间内。插件以当前 DSH 进程权限运行，安装前建议自行查看仓库源码与 LICENSE。
桌面 profile（README 示例为 desktop）：
dsh plugin --profile desktop add github:RicardoYan/dsh-agents-md-only#v0.1.2
Web 端：将命令里的 desktop 换成你实际使用的 profile 名（一般为 web）。
装完后重启 DSH，插件才会完整生效。
卸载示例：
dsh plugin --profile desktop remove dsh-agents-md-only
典型用法¶
本插件没有独立配置文件或 CLI 子命令，典型用法就是「安装 → 重启 → 按 AGENTS 约定维护 Markdown」。
- 在项目根目录维护
AGENTS.md（必要时用AGENTS.local.md放本地、不入库的内容）。 - 不再依赖或刻意避免放置
CLAUDE.md/CLAUDE.local.md作为 DSH 工作区指令（安装插件后 DSH 不会再去读它们）。 - 若团队混用多种工具，只让 DSH 消费 AGENTS 命名，可减少与 Claude Code 默认文件名之间的交叉影响。
适用场景与注意¶
适合谁
- 已统一使用
AGENTS.md描述仓库规则，且不希望 DSH 再合并CLAUDE.md内容。 - 需要在不改内置预设的前提下，用 DSH「一切皆插件」的方式调整指令加载行为。
注意事项
- 版本绑定较紧：仅适用于
>=0.2.1-rc.1 <0.3.0-0；升级 DSH 大版本前请核对插件是否仍兼容。 - 依赖内部接口，DSH 或
dsh-agent-instructions变更可能导致插件需更新。 - 插件不替你做指令内容的质量把关；文件写错或冲突仍要在 Markdown 里自行整理。
结尾¶
dsh-agents-md-only 用很小的安装成本，把 DSH 工作区指令固定到 AGENTS 命名上，适合已经选定 AGENTS 工作流、又受默认四文件加载影响的开发者。
- 目录页：https://www.skillhub.cn/plugins/RicardoYan/dsh-agents-md-only
- GitHub：https://github.com/RicardoYan/dsh-agents-md-only
