Skip to content

[PR] fix: use personaSplit to disable the instructions fingerprint fork in Responses | fix: 用 personaSplit 关闭 Responses 的 instructions 指纹分叉 - #5453

Merged
ranxianglei merged 7 commits into
ranxianglei:masterfrom
whickerpoplawski-arch:fix/persona-split-responses-fingerprint
Nov 4, 2026
Merged

ranxianglei merged 7 commits into
ranxianglei:masterfrom
whickerpoplawski-arch:fix/persona-split-responses-fingerprint

Conversation

@whickerpoplawski-arch

@whickerpoplawski-arch whickerpoplawski-arch commented Nov 1, 2026 •

Copy link
Copy Markdown

摘要

1. Responses 线路上 BILI_SUBAGENT_SPLIT=0 无效

文档写该开关关掉两套 subagent-split。其实机制 (2) 是 claudeSubagentSplit / anthropic order 路由,只跑在 anthropic 分支。Claude Code 走 /v1/responses 时由 instructionsFingerprintApplies() 判定——WIRE_CLIENTS → claude-responses 写死 instructionsFingerprintKeyed: true,没有配置面。

复现(单实例,只变 stableSystemAnchor):

probe 步骤 1 步骤 2 结果
3 6 轮,instructions="AAA" 2 轮不相交历史,"BBB-DIFFERENT" 分叉 → |sub:a18f208ecc433afe
4 6 轮,"SAME-SYS" 2 轮不相交历史,相同 instructions 不分叉(仅历史不相交不够)
5 同 3,但 stableSystemAnchor: true 同 3 不分叉

分叉条件是 tagChanged && !chainContinues。plain-proxy 车道若每轮系统提示都合法变化(改 CLAUDE.md、按轮注入 memory),会持续命中;主车道随后卡住,模型对同一 session 看到两份互相矛盾的 acp_status。

基于上游 HEAD e226544f556712e33f3ef1d9fe5b4dc2b7715e15(包版本 0.1.211)。

设计说明(请保留)

  1. personaSplit:false 也会关掉 codex 条目的指纹分键。 WIRE_CLIENTS → codex 同样带 instructionsFingerprintKeyed: true,走同一条 resolveWireClientProfile。这是有意的一键设计(共享指纹路径只留一个旋钮),不是疏漏。若需要「只关 Claude-over-Responses、保留 Codex 指纹」,请明确说;本 PR 不加第二套 per-client 开关。

  2. personaSplitOff 只传入 instructionsFingerprintApplies;claudeAnthropicPersonaOrderApplies 故意不接。 anthropic 的 persona / order 分叉仍归 subagentSplit。两个旋钮不要交叉——不要事后「补齐」把 personaSplitOff 接到 anthropic 路径。

config surface

变更

  • website/config-reference/server.yaml — personaSplit seed(与 subagentSplit 同形;满足 0.1.211 的 config-surface-guard)
  • src/server/lane-decisions.ts — personaSplitOff 信号;resolveWireClientProfile 在开启时剥掉 instructionsFingerprintKeyed(identity 及其他字段不变)。未改 WIRE_CLIENTS 字面量
  • src/config.ts — personaSplit 类型×2、归一化(BILI_PERSONA_SPLIT)、白名单
  • src/session-id.ts — wireClientSignals / instructionsFingerprintApplies 把 personaSplitOff 传到 registry resolve(调用点适配:构造在 helper 里,不是内联对象)
  • src/server/handle.ts — Responses 两处调用传入 opts.personaSplit === false
  • tests/lane-decisions-b-class.test.ts — claude-responses + codex 用例
  • CONFIGURATION.md / CONFIGURATION.zh-CN.md / website/main.js / website/docs/index.html — 已跑 node tools/gen-config-docs.mjs generate,提交 personaSplit / BILI_PERSONA_SPLIT 生成表行与站点文案
  • LIFECYCLE.md — §1 登记 BILI_PERSONA_SPLIT(与 BILI_SUBAGENT_SPLIT 同形)

测试计划

  • npm test:相对基线无新增失败(基线本身约 12 个既有失败;补 yaml seed 后未重跑全量——聚焦 config-surface-guard + lane-decisions-b-class 已绿)
  • 新用例:personaSplitOff 剥指纹、保留 identity
  • 新用例:codex 条目同样尊重该开关
  • 聚焦:node --import ./tests/preload-test-env.mjs --import tsx --test tests/lane-decisions-b-class.test.ts
  • 手工 / repro.sh probe-3/4/5(云端未跑,待本地 bili 实例验证)
  • docs-sync:生成产物已提交
  • lifecycle-ledger-guard:BILI_PERSONA_SPLIT 已入账

说明

server.yaml 已有 personaSplit seed,与 subagentSplit 并列,以便 config-surface-guard 在 0.1.211 上通过。

白名单 KNOWN_TOP_LEVEL_KEYS 已含 personaSplit;config-surface-guard 不覆盖该白名单(只比对 config.ts leaf ↔ yaml seed)。不要把 guard 绿当成白名单已同步的证明。

生成表已随本 PR 提交(不再延期);请维护者按仓库惯例跑 node tools/gen-config-docs.mjs generate 复核即可。

Closes: #5456

Add personaSplit / BILI_PERSONA_SPLIT so operators can strip
instructionsFingerprintKeyed at resolveWireClientProfile without
mutating WIRE_CLIENTS literals. Keeps identity; seeds config-surface
yaml for 0.1.211 guard.
@ranxianglei ranxianglei changed the title fix: personaSplit to disable Responses instructions fingerprint keying [PR] fix: personaSplit to disable Responses instructions fingerprint keying Nov 1, 2026
@whickerpoplawski-arch whickerpoplawski-arch changed the title [PR] fix: personaSplit to disable Responses instructions fingerprint keying fix: 用 personaSplit 关闭 Responses 的 instructions 指纹分叉 Nov 1, 2026
Commit generated CONFIGURATION / website rows for personaSplit and
register BILI_PERSONA_SPLIT in LIFECYCLE.md §1 next to BILI_SUBAGENT_SPLIT
so docs-sync and lifecycle-ledger-guard pass.
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

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

查重: 不重复。检索了 open+closed issue/PR(personaSplit / BILI_SUBAGENT_SPLIT / subagent-split / instructions fingerprint):已有相关工作只有 #4352 → PR #4409/#4774(header-less claude code subagent 按顺序路由分叉,即机制 2),与本 PR 针对的机制(机制 1:claude-responses wire-client 条目硬编码 instructionsFingerprintKeyed:true、无配置面)不同;症状也不同(#4352 是"该分叉没分叉",本 PR 是"开关对机制 1 不生效导致不该分叉时持续分叉")。配套文档 PR #5452 将一并核对。

标签: bug, claude-code, codex, scope/wiring, p2 —— 配置开关按文档承诺失效 → 特定条件下(Responses 线路 + system prompt 逐轮变化)会话持续分裂冻结主车道;有绕行(stableSystemAnchor),属"能用但有明显问题"。

开始审核:拉取分支 diff,对照基线 e226544 逐项验证正文字节级声明,跑定向测试与 CI 状态,随后按八问给结论。

@ranxianglei

Copy link
Copy Markdown
Owner

ework review

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

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

PR #5453 审核完成。结论:代码可合——方向对、默认行为逐字节不变、定向测试全绿;审核中发现的 6 处问题已全部在 PR 分支上修掉并标注 commit,分支已同步到最新 master(mergeable=true,"blocked" 仅因 fork 的 CI checks 未放行)。

结构化八问

  1. 是什么问题:Claude Code 走 /v1/responses(Responses 线路)时,系统提示逐轮合法变化(CLAUDE.md 编辑、逐轮记忆注入)会让主会话持续分裂到 |sub:<fp> 幽灵车道——主车道冻结,同一会话出现两份互相矛盾的 acp_status。BILI_SUBAGENT_SPLIT=0 管不到这条路径。
  2. 什么原因导致的:WIRE_CLIENTS 注册表(src/server/lane-decisions.ts)在 claude-responses/codex 两个条目上硬编码 instructionsFingerprintKeyed:true,没有任何配置面;而 BILI_SUBAGENT_SPLIT 只门控 anthropic 线路的两套机制(文档也只承诺那两套)。报告人"文档说关掉两套就都关"的前提略有偏差——真实缺口是这套第三分叉机制既无开关也无文档。
  3. 影响范围与严重程度:特定条件触发(Responses 线路 + 系统提示逐轮变);有绕行(stableSystemAnchor:true)。p2。
  4. 怎么修复的:新增 personaSplit 开关(默认开,默认行为不变),在 profile 解析期剥掉 instructionsFingerprintKeyed——claude-responses 与 codex 共用同一条解析路径,一个键管住两处,identity 等其余字段不动;handle.ts 两处调用点一致接线;文档/LIFECYCLE/白名单全同步。
  5. 是否有回归问题:审过的既有行为逐项——① 默认路径:归一化逻辑 + 「未 opt-out 时返回字面量 profile」推理 + 含 codex 线 responses 身份仍走 instructions-hash subagentNamespace:同 id 下 instructions 中途变更会 fork 主 lane 丢压缩(#2241 同款暴露,未审计) #2250 e2e 连续车道的定向测试全绿,byte-identical;② dsh persona / stableSystemAnchor / codexTurn 分支优先级不受影响;③ anthropic 线路故意不接(personaOrderKeyed 是 anthropic-wire-only 字段,不接收该信号——作者设计注记 2,保留);④ designNamespaced canary 打戳一致;⑤ lane-decisions-matrix 源码级守卫通过;⑥ 合并最新 master 后复验:typecheck 干净、131/131 定向测试、docs 生成器字节级 drift 干净。无回归。
  6. 是否破坏缓存:不涉及(仅改会话 id 路由;opt-out 用户的前缀缓存稳定性反而改善)。
  7. 是否改了设计方向:没有——沿用 LIFECYCLE.md「每机制一个 kill-switch」的既有惯例。
  8. 是否引入了新的配置:personaSplit(默认 true)+ env BILI_PERSONA_SPLIT(env 优先)——已在 PR body 补「config surface」节披露(为何既有开关表达不了、考虑过哪些替代、兼容故事)。

行为变更披露(old→new)

设置 BILI_PERSONA_SPLIT=0 / personaSplit:false 后:claude-responses 与 codex 两条车道的 instructions 指纹分叉失效 → 回退 verbatim 身份(用户主动放弃 #150/#970 的 disjoint-blob 保护,换取主车道不再分裂)。未设置时与旧行为逐字节一致。 codex 被一并纳入是有意的「共享路径一个键」设计(作者设计注记 1,按原样保留)。

审核发现与处置(全部已修,commit 独立标注)

  1. 4 处 #XXXX 未填占位符 → 补为 issue 引用(commit 67edd14c2);
  2. 门控缺负向行(Test Blind Spot Retrospective: Reinforcing Negative Assertion Discipline, Tightening Fake Upstream Strictness, Thin Inst | 测试盲区复盘:补反向断言纪律、假上游严格化、薄安装冒烟、形态矩阵与生命周期覆盖 #3617 纪律)→ 补「匿名/非 keyed 客户端不受影响」测试(a50ced835);
  3. src/server.ts:117 遗留死 import(既有,非本 PR 引入)→ 移除(0b8fdb2b7);
  4. PR body 缺「config surface」节(repo 规则:动配置面的 PR 必须带)→ 已 patch 进 PR body;
  5. PR 无关联 issue → 已立 Claude-over-Responses lane keeps forking the main session onto |sub:<fp> when the system prompt changes every turn; BILI_SUBAGENT_SPLIT=0 does not stop it #5456(带来源标记 + 查重声明),PR body 改为 Closes: #5456;
  6. master 审核期间前移约 15 个 PR、触碰本 PR 全部文件 → 已合并最新 master,冲突仅 CONFIGURATION.md/zh-CN 各一处表行,union 解决(保留 master 侧 subagentSplit 作用域注记行 + 新增 personaSplit 行),生成器复核字节级干净。

配套文档 PR #5452 已在 master(subagentSplit 的 Responses 作用域说明),与本 PR 互补不重复。

CI 状态

fork PR 上所有 checks 均 skipped(fork 未授权 Actions),远端判定暂不可得;本地证据如上(typecheck + 131/131 定向测试 + 四个 CI guard 脚本全绿)。需你批准 fork 的 Actions 后 CI 才会跑。

收工判定:可合。建议:批准 fork Actions 看 CI 转绿后由你合并(合并权在你)。

@ranxianglei ranxianglei left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

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

独立审核结论(对 diff 与行为重新过了一遍,未沿用前轮审核表述):APPROVE。

结构化八问

  1. 是什么问题:Responses 线路上,Claude Code(及走 instructions 指纹的 Codex 根线程)在「每轮 instructions 文本变化 + 入站历史不连续」时,会话被 instructions 指纹分叉到独立的 <id>|sub:<fp> 会话——主车道冻结、模型流量跑在分叉车道上、acp_status 同时呈现两套矛盾状态。现有的 BILI_SUBAGENT_SPLIT=0 只覆盖 anthropic-wire 机制,管不到这条路径,用户没有任何开关可关。
  2. 什么原因导致的:WIRE_CLIENTS 注册表里 claude-responses / codex 两个条目硬编码 instructionsFingerprintKeyed: true,而 resolveWireClientProfile 没有配置入参——指纹分叉无条件生效;subagentSplit 只穿到 anthropic-wire 的 order resolver,没穿到 responses-lane 的判定调用点。症状(主车道冻结)是「无开关」这一根因的表现。
  3. 影响范围与严重程度:走 /v1/responses 的 Claude Code 纯代理用户 + 不带 turn-metadata 的 Codex 根线程;触发条件 = 宿主逐轮改写 system/instructions(CLAUDE.md 编辑、记忆注入等合法行为)且历史不连续。严重度:模型流量仍在分叉车道上正常压缩,主车道冻结漂移、状态视图分裂——能用但明显降级,且有 stableSystemAnchor: true 绕行 → p2 成立。
  4. 怎么修复的:新增顶层布尔 personaSplit(默认 true)+ env BILI_PERSONA_SPLIT(env 优先),归一化形状与 subagentSplit 完全一致;personaSplitOff 穿到 resolveWireClientProfile 解析阶段,对命中的 registry 条目剥掉 instructionsFingerprintKeyed 再返回(WIRE_CLIENTS 字面量不动,单一投影点保留),handle.ts 两处调用点传 opts.personaSplit === false。刻意不穿进 claudeAnthropicPersonaOrderApplies——anthropic-wire 的 persona/order 分叉仍归 subagentSplit 管,边界清晰,符合 PR 设计注记 2。
  5. 是否有回归问题(逐项清点审过的既有行为):
    • 默认路径(未设 / true):resolveWireClientProfile 原样返回字面量 profile 引用 → 判定结果与改动前逐字节一致,零漂移 ✅;
    • instructionsFingerprintApplies 的全部消费者只有 handle.ts 两处(responses-lane 路由三元链 + designNamespaced canary stamp),grep 审计确认无其他消费点;三元链中排在前面的分支(codexTurn verbatim、dsh plugin lane、stableSystemAnchor)不受本开关影响 ✅;
    • personaOrderKeyed(anthropic-wire order resolver、ccTitleSidecar)不接此 flag,行为不变 ✅;
    • 配置归一化与 BILI_SUBAGENT_SPLIT 同形(含同样的约定:env 字符串 "false" 计为 ON,仅 "0" 关)——与兄弟键一致,非新引入的行为 ✅;
    • 本地验证(PR head):docs-sync / coverage / config-surface-guard / lifecycle-ledger-guard 全绿;lane-decisions-b-class + matrix + config-surface-guard 测试 112/112;相邻回归集(claude-subagent-split、issue4352、dsh-persona-fingerprint、dsh-persona-continuity、proxy-session-id、issue3397)58/58;tsc --noEmit 干净。全量套件以远程 CI 为准;
    • 高危模式逐项过:无语义漂移(默认逐字节一致)、无 fail-fast 变吞错、无阈值/时序/输出格式变化、无缓存/重试策略静默失效 ✅。
  6. 是否破坏缓存:否。默认路径不动任何 session 键计算与前缀字节;显式关闭后受影响会话从 <id>|sub:<fp> 回落到原始 id——那是用户主动放弃 disjoint-blob 保护(#150/#970),PR 正文已明确披露该取舍。
  7. 是否改了设计方向:否。单一投影判定架构(#3236 纪律)保持;开关进的是 profile 解析阶段而非各消费点加分支;一个旋钮覆盖共享同一指纹机制的两个条目(Codex 有意并入,PR 设计注记 1 声明,未加第二个 per-client 旋钮)。
  8. 是否引入了新的配置:是——顶层 personaSplit:boolean,默认 true,env BILI_PERSONA_SPLIT(0 关闭,env 优先)。迁移方式:无需迁移(默认保持旧行为)。PR 正文带必需的 config-surface 小节(既有表面为何表达不了、考虑过的替代、兼容故事);yaml seed / CONFIGURATION.md en+zh / env→key 映射表 / LIFECYCLE.md §1 / website 文案全部同步,守卫验证通过。

测试有效性

新增 3 个测试覆盖正向(claude-responses 剥离、codex 剥离)+ 负向(匿名客户端不受影响、wrapper 级 flag true/false 双向断言)——#3617 门纪律满足;断言打在最终解析值(identity + keyed)上,此类回归能被抓到。

diff 整洁度

12 文件 +105/-8,每行都服务于本 PR 目的(代码 + 生成文档 + seed + 台账 + 测试);含一个有标注的顺手清理 commit(移除既有死导入,0b8fdb2b7)。version 字段未动、kernel/ 未动、无 lockfile 连带变更。

CI

撰写时镜像缓存(sha 27b262d):0 failed,8 个 guard job queued(version-guard / config-surface-guard / lane-guard / unused-exports / plan / pi-subagents-guard / docs-sync / lifecycle-ledger-guard),7 success,15 skipped(e2e 车道);其中四个零依赖 guard 已在当前树本地复跑全绿。fixup 推送后的新 head 待 CI 重跑确认。

已顺手修:personaSplit 在 CONFIGURATION.md / src/config.ts JSDoc 的描述原文只提 "Claude-over-Responses" 车道,与代码事实不符(Codex 条目同样被剥离,见 PR 设计注记 1)——描述补全点名两条受影响的 Responses-wire 车道(yaml seed + 两处 JSDoc + 重新生成的文档),+ commit 7712498。

收工判定:可合。 代码、测试、文档与配置面纪律全部通过;合并按钮留给 owner(fork 侧 CI 授权仍在等,全量绿以新 head 重跑结果为准)。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

PR #5453 review 完成:已提交 GitHub APPROVE(review id 5755421579,八问体例)。审核独立重做:默认路径逐字节一致、消费点审计干净、kernel 未触碰;本地 guard×4 + 测试 112+58 + typecheck 全绿。顺手修 1 处文档措辞与代码事实不符(personaSplit 描述漏点名 Codex 车道)→ commit 7712498 已推 PR 分支,新 head 待 CI 重跑。

@ranxianglei ranxianglei left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

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

对新 head 77124986f 的复审(增量审核;端到端全量审核见上一轮 APPROVE,本轮核 delta + CI):APPROVE(最终 head 上刷新批准)。

与上一轮的 delta

仅一个新增 commit,即我上一轮审核时顺手推的文档措辞修复(77124986f):personaSplit 描述补全点名两条受影响的 Responses-wire 车道(yaml seed desc_en/desc_zh + src/config.ts 两处 JSDoc + CONFIGURATION.md/zh-CN 重新生成的参数表两行)。纯文档措辞,零代码/语义/测试变更。作者未新增任何 commit;master 仍为 9dc4c94,PR 完全最新、无需 rebase。

本地在恰好该树(HEAD==77124986f)复跑:docs-sync / coverage / config-surface-guard / lifecycle-ledger-guard 全绿;lane-decisions-b-class + matrix + config-surface-guard 测试 112/112;config.ts import smoke OK。

结构化八问(delta 视角)

  1. 是什么问题:同前——Responses 线 instructions 指纹分叉无开关;本轮无新问题。
  2. 什么原因导致的:不变(registry 硬编码 keyed + resolver 无配置入参)。
  3. 影响范围与严重程度:不变(p2;默认行为逐字节一致)。
  4. 怎么修复的:不变;本轮只把文档措辞改对(描述原文漏点名 Codex 车道,与代码事实及 PR 设计注记 1 不符)。
  5. 是否有回归问题:本轮 diff 只碰注释/seed/生成表格——零运行时面;上一轮清点过的既有行为全部原样保持。✅
  6. 是否破坏缓存:否(不变)。
  7. 是否改了设计方向:否(不变)。
  8. 是否引入了新的配置:本轮无新增;personaSplit(默认 true)/ BILI_PERSONA_SPLIT 表面不变,描述现在正确覆盖 Codex 车道。

CI(镜像缓存 @ 7712498)

total 30 / failed 0 / pending 6(mysql-contract、config-surface-guard、lock-sync、version-guard、lifecycle-ledger-guard、kernel-guard),其余全部 success/skipped(含全部 test 车道与上一轮排队的 5 个 guard)。pending 中 config-surface-guard / lifecycle-ledger-guard 已在当前树本地复跑绿。若剩余 job 出异常按 #4599 流程处置。

收工判定:可合。 最终 head 验证通过,合并按钮留给 owner。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

PR #5453 第二轮 review(head 7712498)完成:delta 仅为上一轮自己的文档措辞 fixup,作者无新 commit、master 未动;本地在最终树复跑 guard×4 + 测试 112/112 全绿;镜像缓存 total 30 / failed 0 / pending 6(均为收尾 guard job)。已重新提交 GitHub APPROVE(review id 5755928298,刷新最终 head 上的批准)。判定:可合。

@ranxianglei
ranxianglei merged commit fb3ee1c into ranxianglei:master Nov 4, 2026
55 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants