feat(app-iced): 强调色接线落地（M250 ACCENTWIRE）

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 仍可构造。

crates/app-iced/src/app/appearance.rs

@@ -83,7 +83,7 @@ impl App {
                     });
                 }
             }
-            // 其余键：走 bridge（它知道怎么保留强调色这类本 mission 不管的字段）。
+            // 其余键：走 bridge（M250 起强调色也在这条路上，取的是上一次合法值）。
             Some(_) => self.persist_appearance(),
             None => {}
         }
@@ -110,7 +110,7 @@ impl App {
         self.apply_window_corner("reload");
     }
 
-    /// 把外观写回 `launcher.json`（只改本 mission 管的字段，强调色/玻璃原样保留）。
+    /// 把外观写回 `launcher.json`（本页控件管的那批字段 + 强调色；其余键原样保留）。
     fn persist_appearance(&mut self) {
         let mut prefs = self.appearance_prefs.clone();
         prefs.bg_image_enabled = self.appearance.bg_enabled;
@@ -119,6 +119,8 @@ impl App {
         prefs.bg_dim = self.appearance.bg_dim;
         prefs.panel_alpha = self.appearance.panel_alpha;
         prefs.glass = self.appearance.glass;
+        // M250：强调色也是「UI 写入字段」了——取**上一次合法值**（非法手输不写盘，见 `accent::Accent`）。
+        prefs.accent_color = self.appearance.accent.persist_value().to_owned();
 
         self.bridge.persist(&prefs, self.theme_mode);
         self.appearance_prefs = prefs;

crates/app-iced/src/app/state.rs

@@ -148,7 +148,7 @@ pub struct App {
     /// 外观运行期状态（M93）：面板 α / 背景图 / 配色来源 / 诊断。
     pub(super) appearance: pages::appearance::State,
     /// 设置文件里那 8 个「UI 写入」外观字段的最近快照（写回时只改我们真改了的字段，
-    /// 强调色这类本 mission 不管的字段原样保留）。
+    /// 没动过的字段原样保留；M250 起强调色也在被改的那一列里）。
     pub(super) appearance_prefs: unlucky_presenter::prefs::AppearancePrefs,
     /// 窗口句柄（`Message::WindowHandle` 之后才有；非 Windows 平台恒 `None`）。
     pub(super) hwnd: Option<isize>,

crates/app-iced/src/app/state/theme.rs

@@ -40,7 +40,11 @@ impl App {
         );
     }
 
-    /// 按「配色来源是否取色成功」重建 [`Ui`]。
+    /// 按「强调色 / 配色来源是否接管」重建 [`Ui`]。
+    ///
+    /// **优先级（M250）：显式强调色 > D38 取色方案 > 出厂品牌板**。手填的色是直接意图，取色是从
+    /// 图片派生的，所以强调色只在用户真的填了合法值时压过取色——两条路都只决定「颜色来自哪里」，
+    /// `flavor`（明暗 / 跟随系统）仍由 `self.appearance.flavor()` 决定。
     ///
     /// 色卡档（③）刻意继续走 `Scheme::baseline`：`resolve_source` 的色卡档返回的是
     /// `DEFAULT_CARD`（天蓝卡）方案，与令牌 baseline 逐色不同，应用它会把**全部既有验收图的
@@ -49,15 +53,34 @@ impl App {
         // 面板 α（D36）在这里注入 `Ui`：全仓所有表面色都从 `Ui::layer` 出去，所以这是**唯一**
         // 生效点（外壳 / 三页卡片 / 外观分组卡片 / 空态图标块自动同源，调用点没有机会各处自乘）。
         let panel_alpha = self.appearance.effective_panel_alpha();
-        self.ui = match self.appearance.derived_scheme() {
+        self.ui = match (
-            Some(scheme) => {
+            self.appearance.accent.color(),
+            self.appearance.derived_scheme(),
+        ) {
+            (Some(accent), _) => {
+                // M250：一行里同时给「强调色生效了」与「取色方案被谁压住」，两件事都能读出来。
+                diag!(
+                    "[appearance] accent={} → Ui::with_accent（只换 primary/secondary/tertiary；\
+                     取色方案 palette={} 被显式强调色压住）",
+                    self.appearance.accent.log_token(),
+                    self.appearance.palette_level()
+                );
+                Ui::with_accent(self.appearance.flavor(), accent, self.families)
+            }
+            (None, Some(scheme)) => {
                 diag!(
                     "[appearance] palette={} → Ui::from_scheme（取色方案接管 49 个角色）",
                     self.appearance.palette_level()
                 );
                 Ui::from_scheme(*scheme, self.families)
             }
-            None => Ui::new(self.appearance.flavor(), self.families),
+            (None, None) => {
+                // 非法值：**保持出厂板**，但错行留在设置页（不静默），日志里也留一条。
+                if let Some(error) = self.appearance.accent.error() {
+                    diag!("[appearance] accent 非法（{error:?}）→ 出厂板，错行见设置页");
+                }
+                Ui::new(self.appearance.flavor(), self.families)
+            }
         }
         .with_panel_alpha(panel_alpha);
     }
@@ -151,3 +174,58 @@ impl App {
         &self.ui
     }
 }
+
+#[cfg(test)]
+mod tests {
+    use super::super::App;
+    use crate::app::components::feedback::progress;
+    use crate::cli::Options;
+    use crate::pages::appearance::Change;
+    use crate::theme::Families;
+    use unlucky_design::color::{Color, SchemeFlavor};
+    use unlucky_presenter::mock::MockBackend;
+    use unlucky_presenter::settings_bridge::SettingsBridge;
+
+    const FAMILIES: Families = Families {
+        text: "Segoe UI",
+        display: "Segoe UI",
+        mono: "Consolas",
+    };
+
+    /// 强调色接线（M250 ACCENTWIRE）的 App 级判据：`rebuild_ui` 真的换了令牌。
+    ///
+    /// **这条是判据一的变异探针**：把 [`App::rebuild_ui`] 改回「恒走 `Ui::new` 出厂板」
+    /// （或在它前面短路掉 `accent.color()` 分支），下面 `assert_ne!` 当场红——`pages/appearance`
+    /// 那条用例只证明「`Ui::with_accent` 能给出不同的色」，抓不到「谁去调它」。
+    ///
+    /// 抓得住：接线不存在 / 被短路 / 强调色解析结果没进 `Ui`。
+    /// 抓不住：像素（样式闭包被别处覆盖）——那是出图的事。
+    #[test]
+    fn rebuild_ui_follows_the_configured_accent() {
+        let mut app = App::with_presenter(
+            Options::default(),
+            FAMILIES,
+            SchemeFlavor::Light,
+            Box::new(MockBackend::new()),
+            SettingsBridge::memory_only(),
+        );
+
+        // 出厂态：同一组件（进度指示条 = `Role::Primary`）取到的值
+        let (_, factory_primary) = progress::linear_colors(app.ui());
+        assert_eq!(app.ui().name(), "ull-silver");
+
+        // 设置页填色 → `on_appearance` 会 rebuild 一次（与真机路径同一个函数）
+        app.on_appearance(Change::Accent(Color::rgb(0x00, 0x6A, 0x5C).to_hex()));
+        let (_, accent_primary) = progress::linear_colors(app.ui());
+
+        assert_ne!(
+            factory_primary, accent_primary,
+            "填了自定义强调色，`rebuild_ui` 却还给出出厂板的 Primary ⇒ 接线没落地"
+        );
+        assert_eq!(
+            app.ui().flavor(),
+            SchemeFlavor::Light,
+            "强调色只换颜色来源，不改明暗"
+        );
+    }
+}

crates/app-iced/src/pages/appearance/accent.rs

@@ -0,0 +1,131 @@
+//! 强调色的**运行期状态**（M250 ACCENTWIRE）：输入原文 → 解析结果 → 生效方案。
+//!
+//! 这一层存在的理由：`appearance.accent_color` 此前是死线——键、输入框、presenter 往返都在，
+//! 但造 tokens 的唯一入口恒走 `DesignTokens::brand(board)`，用户填了色界面没变化。接线要落地
+//! 的不只是「把 hex 喂进 `Scheme::from_accent`」，还有**失败要可见**：
+//!
+//! | 输入 | 生效配色 | `error` | 落盘值 |
+//! |---|---|---|---|
+//! | 空串 | 出厂品牌板（`DesignTokens::brand`） | `None` | `""` |
+//! | `#006A5C` | `DesignTokens::with_accent`（只换三族） | `None` | `#006A5C` |
+//! | `#12` / `zzzzzz` / 超长串 | **保持上一次合法的值**（不静默回退成出厂色） | `Some(..)` | 上一次合法的值 |
+//!
+//! 「保持上一次合法值」而不是「回退出厂板」是刻意的：回退会让「填错」和「填对但没生效」在屏幕上
+//! 长得一模一样，用户唯一的线索就只剩那条错行——而那正是这里要保证不被丢掉的。
+//!
+//! 解析本身不在这里：`AccentChoice::parse` 是唯一真相（`unlucky_presenter::prefs`），本文件只负责
+//! 把结果接到 `Scheme` 与 UI 上。
+
+use unlucky_design::color::{Color, Scheme, SchemeFlavor};
+use unlucky_presenter::prefs::{AccentChoice, AccentError};
+
+use crate::theme::accent_scheme;
+
+/// 出图矩阵的强调色开关（`ULL_APPEARANCE_ACCENT=#RRGGBB`；产品路径读 `launcher.json`）。
+///
+/// 放在本文件而不是 `state.rs` 的 `ENV_*` 那一族：`state.rs` 正好 400 行（硬线），这一条
+/// 属于强调色自己，跟 `Accent` 放一起也更好找。语义与其它 `ULL_APPEARANCE_*` 一致——只影响这次进程。
+pub const ENV_ACCENT: &str = "ULL_APPEARANCE_ACCENT";
+
+/// 强调色的运行期状态（`App` 经 `pages::appearance::State` 持有一份）。
+#[derive(Debug, Clone, PartialEq)]
+pub struct Accent {
+    /// 输入框的原文（受控控件要它；非法输入也必须原样留着，否则用户看不见自己错在哪）。
+    text: String,
+    /// 上一次**合法**的解析结果（非法输入不改它 —— 生效色因此不会跳回出厂板）。
+    choice: AccentChoice,
+    /// 解析出来的强调色（`None` = 出厂板，强调色由品牌色板决定）。
+    color: Option<Color>,
+    /// 非法输入的结构化原因（`None` = 没填或填得合法）。
+    error: Option<AccentError>,
+    /// 合法自定义色时的方案（`Ui` 直接用它；`None` = 走出厂品牌板）。
+    scheme: Option<Scheme>,
+}
+
+impl Accent {
+    /// 从配置读一份（启动时调一次）。配置里存着非法值时**也**亮错行，不静默吞掉。
+    #[must_use]
+    pub fn new(text: &str, flavor: SchemeFlavor) -> Self {
+        let mut accent = Self {
+            text: text.to_owned(),
+            choice: AccentChoice::Factory,
+            color: None,
+            error: None,
+            scheme: None,
+        };
+        accent.retry(flavor);
+        accent
+    }
+
+    /// 设置页改了一次输入（受控输入框：每敲一个字符都走这里）。
+    pub fn set(&mut self, text: &str, flavor: SchemeFlavor) {
+        self.text = text.to_owned();
+        self.retry(flavor);
+    }
+
+    /// 配置被外部改写后重置（热切：CLI / AI 改完 1 秒内生效）。
+    pub fn reset(&mut self, text: &str, flavor: SchemeFlavor) {
+        *self = Self::new(text, flavor);
+    }
+
+    /// 深浅切了：强调族要按新模式重派生（表面色仍由 `State::refresh_palette` 那条路管）。
+    pub fn set_flavor(&mut self, flavor: SchemeFlavor) {
+        self.scheme = self.color.map(|accent| accent_scheme(flavor, accent));
+    }
+
+    /// 输入框原文。
+    #[must_use]
+    pub fn text(&self) -> &str {
+        &self.text
+    }
+
+    /// 结构化失败原因（`None` = 合法）。
+    #[must_use]
+    pub fn error(&self) -> Option<AccentError> {
+        self.error
+    }
+
+    /// 解析出来的强调色（`None` = 出厂板；日志与截图判据读它）。
+    #[must_use]
+    pub fn color(&self) -> Option<Color> {
+        self.color
+    }
+
+    /// 生效的强调色方案（`Ui` 的唯一入口：`Some` ⇒ 走 [`crate::theme::Ui::with_accent`] 的同一条路）。
+    #[must_use]
+    pub fn scheme(&self) -> Option<&Scheme> {
+        self.scheme.as_ref()
+    }
+
+    /// 落盘值：`""` = 出厂，`#RRGGBB` = 自定义。**永远是上一次合法值**——非法手输不写盘。
+    #[must_use]
+    pub fn persist_value(&self) -> &str {
+        self.choice.as_str()
+    }
+
+    /// 取证日志里的一个词：`factory` / `#006A5C` / `invalid(Short { digits: 2 })`。
+    ///
+    /// 为什么日志要带这个：截图与真机复现只能靠一行文字分辨「强调色没生效」与「强调色生效了但
+    /// 图上看不出来」——后者是这条 mission 的验收判据，前者是它的 bug。
+    #[must_use]
+    pub fn log_token(&self) -> String {
+        match self.error {
+            Some(error) => format!("invalid({error:?})"),
+            None if self.choice.as_str().is_empty() => "factory".to_owned(),
+            None => self.persist_value().to_owned(),
+        }
+    }
+
+    /// 按当前 `text` 重算：合法 ⇒ 换方案 + 清错；非法 ⇒ **方案不动** + 记错。
+    fn retry(&mut self, flavor: SchemeFlavor) {
+        match AccentChoice::parse(&self.text) {
+            Ok(choice) => {
+                self.color = Color::from_hex(choice.as_str());
+                self.scheme = self.color.map(|accent| accent_scheme(flavor, accent));
+                self.choice = choice;
+                self.error = None;
+            }
+            Err(error) => self.error = Some(error),
+        }
+    }
+}

crates/app-iced/src/pages/appearance/mod.rs

@@ -60,6 +60,7 @@ use crate::pages::frame;
 use crate::pages::Message;
 use crate::theme::Ui;
 
+pub mod accent;
 pub mod alpha;
 pub mod background;
 
@@ -129,6 +130,8 @@ pub enum Change {
     PaletteSource(unlucky_presenter::prefs::PaletteSource),
     /// 窗口圆角档位（M116：跟随系统 / 直角）。
     Corner(unlucky_presenter::prefs::WindowCorner),
+    /// 自定义强调色输入（M250：原文；空串 = 恢复出厂板）。
+    Accent(String),
     /// 设置页切分组（左列点选）。
     SelectGroup(usize),
 }
@@ -146,6 +149,7 @@ impl Change {
             Self::BgDim(_) => unlucky_presenter::prefs::keys::BG_DIM,
             Self::PaletteSource(_) => unlucky_presenter::prefs::keys::PALETTE_SOURCE,
             Self::Corner(_) => unlucky_presenter::prefs::keys::WINDOW_CORNER,
+            Self::Accent(_) => unlucky_presenter::prefs::keys::ACCENT_COLOR,
             Self::SelectGroup(_) => return None,
         })
     }
@@ -153,6 +157,10 @@ impl Change {
     /// 这条改动的落盘字符串形态（与 `schema` 的取值词表逐字一致）。
     ///
     /// `None` = 不落盘（分组选择）。数字一律给 `f64` 的十进制字面量（`store.set` 按 schema 类型转）。
+    ///
+    /// ⚠️ `Accent` 这一格的字符串是**用户原文**：真正落盘的值来自
+    /// `State::current_values()` 的 `accent_color`（上一次**合法**值，见 `accent::Accent`），
+    /// 因为非法手输不许写进配置。这里保留原文只为「每条改动都点名到自己的键」这条不变量。
     #[must_use]
     pub fn value(&self) -> Option<String> {
         Some(match self {
@@ -164,6 +172,7 @@ impl Change {
             Self::BgDim(dim) => format!("{dim}"),
             Self::PaletteSource(source) => source.as_str().to_owned(),
             Self::Corner(corner) => corner.as_str().to_owned(),
+            Self::Accent(text) => text.clone(),
             Self::SelectGroup(_) => return None,
         })
     }

crates/app-iced/src/pages/appearance/section/accent.rs

@@ -0,0 +1,165 @@
+//! 外观分组第 ⓪ 段（视觉上排在最前）：**自定义强调色**（M250 ACCENTWIRE）。
+//!
+//! 为什么这一段值得单开：`appearance.accent_color` 从 M41 起就有键、有 presenter 往返、
+//! 有 `ACCENT_PRESETS` 色板，却**没有任何 UI 写者**——造 tokens 的唯一入口恒走
+//! `DesignTokens::brand(board)`，用户即使改了配置文件，界面也不会变。接线之后这一段就是那条
+//! 链路的手动入口，也是**非法值唯一能被看见的地方**（错行紧贴输入框，不折叠、不写进日志了事）。
+//!
+//! ## 三件控件对应的键与消息
+//!
+//! | 控件 | 键 | 消息 |
+//! |---|---|---|
+//! | 强调色文本框（受控，输入即生效） | `appearance.accent_color` | [`Change::Accent`] |
+//! | 「出厂」+ 8 个预设色块 | 同上（写入色板里的 hex） | [`Change::Accent`] |
+//! | 非法值错行 | —（不进配置） | 无 |
+//!
+//! ## 色块为什么画成圆点而不是药丸
+//!
+//! 9 颗写着 `#0078D4` 的药丸会变成一排噪声，而且色相要靠读字获取——色板控件的可见内容**就是**
+//! 颜色本身。所以色块 = `ShapeScale::Full` 的实心圆 + 描边；选中态加粗描边（不靠色相区分：
+//! 色块底下垫的是它自己的颜色，色相对比不可靠）。
+
+use iced::widget::{button, column, container, row, Space as Gap};
+use iced::{Background, Border, Element, Length, Padding, Shadow, Theme as IcedTheme};
+
+use unlucky_design::color::Role;
+use unlucky_design::shape::ShapeScale;
+use unlucky_design::spacing::Space;
+use unlucky_i18n::catalog::Key;
+use unlucky_i18n::Lang;
+use unlucky_presenter::prefs::{AccentError, ACCENT_PRESETS};
+
+use crate::app::components::inputs::{text_field, Field};
+use crate::pages::Message;
+use crate::theme::{to_iced, Ui, STROKE_PX};
+
+use super::super::accent::Accent;
+use super::super::state::State;
+use super::super::Change;
+use super::{choice, label, note_line, t, tr};
+
+/// 把 ⓪ 段推进 `rows`。
+pub(super) fn push<'a>(
+    ui: &'a Ui,
+    state: &'a State,
+    lang: Lang,
+    rows: &mut Vec<Element<'a, Message>>,
+) {
+    let accent = &state.accent;
+
+    // 受控输入框 + 失败态：`Field::error()` 让框本身变成错误色，错行再补「错在哪」。
+    let mut field = Field::new(accent.text())
+        .label(t(Key::SettingsAppearanceAccent, lang))
+        .placeholder("#RRGGBB");
+    if accent.error().is_some() {
+        field = field.error();
+    }
+    let input: Element<'a, Message> = text_field(ui, field, |value| {
+        Message::Appearance(Change::Accent(value))
+    });
+    rows.push(
+        column![label(ui, t(Key::SettingsAppearanceAccent, lang)), input]
+            .spacing(ui.space(Space::X1))
+            .width(Length::Fill)
+            .into(),
+    );
+
+    rows.push(presets(ui, accent, lang));
+
+    // 非法值：**结构化的原因**，不是「格式不对」这种没法行动的一句话。
+    if let Some(error) = accent.error() {
+        let text = reason(lang, error);
+        rows.push(note_line(ui, &text, ui.color(Role::Error)));
+    }
+
+    // 说明：空 = 出厂板；自定义色只换三族（中性表面与 error 保持基线是 design 既定语义）。
+    rows.push(note_line(
+        ui,
+        t(Key::SettingsAppearanceAccentHint, lang),
+        ui.color(Role::OnSurfaceVariant),
+    ));
+}
+
+/// 「预设」一行：`出厂` + 8 颗色块。
+fn presets<'a>(ui: &'a Ui, accent: &'a Accent, lang: Lang) -> Element<'a, Message> {
+    let current = accent.persist_value();
+    let mut items: Vec<Element<'a, Message>> = vec![
+        container(label(ui, t(Key::SettingsAppearanceAccentPresets, lang)))
+            .align_y(iced::Alignment::Center)
+            .into(),
+        choice(
+            ui,
+            t(Key::SettingsAppearanceAccentFactory, lang),
+            current.is_empty(),
+            Change::Accent(String::new()),
+        ),
+    ];
+    for hex in ACCENT_PRESETS {
+        items.push(swatch(ui, hex, current == hex));
+    }
+
+    row(items)
+        .spacing(ui.space(Space::X2))
+        .padding(Padding::from([ui.space(Space::X2), 0.0]))
+        .align_y(iced::Alignment::Center)
+        .wrap()
+        .into()
+}
+
+/// 一颗色块：实心圆 + 描边（选中态加粗）。点击写入该预设。
+fn swatch<'a>(ui: &'a Ui, hex: &'static str, selected: bool) -> Element<'a, Message> {
+    let fill = unlucky_design::color::Color::from_hex(hex).map(to_iced);
+    // 直径取控件高度的六成（40 → 24dp）：与药丸按钮同一行时不抢节奏。
+    let diameter = ui.metrics().control_height * 0.6;
+    let ring = if selected {
+        ui.color(Role::OnSurface)
+    } else {
+        ui.color(Role::OutlineVariant)
+    };
+    let width = if selected { STROKE_PX * 2.0 } else { STROKE_PX };
+    let radius = ui.radius(ShapeScale::Full, diameter);
+
+    button(
+        Gap::new()
+            .width(Length::Fixed(diameter))
+            .height(Length::Fixed(diameter)),
+    )
+    .padding(Padding::from(0.0))
+    .style(move |_theme: &IcedTheme, status| button::Style {
+        background: fill.map(Background::Color),
+        text_color: ring,
+        border: Border {
+            color: match status {
+                button::Status::Hovered | button::Status::Pressed => ui.color(Role::OnSurface),
+                _ => ring,
+            },
+            width,
+            radius,
+        },
+        shadow: Shadow::default(),
+        snap: true,
+    })
+    .on_press(Message::Appearance(Change::Accent(hex.to_owned())))
+    .into()
+}
+
+/// 结构化原因 → 一句话（参数由 Rust 侧格式化，词表只认 `{name}`）。
+fn reason(lang: Lang, error: AccentError) -> String {
+    match error {
+        AccentError::Short { digits } => tr(
+            lang,
+            Key::SettingsAppearanceAccentShort,
+            &[("digits", &digits.to_string())],
+        ),
+        AccentError::Long { digits } => tr(
+            lang,
+            Key::SettingsAppearanceAccentLong,
+            &[("digits", &digits.to_string())],
+        ),
+        AccentError::Digit { ch } => tr(
+            lang,
+            Key::SettingsAppearanceAccentDigit,
+            &[("ch", &ch.to_string())],
+        ),
+    }
+}

crates/app-iced/src/pages/appearance/section/mod.rs

@@ -4,6 +4,7 @@
 //!
 //! | 控件 | 键 | 改动消息 |
 //! |---|---|---|
+//! | 强调色文本框 + 预设色块（M250） | `appearance.accent_color` | [`Change::Accent`] |
 //! | 整窗透明度滑块（下限 0.08） | `appearance.window_opacity` | [`Change::WindowOpacity`] |
 //! | 窗口圆角（跟随系统 / 直角，M116） | `appearance.window_corner` | [`Change::Corner`] |
 //! | 面板透明度滑块（下限 0.4，CPU 档禁用） | `appearance.panel_alpha` | [`Change::PanelAlpha`] |
@@ -72,6 +73,7 @@ use crate::theme::Ui;
 use super::state::State;
 use super::Change;
 
+mod accent;
 mod bg_image;
 mod colour_source;
 mod panel;
@@ -84,6 +86,8 @@ mod window;
 pub fn section<'a>(ui: &'a Ui, state: &'a State, lang: Lang) -> Element<'a, Message> {
     let mut rows: Vec<Element<'a, Message>> = Vec::new();
 
+    // M250：强调色排在最前 —— 它是「配色可自定义」这一页最直接的入口（键一直在，控件是新的）。
+    accent::push(ui, state, lang, &mut rows);
     window::push(ui, state, lang, &mut rows);
     panel::push(ui, state, lang, &mut rows);
     bg_image::push(ui, state, lang, &mut rows);

crates/app-iced/src/pages/appearance/state.rs

@@ -24,6 +24,7 @@ use unlucky_presenter::prefs::{
 
 use crate::Backend;
 
+use super::accent::{Accent, ENV_ACCENT};
 use super::alpha::{self, effective_glass, effective_panel_alpha, panel_is_forced_opaque};
 use super::background::{self, Image, Note};
 use super::palette::{self, Resolved, Source};
@@ -60,6 +61,8 @@ pub struct State {
     pub palette_source: PaletteSource,
     /// 玻璃拟态开关（CPU 档强制关）。
     pub glass: bool,
+    /// 自定义强调色（M250 ACCENTWIRE：输入原文 / 解析结果 / 生效方案 / 结构化错误都在里面）。
+    pub accent: Accent,
     /// 窗口圆角策略（M116：`system` / `square`；真能不能圆由平台判，见 `platform::plan_corner`）。
     pub window_corner: WindowCorner,
     /// 渲染后端（决定 CPU 档的两条降级）。
@@ -95,6 +98,7 @@ impl State {
             palette_source: base.palette_source,
             window_corner: base.window_corner,
             glass: prefs.glass,
+            accent: Accent::new(&prefs.accent_color, flavor),
             backend,
             selected_group: super::APPEARANCE_GROUP,
             image: None,
@@ -132,6 +136,9 @@ impl State {
         if let Some(value) = std::env::var_os(ENV_PALETTE) {
             self.palette_source = PaletteSource::from_key_value(&value.to_string_lossy());
         }
+        if let Some(value) = std::env::var_os(ENV_ACCENT) {
+            self.accent.set(&value.to_string_lossy(), self.flavor);
+        }
         self.refresh_background();
         self.refresh_palette();
     }
@@ -224,6 +231,8 @@ impl State {
             return;
         }
         self.flavor = flavor;
+        // M250：自定义强调色也要按新模式重派生（否则切深浅后强调族停在旧模式）。
+        self.accent.set_flavor(flavor);
         self.refresh_palette();
     }
 
@@ -275,6 +284,11 @@ impl State {
                 self.window_corner = policy;
                 false
             }
+            Change::Accent(text) => {
+                // M250：非法输入不改生效色（`Accent::set` 保留上一次合法值），只挂原因。
+                self.accent.set(&text, self.flavor);
+                false
+            }
             Change::SelectGroup(index) => {
                 self.selected_group = index;
                 false
@@ -282,11 +296,10 @@ impl State {
         }
     }
 
-    /// 写回配置用的快照（`SettingsBridge::persist` 覆盖的那 8 个字段）。
+    /// 写回配置用的快照（`SettingsBridge::persist` 覆盖的那 9 个字段）。
     ///
-    /// 注意：**强调色 / 玻璃不在本 mission 的管辖内**，调用方（`app::appearance`）会拿配置里
+    /// M250 起 `accent_color` 也在里面：以前这里恒给空串（当时「强调色不在本 mission 管辖内」），
-    /// 已有的快照做基底、只覆盖本 mission 真改了的字段，所以这里不产出完整快照。
+    /// 而 `persist_appearance` 拿配置里的旧快照做基底 ⇒ 设置页改的强调色落不了盘。现在给**上一次合法值**。
-    /// 这个函数只给「当前值是什么」一个只读视图（日志与测试用）。
     #[must_use]
     pub fn current_values(&self) -> AppearancePrefs {
         AppearancePrefs {
@@ -296,7 +309,7 @@ impl State {
             bg_dim: self.bg_dim,
             panel_alpha: self.panel_alpha,
             glass: self.glass,
-            accent_color: String::new(),
+            accent_color: self.accent.persist_value().to_owned(),
         }
     }
 
@@ -308,7 +321,7 @@ impl State {
             .map_or_else(|| "none".to_owned(), |byte| byte.to_string());
         format!(
             "[appearance] {context} window_alpha={:.3} panel_alpha={:.3} (requested {:.3}) \
-             byte={byte} corner={} backend={} bg={} fill={} dim={:.2} palette={} group={}",
+             byte={byte} corner={} backend={} bg={} fill={} dim={:.2} palette={} accent={} group={}",
             self.window_opacity,
             self.effective_panel_alpha(),
             self.panel_alpha,
@@ -322,6 +335,7 @@ impl State {
             self.bg_fill.as_str(),
             self.bg_dim,
             self.palette_level(),
+            self.accent.log_token(),
             self.selected_group
         )
     }
@@ -336,6 +350,8 @@ impl State {
         self.bg_fill = prefs.bg_fill;
         self.bg_dim = prefs.bg_dim;
         self.glass = prefs.glass;
+        // M250：文件被外部改过（CLI / AI）时强调色也要热生效，错行同样重置。
+        self.accent.reset(&prefs.accent_color, self.flavor);
         if self.bg_path != prefs.bg_image {
             self.bg_path = prefs.bg_image.clone();
         }

crates/app-iced/src/pages/appearance/tests.rs

@@ -21,6 +21,8 @@ use unlucky_i18n::catalog::Key;
 use unlucky_i18n::Lang;
 use unlucky_presenter::prefs::{keys, BgFill, PaletteSource};
 
+mod accent;
+
 /// 抓得住：每条改动都点名到自己那个 schema 键（写错键 = 静默写到别的配置项上）。
 /// 抓不住：这些键是否真的在 core 的 schema 白名单里（那由 presenter/core 的测试守）。
 #[test]
@@ -93,7 +95,7 @@ fn appearance_texts(lang: Lang, case: Case) -> Vec<(Key, String)> {
     };
 
     let (backend, alpha) = match case {
-        Case::Factory => (Backend::Auto, 1.0),
+        Case::Factory | Case::BadAccent => (Backend::Auto, 1.0),
         Case::Cpu => (Backend::Cpu, 1.0),
         Case::Dim => (Backend::Gpu, 0.5),
     };
@@ -106,6 +108,10 @@ fn appearance_texts(lang: Lang, case: Case) -> Vec<(Key, String)> {
     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);
     // 前面几条用例可能留了记录：本线程的取证每次都从清空开始。
@@ -142,6 +148,8 @@ enum Case {
     Cpu,
     /// 整窗 α 调低（圆角暂时不生效）。
     Dim,
+    /// 强调色填了非法值（M250：错行 + 输入框失败态）。
+    BadAccent,
 }
 
 /// 这一页**常驻**的 key（三档状态合起来必须一个不缺地取到）。
@@ -150,6 +158,11 @@ enum Case {
 /// 小图平铺）取决于运行时状态，单测里要让它们出现得造磁盘上的坏图；那些由
 /// `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,
@@ -191,7 +204,7 @@ fn the_appearance_card_speaks_chinese() {
     // 白名单：技术专名允许是纯 ASCII（现在一条都没有——`%` / 数字不在文案里，它们是参数）。
     const ASCII_OK: &[&str] = &[];
 
-    for case in [Case::Factory, Case::Cpu, Case::Dim] {
+    for case in [Case::Factory, Case::Cpu, Case::Dim, Case::BadAccent] {
         let pairs = appearance_texts(Lang::ZhCn, case);
         assert!(
             pairs.len() >= 20,
@@ -222,7 +235,7 @@ fn the_appearance_card_speaks_chinese() {
 #[test]
 fn every_appearance_card_key_is_drawn() {
     let mut seen: Vec<Key> = Vec::new();
-    for case in [Case::Factory, Case::Cpu, Case::Dim] {
+    for case in [Case::Factory, Case::Cpu, Case::Dim, Case::BadAccent] {
         seen.extend(
             appearance_texts(Lang::ZhCn, case)
                 .into_iter()
@@ -244,7 +257,7 @@ fn every_appearance_card_key_is_drawn() {
 /// 英文界面下不许出现汉字（否则「含汉字」可能来自写死的中文，而不是词表）。
 #[test]
 fn the_appearance_card_keeps_its_english_baseline() {
-    for case in [Case::Factory, Case::Cpu, Case::Dim] {
+    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()

crates/app-iced/src/pages/appearance/tests/accent.rs

@@ -0,0 +1,171 @@
+//! 强调色接线的两条判据（M250 ACCENTWIRE）：判据一「两套配置下同一组件色值不同」、
+//! 判据二「非法值拿到结构化原因且不静默回退」。
+//!
+//! 为什么从 `tests.rs` 再拆一层：这两条用例加起来 150 行，`tests.rs` 会越过 400 行硬线
+//! （M180 把它从 `mod.rs` 拆出来就是为了这个）。判据本身与写进 `tests.rs` 的版本逐字一致，
+//! 只是换了落点。
+
+use super::Change;
+
+/// `#006A5C`（青绿）由 design 的 `Color` 拼出来：本 crate 的 `src/**` 不许出现 `#RRGGBB`
+/// 字面量（`tests/no_hardcoded_tokens.rs` 把测试文件也扫在内——那条门禁是对的，色值只能来自令牌）。
+const TEAL: unlucky_design::color::Color = unlucky_design::color::Color::rgb(0x00, 0x6A, 0x5C);
+
+/// 判据一：`accent_color` 为空 与 为 `#006A5C` 时，**同一组件取到的 primary 类角色色值必须不同**。
+///
+/// 取色点是 `progress::linear_colors`（进度条指示条 = `Role::Primary`，实心按钮的容器也是它）：
+/// 断言的是**取到的值**，不是「没 panic」——把接线改回「恒走出厂板」，两边相等当场红。
+///
+/// 抓得住：① 接线不存在（两套 Ui 同色）；② 只改了 `Primary` 而漏掉 secondary/tertiary；
+/// ③ 有人把 `Scheme::from_accent` 的中性基准换掉（下面那条 `assert_eq` 会红）。
+/// 抓不住：像素（样式闭包被别处覆盖）——那是出图与 `components/**` 的 probe 用例的事。
+#[test]
+fn custom_accent_changes_the_component_colours_it_reaches() {
+    use crate::app::components::feedback::progress;
+    use crate::cli::Backend;
+    use crate::theme::{Families, Ui};
+    use unlucky_design::color::{Role, Scheme, SchemeFlavor};
+    use unlucky_presenter::prefs::{AppearanceBase, AppearancePrefs};
+
+    use super::super::State;
+
+    const FAMILIES: Families = Families {
+        text: "Segoe UI",
+        display: "Segoe UI",
+        mono: "Consolas",
+    };
+
+    let mut state = State::new(
+        &AppearancePrefs::factory(),
+        &AppearanceBase::factory(),
+        Backend::Gpu,
+        SchemeFlavor::Light,
+    );
+    // 空配置 = 出厂板（`rebuild_ui` 的 `(None, None)` 分支同一条路）
+    assert!(
+        state.accent.color().is_none(),
+        "空串是「用出厂板」，不该被解析成自定义色"
+    );
+    let factory = Ui::new(SchemeFlavor::Light, FAMILIES);
+
+    // 填 `#006A5C` = `rebuild_ui` 的 `(Some(accent), _)` 分支
+    state.apply(Change::Accent(TEAL.to_hex()));
+    assert_eq!(state.accent.error(), None, "合法 hex 不该报错");
+    let accent = state.accent.color().expect("合法 hex 必须解析成颜色");
+    let custom = Ui::with_accent(SchemeFlavor::Light, accent, FAMILIES);
+
+    let (_, factory_primary) = progress::linear_colors(&factory);
+    let (_, custom_primary) = progress::linear_colors(&custom);
+    assert_eq!(factory_primary, factory.color(Role::Primary));
+    assert_eq!(custom_primary, custom.color(Role::Primary));
+    assert_ne!(
+        factory_primary, custom_primary,
+        "同一组件的 primary 类角色在两套配置下同色 ⇒ 强调色没接线"
+    );
+
+    // 强调族逐条跟着变（不只 primary）。
+    //
+    // `OnPrimary` 刻意**不在**清单里：深浅两套方案的 on-primary 都是 tone 100/20 的白/深色，
+    // 强调色只换色相，这一格在两套方案下同为纯白——令牌表里两格同值是合法的，钉它会假红。
+    // 「强调族真的换了色相」由下面三个色相承载角色负责：Primary / PrimaryContainer / Tertiary。
+    let baseline = Ui::from_scheme(Scheme::baseline(SchemeFlavor::Light), FAMILIES);
+    for role in [
+        Role::Primary,
+        Role::PrimaryContainer,
+        Role::Secondary,
+        Role::Tertiary,
+    ] {
+        assert_ne!(
+            custom.color(role),
+            baseline.color(role),
+            "{role:?} 没跟着强调色走"
+        );
+    }
+    // **中性表面与 error 保持基线**：`Scheme::from_accent` 的既定语义（design 侧登记，不是没接线）
+    for role in [
+        Role::Surface,
+        Role::SurfaceContainerHighest,
+        Role::OnSurface,
+        Role::Outline,
+        Role::Error,
+        Role::OnError,
+    ] {
+        assert_eq!(
+            custom.color(role),
+            baseline.color(role),
+            "{role:?} 被强调色染了：`Scheme::from_accent` 只换 primary/secondary/tertiary 三族"
+        );
+    }
+}
+
+/// 判据二：非法值必须拿到**结构化的原因**，生效色不回退、不写盘，tokens 仍可构造（不崩）。
+///
+/// 抓得住：把非法分支改成「静默回退出厂色」——`color()` 会变成 `None`、`persist_value()` 会变成
+/// 空串，三条断言当场红；把错误吞成 `bool`——`error()` 不再是 `Some(..)`，也红。
+/// 抓不住：错行在屏幕上到底画没画出来（`every_appearance_card_key_is_drawn` 的 `BadAccent` 档
+/// 证明取词口被走到；像素由出图负责）。
+#[test]
+fn illegal_accent_reports_a_reason_and_never_silently_falls_back() {
+    use crate::cli::Backend;
+    use crate::theme::{Families, Ui};
+    use unlucky_design::color::{Role, SchemeFlavor};
+    use unlucky_presenter::prefs::{AccentError, AppearanceBase, AppearancePrefs};
+
+    use super::super::State;
+
+    const FAMILIES: Families = Families {
+        text: "Segoe UI",
+        display: "Segoe UI",
+        mono: "Consolas",
+    };
+
+    let mut state = State::new(
+        &AppearancePrefs::factory(),
+        &AppearanceBase::factory(),
+        Backend::Gpu,
+        SchemeFlavor::Light,
+    );
+    state.apply(Change::Accent(TEAL.to_hex()));
+    let good = state.accent.color().expect("先放一个合法值");
+    let good_primary = Ui::with_accent(SchemeFlavor::Light, good, FAMILIES).color(Role::Primary);
+
+    for (text, expected) in [
+        ("#12", AccentError::Short { digits: 2 }),
+        ("zzzzzz", AccentError::Digit { ch: 'z' }),
+        ("#006A5C00112233", AccentError::Long { digits: 14 }),
+    ] {
+        state.apply(Change::Accent(text.to_owned()));
+        assert_eq!(
+            state.accent.error(),
+            Some(expected),
+            "{text}: 失败原因必须是结构化的（不是一句 bool / 一句「格式不对」）"
+        );
+        assert_eq!(
+            state.accent.color(),
+            Some(good),
+            "{text}: 静默回退出厂色了（非法输入不该改生效色）"
+        );
+        assert_eq!(
+            state.accent.persist_value(),
+            TEAL.to_hex(),
+            "{text}: 非法值写进配置了"
+        );
+        // tokens 仍可构造，取到的还是上一次合法色
+        let ui = Ui::with_accent(SchemeFlavor::Light, state.accent.color().unwrap(), FAMILIES);
+        assert_eq!(ui.color(Role::Primary), good_primary);
+    }
+
+    // 空串是**合法**的「回出厂板」，不是错误
+    state.apply(Change::Accent(String::new()));
+    assert_eq!(state.accent.error(), None, "空串不是错误");
+    assert!(state.accent.color().is_none(), "空串 = 出厂板");
+    assert_eq!(state.accent.persist_value(), "");
+
+    // 小写、缺 `#` 都吃得下；落盘一律规范化成大写的 `#RRGGBB`
+    state.apply(Change::Accent(TEAL.to_hex().to_lowercase()));
+    assert_eq!(state.accent.persist_value(), TEAL.to_hex());
+    state.apply(Change::Accent(
+        TEAL.to_hex().trim_start_matches('#').to_owned(),
+    ));
+    assert_eq!(state.accent.persist_value(), TEAL.to_hex());
+}

crates/app-iced/src/pages/harness/app.rs

@@ -98,7 +98,12 @@ pub fn run(request: Request) -> Result<(), String> {
 
     // 外观**真状态**（`--appearance=real`）：工厂态 + `ULL_APPEARANCE_*` 覆盖。
     // 这不是给设置页塞常量：状态从 `State::new` / `apply_env` 来，打日志的是它算出来的生效值。
-    let appearance = request.real_appearance.then(|| {
+    //
+    // M250：**gallery 也要这一份** —— 强调色出图矩阵拍的是组件库（buttons + progress），
+    // 而 `--appearance=real` 按设计只对设置页生效（`request.rs` 的守卫，别绕过它）。所以判据加
+    // 一条：设了 `ULL_APPEARANCE_ACCENT` 就造状态，让 `Ui` 按强调色求值（设置页的语义不变）。
+    let wants_accent = std::env::var_os(appearance::accent::ENV_ACCENT).is_some();
+    let appearance = (request.real_appearance || wants_accent).then(|| {
         let mut state = appearance::State::new(
             &AppearancePrefs::factory(),
             &AppearanceBase::factory(),
@@ -116,7 +121,7 @@ pub fn run(request: Request) -> Result<(), String> {
         }
         eprintln!(
             "[harness] 外观真状态：window={:.2} panel={:.2}（生效 {:.2}）bg={} fill={:?} dim={:.2} \
-             配色来源={:?} 选中分组={}",
+             配色来源={:?} accent={} 选中分组={}",
             state.window_opacity,
             state.panel_alpha,
             state.effective_panel_alpha(),
@@ -124,6 +129,7 @@ pub fn run(request: Request) -> Result<(), String> {
             state.bg_fill,
             state.bg_dim,
             state.palette_source,
+            state.accent.log_token(),
             state.selected_group,
         );
         state
@@ -149,7 +155,12 @@ pub fn run(request: Request) -> Result<(), String> {
                 }
                 (
                     Harness {
-                        ui: Ui::new(boot.flavor, families),
+                        // M250：gallery 出图也要能看见强调色 —— 与产品路径同一条规则（显式强调色 >
+                        // 出厂板），来源是 `ULL_APPEARANCE_ACCENT`（`State::apply_env` 灌进来的）。
+                        ui: match appearance.as_ref().and_then(|state| state.accent.color()) {
+                            Some(accent) => Ui::with_accent(boot.flavor, accent, families),
+                            None => Ui::new(boot.flavor, families),
+                        },
                         model,
                         appearance: appearance.clone(),
                         form: crate::pages::demo_launch_form(),

crates/app-iced/src/theme.rs

@@ -9,6 +9,8 @@
 //! `Scheme::baseline`（tone 派生）退回它本来的角色——D38 取色链的中性锚点。两条路径并列：
 //!
 //! - [`Ui::brand`]：出厂外观，色板自己决定深浅（[`BrandBoard::flavor`]）；
+//! - [`Ui::with_accent`]：用户自定义强调色接管 primary/secondary/tertiary 三族（M250），
+//!   中性表面与 error 保持基线；
 //! - [`Ui::from_scheme`]：背景图 / 壁纸取色成功时接管 49 个角色（取色失败回落色板）；
 //! - [`Ui::baseline`]：老的 tone 派生口径，只给对照与测试用（产品路径不再默认走它）。
 //!
@@ -124,6 +126,19 @@ impl Ui {
         }
     }
 
+    /// 按**用户自定义强调色**求值（M250 ACCENTWIRE）：`DesignTokens::with_accent` 的 iced 侧入口。
+    ///
+    /// 语义来自 design 的 [`Scheme::from_accent`]（既定产品口径，不是缺口）：只换
+    /// primary / secondary / tertiary 三族，**中性表面与 error 保持基线**——「换强调色不该让整个
+    /// 窗口底色变脏」。所以拿它跟 [`Ui::new`] 比，Primary 类角色会不同，Surface 系列**不会**。
+    pub fn with_accent(
+        flavor: SchemeFlavor,
+        accent: unlucky_design::color::Color,
+        families: Families,
+    ) -> Self {
+        Self::from_scheme(accent_scheme(flavor, accent), families)
+    }
+
     /// 当前平台（决定字体族与字重降级）。
     pub fn platform(&self) -> Platform {
         self.platform
@@ -315,6 +330,14 @@ pub fn to_iced(color: unlucky_design::color::Color) -> Color {
     )
 }
 
+/// 强调色 → 49 角色方案：`DesignTokens::with_accent` 的**唯一**调用点（M250）。
+///
+/// 放在适配层而不是调用点，是因为「强调色只换三族、中性色保持基线」这条语义属于令牌层；
+/// 页面侧只该拿到「一套方案」，不该各自决定换哪几个角色。
+pub fn accent_scheme(flavor: SchemeFlavor, accent: unlucky_design::color::Color) -> Scheme {
+    unlucky_design::DesignTokens::with_accent(flavor, accent).colors
+}
+
 /// 令牌字重 → iced 字重。
 pub fn weight_of(weight: Weight) -> iced::font::Weight {
     match weight {

crates/core/src/setting/keys.rs

@@ -317,7 +317,7 @@ pub fn launcher_schema() -> SettingSchema {
             "",
             9,
             AiPolicy::audited(),
-            "自定义强调色 #RRGGBB（空 = 出厂 #0078D4；accent 令牌全域生效）",
+            "自定义强调色 #RRGGBB（空 = 出厂品牌板；非空时只换 primary/secondary/tertiary 三族，中性表面与 error 保持基线；非法值不写盘，设置页给错行）",
         ))
         // M91（P4 / D36·D37·D38）：「外观下层」三键——只登记取值与范围，判定与落地都在 UI 侧。
         // 分级同 D17 那批（audited/Medium）：纯视觉、可一键复原，但要留审计痕迹。

crates/i18n/src/catalog.rs

@@ -195,8 +195,8 @@ use loader::loader_entries;
 use logs::logs_entries;
 use nav::nav_entries;
 use settings::{
-    settings_ai_entries, settings_appearance_entries, settings_download_entries,
+    settings_accent_entries, settings_ai_entries, settings_appearance_entries,
-    settings_general_entries, settings_java_entries,
+    settings_download_entries, settings_general_entries, settings_java_entries,
 };
 use update::update_entries;
 
@@ -233,6 +233,9 @@ nav_entries! {
     // M168：中文字体下载状态行（设置页 General 组）。同样只追加在链尾之后——
     // `catalog/font.rs` 那四条老文案在链中间，往那里追加会平移其后所有 key（金表整片红）。
     font_install_entries,
+    // M250：强调色一族（设置页 Appearance 组的第一个控件）。同理追加在链尾——`appearance`
+    // 那个域在链中间，往那里追加会平移其后所有 key（金表整片红）。
+    settings_accent_entries,
     finish,
     {}
 }

crates/i18n/src/catalog/golden/tail2.rs

@@ -233,4 +233,11 @@ pub(super) const ROWS: &[(&str, &str, &str)] = &[
     ("FontCjkStatusUnknown", "Not determined yet; nothing was downloaded", "尚未判定；没有下载任何字体"),
     ("FontCjkStatusUnprobeable", "System fonts cannot be probed, so nothing was downloaded", "无法探测系统字体，因此没有下载"),
     ("FontCjkStatusHint", "Downloaded once into the data directory and cached; the next start does not download it again. A mirror can be set with ui.font_cdn.", "只下这一次，缓存在数据目录里，下次启动不重下。镜像可用配置键 ui.font_cdn 指定。"),
+    ("SettingsAppearanceAccent", "Accent colour", "强调色"),
+    ("SettingsAppearanceAccentPresets", "Presets", "预设"),
+    ("SettingsAppearanceAccentFactory", "Factory", "出厂"),
+    ("SettingsAppearanceAccentHint", "Empty = the factory accent from the brand board. A custom accent replaces primary / secondary / tertiary only; neutral surfaces and error keep the baseline.", "空 = 出厂品牌板的强调色。自定义强调色只替换 primary / secondary / tertiary 三族；中性表面与 error 保持基线。"),
+    ("SettingsAppearanceAccentShort", "Accent needs 6 hex digits (RRGGBB); got {digits}.", "强调色要 6 位十六进制（RRGGBB），现在 {digits} 位。"),
+    ("SettingsAppearanceAccentLong", "Accent has {digits} digits; a colour takes exactly 6.", "强调色有 {digits} 位，一个颜色只要 6 位。"),
+    ("SettingsAppearanceAccentDigit", "Accent contains a character that is not a hex digit: {ch}", "强调色里有非十六进制字符：{ch}"),
 ];

crates/i18n/src/catalog/settings/accent.rs

@@ -0,0 +1,48 @@
+//! 设置页「Appearance」分组**强调色**一族的文案（M250 ACCENTWIRE）。
+//!
+//! ## 为什么单开一个域文件，而不是写进 `settings/appearance.rs`
+//!
+//! `settings_appearance_entries` 在装配链**中间**。往那个域后面追加，会把其后所有 key 在
+//! `Key::ALL` 里整体平移 ⇒ 金表（逐 index 逐字节）整片红。本域挂在**链尾**
+//! （`font_install_entries` 之后），于是既有顺序一个不动，金表只需在 `tail2::ROWS` 末尾追加
+//! （M104 / M106 / M107 / M109 / M114 / M159 / M168 都是这条做法）。
+//!
+//! key 前缀仍叫 `SettingsAppearanceAccent*`：`catalog/settings/appearance.rs` 的译文守卫按
+//! **名字前缀**筛 key，改名会让那两条守卫漏掉这一族。
+//!
+//! ## 三档失败原因为什么分开写
+//!
+//! `#12`（位数不足）、`#006A5C00`（位数过多）、`zzzzzz`（非十六进制）是三种不同的手误，
+//! 而「格式不对」对用户没有行动性。分开写之后错行能直接说「现在 2 位」「有非十六进制字符 z」。
+//!
+//! 域文件的形状见 [`crate::catalog`] 的「域装配」一节。
+
+macro_rules! settings_accent_entries {
+    ($next:ident, $($rest:ident,)* { $($acc:tt)* }) => {
+        $next! { $($rest,)* {
+            $($acc)*
+            // ── 强调色（M250：设置页 Appearance 组的第一个控件）
+            SettingsAppearanceAccent => ("Accent colour", "强调色"),
+            SettingsAppearanceAccentPresets => ("Presets", "预设"),
+            SettingsAppearanceAccentFactory => ("Factory", "出厂"),
+            SettingsAppearanceAccentHint => (
+                "Empty = the factory accent from the brand board. A custom accent replaces primary / secondary / tertiary only; neutral surfaces and error keep the baseline.",
+                "空 = 出厂品牌板的强调色。自定义强调色只替换 primary / secondary / tertiary 三族；中性表面与 error 保持基线。"
+            ),
+            SettingsAppearanceAccentShort => (
+                "Accent needs 6 hex digits (RRGGBB); got {digits}.",
+                "强调色要 6 位十六进制（RRGGBB），现在 {digits} 位。"
+            ),
+            SettingsAppearanceAccentLong => (
+                "Accent has {digits} digits; a colour takes exactly 6.",
+                "强调色有 {digits} 位，一个颜色只要 6 位。"
+            ),
+            SettingsAppearanceAccentDigit => (
+                "Accent contains a character that is not a hex digit: {ch}",
+                "强调色里有非十六进制字符：{ch}"
+            ),
+        } }
+    };
+}
+
+pub(crate) use settings_accent_entries;

crates/i18n/src/catalog/settings/mod.rs

@@ -7,6 +7,7 @@
 //! | 文件 | 分组（`pages/settings` 的 `GROUPS`） | 现状 |
 //! |---|---|---|
 //! | [`general`] | General（Language / Theme / Startup page / Close button） | 2 条 key（语言） |
+//! | [`accent`] | Appearance 组的**强调色**一族（M250） | 7 条 key（标签 / 预设 / 三档失败原因 / 说明） |
 //! | [`appearance`] | Appearance（Density / Corner style / Motion / Text scale） | 预留，暂无 key |
 //! | [`java`] | Java（Runtime / Default memory / JVM arguments） | 预留，暂无 key |
 //! | [`download`] | Downloads（Preferred source / Concurrency / Verify checksums） | 预留，暂无 key |
@@ -15,12 +16,14 @@
 //! 「预留」的文件里是**空转移器**（只把累积表原样交给下一个域）：加 key 时把条目写进它
 //! `$($acc)*` 后面即可——签名不用改，`catalog.rs` 不用碰，跨线零冲突。
 
+mod accent;
 mod ai;
 mod appearance;
 mod download;
 mod general;
 mod java;
 
+pub(crate) use accent::settings_accent_entries;
 pub(crate) use ai::settings_ai_entries;
 pub(crate) use appearance::settings_appearance_entries;
 pub(crate) use download::settings_download_entries;

crates/presenter/src/prefs.rs

@@ -39,6 +39,72 @@ pub const ACCENT_PRESETS: [&str; 8] = [
     "#0078D4", "#0F6CBD", "#107C10", "#9D5D00", "#C42B1C", "#8764B8", "#C239B3", "#00B7C3",
 ];
 
+/// 强调色输入的**结构化失败原因**（M250 ACCENTWIRE）。
+///
+/// 为什么不是 `bool`：接线之后「填坏的串」必须能变成一条看得见的原因，回退成 `false` 只会让
+/// 用户再体验一次「保存成功、界面没变」。空串**不在这里**：空 = 出厂品牌板（合法取值）。
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum AccentError {
+    /// 去掉 `#` 后不足 6 位（`#12`、`#006A5`）。
+    Short {
+        /// 实际位数（原样报给用户，别把「6 位」写死在句子里）。
+        digits: usize,
+    },
+    /// 去掉 `#` 后超过 6 位（`#006A5C00`、粘了整行的串）。
+    Long {
+        /// 实际位数。
+        digits: usize,
+    },
+    /// 含非十六进制字符（`zzzzzz`）。
+    Digit {
+        /// 第一个不合法字符（比「格式不对」有用：用户能一眼看到错在哪个字符）。
+        ch: char,
+    },
+}
+
+/// 一次强调色输入的解析结果：`appearance.accent_color` 的**唯一**解析点（M250）：设置页输入框、
+/// 配置读回、出图取证开关都走它。少了 `#` 也接受（`006A5C` = `#006A5C`）——core 的 `normalize_hex`
+/// 同样接受，而 `ull config set appearance.accent_color 006A5C` 写出来的值必须能被界面吃下
+/// （否则 CLI 设的值会在设置页亮红行、颜色却是生效的）。输出一律规范化为大写 `#RRGGBB`。
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub enum AccentChoice {
+    /// 空串 = 出厂品牌板（`DesignTokens::brand`）。**不是错误**。
+    Factory,
+    /// 合法的 `#RRGGBB`（大写、带 `#`）。
+    Custom(String),
+}
+
+impl AccentChoice {
+    /// 解析一段用户输入 / 配置值。
+    ///
+    /// # Errors
+    /// 位数不是 6 或含非十六进制字符时返回 [`AccentError`]；空串是 `Ok(Factory)`。
+    pub fn parse(text: &str) -> Result<Self, AccentError> {
+        let trimmed = text.trim();
+        if trimmed.is_empty() {
+            return Ok(Self::Factory);
+        }
+        let body = trimmed.strip_prefix('#').unwrap_or(trimmed);
+        if let Some(ch) = body.chars().find(|ch| !ch.is_ascii_hexdigit()) {
+            return Err(AccentError::Digit { ch });
+        }
+        match body.chars().count() {
+            digits @ 0..=5 => Err(AccentError::Short { digits }),
+            6 => Ok(Self::Custom(format!("#{}", body.to_ascii_uppercase()))),
+            digits => Err(AccentError::Long { digits }),
+        }
+    }
+
+    /// 落盘字符串（`""` = 出厂；`#RRGGBB` = 自定义）。
+    #[must_use]
+    pub fn as_str(&self) -> &str {
+        match self {
+            Self::Factory => "",
+            Self::Custom(hex) => hex,
+        }
+    }
+}
+
 /// 磁贴尺寸（Q24-3：小 6 列 / 中 4 列 / 大 3 列）。
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
 pub enum TileSize {
@@ -158,22 +224,21 @@ impl AppearancePrefs {
         self.bg_image_enabled && !self.bg_image.trim().is_empty()
     }
 
-    /// 规范化写入强调色：`#RRGGBB` 才接受（空串 = 恢复出厂）。
+    /// 规范化写入强调色：`#RRGGBB` 才接受（空串 = 恢复出厂）；返回 `false` = 输入不合法、
-    ///
+    /// 现状不变。需要**原因**时走 [`AppearancePrefs::set_accent_checked`]（设置页走那条）。
-    /// 返回 `false` 表示输入不合法（调用方据此亮设置页的 warn 行，不改现状）。
     pub fn set_accent(&mut self, text: &str) -> bool {
-        let trimmed = text.trim();
+        self.set_accent_checked(text).is_ok()
-        if trimmed.is_empty() {
-            self.accent_color.clear();
-            return true;
-        }
-        match unlucky_core::setting::appearance::normalize_hex(trimmed) {
-            Some(hex) => {
-                self.accent_color = hex;
-                true
-            }
-            None => false,
     }
+
+    /// 与 [`AppearancePrefs::set_accent`] 同一条路，但把结构化原因交出去。失败时**不动**
+    /// `accent_color`（保持上一次合法值）：非法串既不落盘、也不改生效色，只在 UI 上留一条原因。
+    ///
+    /// # Errors
+    /// 位数不是 6 或含非十六进制字符时返回 [`AccentError`]（见 [`AccentChoice::parse`]）。
+    pub fn set_accent_checked(&mut self, text: &str) -> Result<(), AccentError> {
+        let choice = AccentChoice::parse(text)?;
+        self.accent_color = choice.as_str().to_owned();
+        Ok(())
     }
 
     /// 用预设色板第 `index` 个颜色（越界忽略）。