# 移动端使用

手机端（安卓 App 或任意手机浏览器）实时镜像桌面终端并遥控会话。两种连接方式：**局域网直连**、**公网中继**。

## 前置：桌面开启移动端

桌面 CCGUI → 设置 →「移动端」：
- 开启「移动端网关」：桌面在本机端口（默认 `45820`）起 WebSocket 网关，用于局域网直连。
- 如需外网访问，另开「公网中继」并填中继地址（见 [docs/03-中继-部署与使用.md](03-中继-部署与使用.md)）。

设置页会显示：本机局域网地址、端口、配对令牌、二维码，以及公网中继的配对链接。

## 方式一：局域网直连（同一 WiFi）

1. 手机与电脑处于同一局域网。
2. 手机装 App（APK 见 [docs/02](02-移动端-编译.md)），或直接用浏览器打开 `http://电脑局域网IP:45820/`（桌面网关对普通 GET 会返回移动页）。
3. 在移动页「添加连接」选「局域网」，填 `ws://电脑IP:45820`；或直接扫桌面设置页的二维码（内容即 `ws://IP:port/?token=...`）。
4. 令牌一致即连上。

## 方式二：公网中继（外网 / 4G）

1. 桌面已按 docs/03 配好中继并开启。
2. 手机打开桌面设置页给出的「手机配对」链接 `https://你的域名/?room=xxxx&token=yyyy`；或在移动页手动「添加连接」选「中继」，填中继域名、房间号、令牌。
3. 两端 `peer-online` 后自动完成鉴权、开始镜像。

连接会保存在手机本地（浏览器 localStorage / App 内），下次可直接选用。

## 能做什么

- **实时镜像**：附着某个会话即拉取完整回看缓冲并持续同步终端输出。
- **输入遥控**：手机键盘输入直达终端；结构化确认（如权限询问）可点选回答。
- **会话管理**：查看项目与活动会话列表、新建会话（可选模型 / 权限模式）、恢复历史会话、关闭会话。
- **文件树**：按需逐层浏览项目目录。
- **发图**：从相册或拍照选图上传，桌面落盘临时文件并把路径写入输入行（不自动回车，便于你补一句说明再提交）。

## 安全

- 鉴权靠配对令牌；局域网直连时令牌随二维码分发。
- 公网中继链路不做端到端加密，请置于 HTTPS 之后，并只用自己信任的中继。
- 远程写入不绕过 Claude Code 的权限确认。
