书名：《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》
作者：陈堂会
章节：第二章 TypeScript / Node Runtime 基础 / 2.5 背压：不要让日志淹没上下文
电子版系列：查看完整目录
第二章 TypeScript / Node Runtime 基础：2.5 背压：不要让日志淹没上下文
背压是很多 Agent Demo 不谈、生产系统绕不开的问题。工具输出可能非常大，例如 npm test 打出几万行日志，grep 搜索整个仓库，构建工具输出长堆栈。Runtime 不能把所有内容原样塞进模型上下文。
正确做法是分两层处理：
第一层是执行层限流。命令执行器记录完整日志到文件或 trace，但只向模型返回摘要、尾部片段和关键错误行。
第二层是上下文层降级。Context Builder 根据预算决定哪些工具结果进入下一轮，哪些只保留引用。
一个实用策略：
| 输出类型 | 保存 | 注入模型 |
|---|---|---|
| 短 stdout | trace 全量 | 全量 |
| 长 stdout | trace 文件 | 摘要 + 前后片段 |
| stderr | trace 全量 | 错误摘要 + 关键堆栈 |
| 测试报告 | 结构化 JSON | 失败用例、断言、文件行 |
| 构建日志 | trace 文件 | 首个错误块 + 相关上下文 |
