创建时间: 2026-09-12最后更新: 2026-09-12

1. 状态历史的作用

配置 Checkpointer 后,LangGraph 会在图运行过程中持续保存 checkpoint。保存发生在执行步骤(super-step)的边界;同一步骤可以包含多个并行节点。每个 checkpoint 都记录了当时的状态,以及下一步准备执行的节点。

假设一张文章处理图依次生成草稿、审核内容并发布文章,一次运行会留下下面几份状态:

checkpoint-timeline.txt
01
接收主题
02
│ next = ['writeDraft']
03
04
生成草稿
05
│ next = ['reviewDraft']
06
07
完成审核
08
│ next = ['publishArticle']
09
10
发布完成
11
next = []

这些 checkpoint 连在一起,就构成了当前线程的状态历史。它可以帮助我们回答几个实际问题:某个字段在哪一步发生了变化、图为什么停在某个节点、修正历史状态后能否重新执行后续流程。

从历史 checkpoint 继续运行时,LangGraph 会保留原来的记录,并沿选中的历史位置创建新的状态分支。官方把读取、回放和修改历史状态的这组能力称为 time travel

正在验证登录状态
请稍候,验证完成后将继续显示文章内容