动画图形制作套件
说明使用俄语。请以用户所使用的语言回复。
为何需要
那些“凭感觉”逐一制作的图形卡片,到了第三张就开始分裂:一个从底部进入用时半秒,另一个从侧面进入用时一秒,字体大两号,强调色又是另一个色调。观众不会对此进行表述,但视频看起来就像是用别人的片段拼凑而成。
动效工作室基于 HyperFrames 构建,并将其打造成了自己的工厂:品牌决策仅做一次并记录在文件中,视频通过角色简档来描述场景,智能体将简档转化为合成并渲染。新的图形卡片会与之前的一致,即使一个月后由另一个智能体制作也是如此。
工作原理
| 工具 | 作用 | 输入输出 |
|---|---|---|
| HyperFrames | 引擎:场景即 HTML 合成,渲染为视频,自带校验 | HTML、CSS 和 GSAP 时间线 → MP4、WebM 或带透明通道的 MOV ProRes 4444 |
| Claude Code(或类似工具) | 智能体根据简档组装场景 | 简档 + 品牌文件 → 合成、渲染、校验 |
| 品牌文件 | 集中管理颜色、字体、动画、间距 | brand.json → 每个场景的参数 |
| ffmpeg | 在素材上生成草稿、帧列表、黑帧检测 | 带透明通道的场景 + 视频帧 → 预览和帧列表 |
| ProRes 4444 | 输出带透明背景的最终文件供剪辑使用 | 包含透明通道的 MOV 文件 |
| DaVinci Resolve(或同类:Premiere、Final Cut) | 剪辑,将图形叠加在视频上 | MOV ProRes 放置在素材上方轨道 |
智能体编写方案、简档、合成并运行校验;由所有者批准方案和草稿;文字(姓名、数字)由所有者或客户提供。
HyperFrames 是 HeyGen 的一个开源引擎:https://hyperframes.heygen.com。其中的合成是一个包含 data-* 时间属性、GSAP 时间线用于动画以及 CSS 用于样式的 HTML 文件。需要 Node.js 22 或更高版本以及 ffmpeg。
| HyperFrames 自带功能 | 工作室新增功能 |
|---|---|
| 包含轨道和场景时机的 HTML 合成 | 品牌文件:颜色、字体、动画、间距;每次渲染前打印品牌规则 |
hyperframes init,在浏览器中预览工作室 | 按场景角色编写的视频简档,替代手动布局每个合成 |
hyperframes render:MP4、WebM 和带透明通道的 MOV ProRes 4444(--format mov),--quality draft | 角色和模板库:角色转换为特定品牌的模板,同一简档可用于任何品牌风格 |
hyperframes lint、check 和 validate:标记和时机错误、浏览器错误、缺失文件、文本对比度 | 在真实素材上的草稿预览和联系帧表,替代在黑色背景上评估 |
hyperframes add:从注册库中添加预制模块和效果 | 将最终版本与草稿对比检测暗帧和黑帧查找 |
hyperframes doctor:检查运行环境 | check_brand.py:在第一个场景之前检查品牌文件 |
--docker 确保不同机器上结果一致 | 内嵌在合成中的本地字体和本地 GSAP,按场景命名文件 |
以下原则也适用于其他将代码转化为视频的引擎。
何时启用
视频中的图形(演讲者姓名、章节、数字、片尾卡)、Shorts 和 Reels 的钩子、用于剪辑的透明叠加层、新的动效品牌。
不要启用全屏推广视频(10-25 秒,带有自己的情节):这类视频需要根据音乐节奏进行分镜,每个视频有自己的合成,场景角色反而碍事。视频分镜由 shot-list 处理,文章封面由 article-cover 处理,生成式画面风格由 film-look 处理。
三个文件代替一个大文件
- 品牌文件
brand.json:颜色、字体、文本大小、动画词汇、角色时长、间距和安全区域。每个品牌一份,很少修改。包含虚构品牌和每个字段注释的示例:templates/brand.example.json。 - 视频简档
scenes.json:按角色排列的场景列表。仅包含含义和文本,不含任何颜色或动效参数。示例:templates/scenes.example.json。 - 角色模板:每个角色对应一个 HyperFrames 合成,它读取品牌和场景参数并代入数值。需要自己编写模板,每个角色工作量不大。良好起点:
hyperframes init和通过hyperframes add从注册库添加预制模块。
核心规则:某个场景需要的颜色、字体或速度,但未在品牌文件中记录,这是一个信号。要么将其加入品牌文件供所有场景使用,要么放弃。那种“仅在此处”的微调正是导致系统崩溃的原因。如果需要新样式:创建新模板,而不是修改通用模板以适应某个项目。
如何创建品牌文件
- 将
templates/brand.example.json复制到项目中作为brand.json。 - 从网站或品牌指南中获取颜色。没有指南:询问所有者关于背景色、主文本色和强调色。不要为客户编造品牌颜色。
- 每种颜色赋予一个含义:背景、文本、第二行、强调色。如果无法说明颜色用途,则说明它是多余的。五种活跃颜色是上限。
- 字体:一个用于标题和数字,一个用于说明文字,也可以统一用一种。仅使用无衬线或衬线字体。任何地方都不使用等宽和像素字体,包括数字、日期和标签。数字使用宽度相等的无衬线字体:在 CSS 中使用
font-variant-numeric: tabular-nums。计数器不再跳动,字体保持生动。 - 将字体嵌入合成中(通过项目文件或直接在 CSS 中)。来自互联网的字体可能在渲染时无法加载,导致帧使用系统字体。GSAP 也应本地存放,网络加载可能在渲染过程中失败。
- 在
rules中用文字记录品牌限制:如何使用强调色,是否可以引入新颜色,从哪里获取事实。智能体在每次构建前读取这些规则,否则它们会在会话之间丢失。 - 运行校验:
python3 scripts/check_brand.py brand.json
脚本查找必填字段、非十六进制颜色、文本与背景对比度低于 4.5:1、等宽和像素字体、在 1080 帧上小于 28 像素的文本、超出合理范围的时长以及未能覆盖平台界面的安全区域。出现违规时退出代码为 1。
场景角色
描述角色,而不是模板。角色说明场景的用途,而模板则根据品牌选择。更换品牌后,同一角色将以不同风格组装,无需重写简档。
| 角色 | 用途 | 字段 | 背景 | 时长 |
|---|---|---|---|---|
hook | Shots 前 1-3 秒,吸引手指停留 | title(3-6 个单词),subtitle 可选 | 自有,全帧 | 2-3 秒 |
name | 画面中谁在说话 | title(姓名),subtitle(身份) | 透明 | 3-5 秒 |
chapter | 意思模块切换 | label(编号),title | 自有或透明 | 2.5-4 秒 |
number | 需要记住的一个数字 | value,unit,note | 透明 | 3-4 秒 |
endcard | 结尾:姓名、网站、后续行动 | title,meta,Logo | 自有,全帧 | 4-6 秒 |
简短事实、角落笔记或带有分隔符的枚举也可以是角色(fact,note,list)。当同一任务第二次出现时,才创建新角色,而不是为单个场景创建。
画面中的位置 at:bl,br,tl,tr,left,right,center。姓名条几乎总是在左下角,位于演讲者视线相反的一侧。
文本仅来自简档。不要虚构姓名、职位、数字和地址:没有数据就问。图形卡片上的姓氏错误每位观众都能看到。
用文字描述动画
在场景中,动画应像导演那样描述,而不是程序员:
强调线从左向右划线,名字在其后升起,职位随后显现;保持住;所有内容向下一个动作消失
智能体将其转换为品牌参数和 GSAP tween:“升起”表示在 motion.travel_px 距离内,以 motion.enter_sec 时长和 ease_enter 缓动,“随后”表示延迟 stagger_sec 秒,“消失”表示 exit_sec 秒。如果描述中没有所需词汇,则使用品牌默认值,而不是自行编造速度。
- 一个场景一个意思。 如果场景表达两个意思,则分为两个场景。
- 先有最终帧,再运动。 在场景中所有内容都到位后先布局,然后再添加入场和出场。这样重叠部分在渲染前可见。
- 入场慢于出场。 出现时伴有减速,消失时加速且速度大约快一倍。观众关注入场,出场对他们来说不重要。
- 整个视频一个方向。 从底部进入,则从底部或沿同一轴线消失。方向混乱看起来像剪辑错误。
- 一个场景不超过两种技巧。 平移和显现就足够了。同时使用旋转、弹跳和模糊看起来像是引擎演示。
- 短距离,元素依次出现。 平移 30-60 像素看起来高档,跨半个屏幕则廉价。先线,再名字,再说明文字。
- 钩子按单词显示,不是按字母。 逐字母显示缓慢且干扰阅读。
- 最终画面保持不动 3-4 秒,否则观众来不及阅读。
- 代码中避免随机性。 随机数和当前时间会导致每次渲染产生不同画面。使用基于元素索引的公式来产生变化。
手机上的时机和可读性
- 文本完全出现后,保持静止时间不少于
min_hold_sec。 - 阅读时间:每个单词约 0.3 秒加上入场时间。六个单词的图形卡片时长不少于 3 秒。
- 使用中等大小文本。全屏巨大标题显得像在吼叫。
- 短边 1080 像素:标题 64-110,说明文字不少于 40,标签不少于 28。更小的字在手机上无法阅读。
- 一行不超过 25-30 个字符。长行按意思分行,不是按宽度。
- 放在素材上方的文本必须带有背景板、阴影或暗化效果。对比度 4.5:1 是针对背景板计算的,而不是空白背景。
- 只强调一个词或一条线。整段用强调色填充无法阅读。
- 场景的时间线必须填满其插槽:在末尾添加一个覆盖整个场景时长的空 tween。否则 HyperFrames 会提前隐藏场景,导致视频中出现黑帧。
安全区域
平台会用自己的界面覆盖部分画面。以下是针对短边为 1080 的帧的数值,请在平台的最新截图上复核。
9:16(1080x1920,Shorts、Reels、TikTok): 顶部约 250 像素(昵称、按钮),底部约 400(说明文字、音乐、进度条),右侧约 140(点赞和评论),左侧约 60。钩子和重要文本放在中央区域。竖屏中的姓名条应比常规位置更高。
16:9(1920x1080,YouTube,横屏剪辑): 两侧约 96 像素,顶部 54 像素,底部约 96 像素。在最后 5-20 秒 YouTube 会放置片尾卡片,片尾卡的构建要为其留出位置。
安全区域保存在品牌文件中,通过将边框覆盖在草稿帧上来检查场景。
渲染
- 草稿:
hyperframes render --quality draft,比最终版本快数倍。用其检查所有内容,最终版本只渲染一次。 - 常规视频(MP4,H.264): 用于钩子、片尾卡以及所有全屏内容。Alpha 通道只会增大文件体积。
- 用于剪辑的透明背景: 图形卡片、叠加在素材上的章节、数字。HyperFrames 自行渲染带透明通道的 MOV ProRes 4444(
--format mov),适用于 DaVinci Resolve、Premiere 和 Final Cut;网页使用带透明通道的 WebM(--format webm)。MP4 不支持透明通道。全屏剪辑用图形可通过 ffmpeg 转换为更轻量的 ProRes 422 HQ。 - 防止渐变中出现条纹:添加轻微噪点(
texture.grain)并使用 ProRes 母版。 - 不要启用 PNG 帧捕获(
--video-frame-format png):在工作室的校验中它会导致暗部区域变黑。 - 文件名按场景使用拉丁字母:
name-01-sokolova.mov。
最终版前在素材上创建草稿
在黑色背景上一切看起来都正常。问题只有在真实画面上才能发现:图形卡片遮挡了人脸,白色文字消失在了窗户中。
- 以草稿质量渲染带透明背景的场景。
- ffmpeg 将它们叠加到真实视频的帧或片段上(简档中的
preview_bg:文件、视频或帧文件夹,循环分配给场景)并合并为一个预览视频。 - 帧列表:每个场景的开始、中间和结束画面合并为一张图片。
- 目视检查并展示给所有者,附带编号的场景列表,以便其用一个词回答。通过 lint 并不代表设计有效。
校验
hyperframes lint:在每个新模板之后、展示之前运行。hyperframes check(lint、浏览器错误、布局和文本对比度一次性运行),hyperframes doctor:如果渲染失败则运行。Lint 能捕获真实错误:全屏图层在开始时没有零透明度会导致前几帧曝光过度;与y轴 tween 结合使用的translate(-50%,-50%)居中方式会在动画结束时偏移,请使用 flex 包裹器居中。- 在草稿和最终版本中查找黑帧:ffmpeg 捕捉帧亮度,连接处的全黑帧表示场景丢失或视频卡死。合成内的每个视频必须有各自的
id,否则帧会卡住。 - 将最终版本与草稿对比暗帧:掉入黑色的像素比例不应增加。
工作流程
- 品牌:是否有
brand.json?如果没有,创建并使用脚本校验。 - 方案:包含角色、文本、格式和时长的编号场景列表。展示方案,而不是视频:
品牌:Fjord Lab,16:9,图形卡片使用透明通道
01. name / bl / 透明: '玛丽亚·索科洛娃' · '音响工程师',4秒
02. chapter / 透明: '第2章' · '我们如何录制静默',3秒
03. number / right / 透明: 48小时 · '录制一集的时间',3.5秒
04. endcard / MP4: 'Fjord Lab' · fjordlab.example,5秒
- 根据已批准方案创建简档
scenes.json。 - 按角色创建合成,运行
hyperframes lint。 - 在素材上创建草稿、帧列表、查找黑帧、展示。
- 用文字进行修改(“第三个短一点”、“名字大一点”)在简档中修改;通用修改(“所有图形卡片更慢”)在品牌文件中修改。
- 最终渲染,透明场景使用 ProRes 4444,与草稿对比,将文件输出到剪辑文件夹。
常见错误
- 直接在场景中设置颜色或速度。 五个视频项目后会有五种不同的强调色。所有视觉元素仅在品牌文件中。
- 在纯色背景上评估图形。 图形卡片在应用到项目素材之前看起来“很棒”……
...(对于此技能,SKILL.md 已截断,实际版本包含更多内容,例如典型错误、交付检查清单等)