AskaEth/Unlucky-Launcher
1
0 Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity
665 Commits 3 Branches 6 Tags
f217d836800272901b5990bdb92a284102602ee6
Commit Graph
172 Commits
Author SHA1 Message Date
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
AskaEth f5a2610e4d docs(app-iced): 值字级注释改真 + probe 只认 buttons/divider + 截图主题钉死回归测试（M229 复审 r2） 
1) P1-2 的注释值与量测对齐（四处）：`elevated.rs` 的 `PAD`/`Texts::title`/`texts()` 与
   `pages/instances/detail.rs` 还写着「值 14/400」，而实现是 12/400；`PAD` 文档更把 12px 的
   118px 量测挂在「14px 下」。全部改成真值，并把 14px=138px 与 12px=118px 两个量测并列写清。

2) probe 门禁只解决一半：`SECTION=buttons` 绿、`SECTION=all` 仍红（sizes 段的实心块撞「按钮
   40 高」判据），断言文案却写「all 或 buttons」。现在：
   - 只支持 `buttons`（按钮矩阵，实心块判据**只量矩阵区**，后续段不再参与）与 `divider`
     （分隔线两条判据，独立出口）；
   - `all` / 其它 / 未给 → 明确失败并给理由（整页比 1180×760 高，分隔线段与按钮矩阵不可能同屏；
     整页图的 chip/卡片会被当按钮量）；
   - 模块文档的复现命令补上 `ULL_GALLERY_SECTION`（以前照着跑会 panic）；
   - `gallery/mod.rs` 的「五段」→ 七段；`gallery/buttons.rs` 的「8 行 + icon·standard」→ 9 行 + 四式。

3) 截图通道的主题档钉死此前没有回归测试（复审 r2 P2-a）。新增
   `the_screenshot_channel_pins_the_theme_mode_instead_of_reading_the_file`：两份不同的机器配置 +
   同一组截图参数 ⇒ 同一个档位且等于参数；反证非截图通道下两份配置确实分出两档。
   变异自证：把分支改回 `bridge.load().1` → 该测试红（left: Dark, right: Light）。

门禁：fmt --check 0 / check -p unlucky-app-iced --all-targets 0 / test -p unlucky-app-iced 0
（887 passed + 6 integration）/ clippy -p unlucky-app-iced --all-targets -D warnings 0 / 400 行扫描干净。
probe 亲跑：buttons 浅+深两张 sheet OK，divider 一张 OK，`all` 按预期被拒。
 2026-11-11 01:49:16 +08:00
AskaEth 8958b7f67d fix(app-iced): IconButton Outlined 真的画环 + ELEVATED CARD 值串单行（M229 复审 P1） 
P1-1：`icon()` 把 `StyleSpec.stroke` 写死 `0.0`，`IconVariant::Outlined` 的描边角色只到
`roles()` 为止、没画出来 —— Outlined 与 Plain 逐像素相同。改成「有描边角色就是 1px」，
并把「角色 → 填充/内容/描边」抽成 `icon_style_spec()`（`icon()` 直接吃它），单测因此能断言
**接线**而不只是断言 `icon_stroke()` 这个纯函数（第一版正是这样漏掉调用点的）。

回归门两条：纯函数/接线（`buttons/tests/icon.rs`，变异回 0.0 时红）+ 渲染层
（`gallery/probe/rows.rs`：图标按钮左缘 4px 带里 Outlined 有环墨、Plain 必须 0 px；
变异后重出图再跑会红）。环在软渲染里是 Outline 叠画布的抗锯齿混色（实测 110/124/110，
本体 123/138/123），所以判据是「这一带有墨/没墨」而不是颜色匹配。

P1-2：ELEVATED CARD 内距 24 + 值 16px 让「2026-10-29 19:22 UTC」折行，同排卡底不齐；
旧测试还断言 20/14（不变量 118+2×padding ≤ 160 变成 166 > 160，假绿）。
按塔裁决「收内距/字号、不破卡片宽度契约」：`PAD` 24 → 20（= card_padding）、值字级 → BodySmall 12。
量测：时戳 14px 墨水宽 138px（160 外框内宽 120 放不下）、12px 为 118px（放得下，余 2px）。
测试改成四条绑一起（字级 12 / 内距 20 / 160−2×PAD ≥ 118 / 2 列实际宽度也 ≥ 118），
并反证「14px 确实放不下」防登记被当噪音删掉；变异回 14px 时红。

P2（顺带）：
- 截图通道的主题档由 `--screenshot-theme` 钉死（此前读机器 launcher.json，设置页主题行会漂）
- `gallery::probe` 只认 gallery sheet（必须给 `ULL_GALLERY_SECTION`，否则整页图的 chip 会被当按钮量）、
  行表 8 → 9 行（四式图标按钮）、分隔线判据只在渲染了 divider 段时执行、逐行阈值 40 → 30 并加
  「满档色像素必须少于 38% 像素」的反向判据、probe 拆出 `probe/rows.rs` 守 400 行
- FAB extended 的重复分支合成一处，右内距提取 `EXTENDED_PAD_END`；iced 0.14 无 `Length::Min`，
  「最小宽随标签增长」退化为固定宽已登记
- 五处注释谎言改真（theme/tests、general/theme、elevated、launch_args、app/tests/theme）

`buttons/tests.rs` 加用例后 402 行 ⇒ 图标按钮那组拆到 `buttons/tests/icon.rs`。
 2026-11-11 01:49:15 +08:00
AskaEth f9877a89d8 fix(app-iced): 下载页页头「内容库」选中态反转（M229 复审 F3） 
`pages/content.rs::section_switcher` 把 `on_content` 写死成 `true`，而下载页也调它，
于是版本管理页的页头把「内容库」画成选中、「版本管理」画成未选中。

改成由调用方给位置：下载页传 false、内容库页自己传 true；并加一条源码层面的调用点断言
（iced 的 Element 不可内省，判据只有一行，写错必红）。

不是 M229 引入的缺陷（M109 就有），按复审要求单独提交，不与收官换肤混在一起。
 2026-11-11 01:49:14 +08:00
AskaEth db541c820e feat(app-iced): Ink Cat / Silver Cat 换肤 —— 双色板默认 + 规格卡组件几何（M229） 
产品出厂外观从 tone 派生的 `Scheme::baseline` 切到品牌色板：深色 = Ink（淡绿）、
浅色 = Silver（钢蓝），D38 取色链（背景图 / 壁纸）仍然优先，取色失败回落到色板。

主题三档接进设置页「通用 → 主题」：Ink / Silver / 跟随系统（落盘仍是
`appearance.theme_mode` 的 dark / light / auto，不新增配置键）。

组件几何按规格卡对齐（M228 的 `inkcat` 登记项逐条落地）：
- 卡片圆角 12 → 16；实例元信息卡改用新的 ELEVATED CARD（无描边、SurfaceContainer
  底、内距 24、上标注 11/600）
- Snackbar 48/4 → 52/16（双行 72）
- Checkbox 20/rx2 → 18/rx4；Radio 20 → 18 Ø（内点仍 10）
- 按钮加 XS~XL 五档（产品仍只用 S=40），内距改走 ControlSize::pad_x
- 新增 FAB 四态（40/56/80/160×56）与图标按钮第四式 outlined
- 语言与主题两行 chips 统一成规格卡 chip（32 高 / rx8）

`theme.rs` 原本正好 400 行，先把单测纯搬移到 `theme/tests.rs` 再加色板字段；
`app/tests.rs`、`settings/general.rs` 同样按纯搬移拆分守 400 行硬线。

验证：cargo fmt --all --check、cargo check -p unlucky-app-iced --all-targets、
cargo test --workspace（除 clippy 前的一轮 flake，见报告）、cargo clippy --workspace
--all-targets -- -D warnings、全仓 400 行扫描。视觉矩阵 42 张在
DevDocs/artifacts/m229/（gitignored，不进提交）。
 2026-11-11 01:49:13 +08:00
AskaEth 4f5a76f238 docs(download): r2 复审返工——改名后的旧注释三处、视口高度口径如实分档、fade 单测改成对生产值断言（M227） 
P2-1（三处改名后旧注释 + 一处口径，纯文档/注释，无像素变化，未重出图）：
- `install.rs` 段标题「两个 Shared 分支」→「两支「面板先保预算」的分支（Shared / Narrow）」，
  两条子项分别标注 `(Shared)` / `(Narrow)`（改名后只剩一个 Shared，另一支已是 Narrow）。
- `options/view.rs` 的 `Shared` 条目删掉「（chips 档还可能有错误行）」——chips 档被 arm 1 接走
  给 `Narrow`，`Shared` 走不到错误行；`Narrow` 条目本来就写对。
- `tests/options_shot/chips.rs` 断言③ 的注释：实测这条断言在窗口 518–610 里命中的是
  y=550、宽 94px 的**实心「安装」药丸**，版本菜单容器上沿在 636–639（窗口外）——删掉
  「菜单容器的满宽底边」这个错误替代项，并把实测值写进注释。
- 滚动区高度口径：八审原文恢复为「1180×760 ≈96–104px」（署名真实性），另起一句写 M227 在
  tip 上的复量：1180×760 = 101px、1180×900 = 109px、窄档 = 120px，并注明 r2 量的 116px
  与 109px 只差「钉死区从哪一行算起」。`DevDocs/artifacts/m227/README.md` 同句一并改。

P2-2（fade 单测空转，r2 实测变异 STEPS=6 仍绿）：
- 步数与 α 曲线提成 `pub(super) const VIEWPORT_FADE_STEPS` + `pub(super) fn step_alpha(i)`，
  `viewport_fade` 用它们；单测改成对**生产值**断言四条：步数 = 高度像素数（1px/条）、
  α 严格递增且除末条外 <1、相邻增量非递减（曲线要凸）、末条 = 1.0。

变异验证（自己跑，红过再还原）：
- `VIEWPORT_FADE_STEPS` 12 → 6：`panicked … 步数必须等于高度像素数：12px 要 1px 一条，
  现在 6 条 ⇒ 2px/条`，MUTATION_EXIT=101；还原 12 后 GREEN_EXIT=0。
- `t.powf(1.6)` → `t.powf(1.0)`：`panicked … 第 2 条比前一条浓得更少…曲线要凸（t^1.6）`，
  MUTATION2_EXIT=101；还原后绿。

门禁（真实退出码，CARGO_TARGET_DIR=C:/Temp/ull-target/wt-227，-j 4）：
fmt 0 / check -p unlucky-app-iced --all-targets 0 / test --workspace 0（67 个 ok，
app-iced lib 875 passed，四条像素守门 + fade 单测全绿）/ clippy --workspace --all-targets
-D warnings 0 / .rs 扫描 >400 行 0 个、<2 字节 0 个。
 2026-11-10 23:07:20 +08:00
AskaEth 122accdd02 fix(download): 窄档滚动视口底部加 12px 淡出遮罩，去掉被硬裁的「空壳蓝条」（M227 返工） 
D30 视觉审 hold 的必改项：滚动视口在 y=660 硬裁，把版本菜单的容器上沿切成 639–659 = 21px、
**零字形墨迹**的一条色块（深色下 (22,33,41) vs 画布 (9,21,28)，CR 1.99），读起来像渲染错
而不是「下面还有内容可滚」。

改法（reviewer 推荐方案①，保留发现性）：
- 新增 `options/fade.rs::viewport_fade` + `VIEWPORT_FADE_PX = 12`：12 条 1px、α 单调上升的
  **画布色**实色块拼成的斜坡（iced 0.14 没有渐变原语；1px 步进的差别在 1/255 量级）；
- `options::section` 的窄档分支把滚动区包一层 `stack![滚动区, 底部对齐的遮罩]`，遮罩贴着
  视口内沿（≤660），压不到钉死区的实例名（≥668）；
- 颜色取 `ui.layer(MaterialLayer::Canvas)`：浅色淡出到纸面、**深色淡出到墨底**（不是白雾），
  与它下方那块背景同色，所以两档都不新增颜色；
- 三栏档不铺这条遮罩：那里滚动区内容恒 76px < 视口 ≈118px，不会出现半截内容，铺了只是
  「画布盖画布」，反而会动 M222 已验的 1180 像素；
- `options/view.rs` 已 422 行、撞 400 行硬线，遮罩拆成 `options/fade.rs`（含一条几何自检单测）。

实测（720×760）：
- 浅色 x=600 竖列 648 (211,229,245) → 659 (246,250,255) 单调升到画布色；深色 648 (55,72,85)
  → 659 (9,21,28)，无白雾；中文与浅色逐值同串；
- 可见带 21px → 墨迹口径 18px + 底 12px 连续渐变（硬裁边消失，右侧滚动条仍在）；
- 逐像素零回退：`77d675b`（遮罩前）vs 本轮 720 浅/深/中 + 700 守门，差异 bbox 只有
  (112,648)–(696,660) 这 12 行，其余像素一个都没动；1180×760 浅/深/中 与 1180×900 对
  M222 基线仍 **IDENTICAL**。

门禁：fmt ✓ / check ✓ / test --workspace（喂四张守门图）exit 0（app-iced lib 860 passed、
四条像素守门 + 400 行门全绿）/ clippy --workspace --all-targets -D warnings exit 0 /
.rs 全仓扫描 >400 行 0 个、<2 字节 0 个。

已知残留（本轮不动，按债务台账口径登记）：menu 的 L2 阴影不随滚动视口裁切（压在实例名输入框上
约 6.9%，三栏档 fabric 同样存在）——根因在 `components::inputs::menu`，不在 M227 scope，
待专门 mission；finding `.tower/comms/findings/20261110-worker-m227-bug-l2.md`。
 2026-11-10 23:07:20 +08:00
AskaEth a70d5f8010 fix(download): 窄档面板加专属预算，首屏露出 head+六枚 chip+说明、实例名回到 56px（M227） 
720×760（chips 档）原先走 `TailShare::Shared`：面板与列表各吃 Fill 的一半，面板钉死区
（说明 + 菜单 + 实例名 ≈180px）把它吃穿 ⇒ 滚动区视口 0，head（版本 id + 安装按钮）、
六枚加载器 chip、说明一个像素都不在屏，实例名被挤成 35px 且降部被自身边框裁掉
（M222 D30 五审 `artifacts/m222/visual-verdict-r5-hold.md`）。

改法（把 M222 在 1180 档验证过的「面板先保预算、列表吃整行」落到窄档）：

- `TailShare` 拆出第三支 `Narrow`（chips 档 + 面板占高度），`of()` 的三条 arm 与
  `Shared` 的机制注释按 r8 finding 重写（旧文档只写 M125 那一条条件）；
- 新增 `CHIPS_STACK` 121 / `CHIPS_LIST_CHROME` 119 / `CHIPS_PANEL_BUDGET` 192 与
  `narrow_rows()`：720/760 下面板先拿预算，列表 = **132px = 3 整行**（M125 像素守门的下限）；
- `options::section` 三分支：窄档钉死区**只留实例名**，head / 六枚 chip / 说明 / 版本菜单
  进滚动区（滚动区 120px ≥ 首屏 104，菜单露容器上沿 + 滚动条可见）；
- `TailShare::list_height()` 把「列表吃多少」收到一处，两个装配点共用（三栏档行为不变）。

取舍：窄档列表 4 整行 → 3 整行；菜单从钉死改为可滚。理由（459px 里「钉住菜单」+「3 整行
列表」互斥）写在 `rows/tail.rs::CHIPS_PANEL_BUDGET`。

实测（tiny-skia 出图 + 自写 measure.py，DevDocs/artifacts/m227/）：
720×760 分隔线 559→514、滚动区 0→120、head 539–578、chips 583–614（32px）、说明 623–634
（8.98:1 浅 / 10.83:1 深）、实例名 668–723 = 56px（inset 12/9/17）；
700×760（options-fabric）实例名从「完全不在屏」回到 56px；四条像素守门全绿；
1180×760 浅/深/中 与 1180×900 **逐像素零变化**。
 2026-11-10 23:07:19 +08:00
tower-worker a0f61d8bb5 feat(mods): 本地 Mod 列表与启停（M224 MODTOGGLE） 
三层一次做完：core 读写目录 → presenter DTO/host → 实例详情页 MODS 区。
r1 复审后 rebase 到 main 71144df（M223 已合入），并修掉四条文档疵。

core（crates/core/src/addon/mods/）
- suffix：`.disabled` / `.old` 的**唯一判据**（四态枚举 + 展示名 + 双向改名目标名），
  收敛原先两份同构实现——`export/scan.rs::is_disabled_path` 与 `import/plan/paths.rs::suffix_variant`
  改为委派/再导出，签名与行为不变。
- list：单根语义（入口是 derive_game_dir 派生出的运行目录）列 `<run>/mods/`，不按扩展名过滤，
  符号链接/目录/怪名字逐条登记原因；`mods/` 本身是符号链接时拒（不跟随）。
- toggle：启停 = 在 `mods/` 里改名。五条守卫（裸文件名 / 目录可用 / 普通文件 / 不覆盖 / 不做
  copy+delete 兜底）+ 幂等；`.disabled` 只插在 `.old` 之前。

presenter
- dto/mods：ModsCommand / ModListView / ModFailureView（不拼文案，只给结构 + OS 原文）。
- host/mods：后台线程列目录与启停，运行目录走与启动同一份 D20 派生、不写任何设置；
  游戏在跑时 host 侧直接挡。
- state/mods：快照整体替换、迟到结果丢弃、在飞标记；`AppState::mods`。

app-iced（实例详情页）
- MODS 区（`pages/instances/mods.rs`）：名字 + 大小 + `.old` 徽标 + Switch；运行中/在飞只读。
- 进入详情页即后台列一次（不走 3 s 观察窗，避免打红 M192 的「空闲不烧帧」守卫）。
- MODS 卡排在启动参数**之前**（详情列是滚动区，排在后面 1180×1000 下永远看不见）。
- i18n：19 条中英文案（`catalog/instances.rs` + 金表）。

rebase 冲突解法（三个文件，全是"两侧同段新增"，都保留）：
- `i18n/catalog/instances.rs` + `i18n/catalog/golden.rs`：M223 的 Adopt* 段在前、M224 的
  InstancesMods* 段在后（= `Key::ALL` 顺序 = 金表顺序）。
- `presenter/src/state.rs`：`adopt` 与 `mods` 字段/初始化/apply_core 分支都留；`tiles()` 归
  `state/tiles.rs`（本分支搬的），`apply_agent`/`agent_rail_visible` 归 `state/agent.rs`
  （M223 搬的）——两处搬移不重叠，state.rs 里都不再出现。

r1 四条文档疵：
1. `pages/instances/mods.rs` 模块文档：挂载位置写反（"启动参数卡之后"→实际之前），并补上为什么；
2. `state/mods.rs`：引用不存在的 `CoreEvent::ModsChanged/ModsFailed` → 改成 `CoreEvent::Mods`
   + 文字说明 Ok 落快照 / Err 落具名失败；
3. `app/state/mods_shot.rs`：文档说"目录串取真实派生结果"但代码留空 → 改成"故意留空"；
4. `app/state/refresh.rs::note_mods_failure`：文档说"连点两次看见两次红字"与去重机制不符 →
   改成按 `(实例, 文件, 大类)` 三元组去重（防刷屏），换文件/换实例/换大类仍会再弹。

顺带（r1 已确认的 main 红）：`pages/download/options/view.rs:88-89` 两条
`clippy::doc_lazy_continuation` 只缩进修掉，文字未动。
 2026-11-10 21:09:37 +08:00
AskaEth a16aadd467 docs(app-iced): 按 TailShare::of 的真实分支清扫下载页面板注释（r7 三条 + 全量扫） 
(i) 上轮新引入的错误声明 rescope：错误行「恒为 None / 滚动区只有 head+chips」只在**三栏档 +
    带版本列表**这一支成立（has_loader_versions() 要求 problem.is_none()）。**chips 档**（可用宽
    < 600，TailShare::of 对 Options/Install 无条件 Shared）里 problem 可以是 Some（静态不兼容 /
    列表取不到 / 空表三种），错误行会进滚动区且可能被滚走；show_versions() 为假时钉死区只剩
    实例名。install.rs 与 options/view.rs 都按这两支分别写清，并注明该行为域由 M227 重设计。
(ii) install.rs 的「显式给对半分档标志」「对半分：面板吃满自己那一半」改成预算优先口径
    （与同文件十行上方「不是早期的对半分」不再矛盾）。
(iii) rows.rs 三处：三栏档「照旧钉死」限定为「**不带版本列表**的选项区」；`content` 的 share
     说明改成引用 TailShare::of 的真实两支，不再复述「三栏钉死 / chips 各吃一半」；
     「只有对半分那一档才按整行取高」改成「只有 Shared（面板先保预算）那一档」。

全量扫附带修正：tail.rs 的 ROW_PITCH / PANEL_BUDGET 账（760 例改成 176/437、900 改成 569；
预算拆成滚动区 76 + 钉死区 153）；options/model.rs 的 has_loader_versions 文档改成预算口径。

零代码零测试变更。
 2026-11-10 19:34:15 +08:00
AskaEth 409c742aa8 docs(app-iced): 扫掉 r6 的三处文档残留（B 结构合入前最后一改） 
(a) install.rs 的 panel/panel_with 文档按当前结构重写：`shared` 不再是「对半分」（现为
    面板先保预算 + 列表按整行，见 rows/tail.rs::whole_rows）；滚动区实际只有 head + 六枚 chips
    （菜单 9358668 进钉死区、说明 a6f7974 进钉死区），钉死区 = 说明或标签 + 菜单 + 实例名；
    并写明错误行在 Shared 档恒为 None（静态不兼容时不画版本菜单、走不滚动那条路）。
(b) options/view.rs 里「标签与说明都搬到钉死区」自相矛盾：改成「**说明**搬到钉死区；
    『安装选项』标签在 Shared 档**删掉**（八审裁决），Pinned 档保留」。
(c) 同文件 section() 文档里「滚动区溢出时被滚走的是错误行」描述的是不可达情形：改成
    「滚动区只有 head + chips，用户可见内容不会被滚走（错误行在 Shared 档恒为 None）」。

零代码零测试变更。
 2026-11-10 19:34:15 +08:00
AskaEth 33d05689e8 fix(app-iced): 说明只画一份（删滚动区重复）+ 口径三处改真 
八审唯一阻断：中性说明画了两份（滚动区 546–557 与钉死区 576–587 像素级相同、重影）。
删掉滚动区那份，钉死区保留；01/02/05 与 900 的说明墨迹带现在只有一条（576–587 / 716–727）。

口径三处：
1. `section` 文档的滚动区内容改成实际（head + 六枚 chips + 错误行）；
2. 旧的「≈150px / 无需滚动」改成八审实测（可见 96–104px、内容 76px、head 墨迹 462–501、
   chips 506–537 四角闭合）；
3. 钉死区注释「标签与说明都搬到钉死区」改成事实：Shared 档的「安装选项」标签是**删掉**的
   （设计决定，八审裁决），只有说明是搬下去的；Pinned 档仍保留标签。
 2026-11-10 19:34:15 +08:00
AskaEth e2e3c39f61 docs(app-iced): 扫掉 r5 的五处文档漂移（返工链留下的旧描述） 
1. install.rs 模块文档：删掉「钉页脚本轮没做」（6f87c8b 已做：钉死区现在是菜单 + 实例名），
   三层滚动的第 3 层改引 `version_menu_height`（VERSION_ROWS 已改），并写明「选项区自己滚」
   这层是 M222 之后才有的、`Options` 态不再套外层 scrollable（只有 `Install` 态用）。
2. rows.rs：五个 loader chip → 六枚；「实例名那一格滚一下就到」→ 已钉死；分法描述改成
   「面板先保预算 + 列表按整行」（PANEL_BUDGET / whole_rows）。
3. rows/tail.rs 的 TailShare 表：两半各 Fill → 面板先吃预算；补上「带加载器版本列表」这一例外行；
   判据注释改成「像素由 window_height 算」（view_sized 已接）。
4. rows/tail.rs 的 M222 分支注释：删「仍欠一项 S1b」（107d619 已修、26ec3f4 已换预算公式），
   写清现在 1180×760 = 176px/4 行、900 = 308px/7 行。
5. options/view.rs 控件树示意：改成当前真实顺序（滚动区 = head + chips；钉死区 = 说明/标签 +
   菜单 + 实例名），并补上钉死档另走一条路的说明。
 2026-11-10 19:34:15 +08:00
AskaEth 7ea3dbf8f0 fix(app-iced): 方案 B——说明与「安装选项」标签撤出滚动区，滚动区只装控件 
六审算术：滚动视口 103px < 内容 130px，说明 0 像素 + chip 底边框被裁 2 行。方案 C（标签并排）
不可行——六枚 chip 已占 404px、正文列 424px，并排必横向溢出裁掉第六枚，等于用一个已完成项
换另一个。按塔授权走 B：

- **滚动区**（仅 Shared 档）：head + 六枚 chips，间距 X2→X1；
- **钉死区**：说明行（有说明时占「加载器版本」标签那一行，否则显示标签）+ 版本菜单 + 实例名。
  钉死区高度不变（两者都是一行），列表仍 4 行；
- **钉死档保持旧结构**：把标签撤出会让原版面板矮 26px、列表涨到 302px（6.86 行、切出半行），
  实测把 `04` 从 531 挪到 563 —— 第一版就是这个坑，已按此回退。

实测：01/02/05 分隔线 437、列表 **176px = 4.00 整行**、说明墨迹带 y 576–587（真像素）；
04 **531 未变**；03/06 268 未变；900 档 569 / 308px = 7.00 整行。
 2026-11-10 19:34:14 +08:00
AskaEth cb2cffb3ca fix(app-iced,i18n): 分高改「面板先保预算」+ 说明压成单行（D30 五审一次性重分配） 
五审：菜单文字/720 列表/44-97 标定/04 都过，但滚动区被压到 82px（宽）/24px（窄）——宽档切
「安装选项」字身、六枚 chip 0 像素。塔裁决停止逐轮调顺序，一次性重分配：

1. **分高从「对半分」改成「面板先保预算」**：`PANEL_BUDGET = 300`（滚动区 128 + 钉死区 136），
   `whole_rows = floor((column − LIST_CHROME − PANEL_BUDGET)/44) × 44`。
   1180×760：580−97−300 = 183 ⇒ **176px = 4 整行**（原 5 行），面板 307px ⇒ 滚动区 ≈150px；
   1180×900：323 ⇒ **308px = 7 整行**（未变）。720 档走 `None`（Fill），未动。
2. **说明压成单行**（`DownloadOptionsLiteLoaderVanillaOnly`）：两行 28px 是滚动区最大的可压项。
   en `Vanilla parent only — Forge goes through the CLI` / zh `只叠原版；叠 Forge 请走命令行`；
   完整命令行说法留在 `ull help install`。单测断言随之改成「含该句 + 只有一行」并写明原因。

文档按六审要求改口：滚走的是说明/错误行（非控件）；说明变单行后 760 档滚动区已能装下
head+标签+chips+单行说明，**无需滚动**。
 2026-11-10 19:34:14 +08:00
AskaEth 6eb7132ab0 fix(app-iced): 加载器版本菜单搬进钉死区（裁切位置由钉死区高度决定，不是首屏分配） 
四审点破根因：面板的裁切 y 由**钉死区高度**决定、与窗宽无关（1180 与 720 都切在同一处），
所以上一轮「把说明挪到菜单之后」只是换了被切的对象——菜单容器 642–706 只露 18px、条目文字
一个都没画，说明整块不可见。

按 tower 裁决改成结构方案：
- **滚动区**：head（版本 id + 安装按钮）+ 加载器 chips + 中性说明 + 错误行；
- **钉死区**：加载器版本菜单（标签 + 菜单，按条目数占高）+ 实例名输入框。

菜单不再依赖首屏剩余高度分配，可达性由结构保证；溢出时被滚走的是说明/错误行（非控件）。

实测（未变的部分也一并核对）：01/02/05 分隔线 **481**、列表 **220px = 5 整行**；04 对照 **531 未变**；
03/06 窄窗 **268 未变**（本轮结构改动没有挤动列表）；900 高加测 569 ⇒ **308px = 7 整行**。

文档按四审改正：`section` 的文档不再写「首屏能装下菜单/切点不再切字」，改成「裁切位置由钉死区
高度决定」；面板结构写清 head 在滚动区、菜单与实例名在钉死区。
 2026-11-10 19:34:14 +08:00
AskaEth 0ca28d24ff fix(app-iced): 版本行节距/列表 chrome 标定重算（44/97）+ 中性说明挪到版本菜单之后 
三审给了独立量测，两处都按它的数字收敛：

1. `ROW_PITCH` 278/6=46.33 → **44.0**（278 里含列表与面板之间的 8px `Space::X2`）；
   `LIST_CHROME` 93 → **97**（列顶 156 → 列表顶 253）。1180×760 分隔线 492 → **481**、
   列表视口 **220px = 5 整行**；1180×900 加测 = 308px = 7 整行，三审报的 900 高残影不复发。
2. S7 钉页脚引入的新问题：面板上半块的滚动切点压在字形上（宽窗切「加载器版本」标签上沿、
   窄窗把 chips 切成 4px 条）。把中性说明从菜单**之前**移到**之后**——它两行高，排前面正是把
   唯一的加载器专属控件顶出首屏的元凶。

顺带纠正一处文档：面板结构不是「头部 + 可滚上半 + 钉页脚」，head（版本 id + 安装按钮）是上半块
的第一个子项、**安装按钮也在滚动区**，只有实例名是钉死的。
 2026-11-10 19:34:14 +08:00
AskaEth 954281d71a fix(app-iced): 版本列表在三栏对半分档按整行取高（S1b/S9） 
列表视口高度不再是「Fill 剩下的」：正文列高度由仓里已有的 `frame::body_height` 算出，
经 `view_sized` → `body` → `rails::three_column` → `rows::content` 传下来，Shared 档据此
`floor(((h − LIST_CHROME)/2) / ROW_PITCH) * ROW_PITCH` 取整行。

实测（1180×760）：列表 245px → **239px**（分隔线 498 → 492，腾出的 6px 归面板），
`04` 对照**未变**（531 / 278px），720 窄窗**未变**（本来就是 4.0 整行、底缘 0 墨迹）。

两处修正写在提交里：
1. 第一版给所有三栏场合取整，把 `04` 也缩到 239px ⇒ 收窄为只在 `TailShare::Shared` 取整；
2. `rows.rs` 涨到 419 行撞 400 行门禁 ⇒ `TailShare` 与三个标定量纯搬移到 `rows/tail.rs`，
   `rows.rs` 回到 355 行（门禁 `components::gate` 与全仓扫描都绿）。

`view` 保留 4 参数（`#[cfg(test)]`，只有单测用），产品路径走 `view_sized`。
 2026-11-10 19:34:13 +08:00
AskaEth f29ca609ec fix(app-iced,i18n): 实例名钉成面板页脚（S7）+ 中文占位符还原（S8）+ 注释实测值（S6） 
D30 r2 视觉二审四条：

1. **S7（新回归）**：S1 的对半分让面板变矮之后实例名被挤出 1180×760 首屏。按 `install.rs`
   早已登记的方案改成**可滚上半块 + 钉死页脚**：`install::panel_with(.., shared)` →
   `options::section(.., scroll)`；`rows::content` 对 `PanelState::Options` 不再整块套
   scrollable（那层既把实例名卷进滚动区，也在窄窗产生第二条并列滚动条）。页脚不参与滚动，
   可达性由结构保证，S2 随之关闭。
2. **S8**：`catalog/download.rs` 与金表同一行的中文命令占位符 `<Forge 版本 id>` 照抄不可执行，
   还原成 `<forge id>`（两处一起改，金表顺序未动）。
3. **S6**：`rows.rs` 里「两半各 ≈215px / 列表 4.6 行」的估算换成实测（列表 245px = 5.29 行、
   面板 237px、分隔线 y=498），并写明 S1b 仍欠一项与其正确落点。

**S1b/S9（列表底缘整行）本轮没修成**：试过 `responsive` 拿「分给列表的高度」再 floor，
实测无效（`Fill` 子项上拿到非确定高度，量测显示列表区最后墨迹行仍在分隔线前一行），已回退，
不留无效代码。正确落点是把列表可用高度从 `pages/download.rs` / `rails.rs`（都在 scope 外）
传进 `rows::content`。

测试：`-p unlucky-app-iced` 862 passed、`-p unlucky-i18n` 36 passed（金表改动后仍绿）。
 2026-11-10 19:34:13 +08:00
AskaEth cd7813f8eb fix(app-iced): 选项区变高时与版本列表对半分（S1）+ 中英出图注入 + 注释同步 
D30 r1 视觉驳回的三条里，代码能修的两条：

1. **S1 版面**：带加载器版本列表的选项区在三栏档把版本列表从 6.0 行压到 2.4 行（1180×760
   实测 278px→110px，底缘切在第三行图标上）。`rows::TailShare::of` 现在让这类面板在**任何档位**
   都与列表对半分（`scrollable` 分支早已存在），另把加载器版本菜单改成**按条目数**占高
   （1 条 64px / 2 条 112px，原先只有 1 条也固定撑两行）。实测：列表回到 **245px = 5.3 行**。
2. **注释同步（S6）**：`options/view.rs` 模块头原先写「加载器分成两行」+ 两行示意，实际是
   六枚一行（末枚右缘约 404px / 正文列 424）；那条「本轮无看图通道，未出截图」也换成实测值。

顺带（使能中文出图）：`pages/mod.rs::demo_model` 读 `ULL_DL_LANG=zh` 把 `model.lang` 与下载页
目录一起切中文。之前 `LC_ALL=zh_CN.UTF-8` 对出图**完全无效**——页面文案来自 `model.lang`，
而 `Model::new` 写死 `En`、`demo_model` 不碰它（`i18n::detect_env` 不在这条链上）。

测试：`options/s1_tests.rs` 新增两条（菜单只按整行占高；带版本列表的选项区在每个档位都 Shared，
原版/不兼容仍 Pinned），`-p unlucky-app-iced` 862 passed。

未完成：S2 窄窗「滚到底」图——iced 0.14 没有自由函数 `scroll_to`，程序化滚动要手写
`widget::Operation`（约 40 行），本轮不拿半成品充数；面板 `scrollable` 的稳定 Id 已就位。
 2026-11-10 19:34:13 +08:00
AskaEth 841c17152a test(app-iced): 下载页加 options-liteloader 出图取样点（D30 视觉取证） 
M222 的视觉门禁一直缺图：本机没有看图通道，但**出图通道可用**（`--software-renderer` 走
tiny-skia CPU 后端，无桌面也能落盘）。下载页早有专属夹具 `ULL_DL_DEMO`（`demo.rs`，产品路径
不读），M105 就用它出过安装选项区三态，所以这里加第四个取样点，而不是再造一个平行 env：

  ULL_DL_DEMO=options-liteloader pages_demo --screen=download --width=1180 --height=760 \
    --screenshot=out.png --screenshot-theme=light --software-renderer

取样点是「选中 1.12.2 + LiteLoader」（官方版本表只到 1.12.2），走**产品那条真转换**
`Download::from_snapshot`：chip 行、中性说明「只叠原版」、确认键状态都是产品行为。
版本列表**只在本次状态里**补一条 1.12.2——不动 `demo_versions()`，因为那是别处基线图的行集
（`tests/view.rs` 钉着 8 行）。

四张图与真假表落在 `DevDocs/artifacts/m222/`（git 忽略区，不入库）：浅色 / 深色 / 720 窄窗 /
原版对照，README 里写明哪张证明什么、哪些是夹具、哪些是产品真转换。图的内容判定未做——
出图者无图像能力，交给视觉 reviewer。
 2026-11-10 19:34:13 +08:00
AskaEth 04a123deab fix(app-iced,presenter): 修 clippy -D warnings 抓到的三处（文档注释位置、manual_range_contains、单元素 for） 
1. view.rs：我删掉手写 `LOADERS` 常量后，那段文档注释落到了 `VERSION_ROWS` 头上并留了空行
   （clippy::empty_line_after_doc_comments）。说明本身是给「chip 顺序为什么委派」用的，
   改成普通 `//` 注释，不冒充某个条目的文档。
2. model.rs：LiteLoader 的版本区间判定改成 `((1, 5, 2)..=(1, 12, 2)).contains(&version)`
   （clippy::manual_range_contains），语义一字未变。
3. install_tests.rs：只剩 OptiFine 一家后，单元素 `for` 改成直调（clippy::single_element_loop）。
 2026-11-10 19:34:12 +08:00
AskaEth c8bf536c37 feat(app-iced): 下载页在选 LiteLoader 时给中性说明（GUI 只叠原版、Forge 组合走 CLI） 
新增 Key::DownloadOptionsLiteLoaderVanillaOnly（中英各一句，不含花括号占位符）；
金表按 Key::ALL 的真实位置插入（DownloadOptionsNeedsAtLeast 之后、DownloadCancelled 之前），
只加新键不重排旧键。说明走 OptionsView 的新字段 note，不塞 problem（那是错误色 + 禁用确认）。
 2026-11-10 19:34:10 +08:00
AskaEth 944b1610c8 feat(core): LiteLoader 安装路线（官方版本表 + 从零合成 launchwrapper 清单） 
按 M218 SURVEY-p1 §4.1 的清单接上 LiteLoader 的安装路线，不动 OptiFine。

- core: 新增 addon::loader::liteloader（官方 versions.json 解析 + 合成清单）与
  addon::loader::parent（父版本链读盘定位原版版本）；LoaderKind 加 LiteLoader；
  LoaderRelease 加 parent_version_id、LoaderPlanInput::vanilla_installed → parent_installed；
  LoaderInstallPlan::build 改返回 Result（父版本缺失具名报错）；LoaderSource::resolve_on
  支持指定父版本（仅 LiteLoader，其它组合具名 unsupported）。
- 继承边界（本 mission 第一步核实）：arguments.game 父在前子在后追加，minecraftArguments
  子覆盖父，启动顺序 legacy(24) → arguments.game(25)。所以 tweakClass 只写 arguments.game，
  绝不写 minecraftArguments（会顶掉 Forge 1.12.2 的 FMLTweaker）。
- maven/fabric 的 `_ =>` 通配改成穷尽分支：非 maven 族不再静默回落 Forge 的仓库；
  maven::{metadata_url,installer_url} 改返回 Option<String>。
- presenter: supported() 收 LiteLoader、wizard_choices 六选、dto::instances 按关注点拆成
  instances/{loader,runtime,create,tests}.rs（原文件 395 行，动手前先拆）。
- cli: --loader 区分「认不出」(loader_unknown) 与「认得但装不了」(loader_unsupported)；
  <version> 位写加载器版本 id 时按父版本处理（只有 liteloader 接受）；help 只改 install 段。
- app-iced: 下载页加载器 chip 加 LiteLoader（1.5.2~1.12.2，两头按官方没有构建拒），
  chip 清单改为委派 Loader::ALL。
- 测试: 真实响应的裁剪夹具（dl.liteloader.com 与 repo.mumfrey.com 的 maven-metadata）
  驱动「解析→计划→落盘→继承→启动参数顺序」全链；Forge 父链有回归（FMLTweaker 必须还在
  且排在 LiteLoader 之前）；父版本缺失/组合不支持/取消/坏表各自具名错误。
 2026-11-10 19:34:09 +08:00
AskaEth e3ae71ac37 M207: UA 收成一份带联系方式 + 两处字符串副本（gh_proxy 键、用例注释） 
1) UA 只有一份定义：core 的 `download::http::USER_AGENT`
   （`Unlucky-Launcher/<CARGO_PKG_VERSION> (+仓库 URL)`，不用邮箱）。
   - 引擎侧：`EngineConfig::default().user_agent` 直接取它（config.rs 等量替换，仍是 400 行）
   - 带 header 侧：presenter 不再持有 UA 字面量，`get_with_headers` 发 `engine.config().user_agent`
   M205 复审核实过的缺口：Modrinth 收到的是引擎那份 `UnluckyLauncher/<ver>`（无连字符、无联系方式），
   带联系方式的那份只发给 CurseForge 搜索 —— Modrinth 的 UA 政策在真正会被限流的路径上没被满足。

   断言：core 一条钉形状（版本 == CARGO_PKG_VERSION、联系方式段 == 仓库 URL、不含 `@`）；
   presenter 一条在回环上抓**发出去的字节**（两条路径的 UA 逐字节相同且 == EngineConfig::default()）。

2) `app-iced/.../java/downloads/engine.rs`：`"download.gh_proxy"` 字面量改成 `KEY_GH_PROXY`。

3) `presenter/src/host/addon/http.rs` 的用例注释改成事实（Modrinth 走 core 的 EngineTransport，
   `get` 的无 header 分支生产零调用者），模块说明表格同步。

4) `docs/download-settings.md`：§6.1 / §6.1.1 / §7 按 M201（iced 真控件 + 快照通路）之后的现状重写。
 2026-11-09 13:13:20 +08:00
AskaEth b7a1abb18a fix(m206): 「当前默认」改用选中的语汇，不再套禁用配色 
Java 组用 `Chip::badge` 表示「哪个 JDK 是默认」，而 badge 走的是「无消息 ⇒ 禁用」
那条路（`OnSurface`@38% 叠 surface）：M204 实测字/底只有 1.84:1（浅）/ 2.28:1（深），
成了整页最不可读的一段，而它正是「能不能改默认 Java」这个问题的答案本身。
同一张设置页里相邻的「下载」组表达「选中」用的是 `SecondaryContainer` +
`OnSecondaryContainer`（7.21:1）——两个相邻页面对同一个语义用了两套语汇。

改法（不动禁用语义）：

1. 新增 `Chip::current(label)` + `paint::current_item`：**与选中 chip 同一套颜色**，
   但没有消息、不吃五态（没有可点性就没有反馈）。它不等于「未选中」，也不等于
   「禁用」——第三档，判据表写在 `components/selection/chip.rs` 的模块文档里。
2. `Chip::paint(&self, ui)` 成为「哪个档位 → 什么颜色」的唯一入口，`chip()` 用它求
   静息色，断言也用它——档位的判据只有一处，「改回旧配色」的变异会被直接抓住。
3. Java 页的动作位抽成 `view::action_chip`，当前默认走 `Chip::current`，其余仍是可点
   的 `Chip::filter(.., false, ..)`。
4. 下载组**不改**：它本来就是参照语汇（M201 已验收），改完两页逐字段同色。

断言（`pages/settings/java/tests/marker.rs`，浅深两档都跑）：
对比度 ≥4.5:1（实测 7.21/7.21）、与下载组选中 chip 逐字段相等、以及反向断言
「禁用态仍走 38% 字 + 12% 容器且与当前项肉眼可分」。两条变异都在报告里复现过：
`action_chip` 换回 `Chip::badge` ⇒ 对比度断言红（只有 1.84:1）；`Chip::current` 里
`marker: true` 改 `false` ⇒ 三条全红。

举证图（离屏 `--screenshot`，浅/深 + 改前/改后 + 下载组对照）与实测色值表见
`DevDocs/artifacts/m206/`（gitignore，不入库）。
 2026-11-09 12:44:18 +08:00
AskaEth 8a050c4402 fix(m204): 补「扫描中/还没扫描过/正在取消」三格种子 + try_lock 说明对得上代码 
视觉复审 r1 判 p2-1items：六张举证图里「取消」全程是禁用态，「正在扫描… 3/7」
一格都没拍，而 README 却写成「两态」——证据覆盖不到结论（与 M201 同一个坑）。
本提交补种子与拆文件，不出产品行为改动。

- `pages/settings/java/seed.rs`：新增 `scanning` / `unscanned` / `cancelling` 三档。
  三档都把快照写进 `ScanSlot`（新增 `ScanSlot::seed_report`）而不只改 `State.scanning`：
  `clock.advance` 每拍用槽里的快照重算 `scanning`，只改 State 的话第一拍就被推回「没在扫」。
- `pages/settings/java/scan.rs`：`ScanReport` / `Job` / `ScanSlot` / `run_staged` / `rows`
  从 `store.rs` 拆出（加 `seed_report` 之后那个文件 408 行，越过 400 行硬线）；
  `store.rs` 用 `pub use` 再导出 `ScanReport` / `ScanSlot`，既有路径一个都没改。
- `app/view.rs`：`note_screenshot_group` 的锁从 `lock()` 换成 `try_lock()`——代码复审 r1 指出
  注释写着「拿不到锁就不打、不能把界面帧卡在锁上」，而实现用的是阻塞 `lock()`，只兜住中毒
  不兜住等待。选 try_lock 而不是改注释：注释承诺的保证应由代码提供，不能靠「今天只有一个
  调用点、锁里只有一次比较」这种会随改动失效的前提。
- `pages/settings/java/tests/cmdline.rs`：新增 `the_scan_seeds_cover_the_running_states`，
  逐档钉 `State.scanning` 与 `scan.report().running`（后者才是「心跳下一拍会不会把它推开」）。
 2026-11-09 12:09:02 +08:00
AskaEth 5dda9ac31d M201 r2: 修视觉 r1 的两条 P2 + 代码复审的坏值提示 p2 
视觉 r1（fix-then-merge）:
- P2-1 分隔线贴字：downloaded 组的行间距从 0 改成 `Space::X3`（12dp）。实测
  说明末行→分隔线 1–3px → **12–13px**、分隔线→下一标题 4–5px → **12–17px**
  （同族页 9–18px；同一把尺子量演示回退卡 16–19px）。不动 `frame::divider` /
  `demo_card`；`spacing` 只作用于子节点之间，卡片首行顶距与末行底距仍是 20。
- P2-2 孤字「效」：`with_note` 把「原值 X 已按出厂 N 生效」从说明段落里挪到
  **独立一行**（`\n` 分隔，渲染器按行断）。浅/深/窄三张复验：无 <20px 窄行。
  两种措辞（出厂 8 / 已按 1）一字未改，presenter 侧新增 `ends_with("\n原值 …")`
  断言把「独占一行」钉住。

代码复审 p2（非整数坏值被静默丢掉）:
- `raw_int`（`Value::as_i64`）→ `raw_text`：文件里显式写过的原值转**上屏文本**
  （字符串取原文不带 serde 引号、数字/布尔 `to_string`、`null` 当没写）。
  于是 `"auto"` / `8.5` / `true` / `-4` 都能进那句提示，不再「画着 8 却说不出
  用户写的 auto 被忽略」。
- 新用例 `every_bad_value_shape_says_what_the_raw_value_was`：负整数 / 字符串 /
  浮点 / 布尔 / null 五种形态。

验证：fmt --all --check / check -p unlucky-app-iced --all-targets /
test -p unlucky-app-iced(845+6) / test -p unlucky-presenter(316) /
test -p unlucky-i18n(36)，全部 EXIT=0。
 2026-11-09 10:51:16 +08:00
AskaEth ab573838f3 M201: 接通 iced 设置页的数据通路（下载组：真值 + 真控件 + 写回闭环） 
M193 的用户投诉「设置页里改了不生效」的结构性根因是 iced 侧没有设置数据通路：
`CoreEvent::SettingsChanged` 在 `crates/app-iced/src` 零命中、`pages::Model` 没有设置快照、
`download::State` 是空 struct。presenter 那套设置组早就是真值来源（`host::settings::groups`
由 `refresh_all` 与 `dispatch` 的 `SetSetting` 分支发成 `SettingsChanged`），只是没有接到 iced。

这条线现在通了：

    host::settings::groups → SettingsChanged → AppState::settings_groups
      → pages::Model.settings → settings::States.settings → 下载组控件
      → AppCommand::SetSetting → 写盘 + 重新发 SettingsChanged（闭环）

主要改动
- presenter `host/settings/download.rs`：并发/重试两行改成画**引擎生效值**（`DownloadTuning`），
  文件原值与生效值不一致时写明「原值 X 已按出厂 N 生效」（P3-5，两个数都现读）；
  gh-proxy 行补「当前生效：跟随内置默认/已关闭/覆盖为 X」。
- app-iced `pages/settings/download.rs`：`GROUP.body = Some(body)`，按 `SettingControl`
  画 choice（filter chip）/ text（输入框 + 应用）/ action（按钮）/ toggle / readonly；写回走
  `app/update/settings/download.rs` → `AppCommand::SetSetting`（不做乐观回显）。
- `pages::Model.settings` + `settings::States.settings`：快照进页面的唯一通道。
- i18n：新增 `SettingsDownloadsApply`（金表锚点追加，`split_keeps_every_translation` 绿）。
- 取证：`ULL_SCREENSHOT_REAL_HOST=1` 让 `--screenshot` 接真 host（截图通道默认强制 mock，
  而 mock 不发 `SettingsChanged`，真值屏拍不出来）。

测试（新增 11 条）
- presenter `download_tests.rs`：P3-5 的越界回落 / 0→1 / 无差异不出提示 + P3-3 的
  gh-proxy 文件→三态端到端链。
- app-iced `app/update/settings/download_tests.rs`：假后端闭环 ×4 + **真 `CoreHost` 端到端**
  （点 16 ⇒ 磁盘上 `launcher.json` 真的有 16）。
- `pages/settings/tests/download_section.rs`：`body.is_none()` 绊线翻成 `is_some()` +
  控件形状 / 空快照不编值。
 2026-11-09 10:51:16 +08:00
AskaEth aae9a233ff fix(m198): JAVAGUARD——首屏自动扫 / 子进程回收 / 参数长度三条守卫 + 设置页正文结构断言 
- 首屏自动扫：删掉 `cfg!(test)` 分叉，生产入口在测试里真跑；新增
  `the_first_hydrate_starts_a_real_scan_by_itself`（删掉那一行、或把实参翻成 `true`
  都红）。顺手删掉恒为假的 `seeded && !live`：截图种子档在上方就 return 了，编译器也
  报 "assigned but never used"。
- proc：`kill()` + `wait()` 收进 `terminate()`（三个分支共用）；用例先用同一条命令
  真跑一次证明子进程起得来（`spawn().ok()?` 的空跑假绿），并新增 Linux/Android 的
  僵尸回收用例（只 kill 不 wait ⇒ `/proc/<pid>` 留成僵尸）。
- java.extra_args：`MAX_JVM_ARGS = 1024` 镜像 schema，`Refusal::JvmTooLong` + 中英
  文案 + JVM 输入框变红；App 级用例断言回执是具名的「太长」而不是通用的「写不进去」。
- 设置页正文：判据①从「数 `stack = stack.push(` 的出现次数」升级成按角色断言
  （唯一来源 section_columns、`push(` 恰一次且实参是循环变量、尾表达式、禁
  extend/chain/once/concat/append），单行折叠变异体现在会红。
 2026-11-09 06:46:29 +08:00
AskaEth 6e80fd3563 merge: origin/dev（1623f68）合入 M197 分支——解 golden/tail.rs 冲突 
基线：合的是 **origin/dev**（`1623f68`）。`origin/main` 是 D41 的孤儿发布快照
（`d616d65` parents 为空），不参与合并。用 merge 而不是 rebase，保住三轮复审 clean 的 tip。

冲突只有一个：`crates/i18n/src/catalog/golden/tail.rs`（热点文件，多条 mission 都往这里加 key）。

解法（不重排别人的行、不改别人的译文）：
1. 以 **dev 侧 398 行**为底稿（含其它 mission 后加的 key）；
2. 把 M197 的 68 行（`SettingsJavaTooNew` … `SettingsJavaReasonInstallRootTooLong`）
   整块插在 `SettingsJavaReasonWriteFailed` 之后、M174 助手域（`SettingsGroupAssistant`）之前
   —— 即 `settings_java_entries` 那段之后，装配链的正确位置；
3. 两侧合起来 463 行会越过 400 行硬线，于是按既有先例把**M174 助手域起的那半截**
   （dev 的 260 行）整段纯搬移到 `golden/tail_ai.rs`：`tail.rs` 211 行 / `tail_ai.rs` 274 行，
   链序 `golden → tail → tail_ai → tail2` 不变，逐字节不删不改；
4. 解冲突时发现 dev 的 golden 行还是 M197 之前的旧文案（`SettingsJavaEmptyBody` /
   `SettingsJavaAddHint` 的反引号、`SettingsJavaNeverScannedBody` 的旧说法），已把这三条的
   金表行同步回域文件里的现行文案（`split_keeps_every_translation` 逐位置比对当场抓出来的）。

顺带（合并导致的越线）：`crates/core/src/download/engine.rs` 两侧各 400 行、合并后 401
（我 +1 行 `kind: err.kind`，dev +1 行），把模块文档里那三行散文重排成两行（一字未删）→ 400 行。
同一次还把这文件里对 `MirrorTable::set_gh_proxy` 的旧描述改成 M193 的现实（那两个函数已被删）。

验证：fmt 0 · check（app-iced+core+i18n all-targets）0 · i18n 36 · engine_mock 8 · app-iced java 45 ·
core lib java 71 · setting 116 · app-iced lib 全量 832；全仓 file-size 守门脚本复制执行 → 超限 0。
 2026-11-09 06:17:54 +08:00
worker-dlmsettings 94f56f9d9c fix(m193): 复审 r1 三条 P2——版本史还原、retry_limit 0 有诚实语义、装配点措辞更正 
- P2-2：keys.rs 的 schema 版本史按原文逐字还原（1.4.0/1.5.0 的键名、1.2.0 的迁移口径、
  旧读新的完整结论），不再用版本文档换行数；腾行改从我自己新加的注释里出。
- P2-1：download.retry_limit 范围恢复 0~10，并把 0 的语义定成「只试一次」（attempts = max(1, 0)）：
  老配置合法、零迁移、ull config get 读到的 0 与引擎真做的事一致（不再回落出厂 3）。
  schema 描述与 presenter/iced 两处 UI 都写清「0 与 1 都 = 只试一次，不代表不下载」。
- P2-3：shared.rs 的「唯一一处装配」更正为「presenter 侧唯一一处」（CLI 还有三处自建），
  docs 加「哪些路径吃这套设置」表，并立 finding（CLI install/java/pack 不读设置、并发 64→8）。
- P3-3：mirrors.rs 的 gh_proxies 注释改成「无生产读者，仅解析留档」。
- P3-4（presenter 侧）：并发/重试描述的出厂值与上限改用常量 format!，不再是第二处字面量。
- 出图重拍（含 0/1 = 只试一次）。
 2026-11-09 05:24:12 +08:00
worker-dlmsettings e8544b19a7 feat(m193): 下载并发/重试/gh-proxy 真接进引擎（schema 与引擎同源常量） 
- download.concurrency / download.retry_limit 以前引擎侧零消费者（恒用
  EngineConfig::default() 的 64，而 schema 说 8）。现在默认值与硬上限收成
  download/config.rs 的常量，schema、EngineConfig::default()、Semaphore 容量
  三处同源；宿主把三个键翻译成 DownloadTuning 后经 shared::set_tuning（按数据根）
  灌进装配点，改了设置下一次取引擎就生效。
- download.gh_proxy 三态（留空=跟随内置默认 / off=关 / 前缀=覆盖）下沉到
  shared::build，所有走共享引擎的下载路径（内容库/版本清单/字体/安装）一致。
- 删掉 MirrorTable::set_gh_proxy 与 default_gh_proxy 两个改了没用的入口。
- 下载设置页把三条假演示值换成说语义的中文行（含三态说明与 1~64 硬上限）。
- 守卫：探针读 Semaphore 真实许可数（不是读配置），每条配变异证明。
- docs/download-settings.md 记下取证表（另四个键仍零消费，已立 finding）。
 2026-11-09 05:24:11 +08:00
AskaEth fb0b1a5311 merge(dev): 解 M196 与 dev（M179/M193）在 settings/mod.rs 的冲突 
`origin/main` 是 D41 的孤儿快照（单提交、与开发史无共同祖先），M179/M193 这些提交在
`origin/dev` 上；按「跟上主线」的意图合的是 `origin/dev`。用 merge 不用 rebase：复审 clean 的
tip `e5a4b9b` 原样保留，本提交只负责解冲突。

唯一冲突：`settings/mod.rs` 里 `form` 的文档注释（M179 与 M195 重写过同一段）。两边都留：
- **M179/M193**：`type Body` 带 `Lang`、四条按下标分发（General / Update / Assistant / Java）、
  M193 的 download / logs 接线及其文档更新——只有一处措辞随之调整：「四组在下面各有 `else if`」
  → 「在 [`section_columns`] 里各有 `else if`」，因为 M195 把那层循环抽成了独立函数；
- **M195**：循环之后不再 push 那张「没有逐实例覆盖」的空态卡、`overrides_empty` 不存在、
  `section_columns` 与其行为断言（`frame.rs` 两条用例）。
合并后的注释同时说明两件事：`GROUP.body` 从形参拿生效语言（M179）+ 尾部不许再挂东西、
逐实例覆盖的真控件在实例详情页（M195）。

为守住 400 行硬线（冲突态 424 → 399），只压自己的重复叙述：M196 段压到 4 行、
`section_columns` 的文档改为指向 `form`（它原来重复了一遍分发点，且在 M179 之后已不准确）、
模块文档里一段被 M179 实现取代的历史「r3 订正」压成一句可执行的结论。

代码零语义改动（证据见汇报）：`section_columns` 的循环体与 `origin/dev` 归一化后逐字节相同（46 行），
`GROUPS` / `GROUP_LABELS` 三方一致；相对 `origin/dev` 的差异只剩本 mission 的 4 个文件。
 2026-11-09 05:18:29 +08:00
AskaEth 59011b2d56 fix(m195): 复审 r3 —— 失败不再被说成「取消太晚」，并给三档补推导用例 
P2-1（界面撒谎）：`cancel_view` 的 `_ if cancel_requested => TooLate` 把 `Failed` 也吞进去了。
「点取消的同时摘要不符」这类失败（取消置位之后、下一个检查点之前的非容忍失败）会得到
`status=Failed cancel=TooLate rolled_back=true`，于是同一屏上红卡说「已回滚 —— 目标目录零残留」，
下面还有一句「取消来得太晚：这次导入已经跑完，实例会保留，同名文件可能已被覆盖」——后半句是假的，
而且与红卡直接对立。改成**只有** `Success | Partial + cancel_requested` 才判 `TooLate`；
`Failed` 一律 `NotRequested`（失败卡自己用 `failure_stage` 分「没写过 / 回滚干净 / 回滚没做完」，
真相已经说全）。
另外 app-iced 的 `cancel_note` 加一道双保险：只有 `status` 是 `Success/Partial` 时才出那句话，
推导万一回归也不会贴到红卡上。

P2-2（推导零覆盖）：此前只有「给定这一档、文案怎么画」的用例，把 `RollbackIncomplete` 的推导
删掉也全绿。现在 `convert/cancel.rs` 带三条推导用例：`Cancelled + !rolled_back ⇒ 回滚没做完`
（含对照 `rolled_back ⇒ 已回滚`）、`Failed + 取消 ⇒ NotRequested`（含对照 `Success/Partial ⇒ TooLate`）、
没点过取消 ⇒ `NotRequested`。

变异实测：
- P2-1：把 `Failed` 也判 `TooLate` ⇒ `a_failed_run_is_never_dressed_up_as_a_late_cancel` 红
  （`left: TooLate / right: NotRequested`，"失败的导入没有「跑完」这一说"）。
- P2-2：删掉「回滚没做完」的推导（`Cancelled` 一律按已回滚）⇒ `an_incomplete_rollback_is_its_own_bucket` 红
  （`left: RolledBack / right: RollbackIncomplete`）。

验证：`cargo test -p unlucky-core -p unlucky-presenter -p unlucky-app-iced` = 2188 passed / 0 failed；
`-p unlucky-i18n` = 31 / 0；clippy 四 crate = 0 warning / 0 error。
 2026-11-09 05:06:56 +08:00
AskaEth b1524635ba fix(m195): 复审 r2 —— 取消的真实结局必须到达界面（三档 + 终态穿透代次） 
复审 r2 P2-1：界面无条件断言「已停手并回滚：没有留下半包，也没有覆盖已有文件」，而两条路径下
这句话是假的——①取消来得太晚（落在最后一个检查点之后）时管线已经跑完，用户的同名文件被覆盖、
实例已登记；②回滚本身没做完（`rolled_back=false`）。core 一直是诚实的，是 presenter 把报告丢了：
`cancel.load()` 早退 + `cancel_pack` bump 代次后 `handle` 按代次丢弃。

按"接通真相"做（不是改软话）：

- **终态一定发出**：`import::run` 去掉 `cancel` 的无条件早退，收尾抽成 `finish`（清自建空目录 +
  无条件 `send(PackEvent::Report)`）；取消标记在管线返回后**再读一次**，作为"太晚"的唯一证据。
- **终态穿透代次**：`HostPackState::terminal_epochs` 记下 `cancel_pack` 作废的那个代次，
  `handle` 对它**只放行一条 `PackEvent::Report`**（进度事件照旧按代次丢，`fresh_cancel` 起新
  一轮时清空）。这是路径 A 的成因与修法。
- **DTO 三档**（tower 批准扩 scope）：`ImportStatusView` 加 `Cancelled`；新增
  `ImportCancelView { NotRequested, RolledBack, RollbackIncomplete, TooLate }` 挂在
  `ImportReportView::cancel` 上——已回滚 / 回滚没做完 / 取消太晚，三档各自可判。
  `PackEvent::Report` 到达时清掉 `ImportState.cancelled`（它现在只是"取消后还没有结果"的占位）。
- **界面按结局分支**：标题 `PackStatusCancelled`（已取消 — 已回滚）/ `PackCancelIncomplete`
  （已取消 — 回滚没做完）/ 取消太晚时保留真实状态标题并另起一句 `PackCancelTooLate`
  （实例会保留、同名文件可能已被覆盖）；占位的 `PackCancelled` 改成"正在停手，真实结果随后给出"。
  图标：`Close`（描边，页面对填充字形有守门）/ 回滚不完整用 `Warn`，一档都不用 `Role::Error`。

守门与变异：
- 新增路径 A 用例 `a_late_cancel_still_delivers_the_real_outcome_to_the_ui`：真管线把取消置在
  **最后一条 Commit 进度**上（之后没有检查点）⇒ core 报 `Success`/未回滚、用户的 `mods/a.jar`
  确实被覆盖；再 `cancel_pack`（代次 +1 并记终态）→ `finish` → `handle`，断言界面收到
  `status == Success` + `rolled_back == false` + `cancel == TooLate`，且同代次的进度事件仍被丢。
- 变异①：`handle` 恢复"代次不符一律丢" ⇒ 该用例红（"取消太晚时，真实结果必须到达界面"）。
- 变异②：`finish` 恢复"取消就早退" ⇒ 该用例红（另带 P2-2 那条也红）。
- app-iced 新增 `model/tests/cancel.rs`：三档标题互不相同 + 「太晚」必须有那句补充说明 +
  已回滚不许显示成「部分成功」。

验证（CARGO_TARGET_DIR=C:/Temp/ull-target/wt-194）：
`cargo test -p unlucky-core -p unlucky-presenter -p unlucky-app-iced` = 2185 passed / 0 failed；
`-p unlucky-i18n` = 31 / 0；clippy 四 crate = 0 warning / 0 error。
 2026-11-09 05:06:55 +08:00
AskaEth db5b08b9ab fix(m195): 复审 r1 三项 —— 解压检查点真守卫、presenter 接线测试、取消文案改回真话 
P2-1（解压循环检查点没有真守卫）：那条用例原来的断言（status/target/files/bytes/无残留暂存）
在删掉 `extract_overrides` 的检查点后**依然成立**——提交前检查点⑤会替它停一次，于是几 GB 的包
会一直解到结束而测试全绿。改成数 `ImportStage::Extract` 事件：有检查点 = 1 条、删掉 = 3 条
（两面实测）。模块文档同时如实登记"还没有真守卫"的检查点：②③④⑤、全新导入 commit 的取消
分支、phase.rs 远端下载逐条、complete.rs 补全循环的 break。

P2-2（presenter 的真令牌接线零测试）：新增 `pack/tests/cancel.rs`，直接调 `import::run` 并把
传入的 `Arc<AtomicBool>` **预先置 true**，判据只能是盘上事实（目标目录不存在 + profiles.json
零实例）——"没收到 Report"那种判据两条路都成立，`run` 早退条件里的 `cancel.load()` 会把
"没接线"完全遮住。

P2-3（用户可见文案说反了话）：`PackCancelled` 中英双语从「导入会在后台继续跑完 / Import keeps
running in the background…已经写下的文件会留下」改为「导入已取消 —— 后台已停手并回滚：没有留下
半包，也没有覆盖已有文件」；golden 金表同步；`model/tests.rs` 那条把旧文案钉死的用例改成钉新
语义（必须说清停手+回滚，且**禁止**出现 background）；`model.rs` 的 `cancelled` 字段文档与
`dispatch.rs` 的取消注释同族修正。

验证：`cargo test -p unlucky-core -p unlucky-presenter` 1480 passed / 0 failed；
i18n 31 / 0；app-iced packui 28 / 0；三 crate clippy 零 warning。
 2026-11-09 05:06:53 +08:00
AskaEth 26e7b7333e fix(content): 不兼容档在失败路径上取项目名 + 重试轮不再贴错根的标题 (M191 r2) 
复审 r2 两条 p2，都修了，并按复审给的口径验过红。

**P2-1（续）：不兼容档不再只有裸 id**
`FailureKind::Incompatible` 的项目**确实存在**（站点只是没有匹配目标版本/加载器的条目），
所以失败路径上值得现取一次名字——`plan::names_for_incompatible` 按失败项去重、一项一次 GET
（`Modrinth::project`），`fetch_title` 把任何失败都折成 `None`：
**拿名字失败不许影响安装结果**，取不到 / 拿到空标题就退回 id。只有这一档发请求；
「取不到」档 404 那部分项目根本不存在，再发一次只会再吃 404。

**P2-2（新）：重试轮把根的标题贴到了前置头上**
根因是判「这条是不是根项目自己失败」用了 `plan.request.roots.first()`，而重试那一轮的 plan
来自 `retry_request()`，它的 `roots` 就是上一轮的失败名单——第一个是前置。
现在判据改成 **id 比对**（`Root{id,title}`，id 由 `remember` 一起记下来）：
`label_of` 只在这条失败的 id 真的等于原始根 id 时才用根的标题。复审给的那个形状
（roots=["P7dR8mSH","1eAoo2KR"] + root_title="Sodium"）现在画 `P7dR8mSH`，不再是
`Sodium (P7dR8mSH)`。

**守门（每条都真跑红过，且在拆完模块的最终代码上复跑）**
- 去掉不兼容档的名字来源 ⇒ `an_incompatible_item_shows_the_project_name_once_it_is_known` 红
  （`left: "P7dR8mSH"` / `right: "Entity Culling (P7dR8mSH)"`）。
- `label_of` 换回 `roots.first()` ⇒ `the_retry_round_does_not_paste_the_root_title_onto_a_dependency` 红
  （`left: ["Sodium (P7dR8mSH)","1eAoo2KR"]`，正是复审实测的那一行）。
- 取名字不降级（`expect`）⇒ `a_failed_name_lookup_falls_back_to_the_id_without_breaking_anything` 红。

**行数**：`plan.rs` 加完这套到 414 行、`install.rs` 到 403 行，都越过 400 硬线 ⇒
把「名字从哪来」整块（`Root`/`Names`/`names_for_incompatible`/`label_of`/`fetch_title`）
纯搬移到 `plan/labels.rs`（111 行）：`plan.rs` 336、`install.rs` 388。
 2026-11-09 05:06:06 +08:00
AskaEth 961ff453a0 fix(content): 重试面板画可读名，不再只有站点 id (M191 r1 P2-1) 
复审 P2-1：面板原来只画 `P7dR8mSH` 这种项目键，用户拿到的是一串哈希。
可读名其实都在手边，只是没进 DTO——现在补上，按复审给的**最小修法**做，没扩散：

- `InstallFailureView` 加 `label: String`（**语言中立**：站点标题或文件名），
  配 `line()` 统一决定「名字 (id)」还是「只有 id」（名字为空时不编造）。
  `detail`（core 中文散文）**依旧不进界面**——那会踩 i18n R2。
- `plan::label_of` 三个来源，零额外请求：
  根项目 → 请求里的 `title`；计划里有节点（下载失败）→ `node.file.filename`；
  都没有（解析 404 / 不兼容的前置）→ 空，界面退回只画 id（复审认这条兜底）。
- 计划被记住时连显示名一起记（`plan::remember` 多一个 `title`），于是重试那一轮
  面板头与失败名单沿用的是同一个名字（顺手收掉复审 N5 的「重试时面板头显示 id」）。
- N2：删掉新加的 `ContentInstallDismiss`，复用既有的 `DownloadDismiss`（同一句话不立两条 key）。
- 行数/clippy：`collect` 的参数捆成 `Placement{dir,title}`（9 个参数超限）；
  `plan.rs` 加完 `label_of` 到 429 行，把「记住的计划」表纯搬移到 `plan/remembered.rs`（363 + 82）。

守门（真跑红再还原）：
- 把 `label_of` 置空 ⇒ `the_retry_list_shows_a_readable_name_not_just_the_project_id` 红
  （三行全变成 `["AANobbMI","P7dR8mSH","1eAoo2KR"]`）；
- 审阅指出的另一半判据也补上了：`Done` + 残留名单 ⇒ 必须不画；现在**只去掉**
  `stage != Failed` 那一半就红（之前只去掉它仍是全绿，报告的表述不准，已改）。
 2026-11-09 05:06:05 +08:00
AskaEth 5a52f38f35 feat(content): 安装失败的两档分组与「只重试这些」(M191) 
M186 把「可只重试失败项」算到了 core/presenter（DependencyPlan::retry_request()），
但 DTO 没字段、界面没按钮，用户拿不到。这一轮补最后一公里：

- DTO：ContentFailureKind 加 Incompatible 一档（不再借 Unsupported，与「缺密钥」分开）；
  InstallProgressView 加 retry: Vec<InstallFailureView>（project + 档位 + core 原话），
  档位是专门的 InstallFailureKind（Incompatible / Unreachable，穷尽映射 core 的 FailureKind）；
  ContentInstallRequest 加 retry: bool（重试路径唯一读的字段是 instance）。
- presenter：plan.rs 把上一轮失败的计划按 host+实例记住（与 addon/pack.rs 同一手法，
  host/mod.rs 不在 scope）；retry_request()/retry_plan() 就是「只重试这些」——
  调 core 的 retry_request()、只请求失败的那几个项目，present 重新扫目录。
  install.rs 的重试入口没有记录时回一条失败，不退化成整单重装；成功则 forget + 清名单。
- 界面：内容库页插入按档分组的失败面板（两段文案、各自条目）+「只重试这 N 个」实心按钮；
  判据只有一条且在模型里（stage==Failed && 名单非空），全成功时连同按钮一起不渲染。
- i18n：新增 6 条中英文案（不兼容 / 取不到 / 只重试这 N 个 / 标题 / 提示 / 关闭），金表同步。

守门（每条都做过变异验证，见报告）：
① 把 retry_request() 换成根项目请求 ⇒ retrying_asks_for_the_failed_projects_only 红（roots 变 ["sodium"]）；
② 两档合并 ⇒ the_retry_list_keeps_the_two_tiers_apart / the_two_tiers_are_two_groups_with_two_labels 红；
③ 恒渲染 ⇒ a_fully_successful_install_has_no_retry_surface_at_all 红。

数据包（datapack）本轮仍未做：ContentKind 没有这一项，界面上也没有半成品入口。
 2026-11-09 05:06:04 +08:00
AskaEth 93bd704786 fix(m192): r1 复审 P1-1——动效起跑搬进 update 侧 + 帧基准兜底 + 按运行时顺序的守卫 
复审的机制三步全部复核成立（iced_winit-0.14.1 `src/lib.rs:1222` 调 update、`1338` 在
`update()` 内部求值订阅表、`1233` 之后才 `build_user_interfaces` 调 view）。第一版把
「标识变了 → play」写在 `pages::render`（= view）里，于是：同一拍的订阅表看不见轨道 ⇒
`frames()` 要等下一条消息才打开；而那一帧的 dt 是整段空闲时长 ⇒ 轨道被当场判到期删掉。
用户看到的是「一帧 12/8px 偏移 + 闪跳」，比硬切更差；截图通道因为 `has_screenshot()` 恒真，
结构上不可能发现它。

修法（三件都做）
- **起跑搬进 update**：新增 `app/update/motion_sync.rs::App::sync_motion`，在 `App::update`
  收尾（`route_message` 之后、`subscription()` 之前）按**路由**算内容标识并 `motion::observe`。
  `pages::render` 只留 `motion::sample()`（纯采样）。
  顺带：`screen == None`（账户页 / AI 独立页）只记标识不起跑，于是「从它们回到某一屏」也跑换页。
- **帧基准兜底**：`observe` 起跑成功时把 `LAST_FRAME` 重置到「现在」；`Pump::advance` 再加一道
  `MAX_STEP_MS`（4 帧 = 64 ms）单次步进上限——掉帧/挂起时宁可把动画放慢，也不许一帧抹掉。
- **没有窗口就不起跑**：`window.is_none()` 且不是截图通道时 `sync_motion` 直接返回（也**不记**
  标识）⇒「首屏入场」等窗口到了才算第一眼，启动期那棵空树吃不掉它（原先被 1 Hz 心跳 /
  既有 `an_idle_app_...` 用例照出来的就是这个边界）。
- `on_heartbeat` 也推进动效时间轴：窗口被遮挡/最小化/合成器不送绘制时，帧一个都不来，而
  「有轨道」会让 1 Hz 推进整段停摆 ⇒ 轨道靠心跳按单次上限收尾（最坏 5 拍内自然退订）。

守卫（新增 5 条，全部按运行时顺序写）
- `a_state_change_opens_the_frame_subscription_in_the_same_tick`：**先** `assert!(!needs_frames)`
  →**一条真消息**（`Message::Page(Navigate(..))`）→ `assert!(needs_frames)`，并断言
  `watch_until` 仍是 `None`（排除「观察窗顺手开帧」这条假绿）。r1 那条顺序是反的，已删。
- `opening_a_detail_also_opens_the_frames_in_the_same_tick`、`pages_that_render_elsewhere_do_not_start_a_track`、
  `without_a_window_nothing_animates`、`a_stale_baseline_cannot_kill_the_track_in_one_sample`。

r1 两条 P2
- P2-1：`pump::FRAME_MS` 与 `mod.rs` 契约表补写「16 ms 只卡采样/布局推进，**整窗重绘跟随渲染器**
  （软件渲染 ≈970 帧/秒、一次 300 ms 换页 ≈290 次整窗重绘 ≈0.30 核·秒；GPU 档 AutoVsync 40~60）」。
- P2-2：删掉 `app/subscription/tests.rs`，测试并回 `app/subscription.rs` 的 `mod tests` ⇒ 本轮
  动过的文件全部落在声明 scope 内（新文件只有 `app/update/motion_sync.rs`，在 `app/update/**` 下）。

真机证据（GPU 档，`ULL_TICK_TRACE=1`，空闲 14 s 后由心跳触发一次**真实**导航，
`DevDocs/artifacts/m192/idle-click-evidence-gpu-final.log`）：
  idle: frames=96 clock=idle-1hz motion=14（连续 7 拍不动）
  fire: clock=frames motion=16 → 17（同一拍订阅表就开了）
  end : frames=102 clock=idle-1hz motion=20（自己退订）
说明：本机会话没有前台窗口（`GetForegroundWindow()==0`），合成点击（`mouse_event` 与
`PostMessage(WM_LBUTTONDOWN)`）递不进 iced 的输入层，故用「心跳第 N 秒真导航」这条同构路径；
样本次数由**绘制送达**决定（该次动效只收到 ~5 次绘制 ⇒ +6 次采样），正常可见窗口下 60 Hz 呈现
对应 ~19 次。

变异证明 7/7 红（`DevDocs/artifacts/m192/mutate.sh`，含新增 M6「删掉 sync_motion」与
M7「去掉单次步进上限」），还原后自检全绿。

编译：cargo test -p unlucky-app-iced → 0（797 passed / 2 ignored，集成 6 passed）；
clippy --all-targets -D warnings → 0；fmt --check → 0；build → 0。
出图基线复验：三张 rest 基线与九张序列帧的 sha256 与 r1 **逐字节相同**（常驻的那层 container 零内距）。
 2026-11-09 04:52:40 +08:00
AskaEth a1876a08c0 feat(m192): 动效帧泵——design motion 令牌接进 iced 的有界帧订阅 + 首批 3 条入场动效 
令牌早就在 `crates/design/src/motion/` 里齐着（16 档时长 / 可采样缓动 / 弹簧二维表 /
MotionScale 降级），但适配层从没消费过，所以一切状态变化都是硬切。本次补的正是那条中间层：

新增 `components/motion/`（时间轴，不是控件家族）
- `pump.rs`：`Slot`（boot/screen/detail 三个互斥触发点）× `Spec`（时长档 × 缓动档，
  **唯一一张表**，页面拿不到「给我 250ms」这种口子，D31）→ 进度采样；时间轴按 16ms 结算
  （≈60 次/秒），到期轨道**当场删除**。
- `mod.rs`：进程内单时间轴（thread-local；iced 在事件循环线程上串行调 update/view，
  与 `App::update(&mut self)` 同一条纪律，测试也因此天然隔离）+ `enter`/`shifted` 两个页面入口。
- **默认 NONE**：只有产品 `on_boot` 按档位打开；`pages_demo` 这类截图 harness 从不打开。

接线（都接在既有那条链上，不另开循环）
- `App::needs_frames` 多一条「有轨道」分支 → 与截图 / Busy / toast / watch_until 共享**同一个布尔**，
  `window::frames()` 在源码里仍只有一处（守卫：双订阅就红）。
- `on_frame` 每帧推进时间轴；`on_heartbeat` 不变（有帧时不推进）。
- 定档策略集中在 `update/boot_env.rs::motion_scale`：截图档 NONE（D30 出图可复现）、
  CPU 渲染档 HALF、GPU 档 STANDARD，`ULL_MOTION` 可强制。

首批 3 条动效（`pages::render` 一个漏斗，静息恒为 (0,0) ⇒ 既有截图基线一张都不用重出）
- 首屏进入 16px / 换页 12px（纵向） / 列表↔详情 8px（横向）；
  时长 400/300/350ms 全部取自 `DurationToken`，曲线 `Easing::Standard`
  （`EmphasizedDecelerate` 把 75% 位移压在 51ms 内走完，12px 的整页平移会像跳一格）。

守卫与取证
- 11 条帧泵算术守卫 + 4 条接线守卫（含「NONE 档帧采样次数必须为 0」与「帧订阅源码只出现一处」）；
- 5 条变异证明全部复现（删退订 / 删 NONE 短路 / 删 needs_frames 分支 / 删 16ms 闸门 /
  加第二条帧订阅 ⇒ 对应用例红）；
- 多帧序列图 12 张在 `DevDocs/artifacts/m192/`（t=0 / 半程 / 末 + 静息基线，
  `--diff --diff-scan` 实测换页 12px/6px、详情 8px）；
- 空闲实证：`ULL_TICK_TRACE=1` 跑真窗口，帧订阅窗口一过 `clock=idle-1hz` 且 `frames=` 冻结。
 2026-11-09 03:56:19 +08:00
AskaEth 44a0c87a11 style: cargo fmt --all（合并期整合修复）
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
Dev Guards / fmt (rustfmt --check) (push) Canceled after 0s
Details
Dev Guards / clippy (ubuntu) (push) Canceled after 0s
Details 
M187/M188 并入后全仓 fmt --check 为红（CI 的 fmt job 会红）。
本次仅 cargo fmt --all 的换行/缩进变化，无语义改动；
cargo fmt --check 与 cargo check 均已复验为绿。
 2026-11-09 01:43:31 +08:00
worker-logplace 5fd5cd47dc feat(m188): launcher.log 早落盘 + 会话日志搬到 logs/game（旧家只读兼容） 
用户投诉原话：「我们的启动日志放在哪？…他找半天没找到崩溃日志」「只有一个安装日志」。

启动器运行日志（.ULL/logs/launcher.log）
- presenter 构造 HostEnv 时就登记日志目录：启动早期缓冲的 200 行（[probe]/[font]/[theme]）
  当场刷盘，不再是「只有开过一局游戏才有日志」。
- app/** 里所有 eprintln! 诊断改走 app::diag::diag!（stderr + 文件双写，行首 [tag] 即 scope），
  含 boot/boot::fallback/state/update 各线。
- boot 那一拍补一行后端事实（request/effective/fallback）。
- 滚动上限（1 MiB → launcher.1.log，只留一份）写进 README 与 docs/logs-location.md。

会话日志搬家：data/agent/sessions → logs
- LauncherLayout: sessions_root()/game_logs() 新增，agent_sessions() 降级为只读兼容。
- host/logs 与 cli/commands/sessions 两个根合并（同 id 新根优先），event_path 回落旧家。
- 不搬不删；日志目录写一份 session-log-location.json 记录（moved=0, policy=read-only-compat）。

入口与文案
- 设置页「通用」新增「日志文件夹」行：路径 + 打开目录 + 复制路径（i18n 中英）。
- 日志页页头的「打开目录」不再是占位：走 M187 的 open_dir，失败文本带路径并送进剪贴板。
- README.md / README.zh-CN.md 新增「日志在哪」章节（含 crash-reports 只在游戏走到那一步才有），
  docs/logs-location.md 给出上限、双写判据、迁移策略与没验的部分。

守门（每条都有变异证明，见报告）
- 旧家会话仍列得出/打不开 ⇒ 只读新根变红；新会话写 logs/game ⇒ 只读旧根、写回旧家都变红。
- launcher.log 滚动 ⇒ 干掉 rename 变红。
- 打开日志文件夹指向真实目录 ⇒ 换成 cache/ 或去掉 create_dir_all 都变红。
- 日志根随三模式变化 ⇒ 把 HostEnv::logs_dir 写死成便携落点变红。
 2026-11-09 00:43:45 +08:00
AskaEth 7b79d5c397 chore(m197): 三处拆文件守 400 行硬线（复审 r1 后新增内容把三个文件顶过线） 
- `core/src/setting/keys.rs` 396（原 400 → 我的 +15 到 415）：`download.proxy_mode` /
  `proxy_url` / `gh_proxy` 三键搬进新 `keys/proxy.rs`（`specs()` + 一句「空串 ≠ 关」的守卫），
  主表留一行 `.with_all(proxy::specs())`——与 `font` / `update` 同一种形状。
- `core/tests/download/engine_mock_test.rs` 407 → 364：404 那条用例整条搬进
  `tests/download/engine_mock/not_found.rs`（`#[path]` 子模块，仍是 `engine_mock` 这个 target）。
- `pages/settings/java/downloads/tests.rs` 423 → 313：gh-proxy 两条守卫搬进
  `downloads/tests/gh_proxy.rs`（`#[path = "tests/gh_proxy.rs"]`）。

纯搬移 + 一条新单测（`keys/proxy.rs` 的「空串 = 跟随内置默认，不是关」）；行为不变。
 2026-11-08 21:42:15 +08:00
AskaEth 1d240ff1f2 fix(i18n): 复审 r1 —— 两句近义软件渲染说明合一，生效层级码翻成译文（M180） 
P2-1（一屏两句重复）：
- 留面板那一句（就在被禁用的滑块旁边，正好回答「为什么拖不动」），措辞同时点名面板与玻璃
- 删 `SettingsAppearanceSoftwareRendererNote`（catalog 一条 + 金表一行，两边同时删）
- 删 `bg_image.rs` 的 `backend_note` 渲染块与 `State::backend_note()`；state.rs 391 → 382 行

P2-2（配色：preset 的机器码）：
- `palette::level_key(code)` 把 `preset`/`wallpaper`/其余 映射到已有的三条档位 key，不新增平行词表
- `bg_image.rs` 用 `tr(PaletteLevel, {level})` 传译文，中文界面显示「配色：内置色卡」
- 补 `every_level_code_maps_to_its_own_sentence`：三个码值一一对应 + 三条译文互不相同

顺手（复审 L-1/L-2/L-4，全在本 scope 内）：
- `appearance_texts` 加「渲染后不许残留 `{`」断言（参数名写错当场红）
- `section/mod.rs` 文档：取词口 t/tr、填充措辞、清掉孤立 `//!`、把「没有一句英文」改成
  写明两处例外（`{reason}` 原文串、专名）
 2026-11-08 21:42:12 +08:00
AskaEth c4c3c15285 feat(i18n): 外观页 40 条文案进词表（M180 I18NAPPEAR） 
- 卡片内 22 处硬编码英文（整窗/面板透明度、背景图开关+路径、填充、暗化、配色来源）全部改走 Key
- 运行时诊断改成 key + 参数：`background::Note`（读盘/解码/过大/小图平铺）、`state::backend_note`、
  `palette::note` 全部返回 Key；`state.rs` 只留 key、不放文案表（390 → 391 行）
- 上限/下限常量走占位符 `{floor}` / `{max}` / `{limit}` / `{requested}`；`{:.2}` 在 Rust 侧格式化好
  再套模板（`Catalog::render` 只认 `{name}`）
- 新增 40 条 key（中英各一条），按装配链锚点插在 `SettingsAppearanceCornerSuspended` 之后，
  金表 `golden/tail.rs` 同位置插入 40 行（`rows() == len() == Key::ALL.len()`）
- 守卫三条：中文渲染全非 ASCII、卡片 key 全覆盖（改回写死英文即红）、外观 key 逐条真翻过
- probe 加第二条取证路（`record_rendered`），`take()` 签名不动（M179 的守卫在 scope 外）
 2026-11-08 21:42:11 +08:00
AskaEth a14b00aced fix(m197): 复审 r1 的 P1 + 三条 P2（描述对齐行为 / 内部编号下屏 / kind 守卫 / gh-proxy 可覆盖） 
P1（阻断）`java.auto_install` 的描述与行为不一致——那句会进 AI 工具的 JSON Schema
`description`，等于让助手对用户说一件实现刻意不做的事：
- `crates/core/src/setting/keys.rs`：改成「缺 Java 时在 Java 页标出推荐版本并可一键安装；
  不会自动下载」，去掉 `（D13 基准 JDK17）`。
- `SettingsJavaAutoInstallHint` 中英两侧各补一句显式否定（「不会自己开始下载 —— 点「安装」
  才会下」/ "Nothing is downloaded on its own — you press Install."），标签从「自动准备」改成
  「缺 JDK 时推荐一档」；金表同步。
- 新增守卫 `the_auto_install_description_says_it_never_downloads_by_itself`（描述必须含
  「不会自动下载」、不含旧说法与内部编号）。

P2-1 内部决策编号印在界面上：`SettingsJavaDownloadBaseline` 的 `Baseline (D13)` /
`基准版本（D13）` → `Recommended baseline` / `推荐基准版本`（金表同步）。另加两条目录级守卫
（`no_user_visible_string_mentions_an_internal_decision_id` /
`no_user_visible_string_carries_markdown_backticks`）；后者顺带清掉 M168 遗留的
`FontCjkStatusHint` 里的 `ui.font_cdn` 反引号——全仓最后一条。

P2-2 `ProgressEvent::SourceFailed.kind` 没有守卫：`engine_mock_test`
- `reports_progress_events_and_errors_when_all_sources_fail` 的解构补 `kind`，断言
  `ServerError`；
- 新增 `a_404_is_classified_as_not_found_and_never_cools_the_source_down`（404 → `NotFound`，
  与「源坏了」分开）。

P2-3 交付任务书那句「（默认值可改）」：新增 `download.gh_proxy`（空 = 跟随内置默认 /
`off` = 关 / 其它 = 覆盖前缀），`engine_with` 是它的真消费者（改 `RegionProfile`，因为
`gh_proxy_candidates` 读的就是档案里的前缀）；Java 页不画 UI（归 M193）。**内置默认值没动**。
schema minor 1.7.0 → 1.8.0（新键必须推 minor），三处硬编码 minor 的用例同步。

另：真下载用例改成 panic 也清理（复审顺带项 7④）；`downloads/refusal.rs` 的「四档」改「五档」。
 2026-11-08 21:35:13 +08:00
AskaEth ca92014b81 fix(m179): 复审 r2 —— 订正「Body 带 Lang 之后」残留的六处文档漂移 
P2-1：`settings/mod.rs:273`（`AI_GROUP`）还写着「`Group.body` 的签名里没有 `Lang`」，
而同一次提交在同一个文件把槽位改成了 `fn(&Ui, States, Lang)` 并在上方 `GENERAL_GROUP`
按新事实重写 —— 一个文件里两段互相矛盾的说明。本条按新事实重写（行数不变，仍是 389 行）。

一并订正 finding 里剩下的外域漂移（tower 已扩 scope）：
- `settings/ai_about.rs:8`（同一句假话的表格行，finding 没列到）与 `:14-16`
- `settings/general.rs:7-11`（槽位现在带 `Lang`，装不下的只剩**档位** `LangChoice`）
- `settings/general.rs:287`、`settings/update.rs:5`、`pages/mod.rs:271`、
  `settings/language_appearance.rs:20` 的 `pages/appearance/section.rs` 路径

措辞与复审建议的一处偏离（已在提交与报告里说明）：复审建议写「槽位给不了『测试连接』的
结论」，与实现不符——该结论在 `States.groups.ai_about` 里，槽位拿得到；AI 组仍按下标分发
的真实原因是**尚未迁移**（槽位要 `Option<Element>`，`ai::view::body` 返回 `Element`）。

零代码改动：本提交所有变更行都是以 `//!` / `///` 开头的文档行
（`git diff -U0 | grep '^[+-]' | grep -vE '^[+-]+\s*//[/!]'` 为空）。
按 tower 要求**不动** `crates/i18n/src/catalog/settings/appearance.rs:8`（M180 正在改）。

验证：cargo fmt --all --check → 0；cargo check -p unlucky-app-iced --all-targets → 0；
cargo clippy -p unlucky-app-iced --all-targets -D warnings → 0；
cargo test -p unlucky-app-iced --lib appearance → 0（37 passed）。
 2026-11-08 21:01:25 +08:00
AskaEth 9a7b138d08 chore(m197): 清掉 clippy 的三处拒绝 + 一处 2018 idioms 警告 
CI 的门禁是 `cargo clippy --workspace --all-targets -- -D warnings`：
冗余闭包 / 用例表的类型复杂度 / Default 之后逐字段赋值 / elided lifetime 四处都会红。
纯实现侧改动，行为不变（757 + 31 全绿）。
 2026-11-08 20:57:23 +08:00