AskaEth/MeowOS-For-R3P2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
388 Commits 1 Branch 0 Tags
2cfac55b4e990af44e764ef88df47a84aa92b796
Commit Graph
388 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
AskaEth 2cfac55b4e Merge branch 'feat/m22-boot-logo-and-brightness-init-script' 2026-11-05 22:04:56 +08:00
AskaEth f9c2ea42a4 fix(boot): M21 r1 评审 P1 — bl_cap 把 cur=0 当「无有效值」照写 20（+P2 两处） 
P1 根因（评审给的真机驱动证据链，已按其最小修法改）：
  /module_driver/pwm_backlight.sh 是 `insmod pwm_backlight.ko ... default_brightness=0
  max_brightness=101`，模块 init 把 props.brightness 置 0 再 update_status（PWM 0 分支）→ 上电即灭屏；
  该模块由 S11module_driver_default 加载，rcS 自然序排在 S11jpeg_display_shell 之后。于是：
    - 函数入口那次 bl_cap：背光节点还不存在，写必然失败（no-op）；
    - fb0 出现后画图前那次 bl_cap：读到 cur=0，旧条件 `cur <= cap` 命中「只降不升」跳过分支，
      20 从未写入 → 画图时刻亮度 0。
  物理后果两头都是缺陷：面板仍亮则 logo 依旧亮（原问题没修）；面板灭则 S11~S21 无可见 logo，
  settings.conf 缺失时直到 launcherd 才亮屏（相对 stock「0.1s 后写 60」是回归）。

修改：
  - bl_cap 判定改为「仅 1 <= cur <= cap 才视为已有有效值跳过；0 / 空 / 非数字一律照写」。
    S22 抢写 1 的竞态保护不变（1 落在 1..20 → 仍跳过，不会被顶回 20）。
  - 删掉函数入口那次 bl_cap（节点未建，必然 no-op，且是重定向报错的来源）；只保留 fb0 就绪后、
    画 logo 前那一次 —— 同一驱动脚本里 pwm_backlight.ko 先于 soc_fb.ko 加载，fb0 出现即节点就绪。
  - 写入成功时打一行 `backlight: -> 20 (was N)` 便于刷机后复核；`2>/dev/null` 移到 `>` 之前，
    节点未就绪时连重定向报错一起吞掉（P2-1）。
  - S22：失败路径日志由「保持 S11 低亮度」改为「不改背光（当前 brightness=N）」（P2-2）；写入失败
    日志同样附当前读数；写入处的 2>/dev/null 次序一并改正。
  - 头部注释按时序真相重写（驱动默认 0 = 灭屏，不是「上电很亮」）。

实测（沙箱重写 sysfs 路径 + stub cmd_jpeg_display/nanddump/sleep，dash 与 busybox 各一遍）：
  cur=0 → 画图时刻 20、结束 20（修复前 0/0）；cur=1 → 1/1；cur=60、cur=101 → 20/20；
  竞态（fb0 就绪前外部写 1）→ 画图时刻 1、结束 1（未被顶回）；节点不可写时 stderr 0 行、仍画图、rc=0。
  S22 19 用例全 rc=0（仅 usage rc=1，rcS 不可达）、sleep 调用 0、行为与改文案前一致。

S11 与 S22 内容均变 → fw_content.conf 两条 md5 同步更新为
  3ad33301fb9f0884102a47e17a1985ed / 1a0aa33d6f806f3f1648168cc1d8b953
（未改动 meow_watchdog 那条：main tip dfde95b 仍是 553840cd，与本单无关，已在报告中提示。）
 2026-11-05 22:04:16 +08:00
AskaEth 0ab23161b6 fix(boot): M21 开机 logo 亮度 — S11 画前压到 <=20 + 新增 S22brightness 按用户设置恢复 
冷启动 logo 很亮：stock S11 是画完 logo 之后才写死 60，画图那一刻用的是面板上电默认高亮；
而 S11 早于 S21mount_ubifs，那时 /usr/data 未挂载、读不到 settings.conf，只能写死一个值。

- S11jpeg_display_shell：以基线(249220f2)为底，把背光压制挪到画 logo 之前（jpeg_display
  函数体内、先于 cmd_jpeg_display），值 20（只降不升：S22 已写更暗则不覆盖）；删除画完后
  写死 60 的那行；/dev/fb0 等待、mtd5 主题判定、后台 jpeg_display & 语义不变；
  主题判定 `==` 改 `=`（POSIX test，语义不变，便于宿主验证）。
- S22brightness（新）：S21mount_ubifs 之后运行，读 /usr/data/meow/settings.conf 的
  display.brightness，按 display.brightness_min 与 sysfs max_brightness clamp 后写入；
  读不到/解析失败不改背光（保持 S11 低值）、无 sleep/重试、任何运行期失败 exit 0；幂等。
- scripts/build/fw_content.conf：登记两条（S11 覆盖基线同名文件、S22 新增），md5 实算，
  说明列写清 S11 < S21mount_ubifs < S22 的顺序依赖。
- scripts/build/README.md：补「覆盖基线已有文件」语义（无条件 cp -f，不校验基线 md5、
  也不跳过已存在文件；唯一基线校验仍是 hiby_player）。

固件需整包刷机才生效，未刷机、未写设备。
 2026-11-05 22:04:16 +08:00
AskaEth 316d9d42c7 build(fw): 同步 watchdog 的 md5 到 M19 重编后的二进制 
M19 把 meow_watchdog 重编为 ad8c1f2b（首次把 M6.23 的亮屏亮度修复真正编入），但
fw_content.conf 第 32 条仍 pin 旧值 553840cd，build_fw_apps.sh 的强校验会在该条中止。
本提交只改这一行 md5 与该条说明。

注：scripts/build/ 被 .gitignore:68 忽略，而这些文件本就已跟踪，故需 git add -f。
 2026-11-05 21:54:23 +08:00
AskaEth dfde95b020 Merge branch 'feat/m20-watchdog-brightness-boot-fallback' 2026-11-05 21:41:25 +08:00
AskaEth f2551a28a2 fix(watchdog): M20 亮屏亮度不再回退固定 60（settings 读失败重试 + 未知快照语义拆分）— 重编出货二进制 
真机 0.8.46（2026-11-05 21:09 日志）复现「开机/亮屏背光跳到固定值」：
  76646 [watchdog] power: panel ON (blank 0 + brightness 60)
而 /usr/data/meow/settings.conf 是 display.brightness = 1。根因链：
- 出货 /usr/bin/meow_watchdog（md5 553840cd…，与仓库内二进制逐字节相同）是
  2026-09-01 6a4d330 编出的旧版：不含 M6.23 的 settings 读取（strings 无
  display.brightness_min，日志仍是旧格式 "brightness %d"）—— M6.23 只改了源码、
  没重编。旧版 wd_panel_on 无条件 write_brightness(wd_saved_bri>0?wd_saved_bri:60)，
  wd_saved_bri 初值 60 且该 session 未熄屏过 → 亮屏写 60，覆盖 launcher 刚设的 1。
- 源码侧同样有 60 兜底：wd_settings_brightness() fopen 失败即 -1 → 回退快照 60。

改动（patch_v2/meow_watchdog/）：
- wd_settings_brightness()：fopen 失败重试 3×10ms。覆盖 settings.conf「写 tmp+rename」
  原子替换、开机早期 /usr/data 未就绪的瞬时窗口；只在失败时发生（成功路径 0 开销），
  最坏 20ms，远小于亮屏轮询粒度 REFRESH_MS=100ms。
- 新增 wd_bri_decide() 纯函数：settings（clamp 后）→ 本次运行期真实快照 → 不写
  （面板已亮，untouched）→ 安全低亮 10（面板黑且无任何值来源）。任何路径都不再写 60。
- wd_saved_bri 初值 60 → WD_BRI_UNKNOWN(0)；wd_panel_off 只在读到正亮度时更新快照，
  读失败/被 launcher 抢先写 0 时保留上一次真实值（不再是 (br>0)?br:60）。
- panel ON/OFF 日志带 src=settings|snapshot|untouched|safe-low 与 user/saved/cur，
  真机一眼看出用的是哪一支。
- 背光路径加 MEOW_BACKLIGHT env 测试钩子（与 MEOW_SETTINGS_FILE 同款，真机无 env）。
- test_wd_fw.c 新增 21 条用例（决策 7 + settings 解析/重试 6 + panel OFF/ON 端到端 8）；
  端到端用例真的读写背光文件，复现「settings=1 → 亮屏写 1」而不是 60。
- 重编 meow_watchdog：mipsel 静态 MIPS32r2 ELF，md5 ad8c1f2b…，0 warning。

验证：./build_watchdog.sh host → 38 pass / 0 fail；交叉编译（-Os -Wall -Wextra -static）
0 warning，产物静态 MIPS32r2。
生效条件：meow_watchdog 在 squashfs /usr/bin，必须刷固件（或等价的重打包流程）才生效。
后续（不在本单 scope）：scripts/build/fw_content.conf 第 32 行仍 pin 旧 md5 553840cd…，
不更新会让 build_fw_apps.sh 的强校验失败。
 2026-11-05 21:32:27 +08:00
AskaEth bcb11e012f fix(reader): stb_image 实现改由 meow_ui.a 提供，修 M6.45 收编后的重复定义 
SDK 在 M6.45 收编 stb_image.c.o 进 meow_ui.a 后，reader 的 engine/rdimg.c 仍带
-DSTB_IMAGE_IMPLEMENTATION，链接期 stbi_* 与归档内 stb_image.o 重复定义，reader
无法重链。改为只编封装、实现取自归档；rdimg.c 用到的 stbi_info_from_memory /
stbi_load_from_memory 在归档中均已导出。
 2026-11-05 21:12:42 +08:00
AskaEth 62b3603ade merge(sdk): 回补 M19 滚动池槽泄漏修复（wrap 上下文归还 + 44 断言回归） 2026-11-05 21:00:22 +08:00
AskaEth 72c6e9889d fix(sdk): 从公开仓回补 M19 滚动池修复（free 归还 wrap 槽）+ 宿主回归 
meow_scroll_wrap 从 MEOW_SCROLL_POOL(=8) 个 wrap 上下文槽占一个，meow_scroll_free
只归还会话槽、从不归还 wrap 槽也不清 ctx.w → 进程内最多成功 wrap 8 次，之后恒 NULL。
主仓此前仍是有缺陷版本；本提交把公开 SDK 仓 c85877b 的修复按内容移植到主仓（唯一权威
源），meow_ui_scroll.c 结果与公开仓 sdk/meow_ui_scroll.c 逐字节一致，diff 仅 wrap 相关
hunk（之前两文件差异也只有这些 hunk，故无其它改动被覆盖）。

- meow_scroll 结构记 wrap_slot（create 置 -1），wrap 时写槽下标；free 按该下标清
  g_wrap_ctx[].w/lv 并归还 g_wrap_used，随后置 -1（二次 free 不触碰任何槽）。
  直接 create 的实例 wrap_slot=-1，free 不误清别人的槽。池满语义不变：8 个同时活跃时
  第 9 个 wrap 仍返回 NULL；free(NULL) 安全。
- test_meow_ui_scroll 断言 17 → 44：64 次 wrap/free（修复前 8/64、修复后 64/64）、
  free 后再 wrap、8 满 + 第 9 个 NULL + 释放其一即复用、交错 free 不串槽、直接 create
  不误清槽、list→listview→list 槽复用不残留 kind、free(NULL)/二次 free。
  头注释补 meow_ui_nav.c：原配方缺该 TU，链接期 meow_ui_nav_request_exit 未定义。

验证：LAUNCHER_DIR=主检出/patch_v2/meow_launcherd build_sdk_host.sh --verify
exit=0、0 warning/error、成员清单 76 项一致且全 MIPS32r2；宿主测试 44 pass / 0 fail；
同测试对修复前 meow_ui_scroll.c 为 13 pass / 19 fail（首条即 ok=8 first_fail=8）。
meow_ui.a 中 meow_ui_scroll.o 已变化，链 meow_ui.a 的 App 需重链。
 2026-11-05 20:59:36 +08:00
AskaEth 8d2c098deb Merge branch 'feat/files-hello-row-height-followup' 2026-11-05 20:57:43 +08:00
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