Repository navigation
[Bug][根因分析] session/control 流一次瞬态 service-unavailable 后永久终止,所有 Session 投影(标题/统计/看板)冻结(#13416 根因) #13747
githubdbluo
started this conversation in
General
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
摘要
session/control这条长流在一次瞬态的active service "sessionController" is unavailable之后被判为终态,而客户端没有任何入口能重建它。此后该标签页里所有 Session 投影(title、sessionStats、tokenUsage、agentTeam…)永久停止更新,只有重载渲染进程才恢复。这就是 #13416 的根因:不是「帧没投递」,而是流已经死了、且不会重开。#13074(workspace follow 流冻结)是同一处设计缺口在另一条流上的表现,区别是那条流需要两次载体丢失才终态,这条只需要一次。
环境
0.2.2-rc.2(Electron 44.7.0 / Node 24.21.0,Windows 11)现象
{turns} 轮 {steps} 步、token 总量、缓存命中)整条不出现。store.seed(page.projections)的一次性快照,之后仍然不再更新。useProjection(key)消费者都是冻住的(与 [Bug] 桌面端 0.2.2-rc.3:Session 投影不推送实时帧,只有打开会话时的基线(依赖 useProjection 的看板无法实时刷新) #13416 中agentTeam的观测一致)。关键证据
渲染进程控制台里唯一一条相关日志(此后没有任何重试记录):
同一时刻的「磁盘 vs 界面」对比(投影缓存是宿主写出的持久检查点):
~/.dsh/storages/session_projcache/titlesessionStatsturns:1, steps:83, llmMs:…, toolMs:…tokenUsagecacheReadTokens/outputTokens均为最新再往前一个会话的原始日志里,
session/title在 seq 19(回合早期)就落盘了,turn/end在 seq 354;这中间好几分钟界面一直没有标题。可见宿主侧计算与持久化都是正常的,缺的只是推送到客户端的帧。根因(0.2.2-rc.2 代码路径)
packages/api/gateway/src/client/remote-stream.tswaitForRemoteStreamRetry():零延迟重开本身没问题,但它把「重开」直接送进了宿主侧服务不可用的窗口(HMR 替换插件、启动期激活竞争等)。
read()的 catch:重开拿到的是
RemoteError(业务错误,不是 carrier 错误)→ 不做任何重试,直接终态。packages/api/gateway/src/client/snapshot-stream.tsconsume()捕获后只调用options.failed()(即上面那行console.error),而start()是幂等的:终态之后
this.iterator已经结束,restart()无可 abort,start()直接返回。packages/api/session-controller/src/client/index.ts里这两处是唯一的启动/重启入口,且只挂在连接 generation 的订阅上:结论:终态之后即使连接 generation 变化(重连成功)也无法重建这条逻辑流;用户侧唯一恢复手段是重载页面 / 重启应用,而且没有任何提示告诉用户投影已经过期。
影响面
session/control投影帧的 UI:侧边栏会话标题、composer 统计胶囊(sessionStats/tokenUsage)、所有第三方useProjection看板(如 [Bug] 桌面端 0.2.2-rc.3:Session 投影不推送实时帧,只有打开会话时的基线(依赖 useProjection 的看板无法实时刷新) #13416 的团队面板、官方 TeamBoard)。建议的修法(按代价从低到高)
service-unavailable/gateway/*这类瞬时业务错误)带指数退避重试,而不是terminalStreamFailure。按定义 control 流是可重开的,它没有「不可恢复的协议状态」。RemoteSnapshotStream暴露"终态后重建"入口(重置started/taken,或每次 generation 变化新建逻辑流),由connected()触发;这样一次瞬态失败最多丢几秒的帧。session-controller按会话回退到session/observeProjections(本来就有这个 per-session 流式读面),至少让已打开的会话继续拿到帧。failed()的日志带上流名与错误码,方便用户自己判断该刷新。版本核对
@deepseek-ai/dsh-api-gateway、@deepseek-ai/dsh-api-session-controller、@deepseek-ai/dsh-client-store、@deepseek-ai/dsh-session-projection等包在0.2.2-rc.2与0.2.2-rc.5之间lib/*.js逐字节相同(只有typert.host.js与package.json有差异),因此 rc.5 上同样会复现。复现思路
在已连接的标签页里让
sessionController短暂不可用即可(例如热加载/替换@deepseek-ai/dsh-api-session-controller这一条目,或在宿主启动瞬间打开页面)。之后观察:control stream failed;await ctx.remote.session.projections({ sessionId })仍返回正确最新值(证明宿主侧正常、只缺帧);相关:#13416(同一症状的现场报告)、#13074(workspace follow 流的同一处 design gap)、#13726(
active Service … unavailable的另一类成因,供区分:那种是宿主侧永久不可用,本例是瞬态窗口 + 客户端放弃重试)。All reactions