AskaEth
89dcb6bdf3
用户原话：「我系统语言是中文 为什么打开软件是英文 并且设置页里面显示的是 English(system)」。
两处根源：①M92 的探测链一直是对的，但 `pages::Model.lang` 在 `app/view.rs` 里写死成
`Lang::En`（`pages::render` 还把下载页写死成英文），探测结果没人用；②设置页语言行是硬编码
字面量 `("Language", "English (System)")`。
新增/改动（按层）：
- i18n：新域 `catalog/general.rs`（24 条中英双份 key，装配链尾追加）+ `catalog/golden.rs`
只追加不重排；`choice.rs`（`LangChoice`：跟随系统/手选 + D28 四级优先级真值表 + 字体优先级真值表）。
- app-iced 语言入口 `src/ui.rs` + `src/ui/lang.rs`：`LangState` = 用户档位 + 探测结论；
启动判定 `ULL_LANG` > 配置 `ui.language` > 系统 locale > 英文；两行日志（探测/生效 + 中文策略）。
- `app/state.rs`：`App` 持有 `LangState`，切语言 = 换目录 + 落盘 + 重建视图模型；
`app/view.rs` 的 `model()` 收 `lang`，不再写死英文。
- 设置页：语言行换真控件（跟随系统 / 简体中文 / 英文，回显「界面当前使用：简体中文」）；
页头、左列分组名、逐实例空态、导航轨标签全部走 catalog。
- presenter：`settings_bridge_lang.rs`（`load_ui_language` / `persist_ui_language`）。
「跟随系统」= **删键**（schema 允许值只有 zh_cn/en_us），读的是 `doc().get()` 而不是
`effective_str`（后者会把默认值 `zh_cn` 当成用户手选，英文机器一启动就被切成中文）。
验证：408 条 app-iced lib 测试 + 28 条 i18n 测试 + 全仓 `cargo test --workspace --exclude
unlucky-app` 全绿；fmt / clippy `-D warnings` 干净；出图 6 张（en/zh × 浅/深 + 下载页对照）
在 `DevDocs/artifacts/m106/`（该目录被 .gitignore 忽略，按仓内惯例作为本地验收产物）。
121 lines
7.4 KiB
Rust
121 lines
7.4 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`、`loader_label`
|
||
// 等）。它们原本住在 `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;
|