cyxj-remotion-overlay

name	cyxj-remotion-overlay
description	Remotion 出片的私有规则叠加层。用户用 Remotion、React 视频、口播叠加图形、Sequence、spring、interpolate 做视频时使用。必须叠加官方 Remotion skill,不替代官方 skill。

cyxj-remotion-overlay

这是本工作台的 Remotion 私有规则层。先按官方 Remotion skill 和工程红线做正确实现,再套你自己的视觉与口播设计系统。

必读顺序

1. 官方 Remotion skill(remotion-best-practices)。
2. docs/HARD_RULES.md(工程红线:frame 驱动 / interpolate 带 clamp / 确定性渲染 / 资源进 public/…唯一真源)
3. 你自己的设计系统(色彩语义 / 构图 / 人脸禁区 / 标注)——本仓给的是 kit/theme.ts 占位色板,把它换成你自己的。

作者的完整设计说明书(两套主题 / 构图规范 / 动效手感 / 音画节奏 / 验收清单)是私有沉淀,本仓不含;按同样机制沉淀你自己的那几份。

起手姿态:为这一刻造画面,不是先翻库

做任何一段画面前,默认动作是「用官方原生 Remotion 把这一刻需要的画面搭出来」,不是「先看库里有什么能用」。镜头库是保底 + 品牌积木供应,不是起手就得翻的目录。

但这不是要你把标准重复内容也手搓一遍——口播底、标准内容卡、数据卡这种库里干得好的,该复用就快复用。「原生先行」针对的是:有创意选择 / 用户点名要新东西 / 库里没有正好对的——那些时刻。

复用是判断之后的主动选择,不是开工反射:

• ✅ 合理复用 —— 这一刻确实是标准重复内容(口播底、标准内容卡…),且库里那个镜头正好就是干这个动作的、质量达标。说得出「为什么是它」。
• ❌ 削足适履 —— 为了「库里有个差不多的」,把原本想要的画面改成那个镜头的样子。这不是复用,是拿复用偷懒、把创意做没了。

铁律:用户说要「新镜头 / 新效果 / 换个做法」时,默认就是真的造。不许先翻库、拿「库里有个类似的」把用户劝回去。要复用,先说清它确实是重复内容 + 库里那个正好对——说不清就是该造。

怎么决定一段画面怎么做

先短路,再决定——别一上来就走全程:

• ▸ 明显是标准重复内容、库里有个镜头正好对、且这一刻用户没要求换新的 → 直接复用,跳过下面 5 步。
• ▸ 其余(用户要了新东西 / 库里没有正好对的 / 你正想把它「掰成」某个现成镜头)→ 走下面完整 5 步,原生先行。

5 步(对要决定的那个语义单元 / beat):

1. 意图 —— 这句要让观众 get 到什么(信息 / 情绪 / 反转 / 强调)。按时间码 + 逐字稿做语义联想。
2. 画面动作 —— 这个意图配什么视觉动词(逼近 / 暴涨 / 收拢 / 划掉 / 砸下 / 平移…)。先定动作,别先想「用哪个镜头」。
3. 标杆 & 参考 —— 已完成成片里类似意图怎么做的、质量线在哪,对齐别低于它。遇到「新卡片 / 要高级感 / 全新视觉方向」别凭口味直接做:先联网看官方 / 专业设计怎么处理(色彩×背景融合、效果、版式)再动手。凭感觉连调 = 反复被推翻。
4. 怎么搭 —— 默认:官方原生(interpolate / spring / Sequence)+ kit/theme.ts token,把第 2 步那个动作直接搭出来。 库里正好有一个就是干这个动作、且达标 → 才用它。官方能不能做、用哪个 API,照走官方 skill / remotion-documentation MCP,别凭记忆。
5. 补 & 沉淀 —— 不满意 / 缺品牌件 → 拉库里的积木补(玻璃卡 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。
• 复用镜头库的「积木」(玻璃卡 / 字幕 / 运镜姿态…)是对的,别误读成「连积木都重写」;该造新就原生造、该复用积木就复用,按上面「怎么决定一段画面怎么做」走。