AskaEth
347a3cc90d
r1 五项里 R4/R5 与 slug/大小写等直接案例已由 r2 复审独立通过；这三条是它补证出的**剩余边界**， 只做限定修复，不推翻重写： r2.1（未存在认领路径的 Win32 尾点/尾空格别名）：比较键新增 `fspaths::comparison_real()`—— 已存在前缀用 `canonicalize`，**尚不存在的尾段按平台语义归一**：Windows 普通路径折叠尾 `.`/空格 （`Foo.` 与 `Foo ` 都是 `Foo`，Win32 建目录时就这么做），**verbatim 路径（`\?\…`）不折叠** （那是另一个物理目录，合法）。原先 `dir_key` 只统一分隔符与大小写，于是一个尚未创建的 `custom` 认领 `Foo.` 与缺省派生 `Foo` 键不相等却被判定「不撞」，两个实例共用一个运行目录。 r2.2（`data`/`.ULL` 整体映射到受保护游戏树时仍静默外写）：新增 `fspaths::ensure_surfaces_clear_of_game_tree()`——默认写盘面（`.ULL`、`config/`、 `config/instances/`、`profiles.json`、`data/`，以及缺省档的运行目录）**解析后不得落进游戏根**； `plan`（dry-run 也报）与 `adopt`（写盘前）各核一次，重叠即 `adopt_write_surface_in_game_tree` 具名拒绝并提示把数据目录挪到游戏树之外。整体迁移到游戏树**之外**照旧允许（判据是落点不是链接）。 配置写面判据同时收窄职责：`ensure_config_write_surface` 只管「在 `.ULL` 内」， 不再带「`.ULL` 在游戏根里」的豁免特例——重叠由上面那条统一负责。 r2.3（游戏根更高祖先断链仍当空列表）：`scan` 的 `NotFound` 分支改为沿祖先找**最近的已存在入口**， 它能 `lstat` 到但 `canonicalize` 不出来（断链的符号链接/目录联接、目标被搬走）⇒ `adopt_versions_unreadable`；一路到盘根都不存在才是「真正的新数据根」，空结果仍允许。 原先只查 `versions` 与游戏根两层，迁移联接在更高层断开时会误报空库。 新错误码：`adopt_write_surface_in_game_tree`（CLI hint 与 help 拒绝清单同步）。 验证（持久日志在 `target/m221-r2/`，git 忽略、不入库；上一轮 `target/m221-r1/` 证据未覆盖）： - `cargo fmt --all --check` 0；`cargo check -p unlucky-core -p unlucky-cli --all-targets` 0； - `cargo test -p unlucky-core --test adopt` **43 passed / 0 failed**（另跑一次 `ULL_ADOPT_TEST_SYMLINK_REQUIRE=1` 同样 43 passed）； - `cargo test -p unlucky-cli --test adopt_test` **13 passed / 0 failed**； - `cargo clippy -p unlucky-core -p unlucky-cli --all-targets -- -D warnings` 0； - 额外：`cargo test -p unlucky-core --lib` **778 passed**、`cargo test -p unlucky-cli` 全部目标通过； - 三次**实现-only 变异**（不折叠 Win32 尾点尾空格 / 不核游戏树重叠 / NotFound 直接当空） 全部以**断言红**收场（1 / 4 / 2 条失败，非编译错误、非环境错误），每次还原后与基线逐文件一致， 收尾再跑 core+cli 双绿。 界限：只覆盖 core+cli 的定向目标（不等于 workspace 全量）；没有启动真实 Minecraft；GUI 未接； 判据是检查那一刻的快照（TOCTOU 看不到）；Win32 8.3 短名与非 junction 重解析点未覆盖。
222 lines
11 KiB
Rust
222 lines
11 KiB
Rust
//! 运行目录**碰撞**：slug 同名 / 大小写不敏感 / 「空目录已被实例占着」/ 「认领目录还不存在」。
|
||
//!
|
||
//! 复审 r1 的 R1：旧实现只比展示名，第二次登记看到「目录是空的」就复用了 ⇒ 两个从未选择
|
||
//! shared/custom 的实例共用一个运行目录（`mods`/`saves` 互相污染）。
|
||
//! 判据必须是「有没有实例占着这个**真实**目录」，而不是「目录空不空」。
|
||
|
||
use unlucky_core::game::adopt::{self, AdoptTarget};
|
||
use unlucky_core::game::install::instance::read_instance_config;
|
||
use unlucky_core::game::install::pack_dir;
|
||
|
||
use crate::fixture::{foreign_minecraft, request, TempRoot};
|
||
|
||
/// **slug 碰撞**：`Better MC` 与 `Better-MC` 派生到同一个目录名 —— 两个实例必须落在不同目录。
|
||
///
|
||
/// 复审 r1 的 R1：旧实现只比展示名，第二次登记看到「目录是空的」就复用了，于是两个从未选择
|
||
/// shared/custom 的实例共用一个运行目录（`mods`/`saves` 互相污染）。
|
||
///
|
||
/// 抓得住：
|
||
/// - 判据只看目录空不空、不看已有实例占没占（两条 `run_dir` 不同的断言会红）；
|
||
/// - 顺延目录没建出来 / 提示里没点出撞的是谁。
|
||
///
|
||
/// 抓不住：`pack_dir::instance_dir_name` 本身把两个名字折成同一个目录（那是既有行为，
|
||
/// 本 mission 不改它，只保证**登记侧**不共用）。
|
||
#[test]
|
||
fn slug_colliding_names_do_not_share_a_run_dir() {
|
||
let root = TempRoot::new("slug-collide");
|
||
foreign_minecraft(&root.game_root());
|
||
|
||
let mut first = request("1.20.1", AdoptTarget::InstanceDir);
|
||
first.name = Some("Better MC".to_string());
|
||
let a = adopt::adopt(&root.game(), &root.launcher(), &first).expect("第一次登记");
|
||
let mut second = request("1.20.1", AdoptTarget::InstanceDir);
|
||
second.name = Some("Better-MC".to_string());
|
||
let b = adopt::adopt(&root.game(), &root.launcher(), &second).expect("第二次登记");
|
||
|
||
assert_ne!(a.run_dir, b.run_dir, "两个实例不许共用同一个运行目录");
|
||
assert!(
|
||
a.run_dir.is_dir() && b.run_dir.is_dir(),
|
||
"两个目录都要真实存在"
|
||
);
|
||
let bumped = b
|
||
.run_dir
|
||
.file_name()
|
||
.map(|name| name.to_string_lossy().into_owned());
|
||
assert!(
|
||
bumped.as_deref().is_some_and(|name| name.ends_with("-2")),
|
||
"撞车后应顺延成 -2：{:?}",
|
||
b.run_dir
|
||
);
|
||
assert!(
|
||
b.notes.iter().any(|note| note.contains("同一个物理目录")),
|
||
"必须把「撞了谁」说出来：{:?}",
|
||
b.notes
|
||
);
|
||
|
||
// 两份实例设置各自指向自己的目录（不是都指第一个）。
|
||
let config_a = read_instance_config(&root.launcher(), &a.instance_id)
|
||
.expect("读设置")
|
||
.expect("有设置文件");
|
||
let config_b = read_instance_config(&root.launcher(), &b.instance_id)
|
||
.expect("读设置")
|
||
.expect("有设置文件");
|
||
assert_eq!(config_a.game_dir.as_deref(), Some(a.run_dir.as_path()));
|
||
assert_eq!(config_b.game_dir.as_deref(), Some(b.run_dir.as_path()));
|
||
}
|
||
|
||
/// **大小写碰撞**（Windows/macOS）：`Foo` 与 `foo` 是同一个物理目录 ⇒ 同样必须顺延。
|
||
///
|
||
/// 抓得住：`dir_key` 不做大小写归一（Windows 上第二次登记会复用同一个目录）。
|
||
/// 抓不住：Linux（大小写敏感，两条目录本来就不同——那里这条不适用，见 `cfg`）。
|
||
#[cfg(windows)]
|
||
#[test]
|
||
fn names_differing_only_in_case_do_not_share_a_run_dir() {
|
||
let root = TempRoot::new("case-collide");
|
||
foreign_minecraft(&root.game_root());
|
||
|
||
let mut first = request("1.20.1", AdoptTarget::InstanceDir);
|
||
first.name = Some("Foo".to_string());
|
||
let a = adopt::adopt(&root.game(), &root.launcher(), &first).expect("第一次登记");
|
||
let mut second = request("1.20.1", AdoptTarget::InstanceDir);
|
||
second.name = Some("foo".to_string());
|
||
let b = adopt::adopt(&root.game(), &root.launcher(), &second).expect("第二次登记");
|
||
|
||
assert_ne!(a.run_dir, b.run_dir, "大小写不同不是「不同目录」的理由");
|
||
let a_real = a.run_dir.canonicalize().expect("真实路径 A");
|
||
let b_real = b.run_dir.canonicalize().expect("真实路径 B");
|
||
assert_ne!(a_real, b_real, "两个运行目录的真实路径必须不同");
|
||
}
|
||
|
||
/// 空目录**已被别的实例占着** ⇒ 也不能当「失败残留」复用，要顺延。
|
||
///
|
||
/// 这是 R1 的另一半：判据必须是「有没有实例占着」，而不是「目录空不空」。
|
||
///
|
||
/// 抓得住：只按 `directory_occupied` 判（第一次登记建出的空目录会被第二次白白复用）。
|
||
/// 抓不住：目录非空且无人认领的情形（那条保持 `TargetNotEmpty`，见下一条用例）。
|
||
#[test]
|
||
fn an_empty_dir_owned_by_another_instance_is_not_reused() {
|
||
let root = TempRoot::new("owned-empty");
|
||
foreign_minecraft(&root.game_root());
|
||
let mut first = request("1.20.1", AdoptTarget::InstanceDir);
|
||
first.name = Some("Better MC".to_string());
|
||
let a = adopt::adopt(&root.game(), &root.launcher(), &first).expect("第一次登记");
|
||
// 目录此刻是空的（新建、还没启动过游戏）——旧判据会认为「可复用」。
|
||
let entries_before = std::fs::read_dir(&a.run_dir).expect("读目录").count();
|
||
assert_eq!(entries_before, 0, "夹具前提：这个目录此刻是空的");
|
||
|
||
let mut second = request("1.20.1", AdoptTarget::InstanceDir);
|
||
second.name = Some("Better-MC".to_string());
|
||
let b = adopt::adopt(&root.game(), &root.launcher(), &second).expect("第二次登记");
|
||
assert_ne!(b.run_dir, a.run_dir);
|
||
}
|
||
|
||
/// **认领的目录还不存在**时也必须能比对出碰撞。
|
||
///
|
||
/// 场景：第一个实例用 `--isolation custom --game-dir <某路径>` 登记（custom 档**不创建**目录），
|
||
/// 那条路径恰好等于第二个实例缺省派生出来的目录名。第二个实例看到的目录「不存在、非空判据为假」，
|
||
/// 但它已经被第一个实例认领了。
|
||
///
|
||
/// 抓得住：`claims`/`dir_key` 只在「路径存在」时才比较（那样第二条 `run_dir` 相同的断言会红）；
|
||
/// 抓不住：跨卷/大小写之外的别名（例如 8.3 短名），本判据不覆盖。
|
||
#[test]
|
||
fn a_claim_on_a_not_yet_existing_dir_still_collides() {
|
||
let root = TempRoot::new("claim-missing");
|
||
foreign_minecraft(&root.game_root());
|
||
let default_dir = pack_dir::instance_dir(&root.launcher(), "Better MC");
|
||
assert!(!default_dir.exists(), "夹具前提：这个目录还不存在");
|
||
|
||
let mut first = request("1.20.1", AdoptTarget::Custom(default_dir.clone()));
|
||
first.name = Some("Better MC".to_string());
|
||
let a = adopt::adopt(&root.game(), &root.launcher(), &first).expect("custom 登记成功");
|
||
assert_eq!(a.run_dir, default_dir);
|
||
assert!(!default_dir.exists(), "custom 目标不该被创建");
|
||
|
||
let mut second = request("1.20.1", AdoptTarget::InstanceDir);
|
||
second.name = Some("Better-MC".to_string());
|
||
let b = adopt::adopt(&root.game(), &root.launcher(), &second).expect("第二次登记成功");
|
||
|
||
assert_ne!(b.run_dir, default_dir, "认领侧不存在也要能比对出碰撞");
|
||
assert!(
|
||
b.notes.iter().any(|note| note.contains("同一个物理目录")),
|
||
"碰撞要写进 notes：{:?}",
|
||
b.notes
|
||
);
|
||
}
|
||
|
||
/// **Win32 尾点/尾空格别名**：`custom` 认领 `Foo.`（目录还没建）与缺省派生 `Foo` 是**同一个物理目录**。
|
||
///
|
||
/// 复审 r2 的 R2.1：普通路径的尾点/尾空格会被 Win32 折叠，旧实现把尚不存在的尾段原样拼进比较键，
|
||
/// 于是第二次默认登记仍拿到 `Foo`（两次都 exit0、两个 UUID、同一物理目录）。
|
||
///
|
||
/// 抓得住：`dir_key` 只做分隔符/大小写归一（`Foo.` 与 `Foo` 键不等，第二条断言红）。
|
||
///
|
||
/// 抓不住：verbatim 路径（`\\?\…`）——那种写法**不**折叠，是另一个物理目录，见下一条用例。
|
||
#[cfg(windows)]
|
||
#[test]
|
||
fn a_trailing_dot_claim_still_collides_with_the_derived_dir() {
|
||
for suffix in [".", " "] {
|
||
let root = TempRoot::new("win32-alias");
|
||
foreign_minecraft(&root.game_root());
|
||
let claimed = pack_dir::instance_dir(&root.launcher(), &format!("Foo{suffix}"))
|
||
.with_file_name(format!("Foo{suffix}"));
|
||
assert!(!claimed.exists(), "夹具前提：认领目录还不存在");
|
||
|
||
let mut first = request("1.20.1", AdoptTarget::Custom(claimed.clone()));
|
||
first.name = Some("First".to_string());
|
||
let a = adopt::adopt(&root.game(), &root.launcher(), &first).expect("custom 登记成功");
|
||
|
||
let mut second = request("1.20.1", AdoptTarget::InstanceDir);
|
||
second.name = Some("Foo".to_string());
|
||
let b = adopt::adopt(&root.game(), &root.launcher(), &second)
|
||
.expect("第二次默认登记应成功（顺延到 -2，而不是复用同一目录）");
|
||
|
||
assert_ne!(
|
||
b.run_dir, a.run_dir,
|
||
"尾点/尾空格别名不许让两个实例共用一个运行目录（suffix={suffix:?}）"
|
||
);
|
||
assert!(
|
||
b.run_dir
|
||
.file_name()
|
||
.map(|name| name.to_string_lossy().ends_with("-2"))
|
||
.unwrap_or(false),
|
||
"应顺延成 -2：{}",
|
||
b.run_dir.display()
|
||
);
|
||
assert!(
|
||
!a.run_dir.exists(),
|
||
"custom 认领的目录不该被创建：{}",
|
||
a.run_dir.display()
|
||
);
|
||
}
|
||
}
|
||
|
||
/// 正向：**verbatim** 路径（`\\?\…`）不折叠 —— 它是另一个物理目录，必须允许并存。
|
||
///
|
||
/// 抓得住：归一化时盲目 trim（verbatim 的 `Foo.` 会被折叠成 `Foo`，这条第二次登记会顺延，
|
||
/// `-2` 断言红）。
|
||
///
|
||
/// 抓不住：别的重解析点形态；也不验 8.3 短名。
|
||
#[cfg(windows)]
|
||
#[test]
|
||
fn a_verbatim_trailing_dot_path_is_not_folded() {
|
||
let root = TempRoot::new("verbatim");
|
||
foreign_minecraft(&root.game_root());
|
||
let base = pack_dir::instance_dir(&root.launcher(), "Bar");
|
||
let verbatim =
|
||
std::path::PathBuf::from(format!(r"\\?\{}", base.with_file_name("Bar.").display()));
|
||
let mut first = request("1.20.1", AdoptTarget::Custom(verbatim.clone()));
|
||
first.name = Some("First".to_string());
|
||
adopt::adopt(&root.game(), &root.launcher(), &first).expect("verbatim custom 登记成功");
|
||
|
||
let mut second = request("1.20.1", AdoptTarget::InstanceDir);
|
||
second.name = Some("Bar".to_string());
|
||
let b = adopt::adopt(&root.game(), &root.launcher(), &second).expect("默认登记成功");
|
||
assert_eq!(
|
||
b.run_dir
|
||
.file_name()
|
||
.map(|n| n.to_string_lossy().into_owned()),
|
||
Some("Bar".to_string()),
|
||
"verbatim 的 Bar. 与普通 Bar 是两个目录，不该顺延"
|
||
);
|
||
}
|