SuperAPI AI 工具集

color-system

设计与创作

查看项目

更新于 11-03 16:18

技能介绍

color-system 是一个关于 OKLCH 配色与语义色 token 构建的设计技能,重点在于让色板中的每个角色都能在文字、控件、主题和色域限制下保持可用。资料指出,OKLCH 让亮度、色度比 HSL 或十六进制更容易推理,但它本身不负责决定艺术方向,也不保证对比度;真正有效的是对渲染后的颜色配对进行测量。

用途与原则:该技能面向需要凝聚色板、颜色色阶、语义 token 或对比度修复的设计任务。它不建议为了完整而堆叠等权重颜色,也不建议用单一强调色的公式去套所有场景;每个色相都应有明确职责,取舍依据应来自品牌证据、受众、环境光与角色需求,缺失证据时应记录为已批准的假设,而不是默认选用时髦的蓝、紫或绿。

主要能力:一是构建 OKLCH 色阶。oklch(L C H) 中 L 为 0–1 的感知亮度,C 为色度(0 表示灰色,实际最大值约 0.37),H 为 0–360 的色相;建议建立约 10–12 级、从约 0.97(50)到约 0.30(900)的固定步长亮度阶,保持色相稳定,让色度在中段最高、在明暗两端收敛,避免近白或近黑处显得刺眼或浑浊。二是选择语义色,如 success、error、warning、info,应在匹配的 L/C 上选取,避免随手使用现成的红绿。三是派生交互状态,通过将 L 微调 ±0.04–0.06 得到 hover/active,而不是使用透明度。四是建立三层 token 结构:primitives 是命名的 OKLCH 色阶,语义角色描述 text、surface、focus、danger 等职责,组件别名只引用角色而不引用原始值。

对比度与可访问性:技能要求对每个实际会使用的文字/背景配对验证 WCAG:正文至少 4.5:1,大号文字、UI 和图标至少 3:1;焦点、错误、禁用和 hover 等状态在每个主题下都要分别测量,正文配对通过不代表其他状态也通过。WCAG 2.x 比值是其 AA 阈值,法律适用性因地区而异;APCA 可作为附加读数,不能替代 WCAG。CSS contrast-color() 仍只输出黑白,不应依赖它处理品牌配对。不得仅靠颜色传达含义,应与图标或文字配合。

色域与回退:该方法适配 P3,同时要求降级到 sRGB,并为很旧的目标提供十六进制回退;P3 场景下需在 sRGB 回退中保留层级,并记录色域压缩。若某个色相无法承载可读角色,应将其用作标记或大面积强调,并另配更深的语义墨色。

使用方式:资料提到可参考 assets/oklch-ramp.md 中的生成器与 token 骨架,并阅读 oklch-and-ramps、contrast-and-tokens、decision-records 等参考文件;交付时应说明色相/中性策略、语义 token、实测配对、色域回退与缺口,并将角色映射移交给主题化环节。该技能会在前景/背景角色未知时暂停,接收 design-system-interview、deslop-ui 等上游输入,输出给 theming、data-viz、a11y-pass。具体安装命令、运行环境与收费信息暂未提供。