# 《密特罗德 Prime》：PrimeDecomp 的 GameCube 版一致性反编译

> 为《密特罗德 Prime》GameCube 版的可执行文件及其 NES 模拟器模块重建 C++ 源码，使 CodeWarrior 编译结果与原文件一致，涵盖美版、韩版、PAL 版与日版，另有针对体验版光盘和三个 Wii 版本的早期配置。已匹配的单元由源码编译，再与从使用者光盘中拆分出的对象链接，并按各版本的 SHA-1 哈希校验；仓库不含游戏素材或汇编。另行收录的 Metaforce 与 Metroid Prime Port 都在这份代码之上构建原生移植。

- 类型：案例
- 目标：游戏
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-19
- 收录于：2026-10-19
- 原始资源：<https://github.com/PrimeDecomp/prime>
- 一手来源：<https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/primedecomp-metroid-prime-decomp-case/>
- 记录 JSON：<https://awesomerea.org/resources/primedecomp-metroid-prime-decomp-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/primedecomp-metroid-prime-decomp-case/index.md)

## 使用条件与局限

- **前提条件：**构建需要把使用者自备的所选版本光盘镜像放入对应的 orig/ 目录，格式可为 ISO（GCM）、RVZ、WIA、WBFS、CISO、NFS、GCZ 或 TGC，首次构建后即可删除。仓库不含游戏素材或汇编；decomp-toolkit 在本地拆分原始可执行文件及其内嵌数据。CONTRIBUTING 为贡献者列出的参考资料包括 Metaforce、一个共享 Ghidra 服务器，以及早期体验版光盘中附带的符号表。
- **前提条件：**在 Windows 上可直接用 Python 与 ninja 构建；macOS 需要 ninja 和 Wine Crossover；Linux 需要 ninja，在 x86 上会自动下载 wibo 包装器，其他架构则使用 Wine。configure.py 固定 decomp-toolkit v1.8.4、objdiff v3.8.2、binutils 2.42-1、sjiswrap v1.2.2、wibo 1.0.3，以及从 files.decomp.dev 下载的 20251118 编译器包；游戏代码用 CodeWarrior GC/1.3.2 编译，Wii 版本则用 Wii/1.0a。MusyX 音频库来自子模块。
- **范围：**所审阅的 main 分支固定版本日期为 2026 年 10 月 19 日，该提交将 objdiff 更新到 v3.8.2。README 将其描述为进行中的反编译，支持 GM8E01_00（美版 v1.088）、GM8E01_01（美版 v1.093）、GM8E01_48（韩版 v1.097）、GM8P01_00（PAL 版 v1.110）、GM8J01_00（日版 v1.111）和 GM8E01_02（美版 v1.111）；configure.py 与 CI 还涵盖 Multi-Game Demo Disc、一个日本体验版，以及 Wii 上的 New Play Control 版和三部曲合集。产物是原始的 main.dol，以及六个零售 GameCube 版本各自的 NES 模拟器 REL，而非移植；docs/metaforce.md 说明如何把 Metaforce 的代码改写为能一致编译的 C++98。
- **测试证据：**默认构建只对标为 Matching 的单元链接由源码编译的对象，其余单元使用从原文件提取的对象，再按该版本的 build.sha1 校验 main.dol 与 NES REL。decomp.dev 针对该固定提交的报告显示，GM8E01_00 有 93.89% 的代码（16,685 个函数中的 16,478 个）与 98.47% 的数据已匹配，829 个单元中 739 个已完成；其他美版与韩版的代码匹配率为 92.5%–93.83%，PAL 版为 84.37%，日版为 82.91%，体验版与 Wii 版仍处于早期。CI 在提供原始文件的容器中构建全部十一种配置。
- **许可：**仓库采用 CC0-1.0，不涵盖任天堂的游戏、光盘内容或下载的编译器；仓库内附带的 zlib 1.1.3 保留其自身许可，MusyX 则是独立仓库。

## 一手来源

1. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/README.md>
2. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/configure.py>
3. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/tools/download_tool.py>
4. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/config/GM8E01_00/config.yml>
5. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/config/GM8E01_00/build.sha1>
6. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/CONTRIBUTING.md>
7. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/docs/metaforce.md>
8. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/docs/nes-emulator.md>
9. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/.gitmodules>
10. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/.github/workflows/build.yml>
11. <https://github.com/PrimeDecomp/prime/blob/2fd31790998c0486744a6289cac7e2fecc22d143/LICENSE>
12. <https://decomp.dev/PrimeDecomp/prime>
13. <https://web.archive.org/web/20261020042005/https://decomp.dev/PrimeDecomp/prime/GM8E01_00/2fd31790998c0486744a6289cac7e2fecc22d143.json>
14. <https://web.archive.org/web/20261020042012/https://decomp.dev/PrimeDecomp/prime/GM8E01_01/2fd31790998c0486744a6289cac7e2fecc22d143.json>
15. <https://web.archive.org/web/20261020042019/https://decomp.dev/PrimeDecomp/prime/GM8E01_02/2fd31790998c0486744a6289cac7e2fecc22d143.json>
16. <https://web.archive.org/web/20261020042108/https://decomp.dev/PrimeDecomp/prime/GM8E01_48/2fd31790998c0486744a6289cac7e2fecc22d143.json>
17. <https://web.archive.org/web/20261020042116/https://decomp.dev/PrimeDecomp/prime/GM8P01_00/2fd31790998c0486744a6289cac7e2fecc22d143.json>
18. <https://web.archive.org/web/20261020042125/https://decomp.dev/PrimeDecomp/prime/GM8J01_00/2fd31790998c0486744a6289cac7e2fecc22d143.json>

## 同分区更多条目：游戏

- [MinecraftLCE：处于早期阶段的 Minecraft: Nintendo Switch Edition 反编译](https://awesomerea.org/zh/resources/minecraft-lce-switch-decomp-case/index.md) · 案例
- [《时之笛》：16 个版本均以 MD5 校验 ROM 构建的反编译](https://awesomerea.org/zh/resources/ocarina-of-time-decomp-case/index.md) · 案例
- [Paper Mario：覆盖四个版本的一致性 Nintendo 64 反编译](https://awesomerea.org/zh/resources/paper-mario-matching-decomp-case/index.md) · 案例
- [《纸片马力欧 RPG》：早期阶段的 GameCube 一致性反编译](https://awesomerea.org/zh/resources/paper-mario-ttyd-decomp-case/index.md) · 案例
- [Perfect Dark：生成一致 ROM 的 Nintendo 64 反编译重建](https://awesomerea.org/zh/resources/perfect-dark-matching-decomp-case/index.md) · 案例
- [Petari：Super Mario Galaxy 一致性反编译重建](https://awesomerea.org/zh/resources/petari-smg-decomp-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。