Project Sylpheed Recomp

使用 ReXGlue v0.10.0 将 Project Sylpheed 的 Xbox 360 开发版静态重编译为 Windows 程序。

本项目由人类维护者与 AI 辅助完成，属于个人研究和实验性重编译项目，不代表原作者、发行商或 ReXGlue 官方。生成代码、宿主适配和运行验证都可能存在错误；当前版本不保证完整流程、所有资源、所有硬件或所有场景正常工作。使用前请保留原始游戏文件和存档备份，遇到黑屏、崩溃或缺少资源时以日志和对应版本资源为准。

目前已验证 Windows x64 Debug/Release 构建、调试菜单和键盘/手柄菜单操作。教程已有飞船与太空的 3D 场景，视频画面和声音已恢复，默认不跳过。视频流畅度与结束、完整任务、飞行操作和存档仍需验证。零售版主程序不在当前支持范围内。

构建

需要 Clang、MSVC 工具集、Windows SDK、CMake、Ninja 和完整 ReXGlue v0.10.0 开发 SDK。

仓库 assets/ 包含当前开发镜像及完整 MAP/PDB，generated/ 包含对应生成源码。运行仍需完整游戏资源。文件与匹配信息见 输入文件说明。

在仓库目录执行：

python scripts/verify_game_inputs.py --image-only
./scripts/Codegen.ps1 -ReXGlue "<完整 SDK 目录>/bin/rexglue.exe"
./scripts/Build.ps1 -SdkRoot "<完整 SDK 目录>"

构建结果为 out/build/win-amd64-debug/project_sylpheed.exe。安装和工具链配置见 Windows 构建说明。

运行

双击构建出的 EXE，在同目录 project_sylpheed.toml 中设置 game_data_root，指向含匹配开发镜像、config.ini 和 dat/ 的资源目录。默认窗口为 1280×720；键盘和手柄都能操作菜单，按键可在 TOML 自定义。

配置模板在 config/project_sylpheed.example.toml。详细配置和诊断启动见 运行说明。

Windows 顶部“工具”菜单提供统一的可折叠运行信息面板和资源目录选择；目录更改重启生效。使用与指标含义见 性能显示。

宿主音频队列保留 SDK 的解码与混音，可在 TOML 切回原后端；诊断开关和验证见 音频输出。

开发

• 代码结构：生成代码、宿主适配和补丁的边界。
• 开发版与正式版比较：独立生成与构建、调试模块差异、双版本接入方案；正式版运行仍有阻塞。
• 函数命名与符号索引：已有 62 个入口恢复可读名字，按地址或名字定位函数。
• 贡献说明：验证和提交要求。
• 语言与输入、Fiber 修复、生成边界修复：现有适配依据与限制。

generated/ 由 ReXGlue 重建并跟踪，不直接编辑。完整资源包、构建产物和本机配置不纳入 Git。

当前限制

• 当前主线只针对开发/调试版镜像；零售版和试玩版只作有限参考，不保证可以直接游玩。
• 运行必须使用与生成代码匹配的开发版 XEX、MAP/PDB 和资源包；不同版本的 files.tbl、PAK 或 XEX 不能仅凭文件名混用。
• 这是实验性工程，不提供无条件的可用性、性能、存档或兼容性保证。问题报告请附上同目录的 <程序名>.log 和资源版本信息。

项目原创代码使用 BSD-3-Clause；第三方声明见 THIRD-PARTY-NOTICES.txt。