前言¶
在 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
