第一次连手机，能卡住人的地方其实不多。
上个月远程带一个客户装第一台，他折腾了一下午没连上。我让他把报错截给我，一眼就看出来了：桥接程序放在 “D:\新建文件夹\群控 测试” 里。
路径里有中文和空格，脚本直接执行异常。改到 D:\ec 下面，三分钟通了。
按这个顺序走：认设备、挂镜像、建通道。
第一步，让电脑认出这台手机
插线，开爱思助手，看它认不认。
认不出就按这个顺序排：换根线、换个 USB 口、手机上点「信任这台电脑」、最后修复驱动。
这四项里，线材出问题的概率最高。便宜线用两三个月开始接触不良，症状是时好时坏。你以为没连上，其实是那根线。
装机路径也有讲究。中控和桥接程序的路径只用字母和数字，别出现中文、空格、特殊字符。
这是 Windows 的老毛病。路径一脏，脚本就报 com.js.main 执行异常，报错信息里又看不出跟路径有关，所以很多人查错方向。
爱思和 EC 的驱动也可能抢设备。爱思一直占着的话，先卸爱思，装完 EC 再把爱思装回来。顺序反了，两边互相抢端口。
第二步，开发者镜像和代理 IPA
iPhone 要挂一个开发者镜像才能通信。从网盘下载 DeveloperDiskImage.zip，解压到桥接程序的 config 文件夹，按版本规则放好。
版本对不上，就把最接近的那个镜像文件夹名字改成跟手机版本一致。
真找不到机型对应的，去公开的设备支持文件仓库里按型号提一个。这一步多数人一次过。卡住的，多半是没有镜像，或者版本差太远。
代理 IPA 要看版本。iOS 17 以上至少 7.1.0+。低版本装上去不报错，连上了没反应。这个症状容易误判，看起来像中控的问题。
9.0 以上的代理 IPA 自带了 OCR 模型文件，包会大不少。用不到识别的，可以把 ipa 当压缩包打开，进 PlugIns，把 .bin、.param、.onnx 结尾的文件和 keys.txt、ppocrv5_mobile_labels.txt 删掉，再压回去。
第三步，开自动化，看通道建没建起来
点「开启自动化」，然后等。iOS 17 以上这一步不会很快。系统在建一条虚拟网卡通道，网卡名字是 tun 开头。
等的时候去网络连接面板看一眼，有没有 tun 开头的网卡。出现了，通道就建起来了。
没出现有两种解法。一是手动装驱动。二是用爱思最新版本做一次实时投屏，这一步会把驱动一起装上。第二种更省事，我一般先试它。
iOS 17.4 以上，这步能省。7.5.0+ 的中控针对 17.4+ 做了优化，不用装驱动，直接双击 ioscenter.exe 就跑，速度还更快。
要强制走驱动的话，用记事本打开 bridgebin/config/config.toml，把 run174iOSTunnelType 改成 1。
连上之后，先做这两个检查
先确认屏幕宽高对不对。截图或者取坐标不准，多半是宽高用了缓存值。用 device.getDeviceInfo 拿一次实时宽高，跟投屏画面对一下。
宽高不对，后面的点击都会偏。这一步大概一分钟。
再把坐标系定死。横竖屏切换，坐标系会跟着变。竖屏转横屏调 adjustScreenOrientation(2)，反过来调 1。
图色只支持竖屏，节点横竖屏都行。混用的时候要显式设一次。尽量全程固定一个方向，来回切会带出一堆对不齐的问题。
然后跑一个最笨的流程。先别写复杂脚本。打开某个 App，点两下，退出。
这个能跑通，整条链路就是通的。跑不通，问题在上面三步里。