官方把这个版本称为 "The Threshold Release(门槛版)"——核心不是堆新功能,而是把"上手门槛"和"稳定地基"一起打牢,并合并回收了 v0.21.1~v0.21.7 所有补丁版的改动。
版本体量
- 基线区间:自 v0.21.0 起
- 提交规模:约 24,200 次提交、6,080 个合并 PR
- 变更文件:约 15,600 个
- Issue 关闭:约 7,180 个
- 贡献者:约 2,520 人
- 提交类型分布高度偏重构与修复(fix + refactor 占 60%+),属于典型"稳定化大版本"而非功能堆砌型
三大核心主题:把门槛踩平
1. 新用户进门:零 Key 引导式首启
新装桌面端不再甩设置页,而是直接进入一段 引导对话(onboarding chat):
- 一次一张卡片问称呼、主题色、布局、要连的应用、要装的插件
- 跑在免费试用模型
nous/welcome上(每系统用户一次) - 不需要 API Key、不需要账号
- 支持
set_theme工具,对话里直接改界面样式 - 可随时在 Settings → Run onboarding again 重跑
2. Connectors:Agent 走进你已有的应用
通过 Nous 工具网关,Gmail / Linear / Notion 等托管应用可直接被 Agent 调用:
- 说一句"连 Gmail"→ 浏览器登录一次 → 同轮对话里工具生效
- 首次使用可建"仅连接器"免费身份,无需完整账号
- 同一应用支持多命名账号(如 work / home 两个 Gmail)
- 桌面端新增 Connectors 页,与原 MCP 服务器并列(取代旧 MCP 标签页)
3. 本地模型一键托管
Settings → Providers → Local Models 里直接装:
- 自动按 CPU/CUDA/Metal/Vulkan/ROCm 选引擎
- 按显存/内存给目录内模型打分,推荐能塞进显存的最高配
- 自动维护 llama.cpp、断点续传、引擎一键升级
- 内置 Qwen3.8 27B、Qwen3.8 Flash Next、Qwen3.6 35B-A3B、DeepSeek V4 Flash
- 支持 HuggingFace 任意 GGUF;LM Studio / Ollama 也可作 provider 接入
地基层:稳定通道 + 签名包 + 统一包管理
- SemVer 稳定版通道:源码安装默认从 release 到 release,不再追 main 的每个提交;想尝鲜用
hermes update --set-channel main - 签名桌面包:
- Windows → 签名 MSIX(x64 / ARM64),走 App Installer 或微软商店
- macOS → 签名公证的 Apple Silicon 构建
- 首次启动不再现场编译,自带 Python + Node
- 统一包管理器
hermes pm:固定版本、哈希校验 Python 3.14 / uv / Node / ripgrep / FFmpeg / Chromium - 自动恢复:provider 短暂 503/529 时进入有界重试(
agent.auto_recovery_cycles默认 5),不再直接断轮
插件与生态重构
- 插件目录上线至约 600 条,每条 pin 在审阅过的 commit 上,禁改内部、禁不可扫描二进制
- 记忆 provider 外置为目录插件:Honcho / Supermemory / Hindsight / Mem0 / OpenViking / Holographic 迁出核心;Home Assistant、Spotify、Langfuse 同理
- ByteRover、RetainDB 仍内置
- 老用户升级时自动迁移,数据保留
性能与瘦身
- 源码从约 106 万行缩到 69.8 万行(−34%),gateway/run.py 从 34,847 行降到 5,512
- 约 19 个低频工具改为按需加载
- 桌面端工具 schema 从 13,367 token → 6,883 token(接近减半),每轮预填更少
- 固定 prompt 再砍 ~2.1k token
- 本地模型每轮 prefill 压力明显下降
安全修复(本版重点)
Dashboard 登录加固(致谢 Tenable Research):
- 伪造 X-Forwarded-For 绕过限流 → 修复
- 未认证登录请求写无限长审计日志 → 修复
/auth/公网路由无 body 大小限制 → 加限制- native sign-in 登录码发到非 loopback 重定向导致会话接管 → 修复
Git 调用加固:
- 自动 git 操作(workspace 快照、subagent worktree、kanban)不再执行不可信仓库自己配置的 clean/smudge filter
邮件网关发件人伪造:
- From 头带引号显示名可绕过白名单 → 修复
浏览器登录:
- 支持 1Password / Bitwarden / Hermes 加密保险库取凭证,模型上下文看不到密码
- 一次性验证码不进对话,结账填卡需人工确认
交互与体验小改进
- CLI 可选 vim 键位、状态栏 git branch、等待用户时响铃+桌面通知
- Ctrl+C 改为清空当前草稿而不是杀掉回合
/queue可编辑hermes --native让宿主终端接管 TUI 滚动- 桌面端新增 Simple 模式(纯聊天窗口),错误信息带一键修复
- 全 CLI/TUI/网关/桌面字符串接入统一翻译目录,16 种语言全覆盖,新语言可做插件
升级前必须知道的破坏性变更
| 变更点 | 影响 |
|---|---|
| 托管运行时改 Python 3.14 | KittenTTS 在 3.14 下不可用 |
| Windows 桌面仅发 MSIX | 需 Win11 22H2+,NSIS/MSI 安装器移除 |
| macOS 默认仅 Apple Silicon | Intel 构建不再默认提供 |
| 每机单网关成默认 | 旧多 profile 独立网关会被折叠进复用网关 |
session_resetidle/daily 模式退役 |
改用/new或/reset |
sessions.auto_prune默认开 |
结束且 90 天不活跃的会话启动时删除(置顶/打开中的不删) |
| 记忆 provider 迁插件 | 自动迁移,但旧配置别手动改 |
| 旧插件兼容层移除 | hermes sync、内置 tirith 扫描器移除 |
| 工具改名 | todo→todo_list、cronjob→cronjob_manage、process→process_manage,旧名暂兼容 |
本窗口被回退的项(不随 v0.22.0 发布)
避免误传,以下几项曾合入又被 revert:
- Collective Wisdom V1 组织内技能市场
- 卡片式 Skills/Plugins 目录浏览器(暂回退为列表 tab)
- 等待式 approval/clarify 阻塞(仍走
approvals.timeout) - Bot Mode 并行群聊轮次(暂回退串行)
- profile 与 root auth.json 完全隔离(回退,profile 有自己登录时保留)
- cron 创建时快照模型(改为跟随主模型,pin 才锁)
一句话定性
v0.22.0 是 Hermes 从"开发者向 Agent 框架"转向"所有人能用的 Agent 产品"的拐点版本:引导首启 + Connectors + 本地模型把人请进门,稳定通道 + 签名包 + hermes pm + 安全加固把门框焊死。
💡 升级后建议自查四条:
hermes version→hermes doctor→hermes gateway status→ 旧多网关拓扑先跑migrate --dry-run。重启网关别在当前会话前台执行,否则正在跑的回合会被 SIGTERM 拦腰掐断。