遥控器，不是编辑器Orca Mobile companion 是 iOS / Android 应用，配对到你的桌面 Orca，提供「主要只读」的 Agent 视图：Agent 状态、近期终端滚动缓冲，以及你手机上真正想要的控制——回复 prompt、休眠工作树、评审 source control、切换 Agent 账号。桌面永远是 source of truth。
Orca Mobile 是什么
一个 iOS / Android 配套应用，与桌面 Orca 配对后，让你在手机上监控 Agent、在卡住时把它推一把。处于 beta 阶段：iOS 走 App Store / TestFlight 预览通道，Android 安装当前 APK。
它不是完整编辑器，而是已运行桌面的遥控器。
手机上能做什么
| 能力 | 说明 |
|---|---|
| 全局状态 | 跨所有已连接主机（本地桌面 + 远程 Orca 服务器）看每个工作树与其 Agent 状态（工作中 / 完成 / 等你输入） |
| 文件浏览 | 浏览工作区完整文件树（含深层嵌套路径），无需等待桌面 |
| 会话查看 | 以 Chat UI（聊天式转写）或原始终端打开受支持的 Agent 会话；可渲染 Mermaid 图 |
| 文本操作 | 长按选择 / 复制 / 粘贴；终端辅助键行提供 Tab、Shift+Tab |
| Live 模式 | 逐字符直送；听写的文本直接插入，不必按回车 |
| 快捷回复 | 发送 continue、yes、自由文本；附照片或文件；麦克风听写 |
| Quick Commands | 从会话标签条运行与桌面同步的保存命令 / Agent 提示词 |
| 浏览器 | 以 Web 或 Mobile 视图打开浏览器会话，检查响应式页面 |
| Source Control | 评审改动、暂存 / 取消暂存、从手机提交 |
| 账号与用量 | 切换 Agent 账号、查看用量 / 限流状态 |
| 创建工作区 | 与桌面一致的 Smart 源模式（Smart / GitHub / Linear / GitLab / Branch / Name） |
| 推送通知 | Agent 完成时收到推送，与桌面通知一致 |
配对流程
- 桌面端：从账号 / 状态菜单打开配对流程，Orca 显示一次性配对码
- 手机端：打开 companion 应用，选 Pair，粘贴配对码（也可从桌面深链直达配对屏）
一次配对即可；之后桌面是唯一事实来源。
多桌面：连接了多台桌面时，
New Workspace会先问由哪台 host 创建；单台已连接时跳过选择器。
设计定位与使用场景
- 读为主：先看 Agent 在干什么，而不是远程写代码
- 解卡：Agent 等你输入时，用一句话（
continue/ 意见 / 附件）把它从「卡住」推进到「继续」 - 收尾：评审 source control、切账号、看用量，回家路上就能完成
- 手机端不是替代桌面，而是「桌面上正在运行的工作」延伸到你的口袋
落地练习：配对并遥控一次
- 桌面打开配对流程，记下一次性配对码
- 手机装好 companion，完成 Pair
- 在手机上看每个工作树与 Agent 状态
- 让桌面 Agent 进入等待输入状态，从手机回复
continue - 用手机浏览一次文件树、打开一次 Chat UI 会话
怎么判断做对了？——你能说出「桌面是 source of truth、手机是遥控器」的定位，并完成一次从手机推进桌面 Agent 的完整操作。
卡住了怎么办？ 配对失败确认手机与桌面在同一网络 / Tailscale；看不到某个主机的工作树，检查该 host 是否已连接且手机列表已包含它。
小结
- Mobile companion = 只读为主的 Agent 遥控器（iOS / Android，beta）
- 能力：状态、文件树、Chat UI / 终端、回复与听写、Quick Commands、Source Control、账号切换、推送
- 配对：桌面一次性码 → 手机 Pair，一次完成
- 桌面是 source of truth；手机是它的延伸
- 多桌面时创建 workspace 会先选 host
下一节，多账号热切换与用量追踪。