常见问题

速查；细节见各章。

架构

问题	要点
与 LangGraph 区别？	Deep Agents 是带内置 middleware 的 Agent 工厂
与 LangChain Agent？	底层仍是 LangGraph + Message；见 langchainjs

问题	要点
文件工具写不进盘？	是否 StateBackend；换 FilesystemBackend
自定义 middleware 不生效？	注册顺序、是否传入 `createDeepAgent`

问题	要点
仍爆 token？	调低摘要阈值、开 eviction、大输出写文件
模型找不到刚写的内容？	路径是否一致、read 是否在 write 之后

问题	要点
子代理结果太简略？	子代理 prompt 要求输出结构化结论
并行失败？	并发限制与 API rate limit

问题	要点
invoke 类型报错？	动态 middleware 需手动类型断言

建议
生产用 checkpointer + StoreBackend
真磁盘路径用 Composite 限制前缀
危险 bash 仅 Sandbox

优先查：backend 选型、eviction/摘要、子代理返回策略。