前言¶
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 加載邏輯。
