DeerFlow 源码拆解

一套面向工程实践的 DeerFlow 2.1 源码阅读笔记。项目沿用 dg-ai-notes 的拆解方法：每章同时回答“是什么、怎么做、为什么这样做”，并把源码路径、数据流和设计取舍放在同一条学习主线上。

内容范围

• Harness、Gateway、Frontend 三层边界
• LangGraph Agent 工厂、ThreadState 与中间件链
• 模型、Prompt、工具治理、沙箱、产物交付
• 子代理、记忆、上下文压缩、MCP 与 Skills
• Run 生命周期、SSE 流、断线重放与前端状态折叠
• 检查点、持久化、鉴权、配置、部署与扩展

分析基线为本地 deer-flow-main 快照，包版本 2.1.0，分析日期为 2026-08-01。上游 main 分支会继续变化，文中源码链接用于快速定位，精确行为以该基线快照为准。

本地运行

npm install
npm run docs:dev

生产构建：

npm run docs:build
npm run docs:preview

版权说明

本文档是对 ByteDance DeerFlow 开源代码的独立学习笔记，不是官方文档。DeerFlow 项目本身采用 MIT License；本仓库的文字、配置与站点代码同样采用 MIT License。