DeerFlow 系列教程 附录
本附录汇集了 DeerFlow 项目的核心文件索引、官方文档索引和推荐阅读顺序三份速查资料,方便读者在日常开发和学习中快速定位关键代码与文档。内容按实际项目目录结构整理,所有路径均基于 DeerFlow 2.0 版本验证。
附录 A:DeerFlow 核心文件索引
A.1 Agent 核心
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/agents/lead_agent/agent.py |
Lead Agent 工厂函数,创建完整的 Agent 图结构 | 第 7 篇 |
backend/packages/harness/deerflow/agents/lead_agent/prompt.py |
系统提示词模板(约 31KB),定义 Lead Agent 的行为规范 | 第 7 篇 |
backend/packages/harness/deerflow/agents/thread_state.py |
AgentState 类型定义,Agent 的完整状态结构 |
第 7 篇 |
A.2 中间件体系
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/agents/middlewares/ |
15 层中间件目录 | 第 8 篇 |
middlewares/memory_middleware.py |
记忆中间件------长期记忆注入与更新 | 第 8、11 篇 |
middlewares/sandbox_audit_middleware.py |
沙箱审计中间件------安全策略强制执行 | 第 8、11 篇 |
middlewares/loop_detection_middleware.py |
循环检测中间件------防止 Agent 无限循环 | 第 8 篇 |
middlewares/llm_error_handling_middleware.py |
LLM 错误处理中间件------自动重试与降级 | 第 8 篇 |
middlewares/title_middleware.py |
标题生成中间件------自动为对话生成标题 | 第 8 篇 |
middlewares/token_usage_middleware.py |
Token 用量跟踪中间件 | 第 8、15 篇 |
middlewares/uploads_middleware.py |
文件上传中间件------处理用户附件 | 第 8 篇 |
middlewares/view_image_middleware.py |
图像查看中间件------注入图像内容 | 第 8 篇 |
middlewares/todo_middleware.py |
待办事项中间件------管理任务列表 | 第 8 篇 |
middlewares/clarification_middleware.py |
追问澄清中间件------处理用户反馈 | 第 8 篇 |
middlewares/dangling_tool_call_middleware.py |
悬挂工具调用修复中间件 | 第 8 篇 |
middlewares/deferred_tool_filter_middleware.py |
延迟工具过滤中间件 | 第 8 篇 |
middlewares/subagent_limit_middleware.py |
子智能体数量限制中间件 | 第 8、10 篇 |
middlewares/thread_data_middleware.py |
线程数据中间件------管理线程元信息 | 第 8 篇 |
middlewares/tool_error_handling_middleware.py |
工具错误处理中间件 | 第 8 篇 |
Note :上表中的
middlewares/前缀代表完整路径backend/packages/harness/deerflow/agents/middlewares/,为节省空间而缩写。
A.3 工具体系
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/tools/tools.py |
工具加载管线------从配置到注入 Agent 的完整流程 | 第 12 篇 |
backend/packages/harness/deerflow/tools/builtins/ |
内置工具目录 | 第 12 篇 |
tools/builtins/task_tool.py |
Task 工具------委派子智能体执行任务 | 第 10、12 篇 |
tools/builtins/present_file_tool.py |
文件展示工具------向用户呈现生成的文件 | 第 12 篇 |
tools/builtins/clarification_tool.py |
追问澄清工具------向用户提问 | 第 12 篇 |
tools/builtins/tool_search.py |
工具搜索------动态发现和加载工具 | 第 12 篇 |
tools/builtins/view_image_tool.py |
图像查看工具 | 第 12 篇 |
tools/builtins/invoke_acp_agent_tool.py |
ACP Agent 调用工具 | 第 12 篇 |
tools/builtins/setup_agent_tool.py |
Agent 配置工具 | 第 12 篇 |
Note :上表中
tools/builtins/前缀代表完整路径backend/packages/harness/deerflow/tools/builtins/。
A.4 Skills 技能系统
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/skills/loader.py |
技能加载器------三级渐进式加载(发现 → 摘要 → 完整内容) | 第 9、18 篇 |
backend/packages/harness/deerflow/skills/parser.py |
SKILL.md 解析器------YAML frontmatter 提取 | 第 9 篇 |
backend/packages/harness/deerflow/skills/manager.py |
技能管理器------验证、注册、卸载 | 第 9、18 篇 |
backend/packages/harness/deerflow/skills/types.py |
技能类型定义(SkillDefinition) |
第 9 篇 |
backend/packages/harness/deerflow/skills/installer.py |
技能安装器------从 .skill 包安装 |
第 9 篇 |
backend/packages/harness/deerflow/skills/validation.py |
技能校验------安全和格式检查 | 第 9 篇 |
backend/packages/harness/deerflow/skills/security_scanner.py |
技能安全扫描------恶意内容检测 | 第 9 篇 |
A.5 Sub-Agents 子智能体
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/subagents/executor.py |
子智能体执行器------核心编排引擎(约 25KB) | 第 10 篇 |
backend/packages/harness/deerflow/subagents/registry.py |
子智能体注册表------BUILTIN_SUBAGENTS | 第 10 篇 |
backend/packages/harness/deerflow/subagents/config.py |
子智能体配置------SubagentConfig | 第 10 篇 |
backend/packages/harness/deerflow/subagents/builtins/general_purpose.py |
通用子智能体------默认执行器 | 第 10 篇 |
backend/packages/harness/deerflow/subagents/builtins/bash_agent.py |
Bash 子智能体------命令执行 | 第 10 篇 |
A.6 Sandbox 沙箱系统
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/sandbox/ |
沙箱系统目录 | 第 11 篇 |
sandbox/sandbox.py |
沙箱抽象基类 | 第 11 篇 |
sandbox/sandbox_provider.py |
沙箱提供者工厂 | 第 11 篇 |
sandbox/local/local_sandbox.py |
本地沙箱实现(约 13KB) | 第 11 篇 |
sandbox/local/local_sandbox_provider.py |
本地沙箱提供者 | 第 11 篇 |
sandbox/tools.py |
沙箱工具集(约 53KB)------文件操作、代码执行 | 第 11、12 篇 |
sandbox/security.py |
沙箱安全策略 | 第 11、15 篇 |
sandbox/middleware.py |
沙箱中间件 | 第 11 篇 |
sandbox/search.py |
沙箱内搜索 | 第 11 篇 |
Note :上表中
sandbox/前缀代表完整路径backend/packages/harness/deerflow/sandbox/。
A.7 Memory 记忆系统
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/agents/memory/ |
记忆系统目录 | 第 11 篇 |
memory/updater.py |
记忆更新器------事实提取、冲突消解(约 17KB) | 第 11 篇 |
memory/storage.py |
记忆存储------持久化读写 | 第 11 篇 |
memory/queue.py |
记忆队列------异步更新管理 | 第 11 篇 |
memory/prompt.py |
记忆相关提示词模板(约 15KB) | 第 11 篇 |
Note :上表中
memory/前缀代表完整路径backend/packages/harness/deerflow/agents/memory/。
A.8 MCP 集成
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/mcp/ |
MCP 集成目录 | 第 12、18 篇 |
mcp/client.py |
MCP 客户端------MultiServerMCPClient 封装 | 第 12、18 篇 |
mcp/tools.py |
MCP 工具适配------转换为 LangChain Tool | 第 12 篇 |
mcp/cache.py |
MCP 缓存------带过期检测的惰性缓存 | 第 18 篇 |
mcp/oauth.py |
MCP OAuth------GitHub OAuth 认证支持 | 第 18 篇 |
Note :上表中
mcp/前缀代表完整路径backend/packages/harness/deerflow/mcp/。
A.9 模型与配置
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/models/factory.py |
模型工厂------根据配置创建 LLM 实例 | 第 13 篇 |
backend/packages/harness/deerflow/config/app_config.py |
主配置加载------解析 config.yaml(约 16KB) | 第 5、18 篇 |
backend/packages/harness/deerflow/config/extensions_config.py |
扩展配置------MCP 服务器配置(约 11KB) | 第 12、18 篇 |
backend/packages/harness/deerflow/config/sandbox_config.py |
沙箱配置------模式选择和参数 | 第 11 篇 |
backend/packages/harness/deerflow/config/memory_config.py |
记忆配置 | 第 11 篇 |
backend/packages/harness/deerflow/config/model_config.py |
模型配置------Provider 和模型定义 | 第 13 篇 |
backend/packages/harness/deerflow/config/guardrails_config.py |
安全防护配置 | 第 15 篇 |
backend/packages/harness/deerflow/config/tracing_config.py |
追踪配置------LangSmith / Langfuse | 第 15、18 篇 |
backend/packages/harness/deerflow/config/subagents_config.py |
子智能体配置 | 第 10 篇 |
backend/packages/harness/deerflow/config/summarization_config.py |
消息摘要配置 | 第 7 篇 |
backend/packages/harness/deerflow/config/checkpointer_config.py |
Checkpointer 配置(memory / sqlite / postgres) | 第 5 篇 |
backend/packages/harness/deerflow/config/paths.py |
路径管理------DEER_FLOW_HOME 等(约 12KB) | 第 5、19 篇 |
A.10 客户端与 API 网关
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/packages/harness/deerflow/client.py |
嵌入式客户端------程序化调用 DeerFlow(约 36KB) | 第 18 篇 |
backend/app/gateway/app.py |
FastAPI 网关入口------路由注册和中间件配置 | 第 2 篇 |
backend/app/gateway/routers/threads.py |
线程 API 路由(约 27KB) | 第 2 篇 |
backend/app/gateway/routers/agents.py |
智能体管理 API | 第 2 篇 |
backend/app/gateway/routers/skills.py |
技能管理 API(约 15KB) | 第 9 篇 |
backend/app/gateway/routers/memory.py |
记忆 API(约 12KB) | 第 11 篇 |
backend/app/gateway/routers/models.py |
模型列表 API | 第 13 篇 |
backend/app/gateway/routers/mcp.py |
MCP 管理 API | 第 12 篇 |
backend/app/gateway/routers/uploads.py |
文件上传 API | 第 2 篇 |
backend/app/gateway/routers/artifacts.py |
制品管理 API | 第 2 篇 |
backend/app/gateway/routers/runs.py |
Run 管理 API | 第 2 篇 |
backend/app/gateway/routers/suggestions.py |
建议 API | 第 2 篇 |
backend/app/gateway/routers/channels.py |
渠道 API | 第 14 篇 |
backend/app/gateway/services.py |
网关服务层------业务逻辑封装(约 14KB) | 第 2 篇 |
A.11 IM 渠道集成
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
backend/app/channels/ |
IM 渠道集成目录 | 第 14 篇 |
backend/app/channels/manager.py |
渠道管理器------消息分发和生命周期(约 36KB) | 第 14 篇 |
backend/app/channels/base.py |
渠道抽象基类 | 第 14 篇 |
backend/app/channels/feishu.py |
飞书渠道适配器(约 32KB) | 第 14 篇 |
backend/app/channels/wecom.py |
企业微信渠道适配器(约 15KB) | 第 14 篇 |
backend/app/channels/telegram.py |
Telegram 渠道适配器(约 13KB) | 第 14 篇 |
backend/app/channels/slack.py |
Slack 渠道适配器 | 第 14 篇 |
backend/app/channels/message_bus.py |
消息总线------内部消息传递 | 第 14 篇 |
backend/app/channels/store.py |
渠道存储------会话映射 | 第 14 篇 |
backend/app/channels/service.py |
渠道服务------公共业务逻辑 | 第 14 篇 |
A.12 前端核心
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
frontend/src/core/threads/hooks.ts |
前端核心交互------useThreadStream、useThreads、useDeleteThread | 第 20 篇 |
frontend/src/core/api/api-client.ts |
LangGraph API 客户端封装 | 第 20 篇 |
frontend/src/core/api/stream-mode.ts |
流式模式过滤 | 第 20 篇 |
frontend/src/core/messages/utils.ts |
消息分组与内容提取(约 10KB) | 第 20 篇 |
frontend/src/core/artifacts/loader.ts |
制品加载器 | 第 20 篇 |
frontend/src/core/i18n/ |
国际化系统(11 个文件) | 第 20 篇 |
frontend/src/core/settings/store.ts |
用户设置状态管理 | 第 20 篇 |
frontend/src/core/config/index.ts |
前端环境配置(Base URL 计算) | 第 20 篇 |
frontend/src/env.js |
环境变量定义(@t3-oss/env-nextjs + zod) | 第 20 篇 |
frontend/src/app/layout.tsx |
根布局------ThemeProvider + I18nProvider | 第 20 篇 |
frontend/src/app/page.tsx |
着陆页入口 | 第 20 篇 |
frontend/src/app/workspace/chats/[thread_id]/page.tsx |
聊天页面------核心交互页 | 第 20 篇 |
A.13 部署与配置
| 文件路径 | 说明 | 关联教程 |
|---|---|---|
config.example.yaml |
主配置模板------模型、工具、沙箱、技能等完整配置 | 第 5、18、19 篇 |
extensions_config.example.json |
MCP 服务器配置模板 | 第 12、18 篇 |
.env.example |
环境变量模板------API Keys | 第 5、19 篇 |
frontend/.env.example |
前端环境变量模板 | 第 19、20 篇 |
docker/docker-compose.yaml |
Docker 生产编排------Nginx + Frontend + Gateway + LangGraph + Provisioner | 第 19 篇 |
docker/docker-compose-dev.yaml |
Docker 开发编排------热重载 + 命名卷 | 第 19 篇 |
docker/nginx/nginx.conf |
Nginx 路由配置------反向代理 + CORS + SSE | 第 19 篇 |
backend/Dockerfile |
后端 Dockerfile------多阶段构建(builder → dev → runtime) | 第 19 篇 |
frontend/Dockerfile |
前端 Dockerfile------多阶段构建(base → dev / builder → prod) | 第 19 篇 |
Makefile |
项目构建脚本------config / dev / up / down 等命令 | 第 4、19 篇 |
scripts/deploy.sh |
生产部署脚本------配置播种 + 密钥生成 + Docker 启动 | 第 19 篇 |
scripts/docker.sh |
开发 Docker 管理脚本 | 第 19 篇 |
附录 B:DeerFlow 官方文档索引
B.1 项目级文档
| 文档 | 路径 | 说明 |
|---|---|---|
| 主 README | README.md |
项目总览、快速开始、功能介绍(37KB) |
| 中文 README | README_zh.md |
中文版项目文档(27KB) |
| 日文 README | README_ja.md |
日文版项目文档 |
| 法文 README | README_fr.md |
法文版项目文档 |
| 俄文 README | README_ru.md |
俄文版项目文档 |
| 安装指南 | Install.md |
详细安装步骤 |
| 贡献指南 | CONTRIBUTING.md |
开发贡献规范 |
| 安全策略 | SECURITY.md |
安全漏洞报告流程 |
B.2 后端技术文档
| 文档 | 路径 | 说明 |
|---|---|---|
| 架构文档 | backend/docs/ARCHITECTURE.md |
深度架构文档------完整的系统设计说明(30KB) |
| 配置文档 | backend/docs/CONFIGURATION.md |
配置指南------所有配置项详解(13KB) |
| API 参考 | backend/docs/API.md |
REST API 文档------所有接口说明(12KB) |
| 文件上传 | backend/docs/FILE_UPLOAD.md |
文件上传机制说明 |
| 防护栏 | backend/docs/GUARDRAILS.md |
安全策略详解(18KB) |
| 中间件流程 | backend/docs/middleware-execution-flow.md |
中间件执行流程可视化(10KB) |
| 摘要策略 | backend/docs/summarization.md |
消息摘要策略说明(10KB) |
| 计划模式 | backend/docs/plan_mode_usage.md |
计划模式使用指南 |
| MCP 服务器 | backend/docs/MCP_SERVER.md |
MCP 集成文档 |
| 路径示例 | backend/docs/PATH_EXAMPLES.md |
文件路径映射说明 |
| Harness/App 拆分 | backend/docs/HARNESS_APP_SPLIT.md |
后端架构拆分说明(13KB) |
| 环境搭建 | backend/docs/SETUP.md |
后端开发环境搭建 |
| 后端 README | backend/README.md |
后端概览(16KB) |
| 后端贡献指南 | backend/CONTRIBUTING.md |
后端开发贡献规范 |
B.3 设计文档(RFC)
| 文档 | 路径 | 说明 |
|---|---|---|
| 创建 Agent RFC | backend/docs/rfc-create-deerflow-agent.md |
智能体创建设计提案(18KB) |
| 共享模块提取 RFC | backend/docs/rfc-extract-shared-modules.md |
模块提取设计提案 |
| Grep/Glob 工具 RFC | backend/docs/rfc-grep-glob-tools.md |
搜索工具设计提案(13KB) |
B.4 功能实现文档
| 文档 | 路径 | 说明 |
|---|---|---|
| 自动标题生成 | backend/docs/AUTO_TITLE_GENERATION.md |
标题生成实现说明 |
| 标题生成实现 | backend/docs/TITLE_GENERATION_IMPLEMENTATION.md |
标题生成技术细节 |
| 记忆改进 | backend/docs/MEMORY_IMPROVEMENTS.md |
记忆系统优化记录 |
| 记忆改进总结 | backend/docs/MEMORY_IMPROVEMENTS_SUMMARY.md |
记忆优化总结 |
| 记忆设置评审 | backend/docs/MEMORY_SETTINGS_REVIEW.md |
记忆配置评审 |
| Task 工具改进 | backend/docs/task_tool_improvements.md |
Task 工具优化记录 |
| Apple Container | backend/docs/APPLE_CONTAINER.md |
Apple Container 支持 |
| 待办事项 | backend/docs/TODO.md |
开发待办清单 |
B.5 前端与部署文档
| 文档 | 路径 | 说明 |
|---|---|---|
| 前端 README | frontend/README.md |
前端开发指南 |
| 前端开发指南 | frontend/CLAUDE.md |
前端架构和编码规范(4KB) |
| 前端 Agent 指南 | frontend/AGENTS.md |
前端 AI 辅助开发指南(6KB) |
| Provisioner 文档 | docker/provisioner/README.md |
Kubernetes Provisioner 使用指南(11KB) |
B.6 Skill 文档
DeerFlow 内置了丰富的公共技能,每个技能的 SKILL.md 是其能力描述文档:
| 技能 | 路径 | 说明 |
|---|---|---|
| PPT 生成 | skills/public/ppt-generation/SKILL.md |
PPT 幻灯片生成(27KB) |
| 深度研究 | skills/public/deep-research/SKILL.md |
深度研究报告 |
| 数据分析 | skills/public/data-analysis/SKILL.md |
数据分析报告 |
| 图表可视化 | skills/public/chart-visualization/SKILL.md |
数据图表生成 |
| 学术论文评审 | skills/public/academic-paper-review/SKILL.md |
论文评审分析 |
| 代码文档 | skills/public/code-documentation/SKILL.md |
代码文档生成(14KB) |
| 咨询分析 | skills/public/consulting-analysis/SKILL.md |
咨询分析报告(33KB) |
| 图像生成 | skills/public/image-generation/SKILL.md |
AI 图像生成 |
| 前端设计 | skills/public/frontend-design/SKILL.md |
前端 UI 设计 |
| Podcast 生成 | skills/public/podcast-generation/SKILL.md |
播客脚本生成 |
| Newsletter 生成 | skills/public/newsletter-generation/SKILL.md |
新闻通讯生成(13KB) |
| GitHub 深度研究 | skills/public/github-deep-research/SKILL.md |
GitHub 项目分析 |
| 技能创建器 | skills/public/skill-creator/SKILL.md |
辅助创建新技能 |
| Agent 引导 | skills/public/bootstrap/SKILL.md |
Agent 引导配置 |
| Claude 迁移 | skills/public/claude-to-deerflow/SKILL.md |
Claude 迁移工具 |
| 技能搜索 | skills/public/find-skills/SKILL.md |
技能发现 |
附录 C:推荐阅读顺序
C.1 系列教程目录
| 编号 | 标题 | 所属模块 |
|---|---|---|
| 第 01 篇 | DeerFlow 是什么?------开源 Super Agent 框架全景概览 | 模块一:初识 DeerFlow |
| 第 02 篇 | DeerFlow 架构全解------从请求到响应的完整链路 | 模块一:初识 DeerFlow |
| 第 03 篇 | DeerFlow 核心概念图谱------理解五大支柱 | 模块一:初识 DeerFlow |
| 第 04 篇 | 手把手安装 DeerFlow------从零开始搭建你的 AI Agent 平台 | 模块二:快速上手 |
| 第 05 篇 | 配置指南------让 DeerFlow 连接你的大模型 | 模块二:快速上手 |
| 第 06 篇 | DeerFlow 初体验------从对话到交付的完整工作流 | 模块二:快速上手 |
| 第 07 篇 | Lead Agent 深度解析------DeerFlow 的决策大脑 | 模块三:核心概念深度解析 |
| 第 08 篇 | 中间件体系------Agent 的生命周期管理 | 模块三:核心概念深度解析 |
| 第 09 篇 | Skills 技能系统------Agent 的知识与能力扩展 | 模块三:核心概念深度解析 |
| 第 10 篇 | Sub-Agents 子智能体------并行任务编排的艺术 | 模块三:核心概念深度解析 |
| 第 11 篇 | Sandbox 沙箱与 Memory 记忆------安全执行与持久认知 | 模块三:核心概念深度解析 |
| 第 12 篇 | Tools 工具体系------从内置工具到 MCP 扩展 | 模块四:高级功能与扩展 |
| 第 13 篇 | 大模型适配------多 Provider 支持与思考模式 | 模块四:高级功能与扩展 |
| 第 14 篇 | IM 渠道集成------让 DeerFlow 接入飞书、企微、Slack、Telegram | 模块四:高级功能与扩展 |
| 第 15 篇 | Guardrails 安全防护与可观测性 | 模块四:高级功能与扩展 |
| 第 16 篇 | 实战案例一------用 DeerFlow 进行深度研究 | 模块五:实战应用场景 |
| 第 17 篇 | 实战案例二------用 DeerFlow 生成数据可视化与分析报告 | 模块五:实战应用场景 |
| 第 18 篇 | 实战案例三------用 DeerFlow 构建自定义 AI 工作流 | 模块五:实战应用场景 |
| 第 19 篇 | Docker 生产部署全指南 | 模块六:部署与运维 |
| 第 20 篇 | 前端定制与二次开发指南 | 模块六:部署与运维 |
C.2 初学者路径
适合刚接触 DeerFlow 的读者,快速了解项目并动手使用。
第 01 篇(项目总览)
│
▼
第 04 篇(安装 DeerFlow)
│
▼
第 05 篇(配置大模型)
│
▼
第 06 篇(初体验)
│
▼
第 03 篇(核心概念图谱)
│
▼
第 16 篇(深度研究实战)
阅读时长:约 2-3 小时
学习目标:
- 理解 DeerFlow 是什么、能做什么
- 完成本地安装和配置
- 体验完整的对话工作流
- 建立对核心概念的整体认知
- 通过实战案例巩固理解
C.3 开发者路径
适合希望深入理解 DeerFlow 内部机制、进行二次开发或贡献代码的开发者。
第 01 篇(项目总览)
│
▼
第 02 篇(架构全解)
│
▼
第 03 篇(核心概念)
│
▼
第 04 篇(安装搭建)→ 第 05 篇(配置指南)
│
▼
第 07 篇(Lead Agent)
│
▼
第 08 篇(中间件体系)
│
▼
第 09 篇(Skills 技能)
│
▼
第 10 篇(Sub-Agents)
│
▼
第 11 篇(Sandbox & Memory)
│
▼
第 12 篇(Tools 工具)
│
▼
第 18 篇(自定义工作流实战)
│
▼
第 20 篇(前端定制与二次开发)
阅读时长:约 8-12 小时
学习目标:
- 掌握从请求到响应的完整链路
- 理解 Agent 核心(Lead Agent + 中间件 + 状态管理)
- 深入理解五大支柱(Skills、Sub-Agents、Sandbox、Memory、Tools)
- 能够开发自定义技能和 MCP 集成
- 能够进行前端定制和二次开发
C.4 运维路径
适合负责 DeerFlow 部署、监控和运维的工程师。
第 01 篇(项目总览)
│
▼
第 04 篇(安装搭建)
│
▼
第 05 篇(配置指南)
│
▼
第 15 篇(安全防护与可观测性)
│
▼
第 19 篇(Docker 生产部署)
阅读时长:约 3-4 小时
学习目标:
- 理解项目整体架构
- 掌握安装和配置流程
- 配置安全防护和监控追踪
- 完成 Docker 生产部署
- 建立日常运维能力
C.5 全面学习路径
适合希望全面掌握 DeerFlow 的读者,按顺序阅读全部 20 篇教程。
模块一:初识 DeerFlow
第 01 篇 → 第 02 篇 → 第 03 篇
模块二:快速上手
第 04 篇 → 第 05 篇 → 第 06 篇
模块三:核心概念深度解析
第 07 篇 → 第 08 篇 → 第 09 篇 → 第 10 篇 → 第 11 篇
模块四:高级功能与扩展
第 12 篇 → 第 13 篇 → 第 14 篇 → 第 15 篇
模块五:实战应用场景
第 16 篇 → 第 17 篇 → 第 18 篇
模块六:部署与运维
第 19 篇 → 第 20 篇
阅读时长:约 15-20 小时
学习目标:
- 从入门到精通的完整学习路径
- 覆盖所有核心概念和高级功能
- 通过三个实战案例巩固理解
- 具备独立部署和二次开发的能力
C.6 按需查阅索引
如果你有特定的学习需求,可以直接跳转到对应的教程:
| 学习需求 | 推荐教程 | 前置阅读 |
|---|---|---|
| 了解项目全貌 | 第 01 篇 | 无 |
| 理解系统架构 | 第 02 篇 | 第 01 篇 |
| 安装部署 | 第 04 篇 + 第 05 篇 | 第 01 篇 |
| 开发自定义技能 | 第 09 篇 + 第 18 篇 | 第 01、07 篇 |
| 集成 MCP 服务器 | 第 12 篇 + 第 18 篇 | 第 01、05 篇 |
| 理解子智能体编排 | 第 10 篇 | 第 07、08 篇 |
| 配置沙箱执行 | 第 11 篇 | 第 01、05 篇 |
| 接入大模型 | 第 05 篇 + 第 13 篇 | 第 01、04 篇 |
| 接入 IM 渠道 | 第 14 篇 | 第 01、05 篇 |
| 安全加固与监控 | 第 15 篇 | 第 01、05 篇 |
| Docker 生产部署 | 第 19 篇 | 第 01、04、05 篇 |
| 前端二次开发 | 第 20 篇 | 第 01、02 篇 |
| 深度研究实战 | 第 16 篇 | 第 06 篇 |
| 数据可视化实战 | 第 17 篇 | 第 06、09 篇 |
| 自定义工作流实战 | 第 18 篇 | 第 09、10、12 篇 |
小结
本附录提供了三份实用的速查资料:
- 附录 A(核心文件索引):按功能分类列出了 100+ 个关键源码文件,包含文件路径、简要说明和关联教程编号,方便在阅读教程时快速定位源码
- 附录 B(官方文档索引):整理了项目级文档、后端技术文档、RFC 设计文档、功能实现文档、前端文档和 16 个内置技能文档的完整索引
- 附录 C(推荐阅读顺序):针对初学者、开发者、运维、全面学习四种角色提供了定制化的阅读路径,并附上了按需查阅索引表
建议将本附录收藏为日常开发和学习的参考手册,配合具体教程使用效果更佳。
至此,DeerFlow 系列教程全部 20 篇正文 + 附录已完成。感谢阅读!