hawkli-1994/deerflow-book

解决的问题

本书帮助开发者不再将 DeerFlow 视为黑盒。它深入解析 DeerFlow 2.0 的内部架构和源码，使读者能够修改、扩展或基于它构建自己的项目。书中不仅展示如何调用框架，还通过真实的源文件和实用示例，深入探讨代码为何如此设计。

工作原理

本书分为三个部分。第一部分涵盖理论基础：DeerFlow 是什么，其核心概念如 Skills 与 Tools、Sub-Agents、Sandbox、Memory 和上下文工程，以及整体架构。第二部分逐章深入源码，解释 ThreadState 类型系统、中间件链、Skills 和 Tools 管理器、Sub-Agent 执行器、Sandbox 提供者、Memory 系统和上下文工程技术。第三部分聚焦实际二次开发：集成带 OAuth 2.0 的 MCP 服务器、构建支持多模态输出（PPT、播客、图像、视频、仪表盘）的自定义 Skills、添加人工审批流程，以及多租户隔离、RBAC 和审计系统等企业案例。每章都引用其解释的实际 DeerFlow 源文件，且本书持续更新以匹配最新版本。

适用读者

本书面向已有一定代理或 LLM 应用开发经验、希望进行深度定制的开发者。读者需熟悉 Python 3.12+、类型注解、异步编程以及基本的 LangChain/LangGraph 概念。书中为新手、二次开发工程师、企业应用开发者和潜在源码贡献者提供了不同的阅读路径。

亮点

• 源码级分析：每章深入实际 DeerFlow 源码，而非仅停留在高层概念。
• 实用导向：提供完整的二次开发示例，可直接用于项目。
• 架构思维：不仅解释“如何使用”，还解释“为何如此设计”。
• 持续更新：与 DeerFlow 版本保持同步，近期更新涵盖内存、技能、沙箱和 OAuth。
• 包含 Docker 快速入门指南和本地配置参考。
• 基于 MIT 许可开源，并提供贡献指南。