Skip to content
正式场次(SceneGroup)

正式场次(SceneGroup)

本文属于“当前架构”,描述 P5 / C9 已落地的正式场次。 AI 分镜规划与正式镜头写入见 AI 分镜规划。

1. 概念边界

概念表说明
剧情场次scene_groups剧集内一段连续时间/地点/事件,例如「场次 01 · 总裁办公室 · 白天」
场景资产scenes可被多个场次/剧集复用的空间素材,例如「总裁办公室」

一个场次可以有主场景资产,但一个场次也可能涉及多个场景;多个场次可以引用同一个 Scene。 禁止把两者合并为一个实体。

镜头同时保留:

  • shots.chapter_id:始终属于剧集;
  • shots.scene_group_id:可选,为空表示「未分配场次」。

使用 scene_group_id 而非 scene_id,避免与既有 Scene 资产语义冲突。

2. 数据模型

scene_groups 关键字段:

字段说明
project_id / chapter_id项目与剧集归属
index剧集内场次顺序;(chapter_id,index) 唯一
title / description场次标题与描述
location / time_of_day地点与时间
story_event场次关键剧情事件
primary_scene_id主场景资产(可空)
source_parse_run_idP3 解析运行来源
source_beat_keyP3 scene_beat 稳定键;与解析运行一起唯一
source_start_char / source_end_char原文区间

排序:

  • 场次顺序由 index 表示;
  • 镜头顺序仍由 shots.index 表示,且 (chapter_id,index) 全局唯一;
  • 跨场次移动镜头时,服务端在事务内重写章节内 index,不会让不同场次出现重复 index;
  • 场次内展示顺序使用全局 index 的升序过滤结果。

3. P3 场次建议与自动创建

来源:

  • 当前剧集对应 ScriptDocument(doc_type=episode);
  • 最近一次 completed/confirmed 的 P3 解析运行;
  • confirmed_result.episode.scene_beats,兼容 confirmed_result.scene_beats。

3.1 解析确认自动创建

POST /script-parse-runs/{id}/confirm 在落角色/场景/道具/服装后,按已接受的 scene_beats 自动补齐正式场次:

  1. 以 beat.index 作为剧集内场次序号;
  2. 已有同序号场次(人工创建或同一次解析已创建)直接复用,不覆盖人工内容;
  3. 缺失场次写入 scene_groups,source_parse_run_id / source_beat_key 记录来源;
  4. 主场景按地点名称精确/包含匹配项目场景资产,匹配不到时留空;
  5. 自动创建的场次记入 undo_snapshot.created.scene_groups,撤销解析时一并删除。

历史已确认、但在本规则上线前没有场次的解析结果,会在下一次分镜规划前按 confirmed_result.scene_beats 懒回填,避免继续出现“场次序号不存在”。

3.2 手工导入(兼容旧数据)

  1. 读取 suggestions,返回可编辑场次草稿;
  2. 用户可修改标题、地点、时间,移除建议项;
  3. POST /chapters/{id}/scene-groups/import 创建正式场次;
  4. 每条场次用 (chapter_id, source_parse_run_id, source_beat_key) 幂等;
  5. 重复导入同一解析结果只跳过,不覆盖已有人工修改;
  6. 新剧本版本只提示 script_version_changed,不自动覆盖场次;
  7. 已有手工场次但未关联当前解析时,建议接口返回重复导入警告。

主场景匹配只按地点/场景名称精确或包含匹配;匹配不到时保留空主场景并返回 warning。

4. API

方法路径说明
GET/POST/api/v1/studio/chapters/{id}/scene-groups列表/创建
GET/PATCH/DELETE/api/v1/studio/scene-groups/{gid}详情/修改/删除空场次
POST/api/v1/studio/chapters/{id}/scene-groups/reorder场次排序
GET/api/v1/studio/scene-groups/{gid}/shots场次镜头
POST/api/v1/studio/chapters/{id}/shots/reorder跨场次镜头移动/排序
GET/api/v1/studio/chapters/{id}/scene-group-suggestionsP3 场次建议
POST/api/v1/studio/chapters/{id}/scene-groups/import幂等导入

删除含镜头场次返回 409,要求先移动/删除镜头;不会级联删除视频或任务。

5. 历史数据与工作台

  • 存量镜头 scene_group_id 为空,继续可读、可编辑;
  • 树状工作台显示「未分配场次」,不会把历史镜头自动放进虚构场次;
  • 剧集节点 → 场次节点 → 镜头节点,镜头仍懒加载;
  • 场次/镜头排序变更后失效相关 Query 缓存;
  • 剧集列表与镜头面板在 V2 工作台展示场次分组;旧版分镜列表与镜头准备台只保留安全重定向。

6. 当前边界

  • 场次树不创建 P6 参考绑定;
  • 场次编辑不自动重排或删除镜头;
  • 镜头资产版本选择与 AI 分镜规划属于 C10,见 AI 分镜规划。