hermes 指令列工具的安裝、參數與行為相關的官方 issue。 資料來自官方 GitHub repo，狀態由官方 label 推導，每筆附原始連結與最後檢查日期。
Bug：用 /model xxx --provider xxx 切換模型時，即使沒加 --global 也會自動改寫 config.yaml
使用者透過飛書（feishu）與 hermes agent 對話，發送 /model xxx --provider xxxx 切換模型時，agent 會自動把這個模型與 provider 設成 config.yaml 的預設值（並回覆「Saved to config.yaml (--global)」），但使用者並未輸入 --global 參數，預期應該只改變當前執行期的模型設定。
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，使 agent 在第一輪對話前就直接當機。
Windows 上設定檔中未知的 provider key 觸發大量警告日誌，導致 log handler 鎖死並卡住 serve / gateway 事件迴圈
在 Windows 上，一個無害的自訂 config key 會讓 _normalize_custom_provider_entry() 在每次 load_picker_context() 呼叫時都印出警告，配合 Windows 上 concurrent-log-handler 的跨程序鎖，大量警告觸發 RuntimeError: Cannot acquire lock after 20 attempts 並重試，佔滿 CPU 並讓 asyncio 事件迴圈卡住約 14 秒，導致所有 desktop / TUI WebSocket 斷線，而 /health 端點仍顯示健康。
#58200 有暫時解法 P2 comp/agent [Bug] 依文件設定 save_trajectories: true 後，Trajectory 檔案仍未產生
官方文件說明可透過 config.yml 設定 agent.save_trajectories: true 來啟用軌跡紀錄檔，但實際測試發現程式碼從未檢查這個設定，導致對話結束後不會產生任何 *.jsonl 軌跡檔案，在 CLI、TUI、Gateway 皆是如此。
[Feature] 建議把目前選擇的 Model 與 Provider 顯示在清單最上方，方便快速存取
使用者反映每次切換模型或 thinking level 時，都要往下捲動清單才能找到目前已選擇的項目，建議讓目前選定的 provider 和 model 自動排到清單最前面。
[Setup] hermes update 會讓 .git 目錄無限膨脹，長期運行的 VPS 磁碟空間被吃光
每次執行 hermes update 都會新增 git object 但從未清理舊物件，長期運行數月後 .git 目錄膨脹到 884MB（29GB 磁碟），加上 npm 快取與 session 檔案，磁碟使用率一度達 86%，讓後續升級變得有風險。
暫時解法回報者手動執行 git gc --aggressive 將 .git 目錄從 884MB 縮減到 592MB，但這不在 update 流程中，需要自行定期執行。
[功能需求] 新增 CLI 指令與 agent 協助的 session 封存/整理功能
回報者是重度使用者，累積數百個 session 後 session_search 結果變得雜亂，希望新增封存、分類標籤、清理與匯出 session 的 CLI 指令，並讓 agent 本身也能協助使用者整理 session 記錄，而不只是手動管理。
[Bug] Hermes 在 Windows 上使用系統內建的 Node.js，而非自帶的 Node.js
回報者指出更新 Windows 系統自身的 Node.js 版本後，Hermes 會使用系統的 Node.js 而非內建版本，因版本不同導致終端機視窗持續閃爍。預期行為是 Hermes 應一律使用其內建的 Node.js。
feat: 会话添加重要性/优先级标记 (Session Importance)
### 问题描述
Hermes 目前没有给会话（session）标记重要性或优先级的功能
### 建议方案
给每条会话增加一个「重要性/优先级」属性
**1. 设置重要性**
- CLI：`her
[功能需求] TUI/CLI 顯示即時看板任務狀態
回報者指出目前 hermes kanban ls 只能顯示靜態結果，需要手動重新執行才能看到進度，也沒有明顯區分「閒置」與「執行中」任務的視覺提示。提案新增 CLI 的自動刷新模式、TUI 看板中執行中任務的閃爍提示、狀態變化的 Telegram 通知，以及顯示 worker 的最後心跳時間。
[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 注入到環境變數、但未寫入 .env 或 secret scope 的密鑰無法被憑證解析流程找到。
[Bug] 新增指定的 address model API 時出現錯誤，無法運作
此 issue 標題回報使用者在嘗試新增某個 address model API 時遇到錯誤且功能無法運作，內文僅附上一個外部文件連結與一張截圖，未提供進一步文字說明。
OpenAI Codex 裝置授權（device-auth）JSON 回應讀取沒有大小上限
此 issue 回報 hermes_cli.auth._codex_device_code_login() 與 dashboard 的 Codex 完整登入 worker，在讀取 OpenAI Codex 裝置授權流程回傳的 JSON 時，使用不限大小的 httpx.Client.post(...).json() 呼叫，對於幾個授權相關端點的 200 回應沒有設定 byte 上限，可能讓惡意或異常的大型回應被完整緩衝解析。
追蹤 Issue：Windows 桌面版 GUI 產生子行程時，主控台視窗（cmd/conhost/git/gh/powershell）會閃現
此為彙總約 25 篇回報的追蹤 issue，說明 Windows 桌面版 GUI 在無視窗的 pythonw.exe 後端呼叫 cmd.exe、git.exe、gh.exe、powershell.exe 等主控台子行程時，因未加上無視窗旗標，導致黑色主控台視窗閃現，有時甚至持續閃現；內文整理了曾嘗試並回退的修復方式，以及依實際原始碼與 git 歷史驗證過、目前仍有問題的產生點。
[Bug] 更新後 Desktop build 失敗：electronDist does not exist（快取失效）
這個 issue 指出即使先前 PR #47276 的修復曾經成功，在拉取最新程式碼更新後 Desktop build 又再次失敗，因為更新過程會清除 Electron binary 快取，出現「electronDist does not exist」錯誤，顯示 #47266 的修復並未徹底解決問題。此 issue 已關閉。
[Bug] local 後端會忽略 terminal.cwd 設定，一律使用程式啟動時的目錄
回報者指出在 config.yaml 中設定 terminal.cwd 對 local 終端機後端完全無效，根因是 cli.py 中有一段無條件覆寫邏輯，當後端為 local 時會直接用 os.getcwd() 蓋掉設定值，導致該設定只在 docker、ssh 等非 local 後端才生效。
[Bug] 執行 hermes update / hermes desktop 時，桌面應用程式編譯失敗
使用者回報執行 hermes update 或 hermes desktop 進行 Electron 桌面應用程式最後編譯階段時發生錯誤；附上的 log 顯示 electron-builder 正在為 darwin arm64 平台下載並封裝 Electron 執行檔（標題標註為 Windows desktop app，但附上的 log 內容顯示的是 macOS/darwin 封裝流程）。此 issue 為開放狀態，處理狀態為 workaround。
桌面版「工作目錄」設定無法覆蓋殘留的舊 workspace cwd 記憶
回報者指出在 Hermes Desktop 中，即使在 Settings 中正確設定了新的 Working Directory 並寫入 config.yaml 的 terminal.cwd，若 renderer 端的 localStorage 已記住舊的 workspace 路徑，新 session 仍會在舊目錄啟動，造成 UI 顯示已設定新路徑但實際行為不一致。
hermes -z（oneshot 模式）可能漏掉 MCP 工具，因為工具清單在 MCP 探索完成前就先被快照
在 hermes -z（oneshot 模式）下，即使 MCP server 通過 hermes mcp test 測試且能探索到工具，agent 實際可用的工具清單中卻沒有這些 MCP 工具。原因是 oneshot.py 在建立 AIAgent 時就已解析好工具清單，時間點在 MCP discovery 註冊動態工具之前，導致之後才加入的工具永遠不會被看到。
暫時解法在 oneshot.py 解析平台工具集前先手動呼叫 discover_mcp_tools()，可讓 MCP 工具正常被找到，回報者確認本機測試有效。
功能請求：即時語音對話模式（語音輸入輸出、低延遲）
這個 issue 指出目前與 Hermes Agent 的互動只能靠文字（CLI/TUI/IM 平台），沒有像真人對話般的即時語音互動方式。提案在終端機/TUI 中加入麥克風輸入、即時語音轉文字、低延遲回應與語音合成輸出的完整語音對話模式。
執行 hermes mcp serve 出現 ModuleNotFoundError 找不到 mcp_serve 模組
標準 pip 安裝後啟動 MCP server 會因為模組路徑問題崩潰。官方標為 P2,代表有暫時解法可繞過。
暫時解法確認以完整套件方式安裝,必要時重裝並清掉殘留快取再重啟。改完設定後記得重置 session 讓 MCP 重新載入。
Windows 安裝腳本 install.ps1 直接執行時報錯,無法同時使用 -Ensure 與 -Stage
Windows 安裝腳本在裸執行時參數衝突,官方標為 P1,代表這是會擋住安裝且目前沒有官方 workaround 的重大問題。
[功能] Profile 模式的 workers 需要獨立於 HERMES_HOME 之外的共用 auth 儲存位置
回報者指出多個 profile 模式的 Hermes worker 各自使用獨立的 HERMES_HOME，導致 OAuth 憑證分散儲存，在使用會輪替或單次使用 refresh token 的 OAuth 服務時容易發生憑證衝突或更新失敗。提案是新增獨立的 HERMES_AUTH_HOME 環境變數，讓 profile 狀態隔離但共用同一個憑證儲存區。
macOS 上 xAI OAuth loopback：瀏覽器已收到回呼，但 Hermes 仍逾時
回報者在本機 macOS（非 Docker、非 WSL、非遠端主機）設定 xAI Grok OAuth 時，瀏覽器已顯示「xAI authorization received」的成功畫面，但 Hermes 仍拋出 xAI authorization timed out 的錯誤，且沒有任何 xAI 憑證被儲存；回報者指出這與文件中說明的遠端/SSH 情境（callback 根本傳不到 loopback listener）不同。
deepseek provider：模型名稱正規化與 base_url 覆寫機制會破壞自訂端點（如 Volcengine ARK）設定
設定 Hermes 使用 deepseek provider 搭配自訂 OpenAI-compatible 端點（如 Volcengine ARK）時有兩個 bug：非標準模型名稱會被強制正規化成 deepseek-chat 導致遠端回傳 404；credential pool 的 base_url 每次啟動都會被硬編碼預設值覆寫，忽略 config.yaml 或 auth.json 中的自訂設定。
暫時解法目前只有設定 DEEPSEEK_BASE_URL 環境變數能讓自訂端點生效，但官方文件並未將其列為正式設定方式。
[RFC] Kanban 多 profile 協作看板審查（對應 PR #16100）
此 RFC 追蹤已實作的看板功能 PR #16100，內容包含將原本以 cron 驅動改為長駐 daemon（hermes kanban daemon）搭配 systemd、拖放式看板 dashboard 外掛、執行歷史與 worker log 面板、即時 WebSocket 更新，並經過四輪稽核與外部審查，測試涵蓋多行程併發、真實子行程端到端測試與大量隨機化操作的性質測試。此 issue 已關閉，狀態為已修復，後續留言討論轉往 PR #16100 進行。
[Feature] 為 Agent 資料（~/.hermes/）內建自動備份與版本控制
此 issue 提議為 Hermes 儲存在 ~/.hermes/ 的所有 agent 資料（記憶、skill、對話紀錄、輸出）內建自動備份機制與版本控制，避免使用者因硬碟故障等問題遺失 agent 累積學到的狀態，目前使用者只能自行架 cron job 或第三方工具。提案包含新增 hermes backup CLI 指令，可立即快照或設定每日排程等用法。
[Bug] OpenAI Codex OAuth 在 CLI 可正常登入，但 Telegram gateway 回報「未儲存 Codex 憑證」
回報者在 Docker/Coolify 部署環境下，CLI 使用 openai-codex provider 可正常運作且 hermes status 顯示已登入，但透過 Telegram gateway 使用同一組憑證時卻收到「No Codex credentials stored」的錯誤。此 issue 已關閉。
[設定問題] 使用 Copilot 服務商時出現 APIConnectionError（API 呼叫失敗）
使用者在 MacBook M5、python3 3.9.6 環境下，用 hermes setup 設定好 Copilot 服務商後，於 hermes chat 中對話時反覆出現 APIConnectionError，重試 3 次後仍連線失敗。此 issue 已關閉，狀態為已修復。
暫時解法使用者提到執行 `hermes update` 之後問題就解決了。
功能請求：為 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 等 VPN 遠端存取 dashboard。此 issue 提議開放設定 dashboard 的 host/port 與 CORS 來源。
[Bug] virtualenv 遷移後，外部互動式 shell 找不到 hermes 指令
PR #8226 將 hermes 改裝進 /opt/hermes/.venv/ 這個 virtualenv 後，透過 entrypoint 啟動的主程式運作正常，但用 docker exec -it 等外部互動式 shell 進入 container 時，venv 未被啟用、PATH 也沒有加入 venv 路徑，導致出現「hermes: command not found」。此 issue 已關閉。
暫時解法直接執行完整路徑 /opt/hermes/.venv/bin/hermes 可正常運作。
Docker 映像檔缺少 'dashboard' 指令（最新映像檔無法使用 web UI）
nousresearch/hermes-agent:latest 這個 Docker Hub 映像檔沒有包含 dashboard（或 web）子指令，導致在 Coolify 等容器化環境中無法執行 web UI。回報者指出該指令已存在於 main 分支原始碼中，推測 Docker Hub 映像檔是用較舊的 commit 建置的。此 issue 已關閉。
安裝程式卡在「Install ripgrep / ffmpeg [Y/n]」提示，鍵盤輸入無反應
回報者在 Windows 11 上以 curl | bash 安裝 Hermes 時，安裝程式進行到是否安裝 ripgrep 與 ffmpeg 的確認提示後卡住，終端機不接受任何鍵盤輸入（Enter、Y、n 皆無效），回報者已嘗試重開終端機、換終端機、重跑安裝程式皆無效。
[設定問題] OSError: [Errno 22] Invalid argument，prompt_toolkit 造成 hermes chat 崩潰
使用者啟動 hermes chat 後，畫面顯示歡迎訊息並提示 tirith 安全掃描器不可用，接著程式直接印出 Goodbye 並拋出例外，追溯訊息顯示是 asyncio selector 在處理檔案描述子時發生 KeyError，接著在 main.py 中引發另一個例外導致程式崩潰。此 issue 已關閉，狀態為已修復。
[UX] CLI 輸入框新增 Shift+Enter 換行支援
此 issue 提議在 Hermes CLI/TUI 的輸入框中新增 Shift+Enter 作為換行按鍵。目前官方支援的多行輸入按鍵是 Alt+Enter 與 Ctrl+J，Enter 用於送出訊息；作者認為對許多終端機使用者來說，Shift+Enter 是更直覺、更符合聊天 App 習慣的「換行不送出」按鍵，並提議在終端機支援時新增此綁定，同時保留 Alt+Enter / Ctrl+J 作為備援。此 issue 已關閉。
[Bug] CLI 在淺色/米色終端機背景下難以閱讀，缺少淺色模式支援
Hermes CLI 在淺色或米色背景的終端機上幾乎無法閱讀，所有內建 skin（default、ares、mono、slate、poseidon、sisyphus、charizard）都採用為深色背景設計的淺色文字，導致 banner、歡迎訊息、提示符號與使用者輸入文字幾乎看不見。此 issue 已關閉。
功能請求：為 CLI 查詢輸出新增 --output-format json 旗標
使用 hermes chat -q 做程式化編排（如 CI pipeline、MCP server）時，目前只能得到純文字輸出，token 數、成本、session ID、模型資訊等都要自行從非結構化文字解析。此 issue 提議新增 --output-format json 旗標，輸出包含這些 metadata 的結構化 JSON，並已有對應 PR #2916。
設定精靈啟用 NeuTTS 時安裝失敗，錯誤「No module named pip」
回報者在全新安裝 Hermes 並於設定精靈中啟用 NeuTTS 後，安裝過程因虛擬環境內找不到 pip 模組而失敗，回報者推測系統可能只有 pip3 可用。