前言¶
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。
