8 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	90b233088f	feat(core): M112 整合包导出（mrpack 优先 + CF 清单，逐文件远程判定与内联兜底） ... 新增 addon::export（实例目录 → .mrpack / CF manifest.json）： - 逐文件三分：远程引用 / 内联进 overrides/ / 跳过（读不了、符号链接、路径不安全）。 「能否被远程替代」= 目录能证明身份（Modrinth SHA-1、CF 指纹）**且**目标格式表达得了； 证明不了的一律内联，绝不丢、绝不编，逐条进结构化报告（ExportReport）。 - game / dependencies 来自实例快照：versions/<id>/<id>.json 的继承链「叶子」+ 库坐标推加载器， 不解析 <mc>-<loader>-<ver> 字符串（社区实例名不统一，那是猜）。 - .disabled 走路径后缀（不是 env.client=optional：后者装回来默认启用，跨启动器不保真）。 - CF files[] 只写能确定 projectID/fileID 的项；禁用文件 CF 表达不了，内联并记原因。 CF modLoaders[].id 按官方写法：NeoForge 在 1.20.1 上写 neoforge-1.20.1-<ver>。 - 尺寸护栏：fileSize 超 u32 报 pack_limits；整包撞 ZIP64 阈值由 format::write 拒绝。 配套改动： - pack/curseforge/fingerprint：MurmurHash2-32 + 0x09/0x0A/0x0D/0x20 过滤、seed=1、 长度用过滤后长度、哨兵 811513880 短路；金标准由一份独立 Java 实现算出（双向验证）。 - pack/format/payload：PackPayload 加 with_sources（包内条目名 → 实例源文件）， 让「实例里的 mods/x.jar → 包里的 overrides/mods/x.jar」不用拼路径。 - pack/format：写盘时按未压缩总量守 ZIP64 阈值。 - pack/modrinth：禁用位改写路径后缀；fileSize 按 u32 校验。 - pack/manifest：PackLoader::curse_id_for 处理 NeoForge 的 MC 前缀特例。 测试：导出管线 10 条 + 往返保真 4 条（三种格式夹具；允许的差异逐条在测试文件头登记， 并在报告 notes 里给出）。M111 未合并，故本轮「导入」用 M110 的 read + 同形实例目录， 真 import_pack → export → import_pack 端到端留作欠账。	2026-11-04 21:32:37 +08:00
AskaEth	29f531db23	fix(addon): M111 r6 —— 失败文案按 rolled_back 分叉，补「回滚不完整」报告级用例 ... 复审 r6 的两条（都在同两个文件里十来行）： 1. 文案位自相矛盾 - 改前：`pipeline::failed()` **无条件**推「目标目录保持导入前的样子」，`record_rollback()` 随后可能再推「有 N 项未能回滚（目标目录可能与导入前不同）」——同一份 warnings 自相矛盾； CLI `status_label` 也恒写「失败（已回滚）」。 - 改后：`failed()` 只落错误、**不宣称目标目录状态**；口径拆成两个具名入口—— `abandoned()`（失败发生在碰目标目录之前，才说「目标目录未被写入」）与 `record_rollback()`（完整 ⇒ `rolled_back=true` + 「恢复为导入前的样子」；不完整 ⇒ `rolled_back=false` + 逐项列失败项）。CLI `status_label` 按 `rolled_back` 分叉成 「失败（已回滚）」/「失败（回滚不完整）」；`keys.rs` 的状态文档与 pipeline 模块文档表 同步改口径。 2. 新接线零测试（这是 fix-then-merge 的理由） - 新增 `pipeline::tests` 三条报告级用例： `incomplete_rollback_never_claims_the_target_is_untouched`（`rolled_back=false` + warnings 逐项列出 + **不含**任何「保持导入前的样子 / 未被写入 / 恢复为导入前」）、 `complete_rollback_claims_consistency_exactly_once`、 `pre_commit_failure_claims_untouched_only_via_abandoned`。 变异自证（本轮实测，均已还原）： - A：把 `record_rollback` 的分叉整体跳过（no-op）→ 2 条红（`失败项要逐条列出：[]`、 `assertion failed: report.rolled_back`）。 - B：把 `failed()` 恢复成无条件推「保持导入前的样子」→ 2 条红，报错原文即自相矛盾现场： `["…目标目录保持导入前的样子…", "有 1 项未能回滚（目标目录可能与导入前不同）…"]`。	2026-11-04 21:19:58 +08:00
AskaEth	7f657d225c	fix(addon): M111 r5 —— 基线读写同源（.ull）、plan.rs 拆回 400 内、中间产物/回滚/包身份 ... 复审 r5 两条 P1 + 三条 P2。 P1-1 基线读、写走了两条路径（ext4 上是两个文件，Windows/macOS 上假绿） - 写侧 pipeline 用 `LAUNCHER_HOME_DIR`（`.ULL`，启动器**数据根**的名字），读侧 `PackBaseline::path()` 用 `GameLayout::ull_root()`（`.ull`，实例**游戏根**内的私有目录）。 - 现在读写都从 `ull_root()` 派生：`PackBaseline::path()`（绝对）+ 新增 `PackBaseline::relative_path()`（相对，空根求 `ull_root()`），pipeline 的 `baseline_relative()` 只做 `/` 分隔，不再出现第二份目录名字符串；`LAUNCHER_HOME_DIR` 的引用从导入链路里删掉。 - 新断言 `baseline_read_and_write_paths_are_the_same_file`：`path(root) == root.join(relative_path())`、`read.parent() == ull_root()`、写侧字符串不含 `.ULL` （路径比较是大小写敏感的，所以在大小写不敏感的系统上也抓得住）。 - 选 `.ull` 的理由：基线住在**实例的游戏根**里，那是 `GameLayout` 的地盘（且 `crates/core/tests/game/layout.rs:45` 早已钉死 `.ull`）；`.ULL` 是 portable 模式下 exe 旁边的启动器数据根（`config/ data/ cache/ logs/`），层级不同，不能混用。 - 同时清掉 4 个测试里手抄的 `.ULL/pack-baseline.json`，改用 `baseline_rel()`。 P1-2 `import/plan.rs` 401 行撞穿 file-size 守门 - 把 `suffix_note()`（后缀注记）连同它的单测搬进 `plan/paths.rs`（那里本来就有 `suffix_variant`），plan.rs 401 → 373；paths.rs 119 → 157。没有压注释换行数。 P2-1 引擎中间产物会被当成内容提交 - `Staging::purge_engine_artifacts()`：提交前递归剔除 `.ullpart-*` 与 `.ullmeta.json` （判据 `is_engine_artifact`，后缀取自 `core::download::atomic`），删掉的个数进报告注记。 - 测试：`StubFetcher::with_engine_artifacts()` 像真引擎那样在每次"下载"后留下残片， 断言实例目录里没有任何 `.ullpart` / `.ullmeta`。 P2-2 回滚失败被 `let _ =` 吞掉 - 新增 `RollbackOutcome { attempted, failed }`：`rollback_merge` 逐项记账， `CommitGuard::rollback()` 返回它，提交阶段失败时 `CommitFailure { error, rollback }` 把两者一起交回调用方；`ImportReport` 新增 `rollback` 字段，`rolled_back` 改成 "回滚完整 / 从未写过目标目录"才为 true，不完整时 `false` 并在 warnings 里列失败项。 - CLI 人读输出相应分叉（`回滚未完整：N 项没回去`），不再无条件宣称一致。 - `Drop` 那条兜底路径仍拿不到调用方（文档写明是"防漏"不是"承诺"）。 - 单测：`complete_rollback_has_no_failures` 与 `rollback_failures_are_reported_not_swallowed` （用非空目录占住目标位置，让 remove/rename 都失败，跨平台确定）。 P2-3 基线不校验包身份 - `PackBaseline::matches_pack(format, name)`：同一目录先后导入两个包时，别人的基线一律 不拿来当 base（否则"用户改过"会被误判成"整合包升级"而静默覆盖），降级为"无基线"并 记 `pack.import.note.baseline_pack_mismatch`。 - 测试 `baseline_of_another_pack_is_not_used_as_base`：断言告警 key + 冲突降级为 pre_existing + 用户内容保留。 门禁（落盘读 $?）：fmt 0 / clippy(workspace,all-targets,-D warnings) 0 / test -p unlucky-core 0（363 lib）/ test --workspace --exclude unlucky-app 0（1993 passed）。 改动文件最大 373 行。core 依赖表未动（core-no-ui 不受影响）。	2026-11-04 20:54:05 +08:00
AskaEth	4760714743	feat(addon): M111 整合包导入管线（CF / mrpack / MultiMC）+ ull pack import ... 接 M110 的 pack 模型与安全闸，做导入：三格式 → 实例目录，落 D10 §2 三条硬要求。 core（`addon::import`）： - 三方合并：`merge::decide` 判据表（磁盘 × 基线 × 包内），base 侧落在 `<实例根>/.ULL/pack-baseline.json`；无基线时磁盘同名文件算用户已有内容 ⇒ 不覆盖。 冲突逐条进报告（user_modified / user_deleted / pre_existing + 可选处置）。 - 两阶段：先 overrides 再补远端；失败分级只有一条判据（是不是"某个文件搞不到"）： 缺文件 ⇒ Partial；穿越/符号链接/限额/清单坏/摘要不符/IO ⇒ Failed 且整包回滚。 - 事务：`Staging` 临时目录 + `CommitGuard`（全新导入 rename 整目录、合并态 journal 逆序 回滚、Drop 即回滚），基线作为最后一个暂存文件同生共死。 - 三格式语义：mrpack `client-overrides` 胜 `overrides`、`server-overrides` 不解压； `.disabled`/`.old` 按路径后缀识别并原样保留；MultiMC `formatVersion != 1` 整份拒绝、 非加载器 component 逐项进报告；CF `classId` 认不出就不猜。 - 加载器只做翻译（`LoaderTarget`：kind + 原版 + 加载器版本 + 版本 id，含 CF NeoForge `1.20.1-47.1.106` 的 MC 前缀剥离），网络全部经注入的 `PackFetcher` （生产实现 `DownloadEngineFetcher` 只走 core::download，无第二个 reqwest client）。 - 报告：三态 + 逐项原因 + 稳定文案 key 表（`report::keys`，含 ALL 守门表）。 CLI（`ull pack import <file> [--target] [--name] [--overwrite] [--no-register]`）： - 退出码三态 0 / 3 / 1（`Outcome::exit_code` + runner 透传，其它命令仍 0）； - `--json` 恒有信封（`data.status` / `data.error.code` / `data.stages`），Failed 不抛栈。 测试：29 条 core（三格式端到端、合并 6 条、必须先失败 8 条含双检互补样本与确定性 提交失败回滚、报告契约 5 条）+ 5 条 CLI（三态退出码、JSON 契约、既有命令回归、help）。 fmt / clippy(core+cli, -D warnings) 绿；文件全部 ≤400 行。	2026-11-04 20:54:04 +08:00
AskaEth	34f3db359a	fix(core): M110 r2 —— duplicate_override_paths 两种冲突同时报，补 mrpack 同侧分支用例 ... - p2-2：`duplicate_override_paths` 改成「先按 path 分组，再在组内报 (侧集合, 条目份数)」， 判据 `侧数 > 1 || 份数 > 侧数`。r1 修好了跨侧（Both×Client）但按侧去重把「同侧两个组 撞同一路径」这条旧能力换掉了（实测返回 []）；现在两种冲突同时报得出来，返回值升为 `Vec<(String, Vec<PackSide>, usize)>`（M111 注意：这是最后一次改形状的窗口）。 - p3-a：mrpack `check_overrides` 的「每侧只能有一个覆盖目录」分支补用例（此前零测试， 删掉它 54 条全绿；现在删掉即红）。 - p3-b：把 ReadBudget 的「每次调用一份额度，不是整包一份」写进 `override_files` / `ReadBudget` 文档（mrpack 连调三次 ⇒ 理论上限 3×；要整包共用额度就走 `override_files_with`；`open` 阶段的声明总量仍是整包一次）。 - 顺带（复审点名、各一行）：mrpack 非表达目录的 hint 里 21 个连续空格； curseforge 文档里 `.minecraft/.minecraft/…` 的说法按 CF 语义订正（overrides 是 zip 内前缀， 内容铺开不丢；要不要多拷一层取决于导入器）。	2026-11-04 00:20:25 +08:00
AskaEth	6dd652aced	fix(core): M110 r1 复审修复：导出安全闸、跨侧重名、第二检用例、半包与失败分级 ... 按 tower 裁定清单逐条改，不扩战场（模型与扩展点未动）。 - p2-1 跨格式导出不再静默丢内容：`PackFormat::check_overrides` 在默认 `write` 写第一个 字节前判定"这份模型的覆盖目录集合能否被本格式表达"。mrpack 要求目录名由 side 决定 （overrides / client-overrides / server-overrides）、CF 只接受单一 Both 侧组；表达不了 即 `pack_unsupported` + hint。`format.rs` 模块文档写死"默认 write 只保证同格式往返"， 并列出 M112 必须补的四件事（目录映射、side 合并、加载器 id 规范化、extra 分桶）。 - p2-2 `duplicate_override_paths` 改为按 `path` 跨侧计数，返回 `(路径, 侧集合)`； Both×Client 同路径这条 mrpack 真实冲突现在查得出来。 - p2-3 补 `#[cfg(windows)]` 第二检用例（CON / NUL / COM1.txt / `a.` / 尾空格 / 通配符）， 并订正 `archive.rs` 文档里"保留设备名这里不拦"的自相矛盾（实际由 enclosed_name 在 Windows 宿主上拦，第一检放行）。 - p3-1 导出改临时文件 + rename，失败清理临时文件：目标路径不再留半个 zip。 - p3-2 三个 `detect` 不再 `.ok().flatten()` 吞错误：清单在但读不出来 = `pack_metadata`； 注册表汇总时"命中优先于失败"，一个都不命中才报，最后才退化成 `pack_unsupported`。 - p3-3 `env_extra`、CF `files[].extra`、`PackLoader::extra` 各补一条读→render→写→再读用例。 - p3-4 新增 `ReadBudget`（Cell<u64>）：`override_files` 持有累计预算，按实际读出字节 逐条扣减，声明大小撒谎的包不能靠"很多条各自合规"绕过 `max_uncompressed_bytes`。 - CF 读侧始终产出一个 Both 侧 overrides 组（字段缺省 `overrides`），与 render 对称。 每处修复都有变异证据（改坏 → 对应用例红）：p2-1/p2-2/p2-3/p3-1/p3-2/p3-3a-c/p3-4 共 9 条。 门禁：fmt 0 / clippy --workspace --all-targets -D warnings 0 / cargo test --workspace -j 4 exit 0（58 个 test binary，passed 1930，failed 0）；全部改动文件 ≤400 行（最大 389）。	2026-11-04 00:20:24 +08:00
AskaEth	b34e86bba5	feat(core): 整合包格式无关模型与格式扩展点（M110） ... 从零建 `core::addon::pack`：格式无关中间模型 + 格式扩展点 + 安全读取层， 不碰网络、不碰 UI（core-no-ui 依赖表未变）。 - `PackManifest` 无损表达 CF / mrpack / MultiMC 三方字段：包名/版本/作者/简介/ 格式版本/游戏版本/加载器依赖/文件条目/覆盖目录；`files[].hashes` 保留整张摘要表 （mrpack 允许 sha1+sha256+sha512+md5 共存），`disabled` 记语义（导出按 D10 映射成 env.client=optional，CF 落 required=false）。 - 未知字段按条目用 serde flatten 接住（清单顶层 / CF `minecraft` 对象 / 文件条目 / env / 加载器条目），导出时并回且已知字段优先；两格式各有一条「读→写→再读相等」测试。 - `trait PackFormat`（id / label / metadata_entry / detect -> Option<证据> / read / render / 默认 write）+ `PackRegistry`：注册表顺序即优先级，写死 CurseForge → Modrinth → MultiMC；同一份包命中多格式时 `also_matched` 暴露歧义。 测试里用一个 toy 格式（单文件、一行注册）证明扩展点真的可扩展。 - `PackArchive` 把目录与 zip 统一成规整条目表：路径穿越双检（自研七条规则 + zip crate 的 enclosed_name）、符号链接条目拒绝、条目数/解压体积/单条目上限、 规整后重名拒绝、篡改载荷不当场吞掉；每条都有恶意样本测试。 - 格式实现：CF 可读写（缺路径如实记 None）、mrpack 可读写（强制 sha512 形状、 env 三态、三个覆盖目录成三侧）、MultiMC 只读（.minecraft 当覆盖目录， 组件顺序与非加载器组件全保留）。 - 三种格式各一个手造夹具（含截断 TOML / 半截 jar / 零字节 jar），来源在 `tests/fixtures.rs` 里声明为手造，不冒充真实导出。	2026-11-04 00:20:24 +08:00
AskaEth	bc41dfcf7d	Unlucky Launcher v0.0.1-alpha ... Rust 原生单文件 Minecraft 启动器：CLI 完整可用（install/launch/accounts/java/diagnose/agent）， MCP server 接入外部 Agent 工具，GUI 开发中。	2026-10-31 21:54:10 +08:00