Video Generator Skill v2.0.0

自动化视频生成完整工作流程，将有序图片序列和对应旁白合成为同步的MP4视频。支持数据可视化图表动画、端到端全自动生成、统一异常处理。

⚠️ 关键原则（必读）

原则1：音画必须精确匹配

每张图片的旁白必须精确描述该图片的视觉内容，不能讲A图内容却配B图。

原则2：所有片段必须有相同的流结构

concat copy 模式要求所有输入文件有完全相同的流结构（都有video+audio，或都有video-only）。标题页也必须生成带静音AAC轨道的MP4。

原则3：图片完整显示，不裁切

使用 pad 而非 crop，等比缩放图片完整显示，黑边填充剩余区域。

功能概述

1. 热点获取 - 自动从多个平台获取当前热门AI话题
2. 图片准备 - 接收用户上传的有序图片序列
3. 旁白生成 - 为每张图片撰写精确匹配其视觉内容的旁白文本
4. 音频生成 - 使用 edge-tts 生成高质量旁白音频
5. 视频合成 - 使用 FFmpeg 将图片和音频合成为标准MP4视频
6. 标题页生成 - 使用PIL生成中文标题页图片（避免FFmpeg中文乱码）
7. 数据可视化 - 将 Excel/CSV 数据生成图表动画视频（v2.0新增）
8. 端到端生成 - 主题→脚本→分镜→图片→音频→视频全自动（v2.0新增）
9. 异常处理 - 统一错误处理、重试机制、临时文件清理（v2.0新增）

何时使用此技能

当用户输入包含以下意图时，使用此技能：

• "帮我生成一个视频" / "制作教学视频"
• "把这些图片做成视频"
• "生成视频，图片是..."
• "热点视频" / "帮我找个热点话题做视频"
• video generator / video制作
• "检查" / "测试" / "bug" / "有问题" / "报错了" → 执行诊断流程
• "优化" / "改进" / "提升质量" → 执行视频质量优化流程
• "数据可视化" / "Excel图表" / "生成图表视频" → 使用 generate_chart_video.py
• "全自动生成" / "从主题开始" → 使用 generate_full_video.py

【关键】自检与诊断流程

当用户提到"检查"、"测试"、"bug"、"报错"、"有问题"等关键词时，必须执行以下诊断流程！

诊断步骤

1. 环境检查：运行 ffmpeg -version、python -c "import edge_tts" 等
2. 脚本语法检查：对所有 .py 脚本运行 python -m py_compile
3. 读取错误日志：读取 ERROR_LOG.md，检查是否有未修复的错误
4. 生成诊断报告：输出 ✅/❌ 的具体结果
5. 自动修复（如可能）：按 ERROR_LOG.md 记录的方法自动修复

常见诊断场景

使用流程

步骤0：获取热点话题（可选）

在生成视频前，先帮助用户找到当前热门话题。

步骤1：收集需求 + 撰写旁白脚本

明确信息：

• 图片文件路径列表
• 旁白文本（必须精确匹配图片内容！）
• 语音偏好（默认：zh-CN-XiaoxiaoNeural）
• 输出路径

⚠️ 旁白撰写规范： 旁白必须严格描述当前图片的视觉内容。

步骤2：生成音频

使用 edge-tts 为每段旁白生成MP3音频。

步骤3：生成标题页图片（PIL）

⚠️ 不要用FFmpeg drawtext 渲染中文！ 用PIL生成标题页图片。

步骤4：合成视频（黑屏转场方案）

推荐方案：每段图片+音频直接合成完整MP4，再拼接

此方案避免音频丢失问题。支持黑屏转场（0.3-0.5秒）。

步骤5：验证输出

检查生成的视频文件：

• ✅ 有 video 流（codec=h264）
• ✅ 有 audio 流（codec=aac）
• ✅ 音频时长 ≈ 视频时长

脚本选择指南

常见问题 FAQ

Q1: 报错 "FFmpeg not found" 怎么办？

A: 运行：python scripts/install_ffmpeg.py --check 诊断环境。

Q2: 生成的视频没有声音？

A: 检查：edge-tts 是否安装、audio/ 目录是否有音频文件。

Q3: 如何诊断 FFmpeg 环境？

A: 运行：python scripts/install_ffmpeg.py --check

Q4: 如何永久添加 FFmpeg 到 PATH？

A: 运行：python scripts/install_ffmpeg.py --add-to-path

Q5: 如何生成数据可视化视频？

A: 运行：python scripts/generate_chart_video.py --input data.xlsx --chart bar

Q6: 如何全自动生成视频（从主题开始）？

A: 运行：python scripts/generate_full_video.py --topic "AI工作流" --num-segments 5

数据可视化视频生成（generate_chart_video.py）v1.0

将 Excel / CSV 数据自动生成图表动画视频。

依赖安装

pip install pandas matplotlib openpyxl

使用方式

# 柱状图
python scripts/generate_chart_video.py --input data.xlsx --chart bar --x-col 产品名 --y-col 销量 --output output/bar.mp4

# 折线图
python scripts/generate_chart_video.py --input data.csv --chart line --x-col 日期 --y-col 销售额 --output output/line.mp4

# 饼图
python scripts/generate_chart_video.py --input data.xlsx --chart pie --label-col 渠道 --value-col 占比 --output output/pie.mp4

支持的图表类型

端到端视频生成（generate_full_video.py）v1.1

全自动工作流：主题 → 脚本 → 分镜 → 图片 → 音频 → 视频。

使用方式

# 模式A：全自动（--topic）
python scripts/generate_full_video.py --topic "AI自动化工作流" --num-segments 5 --output output/ai_video.mp4

# 模式B：已有图片+音频，直接合成
python scripts/generate_full_video.py --images-dir images --audio-dir audio --output output/my_video.mp4

参数说明

异常处理增强（v2.0）

video-generator v2.0 引入了统一异常处理架构。

架构概览

scripts/
├── error_handler.py        ← 统一异常处理模块（所有脚本共用）
├── generate_video.py      ← 已接入全局异常处理
├── generate_full_video.py ← 已接入全局异常处理
└── generate_chart_video.py ← 已接入全局异常处理

error_handler.py 功能清单

全局异常处理

每个脚本的入口都包裹了全局 try/except，确保任何未捕获的异常都会：

1. 打印用户友好的错误报告（含排查步骤）
2. 将完整 traceback 写入 output/error.log
3. 以正确退出码退出

更新日志

v2.0.0 (2026-06-26)

• ✅ 新增 error_handler.py 统一异常处理模块
• ✅ 所有脚本接入全局异常处理（未捕获异常 → 友好报告 + 日志）
• ✅ 新增重试机制（网络请求自动重试 3 次，指数退避）
• ✅ 新增临时文件自动清理（TempFileCleaner context manager）
• ✅ 新增输入校验（validate_file_exists() / validate_ffmpeg() 等）
• ✅ 错误码系统化（20+ 种错误码，含中文排查建议）
• ✅ 日志增强（所有异常写入 output/error.log，含 traceback）
• ✅ install_ffmpeg.py 升级至 v2.0（--check / --add-to-path / --force）
• ✅ 新增触发词：检查、测试、bug（触发诊断流程）

v1.8.0 (2026-06-25)

• ✅ 新增数据可视化视频生成（generate_chart_video.py）
• ✅ 支持 4 种图表类型：柱状图、折线图、饼图、条形竞赛图
• ✅ 支持 Excel / CSV 数据读取
• ✅ 支持旁白自动生成（edge-tts）
• ✅ 新增触发词：短视频制作、抖音视频、TikTok视频、数据可视化视频

v1.7.0 (2026-06-25)

• ✅ 修复 compose_video() 视频合成失败
• ✅ 新增 --ffmpeg-path 参数
• ✅ 转场优化：trans_duration=0 时结尾不加黑屏转场

v1.6.0 (2026-06-25)

• ✅ 修复最后图片显示不全bug
• ✅ 完整错误码系统（ERR_XXX）
• ✅ 自动检测 FFmpeg 路径（跨平台）

v1.5.0 (2026-06-24)

• ✅ 转场效果改用黑屏帧方案

v1.0.0 (2026-06-21)

• 初始版本

技能维护者： WorkBuddy AI
最后更新： 2026-06-26