dsh-skill-mcp-panel：DeepSeek Harness 技能与 MCP 面板 DSH plugin

dsh-skill-mcp-panel 是一个 DSH plugin，它把技能（skill）与 MCP 服务器的管理收进 DeepSeek Harness 设置页，做成可视化面板，并随包附带 dsh-panel 命令行。 它解决的是「技能和 MCP 配置散在磁盘和配置文件里、只能手改」的痛点。本文讲清三件事：这个面板是干什么的、怎么装怎么用、它和技能目录与 MCP 配置是什么关系与边界。（来源）

dsh-skill-mcp-panel 是干什么的：技能与 MCP 的可视化面板

dsh-skill-mcp-panel 在 DeepSeek Harness 设置页同时提供「技能」与「MCP」两个管理面板，把原先要手改文件的操作变成可视化点击（来源）。 它能管的东西：

1. 技能面板：以卡片列表预览已注册的技能，可展开看内容，支持启用/停用、删除、按名称搜索，进入页面自动刷新。
2. 技能添加与迁移：点加号选文件或把文件、压缩包、技能文件夹拖进页面即可添加，自动识别目录束、单文件与压缩包结构；迁移按钮支持在多个工作区之间批量复制或移动。
3. 工作区与分组：技能按全局或所属工作区存放，页面提供工作区选择器与分组管理；分组只写入插件自己的显示配置，不改动技能目录。
4. MCP 面板：管理 profile 配置里的 MCP 服务器，支持 Stdio 与 HTTP 两种调用方式，可新增、编辑、启停、删除与测试连接，保存后热加载生效。

两个面板面向的其实是两套不同的底层数据，管理动作也因此不同。技能面板动的是磁盘上的技能目录——技能实体直接存放在它所属的位置：全局技能在 ~/.dsh/skills，工作区技能在工作区的 .dsh/skills，面板只是给这些文件加了一层可视化入口。MCP 面板动的是 profile 里的配置块——它写的是目标 profile 的 cordis.patch.yml 受管块，改的是配置而非文件树。把两者的差别列成一张表，就知道每一步操作到底落在哪：

除了图形界面，它还给习惯终端的人准备了 dsh-panel 命令。dsh-panel 含 skill 与 mcp 两个子命令族，把面板上的动作原样搬到命令行：skill 族能列出、添加、迁移、启停、删除技能，mcp 族能管理 MCP 服务器。也就是说，同一件事你既能在设置页点着做，也能在终端敲命令做，两条路落到的是同一份磁盘数据。

技能的添加与迁移有几处细节值得先说清。添加支持的输入有三类：.md 单文件、.zip 压缩包，以及技能文件夹；点「+」选文件或直接拖拽到页面都行，插件会自动识别目录束、单文件还是压缩包结构，不合规的内容会被拒绝并提示原因，不会留下半成品。迁移则在对话框里手动选源工作区、目标工作区（可多选）与技能，默认不勾选任何技能、逐个迁移、失败不影响其余；要注意移动模式只允许单个目标，想同时铺到多个工作区，用复制而不是移动。

一句话：这个 DSH插件（DeepSeek插件）把技能与 MCP 这两个「要编辑文件才能改」的子系统，变成了设置页里可以点、可以拖、可以测的面板。

怎么安装与使用：从插件市场入口到 dsh-panel 命令行

这个 DSH plugin 装法规范、即装即用：从插件市场一键安装，或用命令行安装，装完重启网关即可在设置页看到两个面板（来源）。 按下面的顺序走，每一步都有明确的预期：

1. 安装：在 DSH Plugin Hub 里搜索 dsh-skill-mcp-panel 一键安装，或执行 dsh plugin --profile web add github:fishquito7/dsh-skill-mcp-panel。预期：安装完成后，该包进入当前 profile 的依赖清单。
2. 启用并重启：按提示启用插件，重启该 profile 的网关进程并刷新浏览器。预期：设置页里出现「技能」与「MCP」两个面板入口。
3. 用技能面板：进入设置页的「技能」面板，点加号选文件或直接拖入技能文件添加；用开关启停、用迁移按钮批量复制或移动。预期：新技能以卡片出现，状态标签随启停变化。
4. 用 MCP 面板：进入「MCP」面板，新增 Stdio 或 HTTP 类型的服务器，填写命令或 URL 与环境变量，保存后自动热加载。预期：保存后无需重启网关，MCP 服务器即被加载。
5. 验证：改动会直接作用于磁盘文件，DeepSeek Harness 的文件监听使其即时生效、无需重启。预期：技能面板里能看到新技能卡片、MCP 面板里能测试连接成功，即说明生效。
6. 命令行等价操作（可选）：习惯终端的话，用随包的 dsh-panel 完成同样的管理动作。预期：命令行结果与面板状态一致。

第 6 步的命令行写法，与面板动作一一对应：

# 技能：列出、添加、启停、删除
dsh-panel skill list
dsh-panel skill add <技能文件或目录>
dsh-panel skill disable <名称> --workspace <工作区路径>
dsh-panel skill delete <名称> --global

# MCP：新增（--stdio 或 --http 指定类型）、测试、启停
dsh-panel mcp add --name <serverName> --stdio --command <cmd>
dsh-panel mcp test <名称>
dsh-panel mcp enable <名称> --profile web

命令族支持用 --profile 指定目标 profile，默认 web；配置写入目标 profile 的 cordis.patch.yml 受管块，网关在线时自动热加载。技能相关的命令则用 --global / --project / --workspace 显式指定操作哪一份，找不到指定作用域会直接报错，不会回退误操作。

安装上有几条边界要提前知道。第一，市场条目与 GitHub 源码是两条安装路：市场一键装最省事；GitHub 源码安装时，若提示需要在安装期构建，要按官方说明把对应 key 加进允许构建列表——这等于放行该包的安装期执行权限，只对可信来源放行。第二，同名仓库不止一个：社区里同名的 dsh-skill-mcp-panel 有多个账号的版本，安装前确认来源仓库是 dsh-skill-mcp-panel 插件条目 指向的那个。第三，装完要重启：改完插件不重启进程，界面里看到的还是旧的一套。

与技能目录、MCP 配置的关系与边界

dsh-skill-mcp-panel 是「操作界面」，不是「数据总线」：它管理的仍是磁盘上的技能目录与 profile 里的 MCP 配置，只是把操作入口搬到了面板上（来源）。 关系与边界如下：

1. 技能数据仍归技能目录管：技能实体存在全局 ~/.dsh/skills 或工作区 .dsh/skills，面板改的是这些文件；目录发现与优先级规则不变，仍是《DeepSeek Harness Skills 放哪能被发现》讲的那套。
2. MCP 数据仍归 profile 配置管：面板管理的是 profile 中 MCP 服务器的受管块，改的还是 cordis.patch.yml，调用与合并规则仍按《DeepSeek Harness Skills 怎么用》那套子系统逻辑。
3. 分组是插件的私有数据：技能分组只写进插件自己的显示配置，路径为 ~/.dsh/skills/.system/skill-viewer/groups.json，不落到技能目录；卸载插件后分组信息随之消失，技能文件不受影响。
4. 同名技能按「名称+作用域」精确操作：同名技能同时存在于全局与工作区时，删除、启停、查看都按名称加作用域进行，页面各行独立操作，命令行用 --global / --project / --workspace 显式指定，不会误伤其他副本。
5. 密钥脱敏：env 与 headers 里的密钥在页面与 RPC 中脱敏显示，编辑时缺省 key 保留旧值，避免一改就清空已有密钥。

把「面板动作」和「底层落点」逐条对上，一张表就够了：

一句话：面板是「看得见的入口」，底下动的还是那套目录与配置，理解后者才能用对前者。

dsh-skill-mcp-panel 的常见误区

可视化让操作更顺手，但也容易让人忘记它改的是什么。 逐条纠正：

1. 「面板有独立的数据」——不是独立数据，而是磁盘目录与 profile 配置的一层入口。技能存磁盘目录、MCP 存 profile 配置，卸载插件不带走你的技能与 MCP。
2. 「改了能一键撤销」——不能。操作直接写磁盘与配置、没有撤销站，不是随手可回退，动手前要清楚改的是哪一层。
3. 「分组会写进技能目录」——不会。分组只写进插件自己的 groups.json，属于显示配置。
4. 「同名技能随便点一个就行」——不是随便点一个，而要看清作用域。同名副本按名称加作用域区分，命令行不指定作用域会报错。
5. 「装完立刻就能用」——不是装完就生效，而要重启网关。插件加载与热加载是两回事，装完不重启看到的仍是旧的一套。

注意事项与局限

可视化降低了门槛，但不改变底层规则。 逐条提醒：

1. 它不创造新能力：技能与 MCP 的能力还是由技能内容与 MCP 服务器决定，面板只是让管理更直观。
2. 分组是插件的私有数据：分组写在插件私有的 groups.json 里，卸载插件后分组信息随之消失，技能文件不受影响，重装后需重新分组。
3. GitHub 来源安装可能触发构建：若提示需要在安装时构建，要按官方说明把对应 key 加进允许构建列表，这等于放行该包的安装期执行权限，只对可信来源放行。
4. 存在多个同名仓库：社区里同名的 dsh-skill-mcp-panel 有多个账号的版本，安装前确认来源仓库，具体可查看 dsh-skill-mcp-panel 插件条目。
5. 它不接管 MCP 连接本身：面板只把配置写进 profile 的受管块，真正连接并注册工具的是官方 MCP 客户端插件，由 DeepSeek Harness 的 HMR 加载。

与其在磁盘里翻技能目录、再打开 profile 配置文件手改 MCP 服务器，不如装好社区官方的 DSH Plugin Hub（dsh-plugin.org/zh），在设置页里把这个面板和一些管理类插件一起装齐，技能与 MCP 都可视化操作。

来源：dsh-skill-mcp-panel（Fishquito7）、dsh-skill-mcp-panel 插件条目、DeepSeek Harness 官方文档 - Skills 子系统。