dsh-toolbox-ui

toolstested: passnpmMIT

Floating panel for the DSH web UI managing MCP servers and skills: per-server deferred tool loading (ToolSearch, off by default) keeps a server's tools out of every turn's context — the prompt lists tool names only, and a tool's full schema enters the list once the model finds it with the built-in t

下载量 / Downloads

3,871

依赖体积 / node_modules

26.04 MB

测试时间 / Tested

2026-11-06

DSH 版本 / Version

0.2.2-rc.1

Install

dsh plugin --profile web add dsh-toolbox-ui

Sandbox test results

Stage	Result
1 install	✓
2 list	✓
3 mount	✓
4 boot	—

Four stages run in an isolated sandbox: install (network on) → list → mount → boot (last three with no network).

README

<h1 align="center">dsh-toolbox-ui</h1>

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

中文 | <a href="README.en.md">English</a>

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

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

界面预览

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

工具搜索：面板顶部「工具搜索」是一张工具列表——内置工具与其他插件的工具按名字列出，逐个选「常驻 / 可搜索」，默认全部常驻；MCP 服务器的启停与「延迟 / 全量」仍在原列表，不重复加开关。选成「可搜索」的工具模型要先经搜索拿到 schema 才能用；没有可搜的工具时（全部常驻或全部停用）搜索入口本身不出现，模型不会白搜一次空目录，搜索入口也不会被用户策略藏掉

技能面

真实作用域与同名遮蔽：同名技能跨作用域是合法配置，面板逐条列出并标出哪一份生效
启停（写技能文件里的两个调用面字段，不动文件本身）、删除、读正文与诊断——「技能不生效」的原因直接摆在面板里
「模型自动调用」开关：直接改 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.10.0

# 或固定 GitHub release tag（不自动跨版本，升级要换 tag 重新 add）
dsh plugin --profile web add github:Imzl-zl/dsh-toolbox-ui#v1.10.0

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

dsh plugin --profile web remove dsh-toolbox-ui

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

升级

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

```

详见[安装与升级](docs/installation.md)。

快速上手

打开面板：右下角悬浮按钮，或侧栏底部「工具箱」。面板浮在会话之上，按 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 = 不等）。字段速查见[设计与限制](docs/design.md#项目级专有字段dshmcpjson-里每个-server-可写)。

项目行那些状态文案是什么意思？ 它们把两件独立的事分开说：连接在不在（已连接 · 当前无会话使用（连接保留，下次直接用） / 已连接 · 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，**

…(truncated)

Rendered from the README published on npm. Formatted only, not edited.

Versions

Published on npm:：18，最后更新 2026-11-06

Links

GitHub · Homepage · npm