视频生产错误日志（所有智能体共享）
> 每次踩坑必须记录，每次生产前必须查阅。
> 新增错误时，写明：问题 → 根因 → 修复 → 关联技能
事故1：17条视频全部报废（2026-07-08）
| 字段 | 内容 |
|---|---|
| 问题 | 配音总时长是HTML时长的1.5-2.3倍，配音没念完画面跳完了 |
| 根因 | 批量生产时完全跳过"每段配音时长 vs 场景窗口"的检查 |
| 修复 | 新增Gate 3音画时长硬闸门，逐段对比配音时长≤场景窗口+0.5s |
事故2：品牌名全部写错（2026-07-08）
| 字段 | 内容 |
|---|---|
| 问题 | 17/17视频HTML里全是"膜世界"（应为"膜世界"） |
| 根因 | 模板里就写错，且质量门禁关卡0没执行 |
| 修复 | 品牌名检查改为"模世界"→FAIL |
事故3：音画不同步（2026-07-16）
| 字段 | 内容 |
|---|---|
| 问题 | 视频22s，配音13.6s，-shortest砍掉后半段，画面无声 |
| 根因 | ①HTML data-duration写死25s不匹配配音 ②GSAP动画没按配音时长调 ③ffmpeg用-shortest砍视频 |
| 修复 | ①先配音→测量时长→再建HTML ②每段配音≤场景窗口 ③配音补静音，不用-shortest |
事故4：画面开头没有声音（2026-07-16）
| 字段 | 内容 |
|---|---|
| 问题 | 视频开头4秒只有画面没有声音，观众以为没声音划走了 |
| 根因 | 场景1（标题）设计为无配音，制作时没有考虑用户体验 |
| 修复 | ①前3秒必须有声音（配音/音效/背景音乐） ②前3秒无声音=FAIL |
视频生产前必查清单（12条）
前置检查
□ 1. 已读错误日志（本文件）—— 确认没有重犯已有错误
□ 2. 质量门禁已配置 —— video-quality-gates 已安装且可运行
□ 3. 模板品牌名正确 —— 检查"膜世界"、"模世界"、"魔世界"（只有膜世界正确）
脚本阶段
□ 4. 前3秒有声音 —— 开头不能是纯静音标题
□ 5. 字数按场景分配 —— 每个场景的字数 ≤ 场景窗口秒数 × 4字/秒
□ 6. 无违禁词 —— 无"免费贴""包换""最好""第一"
配音阶段
□ 7. 先配音，后建HTML —— 先测量配音时长，再根据时长建HTML
□ 8. 逐段对比 —— 每段配音时长 ≤ 对应场景窗口秒数 + 0.5s
□ 9. 总时长匹配 —— 配音总时长 ≤ HTML data-duration
渲染阶段
□ 10. 不用 -shortest —— 视频要完整播放，不能砍
□ 11. 无配音的场景补静音 —— 生成完整音频轨道
□ 12. 质量门禁跑完 —— 7道关卡必须全部通过
关联资源
- 完整版：
~/Desktop/学习池/视频生产错误日志_所有智能体共享.md - 视频四大支柱规范：
~/.agents/skills/video-four-pillars/SKILL.md - 视频配音声线配置：
~/Desktop/学习池/视频配音声线配置.md
