LangGraph 架構拆解自頂向下讀原始碼

一個中文學習站,逐層拆解 langchain-ai/langgraph 這個狀態機式 agent 編排框架的整體設計;每一步都直連 GitHub 對應原始碼行,版本釘在 1.2.9。

自頂向下

從 config 體系 → StateGraph 構建 → Pregel 執行引擎 → Channel → Checkpoint → 串流 → 功能 API → 中斷恢復 → 子圖編排,一層層往下展開。

每個關鍵檔案都帶 SrcLink,點開就是 GitHub 上對應的那幾行;版本釘在 1.2.9,升版本只改一處。

不只是給指標——關鍵函式的 5-15 行真實 Python 原始碼直接貼在頁面裡,前後用中文點出在做什麼。

每頁除了職責,還講為什麼這麼設計,以及邊界情況和失敗模式怎麼處理。

LangGraph 以 Channel 表達狀態更新語義,PregelLoop.tick 反覆執行讀-排程-寫-ckpt 直到收斂,這是理解一切的鑰匙。

本站聚焦架構拆解與原始碼定位,安裝使用看官方文件,不重複造使用文件。