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/items.rs

@@ -0,0 +1,218 @@
+//! 内容库页的类型：页面自留状态 / 四态 / 展示行 / 目标实例 / 装不上的原因。
+//!
+//! 从 `pages/content/model.rs` 拆出（那个文件已贴 400 行硬上限）。纯数据类型与纯函数，
+//! 不认识 iced：`model/tests.rs` 直接钉它们的判定。
+
+use unlucky_presenter::dto::{ContentHit, ContentKind, ContentSource, InstanceSummary, LoaderKind};
+
+use unlucky_i18n::{Catalog, Key};
+
+/// 页面自留的选择（检索条件与结果在 presenter 的 `AppState::content`）。
+#[derive(Debug, Clone, PartialEq)]
+pub struct PageState {
+    /// 当前内容类型
+    pub kind: ContentKind,
+    /// 选中的项目 id（`None` = 没选 → 详情面板空态）
+    pub selected: Option<String>,
+    /// 目标实例 id（`None` = 没选 → 装入按钮禁用并说明）
+    pub target: Option<String>,
+    /// 关键词输入框里的草稿（**未提交**；提交后才进 `AppState::content.query`）
+    pub draft: String,
+}
+
+impl Default for PageState {
+    fn default() -> Self {
+        Self {
+            kind: ContentKind::Mod,
+            selected: None,
+            target: None,
+            draft: String::new(),
+        }
+    }
+}
+
+/// 页面此刻画哪一态（四态 + 分页尾）。
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub enum Status {
+    /// 加载中（首屏 / 换条件 / 换页）
+    Loading,
+    /// 有命中项
+    Ready,
+    /// 拉到了但一条都没有
+    Empty,
+    /// 失败（带一句人读原因）
+    Failed(String),
+}
+
+impl Status {
+    /// 失败了吗（视图用它决定画错误面板还是列表）。
+    pub const fn failed(&self) -> bool {
+        matches!(self, Self::Failed(_))
+    }
+}
+
+/// 一条命中项的展示态（文案在这一层求好：iced 的文本控件借用内容）。
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct Hit {
+    /// 项目 id（选中 / 装入指令的载荷）
+    pub id: String,
+    /// 标题
+    pub title: String,
+    /// 一行说明
+    pub summary: String,
+    /// 来源 + 作者（`Modrinth · jelly`）
+    pub supporting: String,
+    /// 下载量（已加千分位）
+    pub downloads: String,
+    /// 更新日期的人读串
+    pub updated: String,
+    /// 支持的游戏版本（详情面板用；空 = 站点没给）
+    pub versions: Vec<String>,
+    /// 支持的加载器（**站点原样的小写 facet**：兼容性判定要用它跟 `loader_facet` 比）
+    pub loaders: Vec<String>,
+    /// 来源（行上标来源徽标）
+    pub source: ContentSource,
+}
+
+impl Hit {
+    /// 命中项 DTO → 展示态（**演示数据也走这条**，于是 fixture 与产品路径逐字段同源）。
+    pub(crate) fn of(hit: &ContentHit, catalog: Catalog) -> Self {
+        let source = match hit.source {
+            ContentSource::Modrinth => catalog.text(Key::ContentSourceModrinth),
+            ContentSource::Curseforge => catalog.text(Key::ContentSourceCurseforge),
+        };
+        let supporting = if hit.author.is_empty() {
+            source.to_string()
+        } else {
+            format!("{source} · {}", hit.author)
+        };
+        Self {
+            id: hit.id.clone(),
+            title: hit.title.clone(),
+            summary: hit.summary.clone(),
+            supporting,
+            downloads: catalog.render(
+                Key::ContentDetailDownloads,
+                &[("count", &thousands(hit.downloads))],
+            ),
+            updated: catalog.render(Key::ContentDetailUpdated, &[("date", &hit.updated)]),
+            versions: hit.game_versions.clone(),
+            loaders: hit.loaders.clone(),
+            source: hit.source,
+        }
+    }
+}
+
+/// 目标实例（一键装入的对象）的展示态。
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct Target {
+    /// 实例 id
+    pub id: String,
+    /// 显示名
+    pub name: String,
+    /// 游戏版本
+    pub mc_version: String,
+    /// 加载器
+    pub loader: LoaderKind,
+}
+
+impl Target {
+    pub(super) fn of(instance: &InstanceSummary) -> Self {
+        Self {
+            id: instance.id.clone(),
+            name: instance.name.clone(),
+            mc_version: instance.mc_version.clone(),
+            loader: instance.loader.kind,
+        }
+    }
+
+    /// 详情里那一行（`Survival · 1.20.4 · Fabric`）。
+    pub(crate) fn label(&self) -> String {
+        format!(
+            "{} · {} · {}",
+            self.name,
+            self.mc_version,
+            loader_name(self.loader)
+        )
+    }
+}
+
+/// 下载量加千分位（`1200000` → `1,200,000`）：raw 数字在详情面板上读不出量级。
+pub(crate) fn thousands(value: u64) -> String {
+    let digits = value.to_string();
+    let mut out = String::with_capacity(digits.len() + digits.len() / 3);
+    for (index, ch) in digits.chars().enumerate() {
+        if index > 0 && (digits.len() - index).is_multiple_of(3) {
+            out.push(',');
+        }
+        out.push(ch);
+    }
+    out
+}
+
+/// 首字母大写（`fabric` → `Fabric`；空串原样）。
+///
+/// **只在画的时候用**：`Hit::loaders` 与兼容性判定都保持站点原样的小写 facet，
+/// 否则「Fabric」与 facet「fabric」一比就成了不兼容（本轮踩过）。
+pub(crate) fn capitalize(raw: &str) -> String {
+    let mut chars = raw.chars();
+    match chars.next() {
+        Some(first) => first.to_uppercase().collect::<String>() + chars.as_str(),
+        None => String::new(),
+    }
+}
+
+/// 加载器的**界面名**（ASCII）。
+///
+/// 不复用 `LoaderKind::label()`：它对原版返回「原版」——中文业务串，而本仓的界面文案在 i18n
+/// 之前是英文基线（干净 CI 上没有中文字体，见 `pages/instances/data.rs` 的同一条理由）。
+pub const fn loader_name(loader: LoaderKind) -> &'static str {
+    match loader {
+        LoaderKind::Vanilla => "Vanilla",
+        LoaderKind::Fabric => "Fabric",
+        LoaderKind::Quilt => "Quilt",
+        LoaderKind::Forge => "Forge",
+        LoaderKind::NeoForge => "NeoForge",
+        LoaderKind::OptiFine => "OptiFine",
+        LoaderKind::LiteLoader => "LiteLoader",
+    }
+}
+
+/// 装不上的原因（**一条一个原因**，可以有多条同时成立）。
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub enum Blocker {
+    /// 整包类内容不走「单文件进目录」这条路（M111 才有导入管线）
+    NeedsPipeline,
+    /// 项目不支持目标实例的游戏版本
+    Version {
+        /// 项目支持的游戏版本（人读，最多取三个）
+        needs: String,
+        /// 目标实例的版本
+        actual: String,
+    },
+    /// 项目不支持目标实例的加载器
+    Loader {
+        /// 目标实例的加载器
+        loader: LoaderKind,
+    },
+    /// 没有目标实例
+    NoTarget,
+}
+
+impl Blocker {
+    /// 一句话原因（i18n）。
+    pub(super) fn reason(&self, catalog: Catalog) -> String {
+        match self {
+            Self::NeedsPipeline => catalog.text(Key::ContentModpackNotReady).to_string(),
+            Self::Version { needs, actual } => catalog.render(
+                Key::ContentIncompatibleVersion,
+                &[("version", needs), ("actual", actual)],
+            ),
+            Self::Loader { loader } => catalog.render(
+                Key::ContentIncompatibleLoader,
+                &[("loader", loader_name(*loader))],
+            ),
+            Self::NoTarget => catalog.text(Key::ContentNoInstances).to_string(),
+        }
+    }
+}

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",
+        "不能画「原版」"
+    );
+}