dsh-auto-continue
43aquarius/dsh-auto-continue
Resumes a session interrupted by a model failure by switching to the next healthy entry of a user-configured model chain, then continues the task automatically. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
설치
dsh plugin --profile web add github:43aquarius/dsh-auto-continueREADME
dsh-auto-continue — 自动续接与模型切换
English | 中文
一个 DeepSeek Harness 插件:当任意会话的模型请求因用量不足、限流、额度重置、凭证错误、上下文超限等原因中断时,自动探测一个可用的备选模型、持久切换会话,并自动补发续接消息——无需人工干预。
它解决什么问题
免费模型经常在任务中途失效(用量耗尽、每分钟限流、整点重置)。没有这个插件时,你得手动换模型、再手动发一句「继续」;有了它,这套动作全自动完成。
工作原理
插件挂在 agent loop 的 agent/request-error 瀑布上,与内置的 dsh-llm-retry 分工协作:
- 短退避重试(瞬时抖动)由内置
dsh-llm-retry处理;重试耗尽或错误不可重试时,才轮到本插件。 - 枚举候选:显式
fallbackChain(provider/model列表)优先,其后按注册顺序枚举全部已注册 provider × model。 - 探测可用性:切换前对每个候选发一个极小的真实请求(默认 16 token、20 秒超时),只有探测通过的候选才会被选中;刚失败过的路由进入冷却表(配额 30 分钟 / 限流 5 分钟 / 凭证 6 小时),不会被立刻重复选中。
- 持久切换:
agent.model.select()写入model/selection会话事件——与 Web UI 手动切换完全同一机制,下一步自动出现[model changed: ...]通知。 - 自动续接:以 hook 原因中止死回合(保留已排队的输入),向 next-turn 收件箱补发一条「继续」;循环的唤醒闩锁自动开新回合,在新模型上原地续跑任务。
- 防失控:单回合最多切换 3 次(可配);上下文超限(
CONTEXT_WINDOW_EXCEEDED)会优先挑上下文窗口更大的模型;全死时不切,如实上报错误。 - 兜底续接(v1.1.0):任何回合以错误收尾后——包括驱动级异常、重试耗尽仍无可用候选等「不明原因」中断——一旦会话空闲即自动重新探活并续接(受
maxIdleResumes上限约束);正常结束或用户手动停止则绝不打扰。 - 大窗口优先(v1.2.0):切换目标优先选择上下文窗口不小于当前模型的路由。DSH 在切换模型时若需压缩历史,会用原路由模型生成摘要——原模型正在限流就会抛
MODEL_SWITCH_COMPACTION_FAILED导致切换失败。选大窗口目标可彻底避开这条死路。MODEL_SWITCH_COMPACTION_FAILED也改按短冷却处理,不会把目标模型拉黑 30 分钟。
设置面板(v1.3.0)
插件在 Web UI 的「插件 → 已安装 → 自动续接与模型切换」详情页(或该插件组件行的「配置」按钮)提供可视化配置表单,无需手工编辑 YAML。
全部为下拉选项,不要求填数字或写 YAML:20 个设置项(总开关、续接文本、优先切换模型链、忽略错误码、探测开关与次数、各类冷却时长、大窗口偏好等)每个都给出 2–5 个精选档位,其中「★推荐」档默认选中且已预先填入,打开即可直接点保存。
- 优先切换模型链:可选「自动枚举全部可用模型(推荐)/优先 DeepSeek 官方/优先免费大窗口/自定义…」;选「自定义」展开文本框按
provider/model一行一个填写。 - 忽略的错误码:默认档 / 仅忽略用户中止 / 不忽略 / 自定义。
- 冷却与超时:全部以「10 分钟 / 30 分钟(推荐)/ 1 小时」这类可读档位呈现,不再需要记毫秒数。
- 三个操作按钮:保存(带 revision 乐观锁,外部并发修改会被拒绝而非静默覆盖)、撤销改动、恢复推荐设置。
- 只有点「保存」才写入;离开页面丢弃暂存编辑。
安装
- dsh-market:市场内搜索
auto-continue或自动续接→ 安装 → 重启 DSH。 - 手动(GitHub 源):在插件管理中安装
github:43aquarius/dsh-auto-continue。
配置
| 配置项 | 默认值 | 说明 |
|---|---|---|
enabled | true | 总开关 |
continuationText | 继续 | 切换后自动补发的续接消息文本 |
fallbackChain | [] | 优先尝试的备选模型(provider/model),按顺序优先;留空则自动枚举 |
ignoreCodes | ["ABORTED", "IMAGE_OFFLOAD_REQUIRED"] | 这些错误码不触发切换 |
maxSwitchesPerTurn | 3 | 单回合最多切换次数 |
probe | true | 切换前发极小真实请求验证候选可用 |
probeTimeoutMs | 20000 | 单个探测超时(毫秒) |
probeMaxTokens | 16 | 探测请求最大输出 token |
maxProbeCandidates | 6 | 单次故障最多探测的候选数 |
switchAfterMs | 120000 | 限流等待超过该毫秒数时不再等待、直接切换 |
cooldownQuotaMs | 1800000 | 配额耗尽路由的冷却时间 |
cooldownRateLimitMs | 300000 | 限流路由的冷却时间 |
cooldownAuthMs | 21600000 | 凭证错误路由的冷却时间 |
cooldownTransientMs | 120000 | 其他临时错误路由的冷却时间 |
healthyTtlMs | 600000 | 探测成功结果的缓存时长 |
resumeOnErrorIdle | true | 回合错误收尾且无排定续接时,空闲后自动兜底续接 |
maxIdleResumes | 3 | 每个会话在每个宿主生命周期内兜底续接的最大次数 |
cooldownModelFaultMs | 1800000 | 模型级持续故障(PI_AI_ERROR 等)的冷却时间 |
preferLargeContext | true | 切换目标优先选上下文窗口不小于当前模型的路由,避免触发历史压缩 |
minContextWindow | 0 | 候选模型的最小上下文窗口(token,0=不限制) |
验证
- 确定性单元测试(
test/switch.test.mjs,9 个场景)覆盖完整切换链路、空闲兜底续接、正常收尾取消挂起、驱动错误续接、LLM 错误码不被误判为驱动错误(2026-11-13 事故回归)、大窗口候选优先。 - 真实 429 限流风暴取证:2026-11-13 现场日志还原出「错误码误标 + 目标窗口过小触发压缩失败 + scoped 事件未全局监听」三重问题,已在 v1.2.0 全部修复。
English
A DeepSeek Harness plugin that automatically recovers interrupted sessions: when a model request fails (quota exhausted, rate limit, reset windows, credential errors, context overflow), it probes the registered model catalog for a healthy fallback, durably switches the session via the same model/selection mechanism as the UI, and queues a continuation message so the task resumes on the new model — no manual intervention.
Short same-model backoff retries remain the job of the bundled dsh-llm-retry plugin; this plugin takes over once retries are exhausted or the failure is terminal. Since v1.1.0 it also covers driver-level failures and exhausted-fallback errors once the agent goes idle (bounded by maxIdleResumes). Since v1.2.0 it prefers destinations with a context window at least as large as the current model — DSH compaction during a switch summarizes with the previous model, so switching to a smaller window while the old model is rate-limited fails with MODEL_SWITCH_COMPACTION_FAILED. It also ships a visual settings panel on the plugin's details page. Switch records are committed via session.appendPluginRecord() with the plugin: envelope grammar so they never poison the session log. See the configuration table above (defaults are sane; everything is tunable).
License
MIT