Files
NESLite/docs/reports/m5-save-recovery.md
T

1.9 KiB
Raw Blame History

M5 可靠存档与恢复记录

日期:2026-09-12
构建目标:org.neslite.app.debug,0.5.4-debug,versionCode 5004,arm64-v8a

已实现

  • 同目录临时文件、持久化刷新、回读校验、有效 .bak、原子替换、单调版本拒绝旧任务;核心线程只 取得不可变快照,文件操作在独立线程完成并按 ROM/目标串行。
  • 电池内存按 SHA-256 检测变化,初始周期 10 个模拟秒;自动即时恢复点周期 60 个模拟秒且最多三份; 暂停和退出补充请求,失败不推进自动槽轮换。
  • 十个手动槽和三个自动槽使用带 ROM、内核、固定提交、配置、时间、长度、状态 SHA-256 及同帧 缩略图的 v1 封装。暂停菜单可保存、读取和选择恢复点。
  • 活动/正常结束标记可发现上次异常会话,只提示有效候选且不自动运行。读档前持久保护当前状态和 电池;拒绝不匹配文件,反序列化失败回滚,双重失败安全重载或进入不可运行 Error。
  • Android SAF 导入/导出白名单存档包,默认不含 ROM;限制路径、重复项、格式、单项 64 MiB 和总计 128 MiB,所有项先校验后通过同一提交器写入。

自动验证

Windows 原生测试覆盖 SHA-256 标准向量、安全提交首次成功、替换前故障保持旧文件、有效备份、乱序 旧版本拒绝;状态封装往返、截断、载荷校验错、ROM/内核提交不匹配;可控时钟的 10 秒/60 秒触发 和三槽轮换;存档包往返、路径穿越拒绝及校验错。

待真机验收

用户当前不连接手机,且 G1~G4 尚未通过。首次/覆盖槽位、SAF 成功与取消、异常进程终止、内核 反序列化失败/双重失败、实机帧时间,以及 H-SAVE 的十槽共 100 次循环和全手柄路径均未执行。 因此 todo.md 的 M5 实现项和 G5 不勾选,10 秒/60 秒仍是初始值而非实测冻结值。