Orca App

Orca App是编码Agent统一调度中心Orca的手机移动端应用。它可与您的桌面Orca配对，为您提供一个以阅读为主的运行中的代理视图——包括代理状态、最近的终端滚动回溯，以及您真正想在手机上使用的控制功能（回复提示、休眠工作树、查看版本控制、切换代理账户）。配对只需进行一次，桌面端始终是唯一的事实来源。

Orca App使用教程

第一步：手机连接桌面工作环境

打开 Orca Mobile 后，可以看到已连接的桌面 Host、正在运行的 worktree，以及 Agent 的使用情况。我的 电脑1通过局域网直连（外出时会自动切换到官方提供的免费公网），我的obsidian_wiki 工作区也出现在最近使用列表中。

手机端已经连接桌面 Host，可以继续最近使用的 obsidian_wiki 工作区进入 Host 后，Orca 会按项目列出全部工作区，并显示每个 Agent 的状态和最近一条消息。我可以直接找到 obsidian_wiki，不需要先打开远程桌面，也不需要在手机上手敲一长串终端命令。

从项目和 worktree 列表进入 obsidian_wiki，列表同时展示工作区与 Agent 的状态

第二步：选择 Codex，直接描述写作任务

进入工作区后，可以新建 Claude、Codex、Hermes、OpenClaw、普通终端、浏览器或 Markdown Note 等不同类型的标签页。这次我选择 Codex，并直接输入生成Markdown。

同一个 worktree 中可以按任务启动不同 Agent；这次写作使用 Codex

这个输入没有指定标题、字数和固定提纲，只给了项目地址、目标目录和文章类型。接下来，Codex 自己拆出了资料核验、文章构思、写作和复核几个步骤。

第三步：让 Agent 分工研究，而不是直接“凭印象写”

从执行记录可以看到，Codex 没有立刻生成一篇项目介绍，而是先核对 Orca 的官方 README、功能定位和最新使用方式，同时启动独立的研究与文章结构任务，再检查本地目录中已有文章的风格。

手机端可以查看工具调用和执行记录，了解 Agent 正在研究什么、修改什么

过程中还出现了一次 WebSocket 连接告警，Orca 随后提示回退到 HTTPS。对我来说，移动端的价值不只是“发出一句话”，而是可以随时回来查看任务是否仍在推进、有没有报错、是否需要补充信息。

这里也能看出多 Agent 的实际用法：不是为了让三个人重复写三篇文章，而是把资料研究、内容结构和最终核验拆给不同角色。 主 Agent 负责整合，独立复核者负责找出事实或表述问题。

第四步：直接检查生成文件

写作完成后，我从 Orca Mobile 的 Files 页面进入 自媒体/微信公众号，可以看到新生成的 stablyai-orca.md，旁边的 stablyai-orca_assets 则存放文章图片。

文章被直接写入指定的 Obsidian 目录，不需要再从聊天窗口复制粘贴

第五步：在手机上预览，再继续迭代

点开 Markdown 文件后，Orca 可以直接渲染标题、正文、列表、粗体和链接。我在手机上通读文章，确认内容已经写入正确位置，也能点击编辑按钮继续修改。

生成后的 Markdown 可以直接预览；发现问题后，再回到 Agent 会话追加修改要求

这次实测最终形成了这样一条链路：

手机提出需求 → 桌面 Host 上的 Codex 调研与写作 → 独立任务复核 → 文件写入 Obsidian → 手机预览 → 继续追加修改。

它并没有让手机变成完整开发机，却把原本需要守在电脑前完成的“发任务、看进度、查文件、做反馈”压缩到了一个移动端入口。对于资料整理、技术文章、周报和文档维护这类异步任务，这种体验比在手机上远程控制桌面自然得多。

从移动设备上可以做什么

• 查看所有工作树、其代理以及当前状态（正在工作 / 已完成 / 等待输入）。移动端将您连接的所有主机（本地桌面和远程 Orca 服务器）的工作树汇总在一个视图中，因此切换它们无需更换设备。

• 从移动设备浏览工作区的完整文件树——包括深度嵌套的路径——以便无需等待桌面即可直接打开任何文件。

• 在 聊天界面（一种聊天风格的记录）或原始终端中打开支持的代理会话。在“设置”→“聊天界面”中设置设备默认值，或长按会话标签页以仅切换该标签页。

• 刷新最近的终端滚动缓冲区，以便您可以查看代理执行或询问了什么。在聊天风格视图中，当消息包含它们时，Markdown 可以渲染 Mermaid 图表。

• 从移动终端视图中选择、复制并粘贴文本——长按选择，使用分享菜单将文本粘贴回回复中。

• 使用终端辅助行来处理在手机键盘上操作不便的按键，包括 Tab 和 Shift+Tab，或者当每个输入的字符都应直接发送到活动终端时，切换到 Live。

• 当代理人等待输入时，发送简短回复（continue, yes, 自由文本），附上照片或文件，或点击麦克风进行语音输入。在实时模式下，语音输入的内容会自动插入到活动终端中，无需按回车键。在聊天界面中，附带的图片会显示为消息缩略图，可选择是否附带文本发送。

• 运行快速命令来自会话标签页条带——已保存的终端命令或代理提示，与桌面列表同步。

• 长按会话标签页以执行批量关闭操作（关闭其他标签页, 关闭左侧标签页, 关闭右侧标签页）。未保存的 markdown 标签页和固定标签页将被跳过。

• 在 Web 或 移动视图中打开浏览器会话，以便您在手机上查看响应式页面。

• 为工作树提供开源控制，以便您在手机上查看已更改的文件、暂存或取消暂存，并提交。

• 切换您的活动代理账户，随时查看使用情况和速率限制状态。当 Codex 赚取到重置积分时，请在账户界面中花费其中一个。

• 从移动设备创建工作区，使用与桌面相同的智能源模式：智能、GitHub、Linear、GitLab、分支和名称。当有多个连接的桌面时，新建工作区会询问哪个主机应首先创建它（一个连接的主机将跳过选择器）。

• 打开主机卡⋯的菜单，用于编辑、连接、移除以及相关操作（长按仍然可作为快捷方式）。

• 在不重新配对的情况下编辑已保存的主机显示名称或连接地址（例如当桌面在家庭局域网和 Tailscale 之间移动时）。

• 当代理完成时获取推送通知，与桌面通知相同。

这款移动应用程序并非完整的编辑器——它只是您已在运行的桌面版的遥控器。

配对

1.在桌面端，从账户/状态菜单中打开 Orca 的配对流程。Orca 会显示一个一次性配对码。

2.在移动设备上，打开 Orca 伴侣应用并选择 配对，然后粘贴代码。（您也可以直接从桌面端通过深度链接进入移动端的配对界面。）

3.优先使用Orca Relay进行配对（当其可用时）——Relay 仅需登录。Relay 上的本地网络地址选择器是可选的（当您需要 LAN 快速路径时请展开它）；LAN 配对仍然需要一个地址。

4.配对交换为该手机建立了一个设备令牌；请保持您所选路径上的桌面可访问。

关闭桌面应用程序会中断直接/局域网会话，直到您重新打开它。基于中继的配对会遵循桌面中继连接——如果主机离线，请重新打开桌面应用程序。

配对后，手机会从桌面设备的计算机名称中获取主机名并显示其操作系统。您可以在桌面设置 → 远程 Orca 服务器中更改计算机名称；手机在重新连接时会获取此更改。

聊天界面

• 对于支持聊天的代理（如 Claude、Codex 以及 Orca 认可的其他代理），移动端可以在 聊天界面中打开会话，而不是原始终端——这与桌面版的 聊天界面相同：包含可读的对话记录、输入框、权限/问题提示以及图片附件。

• 设备默认 — 首次启动时，移动端会询问在此手机上如何打开会话。您可以在 设置 → 聊天界面 → 在聊天界面中打开会话中稍后更改。默认情况下，会话将在终端中打开，直到您选择聊天界面。

• 按会话 — 长按会话标签页并选择 切换到聊天视图 或 切换到终端视图。该覆盖设置将保留在该标签页上，而不会更改设备默认设置。

• 作曲家 — 输入回复，@ 提及工作区文件，使用来自共享目录的智能代理命令（包含描述的 Claude 与 Codex 设置），附上照片，或进行语音输入。附带的图片将显示为可移除的缩略图，并在发送时随之发送（包括仅图片发送和多图片附件）。/

• 模型和会话选项 — 编排器会显示当前模型和会话选项的药丸行。点击它以选择模型或选项（包括直接选择 Codex 模型和提供商感知的快速模式（当活动模型支持时）），而无需进入原始终端。

• 桌面端仍拥有代理 — 聊天界面是配对桌面会话的视图，而非独立的云端代理。

快捷命令

从工作树会话中，打开 快速命令，位于会话标签页条（新终端旁）。命令列表与桌面端相同，并双向同步。

• 终端命令 — 在新标签页中粘贴或运行 shell 命令（可选地无需按回车键，以便您先进行编辑）。

• 代理提示 — 使用保存的提示正文打开选定的代理。

• 从行复制控件（当内容为空时禁用）复制命令主体到剪贴板。

• 命令全局生效或仅对当前项目生效。可从工作表中添加、编辑和删除；桌面主机强制执行共享列表的上限。

如果配对的桌面太旧，在您更新桌面之前，启动器将被禁用。

会话标签页

长按会话栏中的标签页以执行标签页操作，包括关闭、关闭其他标签页、关闭左侧标签页、以及关闭右侧标签页。批量关闭会跳过未保存的 Markdown 标签页（移动端关闭时无保存提示）和置顶标签页。对于支持聊天功能的代理标签页，相同的长按菜单可以切换聊天界面 ↔ 终端。

账号切换器

移动应用程序暴露了与桌面状态栏相同的账户切换器，包括对非活动账户的行内使用。当提供商为其会话或每周窗口报告重置时间戳时，账户屏幕会显示重置倒计时。在此处切换会启用配对的桌面端。

当活动的 Codex 账户赚取了 速率限制重置 积分时，账户界面会显示可用积分数量（以及下次到期时间）和一个 使用重置 操作。确认操作会消耗当前 Codex 目标（主机或 WSL 发行版）的一个积分，并刷新符合条件的速率限制窗口。手机会记录该尝试，以便在连接不稳定后重试时不会重复扣费。结果包括成功、没有符合条件的重置项、积分不足，或重置已应用。

创建工作区

从移动主屏幕，打开 创建工作区 / 新建工作区并选择一个来源模式。 智能会在支持的任务提供商和分支中进行搜索；特定提供商的模式会将创建范围缩小到 GitHub、Linear、GitLab、一个分支或一个纯工作区名称。选择来源后，使用 高级进行命名和分支控制，然后再在配对的桌面端创建工作区。如果连接了多个桌面端，请先选择主机（选择器会显示每个端点，以便相似名称保持可区分）。如果没有连接桌面端，此操作将保持禁用状态。

编辑配对主机

在主机列表中，点击主机卡片上的⋯按钮（或长按卡片）并选择编辑主机。

• 名称 — 仅在此手机上显示的名称。这会覆盖桌面上的计算机名称；将其清空以重新使用桌面名称。

• 地址 — IP，host:port，或ws:// / wss://。缺少端口将保留当前端口（或默认为6768）。地址编辑仅更改此电话连接的位置；它们不重新配对。当同一台桌面计算机可通过不同路径访问时使用此选项（例如家庭局域网与 Tailscale）。

保存地址更改后会重新连接到新的端点。配对令牌保持不变。

移动端版本控制

从工作树会话中，点击分支图标打开源代码管理。用于处理小型后续操作：检查分支状态、检查已更改的路径、暂存或取消暂存文件，并在暂存集合准备就绪后提交。如果分支已经存在 GitHub 拉取请求，请使用 链接现有 PR，从空 PR 状态附加它，而不是创建新的 PR。

移动端浏览器视图

移动浏览器面板有一个Web / 移动切换按钮。使用Web查看常规页面，使用移动则要求配对的桌面浏览器提供手机尺寸的响应式视口。

终端设置

移动终端有一个专用的终端设置界面（设置 → 终端）：

• 文本大小 — WebView 在 fit-to-width 基础上应用的 50%–200% 基准缩放。在终端中进行捏合缩放会锁定在相同的预设值上并保持不变。此设置是针对特定设备的，不会更改桌面终端。

• 自动补全与自动更正 — 默认关闭，因此操作系统永远不会在命令栏中重写命令、标志或路径。开启后可实现手机式的输入；无论如何，实时键盘捕获输入仍会以原始按键流的形式传输。

故障排除

• 工作树上的卡住的加载指示器 — 手机会跟踪桌面代理进程的心跳。如果桌面显示空闲但手机显示正在工作，请强制刷新工作树行以同步状态。

• 配对失败 — 确保您的桌面和手机已登录同一 Orca 账户。配对代码会在几分钟后过期；如果代码已在屏幕上停留一段时间，请生成一个新的。

• 身份验证失败 / 配对无效 — 桌面端不再接受此设备令牌（例如桌面端已清除已配对设备）。请先尝试重试横幅上的操作（临时拒绝可能无需重新配对即可恢复）。如果持续失败，请使用从桌面端重新配对，或移除主机并重新配对。

• 更新 Orca 移动版 / 在您的电脑上更新 Orca — 手机和桌面端使用带版本号的移动协议。如果任一端版本过旧，移动端会屏蔽该主机并引导您前往 App Store (iOS)，GitHub Releases (Android APK 或桌面端)，然后返回主机。更新后，刷新连接；如果消息仍未显示，请移除主机并重新配对。

• 快速命令不可用 — 更新配对的桌面，使其宣传快速命令功能。

• 无法连接到桌面端 — 手机和桌面端必须共享网络路径（局域网、Tailscale 或您使用的配对路径）。关闭桌面端应用会断开连接；重新打开桌面端应用后，手机会自动重新连接。