test(design): 钉住 D43 的固定中性色相(八卡同底色 / 天蓝不动 / 动态路径不退化)

`tests/card_neutral.rs`(新文件,8 条用例):

1. `sky_card_is_bit_identical_to_the_product_baseline`:默认档天蓝的 49 个角色 ==
   `Scheme::baseline`,两套模式逐值相等(M88 的 p1 级硬约束)。
2. `preset_cards_share_one_neutral_hue_and_chroma`:八张卡 surface 的 CAM16 色相
   一致(±1°)、实测彩度落在 ±1.5 带宽内,且更强的一条——八张卡的 surface 是同一个
   hex(实测差 0.00° / 0.00)。
3. `the_old_per_card_tinting_really_was_a_ninefold_gap`:反证,证明上面的带宽量得出
   问题——改前浅色档彩度差 9.3 倍(rose 1.29 / teal 12.03),改后 1.0 倍;深色档改前
   彩度本来就一致(tone 6 装得下 12),问题在色相横跨 285°,改后色相跨度 0。
4. `cards_only_change_the_accent_families`:强调族不靠手抄清单,而是实测「换强调色会
   变的角色」(深色 26 个 / 浅色 23 个——浅色 on-primary/secondary/tertiary 的 tone 是
   100,任何色相都是纯白),其余角色必须逐值留在基线。
5. `card_scheme_matches_from_accent_when_chroma_is_the_default`:色卡方案 ==
   `Scheme::from_accent(卡种子)`,把 D43 接到 `tests/official_accent.rs` 的官方对账上。
6. `image_scheme_ignores_the_preset_neutral_hue`:动态路径的守护测试——同一张图在 sky /
   teal 卡下强调色相同,中性调色板色相来自图像种子(精确口径查 `Palettes::neutral`,
   另加一条观感口径),且远离 `NEUTRAL_HUE_DEG`;谁把取色也改成固定中性就会红。
7. `every_card_scheme_meets_wcag_aa_under_the_fixed_neutral`:8 卡 × 浅/深 × 26 对全部
   ≥ 4.5:1(`palette::wcag::check` 全表),并把 on-surface/surface 钉在实测量级。
8. `dump_card_palette_for_the_color_card`:出图数据(`CARD|…` 行,改前/改后并排),
   渲染脚本只做排版。

实测:8 卡 surface 改前 `#EBFEF8`~`#FFF8F4`(浅)/`#061613`~`#1F0F10`(深)→ 改后统一
`#F6FAFF` / `#09151C`;全表最差比值浅 5.44 / 深 4.98,均远高于 AA 的 4.5。

门禁:`cargo test -p unlucky-design` 231 条全绿(216+5 doc → 226+5 doc,+10 条增量:
本文件 8 条 + `color::palettes` 2 条)。
This commit is contained in:
AskaEth committed 2026-11-02 13:12:42 +08:00
1 parent de9d5337ac
commit b748986aae
1 file changed
+399
+399
View File
@@ -0,0 +1,399 @@
//! D43:内置色卡的**固定中性色相**——切卡只换强调色,窗口底色的冷暖不跟着换。
//!
//! ## 这条测试要钉住的四件事
//!
//! 1. **天蓝卡(出厂默认)逐值不变**:固定的中性色相等于天蓝档的中性色相,所以天蓝卡必须与
//! [`Scheme::baseline`] 的 49 个角色**逐个相等**(M70 定案的不动点,p1 级硬约束)。
//! 2. **八张卡的表面色完全相同**:`surface` 的 CAM16 色相一致(±1°)、实测彩度落在窄带内
//! (±1.5),且改前那条「9 倍差」被同时量出来当反证(见 `the_old_per_card_tinting...`)。
//! 3. **动态路径不许被顺手改成固定中性**:同一张图在两张不同卡下必须生成**同一套强调色**,
//! 而底色由图像种子的色相决定(Monet 体验,D38)。
//! 4. **WCAG 不因换中性色相而掉档**:8 张卡 × 浅/深两套 × 26 对文字/图标对全部 ≥ 4.5:1。
//!
//! ## 实测表(2026-11,本文件 `dump_card_palette_for_the_color_card` 的输出)
//!
//! | 卡 | 改前 `surface`(浅) | 改后 `surface`(浅) | 改前 HCT(浅) | 改后 HCT(浅) |
//! |---|---|---|---|---|
//! | sky | `#F6FAFF` | `#F6FAFF` | 236.86° / 6.41 | 236.86° / 6.41 |
//! | lavender | `#FDF7FF` | `#F6FAFF` | 298.10° / 5.87 | 236.86° / 6.41 |
//! | forest | `#EEFDEE` | `#F6FAFF` | 157.01° / 11.77 | 236.86° / 6.41 |
//! | amber | `#FFF8F4` | `#F6FAFF` | 71.48° / 1.89 | 236.86° / 6.41 |
//! | rose | `#FFF8F7` | `#F6FAFF` | 22.09° / 1.29 | 236.86° / 6.41 |
//! | teal | `#EBFEF8` | `#F6FAFF` | 182.42° / 12.03 | 236.86° / 6.41 |
//! | dusk | `#FBF8FF` | `#F6FAFF` | 280.31° / 5.44 | 236.86° / 6.41 |
//! | olive | `#F9FBE1` | `#F6FAFF` | 120.99° / 11.84 | 236.86° / 6.41 |
//!
//! 深色档同理:改前 `#09151C`~`#1F0F10`、彩度 11.63~12.45,改后八张卡统一 `#09151C`
//! (235.70° / 11.70)。
//!
//! ## 为什么容差是这个带宽(不是随手取整)
//!
//! - **色相 ±1°**:八张卡现在共用一个中性调色板,`surface` 是**同一个 hex**,跨卡差实测 0.00°。
//! 容差留 1° 是为了挡住「将来某张卡偷偷换回 TonalSpot」——那种回退的最小偏离是 **43°**
//! (dusk 280.31° vs 236.86°),1° 的带宽足以把 0 与 43° 分开,同时不误报 8 bit 量化。
//! - **彩度 ±1.5(CAM16,单位与请求值 12 同刻度)**:tone 98 的 8 bit 量化会把「请求 12」
//! 读回成 6.41(浅)/11.70(深),这层压缩是**同一个 hex 的常数偏移**,跨卡比较时抵消;
//! 真正的危险是暖相回退——rose 1.29、amber 1.89,比基线低 4.5~5.1,远超 1.5 的带宽;
//! 紫相(lavender 5.87)只低 0.54,靠上面的色相断言抓(298° 偏 61°)。带宽取 1.5 = 请求
//! 彩度的 1/8,比「改前最小的一张卡偏离基线」还小,所以「9 倍差回来了」一定红。
use unlucky_design::color::{
Hct, Role, Scheme, SchemeFlavor, DEFAULT_NEUTRAL_CHROMA, NEUTRAL_HUE_DEG,
};
use unlucky_design::palette::card::card_scheme_is_readable;
use unlucky_design::palette::{Card, CardKey, CARDS, DEFAULT_CARD, TEXT_PAIRS};
/// 改前的路径(M87 及之前):中性调色板跟着种子染色(官方 TonalSpot)。
///
/// 产品代码已经不用它了,但公开 API 仍在(取色路径就靠它逐色染色),所以这里能原样复现「改前」。
fn before_d43(card: Card, flavor: SchemeFlavor) -> Scheme {
Scheme::from_palettes(
&unlucky_design::color::Palettes::from_seed_with_neutral_chroma(
card.seed,
card.neutral_chroma,
),
flavor,
)
}
fn flavors() -> [SchemeFlavor; 2] {
[SchemeFlavor::Light, SchemeFlavor::Dark]
}
/// 色相环上的最短距离(度)。
fn hue_gap(a: f64, b: f64) -> f64 {
let raw = (a - b).abs();
raw.min(360.0 - raw)
}
/// 天蓝卡就是产品默认色:固定的中性色相**沿用**它,所以 49 个角色必须一位不差。
///
/// 这条是 M88 的 p1 级硬约束。它红了只说明一件事:把「沿用天蓝的中性」实现成了「另选一个中性」。
#[test]
fn sky_card_is_bit_identical_to_the_product_baseline() {
for flavor in flavors() {
let baseline = Scheme::baseline(flavor);
let sky = DEFAULT_CARD.scheme(flavor);
for (role, got) in sky.iter() {
assert_eq!(
got,
baseline.get(role),
"天蓝卡(出厂默认)的 {} / {} 变了:{} → {}",
role.name(),
flavor.name(),
baseline.get(role).to_hex(),
got.to_hex()
);
}
}
}
/// 八张卡的 `surface` 共用同一个中性调色板:色相一致(±1°)、彩度落在窄带(±1.5)。
#[test]
fn preset_cards_share_one_neutral_hue_and_chroma() {
for flavor in flavors() {
let hcts: Vec<(&str, Hct)> = CARDS
.iter()
.map(|card| {
(
card.key,
Hct::from_color(card.scheme(flavor).get(Role::Surface)),
)
})
.collect();
let reference = hcts[0].1;
for (key, hct) in &hcts {
assert!(
hue_gap(hct.hue, reference.hue) <= 1.0,
"{key} / {} 的 surface 色相 {:.2}° 偏离基线 {:.2}° 超过 ±1°",
flavor.name(),
hct.hue,
reference.hue
);
assert!(
(hct.chroma - reference.chroma).abs() <= 1.5,
"{key} / {} 的 surface 实测彩度 {:.2} 偏离基线 {:.2} 超过 ±1.5",
flavor.name(),
hct.chroma,
reference.chroma
);
}
// 更强的口径:八张卡的 surface 是**同一个色值**(不只是「相近」)。
let surfaces: Vec<String> = CARDS
.iter()
.map(|card| card.scheme(flavor).get(Role::Surface).to_hex())
.collect();
assert!(
surfaces.iter().all(|hex| hex == &surfaces[0]),
"{} 模式下八张卡的 surface 不再逐值相同:{surfaces:?}",
flavor.name()
);
}
}
/// 反证:上面那条断言**量得出**问题。改前的路径浅色档彩度差 9 倍,改成固定中性后只剩 1 倍。
///
/// 没有这条的话,「±1.5 的带宽」只是一句自我声明:谁把断言写松(比如改成 ±20),
/// `preset_cards_share_one_neutral_hue_and_chroma` 照样绿,而窗口又开始逐卡染色。
///
/// ⚠️ **9 倍差只出现在浅色档**:tone 98(近白)的暖相色域装不下彩度 12,rose 只兑现到 1.29;
/// 深色档的 tone 6 反而每张卡都装得下(11.63~12.45,只差 1.07 倍)。深色档的问题不是彩度,
/// 而是**色相**(14.66°~300.57°,整整一个色环)——它在深底上表现为「有的卡偏紫、有的偏绿」。
/// 所以两个模式的反证分开断言,别用一条 `> 8` 覆盖两个模式(那样深色档会红,且说不清为什么)。
#[test]
fn the_old_per_card_tinting_really_was_a_ninefold_gap() {
let surface_hct = |scheme: &dyn Fn(Card) -> Scheme| {
CARDS
.iter()
.map(|card| Hct::from_color(scheme(*card).get(Role::Surface)))
.collect::<Vec<_>>()
};
let chroma_ratio = |hcts: &[Hct]| {
let max = hcts.iter().map(|h| h.chroma).fold(f64::MIN, f64::max);
let min = hcts.iter().map(|h| h.chroma).fold(f64::MAX, f64::min);
max / min
};
let hue_span = |hcts: &[Hct]| {
// 色相是环:这里只关心「跨了多少」,用最大凸包跨度(简单排序后首尾差)就够粗判。
let mut hues: Vec<f64> = hcts.iter().map(|h| h.hue).collect();
hues.sort_by(|a, b| a.partial_cmp(b).expect("有限色相"));
hues[hues.len() - 1] - hues[0]
};
// 浅色档:彩度 9 倍差(改前)→ 1 倍(改后)。
let old_light = surface_hct(&|card| before_d43(card, SchemeFlavor::Light));
assert!(
chroma_ratio(&old_light) > 8.0,
"改前(浅色)的 surface 彩度差应当能量出「9 倍级」跳变,实测 {:.2} 倍——\
这条反证已经失效,上面的 ±1.5 带宽就不可信了",
chroma_ratio(&old_light)
);
let new_light = surface_hct(&|card| card.scheme(SchemeFlavor::Light));
assert!(
chroma_ratio(&new_light) < 1.5,
"固定中性后(浅色)八张卡的 surface 彩度差还有 {:.2} 倍",
chroma_ratio(&new_light)
);
// 深色档:彩度本来就一致,问题是色相跨了整个环 → 改后色相跨度收敛到 0。
let old_dark = surface_hct(&|card| before_d43(card, SchemeFlavor::Dark));
assert!(
hue_span(&old_dark) > 180.0,
"改前(深色)的 surface 色相应当横跨大半个色环,实测 {:.2}°",
hue_span(&old_dark)
);
assert!(
chroma_ratio(&old_dark) < 1.5,
"改前(深色)的彩度本来就一致(tone 6 装得下彩度 12),实测 {:.2} 倍",
chroma_ratio(&old_dark)
);
let new_dark = surface_hct(&|card| card.scheme(SchemeFlavor::Dark));
assert!(
hue_span(&new_dark) < 1.0,
"改后(深色)色相跨度 {:.2}°",
hue_span(&new_dark)
);
assert!(chroma_ratio(&new_dark) < 1.5);
}
/// 换卡只换强调族:不随强调色变的角色必须逐值相同,强调族必须真的换。
///
/// 「哪些角色属于强调族」不靠手抄清单,而是**实测**:拿另一个强调色再生成一套方案,值会变的
/// 那些角色就是强调族(primary/secondary/tertiary 全族 + `surface-tint` + `inverse-primary` +
/// 12 个 `*-fixed*` = 26 个),不随强调色变的 23 个(中性表面、描边、error、shadow/scrim)
/// 则必须留在基线——这样将来往 tone 表里加角色也不会漏掉分类。
///
/// ⚠️ 浅色档只有 **23** 个会变:`on-primary` / `on-secondary` / `on-tertiary` 的 tone 是 100,
/// 任何色相都解析成纯白,所以强调色换了它们也不变(深色档的 tone 是 20,会变)。
#[test]
fn cards_only_change_the_accent_families() {
for flavor in flavors() {
let baseline = Scheme::baseline(flavor);
let recolored = Scheme::from_accent(flavor, CardKey::Teal.card().seed);
let (mut accent_roles, mut neutral_roles) = (Vec::new(), Vec::new());
for role in Role::ALL {
if recolored.get(role) == baseline.get(role) {
neutral_roles.push(role);
} else {
accent_roles.push(role);
}
}
assert_eq!(
(accent_roles.len(), neutral_roles.len()),
if flavor.is_dark() { (26, 23) } else { (23, 26) },
"强调族 / 中性族的划分变了({} 模式下换强调色会动 {} 个)",
flavor.name(),
accent_roles.len()
);
let sky = DEFAULT_CARD.scheme(flavor);
for card in CARDS {
let scheme = card.scheme(flavor);
for role in &neutral_roles {
assert_eq!(
scheme.get(*role),
sky.get(*role),
"{} / {} 的 {}(不随强调色变的角色)不该跟着卡变",
card.key,
flavor.name(),
role.name()
);
}
if card.key != DEFAULT_CARD.key {
assert_ne!(
scheme.get(Role::Primary),
sky.get(Role::Primary),
"{} / {} 的主色与天蓝卡相同:卡没生效",
card.key,
flavor.name()
);
}
}
}
}
/// 卡方案 = 用该卡种子做「自定义强调色」:中性表面留在基线,强调族与官方 `from_seed` 对得上。
///
/// 这条把 D43 接到已有的 `tests/official_accent.rs`(192 项官方对账)上:色卡的强调族不是
/// 另一套算法,就是那条已经对过账的路径。
#[test]
fn card_scheme_matches_from_accent_when_chroma_is_the_default() {
for card in CARDS {
if card.neutral_chroma != DEFAULT_NEUTRAL_CHROMA {
continue; // 将来的卡可以带别的中性彩度;那时它的表面色与 baseline 不同是有意的
}
for flavor in flavors() {
assert_eq!(
card.scheme(flavor),
Scheme::from_accent(flavor, card.seed),
"{} / {} 的色卡方案与 from_accent 不一致",
card.key,
flavor.name()
);
}
}
}
/// 动态路径的守护测试(D38/D43):同一张图,**两张不同色卡下强调色相同、底色由图像 seed 决定**。
///
/// 谁把取色路径也改成固定中性,这条立刻红:那时两张卡的 `surface` 会变成同一个冷白色,
/// 而图像种子的色相(红相 ~22°)会从表面色上消失。
#[test]
fn image_scheme_ignores_the_preset_neutral_hue() {
// 4×4 纯 `#B23A48`(rose 卡的种子色)——色相远离固定的 239.5°,好坏都能分辨。
let pixels = [0xB2u8, 0x3A, 0x48, 0xFF].repeat(16);
let seed = unlucky_design::palette::seed_from_rgba(&pixels, 4, 4).expect("纯色图有种子");
let cards = [CardKey::Sky.card(), CardKey::Teal.card()];
let schemes: Vec<Scheme> = cards
.iter()
.map(|card| seed.scheme(SchemeFlavor::Light, card.neutral_chroma))
.collect();
assert_eq!(
schemes[0].get(Role::Primary),
schemes[1].get(Role::Primary),
"取色方案的主色只由图像种子决定,不该跟着当前色卡变"
);
assert_eq!(
schemes[0].get(Role::Surface),
schemes[1].get(Role::Surface),
"取色方案的底色由图像种子决定(当前八张卡的中性彩度相同,所以两套方案的表面色相同)"
);
let surface_hue = Hct::from_color(schemes[0].get(Role::Surface)).hue;
// 精确口径:中性**调色板**的色相必须来自图像种子(不是量化后的表面色——tone 98 的
// 8 bit 量化会让实测色相漂 2.7°~7°,见模块文档;拿它做等式断言只会引入假红)。
for card in cards {
let neutral_hue = seed.palettes(card.neutral_chroma).neutral.hue_deg();
assert!(
(neutral_hue - seed.hue).abs() < 1.0e-9,
"取色路径的中性色相 {neutral_hue:.2}° 没有跟着图像种子 {:.2}° 走",
seed.hue
);
assert!(
hue_gap(neutral_hue, NEUTRAL_HUE_DEG) > 100.0,
"取色路径的中性色相被拉到了色卡的固定中性色相——动态路径的逐色染色被弄丢了(D43 保留它)"
);
}
// 观感层:实测的表面色相明显靠近图像种子,而不是靠色卡的冷调中性色相。
assert!(
hue_gap(surface_hue, seed.hue) < hue_gap(surface_hue, NEUTRAL_HUE_DEG),
"取色方案的 surface 色相 {surface_hue:.2}° 更接近色卡中性色相而不是图像种子 {:.2}°",
seed.hue
);
for card in cards {
assert_ne!(
schemes[0].get(Role::Surface),
card.scheme(SchemeFlavor::Light).get(Role::Surface),
"取色方案的表面色与色卡路径相同,说明取色路径没在按图染色"
);
}
}
/// 8 张卡 × 浅/深 × 26 对:换中性色相后仍全部过 WCAG AA(`wcag::check` 全表),
/// 并把最受中性色相影响的一对(on-surface / surface)钉在实测量级上。
#[test]
fn every_card_scheme_meets_wcag_aa_under_the_fixed_neutral() {
for card in CARDS {
for flavor in flavors() {
let scheme = card.scheme(flavor);
assert!(
card_scheme_is_readable(card, flavor),
"{} / {} 未过 WCAG AA 全表({} 对逐对断言在 `palette::wcag::check`)",
card.key,
flavor.name(),
TEXT_PAIRS.len()
);
// 中性色相变了,最受影响的一对是 on-surface / surface(改前逐卡 16.23~16.44 浅 /
// 14.30~14.42 深)。改后八张卡同一个底色,这一对也逐卡相同,钉住量级免得漂移。
let body = scheme.contrast(Role::OnSurface, Role::Surface);
assert!(
(16.30..=16.40).contains(&body) || (14.28..=14.36).contains(&body),
"{} / {}:on-surface/surface = {body:.3},超出实测区间 \
(浅 16.30~16.40 / 深 14.28~14.36)",
card.key,
flavor.name()
);
}
}
}
/// 出图脚本读的 hex 行(改前 + 改后并排),跑法:
/// `cargo test -p unlucky-design --test card_neutral -- --nocapture`。
///
/// 格式 `CARD|key|flavor|before|role=hex;role=hex;…`(承接那张「8 张卡 surface 色块并排 +
/// 切 sky→teal 窗口底色」的验收图;渲染脚本 `/d/tmp/m88/render.py` 只做排版,数据全在这里)。
#[test]
fn dump_card_palette_for_the_color_card() {
const SHOWN: [Role; 10] = [
Role::Surface,
Role::OnSurface,
Role::OnSurfaceVariant,
Role::SurfaceVariant,
Role::SurfaceContainer,
Role::SurfaceContainerHigh,
Role::Outline,
Role::Primary,
Role::OnPrimary,
Role::PrimaryContainer,
];
for card in CARDS {
for flavor in flavors() {
for (tag, scheme) in [
("before", before_d43(card, flavor)),
("after", card.scheme(flavor)),
] {
let pairs: Vec<String> = SHOWN
.iter()
.map(|role| format!("{}={}", role.name(), scheme.get(*role).to_hex()))
.collect();
println!(
"CARD|{}|{}|{tag}|{}",
card.key,
flavor.name(),
pairs.join(";")
);
}
}
}
}