遠端接入
在手機或其他裝置上遠端使用你的 zqagent:任務在節點上執行,進度、審核請求與結果即時回傳。
一條鏈路,兩種身份
遠端接入採用 Rust 閘道器 + 二進位制 WSS:
手機 / 瀏覽器 ──wss──▶ Rust 閘道器 ◀──wss── 節點(執行任務的機器)
▲
簽發憑據(HTTPS)
│
Hub 控制面- 節點:持有簽名金鑰(
FLEET_SECRET),連線後用金鑰向閘道器證明身份。 - 終端(手機 / 瀏覽器):不接觸節點金鑰。它用賬號登入 Hub,換取一份只授權指定節點 的短時效令牌,再拿它直連閘道器。令牌過期後重新換取即可,無需重新登入。
這樣做的好處:手機上不會長期存放可接管節點的金鑰;令牌丟了也隻影響它授權的那臺節點。
在手機上使用
- 在節點機器上完成接入(見服務端設定的「雲端接入」一節), 並在節點設定裡啟用遠端訪問。
- 手機瀏覽器開啟你的使用者中心(Hub 地址),登入同一賬號。
- 進入「節點」頁即可看到已接入的節點,點選進入控制台。
原生 App 目前直接複用同一套控制台頁面。若你在自研客戶端,協議契約見倉庫的
docs/wire-protocol.md(幀格式、信封、訊息定義與簽名演算法)。
能做什麼
| 操作 | 說明 |
|---|---|
| 提交任務 | 直接發訊息,節點開始執行 |
| 補充資訊 | 任務執行中追加指示,立即注入當前任務 |
| 審核 | 對需要授權的操作選擇 同意 / 全部同意 / 拒絕 |
| 回答問題 | 回答 AI 的提問或計劃確認 |
| 中斷任務 | 隨時停止當前任務 |
| 會話管理 | 新建、切換、檢視會話列表 |
| 檔案瀏覽 | 檢視專案目錄與檔案內容 |
通知與進度
- 任務的關鍵節點(需要審核、需要回答、完成、出錯)會推送到你的賬號,在任意裝置上都能看到。
- 執行進度(正在呼叫哪個工具、輸出了什麼)即時推送。
- 同一賬號的多臺裝置會同時收到通知。
可用性
- 節點只需出站連線閘道器(
wss://,通常走 443),無需公網入站、無需開放埠。 - 閘道器不可達時節點會按指數退避自動重連,期間本地功能完全不受影響。
