AScript iOS — 免越狱的 Python 自动化引擎
AScript iOS 是运行在 iPhone / iPad 上的 Python 自动化引擎。一套 API、两种引擎、全版本兼容：既可用 WDA（WebDriverAgent） 走 Apple 原生通道，也可挂一颗 ESP32 蓝牙 HID 芯片 从物理层模拟点击。支持 iOS 15 ~ iOS 18 全版本，免越狱、免签名、免 Mac、免开发者账号。
from ascript.ios.node import Selector
from ascript.ios.screen import Ocr
from ascript.ios import system
Selector().text("确认").click() # 控件点击
Ocr().find("优惠券") # OCR 找文字
system.app_start("微信") # 465+ App 一行启动
我们的与众不同
iOS 沙盒禁止任意 App 模拟点击其他 App，这是 iOS 自动化的核心门槛。AScript 提供两条成熟的技术路径，并把 AI 视觉、系统集成、云端能力都做到"开箱即用"：
双引擎对比：WDA vs ESP32 HID
两套方案使用同一套 Python API，切换时业务代码几乎不用动。
- 触控原理
- WDA 注入
- 截图原理
- WDA 截图
- 硬件成本
- 0 元
- 开发者模式
- 需开启
- 最低系统
- iOS 15
- 控件能力
- 文本 / ID / XPath
- 触控原理
- ESP32 HID 物理信号
- 截图原理
- 系统录屏扩展
- 硬件成本
- 9 ~ 20 元
- 开发者模式
- 不需要
- 最低系统
- iOS 13
- 控件能力
- 仅触摸 + 键盘
多数场景先用 WDA（零硬件成本）。当 WDA 方案无法满足、或需要更稳定可靠的输入通道时，切换到 HID 模式。两种模式随时切换，脚本基本不用改。
→ WDA 模式上手 · → ESP32 HID 模式上手 · → 模式详细对比
极简 Python API
from ascript.ios.node import Selector
from ascript.ios.screen import Ocr, FindImages, FindColors, yolov11
from ascript.ios import system
from ascript.ios.system import device
# —— 控件（WDA 模式）——
Selector().text("登录").click()
Selector().id("username").input("my_account")
Selector().xpath('//XCUIElementTypeButton[@name="OK"]').click()
# —— AI 视觉 ——
Ocr().find("优惠券") # OCR 找文字（默认 PaddleOCR V5）
Ocr.vision(pattern="订单") # Apple Vision 引擎（iOS 16+）
FindImages("target.png").find_one() # 模板 + SIFT 混合找图
FindColors().find([0xFF0000, 0x00FF00]) # 多点找色
# —— 系统 ——
system.app_start("微信") # 465+ App 库
system.set_clipboard("Hello"); system.get_clipboard()
device.get_screen_size(); device.get_orientation()
system.notify("任务完成", "耗时 12.3s")
把上面任意一段丢给 Cursor / Trae / DeepSeek，用中文描述业务逻辑，脚本直接生成。
AI 视觉引擎 — 全离线、免 API Key
主流视觉能力打包在 ascript.ios.screen 模块下，全部端侧运行，不联网、不要 Key、不收钱。
from ascript.ios.screen import OcrOcr.vision(pattern="...")Ocr.mlkit(...)from ascript.ios.screen import yolov11FindImages("t.png").find_one()FindColors().find([...])from ascript.ios.screen import CodeScannerascript.ios.screen.opencv系统集成 — 开箱即用
只有 iOS 自动化才需要的那些东西，我们都内置了，省下你自己造轮子。
system.app_start("微信")system.set_clipboard / get_clipboardsystem.notify(title, body)ascript.ios.system.deviceascript.ios.system.KeyValueimport pymysqlimport requestsfrom ascript.ios.system import Controlfrom ascript.ios.ui import WebWindowfrom ascript.ios import imefrom ascript.ios import media企业服务环境与兼容
| 项目 | 内容 |
|---|---|
| 目标设备 | iPhone / iPad，iOS 15 ~ iOS 18（HID 模式最低 iOS 13） |
| 脚本语言 | Python 3，完整 Pip 生态 |
| IDE | Web-IDE（浏览器打开即用）· PyCharm · VS Code |
| ESP32 芯片 | ESP32-C3 · ESP32-S3 · ESP32 Pico（约 9 ~ 20 元） |
| AI 编程 | Cursor · Trae · DeepSeek · ChatGPT 直接生成脚本 |
性能与稳定性
常见问题 (FAQ)
AScript iOS 需要越狱或签名吗？
不需要。 AScript 运行在非越狱设备上，不需要重签名、不需要加入开发者账号、不需要信任描述文件，支持 iOS 15 ~ iOS 18 全版本。
开发脚本需要 Mac 吗？
不需要。 用 Windows + 浏览器（内置 Web-IDE）或 PyCharm / VS Code 就能写。WDA 方案首次部署可由我们协助，部署完成后设备脱机独立运行。
WDA 和 ESP32 HID 两种模式怎么选？
优先用 WDA（无需硬件、上手最快）。当 WDA 方案无法满足、对输入稳定性要求更高、或不想开启开发者模式时，切到 HID 模式。
两种模式的输入通道有什么区别？
- WDA 模式：走 Apple XCUITest 公开协议，适合控件树结构清晰的通用场景
- HID 模式：ESP32 外设在系统层是标准蓝牙鼠标 / 键盘，输入通道与系统 API 相互独立，稳定性更佳
OCR 要联网吗？要 API Key 吗？
都不要。 PaddleOCR V5（默认）/ Apple Vision（iOS 16+）/ Google MLKit 三套全部端侧运行，免网络、免 Key、免费。如需更高精度可选装付费 TomatoOCR 插件。
YOLO 支持自训模型吗？
支持。 yolov11.load(param_path, bin_path, yaml_path, nc, use_gpu) 直接加载 NCNN 格式的自训模型，支持自定义标签数量与 GPU 加速。
云端数据库要自己部署服务器吗？
不需要。 登录开发者后台一 键开通专属云端 MySQL，内置 pymysql 客户端直连。
465+ App 启动库怎么用？
system.app_start("微信") # 按中文名
system.app_start(bundle_id="com.tencent.xin") # 按 Bundle ID
system.app_start(scheme="weixin://") # 按 URL Scheme
微信 / QQ / 微博 / 钉钉 / 企业微信 / 飞书 / 支付宝 / 淘宝 / 京东 等主流 App 全覆盖。
ESP32 外设怎么获取？贵吗？
单片 ESP32-C3 / S3 / Pico 约 9 ~ 20 元，我们提供现成硬件和一键烧录工具。详见 HID 外设选购与烧录。
支持 iPad 吗？
支持。 iPad（iPadOS 15+）与 iPhone 使用方式 一致。
支持哪些 Python 第三方库？
支持完整 Pip 生态。requests / pymysql / numpy / opencv-python 等主流库已内置或可直接安装。
一个脚本能同时跑在 Android 和 iOS 上吗？
业务逻辑层可以复用；平台 API（ascript.ios.* vs ascript.android.*）导入路径不同，方法签名尽量对齐。参见 Android 自动化文档。
支持 AI 生成脚本吗？
支持。API 与自然语言逻辑一致，接入 Cursor / Trae / DeepSeek / ChatGPT，中文描述需求就能生成可运行脚本。