Douyin Film Recap — Development skill for Claude Code

Douyin Film Recap

把一部电影或一集剧，变成有证据、可修改、能交付的中文影视解说。

`douyin-film-recap` 是一个开源 Agent Skill 与本地制作流水线，面向 Codex、Claude Code、Cursor 等 Agent 环境。它从字幕、镜头和原片证据出发，完成故事理解、高光召回、解说方案、可编辑分镜、旁白、字幕、竖屏渲染和质量检查。

它追求的不是把剧情摘要铺满画面，而是让旁白、原声、动作、表演和停顿各自承担合适的任务。

   

它能做什么

阶段	能力	主要产物
理解素材	字幕 / ASR、镜头索引、人物、事件、因果、揭示顺序	Transcript、Scene Index、Story Graph
找到戏眼	召回冲突、动作、台词、表演、情绪、反转、喜剧和关系变化	高光候选与保留理由
设计讲法	主线、钩子、Beat、剧透策略、旁白与原声分工	Recap Plan
编译分镜	为每段旁白绑定真实镜头，为原声保留完整动作与句界	Storyboard、可读脚本
生成成片	分段 TTS、竖屏适配、原声底音、中文字幕、FFmpeg 渲染	MP4、SRT、预览
验证交付	来源、时间、帧率、编码、字幕、实际消费镜头和视听证据	EDL、QC、交付报告

可以只运行到任意阶段。找高光不必生成配音，只要方案不必渲染成片。

flowchart LR
    A[影片 / 剧集 / 字幕] --> B[镜头与对白索引]
    B --> C[人物 · 事件 · 因果]
    C --> D[多类型高光]
    D --> E[主线与 Beat]
    E --> F[可编辑 Storyboard]
    F --> G[TTS · 原声 · 字幕]
    G --> H[竖屏成片]
    H --> I[EDL · QC · 交付报告]

为什么值得用

1. 先理解故事，再动剪刀

系统分开记录源素材时间、故事发生顺序、原片揭示顺序和成片时间。人物身份、关系、关键因果和钩子都必须能回到素材证据，减少悬疑片提前泄底、群像人物混淆和“旁白自己编动机”。

2. 高光不只是音量峰值

它会寻找动作和冲突，也会寻找演员表演、反应、沉默、喜剧节奏、人物选择、关系变化与道德代价。每个候选都保留上下文、最小完整边界、剧透风险和取舍理由。

3. 原片负责出刀，旁白负责连接

旁白压缩背景、跳时和重复过程；原片保留无法被复述替代的台词、动作、停顿与情绪。普通配画也必须来自已分析镜头，不能在宽泛时间范围里“猜一个画面”。

4. 能恢复，也能让人接手

流水线有阶段缓存和输入指纹。改字幕会让相关下游失效，改一段旁白只重做受影响内容，人工修改过的 Storyboard 可以继续使用。`edit_decision_list.json` 记录最终真正消费的源片范围。

5. 不把能播放当成已经做好

质量状态分为 `PASSED`、`DEGRADED`、`BLOCKED`。文件存在、FFmpeg 返回 0 或模型说“看起来不错”，都不能代替画面与声音检查。没有独立视听证据时，成片不会被标成完整通过。

5 分钟开始

1. 安装

git clone https://github.com/dengxianghua888-ops/douyin-film-recap.git
cd douyin-film-recap

python -m venv .venv
source .venv/bin/activate       # Windows: .venv\Scripts\activate
pip install -e ".[all]"

系统还需要 FFmpeg / ffprobe。烧