小白可照做 · macOS / Windows

不会剪视频，也能教 AI 学会你喜欢的风格

你不是先学时间线、转场和音效，而是先装好环境，再把“原视频 + 逐字稿 + 参考成片 + 修改反馈”交给 AI。

让 AI 帮我安装我要手动安装

01 / 10 · 四个部件

先说清楚：你要装的不是一个剪辑软件

HyperFrames 是用 HTML 画面和时间线生成视频的工具。AI 负责读素材、写工程和修改，HyperFrames 负责预览、检查与渲染。

Node.js 22+运行 HyperFrames 命令。低于 22 不能继续。

FFmpeg把画面和声音编码成 MP4，本地导出必须有。

HyperFrames CLI创建项目、预览、检查和渲染。

HyperFrames Skills告诉 AI 正确的剪辑流程、动效规则与验收方法。

最重要的区别CLI 是执行工具，Skill 是 AI 的操作说明。只装其中一个，都不算完整。

02 / 10 · 不要急着下载

安装前，只检查三件事

你能打开终端

Mac 打开“终端”；Windows 打开 PowerShell。不会用没关系，只复制本页命令。

磁盘至少留 10 GB

安装文件不大，但视频、缓存、截图和成片很快会占空间。

素材放到固定文件夹

原视频、参考片、逐字稿分开放；不要直接在微信临时目录里开工。

node --version
ffmpeg -version

能看到版本号不等于版本合格：Node.js 必须是 v22 或更高；FFmpeg 能正常显示版本即可。

03 / 10 · 纯小白首选

推荐方法：把安装交给 AI，但要先让它检查

把下面这段完整发给 Codex、Claude Code、WorkBuddy 或其他能操作本地终端的智能体：

请帮我安装并验证 HyperFrames 视频剪辑环境。

要求：
1. 先只读检查当前系统、Node.js、npm、FFmpeg 和磁盘空间；
2. Node.js 必须是 22 或更高；
3. 缺少依赖时，先告诉我准备下载什么、从哪里下载、会修改什么；
4. 等我确认后再安装，不要删除或覆盖我的文件；
5. 安装 HyperFrames CLI 和完整 Skills；
6. 最后运行 npx hyperframes doctor；
7. 把每一项检查结果和失败项用中文告诉我。

看到授权窗口先核对命令只在安装 Node、FFmpeg、HyperFrames 或浏览器组件；看不懂就让 AI 解释，不能直接“一律允许”。

真实课程画面：在 AI 工作区提交任务 — 安装完成后，同一个智能体就能继续读取素材、创建工程和修改成片。

04 / 10

手动安装：按顺序装，不要一次复制一大串

第 1 步：安装 Node.js 22 或更高

从 Node.js 官方下载页选择 LTS 安装包。装完关闭并重新打开终端，再检查：

node --version
npm --version

第 2 步：安装 FFmpeg

macOS

如果已有 Homebrew：

brew install ffmpeg

没有时先看 brew.sh 官方说明。

Windows

在 PowerShell 中尝试：

winget install ffmpeg

若提示多个结果，运行 winget search ffmpeg，把结果交给 AI 选择。

第 3 步：安装 HyperFrames 与 Skills

npx hyperframes doctor
npx hyperframes skills

第一次运行可能询问是否下载 HyperFrames，核对包名后输入 y。直接使用 npx hyperframes ... 更容易保持版本正确。

05 / 10 · 不是 installed 就结束

看到这张“体检表”，才算真的装好

npx hyperframes doctor

Node.jsv22 或更高

FFmpeg / FFprobe两项都能找到

Chrome能找到或自动安装受管浏览器

HyperFramesCLI 能返回版本和环境信息

有红叉就不要继续做视频。把完整体检结果发给 AI，并明确说“只修失败项，已经通过的不要重装”。

06 / 10

创建第一个项目：原视频要复制进工程，不要覆盖

npx hyperframes init ai-video-course --video ./原视频.mp4
cd ai-video-course
npx hyperframes preview

source/ 或 assets/原视频、音频、图片、逐字稿

index.html主时间线与画面入口

compositions/章节、字幕、图解与转场

renders/最终导出；不要放回源素材目录

项目规则源文件只读；每次大修改另存版本；最终成片与工程、字幕审计、封面分开保存。

07 / 10

真正的工作流：让 AI 学“剪辑判断”，不是照搬画面

1原视频保留真实讲解与操作证据

2逐字稿帮助理解段落和字幕

3参考成片学习钩子、节奏、字幕、音效和转场

4先出样片先看 30–90 秒，再铺满全片

5反馈迭代说清时间点、问题和目标

AI 视频剪辑第一次成片效果 — 第一版不好看很正常。先判断它错在结构、遮挡、节奏还是风格理解。

请先分析参考视频，不要立即剪完整片。
请拆解：前三秒钩子、画面布局、字幕位置、停顿处理、音效、转场、人物位置和强调方式。
先给我一份风格规则，再用原视频做 60 秒样片。我确认后再扩展全片。

08 / 10

反馈不是“再好看一点”，而是明确指出哪里错

在 02:14–02:38，章节卡一直挡住操作界面。
请把章节卡缩短到 4–5 秒，之后恢复近全屏录屏；
只在我点击的按钮附近加细框，人物不要挡住菜单；
字幕保持底部，不要提前出现。修改后先给我 3 张关键帧。

一条合格反馈至少包含：时间点、当前问题、目标效果、不能改变的内容、复核证据。

09 / 10

导出前必须过五关：能播放只是最低标准

内容有没有删掉关键因果？口水词是否结合上下文处理？

画面讲操作时有没有遮挡屏幕？框选是否指向真实按钮？

字幕是否跟开口同步？有没有重叠、越界、错字？

声音人声是否连续？音乐是否盖住讲解？有没有爆音？

文件完整解码、时长合理、首中尾抽帧正常、版本名清楚。

npx hyperframes check --snapshots
npx hyperframes preview
npx hyperframes render --output final.mp4

10 / 10

常见报错：先看症状，再修一个点

node: command not foundNode 没装好，或终端没有重开。

Node version too old升级到 22 或更高；不要只升级 npm。

ffmpeg not foundFFmpeg 未安装或 PATH 未生效。

Chrome / browser error运行 npx hyperframes browser ensure 后重新体检。

预览黑屏确认在项目目录运行，且根目录有 index.html。

渲染很慢先做 30–90 秒样片，确认磁盘和源视频关键帧。

今天的最小闭环

环境体检通过 → 60 秒样片 → 明确反馈 → 完整成片

别先追求“一键生成”。真正可复用的是你对内容、节奏、证据和审美的判断标准。