general-video — 通用视频工作流
在构建之前确认路线。 这是自定义合成创作的回退工作流。如果输入内容明显适合某个专门工作流,应优先使用:话题解说 →
/faceless-explainer;GitHub PR →/pr-to-video;现有素材 →/embedded-captions·/talking-head-recut;短无旁白动态图形 →/motion-graphics。超出范围:直播/渲染时数据、NLE 式剪辑已完成视频、或制作 HyperFrames 无法捕获的素材。不确定?先阅读/hyperframes。
按要求精确构建。 标题卡就是标题卡——不是标题卡加三个辅助场景加字幕。如果额外场景或元素确实能改进作品,_提议_它们;不要静默添加。对于小改动(修复颜色、调整一段时长、添加一个元素),跳过规划步骤直接构建。
方法
发现——仅针对开放型请求
对于模糊的探索性请求(“为我们的品牌做点什么”、“一个炫酷的片头”)——在选择颜色之前先理解意图:
- 受众——谁观看?开发者 / 高管 / 普通消费者?
- 平台——在哪里播放?社交媒体(15秒) / 网站主屏 / 产品演示 / 内部?
- 优先级——什么最重要?动态质量 / 内容准确性 / 品牌一致性 / 速度?
- 变体——提供一个最佳版本,还是 2-3 个有实际差异的选项(不同的节奏、能级或结构——而不仅仅是换颜色)?
对于具体请求(“添加一个标题卡”、“修正场景3的节奏”),跳过发现步骤。
步骤 1 — 设计系统 → hyperframes-design
首先建立视觉标识。如果项目有设计规范,请阅读它(优先级 frame.md → design.md → DESIGN.md;将其视为品牌真相——精确颜色、字体、约束)。
如果没有规范,在选择任何颜色或字体之前,你必须同时阅读 hyperframes-design/references/house-style.md 和 hyperframes-design/references/video-composition.md。 house-style.md 提供“解读提示词/生成真实内容”的开启方式、惰性默认列表和图层配方;video-composition.md 提供视频媒介的密度/缩放/前景细节化(数据条、注册标记、等宽字体元数据、“8-10个元素,其中两个用户并未要求”)——这能将“制作精良”与“生成产物”区分开。只读一个是常见的失误——video-composition.md 正是智能体常常跳过的部分,也正是它能够防止输出扁平、居中、类似网页的结果。不要自行发明调色板并跳过这些步骤;进入 hyperframes-design 在此处是强制性的,而非可选分支。之后,根据需要从 references/visual-styles.md 中抽取一个命名的风格/情绪。规范/风格定义的是品牌,而非构图规则。
找到切入点(模糊要求,无规范): 在选择颜色之前,写一个句子——这个名称/词语/主题唤起了什么,什么样的视觉_世界_(隐喻、场景、工具、主题)能表达它?例如,网络安全工具 → 金库门 / 周边扫描线 / 锁芯;冥想应用 → 潮汐、呼吸、慢速光晕。阅读主题的_含义_,而不仅仅是它的文字;选择一个具体的切入点而非逐字重排。对于单场景作品(此时正确地跳过提示词扩展步骤),这是提示词扩展的低成本替代——它是设计概念与通用 logo 加渐变背景之间的区别。
步骤 2 — 提示词扩展 → hyperframes-design
对每个多场景合成执行(单场景作品和琐碎编辑跳过)。根据设计规范 + 家装风格将请求落地为一个一致的中介表示,下游工作以相同方式读取该表示。参见 hyperframes-design/references/prompt-expansion.md。
步骤 3 — 规划
在编写 HTML 之前,从高层次思考:
- 内容——观看者体验:叙事弧线、关键时刻、情感节奏。
- 结构——分为多少个合成、子合成 vs 内联、哪些轨道承载视频 / 叠加层 / 字幕。对于单片文件 vs 模块化子合成的选择,参见
/hyperframes/core/references/composition-patterns.md§ 两种架构(经验法则:≥3 个硬场景切换,或任何复用场景 → 模块化;短单场景作品保持一个文件)。 - 节奏——在实现之前命名模式(例如
fast-fast-SLOW-SHADER-hold);参见hyperframes-design/references/beat-direction.md。 - 时序——哪些片段驱动时长、过渡落在何处、节奏。
- 布局——先构建最终状态(见下文)。
- 动画——然后通过
hyperframes-motion添加动效。
先布局后动画
将每个元素放置在其最可见的时刻——完全进入、正确放置、尚未退出。将其编写为静态 HTML + CSS。尚未使用 GSAP。
原因: 如果你在动画起始状态(屏幕外、缩放为0、透明度0)定位元素,然后补间到你_认为_它们落地的位置,你是在猜测最终布局——重叠问题在渲染前不可见。先构建最终状态,你可以在添加动效之前看到并修复布局问题。
- 为每个场景确定关键帧——最多元素同时可见的时刻。这就是你要构建的布局。
- 为这个关键帧编写静态 CSS。内容容器必须用内边距填充场景,而非绝对偏移:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* 内边距定位内容;填充任意场景大小 */
gap: 24px;
box-sizing: border-box;
}
切勿在内容容器上使用 position: absolute; top: Npx——当内容高度超过空间时会导致溢出。将绝对定位保留给装饰元素。
⚠ 上述
width/height: 100%仅在每个祖先元素都有明确高度时生效。 根<div data-composition-id>及其与.scene-content之间的任何包装器都必须设置大小(在根上设置position: relative; width: 1920px; height: 1080px——参见/hyperframes/core→ “根必须设置大小”)。跳过这一步会导致弹性容器坍缩到约 0,内容堆叠到左上角,第一个字符在 x=0 处被裁剪——而lint/inspect仍然报告 0 个问题。并且始终保留.scene-content上的padding(≥80px):它就是标题安全边距。切勿用单纯的gap替换它。
- 添加入场——从屏幕外/不可见状态动画到 CSS 位置,使用
gsap.from()(在子合成中优先使用gsap.fromTo()以便起始状态明确;参见/hyperframes/core/references/sub-compositions.md)。CSS 位置是基准真相,补间是到达它的过程。 - 退出由过渡处理——根据
hyperframes-motion/transitions/中的场景过渡规则,只有最终场景会动画元素退出;场景之间的过渡本身就是退出。
跨时间共享空间: 如果元素 A 在元素 B 进入同一区域之前退出,两者仍然需要为各自的关键帧设置正确的 CSS 位置——时间线排序将防止它们共存,布局步骤可以捕获意外重叠。分层发光/阴影和 Z 轴深度是_有意_的重叠;布局步骤是为了捕获_无意_的碰撞(两个标题叠在一起、内容溢出帧外)。
构建——委托给领域技能
此映射将技能的全部表面(见 description)对应到其参考资料——并非穷举;当意图未列出时,通过 hyperframes-design(外观/概念)、hyperframes-motion(动效)、/hyperframes/core(契约)路由。第一行是叠加的——请同时阅读它和你的意图行,而非二选一。
| 正在构建… | 首先阅读(按顺序) |
|---|---|
| 始终——每个非琐碎作品,在下方你的意图行之上 | hyperframes-design/references/house-style.md + references/video-composition.md(也已在步骤1/HARD-GATE中把关;“制作精良而非生成产物”的前景细节化) |
| 动态排印 / 文本为主 | hyperframes-motion/techniques.md(动态排印)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| 标题卡 / 下三分之一 / 叠加 / 画中画 / 文本后主体 | hyperframes-design/references/composition-patterns.md +(对于居中/缩放帧)/hyperframes/core → “根必须设置大小” |
| Logo / 品牌标记揭示 | hyperframes-motion/rules/svg-path-draw.md(描边动画)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| 数据 / 统计 / 数字 | hyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md |
| 产品 / 应用 / UI 演示 | hyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| 多场景 / 过渡 | hyperframes-motion/transitions/overview.md 然后 transitions/catalog.md(阅读概述后尚未完成——GSAP 配方在目录中) |
| 模块化 / 子合成 | /hyperframes/core/references/composition-patterns.md + references/sub-compositions.md |
输出清单 → /hyperframes/cli
-
npx hyperframes lint和npx hyperframes validate通过(阻塞后续结果) - 如果存在规范(
frame.md/design.md),则验证设计一致性——清单在hyperframes-design/references/design-adherence.md中 -
npx hyperframes inspect通过,或每个溢出都已有意标记 - 处理对比度警告;对于多场景作品,审查动画映射(
hyperframes-motion/scripts/animation-map.mjs) - 交付预览;仅当明确要求时才渲染为 MP4
- 仅在交接时展示预览(这是稳定的最终预览);不要在构建中途弹出预览——构建阶段的快照是无头的