使用教程
配对完桌面后，App 自动跳转到「会话」页。本章逐屏讲解。
会话页
主入口，列出桌面所有会话（按文件夹分组）。
列表 + 搜索
| 元素 | 说明 |
|---|---|
| 顶部搜索框 | 全局搜索：标题 / 项目路径 / 消息内容 三合一 |
| 工具筛选 | 按 AI 工具过滤（Claude / Codex / Gemini …），只看某个工具的会话 |
| 位置筛选 | 会话分布在本机和远程主机上时出现，按「本机 / 某台远程主机」过滤 |
| 文件夹分组 | 默认按项目路径分组，折叠/展开记忆每个分组的状态 |
| 会话条 | 标题 + 最后一条消息预览 + 颜色标记 + 收藏星标；跑在远程主机上的会话带主机标识 |
| 长按条目 | 弹 ActionSheet（收藏 / 取消收藏 / 用此设置新建会话 / 删除）；「用此设置新建会话」沿用这条会话的项目路径、工具和启动参数，标题自动加「副本」 |
| FAB「+」 | 新建会话，可选工具与目录 |
软键盘自适应
v0.1.0 起，弹出新建会话弹窗时会响应软键盘，避免输入框被键盘挡住。
新建会话时点着选目录（v0.6.0+）
新建会话不用再手打路径了——目录选择器本机和远程 SSH 主机共用同一套界面：
- 逐级点进目录，也能直接看到桌面端最近用过的项目
- 就地新建文件夹，不必先切到电脑上建好再回来
- 选远程主机的目录时，会话就建在那台远程主机上（不会莫名归到本机）
会话列表里跑在远程主机上的会话会显示主机标识，一眼分得清哪些在本机、哪些在服务器。
进入会话
点会话条 → 跳到「对话」页，开始接收 AI 实时输出。
对话页 核心
实时流式接收 AI 输出，最重要的一屏。
消息渲染
| 消息类型 | 渲染方式 |
|---|---|
用户提问（human） |
蓝色背景气泡 |
AI 回复（assistant） |
Markdown 渲染 + 代码块语法高亮（v0.1.0 内置 highlight.js） |
工具调用（tool_use） |
卡片样式：工具名 + 参数 + 输出折叠展开 |
| 系统消息 | 灰色细字，不抢视觉 |
代码块支持的语言：JavaScript / TypeScript / Python / Rust / Go / Java / Bash / SQL / JSON / YAML / Markdown ...
一次回复一张卡（v0.9.0）
AI 的一轮回答收进一张卡片，只有一个头像、一个时间，不再按消息拆成好几张：
| 卡片区域 | 内容 |
|---|---|
| 过程 | AI 边做边说的说明文字 + 每一次工具调用（点开看输入与结果），标题显示「过程 · N 步」 |
| 回答 | 最后的结论文字，Markdown 渲染 |
过程区在 AI 回答中自动展开（看得到它正在干什么），答完自动折叠只留结论；你手动展开或收起过之后，以你的操作为准。Codex 的工具调用过程（例如调用某个 MCP 工具）同样会显示出来。
长按回复卡可复制整段回答。
顶部状态条
对话页标题下方的状态条告诉你这条会话和桌面的连接情况：
| 显示 | 含义 |
|---|---|
| 远程同步中 | 已连上，AI 的输出会实时推到手机 |
| 聊天模式 · 已连上桌面 | 这条会话在桌面上以聊天模式打开，可以正常发消息 |
| 聊天模式 · 正在回复… | 聊天模式会话的 AI 正在回答 |
| 桌面没开这个会话 · 发送时自动打开 | 不是故障：发消息时桌面会自动把它打开 |
| 未连上终端 · 发送时自动唤醒 | 同上，发消息时桌面会自动拉起这个会话 |
| 正在唤醒桌面… N s | 正在等桌面把会话拉起来；远程 SSH 会话会慢一些，耐心等即可 |
| 已断开 | 与桌面的连接断了，回到「设备」页检查桌面是否在线 |
发送 prompt
| 输入方式 | 操作 |
|---|---|
| 键盘打字 | 底部输入框 → 「发送」 → 桌面端 AI 自动开始回复 |
| 按住说话 | 麦克风按钮按住 = 录音 → 松开 = 识别 → 自动填入输入框；录音中上滑可取消 |
| 点一下说话 | 麦克风按钮点一下开始录，再点一下结束并识别 |
| 附件 | 输入框最左侧回形针按钮：选图片 / PDF / 文本类文件发给 AI，图片会自动压缩；也可以直接粘贴截图 |
| 快捷指令 | 回形针旁边的按钮：打开指令面板，「内置指令」是当前工具的斜杠命令，「我的片段」是桌面端「代码片段」里存的片段，点一下填进输入框 |
| 长按消息 | 复制单条消息内容到剪贴板 |
聊天模式会话也能发（v0.7.1）
桌面上以聊天模式打开的会话，手机发出的消息同样直达，回答也照常回流到手机。需要桌面端 v5.9.0 及以上。
两种语音模式（v0.6.0）
按住和点按同时支持，不用预先选——按下去的时长自动区分：短促一按走点按模式，按住不放走按住模式。
长口述举着手机按一分钟并不现实，所以补了点按模式；短句还是按住更顺手，就都保留。
录音期间没有任何浮层或遮罩，状态全部由麦克风按钮自己表达：
| 按钮状态 | 含义 |
|---|---|
| 红底 + 停止方块 + 计时 | 正在录音（按钮变宽显示秒数） |
| 橙底 + 转圈 | 正在识别 |
| 常态图标 | 空闲 |
录音和识别期间输入框始终可用，可以一边等识别一边打字。
麦克风权限
首次使用语音需要授予「麦克风」+「修改音频设置」两项权限（Android 在 Tauri Mobile WebView 上需要这两项才能正确激活录音）。 拒绝后再次点击会重新弹权限请求；如果系统设置里已禁用，需要去系统设置 → 应用权限手动开启。
输入框会自动长高
写长 prompt 时输入框多行自动增高，不用在一条缝里挤着写。
流式输出特性
- WebSocket 长连接接收 PTY 输出，断网自动重连
- 滚动到底部时自动跟随；向上滚动时停止跟随（保留你正在阅读的位置）
- AI 输出完成后弹「AI 回复完成」横幅 / 播放提示音（需要在「我的 → 通知」里开启）
- 有历史记录时，回复卡已经包含回答和工具过程，终端原文平时收起来，需要时点快捷条上的「终端」查看；读不到历史时才直接显示终端原文兜底
快捷操作条
输入框上方的一排按钮：
| 按钮 | 什么时候出现 | 作用 |
|---|---|---|
| 中断 | 只在 AI 正在回答时出现 | 打断当前这一轮回答。连点几下也只打断这一轮，不会把 CLI 退掉、上下文不会丢 |
| 按键 | 常驻；终端模式且已连上终端时可点 | 手动调出按键条（↑ ↓ ← → / Tab / Enter / Esc），选择卡片没自动出现、但 CLI 明显在等按键时用它 |
| 终端 | 有历史记录且终端有输出时 | 展开 / 收起终端原文 |
应答 AI 的选择询问（v0.7.0）
AI 在终端里停下来让你「选一项」（例如确认某个操作、选择方案）时，对话页底部会自动冒出一张 「AI 在等你选择」 卡片：
| 元素 | 说明 |
|---|---|
| 提问 | AI 问的问题，默认显示两行，点一下展开全文 |
| 选项按钮 | 每个选项一个按钮，编号与终端画面一致，当前光标所在项高亮；直接点就能选 |
| 「选后可输入」标记 | 选了这类选项后 CLI 会等你打字，输入框会自动获得焦点 |
| 刷新按钮 | 卡片右上角，重新读取一次桌面上的当前屏幕 |
| 按键条 | ↑ ↓ ← → / Tab / Enter / Esc，菜单之外的按键交互也能应付 |
识别不出选项时，卡片标题会变成「AI 可能在等按键」，这时请对照终端画面用按键条手动操作。如果卡片提示「屏幕上没显示光标位置」，建议用方向键手动移动后按 Enter，别直接点选项。
为什么不能直接打字回答
会话停在菜单上时，打进去的文字会被当成菜单按键，把选项顶乱。菜单要的是方向键和回车，所以手机上给的是按钮和按键条。
聊天模式的会话不显示按键条——它的选择询问不经过终端。
CLI 停在登录页（v0.9.0）
CLI 还没登录、停在浏览器授权页时，对话页底部会出现 「Codex 需要登录」（其他工具显示「CLI 需要登录」）提示卡：
- 这一页没有输入框，登录前发出的消息不会被它收到
- 此时点发送会先被拦一次，输入内容保留；确定仍要发的话再点一次发送
- 处理办法：在电脑上完成登录；也可以点快捷条「按键」按 Esc，再选「Sign in with Device Code」，用设备码在手机浏览器里登录（以终端画面上的提示为准）
- 登录完成后提示卡会自己消失
需要桌面端 v6.1.2 及以上。
Codex 会话的历史（v0.9.0）
Codex 会话（终端模式与聊天模式都算）在手机上也能看到完整的历史记录和工具调用过程，不再只能看终端原文。需要桌面端 v6.1.2 及以上。
历史为空时
如果对话页只显示「暂无历史消息」，手机端 v0.9.1 起会在下面补一行说明原因，例如：
| 提示 | 怎么办 |
|---|---|
| 桌面端版本过旧，升级后才看得到 XX 会话的历史 | 把桌面端升级到 v6.1.2 及以上 |
| 还没关联上 CLI 的会话记录 | 发一条消息，等 AI 开始回答后会自动关联 |
| CLI 还没写下这条会话的记录 | 等 AI 开始回答后就会出现 |
| 桌面没连上这条会话所在的远程主机 | 在桌面端把对应的远程主机连上 |
| 读取历史失败 | 检查网络后重新进入会话 |
拉历史时偶尔网络抖动失败，已经显示出来的历史会保留，不会被一下清成空白。
额度快用完时先确认（v0.9.2）
Claude 账号的额度到了桌面端设置的「额度守卫」线时，手机上新建会话、在会话里继续发消息之前，会先弹出确认，文案由桌面按你的套餐和重置时刻给出。确认后才会创建 / 发送；取消的话，输入框里的内容原样保留。会话的第一句不会再问（新建时已经问过）。
需要桌面端 v6.2.1 及以上；桌面端是旧版时不弹确认，照常发送。守卫线与开关见额度监控与通知。
驱动远程 SSH 会话（v0.6.0）
手机 → 桌面 → 远程服务器，这条链现在整个打通了。
在此之前手机只能在远程主机上建会话，建完发消息会一直等到超时报「唤醒桌面失败」——远程会话的终端跑在另一套管理器里，跟移动端接口从没接上。现在：
- 发消息能送达 — 手机发出的 prompt 正确路由到远端那个终端
- 实时输出照收 — 和本机会话一样走 WebSocket 流式接收
- 历史读得到 — 远程会话的历史记录存在远端主机上，现在会从远端读回来，不再是空白
桌面端停在本机也没关系
手机激活一个远程会话时，桌面端会自动切到对应的工作区再打开它——不需要你先跑到电脑前把工作区切过去。
设备页
管理多个桌面 + 切换 + 配对新桌面。
桌面列表
每个已配对的桌面显示：
| 字段 | 说明 |
|---|---|
| 名称 | 配对时填写的名称，可点「重命名」改成好认的名字 |
| 在线状态 | 当前桌面显示「在线 · 延迟 ms」/「连接异常」；其他桌面显示「未连接」 |
| 公网地址 | 这台桌面的远程访问地址 |
| 配对时间 | 「配对于 …」+「最后使用 …」 |
当前桌面上方还有三格实时数据：
| 数据 | 说明 |
|---|---|
| 活跃 PTY | 当前桌面有几个终端在跑 |
| 总会话 | 桌面端总会话数 |
| 服务版本 | 桌面端的版本号，排查功能是否可用时先看这里 |
操作
| 操作 | 说明 |
|---|---|
| 点击设备卡片 | 切换到该桌面并直接进入它的会话列表（v0.6.0；此前只切换，还得自己再回会话页） |
| 「切换为当前」 | 只切换、不离开设备页（想先看看状态或改名时用） |
| 「重命名」 | 修改这台桌面在手机上显示的名称 |
| 「删除」 | 确认后先通知桌面撤销本机的授权，再从列表移除，桌面端「已配对设备」表同步知道 |
| 「添加桌面」 | 右上角按钮，进入配对流程（扫码 / 手动 PIN） |
删除前先 selfRevoke
v0.1.0 起，移动端删除桌面前会主动调 /api/v1/auth/self-revoke 让桌面端撤销本设备的 token，再从本地列表移除。这样桌面端「已配对设备」表会自动移除该条目，不需要桌面端再手动清理。
我的页
个人中心 + 应用设置。
AI 回复完成提醒
- 开关 + 测试通知按钮
- 开启后，AI 输出结束会在 App 顶部弹出一条横幅（不是系统通知栏通知），点横幅可直接跳到对应会话
- 锁屏 / App 退到后台被系统清掉后收不到
「我的 → 通知」分组里的各项：
| 设置项 | 说明 |
|---|---|
| AI 回复完成提醒 | 横幅开关。你正看着的那个会话不弹，看着别的会话照弹；只在 App 处于前台时可见 |
| 发送测试 banner | 开启提醒后出现，点一下确认横幅能正常弹出 |
| 回复完成提示音（v0.8.0） | 默认关闭。开启后 AI 答完响一声，在对话页也会响——开着对话页、手机放一边等它答完是最常见的用法 |
| 音色 / 音量 / 试听 | 8 种音色与电脑端是同一套：叮咚 / 钟声 / 成功音 / 闹铃 / 气泡 / 水晶 / 梦幻 / 水滴 |
| 判定空闲时间 | 只在连接较旧的桌面端时生效：按终端输出停够几秒判定「答完了」 |
什么算「回复完成」
连接 v6.1.1 及以上的桌面端时，手机直接沿用桌面的判定（与电脑端提示音同一个）：报错的一轮、没有回答的一轮（如切模型、斜杠命令）不算，聊天模式的会话也会提醒。连接更早的桌面端时，按终端输出停顿几秒来判断，流式输出中途停顿较长时可调大「判定空闲时间」。
只在前台生效
提示音走手机媒体音量，静音 / 勿扰模式下同样会响。横幅和提示音都只保证 App 在前台时生效；锁屏或 App 被系统清掉后收不到。
检查更新与关于
| 入口 | 说明 |
|---|---|
| 检查更新 | 查询是否有新版本；新版需要手动下载 APK 覆盖安装 |
| 关于 | 作者信息、社区入口、推荐应用；v0.9.1 起显示安装包的真实版本号 |
| 页面底部 | 显示当前安装的手机端版本号 |
清空所有桌面配置
相当于「退出登录」：
- 弹确认对话框
- 对每个已配对桌面调
/api/v1/auth/self-revoke - 清空本地存储（已配对设备列表 / 会话缓存 / 通知历史）
- 回到首启动状态，需要重新配对
全局快捷操作
| 操作 | 触发方式 |
|---|---|
| 全局搜索（消息内容） | 「会话」页顶部搜索框 |
| 切换桌面 | 「设备」页点击桌面卡片，或点「切换为当前」 |
| 复制消息 | 「对话」页长按消息气泡 |
| 复制整段回答 | 「对话」页长按回复卡（手机端代码块没有单独的复制按钮） |
| 打断 AI | 「对话」页快捷条「中断」（仅回答中出现） |
下一步
- 常见问题 — 连不上 / 收不到通知 / 鉴权报错