remotion-colour-family
从最小锚点构建完整调色板。复用remotion-studio/src/colour/index.ts中的contrast()辅助函数。
触发条件
- BrandConfig缺少
secondary、accent、neutral或semantic块。 - 渲染对比度失败:任何文本-背景组合的比率低于4.5。
- 用户说“为{brand}扩展调色板”或“审计颜色”。
输入
- 1到3个十六进制锚点(主色为必填;辅色、强调色可选)
family:restoration|safety|industrial|consumer|trainingschool(可选):editorial-monocle|modern-minimal|warm-soft|tech-utility|brutalist-experimental—— 视觉学派预设(开放设计血统)。在家族启发式规则运行之前,选择类型特征、对比度偏差和强调色角色。默认值:modern-minimal。- 现有调色板(如果是扩展场景)
方法
-
学派预设 —— 首先应用
school偏差。每个学派约束色相范围、亮度范围、中性色温度和强调色饱和度:学派 色相偏差 亮度偏差 中性色 强调色饱和度 参考资料(已备案) editorial-monocle暖土色(赤陶/粘土/沙色) 高(羊皮纸/象牙色) 仅暖灰色 —— 每种灰色都带有黄褐色底色 一种色度强调色,深沉的泥土色调 _library/claude/、_library/monocle/(如果存在)modern-minimal冷中性色(石板灰/蓝灰色) 平衡 真正的中性灰 一种电光强调色,每个视口使用不超过3次 _library/airbnb/、_library/cal/warm-soft暖粉彩(桃色/腮红/奶油色) 高 暖灰色 + 奶油色 低饱和度玫瑰色/珊瑚色 _library/airtable/、_library/cafe/tech-utility靛蓝/青色/石板灰 低(首选深色表面) 冷灰色趋向石板灰-900 青色信号强调色,仅用于增量/状态 _library/binance/、_library/arc/brutalist-experimental高对比度主色在纯白色上 极高 + 极暗 仅纯黑/白 尖锐的霓虹色,激进使用 _library/brutalism/、_library/bold/ -
家族启发式规则 —— 在学派之后应用。家族提供规范相邻色:
safety:海军蓝 + 应急橙 + 象牙色restoration:蓝绿色 + 石板灰 + 青柠色industrial:石墨色 + 钢色 + 琥珀色consumer:英雄红/蓝 + 暖白色 + 石板灰training:赤陶色 + 奶油色 + 墨色
-
在OKLch中生成 —— 在OKLch色彩空间中工作,而不是HSL,这样色相旋转能保持感知亮度不变。首先将十六进制锚点转换为OKLch;旋转色相±30°/±60°,同时将亮度限制在学派的范围内。将输出转换回十六进制以存储到
BrandConfig。在对比度报告中保留oklch兄弟字段,以供下游Tailwind-4消费者使用(第2阶段)。 -
确定性 —— 相同的
(primary, family, school)三元组必须在多次运行中产生相同的输出调色板。无随机性;无温度;无LLM插值。该生成器是其输入的纯函数。 -
构建中性色 —— 在
oklch(99% 0 hue)(50)和oklch(15% 0 hue)(900)之间插值,根据学派偏差将chroma向主色的色相倾斜(warm-soft使中性色变暖;tech-utility使中性色变冷)。 -
构建语义色 —— 从与主色不冲突的固定池中选择
success/warning/danger。 -
构建深色变体 —— 反转中性色的亮度(
50 ↔ 900),并在OKLch空间中将主色亮度提高8%。 -
验证 —— 对于每一对
(primary, neutral.50)、(primary, neutral.900)、(secondary, neutral.50)、(accent, secondary),确保对比度≥4.5(WCAG-AA)。如果不满足,则重新生成失败的槽位。Brutalist-experimental要求≥7.0(AAA)。
输出
两个产物:
- JSON对比度报告,包含OKLch坐标(供
remotion-brand-codify和第2阶段Web使用):
{
"school": "modern-minimal",
"family": "restoration",
"tokens": {
"primary": { "hex": "#0E7C7B", "oklch": "oklch(48% 0.10 195)" },
"neutral": {
"50": { "hex": "#F5F7F8", "oklch": "oklch(97% 0.005 200)" },
"900": { "hex": "#0E1518", "oklch": "oklch(15% 0.010 215)" }
}
},
"passes": [ { "fg":"#F5F7F8", "bg":"#0E7C7B", "ratio": 7.21, "level":"AAA" } ],
"fails": []
}
- YAML片段,准备放入
Synthex/packages/brand-config/src/brands/{slug}.design.md的colors:块中 —— 令牌名称遵循@google/design.md规范(层级名称使用小写+短横线,例如neutral-50、dark-primary):
colors:
primary: "#0E7C7B"
secondary: "#2A3D45"
accent: "#C5E063"
neutral-50: "#F5F7F8"
neutral-100: "#E4E9EC"
neutral-500: "#6F7B82"
neutral-900: "#0E1518"
success: "#3FA34D"
warning: "#E0A800"
danger: "#C0392B"
on-primary: "#FFFFFF"
on-secondary: "#FFFFFF"
on-accent: "#0E1518"
surface: "{colors.neutral-50}"
on-surface: "{colors.neutral-900}"
dark-primary: "#16B5B3"
dark-secondary: "#1A2428"
dark-surface: "#0E1518"
dark-on-surface: "#F5F7F8"
针对生成的.design.md运行npx --prefix Pi-Dev-Ops/remotion-studio design.md lint,确认对比度错误为零。
边界
- 绝不交付任何存在AA失败的调色板 —— 阻止并请求创始人输入有问题的槽位。
- 绝不覆盖品牌设置的显式
darkVariant。 - 除非
family === 'consumer'且品牌名称明确以红色为锚点,否则绝不使用红色作为主色。 - 在生成过程中绝不调用LLM —— 该函数是确定性的。如果确定性失败(相同输入在不同运行中产生不同输出),那是生成器的错误,而不是特性。
- 绝不混合两种学派 —— 选择一个。混合
editorial-monocle的温暖与tech-utility的石板灰会产生每个品牌起步时都会有的模糊的“AI默认”调色板。
移交给
remotion-brand-codify将结果写入src/brands/{slug}.ts。