编辑性动态图形(Remotion)
将实验、测试或想法的故事转化为 15-30 秒、以数字和文字为主的视频。外观固定而精致:优雅的衬线标题 + 斜体强调词(天蓝色)、小间距大写等宽标签、紧凑粗体无衬线数字;持续显示细边框(左上角品牌名、右上角“01 — 章节”,底部带分段的进度条 + 时间),背景是微弱网格、边缘暗角和细腻颗粒纹理。故事用 JSON 编写,视觉由此生成。
如果需要绘图、角色或手绘场景,这不是本技能而是 animasyon 技能(PIL 墨水)。
示例:ornekler/x-animasyon/ornek.json(“用三种不同设置运行同一任务”;数字为 捏造的演示数据,屏幕上显示“示例数据”)。
安装(一次性)
cd remotion && npm install # Node 18+;字体文件夹自动复制到 public/fonts
首次渲染会下载 Chrome Headless Shell(约 100 MB)。Python 部分需要:numpy、Pillow、ffmpeg。
命令中 Python 使用 .venv/bin/python(Windows 使用 .venv\Scripts\python)。
工作流程
1. 理解故事
核心论点是什么?有哪些数字,来自何处?平台和比例(X:16:9,Reels/Shorts:9:16,或两者皆可),时长(X 15-30 秒)。如果没有数字,则捏造数字:要么向用户请求实测数字,要么使用无数字的场景(标题、列表、问题)。
2. 编写场景列表:calisma/x-animasyon/<ad>.json
从示例中复制。规则:
- 每个场景 一个想法,每行 3-7 个单词,自然简洁的中文。用两行代替长句。
*单词*= 强调(衬体中斜体 + 蓝色)。每个场景最多一个强调。- 数字只能是实测的。 如果使用未测量/示例数字,请在顶层保留
"etiket": "örnek veri"并告知用户。 - 中文中百分号在数字后:
"onek": "%"→80%。货币和时间比较请使用现成文本:"$0,61"、"5 分 12 秒"。 bolum开启新章节(右上角标签 + 进度条的一部分);3-5 个章节足够。- 使用“待处理”、“即将推出”等状态徽章和给自己写的备注;屏幕上的每个文字都是面向观众的。
tur | 字段 | 用途 | 建议时长 |
|---|---|---|---|
baslik | ust?, satirlar | 钩子:前 2-3 秒 | 2.4-3 |
yazi | satirlar?, ust?, metin (≤160) | 逐字输入提示/命令,带键盘音效 | 0.55 + 字符数 × 0.09 + 0.9 |
sayac | ust?, deger, baslangic?, ondalik?, onek?, sonek?, alt? | 单个大数字滚动出现 | 3 |
olcer | satirlar, seviyeler[2-6] (ad, etiket?) | 概念级别:从低到高依次填充 | 3-4 |
sutunlar | satirlar, ogeler[2-6] (ad, deger, etiket?), onek/sonek/ondalik?, not? | 实测结果,自动排序标签 | 4-4.5 |
karsilastirma | satirlar (单行), a, b (ad, ust?, deger, altEtiket?, alt?), fark? (deger, etiket?, alt?) | A vs B:成本、时间 | 4-5 |
liste | satirlar, ogeler[2-5] | 推理、规则、步骤 | 1.6 + 0.5 × 项目数 |
soru | satirlar, alt? | 结尾问题/行动号召 | 3 |
每个场景必须指定 sure(秒),bolum 可选。顶层字段:marka(左上角名称)、etiket?、tema?、sahneler。架构:remotion/src/x/sema.ts。
3. 草稿(快速预览)
.venv/bin/python .claude/skills/x-animasyon/araclar/uret.py calisma/x-animasyon/<ad>.json --oran ikisi --taslak
半尺寸、静音渲染 + 联系页(<ad>-<oran>-taslak-sessiz-sayfa.jpg)。打开页面并检查:溢出的行、重叠的元素、不可读的标签、空白的大面积区域。修正后重新生成草稿。如需实时编辑:cd remotion && npx remotion studio。
4. 渲染 + 音频
.venv/bin/python .claude/skills/x-animasyon/araclar/uret.py calisma/x-animasyon/<ad>.json --oran ikisi
输出到 calisma/x-animasyon/:<ad>-16x9.mp4(1920×1080,60 fps)和 <ad>-9x16.mp4(1080×1920,30 fps),带音频。音频电平默认 -26 LUFS:明显低于语音(-14..-16),如果叠加配音或说话人头也不会淹没。如果单独发送请使用 --lufs -18;如需无音乐请使用 --muziksiz。
逐步执行(相同过程):
cd remotion && npx remotion render XAnimasyon16x9 ../calisma/x-animasyon/<ad>-16x9-sessiz.mp4 \
--props=../calisma/x-animasyon/<ad>.json --muted && cd ..
.venv/bin/python .claude/skills/x-animasyon/araclar/ses.py calisma/x-animasyon/<ad>.json \
--video calisma/x-animasyon/<ad>-16x9-sessiz.mp4 --cikti calisma/x-animasyon/<ad>-16x9.mp4
5. 测量——不能只看、不能只听
uret.py 末尾会运行 olc.py(手动:olc.py <mp4> --json <json>):
- 帧数和时长是否与 JSON 预期一致,音频和视频长度是否相同;
- 联系页:每个场景两帧(中间和退出前)——务必打开查看;
- 集成 LUFS 和真实峰值;每个切点处 whoosh 比背景高多少 dB(低于 2 dB 发出警告)。文本场景后的切点差异较小:前一窗口有按键音,属于正常。 无法测量的项目(音乐是否好听、节奏是否正确)明确留给用户判断。
6. 交付
文件路径、时长、渲染时间和测量摘要。如果使用了示例数据,请再次说明。
调整外观
- 颜色: JSON 中的
"tema": {"vurgu": "#38bdf8", "zemin": "#111113", "yazi": "#ece7df", "soluk": "#8b8883", "seri": [...]}。保持单个强调色;seri是量表/柱状图的颜色。默认值在remotion/src/x/parcalar.tsx。 - 品牌:
"marka"是左上角名称(频道或系列名称)。 - 字体: 仅限可自由分发的字体(如 OFL)。将 TTF 和许可证文本放入
fontlar/,添加到remotion/scripts/fontlari-kopyala.mjs列表和remotion/src/x/fontlar.ts中的YUZLER中,然后执行npm run fontlar。操作系统自带字体(macOS/Windows 系统字体)不得加入仓库,不得分发。 - 布局: 两个方向在
useDuzen()中处理(parcalar.tsx)。竖屏时内容位于 y 300-1320 之间:Reels/Shorts 界面顶部约 190 px,底部约 520 px,并会遮挡右下角。 - 新场景类型:向
sema.ts添加架构,向sahneler.tsx添加组件,向SahneCiz添加分支,并向uret.py的TURLER添加名称。如果场景内需要音效(如键盘声),请使用zaman.ts在araclar/ortak.py中以相同的公式计算时间。
陷阱(已测量)
- 唯一时间源:
remotion/src/x/zaman.ts和araclar/ortak.py执行相同的计算(帧舍入、输入节奏)。修改其一却忘记另一个,会导致 whoosh 从切点偏移,按键音从字符偏移。 - 合成 ID 中不能有下划线;
--props传入的是 文件路径,而非内嵌 JSON。 - 字体通过 FontFace API 加载;不等待
document.fonts.ready(在长时间渲染中,曾观察到某个选项卡从未解析)。如果字体加载失败,渲染会报错并停止,不会静默使用后备字体。 - 颗粒纹理不是在每帧通过 SVG
feTurbulence计算(会阻塞渲染):而是使用一次生成的噪声图块并移动。 - 土耳其语大写通过 CSS 处理(
lang="tr"+text-transform):İ/ı 输出正确。不要使用 JS 的toUpperCase()。 - 不要给文字添加缩放(zoom/pop)动画:会抖动。入场 = 从蒙版升起 + 透明度变化。
- 如果长时间 60 fps 渲染卡住,可以分成
--frames=0-899等片段,然后用 ffmpeg concat 合并。 - 测量的渲染时长(M1 Pro,16 GB,默认并发):27.4 秒的示例,16:9@60 约 67 秒,9:16@30 约 40 秒;草稿(半尺寸)33 / 18 秒。
许可说明:Remotion
Remotion 不是 MIT 许可的。对个人和小型企业免费;超过一定规模的企业需要购买付费许可。使用前请检查最新条款:https://www.remotion.dev/license —— 本仓库中的代码是 MIT 的,但 Remotion 本身受其自身许可约束。