79 lines
5.9 KiB
Markdown
79 lines
5.9 KiB
Markdown
# 龙珠英雄黑屏定位与 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` 可用于确认是否实际运行了本次修复。
|