Deck Visuals(100%本地代码优先视觉工作室)
此处生成的每个视觉资产都是代码优先、确定性且品牌令牌化的:
- 读取
window.BRAND_TOKENS(从deck-brand的tokens.json自动注入)和可选的window.VISUAL_DATA(来自--data data.json)。 - 从本地临时静态服务器导入本地包(
three、d3)——零外部网络或CDN调用。 - 渲染清晰的2倍视网膜透明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. 透明视网膜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–12pt字体。
- 检查所有颜色是否与
tokens.json协调一致。