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 直到收敛,这是理解一切的钥匙。

本站聚焦架构拆解与源码定位,安装使用看官方文档,不重复造使用文档。