概述
hermes checkpoints 管理文件系统检查点存储——这是 Hermes 为 /rollback 功能维护的影子 Git 仓库。在 Hermes 执行 write_file、patch 或 terminal 等写操作之前，它会对工作目录创建快照。本命令可让你查看检查点存储、清理过期数据或完全清空。
hermes checkpoints <子命令>子命令
status — 查看检查点存储状态
hermes checkpoints status显示检查点库的总大小、跟踪的项目数量以及每个项目的占用明细。
list — status 的别名
hermes checkpoints list与 status 完全相同，使用习惯的名称即可。
prune — 删除过期检查点
hermes checkpoints prune删除孤立或过期的检查点，并对存储执行垃圾回收。这样可以在不完全删除回滚历史的情况下释放磁盘空间。
clear — 清除所有检查点
hermes checkpoints clear删除整个检查点库，包括所有 /rollback 历史。只有在你确定不再需要回退过去操作时才使用。
clear-legacy — 删除 v1 迁移归档
hermes checkpoints clear-legacy仅删除从 v1 检查点格式迁移后残留的 legacy-<时间戳>/ 归档。
常见场景
查看磁盘占用
hermes checkpoints status用于了解检查点库占用了多少空间，以及哪些项目占用最多。
日常清理
hermes checkpoints prune定期运行，以垃圾回收过期检查点并释放磁盘空间。
在重要里程碑后重新开始
hermes checkpoints clear当你已提交或备份工作，且不再需要旧更改的回滚保护时使用。
清理旧迁移归档
hermes checkpoints clear-legacy如果你已从 v1 格式升级且不再需要迁移备份，可安全运行。
提示
- 检查点是会话内
/rollback命令的数据来源——清空后将无法回退过去的操作。 prune比clear更安全，因为它只删除过期/孤立数据。- 大规模重构会话可能产生大量检查点；请使用
status监控存储大小。 clear-legacy不会影响当前检查点，只会删除旧的迁移归档。