Huanyu-Hibiki /video-plan
两种模式
| 模式 | 输入 | 输出 | 用途 |
|---|---|---|---|
pre-production |
完整视频文稿 | 分镜表、storyboard.json、素材建议、音乐 cue、动效候选 |
指导拍摄、OBS 录制和前期素材准备 |
rough-cut-finalization |
Rough/rough_cut_manifest.md、missing_materials.md、实际时间码 |
motion_request_list.md、B-roll/动效执行请求 |
根据粗剪后的真实时间线确定真正要做的素材 |
前期分镜表
至少输出以下字段：
| 镜号 | 时间 | 画面 | 旁白要点 | 字幕/屏幕文字 | 剪辑/声音 | 拍摄形式 | 覆盖模式 |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| 01 | 0:00-0:08 | 人物特写，直接看镜头 | 核心问题 | 关键词 | 硬切开场，无铺垫 | 实拍 | A-only |
拍摄形式是路由字段，可使用：实拍、OBS 录像、Remotion 动效、HyperFrames、B-roll 动画设计、AI 图、AI 视频、Stock、实拍 + Remotion 动效、OBS 录像 + Remotion 动效。
覆盖模式声明该时间段的人物/素材同屏关系：A-only / B-only / AB-live（含布局：B-base-A-PiP、A-base-B-overlay、B-base-A-cutout、AB-split），规则见 shared-references/motion-brief-standards.md 第 6 节。
动效条目：导演简报（必做）
凡 拍摄形式 含 Remotion / HyperFrames / B-roll 动画设计的条目，规划时必须按 shared-references/motion-brief-standards.md 输出导演简报，写入 remotion_candidate_list.md：
- 先做输入分类：目标帧重构 / 概念文案 / 流程数据 / 稿转场景；
- 再按固定结构写简报（画面理解 / 核心视觉 / 推荐动作 / 趣味钩子 / 时间轴 / 图层拆分 / 微动与音效 / 负面约束 / 制作判断 / 时长规格 / 推荐引擎）；
- 时长按默认假设给初值（标题 4s、概念 4-6s、流程 5-8s），短动效按五相位（Establish/主动作/主内容/次级细节/Hold）交叠规划；
- 用户的"有冲击力""科技感""有梗"等说法按标准的自然语言翻译表转成动作因果描述；
- 同风格首批条目在简报中标注"待出三帧静图 + 3s 短样片确认风格"，确认前不批量实现；
- 同时在简报中给出素材组织约定（
MOTION-XXX编号、composition 命名、props 化内容、透明通道需求），对齐templates/storyboard.template.md的「Remotion / HyperFrames 素材组织」区。
规划阶段只写简报，不写生产代码、不渲染媒体；简报结尾声明"当前不执行制作"。
规划规则
- 按语义场景分段，不按
//机械切段； - 一镜一功能，避免一句话塞入多个互不相关的视觉命题；
- 保留用户的
【画面建议】，但区分用户意图和最终执行； - 主要观点、情绪和可信度优先分配给 A-roll；
- 真实工具操作、界面和流程优先规划 OBS；
- 抽象解释、架构、流程、数据再进入 Remotion 或 HyperFrames 候选；
- Stock 和 AI B-roll 用于环境、视觉桥接和不可拍摄概念，不为了"每句有画面"而添加；
- 动效时长先按默认假设给初值（标题 4s、概念 4-6s、流程 5-8s），不要一句口播塞多个主动作；
- 每个连续覆盖段内布局稳定，不为单条变化重设布局；不规划小于 2s 的无意义 A-only 回切碎片。
失败模式与恢复
| 触发条件 | 一线修复 | 仍失败兜底 |
|---|---|---|
| 终稿文件缺失或为空 | 询问用户提供路径；不猜测、不拿旧期文稿顶替 | 🔴 用户给不出终稿就停在本阶段，不产出空分镜 |
文稿没有 // 停顿标记 |
正常情况：本就按语义分段，不依赖 // |
无需兜底；禁止退化为按行机械切 |
| 文稿与实际拍摄/录制严重不符（口播大幅偏离） | 走 rough-cut-finalization 模式按实际转录重规划 |
分镜标记 superseded 并保留旧版，不覆盖 |
storyboard.json 与 storyboard.md 内容冲突 |
以 json 为真相源修正 md | 记录冲突原因，🔴 请用户确认哪版有效 |
| 用户要求跳过分镜直接要素材/B-roll | 拒绝并展示分镜缺失的具体风险（素材无路由依据、B-roll 无对账种子） | 坚持要求时只给 material_suggestion_doc.md 草稿，不进入 asset_request_list |
必须生成的交接
video scripts/storyboard.md；video scripts/storyboard.json，作为派生文件真相源；必须包含broll_candidates数组（分镜表中所有 B-roll 条目的结构化版本：镜号、旁白原句、视觉命题草稿、路由建议、覆盖模式、输入分类、简报引用、状态），供/b-roll-finder强制对账——见 templates/storyboard.template.md 的字段定义；video scripts/material_suggestion_doc.md；video scripts/remotion_candidate_list.md；video scripts/music_cue_sheet.json；assets/requests/asset_request_list.md；video scripts/feishu_storyboard_records.json（如项目需要 n8n 同步）。
执行说明
本阶段没有独立的“自动写稿脚本”：分镜拆解和 B-roll 路由需要模型读取终稿后生成，输出格式由 templates/storyboard.template.md 和 references/video-plan/output-template.md 约束。文件落盘由当前 Agent 的写入能力完成；这不是缺少实现，而是该阶段的执行方式。
粗剪后执行第二次规划时，必须丢弃已被实拍、OBS、Stock 或 Filmora 解决的候选，只保留实际缺失且值得制作的请求。
禁止
- 不按
//或换行机械切段，只按语义场景分； - 不把用户的【画面建议】当作最终执行决定，区分意图与执行；
- 不给每句话都分配画面或动效；
- 不在分镜确认前生成
asset_request_list.md触发下载； - 不覆盖已有
storyboard.json——修订走版本递增或superseded标记； - 不把抽象关键词直接落成「通用文字卡」类动效候选；
- 动效条目不写导演简报（或简报只罗列动画预设、没有动作因果）不得进入交接文件；
- 规划阶段不写生产代码、不渲染媒体——三帧静图与短样片属于风格确认闸门，确认前不批量实现。
结束状态
写入 approval_pending，等待用户确认分镜和素材路由；未确认前不启动大批量素材下载。