feat(dlflow): M105 安装选项区(四家加载器 + 官方版本列表 + 实例名)与取消安装真停

用户实跑反馈两条,本轮各自定位到根因并修掉:

1. 「下载页没有前置加载器选项」= 功能未做:`Message::InstallVersion` 直接派
   `AppCommand::InstallVersion`(= 只装原版),core 早在 M32/M35/M45 就有四家加载器的
   安装管线。现在选中版本之后面板先给「安装选项」区(原版 / Forge / NeoForge / Fabric /
   Quilt + 该加载器的官方版本列表 + 实例名),点「安装」才派
   `AppCommand::CreateInstance`。
   - 加载器版本列表复用 core 的 `LoaderSource::loader_versions`,经新增的
     `AppCommand::ListLoaderVersions` / `CoreEvent::LoaderVersions` 回流;
     缓存键是 `(加载器, 原版版本)`,切版本不会串列表;取不到给具名原因并**禁掉确认**。
   - 不兼容组合用静态规则在**选中那一刻**说清(NeoForge 需 1.20.1+、Fabric/Quilt 需
     1.14+、远古版四家都不支持),不让用户「选完才失败」,也不为不可能的组合作无谓联网。
   - 选项草稿(选中 + 加载器 + 加载器版本 + 实例名)住在 `App`,`refresh_view` 带进页面
     模型(与分类筛选同一做法;页面自己存不住跨事件的东西)。

2. 「点取消没反应」= 真 bug,两跳各断一半:
   - 第一跳(UI 侧):取消确实生效了,但**还在跑的后台线程继续发进度**,`InstallProgress(None)`
     刚把面板收回,下一条「下载中」立刻又点亮它 —— 用户看到的就是「点了没反应」。
     修法:`CoreHost` 加安装代次 `install_epoch`(开工与取消都 +1),`HostTask::Install` /
     `InstallDone` 带代次回来,代次不符一律丢。
   - 第二跳(core 侧):`execute` 没有任何取消入参,取消只停在段边界,传输根本没停。
     新增 `execute_with_cancel(…, cancel: Option<&AtomicBool>)`(既有 `execute` 原样包装,
     CLI 一字未改):取消后不再起新文件,在飞的那个与「取消 future」`select` 赛跑,取消赢就
     drop 掉下载 future(响应流关闭、`.ullpart` 由 `PartFile::Drop` 清掉),并且不写版本清单,
     返回新的 `InstallErrorKind::Cancelled`。
   - 另外:取消后**绝不登记实例**(文件段跑完但用户已取消的那一路也拦住);取消文案把
     「哪些留着、哪些一定没发生」说清(D21)。

实测(真网络装置 `host/cancel_tests.rs`,`#[ignore]` 守着,跑法见文件头):
取消前 files_done=2 / `.ullpart` 613 字节;取消后 20 s 进度事件 **0 条**、`.ullpart` **0 字节**
(-613)、版本清单未落盘、实例目录不存在。取消前是 +201466 字节(同一个装置量的)。

文案全部进 i18n(中英,9 条新 key + 金表同步)。
This commit is contained in:
AskaEth committed 2026-11-04 22:12:22 +08:00
1 parent d690d09b84
commit 30b1ff6f48
39 files changed
+2550 -518

No files matched your search

+21 -2
View File
@@ -10,8 +10,8 @@ use crate::dialogs::{DialogId, DialogRequest};
use crate::dto::CreateRequest;
use crate::dto::{
AccountView, AgentEvent, DeviceLoginView, DiagnosisReport, InstallProgressView, InstanceId,
InstanceRuntime, InstanceSummary, JavaPageView, LogLine, LogOutcome, LogSession, NoticeView,
SessionId, SettingGroupView, VersionCategory, VersionSummary,
InstanceRuntime, InstanceSummary, JavaPageView, LoaderKind, LogLine, LogOutcome, LogSession,
NoticeView, SessionId, SettingGroupView, VersionCategory, VersionSummary,
};
use crate::toast::Toast;
@@ -71,6 +71,18 @@ pub enum CoreEvent {
JavaChanged(JavaPageView),
/// 安装进度(`None` = 清掉进度面板)
InstallProgress(Option<InstallProgressView>),
/// 某 (加载器, 原版版本) 可用的加载器版本列表(下载页「安装选项」的版本下拉)。
///
/// `result` 用 `Result` 而不是空列表:**取不到**与**确实没有**是两件事,
/// 前者要给具名错误(不许让下拉显示成空还以为能装),后者是「这个组合官方就没有版本」。
LoaderVersions {
/// 加载器种类
kind: LoaderKind,
/// 目标原版版本
mc_version: String,
/// `Ok(最新在前)` / `Err(人读原因)`
result: Result<Vec<String>, String>,
},
/// 设置分组刷新(设置页右栏)
SettingsChanged(Vec<SettingGroupView>),
/// 横幅通知刷新(隔离切换提示/启动失败等)
@@ -110,6 +122,13 @@ pub enum AppCommand {
CancelInstall,
/// 新建实例(向导提交:版本 + 加载器 + 名字)
CreateInstance(CreateRequest),
/// 拉取某原版版本可用的加载器版本(下载页「安装选项」的版本下拉)
ListLoaderVersions {
/// 加载器种类
kind: LoaderKind,
/// 目标原版版本(`1.20.1`)
mc_version: String,
},
/// 修改实例隔离档位(写实例设置文件)
SetIsolation {
/// 实例 id
+330
View File
@@ -0,0 +1,330 @@
//! 取消安装的**实测装置**(M105)。
//!
//! ## 为什么这条测试要真起一次安装
//!
//! 「点取消没反应」有三种可能的断点,读码分不出来:
//! ① 按钮/消息链断了(不派 `AppCommand::CancelInstall`);
//! ② host 收下取消后,**还在跑的任务**继续发进度事件,把面板又点亮(面板闪一下又回来);
//! ③ 取消根本停不下传输(M105 之前 core 的 `execute` 没有取消入参,下载线程会跑到段尾)。
//!
//! ①② 能靠单测的假事件流抓;③ 只有真起一次安装、真取消、真量「取消之后还在发生什么」才抓得到。
//! 修完之后 ①②③ 都有守门:① 是 app 层的消息测试,② 是下面那条 CI 可跑的
//! [`progress_from_a_cancelled_job_is_dropped`],③ 就是本用例(真网络)。
//!
//! 所以这一条是**真网络**用例:`#[ignore]` 守着(CI 不跑),人工跑:
//!
//! ```text
//! cargo test -p unlucky-presenter --test '' -- real_install --ignored --nocapture
//! # 或(等价,本用例在 lib 测试里)
//! cargo test -p unlucky-presenter real_install_cancel -- --ignored --nocapture
//! ```
//!
//! ## 它量什么(三样里能抓住的两样)
//!
//! | 现象 | 怎么量 | 抓住什么 / 抓不住什么 |
//! |---|---|---|
//! | 进度还在推进 | 取消后收到的 `InstallProgress(Some)` 条数与 `files_done` 增量 | 抓得住「UI 侧还在被事件喂」;抓不住事件之外的后台动作 |
//! | 断点文件还在长 | `<game>/**/*.ullpart*` 的总字节,取消时 vs 取消后 20 s | 抓得住「网络/磁盘确实还在写」;抓不住「线程还活着」(`.ullpart` 不再长也可能是卡在等响应) |
//! | 实例被登记 | `<game>/versions/<id>/<id>.json` 与 `.minecraft/instances` 有没有多出来 | 抓得住「取消后仍然落了成品」;抓不住「用户看不到的临时目录」 |
//!
//! 线程与 socket 两样**抓不住**(没有可移植的查询口,见 `probe` 一节),所以这里不用它当判据。
use std::path::{Path, PathBuf};
use std::time::{Duration, Instant};
use crate::dto::{AppCommand, AppEvent, Backend, CoreEvent, InstallProgressView, InstallStage};
use super::job::HostTask;
use super::{env::HostEnv, CoreHost};
/// 实测用的数据根(放在固定位置而不是系统 temp:便于人工复跑时留着看)。
fn root() -> PathBuf {
std::env::temp_dir().join("ull-m105-cancel")
}
/// 递归数 `.ullpart` 家族(中间文件 + 续传元数据)的总字节。
///
/// 目录很小(只有本次安装写的那几层),所以裸递归够用;读不动的一律当 0
/// (量的是趋势,不是精确值)。
fn part_bytes(dir: &Path) -> u64 {
let Ok(entries) = std::fs::read_dir(dir) else {
return 0;
};
let mut total = 0;
for entry in entries.flatten() {
let path = entry.path();
let Ok(meta) = entry.metadata() else {
continue;
};
if meta.is_dir() {
total += part_bytes(&path);
} else if let Some(name) = path.file_name().and_then(|name| name.to_str()) {
// 中间文件 `<name>.ullpart[-<pid>-<seq>]` 与它的元数据 `.ullmeta.json`
if name.contains(".ullpart") {
total += meta.len();
}
}
}
total
}
/// 一次 tick 后抽干事件,返回本轮的全部事件。
fn pump(host: &mut CoreHost, wait: Duration) -> Vec<AppEvent> {
host.tick(wait);
host.drain_events()
}
/// 事件里的安装进度(别的变体一概忽略)。
fn progress(event: &AppEvent) -> Option<&crate::dto::InstallProgressView> {
match event {
AppEvent::Core(CoreEvent::InstallProgress(Some(progress))) => Some(progress),
_ => None,
}
}
/// **实测主用例**:真起一次安装 → 取消 → 量取消之后还在发生什么。
///
/// 版本用环境变量 `ULL_CANCEL_VERSION` 覆盖(默认 `1.20.1`:文件多、总量够大,
/// 取消点之后还有一大截没下完,于是「取消后还在跑」一眼可见)。
#[test]
#[ignore = "真网络:真起一次安装再取消(需要 ULL_CANCEL_VERSION 指定的版本可下载)"]
fn real_install_cancel_stops_progress_and_leaves_no_half_product() {
let version = std::env::var("ULL_CANCEL_VERSION").unwrap_or_else(|_| "1.20.1".to_string());
let root = root();
std::fs::remove_dir_all(&root).ok();
let env = HostEnv::at_root(&root);
let game = env.game.root().to_path_buf();
let mut host = CoreHost::headless(env);
// ---- 起点:取消之前 ----
host.dispatch(AppCommand::InstallVersion(version.clone()));
let started = Instant::now();
let mut before_cancel_progress = 0_usize;
let mut done_at_cancel = 0_u64;
// 等到「真在下载」(files_done ≥ 2)再取消:取消得太早会落在 Planning/解析阶段,
// 那种取消本来就只是阶段边界停,证明不了下载中取消的行为。
while started.elapsed() < Duration::from_secs(180) {
for event in pump(&mut host, Duration::from_millis(100)) {
if let Some(progress) = progress(&event) {
before_cancel_progress += 1;
done_at_cancel = done_at_cancel.max(progress.files_done);
}
}
if done_at_cancel >= 2 {
break;
}
}
assert!(
done_at_cancel >= 2,
"180 s 内没进到下载阶段(files_done={done_at_cancel}):网络或版本号有问题,先让这条能跑起来"
);
let parts_at_cancel = part_bytes(&game);
// ---- 取消 ----
host.dispatch(AppCommand::CancelInstall);
let cancelled = Instant::now();
let mut after: Vec<(f32, u64, InstallStage, u64)> = Vec::new();
for event in host.drain_events() {
if let Some(progress) = progress(&event) {
after.push((
cancelled.elapsed().as_secs_f32(),
progress.files_done,
progress.stage,
part_bytes(&game),
));
}
}
// ---- 取消之后 20 s:还会不会被喂进度、断点文件还会不会长 ----
//
// 每秒采一次 `.ullpart` 总字节:判据不是「取消那一刻的瞬时值」,而是**它在 5 s 之后
// 不再变高**——在飞的那个文件本来就要多活一个数据块(取消延迟的定义),
// 5 s 是给它留的余量(远超一个数据块)。
let settle = Duration::from_secs(5);
let mut latest = None;
let mut samples: Vec<(f32, u64)> = Vec::new();
let mut next_sample = Duration::from_secs(1);
while cancelled.elapsed() < Duration::from_secs(20) {
for event in pump(&mut host, Duration::from_millis(100)) {
if let Some(progress) = progress(&event) {
latest = Some(progress.clone());
after.push((
cancelled.elapsed().as_secs_f32(),
progress.files_done,
progress.stage,
part_bytes(&game),
));
}
}
let elapsed = cancelled.elapsed();
if elapsed >= next_sample {
samples.push((elapsed.as_secs_f32(), part_bytes(&game)));
next_sample += Duration::from_secs(1);
}
std::thread::sleep(Duration::from_millis(20));
}
let parts_after = part_bytes(&game);
let done_after = latest
.as_ref()
.map_or(done_at_cancel, |view| view.files_done);
// ---- 取证:日志行 ----
eprintln!("[cancel-test] root={}", root.display());
eprintln!(
"[cancel-test] 取消前:进度事件 {before_cancel_progress} 条,files_done={done_at_cancel},.ullpart 合计 {parts_at_cancel} 字节"
);
eprintln!(
"[cancel-test] 取消后 20 s:进度事件 {} 条,files_done={done_after}(+{} 个文件),.ullpart 合计 {parts_after} 字节({:+})",
after.len(),
done_after.saturating_sub(done_at_cancel),
i64::try_from(parts_after).unwrap_or(i64::MAX) - i64::try_from(parts_at_cancel).unwrap_or(i64::MAX)
);
for (at, parts) in &samples {
eprintln!("[cancel-test] t={at:>5.1}s ullpart={parts}");
}
for (index, (at, done, stage, parts)) in after.iter().enumerate().take(12) {
eprintln!(
"[cancel-test] #{index} +{at:.2}s files_done={done} stage={stage:?} ullpart={parts}"
);
}
if after.len() > 12 {
eprintln!("[cancel-test] …(另有 {} 条)", after.len() - 12);
}
// ---- 断点文件 / 临时目录 / 成品三样 ----
// 版本 JSON 只在「全量就绪」才落盘(`execute` 的 complete 判定),取消后不该有成品;
// 实例登记在最后一步之后,取消后不该多出实例。
let version_json = game
.join("versions")
.join(&version)
.join(format!("{version}.json"));
eprintln!(
"[cancel-test] 版本清单 {} / 实例目录 {}",
if version_json.is_file() {
"已落盘"
} else {
"未落盘"
},
game.join("instances").is_dir()
);
// ---- 判据(修好之后必须成立的三条) ----
assert!(
after.is_empty(),
"取消之后还在被喂进度事件({} 条):面板会被重新点亮 = 用户看到的「点了没反应」",
after.len()
);
let settled = samples
.iter()
.find(|(at, _)| Duration::from_secs_f32(*at) >= settle)
.map(|(_, parts)| *parts)
.unwrap_or(parts_at_cancel);
let grew = samples
.iter()
.filter(|(at, _)| Duration::from_secs_f32(*at) >= settle)
.map(|(_, parts)| *parts)
.max()
.map_or(0, |peak| peak.saturating_sub(settled));
assert_eq!(
grew, 0,
"取消 {settle:?} 之后断点文件还在长(+{grew} 字节):下载没有真的停"
);
assert!(
!version_json.is_file(),
"取消之后仍然落了版本清单:半成品被记成「已安装」"
);
std::fs::remove_dir_all(&root).ok();
}
// --------------------------------------------------------------- CI 可跑的守门
/// 一条安装进度快照(够画面板就行)。
fn progress_snapshot(files_done: u64) -> InstallProgressView {
InstallProgressView {
version: "1.20.1".to_string(),
stage: InstallStage::Downloading,
files_done,
files_total: 512,
..InstallProgressView::new()
}
}
/// **「点了取消没反应」的真根因**:取消之后旧任务的进度事件还在往回灌。
///
/// 现场:用户点「取消安装」→ host 收下取消、清 `install`、发 `InstallProgress(None)`(面板回弹),
/// 但**后台线程还在跑**(core 的下载段不是瞬停的),它每下完一个文件就发一条
/// `HostTask::Install`。没有代次的话这条事件照样被翻译成 `InstallProgress(Some(..))`,
/// 面板立刻又被点亮 —— 用户看到的就是「取消按钮点了没反应」。
///
/// 抓得住:代次不符的 `Install` / `InstallDone` 被丢掉(面板不复燃、也不清掉新一轮的取消句柄)。
/// 抓不住:真网络的取消延迟(那条在 `real_install_cancel_*`,`#[ignore]` 守着要手动跑)。
#[test]
fn progress_from_a_cancelled_job_is_dropped() {
let dir = std::env::temp_dir().join(format!("ull-cancel-epoch-{}", std::process::id()));
let _ = std::fs::remove_dir_all(&dir);
let mut host = CoreHost::headless(HostEnv::at_root(&dir));
// 开工:拿当代次
let epoch = host.next_install_epoch();
host.handle(HostTask::Install {
progress: Box::new(progress_snapshot(3)),
epoch,
});
let live: Vec<AppEvent> = host.drain_events();
assert!(
live.iter()
.any(|event| matches!(event, AppEvent::Core(CoreEvent::InstallProgress(Some(_))))),
"当代次的事件必须照常点亮面板"
);
// 取消
host.dispatch(AppCommand::CancelInstall);
let cancelled: Vec<AppEvent> = host.drain_events();
assert!(
cancelled
.iter()
.any(|event| matches!(event, AppEvent::Core(CoreEvent::InstallProgress(None)))),
"取消要立刻把面板收回(不等后台)"
);
assert!(
!cancelled
.iter()
.any(|event| matches!(event, AppEvent::Core(CoreEvent::InstallProgress(Some(_))))),
"取消本身不该重新点亮面板"
);
// 旧任务继续发进度(现场就是这样)——必须被丢掉
host.handle(HostTask::Install {
progress: Box::new(progress_snapshot(4)),
epoch,
});
host.handle(HostTask::InstallDone {
progress: Box::new(progress_snapshot(512)),
result: Err("已取消".to_string()),
epoch,
});
let after: Vec<AppEvent> = host.drain_events();
assert!(
after.is_empty(),
"取消之后旧任务的事件必须一条都不出(实际 {} 条):出了就会把面板重新点亮",
after.len()
);
// 新一轮安装的代次是新的:它的进度照常生效
let fresh = host.next_install_epoch();
assert_ne!(fresh, epoch, "新一轮开工必须换代次");
host.handle(HostTask::Install {
progress: Box::new(progress_snapshot(1)),
epoch: fresh,
});
assert!(
host.drain_events()
.iter()
.any(|event| matches!(event, AppEvent::Core(CoreEvent::InstallProgress(Some(_))))),
"新一轮的进度要能点亮面板(不能把代次守卫写成「一律丢弃」)"
);
std::fs::remove_dir_all(&dir).ok();
}
+20 -4
View File
@@ -6,7 +6,7 @@ use crate::dto::{AppCommand, Backend, CoreEvent, CreateRequest, LoaderKind};
use crate::toast::ToastKind;
use super::accounts::{self, LoginJob};
use super::{game, install, java, launch, logs, settings, versions, CoreHost};
use super::{game, install, java, launch, loader_versions, logs, settings, versions, CoreHost};
impl CoreHost {
/// 下发一条用户意图(`Backend::dispatch` 的实现体)。
@@ -28,9 +28,13 @@ impl CoreHost {
None => self.toast(ToastKind::Warn, "这个实例当前没有在跑"),
},
AppCommand::ListVersions(_) => versions::spawn_list(self.env.clone(), self.tx.clone()),
AppCommand::ListLoaderVersions { kind, mc_version } => {
loader_versions::spawn_list(self.env.clone(), self.tx.clone(), kind, mc_version);
}
AppCommand::InstallVersion(version) => {
let cancel = std::sync::Arc::new(std::sync::atomic::AtomicBool::new(false));
self.install_cancel = Some(std::sync::Arc::clone(&cancel));
let epoch = self.next_install_epoch();
install::spawn_install(
self.env.clone(),
self.tx.clone(),
@@ -41,21 +45,33 @@ impl CoreHost {
loader_version: String::new(),
},
cancel,
epoch,
);
}
AppCommand::CreateInstance(request) => {
let cancel = std::sync::Arc::new(std::sync::atomic::AtomicBool::new(false));
self.install_cancel = Some(std::sync::Arc::clone(&cancel));
install::spawn_install(self.env.clone(), self.tx.clone(), request, cancel);
let epoch = self.next_install_epoch();
install::spawn_install(self.env.clone(), self.tx.clone(), request, cancel, epoch);
}
AppCommand::CancelInstall => {
// 取消只在阶段边界生效(core 的下载循环没有取消钩子):这里先把面板收回,
// 后台线程会在下一阶段开始前看到标记并收尾。
// 取消的三级语义(M105 实测后定稿,见 `install::CANCELLED`):
// ① **面板立刻收回**(不等后台,用户点了就有反应);
// ② **作废旧任务的代次**:后台线程是异步停的(取消延迟 = 一个数据块),
// 它带回来的进度事件一律因代次不符被 `handle` 丢掉——面板不会被重新点亮。
// 这是「点了没反应」的真根因:以前生效了又被旧事件盖回去;
// ③ 后台线程经 `install::run` 的取消检查停在段边界、**绝不登记实例**,
// core 的 `execute_with_cancel` 还会就地掐断在飞的那个文件。
//
// 为什么不在这里 join 后台线程:UI 线程绝不能为了「等它停」而阻塞
// (一个数据块的延迟在人眼下就是「立刻」,但足以让 UI 卡住一帧以上)。
if let Some(cancel) = &self.install_cancel {
cancel.store(true, std::sync::atomic::Ordering::SeqCst);
}
self.install_epoch = self.install_epoch.wrapping_add(1);
self.install = None;
self.send(CoreEvent::InstallProgress(None));
self.toast(ToastKind::Info, install::CANCELLED);
}
AppCommand::SetIsolation { id, mode } => {
match game::set_isolation(&self.env, &id, &mode) {
+36 -2
View File
@@ -15,11 +15,45 @@ impl CoreHost {
HostTask::Versions(Err(reason)) => {
self.toast(ToastKind::Warn, format!("拉取版本清单失败:{reason}"));
}
HostTask::Install(progress) => {
HostTask::LoaderVersions {
kind,
mc_version,
result,
} => {
// 失败既要落进快照(页面禁用确认 + 显示具名原因),也要一条 Toast:
// 用户可能正盯着上面的版本列表,下拉那一行的红字容易被忽略。
if let Err(reason) = &result {
self.toast(
ToastKind::Warn,
format!("取不到 {} 的加载器版本:{reason}", kind.label()),
);
}
self.send(CoreEvent::LoaderVersions {
kind,
mc_version,
result,
});
}
HostTask::Install { progress, epoch } => {
// 旧任务(已取消 / 被下一轮顶掉)的进度一律丢掉:这是「点了取消没反应」的根因。
// 取消时 `InstallProgress(None)` 刚把面板收回,旧任务的下一条「下载中」事件
// 立刻又把它点亮,用户看到的就永远是那块还在涨的进度条。
if epoch != self.install_epoch {
return;
}
self.install = Some(*progress.clone());
self.send(CoreEvent::InstallProgress(Some(*progress)));
}
HostTask::InstallDone { progress, result } => {
HostTask::InstallDone {
progress,
result,
epoch,
} => {
// 收尾同样看代次:取消之后那次「已取消」的收尾不该再动面板(面板早就回弹了),
// 也不该清掉**新一轮**安装的取消句柄。
if epoch != self.install_epoch {
return;
}
self.install_cancel = None;
self.install = Some(*progress.clone());
self.send(CoreEvent::InstallProgress(Some(*progress)));
+57 -167
View File
@@ -14,31 +14,32 @@ use std::path::PathBuf;
use std::sync::atomic::{AtomicBool, Ordering};
use std::sync::Arc;
use unlucky_core::addon::loader::{
LoaderInstallPlan, LoaderKind as CoreLoaderKind, LoaderPlanInput, LoaderSource,
};
use unlucky_core::download::blocking::block_on;
use unlucky_core::download::cache::now_ms;
use unlucky_core::download::DownloadEngine;
use unlucky_core::game::arguments::Environment;
use unlucky_core::game::install::{
execute, InstallError, InstallPlan, InstallReport, PlanInput, RemoteSource,
};
use unlucky_core::game::install::{InstallError, InstallReport};
use crate::dto::{CreateRequest, InstallStage, LoaderKind};
use crate::toast::{Toast, ToastKind};
use super::env::HostEnv;
use super::install_journal::Journal;
use super::install_processors::{self, StageInput};
use super::install_processors;
use super::job::{spawn, HostTask, JobSender};
use super::meter::{sink_for, Meter};
use super::meter::Meter;
mod routes;
use routes::{install_loader, install_vanilla};
/// 文件级并发上限(与 CLI 同值:16 路压满带宽又不至于打爆镜像)。
pub const CONCURRENCY: usize = 16;
/// 用户取消的稳定文案(阶段边界生效)。
pub const CANCELLED: &str = "已取消(阶段边界停下;已下载的文件保留,重装会续用)";
/// 用户取消的稳定文案。
///
/// 三件事一句话说清(D21 的口径:半成品不许冒充成品,断点材料不留在半截状态):
/// ① 怎么停的(`execute_with_cancel` 不再起新文件,在飞的那个就地掐断);
/// ② 什么被留着(**已经下完**的文件,重装续用);
/// ③ 什么一定没发生(实例未登记、版本清单没落盘;在飞文件的 `.ullpart` 由 `PartFile::Drop` 清掉)。
pub const CANCELLED: &str =
"已取消:剩下的文件没有开始下载,已下好的文件保留(重装续用),实例未登记";
/// 一次安装任务的运行上下文(后台线程内一路传下去,免得每个函数排七八个参数)。
struct Job<'a> {
@@ -93,9 +94,18 @@ pub fn unsupported_reason(kind: LoaderKind) -> String {
}
/// 后台安装(向导提交 / 下载页行内安装共用)。
pub fn spawn_install(env: HostEnv, tx: JobSender, request: CreateRequest, cancel: Arc<AtomicBool>) {
///
/// `epoch` 是本次任务的代次([`super::CoreHost`] 的 `install_epoch`):它随每条进度回流,
/// 让 host 丢掉「已被取消 / 被下一轮顶掉」的旧任务的后续事件。
pub fn spawn_install(
env: HostEnv,
tx: JobSender,
request: CreateRequest,
cancel: Arc<AtomicBool>,
epoch: u64,
) {
spawn("install", move || {
let meter = Arc::new(std::sync::Mutex::new(Meter::new(&request)));
let meter = Arc::new(std::sync::Mutex::new(Meter::new(&request, epoch)));
let journal = Journal::open(&env);
journal.line(&format!(
"—— 开始安装 {}({} {})——",
@@ -114,7 +124,7 @@ pub fn spawn_install(env: HostEnv, tx: JobSender, request: CreateRequest, cancel
let mut progress = meter
.lock()
.map(|guard| guard.progress.clone())
.unwrap_or_else(|_| Meter::new(&request).progress);
.unwrap_or_else(|_| Meter::new(&request, epoch).progress);
match result {
Ok(name) => {
journal.line(&format!("完成:实例 {name} 已登记"));
@@ -124,6 +134,7 @@ pub fn spawn_install(env: HostEnv, tx: JobSender, request: CreateRequest, cancel
let _ = tx.send(HostTask::InstallDone {
progress: Box::new(progress),
result: Ok(name),
epoch,
});
let _ = tx.send(HostTask::Toast(Box::new(Toast {
id: 0,
@@ -142,6 +153,7 @@ pub fn spawn_install(env: HostEnv, tx: JobSender, request: CreateRequest, cancel
// 失败文案带上日志路径:面板只有一行、Toast 4 秒就消失,
// 装日志是用户事后能自己回看的唯一渠道(进度板之外)。
let text = if cancelled {
journal.line(CANCELLED);
reason
} else {
journal.line(&format!("安装未完成:{reason}"));
@@ -151,6 +163,7 @@ pub fn spawn_install(env: HostEnv, tx: JobSender, request: CreateRequest, cancel
let _ = tx.send(HostTask::InstallDone {
progress: Box::new(progress),
result: Err(text),
epoch,
});
}
}
@@ -171,11 +184,14 @@ fn run(job: &Job<'_>, request: &CreateRequest) -> Result<String, String> {
{
let mut guard = job.meter.lock().map_err(|_| "进度锁失效".to_string())?;
guard.stage(InstallStage::Planning, "正在解析版本清单…");
let _ = job
.tx
.send(HostTask::Install(Box::new(guard.progress.clone())));
let _ = job.tx.send(HostTask::Install {
progress: Box::new(guard.progress.clone()),
epoch: guard.epoch,
});
}
// 段边界检查(M105):`execute_with_cancel` 自己会掐断在飞的文件,这里管的是**段与段之间**
// ——原版段与加载器段、文件段与登记之间,取消都必须在下一段开工前生效。
if job.cancel.load(Ordering::SeqCst) {
return Err(CANCELLED.to_string());
}
@@ -185,12 +201,22 @@ fn run(job: &Job<'_>, request: &CreateRequest) -> Result<String, String> {
install_loader(job, &engine, request)?
};
// **取消之后绝不登记实例**(M105):文件段已经在跑了,下完那一刻用户可能早已点了取消;
// 这里不拦的话,取消会留下一个「用户以为没装、其实已经装好并登记」的实例——
// 那正是「半成品污染」里最难解释的一种(列表里凭空多一条)。
if job.cancel.load(Ordering::SeqCst) {
job.journal
.line("已取消:文件段跑完但用户已取消,不登记实例(版本清单是否落盘见上)");
return Err(CANCELLED.to_string());
}
{
let mut guard = job.meter.lock().map_err(|_| "进度锁失效".to_string())?;
guard.stage(InstallStage::Registering, "正在登记实例…");
let _ = job
.tx
.send(HostTask::Install(Box::new(guard.progress.clone())));
let _ = job.tx.send(HostTask::Install {
progress: Box::new(guard.progress.clone()),
epoch: guard.epoch,
});
}
let created_at =
unlucky_core::launch::time::format_rfc3339_millis(unlucky_core::launch::time::now());
@@ -204,152 +230,16 @@ fn run(job: &Job<'_>, request: &CreateRequest) -> Result<String, String> {
Ok(name)
}
/// 原版安装(`resolve → plan → [prefetch 资源索引] → execute`)。
fn install_vanilla(
job: &Job<'_>,
engine: &DownloadEngine,
request: &CreateRequest,
) -> Result<String, String> {
let env = job.env;
let version = request.version.trim();
let meta_cache = env.layout.meta_cache();
let now = now_ms();
let sink = sink_for(job.tx.clone(), Arc::clone(job.meter));
block_on(async {
let source = RemoteSource::new(engine, &env.game, &meta_cache, now);
let resolved = source.resolve(version).await.map_err(install_error)?;
let fetched = match resolved
.asset_index
.as_ref()
.filter(|index| index.url.is_some())
{
Some(reference) => {
let (index, bytes) = source.asset_index(reference).await.map_err(install_error)?;
Some((index, env.game.asset_index(&reference.id), bytes))
}
None => None,
};
let mut plan = InstallPlan::build(PlanInput {
layout: &env.game,
version_id: version,
resolved: &resolved,
asset_index: fetched.as_ref().map(|(index, _, _)| index),
environment: &Environment::host(),
})
.map_err(|error| error.to_string())?;
if let Some((_, dest, bytes)) = fetched {
plan.prefetch(dest, bytes);
}
if !plan.is_installable() {
return Err(format!(
"版本 {version} 装不全:{}",
plan.warnings.join(";")
));
}
let (bytes_total, _) = plan.total_bytes();
{
let mut guard = job.meter.lock().map_err(|_| "进度锁失效".to_string())?;
guard.progress.files_total = u64::try_from(plan.file_count()).unwrap_or(u64::MAX);
guard.progress.bytes_total = bytes_total;
guard.stage(
InstallStage::Downloading,
&format!("开始下载 {} 个文件…", plan.file_count()),
);
}
if job.cancel.load(Ordering::SeqCst) {
return Err(CANCELLED.to_string());
}
let report = execute(engine, &plan, CONCURRENCY, Some(sink))
.await
.map_err(install_error)?;
ensure_complete(&report)?;
Ok::<String, String>(version.to_string())
})
}
/// 加载器安装(原版前置 → installer processors → 加载器库 → 版本 JSON 落盘)。
fn install_loader(
job: &Job<'_>,
engine: &DownloadEngine,
request: &CreateRequest,
) -> Result<String, String> {
let env = job.env;
let version = request.version.trim();
let kind = CoreLoaderKind::parse(request.loader.as_str())
.ok_or_else(|| format!("未知加载器 `{}`", request.loader.as_str()))?;
let meta_cache = env.layout.meta_cache();
let loader_version = request.loader_version.trim().to_string();
let explicit = (!loader_version.is_empty()).then_some(loader_version.as_str());
let release = block_on(async {
LoaderSource::new(engine, &meta_cache)
.resolve(kind, version, explicit)
.await
})
.map_err(|error| error.to_string())?;
job.journal.line(&format!(
"加载器解析:{} {} → {}",
release.kind.label(),
release.loader_version,
release.version_id
));
let plan = LoaderInstallPlan::build(LoaderPlanInput {
layout: &env.game,
release: &release,
environment: &Environment::host(),
vanilla_installed: env.game.is_version_installed(version),
});
if plan.vanilla_install_needed {
let mut vanilla = request.clone();
vanilla.loader = LoaderKind::Vanilla;
install_vanilla(job, engine, &vanilla)?;
}
// 两段(加载器库 + 处理器依赖库)在动手前一次预记账:进度条只走一条单调曲线,
// 处理器依赖库下完不会先满格、再在加载器库开始时回落到一半。
{
let mut guard = job.meter.lock().map_err(|_| "进度锁失效".to_string())?;
let (bytes, _) = plan.install.total_bytes();
guard.expect(plan.files().len(), bytes);
}
// Forge/NeoForge:installer processors 必须先跑完,`execute` 才允许写版本 JSON。
if release.requires_installer() {
let input = StageInput {
kind: release.kind,
mc_version: &release.mc_version,
version_id: &release.version_id,
profile: release.install_profile.as_ref(),
installer: release.installer.as_deref(),
installed: env.game.is_version_installed(&release.version_id),
};
// `None` = 这一版不需要跑处理器(版本 JSON 已在盘上 / profile 没有 client 侧步骤),
// 进度与日志都由处理器段自己写全,这里只消费返回值。
let _ = install_processors::stage(
env,
engine,
&input,
&install_processors::CORE,
&job.reporter(),
job.cancel,
)?;
}
{
let mut guard = job.meter.lock().map_err(|_| "进度锁失效".to_string())?;
guard.stage(
InstallStage::Downloading,
&format!("开始下载加载器库({} 个文件)…", plan.files().len()),
);
}
/// 安装错误 → 用户可读文案(**取消不算失败**:给那句稳定文案,不给「失败 + 日志路径」)。
///
/// 判据用 job 自己的取消标志而不是错误大类:core 的 `execute_with_cancel` 只在阶段边界与
/// 每个文件开工前看标志,取消与「最后一个文件刚好失败」可能同时成立——那种情况下用户点了取消,
/// 文案就该说取消(否则他会以为取消导致了失败)。
fn job_error(job: &Job<'_>, error: InstallError) -> String {
if job.cancel.load(Ordering::SeqCst) {
return Err(CANCELLED.to_string());
return CANCELLED.to_string();
}
let sink = sink_for(job.tx.clone(), Arc::clone(job.meter));
let report = block_on(async {
execute(engine, &plan.install, CONCURRENCY, Some(sink))
.await
.map_err(install_error)
})?;
ensure_complete(&report)?;
Ok(release.version_id)
install_error(error)
}
/// 安装错误 → 用户可读文案。
+183
View File
@@ -0,0 +1,183 @@
//! 两条安装路线(原版 / 加载器)——M105 从 `install.rs` 搬出,守 400 行硬线。
//!
//! 搬移是**纯搬移**:函数体一行没改,只多了本文件自己的 `use`。
//! 父模块(`install`)的私有项对子模块可见,所以 `Job` / `CANCELLED` / `job_error` /
//! `ensure_complete` / `sink_for` 一律不重新导出,直接用。
use std::sync::atomic::Ordering;
use std::sync::Arc;
use unlucky_core::addon::loader::{
LoaderInstallPlan, LoaderKind as CoreLoaderKind, LoaderPlanInput, LoaderSource,
};
use unlucky_core::download::blocking::block_on;
use unlucky_core::download::cache::now_ms;
use unlucky_core::download::DownloadEngine;
use unlucky_core::game::arguments::Environment;
use unlucky_core::game::install::{execute_with_cancel, InstallPlan, PlanInput, RemoteSource};
use crate::dto::{CreateRequest, InstallStage, LoaderKind};
use super::super::install_processors::{self, StageInput};
use super::super::meter::sink_for;
use super::{ensure_complete, install_error, job_error, Job, CANCELLED, CONCURRENCY};
/// 原版安装(`resolve → plan → [prefetch 资源索引] → execute`)。
pub(super) fn install_vanilla(
job: &Job<'_>,
engine: &DownloadEngine,
request: &CreateRequest,
) -> Result<String, String> {
let env = job.env;
let version = request.version.trim();
let meta_cache = env.layout.meta_cache();
let now = now_ms();
let sink = sink_for(job.tx.clone(), Arc::clone(job.meter));
block_on(async {
let source = RemoteSource::new(engine, &env.game, &meta_cache, now);
let resolved = source.resolve(version).await.map_err(install_error)?;
let fetched = match resolved
.asset_index
.as_ref()
.filter(|index| index.url.is_some())
{
Some(reference) => {
let (index, bytes) = source.asset_index(reference).await.map_err(install_error)?;
Some((index, env.game.asset_index(&reference.id), bytes))
}
None => None,
};
let mut plan = InstallPlan::build(PlanInput {
layout: &env.game,
version_id: version,
resolved: &resolved,
asset_index: fetched.as_ref().map(|(index, _, _)| index),
environment: &Environment::host(),
})
.map_err(|error| error.to_string())?;
if let Some((_, dest, bytes)) = fetched {
plan.prefetch(dest, bytes);
}
if !plan.is_installable() {
return Err(format!(
"版本 {version} 装不全:{}",
plan.warnings.join(";")
));
}
let (bytes_total, _) = plan.total_bytes();
{
let mut guard = job.meter.lock().map_err(|_| "进度锁失效".to_string())?;
guard.progress.files_total = u64::try_from(plan.file_count()).unwrap_or(u64::MAX);
guard.progress.bytes_total = bytes_total;
guard.stage(
InstallStage::Downloading,
&format!("开始下载 {} 个文件…", plan.file_count()),
);
}
if job.cancel.load(Ordering::SeqCst) {
return Err(CANCELLED.to_string());
}
let report = execute_with_cancel(
engine,
&plan,
CONCURRENCY,
Some(sink),
Some(job.cancel.as_ref()),
)
.await
.map_err(|error| job_error(job, error))?;
ensure_complete(&report)?;
Ok::<String, String>(version.to_string())
})
}
/// 加载器安装(原版前置 → installer processors → 加载器库 → 版本 JSON 落盘)。
pub(super) fn install_loader(
job: &Job<'_>,
engine: &DownloadEngine,
request: &CreateRequest,
) -> Result<String, String> {
let env = job.env;
let version = request.version.trim();
let kind = CoreLoaderKind::parse(request.loader.as_str())
.ok_or_else(|| format!("未知加载器 `{}`", request.loader.as_str()))?;
let meta_cache = env.layout.meta_cache();
let loader_version = request.loader_version.trim().to_string();
let explicit = (!loader_version.is_empty()).then_some(loader_version.as_str());
let release = block_on(async {
LoaderSource::new(engine, &meta_cache)
.resolve(kind, version, explicit)
.await
})
.map_err(|error| error.to_string())?;
job.journal.line(&format!(
"加载器解析:{} {} → {}",
release.kind.label(),
release.loader_version,
release.version_id
));
let plan = LoaderInstallPlan::build(LoaderPlanInput {
layout: &env.game,
release: &release,
environment: &Environment::host(),
vanilla_installed: env.game.is_version_installed(version),
});
if plan.vanilla_install_needed {
let mut vanilla = request.clone();
vanilla.loader = LoaderKind::Vanilla;
install_vanilla(job, engine, &vanilla)?;
}
// 两段(加载器库 + 处理器依赖库)在动手前一次预记账:进度条只走一条单调曲线,
// 处理器依赖库下完不会先满格、再在加载器库开始时回落到一半。
{
let mut guard = job.meter.lock().map_err(|_| "进度锁失效".to_string())?;
let (bytes, _) = plan.install.total_bytes();
guard.expect(plan.files().len(), bytes);
}
// Forge/NeoForge:installer processors 必须先跑完,`execute` 才允许写版本 JSON。
if release.requires_installer() {
let input = StageInput {
kind: release.kind,
mc_version: &release.mc_version,
version_id: &release.version_id,
profile: release.install_profile.as_ref(),
installer: release.installer.as_deref(),
installed: env.game.is_version_installed(&release.version_id),
};
// `None` = 这一版不需要跑处理器(版本 JSON 已在盘上 / profile 没有 client 侧步骤),
// 进度与日志都由处理器段自己写全,这里只消费返回值。
let _ = install_processors::stage(
env,
engine,
&input,
&install_processors::CORE,
&job.reporter(),
job.cancel,
)?;
}
{
let mut guard = job.meter.lock().map_err(|_| "进度锁失效".to_string())?;
guard.stage(
InstallStage::Downloading,
&format!("开始下载加载器库({} 个文件)…", plan.files().len()),
);
}
if job.cancel.load(Ordering::SeqCst) {
return Err(CANCELLED.to_string());
}
let sink = sink_for(job.tx.clone(), Arc::clone(job.meter));
let report = block_on(async {
execute_with_cancel(
engine,
&plan.install,
CONCURRENCY,
Some(sink),
Some(job.cancel.as_ref()),
)
.await
})
.map_err(|error| job_error(job, error))?;
ensure_complete(&report)?;
Ok(release.version_id)
}
@@ -136,9 +136,10 @@ impl Reporter<'_> {
return;
};
guard.stage(stage, message);
let _ = self
.tx
.send(HostTask::Install(Box::new(guard.progress.clone())));
let _ = self.tx.send(HostTask::Install {
progress: Box::new(guard.progress.clone()),
epoch: guard.epoch,
});
}
/// 先把待下的库记账(文件数 + 已知字节),下载回调再逐个累加。
@@ -282,7 +283,10 @@ fn step_sink(tx: JobSender, meter: Arc<Mutex<Meter>>, journal: Journal, total: u
return;
};
guard.stage(InstallStage::Installing, &line);
let _ = tx.send(HostTask::Install(Box::new(guard.progress.clone())));
let _ = tx.send(HostTask::Install {
progress: Box::new(guard.progress.clone()),
epoch: guard.epoch,
});
})
}
@@ -60,7 +60,7 @@ impl Harness {
let (tx, rx) = channel();
Self {
journal: Journal::open(&env),
meter: Arc::new(Mutex::new(Meter::new(&request))),
meter: Arc::new(Mutex::new(Meter::new(&request, 1))),
cancel: Arc::new(AtomicBool::new(false)),
dir,
env,
@@ -83,7 +83,7 @@ impl Harness {
self.rx
.try_iter()
.filter_map(|task| match task {
HostTask::Install(progress) => Some(progress.message.clone()),
HostTask::Install { progress, .. } => Some(progress.message.clone()),
_ => None,
})
.collect()
+3 -3
View File
@@ -37,7 +37,7 @@ impl Fixture {
dir,
env,
tx: channel().0,
meter: Arc::new(Mutex::new(Meter::new(request))),
meter: Arc::new(Mutex::new(Meter::new(request, 1))),
cancel: Arc::new(AtomicBool::new(false)),
journal,
}
@@ -87,7 +87,7 @@ fn progress_is_pre_accounted_across_segments_so_the_bar_never_snaps_to_full() {
// M45 r1 P2-2 的回归:处理器依赖库下完那一刻,面板曾显示 36/36 满格 + 3.4MB/10MB,
// 之后加载器库的 29 个文件才被计入 → 进度条从 100% 回落到 55% 再涨回去。
let request = request(LoaderKind::Forge, "1.20.1");
let mut meter = Meter::new(&request);
let mut meter = Meter::new(&request, 1);
// 原版段:30 个文件全下完(install_vanilla 对总量是赋值,不是累加)
meter.progress.files_total = 30;
@@ -175,7 +175,7 @@ fn meter_counts_files_and_skips_skipped_bytes() {
loader_version: "0.16.5".to_string(),
name: "生存".to_string(),
};
let mut meter = Meter::new(&request);
let mut meter = Meter::new(&request, 1);
assert_eq!(meter.progress.loader, "Fabric 0.16.5");
assert_eq!(meter.progress.instance, "生存");
meter.progress.files_total = 2;
+23 -3
View File
@@ -8,8 +8,8 @@ use std::sync::mpsc::{Receiver, Sender};
use crate::dto::{
AccountView, DeviceLoginView, DiagnosisReport, InstallProgressView, InstanceId,
InstanceRuntime, JavaPageView, LaunchFinished, LiveLogBatch, LogLine, LogOutcome, LogSession,
NoticeView, SessionId, VersionSummary,
InstanceRuntime, JavaPageView, LaunchFinished, LiveLogBatch, LoaderKind, LogLine, LogOutcome,
LogSession, NoticeView, SessionId, VersionSummary,
};
use crate::toast::Toast;
@@ -18,14 +18,34 @@ use crate::toast::Toast;
pub enum HostTask {
/// 版本清单(下载页)
Versions(Result<Vec<VersionSummary>, String>),
/// 加载器版本清单(下载页「安装选项」的下拉)
LoaderVersions {
/// 加载器种类
kind: LoaderKind,
/// 目标原版版本(缓存键的一部分,回传原样)
mc_version: String,
/// `Ok(最新在前)` / `Err(人读原因)`
result: Result<Vec<String>, String>,
},
/// 安装进度(高频,host 只做聚合与转发)
Install(Box<InstallProgressView>),
Install {
/// 进度快照
progress: Box<InstallProgressView>,
/// 任务代次([`super::CoreHost`] 的 `install_epoch`)
///
/// 取消/重新开工都会把代次 +1,于是**旧任务还在飞的事件**带着旧代次回来,
/// host 一眼就能认出来并丢掉。没有这一层的话:取消后 `InstallProgress(None)` 刚把面板
/// 收回,下一条「下载中」事件立刻把它点亮——用户看到的就是「点了取消没反应」(M105 实测)。
epoch: u64,
},
/// 安装收尾(成功带实例名,失败带文案)
InstallDone {
/// 最终进度快照
progress: Box<InstallProgressView>,
/// 成功时为 `Ok(实例名)`
result: Result<String, String>,
/// 任务代次(语义同 [`HostTask::Install`] 的 `epoch`)
epoch: u64,
},
/// 账户列表
Accounts(Vec<AccountView>),
@@ -0,0 +1,120 @@
//! 加载器版本清单(下载页「安装选项」的版本下拉,M105)。
//!
//! ## 为什么要有这一支
//!
//! core 早就有现成能力:[`unlucky_core::addon::loader::LoaderSource::loader_versions`] 按
//! `(加载器, 原版版本)` 给出**官方那份**可用版本表(Fabric/Quilt 走 fabric meta 的 loader 列表,
//! Forge/NeoForge 走 maven 的 `maven-metadata.xml` 再按 `matches_mc` 过滤)。
//! 缺的从来不是能力,是 presenter 到 UI 的那一跳——于是用户在下载页只能装原版,
//! 「自己有的能力不接出来」是 M105 要收的口子。
//!
//! ## 一次查询只回答一个问题
//!
//! 事件里带 `(kind, mc_version)` 原样回传,`state.rs` 拿它当缓存键:**切原版版本 = 换键**,
//! 于是 A 版本的 Fabric 列表不可能挂到 B 版本下面(这条是 M105 复审明确要求的)。
//! 取不到(网络/该组合官方没有版本)走 `Err(人读原因)`,页面据此**禁掉确认**并给具名错误,
//! 绝不静默显示成空列表。
use unlucky_core::addon::loader::{LoaderKind as CoreLoaderKind, LoaderSource};
use unlucky_core::download::blocking::block_on;
use crate::dto::LoaderKind;
use super::env::HostEnv;
use super::job::{spawn, HostTask, JobSender};
/// 拉一份加载器版本列表(网络在后台线程里,UI 不卡)。
pub fn spawn_list(env: HostEnv, tx: JobSender, kind: LoaderKind, mc_version: String) {
spawn("loader-versions", move || {
let result = fetch(&env, kind, &mc_version);
let _ = tx.send(HostTask::LoaderVersions {
kind,
mc_version,
result,
});
});
}
/// 同步拉取(后台线程里跑):DTO 的加载器词表 → core 的加载器词表 → 官方清单。
///
/// 原版(`Vanilla`)没有「加载器版本」这回事,直接给空列表而不是报错:调用方(页面)
/// 在选了原版时根本不画这个下拉,这里是防守。
pub fn fetch(env: &HostEnv, kind: LoaderKind, mc_version: &str) -> Result<Vec<String>, String> {
if kind == LoaderKind::Vanilla {
return Ok(Vec::new());
}
let Some(kind) = CoreLoaderKind::parse(kind.as_str()) else {
return Err(format!("未知加载器 `{}`", kind.as_str()));
};
if mc_version.trim().is_empty() {
return Err("没有选择原版版本".to_string());
}
let engine = super::engine::engine(env);
let meta_cache = env.layout.meta_cache();
block_on(async {
LoaderSource::new(&engine, &meta_cache)
.loader_versions(kind, mc_version.trim())
.await
})
.map_err(|error| error.to_string())
}
#[cfg(test)]
mod tests {
use super::*;
use crate::dto::{AppEvent, CoreEvent};
use crate::state::AppState;
/// **缓存键必须是 `(加载器, 原版版本)`**(M105 的硬要求,复审点名的那条)。
///
/// 现场:在 1.20.1 上查过 Fabric 的列表,接着点 1.21.9;键里若没有原版版本,1.21.9 会直接
/// 显示 1.20.1 那份列表 —— 用户选了个「1.21.9 上不存在」的加载器版本,直到点安装才失败。
#[test]
fn cache_is_keyed_per_loader_and_minecraft_version() {
let mut state = AppState::new();
state.apply(AppEvent::Core(CoreEvent::LoaderVersions {
kind: LoaderKind::Fabric,
mc_version: "1.20.1".to_string(),
result: Ok(vec!["0.16.5".to_string()]),
}));
assert!(state
.loader_versions_for(LoaderKind::Fabric, "1.20.1")
.is_some());
assert!(state
.loader_versions_for(LoaderKind::Fabric, "1.21.9")
.is_none());
assert!(state
.loader_versions_for(LoaderKind::Quilt, "1.20.1")
.is_none());
// 失败也是「查过了」:页面据此显示具名原因并禁掉确认,不再无限重试
state.apply(AppEvent::Core(CoreEvent::LoaderVersions {
kind: LoaderKind::Quilt,
mc_version: "1.20.1".to_string(),
result: Err("network down".to_string()),
}));
assert!(state
.loader_versions_for(LoaderKind::Quilt, "1.20.1")
.is_some());
}
/// 原版没有加载器版本:给空表而不是报错(页面不画这个下拉,防守而已)。
#[test]
fn vanilla_has_no_loader_versions() {
let dir = std::env::temp_dir().join(format!("ull-loader-versions-{}", std::process::id()));
let env = HostEnv::at_root(&dir);
assert_eq!(fetch(&env, LoaderKind::Vanilla, "1.20.1"), Ok(Vec::new()));
std::fs::remove_dir_all(&dir).ok();
}
/// 空版本号在联网前就被拒(不做无意义的请求,也给出人读原因)。
#[test]
fn empty_mc_version_is_rejected_before_network() {
let dir = std::env::temp_dir().join(format!("ull-loader-empty-{}", std::process::id()));
let env = HostEnv::at_root(&dir);
let err = fetch(&env, LoaderKind::Fabric, " ").unwrap_err();
assert!(err.contains("没有选择原版版本"), "{err}");
std::fs::remove_dir_all(&dir).ok();
}
}
+11 -2
View File
@@ -15,17 +15,23 @@ use super::job::{HostTask, JobSender};
/// 一次安装的上下文(进度回调共享)。
pub(super) struct Meter {
pub(super) progress: InstallProgressView,
/// 任务代次:随每条进度一起回流,让 host 能丢掉「已被取消/被顶掉的旧任务」的事件。
///
/// 记在记账器上而不是每条 `HostTask` 现传:所有发送点都已经持有这把锁并读 `progress`,
/// 于是代次与它描述的那份进度**永远同源**(不会出现「新代次的进度配旧代次的标签」)。
pub(super) epoch: u64,
previous: Option<(u64, Instant)>,
}
impl Meter {
pub(super) fn new(request: &CreateRequest) -> Self {
pub(super) fn new(request: &CreateRequest, epoch: u64) -> Self {
Self {
progress: InstallProgressView::start(
&request.version,
&request.instance_name(),
&loader_label(request.loader, &request.loader_version),
),
epoch,
previous: None,
}
}
@@ -75,6 +81,9 @@ pub(super) fn sink_for(tx: JobSender, meter: Arc<std::sync::Mutex<Meter>>) -> Pr
return;
};
meter.note(outcome);
let _ = tx.send(HostTask::Install(Box::new(meter.progress.clone())));
let _ = tx.send(HostTask::Install {
progress: Box::new(meter.progress.clone()),
epoch: meter.epoch,
});
})
}
+20 -1
View File
@@ -25,6 +25,7 @@ mod install_processors;
mod java;
mod job;
mod launch;
mod loader_versions;
mod logs;
mod meter;
mod opener;
@@ -85,8 +86,14 @@ pub struct CoreHost {
tail: logs::Tail,
/// AI 对话的临时后端(agent GUI host 落地前的占位)
chat: MockBackend,
/// 当前安装任务的取消标记(阶段边界检查)
/// 当前安装任务的取消标记(`execute_with_cancel` 与段边界检查共同消费)
install_cancel: Option<std::sync::Arc<std::sync::atomic::AtomicBool>>,
/// 当前安装任务的代次。
///
/// 开工(`InstallVersion` / `CreateInstance`)与取消都 +1:还在飞的后台线程把事件带回来时
/// 一眼能看出「这是旧任务的」,于是既不会被取消掉的安装重新点亮面板,也不会串到下一轮安装
/// (两轮安装同时存在时,旧任务的事件曾经把新任务的进度条顶掉)。
install_epoch: u64,
}
impl CoreHost {
@@ -129,6 +136,7 @@ impl CoreHost {
tail: logs::Tail::default(),
chat: MockBackend::default(),
install_cancel: None,
install_epoch: 0,
};
if refresh {
host.refresh_all();
@@ -145,6 +153,14 @@ impl CoreHost {
self.events.push_back(AppEvent::Core(event));
}
/// 开一轮安装:代次 +1 并把新代次交出去(后台线程随每条进度带回来)。
///
/// 返回**新**代次而不是旧代次:调用方拿它去 `spawn_install`,于是「谁是新任务」只有一处答案。
fn next_install_epoch(&mut self) -> u64 {
self.install_epoch = self.install_epoch.wrapping_add(1);
self.install_epoch
}
fn toast(&mut self, kind: ToastKind, text: impl Into<String>) {
self.events.push_back(AppEvent::Toast(Toast {
id: 0,
@@ -339,6 +355,9 @@ impl Backend for CoreHost {
}
}
#[cfg(test)]
#[path = "cancel_tests.rs"]
mod cancel_tests;
#[cfg(test)]
#[path = "launch_state_tests.rs"]
mod launch_state_tests;
+39 -2
View File
@@ -7,8 +7,8 @@ use crate::agent::AgentRail;
use crate::dialogs::DialogQueue;
use crate::dto::{
AccountView, AgentEvent, AppEvent, CoreEvent, DeviceLoginView, DiagnosisReport,
InstallProgressView, InstanceRuntime, InstanceSummary, JavaPageView, LogLine, LogSession,
NoticeView, Progress, SettingGroupView, VersionSummary,
InstallProgressView, InstanceRuntime, InstanceSummary, JavaPageView, LoaderKind, LogLine,
LogSession, NoticeView, Progress, SettingGroupView, VersionSummary,
};
use crate::prefs::UiPrefs;
use crate::router::{AiPanelMode, Route, Router};
@@ -39,6 +39,9 @@ pub fn grid_positions(count: usize, columns: usize) -> Vec<(usize, usize)> {
/// 实时日志最多保留的行数(滚动窗口;更多行由日志页的筛选/历史会话承担)。
pub const MAX_LIVE_LINES: usize = 2_000;
/// 一份加载器版本清单查询的结果(`Ok` = 最新在前;`Err` = 人读原因)。
pub type LoaderVersions = Result<Vec<String>, String>;
/// 应用全局状态。
#[derive(Debug)]
pub struct AppState {
@@ -78,6 +81,16 @@ pub struct AppState {
pub java: JavaPageView,
/// 安装进度(None = 没有安装任务)
pub install: Option<InstallProgressView>,
/// 加载器版本清单(下载页「安装选项」的下拉;M105)
///
/// 两段键:外层是加载器的**稳定 id**(`LoaderKind::as_str`,`LoaderKind` 没派生 `Hash`,
/// 而 `as_str` 本来就是它在 CLI/GUI 两边的身份),内层是原版版本。
/// **原版版本进键**,所以切到另一个 MC 版本时拿到的是另一条缓存,
/// 不会把 A 版本的 Fabric 列表挂到 B 版本下面(M105 复审的硬要求)。
/// 值是 `Result`:「取不到」与「官方没有版本」是两件事,前者要在页面上说清原因
/// (并禁掉确认),不许显示成空列表。
pub loader_versions:
std::collections::HashMap<&'static str, std::collections::HashMap<String, LoaderVersions>>,
/// 设置分组(设置页右栏)
pub settings_groups: Vec<SettingGroupView>,
/// 当前选中的设置分组(download / java / data / ai / mcp)
@@ -118,6 +131,7 @@ impl AppState {
device_login: DeviceLoginView::new(),
java: JavaPageView::new(),
install: None,
loader_versions: std::collections::HashMap::new(),
settings_groups: Vec::new(),
settings_tab: "download".to_string(),
notices: Vec::new(),
@@ -126,6 +140,19 @@ impl AppState {
}
}
/// 某 (加载器, 原版版本) 的加载器版本清单。
///
/// `None` = 还没查过(页面据此派一次 `AppCommand::ListLoaderVersions` 并显示「正在获取…」);
/// `Some(Err(..))` = 查过但拿不到(页面显示具名原因并**禁掉确认**)。
#[must_use]
pub fn loader_versions_for(
&self,
kind: LoaderKind,
mc_version: &str,
) -> Option<&LoaderVersions> {
self.loader_versions.get(kind.as_str())?.get(mc_version)
}
/// 当前页面。
pub fn route(&self) -> &Route {
self.router.route()
@@ -219,6 +246,16 @@ impl AppState {
None => self.install = None,
},
CoreEvent::SettingsChanged(groups) => self.settings_groups = groups,
CoreEvent::LoaderVersions {
kind,
mc_version,
result,
} => {
self.loader_versions
.entry(kind.as_str())
.or_default()
.insert(mc_version, result);
}
CoreEvent::NoticesChanged(notices) => self.notices = notices,
}
}