MeowOS-SDK

126 Commits 2 Branches 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	c775f8558c	fix(tuku): 评审 P2-1/P2-2——解压页与缩略图缓存互删自愈 + 大页溢出文档化 P2-1（必修）：解压页缓存与缩略图 LRU 在 .bmp 上相互踩踏 - ui/library 的 cache_prune 先按 page_cache 的共用判据 mr_cache_is_page_name 跳过 mrpage_，不再把 BMP 解压页算进缩略图额度或 unlink（含 Vol10.cbz 这类 BMP 档不再出现「被缩略图 LRU 删掉 → 首页解码失败」）； - mr_cache_touch 命中时 stat 校验文件存在与大小，缺失/尺寸不符即移出索引并按未命中返回，调用方重新解压——外部清理/掉电残留/误删都能自愈，不再返回死路径。 P2-2（文档化一次性溢出）： - page_cache.h 与 make_room_locked 写明：单条目本身超过 32MiB 时只保留该条、其它全部淘汰，占用上限受页源单页 64MiB（MR_ZIP_PAGE_MAX_BYTES）约束；大页仍可读，不因预算拒绝落缓存。 - 新增 33MiB 页夹具（PNG 头 + 可压零填充，deflate 后仅数十 KB）与断言：大页可读、cache_bytes 允许超 32MiB、小页被淘汰、再来小页时大页按预算淘汰。顺手：page_cache.h 注释包名 os.meow.picobrowser → os.meow.picbrowser（测试路径同步）。测试：test_cbz 267 → 296 项全 PASS；run_tests.sh（zip 106）与 run_webtoon_tests.sh 全绿；交叉构建 sdk/tuku 零警告，产物静态 MIPS32r2 ELF。	2026-11-05 12:13:47 +08:00
AskaEth	562cc44931	feat(tuku): CBZ 档案册集成——档案页源/书库列册/解压缓存 - logic/reader/archive_source.c：档案册页源实现 M6 mr_book 契约（mz_open/mz_count/mz_entry_at/mz_read_alloc），条目自然序 + 图片后缀 + 路径安全（`..`/绝对路径/反斜杠/隐藏段/内嵌 NUL）+ 单页尺寸上限过滤； meta 按需解压只读图片头（不落缓存，结果按页记忆）；mr_book_open_auto 统一目录册/档案册开册，翻页与条漫两套消费代码零改动。 - logic/reader/page_cache.c/h：解压页落 MeowData/<pkg>/cache，LRU 64 页或 32MiB，启动清 mrpage_* 孤儿，写入 .part + rename；与缩略图缓存同目录、前缀隔离；互斥量保护，解码/缩略图线程可并发。 - logic/library.c/h：扫描直接子文件里的 .cbz/.zip 成册（行=文件名+页数，点入直接阅读）；档案探测由调用方注入（logic 不依赖 zip 容器），不注入时与 M7 行为逐字一致；册间衔接兄弟表=含图目录∪含页档案册，同列自然序。条目构造/副标题/角标/兄弟判据拆成小函数，便于 M13 书库重写拼接。 - ui/library：档案册行 + 封面缩略图（解压档内首图）、扫描注入探测、缓存目录统一由 page_cache 推导（一份规则）。 - ui/reader：open_book 走 mr_book_open_auto；跨册衔接纳入档案册。 - build_tuku.sh 补 zip/archive/cache 源与 sysroot zlib 头（zip.c include <zlib.h>）；run_tests.sh 纳入 zip+cbz 用例；run_webtoon_tests.sh 的宿主集成构建补新源与 -lz；.gitignore 同步测试产物。 - test/test_cbz.c（267 项断言）+ make_cbz_samples.py 真实 cbz 夹具：列档/自然序/解压字节 CRC/路径安全/坏档与 zip 炸弹容错/LRU 与 32MiB 上限/ 启动清孤儿/续读角标/封面首图。	2026-11-05 11:58:12 +08:00

Author

SHA1

Message

Date

AskaEth

c775f8558c

fix(tuku): 评审 P2-1/P2-2——解压页与缩略图缓存互删自愈 + 大页溢出文档化

P2-1（必修）：解压页缓存与缩略图 LRU 在 *.bmp 上相互踩踏
- ui/library 的 cache_prune 先按 page_cache 的共用判据 mr_cache_is_page_name
  跳过 mrpage_*，不再把 BMP 解压页算进缩略图额度或 unlink（含 Vol10.cbz 这类
  BMP 档不再出现「被缩略图 LRU 删掉 → 首页解码失败」）；
- mr_cache_touch 命中时 stat 校验文件存在与大小，缺失/尺寸不符即移出索引并按
  未命中返回，调用方重新解压——外部清理/掉电残留/误删都能自愈，不再返回死路径。

P2-2（文档化一次性溢出）：
- page_cache.h 与 make_room_locked 写明：单条目本身超过 32MiB 时只保留该条、
  其它全部淘汰，占用上限受页源单页 64MiB（MR_ZIP_PAGE_MAX_BYTES）约束；
  大页仍可读，不因预算拒绝落缓存。
- 新增 33MiB 页夹具（PNG 头 + 可压零填充，deflate 后仅数十 KB）与断言：
  大页可读、cache_bytes 允许超 32MiB、小页被淘汰、再来小页时大页按预算淘汰。

顺手：page_cache.h 注释包名 os.meow.picobrowser → os.meow.picbrowser（测试路径同步）。

测试：test_cbz 267 → 296 项全 PASS；run_tests.sh（zip 106）与
run_webtoon_tests.sh 全绿；交叉构建 sdk/tuku 零警告，产物静态 MIPS32r2 ELF。

2026-11-05 12:13:47 +08:00

AskaEth

562cc44931

feat(tuku): CBZ 档案册集成——档案页源/书库列册/解压缓存

- logic/reader/archive_source.c：档案册页源实现 M6 mr_book 契约
  （mz_open/mz_count/mz_entry_at/mz_read_alloc），条目自然序 + 图片后缀 +
  路径安全（`..`/绝对路径/反斜杠/隐藏段/内嵌 NUL）+ 单页尺寸上限过滤；
  meta 按需解压只读图片头（不落缓存，结果按页记忆）；mr_book_open_auto
  统一目录册/档案册开册，翻页与条漫两套消费代码零改动。
- logic/reader/page_cache.c/h：解压页落 MeowData/<pkg>/cache，LRU 64 页或
  32MiB，启动清 mrpage_* 孤儿，写入 .part + rename；与缩略图缓存同目录、
  前缀隔离；互斥量保护，解码/缩略图线程可并发。
- logic/library.c/h：扫描直接子文件里的 .cbz/.zip 成册（行=文件名+页数，
  点入直接阅读）；档案探测由调用方注入（logic 不依赖 zip 容器），不注入时
  与 M7 行为逐字一致；册间衔接兄弟表=含图目录∪含页档案册，同列自然序。
  条目构造/副标题/角标/兄弟判据拆成小函数，便于 M13 书库重写拼接。
- ui/library：档案册行 + 封面缩略图（解压档内首图）、扫描注入探测、缓存
  目录统一由 page_cache 推导（一份规则）。
- ui/reader：open_book 走 mr_book_open_auto；跨册衔接纳入档案册。
- build_tuku.sh 补 zip/archive/cache 源与 sysroot zlib 头（zip.c include
  <zlib.h>）；run_tests.sh 纳入 zip+cbz 用例；run_webtoon_tests.sh 的宿主
  集成构建补新源与 -lz；.gitignore 同步测试产物。
- test/test_cbz.c（267 项断言）+ make_cbz_samples.py 真实 cbz 夹具：
  列档/自然序/解压字节 CRC/路径安全/坏档与 zip 炸弹容错/LRU 与 32MiB 上限/
  启动清孤儿/续读角标/封面首图。

2026-11-05 11:58:12 +08:00