企业官网建设流程全解析

WiiCompiled 是一个把《马力欧赛车 Wii》通过静态重编译变成原生 PC 程序的开源项目：运行时没有任何模拟器、解释器或 JIT，也不存在 PowerPC 指令。本文带你搞懂静态重编译与传统模拟器的本质区别、拆解项目核心管线，并附硬件要求与安装指南。

📌一句话结论：游戏代码在安装阶段就在你自己的电脑上"编译"成了原生机器码——你按下启动时，跑的不是模拟器，而是一个原生的 PC 程序。

一、模拟器、JIT、静态重编译：到底差在哪？

传统 Wii 模拟器（如 Dolphin）需要在运行时处理 PowerPC 代码，常见两种路线：

• 解释器（Interpreter）：逐条翻译指令执行，慢但最稳定
• JIT：运行时动态翻译热点代码，更快，但边玩边"翻译"

WiiCompiled 走的是一条完全不同的路——在启动前把整个游戏编译成原生代码：

⚖️ 注意：项目不随包分发编译好的游戏二进制。Setup 会在本机完整跑一遍静态重编译器，再把结果交给 C++ 编译器——这是一次性成本，之后每次启动都是纯原生执行。

二、技术管线：从 main.dol 到原生可执行文件

核心工具链是一个用 .NET 8 / C# 编写的翻译器 Translator，整个流程分四步：

1️⃣ 解析 DOL，递归遍历调用图

项目清单 projects/mkwii/recomp.yml 锁定了输入文件main.dol/StaticR.rel及其 SHA-256 指纹，只接受干净未改动的 PAL 版RMCP01。翻译器从入口0x800060A4递归遍历调用图，解码每一个可达函数：

translator translate-recursive 0x800060A4 --project projects/mkwii/recomp.yml

2️⃣ 指令解码 + IR/SSA 提升 + 类型推断

反汇编出的 PowerPC 指令被"提升"到中间表示（IR）：PpcLifter.cs 负责指令级提升，SsaTransformer.cs 将代码转化为 SSA 形式，再配合类型推断，把寄存器语义精确映射到原生变量上。遇到未支持的指令默认直接报错，绝不静默跳过。

3️⃣ 生成 C++，交给 Clang 编译

产物不是机器码，而是C++ 源码：

• generate-data-init：生成内嵌数据段初始化代码与RuntimeConfig.h
• emit-build-shards：生成 CMake 构建图
• 最后由 CMake + Ninja + Clang 把生成的源码与运行时一起编译成单一可执行文件

4️⃣ 运行时：用纤程复刻"Wii 操作系统"

runtime/ 是游戏的原生"兼容 OS"。最有意思的是纤程调度器：每个客端OSThread映射为一个宿主 fiber，线程只在显式让出点（OSSleepThread、OSYieldThread等）切换，精确复刻 Wii 的协作式调度语义——设计意图写在 fiber_manager.h 的注释里。

5️⃣ 图形层：aurora 原生渲染

图形层构建在 aurora 之上——一个源码级的 GameCube / Wii 兼容层。GX 图形命令流直接经 WebGPU（Dawn）渲染，支持 D3D12 / Vulkan / Metal 后端，原生支持宽屏与多倍分辨率缩放。

三、性能体验：比模拟器强在哪？

因为游戏代码 100% 原生执行，WiiCompiled 带来了许多模拟器难以企及的体验：

• 🚀解锁帧率 + 帧插值：原版硬锁 60 fps，它能在帧间生成插值帧，配合 120/144 Hz 显示器肉眼可见更顺滑（实验性功能）
• 🖥️任意宽高比 + 高内部分辨率：窗口拉多宽都行，相机实时自适应；可以数倍于主机的分辨率游玩
• 🎵音乐闪避（Ducking）：你在听 Spotify、看视频时，游戏音乐自动让位，其他音频停止后自动恢复
• 🎮F10 游戏内设置栏：内部分辨率、FPS 计数器、四端口手柄映射、震动、音量等实时可调，即时写入Config.toml
• 📟Dolphin 兼容输入表达式：支持 Dolphin 语法的按键表达式，可直接导入GCPadNew.ini
• 🎤真实 Wii 手柄：通过蓝牙配对，官方 Wii U / Switch 体感适配器（WUP-028）也能用

物理精确度：100%。官方证明方式很巧妙——游戏内鬼影是基于输入而非位置跟踪的重放文件，鬼影能与真机完全重合，即证明物理在 Wii / Dolphin / WiiCompiled 三者间严格一致。

四、安装步骤与硬件要求清单

📦最简单的安装方式：使用模组管理器Wheel Wizard，在设置里选择你自有的 PALRMCP01镜像，开启WiiCompiled (beta)开关，一键安装、更新和启动。项目自带的 Launcher/ 目录则是纯命令行后端，分平台实现 Windows / Linux / macOS 的安装逻辑。

⚠️合规提醒：项目不包含任何任天堂代码、素材或游戏数据，你需要自行准备合法 dump 的 PALRMCP01镜像（支持 ISO / GCM / GCZ / CISO / WBFS / WIA / RVZ）。翻译全程在本机完成，任何数据不会上传；其他区域版本和已修改的可执行文件会被直接拒绝。

💡为什么 Setup 这么慢？因为静态重编译器需要处理整个游戏的代码，再把 C++ 编译器压上跑一遍全量构建。这一次性成本，正是"无 JIT、无解释器"的代价——换来的是按下启动键之后纯粹的原生性能。

Apple Silicon 用户如果想从源码完整构建，可参考 macOS 构建指南，步骤从解包光盘到 CMake 编译一应俱全。

五、源码导读：核心模块地图

对开发者来说，翻译器的默认测试套件不需要任何游戏数据和宿主机 C++ 编译器，克隆仓库后即可直接开工：

dotnet test translator/Translator.sln -c Release

六、常见问题 FAQ

Q：这是模拟器吗？不是。所有代码在你按下启动键之前就已编译为原生代码，运行时没有任何 Wii CPU / GPU 的模拟。

Q：能拿它重编译其他 GameCube / Wii 游戏吗？翻译器本身对 DOL / REL 是通用处理的（参考 projects/examples/generic-dol.yml）。但想真正可玩，还需要一整套运行时：音频、输入、GX 等游戏接触到的所有系统。

Q：做完收尾了吗？还没有。游戏已做到全内容可玩、物理 100% 一致，但兼容性、渲染、网络与性能仍在积极打磨中。

Q：Retro Rewind 支持吗？支持。ZPL 的 Retro Rewind 可以被构建成独立静态 Profile：Mod 的Code.pul代码与基础游戏一起被静态翻译，编译成另一个原生可执行文件，而不是运行时打补丁。

Q：协议是什么？GPLv3 开源协议。任何基于 WiiCompiled 分发的《马力欧赛车 Wii》发行版，同样必须采用 GPL v3.0。

WiiCompiled 证明了一件事：从"模拟硬件"到"重编译游戏"的路线不仅技术上可行，还能在性能与画面上带来原生级别的体验。对玩家来说，这是前所未有的 PC 版《马力欧赛车 Wii》；对工程师而言，它是一个教科书级的静态重编译开源范本。🎮