refactor: 同步独立选角与默认人物基线

2026-09-01 10:11:15 +08:00
parent 53917268d3
commit 95bd12cfcd
9 changed files with 25 additions and 14 deletions
@@ -86,7 +86,7 @@ Oxfmt 不负责代码质量，Oxlint 不负责 Vue 的完整类型推导；Vue S
 ## 接口基线

 对齐后端 `qianlanse/short-drama-agent` 的 `dev`：
-`c50d3f536fbca40ea07d36e00bace7bb886fabfa`（2026-08-31），包含 Character Casting、身份／形态双参考首帧、首帧与视频生产就绪检查。本轮只修改前端，请确保后端依照其开发流程同步 Prisma migration 并重启服务。
+`40c700f47d578888105484cfb317f52568855e0e`（2026-09-01），包含 Character Casting、身份／形态双参考首帧、首帧与视频生产就绪检查，以及独立候选生成和中国人物默认选角基线。本轮只修改前端，请确保后端依照其开发流程同步 Prisma migration 并重启服务。

 | HTTP | 路径（以 /api 为前缀） | 用途 |
 | --- | --- | --- |
@@ -195,11 +195,12 @@ API 层也提供 `state` 与 `breakdown/latest` 方法。页面通过共享 chec
 3. 前端以正式 `subject-forms` 目录为基础，并合并 Character Casting readiness，因此尚无形态的角色也可先完成 Identity 和选角。Scene / Prop 若还没有 Form，仍不会凭 checkpoint 伪造正式 Subject ID。
 4. 身份文本批量分为 Character 专用入口和全部主体高级入口。选角候选批量只处理 `missing_anchor`，受本批上限控制；`candidate_pending` 必须人工确认，不会由批量任务静默决定演员。
 5. 身份图片的 `isAnchor` 来自专用 GET。Character primary 通过 Casting Candidate 接口生成且默认停用；点击确认演员后才成为 Anchor 并锁定 Identity。辅助视图不能直接成为母版。Scene / Prop 保留普通母版切换接口。
-6. 身份生图不传 `referenceImageId` 时，由后端自动选择当前母版；无母版时按文本生成。指定时只能选择当前身份已完成的图片；候选图即使停用也可作为显式参考。后端没有“有母版但忽略它”的参数。尺寸成对留空或提供正整数。自定义 Prompt 会替换后端编译的完整文本，建议保留默认。
+6. 普通身份生图不传 `referenceImageId` 时，由后端自动选择当前母版；无母版时按文本生成。指定时只能选择当前身份已完成的图片；候选图即使停用也可作为显式参考。Character Casting Candidate 是独立选角入口，即使已有 Anchor 也不会复用旧母版，避免旧演员身份污染新候选。尺寸成对留空或提供正整数。自定义 Prompt 会替换后端编译的完整文本，建议保留默认。
 7. 目前**人物与场景形态生图**会自动注入当前身份母版，分别固定人物身份和空间骨架；道具暂不自动引用。没有身份或母版时，原形态生图流程仍可使用。已有母版但缺少 Provider 可访问远程地址时，后端会报错；本地 `/storage/` 能显示并不证明原始 Provider URL 仍可访问。前端显示后端错误，不自动重试消耗额度。
 8. 修改风格、身份文本或母版，不会自动使旧图失效或重生成。已有形态主图仍会被分镜使用；需要保持新身份时，主动生成候选图并设为形态主图，再刷新分镜参考图，按需覆盖视频提示词。图库详情展示当次 `identityAnchorImageId` 或 `referenceImageId`；旧记录没有该字段时明确显示未知，不推断它使用了当前母版。
 9. 风格参考图支持登记已有 HTTP(S)／`/storage/` 地址、分类、排序、启停和删除记录；**没有文件上传接口，也没有风格图 AI 生成接口**。当前身份图／形态图 Provider 调用不会自动消费风格参考图片，页面不暗示登记后已生效。
 10. 编辑草稿与轮询分离。保存成功才清空草稿，失败保留；主体切换会提示放弃未保存修改。离开页面不会自动保存。所有新写操作沿用项目级会话互斥，生成前需要费用与后台任务确认，无法替代后端跨浏览器锁。
+11. AI 生成 VisualStyle 与 Character Identity 时，若项目、世界观和角色事实都未指定人物背景，默认采用自然真实的中国人物选角基线。项目明确配置和角色事实优先于系统默认值，不限制后续使用其它国家、地区、族裔或肤色人物。

 ### 后端限制