跳到主要內容
HERMES DOCUMENTATIONDOCS / CURRENT

Hermes Agent v0.17.0 發佈說明

發佈日期：2026 年 6 月 19 日 官方標籤：v2026.6.19 與上一版對比：v2026.6.5...v2026.6.19

本頁基於官方 GitHub Release 做了結構化中文整理，便於快速瀏覽。

一句話概覽​

官方將本次更新命名為 「The Reach Release（觸達版本）」，核心主題是：

v0.16.0 把 Hermes 帶到桌面端，v0.17.0 則把 Hermes 推到更多入口、更深的工作流和更適合團隊運行的管理面。

重點變化：

  • Hermes 新增 iMessage via Photon：通過 Photon Spectrum 託管線路接入 iMessage，不需要自備 Mac relay 或維護 BlueBubbles 橋接服務。
  • Raft agent network 成為新網關入口：Hermes 可以作為外部 agent 接入 Raft，通過 wake-channel bridge 被喚醒處理消息，喚醒載荷只攜帶事件元數據。
  • 桌面端從預覽走向日常主力：快捷鍵可重綁、原生系統通知、子代理 watch-window、模型選擇器預設、VS Code Marketplace 主題、可調整終端面板、會話草稿和 RTL/bidi 文本方向識別都在本次補強。
  • 後臺子代理正式可用：delegate_task(background=true) 會立即返回 handle，主會話可以繼續推進，子代理結束後再把完整結果帶回當前對話。
  • 圖像工具支持編輯：image_generate 不再只生成新圖，也可以接收已有圖片並執行改色、去背景、草圖轉渲染等 image-to-image 編輯任務。
  • Automation Blueprints 降低定時任務門檻：用戶按模板回答問題即可創建自動化，不再需要記 cron 表達式或手寫 slot=value 參數。
  • xAI Grok 訂閱可觸達 Cursor Composer 模型：grok-composer-2.5-fast 進入 xAI OAuth 模型選擇器，上下文窗口按 200k 對齊。
  • Dashboard 管理能力繼續擴展：瀏覽器裡可以構建完整 profile，選擇模型、技能和 MCP server；多 profile 管理統一到機器級視圖，Skills Hub 也有了預覽、安全掃描和 Featured 區域。
  • memory 工具升級為原子批量操作：新增 operations 數組，能在一次調用中批量 add / replace / remove，並按最終字符預算原子提交，減少多輪寫記憶失敗的概率。
  • 網關入口與消息渲染增強：新增官方 WhatsApp Business Cloud API adapter，Telegram 默認使用 Bot API 10.1 富文本消息，SimpleX、Discord、Slack、Matrix、QQBot、微信等平臺也有可靠性修復。
  • 安全、部署和 Windows 修復同步落地：包括 Dashboard 登錄硬化、審批按鈕 fail-closed、敏感信息脫敏、MCP 可疑 stdio 配置攔截、cron 子進程環境清洗、urllib3 / PyJWT CVE 更新，以及 Windows 安裝、更新和 ConPTY 相關修復。

規模數據（自 v0.16.0 起）：約 1,475 次提交 · 約 800 個合併 PR · 1,693 個文件變更 · 235,390 行新增 · 50,730 行刪除 · 300+ 個 issue 關閉 · 245 位社區貢獻者。

我應該升級嗎？​

如果你屬於以下任一場景，建議優先升級 v0.17.0：

  1. 你依賴桌面端作為主入口 —— v0.17.0 對桌面端的交互、通知、主題、遠程 Gateway、多窗口、終端和子代理觀察體驗都做了大幅補強。
  2. 你希望 Hermes 出現在更多消息渠道 —— iMessage via Photon、Raft、WhatsApp Business Cloud API、SimpleX 與 Telegram 富文本都屬於明顯擴面。
  3. 你經常把長任務拆給子代理 —— 後臺子代理可以避免主會話被長任務阻塞，適合研究、構建、巡檢、資料整理和多步驟執行。
  4. 你用 Dashboard 管理自託管或團隊環境 —— Profile Builder、多 profile 管理、Skills Hub 預覽與安全掃描會降低配置、排錯和推廣成本。
  5. 你重度使用長期記憶或技能庫 —— memory 原子批量操作和 Curator 默認零輔助模型成本，會讓長期運行更穩、更省。
  6. 你需要圖像編輯類工具鏈 —— image_generate 現在可以直接編輯已有圖片，很多簡單視覺修圖任務不必再換工具。
  7. 你關注生產環境安全默認值 —— Dashboard OAuth、審批按鈕、MCP 配置、cron 子進程、調試日誌和依賴 CVE 都有修復，暴露到網絡或多人使用的實例尤其值得升級。
  8. 你運行 Windows 或遠程 Gateway —— v0.17.0 包含 Windows 安裝更新、ConPTY、PATH、venv 鎖文件、遠程媒體和遠程後端更新相關修復。

升級前仍建議備份 SOUL.md、MEMORY.md、skills/、Gateway 配置、profile 配置和長期會話數據。自託管 Dashboard、遠程 Gateway、多 profile、消息平臺、MCP、Docker / Nix、Windows 原生安裝用戶尤其建議先在一臺實例上驗證再推廣。

重點亮點​

iMessage via Photon 與 Raft：Hermes 觸達更多入口​

v0.17.0 新增 iMessage platform plugin，基於 Photon Spectrum 的託管線路池接入。用戶可以運行 hermes photon login，按 device code 完成認證後收發 iMessage，不再需要把一臺 Mac 留在角落跑 relay，也不需要維護 BlueBubbles bridge。

Raft 則把 Hermes 接入 agent network。新的 bundled Raft platform adapter 讓 Hermes 通過 wake-channel bridge 作為外部 agent 響應事件。官方特別強調 wake payload 只攜帶事件 ID、時間戳等元數據，不攜帶消息正文，這讓 Hermes 可以在新的協作網絡裡出現，同時保留較清晰的隱私邊界。

主要 PR：#32348、#42582、#44713、#48210。

Hermes Desktop：從“能用”走向“日常主力”​

v0.16.0 的主角是桌面端首發，v0.17.0 的主線則是把桌面端打磨到更適合長期使用。用戶現在可以重綁快捷鍵，按通知類型控制原生系統通知，給子代理打開獨立 watch-window 觀察執行過程，在 composer 裡選擇模型和預設，安裝任意 VS Code Marketplace 主題，並使用可調整大小的 VS Code 風格終端面板。

桌面端也補齊了不少真實工作流細節：每個 thread 可以保存 composer 草稿，聊天內容能自動識別 RTL / bidi 文本方向，Mac 風格 session switcher、worktree-aware 側邊欄分組、hover-reveal 摺疊側欄、消息來源文件夾、流式輸出跟隨底部、jump-to-bottom 按鈕和一等公民的 cron 側邊欄都在本次更新裡出現。

遠程 Gateway 體驗也更完整。遠程媒體 relay 讓用戶可以通過遠程連接附加圖片和 PDF，並顯示 agent 寫出的圖片；桌面端增加客戶端 / 後端版本按鈕、遠程後端更新流程、遠程文件瀏覽，以及睡眠喚醒後重新校驗後端來恢復聊天的邏輯。

主要 PR：#45866、#40660、#47060、#46959、#43292、#44596、#41336、#42634。

後臺子代理：長任務不再卡住主會話​

delegate_task(background=true) 是這次最實用的 agent loop 變化之一。過去把研究、構建、巡檢這類長任務交給子代理時，主會話往往需要等待結果；現在 Hermes 會立即返回一個 handle，主會話繼續工作，後臺子代理完成後再把完整結果作為新 turn 帶回對話。

這個能力適合需要一邊推進主任務、一邊讓子代理跑深度搜索、代碼審查、日誌分析、資料整理或環境驗證的場景。桌面端 watch-window 的加入，也讓用戶能更自然地觀察被委派出去的代理到底在做什麼。

主要 PR：#40946、#46968。

Dashboard：Profile Builder、Skills Hub 與安全登錄​

Dashboard 本次繼續向“瀏覽器裡的完整管理面板”演進。Profile Builder 可以在網頁中完成模型、技能和 MCP server 的組合，不必手工編輯 config.yaml；多 profile 管理被統一到機器級視圖，並提供全局 profile switcher、profile-scoped skills / toolsets 和 Chat tab 上的 session switcher。

Skills Hub 也做了重構。Dashboard 現在支持 connected hubs、Featured 區域、安裝前完整預覽和技能安全掃描，可信 tap 中的 OpenAI、Anthropic、HuggingFace、NVIDIA 等來源不再只是扁平列表，而是更像一個可瀏覽、可評估的技能市場。

安全側，Dashboard OAuth gate 後的 token-required endpoint 會正確返回 401，WebSocket 認證使用實際提供的 Dashboard token，並會在 public_url override 被拒絕時給出警告。對需要把 Dashboard 暴露到局域網或公網的用戶來說，這是一次重要硬化。

主要 PR：#39084、#44007、#40384、#43398、#42578、#43214。

圖像編輯、記憶批量操作與文件讀取增強​

image_generate 現在支持 image-to-image 編輯。用戶可以把已有圖片連同提示詞傳給工具，讓 Hermes 完成改色、去背景、草圖轉渲染等任務；實現上會路由到後端的 edit endpoint，並覆蓋所有受支持的圖像 provider。

memory 工具新增原子批量操作也很關鍵。過去模型可能需要先刪除舊記憶再添加新記憶，中間任何一步失敗都會導致狀態不完整；現在 operations 數組可以在一次調用裡同時 add / replace / remove，並按最終字符預算整體提交。長期運行的 Hermes 更容易把記憶壓縮、更新和新增放在一次可靠操作中完成。

另外，search_files 做了 lossless densification，用更少 token 保留同樣的匹配結果；read_file 可以把 .ipynb、.docx、.xlsx 抽取成文本；上下文文件支持可配置截斷上限和警告，壓縮摘要也加入時間錨點。

主要 PR：#48705、#48507、#47866、#37082、#47251、#41102。

模型與 provider：xAI Composer、GLM 5.2 與更穩的模型目錄​

xAI OAuth 模型選擇器新增 grok-composer-2.5-fast，官方把它描述為 Cursor 背後的快速 coding model，並將上下文窗口對齊到 200k。對已經有 xAI Grok 訂閱的用戶來說，這是不額外準備 API Key 就把 Composer 能力接入 Hermes agent loop 的路徑。

模型目錄方面，本次還加入或補齊 z-ai/glm-5.2、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra 等條目，並把 MiniMax-M3 的 1M 上下文信息修正為真實窗口。模型選擇器新增 Refresh-Models 控件，可以繞過陳舊緩存；Nous 推薦模型會落盤，並在 Portal 不可用時回退。

主要 PR：#47908、#47371、#47391、#45695、#48691、#43338。

Automation、Fleet 與 Gateway Relay：團隊運行能力繼續補齊​

Automation Blueprints 讓用戶按模板創建自動化。一個 blueprint definition 可以同時出現在 Dashboard 表單、CLI / TUI / 消息平臺 slash command、agent 對話和文檔目錄中。用戶選擇模板後回答必要問題即可，不必手寫 cron 表達式。

Fleet 側新增 managed scope，允許管理員把用戶不可變的配置和 secrets 固定在 root-owned /etc/hermes 下。多 profile 也可以 opt-in 複用一個 gateway 進程。CronScheduler 變為可插拔，並出現 Chronos managed-cron provider，面向 scale-to-zero 的託管運行方式。

Gateway-Gateway relay 推進到多個階段，包含 relay adapter、capability descriptor、connector 與 gateway 間的 channel auth、signed HTTP inbound、enroll CLI、WS-only inbound 和 managed boot self-provision client。這些變化對團隊部署、託管環境和跨 Gateway 連接更重要。

主要 PR：#41309、#49098、#48273、#48275、#48078、#48147、#48294。

消息平臺：WhatsApp Cloud API、Telegram 富文本與多平臺修復​

除了 iMessage 和 Raft，本次還新增官方 WhatsApp Business Cloud API adapter。它與現有 Baileys bridge 並存，適合希望走 Meta 官方託管路徑、減少橋接進程和掃碼維護成本的用戶。

Telegram 現在默認使用 Bot API 10.1 rich messages，長消息、格式化和原生 markup 的表現更接近用戶預期，同時保留 opt-out。SimpleX 支持 groups、native attachments、text batching 和 auto-accept。Discord、Slack、Signal、Email、Teams、Matrix、QQBot、微信等平臺也有授權、附件、線程、CPU 佔用和限流相關修復。

主要 PR：#44331、#43921、#44829、#45584、#45953、#42584。

安全、可靠性與 Windows​

安全修復集中在默認失敗方式和敏感信息邊界上。v0.17.0 會在自定義 policy gateway adapter、Slack / 飛書 / Discord 審批按鈕缺少 allowlist 時 fail-closed；調試請求 dump 會脫敏 secrets；公共 status 會隱藏 host metadata；MCP stdio 配置在 probe 前會攔截疑似外傳形態；shell-escape denylist 繞過、缺失 approval module、cua-driver MCP 啟動環境、cron job-script 子進程環境和 TodoStore 內容邊界也有補丁。

依賴側升級 urllib3 和 PyJWT 以清理 CVE；Langfuse 對 base64 data URI 的處理改為脫敏而不是截斷成無效 base64。Windows 側則補齊 Dashboard /chat tab 的 ConPTY 支持、PowerShell 路徑解析、winget 註冊修復、PATH 合併、venv 重建時 _bcrypt.pyd 鎖釋放、註冊表讀取 HERMES_HOME、hermes.exe 更新隔離、JOB-breakaway watcher 和原生 confirm modal。

主要 PR：#45634、#41226、#46637、#46083、#40591、#49207、#40179、#42251、#44084。

其他值得注意的變化​

  • cli.py、gateway/run.py 和 run_agent.py 繼續拆分“巨型文件”，把 subcommand parser、slash command handler、授權邏輯、Kanban watcher 和 turn loop 狀態抽出到更清晰的模塊。
  • CLI / TUI 新增 /version slash command、交互式 /billing、狀態欄展示距離上一條最終回覆的時間、profile alias 展示、從任意來源 clone profile、TUI 插件 Hub overlay 和更好的審批 / clarify / sudo / secret modal。
  • TTS 支持 Gemini persona prompts、xAI 自動 speech tags、speed / streaming knobs、Piper speaker_id，以及 Telegram auto-TTS 的 OGG 輸出。
  • MCP catalog 新增官方 Unreal Engine 5.8 MCP server，並支持 MCP elicitation、late-connecting tools、HTTP keepalive、prompt-only server capability gate 和 Windows 環境變量保留。
  • Skills 側新增 simplify-code，支持三代理並行 code review 與清理；也支持查找 / diff 用戶修改過的 bundled skills、可選支付技能、CLI shop skill 和 per-source browse progress。
  • Curator 默認繼續 prune stale skills，但 LLM consolidation 改為 opt-in，日常後臺整理不再消耗輔助模型 token。
  • Docker / Nix / Installer 修復集中在鏡像體積、supervised gateway、s6 supervisor 檢測、npm lock、Electron 依賴 hash、autostash 前清理 unmerged git index 和安裝方式 stamp 範圍。
  • 本窗口有兩個變更被回滾，html-artifact skill 摺疊方案和 cron per-job profile support 不在 v0.17.0 中交付。

升級建議​

常規升級仍然使用：

hermes update

如果你使用包管理器、Docker、Nix 或 Windows 原生安裝，請按對應安裝方式升級到當前穩定版。升級前建議先確認當前安裝路徑、Git remote、Dashboard 登錄方式、Gateway 暴露方式、消息平臺憑據、MCP 配置和長期記憶路徑。

升級後建議做五件事：

  1. 運行 hermes --version，確認版本已經到 v0.17.0。
  2. 打開 Dashboard，檢查 profile builder、模型選擇、Skills Hub、MCP 和登錄狀態是否正常。
  3. 如果使用桌面端，測試本地會話、遠程 Gateway、子代理 watch-window、模型選擇器和系統通知。
  4. 如果使用消息平臺，至少驗證一個常用入口，例如 Telegram、WhatsApp、iMessage via Photon、Discord 或 Slack。
  5. 如果使用長期記憶，觀察一次 memory 寫入或替換流程，確認升級後仍符合你的記憶治理預期。

參考鏈接​