feat: implement M6 daily use interface
This commit is contained in:
+11
-1
@@ -1,4 +1,4 @@
|
||||
# NESLite 架构(M5 基线)
|
||||
# NESLite 架构(M6 基线)
|
||||
|
||||
## 边界与线程
|
||||
|
||||
@@ -90,3 +90,13 @@ M4 输入层按物理来源维护状态,来源键包含本次设备 ID、按
|
||||
读档只在暂停态核心线程进行并先持久保护当前状态和电池,失败回滚,双重失败安全重载或进入 Error。
|
||||
活动会话标记只提示校验有效的异常恢复候选,不自动运行。SAF 存档包只允许电池、手动槽和自动槽,
|
||||
不含 ROM;原生层在写入前完成路径、单项/总大小、格式、哈希、内核提交、配置和每项校验。
|
||||
|
||||
## M6 日常界面
|
||||
|
||||
Room v2 在 ROM 哈希主键之上保存收藏、隐藏和最近游玩;查询只展示未隐藏项并按收藏、最近、名称排序。
|
||||
隐藏不操作内部 ROM 或 `saves/<sha256>`,导入器遇到相同哈希时恢复关联。显示/音频/输入偏好由独立
|
||||
DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及手柄继续复用原有命令和档案。
|
||||
|
||||
存档管理只解析 M5 已提交封装的边界元数据和缩略图,所有修改仍回到核心线程/统一提交器。虚拟手柄
|
||||
按 pointerId 维护触摸来源并送入与物理手柄相同的 `InputRouter`,因此多来源去重、相反方向和释放规则
|
||||
一致;取消、滑出、失焦与暂停清空所有虚拟来源。首次使用状态也存于设置 DataStore,不接触用户存档。
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
# NESLite 可复现构建说明
|
||||
|
||||
本说明对应 M0~M4 基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
|
||||
本说明对应 M0~M6 基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
|
||||
FCEUmm 或 Oboe 文件。
|
||||
|
||||
## 前置条件
|
||||
|
||||
+1
-1
@@ -6,7 +6,7 @@
|
||||
| --- | --- |
|
||||
| 显示名称 | `NESLite` |
|
||||
| 正式 application ID/namespace | `org.neslite.app` |
|
||||
| 当前开发版本 | `0.5.4`,`versionCode = 5004` |
|
||||
| 当前开发版本 | `0.6.4`,`versionCode = 6004` |
|
||||
| 调试 application ID | `org.neslite.app.debug` |
|
||||
| 发布 ABI | `arm64-v8a` |
|
||||
| min/target SDK | 28/36 |
|
||||
|
||||
@@ -0,0 +1,33 @@
|
||||
# M6 日常使用界面记录
|
||||
|
||||
日期:2026-09-12
|
||||
构建目标:`org.neslite.app.debug`,`0.6.4-debug`,versionCode 6004,arm64-v8a
|
||||
|
||||
## 已实现
|
||||
|
||||
- Room v2 持久化收藏、隐藏和最近游玩时间;支持名称/SHA-256 搜索并显示格式、大小、短哈希、导入
|
||||
时间、最近游玩和缺失状态。移除只隐藏,重新导入同哈希恢复关联。
|
||||
- DataStore 统一保存 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB 快进;设置页复用
|
||||
M3 音频及 M4 手柄档案、A/B 交换和死区状态源,并立即作用于当前会话。
|
||||
- 存档管理读取 M5 v1 封装,展示十个手动槽、三个按时间排序的自动点、提交时间和 RGB565 同帧
|
||||
缩略图;保存、读取及 SAF 导入导出仍调用 M5 服务。
|
||||
- 页面覆盖库空/搜索空、存档空/加载、导入或原生失败、无手柄与中文长名称;保存反馈来自实际原生
|
||||
提交完成事件。多点虚拟键与手柄使用同一 `InputRouter`,滑出、抬起、取消、失焦及暂停都会释放。
|
||||
- 首次引导说明导入、手柄测试、无手柄游玩、保存和退出。
|
||||
|
||||
## 自动验证
|
||||
|
||||
JVM 测试新增设置默认值、虚拟输入滑动先释放后按下、取消释放全部来源、触屏与手柄独立释放,以及
|
||||
存档目录读取器的有效缩略图往返和截断拒绝;既有输入、库导入、诊断和 M5 原生故障测试继续回归。
|
||||
`tools/check.ps1 -Scope Stage` 的 APK、Windows 原生测试和 JVM 29 项全部通过;Android lint 为 0 错误、
|
||||
42 个非阻断警告。调试 APK 为 22,227,235 字节,SHA-256
|
||||
`52F2F84B9BE98DC470A9588B48080BFF1D95C8C50A7C57B499D0EE1012EFF607`。
|
||||
`tools/check.ps1 -Scope Stage` 的 APK、Windows 原生测试和 JVM 28 项全部通过;Android lint 为 0 错误、
|
||||
42 个非阻断警告。调试 APK 为 16,019,404 字节,SHA-256
|
||||
`46C6A207E8D4AF0E7131FA24149B49958FF8E99872E26F4BCA4E49F2801614A5`。
|
||||
|
||||
## 待真机验收
|
||||
|
||||
用户当前不连接手机,且 G1~G5 尚未通过。中文长文件名混合库、Room v1 实际升级、设置重启、真实
|
||||
缩略图、SAF 文件提供器、纯触屏多点路线、首次清数据引导及全手柄/纯触屏完整主链尚未执行。
|
||||
因此 `todo.md` 的 M6 实现项和 G6 保持未勾选。
|
||||
@@ -0,0 +1,17 @@
|
||||
# NESLite 日常使用
|
||||
|
||||
1. 点“从文件导入”选择你合法持有的 `.nes` 文件。应用按完整 SHA-256 建库;同名不同内容独立,
|
||||
相同内容不会重复。可按名称/哈希搜索、收藏或从列表隐藏。隐藏不删除 ROM 和存档,重新导入相同
|
||||
内容会恢复关联。
|
||||
2. 点游戏名称加载,状态为 Paused 后点“运行”。可使用标准 Android 手柄;没有手柄时使用画面下方的
|
||||
多点虚拟方向、A/B、Start/Select 和暂停键。滑出或系统取消会释放对应按键。
|
||||
3. “显示、音频与输入设置”可切换 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB
|
||||
快进,并进入手柄映射、A/B 交换和死区设置。设置会在重启后恢复。
|
||||
4. 游戏中点虚拟“暂停”或按手柄右摇杆进入暂停菜单。“存档管理”显示十个手动槽、三个自动恢复点、
|
||||
提交时间和缩略图。只有原生层确认安全落盘后才显示保存成功。
|
||||
5. 存档包通过 Android 系统文件选择器导入导出,默认不含 ROM。导入前先加载对应游戏并暂停;哈希、
|
||||
内核提交、配置、路径、大小或校验不匹配会被拒绝并保留现有有效存档。
|
||||
6. 用“退出游戏”正常结束。上次进程异常终止时,再次加载相同游戏只列出校验有效的自动恢复点,
|
||||
不会自动运行或覆盖当前进度。
|
||||
|
||||
当前尚未连接目标手机,真机手势、布局、文件提供器和完整触控流程仍需在 L2/G6 验收中确认。
|
||||
Reference in New Issue
Block a user