hermes agent源码安装后更新失败需先确认安装方式，再依次执行强制同步、清理构建、重编译、覆盖安装，并刷新模型注册表，最后交叉验证版本号、quicksilver标识及首token延迟。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Hermes Agent从源码安装后执行hermes update命令无响应、报错或更新后仍显示旧版本号，说明更新流程被阻断在 Git 同步、编译构建或注册表刷新环节，需按真实故障路径逐层验证。
确认当前是否为源码安装版本
非源码安装（如 Docker 或二进制包）无法使用hermes update命令更新到 v0.19.1。先验证安装方式：
运行which hermes，若输出路径包含~/.local/bin/hermes或~/bin/hermes，且项目根目录存在~/.hermes/hermes-agent/，则为源码安装；否则跳过后续所有步骤，改用docker pull nousresearch/hermes-agent:latest或重新克隆源码。
【必须满足此前提才可继续】
拉取最新代码并重建二进制
源码更新失败的核心原因是 Git 子树未同步或 Cargo 编译缓存污染。按顺序执行：
第一步：进入源码根目录 → cd ~/.hermes/hermes-agent
第二步：强制同步主干变更 → git fetch origin main && git reset --hard origin/main（不用pull，避免 merge 冲突卡住）
第三步：清理构建产物 → cargo clean
第四步：重新编译发布版 → cargo build --release（耗时约 2～5 分钟，CPU 占用高属正常）
第五步：覆盖安装可执行文件 → cp target/release/hermes ~/.local/bin/hermes
刷新模型配置与注册表
v0.19.1 新增了 Quicksilver 模型注册机制，旧版.model_registry_cache.pkl会阻止新模型加载。
方法一：一键重载全部配置
执行hermes doctor --fix，该命令会自动完成：清除缓存 → 重载 model_configs → 重建 registry → 验证 API Key 格式。
方法二：手动分步清理（当doctor --fix报权限错误时使用）
运行rm -f ~/.hermes/.model_registry_cache.pkl
再执行hermes model，按提示选择openai/gpt-4o等支持 Quicksilver 的模型，强制触发配置重解析。
注意：如果~/.hermes/environments/model_configs/目录为空或最后修改时间早于 2026-07-25，说明子树未拉取成功，需补执行git subtree pull --prefix environments/model_configs origin main --squash。
验证更新结果
更新完成后必须交叉验证三项指标，缺一不可：
运行hermes --version，输出应为v0.19.1（不是v0.19.0或0.19.1）
运行hermes chat -q "what version are you"，响应中需出现Quicksilver字样
启动hermes后观察首 Token 延迟：输入指令后 1 秒内必须出现欢迎消息或思考流，超过 2 秒说明 cold-start 优化未生效，需检查~/.hermes/config.yaml中display.show_reasoning是否为true且未被环境变量覆盖。
