Skip to content
角色设定板批量范围与费用控制计划

角色设定板批量范围与费用控制计划

本文属于“任务计划”,描述 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,还是仅在详情页提示;
  • 批量上限与并发是否需要沿用项目图片并发配置。