故事板破坏者
- 作者仓库星标 12,584
- 作者仓库 huobao-drama
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @chatfire-AI · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 分镜拆解指南
## 拆解原则
每个镜头聚焦**单一动作**,描述要详尽具体。每个镜头时长 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`,格式为 `旁白:内容`
章节与文件索引
按说明文件中的顺序排列。
镜头要素
视频提示词格式
使用步骤
场景关联规则
角色绑定规则
文件/命令 -> image_prompt · video_prompt · bgm_prompt · sound_effect · scene_id · character_ids · <location>地点</location> · <role>角色名</role>
内容校验值 -> b436a18cc8ca
当前原文的自动摘译,尚未人工审校。
镜头要素
镜头标题:3-5字概括核心内容(如"噩梦惊醒") 时间:具体时分 + 光线描述 地点:场景完整描述 + 空间布局 + 环境细节 景别:远景/全景/中景/近景/特写 角度:平视/仰视/俯视/侧面/背面
视频提示词格式
每个镜头必须包含
video_prompt字段,用于驱动 AI 视频生成: 标签说明:<location>地点</location>— 场景标记<role>角色名</role>— 角色标记<voice>角色名</voice>— 画外音/旁白标记使用步骤
调用
read_storyboard_context读取剧本、角色、场景、已有分镜摘要 先基于剧本完成镜头拆解,确保总时长和叙事连续性合理 为每个镜头补全完整字段: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调用save_storyboards一次性保存完整分镜 如需调整,调用update_storyboard修改具体镜头场景关联规则
优先使用
read_storyboard_context返回的sceneslocation + time可明确匹配时,必须回填正确scene_id不要凭空生成不存在的场景 ID 如果剧本内容明显落在已有场景中,不要重复创造新场景描述角色绑定规则
character_ids必须从read_storyboard_context返回的角色列表中选择 一个镜头可以没有角色,也可以绑定多个角色 只要镜头里有明确出场、被看见、发生动作或说话的角色,都应绑定进去 纯环境镜头、空镜头、物件镜头可以传空数组