前言¶
DeepSeek Harness (DSH) 在執行任務時，主要依據 AGENTS.md 文件來獲取 Agent 的行爲指令。這些指令文件通常存在於全局（~/.dsh/AGENTS.md）和本地工作區（<workspace-root>/AGENTS.md）中。當用戶同時使用多個工具（如 Claude、Cursor、Aider 等）時，這些指令文件可能會散落在不同的目錄下，手動管理和路由變得繁瑣且容易出錯。
dsh-rich-context 插件爲 DSH 提供了一個可視化的指令管理界面。它位於 Skill Center 側邊欄，允許開發者直接編輯、優化並路由 Agent 實際讀取的 AGENTS.md 文件。
插件簡介¶
插件名稱：dsh-rich-context
核心功能：管理 Agent 指令文件，支持自定義路徑、跨工具目錄掃描與默認源切換。
維護者：savageops
開源協議：MIT
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add dsh-rich-context
安裝完成後，需要重啓 dsh web 進程。重啓後，在 Skill Center 側邊欄會出現一個名爲 Context 的入口。
核心功能¶
1. 側邊欄編輯面板¶
Context 面板提供兩個分段標籤頁：
- Global：編輯全局指令文件 ~/.dsh/AGENTS.md。該文件會被注入到所有會話中。
- Workspace：從下拉列表選擇工作區，編輯該工作區的根目錄 AGENTS.md。
2. 自定義路徑編輯¶
在面板頂部的路徑欄中，點擊路徑文本即可跳轉並編輯任意絕對路徑的文件。這允許用戶直接管理非標準位置的指令文件。
3. 源掃描與默認源設置¶
在 Global 標籤頁中，面板會自動掃描 10 個工具目錄（包括 .dsh、.codex、.claude、.cursor、.aider、.gemini、.copilot、.continue 以及根目錄）以查找 AGENTS.md 和 CLAUDE.md 文件。
掃描到的文件會顯示行數。點擊 Set as default 按鈕，系統會將 ~/.dsh/AGENTS.md 創建爲指向該文件的符號鏈接（symlink）。這使得 DSH 能夠透明地讀取你指定的單一工具目錄下的指令文件作爲默認源。點擊 Reset 可恢復爲普通文件。
技術架構¶
該插件採用前後端分離的架構：
- 後端：基於 Node.js，通過 /api/rich-context/* 路由處理文件掃描、讀寫以及符號鏈接管理。
- 前端：純 DOM 實現，無 React 依賴，通過注入的方式渲染側邊欄和編輯器。
注意事項¶
- 安裝後必須重啓
dsh web進程，側邊欄入口才會出現。 - 使用 MIT 許可證，可自由使用和修改。
- 確保插件安裝前，當前 DSH 進程的版本滿足要求（
dsh >= 0.1.6-0 || >= 0.2.0-rc.0）。
