分镜表优先流程
本文属于“当前架构”文档,描述当前已经生效的分镜表优先制作流程。
入口与页面
剧本解析结果确认后,工作台自动跳转到:
/projects/:projectId/storyboard/:chapterId同一集也可以在剧集面板点「分镜表」进入。页面不存在分镜表时,直接提供「生成分镜表」入口。
数据模型
分镜表不另造生成链路,而是复用已有表:
| 页面概念 | 底层表 |
|---|---|
| 分镜表 | shot_plan_drafts |
| 分镜行 | shot_plan_candidates |
| 场次 | scene_groups.storyboard_draft_id 指向的分镜表 |
| 素材清单 | storyboard_assets |
| 素材与分镜行关联 | storyboard_asset_rows |
| AI 对话 | storyboard_ai_messages |
审核通过时复用 confirm_draft 写入正式 shots / shot_details / shot_dialog_lines,并建立 shot_plan_applied_shots 映射。
分镜表状态与候选确认
draft → generating → review_required → confirmed
↘ failedgenerating:后台任务生成中,页面每 5 秒轮询。review_required:分镜行是“候选”。用户可以逐行编辑、勾选批量忽略、恢复被忽略的行。confirmed:已确认候选并同步正式镜头;分镜行、场次、AI 提案都不再允许写表。
页面主流程固定为四步:
生成分镜 → 确认候选 → 审核素材 → 开拍确认候选时只写入未忽略的行,并自动解析素材清单。审核通过不会因为“角色还没有身份版本”等素材缺口被阻断;这些缺口留给素材审核与单镜拍摄门禁拦截。分镜行本身的硬错误(无有效场次、时长越界、说话人未绑定等)仍会阻断通过。
候选表的默认列只保留决策所需信息:场次/镜号、候选镜头、时长、镜头语言、场景/角色、操作。台词、参考图、道具、服装、声音、所需素材、问题放在展开行里;1280 宽度下不横向滚动,1600 以上再显示台词和参考图列。点击行打开编辑抽屉,行尾「更多」菜单提供忽略/恢复/开拍检查。
素材清单与审核
确认候选后会自动解析一次素材清单,也可在素材页点「刷新素材」(会重置已有素材审核状态)。素材按 asset_key 跨行去重,范围包括:
- 角色;
- 场景;
- 道具;
- 服装;
- 台词音色/配音。
素材状态:
| 状态 | 含义 |
|---|---|
unmatched | 项目资产库还没有对应资产 |
candidate | 有资产,但还没有可审的参考图/音色 |
pending_review | 已有参考图/音色,待人工审核 |
approved | 已通过 |
rejected | 已退回 |
审核通过前会校验:
- 角色:必须有已采纳的设定板,或已采纳的角色卡(
identity_version_id)。 - 音色:角色必须已绑定
voice_id。 - 场景/道具/服装:必须至少有一张参考图。
- 所有类型:必须已经关联到项目资产。
角色参考图优先取当前设定板的 file_id_zh / file_id_en,没有设定板时回落到角色主图或已采纳角色卡。
素材页使用按类型分组的卡片墙:角色、场景、道具、服装、音色。卡片同时展示缩略图、状态、被多少镜使用、缺什么,以及「通过 / 退回 / 去生成或关联」。顶部提供“通过全部已就绪”批量操作,只处理已经具备参考图或音色的 pending_review 素材。
角色造型(换装)
分镜表的「角色造型」页签解决“同一角色在不同场次/镜头穿不同衣服”。
流程:
生成角色造型计划(AI) → 用户审核每场每个角色的服装 → 通过并应用- 系统按场次给每个出场角色选一套服装,并识别场次内的换装镜头(shot override)。
- AI 只使用项目已关联的服装 ID;没有匹配到服装的角色会标记“待选择”,不会静默套错。
- 用户只需要审核:卡片展示角色、服装名、选择理由、参考图(造型图或服装图);可以逐项更换服装。
- 点「通过并应用」后,系统会:
- 为角色 + 服装创建/复用
asset_versions(version_kind=appearance, variant_type=costume); - 写入分镜候选
characters[].costume_id / costume_name / appearance_version_id; - 对已同步镜头更新
shot_asset_versions(character_appearance)与costume; - 建立
project_costume_links,供参考图与提示词使用。
- 为角色 + 服装创建/复用
- 门禁新增
character_outfits_valid:每个出场角色必须有服装和造型版本,否则不能开拍。
数据模型:
| 数据 | 表/字段 |
|---|---|
| 造型计划 | storyboard_wardrobe_items(scene 默认 + shot 覆盖) |
| 分镜行造型 | shot_plan_candidates.payload.characters[].costume_id / appearance_version_id |
| 角色造型版本 | asset_versions(version_kind=appearance, attributes.costume_id) |
| 镜头造型 | shot_asset_versions(role=character_appearance / costume) |
造型参考图优先取角色造型版本已采纳图片;没有时回落到服装资产图。需要生成角色穿着服装的图时,从造型卡片进入角色资产详情,在对应造型版本下生成/采纳图片。
单镜拍摄门禁
分镜表 confirmed 后,行尾「更多」菜单才出现「开拍检查」。门禁弹窗只展示当前镜头还差什么,并给出「去审核素材 / 去调整参考图 / 去开拍」的下一步按钮。
每行门禁返回 shootable 和逐项检查:
| 检查 | 条件 |
|---|---|
storyboard_approved | 分镜表已 confirmed |
shot_synced | 已同步正式镜头 |
assets_approved | 该行关联素材全部 approved |
duration_valid | 时长 4–15 秒 |
dialogue_voice | 有台词时音色素材已审核 |
reference_images_valid | 参考图不超过 9 张 |
审核素材通过时,会把参考图自动绑定到已同步镜头(shot_reference_bindings,最多 9 张,source=auto),供后续生成链路直接使用。未确认候选的分镜行不会显示开拍入口。
AI 审核助手
POST /studio/storyboard/{draft_id}/ai/chat 返回:
reply:只读中文建议;proposals:结构化修改提案,必须携带已存在的candidate_id。
AI 不会自动改表。用户点「应用到分镜行」后,前端才调用行更新接口。分镜表 confirmed 后提案按钮禁用;后端行更新也会返回 409。
对话历史按 seq 稳定排序,避免同一秒内 user/assistant 消息乱序。
导出
| 格式 | 接口 | 缩略图 |
|---|---|---|
| Excel | /studio/storyboard/{draft_id}/export.xlsx | 嵌入行首列 |
/studio/storyboard/{draft_id}/export.pdf | 嵌入 A4 横向表格 | |
| CSV | /studio/storyboard/{draft_id}/export.csv | 参考图 URL 列 |
缩略图优先取镜头参考绑定;没有绑定时回落到分镜行素材参考图。
写请求与读一致性
所有使用 get_db 的路由都显式声明 scope="function",让事务在响应发出前提交。这样前端在写请求返回后立即刷新列表,不会读到提交前的旧状态。