feat(m168): 中文字体 CDN 下载真接线（D28 后半）

M167 调研的结论是「中文字体 CDN 下载至今未实装」：`i18n::font` 只有 `Fetcher` trait 与假实现，`needs-download` 分支什么也不做。这条把它接成一条真链路。判据 → 下载 → 注册（一条链，四个 crate 各管一段）： * `unlucky_i18n::font`（零依赖）：`Source::Pinned { urls, sha256, bytes }` 把「下什么」钉死——google/fonts 的 `NotoSansSC[wght].ttf` 钉到 commit `2894aab…`（不是 `@main`）， 17 772 300 B / sha256 `a3041811…`。可变字体一份覆盖 wght 100–900，省掉三份静态子集的 25 MiB。 `FetchError` 补第三档 `Disk`（网络 / 校验 / 磁盘，UI 按类别选词）。 * `unlucky_core::download::font`（新）：缓存命中 → 共享引擎 `download_bytes` → 复验（sha256 + sfnt 魔数 + 32 MiB 上限）→ 原子落盘。**复验在写盘之前**，所以「哈希不符」时盘上什么都没有；缓存按 `<sha256 前 16 位>` 命名，pin 一换自动换名。 * `unlucky_app_iced::fonts::{cdn,install}`（新）：`CdnFetcher` 把 pin 接进 core（`ui.font_cdn` 可覆盖 URL，哈希不换）；`install` 是状态机 + 后台线程，只有 `NeedsDownload` 才起线程（英文 / 系统已有 / 探测不出一律零网络）。注册走 `iced_graphics::text::FontSystem::load_font`，族名从字体库读回来核对。失败只降级（继续用系统字体），不阻塞、不崩。 * 接入两条路径：`fonts::resolve_with`（启动）与 `fonts::cjk_for`（设置页切语言）都调 `install::after_probe`；设置页 General 组多一行状态（下载中 / 完成 / 失败 / 无需下载 + 三类失败原因），文案进 catalog 金表（链尾追加，既有顺序不动）；`App::advance` 每秒比对状态快照后重建视图模型，所以那一行会自己刷新。配置：新增 `ui.font_cdn`（`keys/font.rs`，schema 1.7.0），空 = 内置 jsDelivr 镜像（含备用边缘）。守卫（三条都能变红，变异证明见报告）：core 侧 8 条（缓存不联网 / 哈希不符拒落盘 / HTML 不当字体 / 坏缓存自愈 / 上限 / pin 校验），app 侧 6 条（三种闲置策略零调用、失败不注册、类别不串、幂等、截图钉子、单行日志），页面侧 1 条（四态 × 两语言无缺译、不写假百分比）。测试：`cargo test -p unlucky-i18n --lib` 31 绿；`-p unlucky-core --lib` 622 绿； `-p unlucky-app-iced --lib` 684 绿；`cargo fmt --check` 干净。截图三张见报告。
2026-11-08 14:38:23 +08:00
1 parent 2a004a5754
commit 449ded2cb7
@@ -35,6 +35,82 @@ fn the_general_group_keeps_theme_startup_and_close_as_static_rows() {
    );
 }

+/// **M168（D28 后半）**：中文字体下载状态行的四种状态都得有话说，且两套目录都不许 `⟪missing⟫`。
+///
+/// 抓得住：①只画「下载成功」一种（失败的用户会以为程序坏了）；②失败态的文案写成「保持英文」
+/// （D28 的实际行为是**继续用系统字体**，界面语言不变）；③占位符没被替换（用户会看到 `{family}`）；
+/// ④新 key 只进了英文表（中文界面上出现 `⟪missing⟫`）。
+/// 抓不住：真下载时的样子（那要联网）、字体有没有真的出字（截图 + 真机，见报告）。
+#[test]
+fn the_font_status_row_speaks_in_four_states_and_two_languages() {
+    use crate::fonts::install::{CjkInstall, FetchClass};
+
+    let states = [
+        CjkInstall::Downloading { bytes: 17_772_300 },
+        CjkInstall::Ready {
+            family: "Noto Sans SC".to_owned(),
+            from_cache: true,
+        },
+        CjkInstall::Failed {
+            class: FetchClass::Network,
+            message: "timeout".to_owned(),
+        },
+        CjkInstall::System {
+            family: "Microsoft YaHei".to_owned(),
+        },
+        CjkInstall::NotNeeded,
+        CjkInstall::Unprobeable,
+        CjkInstall::Unknown,
+    ];
+
+    for lang in Lang::ALL {
+        let catalog = lang.catalog();
+        assert!(
+            catalog.get(Key::FontCjkStatusLabel).is_some(),
+            "{} 目录里缺中文字体那一行的标签",
+            lang.tag()
+        );
+        for state in &states {
+            let (value, hint) = general::font_status(&catalog, state);
+            assert!(!value.is_empty(), "{state:?} 没话说");
+            assert!(!value.contains('{'), "{state:?} 占位符没替换：{value}");
+            assert!(
+                !value.contains(unlucky_i18n::catalog::MISSING),
+                "{state:?} 在 {} 目录里缺译：{value}",
+                lang.tag()
+            );
+            if let Some(hint) = hint {
+                assert!(!hint.contains('{'), "{state:?} 的提示没替换：{hint}");
+            }
+        }
+    }
+
+    // 失败态必须说清三类原因之一（而不是一句「失败了」）。
+    let zh = Lang::ZhCn.catalog();
+    for (class, reason) in [
+        (FetchClass::Network, "网络不通"),
+        (FetchClass::Integrity, "镜像内容校验不通过"),
+        (FetchClass::Disk, "写不进数据目录"),
+    ] {
+        let (value, _) = general::font_status(
+            &zh,
+            &CjkInstall::Failed {
+                class,
+                message: "x".to_owned(),
+            },
+        );
+        assert!(value.contains(reason), "失败原因没进文案：{value}");
+    }
+
+    // 下载中写的是**真实**字节数（17.0 MB），不是假百分比。
+    let (value, _) = general::font_status(&zh, &CjkInstall::Downloading { bytes: 17_772_300 });
+    assert!(
+        value.contains("16.9 MB"),
+        "17 772 300 B ≈ 16.9 MiB：{value}"
+    );
+    assert!(!value.contains('%'), "没有真进度就不许写百分比：{value}");
+}
+
 /// 左列图标（`IconKind::Settings`）。分组图标是左列的语义标签，换掉就是换观感。
 #[test]
 fn the_general_group_keeps_its_icon() {