AskaEth/MeowOS-For-R3P2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
395 Commits 1 Branch 0 Tags
479d93a3bf9db9c7ecda99a8be4d749680bd466a
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
AskaEth 479d93a3bf Merge branch 'feat/m24-devkit-static-mipsel-debug-tools' 2026-11-06 20:03:08 +08:00
AskaEth adaed09f94 fix(devkit): M24 r2 评审 — 交付完整性闸门 + 补 sysctl + time64 文档更正 
P2-1（与 P1 同类）：licenses/ 与 README 缺失仍会假成功。
- 新增 meta_complete()/verify_meta()：MANIFEST + README + 五份许可证副本
  （procps COPYING/COPYING.LIB、ncurses、lsof、musl-COPYRIGHT）缺一即不完整
- 纳入 skip 条件与 --verify-only；产物未变但 meta 缺失时就地 write_meta 补全（不重编），
  构建树不在则退回全量重建
- 回归测试新增 T6（删 licenses 后 --with-sources 必须恢复）、T7（--verify-only 必须拒绝）、
  T8（删 README 后恢复）；共 20 项全过

P2-2：README.txt/MANIFEST.txt 的卡上路径全错（写成 ../src、scripts/build/…）。
- 全部改为卡内相对路径：src/、licenses/、MANIFEST.txt、src/DEVKIT.md、src/build_devkit.sh
- README 增加「目录内容」段并注明 src/ 是生成目录、勿手放文件

P2-3：valgrind 的排除理由（“无 MIPS32 后端”）是错的 —— 官方支持 MIPS32/Linux。
- 改为「未尝试」：交叉构建需 autotools + 目标 vDSO 细节、产物 10MB+，56MB 单核不实用

P2-4：busybox 1.31 实测有 pgrep/kill/killall，没有 pkill、没有 sysctl。
- 表格改准确；pgrep 保留（增量有限不交付）；pkill 写明「busybox 无此 applet，
  killall 只能部分替代，本轮未做」
- 新增交付 sysctl（procps 4.0.4，148184 B，静态）：MANIFEST/verify-only/真机
  （sysctl -a 428 键、kernel.hostname/panic 读取、-n）均已验证

P2-5：free -s <小数> 也受 time64 影响（usleep 亚秒被抹平），文档说反了。
- DEVKIT §9 增加一行（free -s 0.5 实测 0s、free -s 1 实测 1s）；README 同步；
  “收益只有 vmstat -t 一列”改为包含 free -s

P3：
1. §9 机制改准：内核只写 8 字节 → tv_sec 高 32 位是内核写入的 nsec、offset 8 的
   tv_nsec 才是未初始化；nanosleep 是把 tv_sec 高半字当 nsec 读（0）
2. 删掉脚本里 top 的旧错误归因（时长溢出/59.4 GiB），与 DEVKIT 对齐
3. 测试耗时改为「热缓存约 15s，冷启动 1–2 分钟」（实测 28s 含多次构建/修复路径）
4. --verify-only 依赖清单写全（file/readelf/sha256sum/awk/sed/grep/wc/cut/basename）
5. licenses/ 增加 musl-COPYRIGHT（zig env → libc/musl/COPYRIGHT，取不到即失败），§6 补一行
6. htop 说明改准：亚秒刷新走 ncurses halfdelay()（select + 32 位 timeval），大概率不受
   time64 影响；受影响的是时钟显示与部分采样（仍注明未做运行时验证）
7. README/脚本注明 src/ 是生成目录
8. LGPL 摘要改为「源码(§6a) 或 共享库(§6b) 或 书面要约(§6c)」
9. ltrace/sysstat 从「不可行」改为「未做（成本高）」，与 perf 的硬阻塞区分

验证：test_build_devkit.sh 20/20；--verify-only 通过（7 个二进制 + MANIFEST + 5 份许可证）；
独立工作区离线重建 64s/0 下载，七个 sha256 与前一次逐字节一致；设备实测 sysctl 与其余六项正常。
 2026-11-06 19:53:45 +08:00
AskaEth 0531603779 fix(devkit): M24 r1 评审 — P1 --with-sources 静默漏源码 + time64 归因更正 
P1（阻断）：stamp 命中时 main 提前 return，--with-sources 在 return 之后，
于是「先构建再 --with-sources」会打印成功、退出码 0、却不产出 src/。

- 把源码整理抽成 stage_sources()，stamp 命中路径先兑现 WITH_SOURCES 再返回；
  整理后按钉住的 sha256 复核（sha 漂移/缺文件都重铺），任何失败即非零退出
- 新增 test_build_devkit.sh（12 项，秒级）：stamp 命中下的 --with-sources、
  src 缺文件/被改坏的自愈、--verify-only 的 MANIFEST 篡改检测
- skip 条件额外要求 MANIFEST 与 bin 逐条 sha 一致；--clean 同时清 out/src；
  全新构建未带 --with-sources 时删除上次残留 src/（避免源码与二进制错配）

P2-a：top 排除理由改写。根因是 zig 0.17 musl 的 time64 ABI 错配（mips o32 是
ILP32 + 内核 4.4 无 time64 syscall，16B timespec 直传 32 位 syscall），不是
procps 的 bug；top 的 Mem 一栏是「百分比/总容量」不是 used GiB。新增 DEVKIT.md
§9 记录证据（vmstat -t 空列、usleep(0.5s)×10 实测 0s、sleep(1) 正常、ps lstart
正常），并说明 M16 的 patch_v2/sdk/meow_ui_time.c 可复用（本轮实测该 .o 独立
编译、仅 5 个 libc 未定义符号）但本轮不接入的取舍——需要单独 mission 做链接期
接管 + 全量回归，不是 -D 能修的。

P2-b：--with-sources 现在同时放 build_devkit.sh + DEVKIT.md（GPLv2 §3 的
"scripts used to control compilation"）；补 LGPL-2.1 §6 静态链接 libproc2 的
义务说明；MANIFEST/README.txt 写明 src/ 与 licenses/。

P2-c：lsof 内嵌 Termux musl 的 resolv.conf 路径记为工具链副作用（实测
lsof -i 约 3s 超时、-nP 瞬时；端口名/本机名不受影响），不换工具链。

P3：软链路径写实（/bin/ps、/usr/bin/{free,lsof,top}）；MANIFEST 用 zig version
而非 clang 版本；chmod 措辞改成检查挂载参数；--verify-only 增加 MANIFEST 逐条
sha256/体积比对且不再依赖 date；stamp 纳入 zig 完整版本；许可证复制失败即报错。

验证：test_build_devkit.sh 12/12 通过；--verify-only 通过（含 MANIFEST 对账）；
独立工作区离线重建 85s/0 下载，六个二进制 sha256 与上一版逐字节一致；设备侧
二进制未变（sha 与 r1 真机验证过的一致）。
 2026-11-06 19:29:27 +08:00
AskaEth b52e6a08bc feat(devkit): M24 静态 MIPS32r2 调试工具集 — vmstat/slabtop/free/ps/pmap/lsof 
TF 卡 MeowOS/opt/devkit 用的交叉编译流水线：zig 0.17 musl 静态链接，
产物 fw_apps/devkit/{bin,MANIFEST.txt,licenses,README.txt}（gitignore 内）。

- build_devkit.sh：源码固定 版本+sha256+URL（ncurses 6.5 / procps-ng 4.0.4 /
  lsof 4.99.4），缓存命中零联网；冷启动 3 次下载约 80s，重跑 0 次联网约 65s，
  stamp 命中 1s 跳过；--force/--clean/--offline/--with-sources/--verify-only
- 自编静态 ncursesw 只为 slabtop（procps 的 slabtop 硬依赖 ncurses）；
  terminfo 目录钉到设备 /usr/share/terminfo，交互式 slabtop 可用
- 逐项自检 file/readelf（static、ELF32、mips32r2、0 NEEDED），任一不过即失败
- 不交付 top（真机输出不可信）、htop（卡上已有 3.5.3 且我们的更大）
- DEVKIT.md：许可证留痕（procps=GPL-2+ 需提供源码、ncurses=MIT、lsof=Purdue）、
  可行性实测、上卡 PATH 与 busybox 同名关系、真机验证输出
 2026-11-06 19:05:15 +08:00
AskaEth 2a2e6988ae Merge branch 'feat/m23-network-time-sync' 2026-11-06 13:43:24 +08:00
AskaEth 1f692ae2a7 fix(ntp): M22 r1 评审 P2×3 — 孤儿 ntpd 收尸 / 日志失败不吞 hwclock / 锁自证 
r1 评审 verdict=p2-3items，三条均已按评审给的修法修掉，且都补了可证伪的回归断言。

P2-1 SIGTERM 后遗留孤儿 ntpd，之后每次静默 skip 且 rc=0
- attempt() 把子进程记进全局 NTPD_CHILD 并落盘 <锁目录>/ntpd.pid；
  新增 cleanup()（EXIT trap）先收尸子进程再释放锁；新增 on_signal()
  （INT/TERM/HUP）清理后 exit 143——旧代码的 TERM trap 只清锁、不 exit，
  被杀后还会继续跑完看门狗。
- 取代原来的 "pidof ntpd 就 skip"：新增 reap_or_skip_ntpd()，用
  /proc/<pid>/cmdline 是否含本锁目录来区分「我们自己遗留的孤儿」（收尸）
  与「别人的常驻 ntpd」（让路）。崩溃后留下的 ntpd.pid 也据此校验，
  pid 被复用时不会误判成外部 daemon（不会永久 skip）。
- S45 stop 不再按陈旧 pid 文件盲杀：只从 <锁目录>/<pid> 取持有者，
  再核对 /proc/<pid>/cmdline 含 meow_ntpsync 才 kill。

P2-2 日志重定向失败导致 hwclock 根本不执行
- persist_rtc 改 ">/dev/null 2>>$LOG_FILE"：hwclock 的 rc 与日志写入解耦。
- 新增 prepare_log()：启动时在子 shell 里试写日志，不可写就整体退化 /dev/null。
  必须用子 shell——`:` 是 POSIX 特殊内建，它的重定向失败会让 dash 直接
  退出整个脚本（本单自测先踩到了，rc=2）。

P2-3 锁 mkdir→写 pid 有窗口，并发抑制非原子
- 锁的持有者改由 <锁目录>/<pid> 子目录自证（mkdir 原子），不再写 pid 文件；
  读到空锁时给 3s 宽限而不是立刻判死。
- 清失效锁改用 mv 到 <锁目录>.stale.$$（rename 原子），并发清锁时只有
  一个能成功，避免「抢锁失败方删掉胜方的锁」。
- 退出只删自己的锁：没有自己的 <pid> 子目录就不动锁目录。

验证
- 新增回归断言 11-16（run_tests.sh）：SIGTERM 收尸/锁释放、遗留孤儿收尸、
  日志不可写仍写 RTC、锁被占用不抢、死锁可接管、pid 复用不阻断。
- 可证伪性：新套件跑旧代码（c9f0cba 的 meow_ntpsync）→ 6 条 FAIL
  （孤儿 alive、日志不可写 rc=1 且 hwclock 未执行、抢锁并发调 ntpd×3）。
  再跑「仅回退 STALE_NTPD 硬化」的变体 → pid 复用那条 FAIL
  （rc=0 但 RTC 未写，正是评审指出的静默失效）。
- dash 与 busybox ash 各 41/41 PASS，rc=0；dash -n / busybox sh -n 均 0 错。
- 时间断言放宽为负载容忍（宿主是多 agent 共享机，实测 sleep 5 能跑成 85s），
  假 ntpd 改为挂 3600s，保证上界仍能证明是看门狗掐断而非自然退出。

fw_content.conf: meow_ntpsync md5 ad324e3f→f3c3abe4，
S45meow_ntpsync md5 25454a3f→115e7592（50meow_ntpsync 未改，md5 不变）。
 2026-11-06 13:34:45 +08:00
AskaEth c9f0cbaab6 feat(ntp): M22 网络校时 — 复用固件自带 ntpd + hwclock 回写 RTC 
真机实测（0.8.47，2026-11-06）定位到的根因不是「没有 NTP 客户端」：
固件自带 ntp-4.2.8p14（/usr/sbin/ntpd）和 /etc/ntp.conf（4 个 pool.ntp.org），
但没有任何 init 脚本/进程启动它 —— 有客户端、没启动。

实测证据：
- RTC 存在且可读（/dev/rtc0，10003000.rtc），内核开机 hctosys=1，
  冷启动不回到 1970 → 掉电保持；RTC 存 UTC（since_epoch == date +%s）。
- 但 RTC 会走慢且无人纠正：实测系统时间比 NTP 慢 49 s；把系统时间人为
  拨错 4 h 后观察 65 s 无人纠正，RTC 也不跟随系统时间。
- UDP/123 出网正常（ntpd -q 一次成功 time set +48.877s）；DNS/HTTP 正常。
- udhcpc 的 default.script 不处理 option 42，实测热点也不下发。
- ntpd -q 不会回写 RTC（步进后 sys-rtc 仍差 49 s）→ 必须 hwclock -w -u。
- ntpd 没有超时参数，无服务器时永久存活 → 必须自带看门狗。
- -p 形式的 server 首个 poll 要 ~64 s；配置里加 iburst 后 8 s 内返回。

实现（新增，不改任何基线文件）：
- /usr/bin/meow_ntpsync：一次性校时器。复用 ntpd -q -g + 运行时生成的
  iburst 配置；内置 IP 兜底（阿里/腾讯/Cloudflare）→ DNS 名兜底；
  单次 15 s 看门狗、默认路由轮询、1 h 短路、进程锁、失败静默。
  成功严格校时后 hwclock -w -u 回写 RTC（RTC 存 UTC，必须 -u）。
- /etc/init.d/S45meow_ntpsync：开机只 setsid 后台拉起并立即返回
  （关键路径 +0 秒；后台最长约 150 s 自行退出），失败不阻断 init。
- /usr/share/udhcpc/default.script.d/50meow_ntpsync：只在 bound/renew
  触发（设备上唯一可靠的「网络就绪」事件），后台拉起后立即 exit 0；
  有 $ntpsrv（option 42）就优先用。基线 default.script 本就有 HOOK_DIR
  循环，目录原本为空。
- tests/run_tests.sh：宿主沙箱单测（假 ntpd/hwclock/网络探测）。

验证：dash 与 busybox sh 各 sh -n 通过；单测两套 shell 各 23/23 通过；
真机（/tmp 下运行，未装系统目录）首跑 8 s rc=0、ntpd slew 成功、
RTC 由 1793940395 写成 1793940452（49 s 偏差被纠正）、hwclock -u -r 吻合；
二次运行 0 s 短路；-b -t 3 无网络 5 s 退出 rc=1；
DHCP 灌入不可达服务器 192.0.2.x 仍靠 IP 兜底在 ~10 s 内成功。
 2026-11-06 12:49:13 +08:00
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
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
AskaEth e87ccdf061 Merge branch 'feat/m643-reader-streaming-panel-sync' 2026-11-04 20:00:59 +08:00
AskaEth f40abbd494 feat: M6.43 — reader分段流式读取(Phase1,只txt) + 面板前台管理/返回回桌面按钮 
- reader分段(只txt): core/seg.{h,c} 512KB码位对齐切段(尾字完整)+manifest+按需读单段; book.c rd_book_open只布局每页所在段(治CPU100%/返回无效) load_seg只读当前段(非txt原路径); reader.c 进度实时保存(翻页/刮擦/字号/编码dirty+on_tick节流落盘+退出即时写,锚点存段号,崩溃不丢进度); rdtxt.c fread替代fgetc(去开书扫描卡顿); Phase2(双段拼接+4%释放)留待
- 面板: /api/ams/bg加fg/fg_count(后台保持向后兼容)+POST /api/ams/:pkg/killfg(前台救命:优先am kill,launcher拒则pid直信号SIGTERM->SIGKILL绕过门控)+前端/#/bg前台组'终止'绿徽标+确认弹窗(一键清仍只后台不误杀前台); POST /api/input/gesture(返回=左缘右滑/回桌面=底部上滑,注入滑动轨迹复用SDK手势)+前端屏幕控制页加返回/回桌面MD3按钮

0warning;宿主test_reader_core 72-0/seg_smoke 19-0/loaders_smoke/book_smoke/formats_smoke PASS;面板selftest/node check PASS
 2026-11-04 19:47:10 +08:00
AskaEth a64ae06eb6 fix(reader): txt编码误判(UTF-8前窗截断判GB18030致乱码) + build_index无持久化(整本重排慢/UI阻塞卡) — ①rd_utf8_sample_ok结尾不完整序列按合法(中间非法仍拒,GBK不误判,新增t13回归) ②索引落盘MeowData/os.meow.reader/index/*.idx(失效键size/mtime/font/fs/ls/wh/enc,命中秒开,原子写+强自检弃坏缓存,编码/字号/行距重排重写) 重开<0.3s/首开建cache; test_reader_core 72-0, 0warning 2026-11-04 19:47:10 +08:00
AskaEth 68710d7ed8 fix(reader): 书索引build_index全量逐字FreeType排版优化 — rdft_advance加(px,cp)->advance缓存(开放寻址4096槽,与glyph缓存分离,load_font/set_px同清), 测量从O(全书字符)降到O(唯一码点~2600); 大书(10MB)打开 rd_book_open 23.9s->140ms(~170x), npages一致布局确定保留; 点条目不再用户态busy循环冻死(非驱动/锁屏, 是UI线程同步全量建索引); 0warning, 宿主test_reader_core 68-0/loaders_smoke/book_smoke/formats_smoke PASS 2026-09-04 21:01:56 +08:00
AskaEth 5e67100231 fix(reader): 书架scan_books改为递归扫子目录(Books/<subdir>/,深度≤2), 用户按目录组织书也能扫到 — 修复'书架为空'(书在Books/kh/子目录); reader热更 eacd0e6c 已基于此; 0warning 2026-09-04 20:48:55 +08:00
AskaEth 06f872faf2 fix(fw): M6.42 收编audiod开机路由武装瘦身(防楔死) — 推卡 
- audiod 重编 d833abce(0warning, glibc-dynamic≤2.17): 去无条件apply_route(5)→target双写,当前端口正确则跳过强烧,仅未武装/端口不对/读失败才写目标;保留M2.91防挂死武装(numid=9语义/popen有界超时/D态抛弃/io_thread未动)
- SDK未变(meow_ui.a 207630cb沿用); launcher 9013f843未变; netmgrd 9c345b2e/meow_audio 6864ec38/amsd 57e19cde 未变
- 固件 r3proii_m6_42.upt 6d7c1168(0.8.42, rootfs 38719488<=45088768, unpack 0 diff); 已上卡+备份r3proii_prev_m6_42=2a966f2b+rm recovery_all+升级重启; 设备已回网0.8.42
- reader eacd0e6c/files 01ad3f01 卡上已热更未动(不在固件)
- 注: audiod瘦身是驱动楔死缓解,需用户后续多boot复测(不在本收编范围)
 2026-09-04 20:48:02 +08:00
AskaEth 68f91f7de2 fix(audio): M6.42 — audiod开机路由武装瘦身(去无条件apply_route(5)→target双写, 当前端口正确则跳过强烧, 仅未武装/端口不对/读失败才写目标; 保留M2.91核心防挂死武装, numid=9语义/popen有界超时/D态抛弃/io_thread未动) — 降低stock hbc3000驱动楔死整机硬冻结触发面(reader后台+Files切换撞楔死驱动口); 0warning, 宿主test_audiod_host 100-0; 需真机多boot复测 2026-09-04 20:43:22 +08:00
AskaEth 4ce7a268a8 fix(fw): M6.41 收编启动失败原因透传+后台管理按钮点不动修复+主菜单微调 — 推卡(固件已上卡,设备待回网补reader热更+校准) 
- launcher 9013f843(启动失败原因透传+后台管理按钮点不动修复+主菜单字体/样式微调) / reader 5a0c8776(左缘返回+view栈+字体瘦身+页位图释放)
- SDK未变(meow_ui.a 207630cb沿用),不重编meow_ui.a/不重链ncm/hello/files(files已热更01ad3f01不动)
- 固件 r3proii_m6_41.upt 2a966f2b(0.8.41, rootfs 38719488<=45088768, unpack 0 diff); 已上卡+备份r3proii_prev_m6_41=28191ae7+rm recovery_all+触发升级重启
- netmgrd 9c345b2e/audiod 9f47c8fd/meow_audio 6864ec38 未变; amsd 57e19cde 保持
- 注: 设备升级后未回网(WiFi已知问题,超~5分钟),reader热更+升级后验收+红线校准待设备回网后补
 2026-09-04 19:50:55 +08:00
AskaEth ddc8d35eb9 fix: M6.41批 — 启动失败原因透传 + 阅读器左缘返回/阅读页接入view栈 + 后台管理按钮点不动 + 阅读器瘦身(fonts common+页位图释放) + files txt换行 
- launcher(453): app_launcher.c g_launch_fail_reason+launch_fail()统一出口(5失败点 fork OOM/exec/no such file/missing dep/execpipe)+main_menu.c launch_fail_toast(缺依赖/CANNOT START: name(reason))+toast256
- launcher(457): bg_page.c bgm_enumerate跳过term_at_ms(杀后当下消失)+不可杀行按钮置灰+row_tap/top_action返回1; subpage.c 消warning
- reader(454): reader_on_swipe LEFT/RIGHT→返回(先关overlay否则page_pop回书架)+app.c书架根LEFT→exit
- reader(458瘦身A+B): app.json fonts full→common(省13MB atlas)+reader.c RD_PAGE_CACHE 3→2+g_anim_old懒分配/anim_done释放+on_enter/on_leave页位图离开释放重建
- reader(459导航): reader_open返回int+shelf点书push ACT_READER(阅读页接入view栈,on_enter/on_leave驱动) — 使454左缘返回+458瘦身B真正生效
- files(455): viewer.c viewer_cp_len+按码位折行(txt中文不冲出右缘)

0warning;宿主测试全过;files二进制已热更
 2026-09-04 19:43:28 +08:00
AskaEth 626a87a30d fix(fw): M6.40 收编系统级音量翻页映射(MSG_KEY_PAGEUP/PAGEDOWN)+P1 MD3(select面板28/对话框按钮胶囊)+阅读器UI改版 — 推卡(固件已上卡,设备待回网验收) 
- meow_ui.a 重编 207630cb(0warning): select面板28/对话框按钮胶囊h/2
- launcher f1980f4f(音量翻页系统映射) / hello 92c7ba17 / files 66bdb60d / reader 9c2a25e0(阅读器UI改版) / ncm e796282e
- 固件 r3proii_m6_40.upt 28191ae7(0.8.40, rootfs 38719488<=45088768, unpack 0 diff); 已上卡+备份r3proii_prev_m6_40=a671b8ba+rm recovery_all+触发升级重启
- netmgrd 9c345b2e/audiod 9f47c8fd/meow_audio 6864ec38 未变; amsd 57e19cde 保持
- 注: 设备升级后未回网(超8分钟),四App+面板热更与升级后验收待设备回网后补
 2026-09-04 18:24:16 +08:00
AskaEth 2826c1e905 feat: M6.40批 — 阅读器UI改版(书架list·grid+空态骨架+界面设置+App设置页+header·footer+背景黑默认) + 系统级音量翻页映射 + P1 MD3(select面板28/对话框按钮胶囊) + MeowPanel写端点护栏 + SDK公开仓·文档同步 
- reader: app.c/shelf.c/reader.c 全套UI; 新增 reader_conf(reader.conf)/settings(App设置页)/reader_ipc(音量翻页IPC响应); app.json加volume_page
- launcher: keys.c meow_volpage_*门 + util.c app_id→fd映射(HELLO记fd/断开清) + app_launcher.c 前台三处接线(进入sink/按键路径volpage_key/离开clear) → 前台声明volume_page的App音量键→MSG_KEY_PAGEUP/PAGEDOWN翻页(非阅读器前台音量照旧)
- sdk: meow_select.c 底部面板28 + meow_ui_dialog.c 对话框按钮胶囊(h/2) + test_meow_ui_select.c修采样
- meowpanel: /api/net/policy·/api/power/policy 加防自锁+policy默认关两条护栏(panel.policy_enabled默认0)
- 文档: MEOW_APP_SDK.md §12.6 + meowpanel README端点表

0warning;宿主测试全过;二进制留批量批次未入库
 2026-09-04 18:13:18 +08:00
AskaEth b364b6371a fix(fw): M6.39 收编SDK LazyGrid/LazyColumn/LazyRow MD3容器化+SDK全局App内底部上滑回桌面(系统手势优先) — 推卡 
- meow_ui.a 重编 0fb87579(0warning): meow_list/lazygrid 默认container=1 + meow_ui_input_is_home_swipe/MEOW_EV_HOME
- launcher a21243b6 / hello 96d14310 / files a9de683f / reader 3e8be7cb / ncm 47954e2c (重链新meow_ui.a)
- 固件 r3proii_m6_39.upt a671b8ba(0.8.39, rootfs 38715392<=45088768, unpack 0 diff)
- netmgrd 9c345b2e/audiod 9f47c8fd/meow_audio 6864ec38 未变; amsd 57e19cde 保持
 2026-09-04 14:01:26 +08:00
AskaEth 501867b362 feat(sdk): M6.39批 — LazyGrid/LazyColumn/LazyRow MD3容器化 + SDK全局App内底部上滑回桌面(系统手势优先) 
- meow_ui_widget.c: W_LIST/meow_list/LazyColumn/LazyRow默认container=1(MD3圆角卡surfaceContainer+tonal选中+卡内按压+去分隔线) + 新增meow_list_set_container; 平坦回退set_container(0)
- meow_lazygrid.c: lg_draw_cell容器化(卡内缩8,surfaceContainer圆角+tonal选中+按压)
- meow_ui_input.c: 新增meow_ui_input_is_home_swipe(镜像np_home_gesture:屏底28px热区+上移65px+竖向主导,与左缘返回/列表中滑互斥) + MEOW_EV_HOME分发→meow_ui_nav_request_exit(系统保留手势**优先于App on_swipe**,任意App内生效→MSG_NAV EXIT→批①保活回桌面; 不调request_exit避免进程退出断送保活)
- 声明: meow_ui_input.h / meow_ui_widgets.h 各追加
- 宿主测试: test_meow_ui_home_gesture 19-0 / test_meow_ui_lazygrid 32-0, 0warning
 2026-09-04 13:56:11 +08:00
AskaEth d0a5901ffb fix(fw): M6.38 收编SDK对话框MD3细化+批②底部上滑回桌面+批6 ncm顶栏回播放页+批④面板后台列表+launcher UI微调+封面空artwork保留 — 推卡+面板热更 
- meow_ui.a 重编 4c006844(0warning): meow_ui_dialog MEOW_SHAPE_EXTRA_LARGE 28
- launcher c9218411 / hello 63824093 / files c9309774 / reader 0d462111(未变,不拉对话框对象) / ncm 2b33b1dc
- 固件 r3proii_m6_38.upt 7b6ce4a5(0.8.38, rootfs 38715392<=45088768, unpack 0 diff)
- meowpanel 后端 fcb2f658 + web(index/css/js/mp_pages) 热更 MeowOS/opt/MeowPanel, /api/ams/bg 新增, 运行中新二进制
- netmgrd 9c345b2e/audiod 9f47c8fd/meow_audio 6864ec38 未变; amsd 57e19cde 保持
 2026-09-04 13:23:56 +08:00
AskaEth a2aec783a7 feat(ui): M6.38批 — P1 MD3细化(SDK对话框28)+批②底部上滑回桌面+批6 ncm顶栏回播放页+批④面板后台列表+launcher UI微调(歌词页黑半透明底/播放页布局下移)+封面空artwork保留修复 
- P1: meow_ui_dialog.c 对话框底框 radius_card→MEOW_SHAPE_EXTRA_LARGE(28) 三处(:103填充/:104描边/:361 BottomSheet); meow_ui_widgets.h 新增 MEOW_SHAPE_EXTRA_LARGE 28 宏; TextField/FAB/Slider/Progress 按设计文档保留
- 批②: np_gesture.h 新增 NP_GEST_HOME+np_home_gesture(底部热区上滑,与左缘返回对称互斥); now_playing.c 新增 np_draw_home_bar(屏底左缘pill指示条)+手势衔接; test_now_playing_widgets G5b
- 批6: ncm home.c 顶栏加回播放页按钮(MEOW_ICON_QUEUE_MUSIC)→push(ACT_PLAYER), 无音频也生效
- 批④: meowpanel /api/ams/bg 只读端点+前端后台列表页+杀/清复用kill通道
- UI微调: now_playing.c 播放页布局宏下移(NP_COVER_Y 84/NP_BTN_Y 612消底部留白)+歌词页背景统一黑色半透明叠层(弃封面取色底,删 np_draw_lyric_coverbg)
- 封面保留: now_playing.c/notif_center.c 空artwork保留上一张已解码封面(防暂停/开歌单致META报空artwork后封面闪没); test_np_cover C2断言更新+mirror同步

0warning;宿主测试 test_np_cover ALL PASS;launcher/ncm/panel 宿主测试无回归。二进制留批量批次未入库
 2026-09-04 13:09:03 +08:00
AskaEth b3ce719742 fix(fw): M6.37 收编SDK默认列表MD3容器化(meow_listview_create默认container=1)重编meow_ui.a重链四App — 推卡 
- meow_ui.a 重编 14f218d7(0warning): meow_listview_create默认container=1,行=surfaceContainer圆角卡+空隙+去分隔线+卡内tonal选中
- launcher e7fd28dd / hello c10a3ea5 / files 90a6e817 / reader 0d462111 / ncm 6f3967f8 (重链新meow_ui.a)
- 固件 r3proii_m6_37.upt a8dd8f54(0.8.37, rootfs 38715392<=45088768, unpack 0 diff)
- netmgrd 9c345b2e/audiod 9f47c8fd/meow_audio 6864ec38 未变; amsd 57e19cde 保持
 2026-09-04 12:29:23 +08:00
AskaEth 8e68254ce4 style(sdk): SDK默认列表MD3容器化 — meow_listview_create默认container=1(行=surfaceContainer圆角卡+空隙+去分隔线+卡内tonal选中)，hello/files/ncm/reader等用默认renderer的App开箱即MD3(用户2026-09-04反馈默认仍扁平)；需平坦宿主可set_container(0)回退(宿主测试test_meow_ui_widgets/listvirt补set_container(0)锁扁平基线)。0warning，宿主测试全过(widgets ALL PASS/md3 PASS/swipe 35-0/listvirt 44-0)。meow_ui.a变需重编+重链四App 2026-09-04 12:24:16 +08:00
AskaEth 4d0a8450e9 fix(fw): M6.36 收编全面MD3对齐+批①叠加/列表外距/后台图标/后台圆角卡+重编meow_ui.a重链四App — 推卡 
- meow_ui.a 重编 d02c0f57(0warning): MD3对齐(meow_ui_widget/widgets:容器/胶囊/shape)+批①叠加共享判定+meow_img_pixels+meow_ui_audio
- launcher 0c4f3c10: MD3全面对齐(subpage/settings/bg/MENU列表圆角卡8px外距/按钮胶囊/状态层/shape)+批①叠加/穿透根治(7处转场)+顶栏后台按钮图标+后台管理页圆角卡
- 四App热更: ncm df149a9c / hello f3ac1fc0 / files f37d66c7 / reader b6cbc050(reader四格式冒烟全过)
- 固件 r3proii_m6_36.upt 91ccf411(0.8.36, rootfs 38715392<=45088768, unpack 0 diff)
- netmgrd 9c345b2e/audiod 9f47c8fd/meow_audio 6864ec38 未变; amsd 57e19cde 已M6.35收编
 2026-09-04 12:00:59 +08:00
AskaEth b712088daa style(md3): 全面MD3对齐P0-P3 — P0扁平行列表容器化(meow_listview_set_container容器模式:surfaceContainer圆角卡12dp+tonal状态层+去分隔线;sub_page/settings_page/bg_page圆角容器) P1按钮胶囊化+shape令牌(extrasmall/small/medium/large/full) P2状态层补齐 P3子控件(Switch off-track/NavBar pill64×32/Checkbox24/对话框28);宿主test_meow_md3等全过,0warning;meow_ui.a变M6.36需重编+四App重链 2026-09-04 11:49:59 +08:00
AskaEth 3fea237306 docs: 同步至 M6.35/0.8.35（App后台常驻框架+批③后台管理页+面板拆分合并页+MD3对齐在跑+third_party/md-material-web参考+redline纪律;不提网易云明面） 2026-09-04 11:40:00 +08:00
AskaEth 2db87b2c5c style(bt): 后台管理页行改MD3圆角卡+8px外距(bgm_row_card_y/h,卡高48行距56上下对称,删除分隔线,按压限卡内,按钮相对卡定位恒等)+test_bg_row_card PASS,0warning 2026-09-04 11:27:07 +08:00
AskaEth 7a276f609e fix(bt): 批①叠加/穿透根治 — /tmp/meow_notif_active从布尔标志改为内容=前台归属app_id(App用MEOW_LOG_APP比较:前台照常上屏收输入/后台常驻自抑+排空输入/空=全抑制),SDK present+input共用共享判定meow_ui_overlay_suppressed_active,launcher 7处转场改写;宿主test_overlay_suppress(T2c)/notif_gesture/overlay_gate/bg全过,0warning;meow_ui.a变M6.36需重编+重链四App 2026-09-04 04:05:41 +08:00
AskaEth 6bab304660 style(launcher): 主界面列表布局(home_layout=list)圆角卡加8px外距(MENU_LIST_ROW_GAP+menu_row_card_y/h卡上下对称内缩行距不变) — 圆角列表项紧贴修复;其余扁平行(Material标准)未动;test_menu_row_gap PASS,0warning,不动meow_ui.a 2026-09-04 03:53:09 +08:00
AskaEth 491db5069c style(launcher): 主界面顶栏'后台'按钮图标美化 — 去方形primary底改surface_container柔和圆角+矢量双卡层叠图标(后台应用堆叠语义)+小字'后台';命中矩形/入口不变,0warning 2026-09-04 03:51:30 +08:00
AskaEth b23c6d53c4 fix(fw): M6.35 收编批③后台管理页(按钮化)+amsd FG/BG+i18n — 推卡 2026-09-04 02:57:26 +08:00
AskaEth 5c174224f7 feat(bt): 批③后台管理页UI按钮化 — 每行右'杀'按钮(bgm_btn_rect精确命中,行区不误杀)+顶栏'一键清除后台'按钮(sub_page_t增row_draw/row_tap/top_action/top_action_cb全NULL守卫,wifi/bt/lock行为不变);test_bgpage 32项ALL PASS,0warning 2026-09-04 02:48:08 +08:00
AskaEth c69fb92284 refactor(i18n): settings/lock 剩余中文补抽为 meow_str_zh 键(内联键,默认=原中文显示不变) — settings_page([59]设置行/值格式/标题)+lock_settings(行/模态/动作)+lock_screen_ui(清空/退格/PIN锁定提示);顺带修2条既有-Wformat-zero-length;宿主settings/lock全过,0warning 2026-09-04 02:21:45 +08:00
AskaEth 211c5a556a feat(bt): 批③后台管理页 — bg_page(顶栏'后台'入口+sub_page_t列表[名字/CPU/内存/状态/tap=kill]+一键清除动作行+空态,2s实时)+meow_bgmgr(collect/can_kill !framework门控+kill_all不杀框架)+meow_bg_terminate复用回收序列;amsd FG/BG收编(重编57e19cde含handle_bg/fg);test_bgmgr 20项ALL PASS,0warning 2026-09-04 02:19:06 +08:00
AskaEth 2f22e26de7 fix(fw): M6.34 收编批①后台常驻+宽限期+audiod A3/DSD+meow_img_pixels+重编meow_ui.a重链四App — 推卡 2026-09-04 02:00:39 +08:00
AskaEth 3c5612f7c9 refactor(sdk/lyric)+misc: ①G5断言改成EXIT(播放页任意右滑回桌面,宿主全过) ②meow_img_pixels正式访问器上收(替代局部补全结构体,const化w/h,清3处警告) ③RECOVERY_PROMPT §五铁律补重链四App ④MEOW_APP_SDK.md §4.1取色/§5.9音频/§9后台字段/§16歌词组件;0warning;meow_ui.a变M6.34需重编+四App重链 2026-09-04 01:49:24 +08:00
AskaEth 45c633868f feat(bt): 批①宽限期补充 — 全App入后台表(bg_since_ms)+未声明App宽限30min(MEOW_BG_GRACE_MS)超时回收+声明常驻/媒体活跃不清+槽满LRU回收最旧未声明;test_bgplay全过/0warning;devdocs APP_BACKGROUND_KEEPALIVE_P1 §9;M6.34需先重编meow_ui.a(meow_img_pixels) 2026-09-04 01:48:31 +08:00
AskaEth effce6d0db feat(audiod): A3+DSD — ①24/32bit高清byte-exact(偏好S32) ②独立AUDIO_FMT_DOP DoP DSD透传+失败报错关流(拒BT) ③音量收编v2双组写PCM+DSD_VOLUME平方锥度audiod权威 ④/api/audio/monitor监控+前端音频页监控卡;宿主100/0,0warning;SDK meow_ui_audio ABI变大M6.34需重编meow_ui.a+重链四App 2026-09-04 00:56:57 +08:00
AskaEth 2dc4cad454 refactor(panel): 前后端按模块拆分+屏幕/控制合并页 — 后端meowpanel.c 6372行拆src/*.c+mp.h(235函数原型,20端点output byte-identical,0warning)+前端拆mp_shared/mp_pages/meowpanel三层;屏幕·遥控合并(左屏实时画面+右MD3 SVG矢量按钮无emoji);重编后热更TF卡 2026-09-04 00:56:13 +08:00