Hermes Agent v0.17.0 (v2026.6.19) — The Reach Release

Hermes Agent v0.17.0 (v2026.6.19) — The Reach Release

发布日：2026-06-19 | 版本：v0.17.0 | 间隔：v2026.6.5 → v2026.6.19（14 天）

规模：~1,475 commits · ~800 merged PRs · 1,693 files changed · +235,390 / -50,730 行 · 300+ issues closed · 245 社区贡献者

🔥 核心亮点

1. iMessage 接入（Photon Spectrum）— 无需 Mac 中继

hermes photon login 即可通过 Photon 的托管线路池收发 iMessage，告别 BlueBubbles 桥接方案。free to start，无需自托管。

PR: #32348 #42582 #44713

2. Raft Agent 网络接入

Hermes 可作为外部 Agent 接入 Raft 网络，通过 wake-channel bridge 唤醒。隐私合约设计：唤醒载荷只含元数据（event IDs, timestamps），不传消息体。

PR: #48210

3. Desktop 桌面应用深度成熟

  • 可重绑定快捷键面板、原生 OS 通知 + 按类型开关
  • Subagent watch-windows：委托 agent 的实时活动流显示在独立面板
  • Composer 模型选择器 + per-model 预设
  • 安装任意 VS Code Marketplace 主题、自动 RTL/bidi 文本方向
  • 可调整大小的 VS Code 风格终端面板
  • 每线程 Composer 草稿、Mac 式会话切换器（^Tab / ^1-9）
  • Desktop pets 弹出式叠加通知

PR: #45866 #40660 #47060 #46959 #43292 #44596 / #47938

4. Background Subagents — 委托任务不阻塞

delegate_task(background=true) 后台派发 subagent，返回立即 Handle，完成后自动插入新 Turn 到对话。边等边干别的。

PR: #40946 #46968

5. Image-to-Image 编辑能力

image_generate 现支持编辑/变换已有图片（Make blue / 去背景 / 草图→渲染），所有后端统一路由到 edit endpoint。

PR: #48705

6. Automation Blueprints — 无需学 cron

按名选自动化，填几个问题就配置好——Dashboard 表单 / CLI 斜杠 / 对话 / 文档目录全端一致。

PR: #41309

7. Cursor Composer 模型接入 xAI Grok 订阅

grok-composer-2.5-fast 进入 xAI OAuth 选择器（200K 上下文），xAI Grok 订阅用户可直接使用，无需额外 API Key。

PR: #47908 #6f89e17

8. Dashboard Profile Builder + Skills Hub 重做

  • 浏览器内完整 Profile 构建（模型/技能/MCP），免编辑 config.yaml
  • Skills Hub 全新浏览体验：连接 hub / Featured / 安装前预览 + 安全扫描
  • Dashboard 认证加固：token 端点正确返回 401、websocket auth 用 serve token

PR: #39084 #44007 / #40384 / #42578

9. memory 工具批量原子操作

新 operations 数组：一次调用内批量 add/replace/remove，原子性对标 char budget。不再需要多轮博弈释放空间后再写。

PR: #48507

10. Curator 成本优化

Skill 汰换默认保持执行（无消耗），但 LLM consolidation 行为改为 opt-in（curator.consolidate: true），日常后台 curation 零 token 消耗。

PR: #47840

11. WhatsApp Business Cloud API 官方适配器

Meta 第一方渠道，无桥接进程，直接指向 Business API 凭据即可收发 WhatsApp。

PR: #44331 #43921

12. Telegram Bot API 10.1 富文本消息

默认启用（可 opt-out），原生富文本渲染取代扁平文本。更好的格式化、长消息处理、原生标记。

PR: #44829 #45584

🏗️ Core Agent & Architecture

God-file 重构

  • cli.py main() 3297 → 954 行：28 个子命令解析器提取到 hermes_cli/subcommands/，32 个斜杠处理器 → CLICommandsMixin
  • gateway/run.py 19157 → 15870 行：42 个斜杠处理器 → GatewaySlashCommandsMixin，认证集群 → GatewayAuthorizationMixin
  • run_agent.py turn loop：Prologue → TurnContext，tail → finalize_turn，retry flags → TurnRetryState

Provider & 模型

  • 新模型：z-ai/glm-5.2（1M 上下文）、claude-fable-5、laguna-m.1 + nemotron-3-ultra、xAI Composer 2.5
  • 模型选择器：Refresh-Models 缓存刷新、持久推荐模型到磁盘、MiniMax-M3 真实 1M 上下文
  • Anthropic 自适应模型：默认 modern thinking contract
  • Auth：自动检测 OpenRouter 凭据池、Codex OAuth 独立账户、xAI OAuth 跨 Profile 解析
  • Bedrock 降级到非流式 InvokeModel 当 IAM 拒接流式

会话 & 多 Agent

  • 可选最大会话上限、ACP 会话来源元数据
  • 自定义 endpoint subagent 池、默认 wall-clock timeout 移除
  • Kanban：config-gated 自动订阅、全局单例锁、worker 存活期 hold reclaim
  • Memory：Hindsight retain scope、OpenViking、Supermemory 会话级

📱 消息平台

  • 新通道：iMessage（Photon）、WhatsApp Business（官方）、SimpleX、Raft
  • Gateway 渲染：终端工具调用显示为 bash code block、裸 fenced code block、可选 LLM 时间戳
  • Telegram：Bot API 10.1 富文本（always-on）、Online/Offline 状态指示器、超大语音预检
  • Discord：role_authorized 传播、Gateway 任务退出恢复
  • Slack：reply_in_thread=false scope、thread 审批 UX、video attachment 可用
  • 其他：被回复消息的附件纳入、WhatsApp 桥接进程重启、Matrix room 上下文隔离、QQbot CPU-spin 修復、Weixin rate-limit circuit breaker

🖥️ CLI / TUI / Setup

  • /version 斜杠命令、/billing 交互式终端账单
  • 状态栏显示上次 agent 回复的经过时间
  • Worktree 锁定防并发冲突、Profile alias
  • TUI：Plugins Hub 交互式启用/禁用、session 名称显示在 terminal titlebar
  • TTS：Gemini 人声提示、xAI 自动语音标签、Piper speaker_id、Telegram OGG 自动 TTS

🔧 Tool System, Skills & MCP

  • image-to-image 编辑：所有后端统一
  • MCP：官方 Unreal Engine 5.8 服务器、elicitation handler（支付/OAuth 确认）、late-connecting MCP tools 暴露、keepalive ping、可疑 stdio 预检、capability-gate tools/list
  • Skills：simplify-code skill（并行 3 Agent 代码审查）、payments skills（Stripe Link / MPP）、CLI shop skill
  • Plugins：支持子目录安装、GitHub URL 粘贴安装、session:compress 生命周期事件
  • Memory write approval：bool write_approval 替代三态 write_mode

🌐 Fleet, Relay & 自动化

  • Managed Scope：root-owned /etc/hermes 管理员锁定的不可变配置
  • 多 Profile 复用单 Gateway（opt-in）
  • Pluggable CronScheduler + Chronos managed-cron（scale-to-zero）
  • Gateway-Gateway relay（Phase 0-3）：relay adapter + WS-only inbound + managed-boot 自推

🐳 Docker / Nix / 安装器

  • s6 检测 supervisor 直接 gateway restart、注册 profile gateway 不自动启动、持久 desired state
  • Docker：镜像优化（.dockerignore / 去 dev deps / 分层）、预安装 matrix deps、supervised gateway 使用 --replace
  • Nix：cold npm build 修复、hashless npm deps via importNpmLock、Electron 40.10.2
  • 安装器：clear unmerged git index 在 autostash 前、scope install-method stamp

🔒 安全

  • Fail closed：own-policy gateway、Slack/Feishu/Discord 审批按钮无 allowlist
  • Secrets 在 request debug dump 中 redact、host metadata withhold
  • Shell-escape denylist bypass 关闭、operator env scrubbing for cua-driver MCP
  • Cron job-script subprocess env sanitization、TodoStore length/count bound
  • urllib3 / PyJWT CVE 升级、Langfuse base64 data URI redact 修复

🪟 Windows

  • Dashboard /chat tab via ConPTY（win_pty_bridge）
  • PowerShell host 绝对路径解析、stale winget 修复、HERMES_HOME 注册表读取
  • Quarantine 运行中 hermes.exe 时更新修复

🧠 对我方环境的影响评估

变更点影响说明
memory 批量原子操作✅ 利好我们频繁使用 memory 工具，batch ops 减少记忆写入失败
Telegram Bot API 10.1 富文本✅ 利好我们主力 Telegram 通道，富文本提升阅读体验
Curator 成本优化✅ 利好零 token 日常 curation，减少辅助消耗
Gateway-Gateway relay⏸ 待评估多实例互通可能性，需明确需求
God-file 重构🟡 无感行为不变，未来插件开发更友好
Docker 镜像优化✅ 利好镜像更小，预装 matrix deps 减少启动时间
Managed Scope（/etc/hermes）🟡 无感企业场景功能，单实例/单用户无需配置
s6 persistence✅ 利好gateway 状态持久化，容器重启更稳定
WhatsApp Business API🟡 选项非核心平台，Baileys 已满足需求
Desktop 应用成熟🟡 参考我们纯 Docker 部署，desktop 功能供管理参考
Multi-profile 单 Gateway⏸ 待评估我们多实例独立运行，合并的可行性需分析
background subagents✅ 利好可用于长耗时任务并行执行

特别关注：Telegram Bot API 10.1 富文本默认启用，更新后检查我们的消息格式是否正常。Docker 镜像优化和 s6 持久化对容器稳定性有正面影响。

完整更新日志：v2026.6.5...v2026.6.19