feat: prepare M8 release candidate

This commit is contained in:
2026-09-12 15:11:53 +08:00
parent 08b8f9671e
commit 01149be202
25 changed files with 938 additions and 16 deletions
+12 -1
View File
@@ -1,4 +1,4 @@
# NESLite 架构(M7 基线)
# NESLite 架构(0.9.4 RC 基线)
## 边界与线程
@@ -117,3 +117,14 @@ AndroidX 返回分发先把当前页面和会话状态归一成单一决策:
重复进入,用户仍可从列表明确手动重试。系统事件以最多 3 个、每个 256 KiB 的 JSONL 文件轮换。
诊断导出列出应用/设备、输入、可用显示模式及两秒运行样本、帧与音频、存档边界和原生错误,只记录
ROM 哈希,不包含 ROM 字节或文件路径。
## M8 候选可观测性与升级边界
基础输入掩码在 JNI 收到实际变化时记录原生 `steady_clock` 时间,单内核线程在下一次有效帧采样前
计算延迟。固定窗口保留最近 2048 个样本并只导出数量、平均、P95 和最大值,既不在音频回调中工作,
也不保存按键序列。该指标的时间域明确为 JNI 入口到首次核心采样,不宣称是物理按键到屏幕总延迟。
Room v1 和 v2 架构随源码保存,v1→v2 迁移继续显式添加收藏、隐藏和最近游玩字段且默认值为零;Android
迁移测试在设备上验证旧中文名称及行数据保留。release 构建保存 FULL 原生符号但不启用混淆。RC 打包
只接受干净提交,产出未签名 release APK、逐库 16 KB 静态审计、应用/固定第三方源码归档、许可证、
候选清单和校验和;签名、双页大小环境、API 28 与覆盖升级仍是独立实机门槛。
+26 -1
View File
@@ -1,6 +1,6 @@
# NESLite 可复现构建说明
本说明对应 M0~M6 基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
本说明对应 0.9.4 RC 基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
FCEUmm 或 Oboe 文件。
## 前置条件
@@ -40,6 +40,31 @@ pwsh -NoProfile -File .\tools\check.ps1 -Scope Build
`Stage` 是本地阶段入口,不是 G1~G9 的替代。实机、ROM、存档、插拔和耐久验收必须在
相应里程碑按 [acceptance.md](acceptance.md) 执行和记录。
## 构建候选交付材料
先提交所有候选源码并保持工作区干净,然后执行:
```powershell
pwsh -NoProfile -ExecutionPolicy Bypass -File .\tools\package-rc.ps1
```
脚本重跑 Stage 和 release lint,生成 `org.neslite.app` 的未签名 release APK、完整原生符号、应用及
三个固定第三方依赖的源码包、许可证/说明、静态原生审计、候选清单和 SHA-256。输出位于
`.build/rc-0.9.4/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非
arm64-v8a 库。
默认 APK 刻意保持未签名;发布私钥和口令不得传入仓库或写入脚本。获得受保护的发布密钥后,在隔离
环境签名并重新执行对齐/签名/设备检查。未签名包不能用于安装、覆盖升级或 G8 运行验收。
冻结的 12 个 CC0 最小 ROM 冒烟样本可用下列命令在忽略目录重建:
```powershell
pwsh -NoProfile -ExecutionPolicy Bypass -File .\tools\generate-rc-roms.ps1
```
它们不包含游戏素材,也不能替代音画、滚屏、电池进度和长稳所需的合法代表游戏样本。设备长稳采集
入口为 `tools/collect-h-long.ps1`;默认 120 分钟、60 秒一次,只负责采集,不自动批准内存趋势。
## M1 诊断版安装
连接并授权一台目标手机后执行:
+1 -1
View File
@@ -6,7 +6,7 @@
| --- | --- |
| 显示名称 | `NESLite` |
| 正式 application ID/namespace | `org.neslite.app` |
| 当前开发版本 | `0.7.4`,`versionCode = 7004` |
| 当前候选版本 | `0.9.4`,`versionCode = 9004` |
| 调试 application ID | `org.neslite.app.debug` |
| 发布 ABI | `arm64-v8a` |
| min/target SDK | 28/36 |
+15
View File
@@ -0,0 +1,15 @@
# 已知问题与候选版限制
本清单对应 0.9.4 RC 源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有
明确接受或修复结论。
| 编号 | 优先级 | 状态 | 问题与处理条件 |
| --- | --- | --- | --- |
| RC-B01 | 阻断 | 开放 | 未连接目标 MagicOS 10 手机,G1~G7 的实机门槛及 G8 关键路径均无有效证据。 |
| RC-B02 | 阻断 | 开放 | 尚无满足动作/滚屏、声音和可观察电池进度要求的合法游戏样本;冻结的 12 个 CC0 最小样本只能用于加载冒烟。 |
| RC-B03 | 阻断 | 开放 | H-LONG、H-INPUT、4 KB/16 KB 运行、API 28 冒烟及 H-UPGRADE 尚未在设备执行。 |
| RC-B04 | 阻断 | 开放 | 尚未提供受保护的发布签名密钥及同 ID/同签名旧版数据集;当前 RC 静态审计包为未签名 APK。 |
| RC-M01 | 中 | 开放 | Release lint 有 55 个非阻断警告,主要是动态界面文本国际化、依赖版本提示和 Android 16 固定横屏兼容提醒;无 lint 错误。 |
不得通过删除失败 ROM、缩短规定轮数/时长、用 x86_64 替代 arm64,或用桌面原生测试替代 Android
实机运行来关闭阻断项。每项关闭时应在 M8 报告登记设备、包哈希、ROM 哈希、命令、原始日志和结论。
+25
View File
@@ -0,0 +1,25 @@
# M8 冻结兼容样本集
冻结规则:下列 12 个样本由 `tools/generate-rc-roms.ps1` 确定性生成,均为本项目原创的最小循环程序,
以 CC0-1.0 提供,不包含第三方游戏代码、图形或音频。验收期间不得删除失败样本;生成器、规格或哈希
发生变化即建立新一版样本集并说明原因。本表只冻结 ROM 身份,不把尚未执行的结果写成通过。
| 代号 | SHA-256 | 区域 | Mapper | 头 | 电池标志 |
| --- | --- | --- | ---: | --- | --- |
| RC01 | `FF989B8059D97193F76957D525CE980CCA63400871B866D31800656CA4882308` | NTSC | 0 | iNES | 否 |
| RC02 | `404550B9A6D016489C745BDA4DC40C44167E6D1E8D5B7AF0F1B4805D616D21CD` | PAL | 0 | NES 2.0 | 否 |
| RC03 | `34B58A0BDE66ED4061069BEF7589A13D1CD18CB8B0E7421B4EF77459A5F71DA5` | NTSC | 1 | iNES | 是 |
| RC04 | `27BFABD42A20AE2C7E4C37AC2942E1425CFAEA7A25223B3CD80AA2A2A4EC4254` | PAL | 1 | NES 2.0 | 是 |
| RC05 | `2FCA7D87F1B4C8FAFCFAD50AA7696F6CA0A27249C638383BF835386F366F2763` | NTSC | 2 | iNES | 否 |
| RC06 | `918E9DAD6567EBEECA076BF5685C93BCD96444D0DCCD702165F8F0E0BA4412C7` | PAL | 2 | NES 2.0 | 否 |
| RC07 | `6DD922B8777A2AAFFA9A5178467D5D764CE2B4F929F1FFE4423D5189EB50B266` | NTSC | 3 | iNES | 否 |
| RC08 | `36D5C72495E3ED7568929C348695D365F1EB14C76AD92CDFAC48C6325BE87D64` | PAL | 3 | NES 2.0 | 否 |
| RC09 | `00FC0A41DD14F095475F3D0EDA8B7B9B851C73D7C8F21D3EA4BECDBF610D27BF` | NTSC | 4 | iNES | 是 |
| RC10 | `3B27032AABC0D027F00DAE1688D0A7E0B43B4110D62EC8226BD4BDCE00FFD2BA` | PAL | 4 | NES 2.0 | 是 |
| RC11 | `19B69240BF8E1D96D2EB049EC89FE4F9BE2365216547ABDB7948FBB61819CB6C` | NTSC | 0 | NES 2.0 | 是 |
| RC12 | `60F486E91CC3A21A866B82A044200E871297EEEA50CC78FB9ADC2D0581A91062` | NTSC | 4 | NES 2.0 | 否 |
这些样本覆盖计划指定的 Mapper 0/1/2/3/4、NTSC/PAL、iNES/NES 2.0 和电池标志,可用于导入、
头解析、核心加载、暂停与退出的确定性冒烟。它们没有交互画面、滚屏、有效音频或可观察的电池进度,
因此不能替代 H-AV、H-LONG、H-INPUT、H-SAVE 或产品关键路径所需的合法代表游戏样本。相关缺口在
`m8-release-candidate.md` 中保留为阻断项。
+72
View File
@@ -0,0 +1,72 @@
# M8 0.9.4 发布候选记录
日期:2026-09-12
候选范围冻结为 M7 已实现功能加 M8 验收/交付能力,不再新增产品功能。源码冻结点为包含本报告的
M8 提交;`tools/package-rc.ps1` 只接受干净工作区,并把实际提交写入 `candidate-manifest.json`。
## 冻结身份与配置
| 项目 | 冻结值 |
| --- | --- |
| applicationId | `org.neslite.app` |
| RC 版本 | `0.9.4`,versionCode 9004,arm64-v8a,min/target SDK 28/36 |
| FCEUmm | `236ccdfc911e84c60fea6b9d0699c2d440a8de14`,静态链接 |
| libretro header | `0c9622896333ee62dc4326bbe8784a210ddeb03c` |
| Oboe | 1.10.0 / `a81bb9f87d4105b84b682685d3bfbb5beca371d1`,静态链接 |
| 构建 | AGP 8.13.2、Gradle 8.13、Kotlin 2.3.0、JDK 17.0.17+10、NDK 28.2.13676358、CMake 3.22.1 |
| 显示/音频/存档 | M7 配置、48 kHz 请求与设备实际格式、M5 v1 存档封装;本阶段未改变核心提交和存档格式 |
| 兼容样本 | `m8-rc-rom-set.md` 中 12 个固定 CC0 样本;失败样本不得移除 |
## F01~F14 证据索引与重跑决定
| 需求 | 当前可引用证据 | RC 决定 |
| --- | --- | --- |
| F01 导入 | M2 报告及 JVM 解析/边界测试 | 用 12 个冻结样本执行 RC 导入;真机待跑 |
| F02 游戏库 | M2/M6 报告及 Room/JVM 测试 | 中文长名、收藏、隐藏、重关联关键路径待跑 |
| F03 游戏控制 | M2/M7 状态机及原生测试 | 加载、运行、暂停、继续、重置、退出待跑 |
| F04 显示 | M2/M6 视口与设置实现 | 实际画面、过滤、整数缩放和重建待跑 |
| F05 音频/时序 | M3/M7 实现与原生统计 | H-AV 从未取得,必须跑 NTSC/PAL |
| F06 手柄映射 | M1/M4 诊断和 JVM 映射测试 | X5 Lite 实测签名及全路径缺失,必须跑 |
| F07 输入细节 | M4 输入来源/连发测试 | H-HOT 从未取得,必须跑;存档菜单手柄路径待跑 |
| F08 快进 | M3/M4/M6 实现与时钟测试 | 真机倍率、静音及失焦取消待跑 |
| F09 游戏/状态存档 | M5 原生安全提交与格式测试 | H-SAVE 100 次及实机分支从未取得,必须跑 |
| F10 存档包/恢复 | M5 格式、校验和故障测试 | SAF、实际空间/中断及恢复路径待跑 |
| F11 生命周期 | M7 策略与竞态测试 | H-LIFE 从未取得,必须跑 |
| F12 虚拟按键 | M6 多来源 JVM 测试 | 纯触屏完整主链待跑 |
| F13 诊断 | M1/M7 有界导出与轮换测试 | 真机导出可读性及会话关联待跑 |
| F14 原生与交付 | M0 工具链锁、M8 静态审计与交付脚本 | 静态 16 KB 审计可本机完成;双页大小、API 28、签名升级待跑 |
现有报告没有任何满足 H-AV、H-HOT、H-SAVE、H-LIFE、H-LONG、H-INPUT、H-NATIVE 运行部分或
H-UPGRADE 完整口径的实机结果,因此本候选不复用这些项目为“通过”。M8 新增输入指标在 JNI 接收
变化掩码时以 C++ `steady_clock` 起点计时,在核心线程首次采样前结束;容量 2048,导出样本数、平均、
P95 和最大值。只有正常 Running 状态下累计至少 1000 次后,才能按一个实际模拟帧的阈值判定。
## 自动检查与静态原生审计
- `tools/check.ps1 -Scope Stage` 通过:arm64-v8a debug APK 构建成功,Windows 原生测试 1/1,JVM
37/37、0 失败。原生测试新增固定容量输入延迟窗口、平均、P95、最大值和重置验证。
- release APK、FULL 原生符号和 Android 迁移测试 APK 均构建成功;迁移测试只完成编译,因无设备没有
执行。release lint 为 0 错误、55 个非阻断警告,详情见 `docs/known-issues.md`。
- 静态审计清点出 `lib/arm64-v8a/libneslite_jni.so` 与 DataStore 的
`lib/arm64-v8a/libdatastore_shared_counter.so`,没有遗漏或非 arm64 ABI。Android Build Tools 36.1.0
的 `zipalign -P 16` 通过;NDK r28c 的 LLVM 19.0.1 检查两库全部 ELF LOAD 段,最小对齐均为
16,384 字节。FCEUmm 和 Oboe 静态链接在 `libneslite_jni.so` 中。
- 最终干净提交的 APK、符号、应用源码、三个第三方源码和材料哈希由 `tools/package-rc.ps1` 写入
`.build/rc-0.9.4/candidate-manifest.json` 与 `SHA256SUMS.txt`,避免在受提交元数据影响的报告中固定
预检产物哈希。
## 设备验收入口
- 12 个固定样本由 `tools/generate-rc-roms.ps1` 重建并逐哈希核对;它们只承担解析、加载、暂停和退出
冒烟。产品关键路径、H-AV 与 H-LONG 仍需具有动作/滚屏、声音和可观察电池进度的合法游戏样本。
- H-LONG 使用 `tools/collect-h-long.ps1`,两个不同代表样本各运行 120 分钟,每 60 秒保留一次原始
meminfo、CSV 和警告日志;脚本只把无崩溃/ANR的足时运行标为“待审内存趋势”,不能自动宣判通过。
- Room v1/v2 架构已随源码保存,Android 迁移测试验证中文名称和新增收藏/隐藏/最近字段;仍须在
同 ID/同签名覆盖安装中核对 ROM、DataStore、控制器档案和全部存档文件。
## 当前结论
M8 的自动采集、静态审计和交付基础设施已准备。由于没有连接 Android 设备、可观察玩法的合法样本、
发布密钥和旧版同签名数据集,M8-01b、M8-02a/b、M8-03b、M8-04a 及 G8 不能执行;M8-04b 的完整
候选交付也受签名和前置验收阻断。按照 `todo.md` 的阶段依赖与证据规则,M8 全部条目保持未勾选。