AskaEth/MeowOS-SDK
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
120 Commits 2 Branches 0 Tags
fbd4db3aececa77664372445339c19f2a98d9745
Commit Graph
28 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
AskaEth fbd4db3aec feat(tuku): zip 容器读取器核心（纯 C + zlib，central directory 校验/单条目按需解压） 2026-11-05 11:39:34 +08:00
AskaEth 6caf2bc6e6 Merge branch 'feat/tuku-webtoon-mode-and-continuity' 2026-11-05 11:39:24 +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 8cbb240931 Merge branch 'feat/mangareader-settings-and-pin-lock' 2026-11-04 21:32:17 +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 47325f2b81 Merge branch 'feat/sdk-image-budget-decode' 2026-11-04 21:19:03 +08:00
AskaEth 21bffa1aeb sdk: 图片层追加预算解码入口，JPEG 解码期缩解（峰值 43.7→14.0 MiB） 
M6 finding（vuln/high）：meow_img_load_file 必先整幅 RGBA 解码，1600×2400 漫画页
瞬时峰值 20.2 MiB（15.4 MiB 输出 + 5.5 MiB YCbCr 平面），超设备 ~14MB 口径，
App 侧无法规避。

调研（vendored stb v2.30）：无解码期缩放能力——JPEG 走固定 hs/vs 重采样到全尺寸，
PNG 一次性 inflate 整幅 raw_image，公共 API 只有 load/load_16/loadf/info。
完整缩小 IDCT 需改编 1/2、1/4、1/8 IDCT + 进升级系数存储 + MCU 尺寸，改动面大且
易出静默像素错误，故不重写解码器。

改为受控的最小追加（sdk/stb_image.h）：
- 新增 stbi_load_scaled / stbi_load_scaled_from_memory：JPEG 输出级按步长 s 抽取
  行/列（resample 状态机逐行推进，仅采样行做颜色转换），整幅原尺寸输出缓冲从不
  物化；scale<=1 与旧 API 逐字节等价，非 JPEG 忽略。
- 进升级 JPEG：各分量系数 IDCT 进像素平面后立即释放（原来拖到输出分配之后）。
- 旧公共 API 行为不变。

SDK 追加式入口（旧 API 一字未改）：
- meow_img_load_file_dim / meow_img_load_mem_dim(path/buf, maxdim)：stbi_info 头探测
  选 1/2、1/4、1/8 整数档（取「长边/s ≥ maxdim」最大档，不欠采样），再交既有
  meow_img_downscale 精修；小图/maxdim<=0 走旧路径。
- meow_img_probe_file：只读头取尺寸，供 App 在 OOM 前提示。

实测（宿主 test_meow_img_budget，--wrap malloc 打点，全部 PASS）：
  8.32MP JPEG   43.70 → 13.96 MiB（新/旧 0.32）
  1600×2400 页  20.16 →  9.18 MiB
  progressive   43.70 → 35.83 MiB（系数阵列扫描期驻留，残余上限）
  PNG 2400×1600 25.65 → 25.65 MiB（stb 无 PNG 缩解，如实记录）
  BMP 2400×1600 14.65 → 15.23 MiB（同上，多一次降采样小缓冲）
缩解结果与「整幅解码+downscale」网格平均差 6.28；对 PIL 逐像素比对与全幅解码
同误差量级（mean ≤0.02, max ≤3）。

验证：build_sdk.sh 重编 meow_ui.a 0 warning；examples/hello 重链 0 warning；
tuku 用 MEOW_SDK_DIR 指向本分支 sdk 重链 0 warning；既有 test_meow_img_color 仍全 PASS。
 2026-11-04 21:02:39 +08:00
AskaEth 5f40d6fd87 Merge branch 'feat/tuku-fluid-viewer-core' 2026-11-04 20:58:13 +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 28b67a7b8d Merge branch 'feat/sdk-host-test-fixes-d1-d7' 2026-11-04 20:26:48 +08:00
AskaEth 432875d4e6 sdk: 宿主测试头注释按实测修订 + select T1 探针修正 
- test_meow_ui_select: T1 选中高亮探针移到容器卡内（x=12），
  适配 M6.37 起的 listview 默认容器模式；6/6 PASS
- 各 test_*.c 头注释补 -Iinclude、meow_ui_nav.c 及精简源列表最小补集
  （theme/widgets/notif_gesture/overlay/suppress/sdk_fixes/pinyin/ime_fix）
- test_sb_statusbar 头注释给出可链接命令（--allow-multiple-definition）
- notify_post/ui_audio_host/p1p2p3 标注需主仓组件，公开仓跳过
- docs/APP_DEV_GUIDE.md: 去掉叠字与过强表述，改为 34/38 实测口径
 2026-11-04 20:26:35 +08:00
AskaEth 2c60de141f 图库: 包名定为 os.meow.picbrowser（用户指定系统前缀）——app.json package/exec、build/pack 产物名与 README/.gitignore 同步；交叉构建+打包复验通过 2026-11-04 20:22:44 +08:00
AskaEth 429535e4d9 Merge branch 'feat/mangareader-skeleton-and-library' 2026-11-04 20:20:34 +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
AskaEth c0396e40ce sync(SDK): 增量同步主仓 M6.37–M6.39 至公开 SDK 仓 
sdk/：
- 同步 meow_ui_widget/input/gfx/lazygrid/audio/media/img 等源码与头
  （SDK 默认列表/容器控件默认 MD3 — meow_list_set_container 可回退；
   全局 App 内底部上滑回桌面 — meow_ui_input_is_home_swipe 系统保留手势；
   LazyGrid/LazyColumn/LazyRow MD3 化；叠加让位自抑改 app_id 判定；
   DSD 音频格式等）
- 新增独立模块源码 meow_img_color / meow_lyric / meow_lyric_view 及对应宿主 test_*.c
- 保留公开仓自包含适配：vendored meow_font.c/meow_font.h/meow_notif.h 不动；
  build_sdk.sh 自包含版本不动；meow_ui_gfx.c 仅改 meow_font.h include 路径；
  meow_ui_internal.h 去除 FreeType 内部声明
- meow_ipc.h 同步到主仓 launcher 版本（含 AUDIO_FMT_DOP/媒体歌词/蓝牙输出协议）
- 不含 FreeType 矢量字 meow_ft_*（需 freetype vendor，公开仓以位图 meow_font
  自包含）；不含 mipsel 二进制 / .o / .a / 固件 / 密钥 / devdocs

examples/hello/：
- 新增 ui/demo/sdk2/sdk2.c；build_hello.sh 纳入该文件（保持自包含）

docs / README / .gitignore：
- docs/MEOW_APP_SDK.md 补 §12.5（默认 MD3 容器 + 底部上滑回桌面 + 两个新 API）
- README 能力清单补「默认 MD3 容器」与「底部上滑回桌面」
- .gitignore 补新增宿主测试二进制

验证：sdk/meow_ui.a 与 examples/hello/hello 交叉编译均 0 warning；工作区无生成物。
 2026-09-04 18:05:36 +08:00
AskaEth a1687486bc sdk: full-sync M7.0a/b (theme view input gfx 等, 真实功能非FT) 2026-09-03 06:51:44 +08:00
AskaEth a70cdbc0f7 sdk: 补同步 swipe-delete 缺失文件(widget/widgets.h/internal.h/build_sdk.sh) 2026-09-03 05:59:59 +08:00
AskaEth 64cde13c8d sdk: 同步主仓新增模块 cachegov/lazygrid/select/net 通道 2026-09-03 05:09:05 +08:00
AskaEth 0af6af7c7e docs: 同步主仓最新 SDK 设计/开发者指南 + README 新能力清单 
MEOW_APP_SDK.md（相对主仓 MEOW_APP_SDK.md，保留公开仓化改写与免责声明）：
- 公共头模块索引补 meow_ui_str.h 行
- §5.5 新增「虚拟化层」（W_LISTVIEW 固定 item 池/多行富 item/自绘钩子；去除 ncm 引用）
- §5.8 新增 TopAppBar 位图动作图标 + sb_icons[] 30 图标索引表
- §6.1 后插入 §6.4 事件分发形式化（命中/捕获/消费/层间隔离/唯一焦点）
- 新增 §12 布局/动画/滚动（meow_box/meow_anim/meow_scroll）+ §13 字符串 i18n（meow_str_*）
- 遗留/待实现 由 §12 重编号为 §14；去除 ncm/网易云/NetEase 字样

APP_DEV_GUIDE.md：新增 §7.11 字符串资源/i18n（保留既有公开化改写 §1.1/§5.2/§10 等）

README.md：更新 include/ 子头计数（20），补「SDK 能力速览」（布局/动画/滚动/事件分发/
虚拟列表/i18n/图标库/图片降采样）

.gitignore：新增本次引入的宿主测试二进制名（test_meow_ui_box/anim/dispatch/listvirt/scroll/str）
 2026-09-02 09:17:20 +08:00
AskaEth 4b094d62a5 sdk: 增量同步主仓新模块（box/anim/scroll/dispatch/listvirt/str/sb_icons/img） 
subtree pull sdk 来自主仓 pub/sdk（主仓 commit 68ce46a 等）。新增：
- 布局引擎 meow_ui_box / 动画基座 meow_ui_anim / 滚动物理 meow_ui_scroll
- §6.4 事件分发形式化 / W_LISTVIEW 虚拟化多行 / meow_str 字符串资源 i18n
- sb_icons 动作图标扩充 + topbar 位图图标 / meow_img_downscale
- tools/ 图标生成脚本与 SVG 源
- 对应宿主 test_*.c 与 demo_box_scroll.c

build_sdk.sh 冲突解析：保留公开仓自包含版（vendored meow_font + -Iinclude -I.），
OBJS 手工并入 4 个新模块（meow_ui_box/anim/scroll/str）。保留 vendored meow_font.c/
meow_ipc.h/meow_font.h/meow_notif.h，剔除宿主测试二进制与编译产物。
 2026-09-02 09:08:51 +08:00
AskaEth 66e9cd5fa4 fix(ncm §32): 内存瘦身修 OOM 被杀 —— 封面降采样(8.28MB→0.78MB) + 瞬态 rbuf 缩减 + 线程栈显式 
真机 dmesg 实锤：OOM Kill ncm (score 460, anon-rss 26.9MB, 设备 56MB)。
画像：封面全分辨率 RGBA 8.28MB(1448x1448 原生解码驻留) 是最大可控块。

瘦身（按收益排序）：
1. sdk meow_ui_img 新增纯增量 meow_img_downscale + cover.c cover_cap(≤480px)
   → 封面 8.28MB→0.78MB，-7.65MB（mem_sim 实测 PASS）。
2. ncm_api.c 瞬态响应 rbuf：song_url→64KB、lyric/song_detail/cloudsearch/user_playlist→256KB
   （detail/track_all 保 1MB）。
3. ncm_app_internal.h 新增 ncm_thread_create（显式 128KB 栈），替换全部 14 处 pthread_create。
4. 滑动窗口/meta 复核零回退（window_sim：608B/首，6000 首 280KB 恒定）。

验证：mem_sim 封面收益 PASS + host home/player 渲染 OK + stream_sim/player_flow_sim/
window_sim/search_sim/cache_evict_sim 全 PASS + test_ncm_core host+mipsel(qemu) PASS
+ build_ncm.sh -Wall -Wextra 0 warning。真机 scp 播放在跑确认（缓存曲，0 播放请求）。

新 ncm md5 44fa16fe（text 1015150/bss 1362500）。正式部署留主会话。
 2026-09-02 03:43:42 +08:00
AskaEth f44d702124 sdk: sb_icons 扩充动作图标 + TopAppBar 位图图标支持 
TopAppBar 动作项此前用字体码点(⚙↻⌕)绘制，4k 字库无这些码点→豆腐。改走位图：
- sb_icons.h 追加 15 个 Material Symbols Rounded 动作位图(settings/refresh/search/
  play_arrow/pause/skip_next/skip_previous/arrow_back/close/add/check/lyrics/
  queue_music/download/heart)，FILL=1 实心与状态栏一致；sb_icons[] 只追加(0-14 不变)，
  动作索引 15-29。
- 生成脚本 tools/gen_action_icons.py（cairosvg svg→32x32 单通道 alpha，SVG 缓存
  icons_src/ 可复现、断网可跑）。
- meow_ui_gfx.c 抽取图标 blit 像素核心 icon_blit_px，新增 meow_gfx_blit_icon_ink
  (控件路径不标顶栏脏区)；meow_gfx_blit_icon 状态栏路径行为不变。
- meow_ui_widget.c W_TOPAPPBAR 项支持位图模式：新 API meow_topappbar_set_item_icon
  (w, idx, icon_idx)，绘制取主题 onSurface/按压向栏底色淡 12%，文本项行为不变；
  hit 用统一项宽。
- 公共头 widgets.h 加 MEOW_ICON_*(15-29) 枚举与 set_item_icon 声明；internal.h 声明
  meow_gfx_blit_icon_ink。
- 宿主测试(test_meow_ui_widgets)加 topbar 位图图标绘制/命中/按压变淡 + 状态栏 blit
  回归断言；test_umbrella 加 MEOW_ICON_* 编译期锁；MEOW_APP_SDK.md 补说明+索引表。
- 验证：宿主测试 ALL PASS(14项)；交叉 zig 构建 0 warning；meow_ui.a 新 md5
  1d69cdae55ab5dde3a98f5e2124f3656。
 2026-09-02 03:24:46 +08:00
AskaEth 2e8fac2a07 sdk(ui): 字符串资源外置（i18n 雏形 §13）—— meow_str_* + 内嵌双语表 + TF 覆盖表 + 控件接入 
公开 SDK 前把 SDK/App 硬编码文案外置：新增 meow_str/meow_strf/meow_str_set_locale/
meow_str_locale，按当前 locale 取串（永不 NULL），第三方开发者可做多语言。

- 新增 include/meow_ui_str.h + meow_ui_str.c：取串优先级 = TF 覆盖表 > 内嵌当前语言
  (en_us→en 其余→zh) > 内嵌内置默认(zh_cn) > 原样返回 id。内嵌双语表（common.* 21 条 +
  ime.* 9 条）；热路径零 malloc（编译期静态表 + ≤256 静态覆盖数组）；纯 libc 宿主可单测。
- locale 存系统设置 settings.conf 的 ui.locale（默认 zh_cn，首次调用惰性读取）；
  meow_str_set_locale 即时切换 + 重载覆盖表 + best-effort 持久化（流式改写保留其它行）。
- TF 覆盖表 MeowData/<pkg>/strings/<locale>.txt（id=text 行，UTF-8，'=' 两侧去空白）；
  无卡/无文件/无该 id → 回落内嵌。meow_strf 用调用方缓冲（snprintf 语义，重入安全）。
- SDK 控件接入：dialog 默认按钮 OK/CANCEL + INPUT 占位、IME 键面/徽标（空格/确定/拼英/
  ?123/清/拼音/（无候选）/中）改走 meow_str；空态/加载态给 App 提供 common.no_data/loading。
- 测试：新增 test_meow_ui_str.c（内嵌回退/TF 覆盖优先级/未知 id 回退/切 locale 即时生效/
  查找正确性/meow_strf，tmp+env 两模式）；全量宿主回归（widgets/dispatch/box/anim/scroll/
  listvirt/theme/ime_fix/pinyin/overlay/notif/sdk_input_keys/p1p2p3/config/vol/sb_collapse/
  notify_*) 0 回归；交叉 zig-mipsel -Wall -Wextra 0 warning。
- 文档：MEOW_APP_SDK.md 新增 §13（字符串资源/i18n，遗留顺延为 §14）；docs/APP_DEV_GUIDE.md
  新增 §7.11。各宿主 test_*.c 头注释补 meow_ui_str.c 编译依赖。

边界（§13.7）：仅 zh_cn/en_us 整串取用；不做复数规则 / BiDi / RTL / 动态字体回退（雏形）。
 2026-09-02 02:37:38 +08:00
AskaEth 2d974bed62 sdk(ui): W_LISTVIEW 虚拟化层 — 固定 item 池 + 多行富 item + 完全自绘 (§5.5) 
在既有 W_LISTVIEW (src2 每帧取行) 之上叠加虚拟化层 (API 追加式, 旧 API 一字不改):
- 数据源 count_fn + bind_fn (index, meow_lv_item*, ctx); count 每帧实时查 (任意长度≥65535,
  不常驻 item 对象); bind 仅在行进入视口时被调一次
- 固定 item 池: 视口行数+2 静态槽 (有界 ≤96), 回滚不重绑 (同 index 命中同槽); 整表扫过后
  wrap 回收合法但每次 draw 有界 (≤视口窗口)
- 多行富 item: 主标题/副标题/左图标·缩略图/右尾件; 行高 set_item_h(px) 或 set_item_tier(1→48/2→56);
  默认 renderer 主题语义色绘制; set_item_draw 完全自绘; section 段头占位行(非粘性); 空态占位
- 集成: tap_at→meow_ui_focus_acquire (§6.4); meow_scroll_wrap(lv,1) track+fling+snap(行边界);
  选中/按压态走主题; enabled=0 变淡不响应
- 兼容: src2==NULL 走既有路径; W_LIST/W_LISTVIEW 单行用法零改动

验证(宿主): 新测试 test_meow_ui_listvirt T1-T5 全 44 PASS (10000 项滚动窗口内容正确/hit 映射/
bind 有界=count/回滚不重绑/多行渲染/截断/图标占位/段头/空态/自绘/焦点/fling 吸附);
全量回归 widgets/dispatch/box/anim/scroll/ime/pinyin/overlay/notif/sdk_input_keys/p1p2p3 全 PASS;
交叉 zig-mipsel -Wall -Wextra 全 SDK TU 0 warning; meow_ui.a 新 md5=2a2d8000b95dd211d09dc736d5538ad0

文档: MEOW_APP_SDK.md §5.5 同步虚拟化层(API 一览/池语义/集成/回归).
 2026-09-02 01:36:48 +08:00
AskaEth 63ac0fd7dc sdk: 事件分发形式化（§6.4）—— 统一命中/捕获/消费/层间隔离/焦点 
根治「焦点/事件穿透」一类反复 bug。此前命中/捕获/消费/层间隔离各处 ad-hoc；
现上收为单一仲裁者（meow_ui_input.c），公共 API 只追加、不删改既有签名。

分发模型：
- 触摸沿 z 序自顶向下命中（meow_draw_hit_topdown，owner==active+enable 过滤）；
- 命中即消费；模态层永远先审（meow_ui_modal_begin/end/active/depth）；
- down 捕获（meow_ui_gesture_begin/owner/end）：命中目标捕获手势直到 up，防滑出误触下层；
- 模态存在时下层完全收不到事件——hit_topdown 恒返回模态哨兵（背板消费，不透传）；
- meow_ui_run 在 TOUCH_DOWN 自动 begin、TAP/SWIPE/LONG_PRESS/NOTIF_PULL 自动 end。

焦点模型：
- 唯一持有者（meow_ui_focus_acquire/release/owner/tap）；
- 点非 focus 区域→释放并通知（meow_ui_focus_tap，list 焦点残留根治）；
- 滚动容器（list/listview）tap_at 命中行自动 acquire，点外由 run 的 focus_tap 释放；
- lost 回调（meow_ui_focus_set_lost_cb）通知转移。

迁移（行为修复，正常交互语义不变）：
- dialog/sheet → meow_ui_modal_begin/end（模态期下层收不到；叠黑由既有整帧快照+卡片仅重绘保证）；
- list/listview tap → meow_ui_focus_acquire；
- 注入/叠加让位（overlay_input_suppressed）与模态层隔离互补，语义不变。

验证：新穿透矩阵 test_meow_ui_dispatch（M1 模态点下层不触发 / M2 弹层叠开两层层隔离 /
M3 捕获手势滑出不误触 / M4 list 焦点点外释放）ALL PASS；
全量回归 widgets/ime_fix/pinyin/overlay_suppress/notif_gesture/sdk_fixes/sb_collapse/
p1p2p3_repro/box/anim/scroll/sdk_input_keys 全 PASS；交叉 -Wall -Wextra 0 warning。

meow_ui.a 新 md5：a9fcfb6eeb07ddbdd48039df4f8f18ce（主会话统一重链，本仓未重链 App）
 2026-09-02 00:57:58 +08:00
AskaEth 35a623dfb6 merge: 接入 Gitea 初始提交（内容以本仓为准） 2026-09-01 23:28:57 +08:00
AskaEth 66fc01aa1d Initial commit 2026-09-01 22:48:08 +08:00