claude-animation-skills 动画交付细节指南:Instagram 安全区、1080x1920@30fps 与 loudnorm -14 LUFS 响度标准
claude-animation-skills 动画交付细节指南:Instagram 安全区、1080x1920@30fps 与 loudnorm -14 LUFS 响度标准
claude-animation-skills 是一套面向 Claude Code 的动画技能包,无需任何实拍素材,就能为你渲染出符合 Instagram Reels 规格的竖版短视频:统一输出 1080x1920@30fps,自动对照 Instagram 安全区做红框检查,带旁白的成片还会按 loudnorm -14 LUFS 平台标准做响度归一化。本文带你看懂这套"交付标准"是怎么落到每一帧画面和每一秒音频里的。
六个技能,先认识一下 🎬
这套工具提供 6 个技能:/zach-d-films(3D 卡通讲解)、/stick-figure(火柴人解说)、/minimalistic-graphics(黑白线条)、/map-route(3D 地图路线)、/breakdown(爆炸拆解)、/graph(极简折线图)。它们各自风格不同,但交付规格完全一致——这正是下文要讲的细节。
交付规格:1080x1920@30fps 是怎么保证的 📐
统一的画布与帧率常量
所有快速技能的渲染参数都集中在 kit/anim.py 里,一行常量锁死规格:
W, H, FPS = 1080, 1920, 30
每个技能的 HTML 模板(如 skills/graph/template.html)也硬编码了 data-width="1080" data-height="1920" data-fps="30",渲染时再通过 HyperFrames 以 --fps 30 输出,双重保证不会跑偏。
两个"引擎级"技能的处理方式
/stick-figure:无头浏览器直接以 1080x1920 视口逐帧绘制,再用 ffmpeg 以-framerate 30、-crf 17、-pix_fmt yuv420p合成,见 skills/stick-figure/engine/tools/render.js。/zach-d-films:先以 720x1280 快速渲染静帧,最后一步用 lanczos 高质量缩放升到 1080x1920,命令写在 skills/zach-d-films/SKILL.md,视频编码统一为libx264 -crf 17 -pix_fmt yuv420p。
💡 这套编码参数(CRF 17 + yuv420p + AAC 192k)是典型的"高质量竖屏短视频"配置:文件不大、清晰度足够、平台兼容性满分。
Instagram 安全区:红框检查怎么做? 📱
Instagram 在 Reels 播放时,顶部和底部会覆盖播放控件与文案区,画面边缘内容容易被挡。这套项目把安全区定义为固定像素范围(见 kit/anim.py):
- 顶部留白约 220 px,内容下限约 1500 px
- 左右各留 100 px 边距
每次快速技能渲染完成后,会自动生成一张 <name>.sheet.jpg 联系表,并用 ffmpeg 的 drawbox 在缩略图上画出红色安全区边框(实现见 kit/anim.py)。你只要看一眼红框内有没有关键内容,就能确认画面"上 Instagram 不翻车"。
两个引擎级技能则把规则直接写进了创作规范:
/stick-figure要求人脸和关键道具保持在 x 100~980、y 220~1500 的安全区内,并避开 y 1250~1420 的字幕带(skills/stick-figure/SKILL.md)/zach-d-films在 9:16 窄画幅下,要求字幕与关键内容避开边缘和 y 950~1030 的字幕带(skills/zach-d-films/SKILL.md)
响度标准:loudnorm -14 LUFS 如何落到音频 🔊
四个快速技能是纯画面短片(无音轨),带旁白的是两个引擎技能。它们的最终混音都遵循同一条 ffmpeg 滤镜链,核心是 loudnorm=I=-14:TP=-1.5:
| 参数 | 含义 | 为什么重要 |
|---|---|---|
I=-14 |
集成响度 -14 LUFS | 短视频/流媒体平台推荐响度基准,手机外放也不吵 |
TP=-1.5 |
真实峰值限制在 -1.5 dB | 防止爆音、削波 |
LRA=9 |
响度动态范围 9 LU(火柴人技能额外指定) | 保持音乐与旁白之间的起伏感 |
/stick-figure的最终混音在 skills/stick-figure/engine/make.sh,还前置了alimiter限幅器,音频输出为 AAC 192k、48 kHz。/zach-d-films的交付命令写在 skills/zach-d-films/SKILL.md:apad,loudnorm=I=-14:TP=-1.5,apad负责补齐旁白与画面时长的微小差异。
简单说:无论用 Kokoro 免费配音、ElevenLabs 还是你自己的录音,出片前都会被"校准"到同一把响度尺子上,发到手机上听感一致。🎧
一键安装与渲染流程 ⚡
git clone https://gitcode.com/gh_mirrors/cl/claude-animation-skills.git
cd claude-animation-skills && ./install.sh
install.sh 会把每个技能链接到 ~/.claude/skills/,并运行一次性环境配置(kit/setup.sh:检查 ffmpeg / Node 18+ / Python 3.9+,安装 three.js 与 Playwright)。两个配音技能再执行 ./install.sh --voice 下载约 1 GB 的本地语音模型,无需任何 API Key。
之后在 Claude Code 里输入类似 /map-route home to the gym, 2.8 km 即可:2D 技能约 10 秒出片,3D 技能约 1.5 分钟,交付物永远是"1080x1920@30fps 的 mp4 + 一张带安全区红框的检查表"。📦
小结
claude-animation-skills 把"能直接发到 Instagram 的视频"做成了工程标准:
- ✅ 规格统一:1080x1920@30fps、CRF 17、yuv420p,写在常量与模板里
- ✅ 安全区可见:每张联系表都有红框,构图规则写进技能规范
- ✅ 响度达标:loudnorm -14 LUFS + -1.5 dBTP 峰值限制,听感稳定
对新手来说,你只需要给出创意,剩下的"平台规格"它已经替你盯好了。
