DeerFlow 2.0:字节的 super agent harness

一句话定位

DeerFlow(Deep Exploration and Efficient Research Flow)是字节跳动开源的 super agent harness。它的自我定义很明确:一个 harness,编排子 agent、记忆与沙箱去做几乎任何事,由可扩展的 skill 驱动。星标超过八万二千,2026 年 2 月 28 日 2.0 版发布后登上 GitHub Trending 第一。

2.0 是一次彻底重写,README 明说它与 v1 不共享任何代码。原来那个 Deep Research 框架仍维护在 main-1.x 分支上并接受贡献,但活跃开发已全部移到 2.0。这个信息很重要:网上大量关于 DeerFlow 的资料讲的是 1.x 的深度研究流水线,与今天仓库里的东西是两套系统。

从 Deep Research 到 Super Agent Harness

1.x 的定位是深度研究:多智能体做检索、规划、报告生成。2.0 把定位从「一类任务的应用」抬到「承载任意任务的运行时」。README 的目录结构本身就是这次转变的证据:Skills & Tools(含 Claude Code 集成)、Session Goals、Manual Context Compaction、Sub-Agents、Sandbox & File System、Context Engineering、Long-Term Memory。这七项里没有一项是「研究」专属的——它们是任何长时程 agent 都要解决的基础设施问题。

值得单独指出两项。Manual Context Compaction(手动上下文压缩)承认了一件多数 harness 回避的事:自动压缩在什么时候压、压掉什么,用户往往没有控制权,而错误的压缩会让长任务在中途失去关键前提。把手动压缩做成一等能力,等于把上下文管理交还给操作者。Session Goals(会话目标)则给长任务一个持久锚点,与本项目 AGENTS.md 里那种「目标」概念同源。

运行与部署

官方推荐 Docker 部署。本地开发从 git clone 加 make setup 开始:一个交互式向导带你选 LLM provider、可选的 web search,以及执行与安全偏好——沙箱模式、bash 访问、文件写入工具——最后生成最小 config.yaml 并把密钥写进 .env,官方说大约两分钟。make doctor 随时验证配置并给出可执行的修复提示;开 issue 前跑 make support-bundle 会生成 issue summary 与 draft 文件。

还有一条为 agent 时代准备的安装路径:README 直接给出一句可以丢给 Claude Code / Codex / Cursor / Windsurf 的 prompt,让编码 agent 自己去 clone 并按 Install.md bootstrap,有 Docker 就选 Docker,并停在「下一条确切命令 + 用户还缺什么配置」。把安装文档写成可被 agent 消费的形式,这是 harness 项目该有的自觉。

可观测性给了三条追踪路径:LangSmith、Langfuse、Monocle。IM 渠道是内置的。搜索与抓取接了 Jina、Browserless,以及 BytePlus 自研的 InfoQuest——这三者的 web fetch 会用请求页面 URL 解析相对链接与图片源,所以返回的 Markdown 带完整目标地址。另有 per-model 的 request_admission 选项做请求节流以贴合 provider 的 RPM 限制,默认关闭。

姊妹项目与模型建议

LLM Space 是官方点名的姊妹项目:一个桌面工具,用来原型化 agent 想法、检查 harness 的每一步、重放失败、跑性能基准。README 称它是 DeerFlow 背后的「秘密武器」。这条线索值得追:harness 最难的部分不是跑通,而是失败之后能定位到是哪一步。

官方推荐用 Doubao-Seed-2.0-Code、DeepSeek v3.2 与 Kimi 2.5 来跑 DeerFlow,并给了火山引擎 Coding Plan 的入口(中国大陆另有 volcengine 链接)。这属于厂商生态引导,读者应把它当作建议而非前提:harness 本身不锁模型。

边界与需要自己判断的地方

README 有一节 ⚠️ Security Notice,标题是「不当部署可能引入安全风险」,并给出安全建议。一个默认能跑 bash、能写文件、能接 IM 渠道对外收发消息的 harness,如果按默认配置暴露到公网,风险是实在的。部署前必须读这一节,并把沙箱模式打开。

README 文件本身有 18 万字符量级,信息密度高但也意味着上手成本不低。我们没有对它做过基准或复现测试,星标与 Trending 第一说明关注度。把它列进 harness 梯顶是因为它是「super agent harness」这条路线上规模最大、文档最完整的开源样本之一,能力水位这一档记为待复现。