iOS 免越狱自动化蓝牙 HID 方案：不装代理也能跑脚本

免签名捷径：原理和硬件准备

代理模式虽好，但签名 IPA 这道门槛劝退了不少人：个人开发者签 7 天就过期，企业签需要付费资质，重签运维成本持续存在。蓝牙 HID 方案直接绕开签名，用一块 ESP32C3 开发板模拟成蓝牙鼠标/键盘，手机系统层面把它识别为标准蓝牙外设，配合辅助触控（小白点）实现点击、滑动、输入等操作，不需要在手机上安装任何代理 App，也不涉及签名证书。更关键的是它的截图机制不走屏幕镜像：市面上多数硬件自动化方案依赖屏幕镜像把画面实时回传电脑再截取，这种“视频采集”特征很容易被 App 风控识别，而蓝牙 HID 用 image.captureFullScreenNoAuto 直接抓取屏幕单帧画面、不建立镜像通道，极大降低被检测的概率。从技术通道看它分三层：开发板（硬件层）模拟 HID 设备并发送鼠标/键盘事件；中控（通信层）通过串口或 WiFi 与开发板通信、下发指令；脚本（逻辑层）调用 bleEvent 系列函数编排流程，三层解耦、任何一层都能独立替换或升级。

开发板型号选 ESP32C3，主流开发板均可，淘宝、拼多多、1688 都有售；有带焊引脚和不带焊引脚两种规格，刷固件要用 USB 口，选带 Type-C 或 Micro-USB 的版本即可；固件免费，到 EasyClick iOS 资源文件夹 → USB 版本 → 蓝牙固件下载，注意不要选成安卓版或 OTG 版固件。ESP32C3 刷入的蓝牙固件分相对坐标和绝对坐标两种，选哪种直接影响后续脚本编写的复杂度和点击精度：

固件类型	兼容性	使用特点	适用场景
相对坐标	兼容性强，覆盖更多系统版本	需要自己计算补偿率，出现累积误差时调用归零函数处理	系统版本较低或兼容性优先
绝对坐标	iOS 17+ 兼容良好	无需计算补偿率，直接指定屏幕坐标点击更精准	新设备优先选择，省心精准

新设备优先用绝对坐标固件，省去补偿率计算和归零操作，脚本更简单、长时间运行也不会坐标漂移；设备系统低于 iOS 17 则只能选相对坐标固件，配合 bleEvent.resetZero 定期归零。刷固件的方式与安卓版蓝牙 HID 一致，用 ESP 烧录工具即可，关键三点：确认选的是 iOS USB 的蓝牙固件，不要选成安卓蓝牙固件或 OTG 固件；刷完获取开发板 MAC 地址，后续绑定和中控识别都依赖它；刷固件时建议关闭中控软件，避免串口被占用导致刷入失败。

绑定、系统配置和通信方式

绑定前建议在开发板和手机上贴好蓝牙 MAC 标签，群控场景下几十块板子混在一起、没标签很难分清。打开 iOS USB 中控，右键目标设备 → 蓝牙 HID 设置 → 绑定蓝牙 BLE；选择已连接的串口（找不到就去掉「只显示已绑定的」勾选并强制刷新串口列表），也可以在 MAC 地址输入框直接输入蓝牙 MAC 后 8 位绑定，适合串口识别不到的情况；绑定完成后中控列表「蓝牙 MAC」栏显示绑定的硬件地址即成功。

手机系统配置决定蓝牙 HID 能不能正常工作，漏开任何一项都可能让鼠标直接没反应：设置 → 辅助功能 → 触控 → 辅助触控（小白点）打开；跟踪灵敏度拉到最左侧（龟速端），避免移动过快导致定位不准；打开「执行触控手势」「显示屏幕键盘」；辅助触控 → 鼠标键里把初始化延迟和最大速度拉到最左，开启鼠标键、Option 切换、使用主键盘；通用 → 触控板与鼠标 → 跟踪加速度拉到最左；设置 → 辅助功能 → 键盘与键入 → 全键盘控制打开，并在「命令」中自定义快捷键。这些配置只需做一次、重启手机后依然生效，但系统更新后如果出现异常，优先检查这些选项是否被重置。

开发板与中控之间的通信方式有两种：

通信方式	说明	适用场景
串口	USB 直接收发数据，无需额外配置	开发板靠近电脑、单台调试
WiFi	需先给开发板设置 WiFi 账号密码（中控右键菜单设置），重启后中控自动扫描硬件 IP	开发板远离电脑、群控场景

WiFi 模式的优势是开发板配网后不再需要连接电脑，只要在同一局域网内中控就能找到它，适合机架式部署；注意 ESP32C3 仅支持 2.4G WiFi，不支持 5G 频段。配置完成后右键 → 蓝牙 HID 设置 → 测试蓝牙 BLE，点「鼠标移动」或「HOME 按键」，手机有动作即成功；没动作就按顺序排查：确认手机蓝牙已开启且与开发板已配对、核对系统选项是否全部正确开启、按住开发板 RST 键 5 秒后松开重新配对蓝牙。

输入文字、快捷键和脚本调用

蓝牙 HID 没装代理，输入文字按可用条件从优到劣排三级方案：

方案	需要条件	输入方式	体验
代理输入	有代理 IPA	直接调用 inputText	最直接高效
自定义输入法	装了 EC 脱机版主程序	开启 imeApi.forwardImeServer 转发后调用 imeApi 模块	接近原生输入法
快捷指令助手	电脑端助手程序 + 快捷指令	请求电脑接口 → 复制到剪贴板 → 粘贴	配置稍繁琐但可复用

第三种方案（快捷指令助手）的完整流程：电脑端下载并运行 iOS 快捷指令助手；手机新建快捷指令，请求 http://电脑 IP:8696 接口获取内容；在快捷指令中加设备震动动作，保证后台也能取到数据并放入剪贴板；回调 suc 接口告知执行成功；在「全键盘控制 → 命令」中给这条快捷指令绑定快捷键；中控右键 → 蓝牙 HID 设置 → 新增键盘快捷键、绑定相同组合键；脚本中通过 bleEvent.keyPressChar 触发该快捷键完成输入。配好后可以分享给其他手机复用，是免签名场景下的实用兜底方案。

快捷键通过模拟键盘按键触发系统级命令：中控右键 → 蓝牙 BLE 设置 → 新增键盘快捷键，组合键选 gui + 字符（如 gui+b 打开通知中心、gui+u 触发快捷指令），快捷指令、通知中心、控制中心、App 切换等系统命令都能这样绑定。

// 触发绑定的键盘快捷键
bleEvent.keyPressChar('b');  // 触发 gui+b

// 截图（不走屏幕镜像）
const img = image.captureFullScreenNoAuto();

// 预截图模式，适合频繁截图场景
image.startPreCapScreen();

除节点功能不可用外，其余识别能力均可正常使用：

识别能力	是否可用	说明
OCR 文字识别	可用	配合截图识别屏幕文字
YOLO 目标检测	可用	需要模型文件
图色找色	可用	常规图色/多点找色
模板匹配	可用	在截图中查找目标图
节点功能	不可用	需代理 IPA 支持

排查、灯语和误区

现象	处理方式
蓝牙连不上	按住开发板 RST 键 5 秒松开重连；手机蓝牙忽略设备后重新配对；换绑前先断开并忽略旧设备
鼠标漂移/不准确	核对手机系统选项是否全开；bleEvent.resetZero 归零；设置缩放比 getIPhoneScale；横竖屏切换时设置对应屏幕尺寸
找不到串口	去掉「只显示已绑定的」勾选，强制刷新串口列表；或直接输 MAC 后 8 位绑定
中控提示无线串口名称异常	重启中控；刷完固件后先关闭刷固件软件再打开中控
开发板配网失败	确认 WiFi 密码正确；使用 2.4G 网络（ESP32C3 不支持 5G）；重启开发板后重新扫描 IP

开发板灯语速查：

灯语	含义
蓝牙配对时常亮 3 秒后熄灭	配对成功
慢闪 10 次	蓝牙断开
快闪 15 次	正在查找蓝牙

几个常见误区：蓝牙 HID 不能完全替代代理模式，节点抓取、相册插入等高级功能仍需代理 IPA，它的定位是免签名的低风控点击/滑动方案；绝对坐标固件不一定比相对坐标好，绝对坐标仅在 iOS 17+ 上精准，低版本设备仍需相对坐标固件；辅助触控灵敏度要拉到最左，很多新手忽略这一步导致鼠标移动过快无法精准定位；群控时注意蓝牙信道拥挤，同一空间内超过 10 块开发板同时工作可能出现干扰，此时建议改用 OTG HID 有线方案或分区域部署。

常见问题

Q1：蓝牙 HID 方案是什么原理？ A：用 ESP32C3 开发板刷入固件后模拟成蓝牙鼠标/键盘，手机开启辅助触控等系统选项后被控制，整个过程不安装代理 IPA、不涉及签名。

Q2：蓝牙 HID 需要安装代理 IPA 吗？ A：不需要。这是该方案的核心优势。免签名、免代理，省掉证书维护成本；截图用 image.captureFullScreenNoAuto 不走屏幕镜像，能极大避免风控检测。

Q3：蓝牙 HID 支持哪些系统版本？ A：蓝牙方案通过系统辅助触控/全键盘控制实现，iOS 18+ 上兼容良好；固件分相对坐标与绝对坐标两种，绝对坐标在 iOS 17+ 上点击更精准。

Q4：一块开发板能控几台手机？ A：一块开发板只能绑定一台手机，绑定后蓝牙名称自动隐藏，防止检测；多台手机需要多块开发板，建议在板子和手机上贴 MAC 标签方便对应。

Q5：蓝牙 HID 能配合脚本使用吗？ A：可以。脚本中用 image.captureFullScreenNoAuto 或 image.startPreCapScreen 预截图加快速度，OCR、YOLO、图色、模板匹配均可用，仅节点功能不可用。

Q6：相对坐标和绝对坐标固件怎么选？ A：新设备系统在 iOS 17+ 优先选绝对坐标固件，无需计算补偿率、点击精准、长时间运行不漂移；系统低于 iOS 17 只能选相对坐标固件，配合 bleEvent.resetZero 定期归零处理累积误差。

Q7：开发板支持哪些通信方式？ A：串口和 WiFi 两种。串口是 USB 直接收发无需额外配置，适合单台调试；WiFi 需在中控右键菜单设置账号密码，重启后自动扫描硬件 IP，适合机架式群控部署。配网后开发板不再需要连接电脑。

Q8：蓝牙 HID 能做群控吗？ A：可以，每台手机绑一块开发板，中控批量管理。但同一空间超过 10 块板子可能出现蓝牙信道干扰，此时建议改用 OTG HID 有线方案，或分区域部署减少干扰。

Q9：开发板灯语代表什么含义？ A：蓝牙配对时常亮 3 秒后熄灭表示配对成功；慢闪 10 次表示蓝牙断开；快闪 15 次表示正在查找蓝牙。遇到异常时先看灯语判断状态再排查。

关于 EasyClick：手机自动化脚本开发平台，覆盖安卓免 ROOT、iOS 免越狱、鸿蒙三大手机生态，还提供苹果脚本编写、苹果群控、安卓群控、远程云控、AI 群控手机等。→ 了解全部产品

---