fix(m195): 复审 r2 —— 取消的真实结局必须到达界面(三档 + 终态穿透代次)

复审 r2 P2-1:界面无条件断言「已停手并回滚:没有留下半包,也没有覆盖已有文件」,而两条路径下
这句话是假的——①取消来得太晚(落在最后一个检查点之后)时管线已经跑完,用户的同名文件被覆盖、
实例已登记;②回滚本身没做完(`rolled_back=false`)。core 一直是诚实的,是 presenter 把报告丢了:
`cancel.load()` 早退 + `cancel_pack` bump 代次后 `handle` 按代次丢弃。

按"接通真相"做(不是改软话):

- **终态一定发出**:`import::run` 去掉 `cancel` 的无条件早退,收尾抽成 `finish`(清自建空目录 +
  无条件 `send(PackEvent::Report)`);取消标记在管线返回后**再读一次**,作为"太晚"的唯一证据。
- **终态穿透代次**:`HostPackState::terminal_epochs` 记下 `cancel_pack` 作废的那个代次,
  `handle` 对它**只放行一条 `PackEvent::Report`**(进度事件照旧按代次丢,`fresh_cancel` 起新
  一轮时清空)。这是路径 A 的成因与修法。
- **DTO 三档**(tower 批准扩 scope):`ImportStatusView` 加 `Cancelled`;新增
  `ImportCancelView { NotRequested, RolledBack, RollbackIncomplete, TooLate }` 挂在
  `ImportReportView::cancel` 上——已回滚 / 回滚没做完 / 取消太晚,三档各自可判。
  `PackEvent::Report` 到达时清掉 `ImportState.cancelled`(它现在只是"取消后还没有结果"的占位)。
- **界面按结局分支**:标题 `PackStatusCancelled`(已取消 — 已回滚)/ `PackCancelIncomplete`
  (已取消 — 回滚没做完)/ 取消太晚时保留真实状态标题并另起一句 `PackCancelTooLate`
  (实例会保留、同名文件可能已被覆盖);占位的 `PackCancelled` 改成"正在停手,真实结果随后给出"。
  图标:`Close`(描边,页面对填充字形有守门)/ 回滚不完整用 `Warn`,一档都不用 `Role::Error`。

守门与变异:
- 新增路径 A 用例 `a_late_cancel_still_delivers_the_real_outcome_to_the_ui`:真管线把取消置在
  **最后一条 Commit 进度**上(之后没有检查点)⇒ core 报 `Success`/未回滚、用户的 `mods/a.jar`
  确实被覆盖;再 `cancel_pack`(代次 +1 并记终态)→ `finish` → `handle`,断言界面收到
  `status == Success` + `rolled_back == false` + `cancel == TooLate`,且同代次的进度事件仍被丢。
- 变异①:`handle` 恢复"代次不符一律丢" ⇒ 该用例红("取消太晚时,真实结果必须到达界面")。
- 变异②:`finish` 恢复"取消就早退" ⇒ 该用例红(另带 P2-2 那条也红)。
- app-iced 新增 `model/tests/cancel.rs`:三档标题互不相同 + 「太晚」必须有那句补充说明 +
  已回滚不许显示成「部分成功」。

验证(CARGO_TARGET_DIR=C:/Temp/ull-target/wt-194):
`cargo test -p unlucky-core -p unlucky-presenter -p unlucky-app-iced` = 2185 passed / 0 failed;
`-p unlucky-i18n` = 31 / 0;clippy 四 crate = 0 warning / 0 error。
This commit is contained in:
AskaEth committed 2026-11-09 05:06:55 +08:00
1 parent db5b08b9ab
commit b1524635ba
23 files changed
+626 -119

No files matched your search

@@ -19,9 +19,10 @@ use std::path::PathBuf;
use unlucky_i18n::Lang; use unlucky_i18n::Lang;
use unlucky_presenter::dto::{ use unlucky_presenter::dto::{
ConflictChoiceView, ConflictFileView, ConflictReasonView, ExportClassView, ExportFileView, ConflictChoiceView, ConflictFileView, ConflictReasonView, ExportClassView, ExportFileView,
ExportPreviewView, ExportReasonView, ExportState, FileActionView, ImportErrorView, ExportPreviewView, ExportReasonView, ExportState, FileActionView, ImportCancelView,
ImportFailureStageView, ImportProgressView, ImportReportView, ImportStageView, ImportState, ImportErrorView, ImportFailureStageView, ImportProgressView, ImportReportView, ImportStageView,
ImportStatusView, InstanceId, LoaderKind, MissingFileView, MissingReasonView, PackFormatView, ImportState, ImportStatusView, InstanceId, LoaderKind, MissingFileView, MissingReasonView,
PackFormatView,
}; };
use crate::pages::content::Target; use crate::pages::content::Target;
@@ -212,6 +213,7 @@ fn report(status: ImportStatusView, conflicts: bool) -> ImportReportView {
bytes_written: 3_400_000, bytes_written: 3_400_000,
rolled_back: true, rolled_back: true,
failure_stage: None, failure_stage: None,
cancel: ImportCancelView::NotRequested,
}; };
if conflicts { if conflicts {
report.conflicts = vec![ report.conflicts = vec![
@@ -196,9 +196,8 @@ pub struct Pack {
pub running: Option<Running>, pub running: Option<Running>,
/// 探测失败诊断 /// 探测失败诊断
pub probe: Option<Probe>, pub probe: Option<Probe>,
/// 用户取消过这次导入:面板收回,**后台也真的停手并回滚了**(M195 起 core 有取消令牌: /// 用户点过取消、**结果还没回来**(面板已收回)。它只作占位:真实结局在
/// 暂存目录删掉、落盘过的撤回、实例不登记)。这句话仍要留在界面上——取消不是"什么都没 /// `report.cancel` 里(已回滚 / 回滚没做完 / 取消太晚),所以文案不许在这里替结局下结论。
/// 发生",而是"按你的意思停下来了",别让用户以为点空了。
pub cancelled: bool, pub cancelled: bool,
/// 取消提示的正文 /// 取消提示的正文
pub cancelled_note: &'static str, pub cancelled_note: &'static str,
@@ -14,7 +14,7 @@
use unlucky_i18n::{Catalog, Key}; use unlucky_i18n::{Catalog, Key};
use unlucky_presenter::dto::{ use unlucky_presenter::dto::{
ConflictChoiceView, ConflictFileView, ConflictReasonView, ImportErrorView, ConflictChoiceView, ConflictFileView, ConflictReasonView, ImportCancelView, ImportErrorView,
ImportFailureStageView, ImportReportView, ImportStatusView, MissingFileView, MissingReasonView, ImportFailureStageView, ImportReportView, ImportStatusView, MissingFileView, MissingReasonView,
}; };
@@ -124,6 +124,11 @@ pub struct Report {
pub can_overwrite: bool, pub can_overwrite: bool,
/// 「两者都留改名」为何不支持(有冲突时如实写) /// 「两者都留改名」为何不支持(有冲突时如实写)
pub overwrite_note: Option<String>, pub overwrite_note: Option<String>,
/// 这次运行与取消的关系(M195 r3:标题与图标按它分档,不许一句打天下)
pub cancel: ImportCancelView,
/// 取消的**补充说明**:只有「取消太晚」有——那种情况标题照常是"已导入/部分成功",
/// 必须另起一句说清"你的取消没赶上,实例会保留、同名文件可能已被覆盖"。
pub cancel_note: Option<String>,
} }
impl Report { impl Report {
@@ -202,6 +207,9 @@ pub(super) fn report_of(
&& page.instance.is_some(), && page.instance.is_some(),
overwrite_note: (!report.conflicts.is_empty()) overwrite_note: (!report.conflicts.is_empty())
.then(|| catalog.text(Key::PackOverwriteNote).to_owned()), .then(|| catalog.text(Key::PackOverwriteNote).to_owned()),
cancel: report.cancel,
cancel_note: (report.cancel == ImportCancelView::TooLate)
.then(|| catalog.text(Key::PackCancelTooLate).to_owned()),
} }
} }
@@ -215,6 +223,12 @@ fn status_title(report: &ImportReportView, catalog: Catalog) -> &'static str {
match report.status { match report.status {
ImportStatusView::Success => catalog.text(Key::PackStatusSuccess), ImportStatusView::Success => catalog.text(Key::PackStatusSuccess),
ImportStatusView::Partial => catalog.text(Key::PackStatusPartial), ImportStatusView::Partial => catalog.text(Key::PackStatusPartial),
// 三档取消各有各的话:已回滚(什么都没留下)/ 回滚没做完(要对一眼目录)/
// 取消太晚(标题是真实状态,另有一句 cancel_note 说明"没赶上")。
ImportStatusView::Cancelled => match report.cancel {
ImportCancelView::RollbackIncomplete => catalog.text(Key::PackCancelIncomplete),
_ => catalog.text(Key::PackStatusCancelled),
},
ImportStatusView::Failed => match report.failure_stage { ImportStatusView::Failed => match report.failure_stage {
Some(ImportFailureStageView::NotStarted) => { Some(ImportFailureStageView::NotStarted) => {
catalog.text(Key::PackStatusFailedNotStarted) catalog.text(Key::PackStatusFailedNotStarted)
@@ -3,6 +3,7 @@
//! 这里**不测画法**(画法靠出图),测的是「决策」:哪些数字进了哪一行、哪些字段被截短、 //! 这里**不测画法**(画法靠出图),测的是「决策」:哪些数字进了哪一行、哪些字段被截短、
//! 哪一态该出现哪一块。所有断言都能在没有图形环境的情况下跑。 //! 哪一态该出现哪一块。所有断言都能在没有图形环境的情况下跑。
mod cancel;
mod pick; mod pick;
mod stage; mod stage;
@@ -11,8 +12,9 @@ use std::path::PathBuf;
use unlucky_i18n::Lang; use unlucky_i18n::Lang;
use unlucky_presenter::dto::{ use unlucky_presenter::dto::{
ConflictChoiceView, ConflictFileView, ConflictReasonView, ExportClassView, ExportFileView, ConflictChoiceView, ConflictFileView, ConflictReasonView, ExportClassView, ExportFileView,
ExportPreviewView, ImportErrorView, ImportProgressView, ImportReportView, ImportStageView, ExportPreviewView, ImportCancelView, ImportErrorView, ImportProgressView, ImportReportView,
ImportStatusView, InstallStage, MissingFileView, MissingReasonView, PackFormatView, ImportStageView, ImportStatusView, InstallStage, MissingFileView, MissingReasonView,
PackFormatView,
}; };
use super::progress::{panel_progress, panel_stage, stage_line}; use super::progress::{panel_progress, panel_stage, stage_line};
@@ -228,6 +230,7 @@ fn report_keeps_tolerable_and_fatal_apart() {
bytes_written: 0, bytes_written: 0,
rolled_back: true, rolled_back: true,
failure_stage: None, failure_stage: None,
cancel: ImportCancelView::NotRequested,
}; };
let block = report_of(&report, &PackPageState::default(), catalog()); let block = report_of(&report, &PackPageState::default(), catalog());
assert!(block.fatal.is_some(), "致命块必须单独存在"); assert!(block.fatal.is_some(), "致命块必须单独存在");
@@ -265,6 +268,7 @@ fn conflicts_default_to_keeping_the_user_copy() {
bytes_written: 0, bytes_written: 0,
rolled_back: true, rolled_back: true,
failure_stage: None, failure_stage: None,
cancel: ImportCancelView::NotRequested,
}; };
// 「以包为准」只在导入到**已有实例**时给(复审 r1 P2-2),所以这里选一个实例 // 「以包为准」只在导入到**已有实例**时给(复审 r1 P2-2),所以这里选一个实例
let page = PackPageState { let page = PackPageState {
@@ -363,6 +367,7 @@ fn overwrite_is_offered_only_when_importing_into_an_existing_instance() {
bytes_written: 0, bytes_written: 0,
rolled_back: true, rolled_back: true,
failure_stage: None, failure_stage: None,
cancel: ImportCancelView::NotRequested,
}; };
let new_instance = PackPageState::default(); let new_instance = PackPageState::default();
@@ -380,19 +385,3 @@ fn overwrite_is_offered_only_when_importing_into_an_existing_instance() {
"导入到已有实例时才给翻档动作" "导入到已有实例时才给翻档动作"
); );
} }
#[test]
fn cancelled_state_is_visible_and_says_the_import_stopped() {
// M195:取消是管线级的(core 停手并回滚),旧文案「后台还在跑」已是假话。
let import = unlucky_presenter::dto::ImportState {
cancelled: true,
..unlucky_presenter::dto::ImportState::default()
};
let export = unlucky_presenter::dto::ExportState::default();
let model = Pack::of(&import, &export, &PackPageState::default(), &[], catalog());
let note = model.cancelled_note.to_lowercase();
let stopped = note.contains("stopped") && note.contains("rolled back");
assert!(model.cancelled && !model.is_idle(), "取消态不能当成空闲");
assert!(stopped, "文案要说清停手并回滚");
assert!(!note.contains("background"), "文案不许说后台跑");
}
@@ -0,0 +1,140 @@
//! 取消的**三档真实结局**在界面上的分支(M195 r3)。
//!
//! 口径:一句「已停手并回滚」打天下是假话——取消可能停在提交前(已回滚)、可能停在回滚没收尾
//! (目标目录可能变了)、也可能**太晚**(管线已经跑完,实例保留、同名文件可能已被覆盖)。
//! 这一族用例钉的就是"三档各说各的话",以及"占位文案不再替结局下结论"。
use std::path::PathBuf;
use unlucky_i18n::{Catalog, Key, Lang};
use unlucky_presenter::dto::{
ImportCancelView, ImportReportView, ImportStatusView, PackFormatView,
};
use super::super::report::report_of;
use super::super::PackPageState;
fn catalog() -> Catalog {
Lang::En.catalog()
}
fn report(
status: ImportStatusView,
cancel: ImportCancelView,
rolled_back: bool,
) -> ImportReportView {
ImportReportView {
status,
format: Some(PackFormatView::Multimc),
pack_name: Some("Better MC".to_string()),
pack_version: None,
game_version: Some("1.20.1".to_string()),
loader: None,
version_id: Some("1.20.1".to_string()),
target: PathBuf::from("C:/tmp/instance"),
files: Vec::new(),
conflicts: Vec::new(),
missing: Vec::new(),
rejected: Vec::new(),
warnings: Vec::new(),
error: None,
registered: None,
bytes_written: 0,
rolled_back,
failure_stage: None,
cancel,
}
}
#[test]
fn a_rolled_back_cancel_says_it_is_cancelled_not_partially_installed() {
// 取消停在提交前:已回滚 ⇒ 标题是「已取消 —— 已回滚」,**不是**「部分成功」(那等于说装了一半),
// 也不能出现「取消太晚」那句补充说明。
let view = report(
ImportStatusView::Cancelled,
ImportCancelView::RolledBack,
true,
);
let block = report_of(&view, &PackPageState::default(), catalog());
assert_eq!(block.title, catalog().text(Key::PackStatusCancelled));
assert_ne!(
block.title,
catalog().text(Key::PackStatusPartial),
"已回滚的取消不许显示成「部分成功」"
);
assert!(!block.installed(), "取消不是「装上了」");
assert!(block.cancel_note.is_none(), "已回滚不需要「太晚」那句");
}
#[test]
fn an_incomplete_cancel_rollback_says_the_directory_may_differ() {
let view = report(
ImportStatusView::Cancelled,
ImportCancelView::RollbackIncomplete,
false,
);
let block = report_of(&view, &PackPageState::default(), catalog());
assert_eq!(block.title, catalog().text(Key::PackCancelIncomplete));
assert_ne!(
block.title,
catalog().text(Key::PackStatusCancelled),
"回滚没做完 ≠ 已回滚(这两句话不能混)"
);
}
#[test]
fn a_too_late_cancel_says_the_import_already_finished() {
// 取消来得太晚:状态是真实的 `Success`,另加一句「实例会保留、同名文件可能已被覆盖」。
let view = report(ImportStatusView::Success, ImportCancelView::TooLate, false);
let block = report_of(&view, &PackPageState::default(), catalog());
assert_eq!(block.title, catalog().text(Key::PackStatusSuccess));
assert_eq!(block.status, ImportStatusView::Success);
assert_ne!(
block.status,
ImportStatusView::Cancelled,
"太晚 ≠ 已回滚(状态是真的 Success/Partial)"
);
assert_eq!(
block.cancel_note,
Some(catalog().text(Key::PackCancelTooLate).to_owned()),
"必须另外说清「取消没赶上」"
);
}
/// 三档的标题**互不相同**(把任意两档并成一句,这里就红)。
#[test]
fn the_three_cancel_outcomes_have_three_different_titles() {
let titles = [
report_of(
&report(
ImportStatusView::Cancelled,
ImportCancelView::RolledBack,
true,
),
&PackPageState::default(),
catalog(),
)
.title,
report_of(
&report(
ImportStatusView::Cancelled,
ImportCancelView::RollbackIncomplete,
false,
),
&PackPageState::default(),
catalog(),
)
.title,
report_of(
&report(ImportStatusView::Success, ImportCancelView::TooLate, false),
&PackPageState::default(),
catalog(),
)
.title,
];
let unique: std::collections::BTreeSet<&String> = titles.iter().collect();
assert_eq!(unique.len(), 3, "三档必须各说各的话:{titles:?}");
}
@@ -3,7 +3,7 @@
//! 从 `tests.rs` 拆出(那边贴着 400 行硬线):本文件只守「预检没过(一个字节都没写)」与 //! 从 `tests.rs` 拆出(那边贴着 400 行硬线):本文件只守「预检没过(一个字节都没写)」与
//! 「已回滚」的措辞/图标分野。夹具在父模块(`use super::*`)。 //! 「已回滚」的措辞/图标分野。夹具在父模块(`use super::*`)。
use unlucky_presenter::dto::ImportFailureStageView; use unlucky_presenter::dto::{ImportCancelView, ImportFailureStageView};
use super::*; use super::*;
@@ -39,6 +39,7 @@ fn the_two_failure_stages_never_share_one_sentence() {
bytes_written: 0, bytes_written: 0,
rolled_back: true, rolled_back: true,
failure_stage: stage, failure_stage: stage,
cancel: ImportCancelView::NotRequested,
} }
} }
@@ -98,7 +98,8 @@ pub(crate) fn section<'a>(
} else if let Some(report) = &model.report { } else if let Some(report) = &model.report {
block = block.push(report_block(ui, catalog, report)); block = block.push(report_block(ui, catalog, report));
} else if model.cancelled { } else if model.cancelled {
// 取消过、还没有新结果:把「后台还在跑」这句话留在屏上(复审 r1 P1-2) // 取消过、**结果还没回来**:先留一句"正在停手"的占位(真实结局随后的报告给出,
// 已回滚 / 回滚没做完 / 取消太晚三档见 `model::report`)
block = block.push( block = block.push(
column![ column![
frame::text_role( frame::text_role(
@@ -57,6 +57,14 @@ pub(super) fn report_block<'a>(
report.written_line.as_str(), report.written_line.as_str(),
ui.color(Role::OnSurfaceVariant), ui.color(Role::OnSurfaceVariant),
), ),
// 「取消太晚」的那句补充说明(标题仍是真实的 `已导入 / 部分成功`)。
frame::text_role(
ui,
TypeRole::BodySmall,
false,
report.cancel_note.as_deref().unwrap_or(""),
ui.color(Role::Tertiary),
),
] ]
.spacing(ui.space(Space::X1)) .spacing(ui.space(Space::X1))
.width(Length::Fill); .width(Length::Fill);
@@ -292,17 +300,31 @@ pub(super) fn conflict_row<'a>(
} }
pub(super) fn status_icon(report: &Report) -> IconKind { pub(super) fn status_icon(report: &Report) -> IconKind {
use unlucky_presenter::dto::{ImportCancelView, ImportStatusView};
match report.status { match report.status {
unlucky_presenter::dto::ImportStatusView::Success => IconKind::Check, ImportStatusView::Success => IconKind::Check,
unlucky_presenter::dto::ImportStatusView::Partial => IconKind::Warn, ImportStatusView::Partial => IconKind::Warn,
unlucky_presenter::dto::ImportStatusView::Failed => IconKind::Error, ImportStatusView::Failed => IconKind::Error,
// 取消**不是错误**(M195):停手用「关闭(叉)」这个描边字形(页面骨架只允许描边,
// 令牌层的 Play/Stop/More 是填充字形,见 `tests/no_hardcoded_tokens.rs` 的守门),
// 回滚没做完才升级成 Warn,都不上红。
ImportStatusView::Cancelled => match report.cancel {
ImportCancelView::RollbackIncomplete => IconKind::Warn,
_ => IconKind::Close,
},
} }
} }
pub(super) fn status_role(report: &Report) -> Role { pub(super) fn status_role(report: &Report) -> Role {
use unlucky_presenter::dto::{ImportCancelView, ImportStatusView};
match report.status { match report.status {
unlucky_presenter::dto::ImportStatusView::Success => Role::Primary, ImportStatusView::Success => Role::Primary,
unlucky_presenter::dto::ImportStatusView::Partial => Role::Tertiary, ImportStatusView::Partial => Role::Tertiary,
unlucky_presenter::dto::ImportStatusView::Failed => Role::Error, ImportStatusView::Failed => Role::Error,
// 取消一档也不做成 `Role::Error`:用户自己点的,不该看起来像装坏了。
ImportStatusView::Cancelled => match report.cancel {
ImportCancelView::RollbackIncomplete => Role::Tertiary,
_ => Role::OnSurfaceVariant,
},
} }
} }
+11 -2
View File
@@ -179,8 +179,17 @@ macro_rules! content_entries {
), ),
PackReportRejectedNote => ("not supported by the client", "客户端不支持"), PackReportRejectedNote => ("not supported by the client", "客户端不支持"),
PackCancelled => ( PackCancelled => (
"Import cancelled — it stopped and rolled back: nothing was left half-done, no existing files were overwritten.", "Cancel requested — the pipeline is stopping now; the real outcome follows.",
"导入已取消 —— 后台已停手并回滚:没有留下半包,也没有覆盖已有文件。" "已请求取消 —— 后台正在停手,真实结果随后给出。"
),
PackStatusCancelled => ("Cancelled — rolled back", "已取消 —— 已回滚"),
PackCancelIncomplete => (
"Cancelled — rollback incomplete: the target directory may differ from before the import.",
"已取消 —— 回滚没做完:目标目录可能与导入前不同。"
),
PackCancelTooLate => (
"The cancel arrived too late: this import already finished. The instance is kept; same-name files may already be overwritten.",
"取消来得太晚:这次导入已经跑完,实例会保留,同名文件可能已被覆盖。"
), ),
PackOverwriteAction => ("Re-import, the pack wins", "以包为准重新导入"), PackOverwriteAction => ("Re-import, the pack wins", "以包为准重新导入"),
PackOverwriteNote => ( PackOverwriteNote => (
+4 -1
View File
@@ -29,7 +29,10 @@ pub(super) const ROWS: &[(&str, &str, &str)] = &[
("PackReportConflicts", "Conflicts: {count}", "冲突:{count} 个"), ("PackReportConflicts", "Conflicts: {count}", "冲突:{count} 个"),
("PackReportRejected", "The client does not support these: {count}", "这些组件客户端不支持:{count} 个"), ("PackReportRejected", "The client does not support these: {count}", "这些组件客户端不支持:{count} 个"),
("PackReportRejectedNote", "not supported by the client", "客户端不支持"), ("PackReportRejectedNote", "not supported by the client", "客户端不支持"),
("PackCancelled", "Import cancelled — it stopped and rolled back: nothing was left half-done, no existing files were overwritten.", "导入已取消 —— 后台已停手并回滚:没有留下半包,也没有覆盖已有文件。"), ("PackCancelled", "Cancel requested — the pipeline is stopping now; the real outcome follows.", "已请求取消 —— 后台正在停手,真实结果随后给出。"),
("PackStatusCancelled", "Cancelled — rolled back", "已取消 —— 已回滚"),
("PackCancelIncomplete", "Cancelled — rollback incomplete: the target directory may differ from before the import.", "已取消 —— 回滚没做完:目标目录可能与导入前不同。"),
("PackCancelTooLate", "The cancel arrived too late: this import already finished. The instance is kept; same-name files may already be overwritten.", "取消来得太晚:这次导入已经跑完,实例会保留,同名文件可能已被覆盖。"),
("PackOverwriteAction", "Re-import, the pack wins", "以包为准重新导入"), ("PackOverwriteAction", "Re-import, the pack wins", "以包为准重新导入"),
("PackOverwriteNote", "Keeping both (renamed) is not supported yet: for each existing file you pick either “keep” or “overwrite”.", "「两者都留(改名)」暂不支持:每个已存在的文件只能选「保留」或「覆盖」。"), ("PackOverwriteNote", "Keeping both (renamed) is not supported yet: for each existing file you pick either “keep” or “overwrite”.", "「两者都留(改名)」暂不支持:每个已存在的文件只能选「保留」或「覆盖」。"),
("PackMissingOffline", "offline import", "离线导入"), ("PackMissingOffline", "offline import", "离线导入"),
+4 -4
View File
@@ -62,10 +62,10 @@ pub use pack::{
ConflictChoiceView, ConflictDecisionView, ConflictDecisionsView, ConflictFileView, ConflictChoiceView, ConflictDecisionView, ConflictDecisionsView, ConflictFileView,
ConflictReasonView, ConflictSourceView, ExportClassView, ExportDoneView, ExportFileView, ConflictReasonView, ConflictSourceView, ExportClassView, ExportDoneView, ExportFileView,
ExportPreviewView, ExportReasonView, ExportRequestView, ExportState, FileActionView, ExportPreviewView, ExportReasonView, ExportRequestView, ExportState, FileActionView,
ImportConflictView, ImportErrorView, ImportFailureStageView, ImportProgressView, ImportCancelView, ImportConflictView, ImportErrorView, ImportFailureStageView,
ImportReportView, ImportRequestView, ImportScanView, ImportStageView, ImportState, ImportProgressView, ImportReportView, ImportRequestView, ImportScanView, ImportStageView,
ImportStatusView, ImportedFileView, MissingFileView, MissingReasonView, PackCommand, PackEvent, ImportState, ImportStatusView, ImportedFileView, MissingFileView, MissingReasonView,
PackFormatView, PackState, ProbeView, PackCommand, PackEvent, PackFormatView, PackState, ProbeView,
}; };
pub use settings::{SettingControl, SettingGroupView, SettingRowView}; pub use settings::{SettingControl, SettingGroupView, SettingRowView};
// M159: 自更新 // M159: 自更新
+3 -3
View File
@@ -57,7 +57,7 @@ pub use export::{
}; };
pub use format::PackFormatView; pub use format::PackFormatView;
pub use import::{ pub use import::{
FileActionView, ImportErrorView, ImportFailureStageView, ImportProgressView, ImportReportView, FileActionView, ImportCancelView, ImportErrorView, ImportFailureStageView, ImportProgressView,
ImportRequestView, ImportStageView, ImportState, ImportStatusView, ImportedFileView, ImportReportView, ImportRequestView, ImportStageView, ImportState, ImportStatusView,
MissingFileView, MissingReasonView, ProbeView, ImportedFileView, MissingFileView, MissingReasonView, ProbeView,
}; };
+8 -2
View File
@@ -64,8 +64,11 @@ pub enum PackEvent {
Exported(Box<ExportDoneView>), Exported(Box<ExportDoneView>),
/// 导出/预检在 host 侧失败(实例找不到、目录派生失败……一句人读原因) /// 导出/预检在 host 侧失败(实例找不到、目录派生失败……一句人读原因)
ExportFailed(String), ExportFailed(String),
/// 用户取消了导入:面板收回,但后台那次导入会跑完(core 没有取消令牌), /// 用户取消了导入(面板立刻收回)。
/// 所以留一位给界面说清「还在跑、结果作废」。 ///
/// 它只表示"取消后还没有结果":M195 起 core 有取消令牌,管线会在检查点停手并回滚,**真实
/// 结局随后的 [`PackEvent::Report`] 才是准话**(`ImportReportView::cancel` 三档:已回滚 /
/// 回滚没做完 / 取消太晚),所以 `Report` 一到就清掉这一位。
Cancelled, Cancelled,
/// 关掉所有面板 /// 关掉所有面板
Cleared, Cleared,
@@ -99,6 +102,9 @@ impl PackState {
self.import.progress = None; self.import.progress = None;
self.import.probe = None; self.import.probe = None;
self.import.scan = None; self.import.scan = None;
// M195 r3:取消的**真实结局**在 `report.cancel` 里,`cancelled` 只作"取消后
// 还没有结果"时的占位;结果一到就清掉,免得它跨到下一次导入上撒谎。
self.import.cancelled = false;
self.import.report = Some(*report); self.import.report = Some(*report);
} }
PackEvent::Probe(probe) => { PackEvent::Probe(probe) => {
+26 -43
View File
@@ -1,7 +1,7 @@
//! 导入侧 DTO:请求、进度、三态、逐项原因、探测诊断。 //! 导入侧 DTO:请求、进度、三态、逐项原因、探测诊断。
//! //!
//! 三态(`Success` / `Partial` / `Failed`)与 core 一一对应,**`Partial` 不是 `Success`**; //! 状态档(`Success` / `Partial` / `Failed` / `Cancelled`)与 core 一一对应,**`Partial` 不是
//! 容忍域([`MissingFileView`])与致命域([`ImportErrorView`])分属不同类型,UI 不可能混成一个列表。 //! `Success`**、**取消不是失败**;容忍域与致命域分属不同类型,UI 不可能混成一个列表。
use std::path::PathBuf; use std::path::PathBuf;
@@ -12,6 +12,12 @@ use crate::dto::InstanceId;
use super::conflict::{ConflictDecisionsView, ConflictFileView, ImportScanView}; use super::conflict::{ConflictDecisionsView, ConflictFileView, ImportScanView};
use super::format::PackFormatView; use super::format::PackFormatView;
mod cancel;
mod failure_stage;
pub use cancel::ImportCancelView;
pub use failure_stage::ImportFailureStageView;
/// 导入阶段(与 core 的 `ImportStage` 一一对应)。 /// 导入阶段(与 core 的 `ImportStage` 一一对应)。
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)] #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]
pub enum ImportStageView { pub enum ImportStageView {
@@ -62,43 +68,6 @@ impl ImportStageView {
} }
} }
/// 致命失败的**阶段**(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`)。 /// 导入三态(`Partial` **不是** `Success`)。
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)] #[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum ImportStatusView { pub enum ImportStatusView {
@@ -112,6 +81,10 @@ pub enum ImportStatusView {
/// 也可能是写完又回滚干净,还可能是回滚没做完——三种由 /// 也可能是写完又回滚干净,还可能是回滚没做完——三种由
/// [`ImportReportView::failure_stage`] 分开说,界面按它选标题与图标。 /// [`ImportReportView::failure_stage`] 分开说,界面按它选标题与图标。
Failed, Failed,
/// **用户取消,管线停手并回滚**(M195 r3):不是失败,也不是「部分成功」。
/// 「回滚干净 / 没做完」由 [`ImportReportView::cancel`] 再分;取消**太晚**(管线已跑完)
/// 不落这一档——那时实例真装上了,状态是 `Success`/`Partial`,只在 `cancel` 记 `TooLate`。
Cancelled,
} }
impl ImportStatusView { impl ImportStatusView {
@@ -122,6 +95,7 @@ impl ImportStatusView {
Self::Success => "success", Self::Success => "success",
Self::Partial => "partial", Self::Partial => "partial",
Self::Failed => "failed", Self::Failed => "failed",
Self::Cancelled => "cancelled",
} }
} }
@@ -132,14 +106,15 @@ impl ImportStatusView {
"success" => Some(Self::Success), "success" => Some(Self::Success),
"partial" => Some(Self::Partial), "partial" => Some(Self::Partial),
"failed" => Some(Self::Failed), "failed" => Some(Self::Failed),
"cancelled" => Some(Self::Cancelled),
_ => None, _ => None,
} }
} }
/// 实例可用吗(`Success` / `Partial` 都是「装上了」)。 /// 实例可用吗(`Success` / `Partial` 是「装上了」;取消与失败都没装上)。
#[must_use] #[must_use]
pub const fn installed(self) -> bool { pub const fn installed(self) -> bool {
!matches!(self, Self::Failed) matches!(self, Self::Success | Self::Partial)
} }
} }
@@ -340,6 +315,11 @@ pub struct ImportReportView {
pub rolled_back: bool, pub rolled_back: bool,
/// 失败发生在哪一步(`None` = 这次不是致命失败)。 /// 失败发生在哪一步(`None` = 这次不是致命失败)。
pub failure_stage: Option<ImportFailureStageView>, pub failure_stage: Option<ImportFailureStageView>,
/// 这次运行与「取消」的关系(M195 r3:取消的**真实结局**,界面按它选文案)。
///
/// 只靠 `status` 表达不了三档:已回滚 / 回滚没做完都在 [`ImportStatusView::Cancelled`] 里,
/// 而「取消太晚、已经跑完」的状态是 `Success`/`Partial`——三档见 [`ImportCancelView`]。
pub cancel: ImportCancelView,
} }
impl ImportReportView { impl ImportReportView {
@@ -379,8 +359,11 @@ pub struct ProbeView {
pub struct ImportState { pub struct ImportState {
/// 正在跑的进度(`None` = 没在跑)。 /// 正在跑的进度(`None` = 没在跑)。
pub progress: Option<ImportProgressView>, pub progress: Option<ImportProgressView>,
/// 用户点了取消(M113 r1):**面板收回但后台还在跑**,所以这一位要留在界面上—— /// 用户点了取消、**结果还没回来**(M195 r3 收窄了它的含义)。
/// 否则用户会以为「没建成」,回头再导一次就撞「directory already exists」。 ///
/// 它只作"取消后还没有结果"的占位:真实结局随后的 `report.cancel` 才是准话(已回滚 /
/// 回滚没做完 / 取消太晚)。所以 `PackEvent::Report` 一到就清掉这一位,免得它跨到下一次
/// 导入上替结局下结论。
pub cancelled: bool, pub cancelled: bool,
/// 最近一次的预检(M160:冲突清单;`None` = 还没预检过或已被新结果顶掉)。 /// 最近一次的预检(M160:冲突清单;`None` = 还没预检过或已被新结果顶掉)。
pub scan: Option<ImportScanView>, pub scan: Option<ImportScanView>,
@@ -0,0 +1,43 @@
//! 一次导入与「取消」的关系(**真实结局**,不是"用户点没点过取消")。
//!
//! 从父模块拆出来只为行数(父文件已到 400 硬限附近),判据与文案口径原样。
//!
//! 三档各有各的话要说,混成一句就是撒谎(M195 r3):
//! - [`ImportCancelView::RolledBack`]:停手了,目标目录与导入前一致;
//! - [`ImportCancelView::RollbackIncomplete`]:停手了,但回滚没做完,目标目录可能与导入前不同;
//! - [`ImportCancelView::TooLate`]:**没来得及停**,管线已经跑完——实例会保留,同名文件可能已被覆盖。
use serde::{Deserialize, Serialize};
/// 一次导入与「取消」的关系(**真实结局**)。
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]
pub enum ImportCancelView {
/// 这次运行没被取消过。
#[default]
NotRequested,
/// 取消生效,管线停手并**完整**回滚(目标目录与导入前一致,实例没登记)。
RolledBack,
/// 取消生效,但回滚没做完(目标目录可能与导入前不同,逐条在 `warnings` 里)。
RollbackIncomplete,
/// 取消到得太晚:管线已经跑完,实例保留,同名文件可能已被覆盖。
TooLate,
}
impl ImportCancelView {
/// 稳定 slug。
#[must_use]
pub const fn slug(self) -> &'static str {
match self {
Self::NotRequested => "not_requested",
Self::RolledBack => "rolled_back",
Self::RollbackIncomplete => "rollback_incomplete",
Self::TooLate => "too_late",
}
}
/// 用户这次取消有没有**真的生效**(前两档是真停手了)。
#[must_use]
pub const fn stopped(self) -> bool {
matches!(self, Self::RolledBack | Self::RollbackIncomplete)
}
}
@@ -0,0 +1,42 @@
//! 致命失败发生在哪一步(M161:`rolled_back` 一个人说不了两件事)。
//!
//! 从父模块拆出来只为行数;判据与文案口径原样。
use serde::{Deserialize, Serialize};
/// 致命失败的**阶段**(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)
}
}
+1 -1
View File
@@ -42,7 +42,7 @@ mod plan;
mod pack; mod pack;
mod sources; mod sources;
pub(super) use pack::{cancel_pack, pack_epoch}; pub(super) use pack::{cancel_pack, pack_epoch, take_terminal_epoch};
#[cfg(test)] #[cfg(test)]
mod tests; mod tests;
+46 -2
View File
@@ -34,6 +34,13 @@
//! 3. **后台那次导入真的停手**:core 在阶段边界与长循环内检查令牌,停下就回滚(暂存目录删掉、 //! 3. **后台那次导入真的停手**:core 在阶段边界与长循环内检查令牌,停下就回滚(暂存目录删掉、
//! 落盘过的撤回、实例不登记),结果是 `ImportStatus::Cancelled` 而**不是**失败。响应延迟的 //! 落盘过的撤回、实例不登记),结果是 `ImportStatus::Cancelled` 而**不是**失败。响应延迟的
//! 底线是「当前这一条文件读完/下完」,见 `core::addon::import::cancel` 的逐段表; //! 底线是「当前这一条文件读完/下完」,见 `core::addon::import::cancel` 的逐段表;
//!
//! **收尾永远把真实结局送到界面**(M195 r3):取消可能落在最后一个检查点之后 —— 那时管线
//! 已经跑完(用户的同名文件被覆盖、实例已登记),也可能回滚没做完。这两种结果以前被
//! `cancel` 的早退 + 代次过滤一起丢掉,界面只剩一句无条件的"已停手并回滚"。现在
//! `import::finish` 无条件发 `PackEvent::Report`,`HostPackState::terminal_epochs` 给
//! "刚被取消的那一次"留一条**只放行 Report** 的一次性通道([`take_terminal_epoch`]),
//! DTO 的 `ImportReportView::cancel` 三档把区别带到界面;
//! 4. **提示语不能借用安装那条**(复审 r1 P1-2):`cancel_pack()` 回一个「刚才有没有导入在跑」, //! 4. **提示语不能借用安装那条**(复审 r1 P1-2):`cancel_pack()` 回一个「刚才有没有导入在跑」,
//! `dispatch` 据此改发 [`crate::dto::PackEvent::Cancelled`]。取消**通常**意味着实例没建 //! `dispatch` 据此改发 [`crate::dto::PackEvent::Cancelled`]。取消**通常**意味着实例没建
//! (管线回滚了),但取消也可能恰好在两个检查点之间落下(那时已经装完并登记)——所以文案 //! (管线回滚了),但取消也可能恰好在两个检查点之间落下(那时已经装完并登记)——所以文案
@@ -78,10 +85,17 @@ use super::super::job::{HostTask, JobSender};
/// ///
/// 为什么不挪进 `CoreHost`:那要给 `host/mod.rs` 加字段(不在本 mission 的 scope)。这张表等价, /// 为什么不挪进 `CoreHost`:那要给 `host/mod.rs` 加字段(不在本 mission 的 scope)。这张表等价,
/// 只是把「每 host 的字段」放在模块里;`host/mod.rs` 一旦进 scope,搬过去只是把这张表删掉。 /// 只是把「每 host 的字段」放在模块里;`host/mod.rs` 一旦进 scope,搬过去只是把这张表删掉。
#[derive(Default, Clone, Copy)] #[derive(Default)]
struct HostPackState { struct HostPackState {
epoch: u64, epoch: u64,
in_flight: usize, in_flight: usize,
/// 「刚被取消、还欠界面一份终态报告」的那几个代次(M195 r3)。
///
/// `cancel_pack` 会把代次 +1,于是被取消那次运行交上来的 `PackEvent::Report` 会被 `handle`
/// 按代次丢掉——可那份报告才是**真实结局**(停手并回滚 / 回滚没做完 / 取消太晚其实已装完)。
/// 记在这里的代次允许**一条** `Report` 穿透代次过滤,取走即销;新一轮导入(`fresh_cancel`)
/// 清空整表,旧运行的报告不会污染新面板。
terminal_epochs: Vec<u64>,
} }
static PACK_STATE: Mutex<Vec<(PathBuf, HostPackState)>> = Mutex::new(Vec::new()); static PACK_STATE: Mutex<Vec<(PathBuf, HostPackState)>> = Mutex::new(Vec::new());
@@ -163,12 +177,42 @@ pub(in crate::host) fn cancel_pack(env: &HostEnv) -> bool {
cancel.store(true, Ordering::SeqCst); cancel.store(true, Ordering::SeqCst);
} }
} }
let running = in_flight(env) > 0;
if running {
// 记下**马上要被作废的那个代次**:那次运行随后交上来的报告是它的真实结局,必须能穿透
// 代次过滤(否则"取消太晚、其实已经装完"在界面上永远不成立)。重复取消只记一次。
let stale = pack_epoch(env);
with_state(env, |state| {
if !state.terminal_epochs.contains(&stale) {
state.terminal_epochs.push(stale);
}
});
}
bump_pack_epoch(env); bump_pack_epoch(env);
in_flight(env) > 0 running
}
/// 这个代次是不是「刚被取消、还欠一份终态报告」的那一次(**取走即销**:只放行一条)。
///
/// 只给 `PackEvent::Report` 用:取消之后的**进度**事件仍旧一律按代次丢掉(面板早就收回了,
/// 再点亮它就是「点了取消没反应」的旧病)。
pub(in crate::host) fn take_terminal_epoch(env: &HostEnv, epoch: u64) -> bool {
with_state(env, |state| {
match state.terminal_epochs.iter().position(|seen| *seen == epoch) {
Some(index) => {
state.terminal_epochs.remove(index);
true
}
None => false,
}
})
} }
/// 这个 host 新一次导入的取消标记(挂进表里供 [`cancel_pack`] 用)。 /// 这个 host 新一次导入的取消标记(挂进表里供 [`cancel_pack`] 用)。
///
/// 顺手清掉「还欠终态报告」的代次:新一次运行占住面板,上一次的结局不该再冒出来。
fn fresh_cancel(env: &HostEnv) -> Arc<AtomicBool> { fn fresh_cancel(env: &HostEnv) -> Arc<AtomicBool> {
with_state(env, |state| state.terminal_epochs.clear());
let cancel = Arc::new(AtomicBool::new(false)); let cancel = Arc::new(AtomicBool::new(false));
let key = host_key(env); let key = host_key(env);
let mut table = PACK_CANCEL let mut table = PACK_CANCEL
+15 -13
View File
@@ -8,6 +8,8 @@
//! 于是「翻译表」本身就是一份可审计的清单:core 加了新变体,`from_slug` 返回 `None` //! 于是「翻译表」本身就是一份可审计的清单:core 加了新变体,`from_slug` 返回 `None`
//! 时这里会落到一个有名字的兜底,而不是悄悄画成别的意思。 //! 时这里会落到一个有名字的兜底,而不是悄悄画成别的意思。
mod cancel;
use std::path::{Path, PathBuf}; use std::path::{Path, PathBuf};
use unlucky_core::addon::export::{ExportReport, FileClass, FileReason}; use unlucky_core::addon::export::{ExportReport, FileClass, FileReason};
@@ -101,20 +103,18 @@ const fn reason_of(reason: ConflictReason) -> ConflictReasonView {
/// 一次导入结果 → DTO。 /// 一次导入结果 → DTO。
/// ///
/// # `Cancelled` 为什么在这里没有对应档(M195) /// `cancel_requested` = 这次运行**被点过取消**(presenter 手里的那个开关)。它只用来区分
/// /// "取消太晚"那一档:管线已经跑完时报告是 `Success`/`Partial`,但那不是一次正常导入——
/// DTO 的 `ImportStatusView` 只有三档,取消走的是 [`crate::dto::PackEvent::Cancelled`] /// 用户的取消没赶上,实例会保留、同名文件可能已被覆盖(M195 r3)。
/// (`import::run` 拿到 `ImportStatus::Cancelled` 就不发报告事件了)。所以本函数只会在 pub(super) fn report_view(
/// "取消恰好落在两个检查点之间、报告仍然是成功/部分成功"时被调用。真收到 `Cancelled` report: &ImportReport,
/// 时按 `Partial` 落地:**绝不是** `Failed`——取消不是失败,不许画成红的。 target: &Path,
pub(super) fn report_view(report: &ImportReport, target: &Path) -> ImportReportView { cancel_requested: bool,
) -> ImportReportView {
ImportReportView { ImportReportView {
status: match report.status { status: ImportStatusView::from_slug(report.status.as_str())
ImportStatus::Cancelled => ImportStatusView::Partial, .unwrap_or(ImportStatusView::Failed),
other => { cancel: cancel::cancel_view(report, cancel_requested),
ImportStatusView::from_slug(other.as_str()).unwrap_or(ImportStatusView::Failed)
}
},
format: report.format.as_deref().and_then(PackFormatView::from_slug), format: report.format.as_deref().and_then(PackFormatView::from_slug),
pack_name: report.pack_name.clone(), pack_name: report.pack_name.clone(),
pack_version: report.pack_version.clone(), pack_version: report.pack_version.clone(),
@@ -330,6 +330,8 @@ fn failed_report_with(target: PathBuf, pack: &Path, error: ImportErrorView) -> I
rolled_back: true, rolled_back: true,
// 预检/装配阶段就失败了:目标目录一个字节都没写(不是「写完又回滚」)。 // 预检/装配阶段就失败了:目标目录一个字节都没写(不是「写完又回滚」)。
failure_stage: Some(ImportFailureStageView::NotStarted), failure_stage: Some(ImportFailureStageView::NotStarted),
// 这一路根本没进管线,谈不上取消。
cancel: crate::dto::ImportCancelView::NotRequested,
} }
} }
@@ -0,0 +1,27 @@
//! 「取消的**真实结局**」→ DTO 三档(M195 r3)。
//!
//! 从父模块拆出来只为行数(父文件已到 400 硬限附近),判据与文案口径原样。
use unlucky_core::addon::import::report::ImportStatus;
use unlucky_core::addon::import::ImportReport;
use crate::dto::ImportCancelView;
/// core 的「取消真实结局」→ DTO 的三档(M195 r3:**不许**把三档混成一句)。
///
/// - core 说 `Cancelled` ⇒ 管线真的停手了;回滚完整与否看 `rolled_back`(两档分开说);
/// - core 说别的(`Success`/`Partial`/`Failed`)但这次被点过取消 ⇒ **取消太晚**:报告是真结局,
/// 但它不是"停下来了",界面必须照实说「实例会保留、文件可能已被覆盖」。
pub(super) fn cancel_view(report: &ImportReport, cancel_requested: bool) -> ImportCancelView {
match report.status {
ImportStatus::Cancelled => {
if report.rolled_back {
ImportCancelView::RolledBack
} else {
ImportCancelView::RollbackIncomplete
}
}
_ if cancel_requested => ImportCancelView::TooLate,
_ => ImportCancelView::NotRequested,
}
}
+39 -15
View File
@@ -8,8 +8,9 @@
//! 3. **缺省档永远 `KeepAll`**:决策从 DTO 逐字段搬([`convert::decisions_of`]),页面没点过的 //! 3. **缺省档永远 `KeepAll`**:决策从 DTO 逐字段搬([`convert::decisions_of`]),页面没点过的
//! 路径在 core 侧落到"保留"; //! 路径在 core 侧落到"保留";
//! 4. **取消是真取消**(M195):`cancel` 标记既挡界面事件、又**交给 core 当取消令牌**——管线 //! 4. **取消是真取消**(M195):`cancel` 标记既挡界面事件、又**交给 core 当取消令牌**——管线
//! 在检查点停手并回滚,不再"后台跑完并登记"(逐段检查点见 //! 在检查点停手并回滚(逐段检查点见 `core::addon::import::cancel`)。取消之后的**进度**不再
//! `core::addon::import::cancel`)。取消后不再打扰界面:进度回调与最终报告都先看取消标记。 //! 打扰界面(回调与代次都挡),但**终态报告一定发出**:取消可能太晚(管线已跑完)或回滚
//! 没做完,那两种结局必须让用户看见(见 [`finish`])。
use std::path::PathBuf; use std::path::PathBuf;
use std::sync::atomic::{AtomicBool, Ordering}; use std::sync::atomic::{AtomicBool, Ordering};
@@ -196,26 +197,49 @@ pub(super) fn run(
} }
let report = block_on(import_pack(&core_request)); let report = block_on(import_pack(&core_request));
if (report.status == ImportStatus::Failed || report.status == ImportStatus::Cancelled) // 取消标记要**在管线返回之后**再读一次:取消可能来得太晚(管线已经跑完),这一读就是
&& register // "太晚"的唯一证据(`finish` 用它把报告标成 `TooLate`)。
let cancel_requested = cancel.load(Ordering::SeqCst);
finish(tx, &target, register, epoch, cancel_requested, &report);
}
/// 收尾:清掉我们自建的空目录 + 把 core 的报告变成事件。
///
/// # 取消也照发(M195 r3)
///
/// 以前这里 `cancel.load()` 是对**所有**事件的早退,于是"取消太晚、后台其实已经装完并登记"
/// 这件事永远到不了界面,界面只能照着旧文案说「已停手并回滚」。现在报告无条件发出:它就是
/// 真实结局——core 说 `Cancelled`(停手并回滚 / 回滚没做完),或者说 `Success`/`Partial`
/// (取消没赶上),由 DTO 的 `cancel` 三档把区别带到界面。
///
/// 代次仍用**出发时**那个(`epoch`):`handle` 给"刚被取消的那一次"留了一次性终态通道
/// ([`super::super::addon::pack::take_terminal_epoch`]),进度事件照旧按代次丢。
pub(super) fn finish(
tx: &JobSender,
target: &std::path::Path,
register: bool,
epoch: u64,
cancel_requested: bool,
report: &unlucky_core::addon::import::ImportReport,
) {
if register
&& matches!(
report.status,
ImportStatus::Failed | ImportStatus::Cancelled
)
{ {
// 失败 / 取消都已回滚,但**目录是我们建的**(`prepare_target`)、core 只清文件不清 // 失败 / 取消都已回滚,但**目录是我们建的**(`prepare_target`)、core 只清文件不清
// 目录 ⇒ 不清掉的话下一次重试会撞「directory already exists」(复审 r1 P2-9)。 // 目录 ⇒ 不清掉的话下一次重试会撞「directory already exists」(复审 r1 P2-9)。
remove_if_empty(&target); remove_if_empty(target);
}
if report.status == ImportStatus::Cancelled || cancel.load(Ordering::SeqCst) {
// 取消之后不再打扰界面(面板已经收回,代次也已经作废)。
//
// M195 起这条是**真的停下来了**:core 在检查点回滚(暂存目录已删,落盘过的已撤回,
// 实例没有登记)。所以提示语可以照实说「已取消:目标目录未改动」;
// `cancel.load(..)` 单独留一条是因为取消也可能**恰好落在两个检查点之间**(管线已经
// 跑完并登记),那时同样不再打扰界面,但别对用户说"没装"。
return;
} }
send( send(
tx, tx,
epoch, epoch,
PackEvent::Report(Box::new(convert::report_view(&report, &target))), PackEvent::Report(Box::new(convert::report_view(
report,
target,
cancel_requested,
))),
); );
} }
@@ -65,3 +65,151 @@ fn a_pre_cancelled_flag_really_stops_the_core_pipeline() {
let _ = std::fs::remove_dir_all(&dir); let _ = std::fs::remove_dir_all(&dir);
} }
/// **路径 A:取消来得太晚**(M195 r3 的核心用例)。
///
/// 三段拼起来,全部确定性、没有 sleep:
/// 1. **core 真管线**跑一次合并态导入,把取消置在**最后一条** `ImportStage::Commit` 进度上——
/// 之后没有任何检查点,于是管线一路跑完(用户的 `mods/a.jar` 被覆盖),报告是
/// `Success` + `rolled_back == false`(core 一直是诚实的);
/// 2. `cancel_pack` 把代次 +1(这就是"取消"),并记下被作废的那个代次;
/// 3. `finish` 照发 `PackEvent::Report`,`handle` 让它**穿透代次**——界面因此拿到「已完成 /
/// 未回滚 / 取消太晚」,而不是旧行为里那句无条件的「已停手并回滚」。
///
/// 变异:把终态通道去掉(`handle` 恢复"代次不符一律丢")⇒ 本用例立刻红(报告到不了界面)。
#[test]
fn a_late_cancel_still_delivers_the_real_outcome_to_the_ui() {
use std::sync::atomic::AtomicUsize;
use unlucky_core::addon::import::{
import_pack, ConflictPolicy, ImportCancel, ImportProgress, ImportProgressSink,
ImportRequest, ImportStage, ImportStatus,
};
use unlucky_core::download::blocking::block_on;
use crate::dto::{AppEvent, Backend, CoreEvent, PackEvent};
let dir = temp_dir("cancel-late");
// 包里有 `mods/a.jar`,目标目录里也有(内容不同)⇒ 合并态"被覆盖"是真的会发生。
let source = dir.join("Path A Pack");
write(
&source.join("mmc-pack.json"),
br#"{"formatVersion": 1, "components": [
{"uid": "net.minecraft", "version": "1.20.1"}]}"#,
);
write(&source.join(".minecraft/mods/a.jar"), b"pack a");
let target = dir.join("instance");
write(&target.join("mods/a.jar"), b"user a");
let data = dir.join("data");
std::fs::create_dir_all(&data).expect("data root");
let env = crate::host::HostEnv::at_root(&data);
// ① core:取消置在最后一条逐文件进度上 ⇒ 之后没有检查点 ⇒ 管线跑完。
let token = ImportCancel::new();
let sink_token = token.clone();
let seen = Arc::new(AtomicUsize::new(0));
let seen_by_sink = Arc::clone(&seen);
let sink: ImportProgressSink = Arc::new(move |progress: &ImportProgress| {
if progress.stage != ImportStage::Commit || progress.total == 0 {
return;
}
seen_by_sink.fetch_add(1, Ordering::SeqCst);
if progress.done + 1 == progress.total {
sink_token.cancel();
}
});
let report = block_on(import_pack(
&ImportRequest::new(&source, &target)
.with_cancel(&token)
// 覆盖档:让用户的 `mods/a.jar` 真的被覆盖(缺省是"保留用户那一侧")。
.with_conflict_policy(ConflictPolicy::Overwrite)
.with_progress(sink),
));
assert!(token.is_cancelled(), "用例前提:取消确实置位了");
assert!(
seen.load(Ordering::SeqCst) > 1,
"确实逐文件走到了底(合并态)"
);
assert_eq!(
report.status,
ImportStatus::Success,
"取消置在最后一条之后 ⇒ 管线已经跑完:{:?}",
report.error
);
assert!(
!report.rolled_back,
"没有回滚就别说回滚过(core 的机器位是诚实的)"
);
assert_eq!(
std::fs::read(target.join("mods/a.jar")).expect("读被覆盖的文件"),
b"pack a",
"路径 A 的前提:用户的同名文件**已经被覆盖**"
);
// ② 用户点取消:代次 +1,被作废的那个代次进了终态通道。
let epoch = super::super::pack_epoch(&env);
let _in_flight = super::super::InFlight::begin(&env);
assert!(
super::super::cancel_pack(&env),
"取消应当看到一条在跑的导入"
);
assert_ne!(
super::super::pack_epoch(&env),
epoch,
"取消会作废本次代次(这正是旧实现丢报告的成因)"
);
// ③ 收尾照发报告;同代次上的**进度**事件仍按代次丢掉。
let mut host = crate::host::CoreHost::headless(env.clone());
let (tx, rx) = crate::host::job::channel();
super::super::import::finish(&tx, &target, false, epoch, true, &report);
tx.send(crate::host::job::HostTask::Pack {
event: Box::new(PackEvent::Progress(None)),
epoch,
})
.expect("送一条同代次的进度事件");
drop(tx);
for task in rx.iter() {
host.handle(task);
}
let events = host.drain_events();
let delivered: Vec<&crate::dto::ImportReportView> = events
.iter()
.filter_map(|event| match event {
AppEvent::Core(CoreEvent::Pack(inner)) => match inner.as_ref() {
PackEvent::Report(view) => Some(view.as_ref()),
_ => None,
},
_ => None,
})
.collect();
let view = delivered
.first()
.expect("取消太晚时,真实结果必须到达界面(丢掉就是路径 A 的假话)");
assert_eq!(
view.status,
crate::dto::ImportStatusView::Success,
"界面拿到的结局是「已完成」"
);
assert!(
!view.rolled_back,
"界面拿到的结局是「未回滚」,不是「已回滚」"
);
assert_eq!(
view.cancel,
crate::dto::ImportCancelView::TooLate,
"必须标成「取消太晚」,不能标成「已回滚」"
);
assert!(
!events.iter().any(|event| match event {
AppEvent::Core(CoreEvent::Pack(inner)) =>
matches!(inner.as_ref(), PackEvent::Progress(_)),
_ => false,
}),
"终态通道只放行报告:取消后的进度事件仍按代次丢掉"
);
let _ = std::fs::remove_dir_all(&dir);
}
+8
View File
@@ -49,8 +49,16 @@ impl CoreHost {
// pack 用**自己**的代次(复审 r1 P2-7):共用安装的计数器会让 // pack 用**自己**的代次(复审 r1 P2-7):共用安装的计数器会让
// 「关一次导入面板」把下载页正在跑的安装静默丢掉。 // 「关一次导入面板」把下载页正在跑的安装静默丢掉。
if epoch != addon::pack_epoch(&self.env) { if epoch != addon::pack_epoch(&self.env) {
// 唯一例外(M195 r3):**刚被取消的那一次**交上来的终态报告。取消会把代次
// +1,若连报告一起丢,界面就永远学不到"取消太晚、其实已经装完/回滚没做完"
// 这个真相——只剩一句无条件的"已停手并回滚"。
// 只放行 `Report`、且同一代次只放行一条;进度事件照旧按代次丢。
if !(matches!(&*event, PackEvent::Report(_))
&& addon::take_terminal_epoch(&self.env, epoch))
{
return; return;
} }
}
// 导入成功可能登记了新实例:与 `InstallDone` 同一条刷新(复审 r1 P2-1), // 导入成功可能登记了新实例:与 `InstallDone` 同一条刷新(复审 r1 P2-1),
// 否则新实例要等下一次无关的 `RefreshAll` 才出现在实例页与目标 chips 里。 // 否则新实例要等下一次无关的 `RefreshAll` 才出现在实例页与目标 chips 里。
if matches!(*event, PackEvent::Report(_)) { if matches!(*event, PackEvent::Report(_)) {