zebbkira/dsh-skills-mcp-manager

dsh-skills-mcp-manager

DeepSeek Harness 是 DeepSeek 官方的 AI 编程助手框架，命令行工具叫 dsh，提供 Web UI、Headless 等运行模式，并通过插件机制扩展能力。

本插件是其中一个独立插件：在 DeepSeek Harness Web GUI 的「设置」页新增一个独立的「技能与 MCP」页面（一级导航入口，与「插件」等并列），用于管理技能（skills）与 MCP 服务器。

MCP 是真实连接：启用的服务器会通过 @deepseek-ai/dsh-mcp-client 真正连上，并把工具注册为 mcp____；启用 / 禁用会实际连接 / 断开。

功能

Skills 技能

- 区分项目级 / 用户级，按来源分组（.dsh/skills、.agents/skills、~/.dsh/skills、~/.agents/skills）。
- 启用 / 禁用：改写 SKILL.md 前言的 disable-model-invocation + user-invocable，可逆。
- 删除：两步确认，物理删除技能目录（bundle）或平铺 .md 文件。
- 详情：查看 description、whenToUse 与完整正文。
- 导入：指定目录 → 扫描技能 → 勾选导入到 ~/.dsh/skills。支持系统原生目录选择器与手写路径两种方式。
- 搜索 / 过滤：按名称模糊搜索，按「已启用 / 未启用」过滤。

MCP 服务

- 表单或 JSON 两种方式新建服务器（stdio 的 command/args/env/cwd，或 streamable-http 的 url/headers）。
- 测试连接：一键真实连接探测。
- 启用 / 禁用：真正连接 / 断开，状态实时显示（连接中 / 运行中 / 失败 / 已停止）。
- 名称搜索、编辑、删除（两步确认）。
- 配置持久化到 ~/.dsh/mcp.json。

安装

方式一：从 npm 安装（推荐）

前置条件：Node.js >= 22.19，并先装好 dsh 命令行。

1. 全局安装 dsh（已装可跳过）
npm install -g @deepseek-ai/dsh
dsh --version      # 能打印版本号即成功

2. 把本插件装进 web profile
dsh plugin --profile web add @zebbkira/dsh-skills-mcp-manager@0.2.0

3. 重启 dsh web
dsh web

dsh plugin 会把包装进 profile 并自动把它加入插件层（本包声明了 dsh.bundle.patch），无需手动改任何配置。版本号 @0.2.0 可换成 npm 上的最新版。

方式二：从 GitHub 仓库安装（开发调试）

用于改代码调试，需要 Node.js >= 22 与 pnpm：

1. 克隆仓库
git clone https://github.com/zebbkira/dsh-skills-mcp-manager.git
cd dsh-skills-mcp-manager

2. 安装依赖并构建
pnpm install
pnpm build

3. 链接进 web profile
dsh plugin --profile web add link:$(pwd)

4. 重启 dsh web
dsh web

Windows PowerShell 下把第 3 步的 $(pwd) 换成完整路径，例如：

dsh plugin --profile web add link:E:\path\to\dsh-skills-mcp-manager

改完源码后重跑 pnpm build 再重启 dsh web 即可。

使用

安装并重启后，打开 DeepSeek Harness Web GUI，打开「设置」，在左侧导航选择「技能与 MCP」（与「插件」并列的一级入口），即可看到管理界面。

目录结构

src/
index.ts                    # Host 半区入口（插件加载 + 设置命名空间 + Agent 公告）
skills.ts                   # 技能文件系统引擎
mcp.ts                      # MCP 配置存储 + 真连接管理器
routes.ts                   # /api/dsh-skills-mcp 路由族
protocol.ts                 # 共享类型与 API 路径
client/
index.ts                  # 浏览器半区入口
SettingsCard.tsx          # 设置页面（一级入口的内容）
manager.tsx               # Skills / MCP 管理界面
api.ts                    # fetch 客户端
locales.ts                # 双语字典
settings-card.module.css
scripts/wrap-client.mjs       # 把浏览器半区打成模块加载器格式
cordis.patch.yml              # 插件注册行
package.json                  # dsh.bundle.patch + dsh.client 清单

MCP 真连接原理

Host 半区的 MCP 管理器在启动 / 保存配置时，把「已启用服务器」收敛成一组活跃连接：

- 每个启用的服务器通过 ctx.plugin(@deepseek-ai/dsh-mcp-client, config) 挂载一个实例，工具注册为 mcp____。
- 连接失败会在页面显示原因，点「测试连接」或重新保存可重试。
- 禁用 / 删除会断开连接并注销该服务器的全部工具。

服务器名（name）即 mcp-client 的命名空间，受 [A-Za-z0-9_-]{1,32} 约束且需全局唯一。

已知限制

- 只扫描四个可管理的技能根目录，不展示内置 / 运行时技能。
- 导入目的地固定为 ~/.dsh/skills，按目录名 / 文件名去重。
- MCP 服务器凭证（env / headers）以明文存于 ~/.dsh/mcp.json，请自行保证该文件权限（建议 0600）。