feat(game): 从其他启动器只读登记已有版本（ull instances scan|adopt）+ 登记可一并定隔离档（M221）
盘上已经铺好的版本（多半是 PCL/HMCL 装的）今天在 ULL 里看不见，用户只能重装一遍。这个 commit 把它们登记成实例，**只读外部、只写自己的配置**：不搬文件、不补清单、不改任何外部 文件的 mtime（versions/ libraries/ assets/ 一个字节都不写）。 core（`game::adopt`，新模块）： - `scan` / `inspect`：只读扫描 + 逐项检查，坏 JSON（带行列号）/ 缺 id / id 与目录名不一致 / 缺父 / 成环 / 读不出来 / 越界 / 同名冲突一律**结构化**报错（稳定 `code`），不吞成空列表； `versions/` 不存在才是空结果，读不了就是错误； - 越界判据用 canonicalize 后的前缀比较，同时覆盖**符号链接、Windows 目录联接（junction）与 祖先链接**（junction 不需要管理员权限，是最常见的「把别人版本目录挂进来」）；越界条目在 边界检查就停手，一个字节都不去读； - `plan`（零写盘，喂 dry-run 与后续 GUI 预检）/ `adopt`（plan + 只写自己的配置）： **缺省运行目录落 ULL 数据区 `<data>/instances/<实例目录名>`（custom 档），绝不沿用全局 `isolated`**——那条缺省的运行目录正是 `versions/<versionId>/`，会在他人的版本目录里长出 mods/saves/config；`shared` / `isolated` 必须显式选，且 `target_notes()` 给出后果话术； - 缺省运行目录已存在且非空 ⇒ 拒绝（不覆盖、不猜「合并进已有实例」）；数据区里已有的祖先 若解析到数据根之外（符号链接/联接）⇒ 拒绝，不沿它写盘； - 登记与隔离档一次写清：`install/instance` 拆出 `register` 子模块，新增 `register_with(InstanceSettings)`；写盘顺序改成「先实例设置、后 profiles」（中断只留孤立 设置文件，不会留下按全局档启动的实例），profiles 写失败会撤掉刚写的设置。`register` 签名与行为不变（`register` = `register_with(inherit)`；同版本同名的幂等复用照旧）。 CLI： - `ull instances scan`（只读列出候选与原因）、`ull instances adopt <version-id> [--name N] [--isolation shared|isolated|custom] [--game-dir DIR] [--dry-run]`；`--game-dir` 单独给即 custom，相对路径在解析期就报用法错误； - 人读/`--json`/help 三条出口齐备（`error.detail.problems` 逐条可分流），已有命令未改。 测试（真磁盘夹具，`cargo test -p unlucky-core --test adopt` 22 passed / `cargo test -p unlucky-cli --test adopt_test` 10 passed）： - 一份「别的启动器铺好的」`.minecraft`（versions/libraries/assets/mods/saves/config + launcher_profiles.json），扫描与登记前后做「路径集合 + 字节数 + 内容哈希 + mtime」全等断言； - 正常 / 缺清单 / 坏 JSON / 缺父 / 成环 / id 不匹配 / 非法 id / 符号链接越界 / 根内符号链接 放行 / **junction 越界** / 数据区 junction 写盘边界 / 缺省非 isolated / shared 与 isolated 的话术 / 重名 / 重复 / 非空目录 / 空目录复用 / dry-run 零写盘； - CLI 侧验 `launch --dry-run` 的 `--gameDir` 指向选定运行目录（argv 已脱敏，比尾段； `data.game_dir` 全等）； - 变异核对（只改实现、跑完即回滚）：缺省档改 `VersionDir` ⇒ 红；边界判据摘掉 ⇒ 符号链接与 junction 两条红；写盘边界摘掉 ⇒ 数据区 junction 那条红；缺父当链终点 ⇒ 两条红。 界限：没有启动真实 Minecraft；GUI（presenter/app-iced）接线另派；D20 单游戏根模型未改 （不扫第二个 `.minecraft`）。
This commit is contained in:
AskaEth committed
1 parent
0577ee87a3
commit
9f5c001387
25 files changed
+3460
-73
No files matched your search
@@ -0,0 +1,315 @@
|
||||
//! M221 CLI 端到端：`ull instances scan` / `ull instances adopt` 的真实入口（解析 → 执行 → 两条输出）。
|
||||
//!
|
||||
//! 用的都是**真磁盘**数据根（`support::TempDir`）+ 一份「别的启动器铺好的」`.minecraft`。
|
||||
//! 每条用例都断言外部文件哈希/mtime 不变（`fixture::assert_unchanged`），
|
||||
//! 因为「只登记不搬文件」是本 mission 的核心承诺。
|
||||
|
||||
#[path = "adopt_test/cli_surface.rs"]
|
||||
mod cli_surface;
|
||||
#[path = "adopt_test/fixture.rs"]
|
||||
mod fixture;
|
||||
#[path = "support/mod.rs"]
|
||||
mod support;
|
||||
|
||||
use std::path::Path;
|
||||
|
||||
use support::{parse_json, run_cli, TempDir};
|
||||
|
||||
use crate::fixture::{assert_unchanged, foreign_data_root, snapshot};
|
||||
|
||||
/// 缺省登记：落 ULL 数据区的独立目录，隔离档 `custom`，**不沿用全局 `isolated`**。
|
||||
///
|
||||
/// 抓得住：
|
||||
/// - 缺省沿用全局 `isolated`（运行目录会变成 `versions/1.20.1`，第二条断言会红）——
|
||||
/// 这是本 mission 点名的最容易漏的一条；
|
||||
/// - 命令只登记不输出（`--json` 缺 `instance`）；
|
||||
/// - 登记过程写了外部 `.minecraft`（哈希断言）。
|
||||
///
|
||||
/// 抓不住：GUI 是否也能触发同一条路（GUI 接线是后续 mission）。
|
||||
#[test]
|
||||
fn adopt_without_isolation_uses_a_separate_run_dir_and_keeps_global_isolated_out_of_it() {
|
||||
let dir = TempDir::new("adopt-default");
|
||||
let root = dir.path();
|
||||
foreign_data_root(root);
|
||||
// 全局档显式写成 isolated（D20 的缺省）：登记**不许**继承它去踩别人的版本目录。
|
||||
set_global_isolated(&dir);
|
||||
let minecraft = root.join(".minecraft");
|
||||
let before = snapshot(&minecraft);
|
||||
|
||||
let (code, stdout, stderr) = run_cli(&[
|
||||
"instances",
|
||||
"adopt",
|
||||
"1.20.1",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 0, "stdout={stdout}\nstderr={stderr}");
|
||||
let after = snapshot(&minecraft);
|
||||
assert_unchanged(&before, &after, "adopt 之后");
|
||||
|
||||
let value = parse_json(&stdout);
|
||||
let instance = &value["data"]["instance"];
|
||||
assert_eq!(instance["isolation"], "custom");
|
||||
assert_eq!(instance["run_dir_source"], "instance_dir");
|
||||
let run_dir = instance["run_dir"].as_str().expect("run_dir");
|
||||
assert!(
|
||||
run_dir.contains("instances"),
|
||||
"缺省运行目录应落 ULL 数据区：{run_dir}"
|
||||
);
|
||||
assert!(
|
||||
!Path::new(run_dir).starts_with(&minecraft),
|
||||
"缺省运行目录不许落进别人的 .minecraft：{run_dir}"
|
||||
);
|
||||
assert!(
|
||||
!run_dir.ends_with("versions/1.20.1") && !run_dir.ends_with("versions\\1.20.1"),
|
||||
"不许沿用全局 isolated 的 versions/<id>：{run_dir}"
|
||||
);
|
||||
assert_eq!(instance["created"], true);
|
||||
|
||||
// 再走一次 `instances list`：档案真的进去了（不是只写了实例文件）。
|
||||
let (code, stdout, _) = run_cli(&["instances", "list", "--json", "--data-dir", &dir.arg()]);
|
||||
assert_eq!(code, 0);
|
||||
let listed = parse_json(&stdout);
|
||||
assert_eq!(listed["data"]["instances"][0]["version_id"], "1.20.1");
|
||||
assert_eq!(listed["data"]["instances"][0]["version_present"], true);
|
||||
}
|
||||
|
||||
/// 登记之后 `launch --dry-run` 的 `--gameDir` 就是选定的运行目录（本 mission 的功能落点）。
|
||||
///
|
||||
/// 抓得住：登记把隔离档写错（`inherit`）⇒ 启动派生坚持全局 `isolated`，`game_dir` 变成
|
||||
/// `versions/1.20.1`（第二条断言会红）；`gameDir` 没进启动计划。
|
||||
/// 抓不住：真进程是否真的用这个 CWD（要真跑游戏，本 mission 不跑）。
|
||||
#[test]
|
||||
fn the_launch_plan_points_game_dir_at_the_chosen_run_dir() {
|
||||
let dir = TempDir::new("adopt-launch");
|
||||
let root = dir.path();
|
||||
foreign_data_root(root);
|
||||
set_global_isolated(&dir);
|
||||
|
||||
let (code, stdout, stderr) = run_cli(&[
|
||||
"instances",
|
||||
"adopt",
|
||||
"1.20.1",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 0, "stdout={stdout}\nstderr={stderr}");
|
||||
let adopted = parse_json(&stdout);
|
||||
let run_dir = adopted["data"]["instance"]["run_dir"]
|
||||
.as_str()
|
||||
.expect("run_dir")
|
||||
.to_string();
|
||||
let instance_id = adopted["data"]["instance"]["id"]
|
||||
.as_str()
|
||||
.expect("instance id")
|
||||
.to_string();
|
||||
|
||||
let dir_arg = dir.arg();
|
||||
let args = [
|
||||
"launch",
|
||||
instance_id.as_str(),
|
||||
"--dry-run",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
dir_arg.as_str(),
|
||||
];
|
||||
let (code, stdout, stderr) = run_cli(&args);
|
||||
assert_eq!(code, 0, "stdout={stdout}\nstderr={stderr}");
|
||||
let plan = parse_json(&stdout);
|
||||
assert_eq!(plan["data"]["game_dir"], run_dir.as_str());
|
||||
assert_eq!(plan["data"]["isolation"], "custom");
|
||||
assert_eq!(plan["data"]["isolation_source"], "instance");
|
||||
let command = plan["data"]["argv"]
|
||||
.as_array()
|
||||
.expect("启动计划里应有 argv");
|
||||
let game_dir_flag = command
|
||||
.windows(2)
|
||||
.find(|pair| pair[0].as_str() == Some("--gameDir"))
|
||||
.map(|pair| pair[1].as_str().unwrap_or_default().to_string())
|
||||
.expect("命令行里应有 --gameDir");
|
||||
// `argv` 是**脱敏后**的（主目录 → `<home>`，见 `core::launch::redact`），所以比尾段而不是全等；
|
||||
// 全等的那条断言在 `data.game_dir` 上（那是未脱敏的权威值）。
|
||||
let tail = format!(
|
||||
"instances/{}",
|
||||
Path::new(&run_dir)
|
||||
.file_name()
|
||||
.expect("运行目录名")
|
||||
.to_string_lossy()
|
||||
);
|
||||
assert!(
|
||||
game_dir_flag.ends_with(&tail) || game_dir_flag.ends_with(&tail.replace('/', "\\")),
|
||||
"--gameDir 必须指向选定的运行目录：{game_dir_flag} 应以 {tail} 结尾"
|
||||
);
|
||||
}
|
||||
|
||||
/// `--isolation shared`：明确选共享 ⇒ 运行目录 = 别人的游戏根，**人读输出必须说出后果**。
|
||||
///
|
||||
/// 抓得住：shared 档没有告知（stdout 里没有「共用」）、shared 被写成 custom + 自己的目录、
|
||||
/// 登记往游戏根写文件（哈希断言）。
|
||||
/// 抓不住：用户是否真的看见这句（UI 验收另说）。
|
||||
#[test]
|
||||
fn shared_isolation_states_the_consequence_in_human_output() {
|
||||
let dir = TempDir::new("adopt-shared");
|
||||
let root = dir.path();
|
||||
foreign_data_root(root);
|
||||
let minecraft = root.join(".minecraft");
|
||||
let before = snapshot(&minecraft);
|
||||
|
||||
let (code, stdout, stderr) = run_cli(&[
|
||||
"instances",
|
||||
"adopt",
|
||||
"1.20.1",
|
||||
"--isolation",
|
||||
"shared",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 0, "stdout={stdout}\nstderr={stderr}");
|
||||
let after = snapshot(&minecraft);
|
||||
assert_unchanged(&before, &after, "shared 登记之后");
|
||||
assert!(
|
||||
stdout.contains("共用"),
|
||||
"必须说出「共用别人的 .minecraft」：{stdout}"
|
||||
);
|
||||
assert!(stdout.contains("一个字节都没动"), "{stdout}");
|
||||
}
|
||||
|
||||
/// `--dry-run`：只检查不写盘（连配置目录都不建）。
|
||||
///
|
||||
/// 抓得住：`--dry-run` 真的写了档案或建了运行目录（快照会红）。
|
||||
/// 抓不住：`--dry-run` 有没有顺带读了不该读的东西。
|
||||
#[test]
|
||||
fn dry_run_writes_nothing() {
|
||||
let dir = TempDir::new("adopt-dry");
|
||||
let root = dir.path();
|
||||
foreign_data_root(root);
|
||||
let before = snapshot(root);
|
||||
|
||||
let (code, stdout, stderr) = run_cli(&[
|
||||
"instances",
|
||||
"adopt",
|
||||
"1.20.1",
|
||||
"--dry-run",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 0, "stdout={stdout}\nstderr={stderr}");
|
||||
let after = snapshot(root);
|
||||
assert_unchanged(&before, &after, "--dry-run 之后");
|
||||
assert!(stdout.contains("检查通过"), "{stdout}");
|
||||
assert!(stdout.contains("没有写任何文件"), "{stdout}");
|
||||
}
|
||||
|
||||
/// 坏的版本（缺父）⇒ 退出码 1，`--json` 里带**逐条**问题码。
|
||||
///
|
||||
/// 抓得住：不合格版本被登记成功（退出码变 0）、问题码被折叠成一句散文（`detail.problems` 缺项）。
|
||||
/// 抓不住：用户在原来的启动器里修好之后重试（自然覆盖）。
|
||||
#[test]
|
||||
fn not_adoptable_version_exits_one_with_structured_problems() {
|
||||
let dir = TempDir::new("adopt-refuse");
|
||||
let root = dir.path();
|
||||
foreign_data_root(root);
|
||||
let before = snapshot(root);
|
||||
|
||||
let (code, stdout, _) = run_cli(&[
|
||||
"instances",
|
||||
"adopt",
|
||||
"1.20.1-orphan",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 1, "{stdout}");
|
||||
let value = parse_json(&stdout);
|
||||
assert_eq!(value["ok"], false);
|
||||
assert_eq!(value["error"]["code"], "adopt_not_adoptable");
|
||||
assert_eq!(
|
||||
value["error"]["detail"]["problems"][0]["code"],
|
||||
"missing_parent"
|
||||
);
|
||||
let after = snapshot(root);
|
||||
assert_unchanged(&before, &after, "失败之后");
|
||||
}
|
||||
|
||||
/// 重复登记 ⇒ 退出码 1 + 无副作用（档案逐字节不变）。
|
||||
///
|
||||
/// 抓得住：重复登记当成功（退出码 0）或失败时改了档案。
|
||||
/// 抓不住：并发两次登记（没有锁；这不是并发入口）。
|
||||
#[test]
|
||||
fn repeating_the_same_adopt_exits_one_without_side_effects() {
|
||||
let dir = TempDir::new("adopt-repeat");
|
||||
let root = dir.path();
|
||||
foreign_data_root(root);
|
||||
let (code, _, stderr) = run_cli(&["instances", "adopt", "1.20.1", "--data-dir", &dir.arg()]);
|
||||
assert_eq!(code, 0, "{stderr}");
|
||||
let config = root.join(".ULL/config");
|
||||
let before = snapshot(&config);
|
||||
|
||||
let (code, stdout, _) = run_cli(&[
|
||||
"instances",
|
||||
"adopt",
|
||||
"1.20.1",
|
||||
"--json",
|
||||
"--data-dir",
|
||||
&dir.arg(),
|
||||
]);
|
||||
assert_eq!(code, 1, "{stdout}");
|
||||
assert_eq!(
|
||||
parse_json(&stdout)["error"]["code"],
|
||||
"adopt_already_registered"
|
||||
);
|
||||
let after = snapshot(&config);
|
||||
assert_unchanged(&before, &after, "重复登记失败之后");
|
||||
}
|
||||
|
||||
/// `instances scan`：只读列出候选，坏版本逐条给原因。
|
||||
///
|
||||
/// 抓得住：扫描变成空列表（那是本 mission 点名不许的行为）、坏版本被静默跳过、
|
||||
/// 扫描写了文件。
|
||||
/// 抓不住：真实 `.minecraft` 里那些平台特有的怪目录（夹具只覆盖已知形状）。
|
||||
#[test]
|
||||
fn scan_lists_candidates_and_reasons_without_writing() {
|
||||
let dir = TempDir::new("adopt-scan");
|
||||
let root = dir.path();
|
||||
foreign_data_root(root);
|
||||
let before = snapshot(root);
|
||||
|
||||
let (code, stdout, stderr) =
|
||||
run_cli(&["instances", "scan", "--json", "--data-dir", &dir.arg()]);
|
||||
assert_eq!(code, 0, "stdout={stdout}\nstderr={stderr}");
|
||||
let after = snapshot(root);
|
||||
assert_unchanged(&before, &after, "scan 之后");
|
||||
|
||||
let value = parse_json(&stdout);
|
||||
assert_eq!(value["data"]["counts"]["total"], 2);
|
||||
assert_eq!(value["data"]["counts"]["adoptable"], 1);
|
||||
let candidates = value["data"]["candidates"].as_array().expect("candidates");
|
||||
let ok = candidates
|
||||
.iter()
|
||||
.find(|item| item["version_id"] == "1.20.1")
|
||||
.expect("有 1.20.1");
|
||||
assert_eq!(ok["adoptable"], true);
|
||||
assert_eq!(ok["jar_present"], true);
|
||||
let orphan = candidates
|
||||
.iter()
|
||||
.find(|item| item["version_id"] == "1.20.1-orphan")
|
||||
.expect("有 1.20.1-orphan");
|
||||
assert_eq!(orphan["adoptable"], false);
|
||||
assert_eq!(orphan["problems"][0]["code"], "missing_parent");
|
||||
}
|
||||
|
||||
/// 把全局隔离档设成 `isolated`（走 schema 校验的正式入口，不手写 launcher.json）。
|
||||
fn set_global_isolated(dir: &TempDir) {
|
||||
let dir_arg = dir.arg();
|
||||
let (code, _, stderr) = run_cli(&[
|
||||
"config",
|
||||
"set",
|
||||
"instances.mode",
|
||||
"isolated",
|
||||
"--data-dir",
|
||||
dir_arg.as_str(),
|
||||
]);
|
||||
assert_eq!(code, 0, "设置全局隔离档失败：{stderr}");
|
||||
}
|
||||
Reference in new issue
Block a user