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