# tuku（os.meow.picbrowser）打包与签名

图库 App（系统包名 `os.meow.picbrowser`）。构建与打包：

```sh
./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 卡」；点顶栏刷新或重进页面即重扫，
  不弹错、不崩溃。

## 一键签名出包

```sh
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`）。