AskaEth
321617861a
M134 复审点名、且都在它 scope 外的收尾。 - `presenter/src/host/launch.rs::loader_label` 删除：全仓零调用点（唯一提及是 i18n 的一条注释），函数体逐字重复 `dto::LoaderKind::label()` 并硬编码「原版」—— 它既是第二份显示词表，又绕过 i18n；留着等于给下一个人示范「照这样写就行」。 随之无用的 `LoaderKind` import 一并收掉。 - `presenter/src/lib.rs` 的 dead_code 豁免说明不再点名已删函数（否则那行注释指向 一个不存在的符号）。 - `i18n/src/bridge.rs:65` 注释改指向唯一那份显示词表（`dto::LoaderKind::label()`）。 - `core/src/game/loader.rs` 与 `presenter/src/dto/instances.rs` 两处「显示路径 没有守卫（已知缺口）」改成 M134 之后的真形态：显示路径是委派（拿 core 的稳定 id 反查 DTO 词表，没有手写 match 可糊），新种类先在 `dto::LoaderKind::from_core` 编 不过，糊错的后果由 `loader_kind_ids_are_the_released_contract` 与按 `ALL` 遍历的 `every_core_loader_kind_reaches_the_tile_as_itself` 钉住。 - `presenter/src/host/game.rs` 无需改动：M134 当时已把它的文档改成新形态，读下来是 真话（`dto_kind` 的 doc 与两个测试的 doc 都对得上现在的代码）。 验证：fmt --all --check 通过；`cargo test -p unlucky-presenter -p unlucky-i18n` = i18n 29 passed / presenter 220 passed（1 ignored）；clippy 两 crate --all-targets `-D warnings` 零告警。删后全仓（含 workspace 外的 crates/app）已无 `launch::loader_label` 引用。
121 lines
7.3 KiB
Rust
121 lines
7.3 KiB
Rust
//! Unlucky-Launcher 的 **UI 框架无关宿主层**（presenter）。
|
||
//!
|
||
//! # 1. 这层为什么存在
|
||
//!
|
||
//! D26 的技术路线是「用 iced 重写 UI」。重写只应该换掉**渲染**，不该重写业务装配——
|
||
//! 本 crate 就是被两个 UI 版共用的那一半：Slint 版（`crates/app`）与 iced 版
|
||
//! （`crates/app-iced`）都从这里取 DTO、状态 reducer 与 host。Slint 退役后只剩 iced
|
||
//! 依赖它，本 crate 不受影响。
|
||
//!
|
||
//! 判据（M85 已核）：这套代码原本住在 `crates/app/src`，但 `host/`（25 个文件）、
|
||
//! `state.rs`、`settings_bridge.rs`、`dto/` 里**没有一处** UI 框架符号；它们依赖的只有
|
||
//! 标准库、serde 与 `unlucky-core`。把它们留在 UI crate 里等于让 iced 重写跟着重写一遍
|
||
//! 约 5400 行，白担行为漂移的风险。
|
||
//!
|
||
//! # 2. 对外表面（UI 侧的唯一入口）
|
||
//!
|
||
//! ```text
|
||
//! host::CoreHost ──impl Backend──► dto::AppEvent ──► state::AppState::apply ──► dto 快照
|
||
//! ▲ │
|
||
//! └──────────── dto::AppCommand ◄────────────────┘
|
||
//! ```
|
||
//!
|
||
//! | 模块 | 入口 | UI 侧怎么用 |
|
||
//! | ---- | ---- | ----------- |
|
||
//! | [`dto`] | [`dto::Backend`] / [`dto::AppCommand`] / [`dto::AppEvent`] / 各 `*View` 快照 | 派发指令、消费事件、把快照字段映射成视图模型 |
|
||
//! | [`host`] | [`host::CoreHost`]（实现 [`dto::Backend`]）、[`host::HostEnv`] | 进程启动时构造一次，之后只当 `Box<dyn Backend>` 用 |
|
||
//! | [`state`] | [`state::AppState`]（`apply` / `navigate` / 各页面字段） | **唯一**状态入口：事件进来先 `apply`，再从字段取值画 |
|
||
//! | [`agent`] | `Presenter`（`agent_rail` / `agent_submit` / `agent_mark_read` / `agent_confirm`）、`AgentRail` | AI 助手的唯一状态入口：读 rail 画、把点击翻成这四个方法 |
|
||
//! | [`prefs`] | `UiPrefs` / `ThemeMode` / `TileSize` / `AppearancePrefs` / `keys` | 读字段做展示；不自己写盘 |
|
||
//! | [`settings_bridge`] | `SettingsBridge`（`open` / `load` / `persist` / `reload_if_changed`） | 启动读一次、变更时写回、每拍问一次「变了吗」 |
|
||
//! | [`theme`] | `CONFIG_POLL_TICKS` / `BACKGROUND_KEY` 一类纯判据、`tile_viewport` / `system_theme_value` | 「这一拍该不该重读/重建」由它回答，UI 只执行 |
|
||
//! | [`router`] | `Route` / `Router` / `AiPanelMode` | 导航状态 |
|
||
//! | [`dialogs`] | `DialogQueue` / `DialogRequest` | 模态队列 |
|
||
//! | [`toast`] | `ToastCenter` / `Toast` | 非阻塞提示 |
|
||
//! | [`wizard`] | `WizardState` | 新建实例向导的纯状态机 |
|
||
//! | [`mock`] / [`mock_data`] | `MockBackend` / 样例数据 | 无数据根时的演示后端、UI 回归 |
|
||
//! | [`backend`] | `AppOptions` / `build_backend` / `config_path` | 启动时选真实 host 还是 mock |
|
||
//!
|
||
//! # 3. UI 侧允许做什么、禁止做什么
|
||
//!
|
||
//! 允许（**只做展示与转发**）：
|
||
//!
|
||
//! - 把本 crate 的值翻译成框架类型（视图模型、颜色、图标、字符串）并灌进属性/`Element`；
|
||
//! - 回调里把用户动作翻成 [`dto::AppCommand`] 交给 [`dto::Backend::dispatch`]，再 `drain_events()` 喂
|
||
//! [`state::AppState::apply`]——**不要**在本地做乐观回显（会话气泡/磁贴状态都以事件为准）；
|
||
//! - 框架能力：窗口、定时器/订阅、图片解码与模糊层、截图落盘、字体加载。
|
||
//!
|
||
//! 禁止：
|
||
//!
|
||
//! - 在本 crate 里出现 Slint / iced / winit 类型（守门命令见 `crates/app/Cargo.toml` 的注释：
|
||
//! 自指问题让那条命令不能写在本 crate 里，否则它自己就被抓出来了）；
|
||
//! - UI 侧绕过 [`state::AppState::apply`] 直接改状态字段（会与事件流打架，磁贴/日志会漂）；
|
||
//! - UI 侧直接 `use unlucky_core::…` 组装业务（读盘、起进程、拼路径、写设置一律走 host/bridge）；
|
||
//! - UI 侧自己造 `<data root>` 路径：路径只从 [`host::HostEnv`] / [`settings_bridge`] 拿。
|
||
//!
|
||
//! # 4. iced 接线的推荐用法（骨架，伪代码）
|
||
//!
|
||
//! ```ignore
|
||
//! // 1) 启动：选后端（数据根解析不出来自动退回 mock）
|
||
//! let backend: Box<dyn Backend> = build_backend(&AppOptions::default());
|
||
//! let bridge = SettingsBridge::open(); // 读盘一次，主题/外观看这里
|
||
//! let state = AppState::new();
|
||
//!
|
||
//! // 2) 订阅：iced 的 30fps 订阅里推进一拍
|
||
//! fn subscription() -> Subscription<Message> { iced::time::every(TICK).map(|_| Message::Tick) }
|
||
//! fn update(&mut self, Message::Tick) {
|
||
//! backend.tick(TICK); // 后台线程的消息在这里汇聚
|
||
//! for event in backend.drain_events() { self.state.apply(event); } // 唯一的写状态入口
|
||
//! if config_poll_due(self.ticks) { // presenter 的纯判据
|
||
//! if let Some((appearance, theme)) = self.bridge.reload_if_changed() { … }
|
||
//! }
|
||
//! self.view = ViewModel::from(&self.state); // 展示转换在 iced 侧做
|
||
//! }
|
||
//!
|
||
//! // 3) 回调：用户动作 → AppCommand → 事件回流（不本地回显）
|
||
//! fn update(&mut self, Message::Launch(id)) { self.dispatch(AppCommand::Launch(id)); }
|
||
//! ```
|
||
//!
|
||
//! 要点：`state` / `bridge` / `backend` 三件由 UI 侧持有并驱动，`presenter` 不持有定时器也不
|
||
//! 知道帧率；事件顺序以 `drain_events()` 的顺序为准（host 侧保证配对：`Install` 之后必有
|
||
//! `InstallDone`、`LaunchStarted` 之后必有 `LaunchEnd`）。
|
||
//!
|
||
//! # 5. 留在 `crates/app`（Slint 侧）的东西，以及为什么
|
||
//!
|
||
//! | 留在 app | 为什么不能进 presenter |
|
||
//! | -------- | ---------------------- |
|
||
//! | `conv/` | 把 DTO 转成 **Slint 结构体**（UI 侧生成的视图模型类型），是 Slint 专属转换层 |
|
||
//! | `ui_bind.rs` / `page_sync.rs` / `callbacks*.rs` | 持有 `MainWindow`、`ModelRc`、回调闭包，全是框架绑定 |
|
||
//! | `theme_runtime.rs` / `appearance_bind.rs` | `impl Inner` 的方法，读写窗口属性与图片属性；其中的**纯判据**已抽到 [`theme`] |
|
||
//! | `bg_image.rs` / `png.rs` | 解码/模糊/编码产出框架图片类型与像素缓冲，属渲染侧 |
|
||
//! | `screenshot.rs` | Slint 快照通道（`Window::take_snapshot`） |
|
||
//! | `main.rs` | `include_modules!()` 与窗口拉起 |
|
||
//!
|
||
//! # 6. 零 UI 依赖的证据命令
|
||
//!
|
||
//! 两条命令（`grep` 与 `cargo tree`）的原文与实测输出见 `crates/app/Cargo.toml` 的注释与 M85
|
||
//! 的完成报告：本 crate 的依赖树里只有 serde / serde_json / unlucky-core（及其自身依赖）。
|
||
|
||
// 关于 dead_code：host 里有一批「已定义、由单测覆盖、等 iced 页面接线才调用」的辅助函数
|
||
// （`host::logs::session_finished`、`host::settings::clear_vendor_priority`
|
||
// 等）。它们原本住在 `crates/app` 里，由那边的 crate 级 `#![allow(dead_code)]` 一并放开；
|
||
// 搬进 lib 之后「pub 但模块私有」会被判成死码。逐条 `#[allow]` 会把噪音藏进实现细节，
|
||
// 这里沿用同一条策略统一放开，接线完成后再删掉本行暴露真死码。
|
||
#![allow(dead_code)]
|
||
|
||
pub mod agent;
|
||
pub mod backend;
|
||
pub mod dialogs;
|
||
pub mod dto;
|
||
pub mod host;
|
||
pub mod mock;
|
||
pub mod mock_data;
|
||
pub mod prefs;
|
||
pub mod router;
|
||
pub mod settings_bridge;
|
||
mod settings_bridge_lang;
|
||
pub mod state;
|
||
pub mod theme;
|
||
pub mod toast;
|
||
pub mod wizard;
|