AskaEth/MeowOS-For-R3P2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
378 Commits 1 Branch 0 Tags
9600f1035270d59da69ec368a33e35dfbff27260
Commit Graph
378 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
AskaEth 9600f10352 fix(hello): demo 左滑列表行高按字体行高派生 — 首行标题不再丢失（M17） 
根因（承接 M12/M15 finding）：SDK meow_listview 双行 renderer 把
block = 2*meow_ui_text_height(font_body) + MEOW_LISTV_SUB_GAP(2) 在行内垂直居中
（ty = 行顶 + (item - block)/2），标题只在 ty >= 视口顶时才画。demo 的 swipe 列表
显式 set_item_renderer(2,1,0)（双行档位）却 set_item_h(48)：真机 source_han_serif
20px 行高 30 → block 62 → ty = 行顶 - 7，首行「notif 0」标题被裁剪守卫整条跳过，
只剩 swipe left 副标题。

修复：
- hello_internal.h：新增 HELLO_ROW_H_MIN(56) / HELLO_ROW_SUB_GAP(2，与 SDK
  MEOW_LISTV_SUB_GAP 同口径) + hello_row_h_for_line_h(line_h)
  = max(56, 2*line_h + 2) + hello_row_h()（取当前主题 font_body 的
  meow_ui_text_height）。本地派生，不依赖 M15 新增导出 meow_listview_item_h；
  显式传值在 M15 之前的 SDK（默认 48/56 档位）与 M15 之后（默认已派生 62）都成立且一致。
- ui/demo/sdk2/sdk2.c：set_item_h(48) 改传 hello_row_h()（行高 30 → 62）。
  列表视口 LV_H / 三节布局推进量不变（行高只影响行内几何与滚动量），其它 demo 区块
  （LazyColumn 列表、宫格、选择器）不受影响。

验证（宿主，未碰真机）：
- zig-mipsel-cc -Os -static -Wall -Wextra（另用 -Werror 复验）交叉编译 hello：0 warning；
- 新宿主 test/test_row_text_fit.c（32 断言，纯头文件派生、不链 SDK）：
  字库行高矩阵 14/21/26/27/30 下 block <= item、首行 ty >= 0；行高 30 → 62；
  旧 48 → ty=-7 的 bug 形态哨兵；全 PASS。

影响：meow_ui.a 未改 → 无需重编 SDK；本 App 需重链重部署（热更 hello 二进制）。
 2026-11-05 20:57:13 +08:00
AskaEth e69b8efeeb fix(files): 目录列表行高按字体行高派生 — 20px 字库下首行标题不再空白（M17） 
根因（承接 M12/M15 finding）：SDK meow_listview 双行 renderer 把
block = 2*meow_ui_text_height(font_body) + MEOW_LISTV_SUB_GAP(2) 在行内垂直居中
（ty = 行顶 + (item - block)/2），标题只在 ty >= 视口顶时才画。目录行是双行档位，
真机 source_han_serif 20px（ascent 24 + descent 6）行高 30 → block 62，而
browser_page_create 显式 set_item_h(56) → ty = 行顶 - 3：首行（行顶 == 视口顶）
标题被裁剪守卫整条跳过，只剩大小/时间副标题。

修复：
- files_internal.h：APP_ROW_H 降级为行高下限（56）；新增 FILES_ROW_SUB_GAP(2，与
  SDK MEOW_LISTV_SUB_GAP 同口径) + files_row_h_for_line_h(line_h)
  = max(56, 2*line_h + 2) + files_row_h()（取当前主题 meow_theme_get()->font_body
  的 meow_ui_text_height）。本地派生，不依赖 M15 新增导出 meow_listview_item_h；
  显式传值在 M15 之前的 SDK（默认 56）与 M15 之后（默认已派生 62）都成立且一致。
- ui/browser.c：browser_page_create 的 set_item_h 改传 files_row_h()
  （行高 30 → 62）。SDK 的 draw/hit/max_scroll 全部按这一个值换算，滚动/命中天然
  同步；页脚几何（r_list 单独扣 APP_FOOTER_H）与行高无关。其它几何/交互不变。

验证（宿主，未碰真机）：
- zig-mipsel-cc -Os -static -Wall -Wextra（另用 -Werror 复验）交叉编译 files：0 warning；
- 新宿主 test/test_row_text_fit.c（32 断言，纯头文件派生、不链 SDK）：
  字库行高矩阵 14/21/26/27/30 下 block <= item、首行 ty >= 0；行高 30 → 62；
  旧 56 → ty=-3 的 bug 形态哨兵；全 PASS。

影响：meow_ui.a 未改 → 无需重编 SDK；本 App 需重链重部署（热更 files 二进制）。
 2026-11-05 20:57:13 +08:00
AskaEth c2635daf3f Merge branch 'feat/sdk-time64-syscall-gaps' 2026-11-05 20:46:36 +08:00
AskaEth a7bd6c44d9 fix(sdk): 评审 p2 修正 — 负 nsec 判 EINVAL / 音频条件等待计数改 5 处 
- meow_ui_time.c `__timedwait_cp`：`at->tv_nsec` 是有符号 long，原写法
  `>= 1000000000L` 会让负 nsec 通过（musl 原文用 `>= 1000000000UL`，负值按无符号
  比较同样判 EINVAL）。改为 `< 0 || >= 1000000000L`，与本文件 M11 的
  `__clock_nanosleep` 写法一致；同时避开 `-Wsign-compare`（UL 写法在 -Wextra 下
  会告警）。反汇编确认 llvm 合并成一条 `sltu`，与 musl 的 unsigned 比较等价。
- CLOCK_ABI.md：meow_ui_audio.c 的 pthread_cond_timedwait 调用点由「3 处」改为
  5 处（:312/:351/:417/:431/:499），§5/§6 两处同步；核对文中其它计数（四 App、
  23 项单测）无误。

验证：宿主 gcc -Wall -Wextra 0 warning，test_meow_time64 23 项 PASS、
test_meow_time 回归 PASS；交叉 zig -Wall -Wextra 0 warning；
build_sdk_host.sh --verify 76 成员全 MIPS32r2、0 warning；归档内 meow_ui_time.o
与新鲜交叉构建逐字节一致。
 2026-11-05 20:46:26 +08:00
AskaEth 40ac1e40f0 docs(sdk): CLOCK_ABI 补 M16 全量清点/接管机制/验证 
§6 把「同源残余」换成逐条清点：zig musl 源里 20 处
`#if defined(SYS_*_time64) && !defined(__ILP32__)` 守卫，分「受损（回退分支直传
time64 结构）」与「不受影响（回退分支自带 long[]/宽度判断）」两类，各给源文件:行号
与反汇编证据；纠正 M11 对 pselect/ppoll 的保守判断（它们本来就正确）。

§7 记录接管机制：_REDIR_TIME64 让应用引用 __x_time64（不是 API 名）；同一 .o 的
libc 符号必须一起定义（只定义 __timedwait_cp 会与 libc 的 __timedwait.o 撞
duplicate symbol，lld 实测）；hidden 不阻止静态链接接管但要保证本 TU 被拉入；
结构宽度前提（整链 zig 头）。附未修 7 项的 5 步配方与「不建议顺手全改」的理由。

§8 记录本单验证：宿主 23 项换算单测 + M11 回归、build_sdk_host.sh --verify
（76 成员/全 MIPS32r2/0 warning）、四个入口的 syscall 号与缓冲宽度反汇编、
真实 meow_ui.a 链接探针的符号绑定。真机确认仍待设备。
 2026-11-05 20:46:26 +08:00
AskaEth 0412994953 test(sdk): time64→o32 time32 换算宿主单测（23 项） 
test_meow_time64.c 覆盖 meow_ui_time.c 接管入口共用的纯换算层：

- 相对超时（futex）：普通值、亚秒、INT32_MAX 上界、上/下溢饱和、负值透传；
- 绝对时刻（clock_settime/timerfd）：int32 上下界接受、越界拒绝（对应 ENOTSUP）；
- itimerspec 四字段不串位、任一越界整体失败且不写坏输出、反向展开对称；
- 结构宽度 before/after：同一块 16B time64 内存按内核 o32 只读 8B 时，
  0.4s 被读成 {0,0}（立即超时）、2.3s 被读成 2s 整；经本层转换后内核读到
  {2, 300000000}。

宿主编译/运行：
  gcc -Os -Wall -Wextra -I. -Iinclude -c meow_ui_time.c -o /tmp/m.o
  gcc -Os -Wall -Wextra -I. -Iinclude test_meow_time64.c /tmp/m.o -o test_meow_time64
  ./test_meow_time64        # == PASS ==
M11 的 test_meow_time.c 仍 PASS（回归）。
 2026-11-05 20:46:26 +08:00
AskaEth 3b5ffece57 feat(sdk): 接管 mipsel time64 同源缺口 — futex 相对超时/timerfd/clock_settime 
zig clang 给 mipsel 预定义 __ILP32__，打穿 musl 的 time64 回退守卫，以下入口把
16/32 字节 time64 结构直接交给 o32 time32 系统调用：

- thread/__timedwait.c:14：futex 相对超时（pthread_cond_timedwait / sem_timedwait /
  pthread_join 超时 / aio_suspend / 非 PI timedlock / rwlock timed）。内核只读前 8B，
  tv_nsec 落在 tv_sec 高半字（恒 0）→ 亚秒等待立即超时、整秒等待丢纳秒。SDK 的
  meow_ui_audio 三处条件等待直接受害。按 musl 原文接管 __timedwait_cp/__timedwait，
  只在发 futex 前把相对超时转成 time32；取消点仍走 libc 的 __syscall_cp。
- linux/timerfd.c:14/42：32B itimerspec 直传 → 内核按 16B 读、字段错位；接管
  create/settime/gettime（同一 .o 的三个符号必须一起定义，否则重复定义）。
- time/clock_settime.c:9：16B 直传 → nsec 恒 0；接管 __clock_settime64。

换算抽成平台无关的 meow_time32_{rel,abs}_from_parts() / itimerspec 转换
（meow_ui_internal.h），宿主可测。pselect/ppoll/select、getrusage、wait4、
clock_adjtime 逐条反汇编确认回退分支自带宽度转换，不受影响（纠正 M11 §6 的保守
估计）。未修项（sigtimedwait/semtimedop/timer_settime/gettime/utimensat/recvmmsg/
mq_timedsend/PI timedlock）的清单与配方见 CLOCK_ABI.md §6/§7。

验证：宿主 gcc -Wall -Wextra 0 warning；交叉 zig -Wall -Wextra 0 warning；
build_sdk_host.sh --verify 76 成员全 MIPS32r2；真实 meow_ui.a 链接探针确认
__pthread_cond_timedwait_time64 的 jal 指向本实现、futex=4238 且超时为 8B、
timerfd 4323/4322、clock_settime 4262。
 2026-11-05 20:46:26 +08:00
AskaEth cfcb94b8d2 Merge branch 'feat/sdk-listview-row-height' 2026-11-05 20:38:09 +08:00
AskaEth 31c12892d6 test(sdk): 宿主回归 — --wrap 行高 30 下首行标题必须画出（listview 行高派生） 
新 test_meow_ui_listview_rowh.c（35 断言）用链接期
-Wl,--wrap=meow_ui_text_height 把宿主 5x7 回退行高 14 换成真机 source_han_serif
20px 实测行高 30，驱动真实 SDK 渲染（同 M12 app/test/test_first_row_title_render.c
手法），断言全部读 back_buf 像素：

- T0 wrap 生效（meow_ui_text_height(font_body) == 30）；
- T1 默认（不设 item_h）：item_h == 62 = max(56, 2*30+2) ≥ 2*行高+间距；
  max_scroll/hit 按 62 换算；scroll=0 时首行标题带与副标题带都有文字像素；
  视口上方无标题泄漏；
- T2 裸 create（不调 renderer）同样派生；set_item_h(0) 忽略并保持派生；
- T3 显式 set_item_h(70)（ncm 语义）：item_h/hit/max_scroll 全按 70，首行标题可见；
- T4 档位：tier(2) 恢复派生 62、tier(1) 48，单行档位不画副标题且标题可见；
- T5 pool 模式（set_vsource + 默认 renderer）：同样派生 62，首行标题可见；
- T6 旧行为哨兵：显式 56 < block 62 时首行标题带 0 像素、副标题仍有 → 证明
  像素断言能区分「画出/被跳过」，即 A/B 复现 bug 形态。

回归（宿主 gcc -O1 -Wall -Wextra，全部 0 warning）：
- 新 test：35 pass / 0 fail；
- listvirt 44 / widgets ALL PASS / md3 ALL / scroll 17 / select 6 / swipe 35 /
  lazygrid 32 全 PASS；
- 交叉 build_sdk_host.sh --verify：76 成员全 MIPS32r2 rel2，meow_ui_widget.c
  -Wall -Wextra 0 warning（meow_ui.a 变更 → 下游 App 重链）。
 2026-11-05 20:38:02 +08:00
AskaEth 4d9ba46a7b fix(sdk): listview 默认行高按字体行高派生 — 双行列表首行标题不再被裁剪 
根因（M12 finding / SDK 侧）：meow_listview 双行 renderer 把「标题+副标题」
文本块 block = 2*meow_ui_text_height(font_body) + MEOW_LISTV_SUB_GAP(2) 在行内
垂直居中（ty = 行顶 + (item-block)/2），且文本只在 `ty >= 视口顶` 时才画。
旧默认行高固定 56 假定行高 ≤ 27；真机 source_han_serif 20px（ascent 24 +
descent 6）行高 30 → block 62 > 56 → ty = 行顶 - 3，首行（行顶 == 视口顶）
标题被裁剪守卫整条跳过、副标题仍在 → 所有用默认行高的 App 两行列表首行
标题消失。

修复（patch_v2/sdk/meow_ui_widget.c）：
- item_h=0 改为「派生」哨兵：listv_item_h() 在未显式定行高时按当前主题正文
  字体行高算 —— lines=2: max(56, 2*line_h+2)（行高 30 → 62）、lines=1:
  max(48, line_h)。draw/hit/max_scroll 共用同一函数，行几何恒一致；
- meow_listview_create 不再写死 56；set_item_renderer 不再写死 48/56；
  set_item_tier 恢复派生默认（仍是 1→≥48 / 2→≥56 的口径，字体大时自动长高）；
- 显式 meow_listview_set_item_h(>0) 语义不变、优先且固定（ncm 传 70、files
  传 56 等调用方不受影响）；set_item_h(<=0) 仍忽略，返回值改为「当前生效行高」；
- 新增 meow_listview_item_h() 读当前生效行高（App 自绘行装饰对齐用，避免再
  硬编码 56）；
- src2 分支的双行判断补 `w->lines == 2`，与 pool 分支同口径：tier/renderer 设
  单行档位时明确不画副标题（此前单行档位 48px 里仍塞 62px 文本块 → 同样丢标题）。

同类路径评估（不改）：
- LazyColumn/LazyRow（W_LIST）：单行 label，item_h 由 create 显式给（默认 44），
  且 item_h 兼作横向列宽，按行高派生意味不明；默认 44 > 真机行高 30，当前不触发；
- lazygrid：格子几何由 App 显式给、文本底部对齐并整体 clip_push 裁剪，不受影响。

影响面：所有用默认行高的两行列表（hello/reader/files 及其它 App）在 20px 字库
下默认行高 56 → 62；显式 set_item_h 的调用方（ncm 70/launcher/files 等）零变化。
meow_ui.a 变更 → 下游 App 需重链（追加导出符号 meow_listview_item_h，ABI 兼容，
老 App 不重编也能跑）。

验证：见下一条 test 提交（宿主 --wrap 行高 30 + 像素断言 35 断言）。
 2026-11-05 20:38:02 +08:00
AskaEth 805cfe11cc Merge branch 'feat/firmware-build-m646-killfix' 2026-11-05 20:16:38 +08:00
AskaEth c811913c06 build(fw): M6.46 固件 — 编入 M7 杀后台修复 + M11 SDK 时钟修复（0.8.46） 
- launcher bb2d5f12 (863160B) 重编，链 meow_ui.a 4c4a1554：
  M7(bgmgr_can_kill 门控 framework→protected_app / 后台页 sub 指针持久化 /
  am kill 走 meow_bg_terminate 与页面按钮同通道) + M11(meow_ui_time 按 o32 time32 取时、
  链接期接管 __clock_gettime*)
- meow_amsd b698f176 (139252B) 重编：M7 am kill 同通道 + cmd_kill/cmd_start 失败原因细分
  （am CLI 9e323faf 保持不动：am.c 自 ca2290e 未变，与仓库发布物一致）
- fw_content.conf 8 条源 md5 对齐：bootmenu 4441822d / watchdog 553840cd / audiod b122c9b8 /
  meow_audio 891ab264 / netmgrd×2 20243ea1 / launcher bb2d5f12 / amsd b698f176；头注 M6.46/0.8.46
- build_fw_apps.sh：repack.sh 改 bash 显式执行（#!/usr/bin/env bash 在 su 下 bad interpreter）
- 打包 r3proii_m6_46.upt md5 66501aaf(42,930,176B)：rootfs 38,756,352<=45,088,768，
  unpack 0 diff，87 files/1 folder 与 m6_45 一致
- 卡上写 r3proii.upt(66501aaf)，原 0.8.45(3f4a8ad3) 备份 r3proii.upt.bak.0.8.45；
  写前写后 du -sk Music 均 199164544；未刷机（运行中仍 43ac2312 / 0.8.45）
 2026-11-05 20:16:29 +08:00
AskaEth 278e7eaa93 merge(sdk): 收编公开 SDK 仓的图片预算解码，主仓成为 SDK 唯一权威源 2026-11-05 20:07:26 +08:00
AskaEth d9950d75eb Merge branch 'feat/ncm-list-first-row-title' 2026-11-05 20:04:49 +08:00
AskaEth e23bdca26a fix(sdk): 收编公开 SDK 仓独有改进（图片预算解码 + JPEG 解码期缩解），主仓成为唯一权威源 
公开仓 ~/Proj/MeowOS-SDK 的 sdk/ 与主仓 patch_v2/sdk 无共同 git 历史（subtree split
重写了提交哈希，不做跨仓 merge/subtree pull），按内容逐文件裁决。公开仓侧的真增量只有
commit 21bffa1（图片预算解码）及其依赖；其余差异是公开仓的自包含打包（扁平 include/、
vendored 头与 meow_font.c）或主仓早已超越的旧快照。

一、取公开侧（纯追加，主仓该文件无独有改动）
- stb_image.h：新增 stbi_load_scaled / stbi_load_scaled_from_memory——JPEG 输出级按
  步长抽取行/列，整幅原尺寸输出缓冲从不物化；进升级 JPEG 各分量系数 IDCT 进像素平面后
  立即释放。scale<=1 与旧 API 等价，非 JPEG 忽略。主仓版本的 diff 全部是公开侧新增
  （无主仓独有 hunk），故整体替换。
- meow_ui_img.c：追加 img_pick_scale / img_finish_dim / meow_img_probe_file /
  meow_img_load_file_dim / meow_img_load_mem_dim。既有加载入口一字未改。
- include/meow_ui_image.h：追加上述三个公共声明。
- 新增 test_meow_img_budget.c + test_meow_img_budget_gen.py（--wrap malloc/free 打点
  统计瞬时峰值，B1-B9 覆盖矩阵）。

二、取主仓（公开侧为旧快照或自包含适配，并入会回退功能）
- meow_ui_ime.c / test_ime_fix.c：主仓 bug3 修复（IME 打开瞬间 200ms TAP 冷却窗 +
  drain/40ms/再 drain）及其回归用例为公开侧所无；公开侧同名文件不含该修复。
- meow_ui_input.c / meow_ui_internal.h：主仓 meow_input_touch_reset（drain 与叠加抑制
  进入沿共用）、FreeType 渲染/字形声明、meow_time_ms_from_parts。公开侧此三处无独有声明
  可并，取主仓即并集。
- meow_ui_gfx.c / meow_ui_sys.c / meow_cachegov.c：主仓时钟 ABI 根因修复（o32 time32，
  meow_ui_time.c 链接期接管 __clock_gettime*）已把这些文件的本地 now_ms 统一为
  meow_ui_time_ms()；公开侧仍是各自 clock_gettime，回落即回退根因修复。
- meow_ui_dialog.c / meow_select.c：主仓 MD3 后续（对话框按钮胶囊 MEOW_SHAPE_FULL、
  bottom sheet 顶角 28）晚于公开侧快照，公开侧等于旧版。
- include/meow_ui_font.h：主仓多出 FreeType 段与 stdint 自洽 include，公开侧缺。
- build_sdk.sh / build_sdk_host.sh：主仓含 FreeType vendor 裁剪构建、meow_ui_time TU、
  launcher meow_font.a 打包；公开侧为自包含重写，不回流。
- 其余 test_*.c：差异仅为编译配方注释（公开仓用 -Iinclude、无 meow_ui_time.c、标注
  「需主仓组件故公开仓跳过」等），对主仓目录布局不成立，不改。

三、不引入（vendored 副本 / 打包产物）
- meow_font.c、include/meow_font.h、include/meow_ipc.h、include/meow_notif.h：公开仓
  为自包含 vendored 副本（meow_font.c 与主仓 font/meow_font.c 逐字节相同），主仓已有
  权威源，复制会制造双源。

裁决说明（两边都改过的文件）：
- test_meow_ui_select.c：公开仓把 T1 探针从 x=10 改到 x=12（commit 432875d）。主仓 x=10
  在本树实测 6/6 PASS（容器卡左缘 8、文本左缘 24，x=10 已在卡内且避开圆角），无失败
  可修，故不跟进该改动，避免无谓 churn。
- 公开侧「meow_media_playctl」一类 API 名：仅出现在公开仓 vendored 头/文档，主仓
  sdk 无对应实现，未硬造。

四、验证（worktree / 分支 feat/sdk-absorb-public-deltas）
- build_sdk_host.sh --verify：0 warning / 0 error；成员清单 76 个（OBJS 32 +
  meow_font.o + freetype 43）一致，全部 ELF32 MIPS32 rel2 (o32)。
- nm 确认 meow_ui.a 导出 meow_img_probe_file / meow_img_load_file_dim /
  meow_img_load_mem_dim / stbi_load_scaled / stbi_load_scaled_from_memory。
- 宿主测试：对「未改动的 main SDK」跑同一套矩阵做基线对比，40 项同名结果逐项完全一致
  （22 PASS / 11 FAIL / 7 建链失败，失败项与失败计数一字不差）；本提交新增
  test_meow_img_budget 为 PASS。补充按各测试正确配方单编：test_meow_img_color、
  test_meow_lyric、test_meow_lyric_view、test_meow_ui_ft（显式传入 MiSans 字体）、
  test_umbrella 均通过/0 warning。
- 既有失败全部是 Termux 环境问题，与本次合并无关（基线同样失败）：/tmp 不可写导致
  mkdtemp/fopen/bind EACCES（config/vol/notif_open/notify_ipc/notify_integration/
  sb_collapse/overlay_suppress/input_keys），audiod 守护不在场（ui_audio_host），
  test_sdk_fixes 阻塞循环超时（基线同样 124）。
- hello_app 用新 meow_ui.a 重链成功（0 warning，静态 MIPS32r2），可执行文件
  471380→473636 字节（+2256，新解码路径）。

五、影响
meow_ui.a 内容变化（新增 4 个 MEOW_API + stb 解码路径改变）→ 需重编重链 hello / files /
reader / ncm 四 App 与 meow_launcherd。
 2026-11-05 20:03:20 +08:00
AskaEth 22f9dab2ce fix(ncm): 列表首行标题不显示 — 行高按字体行高派生（M12） 
根因（真机 seated，非数据/颜色/遮挡）：SDK meow_listview 双行渲染把
「2*行高 + 2」的文本块在行内垂直居中，且标题只在 ty >= 视口顶时才画
（meow_ui_widget.c:2061 的越界守卫）。真机 source_han_serif 20px 面
ascent 24 + descent 6 → 行高 30 → 文本块 62px，而 ncm 行高 APP_ROW_H=56
→ ty = 行顶 - 3；首行行顶 == 视口顶 → ty < 视口顶 → 标题被整条跳过，
副标题（ty+32）仍在视口内照画。两类列表同用该路径 + 同一行高，故症状一致。

修复（不动 SDK）：ncm_app_internal.h 新增 ncm_row_h()/ncm_row_h_for_line_h()，
行高 = max(56, 2*字体行高 + 2 + 8)（偶数；本机 30 → 70，卡高 62 == 文本块）；
home/playlist/queue/cache/search 在 page create 取一次 g_item_h，统一用于
set_item_h 与卡片几何/可见行/页脚/补载视口换算。

回归：
- app/test/test_meow_row_text_fit.c（新）：真机字库行高矩阵 14/21/26/27/30
  48 断言（文本块 ≤ 行高、首行 ty ≥ 0、卡高 ≥ 文本块、旧 56 哨兵）。
- app/test/test_first_row_title_render.c（新）：--wrap 行高=30 驱动真实 SDK
  渲染 + 读回 PPM 像素计数：旧 56 → 首行标题 0 像素/副标题 186；新 70 →
  标题 84/副标题 100。
- test_meow_row_gap、plpage_sim 全 PASS；ncm_host 7 页出图与改动前逐字节相同
  （宿主行高 14 → 行高仍 56，证重构无视觉回归）；5 页自检 PASS；0 warning。
- plpage_sim 临时目录改 $TMPDIR（Termux /tmp 不可写，原写死无法运行）。
- REPORT §43：根因/排除方向/修复/验证/真机验收要点。
 2026-11-05 19:51:01 +08:00
AskaEth 98b9169b86 build(ncm): 宿主构建补 meow_ui_time.c（M11 漏编，main 上 ncm_host 链接失败） 
M11 新增 patch_v2/sdk/meow_ui_time.c 并把 SDK 各处取时收敛到 meow_ui_time_ms，
但 build_ncm_host.sh 的 SDK_SRC 未同步 → main 上跑本脚本链接报
`undefined symbol: meow_ui_time_ms`（且失败链接会删掉已入库的 ncm_host 产物）。
补一个源文件即可，宿主分支只编 meow_ui_time_ms 的非 mips 实现。
 2026-11-05 19:50:51 +08:00
AskaEth 4e60f440f6 Merge branch 'feat/sdk-clock-abi-fix' 2026-11-05 13:42:04 +08:00
AskaEth 38be5e78bc fix(sdk): 时钟 ABI 根因修复 — meow_ui_time 按 o32 time32 取时并链接期接管 
真机 meow_ui_time_ms() 返回「低 32=秒×1000、高 32 随机」的根因不是 SDK 写法，
而是 zig 0.17 自带 musl 在 mipsel 上的 time64 ABI 自相矛盾：
- zig 头（mips-linux-musl/bits/alltypes.h）无条件 64 位 time_t、struct timespec 16 字节；
- zig 的 clang 给 32 位 mips 预定义 __ILP32__，musl 的 time64 回退分支
  `#if defined(SYS_x_time64) && !defined(__ILP32__)`（本意只排除 x32）被编译掉；
- 于是 libc 的 __clock_gettime64 实为 o32 time32 实现（SYS_clock_gettime 4263），
  只写 8 字节 {int32 sec; int32 nsec}，与头的 16 字节布局错配。

修复（patch_v2/sdk/meow_ui_time.c）：
- meow_ui_time_ms() 直接按内核 o32 ABI 取 8 字节 time32，再升 64 位毫秒；
- 同 TU 强定义 __clock_gettime/__clock_gettime64（归档先于 -lc，链接期接管，
  time()/gettimeofday()/pthread 定时等待的内部取时随之修正）；
- 同源缺陷一并修：__nanosleep_time64/__clock_nanosleep(_time64) 转换 time32 后重发
  （修复前 usleep(16000) 等亚秒睡眠立即返回、变忙等空转）；
- gfx/sys/input/cachegov 四处重复 now_ms 收敛到 meow_ui_time_ms；
- build_sdk.sh OBJS 增加 meow_ui_time；新增 test_meow_time 宿主单测、
  tools/clock_abi_probe.c 探针、CLOCK_ABI.md 根因/验证/影响面文档；
- 26 个宿主测试的编译注释补 meow_ui_time.c（cachegov 测试补时钟源）。

验证：宿主单测 PASS；anim(32)/view_event 宿主用例全过；build_sdk_host.sh --verify
76 成员全 MIPS32r2、0 warning；探针链接后无 libc cgt_init/__vdsosym，
__time64/__timedwait_cp 的取时指向本 TU，睡眠走 4166/4265 且用本地 8 字节结构。
 2026-11-05 13:41:52 +08:00
AskaEth 8a115f6583 Merge branch 'feat/ncm-offline-retry-storm' 2026-11-05 13:16:54 +08:00
AskaEth 294ed6ffc7 test(ncm): M10 宿主回归三套（44 断言）+ 构建脚本 + REPORT §42 
- bench/retry_storm_sim.c（25 断言）：真实 retry_ctl.c/meta_gate.c，100ms tick 断网
  120s→4 次/间隔 ≥30s；状态每 tick 抖动→2 次；时钟回退→不立即重试且间隔仍 ≥30s；
  worker 45s>间隔→不并发；META 空闲 3 帧/60s（旧 600）、播放 13 帧（≤1/5s）、
  状态抖动 ≤4 帧/秒、元数据变化/seek 立即报、超长标题截断不重报、回退不连发。
- bench/home_retry_sim.c（13 断言）：真实 app/ui/home.c 的 home_tick 编进宿主
  （--gc-sections + 桩），断网 120s→4 次重试、单飞、全帧重绘 0 次；
  把真机形态的垃圾 64 位 now 喂给 home_tick 仍为 4 次/≥30s；回在线再断网不清基准。
- bench/meta_ipc_sim.c（6 断言）：真实 ipc_media 线程 + 假 launcher AF_UNIX socket，
  空闲 2s 只收到 1 帧 META（旧 ~10 帧），状态翻转恰好多 1 帧，帧头合法。
- build_ncm.sh / build_ncm_host.sh：源列表加 retry_ctl.c、meta_gate.c（host 补
  mem_watch.c，否则 player_manager 链接失败）；build_ncm_sims.sh 加三个 sim。
- REPORT §42：真机日志证据（时间戳低/高 32 位拆解、21016 帧 META）、根因三链、
  实现、验证（session_gate 88 / http_truncate 13 / core 139 全过）、真机验证建议。
 2026-11-05 13:00:32 +08:00
AskaEth 7f4e18b0ed fix(ncm): META 改「变化+低频心跳」，不再每 100ms 刷 launcher（M10） 
根因：ipc_media 主循环 `if (now - last_meta >= 1000)` 同样依赖 meow_ui_time_ms()
的坏 64 位值（REPORT §42）→ 条件恒真 → 每个 IPC 轮次都发 MSG_META。
launcher 日志 meow_20261105_122541.log：单次启动 21016 条
`ipc: META app=dev.player.ncm state=0 pos=0/0 -> ACK`，间隔 ~100ms，且全是
无变化的静止帧；launcher 每帧写 2 行日志+归并会话，SD 写放大到整机卡死。

修复：
- 新增 app/play/meta_gate.{h,c}（纯逻辑）：状态/时长/标题/歌手/专辑/封面/歌词
  标志变化 → 立即报；播放中位置偏移 ≥5s 重锚（launcher 自己按 last_active 外推）；
  心跳播放中 5s / 非播放 30s；硬下限 250ms（任何路径 ≤4 帧/秒）；时钟回退不下溢；
  字符串按发送侧截断长度比较（超长标题不得恒判「变了」）。
- ipc_media.send_meta 改为「组快照 → 闸判定 → 才发」，删除 1s 定时器；
  时间改 ncm_monotonic_ms()；首帧仍必发（注册媒体源）；发送走 DEBUG 日志。
 2026-11-05 13:00:28 +08:00
AskaEth 35a636ef42 fix(ncm): 离线重试改单调钟节奏闸，断网不再每个 tick 重试（M10） 
根因（真机日志 19000100_000000_7534.log）：meow_ui_time_ms() 在设备上返回坏值——
低 32 位是「开机秒数×1000」（无毫秒），高 32 位每次调用随机（REPORT §42）。
旧守卫 `!g_home_thr_on && (!g_offline_retry_ms || now - g_offline_retry_ms >= 30000)`
因此恒真：worker 一收工，下一个 tick 立刻再重试；真机 74s 内 10 次
（间隔 5-7s 只是失败请求本身的连接超时）。第二条链是 else 分支清零重试时刻，
online/offline 一抖动就再试。

修复：
- 新增 app/logic/retry_ctl.{h,c}：节奏闸只做差值，时钟由调用方给可信单调钟
  （home.c 改传 core 的 ncm_monotonic_ms()）；回退不下溢（重定基准、不重试）；
  busy 单飞；在线/离线抖动不重置基准；首次进离线立即探测一次，之后严格 ≥30s。
- home_tick 不再使用入参 now（真机坏值无效化）；新增 home_retry_reset()。
- 静默重试不再走完整 home_reload：新增 home_reload_ex(silent) 不预读盘
  （旧实现每轮在 UI 线程同步读 playlists.bin）、home_apply_ex(keep_scroll)
  保留滚动位置、worker 记 g_home_changed 决定是否需要重绘——旧实现每轮
  home_apply() 复位滚动+整帧重绘，是「歌单列表滑动特别卡」的直接来源。
- worker 线程 pthread_detach（旧代码每轮泄漏线程栈）。
 2026-11-05 13:00:24 +08:00
AskaEth aa225a1973 tower: snapshot of uncommitted base checkout changes (worktree wt-10) 2026-11-05 12:47:10 +08:00
AskaEth 61ef0f6de9 Merge branch 'feat/ncm-offline-session-keep' 2026-11-05 12:01:33 +08:00
AskaEth 31879f3302 fix(ncm): 缓存命中改单请求出参，移除全局命中计数（评审 P2-2/P2-1） 
问题（P2-2）：离线判定用 `ncm_apicache_hits()` 前后差值判「本次是否缓存命中」——
①其它 worker 的命中会污染差值 → 误判「已回在线」；②盘缓存分支的 g_hits++ 在 g_mu 锁外，
跨线程自增/64 位读存在竞争与撕裂可能。

修法（出参方案）：
- `api_post_cached(..., int *from_cache)`：命中置 1（未走网络），miss/失败为 0；
  四个调用点显式传参。
- 新增 `ncm_api_user_playlist_ex(..., int *out_from_cache)`；out_n 与原接口一致**必填**
  （NULL→NCM_ERR_ARG，修入口容忍 NULL、成功路径却无条件解引用的契约不一致，评审 P2-1）；
  out_from_cache 可 NULL。旧 `ncm_api_user_playlist` 为薄包装（调用方零改动）。
- `appstate_load_playlists_ex` 透传该标志；home_worker 用本次请求的 from_cache 判定是否
  回在线；歌单页只在失败时同步离线态（成功可能是缓存命中，不据此清离线）。
- 删除 `ncm_apicache_hits()`/g_hits（无使用者，同时消除数据竞争）；盘缓存命中分支两行
  合并为一行（行为不变，重构）。
- 测试：session_gate_sim 新增 D2 五例（miss→0 且真网络 +1 次 / 命中→1 且 0 请求 /
  失败→0 / 兼容入口不崩 / out_n 必填契约）；playlist_race_sim、plpage_sim 补 `_ex` 桩。

验证：session_gate_sim 88 PASS/0 FAIL；test_ncm_core_host 139 PASS/0 FAIL；
http_truncate_sim 13 PASS/0 FAIL；核心 13 TU（-Wall -Wextra）0 warning。
 2026-11-05 11:59:33 +08:00
AskaEth b1d607d43f fix(ncm): http_ret_norm 保留 NCM_ERR_JSON（评审 P2-1：畸形分块不再误报断网） 
问题：http_run 在 body_feed 失败时返回 NCM_ERR_JSON（畸形 chunk 尺寸/帧体），
但 http_ret_norm 的白名单漏了它，落到 default 被改判 NCM_ERR_NET → 上层按网络类
进离线模式，明明是数据/协议错误却误报「网络不可用」，也会误导离线恢复重试。

修法：白名单补 NCM_ERR_JSON（已属 NCM 错误码的一律原样返回），并把「不得改判」
写进函数注释。测试：http_truncate_sim 新增畸形分块用例（chunk 尺寸行 "ZZ"），
期望 NCM_ERR_JSON；修前该用例会得到 -4。

验证：http_truncate_sim 13 PASS（原 8 截断 + 4 传输归一 + 1 本用例）。
 2026-11-05 11:54:23 +08:00
AskaEth 2ca386973b test(ncm): M9 分类/登录门宿主单测（83 断言）+ 传输层归一 4 例 + REPORT §41 
- bench/session_gate_sim.c（新）：真实 core + ncm_http_request 桩，覆盖
  A 错误分类矩阵（-4/-5/-6/-17/裸 mbedtls vs -13/其它）、B HTTP 状态矩阵
  （401/403 vs 5xx/429 vs 3xx/4xx）、C 登录门 + 启动决策（无网→离线、无会话→扫码）、
  D 真实 ncm_api 状态/业务码映射（含 -460→SVC、301/302→AUTH）、
  E 真实 ncm_login_status_check/refresh 映射、F 会话密钥稳定性（换 MAC 仍可解、
  旧 MAC 密文可解且自动迁移）。83 PASS / 0 FAIL，0 真实请求。
- bench/http_truncate_sim.c：追加 4 例传输层归一（握手 fatal alert→NET、握手超时→TIMEOUT、
  读 fatal alert→NET、CA 失败→TLS），原 8 例截断守卫零回归（12 PASS）。
- build_ncm_sims.sh：window/search/plpage/apicache/cookie_refresh 链入 ncm_session.o
  （appstate/api/login 新依赖），新增 session_gate_sim 构建与运行。
- test_ncm_core.c：采用 M8 分支的 $TMPDIR 适配（Termux /tmp 不可写；合并时以 M8 为准）。
- 相关 sim 头注释同步链接命令（ncm_apicache.o/ncm_session.o）。
- REPORT §41：判定点调用链与行号、根因证据、实现、验证矩阵与诚实出入
  （mipsel/真机未跑；app.c 宿主不可编译的既有原因；403/-460 取舍）。

验证：test_ncm_core_host 139 PASS/0 FAIL；session_gate_sim 83 PASS；
http_truncate_sim 12 PASS；window/search/apicache/cookie_refresh sim 通过；
核心 12 TU + 应用 13 TU（-Wall -Wextra）0 warning。
 2026-11-05 11:45:44 +08:00
AskaEth e0bd503261 fix(ncm): 会话密钥改用设备私有 .mkey，网卡/MAC 变化不再丢登录态（M9 启动无网根因） 
根因（代码级）：会话 cookie 加密密钥 = sha256(首选网卡 MAC + 盐)，MAC 取自
/sys/class/net 首个非 lo 网卡。设备断网时 Wi-Fi 网卡可能从 /sys/class/net 消失，
或 readdir 顺序变化选到另一块网卡 → 派生密钥改变 → session.enc 解不开 →
ncm_ctx_load_cookie 失败 → cookie 为空 → g_st.logged_in=0 → 启动直接进扫码页。
这与「把网络不可达当登录过期」是同一症状的另一条路径，且发生在登录门之前。

改动：
- 新密钥优先 <data_dir>/.mkey（32B 随机，首次生成后稳定，与网络状态无关）；
  .mkey 不可写（只读 FS/无权限）才回退旧 MAC 派生，保持极端环境可启动。
- 旧版 MAC 派生密文仍可解（cookie_decrypt_sel 二次尝试）；load_session 命中旧密钥时
  自动重写为 .mkey 密钥（透明迁移，不改调用方）。
- ncm_store.h 同步说明：machine_key 仅作旧密文兼容，新写入不再使用。
 2026-11-05 11:45:20 +08:00
AskaEth 707bbd8a02 feat(ncm): 断网保持登录态 + 离线模式（可见提示/缓存可播/联网自动回在线）（M9） 
用户报告：「一断网就退出到扫码登录界面，不会保持账号态切离线，缓存列表形同虚设」。
上一条已把失败分成 NETWORK/AUTH；本条把结论落到 App 状态与 UI。

- 会话状态机（appstate.c）：只有 NCM_ERR_AUTH（401/403/301/302）清 cookie；网络类失败
  （不可达/超时/TLS/5xx/-460）只置 g_st.offline，账号态与 session.enc 一律保留；
  appstate_ensure_uid 同语义（原先任何 AUTH 都清 cookie，网络故障不得进入该分支）。
- 启动（app.c）：根页改由 ncm_session_boot_decide 决定——有本地会话就进 home（无网也是），
  只有无本地会话才进扫码；打印 boot 决策日志。
- 离线 UX：首页个人卡「离线模式」红标 + 页脚提示 + 空态「离线模式/可播放已缓存」；
  歌单页/搜索页/播放页/缓存页分别给出离线文案（缓存页点播照旧走 NCM_QUEUE_CACHE，本地可播）。
- 恢复：home 可见时每 30s 静默重试一次（强制绕过接口缓存，成功即回在线并重绘）；
  任何真实网络成功（home/playlist worker）也会清离线态。
- 防误判：接口缓存命中（120s 旧响应）不算「回在线」——home_worker 用
  ncm_apicache_hits() 差分识别，避免离线提示被缓存命中闪掉。
 2026-11-05 11:45:20 +08:00
AskaEth 8557da6fca feat(ncm): 失败分类 + 登录门决策核心（M9：断网不再被当会话过期） 
根因：传输层/服务端暂不可用与鉴权失败共用「负错误码」一个通道，登录门只能按
NCM_ERR_AUTH 判断，任何上游映射偏差都会变成「退出登录」：
- ncm_login.c 把任何业务码 !=200（含 -460 风控）都当 AUTH；ncm_api.c 把 -460 也映射 AUTH；
- api/login 层完全不看 HTTP 状态：401/403 与 5xx/网关 HTML 都落进 JSON/缺字段分支，
  反过来 5xx 与网络故障无法区分；
- http 层握手/写入失败把 mbedtls 裸负码（如 -0x7280）直接返回，上层按 NCM_ERR_* 比不中。

改动：
- core/ncm_session.{h,c}（新）：ncm_err_classify / ncm_err_is_network /
  ncm_http_status_class|err / ncm_gate_decide / ncm_session_boot_decide。
  语义：NETWORK={NET,TLS,TIMEOUT,SVC,历史裸码}；AUTH 仅 NCM_ERR_AUTH；
  401/403→AUTH，408/425/429/5xx→SVC，其它非 2xx→HTTP；启动时有本地会话就先信它
  （无网→离线进 home，绝不进扫码）。
- NCM_ERR_SVC=-17（服务端 5xx/429、业务码 -460：暂不可用、可重试，不是登录失效）。
- ncm_http.c：http_ret_norm 在 done: 统一归一（超时/证书/其它→NET），裸 mbedtls 码不再穿透。
- ncm_api.c：api_status_gate 先按 HTTP 状态定性再解析 body；业务码加 302→AUTH、-460→SVC。
- ncm_login.c：status_check/refresh 先过状态门；301/302→AUTH、-460→SVC、其它非 200→HTTP
  （不再因一次未知响应把用户踢回扫码）。
- ncm_apicache：新增命中计数，供 App 区分「真网络成功」与「离线读到旧缓存」。
- build_core.sh / build_ncm.sh：核心源列表加 ncm_session.c。
 2026-11-05 11:45:20 +08:00
AskaEth 03868d048a Merge branch 'feat/ncm-crossbuild-hotupdate' 2026-11-05 11:36:56 +08:00
AskaEth 7d4906828d build(ncm): 宿主交叉适配层 + 全量测试补跑（M8） 
- 新增 build_ncm_cross_host.sh：同构 HOME 复用容器脚本，串起 sdk/vendor/host-mbedtls/core/tests/ncm
- libs_common.sh 工具链路径改为 MEOW_R3PROII_ROOT/$HOME 可覆盖，容器默认不变
- build_mbedtls.sh 递归清理 library/ 与 3rdparty/ 旧对象，修宿主/mipsel 混架构归档
- test_ncm_core.c 改用 $TMPDIR，Termux /tmp 不可写不再导致 store/cache/tag 用例失败
- REPORT §40：构建/测试/热更结果（ncm md5 1bbd2a55…，Music du 前后恒定）
 2026-11-05 11:34:45 +08:00
AskaEth 2c69070cc4 Merge branch 'feat/ncm-cache-filename-actual-level' 2026-11-04 21:11:04 +08:00
AskaEth e60642217a test(ncm): M6 缓存命名宿主单测（63 PASS）+ core 全量用例 + REPORT §39 
- 新增 test/test_ncm_cache.c + build_ncm_cache_host.sh（纯 libc：真实 ncm_cache.c +
  ncm_tag.c，仅桩 strlcpy/mkdir_p/档位映射，不依赖 vendor/mbedtls）
- 覆盖：实际档映射、降级后写入名、hires 命中已存 exhigh/lossless、低档不命中高档、
  旧命名命中/扫描/删除/双点名迁移、列表去重、LRU/清空/删除兼容、level_from_path 边界
- test_ncm_core.c 新增 test_cache_actual_naming（接入 core 全量测试集，同语义断言）
- REPORT §39：命名/命中/兼容方案、质量取舍与未执行项（vendor/交叉/真机）
 2026-11-04 21:11:00 +08:00
AskaEth 68833cf642 feat(ncm): 下载落盘名用响应实际档 + 命中按文件名标实际档（M6 播放链路） 
- song_download_attempt：URL/类型确定后算实际档，.part/open/commit 统一用实际档键
  （hires 请求被降级为 320k mp3 → song_<id>_exhigh.mp3），eff_level=实际档
- song_local_file：命中路径由 ncm_cache_level_from_path 取文件名档位并按容器钳顶
  （mp3 永不高于极高），旧 hires.mp3 正确显示「极高」
- 移除旧「stale-degraded 改名+强制重下」与「无档位键迁移」：老卡文件读可用、不迁移
- player_flow_sim 适配：补实际档/路径档位桩与 M5 链接桩；P7/P12 期望键改实际档，
  P13 改为旧命名命中即播、不重下不迁移
 2026-11-04 21:11:00 +08:00
AskaEth 30ffe469c8 feat(ncm): 缓存实际档判定/文件名解析 + 查找档位下探（M6 core） 
- ncm_cache_actual_level：请求档 + 容器/码率/位深 + 响应生效档 → 实际档（只降不升），
  作为写盘名/播放显示/已缓存列表的唯一事实源
- ncm_cache_level_from_path：文件名档位段解析（song_<id>_<档位>，含 sky_c51）
- ncm_cache_lookup：请求档精确 miss 后按实际档逐档下探（hires 命中已存 exhigh/lossless），
  只降不升，低档请求不命中高档实体
- ncm_cache_scan：actual_level 改用统一判定；同曲同实际档的旧名+新名去重展示
 2026-11-04 21:11:00 +08:00
AskaEth 132622cbc1 Merge branch 'feat/launcher-bg-kill-button-dead' 2026-11-04 21:00:45 +08:00
AskaEth 6b52740ff1 fix: 后台页杀按钮点不动 — app.json framework=1 被误当「不可杀」门控 + am kill 无前台会话不可执行 
根因（2026-11-04 真机 dev.player.ncm pid=7520）：
- bg_page.c bgm_app_meta 把 app.json 的 framework 字段映射进 bgmgr_row.framework，而
  bgmgr_can_kill 把它当「系统/框架 App 禁止 kill」。但 framework=1 在 MeowOS 里意为「用
  meow_ui.a 的 SDK 框架 App」（docs/APP_DEV_GUIDE.md §9，推荐值，真机 4 个 App 全写 1）
  → 后台页每行「杀」按钮被置灰，bgm_row_tap 命中后直接 return 1、不调 meow_bg_terminate；
  「一键清除后台」同理 0 行可杀。整条链路无日志，故只能靠翻 app.json 才定位（全部设备日志里
  "后台管理页终止后台App" 出现 0 次 = 4 次进页从未真正杀过）。
- 面板 killfg 正常是因为走 am kill → amsd → MSG_AMS_KILL，无 framework 门控；但它其实靠
  amsd 1200ms×2 超时兜底 kill(pid,SIGTERM) 才杀成：util.c 原本在无前台 App 会话时只回
  ACK -2（(uint32_t)MEOW_ERR_NOENT），ACK 及时到达时 amsd 判「launcher refused」完全不杀
  （ams_20260915_031339.log 实证），ACK 迟到才侥幸成功（2026-11-04 真机）。

修复：
- meow_bgmgr: 门控位 framework → protected_app（系统级受保护标记；当前无 App 置位，launcher
  自身组件本就不在 App 表/后台表内）。bg_page 不再把 a->framework 送进门控。
- bg_page: 行副文本改存 ctx 持久缓冲（原 rbuf[].sub 指向 bgm_rows 栈帧 → 悬垂，副标题乱码）；
  门控拒绝/未命中后台表各留一行 logmsg，「点了没反应」从此可查。
- util.c MSG_AMS_KILL: 先查后台保活表 → meow_bg_terminate 就地走真退序列（与页面「杀」按钮
  同一通道，故 am kill 与页面按钮行为对称），无前台会话也能杀；否则仍走 pending / ACK -2。
- amsd cmd_kill/cmd_start: ipc 失败原因细分（connect failed / timeout, no reply / ...），日志
  不再笼统写 "launcher offline"（响应串保留该字样，MeowPanel api_ams_ctl 依此映射 503）。
- meow_bgplay: meow_bg_terminate 注释/日志写明「后台管理页 / am kill」双入口同通道。

测试（宿主 gcc，产物在 $TMPDIR）：
- test_bgpage 40 checks：新增 framework=1 仍判可杀且按钮真 terminate（本 bug 回归）、
  受保护行按钮不杀但留诊断日志、sub 持久化 + 栈抖动不变（悬垂回归）。
- test_bgmgr 30 checks：protected_app 门控矩阵 + framework=1 可杀回归。
- test_bgplay 92 PASS：新增 4b meow_bg_terminate 全链路（受理→term_at_ms→tick SIGTERM→
  on_bg_dead→清槽；空/不在表分别 INVAL/NOENT）；TEST_SVC_PATH 改取 $TMPDIR
  （Termux 无 /tmp，原 fputs(NULL) 直接 abort）。
- amsd 宿主集成（fake launcher 桩，4 例）：ACK 0→terminate 且不盲杀；ACK -2→refused 不盲杀；
  无 launcher→direct SIGTERM (connect failed)；挂起不回→direct SIGTERM (timeout, no reply)。
0warning：util.c 与 main 同告警逐行一致（仅 SDK 头既有 typedef 重定义），其余文件干净。
 2026-11-04 21:00:40 +08:00
AskaEth a73bcb9841 Merge branch 'feat/ncm-cached-list-and-tag-embed' 2026-11-04 20:49:36 +08:00
AskaEth a9c94c7221 fix(ncm): tag 嵌入按实际容器拒绝 MP4/M4A（ID3v2 前缀会破坏 MP4 容器） 
download 扩展名在 type 非 flac 时一律落 mp3；若服务端降级返回 MP4/M4A（"....ftyp"），
给文件加 ID3v2 头会破坏容器。ncm_tag_embed_file 现读 12 字节 magic：fLaC → VORBIS_COMMENT，
"ftyp" → NCM_ERR_ARG 拒绝（调用方 commit 裸流），其余按 MP3 处理。
test_ncm_tag 增 2 条断言（拒绝 + 原文件不变）→ 53 PASS / 0 FAIL，0 warning。
 2026-11-04 20:49:25 +08:00
AskaEth 39465ea1ef feat(ncm): 新写入的缓存文件嵌入歌曲元数据（FLAC/MP3，commit 前流式重写，失败降级裸流） 
用户需求：保留元数据分离的同时把歌曲元数据嵌进缓存文件（否则外部播放器读不到任何信息）。
- 接入点 player_manager：下载完整（dl_rc==OK）→ stream_src_finish（读端先自然收尾）→
  ncm_tag_embed_file(.tmp, 实际扩展名, {name/art_name/album_name}) → dispose join 之后才
  commit。tag 重写是同目录 .tag.tmp + rename 换 inode，解码端全程持旧 fd，播放/seek/
  .part 续传字节语义零改动。
- 容器按实际 magic 分支（ncm_tag.c）；峰值内存 64KB；失败只记 WARN、commit 裸流，
  播放主链路不受影响（用户红线）。
- 元数据分离体系不动：<cache_dir>/meta/<id>.bin 旁路照旧写读；LRU 只 stat 文件，
  无 size/etag 索引需回填（重写后 stat 自然一致）。
- test_ncm_core 新增 test_cache_tag：writer 写裸流 → 嵌入 ID3v2.3 / VORBIS_COMMENT →
  读回 → ncm_cache_scan（hires 名 + 320k mp3 体 → 实际档 EXHIGH，名称来自文件内 tag）
  → ncm_cache_remove → ncm_cache_clear。
- REPORT §38：设计/内存估算/验证/诚实遗留（本机缺 vendor 与交叉工具链，未跑整链与真机）。
 2026-11-04 20:49:25 +08:00
AskaEth f392ee5c48 feat(ncm): 首页顶栏「已缓存」入口 + 已缓存列表页（歌名/歌手/实际档位/大小，点播/单曲删除/清空） 
入口：首页 topbar 新增动作 3（MEOW_ICON_DOWNLOAD 位图，原「回播放页」顺延动作 4）→
push ACT_CACHE；左缘返回弹回首页（app.c 路由补齐 tap/swipe/touch/tick）。

列表页 app/ui/cache.c（对齐 queue.c 惯例：圆角卡/红 mini-vinyl/按压红条/当前播放行高亮）：
- 行 = 歌名 / 歌手 · 实际档位 · 大小；空态/页脚（N 首 · 合计 X MB）。
- 点行 = 点播（NCM_QUEUE_CACHE 队列，上/下一首在缓存列表内循环）；行右「删除」=单曲删除；
  顶栏「清空」=确认框 + ncm_cache_clear（与设置页「清理缓存」同语义）。
- 数据全在 worker：cache_reload → appstate_cache_list_load → ncm_cache_scan（读目录 +
  文件内 tag + 音频头探测）→ 快照；UI 线程零磁盘 IO。快照上限 512 条（最近访问优先，
  ≈116KB bss），更多条目按 mtime 保留最近的。

core：
- ncm_cache_scan / ncm_cache_remove（songs/ 池，song_<id>_<请求档>.<实际格式> 解析，
  跳过 .tmp/.part 与非数字 id；按 mtime 降序；历史双点名删除兜底）。
- ncm_api_level_from_key（缓存键后缀 ↔ 档位枚举，与 ncm_api_level_key 互逆）。
- **档位显示实际档而非请求档**：真机存在 song_171650_hires.mp3（无损请求被降级链落到
  exhigh mp3），故 scan 用 ncm_audio_probe_file 读实际容器参数后只降不升地推断
  （FLAC 16bit→无损 / 24bit→Hi-Res+，MP3 ≤128k→标准 / >128k→极高）。

播放：player_manager 对 NCM_QUEUE_CACHE 用条目真实键（id+请求档+实际扩展名）直读缓存
文件，不按用户当前档键重下；song_local_file/play_is_same_song/queue 页均支持第三种队列。
宿主 mock（NCM_PAGE=cache）造 3 条缓存 + 嵌入 tag + 同步扫描。
 2026-11-04 20:49:25 +08:00
AskaEth 184ebd0ac9 feat(ncm): 缓存文件内嵌元数据模块 ncm_tag（FLAC VORBIS_COMMENT / MP3 ID3v2.3 写读 + 音频头探测） 
core/ncm_tag.c/.h（纯 libc，宿主可单测，不依赖 mbedtls/jsmn）：
- FLAC：在元数据末块之后插入 VORBIS_COMMENT（TITLE/ARTIST/ALBUM），旧 VORBIS_COMMENT
  替换、PADDING/PICTURE 原样保留；MP3：ID3v2.3 TIT2/TPE1/TALB（UTF-16LE+BOM，中英文
  与 emoji 均可），源已带 ID3v2 时先剥旧标签（不留双标签）。
- **按实际容器分支**（读 fLaC 魔数）：缓存名档位段是请求档，真机存在
  song_<id>_hires.mp3（无损请求被降级链落到 exhigh mp3），不能按名字判容器。
- 写入 = 同目录 <path>.tag.tmp + 64KB 分块搬运 + fsync + rename 原子替换；任一步失败
  即 unlink 临时件、原文件保持不变（调用方 commit 裸流降级），峰值内存 64KB。
- ncm_audio_probe_file：只读文件头探测实际容器/位深/码率（FLAC STREAMINFO / MP3 首帧），
  「已缓存列表」据此显示实际档位而非请求档。
- test/test_ncm_tag.c + build_ncm_tag_host.sh：FLAC/MP3 构建+读回、中文 roundtrip、
  旧标签替换、容器判定、3MB 分块、失败降级、探测 —— 51 断言全过，0 warning。
 2026-11-04 20:49:25 +08:00
AskaEth e56c837f4f Merge branch 'feat/sdk-cross-build-bring-up' 2026-11-04 20:26:22 +08:00
AskaEth 8be4634a61 feat(sdk): 本机 zig 交叉链跑通 build_sdk.sh — 新增 build_sdk_host.sh 环境适配+成员/架构自检 
主仓 patch_v2/sdk/build_sdk.sh 此前只在 SDK 仓验证过：硬编码 ROOT="$HOME/Project/R3ProII"
取 .tools/zig-mipsel-cc 与 patch_v2/meow_launcherd/meow_font.a，默认 AR=/usr/bin/ar、
mktemp 落 /tmp。Termux 上三者都不成立（工具链在 ~/.tools、meow_font.a 在仓库内且 *.a 被
gitignore、ar 在 $PREFIX/bin、/tmp 不可写），脚本无法直接跑通。

- build_sdk_host.sh: 不改 build_sdk.sh，临时布局同构 $HOME（.tools 与 patch_v2/
  meow_launcherd 符号链接到真实位置），导出 AR/TMPDIR 后原样执行脚本；--verify 追加
  「成员清单 = 本次 *.o（OBJS + meow_font.o）+ libfreetype.a 对象」比对与全量架构校验
  （不复制 OBJS 列表，避免与 build_sdk.sh 漂移）
- FreeType 2.14.3 源: SDK_FREETYPE_SRC 指向本地源优先；未设且无 vendor 时仍走 savannah 下载
- 验证: 冷构建(zig cache 空) 55s，重编 11-14s；meow_ui.a 5,701,866B / 75 成员
  （OBJS 31 + meow_font.o + freetype 43），全 ELF32 MIPS32 rel2 o32；hello_app 按文档链路
  meow_ui.a + libz.a + -lpthread 链接成功(474,612B 静态 MIPS32r2)，不调 meow_ft_* 时
  freetype 成员未被拉入(零增量成立)
- 产物不入库: vendor/、*.a、*.o 均被 .gitignore 覆盖，git status 仅本脚本
 2026-11-04 20:25:54 +08:00
AskaEth 47c638d65b Merge branch 'feat/m6445-web-license-residual-sync' 2026-11-04 20:14:16 +08:00
AskaEth 20f4727714 feat: M6.44+M6.45 现场补全 — 补齐按扩展名过滤遗漏的 web 前端与 license 合规件 
真机 0.8.45 现场组成补全（初次提现场按扩展名过滤漏掉 7 个文本文件），
内容逐字节取自容器现场 /mnt/mb/home/Aska/Project/R3ProII 并 md5 对拍一致：

- patch_v2/meowpanel/web/meowpanel.css          (+17)  趋势/App 详情卡样式
- patch_v2/meowpanel/web/mp_pages.js            (+289) 性能趋势/功耗曲线/App 详情/蓝牙详情
- patch_v2/meowpanel/web/mp_shared.js           (+49)  趋势 sparkline 通用逻辑
- patch_v2/reader_app/.gitignore                (+2)   seg/chapter smoke host
- patch_v2/reader_app/NOTICE                    (+23)  FreeType 2.14.3 + zlib 条目
- patch_v2/reader_app/resources/licenses/NOTICE (+23)  同 reader_app/NOTICE（md5 一致）
- patch_v2/reader_app/resources/licenses/FTL.txt (新增 6743B) FreeType 许可证全文

面板前端对应已收编的后端 mp_files.c/mp_net.c（文件搜索+蓝牙详情），
NOTICE/FTL.txt 为 LGPL/FreeType 合规产物。仅投运现场内容，未改内容。
 2026-11-04 20:10:42 +08:00
AskaEth 2ffb92c038 Merge branch 'feat/m6445-dirty-snapshot-consolidation' 2026-11-04 20:09:20 +08:00
AskaEth 7c7d891570 feat: M6.44+M6.45 收编 — 真机 0.8.45 现场保全(reader章节/key_router按键路由/WiFi连接修复/ncm bench+IME修复) 
脏工作区现场收编：devdocs/local/m6_44_45_dirty_tracked.patch(46 个已跟踪文本文件,
+3090/-585, 已对 M6.43 基线干净适配) + m6_44_45_untracked_src.tar.gz 中 patch_v2/ 下
13 个新增源文件, 合成单个提交, 内容与容器工作树(R3ProII/patch_v2)逐字节一致。

- reader 章节: 新增 core/rdchapter.{h,c} — TXT 章节规范解析器, 扫描 512KB 码位对齐段文件
  逐段流式识别标题行(行首缩进≤4/显示宽≤40/行内标点≤1 三重约束防误判), 输出标题+全书字符
  偏移+段号/段内偏移+阿拉伯章号(中文数字归一), 首章前内容归"卷首"; book/reader/rdenc/
  rdlayout/settings 接入章节跳转与进度锚点, 附 chapter_smoke/turn_repro/build_turn_repro.sh
- key_router 按键路由: 新增 meow_launcherd/key_router.{h,c} — launcher-UI 页物理键统一路由
  (P1 仅音量键), 把读取边沿+防抖+长按 held+ramp 推进从 5 个会话收敛为进程内单开;
  各页每圈 key_router_pump() 取防抖后边沿, 动作(调音量/光标导航)仍由调用页决定,
  保留 run_menu 的 meow_mode 分支; App 前台 volume_page 武装时边沿抑制;
  main_menu/now_playing/notif_center/settings_page/subpage 接入, 附 test_key_router_vol/test_np_keys
- WiFi 连接修复: meow_netmgrd connect 有界等待 wpa_state=COMPLETED(普通 10s/隐藏网络 15s,
  env 可调)修设置页连接无响应; list_networks/scan_results 的 \xNN 转义还原始字节, 修中文 SSID
  永不命中致新建同名 open 记录顶影; launcher netmgr_ipc 配读超时; 附 test_wifi_connect(桩
  wpa_cli 驱动 static wifi_connect_ex), test_netmgrd.sh 补用例; wifi_page 同步
- ncm bench: 新增 bench/lyric_sim.c、bench/plpage_sim.c, vol_sync_sim 与 ncm core/app 同步
- SDK IME 修复: shift 大小写、K_ENTER 只提交不关、阻塞 IME 循环喂 on_tick 不被遮挡、
  IME 打开 ~200ms TAP 冷却窗吞 stray-TAP; 附 sdk/test_ime_fix.c
- 同期: meow_audiod 音量异步 ACK 线程(代际防 fd/槽复用竞态)、watchdog 音量收编(首选 audiod
  权威, settings.conf 覆盖路径)、panel 文件搜索(F1-④)与蓝牙只读详情(F1-③)、各类 build 脚本同步

范围红线: third_party/legado-E-main 原开发者未跟踪, 本次不入库(保留 devdocs/local tar 参考);
二进制不入库(后续重编); devdocs/ 不入库。59 文件全部在 patch_v2/ 下, 无 third_party/devdocs。
验证: git apply --check 干净; 59 文件 md5 与容器 patch_v2 逐一比对 59/59 一致(含
key_router.c/rdchapter.c/meow_ui_ime.c/test_wifi_connect.c 抽查); 可执行位保守
(check_lgpl_release.sh 100755, build_turn_repro.sh 100644 与容器一致)。
 2026-11-04 20:02:28 +08:00