ONScripter PSP
面向 PSP 的 ONScripter 开发项目，目标是支持原生 480×272 显示和 480×270（270p） 游戏。最初的源码快照来自美少女万华镜2.5移植项目。本仓库包含引擎、对依赖库的本地修改及回归测试，不包含游戏本体，也不包含剧本、美术、音频、字体、存档或 ISO。
项目状态与参与贡献
目前是早期开发快照，还不是可直接用于任意游戏的通用引擎。 引擎从 ;$V4000G1500S480,272 或 ;$V4000G1500S480,270 等脚本头读取脚本原生尺寸。480×270 脚本头解析已有主机端回归测试，但其在 PSP 实机上的显示位置和渲染效果仍需专项验证。
本项目在开发、调试、测试和文档编写中使用生成式人工智能（GenAI）。生成的代码可能存在错误。欢迎任何人通过 Issue、代码审查、修复、测试、文档和 Pull Request 改进项目。反馈时请提供可复现的步骤，并区分 PSP 实机与模拟器上的结果。
主要改动
- 原生 480×272 脚本布局和 CP936 文本支持。
- PSP PMF 播放与 GPU 集成、语音缓冲区生命周期改进及背景缓存。
- 可配置游戏标识的 PSP 存档集成、对话控制和诊断日志。
- 光盘启动目录为
disc0:/PSP_GAME/USRDIR；光盘模式的诊断日志写入ms0:/PSP/<GAME_ID>_ISO.log。
源码保留了经过实机测试的构建中的诊断功能。用户反馈，在 PSP03g、6.20 PRO-C2 / Inferno 环境中，启动、同次运行内读档和重启游戏后读档均正常。这不代表所有 PSP 型号均已验证，也不代表完成了实机全流程测试。构建会申请扩展内存，目前不支持 PSP-1000。
构建
需要 PSPSDK、PSP SDL 1.2 及其图像、混音和字体依赖。已验证的构建环境为以下固定版本的 PSPDEV 容器。在 Linux shell 中进入仓库目录后执行；也可使用 WSL，并将仓库放在其可访问的挂载盘上：
docker run --rm -v "$PWD:/src" -w /src \
pspdev/pspdev@sha256:b22811072ea0721d7f6c666a5a279b6def2b0cd95892b819d9570f8ffc4452c0 \
sh -c 'make -f Makefile.PSP -j4'输出为 EBOOT.PBP 和 onscripter.elf。PBP 仅含基本开发用元数据，不含游戏美术。请自行提供合法取得且兼容的游戏数据；本仓库本身不能重新生成已发行的游戏 ISO。Makefile 会从源码构建随仓库提供的依赖库修改版本。
构建完成后，运行 python -m unittest discover -s tests。测试需要 Python 3；需要编译的主机端测试程序还依赖各自指定的主机编译器，部分测试使用 Windows Visual Studio 2022 Community。CP936 测试输入由程序生成，并非从游戏中复制；依赖私有工作区的导入修正测试未纳入仓库。实机测试与此测试集相互独立。
光盘打包方面，已验收的游戏使用了 genisoimage -xa -iso-level 3 -allow-lowercase -allow-multidot -omit-version-number。非 XA 镜像曾在测试用 PSP 上导致部分文件无法打开。由引擎直接打开的视频及支持文件应保留在 NSA 归档之外。
