neon-replicate

Neon Replicate — 动效复刻工作流

从参考视频分析运动规律，生成 .neon 文件复刻效果，截帧对比迭代优化。

复刻目标：形似而非像素级一致。抓住效果的"灵魂特征"，而不是描摹每一个细节。

Prerequisites

{skill_dir} is the directory where this SKILL.md file is located.

• neon skill 已安装（neon 命令可用）
• FFmpeg 已安装（ffmpeg 命令可用）

验证：

neon --version && ffmpeg -version | head -1

Workflow Overview

1. 准备   → 创建工作目录，放入源视频
2. 分析   → 智能截帧 → 识别阶段灵魂 → 生成分析报告
3. 生成   → 基于报告创建 .neon → neon render
4. 对比   → 按阶段检查灵魂特征 → 定位问题
5. 迭代   → 每轮只修一个阶段 → 重新渲染 → 循环

Step 1: 准备工作目录

mkdir -p replicate-<效果名>/analysis/frames

输入源可以是本地文件或 URL：

# 本地文件
cp /path/to/effect.mp4 replicate-<效果名>/source.mp4

# URL 下载
curl -L -o replicate-<效果名>/source.mp4 "<url>"

Step 2: 智能截帧分析

第一阶段：粗扫描

以 2fps 截取全局概览帧：

bash {skill_dir}/scripts/extract-frames.sh coarse replicate-<效果名>/source.mp4 replicate-<效果名>/analysis/frames/

查看粗扫描帧，建立整体认知：

• 动效分几个阶段？每个阶段的"身份"是什么？
• 哪些时间段需要密集采样？

第二阶段：密集采样

对关键区间以 10fps 截帧（start 和 duration 单位为秒）：

bash {skill_dir}/scripts/extract-frames.sh dense replicate-<效果名>/source.mp4 replicate-<效果名>/analysis/frames/ <start> <duration>

可对多个区间分别执行。

输出分析报告

查看所有截帧后，将分析写入 replicate-<效果名>/analysis/report.md。

---

分析报告模板

核心原则：先识别"灵魂"（定义效果身份的特征），再补充细节。灵魂必须可量化、可验证。

# 动效分析报告

## 基本信息
- 视频时长: Xms
- 分辨率: WxH（分析使用相对值，不依赖绝对分辨率）
- 背景色: #XXXXXX
- 阶段数: N

---

## 效果灵魂（时间线）

### 阶段 1: [阶段名] (0-Xms)

**灵魂特征**（定义这个阶段身份的可观测特征）：
- 运动方向: [具体描述，如"所有元素指向中心，角度误差 < 20°"]
- 运动曲线: [如"easeOutCubic，前 50% 时间完成 80% 位移"]
- 空间变化: [如"半径从 5% cMin 扩展到 25% cMin"]
- 视觉变化: [如"透明度从 100% 线性衰减到 0%"]

**验证方法**：
- [如何在截帧上确认这个特征存在]
- [测量哪几帧的什么数据]

**缺失后果**：
- [如果没有这个特征，效果会变成什么样]

**权重**: 🔴 关键 / 🟡 重要 / 🟢 锦上添花

---

### 阶段 2: [阶段名] (X-Yms)

**灵魂特征**：
- ...

**验证方法**：
- ...

**缺失后果**：
- ...

**权重**: 🔴/🟡/🟢

---

（继续添加更多阶段...）

---

## 特征分级总览

### 🔴 必须对齐（丢了就不是这个效果）
- 阶段 X 的 [具体特征]
- 阶段 Y 的 [具体特征]

### 🟡 尽量接近（影响质感）
- [具体特征]

### 🟢 可自由发挥（随机细节）
- 单个粒子的具体轨迹
- 精确的随机分布位置
- 微小的时间偏移

---

## 技术实现要点

### 渲染模式
- canvas 2D / WebGL / hybrid

### 核心算法
- [生成机制：粒子系统 / 数学曲线 / 噪声场 / 物理模拟]

### 后处理
- [bloom / blur / 混合模式等]

### 关键参数（相对单位）
| 参数 | 值 | 来源 |
|------|-----|------|
| 粒子数量 | ~100 | 从帧 X 密度估算 |
| 扩散速度 | 30% cW/s | 从帧 N→N+1 位移计算 |
| 初始半径 | 5% cMin | 从帧 X 测量 |
| ... | ... | ... |