AI Video Asset Manager

基于 ViMax 多智能体视频生成框架思路，适配 Runway/Kling/可灵/即梦/Pika/Sora/Veo 等工具。

核心原则

1. 资产优先 — 角色/场景/道具未锁定不开始生成
2. 版本不覆盖 — 每次变更新建版本号
3. 检查前置 — 一致性检查是进入下一镜头的门槛

命名规范

资产状态机

草稿 → 审核中 → 已锁定 → 使用中 → 已废弃
  ↑                      ↓
  ← ← ← ← ← ← ← 返工 ← ←

项目结构

每个项目独立仓库：

[项目名]/
├── 00_总览.md
├── 01_资产库/
│   ├── 角色/         # CHAR_XXX_名字.md
│   ├── 场景/         # SCENE_XXX_名字.md
│   └── 道具/         # PROP_XXX_名字.md
├── 02_分镜/
│   ├── 00_分镜表_模板.md
│   └── SHOT_XXX_XX.md
├── 03_参考图索引/
│   ├── CHAR_XXX/
│   ├── SCENE_XXX/
│   ├── TPL_XXX/
│   └── SHOT_XXX/
├── 04_生成记录/
│   └── GEN_XXX_描述.md
├── 05_一致性检查/
│   └── CHECK_XXX_镜头ID.md
└── 06_返工记录/
    └── RW_XXX_镜头ID.md

工作流

新建角色资产

1. 用户提供：角色名 + 外观描述（至少：发型、服装、性格）
2. 创建 01_资产库/角色/CHAR_XXX_名字.md
3. 建立 03_参考图索引/CHAR_XXX/ 目录
4. 用户提供或抓取参考图 URL → 下载到本地
5. 填写外观锁定项、可/禁用提示词
6. 状态：草稿

锁定资产

条件：角色外观经过 ≥2 次生成验证

1. 确认外观锁定项全部勾选
2. 将 frontmatter 中 status 改为 已锁定
3. 在版本历史中新增条目

新建镜头

1. 确认关联角色/场景已锁定
2. 创建 02_分镜/SHOT_XXX_XX.md
3. 绑定资产引用（角色ID、场景ID、道具ID）
4. 填写分镜信息（镜头号、叙事位置、景别、动作描述）
5. 状态：草稿

生成记录归档

1. 用户提供：使用的工具（Runway/Kling/Veo等）
2. 创建/更新 04_生成记录/GEN_XXX_描述.md
3. 记录：prompt、参数、产出路径、工具
4. 状态：已完成

一致性检查

按 references/consistency-rules.md 检查：

全部通过 → 镜头卡标记 ✅

有任一项不一致 → 进入返工流程

返工记录

1. 创建 06_返工记录/RW_XXX_镜头ID.md
2. 记录：返工原因、不一致项、修复方案
3. 修复后重新通过一致性检查

常用指令

项目初始化

新项目运行 scripts/init-project.py：

python scripts/init-project.py [项目路径] [项目名]

参考：references/project-templates.md