AskaEth/MeowOS-SDK
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
149 Commits 2 Branches 0 Tags
1725af631bf8031ce176e8085f18d3e71a4ee1cf
Commit Graph
7 Commits
Author SHA1 Message Date
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
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
AskaEth 4befbfe14c 图库: 书库点图改按文件名定位（修 P1 截断错位）+ 册间衔接根锁定（M18 评审 r1） 
P1-1（会静默开错图）：取消「书库从列表推导图片下标」。
- 新增 mr_reader_open_dir_at_name(dir, name)：阅读器打开目录册后，在**自己刚枚举出的
  全量目录册**（mr_dir_book，与翻页同一份枚举）里按 basename 定位起始页（先精确，
  再大小写不敏感兜底；找不到退回续读/首页）。书库点击只传文件名。
- 删除 mr_library_image_index（不再有跨枚举的隐式契约）。
- 截断提示文案改为「仅显示前 2000 项（图片可在阅读器中翻到）」。
- 修复前（cb02722 探针，2100 张 4 位名夹具）：rows=2000/truncated=1/
  library_images=2000/reader_pages=2100/**mismatched=590**（首行 p1412 → 打开 p1411）；
  评审夹具为 1995/2000。修复后：2000 个可见图片行按名定位 **0 mismatch**，
  2100 页全量可翻；26 次真实 UI 点开（首尾各 3 + 20 个确定性伪随机）逐张命中。

连带处理（评审 r1）：
1. 删掉 reader_page_enter 的 c->view 死写（reopen 判定用 activity active/depth）；
   顺手删掉 library_page_create 里同款死写。
2. 阅读器册间衔接根锁定：新增 mr_path_within_root + mr_book_adjacent_rooted，
   book_switch 用浏览根（默认 MR_ROOT_DIR，测试可注入）钳制相邻册；
   根外的兄弟册按「没有相邻册」处理。test_cont_adjacent A7 验证「明文 _ex 会越根、
   rooted 拒绝、根内翻册不受影响」；test_mode_switch_host H6 验证条漫末页不越根。
3. test_reader_perf 不再依赖顶栏 tap 命中时序：模式切换改走测试钩子
   mr_reader_test_toggle_mode()（与顶栏动作同一个 mode_set），负载下稳定。
4. page_cache 注释去掉「缩略图缓存/缩略图线程」过时描述（只改文字）。

回归：run_tests.sh（library 81 / nav 74 / lazy 57 / perf 25 / … / open_book 含 2100 用例）
与 run_webtoon_tests.sh（含 A7/H6）全 PASS；交叉构建零警告。
 2026-11-05 20:26:40 +08:00
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
AskaEth ff97f3cee7 feat(tuku): M7 条漫模式与续读——模式一键切换/每册记忆、视口±1 懒解码、滑块跳页、册间衔接 
- 条漫：meow_scroll 跟手+fling，按滚动位置懒解码视口±1 页（驻留上限 4 页）；
  排版用 mr_book_meta 累加适宽高度（nav.c 纯逻辑，宿主可测）
- 模式：阅读 chrome 图标一键切翻页/条漫；每册模式与 last page 经 meow_config 持久化
  （reader.mode/page.<FNV1a64(册路径)>），重进该册恢复模式与页码
- 续读：离开/翻页/滚动停止节流落盘；书库扫描给含图册副标题追加「· 续读 Pn」
- 册间衔接：末页前进→同父目录下一含图册首页，首页后退→上一册末页；无相邻册轻提示不退出
- 跳页：chrome 内 meow_slider，目标页预解码完成后落位（2.5s 超时降级提示）
- 解码：改走 M12 预算解码 meow_img_load_file_dim；超大 PNG/BMP 先 probe 预判，
  超 40MiB 原始 RGBA 跳过并显示「图片无法显示」，12MiB 以上记 WARN（如实保留残余风险）
- 测试：新增条漫排版/跳页状态/模式续读持久化/册间边界宿主测试，以及真实 SDK 源码树上的
  阅读器集成测试（模式切换/跳页落位/续读/跨册），test/run_webtoon_tests.sh 一键运行
 2026-11-04 21:49:33 +08:00
AskaEth 23c9db73df feat(tuku): 阅读器左右翻页核心——页源契约/预解码窗口/跟手翻页/方向感知 tap 
- 页源契约（logic/reader）：count/meta/open/close + 目录册（文件夹即书）为第一个实现；
  meta 由纯 C 图片头探测（PNG IHDR/JPEG SOF/BMP）提供原始尺寸，条漫可先排版再取图，
  zip 册（M9/M11）只需另写 mr_book_ops，两种消费方式零改动复用
- 翻页引擎：pthread 后台解码窗口=当前±1 页（目录册 downscale 到屏幕长边），翻页只 blit
  缓存页图 + meow_anim 150ms 滑动吸附；未命中立即切页显示加载态、不在翻页路径解码；
  只 flush 内容区；decode/flip 首帧/翻页完成/进出内存全部 meow_log 打点
- 阅读页 UI：fit 三档（适宽/适高/原始，TopAppBar 动作循环，标题显示页码 x/y）+
  双击以点击点为锚放大（临时缓冲超上限自动降倍率）+ 单指拖拽/滑动步进平移；
  tap 三分区方向感知（RTL 默认：左=下一页，LTR 反之），中区切 chrome；
  左缘返回交给 app.c、屏底热区交给 SDK 回桌面，两者都不拦截
- 跟手：app.c 仅补 2 处极小路由（ACT_READER 的 down/move），reader 自行算位移；
  屏底 28px/左缘 24px 不进拖动，竖向主导放弃横滑
- 内存纪律：驻留 ≤3 张 downscale 页图；放大时窗口收缩到当前页；on_leave 停解码线程、
  释放全部页图/册索引/TopAppBar，并记录 VmRSS/MemAvailable 前后对比
- 测试/构建：新增 test_reader_core（契约边界/空册/越界/重复 open-close/首末页/头探测/
  方向语义/fit/平移夹取，108 项）；run_tests.sh 与 build_tuku.sh 源列表接线；
  宿主 46+108 全 PASS，交叉构建静态 MIPS32r2 ELF、-Wall -Wextra 零警告
 2026-11-04 20:58:05 +08:00