配对桌面
让手机第一次"认识"你的桌面，并交换长期 token。
每台手机独立 token，桌面端可单独吊销。配对协议：PIN（60 秒有效）→ 兑换长期 token；扫码场景下不用输 PIN，二维码里带的是一次性配对凭证。
推荐：扫码配对（5 秒搞定）
| 步骤 | 操作 |
|---|---|
| 1 | 桌面端 → 设置 → 远程访问 → 「 配对新设备」 |
| 2 | 弹出 Modal 显示二维码 + 6 位 PIN（同时展示，扫码失败可手动输 PIN） |
| 3 | 手机端 App → 底部 tab 「设备」 → 「+ 添加桌面」 |
| 4 | 顶部点 「扫描桌面端二维码」；首次会请求相机权限，允许 |
| 5 | 把摄像头对准桌面屏幕的二维码 |
| 6 | 自动完成，桌面会弹 toast「 xxx 配对成功」 |
二维码是加密的配对码，里面带着桌面的公网地址和一张一次性配对凭证：
- 只有智码手机端能识别，其他扫码软件扫出来是一串看不懂的字符
- 和 PIN 一样 60 秒内有效，且扫一次就作废——被别人拍到的旧二维码也用不了
- 扫码失败时手机端不会把桌面地址回填到表单里，避免泄露
扫码提示「二维码无法识别」或「二维码已失效或已被使用」时，回桌面端重新点一次「配对新设备」生成新码，或改用下面的手动 PIN。
备选：手动 PIN 配对
如果手机相机权限被拒、扫码识别失败、或桌面屏幕拍到失败：
| 步骤 | 操作 |
|---|---|
| 1 | 桌面端弹出的 Modal 里复制公网 URL 和 PIN |
| 2 | 手机端 → 「+ 添加桌面」 → 选「手动填写」 |
| 3 | 粘贴公网 URL → 下一步 |
| 4 | 输入 6 位 PIN → 「配对」 |
PIN 60 秒过期
PIN 的有效期是 60 秒，过期后回桌面端再点一下「配对新设备」即可重新生成。 连续输错多次会触发 IP 锁定 5 分钟（防暴力枚举）。
配对成功后
| 桌面端可见 | 移动端可见 |
|---|---|
| 「设置 → 远程访问 → 已配对设备」表里出现新条目（含设备名、首次配对时间、最近活跃时间） | 「设备」页显示当前桌面在线状态、PTY 数、会话数 |
「审计日志」面板新增一条 pair_success 记录 |
自动跳转到「会话」页，开始接收实时输出 |
多桌面：在一台手机上同时管理
家里和办公室两台桌面都想从同一台手机管？重复一遍配对流程即可：
- 在另一台桌面上「配对新设备」
- 手机「设备」tab → 「+ 添加桌面」 → 扫码或手动 PIN
- 配对成功后，「设备」tab 列出所有桌面：点桌面卡片 = 切过去并直接进入它的会话列表；点卡片下方「切换为当前」= 只切换、留在设备页
切换桌面是纯前端切换，不影响其他桌面端的连接。
解除配对
桌面端解除（吊销手机）
- 设置 → 远程访问 → 「已配对设备」
- 找到目标设备 → 「永久删除」
- 该手机下次连接会立即收到「鉴权失败，可能 Token 已被吊销」提示
移动端解除（手机端清空所有桌面配置）
- 移动端 → 「我的」 → 「清空所有桌面配置」
- App 会先 selfRevoke 撤销自己的 token，再清空本地存储
- 桌面端「已配对设备」表里，本设备会自动移除
「清空所有桌面配置」 = 移动端的"退出登录"
彻底清空后，App 回到首启状态，需要重新配对。