用途:把原始口播视频剪辑成成品竖屏短视频。所有品牌选择(颜色、字体、字幕风格、声音、CTA)均取自用户的 brand 文件,不采用技能默认值。工作目录为 ~/reels/(可用 REELS_HOME 覆盖)。
主要能力与流程:
- 前置检查:无 ~/reels/brand.md 时先按 references/setup-interview.md 做设置访谈;有则通读 brand.md 与 brand.json。用 bash scripts/doctor.sh 检查 ffmpeg、Node、HyperFrames 及 CapCut 连接器。
- 每条视频独立文件夹 ~/reels/<yyyy-mm-dd>-<short-name>/,复制原始素材,不编辑原件。
- 转录:python3 scripts/transcribe.py <clip> transcript.json;有 ELEVENLABS_API_KEY 时用 ElevenLabs Scribe,否则用本地 Whisper(免费,时间可能漂移约 0.3 秒)。
- 清理人声:bash scripts/clean_audio.sh <clip> voice.wav(可加 --denoise),目标 -14 LUFS。
- 审查:先看首尾各 4 秒每 0.5 秒抽帧,提出删句、去填充词、CTA 移至结尾、目标 60 秒以内及图形方案,等用户确认后再剪。
- 收紧与剪辑:写 edl.json,跑 python3 scripts/tighten.py <folder> 与 python3 scripts/cut.py <folder>,速度来自品牌 pacing 预设或 brand.json 的 speed。
- 图形与字幕:python3 scripts/auto_edit.py <folder> 生成 edit.json,手动一轮设置每句关键词 "accent": true 并按 graphics 密度(minimal 每 8-12 秒、balanced 每 4-6 秒、busy 每 2-4 秒)加卡片。Hook 标题每行约 10 字符、2-3 行,是唯一带描边的文字。
- 渲染与交付:REEL_PREVIEW=1 bash scripts/render.sh <folder> 出草稿,批准后 bash scripts/render.sh <folder> --final(CapCut 路线加 --capcut)→ final.mp4;再跑 python3 scripts/qa.py <folder>,grab 每张卡片帧检查后 bash scripts/deliver.sh <final.mp4> "<clear name>"。CapCut 仅在 brand.json 有 "capcut": true 时启用。
限制:文档未提供安装步骤细节(指向仓库 README);CapCut 路线并非处处可用,MP4 路线始终可用;不要手写合成 HTML 或使用其他 HyperFrames 工作流;若品牌规则与编辑品味冲突,以 brand.md 为准,并即时把用户纠正写入 Rules。