Files
MeowOS-SDK/tuku
AskaEth 1725af631b 图库: 门控模型接真缩解后端 + _step 全格式后端(M27)
M23 交付了真缩解后端却「修好了用不上」:_step 只接 JPEG,而阅读器的峰值模型
仍是 stb 口径(PNG/BMP 按 W·H·4、JPEG 按缩解后整幅 RGBA),12MP/PNG 页全被判
超预算占位。本次把两处缝焊上:

- sdk/meow_ui_img.c:meow_img_load_file_step 的 JPEG-only 限制放开到 PNG/BMP;
  新增 meow_img_load_file_step_ex 回报实际路径(backend/stb),日志可核对预判。
- tuku/logic/reader/page_source.[ch]:新增 reader_estimate_peak(),成为峰值模型 +
  预算 + MemAvailable 门控的唯一实现(reader 不再另写一份)。
  * 后端命中(JPEG SOF0/1/2、≤3 分量、8bit、N=1..7;PNG 非交错/标准压缩/合法色型;
    BMP DIB≥40/BI_RGB/8·16·24·32bpp)→ 峰值 = 目标图 + 分量平面/行缓冲 + 固定开销,
    与源分辨率无关 → 直接放行,不门控;
  * 只有回退 stb(CMYK/算术编码、Adam7、RLE/1-4bpp、N≥8 小图等)才按 M22 stb 模型
    算峰值,超 3MB 或 MemAvailable <6MB 才占位。Adam7 另补 stb 的整幅暂存上界。
- reader:删掉本地 stb 模型/常量,统一调 reader_estimate_peak;日志加 path=backend|stb。
- 测试:6 类典型页(2000×3000 baseline/渐进/restart、1600×2400 PNG/BMP、4MP、12MP)
  断言全部 backend + 不占位 + 估算 ≥ 实测且 ≤1.5×(实测 1.03–1.08×);两条路径输出
  尺寸逐像素一致;CMYK/Adam7/1bpp 断言走 stb 并按旧门控占位;连翻 30 页无占位、
  单页分配峰值 ≤3MB;membudget 链接补 meow_ui_time.c 与 M23 两个解码 TU。
2026-11-06 11:46:16 +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)。