图库: 修 M31 评审 P1（两档共存峰值 + 换清晰挤掉预取）与三个 P2（r2）

P1-1 内存账没算全：高档解码时低档还占着槽，但门控/预留只按新图算。 - 高档请求携带发起时的常驻快照（page_req.resident），解码前按「常驻 + reader_estimate_peak()」算这次操作的总峰值，上限 MR_TIER_TOTAL_CAP （12MB，与 page_source 的绝对上限同值；常态 3MB 只约束 stb 回退路径，后端页本来就超 3MB 且已被 M27 放行），超了跳过高档、保留低档（skip=coexist）。 - 峰值本身靠调度压回基线：分页模式焦点页还是低档时不预取邻居（预取来会被换清晰腾掉），换清晰前 slots_reserve 腾掉非可见页，高档只与焦点低档共存。 B8（--wrap malloc，两实例并行）：max_live_delta 3250KB→550KB，绝对峰值 5279KB→3932KB（基线 3929KB）。 P1-2 换清晰挤掉预取：换清晰后不重跑窗口，邻居洞留到下次翻页（0/8 命中、4 次/页）。 - 新增每页 in-flight 去重（g_req_inflight）：请求被 worker 取走后不再被窗口刷新重排，这是重复解码/挤掉邻居的根因之一。 - 高档落位后按最近一次翻页方向补回邻居（sharpen_refill）；反方向不补（3MB 常驻上限下放不下，必然再被挤掉）。 - 真机几何探针（480×720，1280×2275 JPEG，8 次 700ms/页）：0/8→8/8 命中， 4→1.5 次解码/页。B8 顺序 100 页：100/100 命中、149 次解码（1.49/页）。 P2-1：B8 改成 101 页册顺序前翻 100 次（每页都是不同的下一页），4MP/12MP 夹具真正成为焦点页；断言最后一页=100、命中率 ≥90%、解码 ≤2/页+余量。 P2-2：B10 去掉恒真的 slot_kb 比较，改断言「总常驻不增加」+「高档操作增量 ≤3MB」+ 「两档共存绝对峰值有界」；补双击放大后换清晰不重置缩放/平移、条漫滚动位置不变。 P2-3：B10 整串生命周期解码次数 ≤12（实测 7）；B8 解码次数上限。夹具用硬链接（同文件系统），避免多页册真拷贝几百 MB。顺带：MR_SHARPEN_MS 200→150（任务允许 150–300ms，给「换清晰→补邻居」留翻页余量）；新增宿主观察口 flip_hits/misses、zoom/pan/woff（只读）。
2026-11-06 16:15:50 +08:00
1 parent 62826e1d13
commit e896a28fba
@@ -17,10 +17,12 @@
 *   B7b 回退路径：CMYK / Adam7 PNG / 1bpp BMP 走 stb，按旧门控占位
 *   B7c P1-1 旁路回归：截断 12MP JPEG / 3000×3000 24bpp 头-only BMP（判定 backend，
 *     后端失败必须 NULL、峰值 ≤3MB）/ 非法位深 PNG（矩阵拒绝→stb 占位）
- *   B8 M27/M31：连翻 100 页（6 类循环）不掉页、不占位、任何时刻存活增量 ≤3MB；
- *      分档页低档/高档都确实跑过（M31：先低后清不把峰值/常驻翻倍）
+ *   B8 M27/M31：顺序连翻 100 页（101 页册，6 类循环，每页都是不同的下一页）不掉页、
+ *      不占位、存活增量 ≤3MB、绝对峰值有上界、预取命中 ≥90%、解码次数 ≤2/页+余量
+ *      （M31 r2：修「每翻一页解 4 次」与高峰值，评审 P1-1/P1-2/P2-1/P2-3）
 *   B10 M31：两级清晰度生命周期（JPEG 大页）：低档先落位（open 不阻塞）→ 停稳后高档落
- *      同一槽（槽内字节不变、槽位不空）→ 拖动中强塞的高档请求被取消通道作废
+ *      同一槽（总常驻不增加、槽位不空、本次操作增量 ≤3MB）→ 双击放大换清晰不重置缩放/平移
+ *      → 拖动中强塞的高档请求被取消通道作废 → 整串解码次数有界
 *   B9 M27：CMYK 回退页集成 —— 占位可重试且不崩
 *
 * 夹具：BMP/PNG 小夹具由本文件用 C 写；JPEG/PNG/BMP 大夹具由 python3+Pillow 生成
@@ -118,6 +120,7 @@ static int g_fail;
 } while (0)
 #define INFO(...) do { printf("  info: "); printf(__VA_ARGS__); printf("\n"); } while (0)

+
 /* ------------------------------------------------------------------ */
 /* 夹具写入                                                            */
 /* ------------------------------------------------------------------ */
@@ -218,6 +221,14 @@ static int copy_file(const char *src, const char *dst)
    return ok ? 0 : -1;
 }

+/* 同一文件系统优先硬链接：多页册只是「同样的夹具当很多页」，101 页 × 12MP/BMP/PNG 真拷贝
+ * 要写几百 MB，跑一次测试 I/O 比解码还久（评审复跑成本）。读侧只按路径打开，硬链接完全等价。 */
+static int link_or_copy(const char *src, const char *dst)
+{
+    if (link(src, dst) == 0) return 0;
+    return copy_file(src, dst);
+}
+
 static int have_file(const char *path)
 {
    struct stat st;
@@ -464,20 +475,23 @@ int main(void)
    }
    int have_jpeg = gen_jpeg_fixtures(jpgbook);

-    /* 连翻 30 页：6 类典型页循环（12MP / 4MP / baseline / 渐进 / PNG / BMP）。
-     * 每类都必须走后端且不占位——这是「修好了却用不上」的回归防线。 */
+    /* 顺序连翻 100 页：6 类典型页循环（12MP / 4MP / baseline / 渐进 / PNG / BMP）。
+     * 每类都必须走后端且不占位——这是「修好了却用不上」的回归防线。
+     * M31 r2（评审 P2-1）：101 页顺序遍历（不是 30 页来回跳）——每次翻页都落到**不同的
+     * 下一页**，4MP/12MP 夹具都会真正成为焦点页并被解码/换清晰。 */
    static const char *const g_mix[] = {
        "base2000.jpg", "prog2000.jpg", "page1600.png",
        "page1600.bmp", "mp4.jpg", "mp12.jpg",
    };
    const int mix_n = (int)(sizeof g_mix / sizeof g_mix[0]);
+    const int mixed_goal = 101;              /* 100 次前翻 → 第 101 页（不回卷、不触发册间衔接） */
    int mixed_pages = 0;
    if (have_jpeg) {
-        for (int i = 0; i < 30; i++) {
+        for (int i = 0; i < mixed_goal; i++) {
            char src[MR_PATH_MAX], dst[MR_PATH_MAX];
            snprintf(src, sizeof src, "%s/%s", jpgbook, g_mix[i % mix_n]);
-            snprintf(dst, sizeof dst, "%s/p%02d_%s", mixed, i, g_mix[i % mix_n]);
-            if (copy_file(src, dst) == 0) mixed_pages++;
+            snprintf(dst, sizeof dst, "%s/p%03d_%s", mixed, i, g_mix[i % mix_n]);
+            if (link_or_copy(src, dst) == 0) mixed_pages++;
        }
    }
    /* 回退路径集成：CMYK（4 分量）必须占位且不崩。 */
@@ -768,50 +782,65 @@ int main(void)
        printf("  SKIP jpeg assertions: Pillow unavailable (python3 -c 'import PIL')\n");
    }

-    /* ---- B8 M27/M31：连翻 100 页（6 类典型页循环）——不掉页、不占位、峰值不增长 ----
-     * M31 起这些 1.3–12MP 的页走两级清晰度（低档先上屏、停稳换高档），所以这条同时是
-     * 「分档不把峰值/常驻翻倍」的回归：低档与高档在同一槽原地替换，任何时刻的存活增量
-     * 仍按单页解码峰值封顶。 */
-    if (have_jpeg && mixed_pages == 30) {
+    /* ---- B8 M27/M31：顺序连翻 100 页（101 页册，6 类典型页循环）——不掉页、不占位、
+     * 峰值不增长、预取命中、解码次数有界 ----
+     * M31 起这些 1.3–12MP 的页走两级清晰度（低档先上屏、停稳换高档）。评审 P1:
+     *   - 顺序前翻（每页都落到不同的下一页），4MP/12MP 夹具真正成为焦点页；
+     *   - 断言语义翻页命中率（目标页已在槽）与解码次数上限，防止「每翻一页解 4 次」；
+     *   - 存活增量仍按单页解码峰值封顶（两档共存时换清晰前会腾掉非可见页，见 reader.c）。 */
+    if (have_jpeg && mixed_pages == mixed_goal) {
        mr_reader_ui_test_set_mem(4096, 16000);
        mr_reader_open_dir(mixed);
        pump_ms(1200);
-        CHECK(mr_reader_ui_count() == 30, "mixed book pages=%d", mr_reader_ui_count());
-        int w = meow_ui_width();
+        CHECK(mr_reader_ui_count() == mixed_goal, "mixed book pages=%d", mr_reader_ui_count());
        int advanced = 0, skipped_max = 0;
        size_t live_steady = g_live;
        int d0 = mr_reader_ui_decode_count();
        int low0 = mr_reader_ui_low_decodes(), high0 = mr_reader_ui_high_decodes();
+        int hits0 = mr_reader_ui_flip_hits(), miss0 = mr_reader_ui_flip_misses();
        /* P2-3：只在窗口稳定后 reset 一次，之后不再 reset——这样淘汰旧图不会掩盖
         * 「分配新图 + 解码」的真实峰值；指标 = 整个 100 翻窗口内相对稳态基线的最大存活增量。
         * （旧实现每翻页 reset 一次，淘汰把基线拉低，报告里的 536KB 是伪值。） */
        size_t base = peak_reset();
        for (int i = 0; i < 100; i++) {
            int before = mr_reader_ui_page();
-            tap(i % 2 == 0 ? 40 : w - 40, 300);
-            pump_ms(220);
-            if (mr_reader_ui_page() != before) advanced++;
+            tap(40, 300);                          /* RTL：左 1/3 = 下一页（顺序前翻） */
+            pump_ms(400);                          /* 700ms/页：给「换清晰→补邻居」留出余量 */
+            if (mr_reader_ui_page() == before + 1) advanced++;
            if (mr_reader_ui_skipped_pages() > skipped_max)
                skipped_max = mr_reader_ui_skipped_pages();
        }
        size_t transient = g_peak > base ? g_peak - base : 0;
-        INFO("100 mixed flips: advanced=%d skipped=%d decodes=%d (low=%d high=%d) steady=%zuKB "
-             "resident=%ldKB max_live_delta=%zuKB",
-             advanced, skipped_max, mr_reader_ui_decode_count() - d0,
+        int hits = mr_reader_ui_flip_hits() - hits0;
+        int miss = mr_reader_ui_flip_misses() - miss0;
+        int decodes = mr_reader_ui_decode_count() - d0;
+        INFO("100 mixed flips: advanced=%d last_page=%d hits=%d miss=%d skipped=%d decodes=%d "
+             "(low=%d high=%d) steady=%zuKB resident=%ldKB max_live_delta=%zuKB abs_peak=%zuKB",
+             advanced, mr_reader_ui_page(), hits, miss, skipped_max, decodes,
             mr_reader_ui_low_decodes() - low0, mr_reader_ui_high_decodes() - high0,
-             live_steady / 1024, mr_reader_ui_resident_kb(), transient / 1024);
-        CHECK(advanced == 100, "100 页全部翻到 (%d/100)", advanced);
+             live_steady / 1024, mr_reader_ui_resident_kb(), transient / 1024, g_peak / 1024);
+        CHECK(advanced == 100 && mr_reader_ui_page() == 100,
+              "100 次顺序前翻逐页推进（advanced=%d last=%d）", advanced, mr_reader_ui_page());
        CHECK(skipped_max == 0, "典型页连翻无占位 (max=%d)", skipped_max);
        CHECK(mr_reader_ui_failed_pages() == 0, "无永久失败页 (%d)",
              mr_reader_ui_failed_pages());
        CHECK(mr_reader_ui_low_decodes() > low0 && mr_reader_ui_high_decodes() > high0,
              "大页确实走了两级（low +%d, high +%d）",
              mr_reader_ui_low_decodes() - low0, mr_reader_ui_high_decodes() - high0);
+        /* 顺序阅读的预取命中率：评审要求不低于基线 7/8。 */
+        CHECK(hits >= 90, "顺序翻页预取命中率 ≥90%%（hit=%d miss=%d）", hits, miss);
+        /* 解码次数上限：分档页 = 低档 + 高档（2 次/页），非 JPEG 单档（1 次/页）+ 开册/补邻居余量。
+         * 出现「每页 4 次」的放大（P1-2 的病灶）时这里会立刻失败。 */
+        CHECK(decodes <= 100 * 2 + 20, "100 次翻页解码次数 ≤2/页+余量 (decodes=%d)", decodes);
        CHECK(mr_reader_ui_resident_kb() <= mr_reader_ui_resident_cap_kb(),
              "常驻仍在上限内 (%ldKB ≤ %ldKB)", mr_reader_ui_resident_kb(),
              mr_reader_ui_resident_cap_kb());
        CHECK(transient <= 3 * 1024 * 1024,
              "100 页连翻任何时刻存活增量 ≤3MB (%zuKB)", transient / 1024);
+        /* 两档共存的总账：常驻（≤3MB）+ 单次解码（≤3MB）——不许因为「基线里已含低档」
+         * 就看着没涨；绝对存活峰值同样要有上界。 */
+        CHECK(g_peak <= (size_t)(mr_reader_ui_resident_cap_kb() + 3 * 1024) * 1024,
+              "绝对存活峰值 ≤ 常驻上限+3MB (%zuKB)", g_peak / 1024);
        meow_view_page_pop();
        pump_ms(200);
    }
@@ -819,8 +848,11 @@ int main(void)
    /* ---- B10 M31：两级清晰度生命周期（2000×3000 JPEG，真机同类大页）----
     * 1) 冻结停稳窗口 → 只解低档：焦点页 tier=low、常驻=显示框大小（仍是一次原生 blit），
     *    主线程不等解码（open 立即返回）；
-     * 2) 放开停稳窗口 → 高档落同一槽：tier=high、槽内字节不变（不翻倍常驻）、槽位全程不空；
-     * 3) 拖动中强塞的高档请求 → 被 M22 的 gen/窗口取消通道作废（skip=cancel），不会被解出来。 */
+     * 2) 放开停稳窗口 → 高档落同一槽：tier=high、**总常驻不增加**（不是恒真的槽内字节比较）、
+     *    槽位全程不空、本次操作存活增量 ≤3MB、两档共存绝对峰值有上界；
+     * 3) 双击放大后按新几何先落低档，再换清晰 → 缩放/平移一字不差（P2-2）；
+     * 4) 拖动中强塞的高档请求 → 被 M22 的 gen/窗口取消通道作废（skip=cancel），不会被解出来；
+     * 5) 整串生命周期解码次数有界（P2-3）。 */
    if (have_jpeg) {
        char tierbook[MR_PATH_MAX];
        snprintf(tierbook, sizeof tierbook, "%s/tier", root);
@@ -829,7 +861,7 @@ int main(void)
            char src[MR_PATH_MAX], dst[MR_PATH_MAX];
            snprintf(src, sizeof src, "%s/base2000.jpg", jpgbook);
            snprintf(dst, sizeof dst, "%s/t%d.jpg", tierbook, i + 1);
-            if (copy_file(src, dst) != 0) tier_ok = 0;
+            if (link_or_copy(src, dst) != 0) tier_ok = 0;
        }
        if (tier_ok) {
            mr_reader_ui_test_set_mem(4096, 16000);
@@ -843,6 +875,7 @@ int main(void)
            pump_ms(800);
            meow_ui_paint_full();
            int page0 = mr_reader_ui_page();
+            int dec0 = mr_reader_ui_decode_count();
            CHECK(mr_reader_ui_focus_tier() == MR_TIER_LOW,
                  "low tier lands first (tier=%d)", mr_reader_ui_focus_tier());
            CHECK(mr_reader_ui_low_decodes() >= 1, "low decode issued (%d)",
@@ -851,6 +884,7 @@ int main(void)
                  "no high decode before the settle window (%d)", mr_reader_ui_high_decodes());
            long low_kb = mr_reader_ui_slot_kb(page0);
            CHECK(low_kb > 0, "low tier image resident (%ldKB)", low_kb);
+            long res_low = mr_reader_ui_resident_kb();
            int bl = mr_reader_ui_blit_draws(), sc = mr_reader_ui_scaled_draws();
            meow_ui_paint_full();
            CHECK(mr_reader_ui_blit_draws() > bl && mr_reader_ui_scaled_draws() == sc,
@@ -860,12 +894,15 @@ int main(void)
            /* 放开升级：边等边采样，焦点槽任何时刻都不能空（不闪白）。 */
            int high0 = mr_reader_ui_high_decodes();
            long min_slot = low_kb;
+            size_t op_base = g_live;
+            peak_reset();
            mr_reader_ui_test_set_sharpen_ms(0);
            for (int i = 0; i < 100 && mr_reader_ui_focus_tier() != MR_TIER_HIGH; i++) {
                pump_ms(10);
                long k = mr_reader_ui_slot_kb(page0);
                if (k > 0 && k < min_slot) min_slot = k;
            }
+            size_t op_peak = peak_since(op_base);          /* 高档这一次操作的存活增量 */
            meow_ui_paint_full();
            CHECK(mr_reader_ui_page() == page0, "tier swap keeps the page (%d -> %d)",
                  page0, mr_reader_ui_page());
@@ -875,16 +912,53 @@ int main(void)
            CHECK(mr_reader_ui_high_decodes() > high0,
                  "high decode issued after settle (%d -> %d)", high0,
                  mr_reader_ui_high_decodes());
-            long high_kb = mr_reader_ui_slot_kb(page0);
-            CHECK(high_kb > 0 && high_kb <= low_kb + 8,
-                  "same-slot swap: one page resident, not two (%ldKB -> %ldKB)", low_kb,
-                  high_kb);
+            /* P2-2：旧的 `slot_kb` 相等是恒真（两档都落同一个 box）。改成真正会抓问题的
+             * 「总常驻不增加」：如果换清晰偷偷多留一张低档，这里立刻涨。 */
+            long res_high = mr_reader_ui_resident_kb();
+            CHECK(res_high > 0 && res_high <= res_low,
+                  "换清晰不增加常驻（没有第二张低档常驻）：%ldKB -> %ldKB",
+                  res_low, res_high);
+            CHECK(op_peak <= 3 * 1024 * 1024,
+                  "高档单次操作的存活增量 ≤3MB (%zuKB)", op_peak / 1024);
+            /* 两档共存总账：常驻 + 本次解码 的绝对峰值有上界（不是「基线含低档所以没涨」）。 */
+            CHECK(g_peak <= (size_t)(mr_reader_ui_resident_cap_kb() + 3 * 1024) * 1024,
+                  "两档共存绝对峰值 ≤ 常驻上限+3MB (%zuKB)", g_peak / 1024);
            CHECK(min_slot > 0, "no blank frame while swapping tiers (min slot %ldKB)",
                  min_slot);
            CHECK(mr_reader_ui_scaled_draws() == sc,
                  "high tier still native blit (scaled %d -> %d)", sc,
                  mr_reader_ui_scaled_draws());

+            /* P2-2 之二：换清晰不得重置缩放/平移。先冻结窗口 → 双击放大（低档按新几何重解）
+             * → 记录缩放/平移 → 放开升级 → 高档落位后两者必须一字不差。 */
+            mr_reader_ui_test_set_sharpen_ms(60000);       /* 先冻结，让放大后的低档先落位 */
+            reader_on_touch_down(240, 360);
+            reader_on_tap(240, 360);
+            pump_ms(60);
+            reader_on_touch_down(240, 360);
+            reader_on_tap(240, 360);
+            pump_ms(150);
+            pump_ms(600);
+            int zoom_before = mr_reader_ui_zoom_pct();
+            int panx_before = mr_reader_ui_pan_x();
+            int pany_before = mr_reader_ui_pan_y();
+            CHECK(zoom_before > 100, "double tap zoomed in (zoom=%d)", zoom_before);
+            CHECK(mr_reader_ui_focus_tier() == MR_TIER_LOW,
+                  "zoomed page re-decodes to low tier first (tier=%d)",
+                  mr_reader_ui_focus_tier());
+            mr_reader_ui_test_set_sharpen_ms(0);
+            for (int i = 0; i < 100 && mr_reader_ui_focus_tier() != MR_TIER_HIGH; i++)
+                pump_ms(10);
+            CHECK(mr_reader_ui_focus_tier() == MR_TIER_HIGH,
+                  "zoomed page reaches the target tier (tier=%d)",
+                  mr_reader_ui_focus_tier());
+            CHECK(mr_reader_ui_zoom_pct() == zoom_before &&
+                  mr_reader_ui_pan_x() == panx_before &&
+                  mr_reader_ui_pan_y() == pany_before,
+                  "换清晰不重置缩放/平移（zoom %d→%d, pan %d,%d→%d,%d）",
+                  zoom_before, mr_reader_ui_zoom_pct(), panx_before, pany_before,
+                  mr_reader_ui_pan_x(), mr_reader_ui_pan_y());
+
            /* 拖动中取消高档：拖动期间强塞一个「换清晰」请求，必须被取消通道作废。 */
            int hd0 = mr_reader_ui_high_decodes(), hc0 = mr_reader_ui_high_canceled();
            reader_on_touch_down(240, 400);
@@ -900,7 +974,40 @@ int main(void)
                  mr_reader_ui_high_decodes());
            reader_on_tap(240, 400);                       /* 松手：回弹，不翻页 */
            pump_ms(300);
-            mr_reader_ui_test_set_sharpen_ms(200);         /* 恢复产品默认停稳窗口 */
+
+            /* P2-2 之三：条漫滚动位置在换清晰时不得被重置（换的是视口中心页的档位）。 */
+            mr_reader_ui_test_set_sharpen_ms(60000);       /* 先冻结：切模式时不要立刻换清晰 */
+            mr_reader_test_toggle_mode();                  /* 翻页 → 条漫 */
+            CHECK(mr_reader_ui_mode() == MR_MODE_WEBTOON, "tier book switched to webtoon");
+            pump_ms(300);
+            reader_on_touch_down(240, 600);
+            for (int k = 1; k <= 5; k++) {
+                reader_on_touch_move(240, 600 - k * 50);
+                pump_ms(10);
+            }
+            reader_on_tap(240, 300);                       /* 松手：fling */
+            pump_ms(2000);                                 /* 等 fling 停稳 */
+            int woff0 = mr_reader_ui_woff();
+            int wpage0 = mr_reader_ui_page();
+            CHECK(woff0 > 0, "webtoon scrolled to a non-top offset (%d px)", woff0);
+            CHECK(mr_reader_ui_focus_tier() == MR_TIER_LOW,
+                  "webtoon center page is low tier before settle (tier=%d)",
+                  mr_reader_ui_focus_tier());
+            mr_reader_ui_test_set_sharpen_ms(0);
+            for (int i = 0; i < 200 && mr_reader_ui_focus_tier() != MR_TIER_HIGH; i++)
+                pump_ms(10);
+            CHECK(mr_reader_ui_focus_tier() == MR_TIER_HIGH,
+                  "webtoon center page reaches the target tier (tier=%d)",
+                  mr_reader_ui_focus_tier());
+            CHECK(mr_reader_ui_woff() == woff0 && mr_reader_ui_page() == wpage0,
+                  "换清晰不重置条漫滚动位置（woff %d→%d, page %d→%d）",
+                  woff0, mr_reader_ui_woff(), wpage0, mr_reader_ui_page());
+            mr_reader_ui_test_set_sharpen_ms(150);         /* 恢复产品默认停稳窗口 */
+            /* P2-3：这一串（开册低+高、放大低+高、条漫低+高、一次被取消的高档）解码次数有界。 */
+            int decodes = mr_reader_ui_decode_count() - dec0;
+            CHECK(decodes <= 12, "两档生命周期解码次数有界 (decodes=%d)", decodes);
+            INFO("tier lifecycle: decodes=%d resident=%ldKB (低档/高档/放大/条漫 各一次换清晰)",
+                 decodes, mr_reader_ui_resident_kb());
            meow_view_page_pop();
            pump_ms(200);
        }