你有没有遇到过这样的场景:老板让你"调研一下竞品的技术架构,写个分析报告",你花了整整两天时间——先搜资料、读论文、看 GitHub,再整理成文档、画架构图、写结论。这种长周期、多步骤、跨工具的任务,普通的 ChatGPT 对话根本搞不定,它只能帮你回答一个子问题,然后你得自己把碎片拼起来。

DeerFlow(Deep Exploration and Efficient Research Flow)是字节跳动在 2025 年初开源的 SuperAgent 框架,目前在 GitHub 上已经拿到了 77K Star,是同类项目中增长最快的之一。它要解决的核心问题就是:让 AI Agent 像一个高级分析师一样,自主地完成一个需要几小时甚至几天的复杂任务

什么是长周期 SuperAgent

先说概念。传统 Agent(比如 AutoGPT、BabyAGI)也能执行多步任务,但它们有一个致命问题:执行到第三步就开始跑偏,上下文丢失、目标偏离、工具调用出错。长周期 SuperAgent 的关键是引入了系统级的工程设计,让 Agent 能在几十甚至上百步的执行中保持稳定。

DeerFlow 对"长周期"的定义有三个维度:

跟 Manus(320K Star)那种偏向"通用智能助手"的定位不同,DeerFlow 更聚焦在研究和内容生产场景,做到了这个垂直领域的极致。

架构拆解:六大核心模块

DeerFlow 的架构设计是它最大的亮点。我花了几天时间把源码读了一遍,整理出六大核心模块:

1. Sandbox(沙箱执行环境)

每个任务都在隔离的沙箱中运行,这意味着 Agent 可以安全地执行任意代码而不用担心搞坏系统。跟 OpenHands 的 sandbox 类似,但 DeerFlow 做了更细粒度的资源限制:

# DeerFlow sandbox 配置示例
sandbox:
  type: docker
  image: python:3.11-slim
  memory_limit: 2g
  cpu_limit: 2
  network: restricted
  timeout: 3600  # 1小时超时

2. Memory(记忆系统)

DeerFlow 的记忆系统分三层:短期记忆(当前任务的上下文窗口)、工作记忆(任务执行过程中产生的中间结果,存储在向量数据库中)、长期记忆(跨任务的知识积累)。这让它在长周期执行中不会"忘掉"前面做过什么。

3. Tools(工具集)

内置了丰富的工具:网页搜索、网页抓取、代码执行、文件读写、PDF 解析、图表生成等。工具的注册和调用采用了标准的 function calling 接口,扩展起来很方便。

4. Skills(技能模块)

Skills 是高于 Tools 的抽象。一个 Skill 可能组合多个 Tools 来完成一个特定目标,比如"深度网页调研"这个 Skill 就会组合搜索、抓取、摘要、对比等多个工具。

5. Sub-agents(子代理)

复杂的任务会被拆分给不同的子代理执行。比如一个"竞品分析"任务,DeerFlow 会派出三个子代理:一个负责搜索资料,一个负责读论文和代码,一个负责写报告。每个子代理有自己的上下文和工具集。

6. Message Gateway(消息网关)

负责子代理之间的通信和协调。所有消息都经过网关路由,支持异步通信和优先级队列。这是保证多代理协作不混乱的关键。

深度研究能力实测

我拿了一个实际任务来测试 DeerFlow:"调研 2025 年主流 AI Agent 框架的技术架构对比"。整个过程大约跑了 12 分钟,它自主完成了以下步骤:

  1. 搜索了 23 个相关网页和论文
  2. 抓取了 8 个项目的 GitHub README 和架构文档
  3. 执行 Python 脚本生成了对比表格
  4. 自动绘制了架构对比图
  5. 生成了一份 4000 字的分析报告,包含引用来源

报告的质量说实话已经超过了大多数初级分析师的水平。当然,它偶尔也会抓到过时的信息,或者对某些技术细节的理解有偏差——但这已经比让我手动做快了 10 倍。

跟 Manus / OpenHands / Devin 的对比

这个赛道现在很热,我来逐一比较:

vs Manus(320K Star)

Manus 是闭源产品,能力确实强,但它本质上是一个通用助手。DeerFlow 是开源框架,你可以自部署、自定义、集成到自己的工作流中。如果你需要的是一个可控的、可定制的研究工具,DeerFlow 更合适。如果你需要的是"啥都能干但你管不了它",那 Manus 更好。

vs OpenHands(58K Star)

OpenHands 主要聚焦在代码开发场景,它的 code agent 能力确实比 DeerFlow 强。但 DeerFlow 在研究和内容生产场景上远超 OpenHands。两者互补大于竞争。

vs Devin(闭源)

Devin 是第一个"AI 软件工程师",它的 SWE-bench 成绩很漂亮。但 Devin 是闭源 SaaS,价格不菲。DeerFlow 的定位不完全是编程,它更像是一个知识工作自动化平台

LangGraph 编排引擎

DeerFlow 底层使用 LangGraph 作为任务编排引擎,这是一个有向图(DAG)的状态机框架。每个节点是一个处理步骤,边代表状态转换:

# DeerFlow 任务图示例
START → plan_node → research_node → code_node → review_node → END
                                    ↓
                              writer_node → END

为什么选 LangGraph 而不是简单的 Sequential Chain?因为长周期任务的核心挑战是条件分支和循环。比如"如果调研结果不够充分,需要回退重新搜索",这种逻辑在 LangGraph 中可以用条件边轻松表达,而在 Sequential Chain 中就很难实现。

LangGraph 还提供了 checkpoint 机制——任务执行到一半如果中断了,可以从 checkpoint 恢复继续执行,不用从头来。这对长周期任务至关重要。

实际使用体验

安装过程还算顺利:

git clone https://github.com/bytedance/deer-flow.git
cd deer-flow
pip install -e .
# 配置 API Key
export OPENAI_API_KEY=sk-xxx
deer-flow run "帮我调研一下 RAG 的最新进展"

Web UI 做得挺好看,可以看到 Agent 的实时执行过程——正在搜索什么、读了哪些页面、生成了什么中间结果。这种透明性比 Manus 的黑盒体验好很多。

但也有不爽的地方:

适合谁?

总结一下,DeerFlow 适合以下场景:

不适合的场景:纯代码开发(用 OpenHands/Devin 更好)、简单问答(直接用 ChatGPT)、实时交互式任务(DeerFlow 的价值在长周期自主执行)。

字节跳动这次开源的质量很高,77K Star 不是白来的。如果你的工作涉及大量调研和内容生产,DeerFlow 值得认真试试。