feat(saves): 截图缩略图墙（M251 · D54 全套：解码/缓存/上限/可见失败）

按 D54 落地，解码在 palette-extract、缓存在 presenter、像素随快照走、壳层只画。

palette-extract（上一提交）→ presenter：
- dto/saves/preview.rs：ScreenshotPreview{NotGenerated,Ready,Failed} + ThumbnailView
  （带 is_consistent：长度 ≠ w×h×4 的像素不许进渲染器）+ ScreenshotThumbKind；
  ScreenshotView 新增 preview 字段（像素不落盘，随 IPC 面走）；
- host/saves/thumbs.rs：attach() 在后台线程（spawn_list 同一条线程）按 mtime 倒序解前
  60 张、单张 >8 MiB 先查大小不进解码器、失败也逐条带原因；进程级 memo 键 =
  (路径, mtime, 大小)，覆盖/替换都会重解；超过 240 条只留本拍碰到的键；
- presenter 新增依赖 unlucky-palette-extract（塔已批，方向 presenter → palette-extract）。

app-iced：
- saves.rs 拆成 model / rows / wall（原文件 385 行，加完墙必破 400）：model 里建一次
  iced Handle（渲染回调零解码、零重复上传），wall 3 列排格子，没像素的格子给
  160×90 占位框 + 逐条原因；text.rs 拆出 text/saves.rs 承载存档/截图一族文案；
- i18n 加 4 条「这一格为什么没有图」（未生成/太大/读不出/解不出）+ 金表同步；
- 出图夹具（saves_shot）合成两种场景的像素，并摆出四种格子（真图×2/未生成/超限失败）。

用例：presenter 9 条（含缓存命中不重解、mtime 变了必重解、第 61 张不解、
>8MiB 不进解码器、缓存有界）+ app-iced 3 条（三种格子的副文案、坏像素降级）。

crates/app-iced/src/pages/instances/tests/i18n.rs

@@ -49,11 +49,17 @@ const ALLOWED: &[&str] = &[
 ];
 
 /// 页面取词的六个源码文件（死 key 扫描与旧串扫描共用）。
-const PAGE_SOURCES: [(&str, &str); 9] = [
+const PAGE_SOURCES: [(&str, &str); 12] = [
     ("instances.rs", include_str!("../../instances.rs")),
     ("instances/detail.rs", include_str!("../detail.rs")),
     ("instances/demo.rs", include_str!("../demo.rs")),
     ("instances/text.rs", include_str!("../text.rs")),
+    // M251：存档 / 截图一族从 text.rs 拆出（那边越过 400 行）——新文件必须一起扫，
+    // 否则那四句缩略图文案会被当成「死 key」。
+    (
+        "instances/text/saves.rs",
+        include_str!("../text/saves.rs"),
+    ),
     (
         "instances/launch_args.rs",
         include_str!("../launch_args.rs"),
@@ -68,6 +74,16 @@ const PAGE_SOURCES: [(&str, &str); 9] = [
     ("instances/saves.rs", include_str!("../saves.rs")),
     // M247：SAVES 区的行与操作区（重命名 / 备份 / 删除 + 行内输入框）
     ("instances/saves/rows.rs", include_str!("../saves/rows.rs")),
+    // M251：SAVES 区的视图模型（快照 → 行/格子；缩略图句柄在这里建）
+    (
+        "instances/saves/model.rs",
+        include_str!("../saves/model.rs"),
+    ),
+    // M251：截图缩略图墙
+    (
+        "instances/saves/wall.rs",
+        include_str!("../saves/wall.rs"),
+    ),
 ];
 
 /// 页面五件套里**允许出现的字符串字面量**（凡是带 ASCII 单词的都必须在这张表里）。
@@ -319,25 +335,32 @@ fn every_english_literal_in_the_page_sources_is_whitelisted() {
         "只扫到 {checked} 条带英文的字面量，扫描器可能失效了"
     );
 
-    // 反向锚②：这些来源**必须**真的在用 Texts / 目录
+    // 反向锚②：这些来源**必须**真的在用 Texts / 目录。
+    //
+    // M251：原来按下标取（`PAGE_SOURCES[5]`），插进一条新文件就整体错位——改成**按文件名取**，
+    // 以后再拆文件不必回来改下标（拆错文件时仍然会红：找不到那个名字就 panic）。
+    let source = |name: &str| -> &'static str {
+        PAGE_SOURCES
+            .iter()
+            .find(|(file, _)| *file == name)
+            .map(|(_, source)| *source)
+            .unwrap_or_else(|| panic!("PAGE_SOURCES 里没有 {name}：拆文件之后忘了登记？"))
+    };
+    assert!(source("instances.rs").contains("Texts::of("), "实例页没有从 Texts 取词");
     assert!(
-        PAGE_SOURCES[0].1.contains("Texts::of("),
-        "实例页没有从 Texts 取词"
-    );
-    assert!(
-        PAGE_SOURCES[0].1.contains("Header::new(texts.title())"),
+        source("instances.rs").contains("Header::new(texts.title())"),
         "页头标题必须是词表里的那条（`Header::new` 里写死字符串 = 中文界面上顶着英文标题）"
     );
     assert!(
-        PAGE_SOURCES[3].1.contains("Key::Instances"),
+        source("instances/text.rs").contains("Key::Instances"),
         "text.rs 没有引用本族的 key"
     );
     assert!(
-        PAGE_SOURCES[5].1.contains("Key::InstancesStage"),
+        source("app/view/instances.rs").contains("Key::InstancesStage"),
         "阶段标签没有走目录"
     );
     assert!(
-        PAGE_SOURCES[4].1.contains("texts.launch_title()"),
+        source("instances/launch_args.rs").contains("texts.launch_title()"),
         "启动参数区没有走目录"
     );
 }

crates/app-iced/src/pages/instances/tests/saves.rs

@@ -9,11 +9,12 @@
 
 use unlucky_presenter::dto::{
     SavesArea, SavesFailureKind, SavesFailureView, SavesListView, SavesSkipKind, SavesSkipView,
-    ScreenshotView, WorldView,
+    ScreenshotPreview, ScreenshotThumbFailure, ScreenshotThumbKind, ScreenshotView, ThumbnailView,
+    WorldView,
 };
 use unlucky_presenter::state::SavesState;
 
-use super::super::saves::{failure_line, from_state};
+use super::super::saves::{failure_line, from_state, ShotPreview};
 use super::super::Texts;
 use unlucky_i18n::Lang;
 
@@ -36,6 +37,12 @@ fn view(instance: &str) -> SavesListView {
             file: "2024-05-01_10.00.00.png".to_string(),
             bytes: 2_048,
             modified_ms: None,
+            // M251：一像素的缩略图——这条用例只关心「格子/计数/副文案」的映射，不关心解码。
+            preview: ScreenshotPreview::Ready(ThumbnailView {
+                width: 1,
+                height: 1,
+                pixels: vec![0x2E, 0x7D, 0x4F, 0xFF],
+            }),
         }],
         skipped: vec![SavesSkipView {
             area: SavesArea::Screenshots,
@@ -79,6 +86,11 @@ fn the_snapshot_becomes_rows_with_stamps_and_badges() {
     );
 
     assert_eq!(saves.screenshots.len(), 1);
+    assert_eq!(
+        saves.thumbnails(),
+        1,
+        "带了像素的截图必须变成一格真图（不是占位）"
+    );
     assert!(
         saves.screenshots[0].detail.contains("2.0 KB"),
         "截图的副文案要带大小：{:?}",
@@ -243,3 +255,103 @@ fn millisecond_stamps_are_rendered_in_utc() {
 }
 
 mod write;
+
+/// **缩略图墙的三种格子**（M251 · D54 第 6 条）：有像素 / 没轮到 / 具名失败，副文案各说各的。
+///
+/// 抓得住：①有像素却不画（`Ready` 被吞成占位）；②「没生成」与「失败」被合并成同一句
+/// （用户没法分辨"刷新一下可能就有了"与"得自己去修文件"）；③失败原因没上屏（原文丢掉）。
+/// 抓不住：像素画得对不对（`Element` 没有内省接口，只能靠 `DevDocs/artifacts/m251/` 的图）。
+#[test]
+fn every_preview_state_gets_its_own_caption() {
+    let texts = Texts::of(Lang::ZhCn.catalog());
+    let mut snapshot = view("a");
+    snapshot.screenshots = vec![
+        ScreenshotView {
+            file: "ok.png".to_string(),
+            bytes: 2_048,
+            modified_ms: Some(STAMP),
+            preview: ScreenshotPreview::Ready(ThumbnailView {
+                width: 2,
+                height: 1,
+                pixels: vec![1, 2, 3, 4, 5, 6, 7, 8],
+            }),
+        },
+        ScreenshotView {
+            file: "pending.png".to_string(),
+            bytes: 4_096,
+            modified_ms: Some(STAMP - 1),
+            preview: ScreenshotPreview::NotGenerated,
+        },
+        ScreenshotView {
+            file: "huge.png".to_string(),
+            bytes: 9_437_184,
+            modified_ms: Some(STAMP - 2),
+            preview: ScreenshotPreview::Failed(ScreenshotThumbFailure {
+                kind: ScreenshotThumbKind::TooLarge,
+                detail: "9437184 > 8388608 字节".to_string(),
+            }),
+        },
+    ];
+    let mut state = bound_state("a");
+    state.changed(snapshot);
+    let saves = from_state(&state, Lang::ZhCn.catalog());
+
+    assert_eq!(saves.thumbnails(), 1, "只有第一格有像素");
+    assert!(matches!(
+        saves.screenshots[0].preview,
+        ShotPreview::Ready { .. }
+    ));
+    assert_eq!(
+        saves.screenshots[1].preview,
+        ShotPreview::Missing {
+            note: texts.saves_preview_none().to_string()
+        }
+    );
+    assert_eq!(
+        saves.screenshots[2].preview,
+        ShotPreview::Missing {
+            note: texts
+                .saves_preview_reason(ScreenshotThumbKind::TooLarge)
+                .to_string()
+        }
+    );
+    // 失败的副文案要带 OS/解码器原文（只进括号），没生成的那格只要一句短话。
+    assert_eq!(
+        saves.screenshots[2].detail,
+        format!(
+            "{}（9437184 > 8388608 字节）",
+            texts.saves_preview_reason(ScreenshotThumbKind::TooLarge)
+        )
+    );
+    assert_eq!(saves.screenshots[1].detail, texts.saves_preview_none());
+}
+
+/// 像素长度与宽高对不上时**不许**建句柄（`Handle::from_rgba` 不校验长度 ⇒ 画出来是花屏）。
+///
+/// 抓得住：把 `is_consistent()` 那道判断删掉（这时会走 `Ready`，`thumbnails()` 变 1 而断言要 0）。
+#[test]
+fn inconsistent_pixels_are_shown_as_a_failure_not_a_broken_image() {
+    let mut snapshot = view("a");
+    snapshot.screenshots = vec![ScreenshotView {
+        file: "short.png".to_string(),
+        bytes: 10,
+        modified_ms: Some(STAMP),
+        preview: ScreenshotPreview::Ready(ThumbnailView {
+            width: 4,
+            height: 4,
+            pixels: vec![0; 15],
+        }),
+    }];
+    let mut state = bound_state("a");
+    state.changed(snapshot);
+    let saves = from_state(&state, Lang::ZhCn.catalog());
+    assert_eq!(saves.thumbnails(), 0, "坏像素不该被当成图");
+    assert_eq!(
+        saves.screenshots[0].preview,
+        ShotPreview::Missing {
+            note: Texts::of(Lang::ZhCn.catalog())
+                .saves_preview_reason(ScreenshotThumbKind::Decode)
+                .to_string()
+        }
+    );
+}