MCP 管理面板 Imzl-zl/dsh-toolbox-ui

dsh-toolbox-ui

DeepSeek Harness Web 的 MCP 管理面板 + 技能管理面板

= 0.2.0-rc.1">

点右下角悬浮按钮或侧栏「工具箱」打开，面板浮在会话之上——改配置、看技能，都不打断正在进行的对话。两个能力面在同一个面板里切换：MCP 与技能。

面板本身跟随 DSH 的界面语言：DSH 设成 English 时，面板里的文案、按钮与状态一律是英文（词典在 lib/client.js 的 EN_DICT）；设成中文或宿主没有语言服务时，显示中文原文。语言开关在 DSH 里，不在面板里：设置 → 通用 → 语言。面板刻意不设自己的开关——语言只有宿主一个真相源，两套开关必然对不上。没手动选过语言时，宿主按浏览器语言推断（浏览器是英文，面板就是英文；这时去设置里选一次中文即可，之后记住该选择）。

界面预览

MCP 市场

MCP 市场

47 个逐条一手核实过的服务，分 10 类；搜索为主操作，配「只要免密钥」筛选与排序。每条如实标注免费额度、要准备什么（密钥 / 连接信息 / 装完还得改的参数），卡片直接安装；已配置的只识别并跳过。

技能面板

技能面板

看本机每个技能的真实作用域与同名遮蔽，启停、删除、读正文与诊断，并一键切换「模型自动调用」——它直接改 SKILL.md 的 disable-model-invocation，只动那一行。

特性

MCP 面

- 逐条看状态、传输方式、连接参数与已注册的工具；展开工具可看完整输入 JSON Schema（必填/可选、类型、枚举、默认值）
- 启停、重连、添加、编辑、移除；凭据类字段默认掩码，点眼睛临时揭示有效运行值并一键复制
- 全局 + 项目双作用域：全局写 Web profile（所有项目可用），项目写该项目 .dsh/mcp.json（只该项目会话可见）；项目里还能「屏蔽」某个全局 MCP
- 从本机其他客户端导入：Claude Code、Codex、OpenCode、pi、Claude Desktop、Cursor、Windsurf、VS Code、Gemini CLI、Roo Code 与跨工具共享配置，也能直接粘贴 JSON；写入前预览，支持「合并」与「替换」
- 跨工作区搬运：把本项目的 MCP 复制到另一个已注册工作区（在宿主内完成，凭据不经过浏览器），或导出成 JSON 备份 / 分享
- 工具延迟加载（ToolSearch）：让某个服务器的工具不再每轮常驻上下文——模型先看到一份只列工具名的目录，用内置的 tool_search 搜到（关键词或 select:<确切名字>）之后，完整参数 schema 才进它的工具列表并可直接调用。默认不开：行上的「延迟 / 全量」标签点一下就切（或列表顶部一键「全部延迟」）；环境变量 DSH_MCP_TOOL_SEARCH=off 整体退回全量注入。机制的三个上限（一次返回条数 / 目录行数 / 已发现集大小）可在「延迟参数」里调，写进 profile patch 的 config.toolSearch

技能面

- 真实作用域与同名遮蔽：同名技能跨作用域是合法配置，面板逐条列出并标出哪一份生效
- 启停（写技能文件里的两个调用面字段，不动文件本身）、删除、读正文与诊断——「技能不生效」的原因直接摆在面板里
- 「模型自动调用」开关：直接改 SKILL.md 的 disable-model-invocation，关掉=删掉那一行（开→关能逐字节还原原文）；状态一律取自技能文件本身，读不出来就说「未知」而不是猜一个值
- 定位按磁盘上的真实位置（不按技能名）：文件/目录名与 frontmatter 的 name 不一致的技能照样能读、能启停、能删
- 市场接 skillhub.cn：安装前披露发布方认证与安全扫描结论，并要一次显式确认（该确认在服务端校验）

公共

- 入口三选一：右下角悬浮按钮（可拖拽、记忆位置）+ 侧栏「工具箱」；可以只留一个，不能都关
- 跟随 DSH 深色/浅色主题，适配窄屏与移动宽度
- 更新提示与一键升级：每天最多查一次 npm、可关闭、绝不自动升级；升级后弹一次「本次更新内容」，不联网

安装

推荐：npm 安装 —— 之后 dsh plugin update 在 ^1.x 内自动升小版本
dsh plugin --profile web add dsh-toolbox-ui@^1.9.0

或固定 GitHub release tag（不自动跨版本，升级要换 tag 重新 add）

dsh plugin --profile web add github:Imzl-zl/dsh-toolbox-ui#v1.9.0

装完重启 dsh web。卸载（不会删除 profile 里已有的 MCP 条目）： sh
dsh plugin --profile web remove dsh-toolbox-ui

不要把 mcp-manager-ui 手工插进 profile 的 cordis.patch.yml、Agent preset 或额外的 --patch 文件——插件命令已经完成这件事，重复装配会明确报错。

升级 sh
dsh plugin --profile web update dsh-toolbox-ui

面板顶部有新版时会显示可关闭的提示条，点「升级」走 DSH 官方的 pluginManager。

⚠️ 1.6.1 及更早的版本不会提示 1.6.2 及之后的新版。 它们的更新检查读的是本仓库的 release feed，而那段时间该 feed 的 latest 被另一条产品线（已冻结在 1.5.5 的旧包）占着，于是永远显示「已是最新」。这个缺陷在 1.6.2 修掉了（改成查本包在 npm 上的 latest），修复只能装在新版里——所以请手动升一次，之后就恢复正常：

sh
dsh plugin --profile web update dsh-toolbox-ui

仍装着旧包 dsh-mcp-manager-ui（≤1.5.5）的话走迁移：1.5.5 面板顶部有一条常驻提示，点「迁移」即装本包、卸掉旧包。若面板里的「升级」按钮报 ERR_PNPM_NO_MATCHING_VERSION，那是旧线的升级源已停用（本仓库的 latest 自 v1.8.2 起指向本包），直接用两条命令：

sh
dsh plugin --profile web remove dsh-mcp-manager-ui
dsh plugin --profile web add dsh-toolbox-ui

详见安装与升级。

快速上手

打开面板：右下角悬浮按钮，或侧栏底部「工具箱」。面板浮在会话之上，按 Esc 或点「关闭」收起，不影响会话。

两个作用域：

| 标签页 | 存哪 | 谁可见 | 改动何时生效 |
| 全局 | Web profile 的 cordis.patch.yml | 所有项目 | DSH 热加载，通常立即生效 |
| 某项目 | 该项目 .dsh/mcp.json | 只该项目会话 | 写盘即生效，不需重开会话或重启 Host |

serverName 按作用域判重：不同项目之间、全局与项目之间可以同名，各自独立连接；同一作用域内不能重名。

加 MCP：面板顶部「添加 MCP」填表单，「导入 MCP」粘贴其他客户端的配置（先预览再写入）。常用服务器有预设模板。

常见问题

项目里的改动什么时候生效？ 保存的那一刻就对齐到正在运行的会话：新增立刻挂上存活会话、删除立刻撤掉工具、改动就地重载连接——不需要重开会话，也不需要重启 Host。手工编辑 .dsh/mcp.json 则在下一次会话挂载时被采纳。

连接跟配置走，不跟会话走。 最后一个会话结束不会拆掉连接，它只进入空闲等待，下一次会话直接复用——「要用的时候」它已经就绪。两个旋钮写在 server 条目里：idleTimeoutMs（空闲保留多久，默认 5 分钟，0 = 永不回收）与 readyTimeoutMs（挂载时等就绪的总预算，默认 5s，0 = 不等）。字段速查见设计与限制。

项目行那些状态文案是什么意思？ 它们把两件独立的事分开说：连接在不在（已连接 · 当前无会话使用（连接保留，下次直接用） / 已连接 · N 个会话在用 / 连接中… / 连接失败 / 尚未建立连接（新会话自动挂载））与几个会话在用——不再有「待会话挂载」那种把两者压成一句、容易被读成「还没连上」的合成状态。

面板显示「已禁用」，模型却报 unknown tool "mcp__xxx__…"？ 那个 MCP 被禁用了，所以它没有注册任何工具。在面板里点「启用」即可。

「延迟」打开后，模型还找得到那些工具吗？ 找得到，但不是靠全量可见：提示词里只有一份只列工具名的目录加一句引导（没有描述、也没有参数 schema），模型用 tool_search 按关键词或 select:<确切名字> 命中后，完整 schema 才进工具列表、之后可直接调用；凭记忆直调尚未加载的工具会被拒绝，拒绝里给出确切的那条查询串，照抄即可。工具只有两三个的服务器开了省不下什么（每轮仍要付一段引导语），工具多的才划算。要整体退回全量注入：环境变量 DSH_MCP_TOOL_SEARCH=off。注意行上那颗「延迟 / 全量」标签显示的是你的配置（逐台的 defer 值）——点它即可切换；它不表示「此刻这个会话里机制真的生效了」。

单台怎么开，在哪儿开？ 列表每一行都有一颗标签：显示「全量」= 这台的工具常驻，显示「延迟」= 已按需加载。点它就切，不用进「编辑」框（项目视图里出现的全局条目要在「全局」标签页里改）；想一次全开/全关用列表顶部的 ⚡「全部延迟」。工具数很少的服务器勾了也生效，面板会提示省下的空间可能不多。

两个上限在哪儿调？ 面板 MCP → 顶部「延迟参数」：maxResults（一次搜索最多返回几个工具，默认 10）、maxDiscovered（已发现集上限，默认 20）；另外有一个默认关着的「限制目录大小」开关（maxCatalogChars）——关着就是全部工具都列进目录，只有工具特别多、又想压上下文时才需要打开它（打开时预填 12500，那只是建议起点）。保存后写进 profile patch 的 config.toolSearch，当前会话立即生效（不需要重启）；与默认相同的值不写盘，所以将来默认值调整时你会跟着走。也可以直接手写这段配置，改完重启 dsh web 生效——⚠️ 拼错键会让插件加载失败并报出具体路径（不是静默忽略），改对再重启即可。
「挂载失败」「连接失败」「作用域隔离失败」怎么区分？ 三件不同的事：挂载失败=会话挂载阶段就没挂上；连接失败=mcp-client 连不上或重连耗尽；作用域隔离失败=连接正常但工具不在共享作用域层。详情页会给具体原因，排查见设计与限制。

会碰到我的其他配置吗？ 不会。全局改动只动由 @deepseek-ai/dsh-mcp-client 声明、且由本插件管理的条目，保留其他插件条目、注释与 !!js 表达式；卸载也不会删除你已有的 MCP 条目与项目的 .dsh/mcp.json。

兼容性

| 项目 | 已验证 |
| DeepSeek Harness | 0.2.0-rc.1 及以上（0.2.0-rc.2、0.2.1-rc.2、0.2.1-rc.3 与 0.2.1-rc.5 都跑过全量；0.2.1 宿主自带的 cordis 4.0.5 / loader 1.0.6 也在覆盖内） |
| Node.js | DSH 自带/支持的运行时 |
| 平台 | Windows；Linux/macOS 使用同一 DSH Web 契约 |

只支持 0.2.x 起：ToolSearch 依赖 0.2 的 per-agent 呈现模式（ctx.tools.modeFor(agent)）与 tools:sdk 手册段，0.1.x 上这两样都不存在。不为旧版本保留降级分支。
支持面就是 0.2.0 与 0.2.1 两条线：两者之间宿主换了两代 loader（1.0.3 → 1.0.6），启动错误传播与 dispose 写盘行为都变了，插件对这两处做了显式适配并各有一条常驻用例。

开发 sh
npm test # 全部测试（含真机集成用例：真 cordis / dsh-tools / dsh-scope / dsh-mcp-client + 真 stdio MCP 子进程）
dsh web # 起 Web 做真实操作验证

文档

中文版与英文版内容一致，.en.md 是英文版。两份在开头互链；文内目录锚点各按自己语言的标题生成（中文锚点在英文文档里解析不到，反之亦然），跨文档链接指向对应语言的那一份。

- 安装与升级 —— 三种安装方式、发布流程、故障排查（English）
- 技能管理 —— 作用域与遮蔽、启停、调用权限、技能市场（English）
- JSON 导入 —— 字段映射与限制（English）
- 项目级 MCP 生命周期 —— 挂载、共享连接与作用域对齐（English）
- 设计与限制 —— 共享连接模型、连接状态语义、已知限制、依赖细节（English）
- DeepSeek Harness 官方插件发布指南

友情链接

LINUX DO

License

MIT