seedance-story-orchestrator

name	seedance-story-orchestrator
description	Orchestrate script-to-final-video production with a strict stage-gated workflow (outline → episode_plan → storyboard → storyboard_images → render), using Seedream image generation, Seedance multi-shot rendering, checkpoint-based confirmation/resume, and optional FFmpeg concatenation. Use when converting txt/json/staged artifacts into storyboard videos and a final merged mp4.

Seedance Story Orchestrator (v0.2.0-phase1)

阶段性方案（Phase 1）：

• 上层编排：seedance-story-orchestrator
• 下层执行：seedance-video-generation/seedance.py

以“可审计、可恢复、可控推进”为第一目标。

Workflow（严格关卡）

固定阶段顺序：

outline -> episode_plan -> storyboard -> storyboard_images -> render

规则：

1. 每阶段执行后写入 checkpoint-{stage}.json，默认 confirmed=false
2. 未确认时，run 会立即停止并返回：
   • pending_confirmation_stage
   • next_action
3. 必须 confirm --stage <stage> 后再继续下一阶段

Prerequisites

• Python 3.8+
• seedance-video-generation skill（必须可访问 seedance.py）
• ARK_API_KEY
• FFmpeg（用于拼接最终视频）

Quick Start（推荐）

# 1) 运行到 render（会在每个关卡停下）
python3 {baseDir}/scripts/run_story.py run \
  --project-dir {baseDir}/outputs/my-project \
  --input-file /path/to/story.txt \
  --stage render

# 2) 按提示确认阶段（示例）
python3 {baseDir}/scripts/run_story.py confirm \
  --project-dir {baseDir}/outputs/my-project \
  --stage outline

# 3) 查看整体状态
python3 {baseDir}/scripts/run_story.py status \
  --project-dir {baseDir}/outputs/my-project