iPhone-use
浏览文档
本页目录

首个 iPhone 任务

进入真实 App,读取证据,再正常结束会话。

开始前

完成CLI 安装、插件安装和设备准备。使用已登录的新本地客户端会话,允许命令执行与图片读取。没有本地 Mac 工具的托管聊天无法操作设备。

发送任务

在 Codex 中调用 $iphone-use:iphone-use,或在 Claude Code 中调用 /iphone-use:iphone-use,然后发送:

打开我的 iPhone 设置,进入“通用”,读取截图确认页面,然后断开会话。不要修改任何设置。

保持手机解锁;连接多台手机时明确说明使用哪一台。

怎样才算完成?

  1. Agent 检查 CLI 和 Xcode,发现设备、连接,并保留返回的会话 ID。
  2. 发现“设置”、打开 App,并通过图片工具读取实际 PNG。
  3. 使用当前截图中的坐标(或 Runner 元素引用)进入“通用”。如果已经在该页面,先返回再进入。
  4. 读取新截图,确认“通用”页面,然后正常断开会话。

命令成功、截图路径存在或单次点击成功,都不代表任务完成。不需要修改任何设置;手机语言不同,界面文字也可能不同。

任务中断时

后台命令的作业 ID 与设备会话 ID 不同。应续读原命令的最终输出,不要重新运行。动作返回 unknown 时,先观察,再决定下一步。

请 Agent 尽可能断开会话,并报告命令、错误和未验证的结果。继续查看故障排查。