short-drama-storyboard

短剧分镜与冻结关键帧

把剧本和视觉事实转成有镜头职责、空间连续性和可冻结起点的 剧集/<EP>/分镜.md。 每镜使用二级标题 ## SHOT-...，同镜下用 ### 冻结关键帧提示词 写起始帧正文。

Quick Start

用 $short-drama-storyboard 完成 EP001 的正式分镜和每镜冻结关键帧

入口

当前剧本加必要视觉事实即可直接进入。资产图片提示词与分镜是兄弟分支，不互相等待。只有关键场次 真的存在多个成立导演方案时，才在上下文比较覆盖方案；普通场次直接设计。

创作者可读说明跟随项目语言；冻结关键帧的可复制正文跟随 short-drama.json#/format/prompt_language。没有 short-drama.json 时正文默认使用 en。 分配镜头时长前读取 short-drama.json#/creator_authority/production_profile/choices/native_duration_seconds。已声明目标模型但 没有原生时长时先补这一个选择；目标模型也未声明时照常按叙事节奏设计，不猜供应商限制。

冻结关键帧写完之前，谁会出现在这一格画面里还没有定下来。所以三条依据都在关键帧之后回填， 读的是成稿画面，不是镜头意图。

用户没有手工点名参考图，不等于选择文生视频。冻结关键帧后先根据本镜可见人物、地点、关键道具与 起始构图判断一致性需求，再检查项目中已有的真实图片。只有当前可读、内容与用途可核对的图片才能自动绑定； 文件名像某个角色但内容未核对时，仍视为未准备好。

项目里一张都没有时，创作者有三条路，一次把三条都说清楚再让他选，不要只给「先生成参考图」和 「改成文生视频」两个：把手上已有的图片放进项目再绑成 REF-...；在自己的工具里出图、本轮先用 PLAN-... 写出挂图计划；或者明确改走文生视频。用本套件的生产技能出图只是第一条路的一种做法， 需要项目外的 adapter 与凭据，不是唯一入口。

开始分镜前读 剧集/<EP>/剧本.md 的当前内容。创作者说「剧本已确认采用」指的是那个文件， 不是对话里更早的草稿；两者不一致时以文件为准，并把差异说出来。

工作流

1. 读取已接受的目标模型原生时长区间，再确认每个场景动作、对白、声音、画面文字和转折由哪些镜头承载。

2. 确定观众何时知道什么、对齐谁、空间如何揭示、转折落在哪个可见动作。 剧本或 Brief 用“前半段 / 后半段 / 前三分之一 / 最后 N 秒”等相对时间限定首次出现、释放或禁止时， 先用已接受集长换成明确时间边界再分镜；例如 60 秒作品的“后半段首次出现”不得早于 30 秒。

3. 每镜写清唯一职责、来源、时长、景别/机位、起点、唯一主要动作、终点和声音；用 起点 → 唯一动作 → 终点 直接说明人物、双手与持物怎样完成本镜状态转换。三条依据留到第 6 步。 有对白、VO 或 OS 时，先按原文和人物说话方式估算完整发声时间，再安排不能重叠的动作、停顿与 末尾反应；把估时依据简写在本镜「声音」里。具体做法见 对白估时。

4. 锁定人物朝向、位置、视线、持物、出入口、屏幕方向和必要状态；上游已有会限制动作空间的持续关系时，把关系投影进本镜起点与终点。

5. 冻结关键帧只投影镜头起点；删除终点才出现的文字、动作、姿态或道具状态。

6. 关键帧成稿后，先从成稿正文读出这一格里需要保持身份、造型或地理的人物、地点和道具， 再用同一份清单一次填满三条依据：

   • 视觉依据：清单里每一项写成《视觉设定.md》的条目引用，这是必写字段；
   • 图片提示词项：清单里已有合适 IMG-... 条目的写上，没有的留「无」；
   • 输入参考图：按清单在用户提供的输入、剧集/<EP>/制作成果/ 和文档已指向的其他可见媒体中查找匹配图片； 命中就写入 REF-...。一张都没命中时写「无（待补参考图：<本镜缺失的起始帧、人物、地点、道具>）」； 只命中一部分时，在已有 REF-... 后追加「；待补参考图：<仍缺的图片>」，缺口之间只用 、 分隔。 创作者说图片由他自己在别处准备时，把这份清单写成 PLAN-... 槽位，本镜即告就绪； 只有创作者明确表示不用图时，才写「无（创作者已明确选择文生视频）」。

   三条依据读的是同一格画面，所以不能互相矛盾：关键帧里点名的人物或道具，一定出现在视觉依据里。

7. 整集请求完成整集，末端一次报告覆盖、节奏和真实未决选择。