另一款完成全面反编译、还有一款在别的平台跑到 90 帧:移植潮正在外溢

原创2026-11-09 17:35:311,715 阅读
文章标签:游戏开发逆向工程图形学代码生成

另一款完成全面反编译、还有一款在别的平台跑到 90 帧:移植潮正在外溢

过去一年里,主机游戏的"非官方 PC 版"已经很少再被简单归为"模拟器又进步了"。同一时间窗口内出现的三条消息,指向的是三条不同的技术路线:《塞尔达传说:黄昏公主》被社区宣布完成全面反编译;《王国之泪》的 Mac 移植版在另一个平台上跑到 90 fps;而《时之笛》的 Switch 2 版本,被一个名为 NX2navi 的项目用静态重编译的方式变成了原生 Windows x86-64 程序,最新版本 0.5.0 已经可以正常游玩。

把这三件事放在一起看,真正值得讨论的不是"谁又跑起来了",而是跑起来的方式变了:从逐条解释执行,转向把客机机器码整体翻译成宿主机程序。本文以 NX2navi 的源码为主要解剖样本——它是三者中唯一在本文可读范围内公开了完整实现细节的项目——来看这套方法里哪些部分是可复用的,以及当移植从"单点突破"变成"流水线作业"之后,社区热度究竟会被分散还是被放大。

NX2navi 项目图标:以游戏中的精灵形象绘制的引导标识

三条进度条,三种不同的"完成度"

先把三个项目的状态摆在同一张表里,但必须承认它们的度量衡并不可比。

作品 路线 社区情报中的状态 可核实的细节
黄昏公主 全面反编译(源码级重建) 反编译完成,被认为具备脱离模拟器登陆 PC 的前提 情报仅给出结论,未披露完成度与可玩范围
王国之泪 平台移植 Mac 移植版帧率达到 90 fps,被拿来与 Switch 2 及 PC 端方案对比 情报未说明该 90 fps 对应的分辨率、画质与稳定性
时之笛(Switch 2 版) 静态重编译 0.4.0 首个公开版本,0.5.0 修复雾效与植被闪烁 仓库 README.md 明确:Windows x86-64 原生程序,Vulkan 渲染器,默认 60 fps

同时还有另一批数字在流传:某《时之笛 3D》PC 重编译 Alpha 版在 RTX 3060 上稳定 55–60 fps;某 Switch 2 模拟器在发售当天就把重制版跑到了 60 帧;另一个《时之笛》PC 移植项目则把帧率上限推到了 250。

这些数字不能横向比较,原因写在 NX2navi 的帧率实现里。

frame_rate.c 的注释记录了一条硬约束:帧率上限被 LIMIT_MAX_HZ 钉在 240,而真正的地板来自 Havok 物理。1.4.3 版本在步长低于 1/240 s 时,物理预解算(profiler scope TtPreSolve,位于 main+0x1261630)会去扩容一块缓冲区,随后 hkDefaultMemoryImpl 直接报 "Out of memory";实测 1/240 s 能跑,1/244 s 及更短则在数秒内 abort。也就是说,240 不是渲染管线的带宽上限,而是游戏自身物理系统的崩溃边界。这一条足以解释为什么"250 帧"是另一个项目的数字:它们的运行时实现不同,撞到的墙也不同。

同样,"模拟器 60 帧"与"重编译 60 帧"也不是一回事。README 的第一条特性写得很直白:Native code, not emulation。前者仍然要在运行时解释或 JIT 客机指令,后者在构建期就把指令翻译完了。这也是为什么 NX2navi 的门槛表里写的不是"能跑模拟器",而是 SSE4.2、16 GB 内存、Vulkan 1.3 加 VK_EXT_external_memory_host 与 VK_EXT_mesh_shader。

把 ARM64 摊平成 C:一条可以照抄的流水线

打开 docs/architecture.md,整条链路是五段:输入、CPU、宿主、图形、工具链。

第一段只做一件事:从玩家自己的 dump 里取出 ExeFS 与 RomFS。所有派生产物都落在 build/ 或 generated/,仓库里绝不出现游戏数据,这一条由 tools/check_content.py 与 CI 的 content-guard.yml 强制。

第二段是这类项目最核心的资产:把 AArch64 翻译成 C。

  • 模块划分是 main、sdk 和若干 subsdk*,rtld 被丢弃,改由宿主自己完成链接;
  • 解码器是手写的(recomp/lifter.py),NEON/FP 走 recomp/simd_c.py 降低到可移植 C,每个客机函数生成一个 C 函数;
  • BL 直接生成直接调用,间接跳转走一张以地址为键的表,运行期由 rt_dispatch 查表并尾调用;
  • 函数发现不靠人工标注,而是靠种子:.eh_frame_hdr、导出的 FUNC 符号、RELATIVE 重定位目标,加上每一条 BL 的目标,以及被 ADR 或 ADRP+ADD 具体化的代码地址。

真正决定这套东西能不能复用到下一部作品的,是两处工程细节。

其一是代码补丁表。整个仓库里,与"具体这一版游戏"强绑定的内容被压缩成几个 patches-v*.txt 文件。以 recomp/patches-v111.txt 为例:

site ostep main 6e6cc0 1e220c21 @page:x10   # fcsel s1, s1, s2, eq -> adrp x10, page
site ostep main 6e6cc4 1e201828 bd410148    # fdiv s8, s1, s0 -> ldr s8, [x10, #256]

每一行是"某条指令的原始字 + 替换后的指令",生成器会先校验原字是否对得上,再打补丁。这意味着换一版游戏,需要重做的不是整套反编译器,而是这张表。仓库里已经有 patches-v110/v111/v121/v143 四份,说明这条流水线至少跨了四个游戏版本。

其二是差分测试。lifter 的每一次改动都必须通过以 Unicorn 为 oracle 的测试组:tests/diff/lift.py 抽样指令、simd.py 覆盖整个 FP/SIMD 编码空间、atomic.py 覆盖独占访存与 ARMv8.1 原子指令、func.py 按生成器的形态验证整函数。其中跳表解析还单独有 tests/jumptables_check.py,要求在 1.2.1 与 1.4.3 上都报告 0 分歧。

值得一提的是,跳表模块本身的体量:recomp/jumptables.py 有 1345 行,比整个手写解码器(830 行)还长。这很符合实际——编译器生成的 switch 分发是静态重编译最容易出错的地方,也是社区里"AI 指着代码就能把游戏搬上 PC"这类叙事最失真之处:真正的工作量不在"看懂指令",而在"证明每一个边界都对"。

真正的移植成本在运行时,不在翻译

翻译完的 C 只是开始。玩家体感上的"像原生一样",来自三个子系统。

线程模型。 游戏假设的是 Horizon 调度器:三个应用核、线程只在自己亲和掩码允许的核上运行、高优先级线程可以剥夺低优先级线程的核;而游戏里大量每核数据结构是不加锁的。宿主必须把这个语义做出来,见 runtime/kernel.c:

  • 三个虚拟核,客机线程只有持核时才跑客机代码,其余在按优先级排序的等待队列里;
  • 抢占是协作式的:等待者优先级更高时打一个标记,持有者在下一个 SVC 和每一次间接调用(rt_dispatch)处检查;
  • 异步抢占默认开启:等待者自旋满 250 μs 就挂起持有者,若其宿主 rip 位于顶层提升代码,则把它挪到 kern_ap_stub,在那里保存易失寄存器并交出核;
  • 自旋等待被统一改道到 rt_spin_gate,每轮暂停一次核,轮询 50 μs 后把核交给等待者。

这套东西如果做错,症状不是"慢",而是随机的死锁和数据竞争——属于那种必须在移植初期就复用的基础设施。

内存。 客机地址等于宿主地址,全部限制在 2^39 以下(IPC 只编码 39 位地址);堆、栈、别名区用 MEM_WRITE_WATCH 预留,于是图形后端可以问内核"自上次上传以来 CPU 写了哪些页"。这段设计在 Windows 上靠 GetWriteWatch,在 Linux 上换成了另一套机制(后文会讲)。

图形。 这是最厚的部分,也是三层结构:

  1. NVN 2 前端(nvn_api_*.c、nvn_obj.h),负责纹理布局、deswizzle、Switch 2 的 GOB 排布;
  2. 在 QueueSubmitCommands 时,把录制好的 NVN 命令在提交线程上重放成 Vulkan 命令缓冲(vk_exec*.c),并用一个录制线程从包环里发 vkCmd*(vk_rec.c);
  3. 驱动层。这里有两个不那么显眼但极关键的修补:uniform 快照(游戏在提交之后很快就改写 uniform block,于是在重放开始时把本次提交绑定的每段 uniform 从 CPU 可写池里拷一份,绘制绑副本)和常量 bank c0(NVN 驱动为每个阶段维护常量库,后端必须按驱动的方式填充存储表、uniform 表、push constant,以及计算派发的 group count)。

一个具体的性能证据可以说明"导入内存"这条路的代价:架构文档直言,若不做设备本地镜像、让 GPU 直接通过 PCIe 读池内存,初始森林会跑到 7 fps。镜像加写监视之后才有 60 fps。

跨平台可复用的技术点,其实是一份"行为差异清单"

如果要从这个仓库里挑出对下一个移植项目最有价值的东西,我会选 docs/maxwell.md。它不是什么架构雄文,而是一张逐条对照表:Maxwell/NVN 怎么做、Vulkan 与 AMD 怎么做、忽略差异会看到什么、本项目怎么处理。

几个已经踩出来的坑:

  • BFE/BFI 越过第 31 位:地形顶点着色器用 ((2y + x) * 8) & 0xff 从寄存器取位置,5 位 x、y 最大到 248。PTX 语义是把字段在第 31 位截断、起始越过 31 位则取 0;而 AMD 的位域指令对偏移和宽度取模 32。结果是 Steam Deck 与 Linux 上的 RX 570(RADV)地形墙体和地面直接消失。修法是翻译器补丁 0012,在字段非常量时做钳制。
  • 纹理 gather 的亚纹素精度:Maxwell 与 AMD/Intel 在边缘 texel 上差一。不处理的话,RADV 会沿墙角和地板边缘画出随镜头角度变化的虚线。修法是按宿主的 subTexelPrecisionBits 对 gather 坐标加偏置(vk_caps.c → gather_bias → 翻译器 TexturePass.InsertCoordGatherBias),并留了 NX2NAVI_GATHER_BIAS=0 的开关。
  • 未初始化寄存器:路径上先读后写的函数局部变量,在 NVIDIA 驱动上会读到同一个 warp 其它 lane 的值。症状极其具体:时之笛的聚光灯循环把地板点亮成 4×8 像素的瓦片(正好一个 warp 一块),并把林克压暗。修法是所有函数局部变量初值置 0(zero_locals,翻译器补丁 0016),并且这条 flag 必须进着色器缓存键,否则开着 DLAA 与关着 DLAA 会命中不同的缓存。
  • 深度格式:RX 9070 没有 D24S8 附件,用 D32F 顶替时,预通道与后续通道之间的 EQUAL/LEQUAL 以及贴花偏移的行为都会变。

这类清单的价值在于它可迁移:只要你也在用同一套着色器翻译器、同一套 NVN 语义,这些坑你迟早会踩,而这里的编号(补丁 0006、0012、0013、0016、0021……)就是现成的索引。tools/xlate/patches/ 下已经有三十多个补丁文件,全部挂在同一个上游翻译器版本(1.3.2)上。

着色器链本身也是可复用的:SM86(Ampere)代码先经 tools/xlate/AmpereLowering.cs 降级到 Maxwell,再由打过补丁的翻译器转成 SPIR-V,用 .NET 10 NativeAOT 编译成 nx2navi_xlate.exe 作为独立进程运行。0.4.0 的发行说明提到,游戏的 36,031 个着色器变体现在全部能翻译——这个量级说明为什么"首次进游戏卡一下"是这类项目的通病,也说明为什么他们要把翻译结果落盘缓存、并在下次启动时预热管线(PREWARM_PIPE_MS、VK_EXT_graphics_pipeline_library 的快链 + 后台优化)。

至于"别的平台"这件事,仓库里也有答案。docs/building.md 的 Linux 一节写得很实在:运行时可编译并在 x86-64 Linux 上运行,窗口、输入、菜单换成 SDL3 版本,runtime/platform/linux.c 实现同一份 platform.h。进度是 1.2.1 在 RADV(RX 7800 XT)与 NVIDIA(RTX 3060)上 60 fps;1.4.3 在 RX 6600 上可跑,Ryzen 5 4600G 的 Vega 7 大约 34 fps;长时间游玩与 Steam Deck 本体尚未验证。

Linux 侧有一处绕不开的差异,正好解释了"为什么换平台不只是重编译一遍":

  • 写监视要 Linux 6.7 以上,用 userfaultfd 的异步写保护加 PAGEMAP_SCAN(runtime/platform/linux.c);
  • 但把导入内存反复改成只读,会让驱动在每次提交时使 userptr buffer 失效(amdgpu 上约 1.3 ms / 16 MiB),而导入本身又会 pin 住页面、把写保护抹掉。于是每个 CPU 可见池都额外拿一份 host-visible 影子存储:提交前把 CPU 写过的页拷进去,GPU 的写在栅栏处回流。代价在实测中约 0.2 ms 一帧,内存翻倍(约 1.1 GB)。

这就是"跨平台可复用"的真实边界:抽象的接口可以复用(platform.h),语义的代价不能复用,必须逐平台重新测量。

部署层:从极客脚本到"一个 setup.exe"

移植潮能外溢,很大程度不是因为技术变简单了,而是因为分发变简单了。

docs/launcher.md 描述的流程是:玩家把 NX2navi-Setup-<version>.exe 放在自己的 .nup dump 旁边,双击。安装器不需要管理员权限,装进 %LOCALAPPDATA%\Programs\NX2navi,自动在安装目录、下载、桌面、文档和各盘根目录找 dump,然后在本地下载约 170 MB 的构建工具、校验、解包、翻译、编译,10 到 25 分钟。

更新路径同样是工程化的:

  • 增量编译:exefs 与 romfs 步骤只依赖游戏文件,更新时直接复用,dump 不再需要;只有 lifter、补丁表或 bring-up 修正变了,才重新 lift;
  • 运行时以预编译静态库(libnx2navirt.a)随发行版下发,玩家机器上只编译少数包含按安装生成头文件的源文件;
  • 每个对象按源文件、头文件、编译选项与编译器版本做键(build-cache/obj/objects.json),版本目录不参与键,因此上一版的中间产物可以跨版本命中;
  • 链接先产出 ocarina.exe.new,完整后才替换;新版本启动失败(start.pyw 返回 86,或六秒内任何错误)就回滚到 previous.txt 那一版,游戏不会在运行中被重建。

installer/text/zh-Hans.json 里已经有完整的中文步骤文案,例如"将游戏代码转换为 C 代码""为显卡驱动构建着色器""写入 60 帧游戏数据补丁"——这条流水线的每个阶段都已经有了面向玩家的名字,而不是留给玩家一堆命令行。

热度:会被分散,还是会被放大

从传播角度看,三条新闻确实在互相稀释注意力:同一天里既有"反编译完成",又有"别的平台 90 帧",读者的第一反应是"到底哪个更厉害"。这类对比很难有结论,因为分辨率、画质档位、稳定性、可玩范围都没对齐。

但从工程角度看,热度更可能被放大,原因是资产在共享。

这一点在仓库里有明确痕迹。tools/fetch_refs.sh 固定拉取一个上游 checkout,其中包含一份共享的着色器清单;tools/shader_list.py 的说明写着:1.4.3 的清单在其历史上累计 24,839 行 V 行变体,1.2.1 是 25,238 行。这些行是"别的移植项目在真实游玩中遇到过的变体",被拿来提前翻译,以减少首次进入新场景时的卡顿。换句话说,一个人玩出来的着色器缓存,成了另一个人的预编译输入。

顺着 THIRD_PARTY_NOTICES.md 看,这条技术谱系更清楚:宿主运行时(动态链接、SVC、线程、IPC、音频渲染器、RomFS)、NVN 前端、帧率补丁、宽屏补丁、按钮图标生成、虚拟核抢占,全部有明确的上游来源与提交号;NVN 对象布局与命令录制格式来自更早的移动端工程;纹理布局来自 deko3d;着色器翻译器来自 Ryujinx。

这就是"外溢"的真实形态:不是某一款游戏被搞定了,而是一套组件化的栈已经成型——反编译后端 + NVN 前端 + 着色器翻译器 + 行为差异清单 + 部署管线。新项目的边际成本因此大幅下降,社区里出现"收录上百个移植项目"的清单也就不奇怪了。

但放大热的代价同样真实,NX2navi 自己的文档就是证据:

  • 版本绑定极紧:只认 1.1.1,程序 ID 0400486024DEC000、main build e0f3ccfa,其它版本直接拒绝;
  • 驱动脆弱:着色器编译器会在某些变体上崩溃(NVIDIA 615.78.08 在 RTX 5080 上,issue #30),于是工具会重试并把崩溃变体记进 shader-prepare-skip.txt;
  • 工具链全是钉子:clang/lld 23.1.3、.NET 10、Vulkan SDK 1.4.363、hactool 固定提交并打三个补丁——其中 mbedtls-asm-clobbers.patch 修的是打包的 mbedtls 2.6.1 的 x86-64 乘法汇编缺少 memory/cc clobber,不打这个补丁,clang 构建在 Linux 上会让每一次 RSA 验签失败;
  • 法务边界写死在工程里:仓库不存游戏数据,LICENSE-ADDITIONS 保留所有增补权利,README 用加粗写明"不含游戏文件、请勿分享构建产物"。

所以,对这三条新闻更准确的解读不是"哪个项目赢了",而是:移植这件事正在从"某位高手的一次性壮举",变成"一条有编号、有测试、有回滚、有上游依赖的产线"。黄昏公主的反编译完成、王国之泪在 Mac 上的 90 帧、时之笛 Switch 2 版被重编译成 Windows 原生程序,是这条产线在不同位置的三个输出。真正会决定下一款作品多久出现的,不是谁更会读汇编,而是这份差异清单和这套补丁表能被复用到什么程度。

登录后查看全文
NX2navi