🐛 精選 Issue
上游重要 issue 的中文摘要與追蹤
Hermes Agent 官方 Issue Top 10：最多人反應的問題與提案
依官方 GitHub reactions 數排序的前 10 名 issue 中文摘要：最多人遇到的 bug 與最多人想要的功能，每筆附原始連結與狀態。
[Bug] 使用 MiniMax M2.7 時持續出現 HTTP 529「伺服器叢集負載過高」錯誤
使用者回報透過 Hermes 呼叫 MiniMax M2.7（api.minimax.io/anthropic 端點）時，即使是中等使用量與短提示，也反覆收到 HTTP 529 Overloaded 錯誤，Hermes 內建的重試機制持續打到同樣的 529 錯誤，嚴重影響可用性，詢問這是否為 MiniMax 端的容量或
Bug：已設定 OPENROUTER_API_KEY，卻仍收到「未設定 auxiliary LLM provider」警告
回報者在 .hermes/.env 中已設定 OPENROUTER API KEY，但執行 hermes 時仍收到「未設定 auxiliary LLM provider」的警告訊息（並附上截圖）。重現步驟是先用 hermes setup 把 model 設為 arcee ai/trinity large preview
Issue 標題與內容皆僅為一個句點，未提供實質資訊
此 issue 的標題與內容皆只有一個句點，未提供任何具體問題描述。此 issue 已關閉。
功能請求：原生 Windows 支援（不透過 WSL2）
使用者希望 Hermes Agent 提供原生 Windows 支援，而非透過 WSL2 執行。此 issue 被標記為重複（duplicate）。
[功能] Telegram 主題（Topic）分流：依論壇主題/討論串將訊息路由到不同 profile
使用者提出功能需求，希望單一 Telegram bot 能依照論壇主題（topic/thread）將訊息分派給不同的 Hermes profile，讓每個主題可由擁有各自模型、skills、記憶與系統提示詞的專屬 agent 處理，取代目前需要為每個 profile 各自跑一個 bot token 與 gateway
[Feature] 為 hermes-agent 提供 Homebrew formula
回報者希望能用 Homebrew 安裝 hermes agent，但官方 homebrew core repo 裡沒有對應的 formula，因此自行建立了一份並提交到 Homebrew/homebrew core 的 PR，於此 issue 中請求關注與支援。此 issue 已關閉。
抄袭都抄不明白
抄袭别人的项目就标注清楚，难怪用起来半桶水的感觉。唉，毕竟不是自己写的东西。
[Bug] 設定 OpenRouter / Nvidia 自訂模型後，hermes chat 出現 BadRequestError（API 呼叫失敗）
使用者回報將 hermes 設定為透過 OpenRouter 使用自訂模型（如 minimax m2.5）後，執行 hermes chat 時 API 呼叫失敗，出現 400 BadRequestError，且判定為不可重試的用戶端錯誤。此 issue 已關閉，狀態為已修復。
功能請求：為 hermes dashboard 新增 --host 與 CORS 設定以支援 Tailscale/VPN 存取
hermes dashboard 預設綁定在 127.0.0.1:9119，且程式碼中 CORS 的 allow origin regex 寫死只允許 localhost/127.0.0.1，即使加上 host 0.0.0.0 讓前端能載入，後端 API 呼叫仍會被 CORS 擋下，導致無法透過 Tailscale 等
[設定問題] 使用 Copilot 服務商時出現 APIConnectionError（API 呼叫失敗）
使用者在 MacBook M5、python3 3.9.6 環境下，用 hermes setup 設定好 Copilot 服務商後，於 hermes chat 中對話時反覆出現 APIConnectionError，重試 3 次後仍連線失敗。此 issue 已關閉，狀態為已修復。
[Bug] 當終端 response.output 為 null 時，Responses 串流會崩潰
當某個 OpenAI 相容 provider 傳回有效的串流事件、但最終 response.completed 的 response.output 是 null 而非空陣列時，Hermes 既有針對空陣列的復原邏輯無法涵蓋這種情況，stream.get final response() 會在 Hermes 能補回串流輸
建議在 auxiliary_client.py 新增 MiniMax 作為 vision backend 支援
設定 AUXILIARY VISION PROVIDER=minimax 時，vision analyze 工具會靜默失敗，因為 resolve strict vision backend() 沒有處理 MiniMax 的分支，回報者指出 MiniMax 有提供如 MiniMax VL 之類的多模態端點可以串接。此 i
[功能討論] 自我改進 agent 的「憑據追溯」：如何證明是哪個版本的 skill 產生了哪個輸出
使用者以討論形式提出治理層面的問題：Hermes 具備從經驗中自動產生與改進 skill 的自我修改能力，但這也代表一個 skill 的「哪個版本」在何時執行、產生了什麼輸出，缺乏可追溯的憑據。作者提出三個具體的溯源問題，例如某個 skill 在早上被建立、下午被改進後，之後執行時究竟是哪個版本產生的結果。此 issu
[Feature] 新增 Brave Search 作為原生網頁搜尋後端
此 issue 提議把 Brave Search API 加入 hermes agent，成為與現有 Firecrawl、Parallel、Tavily、Exa 並列的第一級網頁搜尋後端，理由是 Brave Search 有較大方的免費試用額度、文件完整的 REST API、支援網頁搜尋 / 自動建議 / 帶引用的 A
[Bug] Kimi 服務商（kimi-for-coding）因 temperature 參數不符導致 HTTP 400，需要支援每個模型自訂 temperature
使用 Kimi 服務商的 kimi for coding 模型時，因為該模型強制要求 temperature 必須為 0.6，但 Hermes 目前沒有提供針對特定服務商或模型覆寫 temperature 的設定，導致所有 API 呼叫都收到 HTTP 400 錯誤。使用者建議新增可依服務商/模型調整 temperat
功能請求：原生行動 App（iOS 與 Android）搭配語音通話
這個 issue 希望官方推出支援語音通話的 iOS 與 Android 原生 App，讓使用者能像講電話一樣即時與 Hermes AI 助理對話，並涵蓋文字聊天、推播通知等功能。
[Bug] OpenAI Codex OAuth 在 CLI 可正常登入，但 Telegram gateway 回報「未儲存 Codex 憑證」
回報者在 Docker/Coolify 部署環境下，CLI 使用 openai codex provider 可正常運作且 hermes status 顯示已登入，但透過 Telegram gateway 使用同一組憑證時卻收到「No Codex credentials stored」的錯誤。此 issue 已關閉。
[功能] 新增元寶（Yuanbao）作為新的 gateway 平台
使用者提出功能需求，希望 Hermes 新增支援騰訊的 AI 原生社群平台「元寶」（Yuanbao），其「派」群組聊天功能可讓機器人即時與使用者互動；目前 Hermes 已支援 Telegram、Discord、Slack、WhatsApp 及部分中國企業平台（釘釘、企業微信、微信），但尚未支援元寶這類基於 WebSo
[Feature] 為 Agent 資料（~/.hermes/）內建自動備份與版本控制
此 issue 提議為 Hermes 儲存在 ~/.hermes/ 的所有 agent 資料（記憶、skill、對話紀錄、輸出）內建自動備份機制與版本控制，避免使用者因硬碟故障等問題遺失 agent 累積學到的狀態，目前使用者只能自行架 cron job 或第三方工具。提案包含新增 hermes backup CLI
功能請求：提供不含 Playwright/Chromium 的輕量版 Docker image
這個 issue 指出官方 Docker image 約 2.4GB，大部分容量來自 Playwright、Chromium 與 Node.js 等瀏覽器自動化相依套件，但許多只需要 CLI 聊天或 gateway 模式的使用者其實用不到這些功能。提案額外發布一個排除瀏覽器相依套件的 slim 版 image tag。
[Bug] 全新 Matrix 環境設定完成後，bot 收不到任何訊息（sync 停滯）
使用者在更新到最新版本後，於全新的 Debian 環境設定 Matrix bot，bot 能成功加入房間，但在關閉加密的情況下依然完全收不到或處理不了任何訊息，debug 模式下也沒有任何 inbound event 的 log，懷疑 sync 迴圈在約 30 秒後停滯或斷線。此 issue 已關閉，狀態為已修復。
功能請求：支援原生 Google / Vertex AI provider（繞過 OpenRouter 402 錯誤與速率限制）
使用者反映透過 OpenRouter 使用 google/gemini 3.1 pro preview 模型時常遇到 HTTP 402 額度不足與速率限制錯誤，即使自己有足夠的 Google Cloud 帳單額度也無法繞過。提案在 config.yaml 直接支援原生 google 或 vertex ai provid
功能提案：為具視覺能力的主模型提供原生 Vision 支援，附參考實作與相關 bug 發現
提案指出 Hermes 目前所有影像分析都會繞道經過輔助視覺模型（如 qwen3 vl），即使主模型本身具備原生視覺能力（如 gpt 4o、glm 5v turbo、claude sonnet 4）也是如此，造成額外延遲、成本與資訊流失；回報者提供了一套修改 4 個檔案的原生 vision bypass 參考實作，並在
功能請求：簡化新增 OpenCode Go 等自訂模型到 Hermes Agent 的方式
目前要把 OpenCode Go 這類新模型串進 Hermes Agent，沒有明確或簡單的擴充機制，開發者必須深入內部程式碼才能實驗替代的 LLM provider 或自架推論服務。此 issue 提議建立設定式（YAML/JSON）的模型註冊機制與標準化 adapter 介面。
功能請求：原生支援 Google Cloud Vertex AI provider
Hermes 目前沒有可用的 Google Cloud Vertex AI 整合路徑，設定 google vertex provider 時因缺少 OAuth 驗證機制而在每次 cron 執行時靜默失敗。回報者提到自己寫了一個 standalone proxy 處理服務帳號驗證與 token 更新，並透過現有 cust
在官方 Codex CLI 仍可正常運作的同一台機器/網路上，Hermes 的 openai-codex 服務商卻失敗
使用者回報在同一台 macOS 機器與同一個網路環境下，官方 codex CLI 用 ChatGPT 登入仍可正常完成回應，但 Hermes 設定為 openai codex 服務商時卻反覆出現 APIConnectionError / APITimeoutError，最終顯示連線錯誤，顯示 Hermes 的 open
非常稳定的api中转站 可以尝试下
api中转 gpt/gemini/opus/haiku/sonnet 比例0.9:1 需要的来 不暗改倍率，稳定稳定稳定！Qu20180888
Hermes agent 無法根據先前的對話內容準確回答問題
使用者回報使用 hermes chat 搭配 ollama 自訂端點與 gemma4:e4b 本地模型時，agent 無法記住並根據先前對話（例如使用者告知的名字）回答後續問題，對話紀錄顯示前後回答不一致且答非所問。此 issue 已關閉，狀態為已修復。
功能提案：多 Agent 共用 Discord 頻道協作（訊息歷史注入 + 防止連鎖回覆）
使用者在同一個 Discord 頻道跑 3 個各自獨立的 Hermes agent 實例，遇到 agent 之間看不到彼此訊息、且容易觸發連鎖回覆的問題。issue 分享了作者自行實作的頻道歷史注入與連鎖回覆防止（mention gating）解法，希望能貢獻回上游專案。
[Bug] Claude Max 20x 訂閱搭配有效 OAuth token 呼叫原生 Anthropic API 時全部回傳 HTTP 400
使用者持有 Claude Max 20x 訂閱，並使用 ~/.claude/.credentials.json 中有效的 OAuth access token，但透過 Hermes 呼叫原生 Anthropic API（provider: anthropic）時，每個請求都收到 HTTP 400 錯誤，訊息顯示「額外用
[功能] 為訊息平台新增通用的動作按鈕 / 內嵌鍵盤支援
使用者提出功能需求，希望 Hermes 能有一套通用、跨平台的方式讓訊息附加互動式動作按鈕（尤其是 Telegram 的 inline keyboard），而不是針對特定功能（如模型選擇、指令核准）各自寫死邏輯，讓 agent 產生的訊息或排程訊息都能附上「是/否」「部署/取消」等按鈕選項。此 issue 為開放狀態，
feat(browser)：新增 Obscura 作為瀏覽器 provider（用 Rust 打造、支援 CDP 的無頭瀏覽器）
此 issue 提議把 Obscura（開源、Rust 撰寫、專為 AI agent 自動化與網頁爬取設計的無頭瀏覽器引擎）加入 Hermes 作為瀏覽器 provider。Obscura 提供完整的 Chrome DevTools Protocol（CDP）WebSocket 伺服器，可相容 Puppeteer /
google-workspace skill：新增多帳號支援
productivity/google workspace skill 目前設計為單一帳號，OAuth 設定只會寫入固定路徑的 token 檔案，導致同時有個人與公司 Google Workspace 帳號的使用者只能透過 Hermes 存取其中一個帳號。回報者提議加入 account 參數與每帳號獨立的 token
功能請求：使用者可自訂的多模型路由（能力分類 + 評估回饋）
此 issue 提議讓使用者能把多個 LLM 分配到不同能力分類（如速度、智慧程度、不受限、低成本、高度推理），讓工具依宣告的需求動態選擇模型，而非固定使用單一開發者指定的模型，並可選擇性地用評估指標隨時間優化模型選擇。此 issue 已關閉。
[Bug] DeepSeek API 出現 400 錯誤：思考模式下的 reasoning_content 必須被送回 API
使用者回報搭配支援思考模式的 DeepSeek 模型（如 deepseek v4 flash）時，Hermes 出現 HTTP 400 錯誤，訊息指出思考模式下的 reasoning content 必須在後續請求中送回 API，但 Hermes 目前並未正確處理並回傳先前的 reasoning content。此 i
[Bug] google-gemini-cli 服務商觸發 429 錯誤，但 gquota 額度顯示正常
使用者更新到最新版 Hermes，且 /gquotas 顯示 Gemini AI Pro 額度充足，但使用 google gemini cli 服務商搭配 gemini 3.1 pro 模型測試訊息時仍收到 429 錯誤，額度顯示接近 98%。此 issue 為開放狀態，處理狀態為 workaround。
[RFC] Kanban 多 profile 協作看板審查（對應 PR #16100）
此 RFC 追蹤已實作的看板功能 PR 16100，內容包含將原本以 cron 驅動改為長駐 daemon（hermes kanban daemon）搭配 systemd、拖放式看板 dashboard 外掛、執行歷史與 worker log 面板、即時 WebSocket 更新，並經過四輪稽核與外部審查，測試涵蓋多行
功能請求：Docker 穩定版釋出頻道
回報者透過 Podman 使用 nousresearch/hermes agent:latest 映像檔，但因為每幾小時就會推送新映像檔，導致環境更新太頻繁；雖然可以釘住特定版本 tag，但想避免手動追蹤更新的麻煩，因此提議新增一個指向最新穩定版的 stable 標籤。
功能請求：讓 dashboard 隨 gateway systemd 服務自動啟動
使用者反映 Hermes dashboard 目前是獨立行程，在 WSL 重啟或 gateway 當機後不會自動恢復，需手動重啟才能再次使用。提案建立獨立的 systemd 服務，讓 dashboard 在 gateway 之後自動啟動。
deepseek provider：模型名稱正規化與 base_url 覆寫機制會破壞自訂端點（如 Volcengine ARK）設定
設定 Hermes 使用 deepseek provider 搭配自訂 OpenAI compatible 端點（如 Volcengine ARK）時有兩個 bug：非標準模型名稱會被強制正規化成 deepseek chat 導致遠端回傳 404；credential pool 的 base url 每次啟動都會被硬編
[Feature] Dashboard 主題可讀性差，希望新增更易讀的主題
回報者認為 Dashboard 現有主題（Midnight、Ember、Mono、Cyberpunk、Rose）只是換色，字體偏襯線、字重輕、對比低，導致整體很難閱讀。因此提出希望新增一個或多個更符合主流 UI 標準（字體、字級、字重、對比）的主題，偏好深色模式，並以 Linear 的清晰易讀作為參考範例。
功能請求：終端機支援多後端（本地 + 多組具名遠端）並保留持久 shell
這個 issue 指出 Hermes Agent 目前一次只能設定一種終端機後端（local/ssh/docker 等），需要跨多台機器操作的使用者只能用一次性 SSH 指令拼湊，無法保留 cd、環境變數等 shell 狀態。提案支援同時設定本地與多組具名遠端後端，並各自保留持久 shell。
[Feature] 支援遠端 Hermes agent 搭配本機工具執行（遠端大腦、本機執行）
回報者希望能使用遠端的 Hermes Agent，同時把工具執行留在本機端。目前如果本機把 model.base url 指向遠端 Hermes 的 OpenAI 相容 API server，工具呼叫（例如 pwd）也會在遠端主機上執行，而不是在本機使用者實際的工作目錄執行，這和一般 LLM provider 把 to
功能請求：壓縮閾值（compression threshold）依模型 / provider 個別設定
目前 compression.threshold 是全域單一數值，對 1M context 模型（如 DeepSeek V4 Flash）門檻形同虛設，對小 context 模型又太保守。issue 提議在 config.yaml 新增依 provider 或依模型覆寫 threshold 的設定選項。
TUI 快速調整終端機視窗大小後仍可能出現殘留 / 錯位的文字亂碼
hermes tui 在快速拖拉調整終端機視窗大小後，畫面仍可能出現殘留或錯位的文字，這與先前 14640 修復的同類 resize 問題相似，但在部分終端機環境下仍可重現。
Slack：把 Markdown 表格渲染成 Block Kit 表格
Slack 的 mrkdwn 格式不支援 GitHub Flavored Markdown 的 pipe 表格語法，導致 Hermes 在 Slack 回覆包含表格的內容（例如工具比較）時，表格會以純文字管線符號顯示而非正常表格。此 issue 已關閉。
功能：讓 gateway 平台（Discord/Telegram 等）可依頻道分別設定模型與 system prompt
提案指出目前 gateway 對所有頻道只能使用同一組全域模型與 system prompt，但 Discord 或 Telegram 群組中不同頻道常有不同用途（如低成本摘要頻道、程式開發頻道、閒聊頻道），因此建議新增 channel overrides 設定，讓每個頻道可個別指定模型、provider 與 syst
功能提案：Model Presets，可針對單一回合臨時升級到更強的模型
提案指出目前 Hermes 整個 session 只能用同一個模型，若平時用便宜或快速模型，遇到需要更強推理能力的回合時，只能手動切換模型（之後還要再切回來）或硬著頭皮用弱模型應付；提案建議新增 model presets 設定，讓使用者能為單一回合臨時呼叫指定的 provider 加 model 組合，用完自動切回預
功能請求：新增 TrueConf 通訊平台的 gateway 支援
此 issue 要求讓 Hermes 支援 TrueConf Server / Enterprise 平台作為訊息 gateway，使 TrueConf 使用者能直接與 Hermes agent 溝通，不需透過第三方 gateway。回報者指出 Python 已有現成的 python trueconf bot 函式庫，
Docker 映像檔中 Dashboard 的 Chat 分頁因權限問題（EACCES）失敗
回報者在官方 Docker 映像檔中發現，Dashboard 的內嵌 Chat 分頁首次連線會顯示「Chat unavailable: 1」，根因是 dashboard 以非 root 的 hermes 使用者執行，但 /opt/hermes/ui tui/ 目錄及其 dist 內容在映像檔中屬於 root，導致首次建
功能請求：跨裝置雲端同步 Hermes 所有設定
目前 Hermes 的設定、profile、skills、session 與 memory 都只存在本機 ~/.hermes/ 目錄，多台裝置間沒有內建同步機制，使用者需手動匯出匯入。此 issue 提議加入內建雲端同步功能，涵蓋 config、profiles、skills、memory、sessions 與憑證。
[Feature] 支援 Mistral 作為 LLM provider
此 issue 提議把 Mistral 加入 Hermes Agent 原生支援的 LLM provider 清單，理由是 Mistral 使用者基數比某些既有支援的 provider 更大，且其語音模型已經整合進 Hermes，作者認為新增文字 LLM 應該不會太困難。目前只能透過 custom provider 選
openai-codex / gpt-5.5 作為主要模型時，每次呼叫都會靜默卡住直到 stale timeout
回報者指出當主要模型設為 openai codex / gpt 5.5 時，每次對話都會在約 300 秒的 non streaming stale timeout 期間完全沒有任何回饋（無 token、無錯誤、無提示），之後才會觸發 fallback。同樣設定改用 gpt 5.4 codex 則能立即正常運作，顯示問題
功能提案：整合 Telegram 新功能，包含 Guest Bot、Bot 對 Bot、貼圖與聊天自動化
提案根據 Telegram 於 2026 年 5 月 7 日釋出的一批新 AI bot 功能，建議 Hermes 導入其中幾項：Guest AI Bot（無需加入群組即可被 @mention 使用）、Bot to Bot 通訊（讓多 agent 工作流可直接在 Telegram 上互相對話協作）等，以強化 Hermes
Matrix gateway 缺乏頻內管道，讓下游 dispatcher 能做逐則訊息的 LLM 調度
回報者描述其部署架構在 Hermes 之後接了一個自訂的 OpenAI 相容 LLM dispatcher，依規則（如 context 大小、佇列優先權、安全邊界）在本地與雲端 LLM 之間路由請求；回報者指出目前 Matrix room 中使用者輸入的 /model 指令無法把路由決策帶給下游 dispatcher，
功能請求：新增 Infisical 作為外部 Vault 後端（#3630 的子 issue）
此 issue 是 3630（外部 Vault 支援）的子項目，指出目前支援的外部 Vault 清單（HashiCorp Vault、AWS Secrets Manager、1Password CLI、Bitwarden CLI）缺少對 self host 使用者很重要的 Infisical。回報者說明若採用 Infi
[Bug] 以 HERMES_UID 啟動 Docker 時，Dashboard 的 Chat 功能出現權限錯誤
使用者依照官方 Docker 文件更新 Unraid 範本，設定 HERMES UID / HERMES GID 並掛載共用磁碟區後，嘗試使用 Dashboard 內建的 Chat 功能時遇到權限被拒絕（permission denied）的錯誤。此 issue 已關閉，狀態為已修復。
所有模型被拒絕，錯誤「context window below minimum 64,000 tokens」，Telegram 完全癱瘓
回報者指出 Telegram bot 因 MiniMax M2.7 與 kimi k2.6（皆為 32,768 context）被 Hermes Agent 判定 context window 低於 64K 門檻而全面拒絕，導致 Telegram bot 與 cron job 同時失效。這些模型先前皆可正常運作，使用者
Hermes 更新後 Kanban 版面載入出現 401 Unauthorized
回報者指出更新 Hermes 後，Kanban 看板載入失敗並回傳 401 Unauthorized 錯誤，導致完全無法透過 dashboard 存取既有的 Kanban 工作佇列；回報者推測與同一波更新中出現的 Telegram 配對問題及 64K context 下限錯誤可能是同一批變更造成的。
[Bug] MiMo 推理模型的 reasoning_content 未被保留，導致多輪對話失敗
回報者指出 MiMo 推理（thinking）模型在多輪對話中，前一輪 assistant 訊息的 reasoning content 欄位沒有被保留並回傳給 API，而 MiMo 的 API 要求在 thinking 模式下必須回傳此欄位，因此後續請求會收到 400 錯誤。
RFC 提案：可插拔的 SessionDB 供應者，支援 PostgreSQL、MySQL 等
此 RFC 提案指出 Hermes 目前多個行程（CLI、Gateway、cron、TUI、API server）共用同一個 SQLite state.db 檔案，在一邊執行一邊更新（git pull / hermes update）時容易發生資料庫鎖定，甚至 WAL checkpoint 中斷造成損毀，因此提議讓 S
[Bug] 官方 Docker image 中的 Matrix/Synapse 功能故障
使用者回報官方 Docker image 中 Matrix/Synapse 的 gateway 從某個版本之後開始故障，log 卡在「fixing ownership :1000」不再往下跑，但 bot 仍能發送訊息到 Matrix，只是不會回應頻道內的提示。使用者同時建議原生支援 Matrix 加密功能（可能缺少 m
[Feature] 希望 Hermes 支援用 Claude 訂閱 OAuth 當作 Agent SDK 的 model provider（比照 Codex 模式）
回報者指出現有的 anthropic provider 需要 Developer Platform API key 並另外計費，導致已訂閱 Claude 的使用者形同重複付費（訂閱費 + API token 費）。文中引用 Anthropic 官方說明，指出 2026 年 6 月 15 日起 Agent SDK 與 c
功能請求：原生 Windows 支援
這個 issue 要求為 Hermes Agent 新增原生 Windows 支援。此 issue 已關閉。
Microsoft Teams 平台外掛在內建 Python 3.11 環境下無法載入（microsoft-teams-apps 需要 Python 3.12 以上）
回報者依官方文件設定 Teams 平台後，gateway 始終無法綁定 3978 埠，原因是 Teams 外掛匯入的 microsoft teams apps 套件需要 Python 3.12 以上，但 Hermes 安裝程式建立的虛擬環境是 Python 3.11，即使系統上已有 Python 3.13 也未被 He
Bug：「Response truncated due to output length limit」在 #7237 修復後仍然發生（重新開啟已關閉的 issue）
此 issue 指出「Response truncated due to output length limit」錯誤在先前 7242 與 9525 的修復（回應 7237）之後仍然持續出現。 7237 曾被維護者以「這不是 bug，是 context window 限制」為由關閉，但作者指出關閉後累積的 10 多則留
[Bug] xAI OAuth（xai-oauth）對一般 SuperGrok 訂閱者回傳 HTTP 403，後端疑似只放行 Heavy 方案
這個 issue 指出 xai oauth provider 對持有一般 SuperGrok 訂閱（非 Heavy）的使用者，在推論時持續回傳 HTTP 403，OAuth 登入與 token 儲存流程本身正常，問題出在 xAI 後端目前似乎只放行 SuperGrok Heavy 方案，與官方公告及 Hermes 文件
[Bug] 同時設定 provider、base_url 與 api_key 時，auxiliary task 的 provider 身分會遺失
回報者指出當 auxiliary 任務（如 auxiliary.vision）同時設定 provider、base url 和 api key 時，provider 名稱會被系統忽略並強制改為 custom，導致原本針對特定 provider 的處理邏輯（如 ZAI vision 的 max tokens 略過、Ant
模型回應因輸出長度上限被截斷
回報者指出當模型輸出達到 max output tokens 上限時，回應會被截斷並顯示 finish reason='length' 的錯誤，接著自動回滾到上一個完整的 assistant 回合；此問題在對話變長、模型產出較長內容時較常出現。
--tui 模式下 gateway 會在對話中途因 stdin EOF 意外退出
回報者指出在 macOS 的 tui 模式下，即使使用內建 memory（未啟用 byterover），Python gateway 仍會在對話進行到一半時因「stdin EOF (TUI closed the command pipe)」而退出，12 小時內發生三次，回報者判斷此問題與另一個因 byterover 記
macOS 上 xAI OAuth loopback：瀏覽器已收到回呼，但 Hermes 仍逾時
回報者在本機 macOS（非 Docker、非 WSL、非遠端主機）設定 xAI Grok OAuth 時，瀏覽器已顯示「xAI authorization received」的成功畫面，但 Hermes 仍拋出 xAI authorization timed out 的錯誤，且沒有任何 xAI 憑證被儲存；回報者指出
WhatsApp：回覆訊息的 quotedMessageId / context 沒有傳給 agent，導致回覆情境遺失
使用者在 WhatsApp 回覆（引用）特定訊息時，bridge 有擷取到 quotedMessageId 等 metadata，但 whatsapp.py adapter 會捨棄這些資訊，agent 只收到新的文字內容，看不到被引用的原始訊息。issue 指出這與 27946（Matrix 的同類問題）屬於同一類 b
[Bug] Hermes 透過 Claude CLI 無法運作
回報者在設定 Hermes 使用 Anthropic 的 Claude Pro/Max 訂閱登入方式並選擇 claude opus 4.7 模型後，收到「provider 重試多次後失敗」的錯誤，終端機顯示 BadRequestError [HTTP 400]。此 issue 已關閉。
功能請求：MCP OAuth 需要支援 HTTPS callback URL（而非只能用本機 HTTP）
目前 Hermes 的 MCP OAuth 只支援 http://127.0.0.1:8765/callback 這種本機 HTTP callback，許多 OAuth 服務（如 Salesforce 官方 MCP 流程）不接受這種格式。issue 提議在 config 增加 redirect uri 覆寫選項以支援
[Bug] Discord gateway 出現 API 錯誤，cron 排程訊息無法送達
使用者回報排定的 cron job 無法將訊息送達指定的 Discord 頻道，不論是自動執行還是手動觸發都一樣；但透過在 Discord 上強制產生討論或手動測試訊息時卻可以正常送達。Gateway log 顯示 Discord API 回傳 404 錯誤。此 issue 已關閉，狀態為已修復。
功能請求：支援 XMPP 聊天協定並搭配 OMEMO 加密
這個 issue 指出目前 Hermes 只支援 WhatsApp、Signal 等封閉式聊天協定，提案新增支援可自架、加密且跨裝置廣泛支援的 XMPP 協定（搭配 OMEMO 加密）作為即時通訊選項。
[功能] Profile 模式的 workers 需要獨立於 HERMES_HOME 之外的共用 auth 儲存位置
回報者指出多個 profile 模式的 Hermes worker 各自使用獨立的 HERMES HOME，導致 OAuth 憑證分散儲存，在使用會輪替或單次使用 refresh token 的 OAuth 服務時容易發生憑證衝突或更新失敗。提案是新增獨立的 HERMES AUTH HOME 環境變數，讓 profil
設定精靈啟用 NeuTTS 時安裝失敗，錯誤「No module named pip」
回報者在全新安裝 Hermes 並於設定精靈中啟用 NeuTTS 後，安裝過程因虛擬環境內找不到 pip 模組而失敗，回報者推測系統可能只有 pip3 可用。
功能請求：支援 Proton Pass AI Access Tokens 作為機密來源後端
Hermes 目前支援 Bitwarden Secrets Manager 作為外部機密來源，官方文件也表示歡迎提出其他後端需求。Proton Pass 最近推出 AI Access Tokens，提供唯讀 vault 存取、可設定過期時間、稽核紀錄與端對端加密，此 issue 提議將其新增為 Hermes 的機密來源
套用 #31967/#32016 修復後，openai-codex / gpt-5.5 仍反覆卡在沒有 first byte
回報者指出即使已套用先前針對 Codex timeout 的修復（ 31967、 32016），openai codex / gpt 5.5 仍經常在串流開始前卡住，出現「No first byte from provider in 45s」的重試與斷線訊息，且此問題與舊有的 context 為 0 或 300 秒 s
修正 Codex stream 回傳 None 時的還原機制
此 issue 描述 OpenAI Codex Responses 後端在串流結束時可能回傳 response.output 為 None，導致 OpenAI SDK 的 stream parser 直接崩潰、被 Hermes 誤判為不可重試的用戶端錯誤。作者提出修補方式，包含從已串流的 output items /
Bug：Hermes 使用 OpenAI Codex（ChatGPT）時噴出 'NoneType' object is not iterable 錯誤
此 issue 回報在使用 Provider 為 openai codex、Model 為 gpt 5.5 時，透過 Telegram 或 CLI 傳送任何訊息都會噴出 'NoneType' object is not iterable 錯誤，並被當成不可重試的用戶端錯誤中斷。回報者認為 Hermes 呼叫 ChatG
Bug：openai-codex provider 崩潰，SDK 的 parse_response 無法處理 Codex 後端回傳的 null output
此 issue 指出 Hermes v0.14.0 在使用 openai codex provider 搭配 gpt 5.5 時，每次呼叫 hermes chat 都會噴出 'NoneType' object is not iterable。根因是 ChatGPT Codex 後端在 response.complete
功能請求：整合 Microsoft SkillOpt 實現 agent skill 自我演化
這個 issue 提議探索整合微軟釋出的 SkillOpt，一個透過軌跡驅動編輯與驗證閘門來訓練可重用自然語言 skill 的文字空間最佳化工具，讓 Hermes 能在不動模型權重的情況下自動最佳化 skill。
[Bug] Hermes v0.14.0 中 openai-codex/gpt-5.5 仍不穩定：subagent 幾乎都會連線逾時，官方 Codex CLI 卻正常
回報者指出在 Hermes v0.14.0 中使用 openai codex/gpt 5.5 仍非常不穩定，主要 agent 約有五成機率遇到連線失敗，多個 subagent 同時執行時幾乎必定失敗，但同一台機器、同一網路、同一 ChatGPT/Codex 帳號下的官方 Codex CLI 卻能正常使用，導致 Herm
[Bug] openai-codex 服務商每次請求都因 TypeError（'NoneType' object is not iterable）而崩潰（chatgpt.com 回傳的 output 為 null）
使用者回報在 gateway 重啟後，openai codex 服務商每一次請求都會因 TypeError 崩潰，重新登入也無法解決，因為憑證池雖然重新填入卻立刻再次被抑制。根因是 chatgpt.com 的 Codex 端點在 response.completed 事件中回傳 output: null，OpenAI
功能請求：為 CLI 查詢輸出新增 --output-format json 旗標
使用 hermes chat q 做程式化編排（如 CI pipeline、MCP server）時，目前只能得到純文字輸出，token 數、成本、session ID、模型資訊等都要自行從非結構化文字解析。此 issue 提議新增 output format json 旗標，輸出包含這些 metadata 的結構化
[Bug] Kanban 資料庫損毀問題導致系統崩潰
使用者回報 Hermes 在處理大型任務並使用 Kanban 看板時會崩潰，經過數天排查後認為根因是 Kanban 使用的 SQLite 對檔案鎖定處理不佳：當多個 subagent 同時對同一筆看板資料（例如同一張母票）寫入更新時，資料庫會損毀，嚴重時資料庫會直接關閉，而 Hermes 的狀態也存放在同一個資料庫中，
OpenAI Codex provider 當機，錯誤「'NoneType' object is not iterable」（HTTP None）
回報者指出切換到 gpt 5.5（透過 OpenAI Codex provider，以 OAuth 訂閱登入）後，傳送第一則訊息就會立即觸發「Non retryable error (HTTP None): 'NoneType' object is not iterable」的當機。雖然會自動 fallback，但 C
Codex Responses 串流當機，錯誤 TypeError: 'NoneType' object is not iterable（openai-codex / chatgpt.com backend）
回報者透過外部檔案與截圖回報 Codex Responses 串流功能發生 TypeError: 'NoneType' object is not iterable 的當機，issue 本文未附詳細文字說明，細節放在附件檔案中。此 issue 被標記為重複（duplicate）。
[Bug] v0.15.0 Docker image 缺少 stage2-hook.sh / main-wrapper.sh，container_boot 模組也被移除，導致啟動失敗
官方 nousresearch/hermes agent:latest（v0.15.0）Docker image 啟動時發生三個初始化錯誤並以 exit code 127 結束：找不到 /opt/hermes/docker/stage2 hook.sh 與 main wrapper.sh（原始碼中存在但未進到建置後的
功能請求：解決 Hermes 多租戶（multi-tenant）問題
這個 issue 指出 Hermes 目前的 memory 操作會繞過 hook 系統，導致無法在不修改核心程式碼的情況下做到租戶隔離。作者團隊釋出了開源專案 Hermes Swarm Map，擴充現有 Hermes 模式以支援多租戶環境下的權限控管，並提案將相關修改回饋（upstream）到 Hermes 核心。
[Feature] 多 Agent 架構：協調、協作、專職角色與具韌性的工作流程（總覽 issue）
此 issue 是把 Hermes 從單一 agent（可用 delegate task 產生用完即丟的子 agent，彼此無法溝通、無法共享狀態）演進為真正多 agent 架構的總覽提案，涵蓋具獨立身分與工具集的專職角色、依賴關係感知的工作流程分解、agent 間協作共享 context、當機恢復與卡住偵測，以及跨平
功能：hermes setup 與 config 重新產生時應保留使用者自訂設定值
回報者指出執行 hermes setup 或版本升級後重新產生 config 時，使用者自訂的設定值（如把 compression.threshold 從 0.50 改成 0.80）會被靜默重設回預設值，導致使用者先前為避免 compaction 迴圈所做的調整失效；提案建議在寫入新 config.yaml 前，先讀取
功能請求：即時語音對話模式（語音輸入輸出、低延遲）
這個 issue 指出目前與 Hermes Agent 的互動只能靠文字（CLI/TUI/IM 平台），沒有像真人對話般的即時語音互動方式。提案在終端機/TUI 中加入麥克風輸入、即時語音轉文字、低延遲回應與語音合成輸出的完整語音對話模式。
Desktop：為已存在的 Hermes 服務新增正式的遠端用戶端引導流程
此 issue 指出目前 macOS Desktop 安裝程式的流程偏向本機優先：開啟下載的 DMG 就會看到「Install Hermes」的 setup/bootstrap 畫面，對已經在伺服器或服務機上跑 Hermes、只想要一個桌面用戶端的使用者來說容易造成混淆，讓人誤以為不支援遠端模式，即使桌面版程式碼其實可
[小問題] /tools 指令輸出格式不一致：文字被截斷、標題對不齊
使用者回報執行 /tools 指令時，輸出畫面有兩個排版問題：部分文字被截斷看不完整，以及頂部標題列置中位置偏移一個空格（在 macOS + ghostty 終端機下觀察到）。此 issue 已關閉，狀態為已修復。
功能請求：新增 Rocket.Chat 支援
回報者希望 Hermes 能新增 Rocket.Chat 作為訊息 gateway 通道。
功能請求：Desktop Remote gateway 應支援從 UI 切換 Hermes profile
當 Hermes Desktop 連到遠端 Hermes 後端時，目前只能看到 profile 清單，實際生效的 profile 仍取決於遠端後端啟動時的 HERMES HOME/HERMES PROFILE，Desktop 的 Profiles 頁面無法真正切換後端使用的 profile。此 issue 提議讓 De
[Bug] WhatsApp 的 send_message 工具無法識別 @lid JID、會誤傳到預設頻道，且原始電話號碼會觸發 jidDecode 錯誤
回報者指出 WhatsApp 傳訊功能有三個相關問題：聯絡人名稱解析出的 @lid JID 未被辨識，導致訊息被靜默轉發到預設聊天頻道；未加 + 號或無事先訊息紀錄的原始電話號碼會讓 Baileys 的 jidDecode 失敗並回傳 500 錯誤； send whatsapp 直接呼叫 bridge API，而非透過
[Bug] Cron 排程工作會顯示 memory 工具，但實際執行時無法使用
回報者指出 cron 排程工作中 memory 工具雖然出現在可用工具清單，但實際呼叫時會失敗並顯示「Memory is not available」。原因是 cron 排程用 skip memory=True 建立 AIAgent，但預設工具集仍繼承包含 memory 的核心工具，導致工具存在但無法使用。
[skills-index-watchdog] Skills index 自動偵測到過期或降級（degraded）
自動化的 skills index 新鮮度探測失敗，狀態顯示為 degraded，詳細訊息為「github: 0 < 30」。此 issue 由 GitHub Actions 自動開啟，用來追蹤 /docs/api/skills index.json 的重建是否正常，若問題未解決會持續重新開啟，目前狀態為調查中。
功能請求：Hermes Desktop 支援僅安裝前端（不含 agent 本體）
使用者希望能只安裝 Hermes Desktop 的前端介面，直接設定連線到已安裝在另一台機器上的 agent，而不需要在同一台機器上安裝 agent 本體。
Desktop 版貼上截圖時會重複附加兩份相同的圖片
在 Hermes desktop app 貼上截圖到聊天輸入框時，會附加兩份相同的截圖而非一份，回報者懷疑是重複的 paste/drop/clipboard 事件處理常式同時觸發所致。此 issue 已關閉。
[Feature] 支援桌面版 Hermes 以純用戶端模式安裝，連線遠端 Hermes
回報者想把 Hermes Desktop 安裝成連線到遠端既有 Hermes 服務的輕量用戶端，但現況是只要偵測不到本機安裝，桌面 App 就一定會在首次啟動時自動跑 electron/main.cjs 裡的 bootstrap，執行 install.ps1 安裝 Python、Node 等依賴，沒有官方提供的純用戶端
hermes -z（oneshot 模式）可能漏掉 MCP 工具，因為工具清單在 MCP 探索完成前就先被快照
在 hermes z（oneshot 模式）下，即使 MCP server 通過 hermes mcp test 測試且能探索到工具，agent 實際可用的工具清單中卻沒有這些 MCP 工具。原因是 oneshot.py 在建立 AIAgent 時就已解析好工具清單，時間點在 MCP discovery 註冊動態工具之
[Feature] 原生支援 AWS Bedrock provider
此 issue 指出目前只能透過 OpenRouter 存取 Bedrock，這會多一層轉手延遲、約 5 20% 的費用加成、無法使用自己的 AWS 帳號憑證，也失去 VPC endpoint、CloudTrail、議定價格等企業功能。作者提議直接串接 Bedrock、使用標準 AWS SDK 憑證鏈（環境變數、共用憑
功能請求：Desktop Remote Gateway 應支援真正的遠端工作區 / 檔案瀏覽器
Hermes Desktop 連到遠端後端時，聊天與 session 執行是在遠端機器上跑，但 Desktop 的檔案瀏覽器/工作區面板實際上讀的是本機 Electron 檔案系統，導致遠端模式下的「工作區」名不符實，除非另外把遠端檔案系統掛載到本機才能勉強瀏覽，但仍會出現檔案瀏覽器指向本機掛載路徑、而 agent/s
桌面版「工作目錄」設定無法覆蓋殘留的舊 workspace cwd 記憶
回報者指出在 Hermes Desktop 中，即使在 Settings 中正確設定了新的 Working Directory 並寫入 config.yaml 的 terminal.cwd，若 renderer 端的 localStorage 已記住舊的 workspace 路徑，新 session 仍會在舊目錄啟動，
功能請求：讓 Mixture-of-Agents（moa）可透過 config.yaml 完整設定以兼顧成本與品質
目前 mixture of agents（moa）工具固定使用一組昂貴的頂級模型並套用最高推理強度，成本過高難以日常使用。issue 提議在 config.yaml 新增 moa 區塊可自訂參考模型、聚合器、溫度與推理強度等參數，並提供 session 層級指令與 slash command 動態開關 MoA 路由。此
功能請求：Desktop 版新增文字縮放與可調整內文寬度／邊界設定
這個 issue 指出 Hermes Desktop 目前聊天訊息的顯示欄位偏窄，在大螢幕上留下大量空白，在小螢幕上又容易造成過度換行，對有視力需求的使用者也不友善。提案新增可自訂的文字縮放與內文寬度設定。
[功能請求] Docker image 缺少 linux/arm64 架構支援
使用者反映想在 Apple Silicon Mac 上跑 Hermes Agent 的 Docker container，但目前沒有提供 linux/arm64 架構的 image，只能用 Rosetta 2 執行 amd64 版本，且官方沒有相關文件說明。此 issue 已關閉。
Desktop UI：完整支援設定自訂 OpenAI 相容 provider
Hermes Desktop 目前對許多已知 provider 有內建 API key 欄位，但對自訂的 OpenAI 相容端點（如 AI Router、LiteLLM、自架 gateway 等）只有部分 UI 支援，使用者只能借用其他 provider 的欄位或手動編輯設定檔，容易造成混淆並限制模型清單。此 issu
新增 Ollama Cloud 作為內建 provider
此 issue 指出 Ollama Cloud（OpenAI 相容 API 的雲端推論服務）目前只能透過 custom providers 設定使用，這會造成幾個問題：provider: ollama cloud 在 auxiliary 區塊不會被辨識、需要在每個 auxiliary 任務設定中重複寫 provider
功能請求：整合 headroom-ai 做工具輸出壓縮
這個 issue 提議整合開源工具 headroom ai，在個別工具輸出（如 log、grep 結果、JSON、程式碼）進入 context 前先壓縮，以解決現有 context compressor.py 在對話層級摘要壓縮時遇到的多項已知問題，例如誤判觸發時機、壓縮後反而變大、摘要失敗導致資料遺失等。
[Desktop app] 新增字體大小 / 縮放控制
macOS 上的 Hermes desktop app 沒有調整字體大小或縮放的方式，標準 macOS 縮放快捷鍵（Cmd+加/減/0）與觸控板縮放手勢都無效，config.yaml 也沒有相關的 display 設定，在高解析度或大螢幕上預設字體過小，且沒有替代方案。
[Bug] 執行 hermes update / hermes desktop 時，桌面應用程式編譯失敗
使用者回報執行 hermes update 或 hermes desktop 進行 Electron 桌面應用程式最後編譯階段時發生錯誤；附上的 log 顯示 electron builder 正在為 darwin arm64 平台下載並封裝 Electron 執行檔（標題標註為 Windows desktop app
功能請求：Desktop 版支援每個 session 各自選擇工作目錄，而非僅限啟動時的 cwd
這個 issue 指出 Hermes Desktop 目前只能在啟動時透過 cwd 或環境變數指定單一工作目錄，長期使用多個專案時很不方便；側邊欄選擇資料夾也不會真正變成新 session 的工作目錄。提案讓使用者能在 App 內新增/開啟專案資料夾，並讓新 session 綁定該資料夾。
功能請求：安全機密管理工具（API key 匯入、範圍限定存取、遮罩與 skill 需求宣告）
此 issue 是端到端安全機密管理的總覽 issue，指出目前 Hermes 的機密都以明文存放在 ~/.hermes/.env，每個子程序都拿到完整環境變數，檔案工具也會外洩原始機密，且沒有機制讓 skill 宣告「需要 Twilio API key」並安全提示使用者輸入。此 issue 已關閉。
功能請求：Hermes Desktop 樣式、主題與字型自訂
這個 issue 指出 Hermes Desktop 目前視覺自訂選項很少，提案建立涵蓋編輯器排版（粗體/斜體、字型、字級、程式碼區塊配色）、深色/淺色主題切換、跟隨系統外觀，以及自訂主題等功能的完整樣式系統。此 issue 已關閉。
功能請求：把 Kanban 看板整合進 Desktop app
目前 Kanban 看板與 Desktop app 是分開的，使用者要另開終端機下指令（如 hermes kanban list）並手動複製任務 ID，造成多 agent 協作時的操作阻力。此 issue 提議在 Desktop app 加入側邊欄或 /kanban 指令，讓使用者不用離開聊天介面就能查看與操作看板任務
從 0.5.0 升級到 0.6.0 時 python-olm 建置失敗
回報者在把 Hermes 從 0.5.0 更新到 0.6.0 的過程中，python olm 套件因 CMake 版本相容性問題建置失敗，但回報者表示這個錯誤似乎沒有實際影響 Hermes agent 的運作。
修正：Codex gpt-5.5 自動調高上限通知在同一 gateway session 內重複出現
這個 issue 指出 Codex gpt 5.5 壓縮閾值自動調高的說明通知，在 gateway session 因重建（如 gateway 重啟、cache 失效）時會重複顯示給使用者，即使並非開啟新的可見 session。提案讓此通知在同一個持久 gateway session 中只顯示一次。
[Bug] local 後端會忽略 terminal.cwd 設定，一律使用程式啟動時的目錄
回報者指出在 config.yaml 中設定 terminal.cwd 對 local 終端機後端完全無效，根因是 cli.py 中有一段無條件覆寫邏輯，當後端為 local 時會直接用 os.getcwd() 蓋掉設定值，導致該設定只在 docker、ssh 等非 local 後端才生效。
[Bug] openai-codex 帳號池誤判健康帳號為額度用盡，執行 hermes auth reset 可恢復
Hermes 錯誤地將所有 openai codex 帳號池憑證標記為已達速率限制，包含實際上仍有可用額度的第三個帳號；回報者懷疑是帳號池內部的重置時間戳記狀態管理有誤。
Token 開銷分析：每次 API 呼叫有 73% 是固定開銷（約 13.9K tokens），附數據與改善建議
使用者透過自建的監控儀表板分析 Hermes v0.6.0（Telegram + WhatsApp + Cron 三個 gateway）的 6 份 request dump，發現每次 API 呼叫中有 73% 是不隨請求內容變動的固定開銷，主要來自工具定義（31 個工具佔 46.1%）與系統提示詞（SOUL.md +
建議 Gateway 保留 Telegram 等平台的轉發訊息中繼資料（forwarded-message metadata）
目前 gateway 在正規化收到的訊息時會捨棄 Telegram 原生的轉發訊息中繼資料（如 forward origin），導致 agent 無法分辨使用者是自己輸入還是轉發他人訊息。提案新增一個平台中立的標註層來保留這類上下文。
桌面版/TUI 續接舊 session 時出現「No LLM provider configured」錯誤（session 只存了 billing_provider，如 custom 供應商）
回報者指出在桌面版（與 TUI gateway）點擊任何舊對話續接時都會失敗並顯示「resume failed: No LLM provider configured」，即使目前設定的預設 provider 完全有效、開新對話也正常；同樣的 session 用 CLI 的 hermes chat resume 卻能正常
[功能需求] 桌面版終端機面板應自動跟隨 agent 使用的後端環境
回報者指出 Hermes 桌面版內嵌的終端機面板在 Windows 上一律啟動 PowerShell，即使 agent 實際設定的後端是 WSL2 等其他環境，導致終端機顯示的環境與 agent 實際執行環境不一致，也無法用 read terminal 監控 agent 的真實執行狀態。提案是讓終端機面板自動偵測並對應
功能請求：Gateway session 支援每個群組／主題的個別設定覆寫（topic_configs）
這個 issue 指出目前用同一個 gateway 跑多個 Telegram 群組或 Discord 伺服器時，所有 session 都共用同一組人格、system prompt、CLAUDE.md 與工作目錄，無法針對不同群組或討論串客製化。提案在 config.yaml 新增 topic configs 區塊，依平
功能請求：支援 Telegram Bot API 10.1 的 Rich Messages 與豐富草稿串流
這個 issue 指出 Telegram Bot API 10.1 新增了 RichMessage 等豐富訊息格式（標題、清單、表格、LaTeX 等區塊），提案讓 Hermes 的 Telegram gateway 支援這些新 API，取代目前 plain/MarkdownV2 訊息與逐則編輯的串流方式，讓輸出呈現更完
Bug：前端當機，工具回傳非預期資料時出現 tapClientLookup Index out of bounds
在 Hermes Desktop GUI 中使用 skill manage、memory 或 cronjob 等工具時，若工具回傳的資料結構與前端預期不符，前端會拋出 tapClientLookup: Index out of bounds 錯誤，導致聊天介面白屏或卡死。
[功能] 優化 Ollama 整合：改用原生 /api/chat 端點取代 OpenAI 相容端點
使用者提出以 Ollama 原生 /api/chat 端點取代目前使用的 OpenAI 相容端點 /v1/chat/completions，宣稱可帶來真正的逐字串流、更長的逾時時間、完整的 Ollama 參數支援，以及約 15 20% 的延遲降低，並附上一份 581 行的 agent/ollama adapter.py
Bug：web_search / web_extract 在未經使用者同意下，未設定 API key 也會偷偷把流量導向 Parallel.ai
此 issue 指出某次 commit（PR 43798）改變了 web search 與 web extract 在沒有設定任何 backend 時的預設行為：以前預設會落到 firecrawl（沒設 API key 就會在呼叫時失敗），現在則會在使用者完全沒設定 API key、也沒設定 backend 的情況下，
[功能] 逐行內差異顯示、多語言語法高亮與完整 Markdown / 主題支援（5 個疊加 PR）
此為追蹤 issue，串連多個疊加式 PR，為 agent/rich output.py 建立分層終端機渲染引擎，包含逐字元層級的 diff 高亮顯示、多種語言的語法高亮，以及完整的 Markdown 渲染（標題、清單、引言、表格等）。此 issue 已關閉，狀態為已修復。
[Feature] 建議 Desktop 版支援 Ctrl+F / Cmd+F 在聊天與編輯器內搜尋文字
提案讓 Hermes Desktop 支援類似瀏覽器的「尋找」功能，可在聊天紀錄與 SOUL.md 等編輯器/設定介面中搜尋文字，具備反白標示、上一筆/下一筆導覽與符合筆數顯示等功能。
[Bug] 游標閃爍或表情符號切換導致終端機提示框線一直閃爍
使用者反映在 ghostty 搭配 tmux（一般終端機也會發生）環境下使用 Hermes，游標閃爍會讓提示輸入框的邊框線跟著閃爍，希望能關閉游標閃爍或思考中表情符號輪播動畫。此 issue 已關閉。
[Bug] Cron 排程工作在 OAuth 憑證池耗盡時不會切換到備援 provider
回報者指出使用 OAuth 型 provider（如 openai codex）的 cron 排程工作，在憑證池耗盡時會直接以 HTTP 429 錯誤失敗，而不會像一般 gateway/CLI 主對話那樣自動切換到設定好的 fallback providers 備援鏈，因為 cron/scheduler.py 走的是不
功能提案：憑證代理 daemon，zero-knowledge 的 HTTP/HTTPS 憑證中介機制
此提案指出現有的 env scoping（ 3628）與 PID namespace isolation（ 4432）雖降低憑證外洩風險，但子行程仍可能存取到真實憑證值本身；提案建議在 HTTP 傳輸層攔截，讓真實憑證值永遠不出現在 agent 可存取的任何位置，才能從架構上根本防止 agent 讀取憑證。
[Bug] Ubuntu 26.04 桌面版更新時 Build failed，之後無法再啟動
在 Ubuntu 26.04 LTS 按桌面版右下角的更新按鈕後出現 Build failed，terminal 啟動 hermes desktop 報大量錯誤且無法再執行；CLI 的 hermes 指令仍正常。此 issue 已關閉。
Desktop 更新按鈕在透過 CLI 重建後仍顯示「請在終端機執行 hermes update」
點擊 Hermes Desktop 的「Update」按鈕有時會顯示要求使用者到終端機執行 hermes update 的對話框，而非直接執行更新。原因是 resolveUpdaterBinary() 找不到已存在的 hermes setup.exe，因為透過 CLI 執行 hermes update 重建 deskt
功能提案：可設定的記憶後端，將 memory.md 改名為 rules.md 並支援只用 honcho/fact_store
提案指出 Hermes 目前把 MEMORY.md 與 USER.md 兩個固定檔案的全部內容在每一回合都注入 system prompt，造成規則（永遠該注入）與事實性資料（應可查詢）混雜，且大量條目會造成每回合的 token 浪費；提案建議把 memory.md 更名為 rules.md，並支援可設定的記憶後端。
[Bug] 更新後 Desktop build 失敗：electronDist does not exist（快取失效）
這個 issue 指出即使先前 PR 47276 的修復曾經成功，在拉取最新程式碼更新後 Desktop build 又再次失敗，因為更新過程會清除 Electron binary 快取，出現「electronDist does not exist」錯誤，顯示 47266 的修復並未徹底解決問題。此 issue 已關閉
Cron 排程訊息投遞到 Telegram 私訊主題（DM topic）時，常會跳出該主題
當 cron 排程訊息指定投遞到 Telegram 私訊（DM）的特定主題時，由於路徑中只帶有一般的 thread id、缺少私訊主題所需的中繼資料，Telegram adapter 可能拒絕或改成投遞到主題之外，導致訊息沒有出現在原本指定的主題中。
[Bug] CLI 在淺色/米色終端機背景下難以閱讀，缺少淺色模式支援
Hermes CLI 在淺色或米色背景的終端機上幾乎無法閱讀，所有內建 skin（default、ares、mono、slate、poseidon、sisyphus、charizard）都採用為深色背景設計的淺色文字，導致 banner、歡迎訊息、提示符號與使用者輸入文字幾乎看不見。此 issue 已關閉。
功能請求：加密稽核軌跡，SHA-256 雜湊鏈結行動紀錄（靈感來自 OpenFang）
這個 issue 提議參考 OpenFang 專案的 Merkle 雜湊鏈結稽核軌跡設計，為 Hermes Agent 新增以 SHA 256 逐筆鏈結、防竄改的行動紀錄機制。作者指出目前 Hermes 的紀錄偏向對話內容導向，缺乏針對「代理程式執行了什麼動作」的結構化、可鏈結安全紀錄。此 issue 已關閉。
[功能需求] 跨平台（Telegram、iMessage、CLI 等）共用 session 上下文的對話延續性
回報者指出目前使用者在不同平台切換時，只有長期記憶與已儲存事實會延續，實際對話紀錄仍侷限在原本發生的平台上，導致上下文片段化，使用者必須重複資訊或手動請 agent 查詢過去 session。提案希望能有機制，讓其他平台/session 的相關對話內容可自動或依需求注入目前 session。
[功能] 為 Gemini 模型新增原生 Google GenAI 服務商
使用者提出功能需求，指出目前要在 Hermes 使用 Gemini 模型（如 gemini 3.1 pro preview）只能透過中介服務或 Google 的 OpenAI 相容端點，但相容層常導致 tool calling 不穩定、串流 token 遺失或 agent 崩潰，因此建議實作直接呼叫 Google Ge
功能請求：Web UI Gateway，本機瀏覽器介面搭配串流、Artifacts 與豐富渲染
這個 issue 指出 Hermes Agent 目前支援 CLI、Telegram、Discord、WhatsApp、Slack、Home Assistant 等互動方式，但缺少本機瀏覽器介面。作者研究了 30 多個 AI 介面專案（如 AG UI Protocol、Claude Artifacts、ChatGPT
z.ai 在「尖峰時段」對 hermes agent 做速率限制（429 錯誤）
使用 Max coding plan 搭配 glm 5.2 時，z.ai 在尖峰時段會限制 hermes agent，回傳 429 錯誤（1302/1305），但同帳號下的 opencode 和 claude 不受影響。回報者懷疑是 z.ai 依請求簽章辨識出 hermes 而限速。此 issue 已關閉。
[Feature] 支援 A2A（Agent-to-Agent）協定：遠端 Agent 探索、通訊與互通
此 issue 提議讓 Hermes 支援 Google 提出的 A2A（Agent to Agent）開放協定，作為與 MCP 互補的機制：MCP 回答「我能用哪些工具」，A2A 回答「誰能幫我」，讓不同框架打造的 agent 能互相探索能力並透過標準 HTTP 協作任務。作者認為 Hermes 已有成熟的 MCP
[Feature] 透過 Gateway Hooks 實現多角色自動路由
此 issue 提議讓使用者能定義多個具名「角色」（例如營養師、開發者、財務顧問），各自擁有專屬 session 與系統提示，並用一個輕量分類器（如 Gemini Flash）自動把訊息路由到對應角色，藉此解決目前 Hermes 所有話題共用單一 session、單一人格，導致不同主題互相污染 context、無法給予
[文件] Context 檔案（AGENTS.md/SOUL.md）的說明文件與實際程式碼行為不一致
這個 issue 指出文件描述的三項行為與程式碼實作不符：AGENTS.md 文件說會遞迴合併子目錄設定，但程式碼只讀當前目錄；SOUL.md 文件說會先檢查 cwd 再 fallback 到 ~/.hermes/，但程式碼完全不讀 cwd；文件描述的 terminal.cwd 設定在 gateway/訊息模式下實際會
Cron 排程訊息投遞到 Telegram 私訊主題時，錯誤地被導向 General 主題
自從某次修正（ 22773）後，cron 排程投遞到 Telegram 私訊（DM）forum 主題的訊息會被導向 General/主要主題，而非目標主題，即使 cron 設定的投遞目標本身是正確的；根因是 cron/scheduler.py 對「私訊主題」的分類判斷邏輯有誤。此 issue 已關閉。
用 --no-agent --script 建立 cron job 失敗，錯誤「'str' object has no attribute 'exists'」
回報者在 Windows 環境下用 hermes cron create 搭配 no agent script 建立純腳本排程任務時，程式在驗證排程前就因型別錯誤而失敗，回報者認為這是 cron job 建立流程中的 schema 或 runtime 型別問題，而非使用者輸入錯誤。
[Bug] /agents TUI 指令不更新 subagent 完成狀態，一直卡在 running
用 delegate task 派出 subagent 後，/agents 面板即使任務已完成並回傳結果，狀態仍固定顯示 running 不會更新成 completed 或 failed。此 issue 已關閉。
feat：通用化 ACP client，支援多種 coding agent 的多 agent CLI 編排
此 issue 提議把 Hermes 現有的 ACP（Agent Client Protocol）client（目前是針對 Copilot 特化的 copilot acp client.py）通用化，讓 Hermes 可以編排所有相容 ACP 的 coding agent，包括 Claude Code、Codex CL
功能請求：Gateway 權限分級（Owner/Admin/User/Guest）角色存取控制
這個 issue 指出 Hermes Agent 目前的 gateway 授權是二元制（全部允許或完全阻擋），沒有權限層級概念。提案為 Telegram、Discord、WhatsApp、Slack 等 gateway 平台導入分層權限系統（Owner、Admin、User、Guest），讓部署者能與他人共用 agen
[Bug] QQBot adapter 的 connect() 缺少 is_reconnect 參數，導致無窮重試迴圈
使用者更新到某個 commit 之後的版本，QQBot 的 gateway 進入無窮重試迴圈，無法連線，錯誤訊息顯示 QQAdapter.connect() 收到未預期的關鍵字參數 is reconnect。此 issue 為開放狀態，處理狀態為 workaround。
[Bug] macOS 桌面版：非預設 profile 會看到 default profile 的 session 與 cron（跨 profile 資料外洩）
在 macOS 桌面版切到自建 profile（例如只設定 WeChat 的 rucy）時，UI 仍會顯示屬於 default profile 的 sessions、通訊頻道與 cron jobs，屬於 UI 層的跨 profile 資料外洩。
[UX] CLI 輸入框新增 Shift+Enter 換行支援
此 issue 提議在 Hermes CLI/TUI 的輸入框中新增 Shift+Enter 作為換行按鍵。目前官方支援的多行輸入按鍵是 Alt+Enter 與 Ctrl+J，Enter 用於送出訊息；作者認為對許多終端機使用者來說，Shift+Enter 是更直覺、更符合聊天 App 習慣的「換行不送出」按鍵，並提議
追蹤 Issue：Windows 桌面版 GUI 產生子行程時，主控台視窗（cmd/conhost/git/gh/powershell）會閃現
此為彙總約 25 篇回報的追蹤 issue，說明 Windows 桌面版 GUI 在無視窗的 pythonw.exe 後端呼叫 cmd.exe、git.exe、gh.exe、powershell.exe 等主控台子行程時，因未加上無視窗旗標，導致黑色主控台視窗閃現，有時甚至持續閃現；內文整理了曾嘗試並回退的修復方式，以
功能請求：危險本機操作的核准規則可自訂（approval-locked command patterns）
Hermes 已有危險指令核准機制，但目前需要核准的指令樣式寫死在 tools/approval.py 原始碼中，使用者無法在不修改原始碼的情況下把特定於自己環境的指令（例如重啟 gateway 服務）標記為需要核准，也無法針對非系統層級危險、但在特定部署中具破壞性的操作設定規則。
feat(dreaming)：在 CLI 與 gateway 全面導入穩定的 Dreaming 反思模式
此 issue 描述把 Dreaming 打造成 Hermes 的正式一級功能，讓對話總結、分析與洞察產生這個反思模式能在 CLI 與 gateway（包含 Telegram 傳送）兩種執行路徑上穩定運作。內容包含讓 Dreaming 在正確的 runtime 設定下執行、不依賴工具呼叫、即使底層 agent 發生錯誤
[Bug] context 壓縮在第 2、3 次觸發時報 Jinja 模板錯誤並毀損 session
用 LMStudio 自架模型時，內部 context 壓縮流程在第二或第三次觸發時，會因 No user query found in messages 的 Jinja 模板錯誤而崩潰，session 毀損、對話連續性遺失，只能開新 session。此 issue 已關閉。
[Bug] Telegram 本地 Bot API 的影片檔快取失敗（method not found），變成空白訊息
Telegram gateway 配本地 telegram bot api local 伺服器時，iOS .MOV 等影片文件下載會報 InvalidToken: Not Found: method not found。檔案其實已在本地儲存，但 Hermes 沒把路徑映射回可讀檔案，結果是空白的使用者訊息或只剩 met
[Bug] 遠端 dashboard session 因 refresh token 輪替重放而反覆過期
從另一台機器（如筆電連區網上的 Mac）存取遠端 desktop / dashboard 時，session 會在下一個 access token 更新窗口附近反覆過期，UI 只提供 Retry / Repair install / Use local 等選項，重新登入後撐不久又斷。
[Bug] 側欄建立 worktree 後，session 同時出現在新 worktree 群組與 main 群組
在桌面版側欄用 fork 按鈕建立 worktree 並開始對話後，新 session 會同時顯示在新 worktree 群組和 main 分支群組底下，離開專案視圖再進來才會恢復正常。
[Bug] 桌面版聊天模型選擇器會寫入全域設定，而非只影響當前 session
回報者指出在 Windows 上使用 Hermes 桌面版狀態列的聊天模型選擇器切換模型時，會直接修改全域的 ~/.hermes/config.yaml，而非按文件所述僅套用於當前 session；預期應該只有透過 Settings → Model 才會變更全域預設值。
[Bug] read_file 少算 total_lines，檔案結尾沒換行時可能默默丟掉最後一行
read file 用 wc l 計算行數，對最後一行沒有換行符的檔案會少算一行；當那一行剛好落在分頁邊界，讀取還會標記完成（truncated=False），模型以為讀完整份檔案，實際上默默漏掉最後一行。
[Bug] Codex 突然開始回傳「empty/malformed response」錯誤
回報者原本使用 openai/codex 模型一整天都正常，但之後每則訊息都收到「Empty/malformed response，切換到 fallback」的錯誤，即使切換其他 OpenAI 模型也一樣，只有 Anthropic 等其他 provider 正常。回報者嘗試重新登入 codex、更新 Hermes、重啟
[Bug] openai-codex provider 在 output[] 為空但串流已回傳文字時，報「Responses API returned no output items」錯誤（gpt-5.4）
使用 openai codex provider 搭配 gpt 5.4 時，即使串流 API 已透過 output text.delta 事件送出文字，Hermes 仍會因為最終 response.output 清單是空的而丟出 RuntimeError，導致 3 次重試全部失敗，且串流文字被重複串接顯示成一段亂碼（如
[Feature] 支援 Agent Client Protocol（ACP）Server 模式：讓 Hermes 能在 Zed、JetBrains、Neovim、Toad 等任何 ACP 相容編輯器中執行
此 issue 提議讓 Hermes 實作 ACP（Agent Client Protocol，由 Zed 提出的開放標準，用於編輯器 / IDE 與 AI agent 之間的通訊，類似 LSP 對語言伺服器的角色）的 agent 端介面，讓 Hermes 能被所有支援 ACP 的編輯器與用戶端使用，不只是 Toad，
功能請求：讓 cron 排程結果能自動注入正在進行中的 gateway 對話 session
Hermes 的 cron 排程工作會在獨立的 session 中執行，執行結果送到 origin/home channel 時只有人類看得到，並附註「agent 無法看到這則訊息」，不會被寫進主要 gateway session 的對話紀錄，導致主 agent 常常不記得自己執行過排程任務，使用者得主動詢問才知道任務
MCP stdio 子程序在長時間運作的 worker 中重新連線時會洩漏，孤兒程序持續累積直到 DB 爭用
長時間執行的 Hermes worker 會累積孤兒 MCP stdio 子程序，案例中單一 worker process 累積了 53 個 mimir 子程序，共佔用 1.4GB RSS 與大量檔案描述符，全部搶同一個 SQLite DB，超過約 50 個子程序後會造成 DB handle 爭用，導致 memory
[Bug] 由 plugin 註冊的 web provider 無法透過 web.extract_backend 選用
回報者指出當 web.extract backend 設定為由 plugin 註冊的 provider 名稱（而非內建後端）時，該設定會被靜默忽略，web extract() 會轉而使用自動偵測到的其他後端，且不會顯示任何錯誤或警告提示使用者。此 issue 已關閉。
[Bug] Envelope 快取版面在工具迴圈中的快取斷點失效，造成 OpenRouter 與 Claude 輸入成本增加約兩倍
回報者指出在 OpenRouter/envelope 快取版面下，system and 3 策略把快取斷點放在 tool 訊息與內容為空的 assistant 訊息上，但這兩種訊息實際上無法有效承載快取標記，導致 agent 迴圈中除了 system prompt 之外的快取斷點全部靜默失效，整段對話每次都以全額輸入價
[Bug] 非同步 LLM 呼叫透過忙碌輪詢阻塞桌面版 WebSocket 主迴圈
回報者最初懷疑 interruptible api call 中 300ms 的忙碌輪詢拖慢主執行緒，但經過超過 4 小時的深入調查，確認真正原因是 Anthropic SDK 串流消費端在解析大量 SSE chunk 時造成的 worker 執行緒 GIL 競爭，導致主執行緒長時間無法取得 GIL。此 issue 已
[Bug] 無互動模式下 MCP OAuth 因快取過期的 token 卡住 gateway 啟動
回報者指出在非互動式的 hermes gateway run 情境下，即使已有 OAuth token 檔案，只要 refresh 或授權失敗就會落入需要瀏覽器回呼的流程，導致 gateway 在訊息平台啟動前卡住整個 callback timeout，且重試會因為連接埠被佔用而失敗。此 issue 已關閉。
[Bug] AsyncSessionDB 讓 /resume 指令壞掉：slash_commands.py 缺少 await
回報者指出 AsyncSessionDB 把 SessionDB 的每個方法都包成非同步協程，但 slash commands.py 呼叫這些方法時忘記加上 await，導致執行 /resume 指令時拋出 TypeError: coroutine object is not subscriptable。此 issue
Bug: multiplex_profiles 設為 false 後仍留下孤兒 session，導致訊息路由到錯誤 profile
把 gateway.multiplex profiles 從 true 改回 false 後，先前在多工模式下建立的 profile session 仍殘留在共用的 state.db 中，gateway 會持續讀到這些過期 session 並把訊息路由到錯誤的 profile，即使該 profile 的 gateway
v0.18.0：QQBot adapter 因缺少 is_reconnect 參數而無法連線
升級到 v0.18.0 後，QQ Bot adapter 啟動失敗並報錯「QQAdapter.connect() got an unexpected keyword argument 'is reconnect'」，導致 gateway 啟動時沒有任何平台連線成功；根因是 gateway/run.py 會傳入 is r
[Bug] Responses API 的壓縮後對話紀錄未正確存入 ResponseStore，導致重複壓縮迴圈
回報者指出使用 POST /v1/responses 搭配 previous response id 串接對話時，一旦觸發上下文壓縮，儲存的 conversation history 會把原始未壓縮紀錄與壓縮後的內容混在一起，導致儲存內容持續膨脹；下一次請求載入這份膨脹過的紀錄後又再次觸發壓縮，形成無限重複壓縮的迴圈。
[Bug] get_env_value_prefer_dotenv 在 get_secret 回傳 None 時直接回傳 None，而不會退回讀取 os.environ
回報者指出 hermes cli/config.py 中的 get env value prefer dotenv() 函式，當 get secret(key) 找不到對應密鑰時會直接回傳 None，而不會如預期退回檢查 os.environ，導致透過 Bitwarden Secrets Manager 注入到環境變數
[Bug] Ollama/GLM provider 對簡短完整回應誤判 finish_reason='length'，觸發多餘的續寫重試
回報者指出當 agent 產生很短但完整的最終回應時，對話迴圈的 finish reason == length 截斷處理邏輯仍會誤判並注入「回應被截斷，請繼續」的系統訊息，導致 agent 在 Telegram 上重複傳送同一則簡短回應 2 到 3 次。
[Bug] 即使設定 platforms.weixin.enabled: false，只要環境變數存在 WEIXIN_* 仍會被忽略並照常連線
回報者指出在 config.yaml 設定 platforms.weixin.enabled: false 後，只要 .env 中仍存在 WEIXIN ACCOUNT ID、WEIXIN TOKEN 等環境變數，gateway 啟動時仍會照常連上微信/iLink 平台，未遵守 enabled: false 的設定。此
[Bug] 訊息路由錯誤：使用者輸入被送到錯的 session
回報者指出在 Hermes TUI 中，於某個 session（Session A）輸入的訊息卻被錯誤地送到另一個 session（Session B），Session B 的 AI 因此回應了原本要給 Session A 的任務，而 Session A 沒有收到任何回應。
[功能需求] TUI/CLI 顯示即時看板任務狀態
回報者指出目前 hermes kanban ls 只能顯示靜態結果，需要手動重新執行才能看到進度，也沒有明顯區分「閒置」與「執行中」任務的視覺提示。提案新增 CLI 的自動刷新模式、TUI 看板中執行中任務的閃爍提示、狀態變化的 Telegram 通知，以及顯示 worker 的最後心跳時間。
[Bug] Thinking 區塊導致 CLI 模式文字回應變空白，並引發無限心跳迴圈
回報者指出使用 DeepSeek 等預設啟用 thinking 區塊的模型時，agent 的文字回應無法傳送給使用者，只會顯示終端機工具的輸出結果；在 cron/心跳排程情境下，因使用者看不到回應而無法給出新指示，導致 agent 反覆觸發、耗費大量 API 費用並形成無限迴圈。
[功能需求] 桌面版音訊播放列加入音量滑桿、播放/暫停與速度切換
回報者指出 Hermes 桌面版的朗讀 / TTS 播放列目前只有狀態文字與停止鍵，缺乏音量控制、暫停/繼續播放與播放速度調整等基本播放器功能。提案新增音量滑桿、播放/暫停按鈕與速度切換三項控制。
feat: 会话添加重要性/优先级标记 (Session Importance)
问题描述 Hermes 目前没有给会话（session）标记重要性或优先级的功能 建议方案 给每条会话增加一个「重要性/优先级」属性 1. 设置重要性 CLI： her
[功能需求] 強化桌寵顯示：加入即時執行狀態（參考 Petdex Desktop）
回報者指出 Hermes 目前的桌寵功能只依 5 種基本狀態切換表情，沒有顯示即時執行資訊。提案希望新增浮動視窗模式、顯示目前執行工具與進度、token 用量與耗時的即時狀態氣泡，並讓桌寵能對跨 agent 工具產生反應，同時擴增至 9 種以上可自訂狀態。
[Bug] unbroker 技能實測發現：web_extract 功能受限、broker 涵蓋範圍缺口、subagent 紀錄可靠度與缺少的 broker 參考資料
回報者實際對一名菲律賓籍對象執行 unbroker 技能，掃描涵蓋 51 個資料仲介商但遇到多個結構性問題：文件宣稱 web extract 可直接讀取頁面，但實際後端是僅能搜尋的 DuckDuckGo，無法擷取任意網址內容；51 個仲介商中有 12 個因資料中心 IP 被反機器人機制擋下；部分仲介商缺少對應的 JSO
[Bug] Hermes 在 Windows 上使用系統內建的 Node.js，而非自帶的 Node.js
回報者指出更新 Windows 系統自身的 Node.js 版本後，Hermes 會使用系統的 Node.js 而非內建版本，因版本不同導致終端機視窗持續閃爍。預期行為是 Hermes 應一律使用其內建的 Node.js。
[功能需求] 希望桌面版能新增介面字體大小調整功能
使用者反映桌面版 Hermes 的介面字體太小，且沒有調整選項，因此提議新增字體大小調整功能，方便視力不佳的使用者使用。
[功能需求] 新增 CLI 指令與 agent 協助的 session 封存/整理功能
回報者是重度使用者，累積數百個 session 後 session search 結果變得雜亂，希望新增封存、分類標籤、清理與匯出 session 的 CLI 指令，並讓 agent 本身也能協助使用者整理 session 記錄，而不只是手動管理。
fix(dashboard-auth): Dashboard 設定 basic auth 時，GET /auth/login?provider=basic 回傳 HTTP 500
當 dashboard 設定為使用內建的 basic auth（帳號密碼）provider 時，透過 OAuth 風格的 GET /auth/login?provider=basic 重新導向會回傳 HTTP 500，而不是顯示密碼登入表單；根因是 auth login() handler 對所有 provider 都
redact: 敏感資訊遮罩規則有漏洞，SendGrid API key 只遮住 key-id 段，key-secret 段仍明碼外洩
agent/redact.py 的 SendGrid 遮罩正規表示式在遇到第二個句點就停止匹配，導致三段式 SendGrid API key（SG.<key id .<key secret ）中真正包含密鑰熵值的 key secret 段完全沒有被遮罩，會在 log、對話紀錄等地方以明碼留存。回報者提出加入可選的第三段
長時間對話經過多次 context compaction 後，訊息序列變成無效格式，導致 session 永久失效（DeepSeek）
trajectory compressor 在執行 context compaction 後，會產生不合法的訊息序列（孤兒 tool 訊息），造成 DeepSeek API 以 HTTP 400 拒絕請求，錯誤訊息為「tool 角色訊息必須回應前一則帶 tool calls 的訊息」；長時間運行、累積大量工具呼叫訊息的
[Feature] 建議 Hermes CLI/TUI 支援滑鼠操作與選取文字自動複製（比照 Claude Code）
提案新增兩項目前 Hermes CLI/TUI 缺少、但 Claude Code 已有的體驗：滑鼠支援（點擊移動游標、展開收合區塊、捲動）以及選取文字自動複製到系統剪貼簿，藉此減少操作 CLI 時的摩擦。
[Setup] hermes update 會讓 .git 目錄無限膨脹，長期運行的 VPS 磁碟空間被吃光
每次執行 hermes update 都會新增 git object 但從未清理舊物件，長期運行數月後 .git 目錄膨脹到 884MB（29GB 磁碟），加上 npm 快取與 session 檔案，磁碟使用率一度達 86%，讓後續升級變得有風險。
Signal 群組訊息通過 adapter 過濾後，仍被 _is_user_authorized 擋下
已通過 Signal adapter 層過濾（正確群組 + 有效 mention）的群組訊息，會在 authz mixin.py 的授權層被判定為未授權，因為 platform group user env map 字典中沒有列出 Platform.SIGNAL 對應的環境變數，導致寄件者只會被拿去跟 SIGNAL A
cronjob deliver=origin 不稳定：Yuanbao WS断连时投递失败
现象 在 Yuanbao 平台创建 cronjob 时用 deliver=origin ，投递时好时坏。看日志基本就是两种结果： 1. 正常投递（live adapter 路径命中） 2.
[Bug] Bedrock 的 /model 選擇器會顯示無法使用的裸模型 ID，選到後還會被永久儲存
Bedrock provider 的 /model 選擇器會同時列出裸 foundation model ID 與對應的 inference profile ID，但在 on demand 帳號下裸 ID 無法呼叫；一旦選到裸 ID 會被寫入 config.yaml 的 model.default，導致之後每次呼叫都收
[Feature] 建議為 BlueBubbles 新增產品層級的「訊息投遞健康檢查」，而非只看 process 是否存活
BlueBubbles/iMessage 可能進入一種局部假健康的狀態：Messages.app 顯示已讀、gateway process 仍在跑、連接埠也開著，但 Hermes 實際上收不到任何 iMessage webhook 也不會回應。提案希望新增產品層級的健康檢查與分類後的復原機制，而非只依賴現有零散的個案修
[Bug] Matrix bot 能同步舊訊息，但完全不回應新訊息（無任何 log 輸出）
使用者設定 matrix.org bot 帳號後，bot 能成功登入、加入房間並同步舊訊息，但收到新訊息時完全沒有回應，即使開啟 DEBUG 等級的 log 也沒有任何輸出，改用 Access Token 登入方式同樣無效。此 issue 已關閉，狀態為已修復。
[Feature] 建議讓 local backend 的 prompt 前綴保持「熱機」，避免每次都重新做 cold-session prefill
本機 llama.cpp / vLLM 類伺服器只有在新請求與先前快取狀態的 prompt 前綴完全一致時才能重複使用 KV 快取，否則每個新 session 都要重新處理共用前綴（通常 1~2 萬 token），造成延遲。提案是新增一個選用的 gateway watcher，定期重放最小化請求讓共用前綴保持在快取中；
[Feature] 建議讓 agent 能「附加」到一個開啟中的桌面視窗，直接觀看與操控
目前若要讓 assistant 操作某個桌面應用程式，使用者必須用文字描述視窗與其中的控制項，對記不住選單路徑的使用者（含輔助科技需求者）幾乎不可行。提案新增「附加 app / 視窗」功能，讓使用者選取一個開啟中的視窗後，agent 可透過 UI 自動化側車程式觀看並操控它；作者提到此功能已在另一個 PR（ 53852
[Feature] 建議推出 Excel 側車功能，讓使用者能在即時開啟的活頁簿中直接與 Hermes 對話
目前沒有辦法讓 assistant 直接操作即時開啟的 Excel 活頁簿，重度使用試算表的使用者（如會計、財務）必須先把資料匯出或貼出再貼回結果。提案建立 apps/excel/ 側車，透過 Office.js 工作窗格與零相依的 Node 橋接程式連到既有的 api server，並嚴格限制只能透過結構化 JSON
內容已隱藏的 issue（原始標題已被移除）
此 issue 的標題與內容已被隱藏，無法得知原始回報內容。此 issue 已關閉，標記為 invalid。
[Feature] 建議讓 MoA 參考顧問模型可各自設定獨立的 reasoning_effort
在 MoA（Mixture of Agents）架構中，參考模型只是提供建議，aggregator 只讀取它們的最終回答，但在推理模型上大部分運算時間都花在 aggregator 看不到的內部思考過程；目前沒有辦法只調整參考顧問的推理強度而不影響 aggregator。提案新增一個可選的 per slot reason
[Feature] 建議加入「先驗證才能宣稱完成」的行為規範與未驗證完成宣稱偵測器
目前 agent 常在沒有實際驗證的情況下就宣稱任務完成或可運作，缺乏引導 agent 先驗證再宣稱完成的機制，也沒有偵測器能標記出沒有紀錄支持的完成宣稱。提案新增系統提示引導與一個預設只記錄不阻擋的影子偵測器；作者提到此功能已在另一個 PR（ 54576）實作並運作中。
[Feature] 建議在工具呼叫格式錯誤時，強制指定 tool_choice 重試
透過 OpenAI 相容介面連接的本機／量化模型偶爾會產生格式錯誤的工具呼叫（如缺少必要欄位），目前無法修復的呼叫會被靜默替換成空參數執行，或是把錯誤訊息丟回模型重試卻常常重複失敗，浪費對話輪次與 context。提案是偵測到格式錯誤時，在重試時把 tool choice 釘選在該工具上；作者提到此功能已在另一個 PR
[Feature] 建議把目前選擇的 Model 與 Provider 顯示在清單最上方，方便快速存取
使用者反映每次切換模型或 thinking level 時，都要往下捲動清單才能找到目前已選擇的項目，建議讓目前選定的 provider 和 model 自動排到清單最前面。
[Bug] 依文件設定 save_trajectories: true 後，Trajectory 檔案仍未產生
官方文件說明可透過 config.yml 設定 agent.save trajectories: true 來啟用軌跡紀錄檔，但實際測試發現程式碼從未檢查這個設定，導致對話結束後不會產生任何 .jsonl 軌跡檔案，在 CLI、TUI、Gateway 皆是如此。
Desktop 版：discovered_repos 快取在不同 profile 之間互相洩漏
Hermes Desktop 的檔案系統掃描器會把偵測到的所有 git repo 廣播給每個 profile 各自的資料庫，導致切換 profile 時會看到其他 profile 的 repo；根因是 projects.record repos 處理常式用 replace=True 覆寫了整份清單。
[Feature] 建議讓 pre_llm_call 掛勾能拿到「上一輪做了什麼」的紀錄
目前 pre llm call 這個 plugin hook 只能在每輪對話開始前看到「將要做什麼」，卻看不到上一輪實際發生的結果（例如是否切到備援 provider、工具是否一直失敗），因為這些狀態會在下一輪開始時被清空。提案新增一個 turn outcome 紀錄，並透過新的 last turn 參數傳給下一輪的
Anthropic OAuth 用量顯示錯誤：低用量時段被誤算成 100% 已用
/usage 儀表板在 Anthropic OAuth 帳號用量極低（0~1%）時，會誤顯示為 100% 已用、0% 剩餘。原因是程式碼把 API 回傳、本身已是百分比的數值誤判為 0 1 的小數並乘以 100，造成換算錯誤，回報者也指出 Codex 那條路徑並沒有這個問題。
[Bug] minimax-oauth provider 明明是 OAuth，卻仍要求設定 API key 環境變數
當 auxiliary.title generation 設定為 minimax oauth provider 時，Hermes 仍會嘗試讀取 MINIMAX OAUTH API KEY 環境變數，即使該 provider 應該透過 hermes auth add 的 OAuth token 認證，導致標題產生功能報錯
Telegram 連線卡在「attempt 1/8」永遠不動：s6 supervision 下 asyncio.wait_for 逾時機制失效
gateway 的 Telegram adapter 連線時卡在「Connecting to Telegram (attempt 1/8)...」，即使等超過 15 分鐘也不會拋出 TimeoutError，也不會重試。回報者在多種情境下做了診斷測試，發現問題只在特定執行環境（s6 overlay supervisio
Bug：只設定 basic auth 時，Dashboard 自動 SSO 導向會出現 500 錯誤
當 Hermes Dashboard 綁定在非 loopback 位址（如 0.0.0.0）且只設定 basic auth 時，造訪根目錄會被導向 /auth/login?provider=basic 並呼叫 start login()，但 basic auth provider 是密碼制而非 SSO，呼叫時會拋出 N
himalaya skill 的 flag 指令語法在 v1.2.0 已過時，導致指令出錯
內建的 himalaya skill 文件中，flag add / flag remove 指令仍記載舊版的 flag 參數語法，在 himalaya v1.2.0 執行會噴出「unexpected argument flag found」錯誤；正確語法應改為位置參數形式。
訊息送達後的持久化留存機制會繞過 PII / redaction hook（rich-sent index、delivery mirror、API 錯誤傾印）
Hermes 0.18 會在訊息送達（transform llm output 之後）的多個地方把對話內容寫入磁碟，卻都沒有提供 redaction hook 或保留期限（TTL）設定，包括 rich sent index.json 和 delivery mirror。對於使用 PII tokenization plu
Telegram 打字中提示（typing indicator）在 cron job 執行期間會一直顯示，而非只顯示到訊息送達為止
當 cron job 透過 deliver: origin 送訊息到 Telegram 時，打字中提示會持續顯示到整個 cron job 子程序結束為止，而不是訊息送達後就消失。若 cron job 送出簡短通知後還繼續跑背景工作，使用者的 DM 就會持續顯示打字中長達 30 到 60 分鐘以上。
Telegram 打字中提示（typing indicator）在 cron job 執行期間會一直顯示，而非只顯示到訊息送達為止（重複回報）
與 58258 相同的 bug：cron job 透過 deliver: origin 送訊息到 Telegram 時，打字中提示會持續顯示到整個子程序結束，而非訊息送達後就消失，長時間背景工作會讓提示持續 30 到 60 分鐘以上。此 issue 已標記為重複並關閉。
Desktop：已移除的輸入框附件在切換 session 後會重新出現
使用者在 composer 中點擊附件的關閉按鈕移除附件後，附件會先消失，但切到別的 session 再切回來時，被移除的附件卻會重新出現。根因是 removeComposerAttachment() 只更新記憶體中的 nanostore atom，沒有呼叫 stashSessionDraft() 把變更持久化到 lo
Windows 上設定檔中未知的 provider key 觸發大量警告日誌，導致 log handler 鎖死並卡住 serve / gateway 事件迴圈
在 Windows 上，一個無害的自訂 config key 會讓 normalize custom provider entry() 在每次 load picker context() 呼叫時都印出警告，配合 Windows 上 concurrent log handler 的跨程序鎖，大量警告觸發 RuntimeE
[feishu] 移除過時的表格轉純文字 fallback，post(md) 現已支援 GFM 表格
Feishu adapter 偵測到 markdown 表格語法時，會把整則訊息強制轉成純文字類型，連表格以外的格式也一併被去除。這個行為是 2026 04 22 為了避免表格在 Feishu 端顯示空白而加入的，但回報者實測發現用 text 類型送出表格反而完全沒有格式，懷疑目前 post 類型已可正確渲染 GFM
fix(telegram)：reconnect 流程中的 updater.stop() 在 CLOSE-WAIT socket 上會卡住，heartbeat loop 可能卡好幾小時
polling heartbeat loop 偵測到 CLOSE WAIT socket 後會觸發 handle polling network error，但裡面呼叫 app.updater.stop() 沒有設定 timeout。如果底層 TCP 連線卡在 CLOSE WAIT，polling task 會卡在 e
功能請求：完整的 Profile 對等性（Dashboard、Sessions、Cron、路徑隔離）
使用者同時執行多個 Hermes profile，但發現非 default profile 在多個子系統中被當成次等公民對待，例如 cron job 會寫到錯誤 profile 的目錄、dashboard 功能只看得到 default profile、Desktop App 完全忽略非 default 的 sessio
Windows 上 hermes desktop 啟動器不會與終端機分離，關閉終端機會殺掉 Electron / Python process 並留下殘留程序
在 Windows 上，hermes desktop 會把 Electron App 當成繼承父層 PowerShell console 的子程序啟動，導致關閉父層終端機視窗時 Electron App 也會一併被砍掉，而且 Electron/Node 的 stdout/stderr（含編碼不一致造成的亂碼錯誤訊息）會
Bug：profile 的 config.yaml 中空的 YAML key（terminal:）會讓 load_cli_config 出現 TypeError 而當機
當 profile 的 config.yaml 出現 terminal:（有 key 但沒有值）這種空欄位時，YAML 會解析成 None，導致 load cli config() 用 defaults.get("terminal", {}) 拿到的是 None 而非預期的空字典，後續判斷式因此拋出 TypeError
Bug：停用 coding toolset 會連帶悄悄移除已明確啟用的 terminal / file 工具，導致模型收到 Tools: 0
當 config.yaml 的 agent.disabled toolsets 包含複合 toolset（如 coding）時，Hermes 會扣除該複合 toolset 底下所有工具，即使使用者已明確啟用 terminal 和 file 這兩個子 toolset，最終結果是模型收到零個工具，過程中沒有任何警告，UI
Bug：用 /model xxx --provider xxx 切換模型時，即使沒加 --global 也會自動改寫 config.yaml
使用者透過飛書（feishu）與 hermes agent 對話，發送 /model xxx provider xxxx 切換模型時，agent 會自動把這個模型與 provider 設成 config.yaml 的預設值（並回覆「Saved to config.yaml ( global)」），但使用者並未輸入 gl
Subagent 委派（delegation）忽略設定，永遠使用 credential pool 裡的 glm-4-flash 模型
即使將 delegation 設定為指定的 provider / 模型（如 NVIDIA NIM 的 deepseek v4 flash），subagent 仍完全忽略該設定，永遠使用 credential pool 中的 glm 4 flash（Zhipu）。issue 附上 5 次測試皆重現此問題，包含 deleg
send_message_tool 在裸平台目標下遺失 home.thread_id，訊息會跑到 DM lobby 而非設定的主題
使用 hermes send to telegram（未指定 chat id）時，程式只複製 home.chat id，卻遺漏 home.thread id，導致在 Telegram DM topic mode 且已設定 TELEGRAM HOME CHANNEL THREAD ID 的情況下，所有裸目標的 herme
iOS 原生 App 的 session 篩選器應顯示各來源的完整總數，而非目前已載入頁面的計數
iOS 原生 App 的 sessions 側邊欄目前依已載入到 client 的 session 數量顯示篩選 chip 計數，在分頁載入下這個計數會產生誤導。issue 要求改用後端提供的完整總數，並將 mobile native / ios native / macos native 等別名統一歸類為 Nativ
Bug：使用本機模型端點時，TUI 非正常結束後 Desktop 啟動會無限卡住
當使用者在 TUI/CLI 用 /model 指向本機 loopback 端點（如 llama.cpp / ollama / vLLM）後非正常結束（Ctrl C、關閉終端機、當機等），對應 session 在 state.db 中的 ended at 會永遠是 NULL。下次啟動 desktop 時，後端會把這個未結
iOS 原生 App 的 sessions 列表應該自動無限捲動載入更早的分頁，而非需要手動按鈕
iOS 原生 App 目前仍仰賴一個明顯的「載入更早 sessions」按鈕，捲動並不會自動載入下一頁。issue 要求捲動到底部時自動請求下一頁，並加上防止重複載入與到底停止的保護。此 issue 已修復並關閉。
Desktop GUI 每 10 秒就會重新啟動一個 CLI process，導致重複的 plugin discovery
Hermes Desktop GUI 每約 10 秒就會產生一個新的 CLI process，每次都執行完整的 plugin discovery 流程，造成 agent.log 大量洗版以及不必要的 CPU / 磁碟資源消耗。
壓縮功能當機：_summarize_tool_result 出現 AttributeError 'dict' object has no attribute 'count'
當 write file 工具結果的 content 參數被解析成 dict 而非字串時，context compression 會在 summarize tool result 拋出 AttributeError 而當機，導致壓縮功能完全失效，session 持續增長直到超過 context window。
Langfuse 追蹤（trace）在未設定 observability.service_name 時顯示 service.name=unknown_service
啟用 Langfuse observability plugin 但未設定 service name 時，OpenTelemetry 會 fallback 成 unknown service，導致所有 agent 的 trace 混在同一個無法辨識的來源下。issue 提議讀取 config.yaml 的 observ
web_search / web_extract 失敗時完全沒有提示，使用者可能不知道搜尋功能已失效
當未設定任何 web backend API key 時，web search 和 web extract 會靜默失敗或回傳空結果，不會提示使用者搜尋功能不可用，可能導致使用者數週都不知道核心搜尋功能已失效。issue 建議在失敗時回傳明確錯誤訊息與解決步驟。
[提案] 把 Hermes 當作 Gotong 治理工作流中的個人 agent 層
Gotong 專案作者提出整合構想：Hermes 繼續當個人 agent / 記憶 / 推理層，Gotong 提供外圍的治理協作基底（任務派發、人工審批、append only 紀錄、MCP/A2A 邊界）。屬於外部專案的整合提案。
[Bug] context 壓縮打斷 tool 訊息鏈，嚴格 provider 回 400（tool 訊息缺少對應 tool_calls）
長 session 觸發 context 壓縮時，可能把帶 tool calls 的 assistant 訊息壓掉、留下孤兒 tool 訊息，違反 OpenAI Chat Completions 契約。DeepSeek 等嚴格 provider 會回 HTTP 400，寬鬆的 provider 可能默默吞掉。此 iss
[功能請求] 執行任務前自動載入相關 skills
回報者指出 agent 裝了很多 skill 卻常常忘記載入：遇到任務不先查 skill，而是憑空猜參數或反問使用者。根因是 skill 是被動的，缺少「分析請求並提示相關 skill」或自動注入 skill context 的機制。
[Bug] xAI grok-4.3 在 MCP 工具呼叫中丟失選填多行字串參數，AgentMail 寄出空白信
回報者發現在 provider xai oauth 配 grok 4.3（codex responses 模式）時，AgentMail 的 send message 每次都寄出主旨與內文都空白的信，但工具回報成功，agent 無法自我修正。此 issue 由 AI agent 調查並代表帳號擁有者提交，附可重現的證據。
[Feature] 新增 Searxng 作為預設網頁搜尋 provider 之一（與 Firecrawl、Tavily 並列）
回報者希望在 web tools.py 以及 setup / 環境變數設定中加入 Searxng，作為 Firecrawl、Tavily 等既有 provider 之外的另一個選項，並附上偵測 SEARXNG BASE URL 環境變數與後端選擇邏輯的程式碼草稿。作者也提到未來想加 reranker 步驟，但目前尚未開
[設定問題] OSError: [Errno 22] Invalid argument，prompt_toolkit 造成 hermes chat 崩潰
使用者啟動 hermes chat 後，畫面顯示歡迎訊息並提示 tirith 安全掃描器不可用，接著程式直接印出 Goodbye 並拋出例外，追溯訊息顯示是 asyncio selector 在處理檔案描述子時發生 KeyError，接著在 main.py 中引發另一個例外導致程式崩潰。此 issue 已關閉，狀態為已
[Feature] 讓每個 skill 可以指定切換不同的 LLM model
此 issue 指出目前所有 skill 都繼承主 agent 全域設定的 LLM model（透過 config.yaml 或 hermes model 指令），不論 skill 複雜度高低都用同一個 model，導致使用者為簡單、結構固定的 skill（如 gif search、find nearby、arxiv）
安裝程式卡在「Install ripgrep / ffmpeg [Y/n]」提示，鍵盤輸入無反應
回報者在 Windows 11 上以 curl | bash 安裝 Hermes 時，安裝程式進行到是否安裝 ripgrep 與 ffmpeg 的確認提示後卡住，終端機不接受任何鍵盤輸入（Enter、Y、n 皆無效），回報者已嘗試重開終端機、換終端機、重跑安裝程式皆無效。
新增 mempalace 外部記憶體支援
此 issue 提議為 Hermes 加入 mempalace 模組（連結至 milla jovovich/mempalace repo），提供結構化的外部記憶功能，讓 agent 能擁有超越 context window 的持久化、可查詢記憶，支援長時間任務與跨 session 的連續性。提案包含可插拔的儲存後端（預
Bug：用 Anthropic Claude 訂閱驗證時，Hermes 回報「額度已用完」，即使重啟或重新登入也一樣
此 issue 回報：一開始用 Claude 訂閱驗證裝好 Hermes 後可以正常運作，但過一段時間後開始持續收到 HTTP 400：「You're out of extra usage. Add more at claude.ai/settings/usage and keep going.」，即使重啟 Herme
功能請求：Mattermost adapter 應把 COMMAND_REGISTRY 註冊為原生 slash command 並支援自動完成
Mattermost 手機版客戶端會攔截任何以 / 開頭的訊息，當作原生 Mattermost slash command 執行，導致使用者在與 Hermes bot 的私訊中輸入 /approve、/yolo、/help 等指令時會被 Mattermost 回報「找不到指令」，即使加上前導空白也無法正常運作，使得 M
checkpoint_manager 的 subprocess.run cwd 可能指向不存在的目錄，導致 FileNotFoundError
回報者指出 tools/checkpoint manager.py 的 run git() 在呼叫 subprocess.run 時使用 Path(working dir).resolve() 當作 cwd，但在 Linux/macOS 上即使目錄不存在，resolve() 仍會執行成功，導致 subprocess.r
[Bug] 使用 zai/glm-5.1 對話時出現 UnicodeEncodeError
使用者在使用 zai 服務商的 glm 5.1 模型對話時，API 呼叫連續三次都因 UnicodeEncodeError 失敗，錯誤訊息顯示 ascii 編碼無法處理特定位置的字元，重試三次後最終失敗。此 issue 已關閉，狀態為已修復。
[Feature] 延遲載入工具 Schema：用兩階段注入減少 Token 開銷
此 issue 指出目前每次 API 呼叫都會把所有啟用 toolset 的完整工具 schema 一次注入，在啟用 50 多個工具（terminal、file、web、browser、delegate、vision、memory 等）時，每次呼叫大約會多耗 3,500 到 5,000 個 token，即使該次對話根本
[Bug] 透過飛書/Lark gateway 核准危險指令時出現錯誤碼 200340
透過飛書 (Feishu/Lark) gateway 使用 Hermes 時，當需要人工核准的危險指令（例如刪除保護路徑下的檔案）觸發核准卡片後，點擊「Allow Once」「Session」「Always」「Deny」任一按鈕都會失敗並顯示錯誤碼 200340，任務因此卡住；同樣情境下改用 CLI/TUI 模式核准則
[Bug] 錯誤訊息：Response truncated due to output length limit（回應因長度限制被截斷）
這個 issue 指出使用 Hermes Agent 進行 CLI 聊天或 gateway 訊息（Telegram/Discord/Slack）時，產生長篇回應常會遇到「Response truncated due to output length limit」錯誤，導致回應中途被截斷、破壞對話流程。此 issue 已
訊息 Gateway 支援 Matrix 協定
回報者希望 Hermes 能原生支援 Matrix 協定作為訊息 gateway，讓使用者可以透過任何 Matrix 客戶端（如 Element、FluffyChat）並連到自架的 homeserver 與 agent 互動，但表示自己目前沒時間貢獻程式碼實作。此 issue 已關閉。
開放 issue 數量已超過 1000 個
使用者指出專案的開放 issue 數量已超過 1000 個，詢問社群是否有辦法控制這個成長趨勢，並提及另一個專案 OpenClaw 的開放 issue 數已超過 11000 個作為對比。此 issue 已關閉。
Hermes agent 經常「忘記」自己有 shell 存取權限
回報者指出使用 ChatGPT/Codex 時，Hermes agent 會誤以為自己沒有 shell 存取權限，需要使用者不斷提醒才會執行本可直接用 shell 完成的任務，回報者質疑是否需要手動把「你有 shell 存取權限」寫進記憶體才能解決。
[Feature] 原生支援多 Agent：單一 Gateway 服務多個具名 Agent
此 issue 提議讓 Hermes 支援原生多 agent 架構，讓單一 gateway process 能同時服務多個具名 agent，各自擁有獨立的 session、人格、記憶與工具設定，類似 OpenClaw 的多 agent 架構。作者指出目前 Hermes 是單一 agent 系統：session key
[Bug] API server adapter 未遵守 display.show_reasoning 設定
這個 issue 指出 Hermes 的 display.show reasoning 設定在 CLI 與訊息 gateway adapter 會正確顯示模型的推理過程，但 API server adapter（gateway/platforms/api server.py）完全沒有實作這個邏輯，導致透過 OpenAI
Feishu 外掛的兩個問題：授權按鈕錯誤，以及 topic 群組中錯誤建立新主題
回報者指出兩個 Feishu 相關問題：點擊 Feishu 授權卡片上的按鈕會出現錯誤；在已開啟 topic 的 Feishu 群組中，部分 Hermes 訊息仍會另外建立新的 topic 回覆，而非在既有 topic 內回覆。
[Bug] 使用原生 Gemini 服務商時出現 HTTP 400「收到多組驗證憑證」錯誤
使用者在 ~/.hermes/.env 設定 GEMINI API KEY 使用內建 Gemini 服務商時，Google AI Studio 端點回傳 HTTP 400 錯誤；改用一般 Google Cloud API key（AIzaS 開頭）而非 Vertex AI 產生的金鑰（AQ.Ab8 開頭）才能正常運作。
所有 OpenRouter 模型都回傳 HTTP 400，但用 curl 測試同一組 API key 正常
回報者指出在全新安裝的 Hermes（WSL2 Ubuntu）中，所有 OpenRouter 模型呼叫都回傳 HTTP 400，hermes doctor 也顯示 OpenRouter API 為 HTTP 400，但用同一組 API key 以 curl 測試則能拿到正常回應。
功能請求：支援同一個 Telegram 帳號用多個 bot 連到同一個 agent（各自獨立 session）
目前 Hermes 只能透過 /background 讓同一 agent 平行處理多個任務，但這個方式複雜任務下達麻煩、無法中途互動、且仍是單一佇列序列執行。此 issue 提議讓同一 Telegram 帳號下的多個 bot 各自連到同一個 gateway/agent，建立獨立 session，讓使用者能同時對不同任務
功能請求：跨平台 Session 交接（CLI ↔ Telegram ↔ iMessage）
目前在 CLI、Telegram、iMessage 等不同平台使用 Hermes 時，各平台的 session 是各自獨立、互不相通的，使用者無法把在 CLI 進行到一半的工作接續到 Telegram 上，反之亦然。此 issue 提議建立內建的「交接」機制，讓使用者能在平台間保留任務描述與進度等狀態並無縫接續。
功能提案：跨 session 搜尋與自動壓縮的持久化 Session Memory
此提案指出 Hermes 目前的 session memory 是暫時性的，session 結束或 gateway 重啟後對話脈絡就會遺失，導致使用者必須不斷重新說明環境、偏好與專案狀態；提案建議建立一個以 markdown 檔案為單位、可搜尋且能自動壓縮的持久化「Vault」式 session memory 系統。
功能請求：在 Z.AI Coding Plan 中新增 glm-5.1 模型
此 issue 要求在 Hermes 的 Z.AI (GLM) provider 中新增 glm 5.1 模型，讓使用 Z.AI Coding Plan 的使用者能選用這個比 glm 5 turbo 更新的模型。此 issue 已關閉。
[Feature] 完整 Docker 化部署
回報者目前的理解是 hermes agent 主任務是從主機端 CLI 啟動，並支援用 Docker 當作 AI agent 執行工作的沙箱。回報者希望能有完全 Docker 化的部署方式，讓主任務本身也跑在容器裡，透過 http/ws 和已 Docker 化的 agent 沙箱溝通，並附上自己用 Nomad/Cons
功能請求：Slack 平台改用 Block Kit 的 markdown block type，取代舊版 mrkdwn
這個 issue 指出 Slack adapter 目前用舊版 mrkdwn 格式傳送訊息，不支援表格，且需要手動把標準 markdown 轉換成 Slack 的舊格式語法。Slack 現已提供原生支援標準 markdown（含表格）的 markdown block type，提案改用新格式，並同時修改 send()、
我怎么知道它是多智能体协作还是？？
如题
Docker 映像檔缺少 'dashboard' 指令（最新映像檔無法使用 web UI）
nousresearch/hermes agent:latest 這個 Docker Hub 映像檔沒有包含 dashboard（或 web）子指令，導致在 Coolify 等容器化環境中無法執行 web UI。回報者指出該指令已存在於 main 分支原始碼中，推測 Docker Hub 映像檔是用較舊的 commit
功能請求：新增 Nix Home Manager 模組供使用者層級安裝
這個 issue 指出 Hermes Agent 目前只在 NixOS 系統層級支援宣告式設定，缺乏使用者層級（Home Manager）的宣告式安裝方式。提案新增 Home Manager 模組，讓使用者可用 Nix 宣告式設定 Hermes Agent。
我感觉并没有学习也没有提升到
不是说是学习的框架吗？怎么那么烂的？？
請求啟用 GitHub 私密漏洞通報功能
這個 issue 請求維護者為此 repo 啟用 GitHub 的私密漏洞通報（private vulnerability reporting）功能，以便回報者能私下分享一項安全性問題。此 issue 已關閉。
功能請求：整合 Tailscale serve 提供安全遠端存取
這個 issue 提議讓 Hermes 支援 Tailscale serve，讓使用者能透過私有 mesh 網路以零設定 HTTPS 方式安全存取本機 Hermes API server / Open WebUI，不需公開對外開放連接埠或架設反向代理。提案列出從純文件說明到 config/CLI 整合等不同實作程度的選
feat(delegation)：delegate_task 支援自訂 agent profile，打造客製化編排 harness
此 issue 提議讓 delegate task 能從 config.yaml 中定義的具名 agent profile 產生子 agent，讓使用者不用改 Hermes 核心就能打造類似 oh my opencode slim Pantheon agents 的客製化編排 harness。作者指出目前 delega
功能提案：單一 daemon 支援多 agent，各自獨立 workspace 與記憶，依 topic 隔離
提案指出 Hermes 目前每個 agent 都需要獨立的 profile 與 gateway 行程，若要同時跑多個不同用途的 agent 就要開多個 process，各自佔用資源；提案參考 OpenClaw 的單一 daemon 架構，讓多個 agent 共用同一個 daemon 行程，各自擁有獨立 workspac
Feishu 訊息中的 Markdown 表格無法正確顯示
回報者指出 Feishu 不支援在訊息中渲染 markdown 表格，表格會以未轉換的原始文字顯示；因為 gateway/platforms/feishu.py 的 build markdown post payload() 只是把原始 markdown 包進 md 標籤，而 Feishu 的 md 標籤不支援表格語法
[討論] 為什麼移除了 smart_model_routing？希望能夠恢復
此 issue 是一則討論串，詢問 2026 年 3 月新增、隔月即被移除的 smart model routing 功能（會將短小簡單的訊息自動路由到便宜模型）為何被整個移除，而不是保留為 opt in 選項；作者認為許多使用者仍認為此功能對成本控制有幫助，希望能說明移除原因或考慮以 opt in 形式恢復。
[Bug] 更新後無法啟動
此 issue 標題回報更新後應用程式無法啟動，內文僅附上一張截圖，未提供文字描述。
[功能需求] 透過 pre_llm_call 的 model override 實現依任務類型的逐輪模型路由
此 issue 提出功能需求：希望 plugin 能依照每一輪傳入的訊息內容，選擇該輪要使用的模型（例如寫程式用程式導向模型、簡單問題用快速便宜模型、分析用強推理模型）。作者指出目前 pre llm call 只能把內容注入使用者訊息、無法改變模型，pre gateway dispatch 也只能 skip / rew
[功能需求] 提供正式的更新日誌（changelog）畫面
此 issue 提出功能需求：目前桌面版更新時只顯示幾則更新說明，底部再顯示『還有 25 項更新』的字樣，作者希望能有一個頁面可以捲動 / 翻頁查看所有累積的更新內容，而不是只看到最新的一部分。
[Bug] 新增指定的 address model API 時出現錯誤，無法運作
此 issue 標題回報使用者在嘗試新增某個 address model API 時遇到錯誤且功能無法運作，內文僅附上一個外部文件連結與一張截圖，未提供進一步文字說明。
security.redact_secrets 會改寫實際執行的指令內容，而不只是遮蔽 log
此 issue 回報啟用 security.redact secrets: true 時，看起來像機密的字串會被替換成 ，但這個替換發生在真正交給 shell / interpreter 執行的指令文字本身，而不只是在 transcript 和 log 中。任何合法帶有類似密鑰格式字串的指令（例如 Authorizat
HERMES_CRON_SESSION 被設成行程全域變數，導致互動式 gateway session 誤套用 cron 核准政策
此 issue 回報 cron/scheduler.py 會將 os.environ["HERMES CRON SESSION"] 設為行程層級的全域變數。由於 cron 工作是在長駐的 gateway 行程中執行，此變數一旦被第一個 cron job 設定，就會持續影響到後續所有互動式 session（例如使用者正在
Hermes Desktop 的 Docker 執行後端切換沒有狀態顯示、健康檢查或設定引導
此 issue 提出功能需求：在 Hermes Desktop 的進階設定中選擇 terminal.backend: docker 後，介面沒有連線狀態顯示、沒有『測試連線』功能，若 Docker Desktop 未安裝或 daemon 未啟動，第一次呼叫 terminal / file / execute code
[Bug] macOS gateway 陷入重啟迴圈：launchd plist 寫死 --replace，SIGTERM 結束碼錯誤
此 issue 回報在 macOS（Sequoia 15.7.3）上，當外部觸發（如 launchctl kickstart k）殺掉 Hermes gateway 行程後，gateway 會陷入約 8 10 秒一次的無限重啟迴圈，單一 session 中記錄到超過 400 次 SIGTERM 事件。
Session JSON transcript 匯出功能未過濾 PII（email / SSN 等）
此 issue 回報 agent/redact.py 目前只遮蔽密鑰、token 等機密資訊，但沒有涵蓋一般 PII（如 email 或身分證字號）。作者指出 state.db 本身不做遮蔽是設計上合理的，但選擇性開啟的 JSON transcript 匯出功能（sessions.write json snapshot
[功能需求] Dashboard 檔案頁面支援整個資料夾下載 / ZIP 匯出
此 issue 提出功能需求：目前 Hermes web dashboard 的 Files 頁面只能逐一下載單一檔案，無法整個資料夾（含子目錄）一次下載。作者以一個含 6,275 個檔案、24 個子目錄的備份資料夾為例，說明目前的做法在實務上不可行。
[功能需求] 執行任務期間即時顯示 context window 使用量到桌面版/TUI 狀態列
此 issue 提出功能需求：目前 desktop 與 TUI 狀態列的 context window 使用量儀表只在 message.complete 時才更新，導致長時間的 agentic turn 期間畫面會凍結在前一輪的數值，直到結束才跳動一次。作者指出底層資料其實在每次內部 API 呼叫後都已更新，只是 ga
dashboard-auth.log 沒有輪替機制，檔案會無限成長
此 issue 回報 hermes cli/dashboard auth/audit.py 在寫入 dashboard auth.log 時使用純 append 方式，沒有設定檔案大小上限或輪替（rotation），與系統中其他 log（如 agent.log、errors.log）不同。作者指出在高流量的 dashb
[功能需求] 為 gateway 新增 Linear 平台整合
此 issue 提出功能需求：希望在 gateway 新增 Linear 平台的 adapter（gateway/platforms/linear.py），讓使用者可以直接在 Linear issue 留言中 @提及 agent 來調查問題、彙整相關 issue、更新狀態或提問，不需要切換到 Slack / Teleg
輔助 fallback chain 應該重用 fallback_providers 設定，而不是維護另一份寫死的清單
此 issue 指出 Hermes 目前維護兩套互不相通的 fallback 機制：使用者在 config.yaml 設定的 fallback providers，以及給 compression、vision、title、web extract、curator 等輔助任務使用、寫死在程式中的另一份 fallback 清
Windows 安裝腳本 install.ps1 直接執行時報錯,無法同時使用 -Ensure 與 -Stage
Windows 安裝腳本在裸執行時參數衝突,官方標為 P1,代表這是會擋住安裝且目前沒有官方 workaround 的重大問題。
內建 skill 同步後會留下過期的 .bak 備份資料夾
Skill 同步留下殘留備份目錄,屬於 P3 低優先的清理性問題,不影響功能。
修正（vision）：_resolve_single_provider 的 kwargs 回歸問題導致 Gemini 額度錯誤時 fallback_chain 靜默失敗
此 issue 回報當 Gemini 回傳 HTTP 429（額度用盡）時，vision fallback chain 嘗試透過 resolve single provider 建立 xiaomi tp、ollama 等備援 provider 的 client，但該函式沒有正確把 explicit base url /
Signal RPC 讀取回應內容沒有大小上限
此 issue 回報 SignalAdapter. rpc() 會把 signal cli rest api 回傳的完整 JSON 回應讀進記憶體才解析，若 Signal bridge 設定錯誤、有 bug 或被惡意操控，可能回傳過大的 JSON 造成 gateway 行程被迫緩衝過量資料。此 issue 已關閉並標記
🎁 來自 Inversion Labs 的『禮物』：宣稱提供抗量子加密模組（已標記為 invalid）
此 issue 是一則以『禮物』為包裝的推銷文，發送者自稱來自 Inversion Labs，宣稱提供一個抗量子加密（quantum resistant cryptography）模組，內含後量子加密、agent 對 agent 通訊安全通道、金鑰封裝機制等功能敘述。此 issue 被標上 invalid 標籤。
Slack 過期的 thread session 會壓抑 reset 後應該重新帶入的 thread context
此 issue 回報 SlackAdapter. has active session for thread() 只檢查 session key 是否存在於 SessionStore. entries，並沒有考慮該 session 是否已依 reset 政策（daily / idle / suspended）過期。實際
Codex 圖片生成的 SSE 串流解析沒有大小上限
此 issue 回報內建的 openai codex 圖片生成 provider 在解析成功的 Codex Responses SSE 串流時，使用 iter lines() 逐行累積 data: 內容，但沒有針對單一 SSE 行、單一累積事件或整體串流內容設定上限，可能導致惡意或異常的串流讓緩衝持續累積直到耗盡記憶體
OpenAI Codex 裝置授權（device-auth）JSON 回應讀取沒有大小上限
此 issue 回報 hermes cli.auth. codex device code login() 與 dashboard 的 Codex 完整登入 worker，在讀取 OpenAI Codex 裝置授權流程回傳的 JSON 時，使用不限大小的 httpx.Client.post(...).json() 呼叫
修正：self-improvement review 應把程式碼區塊與 session 敘述寫進 reference 檔，而不是寫進 SKILL.md
此 issue 指出 skill 的 self improvement review 機制雖然能正確偵測修正模式並編碼學習內容，但產生的 patch 內容沒有經過過濾，內嵌程式碼區塊與 session 特定的敘述會直接寫進 SKILL.md，導致檔案從約 85 行膨脹到 150 行以上，違反 SKILL.md 應保持精