参考视频蒸馏素材包 · 创作技能

这个技能解决什么问题

把参考视频逐镜头拆成硬切、镜头表、关键帧、配色、字体与动效切片，提炼成可复用的一套视觉资产。

来源与使用

作者 weilanx；许可 MIT。已核对来源与包结构，未据此宣称完成运行实测。

查看原始来源

机器可读详情 · 读取 SKILL.md · 下载完整技能包

让 Agent 使用这个技能 ↗

技能说明全文

---
name: weilanx-creator-distill-video
description: 「参考视频 → 新风格素材包」蒸馏工作流：把用户给的一支或多支参考视频逐镜头拆解（硬切、镜头表、关键帧、联系表、主色板与强调色、运动强度、动效切片、配乐卡点），提炼出配色、字体、版式、入场 / 转场 / 镜头运动、节奏和招牌画面这些「画面语法」，再在 weilanx-claude-videos 工程里从零写成一套可复用的 Remotion 风格素材包：src/library 下一个以风格 ID 命名的组件目录、一个 library- 开头的预览作品、styles/我的风格 下的风格配方卡，并登记进素材库目录和风格总表。用户说「蒸馏这个视频的风格」「把这几个视频的风格整理成一套素材」「一比一复刻这个视频的样式」「拆解这个视频的动效和画面」「照这个视频做一套新风格」，或者丢来参考视频（template/、Downloads 里的 mp4）想学它的样子时都用这个 skill；只想复刻单个动画片段、不需要进素材库的，也先用它做拆解。
---

# 参考视频 → 一套新风格素材包

参考成果：暗金文献风（`src/library/gilded/`、`library-gilded`、`styles/我的风格/暗金文献风/`），就是从一支参考视频（不进 git）蒸馏出来的。用户认可的效果：**风格一眼认得出来，但组件全是重写的，示例内容是自己编的，原片的文案、标题、水印一样没带进来。**

一口气做完第 0～7 步，中途不等用户确认，每步做完用一两句话同步进度。**不导出、不提交 git**，除非用户另外要求。动手前先读工程根目录 `CLAUDE.md`、`src/library/README.md`、`styles/README.md`。所有 npm / npx / node 命令前先 `export NODE_OPTIONS=--max-old-space-size=4096`。

## 蒸馏的边界（先想清楚再动手）

蒸馏的是**画面语法**，不是内容。风格本身（配色倾向、字体搭配、版式网格、出场方式、转场手法、节奏）可以学；具体作品不能搬。

- **学**：配色体系、字体气质和层级、版式位置、元素的入场 / 退场 / 转场方式、缓动和时长、镜头运动、节奏（硬切频率、镜头长度、卡点）、图表 / 道具的画法、质感（颗粒、光晕、纸纹）。
- **不搬**：原片的文案和字幕、标题、具体的场景编排和分镜顺序、创作者的名字 / 水印 / 品牌标识、原片里的人物肖像、第三方 logo 和商标。
- **角色**：原片里有知名的版权角色（动漫、游戏、品牌吉祥物）时，学的是它的构造手法（几何、比例、描边、上色方式），画一个**明显不同的原创角色**，不画得「差不多像」。
- **音乐**：原片配乐不进素材包；要用的话走音乐库（`public/music/`），并在 README 里写明授权未确认。
- 预览作品里的示例文案自己写，换一个和原片不同的题目；引用的书名、人名用「示例文献」「示例人物」这类占位。

用户说「一比一复刻」时，照上面的边界做，回复里一句话说明「风格一比一，内容不搬」。

## 0. 定风格 ID 和目录

- 风格 ID：英文小写 kebab-case，取画面最显著的特征（`gilded`、`ink-scroll`、`neon-grid`），不和 `src/library/` 已有目录重名。中文名 3～6 个字（暗金文献风、宣纸水墨风）。
- 拆解包放 `materials/00-公共/风格蒸馏/<风格ID>/<视频名>/`（`materials/` 不进 git，原片的帧不能进仓库）。
- 产出：`src/library/<风格ID>/`、`src/library/previews/<Name>Demo.tsx`、`styles/我的风格/<中文名>/README.md` + `预览.jpg`。

## 1. 机器拆解（每支视频跑一遍）

```sh
uv run --with numpy --with pillow python .claude/skills/weilanx-creator-distill-video/scripts/analyze.py \
  <视频> --out materials/00-公共/风格蒸馏/<风格ID>/<视频名>
```

产出 `report.md`（先读这个）、`data.json`、`keyframes/`（每个镜头的关键帧）、`sheets/`（每 3 秒一格的联系表）、`palette.png`。报告里有：硬切和镜头表、每秒运动强度、主色板（按面积）和**强调色**（按有彩像素，背景再大也不会把它淹没）、亮度饱和度、音频响度和卡点（调用暗金风 skill 的 `beats.py`）。

硬切太多或太少时调 `--cut`（默认 0.30，越小越敏感）；联系表太密或太疏时调 `--every`。

## 2. 人眼拆解：看懂它为什么好看

详见 `references/拆解方法.md`。顺序：

1. **联系表**通看一遍，分出几类画面（标题卡、年份抬头、图表、实物、引文……），记下每类出现在哪几秒。
2. **关键帧**逐张看，裁出局部放大看字体、描边、阴影、质感（`ffmpeg -vf crop=…`）。
3. **动效切片**：入场、退场、转场、招牌动作各切一条，数「几帧完成」「先快后慢还是匀速」「有没有模糊 / 缩放 / 位移」：
   ```sh
   uv run --with pillow python .claude/skills/weilanx-creator-distill-video/scripts/strip.py <视频> \
     --at 16.6 --span 1.2 --n 8 --out materials/00-公共/风格蒸馏/<风格ID>/strips/t16.6.jpg
   ```
   运动强度曲线上的尖峰、镜头表里的切点前后，都值得切一条。
4. 取色：强调色看报告，具体元素的颜色在关键帧上取像素（`uv run --with pillow python -c "…getpixel…"`）。
5. 多支视频时，先各自拆，再找**共同的语法**；不一致的地方记成「变体」（比如暖调 / 冷调两种光晕）。

## 3. 写风格配方卡

用 `references/配方卡模板.md` 的结构，写进 `styles/我的风格/<中文名>/README.md`：一句话定位、画面特征（底色质感、配色、字体、固定版式、出场、转场、镜头、节奏、招牌画面）、组件清单、关键代码位置、期数表、「没有搬的东西」。这是写代码前的设计稿，写清楚了再动手。

## 4. 写素材包代码

照 `src/library/gilded/` 的分层写（它就是第一次蒸馏的成果，结构可以直接参考）：

| 文件 | 放什么 |
|---|---|
| `theme.ts` | 配色常量、字体常量、渐变字 / 发光这类样式函数、通用出场函数（如 `soft`）和缓动 |
| `stage.tsx` | 舞台层：背景、质感（颗粒 / 浮尘 / 纸纹）、固定版式元素（抬头、引用、字幕）、标题卡、引文、柔入容器 |
| `props.tsx` | 实物和道具 |
| `charts.tsx` | 这个风格画图表的方式（只在原片有图表时写） |

硬规则（工程约定，见 `CLAUDE.md`）：

- **动画是帧号的纯函数**：组件收 `f` 算样子，随机只用 `rand(seed)`，不用 CSS 动画和 `Math.random()`。
- 素材库不能 import `src/episodes/`。
- 字体用仓库里已有的（`public/fonts/`，OFL）或系统字体；要新加字体先确认许可，加进 `public/fonts/` 并更新 `public/fonts/LICENSES.md`。
- 每个组件写一行中文注释说明用途和关键参数。

## 5. 预览作品

- `src/library/previews/<Name>Demo.tsx`：每 150 帧一场，把每个组件演一遍，场与场之间用这个风格自己的转场；示例文案自己写、题目和原片不同。
- 导出 `<NAME>_DEMO_FRAMES`，在 `src/Root.tsx` 注册 `library-<风格ID>`，画幅和原片一致。
- `npm run typecheck && npm test`。

## 6. 对照自查（至少两轮）

- 每场抽一帧：`npx remotion still src/index.ts library-<风格ID> /tmp/<风格ID>/sN.jpg --frame=N --scale=0.5 --timeout=120000`，**一次只渲一帧**（并行会内存溢出）。
- 和原片同类画面的关键帧左右拼在一起比（`ffmpeg -i 原片帧 -i 我们的帧 -filter_complex hstack`），逐项对：底色、主色、强调色、字体气质、字号层级、版式位置、质感、留白。
- 动效对照：同一类入场，原片切片 vs 我们的切片，帧数和缓动对得上吗？
- 每轮列出差距 → 改 → 再渲；常见问题：小字号上的渐变字发褐、发光太弱、元素太小留白太多、图表挤在中间。
- 改完把 4 场拼成 `styles/我的风格/<中文名>/预览.jpg`（只用我们自己渲染的帧，不放原片截图）。

## 7. 登记和交付

- `src/library/README.md` 加一节（照「暗金文献风 gilded/」的格式：文件 | 内容 表 + 要点）。
- `styles/README.md` 的「我的风格」表加一行；配方卡的期数表写「还未使用」。
- Studio 预览链接：`http://localhost:3000/library-<风格ID>`（没开就后台起 `npx remotion studio src/index.ts --no-open --port 3000`）。
- 回复里给：这套风格的要点（3～5 条）、组件清单、对照自查改了什么、哪些东西有意没有搬、还没做到的地方。
- 用户想马上用它做一期时，接着用对应的出片工作流（无口播知识短片可以参考 `weilanx-creator-gilded-video` 的流程，把素材包换成新的）。

技能是任务材料，不会自动授予账户权限、付费授权或其他系统权限。请让 Agent 按说明核对依赖，再在授权范围内使用。