AskaEth
e6b2200360
appearance.accent_color 此前是死线：配置键、presenter 往返、预设色板都在，但造 tokens 的 唯一入口恒走 DesignTokens::brand(board)，用户填了色界面不变。 - theme.rs：Ui::with_accent + accent_scheme（唯一调用 DesignTokens::with_accent 的地方） - app/state/theme.rs：rebuild_ui 三选一（显式强调色 > D38 取色方案 > 出厂板），diag 一行说清是谁生效 - pages/appearance：新增 accent 状态（原文/解析结果/方案/结构化错误）+ 设置页输入行与预设色块； 非法值保持上一次合法值并给出 Short/Long/Digit 三档原因，不静默回退出厂色 - presenter::prefs：AccentChoice::parse 成为唯一解析点，set_accent_checked 交回结构化原因 - app/appearance.rs：persist_appearance 带上 accent_color（此前写不进去），只写上一次合法值 - pages/harness/app.rs：gallery 也能吃 ULL_APPEARANCE_ACCENT，供出图矩阵 - core keys.rs：订正「空 = 出厂 #0078D4；accent 令牌全域生效」这句半真半假的说明 - i18n：强调色 7 条文案（链尾新域，金表只追加） 判据：同一组件（进度条 Primary）在空配置与 #006A5C 下色值不同（App 级 + 令牌级两条）； 非法值拿到结构化错误、生效色不回退、不写盘、tokens 仍可构造。
277 lines
12 KiB
Rust
277 lines
12 KiB
Rust
//! `pages::appearance` 的单测：`Change` 的落盘映射（M93）+ **中文界面文案的取证守卫**（M180）。
|
||
//!
|
||
//! 为什么是独立文件：`mod.rs` 已经 220 行上下，而 M180 要在模块里加三条取证用例。搬移口径与
|
||
//! `background/tests.rs` 一致——既有两条用例**一字未动**，只是从 `mod.rs` 的行内 `mod tests` 挪到这里。
|
||
//!
|
||
//! ## M180 的两条取证守卫，它们「抓得住什么」
|
||
//!
|
||
//! iced 0.14 没有可遍历控件树的公开接口（见 [`super::probe`] 的模块文档），所以取证点只能是
|
||
//! 取词口 `section::t` / `section::tr`。于是这一对守卫分工如下：
|
||
//!
|
||
//! | 守卫 | 抓得住 | 抓不住 |
|
||
//! |---|---|---|
|
||
//! | [`the_appearance_card_speaks_chinese`] | 中文界面下取到的每一条文案都是纯 ASCII（= 有人把某条 key 的英文写回中文表 / 中文表里放英文原句） | 硬编码字面量（它压根不过取词口） |
|
||
//! | [`every_appearance_card_key_is_drawn`] | 某一处控件被改回**写死英文**：那条 key 不再被取，集合里就少一个元素 | 新加一条字面量（新 key 还没有，集合不看它） |
|
||
//!
|
||
//! 两条合起来才等于「中文界面下外观卡片里不再出现英文字面量」——单看任一条都有一个真会发生的
|
||
//! 漏网口，所以这里刻意写两条。
|
||
|
||
use super::{Change, APPEARANCE_GROUP};
|
||
use unlucky_i18n::catalog::Key;
|
||
use unlucky_i18n::Lang;
|
||
use unlucky_presenter::prefs::{keys, BgFill, PaletteSource};
|
||
|
||
mod accent;
|
||
|
||
/// 抓得住：每条改动都点名到自己那个 schema 键（写错键 = 静默写到别的配置项上）。
|
||
/// 抓不住：这些键是否真的在 core 的 schema 白名单里（那由 presenter/core 的测试守）。
|
||
#[test]
|
||
fn every_change_names_its_own_schema_key() {
|
||
assert_eq!(APPEARANCE_GROUP, 1, "左列第 1 项是 Appearance");
|
||
let cases = [
|
||
(Change::WindowOpacity(0.8), keys::WINDOW_OPACITY),
|
||
(Change::PanelAlpha(0.6), keys::PANEL_ALPHA),
|
||
(Change::BgEnabled(true), keys::BG_IMAGE_ENABLED),
|
||
(Change::BgImage("D:/x.png".to_owned()), keys::BG_IMAGE),
|
||
(Change::BgFill(BgFill::Tile), keys::BG_FILL),
|
||
(Change::BgDim(0.5), keys::BG_DIM),
|
||
(
|
||
Change::PaletteSource(PaletteSource::Wallpaper),
|
||
keys::PALETTE_SOURCE,
|
||
),
|
||
(
|
||
Change::Corner(unlucky_presenter::prefs::WindowCorner::Square),
|
||
keys::WINDOW_CORNER,
|
||
),
|
||
];
|
||
for (change, key) in cases {
|
||
assert_eq!(change.key(), Some(key), "{change:?}");
|
||
assert!(change.value().is_some());
|
||
}
|
||
assert_eq!(Change::SelectGroup(2).key(), None, "切分组不落盘");
|
||
assert_eq!(Change::SelectGroup(2).value(), None);
|
||
}
|
||
|
||
/// 抓得住：落盘字符串必须是 schema 认识的词表（枚举档写错就整条配置读回默认值）。
|
||
/// 抓不住：数值是否在范围内（钳位在 core 侧，越界写入会被 schema 拒绝）。
|
||
#[test]
|
||
fn persisted_values_use_the_schema_vocabulary() {
|
||
assert_eq!(
|
||
Change::BgFill(BgFill::Contain).value().as_deref(),
|
||
Some("contain")
|
||
);
|
||
assert_eq!(
|
||
Change::PaletteSource(PaletteSource::BackgroundImage)
|
||
.value()
|
||
.as_deref(),
|
||
Some("background-image")
|
||
);
|
||
assert_eq!(Change::BgEnabled(false).value().as_deref(), Some("false"));
|
||
assert_eq!(Change::WindowOpacity(0.8).value().as_deref(), Some("0.8"));
|
||
}
|
||
|
||
// --------------------------------------------------------------- 文案（M180 I18NAPPEAR）
|
||
|
||
/// 画一帧外观卡片，取走这一帧从词表取到的**全部**字：`(key, 文案)`。
|
||
///
|
||
/// 三档状态各画一帧：
|
||
/// - [`Case::Factory`]：auto 档、没设背景图——覆盖常驻的标签 / 选项 / 说明；
|
||
/// - [`Case::Cpu`]：CPU 档——覆盖「强制 100%」那一行与软件渲染说明（这两条只在降级态出现）；
|
||
/// - [`Case::Dim`]：整窗 α 调低——覆盖「圆角暂时不生效」那条 notice。
|
||
///
|
||
/// 两条取词路径都要收：`t()` 的 `&'static str` 与 `tr()` 替换完占位符的整句（后者不进前者的记录）。
|
||
fn appearance_texts(lang: Lang, case: Case) -> Vec<(Key, String)> {
|
||
use unlucky_design::color::SchemeFlavor;
|
||
use unlucky_presenter::prefs::{AppearanceBase, AppearancePrefs};
|
||
|
||
use super::probe;
|
||
use crate::cli::Backend;
|
||
use crate::theme::{Families, Ui};
|
||
|
||
const FAMILIES: Families = Families {
|
||
text: "Segoe UI",
|
||
display: "Segoe UI",
|
||
mono: "Consolas",
|
||
};
|
||
|
||
let (backend, alpha) = match case {
|
||
Case::Factory | Case::BadAccent => (Backend::Auto, 1.0),
|
||
Case::Cpu => (Backend::Cpu, 1.0),
|
||
Case::Dim => (Backend::Gpu, 0.5),
|
||
};
|
||
let mut state = super::State::new(
|
||
&AppearancePrefs::factory(),
|
||
&AppearanceBase::factory(),
|
||
backend,
|
||
SchemeFlavor::Light,
|
||
);
|
||
if alpha < 1.0 {
|
||
state.apply(Change::WindowOpacity(alpha));
|
||
}
|
||
if matches!(case, Case::BadAccent) {
|
||
// M250：错行只在失败态出现，所以「三档状态合起来覆盖本页全部 key」需要这一档。
|
||
state.apply(Change::Accent("zzzzzz".to_owned()));
|
||
}
|
||
|
||
let ui = Ui::new(SchemeFlavor::Light, FAMILIES);
|
||
// 前面几条用例可能留了记录：本线程的取证每次都从清空开始。
|
||
probe::take();
|
||
probe::take_rendered();
|
||
|
||
let _tree = super::section(&ui, &state, lang);
|
||
|
||
let mut texts: Vec<(Key, String)> = probe::take()
|
||
.into_iter()
|
||
.map(|(key, text)| (key, text.to_owned()))
|
||
.collect();
|
||
texts.extend(probe::take_rendered());
|
||
|
||
// 复审 L-2：`{name}` 换完还留着花括号 ⇒ 某处参数名与模板不一致（`("floor", …)` 写成
|
||
// `("flor", …)` 时句子会原样显示「下限 {floor}」，而「整句非 ASCII」的守卫看不出来）。
|
||
// 三档状态合起来覆盖本页全部 `tr()` 调用，所以这条断言是全覆盖的。
|
||
for (key, text) in &texts {
|
||
assert!(
|
||
!text.contains('{'),
|
||
"{case:?}：{} 渲染后还留着占位符「{text}」——`tr()` 的参数名与模板对不上",
|
||
key.name()
|
||
);
|
||
}
|
||
texts
|
||
}
|
||
|
||
/// 画哪一档状态。
|
||
#[derive(Debug, Clone, Copy)]
|
||
enum Case {
|
||
/// 工厂态（GPU / auto）。
|
||
Factory,
|
||
/// CPU 降级态（面板 α 与玻璃被强制）。
|
||
Cpu,
|
||
/// 整窗 α 调低（圆角暂时不生效）。
|
||
Dim,
|
||
/// 强调色填了非法值（M250：错行 + 输入框失败态）。
|
||
BadAccent,
|
||
}
|
||
|
||
/// 这一页**常驻**的 key（三档状态合起来必须一个不缺地取到）。
|
||
///
|
||
/// 为什么是手写清单而不是「`Key::ALL` 里所有 `SettingsAppearance*`」：诊断一族（读盘失败 / 配色回落 /
|
||
/// 小图平铺）取决于运行时状态，单测里要让它们出现得造磁盘上的坏图；那些由
|
||
/// `background/tests.rs` 与 `palette.rs` 的单测按 key 逐条钉（见各自的用例注释）。
|
||
const CARD_KEYS: &[Key] = &[
|
||
Key::SettingsAppearanceAccent,
|
||
Key::SettingsAppearanceAccentPresets,
|
||
Key::SettingsAppearanceAccentFactory,
|
||
Key::SettingsAppearanceAccentHint,
|
||
Key::SettingsAppearanceAccentDigit,
|
||
Key::SettingsAppearanceCorner,
|
||
Key::SettingsAppearanceCornerSystem,
|
||
Key::SettingsAppearanceCornerSquare,
|
||
Key::SettingsAppearanceCornerHint,
|
||
Key::SettingsAppearanceCornerSuspended,
|
||
Key::SettingsAppearanceWindowOpacity,
|
||
Key::SettingsAppearanceWindowOpacityHint,
|
||
Key::SettingsAppearancePanelOpacity,
|
||
Key::SettingsAppearancePanelOpacityHint,
|
||
Key::SettingsAppearancePanelOpacityForcedValue,
|
||
Key::SettingsAppearancePanelOpacityForcedHint,
|
||
Key::SettingsAppearanceBackgroundImage,
|
||
Key::SettingsAppearanceOff,
|
||
Key::SettingsAppearanceOn,
|
||
Key::SettingsAppearanceImagePath,
|
||
Key::SettingsAppearancePaletteLevel,
|
||
Key::SettingsAppearanceBgFill,
|
||
Key::SettingsAppearanceBgFillCover,
|
||
Key::SettingsAppearanceBgFillContain,
|
||
Key::SettingsAppearanceBgFillTile,
|
||
Key::SettingsAppearanceBgDim,
|
||
Key::SettingsAppearanceBgDimHint,
|
||
Key::SettingsAppearancePaletteSource,
|
||
Key::SettingsAppearancePaletteBackground,
|
||
Key::SettingsAppearancePaletteWallpaper,
|
||
Key::SettingsAppearancePalettePreset,
|
||
];
|
||
|
||
/// **M180 守门 ①**：中文界面下，外观卡片里取到的每一条文案都不是纯 ASCII。
|
||
///
|
||
/// 抓得住：某条 key 的中文译文被换成英文原句（中文表里出现纯 ASCII 的一句）；中文译文写成
|
||
/// `PNG` / `Preset` 这种专名；`tr()` 那条路径把数字拼进英文模板（比如 `Colours: preset`）。
|
||
/// 抓不住：硬编码字面量——它不过取词口，由 [`every_appearance_card_key_is_drawn`] 与
|
||
/// `catalog/settings/appearance.rs` 的译文守卫合力守。
|
||
///
|
||
/// 变异证明：把 `SettingsAppearanceOff` 的中文改成 `"Off"` ⇒ 本条立刻红。
|
||
#[test]
|
||
fn the_appearance_card_speaks_chinese() {
|
||
// 白名单：技术专名允许是纯 ASCII（现在一条都没有——`%` / 数字不在文案里，它们是参数）。
|
||
const ASCII_OK: &[&str] = &[];
|
||
|
||
for case in [Case::Factory, Case::Cpu, Case::Dim, Case::BadAccent] {
|
||
let pairs = appearance_texts(Lang::ZhCn, case);
|
||
assert!(
|
||
pairs.len() >= 20,
|
||
"{case:?}：取词口只记到 {} 条文案，渲染路径没走到底（语言管子断了？）",
|
||
pairs.len()
|
||
);
|
||
for (key, text) in &pairs {
|
||
if ASCII_OK.contains(&text.as_str()) {
|
||
continue;
|
||
}
|
||
assert!(
|
||
!text.is_ascii(),
|
||
"{case:?}：中文界面下外观卡片里出现了纯 ASCII 的文案「{text}」（{}）\
|
||
——写死英文，或中文表里放了英文原句",
|
||
key.name()
|
||
);
|
||
}
|
||
}
|
||
}
|
||
|
||
/// **M180 守门 ②（漏项）**：这一页每一处控件都必须从词表取词。
|
||
///
|
||
/// 抓得住：把某处 `t(Key::X, lang)` / `tr(lang, Key::X, …)` 改回写死的英文字面量——那条 key 不再
|
||
/// 出现在取词记录里，集合比较当场红（这正是 M172 口径「22 处硬编码」的复发形态）。
|
||
/// 抓不住：新加一条写死英文（它没有 key，也就没有「少了哪条」）。
|
||
///
|
||
/// 变异证明：把 `bg_image.rs` 里 `t(Key::SettingsAppearanceOff, lang)` 换回 `"Off"` ⇒ 本条红。
|
||
#[test]
|
||
fn every_appearance_card_key_is_drawn() {
|
||
let mut seen: Vec<Key> = Vec::new();
|
||
for case in [Case::Factory, Case::Cpu, Case::Dim, Case::BadAccent] {
|
||
seen.extend(
|
||
appearance_texts(Lang::ZhCn, case)
|
||
.into_iter()
|
||
.map(|(key, _)| key),
|
||
);
|
||
}
|
||
|
||
let missing: Vec<&str> = CARD_KEYS
|
||
.iter()
|
||
.filter(|key| !seen.contains(key))
|
||
.map(|key| key.name())
|
||
.collect();
|
||
assert!(
|
||
missing.is_empty(),
|
||
"这些 key 一帧都没取到（控件被改回写死英文，或整段没画）：{missing:?}"
|
||
);
|
||
}
|
||
|
||
/// 英文界面下不许出现汉字（否则「含汉字」可能来自写死的中文，而不是词表）。
|
||
#[test]
|
||
fn the_appearance_card_keeps_its_english_baseline() {
|
||
for case in [Case::Factory, Case::Cpu, Case::Dim, Case::BadAccent] {
|
||
let texts = appearance_texts(Lang::En, case);
|
||
let with_han: Vec<&(Key, String)> = texts
|
||
.iter()
|
||
.filter(|(_, text)| text.chars().any(is_han))
|
||
.collect();
|
||
assert!(
|
||
with_han.is_empty(),
|
||
"{case:?}：英文界面下外观卡片出现了汉字：{with_han:?}"
|
||
);
|
||
}
|
||
}
|
||
|
||
/// 有没有汉字（与 `pages/settings/tests/appearance_section.rs` 的 `is_han` 同一段码位）。
|
||
fn is_han(ch: char) -> bool {
|
||
('\u{4e00}'..='\u{9fff}').contains(&ch)
|
||
}
|