AskaEth/Unlucky-Launcher
1
0 Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity
724 Commits 3 Branches 6 Tags
a17f6fb29fe5ace4849324540bdcef7180e512ca
Commit Graph
14 Commits
Author SHA1 Message Date
AskaEth 15309394ac docs(design): M228 复审 r2 两处文档口径（Ink 矩阵上限、测试指针） 
P2-1 统一全矩阵口径：palette/visibility.rs 实测表 Ink 行第二列「1.54 ~ 12.13」是旧的「对
surface-container-highest 单一层」量法，改成 4×5 全矩阵（4 个状态容器 × 5 个容器层）的上限
**16.47**（primary-container 压 surface-container-lowest），下限 1.54（secondary-container 压
highest）不变——Silver 行本来就是全矩阵（1.02 ~ 1.80），现在两行同口径。表头补「4×5 全矩阵」
说明，避免下次又被按单层读。

P2-2 修正失效指针：visibility.rs 模块文档的「实测」小节把测试指向
`tests/ink_cat_boards.rs`，但容器层可视性那几条在 r1 返工时已搬到
`tests/ink_cat_visibility.rs` —— 改指后者。boards/mod.rs:42 的「26 组文字/图标对
（tests/ink_cat_boards.rs）」仍正确，未动。

纯文档两行，无数值/代码变更。fmt --all --check=0；test -p unlucky-design --all-targets=0
（267 passed = 186 lib + 81 集成；ink_cat_boards 7 / ink_cat_visibility 4 / ink_cat_geometry 3）。
 2026-11-10 22:34:05 +08:00
AskaEth b8003177d7 fix(design): M228 复审 r1 三条（字段底角色对齐、四处小疵、产品默认口径） 
P2-1 字段底角色不对称（塔裁决方案 a）：Silver 的 #dcddde 从 surface-container-high 改判到
surface-container-highest，与 Ink 的 #262b25 同位——component_map 的 TextField 口径就是最高
容器层，单一角色接法才不会一边掉层。Silver 的 high 改取推导值 #e4e4e5（tone 90），阶梯
94.12 → 90.61 → 88.07 保持单调、步长 ≥1.74 L*。实测：Error on 新 highest = 4.686（原按单一
角色接到 high 时的 4.379 失守已消除）、OnSurfaceVariant = 6.383、OnSurface = 12.576。
测试同步：Silver 三条字段用法 pin 从 high 改 highest（与 Ink 对称），并新增
`field_backdrop_is_the_same_role_on_both_boards` 把这个不对称钉住（顺带断言 high 比 highest
更亮、highest 就是规格卡的 #dcddde）。

P2-2 四处小疵：
① inkcat/size.rs 扩展 FAB 起始内距 16 → **28**（规格卡画的数）：框 x=292 → 图标盒 320（`+`
   font-size 24 居中于 x=332），28 才是图上的距离；16 是 M3 官方口径，已在 doc 里登记为偏离，
  并说明「要回 M3 的 16 得同时把图标中心挪回 316，那是要出截图的视觉改动」。测试补一条自洽
   断言：292 + 28 + 24/2 = 332。
② inkcat/metrics.rs 的 SWITCH_THUMB_INSET 注释重写（原句断成碎片且读起来像算错）：写明
   轨道 y=1060..1092 / 拇指 y=1064..1088 ⇒ 上下各 4、右端 116−112=4，以及行程
   52−24−2×4 = 20 的推导。
③ Silver「状态容器 / 容器层」数字统一成实测口径：boards/mod.rs 与 palette/visibility.rs 都写
   「最低 1.02」（Ink 1.54），并点名最差的一组是 tertiary-container 压 surface-container-high
   = 1.016；visibility 表的 Silver 阶梯步长改写 −1.7 ~ −4.1。
④ inkcat/type_scale.rs 正文清单只列 11 个**文字**字号（去掉 FAB 字形 20/26/34），并注明那三个
   归 FabSize::icon_px、SpecText 没有 20 这一档。

P2-3 产品默认口径统一：palettes.rs 的「两个入口」表与 Palettes::baseline 文档、color/mod.rs
的「出厂默认色」小节、Scheme::baseline 文档统一写明「M228 起出厂外观入口是
DesignTokens::brand，本入口是 D38 取色链中性锚点」，与 lib.rs 同口径；顺带把 BASELINE_SEED /
DEFAULT_SEED / DEFAULT_NEUTRAL_CHROMA 的「产品默认」措辞改成取色链口径。

另：tests/ink_cat_boards.rs 已 400 行贴线，把 4 条容器层可视性测试拆到新文件
tests/ink_cat_visibility.rs（纯搬移 + 补 import）；palettes.rs 因新增口径说明到 403 行，按
「合并相邻段落、不删信息」压回 399 行；size.rs 现在 323 行。

五步（design 口径）：fmt --all --check=0；check -p unlucky-design --all-targets=0（零 warning）；
test -p unlucky-design --all-targets=0（267 passed）；clippy -p unlucky-design --all-targets
-- -D warnings=0；400 行扫描只剩 README.md（豁免）、无 <2 字节 .rs。
 2026-11-10 22:34:05 +08:00
AskaEth 0169d4c8fb feat(design): 加 Ink/Silver 双主题色板 + 规格卡几何与字号令牌（M228） 
规格卡 DevDocs/artifacts/components-ink.svg 的令牌化，只动 crates/design，零依赖不变。

- color::boards：BrandBoard（Ink 深 / Silver 浅）→ 49 角色 × 2 套固化色板。
  spec 直写值进 ANCHORS（测试逐条比 hex，规格卡改了代码不改会红）；规格卡没给的
  角色按「同色相 + M3 tone 关系」推导后固化，规则写在 boards/ink.rs 的行注释里。
  Scheme::from_board / DesignTokens::brand 是两个新入口；Scheme::baseline 一字未改
  （它是 D38 取色链的中性锚点，改它等于同时改 app-iced 观感 + 取色语义）。
- palette::visibility：容器层可视性裁决，即债务台账「SecondaryContainer 对 Surface
  仅 1.06」的令牌层结论。状态容器（*-container）对 surface ≥1.20:1 是唯一数字门禁；
  容器层之间不设亮度门禁，改为「选中态 = 容器底 + 文字对比 + 形状/图标」三件套的构成
  要求（浅色板实测 1.05~1.24，任何有意义的门禁都过不了，详情见模块文档实测表）。
- inkcat：规格卡的尺寸与形状数据。ControlSize（按钮 XS~XL = 32/40/56/96/136，圆角
  一律半高）、FabSize（40/56/80/160×56，圆角 12/16/20/16）、控件方框（卡片 16、
  对话框 28、snackbar 52@16、列表行 60 药丸、chip 32@8、字段 4/28 + 内距 16/32、
  复选 18@4、单选 18、开关 52×32 + 拇指 24、进度 4/6）、SpecText（规格卡 11 个字号
  → 命中 / 落档 / 低于 11px 下限三类结论）。
  component_map 的表值一处未动：app-iced 的 pages/frame/tests.rs:42 与 shell/tests.rs:30
  按 Medium(12) pin 住卡片，改表等于连带改观感且破坏既有断言；差异在 inkcat 模块文档
  逐条登记，换肤时由 M229 一次切换 + 截图验收。
- 测试：186 lib（+13 条新单测）+ tests/ink_cat_boards.rs（10 条：完整性/锚点/双主题
  切换/26 对 WCAG AA/25 组规格卡用法/状态容器 1.2 门禁/阶梯单调）+ tests/ink_cat_geometry.rs
  （3 条：按钮 FAB 几何、控件圆角、字号校核）。
 2026-11-10 22:34:05 +08:00
AskaEth 4b059201fd fix(design): 中性色相常量改容差断言 + 取色接线注释指向真正的守护测试（复审 r1 p2） 
- `palettes.rs::neutral_hue_is_the_default_seed_hue`：`to_bits()` 位相等 → 1e-9° 容差。
  色相来自 `atan2(a).to_degrees()`，`NEUTRAL_HUE_DEG` 的字面值是在 Windows(UCRT) 上取的，
  CI 的 ubuntu(glibc) 理论上可差 1 ulp 就让位相等在另一个 OS 上红；而这条要抓的是「换了
  `DEFAULT_SEED` 却没复核常量」（偏几十度），1e-9° 足够且不受平台末位差影响。
  `tests/card_neutral.rs::sky_card_is_bit_identical_to_the_product_baseline` 是**同平台内**
  两个算出来的值互比，继续用位相等（p1 硬约束的钉子，不动）。
  常量文档同步说明「为什么不用 `to_bits`」。
- `resolve/mod.rs` 取色分支的注释：原来只写「`tests/card_neutral.rs` 有反证」，而那条用例
  测的是 `Seed::scheme` 生成器层、覆盖不到这里（复审 r1 p1-1 的病根）。改成点名
  `resolved_image_scheme_keeps_tinting_from_the_seed`——走的就是本函数的公开入口。

`palettes.rs` 仍是 400 行（本轮改 doc 同时压缩了相邻说明，没突破上限）。
 2026-11-02 13:12:43 +08:00
AskaEth de9d5337ac feat(design): 内置色卡改用固定中性色相，切卡只换强调色（D43） 
色卡路径原先走 TonalSpot「中性色也跟种子染色」，八张卡的中性色相 = 种子色相，
浅色档 surface 的实测 CAM16 彩度从 1.29（rose）跨到 12.03（teal）——tone 98 处
暖相色域装不下彩度 12，同一个请求值在暖相上只兑现 1.29。9 倍的底色跳变让用户在
设置页逐张试色时觉得「每张卡都像换了个应用」。

- `color::palettes::NEUTRAL_HUE_DEG`（新常量）= 出厂默认种子 `#3C8DBC` 的 CAM16
  色相 239.51420577630955°，出处与「换默认色时要复核什么」写在常量文档里；
  `neutral_hue_is_the_default_seed_hue` 用位相等钉住它与 `DEFAULT_SEED` 的绑定。
- `Palettes::accent_on_fixed_neutral(accent, neutral_hue, neutral_chroma)`：强调三族
  跟 accent 色相，中性两族固定在给定色相；其余常数（36/16/24/25°/84、tone 表、
  gamut 映射）一行未动。私有 `tonal_spot_with_neutral` 承载实现，`tonal_spot` 只是
  它的「中性色相 = 种子色相」特例。
- `Card::scheme` 改走上述入口（`NEUTRAL_HUE_DEG` + 卡自己的中性彩度）。默认档天蓝的
  49 个角色**逐值不变**（固定在等于它自己中性色相的那个值上，属「沿用」而非「另选」）。
- 动态取色路径**刻意不动**：`resolve::try_level` 仍按图像种子逐色染色、只借色卡的中性
  彩度定浓淡；两处注释都写明「两条路径不同，别统一处理」。
- 订正 `palette/card.rs` 的模块文档：原文把「请求值相同」当成「观感相同」，现在改成
  可直接当契约读的三条（表面与描边八卡逐值相同 / 只有强调族跟卡走 / 天蓝卡 == baseline）。

门禁：fmt 干净、clippy -D warnings 通过、`cargo test -p unlucky-design` 全绿、
`cargo tree -p unlucky-design --edges normal` 仍是单行（零第三方依赖）。
 2026-11-02 13:12:41 +08:00
AskaEth 8be91a9cc9 docs(design)+test(palette-extract): 修正「种子一定是原图真实颜色」的过度承诺 
自测发现：400×400 红蓝棋盘在 MAX_EDGE=256（适配层 thumbnail 缩放）与 512（design 块平均）
下都取到 #704070，都不在原图上——「≤MAX_SAMPLES ⇒ 真实颜色」只对「传进 analyze_rgba 的
那个缓冲」成立，不是整条链的性质。
- Seed::color 文档写明边界 + 上游缩放同样会破坏该性质（附实测例）
- 结构性断言的注释/断言文案改为「design 不再叠第二层块平均」，不再声称能保住真实颜色
 2026-11-02 11:05:06 +08:00
AskaEth 09b716ae79 docs(design)+test(palette-extract): r2 三条口径修正与常数绑定 
- LowChroma 文档：删掉「彩度必然 < 候选门槛 5」（人气门槛也会淘汰高彩度小面积，
  实测 0.5% 纯红报 113.36），改为与契约文档 §6 一致的口径；代码臂注释与 score::most_chromatic 同步
- Seed::color / share 改成有边界的说法：≤MAX_SAMPLES 才是图上真实色、share 的分母是有效采样点
- palette-extract 新增 max_edge_stays_within_the_design_sample_budget：
  MAX_EDGE² ≤ MAX_SAMPLES（256² 当前余量为零，调大就红）
- card.rs：把 6.43~6.50 / 7.70~7.76 写成断言（原来只有 ≥4.5 下限，文档却宣称区间）
- LowChroma.color 字段注释改成「最接近可用的候选色」（113 那条并不「能用」）
 2026-11-02 11:05:03 +08:00
AskaEth f4c48752c2 fix(design): Outcome::NotReached / 色相环回绕断言 / LowChroma 口径统一 / 文档指向（复审 r1 p2-4 + 色彩 r1 p2-2/3/4） 
- Outcome 新增 NotReached：区分「用户没提供」与「更高级成功所以没轮到」，
  UI 不会再对着用户已选的卡说「色卡：未选择」；新增 not_reached_is_distinguishable_from_not_provided
- cards_are_visually_distinct 补色相环回绕间隔（原来只比排序相邻差，350° 的卡会静默通过）
- Failure::LowChroma 的 color 与 chroma 现在永远来自同一个簇（原来一条路径拿 A 簇的色值配 B 簇的彩度）；
  两条路径的口径写进文档注释，并提醒 UI 别把数字写成「彩度 X < 门槛 8」
- card.rs：测试名指向修正（card_keys_are_stable_and_unique，测试就在本文件）、
  「对比度 8.4:1」的假示例换成实测区间（light 6.43~6.49 / dark 7.70~7.75）、
  中性彩度那段补上「请求值相同 ≠ 实际表面同冷度」的事实与 D43 去向
 2026-11-02 11:05:02 +08:00
AskaEth 948a3685cd test(design): 钉住 D40 的彩度门槛 8（复审 r1 p2-3） 
MIN_SEED_CHROMA 8.0 → 6.0 的变异原本全绿（那条断言比的是常量自己）。
新增两条用实测 chroma≈7.23 的灰蓝（#7E8489）：
- seed::tests::chroma_just_below_the_gate_is_rejected（门槛之上/之下夹住）
- resolve::tests::faint_colour_falls_back_to_the_selected_card（回落 + 落点是选中卡 + 方案逐值等于该卡）
顺带把 resolve 的单测拆到 resolve/tests.rs（400 行上限）
 2026-11-02 11:05:01 +08:00
AskaEth 2ce394fbfc fix(design): 混合透明度不再被误判为「全透明」（复审 r1 p2-1） 
先按 alpha 过滤像素、再做块平均（整块全透明则跳过）。原实现先平均再比门槛，
块内 255 与 0 的整数除法得 127 < 128 → 512×512 里 131072 个不透明像素被报
NoOpaquePixels，UI 会告诉用户「背景图几乎全透明」，与事实相反。
- 新增 half_transparent_image_keeps_its_opaque_colour（红）
- 新增 mostly_transparent_image_still_samples_the_visible_part
- 模块文档加一行「混合透明度」的处置与踩坑说明
 2026-11-02 11:04:59 +08:00
AskaEth 36c1cce00d test(design): 补「先量化再打分」的端到端反证（复审 r1 p1） 
reviewer 实测变异：把 analyze_rgba 改成不透明像素算术平均，150 个测试全绿——
因为反证只测了 quantize/score 中间层，接线没人覆盖。新增：
- seed::tests::end_to_end_picks_the_five_percent_accent（95% 米白 + 5% 珊瑚 → #FF6B5A）
- seed::tests::end_to_end_picks_the_three_percent_accent（97/3 → #FF8800）
- resolve::tests::a_five_percent_accent_drives_level_one（一级成功、种子是珊瑚、≠ 回落色卡）
顺带把 seed 的单测拆到 seed/tests.rs（410 行 → 220 + 190，恢复 ≤400 纪律）
 2026-11-02 11:04:58 +08:00
AskaEth 80314f4830 docs(design): hint_key 的文案映射表搬进 provenance.rs 的文档注释 
DevDocs/ 是 gitignore 的本地文档，契约里的「键 → 文案」表review 时看不到，
所以在 hint_key 的 rustdoc 里放同样一张表（差异只有措辞建议，结构一致）。
 2026-11-02 11:04:57 +08:00
AskaEth 31ee69100a refactor(design): resolve 拆成目录模块（单文件 ≤400 行），同步文档口径 
- palette/resolve/{mod.rs,provenance.rs}：编排函数与 Provenance 类型分开，路径不变
- color/mod.rs + palettes.rs：原来的「取色/色卡库不在本 crate、还没实现」改成指向 crate::palette
- 取色 gap 登记改为「单种子已实现，多 source 色仍未实现」
 2026-11-02 11:04:55 +08:00
AskaEth 18327fb038 feat(design): 配色来源纯数学层（Monet 式量化取色 + 色卡 + 三级回落 + 对比度收敛） 
D40 分层：design 保持零第三方依赖，只吃已解码的 RGBA 像素。
- palette/quantize：5bit 直方图 + CIELAB k-means（QuantizerCelebi/Score 的形状）
- palette/score：官方 Score 口径（CUTOFF_CHROMA 5 / TARGET 48 / 权重 0.7+0.3）
- palette/seed：seed_from_rgba + D40 彩度门槛 8，灰白图回落而非凭空上色
- palette/card：8 张内置色卡，key 为持久化键
- palette/wcag：26 对文字对比度门禁 + 沿 tone 轴收敛并记录修正
- palette/resolve：纯函数三级来源编排 + Provenance（原因码/提示键）
 2026-11-02 11:04:10 +08:00