看到"补丁版本"就跳过?v0.23.2 里并进了 1,989 个 PR,官方还说"不写说明"


早上刷 release 列表,看到 v0.23.1 变成 v0.23.2,标题写着 “Patch release”,你的第一反应大概是“那先不升了”。这个判断在大多数项目里都对,但在 Hermes 这里,它正好会让你错过一批真正改变日常使用体验的东西——因为这一次,版本号只动了一个小数点,里面却塞进了大约 1,989 个合并 PR。

更特别的是官方的态度:发布说明里明说,这个窗口里的大部分内容故意不在这里展开,完整的整理版说明会随 v0.24.0 一起发布。所以这篇不是把官方说明翻译一遍,而是把它讲清楚——哪些是官方点名的修复,哪些是只用一句话带过的能力,以及“现在升级”到底意味着什么。

先说数字:这个“补丁”有多大

官方在提交 ae2a81ccc00 上统计的窗口数据:

指标 数值
合并 PR 约 1,989
非合并提交 7,918
改动文件 5,211(+239,733 / −22,788)
关闭 issue 940

作为对比,v0.23.1 那个“补丁”的窗口是约 618 个 PR、2,578 个提交。也就是说这一次是上一次的三倍多。它之所以还叫补丁版本,是因为它的职责是发标签而不是发功能:把这批改动打包成一个稳定版本,供 GitHub release(CLI 与安装脚本)、Microsoft Store 应用、Docker 镜像和 Hermes Cloud 使用。

功能说明为什么要等到 v0.24.0?官方给的理由是整理工作需要时间,而且 v0.24.0 会覆盖从 v0.23.0 开始的所有内容,“这个窗口里没有任何东西被跳过”。这个说法可以接受,但对你来说有个现实问题:等整理版出来之前,你怎么知道要不要升?

官方点名的 7 个修复

这些是发布说明里明确列出的,都在“release candidate 阶段修复”那一节:

  1. 8 月版本创建的桌面聊天发不出消息。 那个版本里 provider 被写成了裸的 custom,之后就一直卡着。现在升级后可以正常发送(#156545)。
  2. Stop 按钮一直不消失。 桌面端或 TUI 里,当回复和 todo / memory 调用同时流式输出时,界面不会收尾。现在会正常结束(#156553)。
  3. 重复的 “Recovered reply”。 Telegram 这类“编辑式流式”的聊天中途崩过一次,恢复后会出现两条。顺带修了另一个小毛病:中途带着 key 前缀的单词(例如 program_id)会被一直藏着不显示,现在按字显示(#156546)。
  4. 冷启动时输入框里的字被吃掉。 桌面端启动并恢复上一个聊天的那几秒,你打进去的内容会丢失或错位。修了两处(#156615、#156642)。
  5. 重连后回复画两遍。 回复到一半断线重连,界面会把已存下的回复再画一次,附件重复。现在只显示一次、内容完整(#156611)。
  6. 未登录却让你去登录 Webapp。 在 Webapp 里打开 Hermes Cloud agent、但这台机器没登录 Nous Portal 时,提示指向了错误的登录入口。现在明确告诉你登录 Nous Portal,并用 409 而不是 401 表达这种状态(#156652)。
  7. 退出 CLI 留下一个 git 进程。 启动时的更新检查正在等 GitHub,你按 Ctrl-C 退出,那个 git ls-remote 还活着。现在它会跟着 CLI 一起结束(#156616)。

如果你是桌面端用户,第 2、4、5 条基本就是“每天都可能碰到一次”的级别。光这三条,这次升级就值了。

只被一句话带过的能力

发布说明用一段话列了十来项,每一项其实都够写一篇。这里挑四件对日常使用影响最大的:

桌面端终于有备份与迁移页面了。 Settings ▸ Backup & Transfer 两张卡:一张把整个 agent 打成一个 zip(每个 profile、设置、记忆、技能、定时任务、会话、.env、auth.json),一张把这份备份装进你选的一台云端 agent。用的是普通的 hermes backup 和 hermes import --keep-host,没有私有迁移格式;替换前会先留撤销点,失败会点名哪些文件没恢复。想细看的见备份与云端迁移那篇。

备用模型链可以体检了。 hermes fallback check 不启动会话,逐条检查配置与凭据;加 --live 会真的发一次最小请求,能抓出额度耗尽、模型下线、端点 502,以及“对方换了模型回答你”这种静默降级。任何一条不通就以退出码 1 结束。细节见fallback 体检那篇。

子代理能在重启后接着跑。 每个子代理在 state.db 里有持久记录,工作目录会被固定保留(默认 48 小时),resume_mode 说明它为什么停下;delegate_task(action='continue') 手动续,delegation.auto_resume 打开后网关每 15 秒自动续。细节见子代理自动续跑那篇。

定时任务的投递可以按 job 调了。 --no-wrap-response 让简报不再套 Cronjob Response: ... 那层抬头和结尾说明;--attach-to-session 让简报变成可以追问的会话,Telegram topic 里的 job 还能配 cron_fresh_thread_per_run 每次运行开新线程;catch_up、grace_minutes、timezone 同样都能按 job 设。细节见定时任务投递开关那篇。

窗口里还有:每个会话一个 prompt-cache 时钟、hermes update --force(立即停止网关而不是等待排空)、从 Telegram / Discord 输入一次性 browser_vault 验证码、可选的 Telegram 共享私信线程、Gemini 3 及之后版本默认走 Gemini Interactions API(含 Gemini 4 Carbon)、Claude Mythos 5.2 的 fast mode、新的插件 API(ctx.fork_session、ctx.redact_text()、ctx.register_idle_task)、更瘦的 macOS 包(首次使用时才装 Chromium)。

其中 prompt-cache 时钟、browser_vault 验证码、插件后台会话这几项,我们之前已经分别写过:prompt-cache 时钟、vault 验证码、插件 fork_session。

该不该现在升

分三种情况看:

桌面端重度用户:建议升。 上面第 2、4、5 条都是界面层的直接体验问题,而且新版桌面端还多了备份页面。注意用安装包装的桌面端在本次不会跟着变(它随下一个捆绑版本更新),Microsoft Store 版走商店更新。

CLI / 服务器用户:可以升,但先做两步。 第一步,跑一次 hermes fallback check(备份链是不是真的能用);第二步,如果你依赖定时任务,先看一眼 hermes cron doctor,再决定要不要给关键 job 加上 --no-wrap-response / --attach-to-session。这两步都不改行为,只是让你知道现状。

Docker / 云端:照旧拉 stable 或 latest。 这次没有需要手工迁移的东西。

要提醒一句:--live 的体检会发真实请求(每条一次、token 很少但不是零),别把它塞进每分钟跑一次的循环里。

一个小结

“Patch release” 在这里的含义是“发标签的版本”,不是“没什么内容的版本”。这一次的后缀只跳了一位,窗口里有 1,989 个 PR、5,211 个改动文件,还有四件官方只用一句话提过、但真正影响每天使用的事。官方把详细说明留给了 v0.24.0,在那之前,这几篇算是补上那段空缺。

完整条目见 v0.23.2 版本页。