为什么iOS 26上只有Baguette能注入触摸深入9参数IndigoHIDMessageForMouseNSEvent配方【免费下载链接】baguetteHeadless control for Apples Simulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm项目地址: https://gitcode.com/gh_mirrors/baguette/baguetteBaguette 是一款面向 iOS 26 的无头headlessiOS 模拟器控制工具一条 Swift 命令行加上自包含的 Web UI让你不开 Xcode 就能启动模拟器、60 fps 串流画面、注入点击、滑动、双指手势和系统边缘手势。iOS 26 悄悄改写了模拟器底层SimulatorHID的线上消息格式idb、AXe等老牌桥接所依赖的 5 参数 HID 调用集体失效——要么消息被丢弃要么直接弄崩backboardd。本文拆解 Baguette 为什么是这条路上唯一还能稳定注入触摸的实现核心就是它对IndigoHIDMessageForMouseNSEvent这套 9 参数配方以及更深的 384 字节修复的逆向与工程化。一、为什么 iOS 26 之后触摸注入集体失灵先说结论不是工具写错了是苹果换了接线方式。旧世界的 5 参数调用idb/AXe走的老签名把消息路由到一个指针服务。iOS 26 上该路径要么静默丢消息要么直接让backboardd崩溃。新世界的 9 参数签名Xcode 26 的 preview-kit 里IndigoHIDMessageForMouseNSEvent变成 9 个参数正确签名会把触摸路由到数字板目标0x32即 guest 端已注册的那个 digitizer 槽位。目标不能自己算IndigoHIDTouchTarget的注释里有一张真实崩溃现场——给 guest 发一个它从未注册过的 targetSimHIDVirtualServiceManager会直接抛异常杀掉整个 SpringBoard。所以0x32是一个某条 create-service 消息注册过的常量而不是任何从屏幕 ID 计算出来的值IndigoHIDTouchTarget.swift。换句话说在 iOS 26 上能发出消息是基本功发到正确 target、用正确参数布局才是分水岭。Baguette 的输入管线就建在这两条之上CLI、baguette input的 stdin JSON、浏览器的 WebSocket 三条入口全部汇入同一个 GestureDispatcher →Input→ IndigoHIDInput.swift。二、9 参数配方逐一拆解下面这张表就是配方的全部。前 5 个参数是语义后 4 个是 iOS 26 新增的坐标系与比例尺源码中完整注释见 IndigoHIDInput.swift 第 29–38 行#参数取值作用1CGPoint *p1归一化坐标0–1主触点位置x / 屏宽、y / 屏高2CGPoint *p2可为nil第二根手指单指传nil双指捏合/平移才用3target0x32路由到触摸数字板子系统CarPlay 面板则是14nsEventType1down2up6draggedAppKit 鼠标事件类型决定这是按下/移动/抬起5direction1down0move2upHID 语义方向与事件类型配对使用6–7unused1/2固定1.0保留位传 1.0 即可8–9widthPoints/heightPoints屏幕点尺寸告诉 guest 屏幕多大坐标按此换算三个必须知道的隐性规则坐标是归一化的。线上协议传的是设备点device points但真正调 C 函数前sendMouse 会先除以width/height压到 0–1。必须跑在主线程。这个 C 函数内部读取 AppKit / NSEvent 的线程局部状态在 NIO 事件循环线程里调用会构造出畸形消息并被模拟器静默丢弃——所以baguette serve的 WebSocket 路径会先 hop 到MainActorAGENTS.md 有专门一节。双指有沉降窗口。两指mouseDown后约 50 ms 内构造器返回nilBaguette 用最多 12 次 × 5 ms 重试覆盖这个窗口既不丢事件也无感知延迟。还有一个藏在同名的细节同一个 C 函数、两种参数布局。Baguette 同时把IndigoHIDMessageForMouseNSEvent位转成 9 参数版tap/pan/pinch和 7 参数版(CGPoint*, CGPoint*, target, eventType, edge, w, h)——后者第 5 个参数是IndigoHIDEdge是 iOS 判断这是系统边缘手势还是应用内拖拽的开关反汇编0x11270处的cmp x24, #0x4正是对 edge 枚举做上界检查源码注释 39–56 行。三、更深的坑Xcode 26 的回归与 384 字节修复按上面的 9 参数配方发 tap在早期 Xcode 26 预览版上是通的。但到了 iOS 26.4 / Xcode 26回归出现了裸鼠标事件要么被误判成 Home 手势要么静默丢弃。Baguette 的选择不是硬修这个 wrapper而是换一条以假乱真的路——喂给模拟器一个硬件形状完全真实的IOHIDEventIOHIDDigitizerDispatch.swift步骤做什么为什么1️⃣ 造手指事件IOHIDEventCreateDigitizerFingerEventeventMask按下/移动用0x07、抬起用0x06位掩码决定 iOS 看到的是持续触摸还是抬起tipPressure必须保持 0非零会崩 HID 处理器2️⃣ 包父事件IOHIDEventCreateDigitizerEventIOHIDEventAppendEvent真实触摸永远是父子成对到达只发裸手指事件只会得到一条 192 字节的空壳消息被 iOS 无视3️⃣ 过 trackpad wrapperIndigoHIDMessageForTrackpadEventFromHIDEventRef三个*FromHIDEventRef包装器里只有 trackpad 这个接受 digitizer 类型并产出 384 字节双记录消息4️⃣ 打两个字节补丁0x6c/0x10c写 target0x320x3a/0x3b(0xda/0xdb) 写边缘位图存在标志wrapper 留下两个未初始化字段iOS 却要读不补丁消息就进未消费通道被丢patch 实现5️⃣ 异步发送并等回执SimDeviceLegacyHIDClient.send 5 秒完成回调返回只代表排队不代表 Mach 发送完成一次性 CLI 可能提前退出丢事件完整推导过程包括每个字节位如何试出来都写在 docs/features/touches/design.md 里还附了一个专门的证伪面命令baguette diag-digitizer-trackpad可以--dump打印 16 字节十六进制、--compare-with-mouse把同坐标走鼠标路径的字节并排 diff——iOS 哪天再改布局这就是第一个响雷的地方。四、边沿手势Home、App Switcher 与锁屏有了 edge 位图bottom0x01、left0x02、right0x04、top0x08外加0x3a处的存在标志0x04Baguette 就能合成所有系统手势。妙处在于iOS 自己只靠速度、驻留和起始 x 区分手势Baguette 不做任何客户端判别体验与 Simulator.app 完全一致手势形状配方iOS 的反应快速上甩y≈1.0 → 0.3012 步 × 16 msedgebottom回 Home 屏慢拖上滑y≈1.0 → 0.5830 步 × 35 ms 中途驻留 900 msedgebottom弹出 App Switcher 卡片左上慢下拉(0.25, 0.0) → (0.25, 0.55)24 步 × 25 msedgetop下拉锁屏右上慢下拉(0.75, 0.0) → (0.75, 0.55)24 步 × 25 msedgetop展开通知中心这些配方都沉淀成了按钮一条命令即可touches/README.mdbaguette tap --udid UDID --x 220 --y 480 --width 440 --height 956 baguette swipe --udid UDID --start-x 220 --start-y 800 --end-x 220 --end-y 200 --width 440 --height 956 baguette press --udid UDID --button swipe-to-app-switcher浏览器端则更直观baguette serve的焦点画布自动识别边缘拖拽——从底部 7% 拖起就带edge: bottom从顶部 7% 拖下就带edge: topiOS 会实时播放对应的系统预览动画全程跟随你的真实拖速不做松手回放。五、上手三分钟验证触摸注入# 1. 安装Apple Silicon Xcode 26 brew install baguette # 2. 或者从仓库源码构建 git clone https://gitcode.com/gh_mirrors/baguette/baguette cd baguette swift build # 3. 启动模拟器并注入触摸 baguette list baguette boot --udid UDID baguette tap --udid UDID --x 219 --y 478 --width 438 --height 954 baguette serve # 浏览器打开 http://127.0.0.1:8421/simulators 直接点按如果 tap 报成功却没反应优先排查两件事设备是否刚被 Xcode 27 的 Device Hub 接管用baguette heal修复见 device-hub以及你是否在主线程外调用了鼠标路径按钮路径是纯 C、线程安全的可当探针用。六、关键文件清单想读什么去哪里9 参数 / 7 参数配方与常量IndigoHIDInput.swiftIOHIDEvent 五步修复与字节补丁IOHIDDigitizerDispatch.swift推导过程 探针命令docs/features/touches/design.md用户文档参数、边沿、坑docs/features/touches/README.md端到端跟踪一次 tapdocs/ARCHITECTURE.md对应的单元测试Tests/BaguetteTests/Input/一句话总结iOS 26 换掉了模拟器输入线上的插头Baguette 先把 9 参数IndigoHIDMessageForMouseNSEvent配方逆向了个底朝天又在 Xcode 26 回归后用硬件级 IOHIDEvent trackpad wrapper 字节补丁打了补丁——这两层合起来就是今天它能在别人失灵的地方稳定注入触摸的全部秘密。【免费下载链接】baguetteHeadless control for Apples Simulators — 3D models, taps, swipes, multi-finger gestures, 60 fps streaming, and a multi-device farm项目地址: https://gitcode.com/gh_mirrors/baguette/baguette创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考