前言¶
DeepSeek Harness（DSH）会从工作区读取指令文件（常见为 AGENTS.md），在后续步骤里交给自带的 instruction loader 使用。若习惯用外部编辑器改 Markdown，需要来回切换窗口，也容易在保存时机上与 DSH 不同步。社区插件 dsh-agents-md（维护者 awychoi，分类：客户端）在 DSH 右侧栏提供纯 Markdown 编辑面板，就地读写当前工作区的指令文件；保存后由 DSH 自身 loader 在下一步读取，插件不注入或复制 prompt 文本。
这是什么¶
dsh-agents-md 在 DeepSeek Harness 右侧栏增加 AGENTS.md 入口，对当前工作区的 workspace instruction 文件进行就地编辑。简介原文为：A right-sidebar markdown editor for DeepSeek Harness workspace instructions. 包版本为 1.0.0（见仓库 package.json），许可证 MIT。与 DeepSeek 无隶属关系。
核心功能¶
下面介绍 README 中已说明的能力，均可在 GitHub 仓库 核对。
编辑与保存¶
- 为当前工作区打开
AGENTS.md的纯 Markdown 编辑器；文件不存在时展示 starter 模板，在按下 Save 之前不会创建文件。 - 从面板保存后，DSH 自带的 instruction loader 在下一步读取磁盘上的文件。
- 保存带版本保护：若磁盘上的文件已被改动，会提示冲突，而不是静默覆盖任一侧的修改。
- 编辑器单文件上限 2 MiB；DSH loader 另有 prompt 与字节预算，大文件可能被 loader 单独截断。
快捷键与入口¶
- 引导卡片上会显示快捷键；默认 Desktop 为 ⌘⇧E，Web 为 ⌥⌘E，可在 Settings → Keyboard shortcuts 中修改。
- 启用插件 bundle 后，展开右侧栏，按 + 选择 AGENTS.md 即可打开面板。
草稿与 Host 存储¶
- 未保存内容会保留：草稿保存在 Host，并在
localStorage中镜像，以便刷新、换浏览器或 DSH Desktop 换端口后仍能恢复。 - Host 侧 debounced JSON 存储路径为
$DSH_HOME/agents-md/drafts.json；草稿 30 天后清理；单调时间戳避免迟到的草稿请求覆盖已保存内容。
Git 与文件名变体¶
- 读取真实的
.gitignore；Include … in Git 开关可添加或移除对指令文件的忽略规则，并识别agents.md等变体；若存在更宽的规则（例如*.md），会如实报告，而非声称文件已纳入版本库。 - 默认 ignore 规则应用一次后记录在
$DSH_HOME/agents-md/git.json；已 tracked 的文件不能仅靠.gitignore取消跟踪，需使用git rm --cached。 - 编辑器接受
AGENTS.md、agents.md、agent.md，优先规范写法；DSH loader 查找AGENTS.md，在大小写敏感文件系统上使用其它拼写需配置 loader。
明确不做的事¶
- 仅编辑当前工作区的一个指令文件；嵌套指令文件与
CLAUDE.md由 DSH 读取，不在此插件内编辑。 - 无预览、无语法高亮、无 WYSIWYG。
- 无凭证、无插件级 settings、无对外部网络的调用（README 说明）。
安装与启用¶
安装步骤来自仓库 README，勿自行拼接未在文档中出现的 CLI 命令。
- 在 DSH 中打开 Plugins → Add plugin。
- 填入仓库地址或本地检出绝对路径：
https://github.com/awychoi/dsh-agents-md
- 启用该 bundle，展开右侧栏，按 + 并选择 AGENTS.md；或使用引导卡片上的快捷键。
插件以当前 DSH 进程权限运行；安装前应阅读源码与 MIT 许可证，确认符合你的安全与合规要求。
典型用法¶
- 在工作区打开 DSH，安装并启用 dsh-agents-md。
- 右侧栏添加 AGENTS.md 面板；若尚无文件，可先编辑模板内容。
- 编辑完成后在面板中 Save；首次保存对缺失文件发送
version: null，Host 使用 create-if-absent，并发创建时以冲突处理而非覆盖。 - 继续 DSH 工作流，让内置 loader 在下一步加载已保存的
AGENTS.md。
适用场景与注意¶
适合：需要在 DSH 内集中维护工作区 agent 指令、希望保存与 loader 行为一致、并需要草稿恢复与保存冲突提示的开发者。
注意：
- 社区目录 skillhub.cn 插件页 为独立站点，与 DeepSeek / 幻方无官方从属；DSH 生态强调「一切皆插件」，本文事实以 GitHub README 为准。
- 仅支持 plain markdown 单文件编辑；复杂文档结构或 CLAUDE.md 需另寻方式。
- 星标等目录元数据会变动，以各站点当前展示为准。
结尾¶
dsh-agents-md 把 workspace 的 AGENTS.md 编辑收进 DSH 右侧栏，保存与版本冲突、Git 忽略、草稿持久化均围绕「文件落盘、loader 读取」这一路径设计，不替代 DSH 的 prompt 加载逻辑。
