dsh-capability-toggles
xiafan68/dsh-capability-toggles
在对话输入框的工具行按插件分组开启或关闭本会话的工具与技能,只影响当前会话。
安装
dsh plugin --profile web add github:xiafan68/dsh-capability-togglesREADME
会话能力开关 · Capability toggles
按会话开关 DSH 的工具与技能(tools / skills)。对话输入卡的工具行里多一个「能力」芯片,点开是按插件分组的清单: 关掉一个工具,模型下一轮就看不到它的 schema;关掉一个 skill,它从技能目录里消失、也加载不到。 打开回来,下一轮就恢复。选择按会话保存,互不影响。
它和 preset 的分工:preset 决定"这个会话挂哪些插件"——要重启、要新会话、粒度是整个插件; 这个插件管的是当前这轮对话里收窄能力(别让模型用 bash、别加载建模的 skill、只留 message-hub), 即时生效,且不影响别的会话。
- 粒度:单个工具 / 单个 skill / 整组(插件)三级开关,组头支持半选状态
- 生效时机:点完即写状态并重算该会话的活 agent;下一次模型请求就能看到差异
- 存储:
<DSH_HOME>/capability-toggles/state.json,记的是"被关掉的名字",所以新装工具默认可见 - 零第三方运行时依赖;Host(Node)+ Client(浏览器)两半边都在本仓库里
截图
输入卡工具行里的「能力」芯片,点开就是按插件分组的能力清单(这里是 16 组、48 个工具与技能,全部开着):

关掉 blender 这一组,整组的 15 个工具一次关掉,计数落到 33/48,组里每一行都变成未勾选:

怎么找到它
显示名、包名与关键词都按「用户会怎么搜」来取,而不是按代码里的名字:
| 位置 | 内容 | 给谁看 |
|---|---|---|
| 插件页标题 / 商店卡片 | 会话能力开关(英文 Capability toggles) | 用户 |
| 插件页描述 / 商店卡片 | 一句说清入口在哪 + 开启/关闭之后发生什么 + 只影响当前会话 | 用户 |
| 包名(安装标识,尚未上 npm) | @dsh-external/dsh-capability-toggles | 安装、日志、Loaders |
keywords | tools skills session toggle … + 工具 技能 开关 … | 插件索引搜索 |
搜索能命中的所有地方:包名(权重 ×3)、标题(×3)、关键词(×2)、描述、作者; 插件页内部的组件列表还有一个过滤框,匹配行标题、描述、行 id 与模块名。 所以标题要短、描述要有用户原词("工具""技能""会话"),不能只写实现术语。
安装
方式一:Plugins 页安装(推荐)
在 DSH 的 Plugins 页用「Add plugin」指向本目录(D:\codes\dsh-capability-toggles),
它会把这个目录以 link: 的方式加进当前 profile 并登记到 bundles。装完重启 DSH。
方式二:手改 profile
在 profile 的 package.json(例如 %USERPROFILE%\.dsh\profiles\desktop\package.json)里加两处:
{
"dependencies": {
"@dsh-external/dsh-capability-toggles": "link:D:/codes/dsh-capability-toggles"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@dsh-external/dsh-capability-toggles"
]
}
}
}
然后安装依赖并重启 DSH:
cd "$DSH_PROFILE_DIR" # 例如 ~/.dsh/profiles/desktop
pnpm install
link: 指向源码目录,所以改完 src/ 后不用重新 install,但要重启 DSH 才会重新加载宿主代码。
方式三:从别人的分享安装
在 Plugins 页用「Add plugin」填包名或仓库地址。分两种情形:
- 已发到 npm 的预构建包:装完即用,不需要批准构建脚本;
- 从仓库源码安装:安装时会跑本仓库的构建脚本,需要在 profile 里批准(
allowBuilds)后才继续。
本插件目前是自己用 link: 装的,还没有发布到 npm / GitHub。
改配置
bundle 默认配置在 cordis.patch.yml:
| 键 | 默认 | 说明 |
|---|---|---|
stateFile | '' → <DSH_HOME>/capability-toggles/state.json | 会话状态存储位置(支持 ~ 与 %USERPROFILE%) |
inferGroups | true | 没有声明的能力是否按前缀 / provider 推断分组;关掉后只显示声明过的组 |
showEntry | true | 是否显示工具行里的「能力」芯片 |
使用
- 在输入卡的工具行(附件、权限、模型选择那一排)最左边找到
能力芯片,点开。 面板从输入卡上方展开,宽度跟随输入卡。收起有三种方式:再点一次芯片、点面板里的「收起」、 点面板外面任意位置(正文、会话列表、输入框都算),或者按 Esc。 - 面板按插件分组。分组默认折叠:点组头(或聚焦后按回车 / 空格)展开,展开后每项一个勾选框,
行首标签标出
工具/技能。 - 勾掉即关闭,下一轮模型请求生效:
- 关工具 → 该工具不再出现在模型的工具清单里;
- 关技能 → 它从技能目录消失(连摘要都不给),
skill工具也加载不到,输入框打/名字也不会注入。
- 组头勾选框是插件粒度的整组开关,部分关闭时显示半选;组头上还显示
on/total。 - 「全部恢复」清空本会话的所有关闭项。
- 组名带
推断的是没有声明归属、按工具名前缀 / skill provider 自动归的组。
状态只对当前会话生效:换会话互不影响;重启 DSH 后仍记得;完全恢复后该会话不会再留下空记录。
让插件自己声明归属
推断分组够用但名字不一定好看。插件可以在启动时向 capabilityToggles 服务声明:
// 等 capabilityToggles 服务就绪
ctx.inject(['capabilityToggles'], (c) => {
c.capabilityToggles.declare({
id: 'dsh-message-hub',
label: 'Message Hub',
tools: ['hub_status', 'hub_feeds', 'hub_items', 'hub_feed_add'],
skills: ['message-hub'],
})
})
声明优先于推断;没声明的继续走推断。声明由 declare() 返回的 disposer 管理,插件卸载就撤回。
名字在声明时不存在(工具没注册、skill 没有)会被跳过,不会出现空组。
什么时候不该用它
- 想让以后所有新会话都少挂点东西 → 用 preset,不是这里。
- 想不再加载某个插件(省进程/内存) → 卸载插件或换 preset;本插件只隐藏能力,不卸载。
原理
生效机制
两条路,都在 agent 的 scope 上做,agent 释放就自动回收:
工具:调 agent.ctx.tools.restrict({ deny }) 拿到一个 disposer。
restrict 只作用于全局注册的工具;preset 里注册的 scoped 工具不受影响(DSH 语义)。
另外 restrict 遇到未知名字会抛错,所以每次应用前都先拿当前 tools.definitions() 过滤一遍——
这样"关掉一个后来被卸载的插件留下的名字"不会让整次应用失败。
Skills:DSH 的 skill 注册表没有 filter API,只有分层解析(最近的层同名胜出)。
所以在 agent 层注册一个同名 shadow,把 invocation 设成
{ modelInvocable: false, userInvocable: false }:
- 模型侧目录里不再出现这个 skill(连摘要都不给)——注册表的最近层压制了原条目;
skill工具加载它会得到"不可用";- 用户在输入框打
/name也不会注入。
注意:如果这个会话在关闭之前已经加载过它,那段正文已经在历史里了,撤不回来。 关闭只保证"从现在起不再被广告、也不再能加载"。
数据流
浏览器 宿主进程
┌──────────────────────────┐ ┌────────────────────────────────────────┐
│ Chip (conversation │ GET │ server.mjs /capability-toggles/api │
│ .input.left) │ ─────────► │ /state /toggle /group /reset │
│ Panel (conversation │ │ │ │
│ .input.dock) │ ─────────► │ ▼ │
│ │ POST │ state.mjs <DSH_HOME>/capability- │
│ 共享一份会话缓存: │ │ toggles/state.json (原子写) │
│ sessions / openState / │ │ │ │
│ expandedGroups(内存) │ │ ▼ │
└──────────────────────────┘ │ catalog.mjs 按插件分组(声明优先) │
│ │ │
│ ▼ │
│ engine.mjs tools.restrict + skill │
│ shadow,只重算该会话的 agent │
└────────────────────────────────────────┘
- 状态是"关闭名单":
{ version: 1, sessions: { [sessionId]: { tools: [], skills: [] } } }, 默认全开;写盘先写*.tmp-<pid>再 rename,坏文件按空状态启动。 - 不写进会话事件:会话日志是唯一真相源,往里塞自定义事件会让旧版本 / 其他读者在重开会话时出问题。
- 一次写操作只重算一次:整组开关走
/group批量落盘,reapply(sessionId)只动这个会话的活 agent; 每次重算先把旧 disposer 全部释放再装新的,避免叠加。 - 插件热重载时可能已经有活着的 agent,
apply()里会把这些 agent 补 attach 一次。 - BFF 用
ctx.inject(['webServer'], ...)等 webServer 就绪再挂——插件不声明依赖时 Cordis 可能先激活本插件, 此时同步ctx.get('webServer')拿到的是空值,路由会静默丢掉、面板随后 404。 - 写操作要求同源
Origin(非浏览器客户端没有Origin,按连接层已鉴权放行),请求体上限 16 KB。
边界(写在前面,免得当成 bug)
- 不是卸载插件:只隐藏能力,插件仍加载,进程 / 内存 / 注册成本都还在。
- scoped 工具挡不住:preset 组合里注册的工具不会被
restrict隐藏;要隐藏只能换 preset。 - skill 是 shadow 不是删除:注册表里依然存在,只是最近层压制了它。
- 只影响当前会话:没有"以后新会话沿用"的开关;要粗粒度默认值请用 preset。
- 只影响下一次请求:已经在会话历史里的工具调用 / skill 正文撤不回来。
- 芯片在工具行、面板在卡片上方:不用浮层,避免和 composer 的叠层打架;面板宽度跟随输入卡。 分组折叠状态只存在浏览器内存里,刷新后回到全折叠。
- 收起面板不拦页面:展开时在 document 的 capture 阶段挂
mousedown/keydown两个监听, 命中面板内或芯片本身就不管(芯片自己的点击负责开合,两边都收会抢帧),其余情况一律收起; 面板关掉就摘掉监听,不留长驻的全局监听。
开发
npm run build # src/client/index.js → lib/client.js(拷贝 + 结构契约校验 + 指纹)
npm test # 8 个离线自检(不连真 DSH,不需要网络)
npm run check # build --check(产物是否过期)+ test ← 提交前跑这个
目录
src/
index.mjs 插件入口:Config / apply / capabilityToggles 服务 / agent 生命周期 / BFF 挂载
state.mjs 每会话状态(JSON,原子写)
engine.mjs 把状态落到 agent:tools.restrict + skill shadow
catalog.mjs 按插件聚合的分组(声明优先,推断兜底)—— 纯函数
server.mjs BFF(/capability-toggles/api)
client/index.js 工具行芯片 + 输入卡上方的开关面板
scripts/
build-client.mjs client 构建:拷贝 + 契约校验(--check 只比对,不写)
lib/
index.js 宿主产物入口(转发到 src,避免两份代码漂移)
client.js 浏览器产物,由 build 生成,不要手改
tests/ 8 个离线自检
locale/ 插件页 / 商店用的标题与描述(en、zh)
cordis.patch.yml bundle 装配层(默认配置)
data/plugins/ 投稿给 awesome-dsh-plugin 的条目草稿(不随 npm 包发布)
docs/ SUBMISSION.md:建仓、发 npm、投稿与截图规格
LICENSE MIT
测试
| 测试 | 覆盖 |
|---|---|
fiber_contract_selftest | 导出面、Config 校验、极简 ctx 下能挂载、服务与状态可用、webServer 晚就绪时补挂 BFF |
state_selftest | 默认全开、持久化、幂等、批量开/关、reset、坏文件兜底 |
catalog_selftest | 声明优先、前缀 / provider 推断、关闭状态、摘要与三态 |
engine_selftest | restrict 只带已知工具、skill shadow 形状、重算先清旧的、detach 回收、服务缺失不抛 |
server_selftest | BFF 真 socket:读状态、单项/整组开关、跨源写拒绝、坏 JSON、缺参、413、404 |
client_bundle_selftest | 假 __ModuleLoader__ 跑产物:注册面、两个槽位、中英词条对齐、sessionId 注入 |
display_meta_selftest | 包名形态、根描述中英双写、keywords 覆盖检索词、locale 标题/描述质量(含"开关"两个方向)、exports 与 files 覆盖 |
submission_selftest | dsh.bundle 与 patch 一致、LICENSE、.gitignore、投稿条目字段/分类/引号/营销词/开关两个方向、截图路径、BOM |
display_meta_selftest 是给搜索与展示上的锁:描述少于 40 字、.!。 结尾缺失、
标题里塞了包名、英文标题没走 sentence case、忘了把 locale/*.json 放进 exports / files,
都会直接失败——这些字段漏了不会报错,只是别人搜不到你。
submission_selftest 是给能不能被装上、能不能被收录上的锁:只声明 dsh.client 没有
dsh.bundle、patch 里的包名与本包不一致、条目分类不在允许取值里、描述没加引号却含 ": "、
写了营销词或"卸载插件"这类与实现相反的话、screenshots.json 指向不存在的图,
都会直接失败。规则原文见 docs/SUBMISSION.md。
构建脚本会在写 lib/client.js 前校验几处结构契约(window.__ModuleLoader__.load 外壳、
exports.apply / exports.inject、两个槽位名、BFF 前缀)。少一处就直接失败——
宁可不产出,也不发一个"看起来能加载、实际注册不上"的 bundle。
开发流程
- 改
src/(宿主)或src/client/index.js(面板)。 - 宿主改了 →
npm run check,重启 DSH。 - 客户端改了 →
npm run build重新生成lib/client.js,重启 DSH 后刷新页面。lib/client.js是产物,不要手改。 - 改了配置项 → 同时更新
cordis.patch.yml注释、上面的配置表,以及fiber_contract_selftest的默认值断言。
改名与改描述
发布后再改可见信息,最容易漏的是三处一起改:
locale/zh.json、locale/en.json的meta.title/meta.description(用户看到的);package.json的description(插件页与商店的兜底文本,缺 locale 时显示的就是它);package.json的keywords(插件索引搜索用,中英文都放)。
npm test 里的 display_meta_selftest 会检查这几处的形态与覆盖;
若改的是 name,还要同步 cordis.patch.yml 的 name、lib/client.js 里 __ModuleLoader__.load 的 id,
以及 profile package.json 的依赖键——这三处不同步,插件会"装上了但面板不出现"。
新增一个 BFF 路由
server.mjs 里加分支 → 在 createApi 返回的对象上不用额外导出 → server_selftest 里补一条真 socket 用例
(覆盖 2xx 和至少一种 4xx)。写操作走 sameOrigin() 检查,读操作可以直接放行。
已知取舍
- 客户端不用状态库:一个
Map+ 一组订阅者,两个槽位(芯片 / 面板)共享同一份会话缓存,够用且没有打包依赖。 groupState在catalog.mjs与客户端各有一份:宿主侧给摘要用,客户端侧给组头三态用;catalog_selftest与client_bundle_selftest各自钉住一份,改一处记得两处一起改。package.json里的中文曾让 PowerShell 的ConvertFrom-Json报「传入的对象无效」:根因是 Windows PowerShell 5.1 的Get-Content默认按 ANSI 解码 UTF-8,汉字字节把引号一起吞掉,JSON 就断了。 加-Encoding UTF8或用 Node 读都正常;submission_selftest另外挡住 BOM 回归。
发布
收录进 awesome-dsh-plugin 要提交的是一个 YAML 条目,
不是改那边的 README(两个 README 都由 data/plugins/*.yml 生成)。条目草稿在
data/plugins/xiafan68__dsh-capability-toggles.yml,
建仓、加 topic、发 npm、截图规格与常见打回原因见 docs/SUBMISSION.md。
投稿前必跑 npm run check——submission_selftest 会把「装不上」「分类写错」「描述带营销词」
这类问题在本地就拦住,省掉提 PR 后被 CI 打回的一轮往返。
许可证
MIT,见 LICENSE。