SSE 重连、Epoch 与重同步

SSE replay 是有界恢复，不是完整持久历史。保存最后收到的 id 和响应中的 X-Qwen-Event-Epoch，重连时一起发送，才能识别数字序号重用后的旧状态。

基础行为

Last-Event-ID	结果
不提供	仅 live，不回放
0	请求当前 ring 中可用历史，仍受窗口与字节预算限制
合法 N 且有连续后续	回放 id>N，然后进入 live
非纯十进制、负数、小数或超安全整数	忽略无效游标并从 live 开始，写诊断

默认 ring 深度 8000。重放阶段结束会发无 id 的 replay_complete，即使 replayedCount 为 0；它只表示该次重放已结束，不表示没有丢历史，也不自动解除 awaitingResync。

四类重同步原因

reason	触发与帧顺序
epoch_reset	epoch 不同，或 N>=nextId；先发信号，再尝试回放当前 ring
seeded_replay_not_in_ring	序列被恢复历史推进但 live ring 为空，N 仍落后；需 load 取 seeded 历史
ring_evicted	ring 最早 id>N+1；信号后只能回放仍保留的后缀
replay_budget_exceeded	回放前缀后到达字节预算；再发信号，随后 replay_complete

epoch token 不同会带 detail:epoch_mismatch。仅比较 N 与 nextId 不够：新 bus 数字已经追上旧 N 时，仍需 token 识别跨代游标。

当前源码的 replayBudgetBytes 默认 8 MiB，至少允许一个符合条件的事件，即使单帧本身超过预算。这是内部有界策略，不是可由 HTTP 客户端无限提高的历史下载配额。

同一订阅可先收到 epoch/ring 类信号，之后再收到 replay_budget_exceeded。所有这些信号都不关闭流，后续帧仍会到达。

状态恢复顺序

会话 reducer 收到 state_resync_required 后设置 awaitingResync，跳过普通 delta；终止、再次 resync、session_snapshot 和 recording_degraded 等安全状态仍可处理，游标也可能继续推进。

宿主应读取 load 的有界 replay snapshot，按自身状态策略 reset/rebuild。共享 transcript store 的 clearAwaitingResync 必须早于新 SSE/replay 开始传递增量；不能等重放结束后才解除，否则重放已被跳过。

session view reducer 与 UI transcript store 是两层状态，不要只清一层就假定全部恢复。参见共享 UI。

History truncation 是提示，不是重同步命令

compactedReplay 开头的 history_truncated 表示较早的 replay 窗口已裁剪。按 fullTranscriptAvailable 决定是否可以调用持久 transcript 分页，同时正常应用保留下来的 replay，不再触发恢复循环。

可选 recordId 是向前分页的 beforeRecordId 锚点。首次裁剪时确定后应保持固定，不能随新增事件向已展示内容移动，否则前插历史会重复。

浏览器连接方式

原生 EventSource 能跟踪 id 并重连，但不能设置自定义 Authorization header。需要 bearer 时使用 fetch 加 SSE parser，SDK 的 REST SSE transport采用这一方式。

流中的 retry:3000 为兼容 EventSource 提供 3 秒重连建议，不等同于应用层所有错误都应每 3 秒无限重试。