为剧本场景生成分镜图。当用户说"生成分镜"、"预览场景画面"、想重新生成某些分镜图、或剧本中有场景缺少分镜图时使用。自动保持角色和画面连续性。
通过生成队列创建分镜图,画面比例根据 content_mode 自动设置。
内容模式规格详见
.claude/references/content-modes.md。
# 提交所有缺失分镜图到生成队列(自动检测 content_mode)
python .claude/skills/generate-storyboard/scripts/generate_storyboard.py script.json
# 为单个场景重新生成
python .claude/skills/generate-storyboard/scripts/generate_storyboard.py script.json --scene E1S05
# 为多个场景重新生成
python .claude/skills/generate-storyboard/scripts/generate_storyboard.py script.json --scene-ids E1S01 E1S02
--scene-ids和--segment-ids是同义别名(后者为 narration 模式的习惯称呼),效果相同。以下统一使用--scene-ids。
选择规则:--scene 重生成一个;--scene-ids 重生成多个;未提供则提交所有缺失项。
注意:脚本要求 generation worker 在线,worker 负责实际图像生成与速率控制。
character_sheet 图像storyboard_image 路径和场景状态脚本自动处理以下参考图传入,无需手动指定:
segment_break=true 时,跳过上一张分镜图参考脚本从剧本 JSON 读取以下字段构建 prompt:
场景 [scene_id/segment_id] 的分镜图:
- 画面描述:[visual.description]
- 镜头构图:[visual.shot_type]
- 镜头运动起点:[visual.camera_movement]
- 光线条件:[visual.lighting]
- 画面氛围:[visual.mood]
- 角色:[characters_in_scene]
- 动作:[action]
风格要求:电影分镜图风格,根据项目 style 设定。
角色必须与提供的角色参考图完全一致。
画面比例通过 API 参数设置,不写入 prompt。
--scene-ids 重新生成失败场景