fix(coexist): 复审 r1 返工——帮助文案跟上新落点 + 「替换了清单」进人读通道 + 导入建实例绑到内容目录(M216 P2/P3/§5)

P2-1 ② 改了缺省落点,CLI 自己的文档还在写旧行为
- `cli/help.rs`「目标目录缺省 = 数据根的共享游戏目录(.minecraft/)」→ 新实例目录
  `<数据根>/instances/<实例名>`(并登记实例);
- `cli/model.rs` 的 `PackImportArgs::target` 字段文档同步。
- 用例 `help_describes_the_new_default_target`(断言帮助含新落点、不含旧落点)。

P2-2 ③ 的「显式说明」进不了任何人读通道
- CLI:`human_lines` 原只遍历 `plan.warnings`,而运行期告警(含「已替换版本清单 …旧的那份
  备份在 …」)在 `report.warnings` 里 ⇒ `ull install` 人读输出从没说过这句话。现在有 report 就
  报 report.warnings(它开头就是 plan 告警的副本),`manifest=Replaced` 再单独打一行备份路径。
- GUI:`install.rs` 新增 `Job::journal_report`(把 `report.warnings` 与 `manifest` 的备份路径写进
  安装日志),`install/routes.rs` 两处 `ensure_complete` 之前各加一行调用(tower 批的两行)。
  此前 `report.manifest` 全仓零消费者。
- 用例 `a_replaced_manifest_is_said_out_loud_in_the_human_output`(走真 `InstallPlan` 排版)。

P3-1 缺省目录被占的 hint 删掉不成立的 `--overwrite` 那半句(它绕过不了这条预检)。
P3-2 GUI 落点改成委托 core 的 `pack_dir::instance_dir`(此前 presenter 自己拼 `data()/instances/…`);
`convert::dir_name` 缩成 `#[cfg(test)]` 的委托入口(生产侧已无调用点,留着继续钉归一化判据)。
P3-3 补 `the_default_target_is_a_new_instance_dir_and_the_instance_is_bound_to_it`:不带 `--target`
跑通整条 CLI,断言落点、内容、登记、以及实例设置里的 `isolation`/`gameDir`。

§5 导入建出来的实例原先「导入成功但内容永远不会被启动用到」
- 新增 `pack_dir::bind_instance_dir`(`InstanceConfig.isolation = Custom` + `game_dir = 导入目录`)
  与 `pack_dir::bind_created_instance`(判据+文案,CLI 与 GUI 同一份);
- CLI 在缺省建实例后、GUI 在 `import.rs::run` 里各调一次;只在「我们新建了实例目录且档案是新建」
  时绑(显式 `--target` / `--no-register` / 复用已有档案都不动);
- 运行目录 = 导入目录(saves/mods/logs/config),**versions/libraries/assets 仍按 D20 恒共享**;
- 未改 `derive_game_dir`。
- 用例:正向 `binding_an_imported_instance_points_it_at_the_import_dir`、反向
  `a_freshly_registered_instance_still_inherits_the_global_mode`。
This commit is contained in:
AskaEth committed 2026-11-09 19:46:41 +08:00
1 parent 96f15c79fb
commit 4e1323212b
10 files changed
+359 -45

No files matched your search

+2 -1
View File
@@ -104,7 +104,8 @@ pub fn topic(name: &str) -> Option<&'static str> {
MultiMC mmc-pack.json(formatVersion 必须为 1)+ instance.cfg + .minecraft/
(Prism 实例;非加载器 component 会逐项列进报告,不静默丢)
目标目录缺省 = 数据根的共享游戏目录(.minecraft/);`--target` 可钉到实例目录。
目标目录缺省 = 新实例目录 `<数据根>/instances/<实例名>`(并登记实例,M216 起不再落共享
.minecraft 根);`--target` 可钉到别处(例如某个实例的运行目录)。
两阶段落盘:先 overrides(三方合并:包内原值 / 磁盘现状 / 上次基线),再补远端文件。
· 用户改过的文件不会被静默覆盖(默认保留,逐条进冲突清单);`--overwrite` 才用包覆盖
· 缺文件(断网 / CurseForge files[] 补不出来)可容忍,但结果降级为「部分成功」
+2 -1
View File
@@ -157,7 +157,8 @@ pub struct InstallArgs {
pub struct PackImportArgs {
/// 整合包路径:`.zip` / `.mrpack` / MultiMC 实例目录。
pub path: PathBuf,
/// 目标实例目录(缺省 = 数据根的共享游戏目录 `game_home`)。
/// 目标实例目录(缺省 = 新实例目录 `<数据根>/instances/<实例名>`,M216 前是共享游戏目录
/// `game_home`)。
pub target: Option<PathBuf>,
/// 实例显示名(缺省 = 包名)。
pub name: Option<String>,
+73 -1
View File
@@ -130,9 +130,25 @@ fn human_lines(
sources.join(" → ")
));
}
for warning in &plan.warnings {
// **M216 P2-2**:有 report 就报**运行期**告警——它开头就是 `plan.warnings` 的副本,加上执行期
// 才知道的事(「已替换版本清单 … 旧的那份备份在 …」)。此前这里只遍历 `plan.warnings`,
// 于是「我们动了别人 `.minecraft` 里那份清单」这句话在 `ull install` 的人读输出里**从没出现过**
// (只有 `--json` 的 `result.warnings` 有)——「不静默破坏」就落不了地。
// 没有 report(`--dry-run`)时退回计划期告警。
let warnings = report.map_or(plan.warnings.as_slice(), |report| {
report.warnings.as_slice()
});
for warning in warnings {
human.push(format!("告警: {warning}"));
}
if let Some(manifest) = report.and_then(|report| report.manifest.as_ref()) {
if let Some(backup) = manifest.backup() {
human.push(format!(
"版本清单已替换(旧的那份备份在 {})",
backup.display()
));
}
}
if let Some(report) = report {
human.push(format!(
"下载 {} 个 / 跳过 {} 个已就绪 / 失败 {} 个(本次 {})",
@@ -181,6 +197,62 @@ pub fn human_bytes(bytes: u64) -> String {
#[cfg(test)]
mod tests {
use super::human_bytes;
use super::*;
use unlucky_core::game::arguments::Environment;
use unlucky_core::game::install::{ManifestWrite, PlanInput};
use unlucky_core::game::layout::GameLayout;
use unlucky_core::game::manifest::VersionJson;
/// **M216 P2-2**:清单被替换这件事必须出现在**人读**行里(以前只进 `--json`,
/// 复审 r1 抓的就是「对玩家仍然静默」)。
///
/// 抓得住:`human_lines` 退回只遍历 `plan.warnings`(那时找不到「已替换版本清单」⇒ 红,
/// 正是修前状态);`manifest` 的备份路径没渲出来。抓不住:真实终端排版与颜色、
/// 以及 `ull install` 的整条命令链(本用例直接调排版函数,不落盘、不联网)。
#[test]
fn a_replaced_manifest_is_said_out_loud_in_the_human_output() {
let root = std::env::temp_dir().join(format!("ull216-report-{}", std::process::id()));
let layout = GameLayout::new(&root);
let resolved = VersionJson::from_json_str(
r#"{"id":"1.20.1","mainClass":"net.minecraft.client.main.Main",
"downloads":{"client":{"sha1":"aa","size":1,"url":"https://example.invalid/c.jar"}}}"#,
)
.expect("清单应可解析");
let plan = InstallPlan::build(PlanInput {
layout: &layout,
version_id: "1.20.1",
resolved: &resolved,
asset_index: None,
environment: &Environment::host(),
})
.expect("组计划应成功");
let backup = root.join("versions/1.20.1/1.20.1.json.ullbak-4242");
let mut warnings = plan.warnings.clone();
warnings.push("已替换版本清单 <dest>(旧的那份备份在 <backup>)".to_string());
let report = InstallReport {
files: Vec::new(),
version_json: Some(plan.version_json_path.clone()),
manifest: Some(ManifestWrite::Replaced {
backup: backup.clone(),
}),
warnings,
};
let text = human_lines(false, &plan, Some(&report), None, &[], "ignored", "1.20.1").join(
"
",
);
assert!(
text.contains("已替换版本清单"),
"运行期告警没进人读输出:{text}"
);
assert!(
text.contains(&backup.display().to_string()),
"备份路径没进人读输出:{text}"
);
std::fs::remove_dir_all(&root).ok();
}
#[test]
fn formats_sizes_without_fake_precision() {
+35 -34
View File
@@ -1,8 +1,7 @@
//! `pack import <file>`:整合包导入(M111)。
//!
//! 逻辑**全在** `core::addon::import`:本文件只做三件事——参数落地、下载引擎接线、两种输出。
//! 之所以坚持这一层很薄,是因为 M113 的导入页要复用的是 core 的 `import_pack` + `ImportReport`,
//! 不是这里的打印逻辑。
//! 逻辑**全在** `core::addon::import`:本文件只做参数落地、引擎接线、两种输出。坚持这一层很薄,
//! 是因为 M113 的导入页要复用的是 core 的 `import_pack` + `ImportReport`,不是这里的打印逻辑。
//!
//! # 三态退出码(脚本契约)
//!
@@ -13,15 +12,13 @@
//! | `failed` | `1` | 致命失败,**已整包回滚** |
//! | `cancelled` | `130` | 用户取消(管线在检查点停手并回滚,**不是失败**) |
//!
//! `130`(= `128 + SIGINT`)是"被用户中断"的惯例码:CLI 这一轮没有取消入口(一次性命令,
//! Ctrl-C 直接杀进程),但 `ImportStatus::Cancelled` 是 core 的公开结果,脚本读 `--json` 时
//! 必须能把它与 `failed` 分开——所以退出码与文案在这里就位,接中断信号是下一步的事。
//! `130`(= `128 + SIGINT`)是"被用户中断"的惯例码:CLI 这一轮没有取消入口(Ctrl-C 直接杀进程),
//! 但 `ImportStatus::Cancelled` 是 core 的公开结果,脚本读 `--json` 时要能把它与 `failed` 分开。
//!
//! `--json` 的信封在三种状态下**都是** `{"ok":true,"data":{…}}`(命令跑完了),分流看
//! `data.status` / `data.error.code` 或退出码;`ok:false` 只用于"命令没跑起来"(参数错、
//! 数据根不可用),与其它命令一致。
//! `data.status` / `data.error.code` 或退出码;`ok:false` 只用于"命令没跑起来"(参数错、数据根不可用)。
use std::path::{Path, PathBuf};
use std::path::Path;
use std::sync::{Arc, Mutex};
use serde_json::json;
@@ -32,7 +29,6 @@ use unlucky_core::addon::import::{
use unlucky_core::download::blocking::block_on;
use unlucky_core::download::DownloadEngine;
use unlucky_core::game::install::pack_dir;
use unlucky_core::platform::layout::LauncherLayout;
use crate::cli::PackImportArgs;
use crate::context::Ctx;
@@ -53,7 +49,19 @@ pub fn run(ctx: &Ctx, args: &PackImportArgs) -> Result<Outcome, CliError> {
.with_hint("给 .zip / .mrpack 文件,或 MultiMC·Prism 的实例目录"));
}
let layout = ctx.layout();
let (target, instance_name) = import_target(&layout, args)?;
// **M216 ②**:缺省落点 = `<data>/instances/<实例名>`(与 GUI 同源,判据在 core 的
// `pack_dir::import_target`),不再是共享的 `.minecraft` 根。
let (target, instance_name) = pack_dir::import_target(
&layout,
&args.path,
args.target.as_deref(),
args.name.as_deref(),
)
.map_err(|reason| {
CliError::user("target_exists", reason).with_hint(
"加 --name 换个实例名,或显式给 --target(--overwrite 只管文件冲突,绕过不了这条预检)",
)
})?;
let stages: Arc<Mutex<Vec<&'static str>>> = Arc::new(Mutex::new(Vec::new()));
let recorder = Arc::clone(&stages);
@@ -80,30 +88,19 @@ pub fn run(ctx: &Ctx, args: &PackImportArgs) -> Result<Outcome, CliError> {
}
let report = block_on(import_pack(&request));
// **§5**:缺省建出来的实例要绑到它的内容目录(判据/文案在 core,与 GUI 同一份),否则
// 「导入成功」而那批 mods/config 永远不会被那条实例的启动用到。
let auto = args.target.is_none() && !args.no_register;
let binding = pack_dir::bind_created_instance(&layout, &target, auto, &report);
let seen = stages.lock().map(|seen| seen.clone()).unwrap_or_default();
Ok(outcome(ctx, &report, &target, &seen, args))
}
/// 导入落点与登记名:**M216 ②** 起与 GUI 同源(`<data>/instances/<实例目录名>`,不是共享的
/// `.minecraft` 根),判据收在 core 的 [`pack_dir::import_target`],本函数只做错误码翻译。
///
/// # Errors
///
/// 缺省目录已存在且非空(`target_exists`)。
fn import_target(
layout: &LauncherLayout,
args: &PackImportArgs,
) -> Result<(PathBuf, String), CliError> {
pack_dir::import_target(
layout,
&args.path,
args.target.as_deref(),
args.name.as_deref(),
)
.map_err(|reason| {
CliError::user("target_exists", reason)
.with_hint("加 --name 换个实例名,或显式给 --target / --overwrite")
})
Ok(outcome(
ctx,
&report,
&target,
&seen,
args,
binding.as_deref(),
))
}
/// 组装 `Outcome`(三态 → 退出码 + 两种输出)。
@@ -113,6 +110,7 @@ fn outcome(
target: &Path,
stages: &[&'static str],
args: &PackImportArgs,
binding: Option<&str>,
) -> Outcome {
let mut data = serde_json::to_value(report).unwrap_or_else(|_| {
json!({
@@ -146,6 +144,9 @@ fn outcome(
if !stages.is_empty() {
human.push(format!("阶段:{}", stages.join(" → ")));
}
if let Some(note) = binding {
human.push(note.to_string());
}
human.push(format!(
"结果:{} 文件 新{} / 覆盖{} / 跳过{} / 保留{} 冲突 {} 缺文件 {}",
status_label(report),
+87
View File
@@ -197,3 +197,90 @@ fn help_lists_the_pack_command() {
assert_eq!(code, 0);
assert!(stdout.contains("pack import"), "总帮助里也要有:{stdout}");
}
/// **M216 P3-3 + §5**:不带 `--target` 时落点是**新实例目录**(不是共享 `.minecraft` 根),
/// 而且登记出来的实例被绑到那个目录(`isolation=custom` + `gameDir`),否则导入内容永远不会
/// 被启动用到。
///
/// 抓得住:CLI 自己兜底回 `ctx.game().root()`(第一条断言会变成 `.minecraft`);不建实例目录而
/// 直接铺共享根;不做绑定(`isolation` 仍是 `null`);绑定写错目录。抓不住:真实启动那一条
/// `derive_game_dir` 的派生(core 的 `isolation.rs` 用例钉,这里只断言设置文件的内容)。
#[test]
fn the_default_target_is_a_new_instance_dir_and_the_instance_is_bound_to_it() {
let data = TempDir::new("pack-default-target");
let source = multimc_instance(data.path());
let (code, stdout, stderr) = run_cli(&[
"pack",
"import",
&source.display().to_string(),
"--name",
"My Pack",
"--data-dir",
&data.arg(),
"--json",
]);
assert_eq!(code, 0, "stdout={stdout} stderr={stderr}");
let instance_dir = data.path().join(".ULL/data/instances/My-Pack");
assert!(
instance_dir.join("mods/a.jar").is_file(),
"缺省落点应当是 <data>/instances/My-Pack:{stdout}"
);
assert!(
!data.path().join(".minecraft/mods/a.jar").exists(),
"不许再往共享 .minecraft 根铺:{stdout}"
);
// 登记的实例被绑到这个目录(§5)。
let profiles: Value = serde_json::from_str(
&std::fs::read_to_string(data.path().join(".ULL/config/profiles.json"))
.expect("profiles.json"),
)
.expect("profiles.json 是 JSON");
assert_eq!(
profiles["profiles"][0]["name"],
Value::String("My Pack".into())
);
let id = profiles["profiles"][0]["id"]
.as_str()
.expect("登记出来的实例有 id")
.to_string();
let config: Value = serde_json::from_str(
&std::fs::read_to_string(
data.path()
.join(".ULL/config/instances")
.join(format!("{id}.json")),
)
.expect("实例设置文件"),
)
.expect("实例设置是 JSON");
assert_eq!(
config["isolation"],
Value::String("custom".into()),
"isolation 应当是 custom:{config}"
);
assert_eq!(
config["gameDir"].as_str().map(Path::new),
Some(instance_dir.as_path()),
"gameDir 应当指向导入目录:{config}"
);
}
/// **M216 P2-1**:`--help` 里的缺省落点必须与新行为一致(写旧行为 = 用户照读会以为文件进了
/// `.minecraft`)。
///
/// 抓得住:文案退回「共享游戏目录」;新落点没写进去。抓不住:`model.rs` 的字段文档
/// (那是编译期文档,测试读不到)——所以断言落在这里只覆盖用户能看见的那一份。
#[test]
fn help_describes_the_new_default_target() {
let (code, stdout, _) = run_cli(&["help", "pack"]);
assert_eq!(code, 0);
assert!(
stdout.contains("instances/<实例名>"),
"帮助里没写新缺省落点:{stdout}"
);
assert!(
!stdout.contains("缺省 = 数据根的共享游戏目录"),
"帮助里还留着旧缺省落点:{stdout}"
);
}