Communitygithub.com

deck-visuals

在本地通过 Playwright/Chromium 和 ffmpeg 生成品牌令牌化的3D渲染(Three.js)、编辑级数据可视化(D3/SVG)以及确定性循环动画片段(MP4)。当NARRATIVE.md中的幻灯片需要3D英雄视觉、自定义架构图、出版级图表或微妙的循环动画背景时使用。

deck-visuals 是什么?

这是一个100%本地的、以代码为先的视觉工作室技能。它通过读取`window.BRAND_TOKENS`(从`deck-brand`的`tokens.json`自动注入)和可选的`window.VISUAL_DATA`数据,调用本地包(如 `three`、`d3`)进行渲染,无需任何外部网络或CDN调用。该技能可以生成2倍视网膜透明PNG图片(`--mode png`)或无缝循环H.264 MP4视频(`--mode mp4`),这些输出可直接用于`deck-builder`中的`insert.picture`或`insert.video`。它支持多种视觉样式:Three.js用于3D元素(英雄球体、等距图层、上升阶梯、轨道飞轮),D3/SVG用于图表,以及HTML/CSS 3D透视舞台用于产品/UI演示。关键规则是:永远不要依赖AI生成的通用图像来处理图表、图表或文本——每个视觉资产都必须是代码驱动的、确定性的,并且与品牌令牌保持一致。该技能还强调在嵌入前检查输出的透明度、抗锯齿和色彩协调性。

兼容平台~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调用。
  • 渲染清晰的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 协调一致。

Individual skills in this repo

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

相关技能