Reels模板
本技能内置了十五个数据驱动的Remotion模板(1080x1920,60 fps),位于 assets/reels-kit/ 中。一个视频对应一个JSON作业文件:选择模板,填写其属性,然后渲染。日常作业无需编写React代码。
以下以 reels/ 开头的路径位于工作文件夹中,而非本技能文件夹内。请勿为作业编辑技能文件夹内的文件。
无人值守运行。 本技能专为自主代理设计。请求者 是启动作业的人:一个协调代理、一个管道或一个人。根据本文件中的规则做出所有决策,永远不要停下来请求批准某个步骤。仅在遇到无法解决的阻塞问题时才停止(例如缺少工具、媒体文件缺失或无法读取、渲染持续失败),并报告问题。每个作业都以一份报告结束(第4节)。
0. 设置工作区
每个项目只需执行一次,在第一个作业之前。
- 检查工具:Node.js 18 或更高版本(
node -v),以及ffmpeg和ffprobe是否在PATH环境变量中。如果缺少某一个,请停止并报告为阻塞问题。不要自行安装系统软件。 - 如果工作文件夹中已有
reels/render.mjs,则使用该工作区并跳转到第1节。 - 否则,将本技能的
assets/reels-kit/文件夹复制到工作文件夹的reels/目录下(例如cp -R <skill-dir>/assets/reels-kit reels),然后在reels/目录内运行npm install。 - 创建文件夹
reels/public/(媒体文件)和reels/jobs/_local/(临时作业)。如果工作文件夹是一个Git仓库,请将reels/node_modules/、reels/public/、reels/out/、reels/exports/和reels/jobs/_local/添加到其.gitignore文件中。
工作区包含 render.mjs(渲染作业)、clean.mjs(释放磁盘空间,见第6节)、src/(模板和共享工具包)、jobs/examples/(每个模板一个示例作业)、public/<name>/(每个作业的输入媒体)、out/stills/(QA静态图片)和 exports/<name>/(每个作业的最终视频)。
偏好设置
此仓库不包含任何人的偏好。文本样式、字体、强调色、文案语气、语言、音乐以及优先使用哪种格式,都来自请求者的简报以及您已经了解的品牌信息,绝不来自模板或此文件中写入的值。当简报中规定了偏好时,请在作业文件中应用它。当简报未规定时,请使用模板默认值并在报告中列出。不要将个人或品牌的偏好写入模板、示例作业或本技能中。
1. 选择模板
当视频应感觉像是某人发布的内容时,从社交原生格式开始。当素材本身承载视频内容时,使用广告格式。
社交原生格式(观众已经熟悉的界面是吸引点)
| 模板 | 何时使用 | 需要提供 |
|---|---|---|
ChatStory | 通过短信聊天记录讲述一个故事,然后展示产品 | 消息(+一张产品照片用于发送)、收尾片段 |
NotesList | 一个笔记应用列表,自动逐字打出:"失败的礼物 vs 她留下的那个" | 标题 + 1 到 7 行,收尾片段 |
SearchHook | 将客户的问题输入搜索栏,由素材给出答案 | 一个查询(+ 建议),1 个或多个片段 |
NotificationStack | 锁屏上充满订单、消息、评论:社会证明和错失恐惧症 | 1 到 6 条通知,背景,收尾片段 |
PolaroidDump | 剪贴簿照片墙,附有手写说明 | 2 到 8 张照片 |
Ranking | 盲排名:项目按顺序落入编号列表,第一名最后 | 2 到 6 个片段,每个片段一个标签和排名 |
PollSticker | 在素材上添加故事投票:两个选项,点击,显示结果 | 一个问题,2 个选项及其百分比,片段 |
广告格式(素材优先,文字叠加其上)
| 模板 | 何时使用 | 需要提供 |
|---|---|---|
BeatCutAd | 默认用于从素材剪辑的产品广告:多个镜头、钩子、行动号召 | 1 个或多个视频片段 |
UgcCaptions | 有人对着镜头说话;逐字字幕 | 1 个带语音和单词时间码的片段 |
Listicle | "三大理由"、技巧、功能、步骤 | 2 到 7 个片段,每个对应一个要点 |
BeforeAfter | 展示转变或对比(mode:wipe 或 split) | 2 个片段或照片 |
ProductSlideshow | 只有产品照片,或快速目录;可选的价签贴纸 | 2 张或更多照片或片段 |
Testimonial | 社会证明:带星级的评论卡片 | 1 个背景片段 + 评论文字 |
CommentReply | 回答异议或常见问题;评论气泡是吸引点 | 1 个或多个片段 + 评论内容 |
OfferPromo | 促销、折扣码、截止日期 | 1 个或多个片段 + 优惠信息 |
如果简报不适合任何模板,请参见第7节。不要强行使用模板做它不擅长的事情。
官方的Remotion技能(remotion-best-practices,通过 npx skills add remotion-dev/skills --skill remotion-best-practices 单独安装)是编写Remotion代码的参考。如果未安装,请使用Remotion文档 https://www.remotion.dev/docs。对于在此仓库中制作视频,当两者有差异时,以本技能为准:构建作业文件而不是新项目或组合,检查静态图片而不是打开Studio,并且一旦静态图片通过就使用 render.mjs 渲染,无需等待指令。
2. 构建作业
- 选择作业名称(小写字母、数字和
-,例如xmas-ornament)。它将成为作业文件的name,输入文件夹reels/public/<name>/和输出文件夹reels/exports/<name>/。仅复制此作业使用的文件到reels/public/<name>/,并保留原始文件在原来位置。在报告中注明每个输入的来源,以及public/中的副本是否是唯一副本(下载或生成的文件)。将每个src写为<name>/<file>。对每个文件运行ffprobe以获取其时长。媒体文件永远不会被提交到版本控制:public/被git忽略,因此示例作业中的路径(footage.mp4、music.m4a、demo/…)在您放置自己的文件之前都是占位符。 - 在放置文字前检查素材:为每个镜头提取一帧(
ffmpeg -ss <t> -i <file> -frames:v 1),并记下产品的位置。 - 阅读
reels/jobs/examples/<Template>.json。它列出了该模板接受的每个属性。将其复制到reels/jobs/<job>.json并进行编辑。对于应保持在Git之外的作业,请使用reels/jobs/_local/。
作业文件:
{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
"props": { },
"i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }
i18n.<lang> 将覆盖 props,因此它只包含已翻译的字符串。对象数组合并逐项进行(null 保留基础项);字符串数组则替换。
每个模板共享的属性:
hook:{ lines (1-3), band, size, duration }。从0秒开始显示,默认2.2秒。cta:{ lines, button, band, size, duration }。在最后duration秒内显示,默认2.5秒。其他字幕在它开始播放时结束。music:{ src, volume }。在末尾淡出。在有语音时使用大约0.15的音量。brand:{ accent (hex), font: poppins | montserrat | anton, textStyle: outline | box | caption }。outline(默认)和box是响亮的广告风格。caption是本机应用内字幕样式:白色标题大小写文本,位于一个深色圆角框中,在其区域顶部,淡入;以第一人称故事线的方式编写,最多2行,每行最多30个字符。- 一个片段:
{ src, start (进入源的时间), duration (在屏幕上的时间), speed, focus (center | top | bottom | "50% 30%"), transition (cut | flash | zoom | whip | focus) }。transition定义该片段如何出现。
一个片段还可以模拟摄像机:zoom(1-2.5,放大并保持 focus 点不动)、tilt(度数,-15到15,荷兰角)和 push(0-0.6,摄像机随着片段到来短暂模糊地前冲,然后稳定下来)。
作业中省略的属性被视为关闭:没有 hook 的作业就没有钩子,不管示例如何。
src 是 public/ 内的路径或HTTPS URL。.jpg/.png/.webp 文件执行缓慢推入效果,而不是播放。
3. 规则
- 安全区域。 所有文字保持在 x 140-940、y 288-1248 的范围内。模板通过三个区域强制执行此规则:
top(y 288-600)、middle(600-930)、lower(930-1248)。您只需选择区域。 - 保持文字远离产品,除非简报要求将其放在产品上。根据您提取的帧为每个文字选择区域。如果每个区域在一个镜头中都覆盖了产品,请缩短文字的
duration或更换镜头。 - 短行。 文字会自动缩小以适应800像素宽度,因此长行会变得很小。每行目标为22个拉丁字符或12个日语字符。将一个单词括在
*星号*中以用强调色为其着色。 - 片段长度。
start + duration * speed不得超过源文件的末尾。视频的总长度是所有片段持续时间的总和(BeforeAfter使用duration;Testimonial是评论加上行动号召的时间)。 - 与节拍同步剪辑,当有音乐时:使片段持续时间总和等于节拍位置。
- 字体。 支持拉丁语、越南语(montserrat 或 anton,以及所有界面卡片)和日语。韩语、泰语、阿拉伯语等需要先在
reels/src/lib/kit.tsx中添加字体。
少量静态片段,多个角度。 当素材是一个或两个固定镜头,而简报要求快速的多角度剪辑(例如展厅巡览或潮流舞蹈剪辑)时,请使用 BeatCutAd 模板,并用不同的 focus、zoom、tilt 和 push 多次重复使用每个源:从一个广角镜头(zoom 约 1.02)开始,然后每个节拍一个细节(文字、角色、名字、手、下摆),交替 tilt 的正负号,在768像素源上保持 zoom 不超过1.7,最后回到广角。使用 cut 转场;push 本身就是转场。这可以重新构图素材,但无法创建真正的全新摄像机角度。
模板说明:
ChatStory、NotesList、NotificationStack:界面先播放,然后clips(收尾片段)闪现出来,行动号召覆盖在它们之上。它们的长度等于界面部分加上片段长度。省略hook:卡片本身占据安全区域。background是卡片后面变暗的媒体。ChatStory:消息根据阅读时间自行调整节奏;仅当需要强制与节拍同步时才设置at(秒)。消息可以携带image(产品照片)来代替或配合text。NotesList:check: true会在该行被输入后打勾,highlight: true则标记它。将产品行放在最后。SearchHook:pick是被选中的建议。保持查询字符串不超过34个字符。NotificationStack:icon是一个表情符号,color是其图块颜色。根据语言翻译now(现在)和date(日期)。PolaroidDump:接近方形的照片效果最好。title是手写的;说明文字保持在20个字符以内。没有片段:照片本身就是视频。Ranking:items按编写的顺序播放,因此先写最低排名,最后写排名1。标签保持在20个字符以内。PollSticker:percent值由您设定;当简报中有真实数值时请使用,永远不要将虚构的数值作为调查数据呈现。- 在这些界面中编写的文案应符合人们发短信和发帖的风格:小写没问题,短行,在人们会使用表情符号的地方使用表情符号。其中的姓名、消息和评论只是示意性内容,除非简报提供了真实内容,因此不要将其归属于真人。
UgcCaptions:words是{ text, start, end },以输出时间轴上的秒为单位。从带有单词时间戳的转录稿中获取;不要猜测时间。keepAudio默认为 true。一个“单词”可以是一个短短语,配合wordsPerPage: 1。CommentReply和OfferPromo:省略hook。气泡或标题已经使用了顶部区域。OfferPromo:行动号召默认位于底部区域。Testimonial:将行动号召区域设置为middle。ProductSlideshow:badge可以使用\n实现两行;使用badgeBand放置它。
4. 检查,然后渲染
在 reels/ 目录下运行这些命令。
node render.mjs jobs/<job>.json --still=1,6,12 --guides # 安全区域边界绘制在顶部
node render.mjs jobs/<job>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<job>.json # 每种语言 -> exports/<name>/
静态图片以半尺寸保存到 out/stills/。打开它们并检查:文字未覆盖产品,没有内容被裁剪,每种语言都适合。选择钩子、中间字幕和行动号召内部的静态图片时间点。文件名为 _GUIDES 的仅供检查使用;永远不要将它们作为结果交付。
只有在静态图片通过后才渲染视频。如果静态图片失败,请修正作业并再次检查;在三次失败后,报告为阻塞问题。渲染会为每个文件打印一行,包含其路径和长度。除非简报要求,否则不要发布或上传视频。
每个作业结束时向请求者发送一份报告。报告内容包括:
- 输出路径和长度;
- 使用的模板以及在简报未明确说明时使用的默认值;
- 每个输入的来源,以及
public/中是否保存了唯一副本; - 第6节的清理操作删除了什么,以及释放了多少空间。
5. Instagram尺寸
渲染的文件大约为16 Mbps。要压缩一个用于上传:
ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4
6. 媒体和磁盘空间
媒体文件是占用磁盘空间的主要部分。输入文件(复制到 public/<name>/ 的素材、照片、音乐)和输出文件(exports/<name>/ 中的视频,15秒的视频每种语言约30 MB)都属于同一个作业,使用相同的名称。保持这种结构,因为清理操作是按作业进行的。其他所有内容都是临时文件:out/ 中的QA静态图片,以及Remotion写入操作系统临时文件夹的临时包(每个包都包含 public/ 的一份完整副本;render.mjs 会删除自己的临时文件,但崩溃的运行和Studio可能会留下一些残留)。node_modules/.cache 中的webpack缓存会增长到几百MB。node_modules/(约1.3 GB,包括无头浏览器)是一次性成本。重新渲染一个作业会覆盖其同名文件,因此对一个作业的反复渲染不会累积占用空间。
如果 reels/clean.mjs 缺失(工作区是从旧版工具包创建的),请先从本技能的 assets/reels-kit/ 中将 clean.mjs 和 render.mjs 复制到 reels/。
在 reels/ 目录下运行这些命令,不要在渲染过程中运行:
node clean.mjs --auto --keep=<name1>,<name2> # 仅保留命名的作业
node clean.mjs --auto # 仅保留最新的作业
node clean.mjs --all # 删除所有输出和输入
7. 向工具包添加模板
本技能支持添加新模板作为作业,但这仍然是更宽泛的Remotion技能的主要职责。仅在模板是本技能明确要使用的时(例如,这是一个Reels格式,并且请求者要求将其添加到这里)才这样做。
不要为了制作一个视频而编写新模板:使用现有的15个模板之一。新模板是为了为所有未来的作业增加格式,而不仅仅是为了一个单一的渲染。
添加一个模板意味着创建一个新的React组件文件(带Props类型)和一个对应的示例作业。使用 src/BeatCutAd/ 作为起点。需要修改的文件:
src/<Template>/<Template>.tsx— 组件。从现有组件复制,修改以匹配用例。src/<Template>/schema.ts— 用于 props 的 Zod 模式。src/registry.ts— 导入并注册组件、模式和名称。jobs/examples/<Template>.json— 一个有效的完整示例作业。- 在
render.mjs和clean.mjs中,allTemplates数组是自动从src/文件系统导出的;无需手动添加。
组件作为无状态函数接收一个 data 对象和一个 Remotion Sequence 组件,请参阅现有组件。在编写组件时,使用 <CompositionTitle> 来显示标题文本(白色,在安全区域的顶部中间,居中),使用 <ActionButton> 来显示行动号召按钮(底部中间)。放置多个元素时使用 <Band> 容器。所有内容都绝对定位在 1080x1920 的画布上。useCurrentFrame() 和 useVideoConfig() 可以从 Remotion 的 'remotion' 导入。
在开发组件时,请始终注意安全区域:所有文字内容必须保持在 x 140-940,y 288-1248 的边界内。还要记住,视频是自动渲染的:不要在组件中包含交互式元素、悬停效果或事件处理程序。转场应该由 transition prop 处理,该 prop 在注册表中自动包装。
组件属性:
- 所有模板都接收
hook、cta、music和brand作为 prop,分别对应HookProps、CtaProps、MusicProps和BrandProps类型。这些由src/reel.ts中的共享组件处理。 - 模板特定的属性在组件类型中定义,例如
BeatCutAdProps。使用 zod 模式进行验证。
测试新模板: 创建作业文件,渲染静态图片,验证布局,然后渲染完整的视频。遵循与现有模板相同的检查过程(第4节)。