hermesagent升级需按五步操作：一验证版本、依赖与备份配置；二用hermesupdate热升级；三指定版本回滚或精准升级；四离线环境原子化升级；五升级后校验服务状态一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在运行 HermesAgent，但发现功能缺失、命令失效或版本滞后，可能是当前安装的版本已过旧，需执行平滑升级以获取最新特性与稳定性修复。以下是实现无中断、可回退、兼容配置的升级操作步骤：
一、验证当前状态与升级前提
在触发任何升级动作前，必须确认本地环境具备合法升级条件，包括版本可识别性、工具链完整性及配置文件安全性。跳过此步可能导致升级后服务不可用或配置丢失。
1、在终端中执行hermes --version，确认输出格式为类似v0.9.0的有效语义化版本号。
2、运行hermes doctor检查核心依赖（如 Python 运行时、模型加载器、网络连通性），确保所有项显示OK状态。
3、备份当前配置目录：cp -r ~/.hermes ~/.hermes.backup-$(date +%Y%m%d)（Linux/macOS）或在 Windows WSL2 中使用相同命令。
二、使用 hermesupdate 工具执行在线热升级
该方式保留原有配置、会话状态与 SOUL.md 人格定义，在进程不中断前提下完成二进制替换，适用于大多数联网生产环境。
1、执行sudo hermesupdate upgrade（Linux/macOS）或以管理员身份运行 PowerShell 后输入相同命令（Windows WSL2）。
2、观察输出中出现Replacing hermes binary with v[0-9.]+...且无Permission denied或checksum mismatch报错。
3、升级完成后，立即运行hermes dashboard --port 9119验证网页端是否正常响应，同时确认 CLI 命令仍可调用。
三、指定版本回滚或精准升级
当线上环境因新版本引入非预期行为需快速恢复，或需部署经内部验证的特定预发布版本时，应绕过自动探测机制，强制锚定目标版本。
1、访问https://github.com/NousResearch/hermes-agent/releases，查找目标版本（如v0.9.1）的完整 Release Tag。
2、执行sudo hermesupdate upgrade --version v0.9.1，注意版本号前缀必须含v且与 GitHub 页面完全一致。
3、升级完毕后，手动比对hermes --version输出与目标版本，同时检查~/.hermes/logs/upgrade.log中最后一行是否含Rolling back to previous version disabled，表示未触发自动回滚。
四、离线环境下的原子化升级
在无外网访问权限的封闭网络中，升级包须预先下载并校验，通过物理介质导入后执行静默覆盖，全过程不依赖远程源，保障操作可审计、可复现。
1、在联网机器上执行hermesupdate download --version v0.9.1 --output /tmp/hermes-v0.9.1.tar.gz，随后用sha256sum生成校验值。
2、将压缩包与校验值文件复制至目标节点，执行sudo hermesupdate install --archive /tmp/hermes-v0.9.1.tar.gz --verify-sha256 [校验值]。
3、命令成功返回后，验证hermes health输出中binary_integrity字段为true，且config_consistency为ok。
五、升级后服务状态一致性校验
无论采用何种升级路径，均需在重启前完成关键运行时状态快照比对，确保模型加载、工具注册、会话恢复等核心能力未受破坏。
1、执行hermes status --verbose，确认gateway_status为running，且active_sessions数量与升级前一致。
2、运行hermes model list，检查返回列表中所有已配置模型仍显示loaded而非missing或unavailable。
3、发起一次最小闭环测试：hermes chat -q "Repeat the word 'confirmed'"，输出必须严格等于confirmed且无堆栈错误。
