feat(m159): 自更新 GUI 客户端接线 + CLI update check/apply 同一内核

D50 的「检查 → 提示 → 可拒绝 → 下载校验 → 下一次启动生效」整环接线，GUI 与 CLI 共用 core 的一条内核（`update::Job`），并顺带修掉 M157 最后一轮复审的三处 P3。内核（core::update） - 新增 job.rs：`Job { source, target, staging, dest }` + `check` / `apply`（复查 → 取包 → 长度/SHA256 双检 → 原子替换），`default_source`（GitHub，`ULL_UPDATE_DIR` 可切本地目录夹具）、`process_dest`、`staging_dir`。 - `mod.rs` 导出 job 一族；`source.rs` 为 `Box<dyn UpdateSource>` 补 trait 转发（壳层要运行期选源，`UpdateChecker` 是泛型的）。 presenter（宿主通道） - `dto/update.rs`：`UpdateView` / `UpdateOutcome`（Idle/Checking/UpToDate/Available/ MissingArtifact/Failed 六态，**失败与最新不折叠**）/ `UpdateBanner` 优先级判据。 - `host/update.rs`：Factory（生产 GitHub / 单测本地目录）+ core 结论 → DTO 的唯一映射 + 更新域偏好（`cache/update/prefs.json`）。 - `host/update_state.rs`：Runtime（会话状态机：begin_check/adopt/begin_apply/dismiss/ set_auto_check）+ `CoreHost` 派发与后台线程。 - `AppCommand::{CheckUpdate, ApplyUpdate, DismissUpdate, SetUpdateAutoCheck}`、 `CoreEvent::Update`、`AppState.update`；`refresh_all` 按开关派发静默检查。 app-iced - 设置页新增第 5 组「更新」（当前版本 / 渠道 / 自动检查开关 / 立即检查 / 上次检查与结果 / 下载并安装 / 就位后立即重启），走 `settings::view` 的 `update` 形参 + 按下标分发（与 M106 语言行同一取舍）。 - 顶部提示条（每页可见）：有新版本（版本号 + 体积 + 说明摘要，可安装/可忽略）、下载中、已就位（立即重启）；静默检查失败**不**弹条（原因进设置页）。 - `pages::Message::Update(UpdateAction)` → `app/update/update_action.rs`；「立即重启」拉同参数的新进程后退出（截图通道不重启）。 CLI - `ull update check` / `ull update apply [--dest <path>]`：复用同一 `Job`；四种结论分开报（`--json` 的 `status`），失败退出码 1（`update_check_failed` / `update_apply_failed`）。 i18n - 新增 `catalog/update.rs`（30 条，链尾追加）+ 金表对应 30 行。 M157 复审 P3 三件 - `app/update/instances.rs` 模块文档改成「清脏的唯一时机是回程快照等于表单」。 - `pages/instances/demo.rs` 的 `demo_form` 注释改成现状（两个参数框早已是单行输入）。 - `pages/instances/launch_args.rs`：门限不满足时只灰 `opengl`/`vulkan`，`default` 仍可点（它是「不下发」的安全档）；判据抽成 `backend_chip_enabled` 并补 3 条用例。浅色 + 灰化两张图：`C:/Temp/m159-shots/instances-launch-args-{light,gated}.png`。顺带：harness 支持 `ULL_SETTINGS_GROUP=<下标>`（拍第 5 组的验收图需要它）。验证：cargo fmt --check 绿；cargo clippy --workspace --all-targets -D warnings 绿； cargo test --workspace --all-targets 51 个测试二进制全绿（唯一例外：core::addon::pack 一族要造 4 GiB 稀疏文件，本机磁盘 99% 满 ⇒ StorageFull，与本次改动无关）；CLI 用本地目录夹具跑通「发现 9.9.9 → 下载 → 校验 → 替换运行中的 exe → 备份留旧文件」，并验证摘要不符时拒绝应用、目标文件零改动、暂存目录零残留。
2026-11-07 12:09:42 +08:00
1 parent a80362915a
commit 1c8f6aa1b3
@@ -0,0 +1,226 @@
+//! 更新状态的**会话层**：一份 `UpdateView`、更新域偏好、以及把 `CoreHost` 接上后台线程。
+//!
+//! 与 [`super::update`] 的分工：那边是「一次检查/应用的纯做法」（选源、调 core、映射 DTO），
+//! 这边是「谁来记着它、谁来派发」。拆开是因为两边都各有一批判据要写清（静默检查的开关、
+//! 拒绝后不再打扰、应用失败不许丢掉候选），塞在一个文件里会越过 400 行硬线。
+
+use std::path::PathBuf;
+
+use unlucky_core::update::Version;
+
+use crate::dto::{CoreEvent, ReadyUpdate, UpdateOutcome, UpdateView};
+
+use super::env::HostEnv;
+use super::update::{current_version, outcome_of, ApplyReport, Factory, Prefs, Report, CHANNEL};
+use super::CoreHost;
+
+/// 会话级更新状态（提示条 / 设置页共用一份）。
+#[derive(Debug)]
+pub struct Runtime {
+    view: UpdateView,
+    prefs: Prefs,
+    factory: Factory,
+    prefs_path: PathBuf,
+    /// 有一条检查/应用正在后台跑（防重复派发；进程内独占）。
+    inflight: bool,
+}
+
+impl Runtime {
+    /// 按数据根装配。
+    #[must_use]
+    pub fn for_env(env: &HostEnv) -> Self {
+        Self::with_factory(env, Factory::for_env(env))
+    }
+
+    /// 用给定装配（单测：临时目录 + 本地目录源）。
+    #[must_use]
+    pub fn with_factory(env: &HostEnv, factory: Factory) -> Self {
+        let prefs_path = env.layout.cache().join("update").join("prefs.json");
+        let prefs = Prefs::load(&prefs_path);
+        Self {
+            view: UpdateView::new(current_version(), CHANNEL.as_str(), prefs.auto_check),
+            prefs,
+            factory,
+            prefs_path,
+            inflight: false,
+        }
+    }
+
+    /// 当前快照。
+    #[must_use]
+    pub fn view(&self) -> &UpdateView {
+        &self.view
+    }
+
+    /// 当前快照（克隆给事件/线程）。
+    #[must_use]
+    pub fn snapshot(&self) -> UpdateView {
+        self.view.clone()
+    }
+
+    /// 偏好。
+    #[must_use]
+    pub const fn prefs(&self) -> Prefs {
+        self.prefs
+    }
+
+    /// 后台有没有一条在跑。
+    #[must_use]
+    pub const fn inflight(&self) -> bool {
+        self.inflight
+    }
+
+    /// 本进程版本解析（失败时 `None`：版本号是编译进来的常量，理论上不可能失败）。
+    #[must_use]
+    pub fn current(&self) -> Option<Version> {
+        Version::parse(current_version()).ok()
+    }
+
+    /// 启动时要不要静默检查（开关关掉 ⇒ 启动**一次网络都不发**）。
+    #[must_use]
+    pub fn should_check_on_start(&self) -> bool {
+        self.prefs.auto_check && !self.inflight
+    }
+
+    /// 开关「启动时静默检查」并落盘。
+    ///
+    /// # Errors
+    ///
+    /// 落盘失败返回人读文案（本会话的取值仍然生效——不因为写不进去就把开关弹回去）。
+    pub fn set_auto_check(&mut self, on: bool) -> Result<(), String> {
+        self.prefs.auto_check = on;
+        self.view.auto_check = on;
+        self.prefs.save(&self.prefs_path)
+    }
+
+    /// 开始一次检查：置「正在查」并返回要交给后台线程的 [`unlucky_core::update::Job`]
+    /// （`None` = 已经有一条在跑）。
+    ///
+    /// `manual` = 用户点的「立即检查」：会清掉「忽略这个版本」，并让失败也弹提示条。
+    pub fn begin_check(&mut self, manual: bool) -> Option<unlucky_core::update::Job> {
+        if self.inflight {
+            return None;
+        }
+        self.inflight = true;
+        self.view.outcome = UpdateOutcome::Checking;
+        self.view.silent = !manual;
+        self.view.applying = false;
+        if manual {
+            self.view.dismissed = false;
+        }
+        Some(self.factory.job())
+    }
+
+    /// 开始应用：`None` = 没有在跑的必要（正在忙 / 没有候选 / 已经就位）。
+    pub fn begin_apply(&mut self) -> Option<unlucky_core::update::Job> {
+        if self.inflight || self.view.ready.is_some() || self.view.outcome.candidate().is_none() {
+            return None;
+        }
+        self.inflight = true;
+        self.view.applying = true;
+        Some(self.factory.job())
+    }
+
+    /// 后台回报进快照（**唯一**的写入口：检查与应用都走这里）。
+    pub fn adopt(&mut self, report: Report) {
+        self.inflight = false;
+        self.view.checked_at = super::update::stamp();
+        match report {
+            Report::Checked(outcome) => {
+                self.view.outcome = outcome;
+                // 只有**用户主动查**才清掉「忽略这个版本」；静默检查（启动时/自动）一律不许把
+                // 用户的拒绝弹回来（mission：拒绝之后本次不再打扰）。手动那一路在
+                // `begin_check` 里就已经清过了，这里的条件只是让「谁清」这件事只有一条判据。
+                if !self.view.silent && self.view.outcome.candidate().is_some() {
+                    self.view.dismissed = false;
+                }
+            }
+            Report::Applied(ApplyReport::Installed {
+                version,
+                path,
+                backup,
+            }) => {
+                self.view.applying = false;
+                self.view.outcome = UpdateOutcome::UpToDate {
+                    latest: Some(version.clone()),
+                };
+                self.view.ready = Some(ReadyUpdate {
+                    version,
+                    path,
+                    backup,
+                });
+            }
+            Report::Applied(ApplyReport::Nothing(outcome)) => {
+                self.view.applying = false;
+                self.view.outcome = outcome;
+            }
+            Report::Applied(ApplyReport::Failed(failure)) => {
+                // 应用失败要说清是哪一步（校验不符 / 替换被占用）。候选随 `outcome` 一起换成
+                // `Failed`，**重试走「立即检查」重新复查**（清单只有几 KB，apply 本来也要复查一次）：
+                // 这样重试拿到的永远是最新那一份，而不是几分钟前的旧候选。失败也不再算「静默」，
+                // 提示条要把原因摆出来。
+                self.view.applying = false;
+                self.view.outcome = UpdateOutcome::Failed(failure);
+                self.view.silent = false;
+            }
+        }
+    }
+
+    /// 用户拒绝这次更新：本次会话不再弹提示条（候选仍在快照里，设置页可手动装）。
+    pub fn dismiss(&mut self) {
+        self.view.dismissed = true;
+    }
+}
+
+impl CoreHost {
+    /// 发布更新快照（唯一的出口；`CoreEvent::Update` 是整份替换）。
+    pub(super) fn publish_update(&mut self) {
+        let view = self.update.snapshot();
+        self.send(CoreEvent::Update(Box::new(view)));
+    }
+
+    /// 派一次检查（`manual` = 设置页点的「立即检查」；`false` = 启动时的静默检查）。
+    pub(super) fn start_update_check(&mut self, manual: bool) {
+        let Some(current) = self.update.current() else {
+            return;
+        };
+        let Some(job) = self.update.begin_check(manual) else {
+            return;
+        };
+        // 先把「正在查」发出去：设置页的按钮据此转圈，而不是看起来没反应。
+        self.publish_update();
+        spawn_check(job, current, self.tx.clone());
+    }
+
+    /// 应用更新（下载 → 长度/SHA256 双检 → 替换；全部在后台线程）。
+    pub(super) fn start_update_apply(&mut self) {
+        let Some(current) = self.update.current() else {
+            return;
+        };
+        let Some(job) = self.update.begin_apply() else {
+            return;
+        };
+        self.publish_update();
+        spawn_apply(job, current, self.tx.clone());
+    }
+}
+
+/// 起一条检查线程（结果经 [`super::HostTask::Update`] 回来）。
+pub fn spawn_check(job: unlucky_core::update::Job, current: Version, tx: super::JobSender) {
+    super::job::spawn("update-check", move || {
+        let report = Report::Checked(outcome_of(job.check(&current, CHANNEL)));
+        let _ = tx.send(super::HostTask::Update(Box::new(report)));
+    });
+}
+
+/// 起一条应用线程（下载 + 双检 + 替换都在里面）。
+pub fn spawn_apply(job: unlucky_core::update::Job, current: Version, tx: super::JobSender) {
+    super::job::spawn("update-apply", move || {
+        let report = Report::applied(job.apply(&current, CHANNEL));
+        let _ = tx.send(super::HostTask::Update(Box::new(report)));
+    });
+}
+
+#[cfg(test)]
+#[path = "update_tests.rs"]
+mod tests;