Hermes Agent 更新、备份与回滚指南

升级前先预检

Hermes 会自动识别 pip、Git 安装器、Homebrew 或 NixOS 等安装方式，并给出匹配的升级路径。Docker 用户通过拉取新镜像升级，不使用 hermes update。

hermes version
hermes update --check
hermes doctor

执行更新

标准更新会拉取配置的更新分支、重新安装依赖，并同步所有 Profiles 的 bundled Skills。通常每台机器只需执行一次。

hermes update
hermes update --backup
hermes update --yes

如果 Hermes Desktop 后端、Gateway 或 Python 进程仍占用虚拟环境，更新会拒绝继续。先正常停止相关进程。

备份与本地改动

`--backup` 会在拉取前创建 HERMES_HOME 快照。更新器可能自动暂存工作树变化，但重要的源码或配置修改仍应先提交或单独备份。

hermes update --backup
hermes backup restore --state pre-update

• 不要依赖自动 stash 保存唯一副本。
• 手工编辑过的 Skills 不应被无提示覆盖。
• 更新前记录当前版本，便于确认升级或回退。

更新后验证

确认版本变化后，依次验证诊断、基础聊天和 Gateway。不要在基础链路失败时继续排查消息平台。

hermes version
hermes doctor
hermes
hermes gateway status

特殊安装方式

Homebrew、NixOS 和 Docker 有各自的包管理升级流程。Hermes 会检测安装布局并提示正确命令；Docker 需要拉取新镜像并重建容器。

• pip / Git 安装器：按 hermes update 输出执行。
• Homebrew：使用 brew upgrade 对应 formula。
• NixOS：更新 flake/input 后重建。
• Docker：拉取新镜像并重新创建容器。