前言¶
DeepSeek Harness(DSH)自带 MCP 接入能力,但没有配套的图形化管理界面。新增或调整 MCP 服务器通常要手写 YAML;连接是否成功往往得回到会话里试探。Skill 以磁盘上的文件存在,英文摘要读一遍就容易忘,日常运维成本偏高。
社区插件 DSH Service Manager(维护者 Baisbt)补的是这一页:在侧边栏提供 服务管理,用表格完成 MCP 的增删改查与启停,并浏览 DSH 可见的 Skill,用你配置的模型翻译摘要。插件通过官方 cordis:include 机制加载自己的配置片段,不会改写你手写的 cordis.patch.yml。
这是什么¶
- 定位:面向 DSH 桌面端的插件,统一查看与管理 MCP 服务器与 Skill。
- 仓库: Baisbt/Baisbt-dsh-service-manager(package 名
dsh-service-manager,当前资料中版本 0.13.2,许可证 MIT)。 - 目录页: skillhub.cn 插件条目。
DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。本文介绍的是上述开源仓库的行为,以 README 与 package.json 为准。
核心功能¶
MCP 服务器¶
下面能力均来自插件 README 的功能说明。
- 无 YAML 的 CRUD:在表格中新增、编辑、删除、启用或禁用 MCP 服务器。
- 展开工具列表:点击行可展开该服务器注册的工具,每行一个工具,悬停可看完整英文描述。
- 工具抽屉:上方为翻译后的摘要,下方为参数表;参数说明可翻译,参数名保持英文(与调用时一致)。
- 重连状态可见:保存后后台刷新 include,页面轮询重连状态,而不是长时间阻塞。
${ENV_VAR}:密钥建议写在环境变量引用中,避免明文落入配置文件。- 可选 token 列:若另行安装
dsh-context,可显示各服务器工具定义占用的 token,并跳转到上下文仪表盘;未安装时该列不出现。
Skill¶
- 浏览 DSH 可见的全部 Skill,摘要与正文分层展示。
- 用自有模型翻译摘要:模型选择器列出 DSH 中配置的 provider × model,默认使用你的默认模型,并记住选择。
- 跟随界面语言:摘要译成 DSH 当前界面语言;若原文已是该语言则直通,不消耗 token。
- 译文 / 原文 切换整表,单卡 ↻ 可重新翻译,工具栏支持批量重新翻译。
- 磁盘缓存:再次访问时零额外请求(缓存键为原文哈希)。
- 失败可见:模型无法交付时卡片标注 机翻,不伪装成功。
- 删除 Skill、在文件管理器中打开:抽屉内路径旁按钮可在资源管理器中选中对应
SKILL.md。 - 使用统计(可选):安装
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。
安装与启用¶
- 打开 Settings → Plugins,在安装框粘贴以下任一来源(摘自 README):
github:Baisbt/Baisbt-dsh-service-manager
或
https://github.com/Baisbt/Baisbt-dsh-service-manager
- 安装后 刷新页面(
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 较多、希望用本地已配模型把英文摘要译成界面语言后再挑选。
注意:
- 版本需落在 DSH
0.2.0-rc.1~0.3.0区间,否则不满足peerDependencies。 - 翻译与 MCP 管理依赖你配置的模型与网络;失败时会标明机翻,不应 Assume 摘要一定准确。
- 与
dsh-context的集成是可选增强,非安装本插件的前提。
结尾¶
DSH Service Manager 把「改 YAML、翻目录、猜 MCP 是否连上」收成侧边栏的一页:MCP 表格化运维,Skill 可读性由你自己的模型补齐,且通过独立 include 文件承载 MCP 配置,尽量不碰你原有的 Cordis 主配置。