init with react+axum+spacetimedb

docs/technical/SCENE_MULTI_ACT_CREATOR_IMPLEMENTATION_PROGRESS_2026-04-20.md

@@ -0,0 +1,129 @@
+# 场景多幕创作与流程改造实施进度 2026-04-20
+
+更新时间：`2026-04-20`
+
+## 1. 本轮落地范围
+
+本轮先完成场景多幕的第一批基础链路，让“场景章节 -> 多幕 -> 主角色 -> 幕背景/相遇 NPC”真正进入现有创作工具与运行时。
+
+本轮目标不是一次性做完 PRD 全量能力，而是先把下面两条主干打通：
+
+1. 草稿层可以承载 `scene chapter / scene act`
+2. 后端可以把 `scene_chapter` 编译成正式蓝图
+3. 创作者可以在现有场景编辑弹层里看到并编辑多幕配置
+4. 编辑后的幕信息可以正确写回 `sceneChapterBlueprints`
+5. 运行时共享层先具备读取幕背景、主角色、相遇 NPC 池的基础能力
+6. 当前幕主角色的负好感 `5` 轮聊天限制先形成首个可运行闭环
+
+## 2. 本轮已落地
+
+## 2.1 草稿与运行时结构
+
+已补齐多幕相关结构：
+
+1. `CustomWorldFoundationDraftProfile.sceneChapters`
+2. `CustomWorldFoundationDraftSceneChapter`
+3. `CustomWorldFoundationDraftSceneAct`
+4. `CustomWorldProfile.sceneChapterBlueprints`
+5. `StoryEngineMemoryState.currentSceneActState`
+
+同时补齐了地点/营地草稿里的 `imageSrc`，避免幕背景回落时丢失现有场景图资产引用。
+
+## 2.2 scene_chapter 草稿编译
+
+`server-node/src/services/customWorldAgentDraftCompiler.ts` 已完成第一批接入：
+
+1. `scene_chapter` 正式进入草稿编译结果
+2. 支持从显式 `sceneChapters` 或地点/章节数据回退生成场景章节卡
+3. 每张卡会编译出场景摘要、幕结构总览、每幕背景图、主角色、辅助 NPC、幕目标、过渡钩子
+4. 每幕生成动态可编辑 section id
+5. 已增加基础警告：
+   - 幕数不足
+   - 缺背景图
+   - 缺相遇 NPC
+   - 主角色不在第一位
+   - 缺线程挂钩
+   - NPC 或线程引用失配
+
+## 2.3 scene_chapter 草稿编辑
+
+`server-node/src/services/customWorldAgentDraftEditService.ts` 已支持：
+
+1. 编辑场景章节标题、摘要
+2. 编辑每幕标题、摘要、背景图链接、相遇 NPC、幕目标、过渡钩子
+3. `encounterNpcIds` 支持用角色 id 或角色名回写
+4. 回写后自动用第一位 NPC 覆盖 `primaryNpcId`
+
+`server-node/src/services/customWorldAgentChangeSummaryService.ts` 也已支持解析 `scene_chapter` 标题。
+
+## 2.4 场景编辑器接入
+
+前端已完成第一批接入：
+
+1. `scene_chapter` 不再作为独立 Tab / 独立卡片暴露给创作者
+2. 多幕配置已内嵌到 `CustomWorldEntityEditorModal.tsx` 的 `LandmarkEditor`
+3. 单幕编辑已从文本表单切成“背景大图预览 + 3 个角色槽位”的轻量交互
+4. “幕标题 / 幕摘要 / 幕目标 / 过渡钩子”已从场景手工编辑区移除，继续留在草稿生成与编译层
+5. 角色槽位已改成直接叠在幕背景图上的站位式预览，每个角色只显示形象与名称
+6. 每幕背景图与角色槽位都走独立弹窗，不做卡片内联展开
+7. 角色槽位会把第一槽位写回 `primaryNpcId`，其余槽位顺序压缩写回 `encounterNpcIds`
+8. 每幕已补上“幕预览”入口，点击后会以独立全屏层启动当前幕运行时预览
+9. 保存场景时会把幕配置同步写回 `CustomWorldProfile.sceneChapterBlueprints`
+10. 世界档案里的场景详情页已移除“场景图片”和“场景内 NPC”字段，相关兼容字段改为从多幕配置自动同步回 `imageSrc / sceneNpcIds`
+
+补充一条等待页体验收口：
+
+10. 世界草稿生成等待页的第二模块标题已从“当前锚点信息”收口为“当前世界信息”，不再显示辅助说明小字，也不再在该模块头部提供“回到工作区”按钮，避免等待态出现重复返回入口
+
+## 2.5 运行时基础层
+
+本轮同步补齐了幕运行的基础读取能力：
+
+1. 当前幕背景图优先覆盖场景默认背景
+2. 当前幕相遇 NPC 池可参与场景相遇过滤
+3. 当前幕主角色与负好感有限聊天的判定 helper 已建立
+4. 场景预览层已能识别“负好感主角色不直接自动开战”的基础分支
+5. 编辑器内幕预览会把当前幕直接装配进真实游戏壳，而不是走静态假页面
+6. 幕编辑中的 3 个角色槽位已进一步收敛成贴在背景图上的站位式角色预览，交互与幕预览保持同一位置语义，只显示角色形象与名称
+7. 幕预览运行时已补 custom world NPC 的视觉兜底链路，优先使用 `visual / imageSrc` 渲染，避免角色形象或动画空白
+8. 当前幕小预览已调整为左侧玩家、右侧敌对/相遇角色的构图，NPC 站位采用一前两后
+前排主角色与玩家角色保持同一 y 轴；后排两个角色改为同一列、x 轴对齐并上下分布，且后排整体 y 轴中点与前排主角色一致
+9. 新增幕默认只带 1 个主角色，后续槽位由创作者按需补充
+10. 小预览里的名字已移动到角色头顶，角色渲染不再带方形底板，避免遮挡场景背景
+11. 幕预览复用真实游戏壳时隐藏左上角角色等级徽标，退出入口固定在上方画面区域底部居中，并使用“结束预览”作为操作文案
+12. 创作侧场景列表封面、多幕配置卡片、配置背景弹层统一读取同一张场景显示图；在任一幕保存背景时同步回全部幕背景字段和场景兼容图，避免同一场景在不同层级出现不同预览图
+13. 场景角色预览图背景改用平台主题变量，亮色主题下不再保留深色预览底
+
+## 2.6 负好感主角色有限聊天闭环
+
+本轮已把 PRD 里的第一版运行时闭环接到现有游戏流程：
+
+1. `StoryEngineMemoryState.currentSceneActState` 会在进入场景章节时初始化到首幕
+2. 当前幕主角色若好感度小于 `0`，相遇后不再直接进入敌对宣言，而是进入有限聊天态
+3. 有限聊天态会把 `turnLimit / remainingTurns / limitReason` 透传到前后端聊天链路
+4. 第 `5` 轮会由后端 prompt 强约束生成“铺垫式收束”回复，不再继续生成下一轮聊天建议
+5. 第 `5` 轮返回后，前端会自动清掉 `npcChatState`，隐藏输入框，并给出 `继续` 的后续推进入口
+6. Adventure 面板会显示当前幕标题与有限聊天剩余轮数
+7. 当前幕主角色在本地战斗胜利后，会重新回到 NPC 聊天态，而不是直接掉回普通剧情续写
+8. 战后重新开启的聊天会把“战斗结果摘要 + 最近战斗日志”一起写入 `npc_chat` 上下文，保证 NPC 能承接刚刚那场交锋继续说话
+9. 若该主角色当前好感仍小于 `0`，战后重新开启的聊天仍按 `5` 轮有限聊天处理，轮数从战后这次重开重新计算
+
+## 3. 当前仍未完成
+
+下面这些仍属于 PRD 未完项，需要下一轮继续：
+
+1. 发布期 `qualityFindings` / blocker 的正式接入
+2. `SceneActRuntimeState` 的完整推进、跨幕推进规则与持久化
+3. 幕切换后的系统提示、切幕触发条件与背景/相遇对象的完整联动
+4. 高好感主角色“无限轮聊天”与更多委托触发细则的专项验证
+5. Agent 聊八锚点 -> 生成草稿 -> 场景内多幕配置的整条创作闭环仍需继续打磨
+
+## 4. 下一轮建议顺序
+
+建议下一轮按下面顺序继续：
+
+1. 先补 `SceneActRuntimeState` 的跨幕推进规则与持久化
+2. 再补发布期 blocker / quality findings
+3. 最后补高好感委托验证与 Agent 创作闭环
+
+这样可以先把“能跑”继续扩成“能切幕”，再把“发布质量门槛”和“完整创作闭环”补完整。