正在打开工具详情…
正在打开工具详情…
字节开源的 super agent harness：编排子代理、记忆、沙箱与技能，接调研、编码这类要跑几分钟到几小时的任务。适合想自建长任务代理的人；代价是配置与安全都重，README 明确警告网关管理员权限等同代码执行。
想自己搭一个能跑长任务（调研 + 编码 + 产出）的代理系统的人，尤其已经熟悉 LangGraph、愿意自己管配置与部署的团队。
只想一键出一份研究报告的人——1.x 那条线更轻；也不适合没有部署经验的人，README 自己把网关权限等同代码执行写进了安全警告。
DeerFlow 2.0 是一次彻底重写，和 1.x 不共用代码——原来那个 Deep Research 框架还在 main-1.x 分支上维护，2.0 的定位是 super agent harness：用子代理、记忆（DeerMem 做记忆抽取）、沙箱和可扩展技能去接「几分钟到几小时」的长任务，不再只是产出一份研究报告。它建在 LangGraph 上，前端有项目、文档架、定时任务、终端 TUI 这一整套，私有知识检索还能接 RAGFlow。
上手路径是 git clone 后 make setup：一个交互向导，让你选 LLM provider、可选的联网搜索，以及沙箱模式、bash 访问、文件写工具这类执行与安全偏好，生成最小 config.yaml 并把 key 写进 .env，约两分钟。之后随时 make doctor 验环境，要提 issue 就跑 make support-bundle（生成可直接粘进 issue 的摘要、AI 草稿与诊断 zip，且不含 .env、原始对话和用户文件内容）。
两个要提前知道的坑。一是安全：README 单独写了一节，说部署不当会引入安全风险，网关管理员权限等同代码执行，外部聊天消息的角色也当作不可信输入处理。二是委托式抓取后端：自托管的 Browserless、Crawl4AI、Firecrawl、fastCRW 默认会被拒绝，必须先确认出站隔离（私有网段、loopback、链路本地、云元数据）再设 network_isolation_confirmed: true，因为重定向、DNS 和子资源都是这些服务自己处理的；make doctor 会列出会被拒的配置。另外 InfoQuest 的 reader / 网页搜索 / 图片搜索用的是 30 秒 HTTP 连接与读取不活动超时，抓取的 、 是另一组服务端选项，别混着调。
timeoutnavigation_timeout上手步骤之外的具体做法：常见场景怎么配、命令怎么写、报错怎么处理。
按第一次上手会卡在哪讲：2.0 与 1.x 分支不是同一套代码、make setup 向导会问什么、委托抓取后端的隔离门槛、以及 README 里那条安全警告到底意味着什么。
README 开宗明义：DeerFlow 2.0 是彻底重写，与 v1 不共用任何代码。如果你要的是原来那个 Deep Research 框架，它在 main-1.x 分支上继续维护；2.0 是 super agent harness，目标是「几分钟到几小时」的通用长任务。
bashgit clone https://github.com/bytedance/deer-flow.git
cd deer-flow
make setup向导会依次问：
它生成一个最小 config.yaml，把 key 写进 .env，全程约两分钟。之后出问题先跑：
bashmake doctor不想一步步点，也可以把这句话交给 Claude Code / Codex / Cursor：
textHelp me clone DeerFlow if needed, then bootstrap it for local development by
following https://raw.githubusercontent.com/bytedance/deer-flow/main/Install.md这一条最容易莫名其妙被拒。自托管的 Browserless、Crawl4AI、Firecrawl、fastCRW 后端，DeerFlow 默认拒绝，因为它们自己处理重定向、DNS 解析和子资源。要启用必须先确认出站隔离——私有网段、loopback、链路本地、云元数据地址都要断掉——再给对应工具设：
yamlnetwork_isolation_confirmed: trueallow_private_addresses 只是允许你故意访问内网目标，不能绕过这个后端检查。make doctor 会直接列出会被拒绝的后端配置。
README 用了一整节讲这件事，核心两条：
开放部署前先按 README 的 Deployment Defaults 与 Security Recommendations 过一遍。
InfoQuest 的 reader、网页搜索、图片搜索用的是 30 秒 HTTP 连接 / 读取不活动超时；抓取的 timeout 与 navigation_timeout 是独立的服务端选项，改后者不会影响前者。