前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构，默认仅提供基础功能。在使用过程中，用户自有技能和 MCP 服务器往往需要额外的管理入口，否则只能通过文件系统或配置文件操作，操作链路较长且容易出错。
dsh-mcp-skills 是一个客户端插件，在 DSH 的网页设置面板中新增两个管理页面：Skills 和 MCP。它将这两个功能从命令行和配置文件中抽离，以图形界面方式提供浏览、导入、删除、开关等操作，适合需要在 Web 界面中快速配置和使用 MCP 服务器与自定义技能的开发者。
插件定位¶
- 名称：dsh-mcp-skills
- 维护者：Lrxc
- 分类：客户端
- 版本：0.2.3
- 许可证：MIT
这是一个为 DeepSeek Harness 提供的客户端插件，在网页设置中增加 Skills 和 MCP 两个管理页面，解决在 Web 界面下管理用户自有技能与 MCP 服务器配置的需求。
核心功能¶
Skills 管理¶
- 浏览用户自有技能列表
- 导入技能：支持单个技能（根目录 SKILL.md 或
/SKILL.md）或多个技能目录，template/ 会被跳过 - 删除技能
- 开关技能启用状态
技能文件存储在 $DSH_HOME/skills 目录下。
MCP 服务器管理¶
- 创建、编辑、删除 MCP 服务器配置
- 支持 stdio 和 Streamable HTTP 两种连接方式
- 连接测试：通过「测试」按钮验证配置是否正确
MCP 服务器配置保存在 $DSH_HOME/mcp-servers.yaml。启用的服务器会被写入当前 profile 的 cordis.patch.yml。重启 DSH 后，插件会自动连接已启用的服务器，工具注册为 mcp__<server>__<tool>。
行为说明¶
- 插件只增删自己生成的
mcp-*行，不改动 cordis.patch.yml 中的其他内容（注释、锚点与!!js表达式都会原样保留） - 写入操作是原子的，并会保留一份
.bak备份 - 若 profile 的 cordis.patch.yml 存在语法错误，插件会拒绝改写并报错，不会覆盖
- 连接测试 15 秒超时，超时后会关闭连接并回收子进程
- 环境清洗规则：
*_KEY/*_PASSWORD/*_SECRET/*_TOKEN与DSH_*变量不会传给 MCP 子进程，需要在服务器的环境变量里显式配置凭据 - 「测试」按钮使用宿主安装自带的 MCP SDK（列为可选 peer 依赖，不随本包重复安装）
- 已存在的技能不会被覆盖，导入结果会显示跳过数量
安装与启用¶
安装前需要满足以下条件：
- 已安装带 web profile 的 dsh
- PATH 中有 pnpm
从 npm 安装：
dsh plugin --profile web add dsh-mcp-skills
从 GitHub 安装：
dsh plugin --profile web add https://github.com/Lrxc/dsh-manage-hub.git
从本地目录安装：
git clone https://github.com/Lrxc/dsh-manage-hub.git
dsh plugin --profile web add file:./dsh-manage-hub
安装完成后重启 dsh：
dsh --profile web
卸载¶
如不再需要，可以通过以下命令卸载：
dsh plugin --profile web remove dsh-mcp-skills
卸载后，需要手动删除 profile 的 cordis.patch.yml 中生成的 mcp-* 行以及 $DSH_HOME/mcp-servers.yaml。
典型用法¶
安装完成后，在 DSH 的网页设置面板中会新增两个页面：
- Skills：在此页面浏览和操作
$DSH_HOME/skills下的技能，支持导入 zip 包或目录。 - MCP：在此页面管理 MCP 服务器配置，创建 stdio 或 HTTP 连接，配置完成后点击「测试」验证连通性。
配置生效后，重启 dsh，插件会自动连接已启用的 MCP 服务器，工具注册为 mcp__<server>__<tool> 格式。
适用场景与注意¶
适合在 DSH 中使用 MCP 服务器或自定义技能，并希望从网页界面进行统一管理的开发者。
注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证
- 技能文件和 MCP 配置文件的路径为 $DSH_HOME/skills 和 $DSH_HOME/mcp-servers.yaml
- 若 cordis.patch.yml 存在语法错误，插件会拒绝改写，不会覆盖
- 连接测试 15 秒超时，环境变量中的敏感信息不会传递给 MCP 子进程，需在服务器环境变量中显式配置
结尾¶
dsh-mcp-skills 在 DSH 的网页设置面板中为 Skills 和 MCP 提供了可视化管理入口，将文件系统操作转化为图形界面操作，减少配置出错概率。插件只增删自己生成的配置行，对现有配置保持最小侵入，适合需要在 Web 界面中频繁配置 MCP 服务器与自定义技能的开发者。
- 插件目录页：https://www.skillhub.cn/plugins/Lrxc/dsh-mcp-skills
- GitHub 仓库：https://github.com/Lrxc/dsh-mcp-skills
