本文目录
一、这是个什么版本
二、升级系统彻底重构
三、Reasoning 终于能续上了
四、其他值得关注的更新
五、怎么升级到 v0.21.7
v0.21.7 是 Hermes Agent 的 patch 版本，发布日期 2026 年 10 月 12 日。它在 v0.21.6 发布后约 4 天发出，桌面端（macOS Apple silicon、Windows）、Microsoft Store、MSIX、安装器、Docker 和 Hermes Cloud 都已经切到这个版本。
从数字上看，这一版合并了 204 个 PR、740 个 commit、69 个 closed issue，代码量净增 +86,775 / −26,980 行。规模比 v0.21.6 小很多，但核心改动很有针对性：升级系统彻底重构、Reasoning resume 恢复、防火墙兼容问题解决。
SECTION一、这是个什么版本
这一版的发布说明里写了一句话：Full curated notes for this window ship with v0.22.0。和 v0.21.6 一样，完整精选更新日志要等 v0.22.0，这个标签只是为了让各分发渠道的稳定版本对齐。
和 v0.21.6 不同的是，v0.21.7 的重点不是安全修复，而是日常维护和功能改进。核心改动集中在 4 个方向：升级系统重构、Reasoning resume 恢复、桌面端 channel 切换、防火墙兼容。
SECTION二、升级系统彻底重构
这一版最大的改动是升级系统。以前的逻辑是：源安装（git checkout）的用户每次 hermes update 都会拉到 main 分支的最新 commit。问题在于 main 分支不稳定，经常出现 breaking change，源安装的用户被坑过很多次。
新的逻辑是：源安装默认只跟 tagged release 更新，比如 v0.21.7。安装的版本如果比最新 release 还新，就保持在原地不动，等下一个 release。如果你想继续跟 main 分支的每个 commit，可以运行 hermes update --set-channel main 切回 Every commit 模式。
fork 和 mirror 不受影响，继续跟自己的 main。Microsoft Store、MSIX、bundled desktop install 的更新机制也不变。
桌面端新增了 channel 切换入口：Settings → About → Updates 里有个 Update channel 开关，可以在 Stable releases 和 Every commit 之间切换。更新对话框里也会显示当前用的是哪个 channel。
这个改动的意义在于：源安装的用户终于有了稳定预期。以前升级 v0.21.5 之后过几天就自动跑到某个新 commit，结果可能是个半成品，现在不会出现这种情况了。
SECTION三、Reasoning 终于能续上了
第二个重点改动是 Reasoning resume 修复。
之前的 bug：执行 hermes chat --resume 之后，模型之前的思考过程（thinking）会丢失。对话看起来续上了，但模型实际上是从中断点重新开始思考，而不是接着上次的推理继续走。
对 Bedrock Converse 上的 reasoning 模型（Claude 的 extended thinking 类）来说，这个 bug 更严重：resumed session 会被直接拒绝，提示 reasoning 模型不支持 resume。
这一版彻底修复了：signed thinking 会在 --resume 和下一个 gateway turn 之后正确 replay。Bedrock Converse 上的 reasoning 模型也能正常 resume 了。
对重度使用 reasoning 模型的开发者来说，这是个"等了好久终于来了"的修复。以前 debug 长链 reasoning 任务，要么从头开始（浪费时间），要么绕开 --resume（用其他方式续上）。
SECTION四、其他值得关注的更新
虽然 v0.21.7 重点是上面两个改动，但发布说明里还藏了不少东西，我挑几个实用的说一下。
防火墙兼容：有些地区的网络环境对 GitHub release 记录 API 不友好，源安装在 main 分支时会拉取 release record，部分防火墙会返回 403，导致升级失败。这一版改成了优先用本地 GitHub token（环境变量 GITHUB_TOKEN 或 gh auth login 配置的），rate limit 也会以 rate limit 的形式报告，不会再被防火墙拦截成莫名其妙的错误。
桌面端更新加速：React Compiler pass 改成按内容缓存，compiled renderer 在 install stamp 没变的情况下会复用，原生输入未变就不重新打包。
插件改进：插件现在能运行 Desktop app 的内置动作（ctx.runAction），还多了一个 plugin SDK 宠物气泡（ctx.pet.say）。core 现在会代理 Codex 请求，插件不再持有 token。session 中途安装的 skills 不用重启 prompt 就能让模型感知到。
图像模型默认调整：新付费订阅用户的默认图像模型改成 Krea 2 Medium Turbo，managed Krea 拒绝请求时会自动 fallback 到 FAL。
其他细节：pin install 只 checkout pin 本身；compaction marks 发到 Relay；新增社区插件 memory-shield、command-ledger、Memoria、Model Router、wyoming-voice-bridge、codex-account-switch、redline。
SECTION五、怎么升级到 v0.21.7
升级方式取决于你用什么渠道。
桌面端：自动更新。Microsoft Store 安装的通过 Store 升级。
CLI：跑 hermes update，或者重跑安装脚本的 one-liner。源安装现在默认只跟 tagged release，如果你想继续跟 main 分支，加 --set-channel main 参数。
Docker / Hermes Cloud：拉 nousresearch/hermes-agent:stable 或者 :latest 镜像。生产环境建议用 :stable。
升级之前建议看一下发布说明里 channel 那节，确认你的升级行为符合预期。特别是源安装的用户，如果之前依赖 main 分支的即时更新，需要主动切到 Every commit 模式，否则 v0.21.7 之后你就停在 v0.21.7 了。
完整精选发布说明随 v0.22.0 一起发。原文说明：v0.22.0 will document everything from v0.21.0 onward — highlights, feature areas, and complete contributor credits.
“互动问题：源安装改成跟随 tagged release 之后，你打算切回 Every commit 模式还是留在 Stable？
