Krilliac/OmegaStrain-Reimplementation

# Syphon Filter: The Omega Strain 重新实现研究 此工作区是 *Syphon Filter: The Omega Strain* (NTSC-U, `SCUS-97264`) 原生重新实现的净室研究起点。使用 PCSX2 作为行为预言机和调试器；这并不意味着它将成为最终原生 runtime 的依赖项。发布版 runtime 是纯粹的现代 CPU 原生代码：不包含 MIPS 解释器、重新编译器、转换后的零售指令块或 PS2 执行层。 ## 当前验证的基线 - 官方 PCSX2 `master` 分支，构建自 commit `86d76bbf590566d9ea74d381eeff3acd9856503a`。 - 构建产物：`third_party/pcsx2/bin/pcsx2-qtx64-avx2.exe` (PCSX2 2.7.485)。 - 官方 Windows 依赖包 SHA-256： `9C02B2CF15DA632B7D862131486B6CD8D7C58979D5F8C345F0BA4E0E2AEC3FD1`。 - 自有的 NTSC-U 光盘镜像 SHA-256： `A60A4B41FEA808335BAA3B887A377BB98063F6F169CA498EFEE49397FBA96130`。 - 启动验证使用 USA BIOS v1.60，序列号 `SCUS-97264`，CRC `D5605611`，ELF 入口点 `0x00100008` 以及 D3D12 渲染。 - 光盘解压在已忽略的 `private/extracted-disc/` 目录树中。 - 所有 273 个顶层 HOG 归档均通过文档化的目录布局验证：包含 32,351 个条目，且无结构性错误。 ## 快速开始 ``` powershell -NoProfile -File .\scripts\launch-omega.ps1 ``` 打开 PCSX2 调试器并在游戏入口点中断： ``` powershell -NoProfile -File .\scripts\launch-omega.ps1 -Debugger ``` 加载已恢复的 resume state： ``` powershell -NoProfile -File .\scripts\launch-omega.ps1 -Resume ``` 打印确切的命令，而不启动另一个模拟器实例： ``` powershell -NoProfile -File .\scripts\launch-omega.ps1 -Debugger -DryRun ``` 静态分析证实 `-lMINSK` 是有效的附加参数语法，并会选择 MINSK 条目。`-x` 对用户的意义及其引发的游戏状态尚未得到验证；启动器可以在私有参考环境中明确测试这对参数： ``` powershell -NoProfile -File .\scripts\launch-omega.ps1 -Debugger -GameArgs '-x -lMINSK' ``` ## 原生 runtime 构建 第一个原生切片是一个无依赖的 C++23 HOG 读取器和语料库验证器。在 VS2022 开发者环境中进行配置，然后使用已提交的多配置预设： ``` cmake --preset msvc cmake --build --preset msvc-debug ctest --preset msvc-debug .\build\msvc\Debug\omega_tool.exe hog-verify-tree .\private\extracted-disc .\build\msvc\Debug\openomega.exe --frames=120 ``` `openomega` 是纯原生的 SDL3/SDL_GPU 宿主外壳。`--frames=N` 是一种自动化冒烟测试模式，它会打开现代 GPU backend，渲染恰好 `N` 帧，并在无需用户输入的情况下退出。 架构和完成标准版本记录在 [`docs/02-Runtime-Architecture.md`](docs/02-Runtime-Architecture.md) 和 [`docs/03-Milestones.md`](docs/03-Milestones.md) 中。研究置信度记录在 `analysis/evidence/ledger.jsonl` 中。 ## 目录结构 - `docs/` — 交接和研究笔记。 - `tools/` — 确定性的光盘/ELF 考古工具。 - `analysis/` — 生成的、可再分发的元数据和报告。 - `analysis/formats/HOG.md` — 已验证的 HOG 容器布局和提取笔记。 - `analysis/elf/loader-hints.md` — 已确认的可执行文件证据和未解决的加载器问题。 - `third_party/pcsx2/` — 已忽略的官方 PCSX2 检出和构建。 - `runtime/` — 已忽略的隔离 PCSX2 数据/配置和日志。 - `private/` — 已忽略的自有 BIOS、光盘镜像、提取的资产和 save state。 ## 法律边界 本仓库绝不能包含 Sony 固件、游戏 ISO、提取的专有资产、save state 或密钥。贡献者必须提供自己合法 dump 的 PS2 BIOS 和零售光盘。版本控制中只能包含原始源代码、工具、文档、哈希值、元数据和独立创建的兼容性数据。 这是一个非官方项目，不隶属于 Sony Interactive Entertainment 或 Bend Studio。请参阅 [`TRADEMARKS.md`](TRADEMARKS.md) 和 [`CONTRIBUTING.md`](CONTRIBUTING.md)。 原始项目代码和文档采用 Apache-2.0 许可。该许可不授予任何零售游戏、固件、资产或第三方商标的权利。 请参阅 [`docs/04-Legal-and-Takedown-Readiness.md`](docs/04-Legal-and-Takedown-Readiness.md) 了解项目的预防性控制和响应流程。 官方参考：[PCSX2 源码](https://github.com/PCSX2/pcsx2)、[BIOS dumping](https://pcsx2.net/docs/setup/bios/) 和 [disc dumping](https://pcsx2.net/docs/setup/discs/)。

标签：AI合规, Bash脚本, C++, PS2模拟器, 云安全监控, 云资产清单, 数据擦除, 游戏引擎重制, 逆向工程, 静态分析