前言¶
DeepSeek Harness 的核心理念是「一切皆插件」。在本地開發或使用過程中，管理技能文件與 MCP 服務器配置通常需要手動編輯 YAML 文件，這種方式容易出錯且缺乏可視化的調試手段。dsh-mcp-skills 插件爲此提供了直接的網頁管理入口，將原本分散的配置項集中到了 Web 界面。
插件定位¶
這是一個由 Lrxc 維護的 DeepSeek Harness 客戶端插件。它通過注入代碼，在網頁設置面板中新增了「Skills」和「MCP」兩個管理頁面，用於集中管理用戶自有技能及 MCP 服務器配置。
核心功能¶
Skills 頁面¶
該頁面用於管理用戶自有技能。支持對技能進行瀏覽、導入（ZIP 格式）、刪除和開關操作。技能文件存儲於 $DSH_HOME/skills 目錄中。
- 導入規則：ZIP 導入支持單個技能（根目錄 SKILL.md 或 <name>/SKILL.md）或多個技能目錄。
- 去重處理：已存在的技能不會被覆蓋；template/ 目錄會被跳過；導入結果會顯示跳過的數量。
MCP 頁面¶
該頁面用於管理 MCP 服務器配置，支持 stdio 和 Streamable HTTP 兩種類型。
- 配置存儲：MCP 服務器配置保存在 $DSH_HOME/mcp-servers.yaml。
- 集成寫入：啓用的服務器會被寫入當前 profile 的 cordis.patch.yml，並在重啓 dsh 後自動連接。
- 工具註冊：掛載的工具名稱格式爲 mcp__<server>__<tool>。
- 文件操作：插件只增刪自己生成的 mcp-* 行，不改動該文件的其他內容（註釋、錨點與 !!js 表達式都會原樣保留）。寫入操作是原子的，並會保留一份 .bak 備份。
連接測試¶
提供連接測試功能，超時時間爲 15 秒。若測試超時，連接會被關閉並回收子進程。測試與真實掛載使用同一套環境清洗規則。
安裝與啓用¶
前置要求¶
- 已安裝帶 web profile 的 DeepSeek Harness (dsh)。
PATH環境變量中包含pnpm。
安裝命令¶
從 npm 安裝：
dsh plugin --profile web add dsh-mcp-skills
從 GitHub 安裝：
dsh plugin --profile web add https://github.com/Lrxc/dsh-manage-hub.git
從本地目錄安裝：
git clone https://github.com/Lrxc/dsh-manage-hub.git
dsh plugin --profile web add file:./dsh-manage-hub
重啓服務¶
安裝完成後，需要重啓服務以使配置生效：
dsh --profile web
注意事項¶
- 配置文件語法檢查：若 profile 的
cordis.patch.yml存在語法錯誤，插件會拒絕改寫並報錯，不會覆蓋文件。 - 環境變量清洗：出於安全考慮，環境變量中的
*_KEY/*_PASSWORD/*_SECRET/*_TOKEN與DSH_*變量不會傳遞給 MCP 子進程。如需憑據，請在服務器的環境變量裏顯式配置。 - 測試按鈕依賴：頁面的「測試」按鈕使用宿主安裝自帶的 MCP SDK（列爲可選 peer 依賴，不隨本包重複安裝）。若宿主未提供該 SDK，只有測試按鈕會提示不可用，技能管理與其餘 MCP 功能不受影響。
總結¶
dsh-mcp-skills 通過 Web 界面解決了 DSH 環境下技能與 MCP 服務器配置分散、難以管理的痛點。它提供了可視化的增刪改查能力，並保留了文件操作的原子性與安全性。
- GitHub 倉庫：https://github.com/Lrxc/dsh-manage-hub
- 插件目錄：https://www.skillhub.cn/plugins/Lrxc/dsh-manage-hub
