video-editing

# Video Editing Skill — 视频剪辑技能（V3） 适配 **小红书 / 抖音 / 微信视频号** 三大主流平台。一条 **从素材导入 → 口播 → 重组故事 → 平台守门 → 自动丰富 → 渲染 → 三平台导出 → 标题文案** 的端到端流水线，按各平台的算法、比例、时长、审核规则调过参——不只是剪辑工具。 ## V3 完整流水线（一图看懂） ``` 口播音频 + 无声素材 │ ├─→ project_bootstrap.py 原始素材目录 → source inventory / project.md ├─→ edit_brief_plan.py 用户一句话需求 → 本地脚本 runbook / gates ├─→ runtime_preflight.py workflow profile → FFmpeg/Node 命令、编码器、filters / live gate ├─→ interlace_conform.py 交错/telecine 采样 → progressive 工作副本 / 全长 A/B gate ├─→ frame_rate_conform.py 手机/录屏 VFR → 全量 PTS 检测 / CFR 工作副本 / live gate ├─→ black_edge_trim.py 首尾黑场 + 静音覆盖 → CFR 工作副本 / 原片边界 proof + live gate ├─→ program_breaks.py 内部黑场与全音轨静音重叠 → 只读分段候选 / 复核时间点 ├─→ border_crop.py 画面内持续黑边 → 逐时点 cropdetect 证据 / 保守裁切建议 ├─→ motion_center.py 局部像素运动中心 → 只读构图复核时间点 ├─→ loop_fill.py 短片 → 次数/固定时长 hard repeat / 真实接缝 proof + 完整审片 gate ├─→ ping_pong_loop.py 短动作 → 端帧去重正放/倒放 / 折返+循环双 proof / live gate ├─→ clip_assembly.py 多源片段 → 单次画布/CFR/SAR/音频归一 / 全接缝 proof + live gate ├─→ edit_style_profile.py 个人/品牌创意方向、节奏与渲染/文案默认值 → 可移植 profile ├─→ production_authorization.py │ 确切素材/动作/provider/权利依据 → 显式授权 + live gate ├─→ transcribe.py 转写 + 词级时间戳 + 口误标记 ├─→ transcript_silence_qa.py 原始转写 vs 实测静音 → 幻觉疑点供回听 ├─→ transcript_lookup.py 原话检索 / 时间窗口读取 → 少量带源时间码的结果 ├─→ visual_transcript_index.py │ 现有关键帧 + 附近原话 → 带源哈希的 JSON/Markdown 复核索引 ├─→ semantic_transcript_review.py │ 全篇前后文审校包 / 最小补丁验证 / 人工 choices gate ├─→ transcript_review.py 本地同步媒体 HTML 校稿 / CPS 提示 / review.txt 回写 ├─→ takes_pack.py 多 take / Scribe transcript → phrase-level 阅读视图 │ speaker / audio_event 编辑节拍 ├─→ script_alignment.py 已审目标稿 → 多 take 原话候选 / choices / render_config │ 词/段边界 / 透明分数 / 歧义与缺素材 gate ├─→ audio_sync.py 外录音轨自动对齐 / 替换音轨计划 ├─→ multicam_sync.py 多机位 → 参考时间线 / 时钟漂移证据 / 对齐预览 gate ├─→ multicam_switch.py 已同步机位 → 归一化说话者音频 / 自动导播草稿 / 完整审片 gate ├─→ scene_boundaries.py fixed/adaptive 视觉切点 + 逐切点 evidence ├─→ visual_dedupe.py 多来源场景 → 感知哈希重复组 / 保留建议 / review gate ├─→ video_understanding.py 抽样帧 + 可选 YOLO 检测 / tracks / scene_tags ├─→ video_stabilization.py 手持素材 → source-bound 后端计划 / 工作副本 / 全长 A/B gate ├─→ chroma_key.py 绿幕/蓝幕 → composite + matte 代表帧 / 人工 review / 完整渲染 gate ├─→ highlight_picker.py 长视频精华候选 / brief-query 定向找片段 ├─→ audio_boundary_snap.py 已选片段 → 词/句末/静音边界校正 ├─→ shorts_batch.py 精华候选 → per-short render_config / render + QA job sheet ├─→ rough_cut.py ASR 粗剪：去纯口头禅 / 相邻重复句 ├─→ hook_variants.py 前三秒 hook 批量角度 / 推荐排序 / 风险检查 ├─→ rewrite_script.py LLM 重组 5 段式（hook/pain/turn/value/cta） ├─→ content_guard.py 80+ 条平台雷区 lint ├─→ source_receipts.py 事实 claim → URL/截图 source deck + publish gate ├─→ beat_sync.py BGM beat-grid → 可审计剪辑骨架，或吸附已有切点 ├─→ speed_ramp.py impact ranges → source-bound 局部变速计划 / 验证 / apply ├─→ freeze_punch.py impact frame → 定格替换窗口 / punch crop / unchanged audio timeline gate ├─→ auto_enrich.py B-roll / 章节卡 / 贴纸 / 强调点 / BGM 卡点 / imagegen 提示词 │ └─→ Codex imagegen gpt-image-2 自动生图（抽象概念配图） ├─→ audio_cue_sheet.py BGM / SFX 音频设计清单 / 生成审批 gate ├─→ audio_cue_mix.py cue sheet + 最终旁白 → 本地/程序化 SFX 单轨 / 1× review gate ├─→ storyboard_plan.py 分镜 shot cards / 生成路由 / 连续性锚点 ├─→ storyboard_animatic.py 每镜静帧 + 可选旁白 → timed MP4 / 1× review / live gate ├─→ photo_montage.py 有序照片 → 轻微缩放/叠化/可选配乐 MP4 + 源绑定收据 ├─→ sequence_handoff.py 相邻镜头 receive/handoff / edit type / 轴线方向 / live gate ├─→ reference_story_formula.py │ 参考片时间码情绪机制 → 目标分镜 content anchors / live gate ├─→ provider_capability.py provider/surface/model 能力合同 / 核验日期 / live gate ├─→ video_prompt_pack.py Dreamina/Veo/LTX/Wan/Sora 提示词包 / 审批 + capability gate ├─→ reference_frame_preflight.py │ 首帧/style key 尺寸/方向/透明背景/画幅 gate ├─→ generation_task_log.py 异步生成任务台账 / submit_id / 下载 gate ├─→ generated_clip_review.py 生成片段 contact sheet / 常识物理 / 连续性 / 重生 gate ├─→ generation_chain_handoff.py │ 已审上一镜末帧 → 下一镜精确首帧 / 顺序生成 live gate ├─→ generated_motion_window.py │ 短生成片 0.25s freeze → active intervals / 人工裁切 / live gate ├─→ scoped_video_edit_review.py │ 原片 vs 局部 AI 编辑结果 / change-only + preserve invariants / A-B gate ├─→ generated_sequence_review.py │ 已审片段相邻尾帧/首帧/预览 / 跨镜头连续性 gate ├─→ final_audio_storyboard.py │ 锁定视觉 EDL + 原 storyboard → 最终声音分镜 / voice ledger / live gate ├─→ narration_loudness_qa.py 最终独立旁白 + 精确短语范围 → LUFS/spread/dBTP/LRA live gate ├─→ caption_speech_qa.py subtitle_pack + 独立人声轨 → 孤立/错位/越界字幕 live gate ├─→ subtitle_glyph_qa.py subtitle_pack + 显式字体 → 逐字符 cmap 覆盖 / 缺字 live gate ├─→ generation_lessons.py 已审片段 → provider/model scoped 提示词经验库 ├─→ storyboard_assets.py 素材任务清单 / ready 预检 / paid 额度提醒 │ 可选 media_library.py recommend 排名 B-roll 候选 ├─→ stock_material_plan.py 远程 stock 搜索规划 │ Pexels / Pixabay / Coverr 查询计划 + 素材登记提示 ├─→ screen_focus.py 录屏点击/热点 → 自动聚焦计划 ├─→ pip_overlay.py 录屏 + facecam → PIP 小窗计划 ├─→ color_grade.py bounded 调色 plan / render_final 单次编码接入 ├─→ lut_grade.py 外部 .cube LUT 校验 / SHA-256 绑定 / 单次编码接入 ├─→ jump_cut.py 自适应去停顿 + 20% 删除预算 + 可审计 cut list + 30ms 防爆音 fade ├─→ multimodal_dead_air.py 静音 AND 静帧 → source-bound 保守删段 / 单次编码 / live gate ├─→ audio_transition.py 显式 J-cut/L-cut → source handle / hash / 1× 试听 gate ├─→ edit_revision.py 文本剪辑 artifact → source-bound 审批 / 成组 apply / undo / redo ├─→ edit_recipe.py 已审 render_config → typed-slot 可移植配方 / 新素材绑定回放 ├─→ edit_preflight.py render_config/enrich_plan/cut list 渲染前预检 gate ├─→ platform_safe_area_qa.py 字幕/PIP/CTA/marker → 平台 UI 安全区 gate + SVG guide ├─→ subtitle_style_preview.py 真实源帧 → 最终 ASS 预设对比 JPEG / 选择 / live gate ├─→ render_final.py 单次编码渲染（可选口播降噪 + enrich_plan/focus_events/pip_overlays + Heavy 字幕 + 响度规范化 + BGM ducking） │ 可选 --versioned-output 防覆盖旧成片 ├─→ subtitle_render_review.py 最终 MP4 + subtitle_pack → 高风险字幕 1× clips / 原尺寸帧 / 完整审片 live gate ├─→ render_qa.py 渲染后黑屏/静帧/静音/尺寸质检 + review packet ├─→ stream_coverage_qa.py 最终 MP4 → decoded 音视频首尾 PTS / 帧数 / 容器覆盖 live gate ├─→ encode_quality_qa.py 同时间线 master vs 重编码件 → SSIM/PSNR / 最差帧 / live gate ├─→ audio_channel_qa.py 成片声道活动/起始/平衡/相位/mono fold-down live gate ├─→ audio_dropout_qa.py 最终人声/混音短促近静音候选 / 1× WAV 听审 live gate ├─→ flash_safety_qa.py 成片亮度/饱和红 flash → 1s/5s 风险窗口 / live gate ├─→ temporal_artifact_qa.py 单帧/少数帧 return-to-state spike → 三帧证据 / 人工 audit / live gate ├─→ shot_color_qa.py 成片镜头亮度/对比/色度/饱和度/broadcast-range + 切点跳变 gate ├─→ retention_rhythm_qa.py 成片 hook 活动 / 长镜头 / 注意力空窗 / 节奏 gate ├─→ reference_edit_rhythm.py 参考片 vs 成片 hard-cut 结构 / contact sheets / live gate ├─→ speech_continuity_qa.py 成片二次 ASR → 切点复读 / 近重复 take / 句内口吃 gate ├─→ lip_sync_review.py 最终 master → 1×/0.25× 口型证据 / 人工 audit / live gate ├─→ review_proxy.py 低码率完整审片 MP4 / 可见时间码 / faststart ├─→ timeline_view.py 源素材删除段 / 成片输出切点 filmstrip + waveform 复盘图 ├─→ edit_compare.py 原片连续时钟 vs 最终像素 / 删段置黑 / 映射验证 ├─→ subtitle_pack.py SRT/VTT/ASS/JSON 字幕交付包（speed/offset 对齐） ├─→ soft_subtitles.py 已审 SRT → MP4 可开关字幕轨 / 无损复制音视频 / live 收据 ├─→ chapter_mux.py 已审章节 JSON → MP4 可跳转章节 / 无损复制音视频 / live 收据 ├─→ metadata_scrub.py 分享前清除 MP4 容器标签/章节/额外轨，保留音视频流 ├─→ hls_vod.py 已审 SDR MP4 → 单码率 HLS 点播目录 / 分片+收据 live verify ├─→ subtitle_readability_qa.py │ 最终字幕 CPS / 时长 / 行长 / 重叠 / 媒体越界 gate ├─→ import_capcut_subtitles.py │ 剪映/CapCut 自动字幕 → transcript / gap cut list ├─→ srt_edit_plan.py SRT + keep/drop 编辑指令 → render_config / cut list ├─→ project_resume.py 续跑上下文包 / agent handoff / 可选 CLAUDE.md ├─→ review_dashboard.py 静态 HTML/JSON 人工复核面板 / gate review queue ├─→ export_edl.py render_config / cut list → EDL + manifest ├─→ export_fcpxml.py render_config / cut list → FCPXML + manifest ├─→ export_otio.py render_config / cut list → OTIO + manifest ├─→ framing_preview.py master → 各平台 cover/contain/blur 真实帧 / 选择 / live gate ├─→ multi_export.py 已审画幅策略 → 小红书 3:4 / 抖音 9:16 / 视频号 ≤60s ├─→ hdr_sdr.py PQ/HLG HDR → source-bound Rec.709 SDR / 完整解码 gate ├─→ video_enhancement.py Lanczos 放大 + 可选运动补帧 / 全长 A-B + 带声复核 gate ├─→ delivery_encode.py source-bound 两遍 H.264/AAC / 硬大小上限 / 完整解码 gate ├─→ gif_preview.py 视频短摘录 → 调色板 GIF / 源绑定收据 / 完整解码 ├─→ logo_overlay.py 已审 MP4 + PNG Logo → 四角叠加 / 源绑定收据 / 完整解码 ├─→ generate_caption.py 标题 + 200-500 字正文 + 3-6 tags + 发布时段 ├─→ cover_variants.py 2-4 套封面 / feed-size 预览 / 最终选择 gate ├─→ approval_receipt.py 已复核交付件 → SHA-256 收据 / stale approval gate └─→ publish_package.py 平台视频/封面/字幕/章节/文案上传包 + gate 状态 ``` **每天做一条短视频的完整提示词模板**：[docs/prompts/15-xhs-daily-tech-video.md](docs/prompts/15-xhs-daily-tech-video.md)（推荐入口）。 生图优先使用 Codex 内置 `image_gen` 工具，即 OpenAI GPT Image 2（`gpt-image-2`）。 ## V3 新增脚本一览（按调用顺序） | 脚本 | 职责 | 关键 CLI | |---|---|---| | `project_bootstrap.py` | 原始素材目录 → 项目结构 / source inventory / project.md | `--source raw_dir` `--project-dir work/day61` `--mode copy|hardlink` `--strict` | | `runtime_preflight.py` | workflow profile → 本机 FFmpeg/Node 命令、编码器、filters、环境漂移 live gate | `list-profiles` / `analyze --profile ... --output --strict` / `verify --report --strict` | | `edit_brief_plan.py` | 自然语言剪辑需求 → 本地脚本 runbook / 命令 / manifest gate | `--brief` `--brief-file` `--source-media` `--platform` `--markdown` `--strict` | | `interlace_conform.py` | 交错/telecine 多段检测 → bwdif/yadif progressive 工作副本、全长 A/B 人工确认与 live gate | `analyze` / `plan --mode frame|field --parity` / `apply` / `confirm` / `verify --strict` | | `frame_rate_conform.py` | 手机/录屏 VFR → decoded PTS cadence、精确 CFR 工作副本、帧数/音画起止与 live gate | `plan <source> --fps 30 --delivery` / `apply <plan>` / `verify <plan> --strict` | | `black_edge_trim.py` | 首尾 blackdetect + 静音覆盖 → source-bound CFR working copy、原片边界 proof 与人工 live gate | `plan --delivery --edge-proof` / `apply` / `confirm` / `verify --strict` | | `program_breaks.py` | 内部黑场与全部音轨静音的重叠 → 源绑定分段候选 JSON/Markdown；不自动切片 | `analyze <video> --output <report.json>` / `verify <report.json>` | | `loop_fill.py` | progressive CFR 短素材 → 按次数/目标时长重复、首个真实接缝 1× proof、完整审片与 live gate | `plan --times|--duration --delivery --seam-proof` / `apply` / `confirm` / `verify --strict` | | `ping_pong_loop.py` | progressive CFR 短动作 → 端帧去重的正放/倒放周期、折返/循环双 proof、缓存上限与 live gate | `plan --start --end --cycles|--duration --delivery --turnaround-proof --loop-seam-proof` / `apply` / `confirm` / `verify --strict` | | `clip_assembly.py` | 多源视频 → 单次画布/CFR/SAR/时间戳/音频归一、全接缝 1× proof 与 live gate | `plan <clips...> --delivery --boundary-proof` / `apply` / `confirm` / `verify --strict` | | `podcast_audiogram.py` | 纯音频摘录 + 静帧封面 + 相对摘录时间的 SRT → 带辅助波形的竖版 MP4 与源绑定收据 | `render <audio> <cover> <captions.srt> --start --duration --output --receipt` / `verify <receipt>` | | `gif_preview.py` | 视频短摘录 → 无声、调色板优化 GIF 和源绑定收据 | `render <video> --start --duration --output --receipt` / `verify <receipt>` | | `photo_montage.py` | 2–100 张照片 → 固定节奏、轻微缩放、叠化和可选配乐的 H.264 MP4；核验源照片、音乐与成片 | `render <photos...> --output --receipt [--music]` / `verify <receipt>` | | `logo_overlay.py` | 已审 MP4 + PNG Logo → 指定四角/宽度/透明度叠加，保留音轨并现场验证 | `render <video> <logo.png> --corner --width-fraction --opacity --margin --output --receipt` / `verify <receipt>` | | `frame_grid.py` | 秒级时间码定位最近解码帧；带可见格号的精确帧网格或单帧 PNG，附帧号/PTS 与源文件收据 | `locate <video> --at-seconds` / `grid <video> --start-frame --step --count --output --receipt` / `frame <video> --start-frame --output --receipt` / `verify <receipt>` | | `border_crop.py` | 对画面内上下/左右黑边逐时点采样；仅在全片及三段一致时建议裁切 | `analyze <video> --output <report.json>` / `verify <report.json>` | | `motion_center.py` | 无检测模型时逐时点标出局部运动中心；大范围变化不给焦点，供人工构图复核 | `analyze <video> --output <report.json>` / `verify <report.json>` | | `edit_style_profile.py` | 个人/品牌创意方向、剪辑节奏、渲染/文案默认值 → 无路径可移植 profile / digest 验证 / defaults-only 合并 | `template` / `create --spec` / `verify --profile --strict` / `apply --config --receipt` | | `production_authorization.py` | 外部上传、侵入性剪辑、付费生成、声音克隆、真人/IP 和发布 → source-bound 授权 gate | `prepare --scope --response-template` / `audit --request --response --strict` / `verify --report --strict` | | `transcript_review.py` | transcript → 文本或本地同步媒体 HTML 校稿 → reviewed transcript | `export` / `html --video --max-cps` / `apply --review --output` | | `transcript_lookup.py` | 只读原话检索或时间窗口读取，返回有界 JSON、源段 ID/时间码与 transcript SHA-256 | `<transcript.json> search <phrase> --limit` / `<transcript.json> span --start --end` | | `visual_transcript_index.py` | 现有关键帧与附近转写段配对，生成可核验的 JSON/Markdown 索引 | `build <keyframes.json> <transcript.json> --output --markdown` / `verify <index.json>` | | `tutorial_companion.py` | 已审教程章节 + 最终视频 + 时间码转写 → 每章截图与原话的 Markdown 伴读草稿、源绑定收据 | `build <video> <chapters.json> <transcript.json> --title --output [--at ch01=秒]` / `verify <bundle>/receipt.json` | | `semantic_transcript_review.py` | transcript → 前后文审校包 / 最小补丁审计 / 人工 choices / reviewed transcript | `prepare` / `audit --strict` / `apply --choices` | | `_internal_text_guard.py` | 拦截内部 token 进画面 | 内部模块，render_final 自动调 | | `content_guard.py` | 平台雷区 lint | `--script` `--title` `--caption` `--strict` | | `source_receipts.py` | 事实 claim → URL/截图 proof deck、Markdown/HTML 和发布 gate | `--claims source_claims.json` `--html` `--require-primary-source` `--strict` | | `takes_pack.py` | 多 take / 顶层 Scribe words → phrase-level Markdown/JSON，保留 speaker/audio events | `--transcript take1=...` `--transcripts-dir` `--json` `--break-gap` | | `script_alignment.py` | 已审目标稿 → 多 take 词/段边界候选、人工 choices、render_config 和 gate | `--target-script` `--transcript label=...` `--media label=...` `--choices` `--render-config` `--strict` | | `audio_sync.py` | scratch audio + 外录音轨 → offset / 替换音轨命令 / gate | `--reference-media` `--external-audio` `--replace-output` `--apply` `--strict` | | `multicam_sync.py` | 多机位 → offset/coverage/音轨选择/pairwise/可选时钟漂移/对齐预览 gate | `--reference-media` `--angle` `--manual-offset` `--measure-clock-drift` `--preview-output` `--apply-preview` `--strict` | | `multicam_switch.py` | ready 同步计划 + speaker-mapped 机位音轨 → source-bound 自动导播草稿、完整解码与人工 live gate | `plan --sync-plan --speaker --program-audio --delivery` / `apply` / `confirm` / `verify --strict` | | `rough_cut.py` | transcript 粗剪：去口头禅/重复句 | `--transcript` `--cut-list` / `--input` `--output` | | `scene_boundaries.py` | FFmpeg fixed/adaptive scene score → 场景边界 + cut evidence | `--method adaptive` `--adaptive-threshold` `--min-scene-score` `--min-scene-duration` |