bggg-tiktok-capcut

name	bggg-tiktok-capcut
description	通用 CapCut 草稿生成与 AI 视频检查 skill。用于把本地 AI 视频套用现有 CapCut 草稿模板， 生成可在 CapCut 首页显示并可编辑的新草稿；也用于提取模板样式、验证草稿结构、抽帧检查 AI 痕迹、规划修复窗口和做本地 RIFE 补帧。

BGGG TikTok CapCut

这个 skill 只保留通用能力：

• 基于现有 CapCut 草稿模板生成新草稿
• 提取模板里的字幕样式、转场、动画、特效
• 验证草稿是否会被 CapCut 索引并显示
• 对 AI 视频或 CapCut 草稿抽帧做 AI 痕迹检查
• 为明显 AI 痕迹生成修复窗口
• 用本地 RIFE 做高质量补帧预处理

默认 CapCut 草稿根目录：

$HOME/Movies/CapCut/User Data/Projects/com.lveditor.draft

如果你的 CapCut 草稿目录不同，设置 CAPCUT_DRAFT_ROOT 或给脚本传 --output-dir / --draft-root。

生成草稿

node <skill-dir>/scripts/create-capcut-draft.mjs \
  --template "PL-magicrep-PV-001" \
  --video "/path/to/ai-video.mp4" \
  --name "ai-video-capcut-001" \
  --captions "Line 1\nLine 2\nLine 3" \
  --split-at 7.5

常用参数：

参数	说明
--template	已存在的 CapCut 草稿目录名
--video	本地 AI 视频路径
--name	新草稿目录名和首页显示名
--captions	字幕文本，可用 \n 分行
--srt	SRT 字幕文件，替代 --captions
--split-at	视频切分点，转场会挂在切点前一段
--no-transition	不复制模板转场
--no-captions	不生成字幕轨道
--output-dir	自定义 CapCut 草稿根目录
--force	同名草稿已存在时先替换

脚本会同步这些 CapCut 会读取的文件，避免草稿目录存在但首页不显示：

• draft_info.json
• draft_meta_info.json
• draft_info.json.bak
• template-2.tmp
• Timelines/project.json
• Timelines/<draft_info.id>/draft_info.json
• Timelines/<draft_info.id>/template.tmp
• Timelines/<draft_info.id>/template-2.tmp
• root_meta_info.json

生成后如果 CapCut 已打开，完全退出再打开，让首页重新加载 root_meta_info.json。

验证草稿

node <skill-dir>/scripts/validate-capcut-draft.mjs \
  --draft "ai-video-capcut-001" \
  --stale-marker "OLD_TEMPLATE_NAME"

验证点包括：

• root 索引是否有对应条目
• draft_info.id 与 Timelines/<id>、project.json 是否一致
• 顶层和嵌套 draft_info/template 副本是否同步
• 视频素材路径是否存在
• 是否有旧模板名或旧素材路径残留

提取模板样式

node <skill-dir>/scripts/extract-template-styles.mjs \
  --template "PL-magicrep-PV-001" \
  --output ./capcut-template-styles.json

输出包含字幕样式、转场、动画、特效、画布和轨道结构。

AI 痕迹检查

对单个视频抽帧：

node <skill-dir>/scripts/extract-ai-artifact-frames.mjs \
  --video "/path/to/ai-video.mp4" \
  --output-root ./ai-artifact-qa

对 CapCut 草稿时间线抽帧：

node <skill-dir>/scripts/extract-ai-artifact-frames.mjs \
  --draft "ai-video-capcut-001" \
  --output-root ./ai-artifact-qa

批量检查本地目录：

node <skill-dir>/scripts/extract-ai-artifact-frames.mjs \
  --video-dir "/path/to/videos" \
  --output-root ./ai-artifact-qa

阅读 references/ai-artifact-qa.md 获取判定标准和 review JSON 结构。

修复规划

node <skill-dir>/scripts/plan-ai-artifact-fixes.mjs \
  --review ./ai_artifact_review.json \
  --output ./ai_artifact_fix_plan.json

RIFE 补帧

阅读 references/smart-frame-interpolation.md。常用命令：

node <skill-dir>/scripts/smart-frame-interpolate.mjs \
  --input "/path/to/source.mp4" \
  --output "/path/to/source_60fps_rife.mp4"

故障排查

先运行：

node <skill-dir>/scripts/validate-capcut-draft.mjs --draft "<draft-name>"

常见问题见 references/failure-modes.md。

脚本清单

脚本	用途
scripts/create-capcut-draft.mjs	基于模板生成可显示的 CapCut 草稿
scripts/validate-capcut-draft.mjs	验证单个草稿结构和索引
scripts/extract-template-styles.mjs	提取模板样式
scripts/extract-ai-artifact-frames.mjs	对视频/草稿抽帧生成 contact sheet
scripts/plan-ai-artifact-fixes.mjs	根据 review JSON 规划修复窗口
scripts/smart-frame-interpolate.mjs	本地 RIFE 补帧