dsh-skill-mcp-manager
DeepSeek Harness(DSH)插件:在会话内直接管理 Harness 的 Skill 和 MCP 服务器,并提供 Web 设置页可视化界面。
- Skill:列出、查看、创建、更新、删除 Harness 技能(写入 provider 根目录的
SKILL.mdbundle,文件系统 watcher 即时生效)。 - MCP:列出、查看、添加、更新、移除、重载 MCP 服务器(操作 loader 中的
@deepseek-ai/dsh-mcp-client条目,热插拔并持久化到 profile 配置)。 - 设置页 UI(
dsh web):设置 → "技能与 MCP" 分区,含 技能 与 MCP 两个标签页,可视化列表与表单,支持创建/编辑/删除/重载。
安装
# 在仓库根目录执行；相对路径会锚定到当前目录
dsh plugin --profile web add ".\dsh-skill-mcp-manager"包内 cordis.patch.yml 声明了 dsh.bundle,安装后会自动作为 bundle 层插入 skill-mcp-manager 条目;package.json 另声明 dsh.client(web 平台),web 启动时 dsh-client-modules 会把 lib/client.js 加入 boot 图并通过 /plugins/dsh-skill-mcp-manager/client.js 提供。重启 dsh web 后生效(设置页需要 web 界面)。
设置页可视化
重启 dsh web 后,打开 设置(齿轮) → 左侧新增 "技能与 MCP" 分区:
- 技能标签页:列出全部技能(名称 / 描述 / 来源 / 调用策略徽标),支持新建(选择用户级或项目级根)、编辑正文与 frontmatter、删除(带确认)。
- MCP 标签页:列出服务器(名称 / 传输方式 / 启用状态 / fiber 状态 / 工具数),支持添加(stdio 或 streamable-http 表单)、编辑、重载、删除(带确认)。
- 环境变量与请求头等敏感值不会回显;编辑时留空表示保持不变。
- 所有读写经由宿主命令桥(
/skill-mgr、/mcp-mgr,JSON 协议)完成,每次变更都会作为命令记录写入会话日志,形成可追溯的审计节点。
提供的工具
Skill 管理(skill_manager_*)
| 工具 | 作用 |
|---|---|
skill_manager_list | 列出当前会话可见的全部技能:名称、描述、来源根、provider、模型/用户调用策略 |
skill_manager_get | 获取单个技能的完整定义:正文、绝对路径、来源、策略、metadata |
skill_manager_roots | 展示文件系统 provider 扫描的所有技能根目录及存在状态 |
skill_manager_create | 创建技能为 <root>/<name>/SKILL.md;名称需为 kebab-case,root 支持 user / project / 绝对路径 |
skill_manager_update | 原地更新技能的前置元数据与正文;省略字段保持不变,传 null 删除 when_to_use / metadata |
skill_manager_delete | 删除技能(文件或整个 bundle 目录);破坏性操作,需 confirm: true |
技能文件格式与 @deepseek-ai/dsh-skill-filesystem 完全一致(--- 包裹的 YAML frontmatter:name / description / whenToUse / disable-model-invocation / user-invocable / metadata)。
MCP 管理(mcp_manager_*)
| 工具 | 作用 |
|---|---|
mcp_manager_list | 列出全部 MCP 服务器:条目 id、serverName、传输方式、端点、启用状态、fiber 阶段、已发布工具数 |
mcp_manager_get | 获取单个服务器的完整配置(env/headers 以表达式引用形式脱敏展示)与实时状态 |
mcp_manager_add | 添加服务器(stdio 或 streamable-http),立即激活并持久化 |
mcp_manager_update | 更新服务器配置(含切换传输方式、改名 serverName),热重启生效 |
mcp_manager_reload | 强制断开重连并重新发现工具 |
mcp_manager_remove | 移除服务器;破坏性操作,需 confirm: true |
MCP 配置字段与 @deepseek-ai/dsh-mcp-client 文档一致:transport / serverName / command / args / env / cwd / url / headers / toolCallTimeoutMs / failOnStartupError / reconnect.*。serverName 必须匹配 [A-Za-z0-9_-]{1,32} 且全局唯一。
人类命令
/skills— 直接列出当前技能(不经模型)。/mcp— 直接列出 MCP 服务器与状态。
配置
在 profile 的 cordis.patch.yml 中可覆盖:
- id: skill-mcp-manager
config:
mcpPlugin: '@deepseek-ai/dsh-mcp-client' # 管理的 MCP 插件条目名
skillDefaultRoot: user # 新建技能默认根:user | project工作原理
- Skill:所有读写都发生在 provider 扫描的根目录内;写入后插件通过
fs/observed事件同步通知 provider 失效,下一次ctx.skills观测即可见。 - MCP:通过 profile 的用户补丁层
cordis.patch.yml(dsh --profile每次启动都读取、且不会被重置的文件)持久化 MCP 服务器条目:增删改会原子重写该文件中的insert列表,并由补丁层 HMR watcher 热重排 loader 树,因此重启dsh web后服务器依然保留。若补丁层不可达(如测试 mock),则回退为仅热插拔的ctx.loader操作。 - 设置页数据桥:客户端 bundle 与宿主共用一套逻辑(
/skill-mgr、/mcp-mgr命令,JSON 协议)。浏览器通过固定 wire 契约ctx.remote.commands.execute(sessionId, line)调用宿主命令,拿到 JSON 结果渲染;命令生命周期记录(command/run/command/done)落在会话日志中,敏感输入不落盘(recordInput: false),响应中的 env/headers 值脱敏为redacted。 - 客户端提供:
dsh-client-modules扫描到本包的dsh.client声明后,把lib/client.js编入 boot 图并服务/plugins/dsh-skill-mcp-manager/client.js,浏览器侧 Cordis 以普通插件条目应用它,注册settings.section("技能与 MCP")与两个标签页。无需重新构建 DSH 前端。
开发
node test/smoke.mjs # 宿主端:工具 + /skill-mgr、/mcp-mgr 命令协议(需 @deepseek-ai 依赖)
node test/client-smoke.mjs # 客户端 bundle:加载、apply、插槽注册、命令桥与脱敏许可
MIT