弹幕字幕动画视频生成器

将中文口播文案转化为「堆叠渐隐字幕」风格的配音动画视频，同时产出竖屏（抖音 1080×1920）和横屏（1920×1080）两个版本，外加封面图和 SRT 字幕文件。

何时使用

• 用户提供标题+正文文案，要求「做成弹幕视频」「生成字幕动画」「口播文案转视频」
• 用户说「做一条视频」且文案风格适合认知升级/深度口播类内容
• 用户提到「堆叠渐隐」「关键词高亮」「字幕动画」

四阶段工作流

严格遵守以下四阶段，每阶段完成后向用户确认，再进入下一阶段。

阶段一：拆（AI 语义拆分）

用户提供：标题 + 文案正文（一段或多段 Markdown 文本）。

AI 执行语义拆分：

1. 理解文案结构：识别章节/分段边界（如 --- 分隔线），按章节组织字幕。
2. 语义自然断句：在语义边界处断句，优先保证意群完整、读起来流畅。
3. 密度控制：每条字幕控制在 ≤36 字、≤2 行。超过 36 字的句子在语义边界处拆分为多条。
4. 保留关键修辞：引用（「」）、反问、排比等修辞结构不破坏。

阶段二：验收（用户确认）

拆分完成后，展示验收卡片：

## 📋 验收卡片 —「标题」

| # | 字幕 | 字数 | 行数 | 密度 |
|---|------|------|------|------|
| 01 | 字幕文本 | 25 | 2 | 适中 |
| 02 | 字幕文本 | 13 | 1 | 稀疏 |
...

密度标识：

• 稀疏（1行，≤20字）：节奏快，适合强调句
• 适中（2行，21-36字）：最佳阅读体验
• 偏密（3行，>36字）：应避免

同时展示总览：

| 指标 | 数值 |
|------|------|
| 总条数 | XX 条（+ 标题卡）|
| 平均字数/条 | XX 字 |
| 最长/最短 | XX / XX 字 |
| 预估总时长 | ~X 分 XX 秒 |

用户验收：

• 通过 → 进入阶段三
• 需要调整 → 根据反馈修改拆分（常见：「太密了，拆开」→ 把所有 3 行/偏密字幕拆成 ≤36 字）
• 反复直到用户确认

阶段三：填（补充内容）

用户确认拆分后，AI 补充以下内容并写入 content_.json：

对每条字幕（含标题），补充：

1. 英文翻译（en）：自然流畅的英文翻译
2. 关键词（keywords）：2-3 个中文字词，用于金黄色高亮
3. Pexels 搜索词（pexels_query）：2-4 个英文词，用于搜索背景图
4. 表情包（sticker）：sticker_00.gif ~ sticker_15.gif 轮转分配

格式严格遵循 references/content_format.md 规范。

阶段四：生成（运行脚本）

在用户的项目目录下执行生成脚本。

前置条件：

• 项目目录下存在 scripts/generate_v9.py（已随技能安装）
• Python 依赖已安装：moviepy, Pillow, numpy, requests
• 中文字体可用（macOS: STHeiti Medium.ttc；其他系统需修改脚本中的 FONT_PATH）

执行命令：

cd 
python3 scripts/generate_v9.py --name  --content content_.json

产出文件（位于 output/ 目录）：

• {name}_9x16.mp4 — 竖屏版（抖音 1080×1920）
• {name}_16x9.mp4 — 横屏版（1920×1080）
• {name}_cover_9x16.png — 竖屏封面（1080×1464, 3:4）
• {name}_cover_16x9.png — 横屏封面（1920×1080, 16:9）
• {name}.srt — 字幕文件

生成完成后，使用 deliver_attachments 交付所有产出文件给用户。

视频特性

• 🖼 Pexels 实景背景，57% 暗化遮罩
• 😂 沙雕企鹅 GIF sticker 弹跳动画
• 🔑 关键词金黄色高亮 RGB(255,215,0)
• 🇬🇧 英文翻译：横屏 52px / 竖屏 40px，亮白 (245,245,245)
• 📊 顶部历史字幕堆叠渐隐（最多 4 条）
• 🎬 3 秒开场标题卡 + 脉冲呼吸灯入场动画
• 🎙 配音在剪映中完成（文本朗读或自行录制）

注意事项

• 字幕时长自动计算：字数 × 0.30s + 1.0s，限制在 [2.5s, 7.0s] 区间
• 表情包：通过代理 127.0.0.1:17891 从 ChineseBQB 下载，无代理时可能失败
• 中文字体：macOS 使用 STHeiti Medium.ttc，其他系统需修改脚本
• 生成耗时：64 条字幕约 30 分钟，36 条约 12 分钟
• .workbuddy/ 文件夹：不要删除，存放项目数据

资源文件

• scripts/generate_v9.py — 视频生成主脚本
• references/content_format.md — Content JSON 格式规范
• references/render_params.md — 渲染参数详细参考