前言¶
在使用 DeepSeek Harness (DSH) 进行智能体开发时，控制技能、MCP 服务器或安全防护通常需要修改代码或配置文件。当需要在运行时动态调整这些能力时，现有流程往往不够灵活。dsh-capability-toggle-plugin 插件提供了一种从 WebUI 进行实时控制与强制执行的方案。
这是什么¶
这是一个由 lifeopsgo 维护的 DeepSeek Harness (DSH) WebUI 插件。它允许管理员在会话、项目或全局三个层级上控制技能、MCP、工具、提示注入以及安全防护（如批准和防护）。该插件对能力执行真实的运行时强制执行，包括移除、隐藏、抑制、拒绝或阻止。
核心功能¶
三级分辨率
支持 session > project > global 三级配置。最近的显式值胜出。未设置的能力会推迟到下一级；如果所有级别都未设置，能力保持启用。面板行徽章始终显示解析结果。
能力分类
提供对以下内容的控制面板：
* Skills：单个模型可调用的技能
* MCP：MCP 服务器（展开行可查看成员工具）
* Tools：单个模型可见的工具及其指导部分
* Prompt：安全的提示注入白名单
* Security：批准升级和五个可选的安全防护
运行时强制执行
根据能力类型，禁用操作会采取不同措施：
* tool / mcp：通过 ctx.tools.restrict({ deny }) 移除，强制调用被拒绝
* skill：被同名的 modelInvocable:false 运行时技能隐藏
* prompt：被隐藏为空文本，或通过 suppressRuntimeContext() 抑制
* approval：作用域内的批准请求解析为 rejected
* guard：在 tools/pre-execute 中阻止或请求确认匹配的调用
使用统计
技能、MCP 服务器和工具显示一个小徽章，表明本次会话中被调用的次数。计数在回合结束时更新，并在代理生命周期内保持，且不会被持久化。
面板首选项
面板标题旁的展开箭头打开三个显示首选项，存储在 localStorage 中以保持刷新和重启后生效：
* Show “enabled / total” on tabs：将徽章渲染为分数（如 67/106）
* Show call stats：显示或隐藏每行的使用徽章
* Level columns to show：仅显示会话、会话+项目或全部三列
安装与启用¶
- 确保系统满足 Node.js >= 22.6。
- 执行安装命令：
dsh plugin --profile web add github:lifeopsgo/dsh-capability-toggle-plugin#v1.3.2
- 重启 DSH Web GUI 进程并刷新页面。
典型用法¶
- 在代理空闲时，打开控制按钮旁边的按钮。
- 切换能力以开启或关闭。
- 使用小的清除徽章将能力返回到“未设置”状态。
- 查看使用统计徽章以了解调用计数。
适用场景与注意¶
- 适用场景：需要动态调整智能体能力的场景，例如测试不同配置下的行为或临时限制某些危险操作。
- 兼容性：兼容 DSH 0.1.x 线；
peerDependencies拒绝 0.2.0 及更高版本。 - 安全防护：安全防护是可选的，通过确认提示进行管理。
- 未设置逻辑：未设置的能力会推迟到下一级；如果所有级别都未设置，能力保持启用。
短结尾¶
该插件通过将能力控制集成到 WebUI 中，简化了 DSH 环境的运行时管理。它支持复杂的层级覆盖和统计功能。更多细节请访问 GitHub 仓库。
