移动端伴侣
将 DevAgent 移动应用与你的桌面配对，以便从手机上监控 agent 并让卡住的 worktree 恢复运转。
DevAgent 移动端伴侣是一个 iOS/Android 应用，可与你的桌面 DevAgent 配对，为你提供以只读为主的运行中 agent 视图——agent 状态、近期终端回滚（scrollback），以及你真正想在手机上使用的那些控制（回复某个提示、让某个 worktree 休眠、审查源代码管理、切换 agent 账户）。配对只需一次，桌面端始终是权威数据源（source of truth）。
Beta
移动端伴侣处于 beta 阶段。iOS 加入 TestFlight 预览渠道，或从 最新 APK 安装 Android 版。
你能在移动端做什么
- 查看每个 worktree、它的 agent 及其当前状态（工作中 / 完成 / 等待输入）。移动端会在单一视图中列出你所连接的每个主机（本地桌面和远端 DevAgent 服务器）的 worktree，因此在它们之间切换无需更换设备。
- 在移动端浏览工作区的完整文件树——包括深层嵌套的路径——因此你无需等待桌面端即可跳转到任意文件。
- 在 Chat UI（聊天风格的对话记录）或原始终端中打开受支持的 agent 会话。在 设置 → Chat UI 中设置设备默认值，或长按某个会话 标签页 只切换该 标签页。
- 拉取近期的终端回滚内容，以便你能阅读某个 agent 做了什么或问了什么。当消息包含 Mermaid 图表时，聊天风格视图中的 Markdown 可以渲染它们。
- 从移动端终端视图中选择、复制和粘贴文本——长按以选择，通过分享面板（share-sheet）将内容粘贴回某条回复。
- 使用终端配件行（accessory row）来输入在手机键盘上不便输入的按键，包括
Tab和Shift+Tab，或者切换到 Live，让每个输入的字符都直接进入活动终端。 - 当某个 agent 在等待输入时，发送一条简短回复（
continue、yes、自由文本），附上一张照片或文件，或点击麦克风来口述回复。在 Live 模式下，口述的文本会插入活动终端而不会替你按回车。在 Chat UI 中，附加的图片会作为缩略图显示在你的消息上，并可带文本或不带文本一起发送。 - 从会话 标签页 条中运行 Quick Commands——已保存的终端命令或 agent prompt，会与桌面端列表同步。
- 长按某个会话 标签页 以进行批量关闭操作（Close Other 标签页、Close 标签页 to the Left、Close 标签页 to the Right）。未保存的 markdown 标签页 和已固定的 标签页 会被跳过。
- 当你需要从手机查看某个自适应页面时，以 Web 或 Mobile 视图打开一个浏览器会话。
- 为某个 worktree 打开 Source Control，以便从手机审查已更改的文件、暂存或取消暂存并提交。
- 随时随地切换你的活动 agent 账户，并查看用量 / 速率限制状态。当 Codex 已获得重置额度时，可从账户界面消费一个。
- 使用与桌面端相同的 Smart source 模式从移动端创建工作区：Smart、GitHub、Linear、GitLab、Branch 和 Name。在连接了多个桌面时，New Workspace 会先询问应由哪个主机创建（只连接了一个主机时会跳过选择器）。
- 打开某个主机卡片的 ⋯ 菜单以进行 Edit、Connect、Remove 及相关操作（长按仍可作为快捷方式）。
- 编辑已保存主机的显示名称或连接地址而无需重新配对（例如当桌面在家庭 LAN 和 Tailscale 之间切换时）。
- 当某个 agent 完成时收到推送通知，与桌面通知保持一致。
移动应用有意做成不是一个完整的编辑器——它是你已经在运行的那个桌面端的遥控器。
配对
- 在桌面端，从账户 / 状态菜单打开 DevAgent 的配对流程。DevAgent 会显示一个一次性配对码。
- 在移动端，打开 DevAgent 伴侣应用并选择 Pair，然后粘贴配对码。（你也可以从桌面端跟随一个深链接直接进入移动端配对界面。）
- 在可用时优先使用 DevAgent Relay 进行配对——仅 Relay 需要登录。在 Relay 上，本地网络地址选择器是可选的（当你想要一条 LAN 快速通道时展开它）；LAN 配对仍然需要一个地址。
- 配对交换会为该手机建立一个设备 token；请让桌面端在你所选择的路径上保持可达。
关闭桌面应用会中断直连/LAN 会话，直到你重新打开它。基于 Relay 的配对跟随桌面 Relay 连接——如果主机离线，请重新打开桌面端。
Chat UI
对于支持聊天的 agent（Claude、Codex 以及 DevAgent 能识别的其他 agent），移动端可以在 Chat UI 而非原始终端中打开会话——与桌面端的 Chat UI 是同一思路：可读的对话记录、编辑器（composer）、权限/问题，以及图片附件。
- 设备默认值 —— 首次启动时，移动端会询问在这台手机上会话应如何打开。之后可在 设置 → Chat UI → Open sessions in Chat UI 中更改。在你选择 Chat UI 之前，默认是终端。
- 按会话 —— 长按某个会话 标签页 并选择 Switch to chat view 或 Switch to terminal view。该覆盖设置会对该 标签页 生效，而不改变设备默认值。
- 编辑器（composer） —— 输入回复，用
@提及工作区文件，使用来自共享目录的 agent 感知/斜杠命令（Claude 与 Codex 的命令集，带描述），附加照片，或口述。附加的图片会以可移除的缩略图形式出现，并在发送时一同带上（包括仅图片发送和多图附件）。 - 模型与会话选项 —— 编辑器会显示一行当前模型和会话选项的胶囊标签（pill row）。点击它即可选择模型或选项（包括直接选择 Codex 模型），而无需退回到原始终端。
- 桌面端仍然拥有该 agent —— Chat UI 是对已配对桌面会话的一个视图，而非一个独立的云端 agent。
Quick Commands
在某个 worktree 会话中，从会话 标签页 条（新终端旁边）打开 Quick Commands。这些命令与桌面端是同一份已保存列表，并双向同步。
- Terminal Command —— 在新 标签页 中粘贴或运行一条 shell 命令（可选择不按回车，以便你先编辑）。
- Agent Prompt —— 用某个已保存的 prompt 主体打开选定的 agent。
- 从该行的复制控件将命令主体复制到剪贴板（主体为空时禁用）。
- 将命令作用域设为全局或当前项目。从该面板中添加、编辑和删除；桌面主机会强制执行共享列表的上限。
如果已配对的桌面端版本太旧，启动器会被禁用，直到你更新桌面端。
会话 标签页
在会话条中长按某个 标签页 以进行 标签页 操作，包括 Close、Close Other 标签页、Close 标签页 to the Left 和 Close 标签页 to the Right。批量关闭会跳过有未保存改动的 markdown 标签页（移动端在关闭时没有保存提示）和已固定的 标签页。对于支持聊天的 agent 标签页，同一个长按面板可以在 Chat UI ↔ 终端之间切换。
账户切换器
移动应用提供与桌面状态栏相同的账户切换器，包括未激活账户的内联用量。当某个提供方为其会话或每周窗口报告重置时间戳时，账户界面会显示重置倒计时。在此处切换会切换已配对的桌面端。
当活动的 Codex 账户已获得速率限制重置额度时，账户界面会显示有多少可用额度（以及下一个何时过期）以及一个 Use reset 操作。确认后会为当前 Codex 目标（主机或 WSL 发行版）消费一个额度，并刷新符合条件的速率限制窗口。手机会记录该尝试，以便在连接不稳定后的重试不会重复消费。结果包括成功、没有可重置的项、没有剩余额度，或已经应用过一次重置。另见 用量与速率限制追踪。
创建工作区
在移动端主界面，打开 Create Workspace / New Workspace 并选择一种 source 模式。Smart 会在受支持的任务提供方和分支中搜索；各提供方专属模式会把创建范围收窄到 GitHub、Linear、GitLab、某个分支，或一个纯工作区名称。选择 source 后，在桌面端创建工作区之前使用 Advanced 进行命名和分支控制。如果连接了不止一个桌面，请先选择主机（选择器会显示每个端点，以便相似的名称仍能区分）。在没有连接桌面时，该操作保持禁用。
编辑已配对的主机
在主机列表中，点击主机卡片的 ⋯ 按钮（或长按该卡片）并选择 Edit host。
- Name —— 仅在这台手机上的显示名称。
- Address —— IP、
host:port，或ws:///wss://。缺少端口时会保留当前端口（或默认为6768）。地址编辑只改变这台手机的连接位置；它不会重新配对。当同一个桌面在不同路径可达时使用它（例如家庭 LAN 与 Tailscale）。
保存地址更改会重新连接到新端点。配对 token 保持不变。
移动端的源代码管理
在某个 worktree 会话中，点击分支图标以打开 Source Control。用它做一些小的后续处理：查看分支状态、检查已更改的路径、暂存或取消暂存文件，并在暂存集就绪后提交。如果该分支已经有一个 GitHub pull request，请从空 PR 状态中使用 Link an existing PR 来关联它，而不是新建一个。
移动端的浏览器视图
移动端浏览器 窗格 有一个 Web / Mobile 切换。使用 Web 查看正常页面，使用 Mobile 请求已配对的桌面浏览器提供手机尺寸的自适应视口。
终端设置
移动端终端有一个专门的 Terminal settings 界面（设置 → 终端）：
- Text size —— 一个 50%–200% 的基准缩放，WebView 会在按宽度适配（fit-to-width）之上应用它。在终端中双指缩放会吸附到相同的预设值并持久保存。该设置按设备生效，不会改变桌面终端。
- Autocomplete & autocorrect —— 默认关闭，因此操作系统永远不会改写命令栏中的命令、标志或路径。开启它以获得手机式输入体验；无论开启与否，实时键盘捕获输入仍会流式传输原始按键。
排查
- worktree 上的转圈卡住 —— 手机会追踪来自桌面 agent 进程的心跳。如果桌面显示空闲但手机显示工作中，请强制刷新该 worktree 行以同步状态。
- 配对失败 —— 确保你的桌面和手机登录了同一个 DevAgent 账户。配对码会在几分钟后过期；如果它已在屏幕上停留一段时间，请生成一个新的。
- 认证失败 / 配对无效 —— 桌面端不再接受这个设备 token（例如在桌面端清除了已配对设备之后）。先尝试横幅上的 Retry（临时性的拒绝可能无需重新配对即可恢复）。如果持续失败，请从桌面端使用 Re-pair，或 Remove 该主机后重新配对。
- Update DevAgent Mobile / 更新你电脑上的 DevAgent —— 手机和桌面遵循一个带版本的移动协议。如果任一方太旧，移动端会屏蔽该主机并引导你前往 App Store（iOS）、GitHub Releases（Android APK 或桌面端），然后返回主机列表。更新后，刷新连接；如果该消息仍在，请移除该主机后重新配对。
- Quick Commands 不可用 —— 更新已配对的桌面端，使其公布 quick-commands 能力。
- 无法连接到桌面 —— 手机和桌面必须共享一条网络路径（LAN、Tailscale，或你所用的配对路径）。关闭桌面应用会中断连接；重新打开桌面端后手机会自动重连。
后续步骤
将移动端通知与桌面通知配对，让 agent 完成的提醒送达正确的设备。对于无头（headless）机器，请使用 远端 DevAgent 服务器 的移动端配对。在 用量与速率限制追踪 下于桌面和移动端追踪提供方用量。