前言¶
DeepSeek Harness（DSH）会读取 ~/.dsh/AGENTS.md 和项目内的 AGENTS.md 等规则文件；Cursor、Claude Code、Codex、TRAE、CodeBuddy 等工具又各自把用户级规则放在不同目录。改一条约束时，先要确认「哪份文件会生效」，再手动打开对应路径，还容易改错位置或漏改并行工具。
dsh-agents-visualization 是社区维护的 DSH 插件（维护者 LINGTIAN303），把项目级、全局级和 25+ 第三方 AI 工具的规则文件收进 DSH 设置 同一页，支持预览、就地编辑和注入量统计。下面介绍它的定位、能力与用法。
这是什么¶
插件在 DSH 设置左侧增加 「规则」 入口，用三个 Tab 划分范围：
| Tab | 管什么 |
|---|---|
| 项目级 | 当前工作区从项目根到 cwd 的目录链上的 AGENTS.md / CLAUDE.md / .local 变体 |
| 全局级 | ~/.dsh/AGENTS.md 与 ~/.agents/AGENTS.md |
| 第三方集中 | 25+ 个 AI 工具的用户级规则文件，按工具子 Tab 切换 |
项目级文件的发现逻辑与 @deepseek-ai/dsh-agent-instructions 同源：向上找到 .git 定项目根，展开目录链，按加载优先级排列候选文件名，而不是固定猜一个路径。
核心功能¶
渲染与编辑。 Markdown 以排版形式预览（标题、列表、表格、代码块），可切换到「源码」查看原文；.mdc 的 YAML frontmatter 会自动剥离。详情里提供等宽编辑器、字节计数、未保存标记，用 Ctrl/Cmd + S 保存。
注入统计。 详情面板显示占用字节、注入字节、已用字数、token 占用（估算）；编辑时实时更新，工具头部汇总该工具整体注入量。注入字节指剥离 frontmatter、去掉首尾空白后的有效内容；token 为启发式估算（CJK 约 1 字 1 token，其余约 4 字符 1 token）。
安全与一致性。 磁盘上的文件被外部修改时会提示冲突，可选择覆盖或重新读取。多个工具共用完全相同内容时会标出，避免误以为改一处即可全部生效。内置清单外的工具，若用户主目录下存在 AGENTS.md 或 rules/ 目录，也会被自动发现。
并发与写入。 写入采用同目录临时文件加 rename 的原子替换，UTF-8 无 BOM；单文件上限 1 MiB。HTTP 接口仅监听本机回环，并通过 DSH 的 connection.requestRejection 做信任校验；connection 不可用时接口 fail-closed 返回 503，不会退化为仅检查 Host。前端只传文件 key，服务端每次请求重新计算允许集合。资料建议版本 0.1.2 及以上（当前 package 版本为 0.1.4），因 0.1.1 及更早在 connection 缺失时存在已知风险，详见仓库 CHANGELOG。
内置第三方工具包括 Claude Code、Codex CLI、Gemini CLI、Cursor、TRAE / TRAE CN、CodeBuddy、WorkBuddy、OpenCode、Windsurf / Devin、Cline、GitHub Copilot、Kiro、Qoder 系列、Augment Code、Roo Code、ZCode、CodeArts Doer、CatPaw、AutoClaw、Hanako、JoyCode 等；路径来源可在界面悬停工具名查看（官方文档 / 本机实测 / 推测）。
安装与启用¶
通过 DSH 插件管理器安装（将 <你的 profile> 换成实际 profile 名）：
dsh plugin --profile <你的 profile> add dsh-agents-visualization
也可在 DSH 设置 → 内置插件 中搜索 dsh-agents-visualization 安装。
本地开发插件时使用 link（路径按本机实际修改）：
dsh plugin --profile <profile> add "link:C:\\path\\to\\dsh-agents-visualization"
兼容性（来自 README）：DSH 0.2.x（在 0.2.1-rc.5 上验证），Node.js >= 20。许可证为 MIT。
安装前建议自行查看 GitHub 仓库 源码与许可证；插件以当前 DSH 进程权限读写用户主目录下的规则文件，属于高敏感能力，不宜在未审阅的情况下盲目启用。
典型用法¶
- 打开 DSH → 设置 → 左侧 「规则」。
- 选择 项目级、全局级 或 第三方集中 Tab，点击任意文件展开详情并编辑。
- 需要新建文件时，在「未创建」分组中点对应条目，再点 创建。
- 某第三方工具不在内置清单中：切到 第三方集中 最后一个子 Tab 「自定义工具」，按模板填写后保存。
自定义工具配置持久化在 ~/.dsh/agents-visualization.json，格式示例：
[
{
"id": "mytool",
"name": "我的工具",
"vendor": "自定义",
"targets": [
{ "kind": "dir", "segments": [".mytool", "rules"] },
{ "kind": "file", "segments": [".mytool", "AGENTS.md"] }
]
}
]
kind 为 file（单文件，可选 alternates 备选路径）、dir（目录下多个 .md / .mdc）或 glob（动态子目录名，需 pattern 与 files）。segments 为相对用户主目录的路径分段，不接受绝对路径与 .. 上跳。设置页内也可直接编辑 JSON 或点「填入模板」追加工具。
适用场景与注意¶
适合经常在 DSH 与多款 AI 编码工具之间切换、需要统一查看或微调 AGENTS.md / 同类规则文件的开发者。项目级 Tab 与 DSH 真实加载顺序对齐，适合核对「当前 cwd 下到底哪几层规则会参与注入」。
需注意：内置路径随各产品更新可能变化，界面标注为「推测」的条目应自行核实；产品路径不对时用 自定义工具 覆盖。符号链接若指向用户主目录之外，不会纳入可编辑范围。
DSH 生态采用「一切皆插件」思路；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
经过上面的步骤，你可以在 DSH 设置里完成规则文件的查看、创建与编辑，并借助注入统计控制上下文体积。进一步细节与 issue 见 GitHub：LINGTIAN303/dsh-agents-visualization。
