供应商启停开关 dunlingzi/dsh-provider-toggle

dsh-provider-toggle

为 DeepSeek Harness 的 设置 → 模型 页提供模型供应商的启用/停用开关，并在页脚给出一个存档列表，让停用的供应商能回到配置里。

停用是真正的停用：它 unset llm-pi-ai.providers.<route> —— 与官方「删除供应商」按钮执行的是同一处写入 —— 因此路由会注销，供应商会从 composer 选择器与子代理选择共同读取的模型目录里消失。由于这次写入删掉的是整段配置，插件会先把它原样存档进自己的设置项，启用时逐字段还原（所有手写字段 —— headers、compat、reasoningEfforts、逐模型覆盖 —— 都能往返，因为存档字段是开放类型的）。

针对 DSH 0.2.0-rc.2（desktop 档）构建。无构建步骤：两半都是纯 JavaScript。

它渲染什么

| 位置 | 槽位 | 内容 |
| 供应商行 | settings.models.provider-card（keyed llm-pi-ai） | 每个自定义供应商卡片内的一行设置项 —— 左标题、右开关 |
| 页面页脚 | settings.models.footer | 全部已存档供应商，以及用于恢复它们的开关 |

被停用的供应商不再有行留存，所以页脚是它唯一能被重新启用的地方。存档为空时，页脚完全不出现在页面上。

它把自己当页面的访客，而不是自成一套。 该行用的是宿主自己的「带标签开关行」（dsh-client-ui-settings-general 的 DeveloperToolsRow）：左侧是标题 + 描述块，字号沿用宿主；右侧是控件，两者间距 24px —— 开关是宿主 Switch 在 dpt- 前缀下的一份拷贝（36×20，关态 --dsw-alias-border-l3／开态 --dsw-alias-brand-primary，120ms 滑动，禁用时半透明）。该行刻意不带自己的 margin、padding 或 border，因为卡片本身已经是一个 gap:12px 的纵向 flex。被阻断的原因就是该行的 description，失败信息以 role="alert" 渲染在这个文本块内 —— 与宿主放置它们的位置完全一致。引用的每一个自定义属性都是 --dsw-* 主题令牌，任何地方都不出现字面色值；tests/run.mjs 对以上全部做了断言。

截图

pi-ai 供应商在 设置 → 模型 页拿到的那一行 —— 宿主自己的带标签行，插件开关在右侧：

供应商行及其启用/停用开关

被守卫拦下的行会通过该行的 description 自我说明，位置正是宿主放说明文案的地方 —— 这里 agent 的默认模型指向了该供应商，同时子代理策略仍然列着它：

被阻断的行，同时显示默认模型阻断与子代理警告

页脚存档 —— 被停用供应商唯一能被重新打开的地方，因为它自己的行已经没了：

页脚存档列出被停用的供应商

截图取自实机 profile。图中的供应商名是本仓库通篇使用的虚构示例。

用法

1. 设置 → 模型。 每个 pi-ai 供应商行末尾都有一个开关。本 README 与 tests/ 里的供应商名均为虚构（Acme Local、Acme Relay (OpenAI)、Globex Cloud）。
2. 点它停用。该行消失，供应商从模型选择器里消失，页脚存档里出现它的条目。
3. 在页脚点它的开关启用。供应商带着与停用前逐字节相同的配置回来，它的行也回来了。

状态存在 profile patch 里（profiles/<profile>/cordis.patch.yml → - id: provider-toggle → config.disabled），所以重启后依然有效。

守卫规则

| 情况 | 行为 |
| agent 的默认模型指向该供应商 | 开关被禁用并显示原因。请先切换默认模型。 |
| 该供应商同时出现在子代理可选模型里 | 允许停用并显示警告；那条可选模型条目将失效。 |
| 该供应商在组合层里也有声明 | 拒绝 —— unset 用户 profile 不会把它摘下来，所以插件不假装做到了。 |
| 期间有别人改了设置 | 按冲突拒绝，重新读取文档，可重试。 |
| 设置文档只读 | 用宿主自己的消息拒绝该操作。 |

安装（desktop 档）

profile 的 package.json 只允许写精确的 registry 版本号，所以本地 tarball 是通过 pnpm-workspace.yaml 的 overrides 装进去的（第 2 步有两处）：

$REPO = '<this checkout>'
$DSH = "$env:USERPROFILE\.dsh" # 或你的 $DSH_HOME $PROFILE_DIR = "$DSH\profiles\desktop"

1. 打包
cd $REPO
pnpm pack --out "$PROFILE_DIR\local-packages\dsh-provider-toggle-0.2.7.tgz"

2. 声明 —— package.json 写精确版本，tarball 写进 pnpm-workspace.yaml 的 overrides package.json "dsh-provider-toggle": "0.2.7"
+ dsh.profile.bundles 里加 "dsh-provider-toggle" pnpm-workspace.yaml overrides: dsh-provider-toggle: file:local-packages/dsh-provider-toggle-0.2.7.tgz

3. 安装，然后校验
cd $PROFILE_DIR
CI=true pnpm install --no-frozen-lockfile
CI=true pnpm install --frozen-lockfile
再跑一遍你 DSH home 自带的只读安装门禁

然后重启应用。这道门禁就是标准的本地插件安装检查 —— 改前只读校验、精确版本 + workspace override、改后同样门禁 + frozen 安装。

自测

node tests/run.mjs # 77 项 —— 插件本身
node tests/uninstall.test.mjs # 32 项 —— 卸载工具端到端
node tests/desensitize.test.mjs # 12 项 —— 脱敏门禁
npm test # 三套连跑

tests/uninstall.test.mjs 会读取活动 profile patch （默认 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml）；把 DSH_PROFILE_DIR 指向别处即可校验另一个档。它的 scratch 目录建在系统临时根下，因此跑测试永远不会写进你自己保留的目录。

除 node_modules/ 下随仓库携带的 schemastery 之外没有依赖，它用于校验宿主半边的 Config。

tests/run.mjs 在 vm 里配一个 window.__ModuleLoader__ 壳来求值 client.js（于是语法错误或顶层 TDZ 会在这里失败，而不是把设置页整个搞白），对两个槽位做浅渲染，并在一个内存版设置文档上端到端驱动开关协议 —— 该文档模拟了宿主的 revision 栅栏与 path-op 语义。

tests/uninstall.test.mjs 在 scratch 目录里对真实 profile patch 的一份副本跑维护工具 —— 从不碰活动 profile —— 并断言移除插件那段之后文档逐字节相同。

卸载 / 回滚

1. 在「模型」页页脚把每个已存档供应商都启用（否则工具会拒绝执行）。
2. 先看计划，再从 profile patch 里移除插件的设置段：
node tools/uninstall.mjs
node tools/uninstall.mjs --execute
3. 从 profile 的依赖列表里移除该包（命令由工具打印）。

tools/uninstall.mjs 默认是 dry run，除非传入 --execute；写之前会连同字节数与 SHA-256 一起备份；存档里还有供应商时会拒绝执行 —— 卸载永远不会悄悄丢掉某个供应商的配置。

那份备份同时就是回滚件：把它拷回 cordis.patch.yml 覆盖，然后重启。

已知限制

- 只针对 llm-pi-ai。 DeepSeek Account 与 DeepSeek 行是官方内置段，「停用官方路由」语义不同，不在范围内。
- 开关位于行的末端、行头下方。 官方页面把这个扩展槽位渲染成行内操作按钮的兄弟节点，所以开关无法插到 编辑/删除 之间。没有修改任何官方包。
- 已经绑定到被停用供应商的会话会保持绑定。 只有默认模型被守卫；已经选中该路由的会话在下一次请求时会失败，直到它切换为止。这正是默认模型守卫是硬阻断的原因。
- 存档是部署配置，不是密钥库。 只暂存 profile 配置；API key 留在凭据服务的 <ROUTE>_API_KEY 下，插件从不读取也从不写入。

目录结构

index.js 宿主半边 —— Config 里 volatile 的 disabled 字段就是存档 client.js 浏览器半边 —— 两个槽位与开关协议 cordis.patch.yml bundle patch —— 插入 provider-toggle 行（id == 设置 namespace） locale/ 插件管理器显示文案（en / zh） tests/run.mjs 执行门禁 —— 两半真跑，77 项 tests/uninstall.test.mjs 卸载工具端到端 —— 32 项 tools/uninstall.mjs 卸载辅助工具 docs/images/ README 截图

致谢

写入路径协议（先存档后 unset 的顺序、先恢复后清空的顺序、拒绝分类，以及重命名后按 schema 形状找回存档行的兜底）参照了 dsh-web 包里的 @linxin666/dsh-client-ui-model-capabilities —— 它在 Apache-2.0 下针对 0.2.0-rc.2 发布了同一处缝。本包是一个独立且小得多的实现：一个开关加一个存档，没有逐模型能力编辑器。

dpt-switch / dpt-thumb 规则是 @deepseek-ai/dsh-client-ui-primitives 的 Switch.module.css 改名后的一份拷贝；该行的字号、间距与令牌取自 dsh-client-ui-settings-models 编译产物 ModelsSection.module.css —— 两者都是 DSH 自己的设计系统，所以插件与它所在的那一页保持一致，而不是去近似它。插件在运行期仍然不 import 这两个包（practices.md：自己写控件并贴合宿主才是被支持的路径）。

许可证

MIT。