前言¶
在 DeepSeek Harness（dsh）裏做智能體開發，MCP 服務、Skills 和 Claude Code 插件往往分散在不同配置文件、目錄和外部市場裏。改一處配置要猜作用域是 global、profile 還是 project；從 Claude Desktop、Cursor 或 VS Code 遷過來的 mcpServers JSON 還要手工對齊格式。下面介紹的 dsh-cap-manager 是維護者 easun-zhu 發佈的 dsh 客戶端插件：在 Web UI 側欄增加 MCP & Skills 面板，把三類能力收進同一界面，並支持導入導出與官方插件市場瀏覽。
這是什麼¶
dsh-cap-manager（npm 包名同名，當前發佈 v1.2.0，MIT 許可證）的定位是：在 DeepSeek Harness Web UI 中提供 MCP 服務器、Skills、Claude Code 插件 的統一管理面板。插件要求 dsh 版本 ≥ 0.2.1-rc.2；倉庫與說明見 GitHub，社區目錄頁：skillhub.cn/plugins/easun-zhu/dsh-cap-manager。
核心功能¶
MCP 服務器¶
側欄 MCP & Skills 面板的 MCP 標籤頁按作用域分組展示卡片：global / profile / project。每張卡片顯示實時連接狀態與工具數量，可新增、編輯、開關啓用、刪除，變更即時生效。關閉啓用時保留配置但不掛載。
項目級配置以 .dsh/mcp.yml 爲唯一來源；項目在面板中被選中或存在活躍會話時，其中已啓用的服務器會被掛載。外部編輯文件會通過 watcher 與 diff mount 被實時拾取。serverName 在所有層級中必須唯一，衝突會在掛載前被拒絕。
面板支持從 Claude、Cursor、Cline、Roo、VS Code 等環境 導入 mcpServers JSON，並 導出 爲標準 JSON 文檔。新增表單提供 filesystem、memory、sequential-thinking、fetch、github、puppeteer 等模板下拉，便於快速起步。
Skills¶
Skills 標籤頁掃描四個可寫根目錄：<project>/.dsh/skills、<project>/.agents/skills、~/.dsh/skills、~/.agents/skills，在同一可搜索列表中展示。支持就地編輯、從 .zip 或 URL 導入、一鍵導出；刪除進入回收站可恢復，並保留 .cap-bak 備份歷史（每個受管文件保留 5 份備份）。
同名 Skills 按提供方規則解析優先級（項目優先於用戶）；被遮蔽或無法解析的條目會以徽章提示，而不是靜默消失。
Claude Code 插件¶
Plugins 標籤頁可瀏覽 Anthropic 官方 claude-plugins-official 市場（README 標註 315+ 插件），在 dsh 內完成安裝、更新、卸載與開關。插件自帶的 Skills 通過原生 skill provider 生效；插件聲明的 mcpServers 會作爲實時 MCP 連接掛載。自 v1.2.0 起，由 Claude Code 插件掛載的 MCP 服務器也會在 MCP 標籤頁中以只讀行出現。
導入與導出（要點）¶
- MCP 導入：支持粘貼、上傳或通過 URL 拉取 JSON；容忍 VS Code JSONC（註釋、尾逗號）；
sse會映射爲streamable-http並告警；無效鍵會自動 slug 並標記。${VAR}/${env:VAR}轉爲!!js process.env.VAR；VS Code${input:…}在應用時通過憑據表單替換。預覽列出所有轉換與失敗項後再寫入。 - MCP 導出：合併受管行與當前項目文件爲
{"mcpServers": …}；!!js折回${VAR}；已禁用行不導出。密鑰以明文導出，界面會明確提示。 - Skills 導入：
.zip（可含外層目錄）、文件夾、零散.md或 zip URL；上限 10 MB / 200 文件，拒絕 zip-slip，丟棄 macOS 垃圾文件。同名默認跳過，可選覆蓋。 - 回收站與備份：刪除的 Skills 可一鍵還原；
.cap-bak-*可覆蓋還原目標或刪除。
安裝與啓用¶
前提：已安裝 DeepSeek Harness ≥ 0.2.1-rc.2（全局 dsh，或通過 npx -y @deepseek-ai/dsh 運行）。無需自行構建，推薦從 npm 安裝：
dsh plugin --profile web add dsh-cap-manager
若 pnpm 發佈冷卻導致裝不到最新版，可顯式指定版本：
dsh plugin --profile web add dsh-cap-manager@1.2.0
也可使用 Release tarball（不經過 npm）：
# Web UI
dsh plugin --profile web add https://github.com/easun-zhu/dsh-cap-manager/releases/download/v1.2.0/dsh-cap-manager-1.2.0.tgz
# Desktop 客戶端
dsh plugin --profile desktop add https://github.com/easun-zhu/dsh-cap-manager/releases/download/v1.2.0/dsh-cap-manager-1.2.0.tgz
將 web / desktop 換成你實際使用的 profile 名稱，重啓 dsh 後，在左側側欄打開 MCP & Skills。README 說明：倉庫未附帶編譯好的 lib/，不建議用 github: 簡寫從源碼構建；優先 npm 或 tarball。
可選：在 dsh Discover 頁或 plugin-market 的 indexes 中加入托管索引，實現一鍵安裝：
https://easun-zhu.github.io/dsh-cap-manager/market/index.json
索引要求 engines.dsh >= 0.2.1-rc.2，並從 npm 安裝包。
典型用法¶
項目 MCP 配置示例¶
可在 .dsh/mcp.yml 中手寫，也可在面板中維護。README 示例：
mcpServers:
projmini:
enabled: true # false = 保留配置但不掛載
transport: stdio
command: node
args: [./scripts/mcp.mjs]
env:
TOKEN: !!js process.env.MY_TOKEN # 掛載時求值
從其他編輯器遷入 MCP¶
在 MCP 標籤頁使用導入（⇩）：粘貼或上傳 mcpServers JSON，或通過 URL 拉取（瀏覽器端請求，目標需允許 CORS；GitHub raw 與多數靜態託管可用）。預覽確認轉換結果後應用，寫入路徑與面板編輯共用同一套校驗與熱更新邏輯。
管理 Skills 與插件¶
在 Skills 標籤頁搜索、編輯或導入 zip/URL；在 Plugins 標籤頁從 claude-plugins-official 市場安裝插件，並統一管理已安裝項。深色模式隨宿主主題自動切換。
更完整的設計與兼容性說明見倉庫 DESIGN.md。
適用場景與注意¶
適合：已在 dsh Web UI（或 desktop profile）中開發，需要在一個界面裏看清 global / profile / project 三層 MCP、集中管理多目錄 Skills，並希望在 dsh 內直接逛官方 Claude Code 插件市場的開發者。
注意：
- 插件以 當前 dsh 進程的權限 讀寫配置、掛載 MCP、掃描目錄；安裝前應閱讀源碼與 MIT 許可證，確認行爲符合你的安全策略。
- MCP 導出含 明文密鑰；生產環境導出前需自行脫敏或限制分發範圍。
- URL 導入在瀏覽器執行，依賴目標站點的 CORS；內網或無 CORS 的地址需改用粘貼或本地上傳。
- DSH 生態強調「一切皆插件」；skillhub.cn 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文所述市場索引由插件維護者託管，非 dsh 內置商店。
結尾¶
經過上面的步驟，你可以在 dsh 側欄用 MCP & Skills 一塊麪板完成 MCP 分層管理、Skills 全目錄運維，以及 claude-plugins-official 插件的安裝與聯動。進一步瞭解請訪問目錄頁 easun-zhu/dsh-cap-manager 與 GitHub 倉庫 easun-zhu/dsh-cap-manager。
