DSH Service Manager:MCP 与 Skill 的统一管理页

前言

DeepSeek Harness(DSH)自带 MCP 接入能力,但没有配套的图形化管理界面。新增或调整 MCP 服务器通常要手写 YAML;连接是否成功往往得回到会话里试探。Skill 以磁盘上的文件存在,英文摘要读一遍就容易忘,日常运维成本偏高。

社区插件 DSH Service Manager(维护者 Baisbt)补的是这一页:在侧边栏提供 服务管理,用表格完成 MCP 的增删改查与启停,并浏览 DSH 可见的 Skill,用你配置的模型翻译摘要。插件通过官方 cordis:include 机制加载自己的配置片段,不会改写你手写的 cordis.patch.yml。

这是什么

DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。本文介绍的是上述开源仓库的行为,以 README 与 package.json 为准。

核心功能

MCP 服务器

下面能力均来自插件 README 的功能说明。

  1. 无 YAML 的 CRUD:在表格中新增、编辑、删除、启用或禁用 MCP 服务器。
  2. 展开工具列表:点击行可展开该服务器注册的工具,每行一个工具,悬停可看完整英文描述。
  3. 工具抽屉:上方为翻译后的摘要,下方为参数表;参数说明可翻译,参数名保持英文(与调用时一致)。
  4. 重连状态可见:保存后后台刷新 include,页面轮询重连状态,而不是长时间阻塞。
  5. ${ENV_VAR}:密钥建议写在环境变量引用中,避免明文落入配置文件。
  6. 可选 token 列:若另行安装 dsh-context,可显示各服务器工具定义占用的 token,并跳转到上下文仪表盘;未安装时该列不出现。

Skill

  1. 浏览 DSH 可见的全部 Skill,摘要与正文分层展示。
  2. 用自有模型翻译摘要:模型选择器列出 DSH 中配置的 provider × model,默认使用你的默认模型,并记住选择。
  3. 跟随界面语言:摘要译成 DSH 当前界面语言;若原文已是该语言则直通,不消耗 token。
  4. 译文 / 原文 切换整表,单卡 ↻ 可重新翻译,工具栏支持批量重新翻译。
  5. 磁盘缓存:再次访问时零额外请求(缓存键为原文哈希)。
  6. 失败可见:模型无法交付时卡片标注 机翻,不伪装成功。
  7. 删除 Skill、在文件管理器中打开:抽屉内路径旁按钮可在资源管理器中选中对应 SKILL.md。
  8. 使用统计(可选):安装 dsh-context 时,卡片可显示近 7 天该 Skill 被加载次数。

翻译只影响你阅读的内容;不会修改 SKILL.md,模型仍收到原始英文 prompt。

Agent 工具 mcp_service

插件还向对话注册 mcp_service 工具,例如可在会话中说「安装 filesystem MCP」,而不必切页操作。

Action 作用 是否需要审批
list 列出服务器、传输方式、状态、工具数量 否
install 添加或更新服务器 是
remove 删除服务器 是
enable / disable 启停服务器 否

需审批的操作走 DSH 一次性授权;拒绝、取消或无可用应答者时不改动配置(fail closed)。畸形参数在进 prompt 前被拒绝。

界面

页面基于 DSH 设计 token 构建,明暗主题随应用自动切换。

环境与依赖

  • DeepSeek Harness:>= 0.2.0-rc.1 且 < 0.3.0(README 与 package.json 的 engines.dsh 一致)。
  • pnpm 需在 PATH 中(插件管理器使用)。
  • 桌面端:Windows、macOS 或 Linux。

安装与启用

  1. 打开 Settings → Plugins,在安装框粘贴以下任一来源(摘自 README):
github:Baisbt/Baisbt-dsh-service-manager

或

https://github.com/Baisbt/Baisbt-dsh-service-manager
  1. 安装后 刷新页面(Ctrl+R)。侧边栏应出现 服务管理 入口。

README 说明:npm 包名安装待包发布后即可使用。若要从不同来源重装同一包(例如此前用本地目录安装过),需先清理 node_modules 下残留,否则可能出现 ERR_PNPM_EPERM(详见仓库 FAQ)。

典型用法

MCP

  • 点击表格行展开该服务器的工具列表。
  • 展开带工具的服务器后,工具栏会出现模型选择器;选定模型后可翻译工具摘要。

Skill

  • 默认摘要为英文。选择模型后点 重新翻译全部,卡片填入译文。
  • 用 译文 / 原文 切换整表显示;单卡 ↻ 仅重译该条。

打开配置目录

页面提供入口,用系统文件管理器打开当前 profile 目录(Windows explorer.exe / macOS open / Linux xdg-open)。仅打开文件夹,插件不代你编辑自有文件。

插件写入的文件

所有由插件拥有的数据落在 profile 目录,不触动其他路径。

路径 含义
<profile>/mcp-servers.yml 生成的 MCP 行,cordis:include 目标
<profile>/.dsh-service-manager/servers.json 服务器列表源数据
<profile>/.dsh-service-manager/translations.json 翻译缓存
<profile>/.dsh-service-manager/settings.json 模型选择等设置
<profile>/.dsh-service-manager/diagnostics.json Agent 工具与加载探测状态

<profile> 为 ~/.dsh/profiles/<name>;Windows 上示例为 %USERPROFILE%\.dsh\profiles\desktop。

安全边界(README):

  • 不修改 cordis.patch.yml、cordis.yml、.credentials.yaml。
  • Host 半部分在 DSH 进程内运行,位于工作区沙箱之外;安装前宜自行审阅源码与许可证(MIT)。

工作原理概要:

cordis.patch.yml(插件自带)
  └─ service-manager          ← Host:路由、Agent 工具、翻译
  └─ service-manager-mcp
       cordis:include → ./mcp-servers.yml

页面通过 /api/service-manager/* 读写;写入后刷新 include 子树以触发 MCP 桥重连,客户端轮询状态。

适用场景与注意

适合:经常在 DSH 里增减 MCP、需要一眼看工具清单与连接状态;Skill 较多、希望用本地已配模型把英文摘要译成界面语言后再挑选。

注意:

  1. 版本需落在 DSH 0.2.0-rc.1~0.3.0 区间,否则不满足 peerDependencies。
  2. 翻译与 MCP 管理依赖你配置的模型与网络;失败时会标明机翻,不应 Assume 摘要一定准确。
  3. 与 dsh-context 的集成是可选增强,非安装本插件的前提。

结尾

DSH Service Manager 把「改 YAML、翻目录、猜 MCP 是否连上」收成侧边栏的一页:MCP 表格化运维,Skill 可读性由你自己的模型补齐,且通过独立 include 文件承载 MCP 配置,尽量不碰你原有的 Cordis 主配置。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye