开源iPhone-use实测：让Codex通过USB操控真实iPhone

让AI代理操作电脑已经不是新鲜事，但手机一直是块短板。模拟器假、云手机贵，iOS更是因为系统封闭，长期没有像样的真机自动化方案。想在iPhone上让AI帮忙批量整理备忘录、自动填表、巡检某个App的页面状态，以前的答案是"做不到"。GitHub上一个新的开源项目正在改变这件事：iPhone-use，一个让Codex通过一根USB线直接操控真实iPhone的插件，项目上线五天拿下2600多个Star。

先说清楚它是什么。iPhone-use是GitHub用户zhongerxin开源的Python项目，采用MIT协议，核心思路是复用Appium生态里Appium维护的WebDriverAgent（简称WDA）。WDA是一个运行在iPhone上的自动化执行服务，由它充当"手"的角色，而电脑端的iPhone-use提供本地MCP服务、Codex插件、安装引导技能和一个实时屏幕预览小组件，充当"眼睛和大脑"。手机不需要越狱，也不需要单独启动Appium Server，一根USB线完成通信和端口转发。

它的工具面相当完整，模型一共可以调用17个工具：环境诊断与就绪检查的pua_doctor、pua_setup、pua_ready；读取控件树和截图的pua_observe、pua_find；查询与启动App的pua_apps、pua_launch_app；执行点击、滑动、物理按键的pua_tap、pua_swipe、pua_press_button；Unicode输入与等待的pua_type_text、pua_wait；以及批量动作、滚动查找和列表采集的pua_batch、pua_scroll_find、pua_collect_list。用自然语言描述"打开某App，把最近的待办整理成清单"这类任务，Codex就能自己规划调用序列完成。

部署是它门槛最高的部分，值得一步步说清楚。依赖清单先备齐：一台macOS电脑，装好完整Xcode（仅命令行工具不够）、Python 3.9以上、Node.js 20.19以上版本和npm 10以上，再准备一个可用于Xcode签名的Apple账号和开发团队，以及一部通过USB连接、已开启开发者模式的iPhone。首次使用必须先在手机上安装并启动WDA Runner，签名、构建、部署这些脏活可以交给项目提供的一段提示词——把仓库地址和安装要求整段复制给本机Codex，它会读取README、检查依赖、运行scripts/install.sh安装插件，然后获取项目锁定的WDA 16.14.0版本，配置你的设备与签名信息，完成构建并启动，直到pua_ready返回ready=true。中间需要本人操作的只有Apple账号登录、设备信任和手机解锁这几步。

有几个设计细节能看出作者做过真机自动化的长跑：控件定位失败时不是死循环重试，而是回退到截图，让模型看图后把像素坐标换算成iPhone点位再点；批量动作、滚动查找、列表采集这些组合工具减少了模型的往返回合；安装任务异步执行并返回工作ID，重复设置优先复用进行中的任务；多进程共享操作锁保证了动作语义明确，超时或断线会标记不确定状态，避免盲目重放点击。隐私方面它默认只发送匿名使用统计，设置IPHONE_USE_ANALYTICS=0即可关闭，不上传屏幕画面和输入内容。

我的判断是，这个项目踩中了AI代理落地的真实缺口。过去真机自动化要么是测试工程师的Xcode UI测试，要么是极客的越狱脚本，普通人够不着；iPhone-use把签名、构建、转发这些复杂度全部打包成引导流程，让"用嘴操作手机"变成一个下午就能搭起来的现实。短板也明显：流程强依赖macOS和Xcode签名体系，Windows用户暂时无缘；执行速度取决于App响应和模型回合，急不来。

如果你手里有Mac和闲置iPhone，值得一试。项目官方地址在GitHub搜索zhongerxin/iPhone-use即可找到，README里有中文的完整安装提示词和故障排查文档。真机代理这条路刚刚起步，但方向已经很清楚了。