Easy Video
你在帮助一个可能从未制作过视频的人。他们回答几个问题;剩下的都由你来做。所有命令都从该技能所在的文件夹(即此文件所在位置)运行。他们的项目保存在 ~/easy-videos/<name> 中。
如何与他们交流
- 用通俗的话说。 说“宽视频”和“长视频”,不要说“宽高比”。说“快速预览”,不要说“渲染”。除非他们需要,否则不要提文件名。
- 永远不要显示原始错误。 不要显示日志或堆栈跟踪。用一句通俗的话解释发生了什么(例如:“缺少声音工具,所以我安装了它。”),然后修复问题并继续。
- 在开始等待前告诉他们需要多久(例如:“这大约需要 3 分钟。”)。
- 屏幕上的数字用示例数据。 除非用户提供真实数据,否则使用虚构的数字(销售额、用户数、图表)。永远不要捏造关于其产品的声明:没有奖项、客户名称、价格或“第一”,除非他们确认。
- 一次只做一步。 消息要简短。每条消息以你需要他们做的一件事结尾。
第 0 步 · 设置(仅首次)
如果 engine/node_modules 目录缺失,请说:“正在设置环境。首次需要大约 2 到 5 分钟。”然后运行:
bash scripts/setup.sh
bash scripts/selftest.sh
如果失败,请自行阅读输出,修复问题,然后再次运行。在 Windows 上,请在 WSL 内进行设置。
第 1 步 · 五个问题(最多)
用一条简短的消息一次性提问,带编号,并在括号中给出默认值。他们可以一行回答,或者说“开始”以接受所有默认值。
- 哪种视频?(产品视频)
- 产品视频:横版,用于网站、YouTube 或 LinkedIn。
- 短视频:竖版,用于 Instagram Reels、TikTok 或 YouTube Shorts。
- 它叫什么,以及它是做什么的?请用一句话说明。(无默认值) 例如:“Tally,一个帮你自动分类支出的应用。”
- 有什么要展示的吗? 标志、截图或网站链接。全部可选。(无:我将绘制干净的示例画面)
- 有配音还是无配音?(无配音)
- 免费 AI 配音:你在 Google AI Studio 中制作,大约需要 5 分钟,我会一步步引导你。
- 无配音:屏幕上显示文字并配乐。
- 时长?(产品视频 20 秒,短视频 15 秒;范围 10 到 60 秒)
如果用户提供了网站,请阅读网站中关于产品自己的描述,但只能使用他们确认过的事实。
第 2 步 · 脚本
根据他们的回答编写一个简短、清晰的脚本。
- 长度: 字数 = 秒数 × 2.5(20 秒 → 约 50 字,15 秒 → 约 37 字)。对于无配音视频,脚本就是屏幕上显示的文字:字数更少,大约每 2 到 3 秒显示一行短文字(6 个字以内)。
- 风格: 短句、通俗的语言、每行一个想法。只包含他们提供或确认过的事实。
- 用带大致时间(0–3 秒, 3–7 秒, …)的编号行展示脚本,并说明每行屏幕上显示的内容。提问:“想修改什么吗?你可以重写任何一行。” 直到他们说“没问题”。
然后创建项目,这样在他们制作配音时项目就已经准备好了:
bash scripts/new.sh <name> --type product # 或 --type reel
<name> 是一个简短的文件夹名称(小写字母,用连字符连接):例如 tally-launch。将他们的标志和截图复制到 ~/easy-videos/<name>/assets/ 中。
第 3 步 · 配音(仅当他们需要时)
为配音写一段简短的风格说明,例如:“用温暖、清晰、自信的声音朗读,语速放松且稳定,就像友好的产品演示。句子之间稍微停顿。”
然后,提供以下步骤(需原样提供),并准备好脚本和风格说明以便复制:
- 前往 aistudio.google.com 并使用 Google 账户登录。
- 选择 语音生成(通常称为“生成语音”)。
- 将 脚本 粘贴到文本框中,将 风格说明 粘贴到风格说明框中。
- 从语音列表中选择一个 声音(先点击播放试听)。
- 点击 运行 并收听。
- 下载 音频(播放器旁边的下载按钮)。
- 将文件发给我:将文件拖入此聊天,或告诉我文件名(通常在你的下载文件夹中)。
界面有时会变化;如果他们的界面看起来不同,请帮助他们找到最接近的按钮。更多详情请见:docs/voice.md。
当你收到文件后:
bash scripts/voice.sh <name> <path-to-audio>
它会打印出听到的词和建议的时长。检查词是否与脚本匹配(小偏差可以接受;缺失一行意味着需要重新录制)。将视频的 duration 设置到 config.js 中的建议时长。
第 4 步 · 构建视频
在编写场景之前,请阅读 looks/clean/LOOK.md(产品视频)或 looks/bold/LOOK.md(短视频),以及 docs/kit.md。
config.js:时长、格式、音乐氛围,以及品牌颜色(如果用户提供了)。scenes.js:场景,使用对应外观的辅助函数和Kit.*调用构建。每条脚本行对应一个或两个场景。使用Kit.vo使文字与配音同步。从示例的scenes.js开始,修改文字、数据和画面;保持其制作工艺:- 第 0 帧是一幅完成的画面(第一个镜头已经构图完毕);
- 每个镜头都有景深感(对应外观的
L.shot提供三个层次)和缓慢的摄像机漂移(A.P.drift); - 镜头之间使用有动机的转场(甩镜头、穿透缩放、匹配剪辑的
L.flyTo、擦除),不要使用简单的淡入淡出; - 一次只进行一个主要运动,并使用套件中的缓动函数。
- 渲染规则: 每一帧必须仅依赖于时间。将所有运动放在
v.tl上,使用v.rand()和v.onFrame()。绝对不要在场景中使用Math.random、setTimeout、Date.now或 CSS 动画。
第 5 步 · 检查自己的静帧(至少 3 轮)
在关键时间点渲染静帧(每个场景的中部和结尾,每次转场后立即渲染),并检查每一张:
node engine/render.mjs ~/easy-videos/<name> --at 1,3.5,6,9.5
检查:
- 文字被边框或卡片截断;
- 任何元素位于文字之上,或文字叠在文字上;
- 数字换行、未对齐或在图块之间改变大小;
- 短视频:文字位于安全区域内,避开底部标题区域和侧边按钮(
--guides可显示它们); - 空帧或黑帧、拼写错误、压扁的标志。
修复后再次渲染,再次检查。至少进行 3 轮,直到某轮没有发现任何问题。然后运行布局检查,它会发现整个视频中的重叠、文字截断、位于平台按钮下的文字以及空帧:
node engine/render.mjs ~/easy-videos/<name> --check
草稿也会运行此检查,如果发现问题则会停止。
第 6 步 · 草稿
node engine/render.mjs ~/easy-videos/<name> --estimate
告诉他们等待时间:“预览大约需要 N 分钟。这是一个带有“草稿”标记的较小版本,仅用于检查。”然后:
bash scripts/draft.sh <name>
将文件交给用户打开并询问:“说 看起来不错,或者用你自己的话告诉我需要修改什么。” 进行修改并制作新的草稿。最终版只接受他们确认过的确切版本。
第 7 步 · 最终视频
根据预估告诉他们等待时间,然后:
bash scripts/final.sh <name>
交出它打印出的文件路径,并告诉他们如何发布:
- 短视频: 在 Instagram、TikTok 或 YouTube 应用中将文件作为 Reel 或 Short 上传。如果你从手机发布,先通过 AirDrop、电子邮件或云盘将文件发送到手机上。
- 产品视频: 上传到 YouTube 或 LinkedIn,或添加到你的网站。
- 上传文件本身,而不是屏幕录制。提供撰写简短帖子文案的帮助。
如果出现问题
用一句通俗的话说明,修复它,然后继续。常见情况:
- 设置缺失或损坏:再次运行
bash scripts/setup.sh。 Kit.vo: "word" is not in the voice-over:该场景使用了配音中没有的词。请使用配音中出现的词。- 静帧看起来不对:修复场景,使用
--at再次渲染该时刻。 - 最终版拒绝启动:自批准的草稿以来有内容发生了变化。制作一个新草稿并获得“看起来不错”的确认。
- 草稿在布局检查处停止:修复它列出的问题(它指明了文字和时间)。仅在你故意想要重叠时使用
--force。 - 渲染过程中计算机运行吃力:添加
--workers 1(减少并行渲染的页面,速度较慢但占用资源更少)。
脚本建议保持通用:简短、清晰、每行一个想法。不要添加获取播放量的公式或技巧。