2026.10.19
iphone-use：让 AI agent 操作真实 iPhone 的自托管工具
iphone-use 把真实 iPhone 暴露给 MCP 客户端、脚本和人工控制端，适合移动自动化与真机测试，但部署依赖 Mac、Xcode、开发者模式及 Apple ID，许可证也需要进一步确认。
它解决什么问题
iphone-use 面向需要让 AI agent 操作真实 iPhone 的开发者和自动化使用者。项目 README 描述了 Claude Code、Codex 及其他 MCP 客户端的接入方式：agent 可以读取屏幕中的文本和元素，点击、输入、滑动，并操作没有 API 的 App。它不是只处理模拟器或网页，而是通过 Mac 上的 daemon 与 iPhone 上的 XCTest runner 协作。
这使它适合几类场景：移动 App 的真机回归与登录流程验证、个人工作流自动化、需要跨页面读取内容的任务，以及希望让人工与 agent 共用一台测试手机的团队。项目也提供 HTTP API，因此脚本和其他 agent 不必局限于 MCP；浏览器页面和原生 iOS app 则用于人工查看和控制。
已知功能
README 列出的核心动作包括启动 App、读取屏幕、点击、输入和滑动。长文本可一次输入，已完成的任务还能记录成可回放 flow，之后无需再次依赖模型来执行同一流程。项目还描述了对操作结果的反馈：动作可能被标记为已应用、未发送或未知，并提示是否适合重试。对于被遮挡的元素，系统声称会拒绝点击，而不是假装成功。
连接方式包括首次通过 USB 设置，之后通过 Wi‑Fi 使用加密隧道。人工控制支持浏览器和另一台 iPhone；README 提到实时 H.264 画面、鼠标键盘操作、二维码配对，以及在屏幕捕获受限时显示元素线框。agent 与人工控制共享同一个 daemon，并通过占用关系避免同时操作。
官方 v0.19.2 release 于 2026 年 10 月 17 日发布，列出的改动包括固定 CI 依赖、补齐集中扫描要求，以及认证兼容性修复。仓库元数据显示项目未归档，但并没有确认一个可识别的 SPDX 开源许可证。
采用前的限制
部署前首先要核对环境。README 要求 macOS 15 或更高版本、已登录 Apple ID 的 Xcode、iOS 15 或更高版本的 iPhone、开启 Developer Mode，以及首次连接所需的 USB 线。用户还需要解锁手机、信任设备，并处理 Xcode 签名；这些步骤不能简单交给 agent 完成。项目页面没有在所给资料中确认更广泛的硬件清单、性能保证或兼容性边界，因此不宜把示例场景视为所有 App 都能稳定自动化。
其次，真实手机会接触消息、健康、银行或支付页面等敏感数据。README 提供认证 HTTPS 反向代理或 VPN 的远程访问思路，也说明浏览器和 iOS app 可以控制设备；但这些描述不能替代组织自己的权限、网络隔离、账号分级和审计方案。不要把生产账号、支付操作或私人凭据直接交给未经验证的 agent 流程。
最后，许可证状态需要在引入前人工检查。仓库 metadata 的 SPDX 值是 NOASSERTION，不能据此假定允许任意商业使用或再分发。建议先在专用测试手机上验证目标 App、签名流程、网络路径和回放稳定性，再决定是否纳入持续集成或日常自动化。
资料来源
资料核对日期：2026-10-19