dsh-model-orchestrator — 模型调度（两级）

先选模型，再选这个模型所在的渠道；失败时先换渠道、再换模型。输入框下方实时显示当前模型、渠道健康、今日用量与自动切换记录。 新会话的第一条消息就按调度结果调用模型（不再先跑选择器里的那个），新会话首屏也有同一份状态与开关。

装在 DSH 里就是一个 bundle：一个 Host 半身（路由决策）+ 一个浏览器半身（状态条与详情面板）。

配合 dsh-our-free-model（OFM）使用——推荐一起装，但不是依赖。 OFM 把免费模型接进来，本插件在这些车道之间做调度。两者零代码依赖，只有 OFM 写在本机的状态文件被当作额外信号读进来。这是单向适配、非官方：我们读它的文件，它不需要知道本插件的存在。详见与 dsh-our-free-model 的关系。

与 dsh-our-free-model 的关系

本插件与 dsh-our-free-model（OFM）配合使用。 先说清楚关系的性质：这是单向适配，不是合作，也不是官方关联——OFM 的作者没有参与本插件、也没有为它背书；本插件只按 OFM 当前写盘的格式去读它留下的状态文件，不对 OFM 提任何适配要求，也不向它的仓库提交改动。分工是这样的：

OFM 负责「把免费模型接进来，并记录渠道状态」——免登录、免注册、免 API Key，把一批前沿模型注册成 our-free-model / our-free-model-region 两条 provider 车道；并在本机维护一份渠道账本（$DSH_HOME/channel-pack/，记录账号、每账号每模型的限流解禁时间、逐渠道首字与今日 token，以及免费车道的可用性探测结果）。
本插件负责「在这些车道之间做调度」——选哪个模型（智力/速度/成本/用量打分）、走哪条渠道（实时健康、限流、首字、粘滞）、失败了先换渠道还是换模型、锁定一个模型时怎么在它的渠道间切换。它不产生模型，只决定请求走哪条已经存在的路。

两者没有代码依赖，也没有互相 import（package.json 里没有 dependencies），模型清单来自内核的 LLM 注册表（llm.listProviders/listModels/resolveModelInfo），不硬编码任何渠道。

你装了什么	得到什么
只装 OFM	免费模型可用；走哪条渠道由 OFM 自己决定，本插件不参与
只装本插件	任何 DSH provider 都能正常路由；少了 OFM 那层渠道旁证，改用本插件自己观测的流量账本
两个都装（推荐）	免费模型 + 两级调度：渠道健康排序、失败先换渠道再换模型、偏好锁定、状态条全部生效，且冷却与限流以 OFM 账号池的真实解禁时间为准

OFM 提供哪些信号（可选）

OFM 往本机写四个 JSON，本插件只读不写：

文件	由谁写	不装 OFM 时
`$DSH_HOME/our-free-model/availability.json`	OFM	免费车道的可用/不可用判定缺失，该渠道按「未知」处理
`$DSH_HOME/our-free-model/stats.json`	OFM	免费车道的今日用量缺失，用量项按 0 计
`$DSH_HOME/channel-pack/state.json`	OFM（内嵌 channel pack）	拿不到每账号每模型的限流解禁时间，冷却判定改用本插件自己观测到的失败
`$DSH_HOME/channel-pack/token-ledger.json`	OFM	少了第二优先的延迟证据，延迟只认本插件实测和报告值

读不到文件、格式不认、provider 不认识，一律降级成「没有信号」——signal() 返回 available: null（未知），不是 false（不可用），所以未知不会被当成坏渠道排掉。想彻底关掉这两个来源：配置里 channelData: false 和 freeModelData: false。

这四个文件是 OFM 的内部实现细节，没有版本承诺，也没有为第三方准备的契约。本插件单向跟随：按它现在写盘的格式读，格式变了就退回「没有信号」，不要求 OFM 为本插件做任何改动。

证据：集成测试 tools/integration.mjs 把 DSH_HOME 指向一个空临时目录（既没有 our-free-model/ 也没有 channel-pack/），在这个前提下加载真实的 Host 半身、跑通路由、失败换渠道、偏好模式与暂停恢复——52 项全过。

安装

需要一个已经装好的 DSH（Desktop 或 dsh web）。

# 1) 把仓库放到任意目录，然后作为一个本地 link 依赖装进你的 DSH profile
cd ~/.dsh/profiles/web
pnpm add link:/absolute/path/to/dsh-model-orchestrator

# 2) 把 dsh-model-orchestrator 加进 ~/.dsh/profiles/web/package.json 的
#    dsh.profile.bundles 数组（漏了这一步插件不会被加载）
# 3) 重启一次 DSH Desktop（或 dsh web）

Host 半身只在启动时加载一次，浏览器半身（状态条/详情面板）由 HMR 或刷新页面加载。

验证：输入框下方出现模型状态条；/route status 能列出模型组； model_orchestrator {"action":"status"} 的 catalog.total > 0。

它解决什么

你手上有十几条免费/低价渠道，同一个模型（比如 glm-5.3）往往在 4~6 条渠道上都有。真正要回答的问题不是「哪个模型分数最高」，而是：

现在该用哪个模型？ —— 由报告里的智力分、实测速度、成本和你的偏好共同决定。
这个模型该走哪条渠道？ —— 由渠道的实时健康、限流、额度和实测首字决定。
渠道挂了怎么办？ —— 先换同模型的其它渠道；只有整个模型的渠道都用不了，才换模型。
我只想用某个模型。 —— 打开偏好模式：只调用该模型，自动在它的渠道间切换；全部渠道不可用时暂停偏好、改用备用模式并提醒你。

旧版把「模型」和「渠道」压成一个分数：每次失败都重新给所有 provider/model 排序，于是可能在 glm-5.3 的另一条渠道还活着的时候，换到一个更弱的模型上。这一版把两层分开，并把「用户明确选的模型」放到最高优先级。

优先级是怎么算的（可以逐项复述）

模型层（选哪个模型的权重）：

项	含义	数据来源
quality	智力分 / 46，按可信度向中性收缩	测速报告（先验）
speed	`1/(1+首字/10s)`	本机实测优先 → 渠道账本 → 报告逐车道
health	`1/(1+0.8×衰减失败数)`	本机流量账本
cost	`1/(1+家族消耗×车道倍率)`	报告标签 + 模型名里的 `x0.2` 倍率
usage	`1/(1+今日 token/2M)`	渠道账本今日用量

四档策略只是重新分配这些权重（每档权重和为 1）：

quality：智力 0.58，速度/健康/成本/用量各占少量；
balanced（默认）：智力 0.46，速度 0.18，健康 0.14，成本 0.14，用量 0.08；
economy：成本 0.30，智力 0.34；
speed：速度 0.34，智力 0.34。

渠道层（同一个模型内选哪条渠道）：同样的五项，但 quality 相同（同模型），真正起作用的是健康、首字、倍率、今日用量，以及「是否正持有本会话的 prompt 缓存」。

粘滞：当前模型/渠道领先不到切换阈值时不换；切换阈值随任务复杂度收紧或放宽。用户刚在选择器里手动选过的模型，切换阈值翻倍（默认 30 分钟内）。

失败处理顺序：

记录到实际失败的那条 provider/model（用 agent/request 的最终配置，而不是可能滞后的请求头）；
先在同模型的其它渠道里重试（同一步内 {kind:'retry'}，调用方看不见）；
整个模型都没有可用渠道时，才按策略换模型；
偏好模式下第 3 步会触发「偏好暂停」：改用备用模式并通知，渠道恢复后自动恢复偏好。

两种「不是我们的错、但也不能一直忍」的情况（LOCAL PATCH 2026-10-18）：

渠道安全审核拦截（如腾讯 CodeBuddy/WorkBuddy 回 HTTP 400 请求被拦截，请重新发送 request illegal）。这类 400 会被识别成 safety 判定：该渠道对这个模型冷却 30 分钟，同渠道的其它模型不受影响，本次请求立刻换渠道重试。以前它被当作 INVALID_REQUEST（「我们的请求写错了」），于是既不冷却也不换渠道，连续两个回合都撞同一堵墙。
连续被同一个渠道拒绝（任意 400）。单次 INVALID_REQUEST 仍然不动路由（渠道无罪），但同一渠道 requestRepeatThreshold（默认 2）次、在 requestRepeatWindowMs（默认 10 分钟）内接连拒绝时，该模型被暂停 requestRepeatBlockMs（默认 30 分钟）并立刻换渠道。收到一次成功响应就清零。

偏好模式

面板里点「偏好」，或在 /route 里：

/route prefer glm-5.3          # 只调用 glm-5.3，自动在它的渠道间切换
/route prefer glm-5.3 buddy    # 限定只走 buddy 这一条渠道（该渠道挂了就算偏好不可用）
/route unprefer                # 回到自动

规则：

同一个模型，换渠道不换模型。 渠道限流/额度耗尽/不可用时，优先在同模型的其它渠道重试。
只在本步不满足时临时改选。 如果这次请求需要图片、而偏好模型不支持视觉，或者上下文超过它的窗口，这一步会临时用别的模型，但不会暂停偏好模式（下一次请求仍回到偏好模型）。
所有渠道都不可用才暂停。 判定标准是渠道级：冷却、被屏蔽、渠道面板关闭、免费车道探测不可用。暂停时：状态条变黄、面板显示原因与倒计时、桌面端弹通知；默认在渠道恢复后自动恢复并再通知一次。
选择器跟着走。 路由切换会写入内核的 model/selection，所以浏览器里的模型选择器、会话日志、模型收到的「模型已变更」提示、面板显示的模型是同一个。在偏好模式下从选择器里改选模型，会把偏好模型一起改掉（可在配置里关闭）。

数据从哪来（以及为什么更准）

数据	来源	用法
模型清单、上下文窗口、模态、reasoning 档	内核 `llm.listProviders/listModels/resolveModelInfo`	能力过滤、effort 选择
渠道账号、每账号每模型的限流解禁时间	OFM 写的 `$DSH_HOME/channel-pack/state.json`	渠道级可用性（只读）
今日每渠道每模型的请求/错误/token/首字	OFM 写的 `$DSH_HOME/channel-pack/token-ledger.json`	第二优先的延迟证据 + 用量项
免费车道的逐模型可用性与探测延迟	OFM 写的 `$DSH_HOME/our-free-model/availability.json`	免费车道不可用/可用判定
免费车道今日逐模型统计	OFM 写的 `$DSH_HOME/our-free-model/stats.json`	免费车道用量
真实流量的首字、token、失败	本插件观测 `llm/stream`	第一优先的延迟证据 + 健康账本
智力分、逐车道报告首字、标签	报告导入 / 随包 `priority-data.json`	先验，可信度收缩

关键点：

报告只是先验。 报告是别的机器、别的日期、benchmark 最大 effort 下测的。 quality 会按「识别可信度 × 实测/估算」向 0.5 收缩：精确别名/规范表/改名折叠 0.9，模式猜测 0.7，报告没见过的 id 直接中性 0.5。它不会因为「报告没写」就被排除。
渠道改名不改家族。 同一个模型换个 id 卖（sn-deepseek-v4-1-flash → sn-deepseek-v4-1-flash-1017、opencode/deepseek-v4.1-flash）仍归到同一个家族：识别会先试原样、再试去掉静态标记，最后逐层折叠并回表验证（构建号/日期戳、区域标记 -sg、渠道命名空间 xxx/、渠道前缀 sn-、虚线版本号），只有折叠后恰好命中已知模型 才采纳，所以猜错不产生任何后果，新后缀也不用改代码。见下节。
不再拿家族最快车道的首字当某条车道的首字。 旧版会让一条 45 秒的车道继承另一条 1 秒车道的速度；现在只认这条车道的实测/账本/报告值，没有就承认「没有证据」。
渠道限流以渠道面板自己记录的为准。 同一渠道多账号时，只有所有启用账号都被该模型限流才判不可用。
所有数据都在本机。 不上传任何东西；渠道文件读取失败只是「没有信号」，路由照常工作。

模型识别：四道关卡

顺序	关卡	例子	可信度
1	原样命中别名 / 规范表 / 修正表	`gmodel`、`z-ai/glm-5.3`、`deepseek-flash`	1.0
2	折叠后恰好命中已知模型	`sn-deepseek-v4-1-flash-1017`、`opencode/deepseek-v4.1-flash`	0.85–0.95
3	命名约定模式	`mimo-v2.6-flash-ultra`、`glm-5.3-flashx`	0.65–0.7
4	认不出来 = 自己一个家族	`brand-new-model-2099`	0（中性分）

第 2 关的折叠规则在 src/families.js 的 FOLD_STEPS（最多折三层，先试折叠次数最少的）：

折叠	去掉的东西	可信度
`snapshot-date`	`-2026-04-20` 这类日期戳	0.95
`build-tag`	`-1017`、`-0731`、`-v2`、`-b3` 这类构建 / 修订号	0.95
`region-tag`	`-sg`、`-us`、`-intl`、`-latest` 这类区域 / 渠道标记	0.95
`namespace`	`opencode/`、`codearts/` 这类一层命名空间	0.95
`channel-tag`	`sn-` 这类渠道自己的短前缀	0.85
`version-dash`	把 `v4-1` 折成 `v4.1` 这类虚线版本号	0.85

为什么安全：折叠只是「提议」，采纳的唯一条件是折叠后的 id 在别名表里精确存在。所以 brand-new-model-2099 去掉 -2099 之后 brand-new-model 谁都对不上，直接退回身份家族，不会把两个陌生模型混成一个；模型名本身以数字结尾的（gpt-oss-20b、nemotron-3-super-120b-a12b）也照原样保留。

批处理端点是唯一例外：:batch / :async 永远保持自己的身份，绝不被折进交互式家族。

屏蔽与放行跟着家族走。 既然一个模型可以有多个 id，deny: ["deepseek-v4.1-flash"] 必须把它所有拼写一起挡掉，否则换个后戳就是绕过自己的黑名单。规则：写家族名或任意一个已识别的 id → 整个家族被挡；写 provider/model → 只挡那一条车道。denyProviders（计费渠道用的那个）本来就是渠道级，完全不经过模型识别。

界面

两个入口，同一份数据：

会话里：输入框下方一条状态带（conversation.composer.dock，与「用量/余额看板」并排）；
新会话首屏：新会话用的是另一个 composer 变体（hero），composer.dock 在那一屏不渲染—— 所以另注册了一个紧凑 chip 到 conversation.hero.options（工作区/预设那一行的右侧）。还没有任何请求时它显示下一条消息将会用哪个模型，点开是同一个面板的浮层。
官方模型列表最上方：对话框右下角点开模型列表（两级菜单里选「模型」那一页），第一行就是 自动选择，排在 DeepSeek 账号 上面。选中它 = 模型全部由调度决定；在这一页里点任何一个具体模型 = 你明确要那个模型，自动选择随即让位（面板「设置」里也有同一个开关，可以在不选模型的情况下关掉它）。
对话框右下角那个模型名：官方 seat 的标签（conversation.input.model.label）由本插件接管。开启自动选择后那里显示的是**「自动选择」**——选择器里那个模型名这时已经不是实际被调用的模型；紧跟其后的推理档 chip 也一并隐藏（它同样只属于选择器）。关掉开关立刻恢复显示模型名，模型列表内部的每一行仍然显示各自的模型名，不受影响。

会话里：[模型调度 · 自动]  ● glm-5.3  可用  今日 12.4k  自动切换 2   ▾
首  屏：[● 模型调度 · 自动  glm-5.3 ▾]                    （点开是浮层面板）
右下角：[⌗ 自动选择 ▾]                                    （开启自动选择时，官方 seat 被改写）

展开后的面板按标签页分（一屏之内，不再是一条几十行的长栏）：

头行：模式（自动 / 偏好 / 手动 / 关闭）、当前策略、刷新；
概览：当前模型卡（家族、真实渠道、推理档、请求数、自动切换、失败原因与倒计时）、偏好卡（当前偏好 + 可用渠道数 +「设为偏好」+「浏览全部模型…」）、目录卡，以及策略排名前 4 的模型组；
模型：全部模型组（★ 设为偏好、可用渠道/总渠道、最佳渠道、智力、得分）；
渠道：当前模型的渠道表（渠道、状态、得分、首字、今日 token）；
记录：最近切换（时间、从哪到哪、为什么）；
设置：策略、偏好模型（下拉列出全部模型，不截断）与备用模式、推理档、单轮 token 预算、渠道数据接入状态、首轮接管开关、自动选择开关；
偏好暂停时，概览顶部出现横幅：原因 + 「重试偏好」。

偏好模型有两个入口：模型组表里点 ★ 直接设；或点「浏览全部模型…」打开专用选择器—— 搜索框 + 全量模型组列表（每行给出可用渠道/总渠道、最佳渠道、智力、视觉、上下文窗口），点一行即设为偏好，另有「不锁定偏好（回到自动调度）」。下拉与列表都由 /api/model-orchestrator/families 提供：它是不截断的全量清单，只在这个界面打开时按需拉取，不跟着 10 秒轮询走。

面板只读 /api/model-orchestrator/summary、写 /api/model-orchestrator/config；两条路由都走宿主自己的鉴权闸门（ctx.connection），未登录的 loopback 调用者拿到 401。

给模型用的工具与命令

工具 model_orchestrator：

status / explain / lanes
set（mode/strategy/preferModel/preferProvider/preferFallback/turnTokenBudget/deny/allow/denyProviders/reasoningEffort）
prefer / unprefer
refresh / import_report / clear_import

命令 /route：

/route status|explain|lanes|auto|manual|off|prefer <模型> [渠道]|unprefer
/route quality|balanced|economy|speed|reasoning <auto|preserve|effort>|refresh

面板上的每个操作和工具/命令走的是同一份实现。

配置

写在 profile 的 cordis.patch.yml（优先级最高），或在面板里改（存到 $DSH_HOME/model-orchestrator/overrides.json）。补丁层里显式写过的键会盖过面板。

键	默认	说明
`enabled`	`true`	总开关。
`mode`	`auto`	`auto` / `prefer` / `manual` / `off`。
`preferModel` / `preferProvider`	`''`	偏好模型（家族 id、模型 id 或 `provider/model`）与可选渠道限制。
`preferFallback`	`auto`	偏好不可用时的模式：`auto` / `manual` / `off`。
`preferNotify`	`true`	暂停/恢复时发桌面通知。
`preferAutoResume`	`true`	渠道恢复后自动恢复偏好。
`preferFollowSelection`	`true`	选择器改选时同步改偏好模型。
`strategy`	`balanced`	`quality` / `balanced` / `economy` / `speed`。
`deny` / `allow`	`[]`	额外屏蔽 / 放行的模型（家族名、任意一个 id，或 `provider/model` 精确到单条车道）。写家族名或某个 id 会覆盖这个名字的所有拼写；写 `lane/model` 只作用于那一条车道。
`denyProviders`	`[]`	整条渠道排除（按渠道 id，与模型识别无关；计费渠道常驻这里）。
`maxSwitchesPerStep` / `maxSwitchesPerTurn`	`3` / `12`	同一步/同一轮最多自动切几次。
`requestRepeatThreshold`	`2`	同一渠道在窗口内连续拒绝几次后暂停该模型（1–10）。
`requestRepeatWindowMs`	`600000`	上面那个「连续」的时间窗口。
`requestRepeatBlockMs`	`1800000`	连续被拒后暂停多久（0 = 只换渠道不暂停）。
`proactiveSwitch`	`true`	冷却中的渠道直接跳过，而不是等它。
`escalateOnFailure`	`true`	失败后优先换到智力不低于失败模型的模型。
`turnTokenBudget`	`0`	单轮输出 token 预算，超出后切省 token 档；0 关闭。
`longContextThreshold`	`120000`	超过这个 prompt 规模就只考虑长上下文模型。
`latencyGateMs`	`10000`	首字达到这个值时速度项为 0.5；0 关闭。
`anchorBonus`	`0.04`	保持当前渠道的加分（只影响渠道层，不参与模型比较）。
`switchMargin` / `laneSwitchMargin`	`0.04` / `0.05`	换模型 / 换渠道的粘滞阈值。
`userChoiceTtlMs`	`1800000`	手动选择器改动被尊重的时长（自动模式，翻倍阈值）。
`routeFirstTurn`	`true`	首轮接管：新会话第一条消息就按调度结果调用模型。关掉后首轮先跑选择器里的模型，第二步起才由路由器接。
`autoSelect`	`false`	自动选择：模型完全由调度决定，官方模型选择器只作展示（选它不会改变实际调用）。`manual` 在这个开关下按 `auto` 处理。
`routeSubagents`	`false`	是否也路由子代理会话（默认让子代理自己的模型选择生效）。
`reasoningEffort`	`auto`	`auto`（按策略）/ `preserve`（能保留就保留）/ 具体 effort。
`channelData` / `freeModelData`	`true`	是否读取渠道面板账本 / 免费车道探测。
`catalogRefreshMs` / `channelDataRefreshMs`	`120000` / `30000`	模型清单 / 渠道数据的刷新间隔。
`modelInfoTtlMs`	`21600000`	模型元数据缓存时长。
`usageUnitTokens`	`2000000`	用量项的参考规模。
`reportPath`	`''`	启动时自动导入这份报告。

旧键兼容：pinProvider/pinModel 会被折叠成 preferModel/preferProvider，并把 auto 改为 prefer。

数据存在哪

$DSH_HOME/model-orchestrator/health.json —— 渠道/模型账本：状态、冷却到期、失败次数（3 小时半衰期衰减）、首字 EWMA、token 用量（15 分钟 / 1 小时 / 5 小时 / 当天）。
$DSH_HOME/model-orchestrator/overrides.json —— 面板/工具改过的设置。
$DSH_HOME/model-orchestrator/priority.json —— 你导入的报告数据层；clear_import 删除它。

它是怎么接进内核的

决策点：system-prompt/assemble（prepend: true）。 内核在组装时快照本步模型；插件在快照前写入选择。
自动选择（autoSelect）。 锚点里不再有选择器、也不再有 requestHeader：只保留本插件自己写过的路由（所以同一轮内粘滞照常）。打开时立刻按当前策略重算一次并写回 selection，模型座位当场变化；manual 与它冲突，打开时 manual 落到 auto。在官方模型列表里点了某个具体模型 = 一条明确指令：退出自动选择、采纳这次选择（列表首行的「自动选择」就是重新接管），并在决策日志里留一条 auto-select-off。
列表首行是注入的，不是 slot。 官方模型选择器（client-ui-model-selection）独占座位与菜单，只开放一个 conversation.input.model.label 子槽；替换座位等于影子掉整个官方选择器（搜索、推理档、子代理门禁、键盘导航）。所以那一行由 MutationObserver 在模型页出现时插进渲染出来的列表里，React 把它丢掉时会补回去。
首轮接管（routeFirstTurn）。 会话还没有 requestHeader、本插件也还没写过路由时，选择器里的模型只算「上次用过的那个」，不是本轮指令：锚点直接给 null（不标 userChoice），selectRoute 从全表选最优，再把结果写进 model/selection，于是选择器跟着路由器走而不是反过来。会话建立过程中内核自己写的初始 selection 事件在这里一并丢掉，否则下一步会立刻锚回它。
写选择：sessionController.selectForNextRequest(agent, selection)。 它同时追加 model/selection 事件并更新选择对象，这是浏览器选择器、会话日志和面板保持一致的唯一正确路径。
请求兜底：agent/request。 在 next() 之后再按 state.applied 覆盖一次 provider/model/effort，保证真正发出去的请求就是路由器选的那条。
同一步故障转移：agent/request-error。 返回 {kind:'retry'} 让内核在同一 step 重新解析配置。
观测：llm/stream。 只记录抛出的异常；带内 finish.error 交给 agent/request-error，避免一次失败记两次（非 agent 循环的调用例外，它们没有 request-error）。
同步：llm/adapters-updated + 自适应定时器。 新登录的渠道账号会自动出现；刷新间隔改了不用重启。

验收情况

node tools/smoke.mjs        # 143 项离线校验（纯逻辑）
node tools/integration.mjs  # 53 项：用 mock Cordis 上下文加载真实 Host 半身
node tools/client-smoke.mjs # 44 项：用 stub ModuleLoader + 迷你 React/DOM 渲染浏览器半身

覆盖：配置、家族识别与可信度（含改名折叠：-1017 构建号、opencode/ 命名空间、-sg 区域标记、虚线版本号，以及「构建号不得凭空造出家族」的反例）、失败分类、账本自愈、渠道账本/限流/免费探测、目录装饰（能力/倍率/重复 id/批处理/用户屏蔽）、两级选择、同模型换渠道、偏好模式（生效/限流/暂停/备用关闭/本步临时改选/恢复）、回合结束恢复用户选择、粘滞与升级、effort 选择、报告导入。集成测试还覆盖：真实插件 apply() 接线、model/selection 落盘、请求覆盖、回合边界恢复用户选择、失败重试、偏好暂停通知、成功恢复通知、工具与命令面、首轮接管（选择器里两个不同模型得到同一条首轮路由、下一步不回弹、关掉开关后首轮回到选择器模型）以及 summary 给新会话预告下一条路由。浏览器半身测试覆盖：三个 slot 注册（会话状态带 + 新会话 chip + 官方 seat 标签，含它在 single 槽上对随发行版 1017 标签的 shadow）、五个标签页、专用偏好选择器、浮层的关闭、失败态与加载态，注入到官方模型列表的那一行（位置、可访问角色、点击写配置、被 React 丢掉后补回），以及右下角模型名的接管：开关打开时 trigger 显示「自动选择」，列表里的 option / menu 两处仍显示模型名，关掉后立即还原。

部署动作

以 link:<你的插件目录> 装在 web profile，并已加入 dsh.profile.bundles。
Host 半身改动需要重启一次 DSH Desktop（或 dsh web）才会加载；浏览器半身由 HMR/刷新加载。
重启后确认：状态条显示真实模型；/route status 能列出模型组； model_orchestrator { "action": "status" } 的 catalog.total > 0。

已知边界

只路由 agent 的模型请求。 其它直接调用 ctx.llm.stream 的代码不经过本插件（但仍会被观测用量）。
剩余额度不可知。 免费渠道的上游不告诉你余额；面板显示的是状态、冷却、实测首字和本插件统计的用量。
报告是快照。 报告没有的模型按中性先验处理；跨版本 AA 分数不可比。
家族识别仍可能有误。 精确别名/规范表可信；改名折叠 0.85–0.95，模式匹配只有 0.7；识别错了会把不同模型当成同一个，或者把同一条路线的两个 id 合成一组（合并只影响打分与选择器的显示，不影响真实调用走哪个 id）。
对 OFM 是单向适配，不是合作，也不是官方关联。 本插件只读它写的四个 JSON：不改它、不向它提需求、也不向它的仓库提交适配改动；OFM 作者既未参与本插件的开发，也未为它背书。
渠道账本读的是 dsh-our-free-model 的私有文件格式。 那四个 JSON 是 OFM 的内部状态，没有版本承诺；文件缺失或结构变化时自动退化为「没有信号」，不会阻断路由。见与 dsh-our-free-model 的关系。
偏好模式的「全部渠道不可用」是全局判断。 一次请求的图片/窗口限制只会临时改选，不会暂停偏好。
注入的那一行不参与官方菜单的键盘导航。 官方 ↑/↓ 只在它自己的条目里走；这一行用 Tab 可达。官方若改了菜单结构，最坏情况是这一行不出现，不会影响官方选择器本身。
自动选择是全局开关，不是每会话一份。 它决定「选择器还算不算指令」，属于同一个人的使用习惯；会话级会是另一种产品（同一份会话列表里有的会话听调度、有的听选择器），所以没做。
官方 seat 标签是「接管」而不是「叠加」。 conversation.input.model.label 是 single 槽， DSH 随发行版带的 1017 发布标签（@deepseek-ai/dsh-client-ui-deepseek-model-label-1017）也占着它，本插件按框架自己的 shadow 规则用 priority: -1 取胜——代价是那个给 DeepSeek 官方 Flash 加「1017」徽标的装饰不再显示（只影响该徽标，选择器与模型列表本身不受影响）。隐藏推理档 chip 是 DOM 层的小手术，指向 seat 自己的标签行；官方若改了触发按钮结构，最坏情况是那枚 chip 不被隐藏，不会报错。
首轮接管只作用于 auto 模式的首个组装。 prefer 按偏好模型走，manual 按选择器走； off 不介入。关掉 routeFirstTurn 就回到「首轮先跑选择器里的模型」。新会话页的 chip 展示的是预计路由（那一刻还不知道这条消息要不要图片或长上下文），真正发出去的那条由 system-prompt/assemble 现场算。
切换会改变模型看到的上下文。 换 provider 时内核会丢掉适配器私有的 replay 信封（文本与工具历史保留），并追加一条持久提示告知模型发生过切换——这是内核设计好的行为。

开发

node tools/build-data.mjs [报告.md]   # 重新生成 src/priority-data.json
node tools/smoke.mjs                  # 123 项离线校验
node tools/integration.mjs            # 52 项接线校验
node tools/client-smoke.mjs           # 44 项浏览器半身渲染校验

tools/build-data.mjs 只写「实测事实」；策略（黑名单、车道提示、权重、冷却时长、effort 选择）在 src/policy-defaults.js，所以重新导入一份报告不会悄悄改变插件的行为。

许可

MIT

dsh-model-orchestrator

Instalar

README