Tuku reader: 真实解码峰值模型 + 3MB 硬阈值 + 解码取消 + 3 槽（M22 止损版）

真机（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/include/meow_ui_image.h

@@ -34,6 +34,22 @@ int meow_img_probe_file(const char *path, int *w, int *h, int *channels);
 meow_img *meow_img_load_file_dim(const char *path, int maxdim);
 meow_img *meow_img_load_mem_dim(const void *buf, int len, int maxdim);
 
+/* 追加（M22）缩解档位选择：取满足「长边/档位 ≥ maxdim」的最大整数档 s ∈ {1,2,4,8}，
+ * 保证缩解结果不欠采样。meow_img_load_file_dim 内部用的就是这个函数；调用方（阅读器）
+ * 用它枚举候选档位做内存预算，避免两处各写一份而漂移。 */
+int meow_img_pick_scale(int longside, int maxdim);
+
+/* 追加（M22）显式档位解码：语义与 meow_img_load_file_dim 相同（结果长边 ≤ maxdim，
+ * 超了就再精修一次），只是缩解档位由调用方决定。内存吃紧时可以选更粗的档位——输出更小、
+ * 峰值更低，代价是细节变软。step <= 1 等价长边约束入口；step > 8 按 8 处理。
+ * 非 JPEG 格式 stb 没有解码期缩放，step 被忽略（整幅解码）。 */
+meow_img *meow_img_load_file_step(const char *path, int maxdim, int step);
+
+/* 追加（M22）精确重采样到 w×h（最近邻，缩小/放大都支持）。阅读器用它把「缩解档位」的
+ * 结果一次性落到显示框，使命中页仍是单次原生 blit（不做每帧重采样）。同尺寸返回 NULL
+ * （调用方保留原图）；失败返回 NULL。 */
+meow_img *meow_img_resample(meow_img *im, int w, int h);
+
 int meow_img_w(const meow_img *img);
 int meow_img_h(const meow_img *img);
 /* 访问器：取 RGBA 像素指针（4 通道 straight alpha；供取色/直读像素）。meow_img 对外 opaque，

sdk/meow_ui_img.c

@@ -45,7 +45,7 @@ meow_img *meow_img_load_file(const char *path)
 /* 追加（M12）：预算解码。选整数缩解档位 s ∈ {1,2,4,8}——取满足「长边/s ≥ maxdim」的最大档，
  * 保证缩解结果不欠采样（不丢细节），再由 meow_img_downscale 精修到 maxdim。长边 < 2*maxdim
  * 时无档可用（s=1），退回整幅解码后精修——此时本就接近目标尺寸，无需牺牲。 */
-static int img_pick_scale(int longside, int maxdim)
+int meow_img_pick_scale(int longside, int maxdim)
 {
     int s = 1;
     while (s < 8 && (longside / (s * 2)) >= maxdim) s *= 2;
@@ -83,10 +83,40 @@ meow_img *meow_img_load_file_dim(const char *path, int maxdim)
     if (!stbi_info(path, &w, &h, &c)) return NULL;
     int longside = w > h ? w : h;
     if (longside <= maxdim) return meow_img_load_file(path);   /* 小图不动：旧路径 */
-    unsigned char *p = stbi_load_scaled(path, &w, &h, &c, 4, img_pick_scale(longside, maxdim));
+    unsigned char *p = stbi_load_scaled(path, &w, &h, &c, 4, meow_img_pick_scale(longside, maxdim));
     return img_finish_dim(p, w, h, maxdim);
 }
 
+/* 追加（M22）：档位由调用方指定。与 meow_img_load_file_dim 同语义（结果长边 ≤ maxdim，
+ * 超了再精修一次），只是档位不再由 maxdim 反推 —— 内存预算紧时可选更粗的档位。 */
+meow_img *meow_img_load_file_step(const char *path, int maxdim, int step)
+{
+    if (!path) return NULL;
+    if (step <= 1 && maxdim <= 0) return meow_img_load_file(path);
+    if (step <= 0) step = 1;
+    if (step > 8) step = 8;
+    int w = 0, h = 0, c = 0;
+    if (!stbi_info(path, &w, &h, &c)) return NULL;
+    int longside = w > h ? w : h;
+    if (step == 1 && maxdim <= 0) return meow_img_load_file(path);
+    unsigned char *p = stbi_load_scaled(path, &w, &h, &c, 4, step);
+    /* maxdim<=0：不精修（保留档位输出的原始尺寸）。 */
+    return img_finish_dim(p, w, h, maxdim > 0 ? maxdim : longside);
+}
+
+/* 追加（M22）：精确重采样到目标尺寸（最近邻，双向）。阅读器把缩解档位的结果一次性
+ * 落到显示框，之后命中页就是单次原生 blit（M17 的热路径纪律不被粗档位破坏）。 */
+static unsigned char *scale_buf(const meow_img *im, int dw, int dh, int cover);
+
+meow_img *meow_img_resample(meow_img *im, int w, int h)
+{
+    if (!im || w <= 0 || h <= 0) return NULL;
+    if (im->w == w && im->h == h) return NULL;
+    unsigned char *tmp = scale_buf(im, w, h, 0);
+    if (!tmp) return NULL;
+    return img_alloc(w, h, tmp);
+}
+
 meow_img *meow_img_load_mem_dim(const void *buf, int len, int maxdim)
 {
     if (!buf || len <= 0) return NULL;
@@ -97,7 +127,7 @@ meow_img *meow_img_load_mem_dim(const void *buf, int len, int maxdim)
     if (longside <= maxdim) return meow_img_load_mem(buf, len);
     unsigned char *p = stbi_load_scaled_from_memory((const unsigned char *)buf, len,
                                                     &w, &h, &c, 4,
-                                                    img_pick_scale(longside, maxdim));
+                                                    meow_img_pick_scale(longside, maxdim));
     return img_finish_dim(p, w, h, maxdim);
 }