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