media-use: 在获取音频/图片前,先调用
/media-use从 HeyGen 目录中解决背景音乐/音效/图片。先运行--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 提供商、语音、颜色强调、节拍数、音乐是/否、字幕是/否——即由代理代表用户做决定)。它不涵盖质量验证关卡。以下关卡在自动模式下仍不可跳过:
- 资产审计(步骤 3)——查看联系表并为每个资产论证使用/跳过理由
- 逐节 HTML 读取(步骤 5)——每个节拍的结构化证据块
- 交付清单(步骤 6)——包括动画映射、逐警告的 WCAG 验证、音频/动态播放
- 诚实披露部分(步骤 6)——“我没有验证什么”必须出现在你的最终总结中
如果你发现自己推理“自动模式倾向于行动,所以我会跳过 X”——而 X 是一个验证关卡,不是偏好问题——那么这种推理是错误的。倾向行动适用于决定 构建什么,而不是决定 是否验证。
步骤 0:抓取与理解品牌
阅读: references/step-0-capture.md
抓取站点,然后阅读提取的数据以理解品牌和产品——它是做什么的、为谁而做、用什么声音说话、处于什么情绪中。抓取的资产是稍后使用的品牌工具包,而不是制作视频的构建块。
在简报前显示登录状态——运行 npx hyperframes auth status 并逐字转述其输出(不要转述或重写)。 它会报告语音/背景音乐将使用 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
检查代码、验证、拍摄缩放至视频时长的快照(公式:max(节拍数 × 3, ceil(时长_秒 / 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——检查代码、验证、快照(缩放至视频时长)、预览 |
| techniques.md | 步骤 3 和 5——13 种原始动画技术及其代码模式(应适应使用,而非复制粘贴) |
| html-in-canvas-patterns.md | 步骤 5——Canvas 内 HTML 效果的完整代码模式(位于 hyperframes 技能中) |