介面

儀表板 API

涵蓋設定、工作階段、檔案、記憶、技能、cron、訊息與營運操作的 FastAPI 介面。

概念專屬圖版儀表板 APIhx-graph-context-concept-dashboard-api正在載入視覺預覽…
以原始尺寸檢視

儀表板 API

這是什麼

這是 Hermes 各種操作介面共用的 FastAPI 後端,集中提供主要執行階段子系統的 HTTP 路由。

白話解釋

Hermes 每個畫面、按鈕與手機通知背後都通往同一個儀表板 API。它不像單一功能,比較像銀行的中央帳本:桌面應用程式、Telegram 訊息與命令列腳本只是不同服務窗口;無論從哪個入口操作,底層更新的是同一份狀態。

為什麼重要

目前釘選版本有 210 條路由,組成桌面應用程式、閘道連線等其他 Hermes 介面共用的 FastAPI 介面。路由群組直接對應 sessions、記憶、cron、skills、訊息、營運等執行階段子系統,並各自使用命名空間,而不是塞進一個未區分的端點。特定記憶 provider 的 /api/memory/providers/{name}/... 路由也位於同一套 API 下,因此新增記憶後端是擴充現有介面,不必另建平行系統。

運作方式

hermes_cli/web_server.py 建立 FastAPI 應用程式;依模組說明,它會在同一個處理程序中提供建置完成的 Vite/React 前端與 REST 端點,讓介面與 API 成為單一可部署單位,不必維護兩台同步伺服器。部分路由專門控制建立在這套 API 上的其他介面:POST /api/gateway/start/stop/restart 會啟動、停止或重新啟動獨立長駐的 gateway 處理程序;/drain 則要求現有處理程序停止接受新輪次,但不直接終止。/api/pairing/approve 用來核准等待配對、準備從遠端傳訊息給 Hermes 的裝置。啟動時,處理程序會在 uvicorn 綁定通訊端後輸出宣告連接埠的文字;桌面應用程式啟動器正是等待這個訊號後才顯示視窗。

具體範例

開發者想在不開啟 Hermes Desktop 的情況下確認 gateway 是否運作:

  1. 他從終端機向儀表板 API 的營運路由傳送一般 HTTP 請求。
  2. 回應請求的是桌面應用程式也會使用的同一個後端處理程序。
  3. 確認 gateway 已停止後,他直接呼叫 POST /api/gateway/start
  4. Gateway 會像按下桌面應用程式中的對應按鈕一樣啟動;結果是兩種操作都得到相同的 gateway 運作狀態,因為它們使用相同端點。

如何連結

「儀表板 API」屬於「介面」系列,最直接相關的概念包括「Hermes 桌面版」、「閘道」、「代理執行環境」與「個人作業系統」。

來源證據

  • web_server — 不支援的來源引用標記;hermes_cli/web_server.py 未納入目前釘選來源的原始碼驗證範圍,因此不可視為本次來源圖譜已驗證的程式證據。

工作流程

  • 目前尚無第一輪工作流程對應;此概念仍透過文章與來源證據出現在知識庫圖譜中。

相關文章

  • 目前沒有文章以足夠頻率直接提及此概念名稱或別名,尚未達到提及探勘門檻。

相關筆記