AskaEth/MeowOS-SDK
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
163 Commits 2 Branches 0 Tags
f2c489d89be09cdb9662942cfdb6db4f85161e69
Commit Graph
19 Commits
Author SHA1 Message Date
AskaEth db92cbd95a 图库: 修 M32 评审 P2（预算注释按 3 槽口径，纯注释） 
- reader.c 头注释与页缓存注释：真机 480×853 页「单页 1599KB → 800KB（−50%）；
  3 槽常驻 3.2MB → 2.4MB」，不再是「两页 1.6MB」。
- MR_RESIDENT_CAP 注释：典型稳态 3 槽 = 2.4MB（窗口只落 2 页时 1.6MB），上限 3.2MB。
- 无判定/常量/代码改动（git diff 只有注释行）。
 2026-11-06 19:17:29 +08:00
AskaEth f647a3c498 图库: 修 M32 评审 P1（plan_decode_long 仍按 4B/px）+ 补 480×853 回归（r2） 
- P1：plan_decode_long 的判据从 l*s*4 改成 l*s*2（MR_PAGE_BYTES_CAP 已是 565 口径）。
  改前真机 480×853 页被压到 359×639（448KB）且每帧重采样；改后原尺寸落槽 799KB、
  绘制走原生 blit（scaled 增量 0）。
- 测试：新增 perf P13 —— 480×853 单页册，断言 slot_kb==480*853*2/1024、resident 相等、
  draw 后 blit 增长且 scaled 增量为 0；现有夹具（480×640/600×960）都在阈值以下，抓不到。
- P2：decode 日志 ok/fail 也打 peak+convert（与 skip 同口径）；CBZ 500 页的「前缀字节」
  改成 mz_read_prefix 实测（不再用 500×4096 硬算），并说明 zlib 窗口不计入 --wrap 峰值；
  565 页图 alpha 忽略的行为差异写进 meow_ui_draw.h / gfx 注释；MR_ZOOM_TEMP_CAP 注释更正。
 2026-11-06 19:01:16 +08:00
AskaEth 7036020005 图库: 阅读器页槽改 RGB565 常驻，页图内存减半（M32） 
- 页槽从 RGBA 改成「已落框的 RGB565 位图」（2B/px）：真机 480×853 页 1599KB → 800KB，
  两页常驻 3.2MB → 1.6MB。解码仍在 worker 里产出 RGBA，当场转 565 并释放 RGBA。
- SDK 新增 565 原语（meow_ui_draw.h / meow_ui_gfx.c）：meow_gfx_blit_rgb565 命中页每行
  一次 memcpy（单次拷贝、无每帧重采样），缩放兜底走 565 最近邻。量化与 back_buf 用同一个
  rgb565()，565 屏上落下的像素与旧 RGBA 路径逐像素一致（不引入色偏/新增色带）。
- 预算按 565 重算：单页像素上限沿用旧 3MB@RGBA 的同几何口径（=1.5MB@565），
  MR_RESIDENT_CAP = 3 槽 + 1 张在途 = 3.2MB；reader_estimate_peak 新增 convert_bytes
  （落槽暂存 2B/px）与 peak_bytes 一起参与门控，避免实测超预算。
- 结果队列（已解码、未落槽）字节计入总预算（pending_bytes），不再「偷吃」最多 2 页。
- CBZ meta() 改读条目 4KB 前缀（mz_read_prefix；deflate 解到 4KB 即停，输入缓冲走栈），
  500 页排版不再触发 500 次全量解压。
- 测试：B3/B8 的 565 常驻与在途预算断言、CBZ 500 页 stored/deflate 前后对比、
  P12 565 与 RGBA 路径的逐像素颜色对比（量化误差/RMSE/灰阶梯）。
 2026-11-06 18:43:11 +08:00
AskaEth bbc73635a6 Revert "Merge branch 'feat/reader-low-res-first-then-sharpen'" 
This reverts commit eb0750051f, reversing
changes made to ce34974727.
 2026-11-06 18:33:05 +08:00
AskaEth e896a28fba 图库: 修 M31 评审 P1（两档共存峰值 + 换清晰挤掉预取）与三个 P2（r2） 
P1-1 内存账没算全：高档解码时低档还占着槽，但门控/预留只按新图算。
- 高档请求携带发起时的常驻快照（page_req.resident），解码前按
  「常驻 + reader_estimate_peak()」算这次操作的总峰值，上限 MR_TIER_TOTAL_CAP
  （12MB，与 page_source 的绝对上限同值；常态 3MB 只约束 stb 回退路径，
  后端页本来就超 3MB 且已被 M27 放行），超了跳过高档、保留低档（skip=coexist）。
- 峰值本身靠调度压回基线：分页模式焦点页还是低档时不预取邻居（预取来会被
  换清晰腾掉），换清晰前 slots_reserve 腾掉非可见页，高档只与焦点低档共存。
  B8（--wrap malloc，两实例并行）：max_live_delta 3250KB→550KB，
  绝对峰值 5279KB→3932KB（基线 3929KB）。
P1-2 换清晰挤掉预取：换清晰后不重跑窗口，邻居洞留到下次翻页（0/8 命中、4 次/页）。
- 新增每页 in-flight 去重（g_req_inflight）：请求被 worker 取走后不再被窗口刷新重排，
  这是重复解码/挤掉邻居的根因之一。
- 高档落位后按最近一次翻页方向补回邻居（sharpen_refill）；反方向不补（3MB 常驻
  上限下放不下，必然再被挤掉）。
- 真机几何探针（480×720，1280×2275 JPEG，8 次 700ms/页）：0/8→8/8 命中，
  4→1.5 次解码/页。B8 顺序 100 页：100/100 命中、149 次解码（1.49/页）。

P2-1：B8 改成 101 页册顺序前翻 100 次（每页都是不同的下一页），4MP/12MP 夹具
真正成为焦点页；断言最后一页=100、命中率 ≥90%、解码 ≤2/页+余量。
P2-2：B10 去掉恒真的 slot_kb 比较，改断言「总常驻不增加」+「高档操作增量 ≤3MB」+
「两档共存绝对峰值有界」；补双击放大后换清晰不重置缩放/平移、条漫滚动位置不变。
P2-3：B10 整串生命周期解码次数 ≤12（实测 7）；B8 解码次数上限。
夹具用硬链接（同文件系统），避免多页册真拷贝几百 MB。

顺带：MR_SHARPEN_MS 200→150（任务允许 150–300ms，给「换清晰→补邻居」留翻页余量）；
新增宿主观察口 flip_hits/misses、zoom/pan/woff（只读）。
 2026-11-06 16:15:50 +08:00
AskaEth 62826e1d13 图库: 阅读器两级清晰度，先低档上屏、停稳再换清晰（M31） 
真机 1280x2275 单页解码 392ms，首次看某页有一瞬加载感。改成：
- 大页（JPEG ≥1MP）先按显示长边一半的档位（真机页=step 4）解一版低档，
  精确落到显示框后立刻上屏（换图仍是单次原生 blit，不闪白、不重置缩放/滚动）；
- 停稳 200ms 后才解目标档位（step 2），在**同一槽**原地替换低档，低档随即释放，
  常驻不翻倍；高档失败/预算跳过时保留低档，不把整页标成「内存不足」；
- 拖动/连翻/条漫滚动/跳页在途期间只解低档；高档请求复用 M22 的 gen/窗口
  stale 判据作废（只多一条 sharpen 谓词），出队前/后两条路径都计入取消；
- 日志尾部新增 tier=low|high（取消行同），真机可直接核对先糊后清。

分档只给 JPEG：step 是 JPEG 缩解概念，PNG/BMP 后端按目标逐行丢行本来就不慢，
且峰值模型对非 JPEG 按「输出=显示框」建模，多一条小图→落框路径会让模型低估
（不新增解码路径，也不改 sdk/ 与 page_source 的唯一模型）。

宿主回归：
- test_reader_membudget B10：JPEG 低档先落位（open 不阻塞）→ 高档落同槽
  （槽内字节不变、槽位全程不空）→ 拖动中强塞的高档请求被取消且不被解码；
- B8 连翻 100 页（6 类 1.3–12MP 循环）峰值增量 2714KB ≤3MB、常驻 ≤3MB，
  低档/高档都确实跑过；B3 断言小页保持单档（不付两次解码）；
- test_reader_perf P11：非 JPEG 大页不分档，仍是一次原生 blit。
 2026-11-06 13:10:01 +08:00
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
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 64336f95d9 图库: 书库改文件管理器模型 + 关闭缩略图 + 根锁定/无卡容错（M18） 
用户反馈四件事一起改：
- 「目录里有一张图就被当成最终目录」→ 取消「目录含图=一本书」全部链路
  （探测/页数/封面/续读角标/懒算 worker/sr2 补位），列表 = 目录 + 图片 +
  .cbz/.zip（目录优先、组内自然序）。点目录=进入（空目录也进），点图片=
  mr_reader_open_dir_at(当前目录, 图片自然序下标)，点档案册=打开档案册。
- 「文件夹浏览特别卡」→ 删除缩略图线程/磁盘 bmp 缓存/LRU/解码路径与行内
  缩略图；首帧只做一次 opendir/readdir+lstat，副标题（类型·大小）扫描期
  生成一次，行合成/滚动/点击零 IO 零格式化；去掉逐行 snap（自由滚动手感）。
  2000 项目录扫描 ~2.8ms（opendir=1, lstat=2000），行合成 2.78ms/200 万次
  （宿主实测；旧实现 2000 项 entry 含 512B cover，内存 2.7MB→1.7MB）。
- 「不要访问 SD 卡上级目录」→ 浏览根锁定 MR_ROOT_DIR：删除越根的顶栏
  「上级」/library_go_parent，根隐藏顶栏返回，左缘返回到根=退出 App。
- 「没有 SD 卡不要报错」→ 根不可访问（未插卡/挂载失败/根是文件）时友好空态
  「未检测到 SD 卡」+ 顶栏刷新/重进页面重试；子目录不可读才弹提示横幅。

集成陷阱：书库图片下标与阅读器目录册共享同一套过滤器（隐藏项/图片扩展名/
普通文件/符号链接）与 mr_natural_cmp，test_browse_lazy 直接对比
mr_dir_book_init 顺序，test_open_book_host 断言「点 img10 就开 img10」。

reader 侧 M17 遗留：mr_reader_open_dir_at 在阅读页已激活时先 pop 再 push，
走完整 leave/enter（SDK 对同 view 重复 push 是 no-op 且会压重复 activity）。

回归：run_tests.sh / run_webtoon_tests.sh 全 PASS；交叉构建零警告。
 2026-11-05 20:26:40 +08:00
AskaEth ceb65dfd01 图库: 修条漫长页/竖翻每帧重采样（解码几何对齐排版）+ 判据与活锁（M17 评审 P1-1/P2） 
评审用真实 UI 链路实测：600x960、800x1280（长宽比 1.6）在翻页拖动与条漫模式
都是 blit+0 / scaled+5；「先适高再切条漫」scaled+10。根因是解码几何来源与排版几何
不同源：decode_long_side() 把长边钳到屏长边 720（600x960 解成 450x720），而
strip_page_height() 按屏宽算出 480x768；mode_set() 又不动 g_fit，适高/原始进条漫
100% 重采样。

修复：
- 解码目标 = 排版真正要的显示框：新增 page_geometry_at()（条漫=strip 高度、宽=视口宽；
  翻页=fit/zoom），解码计划与绘页/就绪判据同源。
- plan_decode_long() 去掉屏长边钳制，只保留 MR_PAGE_BYTES_CAP(3MB) 硬上界，
  超长条漫按比例收缩（不再因为「高度 > 屏长边」就永远对不上）。
- slot 记录本次解码的 want 几何；slot_ready() 改为几何比较：
  fit/缩放/模式变化 → 重解一次（放大再缩回、适高→条漫回到纯 blit）；
  被 3MB 钳住的解码 want 不变 → 不再反复重解（大屏活锁）。
- 解码几何随 page_req 下发、随 page_res 返回：worker 不再读 g_fit/g_zoom/g_vw/g_vh。
- 峰值估算把 downscale/缩解输出一并计入（P2-3）。
- 适宽长图（竖向单独溢出）不再算平移模式：1.6 比例页原先左右 tap/横拖会变成
  「水平平移 0px」的空操作，页面根本翻不动；现在仍按翻页处理（原始档/横向溢出不变）。
- 窗口不再主动清窗口外的页图：0→1→0 来回翻不再反复重解同一页（140 页测试
  decode 次数 21→14）；容量仍由 MR_SLOTS + 字节淘汰兜底。
- state_reset 复位 g_meta/g_start_at（起始页在 on_enter 入口先取走），删重复注释。

测试：test_reader_perf 夹具改成 600x960（1.6）并补 800x1280、翻页拖动、条漫、
「适高→条漫」、双击放大缩回、静止无重解、大屏 1080x1920 无活锁；test_reader_many_pages
补 meow_ui_paint_full（绘制路径覆盖，P2-5）。
 2026-11-05 18:28:52 +08:00
AskaEth 462cfd5bc0 图库: 阅读器翻页按显示尺寸解码（零重采样）+ 多页闪退防御 + 从第 N 张开始（M17） 
用户反馈「横竖翻页都卡（40 页也卡）」「140 张图的文件夹一打开就闪退」
「要从中间某张开始看」三条，本次分别处理：

翻页卡顿（真因：每帧一次重采样）
- 解码目标从「屏长边」改成「当前 fit/zoom 的显示尺寸」：适宽 3:4 页原来解成
  540x720、显示 480x640，draw_page_at 于是每帧走 meow_ui_img_scaled —— 每页每帧
  多一遍全图最近邻重采样 + 一次 1.2MB 临时 malloc/free（>128KB 走 mmap）。
- 现在解码结果与显示框一致（±2px 容差）→ 翻页/滚动热路径只有原生 blit。
- fit/zoom 变化时按新几何重解（slot_ready 判据 + 同页替换），不再残留缩放；
  已到解码预算或已是原始分辨率的小图不会反复重解。
- 拖动/吸附/fling 帧只 invalidate 内容区（顶栏静态，不再每帧重绘标题文字）；
  异步落位只在「该页真的在屏幕上」时才重绘，预取邻居不刷屏。
- 页原始尺寸按册缓存（8B/页），绘制几何不再每帧 fopen probe 文件。

多页闪退（宿主未能复现，按内存边界防御）
- 常驻页图改为「显示尺寸」并加上限：单页 ≤3MB、整窗 ≤9MB（超限淘汰最远页）；
  常驻内存只与解码窗大小有关，不随页数增长。
- 解码中间峰值 >12MB 的页直接跳过并显示占位 + WARN（旧代码 PNG/BMP 放到 40MB，
  3000x3000 就是 36MB 瞬时分配；JPEG 完全没上限）。140 页夹具（含坏图/超大图）
  走真实 UI 链路打开、翻页、跳页、条漫全部通过。

新增 mr_reader_open_dir_at(dir, start_index)（文件管理器模式入口）
- 显式下标优先于续读记录；-1=续读（旧入口语义），其它负数钳到 0，≥页数钳到末页。
- mr_reader_open_dir 保留为 (dir, MR_READER_START_RESUME) 的包装；reader.h 导出。

测试：新增 test_reader_perf（翻页零重采样/fit 切换/驻留上界）与
test_reader_many_pages（140 页 + 坏图/超大图 + 起始下标/钳制/续读优先级 + 条漫跳页）。
 2026-11-05 18:06:26 +08:00
AskaEth 3cbcaaaac1 图库: 修系统返回语义与打开册资源路径（M15） 
- 返回手势：书库列表排除左缘 24px 系统返回带并清空残留拖拽态；library_go_up
  到 TF 根返回 0（app.c 退出 App），不再上溯系统目录；顶栏返回改为显式
  library_go_parent（访问放开，可越过 TF 根到 /）。lock 页继续自行消费返回。
- 打开册：缩略图源图改用预算解码（meow_img_load_file_dim，峰值数十 MB→~1MB）；
  离开书库页停止后台探测/缩略图线程，避免与 open_book 争内存/FD；打开失败按
  errno 记日志，ENOMEM/EMFILE/ENFILE/EAGAIN/EINTR 自动重试一次；修 open_book
  自拷贝 snprintf 的未定义行为。
- 测试：test_browse_ui_host 增加 TF 根退出/顶栏上级/左缘不拖拽断言；新增
  test_open_book_host（封面图+含图子目录的父目录 → reader 打开的完整 UI 链路）。
 2026-11-05 13:03:20 +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
AskaEth f4c21c74a1 fix(tuku): 书库显式启用 MD3 容器模式并补 M4/M5 接缝注释 
- P1：list_rebuild() 在 set_item_renderer/set_item_tier 后调用 meow_listview_set_container(g_lv,1)，
  修正 SDK 默认 container=0（扁平满幅+分隔线）与任务要求的 MD3 圆角卡观感不一致
- P2：reader/lock/settings 桩头补接缝注释——on_create 在 meow_view_create 内运行且 activity 栈空，
  非根页控件须 lazy 到 on_enter 或 push→建→pop；lock 另注明必须由自身 view on_event 消费 SWIPE，
  否则左缘滑动绕过 PIN
- 复验：宿主测试 46/46 PASS；交叉构建静态 MIPS32r2 ELF、-Wall -Wextra 零警告
 2026-11-04 20:09:24 +08:00
AskaEth bed6a95485 feat(tuku): 图库 M3 骨架——书库浏览/主题同步/阅读器与锁屏接缝 
- 新增顶层 tuku/ 工程（package dev.tuku.app、二进制 tuku）：app.c/internal 头/logic/ui 分层、app.json、build/pack 脚本
- 书库：从 TF 卡根浏览文件夹，含图目录=一本书；logic/library 纯 C 扫描+自然排序（page2<page10）
- 流式缩略图：后台线程解码+meow_img_downscale(96)，首帧/滚动不阻塞；磁盘缓存 MeowData/<pkg>/cache（mtime 失效+LRU）
- 列表 meow_listview 虚拟化 + meow_scroll fling/snap；行=缩略图+目录名+页数
- 主题：全部语义色 + meow_theme_add_listener 即时重绘；明暗/风格族两态可读
- 导航：meow_view page push/pop、TopAppBar ⚙→设置；reader/settings/lock 最小桩
- 接缝：mr_reader_get/set_direction（默认 RTL）、lock_view_should_show()（桩 0）
- 宿主 gcc 测试 46 项 PASS；交叉构建静态 MIPS32r2 ELF、-Wall -Wextra 零警告
 2026-11-04 19:44:18 +08:00