用途:为任何配色决策提供依据,包括挑选或构建调色板、明暗模式、对比度、图表与终端配色。核心原则是按语义角色(背景、文本、主色、错误等)选色,而非按原始色相,从而保证主题可替换、一致且无障碍。
主要能力:提供四个领域的现成调色板。网页 UI 含 Carbon(默认,深板岩蓝、暗色优先)、Graphite、Evergreen、Terracotta、Bloom、Teal Slate 及基于 12 步 OKLCH 生成的 Dusk、Driftwood、Meadow;营销落地页含 Sunbloom、Tidewater、Obsidian & Gold、Paper & Ink;数据可视化含分类(Lunar Valley 默认、Hearthstead、Vintage Warm、Glass Wall、Okabe-Ito)、连续(Viridis 默认、Magma、Inferno、Plasma、ColorBrewer Blues、YlOrRd)、发散(Console & Window 默认、Alien Sun、Orchard Dusk、Coffee & Coolant);终端含 Solarized Dark、Nord、Catppuccin Mocha/Latte、Dracula、Tokyo Night。
使用方式:先按角色契约(background、surface、surface-elevated、border、text-primary、text-secondary、primary/primary-hover、accent、success/warning/error/info)映射,再读对应十六进制;每种彩色角色还需 fill/on-fill、subtle/emphasis、subtle-border、link 三元组,不能一个十六进制兼三用。按需加载单个参考文件:Carbon 见 references/carbon.md,其他调色板见 references/palettes.md,对比度校验见 references/contrast.md,自建色阶见 references/build-your-own.md,理论见 references/theory.md。
限制与要点:WCAG AA 要求正文文本 ≥4.5:1,大文本与 UI/边框 ≥3:1;数据分类色不超过约 8 种;色盲安全需辅以文字、图标或位置,发散数据用蓝橙等暖冷对比而非红绿;明暗模式并非简单反转,需按模式重新决定中性色色相与彩度;暗色宜以 APCA 复核,基色抬高至约 #0d1117–#1e1e2e。图表库(如 Recharts)自带 SVG fill 会绕过颜色令牌,需直接指定其文本元素。终端色应绑定 ANSI 1–6 槽,槽 8 仅用于弱化。组件库默认弱化文本常约 3.4:1,需自行校验。与 frontend-design、typography、dataviz 技能配合使用。