AskaEth/Unlucky-Launcher
1
0 Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity
767 Commits 3 Branches 7 Tags
5479f25068cdf50f8b61fd30ebba14df8711138a
Commit Graph
5 Commits
Author SHA1 Message Date
AskaEth 32384b952e chore(presenter,app-iced): 复审 r2 三项（文档对齐 / 拆 dialog.rs / 收窄关闭路径） 
1. 文档自相矛盾（复审 r2 第 1 项）：`SavesState::apply` 的文档还写着「无论成败都清『在飞』与
   『确认中』」——改完之后这是假的，而且与模块文档「安全判据第 3 条」互相打脸。现在逐支写清：
   `Ok` 清 draft/pending、`confirm` 只在被确认的世界已不在快照里时清并登记 `closed_confirm`；
   `Err` 只清 pending。生命周期表里的 `dismissed` 改成真字段名 `closed_confirm`（消费点是
   `app/state/refresh.rs::settle_saves_confirm`）。

2. 拆 `app/update/dialog.rs`（复审裁决）：397 行里 262 行是内联 `mod tests`，而它装的是
   主按钮 / Esc / 次按钮三条不可逆分支。照仓内先例（`app/dialog.rs` + `app/dialog/tests.rs`）
   把测试体搬到 `app/update/dialog/tests.rs`，**纯搬移**：`dialog.rs` 397 → 138，
   `dialog/tests.rs` 262；从 `6c87e2a` 的 `dialog.rs` 里抽出 `mod tests` 去一层缩进后与
   新文件**逐行比对 0 处差异**（262 = 262）。

3. 收窄关闭路径（复审 r2 加固）：`SavesState::close_confirm(current)` 只在 `current` 等于登记的
   那个框时才清；`clear_confirm()` 保持无条件（换实例/复位用）。`escape()` 与 `Secondary|Dismiss`
   改成传当前框 id。新用例 `closing_another_dialog_leaves_our_target_alone`（别人关框不清我们的
   目标；自己关框才清）。
 2026-11-11 14:25:26 +08:00
AskaEth 6c87e2ad8a fix(presenter,app-iced): 删除确认绑定到对话框身份 + 快照不再吃掉目标（M247 r2 复审） 
复审 r1 P1-1（安全）：`SavesState::confirm` 的「关闭即清」在 Esc 这条路径上没有落实，
而主按钮分支无条件先取目标 —— 「删存档 → Esc → 崩溃卡片 → 导出诊断包」会静默删掉那个世界。

两层修，各自有独立用例钉住：

1. **认框不认人**：`confirm` 改成 `Option<(DialogId, String)>`，`take_confirm(current)`
   只在 id 相等时交付；`DialogMessage::Primary` 传 `dialogs.current().id`。即使别的路径漏清，
   也核销不了别人那个框。用例 `a_leaked_target_cannot_be_redeemed_by_another_dialog`
   （去掉 id 校验即红：实测「漏清的目标被别的框兑现了：世界被静默删除」）。
2. **关闭路径补全**：`update/dialog.rs::escape()` 补 `clear_confirm()`（次按钮/遮罩早就清了，
   Esc 漏了）。用例 `escaping_the_delete_dialog_disarms_it_for_the_next_one` 复现整条事故链，
   断言没有下发 `DeleteWorld`、框走自己的路关掉（去掉这行即红）。

P2-1：`changed()` 不再无条件清 `confirm`（一拍无关快照会让主按钮变成静默空操作）——
只在「被确认的世界已经从快照里消失」时清，并登记 `closed_confirm` 让 app 层**收起那个框**
（`refresh_view → settle_saves_confirm`），避免留一个点了没反应的按钮。`failed()` 同理不动 confirm。
用例：`an_unrelated_snapshot_keeps_the_confirmation_redeemable`、`a_vanished_world_closes_its_confirmation`、
`an_unrelated_snapshot_no_longer_drops_the_confirmation`、`the_confirmation_is_dropped_and_reported_when_the_world_vanishes`。

P2-2：`catalog/instances.rs` 那段「这一版只读 / InstancesSavesReadOnly」的陈旧说明改成现状
（写操作已接上，边界由 core 的 `write::boundary` 守）。

拆分（400 行）：`presenter/src/state/saves.rs` 的交互态方法 → `state/saves/interaction.rs`、
判据 → `state/saves/tests.rs`；`app/update/dialog.rs` 的接线用例内联在该文件（5 条）。
 2026-11-11 13:51:07 +08:00
AskaEth 8c67e4eca6 fix(presenter,app-iced): 「游戏在跑」挡在落 core 之前（M247 r2） 
塔裁决：三个写操作在实例启动/运行时必须拒，判据不能只靠界面灰按钮 ——
Windows 上是 os error 32 兜底，**Linux 上删一个正在跑的世界会成功**，那是在
用户玩到一半时把存档删掉。

- host/dispatch.rs：`AppCommand::Saves` 与 `AppCommand::Mods` 同款，先查
  `CoreHost::in_flight(&id)` 再把 `running` 传下去
- host/saves.rs::dispatch 增 `running`：为真时三个写操作**不 spawn、不碰盘**，
  直接回一条 `SavesFailureKind::GameRunning` 的结构化失败；读路径与「打开文件夹」不受影响
- dto：新增 `GameRunning` 类别（不折进 WriteFailed —— 那不是"写失败"，是"我们主动没写"）
- i18n：「游戏正在运行（先退出再操作）」中英成对 + 金表同步
- 用例：在飞时三条写命令盘上指纹不变/世界还在/备份落点没建，且回 GameRunning；
  反向用例钉住闸门没有把写操作一并关死；UI 侧断言三种动词的主句都不出现「写盘失败」且不画重试
- 拆分（400 行）：host/saves.rs → host/saves/write.rs；两处测试各拆出 write 子模块
- SavesState 模块文档补「生命周期」表：draft / pending / confirm 谁写谁清、何时必须清，
  并把 confirm「取走即清」（连点两下不删两个）写成安全不变量
- 出图：ULL_SAVES_FIXTURE=running 一张（失败那句话的样子）
 2026-11-11 13:29:56 +08:00
AskaEth c921b9c185 feat(core,presenter,app-iced): 存档三个写操作（重命名 / 删除 / 备份）+ 行操作区（M247 SAVESOPS） 
core::game::saves 新增 write 模块，三个入口的第一句都是 boundary::guard：

- rename_world：saves/<old> → saves/<new>，撞名/同名/非法名字各自具名拒绝
- delete_world：递归删（不跟随符号链接、层级上限 64），先过边界校验
- backup_world：流式 zip（限额预检 → 临时文件 → 原子改名），
  <世界名>-YYYYMMDD-HHMMSS.zip，撞名顺延，绝不覆盖上一份

guard 三道判据（每次写前重做，不信任调用方）：名字必须是单段裸名字；
saves/ 必须是运行目录的真实直属子目录；世界目录必须是 saves/ 下的真目录
（解析后比父级，不比字符串前缀）。落点目录要求绝对路径（相对路径会落到进程 CWD，
实测过一次）。

presenter：SavesCommand 增 RenameWorld/DeleteWorld/BackupWorld，host 三个后台入口
写成功后重新列一遍目录并把「回执」挂在快照上（SavesOped：改名两端 / 被删的名字 /
备份落点+字节数+跳过的链接数）。SavesFailureView 增 file 与 op，写失败八类一一对应。
SavesState 增 draft / pending / confirm 三样交互态（草稿是行内输入缓冲，
pending 与 ModsState::pending 同一条先例，confirm 是删除确认框在等谁）。

app-iced：世界行右侧重命名/备份/删除；行内输入框改名（现成模态队列没有「输入变了」
这一条消息，用输入模态等于重写一套）；删除走现成 modal 的 Confirm，主按钮落点接在
app/update/dialog.rs。回执行画在卡片里（备份落点看不见就是静默失败）。

i18n：新增 25 条中英成对 key + 金表同步；删掉 M235 的「这一版只读」那条（写操作接上
之后它是假的）。出图夹具 ULL_SAVES_FIXTURE=rename|confirm|backed-up 三种形态。
 2026-11-11 13:29:56 +08:00
AskaEth f217d83680 feat(saves): 实例存档 / 截图的只读列表与打开文件夹（M235 STOREMVP） 
用户诉求是 PCL 差距四项里的「存档截图 / 导入」，M230 审计确认三层全缺。塔裁决 U3
把这一版钉成「只读列表 + 打开文件夹」，不做缩略图墙（缩略图要引图片解码依赖，而
AGENTS §2 只允许 palette-extract 引 image 类依赖；截图/导入产物形态也没定型）。

core
- `game::saves`（新）：只读列 `<run_dir>/saves`（世界目录）与 `<run_dir>/screenshots`
  （图片文件）。只调 symlink_metadata / read_dir / metadata，不建目录、不写文件、不读
  文件内容（`icon.png` 只判存在）。目录不存在 ⇒ 空列表不是错误；存在但不可用（符号
  链接 / 不是目录 / 读不了）⇒ 具名错误。条目级异常逐条登记原因，不静默丢。
- `platform::opener`（新）：`open_dir` 是**目录**打开器的唯一收敛点（explorer / open /
  xdg-open），内部复用 `child::quiet`，cfg 分支只此一处。塔明确要求按 AGENTS §6 放
  platform 而不是业务模块，并要一条可执行判据防退化
  （`the_launcher_literals_live_here_only` 扫 `crates/core/src`：除本文件外不许出现
  `"explorer"` / `"xdg-open"` 字面量）。

presenter
- `dto::saves`：SavesCommand（List / OpenFolder）、SavesListView、SavesFailureView
  （结构 + OS 原文，不拼中文）、`SavesListView` 的计数助手。
- `host::saves`：走 `job::spawn`，UI 只收快照；运行目录仍是
  `isolation::derive_game_dir` 的同一个答案（与启动 / mod 列表同源，**不写盘**）。
  「打开文件夹」打开哪个目录由 host 定：`saves/` → `screenshots/` → 运行目录。
  失败分三类（InstanceUnavailable / DirUnusable / OpenFailed），可重试。
- `state::saves`：快照整体替换、迟到结果丢弃、失败保留绑定（重试才有意义）。
- 接线：CoreEvent::Saves / AppCommand::Saves / HostTask::Saves。

app-iced
- `pages::instances::saves`：详情页 SAVES 卡片（MODS 之后、启动参数之前；**不套第二层
  滚动条**，整列那一条是唯一入口）。世界行带 UTC 时间与「有图标」，截图行带大小与时间；
  第一行固定画「这一版只读」（U3 边界让用户看得见）。读盘失败画一条红字 + 「重试」；
  打开文件夹失败**不画**重试（那个动作的重试就是再点一次按钮）。
- 接线：Message::{ReloadSaves, OpenSavesFolder}、`sync_saves`（与 `sync_mods` 同一判据）、
  Model::saves、`saves_shot` 出图夹具（ULL_SAVES_FIXTURE=1）。

i18n
- `InstancesSaves*` 20 条中英成对，catalog 与金表在**同一条锚点**后追加、逐字节一致。

证据
- core 只读判据：`game::saves::tests` 在真盘建世界/截图，调用前后各拍一次
  （相对路径, 是否目录, 字节数, mtime）指纹并逐条比对；另有用例钉「目录缺失不建目录」。
- presenter：`host::saves::tests` 真盘端到端（custom 档位派生运行目录 → 快照）。
- GUI：`--software-renderer` 1180×760 浅/深各一张 + 1180×1280 两张「整块卡片可见」
  （1180×760 下 SAVES 卡片位于折叠线附近，只能看到卡头；第二对用 ULL_WINDOW_SIZE
  把窗口拉高，口径与 M98 的矩阵一致），落 `DevDocs/artifacts/M235/`。

没做的（U3 边界内，见 handoff）：缩略图墙、导入、删除/重命名、`level.dat` 的
LevelName 解析（世界名暂时就是目录名）。
 2026-11-11 06:00:27 +08:00