使用教程
配对完桌面后，App 自动跳转到「会话」页。本章逐屏讲解。
会话页
主入口，列出桌面所有会话（按文件夹分组）。
列表 + 搜索
| 元素 | 说明 |
|---|---|
| 顶部搜索框 | 全局搜索：标题 / 项目路径 / 消息内容 三合一 |
| 文件夹分组 | 默认按项目路径分组，折叠/展开记忆每个分组的状态 |
| 会话条 | 标题 + 最后一条消息预览 + 颜色标记 + 收藏星标 |
| 长按条目 | 弹 ActionSheet（收藏 / 取消收藏 / 删除 / 重命名） |
| FAB「+」 | 远程新建会话（弹窗可选 project_path 或自定义） |
软键盘自适应
v0.1.0 起，弹出新建会话弹窗时会响应软键盘，避免输入框被键盘挡住。
进入会话
点会话条 → 跳到「对话」页，开始接收 AI 实时输出。
对话页 ★ 核心
实时流式接收 AI 输出，最重要的一屏。
消息渲染
| 消息类型 | 渲染方式 |
|---|---|
用户提问（human） | 蓝色背景气泡 |
AI 回复（assistant） | Markdown 渲染 + 代码块语法高亮（v0.1.0 内置 highlight.js） |
工具调用（tool_use） | 卡片样式：工具名 + 参数 + 输出折叠展开 |
| 系统消息 | 灰色细字，不抢视觉 |
代码块支持的语言：JavaScript / TypeScript / Python / Rust / Go / Java / Bash / SQL / JSON / YAML / Markdown ...
发送 prompt
| 输入方式 | 操作 |
|---|---|
| 键盘打字 | 底部输入框 → 「发送」 → 桌面端 AI 自动开始回复 |
| 按住说话 | 输入框右侧麦克风按钮：按住 = 录音（红色脉动）→ 松开 = 识别 → 自动填入输入框 |
| 长按消息 | 复制单条消息内容到剪贴板 |
麦克风权限
首次使用按住说话需要授予「麦克风」+「修改音频设置」两项权限（Android 系统在 Tauri Mobile WebView 上需要这两项才能正确激活录音）。 拒绝后再次点击会重新弹权限请求；如果系统设置里已禁用，需要去系统设置 → 应用权限手动开启。
流式输出特性
- WebSocket 长连接接收 PTY 输出，断网自动重连
- 滚动到底部时自动跟随；向上滚动时停止跟随（保留你正在阅读的位置）
- AI 输出完成后自动触发「AI 回复完成」通知（如果在「我的」里开启了通知开关）
设备页
管理多个桌面 + 切换 + 配对新桌面。
桌面列表
每个已配对的桌面显示：
| 字段 | 说明 |
|---|---|
| 设备名 | 桌面端的 hostname，可在桌面端设置中改 |
| 在线状态 | 绿圆点（连接中）/ 灰圆点（离线） |
| 活跃 PTY | 当前桌面有几个终端在跑 |
| 总会话数 | 桌面端总会话数 |
| 最近活跃 | 上次有 PTY 输出的时间 |
操作
| 操作 | 说明 |
|---|---|
| 点击设备 | 切换到该桌面（前端切换，不影响其他桌面） |
| 长按设备 | 「永久删除」（先 selfRevoke 撤销自己的 token，再从列表移除，桌面端同步知道） |
| 「+ 添加桌面」 | 进入配对流程（扫码 / 手动 PIN） |
删除前先 selfRevoke
v0.1.0 起，移动端删除桌面前会主动调 /api/v1/auth/self-revoke 让桌面端撤销本设备的 token，再从本地列表移除。这样桌面端「已配对设备」表会自动移除该条目，不需要桌面端再手动清理。
我的页
个人中心 + 应用设置。
AI 回复完成提醒
- 开关 + 测试通知按钮
- 开启后，App 在前台或后台未被系统杀死时，AI 输出结束会弹本地通知
- 锁屏 / 进程被系统强杀后无法收到（Web Notification 的局限）
清空所有桌面配置
相当于「退出登录」：
- 弹确认对话框
- 对每个已配对桌面调
/api/v1/auth/self-revoke - 清空本地存储（已配对设备列表 / 会话缓存 / 通知历史）
- 回到首启动状态，需要重新配对
全局快捷操作
| 操作 | 触发方式 |
|---|---|
| 全局搜索（消息内容） | 「会话」页顶部搜索框 |
| 切换桌面 | 「设备」页点击桌面或顶部下拉 |
| 复制消息 | 「对话」页长按消息气泡 |
| 复制完整代码块 | 代码块右上角「复制」按钮 |
下一步
- 常见问题 — 连不上 / 收不到通知 / 鉴权报错