Hermes Agent 更新翻车了：一条命令引发的血泪教训

前言

软件保持更新才能用到最新功能和安全补丁。Hermes Agent 的更新流程简洁到一条命令，卸载也一样干净利落。

更新到最新版

hermes update

这条命令会：

1. 检查版本 — 对比当前版本和最新版本
2. 拉取代码 — 从 GitHub 拉取最新 release
3. 更新依赖 — 自动升级 Python 包
4. 提示新配置 — 如果有新增的配置项，会引导你设置

整个过程通常 30 秒到 2 分钟。

更新后检查

# 查看当前版本
hermes --version
诊断是否有问题
hermes doctor
查看更新日志
hermes --changelog   # 如果支持

降级到指定版本

如果新版有兼容问题：

pip install hermes-agent==x.y.z

版本号去 GitHub Releases 查看。

卸载 Hermes Agent

# 删除程序文件
pip uninstall hermes-agent -y
删除配置和数据（⚠️ 不可恢复！）
rm -rf ~/.hermes
如果用的是虚拟环境
rm -rf /path/to/venv

卸载后系统完全恢复原状，不留残留。

只删配置保留程序

如果只是想重置：

rm ~/.hermes/config.yaml
hermes setup  # 重新配置

备份与恢复

更新前建议备份配置：

# 备份
cp -r ~/.hermes ~/.hermes.backup.$(date +%Y%m%d)
恢复
cp -r ~/.hermes.backup.20260505 ~/.hermes

自动更新（可选）

在 ~/.hermes/config.yaml 中启用自动检查：

updates:
  check_on_start: true   # 每次启动检查新版本
  auto_update: false     # 是否自动更新（建议关闭）

推荐 check_on_start: true + auto_update: false，看到提示再手动决定。

更新失败怎么办

本文整理自 Hermes Agent 中文社区更新与卸载指南