dsh-model-toggle — 模型级开关（隐藏 / 显示）

设置页 → 模型，页面底部多出一块「模型开关」面板：每个自定义提供商的每个模型一行，右侧一个「隐藏」按钮；隐藏后该模型立即从对话底部的模型选择器消失，同一行变成「显示」按钮，随时恢复。

安装

需要 DSH 0.2（@deepseek-ai/dsh-typert-protocol ≥ 0.2.0-rc.1）。插件是纯 ESM JavaScript，没有构建步骤，装完不用编译。

# 从 GitHub 源安装
dsh plugin --profile <你的 profile> add wangnian886/dsh-model-toggle

# 或装预构建的 Release 包（免 allowBuilds 授权，不需要 git）
dsh plugin --profile <你的 profile> add https://github.com/wangnian886/dsh-model-toggle/releases/latest/download/dsh-model-toggle.tgz

latest/download/dsh-model-toggle.tgz 这个链接不带版本号，升级后仍然有效。

--profile 填你正在用的 profile 名（Web GUI 默认是 web；本机桌面版是 desktop）。装完刷新网页，设置 → 模型 页底部就会出现「模型开关」面板。

卸载（同时会自动把所有已隐藏的模型还原）：

dsh plugin --profile <你的 profile> remove dsh-model-toggle

使用

1. 刷新网页（客户端模块只在页面加载时挂载）。
2. 打开 设置 → 模型，滚到底部「模型开关」面板。
3. 点某行的「隐藏」→ 该模型从对话选择器消失；点「显示」→ 合并回该提供商的模型列表末尾（原位置不保留，选择器里的顺序会变）。

两道护栏会拒绝隐藏并给出说明：不能隐藏某个提供商的最后一个可见模型（llm-pi-ai 要求每条 route 至少保留一个模型条目，列表为空会让配置校验失败），不能隐藏 DSH 当前的默认模型（隐藏后新会话无法解析它）——先在模型选择器里切到别的模型再隐藏。

注意：隐藏当前会话正在用的模型前，先把会话切到别的模型。内置 DeepSeek 系提供商没有配置面，不归本插件管（面板里也不会出现）。

机制（读给想知道原理的人）

• 对话选择器显示的就是 llm-pi-ai 配置里每个提供商的显式 models 数组；隐藏 = 把该模型条目从数组摘除，完整条目原样存进 profile 目录的 dsh-model-toggle.archive.json，显示 = 按原条目合并回去。
• 存档是插件自己的 JSON 文件（版本号 version: 1，结构 { hidden: { [route]: [modelEntry…] } }），不写 DSH 配置系统——DSH 0.2 的配置校验（volatile 键、ACTIVE 状态过滤、replace 语义）对自写分区不友好，文件存档绕开全部三个坑。
• 归档文件损坏时插件拒绝一切隐藏操作（fail-closed），配置一个字节都不会动；list-states 会带出 archiveError。
• 禁用/卸载本插件时自动把所有已隐藏模型合并回原提供商（通过 unload 钩子）；已从配置里消失的提供商（例如被「模型 Pro」禁用）保留存档，等提供商恢复后可再显示。
• 与 dsh-model-pro（模型 Pro）共存：两者写的是同一个 providers 表。模型 Pro 的批量编辑是「整体替换」式，会把已隐藏的模型带回来；发现列表对不上时以本插件面板的「显示」状态为准重新隐藏即可。

边界

• 只管理 llm-pi-ai 的自定义提供商（profile cordis.patch.yml 里 config.providers 表内的）。
• 配置里没有的提供商不出现在面板；被模型 Pro 禁用的提供商以「缺失」状态出现（只读展示存档）。
• 面板一次只允许一个操作在途（防并发写乱序）。

故障排查

• 面板没出现 → 确认刷新过网页；确认插件管理里 dsh-model-toggle 是 enabled 且 active。
• 面板报错 active Service "modelToggle" is unavailable → 说明 apply() 里没构造服务实例（new ModelToggleRuntime(ctx)）。Cordis 的服务注册发生在构造函数里，漏了这行 ctx.typert.register(MANIFEST) 照样成功、但网关取不到实例。
• 面板报错 → 错误文案会带原因；「settings service is not available」说明宿主状态异常，重载插件或重启 DSH。
• 想整份回退 → 插件管理里禁用本插件，所有隐藏模型自动还原；dsh-model-toggle.archive.json 还原成功后会被清空。

开发自测

测试随仓库发布，零依赖（假宿主 + 假 React，不需要装 DSH，也不需要 npm install）：

npm test           # 5 套，合计 108 项，应全绿
npm run test:mutant  # 变异测试，应当跑出 10 条 FAIL（exit 1）

脚本	项数	覆盖
test/host.test.mjs	57	host 行为契约（raw/descriptor 两臂）+ 服务注册守卫 + 读取失败可见性 + 两道隐藏护栏 + 卸载还原顺序
test/client-id.test.mjs	8	client.js 的 loader id 必须逐字等于包名
test/client-render.test.mjs	21	FooterPanel 渲染、按钮回调、busy 并发守卫、存档损坏提示
test/wire.test.mjs	18	wire 契约：结构比对 + codec 行为比对（两边对同一批信封同接受同拒绝）
test/real-unload.test.mjs	4	真实 cordis 卸载：ctx.plugin() → fiber.dispose()，断言归档模型真的回来了

test/real-unload.test.mjs 是唯一用真实 cordis 的套件——假 ctx 把 effect(fn) 当同步调用，模拟不出卸载顺序，所以 v0.1.2 的真机 bug 在假宿主里完全不可见。它需要 @deepseek-ai/cordis（已在 devDependencies）；没装就打印 SKIP 并退出 0，所以干净检出仍然零依赖全绿，npm install 之后才会真正跑。反向验证过：把 host.js 换回 v0.1.2 的形状，这套会跑出 2 条 FAIL 并精确指向「归档模型必须回来」。

test/host-mutant.test.mjs 是变异测试：test/mutants/materialize.mjs 把 host.js 复制到临时目录并注释掉 new ModelToggleRuntime(ctx);，然后跑同一套断言，应当得到 1 passed, 10 failed。守卫失效时先跑它，确认测试本身还有效。两边的断言体是同一份 test/suite.mjs（由 runSuite(importHost) 参数化被测模块），所以不会出现「改了 A 忘了 B」的漂移。

关于卸载还原的顺序：apply() 的返回值和 ctx.effect() 注册的 disposer 会被 cordis 的 _unload() 并发执行（Promise.all(disposables.clear().map(...))），同步 cleanup 会在 async disposer 过第一个 await 之前就跑完。所以清理模块级句柄不能放在 apply() 的返回值里，必须放进 unload effect 自己的 finally——否则还原逻辑读到的是已被清空的 undefined，卸载时静默什么都不做（v0.1.2 及更早版本的真机 bug，由 unload restore survives apply()'s cleanup running first 这条用例守住）。

关于 wire 契约的比对方式：INVOCATIONS 里的 codec 携带 parse 函数，JSON.stringify 会静默丢掉它们，序列化后只剩 {mode, typeSymbol, schema:{}}——所以拿序列化结果比对证明不了任何事（实测：把客户端的返回值校验整个拆掉，旧断言仍返回 true）。现在的守卫改为行为比对：两边各喂一批合法/非法信封，断言同接受、同拒绝。

test/setup.mjs 用 module.registerHooks 把裸 peer 依赖 @deepseek-ai/dsh-typert-protocol 映射到 test/stubs/ 里的替身——替身刻意复刻真实注册行为（构造函数里调 ctx.reflect.provide），而不是照单全收，否则「声明了 Service 类却没构造」这类 bug 在测试里完全不可见。