🤖HermesBlog
Hermes 官方教程 · 第10篇2026/8/9· Easy Understand Hermes Agent

第十篇:检查点(Checkpoints)——AI 的后悔药

Hermes Agent 官方教程第十篇:检查点。让 AI 的每一步修改都可回滚。

这篇讲的是:怎么让 Hermes Agent 记住工作到一半的状态,随时“存档”和“读档”,再也不怕跑飞了。

你有没有玩过那种不能存档的游戏?打了一小时,手一滑,从头再来,心态直接崩了。AI 跑任务也一样——如果中途断网、报错、或者你突然想改需求,之前跑了一大半的结果可能全没了。 Hermes Agent 的“检查点”(Checkpoints)功能,就是给 AI 准备的“存档位”。它能把当前的工作进度、对话上下文、甚至临时变量都存下来,下次直接接着跑,而不是从头再来。

下面我们一步步来看怎么用。


第 1 步:开启检查点功能(默认是关的)

在启动 Hermes Agent 的时候,加一个参数就行。打开你的终端(或者命令行工具),输入:

hermes --checkpoint-enable

就这么简单。启动之后,Agent 每完成一个关键步骤(比如调用完一个工具、生成完一段代码),都会自动存一个“检查点”。

注意:如果你用的是配置文件,也可以在 config.yaml 里写上 checkpoint_enable: true,效果一样。


第 2 步:手动存档(像游戏里按 F5)

有时候你想在某个特定节点存个档,比如“刚处理完数据清洗,还没开始分析”。这时候不用等自动存档,直接对 Agent 说:

请创建一个检查点,命名为“清洗完成”

Agent 会回复你一个检查点 ID(一串字母数字),比如 ckpt_8f3k2a记下这个 ID,它就是你的“存档编号”。


第 3 步:读档(后悔药怎么吃)

假设第二天你继续跑任务,或者刚才跑崩了。重新启动 Hermes Agent,然后输入:

hermes --checkpoint-load ckpt_8f3k2a

或者直接在对话里说:

从检查点“清洗完成”继续

Agent 会恢复当时的全部状态——包括聊过的内容、变量值、甚至中间产生的临时文件路径。你可以直接说“继续分析”,它就知道从哪开始,不会问你“我们刚才聊到哪了”。


第 4 步:查看和管理存档

存多了记不住?没关系,用这个命令列出所有检查点:

hermes --checkpoint-list

你会看到类似这样的输出:

ID: ckpt_8f3k2a | 名称: 清洗完成 | 时间: 2025-01-15 10:32
ID: ckpt_x9m4q1 | 名称: 分析初稿 | 时间: 2025-01-15 11:02

想删除某个没用的存档(比如实验失败的),就:

hermes --checkpoint-delete ckpt_x9m4q1

第 5 步:给检查点设置“自动过期”(可选)

如果你担心存档太多占空间,可以设置只保留最近 5 个:

hermes --checkpoint-keep 5

这样每次新存档生成,最老的那个会被自动清理。适合跑长任务、但不想手动删档的情况。


生活化比喻总结:检查点就是 AI 的“游戏存档”。自动存档是系统帮你保底,手动存档是你自己掌握节奏,读档是后悔药,列表管理是存档管理界面。强烈建议跑长任务(超过 10 分钟)时开启这个功能,不然中途断了真的会哭。


下一篇预告:第十一篇:记忆(Memory)——让 AI 记住你的偏好,不用每次重复交代。我们聊聊怎么让 Agent 变成“老熟人”。

📖 官方文档

本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › user-guide/checkpoints-and-rollback