案例

Gran Turismo 4:借助智能体的 PS2 引擎匹配反编译

将 Gran Turismo 4(《GT 赛车 4》)的 PS2 引擎可执行文件(CORE.GT4,NTSC-U v1.01)按每个函数一个 C 或 C++ 源文件反编译,面向 Sony 的 ee-gcc 2.96,并用 newlib、Expat 等公开库自身的源码匹配其函数。README 称大部分匹配工作由驱动项目工具的 AI 智能体(Anthropic 的 Claude)完成,每个函数须通过编译器与判定器的比对才算完成,并报告 2026 年 10 月某次提交时 95.4% 的函数和 83.6% 的代码字节已匹配。本地完整构建将源码链接到原始地址,其余部分用反汇编补齐,再与使用者的可执行文件比较 SHA-1。

使用条件与局限

  • README 称这是只针对引擎可执行文件、仍在进行中的匹配反编译:游戏逻辑大多在 Adhoc 脚本中,由独立的 OpenAdhoc 项目重建;另一个独立项目 GT4 Native PC 移植被描述为尚不可玩。progress 分支针对提交 ba5d800(2026-10-19)的报告(decomp.dev 对所审提交显示相同数字)给出 30,962 个函数中 29,551 个、代码 83.55% 已匹配,82.08% 的代码由源码链接,2.13% 的数据由源码放置;202 个原本就是手写汇编的函数不计入。
  • 需自备 Gran Turismo 4(美版)v1.01 光盘镜像(SCUS-97328);orig/README.md 列出 SCUS_973.28、CORE.GT4 及其转换所得 ELF 的 SHA-1。仓库未提交任何游戏内容,因此 SHA-1 构建校验和进度报告只能在具备这些文件的机器上运行,CI 中无法运行。
  • 文档以 Linux 或 WSL(Ubuntu)为准,需要 Python 3.11 及以上和 rabbitizer。tools/setup_linux.sh 安装 MIPS binutils 和 32 位 libc,下载 decomp.me 的 ee-gcc 2.96 构建,克隆 decomp-permuter,并在虚拟环境中安装 splat;project.toml 还列出其他 decomp.me 编译器,其中 ee-gcc 2.9 用于约 270 个 Sony SDK 函数。
  • 当 tools/match.py(或智能体使用的 tools/swarm.py)输出 MATCH,且 tools/build.py 将每个函数链接到原始地址并比较已加载段的 SHA-1 时,函数才算匹配。CI 运行单元测试、“C 中不得夹带汇编”的策略检查和布局检查,并编译每个源文件,但没有游戏文件就无法链接或比较;匹配数字为作者报告,本合集未构建或运行任何内容。
  • 项目的工具、文档和源码采用 MIT 许可。THIRD_PARTY.md 列出按各自条款匹配的公开库(Expat、newlib、带例外条款的 GPL 下的 GNU libio 与 GCC 运行库、SGI STL 头文件、MT19937),可用 build.py --without 排除,并说明专有的 SCE-RT/Medius、Logitech 和 Sony SDK 代码仅作识别、未予复制。Gran Turismo 4 归 Sony Interactive Entertainment 所有。智能体说明位于 AGENTS.md、CLAUDE.md 和 .claude/;所审来源未确立 REA 的使用。

关于此条目

类型
案例
类别
独立重建案例
关联
独立重建项目
目标
游戏

来源复核于

说明已依据一手来源复核;这不代表已运行验证、经过安全审计或确认兼容。

报告条目过时 建议修正翻译

一手来源

  1. README.md GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  2. orig/README.md GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  3. THIRD_PARTY.md GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  4. project.toml GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  5. tools/setup_linux.sh GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  6. .github/workflows/check.yml GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  7. .github/workflows/progress.yml GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  8. AGENTS.md GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  9. PILOT.md GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  10. LICENSE GitHub · gustavocanepa/gt4-decomp · 修订 e35ec1d
  11. report.json GitHub · gustavocanepa/gt4-decomp · 修订 9bcdea3
  12. https://decomp.dev/gustavocanepa/gt4-decomp

同分区更多条目:游戏

游戏分区全部 231 项资源游戏案例(189)