用代码生成 15 秒动态图形（Motion Graphics）成片，交付 1920×1080 / 30fps（450 帧）。 画面和音乐全部由代码产出——不依赖任何外部美术素材，也不打开 After Effects。
同一套引擎换一套视觉语言就是一支新片：暗色科技 HUD、riso 三色印刷、纸艺、银盐暗房、
恒星普朗克配色、氰版蓝图、紫外光刻、品牌亮色产品片——下面那张表每一格各是一支，
完整成片在 docs/films/。
本 skill 由作者用 DeepSeek Flash 跑通：从建模、排版、分色到配乐与出片， 整条链路都是它自己跑出来的。 不绑定模型 —— 支持各大主流多模态模型，任何能读写文件、执行命令的编码 Agent 都能用。
这是一个 Agent Skill（给 ZCode / Claude Code 这类编码 Agent 用）：装上之后， 一句「用代码做一条 15 秒动态图形片」就能从零到出片。
| 暗色科技 · 流场 | 丝网印 / riso · 封面 | 3D 建模 · 点云渲染 |
|---|---|---|
 |
 |
 |
| 银盐 / 暗房 · SILVER | 恒星 · KELVIN | 氰版蓝图 · MOTION ENGINE |
 |
 |
 |
| 纸艺 · DECKLE | 紫外光刻 · LITHO | 品牌亮色产品片 · BRAND LIGHT |
 |
 |
 |
最后一格是 DeepSeek 的品牌片（
brand-light-demo-15s.mp4）： 鲸鱼标与字标取 deepseek.com 官网内联 SVG 的原路径（不是重排的近似字体）， 色值逐条取自其设计 token（--ds-color-brand#4d6bfe等），产品界面按其亮色主题自绘。 这是用本引擎做的排版与管线演示，与 DeepSeek 无隶属关系，商标归其所有者。
- 15 秒成片，1920×1080 / 30fps（450 帧），锁在音乐网格上（128 BPM × 8 小节 = 15.000 秒整）， 每个场景正好一小节，每一次剪辑都落在强拍上
- 字体排版：2× 超采样矢量/文字通道、字距排版、字号按目标宽度反解
- 真 3D：参数曲面建模 + 点云渲染（排序散射做精确遮挡）+ 隐藏线线刻
- 印刷管线：分色成四块油墨版、旋转网线做网点、乘法定律叠印、 套印偏移、纸纹、裁切线、套准规
- 配乐合成：打击乐 / 贝斯 / FM 电钢 / 钟 / 铺底 / riser / impact， 加磁带抖晃与混响，无采样
- 颜色也能是被算出来的：给一个物理量就直接得到颜色——黑体温度 （Planck → CIE 1931 → sRGB）、谱线波长、薄膜干涉（氧化层厚度 → 反射光谱）。 LITHO 里曝光光是 405 nm 反解的那支紫，晶圆彩虹是 SiO₂ 厚度 20–780 nm 积分出来的
- 16 张风格牌，默认随机抽：暗色霓虹只是其中一张，抽到编辑排版、手绘速写、
纸艺、标本图录、柔光渐变就照做——轻的做干净了一样好看。抽签结果写进项目的
STYLE.md - 出片链：多进程逐场并行渲染 → H.264 编码 → 混音，1080p30 的 15 秒约 3~8 分钟（排版重的牌更久）
git clone https://github.com/HRuiCcc/RuiC-motion-reel.git \
~/.agents/skills/ruic-motion-reel依赖：python3（numpy + Pillow）、ffmpeg。字体随包（OFL）。
pip install numpy pillow给 Agent 用（推荐）：把 skill 装到 ~/.agents/skills/ 下即可，
Agent 会在你说「用代码做个动效视频 / 生成一条 15 秒作品集样片 / 给某个品牌做一条片子」时自动使用它。
手动用：
# 起一支新片
python3 ~/.agents/skills/ruic-motion-reel/scripts/new_reel.py ~/my-reel --name my_reel
# 默认抽一张风格牌（写进 STYLE.md）；--style <id> 指定，--style none 关掉
cd ~/my-reel
# 改 my_reel/theme.py：品牌、时间网格、色板、文案
# 改 my_reel/scenes.py：八个场景
python3 -m my_reel.build --stills 0 # 抽一场的 7 帧审阅
python3 -m my_reel.build --at 3:1.20 # 某一拍的单帧全分辨率
python3 -m my_reel.build # 出全片产物在 out/。
SKILL.md Agent 的主工作流（触发条件、流程、硬规矩）
engine/ 共享渲染引擎
core.py 画布、矢量文字通道、bloom/色差/颗粒、
印刷原语（叠印 multiply、网点、纸纹、套印偏移）
three.py 3D：参数曲面、相机、点云渲染、隐藏线
fonts.py 字体栈、字距排版、基线换算、字号反解
anim.py 缓动、错帧、值噪声
dsp.py 合成器 DSP：FFT 时变滤波、磁带抖晃、混响、频谱分析
template/ 可跑的最小工程（8 个场景 + 一段配乐）
scripts/
new_reel.py 从模板起一支新片（默认抽一张风格牌，写进项目 STYLE.md）
style_lottery.py 16 张视觉语言的牌堆，抽签 / 列牌 / --avoid 上一张
preview_gif.py 成片或帧序列 → README 用的循环预览 GIF
perf_probe.py 逐算子 CPU vs CuPy，看换显卡到底能省多少
references/ 按需加载的细节文档
design-grammar.md 设计语法：时间网格、排版、构图、动效、亮度校准
three-d.md 3D 引擎用法与配方
print-pipeline.md 分色、网点、叠印、版面家具
audio-dsp.md 配乐合成
gotchas.md 踩过的坑（近 40 条，症状与真因）
performance.md 一帧花在哪、换显卡能省多少（实测）
assets/fonts/ 随包字体（OFL 1.1，见 NOTICE.md）
assets/wechat-donate.png 赞赏码
时间先有网格，再有镜头。 「剪辑点落在强拍上」不是后期对轴对出来的， 是结构决定的——一个小节一个场景，所以音乐和画面共用一条时间轴。
3D 不用三角形光栅化器。 Python 里逐三角形太慢；把曲面密采样成点云、 投影后按深度排序散射（numpy 对重复下标保留最后一次写入 = 画家算法）， 遮挡精确、无逐三角形循环，而且密集点云自带颗粒感——铜版雕刻也是这个原理。
颜色是被算出来的，不是被指定的。 印刷管线把明暗拆成几块油墨版， 各自用不同网线角度做网点，再以乘法叠印。粉压蓝是真紫、黄压蓝是真绿—— 中间调是油墨自己叠出来的。
品牌色必须实测。 官网样式表、产品截图，不要凭印象挑。 亮色品牌的暗色版不是另选一套色，而是把同一套色读到曝光的另一端。 品牌 logo 同理——取官网的原始 SVG/PNG，不要手画，也不要把字标重排成「像 logo 的字体」。
亮底片的后期是反的。 暗场里 bloom 阈值 0.68 就够，亮场要抬到 0.99（纸白本身 0.97）， 品牌色满幅时甚至要抬到 1 以上（品牌蓝的 B 通道 0.996 会把自己的底板点着）。阈值低于底板亮度，整帧就被自己的底色洗白——这个症状看起来像调色不对，真因在阈值。
references/gotchas.md 有 40 多条，每条都是真踩过的，而且症状都不指向真因。举三个：
- PIL 的字形包围盒是相对 ascender 而非基线，按字高居中会整体低一个字身（168px 字号偏 147px）
- 重叠相加滤波要除以窗和（窗只加了一次）；除以窗平方和会引入 2× 纹波， 且首尾样本会把舍入噪声放大上千倍
- AAC 编码后采样间峰值超过采样峰值，采样峰值定 0.92 会得到 +0.3 dBTP（已超 0 dBFS）
微信扫码赞赏
代码 MIT（见 LICENSE）。随包字体为 SIL Open Font License 1.1，
版权与协议见 assets/fonts/NOTICE.md 与 assets/fonts/OFL.txt。