 AskaEth
|
347a3cc90d
|
fix(game): 复审 r2 三项——Win32 尾点/尾空格别名 + 写面与游戏树重叠 + 更高祖先断链
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 重解析点未覆盖。
|
2026-11-09 23:56:02 +08:00 |
|
|
AskaEth
|
8110cde3f5
|
fix(game): 复审 r1 五项——运行目录不许被两实例共用 + 配置写面越界 + versions 断链 + 链接守卫反转 + 快照漏目录
复审 p2-5items 的五项，全部按「先能红的用例，再改实现」：
R1（默认目录可被不同实例隐式共用，产品缺陷）：新增 `adopt/run_dir.rs`——登记前读**每个已有实例**
的 `gameDir`（现役设置 + M27 前档案的遗留字段），用「真实路径 + 拼回不存在的尾段 + 大小写归一」
（Windows/macOS）比较；撞上就顺延 `<base>-2/-3…`（上限 32，撞满 `adopt_no_free_run_dir`）并在
`notes` 点名撞的是哪个实例；**非空且无人认领**仍拒绝（那是用户数据，不偷偷换目录）。这样
`Better MC` 与 `Better-MC`（slug 同名）、Windows 上 `Foo` 与 `foo`（同目录）都不会共用一个运行目录。
大小写归一在 macOS 上是**保守**选择：大小写敏感卷上会多一次顺延，换来的是「绝不共用」在任何卷上成立。
R2（配置写面 junction 写穿到外部游戏根，产品缺陷）：`run_dir::ensure_config_write_surface()`
在 `plan`（dry-run 也报）与 `adopt`（写盘前）各核一次——`config/`、`config/instances/`、
`profiles.json` 的真实落点必须在 `<.ULL>` 内，且**不得经链接落进游戏根**（错误按真实归属分类：
「逃出 .ULL」vs「落进游戏根」）。`.ULL` 本身在游戏根内是布局事实，附加判据在该布局下零判别力，
主判据仍然拦下一切跑出 `.ULL` 的落点——这不是给链接开后门。新码 `adopt_config_surface_unsafe`。
R3（dangling versions 被当不存在，产品缺陷）：`scan` 的 `read_dir` `NotFound` 再三分——
`lstat(versions)` 看见入口（断链符号链接/目录联接/目标被移走）或游戏根解析失败（祖先断链）⇒
`adopt_versions_unreadable`；两者都不是才算「真没有」。`inspect` 也补了同族判据（条目存在但
不是可读目录 ⇒ `directory_unreadable`，不再混成「没装」）。
R4（强制链接测试逻辑反转，假绿）：`fixture::link_gate(created, required) -> Run|Skip|Fail` 是纯
真值表，`link_guard_with()` 显式传参（`link_guard()` 只读环境变量）；新增
`link_guard_executes_all_three_branches` 用 `catch_unwind` **执行** Fail/Skip 两个分支。
四处调用点统一走 guard；建链接/联接的夹具收进 `fixture.rs`。
R5（快照遗漏目录节点，假绿）：新增 `tests/adopt/snapshot.rs`——全节点快照（根/目录/文件/链接
各记类型 + 适用 mtime；目录记 mtime、链接只记目标不跟随、Windows 用重解析点属性认 junction、
读盘失败直接 panic）。**CLI 测试用 `#[path]` 复用同一份**，判据只一处；新增 `fixture_cases`
五条工具自测，`plan`/dry-run 的零写盘判据改用 `snapshot_opt`（连空目录都不许出现）。
验证（本轮持久日志，`target/m221-r1/`，git 忽略、不入库）：
- `cargo fmt --all --check` 0；`cargo check -p unlucky-core -p unlucky-cli --all-targets` 0；
- `cargo test -p unlucky-core --test adopt` **37 passed / 0 failed**（另跑一次
`ULL_ADOPT_TEST_SYMLINK_REQUIRE=1` 同样 37 passed）；
- `cargo test -p unlucky-cli --test adopt_test` **11 passed / 0 failed**；
- `cargo clippy -p unlucky-core -p unlucky-cli --all-targets -- -D warnings` 0；
- 四次**实现-only 变异**（缺省不查认领 / 配置写面不核 / versions 的 NotFound 当空 / 快照不记目录）
全部以**断言红**收场（不是编译错误、不是环境错误），每次还原后与基线清单逐文件一致，收尾再跑绿。
界限：只覆盖 core+cli 的定向目标（不等于 workspace 全量）；没有启动真实 Minecraft；GUI 未接；
判据是检查那一刻的快照，TOCTOU 与非 junction 重解析点仍列边界。
|
2026-11-09 23:13:57 +08:00 |
|
|
AskaEth
|
9f5c001387
|
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`）。
|
2026-11-09 22:21:37 +08:00 |
|