PPSSPW 源码阅读指南

玩家选择自己持有的游戏镜像后，网页需要先确认浏览器能力、配套核心和存档状态，才能把文件交给模拟器。本指南沿本地文件启动说明这条交接，帮助维护者区分页面能打开、核心能启动和游戏能流畅运行。

阅读路径

读者目标	从这里开始	读完后获得什么
理解一次真实运行	主流程与拒绝边界	能解释输入、交接和结果，知道失败在哪里出现
定位修改入口	按职责找代码	在已声明范围内找到入口、依赖和验证位置
审核解释依据	源码证据与两遍调查	区分直接证据、范围限制和未执行验证
复核文档质量	读者模拟与剩余风险	看懂本指南能回答什么，哪些问题仍需验证
查看同步边界	指南变更记录	找到源码锚点与本轮验证范围

覆盖范围

覆盖 Angular 到浏览器运行时的接线、栏目与触控交互、启动能力检查、本地文件挂载、打包与预览；只追踪这些入口。模拟器 CPU/GPU、FFmpeg、完整在线下载、联机、云同步和移动设备性能未覆盖；deps 仅追踪对话框确认、窗口尺寸与设置栏目相关入口，其余第三方实现不作逐层架构讲解。

本包采用 Lite 加代码地图：主流程先建立行为模型，地图用于定位，证据页用于审计。源码和脚本是实现事实的依据；旧文档或测试文件的存在不代表本轮实跑通过。

运行与验证入口

以下命令在仓库根运行；启动命令会占用开发端口，构建命令可能写业务产物，请先阅读根规则。

npm --prefix wasm-page ci
# 维护者验证命令，实际执行结果见指南变更记录
npm --prefix wasm-page test
python -m unittest discover -s server/player-tests -v
# 已有配套核心时的网页重建与预览，会替换业务输出
npm --prefix wasm-page run build:pages
python scripts/package-player.py
python server/serve-player.py

文档站的启动与构建命令见根 README 的文档入口。文档构建只验证说明页面，不证明业务可用或已部署。

既有专题

• 下载清单与断点恢复（仓库文件：docs/game-download.md）
• 性能采样及已知边界（仓库文件：docs/browser-performance.md）
• 上游来源与许可（仓库文件：UPSTREAM.md）

独立网页构建会把文档目录之外的仓库链接显示为精确文件路径，避免产生失效跳转；原始 Markdown 仍保留可核对的源码链接。站点只发布指南，源码和本机资源不会随文档打包。

证据状态：除特别标注外，本页基于当前源码已确认。