升级到 Hermes Agent v0.19.1，默认配置真的不会丢失吗？根据实际测试结果，默认情况下配置确实不会丢失，但前提是必须满足两个关键条件：配置文件未被手动移动过，且未执行过破坏性重装操作。如果跳过验证步骤，或者误用了重置命令，那么config.yaml和.env文件随时可能被覆盖或清空——这些经验来自大量实际案例，值得警惕。

从 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——而该文件是空模板，无任何有效配置内容。