media-use:在获取音频/图片素材前,请先调用
/media-use以从HeyGen目录中获取BGM/SFX/图片。首先运行--adopt以注册现有资产。详情请参阅/media-use技能。
网站转 HyperFrames 视频
捕获一个网站,然后从中生成专业视频。
在步骤0之前确认路线。 此技能制作的是_用于 / 源自一个普通网站_的视频。如果用户实际上是营销 / 发布 / 推广一个产品(即使是从此URL,即使是“我们网站的推广视频”)→ 请使用
/product-launch-video。没有网站的主题讲解 →/faceless-explainer;GitHub PR →/pr-to-video;对现有视频文件进行重新剪辑/重新调色/重新排序 → 超出范围。如果用户只是模糊地说“制作一个视频”,或者不确定是产品发布还是普通网站?请先阅读/hyperframes(完整路由表 + § HyperFrames 不能做什么)。
用户经常这样说:
- “把这个网站变成一个15秒的Instagram社交短片”
- “从 https://... 制作一个30秒的网站导览/展示视频”
- “捕获我们的首页,并用它自己的视觉效果构建一个视频”
工作流程包含7个步骤。每个步骤都会产生一个工件作为下一个步骤的先决条件。默认情况下是协作式的——标记为 💬 的关卡会停下来询问用户。如果用户指定了自主模式(“替我做决定”,“给我惊喜”),则跳过 💬 用户偏好关卡;详见 step-2-brief.md 了解其传播方式。
自主模式并不意味着“跳过所有关卡”。 自主模式涵盖了用户偏好问题(TTS提供商、声音、色彩强调、节拍数、是否使用音乐、是否使用字幕——由AI代理代表用户做决定)。它不涵盖质量验证关卡。以下关卡在自主模式下仍不可跳过:
- 资产审核(步骤3)——查看联络表并为每个资产论证使用/跳过的原因
- 逐拍HTML审查(步骤5)——每个节拍的证据块
- 完成度检查清单(步骤6)——包括动画映射、每个警告的WCAG验证、音频/运动回放
- 诚实披露部分(步骤6)——“我未验证的内容”必须出现在您的最终摘要中
如果您发现自己认为“自主模式倾向于行动,所以我会跳过X”——而X是一个验证关卡,而不是一个偏好问题——那么这个推理是错误的。倾向于行动适用于决定_构建什么_,而不是决定_是否验证_。
步骤0:捕获与理解品牌
阅读: references/step-0-capture.md
捕获网站,然后阅读提取的数据以理解品牌和产品——它做什么,为谁服务,用什么声音说话,处于什么情绪中。捕获的资产是以后使用的品牌工具包,而不是视频的构建块。
在简要说明之前显示登录状态——运行 npx hyperframes auth status 并逐字转发其输出(不要改写或重新表述)。 它会报告语音/BGM将使用HeyGen还是本地引擎,以及当未登录时,如何登录。如果未登录,请停止并等待用户选择——登录,或说“go”/“offline”以继续使用本地引擎——然后再询问简要说明或其他任何事情。 将其视为一个真正的决策点,而不是一个附注;不要将选择折叠到简要说明问题中,也不要将密钥写入每个仓库的 .env 文件中。(在自主模式下,记录状态并继续使用离线模式。)请参阅 ../hyperframes-media → Preflight 获取权威指导。
关卡: 输出网站摘要——先策略(产品做什么,为谁服务,品牌声音),然后是资产/颜色/字体清单;已显示登录状态(已登录,或继续使用离线模式)。
步骤1:品牌标识
阅读: references/step-1-design.md
编写 DESIGN.md ——一个涵盖视觉标识的品牌速查表:颜色、排版、组件样式、布局原则。使用 design-styles.json 获取精确的计算值。
速度选项: 对于快节奏视频(每拍一个广告牌),DESIGN.md 可以是一个包含颜色+字体+注意事项的50行摘要——而不是300行的文档。步骤5中的子代理提示会直接粘贴品牌值,因此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 和合成画面。子代理在报告之前对每个节拍运行 hyperframes lint 和 hyperframes snapshot。
关卡: 每个 compositions/beat-N.html 都已由主代理从头到尾对照 DESIGN.md 和 STORYBOARD.md 阅读。逐拍检查清单位于 step-5-build.md 中。
步骤6:验证与交付
阅读: references/step-6-validate.md
进行 lint、验证、根据视频长度(公式:max(节拍数 × 3, ceil(持续时间秒数 / 2)))缩放快照数量并审查每一个。在交付前修复问题。交付 localhost Studio 项目URL——仅在用户明确要求时才渲染为MP4。仅在交接时提供该Studio URL——它是最终、稳定的预览;构建阶段的快照是 headless 的,因此不要在构建过程中弹出预览。
交付一个您引以为豪的作品。 在交出之前,问问自己:我会把这个作品发布到社交媒体并署上我的名字吗?如果不会,请修复问题。
关卡: 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 技能中) |