ran-j/PS2Recomp：README に基づく導入ガイド

ran-j/PS2Recomp の README はプロジェクトを「Playstation 2 Static Recompiler & Runtime Tool to make native PC ports」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「PS2Recomp: PlayStation 2 Static Recompiler (Experimental)」には次の説明があります。This project statically recompiles PS2 ELF binaries into C++ and provides a runtime to execute the generated code.。これは範囲の説明であり、本番検証の結果ではありません。

README の「Modules」にある内容から、用途が合うかを先に判断できます。ps2xRecomp: reads TOML + ELF, decodes R5900 instructions, and generates C++ output.。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。ps2xAnalyzer: scans ELF/functions and writes TOML config (stubs, skip, instruction patches).。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「Usage」など複数の箇所に分かれています。確認できる情報は次の通りです。Preferred workflow for retail or stripped games:。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 git clone --recurse-submodules https://github.com/ran-j/PS2Recomp.git cd PS2Recomp cmake -S . -B out/build cmake --build out/build --config Debug 実行可能なコマンドがない場合は手順を作らず、「Modules」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「Usage」には1. Open the ELF in Ghidra. 2. Run ps2xRecomp/tools/ghidra/ExportPS2Functions.java. 3. Use the exported TOML and CSV map. 4. Recompile with the exported TOML:とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料にはps2xRuntime: hosts memory, function registration, syscall dispatch, and hardware stubs.ともあります。

制約も確認が必要です。現在の資料からは、ran-j/PS2Recomp の互換表、性能基準、サービス保証、長期サポートを確認できません。README の記載は「Fallback workflow for quick local experiments or ELFs with debug symbol :」です。不明点は採用記録の検証項目として残し、断定に変えないでください。