docs(build): M63 修正 README 的 -o 归档语义/宿主路径/版本示例/入库清单

README.md

@@ -3,7 +3,7 @@
 > 把 HiBy R3 Pro II 便携播放器（君正 X1600，MIPS32r2 / mipsel / musl 静态软浮点，480×720，无 GPU 软渲染）变成一个可扩展的「第二系统 + 应用框架」。
 > MeowOS 与官方 HibyOS 共存于同一台设备：开机由引导选单二选一；启动后 MeowOS 作为主控层，提供自己的桌面 UI、应用框架、服务管理与系统组件。
 >
-> 版本：**M6.35（0.8.35，已上卡）**。M6.19→M6.35 连续十七版推卡自刷验收——**M6.19**：ncm 后台化 UI 叠层/点击穿透+再进 ncm 桌面叠层+播放页新旧 UI 叠层抢刷脏区（软自抑帧移交不完整，恢复边沿强制整帧重画）+PIN 亮屏亮度跳+通知中心封面显歌单封面；**M6.20**：播放页右滑返回+顶部下滑通知中心+状态栏时钟 1s；**M6.21-22**：播放页返回修复（`np_exit` 退出外层主循环）+方向感知手势；**M6.23**：watchdog 亮屏亮度按用户设置恢复；**M6.24**：App 内按电源键锁屏时序；**M6.25**：bootmenu 开机菜单亮度方案 A；**M6.26**：播放页三键命中+媒体卡片体 FOCUS；**M6.27**：netmgrd 流量统计收编（pub_bytes/去 lo）+面板公网流量卡；**M6.28**：收编桌面 Now Playing 双页歌词页+歌词数据源+蓝牙 P1（netmgrd BT_CTL/bt_page）；**M6.29**：播放页任意右滑返回桌面；**M6.30**：收编批5 取色+蓝牙 P2（audiod glibc-dynamic）+面板蓝牙卡；**M6.31**：桌面歌词页封面修复+alsa.conf DEV 自动识别；**M6.32**：重编 meow_ui.a+重链四 App（播放页进度条取色+ncm 列表 gap）+面板透传；**M6.33**：收编 launcher 播放页占位符移除（已有独立歌词页）+封面「空→复原」恢复修复（test_np_cover 14 项 PASS）；**M6.34**：收编**批①后台常驻+宽限期**（全 App 入后台表+30min `MEOW_BG_GRACE_MS` 宽限超时回收+声明常驻/媒体活跃无限期保活+槽满 LRU+app.json `background_keepalive` 三权限位+amsd `EV BG/FG` 上报）+**audiod A3/DSD**（24/32bit 高清 byte-exact+独立 `AUDIO_FMT_DOP` DoP DSD 透传+音量收编 v2 双组写）+**meow_img_pixels 访问器上收**+**面板拆分+屏幕·遥控合并页**（前端三层+左屏右遥控 MD3 SVG 矢量按钮）；**M6.35**：收编**批③后台管理页**（桌面顶栏「后台」入口+`bg_page` 后台列表+每行「杀」按钮+顶栏「一键清」，`!framework` 门控不杀框架）+**amsd FG/BG 收编**（`57e19cde`）+**i18n settings/lock 补抽**。M6.35 之后工作区已提交（暂未打包，并入 M6.36）：批①叠加/穿透根治（`/tmp/meow_notif_active` 内容=前台归属 app_id+SDK present/input 共享判定+launcher 7 处转场）、主界面顶栏后台按钮图标美化、主界面列表圆角卡 8px 外距、后台管理页行 MD3 圆角卡；**MD3 对齐在跑**（agent-435，参考 `third_party/md-material-web` 最新 M3）。M6.10→M6.18：M7 launcher 重写第 1-5 期（M6.10-14：虚拟化宫格/设置页卡顿修复/OOM 通用化/自动切歌根治）+（M6.15）meowpanel jv_free 泄漏修复+（M6.16）Hello demo 滚动卡顿修复+（M6.17）歌词 UI+（M6.18）媒体通知封面+封面分辨率。M6.1→M6.9 全链自刷验收——**M6.1**：netmgrd 期3/powermgr 期2/面板 PIN 鉴权+首页仪表盘/WiFi 录入 UI/服务名统一 meow_*；**M6.2**：锁屏 PIN 全量（`system.pin` 同源面板）+VOL_DOWN×3 框架门控+显示名 name[49]（amsd/launcher UTF-8 整序列截断）；**M6.3**：设置页 5s 修复（309 网络异步步骤机+跳过字体 sha 校验）+310 锁屏三连（输入穿透/解锁状态栏消失/App 死亡残影）；**M6.4**：310 二期 **EVIOCGRAB 锁屏独占触控**（未冻结 App 锁屏输入隔离）+主界面应用名截断；**M6.5**：audiod 315 孤儿会话两段式回收（客户端崩溃/OOM 杀/正常退出后会话完整回收，STATE 回干净无流基线）；**M6.6**：锁屏 310 三期——App 内手动息屏也触发锁屏 + 锁屏脏区全屏不透明底 + 300ms 重铺；**M6.7**：锁屏页自睡（空闲超时自动灭屏，294 遗留补；0.8.7 补刷吸收 fw_content 事故修复——拆分 watchdog+meow_audio 两行）；**M6.8**：310 四轮 锁屏自睡 min(系统息屏,30s)；**M6.9**：netmgrd 期4（SDK 自愿通道/forget/RSSI/AAAA 过滤/iptables 评估）+powermgr 期3（policy/标定工具）固化 + 327 M7.0b launcher 试点（电源菜单/Now Playing 控件化+主题薄壳+i18n 抽串）；历史：M2.69→M2.96 全链路自刷验收：控件库/主界面 MD3 双布局/M3 导航栈/M5 通知跳转/媒体会话/Now Playing/SDK nav+media 封装/字库启动竞态修复**/M2.84-88**：installed 图标修复+残帧pan加固/物理键EVIOCGKEY双源/签名鉴权 2B/meow_route 音频路由/amsd 二期(picker 契约)/流媒体客户端二期(封面·歌词后台·大歌单分页)/MeowPanel 实时画面+遥控+通知实时化/中文拼音 IME**/M2.89**：开机选单抢屏回归修复+watchdog SIGUSR1 不误杀框架 App+amsd 失联修复+顶部下滑手势分流**/M2.90**：**meow_audiod 独占音频守护**（AUDIOD_DESIGN，meow_route 并入退役）+MIUIx 顶级主题+流媒体客户端文案中文化+面板字体库 tar.gz 导入导出**/M2.91-96**：audiod 开机武装 hbc3000 FPGA（根治 PCM 启动内核死锁）+svc_power 充电态权威链(mp2731)+amsd 注册自愈（`am rescan`）/Now Line truncated
+> 版本：下方版本段落记录到 **M6.35（0.8.35，已上卡）**；固件版本号单点 = 板上 `/etc/meowos_version`（由 `build_fw_apps.sh -v` 写入），现行产物示例 `r3proii_0.8.49.upt`。M6.19→M6.35 连续十七版推卡自刷验收——**M6.19**：ncm 后台化 UI 叠层/点击穿透+再进 ncm 桌面叠层+播放页新旧 UI 叠层抢刷脏区（软自抑帧移交不完整，恢复边沿强制整帧重画）+PIN 亮屏亮度跳+通知中心封面显歌单封面；**M6.20**：播放页右滑返回+顶部下滑通知中心+状态栏时钟 1s；**M6.21-22**：播放页返回修复（`np_exit` 退出外层主循环）+方向感知手势；**M6.23**：watchdog 亮屏亮度按用户设置恢复；**M6.24**：App 内按电源键锁屏时序；**M6.25**：bootmenu 开机菜单亮度方案 A；**M6.26**：播放页三键命中+媒体卡片体 FOCUS；**M6.27**：netmgrd 流量统计收编（pub_bytes/去 lo）+面板公网流量卡；**M6.28**：收编桌面 Now Playing 双页歌词页+歌词数据源+蓝牙 P1（netmgrd BT_CTL/bt_page）；**M6.29**：播放页任意右滑返回桌面；**M6.30**：收编批5 取色+蓝牙 P2（audiod glibc-dynamic）+面板蓝牙卡；**M6.31**：桌面歌词页封面修复+alsa.conf DEV 自动识别；**M6.32**：重编 meow_ui.a+重链四 App（播放页进度条取色+ncm 列表 gap）+面板透传；**M6.33**：收编 launcher 播放页占位符移除（已有独立歌词页）+封面「空→复原」恢复修复（test_np_cover 14 项 PASS）；**M6.34**：收编**批①后台常驻+宽限期**（全 App 入后台表+30min `MEOW_BG_GRACE_MS` 宽限超时回收+声明常驻/媒体活跃无限期保活+槽满 LRU+app.json `background_keepalive` 三权限位+amsd `EV BG/FG` 上报）+**audiod A3/DSD**（24/32bit 高清 byte-exact+独立 `AUDIO_FMT_DOP` DoP DSD 透传+音量收编 v2 双组写）+**meow_img_pixels 访问器上收**+**面板拆分+屏幕·遥控合并页**（前端三层+左屏右遥控 MD3 SVG 矢量按钮）；**M6.35**：收编**批③后台管理页**（桌面顶栏「后台」入口+`bg_page` 后台列表+每行「杀」按钮+顶栏「一键清」，`!framework` 门控不杀框架）+**amsd FG/BG 收编**（`57e19cde`）+**i18n settings/lock 补抽**。M6.35 之后工作区已提交（暂未打包，并入 M6.36）：批①叠加/穿透根治（`/tmp/meow_notif_active` 内容=前台归属 app_id+SDK present/input 共享判定+launcher 7 处转场）、主界面顶栏后台按钮图标美化、主界面列表圆角卡 8px 外距、后台管理页行 MD3 圆角卡；**MD3 对齐在跑**（agent-435，参考 `third_party/md-material-web` 最新 M3）。M6.10→M6.18：M7 launcher 重写第 1-5 期（M6.10-14：虚拟化宫格/设置页卡顿修复/OOM 通用化/自动切歌根治）+（M6.15）meowpanel jv_free 泄漏修复+（M6.16）Hello demo 滚动卡顿修复+（M6.17）歌词 UI+（M6.18）媒体通知封面+封面分辨率。M6.1→M6.9 全链自刷验收——**M6.1**：netmgrd 期3/powermgr 期2/面板 PIN 鉴权+首页仪表盘/WiFi 录入 UI/服务名统一 meow_*；**M6.2**：锁屏 PIN 全量（`system.pin` 同源面板）+VOL_DOWN×3 框架门控+显示名 name[49]（amsd/launcher UTF-8 整序列截断）；**M6.3**：设置页 5s 修复（309 网络异步步骤机+跳过字体 sha 校验）+310 锁屏三连（输入穿透/解锁状态栏消失/App 死亡残影）；**M6.4**：310 二期 **EVIOCGRAB 锁屏独占触控**（未冻结 App 锁屏输入隔离）+主界面应用名截断；**M6.5**：audiod 315 孤儿会话两段式回收（客户端崩溃/OOM 杀/正常退出后会话完整回收，STATE 回干净无流基线）；**M6.6**：锁屏 310 三期——App 内手动息屏也触发锁屏 + 锁屏脏区全屏不透明底 + 300ms 重铺；**M6.7**：锁屏页自睡（空闲超时自动灭屏，294 遗留补；0.8.7 补刷吸收 fw_content 事故修复——拆分 watchdog+meow_audio 两行）；**M6.8**：310 四轮 锁屏自睡 min(系统息屏,30s)；**M6.9**：netmgrd 期4（SDK 自愿通道/forget/RSSI/AAAA 过滤/iptables 评估）+powermgr 期3（policy/标定工具）固化 + 327 M7.0b launcher 试点（电源菜单/Now Playing 控件化+主题薄壳+i18n 抽串）；历史：M2.69→M2.96 全链路自刷验收：控件库/主界面 MD3 双布局/M3 导航栈/M5 通知跳转/媒体会话/Now Playing/SDK nav+media 封装/字库启动竞态修复**/M2.84-88**：installed 图标修复+残帧pan加固/物理键EVIOCGKEY双源/签名鉴权 2B/meow_route 音频路由/amsd 二期(picker 契约)/流媒体客户端二期(封面·歌词后台·大歌单分页)/MeowPanel 实时画面+遥控+通知实时化/中文拼音 IME**/M2.89**：开机选单抢屏回归修复+watchdog SIGUSR1 不误杀框架 App+amsd 失联修复+顶部下滑手势分流**/M2.90**：**meow_audiod 独占音频守护**（AUDIOD_DESIGN，meow_route 并入退役）+MIUIx 顶级主题+流媒体客户端文案中文化+面板字体库 tar.gz 导入导Line truncated
 >
 > 许可证：Apache-2.0（见 [`LICENSE`](LICENSE)）。本仓库为非官方第三方项目。
 > 主仓**公开可克隆**：`https://git.yeij.top/AskaEth/MeowOS-For-R3P2.git`（维护者推送走
@@ -222,7 +222,7 @@ init (rcS)
 - **`third_party/`（入库）**—— 第三方参考/依赖归拢目录（与 MeowOS 源码 `patch_v2/` 分离、不混入构建）：`CNMPlayer`（流媒体客户端功能对照）、`md-material-web`（**最新 Material 3 参考**，MD3 对齐依据，agent-435 按其对所有组件细化）。
 - **`LICENSE`** —— Apache-2.0。
 - **顶层文档（入库）**—— `APPS.md`、`MEOW_APP_SDK.md`、`FRAMEWORK_DESIGN.md`、`SYSTEM_SETTINGS.md`、`NOTIFICATION_SYSTEM.md`、`TF_CARD_LAYOUT.md`、`DEVELOPMENT_PLAN.md`、`GESTURE_BACK_DESIGN.md`、`KEY_CONTROL_DESIGN.md`、`PERF_SCHEDULER.md`、`MEOWOS_API.md`。
-- **本地构建资产（根目录 gitignore；但 `scripts/build/` 的 `README.md`/`build_fw_apps.sh`/`fw_content.conf` 已 `git add -f` 入库）**—— 其余（`fw_apps/` 固件组装产物、官方固件基线 rootfs、交叉工具链、本地开发文档、设备密钥等）不入库。详见「构建」与「部署」。
+- **本地构建资产（根目录 gitignore；但 `scripts/build/` 下 `README.md`/`DEVKIT.md`/`build_fw_apps.sh`/`fw_content.conf`/`build_devkit.sh`/`test_build_devkit.sh`/`rebuild_binaries.sh`/`verify_fingerprints.sh`/`devkit-src/*.c` 已 `git add -f` 入库，与 `git ls-files scripts/build` 一致）**—— 其余（`fw_apps/` 固件组装产物、官方固件基线 rootfs、交叉工具链、本地开发文档、设备密钥等）不入库。详见「构建」与「部署」。
 
 ---
 
@@ -247,7 +247,7 @@ patch_v2/hello_app/build_hello.sh   # 链 meow_ui.a + libz.a + -lpthread → hel
 固件 = 官方 v1.4 固件基线 rootfs + SSH 工具集 + MeowOS 系统组件（`meow_bootmenu` / `meow_launcherd` / `meow_watchdog` / `meow_svcd` / `meow_mdns` / `meow_sysui` / `nyai` + 相关 init 脚本 + `/etc/meowos_version`）。特点：
 
 - 打包脚本 `scripts/build/build_fw_apps.sh` 是**配置驱动**的通用脚本（`-c fw_content.conf -v <ver> -o <out.upt> [-b <base>]`）：`fw_content.conf` 清单逐条 `src|dst|md5|desc`，**`.upt` 条目 md5 配置化**（`md5` 空=不校验，填了=构建前强校验源文件，不一致即中止）；**改固件内容只改 `fw_content.conf`，不动脚本**。历史逐版 `build_fw_apps_m2NN.sh` 已**删除**（每版复制一个、内部硬编码 md5、且共享 `fw_apps/` 互相清空）。工作区 `fw_apps/build/`（每次重建）与产物归档 `fw_apps/out/` 分离防互清。这些脚本/清单已 `git add -f` 入库（`scripts/build/` 根目录仍 gitignore），其余为**本地构建工具（gitignore 不入库）**——本仓库只提交源码与文档，需本地交叉工具链 + 官方固件基线 rootfs 才能复现。详见 `scripts/build/README.md`。
-- **rootfs 上限 45,088,768 B（≈45MB）**；产物归档 `fw_apps/out/r3proii_m2NN.upt`。
+- **rootfs 上限 45,088,768 B（≈45MB）**；产物归档 `fw_apps/out/r3proii_<ver>.upt`（如 `r3proii_0.8.49.upt`；`-o` 要显式写进 `out/`，只给文件名会落在仓库根，见 `scripts/build/README.md`）。
 - `/usr/bin` 各组件为静态 MIPS32r2；版本号以 `/etc/meowos_version` 为单点（`build_fw_apps.sh -v` 写入）。
 - **`.upt` 容器 md5 不可复现**（repack 时间戳），以**内容级 0 diff 回验**为准。
 - 外围 CLI（curl/socat/tmux/jq/…）已迁 TF 卡 `MeowOS/opt/bin/`（不进固件）；固件**不含** SDK 库（`meow_ui.a` 只随 App 链接），`hiby_player` 保持官方原样。
@@ -260,7 +260,7 @@ patch_v2/hello_app/build_hello.sh   # 链 meow_ui.a + libz.a + -lpthread → hel
 
 **刷机（整机刷新 MeowOS 固件）**
 
-- 打包产物名 `r3proii_m2NN.upt`；要刷机时把它**复制为 TF 卡根目录的 `r3proii.upt`**。
+- 打包产物名 `r3proii_<ver>.upt`（如 `r3proii_0.8.49.upt`）；要刷机时把它**复制为 TF 卡根目录的 `r3proii.upt`**。
 - 关机（failsafe）后按住**音量加 + 电源**进入升级模式，从卡根 `r3proii.upt` 升级。避免使用播放器 UI 里那个会卡死的升级按钮。
 - 回退：用官方固件重刷，或从 `backups/`（NAND 全量备份，本地）恢复。