project-promo-video

从项目仓库地址出发，一键生成项目宣传视频（含配音 + 字幕）。

全流程：分析项目 → 分镜提示词 → 口播旁白（用户确认）→ 配音驱动分镜时长 → 视频 → 成片。

快速开始

# 0. 前置：安装 FFmpeg、Python3，pip install requests

# 1. 分析项目 + 生成分镜/口播（Agent 完成，产出「分镜.md」）
#    ⚠️ 文案须用户确认后再继续

# 2. 配音驱动分镜时长（先配音锁定时长 → 生成视频 → 组装）
export SPEECH_API_KEY="语音Key"
export ARK_API_KEY="ark-xxx"

# 2a. 先 TTS 配音，锁定每句时长（产出 voice_N.mp3 + timing.json）
python scripts/add_voice_subtitle.py --storyboard 分镜.md --video 占位.mp4 --skip-subtitle

# 2b. 生成视频（Seedance mini/480p，t2v 或 i2v，时长按配音取 ceil）
python scripts/generate_video.py --storyboard 分镜.md --mode t2v --output 完整视频.mp4

# 2c. 组装：复用配音(锁定时长) + 语音驱动字幕（0.5s 停顿，不取整）
python scripts/add_voice_subtitle.py --storyboard 分镜.md --video 完整视频.mp4 \
    --reuse-voice --pause 0.5 --output 完整视频_配音字幕.mp4

配音驱动分镜时长：分镜时长 = 实测配音时长 + 段间停顿 0.5s，不取整、不硬凑 30 秒，总时长随配音自然变化。
有分段片段时加 --video-segments <目录>，脚本会自动按配音时长 trim 到精确小数。

需要的两个 API Key

两个 Key 不可混用。语音合成需先开通「语音合成大模型（Seed-TTS 2.0）」。

分镜文件格式

### 分镜 1 · 开场钩子（痛点）
**画面**：一句话画面说明。

<即梦/Seedance 提示词，结尾写 “9:16 竖屏，5 秒。”>

## 二、口播旁白文案（对应 N 个分镜）

| 分镜 | 旁白 | 约时长 |
|------|------|--------|
| 1 | 想做短视频，却总卡在第一步？ | 5 秒 |

目录结构

├── SKILL.md              # 技能说明（六阶段流程）
├── workflow.md           # 详细步骤 + 范例 + 错误处理
├── bind.md               # 资源限制与降级策略
├── dependencies.yaml     # 依赖声明
└── scripts/
    ├── generate_video.py        # 分镜 → 视频（Seedance）
    └── add_voice_subtitle.py    # 配音(Seed-TTS) + 字幕(ASS)

依赖服务

• Seedance（doubao-seedance-2-0-mini-260615）：火山方舟视频生成模型
• Seed-TTS 2.0：火山语音合成模型
• FFmpeg：拼接、混音、字幕烧录