OpenMontage HyperFrames 脚手架实战：init、capture 与 skills 命令详解

OpenMontage HyperFrames 脚手架实战init、capture 与 skills 命令详解【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage本文围绕 HyperFrames CLI 的三个脚手架命令init、capture、skills展开init用交互式向导或纯参数模式生成标准 HyperFrames 项目骨架capture把一个在线 URL 抓取为可编辑的视频工程skills则为本地 AI 编程环境安装 HyperFrames 技能包。读完本文你可以为不同终端TTY/CI/Agent选择正确的调用方式、理解每个参数背后的行为模板、分辨率、Whisper 转录、技能新鲜度检查并弄清这些命令在 OpenMontage 生产管线中的定位与边界。为什么用脚手架命令而不是手写文件HyperFrames 是 OpenMontage 的两大渲染运行时之一另一个是 Remotion适合 kinetic typography、产品宣传片、网站转视频等 HTML/GSAP 语法的场景。在 OpenMontage 的 HyperFrames 指南 中选型决策矩阵明确指出动态排版、产品 promo、registry 组件块数据图表、颗粒覆盖层、着色器转场应优先 HyperFrames。一旦选定 HyperFrames项目文件不应手工创建。如 hyperframes-cli 技能主文件 所述整个开发循环都通过npx hyperframes驱动要求 Node.js ≥ 22 与 FFmpeg其第 1 步 Scaffold 就是npx hyperframes init my-video或从 URLcapture。脚手架命令的价值在于它们负责搭建正确的文件结构、拷贝媒体、运行转录、并安装 AI 编码技能——这些是手写文件难以对齐的约定。init交互式与纯参数两种调用模式init的默认行为取决于 TTY在终端里运行会进入交互式向导询问示例模板与选项在 CI、Agent、管道输出等非 TTY 环境下CLI 自动切换到非交互模式并且强制要求--example缺失时会直接报错并给出用法示例。在 TTY 上也可以用--non-interactive强制纯参数模式npx hyperframes init my-video # TTY: 交互式向导 npx hyperframes init my-video --example warm-grain # 指定一个示例 npx hyperframes init my-video --example blank --resolution portrait npx hyperframes init my-video --video clip.mp4 # 附带视频文件 npx hyperframes init my-video --audio track.mp3 # 附带音频文件 npx hyperframes init my-video --example blank --tailwind # Tailwind v4 浏览器运行时 npx hyperframes init my-video --non-interactive --example blank # CI/Agent — 纯参数模式可选模板--example支持以下 9 个模板blank— 空白骨架warm-grain— 暖色调颗粒质感play-mode— 播放模式swiss-grid— 瑞士网格排版vignelli— Vignelli 风格decision-tree— 决策树kinetic-type— 动态排版product-promo— 产品宣传片nyt-graph— 纽约时报风格图表其中kinetic-type、product-promo、swiss-grid三个模板与 OpenMontage 的运行时选型决策矩阵 中 产品宣传片 / 标题卡 / 重度文字动效优先 HyperFrames 的建议直接对应可作为相应场景的起点。分辨率预设--resolution接受以下预设预设值输出分辨率landscape1920×1080portrait1080×1920landscape-4k4K 横屏portrait-4k4K 竖屏square1080×1080square-4k4K 方屏另提供别名1080p、4k、uhd、1080p-square、4k-square。竖屏portrait预设对应短视频投放方屏预设适合信息流场景。其余常用参数--skip-skills— 目前被临时忽略在 skills.sh 注册表补齐之前init始终会对照 GitHub 检查 AI 编码技能下文详述。要在 CI/测试中真正跳过改用环境变量HYPERFRAMES_SKIP_SKILLS1。--skip-transcribe— 不对--audio/--video自动做 Whisper 转录。--model、--language— 指定自动转录使用的 Whisper 模型与语言。--tailwind— 生成 Tailwind v4 浏览器运行时的脚手架。注意它与 Studio 的 Tailwind v3 配置不同从源码文档看启用后应先调用hyperframes-coreTailwind 参考技能再编辑 class 或主题 token避免用错版本约定。媒体自动转录当传入--audio或--video时init会用 Whisper 自动转录该文件产出可直接用于字幕/分镜的时间轴。关于语音与模型的选择规则见hyperframes-media技能在 HyperFrames 路由技能 的技能清单中有对应条目。skills 新鲜度机制init 不只是生成文件从 hyperframes-cli 技能主文件 的工作流描述与 HyperFrames 上游技能文档 可以看到init还承担保持 AI 技能新鲜的职责HyperFrames 技能是版本化的。每次init都会把本地已安装的技能与 GitHub 上的最新版对照只要有过旧或缺失的技能就会安装/刷新整套技能集合项目已是最新时这一步是 no-op。该检查是一次快速的 GitHub 往返离线或 API 限流时会在短暂超时后降级为直接安装保证init不会因为网络抖动而硬性失败。--skip-skills参数被临时废除neutered传它也不会跳过检查CI/测试的唯一退出通道是HYPERFRAMES_SKIP_SKILLS1。想单独管理技能而不重新 init可用检查npx hyperframes skills check加--json输出机器可读结论任何一项过旧或缺失时退出码非零更新npx hyperframes skills update— 拉取全套最新技能并补齐尚未安装的部分与 init 的安装步骤等价。此外render/lint/validate运行时若检测到技能过旧CLI 会额外打印一行提醒。环境前提npx hyperframes要求 Node.js ≥ 22 与 FFmpeg 在 PATH 上。OpenMontage 的 HyperFrames 指南 中 preflight 的最低门槛runtime floor与此一致Node 主版本 ≥ 22、ffmpeg在 PATH、npx在 PATH、npx hyperframes doctor退出码为 0bun不是必需的HyperFrames 以公共 npm 包hyperframes发布通过npx消费。仓库根目录的 Makefile 提供了make hyperframes-doctor目标可一键探测 Node/FFmpeg/npx 并运行hyperframes doctor。capture把一个 URL 变成可编辑的视频工程当用户的起点是一个 URL 时把这个网站做成视频、从我们的主页做个社交短片用capture而不是initnpx hyperframes capture https://stripe.com # 从网站生成骨架 npx hyperframes capture https://linear.app -o linear-video # 自定义输出目录 npx hyperframes capture https://example.com --json # JSON 输出供 Agent 消费 npx hyperframes capture https://example.com --skip-assets # 跳过图片/SVG 下载 npx hyperframes capture https://example.com --max-screenshots 12 npx hyperframes capture https://example.com --timeout 60000 # 页面加载超时毫秒capture的行为是用无头浏览器抓取目标 URL截图逐张成为分层场景站点资产图片/SVG 等下载到本地最终产物是一个标准的 HyperFrames 项目——可以像init生成的项目一样执行lint、preview、render。参数要点-o— 自定义输出目录名例如把https://linear.app抓成linear-video工程--json— 输出 JSON 结果供 Agent/CI 解析与 CLI 技能主文件 中 --json在除render/preview/play外的所有命令上都可用 的约定一致--skip-assets— 跳过图片/SVG 下载适合只关心结构骨架或网络受限时--max-screenshots— 限制抓取截图数量默认行为是滚动抓取整页长页面会截很多张--timeout— 页面加载超时时间毫秒慢站点或重站点需要调大。这条命令是website-to-video工作流的机械底座——抓取后后续的创意方向、节奏与动效编排由对应的 Layer 3 技能接管见 HyperFrames 技能路由。skills一次性安装 HyperFrames 技能包npx hyperframes skills # 为 AI 编程工具安装 HyperFrames 技能这是一次性设置命令把 HyperFrames 技能包装入本地 AI 编程环境包含核心技能hyperframes-core、hyperframes-creative、hyperframes-animation、hyperframes-cli、hyperframes-registry、hyperframes-media编排器product-launch-video与hyperframes两个 orchestrator 技能。安装后Agent 在处理 HyperFrames 任务时会遵循框架约定data-*时序属性、GSAP 时间轴规则、确定性渲染约束等。重大版本升级 HyperFrames 后应重新运行日常维护则用skills check/skills update子命令即可。与 OpenMontage 生产管线的关系init 的适用边界理解init的适用场景需要区分两条路径——这正是 OpenMontage HyperFrames 指南 中明确的反模式所在管线模板化路径不跑initOpenMontage 的 compose 阶段由hyperframes_compose工具直接物化工作区。从 tools/video/hyperframes_compose.py 的_scaffold实现注释可以看到This does NOT callhyperframes init— we want full control over the generated files so they map cleanly to edit_decisions。管线需要把edit_decisions的 cuts、asset_manifest的资产路径、playbook 风格映射为 HyperFrames 文件index.html时间轴、data-start/data-duration、CSS 变量 DESIGN.md并自己写出hyperframes.json注册表 URL 与安装路径配置。因此不应从 OpenMontage 编排器里运行hyperframes init——init自带项目语义与技能安装是为人类手动启动项目设计的。Atelier 手写作路径可以跑init在 bespoke-composition 元技能 中HyperFrames 路径明确建议从projects/目录运行npx hyperframes init slug。init 会生成index.html、meta.json、package.json以及一份每项目CLAUDE.md用于把后续 Agent 会话自动路由到/hyperframes子技能之后再手写index.html、按需挂data-composition-src子组合最后经lint→validate→snapshot验证再由video_compose以render_runtime: hyperframescomposition_mode: atelier驱动渲染。两条路径生成的工作区结构一致位于projects/project-name/hyperframes/下index.html根组合、compositions/子组合与 registry 块、assets/、hyperframes.json、DESIGN.md等且不复用 Remotion 的remotion-composer/public/——HyperFrames 相对项目根解析data-composition-src、src与 registry 块混合运行时会互相污染。脚手架之后进入开发循环init/capture只是 CLI 开发循环 的第 1 步Scaffold后续依次是编写 HTML 组合hyperframes-core技能→npx hyperframes lint静态契约缺data-composition-id、轨道重叠、未注册时间轴→npx hyperframes validate无头 Chrome 运行时错误 WCAG 对比度→npx hyperframes inspect文本溢出检测→npx hyperframes preview打开 Studio 时间线编辑器供用户审阅 →npx hyperframes render交付。两条 Agent 侧约定值得注意render前必须经用户确认user-gated渲染退出码为 0 后还要用[ -s $OUTPUT ]或ffprobe验证产物确实存在且时长合理。命令速查场景命令终端交互式起步npx hyperframes init my-videoCI / Agent 纯参数npx hyperframes init my-video --non-interactive --example blank --resolution portrait竖屏 4K 产品宣传片npx hyperframes init promo --example product-promo --resolution portrait-4k带配音自动转录npx hyperframes init my-video --audio track.mp3网站转视频npx hyperframes capture https://example.com -o my-video --json安装/刷新技能包npx hyperframes skills、npx hyperframes skills check --json、npx hyperframes skills update环境体检npx hyperframes doctor或make hyperframes-doctor以上命令与参数均取自 init-and-scaffold 参考文档 及其配套技能文件可在满足 Node ≥ 22 FFmpeg 的环境中直接执行验证。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考