升级Hermes Agent至v0.19.1默认不丢配置,但需满足配置文件未被手动移动且未执行破坏性重装;若跳过验证或误用重置命令,config.yaml和.env可能被覆盖或清空。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

升级 Hermes Agent 从 v0.17.0 到 v0.19.1 时,默认不会丢配置,但必须满足两个前提:配置文件未被手动移动、且未执行破坏性重装操作;若跳过验证步骤或误用重置命令,config.yaml 和 .env 文件可能被覆盖或清空。
确认当前配置是否安全
先检查配置文件实际位置和状态,避免盲目升级:
执行 hermes setup --show-config-path,输出应类似 /home/ubuntu/.hermes/config.yaml;
运行 ls -l ~/.hermes/config.yaml ~/.hermes/.env,确认两个文件存在且修改时间早于今天;
注意:如果输出显示路径是 /tmp/hermes 或 /root/.hermes,说明你之前用 root 权限运行过 setup,而当前用户是普通用户,升级时极大概率会新建一套配置,导致旧配置失效。
升级前必须做的三步备份
第一步:复制 config.yaml 到安全位置
执行 cp ~/.hermes/config.yaml ~/.hermes/config.yaml.bak-$(date +%Y%m%d);
第二步:导出环境变量快照
执行 grep -v '^#' ~/.hermes/.env | sed 's/^/export /' > ~/.hermes/env.sh.bak;
第三步:验证 Git 仓库干净度
进入 cd ~/.hermes/hermes-agent → 运行 git status --porcelain,若输出为空,说明无未提交更改;若有输出,先 git stash 再继续。
v0.19.1 升级中真正会覆盖配置的两种情况
方法一:执行了 hermes setup --reset 或在交互式 setup 中选了 “Full reset”
这会直接删除 ~/.hermes/config.yaml 并重建空文件,不可逆;
方法二:使用安装脚本而非 update 命令重装
例如误运行 curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash,该脚本检测到已有安装后默认执行覆盖式重装,会清空 ~/.hermes 目录下所有内容(含 config.yaml 和 .env);
方法三:从源码手动 install 时用了 -e 参数但未指定 --config-dir
uv pip install -e . 默认读取当前目录下的 config.yaml,若你把源码解压到了 /tmp/hermes-agent,它就会去读 /tmp/hermes-agent/config.yaml——而这个文件是空模板。


















