Files
MeowOS-SDK/sdk
AskaEth 6c8a1d3925 fix: 扫描结尾不再丢最后一个 MCU + 畸形 SOF 尺寸硬闸(M23 r2 P1-A/P1-B)
P1-A(像素错误):mj_boundary() 在「over 且 marker 非 RSTn」时 return 0 提前退出
扫描。熵码位缓冲最多 9 位前瞻,会在最后一个 MCU/块**之前**把扫描结束后的 marker
(DHT/EOI)吃掉;此时最后 1~2 个 MCU 的有效比特还在 bitbuf 里,return 0 把它们丢掉,
分量平面 memset(128) 的灰底直接露出来(低熵/纯白渐进式右下角 #808080)。
修:扫描循环本来就知道确定的 MCU/块数 —— 一律继续解完(位耗尽后 mj_eb 返回 0 做
零填充),marker 交给外层主循环。实测(纯白 2000x3000 progressive 无 restart):
修复前全图最小通道 128 / 与 stb 最大差 127 / >40 差值的通道 9 个;修复后
最小通道 253~255、最大差 ≤2、>40 通道 0。

测试加固(评审指出旧断言是抽样蒙混):
- S12「与无 restart 逐字节一致」改为**全图 memcmp**(去掉 64×64 网格 MAD<0.1 的兜底);
  修复后 9 档 restart 全部逐字节一致。
- 新增 S15:纯白 2000x3000 progressive(q50/60/70/80,无 restart)+ mostly-white q95,
  断言全图最小通道/右下角 24×24 最小通道 ≥250(丢 MCU 必露 128)、与 stb 全图逐像素比较。
  用 HEAD(11a4fcd) 的 meow_jpeg.c 重编同一测试:4 档纯白全部 FAIL(min=128,
  >40 通道 9),修复后全 PASS。

P1-B(内存放大/安全):mj_sof() 按 SOF 声明尺寸分配平面,降档循环在 base_n 已为 1
时不再生效,17~23 字节的 `SOI+SOF0(65535×65535)+EOI` 会让公开入口 _dim(720)
分配并 memset 64MiB(1 分量)/96MiB(3 分量)后才返回 NULL。
修:降档循环之后补硬闸 `if (plane_bytes + target_bytes > MJ_PEAK_CAP) return 0;`
→ 回退 stb(同文件 stb 是 0.02MiB 安全失败)。
回归 S16:构造 SOF 65535²(1/3 分量)→ 后端返回 0、公开入口 NULL、峰值 0.02MiB
(修复前 64.00 / 96.00MiB)。

meow_jpeg.h 注明「峰值只与输出尺寸相关」的适用范围:畸形/超大声明尺寸直接拒绝(安全失败)。

验证:test_meow_img_stream ALL PASS(含 ASan 整轮 rc=0 无报告);test_meow_img_budget /
test_meow_img_color ALL PASS;run_tests.sh rc=0(zip 106 / cbz 296 / membudget PASS);
run_webtoon_tests.sh rc=0;build_sdk.sh 零警告,MIPS32 rel2;体积 meow_jpeg.o 17,212B
+ meow_png_stream.o 8,456B。峰值不变(修复不增加分配)。
2026-11-06 11:21:03 +08:00
..

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 字节转换)。