decomp.wtf:讓 AI 代理反編譯自己擁有的遊戲,並要求逐位元組一致

開源工具 decomp.wtf 讓代理把遊戲拆成函式逐一還原成 C,再用原始編譯器驗證結果是否與原版逐位元組相同。作者已將專案封存。

重點

  • 代理領取單一函式,寫出 C 程式碼,用遊戲原本的編譯器編譯後必須與原版 ROM 或光碟完全一致。
  • 建議用在 GameCube、Wii、Nintendo 64;PlayStation 等為 beta。
  • MIT 授權,支援 Claude Code、Codex CLI 等代理,不支援 macOS。
  • README 顯示作者已封存專案,最後版本 0.10.6,不再收修正。
目錄(3 節)
  1. 發生什麼事
  2. 背景
  3. 對你的影響

發生什麼事

GitHub 上出現名為 decomp.wtf(What The Function)的開源專案。它的做法是把一款遊戲切成一個個函式,辨識原本使用的編譯器,再讓 AI 代理逐一領取函式,依據組合語言、相關資料與呼叫者,寫出對應的 C 程式碼。

驗收標準很嚴格:每次嘗試都會用該遊戲原始的編譯器編譯,並與原版 ROM 或光碟比對,必須逐位元組相同才算成功,否則得零分。失敗時會回傳指令差異讓代理修正,成功的結果則被保存與共享。專案另有處理重複程式碼的自動比對、修正接近成功案例的 permuter,以及即時地圖檢視。

README 列出的建議平台是 GameCube、Wii、Nintendo 64(測試過 Super Mario 64、GoldenEye、Perfect Dark),PlayStation、PS2、GBA、NDS 為 beta。它也能接續 decomp.dev 上社群專案。

decomp.wtf 讓 AI 代理反編譯遊戲,並以位元組一致作為驗收標準

背景

專案採 MIT 授權,需要 Python 3.12 以上,可搭配 Claude Code、Codex CLI、opencode 或相容 OpenAI 的 API 金鑰。Linux 可用,Windows 需在 WSL 2 內執行,不支援 macOS。專案本身不含遊戲程式碼或 ROM,README 也要求只處理自己擁有的遊戲,且不要散布商業遊戲的反編譯結果。

值得注意的是,README 寫明作者已停止維護並封存 repo,目前唯讀。

對你的影響

對一般開發團隊影響不大。它的價值在於示範「用可自動驗證的條件(位元組一致)約束代理」的做法:驗收標準夠明確,代理就能自己反覆修正。若你想做類似的程式碼轉換或遷移工具,這個設計可以參考。