social-video-folder-autocutter

社交视频文件夹自动剪辑器

当用户希望从包含相机/音频文件的文件夹出发，构建可重复执行的流水线，以产出社交短视频或长视频剪辑时，请在编辑前使用本流程。

输出配置

• 竖屏社交： 1080x1920，9:16，最长 3 分钟，以说话人为主的片段默认 1.1x 速度，Netflix 风格字幕，源图层在 Resolve 中保留。
• 横屏长视频： 1920x1080，16:9，3-7 分钟，默认正常速度，下三分之一字幕/字幕可选，源图层在 Resolve 中保留。

必需流水线

1. 扫描文件夹：
   • 运行 DaVinci 技能 probe_media.py；
   • 运行 audio_quality_audit.py；
   • 识别相机 ISO、HQ 音频、片头/转场、品牌文件、旧渲染和现有 Resolve 导出。
2. 制定故事计划：
   • 钩子/议程，
   • 正文节拍，
   • 回顾/CTA，
   • 被拒绝或有风险的片段。
3. 构建剪辑决策：
   • 源文件、入点/出点、机位、原因、转场、裁剪、音频源、字幕文本。
   • 拒绝仅按词边界剪切。
4. 构建 B-roll 覆盖计划：
   • 仅在 B-roll 能证明某个论点、建立事件世界、覆盖跳切、压缩时间，或为观众提供情绪/视觉释放时，才分配 B-roll。
   • 将每个 B-roll 候选标记为 wide、medium、close-up、insert/detail、environment、screen/product 或 human moment。
   • 优先使用宽/中/特写序列，而不是孤立的填充镜头。
   • 要求库存素材提供来源页面/许可元数据，并将其与清单一起存储。
   • 除非用户明确要求纹理效果，否则拒绝在人物面部上叠加低不透明度遮罩；默认使用完全不透明切出或设计好的画中画。
   • 在温暖流量教育类短视频中，谨慎使用 B-roll 作为证明/覆盖。在建立信任的节拍中让说话人保持出镜，并将库存插入镜头保留给关于工作、学习、规划、社区或工具使用的论点。
   • 如果说话人正在实际演示某个概念，优先使用该表演，而不是通用 B-roll。将白板/道具用作快速视觉辅助，而不是长时间替代说话人。
   • 拒绝超过 3s-5s 的静态白板/幻灯片替代，除非用户明确要求屏幕录制风格课程。对于 Instagram，在口头教育节拍中说话人应保持可见。
   • 在计划中保留 B-roll 源 URL/许可说明，并在单独的 Resolve 轨道上保持原始 B-roll 源禁用，以便 HITL 替换。
   • 当项目缺乏足够的原生视觉证据时，使用 Coverr 作为默认免费 B-roll 来源。存储搜索查询、源 URL、创作者/来源署名、许可 URL、下载路径，以及任何未使用候选的拒绝原因。
   • Coverr 许可/API 说明必须与清单一起记录：免费下载需要署名 credit，除非账户/许可另有说明；API 使用需要可点击的 Coverr 署名；不得将 Coverr 素材用于 AI 训练/数据集，或用于构建竞争的库存/视频服务。
   • 对于 Chai With Jai 工作坊宣传片，默认搜索意图应包括：small business owner、entrepreneur workshop、business planning、whiteboard、team collaboration、laptop work、coffee meeting、Jersey City、AI technology、coding、marketing campaign 和 community event。
   • 优先选择可作为口头论点视觉证据的 Coverr 片段。拒绝通用城市灯光、抽象技术、慢节奏生活方式填充内容，或任何带有可识别品牌/商标的内容，除非使用显然安全。
5. 生成审核产物：
   • 供评审审阅的低分辨率代理或静帧，
   • 音频排名 JSON，
   • 字幕预览，
   • Resolve/FCPXML/EDL 计划。
6. 构建真实交接：
   • 用于最终编辑的 Resolve 分层时间线，
   • 原始修复音频禁用，
   • 干净对话与音乐分离，
   • 图形/字幕/B-roll 位于单独轨道，
   • 时间线审计通过。

制胜 Instagram Reels 循环

当先前的剪辑已经接近完成，且用户表示几乎可以发布时，使用此循环：

1. 保留用户喜欢的画面剪辑。 除非用户要求，否则不要重新编辑主线。尽可能导出或定位不带烧录字幕的画面主线。
2. 根据实际语音时间轴添加字幕。 从用户喜欢的剪辑中提取对话，运行 Whisper 词级转录，并构建简短的烧录短语字幕。仅修正高置信度的领域术语，例如人名、活动标题、日期和明显的 ASR 伪影。
3. 保持字幕文本以口语为先。 不要用主题卡片替换口语字幕。主题卡片可以作为单独的上方轨道保留，但下方字幕轨道必须与说话者所说的内容一致。
4. 验证手机安全静帧。 检查开场、中段、B-roll/白板、CTA 和结尾帧。字幕必须避开说话者的嘴部/下巴以及 Instagram 底部 UI 区域。
5. 验证音频。 目标为 -14 至 -16 LUFS 积分响度，真峰值低于 -1 dBTP，并在语音下方压低音乐。
6. 只有这时才优化 B-roll。 在能解决特定剪辑问题的地方添加 B-roll：跳切覆盖、主张证明、视觉解释、地点/活动背景或情绪重置。

重复使用所需的输出产物

对于每个文件夹剪辑，创建或更新：

• story_plan.md
• edit_decisions.csv 或 .json
• broll_plan.json
• broll_asset_manifest.json
• caption_chunks.txt
• captions.ass 或 Resolve 字幕轨道
• verification_report.json
• Resolve 时间线或交接报告

Editframe 角色

将 Editframe 并行用于动态资产，当用户期望 Resolve 源图层时，不要将其作为主要 NLE。

良好用途：

• 动画品牌片头，
• Netflix 风格/单词高亮字幕资产，
• 下三分之一，
• 波形/标题卡，
• 社交安全图形叠加，
• 快速 HTML/React 审阅代理。

除非用户明确希望获得渲染后的网络视频输出，否则避免将 Editframe 作为源摄像机编辑的唯一交付物。Editframe 渲染可以重新导入 Resolve 作为 V3/V4 图形或片头图层。

交接契约

除非这些产物存在，否则绝不要称任务已完成：

• 媒体清单，
• 故事计划，
• 编辑决策，
• 音频质量审计，
• 字幕产物或烧录审阅，
• 分层 Resolve 时间线或交换文件，
• 时间线审计报告。

实用命令

python3 skills/social-video-folder-autocutter/scripts/create_folder_cut_brief.py \
  /path/to/project-folder --out /path/to/project-folder/output/folder_cut_brief.json

然后使用 davinci-resolve-social-editor 进行 Resolve 构建。