[qiyinxi]

原来叠在 #102（客体驱动库模板修复）上；#102 已合，已把 main 合进来，现在只剩转译层这一个改动。

为什么

World of Airports 3.7.3（Unity 6000.3）启动约 2 秒闪退：ndk_translation: Undefined instruction 0xd50320bf，在 libunity 的加载线程里 SIGILL。0xd50320bf 是 AArch64 的 SEVL（HINT #5）。Google 的转译层 0.2.3（API 34 r14 镜像）把 HINT 空间里的 WFE、WFI、SEV、SEVL 当未定义指令；按 ARM 规范，它们可以按 NOP 执行（WFE、WFI 允许立即返回，SEV、SEVL 只影响 WFE）。新版 Unity 的自旋锁会用 sevl; wfe。

改了什么

ndkfix（新包）：在本机从镜像自带的 /system/lib64/libndk_translation.so（sha256 a2086fbc…，build-id 553ba82b…）生成补丁版。

• 三套解码器（重优化器、轻转译器、解释器）的 DecodeSystemClass 里，HINT 那一支各有一处 jbe rel32 跳到未定义指令出口，换成 6 字节 NOP。之后它们落到 NOP 和 YIELD 原来走的那条出口。
• 只改 HINT 类（op0=00、op1=011、CRn=0010）；其余未定义编码（UDF、SB、MSR 立即数等）照旧 SIGILL。
• 等长原地替换，build-id、动态符号、GOT、重定位、数据区都不动。执行桥按 build-id 启用的门控和 fork 保护照常生效（伴生库按名字找映射，补丁版挂在原路径上）。
• 补丁库 sha256 3efa8977…，只在本机生成、不分发；仓库里只有哈希和补丁点附近几个字节的 golden 值。

guestpatch + libfix.sh（代替原来的 vulkanfix 编排）：

• 两个补丁（客体驱动库、转译层）用同一种 profile 描述。
• 客体脚本 libfix.sh 在一次 root 运行里先只读检查全部目标。只要有一个要上传，这次一个都不挂。然后逐个 chcon 成目标文件的标签、bind mount、核哈希，失败的那个 umount、不影响别的。只要新挂上了任何一个，就 setprop ctl.restart zygote 一次。
• 所以两个补丁共用一次 zygote 重启：开机不比原来多花时间，也不会出现「已经挂上、zygote 还是旧的」这种状态。
• 选补丁看实例自己的配置（inst.Config）：缺 abi.type 时按 x86_64 处理，ARM64 客体不套用，不再重读 config.ini（ModAVD#130）。
• 进度的 step 名 vulkan_fix 不变，文字改成「客体库补丁」。

测试

• ndkfix：真库（本机的 testlibs，不碰生产）逐字节比对；差异只落在声明的补丁点里、build-id 不变；补丁点 golden；错误输入返回 Unsupported；用 debug/elf 核 textDelta。
• libfix.sh：用 Git 自带的 sh 加假根目录跑。覆盖：两组都挂只 setprop 一次；有上传就一个不挂；镜像不对；目标不存在；缓存坏；挂载失败会 umount；已挂不再 setprop。
• guestfix：假客体跑多 profile 的 launched、owed、adopted，覆盖上传、上传失败、前台有游戏、ARM64 不跑脚本、脚本运行期间持有 guest 锁。
• 变异检查：去掉输入哈希检查、少改一处补丁点、去掉「有上传就不挂」、每组各 setprop 一次、owed 时不过闸、跑脚本时不拿 guest 锁，单测都会失败。
• 本地全量检查：gofmt、三个平台 vet 和 build、Windows go test（跳过读生产根的四个）。
• 实机（flow-b，带执行桥的 API 34 实例）：
  • 冷启动后两个补丁在同一次脚本运行里挂上，zygote 只重启一次，开机加设置 40 秒；客体里 /system/lib64/libndk_translation.so 的 sha256 等于补丁版。
  • WoA 不再出 0xd50320bf，整段 logcat 里没有未定义指令；pairip 加密的 libunity、libil2cpp 在转译层下正常加载。
  • 用拥有该游戏的账号过了许可检查，走到登录界面，进了机场。

要注意

• 执行桥和文档里有四处写着「Google 的转译层二进制一个字节都不改」，合了以后不再准确。措辞已另开 PR 改：文档：执行桥文字注明 ARM 转译层补丁由管理器另挂 ModAVD#151、文档：执行桥页面注明 ARM 转译层补丁由管理器另挂 modavd.github.io#20，和本 PR 一起合。
• 只认 API 34 r14 镜像的转译层（a2086fbc…）；其他版本状态是 SKIPPED，照旧闪退，只留一条日志。
• WFE 当 NOP 以后，sevl; wfe 自旋变成忙等。WoA 主界面上没看到 CPU 被占满。
• 被接管的、由旧版开机的实例只检查不挂，下次由新版开机才生效。
• 这条路是所有 x86_64 实例开机都要走的，涉及用 root 把本机生成的库 bind mount 到系统库上，按规矩另开会话审。其他游戏的回归放进下个版本的发版回归。

Refs ModAVD/ModAVD#131
Refs ModAVD/ModAVD#130