Repository navigation
[PR] fix: use personaSplit to disable the instructions fingerprint fork in Responses | fix: 用 personaSplit 关闭 Responses 的 instructions 指纹分叉 - #5453
Conversation
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.
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.
(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 状态,随后按八问给结论。 |
|
ework review |
…unfilled #XXXX placeholders)
…ts (pre-existing dead import left by the handle.ts split)
# Conflicts: # CONFIGURATION.md # CONFIGURATION.zh-CN.md
(ai: vllm-qwen/qwen3.8-27b) PR #5453 审核完成。结论:代码可合——方向对、默认行为逐字节不变、定向测试全绿;审核中发现的 6 处问题已全部在 PR 分支上修掉并标注 commit,分支已同步到最新 master(mergeable=true,"blocked" 仅因 fork 的 CI checks 未放行)。 结构化八问
行为变更披露(old→new)设置 审核发现与处置(全部已修,commit 独立标注)
配套文档 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
left a comment
There was a problem hiding this comment.
(ai: vllm-qwen/qwen3.8-27b)
独立审核结论(对 diff 与行为重新过了一遍,未沿用前轮审核表述):APPROVE。
结构化八问
- 是什么问题:Responses 线路上,Claude Code(及走 instructions 指纹的 Codex 根线程)在「每轮 instructions 文本变化 + 入站历史不连续」时,会话被 instructions 指纹分叉到独立的
<id>|sub:<fp>会话——主车道冻结、模型流量跑在分叉车道上、acp_status 同时呈现两套矛盾状态。现有的BILI_SUBAGENT_SPLIT=0只覆盖 anthropic-wire 机制,管不到这条路径,用户没有任何开关可关。 - 什么原因导致的:
WIRE_CLIENTS注册表里claude-responses/codex两个条目硬编码instructionsFingerprintKeyed: true,而resolveWireClientProfile没有配置入参——指纹分叉无条件生效;subagentSplit只穿到 anthropic-wire 的 order resolver,没穿到 responses-lane 的判定调用点。症状(主车道冻结)是「无开关」这一根因的表现。 - 影响范围与严重程度:走
/v1/responses的 Claude Code 纯代理用户 + 不带 turn-metadata 的 Codex 根线程;触发条件 = 宿主逐轮改写 system/instructions(CLAUDE.md 编辑、记忆注入等合法行为)且历史不连续。严重度:模型流量仍在分叉车道上正常压缩,主车道冻结漂移、状态视图分裂——能用但明显降级,且有stableSystemAnchor: true绕行 → p2 成立。 - 怎么修复的:新增顶层布尔
personaSplit(默认 true)+ envBILI_PERSONA_SPLIT(env 优先),归一化形状与subagentSplit完全一致;personaSplitOff穿到resolveWireClientProfile解析阶段,对命中的 registry 条目剥掉instructionsFingerprintKeyed再返回(WIRE_CLIENTS 字面量不动,单一投影点保留),handle.ts 两处调用点传opts.personaSplit === false。刻意不穿进claudeAnthropicPersonaOrderApplies——anthropic-wire 的 persona/order 分叉仍归subagentSplit管,边界清晰,符合 PR 设计注记 2。 - 是否有回归问题(逐项清点审过的既有行为):
- 默认路径(未设 / 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 变吞错、无阈值/时序/输出格式变化、无缓存/重试策略静默失效 ✅。
- 默认路径(未设 / true):
- 是否破坏缓存:否。默认路径不动任何 session 键计算与前缀字节;显式关闭后受影响会话从
<id>|sub:<fp>回落到原始 id——那是用户主动放弃 disjoint-blob 保护(#150/#970),PR 正文已明确披露该取舍。 - 是否改了设计方向:否。单一投影判定架构(#3236 纪律)保持;开关进的是 profile 解析阶段而非各消费点加分支;一个旋钮覆盖共享同一指纹机制的两个条目(Codex 有意并入,PR 设计注记 1 声明,未加第二个 per-client 旋钮)。
- 是否引入了新的配置:是——顶层
personaSplit:boolean,默认true,envBILI_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
left a comment
There was a problem hiding this comment.
(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 视角)
- 是什么问题:同前——Responses 线 instructions 指纹分叉无开关;本轮无新问题。
- 什么原因导致的:不变(registry 硬编码 keyed + resolver 无配置入参)。
- 影响范围与严重程度:不变(p2;默认行为逐字节一致)。
- 怎么修复的:不变;本轮只把文档措辞改对(描述原文漏点名 Codex 车道,与代码事实及 PR 设计注记 1 不符)。
- 是否有回归问题:本轮 diff 只碰注释/seed/生成表格——零运行时面;上一轮清点过的既有行为全部原样保持。✅
- 是否破坏缓存:否(不变)。
- 是否改了设计方向:否(不变)。
- 是否引入了新的配置:本轮无新增;
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。
摘要
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):instructions="AAA""BBB-DIFFERENT"|sub:a18f208ecc433afe"SAME-SYS"stableSystemAnchor: true分叉条件是
tagChanged && !chainContinues。plain-proxy 车道若每轮系统提示都合法变化(改 CLAUDE.md、按轮注入 memory),会持续命中;主车道随后卡住,模型对同一 session 看到两份互相矛盾的acp_status。基于上游 HEAD
e226544f556712e33f3ef1d9fe5b4dc2b7715e15(包版本0.1.211)。设计说明(请保留)
personaSplit:false也会关掉codex条目的指纹分键。WIRE_CLIENTS→codex同样带instructionsFingerprintKeyed: true,走同一条resolveWireClientProfile。这是有意的一键设计(共享指纹路径只留一个旋钮),不是疏漏。若需要「只关 Claude-over-Responses、保留 Codex 指纹」,请明确说;本 PR 不加第二套 per-client 开关。personaSplitOff只传入instructionsFingerprintApplies;claudeAnthropicPersonaOrderApplies故意不接。 anthropic 的 persona / order 分叉仍归subagentSplit。两个旋钮不要交叉——不要事后「补齐」把personaSplitOff接到 anthropic 路径。config surface
personaSplit(默认true)+ envBILI_PERSONA_SPLIT(env 优先),归一化与既有subagentSplit/BILI_SUBAGENT_SPLIT同形;已同步KNOWN_TOP_LEVEL_KEYS白名单、website/config-reference/server.yamlseed、CONFIGURATION.md/zh-CN 参数表与 env→key 映射、LIFECYCLE.md §1 账本、website 站点文案。BILI_SUBAGENT_SPLIT语义绑定「Claude Code subagent」,只门控 anthropic 线路两套机制;本缺陷路径是 wire-client 注册表的instructionsFingerprintKeyed(claude-responses + codex 共享,Codex 集成:guardian 审批请求进入压缩管线,导致明确授权无法被识别 #150/Subagent first token stalls 1-2min: withSessionLock covers full forward + slow flash upstream first byte #970)。把它并入BILI_SUBAGENT_SPLIT= 对一个以 Claude subagent 命名的键做 re-semantics,会悄悄改变 codex 根线程的键控——比新增一个同形旋钮更危险。其余现有机制(providers 表、compress 三层级、per-client 第二开关)均不匹配该维度;共享指纹路径只留一个旋钮是有意设计(见设计说明 1)。true时行为逐字节不变;仅显式=0/false才改变行为:claude-responses 与 codex 条目失去 instructions 指纹键控、回到 verbatim 身份(用户主动放弃 Codex 集成:guardian 审批请求进入压缩管线,导致明确授权无法被识别 #150/Subagent first token stalls 1-2min: withSessionLock covers full forward + slow flash upstream first byte #970 的分叉保护,换取主车道不再被合法的系统提示变化分叉)。行为变更 old→new 已在审核回复中披露。变更
website/config-reference/server.yaml—personaSplitseed(与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 === falsetests/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剥指纹、保留 identitynode --import ./tests/preload-test-env.mjs --import tsx --test tests/lane-decisions-b-class.test.tsrepro.shprobe-3/4/5(云端未跑,待本地 bili 实例验证)docs-sync:生成产物已提交lifecycle-ledger-guard:BILI_PERSONA_SPLIT已入账说明
server.yaml已有personaSplitseed,与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