# ephemeral_value.py:15
class EphemeralValue(Generic[Value], BaseChannel[Value, Value, Value]):
    """Stores the value received in the step immediately preceding, clears after."""
    #  存"紧邻的上一步"收到的值，之后清空

# untracked_value.py:15
class UntrackedValue(Generic[Value], BaseChannel[Value, Value, Value]):
    """Stores the last value received, never checkpointed."""
    #  存最后收到的值，但永不进 checkpoint

先建立直觉：Ephemeral 会被写进 checkpoint（它的 checkpoint() 老实返回值），但它靠"空更新即清空"实现"只活一步"。看构造和存档（channels/ephemeral_value.py:23-26,78-79）：

# ephemeral_value.py:23
def __init__(self, typ: Any, guard: bool = True) -> None:
    super().__init__(typ)
    self.guard = guard            # 是否禁止"一步多写"，默认 True
    self.value = MISSING          # 起点：没有值

# ephemeral_value.py:78
def checkpoint(self) -> Value:
    return self.value             # 和 LastValue 一样，有啥存啥（可能是 MISSING）

Ephemeral 的灵魂在 update 的前几行，它对"空更新"的处理和别人不一样（channels/ephemeral_value.py:55-68）：

# ephemeral_value.py:55
def update(self, values: Sequence[Value]) -> bool:
    if len(values) == 0:                 # ← 没人给我写（空更新）
        if self.value is not MISSING:
            self.value = MISSING         #   把上一步存的值清掉！
            return True                  #   "从有到无"是一次变化
        else:
            return False                 #   本来就没有 → 无变化
    if len(values) != 1 and self.guard:  # guard 检查（下一讲）
        raise InvalidUpdateError(...)
    self.value = values[-1]              # 有值：取最后一个
    return True

# ephemeral_value.py:62
    if len(values) != 1 and self.guard:
        raise InvalidUpdateError(
            f"At key '{self.key}': EphemeralValue(guard=True) can receive "
            f"only one value per step. Use guard=False if you want to store "
            f"any one of multiple values."
        )
    self.value = values[-1]      # guard=False 时：多写不报错，取最后一个

Untracked 和 Ephemeral 的 update/get 几乎一样，唯一的灵魂差异在 checkpoint()（channels/untracked_value.py:48-49）：

# untracked_value.py:48
def checkpoint(self) -> Value | Any:
    return MISSING                # ← 无论内存里有啥，存档时永远交白卷！

# 对比 EphemeralValue（会交出真实值）：
# ephemeral_value.py:78
def checkpoint(self) -> Value:
    return self.value

# UntrackedValue 的 update 照常存值（untracked_value.py:56）
def update(self, values):
    if len(values) == 0:
        return False              # 注意：空更新啥也不做，不清空（和 Ephemeral 不同）
    if len(values) != 1 and self.guard:
        raise InvalidUpdateError(...)
    self.value = values[-1]       # 内存里正常存
    return True

既然存档里没有 Untracked 的值，从存档恢复时它自然拿不回任何东西（channels/untracked_value.py:51-54）：

# untracked_value.py:51
def from_checkpoint(self, checkpoint: Value) -> Self:
    empty = self.__class__(self.typ, self.guard)
    empty.key = self.key
    return empty                  # 直接返回空通道，连 checkpoint 参数都不看！

# 对比 EphemeralValue（会灌回存档的值）：
# ephemeral_value.py:48
def from_checkpoint(self, checkpoint: Value) -> Self:
    empty = self.__class__(self.typ, self.guard)
    empty.key = self.key
    if checkpoint is not MISSING:
        empty.value = checkpoint  # 存了就恢复
    return empty

把 LastValue（Day 28）、EphemeralValue、UntrackedValue 三个"存最后一个值"的兄弟并排看，差异一目了然：

✋ 10 分钟动手

# 1. 两个文件都很短，通读
sed -n '1,80p' libs/langgraph/langgraph/channels/ephemeral_value.py
sed -n '1,74p' libs/langgraph/langgraph/channels/untracked_value.py

# 2. 对照两处 checkpoint() —— 一个返回值、一个返回 MISSING
grep -n "def checkpoint" libs/langgraph/langgraph/channels/*.py

# 3. 亲手验证 Ephemeral 空更新清空
python - <<'PY'
from langgraph.channels.ephemeral_value import EphemeralValue
e = EphemeralValue(str)
e.update(["go"]); print("写入后:", e.get())     # go
print("空更新变化?", e.update([]))               # True（清空了）
try: e.get()
except Exception as ex: print("再读:", type(ex).__name__)  # EmptyChannelError
PY