远程接入

在手机或其他设备上远程使用你的 zqagent：任务在节点上执行，进度、审批请求与结果实时回传。

一条链路，两种身份

远程接入采用 Rust 网关 + 二进制 WSS：

   手机 / 浏览器 ──wss──▶ Rust 网关 ◀──wss── 节点（执行任务的机器）
                            ▲
                      签发凭据（HTTPS）
                            │
                          Hub 控制面

• 节点：持有签名密钥（FLEET_SECRET），连接后用密钥向网关证明身份。
• 终端（手机 / 浏览器）：不接触节点密钥。它用账号登录 Hub，换取一份只授权指定节点 的短时效令牌，再拿它直连网关。令牌过期后重新换取即可，无需重新登录。

这样做的好处：手机上不会长期存放可接管节点的密钥；令牌丢了也只影响它授权的那台节点。

在手机上使用

1. 在节点机器上完成接入（见服务端配置的「云端接入」一节）， 并在节点设置里启用远程访问。
2. 手机浏览器打开你的用户中心（Hub 地址），登录同一账号。
3. 进入「节点」页即可看到已接入的节点，点击进入控制台。

原生 App 目前直接复用同一套控制台页面。若你在自研客户端，协议契约见仓库的 docs/wire-protocol.md（帧格式、信封、消息定义与签名算法）。

能做什么

操作	说明
提交任务	直接发消息，节点开始执行
补充信息	任务运行中追加指示，立即注入当前任务
审批	对需要授权的操作选择 同意 / 全部同意 / 拒绝
回答问题	回答 AI 的提问或计划确认
中断任务	随时停止当前任务
会话管理	新建、切换、查看会话列表
文件浏览	查看项目目录与文件内容

通知与进度

• 任务的关键节点（需要审批、需要回答、完成、出错）会推送到你的账号，在任意设备上都能看到。
• 执行进度（正在调用哪个工具、输出了什么）实时推送。
• 同一账号的多台设备会同时收到通知。

可用性

• 节点只需出站连接网关（wss://，通常走 443），无需公网入站、无需开放端口。
• 网关不可达时节点会按指数退避自动重连，期间本地功能完全不受影响。