style-library 是 hyperframes-video-pipeline 项目中的可复用运动图形卡片库与风格模板集合,主要用于选择视觉风格、添加卡片以及搭建动效视频场景。
使用方法上,先阅读 style-library/GUIDE.md 与 style-library/registry.json,按风格(style)、层级(tier)和用途(purpose)筛选,再打开具体卡片。选中卡片后,需阅读该风格的 DESIGN.md、tokens.css 以及 manifest 中的槽位限制。
卡片分为两种呈现方式:叠加层(overlay)需在卡片和说话者面部之外保持透明;接管式(takeover)则使用不透明背景。使用时将所选卡片复制到视频项目的 compositions/ 目录,本地化其 CSS、字体和 GSAP 依赖,填充命名数据槽位(data-slot),并通过 HyperFrames 技能接入时间节奏。仅复制卡片而不带相对依赖,无法得到完整资产。
若需要整场景起点,可使用 style-templates/;媒体模板可能需要使用者自备 assets/source.mp4,渲染前应先查看其 README。
新增风格时,使用命令 node scripts/style-library/new-style.mjs 03 my-style "My Style",随后完善其设计令牌、manifest 和卡片;manifest 变更后运行 node scripts/style-library/build-registry.mjs 重建注册表。项目专属文案应保留在项目中,库中卡片保持通用。
限制方面,目录中包含草稿资源,并不保证每张卡片都已通过渲染质量检查(QA)。使用前应对所选卡片执行 lint,并按项目实际分辨率渲染,检查其主视觉帧与转场,同时确认槽位文本在最大长度下的显示效果。