Genarrative/docs/technical/RPG_CREATION_SCENE_ACT_ASSET_CONSISTENCY_2026-04-26.md

RPG 创作场景幕资产一致性修复 2026-04-26

背景

当前世界草稿和场景编辑器存在三类一致性问题：

1. 世界草稿生成后，开局场景的三幕可能没有默认主角色。
2. 开局场景列表层、幕卡片层、幕背景配置弹层可能显示不同图片。
3. 幕背景智能生成弹层的默认提示词可能退回规则拼接文本，且预览图和外层当前幕不一致。

落地约束

1. 后端草稿生成必须为 sceneChapterBlueprints[*].acts[*] 写入稳定的幕级字段：encounterNpcIds、primaryNpcId、oppositeNpcId、eventDescription、backgroundPromptText。
2. 开局场景 camp 在生成角色名单之前建立，但最终编译草稿时必须基于已生成的场景角色，为三幕自动补默认主角色，不允许把“开局关键角色”这类占位词留到可编辑草稿里。
3. backgroundPromptText 必须优先来自模型生成的自然画面描述；缺失时才使用规则兜底，兜底也要基于真实主角色名。
4. 前端场景编辑器展示某一幕时，列表卡、幕卡、配置弹层、智能生成弹层都应读取同一个幕级 backgroundImageSrc；只有旧草稿缺幕图时才展示场景主图作为视觉兜底，保存时不得把兜底图反写到所有幕。
5. 智能生成幕背景时，默认提示词必须使用当前幕 backgroundPromptText，不再用标题、摘要、目标拼接替代。

验收点

1. 新生成的开局三幕每幕都有非空 primaryNpcId，并且第一位 encounterNpcIds[0] 与 primaryNpcId 一致。
2. 普通场景与开局场景都能在幕背景生图 prompt 中写入真实主角色名。
3. 开局场景第 2 幕在列表层、编辑卡片层、配置弹层、智能生成弹层中的预览图保持一致。
4. 点击“跟随场景主图”只影响当前幕，不会把同一张图同步覆盖到三幕。