hermes agent提供五级数据恢复能力：一、sqlite数据库恢复；二、git检查点分支还原；三、文件快照模式恢复；四、cli内置回滚命令；五、checkpoint工具细粒度管理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Hermes Agent过程中误删了会话、工具调用记录或工作区文件，则系统提供了多层级的数据恢复能力。以下是针对不同误删场景的可行恢复路径：
一、从SQLite数据库恢复会话与状态数据
所有核心会话状态、消息历史、工具调用及响应均持久化存储于~/.hermes/state.db中，该文件是恢复Agent行为连续性的唯一权威来源。只要该数据库文件未被覆盖或损坏，即可完整还原历史交互。
1、确认数据库文件仍存在：执行ls -l ~/.hermes/state.db检查文件是否存在、权限是否可读、修改时间是否早于误删操作。
2、若存在近期备份：运行cp ~/.hermes/state.db.20260418_142205 ~/.hermes/state.db（替换为实际时间戳）覆盖当前数据库。
3、若无手动备份但启用了Git检查点：跳转至第二部分执行检出操作。
二、通过Git检查点分支还原会话快照
当HERMES_CHECKPOINT_MODE=git启用且项目根目录含.git时，每次工具调用或文件变更均自动提交至hermes/checkpoints/<session></session>分支，形成可追溯的版本化快照。
1、列出全部检查点分支：运行git branch --format="%(refname:short)" | grep "hermes/checkpoints/"。
2、定位目标会话分支：根据分支名中的session_后缀或创建时间筛选最接近误删前的分支。
3、检出该检查点：执行git checkout hermes/checkpoints/session_ef9a3b（替换为实际分支名）。
4、重启Hermes Agent：使新加载的Git状态生效，此时所有已提交的文件变更与会话元数据将恢复至该检查点时刻。
三、利用文件快照模式恢复工作区内容
在非Git环境中，Hermes Agent会在~/.hermes/checkpoints/<session_id>/</session_id>下生成checkpoint.tar.gz，包含自上次检查点以来所有被修改的工作区文件。
1、获取最新检查点目录：运行ls -t ~/.hermes/checkpoints/ | head -n1提取最近的session_id。
Hermes Agent (v0.8.0) 是由 Nous Research 开发的开源自进化 AI 智能体，被誉为“与你共同成长的 Agent”。其核心优势在于内置学习闭环，能从任务中自动提炼技能、持久记忆用户偏好，越用越懂你。该版本聚焦“智能”升级，支持后台任务自动通知、模型实时切换及 MCP OAuth 2.1。它兼容 200+ 主流大模型，支持微信、Telegram 等多平台接入，仅需 5 美元 VPS 即可部署，是提升个人与企业生产力的理想选择。
2、验证快照完整性：执行tar -tzf ~/.hermes/checkpoints/xyz789/checkpoint.tar.gz | head -n5查看压缩包内文件列表。
3、解压覆盖当前工作区：运行tar -xzf ~/.hermes/checkpoints/xyz789/checkpoint.tar.gz -C ./。
4、强制重载文件状态：执行hermes checkpoint reload通知Agent重新索引文件变更，确保工具调用上下文与磁盘状态严格一致。
四、使用CLI内置回滚命令快速恢复
hermes CLI提供原子化回滚接口，可直接列出并选择任意历史恢复点，无需手动操作底层存储。
1、列出所有可用恢复点：运行hermes rollback bash，终端将显示带时间戳和会话ID的恢复点列表。
2、选择编号执行回滚：输入对应序号（如3），系统自动完成数据库切换、文件解压与状态重载。
3、验证恢复结果：调用hermes session list确认当前会话ID已回退至目标状态，所有消息、工具调用链及响应输出将精确复现至该检查点。
五、调用checkpoint工具进行细粒度状态管理
Agent可直接调用checkpoint工具执行list、restore、diff三类操作，适用于脚本集成与自动化恢复流程。
1、查看全部检查点摘要：运行hermes tool checkpoint list，返回含时间、session_id、变更文件数的结构化清单。
2、恢复指定检查点：执行hermes tool checkpoint restore --id session_8c2d1f，触发数据库还原与工作区同步。
3、比对当前与检查点差异：运行hermes tool checkpoint diff --id session_8c2d1f，输出新增、删除、修改的文件路径及行级变动。
