角色设定板批量范围与费用控制计划
本文属于“任务计划”,描述 v1.2.1 待落地的范围筛选与批量生成方案。 当前实现仍是单角色手动触发,见 角色设定板。
1. 背景
角色设定板单角色约 12 张面板图。若在剧本解析或项目初始化时自动为全部角色生成, 会在用户不知情的情况下产生批量费用。需要把“哪些角色必须生成”与“何时允许批量入队” 拆成可解释、可确认的两步。
2. 目标
- 有台词角色进入“必须生成”清单,并在工作台可见缺口;
- 无台词 NPC / 路人默认不生成,不阻塞项目进度;
- 无台词但重要角色支持手动生成;
- 批量生成必须由用户显式确认角色清单与预计费用后才入队;
- 批量失败可重试单个角色,不重复生成已成功的面板。
3. 建议状态模型
按“角色 × 项目”计算,不写入 characters 全局字段:
| 状态 | 含义 |
|---|---|
not_required | 无台词且未被标记为重要角色 |
missing | 有台词或已标记重要,但尚无成功设定板 |
generating | 存在生成中的面板或板 |
ready | 已有 succeeded 且 is_current 的设定板 |
stale | 角色关键字段(外貌、身高、服装)晚于当前板更新时间 |
台词判定建议读取 shot_dialog_lines(按项目聚合说话人),而不是解析角色描述文本。
4. 建议 API
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /studio/projects/{pid}/character-sheet-scope | 返回角色清单、状态、是否必须生成 |
| POST | /studio/projects/{pid}/character-sheets/batch | 显式提交角色 ID 列表与 confirm=true + character_ids |
批量接口要求:
- 请求体必须带
confirm=true与明确的character_ids; - 后端返回预估面板数与预估费用区间;
- 前端二次确认后才真正入队;
- 同一角色已有进行中的板时跳过,不重复扣费;
- 接口返回逐角色结果,而不是一个笼统的成功/失败。
5. 前端落点
- 角色列表 / 项目概览展示“必须生成”缺口数量;
- 批量入口先展示清单、预计图片数与费用,再要求确认;
- 任务中心只展示通用任务状态,业务上下文留在角色面板;
- 单角色详情页继续保留手动“生成角色设定板”。
6. 验收标准
- 有台词角色在未生成时显示
missing; - 无台词 NPC 默认
not_required,不进入批量清单; - 未确认的批量请求返回 400/409,不创建任何任务;
- 确认后只为选中的角色创建任务,已
ready的角色不重复生成; - 预估费用与实际创建的面板数一致;
- 批量失败不把已成功面板标记为失败。
7. 待决问题
- “重要角色”由用户手动标记,还是读取剧本角色重要性字段;
- 费用预估使用固定单价还是项目实际模型单价;
- 角色关键字段变化后是否自动把
ready置为stale,还是仅在详情页提示; - 批量上限与并发是否需要沿用项目图片并发配置。