Communitygithub.com

Deck Visuals(本地程式碼優先視覺工作室)

產生自訂的品牌標記化 3D 渲染(Three.js)、編輯級資料視覺化(D3/SVG)與確定性循環動畫片段(MP4),全程本地執行,無需網路依賴。

Deck Visuals(本地程式碼優先視覺工作室) 是什麼?

Deck Visuals 是一個完全在本地執行的程式碼優先視覺工作室,專為 DeckCraft 生態系統設計。它能根據 NARRATIVE.md 中的投影片需求,自動產生高品質的 3D 英雄視覺、自訂架構圖、出版級圖表或循環動態背景,完全避免使用 AI 生成的模糊圖片。技能核心運作機制是:透過 headless Playwright/Chromium 載入 Three.js 或 D3 場景,注入 `window.BRAND_TOKENS`(來自 `tokens.json`)與可選的 `window.VISUAL_DATA`(來自 `--data`),然後以 2x Retina 解析度輸出透明 PNG 或無縫循環的 H.264 MP4。它支援多種內建配方(例如 `three-hero-orb.html`、`three-isometric-layers.html`、`editorial-chart.html`),對應不同的敘事需求,並強制執行渲染後檢查(透明邊緣、標籤清晰度、色彩一致性)以確保品質。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SwePalm/deckcraft-skills/tree/HEAD/skills/deck-visuals

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 和諧一致。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能