推荐使用 hermesupdate 指定版本切换：先确认 hermes 是由其管理的符号链接，再执行 sudo hermesupdate use v0.18.2 或 v0.19.1，前提是对应版本已预装于 ~/.hermes/bin/。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在本地同时安装了 Hermes Agent v0.18.2 和 v0.19.1，需要在两个版本间快速切换以验证功能兼容性、回溯问题或适配不同项目需求时，不能依赖全局覆盖式升级命令，必须启用版本隔离机制。
使用 hermesupdate 指定版本切换
这是最轻量、最推荐的切换方式，适用于已通过官方 install.sh 或 pip 安装且未手动编译的用户。
第一步：确认当前二进制路径是否由 hermesupdate 管理
执行 which hermes，若输出为 /usr/local/bin/hermes 或 ~/.local/bin/hermes，且该文件是符号链接指向 ~/.hermes/bin/hermes-v[0-9.]+，则可安全使用此方法。
第二步：切换至 v0.18.2
运行 sudo hermesupdate use v0.18.2。该命令不会重新下载，仅更新符号链接目标，并自动重载 systemd 服务（如启用）。
第三步：切换至 v0.19.1
运行 sudo hermesupdate use v0.19.1。注意：v0.19.1 必须已通过 hermesupdate upgrade --version v0.19.1 预先下载并解压到 ~/.hermes/bin/ 目录下，否则会报错 Version not found。
【关键前提】 切换前请确保 ~/.hermes/bin/ 下存在对应版本的可执行文件（如 hermes-v0.18.2 和 hermes-v0.19.1），缺失任一文件将导致切换失败。
基于 Git 的源码级版本切换
适用于从 GitHub 克隆源码构建、需精确控制 commit hash 或调试特定 PR 的开发者。
方法一：使用 git checkout 切换稳定标签
进入 Hermes Agent 项目根目录（如 ~/src/hermes-agent），执行：git fetch origin --tags → git checkout v0.18.2 → cargo build --release → cp target/release/hermes ~/bin/hermes-182
方法二：检出 v0.19.1 的发布分支
v0.19.1 对应分支为 release/v0.19，执行：git checkout release/v0.19 → cargo build --release → cp target/release/hermes ~/bin/hermes-191
提示：编译后生成的二进制建议重命名并存入独立路径（如 ~/bin/），避免与系统 PATH 中的 hermes 冲突。直接调用时用完整路径，例如 ~/bin/hermes-182 --version。
桌面客户端双版本并行启动
Windows 用户若已安装 v0.18.2 Desktop MSI 和 v0.19.1 测试版 EXE，可共存运行但需规避配置冲突。
启动 v0.18.2 桌面版：
双击开始菜单中 “Hermes Agent v0.18.2” 快捷方式，它会自动读取 %APPDATA%\hermesagent\config.json 并加载 v0.18.2 运行时。
启动 v0.19.1 测试版：
以管理员身份运行 PowerShell，执行：cd C:\hermes-v0.19.1 & .\hermes.exe --config-path C:\hermes-v0.19.1\config.json
【不可逆操作】 若未指定 --config-path，v0.19.1 将默认覆盖 %APPDATA%\hermesagent\ 下的配置与状态数据库，导致 v0.18.2 启动时因 schema 不兼容而崩溃。
