PRINTFILM: AI short-video marketing and AI short-drama creation platform
漫剧分集规则(产品主规范)
地位:PRINTFILM 漫剧「分集 → 分镜 → Seedance 生成」的单一真相源。
后续改fragment_plan/build_fragments/ 前端编辑器 / 规则弹窗,均以本文为准。细则附录:SEEDANCE_2_5.md(模型参数)· SHOT_SPLITTING.md(拆镜操作细节)
资料来源:火山方舟 / Seed 官方、社区 Prompt Skill(MapleShaw / dexhunter)、本仓库现实现。
版本:v1.1 · 2026-10-20
0. 一句话原则
一集 = 开幕交代 + 若干可独立重跑的分镜;一分镜 = 一次视频任务(当前自动拆分策略 ≤15s);镜内用画面/对白/旁白分段,空镜绝不口播。
0.1 剧本编辑与来源
- 全剧原始输入保留,作为改编事实依据;已有完整故事时保留事件顺序、关键行为和结局,不能用自动摘要推翻原文。
- 每集主界面为「本集梗概 → 拍摄剧本」。旧
creative字段保留兼容,展示为默认折叠的可选「创作备注」,不再要求每集重复填写创意。 - 已有梗概时「重新生成整集」直接按梗概写正文,不再先重写梗概。梗概可从正文提取;只有尚无正文时才从备注生成。
- 编辑整段或单场未保存时,不能进入分镜或发起生成。正文不足门槛且重试仍失败时,任务必须报错,不能继续自动分镜。
- 分镜来源使用
fragment_source_fp;列表响应以params.fragment_script_changed标识正文是否改变。旧镜头保留供查看,页面提示重新分镜,时长不能冒充当前正文的时长。 - 摘要角色入库前排除明确标注的非人物环境、非拟人道具。动物、拟人角色、真实群体角色继续保留。
0.2 分镜质量与下一步产品改版
当前模型分镜校验增加主要台词的同角色、有序覆盖;对白不能因模型给出的较短时长而压缩,按约 3 字/秒估算,过长则拆段。校验失败沿用规则切分回退;该机制不能替代情节语义审校。
后续产品改版应增加「确认剧本 → 生成分镜 → 确认分镜 → 生成视频」验收点,并让自动分镜成为明确选项。每镜记录 scene_id、来源正文行/段,分开保存画面、动作、口播、运镜和结束状态;检查漏戏、无来源新增旁白、纯对白镜缺乏画面上下文、重复表演。长对白拆镜后应引用同场上一画面的结束状态,避免机械复制完整动作导致重演。当前文本格式和自动分镜流程尚未完成这些结构化改版。
1. 层级模型
项目 Project
└─ 分集 Episode(本集场记正文 + 顶栏生成参数)
└─ 分镜 Fragment(一次 Seedance 调用)
└─ 段 Beat(@duration + 画面|对白|旁白)
| 层级 | 产品对象 | 时长 | 一次动作 |
|---|---|---|---|
| 分集 | DramaEpisode |
多镜串联,常见 1–3 分钟量级成片 | AI 重新分镜 / 全部生成 |
| 分镜 | DramaFragment |
优先 8–15s,当前自动拆分硬上限 15s | 单镜「生成」 |
| 段 | 脚本内 @duration |
3–12s | 镜内节奏,非独立任务 |
常量(代码必须对齐):
| 常量 | 值 | 位置 |
|---|---|---|
| 单段 min/max | 3 / 12 | seedance_segments / segmentDuration.ts |
| 单镜软/硬上限 | 15 / 15 | build_fragments;产品当前主动收紧,不等同上游能力上限 |
| Seedance duration | 4–30 | fragment_content_duration / Ark |
| 参考音频目标/上限 | 15s / ~30s | voice_reference_audio |
2. 分集结构规则
2.1 开幕镜(强制,fragments[0])
| 要求 | 说明 |
|---|---|
is_opening: true |
仅首条 |
| 时长 | 建议 8–15s |
| 必须交代 | 「第 N 集」原文 + 本集标题;1–3 句背景/前情;开场气氛画面 |
| 角色 | character_names 通常空或极少;禁止写人物介绍文案 |
| 片头 | 集号只在开幕强调一次;后续镜禁止重复整集片头 |
系统后处理写入:【片头·集号叠字】、【背景介绍·画面叠字】 等(模型不要输出这些 cue)。
2.2 正戏镜(fragments[1…])
- 按场面 / 情绪段落拆,一场戏通常 1–4 镜
- 覆盖场记全部有效冲突与转折,禁止无故删戏
- 整集避免碎成「一句一对白一镜」
2.3 何时必须切新镜
满足任一即切:
- 场景切换(地点 / 日夜 / 内外)
- 主要角色组合明显变化
- 情绪段落切换(铺垫→冲突→反转→收束)
- 叙事职责不同(开幕 ≠ 对白戏 ≠ 纯空镜)
- 累计将超过当前拆分上限 15s
2.4 分集顶栏参数(作用于本集各镜)
| UI | 提交字段 | 规则 |
|---|---|---|
| 视频风格 | 提示词风格块 | 全片强制画风 |
| 模型 | model |
默认 Seedance 2.5 |
| 画幅 | ratio |
竖屏短剧常用 9:16 |
| 清晰度 | resolution |
草稿 480p,成片可 720p |
同集生成应保持画幅/风格一致;单镜可改脚本,不改顶栏默认。
3. 分镜脚本规则(Fragment content)
3.1 脚本组装顺序(系统写入)
【字幕 cue】
【BGM cue】
【片头/背景叠字】(仅开幕)
【人物介绍·画面叠字·角色身旁】(仅本剧首次出场,贴角色身旁)
@duration:N
【画面|对白|旁白】正文…
(可多段 @duration)
漫剧字幕 cue:【字幕:底部居中·简体中文·逐句轮换·与口播同步】
(同一时刻只显示一行/一句,随口播逐句轮换;勿用「全程旁白烧录」类科普 cue,避免整镜被念。)
3.2 三类正文(铁律)
| 类型 | 用户/LLM 写法 | 系统前缀 | 配音 | 字幕 |
|---|---|---|---|---|
| 画面 / 空镜 | 空镜:… 远景:… 或纯环境动作描写 |
【画面·无配音仅环境音】 |
否 | 否 |
| 对白 | 角色名:台词 |
【对白·慢速清晰·同步字幕】 |
是 | 是 |
| 旁白 | 旁白(VO):… |
【旁白·慢速清晰·同步字幕】 |
是 | 是 |
禁止:
- 把
空镜:黄河浪…写成对白/旁白(会口播并烧字幕) - 在画面段要求「对口型 / 贴词同步」
- 无口播意图却使用「同步字幕」对白前缀
提交 Seedance 前须纠正误标行(已实现 rewrite_misclassified_visual_voice_lines)。
3.3 镜内节奏模板(推荐)
建立空镜 →(动作)→ 对白/旁白 →(反应空镜)
【字幕:底部居中·简体中文·逐句轮换·与口播同步】
【BGM:史诗弦乐铺底,音量低于人声】
@duration:4
【画面·无配音仅环境音】空镜:浑浊黄河拍击老石,远坡百姓扶老携幼……
@duration:6
【对白·慢速清晰·同步字幕】禹:水患未平,岂能退!
@duration:4
【画面·无配音仅环境音】特写:禹攥紧简册,目光望向下游。
单镜内镜头变化建议:约 3–7 段;15s 内过密易闪。
3.4 时长估算
| 类型 | 经验 |
|---|---|
| 空镜 / 画面 | 2–6s |
| 旁白 | ~3 字/秒,再钳 3–12s |
| 对白 | 略短于旁白,留呼吸停顿 |
口播:慢速清晰,禁止赶词(写入 Seedance 强制约束)。
3.5 @asset 与 @duration
| Token | 含义 | 提交时 |
|---|---|---|
@asset:ID |
引用角色/场景/道具 | →「名称(参考图 N)」;正文里已经写了同名则不再叠写 |
@duration:N |
本段秒数 | → 00:00-00:04 时间区间;合计 → API duration |
LLM 分镜禁止直接输出 @asset / @duration / 【字幕】【BGM】【人物介绍】(系统后处理注入)。
4. 资产与参考规则
4.1 本镜引用范围
- 只引用本镜真正用到的角色图 / 场景图
- 稳定优先:主体参考图约 1–8,勿一镜塞满 30 张
character_names:仅正文点到的出镜角色;群演可省略
4.2 音色与 reference_audio
已绑定试听的角色 / 项目旁白,在本镜开口时会提交 reference_audio(SEEDANCE_ATTACH_REFERENCE_AUDIO=true)。未绑定或本镜未开口的角色只挂形象图。缺音色生成前为警告级(可继续),不硬拦截。
| 规则 | 说明 |
|---|---|
| 要对白的角色 | 建议绑定试听(资产库 / 分集 / 画布均可);未绑则由 generate_audio 自发挥 |
| 角色 VO | 角色(vo):台词 走对白/内心独白,不是第三人称旁白;纯 角色(vo,情绪)。 是舞台指示,禁止口播 |
| 旁白 | 第三人称旁白行:有项目级 narrationVoiceAudio 则挂旁白参考音,否则模型配音 |
| 参考音频时长 | 单条目标约 15s,上限约 30s;过短/过长由 voice_reference_audio 截断补足 |
4.3 人物介绍叠字
- 仅本剧第一次出现的重要角色
- 格式:
【人物介绍·画面叠字·角色身旁】姓名|短简介 - 位置:贴在对应角色身旁(肩侧小字),随首次入画短暂出现;禁止居中大标题、禁止与底部口播字幕抢位
- 非口播;不要让模型念介绍全文
4.4 Seedance 2.5 素材上限(生成侧)
| 类型 | 上限 | 备注 |
|---|---|---|
| 参考图 | ≤30 | 产品侧按本镜精简 |
| 参考视频 | ≤10,合计 ≤~30s | 当前主路径少用 |
| 参考音频 | ≤10,合计 ≤~30s | 角色+旁白 |
详见 SEEDANCE_2_5.md。
5. 运镜与提示词写法(分集内可用)
社区与官方共识,写入镜内画面描写时遵守:
- 公式:主体 + 动作/姿态 + 场景环境 +(景别/运镜)+ 结束态 +(光影可选)
- 每段运动轴 ≤ 2(推+摇可以;推+摇+升同时易失控)
- 近景大旋转易崩脸 → 环绕留给中景以上
- 参考必须写清用途:形象 / 场景 / 运镜 / 音色(本仓库用「参考图 N / 参考音频 N」约束块)
- 信息完整、忌干瘪:禁止「禹站在河边」式一句摘要;须写清空间关系、道具用法与本段结束可见状态。同时避免堆砌无关形容词噪声
- 勿写编辑/延长措辞于普通生成(避免任务被重分类)
景别标签可直接用于画面行:空镜: 远景: 近景: 特写: 全景: 等。
AI 重新分镜(fragment_plan)须按上述公式输出画面行;单镜建议 3–7 行(建立→动作→口播→反应),对白镜至少保留 1 条画面行。
5.1 编辑器词库(@ → 小工具 → 景别/运镜)
代码源:frontend/src/lib/dramaCameraLexicon.ts
| 组 | 可插入前缀 |
|---|---|
| 景别 | 空镜: 远景: 全景: 中景: 近景: 特写: 大特写: 建立镜头: 气氛镜头: |
| 运镜 | 推镜: 拉镜: 摇镜: 移镜: 跟拍: 俯拍: 仰拍: 航拍: |
插入后继续补写主体与动作;这些行一律按画面处理,禁止再包一层对白/旁白 cue。
6. Seedance 提交契约(每镜)
| 字段 | 来源 |
|---|---|
model |
顶栏模型 |
content[] |
text 提示词 + reference_image + 开口角色/旁白的 reference_audio |
duration |
@duration 合计(4–30) |
ratio / resolution |
顶栏 |
generate_audio |
true(短剧口播) |
watermark |
false |
return_last_frame |
true(落盘 params.lastFrameUrl;顶栏可开关跨镜衔接) |
提示词块顺序:
- 画面风格强制约束
- 音频/字幕/BGM 强制约束(区分画面-only vs 对白/旁白)
- 角色音色 / 旁白音色 → 参考音频序号(已绑且本镜开口时)
- 角色形象 / 场景 / 道具 → 参考图序号
- 正文(已替换 asset / duration)
7. AI 重新分镜(fragment_plan)契约
7.1 模型只输出
{
"fragments": [
{
"duration_sec": 12,
"scene_name": "地点",
"character_names": ["角色"],
"is_opening": true,
"lines": ["空镜:…", "禹:…", "旁白(VO):…"]
}
]
}
7.2 模型禁止输出
### 场、出场人物行、一切 【字幕】【BGM】【人物介绍】【片头】、@asset、@duration。
7.2.1 画面描写密度(与 §5 对齐)
- 每条画面行:主体 + 动作 + 场景 + 景别/运镜 + 结束态
- 单镜约 3–7 行;对白镜至少 1 条画面行
- 禁止干瘪一句摘要;禁止把动作塞进对白冒号后当台词
7.3 系统后处理
- 行分类打前缀(空镜 → 画面)
- 注入 cue /
@duration/ 开幕叠字 / 首次介绍 - 超软上限拆 Fragment
8. 生成与预览行为
| 规则 | 说明 |
|---|---|
| 单镜生成 | 仅锁当前镜按钮;其它镜可编辑、可预览 |
| 全部生成 | 有进行中任务时禁止重复全部入队 |
| 并行 | video 队列最多约 10 路 |
| 预览 | 轮询刷新 fragments 不得打断正在播放的视频 |
| AI 重新分镜 | 与视频生成互斥 |
9. 分集质量门禁(发布前 / 生成前)
9.1 结构
- 存在开幕镜且含集号+背景+气氛
- 正戏覆盖关键冲突,无无故删戏
- 无「一句一镜」碎片化
9.2 脚本
- 自动拆分每镜合计 ≤15s,单段 3–12s
- 空镜/景别均为画面前缀
- 对白/旁白前缀仅用于真实口播
- BGM 声明音量低于人声
9.3 资产
- 出镜角色有图
- 本镜引用未明显超量
9.4 提交
- 顶栏画幅/模型/风格已确认
- 普通生成未含「编辑/延长」歧义措辞
10. 后续完善清单(按本文推进)
改代码时对照本节勾选;完成一项在 PR / 发布记录里引用本文章节号。
| 优先级 | 项 | 对应章节 | 状态 |
|---|---|---|---|
| P0 | 空镜/景别永不进对白前缀;提交前纠正 | §3.2 | 已做 |
| P0 | 开幕镜强制字段与系统叠字 | §2.1 | 已有,持续校验 |
| P1 | fragment_plan_prompt 与本文 §3/§5/§7 全文对齐(含画面密度/结束态) |
§5、§7 | 已对齐(2026-08-13 加密度硬约束) |
| P1 | 前端脚本校验:空镜行禁止对白 cue、时长合计告警 | §3、§9 | 已做(dramaEpisodeScriptValidate + 编辑区提示 + 生成阻断) |
| P1 | SeedanceRulesModal 文案与本文同步 | §3–§6 | 已同步(漫剧字幕 cue / 空镜铁律) |
| P2 | 运镜词库(景别/推拉摇移)写入编辑器 @ 菜单或帮助 | §5 | 已做(dramaCameraLexicon + @ 小工具) |
| P2 | 生成前资产门禁(缺图/缺音色阻断或明确警告) | §4、§9.3 | 已做(警告级,确认框可继续) |
| P2 | 尾帧衔接 / 延长路径产品化(可选) | §6 return_last_frame |
已做:落盘尾帧;有参考媒体时以 reference_image 衔接(禁混 first_frame);延长路径未做 |
| P3 | 剪辑节奏公式用于整集导出 | 社区 Skill | 已做(导入时写入时长;dramaEditRhythm 可供导出规划) |
11. 相关代码索引
| 模块 | 路径 |
|---|---|
| AI 分镜提示 | backend/app/services/drama/fragment_plan_prompt.py |
| AI 分镜规范化 | backend/app/services/drama/fragment_plan.py |
| 场记切镜 / 行分类 | backend/app/services/drama/build_fragments.py |
| 生产约束 / 空镜纠正 | backend/app/services/seedance_segments.py |
| 组装请求体 | backend/app/services/drama/build_seedance_generate_body.py |
| 生成任务 | backend/app/services/drama/generation.py / jobs.py |
| 前端时长 | frontend/src/lib/segmentDuration.ts |
| 前端脚本/资产门禁 | frontend/src/lib/dramaEpisodeScriptValidate.ts |
| 运镜/景别词库 | frontend/src/lib/dramaCameraLexicon.ts |
| 分镜板宫格导入 | frontend/src/lib/dramaStoryboardGrid.ts / StoryboardGridImportModal |
| 剪辑节奏公式 | frontend/src/lib/dramaEditRhythm.ts |
| 分集编辑页 | frontend/src/pages/drama/EpisodeEditPage.tsx |
| 规则弹窗 | frontend/src/components/drama/SeedanceRulesModal.tsx |
12. 文档关系
| 文档 | 职责 |
|---|---|
| 本文 EPISODE_RULES.md | 分集产品规则主规范(改需求先改这里) |
| SEEDANCE_2_5.md | 模型/API 参数百科 |
| SHOT_SPLITTING.md | 拆镜操作手册与示例 |
| STANDARDS.md | 工程规范 |
上游 Seedance 官方变更时:先更新 SEEDANCE_2_5.md,再修订本文 §4.4 / §6,最后改代码常量。