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:
1 parent
96f15c79fb
commit
4e1323212b
10 files changed
+359
-45
No files matched your search
@@ -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[] 补不出来)可容忍,但结果降级为「部分成功」
|
||||
|
||||
@@ -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>,
|
||||
|
||||
@@ -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() {
|
||||
|
||||
@@ -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),
|
||||
|
||||
@@ -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}"
|
||||
);
|
||||
}
|
||||
Reference in new issue
Block a user