dsh-skill-viewer 是什么？让 DeepSeek Harness 技能与 MCP 可视化

dsh-skill-viewer 是 DeepSeek Harness（DSH Plugin）的 Web UI 插件，在设置页同时提供「技能」与「MCP」两个管理面板，并随包提供统一的 dsh-panel 终端命令，让你在浏览器里完成技能与 MCP 服务器的可视化管理和批量操作。 本文围绕官方 README 介绍它是什么、核心功能、完整的安装更新卸载命令、典型用法与常见排错，助你在 DSH Plugin 生态中摆脱手动编辑文件来管理技能与 MCP。

dsh-skill-viewer 是什么？

dsh-skill-viewer 解决的是 DeepSeek Harness（DSH）中技能与 MCP 服务器缺乏可视化管理的问题：它在 Web 设置页提供技能与 MCP 两个管理面板，让你直接在浏览器里查看、启停、删除、迁移技能，并管理 MCP 服务器配置，无需手动编辑文件。 以下定位与事实均来自官方 README（来源）：

dsh-skill-viewer 由 fishquito7 维护、采用 MIT 协议开源。它在 GitHub 上已更名为 dsh-skill-mcp-panel（原 dsh-skill-viewer），安装包名与仓库命令均以 dsh-skill-mcp-panel 为准。它属于 DSH Plugin 生态的 UI 类插件：技能实体仍存放在磁盘上各自的技能目录（全局 ~/.dsh/skills 或工作区 .dsh/skills），页面与命令行只是这些文件的「管理器」，没有隐藏存储或联接点——卸载插件后技能仍是普通文件，照常被 DSH 发现。核心能力覆盖技能卡片列表、工作区分栏、批量迁移、技能分组、作用域化管理，以及 MCP 面板的 Stdio/HTTP 支持。

dsh-skill-viewer 的核心功能有哪些？

dsh-skill-viewer 的核心能力围绕「技能可视化 + MCP 可视化」展开：技能面板负责技能卡片列表、增删启停、批量迁移与分组，MCP 面板负责服务器配置、热加载与连接测试，全部操作热生效、无需重启网关。 这些能力全部来自官方 README（来源）：

• 技能卡片列表：预览已注册安装的技能，点击卡片展开完整内容，带启用/停用状态标签，支持按名称搜索，进入页面自动刷新。
• 技能增删与拖拽添加：点击“+”选择 .md 或 .zip 文件，或直接把文件、压缩包、技能文件夹拖进页面，自动识别目录束/单文件/压缩包结构，不合规内容会被拒绝并提示原因。
• 工作区分栏：技能实体存放在所属位置（全局 ~/.dsh/skills 或工作区 .dsh/skills），点击工作区横栏即只显示该工作区下的技能。
• 批量迁移：在对话框内选择源/目标工作区（可多选）与技能，批量复制或移动；逐个迁移、失败不影响其余，移动模式限单个目标。
• 技能分组：新建/重命名/删除分组并按分组筛选；分组配置只写入 ~/.dsh/skills/.system/skill-viewer/groups.json，不修改技能目录。
• 作用域化管理与 MCP 面板：同名技能存在于多个作用域时按（名称+作用域）精确操作；MCP 面板管理 cordis.patch.yml 受管块，支持 Stdio 与 HTTP（streamable-http），保存后由 DSH HMR 热加载。

怎么安装与启用 dsh-skill-viewer？

安装 dsh-skill-viewer 推荐走官方发行版 tarball，一条 dsh plugin 命令装进当前 profile，重启网关后刷新页面即启用；更新用 dsh-panel update，卸载用 dsh plugin remove。 以下命令与事实均来自官方 README（来源），参考命令默认指定 --profile web，需要更改 profile 请自行调整：

1. 安装 dsh-skill-viewer：在 DeepSeek Harness 终端执行安装命令。官方首选发行版 tarball——不走 Git，不受 pnpm v11 构建脚本限制：

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

等待命令输出安装完成。

2. 从 Git 安装（备选）：也可以用 Git 方式安装同一插件：

dsh plugin --profile web add github:Fishquito7/dsh-skill-mcp-panel

Git 来源的依赖默认禁止运行 prepare 构建脚本；若报 “git-hosted plugins build on install...”，把 pnpm 打印的 key 加到 profile 目录 pnpm-workspace.yaml 的 allowBuilds 下再重跑。

3. 启用：重启网关并确认面板：安装完成后重启网关：

dsh-restart

重启后刷新页面，设置页「插件」下方即出现「技能」面板，其下方为「MCP」面板。

4. 更新 dsh-skill-viewer：使用 dsh-panel 检查并更新插件：

dsh-panel update [--yes]

也可以单独更新子命令族：dsh-panel skill update 更新技能命令，dsh-panel mcp update 更新 MCP 命令。

5. 卸载 dsh-skill-viewer：从当前 profile 移除插件：

dsh plugin --profile web remove dsh-skill-mcp-panel

卸载后技能仍是磁盘上的普通文件，不会被删除。

dsh-skill-viewer 典型用法

dsh-skill-viewer 的典型用法是双入口：浏览器面板负责可视化操作，dsh-panel 命令行负责脚本化批量管理，两者最终都改动磁盘上的技能文件或 cordis.patch.yml，DSH 文件监听器立即发现变化、无需重启网关。（来源）以下四个步骤覆盖从列出现有技能到配置 MCP 服务器的日常用法。

1. 列出并添加技能：查看全部技能（含所属工作区），并把 .md 文件、目录束或 .zip 压缩包添加到全局：

dsh-panel skill list
dsh-panel skill add ./my-skill.md

2. 按工作区添加与迁移技能：直接添加到指定工作区，或用 scope/migrate 在全局与工作区之间复制或移动（--copy 复制，默认移动）：

dsh-panel skill add ./my-skill.md --workspace D:\项目A
dsh-panel skill migrate all --from 全局 --to D:\项目A --copy --yes

3. 管理技能启停与删除：按名称停用、启用或删除（删除需确认）；同名技能存在于多个作用域时需加 --global / --project / --workspace 显式指定：

dsh-panel skill disable <name>
dsh-panel skill enable <name>
dsh-panel skill delete <name>

4. 添加并测试 MCP 服务器：用 --stdio 添加本地命令服务器，或用 --http --url 添加 streamable-http 服务器，然后测试连接：

dsh-panel mcp add --name <serverName> --stdio --command <cmd>
dsh-panel mcp test <serverName>

dsh-skill-viewer 常见问题与排错

dsh-skill-viewer 最常见的四类问题是 Git 安装被 pnpm 构建脚本拦截、同名技能作用域混淆、安装后面板不出现、CLI 找不到其他工作区的技能，分别按 allowBuilds 配置、作用域参数、重启网关与 --cwd 解决。（来源）

1. Git 安装报 “git-hosted plugins build on install...”：症状是 Git 方式安装时 pnpm 拒绝运行构建脚本；原因是 Git 来源的依赖默认禁止运行 prepare 构建脚本（pnpm v11）。解决：把 pnpm 打印的 key 加到 profile 目录 pnpm-workspace.yaml 的 allowBuilds 下再重跑，或改用官方发行版 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

2. 同名技能操作报错或误操作：症状是启用/停用/删除同名技能时影响了错误的副本；原因是同一技能名同时存在于全局与某工作区。解决：命令行加 --global / --project / --workspace 显式指定要操作的作用域，页面各行独立展开、按（名称+作用域）精确操作：

dsh-panel skill disable <name> --global

3. 安装后设置页没有面板：症状是重启后刷新页面仍看不到「技能」「MCP」面板；原因是安装后没有重启网关。解决：执行 dsh-restart 重启网关，再刷新页面到设置页查看：

dsh-restart

4. CLI 找不到其他工作区的技能：症状是 dsh-panel skill list 看不到某个工作区的技能；原因是 CLI 只扫描当前目录锚定的项目根与用户根。解决：在命令中加 --cwd 指向工作区路径：

dsh-panel skill list --cwd D:\项目A

适用场景与注意

dsh-skill-viewer 适合所有希望可视化、批量地管理 DSH 技能与 MCP 服务器的场景，但技能实体与受管配置仍以磁盘文件为准，bundled 技能只读，且参考命令默认 --profile web。（来源）

适用场景包括：技能数量多、需要按工作区与分组筛选管理；需要在多个工作区之间批量复制或迁移技能；希望用浏览器而不是编辑文件来配置 MCP 服务器；以及在无界面环境下用 dsh-panel 脚本化操作。注意事项：

1. 随部署附带的技能（bundled）为只读，不可停用或删除；只有用户添加的技能可以启停、删除或迁移。
2. 停用 = 把 SKILL.md 改名为 SKILL.md.disabled，启用 = 改回来；所有操作都是对磁盘文件的真实改动，DSH 文件监听器立即发现，热生效、无需重启网关。
3. MCP 配置写入 profile 的 cordis.patch.yml 受管块（以 # >>> dsh-skill-mcp-panel:mcp:begin / # <<< ...end 标记），请勿手改块内内容；真正连接和注册工具的是 DSH 官方插件 @deepseek-ai/dsh-mcp-client，由 DSH 的 HMR 自动加载。
4. 参考命令默认指定 --profile web，需要更改 profile 请自行注意；同名技能存在于多个作用域时，命令行必须显式指定作用域。

项目链接

dsh-skill-viewer 是 fishquito7 维护的 MIT 开源项目。 插件详情页：dsh-skill-viewer 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：Fishquito7/dsh-skill-mcp-panel。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。