用手机控制 1DevTool
通过局域网、Cloudflare 隧道或 Tailscale 使用 Remote Control,在手机上运行 Agent、查看 diff、批准计划并关注你的团队。
Remote Control 把你的手机变成一扇窗口,连接到正在运行 1DevTool 的那台电脑。你可以在沙发上启动一个 Agent,在火车上审查 diff,或者回复一条一直在等你输入的提示——全程无需打开笔记本电脑。所有内容都运行在你自己的机器上,手机只是遥控器。

开启方式
- 在桌面端,从状态栏打开 Remote Control 并启用它。
- 1DevTool 会生成一个私有 URL 和一个二维码。用手机扫描二维码,或在手机浏览器中打开该 URL。
- 根据提示登录。该连接与你的机器绑定——只有你能访问。
三种连接模式
- Local Network — 手机和桌面端处于同一个 Wi-Fi 下。
- Cloudflare Tunnel — 一条安全的 Cloudflare 隧道,无需暴露端口,也无需配置 VPN。
- Tailscale / VPN — 手机通过你自己的 tailnet 访问桌面端。
如果你已经在用 Tailscale,值得花点时间配置:不会向公共互联网暴露任何内容,没有隧道预热等待,并且完整支持 iOS Safari,因此在家庭网络下不必被迫使用应用内的扫码浏览器。面板会明确告诉你 Tailscale 是否已安装、正在运行并已连接,并把二维码和配对 URL 切换为 tailnet 地址。当你的 tailnet 需要启用 HTTPS 时,会有一个一次性的引导步骤帮你完成。
启动时自动开启
在 Settings → Remote 中打开 Start on Launch,每次 1DevTool 启动时远程服务器都会随之启动,这样已配对的手机在重启或更新后会自动重新连接。开关旁边的徽标会显示它启动时使用的模式。
- Local Network — 应用一打开,服务器就会在你的 Wi-Fi 上启动。
- Tailscale — 如果重启后 Tailscale 仍在连接中,1DevTool 最多会等待它两分钟,期间先在本地网络上提供服务。
- Cloudflare Tunnel 是公开的,因此永远不会自动启动。选中该模式时开关会被关闭;若要使用 Start on Launch,请选择 Local Network 或 Tailscale。

手机 App
获取 App。 在 iPhone 和 iPad 上,从 App Store 安装 1DevTool。它免费,需要 iOS 17 或更高版本。在 Android 上,从 Google Play 安装 1DevTool。同样免费,需要 Android 8.0 或更高版本。
Settings → Remote 有两个标签页:Web UI(即本页介绍的全部内容)和 Phone(仍带有 Beta 标签)。Phone 标签页承载 1DevTool 移动应用。该主机默认关闭。开启后,它会在你的局域网或 Tailscale tailnet 上监听 Remote Control 端口。该链路为端到端加密,不涉及任何中继或隧道。Cloudflare 隧道仅用于浏览器客户端。
Phone 标签页还链接到一份设置指南 Read how to install and use the 1DevTool mobile app beta →,你也可以在这里阅读。这份指南是为 Beta 写的,所以在 iPhone 上请从 App Store 安装,而不是 TestFlight;在 Android 上请直接从 Google Play 安装,无需申请邀请。其余设置步骤依然适用。
该区域会列出手机可以访问的地址,并显示一个十分钟后过期的 Pairing code,旁边有 Copy code 和 New code。在 App 中选择 Add computer 并扫描该码。手机会先以 Viewer 身份配对,随后 1DevTool 会询问你要授予它哪个角色(Viewer、Approver、Operator 或 Admin)。在终端中输入内容需要 Operator。每个码只能配对一部手机,连续五次失败后即失效。同一个地址每分钟最多可尝试 20 次配对,最多可配对 32 部手机。已配对的手机会列出其平台和最近一次上线时间,你可以重命名、更改其角色,或点击 Forget 将其移除,这会终止它当前的会话。
配对仅限单次使用,且先只读
- 二维码邀请只能使用一次,十分钟后过期。 扫描后该码即被消耗,并由新码取代,因此被拍下的或过期的二维码无法被重放。配对回复本身也是加密传输的。
- 新手机默认以 Viewer 身份连接,除非你另行选择。它可以读取这台桌面端的工作区,包括文件和对话记录,但执行操作需要更高的角色——见下文 Permissions。
- 二维码配对的角色可以被记住。 设备扫描二维码时,在角色对话框中勾选 Don’t ask again,或在 Settings → Remote 中将 New QR Devices 设为 Ask every time 或某个固定角色。选择任何高于 Viewer 的角色,仍会先要求你确认。口令登录则始终会询问。
手机保持配对的时长
Settings → Remote → Pairing Expiry 提供 7 days、30 days 或 90 days max 三个选项。不再有永久有效的凭据。
无论你选择哪个选项,浏览器配对最长在配对后 7 天过期,且活动不会使其续期。 每天使用手机也不会延长访问期限;一周到期后需要重新配对。更改该设置只会缩短现有配对的期限,不会延长。
在 HTTPS 的 Remote URL 上,浏览器会把配对的那一半以不可导出密钥的形式保存在受保护的存储中,因此读取页面存储的脚本无法将其带走。在普通 HTTP 下,配对仅在该标签页内有效——重新加载需要重新配对——所以请优先使用 HTTPS URL。
连接成功后,你的项目会在手机上按桌面端相同的组织方式显示。点击其中一个即可进入它的工作区。
你能在手机上做什么
Remote Control 镜像了 1DevTool 中那些离开键盘时仍然重要的部分。
向 AI Agent 发送提示并引导它们
打开任意项目的终端,查看 Agent 的最新输出,并发送新的提示——包括那些一直闲置、在等你放行的 Agent。你可以:
- 在适合手机的阅读模式中滚动并复制终端文本
- 直接从手机附加图片到提示中
- 提及仓库中的文件,让 Agent 获得正确的上下文
- 从提示历史中复用过去的提示

审查代码并通过 Git 发布
浏览项目文件,打开某次提交的详情,并在手机上审查 diff。当改动看起来没问题时,暂存、撰写提交信息并推送——一个完整的源码管理闭环,尽在掌中。

测试 API 并查询数据库
发送一个 HTTP 请求并查看响应,或者运行一条数据库查询,使用的是你在桌面端已经设置好的集合和连接。你保存的请求会在手机与桌面端之间保持同步。

定时发送提示
把一条 Agent Input 提示排入队列,让它按计时器、在指定时间或在下一次额度重置时触发——这样长任务可以在你不在时启动,等你回来时已经就绪。

好好阅读对话记录
Reader Mode 会把 Agent 的对话重新渲染成文档,这让在手机上跟进进度变得轻松许多。用户消息、Agent 结果、代码和原始终端输出各有独立的样式,提供浅色、护眼棕(sepia)和深色阅读界面,默认跟随你的设备主题。

适配你屏幕的终端
在手机上打开终端,它会自动重排以适应屏幕:正在查看终端的那部手机决定终端的宽度,因此文本会按你的屏幕换行,而不必在桌面宽度的网格上来回平移。最新的输出和 Agent 的输入框都位于你看得到的位置。
两部手机同时查看时,会协商出对两者都合适的尺寸;你一关闭终端,桌面端窗格就会恢复自己的尺寸。手机连接期间,桌面端窗格会通过 Sized for phone 徽标告知,并提供进入 Reader Mode 的快捷方式。只读查看者仍保持之前的镜像视图。
对于运行在已配对电脑上的终端,效果相同。通过 Host 选择器打开它,它会适配你手机的宽度;文字大小栏中的 A− 和 A+ 会改变其列数,在你的手机占用宽度期间,那台电脑的窗格会显示 Sized for phone · <phone> via <computer>。离开终端后,它会恢复为桌面端的尺寸。如果已配对的电脑运行的是较旧的 1DevTool,或者你只有查看权限,终端会保持那台电脑的宽度,文字大小面板会说明原因,并提供 Open Reader 来阅读完整的行。
在厨房里批准计划
等待你裁决的任务有专属页面。阅读计划,然后点击 Approve 或 Request changes——你的话会原样传达给 Agent,你不在时不会有任何内容被自动批准。参见审批关卡。
在地图上查看整个团队
Maps 标签页(位于 Agents、Projects 和 Inbox 旁边)会把每个项目绘制成一张实时地图:每个 Agent 终端是一个工位,两个 Agent 之间的每条链接是一条线,布局遵循指挥链。组织架构图保持其层级,团队的主持者位于成员上方,没有链接的 Agent 则列在地图下方的 Not linked 列表中等候。
- 选择项目:从 Maps — Live terminals & links 下方的标签中选择。摘要行形如 4 agents · 3 links · 4-seat org,并会指出所有空缺的席位。
- 看工位。 每个工位显示其角色和状态,例如 devin · running。正在等你的工位(它的 AI 运行刚刚结束,或某个团队成员被标记为需要输入)会被标出,顶部会统计数量:3 needs you。
- 看连线。 实线是活跃链接,虚线是**已隔离(quarantined)**的链接(因其终端关闭或重新启动、会话被替换,或其 Agent 或 worktree 发生变化而被暂停)。直线表示双向传递消息,曲线表示仅单向。
- 点击工位即可在手机上打开该终端。
- 当有链接请求在等待时,会出现一条横幅:1 link decision waiting — answer in Inbox。
原本单独的 Team 标签页中的团队、层级和运行视图,现在位于地图下方 Start 列表中的 Teams, runs & logs 下。桌面端对应的同一幅图景请参见 Team Map。

启动已保存的团队
你在桌面端 Builder 中保存的组织架构图和流水线,可以从手机启动。打开项目的 Orchestrate Agents 面板,选择 Add Terminal → Orchestration,或在 Maps 标签页点击 Start a team from a chart。
每个图表是一张卡片,显示其角色或阶段,以及它会打开多少个终端(opens 4)。Preview 会像 Builder 那样绘制它:组织架构图用角色卡片和汇报线,流水线则用编号阶段。Start team 会把每个席位都作为全新终端打开,并已按图表建立好链接,过程中会显示 Opening 2/4 terminals… 的计数。
- 在手机上,每个席位都会打开一个新终端。 把席位交给一个已经打开的终端,仅限桌面端。
- 已有活跃席位的图表不会被替换。 如果该图表已在项目中运行,按钮会让步并指明它;请在桌面端停止或替换它。
- 启动团队需要该设备具有 Operator 权限。
没有合适的已保存图表?Plan a team from a goal 会由规划器提出成员方案,在你批准之前不会运行任何内容。
在已配对电脑上启动 Agent
在手机的 Host 选择器中选择一台已配对电脑,在那里打开一个项目并选择 Add Terminal。面板只会提供在那台电脑上检测到的 AI Agent,点击 Start on 加上电脑名称即可启动。这需要手机具有 Operator 或 Admin 权限,并且已配对电脑上授予了 Start terminals 权限。
当那里的 Agent 停在首次运行的提问上时,手机会指出它,并让你一键回答:
| Agent | 问题 | 按钮 |
|---|---|---|
| Codex | 信任此文件夹 | Trust folder |
| Codex | 启动前更新 | Skip update |
| Cursor Agent | 信任此工作区 | Trust workspace |
| OpenCode | 启动前更新 | Skip update |
| Devin | 信任此文件夹的作者 | Trust folder |
引导电脑之间的对话
两台电脑上的 Agent 之间的对话会显示在 Inbox 中。Approver、Operator 和 Admin 设备可以执行 Pause conversation、Resume、End 或 Deliver now;仅查看的设备会被告知请在桌面端暂停或结束。
批准链接请求和排队消息
Inbox 标签页让你在手机上批准链接请求或放行排队消息,并带有权限标签,让你在点击前就能看清自己授予了什么。Approver 设备可以做决定;仅查看的设备能看到请求,并被告知请在桌面端确认。请求读取权限的链接在手机上只能被拒绝,因为批准它需要桌面端的披露审查。
在手机上查看层级结构
Teams, runs & logs 按层级展示每个活跃的组织——主持者在顶部,成员在下方,每个工位按 Agent 的真实状态亮起,外观与桌面端相同的办公室风格一致——并标出空缺和路由违规。Approver 设备可以一键重新绑定席位。参见 Agent 层级。
阅读编排运行日志
浏览最近的运行,打开某次运行的文件,并查看应用日志,无需走回书桌。
查看你的 AI 额度
AI Quota 部分会按提供商和账户显示剩余额度,让你在开始之前就能判断一次长时间运行能否撑过整夜。参见账户与额度。
Skills 和斜杠命令
手机上同样提供 skills 选择器,因此你可以直接插入一个 skill 或斜杠命令,而不必凭记忆输入它的名称。

通知
开启活动通知后,当 Agent 完成、需要输入,或长时间运行的命令结束时,手机会通知你——这样你不必一直开着应用,也能知道何时该回来处理。
权限
每台已配对设备都有一个角色,在桌面端的 Settings → Remote 中按设备设置:
| 角色 | 允许的操作 |
|---|---|
| Viewer | 读取桌面端的工作区,包括文件和对话记录。每次新配对都从这里开始,除非 Settings → Remote 中的 New QR Devices 为二维码配对指定了其他角色。 |
| Approver | 批准 Agent 的操作和任务关卡,这些操作可能带来破坏性后果。 |
| Operator / Admin | 广泛的命令执行权限,以及对这台桌面端工作区的写入权限,包括打开 localhost 端口的预览。 |
将设备提升到 Viewer 以上时,桌面端会要求确认,并指明该设备及其将能做什么。降低设备权限会立即切断其当前连接,而不是让它们继续保持旧的级别,并且定时提示在到期时会重新检查该设备的授权。在这些角色出现之前配对的设备已被重置为 Viewer——桌面端会对它们加以标记,方便你有意识地确认任何更高的角色。
localhost 端口的预览需要 Operator 或 Admin,并且每个预览都会获得针对该端口的、有效期很短的独立授权,而不是依附于配对。授权失效后,手机会请你重新打开预览。
桌面端无法确认的发送不会被盲目重试。 如果手机无法确认某条提示是否已到达终端,输入框会警告 Check terminal before resending,保留你的草稿,并把原始错误放在 Details 之后——这样一次看似无害的重试就不会把提示发送两次。
相关内容
- 运行 AI Agent — 提示和编排 Agent 的桌面端用法
- AI 用量与额度 — 你的用量标识在手机上也会显示
- Reader Mode — 在小屏幕上阅读对话记录
- 审批关卡 — 随时随地回复 Agent
- 账户与额度 — 额度部分的桌面端视图
- 已配对设备 — 同样的理念,适用于第二台电脑而非手机