AskaEth/MeowOS-For-R3P2
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
419 Commits 1 Branch 0 Tags
837cd47e7c77a33734995ee3d4f1abb89cc42bd1
Commit Graph
419 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
AskaEth 837cd47e7c fix(sdk+launcher): M39 点击输入门 — 固定时长吞窗改为「启动排空 + 短系统手势防穿透」 
根因（M36 已查实）：不是布局竞态，而是固定时长的输入封闭窗口且窗口起点在首帧之后。
- SDK meow_ui_run：M2.22(C) 500ms 内丢弃 TAP/SWIPE/HOME/NOTIF_PULL/TOUCH_DOWN/MOVE/LONG_PRESS，
  窗口在 App 画完首帧后才 arm → 用户看到界面后第一下必被吞。
  改为入口 meow_input_drain() 排空一次（清环形队列 + 复位触摸状态机），
  TAP/TOUCH_DOWN/TOUCH_MOVE/LONG_PRESS 立即生效；仅系统手势（左缘 SWIPE、底部上滑 HOME、
  顶部下拉 NOTIF_PULL、SWIPE_PROGRESS）保留 STARTUP_GESTURE_GUARD_MS=150 防穿透。
- launcher：menu_after_app_exit 1200ms→150ms；子页返回 800ms→150ms；菜单/子页打开
  300ms→150ms（统一 MENU_TOUCH_GUARD_MS）。menu_drain_touch() 同时复位 t_down/原点/坐标：
  只清队列会把「按下已被 drain、抬手稍后才到」误判成一次 tap（幽灵重放的另一半）。
  历史理由已核对：旧窗口是为 Bug2/4（App 运行期事件堆积在 launcher 自身 touch_fd 里被重放）
  加的，真正的机制就是排空本进程 fd —— evdev 每 fd 各收一份，App/子页运行期全量事件都在
  这个 fd 里，drain 后无历史事件可重放；窗口只兜面板重配尾巴。
- 单测：test_meow_ui_home_gesture 新增 T4（11 断言：立即点击生效/立即上滑被守卫挡+守卫后生效/
  立即左缘 SWIPE 同理/TOUCH_DOWN+MOVE 立即下发/LONG_PRESS 立即下发/run 入口 drain 丢弃预置残留；
  旧 SDK 下 8 条红、新 SDK 30 pass/0 fail）；test_meow_ui_dispatch 新增 M5（drain 清队列+复位在途
  手势+新点击不受影响，ALL PASS）；swipe 35/0、view_event ALL PASS（回归）。
- 重编重链（铁律）：meow_ui.a 8525aa6b（meow_ui_input.o 8248a6c6，旧 e54903ca）→
  meow_launcherd e342d24f(891164) / files 17edac0f(383072) / hello 65c1c575(499380) /
  ncm 1c2f5ff7(1225676) / reader a463645f(1716212，gitignore 不入库)。
  picbrowser 仓库内 0 个 tracked 文件（源码不存在）→ 无法重链，见 finding。
- 真机：未验证（纪律禁止覆盖设备已装组件；uinput 注入是 M36 设备失联诱因）。
 2026-11-10 21:58:13 +08:00
AskaEth 46278fd051 Merge branch 'feat/m35-nyai-manifest-authority-and-sd-stagi' 2026-11-10 21:42:40 +08:00
AskaEth cf5703b32b fix(nyai): M35 评审 r1 — 闭合 exFAT 大小写绕过（P1）+ 修 fmt_utc 1/2 月 + 成员名/炸弹纵深 
P1（信任边界）：is_system_pkg() 原用 strncmp，而落盘目录在 exFAT（名字比较
不区分大小写）。包内 app.json 写 "OS.MEOW.READER" 时 valid_pkg 放行、
is_system_pkg 返回 0 → 当第三方无签放行 → dst 解析到已装的
MeowAPPs/os.meow.reader → 备份后部署假包并删掉真系统 App（无需私钥）。
三层封堵：
  1) is_system_pkg 改 strncasecmp（前缀判定不再受大小写影响）；
  2) valid_pkg 收紧为只收 [a-z0-9._-]，并拒绝前导/尾随 '.'（现网包名全小写，
     无兼容代价；tail-dot 同时挡 exFAT/Windows 名字映射怪癖）；
  3) 部署前 readdir 检查 MeowAPPs 里是否有与 pkg 仅大小写不同的已装目录
     （有则拒装并报两个名字）；部署后再用 readdir 复核 on-disk 名字与清单包名
     逐字节相等，不等则回滚，杜绝「身份不明的 App 目录」。

P2-1：fmt_utc() 的 March-based 月份换算写成 +9（应为 -9），1/2 月会打成
20251901/20251931 且年份不 +1。修正为 int 运算；新增 test_fmt_utc.c
（直接 include nyai.c 测 static 函数）覆盖 epoch/负数、1/1、2/1、2/28、闰年
2/29（2024 与 2000）、3/1、12/31 23:59:59、2038-01-01、int32 上界、2100 非闰。

纵深防御（评审残留风险，一并做）：
- tar 成员名净化不再依赖外部 tar：mpk_check_members 解析 tar -tv 的名字，
  拒绝绝对路径 / 含 '..' 组件 / 首字符 '-' / 原始控制字符；解包后 stg_tree_ok
  再用 readdir 的真实名字复核控制字符（tar 列名会把控制字符转义成可见文本，
  原检查会漏）。
- 解压炸弹：累加 tar -tv 的体积，超过 512MB 上限拒装，并加 statvfs
  「剩余空间 ≥ 体积 + 16MB」门禁（解包先于验签，恶意包可在验签前写满卡）。
- 顺手改掉 appmeta.package 注释里「== 文件名茎」的旧语义。

回归：test_nyai.sh 49 → 70 条断言全过（新增：fmt_utc 13 例、大写包名绕过顶替
已装系统包被拒且原 App 未变、尾点包名、与已装目录仅大小写不同、绝对路径/
../ / 首字符 '-' 成员名、控制字符成员名、700MB 解压炸弹），
`-Wall -Wextra` 零告警，二进制可重复构建。

交付：nyai 153,844 B / md5 ef7940ecf5ece993d718ac1d9019cc82（旧 4524ce6b…）。
真机 10.58.215.50 仍不可登录（22 端口 TCP 可连、15-50s 无 banner），本轮
**未做真机复核**，仅宿主验证。
 2026-11-10 21:42:37 +08:00
AskaEth 829d4475e8 feat(nyai): M35 包身份以已签名 app.json 清单为准 + 暂存迁到 SD 并必清理 
包名/版本/依赖不再从 .mpk 文件名推导（用户定案：不对安装包文件名强依赖，
一切信息从清单取），改为解包后读 app.json.package 作唯一权威：
  - 落地目录 MeowAPPs/<pkg>、meow_verify --package <pkg>、防降级基准全用清单包名；
  - 新增 footer.package == app.json.package 一致性检查，不一致拒装并同时报两个名字；
  - valid_pkg 拒绝 "." / ".."（此前 MeowAPPs/.. 可越出安装目录并被 rm_rf）；
  - index 的 Package 字段同样取自清单（缺 package 的包跳过并告警）；
  - scan/export 同步；--help 与错误文案去掉「需要 <pkg>.mpk」。

暂存：MeowAPPs/.stg_<pid>_<pkg>（/usr/data NAND，仅剩 4MB）
  → <MeowROOT>/MeowOS/tmp/pkgs/<pkg>-<UTC时间戳>-<pid>-<n>/（真机即 SD 卡）：
  - mkdir 原子占位 + 失败重试 + pid/序号保证唯一，时间戳只给人看；
  - SD 未挂载/不可写直接拒装（不回退 /usr/data：目标本就在 SD，且跨 fs rename 会 EXDEV）；
  - 解包前后各一道防护：tar -tv 只允许普通文件/目录（拒符号链接/硬链接/设备/FIFO），
    解包后复核暂存树（非普通文件、nlink>1 一律拒）；
  - 中央化 cleanup + SIGINT/SIGTERM/SIGHUP handler（先收子进程组再清）+ atexit 兜底，
    成功/验签失败/清单非法/降级/解压失败/被中断全部删除暂存目录。

真机 time() 受 zig 0.17 mipsel time64 ABI 缺陷影响返回垃圾（实测 3381223399391169494、
localtime_r=NULL），故时间戳直取内核 o32 time32（syscall 4263）并自行换算 UTC，
不依赖 libc time()/localtime_r()。

upgrade 复用 install 同一实现（清单包名必须等于目标包名、目标必须已装）。

新增 host 回归 patch_v2/meowpkg/test_nyai.sh（49 断言：改名包/真实 0.1.7 反例/
footer≠清单/os.meow 无签名/第三方无签名/恶意包名/解压失败/SIGTERM/索引路径/upgrade）。

真机验证（固件 0.8.48，二进制只放 MeowOS/tmp，未覆盖 /usr/bin/nyai）：
os.meow.reader-0.1.4.bak.mpk 现在「签名校验通过 (package=os.meow.reader)」后才被
降级门禁拒绝（旧版此处是包名不符）；weird-name.bin 装成 dev.m35.probe；SIGTERM
中断后暂存目录为空；Music=199164544、/usr/bin/nyai md5 a7d24553… 均未变。
 2026-11-10 21:42:37 +08:00
AskaEth 8f748b137d Merge branch 'feat/m34-font-u-00b7-middle-dot-glyph-missing' 2026-11-10 21:41:39 +08:00
AskaEth 365c8f756b fix(font): 字库生成器补 U+00B7 中点 — 修复 · 渲染豆腐块（M34） 
GB2312 A1A4 经 Python gb2312 codec 解成 U+30FB（MiSans 无该字形 → 空条目），
U+00B7 从未进入字符集；meow_font.c 对「码位不存在」画空心方块，故 format 副题
「Books/ · 595 本」、书行「TXT · 10.3MB」与 M31「· 读」徽标在真机全是豆腐。

build_charset 显式 add(0x00B7)，common/gbk 档生效（full 档本已含）。
重生成 default 字库（28/20px，common）：glyph 4110→4194——+U+00B7 1 个，
另 +83 平假名来自 8/30 tier 重构后 common 字符集扩展（设备字体早于该重构）。
既有 4110 字形两档像素逐字节一致；渲染代码 meow_font.c 未改。
 2026-11-10 20:34:54 +08:00
AskaEth e21cbc7865 Merge branch 'feat/m33-reader-folder-drilldown-navigation' 2026-11-10 19:52:07 +08:00
AskaEth 2881ce908a feat(reader): M33 目录模式逐级下钻 — 子目录/书分层显示（416 本不再平铺） 
- folder 模式从「按第一级目录分段」改为当前目录视图：子目录在前（带子树书数），
  直接书在后；进入/返回只过滤已扫平的 g_books，不 readdir、不重扫（M32 索引不动）。
- 纯函数 shelf_build_rows_at(books,n,folder,cwd,...) + nav 工具（enter/up/breadcrumb/
  count）全部宿主可测；format 模式行序列/副题逐字不变，path 仍是完整路径（进度键不变）。
- 交互：点目录进入；顶栏返回箭头/左缘返回手势回上一级，根层再返回退出 App；顶栏标题=
  当前目录名（按像素宽截断），副题行=面包屑全路径+当前层书数；list/grid 均支持导航。
- 状态：folder↔format、list↔grid 切换保留 cwd；刷新重扫后 cwd 失效则收缩到有书的祖先。
- 边界：空目录不显示（导航只读 g_books，不额外 readdir）；深层目录逐级进入；真实名为
  「未分类」的目录按普通目录处理，不与根层书合并。
- 测试：shelf_group_smoke 63→99 断言；M27 的按第一级分组断言改写为「逐级进入后可见该书」
  （同等强度），新增进入/返回/面包屑/计数/空目录/纯内存/rowcap/UTF-8 截断断言。
- 交付 0.1.7/code8（M32 已占用任务书里的 0.1.6/code7）；真机 0.1.4 未被覆盖。
 2026-11-10 19:26:44 +08:00
AskaEth 190041cd67 Merge branch 'feat/m32-reader-shelf-persistent-index' 2026-11-10 19:03:43 +08:00
AskaEth 58f2d9bff4 perf(reader): M32 r2 书架索引改 level-1 校验 — 真机冷缓存首开 3.47s→0.13–0.16s（r1 全目录校验被真机证伪） 
r1 用宿主 1.1µs/stat + M28 的**热** stat 150µs 外推「434 次≈65ms」，真机 drop_caches 后
实测是 3.15s（7.26ms/次），与 readdir 的 3.0s 同量级：全目录校验的索引命中冷启动仍要
3.06s，只比全扫快 0.2s。「3.0s→0.15s」在冷启动不成立。按任务 1 自己定的判据
（stat 接近 1s 就退回 level-1）改为只校验 Books 根 + 每个一级目录。

真机冷缓存实测（exFAT /usr/data/mnt/sd_0，434 目录/646 文件/595 本；sync + drop_caches；
探针走 /proc/uptime，UI 走 meow_ui_time_ms）：
- 索引命中首开：**127 / 138 / 157ms**（复测 147ms），热 dentry 107–120ms；
- 全量扫描首开：**3428 / 3477ms**（复测 3711ms），热 dentry 不变（readdir 不吃 page cache）；
- 探针冷分项：索引载入 20–30ms；载入+rdprog×595 70–120ms；4 个目录 stat 0–30ms；
- 从阅读页返回书架 29–31ms（M29 语义未变）。
→ 冷启动 22–26 倍提升，方案值得做；索引实测 **63,579B**（v2；r1 全目录 97,490B）。

实现（格式 v2，magic MEOWIDX2 / version 2）：
- writer 回调过滤 rel 含 '/' 的目录：只落 root + 一级目录的 mtime；书/大小/格式记录仍全量；
  level-2+ 不落盘、载入不 stat。载入仍然 0 次 opendir/readdir（strace：0 getdents64，
  真实库 4 次 stat；宿主模拟库 11 次）。
- 校验记录里出现 level-2+ rel 视为坏档；sum(books_here) 改为「≤ nbooks」合理性上界。
- fail-open/原子写/CRC/安全加固/ts 不缓存全部保留（r1 已过评审的部分未动）。

失效矩阵（报文逐条写清）：
自动（根 mtime）：Books 根下直接增/删/改名书；一级目录新增/删除/改名。
自动（一级目录 mtime）：一级目录里直接增/删/改名书、新建子目录。
必须刷新：level-2 及更深处的任何变化（只改深层目录 mtime）。刷新=删索引+全扫。
真机 exFAT mtime 实测 **1 秒**（tm_nsec=0；同秒连续增删 mtime 不变）。我复测 10 轮
「目录刚改过就扫描、同秒再改」→ 9/10 仍命中（陈旧），与评审 29/30 一致；sleep 跨秒后
全部正常失效。头注释已把「10ms」改为「1 秒」，并写明「不在同一秒刻度的变更靠索引失效，
同秒二次变更需刷新」。

bench 修复（P3-3）：MEOW_BENCH_IDX=only —— **不预先 load/scan**，直接进书架量生产首开；
miss —— 先删索引再进书架。两者配合 drop_caches 即冷启动口径。旧行为（先 bench_index/
bench_scan 焐热）保留为默认模式。新增 test/shelf_index_probe_mipsel（write/scan/load/
loadts/statpaths/mtime/size）用于真机分项与 mtime 粒度验证，不进发行包。

测试：shelf_index_smoke 170 pass（新增：level-3/level-2 内变更「索引仍命中且先看到旧
列表 → 刷新后可见」、新建 level-2 目录自动失效、一级目录直接删书自动失效、v2 ndirs=
根+一级数）；ASan+UBSan 干净；build_reader.sh 0 warning，core 6846 / seg 19 / chapter 71 /
shelf_group 63 / index 170 / font 14 / loaders PASS。真机 6 场景逐项验证：一级直接增/
新建子目录/一级改名/根下删书/一级直接删书 = 自动失效；level-3 深处新增 = 仍命中（需刷新）。

交付：app.json 0.1.5/code6 → **0.1.6/code7**；reader md5 5c848c99… 1,711,988B；
mpk md5 10d676f5… 814,574B；未签名不 push。设备验证后已清理 /tmp 与 m32probe，
真实 MeowData 的 shelf.idx 已删（app 自己的章节 .idx 未动），Books 434/646 不变，
已装 0.1.4 md5 4036b889… 未变。
 2026-11-10 18:49:48 +08:00
AskaEth e0dfab95c3 perf(reader): M32 书架索引落盘 — 冷启动只 stat 434 个目录 mtime，跳过 readdir（3.0s→~0.15s） 
M29 只解决了「回书架不重扫」；首次进书架仍要全量扫 434 目录（真机 3.0–3.4s，
其中 opendir+readdir 占 96%）。本单把扫描结果 + 每个扫描目录的 mtime 存到
MeowData/os.meow.reader/index/shelf.idx，冷启动逐目录 stat 比对 mtime，命中即
完全跳过 readdir；任何异常一律 fail-open 全量重扫。

先量再选（任务 1）：宿主 434 目录/595 本/51 rar 虚拟库（贴真机量级）
- 434 次目录 stat = 0.48ms/pass（1.1µs/次，不含 readdir）；
- 读 72KB 索引 = 0.009ms；全量扫描 3.54ms；索引命中 1.29ms（ts_fn=NULL）。
真机按 M28 实测 1079 次 stat=160–170ms（≈150µs/次）外推：434 次 ≈ 65ms，
远低于「可能不可行」的 1s 阈值 → 选「校验全部扫描目录 mtime」（非只 level-1）。
strace 断言：indexonly 载入 0 次 getdents64、恰好 434 次 stat（真的没 readdir）。
生产路径 ≈ 65ms(stat) + <20ms(索引读) + 40–50ms(rdprog×595) + <20ms(build_rows)
≈ 0.13–0.15s（对比 3.0s）。

索引格式 v1（手工小端序列化，不依赖结构体布局）：
header(magic/version/header_size/root_len) + root + dir 记录×(rel,mtime_s,
mtime_ns,books_here) + book 记录×(rel,size,fmt) + trailer(ndirs,nbooks,flags,
depth_skipped,crc32,magic)。truncated/depth_skipped 存在 flags/字段里，载入时
如实重建提示条；**不存阅读进度 ts**，载入后每本由 rdprog_load 现读再排序。

失效语义（存每个扫描过的目录，不只 level-1）：
- level-2 新增 / level-3 深处新增 / 删书 → 该目录 mtime 变 → 重扫；
- 一级目录改名 → 父目录 mtime 变 + 旧目录 stat ENOENT → 重扫；
- 超深（>6 层）未扫描子树不在索引内，其内部变化不自动失效（本来就不显示），
  点「刷新」更新 depth_skipped 计数；mtime 精度受限（exFAT 10ms/FAT32 2s）的
  同刻度变更也可能漏判，点「刷新」必可纠正。
M29 语义不变：首次进书架=索引或全扫；回书架=不扫；刷新=删索引+全扫（之后原子
写回新索引）。

安全/健壮（宁可慢不可错）：
- 写：shelf.idx.tmp 全量写完（尽力 fsync）后 rename；中途被杀只剩 tmp，正式索引
  要么旧要么完整新；rename 覆盖失败先删旧再改名；fflush/写错即放弃，绝不影响书架。
- 读：O_NOFOLLOW|O_NONBLOCK + S_ISREG（FIFO/符号链接直接拒绝不阻塞）；CRC32 覆盖
  全部记录；rel 做绝对路径/“..”/内嵌 NUL/长度校验；版本/根路径/计数/逐目录 mtime
  任一不符即重扫；载入崩溃路径全部 goto 清理，不改书架可用性。
- writer_open 失败（卡满/写保护/无 MeowData）→ 扫描不采集目录、照常出书；
  commit 失败（含只读目录 rename 失败）不留正式索引。

测试：test/shelf_index_smoke 154 pass（含四种变更场景失效、截断/字节翻转/垃圾/
缺失/FIFO/符号链接/版本不符/根路径不符、ts 现读、truncated/depth_skipped 重建、
只读目录写失败、空 Books、root 缺失、.tmp 残渣），ASan+UBSan 干净；
test/shelf_index_bench 模拟 434 目录/595 本/51 rar：scan/load 均 595 本、
truncated=0/depth_skipped=0、索引 72,156B。build_reader.sh 全绿 0 warning
（core 6846 / seg 19 / chapter 71 / shelf_group 63 / index 154 / font 14 /
loaders PASS）。shelf_bench_ondev 增加 index_load/scan_save 计时与
MEOW_BENCH_IDX=miss（真机首开命中 vs 未命中对比，待有卡复核）。

交付：app.json 0.1.4/code5 → 0.1.5/code6；reader md5 df4cadcf
1,711,924B；mpk md5 fec7b1bb 814,535B；未签名不推卡。
 2026-11-10 18:14:52 +08:00
AskaEth 3f09f7c137 Merge branch 'feat/m31-reader-font-memo-and-read-badge' 2026-11-10 13:48:49 +08:00
AskaEth dc9bfdbdaf perf(reader): M31 字体路径记忆化（开书字体查找 35 目录 walk → 1 次 stat）+ 「· 读」徽标即时刷新 
字体：find_font_rec/resolve_font 从 reader.c 抽到 app/font_resolve.c 并加进程内记忆化。
只缓存成功路径；命中后仍做一次 access() 校验（字库被删即重扫）；没找到不缓存，
用户之后拷入的字库下次开书即可找到。顶栏「刷新」额外调 font_cache_invalidate()，
给「新拷入字库、旧字库仍在」一条显式失效路径。宿主实测：35 目录树 walk 0.026~0.54ms
（=300+ 次系统调用）vs 命中 0.001ms（1 次 access）；开书路径每次省一次完整 walk。

徽标：副题格式化抽成 shelf_fmt_sub()（扫描与「刚读完置顶」共用一份实现），
promote_just_read() 改 ts 后立即重算这本的 sub/sub_folder，「· 读」不再等下次全量刷新。

回归：test_reader_core 6846、shelf_group_smoke 63（+8）、font_resolve_smoke 14 全绿；
build_reader.sh 0 warning；扫描缓存/进度语义未改。app.json 0.1.3/code4 → 0.1.4/code5。
 2026-11-10 13:39:32 +08:00
AskaEth 0b30cdbafb Merge branch 'feat/m30-reader-drop-unused-next-page-slot' 2026-11-10 13:30:44 +08:00
AskaEth a9638fa59c perf(reader): M30 删掉无人消费的下一页预取槽（refill 渲染减半、常驻 −0.69MB）+ 回书架置顶刚读完的书 2026-11-10 13:22:35 +08:00
AskaEth dc559aa1ac Merge branch 'feat/m29-reader-shelf-scan-cache-and-row-draw' 2026-11-10 13:11:58 +08:00
AskaEth bece9848e7 perf(reader): M29 书架扫描缓存 + 行数多时关圆角容器（回书架 3.4s→0.03s，滚动 52ms→19ms） 
真机（0.8.48 / reader 0.1.1 基线，同机同字库 ztest 实测）：
- 从阅读页返回书架：3435ms（3259–3531）→ 33ms（24–54）。根因是 shelf_on_enter 无条件
  scan_books()：exFAT 全量扫描 434 目录 = 3.1s。改为进程内缓存（首次进入才扫，顶栏
  「刷新」强制重扫）；truncated/depth_skipped 提示语义不变（首次扫描时算好并保留）。
  行为变化：新进 Books/ 的书、刚读完那本书的「最近阅读置顶」需点一次「刷新」才更新。
- 书架滑动每步（62px，含 widget_draw + flush）：51.9–56.2ms → 19.3–19.9ms。
  行数 > 200 时 meow_listview_set_container(0)（扁平行），≤200 行仍用 MD3 圆角卡；
  圆角卡走 meow_gfx_fill_round 逐像素 rr_inside（464×54 一张 3.8–6.4ms ×11 行）。
- 首次进书架仍需扫一次（3497ms，含 3157ms 扫描）；595 本全可见、format/folder 分组不变。

另加 test/shelf_bench_ondev.c（真机耗时基准，不进 mpk）与 build_reader.sh 的编译步骤；
app.json 0.1.1/2 → 0.1.2/3。未做（按塔砍范围）：字体路径记忆化、首屏只渲染当前页、
自绘行、mtime 失效检测。
 2026-11-10 12:54:17 +08:00
AskaEth 288c133efc Merge branch 'feat/m27-reader-shelf-folder-grouping' 2026-11-09 22:52:43 +08:00
AskaEth e0a82a3d47 fix(reader): M27 r3 评审整改 — cap 边界截断/默认副题不变/提示两行且 6s 消失/版本号 
对应评审 P2-1、P3-7、P3-1、P3-2、P3-10、P3-9：
- P2-1：scan_dir 在目录边界遇 cap 时探测子树（count_books_under）再置 truncated；
  同目录内超限逻辑不变。新增两条断言：cap 卡边界 → truncated=1；恰好装满且后续为空目录 → 不误报
- P3-7：shelf_book 拆 sub（默认副题，与 base 逐字一致）/sub_folder（folder 模式前置子路径）；
  list 按模式选，宫格始终用 base；断言 format 副题逐字等于 base
- P3-1：超量+超深合并提示拆两行绘制（610 起，不再被 480px 右缘切掉）
- P3-2：提示 6s 到期自动消失（app.c 书架前台时调 shelf_on_tick）
- P3-10：app.json version 0.1.1 / version_code 2
- P3-9：shelf_scan_bench.c 头部注明 /proc/uptime 10ms 分辨率、只适合真机
 2026-11-09 22:45:01 +08:00
AskaEth 63ead3ec1e fix(reader): M27 r2 — 扫描深度提到 6 + 按 Books 第一级目录分组 
真机真实布局暴露两处问题（评审 P1）：
- Books/400+本高质量完本合集/<分类>/<作品>/<书名>.txt 在 depth 3-4，旧 depth≤2 让 413 本 3.8GB 不可见
  → SHELF_SCAN_MAX_DEPTH=2→6；report 新增 depth_skipped，超深书籍文件计数并在 g_notice 可见提示
  （有 N 个文件因目录层数超过 6 层未显示），不再静默
- 按完整相对路径分组会把 413 本书炸成 410 个每条 1 书的段头
  → 分组键改为 Books/ 第一级目录（shelf_book.top）；完整相对路径仍在 group[]，
    第一级之后的子路径（分类/作品）放进副题 sub（如 01、玄幻/01、斗破 · TXT · 2.1MB）
  → 真机书库只剩 3 组：400+本高质量完本合集 / kh / 轻小说
- 单测 50 断言：depth3/4 收录、depth7 计入 depth_skipped、四种真实路径的组名、
  a/b 与 a/c 同组 a、副题含子路径、format 回归、根组未分类、path/进度不变
 2026-11-09 22:29:46 +08:00
AskaEth 409fd1edf7 feat(reader): M27 书架按目录分组（ui.shelf_group=folder|format，默认 format 不变） 
- 新增 shelf_model.c/.h：扫描/行序列从 shelf.c 拆出（纯 C，宿主可测）；shelf_book 加 group[96]（相对 Books/ 的目录路径，根下空串），path 语义/内容完全不变（进度键仍为 rdprog_hash(path)）
- folder 模式：目录段头（根下=未分类），未分类置顶、其余按目录名排序；组内沿用最近阅读优先/其次书名；空目录不产生段头
- format 模式逐行保持旧行为；新增 reader.conf ui.shelf_group，缺键默认 format
- 上限 256→2048（SHELF_MAX_ROWS=2N=4096，段头≤书数），超限置可读提示，不再静默截断
- 顶栏加「目录/格式」切换，设置页加「书架分组」；UTF-8 安全截断长中文目录名
- 单测 test/shelf_group_smoke.c（38 断言）+ 计时 test/shelf_scan_bench.c
- build_reader.sh：链 meow_ui.a 解析冒烟 stbi_*；无 qemu 时跳过执行而非失败
 2026-11-09 21:55:33 +08:00
AskaEth db672cbe8f Merge branch 'feat/m26-sdk-image-stack-into-main-repo' 2026-11-06 21:35:50 +08:00
AskaEth 281f4153ee fix(sdk): M26 r1 P1 — ILP32 尺寸算术溢出（畸形 BMP 经公开入口 SIGSEGV）+ 加 S17 回归 
评审在 ARM32（ILP32，与 mipsel 同数据模型）实测：54 字节 BMP 头声明 w=2^27、bpp=32
时 w*bpp 回绕成 0 → rowsize=0 → malloc(0) → 采样索引 row+sx*4 越界读 → SIGSEGV，
经 meow_img_load_file_dim 端到端可触发；同一文件在 LP64 宿主返回 NULL（不溢出），
合并前走 stb 也是 NULL。即这是相对旧路径的鲁棒性回归。

修复（只加闸，正常路径数值不变）：

- meow_png_stream.c（P1 本体）
  · 新增 ILP32 守卫 MZP_MAX_DIM=1<<20 与 mzp_bytes_ok()（unsigned long long 验算，
    超过 SIZE_MAX 即拒）
  · BMP：声明尺寸先升 int/long long 校验（w/h 单边 ≤1<<20；h=INT_MIN 用
    -(long long)hi 取绝对值，不再有 -h 溢出）；rowsize 用 64 位算并验；
    行偏移 off / 采样下标 sx 改 long long，sx 夹在 [0,w-1]；按行 fseek 前加
    off > LONG_MAX 拒绝；目标 RGBA 字节数 64 位验后再 malloc
  · PNG：IHDR 尺寸原已 ≤65535，补上 tw*th*4 的 64 位校验（32768²×4 = 2^32 会回绕），
    emit_row 的 sy/sx 与输出行偏移改 64 位并夹紧
- meow_jpeg.c（顺手审计同类 32 位算术，评审要求「不要只修点名那处」）
  · mj_layout 返回 unsigned long long（单平面/三平面之和都可能越 2^32），
    越界返回 MJ_LAYOUT_BAD → mj_sof 各处重新布局后都检查
  · target_bytes 与分量 plane malloc 改 64 位验算；目标图字节超 MJ_PEAK_CAP 直接拒
  · mj_output：输出缓冲 64 位验；y*vh / x*vw 采样改 long long 并夹紧
  · meow_img_target_dims / mj_pick_n 的 (long)h*maxdim、8*maxdim 改 long long

- test_meow_img_stream.c：新增 S17（10 组畸形 BMP 声明尺寸 + 2 个合法正例 +
  PNG 回绕点），断言「后端拒绝 + 公开入口不崩（越界尺寸另断言 NULL 且不分配）」；
  文件头补 ILP32 交叉编译命令（宿主 LP64 看不到 32 位回绕，测试注释里明写这一点）

验证：同一测试在 zig arm-linux-musleabi（sizeof(long)=4）下 S1-S17 全绿（206 checks，
exit 0）；把后端换回 r1 提交的旧实现，同一 ARM32 二进制 exit 139（说明 S17 真能抓）；
宿主 LP64 S1-S17 全绿、B1-B9 全绿；静态库 --verify 仍 78 成员 / 全 MIPS32r2。

同步提醒：这些行与公开仓 ~/Proj/MeowOS-SDK/sdk/{meow_png_stream.c,meow_jpeg.c} 逐字节
同源，同一补丁必须由控制塔同步过去，否则立刻产生双边漂移。
 2026-11-06 21:27:03 +08:00
AskaEth ee5796747d feat(sdk): M26 公开仓真缩解图像栈并入主仓 — JPEG DCT/PNG 逐行/BMP 跳行后端 + RGB565 页图 
主仓 SDK 的图片层原本是 220 行 stb 直通（整幅解码后重采样）。公开仓 MeowOS-SDK
的同一子系统已被真实 App（tuku 阅读器）驱动并做过峰值实测与像素比对，故以公开仓
为权威方向并入主仓 meow_ui.a，两个方向的新功能都保留（逐文件 diff 确认公开仓是
严格超集：无一处「双方互有增减」）。

- 新增 meow_jpeg.c / meow_jpeg.h：DCT 域缩解 1/8、1/4、1/2（N=1/2/4 点 IDCT），
  渐进式只解到首个精细化扫描；不支持项（CMYK/YCCK、算术编码、过订阅 DHT、16bit
  量化表）返回 0 由调用方回退 stb
- 新增 meow_png_stream.c：libz 逐行 inflate + 反滤波，按步长丢行丢列直写目标尺寸；
  BMP 按目标行 seek + 行内跳列（8/16/24/32bpp）
- meow_ui_img.c + include/meow_ui_image.h：新增 meow_img_pick_scale /
  load_file_step / load_file_step_ex / resample 四个公开入口；_dim 与 _mem_dim
  先进后端，失败/不支持才回退 stb（对外语义不变）
- include/meow_ui_draw.h + meow_ui_gfx.c：M32 RGB565 页图 5 函数
  （meow_gfx_rgb565 / rgba_to_rgb565 / blit_rgb565 / _scaled）。gfx 保留主仓的
  `#include "../meow_launcherd/meow_font.h"` 与 <time.h>（公开仓自 vendored
  meow_font.h 且无 <time.h>，机械覆盖会丢这两行）
- meow_jpeg.h 保持内部：不进 meow_ui.h 伞头，include/ 下无任何头暴露 meow_jpeg_*
- build_sdk.sh：OBJS 插入 meow_jpeg / meow_png_stream（32→34）；成员数
  76→78（+meow_font.o +43 freetype），--verify 全为 ELF32 MIPS32 rel2/o32
- 测试：新增 test_meow_img_stream.c（S1-S16），test_meow_img_budget.c 同步公开仓
  版（B9 断言收紧为 p_new <= p_old）；22 个既有宿主测试的编译注释行补
  meow_jpeg.c / meow_png_stream.c / -lz（meow_ui_img.c 现引用后端符号，不加即
  undefined reference）

宿主实测：S1-S16 全绿（S7 与 stb 网格像素一致：JPEG mad 4.35-13.69、PNG/BMP
mad 0.00；S9 回退矩阵 CMYK/1bpp BMP/Adam7 均拒绝且 stb 仍成功），B1-B9 全绿
（B9 PNG 峰值 25.65→0.61 MiB、BMP 14.65→0.59 MiB）。回归 test_meow_ui_widgets /
scroll / ime_fix / test_umbrella 全过。zlib 在应用链接期解析：meow_ui.a 只留
inflate* 未定义符号，四个 App 构建脚本原本就带 $SYSROOT/lib/libz.a，静态
linkcheck（meow_ui.a + libz.a -lpthread）通过。

注：主仓 patch_v2/reader_app 仍自带 vendored stb、不用 meow_img_*，本单不改变
阅读器的内存占用；RGB565 页图接入 reader_app 是另一个任务。
 2026-11-06 20:44:22 +08:00
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