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