Skip to content

fix: pfa-* 匿名账本可归因 —— mint 时刻 producer provenance + 唯一标签 (#2879) - #2885

Merged
ranxianglei merged 1 commit into
masterfrom
2026-10-12_pfa-anon-provenance
Oct 12, 2026
Merged

ranxianglei merged 1 commit into
masterfrom
2026-10-12_pfa-anon-provenance

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

Closes #2879

来源: #2847 分析「pi 车道切供应商后 fold 不随会话迁移」时观察到的 4 个 ~1.2MB pfa-* 匿名账本无法事后归因(文件名 hash、共享标签、mint 日志无客户端指纹 → #2847 曾误判为孪生文件)。

机制与修法

生产端判定(代码层面): H2(bili 自身 probe 子进程写账本)在 master cd02d2d 证伪——#2313 的 evidence probe 是客户端自己请求的 single-shot 探测转发(携带客户端身份),#2834 家族的 best-effort 子进程只跑 git/powershell 诊断,完全不碰模型流量;src/ 内不存在 bili 合成 LLM 请求过自家 pipeline 的路径。H1(宿主侧辅助 LLM 流量不带会话标识)成立且候选明确:pi native 插件的 x-bili-plugin-conversation 盖章要求 toolsReady && sessionIdOf(ctx)(src/agent/pi.ts:1074-1132),任一缺口即整进程匿名;acp_delegate 每个 run 是独立 pi 子进程(pi-subagents/src/delegate-tool.ts:1377+),其全部对话要么有身份、要么整体落一条持续增长的 pfa-* 链——四个 mtime 间隔 ~1-1.5h 的 ~1.2MB 账本与四个长耗时 delegate run 高度吻合。最终确认需要用户侧证据——本 PR 让该证据从此可取。

本 PR 修的是 issue 影响面 #2(取证误导)与「待补证据」的可得性,单一机制族:

  1. mint 时刻捕获 producer provenance(新模块 src/anon-provenance.ts):新铸 pfa-* 会话时把该请求的 UA、header NAME 清单(值永不记录——可能带凭据)、x-bili-plugin marker 值(extension 已加载但无会话身份 = stamp-failure 签名,H1 关键判别位)、首条 user 消息预览(160 字符截断 + URL mask)、remote address 写入 metadata.anonymousPrefixAffinity.producer。first-writer-wins:后续轮次不得覆写 mint 指纹。x-bili-plugin 有值而会话仍匿名落 pfa-* = pi 扩展盖章失败(toolsReady/sessionId 缺口),直接指向 H1 的具体成因。
  2. 唯一显示标签:匿名会话 label 从共享裸 "prefix-affinity" 改为 prefix-affinity <tail8>(tailHash 前 8 位)。N 个并行匿名账本不再共享同一标签——[Evidence] pi 车道切供应商(同 modelId)后 fold 不随会话迁移:裸上下文 2.23MB(≥298K est tokens)被 preflight 10 秒拒 3 次;账面 ≤157K 与裸水位背离 10.5h #2847 误判的形状被消除。first-write-wins 保证会话生命周期内稳定;旧会话保留裸标签,无需迁移(重启/会话分裂后上游 prompt cache 命中掉到 0% —— 每请求全量付费(成本回归) #499 boot 迁移跳过条件基于 id 前缀而非 label,不受影响)。
  3. mint 日志行补指纹:[prefix-affinity] new anonymous session ... ; ua="..." plugin=... first="..."——对应时刻的日志从此可与账本对账(issue「待补证据」第 2 条)。

⚠️ 行为变更披露(owner policy 2026-09-22)

项 旧 新 原因
新建匿名会话显示标签 恒为 prefix-affinity(所有账本相同) prefix-affinity <tail8>(每账本唯一) 共享标签导致 #2847 取证误判;仅影响 web UI/export/admin 展示面,无任何代码按字面量比较该 label(已核实)
session metadata 无 producer 字段 新增可选 anonymousPrefixAffinity.producer 纯增量,persist 读回路径向后兼容(metadata 自由形态),旧文件无此字段即视为未捕获
mint 日志行 止于 tail/lineage 追加 ; ua= plugin= first= 取证对账所需;UA/预览均截断+mask,header 只记名不记值

既有行为逐项核查(回归审查):label first-write-wins 语义不变(session.ts 原有 if (meta?.label && !existing.meta.label));#499 pfa-* 迁移跳过不变(id 前缀判断);anonymousPrefixAffinity stamp 其余字段仍 latest-wins、仅 producer first-writer-wins;wire 零改动(不改任何转发字节);压缩/nudge/preflight 路径未触碰。

测试

  • 新增 tests/issue2879-anon-provenance.test.ts(4 个 hermetic e2e,真实匿名客户端走 prefix-affinity mint):A=mint 捕获完整 producer + 唯一标签 + 日志指纹;B=两个不同匿名会话标签互异且 firstMsg 各自归位;C=producer first-writer-wins(换 UA/header 的后续轮次不覆写);D=x-bili-plugin: pi 无会话身份 → 仍匿名但记录 pluginAgent=pi(stamp-failure 签名)。
  • 定向回归(触碰路径收窄集)167 用例全绿:prefix-affinity{,-simhash,-orphan}、affinity-{persist,neutral}、issue2033-anonymous-anchor、issue2129-restart-measurement-state、e2e-session-identity、proxy-persist(含 重启/会话分裂后上游 prompt cache 命中掉到 0% —— 每请求全量付费(成本回归) #499 用例)、web-sessions、issue2322-session-name、grok/proxy-session-id、fork-nudge-trigger、issue2484、dsh-persona-continuity、issue2601-persona-fork-lineage。
  • typecheck + build 绿(CI 全量把关)。

留给 owner 的设计决定(不在本 PR 范围)

  • KDD#9 家族:辅助 persona 流量是否应共享主会话身份或豁免持久化——属默认值/语义级产品决定,待本 PR 的 provenance 数据积累后拍板。
  • 用户机器上现存 4 个 pfa-* 文件的最终归因:升级后可用首条消息预览 + 对应时刻 mint 日志直接判别(delegate run 的预期特征 = 角色 prompt 开头,非主会话逐字重合)。

@github-actions

github-actions Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-10-12_pfa-anon-provenance (d0a3ec2)

Option A — Install this exact build (recommended)

npm install -g billion-context@0.0.3200-pr.2885.419e2fa

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

Option B — Download artifact

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

Install instructions are refreshed on each push.

@ranxianglei
ranxianglei force-pushed the 2026-10-12_pfa-anon-provenance branch from 8763e66 to d0a3ec2 Compare October 12, 2026 07:32
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 PR #2885 审查结论(结构化八问)

审了什么:分支 2026-10-12_pfa-anon-provenance,单 commit,4 文件(+332/-5)。逐行核对 diff + 本地独立验证 + 既有行为逐项清点。

① 是什么问题:pfa-* 匿名账本事后无法归因——文件名是内容 hash、所有匿名账本共享同一个裸 prefix-affinity 标签、mint 日志无任何客户端指纹。#2847 中四个 ~1.2MB 账本已被误判为「同一会话的孪生文件」。本 PR 让每个新铸匿名会话的生产者在 mint 时刻可识别。

② 什么原因导致的:设计缺口而非代码 bug——匿名会话以内容指纹为身份(#309),铸造时没有任何机制记录「这个请求是谁发的」;显示标签又硬编码为全体共享的字符串。修法在唯一可观测的时刻(mint 请求)补一条归因通道,方向正确。

③ 影响范围与严重程度:无功能缺陷(压缩/转发均正常);受影响面是取证/诊断:排查 #2847 这类问题时只能靠 mtime/size 猜。严重度 = 诊断受损,非用户可见故障。

④ 怎么修复的:三处改动全部锚定 mint 时刻——(a) 把 UA(≤120 字符)、header NAME 清单(排序 ≤48 个,值永不记录)、x-bili-plugin marker 值(stamp-failure 判别位)、首条 user 消息预览(160 字符、空白折叠+URL mask)、remote address 写入 metadata.anonymousPrefixAffinity.producer,first-writer-wins;(b) 标签改为 prefix-affinity <tail8>,每账本唯一;(c) mint 日志行追加 ; ua= plugin= first= 指纹,与账本可对账。

⑤ 是否有回归问题:未发现。既有行为逐项核查:

  • label first-write-wins 语义不变(src/session.ts:687 if (meta?.label && !existing.meta.label));
  • 重启/会话分裂后上游 prompt cache 命中掉到 0% —— 每请求全量付费(成本回归) #499 boot 迁移跳过条件是 id.startsWith("pfa-")(src/persist.ts:622),基于 id 前缀而非 label → 不受影响;
  • stamp 其余字段仍 latest-wins,仅新增 producer 为 first-writer-wins;
  • wire 零改动(不改任何转发字节;压缩/nudge/preflight 路径未触碰);
  • grep 全 src/:无代码按字面量比较该 label(仅 src/storage/ingest.ts:210、src/server/admin.ts:376 两处透传读取);
  • 旧会话保留裸标签无需迁移;升级前已铸的会话永远缺 producer 字段(向后兼容,视为未捕获)。
  • PR 正文披露的行为变更(label 格式 / metadata 增量 / 日志行后缀)与代码事实一致,无未披露漂移。

⑥ 是否破坏缓存:不涉及(纯本地持久化 metadata,不触碰上游 prefix cache / 重试 / 去重键)。

⑦ 是否改了设计方向:否。KDD#9(辅助 persona 流量共享主会话身份 or 豁免持久化)未触碰,仍是 owner 决定;本 PR 只让证据从此可取。

⑧ 是否引入新配置:无新 env / config / 默认值。

验证证据:

判定:可合并(待新 head d0a3ec221 CI 绿后),人工合并。

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 CI 确认:rebased 新 head d0a3ec221 的 CI 已全绿(29/29,含 test matrix windows/ubuntu ×22/24、hermetic registry e2e、real pi/codex/opencode/dsh lanes)。

最终判定:可合并,请人工合并 #2885 。合并后 #2879 自动关闭;用户机器上现存 4 个 pfa-* 文件的归因按 PR 描述走「升级后看首条消息预览 + 对应时刻 mint 日志」即可。

@ranxianglei
ranxianglei merged commit 8e5df70 into master Oct 12, 2026
29 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

📦 Merged Build Published

This merge to master was published as 0.0.312-master.8e5df70 (rolling master tag).

npm install -g billion-context@0.0.312-master.8e5df70  # this exact build
npm install -g billion-context@master  # always the newest merged build

npm view billion-context@master prints the current version at any time.

@ranxianglei
ranxianglei deleted the 2026-10-12_pfa-anon-provenance branch October 15, 2026 05:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant