DabaoAI-JLP 纪录片全自动智能剪辑工厂

中文 WebUI：素材文件夹 -> 来源锚定文案 -> 克隆配音 -> 无重复剪辑 -> 字幕/BGM/封面/发布信息。

一键启动

双击项目根目录：

DabaoAI一键启动.bat

默认打开：

http://127.0.0.1:7861

7860 端口已让给其他本机项目，本项目默认使用 7861。API Key 默认从 .env 读取；通过 WebUI 保存的密钥会加密写入 config/secrets.bin，不会写入任务快照、日志或前端文件。

当前主流程

当前有效管线是 anchored_pipeline.py，旧版 bbc_mp4_pipeline.py 和 scene_matcher.py 已从项目清理。

核心链路：

1. 检测素材文件夹中的 MP4/MKV 和 SRT/ASS 字幕。
2. 将字幕分块为可追溯的来源片段。
3. DeepSeek 生成带来源锚点的中文口播文案。
4. 百炼或 GPT-SoVITS 按句配音，并复用命中文本哈希的缓存。
5. 全局分配原片区间，避免画面重复。
6. FFmpeg 并发裁切、拼接、混音。
7. 后处理字幕、BGM、封面和发布信息。

目标成片时长是软目标。系统不会靠插入长静音、强行变速或拉伸配音来凑时长，最终长度以真实配音、画面可用区间和片头片尾缓冲为准。

主要文件

app.py                         FastAPI 服务、配置接口、任务接口、WebSocket
backend/jobs.py                一键成片/文案生成状态机与子进程调度
backend/schemas.py             WebUI 参数模型
backend/media.py               素材、字幕、分辨率和时长检测
backend/config_store.py        API Key 加密存储
backend/postprocess.py         字幕/BGM/封面/发布信息后处理
backend/text_utils.py          中文数字、字幕文本清洗
anchored_pipeline.py           来源锚定剪辑主内核
gpt_sovits_batch.py            本地 GPT-SoVITS 批量配音
launch_dabaoai.py              Python 启动入口
frontend/dist/                 已构建 WebUI 静态文件
runtime/start_webui_background.bat  后台启动脚本

输入素材

素材文件夹至少需要：

素材文件夹/
├── 原始纪录片.mp4 或 .mkv
└── 字幕.srt 或 .ass

可以额外放置手写解说文案。没有文案时，WebUI 可调用 AI 生成来源锚定文案。

输出发布包

★ 成片.mp4
★ 字幕.srt
配音稿.txt
★ 匹配报告.json
★ 发布信息.txt
★ 发布信息.json
★ 封面_3x4.jpg / ★ 封面_9x16.jpg / ★ 封面_4x3.jpg / ★ 封面_16x9.jpg
★ BGM授权信息.json

命令行调试

python -m compileall anchored_pipeline.py backend app.py gpt_sovits_batch.py launch_dabaoai.py
python anchored_pipeline.py "E:\素材文件夹" --target-seconds 300 --script-only

本地 GPT-SoVITS 示例：

python anchored_pipeline.py "E:\素材文件夹" --target-seconds 300 ^
  --tts-backend gpt-sovits ^
  --gpt-sovits "D:\GPT-SoVITS" ^
  --reference "D:\参考音频.wav" ^
  --prompt-text "参考音频逐字文本"

清理策略

仓库只保留源码、配置模板、前端构建产物和必要工具。以下内容按需生成，不提交：

• frontend/node_modules/
• runtime/jobs/
• runtime/logs/
• runtime/*_test*/
• _anchored_tts/
• _anchored_clips/
• _clips/
• _frames/
• _gaps/
• github_releases/
• Python/TypeScript 编译缓存

.env、config/secrets.bin、config/.secret.key 属于本机私密文件，已加入 .gitignore。

依赖

• Python 3.9+
• Node.js（仅重新构建前端时需要）
• FFmpeg + FFprobe（项目保留 tools/ffmpeg/bin/ffmpeg.exe 与 ffprobe.exe）
• DeepSeek API Key
• DashScope/百炼 API Key 或本地 GPT-SoVITS
• 可选：SiliconFlow、Seedream API Key

更完整的工作流、WebUI 设计和待优化点见 READE.md 与 DabaoAI_全工作流程_READE.md。