v0.22.0

Hermes Agent v0.22.0

Overview

v0.22.0 — The Threshold Release。 发布于 2026 年 10 月 13 日。自 v0.21.0 起：~24,200 个提交 · ~6,080 个已合并 PR · ~15,600 个文件改动（+2,045,000 / −1,140,000）· ~7,180 个 issue 关闭 · ~2,520 位贡献者。

Hermes 是门槛之神：门、跨越、界石。v0.21.0 让众神归位，v0.22.0 讲的是怎么穿过那道门。桌面端首次安装现在打开就是一段引导对话，跑在免费试用模型上——新用户还没买 API Key，就已经在跟 Hermes 说话了。Connectors 把 agent 带进你日常使用的外部应用，起步不需要账号。本地模型一键装好，跑在你自己机器上。门槛本身也加固了：经过测试的 SemVer 稳定版、默认跟随它更新的安装方式、签名的桌面安装包（含 Microsoft Store），以及底下统一的包管理器。围绕这条主干：600 个插件的目录、Claude 5.5 / GPT-6 模型潮、浏览器里的密码管理器登录、可以随时接管的 Bot Screen、一套 profile 共用一个后端和一个网关，以及小了三分之一的代码库。

这是 Hermes 到目前发布过的最大窗口，约为 v0.21.0 周期的 2.5 倍，并完整汇总、记录了 v0.21.1–v0.21.7 的补丁版本。

Highlights

1. 第一次启动就开始配置自己

在一台从未用过 Hermes 的电脑上打开桌面端，出现的不是设置页，而是一段简短的引导对话。它一次问一件事：你的名字、强调色和布局、要连接哪些应用、要装哪些插件，然后给一段快速导览，并挑好最多四个可以立刻开始的任务。它跑在免费试用模型 nous/welcome 上（每个系统用户一次），所以不需要 Key；Skip setup 随时结束，Settings → Run onboarding again 可以重来。agent 也拿到了 set_theme 工具，“换成紫色、暗色模式”在任何桌面会话里都成立（#137429、#137522、#137807、#134209、#105258）。

2. Connectors：Hermes 直接在你的应用里干活

通过 Nous 工具网关，agent 现在可以在 Linear、Notion 这类托管应用里真正动手：说出你要哪个应用，在浏览器里登录一次，同一轮里工具就能用。起步不需要 Nous 账号——第一次使用某个应用时，Hermes 会创建一个免费的 connectors-only 身份。桌面端新增 Connectors 页面，把托管应用和你的 MCP 服务器放在同一张列表里（它取代了原来的 MCP 标签页），TUI 和 CLI 里是同一张设置卡片；同一个应用可以连接多个命名账号（一个 work、一个 home），用 /connectors 或 hermes connectors 管理（#106842、#111008、#119074、#135143、#135072、#135097、#135151、#135173、#137426）。

3. 一键本地模型

Hermes 现在可以在你本机完整运行开源模型，什么都不出这台机器：不需要账号，不需要 API Key。它会安装并维护 llama.cpp，为你的硬件挑对引擎（CPU、CUDA、Metal、Vulkan 或 ROCm），把每个目录内模型按你的 GPU 和内存打分，并选出放得下的最好版本。下载可暂停可续传，服务器随 Hermes 启停，引擎更新一键完成。入口是 Settings → Providers → Local Models（Windows、macOS、Linux）或终端里的 hermes model → Local models。目录含 Qwen3.8 27B、带 MTP 投机头的 Qwen3.8 Flash Next、Qwen3.6 35B-A3B 和 DeepSeek V4 Flash，也可以直接拉 Hugging Face 上任意 GGUF（#100667、#101823、#128768、#111423、#133111、#134116）。

4. 稳定版通道

Hermes 现在发布经过测试的 SemVer 版本。每个版本在发布前都要通过源码 CI、Docker、Nix、签名桌面构建，以及每个操作系统的安装/升级演练；源码安装默认在版本之间移动，而不是追着 main 的每个提交跑。想贴最新？hermes update --set-channel main，或桌面端 Settings → About 里的通道开关。退回更老的版本会被标记为 rollback，不问你绝不会发生；重跑安装脚本也会停在你选的通道上（#102765、#135847、#135949、#136313、#137780）。

5. 签名桌面安装包、Microsoft Store，和一个包管理器

桌面端现在是一个密封的签名包，自带 Python 和 Node，并自己更新，所以首次启动不需要现场构建。Windows 拿到签名的 MSIX（x64 与 ARM64），通过 App Installer 或 Microsoft Store 分发；macOS 拿到签名并公证的 Apple Silicon 构建。底下新的统一包管理器（hermes pm）接管所有固定版本、校验哈希的工具和 Python 环境：更新会先构建一个新环境，检查通过后才切换，所以一次失败或被中断的更新不会让你停在半应用状态（#102765、#132361、#132386、#120339、#122221）。

6. 插件目录：600 个已审核插件

插件目录在这个周期上线，并长到 600 个条目，每一条都固定到一个经过审核的提交，可从 Hermes 桌面端或 CLI 安装。可以按分类和 star 排序浏览，每个插件、每位作者都有独立页面；目录规则保证收录的插件不能改动 Hermes 内部实现，也不能夹带无法扫描的二进制。记忆类 provider 现在跟着各自的作者走（Honcho、Supermemory、Hindsight、Mem0、OpenViking、Holographic），Home Assistant、Spotify 和 Langfuse 同理：老用户自动迁移，默认安装也更精简（#69446、#111415、#117808、#113381、#114732、#131267、#132476、#136436）。

7. Claude 5.5 与 GPT-6 模型潮

Claude Fable 5.1、Opus 5.5、Sonnet 5.5 和 Haiku 5.5，GPT-6 Astra、Sol、Luna 以及 GPT-6.1 Sol，Gemini 4 Argon，都能在 Nous Portal、OpenRouter 及提供它们的原生通道上选中。此前产生的推理过程现在默认在每一个能读取它的 provider 上重放，跨恢复、分支和压缩都在，所以长时间多步工作保留自己的思路。而当一个 provider 状态不佳时，Hermes 会在可见、有界的循环里等过瞬时的 503/529/超时，而不是直接结束你的这一轮（#100577、#119304、#126842、#134759、#128248、#137955、#136358、#116353）。

8. 用密码管理器登录网站

浏览器 agent 可以用 1Password、Bitwarden 或 Hermes 自带的加密保险库里的登录信息登录网站，而模型永远看不到密码。如果什么都没存，CLI、TUI 或桌面端会出现一个遮罩提示让你保存；一次性验证码会自动填入，且不进入对话；结账时的银行卡和地址填充需要你确认（#106480、#107585、#137084）。

9. Bot Screen：看着你的 bot 干活，需要你时接管

跑在 Linux 网关上的 bot 可以有自己的桌面，由 Hermes 桌面端实时串流。当它撞上登录、2FA 提示或 CAPTCHA，你接管屏幕，自己走完这一步，再把控制权交回去，bot 带着你的会话继续。使用 Docker、SSH 或 Singularity 后端时，bot 的屏幕、computer use 和浏览器都跑在沙箱里，绝不落在你的宿主机上（#108914、#121169、#121110）。

10. 所有 profile 共用一个后端和一个网关

现在每台机器只跑一个消息网关和一个桌面后端，服务你所有的 profile，而不再是每个 profile 一个进程。新建 profile 后它的 bot 立即生效，无需重启；每个 profile 保留自己的凭据、允许名单、cron 任务和会话；hermes update 会自动迁移既有的多 profile 部署。更少的进程，没有令牌冲突，启停只需一件事（#112854、#108928、#118273、#117983、#118246、#118027）。

11. 实时看到并干预子代理

正在运行的子代理现在会停在输入框上方：CLI（F6）、TUI（Ctrl+T）和桌面端都能看到每个子任务的任务、已用时长和实时转录，并带 Steer 与 Stop 按钮。/stop 能触达后台子任务并交回它们的部分成果，delegate_task 还能把截图和设计稿传给支持视觉的子代理（#105593、#115616、#97689）。

12. 懂你套餐的模型选择器

收藏常用模型，在低额度时直接看到“17% left · resets 3:00 PM”，限流何时解除也显示在选择器里；推理强度成为选模型的一部分，在 hermes model、/model（/model X --reasoning high）和桌面端都能设。你在撞墙之前就完成切换，而不是撞了之后（#126535、#133392、#133408、#110346、#113117）。

13. 每个界面都说你的语言

CLI、消息网关、TUI 和桌面端的每一句面向用户的字符串，现在都走同一套翻译目录，内置语言覆盖完整。新语言可以作为插件发布，任何 profile 都能用一个小 YAML 文件覆盖个别字符串（#126296）。

14. 全面变轻

整个代码库在不改变任何行为的前提下被简化：源码从约 1.06M 行降到 698K 行（−34%），gateway/run.py 从 34,847 行缩到 5,512 行。提示词也轻了：约 19 个很少用到的工具改为在 agent 搜索时才加载，桌面端每次调用发出的工具 schema 大约减半，固定提示词又省下约 2.1k token。本地模型每一轮的 prefill 也更少（#102117、#97979、#106676、#137084）。

15. 一点点小舒服

CLI 输入框可选 vim 键位，状态栏多了 git 分支字段，Hermes 等你回应时会有铃声和桌面通知，Ctrl+C 清空草稿而不是杀掉这一轮，/queue 可以编辑，hermes --native 让你自己的终端接管 TUI 的滚动与搜索。桌面端新增 Simple 模式，把应用变成一个纯粹的聊天窗口；出错时会说明哪里出了问题，并给出一键修复（#106412、#106434、#101284、#101320、#137065、#95999、#121035、#118587、#111601）。

⚠️ Upgrade notes

  • 托管安装的运行时是 Python 3.14（包管理器会替你装上）。KittenTTS 在 3.14 上不可用（#102765）。
  • Windows 桌面端只提供 MSIX，需要 Windows 11 22H2 或更新版本，NSIS/MSI 安装器已移除。macOS 默认构建仅支持 Apple Silicon（#102765、#136603）。
  • 每台机器一个网关成为默认。 没有冲突时，hermes update 会把按 profile 分开的网关并入多路复用的默认网关（#112854）。
  • 会话不再按空闲/每日计时器重置。 session_reset 的 idle/daily 模式已退役（仍配置它们的会打警告）；用 /new 或 /reset 开新会话（#105021、#126244）。
  • 老会话会自动清理。 sessions.auto_prune 现在默认开启：结束且 90 天无活动的会话会在启动时删除。置顶和打开的会话永不受影响；设 sessions.auto_prune: false 可全部保留。
  • 记忆类 provider 改为目录插件（Honcho、Supermemory、Hindsight、Mem0、OpenViking、Holographic），Home Assistant、Spotify、Langfuse 同样。老用户会在更新或首次启动时迁移，数据完整。ByteRover 和 RetainDB 仍随核心打包。
  • 插件作者注意：旧的插件兼容导入层已移除（#126164），hermes sync（Skill Sync）已移除（#132465），随包分发的 tirith 扫描器已移除（#133832）。若干工具被改名（todo → todo_list、cronjob → cronjob_manage、process → process_manage）；旧名字仍然可用（#97979）。

🚪 Onboarding, Free Tier, Connectors & Local Models

  • 首次运行引导 — 全新桌面安装会出现引导对话（见 Highlight 1）。既有安装与远程（SSH、URL、Cloud）后端不会自动获得；旧的 setup-profile 流程与 /initiate-setup 已删除（#137420、#134215、#108292）。
  • set_theme — agent 可设置强调色（色板或任意 #rrggbb）、浅色/深色/跟随系统与布局，或直接弹出选择器（#137522）。
  • 免费层 — 没有 provider 也没有 Nous 账号的首次桌面安装，会拿到免费 nous/welcome 模型作为一次性试用（每个系统用户一次）。CLI、TUI 和网关不提供免账号与免费模型；HERMES_GUEST_ONBOARDING 已移除。hermes auth upgrade 或在任意会话、私聊里 /login，可把这个免费身份升级为完整 Nous 账号，并保留已连接的应用（#137807、#105258、#105259、#105260、#105261）。
  • 免费层边界清晰 — 免费限流会立即结束该轮并给出重置时间；每个免费层失败都有错误码和一句人话；应用会处理账户服务的浏览器校验；免费层用户会看到条款与隐私提示。没有额度的 Nous 账号，可以选择让其持有的订阅计费的模型，并获得免费的托管快速网页搜索（#134049、#111970、#133824、#117079）。
  • Connectors — 托管应用连接器、Connectors 页面、一个应用多个账号（见 Highlight 2）。连接器工具还能把你的本地文件作为附件发送，并保存它们返回的文件。nous.guest: false 关闭访客身份，tools.connectors.enabled: false 关闭连接器（#111238、#138014）。
  • 本地模型 — 一键安装（见 Highlight 3）；Hugging Face GGUF 下载支持暂停/续传；在能跑推荐机型的机器上，引导结束后会给出一次性设置邀请（#129506）。引擎可一键更新：Linux 上的 NVIDIA 走 CUDA，AMD 与 Intel GPU 按自身显存走 Vulkan，所有后端都跑 llama.cpp b11370（#111423、#133111、#131782）。推荐更保守：只有能完整放进显存的模型才会被推荐，27B 不再推荐给跑不动的机器（#108429、#135438、#134116、#112107）。自有本地服务：LM Studio 有 provider profile，Ollama 选择器不再闪烁，自启的 llama.cpp 服务器会出现在 /model，桌面托管模型的回退可用（#134320、#113129、#116679、#131795）。

📦 Stable Releases, Desktop Packages & Package Manager

  • 稳定版与更新通道 — 经过测试的 SemVer 稳定版与通道开关（见 Highlight 4）。v0.21.6 和 v0.21.7 是第一批走新闸门的版本；fork 留在 main，领先于最新版的安装会等待下一个版本。更新检查更轻：每天一次 GitHub API 调用取代每 30 分钟一次 git fetch（#107648）。
  • 密封签名的桌面包 — 见 Highlight 5。在打包安装里，hermes update 会指向正确的更新器（App Installer、Store 或 macOS）（#134911）。打包安装端到端可用：agent 的终端可以运行 hermes，卸载会解释系统级移除方式，依赖 Python 的插件能在 MSIX 内安装（#134051、#135333）。
  • hermes pm — 统一包管理器（见 Highlight 5）：固定并校验哈希的 Python 3.14、uv、Node、ripgrep、FFmpeg、Chromium，以及 Windows 上的 Git/Bash，配合 hermes pm doctor|status|repair|gc。贡献者用 source ./activate（或 .ps1/.fish）。
  • 依赖环境按代管理 — 新环境先检查再启用，失败的安装不会破坏正在用的那一代；更新和 hermes pm gc 会回收旧代（在一台机器上从 92 GB 降到 18 GB）（#124968、#133808）。可选 SDK（Anthropic、Bedrock）首次使用时在会话中途装载，无需重启；security.allow_lazy_installs: false 可关闭（#122221）。插件可以声明 Python 依赖，跨 profile 与核心一起解析；冲突会被拒绝，更新会停用不再匹配的插件（#113851、#122103、#114569、#132469）。
  • 更新不会半途生效 — 见 Highlight 5；被强杀的更新会在下次启动时自我修复（#132361、#120339）。更新更快、检出更小（macOS 上 16.5s vs 32.5s），克隆改为 blobless，部分克隆的 .git 膨胀被修复（#135092、#133016、#131679）。
  • 安装器 — install.sh/install.ps1 校验固定版本的 uv 与 Git，交给 PM，日志写入 logs/install.log，并且现在支持 musl Linux（Alpine、Void）、Windows 10 与含 Unicode 的 Windows 路径（#124964、#125598、#132430）。开启遥测后，安装、更新、技能与插件失败都会记录原因（#133809）。
  • Docker / Nix / Termux / Windows — Docker 固定 Debian 13 基础镜像并带完整 Chromium，stable/latest 只在发布版本时移动，内置附加项在重启后回归（#135726、#135084）。Nix 共享同一套固定版本，其桌面应用支持 Wayland；Termux 转向签名的 APT 包（pkg upgrade hermes-agent），但文档仍警告其处于损坏状态；Windows 更新可在旧运行时仍在使用时完成（#128144、#122146、#131779）。

🧠 Providers & Models

  • Provider 成为插件 — ACP 与 CLI 驱动的 provider 可树外安装（hermes plugins install），--provider chatgpt 选择 ChatGPT Codex OAuth（#101456、#115761）。Bedrock 提供 GPT-6（1M）并强制 Claude Guardrails；Azure Foundry 列出部署；Gemini 接受完整 JSON Schema 工具；OpenCode Go 通过 Messages 路由 Claude（#133573、#107815、#115770、#98928、#134848）。
  • 新配置项 — agent.text_verbosity 设置 Responses 的回答长度；命名自定义 provider 可跑在 Codex app-server 上（#115880、#115905）。
  • 模型目录 — Claude 5.x（Opus 5.5 也在原生 Anthropic 与 Bedrock 上，1M）；GPT-6 Astra/Astra Pro 的 standard、fast 与 flex，可选 Codex -900k，Astra 与 6.1 Sol 支持 /fast ultrafast；Gemini 3.8 Flash 与 Gemini 4 Argon；DeepSeek V4.1 Flash、Qwen3.8-Max-0902、Grok 4.7、GLM-5.3-FlashX、Muse Spark 1.3、Solar Pro 4/Mini 4（#122633、#103261、#119410、#136950、#101450、#137989、#107489、#100966、#118371、#117435、#101948、#131645）。
  • 认证 — profile 之间安全共享 OAuth 登录，单次授权不再分叉；Nous 登录能扛过每小时过期、并发子代理、Portal 故障与边缘校验（#100929、#134574、#103526、#121488）。失效登录只提示一次，并给出 hermes auth add；auth.adopt_external_logins: false 停止借用 Codex CLI / Claude Code 的登录（#113816、#115586）。
  • 路由、回退与缓存 — agent.auto_recovery_cycles（默认 5）限定等待；配额重新开放的 Codex 主通道会自动回归（#116353、#130716）。自动路由不会给你没选的 provider 计费；provider_routing.models 可按模型固定 OpenRouter（#107366、#104159）。可选 cache_ttl: auto（交互 1 小时，子代理/cron 5 分钟）；大会话里会打断缓存的 /model 会先确认；压缩保留前缀（#118337、#95267、#104455）。
  • 推理 — 在每个能读取的 provider 上重放；选择器里都能设强度，支持自定义档位名；Anthropic fast mode 遵循文档（#136358、#110346、#115735、#120517）。

🏗️ Core Agent, Sessions & Memory

  • 卡住的轮次会恢复 — 看门狗（agent.turn_liveness.timeout_s，默认 600 秒）中断无进展的轮次并释放会话；反复修复转录现在会抛出单个错误而不是沉默（#99758、#99687）。无文本的死流会重试，重复循环会被切断，被中断的轮次不再被报告为已完成（#113135、#130551、#112272）。
  • 压缩按真实 token 数触发 — 使用 provider 上报的用量，不再按字节数除以 4；受保护的尾部上限为 20%，小窗口模型因此也能压缩（#104555、#117957）。糟糕的摘要不会抹掉上下文：被拒绝或过载的摘要 provider 不会改动转录，未提交的压缩不产生任何变化（#118920、#115906、#136083）。新增 provider 级 compression.model_thresholds 与 auxiliary.<task>.no_progress_timeout（#108061、#115804）。
  • 会话与 state.db — 锁超时会指出持有进程，数据库繁忙不再杀掉一轮，同机不同 PID 命名空间不能偷走租约（#116967、#134577、#132161）。state.db 不再无限增长：自动清理默认开启（结束超过 90 天的会话），并清理陈旧的 cron/kanban/子代理会话；只有 25% 可回收时才 VACUUM（#101316、#100903）。修复命令：hermes sessions set-journal-mode delete|wal、repair-profiles、repair-prompts（#117684、#115689、#124200）。
  • 记忆 — OpenViking 与 Holographic 在更新或首次启动时迁到插件目录，数据完整，否则会说明原因（#134350、#136436、#131269）。手写格式的 MEMORY.md/USER.md 会被接受，拒绝时会说明要改什么，秘密在 provider 看到之前就被清除（#133038、#134429）。
  • profile 与配置 — 损坏的 config.yaml 回退到上一个可用副本，读取错误不会清空它（#109463、#120343）。hermes config get 会遮蔽秘密（--raw 可关闭），set 拒绝拼错的路径并把环境变量风格的名字写入 .env（#111341、#112250）。profile 保持隔离：REST 路由只作用于它指定的 profile，导出会跳过 .ssh/.aws/.gnupg，import-agent --sync 保持导入同步（#118275、#132201、#88855）。

📱 Messaging Platforms (Gateway)

  • 一个网关服务所有 profile — hermes gateway status 会解释任何启动守卫的拒绝，hermes gateway migrate --multiplex 可手动迁移，webhook 平台在 /p/<profile>/ 下服务每个 profile，hermes -p X gateway stop|start 单独停用某个 profile，gateway.standalone: true 是临时的退出开关（#112854、#108952、#119774、#119680）。profile 之间保持隔离：克隆默认不复制 bot token，除非 --clone-channels；profile_routes 可按发送者路由（#109502、#115642）。
  • 会话与命令 — /login 让免费层用户从私聊登录；空闲/每日 session_reset 退役，只有 /new 与 /reset 开新会话；/branch 在 Discord、Telegram、Slack 与 Matrix 上打开兄弟线程（--here 保留旧行为）；decline 模式对未授权私聊回一句礼貌拒绝；可选的 served_model 页脚会说明是哪个模型回答的（#105261、#126244、#117450、#88028、#115925）。
  • 平台 — Telegram 可选 bots_require_mention 阻止 bot 互相应答，extra.drop_pending_on_cold_boot: false 保留离线期间的消息，CJK 可选择富消息；Discord 安装会校验 token、链接 Message Content Intent 并把你加入允许名单，自由回复频道可自动开线程；Slack 的 Block Kit /model 选择器，状态与标题使用 Agent Sessions API；WhatsApp 通过 hermes send --mention 原生提及，不再有 5 秒批处理延迟，每个 profile 都有配对会话；Signal 表格渲染为等宽，Matrix LaTeX 在 Element 里排版，Email 拒绝伪造发件人并要求设置 authserv_id 固定值（未设置前邮件会被丢弃），QQ Bot 的 send_message 可送媒体（#106534、#116134、#111831、#132456、#116168、#103436、#101477、#115253、#117104、#132518、#106538、#106515、#132663、#131927）。
  • Webhooks 与 API server — 可选 coalesce 把事件突发合并成一次运行，cron_job 让事件触发 cron 任务，Standard Webhooks 签名可校验，可选 mirror_to_session 让回复带上上下文（#92066、#95262、#104183、#120825）。API server 把推理流式发给 OpenAI 兼容客户端，流中的审批可以回答（#115797、#121769）。
  • Relay 与 Bot Chat — Bot Mode 房间可编辑成员、Reply 到 @handle、保留 200 条历史、感知发送者的 bot 私聊并带 ALLOW_BOTS 循环守卫（#113384、#107520）。Relay 检查 send_message 目标；NeMo Relay 追踪在 0.10.0 用工作目录标记 span（#99220、#135787、#108345）。

🖥️ Desktop App

  • Simple / Advanced 模式 — Simple 隐藏开发者面板，Advanced 仍是默认（#118587）。标题栏标签页；profile 可在自己的窗口打开或作为启动默认（#107099、#113176）。侧栏可按网关/profile 分组、复用 Cloud 实例、把新会话拖到面板上（#105813、#70571）。可以导入并继续另一个编码 agent 的转录（#104229）。Goal / Loop / Heartbeat 卡片在输入框上方可暂停、恢复、停止（#104246）。
  • 对话与输入 — 推理强度药丸；按 slug 添加模型；超过 3,000 字符的粘贴内容作为 .txt 附件；可选的 macOS 窗口截图快捷键（#109907、#120693、#108901、#113349）。错误卡片会说明问题与修复方式；用量上限卡片显示重置时间并可安排重试（#111601、#116288）。浏览器评论模式可以用笔记钉住页面元素，把裁剪、选择器与样式送进输入框（#100083）。
  • 设置与插件 — 有序子页面并可通过 ⌘K 搜索；聊天字体（如 OpenDyslexic）；俄语、法语、德语、西班牙语（#117127、#111226、#100429）。每个插件一行；插件可以有设置页，桌面插件能按 id 运行应用动作、通过宠物说话、添加外观控制并重排侧栏导航（#133182、#136417、#135504、#120912、#120922）。
  • Bot Mode — Bot Screen（见 Highlight 9），默认关闭且需要宿主机软件包（#108914）。群聊可重排房间、压缩成员的隐藏历史（#105909、#117015）。
  • 性能与平台 — 桌面端连接到正在运行的后端，由后端服务所有 profile（#118246）。更快的 Windows 启动；Linux 无需 sudo，并支持 WSLg/Wayland（#111002、#100136、#113247）。会话跟随 agent 的 git worktree 与分支；Review 面板限定工作范围；可浏览 SSH 工作区、把会话拖到项目上、搜索日志、查看并清除 Kanban 阻塞（#128428、#127200、#99538、#126543、#126658、#125647）。

⌨️ CLI, TUI & Dashboard

  • CLI — display.vim_mode、git_branch 状态字段、display.bell_on_prompt（铃声加 OSC 9 通知），全部默认关闭（#106412、#106434、#101284、#101320）。Ctrl+T 打开子代理监控；轮次中途的多行粘贴算一条消息（#105879、#109146）。可脚本化的命令：hermes usage --json（配额，无会话）、hermes worktree --json/--older-than、kanban edit --title/--body/--priority、-t 选择要启动的 MCP 服务器（#115899、#95257、#117632、#101634）。另外：hermes -z 失败时返回非零；-m custom:<name>:<model> 可直达该 provider；页脚不再塌成“Window too small”（#113234、#115293、#117439）。
  • TUI — --native 或 display.tui_native 使用原生终端模式（#121035）。运行中控制：双击 Esc 中断，按住说话会切断朗读，实时 dock（CLI 也有）显示 /goal 与排队的提示（#125803）。输入修复：扩展键终端的 Shift+字母、macOS 的 Ctrl+D、Wayland 图片粘贴、空闲重绘稳定（#90674、#116851、#116824、#87907）。重连的 TUI 会回到自己的会话；attachments.storage: workspace 暂存沙箱内 agent 可读的文件（#112227、#125816）。
  • Dashboard — 更多设备上的聊天：屏幕阅读器、iPad 触控滚动、移动键盘不再重复字符，第二个标签页有自己的终端（#133960、#134181、#116978、#117061）。错误显示一句话加修复按钮而不是原始 JSON，支持标题搜索与实时切换器、按 API 调用分析（#111602、#133981、#134100、#133991）。自托管：反向代理子路径、密码登录与 OAuth 并存、远程会话不过期（#133903、#107018、#110061）。
  • Slash 命令 — 每个选择器都能设推理强度（hermes model、辅助模型、/model），/model X --reasoning high 也可（#110346）。/queue 可编辑：列出、编辑、移动或删除提示；/s 是 /steer 的简写（#95999、#125803）。/context 按文件显示每个指令文件是被加载、截断还是被遮蔽（#91272）。

🔧 Tools, MCP & Browser

  • 工具按需加载 — computer_use、session_search、image_generate、cron 和桌面 GUI 工具默认放在 tool_search 之后（桌面 schema 从 13,367 降到 6,883 token；defer: [] 可退出）；todo/cronjob/process 更名为 todo_list/cronjob_manage/process_manage（保留别名）（#97979）。工具列表每个会话冻结一次，跨 TUI、-q --resume 与网关跳转保持缓存（#120289）。无人值守的网关/cron 会话会硬性停止工具循环；同一工具重复 5 次即停止（#100967）。
  • 文件与网页工具更聪明 — read_file 显示 SQLite 结构并标记合并冲突，search_files 直接跑 ripgrep（快 5–6 倍），无需 Key 的 web_search 会在免费厂商之间故障转移（#115974、#104502、#134048）。
  • MCP — hermes mcp login <server> --flow device 用于无头终端（#104891）。OAuth 更稳：刷新令牌不会被抹除、被重复使用或发给别的签发方；支持 RFC 9207、Google 托管与 WAF 前置的服务器；网关不再打开浏览器标签（#106185、#111186）。更多服务器可连：仅 SSE 的服务器会回退，严格服务器可连（需 sampling.tools），目录新增官方 n8n 与 Asana V2（#106432、#131891、#116048）。启动最多并发 mcp.discovery_concurrency（4）台服务器；视觉模型能看到 MCP 图片；死掉的 stdio 服务器会重启且不重放调用（#117956、#133815、#106546）。
  • 浏览器与 computer use — 密码管理器登录还可填充银行卡与地址（需你确认）；hermes-sandbox:desktop 成为默认镜像（既有沙箱保留）（#106480、#121169）。browser_exec 开箱可用：驱动自带 Chromium（也是云端回退），并通过 sidecar 打开 localhost（#102986）。
  • 终端与代码执行 — 前台超时超过 600 秒的命令转为后台任务，heartbeat=N 发送进度，实时 dock 会列出它们（#103529）。沙箱结果会标记环境是否被重建；SSH 路径按远端解析（#107093、#122657）。LSP 支持 lsp.servers 与 lsp.package_manager；绝不运行克隆仓库自带的解释器或 SDK（#115714、#126239）。
  • 媒体 — 新模型：GPT Image 2.5、Kling Image v3；视频：Kling 3.0、Kling O3、LTX 2.5、Wan 3.0、MiniMax H3 Max Turbo、Gemini Omni Flash 1.1（#105988）。可选 stt.streaming 边说话边显示文字（CLI、TUI、桌面端），长录音在所有云端 provider 上都能转写（#133853、#133825）。可选 voice.voice_chat_mode: gpt-live 给桌面端全双工语音；auxiliary.voice_chat 让口语轮次跑在更快的模型上，TTS 更早开始（#108137、#133986、#115846）。

🧩 Plugins, Skills & the Plugin Catalog

  • 插件目录 — 插件与作者页面：/docs/plugins 把插件分为 Memory、Desktop、Platforms、Web、Tools、Voice、Automation 与 Models。页面显示描述、披露提示、截图、固定提交处的 README、“Open in Hermes Desktop” 按钮和可复制的安装命令（#111415、#111547、#117808）。卡片更易读：版本标签挨着固定提交（1.2.0 @ ad3f352b），带横幅图、统一尺寸与浅色模式（#113381、#125065、#124001）。条目可以声明已知问题，hermes plugins install 与 dashboard 会在安装时显示（#124058）。目录规则：桌面插件必须留在 SDK 槽位内，11 个改动内部实现的插件已被下架（已安装的副本仍可用），提交指南与 CI 实际检查一致（#115579、#130860、#131048）。
  • 目录新增 — 600 个条目全部是本周期新增。移出核心的除了五个记忆 provider，Holographic 有了新的社区维护者，Home Assistant、Spotify、Langfuse 与 TouchDesigner 成为官方目录插件（#114732、#136196、#132476、#137130）。官方新增：Blender Lab、Snyk、NVIDIA App 与 NVIDIA Broadcast（仅 Windows）、Telegram Business、Memory Wiki（#119365、#109084）。分类规模：Memory 65（Cognee、LanceDB、ReMe、Memoria、HydraDB、Mnemosyne、YantrikDB、BetterDB）、Web 与搜索 34（Apify、Parallel、Linkup、SerpApi、You.com、TinyFish、Oxylabs）、模型 provider 48（JetBrains Junie、Telnyx、NetMind、Groq、Chutes、Kiro、Opper、AIHubMix）、平台 32（Inline、Microsoft 365、Rocket.Chat、VK、Zalo、iMessage、Sendblue）、语音 18（Speechify、Deepgram、Fish Audio、Gemini Live）、桌面面板 140、工具 180（#112292、#118231、#118512、#114202）。
  • 插件系统 — 树外模型 provider 会出现在模型选择器里，可通过 hermes auth 登录（内置 OAuth PKCE）并刷新令牌（#116552）。可选的按 profile 插件宿主：plugins.isolation: host 在独立进程中运行第三方插件，且只带该 profile 的秘密（#126911）。新 API：中断轮次、辅助 LLM 调用与人类输入提示的钩子；插件可以启动网关会话、添加 Automation Blueprint 与辅助模型槽、提供 computer-use 驱动、发起 Codex 签名请求（#118909）。桌面插件 SDK：config_schema 设置渲染为 Capabilities → Plugins 里的表单；插件获得技能/工具集/profile 桥接与模型药丸、菜单槽位（#118917）。安装、固定、更新：私有仓库用你的 git 凭据安装，桌面端可把插件固定到某个提交，更新保留用户数据，插件技能以 /plugin:skill 运行（#106981、#107321、#133175）。加载器与扫描器更结实：卡住的导入在 plugins.load_timeout_seconds（10 秒）后被跳过，守卫钩子失败即关闭，正文、测试夹具与正则字面量不再阻断安装（#118915、#115954）。
  • 技能 — 新增可选技能：pr-lens、system-atlas、anatomy、mono-color、dream-loop、scrollcraft、auteur、ip-as-logo、ai-presenter-video、live-dashboard、dynamic-workflow、reddit-reading、rss-feeds（#109306、#103821）。Skills Hub 索引重建，含约 480 个科学技能，搜索也能找到未索引的技能（#109178）。skills.auto_load 让技能进入每个会话，skills.create_dir 决定 agent 创建的技能放在哪（#92048、#100377）。自我改进更好：学习记录与修正写入该任务的技能，后台回顾可以改进任何技能，会话中途添加的技能能到达下一条消息（#102107）。整理器更轻：不再阻塞 CLI 提示，一次安装从 1.9 GB 降到约 200 MB，未使用的技能在 30 天（原 90 天）后归档（#115862）。Skills Guard：421 个技能样本中被拦下的安装从 83 降到 68；内联 shell 仅限非社区技能（#135595）。

⏰ Cron, Kanban & Delegation

  • Cron — 未固定的任务使用触发时配置的模型，pinned 锁定一个（#113679）。自愈排程：没能到达模型的触发会在 5、15、30 分钟后重跑，provider 的 “retry after” 窗口会让任务安静等待，重启期间错过的槽位会补跑一次（#108731、#115843）。更安静的告警：每个事件一次告警，之后按 cron.failure_repeat_alert_hours 提醒；failure_deliver 可改投或静音；agent 可用 [CRON_FAILURE] 主动标记失败（#114807、#101373、#113155）。新选项：--paused 创建未武装的任务，--interpreter 用你自己的 venv 跑脚本（#104984、#125392）。多路复用网关会用每个 profile 自己的环境与秘密运行其任务；投递需要正面证据，输出在各地都做了秘密遮蔽，迟到的或卫星端运行会被标注（#118027、#100908、#112830）。
  • Kanban — worker 能扛过 provider 故障：失败的轮次带上下文原地重试，限流或 5xx 改为重新排队而不是烧掉重试次数（#112318、#112500）。看板会解释自己：失败卡片显示 worker 的最后输出，派发会说明卡片为何被扣住（#112618）。一份工作流定义驱动列；worker 获得 kanban_schedule；kanban create --body-file；桌面端跟随网关切换（#134340、#130455、#116791、#119054）。
  • 委派与多代理 — 实时子代理、图片与 /stop（见 Highlight 11）。扇出丢得更少：失败的子任务立即浮现，owner 崩溃会保住已完成的工作，子任务可以把进程交给父级，逐个任务的完成通知可选（#103549、#116707、#105125）。子任务路由：delegation.fallback_providers 给子任务自己的回退链，child_timeout_seconds 以不活动计时（#105347、#117606）。/goal 在 CLI、桌面端与消息平台上表现一致，裁判会等待子代理，/goal pause for now 不再覆盖目标，闸门在会话工作区里运行（#104833、#132251、#125453）。

🔒 Security, Privacy & Codebase

  • v0.21.6 安全修复 — dashboard 登录加固（伪造的 X-Forwarded-For、尺寸上限、仅回环的登录码）；自动 git 会跳过仓库里的过滤程序；邮件允许名单抵御显示名伪造（#133367、#130685、#130661、#125212）。秘密留在原处：子进程不继承 adapter/dashboard 秘密，远程 execute_code 的令牌不进 argv，profile 导出跳过凭据存储，刷新与回退时 Key 不会流向外部主机（#125755、#124262、#130525、#120299）。遮蔽更锐利：调试分享先遮蔽再截断，文件读取与终端输出会遮蔽 .env/config 秘密，hermes config get 默认遮蔽（--raw 关闭），记忆交接会被清洗（#132270、#111422、#111341、#134429、#100564）。静态文件仅属主可读：凭据、state.db、快照、浏览器 profile、媒体缓存，忽略任何 umask（#109509、#127229）。
  • 更宽的守卫 — 更多请求会经过 SSRF 守卫（security.fake_ip_ranges 用于 fake-ip 代理）；云元数据抓取、zsh/dash 管道进 shell 与 deno eval 需要审批；approvals.deny 在沙箱内也生效；内置规则取代随包的 tirith（#114887、#113156、#116726、#103649、#133832）。已封堵的漏洞：MCP OAuth 回调不再反射 HTML；webhook、SMS 与 WhatsApp Cloud 入站拒绝空的签名密钥（#92612、#133257）。可选共享指标：只有你同意后每日用量统计才会到达 Nous，两个 telemetry.shared_metrics 开关默认关闭，每个 profile 只问一次，回车即“不用了”（#95278）。
  • 代码库与性能 — 每次请求少约 2.1k 提示词 token，vault 工具按需加载，一次往返的文件探测，hermes -w 不再每次启动重新打包（#137084、#101599）。更安全的备份：hermes backup 保留最新 3 份并标记不完整归档；hermes import 拒绝损坏的归档（#106455、#121498）。另外：KEY_2… 环境变量加入凭据池；单屏 hermes status；可选 display.suppress_warning_notifications；桌面端 Bots 名单分区；只使用 Hermes 自己的 node/npm/uv；Xiaomi MiMo v2.6（#112390、#131034、#114370、#101290、#125589、#118502）。
  • 给贡献者 — CODEOWNERS 取代标签闸门；E2E（含原生 Windows）只在发布构建上运行；稳定版默认跳过 macOS Intel/Termux（#131726、#136603）。

🐛 Notable Bug Fixes

  • 引导、连接器与本地模型 — 托管 llama-server 在 Windows 上不再以 0xC0000374 崩溃，也不再继承你的凭据（#116923）；Windows 本地模型服务器被妥善隔离，孤儿进程安全回收；两个后端同时启动只会起一个 router（#111038、#117600）。
  • 安装、更新与打包 — Docker agent 重启后不再丢失内置 API server、消息与 MCP 依赖（#135726）；在 pull 中途被杀的 hermes update 不再破坏所有入口点（#120339）。
  • Provider 与模型 — 被限流的 Claude 模型不再拉黑整个凭据下的其他 Claude 模型（#113171）；Codex app-server 会话现在能拿到 SOUL.md 与 Hermes 系统提示词（#115759）。
  • Agent 循环、会话与记忆 — 会话行被删除的聊天会重建它，而不是静默丢掉落后的每一轮（#124117）；网关关闭时刷出的消息会被恢复进对应会话（#114225）。
  • 完整的修复清单见 release body。

Upgrade

hermes update

托管安装会装上 Python 3.14 运行时。升级后运行 hermes doctor 检查安装，并重启网关（hermes gateway）让平台改动生效。想看下一次更新会动什么，先跑 hermes update --plan。

Full Changelog: v0.21.0…v0.22.0

← Hermes Agent Changelog