故障转移续跑 elanski/dsh-failover-continue

dsh-failover-continue

DeepSeek Harness (DSH) 的统一 自动继续 + 模型故障转移 插件。

一个插件掌管整个弹性循环，而不是将其拆分到自动继续插件和故障转移插件中：

- 有序回退链，具有两级熔断（模型 + 提供商）。
首次失败即打开该路由（阈值为 1）；下一个请求会离开已失效的路由。对于报告 Retry-After 的提供商（例如网关回复 “retry in 3594s”），会予以遵守，而不是在 60 秒后再次猛击。
- AUTH 和 BILLING 会切换路由，而不是终止会话。 401/403 或计费/签到 402 会打开失败的路由，该轮次会在下一个健康的回退上继续。只有当整条链都打开时才会触发止损。
- CONTEXT_WINDOW_EXCEEDED 是请求作用域的：超大请求会转移到上下文更大的候选项，而不会停用健康的路由。
- 自动继续失败的轮次：实时 firehose + 冷会话扫描（可在宿主重启后存活：孤立的轮次会唤醒并继续），自适应退避，循环防护。
- 安全阀：maxSwitchesPerStep 限制遍历循环；maxConsecutive 限制继续风暴。
- 从构造上保证会话日志安全：该插件从不写入自定义事件类型（Session.append API 无法携带 ignorable 信封标记）。切换通知以普通的 user/message 行发出；状态保存在状态路由和设置命名空间中。
- 双语 RU/EN 设置卡片：每个字符串都通过语言环境字典（该插件注册了一个 ru 语言包——DSH 仅自带 zh/en）。

安装

dsh plugin --profile web add link:/path/to/dsh-failover-continue
or: dsh plugin --profile web add github:/dsh-failover-continue

禁用它要替代的插件（每个 waterfall 恰好一个所有者），迁移设置，重启宿主：

node scripts/migrate-settings.mjs --apply

~/.dsh/profiles/web/cordis.patch.yml
- id: auto-continue
disabled: true
- id: model-failover
disabled: true
- id: model-failover-settings
disabled: true

配置

在 settings.yaml 中使用单一的 failover-continue: 命名空间，可从设置 → 插件 → Failover + auto-continue 完全编辑：有序的 fallbacks （提供商/模型）、tripCodes、阈值/冷却时间、继续文本/时机、退避、循环防护。完整的需求/设计/任务请参见 .kiro/specs/failover-continue/（设计仓库）。

验证

npm run typecheck && npm test && npm run build

许可证

MIT — 参见 LICENSE。捐赠代码和想法在 NOTICE.md 中注明出处。

Russian

DeepSeek Harness 的单一 自动继续 + 模型回退 插件。

一个插件掌管整个弹性循环，而不是“auto-continue + model-failover”组合：

- 有序回退链，具有两级熔断器（路由 + 提供商）。第一次失败会打开路由（阈值为 1）；下一个请求会从已失效的路由发出。提供商的 Retry-After （例如「retry in 3594s」）会被遵守，而不是被重试淹没。
- AUTH 和 BILLING 是切换，而不是埋葬。 401/403 或计费 402 会打开路由，轮次会在下一个存活备用上继续。只有当整条链都打开时才停止。
- CONTEXT_WINDOW_EXCEEDED 是请求作用域的：重请求会转到窗口更大的模型，而不会停用健康路由。
- 失败轮次的自动继续：实时事件流 + 冷会话扫描（可跨主机重启存活：「孤儿」会话会被唤醒并继续），自适应退避，循环守卫。
- 保险丝：maxSwitchesPerStep 切断沿链行走的循环， maxConsecutive — 继续风暴。
- 日志按构造即安全：我们完全不写自己的事件类型（Session.append 不支持 ignorable 标记）。通知 — 使用普通 user/message；状态 — 在状态路由和设置命名空间中。
- 双语卡片 RU/EN：所有字符串都通过字典（插件注册语言包 ru — DSH 开箱只有 zh/en）。

安装

dsh plugin --profile web add link:/path/to/dsh-failover-continue
或：dsh plugin --profile web add github:/dsh-failover-continue

禁用被替换的插件（waterfall 上恰好一个所有者），迁移设置，重启主机（见上文）。设置迁移：

node scripts/migrate-settings.mjs --apply

检查

npm run typecheck && npm test && npm run build

许可证

MIT — 见 LICENSE。代码和想法的贡献者 — 见 NOTICE.md。