使用指南

网站转视频

捕获任何网站并通过一条提示词将其转化为生产级视频。

给你的 AI 代理一个 URL 和创意方向。它会捕获网站、提取品牌识别、编写脚本和故事板、生成配音、构建动画合成,并交付可渲染的视频。

"Create a 20-second product launch video from https://linear.app.
Make it feel like an Apple keynote announcement."

快速开始

安装 skills

Skills 教会你的 AI 代理如何捕获网站和创建 HyperFrames 合成。安装一次——跨会话持续存在。

npx skills add heygen-com/hyperframes

适用于 Claude CodeCursorGemini CLICodex CLI

提示你的代理

在任意目录中打开你的代理并描述你想要的视频:

Create a 25-second product launch video from https://example.com. Bold, cinematic, dark theme energy.

代理在看到 URL 和视频请求时加载 skill,并运行完整流水线——采集、设计、脚本、故事板、配音、构建、验证。

ℹ️ Note

代理在看到 URL 和视频请求时也会自动触发此 skill。

预览

npx hyperframes preview

在浏览器中打开视频。编辑自动重新加载。

渲染为 MP4

npx hyperframes render --output my-video.mp4
✓ Captured 750 frames in 12.4s
✓ Encoded to my-video.mp4 (25.0s, 1920×1080, 6.8MB)

ℹ️ Note

你不需要手动运行 npx hyperframes capture——skill 会指示代理在第一步进行采集。采集命令在下方有高级用法文档。

流水线如何工作

Skill 遵循 Hyperframes 流水线:七个步骤,每个步骤产生一个命名产物供下一步使用。

步骤输出操作
采集capture/提取截图、设计令牌、字体、素材、动画
设计DESIGN.md品牌参考——颜色、字体、注意事项
脚本SCRIPT.md包含开头钩子、故事、证据、CTA 的旁白文本
故事板STORYBOARD.md逐拍创意方向——氛围、素材、动画、过渡
配音 + 时序narration.wav + transcript.json带词级时间戳的 TTS 音频
构建compositions/*.html动画 HTML 合成,每个拍一个
验证快照 PNG交付前的视觉验证

每个步骤的详细说明、每个生成文件的内容以及如何在不重新运行整个流水线的情况下迭代,请参见流水线指南。此结构对任何 Hyperframes 项目都有用,不仅仅是网站采集。

视频类型

提示词决定格式。包含时长和创意方向:

类型时长示例
社交广告10-15s"15 秒 Instagram 轮播。充满活力,快节奏剪辑。"
产品发布20-30s"25 秒产品发布。Apple 发布会风格。"
产品导览30-60s"45 秒导览,展示前 3 个功能。"
品牌宣传15-30s"20 秒品牌视频。展示设计理念。"
功能公告15-25s"功能公告,突出新的 AI 代理。"
预告片8-15s"10 秒预告片。超级极简。只有钩子。"

💡 Tip

创意方向比格式更重要。"俏皮、手工感""暗色、面向开发者、展示代码" 会塑造故事板并驱动代理做出的每个视觉决策。

通过 Gemini Vision 增强采集

默认情况下,采集使用 DOM 上下文描述素材——alt 文本、附近标题、CSS 类。添加 Gemini API 密钥可获得使用视觉的更丰富的 AI 驱动描述。

在项目根目录创建 .env 文件:

echo "GEMINI_API_KEY=your-key-here" > .env

不使用 Gemini

- hero-bg.png — 582KB, section: "Hero", above fold

代理知道文件存在及其在页面上的位置,但不知道它长什么样。

使用 Gemini

- hero-bg.png — 582KB, A gradient wave in purple and blue sweeps
across a dark background, creating an aurora-like effect.

代理知道图片实际显示的内容,从而在故事板中做出更好的创意决策。

层级速率限制每张图片费用
免费5 RPM免费
付费2,000 RPM约 $0.001

典型包含 40 张图片的采集在付费层费用约为 $0.04

采集命令

Skill 自动运行采集,但你可以直接运行它用于预缓存、调试或将数据用于视频制作之外。

npx hyperframes capture https://stripe.com
◇  Captured Stripe | Financial Infrastructure → captures/stripe-com

Screenshots: 12
Assets: 45
Sections: 15
Fonts: sohne-var
标志默认值描述
-o, --outputcaptures/<hostname>输出目录
--timeout120000页面加载超时(毫秒)
--skip-assetsfalse跳过下载图片和字体
--max-screenshots24最大截图数量
--jsonfalse输出结构化 JSON 供程序化使用

采集了什么

数据描述
截图每个滚动深度的视口捕获——基于页面高度的动态数量
颜色像素采样的主色 + 计算样式,包括 oklch/lab 转换
字体CSS 字体族 + 下载的 woff2 文件
素材带语义名称的图片、SVG、Lottie 动画、视频预览
文本DOM 顺序中的所有可见文本
动画Web Animations API、滚动触发动画、WebGL 着色器
区块带标题、类型、背景颜色的页面结构
CTA通过类名和文本模式检测到的按钮和链接

快照命令

从构建的视频中捕获关键帧为 PNG——无需完整渲染即可验证合成:

npx hyperframes snapshot my-project --at 2.9,10.4,18.7
标志默认值描述
--frames5均匀间隔的帧数
--at以逗号分隔的时间戳(秒)
--timeout5000等待运行时初始化的毫秒数

迭代

你不需要重新运行整个流水线来进行更改:

  • 编辑故事板——STORYBOARD.md 是创意北极星。更改一个拍的氛围或素材,然后要求代理仅重建该拍。
  • 编辑合成——直接打开 compositions/beat-3-proof.html 并调整动画、颜色或布局。
  • 重建一个拍——"重建拍 2,更有活力。使用产品截图作为全出血背景。"

更多重新进入模式请参见流水线指南

故障排除

对于使用 Cloudflare 或重客户端渲染的站点,增加超时:
npx hyperframes capture https://example.com --timeout 180000

使用 Framer 等框架的站点通过 IntersectionObserver 延迟加载图片。采集会滚动页面触发加载,但非常长的页面可能会遗漏底部的图片。添加 Gemini 密钥可以改善采集素材的描述,但不会增加数量。

采集使用像素采样结合 DOM 计算样式。暗色站点应在调色板中显示暗色。检查 captures/<name>/screenshots/ 中的滚动截图查看采集实际看到的内容。

验证 skills 已安装:

npx skills add heygen-com/hyperframes

在提示词开头加上 "Use the /website-to-hyperframes skill" 以获得最可靠的结果。代理在看到 URL 和视频请求时也会自动发现它。

下一步