remotion-colour-family
從最少錨點建立完整調色盤。重複使用 remotion-studio/src/colour/index.ts 中的 contrast() 輔助函式。
觸發條件
- BrandConfig 缺少
secondary、accent、neutral或semantic區塊。 - 渲染對比度失敗:任何文字-背景組合的比率 < 4.5。
- 使用者說「擴展 {brand} 的調色盤」或「審核顏色」。
輸入
- 1-3 個十六進位錨點(primary 為必填;secondary、accent 為選填)
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靛藍 / 青色 / 石板灰 低(偏好深色表面) 偏向 slate-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 使用(第二階段)。 -
確定性 — 相同的
(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)。若不符,則重新生成失敗的欄位。粗野主義實驗學派要求 ≥ 7.0(AAA)。
輸出
兩個成品:
- JSON 對比報告,包含 OKLch 座標(供
remotion-brand-codify和第二階段網頁使用):
{
"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:區塊 — Token 名稱遵循@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。