القائمة
读取 project.yaml，将排行榜图片和音频合成为最终 MP4 视频。当所有选手的图片和音频均已就绪、或用户要求渲染/导出/完成视频时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
使用 edge-tts（免费）、OpenAI TTS 或 Fish Audio TTS 将旁白文案转换为音频文件。当片段缺少 audio 字段、用户要求生成配音、或需要将脚本合成语音时使用。
制作"从夯到拉"排行榜锐评视频。当用户想制作排行榜锐评视频、给事物打分排名、或从话题生成带动画的排行榜 MP4 时使用。负责协调 search-images、generate-tts 和 assemble_tierlist 脚本。
使用 DuckDuckGo 搜索并下载视频幻灯片所需的图片素材（无需 API Key）。当视频项目缺少 image 字段、某个片段没有图片、或用户要求根据关键词搜图时使用。
| name | assemble-video |
| description | 读取 project.yaml，将排行榜图片和音频合成为最终 MP4 视频。当所有选手的图片和音频均已就绪、或用户要求渲染/导出/完成视频时使用。 |
读取 project.yaml（type: "tierlist"），生成"从夯到拉"排行榜动画视频。
python skills/assemble-video/scripts/assemble_tierlist.py \
--project projects/myvideo/project.yaml \
--output projects/myvideo/output/video.mp4 \
[--config config.yaml]
标准输出（JSON）：
{"path": "projects/myvideo/output/video.mp4", "duration_seconds": 245.7}
project.yaml 中：
type: "tierlist"contestant 均有 image、audio、tier 字段intro 和 outro 均有 audio 字段若有字段缺失，请先运行 search-images 和 generate-tts 补全。
排行榜背景图（五档）：skills/assemble-video/assets/tierlist_bg.png
| 错误信息 | 原因 | 修复方法 |
|---|---|---|
ffmpeg not found / FileNotFoundError: ffmpeg | 系统未安装 ffmpeg | macOS: brew install ffmpeg；Ubuntu: sudo apt install ffmpeg |
ModuleNotFoundError: No module named 'moviepy' | Python 依赖未安装 | 在项目根目录执行 uv sync（或 pip install moviepy pillow numpy） |
FileNotFoundError: [image path] | project.yaml 中的图片路径不存在 | 确认 image 字段路径正确，或先运行 search-images 补全 |
FileNotFoundError: [audio path] | project.yaml 中的音频路径不存在 | 确认 audio 字段路径正确，或先运行 generate-tts 补全 |
PIL.UnidentifiedImageError | 图片文件损坏或格式不支持 | 删除该图片，重新运行 search-images 下载 |
| 视频合成卡住不动 | 某段音频时长为 0 或 duration 字段错误 | 检查 project.yaml 中所有 duration 字段，值应大于 0 |
| 输出视频无声音 | ffmpeg 版本过旧 | 升级 ffmpeg：brew upgrade ffmpeg |