dsh-model-fallback-queue
模型故障转移队列：P1 限额/限流/不可用时自动切到队列下一个模型继续，全部图形界面配置 | DeepSeek Harness 的模型故障转移队列：当前模型达到配额或速率限制时自动切换到下一个模型
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:HelloQingTao/dsh-model-fallback-queue#2796c7c0fc33ddcb3c0829d3cdc08f2742435799Model Fallback Queue 以 dsh-model-fallback-queue 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（dsh）插件：当前模型限额、限流或不可用时，自动切换到队列里的下一个模型，把会话接着跑完。 队列和开关都在设置页里点，不需要命令行。
dsh-model-fallback-queue会话用某个模型时，如果它 5 小时/周/月限额用尽（QUOTA / ACCOUNT_QUOTA）、被限流（RATE_LIMIT）或凭据失效（AUTH / INVALID_CREDENTIAL），请求直接失败，会话卡住，只能手动换模型再让会话继续。
本插件把「换模型」这件事自动化：请求失败 → 熔断当前路由 → 同一步用队列里下一个可用模型重试 → 成功后稳定留在新路由上。
next() 让路，同路由重试仍由核心的重试插件负责。dsh plugin --profile web add dsh-model-fallback-queue
装完重启 dsh（或刷新 Web GUI）即可，bundle 会随插件自带的 cordis.patch.yml 自动注册。
发生切换时，会话里会出现核心自带的「模型已切换」通知，芯片同步切到新路由。
| 显示 | 含义 |
|---|---|
P1 + 绿点 | 正常走 P1 |
P2（黄点） | 已切换到 P2；黄点表示半开探测中 |
P! + 红点 | 队列全部熔断，已降级放行原配置 |
P（灰点） | 插件未启用 |
面板行为：每行显示优先级、provider/model、健康徽章（🟢 正常 / 🟡 探测中 / 🔴 熔断，带连续失败数）；当前生效行有「当前」标记；底部是最近一次切换记录（P1 → P2（QUOTA））、「切回 P1」按钮（已切走时出现）和「设置…」入口。
| 档位 | 行为 |
|---|---|
| 粘滞（默认，推荐） | 切到 P2 后只要 P2 可用就一直用，P1 恢复了也不切回；P2 也挂时按「邻近可用」往后找，绕回 P1 是最后手段。零抖动，缓存最稳。 |
| 探测回切 | P1 冷却到期后，由下一个真实请求探测回 P1；成功留下，失败回 P2（防抖 5 分钟，不额外发探测流量）。 |
| 手动回切 | 切走后永不自动回 P1，用芯片面板里的「切回 P1」手动恢复。 |
| 字段 | 默认值 | 说明 | 设置页可改 |
|---|---|---|---|
enabled | false | 总开关 | ✅ |
queue | [] | 后备队列，数组顺序即优先级 | ✅ |
failbackMode | sticky | P1 恢复策略：sticky / probe / manual | ✅ |
p1Follow | true | P1 跟随当前会话模型 | — |
immediateCodes | QUOTA, ACCOUNT_QUOTA, RATE_LIMIT, AUTH, INVALID_CREDENTIAL, NO_ADAPTER | 命中即熔断的错误码 | — |
failureThreshold | 2 | 非即时码的连续失败阈值 | — |
cooldownMs | 60000 | 熔断冷却毫秒数 | — |
failbackDelayMs | 300000 | 探测回切防抖毫秒数 | — |
带 — 的高级旋钮当前通过
~/.dsh/profiles/<profile>/cordis.patch.yml里本插件那一行的config配置（默认值适用于绝大多数场景）。日常使用的开关、队列、恢复策略都在设置页。
宿主侧三个扩展点（全部 try/catch 兜底，任何异常都不拦截请求）：
agent/request（waterfall）：生效路由不是 P1 时，返回 {...cfg, provider, model} 覆盖本次请求；agent/request-error（prepend）：判定熔断码 → 熔断当前路由 → 返回 { kind: 'retry' } 让 agent-loop 换路由重试同一步；非致命码 next() 让路；agent/assistant-stream：end 帧即认为该路由走通，复位熔断计数。熔断器为三态（closed / half_open / open），纯内存，进程重启自动归零。运行态经 typert Remote 暴露 snapshot / probe / manualFailback 给 Web 客户端。
dsh-client-auto-continue 天然兼容：自动续发走的是同一条请求瀑布，一样享受队列切换。dsh-llm-retry 分层：它管同路由退避重试，本插件管跨路由切换，不互相抢。agent/request-error。git clone https://github.com/HelloQingTao/dsh-model-fallback-queue.git
cd dsh-model-fallback-queue
在 profile 里以 link: 方式引用本目录即可热改：
"dependencies": { "dsh-model-fallback-queue": "link:/path/to/dsh-model-fallback-queue" }
设计文档见 docs/design-plan.md。