Video

视频制作与处理

综合视频处理工具，涵盖从制作到发布的全流程。

功能模块

内容设计方法论（必读）

制作视频时，必须遵循以下经过验证的内容设计原则。

1. 黄金三秒法则

开头3秒决定用户去留，必须包含强钩子：

执行：视频第一个场景的配音文案必须是钩子，不能有寒暄/铺垫。

2. 好奇心闭环结构

主闭环（覆盖全视频）：开场提出问题 → 结尾揭示答案
├── 小闭环1（0-30s）：提出子问题 → 给出价值
├── 小闭环2（30-60s）：新悬念 → 奖励
└── 小闭环3（60-90s）：深化 → 总结

• 每30-45秒设置一个小闭环，给观众多巴胺奖励
• 每个小闭环关闭前，先打开下一个悬念

3. 完播率优化

4. 字幕规范

• 每块字幕 15-20 个字符（认知最优长度）
• 关键词用大号/不同颜色强调
• 字幕与语音同步偏差 < 200ms（用 Whisper 确保精度）
• 即使有声音也要加字幕（双通道信息留存率更高）

5. 叙事结构选择

一、极速发布（Instant Publisher）

手机/电脑一键录制，自动转码、ASR 字幕、发布到 B 站/小红书。

启动服务

cd ~/.claude/skills/video/tools/instant-video-publisher
./start.sh

访问方式

工作流程

录制 → WebM转MP4 → ASR字幕 → 生成封面 → (可选)烧录字幕 → 发布

视频存储位置

~/Videos/instant-publish/
├── 2026-01-31T08-33-26_测试.webm    # 原始录制
├── 2026-01-31T08-33-26_测试.mp4     # 转码后
├── 2026-01-31T08-33-26_测试.srt     # ASR 字幕
├── 2026-01-31T08-33-26_测试_cover.jpg  # 封面
└── 2026-01-31T08-33-26_测试.json    # 任务元数据

二、视频制作

素材库位置

项目输出位置

/Users/liuyishou/usr/projects/inbox/{项目名}/out/{YYYYMMDD}_{风格}_{主题}.mp4

支持的风格模板

视频制作工作流（必须遵循）

Step 1: 确认需求

收到视频制作请求后，确认：

• 风格：用户指定的风格（如"铅笔白板风"）
• 主题：视频主题（如"保时捷5大车型"）
• 场景列表：每个场景的标题和配音文案

如果用户没有提供完整信息，使用 AskUserQuestion 询问。

Step 2: 创建项目

PROJECT_NAME="porsche-models"
PROJECT_DIR="/Users/liuyishou/usr/projects/inbox/$PROJECT_NAME"
SKILL_DIR="$HOME/.claude/skills/video"

# 复制模板
cp -r "$SKILL_DIR/templates/pencil-whiteboard" "$PROJECT_DIR"

# 复制音效（从内容公关部素材库）
ASSETS_DIR="$HOME/.claude/agents/content-pr-department/assets"
cp "$ASSETS_DIR/audio/sfx/pencil_writing.mp3" "$PROJECT_DIR/public/audio/pencil.mp3"
cp "$ASSETS_DIR/audio/bgm/calm/口播背景_轻柔.mp3" "$PROJECT_DIR/public/audio/bgm.mp3"

# 安装依赖
cd "$PROJECT_DIR"
npm install

Step 3: 生成配音

使用 volc-tts skill 为每个场景生成配音：

cd ~/.claude/skills/api-tts

# 为每个场景生成配音
python scripts/tts.py --voice huopo -o $PROJECT_DIR/public/audio/scene1_raw.mp3 "配音文案"

# 添加首尾静音（开头 0.8s，结尾 1s）
cd $PROJECT_DIR/public/audio
ffmpeg -y -i scene1_raw.mp3 -af "adelay=800|800,apad=pad_dur=1" scene1.mp3
rm scene1_raw.mp3

Step 4: 生成图片

使用 draw skill 生成手绘风格图片：

# 铅笔白板风 Prompt 模板：
# Hand-drawn whiteboard sketch style, 9:16 vertical (1080x1920px),
# bold black marker with blue accents, pure white background.
# [具体场景描述]

# 复制到项目
cp 生成的图片.png $PROJECT_DIR/public/slides/01_scene.png

Step 5: 配置场景

编辑 $PROJECT_DIR/src/scenes.ts：

export const scenes: Scene[] = [
  { slide: "slides/01_hook.jpg", audio: "audio/hook.mp3", duration: 7.5 },
  { slide: "slides/02_scene1.png", audio: "audio/scene1.mp3", duration: 8 },
  // 场景时长 = 绘制时间(1.5s) + 配音时长 + 缓冲(0.5s)
];

计算场景时长：

# 获取音频时长
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 $PROJECT_DIR/public/audio/scene1.mp3
# 场景时长 = 1.5 + 音频时长 + 0.5

Step 6: 渲染导出

cd $PROJECT_DIR

# 渲染视频
npx remotion render Main out/output.mp4

# 重命名（遵循命名规范）
DATE=$(date +%Y%m%d)
STYLE="铅笔白板"
SUBJECT="主题名"
mv out/output.mp4 "out/${DATE}_${STYLE}_${SUBJECT}.mp4"

Step 7: 生成封面并内嵌（必须）

视频导出后必须执行：

VIDEO_FILE="out/${DATE}_${STYLE}_${SUBJECT}.mp4"
COVER_FILE="out/${DATE}_${STYLE}_${SUBJECT}_cover.jpg"

# 方式1: 从视频截取封面（快速）
ffmpeg -y -ss 3 -i "$VIDEO_FILE" -frames:v 1 -q:v 2 "$COVER_FILE"

# 方式2: AI 生成封面（推荐，用 draw skill）

# 内嵌封面到视频
ffmpeg -y -i "$VIDEO_FILE" -i "$COVER_FILE" \
  -map 0:v -map 0:a -map 1 \
  -c:v copy -c:a copy -c:2 mjpeg \
  -disposition:2 attached_pic \
  "out/${DATE}_${STYLE}_${SUBJECT}_with_cover.mp4"

# 替换原文件
mv "$VIDEO_FILE" "out/${DATE}_${STYLE}_${SUBJECT}_no_cover.mp4"
mv "out/${DATE}_${STYLE}_${SUBJECT}_with_cover.mp4" "$VIDEO_FILE"
rm "out/${DATE}_${STYLE}_${SUBJECT}_no_cover.mp4"

# 验证（应该看到 3 个流：h264 + aac + mjpeg）
ffprobe -v quiet -show_streams "$VIDEO_FILE" | grep -E "codec_type|codec_name"

封面尺寸参考：

三、章节导航条

为视频添加章节导航条，显示当前章节进度和标题。

导航条样式

• 位置：视频底部（可配置）
• 高度：80px
• 背景：半透明黑色 (rgba(0,0,0,0.8))
• 进度条：蓝色 (#4A90E2)
• 文字：白色，24px

使用方法

1. 准备章节配置

创建 chapters.json：

{
  "chapters": [
    {"title": "开场介绍", "start": 0, "end": 10},
    {"title": "核心内容", "start": 10, "end": 30},
    {"title": "总结", "start": 30, "end": 40}
  ]
}

2. 生成导航条

python ~/.claude/skills/video/scripts/add_chapter_nav.py \
  --input "输入视频.mp4" \
  --output "输出视频.mp4" \
  --chapters "chapters.json"

参数说明

四、参数配置

视频制作参数

章节导航条参数

五、文件命名规范

{YYYYMMDD}_{风格}_{主题}.mp4
{YYYYMMDD}_{风格}_{主题}_cover.jpg

示例：

• 20260128_铅笔白板_保时捷5大车型.mp4
• 20260128_铅笔白板_保时捷5大车型_cover.jpg

六、快速命令

# 创建视频项目
~/.claude/skills/video/scripts/create-project.sh <项目名> <风格>

# 添加章节导航
python ~/.claude/skills/video/scripts/add_chapter_nav.py \
  --input "原视频.mp4" \
  --output "带导航视频.mp4" \
  --chapters "chapters.json"

依赖

• Node.js + Remotion（视频制作）
• FFmpeg（视频处理）
• Python 3.8+（脚本工具）
• volc-tts skill（配音生成）
• draw skill（图片生成）