Files
MeowOS-SDK/tuku
AskaEth 11e09af7a4 图库: 修 M27 评审 P1 门控旁路 + 三个 P2(r1)
P1-1:判定为 backend 的页不再无条件放行 + 后端中途失败不再静默回退 stb。
- meow_img_load_file_step_ex 增加 allow_stb_fallback 参数:0 = 只试后端,
  失败返回 NULL(坏图占位),绝不回落 stb。阅读器按 dec.path 传入。
- 旧行为实测:截断 12MP JPEG 18,403kB、3000×3000 24bpp 头-only BMP 36,056kB、
  非法位深 PNG 16,409kB(stb 都"成功"出图)。修复后:
  截断 JPEG 275kB→NULL、头-only BMP 908kB→NULL、非法位深 PNG 门控占位(0 分配)。

P2-1:PNG 支持矩阵补 png_depth_ok 同式(color 2/4/6 仅 8/16;color 3 无 16;
color 0 允许 1/2/4/8/16),不再出现「矩阵说支持、后端拒绝」。
P2-2:后端命中页也保留两道安全阀:MemAvailable<6MB 占位、估算 >12MB 硬上限占位。
P2-3:B8 指标改为「窗口稳定后只 reset 一次」,量整个 30 翻窗口内相对稳态基线的
最大存活增量(淘汰不再掩盖峰值),并打印稳态/驻留/增量。
P2-4:page_source.h 的估算精度口径限定为「后端命中/典型页」。

回归:
- B7c 新增截断 12MP JPEG / 24bpp 头-only BMP / 非法位深 PNG,断言 backend-only
  NULL 且峰值 ≤3MB、或 stb 门控占位;B7 典型页与 B7b 回退矩阵保持全绿。
- test_reader_many_pages 恢复 24bpp 头-only 夹具(1bpp 保留):24bpp 判 failed、
  1bpp 判 skipped;断言 failed=2 / skipped=1。
- run_tests.sh / run_webtoon_tests.sh EXIT=0;sdk/test_meow_img_stream ALL PASS;
  交叉构建(SDK + tuku)零警告。
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)。