分镜页面职责边界

本文属于“当前架构”文档，描述当前推荐并正在落地的页面职责边界。

背景

随着 shot.status 收窄为：

• pending
• ready

并且 video-readiness 成为独立的生成准备度检查，分镜相关页面也需要明确区分：

• 哪一页负责准备
• 哪一页负责生成

如果这两层边界不清晰，页面很容易重新长成“两个都能做一点”的混合大页。

核心结论

当前推荐的页面分工是：

ChapterShotEditPage
  = 分镜准备页

ChapterStudio
  = 分镜生成工作台

也就是：

分镜编辑页
→ 提取、确认、修正

分镜工作室
→ 关键帧、参考图、视频参数、视频生成

ChapterShotEditPage 的职责

这页负责把单镜头准备到可进入生成阶段。

应保留为主流程的动作

• 提取并刷新候选
• 无需提取 / 恢复提取
• 资产候选：关联 / 新建 / 忽略
• 对白候选：接受 / 忽略 / 批量接受 / 批量忽略
• 单镜头基础信息修正
• AI 提取的镜头语言默认值确认
  • camera_shot
  • angle
  • movement
  • duration
• AI 提取的动作拍点候选确认
  • action_beats
  • 准备页会同时展示系统当前推断的阶段标签
    • trigger
    • peak
    • aftermath
  • 用于帮助判断首帧 / 关键帧 / 尾帧后续会如何消费这组动作拍点

这页的目标

完成：

• 资产候选确认
• 对白候选确认
• 镜头语言默认值主确认
• 动作拍点主确认
• skip_extraction 等准备决策
• shot.status = ready

其中需要特别区分两层语义：

• shot.status = ready
  • 只表示资产 / 对白等信息提取确认已经完成
• 准备页聚合态里的 ready_for_generation = true
  • 表示当前镜头已经同时补齐：
    • 标题与剧本摘录
    • 镜头语言默认值
    • 动作拍点
    • 提取确认结果

可以把这页理解成：

单镜头准备台 / 最终确认台

ChapterStudio 的职责

这页负责在章节内连续处理镜头的生成准备与执行。

应保留为主流程的动作

• 单镜头和批量 video-readiness
• 关键帧与参考图
• 视频提示词与生成参数
• 单镜头视频生成
• 批量生成前预检
• 批量生成
• 镜头语言微调
  • 允许对 camera_shot / angle / movement / duration 做快捷修正
  • 但仍然写回同一份 ShotDetail 真值，而不是任务级临时覆盖

这页的目标

回答：

• 当前镜头能不能生成视频
• 还差什么
• 应先补关键帧、参考图还是视频参数
• 一章内哪些镜头可以批量推进

可以把这页理解成：

章节内的生成工作台

哪些动作应从工作室降级

为了避免 ChapterStudio 重新变成“第二个编辑页”，下面这些动作应逐步从主流程中降级：

• 无需提取
• 候选忽略
• 对白接受 / 忽略
• 快速关联 / 新建

更推荐的方式是：

• 工作室里显示诊断结果
• 主动作统一变成：
  • 去分镜编辑确认
  • 去分镜编辑确认对白

两页之间的推荐主流程

ChapterShotEditPage
→ 提取与确认
→ shot.status = ready
→ 进入 ChapterStudio
→ 查看 video-readiness
→ 关键帧 / 参考图 / 视频参数
→ 生成视频

如果在 ChapterStudio 中发现：

• shot.status = pending
• video-readiness.extraction_ready = false

则应回流到：

ChapterShotEditPage

继续完成提取确认。

状态边界

为了让页面分工和后端状态一致，建议始终遵守下面这条规则：

• shot.status
  • 只表示信息提取确认状态
• video-readiness
  • 只表示视频生成前置条件是否满足
• runtime task
  • 只表示当前是否有运行中的生成任务

也就是说：

准备状态
≠
视频可生成状态
≠
生成中状态

这三者应分别展示，不应继续混进同一个字段或同一类提示里。