Hermes Agent 的三个版本之间可不是简单的“升级”关系——v0.7 是纯命令行时代，所有配置全靠一个 config.yaml 文件撑着；v0.9 开始引入 Web Dashboard 和 SOUL.md/AGENTS.md 双轨制，彻底抛弃了旧的配置文件；到了 v0.16，架构已经转向桌面工作台，本地甚至不存模型密钥，全部由远程 Gateway 统一调度。

假如你正在为 Hermes Agent 选版本，但发现 v0.7、v0.9、v0.16 的安装路径和配置方式完全不同，直接套用旧教程肯定会卡在第一步——比如拿 v0.7 的 config.yaml 覆盖安装 v0.16，【dashboard 将完全空白，所有模型列表消失】，连基础聊天都启动不了。

先看清楚：三个主流版本的本质区别

v0.7.x 是纯命令行时代，所有规则写在单个 config.yaml 里，靠终端交互驱动；v0.9.0 是分水岭，首次引入 Web Dashboard 和 SOUL.md/AGENTS.md 双轨制，废除 config.yaml；v0.16.0 已彻底转向桌面工作台模式，本地不再存模型密钥，全部由远程 Gateway 统一调度，桌面端通过 WebSocket 连接服务端获取配置。

如果你现在打开终端输入 hermes --version，显示的是 v0.7.3 或 v0.8.5，说明你还在旧架构里；如果显示 v0.16.0，那你的 ~/.hermes 目录下根本找不到 config.yaml，只有 SOUL.md 和 AGENTS.md 两个文件。

Windows 用户怎么选安装方式

方法一：快速体验（适合临时测试）
打开 PowerShell，执行：
irm https://res1.hermesagent.org.cn/install.ps1 | iex
安装完关闭窗口再重开，输入 hermes 验证。这个操作很简单，直接回车就行，但【长期使用会遇到路径乱码、权限拒绝、Git Bash 兼容性差等问题】，尤其当你需要调用浏览器自动化或微信消息网关时，大概率失败。

方法二：WSL2 安装（推荐新手和长期使用者）
① 以管理员身份运行 PowerShell，执行 wsl --install，重启电脑
② 进入 Ubuntu 后，运行 curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
③ 执行 source ~/.bashrc → hermes
这一步必须做完，否则 bash 无法识别 hermes 命令。WSL2 环境能完整跑通 iMessage 桥接、BlueBubbles webhook 注册、D-Bus 系统级通知等高级功能，且避免 Windows 特有的编码坑。

方法三：桌面版一键安装（适合不想碰终端的用户）
访问 https://hermes-agent.nousresearch.com/docs/getting-started/desktop 下载安装包，双击运行。它会自动拉取最新 v0.16.0 代码并配置 Ollama 本地模型后端，但【国内用户可能因 GitHub 直连超时导致卡在“正在下载依赖”界面】，建议先用命令行方式装好基础环境，再安装桌面版。

版本升级不是覆盖安装，而是重构式迁移

第一步：确认当前版本是否为语义化格式
在终端运行 hermes --version，输出必须形如 v0.7.3。如果显示 dev-20240115 或 commit abc1234，说明你安装的是开发分支快照，【不能直接用 hermes update 升级，必须先切回最近的 v0.7.x tag】。

第二步：备份两处关键路径
执行以下命令：
cp -r ~/.hermes/SOUL.md ~/backup_SOUL.md
cp -r ~/.hermes/AGENTS.md ~/backup_AGENTS.md
注意：v0.7.x 用户没有这两个文件，只备份 config.yaml 即可；v0.9+ 用户若跳过此步，升级后角色语气和项目规则将永久丢失。

第三步：分阶段迁移
v0.7.x → v0.9.1：先卸载旧版，再用 install.sh 重装，手动把 config.yaml 中的 model_provider、tools、memory_size 等字段拆解到 SOUL.md 和 AGENTS.md 中
v0.9.1 → v0.16.0：运行 hermes setup --portal，登录 GitHub 绑定 Nous Portal 订阅，桌面端会自动从 Gateway 同步模型列表和工具开关状态。