本帖使用社区开源推广,符合推广要求。我申明并遵循社区要求的以下内容:
- 我的帖子已经打上 开源推广 标签: 是
- 我的开源项目完整开源,无未开源部分: 是
- 我的开源项目已链接认可 LINUX DO 社区: 是
- 我帖子内的项目介绍,AI生成、润色内容部分已截图发出: 是
- 以上选择我承诺是永久有效的,接受社区和佬友监督: 是
以下为项目介绍正文内容,AI生成、润色内容已使用截图方式发出
最近在搞一个开源项目。作为穷哥们,用 ccswitch 配的 API 基本都是各种低价低倍率渠道,这些渠道问题特别多,所以就顺手做了这款 ccswitch 配套软件。想着睡一觉醒来,项目就能自己跑完了。
它不替代 CC Switch,也不接管你的工作方式。它只在本地守着中转线路和 Codex 对话:模型满载时逐档降低推理强度,API 恢复时回到原 thread;同时运行多个项目时,前两个并发续接,其余安全排队。
当你不在电脑前 |
它会怎么做 |
|---|
所有 API 熔断 |
记录受影响的原对话,安静等待,不制造重复任务 |
两小时后有线路恢复 |
发现成功请求,经过 20 秒恢复保护后提前唤醒重试 |
同时跑多个项目 |
默认并发续接 2 个,其余进入持久队列,逐批继续 |
模型档位满载 |
按“极高 → 高 → 中 → 低”降档,可用后再回到原档位 |
你已经手动点了继续 |
识别为“你手动接回”,不会冒充软件自动成功 |
它安静地守在本机,等线路恢复,再把未完成的对话接回原处。

为什么需要它
低倍率中转 API 常通过 CC Switch 组成故障转移队列,但长时间无人值守任务仍可能因为以下情况停止:
- CC Switch 渠道熔断后,Codex 对话不会自行继续;
Selected model is at capacity、429、502、503、504 或连接超时导致任务中断;
- 某条线路余额不足、分组失效或网关返回 OpenResty HTML 400;
- Codex 被切回直连配置,绕开了 CC Switch 的候补队列;
- 运行一整夜时,用户无法及时点击“继续”。
Codex Circuit Resumer 将这些情况收敛成一个轻量的本地后台守望器和一个可点击的 SwiftUI 桌面界面。
核心能力
自动恢复原对话
- 监听 CC Switch 熔断器
Open -> Closed,线路稳定后调用 codex exec resume;
- 扫描 Codex rollout 中的模型满载、限流、503、超时和余额不足等可重试错误;
- 使用指数退避、随机错峰和上游
Retry-After,避免反复冲击低速渠道;
- 成功、人工继续或出现登录/审批等不可自动处理问题时及时收队;
- 严格区分“自动续接已发起”“自动续接已成功”和“你手动接回”,不再把手动点击算成软件成功;
- CC Switch 恢复成功请求后提前唤醒长退避任务,同时继续遵守上游明确给出的
Retry-After;
- 保留原 thread,不新建重复对话。
模型满载自动降档与恢复
- 推理强度可按
xhigh -> high -> medium -> low 逐档降低;
- 默认最低停在
low,不会无限降低;
- 降档后保留原始推理强度,每 15 分钟进入一次安全回升窗口;
- 自动续接使用单次 CLI 覆盖;对话空闲后再通过 Codex 官方对话设置接口同步回原档位,不修改全局设置;
- 原档位按每个对话首次发生满载前的实际选择保存:极高按“极高 → 高 → 中 → 低”降级并恢复极高,高档则恢复高档;
- 已经运行中的单次请求不会被强制终止,恢复后的档位从下一次请求生效。
CC Switch 渠道体检
- 分别监控 Codex 与 Claude Desktop,不监控 Claude Code;
- 严格保持 CC Switch 中的原始渠道排列顺序;
- 显示当前线路、候补线路、降级、熔断、余额不足、鉴权失败和分组失效原因;
- 同时展示 CC Switch 备注倍率与可验证的网站真实倍率;
- 支持 Sub2API billing 信息,并对可识别接口探测余额;
- API Key 仅在本机内存中用于查询,不写入界面或运行日志。
人民币费用对账
- 显示 CC Switch 当天标准成本、中转 API 折前价和已核实倍率部分的折后估算;
- 单独列出缺失倍率或已删除渠道导致的“暂时无法折算”金额;
- 美元金额统一换算成人民币,并标明汇率来源与更新时间;
- 金额每 30 秒从 CC Switch 本地日志重新汇总;
- 折后金额明确标记为估算,不冒充中转站账单。
项目地址: GitHub - loveramarois-byte/codex-circuit-resumer: 线路会熔断,工作不必。macOS / Windows 本地守望器:线路恢复后自动接回 Codex 原对话,并监控 CC Switch 渠道、倍率、余额与人民币费用。 · GitHub
最新版下载(macOS / Windows): Release v2.8.0 · macOS 与 Windows 同步版 · loveramarois-byte/codex-circuit-resumer · GitHub
欢迎试用、提 Issue,也欢迎佬友一起把它磨得更稳。