← 返回开源雷达

HyunSeob/iphone-cli

B · 精选

让 AI Agent 通过无障碍树操控真实 iPhone

⭐ 47 stars⑂ 12 forksRustMIT创建于 2026-11-10最近更新 2026-11-16

这个项目是什么

iphone-cli(命令名 `iph`)是一个用 Rust 编写的命令行工具,让 AI Agent(比如 Claude 这类助手)能直接“看懂”并操作一台真实的 iPhone。它通过读取 iPhone 的“无障碍树”(accessibility tree,也就是系统为辅助功能提供的结构化界面信息)来识别屏幕上有哪些按钮、开关、输入框,而不是靠截图识别,所以读到的信息干净、稳定。

它解决的是 iPhone 自动化长期以来的痛点:过去想让程序控制 iPhone,通常要装 XCUITest、WebDriverAgent,或者做 Xcode 签名、打包测试 App,门槛很高。这个项目直接连接苹果开发者服务(USB 或同一 Wi-Fi 下),不需要装 Xcode、不需要在手机上安装任何 App、也不需要签名,装一个可执行文件就能用。

目标用户是想给 AI Agent 接上“真机操作能力”的开发者和进阶玩家,也可以直接当命令行工具手动操作手机。核心能力包括:读取当前界面元素、点击某个按钮、输入文字、滚动、以及用一个内置的 QuickJS 脚本引擎把多步操作合并成一次调用;同时提供 MCP 服务器模式,方便接入各类 AI Agent 框架。需要注意的是它限制较严:目前只支持真实 iPhone 且要求 iOS 27 及以上,宿主仅限 macOS 和 Windows,不支持模拟器、安卓和横屏。

核心亮点

  • ▸不用 Xcode、不用 WebDriverAgent、手机上不用装任何 App,装一个二进制文件就能控制真机 iPhone
  • ▸读取的是结构化无障碍树而不是截图,界面元素识别更清晰可靠,适合交给 AI 处理
  • ▸自带 MCP 服务器模式(`iph mcp`),方便直接接入各种 AI Agent 框架
  • ▸内置 QuickJS 脚本引擎,一条命令就能跑完多步操作流程,并返回 done / not_sent / unknown 这类明确结果
  • ▸纯 Rust 实现的单文件原生程序,支持 macOS 和 Windows,无需 Python、Node.js 或 Appium 运行环境

谁做的

作者 HyunSeob 是一位韩国独立开发者,GitHub 有 700 多位关注者,个人简介写得很随性(“NOT IDEAL, FYI”);该项目基于 Poki 公开描述的行为重新实现,设备通信依赖开源库 idevice。

怎么用

完全免费开源(MIT 协议),不需要任何 API key。使用方式为本地安装:Mac 上在终端执行一行 `curl` 安装脚本即可(自动下载校验后的二进制到 ~/.local/bin/iph),Windows 则从 Releases 下载 zip 解压后把 iph.exe 放进 PATH。装好后运行 `iph setup` / `iph doctor` 走一遍检查,按提示在手机上打开“开发者模式”、插 USB 点“信任”,之后就能用 `iph read` 看界面、`iph tap "General"` 点按钮等。

如果想连 Wi-Fi 使用,可先 USB 配对再执行 `iph doctor --fix-wifi`。注意它要求手机是真实 iPhone 且系统为 iOS 27 或更高(作者仅在 iPhone 15 Pro Max / iOS 27.0.1 上验证过),宿主只支持 macOS 和 Windows 10/11,不支持模拟器、Android、Linux 和横屏;Windows 端需要先装苹果的设备服务(Microsoft Store 的 Apple Devices 应用,或用 winget 安装 AppleMobileDeviceSupport)。

数据速览

Stars
47
Forks
12
Open Issues
0
收录时间
2026-11-16
accessibilityai-agentautomationcliiosiphonemcprust