AskaEth/Unlucky-Launcher
1
0 Fork 0
Code Issues Pull Requests Actions 4 Packages Projects Releases Wiki Activity
402 Commits 3 Branches 4 Tags
e090c67297490d3740b1aae528097a670a2ab140
Commit Graph
247 Commits
Author SHA1 Message Date
AskaEth e090c67297 feat(platform): 识别 Termux 宿主并把 $PREFIX/lib/jvm 纳入 JDK 扫描 
- 新增 platform::termux：用 TERMUX_VERSION / 默认 PREFIX 识别 Termux，
  推导 $PREFIX 与 $PREFIX/lib/jvm，不把路径写死进调用方
- java::discover 的 standard_roots 在 Unix 分支追加 Termux 的 JVM 根，
  环境可注入（standard_roots_in），补上「Termux 装了 openjdk 但没设
  JAVA_HOME/PATH 就发现不了」的盲点
- 单测覆盖识别、负例与扫描结果
 2026-11-07 09:33:18 +08:00
AskaEth be280c16a3 fix(core): ZIP64 第二道闸不再重复累计预检总量（复审 P2-1） 
复审在 tip 54c2d75 上实证的缺陷：`container()` 把 `preflight()` 返回的**全量**声明尺寸
当成写循环累加基数，循环里又对每个文件 `+= bytes.len()`，于是真实总量只要过半阈值
（~2.15 GiB）就被误拒，而且拒在内容读出来之后——"闸在内容进内存之前"的性质同时失效。

两处修：
1. 记账拆成独立类型 `Written`，**从清单 JSON 长度起算**，与预检返回值无关；预检的返回值
   现在只给测试与诊断看（`let _ =`，文档写明不许当基数）。
2. 内容改成 1 MiB 缓冲流式写进 zip（`COPY_CHUNK`），不再 `std::fs::read` 整份摊在内存里。
   第二道闸看的是"已写字节数"，与内存占用解耦；顺带把"拿预检 total 当基数"这类写法
   在内存侧也变成无害的小错而不是几个 GiB 的读。

测试（按塔台资源令，默认套件不再真写 2.5 GB）：
- `write.rs` 新增 `the_container_does_not_double_count_the_preflight_total`：把阈值注入成
  几十字节（`container`/`preflight`/`Written` 都收 `limit`，生产路径恒为
  `zip::ZIP64_BYTES_THR`），构造"正确实现 70 < 90 通过 / 重复累计 110 ≥ 90 被拒"的窗口，
  **0.01 秒**钉住 P2-1；实测把 bug 写回去即红。
- `write.rs` 新增 `the_second_gate_counts_from_the_manifest_length_not_the_preflight_total`：
  直接对 `Written` 断言 2.5 GB 不拒、撞阈值必拒。
- `zip64.rs` 的 2.5 GB 稀疏文件端到端用例保留但 `#[ignore]`（真跑要 ~70 秒 deflate 与一大片
  内存/页面文件，C 盘页面文件已被上一轮撑到 34.8G），实测过一次成功：条目声明尺寸原样
  2 500 000 000、产物只有几 MB。跑法写在该用例的文档里。

门禁：fmt 0 / clippy -p unlucky-core --all-targets 0 / cargo test -p unlucky-core 1033 passed
0 failed（lib 480 passed + 1 ignored）。
 2026-11-07 08:22:47 +08:00
AskaEth d728ed836f feat(core): M152 整合包收尾——同路径遮蔽逐文件上报 + ZIP64 拒写预检 
导入侧把「同名文件冲突」从整包一个策略推进到逐文件事实：同一实例路径被本包多份声明
命中时（跨侧 overrides/client-overrides，或同侧重复），按叠层顺序（Both → Client）定
胜者，其余标 PlanOverride::shadowed（winner / winner_dir / same_bytes），逐条留
pack.import.note.override_shadowed 注记；phase 只遍历未被遮蔽的条目，不再白读字节，
报告里也不再出现"两条 Installed、前一条的哈希其实没落地"。

不新增 FileAction/ConflictReason 变体：这三个枚举被 crates/presenter 的 convert.rs
穷尽 match，而那个 crate 不在本 purpose 的作用域内，所以走既有的 ImportIssue 通道
（与 server-overrides/ 被跳过同一条）。

导出侧那条 ZIP64 闸原来够不着：先 std::fs::read 整个覆盖文件进内存再累加判断，真要
导出 4 GiB 文件的实例，内存先炸、用户永远看不到那句 pack_limits。改成写前按
metadata().len() 做声明尺寸预检，超阈值在任何字节进内存之前就报；写循环里的增量检查
留作第二道。写 zip 的实现搬到 format/write.rs 以守 400 行。

测试：pack/tests/zip64.rs（稀疏文件真跑到 ZIP64 分支，含累计口径与对照）、
tests/import_layering.rs（同路径不同哈希 / 同哈希不同路径 / 叠层顺序 / 基线记胜者）、
unknown_fields.rs 补第 4 条假边（mrpack files[].extra + 未知哈希算法）。
五条变异各自变红（遮蔽 no-op 6 红、按哈希判重 6 红、翻转叠层 2 红、错误码改 io 3 红、
预检不累计则预检单测红且端到端用例从 0.01s 变成 95s/约 4.5 GiB 内存）。
 2026-11-07 08:22:47 +08:00
AskaEth 06fe12d811 chore(release): M154 版本升到 0.2.2（第一个稳定通道版本，D51） 
- 根 Cargo.toml `[workspace.package] version` 0.2.1 → 0.2.2；`crates/{agent,app-iced,cli,palette-extract,
  presenter}` 里 9 处 intra-workspace path 依赖的 version 约束一并对齐（M137 既定做法）。`crates/app` 是
  workspace `exclude` 的 Slint 退役树，manifest 不参与解析，原样保留。
- Cargo.lock 由 cargo 再生成：只有 8 个 `unlucky-*` 成员条目从 0.2.1 变 0.2.2，第三方依赖（含版本号恰好
  也是 0.2.1 的 hexf-parse / windows-link / windows-threading / xkeysym / yazi）一字未动。这一步不是可选：
  CI 与发布流水线全走 `--locked`（ci.yml:236,274 / release-build.yml:135,142 / make_artifacts.py:50），
  lock 不跟就是「tag 一打就红」。
- packaging 文档里的**示例 tag** 跟到 v0.2.2：docs/artifacts-and-version.md 两处（命名规则示例 + 「tag 说
  X、产物里写 Y」的事故示例）、docs/build-and-ci.md 三处（`--version v…`、两次 `gh workflow run --ref v…`）、
  docs/profiles-and-measurements.md 的「同一槽位现在叫 `unlucky-launcher_0.2.2_windows_x64.exe`」、
  make_manifest.py 四处（Usage 示例 / `normalize_version` docstring / `--version` 的 argparse help）。
- **历史注记一律不动**：docs/runtime-deps.md 的「v0.2.1 首次真跑即红在工具链体检」（M140 事故记录）、
  `.github/workflows/release.yml:71` 同一事故的另一处记录、`crates/core` 更新模块测试里的样本版本串
  （`checker_cases.rs` / `version_cases.rs`，是解析器测试夹具，不是发布事实）、`microsoft.rs:224` 的
  `21.0.13.0.2.1` 负例。
- README.md / README.zh-CN.md、packaging/release-notes.md 核实后**无需改动**：三份文件里没有任何写死的
  版本号——下载表是 `<version>` / `<版本>` 占位符（M153 刚统一的口径，含非发布档位标「暂未发布」的行，
  原样保留未回退），release-notes 正文是 `{{VERSION}}` / `{{SUMS}}` 模板占位符。

验证：`cargo check -p unlucky-cli --all-targets --locked` 过（编译日志里 unlucky-core/agent/cli 均报 v0.2.2）、
`cargo test -p unlucky-cli --lib --locked` 42 passed 0 failed、`cargo metadata --locked --offline` 过（全
workspace manifest + lock 一致）、`python3 packaging/make_manifest.py --self-test` ok、
`ull --version` 实跑输出 `ull 0.2.2（unlucky-cli）`。
 2026-11-07 08:13:29 +08:00
AskaEth f001b93942 feat(core): M150 新增 GitHub Releases 更新源（D50） 
D50 定案 GitHub Releases 为唯一更新源，清单地址固定为
`releases/latest/download/manifest.json`。此前 update 模块只有对拍用的
DirSource，这次把真实源补上。

- `update::github::GitHubReleaseSource` 实现 `UpdateSource`：清单从
  `<base>/<owner>/<repo>/releases/latest/download/manifest.json` 取，
  产物按 D49 命名规则（文件名）拼到同一条 latest/download 路径下；清单里
  已写完整 http(s) 地址的原样使用。
- 网络全走 `core::download`，不新造栈：包体交给引擎 `download()`（镜像展开
  → 地区判定 → 健康度排序 → 退避 → 续传 → 原子落盘），清单走引擎的
  `plan()` + 共享 client 逐候选取文本（与 `game::java` 的一锤子 GET 同一手法）。
  两条路径都吃到 mirrors.json 与地区档案里生效的 gh-proxy 前缀。
- 可配置面只有 owner/repo（默认 AskaEth/Unlucky-Launcher）与 base（默认
  https://github.com，测试指向本地假服务）；渠道只有 stable 有清单，
  beta/alpha/nightly 返回 Ok(None)（D50「先只发 stable」），清单 404 也算
  「还没发布」而不是错误。
- `UpdateErrorKind` 新增 `Network`：远端取字节失败（连不上/超时/5xx/候选全挂）
  与本地 IO 分开——前者可重试，后者重试无意义。引擎把逐源失败压成
  AllSourcesFailed，本源从失败摘要里还原「所有源都 404」为 SourceMissing
  （产物没上传不该被报成网络抖动）。
- 校验仍只有一处：包体请求只带 expected_size，长度/摘要双检留在
  `update::verify`（与 DirSource 同口径）。
- 单测 13 条，全程离线（假 HTTP 服务在 127.0.0.1）：固定清单地址、产物 URL
  解析、自定义 base/owner/repo、清单 404/非 JSON/字段非法/渠道不符/5xx 各自
  归到白名单分类、产物下载、产物 404 → SourceMissing、镜像优先下 gh-proxy
  前缀（清单与产物都验）、与 DirSource 同清单同产物选择结果一致。
 2026-11-07 08:06:22 +08:00
AskaEth 7946e5b804 docs(readme,cli,packaging): M153 清账四条被排忘的文档类 finding 
① README 两版下载表：linux-x64 / linux-arm64 / macos-arm64 / macos-x64 四行补「not yet published /
暂未发布」标记（与 M143 的 windows-arm64 行同款措辞），表后改成「本版只发布 windows-x64」的口径，
并说明发布 job 只留 PUBLISH_SLOTS 里的槽位（现住 release-publish.yml）；顺带把「produced by the CI
matrix」那句改成「矩阵里有、默认发布跑不编、all_slots=true 才编来取证」。

② packaging/make_artifacts.py 两处 docstring 还写 windows-arm64 是 cross-built：按 M140 后的原生
windows-11-arm 事实改写。（release-notes.md 的同一说法在 M139/M142 已改掉，本次核实无残留，未再动。）

③ cli 缺 id 的 hint：删掉「（id 不进仓库）」并改成与 cli/help.rs 一致的「官方构建已内置、环境变量优先、
自建时构建期注入」；Secret 透传的事实留在同处代码注释。

④ README 两版文件清单表：release.yml 从「six-slot build / 六槽位构建」改成「两个 Windows 槽位原生
构建 → 只发布 windows-x64；all_slots=true 才整表六槽位取证」。

纯文案，不动任何构建或运行时逻辑。
 2026-11-07 07:57:32 +08:00
AskaEth 5597a4cc18 feat(release,docs): M149 发布构建烘入微软登录 id（仓库 Secret），文档改为「官方构建开箱即用」 
构建侧：release-build.yml 声明 on.workflow_call.secrets.ULL_MSA_CLIENT_ID（required: false），
cargo build 步以 env 注入它，option_env! 把它烘进二进制；release.yml 的 build job 按名显式透传
（与 PUBLISH_TOKEN 同一模式，不用 inherit）。真值放仓库 Secret，不进任何 git 文件；Secret 未录入
或 Actions 之外求值为空串时，client_id.rs 的 blank_env_value_counts_as_missing 保证「空白=没配」，
不会拿空 id 去联网。

文档：README 两版 / help.rs 的 accounts topic / packaging/release-notes.md /
packaging/docs/build-and-ci.md 统一成「官方构建已内置登录所需配置、开箱即用，仍可用环境变量
ULL_MSA_CLIENT_ID 覆盖；自建想自带就构建时注入」的功能性口径 —— 不出现 id 本身，也不出现归属描述。
client_id.rs 的模块注释与测试注释同步（原文写「id 不进仓库（用户定案）」，已随 Secret 方案改写），
并记下「别把 ULL_MSA_CLIENT_ID 导出到跑 cargo test 的 shell」——presenter 的 M132 入口锚会在
已烘焙 id 的构建里故意红。

实测：ULL_MSA_CLIENT_ID=<id> cargo build --bin ull 后，清空 env 跑 ull accounts add msa 打出
用户码与链接（无「未配置」提示）；同二进制设一个假 env id 则 AADSTS700016 点名该假 id（env 覆盖生效）。
单测：core auth 28、unlucky-cli 全套、i18n 30、presenter 222 全绿；M132 锚在烘焙构建里按设计红、
在不带 id 的构建里绿。cargo fmt --all --check 通过。
 2026-11-06 21:08:53 +08:00
AskaEth 166342b021 fix(core,design): M147 修掉 test(ubuntu) 剩下的两条红（M144 被 fail-fast 挡住没看见） 
`cargo test --workspace --all-targets --no-fail-fast` 在 docker 里（Debian 12 / rustc 1.99.1）
第一次跑全：app-iced 那条修好后，还有两个 target 各有一条 **Linux 专有**的确定性失败——
M144 只看到第一条，因为 cargo 默认在第一个失败 target 就停。两条都是「夹具/断言按 Windows
语义写死」，不是产品逻辑错。

1. `unlucky-core`：`platform::wallpaper::windows::tests::current_theme_expands_local_app_data_env_var`
   （crates/core/src/platform/wallpaper/windows.rs:286，460 passed / 1 failed）
   夹具用了**混合分隔符**：`LOCAL_APP_DATA` 写 `C:/Users/u/AppData/Local`，而 `CUSTOM_THEME`
   写 `C:\Users\u\AppData\Local\…`。探针把 `%LOCALAPPDATA%` 展开后拼上 `\Microsoft\…`，得到
   `C:/Users/u/AppData/Local\Microsoft\…`；`FakeIo` 却按 `CUSTOM_THEME` 建键。Windows 的
   `Path` 把 `/` 与 `\` 都当分隔符 ⇒ 两个 PathBuf 相等；Linux 不 ⇒ 查不到文件 ⇒ 0 个候选。
   修法：`LOCAL_APP_DATA` 改成反斜杠原样（`r"C:\Users\u\AppData\Local"`），展开结果与
   `CUSTOM_THEME` 逐字节相同。测试仍能在 Linux 跑，不丢覆盖（不是加 cfg 门躲开）。

2. `unlucky-design`：`color::palettes::tests::accent_on_fixed_neutral_only_moves_the_neutral_hue`
   （crates/design/src/color/palettes.rs，162 passed / 1 failed）
   `assert_eq!(Palettes, Palettes)` 做 f64 位相等，而两侧算中性色相的路径不同：一侧取
   `NEUTRAL_HUE_DEG` 字面量，一侧经 `atan2()` 现算——glibc 与 UCRT 差 1 ulp
   （239.51420577630955 vs …964）。这正是 palettes.rs:361-365 那条注释自己警告过的坑。
   修法：把「固定中性色相」喂成**种子色相的实测值**（`per_seed.neutral.hue_deg()`），两侧同源
   ⇒ 断言保持**逐位相等**（比放宽容差更紧），零额外行。`NEUTRAL_HUE_DEG` 与种子色相的绑定仍由
   隔壁 `neutral_hue_is_the_default_seed_hue` 用 1e-9° 容差钉着。
   ⚠️ 这里没有照 tower 建议的「1e-9° 容差逐项比」：那个写法在 rustfmt 下要多 9 行，而本文件正好
   400 行、顶在 guards.yml 的红线上。改完 399 行（比改前还少 1 行）。

验证（命令与 ci.yml 逐字一致，容器 ull-linux-check:bookworm）：
- `cargo test --workspace --all-targets --no-fail-fast` → **exit 0**（原 exit 101，2 targets failed）
- `cargo clippy --workspace --all-targets -- -D warnings` → exit 0
- Windows：`cargo test -p unlucky-core --lib` → 464 passed / 0 failed；
  `cargo test -p unlucky-design --lib` → 163 passed / 0 failed（不回归）
 2026-11-06 20:19:03 +08:00
AskaEth 8bfabafe8a fix(app-iced): M147 修掉 Linux 侧 clippy 的 14 条错与写死平台的 α 断言 
两条红的成因都是「Windows-only 的东西没有平台门」：Linux + `--all-targets` + `-D warnings`
三件事凑齐时，Windows 专有的 DWM/穿透代码在 Linux 上变成未用导入 + 死代码。

clippy（14 条错，docker 内 exit 101 → 0）：
- dwm.rs `set_preference` 的 `#[cfg(not(windows))]` 分支以 `return` 结尾 ⇒ needless_return；
  那个块本来就是该 cfg 下函数体的尾巴，去掉 `return`。
- dwm.rs 三常量 + 四读函数在非 Windows 上没有使用者（唯一调用方 `probe::run_one` 的
  Windows 版被门着，`transparency.rs` 只 re-export 三项）⇒ dead_code。用**模块级**
  `#![cfg_attr(not(target_os = "windows"), allow(dead_code))]`：
  · 逐项 `cfg(target_os = "windows")` 会把它们从 Linux 构建里删掉，本文件那几条与平台
    无关的单测（属性号照 Win32 头文件、无效句柄不许表现成成功）就连编译都过不了；
  · 逐项 `cfg_attr` 要多 7 行，本文件 394 行 → 会顶破 guards.yml 的 400 行红线（现 398 行）。
  代价写明在文件头：非 Windows 上本模块的 dead_code 不再报。
- exstyle.rs `use super::raw_ex_style`：唯一使用者 `click_through` 自己按平台门着 ⇒ 补 cfg。
- probe.rs 的 `use super::dwm::{…}`：`CornerOutcome` 与平台无关（`ProbeRow` 字段 + 非 Windows
  的 `empty_row`），其余九个符号只服务于 Windows 的 `run_one` ⇒ 拆成两条 use。
- window_alpha.rs `use …RawWindowHandle`：只有 `RawWindowHandle::Win32` 那条臂用它 ⇒ 补 cfg。

test（docker 内 622 passed / 1 failed → 623 passed / 0 failed）：
`opaque_or_refused_alpha_never_touches_the_window_style` 里「无效句柄 ⇒ Failed」是按 Windows
语义写死的；非 Windows 走 `transparency::set_layered` 的空实现，如实返回 `Unsupported`。
按平台拆成两条断言（Windows 断 `Failed`，其它断 `Unsupported`），两边都不许表现成
`Applied`/`Opaque`。顺带说明：`dispatch` 的 `layered=false` 那半条断言与平台无关，保留在
两条之外照跑。

验证（本机 Windows + Docker Debian 12，命令与 ci.yml 逐字一致）：
- docker `cargo clippy --workspace --all-targets -- -D warnings` → exit 0
- docker `cargo test -p unlucky-app-iced --lib` → 623 passed / 0 failed
- Windows `cargo check -p unlucky-app-iced --all-targets` → 无 error/warning
- Windows `cargo test -p unlucky-app-iced --lib` → 624 passed / 0 failed / 2 ignored
 2026-11-06 20:06:56 +08:00
AskaEth 2e718af711 feat(core): 新增 update 模块，做与更新源无关的自更新内核 
更新源还没拍板，所以先把与源无关的那半边做掉：语义化版本比较、发布清单模型、
渠道准入、下载校验、原子替换 + 回滚。源抽象成 UpdateSource trait（清单 + 包体两个
方法），core 里没有任何 CDN 常量；内置的 DirSource 吃本地目录或 file://，既是测试
实现也是将来 HTTP 源的对照物。

取舍：
- 版本比较严格按 semver 2.0 §11：数值比（0.9 < 0.10）、预发布 < 同号正式版、
  预发布标识逐段比（alpha < beta < rc 是 ASCII 序的自然结果，不另立阶段权重表）、
  构建元数据不参与排序与相等。
- 渠道准入两道判据：清单自报渠道的阶梯比较 + 版本号里的预发布阶段。清单可能写错，
  版本号不会，所以正式版渠道即使拿到一份自称 stable 的 rc 也不会提示更新。
- 校验两道判据且顺序有意：先比长度（抓截断，不必读全文件）再比摘要（抓内容错），
  长度要求**恰好**相等；失败即删暂存文件。StagedPackage 只能由 stage() 产出，
  于是「未校验的包」在类型上就进不了安装路径。
- 替换跨平台统一成「旧文件改名挪开 → 新文件搬进来 → 失败把备份搬回去」：Windows 上
  覆盖运行中的 exe 不存在，改名是唯一可用动作，而改名也可能被不共享删除的句柄拒绝，
  所以失败必须能回滚。Unix 也照这个顺序跑，避免回滚路径只有 Windows 被真正跑过。
- core 零 UI 依赖不变：只有 serde/serde_json + 复用的 sha1/sha2，无新依赖，
  Cargo.toml 未改；不接 presenter、不接 UI。

单测 62 条（crates/core/src/update/tests/）：版本边界、清单校验、渠道准入、
摘要不符、包体截断（短了/多了）、无权限写目标目录、Windows 占用文件、回滚与备份清理。
 2026-11-06 19:16:15 +08:00
AskaEth 54b81cbb7f chore(release): M137 版本升到 0.2.1，发布只发两个 Windows 槽位 
版本：`[workspace.package] version` 0.2.0 → 0.2.1，并把全部 intra-workspace path
依赖的 version 约束一并对齐（`"0.2"` → `"0.2.1"`，M121 的教训）。Cargo.lock 里只有
8 个 unlucky-* 成员条目变化。`crates/app` 是 workspace `exclude` 的 Slint 退役树（manifest
连解析都过不了），不参与解析，故原样保留。

release.yml：新增 `PUBLISH_SLOTS` 白名单（唯一开关）＝ `windows-x64 windows-arm64`。
六槽位一律构建取证，release job 先按白名单裁掉 Linux/macOS 四档产物再重算 SHA256SUMS，
所以 tag 触发的 Release 只有 4 个资产 + SHA256SUMS.txt。release job 改成
`always() && !cancelled()`：未验证槽位构建失败不连坐 Windows 发布，真正的门禁是白名单
齐全性检查。将来某槽位真机验过后把它加进那一行即打开。

顺手修掉一处从未生效的门禁：齐全性检查的 glob 用的是连字符形态
（`dist/$prefix-*-$slot*`），对 D49 之后的下划线资产名永远匹配不上，改成
`dist/${prefix}_*_${stem}*`。资产命名规则 / SHA256SUMS / 合规文本并列资产 /
`--version` 与 tag 交叉校验一律未动。

packaging/release-notes.md：清掉 v0.1.0 / Slint 时代的说明，Downloads 与 Support matrix
只描述本版实际发布的 Windows 两个槽位（其余标「built by CI, not published」）。
packaging/README.md §1/§3/§9 同步 gate（矩阵加「本版发布」列、§3 写清白名单与打开办法）。
起手顺带把示例 tag 从 v0.2.0 更到 v0.2.1，并把「winit / femtovg」更正为「winit / wgpu」。
 2026-11-05 21:30:13 +08:00
AskaEth 119b49cf83 test(presenter): M132 烘焙了 client id 的构建里让入口锚直接红（r2 P2-1） 
r2 复审实测：`ULL_MSA_CLIENT_ID=fake-0000-test-id` 构建 + 同一处变异 → `ok. 22 passed`。
原因是我上一条写成了 `if is_configured() { assert!(CLIENT_ID_BUILD.is_some_and(..)); return; }`
——`remove_var` 之后 `is_configured()` 等价于 `CLIENT_ID_BUILD` 非空，随后的 `assert!` 判的是
同一条件的反面，恒真、无失败路径，于是锚在那种构建里**绿着失效**。这正是本 mission 要防的
「守门空跑」形态，而我报告里还把它写成了「只允许是这个原因」，与代码不符。

改成 `if let Some(source) = client_id_status().source() { panic!(..) }`：环境变量摘掉后仍
报告已配置，就带着 `source=` 和两条出路（不带 id 构建 / 给 `resolve_client_id` 加接缝）直接
红，逼人做决定。没有 `#[ignore]`、没有开关；正常的「两处都没有 id」构建照旧跑两条真登录流。

验证（贴原生输出）：
- 注入 id + 变异 → FAILED（panic，`source=Build`），旧代码此处是 `ok. 22 passed`；
- 注入 id + 无变异 → 也 FAILED（这才是重点：不是靠变异才红，而是拒绝空跑）；
- 无 id + 变异 → `220 passed; 1 failed`，红的正是这条锚；
- 无 id 正常 → `221 passed; 1 ignored`。
 2026-11-05 20:08:52 +08:00
AskaEth f2149048fb test(presenter): M132 把「缺 client id → 原因码」那行钉进测试（r1 P2-1） 
复审 r1 实测：把 `start_login` / `start_browser_login` 里的 `auth_failure(&error)` 改回
`LoginFailure::Other`，编译通过、884 条测试全绿——也就是说「缺 id 会变成 MsaNotConfigured」
这件事此前只有代码可读。这条正是本 mission 要防的回退，补一条能抓它的锚。

新锚 `a_missing_client_id_reaches_the_login_panel_as_a_config_gap` 不只测 `auth_failure`，
而是**真的起两条登录流**（设备码 + 授权码），从 `JobSender` 收到的第一条 `HostTask::Login`
上断言 `failure == MsaNotConfigured`，并断言原文（含 `ULL_MSA_CLIENT_ID`）仍只在 `message`
里、页面画不出来。零网络：`from_env` 在 id 判定处就地早退，事件立刻到，不需要任何桩。

环境变量是进程级的，所以照 core 的做法串行 + panic 也还原；构建期注入过 id 的构建里
（本仓库 CI/本地都不注入）显式断言「只能是这个原因」后返回，不是 ignore/开关。

测试模块从 `accounts.rs` 拆成 `host/accounts/tests.rs`（`#[cfg(test)] mod tests;`，先例
`dto/accounts.rs`、`host/install.rs`）：`accounts.rs` 400 → 299 行，拆完两边都远离 400 行硬线。
scope 已由塔台批准扩到 `crates/presenter/src/host/accounts/**`。

变异验证（最终代码上重跑）：
- 两处 `auth_failure(&error)` → `LoginFailure::Other`：`221 → 220 passed / 1 failed`（只有新锚红）；
- 还原：222 全绿。

顺手把 fn 指针数组换成一个 `assert_config_gap(name, start)` 辅助函数，
`cargo clippy -D warnings` 的 `type_complexity` 不放过它。
 2026-11-05 20:08:52 +08:00
AskaEth af39efd23b fix(presenter,app-iced,i18n): M132 缺 MSA client id 上屏成「未配置 + 怎么补」 
缺 client id 原来整条链路只给 `LoginFailure::Other`：界面画「Sign-in failed /
完整原因在启动器日志里 / Code: other」，用户得翻日志才知道要设 `ULL_MSA_CLIENT_ID`。

落点定在**账户页登录面板**，不是启动流程：这个失败只发生在 `microsoft_auth()`（两条
登录流的入口）；没配 id 的发布版建不出微软账户，`identity::resolve` 那条启动路径用户
撞不到（只有「有 id 的构建里登录过、之后 id 被摘掉」才可达）。

- presenter：新增 `LoginFailure::MsaNotConfigured`（`msa_not_configured`）。`microsoft_auth`
  改为回 `AuthResult`，`AuthError::Unsupported`（`from_env` 唯一的产出点，零网络）单独成码，
  其余失败照旧走 `classify`。诊断原文仍只进日志。
- i18n：账户域新增 `AccountLoginNotConfigured`（标题）/ `AccountFailureMsaNotConfigured`
  （正文：设 `ULL_MSA_CLIENT_ID=<id>` 或构建时注入，改完重启），golden 同步。
- app-iced：`failure_title_key` 给这一类专属标题；正文按码查表；这一类**不给「重试」**
  （进程内的环境变量改不了，重试必然是同一个错）。
- 测试：`a_missing_client_id_tells_the_user_what_to_configure` 断言 UI 模型里出现「未配置」
  + 变量名 + `<id>` 占位 + `msa_not_configured`，且没有那句「去翻日志」；反向锚
  `a_network_failure_does_not_look_like_a_missing_config` 与
  `only_a_missing_client_id_becomes_the_config_gap_code` 钉住别的失败不许跟着变。

为什么这一类可以上屏：上屏的是 catalog 固定文案（无凭据、无 token、无内部细节），
`DevicePanel::Failed` 里没有 `message`/`detail` 字段，原文在类型上就画不出来；
理由是它的原因本身就是用户的下一步。M117/M119 的「诊断不上屏」约定不动。
 2026-11-05 20:08:52 +08:00
AskaEth 321617861a chore(m135): 删掉死代码 launch::loader_label，修 M134 之后变假话的三处文档 
M134 复审点名、且都在它 scope 外的收尾。

- `presenter/src/host/launch.rs::loader_label` 删除：全仓零调用点（唯一提及是
  i18n 的一条注释），函数体逐字重复 `dto::LoaderKind::label()` 并硬编码「原版」——
  它既是第二份显示词表，又绕过 i18n；留着等于给下一个人示范「照这样写就行」。
  随之无用的 `LoaderKind` import 一并收掉。
- `presenter/src/lib.rs` 的 dead_code 豁免说明不再点名已删函数（否则那行注释指向
  一个不存在的符号）。
- `i18n/src/bridge.rs:65` 注释改指向唯一那份显示词表（`dto::LoaderKind::label()`）。
- `core/src/game/loader.rs` 与 `presenter/src/dto/instances.rs` 两处「显示路径
  没有守卫（已知缺口）」改成 M134 之后的真形态：显示路径是委派（拿 core 的稳定 id
  反查 DTO 词表，没有手写 match 可糊），新种类先在 `dto::LoaderKind::from_core` 编
  不过，糊错的后果由 `loader_kind_ids_are_the_released_contract` 与按 `ALL` 遍历的
  `every_core_loader_kind_reaches_the_tile_as_itself` 钉住。
- `presenter/src/host/game.rs` 无需改动：M134 当时已把它的文档改成新形态，读下来是
  真话（`dto_kind` 的 doc 与两个测试的 doc 都对得上现在的代码）。

验证：fmt --all --check 通过；`cargo test -p unlucky-presenter -p unlucky-i18n`
= i18n 29 passed / presenter 220 passed（1 ignored）；clippy 两 crate --all-targets
`-D warnings` 零告警。删后全仓（含 workspace 外的 crates/app）已无
`launch::loader_label` 引用。
 2026-11-05 19:09:53 +08:00
AskaEth c14543a112 fix(m134): 显示路径的 core→DTO 种类改成委派，不再留手写映射臂 
M126 r3 复审实测：core 加第八家加载器、对外契约与 help 都补齐、只在
host::game::dto_kind 那一支写 `=> Vanilla`，三个 crate 全绿（402/220/42）
而磁贴静默显示「原版」——M122 修掉的用户可见 bug 复活。

- dto_kind 不再是自己一张七支手写 match：种类由 core 的稳定 id 反查 DTO 词表
  （LoaderKind::parse → dto::LoaderKind::from_core，全仓唯一那份映射）。落笔处没了：
  想糊 `=> Vanilla` 的人到这儿没有 match 可写，新种类必须先过 from_core。
- 反查不到（core 的 as_str 与 parse 自相矛盾，物理上做不到）就 panic，不退回「原版」。
- 测试从手抄七支清单换成按 core 的 ALL 遍历：加一家自动进圈，不用记得补一行。
 2026-11-05 19:02:15 +08:00
AskaEth f6b7759aa8 docs(m126 r3): 收窄「唯一一份」的说法，并把 ③ 的承诺改成真话 
纯文档，零逻辑改动（`git diff` 里每一行都是 `//!` / `///`）。

P2-1「唯一一份」不成立：`cli/src/cli/help.rs` 里 `ull help instances` 的词表行是
**会打印给用户看的第二份逐字副本**。四处说法收窄为「源头表在 core + 另一处逐字副本在
help.rs，由 `help_lists_every_stable_id` 按 `ALL` 遍历守着」：`game/loader.rs` 的模块
文档（原「生产代码里这七个串只有一处」）与 `as_str` doc（原「生产代码里唯一一份 id
字面量」）、`cli/commands/instances.rs` 的模块文档（原「全仓唯一一份 id 字面量」）与
`loader_json` doc（原「两样都只该有一份」）、`presenter/dto/instances.rs` 的 as_str doc
与契约测试 doc、`addon/loader/mod.rs` 的两处「唯一真相源」。

P2-2「③ 拦得住静默变原版」对显示路径不成立：`presenter/src/host/game.rs::dto_kind` 里
糊一支 `=> Vanilla`、同时把契约与 help 补齐，三个 crate 全绿而磁贴静默显示「原版」。
现在写的是「③ 拦的是**对外词表**（加种类、改词表都红），但**拦不住显示路径**，那处目前
没有守卫（已知缺口，另行记账）」。

顺带只做排版级的行数回收：loader.rs 400 → 397（≤400，仍留余量）。
门禁：cargo fmt --all --check → FMT_OK（本轮按要求只跑 fmt）。
 2026-11-05 18:09:00 +08:00
AskaEth 14ac0dc248 test(m126 r2): 加一支枚举不更新对外契约现在必然红（集合断言 + help 守卫） 
r2 复审指出「加一家加载器会被逼着表态」只做到一半：编译期只拦「漏 match」，三处消费方
用最省事的 `=> Vanilla` 糊过去既编得过、测试也全绿——新加载器会静默显示成原版，正是本
mission 要消灭的形态（r1 里「Rift 会红」是负样本名字撞上的巧合，不是守卫）。

- presenter 的 `loader_kind_ids_are_the_released_contract` 增加**第 ② 段**：把 core 的
  `LoaderKind::ALL.map(as_str)` 与独立手写的七个 id 做**集合相等**比较。加一支而不更新
  契约 → 红；改词表 → 红。（r1 删掉 `assert!(ALL.len()==7)` 后缺的正是这一环：数组宽度
  只保证「表里那一行写成 7 个」，不保证枚举没多一支。）
- 新增 `cli::commands::instances::help_vocabulary_tests::help_lists_every_stable_id`：
  按 `LoaderKind::ALL` 遍历 `ull help instances` 的词表行，漏写一个新 id 必红（此前
  `help.rs:67` 那段词表没有任何测试，而旧的 `help_documents_the_loader_field_contract`
  只查关键词，加一家新加载器时它照样绿）。
- `addon::loader::tests::vocabulary` 补 `installable_list_matches_the_from_core_mapping`：
  把唯一还手写的 `LoaderKind::all()` 与 `from_core` 认可的集合对齐（不重抄字面量）。
- 模块文档第 ③ 步改成真话：契约测试会拦「改词表」与「加新种类」；但 `=> Vanilla` 这种
  糊法**编得过**，拦住它的是那条集合断言，不是编译器（改名同理，只有契约测试会红）。
- 一并修掉 presenter 那条测试 doc 里指向已被删除的 `MARKERS` /
  `markers_cover_every_kind_that_has_one` 的引用，改指向现在真实存在的守卫。
- loader.rs 从 398 压到 395（≤400，留 5 行余量；拆测试到子模块需要 scope 放宽到
  `crates/core/src/game/loader/**`，超出本任务文件清单，已按规矩记账）。

验收实测（临时加 `Abyss` + 三处 `=> Vanilla` 糊过去，已还原）：presenter 契约测试红
（left 8 项 / right 7 项），CLI help 测试红（漏了 `abyss`）；core 往返测试与安装侧清单
守卫、CLI 的 `json_rows_*` 仍绿（它们本就管别的事）。
 2026-11-05 18:08:59 +08:00
AskaEth a322cfcbfe refactor(core): M126 r1 返工：词表改由宏单表生成，安装侧解析收口 
复审 r1 的三条：

P1（CI 会红）：`const MARKERS: [(LoaderKind, &'static str); 6]` 触发
clippy::redundant_static_lifetimes（`error: constants have by default a 'static
lifetime`）。返工直接**删掉 MARKERS**：标记串就取 `LoaderKind::as_str()`，候选顺序取
`LoaderKind::ALL`，认不认标记看 `has_marker()`——解析表既没有独立字面量，也没有独立清单。

P2-1：「漏加 ALL 不会被任何东西拦住」是真话，之前的 doc 覆盖声明是假的。返工用
`loader_kind_vocab!` 宏从**一张表**一次生成枚举 / `ALL` / `as_str` / `has_marker`：
「加了一支却忘了进清单」在物理上不可能（没有第二份清单可写）。尺寸锚随之删除（`[Self; N]`
的宽度本来就由表决定），`parse` 留在宏外的独立 impl 里。

P2-2：「全仓唯一一份 id 字面量」原先不成立——安装侧 `LoaderKind::parse` 还手写了一份反向
匹配表，并带一个只进不出的 `neo-forge` 别名。返工让 install 侧 `parse` **委派**
`core::game::LoaderKind::parse`，只额外收 `neo-forge`（Modrinth 拼法）这一个输入别名，
并新增 `addon::loader::tests::vocabulary` 覆盖「委派没接错 + 别名只进不出 + 装不了的几家
返回 None」。

测试：core 的 `markers_cover_every_kind_that_has_one` 换成
`every_stable_id_parses_back_to_its_kind`（往返 + 顺序优先级），仍是「改名不可见、只有契约
测试能抓」的分工，doc 里写明。

门禁：fmt OK；clippy -p unlucky-core -p unlucky-presenter -p unlucky-cli --all-targets
-- -D warnings 干净；三 crate 测试 core lib 401 / presenter 220 / cli 41 全 ok。
文件行数：loader.rs 397（≤400）。
 2026-11-05 18:08:57 +08:00
AskaEth be37c17962 refactor(core): M126 加载器稳定 id 词表收敛到 game::LoaderKind::as_str 
M122 把「id → 加载器」的解析收到 core::game::loader::InstanceLoader::parse，但
「种类 → 对外稳定 id」的命名词表还散在多处，其中 install 侧那一份只靠一句「不要改名」
的注释约束，MARKERS 更是第四张无守卫字面量表。

- core::game::LoaderKind 新增 as_str（**全仓唯一一份 id 字面量**）、has_marker
  （穷尽 match：新种类必须表态认不认 id 标记）、parse（as_str 的反查）与 ALL（清单，
  顺序即标记优先级）；MARKERS 的标记串改为取自 as_str，不再是独立字面量。
- addon::loader::LoaderKind::as_str 改成委派（结构映射，无字面量）：安装侧拼出的
  <mc>-<kind>-<loader> 与解析侧从此同源。
- presenter::dto::instances::LoaderKind 的 as_str/parse 委派给 core（to_core/from_core
  是结构映射），删掉第四份词表；CLI 删掉 loader_kind_id 翻译层，直接调 core。
- 测试：core 新增 markers_cover_every_kind_that_has_one（MARKERS↔ALL↔has_marker↔as_str
  逐格对齐 + 按标记串 round-trip + neoforge 先于 forge）；presenter 新增
  loader_kind_ids_are_the_released_contract（七个 id 逐字钉住 + 反查 + 别名隔离）。
- 对外输出未变：真二进制对同一组 7 类实例的 `instances list --json` 输出逐字节相同
  （md5 0341752658ca28e020ba48c31a51a124），人读输出同样逐字节相同。

file 行数：core/game/loader.rs 337→399（≤400 硬约束，文档按密度重排、事实未丢）。
 2026-11-05 18:08:56 +08:00
AskaEth 02c7910ad5 ci(app-iced): M127 把下载页四条像素守门接进 CI（仅 Windows），缺图在 CI 里从 SKIP 改成失败 
- 新增 tests/options_shot/feed.rs：四条断言共用一条「喂图」策略
  · CI（CI 已设置）且 Windows 上缺 ULL_DL_*_SHOT ⇒ 失败并提示「守门未喂图」
  · 非 Windows 上喂了图 ⇒ CI 里也失败（断言按 Segoe UI 标定的行高/墨迹宽度）
  · 本机缺图仍可跳过，但每次都留一句提示
- ci.yml 的 test 作业（Windows 槽）：pages_demo 现出 ready700/chips700/compact736/wide1180
  四张图 → 写进 $GITHUB_ENV → cargo test -p unlucky-app-iced --lib options_shot
  出图与断言两步都带 if: runner.os == 'Windows'；失败时上传四张图便于复盘
- 顺带订正五处文档数字：main 7 整行 / r1 4 整行 / r2 7 整行，并写清第 8 条墨迹是 hint
  （rows.rs ×3、options_shot/ready.rs、tests/view.rs），不动任何断言期望值
 2026-11-05 17:17:43 +08:00
AskaEth 0f26ed3753 fix(app-iced): M125 r2 —— chips 档「还没选版本」不再对半切；宽度表换成实测值 
r1 复审 p2-1：`TailShare::of` 只判档位，于是 chips 档「刚进页面」（面板只有一行
提示）也被五五分——700×760 下列表 8 个版本只显示 4 个、下半块 ≈160px 空画布，
而修前（main）这一态是 7 整行。修法：判据加**面板形态**，`Hint` 在任何档位都钉死，
`Chips` + `Options`/`Install` 才共享。实测回到 7 整行（与 main 同一水位）。

守门：新增 `options_shot/ready.rs`（`ULL_DL_READY_SHOT`，不设 `ULL_DL_DEMO` 出的
700×760 图）：列表区至少读出 6 个版本号。它在 r1 的图上**红**（4 个，原生输出见
mission 报告），在修后图上绿（7 个）。三条旧守门照旧（chips / compact / wide），
chips 与 compact 换修前图仍红。

r1 复审 p2-2：宽度表的实测值改正（同一张 736 图逐项量）：
`1.21` 26（余 6）、`1.20` 28（余 4）、`24w` **29**（余 3）、`All versions` 墨迹画到
x=247（裁切边 248，只差 1px）⇒ 桶标签余量是 **3~6px** 而不是 6；「短标签『全部』= 32
零余量」这条论证的对比强度随之写准（比桶标签的 3~6px 更薄）。
`rails/major.rs` 的表格、`options_shot/compact.rs` 的测试文档一并改成实测值；
「墨迹右边界」那条反例也从 216..244 改成实测 216..247。

r1 复审 p3-1：第二级「全部版本」的图标从网格（与第一级同字形同药丸、像素级同形）
换成文档/清单字形 `IconKind::Logs`，理由与「图标集里没有版本/历史字形」写进
`major_shape` 文档。

r1 复审 p3-2：chips 档最多三层滚动（列表 / 面板 / loader 菜单）作为**已知风险**
登记在 `install.rs` 文档里，并写明为什么「把实例名移出滚动区」本轮不做（要拆
`options::section`，动三个文件，而且改完仍无法验证滚轮冒泡——没有通道）。
 2026-11-05 16:43:35 +08:00
AskaEth 9c623a6fd3 style(app-iced): M125 拆文件时留下的孤儿文档片段（clippy 的 empty_line_after_doc_comments） 2026-11-05 16:03:10 +08:00
AskaEth 70dea995b7 refactor(app-iced): M125 主版本栏与选项区像素守门各拆一层（守 400 行红线） 
两处拆分，只为过 `gate::every_source_file_stays_under_the_line_limit`：

- `download/rails.rs` 435 行 → `rails.rs` 311 + `rails/major.rs` 157：主版本桶那一栏
  （`major_rail` / `major_entries` / `major_shape` / `MajorEntry` / `MajorShape`）搬进子模块，
  `rail_title` 留在父模块（两条栏共用）。`Key::VersionMajorTitle` 的落点跟着搬，
  `tests/i18n.rs` 的死 key 扫描表补上 `rails/major.rs`（漏扫会把活 key 判成死 key）。
- `tests/options_shot.rs` 475 行 → 345 + `options_shot/chips.rs` 75 + `options_shot/compact.rs` 67。

顺带修 `options_shot::bands()` 的一处既有缺口：它按三栏算列表列左缘（112+0+24+0+24 = 160），
chips 档没有侧栏时这个左缘是错的，右缘跟着冲出画面 22px——M125 的 chips 守门正好踩到
「扫描越界读到下一行像素」，`first_rule_y` 因此恒返回 None。现在 chips 档直接取页左缘
（112），三栏三档的数值一个不变（M123 那些 140/140、缝 24 的断言照旧）。

守门实跑（本机，tiny-skia）：
- 解 ignore 的 `chips::a_chips_tier_shot_…` 在修后图绿、**修前图红**（实测 18px ≠ 44）；
- `compact::a_compact_tier_shot_…` 修后图绿、修前图红（实测 44px 文字行 ≠ 40px 图标按钮）；
- chips 那条换深色图同样绿（断言不依赖主题色）。
 2026-11-05 16:01:03 +08:00
AskaEth 822f98022d fix(app-iced): M125 chips 档列表不被选项区压成缝；Compact 档主版本首项不再裁字 
两条缺陷都是 M123 取证时在真图上拍出来的，塔台另行核过图：

缺陷 1（medium）：chips 档（窗口 < 736，可用宽 < 600）里选项区按内容高
≈316px 钉在列表下面，列表只剩 18px（0.4 行，行高 44）——版本号读不出来、
换不了版本。修法：`rows::TailShare` 两档，chips 档改成「列表与面板各吃一半、
面板自己可滚」（列表拿到 ≈182px = 4 整行，面板顶端那个实心「安装」与五个
loader chip 仍在屏内）；三栏三档照旧钉死（760 高下列表还有 3 整行、面板
整块在屏内，两样都对）。判据按档位而不是按高度：页面模型里只有 window_width，
窗口高度没接进页面（边界写进 TailShare 文档与报告）。

缺陷 2（medium）：Compact 档主版本栏宽 64，`ListItem` 两侧内边距各 16 ⇒ 文本格
32，首项「All versions」要 ≈84 ⇒ 图上只剩「All v」；中文「全部版本」= 4 全角字
= 64，32 里只剩「全部」且正好顶到裁切边。修法：图标条档的「全部版本」不画文字，
改画与本页第一级那个「全部」同一个网格图标（40×40 Tonal 药丸 + 全称 tooltip）；
桶标签（1.21/24w，实测墨迹 26）放得下，照旧画原文。`rails.rs` 那条「64 宽里
1.21 仍完整」的注释改成实测宽度表，并写清它对首项不成立。

顺带：列表与尾部面板之间补上分隔线（三态一致），`rows::content` 与两个装配点
按档位传 `TailShare`。

守门：
- `tests/options_shot.rs` 解掉 M123 那条 `#[ignore]`（期望值一个字没改，只加
  「列表区 ≥ 3 整行」与「面板仍在屏内、没被底边切」两条）；
- 新增 `a_compact_tier_shot_draws_an_icon_for_the_first_major_entry`：缺陷 2 的
  像素守门（首项是 40×40 居中药丸，不是 64×44 通栏文字行）。复审建议的
  「墨迹右边界 ≤ 栏右内边界」在坏图上也是绿的（修前墨迹 216..244，边界 248），
  所以改钉形状，理由写在测试文档里；
- `tests/rails.rs`：中文与英文都走 Icon 分支、以及 32px 文本格的宽度账
  （「全部版本」= 64 > 32 是精确值，「全部」= 32 零余量所以不选短标签）；
- `tests/view.rs`：档位 → TailShare 的决策面 + 两个装配点都按档位传。

未改产品文案、未改窗口最小宽、未动 M123 的任何断言期望值。
 2026-11-05 15:48:57 +08:00
AskaEth 4a41263357 test(app-iced): M123 安装选项区 × 三栏同屏的宽度与行裁剪守门 
安装选项区（`download/options`）与三栏（`download/rails`）各自都有断言，
但它们**同屏**这件事从来没验过：选项区一高列表就矮，窗口一窄两条栏一收列表
就窄，这两种挤压都不会让任何既有断言变红。

- `tests/options_screen.rs`：七档宽度（1180/1024/900/880/812/736/700）× 三种
  选项态（原版 / Fabric / NeoForge 不兼容）。三栏数字按 `layout/rails.rs` 的
  数值表逐格钉死；列表列在每一档都 ≥ 424（行内四样仍在一行）；两条栏与选项
  面板在同一份模型里、树能一次构建。
- `tests/options_shot.rs`：真 PNG 上的像素断言（需 `ULL_DL_OPTIONS_SHOT`）。
  两栏同屏且像素宽度 = 裁决值 140/140、栏间 24 的缝真空着、第一行版本行整行
  44px、选项区最后一行墨迹离底边还有余量。另有一条 `#[ignore]` 的 Chips 档
  回归：700×760 下列表被压成 18px（现状红，缺陷已单列报告与 finding）。

出图（38 张）在 `DevDocs/artifacts/m123/`（git 忽略，不入库）；旧的
`DevDocs/artifacts/m109/`（内容库页早于 M108 改名，导航轨写的是 `Download`）
已按任务 ② 删除，内容库 12 态在 m123 里按当前 tip 重出。

不动产品行为：本提交只有测试与模块声明。
 2026-11-05 15:46:26 +08:00
AskaEth 9ead4ae892 feat(cli): M124 instances list --json 补 loader 字段，只加不改 
`ull instances list` 的人读输出历来只逐字打 `version_id`，脚本/agent 要判断
「这是不是 Fabric」只能自己猜 id 形状——正是 M122 收敛掉的第二份真相。本提交只补
输出面：

- 每行实例加 `loader: {"kind": <稳定 id>, "version": <版本段>}`，解析一律调
  `unlucky_core::game::InstanceLoader::parse`（M122 的全仓唯一入口），CLI 里没有
  任何新的 id 匹配；CLI 只做「种类 → 稳定 id」的穷尽翻译。
- 原版恒为 `{"kind":"vanilla","version":""}`：键恒存在、不为 null，脚本不必判空。
- `kind` 是识别口径（7 值，含只能继承不能安装的 optifine/liteloader），不是
  `install --loader` 的安装口径（5 值）——这条连同「vanilla 只表示 id 里没有加载器
  痕迹」一起写进模块文档与 `ull help instances`（`--json` 是事实对外契约，字段说明
  跟着契约走）。
- 向后兼容：`data.instances[]` 原有七个键一个没动，人类可读输出逐字不变。
- 测试（`commands::instances::tests`，走真入口 `crate::run`）：四家自家 id + 原版 +
  两家第三方前缀的真值表、原版非 null 的反向锚、人读输出与旧字段不变的兼容锚、
  help 里有契约说明的文档锚。
 2026-11-05 15:23:37 +08:00
AskaEth 081ce65596 fix(core): M122 版本 id → 加载器只留一份解析，并认全自家 id 口径 
`presenter::host::game::loader_from_id` 只认 `fabric-loader-…` / `quilt-loader-…`，
而本启动器自己生成的 id 是 `<mc>-<kind>-<loader>`（`1.20.4-fabric-0.16.5` /
`1.20.4-quilt-0.27.0`），于是刚装好的 Fabric / Quilt 实例在实例页显示成「原版」。

- 新增 `core::game::loader`：`InstanceLoader::parse` 是全仓唯一的 id 解析入口
  （按 `-` 切段、段前缀匹配标记、跳过独立的 `loader` 段、砍老 HMCL 的 MC 尾巴）。
  覆盖自家四种口径（生成端 `addon::loader::LoaderKind::version_id`）、老 HMCL / CF
  口径、OptiFine / LiteLoader 第三方前缀；标记按整段前缀匹配，不再用「包含子串」。
- presenter 只留 DTO 翻译：`dto_kind` 穷尽 match（`dto/` 里仍不许出现 core 类型）。
- 测试：真值表**从生成端取 id**，反向锚（普通版本 id 不被认成加载器），映射单射，
  以及端到端快照（`instances()` 的磁贴数据对四个加载器各自的版本号与徽标）。
 2026-11-05 14:46:22 +08:00
AskaEth bf6b0c4126 build(release): workspace 版本 0.1.0 → 0.2.0，README 的 tag 事实改成 v0.2.0 口径 
- Cargo.toml [workspace.package] version = 0.2.0；Cargo.lock 由 cargo 重新解出一致
  （只有 8 个 unlucky-* 成员条目变动，第三方版本一字未动）
- 各 crate 的 `unlucky-*` path 依赖 `version = "0.1"` 同步提到 "0.2"，否则工作区
  根本解析不出来（cargo metadata 会报 `failed to select a version for
  unlucky-core = "^0.1"`）；crates/app 虽被 exclude、cargo 不读，也一并跟上避免将来
  重新纳入时立刻解析失败
- core::launch::LauncherConfig 兜底的 launcher_version 改成 env!("CARGO_PKG_VERSION")，
  不再是把版本写死一份（CLI / presenter 本来就这么写）
- README.md / README.zh-CN.md：删掉「v0.1.0 是目前唯一的 tag / the only tagged release」
  这类随 v0.2.0 发布即变假的陈述，改写成「v0.1.0 是最后一个 Slint 版 tag，v0.2.0 是
  重写后的第一个 tag」；所有讲 v0.1.0 资产 / Slint Royalty-Free 义务的历史记录原样保留
- packaging/README.md：命名与校验示例跟当前 tag 走（v0.2.0）；§7 实测记录里的 0.1.0
  输出加一句「属实测记录、不回填」，并把过期的「四个 workspace member」改成「任何一个」
 2026-11-05 14:08:37 +08:00
AskaEth d0a8f68607 docs(m120): 页面模块的守门说明改成白名单口径 2026-11-05 13:36:45 +08:00
AskaEth f86be2bd38 fix(app-iced): M120 r1 —— 徽标判据改回「类型是原版」；旧串黑名单翻成白名单 
r1 复审 p2-1（真回归，我引入的）：`loader_badge` 把「非原版 + 空版本号」也送进了
`Key::LoaderVanilla`。而 `host::game::loader_from_id("1.20.1-forge")` 这类 id 取不到版本段
（它按 `forge-` 找，id 却是 `-forge` 结尾），`LoaderInfo::badge()` 对它们给的正是品牌名
`Forge` / `NeoForge` / `OptiFine` —— 于是这三个显示成「原版 / Vanilla」。

判据改成「**加载器类型本身是原版** ⇒ 过词表，其余交给 `badge()`」：
- 修的是判据，不是加分支：函数注释本来就写着「只有原版这一支要过词表」，代码与注释相矛盾。
- 新回归测试 `the_loader_badge_keeps_the_brand_when_the_version_is_missing`：
  `1.20.1-forge` / `1.20.1-neoforge` / `1.20.1-OptiFine` 三条 id 各断言列表副文案与 LOADER
  卡的值都是品牌名（中英两套语言各跑一遍，品牌名两套语言相同）。
  变异实测：把判据改回旧写法 ⇒ 立刻红（`left: "1.20.4 · Vanilla" / right: "1.20.4 · Forge"`，
  与复审给的实证逐字相同）。

r1 复审 p2-2（不阻塞，按塔台要求顺手做）：源码反扫从**黑名单 29 条旧串**翻成**白名单**。
- 先数过：五个页面源码里一共 13 个字面量，其中带 ASCII 单词的只有 6 条，全是专有名词 /
  技术标识 / 占位符名 / 族名前缀（`{date} {time} UTC` / `isolated` / `shared` / `pid` /
  `reason` / `Instances`），逐条写了理由。
- 判据反过来之后，往页面里**新写**一句英文也会红（复审抓到的哑点）——变异实测：
  写进 `"Ready"` ⇒ 红；写回 `"ALL INSTANCES"` ⇒ 红。
- 反向锚保留：扫描器必须真扫到 ≥6 条、`Texts::of(` / `Header::new(texts.title())` /
  `Key::Instances` / `Key::InstancesStage` 必须在用（防止断言空转）。
 2026-11-05 13:36:45 +08:00
AskaEth 1a4e1fee12 feat(app-iced): M120 实例页与启动阶段标签跟着界面语言走 
来源：M106 r1 复审点名——中文机器上首屏（实例页）仍是英中混排（页头 / New instance /
Import / ALL INSTANCES / VERSION / Present on disk / Running · pid / Launch failed）。
用户的原话是「我系统语言是中文 为什么打开软件是英文」。

改了什么
- i18n：catalog/instances.rs 从 6 条死 key 补到 34 条（页头 / 列表列头 / 详情动作 /
  窄窗说明 / 元信息标签与值 / 隔离档位 / 运行状态 / 四个启动阶段）。族在装配链第 2 位，
  新 key 追加在本族末尾，golden 对应位置插入（不是文件末尾追加）。
- 页面：新增 pages/instances/text.rs（Texts）——页面唯一的取词入口，实例页里不再有
  任何可见英文字面量；detail / demo 也改从它取。
- 阶段标签：view/instances.rs 的 Running / Launch failed / 四阶段全部走目录；
  **数字与分隔符不随语言变形**（运行中 · pid 1234 与 Running · pid 1234 只换前半句）。
- 顺手修掉两处「语言反向泄漏」：原版徽标此前直接画 presenter 的中文「原版」（英文界面
  会漏中文），现在走 LoaderVanilla；隔离档位 isolated/shared 也从 core 的稳定 id 换成人话。
- 删掉 InstancesLastPlayed：M117 加的整句 key，从未接线，形状与「标签 + 值」的元信息卡
  不符，由 InstancesMetaLastPlayed + InstancesNeverPlayed 取代。

守门（pages/instances/tests/i18n.rs + app/view/tests.rs）
- 中文态无 ASCII 英文单词（品牌 Java / 技术标识 pid 白名单）；
- 每一条 Instances* 的两套译文必须不同（切语言时真的变）；
- Running 的数字与 · pid 分隔符在两套语言里逐字保留；
- 页面源码里 29 条旧英文基线不许回来；每条 key 都必须被页面引用（死 key）。

出图：DevDocs/artifacts/m120/01~12（有实例 / 空态 / 运行中 × 浅深 × 中英）。
 2026-11-05 13:36:44 +08:00
AskaEth 2f491c31f9 refactor(app-iced): M120 把实例页的展示转换从 view.rs 拆出去（纯搬移） 
view.rs 是「快照 → 视图模型」的唯一入口，实例页那一段（列表副文案 / 运行状态 /
元信息卡 / 时间戳）占了它近一半。M120 要在这批文案上接 i18n，先按功能拆成
view/instances.rs（account_page / logs / rail 是同一个先例），本次一字未改行为。

唯一的非搬移改动：view/tests.rs 显式 import InstanceRuntime / LaunchStage
（它们原来是从 view.rs 的 use 里顺带借到的，拆分后不再可见）。
 2026-11-05 13:36:43 +08:00
AskaEth 0e48ea15b8 fix(app-iced): M119 r2 —— 四处「模拟」文案全由 simulated 驱动；确认条不再替用户 arm 键盘 
复审 r2 的两条 p2 都是「上一轮各差一步」：字段/焦点都真的做了，但**另有三处没接上**、
**键盘闸是代码自己打开的**。

## P2-1：四处文案只认一个开关

r1 只有标题胶囊由 `simulated` 驱动；副标题 / 输入框占位符 / 空态正文是**无条件取词**，
而它们的译文里写着「模拟 / 没接真实模型」——接上真 transport 之后这三句会**反向**留着
（`simulated == false` 时界面还在声明「没接真实模型」）。而且没有一条测试钉得住那个声明。

现在：

- 新增 `pages/agent::Disclaimer { simulated, subtitle, placeholder, empty_body }`，
  `Disclaimer::of(catalog, simulated)` 一次算好；`Conversation.simulated: bool` 换成
  `Conversation.note: Disclaimer`，header / composer / transcript 三处各自从它取词——
  **视图里没有第二种取词路径**；
- i18n 配成对：模拟态用既有的 `AgentSubtitle` / `AgentPlaceholder` / `AgentEmptyBody`，
  真实态新增 `AgentSubtitleReal` / `AgentPlaceholderReal` / `AgentEmptyBodyReal`（中性话）。
  （没有把三句改成中性话：那句告知本身有价值，接真模型后它才该消失。）
- 证据：`crates/app-iced/src/pages/agent/tests/disclaimer.rs`
  —— `all_four_disclaimers_appear_when_the_backend_is_simulated`（四处都提模拟）、
  `no_disclaimer_survives_when_a_real_backend_is_wired`（四处都不提，且不许用空串糊）、
  `the_two_states_use_different_keys`（两态不能共用同一个 key）。

**golden.rs 的 400 行边界**：+3 条会破线。按「按功能拆、不压注释」处理——把这张表的
**说明文档**（35 行）原样搬到 `catalog.rs` 里 `mod golden;` 的文档上（一个字的说明都没删），
`golden.rs` 只留表数据 + 3 行指针。现在 `golden.rs` 374 行、`catalog.rs` 328 行。

## P2-2：键盘闸不许由代码替用户打开

r1 在 `sync_confirm_focus`（`on_agent` 的无条件尾巴，`Events` 又由心跳驱动）里顺手
`keyboard_mode = true`——于是**只要冒出待确认，全局键盘闸就开了**；用户发完那句话接着打下一句，
第一个空格就成了「批准写操作」。复审用临时用例复现过（`rail.confirm` 变 `None`）。

现在：

- `sync_confirm_focus` **只挪焦点**到「允许」，不再碰 `keyboard_mode`（字段文档里写清了为什么）；
- 键盘用户的表态是 `Tab`：`AgentUi::step_focus` 加了一条 **arming 规则**——待确认、焦点已在
  确认条上、但键盘闸还关着时，这一次 `Tab` **只点亮焦点环、不移动焦点**（否则第一次 Tab 会把
  「允许」挪到「拒绝」，用户按 Enter 就是反着裁决）；之后再 Tab 才逐格走；
- 反向回归：`a_stray_space_or_enter_never_approves_a_pending_write`（打字 → 空格 / 回车都不得裁决，
  审计也不许留）；`a_blocking_confirm_can_be_decided_with_the_keyboard_alone` 改成
  「确认到达时未 armed → Tab 点亮 → Enter 允许；第二轮 Tab·Tab 到拒绝 → Space」。

## 出图

`DevDocs/artifacts/m119/` 18 张全部重出（新增取证夹具 `ULL_AGENT_FIXTURE=armed`：
跑一轮真提交后再按一次 Tab，专供「焦点环可见」那张图）：

- `08-agent-simulated-{light,dark}`：`simulated = true` 下四处「模拟」同时可见；
- `09-agent-confirm-focus-{light,dark}`：**按过 Tab 之后**的确认条（焦点环在「允许」上）；
- `05-agent-confirm-{light,dark}`：确认条刚出现、**还没 arm**（无焦点环）——与 09 成对，
  正好把 r2 的行为差异拍下来。

## 门禁（真实退出码，最终树）

| 命令 | 退出码 |
|---|---|
| `cargo fmt --all --check` | 0 |
| `cargo clippy -p unlucky-app-iced -p unlucky-presenter -p unlucky-agent -p unlucky-i18n --all-targets -- -D warnings` | 0（0 warning）|
| `cargo test -p unlucky-app-iced --lib` | 0（605 passed / 0 failed / 2 ignored）|
| `cargo test --workspace --exclude unlucky-app` | 0（58 套 2281 passed / 0 failed / 11 ignored）|

全树受检文件无 >400（`golden.rs` 374、`catalog.rs` 328、`pages/agent/mod.rs` 371）。
 2026-11-05 10:43:22 +08:00
AskaEth a22baebe70 fix(app-iced): M119 r1 —— 常驻「模拟」标识 + 确认条的键盘通路 
复审 r1 的两条 p2，都是「说成真的、其实是假的」与「能走进死路」这个级别的问题。

## P2-1：界面必须自己说清「这是模拟」

原判：生产默认后端是**脚本化 rig**（`ULL_AGENT_SCRIPT` 的 6 种剧情），而「后端未接 / 模型还没
接上」两句诚实文案被我改成了中性话，理由写着「由端点标签说」——**那条端点标签在壳里根本不存在**。
于是默认配置下用户敲一句话得到一段像是模型编的回答。判据：没读过代码的用户，打开右栏、敲一句话，
必须能自己看出来这不是真模型（不接受 tooltip、不接受藏在设置里）。

修法（①恢复诚实文案 + ②常驻可见标记，并用）：

| 位置 | 文案 / 形态 | 谁给的 |
|---|---|---|
| 标题右侧**常驻胶囊**（`SurfaceVariant` tonal）| `Key::AgentSimulated`（Simulated / 模拟）| `AgentHost::is_simulated()` → `Session.simulated` → 视图 |
| 标题下副标题 | 「模拟助手 · 还没接真实模型」 | `Key::AgentSubtitle`（原本是「未接」被改成中性的「会话」，现在写回来且更明确）|
| 空会话正文 | 「…当前是模拟助手，没有接真实模型。」 | `Key::AgentEmptyBody` |
| 输入框占位符 | 「给模拟助手发消息…」 | `Key::AgentPlaceholder` |

**标记不是硬编码在视图里**：`AgentHost.simulated` 是事实字段（今天 transport 只有 rig ⇒ 恒 true）。
接真 `AgentTransport` 那天把它传 `false`，四个位置的「模拟」措辞会一起消失——这是为什么用字段而不是
写死一句话。

## P2-2：确认条必须有键盘通路

原判：Allow/Deny 只有鼠标路径 ⇒ 键盘用户在写操作确认处**永久卡死**（`busy` 锁发送、
`Stop` 走主后端、清不掉 presenter 的 pending confirm）。

- 焦点环多两格：`Focus::ConfirmAllow` / `Focus::ConfirmDeny`，**只在有待确认时**存在
  （鼠标用户不会 Tab 到不存在的按钮）；
- 待确认出现 ⇒ `sync_confirm_focus()` 把焦点直接落到「允许」并**打开键盘巡航**（阻塞态主动亮环），
  消失 ⇒ 焦点收回输入框、巡航关闭；
- `Enter` 与 `Space` 都映射到 `Activate`（`Space` 不抢输入框：`keyboard_mode` 那道闸在
  鼠标点进输入框时是关的）；
- 焦点环不是 10% 状态层——在**实心主色**按钮上那层几乎看不见（出图实测过一版就是没有）。
  改成 2dp `Primary` 描边 + 3px 留白，两个按钮恒定加这层 padding，所以焦点变化不移动布局。

测试（`crates/app-iced/src/app/update/agent/tests.rs`）：
`a_blocking_confirm_can_be_decided_with_the_keyboard_alone` —— 全程只有键盘消息：
确认到达后断言 `focus == ConfirmAllow && keyboard_mode`，发一条 `KeyPressed(Enter)` 完成允许；
第二轮 `Tab`（走到 Deny）+ `KeyPressed(Space)` 完成拒绝；两轮各记一条审计、焦点都收回 Composer。
另有 `the_default_backend_reports_itself_as_simulated` 钉住 P2-1 的事实来源。

## 视图入参顺带收成结构体

`docked`/`page` 本来是 6 个形参（`ui, agent, rail, failure, catalog, width`），这一轮还要加
`simulated` ⇒ 7 个。按塔台登记的可维护性口径改成 `Session { agent, rail, failure, simulated }`：
两个宿主各 3 个形参，以后再加展示事实只改 `Session`。

## 出图（18 张，浅深各一）

`DevDocs/artifacts/m119/`：新增 `08-agent-simulated-*`（空会话 + 四处「模拟」措辞）与
`09-agent-confirm-focus-*`（确认条 + 焦点环落在「允许」）；其余 7 组全部重出（文案与焦点环都变了）。

## 门禁（真实退出码）

| 命令 | 退出码 |
|---|---|
| `cargo fmt --all --check` | 0 |
| `cargo clippy -p unlucky-app-iced -p unlucky-presenter -p unlucky-agent -p unlucky-i18n --all-targets -- -D warnings` | 0（0 warning）|
| `cargo test -p unlucky-app-iced --lib` | 0（601 passed / 0 failed / 2 ignored）|
| `cargo test --workspace --exclude unlucky-app` | 0（58 套 2277 passed / 0 failed / 11 ignored）|

`golden.rs` 400 行（+1 条 `AgentSimulated` 正好顶线）；全树受检文件无 >400。
 2026-11-05 09:17:50 +08:00
AskaEth b5e96c61ac fix(app-iced): M119 出图抓到的两处：右栏文案没跟 lang 走、确认条文字被压成竖缝 
两张验收图（`DevDocs/artifacts/m119/`）暴露的问题，都是测试抓不住、只有图能看出来的那类：

1. **同屏两语**：`pages/agent/mod.rs` 里还留着 M104 的 `const LANG: Lang = Lang::En`，所以右栏的
   标题/按钮恒英文，而 M119 新加的失败横幅走 `App::lang()`（这台机器是 zh-CN）⇒ 一屏里
   「Assistant / Collapse」和「连不上助手后端」并排。现在删掉那个常量，`docked`/`page` 收一个
   `Catalog` 形参，由 `App::lang().catalog()` 给——与设置页/账户页同一条口径（M106 的真值源）。

2. **确认条没有字**：`chip + 文字 + 两个按钮` 挤在同一条 `Row` 里，而右栗只有 280~360：320 宽下
   文字列被压成一条竖缝，标题整段看不见（图 05 第一版就是这个样子）。改成文字行与动作**分行**，
   动作右对齐——窄栏里才是可读的 M3 告警形态。

顺带：`Script::WriteOp` 补一句增量，免得那条助手气泡是空壳（出图更接近真后端）。

`cargo test -p unlucky-app-iced --lib`：599 passed / 0 failed；14 张图重出后逐张看过。
 2026-11-05 08:11:14 +08:00
AskaEth d4fd675935 feat(app-iced): M119 把 presenter 的 agent 四契约与账户窄入口接进 iced 壳 
M103 把 AI 会话的投影（`AgentRail` + `submit/mark_read/confirm`）做完了，M114 把账户三轨做完，
但 iced 壳一直没接：M103 复审确认 `Presenter::` 零非测试消费者，M104 的右栏会话数据来自内置样本。
这一个提交就是那一步——**右栏与账户页吃 presenter 的真实状态**。

## 接线层（新增 `crates/app-iced/src/presenter/`）

| 文件 | 是什么 |
|---|---|
| `agent.rs` | `AgentHost`：presenter 句柄（四契约）+ 事件队列 + **具名**失败（`AgentFailure`：`unreachable` / `not_implemented`）|
| `transport.rs` | `AgentTransport` 的 iced 侧实现（脚本化 rig + 五种剧情 + 两种失败注入）|
| `rig.rs`（仅测试） | 账户轨的 `Backend`：`AppCommand` → host 形状的 `CoreEvent` |
| `mod.rs` | 逻辑路径说明 + **线程/通道边界** |

物理目录 `src/presenter/`，逻辑名字 `crate::app::state::presenter`——由 `app/state.rs` 用
`#[path]` 挂载（与 `shell::agent` 挂 `pages/agent/` 同一个先例：scope 不含 `lib.rs`）。

## 事件回流

`transport` 只**入队**、UI 只**出队**：`advance`→`pump` 里同拍抽干，抽出来的这批经
**既有 `Message::Agent(..)` 通道**（新变体 `Events(Vec<AppEvent>)`）回到 `on_agent`，再由
`Presenter::apply` 落地。同一条漏斗，所以用户点击与后端事件不会各改一次状态。

## 会话内容只留一份

`AgentUi` 里的 `transcript/busy/unread` **删掉**，右栏与独立页直接读 `agent_rail()`
（`pages/agent::spec` 零拷贝借）。M104 的样本会话（`demo::transcript()`）一并删除：出厂就是
空会话，取证夹具要内容就**跑一轮真提交**（`ULL_AGENT_FIXTURE=turn`），消息只能由 presenter 产生。

## 视图

- 气泡按 `ChatMessage.role` 画（User/Assistant/Tool/System），没有任何壳自己的会话类型；
- 新增两条横幅（`conversation/banners.rs`）：**失败态**（catalog 标题 + 已脱敏正文）与
  **写操作确认**（摘要 + Allow/Deny → `agent_confirm`）；
- 拖动缝与折叠条按 400 行硬线拆到 `mod.rs` 之外（`strip.rs`、`conversation/{transcript,banners}.rs`）。

## 未读口径

presenter 判「栏可见吗」用的是它自己的 router + `prefs.ai_collapsed`，而这两件的真源在 `App`。
`refresh_view` 用 presenter 的两个**窄入口**（`navigate` / `prefs_mut().ai_collapsed`）单点写回，
带幂等闸（相同就不重复写，避免 `navigate(Route::Agent)` 顺手 mark_read 吃掉用户攒的未读）。

## 账户页

账户列表与登录事件仍走 `AppCommand`/`CoreEvent`（M114 的形状没动），本轮把**登录指令与
列表消费**纳入同一套树测试：添加离线档案 → 列表出现 → 切换 → 删除；设备码「进行中可见 + 可取消」；
失败态（名字不合法 / 凭据失效）都给具名错误。

## 树测试（9 条，`cargo test -p unlucky-app-iced --lib` 全绿：599 passed / 0 failed）

- `app/update/agent/tests.rs`：提交 → 事件回流 → 右栏出现该轮 + `busy` 翻转 + 标记已读归零；
  确认条可裁决且记审计；三种失败各给具名横幅；草稿逐字同步。
- `app/update/account/tests.rs`：增/切/删端到端；设备码进行中与取消；两种失败态；
  M114 的三条回归闸（原内联测试搬出来）。
- `pages/agent/tests.rs`：视图契约（`spec` 原样借 rail）、a11y 标签、焦点环、两种宿主全态构图。

顺带：`app/tests.rs` 里三条 `agent.unread` 断言跟着 rail 走（出厂 0 未读），`view/account_page.rs`
的 `docked` 调用点补上 rail 与失败横幅。
 2026-11-05 08:02:58 +08:00
AskaEth 6505493d4e feat(i18n): M119 追加 6 条 AI 助手错误/确认文案，并订正两条已成假话的译文 
接线（M119）之后右栏才第一次有「失败态」与「写操作确认」这两块真 UI，而 catalog 里
一条对应的 key 都没有——任务书要求「失败必须显示**具名**错误」，没有键就只能硬编码，
和 M106 立的「界面文案一律走 catalog + lang」直接冲突。所以这批条目是修不成就做不成。

新增（按金表规矩追加在 `agent_entries` 族尾、`golden.rs` 同序追加）：

| key | 用途 |
|---|---|
| `AgentErrorTitle` | 失败横幅标题 |
| `AgentErrorUnavailable` | AI 端点不可达（原因码 `unreachable`） |
| `AgentErrorNotImplemented` | 该路由还没接线（原因码 `not_implemented`） |
| `AgentConfirmRequest` | 确认条的句子（`{summary}` = presenter 已脱敏的请求摘要） |
| `AgentConfirmAllow` / `AgentConfirmDeny` | 确认条两个按钮 |

订正两条**已成假话**的译文（接线前它们陈述「后端未接」）：

- `AgentSubtitle`：`Conversation shell · no backend yet` → `Conversation`
- `AgentEmptyBody`：去掉 `No model is wired up yet.` 一句

真接的是什么由端点标签与失败横幅说，不在标题下重复。`golden.rs` 现在 399 行（+6 行后仍 ≤400）。
 2026-11-05 08:02:49 +08:00
AskaEth 3c61a2397e refactor(app-iced): 拆 state.rs(400 行) 与 update.rs(399 行) 为功能子文件 
两个文件都贴着 400 行硬线、零余量，M119 要往里加字段与一行 drain。**这一个提交只搬不改**
（下一次提交才是改动），搬的位置按功能切：

| 原位置 | 现在 | 内容 |
|---|---|---|
| `app/state.rs` | `state.rs`(172) | 只剩 crate 文档 + 常量 + `struct App` 的字段与注释 |
| 同上 | `state/construct.rs` | 两个构造器 + 字段初始化表 |
| 同上 | `state/refresh.rs` | `refresh_view`（快照 → 视图模型的唯一转换点） |
| 同上 | `state/theme.rs` | `Ui` 重算 / 主题档 / `has_screenshot` / `ui()` |
| `app/update.rs` | `update/clock.rs` | 推进一拍 / 派发 / 抽干事件 / 自动选中 |

一处**非字面**的改动：搬进子模块之后 `pub(super)` 的语义从「crate::app」变成「crate::app::state」，
所以这些方法改成 `pub(in crate::app)`——可见范围与搬家前逐字相同，只是写法得跟着模块路径走。
除此之外照抄原文（含原有注释与文档）。

搬完 `cargo check -p unlucky-app-iced --all-targets` 零 error 零 warning。
 2026-11-05 08:02:45 +08:00
AskaEth 8780f26308 fix(auth): M117 微软登录缺 client id 说「未配置」而不是「未支持」 
用户实跑 debug 二进制看到「本期未支持」，误以为功能没做；实际是构建/启动时
没注入 Azure 公共客户端 id（登录三轨已实现、白名单已批、真机验签过）。

- core/auth/microsoft/client_id.rs（新）：id 的来源判定（env > build，空白值不算配）、
  `ClientIdStatus`/`log_line()` 那行 `[auth] msa client_id=… source=…`、以及
  「未配置 + 怎么配（含可照抄命令）」的共用文案 `MISSING_CLIENT_ID_MESSAGE`。零网络。
- core/auth/error.rs：`AuthError::Unsupported` 不再统一拼「本期未支持：」前缀——该变体
  全仓唯一构造点就是缺 client id，硬拼前缀让「没配置」被读成「没实现」。`code()` 仍是
  `unsupported`，枚举形状与其它分支不动（tower 批的最小改动）。
- core/auth/microsoft/mod.rs：`from_env()` 走 `resolve_client_id()`，失败措辞取自上面那条
  文案，且在网络之前早退（连 HTTP 客户端都不建）；导出 `client_id_status()`。
- cli：`map_auth_error` 的 Unsupported hint 给两条能照抄的命令；`accounts` 帮助说清
  「不是功能缺失」与两种注入方式；新增 `msa_client_id_log_line()` 给 GUI 侧出面。
- app-iced：`on_boot` 打一行 `[auth] msa client_id=… source=…`（判据来自 core，不重算）。
- i18n：`LaunchMsaNotConfigured` 中英各一条，golden 按 `Key::ALL` 顺序在
  `LaunchFailedWithCode` 之后追加一行。

本地便利路径（gitignored，随报告交付）：`DevDocs/ops/ull-msa-run.sh` 读本地 id 文件
或 `azure-msa-app.md` 注入环境变量再起 GUI，脚本本身不含 id。
 2026-11-05 07:31:55 +08:00
AskaEth dc1fa8d082 fix(app-iced): M116 r5 —— 圆角状态从「换色正文」升级成 tonal notice 容器 
r5 复审的第二轮意见（改前那条是一行紫灰正文，与说明段只差色相、中间没有间距，读起来还是
「一段话的前两句」）。按 M3 惯例改成**容器**：

- 新增 `pages/appearance/mod.rs::notice`：`Role::SurfaceContainerHighest` 底 +
  `ShapeScale::Small` 圆角 + 左右 `Space::X2` / 上下 `Space::X1` 内边距，文字
  `Role::OnSurfaceVariant` + 加粗。**只用既有角色与间距档位**，不新增令牌、不引入图标。
  （放在模块根而不是 `section.rs`：后者已 395 行，400 行是硬顶。）
- 状态行与下面的说明段之间再补 `Space::X1`（列间距 X1 + 这里 X1 = X2 总量），
  让它与说明段在**形态**上分开，而不是靠色相。
- 出现条件不变：仅「跟随系统 + α<1」；档位照常显示用户选的值。
- 像素实测（浅色 α=85，1180×760 / 100% DPI）：容器底色 `(216,228,239)`、卡片底
  `(235,245,255)`；容器内文字 `(58,72,83)`；容器 y=372..411，说明段首行 y=428
  ⇒ ink 间距 16px（布局 8px + 行高留白）；α=100 两张图该底色出现次数为 0。

门禁：fmt --check 0 / `cargo test -p unlucky-app-iced --lib -j 2` 0（475 passed）。
 2026-11-05 06:35:21 +08:00
AskaEth 67deb103b0 fix(app-iced): M116 r5 —— 圆角状态行独立成「状态」（换色加粗）+ 说明段去掉重复并压短 
r5 复审 p2-1（图上）、p2-2（证据文档两处）。

## P2-1：状态行要被当成「状态」看见
- 说明段 `SettingsAppearanceCornerHint` 里那句 α 说明**删掉**，只留平台分工（Win11/Server 2025
  请求系统圆角、Win10 直角、macOS/Linux 看桌面合成器、我们不自绘）——英文从约 470 字符 /
  7 行压到 3 行（1180 宽、100% DPI 实测）。
- `SettingsAppearanceCornerSuspended` 改成**只由状态行说**，且状态行不再是「说明段的续行」：
  紧贴在档位行下面，颜色换成设计令牌 `Role::Tertiary`、字重加粗（`note_line` 保持原形，
  新增 4 行的 `state_line` 助手）。档位本身照常显示用户选的值，不改成「直角」。
- 出图复核（四张，浅/深 × α=100/85）：α=85 两张能看到一条**加粗的第三色**状态行，
  α=100 两张没有；状态行墨色由 `(63,76,87)`（与说明段同色）变为 `(116,108,140)`（Tertiary）。

## P2-2：证据文档两处
- `DevDocs/artifacts/m116/probe-table.md` 的 `readback` 归因：`0x04000000`=`WS_CLIPSIBLINGS`
  是 **`CreateWindowExW` 自己补的**（建完就在），`ShowWindow` **只补** `0x10000000`=`WS_VISIBLE`；
  按 r5 复审的最小实验写清（req `0x00CF0000` → before `0x04CF0000` → after `0x14CF0000`），
  读数一行未动。
- `corner/tests.rs` 里「本 mission 没构建 bin」改成指向 2026-11-04 的两次真跑记录
  （`DevDocs/artifacts/m116/README.md` 的 `[corner] boot …` 两行）。

门禁（`CARGO_TARGET_DIR=C:/Temp/ull-target/wt-116-r2`，`-j 2`，跑完已删）：
fmt --check 0 / `cargo test -p unlucky-app-iced --lib` 0（475 passed）/ `-p unlucky-i18n --lib` 0（24 passed）。
 2026-11-05 06:35:21 +08:00
AskaEth 91f723a019 docs(app-iced): M116 r4 —— 日志/模板示例改用真进程实测值（frame=overlapped） 
真进程两跑（`--software-renderer`，同一个 bin，只改整窗 α）拿到：
  α=1.0 → … frame=overlapped layered=off
  α<1   → … frame=overlapped layered=on suppressed_by=window_alpha
所以把两处仍拿 `frame=popup` 当示例的文档改成实测值：
- `pages/appearance/mod.rs` 的取证模板：`frame=overlapped layered=on … suppressed_by=window_alpha`，
  并注明真进程两条在 `DevDocs/artifacts/m116/README.md`、`frame=` 恒为 `overlapped`/`other`。
- `transparency/dwm.rs` 的 `style_summary` 示例：同上，并点明 `popup` 只属于带 owner 的弹出窗。

注释级改动，行为与断言零改动。
 2026-11-05 06:35:20 +08:00
AskaEth 1cb36da1e2 docs(presenter): M116 r4 P3 —— settings_bridge 的「三个键」漂移对齐到四个字段 
AppearanceBase 自 M116 起有四个字段（整窗 α / 标题栏三态 / 配色来源 / 窗口圆角），
load_base 的文档与测试名还写着「三个键」。只改注释与测试函数名，行为零改动。
 2026-11-05 06:35:19 +08:00
AskaEth abc51a957b fix(app-iced): M116 r4/r5 —— 产品窗口不是 WS_POPUP（真凶是整窗 α 的 layered）+ 裁定 A 落地 
r4 复审 p1（证据链前提错误）+ 裁定 A（D47：整窗透明度优先于 DWM 圆角）。

## 事实订正（四处错前提 + 两处残留断言）
- `probe.rs`：删掉「winit 在 decorations=false 下给 WS_POPUP」与「popup+layered = 本产品
  窗口的完整形状」。产品样式按 winit `window_state.rs::to_window_styles` 的来源写成
  `PRODUCT_STYLE`（`WS_CAPTION|WS_BORDER|WS_CLIPSIBLINGS|WS_SYSMENU|WS_THICKFRAME|
  WS_MINIMIZEBOX|WS_MAXIMIZEBOX` = `0x04CF0000`，**不含 WS_POPUP**），并新增
  `product` / `product+alpha` 两行（五行实验）。裸 popup 行改名为 `probe:popup*`，
  明确标注「对照，不是产品形状」。
- `corner.rs`：平台矩阵第 ③ 条改成「调整带只给带 WS_CAPTION|WS_THICKFRAME 的窗口；
  裸 popup 假形状上的 `+0,+0` 不能解释产品」；补第 ④ 条「整窗 α 会关掉圆角（裁定 A）」
  并说明日志里 `pref=` 有值即证明请求确实发出。
- `app/update/appearance.rs` 与 `transparency/{dwm.rs,transparency.rs}` 的注释：把「第一嫌疑是
  无边框 WS_POPUP」改成「整窗 α 引入的 WS_EX_LAYERED」；`frame=` 的真进程取值写明是
  `overlapped`（关 min/max 则 `other`），**永远不会是 popup**。
- 实测复核（`m116_corner_controlled_experiment`，本机 Server 2025 / RDP 断开）：
  `product` 行 `Δframe = +0,-7`（与 `decorated` 同格），`product+alpha` 也是 `+0,-7`
  ⇒ 分层位不改变那条带子，`Δframe` 不能解释圆角失效。

## 裁定 A 落地
- 日志新增中立观测栏 `suppressed_by=window_alpha`（`format_line` 多一个参数；进 `CornerApplied`
  指纹，α 1.0↔<1 各触发一次重下/一行日志）。只陈述「分层位来自我们的整窗 α」。
- 设置页：外观说明句写明「开启整窗透明度时 Windows 不会给窗口圆角，回到 100% 自动恢复」；
  新增 `SettingsAppearanceCornerSuspended` 一档，仅在「跟随系统 + α<1」时作为**当前状态提示**
  出现；档位本身照常显示用户选的值（不偷偷改成「直角」）。中英双份 + golden。
- 未动：per-pixel α、D36 的 LWA_ALPHA 实现、α 与圆角的优先级。

## 顺带
- `presenter/prefs.rs` 的 `AppearanceBase` 文档「三个键/只读」→「四个键」（r4 P3）。
- 证据目录（DevDocs/artifacts/m116/{README.md,probe-table.md}）按上面重写：五行真值表原样贴出、
  产品行标明「跑出来的不是手写的」、旧的「无边框 ⇒ 没有边框带」结论改为「只在假形状上成立，
  产品不用这个形状」。

门禁：check 0 / fmt --check 0 / `cargo test -p unlucky-app-iced --lib` 0（448 passed, 0 failed,
2 ignored）。ignore 探针实跑：`PROBE_RC=0`，两行产品读数见报告。
 2026-11-05 06:35:19 +08:00
AskaEth bc3a2b56a4 docs(app-iced): M116 r3 复审 —— 只对齐注释里的「只读下层键」数量与取证日志模板 
复审 r3：p2 ×2，纯注释/文档漂移，**行为零改动、断言零改动**。

1. `app/appearance.rs:8,15-20,68` 与 `app/state.rs:170-171`：M116 之后
   `AppearanceBase` 是**四个**字段（整窗 α / 标题栏三态 / 配色来源 / 窗口圆角），
   走 `AppCommand::SetSetting` 的是**三个**键（标题栏三态还没有 UI 写者，D37 接线未落地）。
   两处数字与列举按 grep 到的实际代码改（`AppearanceBase` 的 `pub` 字段数 = 4；
   `on_appearance` 的 match 守卫 = WindowOpacity / PaletteSource / Corner）。
2. `pages/appearance/mod.rs:41` 的取证件模板补 `corner=`：`[appearance]` 行确实有这一栏，
   圆角还有一条独立管线 `[corner] <ctx> corner=policy=… source=… os=… excluded_reason=…
   radius=system pref=… readback=… read_hr=… frame=… layered=…`（取值形状取自探针实跑，
   见 corner/tests.rs 的格式单测），模板已按此补齐，并注明「看上去圆不圆」同样不可信。

门禁（`CARGO_TARGET_DIR=C:/Temp/ull-target/wt-116`, `-j 4`，退出码逐个落盘）：
check 0 / fmt --check 0 / `cargo test -p unlucky-app-iced --lib` 0（447 passed, 0 failed, 2 ignored）。
行数：appearance.rs 130、state.rs 343、pages/appearance/mod.rs 180（均 ≤400）。
 2026-11-05 06:35:18 +08:00
AskaEth 41746d1612 fix(app-iced): M116 r1 复审 —— 口径降级为「不承诺」、修掉伪造读数与两处错注释、圆角下发去重 
四条 P1（全是「口径与证据不符」，行为未变）：

1. 把「Win11 一定有系统圆角、边缘平滑」从事实降级：`corner.rs` 的平台矩阵改成
   「实测 / 解释 / 推断 / 未验」四列，并明写本机只测到「写入被接受 / 回读 E_INVALIDARG /
   无边框窗口没有 DWM 调整带」；设置页与 golden 的说明句改成「我们**请求**系统圆角，
   是否圆、边缘什么样由合成器决定」，不再承诺结果。
2. 删掉证据目录里那条伪造读数 `readback=2`：本机三种样式回读全是 `E_INVALIDARG`，
   该值物理上产不出来，也不可能由 `format_line` 产出。改成显式的「合成示例（非实测）」，
   并把每一栏标注成真实/示例来源。probe-table 的「没有一条是推断」标题一并拆开，
   结论 4/5 明确标为**解释**（并写明 Δframe 之差是样式位的同义反复，不能反推 DWM 决策）。
3. `keys.rs` 的「旧读新」语义按实际链路改写：1.4.0 读 1.5.0 文件走
   `SchemaCompat::check_url` → `ReadOnlyPreserveSchema` → `SchemaCompat::access` →
   `FileAccess::ReadOnly`，**整份配置只读**（值照读、`store.set` 报 `SettingError::ReadOnly`、
   `save` 跳过），不是「只是少一档」。
4. 两处错注释订正：
   - `hresult_ok` 的理由改成 `S_FALSE` 的通用语义，并明写 `0x7FF8FFA9` **不是** DWM 的返回值
     （本机实测是 `E_INVALIDARG 0x80070057`），那是我早期用 `unsigned_abs()` 打印 HRESULT 的产物；
     对应单测也把该常量标为「合成值，只用来钉规则」。
   - `DWMWA_VISIBLE_FRAME_BORDER_THICKNESS` 的文档改成「本机三样式三态实测全 1，不能当判据，
     仅作诊断读数」。

两条裁定：
- CPU 档在 Win11 仍走 DWM（tower 裁定保留）：理由写进 `plan_corner` 文档——D36 约束的是我们自己的
  渲染路径，DWM 圆角是合成器侧的，不增加我方负担；设置页说明同步加了「软件渲染也一样」。
- 「圆角窗口上拖边缩放仍命中」实测未做（RDP 断开、无指针注入手段）：mission 里以 note 记为 dropped
  （store 的 task_drop 对已完成任务不生效，工具层面无法取消勾选，已在 note 里写清）。

六条 P2：
1. probe-table 拆「实测 / 解释 / 未验」并删掉绝对化标题。
2. CPU 档裁定见上（任务书由 tower 侧调整）。
3. 拖边缩放任务记账更正见上。
4. **圆角下发去重**：新增 `corner::{CornerApplied, needs_redispatch}`（指纹 = 策略 / 来源 /
   原因码 / 有没有句柄，不含只有真下发才拿得到的读数），`App::apply_window_corner` 改成
   `&mut self` 并在判定未变时**直接返回**（不动窗口、不打日志）；`App` 新增 `corner_applied` 字段。
   新增测试 `the_same_policy_is_dispatched_only_once`：连续 20 次同策略只下发/记 1 次，
   换档与「首次拿到句柄」必须重下。
5. `dwm_get_rect` 的 `hr == 0` 改成 `hresult_ok(hr)`，「判据只有一处」名副其实。
6. 报告口径修正（诊断已产出、UI 接线待做——`SettingsBridge` 未暴露 doc，接线要改 presenter 的
   `settings_bridge.rs`，不在本 mission scope），本轮不动代码。

门禁：fmt --check exit 0；clippy（5 个 crate）--all-targets -D warnings 零 warning；
lib 测试 app-iced 419（+1 去重测试）/ core 266 / design 163 / i18n 24 / presenter 129 全绿；
改动文件仍全部 ≤400 行（最大 keys.rs 398）。
 2026-11-05 06:35:17 +08:00
AskaEth 25d860b2b3 refactor(app-iced): M116 把圆角单测搬出 corner.rs、日志行收敛到 format_line 
- `platform/win32/corner.rs` 从 413 行降到 200 行（AGENTS.md §3-1 的 400 行硬线）：
  单测搬到 `corner/tests.rs`。
- 日志行的**形状**收敛成一个纯函数 `corner::format_line(context, plan, policy, outcome, style)`，
  于是「`excluded_reason` 这一栏还在不在」不依赖真窗口也能被断言。
  新增 `the_log_line_shape_is_pinned_with_the_measured_readings`：用本机探针窗口的真实读数
  （Server 2025 / 26100、读回 E_INVALIDARG、frame=popup）逐字段钉死，
  并把 policy × 系统 × 渲染档四种 `excluded_reason`（none / user / os-build / cpu-tier / unknown-os）全覆盖。
- `set_layered` 补一段「这里是 GetLastError 的 DWORD 语义，`unsigned_abs()` 有意保留；
  DWM 那侧是 HRESULT 语义、必须 `as u32`」的注释 + 对应用例（tower 2026-11-03 裁定：两者不同源，不许统一）。

门禁：fmt --check ✓ / clippy -D warnings（5 个改动 crate）✓ /
lib 测试 core 266 + design 163 + i18n 24 + presenter 129 + app-iced 418 全绿。
 2026-11-05 06:35:03 +08:00
AskaEth 88dbf6d955 feat(app-iced): M116 窗口外框圆角策略（跟随系统/直角）+ DWM 读写的受控对照实验 
用户问「为什么窗口没有圆角」。核实：组件层圆角齐，但窗口外框**零处理**——代码里没有任何
Dwm* / SetWindowRgn。本 mission 先做实测，再按平台分开落策略。

判据（纯函数、可真值表）：
- `platform::plan_corner(策略 × 系统版本 × 渲染档)` → `source=dwm|square` + `excluded_reason`。
  Win11 / Server 2025（build ≥ 22000）→ DWM；Win10 及更早 → 直角（不做 SetWindowRgn 毛边默认）；
  探测不到版本（macOS / X11 / Wayland）→ 直角 + `unknown-os`（「不承诺」而不是「做不到」）。
  CPU 档在 Win11 上照样用 DWM（D36 限制的是我们自己的合成技巧，不是系统合成器）。

落点：`platform/win32/transparency.rs` 仍是全仓唯一 unsafe 文件，新增 DWM 的 FFI 与安全包装；
`alpha.rs` / `dwm.rs` / `probe.rs` 三个新子模块零 unsafe、零 extern（沿 exstyle.rs 的既有形状）。

实测（本机 Server 2025 build 26100、RDP 会话断开、同进程三窗口对照）：
- `DwmSetWindowAttribute(DWMWA_WINDOW_CORNER_PREFERENCE)` 在 WS_OVERLAPPEDWINDOW / WS_POPUP /
  WS_POPUP|WS_EX_LAYERED(α=0.8) 上**全部成功** ⇒ 无边框与整窗 α 不会让属性设不上；
- `DwmGetWindowAttribute` 同一属性三种样式**全部 E_INVALIDARG** ⇒ 本机不支持回读，与样式无关；
- `DWMWA_EXTENDED_FRAME_BOUNDS − GetWindowRect`：有边框 = +0,−7，popup = +0,+0
  ⇒ DWM 只给有边框窗口加不可见调整带，我们的窗口没有可画的圆角区域（结构性解释）。
- 像素（角上透明/方块）**未验**：RDP 断连导致 CopyFromScreen / gdigrab 全废。

同时修掉一个自己踩到的判据错误：`i32::unsigned_abs()` 不能用来打印 HRESULT
（E_INVALIDARG 0x80070057 会被印成 0x7FF8FFA9）。现在 HRESULT 用 `hr as u32` + 严重性位，
GetLastError 的 DWORD 语义保持 `unsigned_abs` 并写死注释（两者不同源，别统一）。

配置：新键 `appearance.window_corner ∈ {system, square}`（出厂 system），schema 1.5.0 只推 minor、
不写迁移：老文件缺键 = 取默认 = 跟随系统；旧版本读新文件时未知键被登记并原样写回（`RenderMode::Full`），
只在显式 `store.set` 该键时才 `UnknownKey`。

设置 UI：外观组只留两档（跟随系统 / 直角）+ 一句按平台说清的说明，文案走 i18n 中英。
日志：`[corner] <ctx> corner=policy=… source=… os=… excluded_reason=… radius=system pref=… readback=… frame=… layered=…`
（形状由 `corner::format_line` 的格式化单测钉住，用探针窗口真实读数构造）。

证据：DevDocs/artifacts/m116/{README.md,probe-table.md}
 2026-11-05 06:35:03 +08:00
AskaEth 0fdc889af6 refactor(presenter): M114 rebase 后守 400 行 —— 实时日志滚动窗口搬进 state/live.rs（纯搬移） 2026-11-05 05:37:43 +08:00