网站转 HyperFrames 视频
捕获一个网站,然后从中制作一个专业视频。
在第 0 步之前确认路由。 此技能将视频制作成 来自/关于一个通用网站 的视频。如果用户实际上是 营销/发布/推广一个产品(即使是从这个 URL 开始,甚至是“为我们网站做推广”)→ 请使用
/product-launch-video。一个 没有网站的话题解说 → 使用/faceless-explainer;一个 GitHub PR → 使用/pr-to-video;重新剪辑/重新调色/重新排序一个现有的视频文件 → 超出范围。如果用户只是模糊地要求“制作一个视频”,或者不确定是发布视频还是通用网站视频?请先阅读/hyperframes(完整路由表 + § HyperFrames 无法做到的事情)。
用户可能会说:
- “把这个网站变成一个 15 秒的 Instagram 社交短片”
- “制作一个 30 秒的网站导览/展示视频,来自 https://...”
- “捕获我们的主页,并基于其自身视觉元素构建一个视频”
工作流包含 7 个步骤。每一步都会产生一个工件,作为下一步的入口。默认情况下是协作模式——标记为 💬 的关口会停下来询问用户。如果用户指示了自主模式(“替我做决定”、“让我惊喜一下”),则跳过 💬 用户偏好问题;详情请参见 step-2-brief.md。
自主模式并不意味着“跳过所有关口”。 自主模式涵盖用户偏好问题(TTS 提供商、语音、颜色强调、节拍数、是否添加音乐、是否添加字幕——在这些问题上,Agent 代表用户做决定)。它不涵盖质量验证关口。在自主模式下,以下关口仍然不可跳过:
- 资产审计(第 3 步)——查看联系表并为每个资产说明 USE/SKIP 的理由
- 逐小节 HTML 阅读(第 5 步)——每个小节的结构化证据块
- DoD 清单(第 6 步)——包括动画映射、按警告逐条进行 WCAG 验证、音频/动作回放
- 诚实披露部分(第 6 步)——“我未验证的内容”必须出现在你的最终总结中
如果你发现自己在推理“自主模式意味着偏向行动,所以我会跳过 X”——并且 X 是一个验证关口,而不是一个偏好问题——那么这个推理是错误的。偏向行动适用于决定 构建什么,而不是决定 是否验证。
第 0 步:捕获与理解品牌
阅读: references/step-0-capture.md
捕获网站,然后阅读提取的数据以理解 品牌和产品——它做什么,为谁服务,用什么声音说话,遵循什么氛围。捕获的资产是后续使用的品牌工具包,而不是视频本身的构建块。
关口: 打印站点摘要——在资产/颜色/字体清单之前,采用战略优先的方式(产品做什么,为谁服务,品牌声音)。
第 1 步:品牌标识
阅读: references/step-1-design.md
编写 DESIGN.md——一份涵盖视觉标识的品牌速查表:颜色、字体、组件样式、布局原则。使用 design-styles.json 获取精确的计算值。
速度选项: 对于快节奏视频(每小节一个广告牌式的呈现),DESIGN.md 可以是一个 50 行的颜色+字体+注意事项总结,而不是一个 300 行的文档。第 5 步的子 Agent 提示会直接粘贴品牌值,因此 DESIGN.md 的深度仅对复杂构图才有意义。
关口: DESIGN.md 存在(任意长度)且至少包含:颜色调色板、字体选择以及注意事项。
第 2 步:策略与信息传递
阅读: references/step-2-brief.md,references/capabilities.md(扫读目录——仅在需要时深入阅读具体章节)
在讨论视觉效果或资产之前,与用户对齐 视频必须传达什么信息。解析用户的提示——他们可能已经提供了视频类型和风格。仅询问缺失的内容:这个视频必须说的一件事、叙事弧线和目标受众。
关口: 视频类型、时长、格式——以及关键的信息和叙事弧线——被锁定。没有这些,第 3 步无法编写概念优先的故事板。
第 3 步:故事板 + 脚本 💬
阅读: references/step-3-storyboard.md
编写概念优先的故事板:信息 → 叙事弧线 → 服务于弧线的小节 → 每小节的技术 → 最后通过品牌强调。然后编写匹配的旁白脚本。向用户展示两者,并附上逐小节总结。迭代直到他们批准。
关口: STORYBOARD.md + SCRIPT.md 存在 并且 用户已批准该计划。
第 4 步:画外音、时间轴 + 字幕 💬
如果第 2 步指明不需要旁白——询问背景音乐,然后跳到第 5 步。否则:询问用户使用哪个 TTS 提供商(HeyGen TTS、ElevenLabs 或 Kokoro),生成音频,转录,将时间戳映射到小节。然后询问字幕。
关口: 要么 (a) 未请求旁白且故事板包含手动小节时间,要么 (b) narration.wav + transcript.json 存在且小节时间已使用实际持续时间更新。
第 5 步:构建构图
阅读: hyperframes 技能(加载它——每条规则都很重要)
阅读: references/step-5-build.md
根据故事板(第 3 步)选择的架构和节奏构建 index.html 和构图。子 Agent 在报告之前,在每个小节上运行 hyperframes lint 和 hyperframes snapshot。
关口: 每个 compositions/beat-N.html 都由主 Agent 根据 DESIGN.md 和 STORYBOARD.md 从头到尾阅读过。逐小节检查清单位于 step-5-build.md 中。
第 6 步:验证与交付
阅读: references/step-6-validate.md
运行 Lint,验证,根据视频长度拍摄快照(公式:max(beats × 3, ceil(duration_seconds / 2))),并逐一审查。在交付前修复问题。交付 localhost Studio 项目 URL——仅在用户明确要求时才渲染为 MP4。仅在交接时 呈现该 Studio URL——它是最终、稳定的预览;构建阶段的快照是无头的,因此不要在构建过程中弹出预览。
交付一个你引以为豪的作品。 在交接之前,问问自己:我会把这段视频以我的名字发布在社交媒体上吗?如果不会,请修复问题。
关口: npx hyperframes lint 和 npx hyperframes validate 通过且无任何错误,最终响应包含活跃的 Studio 项目 URL。
快速参考
视频类型
按视频类型的典型约束——用作起点,而非公式。小节数量应依据内容和旁白而定,而非某个目标范围。
| 类型 | 典型时长 | 时长驱动因素 | 旁白 |
|---|---|---|---|
| 社交广告(IG/TikTok) | 10–15 秒 | 平台限制 | 可选 |
| 产品演示 | 30–60 秒 | 脚本长度 | 完整旁白 |
| 功能公告 | 15–30 秒 | 功能复杂度 | 完整旁白 |
| 品牌短片 | 20–45 秒 | 音乐轨道 | 可选,以音乐为重点 |
| 发布预告 | 10–20 秒 | 吸引力能量 | 最少 |
此表中未有意包含小节数量——它应来自故事板,而非来自“社交广告 = 3-4 个小节”。一个复杂产品的社交广告可能需要 5 个时机精准的小节。一个只有一个强烈视觉论点的品牌短片可能只需要 3 个小节。
格式
- 横屏:1920x1080(默认)
- 竖屏:1080x1920(Instagram Stories,TikTok)
- 方形:1080x1080(Instagram 信息流)
参考文件
| 文件 | 读取时机 |
|---|---|
| step-0-capture.md | 第 0 步——捕获、理解品牌和产品,编写战略优先的站点摘要 |
| step-1-design.md | 第 1 步——编写 DESIGN.md 品牌速查表(5 个部分,250-350 行;对于广告牌式社交广告,可使用 50 行快速路径) |
| step-2-brief.md | 第 2 步——与用户对齐信息、叙事弧线、受众 |
| capabilities.md | 第 2 步和第 5 步——HyperFrames 能做什么的完整清单(24 个部分)。在简报期间扫读目录,在构建期间深入阅读特定部分 |
| step-3-storyboard.md | 第 3 步——故事板 + 脚本(合并)并带有用户评审关口 |
| step-4-vo.md | 第 4 步——TTS 提供商选择、生成、时间轴 |
| step-5-build.md | 第 5 步——构建 index.html + 构图 |
| step-6-validate.md | 第 6 步——Lint,验证,快照(按视频长度缩放),预览 |
| techniques.md | 第 3 步和第 5 步——13 种原始动画技术及代码模式(改编,不要复制粘贴) |
| html-in-canvas-patterns.md | 第 5 步——HTML-in-Canvas 效果的完整代码模式(位于 hyperframes 技能内) |