前言¶
在 DSH 裏維護 Skill 和 MCP 服務器，常見做法是直接改磁盤上的 SKILL.md、手動編輯 profile 裏的 cordis.patch.yml，或在多個工作區之間來回複製文件夾。技能多了以後，啓停狀態、作用域（全局 vs 工作區）、分組和批量遷移都容易出錯；MCP 側則要自己對齊 Stdio / HTTP 兩種形態，並留意密鑰字段別寫進日誌。
dsh-skill-mcp-panel 把這兩類操作收進 Web 設置頁的兩個面板，並附帶統一終端命令 dsh-panel（skill / mcp 兩個子命令族）。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-skill-mcp-panel 是 DSH 的客戶端（Web UI）插件，由 Fishquito7 維護，在設置頁同時提供「技能」與「MCP」管理界面。當前發行版本爲 2.0.1（MIT 許可證）。項目在 GitHub 上約有 101 stars、8 forks。
插件不引入隱藏存儲：技能實體落在 ~/.dsh/skills（全局）或 <工作區>/.dsh/skills；MCP 配置寫入目標 profile 的 cordis.patch.yml 受管塊，由 DSH HMR 熱加載。README 註明：文檔中的參考命令默認使用 --profile web；若你使用其他 profile，需自行調整。
技能面板¶
技能面板用於預覽、啓停、添加、刪除和遷移已註冊的 Skill，並與 DSH 內置插件列表採用同款狀態標籤樣式。
列表與日常操作¶
進入頁面會自動刷新。卡片列表展示已安裝技能，點擊可展開查看完整內容。支持按名稱搜索，以及開關熱啓用/停用、刪除。
停用與啓用的實現方式是對磁盤上的 SKILL.md 改名：停用改爲 SKILL.md.disabled，啓用改回原名。DSH 文件監聽器會立刻發現變化，無需重啓網關。隨部署附帶的 bundled 技能爲只讀，不可停用或刪除。
添加技能（0.7.0 統一入口）¶
點「+」可選擇 .md / .zip 文件，也可把文件、壓縮包或技能文件夾拖入頁面。插件自動識別目錄束、單文件或壓縮包結構；不合規內容會被拒絕並提示原因。
工作區分欄（0.3.0）¶
技能按所屬位置存放：全局在 ~/.dsh/skills，限定工作區在該工作區的 .dsh/skills。頁面「技能列表」下方有工作區橫欄（全局 + 各工作區，可橫向滾動），點擊後只顯示該工作區下的技能。
批量遷移¶
「+」左側的遷移按鈕打開對話框：手動選擇源工作區、目標工作區（可多選）與技能，支持批量複製或移動。默認不勾選任何技能；逐個遷移，單條失敗不影響其餘。移動模式限單個目標。源工作區有分組時，可在技能列表上方按分組篩選（0.7.0）。
技能分組（0.5.0）¶
工作區橫欄下方新增分組橫欄（全部 + 分組名）。「分組」按鈕（遷移按鈕左側）打開分組編輯器：新建/重命名/刪除分組、選擇工作區、命名並批量勾選成員。分組信息只寫入插件自己的顯示配置 ~/.dsh/skills/.system/skill-viewer/groups.json，不修改技能目錄。
作用域化管理（0.6.4）¶
同名技能同時存在於全局與某工作區時，刪除、啓停、查看內容均按（名稱 + 作用域）精確操作——頁面各行獨立展開、獨立操作，不影響其他作用域的副本；找不到指定作用域的條目會直接報錯，不會回退誤操作。命令行對同名技能也需用 --global / --project / --workspace 顯式指定。
MCP 面板（v2.0.0）¶
設置頁「技能」下方新增「MCP」頁，管理 profile cordis.patch.yml 中的 MCP 服務器受管塊。
- 支持 Stdio（本地命令）與 HTTP（streamable-http）兩種調用方式
- 支持新增、編輯、啓停、刪除、測試連接；保存後由 DSH HMR 熱加載，無需重啓網關
env/headers密鑰在 RPC 與頁面中脫敏，編輯時缺省 key 保留舊值cordis.patch.yml面板塊外的用戶內容逐字節保留
MCP 面板塊由 # >>> dsh-skill-mcp-panel:mcp:begin / # <<< dsh-skill-mcp-panel:mcp:end 標記；README 建議勿手改塊內內容。真正連接和註冊工具的是 DSH 官方插件 @deepseek-ai/dsh-mcp-client。
安裝與啓用¶
先做安裝，再重啓網關，最後在 Web 設置頁確認兩個面板是否出現。
1、安裝本包（bundle 層自動掛載，無需編輯配置文件）。首選發行版 tarball：
dsh plugin --profile web add https://github.com/Fishquito7/dsh-skill-mcp-panel/releases/download/v2.0.1/dsh-skill-mcp-panel-2.0.1.tgz
也可以從 Git 安裝（Git 來源的依賴默認禁止運行 prepare 構建腳本；若報 “git-hosted plugins build on install…”，把 pnpm 打印的 key 加到 profile 目錄 pnpm-workspace.yaml 的 allowBuilds 下再重跑）：
dsh plugin --profile web add github:Fishquito7/dsh-skill-mcp-panel
2、重啓網關：
dsh-restart
重啓後刷新頁面：設置 → 「插件」下方爲「技能」，其下方爲「MCP」。
卸載：
dsh plugin --profile web remove dsh-skill-mcp-panel
命令行：dsh-panel¶
統一父命令爲 dsh-panel。CLI 只掃描當前目錄錨定的項目根與用戶根；管理其他工作區的技能請加 --cwd <工作區路徑>。
技能子命令¶
查看幫助：
dsh-panel skill --help
常用示例：
dsh-panel skill list # 列出技能（含工作區：全局 / 工作區）
dsh-panel skill add <path> # 添加到全局（.md 文件、目錄束或 .zip 壓縮包）
dsh-panel skill add <path> --workspace D:\項目A # 直接添加到指定工作區
dsh-panel skill scope <name> --global # 遷移單個技能到全局
dsh-panel skill scope <name> --workspace D:\項目A # 遷移單個技能到指定工作區（--copy 複製）
dsh-panel skill migrate <name...|--all> --from <全局|路徑> --to <全局|路徑> [--copy] [--yes]
dsh-panel skill update [--profile <name>] # 檢查並更新插件（默認 web 配置）
dsh-panel skill disable <name> # 停用
dsh-panel skill enable <name> # 啓用
dsh-panel skill delete <name> # 刪除（需確認）
MCP 子命令¶
dsh-panel mcp list [--profile <name>]
dsh-panel mcp add --name <serverName> --stdio --command <cmd> [--args <arg> ...] [--env KEY=VALUE ...] [--cwd <path>] [--profile <name>]
dsh-panel mcp add --name <serverName> --http --url <url> [--header KEY=VALUE ...] [--profile <name>]
dsh-panel mcp enable|disable <serverName> [--profile <name>]
dsh-panel mcp remove <serverName> [--yes] [--profile <name>]
dsh-panel mcp test <serverName> [--profile <name>]
dsh-panel mcp update [--yes] [--profile <name>]
dsh-panel update [--yes] [--profile <name>] # 更新整個 dsh-skill-mcp-panel
適用場景與注意¶
適合需要在 DSH Web 設置頁集中管理 Skill 與 MCP、或在多工作區之間遷移技能的開發者。若你更習慣終端批量操作，dsh-panel 與頁面能力基本對齊。
安裝前建議自行檢查源碼與 MIT 許可證。插件以當前 dsh 進程權限讀寫 ~/.dsh/skills、工作區 .dsh/skills 及 profile 下的 cordis.patch.yml；在受信環境外安裝第三方插件前應評估權限範圍。SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/Fishquito7/dsh-skill-mcp-panel
- GitHub 倉庫：https://github.com/Fishquito7/dsh-skill-mcp-panel
