H繁中版
文件Flows社群 Repos開始使用
FlowsHermes Desktop：Hermes Agent 原生 GUI 完整導覽
桌面與 GUI入門9 分鐘閱讀by Tony
<!-- Source: https://hermesbible.com/flows/hermes-desktop-full-tour -->

我使用 Hermes Agent 已經好幾個月了。CLI 聊天、TUI、Telegram 閘道、Cron 任務——整套都用過。當 Hermes Desktop 剛推出時，我以為它只是一個包在 Electron 外殼裡的 Web 控制面板，開一次點個頭就會回到終端機。

我錯了。

Hermes Desktop 是同一個 Agent 的原生 GUI 版本。相同的設定、相同的 API 金鑰、相同的對話、相同的技能、相同的記憶。它在 macOS、Windows 和 Linux 上運行。你可以在 Desktop 上開始一個對話，離開後在另一台機器上透過 CLI 接續。官方文件說這是推薦的安裝方式，使用幾週後我理解了原因。

以下是完整導覽：它的功能、安裝方式、所有值得了解的特性，以及你什麼時候會選擇 Desktop 而不是 CLI 或 TUI。

Hermes Desktop 到底是什麼

Hermes Desktop 是一個原生 Electron 應用程式，完整封裝了 Hermes Agent 運行時。它不是一個獨立產品，不是與雲端服務通訊的「桌面應用」，更不是精簡版。它運行的就是你透過 hermes chat 或 hermes --tui 取得的同一個 Agent，使用相同的設定檔、相同的對話資料庫、相同的已安裝技能和相同的記憶。

從下載頁面取得的安裝套件只是 Electron 外殼。首次啟動時，它會將完整的 Agent 運行時配置到你的 Hermes 資料目錄——與 CLI 安裝使用的相同 ~/.hermes（Windows 上為 %USERPROFILE%\.hermes）。所有東西都可以互通。

Hermes 有多個前端，都與同一個 Agent 通訊：

  • Desktop 應用程式： 本頁介紹的原生 GUI
  • CLI（hermes）： prompt-toolkit 終端介面
  • TUI（hermes --tui）： 現代化的 React 終端 UI，帶有覆蓋層
  • Web 控制面板（hermes dashboard）： 瀏覽器控制面板，內建聊天分頁
  • 訊息閘道： Telegram、Discord、Slack 及其他 15+ 個平台

它們共享狀態。你在 Desktop 開始的對話會出現在 CLI 的 hermes sessions list 中。你在 Telegram 開始的對話，接到 Desktop 也能繼續。你不需要選擇其中一個——選適合當下情境的就好。

如何安裝 Hermes Desktop

根據你的起點有兩種路徑。

全新安裝（尚未安裝 Hermes）

從 Hermes Desktop 下載頁面下載預編譯的安裝程式。選擇你的平台：

  • macOS： DMG 安裝程式
  • Windows： NSIS/MSI .exe 安裝程式
  • Linux： AppImage、deb 或 rpm

首次啟動時會自動配置 Python（透過 uv）、Node.js、ripgrep、ffmpeg 和完整的 Agent 運行時。你不需要事先安裝任何東西。

在現有 Hermes 安裝上新增 Desktop

如果你已經有 Hermes CLI，只需一行指令：

hermes desktop

這會從你目前的原始碼安裝建構 Electron 應用程式並啟動它。它使用你現有的設定、金鑰、對話和技能。不需要額外設定。

hermes desktop 指令有一些有用的參數：

參數功能
--skip-build跳過重新建構，直接啟動已解壓的應用程式
--force-build即使內容戳記相符也強制完整重建
--build-only建構桌面應用但不啟動（hermes update 使用）
--source透過 electron . 以開發模式啟動（適合測試）
--cwd PATH設定檔案瀏覽器的初始專案目錄
--hermes-root PATH指向特定的 Hermes 原始碼檢出

如果你在 Windows 上想要更熟悉的安裝體驗，桌面安裝程式 .exe 會在底層處理一切，與你已有的任何 CLI 安裝共享相同的 %LOCALAPPDATA%\hermes 資料目錄。它們可以乾淨地共存。

首次啟動與引導

首次開啟 Hermes Desktop 時，它會顯示一個啟動覆蓋層，引導你選擇提供者和模型。如果你還沒準備好選擇，有「稍後選擇提供者」的選項，讓你立即進入應用程式。

在幕後，首次啟動時它正在將 Hermes Agent 運行時安裝到你的 Hermes 主目錄。如果有問題，應用程式會顯示修復選項：重試、修復安裝或切換到本地閘道。啟動日誌位於 HERMES_HOME/logs/desktop.log，你可以從 CLI 查看：

hermes logs gui -f

聊天體驗

聊天是應用的核心，也是 Desktop 相較於終端機發光的地方。

帶有即時工具活動的串流回應。 當 Hermes 執行工具時——讀取檔案、搜尋網路或執行指令——你會即時看到工具呼叫的結構化摘要。你不需要猜測 Agent 在做什麼；你可以看著它工作。

並排預覽面板。 右側面板在你繼續聊天的同時渲染網頁、檔案和工具輸出。如果 Agent 編輯了一個檔案，你可以不離開聊天就預覽它。如果它開啟一個網頁，渲染後的頁面會顯示在對話旁邊。

拖放檔案。 將檔案拖到聊天區域即可附加到你的下一則訊息。不需要輸入路徑或複製貼上內容。

輸入歷史和佇列編輯。 在空白的輸入框中按上下方向鍵可以循環瀏覽最近的提示。在訊息送出前編輯你已排入佇列的訊息。當你想在送出前微調提示時很有用。

底部的狀態列顯示即時的對話狀態。有一個內建的模型選擇器，讓你可以即時切換模型而不需要開啟設定。還有一個每個對話獨立的 YOLO 切換。如果你想在該對話中跳過危險指令提示，就開啟它。使用前請先了解你關閉了什麼。

檔案瀏覽器

檔案瀏覽器讓你在不離開應用程式的情況下探索和預覽工作目錄。當你追蹤 Agent 讀取、寫入和編輯檔案的過程時很有用，你可以即時看到變更。

在啟動時設定初始專案目錄：

hermes desktop --cwd /path/to/your/project

或設定 HERMES_DESKTOP_CWD 環境變數。

語音模式

Hermes Desktop 支援與 CLI 和 TUI 相同的語音模式。你可以與 Hermes 對話並聽見它回應。在 macOS 上，首次使用時系統會提示麥克風存取權限。

在設定中配置語音轉文字和文字轉語音提供者。如果你想要本地語音轉文字，需要安裝語音附加套件：

# 從 Hermes 安裝目錄
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"

設定與配置

Desktop 相較於 CLI 最大的優勢之一是有真正的設定 UI，而不是編輯 YAML 檔案。以下是你不需要終端機就能配置的內容。

提供者。 提供者面板以帳號管理式的 UX 顯示每個支援的推論提供者。對於支援 OAuth 的提供者可以直接登入：Nous Portal、xAI Grok、MiniMax、Google Gemini。應用程式會為你處理瀏覽器登入流程。API 金鑰透過貼上介面輸入。

模型設定。 從完整目錄中選擇你的主要提供者和模型——與 CLI 使用的相同，不是精選子集。為特定任務配置輔助模型：視覺分析、網頁擷取、上下文壓縮、標題生成、MCP 工具路由和技能策展。

工具與金鑰。 在一個地方管理各個工具的 API 金鑰。應用程式也暴露工具後端的安裝步驟。你可以直接從 GUI 執行安裝後設定器，而不需要切換到終端機。

MCP 伺服器。 透過表單介面新增、編輯和移除 stdio 及 HTTP MCP 伺服器。不需要手動編輯 JSON。變更後重新載入 MCP 工具。

閘道連線。 在本地和遠端閘道之間切換。設定每個設定檔的遠端主機。使用遠端後端的驗證提供者登入。

外觀。 亮色、暗色或系統模式。在「產品」檢視（簡潔、人類友善的工具摘要）和「技術」檢視（原始工具參數和結果）之間切換。選擇強調色主題。

安全性。 配置 YOLO 模式和危險指令核准設定。

管理面板

除了聊天和設定，Desktop 還提供了幾個通常需要 CLI 指令的管理介面：

  • 技能： 瀏覽已安裝技能、搜尋 Skills Hub、安裝新技能、管理你的收藏
  • Cron： 查看排程任務、管理其狀態
  • 設定檔： 在不同的 Hermes 設定檔之間切換。同時在多個設定檔中運行對話，並使用跨設定檔的 @session 連結參照另一個設定檔中的對話
  • 訊息： 為 Telegram、Discord、Slack、WhatsApp 等設定閘道頻道
  • Agent 和控制中心： 多 Agent 工作的協調介面

鍵盤與導航

Desktop 設計為可從鍵盤導航：

  • 指令面板： 按 Cmd+K（Windows/Linux 上為 Ctrl+K）跳轉到任何動作或檢視
  • 可重新綁定的快捷鍵： 設定中的快捷鍵面板讓你重新綁定每個鍵盤快捷鍵
  • 自訂縮放： 半步縮放增量，精確控制文字大小
  • 語言切換器： 在應用內切換介面語言，包括簡體中文（zh-Hans）

連接到遠端後端

預設情況下，Desktop 啟動並管理自己的本地後端。應用程式捆綁了所有東西。但你也可以將它指向另一台機器上運行的 Hermes 後端。

「遠端後端」指的是在遠端機器上運行的 hermes dashboard 伺服器。它需要啟動並可達；Desktop 不會為你啟動它。

在遠端機器上：

# 設定憑證
cat >> ~/.hermes/.env <<'EOF'
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=your-username
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=your-password
HERMES_DASHBOARD_BASIC_AUTH_SECRET=your-stable-secret
EOF

# 啟動綁定到可達位址的控制面板
hermes dashboard --no-open --host 0.0.0.0 --port 9119

在 Desktop 應用中：

前往 Settings → Gateway → Remote gateway。輸入遠端 URL（例如 http://host:9119），使用後端提供的驗證方式（使用者名稱/密碼表單或 OAuth 瀏覽器流程）登入，然後儲存並重新連線。如果你設定了 HERMES_DASHBOARD_BASIC_AUTH_SECRET，對話會在重啟後持續。

每個設定檔可以指向自己的遠端主機。切換設定檔，Desktop 就會連接到不同的後端。

遠端連線問題排除

  • 401 / "Invalid credentials"： 使用者名稱或密碼與後端不相符。請兩者都檢查。
  • 沒有「Sign in」按鈕，只有 session token 輸入： 使用者名稱/密碼提供者在後端未啟用。請確認 .env 中設定了 HERMES_DASHBOARD_BASIC_AUTH_USERNAME 和密碼（或雜湊值）。
  • 每次重啟都要重新登入： 你需要將 HERMES_DASHBOARD_BASIC_AUTH_SECRET 設定為穩定的值。
  • 連線被拒 / 逾時： 後端綁定到 127.0.0.1 或防火牆正在封鎖該埠。請綁定到 0.0.0.0 或 Tailscale IP。

更新與解除安裝

更新。 應用程式會在背景檢查更新，當有新版本時提供一鍵安裝。你也可以從 CLI 使用 hermes update 更新。

解除安裝。 開啟 Settings → About → Danger zone，選擇要移除多少：

  • 僅解除安裝聊天 GUI： 移除桌面應用及其資料；Agent、設定和對話保留。等同於 hermes uninstall --gui
  • 解除安裝 GUI + Agent，保留資料： 移除應用和 Agent，但保留設定、對話和密鑰以便未來重新安裝。等同於 hermes uninstall
  • 解除安裝一切： 移除應用、Agent 和所有使用者資料。等同於 hermes uninstall --full

快速問題排除參考

當遇到問題時，以下是排查起點：

  • 應用無法啟動： 檢查 HERMES_HOME/logs/desktop.log（或 hermes logs gui -f）。嘗試啟動失敗畫面中的修復安裝選項
  • Desktop 顯示「405 Method Not Allowed」： 重新啟動應用。這個錯誤通常表示後端程序進入了異常狀態
  • macOS 上語音麥克風無法運作： 執行 tccutil reset Microphone com.nousresearch.hermes
  • 遠端登入持續失敗： 驗證後端是否可達：curl http://host:9119/api/status
  • 一般異常： hermes doctor 是任何 Hermes 問題的第一個診斷工具

結論

Hermes Desktop 不是 CLI 或閘道的替代品。它是同一個 Agent 的另一個前端，價值在於為當下情境提供合適的介面。

我什麼時候用 Desktop？標準的日常聊天，尤其是我想把檔案拖進對話或在側邊面板查看工具輸出時。配置某些我不想去 YAML 中手動編輯的內容時。邊看檔案邊執行對話時。

我什麼時候還是用 CLI？快速提問、將輸出串接到其他指令、寫腳本，或我已經在終端機中不想切換上下文時。

我什麼時候用閘道？常駐機器人、Telegram 私訊、任何需要從手機或其他機器找到我而不需要我啟動對話的互動。

試試看。如果你已經有 Hermes，執行 hermes desktop，或從 hermes-agent.nousresearch.com/desktop 取得安裝程式。免費嘗試，如果你不喜歡，hermes uninstall --gui 可以乾淨地移除。

Hermes Agent 完整指南：從零開始打造自我改進的 AI 員工Hermes Dreaming 介紹：Hermes Agent 的可審查自我改進