Free Claude Code流恢复机制深度解析：0.75秒回退与5次尝试预算

Free Claude Code流恢复机制深度解析0.75秒回退与5次尝试预算【免费下载链接】free-claude-codeUse Claude Code, Codex, Pi, and OpenCode and more for free (1.3B free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported ToS friendly)项目地址: https://gitcode.com/GitHub_Trending/fr/free-claude-codeFree Claude Code免费使用 Claude Code、Codex、Pi、OpenCode 等 AI 编程助手的项目最容易被低估的能力不是免费而是它的流恢复机制当上游模型 API 在网络抖动中突然断流时它能在0.75 秒内悄悄回滚并重试配合每个逻辑请求的5 次尝试预算让你几乎看不到一次失败的流式对话。本文带你看懂这套机制背后的三个关键决策。为什么流式响应需要恢复而不是重试大模型 API 的响应是 SSEServer-Sent Events流式推送的。流中断有两种典型场景早期断流流刚打开、还没吐出可见内容时网络就断了——此时重试完全无感用户毫无察觉中途断流已经吐出一部分回答后才断开——此时已经承诺给用户的内容不能再凭空消失只能做中途恢复MIDSTREAM_RECOVERY把已显示的内容保留下来再续接。Free Claude Code 在 stream_recovery.py 中用一个统一的RecoveryController来判断当前该走哪条路。0.75 秒回退窗口看不见的缓冲带核心常量只有一行却决定了整个体验EARLY_HOLDBACK_SECONDS 0.75 # 回退等待窗口 RECOVERY_BUFFER_MAX_BYTES 65_536 # 缓冲上限 64KB工作机制见 RecoveryHoldbackBuffer流打开后前 0.75 秒内的所有 SSE 事件先扣留在本地缓冲区不发给客户端如果 0.75 秒内流正常持续缓冲区被提交committed内容照常流出如果 0.75 秒内流断了且还没提交这些内容被直接丢弃整条请求以全新状态重试——用户端表现为多等了半秒而不是看到一半消失了。这就是0.75 秒回退一个短暂的提交边界缓冲让早期断流可以无感重试。5 次尝试预算什么时候还能重试真正的预算定义在 admission.pyUPSTREAM_TRANSIENT_TOTAL_ATTEMPTS 5 # 每个逻辑操作最多 5 次物理尝试每个逻辑请求一次补全调用由一个ProviderExecution对象持有这 5 次预算attempts_remaining随每次尝试递减。当流失败时RecoveryController.advance_failure()按下表做三选一决策条件决策动作用户感知可重试 有剩余预算 流未提交EARLY_RETRY早期重试无感多等 0.75 秒可重试 已产生可见输出MIDSTREAM_RECOVERY中途恢复保留已显示内容并续接预算耗尽 / 不可重试错误FINAL_ERROR终态报错展示稳定错误信息一个巧妙细节当只剩最后 1 次预算、且已经产生可见输出时这次尝试会被预留给中途恢复reserve_last_attempt_for_recovery而不是浪费在无感重试上——保证最后一搏用于救回用户已经看到的内容。重试之间的等待退避与恢复战役重试不是立即进行的。admission.py 同时定义了退避参数DEFAULT_UPSTREAM_BASE_DELAY 2.0 # 基础延迟 2 秒 DEFAULT_UPSTREAM_MAX_DELAY 60.0 # 上限 60 秒 DEFAULT_UPSTREAM_JITTER 1.0 # 抖动幅度而并发请求共享同一个恢复战役recovery episode第一个可重试失败会开启战役并选出一个leader由它等待并发送半开探测half-open probe同时挂起的其他请求合并进同一战役排队探测成功则全员放行。这避免了所有请求同时疯狂重试、压垮上游的重试风暴。错误本身如何分类429 限流可重试、401/400 不可重试、5xx 与网络错误可重试则由 failure_policy.py 统一裁决。想在源码中验证看这几个文件回退窗口与决策核心stream_recovery.py5 次预算与退避参数admission.py失败分类与可重试判定failure_policy.py决策逻辑的单元测试含最后一次尝试保留给中途恢复用例test_stream_recovery.py架构总览第 1165 行附近专门描述了 0.75 秒/65,536 字节提交回退ARCHITECTURE.md如果还没有本地环境可以先克隆仓库git clone https://gitcode.com/GitHub_Trending/fr/free-claude-code小结Free Claude Code 的流恢复机制由三个数字撑起0.75 秒无感回退窗口、5 次每请求尝试预算、64KB回退缓冲上限。早期断流被扣在缓冲带里悄悄重发中途断流则保留已见内容做续接恢复所有重试还受指数退避与共享恢复战役约束。理解这套机制你就知道为什么用它跑长任务时断流几乎从不是你需要操心的事 【免费下载链接】free-claude-codeUse Claude Code, Codex, Pi, and OpenCode and more for free (1.3B free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported ToS friendly)项目地址: https://gitcode.com/GitHub_Trending/fr/free-claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考