{ "added_at": "2026-10-18", "additional_evidence_urls": [ "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/LEGAL.md", "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/PROVENANCE.md", "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/docs/PROGRESS.md", "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/tools/check.py", "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/CONTRIBUTING.md", "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/.github/workflows/python-tests.yml", "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/.github/workflows/decomp-dev.yml", "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/LICENSE" ], "category": "reconstruction-cases", "description_en": "A work-in-progress matching decompilation of Halo 2 for the original Xbox: contributors write C and C++ that the period compiler, building the whole program with link-time code generation, must turn back into the retail executable's bytes function by function. The README reports just under half of the game-function bytes matched and leaves a native port for a later stage. It discloses that much of the maintainer's work runs in Claude and Codex coding-agent lanes.", "description_zh": "Halo 2（初代 Xbox）的进行中一致性反编译：贡献者编写 C 与 C++ 代码，由原时代编译器以链接时代码生成方式构建整个程序，须逐函数还原出零售版可执行文件的字节。README 报告游戏函数字节的匹配比例接近一半，原生移植留待后续阶段。项目披露维护者的大量工作在 Claude 与 Codex 编程智能体流水线中进行。", "entry_url": "https://awesomerea.org/resources/halo2-matching-decomp-case/", "entry_url_zh": "https://awesomerea.org/zh/resources/halo2-matching-decomp-case/", "evidence_url": "https://github.com/kirklandsig/halo2-decompiled/blob/e25e96f9236a74b15ab0f0acaa7af53918ca1233/README.md", "group": "cases", "id": "halo2-matching-decomp-case", "json_url": "https://awesomerea.org/resources/halo2-matching-decomp-case/record.json", "kind": "case-study", "markdown_url": "https://awesomerea.org/resources/halo2-matching-decomp-case/index.md", "markdown_url_zh": "https://awesomerea.org/zh/resources/halo2-matching-decomp-case/index.md", "name": "Halo 2: an agent-assisted matching decompilation of an LTCG Xbox build", "name_zh": "Halo 2：智能体辅助的 LTCG Xbox 版一致性反编译", "reconstruction_method": "matching-decompilation", "record_type": "resource", "relationship": "independent-reconstruction", "requirement_facets": [ "scope", "prerequisites", "testing", "attribution", "license" ], "requirements": [ "README targets the retail disc build's default.xbe (internal name halo2ship.exe, linked 2004-09-28, XDK 5849, Visual C++ 7.1 with /LTCG), identified by SHA-256. At the reviewed commit it reports 9,115 of 11,321 game functions matched (46.90% of game-function bytes; 35.59% of all in-scope bytes). Decompilation and readability work are in progress and a native port is a later stage, so the project produces no playable or ported build.", "Supply the retail default.xbe from a copy you are entitled to use, and the XDK 5849 development toolchain, yourself; neither is provided, and the maintainers will not help obtain the SDK. README says byte-for-byte checking currently depends on that original compiler, which no open-source toolchain can yet reproduce; analysis and documentation need neither. The repository holds no game assets, disc images or leaked material.", "The tools are Python (requirements-dev.txt, with capstone for the checker). tools/build.py builds the whole game as one LTCG image with each source file's flags; tools/check.py compares every marked function with the retail bytes apart from relocated address fields, writes matched/near/todo status to config/functions.csv and exits nonzero while any function differs. Public CI runs the Python tests, whose retail and SDK tests skip without those local inputs, and exports the decomp.dev report from the committed CSV.", "Match counts come from the project's checker; tools/masked.py lists differences the address masking can hide, such as nearby float constants and strings. PROVENANCE.md reports that earlier names drew on sources its policy forbids (third-party names derived from unreleased 2003 linker maps, and an internal 2007 debug build); those were removed or renamed with match status unchanged, while the derivation of names that follow the Halo CE decompilation is still under review.", "Contributors' own work is CC0 1.0; LEGAL.md states this places no Halo 2 code, content or trademarks in the public domain, and the project is unaffiliated with Microsoft, Bungie or 343 Industries. README says much of the maintainer's decompilation runs in automated lanes driven by Claude and Codex, with each batch reviewed and checked before it lands, and it offers contributors a prompt for AI coding agents." ], "requirements_zh": [ "README 的目标是零售光盘版的 default.xbe（内部名称 halo2ship.exe，链接于 2004-09-28，XDK 5849，Visual C++ 7.1 搭配 /LTCG），以 SHA-256 标识。所审提交报告 11,321 个游戏函数中已有 9,115 个匹配（占游戏函数字节的 46.90%，占全部范围内字节的 35.59%）。反编译与可读性整理仍在进行，原生移植属于后续阶段，因此项目尚不产出可游玩或已移植的构建。", "需从有权使用的副本中自备零售版 default.xbe，并自行准备 XDK 5849 开发工具链；项目均不提供，维护者也不协助获取 SDK。README 说明逐字节检查目前依赖该原版编译器，尚无开源工具链能复现其输出；分析和文档工作则两者都不需要。仓库不含游戏素材、光盘镜像或泄露材料。", "工具以 Python 编写（requirements-dev.txt，检查器需 capstone）。tools/build.py 按各源文件的编译选项把整个游戏构建为一个 LTCG 映像；tools/check.py 将每个已标注函数与零售版字节比较（重定位地址字段除外），把 matched／near／todo 状态写入 config/functions.csv，只要仍有函数不同便以非零状态退出。公开 CI 运行 Python 测试（缺少本地零售版与 SDK 输入时相关测试会跳过），并从已提交的 CSV 导出 decomp.dev 报告。", "匹配数来自项目自身的检查器；tools/masked.py 列出地址屏蔽可能掩盖的差异，例如相近的浮点常量和字符串。PROVENANCE.md 报告，早期命名曾借助其政策禁止的来源（源自未公开 2003 年链接映射的第三方命名，以及一份内部 2007 年调试版本）；这些名称已删除或改名，函数匹配状态不变，而部分沿用 Halo CE 反编译的命名，其来源仍在审查中。", "贡献者自身的工作采用 CC0 1.0；LEGAL.md 说明此举不会使 Halo 2 的代码、内容或商标进入公有领域，项目也与 Microsoft、Bungie 或 343 Industries 无关。README 称维护者的大量反编译工作在由 Claude 和 Codex 驱动的自动化流水线中进行，每批改动合入前都经审查与检查，并为贡献者提供可交给 AI 编程智能体的提示词。" ], "targets": [ "game" ], "url": "https://github.com/kirklandsig/halo2-decompiled", "verification": "source-reviewed", "verified_at": "2026-10-18" }