DeerFlow 2.0完整上手指南：能深度研究、写代码、出图图的开源Agent框架一次讲清-育师

DeerFlow 2.0完整上手指南：能深度研究、写代码、出图图的开源Agent框架一次讲清

【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow

DeerFlow 是一个开源的超级智能体框架（SuperAgent harness），把子代理、沙箱、记忆、技能和消息网关打包成一套开箱即用的运行时，专门处理从几分钟到几小时量级的长程任务。如果你需要一个既能做深度研究、又能跑代码出图表、还能顺手生图和做 PPT 的 Agent 系统，这篇指南会带你走完从克隆仓库、跑起服务到卡住时去哪求助的全过程。

想出一份调研报告或分析结论时，DeerFlow 能接住什么活

先说它解决的痛点：普通聊天机器人只会回文字，你要图表、要代码验证、要多步产出，就得自己来回搬。DeerFlow 不一样，它在 Agent 外面搭了一层"手脚"——联网搜索和网页爬取、沙箱里跑 Python 和 bash、读写文件、派生子代理并行干活，甚至能接飞书、钉钉、Telegram 等 IM 渠道，直接在聊天窗口里给它派任务。典型的场景比如：拿到一个陌生行业的题目要交调研结论、手上一份 CSV 不知道能看出什么、要一版带图和配图的 PPT。这些都可以作为单次运行丢给它。

两条命令装好 DeerFlow 并跑起本地 Web 控制台

git clone https://gitcode.com/GitHub_Trending/de/deer-flow cd deer-flow && make setup

make setup是一个交互式向导：选 LLM 供应商、要不要联网搜索、沙箱模式怎么开，大概两分钟就生成好config.yaml并把密钥写进.env。接下来二选一：Docker 用户执行make docker-start，本地开发执行make dev，然后打开http://localhost:2026就能看到 Web 界面。启动遇到问题时先跑make doctor，它会直接告诉你哪一步没配对。

DeerFlow 最实用的四个用例：研究、出图、出报告、自定义技能

丢一个题目，自动检索资料并产出深度研究报告

深度研究是 DeerFlow 最出名的能力：给定一个课题，它会自己拆问题、联网检索、抓取网页、在沙箱里验证数据，最后整理成结构化报告。相关技能位于 skills/public/deep-research/，下面这张演示图就是它在研究任务中自行取回的历史场景素材。

扔一份 CSV 进去，直接产出分析图表

内置的 chart-visualization 和 />

批量生成产品图与配套视觉素材

研究之外，它也能"出图"。image-generation 和 video-generation 技能可以按提示词生成图片、海报和视频素材，ppt-generation 技能则把它们和文案组装成幻灯片。演示库里这套护肤品产品图就是 Agent 直接生成的产物，风格、构图一次到位。

写一个自定义技能，让 DeerFlow 学会新本领

技能（Skill）本质是一个 Markdown 包，描述流程和最佳实践，DeerFlow 按需渐进加载，不占满上下文窗口。用内置的skill_manage工具就能创建和打补丁，对话里以/技能名开头可以强制激活某个技能，例如/data-analysis analyze uploads/foo.csv。不想从零写的话，skill-creator 和 skill-reviewer 两个官方技能分别负责"帮你造"和"帮你审"。下图是一次技能管理端到端验证的现场：创建、打补丁、校验描述全部通过。

配置卡住或想扩展时，按这个顺序查文档和求助

卡住别硬猜，按"自诊 → 文档 → 社区"的顺序来：

先自诊：make doctor检查环境；要报 bug 时跑make support-bundle，它会把诊断摘要写成 Markdown 文件，直接贴进 Issue 即可，省去一大截来回追问。
再查文档，仓库里都有现成入口：
- 安装与部署：backend/docs/SETUP.md
- 接口说明：backend/docs/API.md
- 架构总览：backend/docs/ARCHITECTURE.md
- 沙箱、MCP 与配置项：backend/docs/CONFIGURATION.md、backend/docs/MCP_SERVER.md
- IM 渠道接入：backend/docs/IM_CHANNEL_CONNECTIONS.md
想扩展：改 extensions_config.example.json 或 config.example.yaml 这类模板起步，MCP 服务器、自定义工具、LangSmith/Langfuse 链路都在其中；装扩展包用make extension-install。
实在解决不了：到仓库提 Issue 或 Pull Request，协作约定写在 CONTRIBUTING.md 里，安全相关的问题参照 SECURITY.md。