---
url: /wave-agent/web.md
---
# Web 端（远程控制）使用文档

Web 端不需要安装任何客户端：电脑上跑着 agent，手机或电脑的浏览器打开一个地址就能接管——看进度、批审批、接着对话。页面与桌面端、插件端共用同一套会话与产物，切过去不会打断正在跑的任务。

## 快速入门

1. **电脑侧开启远程控制**：在桌面端、VS Code / JetBrains 插件或 CLI 会话里执行 `/remote-control`（或从设置页进入「远程控制」），页面上给出**页面地址**与**二维码**。
2. **手机打开页面**：扫码或用浏览器打开地址，用企业账号登录（登录态过期会在页面内就地续期，不用重新扫码）。
3. **添加到主屏幕（推荐）**：像 App 一样全屏使用，也是开启锁屏通知的前提。

## 手机上的界面

顶栏只有三个入口，都对应手机上真正用得上的动作：**新建对话**（在电脑上另起一条会话）、**会话**（电脑上的会话列表）、**更多**（切换电脑、通知开关、企业管控台、帮助文档）。

### 会话列表

顶栏「会话」打开电脑上的会话列表：每行是标题、项目目录与最近活跃时间，可以按关键词搜索；行尾的「⋯」放重命名与删除。

每条会话前面的状态点只有一个，按优先级取最高的那一种：

* 🟡 **等待确认**：这条会话卡在审批上，等你处理
* ⏳ **运行中**：正在生成
* 🔵 **有后台任务在跑**：前台回合结束，后台任务还在转

删除建在 worktree 里的会话时，会先读一次改动、把「有未提交改动」说清楚；正在回答的会话还要额外勾一句确认，避免误删正在跑的东西。

### 审批在手机上一样能批

命令、文件改动（带 diff）、计划，都在手机上以确认卡片的形式弹出。计划审批有一处专门的差异：**计划正文直接渲染在确认对话框里**——手机上没有编辑器列、也没有面板，计划正文是批准与否的唯一依据，所以不把它藏到别处去。

### 更多菜单

「更多」菜单里可以开启**锁屏通知**——会话跑完了、或者卡在审批上等你处理，手机会推一条通知。通知需要先把页面添加到主屏幕并允许权限。

### 顺口问一句（`/btw`）

在输入框敲 `/btw <你的问题>`，输入框上方会开一个旁路面板：这一问不进对话历史、不执行任何工具、也不打断正在跑的回合，答完关掉即可。回答过程中面板会显示实时输出的尾部。

终端里前台跑的那条会话暂不支持这一条，面板会直接说明。

### 快捷指令弹窗

输入框左侧的「/」列出这台手机上能用的指令：`/status`、`/clear`、`/compact`、`/tasks`、`/workflows`、`/rewind`、`/model`、`/btw`。选中即执行，不用再手打。

需要电脑那边界面的几条（设置、插件市场、计划预览等）不会出现在这里——手机上点下去没有承载它们的页面。

## 多台电脑

同一账号下可以有多台电脑登记为远程主机。「更多」菜单里的「切换电脑」列出全部机器与在线状态，选一台就切过去；每台机器的页面地址相同，扫码 / 打开地址时选的是机器。

不在用的老机器可以就地删掉：离线的机器那一行带「删除」，点一下就在行内问一次，确认后清掉这台登记；正在使用远程控制的机器删不了，先在那台电脑上关掉远程控制，等它显示为离线。删掉的只是登记——那台电脑下次开启远程控制后会重新出现在列表里。

## 断线与恢复

连接断了不需要重新扫码：页面顶部会多出一条状态条（「电脑侧不在线，等待上线…」），并按指数退避自动重连；手机从后台回到前台、或从浏览器缓存里恢复时，也会立刻重连一次。这条状态条上只有一句原因和右侧的 ×，点 × 可以先把它收起来——同一次断开期间它不会再冒出来，连接接回后下次断开才重新出现。

前台回合跑到一半断线不会丢内容：重连后页面重新拉齐这条会话的快照（正在跑的那一轮继续推）。往上翻到更早的消息时按需分页加载。

刚打开页面就读不到这台机器上的会话列表时，页面会自己再试几次；一直不成功时这条上多出一个「重试」，点它立刻再试一次。切到后台再回来、或连接断开重连时，没读到过列表的页面会重新拉齐整份快照。

## 能力边界

页面可操作的是这台机器上的**会话**，而非那台电脑的**界面**。以下能力目前在 Web 端暂未开放，多数已在后续计划中：

* **设置页**：Web 端暂未开放，配置修改请在桌面端 / VS Code / JetBrains 插件里完成。
* **插件市场、技能、子代理、钩子、MCP 服务**：电脑侧已具备上述能力，页面侧的管理视图待补充。
* **diff / 文件 / 预览面板**：需以整页或抽屉视图承载，尚在排期中。
* **上传文件**：电脑端自磁盘读取后上传，手机端需改为「浏览器读取文件 → 传输至电脑」的链路。
* **当前形态不适配**：打开本地文件（无编辑器可跳转）、终端（不开放远端 shell）、页面内登录退出（退出将注销该电脑）。

一项能力需同时满足「电脑侧提供方法」与「页面侧提供入口」才会呈现，缺一则不渲染入口。少数动作会额外确认一次，因其影响落在该电脑上：切换模型、rewind、`/clear`。