dsh-model-switches
DeepSeek Harness 插件：为组合器的模型选择器提供按提供商和按模型的开关。设置 → 模型中，每个提供商卡片以及每个提供商的模型目录内都会新增开关；关闭的条目将不再提供选择，同时不会更改提供商配置或中断正在运行的会话。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:qzwjer/dsh-model-switches#533cd6e885a22da10670d55d6b671644073fa08cModel Switches 以 dsh-model-switches 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
为 DeepSeek Harness 的设置 → 模型页面增加两级「使能开关」：
仓库：https://github.com/qzwjer/dsh-model-switches 安装：
dsh plugin --profile desktop add D:\path\to\dsh-model-switches-1.0.0.tgz（换机详见 INSTALL-other-machine.md）
| 厂商开关 | 设置 → 模型：每张厂商卡片右上角，「编辑 / 删除」同一行末尾 | 关闭后整个厂商分组消失 |
| 模型开关 | 编辑 → 自定义设置 → 模型目录：每个模型行右侧 | 关闭后仅该模型消失 |
| 作用范围 | 仅影响目录/选择。已选中该模型、正在运行的会话不会被中断（路由路径不经过目录） | |
| 持久化 | 写入当前 profile 的 cordis.patch.yml，重启后仍在 | |
| 生效时机 | 即时。切换后下一次打开模型选择器即生效，无需重启 dsh |
两级是独立的：厂商开关控制整组，模型开关控制单条。把某厂商的全部模型逐个关掉 会被 host 忽略（否则厂商会静默变空）——要整组隐藏请用厂商开关。
dsh plugin --profile <profile> add <path-to-tgz>
换到另一台电脑请照 INSTALL-other-machine.md 做——只需要拷
那一个 .tgz，不用带源码或 node_modules。
必须用 tgz，不要用
link:。link:会让 Node 从被链接的源目录解析依赖，而源目录 没有@deepseek-ai/schemastery，插件会在加载时ERR_MODULE_NOT_FOUND。
@deepseek-ai/schemastery必须是dependencies，不能是peerDependencies。 早期版本把它写成 peer，于是在干净的 profile（没装其它 DSH 插件）里 pnpm 不会安装它， 插件加载即失败——本机能跑只是因为别的插件恰好把它带了进来。1.0.0 起改为真实依赖， 已在空 profile 上验证可独立安装并加载。
engines.dsh声明了兼容范围（>=0.2.0 <0.3.0）。DSH 版本不匹配时，安装后会被 profile 启动拒绝并给出提示，而不是静默失效。
| 项 | 值 |
|---|---|
engines.dsh | >=0.2.0 <0.3.0 |
| 已在 | @deepseek-ai/dsh 0.2.1-rc.2 上验证 |
握手点都来自 DSH 的公开/稳定结构：settings.describe / settings.mutate 的 RPC 形状、
settings.models.provider-card 插槽、LlmRuntime.listModels。若未来 DSH 改了这些，
插件会退化为「开关不出现」或「开关无效」，不会损坏数据。
dsh plugin --profile <profile> remove dsh-model-switches
cordis.patch.yml 里可能残留一行 model-visibility，删掉即可。
Host 侧在 LlmRuntime.listModels() 上装一个过滤器：被关闭的 provider 返回 []；
DSH 的 buildModelCatalog() 会丢弃空分组，于是两个模型选择入口同时看不到它。
选择校验（modelAvailable）同样走 listModels，所以被隐藏的模型也无法被新选中。
细节、验证记录与已知限制见 NOTES-host.md 与 NOTES-client.md。
Models 页只开放三个扩展位（provider-card / sign-in / footer），没有操作位插槽，
所以开关无法通过插槽直接排进「编辑 / 删除」那一行。做法是：
display:none 的锚点；useLayoutEffect 顺 DOM 结构向上找到卡片的 <li>，取其第一个非插槽子元素
（卡片头部行），再取该行的最后一个元素子节点——就是「编辑 / 删除」按钮组；.dmv_mount，用 react-dom 的 createPortal 把开关渲染进去。不匹配任何 CSS-module 哈希类名（那些会在 DSH 升级后变化），只依赖页面自身定义的 结构关系；找不到就安全回退成原来的一行式布局，不会报错或吞掉开关。
踩过的坑：第一版用
getComputedStyle(el).marginLeft === 'auto'来识别操作行。 这在 jsdom 里成立，但真实浏览器里getComputedStyle返回的是解析后的像素值 （实测369.953px），永远不会等于"auto"，于是线上一直走回退分支——开关留在 第二行。定位逻辑因此改为纯结构判断，不再读取计算样式。这也说明：布局类逻辑不能只靠 jsdom 验证，必须用真实浏览器（本项目用 headless Chrome + CDP）确认。
「编辑」面板同样没有扩展插槽，模型行也是靠结构定位的：找到 section[aria-label]
里那些「末尾是按钮、且含文本框」的 div，在每个后面挂一个 .dmv_modelMount，再 portal 进去。
这里有两个真实的坑：
lastElementChild 不再是按钮，
于是下一轮扫描「认不出」这一行、报告 0 行，把刚建好的开关又拆掉——表现为开关闪一下
就消失。修法是判定时先剔除 dmv_modelMount 再取最后一个真子元素。grid-template-columns: minmax(0,1.4fr) minmax(0,1fr) auto auto
（id / 名称 / 选项 / 删除），挂载点是第 5 个子元素，不加列就会掉到第二行。
用 div:has(> .dmv_modelMount) 补一列即可——但必须带 !important：最初写成
:where(...)，而 :where() 的特异性为 0，被页面自己的 .hash_modelRow 压过，规则
根本没生效。针对「启动后一会儿才显示」「点开关时内容短暂消失」做过三轮处理：
| 处理 | 原因 | 效果 |
|---|---|---|
| 自身写入的 echo 不再重读 | 每次 settings.mutate 都会回推 settings/document-updated，插件原先会在回推时再 describe() 一次并重新发布状态 | 省掉一次往返，且不再多余重渲染 |
| 状态不变则不发布 | 快照内容（hidden / hiddenModels / revision）没变时 store.set 直接返回 | 卡片不再因无关刷新而重渲染 |
| 首次读取改为惰性 | 原先在插件激活时就 describe()，而 Models 页自己也会 describe()；整份设置文档被读两遍 | 不进「设置 → 模型」就完全不发请求 |
| 修正 hook 顺序 | route === undefined 的提前 return 曾位于 8 个 hook 之前，违反 React 规则 | 消除潜在崩溃/错乱渲染 |
实测（headless Chrome + CDP，真实 GUI）：点击一次厂商开关，0 次 dmv 节点被摘除、 0 帧出现卡片为空。
测量 /api/session/modelCatalog：返回 17 个厂商、645 个模型，首次约 385ms，
之后仍约 200ms；整页加载期该请求出现过两次（约 700ms 那两次是并行发出的）。
本插件不调用 modelCatalog，也不在启动时读设置（0.4.1 起），所以这段等待来自
DSH 自身的目录聚合。插件能做的只是不往里再加一笔。
关闭某个厂商时，如果某个会话当前正选着该厂商的模型，那个会话的输入框会变灰，
直到切换到别的模型。这是过滤目录的固有结果（DSH 客户端用目录成员判断
routable），不是本插件的 bug。开关旁的提示文案已说明这一点。
| 文件 | 作用 |
|---|---|
index.js | Host 半身：Config（hiddenProviders + hiddenModels，均 volatile）+ listModels 过滤器 |
client.js | 浏览器半身：注册到 settings.models.provider-card，用 portal 把厂商开关放进操作行、把模型开关放进每个模型行 |
cordis.patch.yml | bundle 补丁，插入 id: model-visibility 一行 |
package.json | bundle + dsh.client 声明 + engines.dsh 兼容范围 |
dist/*.tgz | 分发包（只把这个拷到别的电脑） |
INSTALL-other-machine.md | 换机安装步骤 |
NOTES-host.md / NOTES-client.md | 两个半身的设计与验证记录 |
# 在本目录执行
pnpm pack --pack-destination dist
产物落在 dist/，只有 6 个文件、约 23KB，不含 node_modules。
安装到本机：
& 'D:\software\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd' `
plugin --profile desktop add 'D:\workspace\dsh-model-switches\dist\dsh-model-switches-1.0.0.tgz'
升级时把
package.json的version改掉再重新add。同版本号重装不会刷新内容 （pnpm 会命中缓存），必须升版本。