feat(app-iced): M101 r2 设置页状态漏斗 + pages/mod.rs 拆分 + r1 复审订正

r1 复审的 P1：消息漏斗只解决了「加一支消息」，一组要画真值仍要改 `settings/mod.rs` （`Group.body` 与 `view` 只认 `appearance::State`）。本 commit 补齐与消息漏斗同构的状态漏斗： - 新增 `pages/settings/state.rs`：`Groups`（一个组一个字段，字段类型在组自己文件里）+ `States`（按值传给渲染器的只读视图：外观状态 + 组状态）+ `demo_groups()`（harness 的 `'static` 默认状态）。 - `Group.body` 签名改成 `for<'a> fn(&'a Ui, States<'a>) -> Option<Element>`：每组自己从 `States` 取自己要的数据，「没有可画的状态」返回 `None` 由 `form` 退回演示行。 `appearance` 组照旧接 `pages/appearance/section.rs`（M93 路径行为不变）。 - `App.settings: pages::settings::Groups`（`app/state.rs` 字段列表末尾）+ `app/view.rs` 构造 `States` 走新入口 `pages::page_with_settings`。加/改某一组的字段只改那一组的文件。 - 四个组各自的 `State` 落在各自文件；`java::Message` 留一支只有测试构造的 `Ping`，配 `app/update/settings/tests.rs` 的 `a_group_message_reaches_its_handler_through_the_funnel` ——消息漏斗第一次有**运行时**证据。 r1 其余条目： - P2-1 删掉 `only_the_appearance_group_carries_a_real_control_body`（被四条 per-group 断言蕴含），并在同处写明删掉之后「唯一性」没人守；三份 section 文档从「改 3 个文件」订正为 2 个。 - P2-2 `pub mod settings` → `pub(crate) mod settings`（四个消息口模块 `pub(crate)`），并订正两处理由（lint 按类型自身可见性判，不是可达性）。 - P2-3 `pages/mod.rs` 397 行 → 拆出 `pages/message.rs` / `pages/screen.rs`（纯搬移，`pub use` 保证 `pages::Message` / `Action` / `Screen` 路径不变），并删掉 M101 自己那 18 行重复文档。 - P3-1 订正共享点清单（`Key` 由宏从域文件累积生成，加 key 不改 `catalog.rs`）。 - P3-2 守门改成「除已知臂外任何含 `=>` 的行都算兜底」（`other =>` 也拦），并加「恰好四臂」断言。 - P3-3 `ai.rs` → `ai_about.rs` 单独一条 R100 改名提交，`git log --follow` 不断链。 - P3-4 `message.rs` 的「加一支消息改 1 个文件」订正为 2 个。
2026-11-03 20:57:08 +08:00
1 parent 423ea77758
commit 029ece3f17
@@ -0,0 +1,94 @@
+//! 页面消息与动作表（M101 r2 从 `pages/mod.rs` **原样搬出**）。
+//!
+//! 为什么拆：合并 M100/M101 之后 `pages/mod.rs` 是 397 行，只剩 3 行余量，下一条线往枚举里加
+//! 一个变体（含文档）就顶破 400 硬线。拆法与 M99 的 `pages/nav.rs` 同一种范式：**纯搬移**、
+//! 一行不改、路径靠 `pages/mod.rs` 的 `pub use` 再导出保持不变（`pages::Message` / `pages::Action`）。
+//!
+//! `pages::Message` 是页面层的自有消息类型（**不** import `crate::app::Message`，组件契约 §2 的
+//! 同一条纪律）；app 层只做一次 `.map`。
+
+use unlucky_presenter::router::Route;
+
+use super::appearance;
+use super::download::Category;
+use super::settings;
+
+/// 页面消息。
+///
+/// **故意不用 `crate::app::Message`**（组件库契约 §2 的同一条理由）：页面不绑 app 的状态层，
+/// 接线时由 app 层把这里的三类意图翻成 presenter 的 `AppCommand` / `Route`。
+#[derive(Debug, Clone)]
+pub enum Message {
+    /// 骨架期动作（三页的占位按钮 + 实例页上还没接后端的两个页头动作）。
+    Action(Action),
+    /// 路由跳转：导航轨、列表行、窄窗「返回」都走这一条（栈语义归 `presenter::router`）。
+    Navigate(Route),
+    /// 启动某实例（app 层翻成 `AppCommand::LaunchInstance`）。
+    Launch(String),
+    /// 停止某实例（app 层翻成 `AppCommand::StopInstance`）。
+    Stop(String),
+    /// 外观项改动（设置页「外观」分组 → `App` 的状态与落盘）。
+    ///
+    /// 载荷是**用户请求值**（未钳位）：钳位与 CPU 档降级在 `appearance::alpha` 里做，
+    /// 页面只表达意图（与组件库「不持有业务状态」同一条纪律）。
+    Appearance(appearance::Change),
+    /// 选中下载页的一个版本（M94）：**页面内选中**，app 层只改视图模型，不 dispatch。
+    SelectVersion(String),
+    /// 安装指定版本（M94；app 层翻成 `AppCommand::InstallVersion`）。
+    InstallVersion(String),
+    /// 取消正在跑的安装（M94；`AppCommand::CancelInstall`）。
+    CancelInstall,
+    /// 切换下载页分类（M94；app 层翻成 `AppCommand::ListVersions`，`All` 只画现有快照）。
+    SetCategory(Category),
+    /// 把现成文本塞进剪贴板（**M95**：诊断卡片的一行摘要，文本由页面造，app 只搬）。
+    CopySummary(String),
+    /// 设置页的一组消息（**M101 `SETTINGSMSG`**）：设置页的**唯一**投递口。
+    ///
+    /// 四条填页线（java / download / language+appearance / ai+about）各自在自己的文件里定义
+    /// 消息枚举，本枚举**不再**为设置页增加第二个变体——「加一支设置页消息」从此不碰本文件，
+    /// 也不碰 `app/update/page_messages.rs` 那条不许 `_ =>` 的 match。加变体与落点见
+    /// `pages/settings/message.rs`（`app/update/settings.rs` 对它做穷尽分发，漏接线报 E0004）。
+    Settings(settings::GroupMessage),
+}
+
+/// 页面动作清单（骨架期够用就行；接线时按业务语义重命名/扩充）。
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum Action {
+    /// 新建实例（**还没有后端**，见模块文档偏离 #8）。
+    NewInstance,
+    /// 导入（同上）。
+    Import,
+    /// 返回实例列表（窄窗整页切换）。**已由 `Message::Navigate(Route::Instances)` 取代**，
+    /// 这里保留枚举项是为了别把「返回」这件意图从动作表里抹掉（外壳回退路径仍可能用到）。
+    Back,
+    /// 启动（占位动作表里的「启动」；真启动走 `Message::Launch`）。
+    Play,
+    /// 更多。
+    More,
+    /// 复制实例。
+    Duplicate,
+    /// 打开实例目录。
+    OpenFolder,
+    /// 删除实例。
+    Delete,
+    /// 重新探测下载源。
+    RefreshSources,
+    /// 浏览版本列表。
+    BrowseVersions,
+    /// 导入整合包。
+    ImportModpack,
+    /// 检查下载源。
+    CheckSources,
+    /// 打开日志目录。
+    OpenLogs,
+    /// 复制诊断信息。
+    CopyDiagnostics,
+    /// 清空日志。
+    ClearLogs,
+    /// 重置当前设置分组。
+    ResetSection,
+    /// 保存设置。
+    SaveSettings,
+    /// 新增逐实例覆盖。
+    AddOverride,
+}