Files
MeowOS-SDK/tuku
AskaEth 40751c09bd Tuku reader: 真实解码峰值模型 + 3MB 硬阈值 + 解码取消 + 3 槽(M22 止损版)
真机(R3 Pro II 480×720 / MemTotal 56872kB):空闲 RSS 6044kB → 翻页 11400kB →
峰值 15600kB(MemFree 仅 1404kB)→ SIGKILL。M20 审计坐实根因是「单页解码瞬时峰值」,
且旧模型把 stb 当缩解库,对 JPEG 低估 3.5–8 倍(实测 baseline 2000×3000 +10.1MB、
渐进 +23.5MB、1200×1600 PNG +12.9MB)。本次按实测重定预算:

- 真实峰值模型 decode_peak_bytes():JPEG 分量面(+渐进 short 系数面)、PNG 源缓冲 +
  RGBA 转换副本、BMP 直写目标,再叠精修/落框两段一次性重采样;上限常态 3MB
  (MR_DECODE_PEAK_CAP),只有 MemFree 真富余时才放宽到 min(12MB, MemFree-4MB)。
- 超预算时的降级:JPEG 逐步加粗 stbi 缩解档位(meow_img_load_file_step),
  PNG/BMP 无解码期缩放 → 占位;结果精确重采样回显示框(meow_img_resample),
  命中页仍是单次 blit(M17 热路径纪律不破)。
- 占位可重试(g_page_skip 与永久失败 g_page_fail 分离):焦点页冷却 1.5s 自动重试、
  中间区点按立即重试、离开再回来即重试;坏图仍是永久占位。
- 解码前内存门控:MemAvailable < 6MB 不解码(读不到就放行,不猜)。
- 解码请求取消:worker 出队后、mr_book_open 前二次判 gen/窗口;拖动/fling 期间只解落点页,
  预取邻居仅当 MemAvailable ≥ 12MB。
- 先释放再解码:queue_page 按落地字节 slots_reserve() 先淘汰不可见旧图;可见页不淘汰。
- 槽位 4→3、常驻上限 9MB→3MB、结果队列 4→2。
- 可观测性:`reader decode page=N src=WxH peak=XkB memfree=YkB memavail=ZkB ok|skip=… step=S ms=M`
  与进出阅读器 rss/hwm/memfree/memavail。

page_source: 头部探测新增 codec/progressive/channels/planes(mr_probe_info),
只带最小 SOF 的合成头仍能取尺寸(旧契约不退化)。

宿主证据:新增 test_reader_membudget(--wrap malloc 计真实峰值):
PNG 600×960 model 4001kB vs 实测 3943kB;JPEG 1000×1500 step2 model 3749/实测 3711;
连翻 100 页 peak_transient 0kB(先释放再解码让缓冲复用)、驻留 ≤3MB、解码 100 次(取消生效)、
3MB 阈值下 1.5MP JPEG 可解、4MP JPEG 需 MemFree 放行(否则占位)、渐进式模型更高于 baseline。

run_tests.sh 全绿(含 zip 106 / cbz 325)、run_webtoon_tests.sh 全绿、SDK 与 tuku 交叉构建零警告。
2026-11-05 21:28:50 +08:00
..

tuku(os.meow.picbrowser)打包与签名

图库 App(系统包名 os.meow.picbrowser)。构建与打包:

./build_tuku.sh            # 交叉编译 picbrowser(MIPS32r2 静态)
./pack_tuku.sh             # 打包 → os.meow.picbrowser.mpk(根布局;未签名)

浏览交互(文件管理器模型,M18)

  • 列表 = 当前目录一层的子目录 + 受支持图片(png/jpg/jpeg/bmp)+ 档案册(.cbz/.zip); 目录优先,组内自然序(大小写不敏感,同键按原始字节兜底,A.jpg/a.jpg 不抖动)。
  • 点目录 = 进入(空目录也进);点图片 = 从该图开始读(按文件名交给阅读器, 由阅读器的全量目录册定位起始页——列表被 MR_LIB_SCAN_MAX 截断时也不会点错图); 点档案册 = 打开档案册(第 1 页/续读)。
  • 单目录超过 2000 项时列表只显示前 2000 项并给出「已截断」提示行;图片仍可进入阅读器翻到。
  • 缩略图功能已关闭:行内只有类型图标 + 文件名 + 类型·大小;首帧只做单层 opendir/readdir + lstat,滚动/点击路径不解码、不访问文件、不重排字符串。
  • 浏览根锁定 TF 卡根(/usr/data/mnt/sd_0):根目录不显示返回箭头,左缘返回 = 退出 App; 不允许上溯到 SD 卡的上级目录。
  • 根目录不可访问(未插卡/挂载失败)→ 友好空态「未检测到 SD 卡」;点顶栏刷新或重进页面即重扫, 不弹错、不崩溃。

一键签名出包

MEOW_SIGN_KEY=/path/to/signing.key ./pack_tuku.sh
  • 工具查找顺序:$MEOW_SIGN → PATH 里的 meow_sign → $HOME/Proj/MeowOS-For-R3P2/patch_v2/meow_sign/meow_sign。
  • 私钥:$MEOW_SIGN_KEY。未设置时脚本警告并仍产出未签名包(退出码 0);但 os.meow.* 系统包无签名会被设备拒装。
  • 有工具 + 密钥时执行 meow_sign sign <mpk> <key>;若存在 <key>.pub 再执行 meow_sign verify <mpk> <key>.pub。
  • 私钥不入库、不随包分发;本仓不包含任何密钥材料。

mpk 布局

.mpk = tar.gz,条目直接在根层:

os.meow.picbrowser.mpk
├── app.json
├── picbrowser
└── <signature footer>   # 仅签名包有(Ed25519,尾部追加)

即 tar -C build/os.meow.picbrowser -czf os.meow.picbrowser.mpk app.json picbrowser—— 不带 os.meow.picbrowser/ 目录前缀,也不带 ./ 前缀。脚本在签名前用 tar -tzf 断言这一点。

签名是往 tar.gz 尾部追加 footer,签名后的 mpk 不要再跑 tar -t / gzip 之类的命令: gzip 会报 trailing garbage ignored,属预期现象,不是包损坏。要检查布局请在签名前做。

安装

把 .mpk 放到设备 TF 卡,执行 nyai install os.meow.picbrowser.mpk; os.meow.* 包必须验签通过(footer.package == 文件名茎 == app.json.package)。