# dsh-capability-toggle-plugin
**在 DSH WebUI 中控制 agent 能力,并在运行时真正强制执行。**
[](#快速开始)

[](https://github.com/lifeopsgo/dsh-capability-toggle-plugin/releases)
[](./LICENSE)
[](./README.md) [](./README.en.md)
会话 · 项目 · 全局 —— 蓝色对勾 = 开,红色叉 = 关,虚线横杠 = 未设。
## 这是什么
一个 **DeepSeek Harness(DSH)WebUI** 插件,在输入栏旁增加能力开关。它可以在会话、项目或全局层级控制**技能、MCP 服务器、工具、提示词注入、审批升权和安全守卫**。
停用不是界面上的假过滤:能力会在模型下一步从可见能力面中消失,强行调用也会在执行时被拦截。
## 兼容的 DSH 版本
本插件面向 **DSH 0.2 世代**,peer 声明为一条区间:
```
>=0.2.0-0 <0.3.0-0
```
含义是「0.2 的任意版本,含预发布」。npm 上的 DSH 全部版本都是 prerelease,逐条枚举 rc 的结果就是官方每发一版,插件在启动时被判定不兼容并整包跳过;v2.4.0 起改为按世代声明的区间,0.2 线上的新 rc 不再需要改版本号。
上界刻意写成 `<0.3.0-0` 而不是 `<0.3.0`:DSH 的兼容校验按 `includePrerelease: true` 计算 semver,`0.3.0-rc.1` 排在 `0.3.0` 之下,写 `<0.3.0` 会把它放进来。0.3 世代属于破坏性变更,必须拦住。
**已验证的运行时**
| DSH 版本 | 验证方式 |
| --- | --- |
| 0.2.0-rc.1 | v2.0.1 时在该依赖下全量跑绿(380 项) |
| 0.2.1-rc.2 | v2.1.0 时的同套门禁,含浏览器端实测 |
| 0.2.1-rc.5 | v2.3.0 时的类型检查、412 项测试与生产构建 |
| 0.2.2-rc.3 | v2.4.0 时的类型检查、412 项测试、生产构建,并在该运行时里确认宿主配置条目与客户端插槽占用均生效 |
**区间能表达「能不能装」,表达不了「某个 API 在不在」。** 插件依赖两条宿主接缝——composer 的 `data-composer-overlay` 放行口与 `inputTriggers` 的 source 名单——两者都有测试对已安装产物断言;接缝消失时相关功能退化为不生效,不会让整个插件报错。其余 0.2.x 版本没有再逐版跑过门禁,跑门禁的成本请按上表推算。
## 快速开始
需要 **Node.js ^22.19.0 或 ≥ 24.0.0**(与 DSH 0.2.x 相同)。
```bash
dsh plugin --profile web add github:lifeopsgo/dsh-capability-toggle-plugin#v2.5.0
dsh --profile web web
```
刷新页面,点击输入栏 ➕ 旁边的开关按钮打开面板。agent 运行中也能打开查看,但改动要等它空闲才能落盘。若使用其他 profile,请替换 `web`。