Skip to content
分镜表优先流程

分镜表优先流程

本文属于“当前架构”文档,描述当前已经生效的分镜表优先制作流程。

入口与页面

剧本解析结果确认后,工作台自动跳转到:

/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
                    ↘ failed
  • generating:后台任务生成中,页面每 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嵌入行首列
PDF/studio/storyboard/{draft_id}/export.pdf嵌入 A4 横向表格
CSV/studio/storyboard/{draft_id}/export.csv参考图 URL 列

缩略图优先取镜头参考绑定;没有绑定时回落到分镜行素材参考图。

写请求与读一致性

所有使用 get_db 的路由都显式声明 scope="function",让事务在响应发出前提交。这样前端在写请求返回后立即刷新列表,不会读到提交前的旧状态。