video-creator

name video-creator description 视频创作技能。图片+音频合成视频，支持淡入淡出转场、自动拼接片尾、添加BGM。当用户提到「生成视频」「图文转视频」「做视频号」时触发此技能。 Video Creator 图片+音频合成视频工具。 核心流程（铁律） 故事类视频生成流程（套娃流程） 当用户提供故事/剧情/剧本时， 必须严格按以下套娃流程执行 ： ┌─────────────────────────────────────────────────────────────┐ │ 第一层：故事 → 拆分场景 → 并发生成场景主图（文生图） │ │ │ │ 大闹天宫 → 场景1：弼马温受辱 │ │ 场景2：筋斗云回花果山 │ │ 场景3：玉帝派兵 │ │ ... │ │ → 并发调用 text_to_image.py 生成每个场景主图 │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ 第二层：每个场景主图 → 图生图拆出细镜头（保持角色一致） │ │ │ │ 场景1主图 → 细镜头1：悟空看官印疑惑 │ │ 细镜头2：悟空踢翻马槽 │ │ 场景2主图 → 细镜头1：踏筋斗云腾空 │ │ 细镜头2：花果山自封大圣 │ │ → 并发调用 image_to_image.py，以主图为参考 │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ 第三层：生成配音 + 字幕 + 合成视频 │ │ │ │ 1. tts_generator.py 生成配音 + 时间戳 │ │ 2. 【铁律】根据时间戳精确计算每张图的duration（见下方规范） │ │ 3. 生成 SRT 字幕 │ │ 4. 生成 video_config.yaml 前必须校验总时长 │ │ 5. video_maker.py 合成： │ │ → 图片合成（带转场） │ │ → 合并音频 │ │ → 烧录字幕（ASS格式，底部居中固定） │ │ → 自动拼接片尾（二维码+"点关注不迷路"） │ │ → 添加BGM │ └─────────────────────────────────────────────────────────────┘ **铁律：所有视频必须自动拼接片尾！** 目录结构规范 assets/generated/{project_name}/ ├── scene1/ │ ├── main.png # 场景1主图（文生图） │ ├── shot_01.png # 细镜头1（图生图） │ └── shot_02.png # 细镜头2（图生图） ├── scene2/ │ ├── main.png │ ├── shot_01.png │ └── shot_02.png ├── ... ├── narration.mp3 # 配音 ├── narration.json # 时间戳 ├── subtitles.srt # 字幕 ├── video_config.yaml # 视频配置 └── {project_name}.mp4 # 最终视频 执行命令示例 # 第一层：并发生成场景主图 python .opencode/skills/image-service/scripts/text_to_image.py "风格描述，场景1内容" -r 9:16 -o scene1/main.png & python .opencode/skills/image-service/scripts/text_to_image.py "风格描述，场景2内容" -r 9:16 -o scene2/main.png & wait # 第二层：并发图生图生成细镜头 python .opencode/skills/image-service/scripts/image_to_image.py scene1/main.png "保持角色风格，细镜头描述" -r 9:16 -o scene1/shot_01.png & python .opencode/skills/image-service/scripts/image_to_image.py scene1/main.png "保持角色风格，细镜头描述" -r 9:16 -o scene1/shot_02.png & wait # 第三层：生成配音+合成视频 python .opencode/skills/video-creator/scripts/tts_generator.py --text "完整旁白" --output narration.mp3 --timestamps python .opencode/skills/video-creator/scripts/video_maker.py video_config.yaml --srt subtitles.srt --bgm epic 视频配置文件格式 # video_config.yaml ratio: "9:16" # 必须加引号！避免YAML解析错误 bgm_volume: 0.12 outro: true scenes: - audio: narration.mp3 images: # 按场景顺序排列所有细镜头 - file: scene1/shot_01.png duration: 4.34 - file: scene1/shot_02.png duration: 4.88 - file: scene2/shot_01.png duration: 2.15 # ... 注意 ： ratio 必须用引号包裹，如 "9:16" ，否则 YAML 会解析成时间格式。 时长分配规范（铁律！） 生成 video_config.yaml 前，必须严格按以下流程计算 duration： 步骤1：读取时间戳文件 import json with open ( "narration.json" , "r" ) as f: timestamps = json.load(f) audio_duration = timestamps[- 1 ][ "end" ] print ( f"音频总时长: {audio_duration: .1 f} s" ) 步骤2：按内容语义划分场景 根据解说词内容，确定每张图对应的时间段： # 示例：根据解说词内容划分 # 找到每个主题切换点的时间戳 scenes = [ ( "cover.png" , 0 , 12.5 ), # 开场到第一个主题切换 ( "scene01.png" , 12.5 , 26 ), # 第二段内容 # ...根据 narration.json 中的句子边界精确划分 ] 步骤3：计算每张图的 duration for file, start, end in scenes: duration = end - start print ( f" {file} : {duration: .1 f} s" ) 步骤4：校验总时长 total_duration = sum (duration for _, _, duration in scenes) assert abs (total_duration - audio_duration) < 1.0 , \ f"时长不匹配！图片总时长 {total_duration} s vs 音频 {audio_duration} s" 铁律 必须先读取 narration.json 时间戳 ，不能凭感觉估算 按句子语义边界划分 ，不能平均分配 生成配置前必须校验 ，确保图片总时长 ≈ 音频总时长（误差<1秒） 禁止让脚本自动拉伸 ，音画不同步的视频不合格 时长分配表模板 生成配置前，先输出分配表让用户确认： | 场景图 | 对应内容 | 开始 | 结束 | 时长 | |--------|----------|------|------|------| | cover.png | 开场引入 | 0s | 12.5s | 12.5s | | scene01.png | AI Agent时代 | 12.5s | 26s | 13.5s | | ... | ... | ... | ... | ... | | **合计** | | | | **{total}s** | 音频总时长：{audio _duration}s 差值：{diff}s ✅/❌ 字幕规范 字幕使用 ASS 格式， 强制底部居中固定位置 ： 位置：底部居中（Alignment=2） 字体：PingFang SC 大小：屏幕高度 / 40 描边：2px 黑色描边 + 1px 阴影 底边距：屏幕高度 / 20 禁止 ：字幕乱跑、大小不一、位置不固定 脚本参数说明 video_maker.py python video_maker.py config.yaml [options] 参数 说明 默认值 --no-outro 不添加片尾 添加 --no-bgm 不添加BGM 添加 --fade 转场时长(秒) 0.5 --bgm-volume BGM音量 0.08 --bgm 自定义BGM（可选: epic） 默认科技风 --ratio 视频比例 16:9（会被配置文件覆盖） --srt 字幕文件路径 无 tts_generator.py python tts_generator.py --text "文本" --output audio.mp3 [options] 参数 说明 默认值 --voice 音色 zh-CN-YunxiNeural --rate 语速 +0% --timestamps 输出时间戳JSON 否 支持的视频比例 与 image-service 生图服务保持一致，支持 10 种比例 ： 比例 分辨率 适用场景 1:1 1024×1024 正方形，朋友圈 2:3 832×1248 竖版海报 3:2 1248×832 横版海报 3:4 1080×1440 小红书、朋友圈 4:3 1440×1080 传统显示器 4:5 864×1080 Instagram 5:4 1080×864 横版照片 9:16 1080×1920 抖音、视频号、竖屏 16:9 1920×1080 B站、YouTube、横屏 21:9 1536×672 超宽屏电影 片尾规范 铁律：所有视频必须自动拼接对应尺寸的片尾！ 片尾匹配顺序： 精确匹配： outro_{ratio}.mp4 方向匹配：竖版→ outro_9x16.mp4 ，横版→ outro_16x9.mp4 兜底： outro.mp4 BGM 资源 文件 风格 适用场景 bgm_technology.mp3 科技感 技术教程、产品介绍 bgm_epic.mp3 热血史诗 故事、战斗、励志 使用： --bgm epic 或 --bgm /path/to/bgm.mp3 常用音色 音色 ID 风格 zh-CN-YunyangNeural 男声，新闻播报 zh-CN-YunxiNeural 男声，阳光活泼 zh-CN-XiaoxiaoNeural 女声，温暖自然 zh-CN-XiaoyiNeural 女声，活泼可爱 目录结构 video-creator/ ├── SKILL.md ├── scripts/ │ ├── video_maker.py # 主脚本：图片+音频→视频 │ ├── tts_generator.py # TTS 语音生成 │ └── scene_splitter.py # 场景拆分器（可选） ├── assets/ │ ├── outro.mp4 # 通用片尾（16:9） │ ├── outro_9x16.mp4 # 竖版片尾 │ ├── outro_3x4.mp4 # 3:4片尾 │ ├── bgm_technology.mp3 # 默认BGM │ └── bgm_epic.mp3 # 热血BGM └── references/ └── edge_tts_voices.md 依赖 # 系统依赖 brew install ffmpeg # Mac # Python 依赖 pip install edge-tts pyyaml