00. 教程总览

先说这套教程怎么读

DeerFlow 这类项目，最容易看乱。

README 能帮你跑起来。但跑起来以后，真正的问题才开始：目录很多，能力很多，Tools、Skills、MCP、Sandbox、Memory，每个都像重点。

如果一上来读源码，很容易迷路。

如果只看快速开始，又只能停在“能跑”。

所以这套教程不是按“概念大全”的方式写。我更想把它排成一条路线：先跑起来，再看地图，然后按能力模块拆，最后做一个研究型 Agent。

这套教程分成四段

01-03 入门篇
04-06 架构地图
07-22 能力模块：原理 → 源码 → 实战
23-29 终局实战：自己写一个研究型 Agent

入门篇只解决一件事：先能跑。

架构地图解决第二件事：知道一次任务从哪里进来，怎么经过 Gateway、Runtime、Lead Agent，最后怎么变成结果。

能力模块是主菜。这里不按“原理篇 / 源码篇 / 实战篇”三大块拆，而是按能力拆。比如 Tools 就是原理、源码、实战连在一起看。

最后的终局实战，是把前面的东西串起来，做一个研究型 Agent。它能接收一个研究主题，搜索资料，调用工具，生成 Markdown 报告，并把报告保存成文件。

如果你只是想先跑起来

看这三篇就够：

01 DeerFlow 是什么：先知道你在学什么
02 快速开始：先把 DeerFlow 跑起来
03 配置文件：看懂 config.yaml

这三篇解决的是“先能用”。不用急着看源码。

如果你想知道它怎么转起来

继续看：

04 整体架构：DeerFlow 到底在调度什么
05 项目结构：从目录看懂 DeerFlow
06 执行链路：一次任务从入口到结果

这部分是地图。看完你至少知道一次任务从哪里进来，哪些模块参与，最后结果怎么返回。

如果你想二次开发

重点看：

07-22 能力模块

这里不要只看原理。源码篇也别跳过。

你不一定要把每个文件都读懂，但至少要知道：真要改 Tools、Skills、Sub-agents、Sandbox、MCP 时，第一眼应该去哪个目录。

如果你想直接做东西

可以先看：

23-29 终局实战

这一组是目标最明确的部分：自己做一个研究型 Agent。

如果中间遇到不懂的能力，再回头补对应模块。比如不懂 Tool，就回去看 07-09；不懂 Skill，就看 10-12；不懂 MCP，就看 18-19。

完整目录

01 DeerFlow 是什么：先知道你在学什么
02 快速开始：先把 DeerFlow 跑起来
03 配置文件：看懂 config.yaml
04 整体架构：DeerFlow 到底在调度什么
05 项目结构：从目录看懂 DeerFlow
06 执行链路：一次任务从入口到结果
07 Tools 原理：Agent 为什么需要工具
08 Tools 源码：工具是怎么注册和调用的
09 Tools 实战：给研究型 Agent 增加一个工具能力
10 Skills 原理：把经验沉淀成可复用能力
11 Skills 源码：Skill 是怎么安装、解析和约束工具的
12 Skills 实战：写 Skill 约束输出质量
13 Sub-agents 原理：多智能体什么时候值得拆
14 Sub-agents 源码：子 Agent 是怎么创建和汇总的
15 Sub-agents 实战：把研究任务拆给多个 Agent
16 Sandbox 原理：安全执行和文件边界
17 Sandbox 源码：执行环境和文件路径怎么管理
18 MCP 原理：把外部工具接进 Agent
19 MCP 实战：接一个只读外部服务
20 Memory 原理：长期上下文该记什么
21 可观测性：看清一次 Agent 为什么失败
22 排错实战：一次任务为什么失败
23 终局实战：自己写一个研究型 Agent
24 设计 Agent 任务流
25 接入搜索和工具
26 写 Skill 约束输出质量
27 接 MCP / 外部服务
28 生成报告和文件产物
29 验收与部署

如果时间不多

可以先按这条线读：

01 DeerFlow 是什么：先知道你在学什么
|
02 快速开始：先把 DeerFlow 跑起来
|
03 配置文件：看懂 config.yaml
|
04 整体架构：DeerFlow 到底在调度什么
|
06 执行链路：一次任务从入口到结果
|
07 Tools 原理：Agent 为什么需要工具
|
10 Skills 原理：把经验沉淀成可复用能力
|
13 Sub-agents 原理：多智能体什么时候值得拆
|
16 Sandbox 原理：安全执行和文件边界
|
18 MCP 原理：把外部工具接进 Agent
|
23 终局实战：自己写一个研究型 Agent
|
29 验收与部署

这不是最完整的路线，但能先把主线串起来。

等你真的要改某个能力时，再回头补源码篇和实战篇。

看到最后应该能做什么

如果只是看完还能复述几个概念，那意义不大。

我更希望你读完后，至少能做到这些：

• 把 DeerFlow 跑起来；
• 知道配置该改哪里；
• 能说清一次任务大概怎么流动；
• 分得清 Tool、Skill、Sub-agent、Memory、MCP；
• 真要二开时，知道先看哪个目录；
• 最后能自己做一个简单但完整的研究型 Agent。

做到这些就够了。

后面再深入源码，会顺很多。