story-video-orchestrator

name	story-video-orchestrator
description	端到端剧情视频流水线编排，串联角色图、主题、分镜生成与质量分析，适合漫剧、剧情短片和角色一致性视频创作。
metadata	{"openclaw":{"emoji":"🎞️","primaryEnv":"ARK_API_KEY","requires":{"env":["ARK_API_KEY"],"bins":["python3"]}}}

剧情视频流水线 Skill

把 manga-drama 和 volcengine-video-understanding 组合成可复用的剧情视频流水线：角色图 -> 剧本/分镜 -> 多场景视频 -> 批量分析。

何时使用

• 用户要从一张角色图快速生成剧情短片
• 需要把主题、风格、分镜数量封装成一次执行
• 需要在生成后自动拿到漫剧分析报告

使用方法

python3 scripts/run_story_pipeline.py \
  --character ./character.png \
  --theme "樱花树下的邂逅" \
  --style anime_2d \
  --scenes 4 \
  --ratio 16:9 \
  --output-dir ./story_output

参数说明

• --character：角色图片路径，必填
• --theme：故事主题；与 --script-file 二选一
• --script-file：自定义剧本路径
• --style：漫画风格，默认 anime_2d
• --scenes：分镜数，默认 4
• --ratio：输出比例，默认 16:9
• --duration：单镜头时长，默认 5
• --skip-analysis：跳过分析报告
• --output-dir：输出目录，默认 ./story_output

输出结构

story_output/
├── task_info.json
├── drama/
│   ├── script.txt
│   ├── scene_1.mp4
│   └── drama_info.json
├── analysis/
│   └── drama_analysis.md
└── events/
    ├── event_story_pipeline_started_*.json
    ├── event_drama_generated_*.json
    └── event_video_analysis_completed_*.json

事件流

1. story.pipeline.started
2. drama.generated
3. video.analysis.completed（如果未跳过分析）

进阶资料

• 需要选择不同流程模式时，读取 references/workflow-modes.md
• 需要拆解剧情节奏时，进一步读取 ../manga-drama/references/story-beats.md