AI 营销视频 产品 PRD

状态：review-passed（CR-20260823-001 规格、原型、真实浏览器主链与交付文档已同步；Freddy 已验收当前原型并于 2026-08-24 授权正式发布）

产品 PRD 版本：3.0

当前变更：CR-20260823-001

交付包：prd-package.json

边界：项目交付完成不等于真实转化效果已验证；真实效果必须通过受控投放试验判断

0. 初始化动作与输出策略

0.0C 本次增量裁决（CR-20260823-001）

• 快速生成保持 CR-20260818-001 以后已经确认的输入、脚本确认、共享生成配置、后台制作和成片修改链路不变。
• 分镜创作生成脚本后默认进入分镜列表；自由图谱画布改为用户主动选择的复杂创作视图。专业能力以控制范围和可追溯性体现，不要求用户先理解节点拓扑才能完成逐镜制作。
• 进入创作画布时只展开当前分镜、商品素材和当前任务/结果链，并自动适应可视区域；其余元素留在工作空间元素库按需调用。
• 同一动作只保留一个稳定入口。视图栏负责列表/画布切换与元素库，画布工具负责选择、平移、缩放和适应屏幕，节点上下文负责自由生图/图生视频，图片结果直接提供“用于当前分镜”。无响应的历史、复制、下载和更多控件不得保留。
• 本轮只改变专业模式信息架构和画布交互，不改变对象、Prompt、事实/权利/合规门禁、版本不可变规则、模型能力注册或付费确认边界。
• 01–08 已完成开发交付增量答卷；总控以当前 codex/ai-marketing-video worktree 的 v3.0/0.7-candidate 为唯一整合基线。开发阅读入口见 developer-handoff.md，六类模板 Prompt 模块见 prompts/storyboard-template-modules.md；领域任务从旧 main 看到的 v2.5/0.6 视图不进入当前交付事实。

0.0B 本次增量裁决（CR-20260821-001）

• 快速生成保持 CR-20260818-001 的输入、脚本确认、生成配置、后台制作与成片修改链路不变；本轮不向快速生成加入画布、元素库或图片模型概念。
• 分镜创作默认进入自由图谱画布；原“分镜列表”降为辅助查看入口。素材、生成任务、图片结果、视频结果与分镜都是可选择、可连接的节点，用户从任一节点右侧动作入口继续创建下一条分支。
• 建立工作空间级统一元素库，首期只在当前工作空间共享商品、人物、场景、道具和风格参考；不同时建设个人库、团队库、公共市场或跨租户共享。
• 画布内的图片生成采用独立“自由生图”任务：用户写图片描述，可引用元素、商品图或已有图片版本，选择候选图片模型与基础输出参数。结果生成新的 ImageVersion，由用户明确绑定到元素图、分镜参考、首帧或尾帧。
• 自由生图不调用图片工坊 Prompt 2.0、Listing 图片角色、套图 Visual Plan、套图总导演或图片工坊复杂编辑；图片工坊继续作为独立产品，不属于本次视频专业画布运行链。
• 首帧/尾帧是否可执行由所选视频模型的能力注册决定。能力只支持参考图或只支持首帧时，前端明确提示并禁用不支持用途，不把尾帧要求偷偷改写成 Prompt，也不宣称精确锁帧。
• 画布不自动诊断画面质量、不替用户提出修改意见、不自动创建图片或视频重试。系统只执行事实、权利、合规、输入有效性与供应商能力等硬门禁；是否继续生成、选择哪个图片版本和是否重做由用户决定。

0.0A 本次增量裁决（CR-20260817-001）

• 快速生成和分镜创作继续是两套工作流。两者在生成前共用同一套已登记视频模型和 OutputProfile 选择，切换时保留；分镜创作再额外开放逐镜旁白、字幕、画面提示词、首尾帧和版本控制。
• AI 视频导演 Agent 先生成结构化导演计划，再由编译器分别产出无字画面的视觉执行 Prompt、旁白任务和字幕任务。不得把商品信息、模板规则和所有约束机械拼接成一条不断增长的供应商 Prompt。
• 视觉模型只负责无文字画面，禁止要求其直接绘制中文字幕。字幕的权威文本来自用户确认的中文旁白/字幕文案，通过独立的 TTS、打轴、SRT/VTT 和确定性渲染链生成。
• 字幕默认开启并在快速生成配置中可关闭。修改字幕只创建新的字幕轨与合成版本，不重做镜头；是否同时开放 SRT/VTT 下载、cue 时码编辑、字体和多语言能力仍取决于媒体 POC。
• 质检只定位、分级并建议动作。创意、连续性或画面软问题由用户选择继续使用、整片生成新版本或在分镜创作中指定镜头重生成；任何可能付费的生成动作必须再次确认，系统不得自动创建。事实、权利、合规和字幕技术 P0 仍阻断交付。
• 本节覆盖本文中 CR-20260814-002/004/005/006 的“本轮不生成字幕”和“系统只重试失败镜头”等旧范围描述；历史变更记录保留，但不再是当前合同。

0.0 最终验收与文档组成（CR-20260814-005）

• Freddy 已于 2026-08-14 明确表示当前原型满意并授权继续文档收口，该结论构成最终原型验收，不等于真实模型、计费、媒体服务或转化效果已验证。
• 本 PRD 按 segments/01-定位范围与对象.md、02-流程状态与异常.md、03-功能交互与权限.md、04-质量数据验收与风险.md 四段编写和复核，本文是最终整合后的唯一权威产品 PRD。
• 端到端、异常恢复、版本和投放学习流程见 flows.md；模块 Prompt 契约见 prompts/。
• CR-20260814-004 的已验收界面规则优先于早期方案：快速生成右侧只展示一份可编辑脚本，不恢复复杂蓝图、视频创作依据、教学卡、模式说明表或重复配置；这些后台约束仍必须执行。
• CR-20260814-006 明确：六类业务模板只选择对应的“分镜生成 Prompt 模块”和叙事职责，不预写镜头数、镜头时段或固定脚本。大模型必须结合目标总时长、商品事实、可用素材、平台/品牌规则和已登记模型能力动态生成完整脚本与连续时间轴。

0.1 事实、证据与决策分层

1. 背景与目标

1.1 业务问题

1.2 假设前提

1.2.1 CR-20260812-005 事实型媒体边界

本轮推荐生产链路为：媒体探测并统一编码参数 → 按 shot_id 与时间轴拼接/转场 → 从用户确认中文母稿创建 TTS → 自动打轴并生成 SRT/VTT → 字形、断行、安全区与时间轴检查 → 混音和字幕渲染 → ASR/OCR 只做差异复核 → 输出新的合成版本。视觉模型不得直接生成文字。上述证据只证明架构可行，不证明本项目已经接入；FFmpeg/libass 或等价媒体服务、TTS、打轴、字体授权、SLA 和成本均须在 POC 后确认。

1.3 目标与成功标准

2. 用户与场景

2.1 目标用户

2.2 用户故事 / JTBD

2.3 典型场景

3. 产品方案

3.1 核心价值主张

3.2 全局一致性锚点

3.3 MVP 范围

3.4 核心流程

flowchart LR
  A["输入或带入 SKU"] --> B{"租户与店铺内唯一匹配?"}
  B -- "否" --> C["最多一个阻塞问题"]
  C --> B
  B -- "是" --> D["冻结商品事实与素材权利快照"]
  D --> D1["用户批量上传商品图片，选择新手/专业模式与视频内容模板"]
  D1 --> E{"存在事实或合规硬阻断?"}
  E -- "是" --> F["说明缺口并停止生成"]
  E -- "否" --> G["AI 选择内部 Skill 并生成方案候选"]
  G --> H["AI 按模板或自定义方向生成分镜脚本"]
  H --> I["用户逐镜查看并可修改旁白脚本与镜头提示词"]
  I --> J["确认后按镜头生成对应时段片段"]
  J --> J1["片段可独立修改与重做；全部可用后合并成片"]
  J1 --> K["六层质量检查"]
  K --> L{"存在阻断问题?"}
  L -- "是" --> M["查看片段；修改提示词/参考后重生成受影响镜头"]
  M --> K
  L -- "否" --> N["在同一工作台确认交付；版本与受控变体渐进披露"]
  N --> O["绑定投放单元并回流可比数据"]

3.5 方案评测量表（冻结）

4. 功能范围

4.1 页面与业务表面

4.2 本期功能

4.3 非本期范围

5. 功能设计与业务规则

5.1 SKU 解析与商品事实快照

5.1.1 功能定义

5.1.1.1 外部 API 对接与字段映射

5.1.2 字段取值逻辑

5.1.3 交互说明

5.1.4 功能阐述

5.1.5 逆向流程搭建

5.1.6 功能权限清单

5.1.7 上线前历史数据处理

5.2 AI 方案、脚本与分镜

5.2.0 双模式输入、内容模板与新手对话修改（CR-20260814-002）

• 新手与专业模式使用相同的商品输入基线：输入 SKU、补充商品信息并批量上传 1–9 张本商品图片。图片不要求用户选择主图/细节/场景/营销/包装等类型；系统可在后台识别用途，但不得把识别结果变成上传前置。
• SKU 在用户输入停止后自动查询同租户、店铺和 SKU 命名空间内的历史 AI 视频。有记录时弹窗展示缩略图、版本、时间和规格，用户可直接复用或仍然新建；无记录时不打断后续创建。真实查询接口、权限过滤和分页字段在联调前保持未确认。
• 新手模式在商品信息后提供六类视频内容模板：产品展示、UGC 种草、痛点解决、开箱测评、场景证明和功能对比。系统默认选中带“AI 推荐”的最适合模板，用户只需在模板间做一次业务选择；新手仍不要求选择模型、分辨率、首尾帧或编辑 Prompt。专业模式继续保留模板/自定义、模型和完整逐镜控制。
• 主操作为“生成 AI 商品视频”。一次提交后，由编排服务在后台依次生成结构化方案、ShotPlan、逐镜 ShotAttempt、旁白/声音、合成清单与质量报告，前台只展示总进度和最终成片。
• 快速生成与分镜创作默认 subtitleEnabled=true，用户可在生成前关闭。开启时，字幕文案必须显式存在并与旁白母稿同源；视觉模型只生成无字画面，字幕通过独立 SubtitleTrackVersion 与 CompositionVersion 合成。字幕链能力仍待 POC，不得宣称 Seedance 或其他视频模型能稳定生成正确中文字形。
• “一次生成”是前台交互承诺，不是“单个视频模型一次稳定生成整支营销视频”的能力承诺。镜头生成失败或质检发现软问题时，系统保留所有已有结果并展示影响；由用户选择继续使用、整片生成新版本或进入分镜创作指定镜头重生成，确认前不得创建付费任务。
• 参考视频仅接受 MP4 或 MOV 且媒体时长不得超过 15 秒；客户端必须读取容器元数据校验时长，服务端仍需重复校验。它只用于提取节奏、镜头、构图与风格特征，不得覆盖 ProductFactSnapshot，也不得被当作商品事实或素材权利证明。
• 新手成片不展示重复的“AI 已完成哪些步骤”说明，也不提供结果区“进入专业模式编辑”按钮。修改入口固定为文本对话：用户说明修改目标，系统生成新版本并保留旧版本；模式切换仍可从页面顶部完成。
• 新手“历史”打开可操作抽屉并允许查看/复用历史结果，不得使用无交互的装饰入口。
• AI 视频产品的左侧工具导航只保留“AI 视频”入口；新手/专业是同一作品内的创作模式，不拆成灵感、图转视频、复刻、编辑、剪辑等未独立验收的伪入口。

5.2.0A 快速生成蓝图确认、创作依据与修改影响计划（CR-20260814-003）

• 原“新手模式 / 专业模式”改名为“快速生成 / 分镜创作”。两者不是参数多少的差异：快速生成遵循“商品与方向 → AI 视频蓝图 → 用户确认 → 后台生成成片”，分镜创作遵循“商品与方向 → 生成全部分镜脚本 → 逐镜编辑/生成 → 合并成片”。
• 模式切换前端必须说明流程、可控制内容、生成前确认项和状态保留规则；切换只改变当前工作表面，不清空 SKU、商品信息、商品图片、参考视频、模板、OutputProfile、已生成蓝图、分镜尝试、成片或版本记录。
• 快速生成不得在模板选择后直接启动视频模型。主操作先生成 VideoBlueprint，蓝图至少包含：核心卖点及来源、视频结构、镜头数、逐镜表达、OutputProfile 摘要、使用素材、证据不足与 AI 待补全内容。只有用户确认蓝图后，编排层才能创建真实视频生成任务。
• 快速生成与分镜创作在左侧共用“本次生成配置”：已登记视频模型、成片时长、分辨率、比例、目标国家/地区、目标语言、声音和字幕。两种模式只保留一份选择状态，不展示 Prompt、seed、采样器、供应商密钥或高级路由；字幕默认生成且可关闭。
• 六类内容模板必须补充适用营销目标、所需素材、预期结构、人物/场景生成要求、代表性效果预览和事实/素材风险。AI 推荐必须展示可核对的推荐理由，不得仅给“AI 推荐”标签。
• “商品事实、商品信息、商品图片”合并为统一的“视频创作依据”。前端按系统核验事实、用户补充、商品图片/参考素材、平台/地区/品牌约束、AI 推测/待生成内容分组，并为每项展示来源和可信状态；未经核验的用户输入或 AI 推测不得升级为商品事实。
• 快速生成开始后进入独立制作进度/作品工作台，不长期与完整创建表单并排；生成中展示后台真实阶段并允许离开页面。失败时保留成功结果，显示可继续动作，但不自动重试付费生成。完成后显示成片、字幕状态、版本和自然语言修改入口。
• 自然语言修改先创建 RevisionImpactPlan，展示受影响镜头、保留内容、需要重生成内容、是否重新合成、预计耗时/消耗和新版本号。用户确认后才执行；默认保留当前成片并创建父子版本，不覆盖历史版本。
• 常用桌面宽度不得出现关键内容横向裁切。创建阶段以输入与蓝图为主；窄桌面将其改为上下布局。生成中和完成态使用单一全宽工作台。

5.2.0B 快速生成脚本确认的界面收敛（CR-20260814-004）

• 快速生成的用户确认对象由复杂的多区块蓝图收敛为一份 EditableVideoScript。AI 仍在后台生成结构化 VideoBlueprint、事实引用、镜头计划和执行约束，但主界面只把已编排的完整视频脚本放入可编辑文本框。
• 左侧只保留完成任务所需输入：模式切换、SKU、商品图片、商品信息、内容模板、参考视频和“本次生成配置”。配置包含已登记视频模型、时长、分辨率、比例、目标国家/地区、语言、声音和字幕开关，不得在右侧重复显示。
• 主界面移除“视频创作依据”、快速生成教学卡和模式差异说明表；这些内容不再占用创作空间。移除仅影响呈现，ProductFactSnapshot、来源、可信状态、平台/品牌约束和 AI 假设标记继续由后端编排与质量门禁使用。
• 右侧脚本确认区只展示轻量步骤、脚本标题、可编辑的 AI 视频脚本和一个确认主操作。脚本应一次性包含镜头顺序、时段、画面、旁白/声音与收束动作；用户可直接改写，不需要分别编辑卖点卡、素材卡或证据缺口卡。
• 用户点击“确认脚本并开始生成”前不得创建视频模型任务。确认时服务端仍需把用户修改后的脚本重新解析为镜头计划，并再次执行事实、合规、素材权利、平台和可执行性校验；硬阻断不得因为界面简化而跳过。
• “快速生成 / 分镜创作”切换继续保留商品、素材、配置、AI 脚本、分镜结果、成片和版本；界面不再用四行说明解释该规则，但切换反馈必须明确“内容已保留”。

5.2.0C 模板分镜 Prompt 与动态时间轴（CR-20260814-006）

• 六类模板不携带预写脚本、固定镜头数、固定镜头时段或固定秒数。模板只绑定可版本化的 storyboard_prompt_module，定义营销目标、叙事职责、证据要求、风险红线和允许变化项；编排层把该模块与本次上下文共同编译后传给大模型。
• 编译输入至少包含：template_id、storyboard_prompt_module_id/version、target_duration_sec、ProductFactSnapshot、已授权 asset_refs、可选参考视频的节奏特征、OutputProfile、平台/市场/品类规则版本、品牌/合规规则版本、已登记模型 capability_profile、用户补充方向和逐镜覆盖。模板经验必须带平台/市场/品类适用范围与版本，不得写成普遍真理。
• AI 视频导演 Agent 基于目标总时长、叙事复杂度、可用证据、素材数量和能力限制动态决定镜头数、镜头顺序、每镜头时长、画面、中文旁白与字幕文案。时间轴必须从 0 开始、连续、不重叠，所有镜头时长之和等于 target_duration_sec；不得为了套用模板保留无业务目的的镜头。
• 每镜头只承担一个主要业务目的和一个主要画面动作，输出 shot_id、开始/结束时间、业务目的、画面内容、可编辑旁白/字幕、可编辑 visual_execution_prompt、不可覆盖 protected_constraints、商品图片/首尾帧引用、技术要求、事实引用、素材风险和能力要求。视觉 Prompt 必须禁止新增任何可读文字；字幕由独立轨合成。
• 当目标时长不足以容纳模板必须职责、缺少关键证据/素材，或能力注册无法执行所需镜头时，返回一个可操作的 blocking_issue，不得硬塞镜头、压缩到不可理解或虚构素材。用户修改总时长、模板、素材或事实后，必须重新编译并重算完整时间轴；已确认执行快照不被原地覆盖。

• AI 推荐只输出一个默认模板，并以“营销目标匹配、事实证据完整度、素材可执行性、人物/场景权利、能力适配”解释原因；最多展示两个次级备选供用户主动切换。推荐不显示伪精确转化分数，也不承诺生成质量或真实投放效果。

5.2.0D 专业创作画布、统一元素库与自由生图（CR-20260821-001）

专业模式主表面

• 分镜脚本生成完成后，专业模式默认进入分镜列表；列表负责镜头顺序、脚本、提示词、模型、首尾帧、生成状态、版本和合并等主任务。自由图谱画布是用户主动切换的可选创作视图，用于处理素材关系、自由生图和多版本分支，不作为理解分镜流程的前置门槛。
• “分镜列表 / 创作画布”读取同一工程状态并显式切换。切换不得复制工程、重建分镜或丢失任务输入、结果、绑定和版本；进入画布时自动聚焦当前分镜及其直接引用链路。
• ASSET / GENERATION_TASK / IMAGE_RESULT / VIDEO_RESULT / SHOT / NOTE 都是一级画布节点。节点左右连接点表达显式输入与输出依赖；用户选中节点后，从右侧 + 打开与节点类型匹配的上下文动作，例如上传、从元素库加载、自由生图、图生视频或继续创建版本。
• 图片或视频任务本身以画布卡片承载。任务卡直接编辑 Prompt、@节点 引用、模型和基础输出参数；提交后在原位显示真实任务状态，成功结果以新节点回填在任务右侧并保留连线、输入快照和父版本。
• 画布首屏只展开“当前分镜 + 直接引用素材 + 当前任务/结果”；其他人物、场景、道具和风格元素通过元素库按需加入。全局工具只保留选择、平移、缩放与适应屏幕；上传、自由生图、图生视频和用途绑定放在唯一、可见的上下文位置，避免同一动作同时出现在顶部、底部和节点菜单。
• 用户可以从任意成功结果继续分支，不覆盖父节点。图片结果必须直接展示“用于当前分镜”等明确采用动作；关键采用能力不得只隐藏在无标签的 + 菜单中。
• 画布不提供逐帧时间线、图层/蒙版或节点编程。它可以组织生成关系，但不能绕过事实、权利、合规、供应商能力或付费确认门禁。

统一元素库

• 首期元素类型为 PRODUCT / PERSON / SCENE / PROP / STYLE_REFERENCE。每个元素包含稳定 elementId、名称、类型、当前 elementVersionId、来源、权利状态、预览和被哪些镜头引用。
• 商品元素由当前 SKU 和商品事实约束，不允许自由生图结果覆盖商品身份；人物、场景、道具和风格参考可由用户上传或自由生图创建版本。元素库作用域固定为当前工作空间，成员权限沿用工作空间的查看/编辑权限。
• “替换元素版本”只改变用户确认的镜头引用并创建差异记录，不批量静默替换全部镜头。跨项目复用时固定引用的元素版本，元素后续更新不回写已确认视频版本。

画布生成任务

• 自由生图入口统一为一个 ImageGenerationTask，可从元素、分镜、首帧/尾帧占位或已有图片版本的右侧 + 发起。入口在源节点旁创建任务卡并预填引用，不跳转 Modal，也不分裂为四套页面流程。
• 用户可编辑字段仅包含：图片描述、引用的元素/商品图/已有图片、已登记候选图片模型、比例、分辨率和生成数量。系统附加不可删除的商品身份、事实、素材权利、平台和安全约束；不拼接图片工坊的 Listing 角色、套图布局或 Visual Plan。
• 任务状态为 DRAFT / GENERATING / SUCCEEDED / FAILED / CAPABILITY_BLOCKED / SOURCE_INVALID / FORBIDDEN。失败保留输入和已成功版本，由用户选择再次生成；系统不自动分析画面质量、不推荐重试参数、不自动扣费。
• 每次成功生成一个或多个不可变 ImageVersion，结果节点出现在任务右侧并记录父版本、用户 Prompt、@节点 引用、模型与参数快照、任务回执和创建人。已有图片再创作仍创建子分支，不覆盖原图。
• 图生视频使用同一画布语法创建 ShotAttempt 任务卡：用户选择源图片/元素、编辑画面 Prompt、视频模型、时长、比例与受支持的首尾帧输入，生成成功后创建 VideoResult 节点。是否采用为当前分镜由用户明确选择。

用途绑定与能力门禁

• 图片结果默认只是候选资产。用户必须选择“保存为元素版本 / 用作分镜参考 / 用作首帧 / 用作尾帧”之一才创建 ImageUsageBinding；解绑不删除图片版本。
• 绑定首帧或尾帧时，前端先读取当前视频模型能力。REFERENCE_ONLY 只允许分镜参考；FIRST_FRAME 允许参考和首帧；FIRST_AND_LAST_FRAME 才允许尾帧。能力未知时不默认支持，显示“待能力确认”。
• 图片绑定随 ShotAttempt 冻结：草稿可换，开始生成后只读；创建新 ShotAttempt 时可继承后再替换，不回写父版本。自由生图任务本身不触发视频生成或合并。

明确排除

• 不提供“进入图片工坊编辑”、套图模板、画布内图层/蒙版/笔刷、商品图 Listing 合规评分、公共素材市场、多人实时光标、自动质量建议或自动重试。
• 本期原型只证明对象、状态和交互可闭环，不证明任一图片模型的真实一致性、首尾帧控制、成本或 SLA；生产接入前须完成能力与费用 POC。

5.2.1 功能定义

5.2.1.1 外部 API 对接与字段映射

5.2.2 字段取值逻辑

5.2.3 交互说明

5.2.4 功能阐述

5.2.5 逆向流程搭建

5.2.6 功能权限清单

5.2.7 上线前历史数据处理

5.3 镜头生成、模型路由与成本

5.3.1 功能定义

5.3.1.1 外部 API 对接与字段映射

5.3.2 字段取值逻辑

5.3.3 交互说明

5.3.4 功能阐述

5.3.5 逆向流程搭建

5.3.6 功能权限清单

5.3.7 上线前历史数据处理

5.4 六层质检、修复与版本

5.4.1 功能定义

5.4.1.1 外部 API 对接与字段映射

5.4.2 字段取值逻辑

5.4.3 六层门禁

5.4.4 交互说明

5.4.5 功能阐述

5.4.6 逆向流程搭建

5.4.7 功能权限清单

5.4.8 上线前历史数据处理

5.5 模板、受控变体与协作

5.5.1 功能定义

5.5.1.1 外部 API 对接与字段映射

5.5.2 字段取值逻辑

5.5.3 交互说明

5.5.4 功能阐述

5.5.5 逆向流程搭建

5.5.6 功能权限清单

5.5.7 上线前历史数据处理

5.6 交付、投放回流与学习

5.6.1 功能定义

5.6.1.1 外部 API 对接与字段映射

5.6.2 字段取值逻辑

5.6.3 交互说明

5.6.4 功能阐述

5.6.5 逆向流程搭建

5.6.6 功能权限清单

5.6.7 上线前历史数据处理

6. 数据与口径

6.1 核心对象

6.2 项目状态机

6.3 指标与归因口径

7. 权限、状态与异常

7.1 权限矩阵

7.2 错误与恢复

8. 前端功能限制

9. 业务验收标准

10. 风险与未决问题

10.1 风险清单

10.2 非阻塞技术核验项

10.3 被否决方案

10.4 最终完成边界