# 每次调用图时，你传的 config 长这样：
config = {"configurable": {
    "thread_id": "chat-42",        # 哪个对话/会话
    "checkpoint_ns": "",           # 哪一层图（主图=空串）
    "checkpoint_id": "1efab...c3", # 哪一份档（不传则取最新）
}}

# saver 返回的"新坐标"也永远是这三件套（sqlite/__init__.py:437）：
return {"configurable": {
    "thread_id": thread_id,
    "checkpoint_ns": checkpoint_ns,
    "checkpoint_id": checkpoint["id"],
}}

thread_id 是三级里最外层、也是唯一必填的。基类 docstring 专门解释了它（checkpoint/base/__init__.py:182-198）：

# checkpoint/base/__init__.py:186 附近（docstring）
# "The thread_id is the primary key used to store and retrieve checkpoints."
# 用法举例：
config = {"configurable": {"thread_id": "my-thread"}}
# - 对话记忆：同一个 thread_id 跨多次 invoke 复用 → 记得上下文
# - 不同用户/会话：用不同 thread_id → 状态互相隔离，谁也读不到谁

# saver 里 delete_thread 按 thread_id 整柜删除（sqlite/__init__.py:484）
def delete_thread(self, thread_id: str) -> None:
    cur.execute("DELETE FROM checkpoints WHERE thread_id = ?", (thread_id,))
    cur.execute("DELETE FROM writes WHERE thread_id = ?", (thread_id,))

中间那级 checkpoint_ns（namespace 命名空间）表达"这份档属于哪一层图"。它的分隔符定义在常量里（_internal/_constants.py:87-90）：

# _internal/_constants.py:59
CONFIG_KEY_CHECKPOINT_NS = "checkpoint_ns"   # "" 表示根图（主图）

# _internal/_constants.py:87
NS_SEP = "|"     # 分隔各层级：  graph | subgraph | subsubgraph
# _internal/_constants.py:89
NS_END = ":"     # 每一层里，分隔"命名空间"和"任务 id"

# 例子：主图里有个子图节点叫 "planner"，某次任务 id 是 abc：
#   主图的 checkpoint_ns    = ""
#   子图 planner 的 ns      = "planner:abc"
#   子图里再套子图 "search" = "planner:abc|search:def"

最内层 checkpoint_id 用的不是常见的 uuid4，而是 uuid6——一种按时间排序的 UUID（pregel/_checkpoint.py:28-36、checkpoint/base/id.py:79-109）：

# pregel/_checkpoint.py:28
def empty_checkpoint() -> Checkpoint:
    return Checkpoint(
        v=LATEST_VERSION,
        id=str(uuid6(clock_seq=-2)),   # ← 用 uuid6 生成 id
        ts=datetime.now(timezone.utc).isoformat(),
        channel_values={}, channel_versions={}, versions_seen={},
    )

# checkpoint/base/id.py:79  uuid6 的核心：时间戳放在 UUID 高位
def uuid6(node=None, clock_seq=None):
    nanoseconds = time.time_ns()
    timestamp = nanoseconds // 100 + 0x01B21DD213814000
    if _last_v6_timestamp is not None and timestamp <= _last_v6_timestamp:
        timestamp = _last_v6_timestamp + 1     # ← 同一纳秒内也强制递增，保证单调
    ...
    uuid_int = time_high_and_time_mid << 80    # 时间戳占据最高位
    uuid_int |= time_low_and_version << 64

坐标讲完，看 checkpoint 本身怎么"诞生"。每个超步（super-step，Day 19-20）结束都会造一份新 checkpoint，主力函数是 create_checkpoint（pregel/_checkpoint.py:149-214）：

# pregel/_checkpoint.py:149
def create_checkpoint(checkpoint, channels, step, *, id=None,
                      updated_channels=None, get_next_version=None,
                      channels_to_snapshot=None) -> Checkpoint:
    ts = datetime.now(timezone.utc).isoformat()
    ...
    values = {}
    channel_versions = dict(checkpoint["channel_versions"])
    for k in channels:
        if k not in channel_versions:
            continue
        ch = channels[k]
        ...
        v = ch.checkpoint()               # ← 逐个通道调 checkpoint() 取当前存档值
        if v is not MISSING:
            values[k] = v                 #   MISSING（如 UntrackedValue）就不收进来
    return Checkpoint(
        v=LATEST_VERSION,
        ts=ts,
        id=id or str(uuid6(clock_seq=step)),   # 用超步号造 id
        channel_values=values,
        channel_versions=channel_versions,
        versions_seen=checkpoint["versions_seen"],
        updated_channels=None if updated_channels is None else sorted(updated_channels),
    )

checkpoint 存的不止 channel_values。看 Checkpoint TypedDict 全貌（checkpoint/base/__init__.py:92-123）：

# checkpoint/base/__init__.py:92
class Checkpoint(TypedDict):
    v: int                                  # 格式版本号（当前 LATEST_VERSION=4）
    id: str                                 # uuid6，单调递增（L04）
    ts: str                                 # ISO 8601 时间戳
    channel_values: dict[str, Any]          # 各通道的存档值（L05 收集来的）
    channel_versions: ChannelVersions       # 各通道当前的版本号（"通道→版本"）
    versions_seen: dict[str, ChannelVersions]  # 每个节点"看过"各通道到哪个版本
    updated_channels: list[str] | None      # 这一步更新了哪些通道

最后一块拼图：checkpoint 之间靠 parent_checkpoint_id 连成一条链，这就是时间旅行的轨道。回看 saver 里怎么串（checkpoint/sqlite/__init__.py:431）：

# put 时：新档的父 = 当前 config 里携带的 checkpoint_id
config["configurable"].get("checkpoint_id")   # 这就是"上一份档"的 id → 当父

# get_tuple 时：把父 id 组装成 parent_config 返回（sqlite/__init__.py:278-288）
parent_config = ({"configurable": {"thread_id": ..., "checkpoint_ns": ...,
                                    "checkpoint_id": parent_checkpoint_id}}
                 if parent_checkpoint_id else None)   # 第一份档没有父 → None

✋ 10 分钟动手

# 1. Checkpoint 结构 + uuid6 生成
sed -n '92,123p' libs/checkpoint/langgraph/checkpoint/base/__init__.py
sed -n '79,109p' libs/checkpoint/langgraph/checkpoint/base/id.py

# 2. create_checkpoint 怎么遍历通道造档
sed -n '149,214p' libs/langgraph/langgraph/pregel/_checkpoint.py

# 3. 亲手观察坐标与家谱链
python - <<'PY'
from langgraph.graph import StateGraph, START
from langgraph.checkpoint.memory import InMemorySaver
g=StateGraph(dict); g.add_node("a",lambda s:{"n":s.get("n",0)+1}); g.add_edge(START,"a")
app=g.compile(checkpointer=InMemorySaver())
cfg={"configurable":{"thread_id":"t1"}}
app.invoke({"n":0}, cfg); app.invoke({"n":0}, cfg)
for st in app.get_state_history(cfg):
    print("id=", st.config["configurable"]["checkpoint_id"][:8],
          "parent=", (st.parent_config or {}).get("configurable",{}).get("checkpoint_id","None")[:8])
PY