第一次连手机，能把人卡住的地方其实不多。
上个月远程带一个客户装第一台，他折腾了一下午没连上；我让他把报错截给我，一眼就看出来了，桥接程序放在”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，点两下，退出。
这个能跑通，说明整条链路都是通的。跑不通，问题一定在上面三步里。