子代理窗口谁来压
模块:子代理 / 上下文压缩(
internal/runengine/)| 状态:已落地(ceecc28,2026-10-17)| 证据:doc/25-子代理折叠.md、tmp/17-子代理折叠/planning.md、commitceecc28/496d54d
1. 场景与病灶
用户让 researcher 连着搜读四五份长材料,它在自己的 ReAct 循环里一轮轮调工具,主线程只等终稿。
子代理是独立实例、独立窗口。主 run 的折叠链挂在主 run 的 handler 上,管不到子代理进程内的消息列表。于是子代理的窗口先满:下一次模型调用被 provider 以「上下文超长」拒收,委派错误原样上抛,整场 run 变成 error。用户看到的是「失败」,不是报告。
旧结论(19v6-10)写的是「子代理内部不压」,理由是「跑完即弃、回传有上限、摘要没有下一个读者」。这个理由在单轮短任务下成立;在「多轮长材料」这个真实场景里,下一个读者出现了——就是子代理自己的下一次模型调用。
2. 候选与代价
| 候选 | 做法 | 好处 | 代价 |
|---|---|---|---|
| A 不压 | 沿用 19v6-10 | 零改动,子代理跑完即弃 | 多轮任务必死于窗口溢出 |
| B 进程内折叠 | 在子代理装配点挂 agentFoldHandler,只重写 state.Messages |
交终稿前自行压短,父 run 保持 complete;主线程形状不变 | 要复刻主链的「估/折/滤」;摘要套摘要;必须无状态 |
| C 落进主 run 的 mh 再压 | 复用主 run 的落库链 | 坐标不丢、可审计 | 污染主 run 投影;子代理摘要会被 UPSERT 成主 run 的 seq=0,主线程形状被改写(doc 明令不做) |
裁定:B。 只压子代理进程内那份列表,不往 run_model_messages 插行、不占主 run 的坐标。
3. 同族小裁定
| 小问题 | 裁定 | 代价 / 备注 |
|---|---|---|
| 用主 run 同一条链还是给子代理单开窗口? | 复用主 run 同一条链:同一 counter、同一把 compactLimit、同一摘要器、同一份 fileEffects |
子代理窗口不能独立调;压测窗必须高于 root 全场用量。好处是零新旗标、行为不分叉 |
| 折叠产物落库吗? | 不落,明确接受「摘要套摘要」 | 主线程形状不变、runlog 工具行不动;代价是下一次折叠把上次摘要当普通历史再摘一遍,只影响终稿措辞密度 |
| handler 能持有每委派状态吗? | 不能:base 行、上一轮计数、上一次摘要都不许存字段 | eino ToolsNode 默认并行,同名委派共享同一个 handler 实例;字段必串。每次委派唯一属于自己的东西是 ADK 传进来的 state |
| 折叠失败或 provider 溢出,杀整场 run 还是降级? | 都转成错误文本当委派结果 | 父 run 保持 complete,主线程还能继续;手动停止的 ctx 取消仍裸上抛(那是真的要停,转文本会骗模型继续干活) |
| 滤思考和 Usage 触发跟折叠同一拍吗? | 同一拍,三步一起做(估 → 折 → 滤),验收分主次 | 只做折叠会留下「每枪重发思考 + 每轮全量 BPE 重数」两个已知病灶;A1 diff 超 80 行目标被明确接受 |
| 子代理中间态要不要为崩溃恢复落盘? | 本拍不落;后来由 doc/39 只落「完整跑完」的档案供 resume | 分界线不是「文件 vs 数据库」,是「谁裁决多副本并发」 |
4. 证据
- 方案:
doc/25-子代理折叠.md§1(要解决的事)、§2(怎么压:估/折/滤)、§3(错误形状)、§4(middleware 无状态)、§5(摘要套摘要)、§6–§7(eino #1177 与处置表)、§8(明确不做)。 - 台账:
tmp/17-子代理折叠/planning.md§1–§2(病灶)、§3(两个新事实)、§4 D1/D2/D5 与两条禁令、§11(参考实现对照)。 - 代码:
midfold.go的agentFoldHandler.BeforeModelRewriteState(估、折、滤同一入口)、stripReasoning、usageBasedInput;agents.go的newAgentFoldHandler装配点。 - 复核命令:
grep -n "func (h \*agentFoldHandler)\|func stripReasoning\|func usageBasedInput" yk-tako-eino/internal/runengine/midfold.go。
5. 现状
仍有效。同名委派共享实例的问题后来由「壳化」解决(496d54d),见 doc/problems/同名委派共享实例;子代理档案与 resume 见 doc/problems/子代理档案放哪里。