Skip to content

遠端接入 ​

在手機或其他裝置上遠端使用你的 zqagent:任務在節點上執行,進度、審核請求與結果即時回傳。

一條鏈路,兩種身份 ​

遠端接入採用 Rust 閘道器 + 二進位制 WSS:

   手機 / 瀏覽器 ──wss──▶ Rust 閘道器 ◀──wss── 節點(執行任務的機器)
                            ▲
                      簽發憑據(HTTPS)
                            │
                          Hub 控制面
  • 節點:持有簽名金鑰(FLEET_SECRET),連線後用金鑰向閘道器證明身份。
  • 終端(手機 / 瀏覽器):不接觸節點金鑰。它用賬號登入 Hub,換取一份只授權指定節點 的短時效令牌,再拿它直連閘道器。令牌過期後重新換取即可,無需重新登入。

這樣做的好處:手機上不會長期存放可接管節點的金鑰;令牌丟了也隻影響它授權的那臺節點。

在手機上使用 ​

  1. 在節點機器上完成接入(見服務端設定的「雲端接入」一節), 並在節點設定裡啟用遠端訪問。
  2. 手機瀏覽器開啟你的使用者中心(Hub 地址),登入同一賬號。
  3. 進入「節點」頁即可看到已接入的節點,點選進入控制台。

原生 App 目前直接複用同一套控制台頁面。若你在自研客戶端,協議契約見倉庫的 docs/wire-protocol.md(幀格式、信封、訊息定義與簽名演算法)。

能做什麼 ​

操作說明
提交任務直接發訊息,節點開始執行
補充資訊任務執行中追加指示,立即注入當前任務
審核對需要授權的操作選擇 同意 / 全部同意 / 拒絕
回答問題回答 AI 的提問或計劃確認
中斷任務隨時停止當前任務
會話管理新建、切換、檢視會話列表
檔案瀏覽檢視專案目錄與檔案內容

通知與進度 ​

  • 任務的關鍵節點(需要審核、需要回答、完成、出錯)會推送到你的賬號,在任意裝置上都能看到。
  • 執行進度(正在呼叫哪個工具、輸出了什麼)即時推送。
  • 同一賬號的多臺裝置會同時收到通知。

可用性 ​

  • 節點只需出站連線閘道器(wss://,通常走 443),無需公網入站、無需開放埠。
  • 閘道器不可達時節點會按指數退避自動重連,期間本地功能完全不受影響。