Practical overview
When it fits
当你需要在开始 DeerFlow 2.0 定制前建立源码级理解，或需要一套中文架构与开发参考材料时使用。
Who it is for
- 希望理解 DeerFlow 2.0 内部结构的 agent 开发者
- 需要规划 DeerFlow 定制工作的工程师
- 准备建立中文开发者培训或 onboarding 材料的团队
- 希望结合源码学习 Skill、Sub-Agent、Sandbox、Memory 或 MCP 扩展的读者
Documented uses
- 学习 DeerFlow 2.0 的概念和架构
- 按模块阅读 agent 系统源码
- 为自定义 Skill、MCP Server 或人工审批流程寻找设计参考
- 整理面向团队的 DeerFlow 开发学习路径
Requirements & limits
公开 GitHub 仓库和在线阅读站点均由项目材料列出；仓库许可证为 MIT。
- 内容聚焦 DeerFlow 2.0，而不是提供独立的 agent framework 实现。
- 源码分析覆盖 ThreadState、中间件、Skills、Sub-Agent、Sandbox、Memory 和 MCP 等模块。
- 阅读前提包括 Python 3.12+、异步编程、LangGraph 基础及一定的 agent 或 LLM 应用经验。
- 快速开始内容涉及 DeerFlow 官方仓库、Docker Compose、OpenAI API Key 和 PostgreSQL 配置。
- 书籍仓库使用 JavaScript 标注的主要语言，但正文重点是 DeerFlow 源码和 Python 开发概念。
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
按源码路径阅读 DeerFlow 2.0
使用书中的章节结构建立 DeerFlow 2.0 的架构和扩展认知。
Before you start
- Python 3.12+ 及类型注解、异步编程基础
- LangChain 或 LangGraph 的 Graph、State、Node 基础
- 具备 agent 或 LLM 应用开发经验
Steps
先阅读第一章至第三章，了解 DeerFlow 定位、核心概念和总体架构。
二次开发工程师继续阅读第四章至第七章，查看项目结构、Agent 核心、Skills、Tools 和 Sub-Agent。
阅读第八章至第十章，了解 Sandbox、Memory 和 Context Engineering。
最后阅读第十一章至第十四章及附录，覆盖 MCP Server、自定义 Skill、Human-in-the-Loop 和企业案例。
Expected outcome
获得一条从概念、架构和源码分析到二次开发主题的结构化阅读路径。
Guide limitations
- 这是学习和参考路径，不构成对 DeerFlow 环境的运行验证。
- 书中快速开始部分涉及 DeerFlow 官方仓库的启动与配置，实际运行还依赖相应的外部环境。
为 DeerFlow 2.0 定制方案准备参考材料
从源码分析章节中定位与自定义 Skill、MCP 和 agent 扩展相关的参考内容。
Before you start
- 能够阅读 Python agent 项目源码
- 理解 Skill、Tool、Sub-Agent、Sandbox 和 Memory 等概念
- 需要时具备 Docker 基础
Steps
从第四章项目结构开始，确认模块职责和配置体系。
参考第五章至第九章，分别查看 Agent 核心、Skills 与 Tools、Sub-Agent、Sandbox 和 Memory。
阅读第十一章至第十三章，查找 MCP Server、自定义 Skill 和 Human-in-the-Loop 的设计说明。
结合附录 A 与附录 C 查看配置参考和多模态 Skill 代码示例。
Expected outcome
形成面向 DeerFlow 2.0 定制工作的章节索引和设计参考。
Guide limitations
- 仓库提供的是解释、示例和参考路径，不是 DeerFlow 实现的替代品。
- 具体扩展仍需结合 DeerFlow 代码和目标环境进行开发。
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 3 October 2026
- Original website title
- hawkli-1994/deerflow-book · Official homepage title · retained in its source language