儀表板 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 是否運作:
- 他從終端機向儀表板 API 的營運路由傳送一般 HTTP 請求。
- 回應請求的是桌面應用程式也會使用的同一個後端處理程序。
- 確認 gateway 已停止後,他直接呼叫
POST /api/gateway/start。 - Gateway 會像按下桌面應用程式中的對應按鈕一樣啟動;結果是兩種操作都得到相同的 gateway 運作狀態,因為它們使用相同端點。
如何連結
「儀表板 API」屬於「介面」系列,最直接相關的概念包括「Hermes 桌面版」、「閘道」、「代理執行環境」與「個人作業系統」。
來源證據
web_server— 不支援的來源引用標記;hermes_cli/web_server.py未納入目前釘選來源的原始碼驗證範圍,因此不可視為本次來源圖譜已驗證的程式證據。
工作流程
- 目前尚無第一輪工作流程對應;此概念仍透過文章與來源證據出現在知識庫圖譜中。
相關文章
- 目前沒有文章以足夠頻率直接提及此概念名稱或別名,尚未達到提及探勘門檻。
