AskaEth
03741ecd2d
① update.auto_check / update.channel 登记进 core setting schema（1.6.0）
- 新增 setting/keys/update.rs（两键 + UPDATE_CHANNELS，只允许 stable）；
SettingSchema 加 with_all 供域键表批量登记。
- 新增 setting/update_prefs.rs：cache/update/prefs.json → launcher.json 的一次性迁移。
四条硬约束：源指纹闸门（幂等）、不丢 false、新值胜出、旧文件改名 .migrated 后不再被读；
主配置不可写时不动旧文件。收据 config/update-prefs-migration.json。
- presenter Runtime 建会话时迁一次并把结局留在 migration()；prefs 字段换成
auto_check + 每次派发从主配置读 channel（不再硬编码 Channel::Stable）。
保留旧字段 auto_check 的真实来源（原有测试 cases 会断言）。
- CLI config get/set/dump 先跑同一次迁移（幂等），输出里给 migration 段与收据路径。
② presenter/dto/events.rs 的「本次会话不再弹提示条」注释改成真实语义
（记的是版本号：同版本压住、更高版本照弹、手动检查清掉）。
③ 检查/下载进行中按钮禁用：pages/update/busy.rs 的 busy/can_check/can_apply；
设置页两颗按钮改画禁用（不是消失），app 层 on_update_action 再挡一道
（忙碌时 CheckNow/Apply 不派发）；新增两条用例（含「忙完恢回可点」）。
④ 内容库低高度：content_layout::MIN_BODY_HEIGHT=460 + BodyMode（按固定件+三整行算出来，
用例守着算式）；frame::body_height 从 Ui::metrics 算正文可用高，pages::Model 带 window_height。
≥460 列表自己滚；<460 主列整列一个滚动条、列表按自然高度铺开。
⑤ 启动错误文案本地化：presenter 删掉 launch_summary / 「启动失败：」前缀 / 五条中文阶段前缀，
改发 LaunchFailureView{stage,detail}；LaunchFinished 改带 exit_code/uptime_ms/failure，
Toast 由 app 层按 i18n key 现求（与 install_cancelled 同构）。InstancesFailed 拆成
InstancesFailedStage（列表单行）+ LaunchStageFailed（详情/Toast 全文）。
⑥ 导入结果块：ImportReportView 加 failure_stage（NotStarted/RolledBack/RollbackIncomplete，
由 core 的 rollback 机器位推出）；标题、图标、底色三处分档，预检失败不再说「已回滚」。
顺带：六处注释/文档漂移（update.rs 的分工表与偏好落点、pack 的「已整包回滚」、
build_request 的 Errors、settings/update 的按钮禁用说明等），
以及为守 400 行把 update/cli-config/core-keys/presenter-dto/presenter-launch/i18n-golden
里贴线或越线的文件按模块拆开（纯搬移，行为不变）。
392 lines
14 KiB
Rust
392 lines
14 KiB
Rust
//! 导入侧 DTO：请求、进度、三态、逐项原因、探测诊断。
|
||
//!
|
||
//! 三态（`Success` / `Partial` / `Failed`）与 core 一一对应，**`Partial` 不是 `Success`**；
|
||
//! 容忍域（[`MissingFileView`]）与致命域（[`ImportErrorView`]）分属不同类型，UI 不可能混成一个列表。
|
||
|
||
use std::path::PathBuf;
|
||
|
||
use serde::{Deserialize, Serialize};
|
||
|
||
use crate::dto::InstanceId;
|
||
|
||
use super::conflict::{ConflictDecisionsView, ConflictFileView, ImportScanView};
|
||
use super::format::PackFormatView;
|
||
|
||
/// 导入阶段（与 core 的 `ImportStage` 一一对应）。
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]
|
||
pub enum ImportStageView {
|
||
/// 读取清单（开包 + 安全四检 + 探测）。
|
||
Probe,
|
||
/// 解压 / 三方合并覆盖内容。
|
||
Extract,
|
||
/// 补全并下载远端文件。
|
||
Fetch,
|
||
/// 落地。
|
||
Commit,
|
||
/// 登记实例。
|
||
Register,
|
||
}
|
||
|
||
impl ImportStageView {
|
||
/// 五个阶段的声明顺序（= 进度条上的先后）。
|
||
pub const ALL: [ImportStageView; 5] = [
|
||
ImportStageView::Probe,
|
||
ImportStageView::Extract,
|
||
ImportStageView::Fetch,
|
||
ImportStageView::Commit,
|
||
ImportStageView::Register,
|
||
];
|
||
|
||
/// 稳定 slug。
|
||
#[must_use]
|
||
pub const fn slug(self) -> &'static str {
|
||
match self {
|
||
Self::Probe => "probe",
|
||
Self::Extract => "extract",
|
||
Self::Fetch => "fetch",
|
||
Self::Commit => "commit",
|
||
Self::Register => "register",
|
||
}
|
||
}
|
||
|
||
/// 从 core 的 id 反解。
|
||
#[must_use]
|
||
pub fn from_slug(slug: &str) -> Option<Self> {
|
||
Self::ALL.into_iter().find(|stage| stage.slug() == slug)
|
||
}
|
||
|
||
/// 这一阶段有没有「逐文件」的进度（`Probe` 只看清单，没条目可数）。
|
||
#[must_use]
|
||
pub const fn counts_files(self) -> bool {
|
||
!matches!(self, Self::Probe)
|
||
}
|
||
}
|
||
|
||
/// 致命失败的**阶段**（M161：`rolled_back` 一个人说不了两件事）。
|
||
///
|
||
/// core 的 `ImportReport::rolled_back` 语义是「目标目录已确认与导入前一致」——它同时覆盖
|
||
/// 「回滚完整完成」和「**从未写过**目标目录」两种情形（见 `core::addon::import::pipeline` 的
|
||
/// `record_rollback` / `abandoned`）。UI 拿一个 bool 判不出该说哪一句，于是预检失败也会被
|
||
/// 说成「已回滚」，而实际上一个字节都没写。这个枚举把两种情形重新分开，并补上第三种
|
||
/// （回滚有失败项，目标目录可能与导入前不同）。
|
||
///
|
||
/// 只在 `status == Failed` 时有值：成功/部分成功的报告没有「失败阶段」可言。
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub enum ImportFailureStageView {
|
||
/// 预检/装配阶段就失败了：**目标目录一个字节都没写**（用户该去修包/修配置再试）。
|
||
NotStarted,
|
||
/// 已经写过目标目录，回滚**完整**完成（零残留）。
|
||
RolledBack,
|
||
/// 写过了，但回滚有失败项：目标目录可能与导入前不同（`warnings` 里逐条列了）。
|
||
RollbackIncomplete,
|
||
}
|
||
|
||
impl ImportFailureStageView {
|
||
/// 稳定 slug（日志 / 测试用；**不要改名**）。
|
||
#[must_use]
|
||
pub const fn slug(self) -> &'static str {
|
||
match self {
|
||
Self::NotStarted => "not_started",
|
||
Self::RolledBack => "rolled_back",
|
||
Self::RollbackIncomplete => "rollback_incomplete",
|
||
}
|
||
}
|
||
|
||
/// 本次失败到底动没动目标目录。
|
||
#[must_use]
|
||
pub const fn touched_target(self) -> bool {
|
||
!matches!(self, Self::NotStarted)
|
||
}
|
||
}
|
||
|
||
/// 导入三态（`Partial` **不是** `Success`）。
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub enum ImportStatusView {
|
||
/// 全部落地、无冲突。
|
||
Success,
|
||
/// 有缺文件或有冲突（内容不完整，但实例可用）。
|
||
Partial,
|
||
/// 致命失败。
|
||
///
|
||
/// **「动没动过目标目录」不在这里**（M161）：同一个 `Failed` 既可能是预检没过（一个字节都没写），
|
||
/// 也可能是写完又回滚干净，还可能是回滚没做完——三种由
|
||
/// [`ImportReportView::failure_stage`] 分开说，界面按它选标题与图标。
|
||
Failed,
|
||
}
|
||
|
||
impl ImportStatusView {
|
||
/// 稳定 slug。
|
||
#[must_use]
|
||
pub const fn slug(self) -> &'static str {
|
||
match self {
|
||
Self::Success => "success",
|
||
Self::Partial => "partial",
|
||
Self::Failed => "failed",
|
||
}
|
||
}
|
||
|
||
/// 从 core 的 id 反解。
|
||
#[must_use]
|
||
pub fn from_slug(slug: &str) -> Option<Self> {
|
||
match slug {
|
||
"success" => Some(Self::Success),
|
||
"partial" => Some(Self::Partial),
|
||
"failed" => Some(Self::Failed),
|
||
_ => None,
|
||
}
|
||
}
|
||
|
||
/// 实例可用吗（`Success` / `Partial` 都是「装上了」）。
|
||
#[must_use]
|
||
pub const fn installed(self) -> bool {
|
||
!matches!(self, Self::Failed)
|
||
}
|
||
}
|
||
|
||
/// 一条落地文件本次被怎么处理。
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub enum FileActionView {
|
||
/// 新写入。
|
||
Installed,
|
||
/// 覆盖写入（用户没改过）。
|
||
Replaced,
|
||
/// 与包内一致，没动。
|
||
SkippedIdentical,
|
||
/// 用户改过 / 删过，按策略保留了用户那一侧。
|
||
KeptUser,
|
||
}
|
||
|
||
impl FileActionView {
|
||
/// 从 core 的 id 反解。
|
||
#[must_use]
|
||
pub fn from_slug(slug: &str) -> Option<Self> {
|
||
match slug {
|
||
"installed" => Some(Self::Installed),
|
||
"replaced" => Some(Self::Replaced),
|
||
"skipped_identical" => Some(Self::SkippedIdentical),
|
||
"kept_user" => Some(Self::KeptUser),
|
||
_ => None,
|
||
}
|
||
}
|
||
|
||
/// 是否真的写了盘。
|
||
#[must_use]
|
||
pub const fn wrote(self) -> bool {
|
||
matches!(self, Self::Installed | Self::Replaced)
|
||
}
|
||
}
|
||
|
||
/// 一次导入的请求。
|
||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub struct ImportRequestView {
|
||
/// 包路径：zip（`.zip` / `.mrpack`）或 MultiMC 实例目录。
|
||
pub pack: PathBuf,
|
||
/// 目标实例（`None` = 按包名新建一个）。
|
||
pub instance: Option<InstanceId>,
|
||
/// 新实例的展示名（`None` = 用包名）。
|
||
pub instance_name: Option<String>,
|
||
/// 冲突决策（**缺省 [`ConflictDecisionsView::KeepAll`]** = 用户已有文件一个都不动）。
|
||
///
|
||
/// 页面上：`KeepAll` 是缺省与「全部保留」，`OverwriteAll` 是「全部覆盖」，
|
||
/// `PerItem` 是逐项勾选的结果。只有用户**显式点过**之后才会出现后两者。
|
||
pub decisions: ConflictDecisionsView,
|
||
}
|
||
|
||
/// 一条导入进度。
|
||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub struct ImportProgressView {
|
||
/// 阶段。
|
||
pub stage: ImportStageView,
|
||
/// 阶段内已完成条目数。
|
||
pub done: u32,
|
||
/// 阶段内总条目数（`0` = 未知）。
|
||
pub total: u32,
|
||
/// 当前条目的实例内路径（阶段刚开始时为 `None`）。
|
||
pub current: Option<String>,
|
||
/// 包名（面板标题那一行）。
|
||
pub pack: String,
|
||
}
|
||
|
||
impl ImportProgressView {
|
||
/// 空进度（刚派发，后端还没回第一条）。
|
||
#[must_use]
|
||
pub fn new(pack: impl Into<String>) -> Self {
|
||
Self {
|
||
stage: ImportStageView::Probe,
|
||
done: 0,
|
||
total: 0,
|
||
current: None,
|
||
pack: pack.into(),
|
||
}
|
||
}
|
||
|
||
/// 计数已知吗（`false` = 不画确定态进度条，避免「静止的假进度」）。
|
||
#[must_use]
|
||
pub const fn is_known(&self) -> bool {
|
||
self.total > 0
|
||
}
|
||
|
||
/// 阶段内完成比例 0.0~1.0（未知时 `0.0`）。
|
||
#[must_use]
|
||
pub fn ratio(&self) -> f32 {
|
||
if self.total == 0 {
|
||
return 0.0;
|
||
}
|
||
(self.done as f32 / self.total as f32).clamp(0.0, 1.0)
|
||
}
|
||
}
|
||
|
||
/// 一条落地文件。
|
||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub struct ImportedFileView {
|
||
/// 实例内相对路径。
|
||
pub path: String,
|
||
/// 本次处置。
|
||
pub action: FileActionView,
|
||
/// 字节数。
|
||
pub bytes: u64,
|
||
}
|
||
|
||
/// 一个文件「搞不到」的成因（**容忍**域）。
|
||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub enum MissingReasonView {
|
||
/// 调用方没给 fetcher（离线导入）。
|
||
Offline,
|
||
/// 条目补不出下载地址（CF 缺 API 客户端 / `downloads` 为空）。
|
||
NoSource,
|
||
/// 尝试过但失败（404 / 网络）。
|
||
FetchFailed,
|
||
}
|
||
|
||
impl MissingReasonView {
|
||
/// 从 core 的 id 反解。
|
||
#[must_use]
|
||
pub fn from_slug(slug: &str) -> Option<Self> {
|
||
match slug {
|
||
"offline" => Some(Self::Offline),
|
||
"no_source" => Some(Self::NoSource),
|
||
"fetch_failed" => Some(Self::FetchFailed),
|
||
_ => None,
|
||
}
|
||
}
|
||
}
|
||
|
||
/// 一个「搞不到」的文件（容忍，但逐条列出）。
|
||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub struct MissingFileView {
|
||
/// 实例内路径（CF 补全失败时没有）。
|
||
pub path: Option<String>,
|
||
/// 人读标识（CF 条目是 `projectID:fileID`，其余是路径）。
|
||
pub display: String,
|
||
/// 为什么搞不到。
|
||
pub reason: MissingReasonView,
|
||
/// 细节（错误原文）。
|
||
pub detail: String,
|
||
}
|
||
|
||
/// 一次致命失败（是不是「已整包回滚」看 [`ImportReportView::failure_stage`]）。
|
||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub struct ImportErrorView {
|
||
/// 稳定码（`pack_traversal` / `import_integrity` …，进日志与 `--json`）。
|
||
pub code: String,
|
||
/// 人读大类名。
|
||
pub label: String,
|
||
/// 具体是什么。
|
||
pub message: String,
|
||
/// 补救建议（core 有就给）。
|
||
pub hint: Option<String>,
|
||
}
|
||
|
||
/// 一次导入的完整结果。
|
||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub struct ImportReportView {
|
||
/// 三态。
|
||
pub status: ImportStatusView,
|
||
/// 命中的格式（`None` = 探测都没过）。
|
||
pub format: Option<PackFormatView>,
|
||
/// 包名。
|
||
pub pack_name: Option<String>,
|
||
/// 包版本。
|
||
pub pack_version: Option<String>,
|
||
/// 游戏版本。
|
||
pub game_version: Option<String>,
|
||
/// 加载器（人读串，如 `fabric-loader 0.15.11`）。
|
||
pub loader: Option<String>,
|
||
/// 实例绑定的版本 id。
|
||
pub version_id: Option<String>,
|
||
/// 目标实例目录。
|
||
pub target: PathBuf,
|
||
/// 落地的文件。
|
||
pub files: Vec<ImportedFileView>,
|
||
/// 冲突清单。
|
||
pub conflicts: Vec<ConflictFileView>,
|
||
/// 缺文件清单（容忍）。
|
||
pub missing: Vec<MissingFileView>,
|
||
/// MultiMC 不支持的 component（逐项）。
|
||
pub rejected: Vec<String>,
|
||
/// 注记。
|
||
pub warnings: Vec<String>,
|
||
/// 致命错误（`status == Failed` 时必有）。
|
||
pub error: Option<ImportErrorView>,
|
||
/// 登记的实例名。
|
||
pub registered: Option<String>,
|
||
/// 本次写入的字节数。
|
||
pub bytes_written: u64,
|
||
/// 回滚是否完整（`false` = 目标目录可能与导入前不一致，逐条在 `warnings` 里）。
|
||
///
|
||
/// **注意**：`true` 有两种来源——「回滚完整完成」与「从未写过目标目录」（core 的
|
||
/// `abandoned`）。要区分它们看 [`ImportReportView::failure_stage`]；界面上的措辞
|
||
/// **必须**按那个字段选（M161）。
|
||
pub rolled_back: bool,
|
||
/// 失败发生在哪一步（`None` = 这次不是致命失败）。
|
||
pub failure_stage: Option<ImportFailureStageView>,
|
||
}
|
||
|
||
impl ImportReportView {
|
||
/// 真正写盘的文件条数。
|
||
#[must_use]
|
||
pub fn written(&self) -> usize {
|
||
self.files.iter().filter(|file| file.action.wrote()).count()
|
||
}
|
||
|
||
/// 要用户看一眼的东西条数（冲突 + 缺文件 + 被拒 component）。
|
||
#[must_use]
|
||
pub fn issue_count(&self) -> usize {
|
||
self.conflicts.len() + self.missing.len() + self.rejected.len()
|
||
}
|
||
}
|
||
|
||
/// 探测失败的**具名**诊断：「看起来像 X，但缺 Y」。
|
||
///
|
||
/// 为什么不由 core 给：core 的 `detect` 只回答「谁认领」，一个都不认领时只回一句
|
||
/// `pack_unsupported` + 试过哪些格式。而用户手里那个包往往**差一点点**就是某个已知格式
|
||
/// （CF 导出漏了 `manifest.json`、mrpack 被浏览器改名成 `.zip` 后解压丢了 index）。
|
||
/// 判断「像哪个」要看包内到底有哪些标记文件，这是宿主层拿着 `PackArchive` 才看得见的事。
|
||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||
pub struct ProbeView {
|
||
/// 最像哪个格式（`None` = 三个都不像）。
|
||
pub looks_like: Option<PackFormatView>,
|
||
/// 该格式**缺**的标记文件（逐条，按判据顺序）。
|
||
pub missing: Vec<String>,
|
||
/// 包里实际看到的标记（逐条）。
|
||
pub saw: Vec<String>,
|
||
/// 一句兜底说明（也是 core 的原文：试过哪些格式）。
|
||
pub detail: String,
|
||
}
|
||
|
||
/// 导入侧的宿主状态（`AppState::import` 的全部内容）。
|
||
#[derive(Debug, Clone, PartialEq, Default)]
|
||
pub struct ImportState {
|
||
/// 正在跑的进度（`None` = 没在跑）。
|
||
pub progress: Option<ImportProgressView>,
|
||
/// 用户点了取消（M113 r1）：**面板收回但后台还在跑**，所以这一位要留在界面上——
|
||
/// 否则用户会以为「没建成」，回头再导一次就撞「directory already exists」。
|
||
pub cancelled: bool,
|
||
/// 最近一次的预检（M160：冲突清单；`None` = 还没预检过或已被新结果顶掉）。
|
||
pub scan: Option<ImportScanView>,
|
||
/// 最近一次的结果（`None` = 还没导过）。
|
||
pub report: Option<ImportReportView>,
|
||
/// 探测失败的具名诊断（有它就让用户看清「像 X 缺 Y」，而不是一句「无法识别」）。
|
||
pub probe: Option<ProbeView>,
|
||
}
|