zhongerxin/iPhone-use

选用指南

AI 根据 README 整理 · 2026/10/16 21:21:48

使用方式

通过 Codex CLI 安装插件，或在 WorkBuddy 和豆包工作中通过安装脚本接入，使用自然语言提示词操作手机。

查看 README 依据

**使用前，需要先在你自己的 iPhone 上安装、签名并启动 WDA Runner。** WDA 是运行在手机上的执行服务；下面的提示词和 setup 流程可以让所用宿主的助手协助完成首次安装，已有健康的 WDA 可直接复用。 ## 最近更新 2026-10-09 至 2026-10-13，完整记录见 [更新记录](CHANGELOG.md)。 - **预览直接操作**：支持点击画面、鼠标拖动和触控板双指滚动。 - **微信点击优化**：已知导航目标直接看图点击，通讯录和会话列表按需轻量读取。 - **AirDrop 文件传输**：使用技能新增传输指引，将手机图片、视频和文档传回 Mac。 - **页面读取优化**：精简控件树，默认最多返回 200 个节点，支持按需限制快照。 - **连接恢复改进**：完善超时与断线指引，自动恢复临时快照设置。 - **长文本续传保护**：续传绑定原输入框，切换 App 或焦点后停止，避免误写。 ## 用一段提示词让 Codex 安装 将下面这段话复制到本机 Codex： ```text 请帮我安装和配置 iPhone Use： https://github.com/zhongerxin/iPhone-use 先读取仓库 README 和安装脚本，检查本机 Codex CLI、Python、Node.js、npm、

两者都支持通过 USB 操作真实 iPhone，并在侧边栏显示实时画面；共用本机的设备配置、WDA 构建和操作锁，已配置过的手机优先复用。依赖仍是 macOS、完整 Xcode、Python、Node.js / npm 和 USB iPhone，安装这两个适配版无需 Codex CLI。适配版默认关闭匿名使用统计。 | 宿主 | 在源码目录运行 | 安装后的接入 | | --- | --- | --- | | [WorkBuddy](https://github.com/zhongerxin/iPhone-use/blob/main/workbuddy/README.md) | `python3 workbuddy/install.py` | 在「连接器管理」信任 `iphone_use`，新开会话 | | [豆包工作](https://github.com/zhongerxin/iPhone-use/blob/main/doubao/README.md) | `python3 doubao/install.py` | 按安装器输出新建 STDIO 连接器，上传两个技能，新开「本地电脑」任务 |

部署要求

需要 macOS、完整 Xcode（已完成首次启动配置）、可在 Xcode 中使用的 Apple 账号和开发团队、USB 连接的真实 iPhone（需信任此 Mac 并开启开发者模式）、Python 3.9+、Node.js 20.19+ 或 22.12+ 或 24+ 及 npm 10+。

查看 README 依据

如果这些界面步骤需要我操作，给出具体位置和路径，等我完成后继续。 工具可用后读取 iphone-use-setup，先查询 setup status，复用已有配置、健康 WDA 或正在运行的启动任务；首次配置使用我自己的设备和 Apple 开发团队完成签名与启动。 确认 pua_ready 返回 ready=true 后调用一次 pua_screen()，在右侧 MCP App 显示实时手机画面， 再在 iPhone 计算器中验证 12×34=408。Apple 登录、信任、开发者模式或解锁 需要我接管时，说明具体步骤并等我完成；不要照搬作者的设备标识或签名信息。 ``` 如果工具没有加载，先确认连接器已启用，再新开会话 / 本地电脑任务。两个宿主同时使用同一部手机时，按共享操作锁的提示等待，避免同时操作。详细安装、更新和排查步骤见上表链接。 ## 安装依赖 | 依赖 | 用途 | | --- | --- | | macOS 与 Codex、WorkBuddy 或豆包工作 | 运行本地 MCP 服务与屏幕侧边栏；Codex 版安装另需 Codex CLI | | 完整 Xcode，已完成首次启动配置 | 编译、签名、部署和运行 WDA；仅 Command Line Tools 不够 |

| 可在 Xcode 中使用的 Apple 账号和开发团队 | 签名手机端 WDA Runner | | USB 连接的真实 iPhone | 信任此 Mac，开启设备要求的开发者模式，安装与启动期间保持解锁 | | Python 3.9+ | 运行 MCP 服务；Python 端使用标准库 | | Node.js 20.19+、22.12+ 或 24+，npm 10+ | USB 转发与屏幕流；支持范围以项目 engines 和 doctor 检查为准 | Xcode 需要支持手机当前的 iOS 版本。无需越狱，也无需单独启动 Appium Server。WDA 固定使用已验证的 16.14.0 提交，下载、依赖安装、签名和构建由 setup 流程管理。 ### 先在自己的 iPhone 上安装并启动 WDA 手机端使用 [Appium 维护的 WebDriverAgent](https://github.com/appium/WebDriverAgent)。首次使用时，须通过 Xcode 用你自己的 Apple 账号与开发团队签名、安装并启动 `WebDriverAgentRunner`。

已知限制

仓库目前为私有，需要有 GitHub 访问权限或使用已取得的源代码包。

查看 README 依据

完整 Xcode，以及通过 USB 连接的 iPhone。把项目放到合适的本机目录， 运行 sh scripts/install.sh 安装插件。 如果当前聊天还没有加载新工具，明确告诉我重连或新开聊天后继续。 工具可用后读取 iphone-use-setup 技能，检查现有配置，优先复用已有 WDA。 首次配置时发现我的设备，使用我自己的 Apple 开发团队和可签名 bundle ID， 获取固定版本 WDA、配置签名、构建并启动，直到 pua_ready 返回 ready=true， 然后打开手机屏幕。不要照搬作者的设备标识或签名信息。 缺少依赖时说明具体缺项并帮助安装。Apple 账号登录、设备信任、开发者模式 或解锁需要我操作时，告诉我明确步骤，等我完成再继续。 ``` 安装插件后，当前聊天可能需要重新连接才能加载工具，流程可在重连后继续。Apple 账号登录、设备信任、开发者模式及手机解锁仍需本人在系统界面完成。 仓库目前为私有，需要有 GitHub 访问权限，或者使用已取得的源代码包。 ## 在 WorkBuddy 和豆包工作中安装