关键设计决策和原因 ​

决策表归纳；不贴源码。

1. Middleware 架构 ​

可组合、可测试；比单体 Agent 类易扩展。

2. Backend 抽象 ​

同一套文件工具对接内存/磁盘/沙箱，环境可切换。

3. 文件状态管理 ​

元数据与内容分离，支持增量 read 与一致性检查。

4. 工具结果淘汰 ​

大输出落盘，消息留指针，控 token（见 05）。

5. 子代理上下文隔离 ​

子图多轮 tool 不回流父 messages，防污染。

6. Skills 继承 ​

子代理复用组织级技能，减少重复配置。

7. 对话摘要 ​

长任务必备；在 checkpoint 语义下替换 ancient history。

8. 类型累积 ​

middleware 增多时仍保持 create API 类型安全（见 06）。

9. 默认 StateBackend ​

零配置可跑；生产再换 Store/Filesystem。

10. 工具结果预览 ​

read 大文件时分页/预览，避免一次注入。

11. 子代理只返回最终消息 ​

父模型只见结论，不见子代理中间 bash 输出。

12. 支持并行 tool ​

多 subagent 并行缩短墙钟时间；需限流。

总结 ​

Deep Agents 的产品判断：长任务 = 规划 + 外置上下文 + 子代理 + 摘要。