前言¶
DeepSeek Harness 的核心理念是「一切皆插件」。在本地开发或使用过程中，管理技能文件与 MCP 服务器配置通常需要手动编辑 YAML 文件，这种方式容易出错且缺乏可视化的调试手段。dsh-mcp-skills 插件为此提供了直接的网页管理入口，将原本分散的配置项集中到了 Web 界面。
插件定位¶
这是一个由 Lrxc 维护的 DeepSeek Harness 客户端插件。它通过注入代码，在网页设置面板中新增了「Skills」和「MCP」两个管理页面，用于集中管理用户自有技能及 MCP 服务器配置。
核心功能¶
Skills 页面¶
该页面用于管理用户自有技能。支持对技能进行浏览、导入（ZIP 格式）、删除和开关操作。技能文件存储于 $DSH_HOME/skills 目录中。
- 导入规则：ZIP 导入支持单个技能（根目录 SKILL.md 或 <name>/SKILL.md）或多个技能目录。
- 去重处理：已存在的技能不会被覆盖；template/ 目录会被跳过；导入结果会显示跳过的数量。
MCP 页面¶
该页面用于管理 MCP 服务器配置，支持 stdio 和 Streamable HTTP 两种类型。
- 配置存储：MCP 服务器配置保存在 $DSH_HOME/mcp-servers.yaml。
- 集成写入：启用的服务器会被写入当前 profile 的 cordis.patch.yml，并在重启 dsh 后自动连接。
- 工具注册：挂载的工具名称格式为 mcp__<server>__<tool>。
- 文件操作：插件只增删自己生成的 mcp-* 行，不改动该文件的其他内容（注释、锚点与 !!js 表达式都会原样保留）。写入操作是原子的，并会保留一份 .bak 备份。
连接测试¶
提供连接测试功能，超时时间为 15 秒。若测试超时，连接会被关闭并回收子进程。测试与真实挂载使用同一套环境清洗规则。
安装与启用¶
前置要求¶
- 已安装带 web profile 的 DeepSeek Harness (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 --profile web
注意事项¶
- 配置文件语法检查：若 profile 的
cordis.patch.yml存在语法错误，插件会拒绝改写并报错，不会覆盖文件。 - 环境变量清洗：出于安全考虑，环境变量中的
*_KEY/*_PASSWORD/*_SECRET/*_TOKEN与DSH_*变量不会传递给 MCP 子进程。如需凭据，请在服务器的环境变量里显式配置。 - 测试按钮依赖：页面的「测试」按钮使用宿主安装自带的 MCP SDK（列为可选 peer 依赖，不随本包重复安装）。若宿主未提供该 SDK，只有测试按钮会提示不可用，技能管理与其余 MCP 功能不受影响。
总结¶
dsh-mcp-skills 通过 Web 界面解决了 DSH 环境下技能与 MCP 服务器配置分散、难以管理的痛点。它提供了可视化的增删改查能力，并保留了文件操作的原子性与安全性。
- GitHub 仓库：https://github.com/Lrxc/dsh-manage-hub
- 插件目录：https://www.skillhub.cn/plugins/Lrxc/dsh-manage-hub
