前言¶
在 DSH Web 客戶端裏，Skill 與 MCP 往往要頻繁增刪、啓停和改配置。若管理入口占滿左側欄和中央主區，會和日常對話、插件列表搶同一套「全局面板」槽位，對只想在設置裏順手維護清單的用戶也不直觀。
上游 Fishquito7/dsh-skill-mcp-panel 在 2.1.0 把「技能」「MCP」遷到了主頁側欄 + 中央主區；維護者 jipika 的 jipika/dsh-skill-mcp-panel 是在本機使用的改版快照：基於上游 2.1.0（MIT），只改一處客戶端掛載方式——管理入口放進設置窗口的兩個獨立分欄（settings.section），不再佔用 sidebar.panellist 與 main。下面介紹該改版的定位、能力與安裝注意點。
這是什麼¶
dsh-skill-mcp-panel 是 DSH 客戶端插件：在 Web 端提供 Skill 與 MCP 的可視化管理，並隨包提供統一終端命令 dsh-panel（skill / mcp 兩個子命令族）。配置與技能文件仍落在磁盤與 profile 的受管塊裏，變更由 DSH 文件監聽或 HMR 熱加載，一般無需爲單次編輯重啓網關。
jipika 倉庫在 README 中明確說明：這不是上游官方發佈渠道，而是本地改版快照；與上游同 entry id，不能並存。差異集中在 lib/client.js：入口從側欄行 + 中央主區改爲設置分欄；並去掉只服務於「返回對話」按鈕的 layout 硬依賴（避免設置模態框環境下 layout 缺席導致整個插件不裝載）；另含探針 tests/settings-sections-probe.mjs。包版本號爲 2.1.0-local.1，許可證 MIT（上游版權歸 Fishquito7）。
目錄頁：SkillHub · jipika/dsh-skill-mcp-panel（社區目錄，與 DeepSeek / 幻方無官方從屬關係）。
與上游 2.1.0 的界面差異¶
| 維度 | 上游 Fishquito7 2.1.0 | jipika 改版 |
|---|---|---|
| 入口槽位 | sidebar.panellist + main，點擊左欄項切換中央主區 |
settings.section，設置窗口內兩個分欄 |
| 「返回會話」 | 面板左上角箭頭，依賴 ctx.layout.selectPanel(null) |
去掉對 layout 服務的硬依賴 |
| 並存 | — | 與上游同插件 id，只能裝其一 |
功能面（Skill 列表、MCP 寫 cordis.patch.yml 受管塊、dsh-panel CLI 等）仍繼承上游 README 描述；變的是從哪裏打開這兩套管理 UI。
核心功能¶
Skill 管理¶
- 卡片列表預覽已註冊 Skill，可展開查看完整內容；啓用 / 停用標籤與內置插件列表同款樣式。
- 支持搜索、熱啓停、刪除；進入頁面自動刷新。
- 添加：點「+」選
.md/.zip，或拖拽文件、壓縮包、技能目錄；自動識別結構，不合規會拒絕並提示。 - 工作區分欄：全局技能在
~/.dsh/skills，工作區技能在<工作區>/.dsh/skills；列表下方工作區選擇器（摺疊下拉，最多顯示 11 項，其餘滾動）切換可見範圍。 - 批量遷移：源 / 目標工作區（目標可多選）與技能在對話框內選擇，支持複製或移動；移動模式限單個目標。
- 分組：分組配置寫入
~/.dsh/skills/.system/skill-viewer/groups.json，不改動技能目錄本身。 - 作用域：同名 Skill 在全局與工作區並存時，刪、啓停、查看按「名稱 + 作用域」精確操作；CLI 需
--global/--project/--workspace顯式指定。
停用 Skill 即將 SKILL.md 改名爲 SKILL.md.disabled，啓用則改回；遷移爲真實複製 / 移動文件。
MCP 管理¶
- 管理當前 profile 下
cordis.patch.yml中由插件維護的 MCP 服務器塊。 - 支持 Stdio（本地命令）與 HTTP（streamable-http）；可新增、編輯、啓停、刪除、測試連接。
- 保存後由 DSH HMR 熱加載；
env/headers在 RPC 與頁面脫敏，編輯時缺省 key 保留舊值。 - 受管塊由
# >>> dsh-skill-mcp-panel:mcp:begin/# <<< ...end標記，塊外用戶內容逐字節保留；實際連接由官方插件@deepseek-ai/dsh-mcp-client負責。
命令行 dsh-panel¶
README 默認示例使用 profile web；換 profile 需自行加 --profile。
技能常用示例：
dsh-panel skill --help
dsh-panel skill list
dsh-panel skill add <path>
dsh-panel skill add <path> --workspace D:\項目A
dsh-panel skill enable <name>
dsh-panel skill disable <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 test <serverName> [--profile <name>]
CLI 掃描當前目錄錨定的項目根與用戶根；管理其他工作區技能可加 --cwd <工作區路徑>。
DSH 版本兼容¶
同一份構建同時兼容 DSH 0.1.5-rc.2 及更早（TypertCodec 讀 schema）與 0.1.6-alpha.2 及以後（讀 create）。上游 README 記載側欄 + 主區方案在 0.1.6-alpha.2 實測；jipika 改版改爲設置分欄後，不再要求側欄全局面板槽位，但仍需宿主支持 settings.section 註冊。
安裝與啓用¶
README 中的安裝步驟針對上游預構建產物（側欄 + 中央主區 UX）。若你安裝的是 Fishquito7 的 Release / npm 包，得到的是上游界面，不是 jipika 的設置分欄行爲。要使用 jipika 改版，應安裝其 GitHub 倉庫 jipika/dsh-skill-mcp-panel 所描述的構建方式；倉庫 README 未單獨列出 jipika 的 dsh plugin add 一行命令時，不要與上游命令混用 expecting 分欄 UI。
上游 README 給出的安裝方式（ --profile web，bundle 自動掛載）如下，供對照生態與 CLI 習慣；安裝下列包即上游入口，非本改版：
方式一：GitHub Release tarball（Fishquito7 v2.1.0）
dsh plugin --profile web add https://github.com/Fishquito7/dsh-skill-mcp-panel/releases/download/v2.1.0/dsh-skill-mcp-panel-2.1.0.tgz
方式二：npm
dsh plugin --profile web add dsh-skill-mcp-panel
方式三：從 Git 安裝上游倉庫
若出現 “git-hosted plugins build on install…”，按終端提示把 key 寫入 profile 目錄 pnpm-workspace.yaml 的 allowBuilds 後重試：
dsh plugin --profile web add github:Fishquito7/dsh-skill-mcp-panel
安裝任一變體後需重啓網關，再刷新 Web 頁面。jipika 改版就緒後，應在設置窗口內看到「技能」「MCP」分欄，而不是側欄「插件」下方的兩項。
卸載（資料原文）：
dsh plugin --profile web remove dsh-skill-mcp-panel
回滾到上游：整包替換爲 Fishquito7 版本；README 頂部記錄了與上游的全部差異。
典型用法¶
- 打開 DSH Web 設置，進入 jipika 改版掛載的 Skill 分欄：用工作區選擇器限定
~/.dsh/skills或某項目.dsh/skills，搜索後啓停或刪除；用「+」或拖拽添加.md/.zip/ 目錄束。 - 在同一設置窗口打開 MCP 分欄：新增 Stdio 或 HTTP 服務器，保存後測試連接；確認
cordis.patch.yml受管塊外手寫內容未被改寫。 - 在終端用
dsh-panel skill list/dsh-panel mcp list --profile web與頁面對照；多作用域同名 Skill 時，CLI 必須帶--global或--workspace等 flags。
適用場景與注意¶
適合誰：希望在 DSH Web 設置裏集中維護 Skill 與 MCP、又不想長期佔用側欄與中央主區全局面板的用戶；已熟悉上游 dsh-panel 工作流、只需換 UI 入口的開發者。
務必注意：
- 插件以當前 dsh 進程權限運行；安裝前請閱讀 jipika 倉庫 源碼與 MIT 許可證，並知悉其聲明爲本地改版快照、非上游發佈渠道。
- 與上游 不能並存（同 entry id）；切換版本需先卸載再替換包。
- 資料中的 Star 數爲 0（SkillHub 抓取）；功能描述以 README 與 package 描述爲準，勿與未覈實的第三方教程混用。
- MCP 密鑰僅脫敏展示，仍寫入 profile 配置；共享機器與備份
cordis.patch.yml時需自行管控權限。
結尾¶
jipika 的 dsh-skill-mcp-panel 在保留上游 Skill / MCP 管理能力與 dsh-panel CLI 的前提下，把 Web 管理入口收進設置窗口分欄，並去掉對 layout 的硬依賴，適合偏好「設置裏維護、主界面留給對話」的佈局。需要側欄全屏面板或官方 Release 通道時，應選用 Fishquito7/dsh-skill-mcp-panel。
- 目錄頁：https://www.skillhub.cn/plugins/jipika/dsh-skill-mcp-panel
- GitHub：https://github.com/jipika/dsh-skill-mcp-panel
