Overview

v0.22.5 —— 一次打包式补丁。 发布于 2026 年 10 月 22 日。基于提交 bf0203a794a 统计：231 个非合并提交 · 804 个改动文件（+35,212 / −17,885）· 81 个合并 PR · 30 个已关闭 issue。

这个 tag 的用途很实在：那些没法跟着 main 走的分发面——带 CLI 与安装脚本的 GitHub release、Microsoft Store 应用、Docker 和 Hermes Cloud——需要停在同一个稳定点上，而不是停在三天的合并工作里。发布说明写得很直白：这个窗口的整理版说明会随 v0.23.0 一起发，那份会覆盖 v0.22.0 以来的一切。所以这一页给的不是完整清单，而是一段故意没展开的改动摘要。

而这段摘要恰恰是最有用的部分。里面有四件事我们已经单独写过，剩下的则是那种“你先感觉到、后说得出名字”的改动：更新器开始拒绝提供它不会装的版本、Windows 的 launcher 在 Python 重新 pin 后不再退回旧版、斜杠命令可以反过来问你一个问题、侧栏可以用拖拽固定。

---

Highlights

1. 先说数字：这个补丁有多大

一个 tag 里 81 个合并 PR，算大补丁。升级前值得知道它的形状：231 个非合并提交、804 个文件、+35,212 / −17,885 行。里面大部分不是一个新功能，而是三天窗口累积下来的尾巴。作为对照，上一个 tag v0.22.4 是 13 个合并 PR、82 个文件。

2. hermes update 现在会按住它拒绝接受的版本

以前更新器可能把某个 stable release 摆给你，你点了同意，却什么都没装——看起来像“升级卡住了”，其实是它不接受。这个版本里，更新器不会接受的 stable release 会被按住不提供。实际效果：更新提示只在这个安装真的能升到那个版本时出现，被拒绝的版本不再伪装成你造成的卡顿。

3. Windows 的 launcher 不再卡在旧版

Python 的 pin 变化之后，Windows 上的 hermes update 可能停留在旧 launcher 上——更新跑完了，你下一条命令跑的还是上一个版本。现在 launcher 的重指向是更新流程的一部分，下一个 hermes 就是新构建。

4. 插件斜杠命令可以让你挑一个选项

插件的斜杠命令以前是“一发即走”：要么跑完，要么打印点东西。现在它可以摆出一组选项，等你挑完再继续。对插件作者来说，一条命令变成一小段对话，而选项列表是插件自己给的，不用模型去猜、去拼一段自由文本。

5. 桌面端：拖拽固定侧栏，一键装插件并显示等级徽章

桌面壳有两处变化。侧栏条目可以拖到你想要的位置固定；插件可以从目录里一键安装，每个条目带一个等级徽章，点之前就能分清官方、已验证和社区插件。同一版本还包含 Electron 44 升级。

6. hermes mcp serve 与 Singularity 从 core 搬进插件

两者都从核心包移到插件目录——和 v0.22.4 里 agent-importers 走的是同一个方向。现在 setup 在机器上发现别的 agent 的配置时会主动提供导入器，hermes import-agent 与 OpenClaw 迁移都属于这一块。如果你依赖 MCP server 模式或 Singularity/Apptainer 终端后端，升级后要按插件装回来。

7. 边角上一堆你会察觉的小事

• Pillow 13，以及一批依赖安全更新。
• 对话的工作目录消失时，现在会明确告诉你，而不是让工具调用报一个莫名其妙的路径错误。
• 长的 Claude DirectSDK 回答不再被 stall 计时器截断。
• 桌面端群聊又能显示哪个 bot 正在干活。
• 一个实验性的 webhook 模式 MCP 事件客户端随这个版本出现。

Fixes

修复	细节
被拒绝的版本	更新器不会安装的 stable release 不再作为更新摆出来
Windows launcher	hermes update 在 Python 重新 pin 后重指向 launcher，而不是留着旧的
DirectSDK stall 计时器	长的 Claude DirectSDK 回答不再被 stall 计时器截断
群聊指示	桌面端群聊重新显示哪个 bot 在工作
工作目录	对话的工作目录消失时会说明这件事，而不是丢一个路径错误出来

站内已单独写过的四件事

这个窗口里有四项在合并时就已经单独成文：

• Nous 登录重做——每次登录都是普通 device login，免费层访客会移交到你的账号：登录移交那篇。
• 可插拔委派后端——按模型映射或 profile 路由子代理，可按会话切换：委派后端那篇。
• 用量窗口套餐——套餐进度条、限额卡片、换模型后的恢复：用量窗口那篇。
• Windows 半更新安装——半途而废的更新长什么样、怎么修：Windows 半更新那篇。

Upgrade

• Microsoft Store 版： 通过 Store 更新。
• 从安装包安装的桌面端（.exe / .dmg）：这个版本没有变化，等下一个打包版本。
• CLI： hermes update，或者重跑安装一行命令。
• Docker / Hermes Cloud： nousresearch/hermes-agent:stable（或 :latest）。

完整变更对比：v0.22.4…v0.22.5

← Hermes Agent Changelog