P1-1(内存安全):mj_huff_build 构造 9 位快表前校验规范码空间 (code + bits[l] > (1<<l) → 表非法),填表时再夹一道 <512 边界;mj_dht 失败 即返回 0 → 后端拒绝 → 回退 stb。此前过订阅 DHT(如「长度 2 的码 100 个」)会把 fast[512] 下标推到 12799,28~220 字节的畸形 JPEG 就栈溢出(ASan 实测 stack-buffer-overflow,非 ASan 直接 SIGSEGV/SIGBUS)。 回归:码长 1..4 × 符号数 3..255 共 1012 组畸形 DHT 全部后端拒绝、无崩溃; 「有效 JPEG + 注入坏 DHT」走拒绝 + 回退(不花屏)。 P1-2(能力):三处扫描循环的区间重同步统一到 mj_boundary,**只在 total == rst (编码器区间长度)时重同步**。原实现一见「over && marker∈D0..D7」就重同步,但熵码 位缓冲有最多 9 位前瞻,over 会在区间真正结束前 1~2 个 MCU 置位——提前重同步会丢掉 bitbuf 里本区间剩余块的有效比特,随即失步(渐进式 DC 扫描每块仅 ~1 bit,前瞻能跨过 整个 MCU)。这正是 Pillow restart_marker_blocks=1/2/3/4/5/8/16/64/200 的渐进式 100% 回退 stb(25.8MiB)的根因。另修 mj_restart 裸扫把 FF 00(数据字节 0xFF 的填充) 里的 00 误当 marker。 回归:9 个渐进式 + restart 夹具全部 BACKEND=1、峰值 1.86MiB(与无 restart 相同)、 与同编码无 restart 文件逐字节一致(mad=0.000);baseline + restart 仍逐字节一致。 附带(评审 P2 两项,改动极小且已验证): - PNG 8bit gray/RGB 的 tRNS 透明接通(8bit 采样值在 tRNS 低字节),与 stb 逐点 alpha 一致; - 拒绝 16bit 量化表(只属 12bit 精度;收下会让 F*qt 在 mj_accim 里 int32 溢出,UB)。 - meow_img_load_file_step 的 JPEG 走真缩解后端(PNG/BMP 暂留 stb:阅读器预算模型仍是 M22「整幅物化」口径,待 M27 同步后放开)。 验证:ASan 构建全 PASS;test_meow_img_stream 111 项全 PASS;test_meow_img_budget / test_meow_img_color 全 PASS;tuku run_tests.sh rc=0(zip 106 / cbz 296,含 membudget)、 run_webtoon_tests.sh rc=0;build_sdk.sh 零警告,MIPS32 rel2 目标码。 峰值不变(修复不增加分配):2000x3000 baseline/progressive 1.86MiB、PNG 1.33MiB。 体积:meow_jpeg.o 17,284B + meow_png_stream.o 8,456B = 25.1KB。
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 字节转换)。