Repository navigation
[PR] Claude subagent parallel homogeneous dispatch merge: SubagentStart hook injects a unique lane token per dispatch (#5095) | claude 子代理并行同型派发合流:SubagentStart hook 注入每次派发唯一 lane token(#5095) - #5184
Conversation
📦 Built Package ArtifactBranch: Latest build — install this exact versionnpm install -g billion-context@0.0.7272-pr.5184.a6a5751This exact version is immutable and reproducible. The rolling Recent builds (commit → version)
Download artifact
tar xzf billion-context-pr5184.tgz
npm install -g packageInstall instructions are refreshed on each push. |
|
(ai: sglang-gpu0/qwen3.8-27b) CI 状态说明(2026-10-30 02:2xZ 更新)本 PR 自己造成的失败已修完: 剩余的 test 分片红不是本 PR 引入的。失败的是固定一组测试( 本 PR 相关文件所在的分片(包括跑过 |
392721d to
6f800f2
Compare
(ai: vllm-qwen/qwen3.8-27b) Merge guard ping resolved without a push from my side: while I was merging master ( |
(ai: vllm-qwen/qwen3.8-27b) Merge guard ping resolved: branch was already up-to-date with master ( |
ranxianglei
left a comment
There was a problem hiding this comment.
审查结论:代码通过,等 CI 转绿后可合并(不申请 auto-merge,§7.4)
问题:VS Code 扩展版 Claude Code 的子代理不带 agent-id 头、骑着父会话 id 走。#4774 用 system 文本指纹分车道,但并行派发同一类型的子代理(system 文本相同 → 指纹相同)全部挤进同一条车道,互相串内容、折叠互相干扰。
根因:解析器对无头子代理流量的键是 <rawId>|sub:<fp16(指纹)>,这个映射只对"类型"单射、不对"每次派发"单射;线上又没有任何能区分两次派发的量(msgid 无、头无、metadata.user_id 父子同值),所以同型并行必然合流。
修法核验(逐项):
- ✅ token 分支在 src/session-resolve.ts:234(
isClaudeLaneToken守卫后)于所有启发式之前短路返回,键<rawId>|sub:<fp>:t:<token>——每次派发唯一;且不读裸 id 骨架、不认领裸 key,顺带杀掉 virgin-id 上的 #2156 式抢注竞态(测试里有"子代理先到、主会话后到仍能认领裸 id"的验证行)。 - ✅ 零回归面成立:非法 token 被 src/claude-lane-token.ts:25 的语法校验拒绝回落;无 token 路径字节级不变,两个端到端负例锚定了旧合流形态不变。
- ✅ 提取器(src/session-id.ts
claudeSubagentLaneTokenOf)只扫第一条 user 消息:用户把标记粘到后续消息不会误分叉主会话(有负例);图像块/退化形状安全。 - ✅ 安装面(src/plugin-install.ts):用户自有 SubagentStart 条目永不触碰(有测试);重钉路径有
fs.existsSync守卫,升级中途不会烤死指向不存在文件的命令;剥离与安装对称。 - ✅ 无泄漏:skeleton 存储有界(MAX_ORDER_ENTRIES=1024 LRU + 8MB,src/order-persist.ts:29),token 车道不会无限增长。
- ✅ 测试符合 #3617 门禁纪律:正反两向齐全,核心修复点(同型并行两 token 不同键)和文档化缺口(无 token 仍合流)都有锚定。
参考:本地定向跑了新文件 + 相邻回归(issue4352 / claude-subagent-split / hook-command)共 27 用例全绿;PR 自述 claude-native 4 个失败为本地端口区环境噪音(干净 HEAD 同样失败),最终以 CI 为准。
两个非阻塞小发现(可不改合并)
- 入口自检写法与同类入口不一致:src/claude-subagent-hook.ts 用
process.argv[1].includes("claude-subagent-hook"),而 kimi/bootstrap-hook.ts:52、zcode/bootstrap-hook.ts:55、claude-native-bootstrap.ts:588 都是正则锚定文件名结尾(如/(?:^|[\\/])bootstrap-hook\.(?:ts|js)$/)。.includes()在任何 argv 路径包含该子串时也会误触(例如仓库 checkout 在名叫…claude-subagent-hook…的目录下时,模块被 import 也会执行 main)。实际风险极低,改成同型正则即可一了百了。 - 边角:如果用户把自己的第一条消息粘贴成含
bili-lane-token:<12位小写hex>的内容,整个主会话会被键到该 token 车道上(该会话压缩连续性受损,直到首条消息被折叠才恢复)。概率极低、仅自伤(键含自己的 rawId,无跨会话影响),可在 README「已知边界」补一行注释即可。
[bot] 🏷 (ai: vllm-qwen/qwen3.8-27b) Merge-guard follow-up check: re-verified via GitHub API that PR #5184 is still |
[bot] 🏷 (ai: vllm-qwen/qwen3.8-27b) Correction to my previous line: the merge commit is |
(ai: vllm-qwen/qwen3.8-27b)
Fixes #5095
什么坏了
#4774(v0.1.209)把无 agent-id 头的 Claude Code 子代理(VS Code 扩展构建)从父会话裸 key 上分到
|sub:<fp16(system)>车道。但并行派发同一类型的子代理(同一 system 文本 → 同一指纹)全部合流到这一条车道:无关会话互相串内容、折叠互相干扰(#5095 实测时间线)。指纹只对「类型」单射,不对「派发」单射。方案(D1-C,方案讨论见 issue 评论)
bili 托管 settings 新增一个 SubagentStart hook(
dist/claude-subagent-hook.js,与现有 SessionStart bootstrap 同安装通道):每次子代理启动铸一个 12 位十六进制随机 token,以additionalContext(bili-lane-token:<hex>)注入该次派发的上下文。token 随派发自己的首条 user 消息上线;解析器读到 token 就确定性地键控到<rawId>|sub:<fp16(tag)>:t:<token>——每次派发唯一,并行同型派发天然分道。token 不在(未升级安装/首条消息被折叠后/其他宿主)时精确回落现行 #4774 行为,零回归面。改动
src/claude-lane-token.ts(新):token 语法单一来源(mint/校验/提取,零依赖,被 hook 入口与代理侧共同内联)。src/claude-subagent-hook.ts(新,tsup 入口):SubagentStart hook——读空 stdin、铸 token、输出{hookSpecificOutput:{hookEventName:"SubagentStart",additionalContext:...}};任何错误静默 exit 0,绝不打断用户子代理启动。src/session-resolve.ts:resolveSessionOrder/personaConversationOrder新增可选laneToken;token 有效时在最前面确定分叉(不读骨架、不认领裸 key——同时杀掉 virgin-id 上的 [bug] dsh:side request 先到会抢走 persona 锚点,主会话被 fork 到 |sub:<fp>,原生 compress 永久失败 #2156 式抢注竞态),非法 token 被消毒拒绝。src/session-id.ts:claudeSubagentLaneTokenOf(messages)——只扫第一条 user 消息(string / text 块,system-reminder 包裹无所谓);用户把标记粘到后续消息不会误分叉主会话。src/server/handle.ts:Subagent requests share the parent session id and trip fold-reconcile #4352 分支(personaOrderKeyed 车道)传入第 5 参;其余车道零改动。src/plugin-install.ts:托管块安装/重钉/剥离 SubagentStart 钩子(与 SessionStart 同isOurs纪律;用户自己的 SubagentStart 条目永不触碰;repin只在 dist 文件存在时写,升级中途不烤死命令)。tsup.config.ts、reference/architecture.md、README.md/README.zh-CN.md(zh/en 同步)。测试
tests/issue5095-subagent-lane-token.test.ts(7 用例,正反两向 #3617):相邻面:
issue4352、claude-subagent-split、hook-command全绿;claude-native4 个失败为本地端口区粘滞环境噪音(干净 HEAD 同样失败,CI 隔离环境绿)。typecheck + build 绿;独立脚本实测(echo … | node dist/claude-subagent-hook.js→ 合法 JSON、exit 0、空 stdin 安全)。config surface
无新增用户配置键。受管 settings 块(
bili plugin install claude写入的hooks.*)新增一条SubagentStart条目——属安装面而非billion-context.jsonschema;卸载随受管块一并移除。现存机制已穷尽:该判别量线上不存在(msgid 无、头无、metadata.user_id父子同值),只能 bili 自铸;通道复用现有 SessionStart 同构安装通道(#5051 receipt 先例)。已知边界
-p模式 hooks 不触发(SDK 模式 GrowthBook 关闭)——但受害人群是扩展构建,不阻塞。真机回归留待 reporter 验证(Claude Code sub-agents of the same type share a single compaction lane: unrelated sessions bleed content into each other | Claude Code 同类型子代理共用一条压缩车道:无关会话互相串内容、折叠暂停;旧版共享父 id 的折叠块升级后仍残留在父会话 #5095 线程跟进)。审查提示
触及会话身份/车道键(§7.4 must-stay-human):不申请 auto-merge,人工审查合并。