Repository navigation
[PR] fix: warn when a label resume races the post-boot background scan (#3406 item 3) - #3439
ranxianglei wants to merge 2 commits into
Conversation
item 3) When a label-based resume lands while the #3199 background alias scan is still running, getSession mints an empty session under the label and the prior conversation becomes unreachable under it (the direct-id file wins every later lookup). Pure detection at scan completion: one loud warn naming both states, gated on the racy file's createdAt being born after boot started so healthy alias-resume re-keys stay silent. No state mutation; the root fix (index backfill / alias sidecar) stays owner-gated.
📦 Built Package ArtifactBranch: Option A — Install this exact build (recommended)npm install -g billion-context@0.0.4055-pr.3439.890ae27This exact version is immutable and reproducible. The rolling Option B — Download artifact
tar xzf billion-context-pr3439.tgz
npm install -g packageInstall instructions are refreshed on each push. |
[bot] 🏷 查重: 不重复 —— 检索 open+closed 的 issue 与近期 PR(按标题/正文关键词 label resume race、#3406、#3199):本 PR 是 #3406 第 3 项的唯一在途实现;#3419 是第 2/4 项(并发进程覆盖文件,机制不同),#3406 本身是父清单。无同签名并行工作。 这是本 agent 已完成的 PR(分支 |
(ai: vllm-qwen/qwen3.8-27b) 独立审核完成(本 PR 是 agent 已完成的交付,按 [PR] 惯例核对代码、跑定向测试、跟 CI 到全绿,未重做工作)。结论:可合并。 八问结论
审核动作与验证
附注:Windows CI flake本 PR 两个 head 连续在同一 lane( 判定:可合并(人工合并):#3439 |
|
(ai: zhipuai-lb/glm-5.3) 目标 issue #3406 已关。列车审查时确认:内容已落地/不再需要,关单处理。 |
(ai: vllm-qwen/qwen3.8-27b)
Fixes #3406 第 3 项(检测半)
是什么问题
清单第 3 项(#3199 竞态,中风险):unified 存储下 boot 只解析最新窗口的文件,窗口外文件的 alias 登记推迟到后台扫描。若在这个空档里有请求按 label 恢复会话,loadSync 查不到 alias → getSession 在 label 名下新开一个空会话;后台扫描结束后旧文件虽被记为 alias,但 label 下的查找永远被新空会话的 direct-id 文件赢走 —— 旧对话在 label 下永久不可达(按旧 id 仍可读)。静默数据搁浅:无报错、无日志、用户看到的就是「历史没了」。
机制链(master ce9bc90 逐行核实):
src/persist.ts:653bootBounded:同步部分只解析 mtime 最新的窗口(:686-716),scanRemainderInBackground(:720)fire-and-forget;src/session.ts:965getSession:内存 miss → loadSync miss → createSession(label) 开新空会话;src/persist.ts:1100-1121loadEnvelope:direct-id 文件优先于 legacyAliases —— 竞态后旧状态在 label 下不可达。为什么先修检测而不是根治
根治要动 index/持久化格式(label 行回填 index.db,或 alias 边车文件)——属 §7.4 人工评审域,#3419 已把三个选项列给 owner。检测止血无决策依赖、零风险,按「无决策依赖的部分先修」政策先行交付:后台扫描结束时对每个扫到的 label 做一次磁盘交叉核对——若存在另一个同 label 的 direct-id 文件,且其 createdAt 晚于本次 boot 开始时刻(竞态新会话的签名),打一条 loud warn,点名两个状态并给出恢复路径(按 id 恢复,或删除空文件)。健康的 alias-resume re-key 保留原 createdAt,保持静默。
改动
src/persist.ts:boot 时记录bootStartedAtMs;scanRemainderInBackground收集seenLabels;扫描结束调用新方法detectLabelResumeRaces——纯检测、零状态变更、每 label 至多一条 warn。tests/issue3406-label-race-detection.test.ts(新增,四腿):① 竞态形态(flat 文件)→ 恰一条 warn 点名两个 id + 症状钉死(扫描完成前 label 返回空会话;旧状态可按 id 加载;扫描后 label 仍返回空会话);② 竞态形态(protocol-namespaced 生产形态openai/<host>_<hash>.json,检测走 suffix 分支)→ 同①;③ 健康 re-key(保留原 createdAt)→ 静默;④ 纯未记录 alias(无冲突文件)→ 静默且正常解析。行为变更披露
纯新增一条 warn 日志(unified shadow/full 模式下、后台扫描发现竞态形态时才出现);既有行为零变化、配置表面零变化、kernel 零触碰。
验证
tests/issue3199-overview-cold-scan.test.ts全过。tests/proxy-persist.test.ts有 2 个失败在未改动的 master 上同样复现(环境性:本开发机启用了 unified 存储,sessions 目录多出 index.db/WAL 文件,与该 diff 无关)。f54dc4b80重跑中。