v0.23.1

Hermes Agent v0.23.1


概览

v0.23.1 —— 一个上限的补丁。 发布于 2026 年 11 月 9 日。自 v0.23.0 以来累计 约 618 个已合并 PR · 2,578 次非合并提交 · 2,781 个文件变更(+151,690 / −62,595)· 409 个 issue 关闭(测量点 commit 3b421578588)。

这不是一个功能版本,而是一个“把窗口钉住”的稳定标签:GitHub release(CLI 与安装器)、Microsoft Store 应用、Docker 与 Hermes Cloud 都从这里取。官方说得很清楚——这个窗口里的绝大多数功能不会在这里展开说明,完整的策划型发版说明随 v0.24.0 一起发布,从 v0.23.0 起的内容都会写进去。

所以这个版本真正的主角只有一件事:插件目录为什么突然装不上新插件了。


亮点

1. 插件目录上限:2 MiB → 16 MiB

官方插件目录的发布文件在 11 月 9 日越过了客户端的接收上限(2 MiB)。越过之后,取目录这一步被判定为异常响应,客户端记一条 debug 日志、返回“没有线上目录”,然后退回安装包自带的那份目录。整条链路对用户完全静默。

后果有三个,第三个最麻烦:

  • 新收录的插件在你的机器上不存在;
  • 被重新钉到新提交的插件,装到的是你发布版本自带的旧钉;
  • 之后新增的“已下架”条目你看不到,于是一个已被判为不安全的插件仍然显得可以安装。

这个补丁把上限抬到 16 MiB(#151860,修复 #151856)。按当前平均条目体积估算,16 MiB 大约容纳 9,000 个条目,同时仍然给恶意或损坏的响应留了一道边界。停留在 v0.23.0 或更早版本的安装,仍然会退回自带目录,直到更新为止。

2. 窗口里被“故意不展开”的功能

发版说明点名了一批本窗口内合入、但不在这个补丁里展开的内容:

  • TUI 与经典 CLI 的 Esc 回退,取代原来的回退列表选择器;
  • 不依赖桌面端也能跑的群聊,可以坐进来自其它电脑的机器人;
  • 保存的 gateway 连接在桌面端与 Webapp 之间共享;
  • 应用内浏览器用真实浏览器配置登录,并从地址栏填充已保存的登录信息;
  • hermes gateway attach,供本机客户端接入;
  • hermes clipboard image --json;
  • 新插件 API:会话级环境值、插件 JSON-RPC 方法与事件、llm.oneshot 辅助任务、压缩后保持稳定的 conversation_id、gateway 的 on_session_open 钩子与 post_curator_run 钩子;
  • 更快的历史记录与 handoff 读取,以及一批新的插件目录条目。

修复

问题 结果
线上插件目录超过 2 MiB 上限 上限抬到 16 MiB,线上目录重新生效
目录退回自带副本后无任何提示 行为不变(兜底策略保留),失败原因仍只在 debug 日志里
新插件“搜不到”、版本钉过旧、下架条目缺失 随上限修复一并消失

升级

hermes update
  • Microsoft Store 应用:通过商店更新;
  • 用 .exe / .dmg 安装器装的桌面端:本次无变化,跟随下一个打包版本;
  • Docker / Hermes Cloud:nousresearch/hermes-agent:stable(或 :latest)。

升级后建议验证一次:装一个之前搜不到的插件,确认目录确实恢复。更完整的背景与自查方法见这篇发版解读。

← Hermes Agent Changelog