1

docs/technical/RPG_CREATION_SCENE_ACT_ASSET_CONSISTENCY_2026-04-26.md

@@ -0,0 +1,24 @@
+# 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. 点击“跟随场景主图”只影响当前幕，不会把同一张图同步覆盖到三幕。