Deck Visuals(100% 本地程式碼優先視覺工作室)
這裡產生的每個視覺都是程式碼優先、確定性、品牌標記化的:
- 讀取
window.BRAND_TOKENS(從deck-brand的tokens.json自動注入)以及可選的window.VISUAL_DATA(來自--data data.json)。 - 從本地臨時靜態伺服器匯入本機套件(
three、d3)—零外部網路或 CDN 呼叫。 - 渲染清晰的 2x Retina 透明 PNG(
--mode png)或無縫循環的 H.264 MP4 片段(--mode mp4),可直接用於deck-builder的insert.picture或insert.video。
視覺選擇指南(敘事優先)
| 敘事需求 | 最佳工具 / 內建配方 | 輸出 |
|---|---|---|
| 逐步解說圖表或放大某個支柱 | DeckCraft Morph(deck-builder) | 原生向量形狀 |
| 標誌性封面 / 概念錨點 / 3D 英雄 | Three.js(three-hero-orb.html) | 透明 2x PNG 或 3–4 秒循環 MP4 |
| 分層系統 / 平台架構 | Three.js 等距層(three-isometric-layers.html) | 透明 2x PNG |
| 工作量規模 / 成熟度 / 階段路線圖 | Three.js 階梯(three-ascending-steps.html) | 透明 2x PNG |
| 可重複飛輪 / N 模式營運模型 | Three.js 飛輪(three-orbital-flywheel.html) | 無縫循環 MP4 或 2x PNG |
| 量化證明、趨勢、排名、比較 | D3 / SVG(editorial-chart.html) | 透明 2x PNG |
| 產品 / UI 逐步解說 | HTML/CSS 3D 透視舞台(Playwright) | 透明 2x PNG |
| 真實世界照片 | 使用者提供的照片(或未來的可選雲端掛勾) | 裁切圖片 |
渲染視覺資產
1. 透明 Retina PNG(3D 靜態、D3 圖表、SVG 圖表)
node skills/deck-visuals/scripts/render_visual.mjs \
--scene skills/deck-visuals/references/recipes/three-hero-orb.html \
--tokens build/brand/tokens.json \
--width 600 --height 600 --scale 2 \
--mode png --transparent \
--out build/assets/hero-3d.png
2. 確定性循環 MP4(3D 旋轉台、動畫圖表、著色器)
暴露 window.renderFrame = (t) => { ... },其中 t 平滑地從 0 運行到 1(無縫循環,使 t=0 和 t=1 匹配!)。然後執行:
node skills/deck-visuals/scripts/render_visual.mjs \
--scene skills/deck-visuals/references/recipes/three-hero-orb.html \
--tokens build/brand/tokens.json \
--width 600 --height 600 --scale 1 \
--mode mp4 --fps 30 --duration 4 \
--out build/assets/hero-3d-loop.mp4
3. 傳遞自訂資料給圖表/圖形
傳遞 --data path/to/chart-data.json—執行器會在場景腳本執行前將其注入為 window.VISUAL_DATA。
品質規則:嵌入前檢查
在將任何渲染的 PNG(或影片中幀)放到 DeckCraft 投影片上之前,務必單獨檢查:
- 檢查透明度與邊緣抗鋸齒(無鋸齒狀邊框縫隙與投影片背景重疊)。
- 檢查圖表標籤是否清晰、不重疊,且在目標投影片矩形尺寸下至少相當於 11–12 pt。
- 檢查所有顏色是否與
tokens.json和諧一致。