需根据部署方式与网络环境选择升级路径：一、在线升级用hermes update；二、配置融合升级用hermes-cli upgrade；三、git手动切换用git checkout；四、离线升级需预下载并执行migrate；五、web ui需同步启动dashboard。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将 Hermes Agent 升级至最新版本，并确保配置、记忆与技能体系保持完整可用，则需根据当前部署方式与网络环境选择适配的升级路径。以下是完成该任务的具体方法：
一、使用 hermes update 命令在线升级
该方法适用于通过官方安装脚本部署、且具备稳定外网访问能力的用户，可自动拉取最新发布版本并完成二进制替换与基础配置兼容性处理。
1、打开终端（Linux/macOS/WSL2）或命令提示符（Windows），确认已激活 Hermes Agent 运行环境。
2、执行 hermes update 命令，系统将自动检测远程 GitHub Releases 最新稳定版（如 v0.10.0），下载压缩包并解压覆盖。
3、升级完成后，运行 hermes version 验证当前版本号是否更新成功。
二、使用 hermes-cli upgrade 执行配置融合升级
该方法专为通过 pip 或源码安装、且依赖自定义配置（config.yaml、user_config.yaml）的用户设计，内置 _deep_merge 机制可安全合并新旧配置字段，避免手动迁移遗漏。
1、在终端中执行 hermes-cli upgrade，工具将比对远程最新版本与本地当前版本。
2、确认升级提示后，系统自动备份原 config.py 与 workspace/ 目录结构。
3、调用深度合并函数完成默认配置与用户自定义配置的字段级融合，保留模型路径、Nous Portal 凭证、datagen-config-examples 映射等关键设置。
三、基于 Git 分支的手动版本切换
该方法适用于从 GitHub 源码构建、需精确控制修订号或需回滚至特定次版本的高级用户，可复用现有 workspace 路径与数据目录，跳过包管理器限制。
1、进入 Hermes Agent 项目根目录，执行 git fetch origin 同步全部远程分支与标签。
2、运行 git tag --sort=version:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | tail -n 5 查看最近五个语义化版本标签。
3、检出目标版本，例如 git checkout v0.10.0，确保工作区处于干净状态（无未提交修改）。
4、执行 pip install -e . --force-reinstall --no-deps 仅重装当前代码，保留已配置的模型路径与凭证信息。
四、离线环境下的手动升级流程
该方法适用于无外网访问能力的生产节点，需预先在联网机器上获取完整升级包，再通过物理介质导入目标设备，确保二进制、依赖与配置迁移原子性。
1、在联网机器上访问 Hermes Agent 官方 GitHub Releases 页面，下载对应架构的完整 release 包（如 hermes-agent-v0.10.0-linux-x64.tar.gz）。
2、解压后提取 hermes 可执行文件、lib/ 依赖目录及 migrations/ 版本迁移脚本。
3、将上述内容复制至目标节点的 Hermes 安装路径，执行 ./hermes migrate --from v0.9.0 --to v0.10.0 触发结构化配置迁移。
五、Web UI Dashboard 启动同步升级
该方法适用于已启用 Web 界面的用户，升级后需同步启动新版 Dashboard 服务以加载新增功能模块（如密钥管理表单、Token 分析图表、定时任务可视化面板）。
1、执行 hermes update 完成核心代理升级。
2、运行 hermes dashboard 启动新版 Web UI，默认监听 http://127.0.0.1:9119。
3、浏览器访问该地址，确认右上角显示版本号为最新版，并验证“配置”“密钥”“分析”等模块是否正常加载与交互。
