源码安装的Hermes更新攻略

本次实践环境：

• 操作系统：Windows 11

• 运行环境：WSL2 虚拟机 + Ubuntu

• 安装方式：源码

更新不会动目前的配置内容，因为Hermes的用户数据与源码完全分离

• 源码目录：存放程序代码文件，更新源码只会更新这部分内容

• 用户数据目录：~/.hermes/，存放模型密钥、配置文件等所有个性化数据

整个更新过程只操作源码目录，不会修改、删除 ~/.hermes/ 里的文件

一、更新前先做个备份

虽然正常更新不会出问题，但建议养成好习惯

cp -r ~/.hermes ~/.hermes.backup.$(date +%Y%m%d)

执行后会在同级目录生成一个带日期的备份文件夹

接下来先进入源码目录并激活虚拟环境：

cd ~/hermes-agentsource venv/bin/activate

记录一下当前版本号，方便后续对照：

hermes --version

二、更新

步骤 1：拉取官方最新代码

git pull origin main

步骤 2：重新安装依赖（含 ACP 编辑器能力）

新版本通常会新增、升级依赖包，必须重新执行安装，同时保留我一直在用的 ACP 编辑器集成能力：

pip install -e '.[acp]'

💡 说明：

• -e 是可编辑安装模式，后续修改源码会即时生效

• [acp] 会同步更新 ACP 协议相关依赖，确保 JetBrains / VS Code 接入能力正常

步骤 3：配置迁移与检查

新版本往往会新增一些配置项，直接运行可能出现兼容报错，执行官方迁移命令，自动补全缺失的配置：

# 先检查当前配置hermes config check# 新增项自动用默认值，不会覆盖原有设置hermes config migrate

这条命令只会新增缺失的配置字段

步骤 4：验证更新是否成功

# 1. 确认版本号已升级hermes --version# 2. 确认 ACP 模块正常hermes acp --version# 3. 运行自检hermes doctor

最后启动测试