AskaEth/Unlucky-Launcher
1
0 Fork 0
Code Issues Pull Requests Actions 4 Packages Projects Releases Wiki Activity
183 Commits 3 Branches 4 Tags
5c40c64b5f92f6a5f922a3f4b598c290889b95db
Commit Graph
11 Commits
Author SHA1 Message Date
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