dsh-capability-toggles
Manifest validTurns individual tools and skills on or off for the current session from one button in the composer toolbar, grouped by plugin, so a profile with many plugins only exposes what this conversation needs
会话能力开关 · 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。
Comments
Loading…
Similar plugins
by kmyy350234-dz
Keeps heavy tool groups out of every request and brings them back on demand, by keyword, or automatically at session start.
★ 4
MIT
JavaScript
Nov 7, 2026
dsh plugin --profile web add dsh-tool-drawerAdds a right-sidebar panel that lists the skills available to the current session, searches and tags them, combines them with your own saved prompts, appends the selection to the composer in one click
★ 0
dsh plugin --profile web add dsh-skill-prompt-injectorPersonal toolbox for the dsh web profile with per-feature toggles: task-done desktop notifications, one-click restart, session deletion, plugin enable/disable, update checks, and UI utilities.
★ 0
dsh plugin --profile web add dsh-toolsPersonal toolbox for the dsh web profile with per-feature toggles: task-done desktop notifications, one-click restart, session deletion, plugin enable/disable, update checks, and UI utilities.
★ 0
↓ 137/wk
dsh plugin --profile web add dsh-toolsby xiamubumu
Composes tools, skills and MCP servers into switchable per-session sets, shrinking the resident tool surface and the system prompt on demand.
★ 0
MIT
JavaScript
Oct 15, 2026
dsh plugin --profile web add dsh-capability-composerby xiake-1
DSH plugin: enable/disable skills by group (skill toggles manager)
★ 0
MIT
JavaScript
Nov 10, 2026
dsh plugin --profile web add dsh-skill-toggles