编辑-动态图形 是做什么的?
成品动态短片(MP4)的所有者,作品构建为 HyperFrames HTML 加一个暂停的 GSAP 时间线。帧级别的 PROMPT.md 是产品本身;代码仅用于渲染它。
不可协商的规则(优先级最高)
- 未经批准的帧级别
PROMPT.md不得编码 – 自动运行时也是如此:代理起草,人工批准(决策默认 Q6)。批准需在文件中记录一行APPROVAL: <谁> <日期>。变更顺序始终是:台账 -> PROMPT.md -> 代码。 - 此处无支出。 AI-3D、AI 静态图像或任何付费生成都需通过
paid-generation-gate;此技能不进行任何付费调用。目录清单不等于账户访问权限。 - 审阅顺序: Studio 预览 ->
hf_segment范围区 -> 每轮意见仅生成一个完整渲染 -> 最终渲染的逐帧质量检查。一次只处理一个繁重任务(render_lock)。收集意见;在用户仍在书写时进行诊断,但不得开始渲染。 - 硬性陷阱: HyperFrames 根节点上不允许
dir="rtl"(RTL 仅用于文本元素,<html>上使用lang="he");字体来自文件(hf/fonts/中的@font-face);hyperframes snapshot --describe false,每次调用不超过 5 个时间戳;ASCII 工作根目录(new_project)。 - 故障闭合: 无法运行的关卡标记为
blocked(not_run),绝不能标记为pass。超时、空白样本或缺少渲染的情况绝不通过。成功的工具调用是执行证据;已查看的渲染是呈现证据;静态图像不能证明动态。 - 规则 vs 品味: 规则 1-5 是法则。下方标记为 studio style 的项目(默认无字幕、禁用列表、“不要粉色”、Higgsfield 语法、21st-first)是拥有者的品味,需附带其理由进行教授;反之,一份明确说明不同的简报在品味上优先,但绝不能凌驾于关卡之上。
- 数字携带其帧率(除非简报另有说明,否则为 30)且测量的时间需要注明机器(拥有者的 Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB)。NVIDIA/Apple 的时间为未测量值。限制预算、安装或发布的项目将覆盖此技能。
输入 -> 输出
输入:简报/台账(来自 video-intake)、品牌工具包、UI 截图或组件、音乐/旁白。输出:hf/PROMPT.md(帧级别)、hf/DESIGN.md(一个锁定的调色板 + 字体 + 动态令牌)、hf/cues.js(画面和声音的单一时间源)、hf/SOURCES.md、合成文件、mix.wav、最终 MP4、质量检查报告。交接:意见 -> revision-round;其他比例 -> multi-video-variants(完全重新布局,绝不清除);交付关卡 -> render-qa-deliver;如果给定了参考 -> 首先执行 reference-style-transfer(无参考 -> 询问哪个时间范围是“风格”)。
流程
- 注册 + 接收。 选择一个注册表(
launch | kinetic | logo | explainer | calm)并锁定长度、宽高比、旁白、音乐、交付物名称(references/launch-register-and-pace.md)。一个密集的 30 秒发布感觉快了 1.7 倍;批准的长度是 45 秒:首先决定长度。 - 起草 PROMPT.md + DESIGN.md(6 个块;摄像机、过渡和事件表;任何 3D 的节拍卡)。运行
python scripts/motion_spec_check.py hf/PROMPT.md --register <r>;修复;请求批准。 - 源素材节拍(
references/ui-sources-and-port.md):目录 -> hf-blocks -> shadcn 注册表(默认)-> 仅在有账户时使用 21st.dev -> 手工构建;决定每个节拍的 3D 方案(references/three-d-decision.md)。 - 构建一个
index.html+cues.js;移植的组件需重新编写以保证寻帧安全。然后运行hf_preflight --strict,python scripts/seek_safe_scan.py hf/,python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <3D 渲染>]。 - 视觉批准: 四张静态图 + 每个过渡的截图 +
sheet联系表;Studio 预览;意见批量处理。 - 音频(
references/sound-and-captions.md):hf_mix --report;每个品牌事件上的品牌音效;混合并测量最终文件。 - 一次完整渲染在锁定下,先给出预计完成时间;
frame_qa、motion_qa、hf_deliver;使用一个独立的评论者按照agent-content/benchmarks/motion-graphics.rubric.md评分;呈现文件、编号的更改、核对过的台账以及诚实记录的差距。
注册表一览(详情见 references/launch-register-and-pace.md)
| 注册表 | 新画面 | 事件节奏 | 镜头 | 声音 |
|---|---|---|---|---|
launch | 每 2-6 秒,>= 2 个深度层 | <= 0.5-1 秒;手动计数 45-110 次/分钟 | 永不停歇(漂移 2-4 %/s,推入 8-15 %) | 音乐即是音效;每个品牌事件加品牌音效;渐出 |
kinetic | 每 1-3 秒 | 高达约 200 次/分钟(单词对换也算) | 字体即是镜头 | 关键词在说出后 0 到 +7 帧处落地 |
logo | 一个想法,3-8 秒 | 结果在 0.4-0.75 秒内可见 | 一次移动 + 稳定 | 揭示时的品牌音效;3 步结束 |
explainer | 一个想法,3-6 秒 | 30-110 次/分钟 | 有目的性,指向所解释的对象 | 旁白主导;仅在可见变化时有音效 |
calm | 允许停顿 | 稀疏亦可 | 缓慢或锁定 | 一个统一的背景音 + 细微的环境音效;无上扬/下抑效果 |
每个节拍的 3D 方案(五行概述)
每个节拍分别决定,在 PROMPT.md 中写明理由:Blender 用于真实几何 / 屏幕上显示超过 2 秒的英雄材质(优先 EEVEE;在 384-640 像素下测量每帧 1.2-2.25 秒,每个发布增加 1-1.5 分钟);Three.js 用于数据驱动、实例化、带有实时文本的 3D-UI、可迭代编辑或精确十六进制颜色的节拍,需在 1 秒 hf_segment AMD 关卡之后;AI-3D 只能通过 paid-generation-gate 并在许可检查后进行;2.5D(depth_25d,Depth Anything V2 Small,每 2 秒片段耗时 8.1-9.9 秒)用于需要小幅移动的静态图片;无用于 UI/消息节拍。3D 物体绝不能遮挡信息,且需对文字做出反应。
“枯燥 / 看起来像 AI 做的 / 静态” 在某个时间戳
替换节拍概念,而非修饰它。从菜单中选择:由真实语音频谱驱动的语音球;数据驱动的构建(条形图、计数器、路线地球仪);在代码中重建 UI 并作为物体拍摄(透视、景深、150-300% 放大);承载内容的共享元素变形;原地进行数字或文字的切换;在关键词上落地的 3D 英雄元素。永远不要使用小的角落“功能胶囊”、带有小幅推近的平面截图或黑色背景上的点。将注释添加到禁用列表行,并在每次出现时修复它(重复时作为全局规则)。
时间预算(在拥有者的机器上建模或测量;非学生测量值)
目标:一个 30-45 秒发布的首个可演示草稿大约需要 3-4 小时,包含 1-2 轮修改(第一个真实发布耗时 10 个草稿、7 轮评论者评审、4 轮拥有者意见);每轮恰好一次完整渲染。渲染参考(HyperFrames 0.8.98,E11,繁重 40 秒 / 1200 帧):1 个 worker 132.6 秒,4 个 worker 92.8 秒,8 个 worker 88.1 秒;浏览器 GPU 减少 12%;捕获是瓶颈(CPU 仅使用 16 个逻辑核心中的 2-3 个)。早期高级渲染:典型 8-14 分钟,观察范围 4-21 分钟(0.8.79-0.8.93)。始终对一个单元进行基准测试,并在超过 3 分钟的任务前发布预计完成时间行。
关卡
状态:pass | fail | blocked | n/a,始终附带理由。
| 关卡 | 前提条件 | 证据 | 若为假 | 负责人 | 需重新检查 |
|---|---|---|---|---|---|
| G0 接收 | 注册表、长度、宽高比、交付物名称、旁白/音乐来源、参考回答已记录 | hf/BRIEF.md | 提问(每轮 3-4 个问题);blocked | video-intake | 简报变化 |
| G1 帧级别规格 | 6 个块;每个节拍都有帧数、像素、缓动、声音、过渡;禁用列表行;十六进制调色板;APPROVAL: 行 | motion_spec_check.py 退出码 0(2 = 缺少批准 = blocked) | 修复规格;在代码之前停止 | 此技能 + 人工审批者 | 任何重定时或新节拍 |
| G2 干净流畅 | 每个场景一条样条线,每次移动 >= 1.2 秒,反向移动 >= 1 秒且 <= 1.3 倍,文本在每一关键帧内位于画面中;过渡出口 = 入口,英雄元素持续存在,无重复技巧,无淡入淡出 | PROMPT 中的表格 + 检查器;motion_qa 在渲染上报告 0 个卡顿范围 | 重新定时 / 重新路径;替换节拍概念而非修饰 | 此技能 | 任何镜头或过渡变化 |
| G3 密度 | 按注册表:launch = 每 2-6 秒新画面,事件间隔 <= 0.7 秒(声明的呼吸除外),45-110 次事件/分钟(手动计数) | 事件表 + 每个场景 3 帧样本 | 添加或替换节拍;将长移动拉伸至 1.6 倍而非硬塞 | 此技能 | 任何重定时之后 |
| G4 每个节拍的 3D | 每个 3D 节拍都有一张卡片:路线(Blender / Three.js / AI-3D / 2.5D / none)、一句理由、预计完成时间、关卡证据、许可 | 节拍卡表格;Three.js 行:一个非空白的 1 秒 hf_segment 帧 | 重新决定;AI-3D 行需要 paid-generation-gate | 此技能 | 新节拍或资产 |
| G5 调色板锁定 | 一个调色板表格;源文件中的每个十六进制颜色和每个 3D 渲染都在其内 | palette_audit.py 退出码 0(+ --png) | 重新着色 / 重新渲染;若无表格则为 blocked | 此技能 | 新资产、新渲染、色彩注释 |
| G6 UI 源 | 每个 UI/效果节拍在 SOURCES.md 中有一行(来源、许可、版本、日期)和一个寻帧安全的移植;项目中无 npx shadcn add;无复制 21st 预览/媒体内容 | SOURCES.md + 扫描 | 替换来源或手工构建并写明理由 | 此技能 | 新组件 |
| G7 寻帧安全 | hf_preflight --strict 0 错误;seek_safe_scan.py 0 错误;非连续时间的快照一致 | 报告 + 快照对 | 修复;绝不要无故“修复”为抑制 | 此技能 | 每次代码修改后 |
| G8 音频 | 每个品牌事件有品牌音效;旁白下的音效在 -18 至 -26 dB 之间且在画面之前 1-3 帧;音乐渐出;最终文件 -14 LUFS +-0.5,TP <= -1(内部预设 v1,Q5) | hf_mix --report,hf_deliver 在 FINAL 文件上验证 | 重新混音并重新封装(无需重新渲染) | render-qa-deliver 进行测量 | 任何音频或画面重定时 |
| G9 字幕 | 除非简报要求,否则无字幕元素 | grep id/class + <direction> 行 | 删除 / 一行内提问 | 此技能 | 简报变化 |
| G10 渲染 + QA | 本轮一次完整渲染;frame_qa 0 个标记;评分标准平均分 >= 4.0,无维度 < 3,M1/M3/M7 >= 3;台账每一行已核对 | QA 报告 + 评论者输出 | 返回至失败的关卡;升级前最多一轮修改 | render-qa-deliver | 每次完整渲染 |
记录关卡结果(hf/QA.md,每个关卡一行)
G1 pass motion_spec_check exit 0, 24 beats, approval "<who> 2026-10-02" (r2 retime 后重新运行: pass)
G5 blocked 3D render coin_r2.png not readable by palette_audit (not_run) - install Pillow or downscale
G7 fail seek_safe_scan SS02 index.html:211 Math.random -> seeded hash; rescan pending
没有行的关卡视为 not_run。切勿根据之前轮次的记忆写下 pass:重定时、新资产或补丁会使其无效(请参阅“需重新检查”列)。
呈现草稿(render-qa-deliver 拥有交付关卡)
消息 = 立即提供文件 + 编号的更改(按用户自己的意见编号)+ 每行都已核对的台账 + 来自独立评论者的评分标准得分 + 差距(未验证的内容:希伯来语校对、设备叠加、手机上的响度)+ Studio 链接。绝不要呈现带有标记帧、失败关卡或未核对台账行的内容。
参考文献(加载时机)
references/seam-camera-event-tables.md- 总是在编写或审阅 PROMPT.md 时;也参考agent-content/techniques/frame-spec-prompt.md和clean-smooth-motion.md。references/launch-register-and-pace.md- 选择注册表、节奏反馈、禁用列表、缓动数字。references/three-d-decision.md- 任何涉及深度或 3D 的节拍;2.5D 参考agent-content/techniques/2-5d.md。references/ui-sources-and-port.md- UI 卡片、效果、截图动画;agent-content/techniques/screenshot-rebuild.md。references/seek-safe-and-render-traps.md- 编写代码、补丁、渲染差异。references/palette-lock.md、references/typography-hebrew-kinetic.md、references/sound-and-captions.md- DESIGN.md、希伯来语字体、声音方案。references/dated-versions.md- 固定版本和许可(带日期;过期 = 未知)。- 脚本(
python <script> --self-check首先运行):motion_spec_check.py、palette_audit.py、seek_safe_scan.py。它们检查文本和模式,而非外观。
停止并升级
标记为 blocked,而非猜测:缺少批准行;无法进行渲染;缺少关卡输入;价格或许可未知;Three.js 节拍在 AMD 上的 1 秒片段为空白(回退到 Blender 精灵)。在任何支出、安装、发布或向第三方发送消息前询问。绝不要向其他代理会话发送消息。用户关于时间戳“枯燥 / 看起来像 AI 做的 / 静态”的注释意味着从注册表的菜单中替换该节拍概念,并用一行解释。
维护
易变的事实仅存在于 references/dated-versions.md 和全局的带日期模块中(hyperframes-traps.md、three-d-routes.md、audio-mix.md)。将每条新的所有者注释添加到禁用列表行,而非此文件。仅限指定的、确定性的检查;不运行模型评估(决策默认 Q4)。