omd-shader-hero — 單一場景,兩種品牌墨水 是做什麼的?
一個啟動英雄區只會給人們一個印象,而這個印象來自於對你毫無虧欠的人。網格漸層是網路上最常見的著色器效果,而混合兩種互補的品牌色調往往會變成棕色。這個技能反其道而行:兩種平色墨水,基色與一種品牌色,以有序抖色場域的方式呈現,像光線穿過網版印刷般緩慢折疊。每個像素非此即彼,因此不會混合,也不會產生混濁感。文案位於基色墨水製成的硬邊緣挖空區塊上,就像孔版海報上的裁切面板。
腳本會從 DESIGN.md 中選取兩種墨水、文字顏色和對比度。沒有任何顏色是憑感覺挑選的。
運作範例:examples/hero.html,根據虛構的 examples/DESIGN.example.md 填入。腳本:scripts/tokens.mjs(墨水 + 對比度)、scripts/verify.mjs(實際渲染驗證)。
1. 使用時機 / 不使用時機
使用於:
- 啟動、產品、等候名單、活動或品牌重塑頁面需要一個具有動態效果的首屏;
- 專案有
DESIGN.md,其中包含品牌色與深色(或淺色)基色(Core v2 Foundations 代幣、Foundations 散文配對,或 Google 相容的colors:frontmatter); - 品牌適合圖形化、印刷感、自信的風格。
不使用於:
- 沒有 DESIGN.md 或品牌色。
tokens.mjs會以 exit code 3 退出,你應停止;執行omd-init或詢問。絕不自行填補「好看」的顏色(未知即代表不存在); - 品牌風格柔和、攝影感或低調奢華。抖色場域是強烈的視覺元素。請改用簡報中的攝影(tf-shaders "photo first");
- 頁面需要多個著色器場景。一個場景,加上至多一個小型強調區塊(tf-shaders 規則)。如需完整滾動故事,請使用
omd-landing。
2. 流程
- 讀取代幣,不要自行選擇。
腳本會依序讀取三種格式:node <skill>/scripts/tokens.mjs DESIGN.md # 以 JSON 格式輸出決策 node <skill>/scripts/tokens.mjs DESIGN.md --scheme light # 使用淺色基色取代深色- **color.<role>**: \#hex`代幣、Foundations 區段內的Name (`#hex`)配對,以及 frontmattercolors:`。接著它會:- 移除狀態與實用角色(danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active);
- 取最深的代幣作為基色墨水(淺色方案則取最淺的);
- 取一種品牌墨水:若存在名為 primary/brand 的角色則使用,否則取飽和度最高的品牌色,跳過與基色過於接近的顏色。
- 文字顏色由計算得出。 腳本會檢查文字候選(方案另一端的墨水/中性代幣)是否與兩種墨水及其中間色有足夠對比,並選出最佳者。文案位於不透明的基色挖空區塊上,因此需要滿足的條件是文字代幣在基色墨水上的對比度。使用固定範例時,此值為 18.8:1。若即使如此仍低於 4.5:1,腳本會發出警告:請選擇其他文字代幣。
- 撰寫英雄區。 複製
examples/hero.html(或移植,參見 §6)並填入內容:
這會改寫node <skill>/scripts/tokens.mjs DESIGN.md --write path/to/hero.html#hero-varsCSS 區塊(--hero-c0基色、--hero-c1品牌色、--hero-text、--hero-scrim、--hero-scrim-a)以及#hero-tokensJSON。 - 文案必須真實。 標題 + 一句話 + 一個 CTA。使用使用者實際的產品名稱。絕不虛構產品指標、客戶或投資人(tf-shaders §0)。
- 在真實 GPU 上驗證(§5)並以全尺寸檢視各個影格。
3. 場景及其兩個參數
Paper 的 ditheringFragmentShader:type = 4x4(有序 Bayer),colorBack = 基色墨水,colorFront = 品牌色墨水,以及透過 .hero-scene 上的 data-shape 選擇的兩種場域形狀之一:
data-shape | 場域 | 視覺感受 |
|---|---|---|
warp(預設) | 品牌光的緩慢對角線摺疊,比例 1 | 像孔版海報,能量集中在兩個角落 |
ripple | 以英雄區為中心的同心環,位於文案後方,比例 0.5 | 具有重心感的印刷效果:文案位於視覺焦點 |
形狀是構圖的選擇,而非第三個參數:每種形狀的比例固定,使其像素在 px 2–6 的範圍內清晰可見,未知值則預設為 warp。兩種形狀都維持兩種平色墨水(透過像素計數驗證,§5)。Paper 的其他抖色形狀和著色器已被排除:大多數會在邊緣混合兩種顏色,違反了此技能存在的規則。
| 參數 | 範圍 | 預設值 | 功能 |
|---|---|---|---|
speed(data-speed) | 0–1 | 0.3 | 摺疊的漂移速度。高於 ~0.6 會看起來像螢幕保護程式。0 則凍結場域。 |
px(data-px) | 2–6 CSS px | 3 | 抖色細胞大小。2 = 精細網點,3 = 孔版,5–6 = 粗網點。 |
版面規則:
- 挖空,而非遮罩。 文案區塊位於不透明的基色面板上,具有硬邊緣(圍繞文案內縮 2rem × 2.5rem)。半透明遮罩或羽化邊緣會使基色覆蓋品牌點,重新產生混濁。小型文字(頁尾標籤)也有自己的挖空區。
- 對比度:標題與副標題需達 4.5:1。 標題字體夠大,WCAG 可接受 3:1,但此技能不依賴此項寬限。
verify.mjs在低於 4.5:1 時會報錯(針對兩者)。 - 英雄區文案在第一個影格就呈現:不使用
opacity: 0,不等待畫布載入。畫布會在 600ms 內淡入,疊在已完成的 CSS 海報之上。 - 海報也使用兩種墨水。 它遵循形狀(
warp為角落,ripple為環形,在靜止影格之後佈局),其色調來自兩種硬邊緣帶狀區域(核心為 4×4 方格,邊緣為 2×2 方格)內的點大小,絕不透過 alpha 通道:淡化的遮罩會使品牌色疊加在基色上。方格點位於整數像素上,如同 Bayer 細胞。 - 韓文顯示字型遵循
/hangul:keep-all+overflow-wrap: anywhere,行高 1.3,字距 -0.02em(絕不低於 -0.03em),text-wrap: balance,font-synthesis: none。 - 背景設定在
html上,絕不在body上(body 背景會覆蓋負 z-index 場景;這是 tf-shaders 的常見陷阱)。 - 圓角、字體比例與間距同樣來自 DESIGN.md。固定範例未定義圓角,因此 CTA 為直角方形。
4. 函式庫、授權、預算、備用方案
函式庫:@paper-design/shaders 0.0.82(原生 ShaderMount + ditheringFragmentShader),WebGL2。 0.0.82(2026-10-21)僅修改 shader-mount.js:dispose() 現在會釋放 WebGL 環境。授權已於 2026-10-13 根據 npm tarball 的 LICENSE 檔案、npm 元資料及 GitHub 授權 API 驗證:
@paper-design/shaders 0.0.81 | shaders 4.0.4(shaders.com) | |
|---|---|---|
| 授權 | Apache-2.0(+ NOTICE "Paper Shaders, Copyright 2026 Paper") | MIT(© 2026 Shader Effects Inc.);依賴 typegpu 0.12.3 MIT |
| 執行環境 | WebGL2,近乎通用 | 僅 WebGPU;不支援時會出現透明畫布且無記錄 |
| 此場景的 JS | 23.7 KiB 最小化 / 7.0 KiB gzip(esbuild);CDN 按檔案 +esm 5.0 + 2.9 KiB gzip | 2,535 KiB 最小化 / 710 KiB gzip(Shader + MeshGradient) |
| 遙測資料 | 無 | 預設開啟(5% 取樣至 shaders.com/api/telemetry);若必須使用,請傳遞 disableTelemetry |
| npm 週下載量(2026-10-05..11) | 1,104,377(-react) | 287,493 |
Paper 在覆蓋率、體積與遙測方面勝出。shaders 僅作為已採用 WebGPU 場景的專案的升級路徑。在該情況下,請保留此代幣管線、挖空區與備用方案,並傳遞 disableTelemetry。兩種授權均允許在技能與範本中使用。範例從固定的 CDN URL 匯入 Paper,不進行供應商封裝。若你供應商封裝 Paper 的檔案,請一併複製其 NOTICE。
預算:
- JS: 7.0 KiB gzip 函式庫 + 1.1 KiB gzip 場景程式碼。
- GPU: 一個全視口四邊形,兩種顏色,有序抖色。
minPixelRatio: 1且maxPixelCount1920×1080,因為細胞大小即為解析度。Paper 會在離屏或隱藏分頁時暫停。 - 無圖片、無影片、無 UI 字型以外的字型。
備用方案(屬於設計的一部分,而非事後補救):
- 畫布下方的 CSS 半色調海報: 品牌色點位於基色墨水之上(
radial-gradient6px 細胞),朝兩個角落遮罩。這是首次繪製的內容,也是無 WebGL2 的路徑(ShaderMount在無環境時會拋出錯誤;頁面會先檢測getContext('webgl2')),同時也是 CDN 無法連線時的狀態。verify.mjs會強制使用此路徑。 prefers-reduced-motion: reduce: 在固定影格(STILL_FRAME,8000ms)時速度為 0。這是單一靜態構圖,不執行 rAF 循環。
5. 在真實 GPU 上驗證
npm i -D playwright-core && npx playwright-core install chromium # 全新的 Playwright Chromium,非你既有的 Chrome
node <skill>/scripts/verify.mjs path/to/hero.html ./hero-verify --frames 48 --seconds 12 --shape all
--shape warp|ripple|all 會在頁面模組執行前設定 data-shape。對於每種形狀,它會執行四次檢測(1440px GPU、390px 行動裝置、減少動態、無 WebGL)並加上 --enable-gpu --ignore-gpu-blocklist --use-angle=metal(macOS),對於每次檢測:
- 記錄 WebGL 渲染器,以便了解是由真實 GPU 還是 SwiftShader 繪製影格;
- 以確定性方式推進著色器時鐘 12 秒,並儲存影格(ffmpeg → 示範 GIF/MP4);
- 測量對比度:隱藏文案,在每個影格中取樣標題與副標題後方的場景,並取得與文字顏色相比的最差比例。低於 4.5:1 時報錯(針對兩者);
- 計算墨水種類:在挖空區外部,畫布與 CSS 海報的每個像素必須是基色墨水或品牌色墨水(
twoInksScene、twoInksPoster); - 海報先於畫布,根據頁面自身的時鐘:初始化腳本取樣每個渲染影格,記錄海報首次出現在畫面上的影格,以及畫布首次繪製且非透明的影格,同時包含繪製時間與 LCP;
- GPU 檢測的影格時間:場域運行期間的 3 秒 rAF 間隔,計算中位數與 p95;
- 檢查畫布(而非海報)是否顯示在畫面上、場域是否移動、標題在載入時是否為完全不透明、減少動態時是否靜止,以及無 WebGL 時是否顯示海報且無畫布。
於 2026-11-06 使用固定範例進行測量(無頭 Chromium,ANGLE Metal Renderer: Apple M5 Pro),兩種形狀的所有檢查均通過:
| 形狀 | 最差標題 / 副標題對比度 | 其他墨水像素(場景 / 海報) | 海報影格 → 畫布影格(GPU 檢測) | 影格時間(中位數 / p95) |
|---|---|---|---|---|
| warp | 所有四次檢測皆為 18.81 / 18.81 | 0 / 0 | 62 → 112 ms | 8.3 / 9.2 |
| ripple | 所有四次檢測皆為 18.81 / 18.81 | 0 / 0 | 44 → 127 ms | 8.3 / 9.2 |
6. Next.js / React 移植
將區段、文案、挖空區與海報以純 HTML/CSS 伺服端渲染(海報不需要 JS)。在構建時從 tokens.mjs --json 產生 CSS 變數,而非在執行時期。在 'use client' 葉子元件中掛載場景:
useEffect(() => {
if (!probeWebGL2() || !ref.current) return; // 保留海報;無需清理
let m: { dispose(): void } | undefined;
(async () => {
const { ShaderMount, ditheringFragmentShader } = await import('@paper-design/shaders');
try { m = new ShaderMount(ref.current!, ditheringFragmentShader, uniforms, undefined, reduce ? 0 : speed, 8000, 1, 1920 * 1080); }
catch { /* 保留海報 */ }
})();
return () => m?.dispose();
}, []);
7. 出處
來自擁有者的 tf-shaders 實驗(skill/shader-landing/SKILL.md、RESEARCH.md、scripts/shoot.mjs,2026-10):一個場景加上至多一個強調區塊、聲明的 JS 預算、每個畫布下方的 CSS 海報、背景設於 html、字型後方的靜止狀態、在最差影格檢查對比度、首個影格即顯示英雄區文案、將減少動態視為狀態變更,以及真實 GPU 螢幕截圖循環。此技能新增了代幣管線、雙墨水抖色、挖空區、已測量對比度與 WebGL2 執行時期選擇。
禁止事項
- 請勿加入第三種顏色或混合兩種墨水(漸層、半透明疊加、羽化面板)。兩種平色墨水是核心價值;互補色調的混合就是混濁。
- 請勿使用非 DESIGN.md 代幣的顏色,也絕不使用狀態色(例如將危險紅色作為品牌墨水)。
- 請勿將文字直接放在抖色場域上。文案需放在挖空區上;小型文字需有自己的挖空區。
- 請勿根據斷點切換著色器,或動態編譯屬性。更改墨水值或
px只需寫入 uniform,這是可接受的。 - 請勿將英雄區疊在
body背景上,也請勿淡入標題。 - 請勿在同一頁面上同時載入 Paper 與
shaders。