Video Editor Full — 全栈视频后期 Skill
整合 6 大能力的一站式视频后期制作 Skill。从原始录屏到成品发布，全程 AI 驱动。
能力矩阵
| 模块 | 工具 | 用途 | 依赖 |
|---|---|---|---|
| 转录 | Whisper (base/small/medium) | 语音→字幕 SRT | Python + openai-whisper |
| 去静音 | auto-editor | 自动 jump cut 死空气 | Python + auto-editor |
| 精剪 | ffmpeg filter_complex | PIP放大镜、章节标题、加速、drawbox高亮 | ffmpeg 7.0+ |
| 字幕 | ffmpeg subtitles filter | 烧录 SRT（支持中文雅黑） | ffmpeg + 字体 |
| 动画 | Remotion | 片头片尾、数据可视化、动态图表 | Node.js 18+ + Remotion |
| 品牌视频 | HyperFrames | HTML/CSS→视频、AI数字人 | Node.js + HeyGen API Key |
工作流总览
┌─────────────┐ ┌──────────────┐ ┌─────────────────┐
│ 原始视频 │────▶│ 分析 & 转录 │────▶│ 内容规划 │
└─────────────┘ └──────────────┘ └─────────────────┘
│
┌──────────────────────────────┼──────────────────┐
▼ ▼ ▼
┌──────────────┐ ┌─────────────────┐ ┌──────────────┐
│ auto-editor │ │ ffmpeg 精剪 │ │ Remotion │
│ 去静音/jump │ │ PIP+章节+加速 │ │ 片头片尾 │
└──────┬───────┘ └────────┬────────┘ └──────┬───────┘
│ │ │
└─────────────────────────────┼───────────────────┘
▼
┌─────────────────┐
│ 字幕烧录 │
│ + 最终导出 │
└─────────────────┘
前置条件
# 必需
pip install openai-whisper auto-editor
# ffmpeg 必须在 PATH 中（推荐 7.0+）
ffmpeg -version
# 可选：Remotion（片头片尾动画）
npx create-video@latest --blank
# 可选：HyperFrames（品牌视频）
# 需要 HeyGen API Key，见 templates/hyperframes-config.example.json
模块详解
模块 1：分析 & 转录
Step 1: 视频元数据
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4
关注：分辨率、帧率、时长、编码器、比特率。
Step 2: 提取关键帧（每 5 秒）
mkdir -p frames
ffmpeg -i input.mp4 -vf "fps=1/5" -q:v 2 frames/frame_%03d.jpg
用视觉分析确定重点 UI 区域、章节边界、放大镜目标。
Step 3: Whisper 转录
import whisper
model = whisper.load_model("base") # 中文用 base 即可，medium 更准但慢
result = model.transcribe("audio.wav", language="zh")
输出 SRT 后必须人工校准：
- 专有名词（产品名、技术术语）
- 时间轴对齐（尤其后半段容易漂移）
- 同音字错误
模块 2：auto-editor 去静音
# 基础用法：去掉所有静音段
auto-editor input.mp4 --margin 0.2s --output no_silence.mp4
# 保守模式：只去超过 1 秒的静音
auto-editor input.mp4 --min-clip-length 1s --margin 0.3s --output no_silence.mp4
# 导出 timeline（不直接渲染，用于后续 ffmpeg 精剪）
auto-editor input.mp4 --export timeline:api
注意：auto-editor 去静音后时间轴会变，字幕必须在去静音之后再生成或重新对齐。
推荐顺序：原始视频 → auto-editor → 再转录/对齐字幕 → ffmpeg 精剪
模块 3：ffmpeg 精剪（核心）
3.1 PIP 放大镜（画中画）
# 关键：crop 区域用 force_original_aspect_ratio 避免拉伸
PIP_W, PIP_H = 300, 188 # 目标 PIP 窗口尺寸
# filter_complex 片段：
# crop → scale（保持比例）→ pad（补黑边）→ drawbox（黄色边框）
f"[pip{i}]crop={cw}:{ch}:{cx}:{cy},"
f"scale={PIP_W}:{PIP_H}:force_original_aspect_ratio=decrease,"
f"pad={PIP_W}:{PIP_H}:(ow-iw)/2:(oh-ih)/2:color=0x1a1a2e,"
f"drawbox=x=0:y=0:w={PIP_W}:h={PIP_H}:color=yellow:t=2"
f"[pip{i}s]"
3.2 章节标题（drawtext fade）
# 在章节切换点显示标题，淡入淡出
f"drawtext=text='{title}':"
f"fontfile='C\\:/Windows/Fonts/msyh.ttc':"
f"fontsize=28:fontcolor=white:borderw=3:[email protected]:"
f"x=(w-text_w)/2:y=30:"
f"alpha='if(lt(t,{start}),0,if(lt(t,{start}+0.4),(t-{start})/0.4,"
f"if(lt(t,{end}-0.4),1,if(lt(t,{end}),({end}-t)/0.4,0))))':"
f"enable='between(t,{fade_in},{fade_out})'"
3.3 加速
# 视频加速
f"[vout]setpts=PTS/{SPEED}[vfinal]"
# 音频加速（atempo 范围 0.5-2.0，超过需要链式）
f"[0:a]atempo={SPEED}[afinal]"
3.4 字幕时间轴同步
加速后字幕时间码必须同步调整：
new_start = original_start / SPEED
new_end = original_end / SPEED
3.5 完整构建模板
见 scripts/build_template.py
模块 4：Remotion 动画片段
适用于生成片头、片尾、过渡动画、数据可视化。
# 初始化 Remotion 项目
npx create-video@latest my-intro --blank
# 在 src/Composition.tsx 中编写动画
# 渲染为 MP4
npx remotion render src/index.ts MyComp out/intro.mp4
生成的片段通过 ffmpeg concat 拼接到主视频：
# concat list
echo "file 'intro.mp4'" > list.txt
echo "file 'main.mp4'" >> list.txt
echo "file 'outro.mp4'" >> list.txt
ffmpeg -f concat -safe 0 -i list.txt -c copy final.mp4
Remotion Agent Skill 安装：
# 官方 skill（推荐）
git clone https://github.com/remotion-dev/skills.git ~/.claude/skills/remotion
模块 5：HyperFrames 品牌视频
将 HTML/CSS/JS 渲染为视频帧，适合品牌宣传、网站转视频。
# 安装
npm install @anthropic-ai/hyperframes
# 基本用法：HTML → MP4
npx hyperframes render --input composition.html --output brand.mp4
需要 HeyGen API Key 才能使用 Avatar 数字人功能。
配置模板见 templates/hyperframes-config.example.json。
模块 6：最终导出
字幕烧录（最后一步）
ffmpeg -y -i video_no_sub.mp4 \
-vf "subtitles='srt_path':force_style='FontSize=13,FontName=Microsoft YaHei,PrimaryColour=&H00FFFFFF,OutlineColour=&H00000000,Outline=2,Shadow=1,MarginV=22,Bold=1'" \
-c:v libx264 -preset slow -crf 17 \
-c:a copy -pix_fmt yuv420p -movflags +faststart \
output.mp4
多平台导出
| 平台 | 分辨率 | 比例 | 时长限制 |
|---|---|---|---|
| YouTube | 1920x1080 | 16:9 | 无 |
| 微信视频号 | 1080x1920 | 9:16 | 60s（推荐） |
| 小红书 | 1080x1350 | 4:5 | 5min |
| Twitter/X | 1280x720 | 16:9 | 2:20 |
| 1920x1080 | 16:9 | 10min |
# 竖屏裁剪示例（16:9 → 9:16）
ffmpeg -i input.mp4 -vf "crop=ih*9/16:ih,scale=1080:1920" -crf 18 vertical.mp4
质量准则
- CRF 17 + slow preset — 教程视频标准质量
- yuv420p — 兼容所有播放器
- faststart — 网络播放秒开
- lanczos — 缩放算法首选
- 不超过 2 次编码 — 避免代际损失
- 字幕最后烧 — 确保时间轴对齐
常见坑
- Windows 路径在 ffmpeg subtitles filter 中需要
/且:要转义为\: - Whisper 在 Windows 上必须用 Windows 路径（不能用
/tmp/） atempo范围 0.5-2.0，超过需要链式：atempo=2.0,atempo=1.5= 3x- PIP crop 区域和目标窗口比例不一致会拉伸，必须用
force_original_aspect_ratio - auto-editor 改变时间轴后，之前的字幕全部失效
- filter_complex 太长不能命令行传，用
-filter_complex_script写文件
文件结构
video-editor-skill-pack/
├── SKILL.md # 本文件
├── scripts/
│ ├── build_template.py # ffmpeg 精剪构建模板
│ ├── transcribe.py # Whisper 转录脚本
│ ├── adjust_srt_speed.py # SRT 时间轴加速调整
│ └── analyze_frames.py # 关键帧提取 + 分析
├── templates/
│ ├── hyperframes-config.example.json
│ └── remotion-intro/ # Remotion 片头模板（待填充）
└── examples/
└── tutorial-video-workflow.md # 教程视频完整工作流示例