角色换装与造型版本
本文属于“当前架构”,描述角色换装的资产层、造型层与分镜层实现。
1. 三层关系
换装不是“给角色改一张图”,而是三层数据各司其职:
| 层 | 数据 | 作用 |
|---|---|---|
| 服装资产 | costumes + costume_images | 一套衣服本身的产品图/参考图,可被多个角色复用 |
| 角色造型 | asset_versions(version_kind=appearance, attributes.costume_id) | “这个角色穿这套衣服”的造型版本,绑定角色 + 服装 + 造型参考图 |
| 分镜换装 | storyboard_wardrobe_items + shot_plan_candidates.payload.characters[] | 场次级默认造型 + 镜头级换装覆盖 |
角色基础服装 characters.costume_id 只作为默认值;真正的换装以造型版本和分镜造型计划为准。
2. 推荐操作流程
2.1 准备服装资产
- 在服装资产页创建/确认服装;
- 生成或上传服装图,人工审核后采纳;
- 服装名与描述只写服装本身,不写“来自角色表设定”这类出处标注。
2.2 创建角色造型
在角色详情页「新增造型 / 版本」中:
- 选择「关联服装」;
- 系统自动把类型补为「服装造型」,并在版本名为空时填入“角色名 · 服装名”;
- 版本描述写这套造型的可见差异(颜色、材质、配饰、发型/妆容变化);
- 创建后,在「版本历史」里可看到
version_kind=appearance的造型版本。
造型版本会写入 attributes.costume_id,供设定板和分镜造型计划复用。
在「图片候选」里选择「目标版本(生成与采纳)」后:
- 新生成的候选图会绑定该造型版本;
- 提示词会使用该造型绑定的服装及其服装参考图;
- 采纳时也会写回该造型,不再默认落到基础身份版本。
2.3 为造型生成角色设定板
角色设定板支持选择「造型版本」:
- 在「角色设定板」区域选择造型版本;
- 在「参考图」里选择该造型的候选图;不选时自动使用该造型已采纳图或角色正面图;
- 选择「分面板生成后合成」或「一次性整板生成」;
- 生成完成后人工审核并采纳。
图片候选卡片上的「用于设定板」可以直接把这张抽卡结果设为设定板参考图,页面会滚动到设定板区域并选中该图。
视频参考图侧有一个项目级开关「自动使用最新候选」:
- 造型版本还没有已采纳图时,镜头参考素材的自动推荐会使用该版本最新一张成功候选;
- 已采纳图仍然优先;
- 开关默认关闭,避免未审核的抽卡结果直接进入视频。
这样同一角色可以有多块设定板:基础造型、晚宴造型、十年前造型等,各自绑定不同服装与参考图。
2.4 场次与镜头换装
在分镜表的「角色造型」页签:
- 生成角色造型计划(AI 或规则);
- 系统按场次给每个角色选一套服装,并识别场次内的换装镜头;
- 用户逐项审核/更换服装;
- 「通过并应用」后:
- 为角色 + 服装创建/复用
asset_versions(version_kind=appearance, variant_type=costume); - 场次默认写回
storyboard_wardrobe_items; - 镜头覆盖写回候选行
payload.characters[].costume_id / appearance_version_id; - 正式镜头同步
ShotAssetVersion(role=character_appearance / costume)。
- 为角色 + 服装创建/复用
开拍门禁 character_outfits_valid 会检查每个出场角色是否有服装和造型版本。
3. 参考图优先级
角色设定板选择参考图时:
- 用户显式选择的候选图;
- 所选造型版本已采纳的候选图;
- 角色图片槽的正面图;
- 没有参考图时,完全按文字描述生成。
显式参考图必须是该角色自己的候选图或角色图片,后端会校验归属,避免跨角色复用。
4. 前端入口
| 入口 | 位置 | 职责 |
|---|---|---|
| 服装资产 | 资产页 → 服装 | 维护衣服本身 |
| 新增造型 / 版本 | 角色详情 → 右栏 | 把服装绑定成角色造型 |
| 角色设定板 | 角色详情 → 左栏 | 按造型生成资产母版 |
| 角色造型 | 分镜表 → 角色造型 | 按场次/镜头审核换装并应用 |
5. 边界
- 造型版本不改变身份;身份锁定仍由
identity_version_id与正面图控制; - 服装资产可以被多个角色复用,但造型版本必须绑定到具体角色;
- 设定板按造型生成,不自动为每个造型批量生成;
- 分镜造型计划只允许选择项目已关联的服装,不会静默套用未关联服装;
- 一次性整板与分面板合成共用同一套造型/参考图解析逻辑。