feat(app-iced): M109 CONTENTDL —— 内容库页（整合包/Mod/资源包/光影）

用户令「下载页只负责下载整合包和Mod/光影」：新开一页做**内容发现与装入**，
检索走 Modrinth（优先，无需 key）/ CurseForge（`ULL_CF_API_KEY` 环境变量，日志只打
set/unset），装入走 core 的下载引擎真下到实例目录，进度/取消/失败复用下载页那块安装面板。

- **入口（B1）**：`Route::Content` 是新顶层路由，但 `Route::nav()` 复用 `NavSection::Download`
  ——导航轨仍五项，页头右上是「版本管理 | 内容库」一级切换（版本管理页也加了同一个切换，
  否则内容库只有 `ULL_START_ROUTE` 能到）
- **页内四条一级侧栏**（`pages/content/layout.rs` 四档几何：992/856/648 三个门槛都是
  「Σ栏宽 + 间距」算出来的）：整合包 / Mod / 资源包 / 光影；标签栏 200（`Resource packs`
  比 M107 的版本类型名长，140 会切字，已登记偏离）
- **筛选**：关键词（草稿 + 显式「搜索」按钮，不逐字打网络）、来源、游戏版本、加载器
  （Fabric/Forge/NeoForge/Quilt）、排序；**分页**（「加载更多」）而不是无限滚动——快照只有一个槽、
  翻页要看得见、状态要可截图复现
- **四态**：加载 / 空 / 失败 / 有数据 + 「没有更多了」；筛选条在任何状态下都在（加载中藏筛选条
  等于把入口收走）
- **一键装入**：`Content::blockers()` 是纯函数——版本不匹配、加载器不匹配、没有目标实例、
  整合包缺管线**四条原因逐条**给出，按钮点之前就禁用；判定与画法分开（model/tests 直接钉）
- **整合包今天不可装**：`ContentKind::Modpack.dir()` 是 `None`，UI 禁用 + 说明，host 侧再挡
  一次（绕过 UI 也只会回一条 Failed）。真流程是 M111 的导入管线
- **零 UI 网络**：`presenter/host/addon.rs` + `addon/{sources,http,install}.rs`；无 header 的请求走
  core 的 `download_bytes`（信号量限流 + 健康度 + 退避全现成），带 `X-API-KEY` 的只有 CF 一条，
  自带 429/5xx 退避（优先吃 `Retry-After`，封顶 30s）；密钥不进 DTO/日志/仓库
- 文案 41 条中英进 `crates/i18n`（新域接在装配链末尾 ⇒ `Key::ALL` 与金表只追加）
- 演示数据 `ContentHit → Hit::of` 与产品路径同源（格式化不会两套），`ULL_CONTENT_KIND` /
  `ULL_CONTENT_STATE` 供出图矩阵选类型与状态

取证：`DevDocs/artifacts/m109/`（10 张：四类内容 × 浅/深 + 搜索无结果 + 加载器不兼容禁用）

门禁：fmt ✓ / clippy `-D warnings`（三 crate）✓ / app-iced 450+6、presenter 170、i18n 24 全绿；
`cargo tree` 两条零 UI 门禁仍空；全部改动文件 ≤400 行。

crates/app-iced/src/pages/content/model/tests.rs

@@ -0,0 +1,274 @@
+//! 内容库视图模型的守门测试（M109）：四态判定、兼容性判定、装入闸门。
+//!
+//! 全部是纯函数级断言（不开图形环境）：`status_of` / `blockers_of` / `Content::can_install`
+//! 是页面「该画什么、按钮能不能按」的唯一判据，钉住它们比截图更早期。
+
+use super::*;
+use unlucky_i18n::Lang;
+use unlucky_presenter::dto::{
+    ContentHit, ContentKind, ContentQuery, ContentResults, ContentSource, InstanceRuntime,
+    LoaderKind,
+};
+
+fn hit(versions: &[&str], loaders: &[&str]) -> ContentHit {
+    ContentHit {
+        id: "p1".to_string(),
+        slug: "p".to_string(),
+        title: "Sodium".to_string(),
+        summary: "fast".to_string(),
+        author: "jelly".to_string(),
+        downloads: 10,
+        updated: "2026-01-01".to_string(),
+        source: ContentSource::Modrinth,
+        game_versions: versions.iter().map(|item| (*item).to_string()).collect(),
+        loaders: loaders.iter().map(|item| (*item).to_string()).collect(),
+        icon: None,
+    }
+}
+
+fn targets() -> Vec<Target> {
+    vec![
+        Target {
+            id: "fabric-1.20.1".to_string(),
+            name: "Survival".to_string(),
+            mc_version: "1.20.1".to_string(),
+            loader: LoaderKind::Fabric,
+        },
+        Target {
+            id: "forge-1.21.1".to_string(),
+            name: "Modded".to_string(),
+            mc_version: "1.21.1".to_string(),
+            loader: LoaderKind::Forge,
+        },
+    ]
+}
+
+fn blockers_of_hit(hit: &ContentHit, kind: ContentKind, target: Option<&str>) -> Vec<Blocker> {
+    blockers_of(
+        Some((hit.game_versions.as_slice(), hit.loaders.as_slice())),
+        kind,
+        &targets(),
+        target,
+    )
+}
+
+#[test]
+fn a_matching_project_has_no_blockers() {
+    let hit = hit(&["1.20.1"], &["fabric"]);
+    assert!(blockers_of_hit(&hit, ContentKind::Mod, Some("fabric-1.20.1")).is_empty());
+}
+
+#[test]
+fn a_version_mismatch_is_reported_before_the_user_clicks() {
+    // 抓得住：把「版本对不上」留到点了才报错（任务书第 3 条禁止的正是这个）。
+    let hit = hit(&["1.20.1"], &["fabric"]);
+    let blockers = blockers_of_hit(&hit, ContentKind::Mod, Some("forge-1.21.1"));
+    assert!(blockers.contains(&Blocker::Version {
+        needs: "1.20.1".to_string(),
+        actual: "1.21.1".to_string()
+    }));
+    assert!(blockers.contains(&Blocker::Loader {
+        loader: LoaderKind::Forge
+    }));
+}
+
+#[test]
+fn both_mismatches_are_reported_separately() {
+    // 合成一条会在「都不兼容」时只说一半原因
+    let hit = hit(&["1.20.1"], &["fabric"]);
+    assert_eq!(
+        blockers_of_hit(&hit, ContentKind::Mod, Some("forge-1.21.1")).len(),
+        2
+    );
+}
+
+#[test]
+fn site_data_that_is_missing_never_blocks() {
+    // 站点没给版本/加载器 = 未知，不是「不支持」
+    let hit = hit(&[], &[]);
+    assert!(blockers_of_hit(&hit, ContentKind::Mod, Some("forge-1.21.1")).is_empty());
+}
+
+#[test]
+fn modpacks_are_blocked_by_the_missing_pipeline_not_by_compatibility() {
+    let hit = hit(&["1.20.1"], &["fabric"]);
+    assert_eq!(
+        blockers_of_hit(&hit, ContentKind::Modpack, Some("fabric-1.20.1")),
+        vec![Blocker::NeedsPipeline]
+    );
+    // 资源包 / 光影 / Mod 都没有这一条
+    for kind in [
+        ContentKind::Mod,
+        ContentKind::Resourcepack,
+        ContentKind::Shader,
+    ] {
+        assert!(blockers_of_hit(&hit, kind, Some("fabric-1.20.1")).is_empty());
+    }
+}
+
+#[test]
+fn no_target_instance_disables_the_button_with_a_reason() {
+    assert_eq!(
+        blockers_of(None, ContentKind::Mod, &[], None),
+        vec![Blocker::NoTarget]
+    );
+    // 有实例但选中项不在名单里（被删了）：同样不许静默通过
+    assert_eq!(
+        blockers_of(None, ContentKind::Mod, &targets(), Some("gone")),
+        vec![Blocker::NoTarget]
+    );
+    // 没选中项目：只剩「目标」与「整包」这两类先天原因
+    assert!(blockers_of(None, ContentKind::Mod, &targets(), Some("fabric-1.20.1")).is_empty());
+}
+
+fn state_with(results: Option<ContentResults>, pending: bool) -> AppState {
+    let mut state = AppState::new();
+    state.instances = Vec::new();
+    state.content.pending = pending;
+    state.content.results = results;
+    state
+}
+
+fn results(hits: Vec<ContentHit>, offset: u32) -> ContentResults {
+    let mut query = ContentQuery::first(ContentKind::Mod);
+    query.offset = offset;
+    ContentResults {
+        query,
+        hits,
+        total: 100,
+        curseforge: false,
+    }
+}
+
+#[test]
+fn the_four_states_are_derived_from_three_fields() {
+    let page = PageState::default();
+    let catalog = Lang::En.catalog();
+
+    // 还没有结果 ⇒ 加载
+    let loading = Content::from_snapshot(&state_with(None, false), &page, catalog);
+    assert!(loading.is_loading());
+    assert_eq!(loading.status, Status::Loading);
+
+    // 请求在飞 ⇒ 加载（即使手里还有上一批）
+    let pending = Content::from_snapshot(
+        &state_with(Some(results(vec![hit(&["1.20.1"], &["fabric"])], 0)), true),
+        &page,
+        catalog,
+    );
+    assert_eq!(pending.status, Status::Loading);
+
+    // 拉到了但零命中 ⇒ 空
+    let empty = Content::from_snapshot(
+        &state_with(Some(results(Vec::new(), 0)), false),
+        &page,
+        catalog,
+    );
+    assert_eq!(empty.status, Status::Empty);
+
+    // 有命中 ⇒ 有数据
+    let ready = Content::from_snapshot(
+        &state_with(Some(results(vec![hit(&["1.20.1"], &["fabric"])], 0)), false),
+        &page,
+        catalog,
+    );
+    assert_eq!(ready.status, Status::Ready);
+    assert_eq!(ready.hits.len(), 1);
+    assert_eq!(ready.hits[0].title, "Sodium");
+    assert!(!ready.has_more, "只有 1 条、不够一页 ⇒ 没有下一页");
+}
+
+#[test]
+fn a_failure_outranks_the_loading_state() {
+    let mut state = state_with(None, true);
+    state.content.failed = Some("网络不通".to_string());
+    let model = Content::from_snapshot(&state, &PageState::default(), Lang::En.catalog());
+    assert_eq!(model.status, Status::Failed("网络不通".to_string()));
+    assert!(model.status.failed());
+}
+
+#[test]
+fn can_install_needs_a_selection_and_no_blockers() {
+    let mut state = state_with(Some(results(vec![hit(&["1.20.1"], &["fabric"])], 0)), false);
+    state.instances = vec![unlucky_presenter::dto::InstanceSummary {
+        id: "fabric-1.20.1".to_string(),
+        name: "Survival".to_string(),
+        mc_version: "1.20.1".to_string(),
+        loader: unlucky_presenter::dto::LoaderInfo {
+            kind: LoaderKind::Fabric,
+            version: "0.16.5".to_string(),
+        },
+        last_played: None,
+        runtime: InstanceRuntime::Idle,
+        icon: None,
+        isolation: "isolated".to_string(),
+        version_id: "1.20.1".to_string(),
+        version_present: true,
+    }];
+    let catalog = Lang::En.catalog();
+    let page = PageState {
+        kind: ContentKind::Mod,
+        selected: None,
+        target: None,
+        draft: String::new(),
+    };
+
+    // 没选中项目 ⇒ 不能装（也不该说「成功」）
+    let no_selection = Content::from_snapshot(&state, &page, catalog);
+    assert!(!no_selection.can_install());
+    assert_eq!(
+        no_selection.target.as_deref(),
+        Some("fabric-1.20.1"),
+        "只有一个实例就默认选它"
+    );
+
+    // 选中兼容项 ⇒ 能装
+    let page = PageState {
+        selected: Some("p1".to_string()),
+        ..page
+    };
+    let compatible = Content::from_snapshot(&state, &page, catalog);
+    assert!(compatible.can_install());
+    assert!(compatible.blocker_reasons(catalog).is_empty());
+    assert!(compatible.target_label.is_some());
+}
+
+#[test]
+fn the_panel_only_shows_while_an_install_is_unfinished() {
+    use unlucky_presenter::dto::{InstallProgressView, InstallStage};
+
+    let mut state = state_with(None, false);
+    state.install = Some(InstallProgressView {
+        version: "Sodium".to_string(),
+        stage: InstallStage::Downloading,
+        files_total: 1,
+        ..InstallProgressView::new()
+    });
+    let running = Content::from_snapshot(&state, &PageState::default(), Lang::En.catalog());
+    assert!(running.panel.is_some(), "下载中要有面板");
+
+    state.install = Some(InstallProgressView {
+        stage: InstallStage::Done,
+        ..InstallProgressView::new()
+    });
+    let done = Content::from_snapshot(&state, &PageState::default(), Lang::En.catalog());
+    assert!(done.panel.is_none(), "装完的面板不该钉在页面上");
+}
+
+#[test]
+fn loader_names_are_ascii_so_the_english_baseline_stays_english() {
+    for loader in [
+        LoaderKind::Vanilla,
+        LoaderKind::Fabric,
+        LoaderKind::Forge,
+        LoaderKind::NeoForge,
+        LoaderKind::Quilt,
+    ] {
+        assert!(loader_name(loader).is_ascii(), "{loader:?}");
+    }
+    assert_eq!(
+        loader_name(LoaderKind::Vanilla),
+        "Vanilla",
+        "不能画「原版」"
+    );
+}