前言¶
DeepSeek Harness（DSH）会把用户级、工作区里的 AGENTS.md 与 CLAUDE.md 当作智能体指令一并加载进当前会话。改这些文件通常要切到编辑器或终端，保存后也不直观知道「当前对话到底读了哪几份、各占多少预算」。社区插件 dsh-agents-md（维护者 Sillykjs）在 DSH Web 对话页签栏增加「智能体文档」页签，专门列出本会话实际加载的指令文件，并支持就地预览、编辑与保存；保存后从下一条用户消息起重新读取，当前回合不受影响。
下面介绍插件定位、能力与安装用法。事实以 GitHub 仓库 README 为准；社区目录页见 skillhub.cn。DSH 生态强调「一切皆插件」，该目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-agents-md 是面向 DSH Web 的客户端插件（dsh.client.platform: web）。它在对话页签栏增加「智能体文档」，用于查看并编辑当前工作区与会话所加载的 AGENTS.md 类指令文件。仓库简介：A DSH Web conversation tab that lists and edits the AGENTS.md instruction files DSH loads for the current workspace. 许可证为 MIT。
核心功能¶
经 README 核实，插件提供以下能力：
- 列出当前会话加载的全部指令文件：包括用户级与工作区的
AGENTS.md/CLAUDE.md。 - 侧栏顺序：工作区相关文件置顶；其次
~/.dsh/AGENTS.md；~/.agents/AGENTS.md固定在最下方。 - 预览与编辑：默认 Markdown 预览；点「编辑」进入编辑器；支持 Ctrl/⌘+S 保存。
- 生效时机：保存后下一条消息才重新加载指令，当前回合不变。
- 缺失文件可创建：侧栏中不存在的
AGENTS.md可直接新建。 - 顶栏信息：显示工作区路径（点击可在文件管理器中打开），以及 64 KiB 指令预算提示。
- 保存冲突检测：保存前校验版本；若文件已被外部修改，提示冲突而非静默覆盖。
- 界面语言：中英文，跟随 DSH 语言设置。
安装与启用¶
在 DSH Web 打开「设置 → 插件」，点「添加插件」，选择「安装第三方插件」，在「包名或地址」中填入：
github:Sillykjs/dsh-agents-md
安装完成后按提示重启 DSH，刷新页面。页签栏应出现「智能体文档」。
插件以当前 DSH 进程权限运行；安装前建议浏览仓库源码并确认 MIT 许可证是否符合你的环境要求。
典型用法¶
- 打开任意已绑定工作区的 DSH Web 对话，切换到「智能体文档」页签。
- 在侧栏选择要查看的文件（工作区
AGENTS.md、用户级路径下的文件等），默认以预览模式阅读当前内容。 - 需要修改时点「编辑」，改完后按 Ctrl/⌘+S 保存。
- 发送下一条用户消息后，DSH 会按更新后的指令文件继续对话；若保存时提示版本冲突，先在磁盘上合并外部改动，再在插件内重新编辑保存。
若某路径下尚无 AGENTS.md，可在插件内创建后再编辑，无需先手动建空文件。
适用场景与注意¶
适合：经常在 DSH 里调智能体行为、需要在对话界面确认「到底加载了哪些指令」、或希望在不离开 Web 的情况下改工作区 / 用户级 AGENTS.md 的开发者。
注意：
- 指令预算是 64 KiB 量级（顶栏有展示）；超长内容需自行裁剪或拆分策略，插件不负责自动压缩。
- 保存仅影响后续消息；正在进行的单轮多步推理不会因保存而中途换指令。
- 第三方插件非 DSH 官方内置；星标与版本以仓库为准（package.json 中当前版本为 0.1.16，仅作查阅参考）。
结尾¶
dsh-agents-md 把「当前会话用了哪些 AGENTS.md」从隐式配置变成 Web 页签里的可读、可改界面，并配合版本校验避免误覆盖。需要安装地址与 issue 时，见 GitHub：Sillykjs/dsh-agents-md 与 SkillHub 目录页。
