Repository navigation
[PR] feat: verified-incremental prefix fast path for plugin-lane fold reconcile (#3248 phase 1) | [PR] feat: verified-incremental prefix fast path for plugin-lane fold reconcile (#3248 阶段 1) - #3257
Conversation
(ai: vllm-qwen/qwen3.8-27b) 查重: 不重复——本条即 PR #3257 自身的 PR 记录(#3248 阶段 1),与在途 #3253(阶段 2)/#3255/#3256 无同症状同机制条目;正文自述与 #3253 在 开始审核:先取全窗 diff 分段通读(server/测试/admin 高危域精读),本地只跑定向套件(fold-reconcile / positional / incremental-prefix),全量回归看 CI。结论按八问体例给出。 |
📦 Built Package ArtifactBranch: Option A — Install this exact build (recommended)npm install -g billion-context@0.0.3755-pr.3257.5522037This exact version is immutable and reproducible. The rolling Option B — Download artifact
tar xzf billion-context-pr3257.tgz
npm install -g packageInstall instructions are refreshed on each push. |
…path hunk (#3257 review nit)
…path hunk (#3257 review nit)
15d382d to
ac3cf7a
Compare
…ncile (#3248 phase 1) Plugin lanes (metadata.pluginAgent set) skip the full planReconciliation scan when the resent history verifies as a pure tail-append of the previous pass: per-session {count, hash, clean} fingerprint over derived ids in metadata (incrementalPrefix); any gate failure (count-shrink / hash-mismatch / dirty-predecessor) falls back to full reconciliation, and the fingerprint refreshes from every pass so dirty episodes self-heal. Fast-path plan is byte-exact with planReconciliation's missing===0 early exit (shared buildOrderAndCanon walk); lockstep-equivalence property test pins it. Water-level stats at GET /__bili/stats under 'incremental'. No wire, config, env, or header surface added; BILI_FOLD_RECONCILE=off escape hatch unchanged.
…path hunk (#3257 review nit)
ac3cf7a to
08f295e
Compare
(ai: vllm-qwen/qwen3.8-27b) 审核结论:可合(人工合并)独立审完(未照抄 issue/PR 描述):逐段读完全部 5 个文件的 diff(核心
结构化八问
测试有效性(质量关)lockstep 等价是真 property test,断言有牙(逐轮 byte-equality,bug 回归时必抓);gate 三 reason、side-request 非污染、非 lane 排除、损坏指纹静默回退且不计 miss 均单独钉住;链哈希单元覆盖确定性/顺序敏感/内容敏感/截断/NUL 边界。不是为测试而测试。 两个需要知道的预期(不是缺陷,避免日后误读)
判定可合,人工合并(§7.4 auto-merge 不适用:feat surface + 触碰 fold-reconcile identity 域,PR body 自述正确)。合并时机:等新 head |
(ai: vllm-qwen/qwen3.8-27b) 补充一条:rebased head |
|
(ai: zhipuai-lb/glm-5.3) 孤儿票清理:标题指向的 issue 已关闭,修复已由其他路径落地。关单;误判请 reopen。 |
关联: #3248(阶段 3 候选项「server-authored-prefix fast path」的 reconcile 半边)/ #3253(阶段 2,增量车道本体)
一句话
plugin 车道里,当重发历史被证明是上一轮的纯尾部追加时,跳过 fold-reconcile 的全量扫描(
planReconciliation):每会话在 metadata 维护 derived id 的{count, hash, clean}指纹,匹配则代入planReconciliation在 missing===0 早退时返回的精确同形 plan;任何失配回退全量对账,语义零变化。与 #3248 / #3253 的关系
#3248 原阶段 1 措辞是「车道头带我的前缀 hash」。#3253 落地后,增量车道的 canonical 就是 unified messages 表本身(#3007/#3166 从普通流量也在喂它),客户端 hash 阶梯被设计取代。本 PR 做的是不依赖 #3253、独立成立的剩余部分:reconcile 侧快路径——正对应 #3253 列出的 open item「server-authored-prefix fast path(skip the O(full) strip/reconcile walk over the prefix)」中的 reconcile 半边(strip 与其他 per-message 处理不变、照跑)。
metadata.pluginAgent已绑定:dsh / pi / opencode-native);四个通用 wire 适配器不动;BILI_FOLD_RECONCILE=off照旧整体禁用此机制。机制
session.metadata.incrementalPrefix写{count, hash, clean}:count = derived id 数,hash = sha256 链摘要(32 hex),clean = 该 pass 无 claims/unmatched;测试
tests/incremental-prefix.test.ts(13 个):链哈希单元 ×5 + 行为 ×8。核心性质 = lockstep 等价:走快路径的会话必须与每轮强制全量对账的同态会话逐字节一致(metadata 除指纹键外 + blocks deepEqual,5 轮增长逐轮断言);tests/fold-reconcile.test.ts:825整结果断言补新字段fastPath: false(result 形状变更的必要跟进,该用例 fixture 无 pluginAgent,字段结构上恒 false);回归审查(既有行为清点)
GET /__bili/statspayload 新增一个键incremental(per-lane hits/misses)——stats-only 追加,既有键不变。行为变更披露
无对外行为变更(纯服务端内部优化,外部行为由 lockstep 测试证明等价)。新增面:stats payload 多一个
incremental字段。人工合并(§7.4 auto-merge 不适用:触碰 fold-reconcile identity 域 + feat surface)。与未合并的 #3253 在 admin.ts sendStats 一行可能相邻,先合者为准,后者 rebase 即可。