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

5.9 KiB
Raw Blame History

龙珠英雄黑屏定位与 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 时序字段。 这里只声明已实测的文件,不按中文文件名、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 检查见 工具说明;规则单测可用 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 可用于确认是否实际运行了本次修复。