cc-switch 自动故障转移机制详解Failover 队列、熔断器与健康监控的实现剖析【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本篇围绕 cc-switch 的代理故障转移Failover能力展开当主供应商Provider请求失败时系统如何按队列自动切换到备用供应商并通过熔断器避免对持续故障的供应商反复重试。结合 docs/user-manual/en/4-proxy/4.3-failover.md 的官方说明与 src-tauri/src/proxy/circuit_breaker.rs、src-tauri/src/proxy/failover_switch.rs 等源码读完本文你将掌握故障转移队列的配置方法、熔断器各参数的取值与默认值、状态机原理以及常见问题排查路径。一、故障转移解决什么问题故障转移功能会在主供应商请求失败时自动切换到备用供应商从而保证服务的连续性。典型适用场景包括供应商服务质量不稳定偶发超时、限流对高可用性有要求的工作流长时间运行的任务如长会话编码任务中途断流代价高。前置条件使用故障转移功能需要同时满足四个条件这也是排查为什么没触发切换的第一检查清单代理服务已启动Proxy 总开关开启对应应用的接管App Takeover已启用已配置故障转移队列至少一个供应商在队列中已开启自动故障转移Auto Failover开关。从源码可以印证这些约束是硬性校验src-tauri/src/commands/failover.rs 中set_auto_failover_enabled命令在打开开关前会先校验config.enabled代理接管是否启用若未启用接管会直接返回错误需要先启用该应用的代理接管再开启故障转移require_failover_app还会拒绝不支持本地代理数据平面的应用类型。二、配置故障转移队列打开配置页进入 设置 高级 故障转移Settings Advanced Failover。该页面对应前端的 src/components/proxy/AutoFailoverConfigPanel.tsx 与 src/components/proxy/FailoverQueueManager.tsx 等组件。页面顶部有三个应用标签页ClaudeCodexGemini选择一个应用后即可为该应用单独维护队列与参数——每个应用的队列、熔断参数彼此独立。添加备用供应商在Failover Queue故障转移队列区域点击Add Provider添加供应商从下拉列表中选择一个供应商供应商被追加到队列末尾。下拉列表背后的命令是 src-tauri/src/commands/failover.rs 中的get_available_providers_for_failover它返回不在队列中且支持故障转移的供应商。这里有一个值得注意的实现细节Codex 的官方账号卡Codex Official 账号被显式排除——require_failover_provider会检查provider_supports_failover不支持的供应商会被拒绝加入队列返回Codex Official 账号卡不支持自动故障转移。相关断言可由同文件内的测试failover_rejects_codex_official_account_cards验证。调整优先级队列项支持拖拽排序序号越小优先级越高P1 为首选P2、P3 依次后备主供应商失败后系统按队列顺序逐个尝试。队列的存储依据是 providers 表的in_failover_queue字段见 src-tauri/src/commands/failover.rs 文件头部注释即每个供应商带一个是否在队列中的标记配合排序值表达优先级。移除供应商点击供应商右侧的Remove移除按钮即可将其移出队列。关闭自动故障转移开关时不会清空队列队列内容会保留到下次开启时继续使用源码注释明确说明了这一行为。三、主界面快捷操作当代理和故障转移均处于启用状态时供应商卡片上会显示一个故障转移开关允许不进入配置页直接操作加入队列找到目标供应商卡片打开卡片上的故障转移开关供应商自动被追加到队列末尾。移出队列关闭该供应商卡片上的故障转移开关供应商即从队列中移除。四、开启自动故障转移及其背后的切换逻辑操作方式在故障转移配置页打开Auto Failover自动故障转移开关。两种状态的行为差异状态行为关仅记录失败不自动切换开请求失败时自动切换到下一个供应商源码视角开启开关并不只是写一个布尔值阅读 src-tauri/src/commands/failover.rs 的set_auto_failover_enabled可以发现开启动作包含一串顺序保障逻辑这解释了为什么文档要求先配队列再开开关空队列自愈如果队列为空系统会把当前供应商自动加入队列作为 P1避免用户陷入必须先加队列才能开启的死锁若连当前供应商都不存在则报错故障转移队列为空且未设置当前供应商无法开启故障转移。先切 P1再落盘开关开启前先调用switch_proxy_target把代理目标切换到队列首项P1只有切换成功后才把auto_failover_enabled写入数据库避免留下开关已开但目标未切的脏状态。若切换失败自动补加的 P1 会被回滚移除。事件广播成功后向前端发射provider-switched事件source: failoverEnabled并刷新托盘菜单UI 的当前供应商指示随之更新。而真正的故障后切换由 src-tauri/src/proxy/failover_switch.rs 中的FailoverSwitchManager负责去重控制以app_type:provider_id为 key 维护pending_switches集合同一切换进行中时后续触发直接跳过防止并发请求重复切换接管校验切换前再次检查该应用的代理是否处于接管状态enabledtrue未被接管的应用不执行切换热切换 UI 同步通过hot_switch_provider热更新代理目标随后重建托盘菜单并向前端发射provider-switched事件source: failover使主界面卡片实时反映当前生效的供应商。五、故障转移流程官方文档给出的整体流程如下这条链路把单请求重试和供应商级切换两个层次区分开同一供应商内的重试受 Max Retries 约束重试耗尽或熔断器判定该供应商不可用后才沿队列向后切换切换成功后新请求直接发往队列中更靠后的健康供应商。六、熔断器参数、默认值与状态机熔断器Circuit Breaker的目的是避免对持续故障的供应商频繁重试防止无效请求堆积。其实现位于 src-tauri/src/proxy/circuit_breaker.rs。参数配置表不同应用拥有相互独立的默认配置。通用默认值与 Claude 专属默认值如下Claude 因请求耗时更长采用更宽松的配置容忍更多失败参数说明通用默认Claude 默认取值范围Failure Threshold失败阈值连续失败多少次触发熔断481-20Recovery Success Threshold恢复成功阈值半开状态下需要多少次成功才关闭熔断231-10Recovery Wait Time恢复等待时间秒熔断后多久尝试恢复60900-300Error Rate Threshold错误率阈值错误率超过该值时打开熔断60%70%0-100%Minimum Requests最小请求数计算错误率前的最小请求数10155-100这些默认值与源码完全对应src-tauri/src/database/dao/proxy.rs 中ensure_proxy_config_row_exists按应用区分 seed 值——claude (6, 90, 180, 8, 3, 90, 0.7, 15)、codex (3, 60, 120, 4, 2, 60, 0.6, 10)通用结构的默认值4/2/60/0.6/10也定义在 src-tauri/src/proxy/circuit_breaker.rs 的CircuitBreakerConfig::default()中。所有字段统一保存在 src-tauri/src/proxy/types.rs 的AppProxyConfig结构体中circuit_failure_threshold、circuit_success_threshold、circuit_timeout_seconds、circuit_error_rate_threshold、circuit_min_requests持久化在数据库proxy_config表并支持热更新update_config只替换配置、不重置状态。超时参数参数说明通用默认Claude 默认取值范围Stream First Byte Timeout流式首字节超时等待首个数据块的最大时间秒60901-120Stream Idle Timeout流式静默超时数据块之间的最大间隔秒12018060-6000 表示禁用Non-stream Timeout非流式总超时非流式请求的总超时秒60060060-1200取值范围与默认值在 src-tauri/src/proxy/types.rs 的ProxyConfig字段注释中有明确记载例如流式首字节超时范围 1-120 秒默认 60 秒、非流式总超时范围 60-1200 秒默认 600 秒。重试参数参数说明通用默认Claude 默认取值范围Max Retries最大重试次数请求失败时的重试次数360-10注意 Gemini 的默认最大重试次数为 5——src-tauri/src/database/dao/proxy.rs 中 seed 值为gemini (5, 60, 120, 4, 2, 60, 0.6, 10)。熔断器三状态状态说明Closed关闭正常状态放行请求Open打开熔断生效跳过该供应商Half-Open半开尝试恢复仅放行有限的探测请求状态机如下对照 src-tauri/src/proxy/circuit_breaker.rs 源码有几个值得展开的实现细节双重触发条件record_failure中Closed 状态先检查连续失败次数 failure_threshold未达到时再检查错误率——仅当总请求数达到min_requests后failed/total error_rate_threshold同样会打开熔断器。这意味着偶发但密集的失败也会触发熔断而非只有严格连续失败才有效。半开状态严格限流allow_half_open_probe中max_half_open_requests 1即半开状态同一时刻只允许 1 个探测请求占用名额used_half_open_permit超出即拒绝请求结束无论成功失败都要通过record_success/record_failure归还名额。文件内测试test_half_open_transition_does_not_reset_inflight_permit专门验证了并发场景下探测名额不会被重复转换重置。探测失败立即回熔HalfOpen 状态下任何一次record_failure都会立刻切回 Open 并重新计时等待窗口transition_to_open会重置last_opened_at。配置热更新update_config允许运行时替换阈值而不重置计数状态界面上修改参数即时生效。以上状态迁移均有单元测试覆盖如test_circuit_breaker_closed_to_open连续失败达阈值后allow_request返回拒绝、test_circuit_breaker_half_open_to_closed半开连续成功达阈值后恢复 Closed以及test_circuit_breaker_reset手动重置回到 Closed。七、健康状态指示供应商卡片徽章供应商卡片显示健康状态徽章徽章状态说明绿色健康连续失败数为 0黄色警告存在失败但熔断未触发红色已熔断熔断器已打开暂时跳过该供应商队列列表中同样会展示每个供应商的健康状态便于在切换前一眼确认后备供应商是否可用。健康数据结构见 src-tauri/src/proxy/types.rs 的ProviderHealth包含consecutive_failures、last_success_at、last_failure_at、last_error等字段是前端徽章颜色的数据来源。八、故障转移日志每一次故障转移事件都会记录以下信息信息说明时间发生时间原始供应商失败的供应商新供应商切换到的供应商失败原因错误信息这些记录可在用量统计Usage Statistics中的请求日志里查看。后端日志方面FailoverSwitchManager在切换成功时会输出形如[FO-001] 切换: {app_type} → {provider_name}的信息级日志熔断器自身的状态迁移也有独立的日志编码如触发熔断、Open→HalfOpen、半开探测失败等便于在调试级别下还原完整决策过程。九、最佳实践队列配置建议主供应商P1选择最稳定、速度最快的供应商第一备份P2次优选择第二备份P3最后的兜底选项。熔断参数调优建议场景失败阈值恢复等待高可用性要求230 秒一般场景360 秒可容忍偶发失败5120 秒注意这些值都落在参数允许范围内阈值 1-20、等待 0-300 秒。调参时要结合上文双重触发条件来理解如果供应商错误率长期偏高即使把失败阈值调大错误率熔断仍会介入此时应优先考虑更换供应商而非继续放大阈值。监控建议定期关注各供应商的健康状态卡片徽章 / 队列列表故障转移发生频率用量统计中的请求日志熔断器触发频率日志中[FO-001]切换记录与熔断触发日志。十、常见问题FAQ故障转移不触发逐项检查代理服务是否在运行应用接管是否已启用自动故障转移是否已开启队列中是否有备用供应商。补充两个容易被忽略的点若开启了开关但队列为空且无当前供应商set_auto_failover_enabled会直接报错若 Codex 队首是官方账号卡这类不支持故障转移的供应商系统会在读取队列时将其过滤掉实际可用队列可能比显示时更短。故障转移过于频繁可能原因主供应商不稳定网络问题配置错误如把弱供应商排在了 P1。处理建议检查主供应商自身状态调整熔断器参数提高失败阈值或恢复等待时间减少抖动;考虑更换主供应商。所有供应商都被熔断熔断器在恢复等待时间到期后会自动进入 Half-Open 探测并尝试恢复Claude 默认 90 秒无需任何操作。若急需恢复可以手动重启代理服务重置熔断器状态。从源码结构看熔断器提供了reset()手动重置接口状态直接回到 Closed 并清空所有计数这是重置熔断器状态操作背后的底层能力。十一、小结cc-switch 的故障转移是一个队列 重试 熔断三层组合队列定义切换顺序P1/P2/P3重试在单供应商内兜底熔断器负责在供应商持续异常时快速止损并自动试探恢复。全部参数按应用独立存储在proxy_config表并通过 AppProxyConfig 结构体驱动Claude 采用更宽松阈值 8/3/90 秒、错误率 70%、重试 6 次、Gemini 重试 5 次、Codex 等采用通用默认4/2/60 秒、60%、重试 3 次。按照本文的队列配置建议与熔断调优表完成配置后配合用量统计中的请求日志即可在日常使用中持续验证并微调这套高可用链路。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 cc-switch 自动故障转移机制详解：Failover 队列、熔断器与健康监控的实现剖析
cc-switch 自动故障转移机制详解Failover 队列、熔断器与健康监控的实现剖析【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本篇围绕 cc-switch 的代理故障转移Failover能力展开当主供应商Provider请求失败时系统如何按队列自动切换到备用供应商并通过熔断器避免对持续故障的供应商反复重试。结合 docs/user-manual/en/4-proxy/4.3-failover.md 的官方说明与 src-tauri/src/proxy/circuit_breaker.rs、src-tauri/src/proxy/failover_switch.rs 等源码读完本文你将掌握故障转移队列的配置方法、熔断器各参数的取值与默认值、状态机原理以及常见问题排查路径。一、故障转移解决什么问题故障转移功能会在主供应商请求失败时自动切换到备用供应商从而保证服务的连续性。典型适用场景包括供应商服务质量不稳定偶发超时、限流对高可用性有要求的工作流长时间运行的任务如长会话编码任务中途断流代价高。前置条件使用故障转移功能需要同时满足四个条件这也是排查为什么没触发切换的第一检查清单代理服务已启动Proxy 总开关开启对应应用的接管App Takeover已启用已配置故障转移队列至少一个供应商在队列中已开启自动故障转移Auto Failover开关。从源码可以印证这些约束是硬性校验src-tauri/src/commands/failover.rs 中set_auto_failover_enabled命令在打开开关前会先校验config.enabled代理接管是否启用若未启用接管会直接返回错误需要先启用该应用的代理接管再开启故障转移require_failover_app还会拒绝不支持本地代理数据平面的应用类型。二、配置故障转移队列打开配置页进入 设置 高级 故障转移Settings Advanced Failover。该页面对应前端的 src/components/proxy/AutoFailoverConfigPanel.tsx 与 src/components/proxy/FailoverQueueManager.tsx 等组件。页面顶部有三个应用标签页ClaudeCodexGemini选择一个应用后即可为该应用单独维护队列与参数——每个应用的队列、熔断参数彼此独立。添加备用供应商在Failover Queue故障转移队列区域点击Add Provider添加供应商从下拉列表中选择一个供应商供应商被追加到队列末尾。下拉列表背后的命令是 src-tauri/src/commands/failover.rs 中的get_available_providers_for_failover它返回不在队列中且支持故障转移的供应商。这里有一个值得注意的实现细节Codex 的官方账号卡Codex Official 账号被显式排除——require_failover_provider会检查provider_supports_failover不支持的供应商会被拒绝加入队列返回Codex Official 账号卡不支持自动故障转移。相关断言可由同文件内的测试failover_rejects_codex_official_account_cards验证。调整优先级队列项支持拖拽排序序号越小优先级越高P1 为首选P2、P3 依次后备主供应商失败后系统按队列顺序逐个尝试。队列的存储依据是 providers 表的in_failover_queue字段见 src-tauri/src/commands/failover.rs 文件头部注释即每个供应商带一个是否在队列中的标记配合排序值表达优先级。移除供应商点击供应商右侧的Remove移除按钮即可将其移出队列。关闭自动故障转移开关时不会清空队列队列内容会保留到下次开启时继续使用源码注释明确说明了这一行为。三、主界面快捷操作当代理和故障转移均处于启用状态时供应商卡片上会显示一个故障转移开关允许不进入配置页直接操作加入队列找到目标供应商卡片打开卡片上的故障转移开关供应商自动被追加到队列末尾。移出队列关闭该供应商卡片上的故障转移开关供应商即从队列中移除。四、开启自动故障转移及其背后的切换逻辑操作方式在故障转移配置页打开Auto Failover自动故障转移开关。两种状态的行为差异状态行为关仅记录失败不自动切换开请求失败时自动切换到下一个供应商源码视角开启开关并不只是写一个布尔值阅读 src-tauri/src/commands/failover.rs 的set_auto_failover_enabled可以发现开启动作包含一串顺序保障逻辑这解释了为什么文档要求先配队列再开开关空队列自愈如果队列为空系统会把当前供应商自动加入队列作为 P1避免用户陷入必须先加队列才能开启的死锁若连当前供应商都不存在则报错故障转移队列为空且未设置当前供应商无法开启故障转移。先切 P1再落盘开关开启前先调用switch_proxy_target把代理目标切换到队列首项P1只有切换成功后才把auto_failover_enabled写入数据库避免留下开关已开但目标未切的脏状态。若切换失败自动补加的 P1 会被回滚移除。事件广播成功后向前端发射provider-switched事件source: failoverEnabled并刷新托盘菜单UI 的当前供应商指示随之更新。而真正的故障后切换由 src-tauri/src/proxy/failover_switch.rs 中的FailoverSwitchManager负责去重控制以app_type:provider_id为 key 维护pending_switches集合同一切换进行中时后续触发直接跳过防止并发请求重复切换接管校验切换前再次检查该应用的代理是否处于接管状态enabledtrue未被接管的应用不执行切换热切换 UI 同步通过hot_switch_provider热更新代理目标随后重建托盘菜单并向前端发射provider-switched事件source: failover使主界面卡片实时反映当前生效的供应商。五、故障转移流程官方文档给出的整体流程如下这条链路把单请求重试和供应商级切换两个层次区分开同一供应商内的重试受 Max Retries 约束重试耗尽或熔断器判定该供应商不可用后才沿队列向后切换切换成功后新请求直接发往队列中更靠后的健康供应商。六、熔断器参数、默认值与状态机熔断器Circuit Breaker的目的是避免对持续故障的供应商频繁重试防止无效请求堆积。其实现位于 src-tauri/src/proxy/circuit_breaker.rs。参数配置表不同应用拥有相互独立的默认配置。通用默认值与 Claude 专属默认值如下Claude 因请求耗时更长采用更宽松的配置容忍更多失败参数说明通用默认Claude 默认取值范围Failure Threshold失败阈值连续失败多少次触发熔断481-20Recovery Success Threshold恢复成功阈值半开状态下需要多少次成功才关闭熔断231-10Recovery Wait Time恢复等待时间秒熔断后多久尝试恢复60900-300Error Rate Threshold错误率阈值错误率超过该值时打开熔断60%70%0-100%Minimum Requests最小请求数计算错误率前的最小请求数10155-100这些默认值与源码完全对应src-tauri/src/database/dao/proxy.rs 中ensure_proxy_config_row_exists按应用区分 seed 值——claude (6, 90, 180, 8, 3, 90, 0.7, 15)、codex (3, 60, 120, 4, 2, 60, 0.6, 10)通用结构的默认值4/2/60/0.6/10也定义在 src-tauri/src/proxy/circuit_breaker.rs 的CircuitBreakerConfig::default()中。所有字段统一保存在 src-tauri/src/proxy/types.rs 的AppProxyConfig结构体中circuit_failure_threshold、circuit_success_threshold、circuit_timeout_seconds、circuit_error_rate_threshold、circuit_min_requests持久化在数据库proxy_config表并支持热更新update_config只替换配置、不重置状态。超时参数参数说明通用默认Claude 默认取值范围Stream First Byte Timeout流式首字节超时等待首个数据块的最大时间秒60901-120Stream Idle Timeout流式静默超时数据块之间的最大间隔秒12018060-6000 表示禁用Non-stream Timeout非流式总超时非流式请求的总超时秒60060060-1200取值范围与默认值在 src-tauri/src/proxy/types.rs 的ProxyConfig字段注释中有明确记载例如流式首字节超时范围 1-120 秒默认 60 秒、非流式总超时范围 60-1200 秒默认 600 秒。重试参数参数说明通用默认Claude 默认取值范围Max Retries最大重试次数请求失败时的重试次数360-10注意 Gemini 的默认最大重试次数为 5——src-tauri/src/database/dao/proxy.rs 中 seed 值为gemini (5, 60, 120, 4, 2, 60, 0.6, 10)。熔断器三状态状态说明Closed关闭正常状态放行请求Open打开熔断生效跳过该供应商Half-Open半开尝试恢复仅放行有限的探测请求状态机如下对照 src-tauri/src/proxy/circuit_breaker.rs 源码有几个值得展开的实现细节双重触发条件record_failure中Closed 状态先检查连续失败次数 failure_threshold未达到时再检查错误率——仅当总请求数达到min_requests后failed/total error_rate_threshold同样会打开熔断器。这意味着偶发但密集的失败也会触发熔断而非只有严格连续失败才有效。半开状态严格限流allow_half_open_probe中max_half_open_requests 1即半开状态同一时刻只允许 1 个探测请求占用名额used_half_open_permit超出即拒绝请求结束无论成功失败都要通过record_success/record_failure归还名额。文件内测试test_half_open_transition_does_not_reset_inflight_permit专门验证了并发场景下探测名额不会被重复转换重置。探测失败立即回熔HalfOpen 状态下任何一次record_failure都会立刻切回 Open 并重新计时等待窗口transition_to_open会重置last_opened_at。配置热更新update_config允许运行时替换阈值而不重置计数状态界面上修改参数即时生效。以上状态迁移均有单元测试覆盖如test_circuit_breaker_closed_to_open连续失败达阈值后allow_request返回拒绝、test_circuit_breaker_half_open_to_closed半开连续成功达阈值后恢复 Closed以及test_circuit_breaker_reset手动重置回到 Closed。七、健康状态指示供应商卡片徽章供应商卡片显示健康状态徽章徽章状态说明绿色健康连续失败数为 0黄色警告存在失败但熔断未触发红色已熔断熔断器已打开暂时跳过该供应商队列列表中同样会展示每个供应商的健康状态便于在切换前一眼确认后备供应商是否可用。健康数据结构见 src-tauri/src/proxy/types.rs 的ProviderHealth包含consecutive_failures、last_success_at、last_failure_at、last_error等字段是前端徽章颜色的数据来源。八、故障转移日志每一次故障转移事件都会记录以下信息信息说明时间发生时间原始供应商失败的供应商新供应商切换到的供应商失败原因错误信息这些记录可在用量统计Usage Statistics中的请求日志里查看。后端日志方面FailoverSwitchManager在切换成功时会输出形如[FO-001] 切换: {app_type} → {provider_name}的信息级日志熔断器自身的状态迁移也有独立的日志编码如触发熔断、Open→HalfOpen、半开探测失败等便于在调试级别下还原完整决策过程。九、最佳实践队列配置建议主供应商P1选择最稳定、速度最快的供应商第一备份P2次优选择第二备份P3最后的兜底选项。熔断参数调优建议场景失败阈值恢复等待高可用性要求230 秒一般场景360 秒可容忍偶发失败5120 秒注意这些值都落在参数允许范围内阈值 1-20、等待 0-300 秒。调参时要结合上文双重触发条件来理解如果供应商错误率长期偏高即使把失败阈值调大错误率熔断仍会介入此时应优先考虑更换供应商而非继续放大阈值。监控建议定期关注各供应商的健康状态卡片徽章 / 队列列表故障转移发生频率用量统计中的请求日志熔断器触发频率日志中[FO-001]切换记录与熔断触发日志。十、常见问题FAQ故障转移不触发逐项检查代理服务是否在运行应用接管是否已启用自动故障转移是否已开启队列中是否有备用供应商。补充两个容易被忽略的点若开启了开关但队列为空且无当前供应商set_auto_failover_enabled会直接报错若 Codex 队首是官方账号卡这类不支持故障转移的供应商系统会在读取队列时将其过滤掉实际可用队列可能比显示时更短。故障转移过于频繁可能原因主供应商不稳定网络问题配置错误如把弱供应商排在了 P1。处理建议检查主供应商自身状态调整熔断器参数提高失败阈值或恢复等待时间减少抖动;考虑更换主供应商。所有供应商都被熔断熔断器在恢复等待时间到期后会自动进入 Half-Open 探测并尝试恢复Claude 默认 90 秒无需任何操作。若急需恢复可以手动重启代理服务重置熔断器状态。从源码结构看熔断器提供了reset()手动重置接口状态直接回到 Closed 并清空所有计数这是重置熔断器状态操作背后的底层能力。十一、小结cc-switch 的故障转移是一个队列 重试 熔断三层组合队列定义切换顺序P1/P2/P3重试在单供应商内兜底熔断器负责在供应商持续异常时快速止损并自动试探恢复。全部参数按应用独立存储在proxy_config表并通过 AppProxyConfig 结构体驱动Claude 采用更宽松阈值 8/3/90 秒、错误率 70%、重试 6 次、Gemini 重试 5 次、Codex 等采用通用默认4/2/60 秒、60%、重试 3 次。按照本文的队列配置建议与熔断调优表完成配置后配合用量统计中的请求日志即可在日常使用中持续验证并微调这套高可用链路。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考