AskaEth/Unlucky-Launcher
1
0 Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
833 Commits 3 Branches 7 Tags
0e5944045a94e4b5290fddaf9bbe99ed25b9b7a6
Commit Graph
337 Commits
Author SHA1 Message Date
worker-mirrorwire 69e3e198bf fix(download): M294 r1 —— JDK 下载页与 CLI 也接上源选择，文档同步 
复审 p1：发布版 GUI 的「下载 JDK」页是第二处 DownloadEngine::new（要 with_progress
拿走引擎），此前只读了 gh_proxy，region / mirror_preference 到不了那里；报告却把 GUI
写成「已接」。复审 p2：CLI 四条命令同样不认这两个键 —— 同一份 launcher.json 在 GUI 与
CLI 上表现不同，等于把「设置项说假话」挪到 CLI 侧。

- app-iced downloads/engine.rs：新增 SourceSelection（只读键、不翻译）+
  engine_with(.., &SourceSelection)，在 gh-proxy 三态之前叠
  DownloadTuning::with_source_selection(..).apply_source_selection(..)
- Request 加 source_selection 字段，构造点（app/update/settings/java/downloads.rs）
  用 SourceSelection::of_config(&config) 显式传值（不从缓存根反推配置路径：
  反推失败会静默按 auto 收场，正是本 mission 要消灭的形状）
- cli download.rs 的 tuning()：链 .with_source_selection(..)，四条命令共用这一处装配
- core 的 summary()：把「地区 / 镜像偏好」两档印进 CLI 那行生效值（CLI 既然读了，
  少印两项就是新的半真话）
- shared.rs 注释说清「共享引擎」与本文件的第二处装配点；app-iced 模块头补对照表
- 新判据：JDK 下载页与 CLI 各一条断候选源顺序的用例，均配变异验证（换回裸
  EngineConfig::default() / 裸 tuning 即红）；补一条 region=cn + gh_proxy=off 的
  叠加次序守卫（复审 P3-2）
- docs/download-settings.md：§1 表格两行、§5 拆「已接 / 未接」、新增 §3.1.1 覆盖面
  表、§6 补 M14-M16 三条变异、§7 补「镜像可达性没验」

连带（不加就编不过，已报备 tower）：downloads/tests.rs 的 Request 字面量 +1 行、
downloads/tests/gh_proxy.rs 两处 engine_with 调用点补第四参。
 2026-11-13 09:00:00 +08:00
AskaEth 9780fca1c7 fix(app-iced): blend 用例端点改用真实令牌色（M288） 
`blend_hits_both_endpoints_bit_for_bit` 原先用 `Color::from_rgb(0.1, 0.2, 0.3)` /
`(0.7, 0.8, 0.9)` 当端点，撞上 `tests/no_hardcoded_tokens.rs` 的色值守门（它扫 `src/**`，
测试模块也算在里面），使 base 上「全量测试绿」永不可达。

修法在**被判的那一侧**：端点取状态层真正会插值的一对角色——`Role::Surface`（容器）与
`Role::OnSurface`（内容）——经产品同一条令牌路径（`BrandBoard::for_flavor(..).scheme()`
→ `to_iced`）取值，浅/深两套板各跑一遍；判据值全部现算（每通道取两端 min/max）。

三条判据一条不少：端点逐位相等、中点**严格**落在两端之间（比原先的闭区间更强）、α 全程 1.0。
守卫文件一行未改（仍 400 行），扫描范围没有放宽。
 2026-11-12 23:55:24 +08:00
AskaEth 5174845cda fix(app-iced): 列表行圆角改从组件表取（M287） 
`list_item.rs` 硬写 `ui.radius_dp(ShapeScale::None)`，旁边还写着「4.x：ListItem 的形状
是 `CornerNone`（直角），没有圆角档」——而令牌表 `component_map::table` 的 `ListItem`
是 `Small(8)`。产品侧根本没读表，注释在替错误站台。

改为 `row_border(ui)` → `ui.radius_dp(Component::ListItem.spec().shape)`，数值只留在
令牌表。变异实测（只改表的那一行 `Small→Large`）：行圆角 8 → 16，240×60 选中行的顶行
缩进 6 → 13；改回后 11 张图逐字节复原（`DevDocs/artifacts/listradius/`，不入库）。

同 commit 改掉那条直角注释、模块文档补 4.9 行，并加两条单测：渲染路径的
`Border.radius` = 表值折算；源码里不许再出现硬编码的 `ShapeScale::*` 档。

外观影响的边界（写进取证报告）：行只在 选中/悬停/按下 时有容器色，未选中静息与禁用
两态 `fill` 为 `None`，那两态逐字节不变是**正确**的，不是没生效。
 2026-11-12 23:38:56 +08:00
AskaEth 5ce6d8567b docs(app-iced): 残余清单改成「残留快照，不是契约」（M285 r3 p2-1） 
r3 复审的判据改成「不假」而不是「穷尽」，按它给的结构重写这一段：
- 删掉「**所有** components::selection 的 chip/switch 站点」（这个词两头都不准：字面上吞掉了
  已接的 general/language.rs + general/theme.rs 那 6 枚，又把另一个页面 pages/content 的 chip
  算了进来）；
- 第 3 条改成「还剩没搭线的那几处（已知：…；这一串会漂，接线时请更新）」，并补
  java/view.rs 运行时的「设为默认」chip（action_chip 在非默认行返回可点的 Chip::filter，
  runtime_row 没有 forced 形参）；同时明写 language/theme 那 6 枚已接、别算进残余；
- 新增第 5 条：ai/view.rs 的 base_url / model / api_key 三只 Field（此前四处都不落）；
- 末尾加「这份清单是残留快照，不是契约：接上一处就划掉一处，判据只有『有没有拿到 forced』」。

顺带订正 r3 的两条 p3（同一段、纯注释）：
- 主题 chip 枚数 2 → 3（general/theme.rs 的 THEME_MODES: [ThemeMode; 3]）；
- 第 4 条去掉「下载按钮」：java/download_view.rs 里一个 Button 都没有（那两处是 chip，已在第 3 条）。

第 1 条（Downloads 组 + e283c585… 三态 md5）与「已经消费的」「没搭线≠组件库缺能力」两句一字未动。
纯 //! 注释，零代码行。harness.rs 347 → 356 行。
 2026-11-12 23:12:21 +08:00
AskaEth a75ee465a7 docs(app-iced): harness 文档的残余清单改写（三条与代码不符的句子，M285 r2 p2-1） 
r2 复审逐句拿代码核过，三处不符：
(a) 「裸 iced::button 已经消费」—— 8 颗预设色块本身就是裸 button(...) 且不消费（accent.rs:153/
    163-166，ACCENT_PRESETS: [&str; 8]）⇒ 改成「这几类控件（choice / chip / action_button）已消费」。
(b) 残余清单漏了三类 ⇒ 补：Downloads 组整组（body 形参就是 _forced，switch/chip/两颗 Button::new
    都不看 forced；实测 --screen=download 三态 md5 全等 e283c585…）、所有 components::selection 的
    chip / switch 站点（update 自动检查 chip、ai provider/reveal chip 与开关、download 两处、java
    prefs_view 与 download_view）、java 的字段/预设/下载按钮（fields.rs / prefs_view.rs /
    download_view.rs）。同时修掉与本 mission 自己的 artifact README §1「下载页不消费 forced」的
    互相打脸。
(c) 「要接得先给组件开口」对滑块/文本框是假的 ⇒ Slider::state / Field::state / Chip::state /
    Switch::state 全都存在且被消费（gallery 矩阵用的强制视觉态），没接是**没搭线**；真正缺 forced
    入口的只有本地助手 accent::swatch。并加一句反向锚：别把「裸 button」当「已消费」的同义词。

纯文档，零接线改动。harness.rs 330 → 347 行。
 2026-11-12 23:12:20 +08:00
AskaEth 3255579bba docs(app-iced): 把「裸 button 不消费 forced」这句假话改掉 + 用法表补 --force-state（M285 r1 p2-1） 
复审原话：harness.rs:43-45 那段「设置页外观区的滑块 / 文本框 / 裸 iced::button 都不消费
forced」**正是 M282/M284 放弃像素验收的原始理由**——M285 之后后半句已经是假的，留着它下一
个 agent 会再推一遍同一个死胡同。

- pages/harness.rs：参数清单补 --force-state=rest|hover|pressed；那段改成现状（裸 button 已
  经消费：外观 11 处 choice + 语言/主题 chip + 日志 action_button 走 settings::resolve_state；
  components::buttons::Button 三组走 forced_button；仍不消费的只剩滑块 / 文本框 / 色块），
  并明确「别把它改回去」。
- examples/pages_demo.rs：用法表补 --force-state / --appearance / --passthrough（此前
  --force-state=bogus 先报约束、却打出一张没有该参数的用法表）。
  实测：`--force-state=bogus` → exit 2，用法表里含 [--force-state=rest|hover|pressed]。

顺带 r1 p3-1（机制说法订正）：forced_button 的文档写清真实优先级 —— Button::forced() 是
`self.state.or(没有消息 ⇒ Disabled)`，**state 在前**，所以 disabled 也能被 .state() 盖掉；
并加一条单测钉住实际结果（forced_button(Button::disabled(..), Some(Hovered)) ⇒ state:
Some(Hovered)）。今天 7 个站点都写在启用分支里所以安全，但**别**把它套到 if..else 外面。

行数：settings/mod.rs 396 → 397（先算过余量，未破 400）；harness.rs 321 → 330；
pages_demo.rs 37 → 39。判据 1 复验：重出 5 张 rest 图，md5 与基线逐张相同。
 2026-11-12 23:12:20 +08:00
AskaEth e15bd741cd fix(app-iced): 守住 400 行 + 接线计数点跟着语言行搬（M285 门禁红） 
- settings/mod.rs 401 → 396 行（压自己新加的文档，不删任何语义）：
  components::gate::every_source_file_stays_under_the_line_limit 红过。
- pages/tests/base_wiring.rs：语言行搬进 general/language.rs 后，`BASE.role()` 的
  计数点也要跟着搬（general.rs 0 次 → language.rs 1 次），否则
  every_card_internal_control_site_still_passes_a_base 红。计数与语义都没变。
 2026-11-12 23:12:20 +08:00
AskaEth 20607a0584 test(app-iced): 三处测试调用点补 forced=None（M285 形参同步） 
section_columns / settings::view / appearance::section 各加了 forced 形参，
测试里的调用点必须同步（同行情改，不增行；frame.rs 用一次局部绑定避免折行）。
frame.rs 393 → 394 行。产品逻辑零改动。
 2026-11-12 23:12:20 +08:00
AskaEth 7b80b0e314 feat(app-iced): --force-state 穿过设置页与外观区（M285 FORCEDWIRE） 
pages::Model.forced 此前只到得了外壳 + 实例页（唯一消费者 pages/instances.rs:159），
设置页「外观」区的滑块/文本框/裸 iced::button 全都不消费它 ⇒ M284 那四处状态层
（语言档 / 主题档 / 日志 action_button / 外观 choice）只有单测证据，做不出像素判据。

改动：
- settings/mod.rs: resolve_state(forced, status) 与 forced_button(button, forced)
  成为全仓唯一两个「forced 怎么解释」的点；view → form → section_columns 一路
  新增 forced 形参（默认 None ⇒ 今天的行为逐字节不变）。
- Group.body（registry.rs）加第 4 个形参 Option<Interaction>，六组统一签名。
- 四类裸 iced::button 控件把 forced 递进样式闭包并经 resolve_state 落地：
  语言档 chip（general/language.rs）、主题档 chip（general/theme.rs）、
  日志 action_button（logs_row.rs）、外观 choice（appearance/section/mod.rs，
  含 accent/window/bg_image/colour_source 共 10 处调用）。
- components::buttons::Button 的三组（update / ai / java）走 forced_button 的 .state()。
- harness: request.rs 解析 --force-state=rest|hover|pressed（未知值报错，词与产品
  cli.rs 同一套），slug 加 -hover/-pressed；app.rs 把它写进 model.forced，
  截图通道默认 Rest 的纪律保持（显式值优先）。
- pages/mod.rs: 唯一调用点把 model.forced 传给 settings::view（397 → 399 行）。

单测：resolve_state 的 Some 覆盖 / None 退回；forced_button 的 Some 钉态 / None 原样。
 2026-11-12 23:12:20 +08:00
AskaEth 767727efb7 refactor(app-iced): 语言行从 general.rs 纯搬移到 general/language.rs（M285 前置） 
general.rs 390 行、撞 400 行硬线，而 M285 要给语言行三枚 chip 接 forced。
切法与既有的 general/theme.rs 同构（一个行控件一个文件）：正文 view + chip +
chip_style。语句逐字节搬移（去缩进去可见性后 diff 退出码 0），只把
fn language_row 改名成 pub(super) fn view（与 theme::view 同一入口命名）。

general.rs 390 → 245 行；language.rs 170 行。
 2026-11-12 23:12:19 +08:00
AskaEth 589162de89 refactor(app-iced): 设置页分组注册表纯搬移到 settings/registry.rs（M285 前置） 
settings/mod.rs 撞 400 行硬线，而 M285 要给 Group.body 加 forced 形参。
按语义切分（不按行数）：mod.rs 留「整页 → 表单列 → 分组正文」流水线，
registry.rs 留「分组是什么」—— Body / Group / GROUPS / GROUP_LABELS /
SELECTED / GENERAL_GROUP / UPDATE_GROUP / AI_GROUP / JAVA_GROUP。

行为零变化：搬移块去缩进去可见性后与 mod.rs:190-275 逐字节相同
(diff -u 退出码 0，见 mission 报告)。可见性只有两类改动：
- Group / Body 用 pub(crate)，因为 mod.rs 要 pub(super) use（E0365：再导出
  不能比原声明更可见）；
- 其余常量 pub(super)，mod.rs 私有 use，子模块的 super::GROUPS 写法照旧可用。
 2026-11-12 23:12:19 +08:00
AskaEth 747521fe54 fix(app-iced): pressed 状态层改走 Interaction 表 + 外观 choice 叠卡底（M284） 
四处手写按钮（语言 chip / 主题 chip / 日志行两个动作 / 外观互斥按钮）把
`matches!(status, Hovered | Pressed)` 合成分支换成 `Interaction::from_status(status)`
→ `interaction::layer_color`：pressed 从被压成 hover 的 8% 回到令牌表的 10%。

`appearance/section/mod.rs` 的 `choice` 合成底从写死的 `Role::Surface` 换成
`frame::BASE.role()`（= `MaterialLayer::Card` = `SurfaceContainerLow`），与同屏
`general.rs` / `general/theme.rs` 同源——M234/M237 修过两轮的那个错，这是漏网的第三处。

四处样式闭包抽成自由函数（`choice_style` / `chip_style` / `action_style`），单测直接喂
`Hovered` 与 `Pressed`：断言两色不等 + 各自逐值等于 `state_over` 的令牌求值（改 α 也会红）。
语言行那枚 chip 的断言住在 `general/theme.rs`（`general.rs` 已 390 行，贴 400 硬线）。

未验：hover/pressed 的图像判据。`--force-state` 到不了设置页/外观区（那里不消费
`Model.forced`，`pages/harness.rs` 自己写着），接线另立任务；本轮只出 rest 图并比 md5。
 2026-11-12 21:48:03 +08:00
AskaEth 813ec88d89 fix(app-iced): 导航轨 hover/pressed 状态层落回药丸（M283） 
`rail_item` 里同一个元素并存两种形状：选中画 56×32 `radius(Full)` 的药丸，
而 hover/pressed 走 `button(stack).style(..)`，底色铺在整个按钮上
（88×52，`Border::default()` ⇒ r=0）。用户原话就是这一处：「侧边栏按钮
hover/click 是父容器整个方形区域颜色加深，而不是 MD3E 应有的胶囊 UI」。

改法照 `components/navigation/drawer/item.rs`（全仓唯一正确的导航实现）：

- 状态层改由药丸自己的 `container.style` 求值，经 `interaction::layer_color`；
  选中/未选中两条分支不合并（选中静息兜底 `SecondaryContainer`，未选中兜底 `None`）；
- `base` 取 `MaterialLayer::Canvas.surface_role()`（导航轨画的就是 Canvas），不写字面量角色；
- `button.style` 的 `background` 恒为 `None` —— 按钮不再有任何形状上的主张；
- `interaction::tracked` 只在 `forced.is_none()` 时套（强制态是取证，不许有过渡中间帧）；
- 轨底账户位同型：状态层落在头像那个 Ø40 圆上，不是 88×52 的按钮；
- 药丸几何收敛到 `state_layer_box()` 一个定义点（`rail_item` 与单测都读它）。

判据：
- `shell::tests::the_state_layer_is_drawn_on_the_pill_not_across_the_rail`（几何）
- `shell::tests::the_rail_never_paints_its_state_layer_on_the_button`（结构：扫源码，
  `button(stack)..on_press` 闭包里不许出现 `Background::Color`、`tracked` 必须有
  `forced.is_none()` 守卫）。两条都做过反向验证：把写法改回去，两条同时红。

取证（`DevDocs/artifacts/navpill/`）：`--force-state=rest` 与改前**逐字节相同**
（md5 1ebb611b3edc156925ca802d3f4fa76d）；hover/pressed 的高亮区从 88×52 矩形
变成 56×32 药丸（四角为空），账户位从 88×52 变成 Ø40 圆。
 2026-11-12 21:42:30 +08:00
AskaEth ca086a40ee feat(app-iced): 右栗折叠腿的取证夹具 ULL_AGENT_RAIL=exit-collapsed（M279） 
`AgentUi::new()` 出厂就是折叠档，而 `collapse()` 只在档位是 Expanded 时才改档并
`observe_rail(false)`（`pages/agent/state.rs:245-255`）⇒ 原来的 `ULL_AGENT_RAIL=collapsed`
是**空操作**：配 `ULL_MOTION_AT` 拍「折叠中途」时，拍到的只是静息折叠 + 页面入场位移
（M257 r2 复审实测，md5 与静息帧相同）。而折叠腿恰好是「页面模型比物理区更宽」的那一侧
（`content_width()` 吃目标档、`rail_width()` 吃动画进度），最可能出现右侧裁切/重叠的方向
反而没有任何像素证据。

新取值 `exit-collapsed`：先 `expand()`，把展开这一腿 `snap_rail(true)` 落成静息，再在
**同一拍** `collapse()` ⇒ `observe_rail(false)` 真的从进度 1.0 起跑一条 1 → 0 的折叠轨道。
snap 不能省：钉住相位时两条轨道共用同一个起点（`Pump::start_now()` 恒为 0），不 snap 的
话收起那一腿会从展开的半路反向，三张相位图就不是同一条腿，位移表也就没法与展开腿对照。

原有 `collapsed` / `expanded` / `detached`（含「认不出的取值 ⇒ 一动不动」）语义逐字未改，
由新用例 `the_old_rail_values_keep_their_exact_meaning` 守卫。档位落法抽成纯函数
`seed_rail`（用例直接喂名字，不摆环境变量）；启动日志多一个 `seed=` 字段——静息落档与
「真的起了折叠轨道」两者的 `rail` 都是 `collapsed`，只有 `seed` 能分辨。

用例：`exit_collapsed_really_starts_the_collapse_leg_from_full_open`
（轨道在跑、第一帧严格 320、进度严格递减、末端严格 0、帧数 10~20）。
 2026-11-12 20:59:54 +08:00
AskaEth c869a7b346 fix(motion2): 修掉 drawer 药丸守卫的同义反复（M257 r1 复审 P2-1） 
`rail_selected_label_is_secondary` 里那条 `pill_color(..) == pill_color(..)` 比的是同一个
表达式，恒真、抓不到任何东西，而注释还写着「rail 与 drawer 两条线的药丸一致」。

药丸从 M257 起不吃 layout（`pill_color` 的签名里没有 `NavLayout`），所以「两条线一致」由
签名保证；本用例改判真正要守的那一件事：静息选中药丸来自 `SecondaryContainer`。
变异验证：把 `pill_color` 的兜底角色换成 `Primary` ⇒ 该用例在 tests.rs:54 红。
 2026-11-12 20:05:58 +08:00
AskaEth b61f342431 feat(motion2): 右栗折叠过渡 + 状态层 hover/pressed 过渡 
A2 侧边栏（右栗 AI 栏）折叠/展开：
- 帧泵第三条轨道（pump/rail）：展开 medium1 250ms + Emphasized、收起 short4 200ms +
  EmphasizedAccelerate；拆出档走 snap（不做过渡）；MotionScale::NONE 下不插轨道
- 宽度在 metrics::rail_width 逐帧插值；面板内容按目标宽排版 + 按动画宽裁切
  （不重排 / 不溢出），宽度回到 48 时换成图标条（图标贴右端，位置不跳）
- pages/agent/mod.rs 的展开档面板纯搬移到 panel.rs（371 → 289 行）

A8 状态层过渡：
- interaction/layer：令牌化的进度时钟（short1 50ms），NONE 当帧落终值
- interaction/hover：取样控件把起跑搬到 Widget::update（早于订阅表求值）
- 按钮五式 + IconButton + 导航项药丸统一走 interaction::layer_color
  （没有取样控件时逐位退回旧口径，出图基线不变）
- components/motion/mod.rs 的 needs_frames / advance 各加一句委托，
  帧订阅仍然只有一处判断点（app/subscription.rs 未改）
 2026-11-12 20:05:58 +08:00
AskaEth dc8323531b feat(presenter): 多根发现（配置根 + 官方启动器标准位置），实例按自己的根解析存档/模组/启动（M274） 2026-11-12 19:55:51 +08:00
AskaEth fb30598604 fix(app-iced): 首屏（Kind::Boot）不再把旧页画成 250ms 幽灵 
`pages::render` 把 `previous_view` 整棵画在当前页**下面**（`stack![opaque(ghost),
current]`），只在空隙里露出来。boot 那份快照是 `construct.rs` 的零实例初始模型，
被 `refresh.rs` 在第一次 refresh 时换进去 ⇒ 每次启动都闪一张「这里还没有实例…」+ 空态
图标磁贴（退场腿 250ms，`Kind::Boot` 用的就是它）。

修法：`App::sync_motion` 丢掉旧页快照的判据从「没有轨道了」扩成「没有轨道了 **或**
这一档本来就没有旧页」，后者走 `Kind::has_old_page()`——M256 写好的设计口径，此前全仓
无人调用（死代码）。丢在 `update` 的尾巴、`view` 之前 ⇒ 一帧都画不到；不动
`components/motion/**`（M257 的 scope），也不动 `app/state/refresh.rs`（不在本 scope）。

用例：`motion_sync/tests.rs` 新增三条（首屏每拍都不许留旧页 / Peer 换页仍留着旧页退场 /
NONE 档既不起轨道也不留旧页），删掉守卫即红。`motion_sync.rs` 已 398 行，按 400 行硬线
把测试模块**纯搬移**到 `motion_sync/tests.rs`（233 行逐字节相同，仅去掉模块缩进）。

出图：`DevDocs/artifacts/ghostfix/`（页面区 y<720 残余 = 0px；去掉守卫的同一棵树在同样
三相位残余 6897/5291/4762px）。
 2026-11-12 19:35:19 +08:00
AskaEth c5009442c5 fix(presenter): 自动发现实例按盘上痕迹选运行目录 + 空态用例补上分支/传参（M273 r1） 
r1 复审的两条 P2。

## P2-1：外部实例不再一律 isolated

`versions/<id>/` 里出现 `mods` / `saves` / `config` / `options.txt` 任一 ⇒ `isolated`
（gameDir = `versions/<id>`）；否则 ⇒ `shared`（gameDir = 游戏根 `.minecraft`）。
判据只 `exists()`，只读，不改盘；写盘仍然只在用户第一次改设置时（`ensure_profile`）。

- 判据收在 `host/game/discovered.rs::base_mode()`，签名 `(env, id, version_id)`：
  **有档案的实例返回全局 `instances.mode`**（D20 原口径，一字不变），自动发现的按痕迹判。
- 派生运行目录的五处（启动 / mods / saves / addon install / addon pack）从传
  `global_mode` 改成传 `base_mode` ⇒ 「读到的存档/模组在哪」与磁贴上的 ISOLATION 同一份判据。
- `isolation_of(env, id, version_id)` 多收一个版本 id：实例文件优先，缺省 `base_mode`。
  于是懒创建档案（只写 launch 段、isolation 仍为空）之后，磁贴不会从「共用目录」翻回「独立目录」。
- 磁贴/详情：自动发现的实例多一句「运行目录由盘上已有的文件决定」（i18n 中英）；
  按启动时再弹一条说清**这一次**用哪一边（`pages::instances::discovered_run_toast`，
  同文案在屏不重复叠加）。
- `dto::DISCOVERED_ID_PREFIX` / `is_discovered_instance` 成为「自动发现」的公开判据
  （不给 `InstanceSummary` 加字段：那要改 24 处结构体字面量，跨 agent / cli）。

## P2-2：空态用例的覆盖面

r1 复审实测：把 `!block.rows.is_empty()` 改成 `block.rows.is_empty()`（0 实例时反而没按钮），
当时三条用例全绿。现在：

- `detail_empty` 拆成 `empty_not_selected` / `empty_no_instances` 两个函数，分支各自可断言；
- `the_cta_lives_only_in_the_no_instances_branch`：CTA 只在「一个都没有」那一支、
  「没选中」那一支必须是 `Vec::new()`，且分派必须写成 `if has_instances {`（取反即红）；
- `the_page_asks_the_empty_state_with_the_negated_row_count`：两条调用点（宽窗 + 窄窗）
  都必须传 `!block.rows.is_empty()`，条数也钉住（多一条即红）。
- 两个变异已自证：传参取反 ⇒ 后一条红；CTA 挪支 ⇒ 前一条红（红原文见交付报告）。

## P3

- `java::target_major()` 改读并集快照：只有自动发现实例的用户原来会拿到默认 JDK17 而不是
  该版本要求的 JDK（`profiles.json` 是空的）。有档案时顺序与旧写法一致。
- `instances()` 全量扫仍在 UI 线程——本轮不动，刷新时机与代价写进报告（塔另开一条）。

## 结构

`host/game.rs` 394 → 286 行：自动发现那一簇（痕迹判据 / 扫出来的版本 / 合成视图）搬到
`host/game/discovered.rs`（138 行），只为守 400 行硬线；`game::base_mode` 仍是同一条路径。

## 门禁

app-iced lib 973 passed / presenter all-targets 386 passed / i18n 36 passed /
fmt 0 / clippy -D warnings 0。
 2026-11-12 14:21:30 +08:00
AskaEth 5479f25068 feat(presenter): 实例清单改并集（档案 ∪ versions/*）+ 空态接导入向导（M273） 
用户实测：HMCL 能看见 `.minecraft/versions/樱落怡然客户端`，ULL 的实例页是空的
（日志 `instances=0`）。根因不是路径找错，而是 `host::game::instances()` 只列
`profiles.json` 里的档案，第三方启动器装好的版本在界面上根本不存在。

## 列表改并集（presenter/src/host/game.rs）

- `versions/*` 里**能解析出清单**（`<id>/<id>.json` 的 id 与目录名一致、继承链走到底、
  符号链接不越界）且没有被任何档案绑定的版本，就地合成一条实例视图：
  显示名 = 目录名、`version_id` = 目录名。扫描复用 `core::game::adopt::scan`，
  没有另写一套目录遍历。
- 只读：合成视图不建目录、不写 profiles.json、不碰 versions/ 一个字节。
- 档案优先：某版本已被档案绑定时只按档案出一条（名字/隔离档/启动参数都保留），不重复列。
- 坏目录（无清单 / JSON 坏 / id 不符 / 缺父 / 越界）不当实例；`versions/` 读不出来也只是
  退回「只有档案」的旧行为，不让实例页报错。
- 外部实例的视图 id 用 `ext-<fnv64>`：`is_valid_instance_id` 只收 `[A-Za-z0-9_-]`，
  而版本目录名可以是中文（现场就是），直接沿用版本 id 会让**启动**在读实例设置时就失败。

## 懒创建档案（只有第一次改它才写盘）

`set_isolation()` 与 `apply_launch_args()` 的「找不到实例」改成 `game::ensure_profile()`：
外部实例第一次改隔离档 / 启动参数时才写 profiles.json（幂等，id 与视图 id 相同）。

## 空态可见入口 + 文案（app-iced / i18n）

- 空态分两种：列表里有东西但没选中（原「未选择实例」）与**一个实例都没有**
  （新：「还没有实例」+ 实心主行动「导入已有版本」）。用户现场看不到任何入口正是前一种文案
  在误导。
- `adopt_action()` 成为「导入已有版本」意图的唯一产地，页头按钮与空态主行动共用它。

## 门禁

`cargo test -p unlucky-app-iced --lib` 971 passed / `cargo test -p unlucky-presenter
--all-targets` 384 passed / `cargo test -p unlucky-i18n` 36 passed /
`cargo fmt --all --check` 0 / `cargo clippy -p unlucky-presenter -p unlucky-app-iced
--all-targets -- -D warnings` 0。
 2026-11-12 13:13:53 +08:00
AskaEth 751ae80f28 chore(release): 版本号 0.2.5（动效第一批 + 发布链路三处根因修复 + 平台测试收口）
Guards / 依赖许可与来源（cargo-deny） (push) Canceled after 0s
Details
Guards / 文件行数 ≤400 守门 (push) Canceled after 0s
Details
Guards / unsafe 落点守门（集合必须恰好等于期望） (push) Canceled after 0s
Details
Guards / design 零第三方依赖守门 (push) Canceled after 0s
Details
Guards / presenter 零 UI 守门 (push) Canceled after 0s
Details
Guards / core 零 UI 守门 (push) Canceled after 0s
Details
Dev Guards / 架构与合规守门（同 main 口径） (push) Canceled after 0s
Details
GPU evidence / GPU 证据 — 真实产物判据 (push) Canceled after 0s
Details
GPU evidence / GPU 证据 — 探测可用产物与硬件适配器 (push) Canceled after 0s
Details
GPU evidence / GPU 判据自测（不需 GPU；跳过 ≠ 已验证） (push) Canceled after 0s
Details
Dev Guards / GPU 证据门禁（同 main 口径；无 GPU 只跑自测） (push) Canceled after 0s
Details
Dev Guards / fmt (rustfmt --check) (push) Canceled after 0s
Details
Dev Guards / clippy (ubuntu) (push) Canceled after 0s
Details
2026-11-12 12:06:46 +08:00
AskaEth 634955d323 fix(app-iced): 探针与字体测试的子进程改走 platform::child::quiet（M272） 
`cargo test --workspace` 在合并 tip f8d83d1 上被 child_quiet_guard 抓住两处绕开
`platform::child::quiet` 的子进程构造：

① `platform/motion.rs` 的 OS「减少动效」探针（M256 新增，Linux gsettings / macOS
   defaults）是产品代码真回归：`run()` 里裸 `Command::new(program)`。改走 `quiet(program)`。
   `quiet` 返回的就是普通 `Command`，`.spawn()` 的 `Child` 仍归 `run` 自己，所以
   **300ms 超时 + 超时 kill + wait 一个字没丢**；`OnceLock` 缓存、单调用点、不在帧路径
   这三条性质也原样保留（这次只换了构造器）。
② `fonts/tests.rs` 里重起自身 test binary 的那处同样改走 `quiet`；`.output()` 的管道
   语义不变（已实测子进程断言仍然「1 passed」）。没有往 ALLOWED_ROLES 加白。
 2026-11-12 11:28:56 +08:00
AskaEth add8617494 fix(app-iced): 修 about_center 的平移项（模态从「斜滑」回到「绕中心缩放」）+ 补几何断言 
复审 r3 的 P1：about_center 写成 T(-c)·S·T(c)，按 iced_core 的「先右后左」算出来是
p → s·p − (1−s)c，不动点在 (−cx,−cy)（窗口外的镜像点）⇒ 卡片开框时从左上斜滑约
(1−s)·c，而不是绕中心缩放。改成 T(c)·S·T(-c)（= s·p + (1−s)c，不动点就是 c），注释同步。

根因是 zoom.rs 里 0 条 #[test]（矩阵从没被断言过，967 条全绿抓不住）。新增
tests::about_center_keeps_the_center_fixed：中心不动（<1e-3）、尺寸 = 倍率、缩小时左上角
收向中心；三组矩形 × 三档倍率。把 translate 换回去即红。

顺带补齐「抓得住/抓不住」：components/motion/** 与 motion_sync.rs、platform/motion.rs 里
31 条用例现在全部两侧都有（脚本核对 missing=0）。
 2026-11-12 10:50:04 +08:00
AskaEth b6127b4735 fix(app-iced): 补回被变异回滚误删的两处修复（钉住档位 + 退场起点） 
上一提交把一个中间态（BYPASS_PROBE + serialize 未删、Modal::Closing 无 from）提交了：
变异实验后我用 git checkout -- 复原，而那些修复当时还没入库，于是被一起抹掉，
直接用例把这件事抓了出来（3 条恒定红）。现在按正确内容重做：
- delete motion::serialize()（空操作）
- FORCED_SCALE: Cell<Option<MotionScale>>，configure 里钉住优先
- Modal::Closing { start_ms, from }，退场从当前进度连续缩到 0
（教训记在报告：变异只在已提交的树上做，别在未提交的树里 checkout。）
 2026-11-12 10:50:03 +08:00
AskaEth 787cb16189 fix(app-iced): 删掉空操作串行门 + 钉住档位贯穿产品启动路径 + 退场起点接当前进度 
复审 r2 的三条：
1) 删掉 motion::serialize() 那把串行门：PUMP/LAST_FRAME 都是 thread_local，libtest 每用例
   一线程 ⇒ 它改变不了任何结果（ULL_MOTION=off 下握门照样红）。留一个不起作用的同步原语
   比没有更坏。subscription.rs 与 motion_sync.rs 的 idle_app 恢复原签名。
2) 真实根因是「喂给 configure 的值」：idle_app 先钉 STANDARD，随后 on_boot →
   configure_motion（app/update.rs:276）→ boot_env::motion_scale(..) 再定一次档，把钉住覆盖掉。
   改成 BYPASS_PROBE(bool) → FORCED_SCALE(Cell<Option<MotionScale>>)：configure 里钉住优先，
   于是三条定档路径（configure_for_test / on_boot / boot_env 的 env·后端 tier）都穿不过去。
   两条用例钉住它（纯合成 + 真 Message::Boot），删掉「钉住优先」两处都红。
3) P2-2：Modal::Closing 记住起手进度 from，progress = from*(1-eased) —— 进场途中被关掉时
   从当前进度接着缩，不再先跳到 1.0（反向硬跳）。新用例
   closing_during_the_entrance_does_not_jump_to_fully_open，把 from 改回 1.0 即红。
 2026-11-12 10:50:03 +08:00
AskaEth c21c6df51b fix(app-iced): 动效全局态按「测试隔离」修 —— 串行门 + 探针旁路（复审 P2-5 返工） 
tip 8b6f090 上 7 条用例在 -j 2 下红，根因两层：
1) P2-5 引入的 configure_for_test 只挡调用点，而 App::update(Boot) 会走**产品** configure
   再按真探针定档 —— 本机（RDP 会话）SPI_GETCLIENTAREAANIMATION 报「动画关」⇒ 档位被压成
   NONE ⇒ 位移恒 0 ⇒ 门槛 B/C 的守卫全红（日志里 [motion] scale=0.00 就是它）。
2) 动效全局态（档位 + 进程级时间轴）在并行用例间共享，谁先写谁赢。

修法（判据一条没动）：
- components :: motion :: serialize()：**跨模块共用的唯一一把**串行门，subscription.rs 与
  update/motion_sync.rs 的用例都取它（idle_app 把 guard 一起返回，活到用例结束）。
- configure_for_test 置 thread-local BYPASS_PROBE，configure 读它 ⇒ 产品启动路径也不会再按
  探针改档；reset() 清旁路，供「故意走真探针」那条用例使用。
- NONE 仍要求严格 0、STANDARD 仍要求 12~20 帧与端点归位。
 2026-11-12 10:50:03 +08:00
AskaEth 1edf645c2f fix(app-iced): 复审 p2 五条（方向取轨序 / 退场重开 / 遮罩口径 / 恒真断言 / 探针隔离） 
- P2-1 方向改由**导航轨序**决定：新增 nav_rank(route)（NavItem::ALL 下标），
  Pump::observe 收 (screen, rank, detail)，forward 比较 (rank, key) 而非只比屏键 ——
  修掉 Logs↔Settings 的左右镜像；Download↔Content 同 rank，仍判同级水平（已登记偏离）。
- P2-2 退场途中开新框：observe_modal 先当场收尾（Hidden + 待关）再起 Opening；
  sync_motion 收尾时若队列里还有框就不把 dialog_model 置空。
- P2-3 只改文字：遮罩起手是**整块画布色的不透明矩形**（把页面内容遮住），不是透明看不见。
- P2-4 删掉恒真断言（单个 Option 的 <=1），写明「不累积」是字段形状 + mem::replace 给的；
  tests/timeline.rs 与 tests/modal.rs 的每条用例都补了「抓不住」。
- P2-5 新增 motion::configure_for_test（绕过 OS 探针），用例一律走它；
  另留一条故意走真探针的用例证明 Reduced ⇒ NONE 的合成仍在产品入口上。
- 顺带：pump 的模态状态机拆到 pump/modal.rs（守 400 行硬线）。
 2026-11-12 10:50:03 +08:00
AskaEth 4a77f1b421 fix(app-iced): 退场窗口内 Esc 也被吃掉（补键盘入口的闸门） 
模态退场期间逻辑状态已关（state.dialogs 空），但 Esc 走的是 Message::Agent(Key) 那条
独立路径，不经过 on_dialog 的 modal_closing 闸门 ⇒ 那 150ms 里 Esc 会落到 AI 栏去收起面板。
escape() 顶部加同一道闸门（返回 true = 被吃掉），并给退场用例补一条断言。
 2026-11-12 10:50:02 +08:00
AskaEth b1c09c4c91 feat(app-iced): 页面切换按导航深度定向 + 模态缩放淡入（M256 MOTION1） 
- transition.rs：唯一一张动效表。同级换页走水平（±12 / 旧页 ∓8）、进深层走纵向
  （新页 +16 上浮 / 旧页 -8），进腿 medium2/medium1（300/250），退腿 short4→medium1（更短），
  进用 Standard、退用 StandardAccelerate。幅度全部取自 Space 令牌。
- pump.rs：Slot 三互斥槽 → Kind（Boot/Peer{forward}/Push/Pop）+ 两腿轨道；新增模态状态机
  （Opening/Open/Closing，展开后不占帧，退场走完交回一次 take_modal_closed）。
- components/motion/zoom.rs：绕中心缩放的自绘控件（renderer.with_transformation，
  tiny-skia 与 wgpu 都实现了，文字也真的跟着缩放）；scale==1.0 时不套变换 ⇒ 出图基线不变。
- pages/mod.rs：page_with_settings_transition(ui, current, previous, …) 叠
  stack![opaque(旧页@退场位移), 新页@进场位移]；旧函数只剩一句委托（blast radius 不变）。
- App.previous_view：换页时用 std::mem::replace **移动**旧模型（冻结快照），过渡结束当拍
  置 None（不随换页次数增长）。
- 模态：逻辑状态当拍关（state.dialogs 立刻空），画面多留 150ms；退场期间弹窗消息被闸门吞掉。
- platform/motion.rs：系统「减少动效」三态探针（Windows=SystemParametersInfoW，
  Linux/macOS=子进程+300ms 超时），OnceLock 缓存；Unknown **不降级**（探针失败不静默关动效）。
- MotionScale::HALF 语义核清并写进 design 文档：是**时长减半**（更快），不是半速。
 2026-11-12 10:50:02 +08:00
AskaEth d4959fd3d3 test(m262): 三条平台/时序依赖的测试改成确定性判据 
① prefs.rs：custom 落点不再写死 D:/JDKs（Linux 上它是相对路径，会被拼到数据根后，
   同一条断言在两个平台上验的是两件事）。改由临时目录给绝对路径；另加一条相对路径
   必须按数据根解析的断言，把上一版抓不住的那一半补上。
② fonts/tests.rs：install::status() 读的是进程级静态槽，同 binary 的 page_messages
   用例切 zh_cn 会真的发起下载并把它写成 Downloading ⇒ 前后快照比较与谁并行谁赢。
   改成用 current_exe() 在**只有本用例的进程**里量，并断言前后逐值相等（任何写槽都算越界）。
③ fixture_cases.rs：目录 mtime 不再赌「写文件恰好落在另一个 tick」，改为显式钉 mtime
   （t0/t1 整秒，对任何 filetime 粒度无余数）并逐 ns 比对。

三条都补了「抓得住什么 / 抓不住什么」。
 2026-11-11 22:41:06 +08:00
AskaEth 4b184df1ba chore: 版本号 0.2.4（里程碑快照；本批含存档截图/强调色/回车提交/GPU 门禁/签名就绪度） 2026-11-11 21:26:15 +08:00
AskaEth 9ce54a8119 test(app-iced): accent 回车守卫改判代码行并整取实参（M252 r2 P2-1） 
上一轮（e2a9692）声称三处守卫都改了，实际只有 field.rs 与 rows.rs 进了提交：
`section/accent.rs` 的改写留在工作树里，被我自己重放 C4 变异时的 `git checkout --`
还原掉了 —— 提交面因此看不到它，那条守卫仍是 `body.contains(..)`，注释掉接线后它照样绿
（只有白名单顺手红）。先修过程、再修判据：

- `the_accent_field_wires_enter_to_commit` 改成 `code_line(body, ".on_submit(")` 取**代码行**，
  再用 `call_arguments` **整取**实参并断言等于 `["accent_commit"]` —— 顺带堵上
  「`accent_commit_none` 这类同前缀产地静默通过」。
- `code_lines()` 的边界文档换成实测口径（`app-iced/src` 9 处 `r#"`、8 处内容含引号；
  全仓 `crates/**.rs` 291 处），并写清两个方向：内嵌引号 ⇒ 尾部注释漏剥 ⇒ **假绿**；
  JSON 原始字符串同行有 `//` ⇒ 多剥 ⇒ **假红**。两种都由 `code/tests.rs` 钉住。

过程纪律（写进报告）：**变异重放只在已提交的树上做**，否则 `git checkout --` 会把未提交的
修复一起扔掉，而「声称改了、diff 没动」正是这次被复审抓到的形状。
 2026-11-11 19:55:21 +08:00
AskaEth a17f6fb29f test(app-iced): 接线守卫改判「代码行」，注释掉不再算接线（M252 r1 P1-1） 
复审实测：三处接线守卫都是纯文本 `contains`，把真接线注释掉（行注释，或 `/*` 独占一行的
块注释）之后 943 条用例一条不红；`field.rs` 那处连 rustc 的 unused-variable 兜底也能用
`let _submit` 一起绕掉 —— 功能整条静默失效时，测试与 lint 两条线同时不响。

- `pages/layout/source/code.rs`（新）：`code_lines()` 剥 `//` 与跨行/可嵌套 `/* … */`，
  字符串与字符字面量整段保留（`"http://x"` 里的 `//` 不剥）；`code_line()` / `has_code_line()`
  给「某行代码的行首就是那个调用」这条谓词。边界写在模块文档：原始字符串里出现 `"` 是唯一
  可能朝松方向错的形态（本仓 src 现无此写法），其余偏差都是假红。
- 三处守卫改用它：`text_field_forwards_the_submit_callback`（行首是 `on_submit_maybe(`
  且实参不是 `None`、消息来自 `submit_message`）、`the_rename_field_wires_enter`（回车与
  「改名」按钮的行都含 `commit_rename()`，且都不含第二种页面意图 —— 一并关掉 r1 P2-1
  「Debug 自证撑不住判据」）、`the_accent_field_wires_enter_to_commit`（含产地那条代码行）。
- `submit_is_wired_only_at_the_two_call_sites` 的 `scan()` 换成同一谓词并跳过测试文件
  （守卫自己的 fixture 里也有 `.on_submit(` 样本）。
- T29 顺手收敛 scope 内的同族旧断言：`pages/instances/tests.rs` 的行距/散文接线判据与
  `pages/instances/tests/i18n.rs` 的五条取词判据改走 `code_text()`（一行改动、方向不变）。
 2026-11-11 19:55:21 +08:00
AskaEth 92a3c1bbc8 refactor(app-iced): 「禁用不提交」的规则收进 Field::submit_message 
原来 text_field 里内联着 `if state.is_disabled() { None } else { field.submit_message() }`，
那条分支在 Element 上量不到（没有内省接口）⇒ 等于没验。现在把状态作为参数交给
Field::submit_message(state)，规则本身可单测：submit_is_opt_in 多了 Disabled 那一档断言
（接了回调 + 禁用 ⇒ None），text_field 相应少 3 行。
 2026-11-11 19:55:21 +08:00
AskaEth ebce41b2c5 test(app-iced)+docs(appearance): 强调色「已提交」那一档的出图开关 
D30 要拍「回车之后」的样子，但出图通道没有键盘（渲染第 3~4 帧就落盘）。所以把强调色
的两档取证开关（ULL_APPEARANCE_ACCENT / …_COMMIT）收进 accent 自己的模块：第二档在灌值
之后补一次 Accent::commit()，它做的正是回车那条消息（Change::AccentCommit）在状态层做的事
（State::apply 开头的 commit）。拍的因此是同一个状态，不是另一条渲染分支。

顺带两处口径订正：
- state.rs 少了 3 行（它贴 400 行硬线），强调色的 env 开关不再散在 state 里；
- rows.rs 的模块文档把「名字规则」指到 core 的
  game/saves/write/boundary::check_name（原来写的是 presenter）。
 2026-11-11 19:55:21 +08:00
AskaEth f7cfc8ded6 feat(app-iced): 单行输入框透出 on_submit，回车接上存档改名与强调色提交 
债务台账 P18（M250 + M247 的共同缺口）：iced 0.14 的 text_input 有 on_submit、
没有 on_unfocus（builder 逐条核过：on_input/on_input_maybe/on_submit/on_submit_maybe/
on_paste/on_paste_maybe，on_unfocus 零命中），而本仓的 text_field 只透出
on_input ⇒ 行内重命名只能点按钮、强调色拿不到「用户确认」这一下。

- field.rs：Field 变 `Field<'a, M>`（M 只被新加的 on_submit 用到，调用点的类型由
  text_field 的 on_input 一并推出，一行都不用改），回车消息唯一从 submit_message()
  取，`on_submit_maybe(None)` 是默认档 ⇒ 既有调用点逐位不变；禁用态与 on_input 同一
  条规矩被摘掉。
- 存档改名：回车与「改名」按钮共用 commit_rename() 一个消息产地，空名/原名不变/
  非法字符那几道校验因此对回车同样成立。
- 强调色：回车发 Change::AccentCommit（不是又一次 Accent(原文)）⇒ 立即 commit()，
  把「打了一半就放着」的 #12 亮成红框 + 错行；逐键不报短错的规矩不变，落盘仍取
  上一次合法值。
- 判据：submit_is_opt_in（未接就是 None）、text_field_forwards_the_submit_callback、
  submit_is_wired_only_at_the_two_call_sites（白名单扫源码）、
  enter_takes_the_same_message_as_the_rename_button、the_rename_field_wires_enter、
  the_accent_field_wires_enter_to_commit、enter_commits_a_half_typed_value_and_
  persists_only_legal_ones。真键盘回车量不到（Element 无内省、造不出 iced::Renderer
  的测试替身），报告里单列。
 2026-11-11 19:55:21 +08:00
AskaEth 779a2ae254 feat(app-iced)+test(presenter): 句柄按 (目录,mtime,大小) 复用；缓存可清空；端到端出图 
复审 r1 的三条：

1. 端到端图：DevDocs/artifacts/m251/saves-real-decode-light.png —— 真 host
   （ULL_SCREENSHOT_REAL_HOST=1 + --data-dir 一个临时数据根）→ 后台列 screenshots/ →
   palette_extract::thumbnail 真解码 → DTO → Handle::from_rgba → 上屏。三格是三张真 PNG
   的真像素，副文案的 2.3 KB / 2.2 KB / 24.1 KB 也是真扫描值。造根脚本与复现命令进
   artifacts/m251/{README.md,make-real-root.py}，并写明「哪张是排版、哪张是端到端」。
2. 每帧重建 Handle 的成本：改成**缓存**（不是实测）。model.rs 新增 process-level
   memo，键 = (截图目录, 文件, mtime, 字节数)（与 presenter 的缓存键同源，目录单列一格），
   上限 120 条（≈12MB）。判据：the_same_screenshot_reuses_one_handle 断言两次
   from_state 拿到**同一个 Handle id**；变异（换回 Handle::from_rgba）即红。
   a_changed_screenshot_gets_a_new_handle 钉住「文件变了必须换句柄」。
3. 进程级 memo 的副作用：两层各加 #[cfg(test)] clear_cache()/clear_handles()，用例从
   已知状态起跑；两条上限从 240 收到 120（≈12MB/层，算术写进常量文档）。

顺带：句柄键改用 push 拼（format! 模板串会被页面字面量守门当成英文文案抓走）；
preview 的页面模型用例拆到 tests/saves/preview.rs（saves.rs 破 400）。
 2026-11-11 17:09:17 +08:00
AskaEth dd9962e610 test(presenter)+fix(i18n): 淘汰策略与共享缓存解耦；注释里的 ASCII 引号 
- prune() 抽成独立函数：全局缓存被所有用例共享，谁往里面灌 240+ 条都会顺手清掉
  别的用例刚缓存的键（实测：并行跑时 the_second_identical_refresh_... 假红）。淘汰
  策略改在本地 Cache 上测，两条判据各自确定；
- clippy -D warnings：from_ref 代替 &[x.clone()]；
- model.rs 注释里的 "原因 + OS 原文" 用 ASCII 引号 → 页面字面量白名单守门报红，改
  中文引号；core/events 的三处文档失真登记为 TowerFinding（scope 外）；
- 出处文案口径：TooLarge 的 detail 只留数字（presenter 不产人读文案）。
 2026-11-11 16:52:47 +08:00
AskaEth 0b6b8f0a62 fix(app-iced): 缩略图墙一行两格 + 副文案只留元数据（出图实测） 
- 3 格装不下：详情列宽 = FrameMetrics::column ≤ 424（1180 窗宽），卡片内宽约 370，
  3×160+2×12=504 会把第 3 格挤成一条竖条（实测图上『未生成预览』竖着排）。改成 2 格
  = 332px，与同列元信息卡的两列栅格同宽；
- 原因只进占位框（短句），副文案仍画『大小 · 时间』：160px 里塞「原因 + OS 原文」会摊成
  三行，把墙变得比图还吵；原文留在 ScreenshotThumbFailure::detail 供排障；
- 出图：DevDocs/artifacts/m251/saves-light.png / saves-dark.png（1180×1400，
  --software-renderer --screenshot，ULL_SAVES_FIXTURE=1）。
 2026-11-11 16:40:41 +08:00
AskaEth 843f6d08f9 feat(saves): 截图缩略图墙（M251 · D54 全套：解码/缓存/上限/可见失败） 
按 D54 落地，解码在 palette-extract、缓存在 presenter、像素随快照走、壳层只画。

palette-extract（上一提交）→ presenter：
- dto/saves/preview.rs：ScreenshotPreview{NotGenerated,Ready,Failed} + ThumbnailView
  （带 is_consistent：长度 ≠ w×h×4 的像素不许进渲染器）+ ScreenshotThumbKind；
  ScreenshotView 新增 preview 字段（像素不落盘，随 IPC 面走）；
- host/saves/thumbs.rs：attach() 在后台线程（spawn_list 同一条线程）按 mtime 倒序解前
  60 张、单张 >8 MiB 先查大小不进解码器、失败也逐条带原因；进程级 memo 键 =
  (路径, mtime, 大小)，覆盖/替换都会重解；超过 240 条只留本拍碰到的键；
- presenter 新增依赖 unlucky-palette-extract（塔已批，方向 presenter → palette-extract）。

app-iced：
- saves.rs 拆成 model / rows / wall（原文件 385 行，加完墙必破 400）：model 里建一次
  iced Handle（渲染回调零解码、零重复上传），wall 3 列排格子，没像素的格子给
  160×90 占位框 + 逐条原因；text.rs 拆出 text/saves.rs 承载存档/截图一族文案；
- i18n 加 4 条「这一格为什么没有图」（未生成/太大/读不出/解不出）+ 金表同步；
- 出图夹具（saves_shot）合成两种场景的像素，并摆出四种格子（真图×2/未生成/超限失败）。

用例：presenter 9 条（含缓存命中不重解、mtime 变了必重解、第 61 张不解、
>8MiB 不进解码器、缓存有界）+ app-iced 3 条（三种格子的副文案、坏像素降级）。
 2026-11-11 16:33:56 +08:00
AskaEth c14622f828 test(app-iced): 钉住错行里不可见字符的 U+XXXX 形态（M250 r1 小事 2） 2026-11-11 15:54:59 +08:00
AskaEth 14282f3325 fix(app-iced): 复审 r1 的四条 p2 + 三条小事（M250） 
- p2-1 删死状态：`Accent::scheme` 字段 / `scheme()` 取值口 / `set_flavor` 重派生全仓零读者，
  且注释谎称「Ui 的唯一入口」。色值 `color` 与深浅无关，`Ui` 由 `rebuild_ui` 重算，
  所以整条删掉，`new/set/reset` 也不再收 `flavor`
- p2-2 规则只定义一次：新增 `theme::tokens(flavor, accent, scheme, families) -> (Ui, Colors)`,
  `App::rebuild_ui` 与出图 harness 都调它（harness 传 scheme=None，如实说明不覆盖 D38 分支）；
  README 改成「同一条规则、不是同一个调用点」
- p2-3 逐键不闪红：`Accent` 区分「显示中的错」与 `pending`。只有**不可能再变合法**（非 hex / 超 6 位）
  才立刻亮；位数不足先挂 pending，等 `commit()`（点到别的外观控件）或配置读回才亮
- p2-4 订正 `app/state.rs:151` 那句反话（强调色现在是 UI 写入字段）
- 小事：hint 文案改「中性表面与错误色不随强调色变」；`Digit{ch}` 里的不可见字符显示成 U+XXXX；
  8 颗色块补 tooltip（hex 原文，Overlay 底）

判据：新用例 `accent_errors_only_appear_when_they_are_actionable` 覆盖「输入中不亮 / 提交后亮 /
配置读回立刻亮」三态；gallery 出图逐字节与重构前相同（规则搬迁没改像素）。
 2026-11-11 15:46:10 +08:00
AskaEth c609827c49 chore(app-iced): 撤回越界的注释改动（app/state.rs 不在 M250 scope） 2026-11-11 15:12:15 +08:00
AskaEth e345b55c09 fix(app-iced): 预设色板改成两行排版，注释与用例去掉色值字面量（M250） 
- 预设色板原来挤在一行，出图实测被折成「7 + 1」（最后一颗掉到下一行）——改成
  「标签 + 出厂」一行、8 颗色块一行；这是有意排版，不是被挤出来的
- src/** 的色值字面量门禁把注释与测试一起扫（那条门禁是对的）：文档里的 `#RRGGBB`
  实例改成不带 `#` 的描述，超长串用例改用 `TEAL.to_hex()` 拼出来
 2026-11-11 15:10:03 +08:00
AskaEth e6b2200360 feat(app-iced): 强调色接线落地（M250 ACCENTWIRE） 
appearance.accent_color 此前是死线：配置键、presenter 往返、预设色板都在，但造 tokens 的
唯一入口恒走 DesignTokens::brand(board)，用户填了色界面不变。

- theme.rs：Ui::with_accent + accent_scheme（唯一调用 DesignTokens::with_accent 的地方）
- app/state/theme.rs：rebuild_ui 三选一（显式强调色 > D38 取色方案 > 出厂板），diag 一行说清是谁生效
- pages/appearance：新增 accent 状态（原文/解析结果/方案/结构化错误）+ 设置页输入行与预设色块；
  非法值保持上一次合法值并给出 Short/Long/Digit 三档原因，不静默回退出厂色
- presenter::prefs：AccentChoice::parse 成为唯一解析点，set_accent_checked 交回结构化原因
- app/appearance.rs：persist_appearance 带上 accent_color（此前写不进去），只写上一次合法值
- pages/harness/app.rs：gallery 也能吃 ULL_APPEARANCE_ACCENT，供出图矩阵
- core keys.rs：订正「空 = 出厂 #0078D4；accent 令牌全域生效」这句半真半假的说明
- i18n：强调色 7 条文案（链尾新域，金表只追加）

判据：同一组件（进度条 Primary）在空配置与 #006A5C 下色值不同（App 级 + 令牌级两条）；
非法值拿到结构化错误、生效色不回退、不写盘、tokens 仍可构造。
 2026-11-11 14:56:26 +08:00
AskaEth 31cb109445 fix(app-iced): 探针补回宽度判据，并订正覆盖面与 12.4 的口径（M248 r1 P2-1/P2-2） 
P2-1：`TRACK_MIN_RUN = 200` 把「轨道被宿主裁短」这类几何回归从红变成绿——复审把 after 图里
0% 那条轨道右半截涂回画布色（连续段 160px）之后，那一行直接不成带，check_linear 靠另一条带
照样绿。现在拆成两条判据：成带阈值降到 **100**（实测：确定态行 318~320、不定态行 306~308、
文字行 22，两头都留得住），宽度**单独**判 ≥300（`TRACK_MIN_WIDTH`），不再藏在圆角检查的
find 里。反例复跑：两套主题都红「实测最宽段 160px @ 行 163」。

新增 `feedback/tests/bands.rs`（合成图，不依赖真实截图）两条用例，把两个阈值的取值区间钉住：
窄轨道必须仍成带且过不了宽度判据、22px 的文字段永远不成带。变异自证：调用点换回
`bands(.., 200)` → 两条用例都红（`left: [(12,15)] / right: [(5,8),(12,15)]`）；
`TRACK_MIN_WIDTH=150` → 窄轨道用例红。

P2-2：订正两处写反的账——实测 `轨道带 2 条（高 [4, 5]）`，**两条带都在**厚度/宽度判据里
（5 行那条含 1 行抗锯齿，near 容 ±1），不是「只剩一条」；12.4 只量主色两段的左右端点，
**不量**轨道厚度。根因（按单条 320 轨道心算 ~88px vs bands_by_run 按整行取 306px）已写进
`TRACK_MIN_RUN` 的文档。

顺带：12.1 的判据从 probe.rs 搬进 `probe/track.rs`——加完这几行 probe.rs 正好 401 行，
撞 400 红线；顺着 circular / panels 的先例一族几何一个文件。
 2026-11-11 14:32:27 +08:00
AskaEth 8f5dac2ed6 fix(app-iced): 三处 Pixel 偏离按角色语义收敛（M248） 
P2：Elevated 的容器改由高程令牌推导（Elevation::Level1.surface_role），解析值仍是
SurfaceContainerLow，图上逐像素不变；「比 Surface 高一档」从此只有 elevation.rs 一处定义，
组件里不再手抄角色名。

P3：Outlined 的 1dp 描边 OutlineVariant → Outline。design/color/mod.rs 的对比度纪律里
Outline 才是「非文字元素（目标 3:1）」，OutlineVariant 是纯装饰分隔线；图标按钮那一式本来
就是 Outline，文字按钮此前与它不一致（全站两套描边）。实测 Outline/Surface：Ink 5.08、
Silver 4.24（OutlineVariant 1.97 / 1.62）。

P4：进度轨道（线性 + 环形）SecondaryContainer → SurfaceContainerHighest——轨道是「还剩多少」
的背景尺，强调色只属于指示条。与 A1（LinearProgressIndicatorTokens.TrackColor）的差异在
progress.rs 模块文档与 geometry.rs 的 12.2 行登记，gallery 图注同步改成角色名。

判据：新增 buttons/tests/roles.rs 与进度轨道用例，断言的是「取到的角色」与 Ink / Silver /
Scheme::from_seed 三套方案下解析出的颜色，不钉任何 hex；三处各做一次变异自证（改回旧值即红）。

另修 feedback probe 的定位判据：轨道换成中性容器面后，「画布→轨道」的混色轴穿过中性文字，
按「计数」会把图注行数成轨道，改按「连续段」判（bands_by_run）；顺带修掉 indeterminate_row
把标题行当主色带的既有问题（用改前的图 + 改前的探针复现过，与本次换色无关）。
 2026-11-11 14:32:26 +08:00
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