WebSocket 客户端恢复最小骨架
这页先把客户端在断线、回连、找回 cursor 时该怎么做说清楚。
当前先把 token / cursor / retry_attempt → 恢复动作 串起来,让实时链开始有最小客户端恢复策略,而不是只知道“断了就再连一次”。
当前最小恢复策略
先把恢复 phase、下一步动作和兜底动作说清楚。
GET /api/coach/event-recovery:查看当前 channel / token / cursor 下的最小恢复计划
phase:fresh-subscribe / token-refresh-check / cursor-replay / stored-cursor-replay / backoff-wait
nextAction:告诉客户端下一步该直接重连、带 cursor 恢复,还是先等待 backoff
fallbackAction:恢复失败时统一退回 fresh-subscribe
clientHints:当前会把 token、cursor、retry_attempt 三层提示一起返回
执行边界
这层已经开始给恢复动作建议,但仍不是完整客户端恢复器。
这层是最小客户端订阅恢复骨架,不是完整浏览器状态机、持久重试器或刷新令牌系统。
先把恢复策略从“靠人脑理解”推进到“接口直接给出下一步”,这样实时链就更像一套系统。
后面如果继续推进,再补真正客户端恢复器、durable store 和 token refresh。