快速摘要 DeerFlow 2.0 是字节跳动于 2026 年 2 月底开源的一个超级智能体调度框https://blog.csdn.net/weixin_57908930/article/details/159647948?spm1001.2101.3001.6650.5utm_mediumdistribute.pc_relevant.none-task-blog-2%7Edefault%7Ebaidujs_baidulandingword%7ECtr-5-159647948-blog-159636373.235%5Ev43%5Epc_blog_bottom_relevance_base9depth_1-utm_sourcedistribute.pc_relevant.none-task-blog-2%7Edefault%7Ebaidujs_baidulandingword%7ECtr-5-159647948-blog-159636373.235%5Ev43%5Epc_blog_bottom_relevance_base9utm_relevant_index9架SuperAgent Harness基于 LangGraph 1.0 从零重写与 1.x 版本没有任何共用代码。它的核心能力在于让 AI 不再只是给建议而是能在隔离的 Docker 沙箱中真正执行代码、生成文件、部署应用。它内置了子智能体并行调度、跨会话持久记忆、可扩展的 Skill 技能系统并且不绑定任何特定大语言模型。 目前该项目在 GitHub 上已积累超过 50K Star是 2026 年初最受关注的开源 AI Agent 项目之一。往下看有更详细的架构拆解、部署教程和实操指南。从建议型 AI到执行型 AIDeerFlow 解决了什么问题如果你用过 ChatGPT、文心一言或者其他主流 AI 助手一定对这个场景不陌生你让 AI 帮你写一段 Python 脚本它把代码贴给你了然后你得自己复制到编辑器里、安装依赖、运行调试。如果结果不对再把报错信息粘回去让它修改。一来一回效率其实并没有想象中那么高。这就是所谓的手动交接问题Hand-off Problem——AI 负责思考人类负责执行。AI 做了 60% 的认知工作但 0% 的执行工作。DeerFlow 2.0 想要打破的就是这个瓶颈。它的设计理念可以用一句话概括执行优先。当你给它一个任务时它不仅会帮你想好怎么做还会真的动手去做——在一个隔离的 Docker 容器里启动环境、安装依赖、运行代码、输出结果。整个过程你可以完全不参与。换句话说传统 AI 助手的工作方式是我告诉你怎么做你自己去执行而 DeerFlow 的工作方式是你告诉我做什么我从头到尾帮你搞定。这种从建议到执行的范式转变对日常工作效率的提升是显而易见的。想象一下你需要爬取某个网站的数据、清洗成表格、生成分析图表、最后整理成 PPT——以前你可能需要在 AI 和各种工具之间来回切换好几个小时现在你只需要用一句话描述需求然后等结果就好。我在黑龙江节点云计算科技公司考人工智能训练师的时候曾经花大量时间研究各类 Agent 框架的调度机制当时市面上大多数方案要么停留在概念验证阶段要么需要开发者自己拼接大量基础设施。DeerFlow 2.0 给我的第一感觉是它不是一个需要你组装的框架而是一个拿来就能用的运行时环境。DeerFlow 的前世今生DeerFlow 的全称是 Deep Exploration and Efficient Research Flow深度探索与高效研究流程。最早它是字节跳动内部的一个深度研究工具主要用于自动化信息搜集和报告生成。但开源之后社区把它玩出了花——有人用它搭建数据分析流水线有人拿它自动生成 PPT还有人用它从零部署完整的网站。字节的团队意识到DeerFlow 的价值远不止做研究它本质上是一个通用的智能体运行时基础设施。于是他们做了一个大胆的决定从零重写。2026 年 2 月 27 日DeerFlow 2.0 正式发布发布当天就冲上了 GitHub Trending 第一名。截至目前项目 已经积累超过 50K Star 和 5800 多个 Fork。架构全解DeerFlow 2.0 到底是怎么运行的理解 DeerFlow 的架构是用好它的前提。下面我们从整体到局部拆解它的设计思路。全栈服务拓扑DeerFlow 2.0 采用四进程加反向代理的全栈架构所有外部流量都通过一个 Nginx 反向代理默认端口 2026进入系统┌─────────────────────────────────────────────────────────┐│ Nginx (Port 2026) ││ 统一入口 / 反向代理 │└─────────────────────────────────────────────────────────┘│┌───────────────┼───────────────┐▼ ▼ ▼┌─────────────────┐ ┌─────────────┐ ┌──────────────┐│ Frontend │ │ Gateway │ │ LangGraph ││ (Next.js) │ │ API │ │ Server ││ Port 3000 │ │ Port 8001 │ │ Port 2024 │└─────────────────┘ └─────────────┘ └──────────────┘│┌──────┴──────┐▼ ▼┌──────────┐ ┌──────────┐│ Sandbox │ │ Memory ││ Docker │ │ System │└──────────┘ └──────────┘一键获取完整项目代码每个组件各司其职FrontendNext.js端口 3000 提供 Web 用户界面使用 Zustand 进行状态管理通过 SSEServer-Sent Events实现流式响应。Gateway APIFastAPI端口 8001 是后端的 REST 接口层负责模型管理、技能管理、记忆读写、文件上传等操作。它暴露了 Models、MCP、Skills、Memory、Uploads、Artifacts 六个路由模块。LangGraph Server端口 2024 是真正的智能体运行时负责任务分解、子智能体调度、工具调用和结果整合。它基于 LangGraph 的状态图实现工作流编排。SandboxDocker 容器 为每个任务提供隔离的执行环境包含独立的文件系统和 Bash 终端。Memory System 负责跨会话的持久化记忆存储用户偏好、项目上下文和历史知识。Nginx 根据请求路径做分发前端页面请求转给 Next.js/api/langgraph/ 前缀的请求转给 LangGraph Server同时去掉前缀其余 /api/ 请求转给 Gateway API。Lead Agent任务的总指挥DeerFlow 的核心调度逻辑由一个 Lead Agent主智能体驱动。当你输入一个任务后Lead Agent 会经历以下流程首先它会分析任务的复杂度。如果是简单的问答直接回答即可如果是复杂的多步骤任务比如帮我调研 2026 年 AI Agent 的发展趋势写成一份带图表的研究报告它就会启动规划流程。接着Lead Agent 会制定执行计划把大任务拆解成若干子任务。每个子任务会被分配给一个专门的子智能体这些子智能体可以并行执行。系统默认最多允许 3 个子智能体同时运行可配置范围 2-4超出限额的任务会排队等待。最后所有子智能体完成工作后Lead Agent 会汇总结果整合成最终的交付物——可能是一篇报告、一个网页、一组幻灯片甚至是一段视频。值得一提的是DeerFlow 还支持 Human-in-the-Loop人类参与环节。你可以在执行前审查和修改 AI 生成的执行计划也可以设置为自动执行模式跳过审批。子智能体系统各司其职的专业团队DeerFlow 内置了多种角色的子智能体每个角色都有自己专属的工具链和上下文Researcher研究员擅长网络搜索、信息搜集和资料整理。它可以调用搜索引擎、网页爬虫甚至 MCP 协议提供的外部服务来获取信息。Coder程序员负责编写和执行代码。它拥有 Python REPL 工具可以在沙箱中安装依赖、运行脚本、调试程序。Reporter报告员专注于将搜集到的信息和生成的数据整合成结构化的文档输出比如 Markdown 报告、PPT 或网页。举个实际的例子假设你让 DeerFlow 帮你做一份关于泰坦尼克号数据集的探索性分析报告。Lead Agent 可能会这样拆解任务——派一个 Researcher 去搜集数据集的背景资料同时派一个 Coder 去下载数据、清洗数据、生成可视化图表最后让一个 Reporter 把所有结果整合成一份带图文的分析报告。这三个智能体可以并行工作最终交付一份完整的成果。五大核心能力深度拆解Docker 沙箱给 AI 一台专属电脑这是 DeerFlow 最具突破性的设计。传统的 AI 助手在你的对话窗口里假装执行代码——它告诉你代码应该怎么写但真正的执行环境是你的电脑。DeerFlow 不一样它给每个任务分配了一个真实的、隔离的 Docker 容器里面有完整的文件系统和 Bash 终端。在这个容器里智能体可以读写文件、执行 Bash 命令、安装 pip/npm 依赖包、运行 Python 脚本、甚至启动 Web 服务。任务完成后容器可以销毁不会对宿主机产生任何影响。DeerFlow 支持三种沙箱模式Local 模式直接在本地机器上执行适合开发调试但隔离性较弱。Docker 模式推荐使用 AIOAll-in-One沙箱容器隔离性好适合单机部署。Kubernetes 模式通过一个 Provisioner 服务动态分配 K8s Pod适合企业级多人协作场景。沙箱的路径管理也很讲究每个任务线程thread都有独立的 workspace、uploads 和 outputs 目录数据互不干扰。当你上传一个 PDF 文件让 DeerFlow 分析时文件会被放入该线程的 uploads 目录智能体生成的中间文件保存在 workspace 中最终交付物则输出到 outputs 目录供你下载。这种清晰的路径隔离设计既保证了安全性也让多任务并行成为可能。从工程实践的角度来看Docker 沙箱解决了一个非常现实的问题信任边界。当你让 AI 执行代码时你并不清楚它会运行什么命令。如果它直接在你的机器上执行 rm -rf / 或者安装了一个有安全漏洞的依赖包后果不堪设想。沙箱容器把这些风险限制在了一个可控的范围内——即使出了问题也只影响容器内部不会波及宿主机。跨会话持久记忆越用越懂你DeerFlow 的记忆系统不是简单的记住你上一句说了什么而是一套跨会话的长期记忆机制。它的记忆结构分为三个层次用户上下文User Context简短的描述概括你当前的工作和关注点。历史记录History分为近期历史和长期背景记录你过去与系统交互的要点。事实存储Facts离散的知识点每条事实都带有置信度评分和时间戳。记忆的更新是异步的通过一个防抖队列debounced queue在后台完成不会阻塞你的对话流程。系统还会自动去重避免相同的偏好和上下文被重复记录。这意味着当你反复使用 DeerFlow 处理某个项目时它会逐渐了解你的编程风格、文档偏好、项目结构等信息在后续任务中提供更贴合你需求的输出。记忆数据默认存储在本地数据主权完全归你控制。近期项目还新增了 TIAMAT 云端记忆后端的支持为企业级场景提供了更灵活的选择。Skill 技能系统用 Markdown 定义 AI 的工作手册DeerFlow 的技能系统设计得非常巧妙——每个 Skill 本质上就是一个 Markdown 文件里面用 YAML 前置信息定义元数据正文部分描述工作流程、最佳实践和参考资源。---name: research-reportversion: 1.0.0description: 生成深度研究报告author: DeerFlow Team---# 研究报告生成技能## 工作流程1. 根据用户输入确定研究主题和范围2. 使用搜索工具搜集相关资料至少 5 个来源3. 分析和交叉验证搜集到的信息4. 生成结构化的研究报告包含引用来源## 输出要求- 报告长度3000-5000 字- 必须包含数据图表- 所有结论需要有来源支撑一键获取完整项目代码系统在启动时会递归扫描 skills/public/ 和 skills/custom/ 目录解析所有 Skill 文件然后根据 extensions_config.json 中的启用状态决定哪些技能可用。新发现的技能默认是启用的。DeerFlow 开箱即用的内置技能包括深度研究与报告生成、PPT 制作、网页搭建、图片和视频生成、数据分析与可视化等。但真正强大的是它的扩展性——你可以编写自己的 Skill打包成 .skill 压缩包通过 Gateway API 安装或者直接把 Markdown 文件放到 skills/custom/ 目录下。技能的加载是渐进式的Lead Agent 只在需要时才加载相关技能而不是一次性把所有技能塞进上下文。这种设计在处理长时间运行的任务时能显著节省 Token 消耗。多模型支持不绑定随便换DeerFlow 在模型选择上非常开放它兼容任何实现了 OpenAI 兼容 API 的大语言模型。你可以在 config.yaml 中配置多个模型按需切换。官方推荐搭配以下模型使用效果较好Doubao-Seed-2.0-Code字节自家的代码生成模型DeepSeek v3.2在推理和结构化输出方面表现优秀Kimi 2.5长上下文窗口和多模态能力出色当然你也可以接入 GPT-4 系列、Claude 系列或者通过 Ollama 使用本地部署的开源模型。不过需要注意的是DeerFlow 的 Lead Agent 需要比较强的指令遵循和结构化输出能力来完成任务分解和子智能体调度较小的本地模型可能无法胜任这一角色。对于模型的推荐配置官方建议优先选择支持长上下文窗口10 万 Token 以上、具备推理能力、支持多模态输入和可靠工具调用的模型。MCP 协议集成打通外部工具链DeerFlow 通过 Model Context ProtocolMCP实现了与外部工具和服务的集成。MCP 是一种标准化的协议允许 AI 模型安全地调用外部工具。DeerFlow 的 MCP 客户端支持 stdio、SSE 和 HTTP 三种传输方式还支持 OAuth 令牌流程包括 client_credentials 和 refresh_token。MCP 工具采用懒加载策略——只在首次使用时初始化并通过文件修改时间mtime实现缓存失效检测。此外DeerFlow 还集成了字节自研的 InfoQuest 智能搜索和爬取工具集为网络信息搜集提供了更强大的支持。手把手教你部署 DeerFlow 2.0说了这么多原理接下来进入实操环节。DeerFlow 提供了多种部署方式这里以官方推荐的 Docker 部署为例带你一步步跑通整个流程。前置条件在开始之前请确保你的机器上已经安装了以下工具Git用于克隆代码仓库Docker用于运行沙箱容器建议 Docker 20.10 及以上版本Docker Compose用于编排多个服务Make用于执行项目提供的快捷命令至少一个大语言模型的 API Key比如 OpenAI、DeepSeek 或 Kimi第一步克隆仓库打开终端执行以下命令git clone https://github.com/bytedance/deer-flow.gitcd deer-flow一键获取完整项目代码第二步生成配置文件make config一键获取完整项目代码这条命令会在项目根目录下生成 config.yaml 和 .env 两个配置文件。config.yaml 是主配置文件.env 用来存放密钥等敏感信息。第三步配置模型编辑 config.yaml在 models 部分添加你想使用的模型。以下是一个配置 DeepSeek 的示例models:- name: deepseek-v3display_name: DeepSeek V3.2use: langchain_openai:ChatOpenAImodel: deepseek-chatapi_key: $DEEPSEEK_API_KEYbase_url: https://api.deepseek.com/v1max_tokens: 4096temperature: 0.7一键获取完整项目代码如果你想同时配置多个模型只需要在 models 列表中继续添加即可。DeerFlow 的前端界面支持在对话中随时切换模型。第四步设置 API 密钥编辑 .env 文件填入你的 API 密钥# 大语言模型的密钥根据你的模型选择填写DEEPSEEK_API_KEYyour-deepseek-api-key# 搜索工具的密钥用于 Researcher 智能体的网络搜索能力TAVILY_API_KEYyour-tavily-api-key一键获取完整项目代码Tavily 是 DeerFlow 默认使用的搜索 API你需要在 Tavily 官网注册并获取 API Key。如果你不需要网络搜索功能也可以暂时不配置。第五步初始化并启动# 首次运行需要初始化拉取沙箱镜像等make docker-init# 启动所有服务make docker-start一键获取完整项目代码初始化过程可能需要几分钟因为需要拉取 Docker 镜像。启动完成后所有服务会以容器的形式运行在 deer-flow-dev Docker 网络中。如果在初始化过程中遇到网络问题导致镜像拉取失败可以尝试配置 Docker 的镜像加速器。国内用户可以使用阿里云、腾讯云等提供的容器镜像服务来加速下载。启动成功后你可以通过 docker ps 命令查看各服务的运行状态。正常情况下你应该能看到 Nginx、Frontend、Gateway、LangGraph Server 和 Sandbox 等多个容器在运行。如果需要停止服务执行 make docker-stop如果需要查看实时日志来排查问题可以使用 docker logs -f 容器名 命令。第六步打开浏览器使用在浏览器中访问http://localhost:2026一键获取完整项目代码你会看到 DeerFlow 的 Web 界面。在对话框中输入你的任务比如帮我搜集最近一个月关于大语言模型的研究论文生成一份中文综述报告然后等待结果就好。进阶Python 客户端嵌入除了 Web 界面DeerFlow 还提供了一个 Python 客户端可以在不启动 HTTP 服务的情况下直接调用 DeerFlow 的能力from deerflow.client import DeerFlowClientclient DeerFlowClient()# 同步对话response client.chat(分析这篇论文, thread_idmy-thread)# 流式输出for event in client.stream(你好):if event.type messages-tuple and event.data.get(type) ai:print(event.data[content])# 管理技能skills client.list_skills()client.update_skill(web-search, enabledTrue)# 上传文件client.upload_files(thread-1, [./report.pdf])一键获取完整项目代码这个客户端与 Gateway API 共享相同的 Pydantic 响应模型并在 CI 中通过一致性测试来保证两者的接口同步。对于想把 DeerFlow 集成到自己项目中的开发者来说这是非常实用的。与其他 Agent 框架的定位对比在当前的 AI Agent 生态中DeerFlow 并不是唯一的选择。理解它与其他框架的差异有助于你做出更合理的技术选型LangGraph / LangChain 是 DeerFlow 的底层依赖。LangGraph 提供了细粒度的图控制能力适合需要自定义编排逻辑的场景。但它本身不提供沙箱、记忆、技能系统等上层基础设施这些都需要你自己搭建。DeerFlow 可以理解为 LangGraph 的全家桶版本。CrewAI 采用基于角色的抽象设计上手简单适合快速原型开发。但它对长时间运行的复杂任务支持有限。AutoGen微软 在学术研究和多智能体对话场景中表现出色社区活跃度很高。但在生产级部署方面缺少 DeerFlow 那样开箱即用的运行时环境。DeerFlow 的独特定位在于它是一个完整的运行时而不是一个需要你自己组装的工具包。 沙箱隔离、子智能体编排、长期记忆、技能系统、消息网关——这些能力都是开箱即用的。如果你的需求是执行需要数分钟到数小时的复杂自主任务DeerFlow 目前是可用性较高的开源选项之一。打一个通俗的比方LangGraph 像是一箱乐高积木你可以用它搭出任何形状但得自己动手CrewAI 像是一个预组装的模型套件上手快但灵活性有限AutoGen 像是一个实验室工具适合探索和研究。而 DeerFlow 更像是一台已经装好系统的电脑——开机就能用想折腾也可以拆开自定义。还有一个值得关注的对比对象是 Claude Code。Claude Code 同样给智能体提供了文件系统和 Bash 访问能力但它是闭源的、绑定特定模型的。DeerFlow 则是完全开源、模型无关的而且支持自托管部署对数据隐私有要求的团队来说更加友好。实际应用场景举例根据社区反馈和官方文档DeerFlow 2.0 目前已经在以下场景中得到了验证深度研究与报告生成给定一个研究主题DeerFlow 可以自动搜索网络资料、交叉验证信息来源、生成带有引用和图表的研究报告。这也是它最初的核心场景。比如你可以让它调研 2026 年全球 AI 芯片市场格局生成一份带有市场份额图表的中文研究报告它会自动完成从信息搜集到报告排版的全部工作。全栈应用开发从一个文字描述的需求出发自动生成前端页面、后端逻辑和测试代码甚至在沙箱中启动服务进行验证。社区中已经有人用 DeerFlow 从一句话需求开始自动生成了完整的 Web 应用并在沙箱中完成了功能测试。数据分析流水线上传一个 CSV 数据集DeerFlow 可以自动完成数据清洗、特征分析、可视化图表生成输出一份完整的分析报告。对于不擅长编程的数据分析人员来说这大大降低了使用 Python 做数据分析的门槛。内容创作与演示文稿根据主题自动生成 PPT 幻灯片、搭建展示网页甚至利用图像和视频生成技能制作多媒体内容。你可以给它一段会议纪要让它自动整理成一份结构清晰的演示文稿。自动化工作流结合 MCP 协议和消息网关支持 Slack、飞书、Telegram可以通过聊天消息触发复杂的自动化任务。比如在飞书群里发一条消息DeerFlow 帮我查一下竞品 XX 最近的动态它就会自动开始研究并把结果回传到群里。部署安全与注意事项DeerFlow 的强大能力也意味着需要认真对待安全问题。以下是一些关键的注意事项默认只允许本地访问。DeerFlow 的设计初衷是在本地可信环境中运行默认只绑定 127.0.0.1 回环接口。如果你需要在局域网或公网环境中部署务必配置好访问控制和身份验证否则可能导致未授权的命令执行。沙箱并不意味着万无一失。虽然 Docker 容器提供了进程级隔离但在配置不当的情况下比如挂载了宿主机的敏感目录仍然可能存在安全风险。建议使用最小权限原则配置容器。API 密钥管理。你的模型 API 密钥存储在 .env 文件中确保这个文件不会被提交到版本控制系统也不要在不可信的环境中暴露。模型选择的考量。如果你选择使用本地部署的模型来避免数据外传需要确认模型的推理能力足以支撑任务分解和结构化输出。Lead Agent 对模型的指令遵循能力要求较高小参数模型可能会导致调度失败。官方建议至少使用具备强推理能力的中大规模模型比如 70B 参数以上的开源模型。网络隔离。在生产环境中部署时建议将 DeerFlow 的各服务放在内网中通过 VPN 或堡垒机访问。沙箱容器的网络出口也应该做适当限制避免智能体在执行任务时访问不受控的外部资源。许可证合规。DeerFlow 采用 MIT 许可证这是最宽松的开源许可之一允许商业使用、修改和再分发。但如果你在项目中接入了第三方模型或服务还需要遵守这些服务各自的使用条款。如何参与社区贡献DeerFlow 采用 MIT 开源许可证你可以自由使用、修改和商业部署。如果你想参与贡献以下是一些入口GitHub 仓库https://github.com/bytedance/deer-flow官方文档https://deerflow.techIssue 和 PR项目的 GitHub Issues 是报告问题和提交需求的主要渠道自定义 Skill 开发编写你自己的技能 Markdown 文件提交到社区共享项目的 1.x 分支仍然接受维护性贡献但主要的开发精力已经转移到 2.0 版本。总结DeerFlow 2.0 代表了 AI Agent 框架从对话辅助向自主执行演进的一个重要节点。它把沙箱隔离执行、多智能体并行调度、持久化记忆、可扩展技能系统等企业级能力打包成一个开箱即用的开源方案大大降低了构建自主智能体系统的门槛。当然它也不是完美的。持久记忆系统在实际使用中的可靠性还需要更多验证对本地小模型的支持也有一定限制。但作为一个仍在快速迭代的开源项目DeerFlow 2.0 已经展现出了足够的技术深度和社区活力。如果你正在评估 AI Agent 框架或者想亲手体验执行型 AI带来的效率提升DeerFlow 2.0 值得你花时间认真试一试。项目地址 https://github.com/bytedance/deer-flow官方文档 https://deerflow.tech————————————————版权声明本文为CSDN博主「节点云科」的原创文章遵循CC 4.0 BY-SA版权协议转载请附上原文出处链接及本声明。原文链接https://blog.csdn.net/weixin_57908930/article/details/159647948