Novel Storyboard

输入与创作权限

先读用户实际材料与目标，复用已确定的事实和规格；已有剧本、资产或分镜直接进入相关工作，不为流程完整重写上游。未授权的删线、合人、改变人物身份、主题、结局或重要表演意图，先展示原位置、具体方案与得失，再由用户选择；已授权的局部修正直接完成。

下面的类型经验、批次和创作预算是适配起点，不是用户接受过的创作要求。旧校验器可能仍将部分经验规则报为失败：区分实际数据/引用/模型接口错误与创作建议，说明不适用项，保留原稿；不伪造字段、不静默改戏或降低技术投产要求。总控可用时参考其 references/creative-agreement.md；独立任务按本段处理，不强制依赖总控。

novel-storyboard

给 AI 短剧出分镜——管线里第一个直接面对视频模型的层。每个新增镜头都会增加参考准备、生成筛选、连续性与后期工作。先保持导演的观看逻辑与可剪性，再适配当前工具的单段上限（默认 15 秒），不为凑切点增加无意义镜头。

核心机制：镜头认领节拍。 每个镜头声明它覆盖剧本某场的哪几个连续节拍（sceneIndex + beats: [起, 止]），镜头不许跨场次——换景必换镜。这让分镜和剧本的关系变成可机械对账的：

{baseDir} = 本文件所在目录。脚本 {baseDir}/scripts/novel-storyboard.mjs，零依赖，node 直接跑。

边界（不做的事）：不写戏不改台词（novel-script 的活）、不出场景/角色/道具设定图（novel-art / novel-characters 的活）、不自行发明或内化 H3 官方格式、不做剪辑合成。视频生成是可选投产步骤，只有用户明确要求并授权 API 成本后才执行。口型/唇形同步暂不管。

Step 0 — 定输入与范围

已有剧本可先做导演与分镜讨论，不要求先改写大纲。使用本工具 validate/render/export 时需要结构化 script.json 和 --script；先忠实映射原稿，保留对白、事件与已有拍法，无法承载的意图另附交接说明。其余上游按有则用：

• --outline / --cast：提示词禁人名检查 + 报告里 C01 显示成人名
• --art：报告里 S01 显示成场景名 + 批次单嵌场景设定图

已有导演包时，先继承其镜头目的、顺序、画幅、节拍与连续性；技术调整保留来源和偏差。总控选择导演桥接路线时不再重复本流程。

一次切几集：跟剧本的批次走（剧本写到哪就分到哪），默认一批 ≤ 3 集。

Step 1 — seed 工作底稿

node {baseDir}/scripts/novel-storyboard.mjs seed <script.json> --eps 1-3 > <workdir>/storyboard.json

确定性展开：每场的节拍清单（编号、动作/台词、每拍秒数、说话人）进 seedScenes，这就是切镜时的工作底稿。每拍秒数是上游估时基线；导演可依据围读、表演和镜头可读性调整，记录变化并复核总时长。 shots 留空，切镜才是模型的活。

Step 2 — 逐集分段切镜

每集一份任务，能并发就并发。每份任务拿到：

• {baseDir}/references/storyboard-pass.md 和 {baseDir}/references/schema.md（读它们，照着做）
• 该集的 seedScenes 底稿 + 场景卡（art.json 的锚点与光照提示词）+ 角色卡（cast.json 的形象要点）

流程：先按剧情单元分段（每段 9–15 秒、不跨场），普通叙事切 2–5 秒；一眼可读、无精确文字的 insert/full-frame-content 可短至 minInformationCutSeconds（默认 1.2 秒）。每切写一条分镜图提示词。一个源节拍只由一个 cut 的 beats 主要认领；补充信息、主观内容或反应覆盖使用 coverageOf，不能为了多一个镜头而重复认领同一节拍。

此阶段只固定镜头事实、frame、姿态连续性、关键信息展示策略和参考素材需求；不要冻结最终 h3Prompt。可以临时留空，直到候选素材完成验收。

先写明 generationMode：h3-t2va、h3-i2va、h3-fl2va、h3-l2va 或 h3-ref2va。Ref2VA 必须同时写 referenceMode: "multi-reference" 和显式 references；提示词采用 subject_definitions → summary → retention_analysis → detailed_description → overall_soundscape → non_diegetic_music 六段式。参考图按职责选择身份、场景拓扑、关键道具、内容素材，动作/构图图仅在无法靠文字稳定说明且自身完全正确时使用。若候选构图图存在多手、手别、支撑点、姿势或轴线错误，设置 referenceControlMode: "semantic-assets"，只喂干净人物/环境/道具/内容资产，由提示词负责姿态、方位和镜头调度。I2VA/FL2VA/L2VA 才能声明首帧/尾帧并使用官方关键帧对齐句。[Shot k] 切点仍由分镜秒数推导并逐字核对；每切的运镜、动作、光线、表演和声音落在自己的时间窗。

切完把 seedScenes 删掉。

提速不等于成片倍速。技术分镜继承导演 pacingPlan：优先压缩已读懂的建立、重复信息和动作尾巴，保护关键内容最低可读时间与转折后的反应。总时长变化超过 15% 必须记录并审批导演偏差；分镜不得静默改变节奏意图。

Step 3 — 方案检查（最终校验在素材与提示词完成后）

素材未生成、h3Prompt 仍为空时，先人工对账节拍覆盖、台词承载、轴线、时长与资产需求。可用 checkup 列诊断，但提示词/参考验收缺失属于未完成项，不能声称最终校验通过，也不能伪填 approved 或假提示词只为过门。现有 validate 是完整交付校验，没有草稿放行模式。

Step 4 — 出分镜图（可选）

按项目画幅逐切准备构图规划图；只有选用关键帧模式时才称首/尾帧，走 codex 内置 $imagegen，读 {baseDir}/references/frame.md 照契约做。要点：

• 没有 codex 就整步跳过，只交提示词，报告显示占位不装有
• 参考图按职责而不是按数量选择：默认优先干净的人物身份、场景全局方位/拓扑、关键道具和内容资产。动作/构图参考是高风险可选项，只有肢体、支撑点、持物手、屏幕方向和空间轴线全部正确才可使用。相近的人脸特写、同角度重复图和互相冲突的手别/服装不得进入 Ref2VA；必要时改用 semantic-assets，让提示词调度镜头
• 一格一次调用绝不批量；输出 ./<段号>/f<切序>.png（f1 = 主分镜图，每段一个文件夹）
• 默认先出第一段的整套分镜图给用户看效果（3–5 张），确认画风和正反打构图再往后补——一集约 30–40 格，错了浪费的是整批
• 候选图先做资产 QC：人物身份、场景拓扑、躺/坐/站、身体支撑点、持物手、屏幕方向和关键信息占比逐项检查。画面裁掉了证明姿态所需的接触点，就不能因为“看起来好看”而通过
• 手机/电脑/文件承载剧情关键信息时，按 information.displayStrategy 生成插入镜头、全屏内容素材或可跟踪屏幕；精确文字走后期合成
• 单个失败跳过不阻断，最后汇总说明

Step 4.5 — 素材验收后写最终 H3 提示词

只有候选素材的真实文件、顺序、职责与 QC 状态已确定，才写每段最终 h3Prompt。必须同时使用 MiniMax 官方 h3-prompt-writing skill，并完整读取当前模式参考。{baseDir}/references/h3-prompt.md 只负责输入映射和质量门衔接。

Ref2VA 把审核通过的参考写入显式 references；设置 referenceQcRequired: true 时，每项还要列出 requiredChecks、checks 和 reviewStatus: approved。最终提示词必须描述真实图片里存在的姿态和构图，不能用文字强行纠正一张已经错误的参考图。