AskaEth/MeowOS-SDK
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
133 Commits 2 Branches 0 Tags
ceb65dfd014337641591132888cae2bfdb9f8d20
Commit Graph
12 Commits
Author SHA1 Message Date
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 66e598cb62 图库: 恢复缩略图 LRU 跳过解压页缓存（M11 P2-1 回归），补启动空列表/prune 回归测试（M13 评审 P2） 
- ui/library/library.c cache_prune：rebase 时丢失了 M11 c775f85 的必修保护，
  恢复 `if (mr_cache_is_page_name(de->d_name)) continue;`（在 .bmp 过滤之前）。
  解压页缓存与缩略图同目录，mrpage_* 归 page_cache 自己的 64 页/32MiB LRU 管理；
  否则档案页被缩略图 LRU 统计并删除 → 每翻页重解压，且「touch 命中→解码」窗口内
  可能被删导致解码失败。
- 回归测试（MR_LIBRARY_UI_TEST_HOOKS 接缝）：test_browse_ui_host 新增 U6——
  预置 1 个最旧 mrpage_*.bmp + 65 个较新缩略图，调用 library_test_cache_prune()，
  断言 mrpage_* 保留且不计入 64 张额度、缩略图被裁到 64；已验证去掉修复时该用例
  会失败（防止再次在 rebase 中丢失）。
- 顺手补齐/校正：
  ① test_browse_ui_host 的启动路径改为 create 前就把根指向不存在的目录，真实覆盖
     「启动根不可读仍建空列表」（断言 has_list/rows==0/横幅/当前目录），不再只是声明；
  ② tuku_internal.h 的 library_at_root 注释改为「书库根（生产=MR_ROOT_DIR，测试可改根）」。
- 复验：run_tests.sh 全 PASS（73/69/90/18/108/19/85 + settings 集成 + browse UI 集成
  + zip 106 + cbz 325）；run_webtoon_tests.sh 全 PASS（76/36/71/57 + 集成）；
  sdk/build_sdk.sh + build_tuku.sh 零警告 MIPS32r2 静态 ELF；UI host 测试 ASan/UBSan 全绿。
 2026-11-05 12:31:46 +08:00
AskaEth 9f34417c49 图库: 单层浏览 + 懒判定与 M7/M11 整合；探测缓存 P2 修复（M13） 
rebase 到 picbrowser（含 M7 条漫/续读、M11 CBZ 档案册）后的语义拼接：
- 保留单层扫描重写：一次 opendir/readdir+lstat 只列当前层（目录 + 注入 archive_pages
  时的 .cbz/.zip 档案文件），自然升序、隐藏项/符号链接跳过、2000 条截断标注；
  系统目录/空目录/无图目录一律列出；彻底删除递归「子树含图」探测
- 保留并复用 M11 档案册分支：add_dir_entry / add_archive_entry / entry_subtitle /
  entry_badge / archive_pages_at / sibling_is_book / mr_library_scan_ex 注入；
  档案册行同样先成行、页数由后台 probe（注入 zip 页数回调）懒算
- 保留 M7：mr_library_dir_has_images / mr_book_adjacent(_ex) 语义不变；为 adjacency
  恢复 ignored_dir_name（仅册间衔接跳过系统/隐藏目录，浏览本身不隐藏）；
  mr_library_format_subtitle 在补位后拼「· 续读 Pn」角标
- mr_library_probe_path 统一探测目录/档案册：mtime(秒+纳秒)+size 失效的 256 项 LRU +
  互斥锁；评审 P2：只缓存「探测前后 stat 完全一致」的结果，期间变化则不写缓存
  （消除「不完整结果绑定新 mtime」的假新鲜；下次调用重新探测）
- UI：列表用 src2 每帧取行；后台线程探测优先于缩略图；档案册封面解压档内首图（M11）；
  行语义=书页数/缩略图、空目录「空目录」、无图/坏档「无图片」；可上溯至文件系统 /、
  不可读目录提示并停留；TopAppBar「TF卡」回根；启动时根目录不可读也建空列表；
  顶栏回根命中加 g_tb_home_idx>=0 防御
- tuku_internal.h：library_go_up 注释校正（0=到达文件系统 /，app.c 据此退出）
- 测试：test_library 改单层语义；新增 browse_nav / browse_lazy / browse_perf /
  browse_ui_host（含评审 P2 的「探测期间变化不写缓存」用例）；test_cont_adjacent A6
  改两段式；test_cbz T8/T10 改两段式（坏档/无图档案列出但非书）；
  run_tests.sh 保留双方全部条目（browse 4 套 + run_zip_tests/run_cbz_tests）
- 复验：run_tests.sh 全 PASS（含 M11 zip/cbz）、run_webtoon_tests.sh 全 PASS；
  worktree 内 sdk/build_sdk.sh + build_tuku.sh 零警告静态 MIPS32r2 ELF
 2026-11-05 12:23:31 +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 fbd4db3aec feat(tuku): zip 容器读取器核心（纯 C + zlib，central directory 校验/单条目按需解压） 2026-11-05 11:39:34 +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 cca3906c80 图库: M5 设置页（阅读方向/PIN/主题状态）与启动 PIN 锁屏；阅读方向持久化（评审 P1） 
logic/pin（纯 C）：加盐迭代哈希（FNV-1a ×1000 轮 + 每次设置新随机盐，16 位 hex）经
meow_config_* 持久化 pin.enabled/pin.hash/pin.salt；提供 set/verify/change/disable 与
4-8 位纯数字校验；enabled=1 但盐/哈希残缺时 fail-closed；落盘半途失败会还原旧盐，不留
「新盐+旧哈希」的双失效状态。

ui/settings（ACT_SETTINGS）：MD3 分组表单（meow_listview 容器圆角卡 + 段头标签）——
阅读方向 RTL/LTR 走 mr_reader_set_direction；启动 PIN 开关与修改（开启/修改均两遍
MEOW_IME_NUM 确认）；版本与主题状态行（跟随系统 + 当前明暗，随 app.c 主题 listener
整帧重绘）。控件一律在 on_enter 建（栈顶=ACT_SETTINGS），避免 §6.1 owner 绑到
ACT_LIBRARY 的跨页命中泄漏。

ui/lock（ACT_LOCK）：lock_view_should_show() 读 logic/pin；启用时启动先入锁屏，验证前
不绘制任何书库内容；「输入 PIN」按钮弹系统数字键盘（MEOW_IME_NUM），错 PIN 就地提示
重试（无惩罚性锁定），正确则 page_pop 回书库；on_event 消费 SWIPE——左缘返回不能绕过
PIN 或退出 App（meow_view_dispatch_event 先于 app.c 的 on_swipe）。

logic/reader（评审 P1 修复，最小持久化）：mr_reader_set_direction 成功切换后 best-effort
写 meow_config("reader.dir","rtl"/"ltr")，写失败只打 WARN 不阻断本次切换；
mr_reader_get_direction 首次调用惰性读一次配置恢复（无配置/非法值 → 默认 RTL），之后
纯内存快路径。宿主测试经 -DMR_READER_TEST_HOOKS 的 mr_reader_test_reset() 模拟重启。

测试/构建：test_pin（85 项，PIN 全分支，含单键半途落盘失败）；test_settings_reader_persist
（19 项：默认/落盘/重启恢复/坏值/非法值/只读一次/写失败只告警）；可选宿主集成
test_settings_lock_host（真实 SDK view/activity/widget + IME 注入，端到端验证错/对 PIN
解锁与设置页两遍开启；SDK 无源码时 SKIP）；run_tests.sh 保持 46/46 并纳入上述测试
（reader.c 的配置/日志依赖由 test/settings_reader_stub.c 存根），build_tuku.sh 加入
logic/pin.c。交叉构建静态 MIPS ELF（zig-mipsel）零警告。

安全口径：PIN 防随手翻看，不是安全边界——TF 卡可拔出直读、配置可改；存储不使用加密库，
锁屏与设置页文案均如实标注该局限。
 2026-11-04 21:25:17 +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 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