Skip to content

[PR] feat(fastpath): v5 identity-based hit criteria (only sessionid+msgid; count/bytes demoted to diagnostics) — per owner ru | feat(fastpath): v5 身份制命中判据(只看 sessionid+msgid,count/字节降级为诊断)— 按 owner ruling 2026-11-03 - #5577

Closed
ranxianglei wants to merge 2 commits into
masterfrom
feat/watermark-v5-idonly

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

现象 / 背景

owner 裁决(#5571 讨论,m02411):命中判据去掉字节级头部比对——只看 sessionid + msgid,不看字节是否稳定、不看 count。count 在 v4(owner ruling 2026-11-02)已降为诊断;本 PR 完成最后一步:头部逐元素 id/字节比对同样降级,并新增会话身份连续性闸门。

改动(src/server/fastpath.ts 单文件 + 测试,+170/−40)

  1. 头部比对降级:形状有效的宿主 msgid 列表在场时(prevId 链+宽度算术已在服务端重建计数),逐元素核心 id/字节不等不再挡命中,改为 warn 诊断流(watermark v5: N/M head element(s) differ ... riding ... feeds M3)。宿主就地改写 head 会以 stash 前缀核"骑乘"出站(已知后果,warn 流供 M3 智能重播种使用)。纯 count 客户端无任何身份可凭——行为与 v5 前逐字节一致。
  2. sess-change 闸门:新增状态字段 cs(客户端原生会话头 h8=sha1[:8] 摘要,只存摘要不落原文,隐私口径对齐 [PR] feat(obs): M1 Native Identity Observation Layer — Convert the #5571 collection table from static forensics to live measu | feat(obs): M1 原生身份观测层 — 把 #5571 采集表从静态取证变成实测数据(默认关) #5573):wb x-conversation-id / cc x-claude-code-session-id / opencode x-session-affinity(字面量按 lane 统一决策点收尾:还剩四处按客户端名字自算的旁路要搬进来(#3417 待做) #3482 先例在本模块内复制,[Design] Client-Native Unified Identity Layer for Session/MsgID (Identity Collection Table + Incremental Parsing Refacto | [设计] 客户端原生的 session/msgid 统一身份层(身份采集表 + 增量解析重构) #5571 的 profiles 表是规范源)。种子轮记录过身份后,当前请求身份必须同值,否则 miss("sess-change") 走 legacy;任一侧无值则不主张、不误伤。语义:记录的跟随流量走——换会话的后续增长可以骑乘,原会话回来再付一次 legacy(无跨交换静默骑乘)。readSaved 白名单已同步放行 cs(漏了它闸门永不生效,本 PR 内发现并修)。
  3. 保留项(flagged deviation):系统文本没有 msgid,head-drift 两侧模式都继续挡命中(credited miss,自修复)——宁可多解析一次,不把过期 system prompt 发出去。此点在 ruling 线程中单独报备,可否决。

不变量

宽度算术仍服务端重建(K 取自 ledger stampT,永不吃 echo);prevId 链、shape、模型匹配、breaker、零增量 no-progress 全部原样;count 模式逐字节行为不变(既有 in-place-edit 回归测试未动且通过)。

验证

tsc 0 error;tests/fastpath.test.ts 24/24(含 3 个新 v5 测试:骑乘+warn、system 仍挡【钉死偏差】、sess 换回语义)、issue5403-watermark-fastpath 与 lane-decisions-matrix 合计 122/122。

依赖关系

独立于 #5573(observation layer):会话头字面量有意复制而非 import,两个 PR 任意顺序合并均可;合并 #5573 后可选做去重重构。

…026-11-03

Owner directive (issue #5571 thread): drop byte-stability from the hit gate;
verify on sessionid + msgid only, count stays diagnostic (already so since v4).

- Head element loop: under a shape-valid host msgid list, id/byte inequality
  demotes to a diagnostic warn stream (feeds M3 re-seeding signals); pure-count
  clients keep the pre-v5 byte gate unchanged (their ids carry no proof).
- Session continuity gate: new state field cs (h8 digest of the client-native
  session header: wb x-conversation-id / cc x-claude-code-session-id /
  opencode x-session-affinity); an identity swap riding one bili session is a
  sess-change miss; recorded identity follows the traffic, swaps always cost a
  legacy pass. readSaved whitelist extended for cs.
- System text has no msgid (flagged deviation in the ruling): head-drift stays
  gating in both modes.

@ranxianglei ranxianglei left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

自审(评审人=作者本人,小改动按常设规则直接提交):

结论:可合并。 要点核对:

  1. 闸门顺序正确:sess-change 放在 shape/prevId 之后、multimodal/fragment 解析之前(fail-fast),且仅 id 模式(形状有效列表在场)生效。
  2. readSaved 白名单对 cs 要求恰 8 位 hex,失配即重建——与本模块防御风格一致;cs 只存 sha1[:8] 摘要,无隐私面。本字段曾遗漏导致闸门静默失效,已补并有回归测试钉死(sess-change 三个断言)。
  3. 会话头字面量三处复制(#3482 先例,#5573 profiles 表为规范源)——#5573 合并后可做去重重构,不阻塞本 PR。
  4. 需 owner 知悉的两处语义(PR body 已标):① system 文本无 msgid → head-drift 两侧仍挡命中(flagged deviation,可否决);② id 模式下 head 被宿主就地改写会以 stash 前缀核骑乘出站,靠 warn 流兜底,M3 可升级为智能重播种。
  5. count 模式逐字节行为不变:既有 in-place-edit 回归测试未动、通过;122/122 + tsc 0。

@github-actions

github-actions Bot commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: feat/watermark-v5-idonly (3f06c66)

Latest build — install this exact version

npm install -g billion-context@0.0.7953-pr.5577.e1c81bc

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Recent builds (commit → version)

commit version build
3f06c66 billion-context@0.0.7953-pr.5577.e1c81bc build
56874e6 billion-context@0.0.7941-pr.5577.2a4d514 build

Download artifact

  1. Download the artifact from the Actions run
  2. Extract the tarball and install:
tar xzf billion-context-pr5577.tgz
npm install -g package

Install instructions are refreshed on each push.

@ranxianglei ranxianglei changed the title feat(fastpath): v5 身份制命中判据(只看 sessionid+msgid,count/字节降级为诊断)— 按 owner ruling 2026-11-03 [PR] feat(fastpath): v5 identity-based hit criteria (only sessionid+msgid; count/bytes demoted to diagnostics) — per owner ru | feat(fastpath): v5 身份制命中判据(只看 sessionid+msgid,count/字节降级为诊断)— 按 owner ruling 2026-11-03 Nov 3, 2026
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重:不重复。全仓 open/closed 检索 watermark/fastpath 仅命中 #5573(本 PR 正文点名的姊妹「身份采集层」设计 PR,正文明确二者独立、任意顺序可合);无并列/竞争的同 v5 判据改动。#5571(ruling 讨论)、#5403/#5418(前序 v3/v4)、#3482(header 字面量复制先例)均为背景引用,非重复项。

标签:scope/wiring + p2(保留 pr)。理由:owner 裁决落地的请求管道命中判定变更(wiring,非 kernel/非存储);主路径正常、残留风险限特定条件(p2)。

审核结论(八问)

一句人话先行:这个 PR 把你 2026-11-03 的裁决忠实落地了——id 模式下头部逐元素 id/字节比对降级为诊断、新增会话身份连续性闸门;count 模式逐字节行为不变。代码我逐行读完、三个新测试在 CI 里确实过了。唯一拦路的是 CI 现在红,但红的不是这个 diff(见末节)。

  1. 是什么:把 watermark fastpath 命中判据从「字节级头部比对」改成「身份制」——只看 sessionid + msgid,头部字节/id 不等不再挡命中(降为 warn 诊断),并加一道会话身份闸门挡跨会话骑乘。是 [Design] Client-Native Unified Identity Layer for Session/MsgID (Identity Collection Table + Incremental Parsing Refacto | [设计] 客户端原生的 session/msgid 统一身份层(身份采集表 + 增量解析重构) #5571 裁决的最后一步(v4 已把 count 降为诊断)。

  2. 为什么这么改(根因):成立。形状有效的宿主 msgid 列表在场时,宽度算术已在服务端重建计数(K 取自 ledger stampT,不吃 echo)、prevId 链钉窗口起点、模型匹配排除跨模型复用——此时逐元素字节比对是冗余门而非边界真理。系统文本没有 msgid,故 head-drift 两侧仍继续挡(宁多解析一次不发过期 prompt)——你已在 ruling 线程单独报备,属可否决偏差。

  3. 影响范围与严重程度:

    • count 模式(纯 count 客户端,无 msgid):逐字节行为完全不变(闸门要求 tailIds 在场才生效;head-prefix-drift 在 tailIds===undefined 时照旧挡)。零影响。
    • id 模式(发 x-bili-pf-tail-ids 的宿主 dsh/opencode/pi 等),两处均为你裁决的变更:
      • ① 头部就地改写(id 稳定)不再触发 legacy 重解析/重播种,改为让 stash 前缀核「骑乘」出站,直到某次无关 miss 重播种;v5 前一个 legacy turn 即自愈。残留风险:宿主就地改写某冻结头部元素(如 dsh message-edit)且中间无无关 miss 时,模型看到改写前的旧字节。面很窄,已有 warn 流(src/server/fastpath.ts:389)供 M3 消费,但目前尚无消费者,M3 是后续工作。
      • ② sess-change 闸门:换会话的后续增长可骑乘,原会话回来再付一次 legacy,无跨交换静默骑乘;任一侧无 header 则中性。我对测试 A→B→B→A 逐步跟了代码,语义正确。
    • 定 p2:主路径无碍,风险限特定条件、已披露、有监控钩子,非可用性/缓存泄露类。
  4. 修法思路:单一投影不变量不动——宽度算术仍服务端重建,prevId/shape/model/breaker/no-progress 全原样。只在 id 模式把「头部 id/字节不等」从 gate 降为 contentDrifts 计数 + warn;新增 cs 字段(客户端原生会话头 h8=sha1[:8] 摘要,只存摘要不落原文,隐私对齐 [PR] feat(obs): M1 Native Identity Observation Layer — Convert the #5571 collection table from static forensics to live measu | feat(obs): M1 原生身份观测层 — 把 #5571 采集表从静态取证变成实测数据(默认关) #5573)做会话闸门。header 字面量按 lane 统一决策点收尾:还剩四处按客户端名字自算的旁路要搬进来(#3417 待做) #3482 在本模块内复制(依赖自由叶子)不 import,与 [PR] feat(obs): M1 Native Identity Observation Layer — Convert the #5571 collection table from static forensics to live measu | feat(obs): M1 原生身份观测层 — 把 #5571 采集表从静态取证变成实测数据(默认关) #5573 任意顺序可合。readSaved 白名单同步放行 cs(漏了它闸门永不生效,PR 内自发现并修)。

  5. 回归清点:count 模式无回归(见 3)。id 模式两处均有意变更,旧值→新值+原因已在正文 §1/§3 与代码注释披露(① 头部改写 gate→ride+warn;② 新增 sess-change)。高危模式逐项过:fail-fast 未变吞错(shape 故障仍静默 uncredited、不进 breaker);阈值/时序未漂移;输出格式未变(count 模式决策串仍纯 "hit",off-string 分支该模式不可达);breaker 语义未动。持久化:watermark blob 新增可选 cs——向后兼容(旧 state 读出 cs=undefined→中性)、向前兼容(旧 reader 忽略未知 key)、无需迁移/版本 bump。一处非阻塞观察(既有、非本 PR 引入):noteCreditedMiss 的 arm 写入用显式字段列表 {t,m,misses,disabledAt,cs},仍会丢 l(lastTailIds)——v5 前既有写法,本 PR 只加了 cs,要不要顺手补 l 由你定,我不擅动。

  6. 破坏缓存?:不。骑乘是贴住已有 prefix-cache 前缀(stash 核即被缓存前缀),非失效;sess-change 走 legacy 是一次正常重付,非泄漏。无 stale-cache 渗漏、无 cache ref 误写。

  7. 改设计方向?:无转向。仍是 watermark fastpath 命中判定的连续演进(v3 对齐证明去门 → v4 count 降诊断 → v5 头部字节/id 降诊断 + 身份闸门),同机制族内收敛,数据流/边界不变。

  8. 新配置?:无。没有新 env/config/CLI;三个会话头是硬编码常量(lane 统一决策点收尾:还剩四处按客户端名字自算的旁路要搬进来(#3417 待做) #3482 先例,刻意不 import 保持模块依赖自由),符合配置面 owner-gated 纪律。

CI 状态(必须说清)

PR head 当前红:mergeable_state=blocked,多个 test 平衡分片失败(win-22-4 / u24-3 / u22-2 / u22-3 / u24-2);static-gates(typecheck/build)绿。拉了一个失败分片日志定位:失败用例是 storage-render golden (chat/anthropic)(快照渲染 lane D,#3756 域)对提交快照的 AssertionError——本 PR 根本没碰的子模块(本 PR 只改 src/server/fastpath.ts + tests/fastpath.test.ts);而本 PR 自己的 v5 测试在同一分片里过(ok 810 … sess-change …)。结论:这轮红不可归因于本 diff,更像继承性 master 红或 flaky(base d244fff 各 e2e lane 绿,但其主 CI workflow 拉取时仍在跑,当场无法坐实 master 红/绿)。
处置(按 #4599 协调纪律,不开新 issue):请走 #4599 重跑/核对 master;若确认继承红,git merge origin/ci-fixes 进本分支即转绿。这是你本人的 PR,我没擅自往你分支 push ci-fixes——需要的话我来做。

判定

代码层面可合——忠实落地你的裁决,两处理性偏差均已报备,回归清点干净,count 模式零影响,三个新测试有牙且 CI 通过。合并前置:CI 转绿(当前红不可归因于本 diff,走 #4599 重跑/ci-fixes 即可)。green 后建议直接合。长期盯一项:M3 智能重播种是「头部就地改写骑乘」这条 trade-off 的安全网,warn 流已就位但尚无消费者,别让 M3 悬空。

Gate Test Discipline (#3617): every gate ships both directions. The new sess-change gate only had its positive row (swap -> miss); this adds the negative row: a session id first seen after an unrecorded seed turn, and a follow-up that drops the header, must both stay hits, not spurious identity events.
@ranxianglei

Copy link
Copy Markdown
Owner Author

按 owner 指示并入 #5576(cherry-pick 于含 owner 打磨提交的最终谱系之上 = dd20ffb4,零冲突,合流后全套件 131/131 + tsc 0),本 PR 关闭。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant