1

docs/technical/SCENE_MULTI_ACT_CREATOR_IMPLEMENTATION_PROGRESS_2026-04-20.md

@@ -4,15 +4,16 @@
 
 ## 1. 本轮落地范围
 
-本轮先完成 `scene_chapter` 的第一批基础链路，让“场景章节 -> 多幕 -> 主角色 -> 幕背景/相遇 NPC”真正进入现有创作工具和草稿系统。
+本轮先完成场景多幕的第一批基础链路，让“场景章节 -> 多幕 -> 主角色 -> 幕背景/相遇 NPC”真正进入现有创作工具与运行时。
 
-本轮目标不是一次性做完 PRD 全量能力，而是先把下面这条主干打通：
+本轮目标不是一次性做完 PRD 全量能力，而是先把下面两条主干打通：
 
 1. 草稿层可以承载 `scene chapter / scene act`
-2. 草稿编译器可以把 `scene_chapter` 编译成正式卡片
-3. 创作页可以看到、打开、编辑 `scene_chapter`
-4. 编辑后的幕信息可以正确写回草稿
+2. 后端可以把 `scene_chapter` 编译成正式蓝图
+3. 创作者可以在现有场景编辑弹层里看到并编辑多幕配置
+4. 编辑后的幕信息可以正确写回 `sceneChapterBlueprints`
 5. 运行时共享层先具备读取幕背景、主角色、相遇 NPC 池的基础能力
+6. 当前幕主角色的负好感 `5` 轮聊天限制先形成首个可运行闭环
 
 ## 2. 本轮已落地
 
@@ -55,43 +56,62 @@
 
 `server-node/src/services/customWorldAgentChangeSummaryService.ts` 也已支持解析 `scene_chapter` 标题。
 
-## 2.4 创作页展示
+## 2.4 场景编辑器接入
 
 前端已完成第一批接入：
 
-1. 草稿抽屉正式加入 `scene_chapter` 分组
-2. `scene_chapter` 分组顺序位于 `chapter` 后、`thread` 前
-3. 详情面板已支持 `场景章节` 类型标签
-4. 幕背景 section 在详情面板里会直接渲染图片预览
-5. 编辑面板已支持幕摘要 / 相遇 NPC / 幕目标 / 过渡钩子等动态多行字段
+1. `scene_chapter` 不再作为独立 Tab / 独立卡片暴露给创作者
+2. 多幕配置已内嵌到 `CustomWorldEntityEditorModal.tsx` 的 `LandmarkEditor`
+3. 单幕编辑已从文本表单切成“背景大图预览 + 3 个角色槽位”的轻量交互
+4. “幕标题 / 幕摘要 / 幕目标 / 过渡钩子”已从场景手工编辑区移除，继续留在草稿生成与编译层
+5. 角色槽位已改成直接叠在幕背景图上的站位式预览，每个角色只显示形象与名称
+6. 每幕背景图与角色槽位都走独立弹窗，不做卡片内联展开
+7. 角色槽位会把第一槽位写回 `primaryNpcId`，其余槽位顺序压缩写回 `encounterNpcIds`
+8. 每幕已补上“幕预览”入口，点击后会以独立全屏层启动当前幕运行时预览
+9. 保存场景时会把幕配置同步写回 `CustomWorldProfile.sceneChapterBlueprints`
 
 ## 2.5 运行时基础层
 
-本轮同步补齐了幕运行的基础读取能力，便于下一轮继续接游戏流程：
+本轮同步补齐了幕运行的基础读取能力：
 
 1. 当前幕背景图优先覆盖场景默认背景
 2. 当前幕相遇 NPC 池可参与场景相遇过滤
 3. 当前幕主角色与负好感有限聊天的判定 helper 已建立
 4. 场景预览层已能识别“负好感主角色不直接自动开战”的基础分支
+5. 编辑器内幕预览会把当前幕直接装配进真实游戏壳，而不是走静态假页面
+6. 幕编辑中的 3 个角色槽位已进一步收敛成贴在背景图上的站位式角色预览，交互与幕预览保持同一位置语义，只显示角色形象与名称
+7. 幕预览运行时已补 custom world NPC 的视觉兜底链路，优先使用 `visual / imageSrc` 渲染，避免角色形象或动画空白
+8. 当前幕小预览已调整为左侧玩家、右侧敌对/相遇角色的构图，NPC 站位采用一前两后
+9. 新增幕默认只带 1 个主角色，后续槽位由创作者按需补充
+10. 小预览里的名字已移动到角色头顶，角色渲染不再带方形底板，避免遮挡场景背景
+
+## 2.6 负好感主角色有限聊天闭环
+
+本轮已把 PRD 里的第一版运行时闭环接到现有游戏流程：
+
+1. `StoryEngineMemoryState.currentSceneActState` 会在进入场景章节时初始化到首幕
+2. 当前幕主角色若好感度小于 `0`，相遇后不再直接进入敌对宣言，而是进入有限聊天态
+3. 有限聊天态会把 `turnLimit / remainingTurns / limitReason` 透传到前后端聊天链路
+4. 第 `5` 轮会由后端 prompt 强约束生成“铺垫式收束”回复，不再继续生成下一轮聊天建议
+5. 第 `5` 轮返回后，前端会自动清掉 `npcChatState`，隐藏输入框，并给出 `继续` 的后续推进入口
+6. Adventure 面板会显示当前幕标题与有限聊天剩余轮数
 
 ## 3. 当前仍未完成
 
 下面这些仍属于 PRD 未完项，需要下一轮继续：
 
-1. 创作页里的“新增幕 / 删除幕 / 调整幕顺序”交互
-2. 背景图配置与 NPC 配置的独立面板化交互
-3. 发布期 `qualityFindings` / blocker 的正式接入
-4. `SceneActRuntimeState` 的完整推进与持久化
-5. 当前幕主角色负好感 `5` 轮聊天限制的前后端完整闭环
-6. 第 `5` 轮“铺垫式收束”提示与强制退出聊天态
-7. 幕切换后的系统提示与 Adventure 面板状态展示
+1. 发布期 `qualityFindings` / blocker 的正式接入
+2. `SceneActRuntimeState` 的完整推进、跨幕推进规则与持久化
+3. 幕切换后的系统提示、切幕触发条件与背景/相遇对象的完整联动
+4. 高好感主角色“无限轮聊天”与更多委托触发细则的专项验证
+5. Agent 聊八锚点 -> 生成草稿 -> 场景内多幕配置的整条创作闭环仍需继续打磨
 
 ## 4. 下一轮建议顺序
 
 建议下一轮按下面顺序继续：
 
-1. 先补 `SceneActRuntimeState` 初始化与幕推进
-2. 再接 `npcEncounterActions / aiService / chatOrchestrator` 的负好感有限聊天闭环
-3. 最后补创作页的幕增删改序和独立配置面板
+1. 先补 `SceneActRuntimeState` 的跨幕推进规则与持久化
+2. 再补发布期 blocker / quality findings
+3. 最后补高好感委托验证与 Agent 创作闭环
 
-这样可以先把“能跑”补齐，再把“编辑体验”补完整。
+这样可以先把“能跑”继续扩成“能切幕”，再把“发布质量门槛”和“完整创作闭环”补完整。