TikTok剪辑器 — 视频 → 病毒式传播剪辑（带字幕）

功能说明

将长视频转录，识别适合在TikTok/Reels发布的高吸引力片段，使用ffmpeg进行剪辑，并添加TikTok风格的动态字幕。

适用场景

• 用户发送一段视频并希望生成TikTok/Reels剪辑
• 用户提出“剪一下”、“找爆款片段”、“为TikTok剪辑”等请求
• 用户希望为视频剪辑添加字幕

处理流程

第一步：语音转写

# 使用Whisper进行转写（带单词级时间戳）
python3 SKILL_DIR/transcribe.py --input VIDEO_PATH --output TRANSCRIPT.json

使用OpenAI Whisper API，设置 timestamp_granularities=["word","segment"] 实现精确的字幕时间对齐。

第二步：分析并推荐剪辑片段

读取转写文本，识别适合在TikTok上表现良好的内容段落：

• 开头钩子：有力的开场语、引发好奇的陈述或问题
• 价值炸弹：关键洞察、惊人事实、可操作建议
• 情绪高潮：热情洋溢、幽默感强或表达强烈观点的时刻
• 故事弧线：具备完整起承转合的小故事
• 争议性话题：具有争议性的观点，能激发评论互动

以编号列表形式呈现候选剪辑片段，包含：

• 时间范围（开始 → 结束）
• 持续时长
• 钩子句（首句）
• 可能成为爆款的原因
• 建议标题文案

用户从中选择需要剪辑的片段。

第三步：剪辑视频片段

python3 SKILL_DIR/clip.py --input VIDEO_PATH --start MM:SS --end MM:SS --output CLIP.mp4

• 使用ffmpeg进行重新编码，确保剪辑干净
• 如需，自动转换为9:16竖屏格式（裁剪或填充）
• 输出符合TikTok要求的格式（h264编码、aac音频、mp4容器）

第四步：添加TikTok风格字幕

python3 SKILL_DIR/subtitles.py --input CLIP.mp4 --transcript TRANSCRIPT.json --start SS --end SS --style STYLE --output FINAL.mp4

支持的字幕样式：

1. bold-center：白色粗体文字，黑色描边，居中位于画面底部三分之一处（经典TikTok风格）
2. word-highlight：逐词高亮显示，颜色为黄色或绿色（类似CapCut自动字幕）
3. karaoke：当前词语放大并变色（Alex Hormozi风格）
4. box：文字带有彩色背景框（MrBeast风格）

所有样式均使用ASS（Advanced SubStation Alpha）格式，通过ffmpeg实现丰富动画效果。

第五步：竖屏格式处理

若原始视频为横屏（16:9），自动裁剪为9:16竖屏：

• 人物居中裁剪（适用于出镜讲解类视频）
• 或采用模糊背景填充（小视频居中，四周模糊填充）

输出文件

所有输出文件保存至 /home/ubuntu/clawd/clips/，命名规则为：{源文件名}-clip{N}-{样式}.mp4

运行要求

• 已安装 ffmpeg
• OpenAI API密钥（配置在 .env 文件中）
• 输入视频文件

注意事项

• TikTok最长建议90秒，性能最佳
• 最佳时长区间：30–60秒
• 必须以强钩子开头（前3秒至关重要）
• 字幕最多两行，每行约5–7个词