模型 / 資料集
bytedance/deer-flow avatar
bytedance/deer-flow

DeerFlow 2.0:位元組跳動的開源長期任務代理框架

一個開源的長期 SuperAgent 工具,用於研究、編碼和創建。借助沙箱、記憶體、工具、技能、子代理程式和訊息網關,它可以處理可能需要幾分鐘到幾小時的不同級別的任務。

82,492 個 Star11,377 個 ForkPythonMIT

秒懂

它是什麼?
一個編排子代理、記憶、沙箱和技能的超級代理框架,是從原有深度研究框架的徹底重寫。
適合誰用?
bytedance/deer-flow 適合需要 README 所列工作流、且能接受其目前版本狀態的使用者;不適合把未載明的相容性、效能或安全承諾當成既定事實的團隊。先依 README 的專屬入口核對 v2.0.0、設定鍵與輸出邊界,再決定是否納入正式流程。
可以商用嗎?
可以。MIT 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫在最近一天內有新的提交。
用什麼語言寫的?
主要是 Python(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

bytedance-deer-flow-deep-analysis|DeerFlow 的研究任務管線

bytedance-deer-flow-deep-analysis|DeerFlow 的研究任務管線 的專案脈絡:DeerFlow 最初是一個深度研究框架,但 README 稱社群將其推向了研究之外,構建了資料管道、幻燈片、儀表板和工作流程。維護者得出結論,它不只是研究工具,而是一個框架,因此從頭重寫。DeerFlow 2.0 與 v1 不共享任何程式碼;原版在 1.x 分支上維護,活躍開發已轉向 2.0。其名稱展開為 Deep Exploration and Efficient Research Flow。README 未提供 v1 與 v2 的對比,僅說明了重寫這一事實。

bytedance-deer-flow-deep-analysis|DeerFlow 的研究任務管線:bytedance/deer-flow 的 README 是本文的事實邊界。第 1 節所述內容,應回看 DeerFlow 的研究任務管線 涉及的指令、檔案或設定鍵;素材沒有交代的行為不在本文推定範圍內。 bytedance/deer-flow 的版本快照是 v2.0.0,這個標記只用來定位檔案,不代表本文已執行該版本。 這個區分讓檔案明載的能力與尚待確認的部署條件保持分開,也能避免把單一範例誤讀成完整相容矩陣。

bytedance-deer-flow-deep-analysis|sandbox、memory 與 graph 的分工

bytedance-deer-flow-deep-analysis|sandbox、memory 與 graph 的分工 的專案脈絡:README 的快速入門從專案根目錄執行 make setup,該指令啟動互動式精靈,用於選擇 LLM 提供者、可選網路搜尋以及沙箱模式、bash 存取和檔案寫入工具等執行偏好。精靈產生最小的 config.yaml 並將金鑰寫入 .env,大約需要兩分鐘。make doctor 可驗證設定並給出修復提示。對於問題報告,make support-bundle 會產生摘要、草稿和可選證據壓縮包,存放於 .deer-flow/support-bundles 下,僅包含去識別診斷和檔案清單,不包含 .env 或對話訊息。在 Windows 上,本機開發必須從 Git Bash 執行;cmd.exe 和 PowerShell 不支援基於 bash 的指令碼。

bytedance-deer-flow-deep-analysis|sandbox、memory 與 graph 的分工:bytedance/deer-flow 的 README 是本文的事實邊界。第 2 節所述內容,應回看 sandbox、memory 與 graph 的分工 涉及的指令、檔案或設定鍵;素材沒有交代的行為不在本文推定範圍內。 這個區分讓檔案明載的能力與尚待確認的部署條件保持分開,也能避免把單一範例誤讀成完整相容矩陣。

bytedance-deer-flow-deep-analysis|自託管部署對外部服務的依賴

bytedance-deer-flow-deep-analysis|自託管部署對外部服務的依賴 的專案脈絡:Docker 是推薦路徑。make docker-init 拉取沙箱映像,make docker-start 啟動服務,make up 建置映像並啟動生產服務,make down 用於停止。README 包含規模參考表:本機評估從 4 vCPU、8 GB 記憶體、20 GB 可用 SSD 起步;Docker 開發為 4 vCPU、8 GB、25 GB;長期執行伺服器為 8 vCPU、16 GB、40 GB。對於本機開發,make check 驗證 Node.js 22+、pnpm、uv 和 nginx,然後 make install 和 make dev 啟動服務。兩種情況均透過 http://localhost:2026 存取。README 指出,後端處理程序會在下一次設定存取時自動拾取 config.yaml 變更,但檢查點儲存設定除外,需要重新啟動。

bytedance-deer-flow-deep-analysis|自託管部署對外部服務的依賴:bytedance/deer-flow 的 README 是本文的事實邊界。第 3 節所述內容,應回看 自託管部署對外部服務的依賴 涉及的指令、檔案或設定鍵;素材沒有交代的行為不在本文推定範圍內。 這個區分讓檔案明載的能力與尚待確認的部署條件保持分開,也能避免把單一範例誤讀成完整相容矩陣。

bytedance-deer-flow-deep-analysis|沙箱執行、MCP 伺服器和 IM 頻道

bytedance-deer-flow-deep-analysis|沙箱執行、MCP 伺服器和 IM 頻道 的專案脈絡:沙箱模式包括直接在主機上本機執行、在隔離容器中執行 Docker,以及透過 provisioner 服務在 Kubernetes 中執行。MCP 伺服器可設定,HTTP/SSE 伺服器支援 OAuth 權杖流程,stdio 伺服器可設定按工具呼叫的逾時。工具名稱預設新增伺服器名稱前綴以避免衝突。IM 頻道支援 Telegram、Slack、飛書/Lark、微信、企業微信和釘釘,使用長輪詢或 WebSocket 傳輸,無需公用 IP。頻道指令包括 /new、/status、/models、/memory 和 /help。README 也記錄了使用者自有 IM 頻道連線,允許登入使用者綁定自己的帳戶。

bytedance-deer-flow-deep-analysis|沙箱執行、MCP 伺服器和 IM 頻道:bytedance/deer-flow 的 README 是本文的事實邊界。第 4 節所述內容,應回看 沙箱執行、MCP 伺服器和 IM 頻道 涉及的指令、檔案或設定鍵;素材沒有交代的行為不在本文推定範圍內。 這個區分讓檔案明載的能力與尚待確認的部署條件保持分開,也能避免把單一範例誤讀成完整相容矩陣。

bytedance-deer-flow-deep-analysis|使用 LangSmith、Langfuse 和 Monocle 進行可觀測性

bytedance-deer-flow-deep-analysis|使用 LangSmith、Langfuse 和 Monocle 進行可觀測性 的專案脈絡:DeerFlow 內建了 LangSmith 和 Langfuse 的整合。啟用它們需要設定環境變數,如 LANGSMITH_TRACING、LANGSMITH_API_KEY、LANGFUSE_TRACING 和 LANGFUSE_PUBLIC_KEY。每次代理執行都會標註 Langfuse 保留屬性:session_id 來自 thread_id,user_id 來自 get_effective_user_id(),trace_name 為助手 ID,tags 包含環境和模型,metadata.deerflow_trace_id 用於關聯請求。Monocle 是基於 OpenTelemetry 的追蹤器,記錄 LLM 呼叫、代理步驟、工具和 MCP 呼叫及其輸入、輸出、耗時和權杖數。README 警告 Monocle 追蹤會原樣捕獲跨度輸入和輸出,因此遠端匯出器應僅啟用於受信任的目標。三個追蹤器可同時執行。

bytedance-deer-flow-deep-analysis|使用 LangSmith、Langfuse 和 Monocle 進行可觀測性:bytedance/deer-flow 的 README 是本文的事實邊界。第 5 節所述內容,應回看 使用 LangSmith、Langfuse 和 Monocle 進行可觀測性 涉及的指令、檔案或設定鍵;素材沒有交代的行為不在本文推定範圍內。 這個區分讓檔案明載的能力與尚待確認的部署條件保持分開,也能避免把單一範例誤讀成完整相容矩陣。

bytedance-deer-flow-deep-analysis|技能、子代理和上下文工程

bytedance-deer-flow-deep-analysis|技能、子代理和上下文工程 的專案脈絡:標準代理技能是一個 Markdown 檔案,定義工作流程、最佳實踐和參考資料。DeerFlow 內建了研究、報告產生、幻燈片製作、網頁、影像和視訊產生等技能。技能漸進式載入,以保持上下文視窗精簡。allowed-tools 策略僅在技能透過斜線啟動或透過 read_file 載入後生效;啟用或列出技能並不會縮減代理的正常工具集。README 稱這是盡力而為的行為範圍界定,而非硬性安全邊界。DeerFlow 還支援子代理、會話目標、手動上下文壓縮、長期記憶和檔案係統。README 未指定內建技能的具體數量。

bytedance-deer-flow-deep-analysis|技能、子代理和上下文工程:bytedance/deer-flow 的 README 是本文的事實邊界。第 6 節所述內容,應回看 技能、子代理和上下文工程 涉及的指令、檔案或設定鍵;素材沒有交代的行為不在本文推定範圍內。 這個區分讓檔案明載的能力與尚待確認的部署條件保持分開,也能避免把單一範例誤讀成完整相容矩陣。

bytedance-deer-flow-deep-analysis|安全提示與 MIT 授權

bytedance-deer-flow-deep-analysis|安全提示與 MIT 授權 的專案脈絡:README 包含安全提示,警告不當部署可能引入安全風險,並給出了建議。它未提供完整的威脅模型或安全保證。專案採用 MIT 授權,授予使用、複製、修改、合併、發布、分發、再授權和銷售副本的權限,條件是包含版權聲明。授權條款明確否認擔保:軟體按「原樣」提供,不提供任何形式的擔保。README 還提到瀏覽器永遠不會收到 Lark 應用密鑰,但代理對話會在沙箱內執行 lark-cli,因此憑證目錄會掛載到沙箱中,代理執行的任何程序都可讀取,這使得沙箱處於 Lark 憑證信任邊界之內。

bytedance-deer-flow-deep-analysis|安全提示與 MIT 授權:bytedance/deer-flow 的 README 是本文的事實邊界。第 7 節所述內容,應回看 安全提示與 MIT 授權 涉及的指令、檔案或設定鍵;素材沒有交代的行為不在本文推定範圍內。 這個區分讓檔案明載的能力與尚待確認的部署條件保持分開,也能避免把單一範例誤讀成完整相容矩陣。

編輯結論

bytedance/deer-flow 適合需要 README 所列工作流、且能接受其目前版本狀態的使用者;不適合把未載明的相容性、效能或安全承諾當成既定事實的團隊。先依 README 的專屬入口核對 v2.0.0、設定鍵與輸出邊界,再決定是否納入正式流程。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記