工具输出太大怎么办：Spill 落盘

失败如何传播

1. 策略只处理纯文本

   策略只处理纯文本，混入非文本块整体不碰。模型面向路径跳过 read 工具，防止 spill 后 read 再 spill 形成循环。

   [repo]

2. 凭证字节先扣预算再算预览

   凭证字节先扣预算再算预览。凭证本身超限就放弃 spill，保留原样。存储失败只记日志，原始内容原样内联。

   [repo]

3. 取回凭证是不透明句柄

   取回凭证是不透明句柄，本地给路径，远程可给 URI 或键。消费方按后端附带的提示渲染话术，不假定 read 永远正确。

   [repo]

恢复与防线

• 磁盘满导致 spill 写失败，工具调用怎么算： 仍算成功。catch 返回 undefined，原始内容原样内联，不隐藏信息。

• 为什么模型面向路径要跳过 read 工具： 防止 read 输出被 spill 成文件后再 read 触发新 spill，形成无限循环。

仍会失效的地方

• 本页结论对应 revision 0a53fb55bea101816fa226bb964ae2bed71c343b。文件位置、命名和默认行为可能随版本变化，引用实现细节时应同时记录 commit。