Skip to content
Back to search

ruic-motion-reel

"用代码生成动态图形与动效宣传片成片,时长按需(12 / 15 / 24 / 30 / 45 / 60 秒),默认 1920×1080。两条路线:常规宣传片(HUD / 终端 / 动字 / 玻璃面板 / 粒子)走仓库自带的 remotion/ 模板(React 组件 + 浏览器渲染,60fps 无压力);需要自研渲染独有能力(超采样矢量文字、真 3D 点云、丝网印/riso 四色分色、普朗克真彩色、合成器配乐)走本引擎的 Python 管线。画面与音乐全部由代码产出、不用任何外部美术素材、不用 AE。视觉语言有 16 张牌,默认随机抽一张(轻的、非 3D 的、编辑排版/手绘/纸艺/标本那类一样做),不默认做最炫的那一支。当用户说「用代码做个动效视频/动态图形/motion graphics」「生成一条作品集样片/产品片/宣传短片」「做一条 24 秒/30 秒的品牌片」「按某种风格做视频」「给某个品牌/产品做一条片子」「复刻某条动效片的风格」,或要改已有片子的品牌、配色、节奏、镜头、时长时使用。触发词:动效视频、动态图形、motion graphics、作品集样片、产品片、宣传片、任意时长、24 秒、30 秒、1080p30、1080p60、代码生成视频、ruic-motion-reel。"

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hruiccc--ruic-motion-reel/badge.svg)](/listings/hruiccc--ruic-motion-reel)

HTML

<a href="/listings/hruiccc--ruic-motion-reel"><img src="/api/listings/hruiccc--ruic-motion-reel/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/HRuiCcc/RuiC-motion-reel.git \
  ~/.agents/skills/ruic-motion-reel

依赖:`python3`(numpy + Pillow)、`ffmpeg`。字体随包(OFL)。

pip install numpy pillow

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 313 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: ruic-motion-reel
  3. description: "用代码生成动态图形与动效宣传片成片,时长按需(12 / 15 / 24 / 30 / 45 / 60 秒),默认 1920×1080。两条路线:常规宣传片(HUD / 终端 / 动字 / 玻璃面板 / 粒子)走仓库自带的 remotion/ 模板(React 组件 + 浏览器渲染,60fps 无压力);需要自研渲染独有能力(超采样矢量文字、真 3D 点云、丝网印/riso 四色分色、普朗克真彩色、合成器配乐)走本引擎的 Python 管线。画面与音乐全部由代码产出、不用任何外部美术素材、不用 AE。视觉语言有 16 张牌,默认随机抽一张(轻的、非 3D 的、编辑排版/手绘/纸艺/标本那类一样做),不默认做最炫的那一支。当用户说「用代码做个动效视频/动态图形/motion graphics」「生成一条作品集样片/产品片/宣传短片」「做一条 24 秒/30 秒的品牌片」「按某种风格做视频」「给某个品牌/产品做一条片子」「复刻某条动效片的风格」,或要改已有片子的品牌、配色、节奏、镜头、时长时使用。触发词:动效视频、动态图形、motion graphics、作品集样片、产品片、宣传片、任意时长、24 秒、30 秒、1080p30、1080p60、代码生成视频、ruic-motion-reel。"
  4. user-invocable: true
  5. metadata:
  6. dsh:
  7. compatibility: native
  8. requires:
  9. - python3
  10. - ffmpeg
  11. ---
  12. # RuiC-motion-reel —— 代码生成动态图形成片
  13. 一条产线:**从零用代码渲染出一支动态图形 / 动效宣传片**,**片长由 BPM × 小节算出来**
  14. (12 / 15 / 24 / 30 / 45 / 60 秒都能做),默认交付 **1920×1080**。
  15. 画面(字体、3D、粒子、印刷分色)和音乐(合成器)全部由代码产出,
  16. 不依赖任何外部美术素材、不打开 After Effects。
  17. **两条路线**:常规宣传片(HUD / 终端 / 动字 / 玻璃面板 / 粒子)走 `remotion/` 模板;
  18. 自研引擎独有的(印刷分色、点云 3D、物理反解颜色)走下面的 Python 管线。
  19. 选型与分镜模板见 `references/promo-brief.md`。
  20. > **本 skill 由作者用 DeepSeek Flash 跑通**(建模 / 排版 / 分色 / 配乐 / 出片全链路)。
  21. > **不绑定模型**:纯 Python + ffmpeg,不含任何模型专属依赖,
  22. > 支持各大主流多模态模型——任何能读写文件、执行命令的编码 Agent 都能用。
  23. 已经用它做过这几类视觉语言:
  24. | 语言 | 观感 | 关键手法 |
  25. |---|---|---|
  26. | **暗色科技** | 近黑底板 + 霓虹青/品红、HUD 套件、发光字体 | 加色光缓冲、bloom、色差、扫描线 |
  27. | **丝网印 / riso** | 暖米纸张 + 荧光三色油墨、网点、套印 | multiply 叠印、半调网点、套印偏移、纸纹 |
  28. | **品牌暗色产品片** | 品牌色暗色主题 + 真实产品 UI + 3D 硬件 | 品牌色板映射、真 3D 建模、产品界面复刻 |
  29. | **暗房 / 银盐** | 中性纸白 + 碳黑 + 一个安全灯红,无网点无霓虹 | 光晕 halation、片门微抖、两级银盐颗粒、点云刻线 |
  30. | **恒星 / 普朗克真彩色** | 深棕余烬底 + 黑体色温条 + 光谱线,没有一个是挑的 | 普朗克→CIE 1931→sRGB 反解颜色、点云磁流管、真谱线 |
  31. | **紫外光刻 / 半导体** | 近黑冷蓝腔体 + 405 nm 紫外紫 + 氧化层彩虹,一条片子走完版图→掩膜→曝光→显影→探针→划片 | 薄膜干涉真彩、递归版图生成、衍射曝光场(振幅孔径过环形 PSF 再平方)、彩色点云(每点带自己的颜色) |
  32. | **品牌亮色产品片** | 品牌自己的纸白 + 品牌色满幅,迪多尼大标题骑在发丝网格上,两场暗场换气 | 官方 lockup 真素材位图、亮底反转后期、品牌色与 token 逐个实测、产品界面自绘 |
  33. > 最后一支 **LITHO**(`docs/films/litho-wafer-15s.mp4`,1080p / 160 BPM / 10 小节 × 1.5 s)是这条线的样板,
  34. > 同时是牌堆里的 `uv-litho`。它的颜色全部追得到物理量:曝光光 = 405 nm 反解,
  35. > 晶圆彩虹 = SiO₂ 厚度 20–780 nm 的双光束干涉积分到 CIE 1931。
  36. ### 风格:从一句话推出来,不抽牌(2026-11 用户定调)
  37. 上面九支是引擎**做过**的九种,**不是**可选清单,也不是默认答案。
  38. **"一句话生不同的动态样式视频"才是这条产线的用法**:不参考历史片,也不从牌堆里挑。
  39. 一句话进来,先落成 `SPEC.md`,再由 SPEC 决定一切:
  40. ```bash
  41. python3 {skill_dir}/scripts/new_reel.py <片子目录> --brief "做一条 20 秒的咖啡品牌片,暖色胶片感,慢"
  42. ```
  43. 读出来的是六件事 —— **时长 / 画幅 / 冷暖 / 质感 / 节奏 / 语言**,
  44. 由它们推出**色板(H/S/L 反解)+ 字体对 + 运动语法 + 分镜骨架**,全部写进 SPEC.md 和 theme.py:
  45. | 句子里出现 | 推出的东西 |
  46. |---|---|
  47. | "20 秒" | 时长 + 反解出一组每小节整数帧的 BPM/小节 |
  48. | "竖屏" / "9:16" | 1080×1920,作者空间 720×1280 |
  49. | "暖 / 咖啡 / 日落" | 基色相 26°,暗底,主色推到琥珀 |
  50. | "冷 / 科技 / 夜" | 基色相 214°,主色推到电青 |
  51. | "胶片 / 颗粒" | 颗粒 + halation + 片门微抖,转场 flash-frame,衬线标题 |
  52. | "印刷 / riso" | 网点 + 套印偏移 + 纸纹,转场 ink-wipe |
  53. | "极简 / 瑞士 / 杂志" | 亮底、无颗粒、只有发丝线,转场 wipe |
  54. | "慢" / "快" | 决定一小节塞几个动作、以及反解时偏好哪个 BPM 区间 |
  55. 同一句话永远给同一个结果;换一句话就是另一套样子。**这就是"不生限制"的含义**:
  56. 没有必须 15 秒、必须横屏、必须全英文、必须先抽牌这些前置条件——句子说什么就是什么,
  57. 句子没说的才用默认值(16:9 / 30fps / 15s / 中性)。
  58. 16 张风格卡还在(`scripts/style_lottery.py`),但**降级为参考库**:
  59. 只有在"我就是想要那种印刷/纸艺/仪器图录的样子"时才 `--style <id>` 指一张,
  60. 默认不抽、不写 STYLE.md。
  61. 推完 SPEC 之后仍然要一场一场写 `scenes.py` —— SPEC 说清了"该长什么样",
  62. 画面还是得画出来。方法见 `references/style-synthesis.md`。
  63. > ## ⚠️ 默认出口不在这里(2026-09-28 用户定调)
  64. >
  65. > **常规成片默认走本机已有的 Remotion 产线**(耶莱 / 亚莱 / 克莱 / 梦莱 / 企鹅 / 排行榜 1&2),
  66. > 从最接近的那条复制一份改数据文件即可。**本技能是特殊风格的最后手段**,
  67. > 只在需要它独有能力时才用(点云写实 3D / 印刷分色 / 普朗克真彩色 / 合成器配乐)。
  68. >
  69. > 用它的时候两条硬规矩:**编码走 `h264_nvenc`**(实测比 libx264 快 3.7 倍、体积小 28%、
  70. > PSNR 差 0.9 dB),**并行度不许吃满全机**(一场一核足够,用户原话「cpu爆了」)。
  71. >
  72. > **注意:Remotion 也不是 GPU 渲染**——它的帧同样是 headless Chrome 在 CPU 上画的,
  73. > 显卡真正出力的只有**编码**那一步。路由与配方见 `references/remotion-default.md`。
  74. ## DSH 运行约定
  75. - `{skill_dir}` 是本 `SKILL.md` 所在目录。引擎、模板、字体、参考文档都在其下,用绝对路径定位。
  76. - 文中命令都写 `python3`。**在 Windows 上换成 `py -3`**——`python3` 很可能是应用商店的
  77. 别名桩,非交互下静默退出(exit 49,什么都不吐),会被误判成脚本有问题。
  78. - **产出写进用户指定的项目目录**,不改 `{skill_dir}` 内的模板真源;需要模板时先复制。
  79. - 渲染是 CPU 密集的长任务(15 秒 ≈ 1~3 分钟多进程),开工前说清目标目录与预计耗时。
  80. - 成片审核由用户做:渲完把文件路径直接给用户。
  81. ---
  82. ## 一、先判断:是「新做一支」还是「改已有的」
  83. | 用户意图 | 走哪条 |
  84. |---|---|
  85. | 新做一支(没指定风格) | 先按下面「二」问清 3 件事,再按「四」开工 |
  86. | 新做一支(指定了品牌/配色/参考片) | 先做「三」的品牌取色,再按「四」开工 |
  87. | 改已有片子(改品牌/配色/节奏/镜头) | 进该片目录,只改 `theme.py` + 相关 scene,**不要重建工程** |
  88. | 只要某个镜头/效果 | 从 `template/scenes.py` 抽对应类,单独 `--at` 渲染验证 |
  89. ---
  90. ## 二、开工前必须定下的三件事(风格已由 brief 推成 SPEC)
  91. 这三件事决定了整支片子的骨架,**含糊就必问**,不要自己替用户选完就开工。
  92. 风格不在这三件里——它已经由 `scripts/brief.py` 推成 `SPEC.md` 了,照着执行:
  93. 1. **时长与节奏**。默认 15 秒,**宣传片从 24 秒起**(12 小节 × 2.0 s,够讲完三个 act)。
  94. 节奏必须落在一个音乐网格上(见下),别用"大概每 2 秒切一次"。
  95. 2. **说话对象与文案**。是产品片、作品集样片还是品牌片?文案用什么语言?有没有必须出现/必须不出现的词(例如某些片子要求全英文、要出现某域名、不能出现某个品牌)。
  96. 3. **品牌色**。有品牌就必须**取实测色值**,不要凭印象挑(见「三」)。
  97. ### 时间网格:先定 BPM,再定镜头
  98. 整片锁在一个音乐网格上,**每个场景正好一小节**,每次剪辑都落在强拍上。
  99. 所以「画面节奏」和「音乐」是同一套时间轴,而不是后期硬凑的。
  100. ```
  101. 秒数 = 小节数 × 每小节拍数 × 60 / BPM
  102. BPM = 每小节拍数 × 60 × 小节数 / 总秒数
  103. ```
  104. **先选片长,再反解 BPM**(任选,别自己发明分数):
  105. | 片长 | 小节数(=镜头数) | BPM | 每小节 | 适合 |
  106. |---|---|---|---|---|
  107. | 12 s | 8 | 160 | 1.500 s | 纯冲击,无叙事 |
  108. | 15 s | 8 | 128 | 1.875 s | 作品集样片、单点 demo |
  109. | **24 s** | **12** | **120** | **2.000 s** | **宣传片起点:三个 act** |
  110. | 30 s | 10 | 80 | 3.000 s | 需要一点呼吸的品牌片 |
  111. | 45 s | 12 | 64 | 3.750 s | 产品发布、功能串烧 |
  112. | 60 s | 15 | 60 | 4.000 s | 开场短片、展会循环 |
  113. `theme.plan(seconds)` 会反解出「每小节整数帧」的那组 BPM/小节;
  114. `new_reel.py <dir> --seconds 24` 直接按目标时长起工程(BARS/BPM/DUR 一起改好)。
  115. 12 秒以下别做(BPM 会飙过 200),45 秒以上别靠堆场景撑,按 act 切。
  116. **8 小节 ≠ 必须 8 个场景**:场景 02 可以是「一拍一个词」的四个词,等于把 1 小节拆成 4 拍用。
  117. **帧数 = 秒 × FPS**(默认 30 fps:15 秒 = 450 帧,24 秒 = 720 帧)。
  118. 一小节 = `4 × 60 / BPM × FPS` 帧;8 小节 @128 BPM 是 56.25 帧,所以别写死每场 56 帧,
  119. 用 `int(round(...))` 从时间反解(模板的 `render_one` 已经这么做了)。
  120. 12 小节 @120 BPM @30fps 正好 60 帧/小节,是整数——这也是推荐 24 秒做宣传片的原因。
  121. **BARS 不必等于场景数**:`scene_plan()` 会把 `SCENES` 循环铺满 BARS(12 小节用 8 个场景类也跑得动,
  122. 带 seed 的场景会按小节错开种子)。要自定义多小节结构,在 `scenes.py` 里写
  123. `SEQUENCE = [A, B, B, C, ...]`,长度必须等于 `BARS`。
  124. ---
  125. ## 三、品牌取色:量,不要猜
  126. **这是整条产线最容易翻车、也最容易做出「专业感」的地方。**
  127. 1. **先找本机已有的实测色板**。用户往往已经为某个品牌做过片子,颜色是当时从截图里
  128. 聚类采样出来的——比任何猜测都准。搜:
  129. ```bash
  130. ls ~/.agents/skills | grep -i <品牌相关词>
  131. grep -rn "#[0-9a-fA-F]\{6\}" ~/.agents/skills/<那个skill>/template/ --include="*.ts*"
  132. ```
  133. 2. **再核对官网**(官网营销色和产品界面色经常不是同一个绿):
  134. ```bash
  135. curl -sL -A "Mozilla/5.0" https://<官网>/ -o /tmp/site.html
  136. grep -o -i '#[0-9a-f]\{6\}' /tmp/site.html | tr 'A-Z' 'a-z' | sort | uniq -c | sort -rn | head -15
  137. ```
  138. 3. **暗色片怎么用亮色品牌的色板**:暗色版本不是另挑一套色,而是**把品牌色放到曝光另一端**。
  139. 底板用「品牌墨色压暗」的深色(例如产品标题墨蓝压成近黑),主色仍是品牌色本体,
  140. 再取色板的语义色(信息蓝 / 警告橙 / 危险红)做读数,这样片子立刻就是这个品牌的。
  141. 4. **字体挑之前先量**。若要贴近某条参考片,量它定稿字块的**字高 / 字宽比**再选字体,
  142. 不要凭眼感(见 `references/design-grammar.md` 里的比例核对法)。
  143. ---
  144. ## 四、制作流程
  145. ```bash
  146. # 1) 一句话起片(engine/ 与 template/ 复制成自包含工程,并把 SPEC 写进 theme.py)
  147. python3 {skill_dir}/scripts/new_reel.py <片子目录> --brief "一句话需求"
  148. # 只想调片长/不想给 brief:--seconds 24 或 --bars 12
  149. cd <片子目录>
  150. # 2) 改 theme.py:品牌、时间网格、色板、文案(牌面要求原生纹理时把 W, H 设成交付尺寸)
  151. # 3) 改 scenes.py:按 SPEC.md 的分镜骨架与运动语法来写(不是照抄历史片)
  152. # 4) 逐场审阅(关键!不要渲完再看)
  153. python3 -m <包名>.build --stills 0 # 一场抽 7 帧拼长图
  154. python3 -m <包名>.build --at 3:1.20 # 某一拍的单帧全分辨率
  155. # 5) 全片
  156. python3 -m <包名>.build
  157. ```
  158. ### 交付规格已经是 1080p30,不用再调
  159. `template/theme.py` 出厂即:`FPS = 30`、`OUT_W, OUT_H = 1920, 1080`、
  160. `W, H = 1280, 720`(**排版空间**)。布局按 720p 写,出来的是 1080p 文件:
  161. 矢量/文字通道在交付尺寸上超采样渲染(所以字是锐的),
  162. 只有辉光、颗粒、纸纹这类软遮罩在排版空间生成、入板时重采样一次。
  163. **因此:字号、边距、HUD 尺寸都按 720p 的直觉写就行,不用乘 1.5。**
  164. 例外是**靠细纹理吃饭的牌**(丝网印网点、凸版、拼贴、纸艺):网点是细节,
  165. 必须原生清晰——这些牌把 `W, H = OUT_W, OUT_H`,直接在交付尺寸上排版,
  166. 牌面里 `author_at_delivery` 标了这一条。代价是重采样没了、渲染慢一倍,
  167. 其余一切照旧(`gauss(W, H, ...)` 这类调用不用改,W/H 已经是新值)。
  168. ### 每场的实现顺序(照这个顺序做,返工最少)
  169. 1. **底板 + 环境光**(背景、地平线/纸纹、网格)→ `--at` 渲一帧,先确认**亮度对**
  170. 2. **主体**(大字 / 3D / 图形)→ 再看一帧
  171. 3. **运动**(入场、缓动、错帧)→ 抽 7 帧看时间轴
  172. 4. **HUD / 版式细节** → 最后加,它是最容易喧宾夺主的东西
  173. ### 亮度必须对着参考片量,不能靠眼睛
  174. 在同尺寸同色调下比较**均值 / 中位数 / p95**,暗场常见偏差是「整体亮了 2~3 倍」:
  175. ```bash
  176. ffmpeg -v error -ss <t> -i ref.mp4 -frames:v 1 -f rawvideo -pix_fmt rgb24 - | python3 -c "
  177. import sys, numpy as np
  178. a = np.frombuffer(sys.stdin.buffer.read(), np.uint8).reshape(720,1280,3).astype(np.float32)
  179. bg = a[::6,::6].reshape(-1,3)
  180. print('mean', bg.mean(0).round(1), 'median', np.median(bg,0), 'p95', np.percentile(bg,95,0))"
  181. ```
  182. 差值大通常不是「调色」问题,而是**管线里多做了一次线性→sRGB 编码**(见 `references/gotchas.md`)。
  183. ---
  184. ## 五、可选能力(按需读参考文档)
  185. | 要做的效果 | 读哪个 | 引擎入口 |
  186. |---|---|---|
  187. | 类型排版、字号标定、HUD 版式 | `references/design-grammar.md` | `engine/fonts.py`, `engine/core.py` |
  188. | 真 3D(建模、点云渲染、隐藏线) | `references/three-d.md` | `engine/three.py` |
  189. | 印刷/riso 分色、叠印、纸纹 | `references/print-pipeline.md` | `engine/core.py` |
  190. | 颜色按物理量反解(色温 / 谱线) | `references/design-grammar.md` | `engine/color.py` |
  191. | 配乐合成(打击乐/贝斯/铺底/旋律) | `references/audio-dsp.md` | `engine/dsp.py` |
  192. | 出片前自检、已知 bug | `references/gotchas.md` | — |
  193. | 渲染太慢 / 要不要上 GPU | `references/performance.md` | `scripts/perf_probe.py` |
  194. | 默认走哪条路线 / 显卡在哪一步出力 | `references/remotion-default.md` | — |
  195. ### 交付自检(渲完必做)
  196. ```bash
  197. ffprobe -v error -select_streams v:0 -show_entries stream=width,height,nb_frames,r_frame_rate \
  198. -show_entries format=duration -of default=noprint_wrappers=1 out/<name>.mp4
  199. # 响度:真峰必须 < 0 dBTP。波形文件的真峰不够——AAC 会把采样间峰值再抬上去,
  200. # 所以量的是**解码回来的**这条;超过 −0.5 dBTP 先换 384k 再谈降电平(见 gotchas 27、28)
  201. ffmpeg -hide_banner -i out/<name>.mp4 -af loudnorm=print_format=summary -f null - 2>&1 \
  202. | grep -E "Input Integrated|Input True Peak"
  203. ```
  204. 常见规格(默认交付):**1920×1080、30fps、片长精确到帧**(`NFRAMES = round(DUR × FPS)`,15 s = 450、24 s = 720)、
  205. H.264 CRF 15~17(1080p 比 720p 吃码率,别照抄更低的档)、AAC 384k(256k 在瞬态多的素材上
  206. 会把解码真峰顶过 0 dBFS)、约 −9 ~ −13 LUFS、真峰 −1.0 ~ −0.5 dBTP。
  207. `nb_frames` 必须等于 `T.NFRAMES`——少一帧就是有一场没渲满,逐场核 `out/frames/f*.png` 的数量。
  208. 用户点名要 60fps 时,帧数、缓动标定、音频分析(`A.analyse(..., fps=T.FPS)`)都跟着翻倍,
  209. 见 `references/design-grammar.md` 的「动效标定」和 gotchas 40、43。
  210. ---
  211. ## 六、硬规矩
  212. 1. **时间必须落在整拍网格上**,且 `seconds = bars × 240 / BPM` 要精确等于目标时长,
  213. 帧数 `NFRAMES = round(DUR × FPS)` 必须是整数。
  214. 2. **默认交付 1920×1080 / 30fps**;`--brief` 里写了画幅/帧率就按句子的(竖屏、方形、4K、60fps 都行),
  215. 非 16:9 时模板的场景版式必须重排——SPEC.md 会提醒这一条。
  216. 3. **风格必须从 brief 推、不照抄历史片**:先 `--brief "..."` 落 SPEC.md,
  217. 再按 SPEC 的色板/字体/运动语法写场景。要么同一句话一个样子,要么就说明白为什么改。
  218. 4. **品牌色必须实测**,不准凭印象挑;品牌片必须出现该品牌的 logo 或域名时,用真素材
  219. (从官网/已有 skill 里取原始 PNG/SVG),不要手画。
  220. 5. **文案语言必须按用户要求核对**。要求全英文就扫一遍所有字符串,别留中文:
  221. ```bash
  222. python3 -c "
  223. import re,pathlib
  224. s=''.join(pathlib.Path(p).read_text() for p in pathlib.Path('.').rglob('*.py'))
  225. print('中文字符:', re.findall(r'[\u4e00-\u9fff]+', s) or '无')"
  226. ```
  227. 6. **不要替用户决定对外发布**。渲完只给文件路径;要上传/分享必须用户明确说了才做。
  228. 若某品牌的既有 skill 写了「严禁外发」,默认遵守,用户明确要求覆盖时才上传。
  229. 7. **不许改 `{skill_dir}` 里的模板真源**——一切改动落在用户项目目录。
  230. 8. 逐场审阅至少一轮(`--stills`),不要直接渲全片再看。
  231. ---
  232. ## 七、文件布局
  233. ```
  234. {skill_dir}/
  235. ├── SKILL.md
  236. ├── engine/ 共享引擎(复制进每个项目)
  237. │ ├── core.py 渲染核心:Canvas / 矢量文字通道 / bloom / 色差 / 颗粒 /
  238. │ │ 印刷原语(multiply 叠印、网点、纸纹、套印偏移)
  239. │ ├── three.py 3D:参数曲面 / 相机 / 点云排序散射渲染 / 隐藏线
  240. │ ├── fonts.py 字体栈 + 字距排版 + 基线换算(含 getbbox 的 ascent 坑)
  241. │ ├── anim.py 缓动、错帧、值噪声
  242. │ ├── dsp.py 合成器 DSP:FFT 时变滤波、磁带抖晃、混响、频谱分析
  243. │ └── color.py 颜色按物理量反解:普朗克 / CIE 1931 / 谱线 / 色域拟合
  244. ├── template/ 可跑的最小工程(8 场景骨架 + 一段配乐)
  245. ├── scripts/new_reel.py 从模板起一支新片
  246. ├── references/ 设计语法 / 3D / 印刷 / 音频 / 坑 / 性能 / 默认路线
  247. └── assets/fonts/ 随包字体(Archivo Black / Inter / JetBrains Mono /
  248. Bodoni Moda / Fraunces,均为 OFL,可随包分发)
  249. ```
README.md · README · 196 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # RuiC-motion-reel
  2. **一句话进去,一条片子出来 —— 样式现场推,不从模板库里挑。**
  3. ```bash
  4. python3 scripts/new_reel.py ~/my-film --brief "做一条 20 秒的咖啡品牌片,暖色胶片感,慢"
  5. ```
  6. 这句话被读成六个量(**时长 / 画幅 / 冷暖 / 质感 / 节奏 / 语言**),再推出
  7. **色板、字体对、运动语法、分镜骨架**,写进工程的 `SPEC.md` 与 `theme.py`。
  8. 换一句话就是另一套样子——不参考本仓库里任何一支历史片。
  9. 画面和音乐全部由代码产出:不依赖外部美术素材,也不打开 After Effects。
  10. | 一句话 | 推出来的样子 |
  11. |---|---|
  12. | 20 秒咖啡品牌片,暖色胶片感,慢 | 6 小节 @72 BPM · 暗底 · 琥珀 `#C98036` · 衬线标题 · 颗粒 + halation |
  13. | 竖屏 30 秒,冷色科技感,快,霓虹 | 10 小节 @80 · 1080×1920 · 暗底 · 电青 `#0FACF0` · 粗无衬线 · 扫描线 |
  14. | 12 秒,瑞士极简,白底,黑字,克制 | 8 小节 @160 · 亮底 · 中性蓝 `#247FDB` · 大衬线 + 无衬线 · 只有发丝线 |
  15. | 45 秒产品发布,印刷质感,riso 双色 | 12 小节 @64 · 亮底 · riso 粉 `#D42B63` · 网点 + 套印偏移 + 纸纹 |
  16. 片长由音乐网格算出来,不是"感觉差不多":
  17. | 片长 | 小节(=镜头数) | BPM | 每小节 | 适合 |
  18. |---|---|---|---|---|
  19. | 12 s | 8 | 160 | 1.500 s | 纯冲击,无叙事 |
  20. | 15 s | 8 | 128 | 1.875 s | 作品集样片、单点 demo |
  21. | **24 s** | **12** | **120** | **2.000 s** | **宣传片起点:三个 act** |
  22. | 30 s | 10 | 80 | 3.000 s | 需要一点呼吸的品牌片 |
  23. | 45 s | 12 | 64 | 3.750 s | 产品发布、功能串烧 |
  24. | 60 s | 15 | 60 | 4.000 s | 开场短片、展会循环 |
  25. `seconds = bars × 240 / BPM`,两条路线都从这张表取值。
  26. 下面那张表是引擎**做过**的样子(暗色 HUD / riso 印刷 / 纸艺 / 银盐 / 普朗克 / 蓝图 /
  27. 光刻 / 品牌亮色)——**是历史,不是可选清单**。新片一律从一句话推,不抄这些格子。
  28. 完整成片在 [`docs/films/`](docs/films/)。
  29. > **本 skill 由作者用 DeepSeek Flash 跑通**:从建模、排版、分色到配乐与出片,
  30. > 整条链路都是它自己跑出来的。
  31. > **不绑定模型** —— 支持各大主流多模态模型,任何能读写文件、执行命令的编码 Agent 都能用。
  32. 这是一个 Agent Skill(给 ZCode / Claude Code 这类编码 Agent 用):装上之后,
  33. 一句「用代码做一条 15 秒动态图形片」就能从零到出片。
  34. | 暗色科技 · 流场 | 丝网印 / riso · 封面 | 3D 建模 · 点云渲染 |
  35. |---|---|---|
  36. | ![flow](docs/preview/gifs/flow-field.gif) | ![riso](docs/preview/gifs/riso-cover.gif) | ![rack](docs/preview/gifs/rack-3d.gif) |
  37. | **银盐 / 暗房 · SILVER** | **恒星 · KELVIN** | **氰版蓝图 · MOTION ENGINE** |
  38. | ![silver](docs/preview/gifs/silver.gif) | ![kelvin](docs/preview/gifs/kelvin.gif) | ![blueprint](docs/preview/gifs/blueprint.gif) |
  39. | **纸艺 · DECKLE** | **紫外光刻 · LITHO** | **品牌亮色产品片 · BRAND LIGHT** |
  40. | ![deckle](docs/preview/gifs/deckle.gif) | ![litho](docs/preview/gifs/litho.gif) | ![brand light](docs/preview/gifs/brand-light.gif) |
  41. > 另外还有一支 **24 秒动效宣传片**([`promo-deepseek-24s.mp4`](docs/films/promo-deepseek-24s.mp4),1080p60 / 120 BPM × 12 小节),
  42. > 走的是仓库里的 `remotion/` 路线:12 个镜头、全片文字与配乐都是代码写的,不是 15 秒模板拉长。
  43. > ![promo](docs/preview/gifs/promo-deepseek.gif)
  44. >
  45. > 同系列的 **DeepSeek** 品牌片([`brand-light-demo-15s.mp4`](docs/films/brand-light-demo-15s.mp4),Python 路线):
  46. > 鲸鱼标与字标取 deepseek.com 官网内联 SVG 的原路径(不是重排的近似字体),
  47. > 色值逐条取自其设计 token(`--ds-color-brand` `#4d6bfe` 等),产品界面按其亮色主题自绘。
  48. > **这是用本引擎做的排版与管线演示,与 DeepSeek 无隶属关系,商标归其所有者。**
  49. ## 它能做什么
  50. - **任意时长的成片**,锁在音乐网格上(`seconds = bars × 240 / BPM`),每个场景一小节,
  51. **每一次剪辑都落在强拍上**;`BARS` 不必等于场景数(场景会自动循环铺满)
  52. - **字体排版**:2× 超采样矢量/文字通道、字距排版、字号按目标宽度反解
  53. - **真 3D**:参数曲面建模 + 点云渲染(排序散射做精确遮挡)+ 隐藏线线刻
  54. - **印刷管线**:分色成四块油墨版、旋转网线做网点、乘法定律叠印、
  55. 套印偏移、纸纹、裁切线、套准规
  56. - **配乐合成**:打击乐 / 贝斯 / FM 电钢 / 钟 / 铺底 / riser / impact,
  57. 加磁带抖晃与混响,无采样
  58. - **颜色也能是被算出来的**:给一个物理量就直接得到颜色——黑体温度
  59. (Planck → CIE 1931 → sRGB)、谱线波长、薄膜干涉(氧化层厚度 → 反射光谱)。
  60. LITHO 里曝光光是 405 nm 反解的那支紫,晶圆彩虹是 SiO₂ 厚度 20–780 nm 积分出来的
  61. - **样式从句子推,不抽牌**:冷暖定基色相、质感定主色与后期、节奏定密度,
  62. 色板只有"基色相"一个自由度,其余明度同源。16 张卡降级为参考库(`--style <id>` 才用)
  63. - **出片链**:多进程逐场并行渲染 → H.264 编码 → 混音,1080p30 的 15 秒约 3~8 分钟(排版重的牌更久)
  64. ## 安装
  65. ```bash
  66. git clone https://github.com/HRuiCcc/RuiC-motion-reel.git \
  67. ~/.agents/skills/ruic-motion-reel
  68. ```
  69. 依赖:`python3`(numpy + Pillow)、`ffmpeg`。字体随包(OFL)。
  70. ```bash
  71. pip install numpy pillow
  72. ```
  73. ## 用法
  74. **给 Agent 用**(推荐):把 skill 装到 `~/.agents/skills/` 下即可,
  75. Agent 会在你说「用代码做个动效视频 / 生成一条 15 秒作品集样片 / 给某个品牌做一条片子」时自动使用它。
  76. **手动用**:
  77. ```bash
  78. # 主入口:一句话起片(写 SPEC.md / SPEC.json,并把色板、网格、画幅改进 theme.py)
  79. python3 ~/.agents/skills/ruic-motion-reel/scripts/new_reel.py ~/my-film --brief "一句话需求"
  80. # 只要一份中性模板 / 自己指定片长
  81. python3 ~/.agents/skills/ruic-motion-reel/scripts/new_reel.py ~/my-reel --name my_reel
  82. python3 ~/.agents/skills/ruic-motion-reel/scripts/new_reel.py ~/my-promo --seconds 24
  83. cd ~/my-film
  84. # 看 SPEC.md:片长/画幅/冷暖/质感/节奏/分镜骨架都在这
  85. # 补 my_film/theme.py 里的身份与文案(色板/网格/画幅 brief 已经改好了)
  86. # 写 my_film/scenes.py:按 SPEC 的分镜骨架一场一场画
  87. python3 -m my_reel.build --stills 0 # 抽一场的 7 帧审阅
  88. python3 -m my_reel.build --at 3:1.20 # 某一拍的单帧全分辨率
  89. python3 -m my_reel.build # 出全片
  90. ```
  91. 产物在 `out/`。
  92. ## 仓库结构
  93. ```
  94. SKILL.md Agent 的主工作流(触发条件、流程、硬规矩)
  95. engine/ 共享渲染引擎
  96. core.py 画布、矢量文字通道、bloom/色差/颗粒、
  97. 印刷原语(叠印 multiply、网点、纸纹、套印偏移)
  98. three.py 3D:参数曲面、相机、点云渲染、隐藏线
  99. fonts.py 字体栈、字距排版、基线换算、字号反解
  100. anim.py 缓动、错帧、值噪声
  101. dsp.py 合成器 DSP:FFT 时变滤波、磁带抖晃、混响、频谱分析
  102. template/ 可跑的最小工程(8 个场景 + 一段配乐)
  103. scripts/brief.py 一句话 -> SPEC:时长/画幅/冷暖/质感/节奏 -> 色板、字体、分镜骨架
  104. remotion/ 24 秒宣传片的 Remotion 路线(React 组件 + 浏览器渲染,60fps)
  105. scripts/
  106. new_reel.py 从模板起一支新片(默认抽一张风格牌,写进项目 STYLE.md)
  107. style_lottery.py 16 张视觉语言的牌堆,抽签 / 列牌 / --avoid 上一张
  108. preview_gif.py 成片或帧序列 → README 用的循环预览 GIF
  109. perf_probe.py 逐算子 CPU vs CuPy,看换显卡到底能省多少
  110. references/
  111. style-synthesis.md 一句话 → 一套视觉:六个量怎么读、色板怎么反解、六个质感的语法
  112. promo-brief.md 一句话 brief → 分镜:片长选型、16 项要素表、24 秒 12 刀模板
  113. remotion-default.md 为什么常规成片默认走 Remotion、显卡到底在哪一步出力
  114. references/ 按需加载的细节文档
  115. design-grammar.md 设计语法:时间网格、排版、构图、动效、亮度校准
  116. three-d.md 3D 引擎用法与配方
  117. print-pipeline.md 分色、网点、叠印、版面家具
  118. audio-dsp.md 配乐合成
  119. gotchas.md 踩过的坑(近 40 条,症状与真因)
  120. performance.md 一帧花在哪、换显卡能省多少(实测)
  121. assets/fonts/ 随包字体(OFL 1.1,见 NOTICE.md)
  122. assets/wechat-donate.png 赞赏码
  123. ```
  124. ## 设计上的几个立场
  125. **时间先有网格,再有镜头。** 「剪辑点落在强拍上」不是后期对轴对出来的,
  126. 是结构决定的——一个小节一个场景,所以音乐和画面共用一条时间轴。
  127. **3D 不用三角形光栅化器。** Python 里逐三角形太慢;把曲面密采样成点云、
  128. 投影后按深度排序散射(numpy 对重复下标保留最后一次写入 = 画家算法),
  129. 遮挡精确、无逐三角形循环,而且密集点云自带颗粒感——铜版雕刻也是这个原理。
  130. **颜色是被算出来的,不是被指定的。** 印刷管线把明暗拆成几块油墨版,
  131. 各自用不同网线角度做网点,再以乘法叠印。粉压蓝是真紫、黄压蓝是真绿——
  132. 中间调是油墨自己叠出来的。
  133. **品牌色必须实测。** 官网样式表、产品截图,不要凭印象挑。
  134. 亮色品牌的暗色版不是另选一套色,而是把同一套色读到曝光的另一端。
  135. 品牌 logo 同理——取官网的原始 SVG/PNG,不要手画,也不要把字标重排成「像 logo 的字体」。
  136. **亮底片的后期是反的。** 暗场里 bloom 阈值 0.68 就够,亮场要抬到 0.99(纸白本身 0.97),
  137. 品牌色满幅时甚至要抬到 1 以上(品牌蓝的 B 通道 0.996 会把自己的底板点着)。阈值低于底板亮度,整帧就被自己的底色洗白——**这个症状看起来像调色不对,真因在阈值**。
  138. ## 已知的坑都写在代码注释里
  139. `references/gotchas.md` 有 40 多条,每条都是真踩过的,而且症状都不指向真因。举三个:
  140. - PIL 的字形包围盒是相对 **ascender** 而非基线,按字高居中会整体低一个字身(168px 字号偏 147px)
  141. - 重叠相加滤波要除以**窗和**(窗只加了一次);除以窗平方和会引入 2× 纹波,
  142. 且首尾样本会把舍入噪声放大上千倍
  143. - AAC 编码后**采样间峰值超过采样峰值**,采样峰值定 0.92 会得到 +0.3 dBTP(已超 0 dBFS)
  144. ## 赞赏支持
  145. <div align="center">
  146. <img src="assets/wechat-donate.png" width="300" alt="微信赞赏码" />
  147. <p><strong>微信扫码赞赏</strong></p>
  148. <p>微号:<strong>hrc_rch</strong>(说明来意)</p>
  149. </div>
  150. ---
  151. ## 协议
  152. 代码 MIT(见 `LICENSE`)。随包字体为 SIL Open Font License 1.1,
  153. 版权与协议见 `assets/fonts/NOTICE.md` 与 `assets/fonts/OFL.txt`。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.