| name | cyxj-remotion-overlay |
| description | Remotion 出片的私有规则叠加层。用户用 Remotion、React 视频、口播叠加图形、Sequence、spring、interpolate 做视频时使用。必须叠加官方 Remotion skill,不替代官方 skill。 |
cyxj-remotion-overlay
这是本工作台的 Remotion 私有规则层。先按官方 Remotion skill 和工程红线做正确实现,再套你自己的视觉与口播设计系统。
必读顺序
- 官方 Remotion skill(
remotion-best-practices)。
docs/HARD_RULES.md(工程红线:frame 驱动 / interpolate 带 clamp / 确定性渲染 / 资源进 public/…唯一真源)- 你自己的设计系统(色彩语义 / 构图 / 人脸禁区 / 标注)——本仓给的是
kit/theme.ts 占位色板,把它换成你自己的。
作者的完整设计说明书(两套主题 / 构图规范 / 动效手感 / 音画节奏 / 验收清单)是私有沉淀,本仓不含;按同样机制沉淀你自己的那几份。
起手姿态:为这一刻造画面,不是先翻库
做任何一段画面前,默认动作是「用官方原生 Remotion 把这一刻需要的画面搭出来」,不是「先看库里有什么能用」。镜头库是保底 + 品牌积木供应,不是起手就得翻的目录。
但这不是要你把标准重复内容也手搓一遍——口播底、标准内容卡、数据卡这种库里干得好的,该复用就快复用。「原生先行」针对的是:有创意选择 / 用户点名要新东西 / 库里没有正好对的——那些时刻。
复用是判断之后的主动选择,不是开工反射:
- ✅ 合理复用 —— 这一刻确实是标准重复内容(口播底、标准内容卡…),且库里那个镜头正好就是干这个动作的、质量达标。说得出「为什么是它」。
- ❌ 削足适履 —— 为了「库里有个差不多的」,把原本想要的画面改成那个镜头的样子。这不是复用,是拿复用偷懒、把创意做没了。
铁律:用户说要「新镜头 / 新效果 / 换个做法」时,默认就是真的造。不许先翻库、拿「库里有个类似的」把用户劝回去。要复用,先说清它确实是重复内容 + 库里那个正好对——说不清就是该造。
怎么决定一段画面怎么做
先短路,再决定——别一上来就走全程:
- ▸ 明显是标准重复内容、库里有个镜头正好对、且这一刻用户没要求换新的 → 直接复用,跳过下面 5 步。
- ▸ 其余(用户要了新东西 / 库里没有正好对的 / 你正想把它「掰成」某个现成镜头)→ 走下面完整 5 步,原生先行。
5 步(对要决定的那个语义单元 / beat):
- 意图 —— 这句要让观众 get 到什么(信息 / 情绪 / 反转 / 强调)。按时间码 + 逐字稿做语义联想。
- 画面动作 —— 这个意图配什么视觉动词(逼近 / 暴涨 / 收拢 / 划掉 / 砸下 / 平移…)。先定动作,别先想「用哪个镜头」。
- 标杆 & 参考 —— 已完成成片里类似意图怎么做的、质量线在哪,对齐别低于它。遇到「新卡片 / 要高级感 / 全新视觉方向」别凭口味直接做:先联网看官方 / 专业设计怎么处理(色彩×背景融合、效果、版式)再动手。凭感觉连调 = 反复被推翻。
- 怎么搭 —— 默认:官方原生(interpolate / spring / Sequence)+
kit/theme.ts token,把第 2 步那个动作直接搭出来。 库里正好有一个就是干这个动作、且达标 → 才用它。官方能不能做、用哪个 API,照走官方 skill / remotion-documentation MCP,别凭记忆。
- 补 & 沉淀 —— 不满意 / 缺品牌件 → 拉库里的积木补(玻璃卡
GlassCards / 字幕 SrtCaptions / 口播轨 SpeakerTrack / 运镜姿态 poses)。做出来确实好用、且会跨片重复 → 走组件晋升(见 kit/CLAUDE.md 组件晋升节)沉淀回 kit。
框架红线照守(frame 驱动、interpolate 带 clamp、确定性渲染、资源进 public/…见 docs/HARD_RULES.md)——原生手写更容易踩,反而要盯紧。
资产和模板
kit/ # 共享层:引擎级组件 + 5 个基础镜头 + 占位色板
template/ # 起手模板(复制它开新片)
关键纪律
- 不在仓库根目录跑 CLI(没 package.json);命令一律先
cd template/ 或你复制出的工程。
- 不手改官方 Remotion skill。
- 复用镜头库的「积木」(玻璃卡 / 字幕 / 运镜姿态…)是对的,别误读成「连积木都重写」;该造新就原生造、该复用积木就复用,按上面「怎么决定一段画面怎么做」走。
