第三部分：二次开发实战 ⭐️

| 章节 | 内容亮点 | 源码文件 | |------|----------|----------| | 第十一章 · MCP Server 集成 ✅ | OAuth 2.0 认证、工具缓存、多传输方式 (stdio/sse/http) | mcp/oauth.py, mcp/cache.py, mcp/client.py | | 第十二章 · 自定义 Skill 开发 | Skill 开发流程、打包发布、调试测试 | - | | 第十三章 · Human-in-the-Loop | 审批节点设计、审批中间件、审计日志 | - | | 第十四章 · 企业级应用案例 | 多租户隔离、RBAC、审计系统、知识库集成 | - |

附录

• 附录 A · 配置参考 - 完整配置示例
• 附录 B · 贡献指南 - 开发规范、PR 流程

✅ 标记表示本章已基于 DeerFlow 最新源码进行深度更新

🎯 阅读建议

不同读者的阅读路径

🆕 Agent 开发新手

第一章 → 第二章 → 第三章 → 第十二章 (快速上手 Skill 开发)

🔧 二次开发工程师

第四章 → 第五章 → 第六章 → 第七章 → 第十一章 (核心架构)

🏢 企业级应用开发者

第五章 → 第八章 → 第九章 → 第十三章 → 第十四章 (生产环境)

🔬 源码贡献者

通读全书 + 附录 B + 直接阅读 DeerFlow 源码

📋 阅读前置要求

• Python 3.12+ - 熟悉类型注解、异步编程
• LangChain / LangGraph - 了解基本概念（Graph、State、Node）
• Agent / LLM 应用开发 - 有实际项目经验更佳
• Docker - 理解容器基础（用于 Sandbox 章节）

🔄 最新更新

2026-05-02 重大更新

基于 DeerFlow 2.0 最新版本进展（2026 年 4 月），对以下章节进行了更新：

| 章节 | 更新内容 | |------|----------| | Chapter 01 | 新增核心特性：Progressive Skill Loading、InfoQuest、多模态输出 | | Chapter 06 | 新增渐进式 Skill 加载机制、InfoQuest 集成 |

2026-04-09 重大更新

基于 DeerFlow 最新源码，对以下章节进行了深度更新：

| 章节 | 更新内容 | |------|----------| | Chapter 05 | 新增 ThreadState 类型系统 (NotRequired/Annotated)、14+ 中间件完整列表、DeerFlowClient SDK | | Chapter 06 | 新增 Skill 安全扫描、历史管理、安装器实现 | | Chapter 07 | 新增 SubagentExecutor、任务状态机、背景任务管理 | | Chapter 08 | 新增 Sandbox Provider 模式、中间件生命周期、安全审计 | | Chapter 11 | 新增 OAuth 2.0 认证、MCP 工具缓存、多传输方式 |

🤝 参与贡献

本书是开源的，欢迎提交 PR：

1. 内容修正 - 发现与源码不符的地方
2. 章节补充 - 增加新的源码解析
3. 示例代码 - 提供更清晰的代码示例
4. 翻译 - 翻译成其他语言

详见 附录 B · 贡献指南

📌 版本信息

• DeerFlow 版本: 2.0
• 书籍版本: 2026.04
• 最后更新: 2026-04-09

📄 许可证

本书采用 MIT 许可证 开源。

DeerFlow 是 ByteDance 的开源项目，本书为社区贡献的二次开发指南。