zhongerxin/iPhone-use

这是什么？

核心功能

• 01通过 WebDriverAgent 经 USB 控制真实 iPhone。
• 02向模型返回紧凑控件树和实际截图。
• 03支持点击、滑动、拖动、Unicode 文字输入和批量动作。
• 04滚动采集列表，处理重叠内容并去重。
• 05提供实时手机屏幕 widget，支持暂停与人工接管状态。
• 06提供 Codex、WorkBuddy 和豆包工作的安装引导。

适用场景

• 让 AI 助手在个人 iPhone 上打开 App 并完成多步骤任务。
• 滚动采集 iPhone App 中的列表内容并整理。
• 在桌面助手中探索或验证 iOS App 的操作流程。
• 在手机 App 中起草文字，由用户核对后再提交。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/zhongerxin/iPhone-use.git
2. 2

   进入项目目录

   cd iPhone-use
3. 3

   运行安装脚本

   sh scripts/install.sh

使用前须知

• !需要 macOS、完整 Xcode 以及通过 USB 连接的 iPhone。
• !必须先用你自己的 Apple 开发者账号在 iPhone 上签名并运行 WebDriverAgent。
• !主要设计为 Codex、WorkBuddy 或豆包工作的插件，而非独立工具。
• !README 称仓库目前为私有，需要 GitHub 访问权限或源代码包。

标签

常见问题

iPhone-use 是什么？

让 Codex、WorkBuddy 或豆包工作通过 USB 操作真实 iPhone，并在侧边栏实时显示手机屏幕。 iPhone Use 让 AI 助手通过 USB 连接的真实 iPhone 完成任务。用自然语言描述需求后，助手可以打开 App、读取页面、点击、滑动、输入文字并整理列表，侧边栏同时展示手机实时画面。手机端基于 WebDriverAgent（WDA）运行自动化服务，项目本身包含本地 MCP 服务、安装与使用技能以及屏幕 widget。

iPhone-use 可以免费使用吗？用的什么许可证？

iPhone-use 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

iPhone-use 还在维护吗？

活跃维护中。iPhone-use 最近一次提交是在 2026年10月16日。

iPhone-use 适合用来做什么？

让 AI 助手在个人 iPhone 上打开 App 并完成多步骤任务。 滚动采集 iPhone App 中的列表内容并整理。 在桌面助手中探索或验证 iOS App 的操作流程。 在手机 App 中起草文字，由用户核对后再提交。

iPhone-use 怎么安装和运行？

克隆仓库: git clone https://github.com/zhongerxin/iPhone-use.git 进入项目目录: cd iPhone-use 运行安装脚本: sh scripts/install.sh

在哪里获取 iPhone-use？

源代码和安装说明在 GitHub 上：https://github.com/zhongerxin/iPhone-use