AI Video Asset Manager#

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

核心原则#

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

命名规范#

类型前缀示例角色CHAR_``CHAR_001_小弯场景SCENE_``SCENE_001_游戏房道具PROP_``PROP_001镜头SHOT_``SHOT_001_01口播模板TPL_``TPL_001参考图REF_``REF_CHAR_001_front_v01生成记录GEN_``GEN_001一致性检查CHECK_``CHECK_001返工记录RW_``RW_001

资产状态机#

text

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

项目结构#

每个项目独立仓库：

text

[项目名]/
├── 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 检查：

检查项通过标准角色外观与 CHAR_XXX.md 外观锁定项一致场景与 SCENE_XXX.md 一致道具与道具资产卡一致表情/姿态在表情库/手势库范围内光线/色调保持一致

全部通过 → 镜头卡标记 ✅

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

返工记录#

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

常用指令#

用户说执行新角色 [名字] [描述]新建角色资产卡新场景 [名字] [描述]新建场景资产卡锁定 [资产ID]将资产状态改为已锁定新镜头 [角色ID] [场景ID]新建镜头卡生成记录 [镜头ID] [工具]引导填写生成参数一致性检查 [镜头ID]执行一致性检查返工 [镜头ID]创建返工记录下载素材 [URL]下载图片到本地目录

项目初始化#

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

bash

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

参考： references/project-templates.md