Orca 移动端不是把桌面 IDE 硬塞进手机,而是让你离开电脑后仍能看状态、读终端、回复 Agent 并接收完成通知。本文把安装、三步配对、Live 模式、可做事项与排障边界一次讲清。
一、手机上能干嘛:上百 Agent 尽在掌心

Orca 手机伴侣 App 的定位是 read-mostly 视图:桌面端仍是唯一权威源,手机负责远程观察和轻量指挥。你可以把本地与远程服务器上的 worktree、Agent 聚合到一处,快速分辨谁在 working、谁已 done、谁正 waiting,不必反复回到电脑前巡检。
这套思路尤其适合并行任务多、账号多的玩家。Agent 正常干活时只看状态,等待确认时再从手机回复,结束后靠推送收口。官方展示过“Orchestrating 600 agents from my phone”的用户案例,但重点不是夸张的数字,而是把注意力放在真正需要人工介入的节点。
状态聚合也让巡检更有顺序:先看 waiting,处理必须由人回答的问题;再看 done,确认完成推送对应哪个工作区;最后扫一遍 working,判断任务是否仍在推进。手机只承担这层轻量调度,就能把多个终端从“不断切回去看”变成“有需要再介入”。
完成推送则负责最后提醒,让你不必一直亮屏守着进度。
二、安装:iOS 与 Android
iOS 用户从 App Store 或 TestFlight 安装;Android 用户使用 GitHub Releases 提供的 APK,官方给出的版本示例为 0.0.31。移动伴侣当前仍处于 Beta,使用前要接受它以监控和遥控为主,而不是完整桌面替代品。
安装 App 只是第一步,手机必须与正在运行的 Orca 桌面端配对,而且两端需要登录同一个 Orca 账户。它没有云中继:桌面关闭后连接会断开,桌面重新打开后则会自动重连。
三、配对三步:桌面出码,手机粘贴
- 桌面出码:在 Orca 桌面的账户或状态菜单打开配对流程,界面会显示一次性配对码。
- 手机粘贴:打开手机 App,选择 Pair 并粘贴配对码;也可以通过桌面深链接直接进入对应流程。
- 直接交换:桌面与手机直接交换信息并生成设备令牌,之后由这个设备关系维持连接。
配对码并不是长期密码,只有几分钟有效期。若中途搁置太久,不要反复提交旧码,回桌面重新生成即可。也别忽略同账户要求:桌面和手机登录的 Orca 账户不一致,配对不会成功。
四、手机能做的操作

移动端能覆盖“看进度、补一句、做轻量版本控制、收结果”这条链路,常用操作包括:
- 查看全部 worktree 与 Agent 的 working、done、waiting 状态,并聚合本地和远程服务器上的任务。
- 浏览文件树,加载终端 scrollback;长按可复制,辅助键行提供 Tab 与 Shift+Tab。
- 切到 Live 模式后,输入内容会逐字直达终端,适合需要直接与终端会话交互的时刻。
- Agent 等待时发送 continue、yes 或自由文本,也可以附照片、文件,或用麦克风口述。
- 打开浏览器会话;在 Source Control 中查看变更、暂存、提交,并 Link an existing PR。
- 切换活动 Agent 账户并查看用量,用 Smart source 建工作区,在任务完成时接收推送。
日常用法可以很克制:先从状态列表找到 waiting 的行,读完终端上下文再回复;需要持续输入时才开 Live。这样手机承担的是“决策入口”,大量编辑、审查和复杂终端操作仍留给桌面。
Source Control 也适合做短链路操作:先看变更是否属于预期,再暂存和提交;已有 PR 时使用 Link an existing PR。若上下文不足,就回到文件树或终端 scrollback 补齐信息,而不是在不清楚改动来源时仓促操作。照片、文件和麦克风口述则适合把现场材料快速交给正在等待的 Agent。
五、有意为之的限制
移动伴侣不是完整编辑器,而是桌面 Orca 的远程遥控器。文件树和终端 scrollback 方便理解现场,却不等于在手机上接管全部开发工作;桌面仍保存权威状态,关掉桌面也就没有可供手机中继的会话。
另外,终端设置按设备分别保存,自动补全默认关闭。这些限制与 read-mostly 定位一致:移动端优先保证你能看、能回应、能收通知,而不是复制桌面端所有能力。遇到长 diff、复杂修改或大段输入,回桌面处理更稳妥。
六、常见故障排查
worktree 一直转圈:先对对应 worktree 行执行强制刷新,让手机重新获取这一行的状态。不要因为一次加载停顿就重新配对整台设备。
配对失败:先确认桌面与手机使用同一 Orca 账户,再看一次性配对码是否已经超过几分钟有效期;过期就回桌面生成新码。若桌面已经关闭,先重新打开,等待移动端自动重连。
输入方式不合适:只需确认时发送 continue 或 yes;需要自由文本再正常回复;只有确实要逐字送入终端时才使用 Live 模式。先分清场景,能减少误操作。
Agent 连不上 x.ai/anthropic/google?先解决稳定的海外网络。
延伸阅读
主题授权提示:请在后台主题设置-主题授权-激活主题的正版授权,授权购买:RiTheme官网

评论(0)