前言¶
DeepSeek Harness (DSH) 的 Web 客户端采用插件架构。在开发智能体时，管理 MCP（Model Context Protocol）服务器和本地技能文件通常需要直接编辑 JSON 配置或使用命令行。dsh-toolbox-ui 提供了一个浮层面板，允许在对话进行中直接管理这些配置，无需重启或中断会话。
插件简介¶
dsh-toolbox-ui 是由 Imzl-zl 维护的客户端插件，采用 MIT 许可证。它将 MCP 管理面板与技能管理面板集成在一个界面中，支持全局与项目级配置的双向操作。
核心功能¶
MCP 管理面¶
- 状态与详情：查看连接状态、传输方式、连接参数与已注册工具。展开工具条目可查看完整的输入 JSON Schema。
- 操作：支持启停、重连、添加、编辑、移除 MCP。凭据类字段默认掩码，点击眼睛图标可临时显示并复制有效值。
- 配置导入：支持从其他客户端（Claude Code, Cursor, VS Code 等）导入配置，支持跨工作区搬运或导出 JSON。
- 作用域：支持全局（Web profile）与项目级（
.dsh/mcp.json）双作用域，支持屏蔽全局 MCP。
技能管理面¶
- 作用域与遮蔽：查看本机每个技能的真实作用域与同名遮蔽情况。
- 操作：支持启停、删除、读取正文与诊断。
- 模型自动调用开关：一键切换技能的
disable-model-invocation状态，直接修改SKILL.md文件。 - 文件定位：按磁盘上的真实位置定位技能（不按技能名），支持从 skillhub.cn 市场安装（需显式确认）。
通用特性¶
- 入口：支持右下角悬浮按钮（可拖拽）和侧栏「工具箱」两种入口。
- 主题：跟随 DSH 主题，适配窄屏与移动端。
- 更新：每天最多查一次 npm，提供更新提示，但不自动升级。
安装与启用¶
使用官方 CLI 安装：
dsh plugin --profile web add dsh-toolbox-ui@^1.7.2
安装完成后需重启 dsh web 服务。
典型用法¶
- 打开面板：点击右下角悬浮按钮，或侧栏底部的「工具箱」。
- 添加 MCP：在 MCP 面板顶部点击「添加 MCP」填写表单，或使用「导入 MCP」粘贴配置。
- 管理技能：在技能面板中，点击技能条目查看状态，或点击「模型自动调用」开关进行修改。
- 升级插件：当面板提示有新版本时，可执行：
dsh plugin --profile web update dsh-toolbox-ui
适用场景与注意事项¶
本插件以当前 DSH 进程的权限运行，直接操作配置文件。
- 语言：面板语言跟随 DSH 设置（通用 → 语言），未手动选择时默认使用浏览器语言推断。
- 热更新：在项目内修改配置并保存时，改动会立即对齐到正在运行的会话，无需重启 Host。
- 连接保持：MCP 连接不随会话结束而断开，仅进入空闲等待状态，下次会话可直接复用。
- 兼容性：仅支持 DSH 版本 0.1.5-rc.1 及以上。
- 数据隔离：不会修改其他配置，卸载也不会删除已有的 MCP 条目与项目的
.dsh/mcp.json。
结语¶
对于需要频繁调整 MCP 服务器或管理大量本地技能的开发者，dsh-toolbox-ui 提供了一个直观、高效的集中管理入口。
- GitHub: https://github.com/Imzl-zl/dsh-toolbox-ui
- Catalog: https://www.skillhub.cn/plugins/Imzl-zl/dsh-toolbox-ui
