在 DeepSeek Harness (DSH) Web 界面開發或調試智能體時,項目級指令文件(如 AGENTS.md)通常存放在本地。查看或修改這些文件往往需要切換到文件管理器或外部編輯器,打斷當前會話的上下文。mrwoov/dsh-agent-md 插件解決了這個問題,它直接在 Web 會話界面中提供了編輯 AGENTS.md 的入口。
這是一個 DSH Web GUI 插件。它在會話頭部標籤欄新增「Agent」選項卡,與「對話」和「軌跡」並列。其主要作用是讓用戶在瀏覽器中直接瀏覽和編輯當前會話對應項目目錄下的 AGENTS.md 文件。
核心功能¶
- 會話內 Tab:在會話頭部 tab 欄新增「Agent」tab,與「對話」「軌跡」並列,隨時切換,無需離開當前會話。
- 自動定位:自動定位當前會話項目目錄下的
AGENTS.md;文件不存在時,輸入內容保存即自動創建。 - 編輯體驗:使用等寬字體直接編輯,頂部顯示「未保存 / 已保存」狀態,支持一鍵寫入磁盤。
- 上下文隔離:切換會話自動加載對應項目的
AGENTS.md,不會串文件、串目錄。
安裝與啓用¶
- 把本包放到
~/.dsh/profiles/web/node_modules/@mrwoov/目錄下。 - 在
~/.dsh/profiles/web/cordis.patch.yml文件中追加以下內容:
- insert:
- id: agent-md
name: '@mrwoov/dsh-agent-md'
- 重啓 dsh 進程。
典型用法¶
插件通過 HTTP 接口與後端交互,提供了讀寫項目的 AGENTS.md 的能力:
- 讀取:
GET /api/agent-md?path=<項目目錄>返回{ exists, content }。 - 寫入:
POST /api/agent-md?path=<項目目錄>body{ content }寫入<目錄>/AGENTS.md。
技術要點¶
- 純 JavaScript:無構建步驟,複製即用。
- 熱更新限制:DSH 的 patch 熱更新語義爲「只增改、不刪除」。如果修改了包名或配置組合,必須重啓 dsh 進程才能徹底生效(例如改名會導致新舊殘留,舊 bundle URL 404 會拖垮頁面)。
- 實現方式:
host半 (lib/index.js) 註冊/api/agent-md路由,讀寫文件;client半 (lib/client.js) 註冊進conversation.view槽。
生態與背景¶
本項目基於 DeepSeek Harness 的 Cordis 插件機制開發,依賴官方的 Web UI 組件。它是 DeepSeek Harness 生態的社區插件,並非 DeepSeek 官方產品。
- 目錄頁:https://www.skillhub.cn/plugins/mrwoov/dsh-agent-md
- GitHub:https://github.com/mrwoov/dsh-agent-md