DSH Service Manager:在 DSH 里统一管理 MCP 与 Skill

前言

DeepSeek Harness(DSH)自带 MCP 桥接能力,但没有独立的 MCP 管理界面。要新增一个 MCP 服务器,通常得手写 YAML;要确认是否连上,往往得回到会话里再试一次。Skill 以磁盘上的 SKILL.md 存在,英文摘要读一遍就容易忘。

社区插件 DSH Service Manager(仓库 Baisbt/Baisbt-dsh-service-manager,维护者 Baisbt)补的是这一页:在侧边栏用 服务管理 查看、增删改查 MCP,浏览 Skill,并用你在 DSH 里配置的模型翻译摘要。它通过官方 cordis:include 机制加载插件自有的 MCP 配置,不会改写你手写的 cordis.patch.yml。

这是什么

DSH Service Manager 是 DSH 的 Web 侧栏插件(package.json 当前版本 0.13.2,许可证 MIT)。定位可以概括为:一页集中管理 MCP 服务器与 Skill——表格里完成 MCP 的增删改和启停,展开行看工具列表;Skill 列表支持译文/原文切换和批量翻译。另注册 Agent 工具 mcp_service,在对话里也能列出、安装、删除或启停 MCP(敏感操作走 DSH 一次性授权)。

核心功能

MCP 服务器

  1. 无需直接改 YAML 的 CRUD:在表格里添加、编辑、删除、启用/禁用服务器。
  2. 展开工具列表:每个已注册工具一行,悬停可看完整英文描述。
  3. 工具抽屉:上方为翻译后的摘要,下方为参数表;参数说明可翻译,参数名保持英文(与调用时一致)。
  4. 重连状态可见:保存后后台刷新 include;页面轮询重连状态,而不是长时间转圈。
  5. 环境变量占位:支持 ${ENV_VAR},密钥留在环境变量而非明文写在配置里。
  6. 可选 dsh-context 集成:若已安装 dsh-context,可看到各服务器工具定义占用的 token 数,并跳转到上下文面板;未安装则该列不显示。

Skill

  1. 浏览 DSH 可见的全部 Skill:摘要与正文分两层展示。
  2. 用自有模型翻译摘要:模型选择器列出 DSH 中配置的 provider × model,默认跟你的默认模型,并记住选择;译文语言跟随 DSH 界面语言;已是目标语言的文本直通,不浪费 token。
  3. 译文 / 原文 切换整表,单卡 ↻ 重译,工具栏可 重新翻译全部;译文缓存到磁盘,二次访问不发请求。
  4. 翻译失败会标明 机翻,不假装成功;不修改 SKILL.md,模型仍读英文原文。
  5. 支持从页面删除 Skill;抽屉中路径旁按钮可在文件管理器中定位 SKILL.md。
  6. 配合 dsh-context 时,卡片可显示近 7 天该 Skill 被加载的次数。

Agent 工具 mcp_service

动作 作用 需授权
list 服务器、传输方式、状态、工具数量 否
install 添加或更新服务器 是
remove 删除服务器 是
enable / disable 启停服务器 否

拒绝、取消或无可用应答方时不改动配置(fail closed);畸形参数在进入提示前即被拒绝。

界面使用 DSH 设计 token,明/暗主题随应用切换。

安装与启用

环境要求(摘自 README):

  • DeepSeek Harness:>= 0.2.0-rc.1 且 < 0.3.0
  • pnpm 在 PATH 中(DSH 插件管理会用到)
  • Windows、macOS 或 Linux 桌面版 DSH

安装步骤:

  1. 打开 Settings → Plugins,在安装框粘贴下列任一条:
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)。

DSH 插件目录站(SkillHub 等)与 DeepSeek / 幻方无官方从属关系;安装源以你在 DSH 设置里填写的 GitHub 地址为准。

典型用法

MCP:点中行展开工具列表;若有带工具的服务器已展开,工具栏会出现模型选择器,选模型后可翻译工具摘要。

Skill:摘要默认英文;选好模型后点 重新翻译全部 填充卡片;用 译文 / 原文 切换整表,单卡 ↻ 只重译该条。

打开配置目录:页面提供入口,用系统文件管理器打开当前 profile 文件夹(Windows explorer.exe、macOS open、Linux xdg-open);插件只打开目录,不替你改已有文件。

对话里装 MCP:对 Agent 说明意图(例如安装某个 filesystem MCP),由 mcp_service 的 install 处理;需你在 DSH 授权界面确认。

插件会写入哪些文件

仅在你当前 profile 下写入插件自有文件,不碰 cordis.patch.yml、cordis.yml、.credentials.yaml。

路径 含义
<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 桌面 profile 示例为 %USERPROFILE%\.dsh\profiles\desktop。

架构上,插件自带的 cordis.patch.yml 注册 service-manager(Host:路由、Agent 工具、翻译)与 service-manager-mcp(cordis:include 指向 ./mcp-servers.yml)。页面通过 /api/service-manager/* 读写;写入后刷新 include 子树以触发 MCP 桥重连。

适用场景与注意

适合:经常在 DSH 里切换、试用多个 MCP;Skill 较多、希望用中文快速扫摘要又不想改 SKILL.md;希望在对话中用自然语言安装 MCP 且接受授权流程。

安全边界(README 强调):

  • Host 半段在 DSH 进程内运行,位于工作区沙箱之外;安装第三方插件前应自行审阅源码与 MIT 许可证。
  • 建议密钥使用 ${ENV_NAME},由加载时从环境读取。
  • 敏感 MCP 变更(install / remove)必须经 DSH 一次性授权。

结尾

DSH Service Manager 把「手写 YAML + 会话里试连」收成侧边栏里的 服务管理:MCP 表格化运维、工具与 Skill 摘要可译、可选 dsh-context 看 token 与使用频次,并用 mcp_service 把部分操作延伸进对话。若你正在 DSH 0.2.0-rc.1 系列上做多 MCP、多 Skill 开发,可先按上文安装命令启用,再对照仓库截图与 FAQ 排查重装问题。

  • 社区目录页:https://www.skillhub.cn/plugins/Baisbt/Baisbt-dsh-service-manager
  • 源码与文档:https://github.com/Baisbt/Baisbt-dsh-service-manager
羽毛球分组比赛记分
小程序二维码

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

Xiaoye