video-create/.claude/skills/video-from-script/references/manifest-schema.md

manifest.json 规范

pipeline.js init 创建，Pipeline 执行，Agent 审查。

禁止 AI 手写 manifest.json，必须通过 pipeline.js init 初始化。脚本从 account.json 自动继承结构字段，AI 只提供创意内容（items 的 text/imagePrompt/videoPrompt/keyword）。

---

创建方式

# AI 生成创意内容后，通过脚本初始化
node pipeline.js init --account military --mode single \
  --items '[{"text":"中文文案","imagePrompt":"English prompt","videoPrompt":"motion prompt","keyword":"关键词","keywordColor":"#FF6B35"}]'

# 或从文件读取
node pipeline.js init --account military --mode single --items-file ./items.json

# 校验已有 manifest
node pipeline.js validate --manifest <path>

---

顶层字段

字段	说明	来源	谁填充
account	账号 ID	account.json	init 自动
imageModel	gemini / mj	account.json	init 自动
videoModel	veo3-fast / grok-video-3 等	account.json	init 自动
format	画幅：9:16 / 16:9	account.json	init 自动
mode	single 单图 / framePair 首尾帧	CLI 参数	init 自动
references	参考图数组，从 account.json styles.*.references 搬入	account.json	init 自动
items	素材数组（AI 提供创意内容）	CLI --items	AI → init

init 自动继承的字段不需要 AI 关心，不会出错。

---

references 字段

从 account.json 搬入，pipeline 直接使用，不再回读 account.json。

• Gemini → 读 file（本地路径，图生图用）
• MJ → 读 url（公网 URL，--sref 用）

---

items[] 字段

Agent 写入（创建时）

字段	说明
status	固定写 "pending"
text	中文字幕文案
imagePrompt	英文画面描述（给 Gemini/MJ）
videoPrompt	英文运动描述（给 Grok/VEO），描述镜头运动而非内容
keyword	字幕高亮关键词
keywordColor	高亮颜色

Pipeline 回写（执行后）

字段	说明	写入阶段
status	pending → generating → done / failed	images
file	生成的图片路径（相对 manifest）	images
candidates	MJ 拆分的 4 张候选图路径（Gemini 无此字段）	images
url	图片 OSS 公网 URL	upload
video	生成的视频路径	videos
videoDuration	视频时长（秒），Grok=6, VEO=8	videos
videoUrl	视频 OSS 公网 URL	videos
audio	TTS 音频路径	tts
duration	音频时长（秒）	tts

Agent 审查时可操作

• MJ 换选：item.file = item.candidates[2]
• 删除不合格 item：直接从 items 数组移除，重新跑 --phase images
• 调整 prompt 重跑：改 imagePrompt，status 改回 pending

---

首尾帧模式

mode: "framePair" 时，imagePrompt 作为起始帧，每个 item 额外字段：

字段	说明	谁填充
imagePrompt	起始帧画面描述（与 single 模式复用同一字段）	AI
lastFramePrompt	结束帧画面描述	AI
lastFrame	结束帧图片路径	pipeline images 回写
lastFrameUrl	结束帧 OSS URL	pipeline upload 回写

首尾帧规则：同一场景、视角一致、状态对比。VEO 检测到 lastFrameUrl 自动启用双图模式。

---

目录结构

output/{account}_{YYYYMMDD}_{NNN}/
├── manifest.json       # 主清单
├── images/             # scene_{NN}_{keyword}.jpeg（首尾帧加 _last，MJ 候选加 _cand{1-4}）
├── videos/             # scene_{NN}_{keyword}.mp4
└── audio/              # seg_001.mp3