真机(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 交叉构建零警告。
sdk/ — meow_ui 应用框架(源码 + 构建)
本目录是 meow_ui.a 的自包含源码树:公共头在 include/(伞头 meow_ui.h),
构建脚本 build_sdk.sh,宿主逻辑测试 test_*.c。上手指南见仓库根
README.md 与 docs/APP_DEV_GUIDE.md。
构建
cd sdk
./build_sdk.sh # 产出 sdk/meow_ui.a(mipsel 静态库)
交叉编译器默认 $HOME/Project/R3ProII/.tools/zig-mipsel-cc,可用 MEOW_CC 覆盖。
时钟:mipsel o32 时钟/睡眠 ABI 修复(已内置)
公开 SDK 现已内置 mipsel o32 时钟/睡眠 ABI 修复(见 CLOCK_ABI.md),
源码在 meow_ui_time.c。
- 背景:zig 内置 musl 在 mipsel 上「头文件声明 64 位
time_t、实现却走 time32 系统调用」, 导致meow_ui_time_ms()毫秒位恒 0、高 32 位随机;usleep()亚秒等待立即返回(忙等空转)。 - 修复:
meow_ui_time_ms()直接按内核 o32 ABI(8 字节{int32 sec; int32 nsec;})取时, 再自行升成 64 位毫秒;同一 TU 强定义__clock_gettime/__clock_gettime64/__clock_nanosleep/__clock_nanosleep_time64/__nanosleep_time64,在链接期接管 libc 里那份 ABI 不一致的实现。 - 链接顺序要求:应用必须把
meow_ui.a放在-lc之前(cc ... meow_ui.a ... -lc), 强定义才能生效。仓库内examples/hello/build_hello.sh与tuku/build_tuku.sh均如此; 自定义构建脚本请照抄这个顺序,否则取时/睡眠会静默回到坏实现。 - 非 mipsel 目标(宿主单测、aarch64 等)走普通
clock_gettime,行为不变。
已知限制
- 2038 前有效:内核侧仍是 time32(
tv_sec为 int32),秒数超出INT32_MAX即溢出; 本修复只保证「头/实现的宽度一致」,不把内核升到 time64。 - 同源缺陷未修:futex 相对超时(
pthread_cond_timedwait的亚秒等待)、timerfd_settime、clock_settime/clock_adjtime、pselect/ppoll等仍受同一句!__ILP32__影响; 清单与影响见 CLOCK_ABI.md §6。SDK 自身不直接使用这些路径。 - 真机验收:本修复的证据是反汇编 + 宿主单测(本机无 qemu-mipsel),设备侧仍需实测确认。
宿主测试
无硬件即可跑(gcc 直接编译,不链 meow_ui.a):
cd sdk
# 时钟换算与单调性
gcc -Os -Wall -Wextra -I. -Iinclude -c meow_ui_time.c -o meow_ui_time_host.o
gcc -Os -Wall -Wextra -I. -Iinclude test_meow_time.c meow_ui_time_host.o -o test_meow_time
./test_meow_time # == PASS == / checks=N
# 伞头与其余模块测试(示例)
gcc -I. -Iinclude test_umbrella.c <各 sdk 源 .c> test_host_stub.c -lpthread -o test_umbrella
./test_umbrella
注意:宿主编译时 meow_ui_time.c 走 MEOW_TIME32_KERNEL_ABI 0 分支(普通 clock_gettime),
因此宿主测试不能证明 mipsel o32 路径正确 —— 那条路径的正确性靠 CLOCK_ABI.md §4 的
反汇编证据(nm 符号来源 + syscall 4263/4265 的 8 字节转换)。