storyboard breaker
- Repo stars 12,584
- Author repo huobao-drama
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @chatfire-AI · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 分镜拆解指南
## 拆解原则
每个镜头聚焦**单一动作**,描述要详尽具体。每个镜头时长 10-15 秒。
## 镜头要素
1. **镜头标题**:3-5字概括核心内容(如"噩梦惊醒")
2. **时间**:具体时分 + 光线描述
3. **地点**:场景完整描述 + 空间布局 + 环境细节
4. **景别**:远景/全景/中景/近景/特写
5. **角度**:平视/仰视/俯视/侧面/背面
6. **运镜**:固定/推镜/拉镜/摇镜/跟镜/移镜
7. **动作**:谁 + 具体怎么做 + 肢体细节 + 表情
8. **对话**:该镜头的完整对话
9. **画面结果**:动作的即时后果 + 视觉细节
10. **氛围**:光线 + 色调 + 声音 + 整体氛围
11. **时长**:每个镜头 10-15 秒
12. **静态画面提示词**:`image_prompt`,用于首帧/尾帧/镜头图片生成
13. **视频提示词**:`video_prompt`,按 3 秒分段的视频生成描述(必填)
14. **配乐提示词**:`bgm_prompt`,描述该镜头适合的配乐风格
15. **音效提示词**:`sound_effect`,描述该镜头关键环境音/动作音
16. **场景关联**:若能匹配已有场景,必须填写 `scene_id`
17. **角色关联**:填写 `character_ids`,绑定当前镜头涉及的 0 到多个角色
## 视频提示词格式
每个镜头必须包含 `video_prompt` 字段,用于驱动 AI 视频生成:
```
0-3秒:<location>咖啡厅</location>,近景,<role>小明</role>低头看手机,表情焦虑。
<n>3-6秒:<location>咖啡厅</location>,全景,门铃响,<role>小红</role>推门走入。
<n>6-9秒:<location>咖啡厅</location>,中景,<role>小红</role>微笑走向小明,坐下。
```
标签说明:
- `<location>地点</location>` — 场景标记
- `<role>角色名</role>` — 角色标记
- `<voice>角色名</voice>` — 画外音/旁白标记
- `<n>` — 时间段分隔符
## 使用步骤
1. 调用 `read_storyboard_context` 读取剧本、角色、场景、已有分镜摘要
2. 先基于剧本完成镜头拆解,确保总时长和叙事连续性合理
3. 为每个镜头补全完整字段:`title / shot_type / angle / movement / location / time / character_ids / action / dialogue / description / result / atmosphere / image_prompt / video_prompt / bgm_prompt / sound_effect / duration / scene_id`
4. 调用 `save_storyboards` 一次性保存完整分镜
5. 如需调整,调用 `update_storyboard` 修改具体镜头
## 场景关联规则
- 优先使用 `read_storyboard_context` 返回的 `scenes`
- `location + time` 可明确匹配时,必须回填正确 `scene_id`
- 不要凭空生成不存在的场景 ID
- 如果剧本内容明显落在已有场景中,不要重复创造新场景描述
## 角色绑定规则
- `character_ids` 必须从 `read_storyboard_context` 返回的角色列表中选择
- 一个镜头可以没有角色,也可以绑定多个角色
- 只要镜头里有明确出场、被看见、发生动作或说话的角色,都应绑定进去
- 纯环境镜头、空镜头、物件镜头可以传空数组
## 质量要求
- `description` 要适合人读,`video_prompt` 要适合模型生成,二者不要互相替代
- `image_prompt` 要突出单帧构图、角色外观、环境和光线
- `video_prompt` 要突出时间推进、动作变化、镜头语言
- `bgm_prompt` 和 `sound_effect` 用简洁短语即可,但不能空泛到只有“紧张”“悲伤”
- 若存在旁白,统一写入 `dialogue`,格式为 `旁白:内容`
Sections and files
Listed in source order.
sections -> See the original source for section headings
terms -> No English key terms available
files/cmd -> image_prompt · video_prompt · bgm_prompt · sound_effect · scene_id · character_ids · <location>地点</location> · <role>角色名</role>
body sha256 -> b436a18cc8ca