Files
NESLite/docs/reports/long-zhu-ying-xiong-0.9.17.md

79 lines
5.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 龙珠英雄黑屏定位与 0.9.17 修复
日期:2026-09-14。用户提供了项目根目录的 `龙珠英雄.nes`。本次在两个固定内核中复现 NTSC 启动
卡死,并加入按精确文件哈希选择 Dendy 的兼容规则;Android 调试 APK 已构建,手机端仍待复核。
对应计划 F15/XCORE-05,不作为 GCORE 或 G8 的完整放行证据。
## 文件与复现结果
| 项目 | 实际值 |
| --- | --- |
| 文件大小 | 262,160 字节,等于 16 字节头+256 KiB PRG |
| 完整文件 SHA-256 | `f2fa5c9e40dc68e25fc9d9a4d5f2d5c9179c393d16c0d4e76f843aa17a6df981` |
| PRG CRC32 | `20d4221c` |
| iNES 头 | `4e 45 53 1a 10 00 42 00 00 00 00 00 00 00 00 00` |
| 头部声明 | Mapper 4、256 KiB PRG、无 CHR-ROM、带电池,未正确表达此文件所需的 Dendy 制式 |
| 复现平台 | Windows x64、MinGW GCC 16.1.0;同一 libretro 环境选项默认值与输入脚本 |
| FCEUmm 提交 | `236ccdfc911e84c60fea6b9d0699c2d440a8de14` |
| Nestopia 提交 | `224713b257c8620513c1c9ca28dc7f8dea711e18` |
原始默认选项下,两个内核都成功返回加载完成,但持续输出单色画面。FCEUmm 的 600 帧检查仅有
2 次画面变化、非零音频样本计数为 0;Nestopia 为 4 次变化、非零音频计数为 1,并报告 CPU Jam。
临时 CPU 跟踪在 FCEUmm 第 23 帧观察到中断恢复后从错误的程序存储区取指,在 `$9020` 执行停止指令。
该复现在桌面直接取得核心视频回调,不经过 Android 或 GL,因而可以确认黑屏已经发生在游戏执行阶段。
针对启动时序分别检查 PAL 与 Dendy 后,Dendy 在两个内核均能显示中文启动画面并进入菜单;选择
Dendy 作为此文件的兼容制式。Dendy 是核心的 CPU/PPU 时序配置,不是修改手机刷新率;NES 2.0
对该制式有独立定义,见 [NESdev 时序字段](https://www.nesdev.org/wiki/NES_2.0#CPU/PPU_Timing)。
这里只声明已实测的文件,不按中文文件名、Mapper 4 或所有中文游戏泛化此修复。
原始复现日志:`.build/rom-probe/fceumm.log`、`nestopia.log`;临时跟踪记录为
`.build/rom-probe/fceumm-trace.txt`。跟踪只用于定位,最终检查工具和 APK 使用未修改的上游核心源码。
## 应用改动
- `rom_compatibility` 在宿主读入 ROM 后用实际字节计算 SHA-256;仅上述完整哈希命中
`long-zhu-ying-xiong-dendy-v1`,不依赖文件名或 UI 传入的身份字符串。
- 环境回调注册选项时,FCEUmm 使用 `fceumm_region=Dendy`,Nestopia 使用
`nestopia_force_system=dendy`。其余选项、其他 ROM 和两个内核提交保持原值。
- 状态诊断包含 `compatibilityProfile`;卸载时重置,下一款游戏不会继承该规则。
- 原 ROM 字节及其哈希、游戏索引和电池存档位置保留。实际制式进入现有即时存档配置元数据,因此
旧 NTSC 即时存档按原兼容检查拒绝加载且保留文件;本次没有自动删除、改写或迁移用户进度。
- 新增可选 `tools/rom-probe/` 检查工具,明确传入单份本地 ROM 才运行;本地游戏样本加入 Git 忽略,
不进入 APK 或应用源码发布包。
## 局部验证
| 检查 | 结果与边界 |
| --- | --- |
| 兼容规则单测 | `neslite_rom_compatibility_test` 通过;覆盖精确哈希、不同/缺失哈希、两个内核的键名和值、其他选项不受影响 |
| FCEUmm+生产兼容规则 | 1800 帧,约 36 模拟秒;50.007 FPS、91 次画面变化、非零音频计数 1,454,099;一次核心状态往返通过 |
| Nestopia+生产兼容规则 | 1800 帧,约 36 模拟秒;50.007 FPS、92 次画面变化、非零音频计数 1,474,223;一次核心状态往返通过 |
| 画面检查 | 两个内核均看到中文启动、剧情选择和代码输入菜单;固定 Start/A 脚本会改变菜单状态,不再持续黑屏 |
| Android 构建/版本 | `assembleDebug` 通过;BuildIdentityTest 1 项通过,版本 `0.9.17-debug`/9017 |
| 最终 APK 静态原生检查 | 全部 3 个 arm64 库 LOAD 段和 APK 的 16 KB 对齐通过;没有新增共享库依赖 |
| 原文件保护 | 修复后再次计算用户原文件 SHA-256,与输入一致 |
核心状态往返是在 1800 帧后序列化、运行 30 帧、恢复并再运行相同 30 帧,比较画面哈希;每个内核
只做一次,不等同于 Android 存档文件、100 次循环、听感或完整玩法验收。两次 30 帧不计入上表的
1800 帧启动统计。尚未验证 Android 上本次自动规则、完整战斗/通关及长期运行。
验证日志:`.build/rom-probe/verified-fceumm.log`、`verified-nestopia.log`、
`android-build-0.9.17.log`、`android-native-0.9.17.json`;抽样画面为同目录的
`verified-fceumm-179.png`、`verified-fceumm-599.png`、`verified-nestopia-599.png` 等。
复跑单 ROM 检查见 [工具说明](../../tools/rom-probe/README.md);规则单测可用 CTest 精确选择
`^neslite_rom_compatibility_test$`。没有运行 Stage 全量、全库 ROM 遍历、长稳或重复的历史专项。
## 交付与手机复核
版本:`0.9.17-debug`,`versionCode 9017`,ID `org.neslite.app.debug`,arm64-v8a。
源码基于 `e3842c21dcd4c00f34a740da86947c93b5b93afb` 及当前工作区改动,未创建新的 Git 提交。
APK 为 `app/build/outputs/apk/debug/app-debug.apk`,另提供同字节的版本化副本
`.build/releases/NESLite-0.9.17-debug-arm64-v8a.apk`,大小 24,176,631 字节。
SHA-256:`3A08617A13F0EBBD058F3F93AA12F6CB5E65FEC8865124771E9960EA020A8540`。
安装新版后从游戏列表重新打开原有“龙珠英雄”即可命中规则,无需重新导入或改名。FCEUmm 和 Nestopia
均有对应设置;若用户正在旧版会话中,需重新打开游戏。ADB 当前未发现已授权手机,手机加载、输入、
声音和完整玩法需继续按 XCORE-04/05 复核;若仍失败,诊断中的应用版本、内核、ROM 哈希及
`compatibilityProfile` 可用于确认是否实际运行了本次修复。