首个 iPhone 任务
进入真实 App,读取证据,再正常结束会话。
开始前
完成CLI 安装、插件安装和设备准备。使用已登录的新本地客户端会话,允许命令执行与图片读取。没有本地 Mac 工具的托管聊天无法操作设备。
发送任务
在 Codex 中调用 $iphone-use:iphone-use,或在 Claude Code 中调用 /iphone-use:iphone-use,然后发送:
打开我的 iPhone 设置,进入“通用”,读取截图确认页面,然后断开会话。不要修改任何设置。
保持手机解锁;连接多台手机时明确说明使用哪一台。
怎样才算完成?
- Agent 检查 CLI 和 Xcode,发现设备、连接,并保留返回的会话 ID。
- 发现“设置”、打开 App,并通过图片工具读取实际 PNG。
- 使用当前截图中的坐标(或 Runner 元素引用)进入“通用”。如果已经在该页面,先返回再进入。
- 读取新截图,确认“通用”页面,然后正常断开会话。
命令成功、截图路径存在或单次点击成功,都不代表任务完成。不需要修改任何设置;手机语言不同,界面文字也可能不同。
任务中断时
后台命令的作业 ID 与设备会话 ID 不同。应续读原命令的最终输出,不要重新运行。动作返回 unknown 时,先观察,再决定下一步。
请 Agent 尽可能断开会话,并报告命令、错误和未验证的结果。继续查看故障排查。