桌面版 Desktop(31 筆)

桌面應用程式(macOS / Windows)相關的官方 issue。 資料來自官方 GitHub repo,狀態由官方 label 推導,每筆附原始連結與最後檢查日期。

#58309 有暫時解法 P2 comp/desktop

Desktop GUI 每 10 秒就會重新啟動一個 CLI process,導致重複的 plugin discovery

Hermes Desktop GUI 每約 10 秒就會產生一個新的 CLI process,每次都執行完整的 plugin discovery 流程,造成 agent.log 大量洗版以及不必要的 CPU / 磁碟資源消耗。

#58304 有暫時解法 P2 comp/desktop

Bug:使用本機模型端點時,TUI 非正常結束後 Desktop 啟動會無限卡住

當使用者在 TUI/CLI 用 /model 指向本機 loopback 端點(如 llama.cpp / ollama / vLLM)後非正常結束(Ctrl-C、關閉終端機、當機等),對應 session 在 state.db 中的 ended_at 會永遠是 NULL。下次啟動 desktop 時,後端會把這個未結束的 session 當成最新一筆並同步重試已失效的本機端點,導致 uvicorn 事件迴圈被卡住 60 到 100 秒以上,desktop 逾時顯示無法連線。

#58275 討論中 P3 comp/desktop

Windows 上 hermes desktop 啟動器不會與終端機分離,關閉終端機會殺掉 Electron / Python process 並留下殘留程序

在 Windows 上,hermes desktop 會把 Electron App 當成繼承父層 PowerShell console 的子程序啟動,導致關閉父層終端機視窗時 Electron App 也會一併被砍掉,而且 Electron/Node 的 stdout/stderr(含編碼不一致造成的亂碼錯誤訊息)會洗版使用者的終端機。

#58274 討論中 P3 comp/cron

功能請求:完整的 Profile 對等性(Dashboard、Sessions、Cron、路徑隔離)

使用者同時執行多個 Hermes profile,但發現非 default profile 在多個子系統中被當成次等公民對待,例如 cron job 會寫到錯誤 profile 的目錄、dashboard 功能只看得到 default profile、Desktop App 完全忽略非 default 的 session。issue 把這些個別問題彙整成一個總覽,指出根因是程式碼假設 ~/.hermes/(default 根目錄)才是唯一正式路徑。

#58251 討論中 P3 comp/desktop

Desktop:已移除的輸入框附件在切換 session 後會重新出現

使用者在 composer 中點擊附件的關閉按鈕移除附件後,附件會先消失,但切到別的 session 再切回來時,被移除的附件卻會重新出現。根因是 removeComposerAttachment() 只更新記憶體中的 nanostore atom,沒有呼叫 stashSessionDraft() 把變更持久化到 localStorage。

#58215 討論中 P3 comp/tui

Desktop 版:discovered_repos 快取在不同 profile 之間互相洩漏

Hermes Desktop 的檔案系統掃描器會把偵測到的所有 git repo 廣播給每個 profile 各自的資料庫,導致切換 profile 時會看到其他 profile 的 repo;根因是 projects.record_repos 處理常式用 replace=True 覆寫了整份清單。

#58193 討論中 P3 comp/agent

[Feature] 建議讓 agent 能「附加」到一個開啟中的桌面視窗,直接觀看與操控

目前若要讓 assistant 操作某個桌面應用程式,使用者必須用文字描述視窗與其中的控制項,對記不住選單路徑的使用者(含輔助科技需求者)幾乎不可行。提案新增「附加 app / 視窗」功能,讓使用者選取一個開啟中的視窗後,agent 可透過 UI 自動化側車程式觀看並操控它;作者提到此功能已在另一個 PR(#53852)實作並運作中。

#58161 討論中 P3 comp/desktop

[功能需求] 希望桌面版能新增介面字體大小調整功能

使用者反映桌面版 Hermes 的介面字體太小,且沒有調整選項,因此提議新增字體大小調整功能,方便視力不佳的使用者使用。

#58134 討論中 P3 comp/desktop

[功能需求] 強化桌寵顯示:加入即時執行狀態(參考 Petdex Desktop)

回報者指出 Hermes 目前的桌寵功能只依 5 種基本狀態切換表情,沒有顯示即時執行資訊。提案希望新增浮動視窗模式、顯示目前執行工具與進度、token 用量與耗時的即時狀態氣泡,並讓桌寵能對跨 agent 工具產生反應,同時擴增至 9 種以上可自訂狀態。

#58130 討論中 P3 comp/desktop

[功能需求] 桌面版音訊播放列加入音量滑桿、播放/暫停與速度切換

回報者指出 Hermes 桌面版的朗讀 / TTS 播放列目前只有狀態文字與停止鍵,缺乏音量控制、暫停/繼續播放與播放速度調整等基本播放器功能。提案新增音量滑桿、播放/暫停按鈕與速度切換三項控制。

#57903 已修復 P2 comp/agent

[Bug] 非同步 LLM 呼叫透過忙碌輪詢阻塞桌面版 WebSocket 主迴圈

回報者最初懷疑 interruptible_api_call 中 300ms 的忙碌輪詢拖慢主執行緒,但經過超過 4 小時的深入調查,確認真正原因是 Anthropic SDK 串流消費端在解析大量 SSE chunk 時造成的 worker 執行緒 GIL 競爭,導致主執行緒長時間無法取得 GIL。此 issue 已關閉。

#57748 討論中 P3 comp/gateway

[功能需求] 執行任務期間即時顯示 context window 使用量到桌面版/TUI 狀態列

此 issue 提出功能需求:目前 desktop 與 TUI 狀態列的 context window 使用量儀表只在 message.complete 時才更新,導致長時間的 agentic turn 期間畫面會凍結在前一輪的數值,直到結束才跳動一次。作者指出底層資料其實在每次內部 API 呼叫後都已更新,只是 gateway 沒有在 turn 進行中就傳遞出去。

#57738 討論中 P3 comp/desktop

Hermes Desktop 的 Docker 執行後端切換沒有狀態顯示、健康檢查或設定引導

此 issue 提出功能需求:在 Hermes Desktop 的進階設定中選擇 terminal.backend: docker 後,介面沒有連線狀態顯示、沒有『測試連線』功能,若 Docker Desktop 未安裝或 daemon 未啟動,第一次呼叫 terminal / file / execute_code 只會出現通用錯誤而無任何引導。

#57731 討論中 P3 comp/desktop

[功能需求] 提供正式的更新日誌(changelog)畫面

此 issue 提出功能需求:目前桌面版更新時只顯示幾則更新說明,底部再顯示『還有 25 項更新』的字樣,作者希望能有一個頁面可以捲動 / 翻頁查看所有累積的更新內容,而不是只看到最新的一部分。

#56058 討論中 P3 comp/desktop

[Bug] 桌面版聊天模型選擇器會寫入全域設定,而非只影響當前 session

回報者指出在 Windows 上使用 Hermes 桌面版狀態列的聊天模型選擇器切換模型時,會直接修改全域的 ~/.hermes/config.yaml,而非按文件所述僅套用於當前 session;預期應該只有透過 Settings → Model 才會變更全域預設值。

#55725 討論中 P3 comp/desktop

[Bug] 側欄建立 worktree 後,session 同時出現在新 worktree 群組與 main 群組

在桌面版側欄用 fork 按鈕建立 worktree 並開始對話後,新 session 會同時顯示在新 worktree 群組和 main 分支群組底下,離開專案視圖再進來才會恢復正常。

暫時解法

離開專案視圖再重新進入,分組會恢復正常。

#55658 有暫時解法 P2 comp/desktop

[Bug] 更新後無法啟動

此 issue 標題回報更新後應用程式無法啟動,內文僅附上一張截圖,未提供文字描述。

#54220 已修復 P2 comp/agent

追蹤 Issue:Windows 桌面版 GUI 產生子行程時,主控台視窗(cmd/conhost/git/gh/powershell)會閃現

此為彙總約 25 篇回報的追蹤 issue,說明 Windows 桌面版 GUI 在無視窗的 pythonw.exe 後端呼叫 cmd.exe、git.exe、gh.exe、powershell.exe 等主控台子行程時,因未加上無視窗旗標,導致黑色主控台視窗閃現,有時甚至持續閃現;內文整理了曾嘗試並回退的修復方式,以及依實際原始碼與 git 歷史驗證過、目前仍有問題的產生點。

#52401 有暫時解法 P2 comp/cron

[Bug] macOS 桌面版:非預設 profile 會看到 default profile 的 session 與 cron(跨 profile 資料外洩)

在 macOS 桌面版切到自建 profile(例如只設定 WeChat 的 rucy)時,UI 仍會顯示屬於 default profile 的 sessions、通訊頻道與 cron jobs,屬於 UI 層的跨 profile 資料外洩。

#47917 已修復 P1 comp/cli

[Bug] 更新後 Desktop build 失敗:electronDist does not exist(快取失效)

這個 issue 指出即使先前 PR #47276 的修復曾經成功,在拉取最新程式碼更新後 Desktop build 又再次失敗,因為更新過程會清除 Electron binary 快取,出現「electronDist does not exist」錯誤,顯示 #47266 的修復並未徹底解決問題。此 issue 已關閉。

#46742 已修復 P2 comp/desktop

[Bug] Ubuntu 26.04 桌面版更新時 Build failed,之後無法再啟動

在 Ubuntu 26.04 LTS 按桌面版右下角的更新按鈕後出現 Build failed,terminal 啟動 hermes desktop 報大量錯誤且無法再執行;CLI 的 hermes 指令仍正常。此 issue 已關閉。

#44562 討論中 P3 comp/desktop

Bug:前端當機,工具回傳非預期資料時出現 tapClientLookup Index out of bounds

在 Hermes Desktop GUI 中使用 skill_manage、memory 或 cronjob 等工具時,若工具回傳的資料結構與前端預期不符,前端會拋出 tapClientLookup: Index out of bounds 錯誤,導致聊天介面白屏或卡死。

#41222 討論中 P3 comp/cron

功能請求:把 Kanban 看板整合進 Desktop app

目前 Kanban 看板與 Desktop app 是分開的,使用者要另開終端機下指令(如 hermes kanban list)並手動複製任務 ID,造成多 agent 協作時的操作阻力。此 issue 提議在 Desktop app 加入側邊欄或 /kanban 指令,讓使用者不用離開聊天介面就能查看與操作看板任務。

#40297 討論中 P3 comp/desktop

功能請求:Desktop 版支援每個 session 各自選擇工作目錄,而非僅限啟動時的 cwd

這個 issue 指出 Hermes Desktop 目前只能在啟動時透過 --cwd 或環境變數指定單一工作目錄,長期使用多個專案時很不方便;側邊欄選擇資料夾也不會真正變成新 session 的工作目錄。提案讓使用者能在 App 內新增/開啟專案資料夾,並讓新 session 綁定該資料夾。

#40187 有暫時解法 P2 comp/cli

[Bug] 執行 hermes update / hermes desktop 時,桌面應用程式編譯失敗

使用者回報執行 hermes update 或 hermes desktop 進行 Electron 桌面應用程式最後編譯階段時發生錯誤;附上的 log 顯示 electron-builder 正在為 darwin arm64 平台下載並封裝 Electron 執行檔(標題標註為 Windows desktop app,但附上的 log 內容顯示的是 macOS/darwin 封裝流程)。此 issue 為開放狀態,處理狀態為 workaround。

#40166 討論中 P3 comp/desktop

[Desktop app] 新增字體大小 / 縮放控制

macOS 上的 Hermes desktop app 沒有調整字體大小或縮放的方式,標準 macOS 縮放快捷鍵(Cmd+加/減/0)與觸控板縮放手勢都無效,config.yaml 也沒有相關的 display 設定,在高解析度或大螢幕上預設字體過小,且沒有替代方案。

#38855 已修復 P1 comp/cli

桌面版「工作目錄」設定無法覆蓋殘留的舊 workspace cwd 記憶

回報者指出在 Hermes Desktop 中,即使在 Settings 中正確設定了新的 Working Directory 並寫入 config.yaml 的 terminal.cwd,若 renderer 端的 localStorage 已記住舊的 workspace 路徑,新 session 仍會在舊目錄啟動,造成 UI 顯示已設定新路徑但實際行為不一致。

#38602 討論中 P3 comp/desktop

[Feature] 支援桌面版 Hermes 以純用戶端模式安裝,連線遠端 Hermes

回報者想把 Hermes Desktop 安裝成連線到遠端既有 Hermes 服務的輕量用戶端,但現況是只要偵測不到本機安裝,桌面 App 就一定會在首次啟動時自動跑 electron/main.cjs 裡的 bootstrap,執行 install.ps1 安裝 Python、Node 等依賴,沒有官方提供的純用戶端安裝版本。

暫時解法

body 提到可在首次啟動前先設定環境變數 HERMES_DESKTOP_REMOTE_URL 與 HERMES_DESKTOP_REMOTE_TOKEN,讓桌面 App 改連線遠端後端、跳過本機後端啟動;但 Electron 外殼本身仍會被安裝,且一旦取消設定這兩個環境變數,下次啟動仍會嘗試 bootstrap 本機環境。

#37713 討論中 P3 comp/gateway

功能請求:Desktop Remote gateway 應支援從 UI 切換 Hermes profile

當 Hermes Desktop 連到遠端 Hermes 後端時,目前只能看到 profile 清單,實際生效的 profile 仍取決於遠端後端啟動時的 HERMES_HOME/HERMES_PROFILE,Desktop 的 Profiles 頁面無法真正切換後端使用的 profile。此 issue 提議讓 Desktop UI 能直接切換遠端使用中的 profile。

#36970 討論中 P3 comp/desktop

Desktop:為已存在的 Hermes 服務新增正式的遠端用戶端引導流程

此 issue 指出目前 macOS Desktop 安裝程式的流程偏向本機優先:開啟下載的 DMG 就會看到「Install Hermes」的 setup/bootstrap 畫面,對已經在伺服器或服務機上跑 Hermes、只想要一個桌面用戶端的使用者來說容易造成混淆,讓人誤以為不支援遠端模式,即使桌面版程式碼其實可以手動設定連到遠端後端。作者希望新增明顯的「使用既有 Hermes 服務」/「連線到遠端 Hermes」啟動路徑,可輸入後端網址與 token 或配對碼,並驗證健康檢查端點。

#11911 討論中 P3 comp/desktop

功能請求:原生行動 App(iOS 與 Android)搭配語音通話

這個 issue 希望官方推出支援語音通話的 iOS 與 Android 原生 App,讓使用者能像講電話一樣即時與 Hermes AI 助理對話,並涵蓋文字聊天、推播通知等功能。

其他分類

回官方 Issue 精選問答看學校解法卡常見問題排解