用途:为代码库产出经过对比度校验的色彩令牌文件,涵盖色阶、语义层与深色模式。核心理念是色彩是一套系统而非一堆色值:每个色相以完整明度色阶交付,组件只消费语义令牌,任何文字/背景组合都需附计算出的对比度比值。适用于调色板、色阶、深色模式、对比度修复、状态/交互色与主题化。若缺少令牌基础设施,应先运行 design-foundation;整体灰色扁平通常属层级问题而非调色板问题。
主要能力与流程:第一步检查代码库,用正则 grep 收集颜色值、去重计数、聚类相近色(明度差小于约5),读取现有令牌判断是否只有零散 hex,识别事实品牌色并检查深色模式状态,抽查最常见文字/背景对的对比度。第二步按需一次性询问品牌色、性格与深色模式范围,能推断则推断不阻塞。第三步构建系统:品牌色展开为50–950的11级明度色阶;中性色阶需带品牌色相(约5–15%饱和度),禁用#808080与纯黑;按需添加辅色(类似、互补或三色规则);状态色为成功/警告/错误/信息并各带100/600/700迷你色阶;语义层包含 bg、text、border、interactive 等,组件不直接使用色阶值;深色模式只重映射语义令牌并重新校验。对比度按 WCAG 相对亮度计算,正文≥4.5:1、大字与UI≥3:1,必要时参考 APCA。状态色不能只靠颜色区分,需配图标或标签。
使用方式:按检测到的技术栈写入令牌入口(扩展而非分叉),迁移高漂移色值集群。交付物含代码、调色决策、对比度验证表、迁移映射与已迁移文件清单。限制:资料未提供安装命令、价格、平台等细节;具体技术栈适配需依实际代码库而定。