メインコンテンツへスキップ
X

dsh-capability-toggles

xiafan68/dsh-capability-toggles

Turns 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.

インストール

dsh plugin --profile web add github:xiafan68/dsh-capability-toggles

README

会话能力开关 · 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,组里每一行都变成未勾选:

关掉 blender 一组后只剩 33/48

怎么找到它

显示名、包名与关键词都按「用户会怎么搜」来取,而不是按代码里的名字:

位置内容给谁看
插件页标题 / 商店卡片会话能力开关(英文 Capability toggles)用户
插件页描述 / 商店卡片一句说清入口在哪 + 开启/关闭之后发生什么 + 只影响当前会话用户
包名(安装标识,尚未上 npm)@dsh-external/dsh-capability-toggles安装、日志、Loaders
keywordstools 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%)
inferGroupstrue没有声明的能力是否按前缀 / provider 推断分组;关掉后只显示声明过的组
showEntrytrue是否显示工具行里的「能力」芯片

使用

  1. 在输入卡的工具行(附件、权限、模型选择那一排)最左边找到 能力 芯片,点开。 面板从输入卡上方展开,宽度跟随输入卡。收起有三种方式:再点一次芯片、点面板里的「收起」、 点面板外面任意位置(正文、会话列表、输入框都算),或者按 Esc。
  2. 面板按插件分组。分组默认折叠:点组头(或聚焦后按回车 / 空格)展开,展开后每项一个勾选框, 行首标签标出 工具 / 技能。
  3. 勾掉即关闭,下一轮模型请求生效:
    • 关工具 → 该工具不再出现在模型的工具清单里;
    • 关技能 → 它从技能目录消失(连摘要都不给),skill 工具也加载不到,输入框打 /名字 也不会注入。
  4. 组头勾选框是插件粒度的整组开关,部分关闭时显示半选;组头上还显示 on/total。
  5. 「全部恢复」清空本会话的所有关闭项。
  6. 组名带 推断 的是没有声明归属、按工具名前缀 / 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_selftestrestrict 只带已知工具、skill shadow 形状、重算先清旧的、detach 回收、服务缺失不抛
server_selftestBFF 真 socket:读状态、单项/整组开关、跨源写拒绝、坏 JSON、缺参、413、404
client_bundle_selftest假 __ModuleLoader__ 跑产物:注册面、两个槽位、中英词条对齐、sessionId 注入
display_meta_selftest包名形态、根描述中英双写、keywords 覆盖检索词、locale 标题/描述质量(含"开关"两个方向)、exports 与 files 覆盖
submission_selftestdsh.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。

开发流程

  1. 改 src/(宿主)或 src/client/index.js(面板)。
  2. 宿主改了 → npm run check,重启 DSH。
  3. 客户端改了 → npm run build 重新生成 lib/client.js,重启 DSH 后刷新页面。lib/client.js 是产物,不要手改。
  4. 改了配置项 → 同时更新 cordis.patch.yml 注释、上面的配置表,以及 fiber_contract_selftest 的默认值断言。

改名与改描述

发布后再改可见信息,最容易漏的是三处一起改:

  1. locale/zh.json、locale/en.json 的 meta.title / meta.description(用户看到的);
  2. package.json 的 description(插件页与商店的兜底文本,缺 locale 时显示的就是它);
  3. 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。

関連プラグイン