v0.21.3

Hermes Agent v0.21.3

Overview

v0.21.3 — The Sign-In Patch。 2026 年 9 月 14 日发布。自 v0.21.2 以来：1,036 个非合并提交 · 2,642 个改动文件（+131,690 / −37,096）· 338 个已合并 PR，统计于提交 9b419a2d3c2657c192008e732149d61170b32c01。

有些修复只对“从不手动跑 hermes update“的那批安装有意义，这个 tag 就是为它们切的：Docker 镜像、Hermes Cloud 和托管部署都从最新的 release tag 构建，所以上一窗口里远程网关的登录修复必须先滚进一个稳定 tag，云端用户才拿得到。这个窗口本身并不小——同样的约 338 个 PR 里还有网关线上契约、每个模型选择器上的推理强度、OpenRouter OAuth PKCE 登录、HEIF/HEIC/AVIF 解码，以及一大批平台侧工作——但这些的完整梳理会随 v0.22.0 一起发布，那一版会从 v0.21.0 起把全部内容补上。本页只讲这个 tag 是为哪两件事切的。

Highlights

1. 桌面唤醒时的刷新风暴，不再把你的会话吊销掉

远程 dashboard 会话曾经会在“多个请求同时到达”时失效。网关的两条刷新路径——cookie 网关和桌面端的原生 bearer 路由——会各自出示同一个轮换中的 refresh token；而身份提供方在 refresh token 被使用后就轮换它，第二次出示旧值会被判为令牌盗用（token reuse），直接吊销整个会话。桌面从睡眠中醒来正好是一次天然的请求风暴，所以这个故障看起来像随机发生，而且总在最不方便的时候出现（#110061，修复 #55712）。

现在，携带同一个轮换令牌的并发刷新会被合并：由其中一个请求完成轮换，其余请求采用它的结果。刷新也从事件循环上移开了，身份提供方再慢，也不会把 /api/status 一起冻住。

Portal 侧有一个配套改动（hermes-portal#1209）：空闲期改为滑动 30 天，并给轮换后的旧令牌留 5 分钟宽限期，让真正在途的并发请求不会被误判成盗用。

2. 长驻进程不再泄漏重复的 state.db 写入句柄

拓扑本身健康时，日志里也可能冒出 N live SessionDB handles 这条前兆。网关、dashboard/桌面后端、ACP 以及与 CLI 相关的读取方各自挂了一个写入句柄，于是这个计数一路涨，最后诊断信息指责的正是它本该发现的那个问题（#110934，修复 #100896 和 #103339）。

现在这个形状被明确了：读取方以只读方式附加，进程内的写入方共享注册表里的同一个句柄，而不是各自去开一个。句柄越少，某个组件取消另一个组件锁的机会就越少——这正是 v0.21.2 补丁版用六个 PR 关掉的那一类故障。

Also in this window

这个 tag 滚入了自 v0.21.2 以来合并的全部内容，不止上面两条。按领域分组如下，具体说明留给 v0.22.0 的正式发布说明：

  • 网关线上契约：服务端到客户端的 JSON-RPC 请求取代了 *.request / *.respond 事件对（#110521），并用一份 Pydantic 线上契约注册表生成 TypeScript 与 OpenRPC 类型（#110522、#110523）。
  • 模型与推理：每个模型选择器都可以设置推理强度，桌面端多了 composer 上的强度药丸与按辅助任务设置强度的入口；OpenRouter 支持 OAuth PKCE 登录。
  • MCP：存储的 OAuth refresh token 被绑定到签发它的授权服务器；桌面端每天提醒一次需要重新登录的服务器。
  • 媒体：支持 HEIF、HEIC 与 AVIF 图像解码。
  • Provider：FAL 目录新增 Wan 3.0、Kling 3.0 / Kling Image v3、MiniMax H3 Max Turbo、Gemini Omni Flash 1.1 与 Meta Muse；Honcho 的 peer-model 设置被重做。
  • 平台：Slack 支持粘贴的表格，并加入 Agent Sessions API。
  • 存储与 profile：多路复用 profile 的隔离与网关存活性的修复，以及拒绝在跨 VM 文件系统上跑 WAL 日志模式。

Upgrade

已有安装就地升级：

hermes update

Docker 与 Hermes Cloud 从该 tag 构建：

docker pull nousresearch/hermes-agent:v2026.9.14

完整 diff 见 v2026.9.11…v2026.9.14。

← Hermes Agent Changelog