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

一、蓝牙 HID：iOS 自动化的“免签名捷径”

代理模式虽好，但签名 IPA 这道门槛劝退了不少人：个人开发者签 7 天就过期，企业签需要付费资质，重签运维成本持续存在。蓝牙 HID 方案直接绕开签名——用一块 ESP32C3 开发板模拟成蓝牙鼠标/键盘，手机系统层面把它识别为标准蓝牙外设，配合辅助触控（小白点）实现点击、滑动、输入等操作。整个过程不需要在手机上安装任何代理 App，也不涉及任何签名证书。

更关键的是它的截图机制：不走屏幕镜像。市面上多数硬件自动化方案依赖屏幕镜像把画面实时回传电脑再截取，这种“视频采集”特征很容易被 App 风控系统识别。蓝牙 HID 方案用 image.captureFullScreenNoAuto 直接抓取屏幕单帧画面，不建立镜像通道，极大降低了被风控检测的概率——这是它区别于其他硬件方案的核心卖点。

从技术链路看，蓝牙 HID 方案分为三层：开发板（硬件层）负责模拟 HID 设备并向手机发送鼠标/键盘事件；中控（通信层）通过串口或 WiFi 与开发板通信，下发控制指令；脚本（逻辑层）调用 bleEvent 系列函数编排自动化流程。三层解耦，任何一层都可以独立替换或升级。

二、硬件与固件准备

2.1 开发板选型

• 型号：ESP32C3，主流开发板均可，淘宝、拼多多、1688 均有售；
• 有带焊引脚和不带焊引脚两种规格，刷固件时需要用到 USB 口，选带 Type-C 或 Micro-USB 的版本即可；
• 固件免费，到 EasyClick iOS 资源文件夹 → USB 版本 → 蓝牙固件下载，注意不要选成安卓版或 OTG 版固件。

2.2 固件两种坐标模式

ESP32C3 刷入的蓝牙固件分相对坐标和绝对坐标两种，选择哪种直接影响后续脚本编写的复杂度和点击精度：

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

建议：新设备优先用绝对坐标固件。省去补偿率计算和归零操作，脚本编写更简单，长时间运行也不会出现坐标漂移。如果设备系统低于 iOS 17，则只能选相对坐标固件，配合 bleEvent.resetZero 定期归零。

2.3 刷入固件

刷入方式与安卓版蓝牙 HID 一致，使用 ESP 烧录工具即可。关键注意事项：

1. 确认选的是 iOS USB 的蓝牙固件，不要选成安卓蓝牙固件或 OTG 固件；
2. 刷完后获取开发板 MAC 地址，后续绑定和中控识别都依赖它；
3. 刷固件时建议关闭中控软件，避免串口被占用导致刷入失败。

三、绑定与配置流程

3.1 设备与蓝牙绑定

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

3.2 手机系统配置（关键步骤）

蓝牙 HID 能否正常工作，完全取决于以下系统选项是否正确开启。漏开任何一项都可能导致鼠标不响应或行为异常：

• 设置 → 辅助功能 → 触控 → 辅助触控（小白点）打开；
• 跟踪灵敏度拉到最左侧（龟速端），避免鼠标移动过快导致定位不准；
• 打开「执行触控手势」「显示屏幕键盘」；
• 辅助触控 → 鼠标键：初始化延迟和最大速度拉到最左，开启鼠标键、Option 切换、使用主键盘；
• 通用 → 触控板与鼠标 → 跟踪加速度拉到最左；
• 设置 → 辅助功能 → 键盘与键入 → 全键盘控制打开，并在「命令」中自定义快捷键（后续键盘快捷键功能依赖于此）。

这些配置只需做一次，重启手机后依然生效。但如果系统更新后出现异常，优先检查这些选项是否被重置。

3.3 通信方式

开发板与中控之间的通信方式有两种，按需选择：

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

WiFi 模式的优势在于开发板配网后不再需要连接电脑，只要在同一局域网内中控就能找到它，适合机架式部署。注意 ESP32C3 仅支持 2.4G WiFi，不支持 5G 频段。

3.4 测试验证

配置完成后右键 → 蓝牙 HID 设置 → 测试蓝牙 BLE，点击「鼠标移动」或「HOME 按键」，手机有对应动作即配置成功。如果没有动作，按以下顺序排查：

1. 确认手机蓝牙已开启且与开发板已配对；
2. 核对 3.2 节的系统选项是否全部正确开启；
3. 按住开发板 RST 键 5 秒后松开，重新配对蓝牙。

四、输入功能的三种降级方案

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

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

第三种方案（快捷指令助手）的完整流程：

1. 电脑端下载并运行 iOS 快捷指令助手；
2. 手机新建快捷指令，请求 http://电脑IP:8696 接口获取内容；
3. 在快捷指令中加设备震动动作，保证后台也能取到数据并放入剪贴板；
4. 回调 suc 接口告知程序执行成功；
5. 在「全键盘控制 → 命令」中给这条快捷指令绑定快捷键；
6. 中控右键 → 蓝牙 HID 设置 → 新增键盘快捷键，绑定相同组合键；
7. 脚本中通过 bleEvent.keyPressChar 触发该快捷键，完成输入。

配置虽然繁琐，但配好后可以分享给其他手机复用，是免签名场景下的实用兜底方案。

五、键盘快捷键与脚本配合

5.1 绑定键盘快捷键

蓝牙 HID 方案通过模拟键盘按键触发系统级命令：

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

5.2 脚本调用

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

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

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

5.3 截图与识别能力

蓝牙 HID 方案下，除节点功能不可用外，其余识别能力均可正常使用：

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

六、常见问题排查与误区

6.1 问题排查表

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

6.2 开发板灯语速查

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

6.3 常见误区

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

七、FAQ

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：手机自动化AI智能体平台，覆盖安卓免 root、iOS 免越狱（代理/蓝牙 HID/OTG HID）、鸿蒙 Next 三大生态，提供脚本开发、苹果群控、本地中控投屏与云控系统。→ 了解全部产品

---