From effe0355bdf734f4a0e7e48678af7cd8a83ba4cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=AB=98=E7=89=A9?= <253518756@qq.com>
Date: Tue, 21 Apr 2026 00:48:17 +0800
Subject: [PATCH 1/6] 1

---
 ...D_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md | 579 ++++++++++++++++++
 docs/planning/README.md                       |   1 +
 ...T_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md | 212 +++++++
 ...T_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md |  75 +++
 ...T_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md | 148 +++++
 ...ON_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md |  92 +++
 docs/technical/README.md                      |   4 +
 .../shared/src/contracts/customWorldAgent.ts  |   5 +
 server-node/src/app.test.ts                   | 143 +++++
 server-node/src/routes/customWorldAgent.ts    |   4 +
 .../syncCustomWorldSavedProfileAssets.ts      | 229 +++++++
 .../services/customWorldAgentOrchestrator.ts  | 143 +++++
 .../services/customWorldAgentPhase4.test.ts   | 224 +++++++
 .../services/customWorldWorkSummaryService.ts | 112 ++--
 src/components/CustomWorldResultView.test.tsx |  27 +
 src/components/CustomWorldResultView.tsx      |   8 +-
 .../CustomWorldCreationHub.tsx                |   4 +-
 ...meSelectionFlow.agent.interaction.test.tsx | 548 +++++++++++++++--
 .../game-shell/PreGameSelectionFlow.tsx       | 519 +++++++++++++---
 19 files changed, 2897 insertions(+), 180 deletions(-)
 create mode 100644 docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md
 create mode 100644 docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md
 create mode 100644 docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md
 create mode 100644 docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md
 create mode 100644 docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
 create mode 100644 server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts

diff --git a/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md b/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md
new file mode 100644
index 00000000..881927d7
--- /dev/null
+++ b/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md
@@ -0,0 +1,579 @@
+# 工程无用分支、历史代码与隐形多链路大清洗执行计划（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 文档目标
+
+这份文档只解决一件事：
+
+**对当前工程发起一轮“不是继续加功能，而是系统性减负、删重、收口、归档”的大清洗。**
+
+这轮重点不是做表面上的“代码变少”，而是把下面 3 类长期拉低可读性和可维护性的东西真正处理掉：
+
+1. 无用历史代码
+2. 隐形的多数据链路 / 多真相链路乱代码
+3. 实现到一半但长期挂在主工程里的半成品代码
+
+本文目标不是重复现有审计，而是把已有结论整理成：
+
+1. 可执行的清洗范围
+2. 明确的判定标准
+3. 分阶段的推进顺序
+4. 每阶段的交付物
+5. 可以落地的验收与回滚口径
+
+---
+
+## 1. 先把“清什么”说清楚
+
+这次文档里说的“无用分支”，优先指的是：
+
+1. 代码逻辑分支
+2. 数据链路分支
+3. 兼容实现分支
+4. 遗留入口分支
+
+**不是先把 Git 分支清空。**
+
+Git 分支治理可以后置做，但不能和首轮工程清洗混在一起，否则很容易把“代码归因”“入口归因”“历史责任归因”一起搅乱。
+
+---
+
+## 2. 三类清洗对象的定义
+
+## 2.1 无用历史代码
+
+满足以下任一特征，即进入“无用历史代码候选”：
+
+1. 没有正式运行时入口，也没有当前规划要接回入口
+2. 只被测试或历史兼容层引用，但主流程已经不再依赖
+3. 与当前正式实现功能重复，但不是唯一真相源
+4. 只剩 stub、占位、迁移残骸、旧 prompt 壳子、旧 helper 壳子
+5. 生成产物仍留在主仓库，但已不再被正式流程消费
+
+这类代码的处理目标是：
+
+**删除、归档、降级标记三选一，不再长期以“也许以后要用”为理由挂在主路径里。**
+
+## 2.2 隐形多数据链路乱代码
+
+满足以下任一特征，即进入“隐形多链路问题候选”：
+
+1. 同一份运行时状态同时由前端本地镜像和后端会话共同解释
+2. 同一类任务、物品、剧情、鉴权逻辑在前后端或多模块里各维护一份
+3. 同一份数据在“提交前本地写一份、提交后服务端再回填一份”
+4. 同一功能表面只有一个按钮，背后却有两到三条实现路径
+5. 正式链路和 fallback 链路长期并存，且没有退场时间
+
+这类问题的处理目标是：
+
+**把每条正式能力收敛成单一主链、单一真相源、单一编排出口。**
+
+## 2.3 实现到一半的半成品代码
+
+满足以下任一特征，即进入“半成品候选”：
+
+1. UI、Hook、Service 已存在，但没有正式入口
+2. 文档写了概念，代码只落了一半，后续也没有继续接完
+3. 只有局部测试或局部 mock 在用，真实流程不用
+4. 仍保留 TODO / stub / draft / launcher / modal，但未纳入当前主线
+5. 用户看不到、主流程不调用、团队也没有当前阶段交付计划
+
+这类代码的处理目标是：
+
+**要么纳入当前主线尽快补完，要么明确归档，不允许继续以“半活状态”污染主工程。**
+
+---
+
+## 3. 这轮清洗后的目标状态
+
+本轮完成后，工程应至少达到下面 7 个状态：
+
+1. 同一领域只保留一条正式主链，不再出现前后端双真相或多桥接链路并存
+2. 无入口孤岛、旧兼容壳子、旧 prompt 壳子、旧 stub 文件有明确去留结果
+3. “实现到一半”的模块不再伪装成正式能力挂在主工程中
+4. 前端继续回到“表现层”，正式运行时逻辑、鉴权真相、任务物品编排继续向后端收口
+5. 热点大文件不再同时背负历史残留、兼容残留和新逻辑堆叠
+6. 文档与代码状态一致，不再让旧规划长期误导当前执行方向
+7. `lint + typecheck + test + build + check:content` 重新成为可信基线
+
+---
+
+## 4. 执行原则
+
+## 4.1 不做大爆炸整仓改写
+
+本轮只允许“小批次、可回归、可解释”的连续清洗，不做一次性整仓推翻。
+
+## 4.2 先建台账，再动删除
+
+任何删除、归档、重定向动作前，必须先确认：
+
+1. 当前入口关系
+2. 当前依赖关系
+3. 当前替代路径
+4. 删除后的验收路径
+
+没有台账，不做大规模删改。
+
+## 4.3 先收真相源，再谈瘦身
+
+如果同一领域仍有多条真相链路并存，优先收口真相源，而不是只删表面代码量。
+
+## 4.4 文档和代码同步收口
+
+只要本轮确认某条旧链降级、冻结、归档，相关文档必须同步更新，不能让旧文档继续把团队往废链路上拉。
+
+## 4.5 每批清洗必须可回归
+
+每一批完成后至少要求：
+
+1. 入口可解释
+2. 回归路径明确
+3. 门禁可跑
+4. 回滚点存在
+
+---
+
+## 5. 当前已知问题基础
+
+本计划基于现有文档已经确认的结论推进，重点参考：
+
+1. `docs/audits/engineering/ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md`
+2. `docs/audits/engineering/ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md`
+3. `docs/audits/engineering/CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md`
+4. `docs/planning/EXPRESS_BACKEND_REFACTOR_PLAN_2026-04-08.md`
+5. `docs/experience/PROJECT_WORK_EXPERIENCE_PLAYBOOK.md`
+
+按当前审计结果，首轮就应重点关注下面 3 组对象。
+
+## 5.1 当前高置信度“无入口 / 孤岛 / 残留”候选
+
+以下对象已经在最近审计中被点名，默认进入首轮复核台账：
+
+1. `src/components/GameShell.tsx`
+2. `src/components/custom-world-home/CustomWorldCreationHub.tsx`
+3. `src/components/custom-world-home/CustomWorldCreationLauncherModal.tsx`
+4. `src/components/custom-world-agent/CustomWorldAgentLauncherModal.tsx`
+5. `src/components/custom-world-agent/CustomWorldAgentDraftDrawer.tsx`
+6. `src/hooks/story/storyBootstrap.ts`
+7. `src/hooks/useEquipmentFlow.ts`
+8. `src/hooks/useForgeFlow.ts`
+9. `src/hooks/useInventoryFlow.ts`
+10. `src/services/customWorldPresentation.stub.ts`
+11. `src/services/typewriter.ts`
+12. `src/prompts/customWorldOrchestratorPrompts.ts`
+13. `src/prompts/storyOrchestratorPrompts.ts`
+14. `src/data/buildTagSimilarity.generated.ts`
+
+这些文件不能直接判死刑，但必须进入“保留 / 接回 / 归档 / 删除”四选一清单。
+
+## 5.2 当前高置信度“隐形多链路 / 双真相”候选
+
+以下对象应进入首轮主链收口清单：
+
+1. `src/hooks/story/runtimeStoryCoordinator.ts`
+2. `src/services/runtimeStoryService.ts`
+3. `src/services/apiClient.ts`
+4. `src/hooks/story/npcEncounterActions.ts`
+5. `src/services/questDirector.ts`
+6. `src/services/runtimeItemAiDirector.ts`
+7. `src/services/ai.ts`
+
+当前这批问题的共同特征是：
+
+1. 前端仍保留本地镜像、自动登录凭证或双环境编排残留
+2. NPC 任务换单、任务生成、运行时物品生成仍有前端发起和混合执行痕迹
+3. 浏览器侧大型 AI orchestration 仍未完全退出主工程
+
+## 5.3 当前“新热点继续吸纳历史复杂度”候选
+
+以下对象不一定是垃圾代码，但很容易继续成为历史残留的新容器：
+
+1. `src/components/CustomWorldEntityEditorModal.tsx`
+2. `server-node/src/modules/assets/characterAssetRoutes.ts`
+3. `src/prompts/storyPromptBuilders.ts`
+4. `server-node/src/modules/custom-world/runtimeProfile.ts`
+5. `src/components/game-shell/PreGameSelectionFlow.tsx`
+6. `src/components/game-shell/PlatformHomeView.tsx`
+
+这批文件必须在本轮中被视为“禁止继续裸堆新逻辑”的重点区域。
+
+---
+
+## 6. 清洗判定表
+
+每个候选对象进入清理台账后，只允许落到下面 4 类结果之一：
+
+| 结果类型 | 适用场景 | 处理动作 |
+| --- | --- | --- |
+| 删除 | 无入口、无当前规划、无兼容价值 | 直接删文件、删引用、补回归 |
+| 归档 | 暂不继续，但保留历史价值 | 移出主路径、在文档中标明冻结状态 |
+| 扶正 | 当前主线确实需要，只是入口丢失或命名混乱 | 接回正式入口、补测试、补文档 |
+| 拆分收口 | 不是废代码，但混合了历史残留和正式逻辑 | 先拆职责，再删除残留分支 |
+
+禁止出现第 5 种状态：
+
+**“先留着，以后再说，但继续挂在主工程里。”**
+
+---
+
+## 7. 分阶段执行计划
+
+## P0：冻结新增污染，先建立清洗台账
+
+### 目标
+
+先把“哪些东西要清、为什么清、怎么判定是否能清”讲清楚，停止继续往旧热点和疑似废链上加逻辑。
+
+### 主要动作
+
+1. 建立 3 份清单：
+   - 无入口孤岛清单
+   - 多真相链路清单
+   - 半成品能力清单
+2. 为每个对象补 5 个字段：
+   - 当前入口
+   - 当前调用方
+   - 当前替代路径
+   - 建议结论
+   - 回归验证点
+3. 约束新增开发：
+   - 不再向疑似废链补功能
+   - 不再向热点大文件直接叠逻辑
+   - 新需求优先接到当前正式主链
+4. 明确本轮清洗后的唯一方向：
+   - 前端只做表现
+   - 后端持有正式运行时真相
+   - 旧兼容链不能继续膨胀
+
+### 交付物
+
+1. 清洗对象总台账
+2. 首轮批次拆分表
+3. 每批回归清单
+
+### 完成标准
+
+不是“开始删文件”才算开始。
+
+只要台账、批次、判定口径和冻结规则明确，这一阶段就算完成。
+
+---
+
+## P1：先清无入口孤岛和明显历史残留
+
+### 目标
+
+先把最容易污染阅读体验、又不需要大规模业务改造的对象清掉，快速降低仓库噪音。
+
+### 优先清理对象
+
+1. 无运行时入口组件
+2. 只被测试引用的旧壳层
+3. 已迁移后留下的 stub / prompt 壳 / helper 壳
+4. 已不进入正式链路的 generated 文件
+5. 旧 launcher / draft / modal 壳层
+
+### 处理顺序建议
+
+1. 先处理 `prompt / stub / helper / launcher` 级别的小残留
+2. 再处理 `旧 hook / 旧 flow / 旧 shell` 级别的流程残留
+3. 最后处理“可能有历史价值但暂不接回”的 UI 大块头
+
+### 本阶段输出结果
+
+每个对象必须给出明确结果：
+
+1. 删除
+2. 归档
+3. 扶正接回
+
+### 验收标准
+
+1. 主工程中“没有正式入口的文件”显著减少
+2. 新人看目录时，不再大量遇到真假难辨的旧入口
+3. 相关引用、测试、文档同步更新
+
+---
+
+## P2：收单一真相源，清掉隐形多数据链路
+
+### 目标
+
+这阶段不以“删多少文件”为核心，而是以“同一件事最终只走一条正式链”作为核心。
+
+### 第一优先级链路
+
+1. 运行时快照链
+2. 鉴权与自动登录链
+3. NPC 任务生成 / 换单链
+4. 运行时物品生成链
+5. 浏览器端 AI orchestration 链
+
+### 重点动作
+
+1. 收掉前端“提交前先写本地真相，再等服务端回填”的链路
+2. 收掉本地存储中的自动登录用户名 / 密码真相
+3. 把 NPC 委托换单动作继续迁回后端运行时主链
+4. 将 `questDirector`、`runtimeItemAiDirector` 拆成：
+   - 前端 SDK 层
+   - 后端正式执行层
+5. 继续压缩浏览器端 `src/services/ai.ts` 的正式职责
+
+### 这阶段最重要的判断标准
+
+不是“文件还在不在”，而是下面 4 条是否成立：
+
+1. 玩家一次动作只提交一个正式 action，而不是两边各写一遍状态
+2. 前端不再持有正式运行时镜像真相
+3. 前端不再长期持有自动登录账号密码
+4. 同一类生成能力不再同时存在“浏览器正式版”和“后端正式版”
+
+### 验收标准
+
+1. 正式运行时状态解释权明确以后端为准
+2. 鉴权边界不再依赖浏览器保存高风险凭证
+3. NPC 任务、物品、剧情编排链路的职责边界清楚
+
+---
+
+## P3：集中处理实现到一半的半成品能力
+
+### 目标
+
+把“看起来像功能、实际上不是当前正式能力”的对象清出主路径。
+
+### 清理规则
+
+半成品对象统一按下面规则处理：
+
+1. 30 天内明确要接回主线的，进入补完批次
+2. 当前阶段不做的，降级为归档或实验稿
+3. 没有继续计划、也没有正式入口价值的，直接删除
+
+### 本阶段重点对象
+
+1. 只有 modal / launcher / draft 壳层，但没有正式调用链的 UI
+2. 只有部分 hook / service 实现，但没有主链消费的流程模块
+3. 只剩“概念占位”的 prompt、adapter、presentation、stub 文件
+4. 文档里反复提到、代码里却长期不接线的能力块
+
+### 必须同步做的事
+
+1. 更新对应规划文档
+2. 从当前主叙事中移除本轮明确不做的项
+3. 给保留实验稿加清晰标签，避免被误读成正式能力
+
+### 验收标准
+
+1. 主工程里不再混着大量“像功能但不是正式功能”的对象
+2. 文档不再持续推动团队回头补本轮已冻结能力
+3. 目录层级和入口关系显著更清楚
+
+---
+
+## P4：在减负后的基础上拆热点，恢复可读性
+
+### 目标
+
+前 3 阶段做完后，再进入“真正让工程重新好读”的结构优化。
+
+### 重点对象
+
+1. `src/components/CustomWorldEntityEditorModal.tsx`
+2. `server-node/src/modules/assets/characterAssetRoutes.ts`
+3. `src/prompts/storyPromptBuilders.ts`
+4. `server-node/src/modules/custom-world/runtimeProfile.ts`
+5. `src/components/game-shell/PreGameSelectionFlow.tsx`
+6. `src/components/game-shell/PlatformHomeView.tsx`
+
+### 拆分原则
+
+1. 先按职责拆，不按文件长度拆
+2. 先把历史残留和兼容分支移走，再做正式模块化
+3. 拆完之后必须更清晰地回答：
+   - 谁负责 UI
+   - 谁负责数据准备
+   - 谁负责正式规则
+   - 谁负责调用后端
+
+### 验收标准
+
+1. 热点文件不再同时吞 UI、规则、编排、兼容残留
+2. 新功能不需要再跨四五层历史壳子一起改
+3. 后续 review 能更快定位责任边界
+
+---
+
+## 8. 批次拆分建议
+
+为了避免清理动作过大失控，建议按下面粒度推进：
+
+## 批次 A：小型孤岛与残留壳子
+
+处理对象：
+
+1. stub
+2. prompt 壳
+3. 无入口 helper
+4. 无入口 launcher / modal
+
+目标：
+
+快速去噪，降低目录误导性。
+
+## 批次 B：旧 flow / 旧 shell / 旧 hook
+
+处理对象：
+
+1. `GameShell`
+2. `storyBootstrap`
+3. `useEquipmentFlow`
+4. `useForgeFlow`
+5. `useInventoryFlow`
+
+目标：
+
+清旧主流程壳层和旧流程残留。
+
+## 批次 C：运行时真相收口
+
+处理对象：
+
+1. `runtimeStoryCoordinator`
+2. `runtimeStoryService`
+3. `apiClient`
+
+目标：
+
+去掉本地镜像真相与本地鉴权真相。
+
+## 批次 D：任务 / 物品 / AI 混合执行层收口
+
+处理对象：
+
+1. `npcEncounterActions`
+2. `questDirector`
+3. `runtimeItemAiDirector`
+4. `ai.ts`
+
+目标：
+
+消灭混合执行和双环境正式链。
+
+## 批次 E：热点大文件拆分
+
+处理对象：
+
+1. custom world
+2. assets
+3. game shell platform
+4. prompt builder
+5. runtime profile
+
+目标：
+
+在主链已收口后恢复可读性。
+
+---
+
+## 9. 每批必须产出的内容
+
+每一批都必须带着下面 5 类产出结束：
+
+1. 代码改动
+2. 文档回填
+3. 去留说明
+4. 验收记录
+5. 回滚点说明
+
+如果一个批次只能产出“删了几个文件”，但说不清：
+
+1. 删除后谁接手
+2. 主链是否更清楚
+3. 文档是否同步
+
+那么这个批次不算完成。
+
+---
+
+## 10. 统一验收口径
+
+本轮建议至少用下面 10 条作为统一验收口径：
+
+1. `npm run lint`
+2. `npm run test`
+3. `npm run build`
+4. `npm run check:content`
+5. 目录中高置信度孤岛数量下降
+6. 旧兼容链不再继续接收新逻辑
+7. 前端不再保存自动登录用户名 / 密码
+8. 运行时主状态不再由前端本地镜像优先解释
+9. 当前正式能力的入口关系能在文档中说清楚
+10. 新人阅读主目录和主流程文件时，不再频繁遇到真假并存入口
+
+---
+
+## 11. 风险与控制点
+
+## 11.1 最大风险不是“删多了”，而是“边删边继续加废链”
+
+如果没有冻结规则，这轮会一边清旧，一边又把新逻辑接回旧壳子里，最后只会重复劳动。
+
+## 11.2 不能把“兼容”当永久借口
+
+兼容链可以短期存在，但必须写清：
+
+1. 为什么保留
+2. 保留到什么时候
+3. 谁负责后续移除
+
+## 11.3 不能只删代码，不收文档
+
+如果代码删了，旧文档不改，团队还是会持续把需求往旧链上接。
+
+## 11.4 不能只盯文件大小，不盯真相链
+
+有些文件很大但确实是正式主链。
+有些文件很小，却是双真相和多链路的根源。
+
+本轮必须优先盯后者。
+
+---
+
+## 12. 当前不建议优先做的事
+
+1. 不建议在清洗期间继续横向扩功能
+2. 不建议直接对热点文件做“纯格式化式拆分”
+3. 不建议在未确认入口关系前整片删除可疑模块
+4. 不建议让前端继续补正式运行时逻辑作为短期兜底
+5. 不建议保留“也许以后有用”的主工程残留
+
+原因很简单：
+
+**当前最需要恢复的不是功能宽度，而是工程的干净边界、单一主链和可读体验。**
+
+---
+
+## 13. 推荐推进顺序
+
+建议严格按下面顺序推进：
+
+1. 先做 P0：建台账、冻结污染
+2. 再做 P1：清无入口孤岛和小残留
+3. 再做 P2：收运行时、鉴权、任务物品的单一主链
+4. 再做 P3：处理半成品能力与文档冻结项
+5. 最后做 P4：拆热点、补结构可读性
+
+不建议倒过来先拆热点。
+
+因为如果历史残留和双真相还在，大文件拆完以后，复杂度只是换地方继续长。
+
+---
+
+## 14. 一句话结论
+
+这轮工程大清洗的核心，不是“删旧代码看起来更清爽”，而是：
+
+**用一轮有台账、有判定、有阶段、有验收的大清理，把无用历史代码、隐形多链路乱代码和半成品能力从主工程里真正清出去，让项目重新回到单一主链、单一真相源、目录可读、职责清楚的健康状态。**
diff --git a/docs/planning/README.md b/docs/planning/README.md
index 0903a157..65201388 100644
--- a/docs/planning/README.md
+++ b/docs/planning/README.md
@@ -2,6 +2,7 @@
 
 ## 当前入口
 
+- [ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md](./ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md)：面向无用历史代码、隐形多数据链路和半成品实现的一轮工程大清洗执行计划，强调先建台账、再删重收口、最后恢复主工程可读性。
 - [CURRENT_GAME_ITERATION_PRIORITIES_2026-04-03.md](./CURRENT_GAME_ITERATION_PRIORITIES_2026-04-03.md)：当前阶段最值得优先做什么、为什么，以及它和审计/PRD 的对应关系。
 - [CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md](./CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md)：在不新增前端创作流程的前提下，围绕当前 Agent 创作动线做收口、删重、补通和文档收束的大白话执行规划。
 - [EXPRESS_BACKEND_REFACTOR_PLAN_2026-04-08.md](./EXPRESS_BACKEND_REFACTOR_PLAN_2026-04-08.md)：基于“前端只做表现、逻辑与数据全部后端化”的工程重构规划。
diff --git a/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md b/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md
new file mode 100644
index 00000000..b006e0f0
--- /dev/null
+++ b/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md
@@ -0,0 +1,212 @@
+# Agent 结果页深度编辑回写主链方案（阶段一）
+
+更新时间：`2026-04-20`
+
+## 1. 这次阶段一先改什么
+
+这次阶段一不做结果页只读化。
+
+结果页继续保留当前已经可用、而且用户已经满意的这些能力：
+
+1. 结果页继续允许深度编辑世界设定
+2. 结果页继续允许编辑角色、场景、营地、封面
+3. 结果页继续允许直接新增角色与地点
+4. 结果页继续保留当前已有的浏览、自动保存、进入世界体验
+
+这次真正要补的是：
+
+**把结果页里产出的完整 `CustomWorldProfile`，同步回 `Agent session`，让结果页编辑不再游离在主链之外。**
+
+---
+
+## 2. 当前真正的问题
+
+当前链路里，结果页虽然还能深度编辑，但数据职责是分裂的：
+
+```text
+Agent session
+-> 前端 buildCustomWorldProfileFromAgentDraft()
+-> 结果页本地 profile
+-> 结果页继续深度编辑
+-> 自动保存到 custom-world-library
+-> 进入世界
+```
+
+这里最大的问题不是“结果页能编辑”，而是：
+
+1. 结果页编辑后的最新世界结构，没有稳定回写到 `Agent session`
+2. 用户从结果页返回 Agent 工作区后，session 侧仍可能停留在较旧的草稿状态
+3. “结果页当前看到的世界”“Agent session 当前保存的草稿”“作品库里自动保存的 profile”可能不是同一份东西
+4. 进入世界时如果直接吃当前前端内存态，也会继续放大这个分叉
+
+所以阶段一要解决的是：
+
+**结果页仍然是深度编辑器，但它编辑的是 Agent 主链里的当前结果快照，不是脱链的本地副本。**
+
+---
+
+## 3. 阶段一目标状态
+
+阶段一把链路先收成下面这样：
+
+```text
+Agent session
+-> 前端 buildCustomWorldProfileFromAgentDraft() 生成结果页初始 profile
+-> 用户在结果页继续深度编辑 profile
+-> 前端调用新的 Agent action，把完整结果 profile 同步回 session
+-> session 保留：
+   - 当前 foundation draft
+   - 当前 legacyResultProfile 结果快照
+   - 重编译后的 draftCards / assetCoverage / suggestedActions
+-> 自动保存与进入世界都优先基于已同步的 session 结果快照执行
+```
+
+这一步仍然是过渡态，不是最终态。
+
+因为：
+
+1. 阶段一还不打通 `publish_world`
+2. 阶段一也不把结果页改造成完全原生的 draft 编辑器
+3. 阶段一允许继续保留 `draftProfile.legacyResultProfile` 作为兼容桥接字段
+
+但至少要做到：
+
+**结果页的深度编辑，必须进入 Agent session 的单一主链。**
+
+---
+
+## 4. 阶段一具体实现边界
+
+## 4.1 新增 Agent action：`sync_result_profile`
+
+阶段一新增一个面向结果页的 Agent action：
+
+```ts
+{ action: 'sync_result_profile'; profile: CustomWorldProfileRecord }
+```
+
+用途只有一个：
+
+把结果页当前完整 `CustomWorldProfile` 快照同步回 `CustomWorldAgentSessionRecord`。
+
+它不是发布动作，也不是世界编译动作。
+它只是把结果页当前编辑结果认回主链。
+
+---
+
+## 4.2 服务端写回策略
+
+服务端接到 `sync_result_profile` 后，按下面规则处理：
+
+1. 读取当前 session
+2. 取当前 `draftProfile`
+3. 保留当前 draft 层已有的结构化字段：
+   - `playableNpcs / storyNpcs / landmarks / camp`
+   - `factions / threads / chapters / sceneChapters`
+   - `worldHook / playerPremise / openingSituation / iconicElements`
+   - 以及现有资产、scene chapter 等字段
+4. 把结果页传来的完整 `CustomWorldProfile` 写入 `draftProfile.legacyResultProfile`
+5. 对于 draft 层里本来就和结果页一一对应、且结果页已经改动的字段，同步覆盖基础摘要字段：
+   - `name`
+   - `subtitle`
+   - `summary`
+   - `tone`
+   - `playerGoal`
+   - `majorFactions`
+   - `coreConflicts`
+6. 重新编译 `draftCards`
+7. 重建 `assetCoverage`
+8. 刷新 `suggestedActions`
+9. 写入 action result message 和 checkpoint
+
+这里故意不在阶段一做“把完整 runtime profile 反解成一整套全量 foundation draft 结构”的大重构。
+
+原因是：
+
+1. 结果页当前已经支持很多深度编辑字段
+2. 如果现在硬做全量反编译，最容易把场景章节、多幕、资产字段写坏
+3. 阶段一应该先保证“结果页编辑不脱链”，而不是一次性重做所有模型映射
+
+---
+
+## 4.3 前端触发策略
+
+前端只在 `customWorldResultViewSource === 'agent-draft'` 时走这条同步链。
+
+具体规则：
+
+1. 结果页 profile 每次发生变化时，继续允许本地即时更新
+2. 但在自动保存前，先把 profile 通过 `sync_result_profile` 同步到 Agent session
+3. 返回创作时，如果要重新读 Agent 草稿，也应优先以最新 session 为准
+4. 点击“进入世界”时，先拉取最新 session，再重新 `buildCustomWorldProfileFromAgentDraft()`，避免吃到旧的前端缓存 profile
+
+这样阶段一就能做到：
+
+1. 结果页编辑体验不变
+2. Agent session 成为结果页编辑后的可恢复真相源
+3. 自动保存、返回创作、进入世界三条路都围绕同一份 session-backed 结果快照
+
+---
+
+## 5. 阶段一明确不做什么
+
+这次阶段一明确不做：
+
+1. 不关闭结果页当前已有的编辑器能力
+2. 不删除结果页当前已有的 AI 新增角色/地点能力
+3. 不打通 `publish_world`
+4. 不把 `legacyResultProfile` 直接删掉
+5. 不把结果页整个改写成只操作 draft card 的新系统
+6. 不把旧 `custom-world/sessions` 链在本阶段直接物理移除
+
+---
+
+## 6. 验收标准
+
+阶段一做完后，至少要满足下面这些结果：
+
+1. Agent 草稿结果页继续保持当前深度编辑体验不变
+2. 结果页发生编辑后，Agent session 中能看到同步后的最新结果快照
+3. 从结果页返回创作后，不会明显回退到较旧的草稿态
+4. 点击“进入世界”时，会优先使用最新 session 重新编译结果，而不是只依赖前端旧内存态
+5. 自动保存到作品库的 profile 与当前 session 结果快照保持一致
+
+---
+
+## 7. 一句话结论
+
+阶段一不是收掉结果页，而是把结果页继续保留为深度编辑器，同时补上一条正式的 session 回写链，让它不再游离在 Agent 主链之外。
+
+---
+
+## 8. 2026-04-20 实际落地结果
+
+本轮已经按阶段一目标完成下面这些收口：
+
+1. 前端结果页自动保存时，若当前来源是 `agent-draft`，会先执行 `sync_result_profile`
+2. `sync_result_profile` 完成后，自动保存不再直接写旧的前端内存 profile，而是优先保存从最新 session 重新 `buildCustomWorldProfileFromAgentDraft()` 得到的结果快照
+3. 点击“进入世界”时，仍会先同步 session，再基于最新 session 重编译 profile 后进入世界
+4. 点击“返回创作”时，也会先做一次结果页到 session 的同步兜底，再返回 Agent 工作区
+5. 为避免用户刚从结果页返回工作区又被自动重开逻辑顶回结果页，前端补了一层显式返回抑制标记
+6. 服务端 `sync_result_profile` 现已按阶段一边界收窄为“保留 foundation draft 结构，只更新基础摘要字段和 `legacyResultProfile`”，没有提前做整套 runtime -> draft 反解
+
+这意味着阶段一当前已经把下面三条路径收回到同一条 session 主链：
+
+1. 自动保存到作品库
+2. 返回 Agent 工作区继续创作
+3. 从结果页直接进入世界
+
+## 9. 本轮仍然保留的阶段性边界
+
+这次落地后，仍然保留文档原先约定的过渡边界：
+
+1. 结果页深度编辑能力不做收缩
+2. `draftProfile.legacyResultProfile` 继续作为兼容桥接字段保留
+3. `publish_world` 仍未在这一轮打通
+4. 前端仍然使用 `buildCustomWorldProfileFromAgentDraft()` 作为 session -> 结果页的兼容编译层
+
+所以下一阶段如果要继续推进，重点应转向：
+
+1. 降低前端对 legacy profile 编译桥接的依赖
+2. 继续把发布链路收口到 Agent session / service 侧
+3. 逐步缩减结果页直改 legacy profile 的历史职责
diff --git a/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md b/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md
new file mode 100644
index 00000000..03b727b9
--- /dev/null
+++ b/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md
@@ -0,0 +1,75 @@
+# Agent 结果页与平台入口收口方案（阶段二）
+
+更新时间：`2026-04-20`
+
+## 1. 阶段二目标
+
+阶段一已经把 Agent 结果页编辑快照同步回 session 主链。阶段二不继续扩大结果页编辑能力，而是把入口和职责继续收紧：
+
+1. 平台“创作”入口统一读取 `custom-world/works` 聚合列表
+2. Agent 草稿和已保存作品在同一个入口里展示
+3. 草稿点击后恢复 Agent session，已保存作品点击后进入作品详情
+4. Agent 结果页不再暴露“继续在结果页补世界结构”的新增入口
+
+一句话目标：
+
+**让用户从平台创作入口能稳定找回草稿和作品，同时让结果页更像收口预览，而不是另一套编辑器。**
+
+---
+
+## 2. 本阶段不做什么
+
+阶段二明确不做：
+
+1. 不物理删除旧 `custom-world/sessions` 链
+2. 不打通 `publish_world`
+3. 不重做结果页 UI
+4. 不删除已保存作品的继续编辑入口
+5. 不把结果页整体改成只读
+
+这些事项留给后续阶段继续拆。
+
+---
+
+## 3. 平台入口落地规则
+
+平台“创作”Tab 改为优先展示 `listCustomWorldWorks()` 的聚合结果：
+
+1. `agent_session` 类型展示为草稿，可点击恢复 Agent 工作区
+2. `published_profile` 类型展示为作品，可点击进入作品详情
+3. 聚合接口失败时保留现有作品库 `myEntries` 兜底
+4. 不新增平行页面，复用已有 `CustomWorldCreationHub`
+
+这样用户不再需要依赖隐藏 sessionId 或旧作品库入口才能找回创作。
+
+---
+
+## 4. 结果页职责收口规则
+
+Agent 来源结果页继续保留：
+
+1. 浏览世界、角色、场景
+2. 自动保存
+3. 返回 Agent 工作区
+4. 进入世界
+
+Agent 来源结果页本阶段收紧：
+
+1. 不再显示直接新增可扮演角色、场景角色、场景的入口
+2. 不再把“去 Agent 调整设定”设计成结果页内部继续补世界结构
+3. 如需继续调整，返回 Agent 工作区
+
+已保存作品的结果页仍保持现有编辑能力，避免破坏作品库已有体验。
+
+---
+
+## 5. 验收标准
+
+阶段二完成后应满足：
+
+1. 平台“创作”Tab 能看到 Agent 草稿和已保存作品的统一列表
+2. 点击 Agent 草稿能恢复对应 Agent 工作区
+3. 点击已保存作品能进入原有作品详情
+4. Agent 结果页不再显示直接新增角色/地点的入口
+5. 已保存作品的结果页编辑能力不受影响
+
diff --git a/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md b/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md
new file mode 100644
index 00000000..93548f78
--- /dev/null
+++ b/docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md
@@ -0,0 +1,148 @@
+# Agent 结果页旧链降级与预览冻结方案（阶段三）
+
+更新时间：`2026-04-20`
+
+## 1. 阶段三目标
+
+阶段一已经把结果页编辑同步回 Agent session 主链。
+
+阶段二已经把平台“创作”入口统一到 `custom-world/works` 聚合列表，并收紧了 Agent 结果页里的新增入口。
+
+阶段三不继续扩功能，而是继续做两件事：
+
+1. 让旧 pipeline 在主入口里进一步降级，不再和 Agent 主链抢“草稿”职责
+2. 让 Agent 来源结果页进一步冻结为“预览/收口层”，不再继续承担 legacy profile 直改编辑器职责
+
+一句话目标：
+
+**把还在和 Agent 主链并行的旧职责继续降级，避免系统自己和自己打架。**
+
+---
+
+## 2. 当前剩余问题
+
+虽然阶段一、二已经把主链收紧了不少，但当前还保留两个明显的并行口：
+
+### 2.1 创作中心里旧 library 草稿仍可能继续冒充主草稿
+
+当前 `listCustomWorldWorkSummaries()` 会把 runtime library 里的所有 profile 都折成 `published_profile` 类型返回。
+
+这意味着：
+
+1. `visibility = 'draft'` 的 library 草稿仍会继续出现在创作中心
+2. 创作中心里同时存在：
+   - Agent session 草稿
+   - library 草稿
+   - 已发布作品
+3. 用户看到的“草稿”概念仍然可能混成两套
+
+阶段三需要明确：
+
+**创作中心主入口只认 Agent session 草稿 和 已发布作品，不再继续把 library draft 当主草稿展示。**
+
+---
+
+### 2.2 Agent 结果页仍能继续打开旧 legacy 编辑器
+
+当前 Agent 来源结果页虽然已经不再暴露“新增角色/新增地点”入口，但仍然保留下面这些旧编辑链：
+
+1. 点击世界概述/基本设定仍能打开 legacy world editor
+2. 点击角色、场景、封面仍能继续进入旧 profile 编辑弹窗
+3. 这些编辑器本质上仍然是在改 legacy `CustomWorldProfile`
+
+这会带来两个问题：
+
+1. Agent 结果页继续像一套“旧编辑器”
+2. “去 Agent 调整设定”和“结果页直接改 legacy profile”两条路仍然并行存在
+
+阶段三需要明确：
+
+**Agent 来源结果页继续保留浏览、自动保存、返回创作、进入世界，但不再继续承担 legacy profile 深编辑职责。**
+
+---
+
+## 3. 阶段三落地规则
+
+## 3.1 创作中心只展示两类主入口内容
+
+`custom-world/works` 在阶段三只保留下面两类条目：
+
+1. `agent_session`
+   - 统一视为草稿
+   - 点击后恢复 Agent 工作区
+2. `published_profile`
+   - 统一视为已发布作品
+   - 点击后进入现有作品详情
+
+明确不再把下面这类内容继续塞进创作中心主入口：
+
+1. library 中 `visibility = 'draft'` 的兼容草稿
+
+这些兼容草稿仍然保留在作品库/详情链路里，不在本阶段物理删除，但不再继续占创作中心“草稿主入口”。
+
+---
+
+## 3.2 Agent 来源结果页冻结为预览态
+
+当 `customWorldResultViewSource === 'agent-draft'` 时，结果页阶段三继续保留：
+
+1. 浏览世界信息
+2. 浏览角色、地点、场景结构
+3. 自动保存
+4. 返回 Agent 工作区
+5. 进入世界
+
+同时阶段三进一步收紧：
+
+1. 不再打开世界/角色/场景/封面的 legacy 编辑弹窗
+2. 不再提供删除角色、删除场景等旧 profile 直改入口
+3. Agent 来源结果页上的对象卡统一作为“查看详情”预览卡使用
+
+已保存作品的结果页编辑能力继续保留，不在本阶段收缩，避免破坏已有作品库编辑体验。
+
+---
+
+## 3.3 结果页同步动作只在真的发生差异时执行
+
+阶段一补的 `sync_result_profile` 仍然保留，但阶段三补一个行为约束：
+
+1. 如果当前 Agent 结果页 profile 和最新 session 重编译结果签名一致
+2. 那么返回创作、进入世界、自动保存前不再重复触发一次 `sync_result_profile`
+
+目的不是省接口，而是明确：
+
+**结果页同步是“有改动才回写”的主链动作，不是每次离开页面都机械重放。**
+
+---
+
+## 4. 阶段三明确不做什么
+
+这次阶段三明确不做：
+
+1. 不物理删除旧 `custom-world/sessions` 相关服务与兼容代码
+2. 不打通 `publish_world`
+3. 不把前端 `buildCustomWorldProfileFromAgentDraft()` 兼容编译层移除
+4. 不删除 `draftProfile.legacyResultProfile`
+5. 不收缩已保存作品的 legacy 编辑器能力
+
+阶段三只做主入口降级与 Agent 结果页职责冻结，不做更大的模型替换。
+
+---
+
+## 5. 验收标准
+
+阶段三完成后应满足：
+
+1. 创作中心不再把 library draft 兼容作品继续显示为“草稿主入口”
+2. 创作中心里只保留 Agent 草稿和已发布作品两类主入口内容
+3. Agent 来源结果页不再能继续打开 legacy 世界/角色/场景编辑弹窗
+4. 已保存作品结果页编辑能力不受影响
+5. Agent 结果页在未发生改动时，返回创作/进入世界/自动保存不会重复触发无意义的 `sync_result_profile`
+
+---
+
+## 6. 一句话结论
+
+阶段三不是删除兼容层，而是把它们继续降级到不会抢主流程职责的位置上：
+
+**创作中心只认 Agent 草稿和已发布作品，Agent 结果页只负责预览与收口，不再继续充当旧编辑器。**
diff --git a/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md b/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
new file mode 100644
index 00000000..4c4ae9e7
--- /dev/null
+++ b/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
@@ -0,0 +1,92 @@
+# Agent 创作流四阶段收口检查与旧链清理边界
+
+更新时间：`2026-04-21`
+
+## 1. 结论先行
+
+当前这条 Agent 创作流已经完成阶段一到阶段三的主要收口。
+
+阶段四中的“文档清理”已经开始做，但还没有形成独立、完整的新主链。
+
+因此这轮可以执行的清理只有一类：
+
+1. 删除已经不再从当前主入口可达的旧 `custom-world/sessions` 世界生成链
+2. 保留仍在服务 `Agent session` 主链或已保存作品兼容编辑体验的底层能力
+
+这轮不做：
+
+1. 不删 `Agent session` 的底层持久化能力
+2. 不删已保存作品结果页的 legacy 编辑器兼容能力
+3. 不删 `custom-world/works` 聚合入口
+
+---
+
+## 2. 阶段完成度
+
+### 2.1 阶段一
+
+已完成。
+
+证据：
+
+1. 结果页新增了 `sync_result_profile`
+2. 结果页编辑后的快照可以回写到 `Agent session`
+3. 自动保存、返回创作、进入世界都优先走 session 主链
+
+### 2.2 阶段二
+
+已完成。
+
+证据：
+
+1. 平台创作入口已切到 `custom-world/works`
+2. 草稿恢复优先回 Agent 工作区
+3. Agent 结果页不再继续新增旧编辑入口
+
+### 2.3 阶段三
+
+已完成。
+
+证据：
+
+1. 创作中心不再把 library draft 当主草稿入口
+2. Agent 来源结果页冻结为预览收口层
+3. 重复同步动作已收敛为有差异才执行
+
+### 2.4 阶段四
+
+未完全完成。
+
+原因：
+
+1. 文档清理已经开始，但还没有完整收束到单一结论文档
+2. 旧 `custom-world/sessions` 生成链虽然已经不在主入口上，但还未清干净
+
+---
+
+## 3. 本轮允许删除的旧链
+
+允许删除：
+
+1. `src/services/aiService.ts` 里的旧 `custom-world/sessions` 请求函数
+2. `server-node/src/routes/runtimeRoutes.ts` 里的旧 `custom-world/sessions` 路由
+3. `server-node/src/services/customWorldGenerationService.ts`
+4. 与这条旧链对应的测试
+
+不允许删除：
+
+1. `server-node/src/services/customWorldSessionStore.ts`
+2. `server-node/src/repositories/runtimeRepository.ts` 中被 Agent session 复用的 session 持久化能力
+3. `src/services/aiService.ts` 里仍在使用的 `generateCustomWorldProfile` 及其现代封装
+
+---
+
+## 4. 删除完成后的判断标准
+
+如果旧链清理成功，应满足：
+
+1. `src/services/aiService.ts` 不再暴露旧 `custom-world/sessions` 请求函数
+2. `server-node/src/routes/runtimeRoutes.ts` 不再挂旧 session 路由
+3. 仓库里不再有主流程可达的旧世界生成入口
+4. Agent 主链与已保存作品编辑链仍然可用
+
diff --git a/docs/technical/README.md b/docs/technical/README.md
index 30c71580..42272303 100644
--- a/docs/technical/README.md
+++ b/docs/technical/README.md
@@ -9,6 +9,10 @@
 - [CUSTOM_WORLD_DRAFT_GENERATION_FAILURE_ANALYSIS_AND_FIX_2026-04-20.md](./CUSTOM_WORLD_DRAFT_GENERATION_FAILURE_ANALYSIS_AND_FIX_2026-04-20.md)：世界草稿生成失败后等待页误显示为“卡在编译草稿卡”的根因拆解、主链与增强链路边界，以及本次修复策略。
 - [CUSTOM_WORLD_AUTO_ASSET_VISIBILITY_FIX_2026-04-20.md](./CUSTOM_WORLD_AUTO_ASSET_VISIBILITY_FIX_2026-04-20.md)：世界草稿里“资产已生成但结果页看不到”的根因拆解，包含角色主形象展示、分幕背景露出和 fallback 资源格式修复。
 - [CUSTOM_WORLD_PHASE4_COUNT_SEMANTICS_ALIGNMENT_2026-04-20.md](./CUSTOM_WORLD_PHASE4_COUNT_SEMANTICS_ALIGNMENT_2026-04-20.md)：Phase4 新增角色/地点后草稿作品卡数量统计与测试断言的语义对齐说明。
+- [AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md)：阶段一保持结果页深度编辑能力不变，同时把结果页完整世界快照同步回 Agent session 主链的方案说明。
+- [AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md)：阶段二把平台创作入口统一到聚合作品列表，并收紧 Agent 结果页的新增入口职责边界。
+- [AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md)：阶段三继续降级旧 pipeline，让创作中心只认 Agent 草稿与已发布作品，并把 Agent 结果页冻结为预览收口层。
+- [CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md](./CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md)：对照当前优化计划核查四阶段完成度，并明确这轮只允许物理删除旧 `custom-world/sessions` 世界生成链，不误伤 Agent 主链与已保存作品兼容编辑链。
 - [TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md](./TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md)：把外部仓库 TXT 模式完整迁入当前项目的冻结边界、模块映射、分阶段计划与验收清单。
 - [NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md](./NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md)：当前 Node 运行时后端的技术栈、入口、鉴权、存储与接口知识图谱。
 - [EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md](./EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md)：Express 后端当前 contract 冻结版本、热点文件编辑规则与集成窗口清单。
diff --git a/packages/shared/src/contracts/customWorldAgent.ts b/packages/shared/src/contracts/customWorldAgent.ts
index c40f56a9..4be16d88 100644
--- a/packages/shared/src/contracts/customWorldAgent.ts
+++ b/packages/shared/src/contracts/customWorldAgent.ts
@@ -428,6 +428,7 @@ export type CustomWorldAgentOperationType =
   | 'regenerate_scope'
   | 'draft_foundation'
   | 'update_draft_card'
+  | 'sync_result_profile'
   | 'generate_characters'
   | 'generate_landmarks'
   | 'generate_role_assets'
@@ -497,6 +498,10 @@ export type CustomWorldAgentActionRequest =
         value: string;
       }>;
     }
+  | {
+      action: 'sync_result_profile';
+      profile: Record<string, unknown>;
+    }
   | {
       action: 'generate_characters';
       count: number;
diff --git a/server-node/src/app.test.ts b/server-node/src/app.test.ts
index e3760fbc..799f1353 100644
--- a/server-node/src/app.test.ts
+++ b/server-node/src/app.test.ts
@@ -2503,6 +2503,34 @@ test('custom world works endpoint returns draft sessions and published worlds to
 
     assert.equal(publishResponse.status, 200);
 
+    const publishMutationResponse = await httpRequest(
+      `${baseUrl}/api/runtime/custom-world-library/world-published/publish`,
+      withBearer(entry.token, {
+        method: 'POST',
+      }),
+    );
+
+    assert.equal(publishMutationResponse.status, 200);
+
+    const draftOnlyResponse = await httpRequest(
+      `${baseUrl}/api/runtime/custom-world-library/world-draft-only`,
+      withBearer(entry.token, {
+        method: 'PUT',
+        body: JSON.stringify({
+          profile: {
+            id: 'world-draft-only',
+            name: '旧兼容草稿',
+            subtitle: '仍保留在作品库，但不再进入创作中心',
+            summary: '这个条目用来验证阶段三不会继续把 library draft 当主草稿展示。',
+            playableNpcs: [{ id: 'hero-draft', name: '旧草稿角色' }],
+            landmarks: [{ id: 'port-draft', name: '旧草稿地点' }],
+          },
+        }),
+      }),
+    );
+
+    assert.equal(draftOnlyResponse.status, 200);
+
     const worksResponse = await httpRequest(
       `${baseUrl}/api/runtime/custom-world/works`,
       {
@@ -2542,6 +2570,10 @@ test('custom world works endpoint returns draft sessions and published worlds to
           item.canEnterWorld === true,
       ),
     );
+    assert.equal(
+      worksPayload.items.some((item) => item.profileId === 'world-draft-only'),
+      false,
+    );
   });
 });
 
@@ -3038,6 +3070,117 @@ test('custom world agent update_draft_card action updates draft profile and card
   );
 });
 
+test('custom world agent sync_result_profile action writes result snapshot back over http', async () => {
+  await withTestServer(
+    'custom-world-agent-sync-result-profile-http',
+    async ({ baseUrl, context }) => {
+      installTestCustomWorldAgentSingleTurnLlm(context);
+      const entry = await authEntry(
+        baseUrl,
+        'cw_agent_sync_result',
+        'secret123',
+      );
+      const session = await createObjectRefiningCustomWorldAgentSession({
+        baseUrl,
+        token: entry.token,
+      });
+
+      const actionResponse = await httpRequest(
+        `${baseUrl}/api/runtime/custom-world/agent/sessions/${encodeURIComponent(session.sessionId)}/actions`,
+        withBearer(entry.token, {
+          method: 'POST',
+          body: JSON.stringify({
+            action: 'sync_result_profile',
+            profile: {
+              id: `agent-draft-${session.sessionId}`,
+              settingText: '被海雾吞没的旧航路群岛',
+              name: '潮雾列岛·结果页回写版',
+              subtitle: '旧灯塔与失控航路',
+              summary: '结果页里的最新世界概述已经回写到当前草稿。',
+              tone: '压抑、潮湿、悬疑',
+              playerGoal: '查清沉船夜与假航灯背后的操盘链。',
+              templateWorldType: 'WUXIA',
+              majorFactions: ['守灯会', '航运公会'],
+              coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+              attributeSchema: {
+                id: 'schema:test',
+                worldId: 'CUSTOM',
+                schemaVersion: 1,
+                schemaName: '测试',
+                generatedFrom: {
+                  worldType: 'CUSTOM',
+                  worldName: '潮雾列岛·结果页回写版',
+                  settingSummary: '测试',
+                  tone: '测试',
+                  conflictCore: '测试',
+                },
+                slots: [],
+              },
+              playableNpcs: [],
+              storyNpcs: [],
+              items: [],
+              landmarks: [],
+              generationMode: 'full',
+              generationStatus: 'complete',
+            },
+          }),
+        }),
+      );
+      const actionPayload = (await actionResponse.json()) as {
+        operation: {
+          operationId: string;
+          status: string;
+        };
+      };
+
+      assert.equal(actionResponse.status, 200);
+      assert.equal(actionPayload.operation.status, 'queued');
+
+      await waitForCustomWorldAgentOperation({
+        baseUrl,
+        token: entry.token,
+        sessionId: session.sessionId,
+        operationId: actionPayload.operation.operationId,
+        expectedStatus: 'completed',
+      });
+
+      const sessionResponse = await httpRequest(
+        `${baseUrl}/api/runtime/custom-world/agent/sessions/${encodeURIComponent(session.sessionId)}`,
+        {
+          headers: {
+            Authorization: `Bearer ${entry.token}`,
+          },
+        },
+      );
+      const sessionPayload = (await sessionResponse.json()) as {
+        draftProfile: {
+          name?: string;
+          summary?: string;
+          legacyResultProfile?: {
+            name?: string;
+            playerGoal?: string;
+          };
+        } | null;
+      };
+
+      assert.equal(sessionResponse.status, 200);
+      assert.equal(sessionPayload.draftProfile?.name, '潮雾列岛·结果页回写版');
+      assert.equal(
+        sessionPayload.draftProfile?.summary,
+        '结果页里的最新世界概述已经回写到当前草稿。',
+      );
+      assert.equal(
+        sessionPayload.draftProfile?.legacyResultProfile?.name,
+        '潮雾列岛·结果页回写版',
+      );
+      assert.equal(
+        sessionPayload.draftProfile?.legacyResultProfile?.playerGoal,
+        '查清沉船夜与假航灯背后的操盘链。',
+      );
+    },
+  );
+});
+
 test('custom world agent generate_characters action appends character cards over http', async () => {
   await withTestServer(
     'custom-world-agent-phase4-generate-characters-http',
diff --git a/server-node/src/routes/customWorldAgent.ts b/server-node/src/routes/customWorldAgent.ts
index 33e8762f..aa353e61 100644
--- a/server-node/src/routes/customWorldAgent.ts
+++ b/server-node/src/routes/customWorldAgent.ts
@@ -39,6 +39,10 @@ const actionSchema = z.discriminatedUnion('action', [
       )
       .min(1),
   }),
+  z.object({
+    action: z.literal('sync_result_profile'),
+    profile: z.record(z.string(), z.unknown()),
+  }),
   z.object({
     action: z.literal('generate_characters'),
     count: z.number().int().min(1).max(3),
diff --git a/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts b/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts
new file mode 100644
index 00000000..d64c6c3e
--- /dev/null
+++ b/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts
@@ -0,0 +1,229 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import sharp from 'sharp';
+
+import { createDatabase } from '../db.js';
+import { RuntimeRepository } from '../repositories/runtimeRepository.js';
+import { loadConfig } from '../config.js';
+import { CustomWorldAgentSessionStore } from '../services/customWorldAgentSessionStore.js';
+
+type RecordValue = Record<string, unknown>;
+
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function isRecord(value: unknown): value is RecordValue {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function toRecordArray(value: unknown) {
+  return Array.isArray(value)
+    ? value.filter((entry): entry is RecordValue => isRecord(entry))
+    : [];
+}
+
+function resolvePublicAssetPath(publicDir: string, imageSrc: unknown) {
+  const normalizedImageSrc = toText(imageSrc);
+  if (!normalizedImageSrc) {
+    return null;
+  }
+
+  return path.join(publicDir, normalizedImageSrc.replace(/^\/+/u, ''));
+}
+
+async function ensureSquareRoleImage(publicDir: string, imageSrc: unknown) {
+  const assetPath = resolvePublicAssetPath(publicDir, imageSrc);
+  if (!assetPath || !fs.existsSync(assetPath)) {
+    return null;
+  }
+
+  const metadata = await sharp(assetPath).metadata();
+  if (
+    typeof metadata.width === 'number' &&
+    typeof metadata.height === 'number' &&
+    metadata.width === metadata.height
+  ) {
+    return {
+      imageSrc: toText(imageSrc),
+      updated: false,
+      width: metadata.width,
+      height: metadata.height,
+    };
+  }
+
+  const squaredBuffer = await sharp(assetPath)
+    .resize(1024, 1024, {
+      fit: 'cover',
+      position: 'attention',
+    })
+    .png()
+    .toBuffer();
+  fs.writeFileSync(assetPath, squaredBuffer);
+
+  return {
+    imageSrc: toText(imageSrc),
+    updated: true,
+    width: 1024,
+    height: 1024,
+  };
+}
+
+async function main() {
+  const userId = 'user_02b1dea4e951b13fe53db236560bdf28';
+  const sessionId = 'custom-world-agent-session-019e192a4060d18b92df127f1dafe8ae';
+  const profileId = 'custom-world-mo744tca-深海奇境';
+  const config = loadConfig({
+    projectRoot: path.resolve(process.cwd(), '..'),
+  });
+  const db = await createDatabase(config);
+
+  try {
+    const runtimeRepository = new RuntimeRepository(db);
+    const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+    const session = await sessionStore.getSnapshot(userId, sessionId);
+    if (!session || !isRecord(session.draftProfile)) {
+      throw new Error('未找到目标世界草稿 session，无法同步历史保存档案。');
+    }
+
+    const savedProfileEntry = (
+      await runtimeRepository.listCustomWorldProfiles(userId)
+    ).find((entry) => entry.profileId === profileId);
+    if (!savedProfileEntry) {
+      throw new Error('未找到目标 saved profile，无法同步历史保存档案。');
+    }
+
+    const draftProfile = session.draftProfile;
+    const nextProfile = JSON.parse(
+      JSON.stringify(savedProfileEntry.profile),
+    ) as RecordValue;
+
+    const draftPlayableById = new Map(
+      toRecordArray(draftProfile.playableNpcs).map((entry) => [toText(entry.id), entry] as const),
+    );
+    const draftStoryById = new Map(
+      toRecordArray(draftProfile.storyNpcs).map((entry) => [toText(entry.id), entry] as const),
+    );
+    const draftLandmarkById = new Map(
+      toRecordArray(draftProfile.landmarks).map((entry) => [toText(entry.id), entry] as const),
+    );
+    const draftSceneChapterBySceneId = new Map(
+      toRecordArray(draftProfile.sceneChapters).map((entry) => [toText(entry.sceneId), entry] as const),
+    );
+
+    const playableNpcs = toRecordArray(nextProfile.playableNpcs).map((role) => {
+      const draftRole = draftPlayableById.get(toText(role.id));
+      if (!draftRole) {
+        return role;
+      }
+
+      return {
+        ...role,
+        imageSrc: toText(draftRole.imageSrc) || role.imageSrc,
+        generatedVisualAssetId:
+          toText(draftRole.generatedVisualAssetId) || role.generatedVisualAssetId,
+      };
+    });
+
+    const storyNpcs = toRecordArray(nextProfile.storyNpcs).map((role) => {
+      const draftRole = draftStoryById.get(toText(role.id));
+      if (!draftRole) {
+        return role;
+      }
+
+      return {
+        ...role,
+        imageSrc: toText(draftRole.imageSrc) || role.imageSrc,
+        generatedVisualAssetId:
+          toText(draftRole.generatedVisualAssetId) || role.generatedVisualAssetId,
+      };
+    });
+
+    const landmarks = toRecordArray(nextProfile.landmarks).map((landmark) => {
+      const draftLandmark = draftLandmarkById.get(toText(landmark.id));
+      const draftSceneChapter = draftSceneChapterBySceneId.get(toText(landmark.id));
+      const firstActImageSrc =
+        toRecordArray(draftSceneChapter?.acts)
+          .map((act) => toText(act.backgroundImageSrc))
+          .find(Boolean) || '';
+
+      return {
+        ...landmark,
+        imageSrc:
+          toText(draftLandmark?.imageSrc) ||
+          firstActImageSrc ||
+          toText(landmark.imageSrc) ||
+          undefined,
+      };
+    });
+
+    const sceneChapterBlueprints = toRecordArray(
+      nextProfile.sceneChapterBlueprints,
+    ).map((chapter) => {
+      const draftChapter = draftSceneChapterBySceneId.get(toText(chapter.sceneId));
+      if (!draftChapter) {
+        return chapter;
+      }
+
+      const draftActById = new Map(
+        toRecordArray(draftChapter.acts).map((act) => [toText(act.id), act] as const),
+      );
+
+      return {
+        ...chapter,
+        acts: toRecordArray(chapter.acts).map((act) => {
+          const draftAct = draftActById.get(toText(act.id));
+          if (!draftAct) {
+            return act;
+          }
+
+          return {
+            ...act,
+            backgroundImageSrc:
+              toText(draftAct.backgroundImageSrc) || act.backgroundImageSrc,
+            backgroundAssetId:
+              toText(draftAct.backgroundAssetId) || act.backgroundAssetId,
+          };
+        }),
+      };
+    });
+
+    const roleImageUpdates = await Promise.all(
+      [...playableNpcs, ...storyNpcs].map((role) =>
+        ensureSquareRoleImage(config.publicDir, role.imageSrc),
+      ),
+    );
+
+    nextProfile.playableNpcs = playableNpcs;
+    nextProfile.storyNpcs = storyNpcs;
+    nextProfile.landmarks = landmarks;
+    nextProfile.sceneChapterBlueprints = sceneChapterBlueprints;
+
+    const updatedEntry = await runtimeRepository.upsertCustomWorldProfile(
+      userId,
+      profileId,
+      nextProfile,
+      savedProfileEntry.authorDisplayName || '玩家',
+    );
+
+    const summary = {
+      profileId,
+      syncedPlayableCount: playableNpcs.length,
+      syncedStoryCount: storyNpcs.length,
+      syncedLandmarkCount: landmarks.length,
+      syncedSceneChapterCount: sceneChapterBlueprints.length,
+      squareRoleImagesUpdated: roleImageUpdates.filter((entry) => entry?.updated).length,
+      coverImageSrc: updatedEntry.entry.coverImageSrc,
+    };
+
+    console.log(JSON.stringify(summary, null, 2));
+  } finally {
+    await db.close();
+  }
+}
+
+void main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
diff --git a/server-node/src/services/customWorldAgentOrchestrator.ts b/server-node/src/services/customWorldAgentOrchestrator.ts
index 956f80d4..a1292a02 100644
--- a/server-node/src/services/customWorldAgentOrchestrator.ts
+++ b/server-node/src/services/customWorldAgentOrchestrator.ts
@@ -16,6 +16,8 @@ import type {
 } from '../../../packages/shared/src/contracts/customWorldAgent.js';
 import { badRequest, notFound } from '../errors.js';
 import { prepareEventStreamResponse } from '../http.js';
+import { normalizeCustomWorldProfile } from '../modules/custom-world/runtimeProfile.js';
+import type { CustomWorldProfile } from '../modules/custom-world/runtimeTypes.js';
 import { CustomWorldAgentAssetBridgeService } from './customWorldAgentAssetBridgeService.js';
 import { CustomWorldAgentAutoAssetService } from './customWorldAgentAutoAssetService.js';
 import { CustomWorldAgentChangeSummaryService } from './customWorldAgentChangeSummaryService.js';
@@ -150,6 +152,8 @@ function buildOperation(type: CustomWorldAgentOperationRecord['type']) {
       ? '正在把已确认设定编成第一版世界底稿。'
       : type === 'update_draft_card'
         ? '正在把这次设定改动写回草稿。'
+        : type === 'sync_result_profile'
+          ? '正在把结果页里的世界快照同步回当前草稿。'
         : type === 'generate_characters'
           ? '正在围绕当前底稿补出新角色。'
           : type === 'generate_landmarks'
@@ -194,6 +198,27 @@ function buildRoleAssetSyncResultText(params: {
   return `已把「${params.roleName}」的角色资产写回草稿，当前状态：${params.assetStatusLabel}。`;
 }
 
+function syncResultProfileIntoDraftProfile(params: {
+  currentDraftProfile: Record<string, unknown> | null | undefined;
+  resultProfile: CustomWorldProfile;
+}) {
+  const currentDraftProfile = params.currentDraftProfile ?? {};
+  const resultProfile = params.resultProfile;
+
+  return {
+    // 阶段一只回写基础摘要和完整 legacy 快照，避免把结果页的运行时结构反向拆回 foundation draft。
+    ...currentDraftProfile,
+    name: resultProfile.name,
+    subtitle: resultProfile.subtitle,
+    summary: resultProfile.summary,
+    tone: resultProfile.tone,
+    playerGoal: resultProfile.playerGoal,
+    majorFactions: resultProfile.majorFactions,
+    coreConflicts: resultProfile.coreConflicts,
+    legacyResultProfile: resultProfile as unknown as Record<string, unknown>,
+  } satisfies Record<string, unknown>;
+}
+
 function buildQuestionLines(
   pendingClarifications: CustomWorldPendingClarification[],
 ) {
@@ -548,6 +573,7 @@ export class CustomWorldAgentOrchestrator {
 
     if (
       payload.action === 'update_draft_card' ||
+      payload.action === 'sync_result_profile' ||
       payload.action === 'generate_characters' ||
       payload.action === 'generate_landmarks' ||
       payload.action === 'generate_role_assets' ||
@@ -595,6 +621,32 @@ export class CustomWorldAgentOrchestrator {
       };
     }
 
+    if (payload.action === 'sync_result_profile') {
+      const normalizedProfile = normalizeCustomWorldProfile(
+        payload.profile,
+        '',
+      );
+      if (!normalizedProfile) {
+        throw badRequest('sync_result_profile requires a valid profile');
+      }
+
+      const operation = buildOperation('sync_result_profile');
+      await this.sessionStore.createOperation(userId, sessionId, operation);
+      void this.processSyncResultProfileOperation({
+        userId,
+        sessionId,
+        operationId: operation.operationId,
+        payload: {
+          ...payload,
+          profile: normalizedProfile as unknown as Record<string, unknown>,
+        },
+      });
+
+      return {
+        operation,
+      };
+    }
+
     if (payload.action === 'generate_characters') {
       if (payload.count < 1 || payload.count > 3) {
         throw badRequest('generate_characters count must be between 1 and 3');
@@ -1113,6 +1165,97 @@ export class CustomWorldAgentOrchestrator {
     }
   }
 
+  private async processSyncResultProfileOperation(params: {
+    userId: string;
+    sessionId: string;
+    operationId: string;
+    payload: Extract<
+      CustomWorldAgentActionRequest,
+      { action: 'sync_result_profile' }
+    >;
+  }) {
+    const { userId, sessionId, operationId, payload } = params;
+
+    try {
+      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
+        status: 'running',
+        phaseLabel: '同步结果页快照',
+        phaseDetail: '正在把结果页里的最新世界结构写回当前草稿。',
+        progress: 36,
+      });
+
+      const latestSession = (await this.sessionStore.get(
+        userId,
+        sessionId,
+      )) as CustomWorldAgentSessionRecord | null;
+      if (!latestSession) {
+        throw new Error('custom world agent session not found');
+      }
+
+      const resultProfile = payload.profile as unknown as CustomWorldProfile;
+      const nextDraftProfile = syncResultProfileIntoDraftProfile({
+        currentDraftProfile: latestSession.draftProfile,
+        resultProfile,
+      });
+
+      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
+        phaseLabel: '重编译草稿摘要',
+        phaseDetail: '正在刷新草稿卡摘要、资产覆盖和结果页恢复快照。',
+        progress: 72,
+      });
+
+      const nextDraftCards = this.draftCompiler.compileDraftCards(nextDraftProfile);
+      const assetCoverage = rebuildRoleAssetCoverage(nextDraftProfile);
+      const nextStage =
+        latestSession.stage === 'visual_refining'
+          ? ('visual_refining' as const)
+          : ('object_refining' as const);
+      const nextSuggestedActions = buildSuggestedActions({
+        stage: nextStage,
+        isReady: true,
+        draftProfile: nextDraftProfile,
+        draftCards: nextDraftCards,
+      });
+
+      await this.sessionStore.replaceDerivedState(userId, sessionId, {
+        stage: nextStage,
+        draftProfile: nextDraftProfile,
+        draftCards: nextDraftCards,
+        assetCoverage,
+        suggestedActions: nextSuggestedActions,
+        recommendedReplies: [],
+      });
+      await this.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: '同步结果页编辑',
+      });
+      await this.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: '结果页里的最新世界结构已经同步回当前草稿。',
+        }),
+      );
+
+      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
+        status: 'completed',
+        phaseLabel: '结果页快照已同步',
+        phaseDetail: '当前结果页编辑内容已经并回 Agent 草稿主链。',
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
+        status: 'failed',
+        phaseLabel: '结果页同步失败',
+        phaseDetail: '这一轮结果页编辑没有成功写回当前草稿。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'sync result profile failed',
+      });
+    }
+  }
+
   private async processGenerateCharactersOperation(params: {
     userId: string;
     sessionId: string;
diff --git a/server-node/src/services/customWorldAgentPhase4.test.ts b/server-node/src/services/customWorldAgentPhase4.test.ts
index b5e347f0..d2a6302b 100644
--- a/server-node/src/services/customWorldAgentPhase4.test.ts
+++ b/server-node/src/services/customWorldAgentPhase4.test.ts
@@ -227,6 +227,200 @@ test('phase4 update_draft_card writes back draft profile and recompiles summarie
   );
 });
 
+test('phase4 sync_result_profile writes result-page snapshot back into session draft chain', async () => {
+  const runtimeRepository = createRuntimeRepositoryStub();
+  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+  });
+  const userId = 'user-phase4-sync-result-profile';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+
+  const response = await orchestrator.executeAction(userId, session.sessionId, {
+    action: 'sync_result_profile',
+    profile: {
+      id: `agent-draft-${session.sessionId}`,
+      settingText: '被海雾吞没的旧航路群岛',
+      name: '潮雾列岛·结果页精修版',
+      subtitle: '旧灯塔与失控航路',
+      summary: '结果页已经把世界概述继续往沉船夜暗线收紧。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清沉船夜与假航灯的真正操盘者。',
+      templateWorldType: 'WUXIA',
+      majorFactions: ['守灯会', '航运公会'],
+      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      attributeSchema: {
+        id: 'schema:test',
+        worldId: 'CUSTOM',
+        schemaVersion: 1,
+        schemaName: '测试',
+        generatedFrom: {
+          worldType: 'CUSTOM',
+          worldName: '潮雾列岛·结果页精修版',
+          settingSummary: '测试',
+          tone: '测试',
+          conflictCore: '测试',
+        },
+        slots: [],
+      },
+      playableNpcs: [],
+      storyNpcs: [],
+      items: [],
+      landmarks: [],
+      generationMode: 'full',
+      generationStatus: 'complete',
+    },
+  });
+  const operation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    response.operation.operationId,
+  );
+  const snapshot = await orchestrator.getSessionSnapshot(userId, session.sessionId);
+  const profile = normalizeFoundationDraftProfile(snapshot?.draftProfile);
+  const draftRecord = snapshot?.draftProfile as Record<string, unknown> | null;
+  const legacyResultProfile = draftRecord?.legacyResultProfile as
+    | Record<string, unknown>
+    | undefined;
+
+  assert.equal(operation?.status, 'completed');
+  assert.equal(profile?.name, '潮雾列岛·结果页精修版');
+  assert.equal(
+    profile?.summary,
+    '结果页已经把世界概述继续往沉船夜暗线收紧。',
+  );
+  assert.equal(legacyResultProfile?.name, '潮雾列岛·结果页精修版');
+  assert.equal(
+    legacyResultProfile?.playerGoal,
+    '查清沉船夜与假航灯的真正操盘者。',
+  );
+  assert.ok(
+    snapshot?.messages.some(
+      (message) =>
+        message.kind === 'action_result' &&
+        message.text.includes('结果页里的最新世界结构已经同步回当前草稿'),
+    ),
+  );
+});
+
+test('phase4 sync_result_profile keeps existing foundation structure while updating summary snapshot', async () => {
+  const runtimeRepository = createRuntimeRepositoryStub();
+  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+  });
+  const userId = 'user-phase4-sync-result-profile-structure';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+  const baselineProfile = normalizeFoundationDraftProfile(session.draftProfile);
+  const baselinePlayableName = baselineProfile?.playableNpcs[0]?.name;
+  const baselineStoryName = baselineProfile?.storyNpcs[0]?.name;
+  const baselineLandmarkName = baselineProfile?.landmarks[0]?.name;
+
+  assert.ok(baselinePlayableName);
+  assert.ok(baselineStoryName);
+  assert.ok(baselineLandmarkName);
+
+  const response = await orchestrator.executeAction(userId, session.sessionId, {
+    action: 'sync_result_profile',
+    profile: {
+      id: `agent-draft-${session.sessionId}`,
+      settingText: '被海雾吞没的旧航路群岛',
+      name: '潮雾列岛·结果页精修版',
+      subtitle: '旧灯塔与失控航路',
+      summary: '结果页已经把世界概述继续往沉船夜暗线收紧。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清沉船夜与假航灯的真正操盘者。',
+      templateWorldType: 'WUXIA',
+      majorFactions: ['守灯会', '航运公会'],
+      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      attributeSchema: {
+        id: 'schema:test',
+        worldId: 'CUSTOM',
+        schemaVersion: 1,
+        schemaName: '测试',
+        generatedFrom: {
+          worldType: 'CUSTOM',
+          worldName: '潮雾列岛·结果页精修版',
+          settingSummary: '测试',
+          tone: '测试',
+          conflictCore: '测试',
+        },
+        slots: [],
+      },
+      playableNpcs: [
+        {
+          id: 'playable-runtime-only',
+          name: '结果页临时角色',
+          title: '运行时角色',
+          role: '测试角色',
+          description: '不应该直接覆盖 foundation draft。',
+          backstory: '仅用于验证 sync 边界。',
+          personality: '谨慎',
+          motivation: '验证同步边界',
+          combatStyle: '观察',
+          initialAffinity: 0,
+          relationshipHooks: [],
+          tags: [],
+        },
+      ],
+      storyNpcs: [
+        {
+          id: 'story-runtime-only',
+          name: '结果页临时场景角色',
+          title: '运行时场景角色',
+          role: '测试角色',
+          description: '不应该直接覆盖 foundation draft。',
+          backstory: '仅用于验证 sync 边界。',
+          personality: '克制',
+          motivation: '验证同步边界',
+          combatStyle: '观察',
+          initialAffinity: 0,
+          relationshipHooks: [],
+          tags: [],
+        },
+      ],
+      items: [],
+      landmarks: [
+        {
+          id: 'landmark-runtime-only',
+          name: '结果页临时地点',
+          description: '不应该直接覆盖 foundation draft。',
+          dangerLevel: '低',
+          sceneNpcIds: [],
+          connections: [],
+        },
+      ],
+      generationMode: 'full',
+      generationStatus: 'complete',
+    },
+  });
+  const operation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    response.operation.operationId,
+  );
+  const snapshot = await orchestrator.getSessionSnapshot(userId, session.sessionId);
+  const profile = normalizeFoundationDraftProfile(snapshot?.draftProfile);
+  const draftRecord = snapshot?.draftProfile as Record<string, unknown> | null;
+  const legacyResultProfile = draftRecord?.legacyResultProfile as
+    | Record<string, unknown>
+    | undefined;
+
+  assert.equal(operation?.status, 'completed');
+  assert.equal(profile?.name, '潮雾列岛·结果页精修版');
+  assert.equal(profile?.playableNpcs[0]?.name, baselinePlayableName);
+  assert.equal(profile?.storyNpcs[0]?.name, baselineStoryName);
+  assert.equal(profile?.landmarks[0]?.name, baselineLandmarkName);
+  assert.equal(legacyResultProfile?.name, '潮雾列岛·结果页精修版');
+  assert.equal(
+    (legacyResultProfile?.playableNpcs as Array<{ name?: string }> | undefined)?.[0]
+      ?.name,
+    '结果页临时角色',
+  );
+});
+
 test('phase4 generate_characters appends story npcs and updates work summary counts', async () => {
   const runtimeRepository = createRuntimeRepositoryStub();
   const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
@@ -323,3 +517,33 @@ test('phase4 generate_landmarks appends new landmark cards and checkpoints', asy
   );
   assert.ok((latestSessionRecord?.checkpoints.length ?? 0) >= 2);
 });
+
+test('phase4 work summaries exclude library draft entries after phase3 downgrade', async () => {
+  const runtimeRepository = createRuntimeRepositoryStub();
+  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+  });
+  const userId = 'user-phase4-work-summary-phase3';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+
+  await runtimeRepository.upsertCustomWorldProfile(userId, 'library-draft-1', {
+    id: 'library-draft-1',
+    name: '旧兼容草稿',
+    subtitle: '仍保留在作品库',
+    summary: '不应该继续出现在创作中心 works 聚合里。',
+    playableNpcs: [],
+    landmarks: [],
+  });
+
+  const workItems = await listCustomWorldWorkSummaries(userId, {
+    runtimeRepository,
+    customWorldAgentSessions: sessionStore,
+  });
+
+  assert.ok(workItems.some((item) => item.sessionId === session.sessionId));
+  assert.equal(
+    workItems.some((item) => item.profileId === 'library-draft-1'),
+    false,
+  );
+});
diff --git a/server-node/src/services/customWorldWorkSummaryService.ts b/server-node/src/services/customWorldWorkSummaryService.ts
index 79989c2a..a77454d5 100644
--- a/server-node/src/services/customWorldWorkSummaryService.ts
+++ b/server-node/src/services/customWorldWorkSummaryService.ts
@@ -171,6 +171,12 @@ function isLibraryEntry(
   );
 }
 
+function isPublishedLibraryEntry(
+  value: unknown,
+): value is CustomWorldLibraryEntry<CustomWorldProfileRecord> {
+  return isLibraryEntry(value) && value.visibility === 'published';
+}
+
 export async function listCustomWorldWorkSummaries(
   userId: string,
   dependencies: {
@@ -216,8 +222,10 @@ export async function listCustomWorldWorkSummaries(
     };
   });
 
-  const publishedItems: CustomWorldWorkSummary[] = profiles.map((profile) => {
-    const libraryEntry = isLibraryEntry(profile) ? profile : null;
+  const publishedItems: CustomWorldWorkSummary[] = profiles
+    .filter((profile) => isPublishedLibraryEntry(profile))
+    .map((profile) => {
+      const libraryEntry = profile;
     const profileRecord = (
       libraryEntry?.profile ?? profile
     ) as CustomWorldProfileRecord & Record<string, unknown>;
@@ -237,59 +245,55 @@ export async function listCustomWorldWorkSummaries(
       (entry) => Boolean(toText(entry.generatedAnimationSetId)),
     ).length;
 
-    return {
-      workId: `published:${toText(profileRecord.id) || updatedAt}`,
-      sourceType: 'published_profile',
-      status: 'published',
-      title:
-        (libraryEntry ? toText(libraryEntry.worldName) : '') ||
-        toText(profileRecord.name) ||
-        '未命名世界',
-      subtitle:
-        (libraryEntry ? toText(libraryEntry.subtitle) : '') ||
-        toText(profileRecord.subtitle) ||
-        '已保存作品',
-      summary:
-        (libraryEntry ? toText(libraryEntry.summaryText) : '') ||
-        toText(profileRecord.summary) ||
-        '这个世界已经可以直接进入体验。',
-      coverImageSrc:
-        (libraryEntry ? libraryEntry.coverImageSrc : null) ||
-        coverPresentation.imageSrc,
-      coverRenderMode: coverPresentation.renderMode,
-      coverCharacterImageSrcs: coverPresentation.characterImageSrcs,
-      updatedAt,
-      publishedAt:
-        (libraryEntry ? toText(libraryEntry.publishedAt) : '') ||
-        toText(profileRecord.publishedAt) ||
+      return {
+        workId: `published:${toText(profileRecord.id) || updatedAt}`,
+        sourceType: 'published_profile',
+        status: 'published',
+        title:
+          toText(libraryEntry.worldName) ||
+          toText(profileRecord.name) ||
+          '未命名世界',
+        subtitle:
+          toText(libraryEntry.subtitle) ||
+          toText(profileRecord.subtitle) ||
+          '已保存作品',
+        summary:
+          toText(libraryEntry.summaryText) ||
+          toText(profileRecord.summary) ||
+          '这个世界已经可以直接进入体验。',
+        coverImageSrc: libraryEntry.coverImageSrc || coverPresentation.imageSrc,
+        coverRenderMode: coverPresentation.renderMode,
+        coverCharacterImageSrcs: coverPresentation.characterImageSrcs,
         updatedAt,
-      stage: 'published',
-      stageLabel: '已发布',
-      playableNpcCount:
-        (libraryEntry?.playableNpcCount ?? 0) > 0
-          ? libraryEntry!.playableNpcCount
-          : playableNpcs.length,
-      landmarkCount:
-        (libraryEntry?.landmarkCount ?? 0) > 0
-          ? libraryEntry!.landmarkCount
-          : landmarks.length,
-      roleVisualReadyCount,
-      roleAnimationReadyCount,
-      roleAssetSummaryLabel:
-        roleAnimationReadyCount > 0
-          ? `动作已就绪 ${roleAnimationReadyCount}`
-          : roleVisualReadyCount > 0
-            ? `主图已就绪 ${roleVisualReadyCount}`
-            : null,
-      sessionId: null,
-      profileId:
-        (libraryEntry ? toText(libraryEntry.profileId) : '') ||
-        toText(profileRecord.id) ||
-        null,
-      canResume: false,
-      canEnterWorld: true,
-    };
-  });
+        publishedAt:
+          toText(libraryEntry.publishedAt) ||
+          toText(profileRecord.publishedAt) ||
+          updatedAt,
+        stage: 'published',
+        stageLabel: '已发布',
+        playableNpcCount:
+          libraryEntry.playableNpcCount > 0
+            ? libraryEntry.playableNpcCount
+            : playableNpcs.length,
+        landmarkCount:
+          libraryEntry.landmarkCount > 0
+            ? libraryEntry.landmarkCount
+            : landmarks.length,
+        roleVisualReadyCount,
+        roleAnimationReadyCount,
+        roleAssetSummaryLabel:
+          roleAnimationReadyCount > 0
+            ? `动作已就绪 ${roleAnimationReadyCount}`
+            : roleVisualReadyCount > 0
+              ? `主图已就绪 ${roleVisualReadyCount}`
+              : null,
+        sessionId: null,
+        profileId:
+          toText(libraryEntry.profileId) || toText(profileRecord.id) || null,
+        canResume: false,
+        canEnterWorld: true,
+      };
+    });
 
   return [...draftItems, ...publishedItems].sort((left, right) =>
     right.updatedAt.localeCompare(left.updatedAt),
diff --git a/src/components/CustomWorldResultView.test.tsx b/src/components/CustomWorldResultView.test.tsx
index 679bb68a..05fe3658 100644
--- a/src/components/CustomWorldResultView.test.tsx
+++ b/src/components/CustomWorldResultView.test.tsx
@@ -398,3 +398,30 @@ test('landmark tab uses first act image as scene card preview and keeps chapter
     '/generated-custom-world-scenes/scene-act-1.png',
   );
 });
+
+test('readOnly result view hides edit and create actions for agent preview mode', async () => {
+  const user = userEvent.setup();
+
+  render(
+    <CustomWorldResultView
+      profile={baseProfile}
+      previewCharacters={[]}
+      isGenerating={false}
+      progress={0}
+      progressLabel=""
+      error={null}
+      onBack={() => {}}
+      onProfileChange={() => {}}
+      readOnly
+      compactAgentResultMode
+    />,
+  );
+
+  expect(screen.queryByRole('button', { name: /^编辑$/u })).toBeNull();
+
+  await user.click(screen.getByRole('button', { name: /可扮演角色/u }));
+  expect(screen.queryByRole('button', { name: '新增可扮演角色' })).toBeNull();
+
+  await user.click(screen.getByRole('button', { name: /场景角色/u }));
+  expect(screen.queryByRole('button', { name: /批量删除/u })).toBeNull();
+});
diff --git a/src/components/CustomWorldResultView.tsx b/src/components/CustomWorldResultView.tsx
index 1ca3ddb8..ce4e89fc 100644
--- a/src/components/CustomWorldResultView.tsx
+++ b/src/components/CustomWorldResultView.tsx
@@ -40,6 +40,7 @@ interface CustomWorldResultViewProps {
   regenerateActionLabel?: string;
   enterWorldActionLabel?: string;
   autoSaveState?: 'idle' | 'saving' | 'saved' | 'error';
+  compactAgentResultMode?: boolean;
 }
 
 type EntityGenerationKind = 'playable' | 'story' | 'landmark';
@@ -372,6 +373,7 @@ export function CustomWorldResultView({
   regenerateActionLabel = '重新生成',
   enterWorldActionLabel = '进入世界',
   autoSaveState = 'idle',
+  compactAgentResultMode = false,
 }: CustomWorldResultViewProps) {
   const [editorTarget, setEditorTarget] =
     useState<CustomWorldEditorTarget | null>(null);
@@ -609,9 +611,11 @@ export function CustomWorldResultView({
           onProfileChange={onProfileChange}
           onDeleteStoryNpcs={handleDeleteStoryNpcs}
           onDeleteLandmarks={handleDeleteLandmarks}
-          createActionLabel={readOnly ? undefined : createLabel}
+          createActionLabel={
+            readOnly || compactAgentResultMode ? undefined : createLabel
+          }
           onCreateAction={
-            readOnly || !createTarget
+            readOnly || compactAgentResultMode || !createTarget
               ? undefined
               : () => {
                   if (activeTab === 'playable') {
diff --git a/src/components/custom-world-home/CustomWorldCreationHub.tsx b/src/components/custom-world-home/CustomWorldCreationHub.tsx
index 31247959..e4f4e97c 100644
--- a/src/components/custom-world-home/CustomWorldCreationHub.tsx
+++ b/src/components/custom-world-home/CustomWorldCreationHub.tsx
@@ -135,12 +135,12 @@ export function CustomWorldCreationHub({
                 key={item.workId}
                 item={item}
                 onClick={() => {
-                  if (item.status === 'draft' && item.sessionId) {
+                  if (item.sourceType === 'agent_session' && item.sessionId) {
                     onResumeDraft(item.sessionId);
                     return;
                   }
 
-                  if (item.status === 'published' && item.profileId) {
+                  if (item.profileId) {
                     onEnterPublished(item.profileId);
                   }
                 }}
diff --git a/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx b/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx
index 46f52405..94365b7d 100644
--- a/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx
+++ b/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx
@@ -6,14 +6,15 @@ import { useState } from 'react';
 import { beforeEach, expect, test, vi } from 'vitest';
 
 import type { CustomWorldAgentSessionSnapshot } from '../../../packages/shared/src/contracts/customWorldAgent';
+import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
 import {
   createCustomWorldAgentSession,
   executeCustomWorldAgentAction,
   getCustomWorldAgentOperation,
   getCustomWorldAgentSession,
+  listCustomWorldWorks,
   streamCustomWorldAgentMessage,
 } from '../../services/aiService';
-import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
 import type { AuthUser } from '../../services/authService';
 import {
   clearProfileBrowseHistory,
@@ -54,12 +55,30 @@ async function clickFirstAsyncButtonByName(
   await user.click(buttons[0]!);
 }
 
+async function openCreationHub(user: ReturnType<typeof userEvent.setup>) {
+  await clickFirstButtonByName(user, '创作');
+  expect(await screen.findByText('创作中心')).toBeTruthy();
+}
+
+async function openNewRpgCreation(
+  user: ReturnType<typeof userEvent.setup>,
+) {
+  await openCreationHub(user);
+  const createButtons = await screen.findAllByRole('button', {
+    name: /新建作品/u,
+  });
+  await user.click(createButtons.at(-1)!);
+  expect(screen.getByText('选择创作类型')).toBeTruthy();
+  await user.click(screen.getByRole('button', { name: /角色扮演 RPG/u }));
+}
+
 vi.mock('../../services/aiService', () => ({
   createCustomWorldAgentSession: vi.fn(),
   executeCustomWorldAgentAction: vi.fn(),
   generateCustomWorldProfile: vi.fn(),
   getCustomWorldAgentOperation: vi.fn(),
   getCustomWorldAgentSession: vi.fn(),
+  listCustomWorldWorks: vi.fn(),
   streamCustomWorldAgentMessage: vi.fn(),
 }));
 
@@ -340,6 +359,7 @@ beforeEach(() => {
   vi.mocked(createCustomWorldAgentSession).mockResolvedValue({
     session: mockSession,
   });
+  vi.mocked(listCustomWorldWorks).mockResolvedValue([]);
   vi.mocked(executeCustomWorldAgentAction).mockResolvedValue({
     operation: {
       operationId: 'operation-draft-foundation-1',
@@ -369,8 +389,11 @@ test('create tab opens game type modal, keeps AIRP and visual novel locked, and
 
   render(<TestWrapper />);
 
-  await clickFirstButtonByName(user, '创作');
-  await clickFirstButtonByName(user, /开启新的创作/u);
+  await openCreationHub(user);
+  const createButtons = await screen.findAllByRole('button', {
+    name: /新建作品/u,
+  });
+  await user.click(createButtons.at(-1)!);
 
   expect(screen.getByText('选择创作类型')).toBeTruthy();
 
@@ -393,6 +416,52 @@ test('create tab opens game type modal, keeps AIRP and visual novel locked, and
   ).toBeTruthy();
 });
 
+test('create tab uses unified creation hub and can resume an agent draft', async () => {
+  const user = userEvent.setup();
+
+  vi.mocked(listCustomWorldWorks).mockResolvedValue([
+    {
+      workId: 'draft:custom-world-agent-session-1',
+      sourceType: 'agent_session',
+      status: 'draft',
+      title: '潮雾列岛',
+      subtitle: '精修对象',
+      summary: '玩家是失职返乡的守灯人。',
+      coverImageSrc: null,
+      coverRenderMode: 'image',
+      coverCharacterImageSrcs: [],
+      updatedAt: '2026-04-20T10:00:00.000Z',
+      publishedAt: null,
+      stage: 'object_refining',
+      stageLabel: '精修对象',
+      playableNpcCount: 3,
+      landmarkCount: 4,
+      roleVisualReadyCount: 1,
+      roleAnimationReadyCount: 0,
+      roleAssetSummaryLabel: '沈砺 · 主图已生成',
+      sessionId: 'custom-world-agent-session-1',
+      profileId: null,
+      canResume: true,
+      canEnterWorld: false,
+    },
+  ]);
+
+  render(<TestWrapper withAuth />);
+
+  await openCreationHub(user);
+
+  expect(
+    screen.getByRole('button', { name: /继续精修/u }),
+  ).toBeTruthy();
+  expect(screen.getByRole('button', { name: /继续精修/u })).toBeTruthy();
+
+  await user.click(screen.getByRole('button', { name: /继续精修/u }));
+
+  expect(
+    await screen.findByText('Agent工作区：custom-world-agent-session-1'),
+  ).toBeTruthy();
+});
+
 test('clicking a public work while logged out routes through requireAuth', async () => {
   const user = userEvent.setup();
   const requireAuth = vi.fn();
@@ -448,10 +517,7 @@ test('selecting RPG creation while logged out routes through requireAuth', async
     />,
   );
 
-  await clickFirstButtonByName(user, '创作');
-  await clickFirstButtonByName(user, /开启新的创作/u);
-  await user.click(screen.getByRole('button', { name: /角色扮演 RPG/u }));
-
+  await openNewRpgCreation(user);
   expect(requireAuth).toHaveBeenCalledTimes(1);
   expect(createCustomWorldAgentSession).not.toHaveBeenCalled();
 });
@@ -461,9 +527,7 @@ test('starting draft generation leaves the agent workspace and shows the generat
 
   render(<TestWrapper />);
 
-  await clickFirstButtonByName(user, '创作');
-  await clickFirstButtonByName(user, /开启新的创作/u);
-  await user.click(screen.getByRole('button', { name: /角色扮演 RPG/u }));
+  await openNewRpgCreation(user);
 
   expect(
     await screen.findByText('Agent工作区：custom-world-agent-session-1'),
@@ -490,7 +554,7 @@ test('starting draft generation leaves the agent workspace and shows the generat
   expect(screen.queryByText('先告诉我你想做一个怎样的 RPG 世界。')).toBeNull();
 });
 
-test('existing draft sessions enter the legacy result layout directly', async () => {
+test('existing draft sessions enter the agent preview layout without opening legacy editor', async () => {
   const user = userEvent.setup();
 
   vi.mocked(getCustomWorldAgentOperation).mockResolvedValue({
@@ -595,9 +659,7 @@ test('existing draft sessions enter the legacy result layout directly', async ()
 
   render(<TestWrapper />);
 
-  await clickFirstButtonByName(user, '创作');
-  await clickFirstButtonByName(user, /开启新的创作/u);
-  await user.click(screen.getByRole('button', { name: /角色扮演 RPG/u }));
+  await openNewRpgCreation(user);
 
   await waitFor(
     async () => {
@@ -611,13 +673,295 @@ test('existing draft sessions enter the legacy result layout directly', async ()
   expect(screen.queryByText(/Agent工作区/u)).toBeNull();
   expect(screen.queryByRole('button', { name: /^锚点/u })).toBeNull();
   expect(screen.getByText(/基本设定/u)).toBeTruthy();
+  expect(screen.queryByRole('button', { name: /新增场景角色/u })).toBeNull();
 
   await user.click(screen.getByRole('button', { name: /场景角色/u }));
-  await user.click(screen.getByRole('button', { name: /顾潮音/u }));
+  expect(screen.getByRole('button', { name: /顾潮音/u })).toBeTruthy();
+  expect(screen.queryByText(/编辑场景角色：顾潮音/u)).toBeNull();
+  expect(screen.queryByRole('button', { name: /AI生成/u })).toBeNull();
+  expect(screen.queryByText('技能')).toBeNull();
+});
 
-  expect(await screen.findByText(/编辑场景角色：顾潮音/u)).toBeTruthy();
-  expect(screen.getByRole('button', { name: /AI生成/u })).toBeTruthy();
-  expect(screen.getByText('技能')).toBeTruthy();
+test('agent draft result back button returns to workspace without redundant sync when session is already latest', async () => {
+  const user = userEvent.setup();
+
+  vi.mocked(executeCustomWorldAgentAction).mockResolvedValue({
+    operation: {
+      operationId: 'operation-sync-result-profile-1',
+      type: 'sync_result_profile',
+      status: 'queued',
+      phaseLabel: '同步结果页快照',
+      phaseDetail: '正在把结果页里的最新世界结构写回当前草稿。',
+      progress: 24,
+      error: null,
+    },
+  });
+  vi.mocked(getCustomWorldAgentOperation).mockResolvedValue({
+    operationId: 'operation-sync-result-profile-1',
+    type: 'sync_result_profile',
+    status: 'completed',
+    phaseLabel: '结果页快照已同步',
+    phaseDetail: '当前结果页编辑内容已经并回 Agent 草稿主链。',
+    progress: 100,
+    error: null,
+  });
+
+  const resultSession = {
+    ...mockSession,
+    stage: 'object_refining' as const,
+    creatorIntent: {
+      sourceMode: 'card',
+      worldHook: '被海雾吞没的旧航路群岛',
+      playerPremise: '玩家回到群岛调查沉船真相。',
+      themeKeywords: ['海雾', '旧航路'],
+      toneDirectives: ['压抑', '悬疑'],
+      openingSituation: '首夜就有陌生船只闯入禁航区。',
+      coreConflicts: ['航运公会与守灯会争夺航路控制权'],
+      keyFactions: [],
+      keyCharacters: [],
+      keyLandmarks: [],
+      iconicElements: ['会移动的海雾'],
+      forbiddenDirectives: [],
+      rawSettingText: '',
+    },
+    draftProfile: {
+      name: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '第一版世界底稿已经整理完成。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清沉船与禁航区异动的真相。',
+      majorFactions: ['守灯会', '航运公会'],
+      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      playableNpcs: [
+        {
+          id: 'playable-1',
+          name: '沈砺',
+          title: '旧航路引路人',
+          role: '关键同行者',
+          publicIdentity: '最熟悉旧航路的人。',
+          publicMask: '看上去像可靠旧友。',
+          currentPressure: '他必须在两股势力间站队。',
+          hiddenHook: '暗中替沉船商盟引路。',
+          relationToPlayer: '旧友兼潜在背叛者',
+          threadIds: ['thread-1'],
+          summary: '他像旧友，但也像一把始终没收回鞘的刀。',
+        },
+      ],
+      storyNpcs: [
+        {
+          id: 'story-1',
+          name: '顾潮音',
+          title: '守灯会值夜人',
+          role: '场景关键角色',
+          publicIdentity: '负责夜间巡灯与封锁。',
+          publicMask: '对外一直冷静克制。',
+          currentPressure: '她知道更多禁航区真相。',
+          hiddenHook: '曾亲眼见过失控海雾吞船。',
+          relationToPlayer: '最早愿意交换线索的人',
+          threadIds: ['thread-1'],
+          summary: '她总像比所有人更早知道海雾会往哪一侧压下来。',
+        },
+      ],
+      landmarks: [
+        {
+          id: 'landmark-1',
+          name: '回潮旧灯塔',
+          purpose: '观察雾潮与往来船只',
+          mood: '潮湿、压抑、风声不止',
+          importance: '开局核心场景',
+          characterIds: ['story-1'],
+          threadIds: ['thread-1'],
+          summary: '旧灯塔是整片群岛最先看见异动的地方。',
+        },
+      ],
+      factions: [],
+      threads: [],
+      chapters: [],
+      worldHook: '被海雾吞没的旧航路群岛',
+      playerPremise: '玩家回到群岛调查沉船真相。',
+      openingSituation: '首夜就有陌生船只闯入禁航区。',
+      iconicElements: ['会移动的海雾'],
+      sourceAnchorSummary: '海雾、旧灯塔、失控航路。',
+      legacyResultProfile: {
+        id: 'agent-draft-custom-world-agent-session-1',
+        settingText: '被海雾吞没的旧航路群岛',
+        name: '潮雾列岛·同步后',
+        subtitle: '旧灯塔与失控航路',
+        summary: '同步后的结果页快照已经回写到 session。',
+        tone: '压抑、潮湿、悬疑',
+        playerGoal: '查清沉船与禁航区异动的真相。',
+        templateWorldType: 'WUXIA',
+        majorFactions: ['守灯会', '航运公会'],
+        coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+        playableNpcs: [],
+        storyNpcs: [],
+        items: [],
+        landmarks: [],
+        generationMode: 'full',
+        generationStatus: 'complete',
+      },
+    },
+    draftCards: [
+      {
+        id: 'world-foundation',
+        kind: 'world',
+        title: '潮雾列岛',
+        subtitle: '旧灯塔与失控航路',
+        summary: '第一版世界底稿已经整理完成。',
+        status: 'warning',
+        linkedIds: ['playable-1', 'story-1', 'landmark-1'],
+        warningCount: 0,
+      },
+    ],
+  } satisfies CustomWorldAgentSessionSnapshot;
+  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(resultSession);
+
+  render(<TestWrapper />);
+
+  await openNewRpgCreation(user);
+
+  await waitFor(
+    async () => {
+      expect(await screen.findByText('世界档案')).toBeTruthy();
+      expect(screen.getByRole('button', { name: /返回创作/u })).toBeTruthy();
+    },
+    { timeout: 2500 },
+  );
+
+  await user.click(screen.getByRole('button', { name: /返回创作/u }));
+
+  await waitFor(() => {
+    expect(
+      screen.getByText('Agent工作区：custom-world-agent-session-1'),
+    ).toBeTruthy();
+  });
+
+  expect(
+    vi.mocked(executeCustomWorldAgentAction).mock.calls.some(
+      ([sessionId, payload]) =>
+        sessionId === 'custom-world-agent-session-1' &&
+        payload?.action === 'sync_result_profile',
+    ),
+  ).toBe(false);
+  expect(screen.queryByText('世界档案')).toBeNull();
+});
+
+test('agent draft result auto-save persists the latest profile rebuilt from synced session', async () => {
+  const user = userEvent.setup();
+
+  vi.mocked(executeCustomWorldAgentAction).mockResolvedValue({
+    operation: {
+      operationId: 'operation-sync-result-profile-2',
+      type: 'sync_result_profile',
+      status: 'queued',
+      phaseLabel: '同步结果页快照',
+      phaseDetail: '正在把结果页里的最新世界结构写回当前草稿。',
+      progress: 24,
+      error: null,
+    },
+  });
+  vi.mocked(getCustomWorldAgentOperation).mockResolvedValue({
+    operationId: 'operation-sync-result-profile-2',
+    type: 'sync_result_profile',
+    status: 'completed',
+    phaseLabel: '结果页快照已同步',
+    phaseDetail: '当前结果页编辑内容已经并回 Agent 草稿主链。',
+    progress: 100,
+    error: null,
+  });
+
+  const syncedSession = {
+    ...mockSession,
+    stage: 'object_refining' as const,
+    creatorIntent: {
+      sourceMode: 'card',
+      worldHook: '被海雾吞没的旧航路群岛',
+      playerPremise: '玩家回到群岛调查沉船真相。',
+      themeKeywords: ['海雾', '旧航路'],
+      toneDirectives: ['压抑', '悬疑'],
+      openingSituation: '首夜就有陌生船只闯入禁航区。',
+      coreConflicts: ['航运公会与守灯会争夺航路控制权'],
+      keyFactions: [],
+      keyCharacters: [],
+      keyLandmarks: [],
+      iconicElements: ['会移动的海雾'],
+      forbiddenDirectives: [],
+      rawSettingText: '',
+    },
+    draftProfile: {
+      name: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '第一版世界底稿已经整理完成。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清沉船与禁航区异动的真相。',
+      majorFactions: ['守灯会', '航运公会'],
+      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      playableNpcs: [],
+      storyNpcs: [],
+      landmarks: [],
+      factions: [],
+      threads: [],
+      chapters: [],
+      worldHook: '被海雾吞没的旧航路群岛',
+      playerPremise: '玩家回到群岛调查沉船真相。',
+      openingSituation: '首夜就有陌生船只闯入禁航区。',
+      iconicElements: ['会移动的海雾'],
+      sourceAnchorSummary: '海雾、旧灯塔、失控航路。',
+      legacyResultProfile: {
+        id: 'agent-draft-custom-world-agent-session-1',
+        settingText: '被海雾吞没的旧航路群岛',
+        name: '潮雾列岛·session最新版',
+        subtitle: '旧灯塔与失控航路',
+        summary: '作品库应该保存这份同步后的最新快照。',
+        tone: '压抑、潮湿、悬疑',
+        playerGoal: '查清沉船与禁航区异动的真相。',
+        templateWorldType: 'WUXIA',
+        majorFactions: ['守灯会', '航运公会'],
+        coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+        playableNpcs: [],
+        storyNpcs: [],
+        items: [],
+        landmarks: [],
+        generationMode: 'full',
+        generationStatus: 'complete',
+      },
+    },
+    draftCards: [
+      {
+        id: 'world-foundation',
+        kind: 'world',
+        title: '潮雾列岛',
+        subtitle: '旧灯塔与失控航路',
+        summary: '第一版世界底稿已经整理完成。',
+        status: 'warning',
+        linkedIds: [],
+        warningCount: 0,
+      },
+    ],
+  } satisfies CustomWorldAgentSessionSnapshot;
+  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(syncedSession);
+
+  render(<TestWrapper />);
+
+  await openNewRpgCreation(user);
+
+  await waitFor(
+    async () => {
+      expect(await screen.findByText('世界档案')).toBeTruthy();
+      expect(screen.getByText('已自动保存')).toBeTruthy();
+    },
+    { timeout: 2500 },
+  );
+
+  await waitFor(() => {
+    expect(upsertCustomWorldProfile).toHaveBeenCalled();
+  });
+
+  const latestSavedProfile = vi.mocked(upsertCustomWorldProfile).mock.calls.at(-1)?.[0];
+  expect(latestSavedProfile?.name).toBe('潮雾列岛·session最新版');
+  expect(latestSavedProfile?.summary).toBe(
+    '作品库应该保存这份同步后的最新快照。',
+  );
 });
 
 test('authenticated users with save archives default into the saves tab', async () => {
@@ -697,42 +1041,71 @@ test('owned world detail can delete a work and return to the create tab list', a
   const user = userEvent.setup();
   vi.spyOn(window, 'confirm').mockReturnValue(true);
 
-  vi.mocked(listCustomWorldLibrary).mockResolvedValue([
-    {
-      ownerUserId: 'user-1',
-      profileId: 'world-delete-1',
-      profile: {
-        id: 'world-delete-1',
-        name: '潮雾列岛',
-        subtitle: '旧灯塔与失控航路',
-        summary: '用于测试删除流程的作品。',
-        tone: '压抑、潮湿、悬疑',
-        playerGoal: '查清旧案。',
-        majorFactions: ['守灯会'],
-        coreConflicts: ['雾潮正在逼近港口'],
-        playableNpcs: [],
-        storyNpcs: [],
-        landmarks: [],
-      } as never,
-      visibility: 'draft',
-      publishedAt: null,
-      updatedAt: '2026-04-16T12:00:00.000Z',
-      authorDisplayName: '测试玩家',
-      worldName: '潮雾列岛',
+  const publishedWork = {
+    workId: 'published:world-delete-1',
+    sourceType: 'published_profile' as const,
+    status: 'published' as const,
+    title: '潮雾列岛',
+    subtitle: '旧灯塔与失控航路',
+    summary: '用于测试删除流程的作品。',
+    coverImageSrc: null,
+    coverRenderMode: 'image' as const,
+    coverCharacterImageSrcs: [],
+    updatedAt: '2026-04-16T12:00:00.000Z',
+    publishedAt: '2026-04-16T12:00:00.000Z',
+    stage: null,
+    stageLabel: '已发布',
+    playableNpcCount: 0,
+    landmarkCount: 0,
+    roleVisualReadyCount: 0,
+    roleAnimationReadyCount: 0,
+    roleAssetSummaryLabel: null,
+    sessionId: null,
+    profileId: 'world-delete-1',
+    canResume: false,
+    canEnterWorld: true,
+  };
+  const publishedLibraryEntry = {
+    ownerUserId: 'user-1',
+    profileId: 'world-delete-1',
+    profile: {
+      id: 'world-delete-1',
+      name: '潮雾列岛',
       subtitle: '旧灯塔与失控航路',
-      summaryText: '用于测试删除流程的作品。',
-      coverImageSrc: null,
-      themeMode: 'tide',
-      playableNpcCount: 0,
-      landmarkCount: 0,
-    },
-  ]);
+      summary: '用于测试删除流程的作品。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清旧案。',
+      majorFactions: ['守灯会'],
+      coreConflicts: ['雾潮正在逼近港口'],
+      playableNpcs: [],
+      storyNpcs: [],
+      landmarks: [],
+    } as never,
+    visibility: 'published' as const,
+    publishedAt: '2026-04-16T12:00:00.000Z',
+    updatedAt: '2026-04-16T12:00:00.000Z',
+    authorDisplayName: '测试玩家',
+    worldName: '潮雾列岛',
+    subtitle: '旧灯塔与失控航路',
+    summaryText: '用于测试删除流程的作品。',
+    coverImageSrc: null,
+    themeMode: 'tide' as const,
+    playableNpcCount: 0,
+    landmarkCount: 0,
+  };
+
+  vi.mocked(listCustomWorldWorks)
+    .mockResolvedValueOnce([publishedWork])
+    .mockResolvedValue([]);
+  vi.mocked(listCustomWorldLibrary)
+    .mockResolvedValueOnce([publishedLibraryEntry])
+    .mockResolvedValue([]);
   vi.mocked(deleteCustomWorldProfile).mockResolvedValue([]);
 
   render(<TestWrapper withAuth />);
 
-  await clickFirstButtonByName(user, '创作');
-  await clickFirstAsyncButtonByName(user, /潮雾列岛/u);
+  await openCreationHub(user);
+  await user.click(screen.getByRole('button', { name: /进入世界/u }));
   await user.click(await screen.findByRole('button', { name: '删除作品' }));
 
   await waitFor(() => {
@@ -742,8 +1115,77 @@ test('owned world detail can delete a work and return to the create tab list', a
   await waitFor(() => {
     expect(screen.queryByRole('button', { name: '删除作品' })).toBeNull();
   });
-  expect(
-    screen.getAllByText('你还没有保存任何自定义世界，先创建一个草稿开始吧。')
-      .length,
-  ).toBeTruthy();
+  await waitFor(() => {
+    expect(screen.getByText('还没有作品')).toBeTruthy();
+  });
+});
+
+test('creation hub published work enters existing detail view', async () => {
+  const user = userEvent.setup();
+
+  vi.mocked(listCustomWorldWorks).mockResolvedValue([
+    {
+      workId: 'published:world-public-1',
+      sourceType: 'published_profile',
+      status: 'published',
+      title: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '已经发布的群岛世界作品。',
+      coverImageSrc: null,
+      coverRenderMode: 'image',
+      coverCharacterImageSrcs: [],
+      updatedAt: '2026-04-20T10:00:00.000Z',
+      publishedAt: '2026-04-20T10:00:00.000Z',
+      stage: null,
+      stageLabel: '已发布',
+      playableNpcCount: 3,
+      landmarkCount: 4,
+      roleVisualReadyCount: 1,
+      roleAnimationReadyCount: 0,
+      roleAssetSummaryLabel: null,
+      sessionId: null,
+      profileId: 'world-public-1',
+      canResume: false,
+      canEnterWorld: true,
+    },
+  ]);
+  vi.mocked(listCustomWorldLibrary).mockResolvedValue([
+    {
+      ownerUserId: 'user-1',
+      profileId: 'world-public-1',
+      profile: {
+        id: 'world-public-1',
+        name: '潮雾列岛',
+        subtitle: '旧灯塔与失控航路',
+        summary: '已经发布的群岛世界作品。',
+        tone: '压抑、潮湿、悬疑',
+        playerGoal: '查清群岛旧案。',
+        majorFactions: ['守灯会'],
+        coreConflicts: ['假航灯正在扰乱航线'],
+        playableNpcs: [],
+        storyNpcs: [],
+        landmarks: [],
+      } as never,
+      visibility: 'published',
+      publishedAt: '2026-04-20T10:00:00.000Z',
+      updatedAt: '2026-04-20T10:00:00.000Z',
+      authorDisplayName: '测试玩家',
+      worldName: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summaryText: '已经发布的群岛世界作品。',
+      coverImageSrc: null,
+      themeMode: 'tide',
+      playableNpcCount: 3,
+      landmarkCount: 4,
+    },
+  ]);
+
+  render(<TestWrapper withAuth />);
+
+  await openCreationHub(user);
+  await user.click(screen.getByRole('button', { name: /进入世界/u }));
+
+  expect(await screen.findByText('世界信息')).toBeTruthy();
+  expect(screen.getByRole('button', { name: '开始游戏' })).toBeTruthy();
+  expect(screen.getByText('已发布')).toBeTruthy();
 });
diff --git a/src/components/game-shell/PreGameSelectionFlow.tsx b/src/components/game-shell/PreGameSelectionFlow.tsx
index 46542469..a2f06cbf 100644
--- a/src/components/game-shell/PreGameSelectionFlow.tsx
+++ b/src/components/game-shell/PreGameSelectionFlow.tsx
@@ -14,6 +14,7 @@ import type {
   CustomWorldAgentMessage,
   CustomWorldAgentOperationRecord,
   CustomWorldAgentSessionSnapshot,
+  CustomWorldWorkSummary,
   SendCustomWorldAgentMessageRequest,
 } from '../../../packages/shared/src/contracts/customWorldAgent';
 import type {
@@ -29,6 +30,7 @@ import {
   executeCustomWorldAgentAction,
   getCustomWorldAgentOperation,
   getCustomWorldAgentSession,
+  listCustomWorldWorks,
   streamCustomWorldAgentMessage,
 } from '../../services/aiService';
 import { buildCustomWorldProfileFromAgentDraft } from '../../services/customWorldAgentDraftResult';
@@ -69,6 +71,7 @@ import {
 } from '../../services/storageService';
 import { type CustomWorldProfile, type GameState } from '../../types';
 import { useAuthUi } from '../auth/AuthUiContext';
+import { CustomWorldCreationHub } from '../custom-world-home/CustomWorldCreationHub';
 import { PlatformCreationTypeModal } from './PlatformCreationTypeModal';
 import { type PlatformHomeTab, PlatformHomeView } from './PlatformHomeView';
 import { PlatformWorldDetailView } from './PlatformWorldDetailView';
@@ -107,6 +110,10 @@ type CustomWorldGenerationViewSource = 'agent-draft-foundation' | null;
 
 type CustomWorldResultViewSource = 'saved-profile' | 'agent-draft' | null;
 type CustomWorldAutoSaveState = 'idle' | 'saving' | 'saved' | 'error';
+type SyncedAgentDraftResult = {
+  session: CustomWorldAgentSessionSnapshot | null;
+  profile: CustomWorldProfile | null;
+};
 
 type PreGameSelectionFlowProps = {
   selectionStage: SelectionStage;
@@ -164,6 +171,10 @@ function normalizeAgentBackedProfile(profile: CustomWorldProfile) {
   } satisfies CustomWorldProfile;
 }
 
+function stringifyAgentBackedProfile(profile: CustomWorldProfile) {
+  return JSON.stringify(normalizeAgentBackedProfile(profile));
+}
+
 function LazyPanelFallback({ label }: { label: string }) {
   return (
     <div className="flex h-full min-h-0 items-center justify-center">
@@ -174,6 +185,37 @@ function LazyPanelFallback({ label }: { label: string }) {
   );
 }
 
+function buildCreationHubFallbackItems(
+  entries: CustomWorldLibraryEntry<CustomWorldProfile>[],
+): CustomWorldWorkSummary[] {
+  return entries
+    .filter((entry) => entry.visibility === 'published')
+    .map((entry) => ({
+    workId: `fallback:${entry.profileId}`,
+    sourceType: 'published_profile',
+    status: 'published',
+    title: entry.worldName,
+    subtitle: entry.subtitle || '已发布作品',
+    summary: entry.summaryText || '继续补完这个世界的设定与游玩入口。',
+    coverImageSrc: entry.coverImageSrc,
+    coverRenderMode: 'image',
+    coverCharacterImageSrcs: [],
+    updatedAt: entry.updatedAt,
+    publishedAt: entry.publishedAt,
+    stage: null,
+    stageLabel: '已发布',
+    playableNpcCount: entry.playableNpcCount,
+    landmarkCount: entry.landmarkCount,
+    roleVisualReadyCount: 0,
+    roleAnimationReadyCount: 0,
+    roleAssetSummaryLabel: null,
+    sessionId: null,
+    profileId: entry.profileId,
+    canResume: false,
+    canEnterWorld: true,
+  }));
+}
+
 export function PreGameSelectionFlow({
   selectionStage,
   setSelectionStage,
@@ -191,6 +233,9 @@ export function PreGameSelectionFlow({
   const [savedCustomWorldEntries, setSavedCustomWorldEntries] = useState<
     CustomWorldLibraryEntry<CustomWorldProfile>[]
   >([]);
+  const [customWorldWorkEntries, setCustomWorldWorkEntries] = useState<
+    CustomWorldWorkSummary[]
+  >([]);
   const [publishedGalleryEntries, setPublishedGalleryEntries] = useState<
     CustomWorldGalleryCard[]
   >([]);
@@ -250,6 +295,10 @@ export function PreGameSelectionFlow({
   const customWorldAutoSaveTimeoutRef = useRef<number | null>(null);
   const lastAutoSavedProfileSignatureRef = useRef<string | null>(null);
   const latestAutoSaveRequestIdRef = useRef(0);
+  const latestAgentResultSyncSignatureRef = useRef<string | null>(null);
+  // 用户手动返回工作区后，先抑制自动重开结果页，避免刚退出又被 session 快照顶回去。
+  const isAgentDraftResultAutoOpenSuppressedRef = useRef(false);
+  const isCustomWorldAutoSaveBusyRef = useRef(false);
   const platformTabBootstrapUserIdRef = useRef<string | null | undefined>(
     undefined,
   );
@@ -318,6 +367,17 @@ export function PreGameSelectionFlow({
     }
   }, [authUi?.user]);
 
+  const refreshCustomWorldWorks = useCallback(async () => {
+    if (!authUi?.user) {
+      setCustomWorldWorkEntries([]);
+      return [];
+    }
+
+    const nextItems = await listCustomWorldWorks();
+    setCustomWorldWorkEntries(nextItems);
+    return nextItems;
+  }, [authUi?.user]);
+
   const appendBrowseHistoryEntry = useCallback(
     async (entry: PlatformBrowseHistoryWriteEntry) => {
       const nextEntries = writePlatformBrowseHistory(authUi?.user, entry);
@@ -380,6 +440,7 @@ export function PreGameSelectionFlow({
       setDashboardError(null);
       if (!isAuthenticated) {
         setSavedCustomWorldEntries([]);
+        setCustomWorldWorkEntries([]);
         setSaveEntries([]);
         setProfileDashboard(null);
       }
@@ -387,12 +448,14 @@ export function PreGameSelectionFlow({
       try {
         const [
           libraryEntriesResult,
+          workEntriesResult,
           galleryEntriesResult,
           dashboardResult,
           historyResult,
           saveArchivesResult,
         ] = await Promise.allSettled([
           isAuthenticated ? listCustomWorldLibrary() : Promise.resolve([]),
+          isAuthenticated ? listCustomWorldWorks() : Promise.resolve([]),
           listCustomWorldGallery(),
           isAuthenticated ? getProfileDashboard() : Promise.resolve(null),
           isAuthenticated
@@ -423,6 +486,12 @@ export function PreGameSelectionFlow({
           setSavedCustomWorldEntries([]);
         }
 
+        if (workEntriesResult.status === 'fulfilled') {
+          setCustomWorldWorkEntries(workEntriesResult.value);
+        } else {
+          setCustomWorldWorkEntries([]);
+        }
+
         if (galleryEntriesResult.status === 'fulfilled') {
           setPublishedGalleryEntries(galleryEntriesResult.value);
         } else {
@@ -431,11 +500,14 @@ export function PreGameSelectionFlow({
 
         if (
           (isAuthenticated && libraryEntriesResult.status === 'rejected') ||
+          (isAuthenticated && workEntriesResult.status === 'rejected') ||
           galleryEntriesResult.status === 'rejected'
         ) {
           const platformFailure =
             libraryEntriesResult.status === 'rejected'
               ? libraryEntriesResult.reason
+              : workEntriesResult.status === 'rejected'
+                ? workEntriesResult.reason
               : galleryEntriesResult.status === 'rejected'
                 ? galleryEntriesResult.reason
                 : null;
@@ -742,9 +814,14 @@ export function PreGameSelectionFlow({
       return;
     }
 
+    if (isAgentDraftResultAutoOpenSuppressedRef.current) {
+      return;
+    }
+
     if (selectionStage === 'agent-workspace') {
       setGeneratedCustomWorldProfile(agentDraftResultProfile);
       setCustomWorldResultViewSource('agent-draft');
+      isAgentDraftResultAutoOpenSuppressedRef.current = false;
       setSelectionStage('custom-world-result');
       return;
     }
@@ -755,10 +832,12 @@ export function PreGameSelectionFlow({
     ) {
       setGeneratedCustomWorldProfile(agentDraftResultProfile);
       setCustomWorldResultViewSource('agent-draft');
+      isAgentDraftResultAutoOpenSuppressedRef.current = false;
     }
   }, [
     agentDraftResultProfile,
     generatedCustomWorldProfile,
+    isAgentDraftResultAutoOpenSuppressedRef,
     selectionStage,
     setSelectionStage,
     shouldAutoOpenAgentDraftResult,
@@ -776,6 +855,8 @@ export function PreGameSelectionFlow({
   const isAgentDraftGenerationView =
     customWorldGenerationViewSource === 'agent-draft-foundation';
   const isAgentDraftResultView = customWorldResultViewSource === 'agent-draft';
+  const isAgentDraftResultEditingFrozen =
+    customWorldResultViewSource === 'agent-draft';
   const activeGenerationSettingText = agentDraftSettingPreview;
   const activeGenerationProgress = agentDraftGenerationProgress;
   const isActiveGenerationRunning =
@@ -822,6 +903,7 @@ export function PreGameSelectionFlow({
 
     setIsCreatingAgentSession(true);
     setCreationTypeError(null);
+    isAgentDraftResultAutoOpenSuppressedRef.current = false;
 
     try {
       const { session } = await createCustomWorldAgentSession(
@@ -921,6 +1003,7 @@ export function PreGameSelectionFlow({
     const isDraftFoundationAction = payload.action === 'draft_foundation';
 
     if (isDraftFoundationAction) {
+      isAgentDraftResultAutoOpenSuppressedRef.current = false;
       setGeneratedCustomWorldProfile(null);
       setCustomWorldError(null);
       setCustomWorldAutoSaveError(null);
@@ -980,14 +1063,14 @@ export function PreGameSelectionFlow({
   };
 
   const leaveAgentDraftResult = () => {
+    isAgentDraftResultAutoOpenSuppressedRef.current = true;
     setGeneratedCustomWorldProfile(null);
     setCustomWorldError(null);
     setCustomWorldAutoSaveError(null);
     setCustomWorldAutoSaveState('idle');
     setCustomWorldGenerationViewSource(null);
     setCustomWorldResultViewSource(null);
-    setPlatformTab('create');
-    setSelectionStage('platform');
+    setSelectionStage('agent-workspace');
   };
 
   const retryAgentDraftGeneration = () => {
@@ -1000,25 +1083,79 @@ export function PreGameSelectionFlow({
     openCreationTypePicker();
   };
 
-  const openLibraryDetail = (
-    entry: CustomWorldLibraryEntry<CustomWorldProfile>,
-  ) => {
-    if (entry.visibility === 'published') {
-      void appendBrowseHistoryEntry({
-        ownerUserId: entry.ownerUserId,
-        profileId: entry.profileId,
-        worldName: entry.worldName,
-        subtitle: entry.subtitle,
-        summaryText: entry.summaryText,
-        coverImageSrc: entry.coverImageSrc,
-        themeMode: entry.themeMode,
-        authorDisplayName: entry.authorDisplayName,
-      });
-    }
-    setSelectedDetailEntry(entry);
-    setDetailError(null);
-    setSelectionStage('detail');
-  };
+  const openLibraryDetail = useCallback(
+    (entry: CustomWorldLibraryEntry<CustomWorldProfile>) => {
+      if (entry.visibility === 'published') {
+        void appendBrowseHistoryEntry({
+          ownerUserId: entry.ownerUserId,
+          profileId: entry.profileId,
+          worldName: entry.worldName,
+          subtitle: entry.subtitle,
+          summaryText: entry.summaryText,
+          coverImageSrc: entry.coverImageSrc,
+          themeMode: entry.themeMode,
+          authorDisplayName: entry.authorDisplayName,
+        });
+      }
+      setSelectedDetailEntry(entry);
+      setDetailError(null);
+      setSelectionStage('detail');
+    },
+    [appendBrowseHistoryEntry, setSelectionStage],
+  );
+
+  const handleOpenCreationWork = useCallback(
+    async (work: CustomWorldWorkSummary) => {
+      if (work.status === 'draft' && work.sessionId) {
+        // 阶段二要求草稿优先回到 Agent 工作区，而不是再次自动顶回结果页。
+        isAgentDraftResultAutoOpenSuppressedRef.current = true;
+        persistAgentUiState(work.sessionId, null);
+        setGeneratedCustomWorldProfile(null);
+        setCustomWorldError(null);
+        setCustomWorldAutoSaveError(null);
+        setCustomWorldAutoSaveState('idle');
+        setCustomWorldGenerationViewSource(null);
+        setCustomWorldResultViewSource(null);
+        setPlatformTab('create');
+        setSelectionStage('agent-workspace');
+        return;
+      }
+
+      if (!work.profileId) {
+        return;
+      }
+
+      try {
+        let matchedEntry = savedCustomWorldEntries.find(
+          (entry) => entry.profileId === work.profileId,
+        );
+
+        if (!matchedEntry && authUi?.user) {
+          const latestLibraryEntries = await listCustomWorldLibrary();
+          setSavedCustomWorldEntries(latestLibraryEntries);
+          matchedEntry = latestLibraryEntries.find(
+            (entry) => entry.profileId === work.profileId,
+          );
+        }
+
+        if (matchedEntry) {
+          openLibraryDetail(matchedEntry);
+          return;
+        }
+
+        setPlatformError('未找到对应作品，请刷新后重试。');
+      } catch (error) {
+        setPlatformError(resolveErrorMessage(error, '读取作品详情失败。'));
+      }
+    },
+    [
+      authUi?.user,
+      openLibraryDetail,
+      persistAgentUiState,
+      savedCustomWorldEntries,
+      setSelectionStage,
+    ],
+  );
 
   const openGalleryDetail = async (entry: CustomWorldGalleryCard) => {
     setSelectionStage('detail');
@@ -1083,7 +1220,7 @@ export function PreGameSelectionFlow({
       }
 
       const normalizedProfile = normalizeAgentBackedProfile(profile);
-      const profileSignature = JSON.stringify(normalizedProfile);
+      const profileSignature = stringifyAgentBackedProfile(normalizedProfile);
       const requestId = latestAutoSaveRequestIdRef.current + 1;
       latestAutoSaveRequestIdRef.current = requestId;
       setCustomWorldAutoSaveState('saving');
@@ -1097,6 +1234,9 @@ export function PreGameSelectionFlow({
 
         lastAutoSavedProfileSignatureRef.current = profileSignature;
         setSavedCustomWorldEntries(mutation.entries);
+        if (authUi?.user) {
+          void refreshCustomWorldWorks().catch(() => {});
+        }
         setSelectedDetailEntry((current) => {
           if (!current || current.profileId === mutation.entry.profileId) {
             return mutation.entry;
@@ -1119,7 +1259,99 @@ export function PreGameSelectionFlow({
         return null;
       }
     },
-    [generatedCustomWorldProfile],
+    [authUi?.user, generatedCustomWorldProfile, refreshCustomWorldWorks],
+  );
+
+  const syncAgentDraftResultProfile = useCallback(
+    async (profile: CustomWorldProfile) => {
+      if (!activeAgentSessionId) {
+        return {
+          session: null,
+          profile: null,
+        } satisfies SyncedAgentDraftResult;
+      }
+
+      const normalizedProfile = normalizeAgentBackedProfile(profile);
+      const profileSignature = stringifyAgentBackedProfile(normalizedProfile);
+      const latestSessionProfileSignature =
+        agentSession && buildCustomWorldProfileFromAgentDraft(agentSession)
+          ? stringifyAgentBackedProfile(
+              buildCustomWorldProfileFromAgentDraft(agentSession)!,
+            )
+          : '';
+      if (latestSessionProfileSignature === profileSignature) {
+        latestAgentResultSyncSignatureRef.current = profileSignature;
+        return {
+          session: agentSession,
+          profile: normalizeAgentBackedProfile(
+            buildCustomWorldProfileFromAgentDraft(agentSession) ?? profile,
+          ),
+        } satisfies SyncedAgentDraftResult;
+      }
+      if (latestAgentResultSyncSignatureRef.current === profileSignature) {
+        return {
+          session: agentSession,
+          profile: normalizeAgentBackedProfile(
+            buildCustomWorldProfileFromAgentDraft(agentSession) ?? profile,
+          ),
+        } satisfies SyncedAgentDraftResult;
+      }
+
+      const { operation } = await executeCustomWorldAgentAction(
+        activeAgentSessionId,
+        {
+          action: 'sync_result_profile',
+          profile: normalizedProfile as unknown as Record<string, unknown>,
+        },
+      );
+      setAgentOperation(operation);
+      persistAgentUiState(activeAgentSessionId, operation.operationId);
+
+      for (let attempt = 0; attempt < 60; attempt += 1) {
+        const latestOperation = await getCustomWorldAgentOperation(
+          activeAgentSessionId,
+          operation.operationId,
+        );
+        setAgentOperation(latestOperation);
+
+        if (latestOperation.status === 'failed') {
+          throw new Error(
+            latestOperation.error ||
+              latestOperation.phaseDetail ||
+              '同步结果页世界快照失败。',
+          );
+        }
+
+        if (latestOperation.status === 'completed') {
+          persistAgentUiState(activeAgentSessionId, null);
+          const latestSession = await syncAgentSessionSnapshot(
+            activeAgentSessionId,
+          );
+          // 同步完成后统一从最新 session 重编译结果，保证结果页、作品库和进入世界吃同一份快照。
+          const latestProfile = normalizeAgentBackedProfile(
+            buildCustomWorldProfileFromAgentDraft(latestSession) ?? profile,
+          );
+          if (latestProfile) {
+            setGeneratedCustomWorldProfile(latestProfile);
+          }
+          latestAgentResultSyncSignatureRef.current = profileSignature;
+          return {
+            session: latestSession,
+            profile: latestProfile,
+          } satisfies SyncedAgentDraftResult;
+        }
+
+        await new Promise((resolve) => window.setTimeout(resolve, 200));
+      }
+
+      throw new Error('同步结果页世界快照超时。');
+    },
+    [
+      activeAgentSessionId,
+      agentSession,
+      persistAgentUiState,
+      syncAgentSessionSnapshot,
+    ],
   );
 
   useEffect(() => {
@@ -1127,6 +1359,7 @@ export function PreGameSelectionFlow({
       setCustomWorldAutoSaveState('idle');
       setCustomWorldAutoSaveError(null);
       lastAutoSavedProfileSignatureRef.current = null;
+      latestAgentResultSyncSignatureRef.current = null;
       if (customWorldAutoSaveTimeoutRef.current !== null) {
         window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
         customWorldAutoSaveTimeoutRef.current = null;
@@ -1138,7 +1371,11 @@ export function PreGameSelectionFlow({
       return;
     }
 
-    const nextSignature = JSON.stringify(generatedCustomWorldProfile);
+    if (isCustomWorldAutoSaveBusyRef.current) {
+      return;
+    }
+
+    const nextSignature = stringifyAgentBackedProfile(generatedCustomWorldProfile);
     if (nextSignature === lastAutoSavedProfileSignatureRef.current) {
       return;
     }
@@ -1150,7 +1387,28 @@ export function PreGameSelectionFlow({
 
     const profileToSave = generatedCustomWorldProfile;
     customWorldAutoSaveTimeoutRef.current = window.setTimeout(() => {
-      void saveGeneratedCustomWorld(profileToSave);
+      void (async () => {
+        isCustomWorldAutoSaveBusyRef.current = true;
+        try {
+          let latestProfileToSave = normalizeAgentBackedProfile(profileToSave);
+          if (isAgentDraftResultView) {
+            const syncedResult =
+              await syncAgentDraftResultProfile(profileToSave);
+            // 作品库自动保存优先落同步后 session 重编译出的结果，避免继续保存旧的前端内存态。
+            latestProfileToSave = normalizeAgentBackedProfile(
+              syncedResult.profile ?? profileToSave,
+            );
+          }
+          await saveGeneratedCustomWorld(latestProfileToSave);
+        } catch (error) {
+          setCustomWorldAutoSaveState('error');
+          setCustomWorldAutoSaveError(
+            resolveErrorMessage(error, '保存自定义世界失败。'),
+          );
+        } finally {
+          isCustomWorldAutoSaveBusyRef.current = false;
+        }
+      })();
       customWorldAutoSaveTimeoutRef.current = null;
     }, 600);
 
@@ -1160,7 +1418,13 @@ export function PreGameSelectionFlow({
         customWorldAutoSaveTimeoutRef.current = null;
       }
     };
-  }, [generatedCustomWorldProfile, saveGeneratedCustomWorld, selectionStage]);
+  }, [
+    generatedCustomWorldProfile,
+    isAgentDraftResultView,
+    saveGeneratedCustomWorld,
+    selectionStage,
+    syncAgentDraftResultProfile,
+  ]);
 
   const openSavedCustomWorldEditor = (
     entry: CustomWorldLibraryEntry<CustomWorldProfile>,
@@ -1200,6 +1464,7 @@ export function PreGameSelectionFlow({
         selectedDetailEntry.profileId,
       );
       setSavedCustomWorldEntries(mutation.entries);
+      await refreshCustomWorldWorks().catch(() => []);
       setSelectedDetailEntry(mutation.entry);
       setPublishedGalleryEntries(await listCustomWorldGallery());
     } catch (error) {
@@ -1221,6 +1486,7 @@ export function PreGameSelectionFlow({
         selectedDetailEntry.profileId,
       );
       setSavedCustomWorldEntries(mutation.entries);
+      await refreshCustomWorldWorks().catch(() => []);
       setSelectedDetailEntry(mutation.entry);
       setPublishedGalleryEntries(await listCustomWorldGallery());
     } catch (error) {
@@ -1249,6 +1515,7 @@ export function PreGameSelectionFlow({
         selectedDetailEntry.profileId,
       );
       setSavedCustomWorldEntries(entries);
+      await refreshCustomWorldWorks().catch(() => []);
       setSelectedDetailEntry(null);
       setPlatformTab('create');
       setSelectionStage('platform');
@@ -1269,6 +1536,10 @@ export function PreGameSelectionFlow({
       ),
   );
   const resultViewError = customWorldAutoSaveError ?? customWorldError;
+  const creationHubItems =
+    customWorldWorkEntries.length > 0
+      ? customWorldWorkEntries
+      : buildCreationHubFallbackItems(savedCustomWorldEntries);
 
   return (
     <>
@@ -1281,47 +1552,106 @@ export function PreGameSelectionFlow({
             exit={{ opacity: 0, y: -12 }}
             className="flex h-full min-h-0 flex-col"
           >
-            <PlatformHomeView
-              activeTab={platformTab}
-              onTabChange={setPlatformTab}
-              hasSavedGame={hasSavedGame}
-              savedSnapshot={savedSnapshot}
-              saveEntries={saveEntries}
-              saveError={saveError}
-              featuredEntries={featuredGalleryEntries}
-              latestEntries={publishedGalleryEntries}
-              myEntries={savedCustomWorldEntries}
-              historyEntries={historyEntries}
-              profileDashboard={profileDashboard}
-              isLoadingPlatform={isLoadingPlatform}
-              isLoadingDashboard={isLoadingDashboard}
-              isResumingSaveWorldKey={isResumingSaveWorldKey}
-              platformError={
-                isLoadingPlatform ? null : (platformError ?? creationTypeError)
-              }
-              dashboardError={isLoadingDashboard ? null : dashboardError}
-              onContinueGame={handleContinueGame}
-              onResumeSave={(entry) => {
-                void handleResumeSaveEntry(entry);
-              }}
-              onOpenCreateWorld={openCustomWorldCreator}
-              onOpenCreateTypePicker={openCreationTypePicker}
-              onOpenGalleryDetail={(entry) => {
-                runProtectedAction(() => {
-                  void openGalleryDetail(entry);
-                });
-              }}
-              onOpenLibraryDetail={(entry) => {
-                runProtectedAction(() => {
-                  openLibraryDetail(entry);
-                });
-              }}
-              onOpenProfileDashboardCard={() => {
-                if (dashboardError) {
-                  void refreshProfileDashboard();
+            {platformTab === 'create' ? (
+              <CustomWorldCreationHub
+                items={creationHubItems}
+                loading={isLoadingPlatform}
+                error={isLoadingPlatform ? null : (platformError ?? creationTypeError)}
+                onBack={() => {
+                  setPlatformTab('home');
+                }}
+                onRetry={() => {
+                  setPlatformError(null);
+                  void refreshCustomWorldWorks().catch((error) => {
+                    setPlatformError(
+                      resolveErrorMessage(error, '读取创作作品列表失败。'),
+                    );
+                  });
+                }}
+                onCreateNew={openCreationTypePicker}
+                onResumeDraft={(sessionId) => {
+                  runProtectedAction(() => {
+                    void handleOpenCreationWork({
+                      workId: `draft:${sessionId}`,
+                      sourceType: 'agent_session',
+                      status: 'draft',
+                      title: '',
+                      subtitle: '',
+                      summary: '',
+                      coverImageSrc: null,
+                      coverRenderMode: 'image',
+                      coverCharacterImageSrcs: [],
+                      updatedAt: new Date().toISOString(),
+                      publishedAt: null,
+                      stage: null,
+                      stageLabel: '',
+                      playableNpcCount: 0,
+                      landmarkCount: 0,
+                      roleVisualReadyCount: 0,
+                      roleAnimationReadyCount: 0,
+                      roleAssetSummaryLabel: null,
+                      sessionId,
+                      profileId: null,
+                      canResume: true,
+                      canEnterWorld: false,
+                    });
+                  });
+                }}
+                onEnterPublished={(profileId) => {
+                  runProtectedAction(() => {
+                    const matchedWork = creationHubItems.find(
+                      (entry) => entry.profileId === profileId,
+                    );
+                    if (!matchedWork) {
+                      return;
+                    }
+                    void handleOpenCreationWork(matchedWork);
+                  });
+                }}
+              />
+            ) : (
+              <PlatformHomeView
+                activeTab={platformTab}
+                onTabChange={setPlatformTab}
+                hasSavedGame={hasSavedGame}
+                savedSnapshot={savedSnapshot}
+                saveEntries={saveEntries}
+                saveError={saveError}
+                featuredEntries={featuredGalleryEntries}
+                latestEntries={publishedGalleryEntries}
+                myEntries={savedCustomWorldEntries}
+                historyEntries={historyEntries}
+                profileDashboard={profileDashboard}
+                isLoadingPlatform={isLoadingPlatform}
+                isLoadingDashboard={isLoadingDashboard}
+                isResumingSaveWorldKey={isResumingSaveWorldKey}
+                platformError={
+                  isLoadingPlatform ? null : (platformError ?? creationTypeError)
                 }
-              }}
-            />
+                dashboardError={isLoadingDashboard ? null : dashboardError}
+                onContinueGame={handleContinueGame}
+                onResumeSave={(entry) => {
+                  void handleResumeSaveEntry(entry);
+                }}
+                onOpenCreateWorld={openCustomWorldCreator}
+                onOpenCreateTypePicker={openCreationTypePicker}
+                onOpenGalleryDetail={(entry) => {
+                  runProtectedAction(() => {
+                    void openGalleryDetail(entry);
+                  });
+                }}
+                onOpenLibraryDetail={(entry) => {
+                  runProtectedAction(() => {
+                    openLibraryDetail(entry);
+                  });
+                }}
+                onOpenProfileDashboardCard={() => {
+                  if (dashboardError) {
+                    void refreshProfileDashboard();
+                  }
+                }}
+              />
+            )}
           </motion.div>
         )}
 
@@ -1501,7 +1831,28 @@ export function PreGameSelectionFlow({
                   }}
                   onBack={
                     isAgentDraftResultView
-                      ? leaveAgentDraftResult
+                      ? () => {
+                          void (async () => {
+                            const currentProfile =
+                              generatedCustomWorldProfile ??
+                              buildCustomWorldProfileFromAgentDraft(
+                                agentSession,
+                              );
+
+                            if (currentProfile && activeAgentSessionId) {
+                              await syncAgentDraftResultProfile(currentProfile);
+                            }
+
+                            leaveAgentDraftResult();
+                          })().catch((error) => {
+                            setCustomWorldError(
+                              resolveErrorMessage(
+                                error,
+                                '返回创作前同步草稿失败。',
+                              ),
+                            );
+                          });
+                        }
                       : leaveCustomWorldResult
                   }
                   onEditSetting={undefined}
@@ -1509,10 +1860,40 @@ export function PreGameSelectionFlow({
                   onContinueExpand={undefined}
                   onEnterWorld={() => {
                     runProtectedAction(() => {
-                      handleCustomWorldSelect(generatedCustomWorldProfile);
+                      void (async () => {
+                        if (!isAgentDraftResultView || !activeAgentSessionId) {
+                          handleCustomWorldSelect(generatedCustomWorldProfile);
+                          return;
+                        }
+
+                        const currentProfile =
+                          generatedCustomWorldProfile ??
+                          buildCustomWorldProfileFromAgentDraft(agentSession);
+                        if (!currentProfile) {
+                          return;
+                        }
+
+                        const latestResult = await syncAgentDraftResultProfile(
+                          currentProfile,
+                        );
+                        const latestProfile = normalizeAgentBackedProfile(
+                          buildCustomWorldProfileFromAgentDraft(
+                            latestResult.session ?? agentSession,
+                          ) ??
+                            latestResult.profile ??
+                            currentProfile,
+                        );
+                        setGeneratedCustomWorldProfile(latestProfile);
+                        handleCustomWorldSelect(latestProfile);
+                      })().catch((error) => {
+                        setCustomWorldError(
+                          resolveErrorMessage(error, '进入世界前同步草稿失败。'),
+                        );
+                      });
                     });
                   }}
-                  readOnly={false}
+                  readOnly={isAgentDraftResultEditingFrozen}
+                  compactAgentResultMode={isAgentDraftResultView}
                   backLabel={isAgentDraftResultView ? '返回创作' : undefined}
                   editActionLabel="去Agent调整设定"
                   enterWorldActionLabel="进入世界"

From 3614e1f5a2bb69576661d7ffb0491d2910782362 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=AB=98=E7=89=A9?= <253518756@qq.com>
Date: Tue, 21 Apr 2026 09:44:17 +0800
Subject: [PATCH 2/6] =?UTF-8?q?=E5=88=9B=E4=BD=9C=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E6=B5=81=E7=A8=8B=E6=94=B6=E6=9D=9F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md                                     |    2 +-
 README.md                                     |   10 +-
 ...RAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md |   62 +-
 ...NG_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md |  141 ++
 ...NG_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md |  145 ++
 ...NG_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md |  177 +++
 ...NG_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md |   56 +
 ...OGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md |  503 +++++++
 docs/audits/engineering/README.md             |   27 +-
 .../CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md     |    8 +-
 ...ATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md |   31 +
 ...D_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md |    2 +-
 ...R_PHASE1_IMPLEMENTATION_PLAN_2026-04-13.md |   20 +
 ...R_PHASE2_IMPLEMENTATION_PLAN_2026-04-13.md |   30 +
 ...R_PHASE3_IMPLEMENTATION_PLAN_2026-04-14.md |   30 +
 ...R_PHASE4_IMPLEMENTATION_PLAN_2026-04-14.md |   30 +
 ...R_PHASE5_IMPLEMENTATION_PLAN_2026-04-14.md |   28 +
 ...R_PHASE6_IMPLEMENTATION_PLAN_2026-04-14.md |   22 +
 ...RST_CUSTOM_WORLD_CREATOR_PRD_2026-04-12.md |   10 +
 ...TEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md |   11 +-
 .../BUSINESS_PROMPT_INVENTORY_2026-04-19.md   |    6 +-
 .../CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md |   36 +
 ...ON_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md |   41 +-
 .../EDITOR_ASSET_API_MIGRATION_2026-04-08.md  |    5 -
 .../EDITOR_ENTRY_CLEANUP_2026-04-21.md        |   85 ++
 .../NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md |   15 +-
 .../PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md |    5 -
 ...MOTION_REPRODUCTION_WORKFLOW_2026-04-07.md |    2 +-
 docs/technical/README.md                      |    1 +
 package.json                                  |    1 -
 scripts/generate-build-tag-similarity.py      |  357 -----
 server-node/src/app.ts                        |   13 -
 server-node/src/context.ts                    |    2 -
 .../src/modules/assets/qwenSpriteRoutes.ts    |  907 -------------
 server-node/src/routes/runtimeRoutes.ts       |  138 --
 server-node/src/server.ts                     |    2 -
 .../services/customWorldGenerationService.ts  |   33 -
 .../src/services/customWorldSessionStore.ts   |  229 ----
 src/components/GameShell.tsx                  |  807 ------------
 src/components/auth/AuthGate.test.tsx         |   10 +-
 src/components/auth/AuthGate.tsx              |   10 +-
 ...ustomWorldAgentClarificationPanel.test.tsx |   98 --
 .../CustomWorldAgentClarificationPanel.tsx    |   64 -
 ...AgentDraftDetailPanel.interaction.test.tsx |  115 --
 .../CustomWorldAgentDraftDetailPanel.test.tsx |   81 --
 .../CustomWorldAgentDraftDetailPanel.tsx      |  221 ----
 .../CustomWorldAgentDraftDrawer.tsx           |  117 --
 ...ustomWorldAgentIntentSummaryPanel.test.tsx |   40 -
 .../CustomWorldAgentIntentSummaryPanel.tsx    |   99 --
 .../CustomWorldAgentLauncherModal.tsx         |   90 --
 .../CustomWorldAgentLockBar.tsx               |   53 -
 .../CustomWorldAgentQuickActions.tsx          |  132 --
 .../CustomWorldAgentSummaryPanel.tsx          |   58 -
 .../CustomWorldDraftCardDetailModal.tsx       |   67 -
 .../CustomWorldDraftEditPanel.test.tsx        |  102 --
 .../CustomWorldDraftEditPanel.tsx             |  141 --
 .../CustomWorldGenerateEntityModal.tsx        |  139 --
 .../CustomWorldCreationHub.tsx                |   45 +-
 .../CustomWorldCreationLauncherModal.tsx      |  146 --
 .../CustomWorldCreationStartCard.tsx          |   43 +-
 .../custom-world-home/CustomWorldWorkCard.tsx |   44 +-
 .../custom-world-home/CustomWorldWorkTabs.tsx |    8 +-
 .../game-shell/PlatformHomeView.tsx           |  171 ++-
 .../game-shell/PreGameSelectionFlow.tsx       |  198 +--
 src/data/buildTagSimilarity.generated.ts      |  822 ------------
 src/data/customWorldCharacterLoadout.stub.ts  |    9 -
 src/editor/shared/EditorEmptyState.tsx        |    7 -
 src/editor/shared/EditorSelectionCard.tsx     |   48 -
 src/editor/shared/cloneValue.ts               |    7 -
 src/editor/shared/editorApiClient.ts          |    4 -
 src/editor/shared/useJsonSave.ts              |   48 -
 src/hooks/story/storyBootstrap.ts             |  249 ----
 src/hooks/useEquipmentFlow.ts                 |  133 --
 src/hooks/useForgeFlow.ts                     |  158 ---
 src/hooks/useInventoryFlow.ts                 |   99 --
 src/index.css                                 |   29 +
 src/prompts/customWorldOrchestratorPrompts.ts |    8 -
 src/prompts/qwenSpriteSheetToolPrompts.ts     |  629 ---------
 src/prompts/storyOrchestratorPrompts.ts       |    5 -
 src/routing/appRoutes.test.ts                 |    8 +-
 src/routing/appRoutes.tsx                     |   40 +-
 src/services/aiService.ts                     |  233 +---
 src/services/apiClient.ts                     |   42 -
 src/services/authService.test.ts              |   37 +-
 src/services/authService.ts                   |    8 +-
 src/services/customWorldPresentation.stub.ts  |   54 -
 src/services/typewriter.ts                    |    6 -
 src/tools/QwenSpriteSheetTool.tsx             | 1169 -----------------
 src/tools/qwenSpriteSheetToolModel.test.ts    |  147 ---
 src/tools/qwenSpriteSheetToolModel.ts         |    1 -
 src/tools/qwenSpriteSheetToolPersistence.ts   |  113 --
 tsconfig.typecheck-guardrails.json            |    1 -
 vitest.config.ts                              |    9 -
 93 files changed, 1794 insertions(+), 8651 deletions(-)
 create mode 100644 docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md
 create mode 100644 docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md
 create mode 100644 docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md
 create mode 100644 docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md
 create mode 100644 docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md
 create mode 100644 docs/technical/CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md
 create mode 100644 docs/technical/EDITOR_ENTRY_CLEANUP_2026-04-21.md
 delete mode 100644 scripts/generate-build-tag-similarity.py
 delete mode 100644 server-node/src/modules/assets/qwenSpriteRoutes.ts
 delete mode 100644 server-node/src/services/customWorldGenerationService.ts
 delete mode 100644 server-node/src/services/customWorldSessionStore.ts
 delete mode 100644 src/components/GameShell.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentClarificationPanel.test.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentClarificationPanel.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.interaction.test.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.test.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentDraftDrawer.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.test.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentLauncherModal.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentLockBar.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentQuickActions.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldAgentSummaryPanel.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldDraftCardDetailModal.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldDraftEditPanel.test.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldDraftEditPanel.tsx
 delete mode 100644 src/components/custom-world-agent/CustomWorldGenerateEntityModal.tsx
 delete mode 100644 src/components/custom-world-home/CustomWorldCreationLauncherModal.tsx
 delete mode 100644 src/data/buildTagSimilarity.generated.ts
 delete mode 100644 src/data/customWorldCharacterLoadout.stub.ts
 delete mode 100644 src/editor/shared/EditorEmptyState.tsx
 delete mode 100644 src/editor/shared/EditorSelectionCard.tsx
 delete mode 100644 src/editor/shared/cloneValue.ts
 delete mode 100644 src/editor/shared/useJsonSave.ts
 delete mode 100644 src/hooks/story/storyBootstrap.ts
 delete mode 100644 src/hooks/useEquipmentFlow.ts
 delete mode 100644 src/hooks/useForgeFlow.ts
 delete mode 100644 src/hooks/useInventoryFlow.ts
 delete mode 100644 src/prompts/customWorldOrchestratorPrompts.ts
 delete mode 100644 src/prompts/qwenSpriteSheetToolPrompts.ts
 delete mode 100644 src/prompts/storyOrchestratorPrompts.ts
 delete mode 100644 src/services/customWorldPresentation.stub.ts
 delete mode 100644 src/services/typewriter.ts
 delete mode 100644 src/tools/QwenSpriteSheetTool.tsx
 delete mode 100644 src/tools/qwenSpriteSheetToolModel.test.ts
 delete mode 100644 src/tools/qwenSpriteSheetToolModel.ts
 delete mode 100644 src/tools/qwenSpriteSheetToolPersistence.ts

diff --git a/AGENTS.md b/AGENTS.md
index cf5aef51..994679a5 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -82,7 +82,7 @@ docs/
 │  ├─ AI_NATIVE_UNIFIED_ROLE_ATTRIBUTE_SYSTEM_PRD_2026-04-02.md
 │  ├─ BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md
 │  └─ RUNTIME_ITEM_GENERATION_CURRENT_SYSTEM_DESIGN.md
-├─ reference/[QwenSpriteSheetTool.tsx](src/tools/QwenSpriteSheetTool.tsx)
+├─ reference/
 │  ├─ README.md
 │  └─ FUNCTION_SCRIPT_CATALOG_2026-04-04.md
 └─ technical/
diff --git a/README.md b/README.md
index 98cd591f..c9b219e4 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 - NPC 交易、送礼、求助、招募
 - 宝藏交互
 - 同伴跟随与战斗
-- 预设编辑器 / NPC 视觉编辑器 / 行为编辑器
+- 游戏主流程内嵌的角色资产工坊、自定义世界实体编辑与角色形象编辑
 - 自动存档与继续游戏
 
 ## 运行
@@ -99,11 +99,11 @@ npm run check:content
 - [src/hooks/useCombatFlow.ts](/E:/Repos/Genarrative/src/hooks/useCombatFlow.ts)
 - [src/hooks/useStoryGeneration.ts](/E:/Repos/Genarrative/src/hooks/useStoryGeneration.ts)
 
-编辑器：
+主流程内嵌编辑能力：
 
-- [src/components/PresetEditor.tsx](/E:/Repos/Genarrative/src/components/PresetEditor.tsx)
-- [src/components/NpcVisualEditor.tsx](/E:/Repos/Genarrative/src/components/NpcVisualEditor.tsx)
-- [src/components/StateFunctionEditor.tsx](/E:/Repos/Genarrative/src/components/StateFunctionEditor.tsx)
+- [src/components/CustomWorldEntityEditorModal.tsx](/E:/Repos/Genarrative/src/components/CustomWorldEntityEditorModal.tsx)
+- [src/components/CustomWorldNpcVisualEditor.tsx](/E:/Repos/Genarrative/src/components/CustomWorldNpcVisualEditor.tsx)
+- [src/components/CustomWorldRoleAssetStudioModal.tsx](/E:/Repos/Genarrative/src/components/CustomWorldRoleAssetStudioModal.tsx)
 
 核心数据：
 
diff --git a/docs/audits/AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md b/docs/audits/AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md
index d6aa8108..303fdc11 100644
--- a/docs/audits/AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md
+++ b/docs/audits/AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md
@@ -251,8 +251,8 @@ custom-world-library
 | `anchorContent / creatorIntent / anchorPack / lockState` 被直接塞进 legacy profile | 创作态元数据 | 会跟随自动保存一起写进作品库 profile，但 runtime 并不以这些字段为正式运行时输入 | 当前更像创作态元数据泄漏进运行时 profile |
 | `qualityFindings` | session / contract 字段 | contract、session store、测试里存在，但没形成生成、渲染、发布阻断闭环 | 当前主链悬空 |
 | `checkpoints` | session 字段 | session store 会记录，但主工作区和结果页没有真实展示入口 | 当前主链悬空 |
-| `suggestedActions` | session 字段 | session 会生成，但主工作区没有接 `QuickActions` 等面板 | 当前主链悬空 |
-| `pendingClarifications` | session 字段 | session 有数据，但澄清面板未接入主工作区 | 当前主链悬空 |
+| `suggestedActions` | session 字段 | session 会生成，但当前正式工作区没有对应消费面；旧 `QuickActions` 面板已在 `2026-04-21` 判定退出当前版本主链并物理删除 | 当前主链悬空 |
+| `pendingClarifications` | session 字段 | session 有数据，但当前正式工作区没有对应消费面；旧澄清面板已在 `2026-04-21` 判定退出当前版本主链并物理删除 | 当前主链悬空 |
 | `operations` 历史 | session 字段 | 主工作区只展示当前 `activeOperation` 横幅，不展示完整历史 | 当前主链弱消费 |
 | `roleAssetSummaryLabel / cover* / counts` 等 works 字段 | works 聚合字段 | 后端能返回，但主平台 create tab 没走 `works` 入口 | 当前主链弱消费 |
 
@@ -266,11 +266,11 @@ custom-world-library
 | --- | --- | --- |
 | 结果页直接生成 playable/story/landmark | `CustomWorldResultView.tsx` 仍可直接调用 AI 生成 | 与 Agent 对象精修链重复，且不会同步回 session |
 | 结果页直接编辑 `CustomWorldProfile` | `CustomWorldEntityEditorModal` 仍挂在结果页 | 把结果页继续维持成旧编辑器，而不是 Agent 流程的收口层 |
-| 旧 `custom-world/sessions` 世界生成 | `aiService.generateCustomWorldProfile()` 仍完整可用 | 与 Agent 八锚点世界创建重复 |
+| 旧 `custom-world/sessions` 世界生成 | `2026-04-20` 审计时仍完整可用；`2026-04-21` 已完成物理删除 | 与 Agent 八锚点世界创建重复；当前遗留问题已转为文档口径清理 |
 | 作品库 `publish/unpublish` 与 Agent `publish_world` | 两套“发布”概念并行 | 一套作用于 library profile，一套想作用于 Agent session，但后者还未打通 |
 | 结果页自动保存 | `generatedCustomWorldProfile` 变化时自动 `upsertCustomWorldProfile()` | 让“草稿保存”“作品库存档”“正式发布”语义混在一起 |
 
-## 7.2 冗余或未接线组件
+## 7.2 冗余或已退出当前版本主链的组件
 
 `src/components/custom-world-agent/CustomWorldAgentWorkspace.tsx` 当前只真正接了：
 
@@ -280,7 +280,7 @@ custom-world-library
 4. `CustomWorldAgentThread`
 5. `CustomWorldAgentComposer`
 
-但同目录下已经存在且主工作区未接线的组件包括：
+在 `2026-04-21` 清理前，同目录下还存在一组未接线旧组件：
 
 1. `CustomWorldAgentLockBar.tsx`
 2. `CustomWorldAgentDraftDrawer.tsx`
@@ -291,6 +291,25 @@ custom-world-library
 7. `CustomWorldAgentClarificationPanel.tsx`
 8. `CustomWorldGenerateEntityModal.tsx`
 
+其中：
+
+1. `CustomWorldAgentDraftDrawer.tsx` 已在批次 A 清理中删除
+2. `CustomWorldAgentLockBar.tsx`
+3. `CustomWorldAgentDraftDetailPanel.tsx`
+4. `CustomWorldAgentQuickActions.tsx`
+5. `CustomWorldAgentSummaryPanel.tsx`
+6. `CustomWorldAgentIntentSummaryPanel.tsx`
+7. `CustomWorldAgentClarificationPanel.tsx`
+8. `CustomWorldGenerateEntityModal.tsx`
+
+已在批次 D 清理中判定为退出当前版本主链，并完成物理删除。
+
+因此这里的审计结论需要更新为：
+
+1. 它们不再属于“待接线组件”
+2. 它们属于已确认退场的旧副面板链
+3. 当前版本如果还要补 `suggestedActions / pendingClarifications / draftCards` 的消费面，应基于新的主链设计重新定义，而不是默认把旧面板接回来
+
 另外，`src/components/custom-world-home/CustomWorldCreationHub.tsx` 也已存在，但平台 `create` tab 还没有把它接成主入口。
 
 ---
@@ -345,16 +364,16 @@ Agent session
 2. 只有 `publish_world` 成功后，才产出正式 `CustomWorldProfile` 并允许主入口进入世界。
 3. `qualityFindings / blocker` 必须在 foundation draft 完成、资产写回后、publish 前持续重跑。
 
-## P1：决定旧 world session 流程的命运
+## P1：继续做旧 world session 链的文档收口
 
-当前最容易继续制造重复复杂度的是旧 `custom-world/sessions` 链。
+`2026-04-21` 更新：
 
-建议二选一：
+旧 `custom-world/sessions` 链已经完成物理删除。
 
-1. 明确保留为“快速世界生成兼容模式”，但从主入口降级。
-2. 明确进入淘汰路径，逐步下线 `generateCustomWorldProfile()` 这条旧链。
+因此这里不再是“保留还是淘汰”的开放问题，而是：
 
-不建议继续让它和 Agent 八锚点链同时作为主入口长期并存。
+1. 继续清理由这条旧链残留在审计、PRD、知识图谱中的过时口径
+2. 把当前正式主链与仍保留的兼容层边界写清楚
 
 ## P1：把 works 创作中心接回主平台
 
@@ -365,16 +384,23 @@ Agent session
 3. 已发布 profile 通过“进入世界”或“查看详情”进入。
 4. `myEntries` 退回为作品库子集，而不是 create tab 的唯一数据源。
 
-## P1：补齐 Agent workspace 的最小闭环
+## P1：为悬空 session 字段重新定义最小闭环
 
-建议优先接上：
+`2026-04-21` 更新：
 
-1. `CustomWorldAgentQuickActions`
-2. `CustomWorldAgentDraftDrawer`
-3. `CustomWorldAgentDraftDetailPanel`
-4. `CustomWorldAgentClarificationPanel`
+原文这里建议把旧 `QuickActions / DraftDrawer / DraftDetailPanel / ClarificationPanel` 接回主工作区。
 
-如果这几个面板不接上，`suggestedActions / pendingClarifications / draftCards` 这些 session 字段会长期处于悬空状态。
+但这些旧副面板已经在当前版本收口判断中被明确认定为：
+
+1. 不属于现行主链
+2. 不再作为当前版本默认待落地项
+3. 已完成物理删除
+
+因此当前更准确的建议应该是：
+
+1. 如果 `suggestedActions / pendingClarifications / draftCards` 仍要进入正式主流程，需要先重新定义符合当前极简工作区的消费方式
+2. 不应再以“把旧副面板接回来”作为默认方案
+3. 在没有新主链设计前，这些字段继续标记为“主链悬空”
 
 ## P2：等主链收口后再清桥接字段
 
diff --git a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md
new file mode 100644
index 00000000..26b2b81a
--- /dev/null
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md
@@ -0,0 +1,141 @@
+# 工程死分支清理执行记录 A（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+这份记录对应：
+
+- `docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md`
+- 其中的 `P0 + 批次 A`
+
+本批次只做一件事：
+
+**先清理高置信度、低耦合、无正式入口的小型孤岛与残留壳子。**
+
+这批对象有一个共同特征：
+
+1. 当前没有正式运行时引用
+2. 没有当前主链计划要接回
+3. 删除后有明确替代路径，或者本身只是历史占位
+
+因此这批次不碰运行时真相链、不碰鉴权链、不碰任务物品主链，只先做低风险去噪。
+
+---
+
+## 1. 本批次已处理对象
+
+## 1.1 已删除文件
+
+| 文件 | 判定 | 删除原因 | 替代路径 / 当前真相源 | 验证口径 |
+| --- | --- | --- | --- | --- |
+| `src/services/customWorldPresentation.stub.ts` | 无引用占位 stub | 文件本身就是占位实现，且正式逻辑已由 `customWorldPresentation.ts` 承接 | `src/services/customWorldPresentation.ts` | 符号级检索确认正式调用方都指向正式实现 |
+| `src/services/typewriter.ts` | 无引用 helper 残留 | 独立 helper 已失效，正式链路已在 `storyPresentation.ts` / `storyRenderingHelpers.ts` 等处内联或迁移 | `src/hooks/story/storyPresentation.ts`、`src/hooks/story/storyRenderingHelpers.ts` | `getTypewriterDelay` 调用点未指向该文件 |
+| `src/prompts/customWorldOrchestratorPrompts.ts` | 前端孤岛 prompt 壳 | 当前无正式 import，正式主编排 prompt 已收口到后端 prompt 目录，前端 `ai.ts` 也保留自己的现行实现 | `server-node/src/prompts/customWorldOrchestratorPrompts.ts`、`src/services/ai.ts` | 全仓检索仅剩文档引用，无代码消费 |
+| `src/prompts/storyOrchestratorPrompts.ts` | 前端孤岛 prompt 壳 | 当前无正式 import，剧情语言修复 prompt 已由后端 prompt 目录承接，前端当前执行路径不依赖该文件 | `server-node/src/prompts/storyOrchestratorPrompts.ts`、`src/services/ai.ts` | 全仓检索仅剩文档引用，无代码消费 |
+| `src/components/custom-world-home/CustomWorldCreationLauncherModal.tsx` | 无入口 UI 壳层 | 最近两轮工程审计都确认无运行时引用，当前平台主流程未接这条入口 | 当前平台正式入口链 | 文件级检索确认无组件 import |
+| `src/components/custom-world-agent/CustomWorldAgentLauncherModal.tsx` | 无入口 UI 壳层 | Agent 创作主流程已切到当前工作区链路，这个旧 modal 没有接线价值 | 当前 Agent 工作区主链 | 文件级检索确认无组件 import |
+| `src/components/custom-world-agent/CustomWorldAgentDraftDrawer.tsx` | 无入口 UI 壳层 | 只有孤立 UI 实现，没有正式调用链，也不在当前结果页 / 工作区主链中 | 当前 Agent 工作区与结果页正式链 | 文件级检索确认无组件 import |
+
+---
+
+## 2. 本批次为什么先删这 7 个
+
+这批文件适合先处理，不是因为它们最大，而是因为它们最清晰：
+
+1. **没有正式入口。**
+   本轮检索没有发现主工程 import。
+2. **删除后不会形成职责空洞。**
+   要么已有正式替代路径，要么本身只是历史占位。
+3. **不会误伤当前重点链路。**
+   这批不涉及运行时快照、鉴权、任务、物品、AI 正式编排主链。
+4. **可以最快降低目录噪音。**
+   先把真假并存的壳子删掉，后面做批次 B/C/D 时判断成本会更低。
+
+---
+
+## 3. 本批次暂不处理对象
+
+以下对象虽然已进入首轮台账，但本批次暂不删除：
+
+1. `src/components/GameShell.tsx`
+2. `src/components/custom-world-home/CustomWorldCreationHub.tsx`
+3. `src/hooks/story/storyBootstrap.ts`
+4. `src/hooks/useEquipmentFlow.ts`
+5. `src/hooks/useForgeFlow.ts`
+6. `src/hooks/useInventoryFlow.ts`
+7. `src/data/buildTagSimilarity.generated.ts`
+
+暂缓原因分别是：
+
+1. 仍属于旧主流程 / 旧 flow 级别对象，删除前要先核对更多历史依赖和替代路径
+2. 部分对象仍有测试引用或更大的上下文耦合
+3. `buildTagSimilarity.generated.ts` 虽无正式业务 import，但属于生成产物，处理前还要确认脚本链与文档链
+
+这批对象更适合进入：
+
+1. `批次 B：旧 flow / 旧 shell / 旧 hook`
+2. 或独立的数据产物复核批次
+
+---
+
+## 4. 本批次同步更新的文档
+
+本批次除了删文件，还同步做了文档回填：
+
+1. 新增本执行记录，说明本批删了什么、为什么删、哪些对象暂缓
+2. 更新 `docs/audits/engineering/README.md`，把这份执行记录加入当前审计入口
+
+这样做的目的，是避免再次出现：
+
+1. 代码删了
+2. 但审计入口还是旧状态
+3. 后续开发又从旧清单里重复判断一遍
+
+---
+
+## 5. 验证方式
+
+本批次验证采用两层口径：
+
+## 5.1 删除前验证
+
+1. 文件级检索确认无正式 import
+2. 符号级检索确认关键导出没有被主链消费
+3. 结合 `2026-04-20` 工程审计交叉确认这些对象已被标记为高置信度孤岛
+
+## 5.2 删除后验证
+
+建议至少执行：
+
+1. `npm run check:encoding`
+2. `npm run build`
+
+说明：
+
+- 当前仓库已知 `typecheck` 与 `lint` 仍处于红线阶段，因此本批不把它们作为“由本批引入的新失败”判断口径
+- 本批主要验证目标是：删除小残留后，不产生新的导入断裂和构建断裂
+
+---
+
+## 6. 本批次结果判断
+
+本批次完成后，工程至少获得了 3 个直接收益：
+
+1. `src/prompts/`、`src/services/`、`src/components/custom-world-*` 中少了一批无入口孤岛
+2. 当前目录里“看起来像正式入口，其实已经废弃”的误导性对象减少
+3. 后续可以把精力集中到真正高价值的批次 B/C/D，而不是继续被小残留分散判断成本
+
+---
+
+## 7. 下一批建议
+
+建议严格按计划继续往下推进：
+
+1. 批次 B：`GameShell`、`storyBootstrap`、`useEquipmentFlow`、`useForgeFlow`、`useInventoryFlow`
+2. 批次 C：`runtimeStoryCoordinator`、`runtimeStoryService`、`apiClient`
+3. 批次 D：`npcEncounterActions`、`questDirector`、`runtimeItemAiDirector`、`ai.ts`
+
+一句话总结本批次：
+
+**先把最确定的死分支和占位壳子清掉，让主工程少一些假入口、假主源、假能力，再进入更重的主链收口。**
diff --git a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md
new file mode 100644
index 00000000..f4bb8093
--- /dev/null
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md
@@ -0,0 +1,145 @@
+# 工程死分支清理执行记录 B（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+这份记录对应清洗计划中的：
+
+- `批次 B：旧 flow / 旧 shell / 旧 hook`
+
+本批次聚焦的不是小型 stub，而是：
+
+**已经退出正式主流程、但仍占着高辨识度命名和旧职责心智的壳层与流程 Hook。**
+
+这类文件如果继续留在仓库里，问题比小 helper 更大，因为它们会持续制造误判：
+
+1. 新人会以为它们还是正式入口
+2. 后续开发会误判“应该往这里接逻辑”
+3. review 时会多出一层“旧主链是不是还活着”的判断成本
+
+---
+
+## 1. 本批次已处理对象
+
+## 1.1 已删除文件
+
+| 文件 | 判定 | 删除原因 | 替代路径 / 当前真相源 | 验证口径 |
+| --- | --- | --- | --- | --- |
+| `src/components/GameShell.tsx` | 旧主流程壳层残留 | 当前正式壳层已由 `src/components/game-shell/GameShellRuntime.tsx` 承接，旧文件无正式 import | `src/components/game-shell/GameShellRuntime.tsx`、`src/hooks/useGameShellRuntime.ts` | 全仓检索未发现对旧 `GameShell` 组件的正式消费 |
+| `src/hooks/story/storyBootstrap.ts` | 旧启动流程 Hook 残留 | 当前主剧情启动链已不再调用该 Hook，继续保留只会误导人以为它还是故事初始化入口 | 当前 story runtime / coordinator 链 | 全仓检索未发现 `useStoryBootstrap` 消费方 |
+| `src/hooks/useEquipmentFlow.ts` | 旧装备流程 Hook 残留 | 当前正式背包与装备链未消费该 Hook，属于旧流程实现残留 | 当前 inventory / runtime 正式链 | 符号级检索仅命中定义文件自身 |
+| `src/hooks/useForgeFlow.ts` | 旧锻造流程 Hook 残留 | 当前正式锻造入口未通过该 Hook 进入主链，保留会制造旧流程错觉 | 当前 inventory / runtime 正式链 | 符号级检索仅命中定义文件自身 |
+| `src/hooks/useInventoryFlow.ts` | 旧背包使用流程 Hook 残留 | 当前主流程未消费该 Hook，属于旧状态推进实现残留 | 当前 inventory / runtime 正式链 | 符号级检索仅命中定义文件自身 |
+
+---
+
+## 2. 为什么这批要紧跟批次 A 处理
+
+批次 A 清掉的是“小型假入口”。
+
+批次 B 清掉的是“高辨识度旧主链”。
+
+这批必须紧跟着做，原因是：
+
+1. 它们虽然比 stub 更大，但引用关系同样清楚
+2. 它们的误导性比小残留更强
+3. 不先处理这批，后面做批次 C/D 时，很容易继续有人拿旧 flow Hook 当候选接线点
+
+一句话讲：
+
+**批次 A 是去噪，批次 B 是拔掉旧路牌。**
+
+---
+
+## 3. 本批次删除后的结构变化
+
+本批次完成后，仓库里的流程心智会更清楚：
+
+1. 游戏壳层正式入口继续收敛到 `src/components/game-shell/**`
+2. 旧 `GameShell.tsx` 不再和 `GameShellRuntime.tsx` 并存
+3. 旧的装备 / 锻造 / 背包单独 flow Hook 不再伪装成还在生效的正式实现
+4. 旧 `storyBootstrap` 不再和当前 story runtime 链并存
+
+这会直接减少两类误判：
+
+1. “是不是还有旧主流程没迁完”
+2. “我是不是应该把新逻辑继续补进这些旧 Hook”
+
+---
+
+## 4. 本批次暂不处理对象
+
+虽然批次 B 已经处理了旧 shell / old flow / old bootstrap，但以下对象仍暂缓：
+
+1. `src/components/custom-world-home/CustomWorldCreationHub.tsx`
+2. `src/data/buildTagSimilarity.generated.ts`
+3. 批次 C 的运行时真相链：
+   - `src/hooks/story/runtimeStoryCoordinator.ts`
+   - `src/services/runtimeStoryService.ts`
+   - `src/services/apiClient.ts`
+4. 批次 D 的混合执行层：
+   - `src/hooks/story/npcEncounterActions.ts`
+   - `src/services/questDirector.ts`
+   - `src/services/runtimeItemAiDirector.ts`
+   - `src/services/ai.ts`
+
+暂缓原因很明确：
+
+1. 这些对象要么仍在当前正式链上
+2. 要么涉及运行时真相与鉴权边界
+3. 不能按“无引用旧壳”同一口径直接删除
+
+---
+
+## 5. 本批次验证方式
+
+## 5.1 删除前验证
+
+1. 全仓检索 `GameShell` 旧组件消费方，确认当前正式壳层已切到 `game-shell/` 目录
+2. 全仓检索 `useStoryBootstrap`
+3. 全仓检索旧装备 / 锻造 / 背包 flow Hook 导出的 handler 名称
+4. 交叉确认当前正式主链入口已存在替代实现
+
+## 5.2 删除后验证
+
+建议至少执行：
+
+1. `npm run check:encoding`
+2. `npm run build`
+
+如果这两项通过，说明：
+
+1. 删除没有引入新的导入断裂
+2. 主工程构建链仍然成立
+
+---
+
+## 6. 本批次结果判断
+
+本批次完成后，工程获得的直接收益是：
+
+1. 旧主流程壳层不再和现行壳层并存
+2. 旧流程 Hook 不再占据 `src/hooks/` 的主路径注意力
+3. 当前正式入口和历史残留的边界更清楚
+4. 后续开发更不容易把新逻辑接回旧流程壳子
+
+---
+
+## 7. 下一批建议
+
+建议下一步进入真正有结构价值的收口：
+
+1. `批次 C：运行时真相收口`
+   - `runtimeStoryCoordinator`
+   - `runtimeStoryService`
+   - `apiClient`
+2. `批次 D：任务 / 物品 / AI 混合执行层收口`
+   - `npcEncounterActions`
+   - `questDirector`
+   - `runtimeItemAiDirector`
+   - `ai.ts`
+
+一句话总结本批次：
+
+**这一步不是在“删几个没用 Hook”，而是在把已经退场的旧主流程壳层和旧 flow 路牌从主工程里真正拔掉，让现行架构不再和历史壳子并排站着。**
diff --git a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md
new file mode 100644
index 00000000..9e9f7a80
--- /dev/null
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md
@@ -0,0 +1,177 @@
+# 工程死分支清理执行记录 C（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+这份记录对应清洗计划中的：
+
+- `批次 C：运行时真相收口`
+
+但这次不是“一口气把运行时真相链全删干净”，而是先做其中最明确、风险最低、最不该继续拖的那一段：
+
+1. **收掉前端本地自动登录用户名 / 密码真相**
+2. **把登录恢复改成优先依赖服务端 session / refresh**
+
+同时，这一批也明确记录了一件事：
+
+**运行时快照前置写入链当前还不能直接砍。**
+
+原因不是“不想动”，而是服务端当前 `runtime story` 动作入口仍然以远端快照作为执行基线。  
+在后端 contract 没先改好之前，前端不能假装自己已经退出这条链。
+
+---
+
+## 1. 本批次已处理对象
+
+## 1.1 已收口的鉴权链
+
+| 文件 | 处理动作 | 本批结论 |
+| --- | --- | --- |
+| `src/services/apiClient.ts` | 删除本地自动登录用户名 / 密码存取逻辑 | 前端不再保存 auto auth 账号密码 |
+| `src/services/authService.ts` | 去掉对本地游客凭证的读写依赖 | 自动游客登录改为仅本次生成凭证，不再长期落本地 |
+| `src/components/auth/AuthGate.tsx` | 去掉“必须先有本地 access token 才尝试恢复”的前置假设 | 登录恢复改为优先尝试服务端 `getCurrentAuthUser()` / refresh session |
+| `src/services/authService.test.ts` | 改写游客自动登录相关断言 | 验证改为“生成临时凭证并完成登录”，而不是“落本地账号密码” |
+| `src/components/auth/AuthGate.test.tsx` | 改写登录恢复 mock | 验证改为“先尝试服务端会话恢复，再决定是否走游客兜底” |
+
+---
+
+## 2. 本批次为什么先做这段
+
+这批优先级高，是因为它同时满足 4 条：
+
+1. **风险明确。**
+   浏览器保存自动登录用户名 / 密码，本身就不符合“前端只做表现、后端负责鉴权真相”的方向。
+2. **替代路径已经存在。**
+   后端已经有 refresh session cookie 与 `getCurrentAuthUser()`，不是没有可替代能力。
+3. **改动边界清楚。**
+   这一段主要落在前端鉴权恢复逻辑和测试，不会直接波及运行时战斗、任务、物品、剧情主链。
+4. **收益直接。**
+   一旦收掉，前端就少了一份最不该长期保留的高风险真相。
+
+一句话讲：
+
+**这一步先把“浏览器记住游客账号密码再重登”这条假真相链拔掉。**
+
+---
+
+## 3. 本批次明确没做的事
+
+## 3.1 没有直接删除 `runtimeStoryCoordinator.ts` 里的前置 `putSaveSnapshot(...)`
+
+这不是漏做，而是明确暂缓。
+
+当前复核结果是：
+
+1. `server-node/src/modules/story/storyActionService.ts`
+2. `server-node/src/routes/runtimeRoutes.ts`
+3. `server-node/src/repositories/runtimeRepository.ts`
+
+这条后端链当前仍然通过远端快照读取运行时状态，再执行：
+
+1. `getRuntimeStoryState`
+2. `resolveRuntimeStoryAction`
+
+也就是说，当前真实情况不是“前端多写了一份完全没用的镜像”，而是：
+
+**前端在提交动作前先把当前状态写回远端快照，后端再基于这份快照执行业务动作。**
+
+在这个 contract 没先升级为“前端只发 action，后端自己持有完整 session 真相”之前，前端不能直接把这一步砍掉。
+
+否则会出现：
+
+1. 动作请求仍在走
+2. 但服务端读取到的执行基线不完整
+3. 最后不是收口真相，而是把主链打断
+
+## 3.2 没有删除 `runtimeStoryService.ts` / `runtimeStoryCoordinator.ts` 的快照再水合逻辑
+
+这一步本轮也做了复核，结论是：
+
+1. 我曾尝试把 `runtimeStoryCoordinator.ts` 中对服务端返回快照的重复再水合去掉
+2. 但对应的 `runtimeStoryCoordinator` 测试立即暴露出：当前后端返回的快照在部分战斗场景下还不是完整水合态
+3. 说明前端当前这层再水合仍然有现实职责，不是纯多余代码
+
+所以这一步本批明确结论是：
+
+**暂不删除，等后端快照 contract 先补完整后再做。**
+
+---
+
+## 4. 本批次验证结果
+
+本批次已完成的定向验证：
+
+1. `npx vitest run src/services/authService.test.ts`
+2. `npx vitest run src/components/auth/AuthGate.test.tsx`
+3. `npx vitest run src/hooks/story/runtimeStoryCoordinator.test.ts`
+4. `npm run check:encoding`
+
+结果：
+
+1. `authService` 测试通过
+2. `AuthGate` 测试通过
+3. `runtimeStoryCoordinator` 测试通过
+4. 编码检查通过
+
+另外执行了：
+
+1. `npm run build`
+
+结果：
+
+构建产物生成成功，但 `build-gate` 仍因主包 chunk warning 拦截失败。  
+当前失败点仍是已知的主包体积问题：
+
+- `AuthenticatedApp-*.js` 超过当前 warning 门槛
+
+这属于仓库当前既有工程问题，不是本批次引入的新断裂。
+
+---
+
+## 5. 本批次完成后的实际收益
+
+这一步完成后，工程在鉴权边界上有了两个明确改善：
+
+1. **前端不再保存自动登录用户名 / 密码。**
+   浏览器只保留 access token，本地高风险游客凭证真相已经收掉。
+2. **登录恢复逻辑更接近服务端为真相源。**
+   `AuthGate` 不再假设“没有本地 token 就一定还没登录”，而是优先尝试服务端会话恢复。
+
+这意味着前端鉴权链已经从：
+
+```text
+本地用户名/密码 -> 再次 entry -> 拿 token
+```
+
+进一步收到了：
+
+```text
+refresh session / 当前会话 -> 恢复用户
+兜底时才创建一次游客凭证
+```
+
+---
+
+## 6. 本批次后续建议
+
+要继续完成批次 C，下一步不该直接在前端硬删，而应该先补后端 contract：
+
+1. 让 `runtime story` 动作链逐步摆脱“前端先写远端快照”的依赖
+2. 让服务端自己持有更完整的运行时 session 真相
+3. 等后端返回快照已经稳定水合后，再删前端的重复再水合
+
+换句话说，批次 C 的后半段应该拆成：
+
+1. **C-1：鉴权真相收口**  
+   本批已完成
+2. **C-2：运行时快照 contract 后端化**  
+   需要先改后端
+3. **C-3：前端镜像写入与重复水合退场**  
+   依赖 C-2
+
+---
+
+## 7. 一句话总结
+
+**批次 C 这一轮已经先把“浏览器长期保存游客账号密码”这条最不该存在的鉴权假真相链收掉了；而运行时快照前置写入这条链经过复核确认仍受后端 contract 约束，不能在服务端未先补齐前硬砍。**
diff --git a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md
new file mode 100644
index 00000000..89315af5
--- /dev/null
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md
@@ -0,0 +1,56 @@
+# 工程死分支清理执行记录 D（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+本批次继续清理上一轮复核后剩余的低风险数据产物与测试占位：
+
+1. 未接入业务的生成产物
+2. 只为测试替换真实实现的空 stub
+3. 支撑这些残留的配置与脚本
+
+---
+
+## 1. 已删除对象
+
+| 文件 | 判定 | 删除原因 | 替代路径 / 当前真相源 |
+| --- | --- | --- | --- |
+| `src/data/buildTagSimilarity.generated.ts` | 未接入业务的生成产物 | 运行时代码不 import；Build 相似度当前由 `buildTags.ts` 中的属性亲和度逻辑计算 | `src/data/buildTags.ts` |
+| `scripts/generate-build-tag-similarity.py` | 已无输出目标的生成脚本 | 只负责生成已删除的矩阵文件，继续保留会误导后续开发恢复旧主源 | `src/data/buildTags.ts` 的手工审表逻辑 |
+| `src/data/customWorldCharacterLoadout.stub.ts` | 测试专用空 stub | 只通过 `vitest.config.ts` alias 替换真实实现；真实实现已经稳定存在 | `src/data/customWorldCharacterLoadout.ts` |
+
+---
+
+## 2. 同步更新
+
+本批次同步移除了：
+
+1. `vitest.config.ts` 中指向 `customWorldCharacterLoadout.stub.ts` 的 alias
+2. `BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md` 中把旧 generated 矩阵描述为当前文件的表述
+3. 清理计划里对 `buildTagSimilarity.generated.ts` 的未处理状态说明
+
+---
+
+## 3. 验证口径
+
+删除前已确认：
+
+1. `buildTagSimilarity.generated.ts` 无运行时代码引用
+2. `customWorldCharacterLoadout.stub.ts` 只被 `vitest.config.ts` alias 引用
+3. 真实 `customWorldCharacterLoadout.ts` 仍被 `characterPresets.ts` 与 `npcInteractions.ts` 使用，不能删除
+
+删除后建议验证：
+
+1. `npm run check:encoding`
+2. 与自定义世界开局物品相关的测试
+
+---
+
+## 4. 当前结论
+
+本批次完成后，剩余清理对象已经不再适合按“无引用直接删”推进。后续如果继续清，需要先改 contract 或主链职责：
+
+1. 运行时快照真相链
+2. 任务 / 物品 / AI 混合执行层
+3. 大型主流程组件继续拆分，而不是直接删除
diff --git a/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md b/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md
new file mode 100644
index 00000000..66b66ef5
--- /dev/null
+++ b/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md
@@ -0,0 +1,503 @@
+# 前端应迁后端逻辑审计（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 审计目标
+
+这份文档只回答一个问题：
+
+**当前前端代码里，哪些逻辑已经明显越过“前端只做表现，Express 后端负责逻辑、数据与存储”的边界，应该继续迁到后端。**
+
+本轮不改业务代码，只做：
+
+1. 基于当前仓库状态给出高置信度候选点
+2. 标明代码证据
+3. 给出迁移优先级
+4. 说明迁移后前端应该保留什么、移走什么
+
+---
+
+## 1. 结论先行
+
+结合当前代码与已有边界文档，前端里仍有 6 类逻辑应该继续后移：
+
+1. **运行时快照前置写入与本地镜像解释**
+2. **鉴权 token 的浏览器本地真相**
+3. **平台浏览历史的本地真相与迁移状态**
+4. **NPC 待接委托“换单”仍由前端直接触发正式生成**
+5. **quest/runtime item 的双环境混合编排**
+6. **浏览器侧大型 AI orchestration 与 prompt/repair/fallback 主链**
+
+一句话判断：
+
+**当前前端已经不是最早那种“大量主算”的状态，但仍然保留了运行时镜像、生成编排和部分正式真相。后端边界还需要再收一轮，前端才算真正退回表现层。**
+
+---
+
+## 2. 审计依据
+
+### 2.1 文档依据
+
+1. `docs/experience/PROJECT_WORK_EXPERIENCE_PLAYBOOK.md`
+2. `docs/planning/EXPRESS_BACKEND_REFACTOR_PLAN_2026-04-08.md`
+3. `docs/technical/RUNTIME_STORY_BACKEND_BOUNDARY_MIGRATION_2026-04-19.md`
+4. `docs/audits/engineering/ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md`
+5. `docs/audits/engineering/CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md`
+
+### 2.2 当前代码依据
+
+1. `src/hooks/story/runtimeStoryCoordinator.ts`
+2. `src/services/apiClient.ts`
+3. `src/services/platformBrowseHistory.ts`
+4. `src/components/game-shell/PreGameSelectionFlow.tsx`
+5. `src/hooks/story/npcEncounterActions.ts`
+6. `src/services/questDirector.ts`
+7. `src/services/runtimeItemAiDirector.ts`
+8. `src/services/ai.ts`
+
+---
+
+## 3. 当前高置信度应后移逻辑
+
+## 3.1 运行时快照前置写入仍在前端
+
+### 代码证据
+
+`src/hooks/story/runtimeStoryCoordinator.ts` 当前仍存在以下链路：
+
+1. `syncRuntimeSnapshot(...)`
+2. `syncRuntimeSnapshot(...)` 内部直接调用 `putSaveSnapshot(...)`
+3. `loadServerRuntimeOptionCatalog(...)` 在请求 `getRuntimeStoryState(...)` 之前先写本地快照
+4. `resolveServerRuntimeChoice(...)` 在请求 `resolveRuntimeStoryAction(...)` 之前先写本地快照
+
+对应位置：
+
+1. `src/hooks/story/runtimeStoryCoordinator.ts:21`
+2. `src/hooks/story/runtimeStoryCoordinator.ts:25`
+3. `src/hooks/story/runtimeStoryCoordinator.ts:36`
+4. `src/hooks/story/runtimeStoryCoordinator.ts:99`
+
+### 当前问题
+
+这意味着运行时正式动作发起前，前端仍会先落一份自己的快照真相，再去请求后端。
+
+这条链的问题不是“有没有缓存”，而是：
+
+1. 前端仍在承担正式提交前的状态镜像
+2. 快照解释权没有完全收回到后端
+3. 运行时主链仍处于“本地镜像 + 服务端会话”并存状态
+
+### 迁移建议
+
+后端继续承接：
+
+1. 运行时快照写入
+2. 快照版本解释
+3. 动作提交前的状态一致性校验
+
+前端只保留：
+
+1. 当前展示用的 view model
+2. 可选的只读恢复缓存
+3. 纯表现态的 loading / transition / animation state
+
+### 优先级
+
+`P0`
+
+---
+
+## 3.2 鉴权 token 仍由前端 localStorage 持有真相
+
+### 代码证据
+
+`src/services/apiClient.ts` 当前仍直接访问 `window.localStorage` 保存 access token：
+
+1. `getStoredAccessToken()`
+2. `setStoredAccessToken(...)`
+3. `clearStoredAccessToken(...)`
+4. `withAuthorizationHeaders(...)` 直接从本地 token 组装请求头
+
+对应位置：
+
+1. `src/services/apiClient.ts:333`
+2. `src/services/apiClient.ts:341`
+3. `src/services/apiClient.ts:362`
+4. `src/services/apiClient.ts:382`
+
+### 当前问题
+
+第三批清理已经收掉了“自动登录用户名/密码”本地真相，但 access token 仍然由浏览器长期持有。
+
+这在当前项目边界下仍有两个问题：
+
+1. 正式鉴权真相仍没有完全收回后端 session 边界
+2. 前端 SDK 仍然负担 token 生命周期的关键部分
+
+### 迁移建议
+
+后端继续承接：
+
+1. session / refresh / cookie 真相
+2. 鉴权状态续期
+3. token 更新与失效策略
+
+前端只保留：
+
+1. 当前是否已登录的展示态
+2. 统一的请求封装
+3. 401 后的 UI 响应
+
+### 优先级
+
+`P0`
+
+---
+
+## 3.3 平台浏览历史仍是“前端本地历史 + 后端回填”的双真相
+
+### 代码证据
+
+`src/services/platformBrowseHistory.ts` 当前仍维护一整套本地历史真相：
+
+1. `readPlatformBrowseHistory(...)`
+2. `writePlatformBrowseHistory(...)`
+3. `hasPendingPlatformBrowseHistoryMigration(...)`
+4. `markPlatformBrowseHistoryMigrated(...)`
+
+对应位置：
+
+1. `src/services/platformBrowseHistory.ts:77`
+2. `src/services/platformBrowseHistory.ts:103`
+3. `src/services/platformBrowseHistory.ts:151`
+4. `src/services/platformBrowseHistory.ts:164`
+
+`src/components/game-shell/PreGameSelectionFlow.tsx` 当前仍显式做：
+
+1. 先 `writePlatformBrowseHistory(...)`
+2. 再调用 `upsertProfileBrowseHistory(...)`
+3. 同步成功后 `markPlatformBrowseHistoryMigrated(...)`
+4. 启动阶段读取 `readPlatformBrowseHistory(...)`
+5. 根据 `hasPendingPlatformBrowseHistoryMigration(...)` 决定是否补同步
+
+对应位置：
+
+1. `src/components/game-shell/PreGameSelectionFlow.tsx:383`
+2. `src/components/game-shell/PreGameSelectionFlow.tsx:392`
+3. `src/components/game-shell/PreGameSelectionFlow.tsx:394`
+4. `src/components/game-shell/PreGameSelectionFlow.tsx:433`
+5. `src/components/game-shell/PreGameSelectionFlow.tsx:466`
+
+### 当前问题
+
+这条链已经不是单纯缓存，而是：
+
+1. 本地历史存储
+2. 本地同步标记
+3. 后端历史持久化
+
+三套状态同时存在。
+
+### 迁移建议
+
+后端继续承接：
+
+1. 浏览历史唯一持久化真相
+2. 历史去重、排序、截断
+3. 迁移完成标记
+
+前端只保留：
+
+1. 展示缓存
+2. 弱网下的临时 optimistic UI
+3. 刷新后重新拉取远端结果
+
+### 优先级
+
+`P1`
+
+---
+
+## 3.4 NPC 待接委托“换单”仍由前端直接发起正式生成
+
+### 代码证据
+
+`src/hooks/story/npcEncounterActions.ts` 当前仍保留：
+
+1. `replacePendingNpcQuestOffer = async () => { ... }`
+2. 内部直接调用 `generateQuestForNpcEncounter(...)`
+
+对应位置：
+
+1. `src/hooks/story/npcEncounterActions.ts:1561`
+2. `src/hooks/story/npcEncounterActions.ts:1595`
+
+### 当前问题
+
+聊天后是否挂出待接委托已经后移，但“换一份委托”这条分支仍然是：
+
+1. 前端组装上下文
+2. 前端决定调用生成
+3. 前端直接把结果写回当前 story UI
+
+这仍属于正式运行时任务编排没有收干净。
+
+### 迁移建议
+
+后端继续承接：
+
+1. NPC 待接委托换单决策
+2. 是否允许换单
+3. 换单后的任务草案生成
+4. 对应聊天态快照回填
+
+前端只保留：
+
+1. 点击“换一份委托”
+2. loading / error 展示
+3. 消费后端返回的新 pending quest offer
+
+### 优先级
+
+`P0`
+
+---
+
+## 3.5 questDirector 仍是前端 SDK 与生成编排混合体
+
+### 代码证据
+
+`src/services/questDirector.ts` 当前同时承担：
+
+1. `generateQuestForNpcEncounter(...)`
+2. 浏览器路径 `requestJson('/api/runtime/quests/generate')`
+3. 非浏览器路径 `requestChatMessageContent(...)`
+4. 本地 `compileQuestIntentToQuest(...)` fallback
+
+对应位置：
+
+1. `src/services/questDirector.ts:213`
+2. `src/services/questDirector.ts:242`
+3. `src/services/questDirector.ts:267`
+4. `src/services/questDirector.ts:256`
+5. `src/services/questDirector.ts:281`
+6. `src/services/questDirector.ts:293`
+
+### 当前问题
+
+这类文件虽然浏览器正式路径已经优先走后端，但职责仍混在一起：
+
+1. 前端 SDK
+2. Quest prompt 编排
+3. Quest intent 解析
+4. deterministic fallback compile
+
+这会导致边界长期模糊，也让前端仍像“半个服务端”。
+
+### 迁移建议
+
+后端继续承接：
+
+1. quest intent 生成
+2. prompt 组装
+3. JSON 解析
+4. fallback compile
+
+前端只保留：
+
+1. `requestGenerateQuest(...)` 这类轻量 SDK
+2. 请求参数组装
+3. 结果消费
+
+### 优先级
+
+`P1`
+
+---
+
+## 3.6 runtimeItemAiDirector 仍是前端 SDK 与意图生成混合体
+
+### 代码证据
+
+`src/services/runtimeItemAiDirector.ts` 当前同时承担：
+
+1. `generateRuntimeItemAiIntents(...)`
+2. 浏览器路径 `requestJson('/api/runtime/items/runtime-intent')`
+3. 非浏览器路径 `requestChatMessageContent(...)`
+4. 本地 `buildRuntimeItemAiIntent(...)` fallback
+
+对应位置：
+
+1. `src/services/runtimeItemAiDirector.ts:84`
+2. `src/services/runtimeItemAiDirector.ts:94`
+3. `src/services/runtimeItemAiDirector.ts:118`
+
+### 当前问题
+
+它和 `questDirector` 是同类问题：
+
+1. 正式浏览器路径已经走后端
+2. 但前端文件仍然承担完整生成逻辑认知
+3. 文件职责仍然是双环境混合
+
+### 迁移建议
+
+后端继续承接：
+
+1. runtime item intent prompt
+2. 模型调用
+3. 结果解析与 fallback
+
+前端只保留：
+
+1. 轻量请求 SDK
+2. 结果到 UI 的映射
+
+### 优先级
+
+`P1`
+
+---
+
+## 3.7 `src/services/ai.ts` 仍是浏览器侧正式 AI orchestration 热点
+
+### 代码证据
+
+当前 `src/services/ai.ts` 仍直接承担以下正式链路：
+
+1. `requestChatMessageContent(...)`
+2. `requestPlainTextCompletionFromClient(...)`
+3. `streamPlainTextCompletionFromClient(...)`
+4. `generateCustomWorldProfile(...)`
+5. `generateInitialStory(...)`
+6. `generateNextStep(...)`
+7. `streamNpcChatDialogue(...)`
+8. `streamNpcRecruitDialogue(...)`
+
+对应位置：
+
+1. `src/services/ai.ts:1732`
+2. `src/services/ai.ts:1868`
+3. `src/services/ai.ts:2038`
+4. `src/services/ai.ts:2339`
+5. `src/services/ai.ts:2447`
+6. `src/services/ai.ts:2487`
+7. `src/services/ai.ts:2529`
+8. `src/services/ai.ts:2570`
+
+并且文件内仍保留：
+
+1. JSON repair
+2. prompt 组装
+3. response normalize
+4. fallback/offline 响应
+5. 角色聊天建议与摘要生成
+
+### 当前问题
+
+这说明浏览器端并不只是“请求一个后端接口”，而是还在承担：
+
+1. prompt source
+2. 生成策略
+3. 错误修复
+4. fallback 编排
+5. 多类业务场景的正式 AI 出口
+
+这与“前端只做表现”存在明确冲突。
+
+### 迁移建议
+
+后端继续承接：
+
+1. story / npc / recruit / custom-world 的 prompt 编排
+2. JSON repair
+3. fallback 策略
+4. streaming orchestration
+5. 模型调用与日志
+
+前端只保留：
+
+1. 轻量 AI SDK
+2. SSE 文本流展示
+3. UI fallback 呈现
+
+### 优先级
+
+`P0`
+
+---
+
+## 4. 可以暂时保留在前端的部分
+
+下面这些内容即使和上述模块同文件出现，也不属于必须后移的对象：
+
+1. 面板开关、loading、error、streaming 文本展示
+2. 动画时间线、过场状态、临时 UI 回显
+3. 表单草稿、筛选词、排序选项
+4. 只影响表现、不影响正式真相的 view model 拼接
+
+迁移时要注意：
+
+**不是把所有前端代码都往后端搬，而是把“正式状态解释、规则裁决、生成编排、持久化真相”搬走。**
+
+---
+
+## 5. 推荐迁移顺序
+
+## 5.1 第一阶段
+
+先收最危险的正式真相：
+
+1. `runtimeStoryCoordinator.ts`
+2. `apiClient.ts`
+3. `npcEncounterActions.ts` 里的 quest replace 分支
+
+原因：
+
+1. 这三处最直接影响运行时真相和动作主链
+2. 不先收这些，前端仍然不是纯表现层
+
+## 5.2 第二阶段
+
+再拆双环境混合服务：
+
+1. `questDirector.ts`
+2. `runtimeItemAiDirector.ts`
+3. `platformBrowseHistory.ts`
+
+原因：
+
+1. 这几处已经有后端承接基础
+2. 迁移成本相对可控
+
+## 5.3 第三阶段
+
+最后继续压缩浏览器 AI orchestration：
+
+1. `src/services/ai.ts`
+2. 相关 prompt builder / repair helper / offline fallback
+
+原因：
+
+1. 这部分体量大
+2. 链路多
+3. 更适合在前两阶段把 contract 稳住后集中拆
+
+---
+
+## 6. 建议产出物
+
+如果后续按这份文档继续落地，建议每一批都至少同步产出：
+
+1. 一份落地文档，说明迁移了哪条链
+2. 一组 contract/route 变更说明
+3. 一组前端 SDK 收缩说明
+4. 一组防回退测试
+
+---
+
+## 7. 一句话结论
+
+当前前端最需要继续后移的，不是零散小工具，而是：
+
+**运行时快照前置写入、鉴权 token、本地浏览历史真相、NPC 委托换单、quest/runtime item 双环境混合编排，以及 `src/services/ai.ts` 里仍然留在浏览器的正式 AI orchestration。**
diff --git a/docs/audits/engineering/README.md b/docs/audits/engineering/README.md
index e3ae7bcf..94efb4c8 100644
--- a/docs/audits/engineering/README.md
+++ b/docs/audits/engineering/README.md
@@ -4,21 +4,36 @@
 
 ## 当前推荐入口
 
-1. [CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md](./CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md)
+1. [FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md](./FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md)
+   这一版是本轮前端越界逻辑专项审计，专门汇总当前仍应继续迁到 Express 后端的运行时、鉴权、生成编排与本地真相残留。
+2. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md)
+   这一版是第四批落地记录，聚焦未接入业务的数据生成产物、测试专用 stub 与对应配置残留出清。
+3. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md)
+   这一版是第三批落地记录，聚焦鉴权真相收口，先移除前端保存自动登录用户名/密码的本地真相，并明确运行时快照前置写入为什么当前还不能硬砍。
+4. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md)
+   这一版是第二批落地记录，聚焦旧主流程壳层、旧 bootstrap 和旧 inventory / forge / equipment flow Hook 的正式出清。
+5. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md)
+   这一版是第一批落地记录，聚焦高置信度小型孤岛、prompt 壳子、stub 和无入口 modal 的首轮清理。
+6. [CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md](./CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md)
    这一版是面向当前仓库状态的优化点盘点，适合直接拿来排优先级和拆执行批次。
-2. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md)
+7. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md)
    这一版是对 `2026-04-19` 基线的当前仓库复核，明确哪些问题已经处理、哪些表述需要纠正、热点又迁移到了哪里。
-3. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md)
+8. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md)
    这一版保留原始问题快照和执行回填，适合回看“为什么会有这轮清理与边界收口”。
-4. [ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md)
+9. [ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md)
    这一版最适合作为当前工程基线，重点从“是否真正绿色”“门禁有没有覆盖真实风险”来判断仓库状态。
-5. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md)
+10. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md)
    适合回看运行时主链路、Story/Combat 边界、分层过渡期问题。
-6. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md)
+11. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md)
    适合看第一轮系统性工程扫描，了解最早的问题基线。
 
 ## 融合结论
 
+- 最新专项审计已经把“前端哪些逻辑还该后移到后端”收敛到 6 类：运行时快照、本地 token、本地浏览历史、NPC 委托换单、quest/runtime item 混合编排、浏览器 AI orchestration。
+- 工程大清洗已经开始进入实际执行阶段，首批高置信度小型孤岛和残留壳子已开始清理。
+- 第二批已经开始清理旧主流程壳层与旧 flow Hook，当前主工程的“现行入口”和“历史入口”边界正在变得更清楚。
+- 第三批已经先完成鉴权真相收口的一段，前端不再保存自动登录用户名/密码；运行时快照链仍需先补后端 contract，再继续往前删。
+- 第四批已经继续收掉未接入业务的数据生成产物、测试专用 stub 与对应脚本/配置残留，主工程里的“假数据主源”进一步减少。
 - 当前仓库已经完成“旧 dev 插件链路删除、根目录噪音清理、`server-node -> src/**` 反向依赖切断”这批第一阶段任务。
 - 当前如果想直接判断“今天先优化什么”，优先看 `CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md`。
 - 当前的新重点已经进一步收敛到三类：未接线孤岛模块、前端残留的运行时/鉴权真相、热点向 prompt/runtime profile/平台入口壳层迁移。
diff --git a/docs/experience/CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md b/docs/experience/CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md
index 99166c90..5a15a1ab 100644
--- a/docs/experience/CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md
+++ b/docs/experience/CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md
@@ -22,20 +22,20 @@
 
 ### 2.1 编辑器入口与页签整理
 
-- 保留 `/preset-editor`、`/npc-editor`、`/function-editor`
-- 新增 `/behavior-editor` 作为“选项行为”编辑页别名
+- 当时曾保留 `/preset-editor`、`/npc-editor`、`/function-editor`
+- 当时还新增过 `/behavior-editor` 作为“选项行为”编辑页别名
 - 将原先单独的 `NPC 视觉` 标签并回 `NPC` 编辑页
 - 将 `Function` 页签改名为 `选项行为`
 
 结论：
-- 路由层要尽量兼容旧入口，避免历史链接失效
+- 独立编辑器入口如果没有继续接入主流程，应及时物理删除，不要长期保留兼容壳
 - 页签命名要贴近创作者语言，而不是内部实现命名
 
 ### 2.2 NPC 视觉模块并入 NPC 编辑
 
 完成内容：
 
-- 将 [NpcVisualEditor](/E:/Repos/Genarrative/src/components/NpcVisualEditor.tsx) 嵌入 [PresetEditor](/E:/Repos/Genarrative/src/components/PresetEditor.tsx) 的 NPC 编辑页
+- 当时曾将 `NpcVisualEditor` 嵌入 `PresetEditor` 的 NPC 编辑页
 - 让 NPC 文本字段与视觉字段围绕同一个当前选中 NPC 联动
 - 保留视觉覆盖保存与全局布局保存能力
 
diff --git a/docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md b/docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md
index 68fe5eff..16424b14 100644
--- a/docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md
+++ b/docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md
@@ -86,6 +86,22 @@
 2. 不为了“文档里写过”就把所有没接线面板都接进来
 3. 不把当前工作区重新改造成一个更复杂的大后台
 
+补充更新（`2026-04-21`）：
+
+上一轮审计里提到的一组旧 Agent 副面板，已经在工程清理中被明确判定为退出当前版本主链并物理删除，包括：
+
+1. `CustomWorldAgentLockBar.tsx`
+2. `CustomWorldAgentQuickActions.tsx`
+3. `CustomWorldAgentSummaryPanel.tsx`
+4. `CustomWorldAgentIntentSummaryPanel.tsx`
+5. `CustomWorldAgentClarificationPanel.tsx`
+6. `CustomWorldAgentDraftDetailPanel.tsx`
+7. `CustomWorldDraftCardDetailModal.tsx`
+8. `CustomWorldDraftEditPanel.tsx`
+9. `CustomWorldGenerateEntityModal.tsx`
+
+所以这里的“不为了文档里写过就全接进来”，现在不只是态度提醒，而是已经执行过的现实边界。
+
 ### 3.3 不把结果页继续当旧编辑器扩写
 
 这轮明确不再鼓励：
@@ -244,6 +260,15 @@
 
 尤其是旧 `custom-world/sessions` 这条链，如果还要保留，也只能是兼容入口，不能再和 Agent 主链平起平坐。
 
+补充更新（`2026-04-21`）：
+
+这条旧 `custom-world/sessions` 世界生成链已经完成物理删除。
+
+因此阶段三在当前仓库里的剩余任务，不再是“决定要不要保留这条旧链”，而是：
+
+1. 继续收掉结果页 legacy profile 直改能力的误导性职责
+2. 继续清理文档里把旧链当成现行选项的表述
+
 ---
 
 ## 4.5 第五件事：把文稿里那些“这轮不做”的未完成项从主叙事里移掉
@@ -323,6 +348,12 @@
 2. 把“未来也许做”从“这轮要做”里拆开
 3. 让所有当前规划只服务当前版本
 
+就当前状态补一句最重要的执行口径：
+
+1. 已经物理删除的旧链和旧副面板，不再作为“本轮待落地项”
+2. 历史 PRD 可以保留实现设想，但必须和“当前版本执行规划”分开
+3. 当前版本规划只保留仍对正式主链有现实约束的事项
+
 这一阶段的目标是：
 
 **让接下来所有开发都围绕同一套现实目标执行。**
diff --git a/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md b/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md
index 881927d7..e6c36e6b 100644
--- a/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md
+++ b/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md
@@ -164,7 +164,7 @@ Git 分支治理可以后置做，但不能和首轮工程清洗混在一起，
 11. `src/services/typewriter.ts`
 12. `src/prompts/customWorldOrchestratorPrompts.ts`
 13. `src/prompts/storyOrchestratorPrompts.ts`
-14. `src/data/buildTagSimilarity.generated.ts`
+14. `src/data/buildTagSimilarity.generated.ts`（已在后续清理批次中删除）
 
 这些文件不能直接判死刑，但必须进入“保留 / 接回 / 归档 / 删除”四选一清单。
 
diff --git a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE1_IMPLEMENTATION_PLAN_2026-04-13.md b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE1_IMPLEMENTATION_PLAN_2026-04-13.md
index 7f73a297..52c13fd7 100644
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE1_IMPLEMENTATION_PLAN_2026-04-13.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE1_IMPLEMENTATION_PLAN_2026-04-13.md
@@ -2,6 +2,16 @@
 
 更新时间：`2026-04-13`
 
+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第一阶段历史落地方案。
+
+补充边界：
+
+1. 文中出现的旧 Agent 副面板、旧世界生成链，不代表它们仍是当前版本待落地项
+2. 已被工程清理判定退出主链并删除的对象，应以最新清理记录为准，不再按这里的历史计划继续接回
+3. 当前版本执行优先级，应回到 `docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md`
+
 ## 0. 文档目的
 
 这份文档用于把以下两份 PRD 收束成可直接开工的第一阶段实现方案：
@@ -1056,6 +1066,16 @@ onSubmit({
 
 ## 12. 落地文件清单
 
+### 当前状态补充（2026-04-21）
+
+下面这份文件清单是第一阶段编写当日的历史落地清单。
+
+需要特别注意：
+
+1. 其中列出的 `CustomWorldAgentLockBar.tsx`、`CustomWorldAgentQuickActions.tsx` 等旧副面板，已经在当前版本清理中退出主链并物理删除
+2. 因此这里不能再被当作“当前版本仍要补齐的现行文件清单”
+3. 当前仍然有效的执行边界，应以最新优化规划和清理记录为准
+
 ## 12.1 shared
 
 必须新增：
diff --git a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE2_IMPLEMENTATION_PLAN_2026-04-13.md b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE2_IMPLEMENTATION_PLAN_2026-04-13.md
index b1ae0d71..9f3ae993 100644
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE2_IMPLEMENTATION_PLAN_2026-04-13.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE2_IMPLEMENTATION_PLAN_2026-04-13.md
@@ -2,6 +2,15 @@
 
 更新时间：`2026-04-13`
 
+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第二阶段历史落地方案。
+
+补充边界：
+
+1. 文中提到的 `CustomWorldAgentIntentSummaryPanel`、`CustomWorldAgentClarificationPanel`、`CustomWorldAgentLockBar`、`CustomWorldAgentQuickActions` 等旧副面板，已经在当前版本收口判断中退出主链并物理删除
+2. 这些内容现在只能作为历史设计参考，不再作为当前版本默认待接线项
+3. 当前如果要重新设计这些能力的消费方式，应基于现行主链重新定义
 ## 0. 文档目的
 
 这份文档用于把以下两份文档进一步收束成第二阶段实现方案：
@@ -548,6 +557,21 @@ buildPendingClarifications(intent, readiness)
 
 ## 10. 前端实现方案
 
+### 当前状态补充（2026-04-21）
+
+这一节描述的是第二阶段编写当时的右侧副面板方案。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentIntentSummaryPanel`
+2. `CustomWorldAgentClarificationPanel`
+3. `CustomWorldAgentLockBar`
+4. `CustomWorldAgentQuickActions`
+
+这组旧副面板不再作为当前版本默认待接线方向，其中对应已落地但退出主链的文件也已物理删除。
+
+因此本节以下内容应视为历史设计稿，不再直接代表当前版本执行方案。
+
 ## 10.1 修改 `CustomWorldAgentWorkspace.tsx`
 
 第二阶段它不再只是空壳工作区，而要新增：
@@ -679,6 +703,12 @@ buildPendingClarifications(intent, readiness)
 
 ## 13. 落地文件清单
 
+### 当前状态补充（2026-04-21）
+
+本节列的是第二阶段历史文件清单。
+
+其中涉及旧副面板的部分，现在只保留历史参考价值，不再等同于当前版本待落地项。
+
 ## 13.1 shared
 
 必须修改：
diff --git a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE3_IMPLEMENTATION_PLAN_2026-04-14.md b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE3_IMPLEMENTATION_PLAN_2026-04-14.md
index 6aef83af..a4f1ddac 100644
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE3_IMPLEMENTATION_PLAN_2026-04-14.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE3_IMPLEMENTATION_PLAN_2026-04-14.md
@@ -2,6 +2,15 @@
 
 更新时间：`2026-04-14`
 
+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第三阶段历史落地方案。
+
+补充边界：
+
+1. 文中涉及的 `CustomWorldAgentQuickActions`、`CustomWorldAgentDraftDetailPanel`、`CustomWorldDraftCardDetailModal` 等旧副面板，已在当前版本清理中退出主链并物理删除
+2. 因此这份文档里的对应实现章节，不能再直接视为当前版本待继续补完的目标
+3. 当前版本只保留对正式主链仍有现实约束的能力项
 ## 0. 文档目的
 
 这份文档用于把以下几份文档进一步收束成第三阶段实现方案：
@@ -721,6 +730,21 @@ object_refining
 
 ## 11. 前端实现方案
 
+### 当前状态补充（2026-04-21）
+
+这一节描述的是第三阶段编写当时的草稿抽屉与详情侧栏方案。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentDraftDrawer.tsx` 已在 earlier cleanup 中删除
+2. `CustomWorldAgentDraftDetailPanel.tsx`
+3. `CustomWorldDraftCardDetailModal.tsx`
+4. `CustomWorldAgentQuickActions.tsx`
+
+已在当前版本收口判断中退出主链并物理删除。
+
+因此本节以下内容应视为历史设计稿，而不是当前版本默认待落地方案。
+
 ## 11.1 修改 `CustomWorldAgentQuickActions.tsx`
 
 第三阶段必须让：
@@ -918,6 +942,12 @@ creatorIntentReadiness.isReady === false
 
 ## 14. 落地文件清单
 
+### 当前状态补充（2026-04-21）
+
+本节列的是第三阶段历史文件清单。
+
+其中涉及旧抽屉、旧详情面板、旧快捷动作面板的部分，当前仅保留历史参考意义。
+
 ## 14.1 shared
 
 必须修改：
diff --git a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE4_IMPLEMENTATION_PLAN_2026-04-14.md b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE4_IMPLEMENTATION_PLAN_2026-04-14.md
index cca30769..a936102d 100644
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE4_IMPLEMENTATION_PLAN_2026-04-14.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE4_IMPLEMENTATION_PLAN_2026-04-14.md
@@ -2,6 +2,15 @@
 
 更新时间：`2026-04-14`
 
+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第四阶段历史落地方案。
+
+补充边界：
+
+1. 文中聚焦的草稿详情编辑链与实体生成弹窗链，在当前版本收口判断中已经退出主链
+2. 对应的 `CustomWorldAgentDraftDetailPanel`、`CustomWorldDraftEditPanel`、`CustomWorldGenerateEntityModal`、`CustomWorldAgentQuickActions` 等文件已物理删除
+3. 当前版本不再把这套旧副面板链作为默认待接线方向
 ## 0. 文档目的
 
 这份文档用于把以下几份文档进一步收束成第四阶段实现方案：
@@ -665,6 +674,21 @@ generateAdditionalLandmarks(params)
 
 ## 10. 前端实现方案
 
+### 当前状态补充（2026-04-21）
+
+这一节描述的是第四阶段编写当时的草稿详情编辑链与实体生成弹窗链。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentDraftDetailPanel.tsx`
+2. `CustomWorldDraftEditPanel.tsx`
+3. `CustomWorldGenerateEntityModal.tsx`
+4. `CustomWorldAgentQuickActions.tsx`
+
+已在当前版本收口判断中退出主链并物理删除。
+
+因此本节以下内容只保留历史设计参考价值，不再直接代表当前版本执行方向。
+
 ## 10.1 修改 `CustomWorldAgentDraftDetailPanel.tsx`
 
 第四阶段它要从只读详情升级成：
@@ -851,6 +875,12 @@ editableSectionIds: []
 
 ## 13. 落地文件清单
 
+### 当前状态补充（2026-04-21）
+
+本节列的是第四阶段历史文件清单。
+
+其中涉及草稿详情编辑链与实体生成弹窗链的部分，不再等同于当前版本待落地清单。
+
 ## 13.1 shared
 
 必须修改：
diff --git a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE5_IMPLEMENTATION_PLAN_2026-04-14.md b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE5_IMPLEMENTATION_PLAN_2026-04-14.md
index 6e9c4215..0e0cd627 100644
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE5_IMPLEMENTATION_PLAN_2026-04-14.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE5_IMPLEMENTATION_PLAN_2026-04-14.md
@@ -2,6 +2,15 @@
 
 更新时间：`2026-04-14`
 
+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第五阶段历史落地方案。
+
+补充边界：
+
+1. 文中继续沿用的 `CustomWorldAgentDraftDetailPanel`、`CustomWorldAgentQuickActions` 等旧副面板，在当前版本已经退出主链并物理删除
+2. 因此这份文档里的实现安排，不应再被直接视为当前版本执行清单
+3. 当前版本是否重引入相关能力，必须基于新的主链设计重新判断
 ## 0. 文档目的
 
 这份文档用于把以下几份文档进一步收束成第五阶段实现方案：
@@ -195,6 +204,19 @@
 
 ## 7.2 入口位置
 
+### 当前状态补充（2026-04-21）
+
+这一节以下描述依赖当时仍被视为现行方案的旧详情面板链与旧快捷动作链。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentDraftDetailPanel.tsx`
+2. `CustomWorldAgentQuickActions.tsx`
+
+已退出主链并物理删除。
+
+因此这里关于入口位置的说明，现在只能作为历史资产工坊设计参考，不再代表当前版本 UI 入口。
+
 ### 角色卡详情入口
 
 在 `CustomWorldAgentDraftDetailPanel` 中，当当前卡类型为：
@@ -548,6 +570,12 @@ mergeRoleAssetIntoDraftProfile(draftProfile, payload);
 
 ## 11. 前端实现方案
 
+### 当前状态补充（2026-04-21）
+
+本节以下内容依赖旧详情面板链与旧快捷动作面板。
+
+这些文件当前已经退出主链并删除，所以这里不再是当前版本的直接执行清单。
+
 ## 11.1 修改 `CustomWorldAgentDraftDetailPanel.tsx`
 
 当卡片类型为 `character` 时，新增：
diff --git a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE6_IMPLEMENTATION_PLAN_2026-04-14.md b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE6_IMPLEMENTATION_PLAN_2026-04-14.md
index dd64840a..bb642bd1 100644
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE6_IMPLEMENTATION_PLAN_2026-04-14.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE6_IMPLEMENTATION_PLAN_2026-04-14.md
@@ -2,6 +2,15 @@
 
 更新时间：`2026-04-14`
 
+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第六阶段历史落地方案。
+
+补充边界：
+
+1. 文中继续引用的 `CustomWorldAgentDraftDetailPanel`、`CustomWorldAgentQuickActions` 等旧副面板，在当前版本已经退出主链并物理删除
+2. 这份文档可用于回看当时的资产工坊设想，但不代表当前版本仍按这里逐项补齐
+3. 当前执行边界以最新优化规划和阶段四清理边界文档为准
 ## 0. 文档目的
 
 这份文档用于把以下几份文档进一步收束成第六阶段实现方案：
@@ -190,6 +199,19 @@
 
 ## 7.2 入口位置
 
+### 当前状态补充（2026-04-21）
+
+这一节以下描述依赖当时仍被视为现行方案的旧详情面板链与旧快捷动作链。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentDraftDetailPanel.tsx`
+2. `CustomWorldAgentQuickActions.tsx`
+
+已退出主链并物理删除。
+
+因此这里关于入口位置的说明，现在只保留历史场景资产工坊设计参考价值。
+
 ### 地点卡详情入口
 
 在 `CustomWorldAgentDraftDetailPanel` 中，当当前卡类型为：
diff --git a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PRD_2026-04-12.md b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PRD_2026-04-12.md
index c4cf9d55..4f6a457a 100644
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PRD_2026-04-12.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PRD_2026-04-12.md
@@ -2,6 +2,16 @@
 
 更新时间：`2026-04-12`
 
+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为历史 PRD 基线，用于回看当时的完整目标设计。
+
+但需要特别注意：
+
+1. 文中涉及的一部分旧 Agent 副面板与旧世界生成链，已经在 `2026-04-21` 的工程清理中判定退出当前版本主链并完成物理删除
+2. 当前版本的真实执行边界，以 `docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md`、`docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md` 和最新工程清理批次记录为准
+3. 阅读这份文档时，应把它视为“历史完整设计稿”，而不是“当前版本仍要全部继续落地的执行清单”
+
 ## 0. 文档目的
 
 这份 PRD 用于把以下几份分析文档收束成一份可直接指导编码落地的新创作工具产品需求文档：
diff --git a/docs/prd/BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md b/docs/prd/BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md
index 69dd8516..79f35c3c 100644
--- a/docs/prd/BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md
+++ b/docs/prd/BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md
@@ -8,7 +8,6 @@
 
 - `src/data/buildDamage.ts`
 - `src/data/buildTags.ts`
-- `src/data/buildTagSimilarity.generated.ts`
 
 现状不是“标签各自独立生效”，而是：
 
@@ -263,7 +262,7 @@ type BuildDamageBreakdown = {
 
 ## 4.3 相似度来源
 
-当前仓库已有 `src/data/buildTagSimilarity.generated.ts`，但新方案不再以“标签-标签相似度矩阵”为主数据源。
+旧版曾生成过标签-标签相似度矩阵，但新方案不再以“标签-标签相似度矩阵”为主数据源。
 
 建议改为新增：
 
@@ -401,13 +400,13 @@ finalDamage =
 ### 风险 3：旧数据迁移成本
 
 问题：
-现有 `buildTagSimilarity.generated.ts` 将弱化甚至失去主要用途。
+旧标签相似度矩阵已经不再作为主数据源。
 
 对策：
 
-1. 本期不强制删除旧文件。
-2. 新逻辑只依赖新 affinity 表。
-3. 等新系统稳定后，再清理旧相似度矩阵和旧展示逻辑。
+1. 新逻辑只依赖标签定义中的属性亲和度。
+2. 旧相似度矩阵生成产物已从主工程移除。
+3. 后续若需要重新引入自动建议，也应输出为审表辅助数据，而不是运行时真相源。
 
 ## 11. 一句话结论
 
diff --git a/docs/reference/BUSINESS_PROMPT_INVENTORY_2026-04-19.md b/docs/reference/BUSINESS_PROMPT_INVENTORY_2026-04-19.md
index eac71f06..35d88d63 100644
--- a/docs/reference/BUSINESS_PROMPT_INVENTORY_2026-04-19.md
+++ b/docs/reference/BUSINESS_PROMPT_INVENTORY_2026-04-19.md
@@ -74,7 +74,6 @@
 | `src/prompts/storyOrchestratorPrompts.ts` | 剧情中文修复 | `STORY_LANGUAGE_REPAIR_SYSTEM_PROMPT` |
 | `src/prompts/customWorldRolePromptDefaults.ts` | 角色资产工作台默认词唯一主源 | `buildDefaultRolePromptBundle` |
 | `src/prompts/customWorldEntityActionPrompts.ts` | 编辑器技能动作词 | `buildSkillActionPrompt` |
-| `src/prompts/qwenSpriteSheetToolPrompts.ts` | Qwen 精灵图工具 prompt 模型 | 主 prompt / sheet prompt / repair prompt / negative prompt 系列 |
 
 ### 3.3 共享层
 
@@ -91,7 +90,6 @@
 - `src/services/questPrompt.ts`
 - `src/services/runtimeItemAiPrompt.ts`
 - `server-node/src/services/eightAnchorPromptBuilder.ts`
-- `src/tools/qwenSpriteSheetToolModel.ts`
 - `src/components/asset-studio/customWorldRolePromptDefaults.ts`
 - `packages/shared/src/assets/qwenSprite.ts`
 
@@ -110,14 +108,12 @@
 | --- | --- | --- |
 | `server-node/src/prompts/characterAssetPrompts.ts` | 正式角色资产生成 prompt | 后端角色主图、动作试片、角色场景词主源 |
 | `packages/shared/src/prompts/qwenSprite.ts` | 共享角色主 prompt 模板 | 共享给后端资产链使用的基础模板 |
-| `src/prompts/qwenSpriteSheetToolPrompts.ts` | 工具链 prompt 模型 | Qwen 精灵图工具主词、分镜词、修帧词、负面词 |
 | `src/prompts/customWorldRolePromptDefaults.ts` | 工作台默认词种子 | 角色视觉词、动画词、场景词默认值 |
 | `src/prompts/customWorldEntityActionPrompts.ts` | 编辑器动作词 | 技能动作描述 prompt builder |
 
 当前调用关系：
 
 - `server-node/src/modules/assets/characterAssetRoutes.ts` 调用 `server-node/src/prompts/characterAssetPrompts.ts`
-- `src/tools/QwenSpriteSheetTool.tsx` 通过兼容层消费 `src/prompts/qwenSpriteSheetToolPrompts.ts`
 - `src/components/CustomWorldRoleAssetStudioModal.tsx` 通过兼容层消费 `src/prompts/customWorldRolePromptDefaults.ts`
 - `src/components/CustomWorldEntityEditorModal.tsx` 直接调用 `src/prompts/customWorldEntityActionPrompts.ts`
 
@@ -145,7 +141,7 @@
 - `src/services/customWorld.ts` 中的自定义世界分阶段 prompt 与场景背景图 prompt
 - `src/services/ai.ts` 中的世界修复 / 语言修复 / JSON only system prompt
 - `src/services/prompt.ts`、`characterChatPrompt.ts`、`questPrompt.ts`、`runtimeItemAiPrompt.ts` 这批前端 prompt 脚本
-- `src/tools/qwenSpriteSheetToolModel.ts`、`src/components/asset-studio/customWorldRolePromptDefaults.ts`、`src/components/CustomWorldEntityEditorModal.tsx` 里的工具 / 编辑器 prompt 散点
+- `src/components/asset-studio/customWorldRolePromptDefaults.ts`、`src/components/CustomWorldEntityEditorModal.tsx` 里的工具 / 编辑器 prompt 散点
 
 ## 8. 当前仍在非 Prompt 目录中的相关文件
 
diff --git a/docs/technical/CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md b/docs/technical/CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md
new file mode 100644
index 00000000..c20759b5
--- /dev/null
+++ b/docs/technical/CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md
@@ -0,0 +1,36 @@
+# 创作页移动端 UI 修复记录
+
+日期：`2026-04-21`
+
+## 问题定位
+
+本轮修复只处理创作页表现层，不新增创作流程。
+
+当前移动端问题主要来自三处：
+
+1. 平台页在 `platformTab === 'create'` 时直接渲染 `CustomWorldCreationHub`，绕过了 `PlatformHomeView` 的移动端外壳，导致底部 Tab 栏没有挂载。
+2. 创作中心内部仍混用 `pixel-*` 九宫格样式、`bg-black/*`、`text-white`、`border-white/*` 等暗色 Tailwind 类，亮色主题下会出现深色块和低对比文字。
+3. 创作中心根节点自带 `h-full overflow-y-auto`，放回平台页后容易与平台页主滚动区抢滚动权，手机上会显得布局混乱。
+
+## 落地约束
+
+1. 创作页仍复用现有平台首页，不新增页面和新系统。
+2. 移动端底部 Tab 必须始终由 `PlatformHomeView` 统一渲染，创作页只作为 `create` Tab 的内容。
+3. 创作中心内部不再使用深色硬编码作为默认底色，普通卡片、筛选 Tab、空状态和按钮统一使用 `platform-*` token。
+4. 创作中心不再自建整页滚动，只把内容交给平台页主滚动区，避免嵌套滚动。
+5. UI 中不增加规则说明类文案，只保留必要入口、状态和作品信息。
+
+## 编码方案
+
+1. 在 `PlatformHomeView` 增加可选的 `createTabContent`，让当前 Agent 创作中心接回平台页统一外壳。
+2. `PreGameSelectionFlow` 不再在 `platformTab === 'create'` 时绕过 `PlatformHomeView`，而是把 `CustomWorldCreationHub` 作为创作 Tab 内容传入。
+3. `CustomWorldCreationHub` 改为无内部整页滚动的内容容器，标题、返回、计数、错误、加载骨架都使用平台 token。
+4. `CustomWorldCreationStartCard` 与 `CustomWorldWorkCard` 从像素暗色面板切换为平台卡片样式，保留游戏化主视觉但跟随亮暗主题。
+5. `CustomWorldWorkTabs` 改用 `platform-tab`，并保持横向滚动与清晰选中态。
+
+## 验收要点
+
+1. 手机宽度下进入“创作”后，底部“首页 / 创作 / 存档 / 我的”Tab 始终可见。
+2. 亮色主题下创作页默认卡片不出现大面积黑色底板。
+3. 创作页只有平台页主内容区滚动，底部 Tab 不随作品列表滚走。
+4. 桌面端仍可通过左侧平台导航进入创作页。
diff --git a/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md b/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
index 4c4ae9e7..20c8aa9f 100644
--- a/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
+++ b/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
@@ -6,12 +6,13 @@
 
 当前这条 Agent 创作流已经完成阶段一到阶段三的主要收口。
 
-阶段四中的“文档清理”已经开始做，但还没有形成独立、完整的新主链。
+阶段四中的“文档清理”已经开始做，但还没有形成独立、完整的新主链审计闭环。
 
-因此这轮可以执行的清理只有一类：
+因此这轮可以执行的清理现在有两类：
 
 1. 删除已经不再从当前主入口可达的旧 `custom-world/sessions` 世界生成链
-2. 保留仍在服务 `Agent session` 主链或已保存作品兼容编辑体验的底层能力
+2. 删除已经完全脱离 `CustomWorldAgentWorkspace` 主链、只剩孤立互相引用与自测覆盖的 `custom-world-agent` 旧面板
+3. 保留仍在服务 `Agent session` 主链或已保存作品兼容编辑体验的底层能力
 
 这轮不做：
 
@@ -60,7 +61,8 @@
 原因：
 
 1. 文档清理已经开始，但还没有完整收束到单一结论文档
-2. 旧 `custom-world/sessions` 生成链虽然已经不在主入口上，但还未清干净
+2. 旧 `custom-world/sessions` 生成链已经完成物理清理，但与之相关的审计/PRD/知识图谱文档仍需继续统一口径
+3. `custom-world-agent` 孤岛面板已经完成第二轮物理清理，但阶段四文档总收口仍未完全覆盖所有历史 PRD 口径
 
 ---
 
@@ -72,12 +74,29 @@
 2. `server-node/src/routes/runtimeRoutes.ts` 里的旧 `custom-world/sessions` 路由
 3. `server-node/src/services/customWorldGenerationService.ts`
 4. 与这条旧链对应的测试
+5. `server-node/src/services/customWorldSessionStore.ts`
+6. `src/components/custom-world-agent/CustomWorldAgentLockBar.tsx`
+7. `src/components/custom-world-agent/CustomWorldAgentQuickActions.tsx`
+8. `src/components/custom-world-agent/CustomWorldAgentSummaryPanel.tsx`
+9. `src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.tsx`
+10. `src/components/custom-world-agent/CustomWorldAgentClarificationPanel.tsx`
+11. `src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx`
+12. `src/components/custom-world-agent/CustomWorldDraftCardDetailModal.tsx`
+13. `src/components/custom-world-agent/CustomWorldDraftEditPanel.tsx`
+14. `src/components/custom-world-agent/CustomWorldGenerateEntityModal.tsx`
+15. 仅为上述孤岛面板存在的对应测试文件
 
 不允许删除：
 
-1. `server-node/src/services/customWorldSessionStore.ts`
-2. `server-node/src/repositories/runtimeRepository.ts` 中被 Agent session 复用的 session 持久化能力
-3. `src/services/aiService.ts` 里仍在使用的 `generateCustomWorldProfile` 及其现代封装
+1. `server-node/src/repositories/runtimeRepository.ts` 中被 Agent session 复用的 session 持久化能力
+2. `src/services/aiService.ts` 里仍在使用的 `generateCustomWorldProfile` 及其现代封装
+3. 已保存作品结果页仍在使用的 legacy 编辑器兼容能力
+4. `src/components/custom-world-agent/CustomWorldAgentWorkspace.tsx` 及其仍在主链上的 5 个子模块：
+   - `CustomWorldAgentHeader`
+   - `EightAnchorProgressBar`
+   - `CustomWorldAgentOperationBanner`
+   - `CustomWorldAgentThread`
+   - `CustomWorldAgentComposer`
 
 ---
 
@@ -87,6 +106,8 @@
 
 1. `src/services/aiService.ts` 不再暴露旧 `custom-world/sessions` 请求函数
 2. `server-node/src/routes/runtimeRoutes.ts` 不再挂旧 session 路由
-3. 仓库里不再有主流程可达的旧世界生成入口
-4. Agent 主链与已保存作品编辑链仍然可用
-
+3. `server-node/src/services/customWorldSessionStore.ts` 与 `server-node/src/services/customWorldGenerationService.ts` 已物理删除
+4. 仓库里不再有主流程可达的旧世界生成入口
+5. `CustomWorldAgentWorkspace.tsx` 只保留当前正式主链需要的 5 个子模块
+6. 与旧 Agent 草稿面板相关的孤岛 UI 与自测不再继续占据正式目录注意力
+7. Agent 主链与已保存作品编辑链仍然可用
diff --git a/docs/technical/EDITOR_ASSET_API_MIGRATION_2026-04-08.md b/docs/technical/EDITOR_ASSET_API_MIGRATION_2026-04-08.md
index cd2ba7e6..1768e251 100644
--- a/docs/technical/EDITOR_ASSET_API_MIGRATION_2026-04-08.md
+++ b/docs/technical/EDITOR_ASSET_API_MIGRATION_2026-04-08.md
@@ -26,10 +26,6 @@
 - `GET /api/assets/character-animation/jobs/:taskId`
 - `POST /api/assets/character-animation/import-video`
 - `GET /api/assets/character-animation/templates`
-- `POST /api/assets/qwen-sprite/master`
-- `POST /api/assets/qwen-sprite/sheet`
-- `POST /api/assets/qwen-sprite/frame-repair`
-- `POST /api/assets/qwen-sprite/save`
 
 ---
 
@@ -50,7 +46,6 @@
 - 状态行为覆盖保存
 - 角色主形象生成、发布与任务查询
 - 角色动作生成、导入、发布、模板读取与任务查询
-- Qwen 精灵主图、精灵表、修帧与资产保存
 
 ---
 
diff --git a/docs/technical/EDITOR_ENTRY_CLEANUP_2026-04-21.md b/docs/technical/EDITOR_ENTRY_CLEANUP_2026-04-21.md
new file mode 100644
index 00000000..1b2b0f8d
--- /dev/null
+++ b/docs/technical/EDITOR_ENTRY_CLEANUP_2026-04-21.md
@@ -0,0 +1,85 @@
+# 主流程外编辑器入口清理说明（2026-04-21）
+
+日期：`2026-04-21`
+
+## 1. 文档目标
+
+记录本轮对“挂在主流程路由外的旧编辑器入口”和“仍把这些入口当现役能力的残留说明”做的收口，避免后续开发再次把历史入口误判成正式能力。
+
+---
+
+## 2. 本轮清理结论
+
+本轮确认后，当前前端正式入口只保留游戏主流程：
+
+- `src/routing/appRoutes.tsx` 仅保留 `game`
+
+本轮删除或收口的对象：
+
+- 独立前端工具路由 `qwen-sprite-tool`
+- 仅服务该独立入口的前端页面 `src/tools/QwenSpriteSheetTool.tsx`
+- 仅服务该独立入口的工具模型与持久化封装
+- 仅服务该独立入口的后端路由 `server-node/src/modules/assets/qwenSpriteRoutes.ts`
+- 路由测试里把旧编辑器 / 独立工具入口当作现役分支的断言
+- README、经验文档、类型检查配置中已经失效的旧编辑器文件引用
+
+---
+
+## 3. 为什么可以删除
+
+本轮删除对象满足下面几个条件：
+
+1. 不在当前玩家主流程中可达
+2. 没有继续嵌入正式创作主链
+3. 当前仓库已有主流程内嵌的替代能力
+4. 保留它们只会继续制造“看起来还能进、实际上已经不走”的假入口
+
+其中需要特别区分的是：
+
+- `src/editor/shared/editorApiClient.ts`
+- `server-node/src/modules/editor/editorRoutes.ts`
+- `src/components/CustomWorldEntityEditorModal.tsx`
+- `src/components/CustomWorldNpcVisualEditor.tsx`
+- `src/components/CustomWorldRoleAssetStudioModal.tsx`
+
+这些仍然服务当前主流程内嵌编辑能力，因此本轮不删除。
+
+---
+
+## 4. 当前保留的编辑能力边界
+
+当前保留的是“嵌入主流程的编辑能力”，不是“独立编辑器站点”：
+
+- 自定义世界实体编辑
+- 自定义世界角色形象编辑
+- 主流程内的角色资产工坊模态
+- 与这些能力配套的 `/api/editor/*` 与 `/api/assets/character-*` 接口
+
+后续如果还要新增编辑能力，应优先：
+
+1. 先确认是否真的需要独立入口
+2. 默认优先接回主流程模态或正式创作链
+3. 如果只是内部工具，不要长期挂在正式前端路由里
+
+---
+
+## 5. 本轮同步更新
+
+本轮已同步更新：
+
+- `README.md`
+- `docs/experience/CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md`
+- `src/routing/appRoutes.tsx`
+- `src/routing/appRoutes.test.ts`
+- `server-node/src/app.ts`
+- `tsconfig.typecheck-guardrails.json`
+
+---
+
+## 6. 后续建议
+
+后续继续清理时，优先沿着这条规则推进：
+
+1. 先识别是否还在主流程可达
+2. 再判断是否仍有正式嵌入点
+3. 若只剩文档、测试、兼容判断或独立路由壳，直接成批收口
diff --git a/docs/technical/NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md b/docs/technical/NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md
index 7616c90e..20e1ddee 100644
--- a/docs/technical/NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md
+++ b/docs/technical/NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md
@@ -150,10 +150,11 @@ JWT 现状：
 - `POST /api/custom-world/scene-image`
 - `POST /api/runtime/story/initial`
 - `POST /api/runtime/story/continue`
-- `POST /api/runtime/custom-world/sessions`
-- `GET /api/runtime/custom-world/sessions/:sessionId`
-- `POST /api/runtime/custom-world/sessions/:sessionId/answers`
-- `GET /api/runtime/custom-world/sessions/:sessionId/generate/stream`
+- `POST /api/runtime/custom-world/agent/sessions`
+- `GET /api/runtime/custom-world/agent/sessions/:sessionId`
+- `POST /api/runtime/custom-world/agent/sessions/:sessionId/messages`
+- `POST /api/runtime/custom-world/agent/sessions/:sessionId/actions`
+- `GET /api/runtime/custom-world/works`
 - `POST /api/runtime/chat/character/suggestions`
 - `POST /api/runtime/chat/character/summary`
 - `POST /api/runtime/chat/character/reply/stream`
@@ -183,10 +184,6 @@ JWT 现状：
 - `GET /api/assets/character-animation/jobs/:taskId`
 - `POST /api/assets/character-animation/import-video`
 - `GET /api/assets/character-animation/templates`
-- `POST /api/assets/qwen-sprite/master`
-- `POST /api/assets/qwen-sprite/sheet`
-- `POST /api/assets/qwen-sprite/frame-repair`
-- `POST /api/assets/qwen-sprite/save`
 
 编辑器与资产接口门禁：
 
@@ -227,9 +224,7 @@ Custom World：
 编辑器与资产工具层：
 
 - `src/editor/shared/editorApiClient.ts`
-- `src/editor/shared/useJsonSave.ts`
 - `src/components/preset-editor/characterAssetStudioPersistence.ts`
-- `src/tools/qwenSpriteSheetToolPersistence.ts`
 
 ## 10. 当前 Vite 角色
 
diff --git a/docs/technical/PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md b/docs/technical/PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md
index 1efe4240..beac32a6 100644
--- a/docs/technical/PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md
+++ b/docs/technical/PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md
@@ -11,7 +11,6 @@
 - `server-node/src/services/eightAnchorPromptBuilder.ts`
 - `server-node/src/modules/assets/characterAssetRoutes.ts`
 - `src/services/**`
-- `src/tools/qwenSpriteSheetToolModel.ts`
 - `src/components/**`
 
 问题主要有三类：
@@ -50,7 +49,6 @@ src/prompts/
 ├─ customWorldPrompts.ts
 ├─ customWorldRolePromptDefaults.ts
 ├─ questPrompts.ts
-├─ qwenSpriteSheetToolPrompts.ts
 ├─ runtimeItemPrompts.ts
 ├─ storyOrchestratorPrompts.ts
 └─ storyPromptBuilders.ts
@@ -82,8 +80,6 @@ src/prompts/
   - 八锚点状态推断、模式规则与正式单轮共创 prompt
 - `src/prompts/customWorldPrompts.ts`
   - 自定义世界分阶段生成 prompt 与场景背景图 prompt
-- `src/prompts/qwenSpriteSheetToolPrompts.ts`
-  - 精灵图工具主词 / 分镜词 / 修帧词 / 负面词
 - `src/prompts/customWorldRolePromptDefaults.ts`
   - 角色资产工作台默认 prompt 种子唯一主源
 - `src/prompts/customWorldEntityActionPrompts.ts`
@@ -127,7 +123,6 @@ src/prompts/
 - `src/services/characterChatPrompt.ts`
 - `src/services/questPrompt.ts`
 - `src/services/runtimeItemAiPrompt.ts`
-- `src/tools/qwenSpriteSheetToolModel.ts`
 - `src/components/asset-studio/customWorldRolePromptDefaults.ts`
 - `packages/shared/src/assets/qwenSprite.ts`
 
diff --git a/docs/technical/QWEN_IMAGE_2_PIXELMOTION_REPRODUCTION_WORKFLOW_2026-04-07.md b/docs/technical/QWEN_IMAGE_2_PIXELMOTION_REPRODUCTION_WORKFLOW_2026-04-07.md
index 3c124cec..83bd2db4 100644
--- a/docs/technical/QWEN_IMAGE_2_PIXELMOTION_REPRODUCTION_WORKFLOW_2026-04-07.md
+++ b/docs/technical/QWEN_IMAGE_2_PIXELMOTION_REPRODUCTION_WORKFLOW_2026-04-07.md
@@ -676,7 +676,7 @@ PixelMotion 很关键的一点，不是要求 16 帧都完美，而是允许修
 ### 13.4 推荐目录结构
 
 ```text
-pixelmotion-qwen/
+pixelmotion-workflow/
   refs/
     master.png
     pose_board_run.png
diff --git a/docs/technical/README.md b/docs/technical/README.md
index 42272303..e98fb37a 100644
--- a/docs/technical/README.md
+++ b/docs/technical/README.md
@@ -13,6 +13,7 @@
 - [AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md)：阶段二把平台创作入口统一到聚合作品列表，并收紧 Agent 结果页的新增入口职责边界。
 - [AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md)：阶段三继续降级旧 pipeline，让创作中心只认 Agent 草稿与已发布作品，并把 Agent 结果页冻结为预览收口层。
 - [CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md](./CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md)：对照当前优化计划核查四阶段完成度，并明确这轮只允许物理删除旧 `custom-world/sessions` 世界生成链，不误伤 Agent 主链与已保存作品兼容编辑链。
+- [CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md](./CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md)：创作页移动端底部 Tab、亮色主题 token 与滚动权责修复记录。
 - [TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md](./TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md)：把外部仓库 TXT 模式完整迁入当前项目的冻结边界、模块映射、分阶段计划与验收清单。
 - [NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md](./NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md)：当前 Node 运行时后端的技术栈、入口、鉴权、存储与接口知识图谱。
 - [EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md](./EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md)：Express 后端当前 contract 冻结版本、热点文件编辑规则与集成窗口清单。
diff --git a/package.json b/package.json
index 42655d8c..2e82716e 100644
--- a/package.json
+++ b/package.json
@@ -32,7 +32,6 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "check": "npm run lint && npm run test && npm run build && npm run check:content",
-    "generate:build-tags": "py -3 scripts/generate-build-tag-similarity.py",
     "check:data": "node scripts/run-tsx.cjs scripts/validate-content.ts",
     "check:overrides": "node scripts/run-tsx.cjs scripts/validate-overrides.ts",
     "check:smoke": "node scripts/run-tsx.cjs scripts/smoke-content.ts",
diff --git a/scripts/generate-build-tag-similarity.py b/scripts/generate-build-tag-similarity.py
deleted file mode 100644
index e9071fee..00000000
--- a/scripts/generate-build-tag-similarity.py
+++ /dev/null
@@ -1,357 +0,0 @@
-import json
-import os
-from pathlib import Path
-
-import numpy as np
-
-try:
-    from vikingdb import VikingDB, IAM, EmbeddingClient
-    from vikingdb.vector import EmbeddingData, EmbeddingModelOpt, EmbeddingRequest
-except ImportError as exc:  # pragma: no cover
-    raise SystemExit(
-        "Missing dependency: vikingdb-python-sdk.\n"
-        "Install it with: py -3 -m pip install vikingdb-python-sdk"
-    ) from exc
-
-
-def zh(value: str) -> str:
-    return value.encode("utf-8").decode("unicode_escape")
-
-
-BUILD_TAGS = [
-    {
-        "label": zh(r"\u5feb\u5251"),
-        "aliases": ["duelist", "swift blade", "swiftblade", zh(r"\u5251\u5feb"), zh(r"\u5feb\u5203")],
-        "description": zh(r"\u4ee5\u9ad8\u901f\u8f7b\u5175\u5668\u3001\u8fde\u7eed\u51fa\u624b\u548c\u8d34\u8eab\u538b\u8feb\u4e3a\u6838\u5fc3\u7684\u8fd1\u6218\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u8fde\u6bb5"),
-        "aliases": ["combo", "chain", zh(r"\u8fde\u51fb")],
-        "description": zh(r"\u4f9d\u8d56\u8fde\u7eed\u547d\u4e2d\u4e0e\u591a\u6bb5\u8282\u594f\u538b\u5236\u7684\u8f93\u51fa\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u7a81\u8fdb"),
-        "aliases": ["dash", "lunge", "mobility engage"],
-        "description": zh(r"\u5f3a\u8c03\u5feb\u901f\u8d34\u8fd1\u76ee\u6807\u3001\u62a2\u5360\u8eab\u4f4d\u548c\u5148\u624b\u5207\u5165\u7684\u6218\u6597\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u8ffd\u51fb"),
-        "aliases": ["chase", "follow-up", "finisher chase"],
-        "description": zh(r"\u64c5\u957f\u5728\u5bf9\u624b\u5931\u8861\u6216\u88ab\u51fb\u9000\u540e\u7ee7\u7eed\u8ffd\u6253\u7684\u6218\u6597\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u5feb\u88ad"),
-        "aliases": ["assassin", "rogue", "ambush", zh(r"\u523a\u51fb")],
-        "description": zh(r"\u5f3a\u8c03\u77ed\u65f6\u5207\u5165\u3001\u70b9\u6740\u5f31\u70b9\u548c\u8fc5\u901f\u8131\u79bb\u7684\u523a\u51fb\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u8fdc\u5c04"),
-        "aliases": ["projectile", "ranged", "arrow", zh(r"\u5c04\u51fb")],
-        "description": zh(r"\u4ee5\u6295\u5c04\u7269\u3001\u4e2d\u8fdc\u8ddd\u79bb\u7275\u5236\u548c\u5b89\u5168\u8f93\u51fa\u4e3a\u6838\u5fc3\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u6e38\u51fb"),
-        "aliases": ["scout", "skirmish", "harass", "fieldcraft"],
-        "description": zh(r"\u5f3a\u8c03\u8fb9\u79fb\u52a8\u8fb9\u8f93\u51fa\u3001\u8bd5\u63a2\u62c9\u626f\u548c\u62e9\u673a\u518d\u5165\u573a\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u673a\u52a8"),
-        "aliases": ["mobility", "nimble", "agile"],
-        "description": zh(r"\u4ee3\u8868\u9ad8\u4f4d\u79fb\u3001\u9ad8\u8eab\u6cd5\u548c\u5feb\u901f\u6362\u4f4d\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u98ce\u884c"),
-        "aliases": ["wind", "gust", "speed", zh(r"\u75be\u884c")],
-        "description": zh(r"\u5f3a\u8c03\u8f7b\u7075\u6b65\u6cd5\u3001\u79fb\u901f\u4f18\u52bf\u548c\u8fc5\u901f\u8c03\u4f4d\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u91cd\u51fb"),
-        "aliases": ["heavy", "slam", "mighty", "crush"],
-        "description": zh(r"\u5f3a\u8c03\u539a\u91cd\u6253\u51fb\u3001\u5355\u6b21\u9ad8\u538b\u8f93\u51fa\u548c\u6b63\u9762\u7838\u7a7f\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u7206\u53d1"),
-        "aliases": ["burst", "nova", "sudden damage"],
-        "description": zh(r"\u4ee3\u8868\u77ed\u7a97\u53e3\u5185\u8fc5\u901f\u62ac\u9ad8\u4f24\u5bb3\u5cf0\u503c\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u7834\u7532"),
-        "aliases": ["breaker", "armor break", "shatter"],
-        "description": zh(r"\u64c5\u957f\u6495\u5f00\u9632\u5fa1\u3001\u6253\u65ad\u5b88\u52bf\u548c\u9488\u5bf9\u786c\u76ee\u6807\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u538b\u5236"),
-        "aliases": ["tempo", "pressure", "control offense"],
-        "description": zh(r"\u901a\u8fc7\u6301\u7eed\u4e3b\u52a8\u8fdb\u653b\u4e0e\u8282\u594f\u5360\u4f18\u8feb\u4f7f\u5bf9\u624b\u5931\u8bef\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u538b\u8840"),
-        "aliases": ["low hp", "berserk", "risk damage"],
-        "description": zh(r"\u4ee5\u5192\u9669\u538b\u4f4e\u8840\u7ebf\u6362\u53d6\u66f4\u5f3a\u653b\u51fb\u6027\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u5b88\u5fa1"),
-        "aliases": ["ward", "guard", "protector", "defense"],
-        "description": zh(r"\u5f3a\u8c03\u51cf\u4f24\u3001\u7a33\u5b88\u548c\u9876\u4f4f\u6b63\u9762\u4f24\u5bb3\u7684\u9632\u5fa1\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u62a4\u4f53"),
-        "aliases": ["barrier", "shielding", "spirit guard", "spirit"],
-        "description": zh(r"\u504f\u5411\u62a4\u7f69\u3001\u62a4\u8eab\u6c14\u52b2\u548c\u72b6\u6001\u6297\u538b\u7684\u9632\u5fa1\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u91cd\u7532"),
-        "aliases": ["tank", "heavy armor", "iron wall"],
-        "description": zh(r"\u4ee3\u8868\u9ad8\u786c\u5ea6\u62a4\u7532\u3001\u6b63\u9762\u627f\u4f24\u4e0e\u7a33\u5b9a\u7ad9\u573a\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u53cd\u51fb"),
-        "aliases": ["counter", "riposte", "retaliate"],
-        "description": zh(r"\u901a\u8fc7\u683c\u6321\u3001\u7ad9\u6869\u4e0e\u540e\u624b\u60e9\u7f5a\u5f62\u6210\u6536\u76ca\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u9547\u90aa"),
-        "aliases": ["banish", "holy ward", "warding seal"],
-        "description": zh(r"\u64c5\u957f\u538b\u5236\u90aa\u795f\u3001\u5492\u715e\u548c\u5f02\u7c7b\u80fd\u91cf\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u6cd5\u4fee"),
-        "aliases": ["caster", "mage", "arcane", "spell"],
-        "description": zh(r"\u4ee5\u6cd5\u672f\u9a71\u52a8\u8f93\u51fa\u3001\u63a7\u5236\u548c\u8d44\u6e90\u8fd0\u8f6c\u7684\u6838\u5fc3\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u6cd5\u529b"),
-        "aliases": ["mana", "magic", "essence", "spirit power"],
-        "description": zh(r"\u56f4\u7ed5\u6cd5\u529b\u4e0a\u9650\u3001\u6cd5\u672f\u6d88\u8017\u4e0e\u6cd5\u80fd\u5faa\u73af\u6784\u7b51\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u96f7\u6cd5"),
-        "aliases": ["lightning", "thunder", "storm"],
-        "description": zh(r"\u4ee3\u8868\u9ad8\u538b\u96f7\u7cfb\u672f\u6cd5\u3001\u77ac\u65f6\u9707\u8361\u548c\u9ebb\u75f9\u538b\u5236\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u7b26\u9635"),
-        "aliases": ["sigil", "formation", "seal", "rune"],
-        "description": zh(r"\u901a\u8fc7\u7b26\u7bb4\u3001\u6cd5\u9635\u548c\u9884\u5e03\u7f6e\u6548\u679c\u6539\u53d8\u6218\u573a\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u63a7\u573a"),
-        "aliases": ["control", "crowd control", "lockdown"],
-        "description": zh(r"\u4ee5\u9650\u5236\u884c\u52a8\u3001\u5c01\u9501\u7a7a\u95f4\u548c\u538b\u7f29\u9009\u62e9\u4e3a\u6838\u5fc3\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u8fc7\u8f7d"),
-        "aliases": ["overload", "surge", "power spike"],
-        "description": zh(r"\u5728\u77ed\u65f6\u95f4\u5185\u63a8\u52a8\u9ad8\u6cd5\u8017\u4e0e\u9ad8\u5f3a\u5ea6\u91ca\u653e\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u56de\u590d"),
-        "aliases": ["heal", "healing", "recovery", "restore"],
-        "description": zh(r"\u5f3a\u8c03\u5373\u65f6\u6062\u590d\u4e0e\u6218\u540e\u7eed\u63a5\u80fd\u529b\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u62a4\u6301"),
-        "aliases": ["support", "aid", "blessing"],
-        "description": zh(r"\u901a\u8fc7\u589e\u76ca\u3001\u62ac\u7a33\u6001\u548c\u4fdd\u62a4\u961f\u53cb\u6765\u5efa\u7acb\u4f18\u52bf\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u7eed\u6218"),
-        "aliases": ["sustain", "endurance", "long fight"],
-        "description": zh(r"\u9762\u5411\u957f\u7ebf\u6218\u6597\u3001\u8d44\u6e90\u6301\u7eed\u4e0e\u5bb9\u9519\u63d0\u5347\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u547d\u7eb9"),
-        "aliases": ["fate", "omen", "destiny"],
-        "description": zh(r"\u56f4\u7ed5\u547d\u8fd0\u3001\u5370\u8bb0\u4e0e\u89e6\u53d1\u5f0f\u8fde\u9501\u6536\u76ca\u6784\u7b51\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u673a\u7f18"),
-        "aliases": ["fortune", "luck", "opportunity"],
-        "description": zh(r"\u4f9d\u8d56\u65f6\u673a\u3001\u8fd0\u52bf\u548c\u989d\u5916\u6536\u76ca\u89e6\u53d1\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u51b7\u5374"),
-        "aliases": ["cooldown", "cdr", "recharge"],
-        "description": zh(r"\u901a\u8fc7\u66f4\u5feb\u5468\u8f6c\u6280\u80fd\u4e0e\u9053\u5177\u6765\u6eda\u52a8\u4f18\u52bf\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u7edf\u5fa1"),
-        "aliases": ["commander", "command", "leader"],
-        "description": zh(r"\u5f3a\u8c03\u6574\u4f53\u534f\u8c03\u3001\u56e2\u961f\u6536\u76ca\u548c\u7efc\u5408\u8c03\u5ea6\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u5747\u8861"),
-        "aliases": ["balanced", "adaptable", "all-round"],
-        "description": zh(r"\u6ca1\u6709\u660e\u663e\u77ed\u677f\uff0c\u504f\u91cd\u4e2d\u540e\u671f\u7a33\u5b9a\u6210\u578b\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u5de5\u5de7"),
-        "aliases": ["craft", "artisan", "utility", "socket"],
-        "description": zh(r"\u504f\u5411\u5de5\u827a\u3001\u5668\u68b0\u3001\u9576\u5d4c\u548c\u8f85\u52a9\u6784\u7b51\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u70bc\u836f"),
-        "aliases": ["alchemy", "potion", "tonic"],
-        "description": zh(r"\u56f4\u7ed5\u836f\u5242\u3001\u4e34\u65f6\u5f3a\u5316\u548c\u6218\u4e2d\u8865\u7ed9\u7684\u5de5\u827a\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u5148\u950b"),
-        "aliases": ["vanguard", "frontline"],
-        "description": zh(r"\u4ee3\u8868\u961f\u4f0d\u4e2d\u7684\u6b63\u9762\u5f00\u8def\u3001\u5403\u7ebf\u4e0e\u538b\u524d\u6392\u804c\u8d23\u3002"),
-    },
-    {
-        "label": zh(r"\u72c2\u6218"),
-        "aliases": ["berserker", "rage"],
-        "description": zh(r"\u4ee5\u8840\u91cf\u4ea4\u6362\u3001\u731b\u653b\u548c\u9ad8\u98ce\u9669\u9ad8\u56de\u62a5\u4e3a\u7279\u8272\u7684\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u6cd5\u5251"),
-        "aliases": ["spellblade", "bladecaster"],
-        "description": zh(r"\u878d\u5408\u5175\u5203\u4e0e\u672f\u6cd5\uff0c\u64c5\u957f\u4e2d\u8ddd\u79bb\u538b\u8feb\u7684\u6df7\u5408\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u5723\u4f51"),
-        "aliases": ["paladin", "holy guard"],
-        "description": zh(r"\u517c\u5177\u9632\u62a4\u3001\u56de\u590d\u548c\u60e9\u6212\u80fd\u529b\u7684\u795d\u798f\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u5821\u5792"),
-        "aliases": ["fortress", "bulwark"],
-        "description": zh(r"\u4ee5\u7a33\u5b9a\u7ad9\u573a\u3001\u786c\u6297\u4e0e\u53cd\u6253\u4e3a\u6838\u5fc3\u7684\u91cd\u9632\u5fa1\u6807\u7b7e\u3002"),
-    },
-    {
-        "label": zh(r"\u8d77\u624b"),
-        "aliases": ["starter", "legacy"],
-        "description": zh(r"\u504f\u8fc7\u6e21\u4e0e\u8d77\u6b65\u7528\u9014\u7684\u65e9\u671f\u6784\u7b51\u6807\u7b7e\u3002"),
-    },
-]
-
-
-def build_prompt(definition: dict) -> str:
-    aliases = "\u3001".join(definition["aliases"])
-    return f"{definition['label']}：{definition['description']} 别名：{aliases}。"
-
-
-def load_env_file(path: Path, protected_keys: set[str]) -> None:
-    if not path.exists():
-        return
-
-    for raw_line in path.read_text(encoding="utf-8").splitlines():
-        line = raw_line.strip()
-        if not line or line.startswith("#") or "=" not in line:
-            continue
-
-        key, value = line.split("=", 1)
-        key = key.strip()
-        if not key or key in protected_keys:
-            continue
-
-        value = value.strip()
-        if len(value) >= 2 and value[0] == value[-1] and value[0] in {"'", '"'}:
-            value = value[1:-1]
-
-        os.environ[key] = value
-
-
-def load_local_env() -> None:
-    root_dir = Path(__file__).resolve().parents[1]
-    protected_keys = set(os.environ)
-
-    load_env_file(root_dir / ".env", protected_keys)
-    load_env_file(root_dir / ".env.local", protected_keys)
-
-
-def create_embedding_client() -> EmbeddingClient:
-    access_key = os.getenv("VOLCENGINE_ACCESS_KEY_ID") or os.getenv("VIKINGDB_ACCESS_KEY_ID")
-    secret_key = os.getenv("VOLCENGINE_SECRET_ACCESS_KEY") or os.getenv("VIKINGDB_SECRET_ACCESS_KEY")
-    host = os.getenv("VIKINGDB_HOST", "api-vikingdb.vikingdb.cn-beijing.volces.com")
-    region = os.getenv("VIKINGDB_REGION", "cn-beijing")
-
-    if not access_key or not secret_key:
-        raise SystemExit(
-            "Missing VikingDB credentials.\n"
-            "Required:\n"
-            "  VOLCENGINE_ACCESS_KEY_ID\n"
-            "  VOLCENGINE_SECRET_ACCESS_KEY\n"
-            "Optional:\n"
-            "  VIKINGDB_HOST (default: api-vikingdb.vikingdb.cn-beijing.volces.com)\n"
-            "  VIKINGDB_REGION (default: cn-beijing)\n"
-        )
-
-    service = VikingDB(
-        host=host,
-        region=region,
-        auth=IAM(ak=access_key, sk=secret_key),
-    )
-    return EmbeddingClient(service)
-
-
-def encode_texts(client: EmbeddingClient, texts: list[str]) -> np.ndarray:
-    request = EmbeddingRequest(
-        data=[EmbeddingData(text=text) for text in texts],
-        dense_model=EmbeddingModelOpt(name="bge-large-zh"),
-    )
-    response = client.embedding(request)
-    result = getattr(response, "result", None)
-    data = getattr(result, "data", None) if result is not None else None
-    if data is None and isinstance(result, dict):
-        data = result.get("data")
-    if data is None:
-        data = getattr(response, "data", None)
-
-    if data is None:
-        raise ValueError("Embedding response did not include any data entries.")
-
-    embeddings: list[list[float]] = []
-    for item in data:
-        dense = getattr(item, "dense", None)
-        if dense is None and isinstance(item, dict):
-            dense = item.get("dense")
-        if dense is None:
-            dense = getattr(item, "embedding", None)
-        if dense is None and isinstance(item, dict):
-            dense = item.get("embedding")
-        if dense is None:
-            raise ValueError("Embedding response item did not include a dense vector.")
-        embeddings.append(dense)
-
-    matrix = np.array(embeddings, dtype=np.float32)
-    norms = np.linalg.norm(matrix, axis=1, keepdims=True)
-    norms[norms == 0] = 1.0
-    return matrix / norms
-
-
-def main():
-    load_local_env()
-    client = create_embedding_client()
-    prompts = [build_prompt(definition) for definition in BUILD_TAGS]
-    embeddings = encode_texts(client, prompts)
-
-    threshold = 0.35
-    pairs: list[tuple[str, str, float]] = []
-    for index, left in enumerate(BUILD_TAGS):
-        for other_index in range(index + 1, len(BUILD_TAGS)):
-            right = BUILD_TAGS[other_index]
-            similarity = float(np.dot(embeddings[index], embeddings[other_index]))
-            if similarity < threshold:
-                continue
-            pairs.append((left["label"], right["label"], round(similarity, 4)))
-
-    output_path = Path(__file__).resolve().parents[1] / "src" / "data" / "buildTagSimilarity.generated.ts"
-    lines = [
-        "export const BUILD_TAG_SIMILARITY_PAIRS: Array<readonly [string, string, number]> = ["
-    ]
-    for left, right, similarity in pairs:
-        lines.append(f"  ['{left}', '{right}', {similarity}],")
-    lines.append("] as const;")
-    output_path.write_text("\n".join(lines) + "\n", encoding="utf-8")
-
-    print(json.dumps({
-        "output": str(output_path),
-        "pair_count": len(pairs),
-        "model": "bge-large-zh",
-    }, ensure_ascii=False))
-
-
-if __name__ == "__main__":
-    main()
diff --git a/server-node/src/app.ts b/server-node/src/app.ts
index e716912c..2227b813 100644
--- a/server-node/src/app.ts
+++ b/server-node/src/app.ts
@@ -8,7 +8,6 @@ import { errorHandler } from './middleware/errorHandler.js';
 import { requestIdMiddleware } from './middleware/requestId.js';
 import { responseEnvelopeMiddleware } from './middleware/responseEnvelope.js';
 import { createCharacterAssetRoutes } from './modules/assets/characterAssetRoutes.js';
-import { createQwenSpriteRoutes } from './modules/assets/qwenSpriteRoutes.js';
 import { createEditorRoutes } from './modules/editor/editorRoutes.js';
 import { createStoryActionRoutes } from './modules/story/storyActionRoutes.js';
 import { createAuthRoutes } from './routes/authRoutes.js';
@@ -119,18 +118,6 @@ export function createApp(context: AppContext) {
       createCharacterAssetRoutes(context.config, context.llmClient),
     ),
   );
-  app.use(
-    scopeToPrefixes(
-      ['/api/assets/qwen-sprite'],
-      withRouteMeta({ routeVersion: '2026-04-08', operation: 'assets.qwen' }),
-    ),
-  );
-  app.use(
-    scopeToPrefixes(
-      ['/api/assets/qwen-sprite'],
-      createQwenSpriteRoutes(context.config),
-    ),
-  );
   app.use(
     '/api/auth',
     withRouteMeta({ routeVersion: '2026-04-08' }),
diff --git a/server-node/src/context.ts b/server-node/src/context.ts
index 8f195f8e..e978ac56 100644
--- a/server-node/src/context.ts
+++ b/server-node/src/context.ts
@@ -12,7 +12,6 @@ import { UserSessionRepository } from './repositories/userSessionRepository.js';
 import { CaptchaChallengeStore } from './services/captchaChallengeStore.js';
 import { CustomWorldAgentOrchestrator } from './services/customWorldAgentOrchestrator.js';
 import { CustomWorldAgentSessionStore } from './services/customWorldAgentSessionStore.js';
-import { CustomWorldSessionStore } from './services/customWorldSessionStore.js';
 import { UpstreamLlmClient } from './services/llmClient.js';
 import type { SmsVerificationService } from './services/smsVerificationService.js';
 import type { WechatAuthService } from './services/wechatAuthService.js';
@@ -30,7 +29,6 @@ export type AppContext = {
   userSessionRepository: UserSessionRepository;
   runtimeRepository: RuntimeRepository;
   llmClient: UpstreamLlmClient;
-  customWorldSessions: CustomWorldSessionStore;
   customWorldAgentSessions: CustomWorldAgentSessionStore;
   customWorldAgentOrchestrator: CustomWorldAgentOrchestrator;
   smsVerificationService: SmsVerificationService;
diff --git a/server-node/src/modules/assets/qwenSpriteRoutes.ts b/server-node/src/modules/assets/qwenSpriteRoutes.ts
deleted file mode 100644
index 4053e78d..00000000
--- a/server-node/src/modules/assets/qwenSpriteRoutes.ts
+++ /dev/null
@@ -1,907 +0,0 @@
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import http, {
-  type IncomingMessage,
-  type RequestOptions,
-  type ServerResponse,
-} from 'node:http';
-import https from 'node:https';
-import path from 'node:path';
-
-import { Router, type NextFunction, type Request, type Response } from 'express';
-import type { AppConfig } from '../../config.js';
-
-const QWEN_SPRITE_MASTER_GENERATE_PATH = '/api/assets/qwen-sprite/master';
-const QWEN_SPRITE_SHEET_GENERATE_PATH = '/api/assets/qwen-sprite/sheet';
-const QWEN_SPRITE_FRAME_REPAIR_PATH = '/api/assets/qwen-sprite/frame-repair';
-const QWEN_SPRITE_SAVE_PATH = '/api/assets/qwen-sprite/save';
-const DEFAULT_DASHSCOPE_BASE_URL = 'https://dashscope.aliyuncs.com/api/v1';
-const DEFAULT_QWEN_IMAGE_MODEL = 'qwen-image-2.0';
-
-function readJsonBody(req: IncomingMessage & { body?: unknown }) {
-  const parsedBody = req.body;
-  if (parsedBody && typeof parsedBody === 'object' && !Array.isArray(parsedBody)) {
-    return Promise.resolve(parsedBody as Record<string, unknown>);
-  }
-
-  return new Promise<Record<string, unknown>>((resolve, reject) => {
-    const chunks: Buffer[] = [];
-    req.on('data', (chunk) => {
-      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-    });
-    req.on('end', () => {
-      try {
-        const raw =
-          Buffer.concat(chunks)
-            .toString('utf8')
-            .replace(/^\uFEFF/u, '') || '{}';
-        resolve(JSON.parse(raw));
-      } catch (error) {
-        reject(error);
-      }
-    });
-    req.on('error', reject);
-  });
-}
-
-function sendJson(res: ServerResponse, statusCode: number, payload: unknown) {
-  res.statusCode = statusCode;
-  res.setHeader('Content-Type', 'application/json; charset=utf-8');
-  res.end(JSON.stringify(payload));
-}
-
-function isRecordValue(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-function isStringArray(value: unknown): value is string[] {
-  return (
-    Array.isArray(value) &&
-    value.every((item) => typeof item === 'string' && item.trim().length > 0)
-  );
-}
-
-function resolveRuntimeEnv(config: AppConfig) {
-  return config.rawEnv;
-}
-
-function normalizeDashScopeBaseUrl(value: string) {
-  return value.replace(/\/$/u, '');
-}
-
-function extractApiErrorMessage(responseText: string, fallbackMessage: string) {
-  if (!responseText.trim()) {
-    return fallbackMessage;
-  }
-
-  try {
-    const parsed = JSON.parse(responseText) as {
-      code?: string;
-      message?: string;
-      error?: { message?: string };
-    };
-    if (
-      typeof parsed.error?.message === 'string' &&
-      parsed.error.message.trim()
-    ) {
-      return parsed.error.message;
-    }
-    if (typeof parsed.message === 'string' && parsed.message.trim()) {
-      return parsed.message;
-    }
-    if (typeof parsed.code === 'string' && parsed.code.trim()) {
-      return `${fallbackMessage} (${parsed.code})`;
-    }
-  } catch {
-    // Fall through to raw text.
-  }
-
-  return responseText;
-}
-
-function sanitizePathSegment(value: string) {
-  const normalized = value
-    .trim()
-    .toLowerCase()
-    .replace(/[^a-z0-9-_]+/gu, '-')
-    .replace(/-+/gu, '-')
-    .replace(/^-|-$/gu, '');
-
-  return normalized || 'asset';
-}
-
-function createTimestampId(prefix: string) {
-  return `${prefix}-${Date.now()}`;
-}
-
-function requestTextResponse(
-  urlString: string,
-  options: {
-    method?: string;
-    headers?: Record<string, string>;
-    bodyText?: string;
-  } = {},
-) {
-  return new Promise<{
-    statusCode: number;
-    headers: Record<string, string | string[] | undefined>;
-    bodyText: string;
-  }>((resolve, reject) => {
-    const url = new URL(urlString);
-    const transport = url.protocol === 'https:' ? https : http;
-    const payload = options.bodyText;
-    const requestOptions: RequestOptions = {
-      protocol: url.protocol,
-      hostname: url.hostname,
-      port: url.port ? Number(url.port) : undefined,
-      path: `${url.pathname}${url.search}`,
-      method: options.method ?? 'GET',
-      headers: {
-        ...(options.headers ?? {}),
-        ...(payload ? { 'Content-Length': Buffer.byteLength(payload) } : {}),
-      },
-    };
-
-    const request = transport.request(requestOptions, (upstreamRes) => {
-      const chunks: Buffer[] = [];
-      upstreamRes.on('data', (chunk) => {
-        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-      });
-      upstreamRes.on('end', () => {
-        resolve({
-          statusCode: upstreamRes.statusCode ?? 502,
-          headers: upstreamRes.headers,
-          bodyText: Buffer.concat(chunks).toString('utf8'),
-        });
-      });
-      upstreamRes.on('error', reject);
-    });
-
-    request.on('error', reject);
-    if (payload) {
-      request.write(payload);
-    }
-    request.end();
-  });
-}
-
-function requestBinaryResponse(
-  urlString: string,
-  options: {
-    method?: string;
-    headers?: Record<string, string>;
-  } = {},
-) {
-  return new Promise<{
-    statusCode: number;
-    headers: Record<string, string | string[] | undefined>;
-    body: Buffer;
-  }>((resolve, reject) => {
-    const url = new URL(urlString);
-    const transport = url.protocol === 'https:' ? https : http;
-    const requestOptions: RequestOptions = {
-      protocol: url.protocol,
-      hostname: url.hostname,
-      port: url.port ? Number(url.port) : undefined,
-      path: `${url.pathname}${url.search}`,
-      method: options.method ?? 'GET',
-      headers: options.headers ?? {},
-    };
-
-    const request = transport.request(requestOptions, (upstreamRes) => {
-      const chunks: Buffer[] = [];
-      upstreamRes.on('data', (chunk) => {
-        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-      });
-      upstreamRes.on('end', () => {
-        resolve({
-          statusCode: upstreamRes.statusCode ?? 502,
-          headers: upstreamRes.headers,
-          body: Buffer.concat(chunks),
-        });
-      });
-      upstreamRes.on('error', reject);
-    });
-
-    request.on('error', reject);
-    request.end();
-  });
-}
-
-function proxyJsonRequest(
-  urlString: string,
-  apiKey: string,
-  body: Record<string, unknown>,
-) {
-  return requestTextResponse(urlString, {
-    method: 'POST',
-    headers: {
-      Authorization: `Bearer ${apiKey}`,
-      'Content-Type': 'application/json',
-    },
-    bodyText: JSON.stringify(body),
-  });
-}
-
-function collectStringsByKey(
-  value: unknown,
-  targetKey: string,
-  results: string[],
-) {
-  if (Array.isArray(value)) {
-    value.forEach((item) => collectStringsByKey(item, targetKey, results));
-    return;
-  }
-
-  if (!isRecordValue(value)) {
-    return;
-  }
-
-  const directValue = value[targetKey];
-  if (typeof directValue === 'string' && directValue.trim()) {
-    results.push(directValue.trim());
-  }
-
-  Object.values(value).forEach((nestedValue) =>
-    collectStringsByKey(nestedValue, targetKey, results),
-  );
-}
-
-function extractImageUrls(payload: Record<string, unknown>) {
-  const results: string[] = [];
-  collectStringsByKey(payload.output, 'image', results);
-  collectStringsByKey(payload.output, 'url', results);
-  return [...new Set(results)];
-}
-
-function parseDataUrl(source: string) {
-  const matched = /^data:(image\/[^;]+);base64,(.+)$/u.exec(source);
-  if (!matched) {
-    return null;
-  }
-
-  const mimeType = matched[1];
-  const base64Payload = matched[2];
-  const extension = (() => {
-    switch (mimeType) {
-      case 'image/jpeg':
-        return 'jpg';
-      case 'image/webp':
-        return 'webp';
-      default:
-        return 'png';
-    }
-  })();
-
-  return {
-    buffer: Buffer.from(base64Payload, 'base64'),
-    extension,
-  };
-}
-
-async function resolveImageSourcePayload(rootDir: string, source: string) {
-  const parsedDataUrl = parseDataUrl(source);
-  if (parsedDataUrl) {
-    return parsedDataUrl;
-  }
-
-  if (!source.startsWith('/')) {
-    throw new Error('图像来源必须是 Data URL 或 public 目录 URL。');
-  }
-
-  const normalizedSource = path.posix.normalize(source).replace(/^\/+/u, '');
-  const absolutePath = path.resolve(
-    rootDir,
-    'public',
-    ...normalizedSource.split('/'),
-  );
-  const publicRoot = path.resolve(rootDir, 'public');
-
-  if (!absolutePath.startsWith(publicRoot)) {
-    throw new Error('图像来源路径越界。');
-  }
-
-  const buffer = await readFile(absolutePath);
-  const extension = path.extname(absolutePath).replace(/^\./u, '') || 'png';
-
-  return {
-    buffer,
-    extension,
-  };
-}
-
-async function resolveImageSourceAsDataUrl(rootDir: string, source: string) {
-  if (/^data:image\/[^;]+;base64,/u.test(source)) {
-    return source;
-  }
-
-  const payload = await resolveImageSourcePayload(rootDir, source);
-  const mimeType = (() => {
-    switch (payload.extension) {
-      case 'jpg':
-      case 'jpeg':
-        return 'image/jpeg';
-      case 'webp':
-        return 'image/webp';
-      default:
-        return 'image/png';
-    }
-  })();
-
-  return `data:${mimeType};base64,${payload.buffer.toString('base64')}`;
-}
-
-async function writeDraftImageFile(
-  rootDir: string,
-  relativePath: string,
-  buffer: Buffer,
-) {
-  const absolutePath = path.resolve(rootDir, 'public', ...relativePath.split('/'));
-  await mkdir(path.dirname(absolutePath), { recursive: true });
-  await writeFile(absolutePath, buffer);
-  return `/${relativePath}`;
-}
-
-async function generateQwenImages(
-  config: AppConfig,
-  input: {
-    kind: 'master' | 'sheet' | 'repair';
-    promptText: string;
-    negativePrompt: string;
-    model: string;
-    size: string;
-    promptExtend: boolean;
-    seed?: number;
-    candidateCount: number;
-    referenceImages: string[];
-  },
-) {
-  const rootDir = config.projectRoot;
-  const runtimeEnv = resolveRuntimeEnv(config);
-  const baseUrl = normalizeDashScopeBaseUrl(
-    runtimeEnv.DASHSCOPE_BASE_URL || DEFAULT_DASHSCOPE_BASE_URL,
-  );
-  const apiKey = runtimeEnv.DASHSCOPE_API_KEY || '';
-
-  if (!apiKey) {
-    throw new Error('服务端缺少 DASHSCOPE_API_KEY，无法调用 Qwen-Image。');
-  }
-
-  const content = [
-    ...(await Promise.all(
-      input.referenceImages
-        .slice(0, 3)
-        .map(async (image) => ({ image: await resolveImageSourceAsDataUrl(rootDir, image) })),
-    )),
-    { text: input.promptText },
-  ];
-
-  const requestPayload: Record<string, unknown> = {
-    model: input.model || DEFAULT_QWEN_IMAGE_MODEL,
-    input: {
-      messages: [
-        {
-          role: 'user',
-          content,
-        },
-      ],
-    },
-    parameters: {
-      n: Math.max(1, Math.min(6, input.candidateCount)),
-      negative_prompt: input.negativePrompt,
-      prompt_extend: input.promptExtend,
-      watermark: false,
-      size: input.size,
-      ...(typeof input.seed === 'number' && Number.isFinite(input.seed)
-        ? { seed: input.seed }
-        : {}),
-    },
-  };
-
-  const response = await proxyJsonRequest(
-    `${baseUrl}/services/aigc/multimodal-generation/generation`,
-    apiKey,
-    requestPayload,
-  );
-
-  if (response.statusCode < 200 || response.statusCode >= 300) {
-    throw new Error(
-      extractApiErrorMessage(response.bodyText, 'Qwen-Image 生成失败。'),
-    );
-  }
-
-  const parsed = JSON.parse(response.bodyText) as Record<string, unknown>;
-  const imageUrls = extractImageUrls(parsed);
-
-  if (imageUrls.length === 0) {
-    throw new Error('Qwen-Image 未返回可下载的图片结果。');
-  }
-
-  const draftId = createTimestampId(`qwen-${input.kind}`);
-  const relativeDir = path.posix.join(
-    'generated-qwen-sprites',
-    '_drafts',
-    input.kind,
-    draftId,
-  );
-
-  const drafts = await Promise.all(
-    imageUrls.map(async (imageUrl, index) => {
-      const binaryResponse = await requestBinaryResponse(imageUrl);
-      if (
-        binaryResponse.statusCode < 200 ||
-        binaryResponse.statusCode >= 300
-      ) {
-        throw new Error(`下载生成图片失败（${binaryResponse.statusCode}）。`);
-      }
-
-      const imageSrc = await writeDraftImageFile(
-        rootDir,
-        path.posix.join(relativeDir, `candidate-${String(index + 1).padStart(2, '0')}.png`),
-        binaryResponse.body,
-      );
-
-      return {
-        id: `${draftId}-${index + 1}`,
-        label: `${input.kind === 'master' ? '主图' : input.kind === 'sheet' ? '精灵表' : '修帧'} ${index + 1}`,
-        imageSrc,
-        remoteUrl: imageUrl,
-      };
-    }),
-  );
-
-  await writeFile(
-    path.resolve(rootDir, 'public', ...relativeDir.split('/'), 'job.json'),
-    JSON.stringify(
-      {
-        draftId,
-        kind: input.kind,
-        model: input.model,
-        size: input.size,
-        promptText: input.promptText,
-        negativePrompt: input.negativePrompt,
-        promptExtend: input.promptExtend,
-        seed: input.seed,
-        candidateCount: input.candidateCount,
-        referenceImageCount: input.referenceImages.length,
-        drafts,
-        createdAt: new Date().toISOString(),
-      },
-      null,
-      2,
-    ) + '\n',
-    'utf8',
-  );
-
-  return {
-    draftId,
-    drafts,
-    model: input.model,
-    size: input.size,
-    promptText: input.promptText,
-    negativePrompt: input.negativePrompt,
-  };
-}
-
-async function handleGenerateMaster(
-  config: AppConfig,
-  req: IncomingMessage & { body?: unknown },
-  res: ServerResponse,
-) {
-  if (req.method !== 'POST') {
-    sendJson(res, 405, { error: { message: 'Method Not Allowed' } });
-    return;
-  }
-
-  let body: Record<string, unknown>;
-  try {
-    body = await readJsonBody(req);
-  } catch {
-    sendJson(res, 400, { error: { message: 'Invalid JSON body' } });
-    return;
-  }
-
-  const promptText =
-    typeof body.promptText === 'string' ? body.promptText.trim() : '';
-  const negativePrompt =
-    typeof body.negativePrompt === 'string' ? body.negativePrompt.trim() : '';
-  const model =
-    typeof body.model === 'string' && body.model.trim()
-      ? body.model.trim()
-      : DEFAULT_QWEN_IMAGE_MODEL;
-  const size =
-    typeof body.size === 'string' && body.size.trim()
-      ? body.size.trim()
-      : '1024*1024';
-  const promptExtend = body.promptExtend !== false;
-  const candidateCount =
-    typeof body.candidateCount === 'number' && Number.isFinite(body.candidateCount)
-      ? body.candidateCount
-      : 1;
-  const seed =
-    typeof body.seed === 'number' && Number.isFinite(body.seed)
-      ? body.seed
-      : undefined;
-  const referenceImages = isStringArray(body.referenceImages)
-    ? body.referenceImages
-    : [];
-
-  if (!promptText) {
-    sendJson(res, 400, { error: { message: 'promptText is required.' } });
-    return;
-  }
-
-  try {
-    const result = await generateQwenImages(config, {
-      kind: 'master',
-      promptText,
-      negativePrompt,
-      model,
-      size,
-      promptExtend,
-      seed,
-      candidateCount,
-      referenceImages,
-    });
-
-    sendJson(res, 200, {
-      ok: true,
-      ...result,
-    });
-  } catch (error) {
-    sendJson(res, 500, {
-      error: {
-        message: error instanceof Error ? error.message : '生成主图失败。',
-      },
-    });
-  }
-}
-
-async function handleGenerateSheet(
-  config: AppConfig,
-  req: IncomingMessage & { body?: unknown },
-  res: ServerResponse,
-) {
-  if (req.method !== 'POST') {
-    sendJson(res, 405, { error: { message: 'Method Not Allowed' } });
-    return;
-  }
-
-  let body: Record<string, unknown>;
-  try {
-    body = await readJsonBody(req);
-  } catch {
-    sendJson(res, 400, { error: { message: 'Invalid JSON body' } });
-    return;
-  }
-
-  const promptText =
-    typeof body.promptText === 'string' ? body.promptText.trim() : '';
-  const negativePrompt =
-    typeof body.negativePrompt === 'string' ? body.negativePrompt.trim() : '';
-  const model =
-    typeof body.model === 'string' && body.model.trim()
-      ? body.model.trim()
-      : DEFAULT_QWEN_IMAGE_MODEL;
-  const size =
-    typeof body.size === 'string' && body.size.trim()
-      ? body.size.trim()
-      : '1024*1024';
-  const promptExtend = body.promptExtend !== false;
-  const candidateCount =
-    typeof body.candidateCount === 'number' && Number.isFinite(body.candidateCount)
-      ? body.candidateCount
-      : 1;
-  const seed =
-    typeof body.seed === 'number' && Number.isFinite(body.seed)
-      ? body.seed
-      : undefined;
-  const referenceImages = isStringArray(body.referenceImages)
-    ? body.referenceImages
-    : [];
-
-  if (!promptText) {
-    sendJson(res, 400, { error: { message: 'promptText is required.' } });
-    return;
-  }
-
-  try {
-    const result = await generateQwenImages(config, {
-      kind: 'sheet',
-      promptText,
-      negativePrompt,
-      model,
-      size,
-      promptExtend,
-      seed,
-      candidateCount,
-      referenceImages,
-    });
-
-    sendJson(res, 200, {
-      ok: true,
-      ...result,
-    });
-  } catch (error) {
-    sendJson(res, 500, {
-      error: {
-        message: error instanceof Error ? error.message : '生成精灵表失败。',
-      },
-    });
-  }
-}
-
-async function handleRepairFrame(
-  config: AppConfig,
-  req: IncomingMessage & { body?: unknown },
-  res: ServerResponse,
-) {
-  if (req.method !== 'POST') {
-    sendJson(res, 405, { error: { message: 'Method Not Allowed' } });
-    return;
-  }
-
-  let body: Record<string, unknown>;
-  try {
-    body = await readJsonBody(req);
-  } catch {
-    sendJson(res, 400, { error: { message: 'Invalid JSON body' } });
-    return;
-  }
-
-  const promptText =
-    typeof body.promptText === 'string' ? body.promptText.trim() : '';
-  const negativePrompt =
-    typeof body.negativePrompt === 'string' ? body.negativePrompt.trim() : '';
-  const model =
-    typeof body.model === 'string' && body.model.trim()
-      ? body.model.trim()
-      : DEFAULT_QWEN_IMAGE_MODEL;
-  const size =
-    typeof body.size === 'string' && body.size.trim()
-      ? body.size.trim()
-      : '512*512';
-  const promptExtend = body.promptExtend !== false;
-  const seed =
-    typeof body.seed === 'number' && Number.isFinite(body.seed)
-      ? body.seed
-      : undefined;
-  const referenceImages = isStringArray(body.referenceImages)
-    ? body.referenceImages
-    : [];
-
-  if (!promptText) {
-    sendJson(res, 400, { error: { message: 'promptText is required.' } });
-    return;
-  }
-
-  if (referenceImages.length === 0) {
-    sendJson(res, 400, {
-      error: { message: '至少需要一张参考图来修复帧。' },
-    });
-    return;
-  }
-
-  try {
-    const result = await generateQwenImages(config, {
-      kind: 'repair',
-      promptText,
-      negativePrompt,
-      model,
-      size,
-      promptExtend,
-      seed,
-      candidateCount: 1,
-      referenceImages,
-    });
-
-    sendJson(res, 200, {
-      ok: true,
-      ...result,
-      repairedFrame: result.drafts[0] ?? null,
-    });
-  } catch (error) {
-    sendJson(res, 500, {
-      error: {
-        message: error instanceof Error ? error.message : '修帧失败。',
-      },
-    });
-  }
-}
-
-async function handleSaveAsset(
-  rootDir: string,
-  req: IncomingMessage & { body?: unknown },
-  res: ServerResponse,
-) {
-  if (req.method !== 'POST') {
-    sendJson(res, 405, { error: { message: 'Method Not Allowed' } });
-    return;
-  }
-
-  let body: Record<string, unknown>;
-  try {
-    body = await readJsonBody(req);
-  } catch {
-    sendJson(res, 400, { error: { message: 'Invalid JSON body' } });
-    return;
-  }
-
-  const assetKey =
-    typeof body.assetKey === 'string' ? sanitizePathSegment(body.assetKey) : '';
-  const actionKey =
-    typeof body.actionKey === 'string' ? sanitizePathSegment(body.actionKey) : '';
-  const masterSource =
-    typeof body.masterSource === 'string' ? body.masterSource.trim() : '';
-  const sheetSource =
-    typeof body.sheetSource === 'string' ? body.sheetSource.trim() : '';
-  const framesDataUrls = isStringArray(body.framesDataUrls)
-    ? body.framesDataUrls
-    : [];
-  const metadata = isRecordValue(body.metadata) ? body.metadata : {};
-  const prompts = isRecordValue(body.prompts) ? body.prompts : {};
-
-  if (!assetKey) {
-    sendJson(res, 400, { error: { message: 'assetKey is required.' } });
-    return;
-  }
-
-  if (!actionKey) {
-    sendJson(res, 400, { error: { message: 'actionKey is required.' } });
-    return;
-  }
-
-  if (!sheetSource) {
-    sendJson(res, 400, { error: { message: 'sheetSource is required.' } });
-    return;
-  }
-
-  try {
-    const assetId = createTimestampId('qwen-sprite');
-    const relativeDir = path.posix.join(
-      'generated-qwen-sprites',
-      assetKey,
-      actionKey,
-      assetId,
-    );
-    const absoluteDir = path.resolve(rootDir, 'public', ...relativeDir.split('/'));
-    await mkdir(path.join(absoluteDir, 'frames'), { recursive: true });
-
-    let masterImagePath: string | null = null;
-    if (masterSource) {
-      const payload = await resolveImageSourcePayload(rootDir, masterSource);
-      masterImagePath = await writeDraftImageFile(
-        rootDir,
-        path.posix.join(relativeDir, `master.${payload.extension}`),
-        payload.buffer,
-      );
-    }
-
-    const sheetPayload = await resolveImageSourcePayload(rootDir, sheetSource);
-    const sheetImagePath = await writeDraftImageFile(
-      rootDir,
-      path.posix.join(relativeDir, `sheet.${sheetPayload.extension}`),
-      sheetPayload.buffer,
-    );
-
-    const framePaths: string[] = [];
-    for (let index = 0; index < framesDataUrls.length; index += 1) {
-      const framePayload = await resolveImageSourcePayload(
-        rootDir,
-        framesDataUrls[index] ?? '',
-      );
-      const framePath = await writeDraftImageFile(
-        rootDir,
-        path.posix.join(
-          relativeDir,
-          'frames',
-          `frame-${String(index + 1).padStart(2, '0')}.${framePayload.extension}`,
-        ),
-        framePayload.buffer,
-      );
-      framePaths.push(framePath);
-    }
-
-    await writeFile(
-      path.join(absoluteDir, 'metadata.json'),
-      JSON.stringify(
-        {
-          assetId,
-          assetKey,
-          actionKey,
-          masterImagePath,
-          sheetImagePath,
-          framePaths,
-          metadata,
-          prompts,
-          createdAt: new Date().toISOString(),
-        },
-        null,
-        2,
-      ) + '\n',
-      'utf8',
-    );
-
-    sendJson(res, 200, {
-      ok: true,
-      assetId,
-      assetDir: `/${relativeDir}`,
-      masterImagePath,
-      sheetImagePath,
-      framePaths,
-      saveMessage: '已保存到 public/generated-qwen-sprites。',
-    });
-  } catch (error) {
-    sendJson(res, 500, {
-      error: {
-        message: error instanceof Error ? error.message : '保存精灵表资产失败。',
-      },
-    });
-  }
-}
-
-function toExpressHandler(
-  handler: (
-    request: IncomingMessage & { body?: unknown },
-    response: ServerResponse,
-  ) => Promise<void> | void,
-) {
-  return (request: Request, response: Response, next: NextFunction) => {
-    Promise.resolve(
-      handler(
-        request as Request & IncomingMessage & { body?: unknown },
-        response as Response & ServerResponse,
-      ),
-    ).catch(next);
-  };
-}
-
-export function createQwenSpriteRoutes(config: AppConfig) {
-  const router = Router();
-
-  router.use((request, response, next) => {
-    if (
-      request.path !== '/api/assets' &&
-      !request.path.startsWith('/api/assets/')
-    ) {
-      next();
-      return;
-    }
-
-    if (!config.assetsApiEnabled) {
-      response.status(403).json({
-        error: {
-          message: '资产工具接口当前未启用。',
-        },
-      });
-      return;
-    }
-    next();
-  });
-
-  router.use(
-    QWEN_SPRITE_MASTER_GENERATE_PATH,
-    toExpressHandler((request, response) =>
-      handleGenerateMaster(config, request, response),
-    ),
-  );
-  router.use(
-    QWEN_SPRITE_SHEET_GENERATE_PATH,
-    toExpressHandler((request, response) =>
-      handleGenerateSheet(config, request, response),
-    ),
-  );
-  router.use(
-    QWEN_SPRITE_FRAME_REPAIR_PATH,
-    toExpressHandler((request, response) =>
-      handleRepairFrame(config, request, response),
-    ),
-  );
-  router.use(
-    QWEN_SPRITE_SAVE_PATH,
-    toExpressHandler((request, response) =>
-      handleSaveAsset(config.projectRoot, request, response),
-    ),
-  );
-
-  return router;
-}
diff --git a/server-node/src/routes/runtimeRoutes.ts b/server-node/src/routes/runtimeRoutes.ts
index 75b8dc27..b67a2538 100644
--- a/server-node/src/routes/runtimeRoutes.ts
+++ b/server-node/src/routes/runtimeRoutes.ts
@@ -3,8 +3,6 @@ import { z } from 'zod';
 
 import type { ListCustomWorldWorksResponse } from '../../../packages/shared/src/contracts/customWorldAgent.js';
 import type {
-  AnswerCustomWorldSessionQuestionRequest,
-  CreateCustomWorldSessionRequest,
   CustomWorldGalleryDetailResponse,
   CustomWorldGalleryResponse,
   CustomWorldLibraryMutationResponse,
@@ -21,7 +19,6 @@ import type {
   SavedGameSnapshotInput,
 } from '../../../packages/shared/src/contracts/runtime.js';
 import {
-  CUSTOM_WORLD_GENERATION_MODES,
   PLATFORM_THEMES,
 } from '../../../packages/shared/src/contracts/runtime.js';
 import type {
@@ -41,7 +38,6 @@ import { badRequest, notFound } from '../errors.js';
 import {
   asyncHandler,
   jsonClone,
-  prepareEventStreamResponse,
   sendApiResponse,
 } from '../http.js';
 import { requireJwtAuth } from '../middleware/auth.js';
@@ -67,7 +63,6 @@ import {
   npcRecruitDialogueRequestSchema,
 } from '../services/chatService.js';
 import { generateCustomWorldEntity } from '../services/customWorldEntityGenerationService.js';
-import { generateCustomWorldProfile } from '../services/customWorldGenerationService.js';
 import { generateSceneNpcForLandmark } from '../services/customWorldSceneNpcGenerationService.js';
 import { listCustomWorldWorkSummaries } from '../services/customWorldWorkSummaryService.js';
 import { generateQuestForNpcEncounter } from '../services/questService.js';
@@ -133,17 +128,6 @@ const customWorldEntitySchema = z.object({
   kind: z.enum(['playable', 'story', 'landmark']),
 });
 
-const customWorldSessionSchema = z.object({
-  settingText: z.string().trim().min(1),
-  creatorIntent: jsonObjectSchema.nullable().optional().default(null),
-  generationMode: z.enum(CUSTOM_WORLD_GENERATION_MODES).default('fast'),
-});
-
-const customWorldAnswerSchema = z.object({
-  questionId: z.string().trim().min(1),
-  answer: z.string().trim().min(1),
-});
-
 const runtimeItemIntentSchema = z.object({
   context: jsonObjectSchema,
   plans: z.array(jsonObjectSchema),
@@ -792,128 +776,6 @@ export function createRuntimeRoutes(context: AppContext) {
     }),
   );
 
-  router.post(
-    '/runtime/custom-world/sessions',
-    routeMeta({ operation: 'runtime.customWorldSession.create' }),
-    asyncHandler(async (request, response) => {
-      const payload = customWorldSessionSchema.parse(
-        request.body,
-      ) as CreateCustomWorldSessionRequest;
-      sendApiResponse(
-        response,
-        await context.customWorldSessions.create(
-          request.userId!,
-          payload.settingText,
-          payload.creatorIntent,
-          payload.generationMode,
-        ),
-      );
-    }),
-  );
-
-  router.get(
-    '/runtime/custom-world/sessions/:sessionId',
-    routeMeta({ operation: 'runtime.customWorldSession.get' }),
-    asyncHandler(async (request, response) => {
-      const session = await context.customWorldSessions.get(
-        request.userId!,
-        readParam(request.params.sessionId),
-      );
-      if (!session) {
-        throw notFound('custom world session not found');
-      }
-      sendApiResponse(response, session);
-    }),
-  );
-
-  router.post(
-    '/runtime/custom-world/sessions/:sessionId/answers',
-    routeMeta({ operation: 'runtime.customWorldSession.answer' }),
-    asyncHandler(async (request, response) => {
-      const payload = customWorldAnswerSchema.parse(
-        request.body,
-      ) as AnswerCustomWorldSessionQuestionRequest;
-      const session = await context.customWorldSessions.answer(
-        request.userId!,
-        readParam(request.params.sessionId),
-        payload.questionId,
-        payload.answer,
-      );
-      if (!session) {
-        throw notFound('custom world session not found');
-      }
-      sendApiResponse(response, session);
-    }),
-  );
-
-  router.get(
-    '/runtime/custom-world/sessions/:sessionId/generate/stream',
-    routeMeta({ operation: 'runtime.customWorldSession.generateStream' }),
-    asyncHandler(async (request, response) => {
-      const session = await context.customWorldSessions.get(
-        request.userId!,
-        readParam(request.params.sessionId),
-      );
-      if (!session) {
-        throw notFound('custom world session not found');
-      }
-
-      prepareEventStreamResponse(request, response);
-      const controller = new AbortController();
-
-      request.on('close', () => {
-        controller.abort();
-      });
-
-      const writeEvent = (event: string, payload: Record<string, unknown>) => {
-        response.write(`event: ${event}\n`);
-        response.write(`data: ${JSON.stringify(payload)}\n\n`);
-      };
-
-      writeEvent('progress', { phase: 'preparing', progress: 10 });
-      await context.customWorldSessions.updateStatus(
-        request.userId!,
-        readParam(request.params.sessionId),
-        'generating',
-      );
-      writeEvent('progress', { phase: 'requesting_llm', progress: 45 });
-
-      try {
-        const profile = await generateCustomWorldProfile(context, session, {
-          signal: controller.signal,
-          onProgress: (progress) => {
-            writeEvent(
-              'progress',
-              progress as unknown as Record<string, unknown>,
-            );
-          },
-        });
-        await context.customWorldSessions.setResult(
-          request.userId!,
-          readParam(request.params.sessionId),
-          profile,
-        );
-        writeEvent('progress', { phase: 'completed', progress: 100 });
-        writeEvent('result', { profile });
-        writeEvent('done', { ok: true });
-      } catch (error) {
-        const message =
-          error instanceof Error
-            ? error.message
-            : 'custom world generation failed';
-        await context.customWorldSessions.updateStatus(
-          request.userId!,
-          readParam(request.params.sessionId),
-          'generation_error',
-          message,
-        );
-        writeEvent('error', { message });
-      } finally {
-        response.end();
-      }
-    }),
-  );
-
   router.post(
     '/runtime/items/runtime-intent',
     routeMeta({ operation: 'runtime.items.intent' }),
diff --git a/server-node/src/server.ts b/server-node/src/server.ts
index 3c303014..813da85a 100644
--- a/server-node/src/server.ts
+++ b/server-node/src/server.ts
@@ -16,7 +16,6 @@ import { CaptchaChallengeStore } from './services/captchaChallengeStore.js';
 import { CustomWorldAgentAutoAssetService } from './services/customWorldAgentAutoAssetService.js';
 import { CustomWorldAgentOrchestrator } from './services/customWorldAgentOrchestrator.js';
 import { CustomWorldAgentSessionStore } from './services/customWorldAgentSessionStore.js';
-import { CustomWorldSessionStore } from './services/customWorldSessionStore.js';
 import { UpstreamLlmClient } from './services/llmClient.js';
 import { createSmsVerificationService } from './services/smsVerificationService.js';
 import { createWechatAuthService } from './services/wechatAuthService.js';
@@ -113,7 +112,6 @@ export async function createAppContext(config: AppConfig = loadConfig()) {
     userSessionRepository: new UserSessionRepository(db),
     runtimeRepository,
     llmClient: new UpstreamLlmClient(config, logger),
-    customWorldSessions: new CustomWorldSessionStore(runtimeRepository),
     customWorldAgentSessions,
     customWorldAgentOrchestrator: new CustomWorldAgentOrchestrator(
       customWorldAgentSessions,
diff --git a/server-node/src/services/customWorldGenerationService.ts b/server-node/src/services/customWorldGenerationService.ts
deleted file mode 100644
index 0a657318..00000000
--- a/server-node/src/services/customWorldGenerationService.ts
+++ /dev/null
@@ -1,33 +0,0 @@
-import type { AppContext } from '../context.js';
-import {
-  type CustomWorldGenerationProgress,
-  generateCustomWorldProfileFromOrchestrator,
-  type GenerateCustomWorldProfileInput,
-} from '../modules/ai/customWorldOrchestrator.js';
-import type { CustomWorldSession } from './customWorldSessionStore.js';
-
-export async function generateCustomWorldProfile(
-  context: AppContext,
-  session: CustomWorldSession,
-  options: {
-    onProgress?: (progress: CustomWorldGenerationProgress) => void;
-    signal?: AbortSignal;
-  } = {},
-) {
-  const input = {
-    settingText: session.settingText,
-    creatorIntent: session.creatorIntent,
-    generationMode: session.generationMode,
-  } satisfies GenerateCustomWorldProfileInput;
-
-  const profile = await generateCustomWorldProfileFromOrchestrator(
-    context.llmClient,
-    input,
-    {
-      onProgress: options.onProgress,
-      signal: options.signal,
-    },
-  );
-
-  return JSON.parse(JSON.stringify(profile)) as Record<string, unknown>;
-}
diff --git a/server-node/src/services/customWorldSessionStore.ts b/server-node/src/services/customWorldSessionStore.ts
deleted file mode 100644
index 6fb99c6a..00000000
--- a/server-node/src/services/customWorldSessionStore.ts
+++ /dev/null
@@ -1,229 +0,0 @@
-import crypto from 'node:crypto';
-
-import type { JsonObject } from '../../../packages/shared/src/contracts/common.js';
-import type {
-  CustomWorldGenerationMode,
-  CustomWorldQuestion,
-  CustomWorldSessionRecord,
-  CustomWorldSessionStatus,
-} from '../../../packages/shared/src/contracts/runtime.js';
-import type { RuntimeRepositoryPort } from '../repositories/runtimeRepository.js';
-
-export type CustomWorldSession = {
-  sessionId: string;
-  status: CustomWorldSessionStatus;
-  settingText: string;
-  creatorIntent: JsonObject | null;
-  generationMode: CustomWorldGenerationMode;
-  questions: CustomWorldQuestion[];
-  result?: JsonObject;
-  lastError?: string;
-  createdAt: string;
-  updatedAt: string;
-};
-
-function cloneSession(session: CustomWorldSession) {
-  return JSON.parse(JSON.stringify(session)) as CustomWorldSession;
-}
-
-function toSessionRecord(session: CustomWorldSession): CustomWorldSessionRecord {
-  return {
-    sessionId: session.sessionId,
-    status: session.status,
-    settingText: session.settingText,
-    creatorIntent: session.creatorIntent,
-    generationMode: session.generationMode,
-    questions: session.questions,
-    result: session.result,
-    lastError: session.lastError,
-    createdAt: session.createdAt,
-    updatedAt: session.updatedAt,
-  };
-}
-
-function toSession(record: CustomWorldSessionRecord) {
-  return cloneSession({
-    sessionId: record.sessionId,
-    status: record.status,
-    settingText: record.settingText,
-    creatorIntent: record.creatorIntent ?? null,
-    generationMode: record.generationMode,
-    questions: record.questions,
-    result: record.result,
-    lastError: record.lastError,
-    createdAt: record.createdAt,
-    updatedAt: record.updatedAt,
-  });
-}
-
-function hasPendingQuestion(questions: CustomWorldQuestion[]) {
-  return questions.some((question) => !question.answer?.trim());
-}
-
-function buildClarificationQuestions(
-  settingText: string,
-  creatorIntent: JsonObject | null,
-) {
-  const questions: CustomWorldQuestion[] = [];
-  const worldHook =
-    typeof creatorIntent?.worldHook === 'string' ? creatorIntent.worldHook.trim() : '';
-  const playerPremise =
-    typeof creatorIntent?.playerPremise === 'string' ? creatorIntent.playerPremise.trim() : '';
-  const openingSituation =
-    typeof creatorIntent?.openingSituation === 'string'
-      ? creatorIntent.openingSituation.trim()
-      : '';
-  const coreConflicts = Array.isArray(creatorIntent?.coreConflicts)
-    ? creatorIntent.coreConflicts
-    : [];
-
-  if (!worldHook && settingText.trim().length < 24) {
-    questions.push({
-      id: 'world_hook',
-      label: '世界核心',
-      question: '请用一句话补充这个世界最核心的命题或独特卖点。',
-    });
-  }
-  if (!playerPremise) {
-    questions.push({
-      id: 'player_premise',
-      label: '玩家身份',
-      question: '玩家在这个世界里是什么身份、立场或来历？',
-    });
-  }
-  if (!openingSituation) {
-    questions.push({
-      id: 'opening_situation',
-      label: '开局处境',
-      question: '故事开局时，玩家正处于什么局面？',
-    });
-  }
-  if (coreConflicts.length === 0) {
-    questions.push({
-      id: 'core_conflict',
-      label: '核心冲突',
-      question: '这个世界当前最核心的冲突、危机或悬念是什么？',
-    });
-  }
-
-  return questions;
-}
-
-export class CustomWorldSessionStore {
-  constructor(
-    private readonly runtimeRepository: RuntimeRepositoryPort,
-  ) {}
-
-  async create(
-    userId: string,
-    settingText: string,
-    creatorIntent: JsonObject | null,
-    generationMode: CustomWorldGenerationMode,
-  ) {
-    const sessionId = `custom-world-session-${crypto.randomBytes(16).toString('hex')}`;
-    const now = new Date().toISOString();
-    const session: CustomWorldSession = {
-      sessionId,
-      status: 'ready_to_generate',
-      settingText,
-      creatorIntent,
-      generationMode,
-      questions: buildClarificationQuestions(settingText, creatorIntent),
-      createdAt: now,
-      updatedAt: now,
-    };
-
-    if (hasPendingQuestion(session.questions)) {
-      session.status = 'clarifying';
-    }
-
-    await this.runtimeRepository.upsertCustomWorldSession(
-      userId,
-      sessionId,
-      toSessionRecord(session),
-    );
-    return cloneSession(session);
-  }
-
-  async list(userId: string) {
-    const sessions = await this.runtimeRepository.listCustomWorldSessions(userId);
-    return sessions.map((session) => toSession(session));
-  }
-
-  async get(userId: string, sessionId: string) {
-    const session = await this.runtimeRepository.getCustomWorldSession(
-      userId,
-      sessionId,
-    );
-    return session ? toSession(session) : null;
-  }
-
-  async answer(
-    userId: string,
-    sessionId: string,
-    questionId: string,
-    answer: string,
-  ) {
-    const session = await this.get(userId, sessionId);
-    if (!session) {
-      return null;
-    }
-
-    const question = session.questions.find((item) => item.id === questionId);
-    if (!question) {
-      return null;
-    }
-
-    question.answer = answer;
-    session.status = hasPendingQuestion(session.questions)
-      ? 'clarifying'
-      : 'ready_to_generate';
-    session.updatedAt = new Date().toISOString();
-    await this.runtimeRepository.upsertCustomWorldSession(
-      userId,
-      sessionId,
-      toSessionRecord(session),
-    );
-    return cloneSession(session);
-  }
-
-  async updateStatus(
-    userId: string,
-    sessionId: string,
-    status: CustomWorldSessionStatus,
-    lastError = '',
-  ) {
-    const session = await this.get(userId, sessionId);
-    if (!session) {
-      return null;
-    }
-
-    session.status = status;
-    session.lastError = lastError || undefined;
-    session.updatedAt = new Date().toISOString();
-    await this.runtimeRepository.upsertCustomWorldSession(
-      userId,
-      sessionId,
-      toSessionRecord(session),
-    );
-    return cloneSession(session);
-  }
-
-  async setResult(userId: string, sessionId: string, result: JsonObject) {
-    const session = await this.get(userId, sessionId);
-    if (!session) {
-      return null;
-    }
-
-    session.status = 'completed';
-    session.lastError = undefined;
-    session.result = JSON.parse(JSON.stringify(result)) as JsonObject;
-    session.updatedAt = new Date().toISOString();
-    await this.runtimeRepository.upsertCustomWorldSession(
-      userId,
-      sessionId,
-      toSessionRecord(session),
-    );
-    return cloneSession(session);
-  }
-}
diff --git a/src/components/GameShell.tsx b/src/components/GameShell.tsx
deleted file mode 100644
index 8837b85f..00000000
--- a/src/components/GameShell.tsx
+++ /dev/null
@@ -1,807 +0,0 @@
-import {AnimatePresence, motion} from 'motion/react';
-import {lazy, Suspense, useCallback, useEffect, useMemo, useState} from 'react';
-
-import {getLiveGamePlayTimeMs} from '../data/runtimeStats';
-import type { HydratedSavedGameSnapshot } from '../persistence/runtimeSnapshotTypes';
-import {getWorldCampScenePreset} from '../data/scenePresets';
-import {BottomTab} from '../hooks/useGameFlow';
-import {resolveActiveSceneActBlueprint} from '../services/customWorldSceneActRuntime';
-import {
-  type BattleRewardUi,
-  type CharacterChatUi,
-  type GoalFlowUi,
-  type InventoryFlowUi,
-  type NpcChatQuestOfferUi,
-  type QuestFlowUi,
-  type StoryGenerationNpcUi,
-} from '../hooks/useStoryGeneration';
-import {
-  type Character,
-  type CustomWorldProfile,
-  type CompanionRenderState,
-  type GameState,
-  type StoryMoment,
-  type StoryOption,
-} from '../types';
-import {CHROME_ICONS, getNineSliceStyle, TAB_ICONS, UI_CHROME} from '../uiAssets';
-import {CharacterSelectionFlow} from './game-shell/CharacterSelectionFlow';
-import {PreGameSelectionFlow} from './game-shell/PreGameSelectionFlow';
-import {SCENE_TRANSITION_FUNCTION_MODES, useSceneTransitionModel} from './game-shell/useSceneTransitionModel';
-import {useGameShellViewModel} from './game-shell/useGameShellViewModel';
-import {GameCanvas} from './GameCanvas';
-import {PixelIcon} from './PixelIcon';
-
-interface GameShellSessionProps {
-  gameState: GameState;
-  currentStory: StoryMoment | null;
-  isLoading: boolean;
-  aiError: string | null;
-  bottomTab: BottomTab;
-  setBottomTab: (tab: BottomTab) => void;
-  isMapOpen: boolean;
-  setIsMapOpen: (open: boolean) => void;
-}
-
-interface GameShellStoryProps {
-  displayedOptions: StoryOption[];
-  canRefreshOptions: boolean;
-  handleRefreshOptions: () => void;
-  handleChoice: (option: StoryOption) => void;
-  handleNpcChatInput: (input: string) => boolean;
-  exitNpcChat: () => boolean;
-  handleMapTravelToScene: (sceneId: string) => boolean;
-  npcUi: StoryGenerationNpcUi;
-  characterChatUi: CharacterChatUi;
-  inventoryUi: InventoryFlowUi;
-  battleRewardUi: BattleRewardUi;
-  questUi: QuestFlowUi;
-  npcChatQuestOfferUi: NpcChatQuestOfferUi;
-  goalUi: GoalFlowUi;
-}
-
-interface GameShellEntryProps {
-  hasSavedGame: boolean;
-  savedSnapshot: HydratedSavedGameSnapshot | null;
-  handleContinueGame: (snapshot?: HydratedSavedGameSnapshot | null) => void;
-  handleStartNewGame: () => void;
-  handleSaveAndExit: () => void;
-  handleCustomWorldSelect: (customWorldProfile: CustomWorldProfile) => void;
-  handleBackToWorldSelect: () => void;
-  handleCharacterSelect: (character: Character) => void;
-}
-
-interface GameShellCompanionProps {
-  companionRenderStates: CompanionRenderState[];
-  buildCompanionRenderStates: (state: GameState) => CompanionRenderState[];
-  onBenchCompanion: (npcId: string) => void;
-  onActivateRosterCompanion: (npcId: string, swapNpcId?: string | null) => void;
-}
-
-interface GameShellAudioProps {
-  musicVolume: number;
-  onMusicVolumeChange: (value: number) => void;
-}
-
-interface GameShellProps {
-  session: GameShellSessionProps;
-  story: GameShellStoryProps;
-  entry: GameShellEntryProps;
-  companions: GameShellCompanionProps;
-  audio: GameShellAudioProps;
-}
-
-const AdventureEntityModal = lazy(async () => {
-  const module = await import('./AdventureEntityModal');
-
-  return {
-    default: module.AdventureEntityModal,
-  };
-});
-
-const CharacterChatModal = lazy(async () => {
-  const module = await import('./CharacterChatModal');
-
-  return {
-    default: module.CharacterChatModal,
-  };
-});
-
-const CompanionCampModal = lazy(async () => {
-  const module = await import('./CompanionCampModal');
-
-  return {
-    default: module.CompanionCampModal,
-  };
-});
-
-const MapModal = lazy(async () => {
-  const module = await import('./MapModal');
-
-  return {
-    default: module.MapModal,
-  };
-});
-
-const NpcModals = lazy(async () => {
-  const module = await import('./NpcModals');
-
-  return {
-    default: module.NpcModals,
-  };
-});
-
-const AdventurePanel = lazy(async () => {
-  const module = await import('./AdventurePanel');
-
-  return {
-    default: module.AdventurePanel,
-  };
-});
-
-const CharacterPanel = lazy(async () => {
-  const module = await import('./CharacterPanel');
-
-  return {
-    default: module.CharacterPanel,
-  };
-});
-
-const InventoryPanel = lazy(async () => {
-  const module = await import('./InventoryPanel');
-
-  return {
-    default: module.InventoryPanel,
-  };
-});
-
-function ModalLoadingFallback({
-  label,
-  onClose,
-}: {
-  label: string;
-  onClose?: (() => void) | null;
-}) {
-  return (
-    <div
-      className="fixed inset-0 z-[90] flex items-center justify-center bg-black/70 p-4 backdrop-blur-sm"
-      onClick={onClose ?? undefined}
-    >
-      <div
-        className="pixel-nine-slice pixel-modal-shell flex min-h-40 w-full max-w-md items-center justify-center px-6 py-8 text-center text-sm text-zinc-300 shadow-[0_24px_80px_rgba(0,0,0,0.55)]"
-        style={getNineSliceStyle(UI_CHROME.modalPanel)}
-        onClick={event => event.stopPropagation()}
-      >
-        {label}
-      </div>
-    </div>
-  );
-}
-
-function PanelLoadingFallback({
-  label,
-}: {
-  label: string;
-}) {
-  return (
-    <div className="pixel-nine-slice flex min-h-0 flex-1 items-center justify-center px-4 py-6 text-center text-xs uppercase tracking-[0.24em] text-zinc-500" style={getNineSliceStyle(UI_CHROME.modalPanel)}>
-      {label}
-    </div>
-  );
-}
-
-export function GameShell({session, story, entry, companions, audio}: GameShellProps) {
-  const {
-    gameState,
-    currentStory,
-    isLoading,
-    aiError,
-    bottomTab,
-    setBottomTab,
-    isMapOpen,
-    setIsMapOpen,
-  } = session;
-  const {
-    displayedOptions,
-    canRefreshOptions,
-    handleRefreshOptions,
-    handleChoice,
-    handleNpcChatInput,
-    exitNpcChat,
-    handleMapTravelToScene,
-    npcUi,
-    characterChatUi,
-    inventoryUi,
-    battleRewardUi,
-    questUi,
-    npcChatQuestOfferUi,
-    goalUi,
-  } = story;
-  const {
-    hasSavedGame,
-    savedSnapshot,
-    handleContinueGame,
-    handleStartNewGame,
-    handleSaveAndExit,
-    handleCustomWorldSelect,
-    handleBackToWorldSelect,
-    handleCharacterSelect,
-  } = entry;
-  const {
-    companionRenderStates,
-    buildCompanionRenderStates,
-    onBenchCompanion,
-    onActivateRosterCompanion,
-  } = companions;
-  const {musicVolume, onMusicVolumeChange} = audio;
-
-  const [clockNow, setClockNow] = useState(() => Date.now());
-  const openingCampSceneId = useMemo(
-    () => (gameState.worldType ? getWorldCampScenePreset(gameState.worldType)?.id ?? null : null),
-    [gameState.worldType],
-  );
-  const hasNpcModalOpen = Boolean(npcUi.tradeModal || npcUi.giftModal || npcUi.recruitModal);
-  const {
-    selectionStage,
-    setSelectionStage,
-    overlayPanel,
-    openOverlayPanel,
-    closeOverlayPanel,
-    selectedSceneEntity,
-    setSelectedSceneEntity,
-    openPartyMemberDetails,
-    closeAdventureEntityModal,
-    showTeamModal,
-    openCampModal,
-    closeCampModal,
-    resetForSaveAndExit,
-    shouldMountAdventureEntityModal,
-    shouldMountCampModal,
-    shouldMountMapModal,
-    shouldMountCharacterChatModal,
-    shouldMountNpcModals,
-  } = useGameShellViewModel({
-    gameState,
-    isMapOpen,
-    characterChatModalOpen: Boolean(characterChatUi.modal),
-    hasNpcModalOpen,
-  });
-  const {
-    visibleGameState,
-    visibleCurrentStory,
-    sceneTransitionPhase,
-    sceneTransitionToken,
-    setSceneTransitionDurations,
-    beginSceneTransition,
-  } = useSceneTransitionModel({
-    gameState,
-    currentStory,
-    openingCampSceneId,
-  });
-  const isCharacterSelectionStage =
-    gameState.currentScene === 'Selection' &&
-    Boolean(gameState.worldType) &&
-    !gameState.playerCharacter;
-  const collapseTopStage = gameState.currentScene === 'Selection';
-  const shouldHideStoryOptions = sceneTransitionPhase !== 'idle';
-  const visibleStoryForRender = visibleCurrentStory;
-
-  const dialogueIndicator = useMemo(() => {
-    if (!isLoading || visibleCurrentStory?.displayMode !== 'dialogue' || visibleGameState.currentEncounter?.kind !== 'npc') {
-      return null;
-    }
-
-    const lastSpeaker = visibleCurrentStory.dialogue?.[visibleCurrentStory.dialogue.length - 1]?.speaker ?? null;
-    return {
-      showPlayer: true,
-      showEncounter: true,
-      activeSpeaker: lastSpeaker === 'player' ? 'player' : lastSpeaker ? 'npc' : null,
-    } as const;
-  }, [visibleCurrentStory?.dialogue, visibleCurrentStory?.displayMode, visibleGameState.currentEncounter?.kind, isLoading]);
-
-  const characterChatSummaries = useMemo(
-    () =>
-      Object.fromEntries(
-        Object.entries(gameState.characterChats ?? {}).map(([characterId, record]) => [characterId, record.summary]),
-      ),
-    [gameState.characterChats],
-  );
-
-  const visibleCompanionRenderStates = useMemo(
-    () => buildCompanionRenderStates(visibleGameState),
-    [buildCompanionRenderStates, visibleGameState],
-  );
-
-  const canvasCompanionRenderStates = useMemo(() => {
-    const activeEncounterNpcId = visibleGameState.currentEncounter?.kind === 'npc'
-      ? visibleGameState.currentEncounter.id ?? null
-      : null;
-    if (!activeEncounterNpcId) return visibleCompanionRenderStates;
-    return visibleCompanionRenderStates.filter(companion => companion.npcId !== activeEncounterNpcId);
-  }, [visibleCompanionRenderStates, visibleGameState.currentEncounter]);
-
-  const livePlayTimeMs = useMemo(
-    () => getLiveGamePlayTimeMs(gameState.runtimeStats, clockNow),
-    [clockNow, gameState.runtimeStats],
-  );
-  const activeSceneAct = useMemo(
-    () => resolveActiveSceneActBlueprint({
-      profile: visibleGameState.customWorldProfile,
-      sceneId: visibleGameState.currentScenePreset?.id ?? null,
-      storyEngineMemory: visibleGameState.storyEngineMemory,
-    }),
-    [
-      visibleGameState.currentScenePreset?.id,
-      visibleGameState.customWorldProfile,
-      visibleGameState.storyEngineMemory,
-    ],
-  );
-  const activeSceneChapter = useMemo(() => {
-    if (!visibleGameState.customWorldProfile || !visibleGameState.currentScenePreset?.id) {
-      return null;
-    }
-
-    return (
-      visibleGameState.customWorldProfile.sceneChapterBlueprints?.find(
-        entry => entry.sceneId === visibleGameState.currentScenePreset?.id
-          || entry.linkedLandmarkIds.includes(visibleGameState.currentScenePreset?.id ?? ''),
-      ) ?? null
-    );
-  }, [
-    visibleGameState.currentScenePreset?.id,
-    visibleGameState.customWorldProfile,
-  ]);
-
-  const adventureStatistics = useMemo(
-    () => ({
-      playTimeMs: livePlayTimeMs,
-      hostileNpcsDefeated: gameState.runtimeStats.hostileNpcsDefeated,
-      questsAccepted: gameState.runtimeStats.questsAccepted,
-      questsCompleted: visibleGameState.quests.filter(quest => quest.status === 'completed' || quest.status === 'turned_in').length,
-      questsTurnedIn: visibleGameState.quests.filter(quest => quest.status === 'turned_in').length,
-      itemsUsed: gameState.runtimeStats.itemsUsed,
-      scenesTraveled: gameState.runtimeStats.scenesTraveled,
-      currentSceneName: visibleGameState.currentScenePreset?.name ?? 'Current Area',
-      playerCurrency: visibleGameState.playerCurrency,
-      inventoryItemCount: visibleGameState.playerInventory.reduce((sum, item) => sum + item.quantity, 0),
-      inventoryStackCount: visibleGameState.playerInventory.length,
-      activeCompanionCount: visibleGameState.companions.length,
-      rosterCompanionCount: visibleGameState.roster.length,
-    }),
-    [
-      gameState.runtimeStats.itemsUsed,
-      gameState.runtimeStats.hostileNpcsDefeated,
-      gameState.runtimeStats.questsAccepted,
-      gameState.runtimeStats.scenesTraveled,
-      livePlayTimeMs,
-      visibleGameState.companions.length,
-      visibleGameState.currentScenePreset?.name,
-      visibleGameState.playerCurrency,
-      visibleGameState.playerInventory,
-      visibleGameState.quests,
-      visibleGameState.roster.length,
-    ],
-  );
-
-  useEffect(() => {
-    if (!gameState.playerCharacter || gameState.currentScene !== 'Story') {
-      return;
-    }
-
-    setClockNow(Date.now());
-    const intervalId = window.setInterval(() => setClockNow(Date.now()), 1000);
-    return () => window.clearInterval(intervalId);
-  }, [gameState.currentScene, gameState.playerCharacter]);
-
-  const handleSceneTransitionChoice = useCallback((option: StoryOption) => {
-    const transitionMode = SCENE_TRANSITION_FUNCTION_MODES[option.functionId];
-    if (transitionMode) {
-      beginSceneTransition(transitionMode);
-    }
-    handleChoice(option);
-  }, [beginSceneTransition, handleChoice]);
-
-  return (
-    <div
-      className="fusion-pixel-app pixel-root-shell flex h-screen max-h-screen flex-col overflow-hidden font-sans text-zinc-100"
-      style={{
-        backgroundImage: `linear-gradient(rgba(8, 10, 14, 0.82), rgba(8, 10, 14, 0.82)), url("${UI_CHROME.appBackground}")`,
-        backgroundPosition: 'center',
-        backgroundRepeat: 'repeat',
-      }}
-    >
-      <div className={`relative ${collapseTopStage ? 'h-0 border-b-0' : 'h-[36%] border-b border-white/5'}`}>
-        {collapseTopStage ? null : (
-          <GameCanvas
-            scrollWorld={visibleGameState.scrollWorld}
-            animationState={visibleGameState.animationState}
-            playerCharacter={visibleGameState.playerCharacter}
-            encounter={visibleGameState.currentEncounter}
-            currentScenePreset={visibleGameState.currentScenePreset}
-            worldType={visibleGameState.worldType}
-            sceneHostileNpcs={visibleGameState.sceneHostileNpcs}
-            playerX={visibleGameState.playerX}
-            playerOffsetY={visibleGameState.playerOffsetY}
-            playerFacing={visibleGameState.playerFacing}
-            playerActionMode={visibleGameState.playerActionMode}
-            inBattle={visibleGameState.inBattle}
-            playerHp={visibleGameState.playerHp}
-            playerMaxHp={visibleGameState.playerMaxHp}
-            playerMana={visibleGameState.playerMana}
-            playerMaxMana={visibleGameState.playerMaxMana}
-            activeCombatEffects={visibleGameState.activeCombatEffects}
-            companions={canvasCompanionRenderStates}
-            npcStates={visibleGameState.npcStates}
-            dialogueIndicator={dialogueIndicator}
-            npcAffinityEffect={visibleStoryForRender?.npcAffinityEffect ?? null}
-            onEntitySelect={setSelectedSceneEntity}
-            onSceneNameClick={() => setIsMapOpen(true)}
-            sceneTransitionPhase={sceneTransitionPhase}
-            sceneTransitionToken={sceneTransitionToken}
-            onSceneTransitionDurationsChange={setSceneTransitionDurations}
-          />
-        )}
-      </div>
-
-      <div
-        className={`pixel-app-shell flex min-h-0 flex-1 flex-col ${isCharacterSelectionStage ? 'justify-center p-4 sm:p-5' : 'p-3 sm:p-4'}`}
-        style={{
-          backgroundColor: isCharacterSelectionStage ? '#0d1016' : undefined,
-          backgroundImage: isCharacterSelectionStage
-            ? undefined
-            : `linear-gradient(rgba(10, 12, 18, 0.55), rgba(10, 12, 18, 0.55)), url("${UI_CHROME.appBackground}")`,
-          backgroundPosition: isCharacterSelectionStage ? undefined : 'center',
-          backgroundRepeat: isCharacterSelectionStage ? undefined : 'repeat',
-        }}
-      >
-        <AnimatePresence mode="wait">
-          {!gameState.worldType && (
-            <PreGameSelectionFlow
-              selectionStage={selectionStage}
-              setSelectionStage={setSelectionStage}
-              gameState={gameState}
-              hasSavedGame={hasSavedGame}
-              savedSnapshot={savedSnapshot}
-              handleContinueGame={handleContinueGame}
-              handleStartNewGame={handleStartNewGame}
-              handleCustomWorldSelect={handleCustomWorldSelect}
-            />
-          )}
-
-          {gameState.worldType && !gameState.playerCharacter && (
-            <motion.div
-              key="character-select-shell"
-              initial={{opacity: 0, y: 12}}
-              animate={{opacity: 1, y: 0}}
-              exit={{opacity: 0, y: -12}}
-              className="flex h-full min-h-0 flex-col"
-            >
-              <CharacterSelectionFlow
-                worldType={gameState.worldType}
-                customWorldProfile={gameState.customWorldProfile}
-                onBack={() => {
-                  handleBackToWorldSelect();
-                  setSelectionStage('platform');
-                }}
-                onConfirm={handleCharacterSelect}
-              />
-            </motion.div>
-          )}
-
-          {visibleGameState.playerCharacter && visibleStoryForRender && (
-            <motion.div key="story-flow" initial={{opacity: 0}} animate={{opacity: 1}} className="flex h-full min-h-0 flex-col">
-              <div className="story-top-tabs mb-3 grid grid-cols-3 gap-2 sm:gap-3">
-                <button
-                  onClick={() => setBottomTab('character')}
-                  className={`pixel-nine-slice pixel-pressable pixel-tab-button ${bottomTab === 'character' ? 'pixel-tab-button--active text-white' : 'text-zinc-300'}`}
-                  style={getNineSliceStyle(bottomTab === 'character' ? UI_CHROME.tabActive : UI_CHROME.tabInactive, {paddingX: 10, paddingY: 8})}
-                >
-                  <span className="pixel-tab-button__inner">
-                    <PixelIcon
-                      src={bottomTab === 'character' ? TAB_ICONS.character.active : TAB_ICONS.character.inactive}
-                      className={`pixel-tab-button__icon ${bottomTab === 'character' ? 'opacity-100' : 'opacity-70'}`}
-                    />
-                    <span className="pixel-tab-button__label">队伍</span>
-                  </span>
-                </button>
-                <button
-                  onClick={() => setBottomTab('adventure')}
-                  className={`pixel-nine-slice pixel-pressable pixel-tab-button ${bottomTab === 'adventure' ? 'pixel-tab-button--active text-white' : 'text-zinc-300'}`}
-                  style={getNineSliceStyle(bottomTab === 'adventure' ? UI_CHROME.tabActive : UI_CHROME.tabInactive, {paddingX: 10, paddingY: 8})}
-                >
-                  <span className="pixel-tab-button__inner">
-                    <PixelIcon
-                      src={bottomTab === 'adventure' ? TAB_ICONS.adventure.active : TAB_ICONS.adventure.inactive}
-                      className={`pixel-tab-button__icon ${bottomTab === 'adventure' ? 'opacity-100' : 'opacity-70'}`}
-                    />
-                    <span className="pixel-tab-button__label">冒险</span>
-                  </span>
-                </button>
-                <button
-                  onClick={() => setBottomTab('inventory')}
-                  className={`pixel-nine-slice pixel-pressable pixel-tab-button ${bottomTab === 'inventory' ? 'pixel-tab-button--active text-white' : 'text-zinc-300'}`}
-                  style={getNineSliceStyle(bottomTab === 'inventory' ? UI_CHROME.tabActive : UI_CHROME.tabInactive, {paddingX: 10, paddingY: 8})}
-                >
-                  <span className="pixel-tab-button__inner">
-                    <PixelIcon
-                      src={bottomTab === 'inventory' ? TAB_ICONS.inventory.active : TAB_ICONS.inventory.inactive}
-                      className={`pixel-tab-button__icon ${bottomTab === 'inventory' ? 'opacity-100' : 'opacity-70'}`}
-                    />
-                    <span className="pixel-tab-button__label">背包</span>
-                  </span>
-                </button>
-              </div>
-
-              {bottomTab === 'character' && (
-                <Suspense fallback={<PanelLoadingFallback label="正在加载队伍面板" />}>
-                  <CharacterPanel
-                    worldType={visibleGameState.worldType}
-                    customWorldProfile={visibleGameState.customWorldProfile}
-                    playerCharacter={visibleGameState.playerCharacter}
-                    playerHp={visibleGameState.playerHp}
-                    playerMaxHp={visibleGameState.playerMaxHp}
-                    playerMana={visibleGameState.playerMana}
-                    playerMaxMana={visibleGameState.playerMaxMana}
-                    playerEquipment={visibleGameState.playerEquipment}
-                    activeBuildBuffs={visibleGameState.activeBuildBuffs}
-                    companionRenderStates={companionRenderStates}
-                    npcStates={visibleGameState.npcStates}
-                    quests={visibleGameState.quests}
-                    companionArcStates={
-                      visibleGameState.storyEngineMemory?.companionArcStates ?? []
-                    }
-                    companionResolutions={
-                      visibleGameState.storyEngineMemory?.companionResolutions ?? []
-                    }
-                    onOpenCamp={openCampModal}
-                    onOpenCharacterChat={characterChatUi.openChat}
-                    chatSummaries={characterChatSummaries}
-                    onInspectMember={openPartyMemberDetails}
-                  />
-                </Suspense>
-              )}
-
-              {bottomTab === 'adventure' && (
-                <Suspense fallback={<PanelLoadingFallback label="正在加载冒险面板" />}>
-                  <AdventurePanel
-                    aiError={aiError}
-                    currentStory={visibleStoryForRender}
-                    isLoading={isLoading}
-                    displayedOptions={displayedOptions}
-                    hideOptions={shouldHideStoryOptions}
-                    canRefreshOptions={canRefreshOptions}
-                    onRefreshOptions={handleRefreshOptions}
-                    onChoice={handleSceneTransitionChoice}
-                    onSubmitNpcChatInput={handleNpcChatInput}
-                    onExitNpcChat={exitNpcChat}
-                    onOpenCharacter={() => openOverlayPanel('character')}
-                    onOpenInventory={() => openOverlayPanel('inventory')}
-                    playerCharacter={visibleGameState.playerCharacter}
-                    worldType={visibleGameState.worldType}
-                    quests={visibleGameState.quests}
-                    questUi={questUi}
-                    npcChatQuestOfferUi={npcChatQuestOfferUi}
-                    goalStack={goalUi.goalStack}
-                    goalPulse={goalUi.pulse}
-                    onDismissGoalPulse={goalUi.dismissPulse}
-                    battleRewardUi={battleRewardUi}
-                    playerHp={visibleGameState.playerHp}
-                    playerMaxHp={visibleGameState.playerMaxHp}
-                    playerMana={visibleGameState.playerMana}
-                    playerMaxMana={visibleGameState.playerMaxMana}
-                    playerSkillCooldowns={visibleGameState.playerSkillCooldowns}
-                    inBattle={visibleGameState.inBattle}
-                    currentNpcBattleMode={visibleGameState.currentNpcBattleMode}
-                    chapterState={visibleGameState.chapterState ?? null}
-                    journeyBeat={
-                      visibleGameState.storyEngineMemory?.currentJourneyBeat ?? null
-                    }
-                    currentSceneActTitle={activeSceneAct?.title ?? null}
-                    currentSceneActIndex={
-                      activeSceneChapter && activeSceneAct
-                        ? (() => {
-                            const actIndex = activeSceneChapter.acts.findIndex(
-                              act => act.id === activeSceneAct.id,
-                            );
-                            return actIndex >= 0 ? actIndex + 1 : null;
-                          })()
-                        : null
-                    }
-                    currentSceneActCount={activeSceneChapter?.acts.length ?? null}
-                    statistics={adventureStatistics}
-                    musicVolume={musicVolume}
-                    onMusicVolumeChange={onMusicVolumeChange}
-                    onSaveAndExit={() => {
-                      resetForSaveAndExit();
-                      handleSaveAndExit();
-                    }}
-                  />
-                </Suspense>
-              )}
-
-              {bottomTab === 'inventory' && (
-                <Suspense fallback={<PanelLoadingFallback label="正在加载背包面板" />}>
-                  <InventoryPanel
-                    playerCharacter={visibleGameState.playerCharacter}
-                    worldType={visibleGameState.worldType}
-                    playerInventory={visibleGameState.playerInventory}
-                    playerCurrency={visibleGameState.playerCurrency}
-                    playerHp={visibleGameState.playerHp}
-                    playerMaxHp={visibleGameState.playerMaxHp}
-                    playerMana={visibleGameState.playerMana}
-                    playerMaxMana={visibleGameState.playerMaxMana}
-                    inBattle={visibleGameState.inBattle}
-                    onUseItem={inventoryUi.useInventoryItem}
-                    onEquipItem={inventoryUi.equipInventoryItem}
-                    forgeRecipes={inventoryUi.forgeRecipes}
-                    onCraftRecipe={inventoryUi.craftRecipe}
-                    onDismantleItem={inventoryUi.dismantleItem}
-                    onReforgeItem={inventoryUi.reforgeItem}
-                    continueGameDigest={
-                      visibleGameState.storyEngineMemory?.continueGameDigest ?? null
-                    }
-                    narrativeCodex={
-                      visibleGameState.storyEngineMemory?.narrativeCodex ?? []
-                    }
-                    narrativeQaReport={
-                      visibleGameState.storyEngineMemory?.narrativeQaReport ?? null
-                    }
-                  />
-                </Suspense>
-              )}
-            </motion.div>
-          )}
-        </AnimatePresence>
-      </div>
-
-      {shouldMountAdventureEntityModal && (
-        <Suspense fallback={<ModalLoadingFallback label="正在加载冒险详情..." onClose={closeAdventureEntityModal} />}>
-          <AdventureEntityModal
-            selection={selectedSceneEntity}
-            gameState={gameState}
-            onClose={closeAdventureEntityModal}
-            onOpenCharacterChat={target => {
-              closeAdventureEntityModal();
-              characterChatUi.openChat(target);
-            }}
-          />
-        </Suspense>
-      )}
-
-      <AnimatePresence>
-        {overlayPanel && gameState.playerCharacter && (
-          <motion.div
-            initial={{opacity: 0}}
-            animate={{opacity: 1}}
-            exit={{opacity: 0}}
-            className="fixed inset-0 z-[65] flex items-center justify-center bg-black/70 p-4 backdrop-blur-sm"
-            onClick={closeOverlayPanel}
-          >
-            <motion.div
-              initial={{opacity: 0, scale: 0.96, y: 8}}
-              animate={{opacity: 1, scale: 1, y: 0}}
-              exit={{opacity: 0, scale: 0.96, y: 8}}
-              transition={{duration: 0.18, ease: 'easeOut'}}
-              className="pixel-nine-slice pixel-modal-shell flex max-h-[min(92vh,60rem)] w-full max-w-5xl flex-col overflow-hidden shadow-[0_24px_80px_rgba(0,0,0,0.55)]"
-              style={getNineSliceStyle(UI_CHROME.modalPanel)}
-              onClick={event => event.stopPropagation()}
-            >
-              <div className="relative border-b border-white/10 px-4 py-3 sm:px-5 sm:py-4">
-                <div className="min-w-0 pr-10 text-sm font-semibold text-white">{overlayPanel === 'character' ? '队伍' : '背包'}</div>
-                <button
-                  type="button"
-                  onClick={closeOverlayPanel}
-                  className="absolute right-4 top-3 p-1 text-zinc-400 transition-colors hover:text-white sm:right-5 sm:top-4"
-                >
-                  <PixelIcon src={CHROME_ICONS.close} className="h-4 w-4" />
-                </button>
-              </div>
-              <div className="flex min-h-0 flex-1 p-5">
-                {overlayPanel === 'character' ? (
-                  <Suspense fallback={<PanelLoadingFallback label="正在加载队伍面板" />}>
-                    <CharacterPanel
-                      worldType={gameState.worldType}
-                      customWorldProfile={gameState.customWorldProfile}
-                      playerCharacter={gameState.playerCharacter}
-                      playerHp={gameState.playerHp}
-                      playerMaxHp={gameState.playerMaxHp}
-                      playerMana={gameState.playerMana}
-                      playerMaxMana={gameState.playerMaxMana}
-                      playerEquipment={gameState.playerEquipment}
-                      activeBuildBuffs={gameState.activeBuildBuffs}
-                      companionRenderStates={companionRenderStates}
-                      npcStates={gameState.npcStates}
-                      quests={gameState.quests}
-                      onOpenCamp={() => {
-                        closeOverlayPanel();
-                        openCampModal();
-                      }}
-                      onOpenCharacterChat={target => {
-                        closeOverlayPanel();
-                        characterChatUi.openChat(target);
-                      }}
-                      chatSummaries={characterChatSummaries}
-                      onInspectMember={openPartyMemberDetails}
-                    />
-                  </Suspense>
-                ) : (
-                  <Suspense fallback={<PanelLoadingFallback label="正在加载背包面板" />}>
-                    <InventoryPanel
-                      playerCharacter={gameState.playerCharacter}
-                      worldType={gameState.worldType}
-                      playerInventory={gameState.playerInventory}
-                      playerCurrency={gameState.playerCurrency}
-                      playerHp={gameState.playerHp}
-                      playerMaxHp={gameState.playerMaxHp}
-                      playerMana={gameState.playerMana}
-                      playerMaxMana={gameState.playerMaxMana}
-                      inBattle={gameState.inBattle}
-                      onUseItem={inventoryUi.useInventoryItem}
-                      onEquipItem={inventoryUi.equipInventoryItem}
-                      forgeRecipes={inventoryUi.forgeRecipes}
-                      onCraftRecipe={inventoryUi.craftRecipe}
-                      onDismantleItem={inventoryUi.dismantleItem}
-                      onReforgeItem={inventoryUi.reforgeItem}
-                    />
-                  </Suspense>
-                )}
-              </div>
-            </motion.div>
-          </motion.div>
-        )}
-      </AnimatePresence>
-
-      {shouldMountCampModal && (
-        <Suspense fallback={<ModalLoadingFallback label="正在加载队伍营地..." onClose={closeCampModal} />}>
-          <CompanionCampModal
-            isOpen={showTeamModal}
-            playerCharacter={gameState.playerCharacter}
-            companions={gameState.companions}
-            roster={gameState.roster}
-            inBattle={gameState.inBattle}
-            onClose={closeCampModal}
-            onBenchCompanion={onBenchCompanion}
-            onActivateCompanion={onActivateRosterCompanion}
-          />
-        </Suspense>
-      )}
-
-      {shouldMountMapModal && (
-        <Suspense fallback={<ModalLoadingFallback label="正在加载地图..." onClose={() => setIsMapOpen(false)} />}>
-          <MapModal
-            isOpen={isMapOpen}
-            currentScenePreset={gameState.currentScenePreset}
-            worldType={gameState.worldType}
-            canTravel={!gameState.inBattle && !isLoading}
-            onTravelToScene={scene => {
-              const triggered = handleMapTravelToScene(scene.id);
-              if (triggered) {
-                setIsMapOpen(false);
-              }
-            }}
-            isTraveling={isLoading}
-            onClose={() => setIsMapOpen(false)}
-          />
-        </Suspense>
-      )}
-
-      {shouldMountCharacterChatModal && (
-        <Suspense fallback={<ModalLoadingFallback label="正在加载角色聊天..." onClose={characterChatUi.closeChat} />}>
-          <CharacterChatModal
-            modal={characterChatUi.modal}
-            onClose={characterChatUi.closeChat}
-            onDraftChange={characterChatUi.setDraft}
-            onUseSuggestion={characterChatUi.useSuggestion}
-            onRefreshSuggestions={characterChatUi.refreshSuggestions}
-            onSendDraft={characterChatUi.sendDraft}
-          />
-        </Suspense>
-      )}
-
-      {shouldMountNpcModals && (
-        <Suspense fallback={<ModalLoadingFallback label="正在加载场景角色交互..." />}>
-          <NpcModals gameState={gameState} npcUi={npcUi} />
-        </Suspense>
-      )}
-    </div>
-  );
-}
diff --git a/src/components/auth/AuthGate.test.tsx b/src/components/auth/AuthGate.test.tsx
index 7514003f..65ba9ba2 100644
--- a/src/components/auth/AuthGate.test.tsx
+++ b/src/components/auth/AuthGate.test.tsx
@@ -9,9 +9,9 @@ import { AuthGate } from './AuthGate';
 import { useAuthUi } from './AuthUiContext';
 
 const authMocks = vi.hoisted(() => ({
-  getStoredAccessToken: vi.fn(),
   ensureAutoAuthUser: vi.fn(),
   getAuthLoginOptions: vi.fn(),
+  getCurrentAuthUser: vi.fn(),
   loginWithPhoneCode: vi.fn(),
   sendPhoneLoginCode: vi.fn(),
   startWechatLogin: vi.fn(),
@@ -20,7 +20,6 @@ const authMocks = vi.hoisted(() => ({
 
 vi.mock('../../services/apiClient', () => ({
   AUTH_STATE_EVENT: 'genarrative-auth-state-changed',
-  getStoredAccessToken: authMocks.getStoredAccessToken,
 }));
 
 vi.mock('../../services/authService', () => ({
@@ -31,9 +30,9 @@ vi.mock('../../services/authService', () => ({
   getAuthAuditLogs: vi.fn(),
   getAuthLoginOptions: authMocks.getAuthLoginOptions,
   getAuthRiskBlocks: vi.fn(),
+  getCurrentAuthUser: authMocks.getCurrentAuthUser,
   getAuthSessions: vi.fn(),
   getCaptchaChallengeFromError: vi.fn(() => null),
-  getCurrentAuthUser: vi.fn(),
   liftAuthRiskBlock: vi.fn(),
   loginWithPhoneCode: authMocks.loginWithPhoneCode,
   logoutAllAuthSessions: vi.fn(),
@@ -76,8 +75,11 @@ const mockUser: AuthUser = {
 
 beforeEach(() => {
   vi.clearAllMocks();
-  authMocks.getStoredAccessToken.mockReturnValue(null);
   authMocks.consumeAuthCallbackResult.mockReturnValue(null);
+  authMocks.getCurrentAuthUser.mockResolvedValue({
+    user: null,
+    availableLoginMethods: ['phone'],
+  });
   authMocks.loginWithPhoneCode.mockResolvedValue(mockUser);
   authMocks.sendPhoneLoginCode.mockResolvedValue({
     cooldownSeconds: 60,
diff --git a/src/components/auth/AuthGate.tsx b/src/components/auth/AuthGate.tsx
index 31894296..919fdafd 100644
--- a/src/components/auth/AuthGate.tsx
+++ b/src/components/auth/AuthGate.tsx
@@ -10,7 +10,6 @@ import {
 import { useGameSettings } from '../../hooks/useGameSettings';
 import {
   AUTH_STATE_EVENT,
-  getStoredAccessToken,
 } from '../../services/apiClient';
 import {
   type AuthAuditLogEntry,
@@ -228,12 +227,6 @@ export function AuthGate({ children }: AuthGateProps) {
         setShowLoginModal(true);
       }
 
-      const token = getStoredAccessToken();
-      if (!token) {
-        await resolveGuestFallback();
-        return;
-      }
-
       try {
         const nextSession = await getCurrentAuthUser();
         if (!isActive) {
@@ -241,9 +234,8 @@ export function AuthGate({ children }: AuthGateProps) {
         }
 
         if (!nextSession.user) {
-          setUser(null);
           setAvailableLoginMethods(nextSession.availableLoginMethods);
-          setStatus('unauthenticated');
+          await resolveGuestFallback();
           return;
         }
 
diff --git a/src/components/custom-world-agent/CustomWorldAgentClarificationPanel.test.tsx b/src/components/custom-world-agent/CustomWorldAgentClarificationPanel.test.tsx
deleted file mode 100644
index 53a4f105..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentClarificationPanel.test.tsx
+++ /dev/null
@@ -1,98 +0,0 @@
-/* @vitest-environment jsdom */
-
-import { render, screen } from '@testing-library/react';
-import { renderToStaticMarkup } from 'react-dom/server';
-import { afterEach, expect, test, vi } from 'vitest';
-
-import { CustomWorldAgentClarificationPanel } from './CustomWorldAgentClarificationPanel';
-
-afterEach(() => {
-  vi.restoreAllMocks();
-});
-
-test('clarification panel shows pending questions and ready state', () => {
-  const pendingHtml = renderToStaticMarkup(
-    <CustomWorldAgentClarificationPanel
-      readiness={{
-        isReady: false,
-        completedKeys: ['world_hook'],
-        missingKeys: ['player_premise', 'core_conflict'],
-      }}
-      pendingClarifications={[
-        {
-          id: 'player_premise',
-          label: '玩家身份与开局',
-          question: '玩家是谁，故事开场时卡在什么处境里？',
-          targetKey: 'player_premise',
-          priority: 2,
-        },
-      ]}
-    />,
-  );
-  const readyHtml = renderToStaticMarkup(
-    <CustomWorldAgentClarificationPanel
-      readiness={{
-        isReady: true,
-        completedKeys: [
-          'world_hook',
-          'player_premise',
-          'theme_and_tone',
-          'core_conflict',
-          'relationship_seed',
-          'iconic_element',
-        ],
-        missingKeys: [],
-      }}
-      pendingClarifications={[]}
-    />,
-  );
-
-  expect(pendingHtml).toContain('待补充问题');
-  expect(pendingHtml).toContain('玩家是谁，故事开场时卡在什么处境里');
-  expect(readyHtml).toContain('当前设定已齐备，可以进入下一阶段');
-});
-
-test('falls back to stable keys when clarification ids are empty', () => {
-  const consoleErrorSpy = vi
-    .spyOn(console, 'error')
-    .mockImplementation(() => undefined);
-
-  render(
-    <CustomWorldAgentClarificationPanel
-      readiness={{
-        isReady: false,
-        completedKeys: [],
-        missingKeys: ['player_premise', 'core_conflict'],
-      }}
-      pendingClarifications={[
-        {
-          id: '',
-          label: '玩家身份与开局',
-          question: '玩家是谁，故事开场时卡在什么处境里？',
-          targetKey: 'player_premise',
-          priority: 2,
-        },
-        {
-          id: '',
-          label: '核心冲突',
-          question: '第一阶段最直接撞上的冲突是什么？',
-          targetKey: 'core_conflict',
-          priority: 1,
-        },
-      ]}
-    />,
-  );
-
-  expect(screen.getByText(/玩家身份与开局/u)).toBeTruthy();
-  expect(screen.getByText(/核心冲突/u)).toBeTruthy();
-
-  const duplicateKeyCalls = consoleErrorSpy.mock.calls.filter((call) =>
-    call.some(
-      (arg) =>
-        typeof arg === 'string' &&
-        arg.includes('Encountered two children with the same key'),
-    ),
-  );
-
-  expect(duplicateKeyCalls).toHaveLength(0);
-});
diff --git a/src/components/custom-world-agent/CustomWorldAgentClarificationPanel.tsx b/src/components/custom-world-agent/CustomWorldAgentClarificationPanel.tsx
deleted file mode 100644
index a0e9ca8c..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentClarificationPanel.tsx
+++ /dev/null
@@ -1,64 +0,0 @@
-import type {
-  CreatorIntentReadiness,
-  CustomWorldPendingClarification,
-} from '../../../packages/shared/src/contracts/customWorldAgent';
-
-type CustomWorldAgentClarificationPanelProps = {
-  pendingClarifications: CustomWorldPendingClarification[];
-  readiness: CreatorIntentReadiness;
-};
-
-export function CustomWorldAgentClarificationPanel({
-  pendingClarifications,
-  readiness,
-}: CustomWorldAgentClarificationPanelProps) {
-  if (readiness.isReady) {
-    return (
-      <section className="rounded-[1.5rem] border border-emerald-300/18 bg-emerald-500/8 px-4 py-4">
-        <div className="text-[11px] font-bold tracking-[0.2em] text-emerald-100/80">
-          下一阶段
-        </div>
-        <div className="mt-2 text-lg font-semibold text-white">
-          当前设定已齐备，可以进入下一阶段
-        </div>
-      </section>
-    );
-  }
-
-  return (
-    <section className="platform-remap-surface rounded-[1.5rem] border border-white/10 bg-black/18 px-4 py-4">
-      <div className="flex items-center justify-between gap-3">
-        <div>
-          <div className="text-[11px] font-bold tracking-[0.2em] text-zinc-400">
-            待补充问题
-          </div>
-          <div className="mt-2 text-lg font-semibold text-white">
-            先补最关键的 1 到 3 项
-          </div>
-        </div>
-        <span className="rounded-full border border-sky-300/20 bg-sky-500/10 px-3 py-1 text-[11px] text-sky-100">
-          {pendingClarifications.length}
-        </span>
-      </div>
-
-      <div className="mt-4 space-y-2">
-        {pendingClarifications.slice(0, 3).map((item, index) => (
-          <div
-            key={item.id.trim() || `clarification-${item.targetKey}-${index}`}
-            className="rounded-[1.15rem] border border-white/8 bg-white/5 px-3 py-3"
-          >
-            <div className="flex items-start justify-between gap-3">
-              <div className="text-sm font-semibold text-white">
-                {index + 1}. {item.label}
-              </div>
-              <div className="text-[11px] text-zinc-500">P{item.priority}</div>
-            </div>
-            <div className="mt-2 text-sm leading-6 text-zinc-300">
-              {item.question}
-            </div>
-          </div>
-        ))}
-      </div>
-    </section>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.interaction.test.tsx b/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.interaction.test.tsx
deleted file mode 100644
index 14a2f771..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.interaction.test.tsx
+++ /dev/null
@@ -1,115 +0,0 @@
-/* @vitest-environment jsdom */
-
-import { render, screen } from '@testing-library/react';
-import userEvent from '@testing-library/user-event';
-import { useState } from 'react';
-import { expect, test } from 'vitest';
-
-import type { CustomWorldDraftCardDetail } from '../../../packages/shared/src/contracts/customWorldAgent';
-import { CustomWorldAgentDraftDetailPanel } from './CustomWorldAgentDraftDetailPanel';
-import { CustomWorldGenerateEntityModal } from './CustomWorldGenerateEntityModal';
-
-const CHARACTER_DETAIL: CustomWorldDraftCardDetail = {
-  id: 'character-1',
-  kind: 'character',
-  title: '沈砺',
-  sections: [
-    {
-      id: 'name',
-      label: '角色名',
-      value: '沈砺',
-    },
-    {
-      id: 'publicMask',
-      label: '外显身份',
-      value: '守灯会里最熟悉旧航道的人。',
-    },
-    {
-      id: 'summary',
-      label: '角色摘要',
-      value: '他像旧友，但也像一把始终没收回鞘的刀。',
-    },
-  ],
-  linkedIds: ['thread-1'],
-  locked: false,
-  editable: true,
-  editableSectionIds: ['name', 'publicMask', 'summary'],
-  warningMessages: [],
-  assetStatus: 'missing',
-  assetStatusLabel: '待生成主图',
-};
-
-function DetailInteractionHarness() {
-  const [editMode, setEditMode] = useState(false);
-  const [generateMode, setGenerateMode] = useState<'character' | 'landmark' | null>(
-    null,
-  );
-  const [savedPayload, setSavedPayload] = useState<string>('');
-
-  return (
-    <>
-      <CustomWorldAgentDraftDetailPanel
-        detail={CHARACTER_DETAIL}
-        loading={false}
-        editMode={editMode}
-        onClose={() => {}}
-        onStartEdit={() => {
-          setEditMode(true);
-        }}
-        onCancelEdit={() => {
-          setEditMode(false);
-        }}
-        onSave={(sections) => {
-          setSavedPayload(JSON.stringify(sections));
-          setEditMode(false);
-        }}
-        onGenerateCharacter={() => {
-          setGenerateMode('character');
-        }}
-        onGenerateLandmark={() => {
-          setGenerateMode('landmark');
-        }}
-        onOpenRoleAssetStudio={() => {}}
-      />
-      <CustomWorldGenerateEntityModal
-        open={generateMode !== null}
-        mode={generateMode ?? 'character'}
-        anchorCardTitle={CHARACTER_DETAIL.title}
-        onClose={() => {
-          setGenerateMode(null);
-        }}
-        onSubmit={() => {
-          setGenerateMode(null);
-        }}
-      />
-      <div data-testid="saved-payload">{savedPayload}</div>
-    </>
-  );
-}
-
-test('draft detail panel supports edit save and opening generate modals', async () => {
-  const user = userEvent.setup();
-
-  render(<DetailInteractionHarness />);
-
-  await user.click(screen.getByRole('button', { name: '编辑设定' }));
-  const summaryInput = screen.getByLabelText('角色摘要');
-  await user.clear(summaryInput);
-  await user.type(summaryInput, '他像旧友，也像最早知道航道秘密的人。');
-  await user.click(screen.getByRole('button', { name: '保存' }));
-
-  expect(screen.getByTestId('saved-payload').textContent).toContain(
-    '他像旧友，也像最早知道航道秘密的人。',
-  );
-
-  await user.click(screen.getByRole('button', { name: '新增角色' }));
-  expect(screen.getByRole('button', { name: '生成角色' })).toBeTruthy();
-  expect(screen.getByText('当前参考卡')).toBeTruthy();
-  const closeButtons = screen.getAllByRole('button', { name: '关闭' });
-  await user.click(closeButtons[closeButtons.length - 1]!);
-
-  expect(screen.getByRole('button', { name: '角色资产' })).toBeTruthy();
-
-  await user.click(screen.getByRole('button', { name: '新增场景' }));
-  expect(screen.getByRole('button', { name: '生成场景' })).toBeTruthy();
-});
diff --git a/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.test.tsx b/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.test.tsx
deleted file mode 100644
index 315e1c62..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.test.tsx
+++ /dev/null
@@ -1,81 +0,0 @@
-import { renderToStaticMarkup } from 'react-dom/server';
-import { expect, test } from 'vitest';
-
-import { CustomWorldAgentDraftDetailPanel } from './CustomWorldAgentDraftDetailPanel';
-
-test('draft detail panel renders sections and warnings', () => {
-  const html = renderToStaticMarkup(
-    <CustomWorldAgentDraftDetailPanel
-      detail={{
-        id: 'thread-1',
-        kind: 'thread',
-        title: '谁掌握航道解释权',
-        sections: [
-          {
-            id: 'thread-type',
-            label: '线程类型',
-            value: '明线',
-          },
-          {
-            id: 'thread-conflict',
-            label: '冲突内容',
-            value: '守灯会与沉船商盟正在争夺航道解释权。',
-          },
-        ],
-        linkedIds: ['character-1', 'landmark-1'],
-        locked: false,
-        editable: true,
-        editableSectionIds: ['title', 'summary', 'conflictType', 'stakes'],
-        warningMessages: ['这条线还缺少更明确的地点挂点。'],
-      }}
-      loading={false}
-      onClose={() => {}}
-      onStartEdit={() => {}}
-      onGenerateCharacter={() => {}}
-      onGenerateLandmark={() => {}}
-    />,
-  );
-
-  expect(html).toContain('谁掌握航道解释权');
-  expect(html).toContain('线程类型');
-  expect(html).toContain('守灯会与沉船商盟');
-  expect(html).toContain('继续精修');
-  expect(html).toContain('编辑设定');
-  expect(html).toContain('新增角色');
-});
-
-test('draft detail panel renders scene chapter label and background preview', () => {
-  const html = renderToStaticMarkup(
-    <CustomWorldAgentDraftDetailPanel
-      detail={{
-        id: 'scene-chapter-docks',
-        kind: 'scene_chapter',
-        title: '潮汐码头章节',
-        sections: [
-          {
-            id: 'sceneName',
-            label: '所属场景',
-            value: '潮汐码头',
-          },
-          {
-            id: 'act:act-docks-1:backgroundImageSrc',
-            label: '第 1 幕背景图',
-            value: '/images/scene/docks-act-1.webp',
-          },
-        ],
-        linkedIds: ['landmark-docks', 'thread-smuggling'],
-        locked: false,
-        editable: true,
-        editableSectionIds: ['title', 'summary', 'act:act-docks-1:title'],
-        warningMessages: [],
-      }}
-      loading={false}
-      onClose={() => {}}
-      onStartEdit={() => {}}
-    />,
-  );
-
-  expect(html).toContain('场景章节');
-  expect(html).toContain('第 1 幕背景图');
-  expect(html).toContain('img');
-});
diff --git a/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx b/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx
deleted file mode 100644
index 85e1c001..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx
+++ /dev/null
@@ -1,221 +0,0 @@
-import type { CustomWorldDraftCardDetail } from '../../../packages/shared/src/contracts/customWorldAgent';
-import { CustomWorldDraftEditPanel } from './CustomWorldDraftEditPanel';
-
-type CustomWorldAgentDraftDetailPanelProps = {
-  detail: CustomWorldDraftCardDetail | null;
-  loading: boolean;
-  busy?: boolean;
-  editMode?: boolean;
-  onClose: () => void;
-  onStartEdit?: () => void;
-  onCancelEdit?: () => void;
-  onSave?: (
-    sections: Array<{
-      sectionId: string;
-      value: string;
-    }>,
-  ) => void;
-  onGenerateCharacter?: () => void;
-  onGenerateLandmark?: () => void;
-  onOpenRoleAssetStudio?: () => void;
-};
-
-function resolveKindLabel(kind: CustomWorldDraftCardDetail['kind']) {
-  if (kind === 'world') return '世界总卡';
-  if (kind === 'camp') return '营地';
-  if (kind === 'faction') return '势力';
-  if (kind === 'character') return '角色';
-  if (kind === 'landmark') return '地点';
-  if (kind === 'thread') return '线程';
-  if (kind === 'chapter') return '第一幕';
-  if (kind === 'scene_chapter') return '场景章节';
-  return '草稿卡';
-}
-
-function ActionButton(props: {
-  label: string;
-  onClick?: () => void;
-  disabled?: boolean;
-  tone?: 'default' | 'sky';
-}) {
-  const { label, onClick, disabled = false, tone = 'default' } = props;
-
-  if (!onClick) {
-    return null;
-  }
-
-  return (
-    <button
-      type="button"
-      onClick={onClick}
-      disabled={disabled}
-      className={`rounded-full border px-3 py-1.5 text-[11px] transition ${
-        tone === 'sky'
-          ? 'border-sky-300/20 bg-sky-500/10 text-sky-100 hover:text-white'
-          : 'border-white/10 bg-black/20 text-zinc-300 hover:text-white'
-      } disabled:cursor-not-allowed disabled:opacity-45`}
-    >
-      {label}
-    </button>
-  );
-}
-
-export function CustomWorldAgentDraftDetailPanel({
-  detail,
-  loading,
-  busy = false,
-  editMode = false,
-  onClose,
-  onStartEdit,
-  onCancelEdit,
-  onSave,
-  onGenerateCharacter,
-  onGenerateLandmark,
-  onOpenRoleAssetStudio,
-}: CustomWorldAgentDraftDetailPanelProps) {
-  const shouldRenderImagePreview = (
-    detailKind: CustomWorldDraftCardDetail['kind'],
-    sectionId: string,
-    value: string,
-  ) =>
-    detailKind === 'scene_chapter' &&
-    sectionId.endsWith(':backgroundImageSrc') &&
-    value !== '待继续精修';
-
-  return (
-    <section className="platform-remap-surface rounded-[1.5rem] border border-white/10 bg-black/18 px-4 py-4">
-      <div className="flex items-start justify-between gap-3">
-        <div>
-          <div className="text-[11px] font-bold tracking-[0.2em] text-zinc-400">
-            卡片详情
-          </div>
-          <div className="mt-2 text-lg font-semibold text-white">
-            {loading ? '正在读取' : detail?.title || '选择一张草稿卡'}
-          </div>
-        </div>
-        <button
-          type="button"
-          onClick={onClose}
-          className="rounded-full border border-white/10 bg-black/20 px-3 py-1 text-[11px] text-zinc-300 transition hover:text-white"
-        >
-          关闭
-        </button>
-      </div>
-
-      {loading ? (
-        <div className="mt-4 rounded-[1.15rem] border border-white/8 bg-white/5 px-4 py-5 text-sm leading-7 text-zinc-300">
-          正在整理这张卡的内容。
-        </div>
-      ) : detail ? (
-        <div className="mt-4 space-y-3">
-          <div className="flex flex-wrap items-center gap-2">
-            <span className="rounded-full border border-sky-300/20 bg-sky-500/10 px-3 py-1 text-[11px] text-sky-100">
-              {resolveKindLabel(detail.kind)}
-            </span>
-            <span className="rounded-full border border-white/10 bg-black/24 px-3 py-1 text-[11px] text-zinc-300">
-              关联 {detail.linkedIds.length}
-            </span>
-            {detail.editable ? (
-              <span className="rounded-full border border-emerald-300/20 bg-emerald-500/10 px-3 py-1 text-[11px] text-emerald-100">
-                可编辑
-              </span>
-            ) : null}
-            {detail.kind === 'character' && detail.assetStatusLabel ? (
-              <span className="rounded-full border border-amber-300/20 bg-amber-500/10 px-3 py-1 text-[11px] text-amber-100">
-                {detail.assetStatusLabel}
-              </span>
-            ) : null}
-          </div>
-
-          <div className="flex flex-wrap gap-2">
-            {!editMode && detail.editable ? (
-              <ActionButton
-                label="编辑设定"
-                onClick={onStartEdit}
-                disabled={busy}
-              />
-            ) : null}
-            {!editMode && detail.kind === 'character' ? (
-              <ActionButton
-                label="角色资产"
-                onClick={onOpenRoleAssetStudio}
-                disabled={busy}
-                tone="sky"
-              />
-            ) : null}
-            {!editMode ? (
-              <>
-                <ActionButton
-                  label="新增角色"
-                  onClick={onGenerateCharacter}
-                  disabled={busy}
-                  tone="sky"
-                />
-                <ActionButton
-                  label="新增场景"
-                  onClick={onGenerateLandmark}
-                  disabled={busy}
-                  tone="sky"
-                />
-              </>
-            ) : null}
-          </div>
-
-          {editMode && onSave && onCancelEdit ? (
-            <CustomWorldDraftEditPanel
-              detail={detail}
-              disabled={busy}
-              onSave={onSave}
-              onCancel={onCancelEdit}
-            />
-          ) : (
-            <div className="space-y-2">
-              {detail.sections.map((section) => (
-                <div
-                  key={section.id}
-                  className="rounded-[1.1rem] border border-white/8 bg-white/5 px-3 py-3"
-                >
-                  <div className="text-[11px] tracking-[0.16em] text-zinc-400">
-                    {section.label}
-                  </div>
-                  {shouldRenderImagePreview(detail.kind, section.id, section.value) ? (
-                    <img
-                      src={section.value}
-                      alt={section.label}
-                      className="mt-3 h-40 w-full rounded-[1rem] border border-white/10 object-cover"
-                    />
-                  ) : null}
-                  <div className="mt-2 whitespace-pre-wrap text-sm leading-7 text-zinc-100">
-                    {section.value}
-                  </div>
-                </div>
-              ))}
-            </div>
-          )}
-
-          {detail.warningMessages.length > 0 ? (
-            <div className="rounded-[1.15rem] border border-amber-300/20 bg-amber-500/10 px-4 py-4">
-              <div className="text-[11px] font-bold tracking-[0.18em] text-amber-100">
-                继续精修
-              </div>
-              <div className="mt-3 space-y-2">
-                {detail.warningMessages.map((message, index) => (
-                  <div
-                    key={`${detail.id}-warning-${index}`}
-                    className="text-sm leading-7 text-amber-50"
-                  >
-                    {message}
-                  </div>
-                ))}
-              </div>
-            </div>
-          ) : null}
-        </div>
-      ) : (
-        <div className="mt-4 rounded-[1.15rem] border border-dashed border-white/10 bg-black/22 px-4 py-5 text-sm leading-7 text-zinc-400">
-          从草稿抽屉里点开一张卡，就能在这里看世界底稿的具体内容。
-        </div>
-      )}
-    </section>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldAgentDraftDrawer.tsx b/src/components/custom-world-agent/CustomWorldAgentDraftDrawer.tsx
deleted file mode 100644
index cd2a3812..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentDraftDrawer.tsx
+++ /dev/null
@@ -1,117 +0,0 @@
-import type { CustomWorldDraftCardSummary } from '../../../packages/shared/src/contracts/customWorldAgent';
-
-type CustomWorldAgentDraftDrawerProps = {
-  draftCards: CustomWorldDraftCardSummary[];
-  activeCardId?: string | null;
-  onSelectCard: (cardId: string) => void;
-};
-
-const DRAWER_KIND_ORDER: CustomWorldDraftCardSummary['kind'][] = [
-  'world',
-  'chapter',
-  'scene_chapter',
-  'thread',
-  'faction',
-  'character',
-  'landmark',
-  'camp',
-];
-
-function resolveGroupLabel(kind: CustomWorldDraftCardSummary['kind']) {
-  if (kind === 'world') return '世界总卡';
-  if (kind === 'chapter') return '第一幕';
-  if (kind === 'scene_chapter') return '场景章节';
-  if (kind === 'thread') return '世界线程';
-  if (kind === 'faction') return '势力';
-  if (kind === 'character') return '关键角色';
-  if (kind === 'landmark') return '关键地点';
-  if (kind === 'camp') return '营地';
-  return '草稿卡';
-}
-
-export function CustomWorldAgentDraftDrawer({
-  draftCards,
-  activeCardId,
-  onSelectCard,
-}: CustomWorldAgentDraftDrawerProps) {
-  const groupedCards = DRAWER_KIND_ORDER.map((kind) => ({
-    kind,
-    items: draftCards.filter((card) => card.kind === kind),
-  })).filter((group) => group.items.length > 0);
-
-  return (
-    <div className="platform-remap-surface rounded-[1.5rem] border border-white/10 bg-black/18 px-4 py-4">
-      <div className="text-[11px] font-bold tracking-[0.2em] text-zinc-400">
-        草稿抽屉
-      </div>
-      {groupedCards.length > 0 ? (
-        <div className="mt-3 space-y-4">
-          {groupedCards.map((group) => (
-            <section key={group.kind}>
-              <div className="flex items-center justify-between gap-3">
-                <div className="text-[11px] tracking-[0.18em] text-zinc-400">
-                  {resolveGroupLabel(group.kind)}
-                </div>
-                <div className="text-[11px] text-zinc-500">
-                  {group.items.length}
-                </div>
-              </div>
-              <div className="mt-2 space-y-2">
-                {group.items.map((card, index) => {
-                  const isActive = activeCardId === card.id;
-
-                  return (
-                    <button
-                      key={card.id || `${group.kind}-card-${index}`}
-                      type="button"
-                      onClick={() => onSelectCard(card.id)}
-                      className={`w-full rounded-[1.2rem] border px-3 py-3 text-left transition ${
-                        isActive
-                          ? 'border-sky-300/30 bg-sky-500/10'
-                          : 'border-white/8 bg-white/5 hover:border-white/14'
-                      }`}
-                    >
-                      <div className="flex items-start justify-between gap-3">
-                        <div className="text-sm font-semibold text-white">
-                          {card.title}
-                        </div>
-                        {card.warningCount > 0 ? (
-                          <span className="rounded-full border border-amber-300/20 bg-amber-500/10 px-2 py-0.5 text-[10px] text-amber-100">
-                            {card.warningCount}
-                          </span>
-                        ) : null}
-                      </div>
-                      <div className="mt-1 text-[11px] text-zinc-400">
-                        {card.subtitle}
-                      </div>
-                      <div className="mt-2 text-sm leading-6 text-zinc-300">
-                        {card.summary}
-                      </div>
-                      <div className="mt-3 flex flex-wrap gap-2">
-                        <span className="rounded-full border border-white/10 bg-black/24 px-2.5 py-1 text-[10px] text-zinc-200">
-                          关联 {card.linkedIds.length}
-                        </span>
-                        <span className="rounded-full border border-white/10 bg-black/24 px-2.5 py-1 text-[10px] text-zinc-200">
-                          {card.status === 'warning' ? '待精修' : '建议稿'}
-                        </span>
-                        {card.kind === 'character' && card.assetStatusLabel ? (
-                          <span className="rounded-full border border-amber-300/20 bg-amber-500/10 px-2.5 py-1 text-[10px] text-amber-100">
-                            {card.assetStatusLabel}
-                          </span>
-                        ) : null}
-                      </div>
-                    </button>
-                  );
-                })}
-              </div>
-            </section>
-          ))}
-        </div>
-      ) : (
-        <div className="mt-3 text-sm leading-7 text-zinc-400">
-          当前设定收束后，世界底稿会先从这里长出来。
-        </div>
-      )}
-    </div>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.test.tsx b/src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.test.tsx
deleted file mode 100644
index 3b8d6cf5..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.test.tsx
+++ /dev/null
@@ -1,40 +0,0 @@
-import { renderToStaticMarkup } from 'react-dom/server';
-import { expect, test } from 'vitest';
-
-import { CustomWorldAgentIntentSummaryPanel } from './CustomWorldAgentIntentSummaryPanel';
-
-test('intent summary panel shows collected custom world anchors', () => {
-  const html = renderToStaticMarkup(
-    <CustomWorldAgentIntentSummaryPanel
-      creatorIntent={{
-        sourceMode: 'freeform',
-        rawSettingText: '',
-        worldHook: '一个被潮雾切开的列岛世界。',
-        themeKeywords: ['海岛'],
-        toneDirectives: ['冷峻'],
-        playerPremise: '玩家是失职返乡的守灯人。',
-        openingSituation: '开局站在即将熄灭的旧灯塔上。',
-        coreConflicts: ['守灯会与沉船商盟争夺航道解释权'],
-        keyCharacters: [],
-        iconicElements: ['潮雾钟声'],
-      }}
-      readiness={{
-        isReady: false,
-        completedKeys: [
-          'world_hook',
-          'player_premise',
-          'theme_and_tone',
-          'core_conflict',
-          'iconic_element',
-        ],
-        missingKeys: ['relationship_seed'],
-      }}
-    />,
-  );
-
-  expect(html).toContain('已收集设定');
-  expect(html).toContain('世界一句话');
-  expect(html).toContain('一个被潮雾切开的列岛世界');
-  expect(html).toContain('守灯会与沉船商盟争夺航道解释权');
-  expect(html).toContain('5/6');
-});
diff --git a/src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.tsx b/src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.tsx
deleted file mode 100644
index 3d00a72c..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.tsx
+++ /dev/null
@@ -1,99 +0,0 @@
-import type { CreatorIntentReadiness } from '../../../packages/shared/src/contracts/customWorldAgent';
-import {
-  evaluateCustomWorldCreatorIntentReadiness,
-  hasMeaningfulCustomWorldCreatorIntent,
-  normalizeCustomWorldCreatorIntent,
-} from '../../services/customWorldCreatorIntent';
-
-type CustomWorldAgentIntentSummaryPanelProps = {
-  creatorIntent: Record<string, unknown> | null;
-  readiness: CreatorIntentReadiness;
-};
-
-export function CustomWorldAgentIntentSummaryPanel({
-  creatorIntent,
-  readiness,
-}: CustomWorldAgentIntentSummaryPanelProps) {
-  const intent = normalizeCustomWorldCreatorIntent(creatorIntent);
-  const resolvedReadiness =
-    readiness ?? evaluateCustomWorldCreatorIntentReadiness(intent);
-  const items = [
-    {
-      label: '世界一句话',
-      value: intent?.worldHook || '',
-      ready: resolvedReadiness.completedKeys.includes('world_hook'),
-    },
-    {
-      label: '玩家身份',
-      value: intent?.playerPremise || '',
-      ready: Boolean(intent?.playerPremise),
-    },
-    {
-      label: '开局处境',
-      value: intent?.openingSituation || '',
-      ready: Boolean(intent?.openingSituation),
-    },
-    {
-      label: '核心冲突',
-      value: intent?.coreConflicts.join('、') || '',
-      ready: resolvedReadiness.completedKeys.includes('core_conflict'),
-    },
-    {
-      label: '主题气质',
-      value:
-        [...(intent?.themeKeywords ?? []), ...(intent?.toneDirectives ?? [])]
-          .filter(Boolean)
-          .join('、') || '',
-      ready: resolvedReadiness.completedKeys.includes('theme_and_tone'),
-    },
-    {
-      label: '标志性要素',
-      value: intent?.iconicElements.join('、') || '',
-      ready: resolvedReadiness.completedKeys.includes('iconic_element'),
-    },
-  ];
-
-  return (
-    <section className="platform-remap-surface rounded-[1.5rem] border border-white/10 bg-black/18 px-4 py-4">
-      <div className="flex items-center justify-between gap-3">
-        <div>
-          <div className="text-[11px] font-bold tracking-[0.2em] text-zinc-400">
-            已收集设定
-          </div>
-          <div className="mt-2 text-lg font-semibold text-white">
-            {resolvedReadiness.isReady ? '创作输入已齐备' : '继续收世界骨架'}
-          </div>
-        </div>
-        <span className="rounded-full border border-white/10 bg-black/24 px-3 py-1 text-[11px] text-zinc-300">
-          {resolvedReadiness.completedKeys.length}/6
-        </span>
-      </div>
-
-      {hasMeaningfulCustomWorldCreatorIntent(intent) ? (
-        <div className="mt-4 grid gap-2 sm:grid-cols-2">
-          {items.map((item) => (
-            <div
-              key={item.label}
-              className={`rounded-[1.15rem] border px-3 py-3 ${
-                item.ready
-                  ? 'border-emerald-300/18 bg-emerald-500/8'
-                  : 'border-white/8 bg-white/5'
-              }`}
-            >
-              <div className="text-[11px] tracking-[0.16em] text-zinc-400">
-                {item.label}
-              </div>
-              <div className="mt-2 text-sm leading-6 text-zinc-100">
-                {item.value || '待补充'}
-              </div>
-            </div>
-          ))}
-        </div>
-      ) : (
-        <div className="mt-4 rounded-[1.15rem] border border-dashed border-white/10 bg-black/22 px-4 py-5 text-sm text-zinc-400">
-          还在收集你的世界设定
-        </div>
-      )}
-    </section>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldAgentLauncherModal.tsx b/src/components/custom-world-agent/CustomWorldAgentLauncherModal.tsx
deleted file mode 100644
index 29f901b8..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentLauncherModal.tsx
+++ /dev/null
@@ -1,90 +0,0 @@
-import { X } from 'lucide-react';
-
-type CustomWorldAgentLauncherModalProps = {
-  isOpen: boolean;
-  seedText: string;
-  isBusy: boolean;
-  error: string | null;
-  onClose: () => void;
-  onSeedTextChange: (value: string) => void;
-  onConfirm: () => void;
-};
-
-export function CustomWorldAgentLauncherModal({
-  isOpen,
-  seedText,
-  isBusy,
-  error,
-  onClose,
-  onSeedTextChange,
-  onConfirm,
-}: CustomWorldAgentLauncherModalProps) {
-  if (!isOpen) {
-    return null;
-  }
-
-  return (
-    <div className="platform-overlay fixed inset-0 z-[90] flex items-center justify-center p-4 backdrop-blur-sm">
-      <div className="platform-modal-shell platform-remap-surface flex max-h-[92vh] w-full max-w-2xl flex-col overflow-hidden rounded-[2rem] shadow-[0_30px_90px_rgba(0,0,0,0.6)]">
-        <div className="flex items-center justify-between border-b border-white/10 px-5 py-4">
-          <div>
-            <div className="text-base font-semibold text-white">
-              开始和 Agent 共创
-            </div>
-            <div className="mt-1 text-xs text-zinc-400">
-              输入一段种子灵感，先进入新的工作区。
-            </div>
-          </div>
-          <button
-            type="button"
-            onClick={onClose}
-            disabled={isBusy}
-            className="rounded-full border border-white/10 bg-white/5 p-2 text-zinc-300 transition hover:bg-white/10 hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            <X className="h-4 w-4" />
-          </button>
-        </div>
-
-        <div className="min-h-0 flex-1 overflow-y-auto px-5 py-5">
-          <label className="block">
-            <div className="mb-2 text-sm font-medium text-zinc-200">
-              Seed Text
-            </div>
-            <textarea
-              value={seedText}
-              onChange={(event) => onSeedTextChange(event.target.value)}
-              rows={7}
-              placeholder="例：一个被潮雾切碎的列岛世界，灯塔守望者、沉船秘术与旧盟约残片正在重新苏醒。"
-              className="w-full rounded-3xl border border-white/10 bg-black/30 px-4 py-3 text-sm leading-7 text-white outline-none transition focus:border-sky-400/40"
-            />
-          </label>
-
-          {error ? (
-            <div className="mt-4 rounded-3xl border border-rose-400/25 bg-rose-500/10 px-4 py-3 text-sm leading-6 text-rose-100">
-              {error}
-            </div>
-          ) : null}
-        </div>
-
-        <div className="flex flex-wrap items-center justify-end gap-3 border-t border-white/10 px-5 py-4">
-          <button
-            type="button"
-            onClick={onClose}
-            disabled={isBusy}
-            className="rounded-2xl border border-white/10 bg-white/5 px-4 py-2 text-sm text-zinc-300 transition hover:bg-white/10 hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            取消
-          </button>
-          <button
-            type="button"
-            onClick={onConfirm}
-            disabled={isBusy}
-            className="rounded-2xl bg-sky-400 px-4 py-2 text-sm font-semibold text-slate-950 transition hover:bg-sky-300 disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            {isBusy ? '处理中...' : '开始共创'}
-          </button>
-        </div>
-      </div>
-    </div>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldAgentLockBar.tsx b/src/components/custom-world-agent/CustomWorldAgentLockBar.tsx
deleted file mode 100644
index 7b1009fa..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentLockBar.tsx
+++ /dev/null
@@ -1,53 +0,0 @@
-type CustomWorldAgentLockBarProps = {
-  lockState: Record<string, unknown> | null;
-};
-
-function readLockedItems(lockState: Record<string, unknown> | null) {
-  if (!lockState) {
-    return [];
-  }
-
-  return [...new Set(
-    Object.entries(lockState)
-    .flatMap(([key, value]) =>
-      Array.isArray(value)
-        ? value
-            .map((item) => String(item).trim())
-            .filter(Boolean)
-            .map((item) => `${key}:${item}`)
-        : typeof value === 'string' && value.trim()
-          ? [`${key}:${value.trim()}`]
-          : [],
-    )
-  )].slice(0, 8);
-}
-
-export function CustomWorldAgentLockBar({
-  lockState,
-}: CustomWorldAgentLockBarProps) {
-  const lockedItems = readLockedItems(lockState);
-
-  return (
-    <div className="platform-remap-surface rounded-[1.5rem] border border-white/10 bg-black/18 px-4 py-4">
-      <div className="text-[11px] font-bold tracking-[0.2em] text-zinc-400">
-        锁定内容
-      </div>
-      {lockedItems.length > 0 ? (
-        <div className="mt-3 flex flex-wrap gap-2">
-          {lockedItems.map((item, index) => (
-            <span
-              key={`locked-item-${index}-${item}`}
-              className="rounded-full border border-amber-300/20 bg-amber-500/10 px-3 py-1 text-[11px] text-amber-100"
-            >
-              {item}
-            </span>
-          ))}
-        </div>
-      ) : (
-        <div className="mt-3 text-sm leading-7 text-zinc-400">
-          暂未锁定内容
-        </div>
-      )}
-    </div>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldAgentQuickActions.tsx b/src/components/custom-world-agent/CustomWorldAgentQuickActions.tsx
deleted file mode 100644
index a897ae33..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentQuickActions.tsx
+++ /dev/null
@@ -1,132 +0,0 @@
-import type { CustomWorldSuggestedAction } from '../../../packages/shared/src/contracts/customWorldAgent';
-
-type CustomWorldAgentQuickActionsProps = {
-  suggestedActions: CustomWorldSuggestedAction[];
-  disabled: boolean;
-  canDraftFoundation: boolean;
-  showEntityActions?: boolean;
-  showSummaryAction?: boolean;
-  onRequestSummary: () => void;
-  onDraftFoundation: () => void;
-  onGenerateCharacter?: () => void;
-  onGenerateLandmark?: () => void;
-  onGenerateRoleAssets?: () => void;
-  showRoleAssetAction?: boolean;
-  onFocusSuggestedAction: (action?: CustomWorldSuggestedAction) => void;
-};
-
-function QuickActionButton(props: {
-  label: string;
-  onClick: () => void;
-  disabled: boolean;
-  tone?: 'default' | 'sky' | 'amber';
-}) {
-  const { label, onClick, disabled, tone = 'default' } = props;
-
-  return (
-    <button
-      type="button"
-      onClick={onClick}
-      disabled={disabled}
-      className={`rounded-[1.1rem] border px-4 py-3 text-left text-sm transition disabled:cursor-not-allowed disabled:opacity-45 ${
-        tone === 'amber'
-          ? 'border-amber-300/20 bg-amber-500/10 text-amber-100 hover:text-white'
-          : tone === 'sky'
-            ? 'border-sky-300/20 bg-sky-500/10 text-sky-100 hover:text-white'
-            : 'border-white/10 bg-black/20 text-zinc-200 hover:text-white'
-      }`}
-    >
-      {label}
-    </button>
-  );
-}
-
-export function CustomWorldAgentQuickActions({
-  suggestedActions,
-  disabled,
-  canDraftFoundation,
-  showEntityActions = false,
-  showSummaryAction = true,
-  onRequestSummary,
-  onDraftFoundation,
-  onGenerateCharacter,
-  onGenerateLandmark,
-  onGenerateRoleAssets,
-  showRoleAssetAction = false,
-  onFocusSuggestedAction,
-}: CustomWorldAgentQuickActionsProps) {
-  const summaryAction = suggestedActions.find(
-    (action) => action.type === 'request_summary',
-  );
-  const draftAction = suggestedActions.find(
-    (action) => action.type === 'draft_foundation',
-  );
-  const refinementActions = suggestedActions.filter(
-    (action) =>
-      action.type !== 'request_summary' && action.type !== 'draft_foundation',
-  );
-
-  return (
-    <div className="platform-remap-surface rounded-[1.5rem] border border-white/10 bg-black/18 px-4 py-4">
-      <div className="text-[11px] font-bold tracking-[0.2em] text-zinc-400">
-        快捷动作
-      </div>
-      <div className="mt-3 flex flex-col gap-2">
-        {showSummaryAction ? (
-          <QuickActionButton
-            label={summaryAction?.label ?? '总结当前设定'}
-            onClick={onRequestSummary}
-            disabled={disabled}
-            tone="sky"
-          />
-        ) : null}
-        {draftAction && canDraftFoundation ? (
-          <QuickActionButton
-            label={draftAction.label}
-            onClick={onDraftFoundation}
-            disabled={disabled}
-            tone="amber"
-          />
-        ) : null}
-        {showEntityActions && onGenerateCharacter ? (
-          <QuickActionButton
-            label="新增角色"
-            onClick={onGenerateCharacter}
-            disabled={disabled}
-          />
-        ) : null}
-        {showEntityActions && onGenerateLandmark ? (
-          <QuickActionButton
-            label="新增场景"
-            onClick={onGenerateLandmark}
-            disabled={disabled}
-          />
-        ) : null}
-        {showRoleAssetAction && onGenerateRoleAssets ? (
-          <QuickActionButton
-            label="生成角色主图与动作"
-            onClick={onGenerateRoleAssets}
-            disabled={disabled}
-            tone="amber"
-          />
-        ) : null}
-        {refinementActions.length > 0 ? (
-          refinementActions.slice(0, 2).map((action) => (
-            <QuickActionButton
-              key={action.id}
-              label={action.label}
-              onClick={() => onFocusSuggestedAction(action)}
-              disabled={disabled}
-            />
-          ))
-        ) : !draftAction || !canDraftFoundation ? (
-          <QuickActionButton
-            label={showEntityActions ? '继续精修当前草稿' : '继续补充设定'}
-            onClick={() => onFocusSuggestedAction()}
-            disabled={disabled}
-          />
-        ) : null}
-      </div>
-    </div>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldAgentSummaryPanel.tsx b/src/components/custom-world-agent/CustomWorldAgentSummaryPanel.tsx
deleted file mode 100644
index 57cb7b82..00000000
--- a/src/components/custom-world-agent/CustomWorldAgentSummaryPanel.tsx
+++ /dev/null
@@ -1,58 +0,0 @@
-import type { CustomWorldAgentSessionSnapshot } from '../../../packages/shared/src/contracts/customWorldAgent';
-
-type CustomWorldAgentSummaryPanelProps = {
-  session: CustomWorldAgentSessionSnapshot;
-};
-
-function readSummaryText(
-  draftProfile: Record<string, unknown> | null,
-  fallback: string,
-) {
-  const title =
-    typeof draftProfile?.title === 'string' ? draftProfile.title.trim() : '';
-  const summary =
-    typeof draftProfile?.summary === 'string'
-      ? draftProfile.summary.trim()
-      : '';
-
-  return {
-    title: title || '世界摘要待整理',
-    summary: summary || fallback,
-  };
-}
-
-export function CustomWorldAgentSummaryPanel({
-  session,
-}: CustomWorldAgentSummaryPanelProps) {
-  const pendingCount = session.pendingClarifications.length;
-  const { title, summary } = readSummaryText(
-    session.draftProfile,
-    '第一阶段先收住世界设定，后续阶段再把这里整理成更完整的世界底稿摘要。',
-  );
-
-  return (
-    <div className="platform-remap-surface rounded-[1.75rem] border border-white/10 bg-black/20 px-4 py-4">
-      <div className="flex flex-wrap items-start justify-between gap-3">
-        <div>
-          <div className="text-[11px] font-bold tracking-[0.2em] text-zinc-400">
-            顶部摘要
-          </div>
-          <div className="mt-2 text-lg font-semibold text-white">
-            {title}
-          </div>
-        </div>
-        <div className="flex flex-wrap gap-2">
-          <span className="rounded-full border border-white/10 bg-black/24 px-3 py-1 text-[11px] text-zinc-300">
-            消息 {session.messages.length}
-          </span>
-          <span className="rounded-full border border-sky-300/20 bg-sky-500/10 px-3 py-1 text-[11px] text-sky-100">
-            待澄清 {pendingCount}
-          </span>
-        </div>
-      </div>
-      <div className="mt-3 text-sm leading-7 text-zinc-300">
-        {summary}
-      </div>
-    </div>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldDraftCardDetailModal.tsx b/src/components/custom-world-agent/CustomWorldDraftCardDetailModal.tsx
deleted file mode 100644
index d3ddc90b..00000000
--- a/src/components/custom-world-agent/CustomWorldDraftCardDetailModal.tsx
+++ /dev/null
@@ -1,67 +0,0 @@
-import type { CustomWorldDraftCardDetail } from '../../../packages/shared/src/contracts/customWorldAgent';
-import { CustomWorldAgentDraftDetailPanel } from './CustomWorldAgentDraftDetailPanel';
-
-type CustomWorldDraftCardDetailModalProps = {
-  open: boolean;
-  detail: CustomWorldDraftCardDetail | null;
-  loading: boolean;
-  busy?: boolean;
-  editMode?: boolean;
-  onClose: () => void;
-  onStartEdit?: () => void;
-  onCancelEdit?: () => void;
-  onSave?: (
-    sections: Array<{
-      sectionId: string;
-      value: string;
-    }>,
-  ) => void;
-  onGenerateCharacter?: () => void;
-  onGenerateLandmark?: () => void;
-  onOpenRoleAssetStudio?: () => void;
-};
-
-export function CustomWorldDraftCardDetailModal({
-  open,
-  detail,
-  loading,
-  busy = false,
-  editMode = false,
-  onClose,
-  onStartEdit,
-  onCancelEdit,
-  onSave,
-  onGenerateCharacter,
-  onGenerateLandmark,
-  onOpenRoleAssetStudio,
-}: CustomWorldDraftCardDetailModalProps) {
-  if (!open) {
-    return null;
-  }
-
-  return (
-    <div className="platform-overlay fixed inset-0 z-[95] flex items-end justify-center p-3 backdrop-blur-sm xl:hidden">
-      <button
-        type="button"
-        aria-label="关闭卡片详情"
-        onClick={onClose}
-        className="absolute inset-0 cursor-default"
-      />
-      <div className="relative z-10 max-h-[85vh] w-full max-w-2xl overflow-y-auto">
-        <CustomWorldAgentDraftDetailPanel
-          detail={detail}
-          loading={loading}
-          busy={busy}
-          editMode={editMode}
-          onClose={onClose}
-          onStartEdit={onStartEdit}
-          onCancelEdit={onCancelEdit}
-          onSave={onSave}
-          onGenerateCharacter={onGenerateCharacter}
-          onGenerateLandmark={onGenerateLandmark}
-          onOpenRoleAssetStudio={onOpenRoleAssetStudio}
-        />
-      </div>
-    </div>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldDraftEditPanel.test.tsx b/src/components/custom-world-agent/CustomWorldDraftEditPanel.test.tsx
deleted file mode 100644
index 6d94c624..00000000
--- a/src/components/custom-world-agent/CustomWorldDraftEditPanel.test.tsx
+++ /dev/null
@@ -1,102 +0,0 @@
-import { renderToStaticMarkup } from 'react-dom/server';
-import { expect, test } from 'vitest';
-
-import { CustomWorldAgentDraftDetailPanel } from './CustomWorldAgentDraftDetailPanel';
-
-test('draft detail panel renders editable form in edit mode', () => {
-  const html = renderToStaticMarkup(
-    <CustomWorldAgentDraftDetailPanel
-      detail={{
-        id: 'character-1',
-        kind: 'character',
-        title: '沈砺',
-        sections: [
-          {
-            id: 'name',
-            label: '角色名',
-            value: '沈砺',
-          },
-          {
-            id: 'publicMask',
-            label: '外显身份',
-            value: '守灯会里最熟悉旧航道的人。',
-          },
-          {
-            id: 'summary',
-            label: '角色摘要',
-            value: '他像旧友，但也像一把始终没收回鞘的刀。',
-          },
-        ],
-        linkedIds: ['thread-1'],
-        locked: false,
-        editable: true,
-        editableSectionIds: ['name', 'publicMask', 'summary'],
-        warningMessages: [],
-      }}
-      loading={false}
-      editMode
-      onClose={() => {}}
-      onCancelEdit={() => {}}
-      onSave={() => {}}
-    />,
-  );
-
-  expect(html).toContain('保存');
-  expect(html).toContain('取消');
-  expect(html).toContain('角色名');
-  expect(html).toContain('textarea');
-});
-
-test('draft detail panel uses textarea for scene chapter act narrative fields', () => {
-  const html = renderToStaticMarkup(
-    <CustomWorldAgentDraftDetailPanel
-      detail={{
-        id: 'scene-chapter-docks',
-        kind: 'scene_chapter',
-        title: '潮汐码头章节',
-        sections: [
-          {
-            id: 'title',
-            label: '场景章节标题',
-            value: '潮汐码头章节',
-          },
-          {
-            id: 'act:act-docks-1:summary',
-            label: '第 1 幕摘要',
-            value: '玩家刚抵达时，林潮先决定要不要放行。',
-          },
-          {
-            id: 'act:act-docks-1:encounterNpcIds',
-            label: '第 1 幕相遇 NPC',
-            value: '林潮\n晏九',
-          },
-          {
-            id: 'act:act-docks-1:transitionHook',
-            label: '第 1 幕过渡钩子',
-            value: '确认站位后，真正的封锁者会压上来。',
-          },
-        ],
-        linkedIds: ['thread-smuggling'],
-        locked: false,
-        editable: true,
-        editableSectionIds: [
-          'title',
-          'act:act-docks-1:summary',
-          'act:act-docks-1:encounterNpcIds',
-          'act:act-docks-1:transitionHook',
-        ],
-        warningMessages: [],
-      }}
-      loading={false}
-      editMode
-      onClose={() => {}}
-      onCancelEdit={() => {}}
-      onSave={() => {}}
-    />,
-  );
-
-  expect(html).toContain('第 1 幕摘要');
-  expect(html).toContain('第 1 幕相遇 NPC');
-  expect(html).toContain('第 1 幕过渡钩子');
-  expect(html).toContain('textarea');
-});
diff --git a/src/components/custom-world-agent/CustomWorldDraftEditPanel.tsx b/src/components/custom-world-agent/CustomWorldDraftEditPanel.tsx
deleted file mode 100644
index c6c63460..00000000
--- a/src/components/custom-world-agent/CustomWorldDraftEditPanel.tsx
+++ /dev/null
@@ -1,141 +0,0 @@
-import { useEffect, useMemo, useState } from 'react';
-
-import type { CustomWorldDraftCardDetail } from '../../../packages/shared/src/contracts/customWorldAgent';
-
-type CustomWorldDraftEditPanelProps = {
-  detail: CustomWorldDraftCardDetail;
-  disabled?: boolean;
-  onSave: (
-    sections: Array<{
-      sectionId: string;
-      value: string;
-    }>,
-  ) => void;
-  onCancel: () => void;
-};
-
-function shouldUseTextarea(sectionId: string, value: string) {
-  const sceneActField = sectionId.match(/^act:[^:]+:(.+)$/u)?.[1] ?? null;
-  return (
-    value.length > 28 ||
-    value.includes('\n') ||
-    sectionId === 'summary' ||
-    sectionId === 'tone' ||
-    sectionId === 'coreConflicts' ||
-    sectionId === 'hiddenHook' ||
-    sectionId === 'secret' ||
-    sectionId === 'stakes' ||
-    sectionId === 'openingEvent' ||
-    sectionId === 'understandingShift' ||
-    sectionId === 'description' ||
-    sceneActField === 'summary' ||
-    sceneActField === 'encounterNpcIds' ||
-    sceneActField === 'actGoal' ||
-    sceneActField === 'transitionHook'
-  );
-}
-
-export function CustomWorldDraftEditPanel({
-  detail,
-  disabled = false,
-  onSave,
-  onCancel,
-}: CustomWorldDraftEditPanelProps) {
-  const editableSections = useMemo(
-    () =>
-      detail.sections.filter((section) =>
-        detail.editableSectionIds.includes(section.id),
-      ),
-    [detail],
-  );
-  const [draftValues, setDraftValues] = useState<Record<string, string>>(() =>
-    Object.fromEntries(
-      editableSections.map((section) => [section.id, section.value]),
-    ),
-  );
-
-  useEffect(() => {
-    setDraftValues(
-      Object.fromEntries(editableSections.map((section) => [section.id, section.value])),
-    );
-  }, [editableSections]);
-
-  if (editableSections.length === 0) {
-    return null;
-  }
-
-  return (
-    <div className="space-y-3">
-      {editableSections.map((section) => {
-        const value = draftValues[section.id] ?? '';
-        const multiline = shouldUseTextarea(section.id, value);
-
-        return (
-          <label
-            key={section.id}
-            className="block rounded-[1.1rem] border border-white/8 bg-white/5 px-3 py-3"
-          >
-            <div className="text-[11px] tracking-[0.16em] text-zinc-400">
-              {section.label}
-            </div>
-            {multiline ? (
-              <textarea
-                value={value}
-                onChange={(event) => {
-                  const nextValue = event.target.value;
-                  setDraftValues((current) => ({
-                    ...current,
-                    [section.id]: nextValue,
-                  }));
-                }}
-                rows={4}
-                disabled={disabled}
-                className="mt-2 w-full resize-none rounded-[0.9rem] border border-white/10 bg-black/26 px-3 py-3 text-sm leading-7 text-white outline-none transition focus:border-sky-400/40 disabled:cursor-not-allowed disabled:opacity-60"
-              />
-            ) : (
-              <input
-                type="text"
-                value={value}
-                onChange={(event) => {
-                  const nextValue = event.target.value;
-                  setDraftValues((current) => ({
-                    ...current,
-                    [section.id]: nextValue,
-                  }));
-                }}
-                disabled={disabled}
-                className="mt-2 h-11 w-full rounded-[0.9rem] border border-white/10 bg-black/26 px-3 text-sm text-white outline-none transition focus:border-sky-400/40 disabled:cursor-not-allowed disabled:opacity-60"
-              />
-            )}
-          </label>
-        );
-      })}
-
-      <div className="flex items-center justify-end gap-3">
-        <button
-          type="button"
-          onClick={onCancel}
-          disabled={disabled}
-          className="rounded-full border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-200 transition hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-        >
-          取消
-        </button>
-        <button
-          type="button"
-          onClick={() => {
-            onSave(
-              editableSections.map((section) => ({
-                sectionId: section.id,
-                value: draftValues[section.id] ?? '',
-              })),
-            );
-          }}
-          disabled={disabled}
-          className="rounded-full border border-sky-300/20 bg-sky-500/10 px-4 py-2 text-sm font-medium text-sky-100 transition hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-        >
-          保存
-        </button>
-      </div>
-    </div>
-  );
-}
diff --git a/src/components/custom-world-agent/CustomWorldGenerateEntityModal.tsx b/src/components/custom-world-agent/CustomWorldGenerateEntityModal.tsx
deleted file mode 100644
index 8d2a3e1a..00000000
--- a/src/components/custom-world-agent/CustomWorldGenerateEntityModal.tsx
+++ /dev/null
@@ -1,139 +0,0 @@
-import { useEffect, useState } from 'react';
-
-type CustomWorldGenerateEntityModalProps = {
-  open: boolean;
-  mode: 'character' | 'landmark';
-  anchorCardTitle?: string | null;
-  disabled?: boolean;
-  onClose: () => void;
-  onSubmit: (payload: {
-    count: number;
-    promptText: string;
-  }) => void;
-};
-
-export function CustomWorldGenerateEntityModal({
-  open,
-  mode,
-  anchorCardTitle,
-  disabled = false,
-  onClose,
-  onSubmit,
-}: CustomWorldGenerateEntityModalProps) {
-  const [count, setCount] = useState(2);
-  const [promptText, setPromptText] = useState('');
-
-  useEffect(() => {
-    if (!open) {
-      return;
-    }
-
-    setCount(2);
-    setPromptText('');
-  }, [open, mode]);
-
-  if (!open) {
-    return null;
-  }
-
-  const title = mode === 'character' ? '新增角色' : '新增场景';
-  const submitLabel = mode === 'character' ? '生成角色' : '生成场景';
-
-  return (
-    <div className="platform-overlay fixed inset-0 z-[96] flex items-end justify-center p-3 backdrop-blur-sm sm:items-center">
-      <button
-        type="button"
-        aria-label="关闭新增弹窗"
-        onClick={onClose}
-        className="absolute inset-0 cursor-default"
-      />
-      <div className="platform-modal-shell platform-remap-surface relative z-10 w-full max-w-xl rounded-[1.8rem] px-4 py-4 shadow-[0_18px_60px_rgba(0,0,0,0.35)] sm:px-5 sm:py-5">
-        <div className="flex items-start justify-between gap-3">
-          <div>
-            <div className="text-[11px] font-bold tracking-[0.2em] text-zinc-400">
-              AI 扩写
-            </div>
-            <div className="mt-2 text-lg font-semibold text-white">{title}</div>
-          </div>
-          <button
-            type="button"
-            onClick={onClose}
-            disabled={disabled}
-            className="rounded-full border border-white/10 bg-black/20 px-3 py-1 text-[11px] text-zinc-300 transition hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            关闭
-          </button>
-        </div>
-
-        <div className="mt-4 space-y-4">
-          {anchorCardTitle ? (
-            <div className="rounded-[1.1rem] border border-white/8 bg-white/5 px-3 py-3">
-              <div className="text-[11px] tracking-[0.16em] text-zinc-400">
-                当前参考卡
-              </div>
-              <div className="mt-2 text-sm text-zinc-100">{anchorCardTitle}</div>
-            </div>
-          ) : null}
-
-          <div className="rounded-[1.1rem] border border-white/8 bg-white/5 px-3 py-3">
-            <div className="text-[11px] tracking-[0.16em] text-zinc-400">数量</div>
-            <div className="mt-3 flex gap-2">
-              {[1, 2, 3].map((value) => (
-                <button
-                  key={value}
-                  type="button"
-                  onClick={() => setCount(value)}
-                  disabled={disabled}
-                  className={`rounded-full border px-4 py-2 text-sm transition ${
-                    count === value
-                      ? 'border-sky-300/20 bg-sky-500/10 text-sky-100'
-                      : 'border-white/10 bg-black/20 text-zinc-300 hover:text-white'
-                  } disabled:cursor-not-allowed disabled:opacity-45`}
-                >
-                  {value}
-                </button>
-              ))}
-            </div>
-          </div>
-
-          <label className="block rounded-[1.1rem] border border-white/8 bg-white/5 px-3 py-3">
-            <div className="text-[11px] tracking-[0.16em] text-zinc-400">
-              补充要求
-            </div>
-            <textarea
-              value={promptText}
-              onChange={(event) => setPromptText(event.target.value)}
-              rows={5}
-              disabled={disabled}
-              className="mt-2 w-full resize-none rounded-[0.9rem] border border-white/10 bg-black/26 px-3 py-3 text-sm leading-7 text-white outline-none transition focus:border-sky-400/40 disabled:cursor-not-allowed disabled:opacity-60"
-            />
-          </label>
-        </div>
-
-        <div className="mt-4 flex items-center justify-end gap-3">
-          <button
-            type="button"
-            onClick={onClose}
-            disabled={disabled}
-            className="rounded-full border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-200 transition hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            取消
-          </button>
-          <button
-            type="button"
-            onClick={() => {
-              onSubmit({
-                count,
-                promptText: promptText.trim(),
-              });
-            }}
-            disabled={disabled}
-            className="rounded-full border border-sky-300/20 bg-sky-500/10 px-4 py-2 text-sm font-medium text-sky-100 transition hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            {submitLabel}
-          </button>
-        </div>
-      </div>
-    </div>
-  );
-}
diff --git a/src/components/custom-world-home/CustomWorldCreationHub.tsx b/src/components/custom-world-home/CustomWorldCreationHub.tsx
index e4f4e97c..eaae45e5 100644
--- a/src/components/custom-world-home/CustomWorldCreationHub.tsx
+++ b/src/components/custom-world-home/CustomWorldCreationHub.tsx
@@ -21,8 +21,10 @@ type CustomWorldCreationHubProps = {
 
 function EmptyState({ title }: { title: string }) {
   return (
-    <div className="platform-remap-surface flex min-h-[16rem] flex-col items-center justify-center rounded-[1.8rem] border border-white/8 bg-white/5 px-6 py-8 text-center">
-      <div className="text-lg font-semibold text-white">{title}</div>
+    <div className="platform-subpanel flex min-h-[14rem] flex-col items-center justify-center rounded-[1.6rem] px-6 py-8 text-center">
+      <div className="text-lg font-semibold text-[var(--platform-text-strong)]">
+        {title}
+      </div>
     </div>
   );
 }
@@ -52,35 +54,26 @@ export function CustomWorldCreationHub({
   );
 
   return (
-    <div
-      className="flex h-full min-h-0 flex-col overflow-y-auto overscroll-y-contain pr-1 pb-[max(1rem,env(safe-area-inset-bottom))]"
-      style={{ WebkitOverflowScrolling: 'touch' }}
-    >
-      <div
-        className="platform-remap-surface sticky top-0 z-20 -mx-3 px-3 pb-4 pt-1 sm:static sm:mx-0 sm:bg-none sm:px-0 sm:pb-5 sm:pt-0"
-        style={{
-          background:
-            'linear-gradient(180deg, var(--platform-modal-fill), transparent)',
-        }}
-      >
+    <div className="platform-page-stage platform-remap-surface space-y-4 px-3 pb-4 pt-3 sm:px-4 sm:pt-4">
+      <div className="pb-1">
         <div className="flex items-start justify-between gap-3">
           <div>
             <button
               type="button"
               onClick={onBack}
-              className="rounded-full border border-white/10 bg-black/18 px-3 py-1.5 text-[11px] text-zinc-300 transition-colors hover:text-white"
+              className="platform-button platform-button--ghost min-h-0 rounded-full px-3 py-1.5 text-[11px]"
             >
               返回
             </button>
-            <div className="mt-4 text-[1.8rem] font-black leading-tight text-white sm:text-[2.3rem]">
+            <div className="mt-4 text-[1.8rem] font-black leading-tight text-[var(--platform-text-strong)] sm:text-[2.3rem]">
               创作中心
             </div>
           </div>
           <div className="hidden shrink-0 gap-2 sm:flex">
-            <span className="rounded-full border border-amber-300/20 bg-amber-500/10 px-3 py-1 text-[11px] text-amber-100">
+            <span className="platform-pill platform-pill--warm px-3 py-1 text-[11px]">
               草稿 {draftCount}
             </span>
-            <span className="rounded-full border border-emerald-300/20 bg-emerald-500/10 px-3 py-1 text-[11px] text-emerald-100">
+            <span className="platform-pill platform-pill--success px-3 py-1 text-[11px]">
               已发布 {publishedCount}
             </span>
           </div>
@@ -98,12 +91,12 @@ export function CustomWorldCreationHub({
         />
 
         {error ? (
-          <div className="rounded-3xl border border-rose-400/18 bg-rose-500/10 px-4 py-4 text-sm leading-7 text-rose-100">
+          <div className="platform-banner platform-banner--danger rounded-[1.4rem] px-4 py-4 text-sm leading-7">
             <div>{error}</div>
             <button
               type="button"
               onClick={onRetry}
-              className="mt-3 rounded-full border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-200 transition hover:text-white"
+              className="platform-button platform-button--ghost mt-3 min-h-0 rounded-full px-4 py-2 text-sm"
             >
               重试
             </button>
@@ -115,15 +108,15 @@ export function CustomWorldCreationHub({
             {Array.from({ length: 3 }).map((_, index) => (
               <div
                 key={`skeleton-${index}`}
-                className="min-h-[12rem] rounded-[1.8rem] border border-white/8 bg-white/5 p-5"
+                className="platform-subpanel min-h-[12rem] rounded-[1.6rem] p-5"
               >
-                <div className="h-4 w-20 rounded-full bg-white/10" />
-                <div className="mt-6 h-8 w-36 rounded-full bg-white/10" />
-                <div className="mt-4 h-4 w-full rounded-full bg-white/10" />
-                <div className="mt-2 h-4 w-4/5 rounded-full bg-white/10" />
+                <div className="h-4 w-20 rounded-full bg-[var(--platform-track-fill)]" />
+                <div className="mt-6 h-8 w-36 rounded-full bg-[var(--platform-track-fill)]" />
+                <div className="mt-4 h-4 w-full rounded-full bg-[var(--platform-track-fill)]" />
+                <div className="mt-2 h-4 w-4/5 rounded-full bg-[var(--platform-track-fill)]" />
                 <div className="mt-8 flex gap-2">
-                  <div className="h-7 w-20 rounded-full bg-white/10" />
-                  <div className="h-7 w-20 rounded-full bg-white/10" />
+                  <div className="h-7 w-20 rounded-full bg-[var(--platform-track-fill)]" />
+                  <div className="h-7 w-20 rounded-full bg-[var(--platform-track-fill)]" />
                 </div>
               </div>
             ))}
diff --git a/src/components/custom-world-home/CustomWorldCreationLauncherModal.tsx b/src/components/custom-world-home/CustomWorldCreationLauncherModal.tsx
deleted file mode 100644
index 0e97d922..00000000
--- a/src/components/custom-world-home/CustomWorldCreationLauncherModal.tsx
+++ /dev/null
@@ -1,146 +0,0 @@
-import { X } from 'lucide-react';
-
-import type { CustomWorldQuestion } from '../../../packages/shared/src/contracts/runtime';
-
-type CustomWorldCreationLauncherModalProps = {
-  isOpen: boolean;
-  mode: 'create' | 'resume';
-  seedText: string;
-  seedTextLocked: boolean;
-  questions: CustomWorldQuestion[];
-  answers: Record<string, string>;
-  isBusy: boolean;
-  error: string | null;
-  lastError?: string | null;
-  primaryLabel: string;
-  onClose: () => void;
-  onSeedTextChange: (value: string) => void;
-  onAnswerChange: (questionId: string, value: string) => void;
-  onPrimaryAction: () => void;
-};
-
-export function CustomWorldCreationLauncherModal({
-  isOpen,
-  mode,
-  seedText,
-  seedTextLocked,
-  questions,
-  answers,
-  isBusy,
-  error,
-  lastError = null,
-  primaryLabel,
-  onClose,
-  onSeedTextChange,
-  onAnswerChange,
-  onPrimaryAction,
-}: CustomWorldCreationLauncherModalProps) {
-  if (!isOpen) {
-    return null;
-  }
-
-  const unansweredQuestions = questions.filter((question) => !question.answer?.trim());
-
-  return (
-    <div className="platform-overlay fixed inset-0 z-[90] flex items-center justify-center p-4 backdrop-blur-sm">
-      <div className="platform-modal-shell platform-remap-surface flex max-h-[92vh] w-full max-w-2xl flex-col overflow-hidden rounded-[2rem] shadow-[0_30px_90px_rgba(0,0,0,0.6)]">
-        <div className="flex items-center justify-between border-b border-white/10 px-5 py-4">
-          <div>
-            <div className="text-base font-semibold text-white">
-              {mode === 'create' ? '新建作品' : '继续创作'}
-            </div>
-            <div className="mt-1 text-xs text-zinc-400">
-              输入一点灵感，开始共创一个新世界。
-            </div>
-          </div>
-          <button
-            type="button"
-            onClick={onClose}
-            disabled={isBusy}
-            className="rounded-full border border-white/10 bg-white/5 p-2 text-zinc-300 transition hover:bg-white/10 hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            <X className="h-4 w-4" />
-          </button>
-        </div>
-
-        <div className="min-h-0 flex-1 overflow-y-auto px-5 py-5">
-          <div className="space-y-4">
-            <label className="block">
-              <div className="mb-2 text-sm font-medium text-zinc-200">
-                世界灵感
-              </div>
-              <textarea
-                value={seedText}
-                onChange={(event) => onSeedTextChange(event.target.value)}
-                rows={seedTextLocked ? 4 : 6}
-                readOnly={seedTextLocked}
-                placeholder="例：一个被潮雾切碎的列岛世界，灯塔守望者、沉船秘术与旧盟约残片正在重新苏醒。"
-                className={`w-full rounded-3xl border border-white/10 bg-black/30 px-4 py-3 text-sm leading-7 text-white outline-none transition focus:border-sky-400/40 ${
-                  seedTextLocked ? 'cursor-not-allowed opacity-75' : ''
-                }`}
-              />
-            </label>
-
-            {unansweredQuestions.length > 0 ? (
-              <div className="space-y-3">
-                <div className="rounded-3xl border border-white/10 bg-black/20 px-4 py-3 text-sm leading-7 text-zinc-300">
-                  先补齐几条关键锚点，再开始生成。
-                </div>
-                {unansweredQuestions.map((question) => (
-                  <label key={question.id} className="block">
-                    <div className="mb-2 text-sm font-medium text-zinc-200">
-                      {question.label}
-                    </div>
-                    <div className="mb-2 text-xs leading-6 text-zinc-400">
-                      {question.question}
-                    </div>
-                    <textarea
-                      value={answers[question.id] ?? question.answer ?? ''}
-                      onChange={(event) =>
-                        onAnswerChange(question.id, event.target.value)
-                      }
-                      rows={3}
-                      placeholder="补充一句就可以。"
-                      className="w-full rounded-3xl border border-white/10 bg-black/30 px-4 py-3 text-sm leading-7 text-white outline-none transition focus:border-sky-400/40"
-                    />
-                  </label>
-                ))}
-              </div>
-            ) : null}
-
-            {lastError ? (
-              <div className="rounded-3xl border border-amber-400/25 bg-amber-500/10 px-4 py-3 text-sm leading-6 text-amber-100">
-                上次生成未完成：{lastError}
-              </div>
-            ) : null}
-
-            {error ? (
-              <div className="rounded-3xl border border-rose-400/25 bg-rose-500/10 px-4 py-3 text-sm leading-6 text-rose-100">
-                {error}
-              </div>
-            ) : null}
-          </div>
-        </div>
-
-        <div className="flex flex-wrap items-center justify-end gap-3 border-t border-white/10 px-5 py-4">
-          <button
-            type="button"
-            onClick={onClose}
-            disabled={isBusy}
-            className="rounded-2xl border border-white/10 bg-white/5 px-4 py-2 text-sm text-zinc-300 transition hover:bg-white/10 hover:text-white disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            取消
-          </button>
-          <button
-            type="button"
-            onClick={onPrimaryAction}
-            disabled={isBusy}
-            className="rounded-2xl bg-sky-400 px-4 py-2 text-sm font-semibold text-slate-950 transition hover:bg-sky-300 disabled:cursor-not-allowed disabled:opacity-45"
-          >
-            {isBusy ? '处理中...' : primaryLabel}
-          </button>
-        </div>
-      </div>
-    </div>
-  );
-}
diff --git a/src/components/custom-world-home/CustomWorldCreationStartCard.tsx b/src/components/custom-world-home/CustomWorldCreationStartCard.tsx
index e87d5b5e..2a8cee3d 100644
--- a/src/components/custom-world-home/CustomWorldCreationStartCard.tsx
+++ b/src/components/custom-world-home/CustomWorldCreationStartCard.tsx
@@ -1,5 +1,3 @@
-import { getNineSliceStyle, UI_CHROME } from '../../uiAssets';
-
 type CustomWorldCreationStartCardProps = {
   onCreateNew: () => void;
 };
@@ -8,35 +6,22 @@ export function CustomWorldCreationStartCard({
   onCreateNew,
 }: CustomWorldCreationStartCardProps) {
   return (
-    <div
-      className="pixel-nine-slice pixel-panel overflow-hidden"
-      style={getNineSliceStyle(UI_CHROME.storyPanel, {
-        paddingX: 18,
-        paddingY: 16,
-      })}
-    >
-      <div className="relative overflow-hidden rounded-[1.75rem] border border-white/8 bg-[radial-gradient(circle_at_top_left,rgba(125,211,252,0.18),transparent_36%),linear-gradient(180deg,rgba(8,10,14,0.28),rgba(8,10,14,0.82))] px-5 py-5">
-        <div className="flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between">
-          <div>
-            <div className="text-2xl font-black text-white sm:text-3xl">
-              新建作品
-            </div>
+    <div className="platform-surface platform-surface--hero relative overflow-hidden px-5 py-5">
+      <div className="absolute inset-0 bg-[var(--platform-hero-overlay-strong)]" />
+      <div className="relative z-10 flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between">
+        <div>
+          <div className="text-2xl font-black text-white sm:text-3xl">
+            新建作品
           </div>
-          <button
-            type="button"
-            onClick={onCreateNew}
-            className="pixel-nine-slice pixel-pressable w-full text-left sm:w-auto"
-            style={getNineSliceStyle(UI_CHROME.choiceButton, {
-              paddingX: 18,
-              paddingY: 11,
-            })}
-          >
-            <div className="flex items-center justify-between gap-4">
-              <span className="text-sm font-semibold text-white">新建作品</span>
-              <span className="text-white/60">→</span>
-            </div>
-          </button>
         </div>
+        <button
+          type="button"
+          onClick={onCreateNew}
+          className="platform-button platform-button--primary w-full justify-between rounded-[1.1rem] text-left sm:w-auto"
+        >
+          <span className="text-sm font-semibold">新建作品</span>
+          <span aria-hidden="true">→</span>
+        </button>
       </div>
     </div>
   );
diff --git a/src/components/custom-world-home/CustomWorldWorkCard.tsx b/src/components/custom-world-home/CustomWorldWorkCard.tsx
index 7475a9d2..42294958 100644
--- a/src/components/custom-world-home/CustomWorldWorkCard.tsx
+++ b/src/components/custom-world-home/CustomWorldWorkCard.tsx
@@ -1,6 +1,5 @@
 import type { CustomWorldWorkSummary } from '../../../packages/shared/src/contracts/customWorldAgent';
 import { CustomWorldCoverArtwork } from '../CustomWorldCoverArtwork';
-import { getNineSliceStyle, UI_CHROME } from '../../uiAssets';
 
 function formatUpdatedAt(value: string) {
   const date = new Date(value);
@@ -31,76 +30,71 @@ export function CustomWorldWorkCard({
   const roleCountLabel = isDraft ? '角色' : '可扮演角色';
 
   return (
-    <div
-      className="pixel-nine-slice pixel-panel relative overflow-hidden"
-      style={getNineSliceStyle(UI_CHROME.panel, {
-        paddingX: 16,
-        paddingY: 15,
-      })}
-    >
+    <div className="platform-surface platform-interactive-card relative min-h-[13.5rem] overflow-hidden px-4 py-4 sm:min-h-[14rem]">
       <CustomWorldCoverArtwork
         imageSrc={item.coverImageSrc}
         title={item.title}
-        fallbackLabel={item.title.slice(0, 4) || '封面'}
+        fallbackLabel="封面"
         renderMode={item.coverRenderMode}
         characterImageSrcs={item.coverCharacterImageSrcs}
-        className="absolute inset-0"
+        className="platform-cover-artwork absolute inset-0"
       />
+      <div className="absolute inset-0 bg-[var(--platform-card-overlay-strong)]" />
       <div className="relative z-10 flex h-full min-h-[12rem] flex-col">
         <div className="flex items-start justify-between gap-3">
           <div className="flex flex-wrap gap-2">
             <span
-              className={`rounded-full border px-3 py-1 text-[10px] tracking-[0.18em] ${
+              className={`platform-pill px-3 py-1 text-[10px] ${
                 isDraft
-                  ? 'border-amber-300/20 bg-amber-500/10 text-amber-100'
-                  : 'border-emerald-300/20 bg-emerald-500/10 text-emerald-100'
+                  ? 'platform-pill--warm'
+                  : 'platform-pill--success'
               }`}
             >
               {isDraft ? '草稿' : '已发布'}
             </span>
             {item.stageLabel ? (
-              <span className="rounded-full border border-white/10 bg-black/24 px-3 py-1 text-[10px] text-zinc-200">
+              <span className="platform-pill platform-pill--neutral px-3 py-1 text-[10px]">
                 {item.stageLabel}
               </span>
             ) : null}
           </div>
-          <div className="text-[11px] text-zinc-400">
+          <div className="shrink-0 text-[11px] text-[var(--platform-text-soft)]">
             {formatUpdatedAt(item.updatedAt)}
           </div>
         </div>
 
         <div className="mt-4">
-          <div className="text-2xl font-black text-white">
+          <div className="text-2xl font-black text-[var(--platform-text-strong)]">
             {item.title}
           </div>
-          <div className="mt-1 text-xs tracking-[0.12em] text-zinc-400">
+          <div className="mt-1 text-xs tracking-[0.12em] text-[var(--platform-text-soft)]">
             {item.subtitle}
           </div>
-          <div className="mt-3 line-clamp-3 text-sm leading-7 text-zinc-200/90">
+          <div className="mt-3 line-clamp-3 text-sm leading-7 text-[color:color-mix(in_srgb,var(--platform-text-base)_92%,transparent)]">
             {item.summary}
           </div>
         </div>
 
-        <div className="mt-auto flex items-center justify-between gap-3 pt-4">
+        <div className="mt-auto flex flex-col gap-3 pt-4 sm:flex-row sm:items-center sm:justify-between">
           <div className="flex flex-wrap gap-2">
-            <span className="rounded-full border border-white/10 bg-black/24 px-3 py-1 text-[10px] text-zinc-100">
+            <span className="platform-pill platform-pill--neutral px-3 py-1 text-[10px]">
               {roleCountLabel} {item.playableNpcCount}
             </span>
-            <span className="rounded-full border border-white/10 bg-black/24 px-3 py-1 text-[10px] text-zinc-100">
+            <span className="platform-pill platform-pill--neutral px-3 py-1 text-[10px]">
               地点 {item.landmarkCount}
             </span>
             {item.roleVisualReadyCount ? (
-              <span className="rounded-full border border-amber-300/20 bg-amber-500/10 px-3 py-1 text-[10px] text-amber-100">
+              <span className="platform-pill platform-pill--warm px-3 py-1 text-[10px]">
                 主图 {item.roleVisualReadyCount}
               </span>
             ) : null}
             {item.roleAnimationReadyCount ? (
-              <span className="rounded-full border border-emerald-300/20 bg-emerald-500/10 px-3 py-1 text-[10px] text-emerald-100">
+              <span className="platform-pill platform-pill--success px-3 py-1 text-[10px]">
                 动作 {item.roleAnimationReadyCount}
               </span>
             ) : null}
             {item.roleAssetSummaryLabel ? (
-              <span className="rounded-full border border-white/10 bg-black/24 px-3 py-1 text-[10px] text-zinc-200">
+              <span className="platform-pill platform-pill--neutral px-3 py-1 text-[10px]">
                 {item.roleAssetSummaryLabel}
               </span>
             ) : null}
@@ -108,7 +102,7 @@ export function CustomWorldWorkCard({
           <button
             type="button"
             onClick={onClick}
-            className="rounded-full border border-sky-300/20 bg-sky-500/10 px-4 py-2 text-sm font-medium text-sky-100 transition hover:text-white"
+            className="platform-button platform-button--primary min-h-0 shrink-0 rounded-full px-4 py-2 text-sm"
           >
             {isDraft ? (hasFoundationDraft ? '继续精修' : '继续创作') : '进入世界'}
           </button>
diff --git a/src/components/custom-world-home/CustomWorldWorkTabs.tsx b/src/components/custom-world-home/CustomWorldWorkTabs.tsx
index 4127d7f6..328fd890 100644
--- a/src/components/custom-world-home/CustomWorldWorkTabs.tsx
+++ b/src/components/custom-world-home/CustomWorldWorkTabs.tsx
@@ -23,7 +23,7 @@ export function CustomWorldWorkTabs({
   onChange,
 }: CustomWorldWorkTabsProps) {
   return (
-    <div className="platform-remap-surface flex items-center gap-2 overflow-x-auto pb-1">
+    <div className="platform-remap-surface flex items-center gap-2 overflow-x-auto pb-1 scrollbar-hide">
       {FILTER_OPTIONS.map((option) => {
         const count =
           option.id === 'draft'
@@ -37,10 +37,8 @@ export function CustomWorldWorkTabs({
             key={option.id}
             type="button"
             onClick={() => onChange(option.id)}
-            className={`shrink-0 rounded-full border px-4 py-2 text-sm transition ${
-              activeFilter === option.id
-                ? 'border-sky-300/20 bg-sky-500/10 text-sky-100'
-                : 'border-white/10 bg-black/18 text-zinc-300 hover:text-white'
+            className={`platform-tab shrink-0 px-4 py-2 text-sm ${
+              activeFilter === option.id ? 'platform-tab--active' : ''
             }`}
           >
             {option.label} {count}
diff --git a/src/components/game-shell/PlatformHomeView.tsx b/src/components/game-shell/PlatformHomeView.tsx
index 3a0ae3ce..6fc20457 100644
--- a/src/components/game-shell/PlatformHomeView.tsx
+++ b/src/components/game-shell/PlatformHomeView.tsx
@@ -19,7 +19,13 @@ import {
   UserPlus,
   UserRound,
 } from 'lucide-react';
-import { type ComponentType, useMemo } from 'react';
+import {
+  type ComponentType,
+  type ReactNode,
+  useEffect,
+  useMemo,
+  useState,
+} from 'react';
 
 import type {
   CustomWorldGalleryCard,
@@ -52,6 +58,47 @@ const MOBILE_PAGE_STAGE_CLASS =
   'platform-page-stage platform-remap-surface space-y-4 pb-2';
 const DESKTOP_PAGE_STAGE_CLASS =
   'platform-page-stage platform-remap-surface space-y-5 pb-4';
+const DESKTOP_LAYOUT_QUERY = '(min-width: 1024px)';
+
+function usePlatformDesktopLayout() {
+  const [isDesktopLayout, setIsDesktopLayout] = useState(() => {
+    if (
+      typeof window === 'undefined' ||
+      typeof window.matchMedia !== 'function'
+    ) {
+      return false;
+    }
+
+    return window.matchMedia(DESKTOP_LAYOUT_QUERY).matches;
+  });
+
+  useEffect(() => {
+    if (
+      typeof window === 'undefined' ||
+      typeof window.matchMedia !== 'function'
+    ) {
+      return;
+    }
+
+    const mediaQuery = window.matchMedia(DESKTOP_LAYOUT_QUERY);
+    const updateLayout = (event?: MediaQueryListEvent) => {
+      setIsDesktopLayout(event?.matches ?? mediaQuery.matches);
+    };
+
+    updateLayout();
+
+    // 平台页只挂载当前断点外壳，避免隐藏的移动端/桌面端内容重复抢占查询。
+    if (typeof mediaQuery.addEventListener === 'function') {
+      mediaQuery.addEventListener('change', updateLayout);
+      return () => mediaQuery.removeEventListener('change', updateLayout);
+    }
+
+    mediaQuery.addListener(updateLayout);
+    return () => mediaQuery.removeListener(updateLayout);
+  }, []);
+
+  return isDesktopLayout;
+}
 
 function SectionHeader({ title, detail }: { title: string; detail: string }) {
   return (
@@ -653,6 +700,7 @@ export function PlatformHomeView({
   onOpenGalleryDetail,
   onOpenLibraryDetail,
   onOpenProfileDashboardCard,
+  createTabContent,
 }: {
   activeTab: PlatformHomeTab;
   onTabChange: (tab: PlatformHomeTab) => void;
@@ -679,9 +727,11 @@ export function PlatformHomeView({
     entry: CustomWorldLibraryEntry<CustomWorldProfile>,
   ) => void;
   onOpenProfileDashboardCard?: (cardKey: ProfileDashboardCardKey) => void;
+  createTabContent?: ReactNode;
 }) {
   const authUi = useAuthUi();
   const isAuthenticated = Boolean(authUi?.user);
+  const isDesktopLayout = usePlatformDesktopLayout();
   const featuredShelf = useMemo(
     () => featuredEntries.slice(0, 6),
     [featuredEntries],
@@ -732,7 +782,7 @@ export function PlatformHomeView({
   const desktopReleaseGrid = latestEntries.slice(0, 6);
   const desktopLibraryPreview = myEntries.slice(0, 2);
 
-  let content = (
+  let content: ReactNode = (
     <div className={MOBILE_PAGE_STAGE_CLASS}>
       <button
         type="button"
@@ -824,59 +874,62 @@ export function PlatformHomeView({
   );
 
   if (activeTab === 'create') {
-    content = (
-      <div className={MOBILE_PAGE_STAGE_CLASS}>
-        <button
-          type="button"
-          onClick={onOpenCreateTypePicker}
-          className={`${HERO_SURFACE_CLASS} relative block w-full overflow-hidden px-[18px] py-4 text-left`}
-        >
-          <div className="absolute inset-0 bg-[var(--platform-hero-overlay-strong)]" />
-          <div className="relative z-10 flex min-h-[10rem] flex-col justify-between">
-            <span className="platform-pill platform-pill--cool w-fit">
-              CREATE
-            </span>
-            <div>
-              <div className="text-3xl font-black text-white">开启新的创作</div>
-              <div className="mt-2 max-w-[28rem] text-sm leading-6 text-zinc-200/88">
-                先选择游戏类型，再进入对应的创作工作台继续推进。
-              </div>
-              <div className="mt-4 flex items-center gap-2 text-sm font-semibold text-white/90">
-                <span>选择类型并继续</span>
-                <ArrowRight className="h-4 w-4" />
+    content =
+      createTabContent ?? (
+        <div className={MOBILE_PAGE_STAGE_CLASS}>
+          <button
+            type="button"
+            onClick={onOpenCreateTypePicker}
+            className={`${HERO_SURFACE_CLASS} relative block w-full overflow-hidden px-[18px] py-4 text-left`}
+          >
+            <div className="absolute inset-0 bg-[var(--platform-hero-overlay-strong)]" />
+            <div className="relative z-10 flex min-h-[10rem] flex-col justify-between">
+              <span className="platform-pill platform-pill--cool w-fit">
+                CREATE
+              </span>
+              <div>
+                <div className="text-3xl font-black text-white">
+                  开启新的创作
+                </div>
+                <div className="mt-2 max-w-[28rem] text-sm leading-6 text-zinc-200/88">
+                  先选择游戏类型，再进入对应的创作工作台继续推进。
+                </div>
+                <div className="mt-4 flex items-center gap-2 text-sm font-semibold text-white/90">
+                  <span>选择类型并继续</span>
+                  <ArrowRight className="h-4 w-4" />
+                </div>
               </div>
             </div>
-          </div>
-        </button>
+          </button>
 
-        <section>
-          <SectionHeader title="我的创作" detail="草稿与已发布" />
-          {isLoadingPlatform ? (
-            <EmptyShelf text="正在读取你的作品..." />
-          ) : myEntries.length > 0 ? (
-            <div className="grid grid-cols-2 gap-2.5 sm:gap-3 xl:grid-cols-3">
-              {myEntries.map(
-                (entry: CustomWorldLibraryEntry<CustomWorldProfile>) => (
-                  <CreationLibraryCard
-                    key={`${entry.ownerUserId}:${entry.profileId}:mine`}
-                    entry={entry}
-                    onClick={() => onOpenLibraryDetail(entry)}
-                  />
-                ),
-              )}
-            </div>
-          ) : (
-            <EmptyShelf
-              text={
-                isAuthenticated
-                  ? '你还没有保存任何自定义世界，先创建一个草稿开始吧。'
-                  : '登录后查看你的作品。'
-              }
-            />
-          )}
-        </section>
-      </div>
-    );
+          <section>
+            <SectionHeader title="我的创作" detail="草稿与已发布" />
+            {isLoadingPlatform ? (
+              <EmptyShelf text="正在读取你的作品..." />
+            ) : myEntries.length > 0 ? (
+              <div className="grid grid-cols-2 gap-2.5 sm:gap-3 xl:grid-cols-3">
+                {myEntries.map(
+                  (entry: CustomWorldLibraryEntry<CustomWorldProfile>) => (
+                    <CreationLibraryCard
+                      key={`${entry.ownerUserId}:${entry.profileId}:mine`}
+                      entry={entry}
+                      onClick={() => onOpenLibraryDetail(entry)}
+                    />
+                  ),
+                )}
+              </div>
+            ) : (
+              <EmptyShelf
+                text={
+                  isAuthenticated
+                    ? '你还没有保存任何自定义世界，先创建一个草稿开始吧。'
+                    : '登录后查看你的作品。'
+                }
+              />
+            )}
+          </section>
+        </div>
+      );
   }
 
   if (activeTab === 'saves') {
@@ -1117,7 +1170,7 @@ export function PlatformHomeView({
     );
   }
 
-  const desktopContent =
+  const desktopContent: ReactNode =
     activeTab === 'home' ? (
       <div className={DESKTOP_PAGE_STAGE_CLASS}>
         {platformError ? (
@@ -1415,9 +1468,9 @@ export function PlatformHomeView({
       content
     );
 
-  return (
-    <div className="flex h-full min-h-0 flex-col">
-      <div className="flex h-full min-h-0 flex-col lg:hidden">
+  if (!isDesktopLayout) {
+    return (
+      <div className="flex h-full min-h-0 flex-col">
         <div className="mb-4">
           <PlatformBrandLogo />
         </div>
@@ -1461,8 +1514,12 @@ export function PlatformHomeView({
           </div>
         </div>
       </div>
+    );
+  }
 
-      <div className="hidden h-full min-h-0 lg:flex lg:flex-col">
+  return (
+    <div className="flex h-full min-h-0 flex-col">
+      <div className="flex h-full min-h-0 flex-col">
         <div className="platform-desktop-shell flex h-full min-h-0 flex-col p-5 xl:p-6">
           <div className="platform-desktop-topbar flex items-center gap-4 px-5 py-4">
             <div className="flex min-w-0 flex-1 items-center gap-5">
diff --git a/src/components/game-shell/PreGameSelectionFlow.tsx b/src/components/game-shell/PreGameSelectionFlow.tsx
index a2f06cbf..56a438fe 100644
--- a/src/components/game-shell/PreGameSelectionFlow.tsx
+++ b/src/components/game-shell/PreGameSelectionFlow.tsx
@@ -1540,6 +1540,64 @@ export function PreGameSelectionFlow({
     customWorldWorkEntries.length > 0
       ? customWorldWorkEntries
       : buildCreationHubFallbackItems(savedCustomWorldEntries);
+  const creationHubContent = (
+    <CustomWorldCreationHub
+      items={creationHubItems}
+      loading={isLoadingPlatform}
+      error={isLoadingPlatform ? null : (platformError ?? creationTypeError)}
+      onBack={() => {
+        setPlatformTab('home');
+      }}
+      onRetry={() => {
+        setPlatformError(null);
+        void refreshCustomWorldWorks().catch((error) => {
+          setPlatformError(
+            resolveErrorMessage(error, '读取创作作品列表失败。'),
+          );
+        });
+      }}
+      onCreateNew={openCreationTypePicker}
+      onResumeDraft={(sessionId) => {
+        runProtectedAction(() => {
+          void handleOpenCreationWork({
+            workId: `draft:${sessionId}`,
+            sourceType: 'agent_session',
+            status: 'draft',
+            title: '',
+            subtitle: '',
+            summary: '',
+            coverImageSrc: null,
+            coverRenderMode: 'image',
+            coverCharacterImageSrcs: [],
+            updatedAt: new Date().toISOString(),
+            publishedAt: null,
+            stage: null,
+            stageLabel: '',
+            playableNpcCount: 0,
+            landmarkCount: 0,
+            roleVisualReadyCount: 0,
+            roleAnimationReadyCount: 0,
+            roleAssetSummaryLabel: null,
+            sessionId,
+            profileId: null,
+            canResume: true,
+            canEnterWorld: false,
+          });
+        });
+      }}
+      onEnterPublished={(profileId) => {
+        runProtectedAction(() => {
+          const matchedWork = creationHubItems.find(
+            (entry) => entry.profileId === profileId,
+          );
+          if (!matchedWork) {
+            return;
+          }
+          void handleOpenCreationWork(matchedWork);
+        });
+      }}
+    />
+  );
 
   return (
     <>
@@ -1552,106 +1610,48 @@ export function PreGameSelectionFlow({
             exit={{ opacity: 0, y: -12 }}
             className="flex h-full min-h-0 flex-col"
           >
-            {platformTab === 'create' ? (
-              <CustomWorldCreationHub
-                items={creationHubItems}
-                loading={isLoadingPlatform}
-                error={isLoadingPlatform ? null : (platformError ?? creationTypeError)}
-                onBack={() => {
-                  setPlatformTab('home');
-                }}
-                onRetry={() => {
-                  setPlatformError(null);
-                  void refreshCustomWorldWorks().catch((error) => {
-                    setPlatformError(
-                      resolveErrorMessage(error, '读取创作作品列表失败。'),
-                    );
-                  });
-                }}
-                onCreateNew={openCreationTypePicker}
-                onResumeDraft={(sessionId) => {
-                  runProtectedAction(() => {
-                    void handleOpenCreationWork({
-                      workId: `draft:${sessionId}`,
-                      sourceType: 'agent_session',
-                      status: 'draft',
-                      title: '',
-                      subtitle: '',
-                      summary: '',
-                      coverImageSrc: null,
-                      coverRenderMode: 'image',
-                      coverCharacterImageSrcs: [],
-                      updatedAt: new Date().toISOString(),
-                      publishedAt: null,
-                      stage: null,
-                      stageLabel: '',
-                      playableNpcCount: 0,
-                      landmarkCount: 0,
-                      roleVisualReadyCount: 0,
-                      roleAnimationReadyCount: 0,
-                      roleAssetSummaryLabel: null,
-                      sessionId,
-                      profileId: null,
-                      canResume: true,
-                      canEnterWorld: false,
-                    });
-                  });
-                }}
-                onEnterPublished={(profileId) => {
-                  runProtectedAction(() => {
-                    const matchedWork = creationHubItems.find(
-                      (entry) => entry.profileId === profileId,
-                    );
-                    if (!matchedWork) {
-                      return;
-                    }
-                    void handleOpenCreationWork(matchedWork);
-                  });
-                }}
-              />
-            ) : (
-              <PlatformHomeView
-                activeTab={platformTab}
-                onTabChange={setPlatformTab}
-                hasSavedGame={hasSavedGame}
-                savedSnapshot={savedSnapshot}
-                saveEntries={saveEntries}
-                saveError={saveError}
-                featuredEntries={featuredGalleryEntries}
-                latestEntries={publishedGalleryEntries}
-                myEntries={savedCustomWorldEntries}
-                historyEntries={historyEntries}
-                profileDashboard={profileDashboard}
-                isLoadingPlatform={isLoadingPlatform}
-                isLoadingDashboard={isLoadingDashboard}
-                isResumingSaveWorldKey={isResumingSaveWorldKey}
-                platformError={
-                  isLoadingPlatform ? null : (platformError ?? creationTypeError)
+            <PlatformHomeView
+              activeTab={platformTab}
+              onTabChange={setPlatformTab}
+              hasSavedGame={hasSavedGame}
+              savedSnapshot={savedSnapshot}
+              saveEntries={saveEntries}
+              saveError={saveError}
+              featuredEntries={featuredGalleryEntries}
+              latestEntries={publishedGalleryEntries}
+              myEntries={savedCustomWorldEntries}
+              historyEntries={historyEntries}
+              profileDashboard={profileDashboard}
+              isLoadingPlatform={isLoadingPlatform}
+              isLoadingDashboard={isLoadingDashboard}
+              isResumingSaveWorldKey={isResumingSaveWorldKey}
+              platformError={
+                isLoadingPlatform ? null : (platformError ?? creationTypeError)
+              }
+              dashboardError={isLoadingDashboard ? null : dashboardError}
+              createTabContent={creationHubContent}
+              onContinueGame={handleContinueGame}
+              onResumeSave={(entry) => {
+                void handleResumeSaveEntry(entry);
+              }}
+              onOpenCreateWorld={openCustomWorldCreator}
+              onOpenCreateTypePicker={openCreationTypePicker}
+              onOpenGalleryDetail={(entry) => {
+                runProtectedAction(() => {
+                  void openGalleryDetail(entry);
+                });
+              }}
+              onOpenLibraryDetail={(entry) => {
+                runProtectedAction(() => {
+                  openLibraryDetail(entry);
+                });
+              }}
+              onOpenProfileDashboardCard={() => {
+                if (dashboardError) {
+                  void refreshProfileDashboard();
                 }
-                dashboardError={isLoadingDashboard ? null : dashboardError}
-                onContinueGame={handleContinueGame}
-                onResumeSave={(entry) => {
-                  void handleResumeSaveEntry(entry);
-                }}
-                onOpenCreateWorld={openCustomWorldCreator}
-                onOpenCreateTypePicker={openCreationTypePicker}
-                onOpenGalleryDetail={(entry) => {
-                  runProtectedAction(() => {
-                    void openGalleryDetail(entry);
-                  });
-                }}
-                onOpenLibraryDetail={(entry) => {
-                  runProtectedAction(() => {
-                    openLibraryDetail(entry);
-                  });
-                }}
-                onOpenProfileDashboardCard={() => {
-                  if (dashboardError) {
-                    void refreshProfileDashboard();
-                  }
-                }}
-              />
-            )}
+              }}
+            />
           </motion.div>
         )}
 
diff --git a/src/data/buildTagSimilarity.generated.ts b/src/data/buildTagSimilarity.generated.ts
deleted file mode 100644
index 36b8d237..00000000
--- a/src/data/buildTagSimilarity.generated.ts
+++ /dev/null
@@ -1,822 +0,0 @@
-export const BUILD_TAG_SIMILARITY_PAIRS: Array<readonly [string, string, number]> = [
-  ['快剑', '连段', 0.5652],
-  ['快剑', '突进', 0.639],
-  ['快剑', '追击', 0.5853],
-  ['快剑', '快袭', 0.7138],
-  ['快剑', '远射', 0.5732],
-  ['快剑', '游击', 0.5988],
-  ['快剑', '机动', 0.6052],
-  ['快剑', '风行', 0.6161],
-  ['快剑', '重击', 0.6202],
-  ['快剑', '爆发', 0.5647],
-  ['快剑', '破甲', 0.614],
-  ['快剑', '压制', 0.4927],
-  ['快剑', '压血', 0.4749],
-  ['快剑', '守御', 0.5533],
-  ['快剑', '护体', 0.4756],
-  ['快剑', '重甲', 0.5429],
-  ['快剑', '反击', 0.5565],
-  ['快剑', '镇邪', 0.4676],
-  ['快剑', '法修', 0.4834],
-  ['快剑', '法力', 0.4449],
-  ['快剑', '雷法', 0.5596],
-  ['快剑', '符阵', 0.502],
-  ['快剑', '控场', 0.4504],
-  ['快剑', '过载', 0.488],
-  ['快剑', '回复', 0.4804],
-  ['快剑', '护持', 0.4336],
-  ['快剑', '续战', 0.5132],
-  ['快剑', '命纹', 0.4916],
-  ['快剑', '机缘', 0.3826],
-  ['快剑', '冷却', 0.5143],
-  ['快剑', '统御', 0.4761],
-  ['快剑', '均衡', 0.4664],
-  ['快剑', '工巧', 0.4952],
-  ['快剑', '炼药', 0.496],
-  ['快剑', '先锋', 0.4771],
-  ['快剑', '狂战', 0.647],
-  ['快剑', '法剑', 0.7139],
-  ['快剑', '圣佑', 0.4072],
-  ['快剑', '堡垒', 0.5619],
-  ['快剑', '起手', 0.4805],
-  ['连段', '突进', 0.6269],
-  ['连段', '追击', 0.689],
-  ['连段', '快袭', 0.6255],
-  ['连段', '远射', 0.5834],
-  ['连段', '游击', 0.6451],
-  ['连段', '机动', 0.608],
-  ['连段', '风行', 0.5415],
-  ['连段', '重击', 0.6386],
-  ['连段', '爆发', 0.645],
-  ['连段', '破甲', 0.6281],
-  ['连段', '压制', 0.6701],
-  ['连段', '压血', 0.5097],
-  ['连段', '守御', 0.5739],
-  ['连段', '护体', 0.5288],
-  ['连段', '重甲', 0.5223],
-  ['连段', '反击', 0.6474],
-  ['连段', '镇邪', 0.4724],
-  ['连段', '法修', 0.5649],
-  ['连段', '法力', 0.5241],
-  ['连段', '雷法', 0.5451],
-  ['连段', '符阵', 0.5724],
-  ['连段', '控场', 0.6077],
-  ['连段', '过载', 0.5676],
-  ['连段', '回复', 0.5579],
-  ['连段', '护持', 0.5517],
-  ['连段', '续战', 0.6264],
-  ['连段', '命纹', 0.5979],
-  ['连段', '机缘', 0.4965],
-  ['连段', '冷却', 0.5609],
-  ['连段', '统御', 0.5969],
-  ['连段', '均衡', 0.5373],
-  ['连段', '工巧', 0.5193],
-  ['连段', '炼药', 0.5167],
-  ['连段', '先锋', 0.5145],
-  ['连段', '狂战', 0.5901],
-  ['连段', '法剑', 0.5712],
-  ['连段', '圣佑', 0.4439],
-  ['连段', '堡垒', 0.5764],
-  ['连段', '起手', 0.5323],
-  ['突进', '追击', 0.7523],
-  ['突进', '快袭', 0.7773],
-  ['突进', '远射', 0.681],
-  ['突进', '游击', 0.7741],
-  ['突进', '机动', 0.7414],
-  ['突进', '风行', 0.6838],
-  ['突进', '重击', 0.6753],
-  ['突进', '爆发', 0.679],
-  ['突进', '破甲', 0.7068],
-  ['突进', '压制', 0.6313],
-  ['突进', '压血', 0.5655],
-  ['突进', '守御', 0.6259],
-  ['突进', '护体', 0.5488],
-  ['突进', '重甲', 0.564],
-  ['突进', '反击', 0.6671],
-  ['突进', '镇邪', 0.5221],
-  ['突进', '法修', 0.5476],
-  ['突进', '法力', 0.4857],
-  ['突进', '雷法', 0.5302],
-  ['突进', '符阵', 0.6334],
-  ['突进', '控场', 0.5836],
-  ['突进', '过载', 0.6108],
-  ['突进', '回复', 0.589],
-  ['突进', '护持', 0.5765],
-  ['突进', '续战', 0.622],
-  ['突进', '命纹', 0.5123],
-  ['突进', '机缘', 0.546],
-  ['突进', '冷却', 0.5704],
-  ['突进', '统御', 0.5823],
-  ['突进', '均衡', 0.5443],
-  ['突进', '工巧', 0.5262],
-  ['突进', '炼药', 0.5517],
-  ['突进', '先锋', 0.6528],
-  ['突进', '狂战', 0.7068],
-  ['突进', '法剑', 0.5439],
-  ['突进', '圣佑', 0.4391],
-  ['突进', '堡垒', 0.6254],
-  ['突进', '起手', 0.6149],
-  ['追击', '快袭', 0.7158],
-  ['追击', '远射', 0.667],
-  ['追击', '游击', 0.7451],
-  ['追击', '机动', 0.6764],
-  ['追击', '风行', 0.6563],
-  ['追击', '重击', 0.65],
-  ['追击', '爆发', 0.6452],
-  ['追击', '破甲', 0.672],
-  ['追击', '压制', 0.6919],
-  ['追击', '压血', 0.5459],
-  ['追击', '守御', 0.6761],
-  ['追击', '护体', 0.6079],
-  ['追击', '重甲', 0.521],
-  ['追击', '反击', 0.7187],
-  ['追击', '镇邪', 0.5213],
-  ['追击', '法修', 0.5634],
-  ['追击', '法力', 0.5432],
-  ['追击', '雷法', 0.5044],
-  ['追击', '符阵', 0.6157],
-  ['追击', '控场', 0.5958],
-  ['追击', '过载', 0.6295],
-  ['追击', '回复', 0.6354],
-  ['追击', '护持', 0.6463],
-  ['追击', '续战', 0.7218],
-  ['追击', '命纹', 0.5615],
-  ['追击', '机缘', 0.5268],
-  ['追击', '冷却', 0.6234],
-  ['追击', '统御', 0.6099],
-  ['追击', '均衡', 0.5722],
-  ['追击', '工巧', 0.4781],
-  ['追击', '炼药', 0.5361],
-  ['追击', '先锋', 0.5768],
-  ['追击', '狂战', 0.6197],
-  ['追击', '法剑', 0.5672],
-  ['追击', '圣佑', 0.5151],
-  ['追击', '堡垒', 0.5949],
-  ['追击', '起手', 0.5904],
-  ['快袭', '远射', 0.6641],
-  ['快袭', '游击', 0.7421],
-  ['快袭', '机动', 0.6528],
-  ['快袭', '风行', 0.6794],
-  ['快袭', '重击', 0.7028],
-  ['快袭', '爆发', 0.6717],
-  ['快袭', '破甲', 0.6879],
-  ['快袭', '压制', 0.6159],
-  ['快袭', '压血', 0.5831],
-  ['快袭', '守御', 0.6133],
-  ['快袭', '护体', 0.5434],
-  ['快袭', '重甲', 0.5328],
-  ['快袭', '反击', 0.6898],
-  ['快袭', '镇邪', 0.5335],
-  ['快袭', '法修', 0.5486],
-  ['快袭', '法力', 0.5028],
-  ['快袭', '雷法', 0.593],
-  ['快袭', '符阵', 0.5869],
-  ['快袭', '控场', 0.5595],
-  ['快袭', '过载', 0.5888],
-  ['快袭', '回复', 0.5748],
-  ['快袭', '护持', 0.5483],
-  ['快袭', '续战', 0.5473],
-  ['快袭', '命纹', 0.5426],
-  ['快袭', '机缘', 0.4854],
-  ['快袭', '冷却', 0.5745],
-  ['快袭', '统御', 0.5406],
-  ['快袭', '均衡', 0.5206],
-  ['快袭', '工巧', 0.5192],
-  ['快袭', '炼药', 0.5656],
-  ['快袭', '先锋', 0.5619],
-  ['快袭', '狂战', 0.6826],
-  ['快袭', '法剑', 0.5964],
-  ['快袭', '圣佑', 0.4988],
-  ['快袭', '堡垒', 0.5941],
-  ['快袭', '起手', 0.5629],
-  ['远射', '游击', 0.6795],
-  ['远射', '机动', 0.6245],
-  ['远射', '风行', 0.5979],
-  ['远射', '重击', 0.6841],
-  ['远射', '爆发', 0.5983],
-  ['远射', '破甲', 0.5703],
-  ['远射', '压制', 0.5474],
-  ['远射', '压血', 0.4747],
-  ['远射', '守御', 0.5923],
-  ['远射', '护体', 0.5016],
-  ['远射', '重甲', 0.5697],
-  ['远射', '反击', 0.5669],
-  ['远射', '镇邪', 0.4811],
-  ['远射', '法修', 0.5174],
-  ['远射', '法力', 0.4697],
-  ['远射', '雷法', 0.5274],
-  ['远射', '符阵', 0.5635],
-  ['远射', '控场', 0.562],
-  ['远射', '过载', 0.526],
-  ['远射', '回复', 0.5325],
-  ['远射', '护持', 0.5249],
-  ['远射', '续战', 0.643],
-  ['远射', '命纹', 0.4921],
-  ['远射', '机缘', 0.4417],
-  ['远射', '冷却', 0.4675],
-  ['远射', '统御', 0.5189],
-  ['远射', '均衡', 0.5349],
-  ['远射', '工巧', 0.5065],
-  ['远射', '炼药', 0.5366],
-  ['远射', '先锋', 0.5259],
-  ['远射', '狂战', 0.5781],
-  ['远射', '法剑', 0.5516],
-  ['远射', '圣佑', 0.4589],
-  ['远射', '堡垒', 0.5505],
-  ['远射', '起手', 0.5292],
-  ['游击', '机动', 0.7143],
-  ['游击', '风行', 0.6702],
-  ['游击', '重击', 0.6773],
-  ['游击', '爆发', 0.6322],
-  ['游击', '破甲', 0.6881],
-  ['游击', '压制', 0.624],
-  ['游击', '压血', 0.5784],
-  ['游击', '守御', 0.6592],
-  ['游击', '护体', 0.5893],
-  ['游击', '重甲', 0.5299],
-  ['游击', '反击', 0.7005],
-  ['游击', '镇邪', 0.5426],
-  ['游击', '法修', 0.5741],
-  ['游击', '法力', 0.5228],
-  ['游击', '雷法', 0.523],
-  ['游击', '符阵', 0.6419],
-  ['游击', '控场', 0.6207],
-  ['游击', '过载', 0.5284],
-  ['游击', '回复', 0.556],
-  ['游击', '护持', 0.5766],
-  ['游击', '续战', 0.6038],
-  ['游击', '命纹', 0.5388],
-  ['游击', '机缘', 0.5112],
-  ['游击', '冷却', 0.554],
-  ['游击', '统御', 0.5779],
-  ['游击', '均衡', 0.5303],
-  ['游击', '工巧', 0.568],
-  ['游击', '炼药', 0.5643],
-  ['游击', '先锋', 0.6093],
-  ['游击', '狂战', 0.7051],
-  ['游击', '法剑', 0.6137],
-  ['游击', '圣佑', 0.4791],
-  ['游击', '堡垒', 0.6628],
-  ['游击', '起手', 0.5949],
-  ['机动', '风行', 0.779],
-  ['机动', '重击', 0.6363],
-  ['机动', '爆发', 0.627],
-  ['机动', '破甲', 0.6149],
-  ['机动', '压制', 0.6331],
-  ['机动', '压血', 0.5046],
-  ['机动', '守御', 0.6324],
-  ['机动', '护体', 0.5913],
-  ['机动', '重甲', 0.5902],
-  ['机动', '反击', 0.5831],
-  ['机动', '镇邪', 0.4794],
-  ['机动', '法修', 0.5937],
-  ['机动', '法力', 0.5797],
-  ['机动', '雷法', 0.5596],
-  ['机动', '符阵', 0.5786],
-  ['机动', '控场', 0.5914],
-  ['机动', '过载', 0.5971],
-  ['机动', '回复', 0.5985],
-  ['机动', '护持', 0.5888],
-  ['机动', '续战', 0.6009],
-  ['机动', '命纹', 0.565],
-  ['机动', '机缘', 0.5935],
-  ['机动', '冷却', 0.5674],
-  ['机动', '统御', 0.5976],
-  ['机动', '均衡', 0.5708],
-  ['机动', '工巧', 0.6219],
-  ['机动', '炼药', 0.5386],
-  ['机动', '先锋', 0.5903],
-  ['机动', '狂战', 0.6296],
-  ['机动', '法剑', 0.534],
-  ['机动', '圣佑', 0.4903],
-  ['机动', '堡垒', 0.5817],
-  ['机动', '起手', 0.5714],
-  ['风行', '重击', 0.5814],
-  ['风行', '爆发', 0.5888],
-  ['风行', '破甲', 0.5965],
-  ['风行', '压制', 0.5891],
-  ['风行', '压血', 0.4822],
-  ['风行', '守御', 0.5779],
-  ['风行', '护体', 0.563],
-  ['风行', '重甲', 0.5303],
-  ['风行', '反击', 0.5606],
-  ['风行', '镇邪', 0.4994],
-  ['风行', '法修', 0.5666],
-  ['风行', '法力', 0.5465],
-  ['风行', '雷法', 0.6185],
-  ['风行', '符阵', 0.6019],
-  ['风行', '控场', 0.5591],
-  ['风行', '过载', 0.5711],
-  ['风行', '回复', 0.5502],
-  ['风行', '护持', 0.5305],
-  ['风行', '续战', 0.5345],
-  ['风行', '命纹', 0.5222],
-  ['风行', '机缘', 0.4927],
-  ['风行', '冷却', 0.5579],
-  ['风行', '统御', 0.5759],
-  ['风行', '均衡', 0.5518],
-  ['风行', '工巧', 0.5349],
-  ['风行', '炼药', 0.4949],
-  ['风行', '先锋', 0.5716],
-  ['风行', '狂战', 0.637],
-  ['风行', '法剑', 0.5606],
-  ['风行', '圣佑', 0.4625],
-  ['风行', '堡垒', 0.5604],
-  ['风行', '起手', 0.5593],
-  ['重击', '爆发', 0.6945],
-  ['重击', '破甲', 0.6774],
-  ['重击', '压制', 0.6399],
-  ['重击', '压血', 0.5782],
-  ['重击', '守御', 0.6601],
-  ['重击', '护体', 0.5804],
-  ['重击', '重甲', 0.7689],
-  ['重击', '反击', 0.6758],
-  ['重击', '镇邪', 0.5743],
-  ['重击', '法修', 0.5315],
-  ['重击', '法力', 0.5534],
-  ['重击', '雷法', 0.6306],
-  ['重击', '符阵', 0.5642],
-  ['重击', '控场', 0.555],
-  ['重击', '过载', 0.603],
-  ['重击', '回复', 0.6222],
-  ['重击', '护持', 0.5424],
-  ['重击', '续战', 0.6046],
-  ['重击', '命纹', 0.5489],
-  ['重击', '机缘', 0.4778],
-  ['重击', '冷却', 0.5272],
-  ['重击', '统御', 0.5262],
-  ['重击', '均衡', 0.5299],
-  ['重击', '工巧', 0.5468],
-  ['重击', '炼药', 0.5696],
-  ['重击', '先锋', 0.5126],
-  ['重击', '狂战', 0.6859],
-  ['重击', '法剑', 0.593],
-  ['重击', '圣佑', 0.5253],
-  ['重击', '堡垒', 0.6473],
-  ['重击', '起手', 0.5027],
-  ['爆发', '破甲', 0.6471],
-  ['爆发', '压制', 0.6149],
-  ['爆发', '压血', 0.6011],
-  ['爆发', '守御', 0.6566],
-  ['爆发', '护体', 0.6024],
-  ['爆发', '重甲', 0.5939],
-  ['爆发', '反击', 0.6182],
-  ['爆发', '镇邪', 0.5866],
-  ['爆发', '法修', 0.5946],
-  ['爆发', '法力', 0.5942],
-  ['爆发', '雷法', 0.6125],
-  ['爆发', '符阵', 0.6034],
-  ['爆发', '控场', 0.553],
-  ['爆发', '过载', 0.6815],
-  ['爆发', '回复', 0.6327],
-  ['爆发', '护持', 0.5936],
-  ['爆发', '续战', 0.5908],
-  ['爆发', '命纹', 0.6207],
-  ['爆发', '机缘', 0.5688],
-  ['爆发', '冷却', 0.655],
-  ['爆发', '统御', 0.5539],
-  ['爆发', '均衡', 0.5714],
-  ['爆发', '工巧', 0.5236],
-  ['爆发', '炼药', 0.5637],
-  ['爆发', '先锋', 0.5253],
-  ['爆发', '狂战', 0.6509],
-  ['爆发', '法剑', 0.5871],
-  ['爆发', '圣佑', 0.5475],
-  ['爆发', '堡垒', 0.6038],
-  ['爆发', '起手', 0.578],
-  ['破甲', '压制', 0.6264],
-  ['破甲', '压血', 0.5547],
-  ['破甲', '守御', 0.7071],
-  ['破甲', '护体', 0.658],
-  ['破甲', '重甲', 0.7112],
-  ['破甲', '反击', 0.6969],
-  ['破甲', '镇邪', 0.6075],
-  ['破甲', '法修', 0.5574],
-  ['破甲', '法力', 0.5077],
-  ['破甲', '雷法', 0.5545],
-  ['破甲', '符阵', 0.6422],
-  ['破甲', '控场', 0.5732],
-  ['破甲', '过载', 0.5188],
-  ['破甲', '回复', 0.5907],
-  ['破甲', '护持', 0.5939],
-  ['破甲', '续战', 0.587],
-  ['破甲', '命纹', 0.5605],
-  ['破甲', '机缘', 0.4785],
-  ['破甲', '冷却', 0.5631],
-  ['破甲', '统御', 0.5967],
-  ['破甲', '均衡', 0.5164],
-  ['破甲', '工巧', 0.5391],
-  ['破甲', '炼药', 0.543],
-  ['破甲', '先锋', 0.6307],
-  ['破甲', '狂战', 0.6562],
-  ['破甲', '法剑', 0.6461],
-  ['破甲', '圣佑', 0.542],
-  ['破甲', '堡垒', 0.6839],
-  ['破甲', '起手', 0.562],
-  ['压制', '压血', 0.6276],
-  ['压制', '守御', 0.6984],
-  ['压制', '护体', 0.6072],
-  ['压制', '重甲', 0.545],
-  ['压制', '反击', 0.7119],
-  ['压制', '镇邪', 0.5967],
-  ['压制', '法修', 0.553],
-  ['压制', '法力', 0.5656],
-  ['压制', '雷法', 0.5769],
-  ['压制', '符阵', 0.5715],
-  ['压制', '控场', 0.749],
-  ['压制', '过载', 0.6006],
-  ['压制', '回复', 0.5653],
-  ['压制', '护持', 0.6715],
-  ['压制', '续战', 0.5801],
-  ['压制', '命纹', 0.551],
-  ['压制', '机缘', 0.5549],
-  ['压制', '冷却', 0.5747],
-  ['压制', '统御', 0.6469],
-  ['压制', '均衡', 0.5886],
-  ['压制', '工巧', 0.5383],
-  ['压制', '炼药', 0.535],
-  ['压制', '先锋', 0.5772],
-  ['压制', '狂战', 0.5509],
-  ['压制', '法剑', 0.5397],
-  ['压制', '圣佑', 0.5325],
-  ['压制', '堡垒', 0.6023],
-  ['压制', '起手', 0.5394],
-  ['压血', '守御', 0.5914],
-  ['压血', '护体', 0.5175],
-  ['压血', '重甲', 0.5008],
-  ['压血', '反击', 0.6153],
-  ['压血', '镇邪', 0.5773],
-  ['压血', '法修', 0.4587],
-  ['压血', '法力', 0.4814],
-  ['压血', '雷法', 0.5198],
-  ['压血', '符阵', 0.5016],
-  ['压血', '控场', 0.5041],
-  ['压血', '过载', 0.5253],
-  ['压血', '回复', 0.5365],
-  ['压血', '护持', 0.515],
-  ['压血', '续战', 0.497],
-  ['压血', '命纹', 0.4709],
-  ['压血', '机缘', 0.4604],
-  ['压血', '冷却', 0.5177],
-  ['压血', '统御', 0.4647],
-  ['压血', '均衡', 0.4405],
-  ['压血', '工巧', 0.405],
-  ['压血', '炼药', 0.5014],
-  ['压血', '先锋', 0.5009],
-  ['压血', '狂战', 0.6444],
-  ['压血', '法剑', 0.5183],
-  ['压血', '圣佑', 0.4573],
-  ['压血', '堡垒', 0.5345],
-  ['压血', '起手', 0.4848],
-  ['守御', '护体', 0.7607],
-  ['守御', '重甲', 0.7127],
-  ['守御', '反击', 0.7066],
-  ['守御', '镇邪', 0.6594],
-  ['守御', '法修', 0.5957],
-  ['守御', '法力', 0.614],
-  ['守御', '雷法', 0.5409],
-  ['守御', '符阵', 0.6034],
-  ['守御', '控场', 0.6585],
-  ['守御', '过载', 0.5236],
-  ['守御', '回复', 0.5995],
-  ['守御', '护持', 0.7566],
-  ['守御', '续战', 0.6493],
-  ['守御', '命纹', 0.5943],
-  ['守御', '机缘', 0.494],
-  ['守御', '冷却', 0.5445],
-  ['守御', '统御', 0.6908],
-  ['守御', '均衡', 0.6017],
-  ['守御', '工巧', 0.5528],
-  ['守御', '炼药', 0.5365],
-  ['守御', '先锋', 0.665],
-  ['守御', '狂战', 0.62],
-  ['守御', '法剑', 0.6191],
-  ['守御', '圣佑', 0.665],
-  ['守御', '堡垒', 0.7582],
-  ['守御', '起手', 0.5109],
-  ['护体', '重甲', 0.6496],
-  ['护体', '反击', 0.6368],
-  ['护体', '镇邪', 0.6807],
-  ['护体', '法修', 0.6148],
-  ['护体', '法力', 0.6455],
-  ['护体', '雷法', 0.5794],
-  ['护体', '符阵', 0.6043],
-  ['护体', '控场', 0.5781],
-  ['护体', '过载', 0.5113],
-  ['护体', '回复', 0.5927],
-  ['护体', '护持', 0.7176],
-  ['护体', '续战', 0.5704],
-  ['护体', '命纹', 0.6048],
-  ['护体', '机缘', 0.4744],
-  ['护体', '冷却', 0.4956],
-  ['护体', '统御', 0.6238],
-  ['护体', '均衡', 0.5194],
-  ['护体', '工巧', 0.4965],
-  ['护体', '炼药', 0.5417],
-  ['护体', '先锋', 0.5728],
-  ['护体', '狂战', 0.5373],
-  ['护体', '法剑', 0.6043],
-  ['护体', '圣佑', 0.725],
-  ['护体', '堡垒', 0.6437],
-  ['护体', '起手', 0.4898],
-  ['重甲', '反击', 0.5685],
-  ['重甲', '镇邪', 0.556],
-  ['重甲', '法修', 0.4907],
-  ['重甲', '法力', 0.5033],
-  ['重甲', '雷法', 0.513],
-  ['重甲', '符阵', 0.5623],
-  ['重甲', '控场', 0.5215],
-  ['重甲', '过载', 0.5094],
-  ['重甲', '回复', 0.573],
-  ['重甲', '护持', 0.579],
-  ['重甲', '续战', 0.6005],
-  ['重甲', '命纹', 0.5357],
-  ['重甲', '机缘', 0.4124],
-  ['重甲', '冷却', 0.4427],
-  ['重甲', '统御', 0.5444],
-  ['重甲', '均衡', 0.5009],
-  ['重甲', '工巧', 0.5093],
-  ['重甲', '炼药', 0.5303],
-  ['重甲', '先锋', 0.5833],
-  ['重甲', '狂战', 0.6125],
-  ['重甲', '法剑', 0.5387],
-  ['重甲', '圣佑', 0.5324],
-  ['重甲', '堡垒', 0.7125],
-  ['重甲', '起手', 0.473],
-  ['反击', '镇邪', 0.6254],
-  ['反击', '法修', 0.5644],
-  ['反击', '法力', 0.543],
-  ['反击', '雷法', 0.5453],
-  ['反击', '符阵', 0.6064],
-  ['反击', '控场', 0.615],
-  ['反击', '过载', 0.5353],
-  ['反击', '回复', 0.5944],
-  ['反击', '护持', 0.6343],
-  ['反击', '续战', 0.576],
-  ['反击', '命纹', 0.5603],
-  ['反击', '机缘', 0.5539],
-  ['反击', '冷却', 0.5888],
-  ['反击', '统御', 0.5744],
-  ['反击', '均衡', 0.5154],
-  ['反击', '工巧', 0.4982],
-  ['反击', '炼药', 0.5217],
-  ['反击', '先锋', 0.5842],
-  ['反击', '狂战', 0.6543],
-  ['反击', '法剑', 0.581],
-  ['反击', '圣佑', 0.5798],
-  ['反击', '堡垒', 0.6901],
-  ['反击', '起手', 0.5609],
-  ['镇邪', '法修', 0.5702],
-  ['镇邪', '法力', 0.5942],
-  ['镇邪', '雷法', 0.6029],
-  ['镇邪', '符阵', 0.6614],
-  ['镇邪', '控场', 0.568],
-  ['镇邪', '过载', 0.5081],
-  ['镇邪', '回复', 0.5846],
-  ['镇邪', '护持', 0.5381],
-  ['镇邪', '续战', 0.4889],
-  ['镇邪', '命纹', 0.5353],
-  ['镇邪', '机缘', 0.457],
-  ['镇邪', '冷却', 0.5112],
-  ['镇邪', '统御', 0.5196],
-  ['镇邪', '均衡', 0.4713],
-  ['镇邪', '工巧', 0.4463],
-  ['镇邪', '炼药', 0.4968],
-  ['镇邪', '先锋', 0.4949],
-  ['镇邪', '狂战', 0.591],
-  ['镇邪', '法剑', 0.6089],
-  ['镇邪', '圣佑', 0.6872],
-  ['镇邪', '堡垒', 0.6238],
-  ['镇邪', '起手', 0.4864],
-  ['法修', '法力', 0.7208],
-  ['法修', '雷法', 0.6333],
-  ['法修', '符阵', 0.6298],
-  ['法修', '控场', 0.5764],
-  ['法修', '过载', 0.578],
-  ['法修', '回复', 0.5988],
-  ['法修', '护持', 0.5658],
-  ['法修', '续战', 0.541],
-  ['法修', '命纹', 0.6459],
-  ['法修', '机缘', 0.5116],
-  ['法修', '冷却', 0.5266],
-  ['法修', '统御', 0.6418],
-  ['法修', '均衡', 0.4631],
-  ['法修', '工巧', 0.5871],
-  ['法修', '炼药', 0.6282],
-  ['法修', '先锋', 0.5125],
-  ['法修', '狂战', 0.5753],
-  ['法修', '法剑', 0.7104],
-  ['法修', '圣佑', 0.5691],
-  ['法修', '堡垒', 0.5534],
-  ['法修', '起手', 0.5379],
-  ['法力', '雷法', 0.61],
-  ['法力', '符阵', 0.5773],
-  ['法力', '控场', 0.4987],
-  ['法力', '过载', 0.605],
-  ['法力', '回复', 0.598],
-  ['法力', '护持', 0.5795],
-  ['法力', '续战', 0.5531],
-  ['法力', '命纹', 0.6539],
-  ['法力', '机缘', 0.5452],
-  ['法力', '冷却', 0.5194],
-  ['法力', '统御', 0.6022],
-  ['法力', '均衡', 0.5077],
-  ['法力', '工巧', 0.5687],
-  ['法力', '炼药', 0.5806],
-  ['法力', '先锋', 0.4548],
-  ['法力', '狂战', 0.5491],
-  ['法力', '法剑', 0.6307],
-  ['法力', '圣佑', 0.5769],
-  ['法力', '堡垒', 0.5276],
-  ['法力', '起手', 0.4906],
-  ['雷法', '符阵', 0.597],
-  ['雷法', '控场', 0.5121],
-  ['雷法', '过载', 0.5585],
-  ['雷法', '回复', 0.5585],
-  ['雷法', '护持', 0.4631],
-  ['雷法', '续战', 0.4514],
-  ['雷法', '命纹', 0.5399],
-  ['雷法', '机缘', 0.4319],
-  ['雷法', '冷却', 0.4935],
-  ['雷法', '统御', 0.5187],
-  ['雷法', '均衡', 0.4183],
-  ['雷法', '工巧', 0.4696],
-  ['雷法', '炼药', 0.5434],
-  ['雷法', '先锋', 0.4505],
-  ['雷法', '狂战', 0.5692],
-  ['雷法', '法剑', 0.6448],
-  ['雷法', '圣佑', 0.5153],
-  ['雷法', '堡垒', 0.4846],
-  ['雷法', '起手', 0.4587],
-  ['符阵', '控场', 0.6108],
-  ['符阵', '过载', 0.5434],
-  ['符阵', '回复', 0.5793],
-  ['符阵', '护持', 0.5548],
-  ['符阵', '续战', 0.5653],
-  ['符阵', '命纹', 0.5807],
-  ['符阵', '机缘', 0.5305],
-  ['符阵', '冷却', 0.5247],
-  ['符阵', '统御', 0.596],
-  ['符阵', '均衡', 0.4758],
-  ['符阵', '工巧', 0.5118],
-  ['符阵', '炼药', 0.5587],
-  ['符阵', '先锋', 0.5208],
-  ['符阵', '狂战', 0.6399],
-  ['符阵', '法剑', 0.6213],
-  ['符阵', '圣佑', 0.5678],
-  ['符阵', '堡垒', 0.6326],
-  ['符阵', '起手', 0.5444],
-  ['控场', '过载', 0.5345],
-  ['控场', '回复', 0.5483],
-  ['控场', '护持', 0.5773],
-  ['控场', '续战', 0.5117],
-  ['控场', '命纹', 0.5334],
-  ['控场', '机缘', 0.5049],
-  ['控场', '冷却', 0.5248],
-  ['控场', '统御', 0.6024],
-  ['控场', '均衡', 0.5389],
-  ['控场', '工巧', 0.5029],
-  ['控场', '炼药', 0.4973],
-  ['控场', '先锋', 0.5409],
-  ['控场', '狂战', 0.5177],
-  ['控场', '法剑', 0.4913],
-  ['控场', '圣佑', 0.4957],
-  ['控场', '堡垒', 0.5744],
-  ['控场', '起手', 0.5304],
-  ['过载', '回复', 0.621],
-  ['过载', '护持', 0.523],
-  ['过载', '续战', 0.5862],
-  ['过载', '命纹', 0.4679],
-  ['过载', '机缘', 0.4845],
-  ['过载', '冷却', 0.6125],
-  ['过载', '统御', 0.5142],
-  ['过载', '均衡', 0.512],
-  ['过载', '工巧', 0.4477],
-  ['过载', '炼药', 0.5165],
-  ['过载', '先锋', 0.472],
-  ['过载', '狂战', 0.5719],
-  ['过载', '法剑', 0.5009],
-  ['过载', '圣佑', 0.4471],
-  ['过载', '堡垒', 0.4894],
-  ['过载', '起手', 0.5507],
-  ['回复', '护持', 0.6385],
-  ['回复', '续战', 0.7208],
-  ['回复', '命纹', 0.5697],
-  ['回复', '机缘', 0.5503],
-  ['回复', '冷却', 0.6266],
-  ['回复', '统御', 0.6014],
-  ['回复', '均衡', 0.5601],
-  ['回复', '工巧', 0.551],
-  ['回复', '炼药', 0.6223],
-  ['回复', '先锋', 0.49],
-  ['回复', '狂战', 0.5537],
-  ['回复', '法剑', 0.5084],
-  ['回复', '圣佑', 0.5796],
-  ['回复', '堡垒', 0.5532],
-  ['回复', '起手', 0.5605],
-  ['护持', '续战', 0.6602],
-  ['护持', '命纹', 0.5718],
-  ['护持', '机缘', 0.5891],
-  ['护持', '冷却', 0.5337],
-  ['护持', '统御', 0.6472],
-  ['护持', '均衡', 0.5856],
-  ['护持', '工巧', 0.5238],
-  ['护持', '炼药', 0.5062],
-  ['护持', '先锋', 0.6196],
-  ['护持', '狂战', 0.5233],
-  ['护持', '法剑', 0.4996],
-  ['护持', '圣佑', 0.6853],
-  ['护持', '堡垒', 0.6118],
-  ['护持', '起手', 0.522],
-  ['续战', '命纹', 0.5695],
-  ['续战', '机缘', 0.5065],
-  ['续战', '冷却', 0.5479],
-  ['续战', '统御', 0.6108],
-  ['续战', '均衡', 0.6118],
-  ['续战', '工巧', 0.4802],
-  ['续战', '炼药', 0.5326],
-  ['续战', '先锋', 0.5283],
-  ['续战', '狂战', 0.589],
-  ['续战', '法剑', 0.5245],
-  ['续战', '圣佑', 0.4996],
-  ['续战', '堡垒', 0.5803],
-  ['续战', '起手', 0.5138],
-  ['命纹', '机缘', 0.6391],
-  ['命纹', '冷却', 0.4859],
-  ['命纹', '统御', 0.5763],
-  ['命纹', '均衡', 0.4904],
-  ['命纹', '工巧', 0.5419],
-  ['命纹', '炼药', 0.5336],
-  ['命纹', '先锋', 0.4693],
-  ['命纹', '狂战', 0.5297],
-  ['命纹', '法剑', 0.5789],
-  ['命纹', '圣佑', 0.5901],
-  ['命纹', '堡垒', 0.5077],
-  ['命纹', '起手', 0.5058],
-  ['机缘', '冷却', 0.4758],
-  ['机缘', '统御', 0.5276],
-  ['机缘', '均衡', 0.5299],
-  ['机缘', '工巧', 0.5537],
-  ['机缘', '炼药', 0.4607],
-  ['机缘', '先锋', 0.4412],
-  ['机缘', '狂战', 0.4916],
-  ['机缘', '法剑', 0.4279],
-  ['机缘', '圣佑', 0.5334],
-  ['机缘', '堡垒', 0.4821],
-  ['机缘', '起手', 0.5271],
-  ['冷却', '统御', 0.4681],
-  ['冷却', '均衡', 0.5192],
-  ['冷却', '工巧', 0.4528],
-  ['冷却', '炼药', 0.5105],
-  ['冷却', '先锋', 0.4123],
-  ['冷却', '狂战', 0.5277],
-  ['冷却', '法剑', 0.4966],
-  ['冷却', '圣佑', 0.427],
-  ['冷却', '堡垒', 0.5101],
-  ['冷却', '起手', 0.5162],
-  ['统御', '均衡', 0.5641],
-  ['统御', '工巧', 0.5768],
-  ['统御', '炼药', 0.5346],
-  ['统御', '先锋', 0.633],
-  ['统御', '狂战', 0.5482],
-  ['统御', '法剑', 0.5855],
-  ['统御', '圣佑', 0.5481],
-  ['统御', '堡垒', 0.5774],
-  ['统御', '起手', 0.5428],
-  ['均衡', '工巧', 0.5957],
-  ['均衡', '炼药', 0.4911],
-  ['均衡', '先锋', 0.4931],
-  ['均衡', '狂战', 0.488],
-  ['均衡', '法剑', 0.5058],
-  ['均衡', '圣佑', 0.4665],
-  ['均衡', '堡垒', 0.5519],
-  ['均衡', '起手', 0.5537],
-  ['工巧', '炼药', 0.6352],
-  ['工巧', '先锋', 0.4415],
-  ['工巧', '狂战', 0.4979],
-  ['工巧', '法剑', 0.5548],
-  ['工巧', '圣佑', 0.4727],
-  ['工巧', '堡垒', 0.5285],
-  ['工巧', '起手', 0.5812],
-  ['炼药', '先锋', 0.4232],
-  ['炼药', '狂战', 0.5542],
-  ['炼药', '法剑', 0.5878],
-  ['炼药', '圣佑', 0.4755],
-  ['炼药', '堡垒', 0.5155],
-  ['炼药', '起手', 0.5478],
-  ['先锋', '狂战', 0.5637],
-  ['先锋', '法剑', 0.516],
-  ['先锋', '圣佑', 0.4738],
-  ['先锋', '堡垒', 0.6068],
-  ['先锋', '起手', 0.5946],
-  ['狂战', '法剑', 0.6253],
-  ['狂战', '圣佑', 0.4844],
-  ['狂战', '堡垒', 0.6703],
-  ['狂战', '起手', 0.5352],
-  ['法剑', '圣佑', 0.5668],
-  ['法剑', '堡垒', 0.5968],
-  ['法剑', '起手', 0.4903],
-  ['圣佑', '堡垒', 0.5733],
-  ['圣佑', '起手', 0.4104],
-  ['堡垒', '起手', 0.5186],
-] as const;
diff --git a/src/data/customWorldCharacterLoadout.stub.ts b/src/data/customWorldCharacterLoadout.stub.ts
deleted file mode 100644
index 67d7a5b5..00000000
--- a/src/data/customWorldCharacterLoadout.stub.ts
+++ /dev/null
@@ -1,9 +0,0 @@
-import type { InventoryItem } from '../types';
-
-export function buildCustomWorldStarterInventoryItems(): InventoryItem[] {
-  return [];
-}
-
-export function buildCustomWorldStarterEquipmentItems(): InventoryItem[] {
-  return [];
-}
diff --git a/src/editor/shared/EditorEmptyState.tsx b/src/editor/shared/EditorEmptyState.tsx
deleted file mode 100644
index 8ced0cec..00000000
--- a/src/editor/shared/EditorEmptyState.tsx
+++ /dev/null
@@ -1,7 +0,0 @@
-export function EditorEmptyState({ message }: { message: string }) {
-  return (
-    <div className="rounded-2xl border border-white/10 bg-black/20 p-6 text-sm text-zinc-300">
-      {message}
-    </div>
-  );
-}
diff --git a/src/editor/shared/EditorSelectionCard.tsx b/src/editor/shared/EditorSelectionCard.tsx
deleted file mode 100644
index 13140038..00000000
--- a/src/editor/shared/EditorSelectionCard.tsx
+++ /dev/null
@@ -1,48 +0,0 @@
-import type { ReactNode } from 'react';
-
-import { SaveBar, SelectField, type SelectFieldOption } from './FormFields';
-import { SectionCard } from './SectionCard';
-
-export function EditorSelectionCard({
-  title,
-  description,
-  selectLabel,
-  selectValue,
-  onSelectChange,
-  selectOptions,
-  saveLabel,
-  onSave,
-  isSaving,
-  saveMessage,
-  children,
-}: {
-  title: string;
-  description?: string;
-  selectLabel: string;
-  selectValue: string | number;
-  onSelectChange: (value: string) => void;
-  selectOptions: SelectFieldOption[];
-  saveLabel: string;
-  onSave: () => void;
-  isSaving: boolean;
-  saveMessage: string | null;
-  children?: ReactNode;
-}) {
-  return (
-    <SectionCard title={title} description={description}>
-      <SelectField
-        label={selectLabel}
-        value={selectValue}
-        onChange={onSelectChange}
-        options={selectOptions}
-      />
-      {children}
-      <SaveBar
-        saveLabel={saveLabel}
-        onSave={onSave}
-        isSaving={isSaving}
-        saveMessage={saveMessage}
-      />
-    </SectionCard>
-  );
-}
diff --git a/src/editor/shared/cloneValue.ts b/src/editor/shared/cloneValue.ts
deleted file mode 100644
index 8537d138..00000000
--- a/src/editor/shared/cloneValue.ts
+++ /dev/null
@@ -1,7 +0,0 @@
-export function cloneValue<T>(value: T): T {
-  if (typeof structuredClone === 'function') {
-    return structuredClone(value);
-  }
-
-  return JSON.parse(JSON.stringify(value)) as T;
-}
diff --git a/src/editor/shared/editorApiClient.ts b/src/editor/shared/editorApiClient.ts
index cf9effc9..0c570b40 100644
--- a/src/editor/shared/editorApiClient.ts
+++ b/src/editor/shared/editorApiClient.ts
@@ -27,10 +27,6 @@ export const ASSET_API_PATHS = {
   characterAnimationJobs: `${ASSETS_API_BASE_PATH}/character-animation/jobs`,
   characterAnimationImportVideo: `${ASSETS_API_BASE_PATH}/character-animation/import-video`,
   characterAnimationTemplates: `${ASSETS_API_BASE_PATH}/character-animation/templates`,
-  qwenSpriteMaster: `${ASSETS_API_BASE_PATH}/qwen-sprite/master`,
-  qwenSpriteSheet: `${ASSETS_API_BASE_PATH}/qwen-sprite/sheet`,
-  qwenSpriteFrameRepair: `${ASSETS_API_BASE_PATH}/qwen-sprite/frame-repair`,
-  qwenSpriteSave: `${ASSETS_API_BASE_PATH}/qwen-sprite/save`,
 } as const;
 
 export const EDITOR_ITEM_CATALOG_API_PATH =
diff --git a/src/editor/shared/useJsonSave.ts b/src/editor/shared/useJsonSave.ts
deleted file mode 100644
index f304345e..00000000
--- a/src/editor/shared/useJsonSave.ts
+++ /dev/null
@@ -1,48 +0,0 @@
-import { useState } from 'react';
-
-import {
-  saveEditorJsonResource,
-  type EditorJsonResourceId,
-} from './editorApiClient';
-
-type UseJsonSaveOptions = {
-  resourceId: EditorJsonResourceId;
-  payload: Record<string, unknown>;
-  validate?: () => string[];
-  successMessage: string;
-  errorMessage: string;
-};
-
-export function useJsonSave({
-  resourceId,
-  payload,
-  validate,
-  successMessage,
-  errorMessage,
-}: UseJsonSaveOptions) {
-  const [isSaving, setIsSaving] = useState(false);
-  const [saveMessage, setSaveMessage] = useState<string | null>(null);
-
-  const save = async () => {
-    setIsSaving(true);
-    setSaveMessage(null);
-
-    const validationErrors = validate?.() ?? [];
-    if (validationErrors.length > 0) {
-      setSaveMessage(validationErrors.slice(0, 3).join(' | '));
-      setIsSaving(false);
-      return;
-    }
-
-    try {
-      await saveEditorJsonResource(resourceId, payload, errorMessage);
-      setSaveMessage(successMessage);
-    } catch (error) {
-      setSaveMessage(error instanceof Error ? error.message : errorMessage);
-    } finally {
-      setIsSaving(false);
-    }
-  };
-
-  return { isSaving, saveMessage, save };
-}
diff --git a/src/hooks/story/storyBootstrap.ts b/src/hooks/story/storyBootstrap.ts
deleted file mode 100644
index 93fda4a8..00000000
--- a/src/hooks/story/storyBootstrap.ts
+++ /dev/null
@@ -1,249 +0,0 @@
-import type { Dispatch, SetStateAction } from 'react';
-import { useCallback, useEffect, useState } from 'react';
-
-import type { StoryGenerationContext } from '../../services/aiTypes';
-import { applyStoryReasoningRecovery } from '../../data/storyRecovery';
-import type { Character, Encounter, GameState, StoryMoment, StoryOption } from '../../types';
-import {
-  playOpeningAdventureSequence,
-  type PreparedOpeningAdventure,
-} from './openingAdventure';
-
-type BuildFallbackStoryForState = (
-  state: GameState,
-  character: Character,
-  fallbackText?: string,
-) => StoryMoment;
-
-type GenerateStoryForState = (params: {
-  state: GameState;
-  character: Character;
-  history: StoryMoment[];
-  choice?: string;
-  lastFunctionId?: string | null;
-  optionCatalog?: StoryOption[] | null;
-}) => Promise<StoryMoment>;
-
-type BuildDialogueStoryMoment = (
-  npcName: string,
-  text: string,
-  options: StoryOption[],
-  streaming?: boolean,
-) => StoryMoment;
-
-export function useStoryBootstrap(params: {
-  gameState: GameState;
-  currentStory: StoryMoment | null;
-  isLoading: boolean;
-  setGameState: Dispatch<SetStateAction<GameState>>;
-  setCurrentStory: Dispatch<SetStateAction<StoryMoment | null>>;
-  setAiError: Dispatch<SetStateAction<string | null>>;
-  setIsLoading: Dispatch<SetStateAction<boolean>>;
-  prepareOpeningAdventure: (
-    state: GameState,
-    character: Character,
-  ) => PreparedOpeningAdventure | null;
-  getNpcEncounterKey: (encounter: Encounter) => string;
-  buildFallbackStoryForState: BuildFallbackStoryForState;
-  generateStoryForState: GenerateStoryForState;
-  buildDialogueStoryMoment: BuildDialogueStoryMoment;
-  buildStoryContextFromState: (
-    state: GameState,
-    extras?: {
-      lastFunctionId?: string | null;
-      openingCampBackground?: string | null;
-      openingCampDialogue?: string | null;
-      encounterNpcStateOverride?: GameState['npcStates'][string] | null;
-    },
-  ) => StoryGenerationContext;
-  getStoryGenerationHostileNpcs: (
-    state: GameState,
-  ) => GameState['sceneHostileNpcs'];
-  hasRenderableDialogueTurns: (text: string, npcName: string) => boolean;
-  inferOpeningCampFollowupOptions: (
-    state: GameState,
-    character: Character,
-    baseOptions: StoryOption[],
-    openingBackground: string,
-    openingDialogue: string,
-  ) => Promise<StoryOption[]>;
-  getTypewriterDelay: (char: string) => number;
-  isNpcEncounter: (
-    encounter: GameState['currentEncounter'],
-  ) => encounter is Encounter;
-  isInitialCompanionEncounter: (
-    encounter: GameState['currentEncounter'],
-  ) => encounter is Encounter;
-}) {
-  const {
-    gameState,
-    currentStory,
-    isLoading,
-    setGameState,
-    setCurrentStory,
-    setAiError,
-    setIsLoading,
-    prepareOpeningAdventure,
-    getNpcEncounterKey,
-    buildFallbackStoryForState,
-    generateStoryForState,
-    buildDialogueStoryMoment,
-    buildStoryContextFromState,
-    getStoryGenerationHostileNpcs,
-    hasRenderableDialogueTurns,
-    inferOpeningCampFollowupOptions,
-    getTypewriterDelay,
-    isNpcEncounter,
-    isInitialCompanionEncounter,
-  } = params;
-
-  const [preparedOpeningAdventure, setPreparedOpeningAdventure] =
-    useState<PreparedOpeningAdventure | null>(null);
-
-  useEffect(() => {
-    if (
-      gameState.currentScene !== 'Story' ||
-      !gameState.playerCharacter ||
-      gameState.storyHistory.length > 0 ||
-      currentStory ||
-      !isNpcEncounter(gameState.currentEncounter) ||
-      gameState.currentEncounter.specialBehavior !== 'initial_companion'
-    ) {
-      setPreparedOpeningAdventure(null);
-      return;
-    }
-
-    setPreparedOpeningAdventure(
-      prepareOpeningAdventure(gameState, gameState.playerCharacter),
-    );
-  }, [
-    currentStory,
-    gameState,
-    isNpcEncounter,
-    prepareOpeningAdventure,
-  ]);
-
-  const startOpeningAdventure = useCallback(async () => {
-    if (
-      !gameState.playerCharacter ||
-      !isNpcEncounter(gameState.currentEncounter)
-    ) {
-      return;
-    }
-
-    const encounter = gameState.currentEncounter;
-    if (encounter.specialBehavior !== 'initial_companion') {
-      return;
-    }
-
-    const preparedStory =
-      preparedOpeningAdventure?.encounterKey === getNpcEncounterKey(encounter)
-        ? preparedOpeningAdventure
-        : prepareOpeningAdventure(gameState, gameState.playerCharacter);
-
-    if (!preparedStory) {
-      return;
-    }
-
-    await playOpeningAdventureSequence({
-      gameState,
-      character: gameState.playerCharacter,
-      encounter,
-      preparedStory,
-      setGameState,
-      setCurrentStory,
-      setAiError,
-      setIsLoading,
-      buildDialogueStoryMoment,
-      buildStoryContextFromState,
-      getStoryGenerationHostileNpcs,
-      hasRenderableDialogueTurns,
-      inferOpeningCampFollowupOptions,
-      getTypewriterDelay,
-    });
-  }, [
-    buildDialogueStoryMoment,
-    buildStoryContextFromState,
-    gameState,
-    getNpcEncounterKey,
-    getStoryGenerationHostileNpcs,
-    getTypewriterDelay,
-    hasRenderableDialogueTurns,
-    inferOpeningCampFollowupOptions,
-    isNpcEncounter,
-    prepareOpeningAdventure,
-    preparedOpeningAdventure,
-    setAiError,
-    setCurrentStory,
-    setGameState,
-    setIsLoading,
-  ]);
-
-  useEffect(() => {
-    const startStory = async () => {
-      if (
-        gameState.currentScene !== 'Story' ||
-        !gameState.worldType ||
-        !gameState.playerCharacter ||
-        currentStory ||
-        isLoading
-      ) {
-        return;
-      }
-
-      if (
-        gameState.storyHistory.length === 0 &&
-        isInitialCompanionEncounter(gameState.currentEncounter) &&
-        !gameState.npcInteractionActive
-      ) {
-        setAiError(null);
-        void startOpeningAdventure();
-        return;
-      }
-
-      setIsLoading(true);
-      try {
-        setAiError(null);
-        const nextStory = await generateStoryForState({
-          state: gameState,
-          character: gameState.playerCharacter,
-          history: [],
-        });
-        setGameState(applyStoryReasoningRecovery(gameState));
-        setCurrentStory(nextStory);
-      } catch (error) {
-        console.error('Failed to start story:', error);
-        setAiError(error instanceof Error ? error.message : '未知智能生成错误');
-        setCurrentStory(
-          buildFallbackStoryForState(gameState, gameState.playerCharacter),
-        );
-      } finally {
-        setIsLoading(false);
-      }
-    };
-
-    void startStory();
-  }, [
-    buildFallbackStoryForState,
-    currentStory,
-    gameState,
-    generateStoryForState,
-    isInitialCompanionEncounter,
-    isLoading,
-    setAiError,
-    setCurrentStory,
-    setGameState,
-    setIsLoading,
-    startOpeningAdventure,
-  ]);
-
-  const resetPreparedOpeningAdventure = useCallback(() => {
-    setPreparedOpeningAdventure(null);
-  }, []);
-
-  return {
-    preparedOpeningAdventure,
-    startOpeningAdventure,
-    resetPreparedOpeningAdventure,
-  };
-}
diff --git a/src/hooks/useEquipmentFlow.ts b/src/hooks/useEquipmentFlow.ts
deleted file mode 100644
index d634ac50..00000000
--- a/src/hooks/useEquipmentFlow.ts
+++ /dev/null
@@ -1,133 +0,0 @@
-import { useCallback } from 'react';
-
-import {
-  applyEquipmentLoadoutToState,
-  getEquipmentSlotFromItem,
-  getEquipmentSlotLabel,
-} from '../data/equipmentEffects';
-import {
-  EQUIPMENT_EQUIP_FUNCTION,
-  EQUIPMENT_UNEQUIP_FUNCTION,
-} from '../data/functionCatalog';
-import {
-  addInventoryItems,
-  removeInventoryItem,
-} from '../data/npcInteractions';
-import { EquipmentSlotId, GameState, InventoryItem } from '../types';
-import type { CommitGeneratedState } from './generatedState';
-
-function normalizeEquippedItem(item: InventoryItem) {
-  return {
-    ...item,
-    quantity: 1,
-  };
-}
-
-function buildEquipResultText(
-  item: InventoryItem,
-  slot: EquipmentSlotId,
-  replacedItem?: InventoryItem | null,
-) {
-  return replacedItem
-    ? `你将${replacedItem.name}从${getEquipmentSlotLabel(slot)}位上换下，改为装备${item.name}。`
-    : `你将${item.name}装备在${getEquipmentSlotLabel(slot)}位上。`;
-}
-
-function buildUnequipResultText(item: InventoryItem) {
-  return `你卸下了${item.name}，暂时收回背包。`;
-}
-
-export function useEquipmentFlow({
-  gameState,
-  commitGeneratedState,
-}: {
-  gameState: GameState;
-  commitGeneratedState: CommitGeneratedState;
-}) {
-  const handleEquipInventoryItem = useCallback(
-    async (itemId: string) => {
-      if (!gameState.playerCharacter || gameState.inBattle) return false;
-
-      const item = gameState.playerInventory.find(
-        (candidate) => candidate.id === itemId,
-      );
-      if (!item || item.quantity <= 0) return false;
-
-      const slot = getEquipmentSlotFromItem(item);
-      if (!slot) return false;
-
-      const replacedItem = gameState.playerEquipment[slot];
-      const nextEquipment = {
-        ...gameState.playerEquipment,
-        [slot]: normalizeEquippedItem(item),
-      };
-
-      let nextInventory = removeInventoryItem(
-        gameState.playerInventory,
-        item.id,
-        1,
-      );
-      if (replacedItem) {
-        nextInventory = addInventoryItems(nextInventory, [replacedItem]);
-      }
-
-      const nextState = applyEquipmentLoadoutToState(
-        {
-          ...gameState,
-          playerInventory: nextInventory,
-        },
-        nextEquipment,
-      );
-
-      await commitGeneratedState(
-        nextState,
-        gameState.playerCharacter,
-        `装备${item.name}`,
-        buildEquipResultText(item, slot, replacedItem),
-        EQUIPMENT_EQUIP_FUNCTION.id,
-      );
-
-      return true;
-    },
-    [commitGeneratedState, gameState],
-  );
-
-  const handleUnequipItem = useCallback(
-    async (slot: EquipmentSlotId) => {
-      if (!gameState.playerCharacter || gameState.inBattle) return false;
-
-      const equippedItem = gameState.playerEquipment[slot];
-      if (!equippedItem) return false;
-
-      const nextEquipment = {
-        ...gameState.playerEquipment,
-        [slot]: null,
-      };
-      const nextState = applyEquipmentLoadoutToState(
-        {
-          ...gameState,
-          playerInventory: addInventoryItems(gameState.playerInventory, [
-            equippedItem,
-          ]),
-        },
-        nextEquipment,
-      );
-
-      await commitGeneratedState(
-        nextState,
-        gameState.playerCharacter,
-        `卸下${equippedItem.name}`,
-        buildUnequipResultText(equippedItem),
-        EQUIPMENT_UNEQUIP_FUNCTION.id,
-      );
-
-      return true;
-    },
-    [commitGeneratedState, gameState],
-  );
-
-  return {
-    handleEquipInventoryItem,
-    handleUnequipItem,
-  };
-}
diff --git a/src/hooks/useForgeFlow.ts b/src/hooks/useForgeFlow.ts
deleted file mode 100644
index bdfd4a14..00000000
--- a/src/hooks/useForgeFlow.ts
+++ /dev/null
@@ -1,158 +0,0 @@
-import { useCallback, useMemo } from 'react';
-
-import {
-  buildForgeSuccessText,
-  executeDismantleItem,
-  executeForgeRecipe,
-  executeReforgeItem,
-  getForgeRecipeViews,
-  getReforgeCostView,
-} from '../data/forgeSystem';
-import {
-  FORGE_CRAFT_FUNCTION,
-  FORGE_DISMANTLE_FUNCTION,
-  FORGE_REFORGE_FUNCTION,
-} from '../data/functionCatalog';
-import type { GameState } from '../types';
-import type { CommitGeneratedState } from './generatedState';
-
-export function useForgeFlow({
-  gameState,
-  commitGeneratedState,
-}: {
-  gameState: GameState;
-  commitGeneratedState: CommitGeneratedState;
-}) {
-  const forgeRecipes = useMemo(
-    () =>
-      getForgeRecipeViews(
-        gameState.playerInventory,
-        gameState.playerCurrency,
-        gameState.worldType,
-      ),
-    [gameState.playerCurrency, gameState.playerInventory, gameState.worldType],
-  );
-
-  const handleCraftRecipe = useCallback(
-    async (recipeId: string) => {
-      if (!gameState.playerCharacter || gameState.inBattle) return false;
-
-      const result = executeForgeRecipe(
-        gameState.playerInventory,
-        recipeId,
-        gameState.worldType,
-        gameState.playerCurrency,
-      );
-      if (!result) return false;
-
-      const recipe = forgeRecipes.find(
-        (candidate) => candidate.id === recipeId,
-      );
-      const nextState: GameState = {
-        ...gameState,
-        playerCurrency: result.currency,
-        playerInventory: result.inventory,
-      };
-
-      await commitGeneratedState(
-        nextState,
-        gameState.playerCharacter,
-        `制作${result.createdItem.name}`,
-        buildForgeSuccessText('craft', {
-          recipeName: recipe?.name ?? recipeId,
-          createdItemName: result.createdItem.name,
-          currencyText: recipe?.currencyText,
-        }),
-        FORGE_CRAFT_FUNCTION.id,
-      );
-
-      return true;
-    },
-    [commitGeneratedState, forgeRecipes, gameState],
-  );
-
-  const handleDismantleItem = useCallback(
-    async (itemId: string) => {
-      if (!gameState.playerCharacter || gameState.inBattle) return false;
-
-      const sourceItem = gameState.playerInventory.find(
-        (item) => item.id === itemId,
-      );
-      if (!sourceItem) return false;
-
-      const result = executeDismantleItem(gameState.playerInventory, itemId);
-      if (!result) return false;
-
-      const nextState: GameState = {
-        ...gameState,
-        playerInventory: result.inventory,
-      };
-
-      await commitGeneratedState(
-        nextState,
-        gameState.playerCharacter,
-        `拆解${sourceItem.name}`,
-        buildForgeSuccessText('dismantle', {
-          sourceItemName: sourceItem.name,
-          outputNames: result.outputs.map((item) => item.name),
-        }),
-        FORGE_DISMANTLE_FUNCTION.id,
-      );
-
-      return true;
-    },
-    [commitGeneratedState, gameState],
-  );
-
-  const handleReforgeItem = useCallback(
-    async (itemId: string) => {
-      if (!gameState.playerCharacter || gameState.inBattle) return false;
-
-      const sourceItem = gameState.playerInventory.find(
-        (item) => item.id === itemId,
-      );
-      if (!sourceItem) return false;
-
-      const result = executeReforgeItem(
-        gameState.playerInventory,
-        itemId,
-        gameState.playerCurrency,
-      );
-      if (!result) return false;
-
-      const nextState: GameState = {
-        ...gameState,
-        playerCurrency: Math.max(
-          0,
-          gameState.playerCurrency - result.currencyCost,
-        ),
-        playerInventory: result.inventory,
-      };
-
-      const reforgeCost = getReforgeCostView(sourceItem, gameState.worldType);
-
-      await commitGeneratedState(
-        nextState,
-        gameState.playerCharacter,
-        `重铸${sourceItem.name}`,
-        buildForgeSuccessText('reforge', {
-          sourceItemName: sourceItem.name,
-          createdItemName: result.reforgedItem.name,
-          currencyText: reforgeCost.currencyText,
-        }),
-        FORGE_REFORGE_FUNCTION.id,
-      );
-
-      return true;
-    },
-    [commitGeneratedState, gameState],
-  );
-
-  return {
-    forgeRecipes,
-    handleCraftRecipe,
-    handleDismantleItem,
-    handleReforgeItem,
-    getReforgeCostView,
-  };
-}
diff --git a/src/hooks/useInventoryFlow.ts b/src/hooks/useInventoryFlow.ts
deleted file mode 100644
index d2a0e309..00000000
--- a/src/hooks/useInventoryFlow.ts
+++ /dev/null
@@ -1,99 +0,0 @@
-import { useCallback } from 'react';
-
-import { appendBuildBuffs } from '../data/buildDamage';
-import { INVENTORY_USE_FUNCTION } from '../data/functionCatalog';
-import {
-  buildInventoryUseResultText,
-  isInventoryItemUsable,
-  resolveInventoryItemUseEffect,
-} from '../data/inventoryEffects';
-import { removeInventoryItem } from '../data/npcInteractions';
-import { incrementGameRuntimeStats } from '../data/runtimeStats';
-import { GameState } from '../types';
-import type { CommitGeneratedState } from './generatedState';
-
-type TickCooldowns = (
-  cooldowns: Record<string, number>,
-) => Record<string, number>;
-
-export function useInventoryFlow({
-  gameState,
-  commitGeneratedState,
-  tickCooldowns,
-}: {
-  gameState: GameState;
-  commitGeneratedState: CommitGeneratedState;
-  tickCooldowns: TickCooldowns;
-}) {
-  const handleUseInventoryItem = useCallback(
-    async (itemId: string) => {
-      if (!gameState.playerCharacter) return false;
-
-      const item = gameState.playerInventory.find(
-        (candidate) => candidate.id === itemId,
-      );
-      if (!item || !isInventoryItemUsable(item) || item.quantity <= 0)
-        return false;
-
-      const effect = resolveInventoryItemUseEffect(
-        item,
-        gameState.playerCharacter,
-      );
-      if (!effect) return false;
-
-      if (
-        effect.hpRestore <= 0 &&
-        effect.manaRestore <= 0 &&
-        effect.cooldownReduction <= 0 &&
-        effect.buildBuffs.length <= 0
-      ) {
-        return false;
-      }
-
-      let cooldowns = gameState.playerSkillCooldowns;
-      for (let index = 0; index < effect.cooldownReduction; index += 1) {
-        cooldowns = tickCooldowns(cooldowns);
-      }
-
-      const nextState: GameState = {
-        ...gameState,
-        playerHp: Math.min(
-          gameState.playerMaxHp,
-          gameState.playerHp + effect.hpRestore,
-        ),
-        playerMana: Math.min(
-          gameState.playerMaxMana,
-          gameState.playerMana + effect.manaRestore,
-        ),
-        playerSkillCooldowns: cooldowns,
-        activeBuildBuffs: appendBuildBuffs(
-          gameState.activeBuildBuffs,
-          effect.buildBuffs,
-        ),
-        playerInventory: removeInventoryItem(
-          gameState.playerInventory,
-          item.id,
-          1,
-        ),
-        runtimeStats: incrementGameRuntimeStats(gameState.runtimeStats, {
-          itemsUsed: 1,
-        }),
-      };
-
-      await commitGeneratedState(
-        nextState,
-        gameState.playerCharacter,
-        `使用${item.name}`,
-        buildInventoryUseResultText(item, effect),
-        INVENTORY_USE_FUNCTION.id,
-      );
-
-      return true;
-    },
-    [commitGeneratedState, gameState, tickCooldowns],
-  );
-
-  return {
-    handleUseInventoryItem,
-  };
-}
diff --git a/src/index.css b/src/index.css
index 3bd5ea36..c151f45b 100644
--- a/src/index.css
+++ b/src/index.css
@@ -1365,6 +1365,15 @@ body {
   background: var(--platform-track-fill);
 }
 
+.platform-cover-artwork {
+  background: radial-gradient(
+      circle at top,
+      var(--platform-surface-glow-a),
+      transparent 42%
+    ),
+    var(--platform-subpanel-fill);
+}
+
 .platform-theme--light
   :where(
     .platform-surface:not(.platform-surface--hero),
@@ -2398,6 +2407,26 @@ button {
 @media (max-width: 640px) {
   :root {
     --ui-scale: 0.8;
+    --platform-bottom-nav-height: 3.35rem;
+    --platform-bottom-nav-label-size: 10px;
+  }
+
+  .platform-main-shell {
+    padding-inline: max(0.75rem, env(safe-area-inset-left)) max(
+        0.75rem,
+        env(safe-area-inset-right)
+      );
+    padding-top: max(0.75rem, env(safe-area-inset-top));
+    padding-bottom: 0.5rem;
+  }
+
+  .platform-page-stage {
+    border-radius: 1.45rem;
+  }
+
+  .platform-bottom-nav {
+    position: relative;
+    z-index: 30;
   }
 
   .selection-hero-brand {
diff --git a/src/prompts/customWorldOrchestratorPrompts.ts b/src/prompts/customWorldOrchestratorPrompts.ts
deleted file mode 100644
index e4e0b503..00000000
--- a/src/prompts/customWorldOrchestratorPrompts.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-export const CUSTOM_WORLD_JSON_REPAIR_SYSTEM_PROMPT = `你是 JSON 修复器。
-你会收到一段本应为单个 JSON 对象的文本。
-你的唯一任务是把它修复成能被 JSON.parse 直接解析的单个 JSON 对象。
-不要输出 Markdown、代码块、解释、注释或额外文字。
-尽量保留原始语义，只修复格式问题；必要时可以补齐缺失的引号、逗号、括号、数组闭合或缺失字段。`;
-
-export const CUSTOM_WORLD_GENERATION_JSON_ONLY_SYSTEM_PROMPT = `你是严格的自定义世界 JSON 生成器。
-只输出一个 JSON 对象，不要输出 Markdown、代码块、解释或额外文字。`;
diff --git a/src/prompts/qwenSpriteSheetToolPrompts.ts b/src/prompts/qwenSpriteSheetToolPrompts.ts
deleted file mode 100644
index 93a63ab0..00000000
--- a/src/prompts/qwenSpriteSheetToolPrompts.ts
+++ /dev/null
@@ -1,629 +0,0 @@
-export type QwenSpriteActionTemplateId =
-  | 'idle'
-  | 'run'
-  | 'attack_slash'
-  | 'hurt'
-  | 'die';
-
-export type QwenSpriteActionTemplate = {
-  id: QwenSpriteActionTemplateId;
-  label: string;
-  loop: boolean;
-  defaultFps: number;
-  bodyTravel: string;
-  weaponRule: string;
-  stagingDirection?: string;
-  defaultDetailText?: string;
-  sequenceLines: [string, string, string, string];
-  ending: string;
-};
-
-export const DEFAULT_MASTER_NEGATIVE_PROMPT =
-  '正面视角，左朝向，完全 90 度纯右视图，镜头透视，半身像，脚被裁切，头顶被裁切，多角色，复杂背景，建筑场景，道具堆叠，漂浮物，烟雾环境，武器消失，武器换手，额外手臂，额外腿，服装变化，脸部变化，模糊，运动模糊，文字，水印，UI 元素';
-
-export const DEFAULT_SHEET_NEGATIVE_PROMPT =
-  '多角色，左右朝向混乱，前视图，背视图，镜头切换，景别变化，特写，脚底裁切，头顶裁切，缺手，缺脚，额外肢体，武器消失，武器换手，服装变化，脸部变化，发型变化，动作不连续，重复帧过多，构图混乱，背景复杂，强透视，运动模糊，残影，文字，水印，UI，边框覆盖角色';
-
-export const DEFAULT_REPAIR_NEGATIVE_PROMPT =
-  '多角色，错误朝向，缺手，缺脚，额外肢体，武器消失，武器换手，脸部变化，发型变化，服装变化，模糊，运动模糊，复杂背景，文字，水印';
-
-const CHIBI_STYLE_TEXT =
-  'Q版大头身动作角色，头身比固定控制在 2 到 3 头身，头部占比明显更大，类似横版像素 RPG 可扮演角色的比例，不要写实长身比例。';
-const PIXEL_STYLE_TEXT =
-  '参考项目内可扮演角色的像素风动作角色画风，整体是像素游戏角色设计方向，身体始终朝右，适合横版动作 sprite 资产。';
-const SIDE_FACING_RIGHT_TEXT =
-  '角色采用横版动作素材常用的右向斜侧身站姿，身体整体朝右，但保留少量正面信息，能读到面部轮廓与胸肩结构，不是完全 90 度纯右视图，也不是正面立绘。';
-const SUBJECT_ONLY_TEXT =
-  '画面中只保留单个角色主体，不要额外人物、动物、召唤物、载具或陪体。';
-const CLEAN_BACKGROUND_TEXT =
-  '背景固定为纯绿色绿幕，只作为抠像底色，不出现建筑、室内布景、风景、地面道具、漂浮物、烟雾叙事元素或其他角色以外的场景内容。';
-const STYLE_REFERENCE_SCOPE_TEXT =
-  '参考图不仅用于约束像素画风、颜色组织、头身比例、右朝向和镜头语言，还要严格约束身体结构骨架。生成结果必须优先沿用参考图的人形动作角色身体结构，包括头、躯干、双臂、双腿、站姿重心和整体头身比；可以变化发型、服装、主题配饰和材质，但不要脱离参考图的人形身体结构。';
-const CONCEPT_INTERPRETATION_TEXT =
-  '请先拆解设定中的“身份词、主题词、身体结构词”。如果文字设定没有明确要求非人身体结构，默认优先生成人形拟人化角色，让主题词主要体现在服装、头饰、冠冕、权杖、纹样、材质和发光装饰上。';
-const HUMANLIKE_PRIORITY_TEXT =
-  '默认优先使用参考图对应的人类或类人动作角色骨架，保持清楚的头、躯干、手臂和双腿轮廓，这样更适合横版动作 sprite。只有当文字设定明确要求鱼尾、触手身体、伞盖头部、无双腿、漂浮体、凝胶体或其他非人结构时，才改为对应非人身体。';
-const CONCEPT_HIERARCHY_TEXT =
-  '视觉优先级应当是：身体结构词第一，身份词第二，主题词第三。没有明确身体结构词时，默认用人形拟人化表现，再把主题词转译成服装和装饰。';
-const THEME_APPLICATION_BOUNDARY_TEXT =
-  '主题词默认只作用在角色自身的服装剪裁、材质、纹样、饰品、武器和发光细节上，不要把主题词自动扩写成背景建筑、自然场景、漂浮装饰或额外环境物件。';
-const CHIBI_CHARACTER_TEXT =
-  '即使角色带有怪物或海洋主题，也优先做成 Q版可爱的人形动作角色，方便读图和后续动画化。';
-
-const SETTING_AND_ROLE_ALIGNMENT_TEXT =
-  '先从角色设定中提炼世界设定、时代氛围、阵营身份、职业职责、战斗习惯、装备结构、材质配色和情绪气质，再把这些信息落实到发型、服装层次、护具、武器、饰品、轮廓和动作节奏里，不要混入与设定无关的现代服饰、写实摄影镜头、枪械体系或其他世界观元素。';
-const CHARACTER_DETAIL_COVERAGE_TEXT =
-  '角色描述需要尽量落到可视化细节：发型与脸部识别点、年龄层与气质、服装层次、护具与配饰、武器/法器类型、主色与材质、职业姿态与世界观痕迹，避免只有抽象身份词。';
-
-export const DEFAULT_CHARACTER_BRIEF =
-  '魔潮复苏边境城邦中的少女遗迹冒险者，Q版大头身，约 2 到 3 头身，金棕色微卷短发，琥珀色眼睛，额前碎发与侧边发束清晰，表情明亮但带警觉；穿分层轻甲、短披风和旅行短裙，皮革护腕、金属护膝、系带短靴完整可见；腰间挂药剂包、地图筒与小型护符，右手持单手短剑，主色为蜂蜜金、墨绿和旧银，轮廓利落，像长期在遗迹与荒野间行动的年轻探索者。';
-
-export const PLAYABLE_CHARACTER_STYLE_REFERENCE_SOURCES = [
-  '/character/Sword Princess/Original/Hero/idle/Idle01.png',
-  '/character/Archer Hero/Original/Hero/idle/idle01.png',
-  '/character/Girl Hero 1/Original/Hero/Idle/Idle01.png',
-  '/character/Punch Hero 3/Original/Hero/Idle/Idle01.png',
-  '/character/Fighter 4/original/Hero/idle/idle01.png',
-];
-
-export const QWEN_SPRITE_ACTION_TEMPLATES: QwenSpriteActionTemplate[] = [
-  {
-    id: 'idle',
-    label: '待机循环',
-    loop: true,
-    defaultFps: 8,
-    bodyTravel: '原地',
-    weaponRule: '武器始终在主手，位置稳定',
-    sequenceLines: [
-      '1-4 帧：稳定站姿，轻微呼吸起伏',
-      '5-8 帧：胸腔与肩膀轻微抬起，衣摆极轻微变化',
-      '9-12 帧：呼气回落，重心恢复',
-      '13-16 帧：逐渐回到与首帧接近的站姿',
-    ],
-    ending: '第 16 帧自然衔接第 1 帧',
-  },
-  {
-    id: 'run',
-    label: '奔跑循环',
-    loop: true,
-    defaultFps: 12,
-    bodyTravel: '小幅前移但角色中心基本固定',
-    weaponRule: '武器始终在主手，不换手',
-    sequenceLines: [
-      '1-4 帧：右腿前摆，左腿后蹬，身体略前倾',
-      '5-8 帧：双腿交叉经过身体下方，手臂反向摆动',
-      '9-12 帧：左腿前摆，右腿后蹬，继续前倾',
-      '13-16 帧：完成另一半跑步循环并回到可接第 1 帧的状态',
-    ],
-    ending: '第 16 帧能无缝接回第 1 帧',
-  },
-  {
-    id: 'attack_slash',
-    label: '横斩攻击',
-    loop: false,
-    defaultFps: 12,
-    bodyTravel: '中幅前探',
-    weaponRule: '右手持武器，始终右手，不换手',
-    sequenceLines: [
-      '1-4 帧：轻微收身蓄力，武器向后收',
-      '5-8 帧：重心前压，挥击开始',
-      '9-12 帧：斩击达到最大幅度，动作力量最强',
-      '13-16 帧：顺势收招，回到可接下一动作的稳定姿态',
-    ],
-    ending: '第 16 帧停在收招后稳定姿态',
-  },
-  {
-    id: 'hurt',
-    label: '受击后仰',
-    loop: false,
-    defaultFps: 10,
-    bodyTravel: '原地或极小后仰',
-    weaponRule: '武器不要脱手，不要换手',
-    sequenceLines: [
-      '1-4 帧：突然受击，头肩后仰',
-      '5-8 帧：身体失衡最明显',
-      '9-12 帧：手臂和武器随惯性摆动',
-      '13-16 帧：逐渐恢复到勉强站稳的姿态',
-    ],
-    ending: '第 16 帧能接回 idle 或下一个动作',
-  },
-  {
-    id: 'die',
-    label: '倒地死亡',
-    loop: false,
-    defaultFps: 8,
-    bodyTravel: '明显倒地位移',
-    weaponRule: '武器不可瞬间消失',
-    sequenceLines: [
-      '1-4 帧：受创失衡，重心被打断',
-      '5-8 帧：身体明显下坠或后仰',
-      '9-12 帧：倒地过程完成，动作幅度最大',
-      '13-16 帧：停在清晰的终止姿态',
-    ],
-    ending: '第 16 帧停在死亡结束姿态，不需要循环',
-  },
-];
-
-const ACTION_TEMPLATE_DETAILS: Record<
-  QwenSpriteActionTemplateId,
-  { stagingDirection: string; defaultDetailText: string }
-> = {
-  idle: {
-    stagingDirection:
-      '演出重点是轻呼吸、微幅重心起伏、戒备感和可循环衔接。',
-    defaultDetailText:
-      '保持与角色设定一致的戒备气质和职业站姿，重心稳在脚下，呼吸起伏轻微，披风、衣摆、发梢和小型饰品只有细小摆动，武器安静跟随身体微动，像角色在所属世界里随时准备探索、交涉或开战的待机瞬间。',
-  },
-  run: {
-    stagingDirection:
-      '演出重点是持续推进、步点清楚、上身稳定和装备惯性。',
-    defaultDetailText:
-      '跑动时要体现角色职业和世界设定中的装备重量感，身体略微前压，步幅清晰，手臂与武器顺势摆动，披风、衣摆和挂件跟着惯性后甩，像角色正穿过战场、街巷或遗迹通道迅速移动，节奏连续稳定。',
-  },
-  attack_slash: {
-    stagingDirection:
-      '演出重点是收身蓄力、爆发斩击、武器轨迹和收招稳定。',
-    defaultDetailText:
-      '攻击前先有短暂收身蓄力，再顺着主手武器做干净利落的前踏斩击，爆发点明确，武器轨迹贴合角色职业习惯与世界观武器设定，衣摆和挂件随发力甩动，收招后还能稳住重心，像久经战斗训练的真实角色动作。',
-  },
-  hurt: {
-    stagingDirection:
-      '演出重点是冲击反馈、短暂失衡、惯性摆动和重新稳住。',
-    defaultDetailText:
-      '受击瞬间要有明确冲击反馈，肩背后仰或身体侧偏，表情短促吃痛但不夸张，武器和手臂因惯性发生合理摆动，服装层次和挂件跟着抖动一下，随后努力稳住姿态，像这个角色在其世界观里真实挨到一击后的反应。',
-  },
-  die: {
-    stagingDirection:
-      '演出重点是失衡下坠、动作逐渐停尽和终止姿态清晰。',
-    defaultDetailText:
-      '死亡动作要先表现失衡与力量被抽离，再完成明显倒下或瘫落，武器和四肢随惯性下坠，披风、衣摆和饰品有最后一次明显摆动，最终停在清晰的终止姿态，符合角色身份、装备重量和世界氛围，不要轻飘或喜剧化。',
-  },
-};
-
-export function getActionTemplateById(id: QwenSpriteActionTemplateId) {
-  const template =
-    QWEN_SPRITE_ACTION_TEMPLATES.find((candidate) => candidate.id === id) ??
-    QWEN_SPRITE_ACTION_TEMPLATES[0];
-  return {
-    ...template,
-    ...ACTION_TEMPLATE_DETAILS[template.id],
-  };
-}
-
-export function readFileAsDataUrl(file: File) {
-  return new Promise<string>((resolve, reject) => {
-    const reader = new FileReader();
-    reader.onload = () => resolve(String(reader.result ?? ''));
-    reader.onerror = () => reject(reader.error ?? new Error('读取文件失败'));
-    reader.readAsDataURL(file);
-  });
-}
-
-function loadImageFromSource(source: string) {
-  return new Promise<HTMLImageElement>((resolve, reject) => {
-    const image = new Image();
-    image.crossOrigin = 'anonymous';
-    image.onload = () => resolve(image);
-    image.onerror = () => reject(new Error(`加载图片失败：${source}`));
-    image.src = source;
-  });
-}
-
-function drawContainedImage(
-  context: CanvasRenderingContext2D,
-  image: HTMLImageElement,
-  options: {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  },
-) {
-  const fitScale = Math.min(
-    options.width / image.width,
-    options.height / image.height,
-  );
-  const drawWidth = image.width * fitScale;
-  const drawHeight = image.height * fitScale;
-  const drawX = options.x + (options.width - drawWidth) / 2;
-  const drawY = options.y + (options.height - drawHeight) / 2;
-
-  context.drawImage(image, drawX, drawY, drawWidth, drawHeight);
-}
-
-export async function sliceSpriteSheetFrames(
-  spriteSource: string,
-  options: {
-    rows: number;
-    cols: number;
-  },
-) {
-  const image = await loadImageFromSource(spriteSource);
-  const frameWidth = Math.floor(image.width / options.cols);
-  const frameHeight = Math.floor(image.height / options.rows);
-  const frames: string[] = [];
-
-  for (let rowIndex = 0; rowIndex < options.rows; rowIndex += 1) {
-    for (let colIndex = 0; colIndex < options.cols; colIndex += 1) {
-      const canvas = document.createElement('canvas');
-      const context = canvas.getContext('2d');
-      if (!context) {
-        throw new Error('无法创建画布上下文');
-      }
-
-      canvas.width = frameWidth;
-      canvas.height = frameHeight;
-      context.drawImage(
-        image,
-        colIndex * frameWidth,
-        rowIndex * frameHeight,
-        frameWidth,
-        frameHeight,
-        0,
-        0,
-        frameWidth,
-        frameHeight,
-      );
-      frames.push(canvas.toDataURL('image/png'));
-    }
-  }
-
-  return {
-    frameWidth,
-    frameHeight,
-    frames,
-    width: image.width,
-    height: image.height,
-  };
-}
-
-export async function extractSpriteFrame(
-  spriteSource: string,
-  options: {
-    rows: number;
-    cols: number;
-    frameIndex: number;
-    outputSize?: number;
-  },
-) {
-  const sliced = await sliceSpriteSheetFrames(spriteSource, {
-    rows: options.rows,
-    cols: options.cols,
-  });
-  const frameSource = sliced.frames[options.frameIndex];
-
-  if (!frameSource) {
-    throw new Error('帧索引超出范围。');
-  }
-
-  if (!options.outputSize) {
-    return frameSource;
-  }
-
-  const image = await loadImageFromSource(frameSource);
-  const canvas = document.createElement('canvas');
-  const context = canvas.getContext('2d');
-  if (!context) {
-    throw new Error('无法创建画布上下文');
-  }
-
-  canvas.width = options.outputSize;
-  canvas.height = options.outputSize;
-  context.clearRect(0, 0, canvas.width, canvas.height);
-  context.drawImage(image, 0, 0, canvas.width, canvas.height);
-  return canvas.toDataURL('image/png');
-}
-
-export async function replaceSpriteFrame(
-  spriteSource: string,
-  options: {
-    rows: number;
-    cols: number;
-    frameIndex: number;
-    replacementSource: string;
-  },
-) {
-  const spriteImage = await loadImageFromSource(spriteSource);
-  const replacementImage = await loadImageFromSource(options.replacementSource);
-  const frameWidth = Math.floor(spriteImage.width / options.cols);
-  const frameHeight = Math.floor(spriteImage.height / options.rows);
-  const rowIndex = Math.floor(options.frameIndex / options.cols);
-  const colIndex = options.frameIndex % options.cols;
-
-  const canvas = document.createElement('canvas');
-  const context = canvas.getContext('2d');
-  if (!context) {
-    throw new Error('无法创建画布上下文');
-  }
-
-  canvas.width = spriteImage.width;
-  canvas.height = spriteImage.height;
-  context.drawImage(spriteImage, 0, 0);
-  context.clearRect(
-    colIndex * frameWidth,
-    rowIndex * frameHeight,
-    frameWidth,
-    frameHeight,
-  );
-  context.drawImage(
-    replacementImage,
-    colIndex * frameWidth,
-    rowIndex * frameHeight,
-    frameWidth,
-    frameHeight,
-  );
-
-  return canvas.toDataURL('image/png');
-}
-
-export function buildOrderedActiveFrameIndices(
-  frameOrder: number[],
-  activeFrames: number[],
-) {
-  return frameOrder.filter((frameIndex) => activeFrames.includes(frameIndex));
-}
-
-export function buildOrderedActiveFrameSources(
-  frameDataUrls: string[],
-  frameOrder: number[],
-  activeFrames: number[],
-) {
-  return buildOrderedActiveFrameIndices(frameOrder, activeFrames)
-    .map((frameIndex) => frameDataUrls[frameIndex] ?? '')
-    .filter(Boolean);
-}
-
-export async function composeSpriteSheetFromFrames(
-  frameSources: string[],
-  options: {
-    cols: number;
-    rows?: number;
-    frameWidth?: number;
-    frameHeight?: number;
-    padToGrid?: boolean;
-  },
-) {
-  if (frameSources.length === 0) {
-    throw new Error('没有可用于拼接精灵表的帧。');
-  }
-
-  const images = await Promise.all(
-    frameSources.map((source) => loadImageFromSource(source)),
-  );
-  const frameWidth =
-    options.frameWidth ??
-    Math.max(...images.map((image) => image.width), 1);
-  const frameHeight =
-    options.frameHeight ??
-    Math.max(...images.map((image) => image.height), 1);
-  const rows =
-    options.rows ?? Math.max(1, Math.ceil(images.length / options.cols));
-  const canvas = document.createElement('canvas');
-  const context = canvas.getContext('2d');
-  if (!context) {
-    throw new Error('无法创建画布上下文');
-  }
-
-  canvas.width = frameWidth * options.cols;
-  canvas.height = frameHeight * rows;
-  context.clearRect(0, 0, canvas.width, canvas.height);
-
-  const totalCells = options.padToGrid ? rows * options.cols : images.length;
-  for (let index = 0; index < totalCells; index += 1) {
-    const image = images[index];
-    if (!image) {
-      continue;
-    }
-    const rowIndex = Math.floor(index / options.cols);
-    const colIndex = index % options.cols;
-    drawContainedImage(context, image, {
-      x: colIndex * frameWidth,
-      y: rowIndex * frameHeight,
-      width: frameWidth,
-      height: frameHeight,
-    });
-  }
-
-  return {
-    dataUrl: canvas.toDataURL('image/png'),
-    rows,
-    cols: options.cols,
-    frameWidth,
-    frameHeight,
-    frameCount: frameSources.length,
-  };
-}
-
-export async function buildPlayableCharacterStyleReferenceBoard(
-  sources = PLAYABLE_CHARACTER_STYLE_REFERENCE_SOURCES,
-) {
-  const images = await Promise.all(
-    sources.map((source) => loadImageFromSource(source)),
-  );
-  const cols = 3;
-  const rows = 2;
-  const cellSize = 320;
-  const padding = 24;
-  const canvas = document.createElement('canvas');
-  const context = canvas.getContext('2d');
-  if (!context) {
-    throw new Error('无法创建画布上下文');
-  }
-
-  canvas.width = cols * cellSize + padding * 2;
-  canvas.height = rows * cellSize + padding * 2;
-  context.fillStyle = '#f6f0dd';
-  context.fillRect(0, 0, canvas.width, canvas.height);
-  context.imageSmoothingEnabled = false;
-
-  images.forEach((image, index) => {
-    const colIndex = index % cols;
-    const rowIndex = Math.floor(index / cols);
-    drawContainedImage(context, image, {
-      x: padding + colIndex * cellSize,
-      y: padding + rowIndex * cellSize,
-      width: cellSize,
-      height: cellSize,
-    });
-  });
-
-  return canvas.toDataURL('image/png');
-}
-
-export function buildMasterPrompt(characterBrief: string) {
-  return [
-    '???2D ???????????????????????????????????????????? sprite sheet ???',
-    `?????${SIDE_FACING_RIGHT_TEXT}`,
-    `?????${SUBJECT_ONLY_TEXT}`,
-    `?????1:1 ??????????????????????????????????????????????????${CLEAN_BACKGROUND_TEXT}`,
-    `?????${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT} ?????????????????????????????????????/??/???????????????????????`,
-    SETTING_AND_ROLE_ALIGNMENT_TEXT,
-    CHARACTER_DETAIL_COVERAGE_TEXT,
-    CONCEPT_INTERPRETATION_TEXT,
-    HUMANLIKE_PRIORITY_TEXT,
-    CONCEPT_HIERARCHY_TEXT,
-    THEME_APPLICATION_BOUNDARY_TEXT,
-    characterBrief.trim(),
-  ]
-    .filter(Boolean)
-    .join('\n');
-}
-
-export function buildSheetPrompt(options: {
-  characterBrief: string;
-  actionTemplate: QwenSpriteActionTemplate;
-  extraDirection: string;
-}) {
-  return [
-    `???1??????????? 4x4 ? sprite sheet?? 16 ????????????????????????????????????????????????????????????????????????????????????????????????????? 90 ??????${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT}`,
-    SETTING_AND_ROLE_ALIGNMENT_TEXT,
-    CONCEPT_INTERPRETATION_TEXT,
-    HUMANLIKE_PRIORITY_TEXT,
-    CONCEPT_HIERARCHY_TEXT,
-    THEME_APPLICATION_BOUNDARY_TEXT,
-    `????${options.actionTemplate.label}`,
-    `???????${options.actionTemplate.stagingDirection ?? ACTION_TEMPLATE_DETAILS[options.actionTemplate.id].stagingDirection}`,
-    `?????${options.actionTemplate.loop ? '?' : '?'}`,
-    `?????${options.actionTemplate.bodyTravel}`,
-    `?????${options.actionTemplate.weaponRule}`,
-    ...options.actionTemplate.sequenceLines,
-    `?????${options.actionTemplate.ending}`,
-    '?????????????????????????????????????????????????????????????????????????????????? sprite frames?',
-    options.characterBrief.trim(),
-    `???????${options.extraDirection.trim() || options.actionTemplate.defaultDetailText || ACTION_TEMPLATE_DETAILS[options.actionTemplate.id].defaultDetailText}`,
-  ]
-    .filter(Boolean)
-    .join('\n');
-}
-
-export function buildRepairPrompt(options: {
-  issueText: string;
-  useNeighborLabel: '???' | '???';
-}) {
-  return [
-    `???1??????????2??????????3???????2??${options.useNeighborLabel}?`,
-    `?????????????????????????????????????????????????????????2???????1?????????????? 90 ??????${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT} ${SETTING_AND_ROLE_ALIGNMENT_TEXT} ${CONCEPT_INTERPRETATION_TEXT} ${HUMANLIKE_PRIORITY_TEXT} ${CONCEPT_HIERARCHY_TEXT} ${THEME_APPLICATION_BOUNDARY_TEXT} ???3???????????????? sprite sheet ??`,
-    '?????????????????????????',
-    `?????${options.issueText.trim() || '????????????????????'}`,
-  ].join('\n');
-}
-
-export function buildVideoActionPrompt(options: {
-  actionTemplate: QwenSpriteActionTemplate;
-  actionDetailText: string;
-  useChromaKey: boolean;
-  characterBrief: string;
-}) {
-  return [
-    `???????????????? ${options.actionTemplate.label}?`,
-    `??????1??????????????????????????????????? 90 ??????${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT}`,
-    SETTING_AND_ROLE_ALIGNMENT_TEXT,
-    CONCEPT_INTERPRETATION_TEXT,
-    HUMANLIKE_PRIORITY_TEXT,
-    CONCEPT_HIERARCHY_TEXT,
-    THEME_APPLICATION_BOUNDARY_TEXT,
-    `???????${options.actionTemplate.stagingDirection ?? ACTION_TEMPLATE_DETAILS[options.actionTemplate.id].stagingDirection}`,
-    `?????${options.actionTemplate.sequenceLines.join('?')}??????${options.actionTemplate.ending}?`,
-    options.useChromaKey
-      ? '??????????????????????????????'
-      : '?????????????',
-    `???????${options.actionDetailText.trim() || options.actionTemplate.defaultDetailText || ACTION_TEMPLATE_DETAILS[options.actionTemplate.id].defaultDetailText}`,
-    `?????${options.characterBrief.trim()}`,
-    '?????????????????????????????????????????',
-  ].join(' ');
-}
-
-export async function triggerDataUrlDownload(
-  filename: string,
-  dataUrl: string,
-) {
-  const response = await fetch(dataUrl);
-  const blob = await response.blob();
-  const objectUrl = URL.createObjectURL(blob);
-  const anchor = document.createElement('a');
-  anchor.href = objectUrl;
-  anchor.download = filename;
-  anchor.click();
-  URL.revokeObjectURL(objectUrl);
-}
-
-export function triggerJsonDownload(filename: string, value: unknown) {
-  const blob = new Blob([JSON.stringify(value, null, 2)], {
-    type: 'application/json',
-  });
-  const objectUrl = URL.createObjectURL(blob);
-  const anchor = document.createElement('a');
-  anchor.href = objectUrl;
-  anchor.download = filename;
-  anchor.click();
-  URL.revokeObjectURL(objectUrl);
-}
-
-export function buildDefaultFrameOrder(frameCount: number) {
-  return Array.from({ length: frameCount }, (_, index) => index);
-}
-
-export function restoreAllFrames(frameCount: number) {
-  return buildDefaultFrameOrder(frameCount);
-}
-
-export function buildMasterNegativePrompt(_characterBrief: string) {
-  return `${DEFAULT_MASTER_NEGATIVE_PROMPT}，不要机械地把主题词直接画成完整怪物本体，也不要把主题词自动扩写成角色以外的场景元素，除非文字设定明确要求`;
-}
-
-export function buildSheetNegativePrompt(_characterBrief: string) {
-  return `${DEFAULT_SHEET_NEGATIVE_PROMPT}，不要机械地把主题词直接画成完整怪物本体，除非文字设定明确要求非人身体`;
-}
-
-export function buildRepairNegativePrompt(_characterBrief: string) {
-  return `${DEFAULT_REPAIR_NEGATIVE_PROMPT}，不要机械地把主题词直接画成完整怪物本体，除非文字设定明确要求非人身体`;
-}
-
-export function moveFrameOrderItem(
-  frameOrder: number[],
-  frameIndex: number,
-  direction: -1 | 1,
-) {
-  const currentOrderIndex = frameOrder.indexOf(frameIndex);
-  if (currentOrderIndex < 0) {
-    return frameOrder;
-  }
-
-  const targetIndex = currentOrderIndex + direction;
-  if (targetIndex < 0 || targetIndex >= frameOrder.length) {
-    return frameOrder;
-  }
-
-  const nextOrder = [...frameOrder];
-  const [item] = nextOrder.splice(currentOrderIndex, 1);
-  nextOrder.splice(targetIndex, 0, item);
-  return nextOrder;
-}
-
-export function toggleActiveFrame(activeFrames: number[], frameIndex: number) {
-  if (activeFrames.includes(frameIndex)) {
-    return activeFrames.filter((item) => item !== frameIndex);
-  }
-
-  return [...activeFrames, frameIndex].sort((left, right) => left - right);
-}
diff --git a/src/prompts/storyOrchestratorPrompts.ts b/src/prompts/storyOrchestratorPrompts.ts
deleted file mode 100644
index 29436a66..00000000
--- a/src/prompts/storyOrchestratorPrompts.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-export const STORY_LANGUAGE_REPAIR_SYSTEM_PROMPT = `你是 RPG 中文叙事文本修复器。
-你会收到一个已经解析过的剧情 JSON 对象。
-你的唯一任务是把 storyText 和 options[].actionText 中的英文句子、中英混杂句式、英文解释改写成自然中文。
-必须保持 JSON 结构、encounter、options 数量、options 顺序以及每个 functionId 完全不变。
-只输出一个 JSON 对象，不要输出 Markdown、代码块、解释、注释或额外文字。`;
diff --git a/src/routing/appRoutes.test.ts b/src/routing/appRoutes.test.ts
index f0456a3d..f3a89a74 100644
--- a/src/routing/appRoutes.test.ts
+++ b/src/routing/appRoutes.test.ts
@@ -9,7 +9,7 @@ describe('matchAppRoute', () => {
     });
   });
 
-  it('routes deprecated editor paths back to the main game', () => {
+  it('routes former standalone editor paths back to the main game', () => {
     expect(matchAppRoute('/item-editor/tools')).toEqual({
       kind: 'game',
     });
@@ -26,10 +26,4 @@ describe('matchAppRoute', () => {
       kind: 'game',
     });
   });
-
-  it('keeps the sprite tool route', () => {
-    expect(matchAppRoute('/sprite-tool')).toEqual({
-      kind: 'qwen-sprite-tool',
-    });
-  });
 });
diff --git a/src/routing/appRoutes.tsx b/src/routing/appRoutes.tsx
index da5c330c..49b5c16d 100644
--- a/src/routing/appRoutes.tsx
+++ b/src/routing/appRoutes.tsx
@@ -9,9 +9,6 @@ type AppRouteComponent = LazyExoticComponent<
 export type AppRouteMatch =
   | {
       kind: 'game';
-    }
-  | {
-      kind: 'qwen-sprite-tool';
     };
 
 export type ResolvedAppRoute = {
@@ -23,15 +20,6 @@ export type ResolvedAppRoute = {
 };
 
 const GameApp = lazy(() => import('../AuthenticatedApp')) as AppRouteComponent;
-const QwenSpriteToolApp = lazy(
-  () => import('../tools/QwenSpriteSheetTool'),
-) as AppRouteComponent;
-
-const QWEN_SPRITE_TOOL_PREFIXES = [
-  '/qwen-sprite-tool',
-  '/sprite-tool',
-  '/pixelmotion-qwen',
-];
 
 function normalizeRoutePath(pathname: string) {
   const trimmedPathname = pathname.trim().toLowerCase();
@@ -43,25 +31,8 @@ function normalizeRoutePath(pathname: string) {
   return trimmedPathname.replace(/\/+$/u, '');
 }
 
-function matchesRoutePrefix(pathname: string, prefix: string) {
-  const normalizedPrefix = normalizeRoutePath(prefix);
-
-  return (
-    pathname === normalizedPrefix || pathname.startsWith(`${normalizedPrefix}/`)
-  );
-}
-
 export function matchAppRoute(pathname: string): AppRouteMatch {
-  const normalizedPathname = normalizeRoutePath(pathname);
-  const isQwenSpriteToolRoute = QWEN_SPRITE_TOOL_PREFIXES.some((prefix) =>
-    matchesRoutePrefix(normalizedPathname, prefix),
-  );
-
-  if (isQwenSpriteToolRoute) {
-    return {
-      kind: 'qwen-sprite-tool',
-    };
-  }
+  void normalizeRoutePath(pathname);
 
   return {
     kind: 'game',
@@ -71,15 +42,6 @@ export function matchAppRoute(pathname: string): AppRouteMatch {
 export function resolveAppRoute(pathname: string): ResolvedAppRoute {
   const matchedRoute = matchAppRoute(pathname);
 
-  if (matchedRoute.kind === 'qwen-sprite-tool') {
-    return {
-      kind: matchedRoute.kind,
-      loadingEyebrow: '正在载入精灵表工坊',
-      loadingText: '正在载入 Qwen 精灵表工具...',
-      Component: QwenSpriteToolApp,
-    };
-  }
-
   return {
     kind: 'game',
     loadingEyebrow: '正在载入游戏',
diff --git a/src/services/aiService.ts b/src/services/aiService.ts
index a80b1654..b887ec0d 100644
--- a/src/services/aiService.ts
+++ b/src/services/aiService.ts
@@ -10,11 +10,7 @@ import type {
   SendCustomWorldAgentMessageRequest,
 } from '../../packages/shared/src/contracts/customWorldAgent';
 import type {
-  AnswerCustomWorldSessionQuestionRequest,
-  CreateCustomWorldSessionRequest,
   CustomWorldGenerationProgress,
-  CustomWorldSessionRecord,
-  CustomWorldSessionSummary,
   GenerateCustomWorldProfileInput,
   GenerateCustomWorldProfileOptions,
 } from '../../packages/shared/src/contracts/runtime';
@@ -357,190 +353,8 @@ export async function generateCustomWorldProfile(
   input: GenerateCustomWorldProfileInput | string,
   options: GenerateCustomWorldProfileOptions = {},
 ): Promise<CustomWorldProfile> {
-  const normalizedInput =
-    typeof input === 'string'
-      ? {
-          settingText: input,
-          creatorIntent: null,
-          generationMode: 'full' as const,
-        }
-      : {
-          settingText: input.settingText,
-          creatorIntent: input.creatorIntent ?? null,
-          generationMode:
-            input.generationMode === 'fast'
-              ? ('fast' as const)
-              : ('full' as const),
-        };
-
-  const session = await createCustomWorldSession({
-    settingText: normalizedInput.settingText,
-    creatorIntent: normalizedInput.creatorIntent as Record<
-      string,
-      unknown
-    > | null,
-    generationMode: normalizedInput.generationMode,
-  });
-
-  const fallbackAnswerMap: Record<string, string> = {
-    world_hook:
-      typeof normalizedInput.creatorIntent?.worldHook === 'string' &&
-      normalizedInput.creatorIntent.worldHook.trim()
-        ? normalizedInput.creatorIntent.worldHook.trim()
-        : normalizedInput.settingText.trim().slice(0, 120) ||
-          '这是一个围绕失衡秩序展开的世界。',
-    player_premise:
-      typeof normalizedInput.creatorIntent?.playerPremise === 'string' &&
-      normalizedInput.creatorIntent.playerPremise.trim()
-        ? normalizedInput.creatorIntent.playerPremise.trim()
-        : '玩家是一名被卷入局势中心的行动者。',
-    opening_situation:
-      typeof normalizedInput.creatorIntent?.openingSituation === 'string' &&
-      normalizedInput.creatorIntent.openingSituation.trim()
-        ? normalizedInput.creatorIntent.openingSituation.trim()
-        : '故事开局时，玩家正身处风暴边缘，必须立刻判断立场与风险。',
-    core_conflict:
-      Array.isArray(normalizedInput.creatorIntent?.coreConflicts) &&
-      normalizedInput.creatorIntent.coreConflicts.length > 0
-        ? normalizedInput.creatorIntent.coreConflicts
-            .map((item) => (typeof item === 'string' ? item.trim() : ''))
-            .filter(Boolean)
-            .join('；')
-        : '旧秩序与新威胁正在同时逼近，各方都在争夺主动权。',
-  };
-
-  for (const question of session.questions ?? []) {
-    if (question.answer?.trim()) {
-      continue;
-    }
-
-    const answer =
-      fallbackAnswerMap[question.id] || normalizedInput.settingText.trim();
-    await answerCustomWorldSessionQuestion(session.sessionId, {
-      questionId: question.id,
-      answer,
-    });
-  }
-
-  return streamCustomWorldSessionGeneration(session.sessionId, options);
-}
-
-export async function streamCustomWorldSessionGeneration(
-  sessionId: string,
-  options: GenerateCustomWorldProfileOptions = {},
-): Promise<CustomWorldProfile> {
-  const response = await fetchWithApiAuth(
-    `${RUNTIME_API_BASE}/custom-world/sessions/${encodeURIComponent(sessionId)}/generate/stream`,
-    {
-      method: 'GET',
-      signal: options.signal,
-    },
-  );
-  if (!response.ok) {
-    const responseText = await response.text();
-    throw new Error(parseApiErrorMessage(responseText, '生成自定义世界失败'));
-  }
-  if (!response.body) {
-    throw new Error('自定义世界生成流不可用');
-  }
-
-  const reader = response.body.getReader();
-  const decoder = new TextDecoder('utf-8');
-  let buffer = '';
-  let latestProfile: Record<string, unknown> | null = null;
-
-  for (;;) {
-    const { done, value } = await reader.read();
-    if (done) {
-      break;
-    }
-
-    buffer += decoder.decode(value, { stream: true });
-
-    while (buffer.includes('\n\n')) {
-      const boundary = buffer.indexOf('\n\n');
-      const eventBlock = buffer.slice(0, boundary);
-      buffer = buffer.slice(boundary + 2);
-
-      let eventName = '';
-      for (const rawLine of eventBlock.split(/\r?\n/u)) {
-        const line = rawLine.trim();
-        if (!line) {
-          continue;
-        }
-        if (line.startsWith('event:')) {
-          eventName = line.slice(6).trim();
-          continue;
-        }
-        if (!line.startsWith('data:')) {
-          continue;
-        }
-
-        const payloadText = line.slice(5).trim();
-        if (!payloadText) {
-          continue;
-        }
-
-        const payload = JSON.parse(payloadText) as Record<string, unknown>;
-        if (eventName === 'progress') {
-          if (
-            typeof payload.phaseId === 'string' &&
-            typeof payload.phaseLabel === 'string' &&
-            typeof payload.phaseDetail === 'string' &&
-            typeof payload.overallProgress === 'number' &&
-            Array.isArray(payload.steps)
-          ) {
-            options.onProgress?.(
-              payload as unknown as CustomWorldGenerationProgress,
-            );
-          } else {
-            options.onProgress?.({
-              phaseId: 'finalize',
-              phaseLabel:
-                typeof payload.phase === 'string'
-                  ? payload.phase
-                  : 'generating',
-              phaseDetail:
-                typeof payload.phase === 'string'
-                  ? payload.phase
-                  : 'generating',
-              overallProgress:
-                typeof payload.progress === 'number'
-                  ? payload.progress / 100
-                  : 0,
-              completedWeight:
-                typeof payload.progress === 'number' ? payload.progress : 0,
-              totalWeight: 100,
-              elapsedMs: 0,
-              estimatedRemainingMs: null,
-              activeStepIndex: 0,
-              steps: [],
-            });
-          }
-        }
-        if (
-          eventName === 'result' &&
-          payload.profile &&
-          typeof payload.profile === 'object'
-        ) {
-          latestProfile = payload.profile as Record<string, unknown>;
-        }
-        if (eventName === 'error') {
-          throw new Error(
-            typeof payload.message === 'string'
-              ? payload.message
-              : '生成自定义世界失败',
-          );
-        }
-      }
-    }
-  }
-
-  if (!latestProfile) {
-    throw new Error('自定义世界生成未返回结果');
-  }
-
-  return latestProfile as unknown as CustomWorldProfile;
+  const aiClient = await loadLegacyAiModule();
+  return aiClient.generateCustomWorldProfile(input, options);
 }
 
 export async function generateCustomWorldSceneImage(
@@ -625,22 +439,6 @@ export async function generateCustomWorldLandmark(payload: {
   return response.entity;
 }
 
-export async function createCustomWorldSession(payload: {
-  settingText: string;
-  creatorIntent?: Record<string, unknown> | null;
-  generationMode: 'fast' | 'full';
-}) {
-  return requestJson<CustomWorldSessionSummary>(
-    `${RUNTIME_API_BASE}/custom-world/sessions`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload satisfies CreateCustomWorldSessionRequest),
-    },
-    '创建自定义世界会话失败',
-  );
-}
-
 export async function listCustomWorldWorks() {
   const response = await requestJson<ListCustomWorldWorksResponse>(
     `${RUNTIME_API_BASE}/custom-world/works`,
@@ -842,33 +640,6 @@ export async function getCustomWorldAgentCardDetail(
   return response.card as CustomWorldDraftCardDetail;
 }
 
-export async function getCustomWorldSession(sessionId: string) {
-  return requestJson<CustomWorldSessionRecord>(
-    `${RUNTIME_API_BASE}/custom-world/sessions/${encodeURIComponent(sessionId)}`,
-    {
-      method: 'GET',
-    },
-    '读取自定义世界会话失败',
-  );
-}
-
-export async function answerCustomWorldSessionQuestion(
-  sessionId: string,
-  payload: { questionId: string; answer: string },
-) {
-  return requestJson<CustomWorldSessionSummary>(
-    `${RUNTIME_API_BASE}/custom-world/sessions/${encodeURIComponent(sessionId)}/answers`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(
-        payload satisfies AnswerCustomWorldSessionQuestionRequest,
-      ),
-    },
-    '提交自定义世界补充设定失败',
-  );
-}
-
 export async function streamCharacterPanelChatReply(
   world: WorldType,
   playerCharacter: Character,
diff --git a/src/services/apiClient.ts b/src/services/apiClient.ts
index e508c46a..f739c682 100644
--- a/src/services/apiClient.ts
+++ b/src/services/apiClient.ts
@@ -9,8 +9,6 @@ import {
 } from '../../packages/shared/src/http';
 
 const ACCESS_TOKEN_KEY = 'genarrative.auth.access-token.v1';
-const AUTO_AUTH_USERNAME_KEY = 'genarrative.auth.auto-username.v1';
-const AUTO_AUTH_PASSWORD_KEY = 'genarrative.auth.auto-password.v1';
 export const AUTH_STATE_EVENT = 'genarrative-auth-state-changed';
 const REQUEST_ID_HEADER = 'x-request-id';
 const API_VERSION_HEADER = 'x-api-version';
@@ -376,46 +374,6 @@ export function clearStoredAccessToken(
   }
 }
 
-export function getStoredAutoAuthCredentials() {
-  if (!canUseLocalStorage()) {
-    return null;
-  }
-
-  const username = window.localStorage.getItem(AUTO_AUTH_USERNAME_KEY)?.trim() || '';
-  const password = window.localStorage.getItem(AUTO_AUTH_PASSWORD_KEY)?.trim() || '';
-
-  if (!username || !password) {
-    return null;
-  }
-
-  return {
-    username,
-    password,
-  };
-}
-
-export function setStoredAutoAuthCredentials(credentials: {
-  username: string;
-  password: string;
-}) {
-  if (!canUseLocalStorage()) {
-    return;
-  }
-
-  window.localStorage.setItem(AUTO_AUTH_USERNAME_KEY, credentials.username.trim());
-  window.localStorage.setItem(AUTO_AUTH_PASSWORD_KEY, credentials.password.trim());
-}
-
-export function clearStoredAutoAuthCredentials() {
-  if (!canUseLocalStorage()) {
-    return;
-  }
-
-  window.localStorage.removeItem(AUTO_AUTH_USERNAME_KEY);
-  window.localStorage.removeItem(AUTO_AUTH_PASSWORD_KEY);
-  emitAuthStateChange();
-}
-
 function withAuthorizationHeaders(
   headers?: HeadersInit,
   options: Pick<ApiRequestOptions, 'omitEnvelopeHeader' | 'skipAuth'> = {},
diff --git a/src/services/authService.test.ts b/src/services/authService.test.ts
index 3b617eb9..03e245c2 100644
--- a/src/services/authService.test.ts
+++ b/src/services/authService.test.ts
@@ -7,9 +7,7 @@ const { requestJsonMock } = vi.hoisted(() => ({
 import {
   ApiClientError,
   clearStoredAccessToken,
-  clearStoredAutoAuthCredentials,
   getStoredAccessToken,
-  getStoredAutoAuthCredentials,
   setStoredAccessToken,
 } from './apiClient';
 import {
@@ -67,7 +65,6 @@ describe('authService auto auth', () => {
     });
     requestJsonMock.mockReset();
     clearStoredAccessToken();
-    clearStoredAutoAuthCredentials();
   });
 
   it('creates credentials that match current username/password constraints', () => {
@@ -78,7 +75,7 @@ describe('authService auto auth', () => {
     expect(credentials.password.length).toBeGreaterThanOrEqual(6);
   });
 
-  it('stores jwt and auto credentials after auth entry', async () => {
+  it('stores jwt after auth entry without persisting guest credentials locally', async () => {
     requestJsonMock.mockResolvedValue({
       token: 'jwt-token-value',
       user: {
@@ -99,10 +96,6 @@ describe('authService auto auth', () => {
 
     expect(user.username).toBe('guest_abc123abc123');
     expect(getStoredAccessToken()).toBe('jwt-token-value');
-    expect(getStoredAutoAuthCredentials()).toEqual({
-      username: 'guest_abc123abc123',
-      password: 'auto_secret_password',
-    });
     expect(requestJsonMock).toHaveBeenCalledWith(
       '/api/auth/entry',
       expect.objectContaining({
@@ -115,9 +108,7 @@ describe('authService auto auth', () => {
     );
   });
 
-  it('reuses stored auto credentials before generating a new account', async () => {
-    window.localStorage.setItem('genarrative.auth.auto-username.v1', 'guest_saveduser01');
-    window.localStorage.setItem('genarrative.auth.auto-password.v1', 'auto_saved_password');
+  it('creates a fresh guest credential pair for auto auth when a session is missing', async () => {
     requestJsonMock.mockResolvedValue({
       token: 'jwt-restored',
       user: {
@@ -132,16 +123,24 @@ describe('authService auto auth', () => {
     });
 
     const result = await ensureAutoAuthUser();
+    const authEntryBody = JSON.parse(
+      requestJsonMock.mock.calls[0]?.[1]?.body as string,
+    ) as {
+      username: string;
+      password: string;
+    };
 
     expect(result.user.username).toBe('guest_saveduser01');
-    expect(result.credentials).toEqual({
-      username: 'guest_saveduser01',
-      password: 'auto_saved_password',
-    });
+    expect(result.credentials.username).toMatch(/^guest_[a-z0-9]{12}$/u);
+    expect(result.credentials.password).toMatch(
+      /^auto_[a-z0-9]{24}_[a-z0-9]{8}$/u,
+    );
+    expect(authEntryBody).toEqual(result.credentials);
     expect(requestJsonMock).toHaveBeenCalledWith(
       '/api/auth/entry',
       expect.objectContaining({
         method: 'POST',
+        body: expect.any(String),
       }),
       '登录失败',
     );
@@ -168,7 +167,13 @@ describe('authService auto auth', () => {
 
     expect(requestJsonMock).toHaveBeenCalledTimes(1);
     expect(firstResult).toEqual(secondResult);
-    expect(getStoredAutoAuthCredentials()).toEqual(firstResult.credentials);
+    const authEntryBody = JSON.parse(
+      requestJsonMock.mock.calls[0]?.[1]?.body as string,
+    ) as {
+      username: string;
+      password: string;
+    };
+    expect(authEntryBody).toEqual(firstResult.credentials);
   });
 
   it('sends phone login code through the new auth endpoint', async () => {
diff --git a/src/services/authService.ts b/src/services/authService.ts
index ab8ca2cb..b6736431 100644
--- a/src/services/authService.ts
+++ b/src/services/authService.ts
@@ -24,11 +24,8 @@ import type {
 import {
   ApiClientError,
   clearStoredAccessToken,
-  clearStoredAutoAuthCredentials,
-  getStoredAutoAuthCredentials,
   requestJson,
   setStoredAccessToken,
-  setStoredAutoAuthCredentials,
 } from './apiClient';
 
 export type { AuthUser } from '../../packages/shared/src/contracts/auth';
@@ -121,7 +118,6 @@ export function createAutoAuthCredentials(): AutoAuthCredentials {
 
 export function clearAuthSession() {
   clearStoredAccessToken();
-  clearStoredAutoAuthCredentials();
 }
 
 export async function sendPhoneLoginCode(
@@ -249,14 +245,12 @@ export async function authEntryWithStoredCredentials(
     normalizedCredentials.username,
     normalizedCredentials.password,
   );
-  setStoredAutoAuthCredentials(normalizedCredentials);
   return user;
 }
 
 export async function ensureAutoAuthUser() {
   pendingAutoAuthUser ??= (async () => {
-    const credentials =
-      getStoredAutoAuthCredentials() ?? createAutoAuthCredentials();
+    const credentials = createAutoAuthCredentials();
     const user = await authEntryWithStoredCredentials(credentials);
 
     return {
diff --git a/src/services/customWorldPresentation.stub.ts b/src/services/customWorldPresentation.stub.ts
deleted file mode 100644
index 7e9db3a2..00000000
--- a/src/services/customWorldPresentation.stub.ts
+++ /dev/null
@@ -1,54 +0,0 @@
-import { WorldType } from '../types';
-
-const ATTRIBUTE_LABELS = {
-  strength: 'Strength',
-  agility: 'Agility',
-  intelligence: 'Intelligence',
-  spirit: 'Spirit',
-} as const;
-
-const RESOURCE_LABELS = {
-  hp: 'HP',
-  mp: 'MP',
-  maxHp: '生命上限',
-  maxMp: '灵力上限',
-  damage: 'Damage',
-  guard: 'Guard',
-  range: 'Range',
-  cooldown: 'Cooldown',
-  manaCost: '灵力消耗',
-} as const;
-
-export function buildThemedSkillName(_profile: unknown, style: string, index = 0) {
-  return `${style || 'skill'}-${index + 1}`;
-}
-
-export function buildCustomCampSceneName(profile: { name?: string; camp?: { name?: string | null } | null } | null | undefined) {
-  return profile?.camp?.name?.trim() || (profile?.name ? `${profile.name}归舍` : '归舍');
-}
-
-export function getAttributeLabelsForWorld(_worldType: WorldType | null) {
-  return ATTRIBUTE_LABELS;
-}
-
-export function getResourceLabelsForWorld(_worldType: WorldType | null) {
-  return RESOURCE_LABELS;
-}
-
-export function buildThemedItemName(_profile: unknown, category: string, rarity: string, seedKey: string) {
-  return `${category}-${rarity}-${seedKey}`;
-}
-
-export function buildThemedItemDescription(_profile: unknown, category: string, rarity: string, seedKey: string) {
-  return `${category}-${rarity}-${seedKey} description`;
-}
-
-export function inferCustomItemMechanics() {
-  return {
-    tags: [],
-    equipmentSlotId: null,
-    statProfile: null,
-    useProfile: null,
-    value: 0,
-  };
-}
diff --git a/src/services/typewriter.ts b/src/services/typewriter.ts
deleted file mode 100644
index 68c79138..00000000
--- a/src/services/typewriter.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-export function getTypewriterDelay(char: string) {
-  if (/[。！？?!]/u.test(char)) return 240;
-  if (/[，、；：,;:]/u.test(char)) return 150;
-  if (/\s/u.test(char)) return 45;
-  return 90;
-}
diff --git a/src/tools/QwenSpriteSheetTool.tsx b/src/tools/QwenSpriteSheetTool.tsx
deleted file mode 100644
index 264742a7..00000000
--- a/src/tools/QwenSpriteSheetTool.tsx
+++ /dev/null
@@ -1,1169 +0,0 @@
-import {
-  ArrowLeft,
-  ArrowRight,
-  Download,
-  Pause,
-  Play,
-  RefreshCcw,
-  Save,
-  Sparkles,
-  Upload,
-  Wrench,
-} from 'lucide-react';
-import { useEffect, useMemo, useRef, useState } from 'react';
-
-import {
-  buildAnimationClipFromVideoSource,
-  GENERATED_FRAME_HEIGHT,
-  GENERATED_FRAME_WIDTH,
-} from '../components/asset-studio/characterAssetWorkflowModel';
-import { generateCharacterAnimationDraft } from '../components/asset-studio/characterAssetWorkflowPersistence';
-import {
-  NumberField,
-  SelectField,
-  TextAreaField,
-  TextField,
-} from '../editor/shared/FormFields';
-import { SectionCard } from '../editor/shared/SectionCard';
-import { AnimationState } from '../types';
-import {
-  DEFAULT_CHARACTER_BRIEF,
-  buildDefaultFrameOrder,
-  buildMasterNegativePrompt,
-  buildMasterPrompt,
-  buildOrderedActiveFrameSources,
-  buildPlayableCharacterStyleReferenceBoard,
-  buildRepairNegativePrompt,
-  buildRepairPrompt,
-  buildSheetNegativePrompt,
-  buildSheetPrompt,
-  buildVideoActionPrompt,
-  composeSpriteSheetFromFrames,
-  extractSpriteFrame,
-  getActionTemplateById,
-  moveFrameOrderItem,
-  QWEN_SPRITE_ACTION_TEMPLATES,
-  type QwenSpriteActionTemplateId,
-  replaceSpriteFrame,
-  restoreAllFrames,
-  sliceSpriteSheetFrames,
-  toggleActiveFrame,
-  triggerDataUrlDownload,
-  triggerJsonDownload,
-} from './qwenSpriteSheetToolModel';
-import {
-  generateQwenSpriteMaster,
-  generateQwenSpriteSheet,
-  type QwenSpriteImageDraft,
-  repairQwenSpriteFrame,
-  saveQwenSpriteAsset,
-} from './qwenSpriteSheetToolPersistence';
-
-const MODEL_OPTIONS = [
-  { label: 'Qwen-Image-2.0', value: 'qwen-image-2.0' },
-];
-const ACTION_GENERATION_MODE_OPTIONS = [
-  { label: '方案一：直接生成精灵表', value: 'direct-sheet' },
-  { label: '方案二：图生视频后抽帧', value: 'image-to-video' },
-];
-const FIXED_IMAGE_TO_VIDEO_MODEL = 'doubao-seedance-2-0-fast-260128';
-const FIXED_IMAGE_TO_VIDEO_RESOLUTION = '480p';
-const FIXED_IMAGE_TO_VIDEO_DURATION_SECONDS = 4;
-
-function mapActionTemplateIdToAnimationState(
-  actionTemplateId: QwenSpriteActionTemplateId,
-) {
-  switch (actionTemplateId) {
-    case 'run':
-      return AnimationState.RUN;
-    case 'attack_slash':
-      return AnimationState.ATTACK;
-    case 'hurt':
-      return AnimationState.HURT;
-    case 'die':
-      return AnimationState.DIE;
-    case 'idle':
-    default:
-      return AnimationState.IDLE;
-  }
-}
-
-function StatusNote({ title, message }: { title: string; message: string }) {
-  return (
-    <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3">
-      <div className="text-[11px] uppercase tracking-[0.2em] text-zinc-500">
-        {title}
-      </div>
-      <div className="mt-1 text-sm leading-relaxed text-zinc-300">{message}</div>
-    </div>
-  );
-}
-
-function DraftStrip({
-  drafts,
-  selectedId,
-  onSelect,
-}: {
-  drafts: QwenSpriteImageDraft[];
-  selectedId: string;
-  onSelect: (draft: QwenSpriteImageDraft) => void;
-}) {
-  return (
-    <div className="grid gap-3 md:grid-cols-2 xl:grid-cols-4">
-      {drafts.map((draft) => {
-        const isSelected = draft.id === selectedId;
-        return (
-          <button
-            key={draft.id}
-            type="button"
-            onClick={() => onSelect(draft)}
-            className={`rounded-2xl border p-3 text-left transition ${
-              isSelected
-                ? 'border-emerald-400/40 bg-emerald-500/10'
-                : 'border-white/10 bg-black/20 hover:border-white/20'
-            }`}
-          >
-            <div className="flex h-[220px] items-center justify-center overflow-hidden rounded-xl border border-white/10 bg-[linear-gradient(180deg,#171b23,#0d1117)] p-2">
-              <img
-                src={draft.imageSrc}
-                alt={draft.label}
-                className="h-full w-full object-contain"
-              />
-            </div>
-            <div className="mt-2 flex items-center justify-between gap-2">
-              <span className="text-sm text-white">{draft.label}</span>
-              {isSelected && (
-                <span className="rounded-full border border-emerald-400/30 bg-emerald-500/10 px-2 py-0.5 text-[11px] text-emerald-100">
-                  当前
-                </span>
-              )}
-            </div>
-          </button>
-        );
-      })}
-    </div>
-  );
-}
-
-export default function QwenSpriteSheetTool() {
-  const initialActionTemplateId: QwenSpriteActionTemplateId = 'idle';
-  const [assetKey, setAssetKey] = useState('qwen-sprite-demo');
-  const [characterBrief, setCharacterBrief] = useState(DEFAULT_CHARACTER_BRIEF);
-  const [styleReferenceBoardSource, setStyleReferenceBoardSource] = useState('');
-  const masterCandidateCount = 2;
-  const masterSeed = 1101;
-  const masterPromptExtend = true;
-  const [masterDrafts, setMasterDrafts] = useState<QwenSpriteImageDraft[]>([]);
-  const [selectedMasterDraftId, setSelectedMasterDraftId] = useState('');
-  const [selectedMasterSource, setSelectedMasterSource] = useState('');
-  const [masterStatus, setMasterStatus] = useState<string | null>(null);
-  const [isGeneratingMaster, setIsGeneratingMaster] = useState(false);
-
-  const [actionTemplateId, setActionTemplateId] =
-    useState<QwenSpriteActionTemplateId>(initialActionTemplateId);
-  const [actionKey, setActionKey] = useState(initialActionTemplateId);
-  const [actionGenerationMode, setActionGenerationMode] = useState<
-    'direct-sheet' | 'image-to-video'
-  >('image-to-video');
-  const [actionDetailText, setActionDetailText] = useState(
-    getActionTemplateById(initialActionTemplateId).defaultDetailText ?? '',
-  );
-  const [sheetCandidateCount, setSheetCandidateCount] = useState(2);
-  const [sheetSeed, setSheetSeed] = useState(2101);
-  const [sheetPromptExtend, setSheetPromptExtend] = useState(false);
-  const [sheetDrafts, setSheetDrafts] = useState<QwenSpriteImageDraft[]>([]);
-  const [selectedSheetDraftId, setSelectedSheetDraftId] = useState('');
-  const [editedSheetSource, setEditedSheetSource] = useState('');
-  const [sheetStatus, setSheetStatus] = useState<string | null>(null);
-  const [isGeneratingSheet, setIsGeneratingSheet] = useState(false);
-  const [actionVideoPreviewPath, setActionVideoPreviewPath] = useState('');
-  const [useChromaKey, setUseChromaKey] = useState(true);
-
-  const [frameDataUrls, setFrameDataUrls] = useState<string[]>([]);
-  const [frameWidth, setFrameWidth] = useState(0);
-  const [frameHeight, setFrameHeight] = useState(0);
-  const [activeFrames, setActiveFrames] = useState<number[]>([]);
-  const [frameOrder, setFrameOrder] = useState<number[]>([]);
-  const [selectedFrameIndex, setSelectedFrameIndex] = useState(0);
-  const [fps, setFps] = useState(8);
-  const [isPreviewPlaying, setIsPreviewPlaying] = useState(true);
-  const [previewCursor, setPreviewCursor] = useState(0);
-
-  const [repairIssueText, setRepairIssueText] = useState(
-    '修复手脚、武器和朝向，使这一帧与相邻帧连续。',
-  );
-  const [repairModel, setRepairModel] = useState('qwen-image-2.0');
-  const [repairSeed, setRepairSeed] = useState(3101);
-  const [repairPromptExtend, setRepairPromptExtend] = useState(false);
-  const [repairNeighborDirection, setRepairNeighborDirection] = useState<
-    'previous' | 'next'
-  >('previous');
-  const [repairStatus, setRepairStatus] = useState<string | null>(null);
-  const [lastRepairPreview, setLastRepairPreview] = useState('');
-  const [isRepairingFrame, setIsRepairingFrame] = useState(false);
-
-  const [saveStatus, setSaveStatus] = useState<string | null>(null);
-  const [isSaving, setIsSaving] = useState(false);
-  const previousAutoActionDetailRef =
-    useRef<QwenSpriteActionTemplateId>(initialActionTemplateId);
-  const preserveEditorStateRef = useRef(false);
-  const editorStateShapeRef = useRef({
-    activeLength: 0,
-    orderLength: 0,
-  });
-
-  const actionTemplate = useMemo(
-    () => getActionTemplateById(actionTemplateId),
-    [actionTemplateId],
-  );
-  const masterPromptText = useMemo(
-    () => buildMasterPrompt(characterBrief),
-    [characterBrief],
-  );
-  const masterNegativePrompt = useMemo(
-    () => buildMasterNegativePrompt(characterBrief),
-    [characterBrief],
-  );
-  const masterModel = 'qwen-image-2.0';
-  const masterSize = '1024*1024';
-  const sheetNegativePrompt = useMemo(
-    () => buildSheetNegativePrompt(characterBrief),
-    [characterBrief],
-  );
-  const repairNegativePrompt = useMemo(
-    () => buildRepairNegativePrompt(characterBrief),
-    [characterBrief],
-  );
-  const sheetModel = 'qwen-image-2.0';
-  const sheetSize = '1024*1024';
-  const resolvedActionAnimationState = useMemo(
-    () => mapActionTemplateIdToAnimationState(actionTemplateId),
-    [actionTemplateId],
-  );
-  const sheetPromptText = useMemo(
-    () =>
-      buildSheetPrompt({
-        characterBrief,
-        actionTemplate,
-        extraDirection: `动作细节描述：${actionDetailText.trim()}`,
-      }),
-    [actionDetailText, actionTemplate, characterBrief],
-  );
-  const repairPromptText = useMemo(
-    () =>
-      buildRepairPrompt({
-        issueText: repairIssueText,
-        useNeighborLabel:
-          repairNeighborDirection === 'previous' ? '上一帧' : '下一帧',
-      }),
-    [repairIssueText, repairNeighborDirection],
-  );
-  const videoActionPrompt = useMemo(
-    () =>
-      buildVideoActionPrompt({
-        actionTemplate,
-        actionDetailText,
-        characterBrief,
-        useChromaKey,
-      }),
-    [actionDetailText, actionTemplate, characterBrief, useChromaKey],
-  );
-  const previewFrames = useMemo(
-    () => buildOrderedActiveFrameSources(frameDataUrls, frameOrder, activeFrames),
-    [activeFrames, frameDataUrls, frameOrder],
-  );
-
-  useEffect(() => {
-    setActionKey(actionTemplate.id);
-    setFps(actionTemplate.defaultFps);
-    setActionDetailText((currentValue) => {
-      const previousTemplate = getActionTemplateById(
-        previousAutoActionDetailRef.current,
-      );
-      previousAutoActionDetailRef.current = actionTemplate.id;
-      if (
-        !currentValue.trim() ||
-        currentValue.trim() === (previousTemplate.defaultDetailText ?? '').trim()
-      ) {
-        return actionTemplate.defaultDetailText ?? currentValue;
-      }
-      return currentValue;
-    });
-  }, [actionTemplate]);
-
-  useEffect(() => {
-    let isMounted = true;
-
-    void buildPlayableCharacterStyleReferenceBoard()
-      .then((nextBoard) => {
-        if (!isMounted) {
-          return;
-        }
-        setStyleReferenceBoardSource(nextBoard);
-      })
-      .catch((error) => {
-        if (!isMounted) {
-          return;
-        }
-        setMasterStatus(
-          error instanceof Error
-            ? error.message
-            : '构建默认风格参考板失败。',
-        );
-      });
-
-    return () => {
-      isMounted = false;
-    };
-  }, []);
-
-  useEffect(() => {
-    editorStateShapeRef.current = {
-      activeLength: activeFrames.length,
-      orderLength: frameOrder.length,
-    };
-  }, [activeFrames.length, frameOrder.length]);
-
-  useEffect(() => {
-    if (!editedSheetSource) {
-      setFrameDataUrls([]);
-      setFrameWidth(0);
-      setFrameHeight(0);
-      setActiveFrames([]);
-      setFrameOrder([]);
-      return;
-    }
-
-    let isMounted = true;
-    void sliceSpriteSheetFrames(editedSheetSource, { rows: 4, cols: 4 }).then(
-      (result) => {
-        if (!isMounted) {
-          return;
-        }
-        setFrameDataUrls(result.frames);
-        setFrameWidth(result.frameWidth);
-        setFrameHeight(result.frameHeight);
-        if (
-          preserveEditorStateRef.current &&
-          editorStateShapeRef.current.orderLength === result.frames.length &&
-          editorStateShapeRef.current.activeLength > 0
-        ) {
-          preserveEditorStateRef.current = false;
-          return;
-        }
-        preserveEditorStateRef.current = false;
-        setActiveFrames(buildDefaultFrameOrder(result.frames.length));
-        setFrameOrder(buildDefaultFrameOrder(result.frames.length));
-        setSelectedFrameIndex(0);
-        setPreviewCursor(0);
-      },
-    ).catch((error) => {
-      if (!isMounted) {
-        return;
-      }
-      setSheetStatus(
-        error instanceof Error ? error.message : '切分精灵表失败。',
-      );
-    });
-
-    return () => {
-      isMounted = false;
-    };
-  }, [editedSheetSource]);
-
-  useEffect(() => {
-    setPreviewCursor(0);
-    if (!isPreviewPlaying || previewFrames.length <= 1) {
-      return undefined;
-    }
-
-    const intervalId = window.setInterval(() => {
-      setPreviewCursor((current) => (current + 1) % previewFrames.length);
-    }, Math.max(60, Math.round(1000 / Math.max(1, fps))));
-
-    return () => window.clearInterval(intervalId);
-  }, [fps, isPreviewPlaying, previewFrames]);
-
-  const handleGenerateMaster = async () => {
-    setIsGeneratingMaster(true);
-    setMasterStatus(null);
-    try {
-      const result = await generateQwenSpriteMaster({
-        promptText: masterPromptText,
-        negativePrompt: masterNegativePrompt,
-        model: masterModel,
-        size: masterSize,
-        promptExtend: masterPromptExtend,
-        candidateCount: masterCandidateCount,
-        seed: masterSeed > 0 ? masterSeed : undefined,
-        referenceImages: styleReferenceBoardSource
-          ? [styleReferenceBoardSource]
-          : [],
-      });
-      setMasterDrafts(result.drafts);
-      setSelectedMasterDraftId(result.drafts[0]?.id ?? '');
-      setSelectedMasterSource(result.drafts[0]?.imageSrc ?? '');
-      setMasterStatus(`已生成 ${result.drafts.length} 个主图候选。`);
-    } catch (error) {
-      setMasterStatus(error instanceof Error ? error.message : '生成主图失败。');
-    } finally {
-      setIsGeneratingMaster(false);
-    }
-  };
-
-  const handleGenerateSheet = async () => {
-    if (!selectedMasterSource) {
-      setSheetStatus('请先锁定主图。');
-      return;
-    }
-    setIsGeneratingSheet(true);
-    setSheetStatus(null);
-    try {
-      if (actionGenerationMode === 'image-to-video') {
-        const result = await generateCharacterAnimationDraft({
-          characterId: assetKey || 'qwen-sprite-tool',
-          strategy: 'image-to-video',
-          animation: actionKey,
-          promptText: videoActionPrompt,
-          visualSource: selectedMasterSource,
-          referenceImageDataUrls: [],
-          referenceVideoDataUrls: [],
-          lastFrameImageDataUrl: selectedMasterSource,
-          frameCount: 16,
-          fps: actionTemplate.defaultFps,
-          durationSeconds: FIXED_IMAGE_TO_VIDEO_DURATION_SECONDS,
-          loop: actionTemplate.loop,
-          useChromaKey,
-          resolution: FIXED_IMAGE_TO_VIDEO_RESOLUTION,
-          ratio: '1:1',
-          imageSequenceModel: 'wan2.7-image-pro',
-          videoModel: FIXED_IMAGE_TO_VIDEO_MODEL,
-          referenceVideoModel: 'wan2.7-r2v',
-          motionTransferModel: 'wan2.2-animate-move',
-        });
-
-        if (result.strategy !== 'image-to-video') {
-          throw new Error('动作生成接口返回了非预期结果。');
-        }
-
-        const clip = await buildAnimationClipFromVideoSource(
-          result.previewVideoPath,
-          {
-            animation: resolvedActionAnimationState,
-            fps: actionTemplate.defaultFps,
-            loop: actionTemplate.loop,
-            frameCount: 16,
-            frameWidth: GENERATED_FRAME_WIDTH,
-            frameHeight: GENERATED_FRAME_HEIGHT,
-            applyChromaKey: useChromaKey,
-            sampleStartRatio: actionTemplate.loop ? 0.12 : 0,
-            sampleEndRatio: actionTemplate.loop ? 0.94 : 1,
-          },
-        );
-        const composedSheet = await composeSpriteSheetFromFrames(clip.frames, {
-          cols: 4,
-          rows: 4,
-          frameWidth: clip.frameWidth,
-          frameHeight: clip.frameHeight,
-          padToGrid: true,
-        });
-        const videoDraftId = `${assetKey || 'qwen-sprite'}-video-${Date.now()}`;
-        setActionVideoPreviewPath(result.previewVideoPath);
-        setSheetDrafts([
-          {
-            id: videoDraftId,
-            label: '图生视频抽帧结果',
-            imageSrc: composedSheet.dataUrl,
-          },
-        ]);
-        setSelectedSheetDraftId(videoDraftId);
-        setEditedSheetSource(composedSheet.dataUrl);
-        setFps(actionTemplate.defaultFps);
-        setSheetStatus(
-          '图生视频已生成，并已自动抽帧为 16 帧精灵表草稿。',
-        );
-      } else {
-        const result = await generateQwenSpriteSheet({
-          promptText: sheetPromptText,
-          negativePrompt: sheetNegativePrompt,
-          model: sheetModel,
-          size: sheetSize,
-          promptExtend: sheetPromptExtend,
-          candidateCount: sheetCandidateCount,
-          seed: sheetSeed > 0 ? sheetSeed : undefined,
-          referenceImages: [selectedMasterSource],
-        });
-        setActionVideoPreviewPath('');
-        setSheetDrafts(result.drafts);
-        setSelectedSheetDraftId(result.drafts[0]?.id ?? '');
-        setEditedSheetSource(result.drafts[0]?.imageSrc ?? '');
-        setSheetStatus(`已生成 ${result.drafts.length} 张精灵表候选。`);
-      }
-    } catch (error) {
-      const rawMessage =
-        error instanceof Error ? error.message : '生成精灵表失败。';
-      if (
-        actionGenerationMode === 'image-to-video' &&
-        /DataInspectionFailed/u.test(rawMessage)
-      ) {
-        setSheetStatus(
-          '图生视频请求已到达模型侧，但触发了供应商内容审查。建议把动作细节描述改得更中性一些，减少暴力/未成年感/敏感词，再试一次；也可以临时切回“直接生成精灵表”方案。',
-        );
-      } else {
-        setSheetStatus(rawMessage);
-      }
-    } finally {
-      setIsGeneratingSheet(false);
-    }
-  };
-
-  const handleRepairFrame = async () => {
-    if (!selectedMasterSource || !editedSheetSource || !frameDataUrls.length) {
-      setRepairStatus('请先准备主图和精灵表。');
-      return;
-    }
-
-    const currentOrderIndex = frameOrder.indexOf(selectedFrameIndex);
-    const neighborOrderIndex =
-      repairNeighborDirection === 'previous'
-        ? Math.max(0, currentOrderIndex - 1)
-        : Math.min(frameOrder.length - 1, currentOrderIndex + 1);
-    const neighborFrameIndex =
-      frameOrder[neighborOrderIndex] ?? selectedFrameIndex;
-
-    setIsRepairingFrame(true);
-    setRepairStatus(null);
-    try {
-      const neighborFrame = await extractSpriteFrame(editedSheetSource, {
-        rows: 4,
-        cols: 4,
-        frameIndex: neighborFrameIndex,
-        outputSize: 512,
-      });
-      const currentFrame = await extractSpriteFrame(editedSheetSource, {
-        rows: 4,
-        cols: 4,
-        frameIndex: selectedFrameIndex,
-        outputSize: 512,
-      });
-      const result = await repairQwenSpriteFrame({
-        promptText: repairPromptText,
-        negativePrompt: repairNegativePrompt,
-        model: repairModel,
-        size: '512*512',
-        promptExtend: repairPromptExtend,
-        seed: repairSeed > 0 ? repairSeed : undefined,
-        referenceImages: [selectedMasterSource, neighborFrame, currentFrame],
-      });
-      const repairedFrame = result.repairedFrame?.imageSrc ?? '';
-      if (!repairedFrame) {
-        throw new Error('修帧接口没有返回图片。');
-      }
-      const nextSheetSource = await replaceSpriteFrame(editedSheetSource, {
-        rows: 4,
-        cols: 4,
-        frameIndex: selectedFrameIndex,
-        replacementSource: repairedFrame,
-      });
-      preserveEditorStateRef.current = true;
-      setEditedSheetSource(nextSheetSource);
-      setLastRepairPreview(repairedFrame);
-      setRepairStatus(`已修复第 ${selectedFrameIndex + 1} 帧。`);
-    } catch (error) {
-      setRepairStatus(error instanceof Error ? error.message : '修帧失败。');
-    } finally {
-      setIsRepairingFrame(false);
-    }
-  };
-
-  const handleSaveAsset = async () => {
-    if (!editedSheetSource || frameDataUrls.length === 0) {
-      setSaveStatus('请先生成并确认一张精灵表。');
-      return;
-    }
-    const orderedActiveFrameSources = buildOrderedActiveFrameSources(
-      frameDataUrls,
-      frameOrder,
-      activeFrames,
-    );
-    if (orderedActiveFrameSources.length === 0) {
-      setSaveStatus('至少要保留一帧后再保存。');
-      return;
-    }
-
-    setIsSaving(true);
-    setSaveStatus(null);
-    try {
-      const composedSheet = await composeSpriteSheetFromFrames(
-        orderedActiveFrameSources,
-        {
-          cols: 4,
-          rows: 4,
-          frameWidth: frameWidth || undefined,
-          frameHeight: frameHeight || undefined,
-          padToGrid: true,
-        },
-      );
-      const result = await saveQwenSpriteAsset({
-        assetKey,
-        actionKey,
-        masterSource: selectedMasterSource,
-        sheetSource: composedSheet.dataUrl,
-        framesDataUrls: orderedActiveFrameSources,
-        metadata: {
-          generationMode: actionGenerationMode,
-          rows: composedSheet.rows,
-          cols: composedSheet.cols,
-          sourceFrameCount: frameDataUrls.length,
-          frameCount: orderedActiveFrameSources.length,
-          frameWidth: composedSheet.frameWidth,
-          frameHeight: composedSheet.frameHeight,
-          fps,
-          loop: actionTemplate.loop,
-          activeFrames,
-          frameOrder,
-          actionTemplateId,
-          actionDetailText,
-          previewVideoPath: actionVideoPreviewPath || undefined,
-        },
-        prompts: {
-          characterBrief,
-          masterPromptText,
-          masterNegativePrompt,
-          sheetPromptText,
-          sheetNegativePrompt,
-          videoActionPrompt,
-          repairPromptText,
-          repairNegativePrompt,
-        },
-      });
-      setSaveStatus(`${result.saveMessage} 目录：${result.assetDir}`);
-    } catch (error) {
-      setSaveStatus(error instanceof Error ? error.message : '保存失败。');
-    } finally {
-      setIsSaving(false);
-    }
-  };
-
-  return (
-    <div className="min-h-screen bg-[#0a0c10] text-zinc-100">
-      <div className="mx-auto max-w-[1700px] px-4 py-6 sm:px-6 lg:px-8">
-        <div className="mb-6 rounded-3xl border border-emerald-400/20 bg-[radial-gradient(circle_at_top_left,rgba(16,185,129,0.18),transparent_40%),linear-gradient(180deg,#151a22,#0c1016)] p-6">
-          <div className="text-xs uppercase tracking-[0.28em] text-emerald-300/80">
-            Qwen Sprite Tool
-          </div>
-          <h1 className="mt-2 text-3xl font-semibold text-white">
-            Qwen-Image-2.0 精灵表工坊
-          </h1>
-          <p className="mt-3 max-w-5xl text-sm leading-relaxed text-zinc-300">
-            先锁主图，再用动作模板生成 4x4 / 16 帧 Sprite Sheet，随后做单帧修复、
-            帧启停、帧序调整、FPS 调整，并保存为本地资产。
-          </p>
-        </div>
-
-        <div className="grid gap-4 xl:grid-cols-[420px_1fr]">
-          <div className="space-y-4">
-            <SectionCard title="基础信息" description="保存时会落到 public/generated-qwen-sprites。">
-              <div className="space-y-4">
-                <TextField label="资产标识" value={assetKey} onChange={setAssetKey} />
-                <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
-                  当前动作标识：{actionKey}
-                </div>
-              </div>
-            </SectionCard>
-
-            <SectionCard title="阶段 A：主图" description="这里只输入角色描述。工具会自动绑定项目内可扮演角色的像素风样式参考，并强制使用身体朝右的动作角色视角。">
-              <div className="space-y-4">
-                <TextAreaField
-                  label="角色描述与设定"
-                  value={characterBrief}
-                  onChange={setCharacterBrief}
-                  rows={5}
-                  placeholder="例如：Q版大头身少女剑士，头部占比更大，明亮表情，双刃或短剑，轻装冒险服。"
-                />
-                <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-xs leading-relaxed text-zinc-400">
-                  阶段 A 会自动附加项目内可扮演角色的风格参考板，默认强制像素风、Q版大头身、侧身朝右、全身完整、适合后续动作生成。
-                </div>
-                {styleReferenceBoardSource && (
-                  <div className="overflow-hidden rounded-2xl border border-white/10 bg-black/20 p-3">
-                    <div className="mb-2 text-xs uppercase tracking-[0.2em] text-zinc-400">
-                      自动风格参考板
-                    </div>
-                    <div className="flex h-[220px] items-center justify-center overflow-hidden rounded-xl border border-white/10 bg-[linear-gradient(180deg,#171b23,#0d1117)] p-2">
-                      <img
-                        src={styleReferenceBoardSource}
-                        alt="自动风格参考板"
-                        className="h-full w-full object-contain pixelated"
-                        style={{ imageRendering: 'pixelated' }}
-                      />
-                    </div>
-                  </div>
-                )}
-                <button
-                  type="button"
-                  onClick={() => void handleGenerateMaster()}
-                  disabled={isGeneratingMaster}
-                  className="inline-flex w-full items-center justify-center gap-2 rounded-xl bg-emerald-500 px-4 py-3 text-sm font-medium text-black transition hover:bg-emerald-400 disabled:cursor-not-allowed disabled:opacity-60"
-                >
-                  <Upload className="h-4 w-4" />
-                  <span>{isGeneratingMaster ? '生成中...' : '生成主图候选'}</span>
-                </button>
-                {selectedMasterSource && (
-                  <div className="overflow-hidden rounded-2xl border border-emerald-400/20 bg-black/20 p-3">
-                    <div className="mb-2 text-xs uppercase tracking-[0.2em] text-emerald-200/80">
-                      当前主图
-                    </div>
-                    <div className="flex h-[260px] items-center justify-center overflow-hidden rounded-xl border border-white/10 bg-[linear-gradient(180deg,#171b23,#0d1117)] p-2">
-                      <img
-                        src={selectedMasterSource}
-                        alt="当前主图"
-                        className="h-full w-full object-contain"
-                      />
-                    </div>
-                  </div>
-                )}
-                {masterStatus && <StatusNote title="主图状态" message={masterStatus} />}
-              </div>
-            </SectionCard>
-
-            <SectionCard title="阶段 B：动作生成" description="这里只选择动作类型并填写动作细节描述。工具会自动在底层拼接视频/精灵表提示词。">
-              <div className="space-y-4">
-                <SelectField
-                  label="生成方案"
-                  value={actionGenerationMode}
-                  onChange={(value) =>
-                    setActionGenerationMode(
-                      value as 'direct-sheet' | 'image-to-video',
-                    )
-                  }
-                  options={ACTION_GENERATION_MODE_OPTIONS}
-                />
-                <SelectField
-                  label="动作模板"
-                  value={actionTemplateId}
-                  onChange={(value) => setActionTemplateId(value as QwenSpriteActionTemplateId)}
-                  options={QWEN_SPRITE_ACTION_TEMPLATES.map((template) => ({
-                    label: template.label,
-                    value: template.id,
-                  }))}
-                />
-                <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-xs leading-relaxed text-zinc-400">
-                  当前模板：{actionTemplate.label} / 默认 {actionTemplate.defaultFps} FPS / {actionTemplate.loop ? '循环动作' : '一次性动作'}
-                </div>
-                <TextAreaField
-                  label="动作细节描述"
-                  value={actionDetailText}
-                  onChange={setActionDetailText}
-                  rows={4}
-                  placeholder="例如：先轻微下压蓄力，再迅速前踏横斩，收招干净，动作利落。"
-                />
-                <TextAreaField
-                  label={
-                    actionGenerationMode === 'image-to-video'
-                      ? '底层视频提示词预览（自动生成）'
-                      : '底层精灵表提示词预览（自动生成）'
-                  }
-                  value={
-                    actionGenerationMode === 'image-to-video'
-                      ? videoActionPrompt
-                      : sheetPromptText
-                  }
-                  onChange={() => {}}
-                  rows={6}
-                  disabled
-                />
-                {actionGenerationMode === 'image-to-video' ? (
-                  <>
-                    <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-xs leading-relaxed text-zinc-400">
-                      当前走图生视频方案：工具会自动把主图送进官方首尾帧视频模型 `doubao-seedance-2-0-fast-260128`，固定按 `1:1 / 480p / 4 秒` 生成，再自动抽成 16 帧精灵表。
-                    </div>
-                    <div className="grid gap-3 sm:grid-cols-2">
-                      <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
-                        <div className="text-xs uppercase tracking-[0.18em] text-zinc-500">
-                          视频模型
-                        </div>
-                        <div className="mt-1">{FIXED_IMAGE_TO_VIDEO_MODEL}</div>
-                      </div>
-                      <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
-                        <div className="text-xs uppercase tracking-[0.18em] text-zinc-500">
-                          清晰度
-                        </div>
-                        <div className="mt-1">{FIXED_IMAGE_TO_VIDEO_RESOLUTION}</div>
-                      </div>
-                    </div>
-                    <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
-                      <div className="text-xs uppercase tracking-[0.18em] text-zinc-500">
-                        视频时长
-                      </div>
-                      <div className="mt-1">{FIXED_IMAGE_TO_VIDEO_DURATION_SECONDS} 秒</div>
-                    </div>
-                    <label className="flex items-center gap-3 rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-200">
-                      <input
-                        type="checkbox"
-                        checked={useChromaKey}
-                        onChange={(event) => setUseChromaKey(event.target.checked)}
-                        className="h-4 w-4 rounded border-white/20 bg-black/40"
-                      />
-                      <span>强制绿幕背景，方便后续抽帧抠像</span>
-                    </label>
-                  </>
-                ) : (
-                  <>
-                    <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-xs leading-relaxed text-zinc-400">
-                      当前走直接精灵表方案：工具会自动基于动作模板和细节描述拼底层提示词。
-                    </div>
-                    <NumberField label="候选数量" value={sheetCandidateCount} onChange={setSheetCandidateCount} min={1} />
-                    <NumberField label="种子" value={sheetSeed} onChange={setSheetSeed} min={0} />
-                    <label className="flex items-center gap-3 rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-200">
-                      <input
-                        type="checkbox"
-                        checked={sheetPromptExtend}
-                        onChange={(event) => setSheetPromptExtend(event.target.checked)}
-                        className="h-4 w-4 rounded border-white/20 bg-black/40"
-                      />
-                      <span>启用 prompt_extend</span>
-                    </label>
-                  </>
-                )}
-                <button
-                  type="button"
-                  onClick={() => void handleGenerateSheet()}
-                  disabled={isGeneratingSheet || !selectedMasterSource}
-                  className="inline-flex w-full items-center justify-center gap-2 rounded-xl bg-emerald-500 px-4 py-3 text-sm font-medium text-black transition hover:bg-emerald-400 disabled:cursor-not-allowed disabled:opacity-60"
-                >
-                  <Sparkles className="h-4 w-4" />
-                  <span>
-                    {isGeneratingSheet
-                      ? '生成中...'
-                      : actionGenerationMode === 'image-to-video'
-                        ? '生成动作视频并抽帧'
-                        : '生成精灵表候选'}
-                  </span>
-                </button>
-                {sheetStatus && <StatusNote title="精灵表状态" message={sheetStatus} />}
-              </div>
-            </SectionCard>
-          </div>
-
-          <div className="space-y-4">
-            {masterDrafts.length > 0 && (
-              <SectionCard title="主图候选">
-                <DraftStrip
-                  drafts={masterDrafts}
-                  selectedId={selectedMasterDraftId}
-                  onSelect={(draft) => {
-                    setSelectedMasterDraftId(draft.id);
-                    setSelectedMasterSource(draft.imageSrc);
-                  }}
-                />
-              </SectionCard>
-            )}
-
-            {sheetDrafts.length > 0 && (
-              <SectionCard title="精灵表候选">
-                <DraftStrip
-                  drafts={sheetDrafts}
-                  selectedId={selectedSheetDraftId}
-                  onSelect={(draft) => {
-                    setSelectedSheetDraftId(draft.id);
-                    setEditedSheetSource(draft.imageSrc);
-                  }}
-                />
-              </SectionCard>
-            )}
-
-            <SectionCard title="阶段 C：视频抽帧结果 / 精灵表编辑">
-              <div className="grid gap-4 xl:grid-cols-[360px_1fr]">
-                <div className="space-y-4">
-                  {actionVideoPreviewPath && (
-                    <div className="rounded-2xl border border-white/10 bg-black/20 p-4">
-                      <div className="mb-3 text-sm font-medium text-white">动作视频预览</div>
-                      <video
-                        src={actionVideoPreviewPath}
-                        controls
-                        loop
-                        muted
-                        className="w-full rounded-xl border border-white/10 bg-black/30"
-                      />
-                    </div>
-                  )}
-                  <div className="rounded-2xl border border-white/10 bg-black/20 p-4">
-                    <div className="mb-3 flex items-center justify-between">
-                      <div className="text-sm font-medium text-white">动画预览</div>
-                      <button
-                        type="button"
-                        onClick={() => setIsPreviewPlaying((current) => !current)}
-                        className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-black/20 px-3 py-2 text-xs text-zinc-100 transition hover:bg-white/10"
-                      >
-                        {isPreviewPlaying ? <Pause className="h-4 w-4" /> : <Play className="h-4 w-4" />}
-                        <span>{isPreviewPlaying ? '暂停' : '播放'}</span>
-                      </button>
-                    </div>
-                    <div className="flex h-[280px] items-center justify-center overflow-hidden rounded-xl border border-white/10 bg-black/20 p-3">
-                      {previewFrames[previewCursor] ? (
-                        <img
-                          src={previewFrames[previewCursor]}
-                          alt="动画预览"
-                          className="h-full w-full object-contain pixelated"
-                          style={{ imageRendering: 'pixelated' }}
-                        />
-                      ) : (
-                        <div className="text-sm text-zinc-500">生成精灵表后在这里预览</div>
-                      )}
-                    </div>
-                    <div className="mt-4 grid gap-3 sm:grid-cols-2">
-                      <NumberField label="FPS" value={fps} onChange={setFps} min={1} />
-                      <div className="rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
-                        <div>启用帧：{activeFrames.length}</div>
-                        <div className="mt-1">单格尺寸：{frameWidth || '-'} × {frameHeight || '-'}</div>
-                      </div>
-                    </div>
-                    <div className="mt-4 flex flex-wrap gap-3">
-                      <button
-                        type="button"
-                        onClick={async () => {
-                          const orderedActiveFrameSources =
-                            buildOrderedActiveFrameSources(
-                              frameDataUrls,
-                              frameOrder,
-                              activeFrames,
-                            );
-                          if (orderedActiveFrameSources.length === 0) {
-                            setSaveStatus('至少要保留一帧后再导出 PNG。');
-                            return;
-                          }
-                          const composedSheet = await composeSpriteSheetFromFrames(
-                            orderedActiveFrameSources,
-                            {
-                              cols: 4,
-                              rows: 4,
-                              frameWidth: frameWidth || undefined,
-                              frameHeight: frameHeight || undefined,
-                              padToGrid: true,
-                            },
-                          );
-                          await triggerDataUrlDownload(
-                            `${assetKey}-${actionKey}-sheet-edited.png`,
-                            composedSheet.dataUrl,
-                          );
-                        }}
-                        className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-100 transition hover:bg-white/10"
-                      >
-                        <Download className="h-4 w-4" />
-                        <span>下载整理后 PNG</span>
-                      </button>
-                      <button
-                        type="button"
-                        onClick={() =>
-                          triggerJsonDownload(`${assetKey}-${actionKey}-metadata.json`, {
-                            assetKey,
-                            actionKey,
-                            generationMode: actionGenerationMode,
-                            rows: 4,
-                            cols: 4,
-                            sourceFrameCount: frameDataUrls.length,
-                            frameCount: previewFrames.length,
-                            frameWidth,
-                            frameHeight,
-                            fps,
-                            loop: actionTemplate.loop,
-                            activeFrames,
-                            frameOrder,
-                            actionTemplateId,
-                            actionDetailText,
-                            previewVideoPath: actionVideoPreviewPath || undefined,
-                          })
-                        }
-                        className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-100 transition hover:bg-white/10"
-                      >
-                        <Download className="h-4 w-4" />
-                        <span>下载 JSON</span>
-                      </button>
-                      <button
-                        type="button"
-                        onClick={() => void handleSaveAsset()}
-                        disabled={isSaving}
-                        className="inline-flex items-center gap-2 rounded-lg border border-emerald-400/30 bg-emerald-500/10 px-4 py-2 text-sm text-emerald-100 transition hover:bg-emerald-500/20 disabled:cursor-not-allowed disabled:opacity-60"
-                      >
-                        <Save className="h-4 w-4" />
-                        <span>{isSaving ? '保存中...' : '保存到本地目录'}</span>
-                      </button>
-                    </div>
-                    {saveStatus && <div className="mt-4"><StatusNote title="保存状态" message={saveStatus} /></div>}
-                  </div>
-
-                  <div className="rounded-2xl border border-white/10 bg-black/20 p-4">
-                    <div className="mb-3 text-sm font-medium text-white">当前选中帧</div>
-                    <div className="flex h-[220px] items-center justify-center overflow-hidden rounded-xl border border-white/10 bg-black/20 p-3">
-                      {frameDataUrls[selectedFrameIndex] ? (
-                        <img
-                          src={frameDataUrls[selectedFrameIndex]}
-                          alt={`帧 ${selectedFrameIndex + 1}`}
-                          className="h-full w-full object-contain pixelated"
-                          style={{ imageRendering: 'pixelated' }}
-                        />
-                      ) : (
-                        <div className="text-sm text-zinc-500">暂无帧</div>
-                      )}
-                    </div>
-                    <div className="mt-4 flex flex-wrap gap-3">
-                      <button
-                        type="button"
-                        onClick={() =>
-                          setActiveFrames((current) => toggleActiveFrame(current, selectedFrameIndex))
-                        }
-                        className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-100 transition hover:bg-white/10"
-                      >
-                        <RefreshCcw className="h-4 w-4" />
-                        <span>{activeFrames.includes(selectedFrameIndex) ? '隐藏这一帧' : '重新启用'}</span>
-                      </button>
-                      <button
-                        type="button"
-                        onClick={() =>
-                          setFrameOrder((current) => moveFrameOrderItem(current, selectedFrameIndex, -1))
-                        }
-                        className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-100 transition hover:bg-white/10"
-                      >
-                        <ArrowLeft className="h-4 w-4" />
-                        <span>前移</span>
-                      </button>
-                      <button
-                        type="button"
-                        onClick={() =>
-                          setFrameOrder((current) => moveFrameOrderItem(current, selectedFrameIndex, 1))
-                        }
-                        className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-100 transition hover:bg-white/10"
-                      >
-                        <ArrowRight className="h-4 w-4" />
-                        <span>后移</span>
-                      </button>
-                      <button
-                        type="button"
-                        onClick={() => setActiveFrames(restoreAllFrames(frameDataUrls.length))}
-                        className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-100 transition hover:bg-white/10"
-                      >
-                        <RefreshCcw className="h-4 w-4" />
-                        <span>全部启用</span>
-                      </button>
-                      <button
-                        type="button"
-                        onClick={() => setFrameOrder(buildDefaultFrameOrder(frameDataUrls.length))}
-                        className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-black/20 px-4 py-2 text-sm text-zinc-100 transition hover:bg-white/10"
-                      >
-                        <RefreshCcw className="h-4 w-4" />
-                        <span>重置顺序</span>
-                      </button>
-                    </div>
-                  </div>
-
-                  <div className="rounded-2xl border border-white/10 bg-black/20 p-4">
-                    <div className="mb-3 flex items-center gap-2 text-sm font-medium text-white">
-                      <Wrench className="h-4 w-4" />
-                      <span>单帧修复</span>
-                    </div>
-                    <div className="space-y-4">
-                      <TextAreaField label="问题描述" value={repairIssueText} onChange={setRepairIssueText} rows={3} />
-                      <TextAreaField label="修帧提示词（自动生成）" value={repairPromptText} onChange={() => {}} rows={6} disabled />
-                      <TextAreaField
-                        label="修帧负向提示词（固定）"
-                        value={repairNegativePrompt}
-                        onChange={() => {}}
-                        rows={4}
-                        disabled
-                      />
-                      <SelectField
-                        label="连续性参考"
-                        value={repairNeighborDirection}
-                        onChange={(value) => setRepairNeighborDirection(value as 'previous' | 'next')}
-                        options={[
-                          { label: '上一帧', value: 'previous' },
-                          { label: '下一帧', value: 'next' },
-                        ]}
-                      />
-                      <SelectField label="模型" value={repairModel} onChange={setRepairModel} options={MODEL_OPTIONS} />
-                      <NumberField label="修帧种子" value={repairSeed} onChange={setRepairSeed} min={0} />
-                      <label className="flex items-center gap-3 rounded-xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-200">
-                        <input
-                          type="checkbox"
-                          checked={repairPromptExtend}
-                          onChange={(event) => setRepairPromptExtend(event.target.checked)}
-                          className="h-4 w-4 rounded border-white/20 bg-black/40"
-                        />
-                        <span>启用 prompt_extend</span>
-                      </label>
-                      <button
-                        type="button"
-                        onClick={() => void handleRepairFrame()}
-                        disabled={isRepairingFrame || !frameDataUrls.length}
-                        className="inline-flex items-center gap-2 rounded-xl bg-emerald-500 px-4 py-3 text-sm font-medium text-black transition hover:bg-emerald-400 disabled:cursor-not-allowed disabled:opacity-60"
-                      >
-                        <Wrench className="h-4 w-4" />
-                        <span>{isRepairingFrame ? '修复中...' : '修复当前帧'}</span>
-                      </button>
-                      {lastRepairPreview && (
-                        <div className="overflow-hidden rounded-xl border border-white/10 bg-black/20">
-                          <img src={lastRepairPreview} alt="最近修复结果" className="h-40 w-full object-contain" />
-                        </div>
-                      )}
-                      {repairStatus && <StatusNote title="修帧状态" message={repairStatus} />}
-                    </div>
-                  </div>
-                </div>
-
-                <div className="rounded-2xl border border-white/10 bg-black/20 p-4">
-                  <div className="mb-3 text-sm font-medium text-white">16 帧网格</div>
-                  <div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-4">
-                    {frameDataUrls.length > 0 ? (
-                      frameDataUrls.map((frameSource, frameIndex) => {
-                        const isSelected = frameIndex === selectedFrameIndex;
-                        const isActive = activeFrames.includes(frameIndex);
-                        const orderPosition = frameOrder.indexOf(frameIndex) + 1;
-                        return (
-                          <button
-                            key={`frame-${frameIndex}`}
-                            type="button"
-                            onClick={() => setSelectedFrameIndex(frameIndex)}
-                            className={`rounded-2xl border p-2 text-left transition ${
-                              isSelected
-                                ? 'border-emerald-400/40 bg-emerald-500/10'
-                                : 'border-white/10 bg-black/20 hover:border-white/20'
-                            }`}
-                          >
-                            <div className="flex h-[120px] items-center justify-center overflow-hidden rounded-xl border border-white/10 bg-[linear-gradient(180deg,#151922,#0b0f15)] p-2">
-                              <img
-                                src={frameSource}
-                                alt={`frame ${frameIndex + 1}`}
-                                className="h-full w-full object-contain pixelated"
-                                style={{ imageRendering: 'pixelated' }}
-                              />
-                            </div>
-                            <div className="mt-2 flex items-center justify-between gap-2 text-[11px]">
-                              <span className="text-zinc-300">帧 {frameIndex + 1}</span>
-                              <span
-                                className={`rounded-full border px-2 py-0.5 ${
-                                  isActive
-                                    ? 'border-emerald-400/30 bg-emerald-500/10 text-emerald-100'
-                                    : 'border-white/10 bg-black/30 text-zinc-500'
-                                }`}
-                              >
-                                {isActive ? `启用 #${orderPosition}` : '隐藏'}
-                              </span>
-                            </div>
-                          </button>
-                        );
-                      })
-                    ) : (
-                      <div className="col-span-full rounded-2xl border border-dashed border-white/10 px-4 py-16 text-center text-sm text-zinc-500">
-                        生成精灵表后，这里会自动切成 16 帧。
-                      </div>
-                    )}
-                  </div>
-                </div>
-              </div>
-            </SectionCard>
-          </div>
-        </div>
-      </div>
-    </div>
-  );
-}
diff --git a/src/tools/qwenSpriteSheetToolModel.test.ts b/src/tools/qwenSpriteSheetToolModel.test.ts
deleted file mode 100644
index b8550f71..00000000
--- a/src/tools/qwenSpriteSheetToolModel.test.ts
+++ /dev/null
@@ -1,147 +0,0 @@
-import {
-  buildDefaultFrameOrder,
-  DEFAULT_CHARACTER_BRIEF,
-  buildMasterNegativePrompt,
-  buildMasterPrompt,
-  buildOrderedActiveFrameIndices,
-  buildOrderedActiveFrameSources,
-  buildRepairNegativePrompt,
-  buildRepairPrompt,
-  buildSheetNegativePrompt,
-  buildSheetPrompt,
-  buildVideoActionPrompt,
-  getActionTemplateById,
-  moveFrameOrderItem,
-  PLAYABLE_CHARACTER_STYLE_REFERENCE_SOURCES,
-  restoreAllFrames,
-  toggleActiveFrame,
-} from './qwenSpriteSheetToolModel';
-
-describe('qwenSpriteSheetToolModel', () => {
-  it('builds ordered active frame indices from current order and active set', () => {
-    expect(buildOrderedActiveFrameIndices([3, 1, 0, 2], [0, 2, 3])).toEqual([
-      3, 0, 2,
-    ]);
-  });
-
-  it('builds ordered active frame sources', () => {
-    expect(
-      buildOrderedActiveFrameSources(
-        ['f0', 'f1', 'f2', 'f3'],
-        [3, 1, 0, 2],
-        [0, 2, 3],
-      ),
-    ).toEqual(['f3', 'f0', 'f2']);
-  });
-
-  it('moves a frame forward or backward in order', () => {
-    expect(moveFrameOrderItem([0, 1, 2, 3], 2, -1)).toEqual([0, 2, 1, 3]);
-    expect(moveFrameOrderItem([0, 1, 2, 3], 1, 1)).toEqual([0, 2, 1, 3]);
-    expect(moveFrameOrderItem([0, 1, 2, 3], 0, -1)).toEqual([0, 1, 2, 3]);
-  });
-
-  it('toggles active frames without duplicating indices', () => {
-    expect(toggleActiveFrame([0, 2, 3], 2)).toEqual([0, 3]);
-    expect(toggleActiveFrame([0, 3], 2)).toEqual([0, 2, 3]);
-  });
-
-  it('restores all frames to the default order', () => {
-    expect(buildDefaultFrameOrder(4)).toEqual([0, 1, 2, 3]);
-    expect(restoreAllFrames(4)).toEqual([0, 1, 2, 3]);
-  });
-
-  it('provides action-specific default detail text for all five action templates', () => {
-    const actionTemplateIds = ['idle', 'run', 'attack_slash', 'hurt', 'die'] as const;
-
-    actionTemplateIds.forEach((actionTemplateId) => {
-      const actionTemplate = getActionTemplateById(actionTemplateId);
-      expect(actionTemplate.defaultDetailText?.length ?? 0).toBeGreaterThan(20);
-      expect(actionTemplate.stagingDirection?.length ?? 0).toBeGreaterThan(8);
-    });
-  });
-
-  it('builds a sheet prompt that contains the template structure', () => {
-    const actionTemplate = getActionTemplateById('attack_slash');
-    const prompt = buildSheetPrompt({
-      characterBrief: '黑发青年剑士，右手持长剑。',
-      actionTemplate,
-      extraDirection: '每格边界清晰。',
-    });
-
-    expect(prompt).toContain('4x4');
-    expect(prompt).toContain('横斩攻击');
-    expect(prompt).toContain('1-4 帧');
-    expect(prompt).toContain('黑发青年剑士');
-    expect(prompt).toContain('每格边界清晰');
-    expect(prompt).toContain('大头身');
-  });
-
-  it('builds a master prompt with square canvas and richer world-character detail coverage', () => {
-    const prompt = buildMasterPrompt(DEFAULT_CHARACTER_BRIEF);
-
-    expect(prompt).toContain('1:1');
-    expect(prompt).toContain('sprite sheet');
-    expect(prompt).toContain('90');
-    expect(prompt).toContain(DEFAULT_CHARACTER_BRIEF);
-    expect(prompt).toContain('????????????');
-    expect(prompt).toContain('????????????????????????');
-  });
-
-  it('strengthens non-human species traits for siren-like characters', () => {
-    const prompt = buildMasterPrompt('海妖，海洋歌者，蓝绿色鳞片，海妖耳鳍。');
-    const negativePrompt = buildMasterNegativePrompt(
-      '海妖，海洋歌者，蓝绿色鳞片，海妖耳鳍。',
-    );
-
-    expect(prompt).toContain('如果文字设定没有明确要求非人身体结构，默认优先生成人形拟人化角色');
-    expect(prompt).toContain('严格约束身体结构骨架');
-    expect(prompt).toContain('沿用参考图的人形动作角色身体结构');
-    expect(prompt).toContain('主题词默认只作用在角色自身');
-    expect(negativePrompt).toContain('不要机械地把主题词直接画成完整怪物本体');
-  });
-
-  it('keeps theme words on the character instead of leaking into the background', () => {
-    const prompt = buildMasterPrompt('机械祭司，冷白金属外套，环形圣徽。');
-
-    expect(prompt).toContain('主题词默认只作用在角色自身');
-    expect(prompt).toContain('不要把主题词自动扩写成背景建筑');
-    expect(prompt).not.toContain('水母国王');
-  });
-
-  it('builds a repair prompt that keeps chibi ratio', () => {
-    const prompt = buildRepairPrompt({
-      issueText: '修复头部和手部比例。',
-      useNeighborLabel: '上一帧',
-    });
-
-    expect(prompt).toContain('上一帧');
-    expect(prompt).toContain('大头身');
-  });
-
-  it('builds a video action prompt with pixel style constraints', () => {
-    const actionTemplate = getActionTemplateById('run');
-    const prompt = buildVideoActionPrompt({
-      actionTemplate,
-      actionDetailText: '?????????????????????????????????????????????',
-      characterBrief: '?????????????????????????????????????????????',
-      useChromaKey: true,
-    });
-
-    expect(prompt).toContain(actionTemplate.label);
-    expect(prompt).toContain(actionTemplate.stagingDirection ?? '');
-    expect(prompt).toContain('90');
-    expect(prompt).toContain('Q');
-    expect(prompt).toContain('sprite');
-  });
-
-  it('builds generic theme over-literalization negatives', () => {
-    expect(buildSheetNegativePrompt('海妖')).toContain('不要机械地把主题词直接画成完整怪物本体');
-    expect(buildRepairNegativePrompt('海妖')).toContain('不要机械地把主题词直接画成完整怪物本体');
-    expect(buildMasterNegativePrompt('机械祭司')).toContain('不要把主题词自动扩写成角色以外的场景元素');
-  });
-
-  it('contains built-in playable character style reference sources', () => {
-    expect(PLAYABLE_CHARACTER_STYLE_REFERENCE_SOURCES.length).toBeGreaterThan(0);
-    expect(PLAYABLE_CHARACTER_STYLE_REFERENCE_SOURCES.some((source) => source.includes('Girl Hero 1'))).toBe(true);
-  });
-});
diff --git a/src/tools/qwenSpriteSheetToolModel.ts b/src/tools/qwenSpriteSheetToolModel.ts
deleted file mode 100644
index c771d312..00000000
--- a/src/tools/qwenSpriteSheetToolModel.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from '../prompts/qwenSpriteSheetToolPrompts';
diff --git a/src/tools/qwenSpriteSheetToolPersistence.ts b/src/tools/qwenSpriteSheetToolPersistence.ts
deleted file mode 100644
index 1f937e9c..00000000
--- a/src/tools/qwenSpriteSheetToolPersistence.ts
+++ /dev/null
@@ -1,113 +0,0 @@
-import {
-  ASSET_API_PATHS,
-  postApiJson,
-} from '../editor/shared/editorApiClient';
-
-const QWEN_SPRITE_MASTER_API_PATH = ASSET_API_PATHS.qwenSpriteMaster;
-const QWEN_SPRITE_SHEET_API_PATH = ASSET_API_PATHS.qwenSpriteSheet;
-const QWEN_SPRITE_FRAME_REPAIR_API_PATH =
-  ASSET_API_PATHS.qwenSpriteFrameRepair;
-const QWEN_SPRITE_SAVE_API_PATH = ASSET_API_PATHS.qwenSpriteSave;
-
-export type QwenSpriteImageDraft = {
-  id: string;
-  label: string;
-  imageSrc: string;
-  remoteUrl?: string;
-};
-
-export type GenerateQwenSpritePayload = {
-  promptText: string;
-  negativePrompt: string;
-  model: string;
-  size: string;
-  promptExtend: boolean;
-  candidateCount: number;
-  seed?: number;
-  referenceImages: string[];
-};
-
-export type RepairQwenSpriteFramePayload = {
-  promptText: string;
-  negativePrompt: string;
-  model: string;
-  size: string;
-  promptExtend: boolean;
-  seed?: number;
-  referenceImages: string[];
-};
-
-export type SaveQwenSpriteAssetPayload = {
-  assetKey: string;
-  actionKey: string;
-  masterSource: string;
-  sheetSource: string;
-  framesDataUrls: string[];
-  metadata: Record<string, unknown>;
-  prompts: Record<string, unknown>;
-};
-
-async function postJson<T>(
-  url: string,
-  payload: Record<string, unknown>,
-  fallbackMessage: string,
-) {
-  return postApiJson<T>(url, payload, fallbackMessage);
-}
-
-export async function generateQwenSpriteMaster(
-  payload: GenerateQwenSpritePayload,
-) {
-  return postJson<{
-    ok: true;
-    draftId: string;
-    drafts: QwenSpriteImageDraft[];
-    model: string;
-    size: string;
-    promptText: string;
-    negativePrompt: string;
-  }>(QWEN_SPRITE_MASTER_API_PATH, payload, '生成主图失败');
-}
-
-export async function generateQwenSpriteSheet(
-  payload: GenerateQwenSpritePayload,
-) {
-  return postJson<{
-    ok: true;
-    draftId: string;
-    drafts: QwenSpriteImageDraft[];
-    model: string;
-    size: string;
-    promptText: string;
-    negativePrompt: string;
-  }>(QWEN_SPRITE_SHEET_API_PATH, payload, '生成精灵表失败');
-}
-
-export async function repairQwenSpriteFrame(
-  payload: RepairQwenSpriteFramePayload,
-) {
-  return postJson<{
-    ok: true;
-    draftId: string;
-    drafts: QwenSpriteImageDraft[];
-    repairedFrame: QwenSpriteImageDraft | null;
-    model: string;
-    size: string;
-    promptText: string;
-    negativePrompt: string;
-  }>(QWEN_SPRITE_FRAME_REPAIR_API_PATH, payload, '修复帧失败');
-}
-
-export async function saveQwenSpriteAsset(
-  payload: SaveQwenSpriteAssetPayload,
-) {
-  return postJson<{
-    ok: true;
-    assetId: string;
-    assetDir: string;
-    masterImagePath: string | null;
-    sheetImagePath: string;
-    framePaths: string[];
-    saveMessage: string;
-  }>(QWEN_SPRITE_SAVE_API_PATH, payload, '保存精灵表失败');
-}
diff --git a/tsconfig.typecheck-guardrails.json b/tsconfig.typecheck-guardrails.json
index 7383e42d..4e9ad32e 100644
--- a/tsconfig.typecheck-guardrails.json
+++ b/tsconfig.typecheck-guardrails.json
@@ -30,7 +30,6 @@
     "src/components/MedievalNpcAnimator.tsx",
     "src/components/npcRenderUtils.ts",
     "src/components/CharacterDetailModal.tsx",
-    "src/components/NpcVisualEditor.tsx",
     "src/components/adventure-panel/**/*.tsx",
     "src/components/game-canvas/**/*.tsx",
     "src/components/game-shell/**/*.ts",
diff --git a/vitest.config.ts b/vitest.config.ts
index 970c43d8..d4a811d1 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -1,15 +1,6 @@
-import {fileURLToPath, URL} from 'node:url';
-
 import {defineConfig} from 'vitest/config';
 
 export default defineConfig({
-  resolve: {
-    alias: {
-      './customWorldCharacterLoadout': fileURLToPath(new URL('./src/data/customWorldCharacterLoadout.stub.ts', import.meta.url)),
-      '../data/customWorldCharacterLoadout': fileURLToPath(new URL('./src/data/customWorldCharacterLoadout.stub.ts', import.meta.url)),
-      '../../data/customWorldCharacterLoadout': fileURLToPath(new URL('./src/data/customWorldCharacterLoadout.stub.ts', import.meta.url)),
-    },
-  },
   test: {
     environment: 'node',
     globals: true,

From 13bc79306f7e7f61daae5b9436d2ae3d438f29f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=AB=98=E7=89=A9?= <253518756@qq.com>
Date: Tue, 21 Apr 2026 10:30:12 +0800
Subject: [PATCH 3/6] 1

---
 ...NG_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md |   25 +
 ...D_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md |   99 ++
 ...DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md |   96 ++
 ...AFT_RESULT_AUTOSAVE_DB_CHECK_2026-04-21.md |  119 ++
 ...HAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md | 1032 +++++++++++++++++
 ...ON_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md |    2 +
 ...END_MIGRATION_EXECUTION_PLAN_2026-04-21.md |  169 +++
 docs/technical/README.md                      |    3 +
 packages/shared/src/contracts/auth.ts         |    3 +-
 packages/shared/src/contracts/story.ts        |   23 +-
 server-node/src/auth/accessSessionCookie.ts   |   84 ++
 server-node/src/config.ts                     |   34 +
 server-node/src/middleware/auth.ts            |    6 +-
 .../modules/custom-world/runtimeProfile.ts    |  116 ++
 .../modules/quest/questStoryActionService.ts  |  316 +++++
 .../src/modules/story/runtimeSession.ts       |   15 +
 .../src/modules/story/storyActionRoutes.ts    |   32 +-
 .../src/modules/story/storyActionService.ts   |   82 +-
 server-node/src/routes/authRoutes.ts          |   33 +-
 server-node/src/routes/runtimeRoutes.ts       |   25 +
 .../services/customWorldAgentOrchestrator.ts  |  126 ++
 .../services/customWorldAgentPhase4.test.ts   |  156 +++
 .../services/customWorldAgentSessionStore.ts  |   50 +-
 .../services/customWorldWorkSummaryService.ts |    2 +-
 ...ustomWorldCreationHub.interaction.test.tsx |    6 +-
 .../CustomWorldCreationHub.test.tsx           |    2 +-
 .../CustomWorldCreationHub.tsx                |    6 +-
 .../custom-world-home/CustomWorldWorkCard.tsx |    7 +-
 .../game-shell/PlatformHomeView.tsx           |    2 +-
 ...meSelectionFlow.agent.interaction.test.tsx |  267 +++--
 .../game-shell/PreGameSelectionFlow.tsx       |  107 +-
 src/hooks/story/npcEncounterActions.test.ts   |  103 +-
 src/hooks/story/npcEncounterActions.ts        |  158 +--
 .../story/runtimeStoryCoordinator.test.ts     |   37 +-
 src/hooks/story/runtimeStoryCoordinator.ts    |   27 +-
 src/hooks/story/uiTypes.ts                    |    2 +-
 src/services/aiService.ts                     |   33 +-
 src/services/apiClient.test.ts                |  161 +--
 src/services/apiClient.ts                     |  107 +-
 src/services/authService.test.ts              |  312 ++---
 src/services/authService.ts                   |   22 +-
 .../customWorldAgentDraftResult.test.ts       |   82 ++
 src/services/customWorldAgentDraftResult.ts   |  345 ++++--
 .../customWorldAgentGenerationProgress.ts     |    9 +-
 src/services/platformBrowseHistory.ts         |  172 ---
 src/services/questDirector.ts                 |  184 +--
 src/services/runtimeItemAiDirector.ts         |  128 +-
 src/services/runtimeStoryService.test.ts      |   77 ++
 src/services/runtimeStoryService.ts           |   44 +-
 49 files changed, 3691 insertions(+), 1357 deletions(-)
 create mode 100644 docs/technical/AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md
 create mode 100644 docs/technical/AGENT_DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md
 create mode 100644 docs/technical/AGENT_DRAFT_RESULT_AUTOSAVE_DB_CHECK_2026-04-21.md
 create mode 100644 docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
 create mode 100644 docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md
 create mode 100644 server-node/src/auth/accessSessionCookie.ts
 delete mode 100644 src/services/platformBrowseHistory.ts

diff --git a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md
index 9e9f7a80..41ea6323 100644
--- a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md
@@ -127,6 +127,31 @@
 
 这属于仓库当前既有工程问题，不是本批次引入的新断裂。
 
+## 4.1 2026-04-21 补充修正：会话探测 401 自触发循环
+
+在这批收口完成后，前端又暴露出一条更细的鉴权恢复回路问题：
+
+1. `AuthGate` 启动时会调用 `getCurrentAuthUser()` 探测现有会话
+2. `/api/auth/me` 返回 `401` 时，`apiClient.ts` 会默认广播一次 `AUTH_STATE_EVENT`
+3. `AuthGate` 自己又监听这个事件并重新 `hydrate()`
+4. 最终形成 `hydrate -> /auth/me 401 -> emit -> hydrate` 的自触发循环
+
+这条链的问题不在“是否允许 401”，而在：
+
+**会话探测请求把“未登录态探测”错误地当成了“全局登录态变更”。**
+
+因此这里补了一条更细粒度的约束：
+
+1. `apiClient.ts` 新增 `notifyAuthStateChange` 选项，默认仍保持原有广播行为
+2. `getCurrentAuthUser()` 作为会话探测请求，显式关闭这类 401 广播
+3. 真实登录、登出、刷新成功后，仍保留全局鉴权变更通知
+
+这样修完后：
+
+1. `AuthGate` 仍会优先尝试服务端会话恢复
+2. 无会话时会正常落回未登录分支
+3. 不会因为探测型 401 把自己重新唤醒并刷爆控制台
+
 ---
 
 ## 5. 本批次完成后的实际收益
diff --git a/docs/technical/AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md b/docs/technical/AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md
new file mode 100644
index 00000000..31baf4db
--- /dev/null
+++ b/docs/technical/AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md
@@ -0,0 +1,99 @@
+# Agent 对话框与结果页精修职责边界修正
+
+更新时间：`2026-04-21`
+
+## 1. 结论
+
+本次修正把“Agent 对话框”和“结果页精修”重新拆清楚：
+
+1. `CustomWorldAgentWorkspace` 只负责八锚点信息收集、八锚点进度展示、八锚点完成后的“整理世界底稿”动作。
+2. “精修”不是 Agent 对话框里的概念，不再通过 Agent 建议动作进入角色、地点、世界总卡的局部修整。
+3. 已经生成底稿的草稿，从创作中心点击后进入结果页继续完善。
+4. 尚未生成底稿的草稿，从创作中心点击后才恢复 Agent 对话框继续补齐八锚点。
+5. 结果页负责成稿后的编辑、补全、进入世界前确认和自动保存，并通过 `sync_result_profile` 回写到当前 Agent session。
+
+一句话：
+
+**Agent 收八锚点，结果页做精修。**
+
+---
+
+## 2. 为什么要修正
+
+旧实现把 `object_refining` 草稿卡片显示成“继续精修”，但点击后直接恢复 Agent 工作区。
+
+这个行为会让用户产生两个误解：
+
+1. 以为精修是 Agent 对话框里的下一阶段。
+2. 以为 Agent 对话框不仅负责收集八锚点，还负责后续对象级编辑。
+
+这和当前产品边界不一致。Agent 对话框应该保持轻量，只用于拿到足够稳定的八锚点输入；对象、场景、封面、世界档案的修整都应该在结果页完成。
+
+---
+
+## 3. 当前落地规则
+
+### 3.1 创作中心草稿点击分流
+
+`custom-world/works` 返回 `agent_session` 草稿后，前端按草稿是否已有底稿内容分流：
+
+1. `playableNpcCount <= 0 && landmarkCount <= 0`
+   - 视为八锚点仍未整理成底稿。
+   - 点击进入 `agent-workspace`。
+2. `playableNpcCount > 0 || landmarkCount > 0`
+   - 视为已有可编辑底稿。
+   - 点击读取对应 Agent session，编译为 `CustomWorldProfile`，进入 `custom-world-result`。
+
+### 3.2 Agent 对话框动作边界
+
+Agent 会话建议动作只保留：
+
+1. 总结当前设定 / 总结当前世界底稿。
+2. 八锚点准备完成后的“整理一版世界底稿”。
+
+不再在 Agent 会话快照里继续生成或兼容展示：
+
+1. `refine_focus_target`
+2. “精修角色”
+3. “继续补地点”
+4. “先看世界总卡”
+
+旧 session 快照如果仍带有 `refine_focus_target`，服务端兼容层会过滤掉，避免旧数据把精修入口重新塞回 Agent 对话框。
+
+### 3.3 结果页精修边界
+
+Agent 来源结果页不再是冻结预览态。
+
+当前允许在结果页继续进行成稿精修，包括：
+
+1. 编辑世界信息。
+2. 编辑角色、场景、封面等对象档案。
+3. 删除或调整已有对象。
+4. 自动保存到作品草稿。
+5. 进入世界前通过 `sync_result_profile` 写回 Agent session。
+
+为了保持主链简洁，Agent 来源结果页仍不重新打开“通过 Agent 对话精修对象”的入口。
+
+---
+
+## 4. 对历史文档口径的覆盖
+
+这份文档覆盖 [AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md) 中“Agent 来源结果页冻结为预览态”的阶段性口径。
+
+新的主口径是：
+
+1. Agent 来源结果页可以编辑，因为精修本来就应该发生在结果页。
+2. 需要收紧的是 Agent 对话框，不是结果页。
+3. 结果页编辑后仍必须同步回 Agent session，保持进入世界前的数据真相源一致。
+
+---
+
+## 5. 验收标准
+
+本次修正完成后应满足：
+
+1. 创作中心已有底稿草稿按钮文案为“继续完善”，点击进入结果页。
+2. 创作中心未成稿草稿按钮仍为“继续创作”，点击进入 Agent 对话框。
+3. Agent 对话框不出现“精修角色 / 补地点 / 看世界总卡”类对象精修入口。
+4. Agent 来源结果页可以打开编辑弹窗进行精修。
+5. 返回创作从结果页回到创作中心，不回到 Agent 对话框。
diff --git a/docs/technical/AGENT_DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md b/docs/technical/AGENT_DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md
new file mode 100644
index 00000000..9079d0da
--- /dev/null
+++ b/docs/technical/AGENT_DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md
@@ -0,0 +1,96 @@
+# Agent 草稿结果页资产合并修复 2026-04-21
+
+更新时间：`2026-04-21`
+
+## 1. 问题现象
+
+当前创作流程里，用户在“生成草稿”后反馈：
+
+1. 角色主图没有稳定出现在结果页
+2. 场景背景图有时可见，有时角色图缺失
+3. 自动保存后的作品库条目里，分幕图可能已经存在，但场景角色主图仍为空
+
+## 2. 本次真实排查结论
+
+本轮不是单一的“没写数据库”问题，而是 `agent draft -> result profile` 桥接层存在一类更隐蔽的集合漂移问题。
+
+排查后确认：
+
+1. 最新 `custom_world_sessions.payload_json` 里的 `draftProfile.storyNpcs[].imageSrc` 已经存在
+2. 最新 `draftProfile.sceneChapters[].acts[].backgroundImageSrc` 也已经存在
+3. 对应图片文件也真实存在于仓库根 `public/` 下
+4. 最新 `custom_world_profiles.payload_json` 里，分幕图通常已保存成功
+5. 但场景角色主图可能仍为空
+
+根因在于：
+
+1. 结果页桥接层在 `draftProfile.legacyResultProfile` 存在时，仍把 `legacyResultProfile` 视为主列表
+2. 旧逻辑只会按 `id` 把 `draftProfile` 里的图片字段回贴到 `legacyResultProfile`
+3. 一旦后续草稿精修导致 `draftProfile` 的角色集合、角色 id 或角色命名发生漂移
+4. 旧 `legacyResultProfile` 就会继续主导结果页和自动保存对象列表
+5. 最新角色主图虽然已在 `draftProfile` 里生成完成，但会因为匹配失败而被整批吞掉
+
+这类问题在场景角色上最明显，因为角色集合最容易在后续精修中替换。
+
+## 3. 修复策略
+
+本轮在：
+
+- `src/services/customWorldAgentDraftResult.ts`
+
+调整桥接规则：
+
+1. `legacyResultProfile` 仍保留，继续提供运行时富字段
+2. 但角色、场景、分幕等对象集合不再默认由 `legacyResultProfile` 主导
+3. 最新 `draftProfile` 成为结果页对象列表的主来源
+4. `legacyResultProfile` 只负责给命中的对象补运行时富字段
+5. 匹配优先级为：
+   - 先按 `id`
+   - 再按名称兜底
+
+具体规则：
+
+1. `playableNpcs`：以最新 draft 集合为主，legacy 只补富字段与旧运行时字段
+2. `storyNpcs`：同上，避免旧角色列表吞掉新角色主图
+3. `sceneChapterBlueprints`：以最新 draft 幕列表为主，legacy 只补章节/幕已有运行时字段
+4. `landmarks`：优先更新最新 draft 命中的场景对象，但保留 legacy 中未被命中的剩余运行时场景，避免丢连接与残留信息
+5. `camp`：保留 legacy 基础信息，但优先取 draft 最新图片字段
+
+## 4. 修复后的链路意义
+
+修复后：
+
+1. 草稿自动资产服务生成的角色主图不会再因为旧 `legacyResultProfile` 的角色集合过时而丢失
+2. 分幕图继续可以稳定进入结果页与自动保存
+3. 作品库自动保存时，结果页编译出的 profile 更接近“当前草稿真实快照”，而不是历史 legacy 快照
+
+## 5. 新增验证
+
+本轮补了前端桥接测试：
+
+- `src/services/customWorldAgentDraftResult.test.ts`
+
+新增验证点：
+
+1. 当 `draftProfile.storyNpcs` 与 `legacyResultProfile.storyNpcs` 集合漂移时
+2. 结果页仍应优先展示最新 draft 角色
+3. 最新角色主图与最新分幕图不能被旧 legacy 快照吞掉
+
+## 6. 当前状态
+
+本轮修复后，本地已验证：
+
+1. `src/services/customWorldAgentDraftResult.test.ts`
+2. `src/components/CustomWorldResultView.test.tsx`
+3. `src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx`
+4. `npm run check:encoding`
+
+均通过。
+
+## 7. 后续建议
+
+这次问题再次说明：
+
+1. `legacyResultProfile` 继续长期作为结果页主列表来源风险很高
+2. 只做“按 id 回贴图片字段”在对象集合会漂移的链路里不够稳
+3. 后续如果继续推进后端单一真相源，应优先把结果页对象集合完全改为服务端最新 compile/preview 结果，而不是继续让前端桥接层承担最终裁决
diff --git a/docs/technical/AGENT_DRAFT_RESULT_AUTOSAVE_DB_CHECK_2026-04-21.md b/docs/technical/AGENT_DRAFT_RESULT_AUTOSAVE_DB_CHECK_2026-04-21.md
new file mode 100644
index 00000000..4aa0786f
--- /dev/null
+++ b/docs/technical/AGENT_DRAFT_RESULT_AUTOSAVE_DB_CHECK_2026-04-21.md
@@ -0,0 +1,119 @@
+# 创作流程草稿/图片/动作自动保存数据库检查 2026-04-21
+
+更新时间：`2026-04-21`
+
+## 1. 本次检查范围
+
+本次检查只聚焦当前创作流程里下面这条链路：
+
+`结果页前端编辑 -> 自动保存 -> Agent session 主链同步 -> 作品库落库`
+
+重点核对三类内容：
+
+1. 草稿文本类修改
+2. 生成后的角色图片、地点图片、分幕图
+3. 角色动作相关资产字段
+
+## 2. 当前实际自动保存链路
+
+当前前端主入口在：
+
+- `src/components/game-shell/PreGameSelectionFlow.tsx`
+
+实际行为如下：
+
+1. 结果页编辑统一通过 `onProfileChange` 更新 `generatedCustomWorldProfile`
+2. 当结果页停留在 `custom-world-result` 阶段时，前端会对 profile 做防抖自动保存
+3. 如果当前结果页来源是 `agent-draft`，自动保存前会先执行 `sync_result_profile`
+4. `sync_result_profile` 完成后，前端不直接保存旧内存 profile，而是优先保存“从最新 session 重编译出的 profile”
+5. 作品库保存最终走 `PUT /api/runtime/custom-world-library/:profileId`
+6. Express 后端通过 `runtimeRepository.upsertCustomWorldProfile(...)` 把 profile 写入 `custom_world_profiles.payload_json`
+
+所以数据库层本身是有正常落库能力的。
+
+## 3. 本次检查前确认成立的部分
+
+以下能力在本次检查前已经成立：
+
+1. 结果页普通草稿字段编辑会触发自动保存
+2. 自动保存会真正调用后端作品库接口并更新数据库
+3. 返回创作、进入世界两条路径也会优先同步 Agent session
+4. `legacyResultProfile` 已作为阶段一桥接快照保留在 session 中
+
+## 4. 本次发现的真实风险
+
+风险不在数据库写入本身，而在：
+
+`sync_result_profile -> session 重编译结果页 profile`
+
+此前 `sync_result_profile` 只回写：
+
+1. 基础摘要字段
+2. `legacyResultProfile`
+
+但没有把结果页里已经确认过的资产字段同步回 foundation draft 对应节点。
+
+这会导致一个阶段性风险：
+
+1. 用户在结果页换了新的角色图
+2. 或者结果页里刚确认了新的动作资产字段
+3. 或者结果页里刚确认了新的地点图、分幕图
+4. 自动保存前前端先做一次 session 同步
+5. 同步完成后又从 session 重编译结果页 profile
+6. 重编译过程会把 draft 层旧资产字段再次并入结果 profile
+
+这样就可能出现：
+
+**数据库自动保存成功了，但保存进去的是“被旧 draft 资产字段回退过的版本”，不是用户刚在结果页看到的最新图/动作。**
+
+## 5. 本轮修复
+
+本轮在：
+
+- `server-node/src/services/customWorldAgentOrchestrator.ts`
+
+补了一个收窄修复：
+
+1. `sync_result_profile` 仍然保持阶段一边界，不做整套 runtime -> foundation draft 反解
+2. 但会按相同 id，把结果页里已确认的资产字段同步回 draft 层已有对象
+3. 同步范围包括：
+   - 角色 `imageSrc`
+   - 角色 `generatedVisualAssetId`
+   - 角色 `generatedAnimationSetId`
+   - 角色 `animationMap`
+   - 地点 `imageSrc`
+   - 分幕 `backgroundImageSrc`
+   - 分幕 `backgroundAssetId`
+
+这样后续再从 session 重编译结果页 profile 时，最新资产字段不会再被旧 draft 值回退。
+
+## 6. 验证补充
+
+本轮补了服务端测试：
+
+- `server-node/src/services/customWorldAgentPhase4.test.ts`
+
+新增验证点：
+
+1. `sync_result_profile` 后，最新角色主图会写回 draft
+2. 最新角色动作资产字段会写回 draft
+3. 最新地点图会写回 draft
+4. 最新分幕图会写回 draft
+
+## 7. 结论
+
+截至本轮修复后，当前创作流程里：
+
+1. 草稿文本修改可以自动保存到数据库
+2. 结果页中确认后的角色图、地点图、分幕图可以随自动保存稳定进入数据库
+3. 角色动作相关资产字段可以随 session 同步和自动保存稳定保留
+
+但仍需注意：
+
+1. 当前仍是阶段一兼容链路，核心桥接字段仍然是 `legacyResultProfile`
+2. 正式发布链 `publish_world` 还没有在当前阶段打通
+3. 前端仍依赖 `buildCustomWorldProfileFromAgentDraft()` 作为 session -> 结果页兼容编译层
+
+因此本轮结论是：
+
+**当前“前端修改 -> 自动保存 -> 数据库”主链可用；本次已补上图片与动作资产在 session 重编译阶段的回退风险。**
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
new file mode 100644
index 00000000..6ad80bc5
--- /dev/null
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
@@ -0,0 +1,1032 @@
+# 当前创作流程链路前后端脚本重构执行方案
+
+更新时间：`2026-04-21`
+
+## 0. 文档目标
+
+本文件只服务一件事：
+
+**把当前“创作入口 -> Agent 会话 -> 世界底稿 -> 结果页编辑 -> 自动保存 -> 作品库 -> 进入世界”这条链路上的前后端脚本，整理成一份可以直接指导后续编码拆分的执行方案。**
+
+本轮不直接改业务逻辑，只明确：
+
+1. 当前链路上的真实脚本地图
+2. 当前可读性差、可扩展性差的结构性问题
+3. 目标分层与真相源边界
+4. 文件级拆分建议
+5. 分阶段落地计划与验收标准
+
+---
+
+## 1. 范围与依据
+
+### 1.1 本文覆盖的创作链路
+
+```text
+平台创作入口
+-> Agent session 创建 / 恢复
+-> Agent 对话与 action 执行
+-> foundation draft 生成
+-> 角色图 / 地点图 / 分幕图 / 动作资产生成与同步
+-> 结果页编辑
+-> 自动保存到作品库
+-> works 聚合展示 / 恢复创作
+-> 进入游戏世界
+```
+
+### 1.2 本文主要依据
+
+1. `docs/audits/AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md`
+2. `docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md`
+3. `docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md`
+4. `docs/technical/AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md`
+5. `docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md`
+6. `docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md`
+7. `docs/technical/AGENT_DRAFT_RESULT_AUTOSAVE_DB_CHECK_2026-04-21.md`
+
+---
+
+## 2. 当前链路脚本地图
+
+## 2.1 前端主链脚本
+
+| 文件 | 当前职责 | 当前问题 |
+| --- | --- | --- |
+| `src/components/game-shell/PreGameSelectionFlow.tsx` | 平台 tab、详情页、创作入口、Agent session 创建与恢复、operation 轮询、结果页自动保存、session 同步、进入世界前同步、works/library/gallery/history/save 拉取 | 单文件承载过多流程编排，页面壳层、状态机、网络请求、自动保存和世界进入逻辑混在一起，是当前前端最大热点 |
+| `src/components/custom-world-home/CustomWorldCreationHub.tsx` | 创作中心 works 展示、继续创作、草稿与已发布作品入口 | 读模型已经存在，但与平台壳层仍有状态耦合，入口职责还没有完全收口 |
+| `src/components/CustomWorldResultView.tsx` | 结果页预览、结果页内生成角色/地点、结果页内触发编辑、资产调试面板 | 结果页同时是预览层、编辑层、生成层，仍保留 legacy profile 直改能力 |
+| `src/components/CustomWorldEntityEditorModal.tsx` | 世界、封面、营地、角色、地点等多种对象编辑，以及部分资产与运行时预览能力 | 单文件过大，编辑表单、资产工作流、运行时预览混合，后续很难局部扩展 |
+| `src/components/CustomWorldRoleAssetStudioModal.tsx` | 角色主图候选、动作生成、动作发布、缓存读写 | 视觉生成、动作生成、缓存、发布四类职责耦合在一个模态层里 |
+| `src/services/customWorldAgentDraftResult.ts` | `Agent session draftProfile -> legacy CustomWorldProfile` 的桥接编译与资产合并 | 前端承担了结构化编译责任，是“前端只做表现”边界下最应继续收缩的兼容层 |
+| `src/services/aiService.ts` | Agent session、消息流、operation、旧 custom world 相关请求、若干结果页生成动作 | custom world 相关 API 与 story/chat/legacy AI 接口混放，不利于链路收口 |
+| `src/services/storageService.ts` | works、library、gallery、browse history、save archive、profile dashboard | custom world 作品链 API 与通用 runtime 存储 API 混放，边界不清晰 |
+
+## 2.2 后端主链脚本
+
+| 文件 | 当前职责 | 当前问题 |
+| --- | --- | --- |
+| `packages/shared/src/contracts/customWorldAgent.ts` | session、message、draft、asset、works、action、operation 契约 | 契约体量过大，action 定义与后端真实执行能力存在漂移 |
+| `server-node/src/routes/customWorldAgent.ts` | Agent session 与 action 路由入口 | 应继续保持薄路由，但当前下游编排层过重，路由可读性受限 |
+| `server-node/src/routes/runtimeRoutes.ts` | works、library、gallery、runtime 相关通用路由 | custom world 作品链路仍混在 runtime 大路由里，不利于独立演进 |
+| `server-node/src/services/customWorldAgentOrchestrator.ts` | session 生命周期、消息处理、action 分发、result sync、派生状态拼装、suggested actions、质量状态拼装 | 当前后端最大热点之一，承担了过多业务分支和字段同步细节 |
+| `server-node/src/services/customWorldAgentSessionStore.ts` | session 创建、读写、兼容旧结构补齐、snapshot 输出 | store、兼容转换、session factory 三类职责还没有拆开 |
+| `server-node/src/services/customWorldAgentFoundationDraftService.ts` | eight-anchor / intent -> foundation draft；内部依赖 runtime profile 编译再转回 draft | 存在“先编 legacy runtime profile，再转回 foundation draft”的双重编译 |
+| `server-node/src/modules/custom-world/runtimeProfile.ts` | custom world runtime profile 规范化、构建、编译、属性 schema、场景章节处理 | 文件过大，normalize/build/schema/scene/role 等职责全部堆在一起 |
+| `server-node/src/repositories/runtimeRepository.ts` | save/settings/custom world profiles/custom world sessions/browse history 等仓储 | 仓储按技术分组，不按领域分组；custom world 相关方法和通用 runtime 方法耦合 |
+| `server-node/src/services/customWorldWorkSummaryService.ts` | 聚合 Agent 草稿与已发布 profile，生成 works 读模型 | 汇总逻辑、展示语义、metadata 回退混在一起，适合作为独立 read model 层继续收口 |
+
+## 2.3 当前链路上的次级执行模块
+
+以下脚本不是主入口，但属于链路中的重要执行点，后续重构不能绕开：
+
+1. `server-node/src/services/customWorldAgentEntityGenerationService.ts`
+2. `server-node/src/services/customWorldAgentAutoAssetService.ts`
+3. `server-node/src/services/customWorldAgentAssetBridgeService.ts`
+4. `server-node/src/services/customWorldAgentDraftCompiler.ts`
+5. `server-node/src/services/customWorldAgentRoleAssetStateService.ts`
+
+这些模块后续要继续明确边界：
+
+1. 生成型 service 只负责生成结果
+2. bridge / sync 型 service 只负责把已确认结果写回 session
+3. snapshot / read model 型 service 只负责组织前端展示数据
+
+---
+
+## 3. 当前结构性问题
+
+## 3.1 前端壳层承担了过多编排责任
+
+`PreGameSelectionFlow.tsx` 当前既是平台页面壳层，又是创作流程控制器，还同时负责：
+
+1. Agent session 创建与恢复
+2. operation 轮询
+3. works、gallery、history、save、dashboard 拉取
+4. 结果页自动保存
+5. 结果页改动同步回 session
+6. 进入世界前同步
+
+这会导致：
+
+1. 页面组件一改就容易碰到主链数据流
+2. 自动保存与页面切换耦合过紧
+3. 后续任何新增 action 都会继续堆进壳层文件
+
+## 3.2 前端仍在承担结果 profile 编译责任
+
+`buildCustomWorldProfileFromAgentDraft()` 仍是当前 session draft -> result profile 的关键桥接点。
+
+这意味着：
+
+1. Agent session 不是最终唯一真相源
+2. 前端在裁决字段取舍、默认值、资产合并
+3. 自动保存和进入世界依赖的是前端重编译结果，而不是服务端正式输出
+
+这与“前端只做表现，逻辑和数据收回 Express 后端”的项目约束不一致。
+
+## 3.3 结果页仍是 legacy 编辑器兼容工作台
+
+`CustomWorldResultView.tsx`、`CustomWorldEntityEditorModal.tsx`、`CustomWorldRoleAssetStudioModal.tsx` 当前仍然存在：
+
+1. 直接改 legacy `CustomWorldProfile`
+2. 直接调用 legacy 生成接口补角色、地点
+3. 资产工坊直接处理缓存、候选、发布
+
+结果页就不只是“预览 / 发布前收口层”，而是独立并行编辑器。
+
+## 3.4 后端编排层和编译层都过重
+
+`customWorldAgentOrchestrator.ts` 与 `runtimeProfile.ts` 是当前两个最明显的大文件热点：
+
+1. 一个同时承担 message orchestration、action dispatch、result sync、snapshot 拼装
+2. 一个同时承担 runtime normalize、schema build、scene chapter compile、role build
+
+结果是：
+
+1. 新增 action 成本高
+2. 新增字段时容易遗漏多个分支
+3. 单测很难精准覆盖局部职责
+
+## 3.5 works、library、publish、enter world 仍没有完全收成单一路径
+
+当前仍然是：
+
+1. Agent session 草稿链
+2. 已保存 profile 链
+3. 结果页 legacy profile 直改链
+4. works 聚合读模型链
+
+多条 pipeline 并存会继续放大桥接层复杂度。
+
+---
+
+## 4. 目标分层架构
+
+## 4.1 目标原则
+
+后续重构必须统一遵守 5 条原则：
+
+1. **Agent session 是创作态唯一真相源。**
+2. **服务端编译结果预览是结果页唯一数据来源。**
+3. **published profile 是进入世界与作品库持久化的正式真相。**
+4. **前端只保留展示状态、交互状态、表单草稿态，不再承担结构化编译。**
+5. **action 能力由后端注册表统一声明，前端不再假设 contract 中定义的 action 一定真实可用。**
+
+## 4.2 目标链路
+
+```text
+前端平台壳层
+-> custom world 专属 client
+-> Agent route / works route / library route
+-> session application service
+-> action registry
+-> foundation / entity / asset / publish domain services
+-> session store / custom world repository
+-> 服务端 result preview compiler
+-> 前端结果页展示与编辑
+-> 服务端 autosave / publish / enter-world gate
+```
+
+## 4.3 三类真相源
+
+后续必须严格区分三类数据：
+
+| 数据 | 真相位置 | 用途 |
+| --- | --- | --- |
+| 创作态 session | Agent session store | 对话、草稿、锁定、suggested actions、asset 覆盖率、阶段状态 |
+| 结果页预览态 result preview | 服务端 preview compiler 输出 | 结果页展示、结果页局部编辑回填、自动保存前比对 |
+| 已发布世界 profile | custom world profile repository | 作品库、发布态、进入世界、对外展示 |
+
+前端不再把 `draftProfile -> runtime profile` 编译结果视为正式真相，只能把它视为临时兼容输出，且这条兼容层要持续收缩。
+
+---
+
+## 4.4 RPG 创作流程脚本命名规范
+
+这套创作流程只服务 **RPG 类型游戏**，后续命名不能继续沿用过于泛化的 `customWorld`、`runtime`、`flow` 混搭口径，而应把“RPG 创作域”显式写进命名里。
+
+### 命名目标
+
+1. 让人一眼看出这是 **RPG 世界创作链**，不是通用世界编辑器。
+2. 让文件名能直接表达层级：页面壳层、工作流、应用服务、编译器、仓储、读模型。
+3. 避免继续出现“同一文件名里既有业务域又有历史兼容语义”的情况。
+
+### 推荐命名根
+
+后续新建或重命名文件时，优先使用下面 3 类命名根：
+
+1. `rpgCreation`：用于前端创作流程壳层、workflow、client、view model
+2. `rpgWorld`：用于后端世界草稿、世界预览、世界发布、世界仓储
+3. `rpgAgent`：用于 Agent session、message turn、action executor、snapshot
+
+### 命名规则
+
+1. 前端组件文件使用 `RpgCreation` 前缀。
+2. 前端 hooks / workflow 文件使用 `useRpgCreation` 前缀。
+3. 前端 client / adapter / mapper 文件使用 `rpgCreation` 前缀。
+4. 后端应用服务文件使用 `RpgAgent` 或 `RpgWorld` 前缀。
+5. 后端仓储文件使用 `RpgWorld...Repository` 或 `RpgAgent...Repository`。
+6. 共享契约文件使用 `rpgCreation...` 或 `rpgAgent...` 小驼峰命名。
+7. 禁止再新增过于泛化的 `customWorld*Service.ts`、`customWorld*Flow.tsx` 作为新主命名。
+
+### 文件命名示例
+
+#### 前端示例
+
+1. `src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx`
+2. `src/components/game-shell/rpg-creation-flow/useRpgCreationPlatformBootstrap.ts`
+3. `src/components/game-shell/rpg-creation-flow/useRpgCreationSessionController.ts`
+4. `src/components/rpg-creation-result/RpgCreationResultView.tsx`
+5. `src/components/rpg-creation-editor/RpgCreationRoleEditorSection.tsx`
+6. `src/services/rpg-creation/rpgCreationAgentClient.ts`
+7. `src/services/rpg-creation/rpgCreationPreviewAdapter.ts`
+
+#### 后端示例
+
+1. `server-node/src/routes/rpgCreationAgentRoutes.ts`
+2. `server-node/src/routes/rpgWorldLibraryRoutes.ts`
+3. `server-node/src/services/RpgAgentOrchestrator.ts`
+4. `server-node/src/services/RpgAgentActionRegistry.ts`
+5. `server-node/src/services/RpgWorldPreviewCompiler.ts`
+6. `server-node/src/repositories/RpgWorldProfileRepository.ts`
+7. `server-node/src/repositories/RpgAgentSessionRepository.ts`
+
+#### 共享契约示例
+
+1. `packages/shared/src/contracts/rpgAgentSession.ts`
+2. `packages/shared/src/contracts/rpgAgentActions.ts`
+3. `packages/shared/src/contracts/rpgCreationPreview.ts`
+4. `packages/shared/src/contracts/rpgCreationWorkSummary.ts`
+
+### 兼容期命名策略
+
+因为当前主链已有大量 `customWorld*` 文件，重构期间采用“两段式迁移”：
+
+1. 第一阶段先新增按规范命名的新目录和 façade。
+2. 第二阶段再把旧 `customWorld*` 文件逐步迁到 `rpgCreation* / rpgWorld* / rpgAgent*` 命名。
+
+### 命名禁忌
+
+后续重构中禁止继续出现以下命名问题：
+
+1. 一个文件名同时表达多个层级，例如 `FlowServiceController`。
+2. 用 `runtime` 指代创作态脚本。
+3. 用 `customWorld` 指代实际上只服务 RPG 创作链的新模块。
+4. 用 `Helper`、`Utils`、`Manager` 作为主业务模块名。
+
+---
+
+## 5. 前端重构拆分方案
+
+## 5.1 `PreGameSelectionFlow.tsx` 拆分方案
+
+### 现状问题
+
+当前文件同时承担“平台壳层 + 数据加载器 + 创作流程控制器 + 自动保存协调器 + 世界进入协调器”五类职责。
+
+### 目标拆分
+
+保留 `PreGameSelectionFlow.tsx` 作为页面壳层，只负责：
+
+1. stage 切换
+2. 组件装配
+3. 视觉级 loading / error 展示
+
+从该文件中拆出以下模块：
+
+1. `src/components/game-shell/custom-world-flow/useCustomWorldPlatformBootstrap.ts`
+2. `src/components/game-shell/custom-world-flow/useCustomWorldWorkEntries.ts`
+3. `src/components/game-shell/custom-world-flow/useCustomWorldAgentSessionController.ts`
+4. `src/components/game-shell/custom-world-flow/useCustomWorldAgentOperationPolling.ts`
+5. `src/components/game-shell/custom-world-flow/useCustomWorldResultAutosave.ts`
+6. `src/components/game-shell/custom-world-flow/useCustomWorldEnterWorld.ts`
+7. `src/components/game-shell/custom-world-flow/useCustomWorldDetailNavigation.ts`
+
+### 编码要求
+
+1. 壳层文件内不再直接拼接 route path。
+2. 壳层文件内不再直接包含自动保存防抖实现。
+3. 壳层文件内不再直接包含 session -> result profile 编译细节。
+4. 壳层文件内不再直接处理 works/library/history/save 的多路请求编排。
+
+## 5.2 custom world 专属 client 拆分方案
+
+### 现状问题
+
+`aiService.ts` 和 `storageService.ts` 中 custom world 相关接口已经比较多，继续堆在通用 service 里会加重跨域耦合。
+
+### 目标拆分
+
+新增 custom world 专属 client 目录：
+
+1. `src/services/custom-world/customWorldAgentClient.ts`
+2. `src/services/custom-world/customWorldWorkClient.ts`
+3. `src/services/custom-world/customWorldLibraryClient.ts`
+4. `src/services/custom-world/customWorldAssetClient.ts`
+
+### 保留边界
+
+1. `aiService.ts` 只保留 story/chat/通用 AI 能力。
+2. `storageService.ts` 只保留 save/settings/profile dashboard 等通用 runtime 存储。
+3. custom world 相关请求全部从通用 service 中迁出后，旧导出保留一个阶段的兼容别名，再统一删除。
+
+## 5.3 `CustomWorldResultView.tsx` 拆分方案
+
+### 现状问题
+
+该文件同时承担结果概览、实体目录、结果页动作、局部生成动作和调试面板。
+
+### 目标拆分
+
+保留 `CustomWorldResultView.tsx` 作为结果页组合壳层，并拆出：
+
+1. `src/components/custom-world-result/CustomWorldResultHeader.tsx`
+2. `src/components/custom-world-result/CustomWorldResultActionBar.tsx`
+3. `src/components/custom-world-result/CustomWorldResultEntitySection.tsx`
+4. `src/components/custom-world-result/CustomWorldAssetCoveragePanel.tsx`
+5. `src/components/custom-world-result/CustomWorldAssetDebugPanel.tsx`
+6. `src/components/custom-world-result/useCustomWorldResultActions.ts`
+
+### 边界要求
+
+1. 结果页只调用 custom world 专属 client。
+2. 结果页不再直接依赖 legacy 生成函数作为长期主链能力。
+3. 调试面板与正式结果页逻辑隔离，避免调试代码继续污染主流程组件。
+
+## 5.4 `CustomWorldEntityEditorModal.tsx` 拆分方案
+
+### 现状问题
+
+该文件把 world / cover / camp / role / landmark / chapter 编辑全部放在一个文件里，且还混入运行时预览与资产工作流。
+
+### 目标拆分
+
+保留 modal 壳层，拆出：
+
+1. `src/components/custom-world-editor/CustomWorldWorldEditorSection.tsx`
+2. `src/components/custom-world-editor/CustomWorldCoverEditorSection.tsx`
+3. `src/components/custom-world-editor/CustomWorldCampEditorSection.tsx`
+4. `src/components/custom-world-editor/CustomWorldRoleEditorSection.tsx`
+5. `src/components/custom-world-editor/CustomWorldLandmarkEditorSection.tsx`
+6. `src/components/custom-world-editor/CustomWorldSceneChapterEditorSection.tsx`
+7. `src/components/custom-world-editor/customWorldResultFormMapper.ts`
+
+### 边界要求
+
+1. 编辑 section 只负责表单表现。
+2. 提交 patch、差异比较、字段清洗都收口到独立 mapper / mutation 层。
+3. 运行时预览和战斗预览不继续堆在结果编辑主链文件里。
+
+## 5.5 `CustomWorldRoleAssetStudioModal.tsx` 拆分方案
+
+### 现状问题
+
+角色图候选、动作模板、动作生成、缓存恢复、结果发布都在一个文件里，后续加“场景资产工坊”时会继续复制相同问题。
+
+### 目标拆分
+
+建议拆为：
+
+1. `src/components/custom-world-asset-studio/useRoleVisualCandidateWorkflow.ts`
+2. `src/components/custom-world-asset-studio/useRoleAnimationWorkflow.ts`
+3. `src/components/custom-world-asset-studio/roleAssetStudioModel.ts`
+4. `src/components/custom-world-asset-studio/roleAssetStudioPublishClient.ts`
+5. `src/components/custom-world-asset-studio/CustomWorldRoleAssetStudioModal.tsx`
+
+### 边界要求
+
+1. 缓存模型独立于 UI。
+2. 发布动作只负责把“已确认资产结果”提交给后端。
+3. 动作生成参数模板不要散落在 UI 文件里。
+
+## 5.6 `customWorldAgentDraftResult.ts` 收缩方案
+
+### 当前定位
+
+这是当前最重要的前端兼容桥接层。
+
+### 过渡策略
+
+阶段一不直接删除，但要改名并收缩定位：
+
+1. 建议迁为 `src/services/custom-world/customWorldResultPreviewAdapter.ts`
+2. 只保留“服务端 result preview -> 前端 view model”的轻量适配
+3. 禁止继续在其中新增业务裁决和字段拼装逻辑
+
+### 长期目标
+
+服务端提供正式 `result preview` 输出后，前端不再执行 `draftProfile -> CustomWorldProfile` 编译，本文件可以在后续阶段物理删除。
+
+---
+
+## 6. 后端重构拆分方案
+
+## 6.1 route 层收口
+
+### 当前问题
+
+`customWorldAgent.ts` 与 `runtimeRoutes.ts` 的下游能力边界还不够清晰，custom world 作品链仍混在 runtime 大路由里。
+
+### 目标拆分
+
+1. `server-node/src/routes/customWorldAgent.ts` 只保留 Agent session / action / operation 路由。
+2. 从 `server-node/src/routes/runtimeRoutes.ts` 中拆出：
+   - `server-node/src/routes/customWorldWorks.ts`
+   - `server-node/src/routes/customWorldLibrary.ts`
+   - `server-node/src/routes/customWorldGallery.ts`
+
+### 编码要求
+
+1. 路由层只做鉴权、请求校验、应用服务调用、响应映射。
+2. 不在路由层拼装 session 派生状态。
+3. 不在路由层做 draft / profile 字段兼容转换。
+
+## 6.2 `customWorldAgentOrchestrator.ts` 拆分方案
+
+### 当前问题
+
+该文件当前同时承担：
+
+1. message turn 处理
+2. action 分发
+3. session 读写
+4. result profile sync
+5. suggested actions 生成
+6. 派生状态与 operation 文案拼装
+
+### 目标拆分
+
+保留 `customWorldAgentOrchestrator.ts` 作为应用服务 façade，只负责主链事务编排，并拆出：
+
+1. `server-node/src/services/customWorldAgentMessageTurnService.ts`
+2. `server-node/src/services/customWorldAgentActionRegistry.ts`
+3. `server-node/src/services/customWorldAgentActionExecutors/`
+4. `server-node/src/services/customWorldAgentResultSyncService.ts`
+5. `server-node/src/services/customWorldAgentSuggestedActionService.ts`
+6. `server-node/src/services/customWorldAgentSnapshotBuilder.ts`
+7. `server-node/src/services/customWorldAgentQualityGateService.ts`
+
+### 关键要求
+
+1. `action -> executor` 必须通过注册表映射，不再在 orchestrator 里堆分支。
+2. `publish_world`、`generate_scene_assets`、`expand_long_tail` 等 contract 中存在的 action，要么接入真实 executor，要么明确标记为未开放并返回禁用原因。
+3. `sync_result_profile` 的字段回写细节只允许出现在独立 sync service 中。
+
+## 6.3 `customWorldAgentSessionStore.ts` 拆分方案
+
+### 当前问题
+
+store 当前混合了：
+
+1. session factory
+2. session persistence
+3. 旧结构兼容补齐
+4. snapshot 输出
+
+### 目标拆分
+
+1. `server-node/src/services/customWorldAgentSessionFactory.ts`
+2. `server-node/src/services/customWorldAgentSessionCompatibility.ts`
+3. `server-node/src/services/customWorldAgentSessionStore.ts`
+4. `server-node/src/repositories/customWorldAgentSessionRepository.ts`
+
+### 关键要求
+
+1. session store 只保留高层读写接口。
+2. 兼容 legacy session 的逻辑单独隔离，避免污染新字段演进。
+3. persistence adapter 不再依赖 runtime 仓储大文件直接暴露全部能力。
+
+## 6.4 `customWorldAgentFoundationDraftService.ts` 拆分方案
+
+### 当前问题
+
+当前 foundation draft 生成还带着“runtime profile 双重编译”的历史包袱。
+
+### 目标拆分
+
+1. `server-node/src/services/customWorldAgentFoundationInputBuilder.ts`
+2. `server-node/src/services/customWorldAgentFoundationLlmService.ts`
+3. `server-node/src/services/customWorldAgentFoundationNormalizer.ts`
+4. `server-node/src/services/customWorldAgentFoundationDraftService.ts`
+5. `server-node/src/services/customWorldAgentResultPreviewCompiler.ts`
+
+### 关键要求
+
+1. foundation draft 生成与 runtime preview 编译彻底拆开。
+2. 不再通过“先编 legacy runtime profile，再转回 foundation draft”维持主链。
+3. `legacyResultProfile` 只作为阶段性兼容字段存在，禁止继续扩大依赖面。
+
+## 6.5 `runtimeProfile.ts` 拆分方案
+
+### 当前问题
+
+这是当前 custom world runtime 编译中心，但文件过大，后续继续在原文件上叠加只会放大维护成本。
+
+### 目标拆分
+
+新增目录：
+
+1. `server-node/src/modules/custom-world/runtime-profile/index.ts`
+2. `server-node/src/modules/custom-world/runtime-profile/normalizeShared.ts`
+3. `server-node/src/modules/custom-world/runtime-profile/normalizeRole.ts`
+4. `server-node/src/modules/custom-world/runtime-profile/normalizeLandmark.ts`
+5. `server-node/src/modules/custom-world/runtime-profile/normalizeSceneChapter.ts`
+6. `server-node/src/modules/custom-world/runtime-profile/normalizeCamp.ts`
+7. `server-node/src/modules/custom-world/runtime-profile/buildCompiledProfile.ts`
+8. `server-node/src/modules/custom-world/runtime-profile/buildAttributeSchema.ts`
+9. `server-node/src/modules/custom-world/runtime-profile/creatorIntentBridge.ts`
+
+### 过渡策略
+
+1. 原 `runtimeProfile.ts` 先保留为 façade 导出层。
+2. 新调用逐步改走目录化模块。
+3. 旧导出在阶段性兼容完成后再统一清理。
+
+## 6.6 仓储层与 works 聚合层拆分方案
+
+### 当前问题
+
+`runtimeRepository.ts` 与 `customWorldWorkSummaryService.ts` 目前都承担了过多跨域职责。
+
+### 目标拆分
+
+建议把 `runtimeRepository.ts` 拆成：
+
+1. `server-node/src/repositories/runtimeSaveRepository.ts`
+2. `server-node/src/repositories/runtimeSettingsRepository.ts`
+3. `server-node/src/repositories/customWorldProfileRepository.ts`
+4. `server-node/src/repositories/customWorldAgentSessionRepository.ts`
+5. `server-node/src/repositories/profileBrowseHistoryRepository.ts`
+
+建议把 `customWorldWorkSummaryService.ts` 拆成：
+
+1. `server-node/src/services/customWorldWorkSummaryAssembler.ts`
+2. `server-node/src/services/customWorldWorkCoverResolver.ts`
+3. `server-node/src/services/customWorldWorkSummaryService.ts`
+
+### 关键要求
+
+1. works service 只做读模型聚合，不直接承担 session 兼容修补。
+2. repository 按领域而不是按技术杂糅方式拆开。
+3. works 聚合输出必须稳定支持“继续创作”和“进入世界”两个入口判定。
+
+## 6.7 结果预览与发布链统一方案
+
+### 当前问题
+
+当前“结果页可进入世界”和“正式发布”还不是一条统一主链。
+
+### 目标方案
+
+后续增加服务端 result preview / publish gate 之后，统一为：
+
+```text
+结果页编辑
+-> 服务端写回 session patch
+-> 服务端编译 result preview
+-> 自动保存或发布
+-> 发布校验
+-> 生成 published profile
+-> 进入世界
+```
+
+### 关键要求
+
+1. 进入世界前不再绕开 publish gate。
+2. `qualityFindings` 与 blocker 要成为真实 gate，而不是仅展示字段。
+3. 自动保存保存的是“服务端确认后的 preview / profile”，而不是前端私有重编译产物。
+
+---
+
+## 7. 共享契约重构方案
+
+## 7.1 `customWorldAgent.ts` 拆分建议
+
+建议拆为以下契约文件，再由 index 统一 re-export：
+
+1. `packages/shared/src/contracts/customWorldAgentAnchors.ts`
+2. `packages/shared/src/contracts/customWorldAgentDraft.ts`
+3. `packages/shared/src/contracts/customWorldAgentActions.ts`
+4. `packages/shared/src/contracts/customWorldAgentSession.ts`
+5. `packages/shared/src/contracts/customWorldWorkSummary.ts`
+
+## 7.2 契约演进要求
+
+后续 contract 调整需要新增两类约束：
+
+1. `supportedActions` 或等价能力矩阵，由后端真实注册表生成，前端只消费它，不再根据类型字面量自行假设按钮可用。
+2. `resultPreview` 或独立 preview contract，明确区分“session 草稿”和“结果页预览”。
+
+## 7.3 兼容字段处理
+
+以下字段或能力要被明确标为“兼容过渡态”：
+
+1. `legacyResultProfile`
+2. 前端 `buildCustomWorldProfileFromAgentDraft()`
+3. 结果页直接调用 legacy 生成函数补实体
+
+所有新功能禁止再建立对这些兼容字段的新增依赖。
+
+---
+
+## 8. 测试与文档同步方案
+
+## 8.1 测试分层
+
+后续重构至少补齐 4 层测试：
+
+1. **unit tests**：针对 result sync、action registry、foundation normalizer、runtime preview compiler
+2. **contract tests**：针对 session snapshot、works summary、preview contract
+3. **integration tests**：覆盖“创建 session -> 发消息 -> draft foundation -> 编辑结果 -> 自动保存 -> 继续创作”
+4. **regression tests**：覆盖角色图、地点图、分幕图、动作资产字段不会在 session 重编译中回退
+
+## 8.2 fixture 要求
+
+建议补充固定 fixture：
+
+1. 最小 eight-anchor session fixture
+2. foundation draft fixture
+3. result preview fixture
+4. published profile fixture
+
+这样 runtime compiler、autosave、works 聚合三条链可以共享相同样本。
+
+## 8.3 文档同步要求
+
+每完成一个阶段，至少同步更新：
+
+1. 本执行方案
+2. `docs/technical/README.md`
+3. 与本阶段对应的阶段性技术文档
+4. 若边界发生变化，还要同步相关 PRD / 审计文档口径
+
+---
+
+## 9. 可并行重构工作包
+
+本次执行计划需要拆成多个可同时推进的工作部分，避免所有人都集中修改同一个热点文件。
+
+并行原则如下：
+
+1. 每个工作包只负责一组清晰模块。
+2. 每个工作包必须有明确写入边界。
+3. 同一阶段允许并行，但禁止多人同时大改同一核心文件。
+4. 先做 façade 和新目录，再做调用迁移，最后做旧层清理。
+
+## 9.1 工作包 A：命名规范与目录骨架
+
+### 目标
+
+先建立 RPG 创作域的新命名与目录骨架，给后续并行迁移提供统一落点。
+
+### 负责范围
+
+1. 前端 `src/components/game-shell/rpg-creation-flow/`
+2. 前端 `src/components/rpg-creation-result/`
+3. 前端 `src/components/rpg-creation-editor/`
+4. 前端 `src/services/rpg-creation/`
+5. 后端 `server-node/src/routes/` 下 RPG 创作相关新路由文件
+6. 后端 `server-node/src/services/` 下 RPG 创作相关 façade 文件
+7. 共享契约新文件骨架
+
+### 写入边界
+
+1. 可以新建目录和 façade 文件。
+2. 可以改文档和导出索引。
+3. 不负责大规模迁移老逻辑。
+
+### 前置依赖
+
+无，可最先开始。
+
+## 9.2 工作包 B：前端平台壳层与流程编排拆分
+
+### 目标
+
+把 `PreGameSelectionFlow.tsx` 从大编排文件拆成壳层 + hooks。
+
+### 负责范围
+
+1. `PreGameSelectionFlow.tsx`
+2. 平台 bootstrap、session controller、operation polling、detail navigation 相关 hooks
+3. 平台侧 works / dashboard / save / history 拉取协调
+
+### 写入边界
+
+1. 主要修改前端壳层与流程 hooks。
+2. 不直接改后端 route / service 语义。
+3. 不承担结果页编辑器拆分。
+
+### 前置依赖
+
+最好在工作包 A 的目录骨架准备好后开始。
+
+## 9.3 工作包 C：前端结果页与编辑器拆分
+
+### 目标
+
+把结果页、实体编辑器、角色资产工坊拆成组合壳层与独立 section / workflow。
+
+### 负责范围
+
+1. `CustomWorldResultView.tsx`
+2. `CustomWorldEntityEditorModal.tsx`
+3. `CustomWorldRoleAssetStudioModal.tsx`
+4. 结果页 action hooks、表单 mapper、资产 workflow
+
+### 写入边界
+
+1. 主要改结果页与编辑器相关前端组件。
+2. 允许补前端 view model 与 mapper。
+3. 不直接改平台壳层主状态编排。
+
+### 前置依赖
+
+依赖工作包 A 的命名规范与目录落点，和工作包 B 并行。
+
+## 9.4 工作包 D：前端 custom world client 收口
+
+### 目标
+
+把 custom world 专属接口从 `aiService.ts`、`storageService.ts` 中迁出。
+
+### 负责范围
+
+1. `aiService.ts`
+2. `storageService.ts`
+3. 新增 `rpgCreation*Client` 文件
+4. 调整前端调用导入路径
+
+### 写入边界
+
+1. 只负责 API client 与请求封装。
+2. 不负责结果页 UI 拆分。
+3. 不负责后端业务实现重构。
+
+### 前置依赖
+
+依赖工作包 A 的命名和目录约束；可与 B、C 并行。
+
+## 9.5 工作包 E：后端 Agent 编排拆分
+
+### 目标
+
+拆解 `customWorldAgentOrchestrator.ts`，引入 registry、snapshot builder、result sync service。
+
+### 负责范围
+
+1. `customWorldAgentOrchestrator.ts`
+2. action registry
+3. action executors
+4. result sync service
+5. snapshot builder
+6. quality gate service
+
+### 写入边界
+
+1. 主改后端应用服务层。
+2. 不负责 runtime profile 编译模块的目录化拆分。
+3. 不负责前端壳层迁移。
+
+### 前置依赖
+
+建议在工作包 A 后开始；可与 B、C、D 并行。
+
+## 9.6 工作包 F：后端 session/store/repository 拆分
+
+### 目标
+
+拆出 session factory、compatibility、repository adapter，并把 custom world 仓储从 runtime 大仓储中分离。
+
+### 负责范围
+
+1. `customWorldAgentSessionStore.ts`
+2. `runtimeRepository.ts`
+3. `customWorldWorkSummaryService.ts`
+4. 新 session repository / profile repository / work summary assembler
+
+### 写入边界
+
+1. 主改后端持久化与读模型层。
+2. 不负责 action executor 细节。
+3. 不负责前端调用改造。
+
+### 前置依赖
+
+与工作包 E 有接口协作关系，但可以并行推进，最终通过 façade 汇合。
+
+## 9.7 工作包 G：后端 preview compiler 与 runtime profile 目录化
+
+### 目标
+
+把 `runtimeProfile.ts` 拆成目录化模块，并引入服务端 result preview compiler。
+
+### 负责范围
+
+1. `runtimeProfile.ts`
+2. `runtime-profile/` 新目录
+3. result preview compiler
+4. foundation draft 与 preview 编译的边界收口
+
+### 写入边界
+
+1. 只负责编译层、normalize 层和 preview 输出。
+2. 不直接重构路由层。
+3. 不直接迁前端组件。
+
+### 前置依赖
+
+与工作包 E、F 并行，但在主链接入前需要先和 E 对齐 preview contract。
+
+## 9.8 工作包 H：共享契约与测试基建
+
+### 目标
+
+拆分共享契约，补齐 fixture、contract tests、integration tests。
+
+### 负责范围
+
+1. `packages/shared/src/contracts/`
+2. preview / action / session / works summary 契约
+3. fixture
+4. unit / contract / integration / regression tests
+
+### 写入边界
+
+1. 契约变更必须同步测试。
+2. 不直接承担业务 UI 拆分。
+3. 不直接承担数据库仓储重构。
+
+### 前置依赖
+
+可从工作包 A 开始先建骨架，随后跟随 B 到 G 持续补齐。
+
+## 9.9 并行推进关系
+
+推荐并行顺序如下：
+
+```text
+第一批并行：
+工作包 A + 工作包 H
+
+第二批并行：
+工作包 B + 工作包 C + 工作包 D + 工作包 E + 工作包 F + 工作包 G
+
+第三批收口：
+把 B~H 的 façade 接回主链
+-> 联调自动保存 / works / publish / enter world
+-> 清理旧兼容层
+```
+
+## 9.10 并行协作约束
+
+为避免多人互相覆盖，本轮建议遵守：
+
+1. 工作包 B 独占 `PreGameSelectionFlow.tsx`。
+2. 工作包 C 独占 `CustomWorldResultView.tsx`、`CustomWorldEntityEditorModal.tsx`、`CustomWorldRoleAssetStudioModal.tsx`。
+3. 工作包 D 独占 `aiService.ts`、`storageService.ts`。
+4. 工作包 E 独占 `customWorldAgentOrchestrator.ts`。
+5. 工作包 F 独占 `customWorldAgentSessionStore.ts`、`runtimeRepository.ts`、`customWorldWorkSummaryService.ts`。
+6. 工作包 G 独占 `runtimeProfile.ts` 及其新目录。
+7. 工作包 H 独占 shared contracts 主文件和测试 fixture 总目录。
+
+---
+
+## 10. 分阶段落地计划
+
+## Phase 0：冻结口径与清点兼容层
+
+### 目标
+
+把当前链路拆分前的边界先冻结，避免后续一边拆一边新增同类耦合。
+
+### 工作项
+
+1. 完成本文档并作为后续施工总口径
+2. 标记兼容层：`customWorldAgentDraftResult.ts`、`legacyResultProfile`、结果页 legacy 生成动作
+3. 列出当前 action contract 与真实 executor 的对照表
+
+### 验收标准
+
+1. 团队对“session / preview / published profile”三类真相源达成一致
+2. 新需求不再默认往 `PreGameSelectionFlow.tsx` 和 `customWorldAgentOrchestrator.ts` 继续堆逻辑
+
+## Phase 1：目录骨架、命名规范与前端拆分并行启动
+
+### 目标
+
+先建立 RPG 创作域的新目录和命名规范，并把前端热点文件拆成可维护结构，但不改当前主流程行为。
+
+### 工作项
+
+1. 完成工作包 A
+2. 完成工作包 B
+3. 完成工作包 C
+4. 完成工作包 D
+
+### 验收标准
+
+1. `PreGameSelectionFlow.tsx` 只剩 stage 与组件装配逻辑
+2. 通用 service 中不再继续新增 custom world workflow 接口
+3. 自动保存、session 恢复、进入世界逻辑都有独立 hook / coordinator
+4. 新增文件遵循 RPG 创作域命名规范
+
+## Phase 2：后端应用服务、仓储、编译层并行拆分
+
+### 目标
+
+把后端主链从“大 orchestrator + 大 store + 大 compiler”拆成 registry + services + repositories + compiler modules。
+
+### 工作项
+
+1. 完成工作包 E
+2. 完成工作包 F
+3. 完成工作包 G
+4. 工作包 H 同步补 contract 与测试
+
+### 验收标准
+
+1. `customWorldAgentOrchestrator.ts` 不再包含具体字段回写实现
+2. action 的启用 / 禁用状态可由后端统一描述
+3. session 兼容逻辑可以脱离 store 单独测试
+4. `runtimeProfile.ts` 已退化为 façade 或兼容导出层
+
+## Phase 3：结果预览编译后移到后端
+
+### 目标
+
+消除前端“本地编译结果 profile”的主链地位。
+
+### 工作项
+
+1. 新增服务端 result preview compiler
+2. 结果页改为消费服务端 preview
+3. `customWorldAgentDraftResult.ts` 改为薄适配层
+
+### 验收标准
+
+1. 前端不再把 `buildCustomWorldProfileFromAgentDraft()` 作为正式编译步骤
+2. 自动保存与 session 同步都基于服务端确认后的 preview
+3. 结果页字段回退问题不再依赖前端兼容修补
+
+## Phase 4：发布链、自动保存链、进入世界链统一
+
+### 目标
+
+把“可玩”与“已发布”的门槛统一到后端。
+
+### 工作项
+
+1. 打通 publish gate
+2. 把 `qualityFindings` / blocker 接成真实阻断条件
+3. enter world 统一走服务端发布态或明确允许的预览态
+
+### 验收标准
+
+1. 前端不能绕开 publish / gate 直接进世界
+2. works、library、enter world 三处状态语义一致
+3. 发布失败可以给出明确 blocker 与恢复入口
+
+## Phase 5：兼容层清理
+
+### 目标
+
+在主链稳定后，物理清理历史桥接层和重复 pipeline。
+
+### 工作项
+
+1. 删除前端 draft result 编译桥
+2. 删除结果页 legacy 直改链的残余入口
+3. 清理 contract 中已废弃 action / 字段
+
+### 验收标准
+
+1. 创作主链只剩 session -> preview -> published profile 三层
+2. 不再存在“前端本地编译 profile 才能自动保存”的依赖
+3. 文档、契约、测试口径一致
+
+---
+
+## 11. 本次执行约束
+
+后续按本文落地时，需要持续遵守以下约束：
+
+1. 不做大爆炸式重写，按阶段保留 façade 与兼容层。
+2. 不新开平行系统，优先在现有创作中心、结果页、Agent 工作区上做结构拆分。
+3. 前端新增文件优先按“壳层 / hook / client / section”拆，不把逻辑再塞回组件文件。
+4. 后端新增文件优先按“route / application service / domain service / repository / compiler”拆，不再继续扩大大文件。
+5. 每个阶段完成后同步文档与测试，不允许代码结构已经迁移但文档还停留在旧链路口径。
+
+---
+
+## 12. 结论
+
+当前创作流程的核心问题，不是单点 bug，而是：
+
+**前端壳层、前端兼容编译层、后端编排层、后端 runtime 编译层同时过重，导致整条创作链处在“多条 pipeline 并存、桥接层过多、职责分层混乱”的过渡态。**
+
+后续重构的正确方向不是继续在热点文件上补判断，而是按本文把主链收成：
+
+**session 真相源 -> 服务端 preview 编译 -> published profile 发布态**
+
+只有这样，当前链路的可读性、可扩展性和后续功能落地稳定性，才会一起提升。
diff --git a/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md b/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
index 20c8aa9f..a9a02faf 100644
--- a/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
+++ b/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
@@ -2,6 +2,8 @@
 
 更新时间：`2026-04-21`
 
+补充修正：`2026-04-21` 本文档的“草稿恢复优先回 Agent 工作区”和“Agent 来源结果页冻结为预览收口层”属于阶段性收口口径，已被 [AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md](./AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md) 覆盖。当前主口径是：Agent 对话框只收集八锚点，已有底稿的草稿从创作中心进入结果页继续完善。
+
 ## 1. 结论先行
 
 当前这条 Agent 创作流已经完成阶段一到阶段三的主要收口。
diff --git a/docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md b/docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md
new file mode 100644
index 00000000..90da8e88
--- /dev/null
+++ b/docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md
@@ -0,0 +1,169 @@
+# 前端逻辑后移实施方案（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 1. 目标
+
+本方案只回答一件事：
+
+**怎样把当前仍残留在前端的正式运行时逻辑、正式会话真相与正式生成编排，继续收回到 Express 后端。**
+
+这份文档不是泛泛而谈的方向说明，而是直接面向本轮与后续几轮编码落地的实施基线。
+
+---
+
+## 2. 本轮确定的硬边界
+
+根据仓库约束与当前审计结果，本轮继续冻结以下边界：
+
+1. 前端只负责表现、输入采集、临时 UI 状态与服务端结果渲染。
+2. 后端负责正式鉴权、正式会话、正式运行时快照、正式任务生成、正式运行时物品意图生成、正式自定义世界生成。
+3. 浏览器内不再保存 access token，不再把浏览历史作为本地正式真相，不再保留正式 quest / runtime item / custom world 生成编排。
+4. 运行时主链必须继续向“前端提交意图，后端解释快照并返回展示模型”收敛。
+
+---
+
+## 3. 现状拆分
+
+当前残留问题已经收敛为三批：
+
+### 3.1 第一批：正式真相仍在前端
+
+1. `src/services/apiClient.ts`
+   - 浏览器仍保存 access token，并拼接 `Authorization: Bearer ...`
+2. `src/services/authService.ts`
+   - 登录、微信绑定等流程仍把 access token 当作前端真相
+3. `src/components/game-shell/PreGameSelectionFlow.tsx`
+   - 浏览历史仍是本地写入 + 后端回填的双真相
+4. `src/services/platformBrowseHistory.ts`
+   - 维护浏览历史本地存储、迁移标记与同步状态
+
+### 3.2 第二批：运行时主链仍依赖前端预写快照
+
+1. `src/hooks/story/runtimeStoryCoordinator.ts`
+   - 在请求 runtime state / runtime action 前，仍先 `PUT /runtime/save/snapshot`
+2. `src/hooks/story/npcEncounterActions.ts`
+   - 待接委托的“更换任务”“放弃任务”仍由前端正式结算
+
+### 3.3 第三批：正式生成编排仍残留在浏览器
+
+1. `src/services/questDirector.ts`
+2. `src/services/runtimeItemAiDirector.ts`
+3. `src/services/aiService.ts` 的 custom world profile 生成入口
+4. `src/services/ai.ts` 中仍保留的浏览器侧 legacy AI orchestration
+
+---
+
+## 4. 分批实施策略
+
+## 4.1 第一批：先收正式真相
+
+### 鉴权
+
+目标状态：
+
+1. 后端通过 HttpOnly Cookie 持有 refresh session 与 access session。
+2. 前端请求层不再读写 access token。
+3. 前端只监听鉴权状态事件，不解释 token 生命周期。
+
+本批涉及：
+
+1. `server-node/src/auth/accessSessionCookie.ts`
+2. `server-node/src/routes/authRoutes.ts`
+3. `server-node/src/middleware/auth.ts`
+4. `src/services/apiClient.ts`
+5. `src/services/authService.ts`
+6. `src/components/auth/AuthGate.tsx`
+
+### 浏览历史
+
+目标状态：
+
+1. 浏览历史唯一真相在 `runtimeRepository`。
+2. 前端不再保留本地浏览历史、迁移标记、同步标记。
+3. 浏览历史只通过 `storageService` 读取和写入。
+
+本批涉及：
+
+1. `src/components/game-shell/PreGameSelectionFlow.tsx`
+2. `src/components/game-shell/PlatformHomeView.tsx`
+3. `src/services/storageService.ts`
+4. `src/services/platformBrowseHistory.ts`
+
+## 4.2 第二批：把 runtime story 快照解释权收回后端
+
+目标状态：
+
+1. 前端不再通过单独的 `PUT /runtime/save/snapshot` 预写快照再触发动作。
+2. runtime state / runtime action 允许前端提交当前快照上下文，由后端内部决定是否写入、如何解释、何时持久化。
+3. NPC 待接委托的 replace / abandon / accept 全部走后端 runtime action。
+
+建议实施方式：
+
+1. 扩展 `packages/shared/src/contracts/story.ts`
+   - `RuntimeStoryActionRequest` 增加可选 `snapshot`
+   - 新增 `RuntimeStoryStateRequest`
+2. 新增 `POST /api/runtime/story/state/resolve`
+3. `storyActionService` 内部统一处理“请求携带快照上下文时的服务端同步”
+4. 把 `npc_chat_quest_offer_replace` / `npc_chat_quest_offer_abandon` 接到后端 runtime action
+
+## 4.3 第三批：把正式生成编排收成后端唯一出口
+
+目标状态：
+
+1. `questDirector` 只保留轻量 SDK。
+2. `runtimeItemAiDirector` 只保留轻量 SDK。
+3. custom world profile 正式生成走后端 route。
+4. 浏览器侧 `src/services/ai.ts` 不再承担正式浏览器主链。
+
+建议实施方式：
+
+1. `server-node/src/routes/runtimeRoutes.ts`
+   - 补 `custom-world/profile` 正式 route
+2. `src/services/aiService.ts`
+   - custom world 入口改走后端
+3. `src/services/questDirector.ts`
+   - 只请求 `/api/runtime/quests/generate`
+4. `src/services/runtimeItemAiDirector.ts`
+   - 只请求 `/api/runtime/items/runtime-intent`
+
+---
+
+## 5. 本轮落地范围
+
+本轮优先完成以下内容：
+
+1. 鉴权 access token 从前端 localStorage 后移到后端 Cookie。
+2. 浏览历史从前端本地真相后移到后端唯一真相。
+3. custom world profile 正式生成入口补齐后端 route，并把前端收成 SDK。
+4. `questDirector` / `runtimeItemAiDirector` 收缩为前端 SDK。
+5. runtime story contract 开始补“随请求提交快照上下文”的后端承接能力，并把 NPC 待接委托 replace / abandon 接到后端。
+
+---
+
+## 6. 验收标准
+
+### 第一批验收
+
+1. 浏览器中不再保存 access token。
+2. `fetchWithApiAuth` 不再拼接 Bearer token。
+3. 浏览历史仅通过远端接口读写。
+4. `src/services/platformBrowseHistory.ts` 不再是正式链路依赖。
+
+### 第二批验收
+
+1. `runtimeStoryCoordinator.ts` 不再在动作前独立 `PUT /runtime/save/snapshot`。
+2. `NPC` 待接委托 replace / abandon / accept 都以后端返回结果为准。
+
+### 第三批验收
+
+1. `questDirector.ts` 与 `runtimeItemAiDirector.ts` 不再保留正式 fallback orchestration。
+2. custom world profile 的浏览器正式入口不再直接 import legacy `./ai`。
+
+---
+
+## 7. 一句话结论
+
+这轮迁移的重点不是“把几个 helper 挪到 server-node 目录”，而是：
+
+**把前端里仍然承担正式真相、正式运行时解释和正式生成编排的那一层职责，继续收回到 Express 后端。**
diff --git a/docs/technical/README.md b/docs/technical/README.md
index e98fb37a..5d9a63e1 100644
--- a/docs/technical/README.md
+++ b/docs/technical/README.md
@@ -4,6 +4,7 @@
 
 ## 文档列表
 
+- [FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md](./FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md)：把鉴权、浏览历史、runtime story 快照、NPC 待接委托与正式生成编排继续后移到 Express 后端的实施方案与验收口径。
 - [REPO_NOISE_CLEANUP_BASELINE_2026-04-19.md](./REPO_NOISE_CLEANUP_BASELINE_2026-04-19.md)：落实工程清理审计第一阶段后的仓库噪音清理范围、忽略规则闭合点与后续约束。
 - [PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md](./PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md)：后端提示词收口到 `server-node/src/prompts/` 的目录方案、兼容策略与后续新增规则。
 - [CUSTOM_WORLD_DRAFT_GENERATION_FAILURE_ANALYSIS_AND_FIX_2026-04-20.md](./CUSTOM_WORLD_DRAFT_GENERATION_FAILURE_ANALYSIS_AND_FIX_2026-04-20.md)：世界草稿生成失败后等待页误显示为“卡在编译草稿卡”的根因拆解、主链与增强链路边界，以及本次修复策略。
@@ -12,7 +13,9 @@
 - [AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE1_2026-04-20.md)：阶段一保持结果页深度编辑能力不变，同时把结果页完整世界快照同步回 Agent session 主链的方案说明。
 - [AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md)：阶段二把平台创作入口统一到聚合作品列表，并收紧 Agent 结果页的新增入口职责边界。
 - [AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md)：阶段三继续降级旧 pipeline，让创作中心只认 Agent 草稿与已发布作品，并把 Agent 结果页冻结为预览收口层。
+- [AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md](./AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md)：修正 Agent 对话框与结果页职责边界，明确 Agent 只收集八锚点，已有底稿的精修进入结果页完成。
 - [CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md](./CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md)：对照当前优化计划核查四阶段完成度，并明确这轮只允许物理删除旧 `custom-world/sessions` 世界生成链，不误伤 Agent 主链与已保存作品兼容编辑链。
+- [CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md)：梳理当前创作入口到结果页自动保存再到进入世界的全链前后端脚本地图，并给出文件级重构拆分方案、目标分层与阶段验收标准。
 - [CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md](./CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md)：创作页移动端底部 Tab、亮色主题 token 与滚动权责修复记录。
 - [TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md](./TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md)：把外部仓库 TXT 模式完整迁入当前项目的冻结边界、模块映射、分阶段计划与验收清单。
 - [NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md](./NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md)：当前 Node 运行时后端的技术栈、入口、鉴权、存储与接口知识图谱。
diff --git a/packages/shared/src/contracts/auth.ts b/packages/shared/src/contracts/auth.ts
index 6ee28cc6..62fdc2a8 100644
--- a/packages/shared/src/contracts/auth.ts
+++ b/packages/shared/src/contracts/auth.ts
@@ -78,7 +78,8 @@ export type AuthPhoneChangeResponse = {
 };
 
 export type AuthRefreshResponse = {
-  token: string;
+  ok: true;
+  token?: string;
 };
 
 export type AuthSessionSummary = {
diff --git a/packages/shared/src/contracts/story.ts b/packages/shared/src/contracts/story.ts
index 22a54340..025a0c1f 100644
--- a/packages/shared/src/contracts/story.ts
+++ b/packages/shared/src/contracts/story.ts
@@ -325,6 +325,9 @@ export const TASK6_RUNTIME_FUNCTION_IDS = [
   'forge_reforge',
   'inventory_use',
   'npc_gift',
+  'npc_chat_quest_offer_abandon',
+  'npc_chat_quest_offer_replace',
+  'npc_chat_quest_offer_view',
   'npc_quest_accept',
   'npc_quest_turn_in',
   'npc_trade',
@@ -360,6 +363,9 @@ export type RuntimeStoryOptionInteraction =
         | 'help'
         | 'fight'
         | 'leave'
+        | 'quest_offer_abandon'
+        | 'quest_offer_replace'
+        | 'quest_offer_view'
         | 'recruit'
         | 'spar'
         | 'trade'
@@ -481,7 +487,22 @@ export type RuntimeStoryPatch =
     };
 
 export type RuntimeStoryActionRequest =
-  RuntimeActionRequest<RuntimeStoryChoiceAction>;
+  RuntimeActionRequest<RuntimeStoryChoiceAction> & {
+    snapshot?: SavedGameSnapshotInput;
+  };
+
+export type RuntimeStoryStateRequest<
+  TSnapshotGameState = JsonObject,
+  TSnapshotCurrentStory = JsonObject,
+> = {
+  sessionId: string;
+  clientVersion?: number;
+  snapshot?: SavedGameSnapshotInput<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
+};
 
 export type RuntimeStoryActionResponse<
   TSnapshotGameState = JsonObject,
diff --git a/server-node/src/auth/accessSessionCookie.ts b/server-node/src/auth/accessSessionCookie.ts
new file mode 100644
index 00000000..54705270
--- /dev/null
+++ b/server-node/src/auth/accessSessionCookie.ts
@@ -0,0 +1,84 @@
+import type { Request, Response } from 'express';
+
+import type { AppConfig } from '../config.js';
+
+function buildCookieParts(
+  config: AppConfig,
+  value: string,
+  options: {
+    maxAgeSeconds: number;
+  },
+) {
+  const parts = [
+    `${config.authSession.accessCookieName}=${encodeURIComponent(value)}`,
+    `Path=${config.authSession.accessCookiePath}`,
+    'HttpOnly',
+    `SameSite=${config.authSession.accessCookieSameSite}`,
+    `Max-Age=${Math.max(0, Math.floor(options.maxAgeSeconds))}`,
+  ];
+
+  if (config.authSession.accessCookieSecure) {
+    parts.push('Secure');
+  }
+
+  return parts.join('; ');
+}
+
+function appendSetCookieHeader(response: Response, cookieValue: string) {
+  const currentHeader = response.getHeader('Set-Cookie');
+  if (!currentHeader) {
+    response.setHeader('Set-Cookie', cookieValue);
+    return;
+  }
+
+  if (Array.isArray(currentHeader)) {
+    response.setHeader('Set-Cookie', [...currentHeader, cookieValue]);
+    return;
+  }
+
+  response.setHeader('Set-Cookie', [String(currentHeader), cookieValue]);
+}
+
+export function setAccessSessionCookie(
+  response: Response,
+  config: AppConfig,
+  token: string,
+  maxAgeSeconds: number,
+) {
+  appendSetCookieHeader(
+    response,
+    buildCookieParts(config, token, {
+      maxAgeSeconds,
+    }),
+  );
+}
+
+export function clearAccessSessionCookie(response: Response, config: AppConfig) {
+  appendSetCookieHeader(
+    response,
+    buildCookieParts(config, '', {
+      maxAgeSeconds: 0,
+    }),
+  );
+}
+
+export function readAccessSessionToken(request: Request, config: AppConfig) {
+  const cookieHeader = request.header('cookie')?.trim() || '';
+  if (!cookieHeader) {
+    return '';
+  }
+
+  const cookieEntries = cookieHeader.split(';');
+  for (const entry of cookieEntries) {
+    const [rawName, ...valueParts] = entry.split('=');
+    const name = rawName?.trim();
+    if (name !== config.authSession.accessCookieName) {
+      continue;
+    }
+
+    const rawValue = valueParts.join('=').trim();
+    return rawValue ? decodeURIComponent(rawValue) : '';
+  }
+
+  return '';
+}
diff --git a/server-node/src/config.ts b/server-node/src/config.ts
index d59dc300..62aa943e 100644
--- a/server-node/src/config.ts
+++ b/server-node/src/config.ts
@@ -74,6 +74,11 @@ export type AppConfig = {
     mockAvatarUrl: string;
   };
   authSession: {
+    accessCookieName: string;
+    accessCookieTtlSeconds: number;
+    accessCookieSecure: boolean;
+    accessCookieSameSite: 'Lax' | 'Strict' | 'None';
+    accessCookiePath: string;
     refreshCookieName: string;
     refreshSessionTtlDays: number;
     refreshCookieSecure: boolean;
@@ -274,6 +279,11 @@ export function loadConfig(options: LoadConfigOptions = {}): AppConfig {
     'AUTH_REFRESH_COOKIE_SAME_SITE',
     'Lax',
   );
+  const accessSameSite = readString(
+    env,
+    'AUTH_ACCESS_COOKIE_SAME_SITE',
+    'Lax',
+  );
 
   return {
     nodeEnv,
@@ -484,6 +494,30 @@ export function loadConfig(options: LoadConfigOptions = {}): AppConfig {
       mockAvatarUrl: readString(env, 'WECHAT_MOCK_AVATAR_URL', ''),
     },
     authSession: {
+      accessCookieName: readString(
+        env,
+        'AUTH_ACCESS_COOKIE_NAME',
+        'genarrative_access_session',
+      ),
+      accessCookieTtlSeconds: readPositiveInt(
+        env,
+        'AUTH_ACCESS_COOKIE_TTL_SECONDS',
+        7200,
+      ),
+      accessCookieSecure: readBoolean(
+        env,
+        'AUTH_ACCESS_COOKIE_SECURE',
+        readString(env, 'NODE_ENV', 'development') === 'production',
+      ),
+      accessCookieSameSite:
+        accessSameSite === 'None' || accessSameSite === 'Strict'
+          ? (accessSameSite as AppConfig['authSession']['accessCookieSameSite'])
+          : 'Lax',
+      accessCookiePath: readString(
+        env,
+        'AUTH_ACCESS_COOKIE_PATH',
+        '/',
+      ),
       refreshCookieName: readString(
         env,
         'AUTH_REFRESH_COOKIE_NAME',
diff --git a/server-node/src/middleware/auth.ts b/server-node/src/middleware/auth.ts
index a67a415a..e7429d9b 100644
--- a/server-node/src/middleware/auth.ts
+++ b/server-node/src/middleware/auth.ts
@@ -1,5 +1,6 @@
 import type { NextFunction, Request, Response } from 'express';
 
+import { readAccessSessionToken } from '../auth/accessSessionCookie.js';
 import { verifyAccessToken } from '../auth/token.js';
 import type { AppConfig } from '../config.js';
 import { unauthorized } from '../errors.js';
@@ -16,9 +17,10 @@ function readBearerToken(request: Request) {
 export function requireJwtAuth(config: AppConfig, userRepository: UserRepository) {
   return async (request: Request, _response: Response, next: NextFunction) => {
     try {
-      const token = readBearerToken(request);
+      const token =
+        readBearerToken(request) || readAccessSessionToken(request, config);
       if (!token) {
-        throw unauthorized('缺少 Authorization Bearer Token');
+        throw unauthorized('缺少登录凭证');
       }
 
       const claims = await verifyAccessToken(token, config);
diff --git a/server-node/src/modules/custom-world/runtimeProfile.ts b/server-node/src/modules/custom-world/runtimeProfile.ts
index b4a706ff..039b1f2a 100644
--- a/server-node/src/modules/custom-world/runtimeProfile.ts
+++ b/server-node/src/modules/custom-world/runtimeProfile.ts
@@ -23,6 +23,8 @@ import type {
   CustomWorldRoleProfile,
   CustomWorldRoleSkill,
   RoleAttributeProfile,
+  SceneActBlueprint,
+  SceneChapterBlueprint,
   WorldAttributeSchema,
   WorldAttributeSlot,
   WorldType,
@@ -83,6 +85,18 @@ const WORLD_ATTRIBUTE_SLOT_IDS = [
   'axis_e',
   'axis_f',
 ] as const;
+const SCENE_ACT_STAGES = new Set([
+  'opening',
+  'expansion',
+  'turning_point',
+  'climax',
+  'aftermath',
+]);
+const SCENE_ACT_ADVANCE_RULES = new Set([
+  'after_primary_contact',
+  'after_active_step_complete',
+  'after_chapter_resolution',
+]);
 
 export const MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT = 5;
 export const MIN_CUSTOM_WORLD_TOTAL_NPC_COUNT = 30;
@@ -1434,6 +1448,105 @@ function normalizeItemList(value: unknown) {
     .filter((entry) => entry.name && entry.category);
 }
 
+function normalizeSceneActStageCoverage(value: unknown) {
+  const stageCoverage = Array.isArray(value)
+    ? value
+        .filter((entry): entry is string => typeof entry === 'string')
+        .map((entry) => entry.trim())
+        .filter((entry): entry is SceneActBlueprint['stageCoverage'][number] =>
+          SCENE_ACT_STAGES.has(entry as never),
+        )
+    : [];
+
+  return [...new Set(stageCoverage)];
+}
+
+function normalizeSceneActBlueprint(
+  value: unknown,
+  index: number,
+  sceneId: string,
+): SceneActBlueprint | null {
+  const item =
+    value && typeof value === 'object'
+      ? (value as Record<string, unknown>)
+      : null;
+  if (!item) {
+    return null;
+  }
+
+  const encounterNpcIds = toStringArray(item.encounterNpcIds);
+  const stageCoverage = normalizeSceneActStageCoverage(item.stageCoverage);
+  const advanceRule = toText(item.advanceRule);
+  const title = toText(item.title);
+  const summary = toText(item.summary);
+
+  if (!title && !summary && encounterNpcIds.length === 0) {
+    return null;
+  }
+
+  return {
+    id: toText(item.id) || `saved-scene-act-${sceneId}-${index + 1}`,
+    sceneId,
+    title: title || `第 ${index + 1} 幕`,
+    summary: summary || title || `围绕${sceneId}继续推进`,
+    stageCoverage:
+      stageCoverage.length > 0
+        ? stageCoverage
+        : index === 0
+          ? ['opening']
+          : ['climax', 'aftermath'],
+    backgroundImageSrc: toText(item.backgroundImageSrc) || undefined,
+    backgroundAssetId: toText(item.backgroundAssetId) || undefined,
+    encounterNpcIds,
+    primaryNpcId: toText(item.primaryNpcId) || encounterNpcIds[0] || '',
+    linkedThreadIds: toStringArray(item.linkedThreadIds),
+    advanceRule: SCENE_ACT_ADVANCE_RULES.has(advanceRule as never)
+      ? (advanceRule as SceneActBlueprint['advanceRule'])
+      : 'after_active_step_complete',
+    actGoal: toText(item.actGoal),
+    transitionHook: toText(item.transitionHook),
+  };
+}
+
+function normalizeSceneChapterBlueprints(value: unknown) {
+  if (!Array.isArray(value)) {
+    return null;
+  }
+
+  const normalized = value
+    .filter(
+      (entry): entry is Record<string, unknown> =>
+        Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry),
+    )
+    .map((entry, index) => {
+      const sceneId = toText(entry.sceneId);
+      if (!sceneId) {
+        return null;
+      }
+
+      const acts = Array.isArray(entry.acts)
+        ? entry.acts
+            .map((act, actIndex) =>
+              normalizeSceneActBlueprint(act, actIndex, sceneId),
+            )
+            .filter((act): act is SceneActBlueprint => Boolean(act))
+        : [];
+
+      return {
+        id: toText(entry.id) || `saved-scene-chapter-${sceneId}-${index + 1}`,
+        sceneId,
+        title: toText(entry.title) || toText(entry.sceneName) || sceneId,
+        summary: toText(entry.summary),
+        linkedThreadIds: toStringArray(entry.linkedThreadIds),
+        linkedLandmarkIds: toStringArray(entry.linkedLandmarkIds),
+        acts,
+      } satisfies SceneChapterBlueprint;
+    })
+    .filter((entry): entry is SceneChapterBlueprint => Boolean(entry));
+
+  return normalized.length > 0 ? normalized : null;
+}
+
 function normalizeLandmarks(params: {
   landmarks: Array<Record<string, unknown>>;
   storyNpcs: CustomWorldNpc[];
@@ -1655,6 +1768,9 @@ export function normalizeCustomWorldProfile(
       Array.isArray(item.threadContracts)
         ? (item.threadContracts as Array<Record<string, unknown>>)
         : null,
+    sceneChapterBlueprints: normalizeSceneChapterBlueprints(
+      item.sceneChapterBlueprints,
+    ),
     scenarioPackId: toText(item.scenarioPackId) || null,
     campaignPackId: toText(item.campaignPackId) || null,
   };
diff --git a/server-node/src/modules/quest/questStoryActionService.ts b/server-node/src/modules/quest/questStoryActionService.ts
index 42f35395..de2ce3ac 100644
--- a/server-node/src/modules/quest/questStoryActionService.ts
+++ b/server-node/src/modules/quest/questStoryActionService.ts
@@ -1,4 +1,5 @@
 import type {
+  RuntimeStoryOptionView,
   RuntimeStoryActionRequest,
   RuntimeStoryPatch,
 } from '../../../../packages/shared/src/contracts/story.js';
@@ -29,6 +30,9 @@ import {
 } from '../story/runtimeSession.js';
 
 const SUPPORTED_QUEST_STORY_FUNCTION_IDS = new Set<string>([
+  'npc_chat_quest_offer_abandon',
+  'npc_chat_quest_offer_replace',
+  'npc_chat_quest_offer_view',
   'npc_quest_accept',
   'npc_quest_turn_in',
 ]);
@@ -37,6 +41,9 @@ type QuestStoryResolution = {
   actionText: string;
   resultText: string;
   patches: RuntimeStoryPatch[];
+  storyText?: string;
+  presentationOptions?: RuntimeStoryOptionView[];
+  savedCurrentStory?: JsonRecord;
 };
 
 type JsonRecord = Record<string, unknown>;
@@ -140,6 +147,144 @@ function readPendingQuestOffer(
   return quest as RuntimeQuestLogEntry;
 }
 
+function readPendingQuestOfferContext(
+  currentStory: unknown,
+  npcKey: string,
+) {
+  if (!isObject(currentStory)) {
+    return null;
+  }
+
+  const npcChatState = isObject(currentStory.npcChatState)
+    ? currentStory.npcChatState
+    : null;
+  const pendingQuestOffer = isObject(npcChatState?.pendingQuestOffer)
+    ? npcChatState.pendingQuestOffer
+    : null;
+  const quest = readPendingQuestOffer(currentStory, npcKey);
+
+  if (!quest) {
+    return null;
+  }
+
+  const dialogue = Array.isArray(currentStory.dialogue)
+    ? currentStory.dialogue
+        .filter((entry) => isObject(entry))
+        .map((entry) => ({ ...entry }))
+    : [];
+  const turnCount =
+    typeof npcChatState?.turnCount === 'number' &&
+    Number.isFinite(npcChatState.turnCount)
+      ? Math.max(0, Math.round(npcChatState.turnCount))
+      : 0;
+  const customInputPlaceholder =
+    readString(npcChatState?.customInputPlaceholder) || '输入你想对 TA 说的话';
+
+  return {
+    dialogue,
+    turnCount,
+    customInputPlaceholder,
+    quest,
+    introText: readString(pendingQuestOffer?.introText),
+  };
+}
+
+function buildNpcChatOption(
+  encounter: RuntimeEncounter,
+  actionText: string,
+) {
+  return {
+    functionId: 'npc_chat',
+    actionText,
+    text: actionText,
+    detailText: '',
+    interaction: {
+      kind: 'npc',
+      npcId: encounter.id ?? encounter.npcName,
+      action: 'chat',
+    },
+    visuals: {
+      playerAnimation: 'idle',
+      playerMoveMeters: 0,
+      playerOffsetY: 0,
+      playerFacing: 'right',
+      scrollWorld: false,
+      monsterChanges: [],
+    },
+  } satisfies JsonRecord;
+}
+
+function buildPendingQuestOfferOptions(encounter: RuntimeEncounter) {
+  const npcId = encounter.id ?? encounter.npcName;
+  const buildOption = (
+    functionId:
+      | 'npc_chat_quest_offer_view'
+      | 'npc_chat_quest_offer_replace'
+      | 'npc_chat_quest_offer_abandon',
+    actionText: string,
+    action: 'quest_offer_view' | 'quest_offer_replace' | 'quest_offer_abandon',
+  ) =>
+    ({
+      functionId,
+      actionText,
+      text: actionText,
+      detailText: '',
+      interaction: {
+        kind: 'npc',
+        npcId,
+        action,
+      },
+      visuals: {
+        playerAnimation: 'idle',
+        playerMoveMeters: 0,
+        playerOffsetY: 0,
+        playerFacing: 'right',
+        scrollWorld: false,
+        monsterChanges: [],
+      },
+      runtimePayload:
+        functionId === 'npc_chat_quest_offer_view'
+          ? { npcChatQuestOfferAction: 'view' }
+          : functionId === 'npc_chat_quest_offer_replace'
+            ? { npcChatQuestOfferAction: 'replace' }
+            : { npcChatQuestOfferAction: 'abandon' },
+    }) satisfies JsonRecord;
+
+  return [
+    buildOption('npc_chat_quest_offer_view', '查看任务', 'quest_offer_view'),
+    buildOption(
+      'npc_chat_quest_offer_replace',
+      '更换任务',
+      'quest_offer_replace',
+    ),
+    buildOption(
+      'npc_chat_quest_offer_abandon',
+      '放弃任务',
+      'quest_offer_abandon',
+    ),
+  ];
+}
+
+function buildPostQuestOfferChatOptions(encounter: RuntimeEncounter) {
+  return [
+    '那先继续聊聊你刚才没说完的部分',
+    '除了委托，你对眼前局势还有什么判断',
+    '先把这附近真正危险的地方说清楚',
+  ].map((actionText) => buildNpcChatOption(encounter, actionText));
+}
+
+function buildQuestOfferDialogueText(
+  encounter: RuntimeEncounter,
+  quest: RuntimeQuestLogEntry,
+) {
+  const summaryText = readString(quest.summary) || readString(quest.description);
+  return `${encounter.npcName}沉吟了片刻，像是终于把真正想托付的事说了出来。${
+    summaryText
+      ? `如果你愿意，我想把这件事正式交给你：${summaryText}`
+      : '如果你愿意，我想把眼前这件事正式交给你。'
+  }`;
+}
+
 function ensureEncounterQuestContext(session: RuntimeSession) {
   const state = session.rawGameState as unknown as RuntimeGameState;
   const encounter = getNpcEncounter(session, state);
@@ -225,6 +370,171 @@ function resolveQuestAcceptAction(
   };
 }
 
+function resolveQuestOfferViewAction(
+  session: RuntimeSession,
+  currentStory?: unknown,
+): QuestStoryResolution {
+  const { encounter, npcKey } = ensureEncounterQuestContext(session);
+  const pendingOffer = readPendingQuestOfferContext(currentStory, npcKey);
+  if (!pendingOffer) {
+    throw conflict('当前没有待处理的委托可查看。');
+  }
+
+  return {
+    actionText: `查看${encounter.npcName}提出的委托`,
+    resultText: readString(pendingOffer.introText) || buildQuestOfferDialogueText(encounter, pendingOffer.quest),
+    patches: [],
+  };
+}
+
+function resolveQuestOfferReplaceAction(
+  session: RuntimeSession,
+  currentStory?: unknown,
+): QuestStoryResolution {
+  const { state, encounter, npcKey } = ensureEncounterQuestContext(session);
+  const pendingOffer = readPendingQuestOfferContext(currentStory, npcKey);
+  if (!pendingOffer) {
+    throw conflict('当前没有待处理的委托可更换。');
+  }
+
+  const nextQuest = buildQuestForEncounter({
+    issuerNpcId: npcKey,
+    issuerNpcName: encounter.npcName,
+    roleText: encounter.context,
+    scene: state.currentScenePreset,
+    worldType: state.worldType,
+    context: {
+      worldType: state.worldType,
+      recentStoryMoments: Array.isArray(state.storyHistory)
+        ? state.storyHistory.slice(-6)
+        : [],
+      playerCharacter: state.playerCharacter ?? null,
+      playerProgression: state.playerProgression ?? null,
+    },
+    currentQuests: (Array.isArray(state.quests) ? state.quests : []).map((item) => ({
+      id: item.id,
+      issuerNpcId: item.issuerNpcId,
+      status: item.status,
+    })),
+  });
+
+  if (!nextQuest) {
+    throw conflict('当前没有更合适的委托可供更换。');
+  }
+
+  const dialogue = [
+    ...pendingOffer.dialogue,
+    {
+      speaker: 'player',
+      text: '能不能换一份更适合眼下局势的委托？',
+    },
+    {
+      speaker: 'npc',
+      speakerName: encounter.npcName,
+      text: buildQuestOfferDialogueText(encounter, nextQuest),
+    },
+  ];
+
+  return {
+    actionText: `请${encounter.npcName}更换委托`,
+    resultText: buildQuestOfferDialogueText(encounter, nextQuest),
+    storyText: buildQuestOfferDialogueText(encounter, nextQuest),
+    savedCurrentStory: {
+      text: dialogue
+        .map((entry) => readString(entry.text))
+        .filter(Boolean)
+        .join('\n'),
+      options: buildPendingQuestOfferOptions(encounter),
+      displayMode: 'dialogue',
+      dialogue,
+      streaming: false,
+      npcChatState: {
+        npcId: npcKey,
+        npcName: encounter.npcName,
+        turnCount: pendingOffer.turnCount,
+        customInputPlaceholder: pendingOffer.customInputPlaceholder,
+        pendingQuestOffer: {
+          quest: nextQuest,
+        },
+      },
+    },
+    presentationOptions: buildPendingQuestOfferOptions(encounter).map((option) => ({
+      functionId: readString(option.functionId),
+      actionText: readString(option.actionText),
+      detailText: '',
+      scope: 'npc',
+      interaction: isObject(option.interaction)
+        ? (option.interaction as RuntimeStoryOptionView['interaction'])
+        : undefined,
+      payload: isObject(option.runtimePayload)
+        ? (option.runtimePayload as Record<string, unknown>)
+        : undefined,
+    })),
+    patches: [],
+  };
+}
+
+function resolveQuestOfferAbandonAction(
+  session: RuntimeSession,
+  currentStory?: unknown,
+): QuestStoryResolution {
+  const { encounter, npcKey } = ensureEncounterQuestContext(session);
+  const pendingOffer = readPendingQuestOfferContext(currentStory, npcKey);
+  if (!pendingOffer) {
+    throw conflict('当前没有待处理的委托可放弃。');
+  }
+
+  const npcReply = `${encounter.npcName}点了点头，没有继续强求，只把这份委托暂时收了回去。`;
+  const dialogue = [
+    ...pendingOffer.dialogue,
+    {
+      speaker: 'player',
+      text: '这件事我先不接，咱们还是先聊别的。',
+    },
+    {
+      speaker: 'npc',
+      speakerName: encounter.npcName,
+      text: npcReply,
+    },
+  ];
+
+  return {
+    actionText: `暂不接受${encounter.npcName}的委托`,
+    resultText: npcReply,
+    storyText: npcReply,
+    savedCurrentStory: {
+      text: dialogue
+        .map((entry) => readString(entry.text))
+        .filter(Boolean)
+        .join('\n'),
+      options: buildPostQuestOfferChatOptions(encounter),
+      displayMode: 'dialogue',
+      dialogue,
+      streaming: false,
+      npcChatState: {
+        npcId: npcKey,
+        npcName: encounter.npcName,
+        turnCount: pendingOffer.turnCount,
+        customInputPlaceholder: pendingOffer.customInputPlaceholder,
+        pendingQuestOffer: null,
+      },
+    },
+    presentationOptions: buildPostQuestOfferChatOptions(encounter).map((option) => ({
+      functionId: readString(option.functionId),
+      actionText: readString(option.actionText),
+      detailText: '',
+      scope: 'npc',
+      interaction: isObject(option.interaction)
+        ? (option.interaction as RuntimeStoryOptionView['interaction'])
+        : undefined,
+      payload: isObject(option.runtimePayload)
+        ? (option.runtimePayload as Record<string, unknown>)
+        : undefined,
+    })),
+    patches: [],
+  };
+}
+
 function resolveQuestTurnInAction(
   session: RuntimeSession,
   request: RuntimeStoryActionRequest,
@@ -311,6 +621,12 @@ export function resolveQuestStoryAction(
   } = {},
 ): QuestStoryResolution {
   switch (request.action.functionId) {
+    case 'npc_chat_quest_offer_view':
+      return resolveQuestOfferViewAction(session, options.currentStory);
+    case 'npc_chat_quest_offer_replace':
+      return resolveQuestOfferReplaceAction(session, options.currentStory);
+    case 'npc_chat_quest_offer_abandon':
+      return resolveQuestOfferAbandonAction(session, options.currentStory);
     case 'npc_quest_accept':
       return resolveQuestAcceptAction(session, options.currentStory);
     case 'npc_quest_turn_in':
diff --git a/server-node/src/modules/story/runtimeSession.ts b/server-node/src/modules/story/runtimeSession.ts
index 7a87dfff..7e38ce43 100644
--- a/server-node/src/modules/story/runtimeSession.ts
+++ b/server-node/src/modules/story/runtimeSession.ts
@@ -738,6 +738,21 @@ function buildOptionInteraction(
       npc_spar: { kind: 'npc', npcId, action: 'spar' },
       npc_trade: { kind: 'npc', npcId, action: 'trade' },
       npc_gift: { kind: 'npc', npcId, action: 'gift' },
+      npc_chat_quest_offer_view: {
+        kind: 'npc',
+        npcId,
+        action: 'quest_offer_view',
+      },
+      npc_chat_quest_offer_replace: {
+        kind: 'npc',
+        npcId,
+        action: 'quest_offer_replace',
+      },
+      npc_chat_quest_offer_abandon: {
+        kind: 'npc',
+        npcId,
+        action: 'quest_offer_abandon',
+      },
       npc_quest_accept: { kind: 'npc', npcId, action: 'quest_accept' },
       npc_quest_turn_in: { kind: 'npc', npcId, action: 'quest_turn_in' },
     };
diff --git a/server-node/src/modules/story/storyActionRoutes.ts b/server-node/src/modules/story/storyActionRoutes.ts
index f9bc124c..857e0f21 100644
--- a/server-node/src/modules/story/storyActionRoutes.ts
+++ b/server-node/src/modules/story/storyActionRoutes.ts
@@ -1,7 +1,10 @@
 import { Router } from 'express';
 import { z } from 'zod';
 
-import type { RuntimeStoryActionRequest } from '../../../../packages/shared/src/contracts/story.js';
+import type {
+  RuntimeStoryActionRequest,
+  RuntimeStoryStateRequest,
+} from '../../../../packages/shared/src/contracts/story.js';
 import type { AppContext } from '../../context.js';
 import { badRequest } from '../../errors.js';
 import { asyncHandler, sendApiResponse } from '../../http.js';
@@ -17,6 +20,7 @@ const actionPayloadSchema = z.record(z.string(), z.unknown());
 const runtimeStoryActionSchema = z.object({
   sessionId: z.string().trim().min(1),
   clientVersion: z.number().int().min(0).optional(),
+  snapshot: z.unknown().optional(),
   action: z.object({
     type: z.literal('story_choice'),
     functionId: z.string().trim().min(1),
@@ -25,6 +29,12 @@ const runtimeStoryActionSchema = z.object({
   }),
 });
 
+const runtimeStoryStateResolveSchema = z.object({
+  sessionId: z.string().trim().min(1),
+  clientVersion: z.number().int().min(0).optional(),
+  snapshot: z.unknown().optional(),
+});
+
 export function createStoryActionRoutes(context: AppContext) {
   const router = Router();
   const requireAuth = requireJwtAuth(context.config, context.userRepository);
@@ -70,5 +80,25 @@ export function createStoryActionRoutes(context: AppContext) {
     }),
   );
 
+  router.post(
+    '/state/resolve',
+    routeMeta({ operation: 'runtime.story.state.resolve' }),
+    asyncHandler(async (request, response) => {
+      const payload = runtimeStoryStateResolveSchema.parse(
+        request.body,
+      ) as RuntimeStoryStateRequest;
+      sendApiResponse(
+        response,
+        await getRuntimeStoryState({
+          runtimeRepository: context.runtimeRepository,
+          userId: request.userId!,
+          sessionId: payload.sessionId,
+          clientVersion: payload.clientVersion,
+          snapshot: payload.snapshot,
+        }),
+      );
+    }),
+  );
+
   return router;
 }
diff --git a/server-node/src/modules/story/storyActionService.ts b/server-node/src/modules/story/storyActionService.ts
index 15c84ef6..86203ef3 100644
--- a/server-node/src/modules/story/storyActionService.ts
+++ b/server-node/src/modules/story/storyActionService.ts
@@ -4,6 +4,7 @@ import type {
   RuntimeStoryActionResponse,
   RuntimeStoryOptionView,
   RuntimeStoryPatch,
+  RuntimeStoryStateRequest,
 } from '../../../../packages/shared/src/contracts/story.js';
 import { conflict, invalidRequest } from '../../errors.js';
 import type { RuntimeRepositoryPort } from '../../repositories/runtimeRepository.js';
@@ -59,6 +60,8 @@ type StoryResolution = {
   resultText: string;
   patches: RuntimeStoryPatch[];
   storyText?: string;
+  presentationOptions?: RuntimeStoryOptionView[];
+  savedCurrentStory?: JsonRecord;
   battle?: RuntimeBattlePresentation | null;
   toast?: string | null;
 };
@@ -604,6 +607,48 @@ function readSavedStoryText(currentStory: unknown) {
   return '';
 }
 
+function normalizeIncomingSnapshot(snapshot: unknown) {
+  if (!isObject(snapshot)) {
+    return null;
+  }
+
+  const gameState = 'gameState' in snapshot ? snapshot.gameState : null;
+  const bottomTab = readString(snapshot.bottomTab) || 'adventure';
+  const currentStory = 'currentStory' in snapshot ? snapshot.currentStory : null;
+  const savedAt = readString(snapshot.savedAt) || new Date().toISOString();
+
+  if (!gameState || !isObject(gameState)) {
+    return null;
+  }
+
+  return normalizeSavedSnapshotPayload({
+    savedAt,
+    bottomTab,
+    gameState,
+    currentStory: currentStory ?? null,
+  });
+}
+
+async function resolveSnapshotForRequest(params: {
+  runtimeRepository: RuntimeRepositoryPort;
+  userId: string;
+  snapshot?: unknown;
+}) {
+  const incomingSnapshot = normalizeIncomingSnapshot(params.snapshot);
+  if (incomingSnapshot) {
+    return hydrateSavedSnapshot(
+      await params.runtimeRepository.putSnapshot(params.userId, incomingSnapshot),
+    )!;
+  }
+
+  const persistedSnapshot = await params.runtimeRepository.getSnapshot(params.userId);
+  if (!persistedSnapshot) {
+    throw conflict('运行时快照不存在，请先初始化并保存一次游戏');
+  }
+
+  return hydrateSavedSnapshot(persistedSnapshot)!;
+}
+
 function buildFallbackStoryText(session: RuntimeSession) {
   if (session.inBattle && session.sceneHostileNpcs.length > 0) {
     return `眼前的冲突还没结束，${session.sceneHostileNpcs[0]!.name}仍在逼你立刻做出下一步判断。`;
@@ -860,11 +905,11 @@ export async function resolveRuntimeStoryAction(params: {
   userId: string;
   request: RuntimeStoryActionRequest;
 }) {
-  const snapshot = await params.runtimeRepository.getSnapshot(params.userId);
-  if (!snapshot) {
-    throw conflict('运行时快照不存在，请先初始化并保存一次游戏');
-  }
-  const hydratedSnapshot = hydrateSavedSnapshot(snapshot)!;
+  const hydratedSnapshot = await resolveSnapshotForRequest({
+    runtimeRepository: params.runtimeRepository,
+    userId: params.userId,
+    snapshot: params.request.snapshot,
+  });
 
   const functionId =
     typeof params.request.action.functionId === 'string'
@@ -968,6 +1013,12 @@ export async function resolveRuntimeStoryAction(params: {
     storyText,
     options,
   );
+  if (resolution.presentationOptions?.length) {
+    options = resolution.presentationOptions;
+  }
+  if (resolution.savedCurrentStory) {
+    savedCurrentStory = resolution.savedCurrentStory;
+  }
   const pendingQuestAcceptedCurrentStory =
     functionId === 'npc_quest_accept'
       ? buildPendingQuestAcceptedCurrentStory({
@@ -1061,14 +1112,25 @@ export async function getRuntimeStoryState(params: {
   runtimeRepository: RuntimeRepositoryPort;
   userId: string;
   sessionId: string;
+  clientVersion?: number;
+  snapshot?: RuntimeStoryStateRequest['snapshot'];
 }) {
-  const snapshot = await params.runtimeRepository.getSnapshot(params.userId);
-  if (!snapshot) {
-    throw conflict('运行时快照不存在，请先初始化并保存一次游戏');
-  }
-  const hydratedSnapshot = hydrateSavedSnapshot(snapshot)!;
+  const hydratedSnapshot = await resolveSnapshotForRequest({
+    runtimeRepository: params.runtimeRepository,
+    userId: params.userId,
+    snapshot: params.snapshot,
+  });
 
   const session = loadRuntimeSession(hydratedSnapshot, params.sessionId);
+  if (
+    typeof params.clientVersion === 'number' &&
+    params.clientVersion !== session.runtimeVersion
+  ) {
+    throw conflict('运行时版本已变化，请先同步最新快照后再读取状态', {
+      clientVersion: params.clientVersion,
+      serverVersion: session.runtimeVersion,
+    });
+  }
   ensureNpcInventorySessionState(session);
   const options = buildAvailableOptions(session);
   const storyText =
diff --git a/server-node/src/routes/authRoutes.ts b/server-node/src/routes/authRoutes.ts
index 4afe0e86..5461e28b 100644
--- a/server-node/src/routes/authRoutes.ts
+++ b/server-node/src/routes/authRoutes.ts
@@ -1,4 +1,4 @@
-import { type Request, Router } from 'express';
+import { type Request, type Response, Router } from 'express';
 import { z } from 'zod';
 
 import type {
@@ -30,6 +30,10 @@ import {
   sendPhoneLoginCode,
   startWechatLogin,
 } from '../auth/authService.js';
+import {
+  clearAccessSessionCookie,
+  setAccessSessionCookie,
+} from '../auth/accessSessionCookie.js';
 import {
   clearRefreshSessionCookie,
   readRefreshSessionToken,
@@ -112,6 +116,23 @@ function buildRefreshCookieLifetimeSeconds(
   );
 }
 
+function buildAccessCookieLifetimeSeconds(context: AppContext) {
+  return Math.max(0, context.config.authSession.accessCookieTtlSeconds);
+}
+
+async function writeAccessSessionCookie(
+  context: AppContext,
+  response: Response,
+  token: string,
+) {
+  setAccessSessionCookie(
+    response,
+    context.config,
+    token,
+    buildAccessCookieLifetimeSeconds(context),
+  );
+}
+
 export function createAuthRoutes(context: AppContext) {
   const router = Router();
   const requireAuth = requireJwtAuth(context.config, context.userRepository);
@@ -145,6 +166,7 @@ export function createAuthRoutes(context: AppContext) {
         user,
         requestContext,
       );
+      await writeAccessSessionCookie(context, response, result.token);
       setRefreshSessionCookie(
         response,
         context.config,
@@ -223,6 +245,7 @@ export function createAuthRoutes(context: AppContext) {
         user,
         requestContext,
       );
+      await writeAccessSessionCookie(context, response, result.token);
       setRefreshSessionCookie(
         response,
         context.config,
@@ -298,6 +321,7 @@ export function createAuthRoutes(context: AppContext) {
           user,
           requestContext,
         );
+        await writeAccessSessionCookie(context, response, result.token);
         setRefreshSessionCookie(
           response,
           context.config,
@@ -309,7 +333,6 @@ export function createAuthRoutes(context: AppContext) {
           302,
           buildAuthResultRedirectUrl(redirectPath, {
             auth_provider: 'wechat',
-            auth_token: result.token,
             auth_binding_status: result.user.bindingStatus,
           }),
         );
@@ -352,6 +375,7 @@ export function createAuthRoutes(context: AppContext) {
         user,
         requestContext,
       );
+      await writeAccessSessionCookie(context, response, result.token);
       setRefreshSessionCookie(
         response,
         context.config,
@@ -369,6 +393,7 @@ export function createAuthRoutes(context: AppContext) {
       const refreshToken = readRefreshSessionToken(request, context.config);
       try {
         const result = await refreshAuthSession(context, refreshToken);
+        await writeAccessSessionCookie(context, response, result.token);
         setRefreshSessionCookie(
           response,
           context.config,
@@ -376,9 +401,11 @@ export function createAuthRoutes(context: AppContext) {
           buildRefreshCookieLifetimeSeconds(context, result.refreshExpiresAt),
         );
         sendApiResponse(response, {
+          ok: true,
           token: result.token,
         });
       } catch (error) {
+        clearAccessSessionCookie(response, context.config);
         clearRefreshSessionCookie(response, context.config);
         throw error;
       }
@@ -479,6 +506,7 @@ export function createAuthRoutes(context: AppContext) {
     routeMeta({ operation: 'auth.logout_all' }),
     requireAuth,
     asyncHandler(async (request, response) => {
+      clearAccessSessionCookie(response, context.config);
       clearRefreshSessionCookie(response, context.config);
       sendApiResponse(
         response,
@@ -498,6 +526,7 @@ export function createAuthRoutes(context: AppContext) {
     asyncHandler(async (request, response) => {
       const refreshToken = readRefreshSessionToken(request, context.config);
       await revokeRefreshSession(context, refreshToken);
+      clearAccessSessionCookie(response, context.config);
       clearRefreshSessionCookie(response, context.config);
       sendApiResponse(
         response,
diff --git a/server-node/src/routes/runtimeRoutes.ts b/server-node/src/routes/runtimeRoutes.ts
index b67a2538..ddcd13d5 100644
--- a/server-node/src/routes/runtimeRoutes.ts
+++ b/server-node/src/routes/runtimeRoutes.ts
@@ -7,6 +7,7 @@ import type {
   CustomWorldGalleryResponse,
   CustomWorldLibraryMutationResponse,
   CustomWorldLibraryResponse,
+  GenerateCustomWorldProfileInput,
   PlatformBrowseHistoryBatchSyncRequest,
   PlatformBrowseHistoryResponse,
   PlatformBrowseHistoryWriteEntry,
@@ -50,6 +51,7 @@ import {
   streamNpcChatTurnFromOrchestrator,
   streamNpcRecruitDialogueFromOrchestrator,
 } from '../modules/ai/chatOrchestrator.js';
+import { generateCustomWorldProfileFromOrchestrator } from '../modules/ai/customWorldOrchestrator.js';
 import {
   hydrateSavedSnapshot,
   normalizeSavedSnapshotPayload,
@@ -118,6 +120,12 @@ const customWorldProfileSchema = z.object({
   profile: jsonObjectSchema,
 });
 
+const customWorldProfileGenerationSchema = z.object({
+  settingText: z.string().trim().min(1),
+  creatorIntent: jsonObjectSchema.nullish(),
+  generationMode: z.enum(['fast', 'full']).optional(),
+});
+
 const customWorldSceneNpcSchema = z.object({
   profile: jsonObjectSchema,
   landmarkId: z.string().trim().min(1),
@@ -600,6 +608,23 @@ export function createRuntimeRoutes(context: AppContext) {
     }),
   );
 
+  router.post(
+    '/runtime/custom-world/profile',
+    routeMeta({ operation: 'runtime.customWorld.profile' }),
+    asyncHandler(async (request, response) => {
+      const payload = customWorldProfileGenerationSchema.parse(
+        request.body,
+      ) as GenerateCustomWorldProfileInput;
+      sendApiResponse(
+        response,
+        await generateCustomWorldProfileFromOrchestrator(
+          context.llmClient,
+          payload,
+        ),
+      );
+    }),
+  );
+
   router.post(
     '/runtime/custom-world-library/:profileId/publish',
     routeMeta({ operation: 'runtime.customWorldLibrary.publish' }),
diff --git a/server-node/src/services/customWorldAgentOrchestrator.ts b/server-node/src/services/customWorldAgentOrchestrator.ts
index a1292a02..484e2320 100644
--- a/server-node/src/services/customWorldAgentOrchestrator.ts
+++ b/server-node/src/services/customWorldAgentOrchestrator.ts
@@ -198,6 +198,116 @@ function buildRoleAssetSyncResultText(params: {
   return `已把「${params.roleName}」的角色资产写回草稿，当前状态：${params.assetStatusLabel}。`;
 }
 
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function toRecordArray(value: unknown) {
+  return Array.isArray(value)
+    ? value.filter((item): item is Record<string, unknown> => isRecord(item))
+    : [];
+}
+
+function cloneJsonRecord<T>(value: T): T {
+  return JSON.parse(JSON.stringify(value)) as T;
+}
+
+function syncRoleAssetsFromResultProfile(params: {
+  currentRoles: unknown;
+  resultRoles: unknown;
+}) {
+  const resultRoleById = new Map(
+    toRecordArray(params.resultRoles).map((role) => [toText(role.id), role]),
+  );
+
+  return toRecordArray(params.currentRoles).map((currentRole) => {
+    const resultRole = resultRoleById.get(toText(currentRole.id));
+    if (!resultRole) {
+      return currentRole;
+    }
+
+    return {
+      ...currentRole,
+      imageSrc: toText(resultRole.imageSrc) || null,
+      generatedVisualAssetId: toText(resultRole.generatedVisualAssetId) || null,
+      generatedAnimationSetId:
+        toText(resultRole.generatedAnimationSetId) || null,
+      animationMap: isRecord(resultRole.animationMap)
+        ? cloneJsonRecord(resultRole.animationMap)
+        : null,
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function syncLandmarkAssetsFromResultProfile(params: {
+  currentLandmarks: unknown;
+  resultLandmarks: unknown;
+}) {
+  const resultLandmarkById = new Map(
+    toRecordArray(params.resultLandmarks).map((landmark) => [
+      toText(landmark.id),
+      landmark,
+    ]),
+  );
+
+  return toRecordArray(params.currentLandmarks).map((currentLandmark) => {
+    const resultLandmark = resultLandmarkById.get(toText(currentLandmark.id));
+    if (!resultLandmark) {
+      return currentLandmark;
+    }
+
+    return {
+      ...currentLandmark,
+      imageSrc: toText(resultLandmark.imageSrc) || null,
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function syncSceneChapterAssetsFromResultProfile(params: {
+  currentSceneChapters: unknown;
+  resultSceneChapters: unknown;
+}) {
+  const resultSceneChapterBySceneId = new Map(
+    toRecordArray(params.resultSceneChapters).map((chapter) => [
+      toText(chapter.sceneId),
+      chapter,
+    ]),
+  );
+
+  return toRecordArray(params.currentSceneChapters).map((currentChapter) => {
+    const resultChapter = resultSceneChapterBySceneId.get(
+      toText(currentChapter.sceneId),
+    );
+    if (!resultChapter) {
+      return currentChapter;
+    }
+
+    const resultActById = new Map(
+      toRecordArray(resultChapter.acts).map((act) => [toText(act.id), act]),
+    );
+
+    return {
+      ...currentChapter,
+      acts: toRecordArray(currentChapter.acts).map((currentAct) => {
+        const resultAct = resultActById.get(toText(currentAct.id));
+        if (!resultAct) {
+          return currentAct;
+        }
+
+        return {
+          ...currentAct,
+          backgroundImageSrc: toText(resultAct.backgroundImageSrc) || null,
+          backgroundAssetId: toText(resultAct.backgroundAssetId) || null,
+        } satisfies Record<string, unknown>;
+      }),
+    } satisfies Record<string, unknown>;
+  });
+}
+
 function syncResultProfileIntoDraftProfile(params: {
   currentDraftProfile: Record<string, unknown> | null | undefined;
   resultProfile: CustomWorldProfile;
@@ -215,6 +325,22 @@ function syncResultProfileIntoDraftProfile(params: {
     playerGoal: resultProfile.playerGoal,
     majorFactions: resultProfile.majorFactions,
     coreConflicts: resultProfile.coreConflicts,
+    playableNpcs: syncRoleAssetsFromResultProfile({
+      currentRoles: currentDraftProfile.playableNpcs,
+      resultRoles: resultProfile.playableNpcs,
+    }),
+    storyNpcs: syncRoleAssetsFromResultProfile({
+      currentRoles: currentDraftProfile.storyNpcs,
+      resultRoles: resultProfile.storyNpcs,
+    }),
+    landmarks: syncLandmarkAssetsFromResultProfile({
+      currentLandmarks: currentDraftProfile.landmarks,
+      resultLandmarks: resultProfile.landmarks,
+    }),
+    sceneChapters: syncSceneChapterAssetsFromResultProfile({
+      currentSceneChapters: currentDraftProfile.sceneChapters,
+      resultSceneChapters: resultProfile.sceneChapterBlueprints,
+    }),
     legacyResultProfile: resultProfile as unknown as Record<string, unknown>,
   } satisfies Record<string, unknown>;
 }
diff --git a/server-node/src/services/customWorldAgentPhase4.test.ts b/server-node/src/services/customWorldAgentPhase4.test.ts
index d2a6302b..edf5c4db 100644
--- a/server-node/src/services/customWorldAgentPhase4.test.ts
+++ b/server-node/src/services/customWorldAgentPhase4.test.ts
@@ -421,6 +421,162 @@ test('phase4 sync_result_profile keeps existing foundation structure while updat
   );
 });
 
+test('phase4 sync_result_profile also writes latest role and scene assets back into draft profile', async () => {
+  const runtimeRepository = createRuntimeRepositoryStub();
+  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+  });
+  const userId = 'user-phase4-sync-result-profile-assets';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+  const baselineProfile = normalizeFoundationDraftProfile(session.draftProfile)!;
+  const playableRole = baselineProfile.playableNpcs[0]!;
+  const storyRole = baselineProfile.storyNpcs[0]!;
+  const landmark = baselineProfile.landmarks[0]!;
+
+  const response = await orchestrator.executeAction(userId, session.sessionId, {
+    action: 'sync_result_profile',
+    profile: {
+      id: `agent-draft-${session.sessionId}`,
+      settingText: '被海雾吞没的旧航路群岛',
+      name: '潮雾列岛·结果页精修版',
+      subtitle: '旧灯塔与失控航路',
+      summary: '结果页已经把最新图与动作一起确认。 ',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清沉船夜与假航灯的真正操盘者。',
+      templateWorldType: 'WUXIA',
+      majorFactions: ['守灯会', '航运公会'],
+      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      attributeSchema: {
+        id: 'schema:test',
+        worldId: 'CUSTOM',
+        schemaVersion: 1,
+        schemaName: '测试',
+        generatedFrom: {
+          worldType: 'CUSTOM',
+          worldName: '潮雾列岛·结果页精修版',
+          settingSummary: '测试',
+          tone: '测试',
+          conflictCore: '测试',
+        },
+        slots: [],
+      },
+      playableNpcs: [
+        {
+          id: playableRole.id,
+          name: playableRole.name,
+          title: '结果页角色',
+          role: '关键同行者',
+          description: '结果页确认的最新角色资产。',
+          backstory: '测试',
+          personality: '冷静',
+          motivation: '验证资产回写',
+          combatStyle: '观察',
+          initialAffinity: 12,
+          relationshipHooks: [],
+          tags: [],
+          imageSrc: '/generated/playable/latest-master.png',
+          generatedVisualAssetId: 'visual-playable-latest',
+          generatedAnimationSetId: 'anim-playable-latest',
+          animationMap: {
+            idle: {
+              spriteSheetPath: '/generated/playable/idle.png',
+            },
+          },
+        },
+      ],
+      storyNpcs: [
+        {
+          id: storyRole.id,
+          name: storyRole.name,
+          title: '结果页场景角色',
+          role: '场景关键角色',
+          description: '结果页确认的最新场景角色资产。',
+          backstory: '测试',
+          personality: '克制',
+          motivation: '验证资产回写',
+          combatStyle: '观察',
+          initialAffinity: 6,
+          relationshipHooks: [],
+          tags: [],
+          imageSrc: '/generated/story/latest-master.png',
+          generatedVisualAssetId: 'visual-story-latest',
+        },
+      ],
+      items: [],
+      landmarks: [
+        {
+          id: landmark.id,
+          name: landmark.name,
+          description: '结果页确认的最新地点图。',
+          dangerLevel: '中',
+          sceneNpcIds: [],
+          connections: [],
+          imageSrc: '/generated/landmark/latest-scene.png',
+        },
+      ],
+      sceneChapterBlueprints: [
+        {
+          id: 'scene-chapter-1',
+          sceneId: landmark.id,
+          title: '灯塔初章',
+          summary: '结果页确认最新分幕图。',
+          linkedThreadIds: [],
+          linkedLandmarkIds: [landmark.id],
+          acts: [
+            {
+              id: `${landmark.id}-act-1`,
+              sceneId: landmark.id,
+              title: '第一幕',
+              summary: '第一幕',
+              stageCoverage: ['opening'],
+              backgroundImageSrc: '/generated/scene/act-1-latest.png',
+              backgroundAssetId: 'scene-asset-latest',
+              encounterNpcIds: [],
+              primaryNpcId: '',
+              linkedThreadIds: [],
+              advanceRule: 'after_primary_contact',
+              actGoal: '验证分幕图回写',
+              transitionHook: '进入下一幕',
+            },
+          ],
+        },
+      ],
+      generationMode: 'full',
+      generationStatus: 'complete',
+    },
+  });
+  const operation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    response.operation.operationId,
+  );
+  const snapshot = await orchestrator.getSessionSnapshot(userId, session.sessionId);
+  const profile = normalizeFoundationDraftProfile(snapshot?.draftProfile)!;
+  const syncedPlayable = profile.playableNpcs.find(
+    (entry) => entry.id === playableRole.id,
+  );
+  const syncedStory = profile.storyNpcs.find((entry) => entry.id === storyRole.id);
+  const syncedLandmark = profile.landmarks.find((entry) => entry.id === landmark.id);
+  const syncedSceneAct = profile.sceneChapters[0]?.acts[0];
+
+  assert.equal(operation?.status, 'completed');
+  assert.equal(syncedPlayable?.imageSrc, '/generated/playable/latest-master.png');
+  assert.equal(syncedPlayable?.generatedVisualAssetId, 'visual-playable-latest');
+  assert.equal(syncedPlayable?.generatedAnimationSetId, 'anim-playable-latest');
+  assert.deepEqual(syncedPlayable?.animationMap, {
+    idle: {
+      spriteSheetPath: '/generated/playable/idle.png',
+    },
+  });
+  assert.equal(syncedStory?.imageSrc, '/generated/story/latest-master.png');
+  assert.equal(syncedStory?.generatedVisualAssetId, 'visual-story-latest');
+  assert.equal(syncedLandmark?.imageSrc, '/generated/landmark/latest-scene.png');
+  assert.equal(syncedSceneAct?.backgroundImageSrc, '/generated/scene/act-1-latest.png');
+  assert.equal(syncedSceneAct?.backgroundAssetId, 'scene-asset-latest');
+});
+
 test('phase4 generate_characters appends story npcs and updates work summary counts', async () => {
   const runtimeRepository = createRuntimeRepositoryStub();
   const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
diff --git a/server-node/src/services/customWorldAgentSessionStore.ts b/server-node/src/services/customWorldAgentSessionStore.ts
index 3ae5c140..8ec5f599 100644
--- a/server-node/src/services/customWorldAgentSessionStore.ts
+++ b/server-node/src/services/customWorldAgentSessionStore.ts
@@ -368,10 +368,15 @@ function buildCompatibleSuggestedActions(params: {
   record: CustomWorldAgentSessionRecord;
   stage: CustomWorldAgentStage;
   readiness: CreatorIntentReadiness;
-  draftProfile: Record<string, unknown>;
 }) {
   if (params.record.suggestedActions.length > 0) {
-    return params.record.suggestedActions;
+    // 旧快照里可能带有“精修对象”的 Agent 建议动作；当前 Agent 对话框只服务八锚点收集。
+    const compatibleActions = params.record.suggestedActions.filter(
+      (action) => action.type !== 'refine_focus_target',
+    );
+    if (compatibleActions.length > 0) {
+      return compatibleActions;
+    }
   }
 
   const actions: CustomWorldSuggestedAction[] = [
@@ -384,16 +389,6 @@ function buildCompatibleSuggestedActions(params: {
           : '总结当前设定',
     },
   ];
-  const playableNpcs = Array.isArray(params.draftProfile.playableNpcs)
-    ? params.draftProfile.playableNpcs
-    : [];
-  const storyNpcs = Array.isArray(params.draftProfile.storyNpcs)
-    ? params.draftProfile.storyNpcs
-    : [];
-  const landmarks = Array.isArray(params.draftProfile.landmarks)
-    ? params.draftProfile.landmarks
-    : [];
-
   if (params.stage === 'foundation_review' && params.readiness.isReady) {
     actions.push({
       id: 'draft_foundation',
@@ -403,36 +398,6 @@ function buildCompatibleSuggestedActions(params: {
     return actions;
   }
 
-  if (params.stage === 'object_refining' || params.stage === 'visual_refining') {
-    const firstCharacter = toRecord([...playableNpcs, ...storyNpcs][0]);
-    const firstLandmark = toRecord(landmarks[0]);
-
-    actions.push({
-      id: 'refine_world',
-      type: 'refine_focus_target',
-      label: '先看世界总卡',
-      targetId: 'world-foundation',
-    });
-
-    if (firstCharacter) {
-      actions.push({
-        id: `refine-character-${toText(firstCharacter.id) || 'seed'}`,
-        type: 'refine_focus_target',
-        label: `精修角色：${toText(firstCharacter.name) || '关键角色'}`,
-        targetId: toText(firstCharacter.id) || null,
-      });
-    }
-
-    if (firstLandmark) {
-      actions.push({
-        id: `refine-landmark-${toText(firstLandmark.id) || 'seed'}`,
-        type: 'refine_focus_target',
-        label: `继续补地点：${toText(firstLandmark.name) || '关键地点'}`,
-        targetId: toText(firstLandmark.id) || null,
-      });
-    }
-  }
-
   return actions;
 }
 
@@ -533,7 +498,6 @@ function applyCompatibility(record: CustomWorldAgentSessionRecord) {
       record,
       stage,
       readiness: creatorIntentReadiness,
-      draftProfile,
     }),
     assetCoverage: buildCompatibleAssetCoverage(record, draftProfile),
     recommendedReplies: normalizeRecommendedReplies(
diff --git a/server-node/src/services/customWorldWorkSummaryService.ts b/server-node/src/services/customWorldWorkSummaryService.ts
index a77454d5..9111b4b9 100644
--- a/server-node/src/services/customWorldWorkSummaryService.ts
+++ b/server-node/src/services/customWorldWorkSummaryService.ts
@@ -55,7 +55,7 @@ function formatDraftStageLabel(stage: CustomWorldAgentStage) {
   if (stage === 'collecting_intent') return '收集世界锚点';
   if (stage === 'clarifying') return '补齐关键锚点';
   if (stage === 'foundation_review') return '准备整理底稿';
-  if (stage === 'object_refining') return '精修对象';
+  if (stage === 'object_refining') return '待完善草稿';
   if (stage === 'visual_refining') return '视觉工坊';
   if (stage === 'long_tail_review') return '扩展长尾';
   if (stage === 'ready_to_publish') return '准备发布';
diff --git a/src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx b/src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx
index 8d0d0db7..01bf7097 100644
--- a/src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx
+++ b/src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx
@@ -17,7 +17,7 @@ const baseDraftItem: CustomWorldWorkSummary = {
   updatedAt: new Date('2026-04-14T10:00:00.000Z').toISOString(),
   publishedAt: null,
   stage: 'object_refining',
-  stageLabel: '精修对象',
+  stageLabel: '待完善草稿',
   playableNpcCount: 3,
   landmarkCount: 4,
   sessionId: 'session-1',
@@ -35,7 +35,7 @@ test('creation hub reflects updated draft title summary and counts after rerende
       onBack={() => {}}
       onRetry={() => {}}
       onCreateNew={() => {}}
-      onResumeDraft={() => {}}
+      onOpenDraft={() => {}}
       onEnterPublished={() => {}}
     />,
   );
@@ -62,7 +62,7 @@ test('creation hub reflects updated draft title summary and counts after rerende
       onBack={() => {}}
       onRetry={() => {}}
       onCreateNew={() => {}}
-      onResumeDraft={() => {}}
+      onOpenDraft={() => {}}
       onEnterPublished={() => {}}
     />,
   );
diff --git a/src/components/custom-world-home/CustomWorldCreationHub.test.tsx b/src/components/custom-world-home/CustomWorldCreationHub.test.tsx
index 5e822639..2eae91fc 100644
--- a/src/components/custom-world-home/CustomWorldCreationHub.test.tsx
+++ b/src/components/custom-world-home/CustomWorldCreationHub.test.tsx
@@ -33,7 +33,7 @@ test('creation hub draft card renders compiled work summary fields', () => {
       onBack={() => {}}
       onRetry={() => {}}
       onCreateNew={() => {}}
-      onResumeDraft={() => {}}
+      onOpenDraft={() => {}}
       onEnterPublished={() => {}}
     />,
   );
diff --git a/src/components/custom-world-home/CustomWorldCreationHub.tsx b/src/components/custom-world-home/CustomWorldCreationHub.tsx
index eaae45e5..156e1810 100644
--- a/src/components/custom-world-home/CustomWorldCreationHub.tsx
+++ b/src/components/custom-world-home/CustomWorldCreationHub.tsx
@@ -15,7 +15,7 @@ type CustomWorldCreationHubProps = {
   onBack: () => void;
   onRetry: () => void;
   onCreateNew: () => void;
-  onResumeDraft: (sessionId: string) => void;
+  onOpenDraft: (item: CustomWorldWorkSummary) => void;
   onEnterPublished: (profileId: string) => void;
 };
 
@@ -36,7 +36,7 @@ export function CustomWorldCreationHub({
   onBack,
   onRetry,
   onCreateNew,
-  onResumeDraft,
+  onOpenDraft,
   onEnterPublished,
 }: CustomWorldCreationHubProps) {
   const [activeFilter, setActiveFilter] =
@@ -129,7 +129,7 @@ export function CustomWorldCreationHub({
                 item={item}
                 onClick={() => {
                   if (item.sourceType === 'agent_session' && item.sessionId) {
-                    onResumeDraft(item.sessionId);
+                    onOpenDraft(item);
                     return;
                   }
 
diff --git a/src/components/custom-world-home/CustomWorldWorkCard.tsx b/src/components/custom-world-home/CustomWorldWorkCard.tsx
index 42294958..6f67d7b7 100644
--- a/src/components/custom-world-home/CustomWorldWorkCard.tsx
+++ b/src/components/custom-world-home/CustomWorldWorkCard.tsx
@@ -27,6 +27,11 @@ export function CustomWorldWorkCard({
   const isDraft = item.status === 'draft';
   const hasFoundationDraft =
     item.playableNpcCount > 0 || item.landmarkCount > 0;
+  const actionLabel = isDraft
+    ? hasFoundationDraft
+      ? '继续完善'
+      : '继续创作'
+    : '进入世界';
   const roleCountLabel = isDraft ? '角色' : '可扮演角色';
 
   return (
@@ -104,7 +109,7 @@ export function CustomWorldWorkCard({
             onClick={onClick}
             className="platform-button platform-button--primary min-h-0 shrink-0 rounded-full px-4 py-2 text-sm"
           >
-            {isDraft ? (hasFoundationDraft ? '继续精修' : '继续创作') : '进入世界'}
+            {actionLabel}
           </button>
         </div>
       </div>
diff --git a/src/components/game-shell/PlatformHomeView.tsx b/src/components/game-shell/PlatformHomeView.tsx
index 6fc20457..2c1fee68 100644
--- a/src/components/game-shell/PlatformHomeView.tsx
+++ b/src/components/game-shell/PlatformHomeView.tsx
@@ -30,13 +30,13 @@ import {
 import type {
   CustomWorldGalleryCard,
   CustomWorldLibraryEntry,
+  PlatformBrowseHistoryEntry,
   ProfileDashboardCardKey,
   ProfileDashboardSummary,
   ProfileSaveArchiveSummary,
 } from '../../../packages/shared/src/contracts/runtime';
 import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
 import type { AuthUser } from '../../services/authService';
-import type { PlatformBrowseHistoryEntry } from '../../services/platformBrowseHistory';
 import type { CustomWorldProfile } from '../../types';
 import { useAuthUi } from '../auth/AuthUiContext';
 import { PlatformBrandLogo } from './PlatformBrandLogo';
diff --git a/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx b/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx
index 19ee8402..7416cca6 100644
--- a/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx
+++ b/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx
@@ -223,6 +223,97 @@ const mockAuthUser: AuthUser = {
   wechatBound: false,
 };
 
+const compiledAgentDraftSession: CustomWorldAgentSessionSnapshot = {
+  ...mockSession,
+  stage: 'object_refining',
+  creatorIntent: {
+    sourceMode: 'card',
+    worldHook: '被海雾吞没的旧航路群岛',
+    playerPremise: '玩家回到群岛调查沉船真相。',
+    themeKeywords: ['海雾', '旧航路'],
+    toneDirectives: ['压抑', '悬疑'],
+    openingSituation: '首夜就有陌生船只闯入禁航区。',
+    coreConflicts: ['航运公会与守灯会争夺航路控制权'],
+    keyFactions: [],
+    keyCharacters: [],
+    keyLandmarks: [],
+    iconicElements: ['会移动的海雾'],
+    forbiddenDirectives: [],
+    rawSettingText: '',
+  },
+  draftProfile: {
+    name: '潮雾列岛',
+    subtitle: '旧灯塔与失控航路',
+    summary: '第一版世界底稿已经整理完成。',
+    tone: '压抑、潮湿、悬疑',
+    playerGoal: '查清沉船与禁航区异动的真相。',
+    majorFactions: ['守灯会', '航运公会'],
+    coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+    playableNpcs: [
+      {
+        id: 'playable-1',
+        name: '沈砺',
+        title: '旧航路引路人',
+        role: '关键同行者',
+        publicIdentity: '最熟悉旧航路的人。',
+        publicMask: '看上去像可靠旧友。',
+        currentPressure: '他必须在两股势力间站队。',
+        hiddenHook: '暗中替沉船商盟引路。',
+        relationToPlayer: '旧友兼潜在背叛者',
+        threadIds: ['thread-1'],
+        summary: '他像旧友，但也像一把始终没收回鞘的刀。',
+      },
+    ],
+    storyNpcs: [
+      {
+        id: 'story-1',
+        name: '顾潮音',
+        title: '守灯会值夜人',
+        role: '场景关键角色',
+        publicIdentity: '负责夜间巡灯与封锁。',
+        publicMask: '对外一直冷静克制。',
+        currentPressure: '她知道更多禁航区真相。',
+        hiddenHook: '曾亲眼见过失控海雾吞船。',
+        relationToPlayer: '最早愿意交换线索的人',
+        threadIds: ['thread-1'],
+        summary: '她总像比所有人更早知道海雾会往哪一侧压下来。',
+      },
+    ],
+    landmarks: [
+      {
+        id: 'landmark-1',
+        name: '回潮旧灯塔',
+        purpose: '观察雾潮与往来船只',
+        mood: '潮湿、压抑、风声不止',
+        importance: '开局核心场景',
+        characterIds: ['story-1'],
+        threadIds: ['thread-1'],
+        summary: '旧灯塔是整片群岛最先看见异动的地方。',
+      },
+    ],
+    factions: [],
+    threads: [],
+    chapters: [],
+    worldHook: '被海雾吞没的旧航路群岛',
+    playerPremise: '玩家回到群岛调查沉船真相。',
+    openingSituation: '首夜就有陌生船只闯入禁航区。',
+    iconicElements: ['会移动的海雾'],
+    sourceAnchorSummary: '海雾、旧灯塔、失控航路。',
+  },
+  draftCards: [
+    {
+      id: 'world-foundation',
+      kind: 'world',
+      title: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '第一版世界底稿已经整理完成。',
+      status: 'warning',
+      linkedIds: ['playable-1', 'story-1', 'landmark-1'],
+      warningCount: 0,
+    },
+  ],
+};
+
 type TestAuthValue = {
   user: AuthUser | null;
   openLoginModal: (postLoginAction?: (() => void) | null) => void;
@@ -416,7 +507,7 @@ test('create tab opens game type modal, keeps AIRP and visual novel locked, and
   ).toBeTruthy();
 });
 
-test('create tab uses unified creation hub and can resume an agent draft', async () => {
+test('create tab opens compiled agent draft in result refinement page', async () => {
   const user = userEvent.setup();
 
   vi.mocked(listCustomWorldWorks).mockResolvedValue([
@@ -425,7 +516,7 @@ test('create tab uses unified creation hub and can resume an agent draft', async
       sourceType: 'agent_session',
       status: 'draft',
       title: '潮雾列岛',
-      subtitle: '精修对象',
+      subtitle: '待完善草稿',
       summary: '玩家是失职返乡的守灯人。',
       coverImageSrc: null,
       coverRenderMode: 'image',
@@ -433,7 +524,7 @@ test('create tab uses unified creation hub and can resume an agent draft', async
       updatedAt: '2026-04-20T10:00:00.000Z',
       publishedAt: null,
       stage: 'object_refining',
-      stageLabel: '精修对象',
+      stageLabel: '待完善草稿',
       playableNpcCount: 3,
       landmarkCount: 4,
       roleVisualReadyCount: 1,
@@ -445,21 +536,70 @@ test('create tab uses unified creation hub and can resume an agent draft', async
       canEnterWorld: false,
     },
   ]);
+  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(
+    compiledAgentDraftSession,
+  );
 
   render(<TestWrapper withAuth />);
 
   await openCreationHub(user);
 
-  expect(
-    screen.getByRole('button', { name: /继续精修/u }),
-  ).toBeTruthy();
-  expect(screen.getByRole('button', { name: /继续精修/u })).toBeTruthy();
+  expect(screen.getByRole('button', { name: /继续完善/u })).toBeTruthy();
 
-  await user.click(screen.getByRole('button', { name: /继续精修/u }));
+  await user.click(screen.getByRole('button', { name: /继续完善/u }));
+
+  await waitFor(
+    async () => {
+      expect(await screen.findByText('世界档案')).toBeTruthy();
+      expect(screen.queryByText('Agent工作区：custom-world-agent-session-1')).toBeNull();
+      expect(screen.getByRole('button', { name: /返回创作/u })).toBeTruthy();
+    },
+    { timeout: 2500 },
+  );
+});
+
+test('create tab resumes agent workspace when draft has no compiled result yet', async () => {
+  const user = userEvent.setup();
+
+  vi.mocked(listCustomWorldWorks).mockResolvedValue([
+    {
+      workId: 'draft:custom-world-agent-session-1',
+      sourceType: 'agent_session',
+      status: 'draft',
+      title: '潮雾列岛',
+      subtitle: '补齐关键锚点',
+      summary: '玩家是失职返乡的守灯人。',
+      coverImageSrc: null,
+      coverRenderMode: 'image',
+      coverCharacterImageSrcs: [],
+      updatedAt: '2026-04-20T10:00:00.000Z',
+      publishedAt: null,
+      stage: 'clarifying',
+      stageLabel: '补齐关键锚点',
+      playableNpcCount: 0,
+      landmarkCount: 0,
+      roleVisualReadyCount: 0,
+      roleAnimationReadyCount: 0,
+      roleAssetSummaryLabel: null,
+      sessionId: 'custom-world-agent-session-1',
+      profileId: null,
+      canResume: true,
+      canEnterWorld: false,
+    },
+  ]);
+
+  render(<TestWrapper withAuth />);
+
+  await openCreationHub(user);
+
+  expect(screen.getByRole('button', { name: /继续创作/u })).toBeTruthy();
+
+  await user.click(screen.getByRole('button', { name: /继续创作/u }));
 
   expect(
     await screen.findByText('Agent工作区：custom-world-agent-session-1'),
   ).toBeTruthy();
+  expect(screen.queryByText('世界档案')).toBeNull();
 });
 
 test('clicking a public work while logged out routes through requireAuth', async () => {
@@ -581,7 +721,7 @@ test('starting draft generation leaves the agent workspace and shows the generat
   expect(screen.queryByText('先告诉我你想做一个怎样的 RPG 世界。')).toBeNull();
 });
 
-test('existing draft sessions enter the agent preview layout without opening legacy editor', async () => {
+test('existing draft sessions open result page refinement instead of agent dialog', async () => {
   const user = userEvent.setup();
 
   vi.mocked(getCustomWorldAgentOperation).mockResolvedValue({
@@ -593,96 +733,9 @@ test('existing draft sessions enter the agent preview layout without opening leg
     progress: 100,
     error: null,
   });
-  vi.mocked(getCustomWorldAgentSession).mockResolvedValue({
-    ...mockSession,
-    stage: 'object_refining',
-    creatorIntent: {
-      sourceMode: 'card',
-      worldHook: '被海雾吞没的旧航路群岛',
-      playerPremise: '玩家回到群岛调查沉船真相。',
-      themeKeywords: ['海雾', '旧航路'],
-      toneDirectives: ['压抑', '悬疑'],
-      openingSituation: '首夜就有陌生船只闯入禁航区。',
-      coreConflicts: ['航运公会与守灯会争夺航路控制权'],
-      keyFactions: [],
-      keyCharacters: [],
-      keyLandmarks: [],
-      iconicElements: ['会移动的海雾'],
-      forbiddenDirectives: [],
-      rawSettingText: '',
-    },
-    draftProfile: {
-      name: '潮雾列岛',
-      subtitle: '旧灯塔与失控航路',
-      summary: '第一版世界底稿已经整理完成。',
-      tone: '压抑、潮湿、悬疑',
-      playerGoal: '查清沉船与禁航区异动的真相。',
-      majorFactions: ['守灯会', '航运公会'],
-      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
-      playableNpcs: [
-        {
-          id: 'playable-1',
-          name: '沈砺',
-          title: '旧航路引路人',
-          role: '关键同行者',
-          publicIdentity: '最熟悉旧航路的人。',
-          publicMask: '看上去像可靠旧友。',
-          currentPressure: '他必须在两股势力间站队。',
-          hiddenHook: '暗中替沉船商盟引路。',
-          relationToPlayer: '旧友兼潜在背叛者',
-          threadIds: ['thread-1'],
-          summary: '他像旧友，但也像一把始终没收回鞘的刀。',
-        },
-      ],
-      storyNpcs: [
-        {
-          id: 'story-1',
-          name: '顾潮音',
-          title: '守灯会值夜人',
-          role: '场景关键角色',
-          publicIdentity: '负责夜间巡灯与封锁。',
-          publicMask: '对外一直冷静克制。',
-          currentPressure: '她知道更多禁航区真相。',
-          hiddenHook: '曾亲眼见过失控海雾吞船。',
-          relationToPlayer: '最早愿意交换线索的人',
-          threadIds: ['thread-1'],
-          summary: '她总像比所有人更早知道海雾会往哪一侧压下来。',
-        },
-      ],
-      landmarks: [
-        {
-          id: 'landmark-1',
-          name: '回潮旧灯塔',
-          purpose: '观察雾潮与往来船只',
-          mood: '潮湿、压抑、风声不止',
-          importance: '开局核心场景',
-          characterIds: ['story-1'],
-          threadIds: ['thread-1'],
-          summary: '旧灯塔是整片群岛最先看见异动的地方。',
-        },
-      ],
-      factions: [],
-      threads: [],
-      chapters: [],
-      worldHook: '被海雾吞没的旧航路群岛',
-      playerPremise: '玩家回到群岛调查沉船真相。',
-      openingSituation: '首夜就有陌生船只闯入禁航区。',
-      iconicElements: ['会移动的海雾'],
-      sourceAnchorSummary: '海雾、旧灯塔、失控航路。',
-    },
-    draftCards: [
-      {
-        id: 'world-foundation',
-        kind: 'world',
-        title: '潮雾列岛',
-        subtitle: '旧灯塔与失控航路',
-        summary: '第一版世界底稿已经整理完成。',
-        status: 'warning',
-        linkedIds: ['playable-1', 'story-1', 'landmark-1'],
-        warningCount: 0,
-      },
-    ],
-  });
+  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(
+    compiledAgentDraftSession,
+  );
 
   render(<TestWrapper withAuth />);
 
@@ -704,12 +757,12 @@ test('existing draft sessions enter the agent preview layout without opening leg
 
   await user.click(screen.getByRole('button', { name: /场景角色/u }));
   expect(screen.getByRole('button', { name: /顾潮音/u })).toBeTruthy();
-  expect(screen.queryByText(/编辑场景角色：顾潮音/u)).toBeNull();
-  expect(screen.queryByRole('button', { name: /AI生成/u })).toBeNull();
-  expect(screen.queryByText('技能')).toBeNull();
+  await user.click(screen.getByRole('button', { name: /顾潮音/u }));
+  expect(await screen.findByText(/编辑场景角色：顾潮音/u)).toBeTruthy();
+  expect(screen.getByRole('button', { name: /AI生成/u })).toBeTruthy();
 });
 
-test('agent draft result back button returns to workspace without redundant sync when session is already latest', async () => {
+test('agent draft result back button returns to creation hub without redundant sync when session is already latest', async () => {
   const user = userEvent.setup();
 
   vi.mocked(executeCustomWorldAgentAction).mockResolvedValue({
@@ -843,7 +896,7 @@ test('agent draft result back button returns to workspace without redundant sync
   } satisfies CustomWorldAgentSessionSnapshot;
   vi.mocked(getCustomWorldAgentSession).mockResolvedValue(resultSession);
 
-  render(<TestWrapper />);
+  render(<TestWrapper withAuth />);
 
   await openNewRpgCreation(user);
 
@@ -858,9 +911,7 @@ test('agent draft result back button returns to workspace without redundant sync
   await user.click(screen.getByRole('button', { name: /返回创作/u }));
 
   await waitFor(() => {
-    expect(
-      screen.getByText('Agent工作区：custom-world-agent-session-1'),
-    ).toBeTruthy();
+    expect(screen.getByText('创作中心')).toBeTruthy();
   });
 
   expect(
@@ -968,7 +1019,7 @@ test('agent draft result auto-save persists the latest profile rebuilt from sync
   } satisfies CustomWorldAgentSessionSnapshot;
   vi.mocked(getCustomWorldAgentSession).mockResolvedValue(syncedSession);
 
-  render(<TestWrapper />);
+  render(<TestWrapper withAuth />);
 
   await openNewRpgCreation(user);
 
diff --git a/src/components/game-shell/PreGameSelectionFlow.tsx b/src/components/game-shell/PreGameSelectionFlow.tsx
index ebd227d3..2357d18a 100644
--- a/src/components/game-shell/PreGameSelectionFlow.tsx
+++ b/src/components/game-shell/PreGameSelectionFlow.tsx
@@ -20,6 +20,8 @@ import type {
 import type {
   CustomWorldGalleryCard,
   CustomWorldLibraryEntry,
+  PlatformBrowseHistoryEntry,
+  PlatformBrowseHistoryWriteEntry,
   ProfileDashboardSummary,
   ProfileSaveArchiveSummary,
 } from '../../../packages/shared/src/contracts/runtime';
@@ -46,14 +48,6 @@ import {
   writeCustomWorldAgentUiState,
 } from '../../services/customWorldAgentUiState';
 import { buildCustomWorldCreatorIntentFoundationText } from '../../services/customWorldCreatorIntent';
-import {
-  hasPendingPlatformBrowseHistoryMigration,
-  markPlatformBrowseHistoryMigrated,
-  type PlatformBrowseHistoryEntry,
-  type PlatformBrowseHistoryWriteEntry,
-  readPlatformBrowseHistory,
-  writePlatformBrowseHistory,
-} from '../../services/platformBrowseHistory';
 import {
   deleteCustomWorldProfile,
   getCustomWorldGalleryDetail,
@@ -64,7 +58,6 @@ import {
   listProfileSaveArchives,
   publishCustomWorldProfile,
   resumeProfileSaveArchive,
-  syncProfileBrowseHistory,
   unpublishCustomWorldProfile,
   upsertCustomWorldProfile,
   upsertProfileBrowseHistory,
@@ -381,18 +374,11 @@ export function PreGameSelectionFlow({
 
   const appendBrowseHistoryEntry = useCallback(
     async (entry: PlatformBrowseHistoryWriteEntry) => {
-      const nextEntries = writePlatformBrowseHistory(authUi?.user, entry);
-      setHistoryEntries(nextEntries);
       setHistoryError(null);
 
-      if (!authUi?.user) {
-        return;
-      }
-
       try {
         const syncedEntries = await upsertProfileBrowseHistory(entry);
         setHistoryEntries(syncedEntries);
-        markPlatformBrowseHistoryMigrated(authUi?.user);
       } catch (error) {
         setHistoryError(resolveErrorMessage(error, '写入浏览历史失败。'));
       }
@@ -444,8 +430,7 @@ export function PreGameSelectionFlow({
     let isActive = true;
 
     void (async () => {
-      const localHistoryEntries = readPlatformBrowseHistory(authUi?.user);
-      setHistoryEntries(localHistoryEntries);
+      setHistoryEntries([]);
       setHistoryError(null);
       setSaveError(null);
       setIsLoadingPlatform(true);
@@ -472,22 +457,7 @@ export function PreGameSelectionFlow({
           isAuthenticated ? listCustomWorldWorks() : Promise.resolve([]),
           listCustomWorldGallery(),
           isAuthenticated ? getProfileDashboard() : Promise.resolve(null),
-          isAuthenticated
-            ? (async () => {
-                let nextEntries = await listProfileBrowseHistory();
-
-                if (
-                  hasPendingPlatformBrowseHistoryMigration(authUi?.user) &&
-                  localHistoryEntries.length > 0
-                ) {
-                  nextEntries =
-                    await syncProfileBrowseHistory(localHistoryEntries);
-                  markPlatformBrowseHistoryMigrated(authUi?.user);
-                }
-
-                return nextEntries;
-              })()
-            : Promise.resolve(localHistoryEntries),
+          isAuthenticated ? listProfileBrowseHistory() : Promise.resolve([]),
           isAuthenticated ? listProfileSaveArchives() : Promise.resolve([]),
         ]);
         if (!isActive) {
@@ -881,8 +851,6 @@ export function PreGameSelectionFlow({
   const isAgentDraftGenerationView =
     customWorldGenerationViewSource === 'agent-draft-foundation';
   const isAgentDraftResultView = customWorldResultViewSource === 'agent-draft';
-  const isAgentDraftResultEditingFrozen =
-    customWorldResultViewSource === 'agent-draft';
   const activeGenerationSettingText = agentDraftSettingPreview;
   const activeGenerationProgress = agentDraftGenerationProgress;
   const isActiveGenerationRunning =
@@ -1096,7 +1064,8 @@ export function PreGameSelectionFlow({
     setCustomWorldAutoSaveState('idle');
     setCustomWorldGenerationViewSource(null);
     setCustomWorldResultViewSource(null);
-    setSelectionStage('agent-workspace');
+    setPlatformTab('create');
+    setSelectionStage('platform');
   };
 
   const retryAgentDraftGeneration = () => {
@@ -1133,17 +1102,39 @@ export function PreGameSelectionFlow({
   const handleOpenCreationWork = useCallback(
     async (work: CustomWorldWorkSummary) => {
       if (work.status === 'draft' && work.sessionId) {
-        // 阶段二要求草稿优先回到 Agent 工作区，而不是再次自动顶回结果页。
-        isAgentDraftResultAutoOpenSuppressedRef.current = true;
         persistAgentUiState(work.sessionId, null);
-        setGeneratedCustomWorldProfile(null);
         setCustomWorldError(null);
         setCustomWorldAutoSaveError(null);
         setCustomWorldAutoSaveState('idle');
         setCustomWorldGenerationViewSource(null);
-        setCustomWorldResultViewSource(null);
+
+        const shouldOpenAgentWorkspace =
+          work.playableNpcCount <= 0 && work.landmarkCount <= 0;
+
+        if (shouldOpenAgentWorkspace) {
+          // 仅八锚点未整理成底稿时才恢复 Agent 对话工作区。
+          isAgentDraftResultAutoOpenSuppressedRef.current = true;
+          setGeneratedCustomWorldProfile(null);
+          setCustomWorldResultViewSource(null);
+          setPlatformTab('create');
+          setSelectionStage('agent-workspace');
+          return;
+        }
+
+        isAgentDraftResultAutoOpenSuppressedRef.current = false;
+        const latestSession = await syncAgentSessionSnapshot(work.sessionId);
+        const nextProfile = buildCustomWorldProfileFromAgentDraft(latestSession);
+        if (!nextProfile) {
+          setPlatformError('当前草稿还没有可编辑的结果页数据，请先继续补齐锚点。');
+          setPlatformTab('create');
+          setSelectionStage('agent-workspace');
+          return;
+        }
+
+        setGeneratedCustomWorldProfile(normalizeAgentBackedProfile(nextProfile));
+        setCustomWorldResultViewSource('agent-draft');
         setPlatformTab('create');
-        setSelectionStage('agent-workspace');
+        setSelectionStage('custom-world-result');
         return;
       }
 
@@ -1179,6 +1170,7 @@ export function PreGameSelectionFlow({
       openLibraryDetail,
       persistAgentUiState,
       savedCustomWorldEntries,
+      syncAgentSessionSnapshot,
       setSelectionStage,
     ],
   );
@@ -1583,32 +1575,9 @@ export function PreGameSelectionFlow({
         });
       }}
       onCreateNew={openCreationTypePicker}
-      onResumeDraft={(sessionId) => {
+      onOpenDraft={(item) => {
         runProtectedAction(() => {
-          void handleOpenCreationWork({
-            workId: `draft:${sessionId}`,
-            sourceType: 'agent_session',
-            status: 'draft',
-            title: '',
-            subtitle: '',
-            summary: '',
-            coverImageSrc: null,
-            coverRenderMode: 'image',
-            coverCharacterImageSrcs: [],
-            updatedAt: new Date().toISOString(),
-            publishedAt: null,
-            stage: null,
-            stageLabel: '',
-            playableNpcCount: 0,
-            landmarkCount: 0,
-            roleVisualReadyCount: 0,
-            roleAnimationReadyCount: 0,
-            roleAssetSummaryLabel: null,
-            sessionId,
-            profileId: null,
-            canResume: true,
-            canEnterWorld: false,
-          });
+          void handleOpenCreationWork(item);
         });
       }}
       onEnterPublished={(profileId) => {
@@ -1918,10 +1887,10 @@ export function PreGameSelectionFlow({
                       });
                     });
                   }}
-                  readOnly={isAgentDraftResultEditingFrozen}
+                  readOnly={false}
                   compactAgentResultMode={isAgentDraftResultView}
                   backLabel={isAgentDraftResultView ? '返回创作' : undefined}
-                  editActionLabel="去Agent调整设定"
+                  editActionLabel="继续调整设定"
                   enterWorldActionLabel="进入世界"
                   autoSaveState={customWorldAutoSaveState}
                 />
diff --git a/src/hooks/story/npcEncounterActions.test.ts b/src/hooks/story/npcEncounterActions.test.ts
index 7db5c9aa..6cfb9838 100644
--- a/src/hooks/story/npcEncounterActions.test.ts
+++ b/src/hooks/story/npcEncounterActions.test.ts
@@ -3,11 +3,9 @@ import { beforeEach, describe, expect, it, vi } from 'vitest';
 const {
   resolveServerRuntimeChoiceMock,
   streamNpcChatTurnMock,
-  generateQuestForNpcEncounterMock,
 } = vi.hoisted(() => ({
   resolveServerRuntimeChoiceMock: vi.fn(),
   streamNpcChatTurnMock: vi.fn(),
-  generateQuestForNpcEncounterMock: vi.fn(),
 }));
 
 vi.mock('./runtimeStoryCoordinator', () => ({
@@ -18,10 +16,6 @@ vi.mock('../../services/aiService', () => ({
   streamNpcChatTurn: streamNpcChatTurnMock,
 }));
 
-vi.mock('../../services/questDirector', () => ({
-  generateQuestForNpcEncounter: generateQuestForNpcEncounterMock,
-}));
-
 import {
   AnimationState,
   type Character,
@@ -593,7 +587,6 @@ describe('npcEncounterActions', () => {
   beforeEach(() => {
     resolveServerRuntimeChoiceMock.mockReset();
     streamNpcChatTurnMock.mockReset();
-    generateQuestForNpcEncounterMock.mockReset();
   });
 
   it.each([
@@ -1371,8 +1364,6 @@ describe('npcEncounterActions', () => {
         }),
       }),
     );
-    expect(generateQuestForNpcEncounterMock).not.toHaveBeenCalled();
-
     const lastStory = actions.setCurrentStory.mock.calls.at(-1)?.[0] as StoryMoment;
     expect(lastStory.npcChatState?.pendingQuestOffer?.quest).toEqual(pendingQuest);
     expect(lastStory.npcAffinityEffect).toEqual({
@@ -1393,18 +1384,38 @@ describe('npcEncounterActions', () => {
     );
   });
 
-  it('replaces a pending quest offer by reusing the existing quest generator', async () => {
+  it('replaces a pending quest offer through the server runtime resolver', async () => {
     const currentQuest = createQuest('quest-bridge-offer', '断桥口的密信');
     const nextQuest = createQuest('quest-bridge-replaced', '断桥夜巡');
-    generateQuestForNpcEncounterMock.mockResolvedValueOnce(nextQuest);
+    resolveServerRuntimeChoiceMock.mockResolvedValueOnce({
+      hydratedSnapshot: {
+        gameState: createState(),
+      },
+      nextStory: createPendingQuestOfferStory(nextQuest),
+    });
 
     const actions = createNpcEncounterActions({
       currentStory: createPendingQuestOfferStory(currentQuest),
     });
 
-    await expect(actions.replacePendingNpcQuestOffer()).resolves.toBe(true);
+    expect(actions.replacePendingNpcQuestOffer()).toBe(true);
+    await flushAsyncWork();
 
-    expect(generateQuestForNpcEncounterMock).toHaveBeenCalledTimes(1);
+    expect(resolveServerRuntimeChoiceMock).toHaveBeenCalledWith(
+      expect.objectContaining({
+        gameState: actions.gameState,
+        currentStory: actions.currentStory,
+        option: expect.objectContaining({
+          functionId: 'npc_chat_quest_offer_replace',
+          actionText: '你请断桥客换一份更合适的委托。',
+          interaction: {
+            kind: 'npc',
+            npcId: 'npc-rival',
+            action: 'quest_offer_replace',
+          },
+        }),
+      }),
+    );
     const lastStory = actions.setCurrentStory.mock.calls.at(-1)?.[0] as StoryMoment;
     expect(lastStory.npcChatState?.pendingQuestOffer?.quest).toEqual(nextQuest);
     expect(lastStory.options.map((option) => option.actionText)).toEqual([
@@ -1485,14 +1496,78 @@ describe('npcEncounterActions', () => {
     );
   });
 
-  it('abandons a pending quest offer and returns to free npc chat', () => {
+  it('abandons a pending quest offer through the server runtime resolver', async () => {
     const pendingQuest = createQuest('quest-bridge-offer', '断桥口的密信');
+    resolveServerRuntimeChoiceMock.mockResolvedValueOnce({
+      hydratedSnapshot: {
+        gameState: createState(),
+      },
+      nextStory: {
+        ...createPendingQuestOfferStory(pendingQuest),
+        options: [
+          createOption('npc_chat', '那先继续聊聊你刚才没说完的部分', {
+            kind: 'npc',
+            npcId: 'npc-rival',
+            action: 'chat',
+          }),
+          createOption('npc_chat', '除了委托，你对眼前局势还有什么判断', {
+            kind: 'npc',
+            npcId: 'npc-rival',
+            action: 'chat',
+          }),
+          createOption('npc_chat', '先把这附近真正危险的地方说清楚', {
+            kind: 'npc',
+            npcId: 'npc-rival',
+            action: 'chat',
+          }),
+        ],
+        dialogue: [
+          {
+            speaker: 'npc',
+            speakerName: '断桥客',
+            text: '这件事我只想托给你。',
+          },
+          {
+            speaker: 'player',
+            text: '这件事我先不接，咱们还是先聊别的。',
+          },
+          {
+            speaker: 'npc',
+            speakerName: '断桥客',
+            text: '那就先聊别的。',
+          },
+        ],
+        npcChatState: {
+          npcId: 'npc-rival',
+          npcName: '断桥客',
+          turnCount: 2,
+          customInputPlaceholder: '输入你想对 TA 说的话',
+          pendingQuestOffer: null,
+        },
+      } satisfies StoryMoment,
+    });
     const actions = createNpcEncounterActions({
       currentStory: createPendingQuestOfferStory(pendingQuest),
     });
 
     expect(actions.abandonPendingNpcQuestOffer()).toBe(true);
+    await flushAsyncWork();
 
+    expect(resolveServerRuntimeChoiceMock).toHaveBeenCalledWith(
+      expect.objectContaining({
+        gameState: actions.gameState,
+        currentStory: actions.currentStory,
+        option: expect.objectContaining({
+          functionId: 'npc_chat_quest_offer_abandon',
+          actionText: '你暂时没有接下断桥客提出的委托。',
+          interaction: {
+            kind: 'npc',
+            npcId: 'npc-rival',
+            action: 'quest_offer_abandon',
+          },
+        }),
+      }),
+    );
     const lastStory = actions.setCurrentStory.mock.calls.at(-1)?.[0] as StoryMoment;
     expect(lastStory.npcChatState?.pendingQuestOffer).toBeNull();
     expect(lastStory.options.map((option) => option.actionText)).toEqual([
diff --git a/src/hooks/story/npcEncounterActions.ts b/src/hooks/story/npcEncounterActions.ts
index 4b5df44a..7cefe20d 100644
--- a/src/hooks/story/npcEncounterActions.ts
+++ b/src/hooks/story/npcEncounterActions.ts
@@ -24,7 +24,6 @@ import type { StoryGenerationContext } from '../../services/aiTypes';
 import {
   resolveLimitedPrimaryNpcChatState,
 } from '../../services/customWorldSceneActRuntime';
-import { generateQuestForNpcEncounter } from '../../services/questDirector';
 import { appendStoryEngineCarrierMemory } from '../../services/storyEngine/echoMemory';
 import { createHistoryMoment } from '../../services/storyHistory';
 import type {
@@ -1558,81 +1557,36 @@ export function createStoryNpcEncounterActions({
     }
   };
 
-  const replacePendingNpcQuestOffer = async () => {
-    const playerCharacter = gameState.playerCharacter;
+  const replacePendingNpcQuestOffer = () => {
     const encounter = gameState.currentEncounter;
     const pendingQuestOffer = isNpcEncounter(encounter)
       ? getPendingQuestOffer(currentStory, encounter)
       : null;
-    if (!playerCharacter || !encounter || !pendingQuestOffer) {
+    if (!encounter || !pendingQuestOffer) {
       return false;
     }
-
-    const encounterKey = getNpcEncounterKey(encounter);
-    const currentNpcChatState =
-      currentStory?.npcChatState?.npcId === encounterKey
-        ? currentStory.npcChatState
-        : null;
-    const currentDialogue =
-      currentStory?.dialogue && currentNpcChatState
-        ? [...currentStory.dialogue]
-        : [];
-    const turnCount = currentNpcChatState?.turnCount ?? 0;
-    const playerLine = '能不能换一份更适合眼下局势的委托？';
-    const generationState = {
-      ...gameState,
-      storyHistory: appendHistory(
-        gameState,
-        `你请${encounter.npcName}换一份更合适的委托。`,
-        `${encounter.npcName}重新斟酌起该交给你的事。`,
-      ),
-    };
-
-    setAiError(null);
-    setIsLoading(true);
-
-    try {
-      const nextQuest = await generateQuestForNpcEncounter({
-        state: generationState,
-        encounter,
-      });
-      if (!nextQuest) {
-        setAiError('当前没有更合适的委托可供更换。');
-        return false;
-      }
-
-      setGameState(generationState);
-      setCurrentStory(
-        buildNpcChatStoryMoment({
-          encounter,
-          dialogue: [
-            ...currentDialogue,
-            {
-              speaker: 'player',
-              text: playerLine,
-            },
-            {
-              speaker: 'npc',
-              speakerName: encounter.npcName,
-              text: buildQuestOfferDialogueText(encounter, nextQuest),
-            },
-          ],
-          options: buildPendingQuestOfferOptions(encounter),
-          streaming: false,
-          turnCount,
-          pendingQuestOffer: {
-            quest: nextQuest,
-          },
-        }),
-      );
-      return true;
-    } catch (error) {
-      console.error('Failed to replace pending npc quest offer:', error);
-      setAiError(error instanceof Error ? error.message : '更换任务失败');
-      return false;
-    } finally {
-      setIsLoading(false);
-    }
+    void resolveServerNpcStoryAction({
+      option: {
+        functionId: 'npc_chat_quest_offer_replace',
+        actionText: `你请${encounter.npcName}换一份更合适的委托。`,
+        text: `你请${encounter.npcName}换一份更合适的委托。`,
+        detailText: '',
+        visuals: {
+          playerAnimation: AnimationState.IDLE,
+          playerMoveMeters: 0,
+          playerOffsetY: 0,
+          playerFacing: 'right',
+          scrollWorld: false,
+          monsterChanges: [],
+        },
+        interaction: {
+          kind: 'npc',
+          npcId: encounter.id ?? encounter.npcName,
+          action: 'quest_offer_replace',
+        },
+      },
+    });
+    return true;
   };
 
   const abandonPendingNpcQuestOffer = () => {
@@ -1643,49 +1597,27 @@ export function createStoryNpcEncounterActions({
     if (!encounter || !pendingQuestOffer) {
       return false;
     }
-
-    const encounterKey = getNpcEncounterKey(encounter);
-    const currentNpcChatState =
-      currentStory?.npcChatState?.npcId === encounterKey
-        ? currentStory.npcChatState
-        : null;
-    const currentDialogue =
-      currentStory?.dialogue && currentNpcChatState
-        ? [...currentStory.dialogue]
-        : [];
-    const turnCount = currentNpcChatState?.turnCount ?? 0;
-    const playerLine = '这件事我先不接，咱们还是先聊别的。';
-    const npcReply = `${encounter.npcName}点了点头，没有继续强求，只把这份委托暂时收了回去。`;
-    const nextState = {
-      ...gameState,
-      storyHistory: appendHistory(
-        gameState,
-        `你暂时没有接下${encounter.npcName}提出的委托。`,
-        npcReply,
-      ),
-    };
-
-    setGameState(nextState);
-    setCurrentStory(
-      buildNpcChatStoryMoment({
-        encounter,
-        dialogue: [
-          ...currentDialogue,
-          {
-            speaker: 'player',
-            text: playerLine,
-          },
-          {
-            speaker: 'npc',
-            speakerName: encounter.npcName,
-            text: npcReply,
-          },
-        ],
-        options: buildPostQuestOfferChatSuggestions(encounter),
-        streaming: false,
-        turnCount,
-      }),
-    );
+    void resolveServerNpcStoryAction({
+      option: {
+        functionId: 'npc_chat_quest_offer_abandon',
+        actionText: `你暂时没有接下${encounter.npcName}提出的委托。`,
+        text: `你暂时没有接下${encounter.npcName}提出的委托。`,
+        detailText: '',
+        visuals: {
+          playerAnimation: AnimationState.IDLE,
+          playerMoveMeters: 0,
+          playerOffsetY: 0,
+          playerFacing: 'right',
+          scrollWorld: false,
+          monsterChanges: [],
+        },
+        interaction: {
+          kind: 'npc',
+          npcId: encounter.id ?? encounter.npcName,
+          action: 'quest_offer_abandon',
+        },
+      },
+    });
     return true;
   };
 
diff --git a/src/hooks/story/runtimeStoryCoordinator.test.ts b/src/hooks/story/runtimeStoryCoordinator.test.ts
index 6cb43945..57d79332 100644
--- a/src/hooks/story/runtimeStoryCoordinator.test.ts
+++ b/src/hooks/story/runtimeStoryCoordinator.test.ts
@@ -1,23 +1,17 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 const {
-  putSaveSnapshotMock,
   getRuntimeStoryStateMock,
   resolveRuntimeStoryActionMock,
   getRuntimeSessionIdMock,
   getRuntimeClientVersionMock,
 } = vi.hoisted(() => ({
-  putSaveSnapshotMock: vi.fn(),
   getRuntimeStoryStateMock: vi.fn(),
   resolveRuntimeStoryActionMock: vi.fn(),
   getRuntimeSessionIdMock: vi.fn(() => 'runtime-main'),
   getRuntimeClientVersionMock: vi.fn(() => 0),
 }));
 
-vi.mock('../../services/storageService', () => ({
-  putSaveSnapshot: putSaveSnapshotMock,
-}));
-
 vi.mock('../../services/runtimeStoryService', async () => {
   const actual =
     await vi.importActual<typeof import('../../services/runtimeStoryService')>(
@@ -149,7 +143,6 @@ function createRuntimeNpcBattleSnapshot(
 
 describe('runtimeStoryCoordinator', () => {
   beforeEach(() => {
-    putSaveSnapshotMock.mockReset();
     getRuntimeStoryStateMock.mockReset();
     resolveRuntimeStoryActionMock.mockReset();
     getRuntimeSessionIdMock.mockReset();
@@ -209,12 +202,15 @@ describe('runtimeStoryCoordinator', () => {
       currentStory,
     });
 
-    expect(putSaveSnapshotMock).toHaveBeenCalledWith({
-      gameState,
-      bottomTab: 'adventure',
-      currentStory,
+    expect(getRuntimeStoryStateMock).toHaveBeenCalledWith({
+      sessionId: 'runtime-main',
+      clientVersion: 7,
+      snapshot: {
+        gameState,
+        bottomTab: 'adventure',
+        currentStory,
+      },
     });
-    expect(getRuntimeStoryStateMock).toHaveBeenCalledWith('runtime-main');
     expect(options).toEqual([
       expect.objectContaining({
         functionId: 'npc_chat',
@@ -306,11 +302,6 @@ describe('runtimeStoryCoordinator', () => {
       },
     });
 
-    expect(putSaveSnapshotMock).toHaveBeenCalledWith({
-      gameState,
-      bottomTab: 'adventure',
-      currentStory,
-    });
     expect(resolveRuntimeStoryActionMock).toHaveBeenCalledWith({
       sessionId: 'runtime-main',
       clientVersion: 7,
@@ -319,6 +310,11 @@ describe('runtimeStoryCoordinator', () => {
       payload: {
         note: 'server-runtime-test',
       },
+      snapshot: {
+        gameState,
+        bottomTab: 'adventure',
+        currentStory,
+      },
     });
     expect(result.hydratedSnapshot).toBe(hydratedSnapshot);
     expect(result.nextStory).toEqual(
@@ -414,7 +410,9 @@ describe('runtimeStoryCoordinator', () => {
 
     const result = await resumeServerRuntimeStory(localHydratedSnapshot);
 
-    expect(getRuntimeStoryStateMock).toHaveBeenCalledWith('runtime-main');
+    expect(getRuntimeStoryStateMock).toHaveBeenCalledWith({
+      sessionId: 'runtime-main',
+    });
     expect(result.hydratedSnapshot).toBe(serverHydratedSnapshot);
     expect(result.nextStory).toEqual(
       expect.objectContaining({
@@ -614,6 +612,9 @@ describe('runtimeStoryCoordinator', () => {
 
     const result = await resumeServerRuntimeStory(localHydratedSnapshot);
 
+    expect(getRuntimeStoryStateMock).toHaveBeenCalledWith({
+      sessionId: 'runtime-main',
+    });
     expect(result.hydratedSnapshot.gameState.sceneHostileNpcs[0]).toEqual(
       expect.objectContaining({
         id: 'npc-bandit',
diff --git a/src/hooks/story/runtimeStoryCoordinator.ts b/src/hooks/story/runtimeStoryCoordinator.ts
index 09f35ca6..6d9075d8 100644
--- a/src/hooks/story/runtimeStoryCoordinator.ts
+++ b/src/hooks/story/runtimeStoryCoordinator.ts
@@ -5,11 +5,11 @@ import {
   getRuntimeSessionId,
   getRuntimeStoryState,
   resolveRuntimeStoryAction,
+  type RuntimeStorySnapshotRequest,
   resolveRuntimeStoryMoment,
   type RuntimeStoryChoicePayload,
   type RuntimeStoryResponse,
 } from '../../services/runtimeStoryService';
-import { putSaveSnapshot } from '../../services/storageService';
 import type { GameState, StoryMoment, StoryOption } from '../../types';
 
 function getRuntimeResponseOptions(response: RuntimeStoryResponse) {
@@ -18,26 +18,26 @@ function getRuntimeResponseOptions(response: RuntimeStoryResponse) {
     : response.presentation.options;
 }
 
-async function syncRuntimeSnapshot(
+function buildRuntimeSnapshotRequest(
   gameState: GameState,
   currentStory: StoryMoment | null,
 ) {
-  await putSaveSnapshot({
+  return {
     gameState,
     bottomTab: 'adventure',
     currentStory,
-  });
+  } satisfies RuntimeStorySnapshotRequest;
 }
 
 export async function loadServerRuntimeOptionCatalog(params: {
   gameState: GameState;
   currentStory: StoryMoment | null;
 }) {
-  await syncRuntimeSnapshot(params.gameState, params.currentStory);
-
-  const response = await getRuntimeStoryState(
-    getRuntimeSessionId(params.gameState),
-  );
+  const response = await getRuntimeStoryState({
+    sessionId: getRuntimeSessionId(params.gameState),
+    clientVersion: getRuntimeClientVersion(params.gameState),
+    snapshot: buildRuntimeSnapshotRequest(params.gameState, params.currentStory),
+  });
   const options = resolveRuntimeStoryMoment({
     response,
     hydratedSnapshot: response.snapshot,
@@ -64,9 +64,9 @@ export async function resumeServerRuntimeStory(
     };
   }
 
-  const response = await getRuntimeStoryState(
-    getRuntimeSessionId(hydratedSnapshot.gameState),
-  );
+  const response = await getRuntimeStoryState({
+    sessionId: getRuntimeSessionId(hydratedSnapshot.gameState),
+  });
   const resumedSnapshot = rehydrateSavedSnapshot(response.snapshot);
   const runtimeOptions = getRuntimeResponseOptions(response);
   const nextStory =
@@ -96,8 +96,6 @@ export async function resolveServerRuntimeChoice(params: {
     Partial<Pick<StoryOption, 'interaction'>>;
   payload?: RuntimeStoryChoicePayload;
 }) {
-  await syncRuntimeSnapshot(params.gameState, params.currentStory);
-
   const response = await resolveRuntimeStoryAction({
     sessionId: getRuntimeSessionId(params.gameState),
     clientVersion: getRuntimeClientVersion(params.gameState),
@@ -107,6 +105,7 @@ export async function resolveServerRuntimeChoice(params: {
         ? params.option.interaction.npcId
         : undefined,
     payload: params.payload,
+    snapshot: buildRuntimeSnapshotRequest(params.gameState, params.currentStory),
   });
   const hydratedSnapshot = rehydrateSavedSnapshot(response.snapshot);
 
diff --git a/src/hooks/story/uiTypes.ts b/src/hooks/story/uiTypes.ts
index dd2f4f3a..9b901fc4 100644
--- a/src/hooks/story/uiTypes.ts
+++ b/src/hooks/story/uiTypes.ts
@@ -82,7 +82,7 @@ export interface QuestFlowUi {
 }
 
 export interface NpcChatQuestOfferUi {
-  replacePendingOffer: () => Promise<boolean>;
+  replacePendingOffer: () => boolean;
   abandonPendingOffer: () => boolean;
   acceptPendingOffer: () => string | null;
 }
diff --git a/src/services/aiService.ts b/src/services/aiService.ts
index b887ec0d..ba6cc75e 100644
--- a/src/services/aiService.ts
+++ b/src/services/aiService.ts
@@ -353,8 +353,37 @@ export async function generateCustomWorldProfile(
   input: GenerateCustomWorldProfileInput | string,
   options: GenerateCustomWorldProfileOptions = {},
 ): Promise<CustomWorldProfile> {
-  const aiClient = await loadLegacyAiModule();
-  return aiClient.generateCustomWorldProfile(input, options);
+  const normalizedInput =
+    typeof input === 'string'
+      ? {
+          settingText: input,
+        }
+      : input;
+
+  if (typeof window === 'undefined') {
+    const aiClient = await loadLegacyAiModule();
+    return aiClient.generateCustomWorldProfile(normalizedInput, options);
+  }
+
+  if (options.signal?.aborted) {
+    throw options.signal.reason instanceof Error
+      ? options.signal.reason
+      : new Error('世界生成已中断。');
+  }
+
+  const profile = await requestPostJson<CustomWorldProfile>(
+    `${RUNTIME_API_BASE}/custom-world/profile`,
+    normalizedInput,
+    '生成自定义世界失败',
+  );
+
+  if (options.signal?.aborted) {
+    throw options.signal.reason instanceof Error
+      ? options.signal.reason
+      : new Error('世界生成已中断。');
+  }
+
+  return profile;
 }
 
 export async function generateCustomWorldSceneImage(
diff --git a/src/services/apiClient.test.ts b/src/services/apiClient.test.ts
index 4962b9c4..4be91695 100644
--- a/src/services/apiClient.test.ts
+++ b/src/services/apiClient.test.ts
@@ -1,33 +1,12 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 import {
+  AUTH_STATE_EVENT,
   ApiClientError,
-  clearStoredAccessToken,
   fetchWithApiAuth,
-  getStoredAccessToken,
   requestJson,
-  setStoredAccessToken,
 } from './apiClient';
 
-function createMemoryStorage() {
-  const values = new Map<string, string>();
-
-  return {
-    getItem(key: string) {
-      return values.has(key) ? values.get(key)! : null;
-    },
-    setItem(key: string, value: string) {
-      values.set(key, value);
-    },
-    removeItem(key: string) {
-      values.delete(key);
-    },
-    clear() {
-      values.clear();
-    },
-  };
-}
-
 function createResponseMock(params: {
   status: number;
   body?: string;
@@ -54,50 +33,18 @@ function createResponseMock(params: {
 
 describe('apiClient', () => {
   const fetchMock = vi.fn();
+  const dispatchEventMock = vi.fn();
 
   beforeEach(() => {
     vi.stubGlobal('fetch', fetchMock);
     vi.stubGlobal('window', {
-      localStorage: createMemoryStorage(),
-      dispatchEvent: vi.fn(),
+      dispatchEvent: dispatchEventMock,
     });
     fetchMock.mockReset();
-    clearStoredAccessToken();
+    dispatchEventMock.mockReset();
   });
 
-  it('attaches auth headers and clears stale tokens on unauthorized responses', async () => {
-    setStoredAccessToken('jwt-token');
-    fetchMock
-      .mockResolvedValueOnce(createResponseMock({ status: 401 }))
-      .mockResolvedValueOnce(createResponseMock({ status: 401 }));
-
-    const response = await fetchWithApiAuth('/api/protected', { method: 'GET' });
-
-    expect(response.status).toBe(401);
-    expect(fetchMock).toHaveBeenCalledTimes(2);
-    expect(fetchMock).toHaveBeenCalledWith(
-      '/api/protected',
-      expect.objectContaining({
-        credentials: 'same-origin',
-        headers: expect.objectContaining({
-          Authorization: 'Bearer jwt-token',
-          'x-genarrative-response-envelope': 'v1',
-        }),
-      }),
-    );
-    expect(fetchMock).toHaveBeenNthCalledWith(
-      2,
-      '/api/auth/refresh',
-      expect.objectContaining({
-        method: 'POST',
-        credentials: 'same-origin',
-      }),
-    );
-    expect(getStoredAccessToken()).toBe('');
-  });
-
-  it('refreshes the access token once and retries the original request', async () => {
-    setStoredAccessToken('expired-token');
+  it('refreshes cookie session once and retries the original request', async () => {
     fetchMock
       .mockResolvedValueOnce(createResponseMock({ status: 401 }))
       .mockResolvedValueOnce(
@@ -106,7 +53,7 @@ describe('apiClient', () => {
           body: JSON.stringify({
             ok: true,
             data: {
-              token: 'fresh-token',
+              ok: true,
             },
             error: null,
             meta: {
@@ -138,41 +85,115 @@ describe('apiClient', () => {
     );
 
     expect(result).toEqual({ value: 7 });
-    expect(getStoredAccessToken()).toBe('fresh-token');
+    expect(fetchMock).toHaveBeenCalledTimes(3);
+    expect(fetchMock).toHaveBeenNthCalledWith(
+      1,
+      '/api/runtime/protected',
+      expect.objectContaining({
+        credentials: 'same-origin',
+        headers: expect.objectContaining({
+          'x-genarrative-response-envelope': 'v1',
+        }),
+      }),
+    );
     expect(fetchMock).toHaveBeenNthCalledWith(
       2,
       '/api/auth/refresh',
       expect.objectContaining({
         method: 'POST',
+        credentials: 'same-origin',
       }),
     );
     expect(fetchMock).toHaveBeenNthCalledWith(
       3,
       '/api/runtime/protected',
       expect.objectContaining({
-        headers: expect.objectContaining({
-          Authorization: 'Bearer fresh-token',
-        }),
+        credentials: 'same-origin',
+      }),
+    );
+    expect(dispatchEventMock).toHaveBeenCalledTimes(1);
+    expect(dispatchEventMock).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: AUTH_STATE_EVENT,
       }),
     );
   });
 
-  it('does not refresh or emit auth changes for 401 responses without auth context', async () => {
+  it('does not emit auth change events when 401 probe requests opt into silent mode', async () => {
     fetchMock.mockResolvedValueOnce(createResponseMock({ status: 401 }));
 
+    const response = await fetchWithApiAuth(
+      '/api/auth/me',
+      {
+        method: 'GET',
+      },
+      {
+        notifyAuthStateChange: false,
+        skipRefresh: true,
+      },
+    );
+
+    expect(response.status).toBe(401);
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    expect(dispatchEventMock).not.toHaveBeenCalled();
+  });
+
+  it('emits auth change events when refresh fails on protected requests', async () => {
+    fetchMock
+      .mockResolvedValueOnce(createResponseMock({ status: 401 }))
+      .mockResolvedValueOnce(createResponseMock({ status: 401 }));
+
     const response = await fetchWithApiAuth('/api/runtime/protected', {
       method: 'GET',
     });
 
     expect(response.status).toBe(401);
-    expect(fetchMock).toHaveBeenCalledTimes(1);
-    expect(fetchMock).toHaveBeenCalledWith(
+    expect(fetchMock).toHaveBeenCalledTimes(2);
+    expect(dispatchEventMock).toHaveBeenCalledTimes(1);
+  });
+
+  it('accepts refresh responses that only acknowledge renewed cookie state', async () => {
+    fetchMock
+      .mockResolvedValueOnce(createResponseMock({ status: 401 }))
+      .mockResolvedValueOnce(
+        createResponseMock({
+          status: 200,
+          body: JSON.stringify({
+            ok: true,
+            data: {
+              ok: true,
+            },
+            error: null,
+            meta: {
+              apiVersion: '2026-04-08',
+            },
+          }),
+        }),
+      )
+      .mockResolvedValueOnce(
+        createResponseMock({
+          status: 200,
+          body: JSON.stringify({
+            ok: true,
+            data: {
+              value: 9,
+            },
+            error: null,
+            meta: {
+              apiVersion: '2026-04-08',
+            },
+          }),
+        }),
+      );
+
+    const result = await requestJson<{ value: number }>(
       '/api/runtime/protected',
-      expect.objectContaining({
-        credentials: 'same-origin',
-      }),
+      { method: 'GET' },
+      '读取受保护数据失败',
     );
-    expect(window.dispatchEvent).not.toHaveBeenCalled();
+
+    expect(result).toEqual({ value: 9 });
+    expect(fetchMock).toHaveBeenCalledTimes(3);
   });
 
   it('retries transient get requests before unwrapping the response envelope', async () => {
diff --git a/src/services/apiClient.ts b/src/services/apiClient.ts
index 752a166e..61966e05 100644
--- a/src/services/apiClient.ts
+++ b/src/services/apiClient.ts
@@ -7,8 +7,8 @@ import {
   parseApiErrorMessage,
   unwrapApiResponse,
 } from '../../packages/shared/src/http';
+import type { AuthRefreshResponse } from '../../packages/shared/src/contracts/auth';
 
-const ACCESS_TOKEN_KEY = 'genarrative.auth.access-token.v1';
 export const AUTH_STATE_EVENT = 'genarrative-auth-state-changed';
 const REQUEST_ID_HEADER = 'x-request-id';
 const API_VERSION_HEADER = 'x-api-version';
@@ -30,6 +30,8 @@ export type ApiRequestOptions = {
   skipAuth?: boolean;
   omitEnvelopeHeader?: boolean;
   skipRefresh?: boolean;
+  // 会话探测类请求需要静默处理 401，避免 AuthGate 因自发广播再次触发 hydrate。
+  notifyAuthStateChange?: boolean;
 };
 
 type ResolvedRetryOptions = {
@@ -48,10 +50,6 @@ type ParsedApiErrorShape = {
   meta: Partial<ApiMeta>;
 };
 
-type RefreshTokenResponse = {
-  token: string;
-};
-
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === 'object' && value !== null;
 }
@@ -311,11 +309,7 @@ export class ApiClientError extends Error {
   }
 }
 
-function canUseLocalStorage() {
-  return typeof window !== 'undefined' && typeof window.localStorage !== 'undefined';
-}
-
-function emitAuthStateChange() {
+export function emitAuthStateChange() {
   if (typeof window === 'undefined') {
     return;
   }
@@ -330,72 +324,18 @@ function emitAuthStateChange() {
   }
 }
 
-export function getStoredAccessToken() {
-  if (!canUseLocalStorage()) {
-    return '';
-  }
-
-  return window.localStorage.getItem(ACCESS_TOKEN_KEY)?.trim() || '';
-}
-
-export function setStoredAccessToken(
-  token: string,
-  options: {
-    emit?: boolean;
-  } = {},
-) {
-  if (!canUseLocalStorage()) {
-    return;
-  }
-
-  const nextToken = token.trim();
-  const previousToken = getStoredAccessToken();
-  if (nextToken) {
-    window.localStorage.setItem(ACCESS_TOKEN_KEY, nextToken);
-  } else {
-    window.localStorage.removeItem(ACCESS_TOKEN_KEY);
-  }
-
-  // 只有登录态令牌真的发生变化时才广播事件，避免无意义的鉴权重算。
-  if (options.emit !== false && previousToken !== nextToken) {
-    emitAuthStateChange();
-  }
-}
-
-export function clearStoredAccessToken(
-  options: {
-    emit?: boolean;
-  } = {},
-) {
-  if (!canUseLocalStorage()) {
-    return;
-  }
-
-  const previousToken = getStoredAccessToken();
-  window.localStorage.removeItem(ACCESS_TOKEN_KEY);
-
-  // 未登录态下重复清空 token 不应触发状态刷新，否则会放大 401 循环。
-  if (options.emit !== false && previousToken) {
-    emitAuthStateChange();
-  }
-}
-
-function withAuthorizationHeaders(
+function withApiHeaders(
   headers?: HeadersInit,
-  options: Pick<ApiRequestOptions, 'omitEnvelopeHeader' | 'skipAuth'> = {},
+  options: Pick<ApiRequestOptions, 'omitEnvelopeHeader'> = {},
 ) {
   const nextHeaders = normalizeHeaders(headers);
-  const token = getStoredAccessToken();
-  if (token && !options.skipAuth) {
-    nextHeaders.Authorization = `Bearer ${token}`;
-  }
   if (!options.omitEnvelopeHeader) {
     nextHeaders[API_RESPONSE_ENVELOPE_HEADER] = API_RESPONSE_ENVELOPE_VERSION;
   }
   return nextHeaders;
 }
 
-let refreshAccessTokenPromise: Promise<string> | null = null;
+let refreshAccessTokenPromise: Promise<void> | null = null;
 
 async function refreshAccessToken() {
   if (refreshAccessTokenPromise) {
@@ -412,24 +352,19 @@ async function refreshAccessToken() {
     });
 
     if (!response.ok) {
-      clearStoredAccessToken();
       throw await buildApiClientError(response, '刷新登录状态失败');
     }
 
     const responseText = await response.text();
     const payload = responseText
-      ? unwrapApiResponse<RefreshTokenResponse>(
-          JSON.parse(responseText) as RefreshTokenResponse,
+      ? unwrapApiResponse<AuthRefreshResponse>(
+          JSON.parse(responseText) as AuthRefreshResponse,
         )
       : null;
 
-    if (!payload?.token?.trim()) {
-      clearStoredAccessToken();
+    if (payload?.ok !== true) {
       throw new Error('刷新登录状态失败');
     }
-
-    setStoredAccessToken(payload.token, { emit: false });
-    return payload.token;
   })();
 
   try {
@@ -446,25 +381,20 @@ export async function fetchWithApiAuth(
 ) {
   const method = (init.method ?? 'GET').toUpperCase();
   const retry = resolveRetryOptions(method, options.retry);
+  const shouldNotifyAuthStateChange = options.notifyAuthStateChange !== false;
   let attempt = 0;
   let refreshAttempted = false;
 
   for (;;) {
     try {
-      const requestHeaders = withAuthorizationHeaders(init.headers, options);
-      const hasAuthHeader = Boolean(
-        requestHeaders.Authorization?.trim() ||
-          requestHeaders.authorization?.trim(),
-      );
       const response = await fetch(input, {
         credentials: 'same-origin',
         ...init,
-        headers: requestHeaders,
+        headers: withApiHeaders(init.headers, options),
       });
 
       if (
         response.status === 401 &&
-        hasAuthHeader &&
         !options.skipAuth &&
         !options.skipRefresh &&
         !refreshAttempted
@@ -472,12 +402,19 @@ export async function fetchWithApiAuth(
         try {
           await refreshAccessToken();
           refreshAttempted = true;
+          if (shouldNotifyAuthStateChange) {
+            emitAuthStateChange();
+          }
           continue;
         } catch {
-          clearStoredAccessToken();
+          if (shouldNotifyAuthStateChange) {
+            emitAuthStateChange();
+          }
+        }
+      } else if (response.status === 401 && !options.skipAuth) {
+        if (shouldNotifyAuthStateChange) {
+          emitAuthStateChange();
         }
-      } else if (response.status === 401) {
-        clearStoredAccessToken();
       }
 
       if (!shouldRetryResponse(response.status, attempt, retry)) {
diff --git a/src/services/authService.test.ts b/src/services/authService.test.ts
index 03e245c2..566b38db 100644
--- a/src/services/authService.test.ts
+++ b/src/services/authService.test.ts
@@ -1,15 +1,20 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 
-const { requestJsonMock } = vi.hoisted(() => ({
-  requestJsonMock: vi.fn(),
+const apiClientMocks = vi.hoisted(() => ({
+  emitAuthStateChange: vi.fn(),
+  requestJson: vi.fn(),
 }));
 
-import {
-  ApiClientError,
-  clearStoredAccessToken,
-  getStoredAccessToken,
-  setStoredAccessToken,
-} from './apiClient';
+vi.mock('./apiClient', async () => {
+  const actual = await vi.importActual<typeof import('./apiClient')>('./apiClient');
+  return {
+    ...actual,
+    emitAuthStateChange: apiClientMocks.emitAuthStateChange,
+    requestJson: apiClientMocks.requestJson,
+  };
+});
+
+import { ApiClientError } from './apiClient';
 import {
   authEntryWithStoredCredentials,
   bindWechatPhone,
@@ -22,49 +27,34 @@ import {
   getAuthRiskBlocks,
   getAuthSessions,
   getCaptchaChallengeFromError,
+  getCurrentAuthUser,
   liftAuthRiskBlock,
   loginWithPhoneCode,
   logoutAllAuthSessions,
-  revokeAuthSession,
   sendPhoneLoginCode,
   startWechatLogin,
 } from './authService';
 
-function createMemoryStorage() {
-  const values = new Map<string, string>();
-
+function createWindowMock(overrides: Record<string, unknown> = {}) {
   return {
-    getItem(key: string) {
-      return values.has(key) ? values.get(key)! : null;
+    dispatchEvent: vi.fn(),
+    location: {
+      pathname: '/',
+      hash: '',
+      search: '',
+      assign: vi.fn(),
     },
-    setItem(key: string, value: string) {
-      values.set(key, value);
-    },
-    removeItem(key: string) {
-      values.delete(key);
-    },
-    clear() {
-      values.clear();
+    history: {
+      replaceState: vi.fn(),
     },
+    ...overrides,
   };
 }
 
-vi.mock('./apiClient', async () => {
-  const actual = await vi.importActual<typeof import('./apiClient')>('./apiClient');
-  return {
-    ...actual,
-    requestJson: requestJsonMock,
-  };
-});
-
-describe('authService auto auth', () => {
+describe('authService', () => {
   beforeEach(() => {
-    vi.stubGlobal('window', {
-      localStorage: createMemoryStorage(),
-      dispatchEvent: vi.fn(),
-    });
-    requestJsonMock.mockReset();
-    clearStoredAccessToken();
+    vi.clearAllMocks();
+    vi.stubGlobal('window', createWindowMock());
   });
 
   it('creates credentials that match current username/password constraints', () => {
@@ -75,9 +65,8 @@ describe('authService auto auth', () => {
     expect(credentials.password.length).toBeGreaterThanOrEqual(6);
   });
 
-  it('stores jwt after auth entry without persisting guest credentials locally', async () => {
-    requestJsonMock.mockResolvedValue({
-      token: 'jwt-token-value',
+  it('auth entry trims guest credentials and emits auth state changes', async () => {
+    apiClientMocks.requestJson.mockResolvedValue({
       user: {
         id: 'user_1',
         username: 'guest_abc123abc123',
@@ -95,8 +84,7 @@ describe('authService auto auth', () => {
     });
 
     expect(user.username).toBe('guest_abc123abc123');
-    expect(getStoredAccessToken()).toBe('jwt-token-value');
-    expect(requestJsonMock).toHaveBeenCalledWith(
+    expect(apiClientMocks.requestJson).toHaveBeenCalledWith(
       '/api/auth/entry',
       expect.objectContaining({
         body: JSON.stringify({
@@ -106,11 +94,11 @@ describe('authService auto auth', () => {
       }),
       '登录失败',
     );
+    expect(apiClientMocks.emitAuthStateChange).toHaveBeenCalledTimes(1);
   });
 
   it('creates a fresh guest credential pair for auto auth when a session is missing', async () => {
-    requestJsonMock.mockResolvedValue({
-      token: 'jwt-restored',
+    apiClientMocks.requestJson.mockResolvedValue({
       user: {
         id: 'user_saved',
         username: 'guest_saveduser01',
@@ -124,7 +112,7 @@ describe('authService auto auth', () => {
 
     const result = await ensureAutoAuthUser();
     const authEntryBody = JSON.parse(
-      requestJsonMock.mock.calls[0]?.[1]?.body as string,
+      apiClientMocks.requestJson.mock.calls[0]?.[1]?.body as string,
     ) as {
       username: string;
       password: string;
@@ -136,19 +124,11 @@ describe('authService auto auth', () => {
       /^auto_[a-z0-9]{24}_[a-z0-9]{8}$/u,
     );
     expect(authEntryBody).toEqual(result.credentials);
-    expect(requestJsonMock).toHaveBeenCalledWith(
-      '/api/auth/entry',
-      expect.objectContaining({
-        method: 'POST',
-        body: expect.any(String),
-      }),
-      '登录失败',
-    );
+    expect(apiClientMocks.requestJson).toHaveBeenCalledTimes(1);
   });
 
   it('deduplicates concurrent auto auth requests', async () => {
-    requestJsonMock.mockResolvedValue({
-      token: 'jwt-auto',
+    apiClientMocks.requestJson.mockResolvedValue({
       user: {
         id: 'user_auto',
         username: 'guest_auto',
@@ -165,19 +145,12 @@ describe('authService auto auth', () => {
       ensureAutoAuthUser(),
     ]);
 
-    expect(requestJsonMock).toHaveBeenCalledTimes(1);
+    expect(apiClientMocks.requestJson).toHaveBeenCalledTimes(1);
     expect(firstResult).toEqual(secondResult);
-    const authEntryBody = JSON.parse(
-      requestJsonMock.mock.calls[0]?.[1]?.body as string,
-    ) as {
-      username: string;
-      password: string;
-    };
-    expect(authEntryBody).toEqual(firstResult.credentials);
   });
 
-  it('sends phone login code through the new auth endpoint', async () => {
-    requestJsonMock.mockResolvedValue({
+  it('sends phone login code through the auth endpoint', async () => {
+    apiClientMocks.requestJson.mockResolvedValue({
       ok: true,
       cooldownSeconds: 60,
       expiresInSeconds: 300,
@@ -187,7 +160,7 @@ describe('authService auto auth', () => {
     const result = await sendPhoneLoginCode(' 138 0013 8000 ');
 
     expect(result.cooldownSeconds).toBe(60);
-    expect(requestJsonMock).toHaveBeenCalledWith(
+    expect(apiClientMocks.requestJson).toHaveBeenCalledWith(
       '/api/auth/phone/send-code',
       expect.objectContaining({
         body: JSON.stringify({
@@ -199,28 +172,6 @@ describe('authService auto auth', () => {
     );
   });
 
-  it('sends phone change code with the correct scene', async () => {
-    requestJsonMock.mockResolvedValue({
-      ok: true,
-      cooldownSeconds: 60,
-      expiresInSeconds: 300,
-      providerRequestId: 'mock-request-id',
-    });
-
-    await sendPhoneLoginCode('13900139000', 'change_phone');
-
-    expect(requestJsonMock).toHaveBeenCalledWith(
-      '/api/auth/phone/send-code',
-      expect.objectContaining({
-        body: JSON.stringify({
-          phone: '13900139000',
-          scene: 'change_phone',
-        }),
-      }),
-      '发送验证码失败',
-    );
-  });
-
   it('extracts captcha challenge details from api errors', () => {
     expect(getCaptchaChallengeFromError(new Error('plain error'))).toBeNull();
 
@@ -246,9 +197,8 @@ describe('authService auto auth', () => {
     });
   });
 
-  it('stores jwt after phone login', async () => {
-    requestJsonMock.mockResolvedValue({
-      token: 'phone-jwt-token',
+  it('emits auth state changes after phone login', async () => {
+    apiClientMocks.requestJson.mockResolvedValue({
       user: {
         id: 'user_phone',
         username: '138****8000',
@@ -263,8 +213,7 @@ describe('authService auto auth', () => {
     const user = await loginWithPhoneCode('13800138000', '123456');
 
     expect(user.username).toBe('138****8000');
-    expect(getStoredAccessToken()).toBe('phone-jwt-token');
-    expect(requestJsonMock).toHaveBeenCalledWith(
+    expect(apiClientMocks.requestJson).toHaveBeenCalledWith(
       '/api/auth/phone/login',
       expect.objectContaining({
         body: JSON.stringify({
@@ -274,11 +223,11 @@ describe('authService auto auth', () => {
       }),
       '登录失败',
     );
+    expect(apiClientMocks.emitAuthStateChange).toHaveBeenCalledTimes(1);
   });
 
-  it('binds wechat phone and stores jwt after activation', async () => {
-    requestJsonMock.mockResolvedValue({
-      token: 'wechat-bind-token',
+  it('emits auth state changes after wechat bind activation', async () => {
+    apiClientMocks.requestJson.mockResolvedValue({
       user: {
         id: 'user_wechat',
         username: '138****8000',
@@ -293,22 +242,11 @@ describe('authService auto auth', () => {
     const user = await bindWechatPhone('13800138000', '123456');
 
     expect(user.wechatBound).toBe(true);
-    expect(getStoredAccessToken()).toBe('wechat-bind-token');
-    expect(requestJsonMock).toHaveBeenCalledWith(
-      '/api/auth/wechat/bind-phone',
-      expect.objectContaining({
-        body: JSON.stringify({
-          phone: '13800138000',
-          code: '123456',
-        }),
-      }),
-      '绑定手机号失败',
-    );
+    expect(apiClientMocks.emitAuthStateChange).toHaveBeenCalledTimes(1);
   });
 
-  it('changes phone number without replacing the stored access token', async () => {
-    setStoredAccessToken('active-token');
-    requestJsonMock.mockResolvedValue({
+  it('changes phone number without emitting a global auth state refresh', async () => {
+    apiClientMocks.requestJson.mockResolvedValue({
       user: {
         id: 'user_phone',
         username: '139****9000',
@@ -323,41 +261,29 @@ describe('authService auto auth', () => {
     const user = await changePhoneNumber('13900139000', '123456');
 
     expect(user.phoneNumberMasked).toBe('139****9000');
-    expect(getStoredAccessToken()).toBe('active-token');
-    expect(requestJsonMock).toHaveBeenCalledWith(
-      '/api/auth/phone/change',
-      expect.objectContaining({
-        body: JSON.stringify({
-          phone: '13900139000',
-          code: '123456',
-        }),
-      }),
-      '更换手机号失败',
-    );
+    expect(apiClientMocks.emitAuthStateChange).not.toHaveBeenCalled();
   });
 
   it('starts wechat login by navigating to backend authorization url', async () => {
     const assignMock = vi.fn();
-    vi.stubGlobal('window', {
-      localStorage: createMemoryStorage(),
-      dispatchEvent: vi.fn(),
-      location: {
-        pathname: '/',
-        hash: '',
-        search: '',
-        assign: assignMock,
-      },
-      history: {
-        replaceState: vi.fn(),
-      },
-    });
-    requestJsonMock.mockResolvedValue({
+    vi.stubGlobal(
+      'window',
+      createWindowMock({
+        location: {
+          pathname: '/',
+          hash: '',
+          search: '',
+          assign: assignMock,
+        },
+      }),
+    );
+    apiClientMocks.requestJson.mockResolvedValue({
       authorizationUrl: '/api/auth/wechat/callback?mock_code=wx-user&state=state123',
     });
 
     await startWechatLogin();
 
-    expect(requestJsonMock).toHaveBeenCalledWith(
+    expect(apiClientMocks.requestJson).toHaveBeenCalledWith(
       '/api/auth/wechat/start?redirectPath=%2F',
       expect.objectContaining({
         method: 'GET',
@@ -370,14 +296,14 @@ describe('authService auto auth', () => {
   });
 
   it('loads available login methods for the unauthenticated login screen', async () => {
-    requestJsonMock.mockResolvedValue({
+    apiClientMocks.requestJson.mockResolvedValue({
       availableLoginMethods: ['phone', 'wechat'],
     });
 
     const result = await getAuthLoginOptions();
 
     expect(result.availableLoginMethods).toEqual(['phone', 'wechat']);
-    expect(requestJsonMock).toHaveBeenCalledWith(
+    expect(apiClientMocks.requestJson).toHaveBeenCalledWith(
       '/api/auth/login-options',
       expect.objectContaining({
         method: 'GET',
@@ -386,20 +312,22 @@ describe('authService auto auth', () => {
     );
   });
 
-  it('consumes auth callback hash and stores token', () => {
+  it('consumes auth callback hash without trying to persist tokens locally', () => {
     const replaceStateMock = vi.fn();
-    vi.stubGlobal('window', {
-      localStorage: createMemoryStorage(),
-      dispatchEvent: vi.fn(),
-      location: {
-        pathname: '/',
-        search: '',
-        hash: '#auth_provider=wechat&auth_token=wx-token&auth_binding_status=pending_bind_phone',
-      },
-      history: {
-        replaceState: replaceStateMock,
-      },
-    });
+    vi.stubGlobal(
+      'window',
+      createWindowMock({
+        location: {
+          pathname: '/',
+          search: '',
+          hash: '#auth_provider=wechat&auth_binding_status=pending_bind_phone',
+          assign: vi.fn(),
+        },
+        history: {
+          replaceState: replaceStateMock,
+        },
+      }),
+    );
 
     const result = consumeAuthCallbackResult();
 
@@ -408,12 +336,36 @@ describe('authService auto auth', () => {
       bindingStatus: 'pending_bind_phone',
       error: null,
     });
-    expect(getStoredAccessToken()).toBe('wx-token');
+    expect(apiClientMocks.emitAuthStateChange).not.toHaveBeenCalled();
     expect(replaceStateMock).toHaveBeenCalledWith(null, '', '/');
   });
 
+  it('gets current auth user with silent auth-state notification settings', async () => {
+    apiClientMocks.requestJson.mockResolvedValue({
+      user: null,
+      availableLoginMethods: ['phone'],
+    });
+
+    const result = await getCurrentAuthUser();
+
+    expect(result).toEqual({
+      user: null,
+      availableLoginMethods: ['phone'],
+    });
+    expect(apiClientMocks.requestJson).toHaveBeenCalledWith(
+      '/api/auth/me',
+      expect.objectContaining({
+        method: 'GET',
+      }),
+      '读取当前用户失败',
+      {
+        notifyAuthStateChange: false,
+      },
+    );
+  });
+
   it('loads auth sessions from account center endpoint', async () => {
-    requestJsonMock.mockResolvedValue({
+    apiClientMocks.requestJson.mockResolvedValue({
       sessions: [
         {
           sessionId: 'usess_1',
@@ -432,17 +384,10 @@ describe('authService auto auth', () => {
     const sessions = await getAuthSessions();
 
     expect(sessions).toHaveLength(1);
-    expect(requestJsonMock).toHaveBeenCalledWith(
-      '/api/auth/sessions',
-      expect.objectContaining({
-        method: 'GET',
-      }),
-      '读取登录设备失败',
-    );
   });
 
   it('loads recent auth audit logs', async () => {
-    requestJsonMock.mockResolvedValue({
+    apiClientMocks.requestJson.mockResolvedValue({
       logs: [
         {
           id: 'audit_1',
@@ -459,17 +404,10 @@ describe('authService auto auth', () => {
     const logs = await getAuthAuditLogs();
 
     expect(logs).toHaveLength(1);
-    expect(requestJsonMock).toHaveBeenCalledWith(
-      '/api/auth/audit-logs',
-      expect.objectContaining({
-        method: 'GET',
-      }),
-      '读取账号操作记录失败',
-    );
   });
 
   it('loads current risk blocks', async () => {
-    requestJsonMock.mockResolvedValue({
+    apiClientMocks.requestJson.mockResolvedValue({
       blocks: [
         {
           scopeType: 'phone',
@@ -484,23 +422,16 @@ describe('authService auto auth', () => {
     const blocks = await getAuthRiskBlocks();
 
     expect(blocks).toHaveLength(1);
-    expect(requestJsonMock).toHaveBeenCalledWith(
-      '/api/auth/risk-blocks',
-      expect.objectContaining({
-        method: 'GET',
-      }),
-      '读取安全状态失败',
-    );
   });
 
   it('lifts a risk block by scope type', async () => {
-    requestJsonMock.mockResolvedValue({
+    apiClientMocks.requestJson.mockResolvedValue({
       ok: true,
     });
 
     await liftAuthRiskBlock('phone');
 
-    expect(requestJsonMock).toHaveBeenCalledWith(
+    expect(apiClientMocks.requestJson).toHaveBeenCalledWith(
       '/api/auth/risk-blocks/phone/lift',
       expect.objectContaining({
         method: 'POST',
@@ -509,37 +440,20 @@ describe('authService auto auth', () => {
     );
   });
 
-  it('revokes a remote auth session by id', async () => {
-    requestJsonMock.mockResolvedValue({
-      ok: true,
-    });
-
-    await revokeAuthSession('usess_123');
-
-    expect(requestJsonMock).toHaveBeenCalledWith(
-      '/api/auth/sessions/usess_123/revoke',
-      expect.objectContaining({
-        method: 'POST',
-      }),
-      '移除登录设备失败',
-    );
-  });
-
-  it('clears local auth state after logout all sessions', async () => {
-    setStoredAccessToken('stale-token');
-    requestJsonMock.mockResolvedValue({
+  it('emits auth change after logout all sessions', async () => {
+    apiClientMocks.requestJson.mockResolvedValue({
       ok: true,
     });
 
     await logoutAllAuthSessions();
 
-    expect(requestJsonMock).toHaveBeenCalledWith(
+    expect(apiClientMocks.requestJson).toHaveBeenCalledWith(
       '/api/auth/logout-all',
       expect.objectContaining({
         method: 'POST',
       }),
       '退出全部设备失败',
     );
-    expect(getStoredAccessToken()).toBe('');
+    expect(apiClientMocks.emitAuthStateChange).toHaveBeenCalledTimes(1);
   });
 });
diff --git a/src/services/authService.ts b/src/services/authService.ts
index b6736431..dbf7b1ca 100644
--- a/src/services/authService.ts
+++ b/src/services/authService.ts
@@ -23,9 +23,8 @@ import type {
 } from '../../packages/shared/src/contracts/auth';
 import {
   ApiClientError,
-  clearStoredAccessToken,
+  emitAuthStateChange,
   requestJson,
-  setStoredAccessToken,
 } from './apiClient';
 
 export type { AuthUser } from '../../packages/shared/src/contracts/auth';
@@ -117,7 +116,7 @@ export function createAutoAuthCredentials(): AutoAuthCredentials {
 }
 
 export function clearAuthSession() {
-  clearStoredAccessToken();
+  emitAuthStateChange();
 }
 
 export async function sendPhoneLoginCode(
@@ -160,7 +159,7 @@ export async function loginWithPhoneCode(phone: string, code: string) {
     '登录失败',
   );
 
-  setStoredAccessToken(response.token);
+  emitAuthStateChange();
   return response.user;
 }
 
@@ -178,7 +177,7 @@ export async function bindWechatPhone(phone: string, code: string) {
     '绑定手机号失败',
   );
 
-  setStoredAccessToken(response.token);
+  emitAuthStateChange();
   return response.user;
 }
 
@@ -233,7 +232,7 @@ export async function authEntry(username: string, password: string) {
     '登录失败',
   );
 
-  setStoredAccessToken(response.token);
+  emitAuthStateChange();
   return response.user;
 }
 
@@ -279,19 +278,14 @@ export function consumeAuthCallbackResult(): ConsumedAuthCallback | null {
   }
 
   const params = new URLSearchParams(hash);
-  const authToken = params.get('auth_token');
   const authError = params.get('auth_error');
   const providerValue = params.get('auth_provider');
   const bindingStatus = params.get('auth_binding_status');
 
-  if (!authToken && !authError) {
+  if (!bindingStatus && !authError && !providerValue) {
     return null;
   }
 
-  if (authToken) {
-    setStoredAccessToken(authToken);
-  }
-
   if (typeof window.history?.replaceState === 'function') {
     window.history.replaceState(
       null,
@@ -314,6 +308,10 @@ export async function getCurrentAuthUser(): Promise<AuthSessionSnapshot> {
       method: 'GET',
     },
     '读取当前用户失败',
+    {
+      // 会话恢复阶段允许 401 作为“未登录”信号，不应再广播一次全局鉴权事件。
+      notifyAuthStateChange: false,
+    },
   );
 
   return {
diff --git a/src/services/customWorldAgentDraftResult.test.ts b/src/services/customWorldAgentDraftResult.test.ts
index c75afc02..4d6c8ddf 100644
--- a/src/services/customWorldAgentDraftResult.test.ts
+++ b/src/services/customWorldAgentDraftResult.test.ts
@@ -777,3 +777,85 @@ test('embedded legacy result profile keeps result-page settings in runtime chara
     '守灯会值夜人，对外总像比别人更冷静一步。',
   );
 });
+
+test('embedded legacy result profile uses latest draft role collection when legacy role ids drift', () => {
+  const profile = buildCustomWorldProfileFromAgentDraft({
+    ...session,
+    draftProfile: {
+      ...session.draftProfile,
+      legacyResultProfile: buildLegacyResultProfile(),
+      storyNpcs: [
+        {
+          id: 'story-npc-latest-1',
+          name: '林教授',
+          title: '深海学院导师',
+          role: '场景关键角色',
+          publicIdentity: '研究古代海洋遗迹的资深学者。',
+          publicMask: '总是先观察，再给出判断。',
+          currentPressure: '必须在遗迹崩塌前带出关键样本。',
+          hiddenHook: '他知道遗迹深处那扇门为何会苏醒。',
+          relationToPlayer: '最早愿意共享海图的人',
+          threadIds: ['thread-1'],
+          summary: '他像学者，也像提前看见灾变的人。',
+          imageSrc:
+            '/generated-characters/story-npc-latest-1/visual/asset-latest/master.png',
+          generatedVisualAssetId: 'asset-latest-story',
+        },
+      ],
+      sceneChapters: [
+        {
+          id: 'scene-chapter-latest-1',
+          sceneId: 'landmark-1',
+          sceneName: '回潮旧灯塔',
+          title: '灯塔新章',
+          summary: '围绕林教授推进的新章节。',
+          linkedThreadIds: ['thread-1'],
+          linkedLandmarkIds: ['landmark-1'],
+          acts: [
+            {
+              id: 'scene-act-latest-1',
+              title: '第一幕',
+              summary: '先接林教授的入口信息。',
+              stageCoverage: ['opening'],
+              backgroundImageSrc:
+                '/generated-custom-world-scenes/landmark-1/scene-act-latest-1/scene.png',
+              backgroundAssetId: 'scene-asset-latest',
+              encounterNpcIds: ['story-npc-latest-1'],
+              primaryNpcId: 'story-npc-latest-1',
+              linkedThreadIds: ['thread-1'],
+              actGoal: '接住新的入口信息',
+              transitionHook: '向下一幕推进。',
+              advanceRule: 'after_primary_contact',
+            },
+          ],
+        },
+      ],
+      landmarks: [
+        {
+          ...session.draftProfile.landmarks[0],
+          imageSrc: '/generated-custom-world-scenes/landmark-1/latest-scene.png',
+        },
+      ],
+    },
+  });
+
+  expect(profile?.storyNpcs).toHaveLength(1);
+  expect(profile?.storyNpcs[0]?.id).toBe('story-npc-latest-1');
+  expect(profile?.storyNpcs[0]?.name).toBe('林教授');
+  expect(profile?.storyNpcs[0]?.imageSrc).toBe(
+    '/generated-characters/story-npc-latest-1/visual/asset-latest/master.png',
+  );
+  expect(profile?.storyNpcs[0]?.generatedVisualAssetId).toBe(
+    'asset-latest-story',
+  );
+  expect(profile?.storyNpcs[0]?.narrativeProfile).toBeFalsy();
+  expect(profile?.landmarks[0]?.imageSrc).toBe(
+    '/generated-custom-world-scenes/landmark-1/latest-scene.png',
+  );
+  expect(profile?.sceneChapterBlueprints?.[0]?.acts[0]?.primaryNpcId).toBe(
+    'story-npc-latest-1',
+  );
+  expect(profile?.sceneChapterBlueprints?.[0]?.acts[0]?.backgroundImageSrc).toBe(
+    '/generated-custom-world-scenes/landmark-1/scene-act-latest-1/scene.png',
+  );
+});
diff --git a/src/services/customWorldAgentDraftResult.ts b/src/services/customWorldAgentDraftResult.ts
index 24bfa722..1df6f997 100644
--- a/src/services/customWorldAgentDraftResult.ts
+++ b/src/services/customWorldAgentDraftResult.ts
@@ -147,6 +147,13 @@ type AdaptedDraftLandmark = {
   connections: never[];
 };
 
+type AdaptedDraftCamp = {
+  name: string;
+  description: string;
+  dangerLevel: string;
+  imageSrc?: string;
+};
+
 function adaptDraftLandmarks(value: unknown, storyNpcIdSet: Set<string>) {
   return toRecordArray(value)
     .map((record, index) => {
@@ -178,108 +185,225 @@ function adaptDraftLandmarks(value: unknown, storyNpcIdSet: Set<string>) {
     .filter(Boolean) as AdaptedDraftLandmark[];
 }
 
-function mergeDraftRoleAssetsIntoProfile(
-  baseProfile: CustomWorldProfile,
-  draftRoles: AdaptedDraftCharacter[],
-  roleKind: 'playable' | 'story',
-) {
-  const draftRoleById = new Map(draftRoles.map((role) => [role.id, role]));
-  const currentRoles =
-    roleKind === 'playable' ? baseProfile.playableNpcs : baseProfile.storyNpcs;
-  const mergedRoles = currentRoles.map((role) => {
-    const draftRole = draftRoleById.get(role.id);
-    if (!draftRole) {
-      return role;
-    }
+function adaptDraftCamp(value: unknown): AdaptedDraftCamp | null {
+  if (!isRecord(value)) {
+    return null;
+  }
 
-    return {
-      ...role,
-      imageSrc: draftRole.imageSrc ?? role.imageSrc,
-      generatedVisualAssetId:
-        draftRole.generatedVisualAssetId ?? role.generatedVisualAssetId,
-      generatedAnimationSetId:
-        draftRole.generatedAnimationSetId ?? role.generatedAnimationSetId,
-      animationMap: draftRole.animationMap ?? role.animationMap,
-    };
-  });
-
-  if (roleKind === 'playable') {
-    return {
-      ...baseProfile,
-      playableNpcs: mergedRoles,
-    } satisfies CustomWorldProfile;
+  const name = toText(value.name);
+  const description = toText(value.description);
+  if (!name && !description) {
+    return null;
   }
 
   return {
-    ...baseProfile,
-    storyNpcs: mergedRoles,
-  } satisfies CustomWorldProfile;
+    name: name || '开局据点',
+    description: description || '开局落脚点仍待继续精修。',
+    dangerLevel:
+      toText(value.dangerLevel) || toText(value.mood) || 'medium',
+    imageSrc: toText(value.imageSrc) || undefined,
+  } satisfies AdaptedDraftCamp;
 }
 
-function mergeDraftSceneAssetsIntoProfile(
-  baseProfile: CustomWorldProfile,
-  draftSceneChapters: CustomWorldProfile['sceneChapterBlueprints'],
-  draftLandmarks: AdaptedDraftLandmark[],
+function normalizeMatchText(value: unknown) {
+  return toText(value).toLocaleLowerCase();
+}
+
+function findRecordMatchIndex(
+  records: Record<string, unknown>[],
+  matcher: (record: Record<string, unknown>) => boolean,
+  usedIndexes: Set<number>,
 ) {
-  const normalizedDraftSceneChapters = draftSceneChapters ?? [];
-  const draftSceneChapterBySceneId = new Map(
-    normalizedDraftSceneChapters.map((chapter) => [chapter.sceneId, chapter]),
+  const matchedIndex = records.findIndex(
+    (record, index) => !usedIndexes.has(index) && matcher(record),
   );
-  const draftLandmarkById = new Map(draftLandmarks.map((entry) => [entry.id, entry]));
+  if (matchedIndex >= 0) {
+    usedIndexes.add(matchedIndex);
+  }
+  return matchedIndex;
+}
 
-  const nextCamp = baseProfile.camp
-    ? {
-        ...baseProfile.camp,
-        imageSrc: baseProfile.camp.imageSrc,
-      }
-    : baseProfile.camp;
+function mergeDraftRolesIntoProfileRecord(params: {
+  baseRoles: unknown;
+  draftRoles: AdaptedDraftCharacter[];
+}) {
+  const baseRoles = toRecordArray(params.baseRoles);
+  if (params.draftRoles.length <= 0) {
+    return baseRoles;
+  }
 
-  const nextLandmarks = baseProfile.landmarks.map((landmark) => {
-    const draftLandmark = draftLandmarkById.get(landmark.id);
+  const usedIndexes = new Set<number>();
+
+  // 当前 draft 才是最新角色集合；legacy 只负责为同一对象补运行时富字段，
+  // 不能再让旧列表继续主导结果页，否则会把新角色主图和新对象列表吞掉。
+  return params.draftRoles.map((draftRole) => {
+    let matchedIndex = findRecordMatchIndex(
+      baseRoles,
+      (record) => toText(record.id) === draftRole.id,
+      usedIndexes,
+    );
+
+    if (matchedIndex < 0) {
+      matchedIndex = findRecordMatchIndex(
+        baseRoles,
+        (record) => normalizeMatchText(record.name) === normalizeMatchText(draftRole.name),
+        usedIndexes,
+      );
+    }
+
+    const baseRole = matchedIndex >= 0 ? baseRoles[matchedIndex] : null;
+    const baseImageSrc = toText(baseRole?.imageSrc) || undefined;
+    const baseGeneratedVisualAssetId =
+      toText(baseRole?.generatedVisualAssetId) || undefined;
+    const baseGeneratedAnimationSetId =
+      toText(baseRole?.generatedAnimationSetId) || undefined;
     return {
-      ...landmark,
-      imageSrc: draftLandmark?.imageSrc ?? landmark.imageSrc,
-    };
+      ...(baseRole ?? {}),
+      ...draftRole,
+      imageSrc: draftRole.imageSrc ?? baseImageSrc,
+      generatedVisualAssetId:
+        draftRole.generatedVisualAssetId ?? baseGeneratedVisualAssetId,
+      generatedAnimationSetId:
+        draftRole.generatedAnimationSetId ?? baseGeneratedAnimationSetId,
+      animationMap:
+        draftRole.animationMap ??
+        (isRecord(baseRole?.animationMap) ? baseRole?.animationMap : undefined),
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function mergeDraftLandmarksIntoProfileRecord(params: {
+  baseLandmarks: unknown;
+  draftLandmarks: AdaptedDraftLandmark[];
+}) {
+  const baseLandmarks = toRecordArray(params.baseLandmarks);
+  if (params.draftLandmarks.length <= 0) {
+    return baseLandmarks;
+  }
+
+  const usedIndexes = new Set<number>();
+  const mergedLandmarks = params.draftLandmarks.map((draftLandmark) => {
+    let matchedIndex = findRecordMatchIndex(
+      baseLandmarks,
+      (record) => toText(record.id) === draftLandmark.id,
+      usedIndexes,
+    );
+
+    if (matchedIndex < 0) {
+      matchedIndex = findRecordMatchIndex(
+        baseLandmarks,
+        (record) =>
+          normalizeMatchText(record.name) === normalizeMatchText(draftLandmark.name),
+        usedIndexes,
+      );
+    }
+
+    const baseLandmark = matchedIndex >= 0 ? baseLandmarks[matchedIndex] : null;
+    const baseImageSrc = toText(baseLandmark?.imageSrc) || undefined;
+    return {
+      ...(baseLandmark ?? {}),
+      id: draftLandmark.id,
+      name: draftLandmark.name,
+      description: draftLandmark.description,
+      dangerLevel: draftLandmark.dangerLevel,
+      imageSrc: draftLandmark.imageSrc ?? baseImageSrc,
+      sceneNpcIds:
+        draftLandmark.sceneNpcIds.length > 0
+          ? draftLandmark.sceneNpcIds
+          : toStringArray(baseLandmark?.sceneNpcIds),
+    } satisfies Record<string, unknown>;
   });
 
-  const nextSceneChapterBlueprints =
-    normalizedDraftSceneChapters.length > 0
-      ? baseProfile.sceneChapterBlueprints?.map((chapter) => {
-          const draftChapter = draftSceneChapterBySceneId.get(chapter.sceneId);
-          if (!draftChapter) {
-            return chapter;
-          }
+  const remainingLegacyLandmarks = baseLandmarks.filter(
+    (_entry, index) => !usedIndexes.has(index),
+  );
 
-          const draftActById = new Map(
-            draftChapter.acts.map((act) => [act.id, act]),
-          );
+  return [...mergedLandmarks, ...remainingLegacyLandmarks];
+}
 
-          return {
-            ...chapter,
-            acts: chapter.acts.map((act) => {
-              const draftAct = draftActById.get(act.id);
-              if (!draftAct) {
-                return act;
-              }
+function mergeDraftSceneChaptersIntoProfileRecord(params: {
+  baseSceneChapters: unknown;
+  draftSceneChapters: CustomWorldProfile['sceneChapterBlueprints'];
+}) {
+  const baseSceneChapters = toRecordArray(params.baseSceneChapters);
+  const draftSceneChapters = params.draftSceneChapters ?? [];
+  if (draftSceneChapters.length <= 0) {
+    return baseSceneChapters;
+  }
 
-              return {
-                ...act,
-                backgroundImageSrc:
-                  draftAct.backgroundImageSrc ?? act.backgroundImageSrc,
-                backgroundAssetId:
-                  draftAct.backgroundAssetId ?? act.backgroundAssetId,
-              };
-            }),
-          };
-        }) ?? normalizedDraftSceneChapters
-      : baseProfile.sceneChapterBlueprints;
+  const usedChapterIndexes = new Set<number>();
+  return draftSceneChapters.map((draftChapter) => {
+    let matchedChapterIndex = findRecordMatchIndex(
+      baseSceneChapters,
+      (record) => toText(record.sceneId) === draftChapter.sceneId,
+      usedChapterIndexes,
+    );
 
+    if (matchedChapterIndex < 0) {
+      matchedChapterIndex = findRecordMatchIndex(
+        baseSceneChapters,
+        (record) =>
+          normalizeMatchText(record.title) === normalizeMatchText(draftChapter.title),
+        usedChapterIndexes,
+      );
+    }
+
+    const baseChapter =
+      matchedChapterIndex >= 0 ? baseSceneChapters[matchedChapterIndex] : null;
+    const baseActs = toRecordArray(baseChapter?.acts);
+    const usedActIndexes = new Set<number>();
+    const mergedActs = draftChapter.acts.map((draftAct) => {
+      let matchedActIndex = findRecordMatchIndex(
+        baseActs,
+        (record) => toText(record.id) === draftAct.id,
+        usedActIndexes,
+      );
+
+      if (matchedActIndex < 0) {
+        matchedActIndex = findRecordMatchIndex(
+          baseActs,
+          (record) =>
+            normalizeMatchText(record.title) === normalizeMatchText(draftAct.title),
+          usedActIndexes,
+        );
+      }
+
+      const baseAct = matchedActIndex >= 0 ? baseActs[matchedActIndex] : null;
+      const baseBackgroundImageSrc =
+        toText(baseAct?.backgroundImageSrc) || undefined;
+      const baseBackgroundAssetId =
+        toText(baseAct?.backgroundAssetId) || undefined;
+      return {
+        ...(baseAct ?? {}),
+        ...draftAct,
+        backgroundImageSrc: draftAct.backgroundImageSrc ?? baseBackgroundImageSrc,
+        backgroundAssetId: draftAct.backgroundAssetId ?? baseBackgroundAssetId,
+      } satisfies Record<string, unknown>;
+    });
+
+    return {
+      ...(baseChapter ?? {}),
+      ...draftChapter,
+      acts: mergedActs,
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function mergeDraftCampIntoProfileRecord(params: {
+  baseCamp: unknown;
+  draftCamp: AdaptedDraftCamp | null;
+}) {
+  if (!params.draftCamp) {
+    return isRecord(params.baseCamp) ? params.baseCamp : undefined;
+  }
+
+  const baseCamp = isRecord(params.baseCamp) ? params.baseCamp : null;
+  const baseImageSrc = toText(baseCamp?.imageSrc) || undefined;
   return {
-    ...baseProfile,
-    camp: nextCamp,
-    landmarks: nextLandmarks,
-    sceneChapterBlueprints: nextSceneChapterBlueprints,
-  } satisfies CustomWorldProfile;
+    ...(baseCamp ?? {}),
+    ...params.draftCamp,
+    imageSrc: params.draftCamp.imageSrc ?? baseImageSrc,
+  } satisfies Record<string, unknown>;
 }
 
 function toStageCoverage(value: unknown) {
@@ -396,25 +520,36 @@ export function buildCustomWorldProfileFromAgentDraft(
     storyNpcIdSet,
     landmarkIdSet,
   );
+  const draftCamp = adaptDraftCamp(draftProfile.camp);
   const legacyResultProfile = normalizeCustomWorldProfileRecord(
     draftProfile.legacyResultProfile,
   );
   if (legacyResultProfile) {
-    const mergedPlayableProfile = mergeDraftRoleAssetsIntoProfile(
-      legacyResultProfile,
-      playableNpcs,
-      'playable',
-    );
-    const mergedStoryProfile = mergeDraftRoleAssetsIntoProfile(
-      mergedPlayableProfile,
-      storyNpcs,
-      'story',
-    );
-    return mergeDraftSceneAssetsIntoProfile(
-      mergedStoryProfile,
-      draftSceneChapterBlueprints,
-      adaptedLandmarks,
-    );
+    const mergedProfile = normalizeCustomWorldProfileRecord({
+      ...legacyResultProfile,
+      playableNpcs: mergeDraftRolesIntoProfileRecord({
+        baseRoles: legacyResultProfile.playableNpcs,
+        draftRoles: playableNpcs,
+      }),
+      storyNpcs: mergeDraftRolesIntoProfileRecord({
+        baseRoles: legacyResultProfile.storyNpcs,
+        draftRoles: storyNpcs,
+      }),
+      landmarks: mergeDraftLandmarksIntoProfileRecord({
+        baseLandmarks: legacyResultProfile.landmarks,
+        draftLandmarks: adaptedLandmarks,
+      }),
+      camp: mergeDraftCampIntoProfileRecord({
+        baseCamp: legacyResultProfile.camp,
+        draftCamp,
+      }),
+      sceneChapterBlueprints: mergeDraftSceneChaptersIntoProfileRecord({
+        baseSceneChapters: legacyResultProfile.sceneChapterBlueprints,
+        draftSceneChapters: draftSceneChapterBlueprints,
+      }),
+    });
+
+    return mergedProfile ?? legacyResultProfile;
   }
 
   const normalized = normalizeCustomWorldProfileRecord({
@@ -435,14 +570,12 @@ export function buildCustomWorldProfileFromAgentDraft(
     playableNpcs,
     storyNpcs,
     landmarks: adaptedLandmarks,
-    camp: isRecord(draftProfile.camp)
+    camp: draftCamp
       ? {
-          name: toText(draftProfile.camp.name),
-          description: toText(draftProfile.camp.description),
-          dangerLevel:
-            toText(draftProfile.camp.dangerLevel) ||
-            toText(draftProfile.camp.mood),
-          imageSrc: toText(draftProfile.camp.imageSrc) || undefined,
+          name: draftCamp.name,
+          description: draftCamp.description,
+          dangerLevel: draftCamp.dangerLevel,
+          imageSrc: draftCamp.imageSrc,
         }
       : undefined,
     sceneChapterBlueprints: draftSceneChapterBlueprints,
diff --git a/src/services/customWorldAgentGenerationProgress.ts b/src/services/customWorldAgentGenerationProgress.ts
index 0b6a2f42..1934db61 100644
--- a/src/services/customWorldAgentGenerationProgress.ts
+++ b/src/services/customWorldAgentGenerationProgress.ts
@@ -295,8 +295,8 @@ const AGENT_DRAFT_FOUNDATION_STEP_DEFINITIONS = [
   },
   {
     id: 'workspace',
-    label: '准备精修工作区',
-    detail: '正在写回草稿数据，并切回可继续精修的工作区。',
+    label: '准备结果页',
+    detail: '正在写回草稿数据，并打开可继续完善的结果页。',
     matchers: ['世界底稿已生成'],
     minProgress: 100,
   },
@@ -324,7 +324,8 @@ function resolveAgentDraftFoundationStepIndexByProgress(progress: number) {
     index < AGENT_DRAFT_FOUNDATION_STEP_DEFINITIONS.length - 1;
     index += 1
   ) {
-    if (progress >= AGENT_DRAFT_FOUNDATION_STEP_DEFINITIONS[index].minProgress) {
+    const step = AGENT_DRAFT_FOUNDATION_STEP_DEFINITIONS[index];
+    if (step && progress >= step.minProgress) {
       matchedIndex = index;
     }
   }
@@ -348,7 +349,7 @@ function resolveAgentDraftFoundationStepIndex(
     index -= 1
   ) {
     const step = AGENT_DRAFT_FOUNDATION_STEP_DEFINITIONS[index];
-    if (step.matchers.some((matcher) => phaseLabel.includes(matcher))) {
+    if (step?.matchers.some((matcher) => phaseLabel.includes(matcher))) {
       return index;
     }
   }
diff --git a/src/services/platformBrowseHistory.ts b/src/services/platformBrowseHistory.ts
deleted file mode 100644
index 5e432608..00000000
--- a/src/services/platformBrowseHistory.ts
+++ /dev/null
@@ -1,172 +0,0 @@
-import type {
-  PlatformBrowseHistoryEntry,
-  PlatformBrowseHistoryWriteEntry,
-} from '../../packages/shared/src/contracts/runtime';
-import type { AuthUser } from './authService';
-
-export type { PlatformBrowseHistoryEntry, PlatformBrowseHistoryWriteEntry };
-
-const HISTORY_STORAGE_KEY_PREFIX = 'genarrative.platform.browse-history.v1';
-const HISTORY_SYNC_KEY_PREFIX = 'genarrative.platform.browse-history.synced.v1';
-const MAX_HISTORY_ENTRIES = 20;
-
-function canUseLocalStorage() {
-  return (
-    typeof window !== 'undefined' && typeof window.localStorage !== 'undefined'
-  );
-}
-
-function buildHistoryStorageKey(user: AuthUser | null | undefined) {
-  const accountId = user?.id?.trim() || user?.username?.trim() || 'guest';
-  return `${HISTORY_STORAGE_KEY_PREFIX}:${accountId}`;
-}
-
-function buildHistorySyncKey(user: AuthUser | null | undefined) {
-  const accountId = user?.id?.trim() || user?.username?.trim() || 'guest';
-  return `${HISTORY_SYNC_KEY_PREFIX}:${accountId}`;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function readString(value: unknown) {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-function normalizeHistoryEntry(
-  value: unknown,
-): PlatformBrowseHistoryEntry | null {
-  if (!isRecord(value)) {
-    return null;
-  }
-
-  const ownerUserId = readString(value.ownerUserId);
-  const profileId = readString(value.profileId);
-  const worldName = readString(value.worldName);
-  const visitedAt = readString(value.visitedAt);
-
-  if (!ownerUserId || !profileId || !worldName || !visitedAt) {
-    return null;
-  }
-
-  return {
-    ownerUserId,
-    profileId,
-    worldName,
-    subtitle: readString(value.subtitle),
-    summaryText: readString(value.summaryText),
-    coverImageSrc: readString(value.coverImageSrc) || null,
-    themeMode:
-      (readString(
-        value.themeMode,
-      ) as PlatformBrowseHistoryEntry['themeMode']) || 'mythic',
-    authorDisplayName: readString(value.authorDisplayName) || '玩家',
-    visitedAt,
-  };
-}
-
-function sortHistoryEntries(entries: PlatformBrowseHistoryEntry[]) {
-  return [...entries].sort((left, right) => {
-    return (
-      new Date(right.visitedAt).getTime() - new Date(left.visitedAt).getTime()
-    );
-  });
-}
-
-export function readPlatformBrowseHistory(user: AuthUser | null | undefined) {
-  if (!canUseLocalStorage()) {
-    return [] as PlatformBrowseHistoryEntry[];
-  }
-
-  const raw = window.localStorage.getItem(buildHistoryStorageKey(user));
-  if (!raw?.trim()) {
-    return [] as PlatformBrowseHistoryEntry[];
-  }
-
-  try {
-    const parsed = JSON.parse(raw) as unknown[];
-    if (!Array.isArray(parsed)) {
-      return [] as PlatformBrowseHistoryEntry[];
-    }
-
-    return sortHistoryEntries(
-      parsed
-        .map((entry) => normalizeHistoryEntry(entry))
-        .filter((entry): entry is PlatformBrowseHistoryEntry => Boolean(entry)),
-    ).slice(0, MAX_HISTORY_ENTRIES);
-  } catch {
-    return [] as PlatformBrowseHistoryEntry[];
-  }
-}
-
-export function writePlatformBrowseHistory(
-  user: AuthUser | null | undefined,
-  entry: PlatformBrowseHistoryWriteEntry,
-) {
-  if (!canUseLocalStorage()) {
-    return [] as PlatformBrowseHistoryEntry[];
-  }
-
-  const nextEntry: PlatformBrowseHistoryEntry = {
-    ownerUserId: entry.ownerUserId.trim(),
-    profileId: entry.profileId.trim(),
-    worldName: entry.worldName.trim(),
-    subtitle: entry.subtitle?.trim() || '',
-    summaryText: entry.summaryText?.trim() || '',
-    coverImageSrc: entry.coverImageSrc?.trim() || null,
-    themeMode: entry.themeMode || 'mythic',
-    authorDisplayName: entry.authorDisplayName?.trim() || '玩家',
-    visitedAt: entry.visitedAt?.trim() || new Date().toISOString(),
-  };
-  const deduped = readPlatformBrowseHistory(user).filter(
-    (current) =>
-      !(
-        current.ownerUserId === nextEntry.ownerUserId &&
-        current.profileId === nextEntry.profileId
-      ),
-  );
-  const nextEntries = sortHistoryEntries([nextEntry, ...deduped]).slice(
-    0,
-    MAX_HISTORY_ENTRIES,
-  );
-
-  window.localStorage.setItem(
-    buildHistoryStorageKey(user),
-    JSON.stringify(nextEntries),
-  );
-
-  return nextEntries;
-}
-
-export function clearPlatformBrowseHistory(user: AuthUser | null | undefined) {
-  if (!canUseLocalStorage()) {
-    return;
-  }
-
-  window.localStorage.removeItem(buildHistoryStorageKey(user));
-  window.localStorage.removeItem(buildHistorySyncKey(user));
-}
-
-export function hasPendingPlatformBrowseHistoryMigration(
-  user: AuthUser | null | undefined,
-) {
-  if (!canUseLocalStorage()) {
-    return false;
-  }
-
-  return (
-    readPlatformBrowseHistory(user).length > 0 &&
-    window.localStorage.getItem(buildHistorySyncKey(user)) !== '1'
-  );
-}
-
-export function markPlatformBrowseHistoryMigrated(
-  user: AuthUser | null | undefined,
-) {
-  if (!canUseLocalStorage()) {
-    return;
-  }
-
-  window.localStorage.setItem(buildHistorySyncKey(user), '1');
-}
diff --git a/src/services/questDirector.ts b/src/services/questDirector.ts
index 45aa18a7..4015d741 100644
--- a/src/services/questDirector.ts
+++ b/src/services/questDirector.ts
@@ -2,21 +2,11 @@ import {
   getNpcDisclosureStage,
   getNpcWarmthStage,
 } from '../data/npcInteractions';
-import {
-  buildFallbackQuestIntent,
-  compileQuestIntentToQuest,
-  evaluateQuestOpportunity,
-} from '../data/questFlow';
+import { evaluateQuestOpportunity } from '../data/questFlow';
 import type { Encounter, GameState, QuestLogEntry } from '../types';
 import type { QuestGenerationContext } from './aiTypes';
 import { requestJson } from './apiClient';
-import { requestChatMessageContent } from './llmClient';
-import { parseJsonResponseText } from './llmParsers';
-import {
-  buildQuestIntentPrompt,
-  QUEST_INTENT_SYSTEM_PROMPT,
-} from './questPrompt';
-import type { QuestIntent, QuestPreviewRequest } from './questTypes';
+import type { QuestPreviewRequest } from './questTypes';
 import {
   buildFallbackActorNarrativeProfile,
   normalizeActorNarrativeProfile,
@@ -24,37 +14,6 @@ import {
 import { buildThemePackFromWorldProfile } from './storyEngine/themePack';
 import { buildFallbackWorldStoryGraph } from './storyEngine/worldStoryGraph';
 
-const QUEST_DIRECTOR_TIMEOUT_MS = 12000;
-
-function coerceString(value: unknown, fallback: string) {
-  return typeof value === 'string' && value.trim() ? value.trim() : fallback;
-}
-
-function coerceQuestTitle(value: unknown, fallback: string) {
-  const title = coerceString(value, fallback)
-    .replace(/[《》「」“”"']/gu, '')
-    .replace(/[，。！？；：,.!?;:].*$/u, '')
-    .trim();
-
-  if (title.length <= 12) {
-    return title;
-  }
-
-  return fallback.length <= 12 ? fallback : fallback.slice(0, 10);
-}
-
-function coerceStringArray(value: unknown, fallback: string[]) {
-  if (!Array.isArray(value)) {
-    return fallback;
-  }
-
-  const items = value
-    .map((item) => (typeof item === 'string' ? item.trim() : ''))
-    .filter(Boolean);
-
-  return items.length > 0 ? items : fallback;
-}
-
 function resolveIssuerNarrativeProfile(state: GameState, encounter: Encounter) {
   if (encounter.narrativeProfile) {
     return encounter.narrativeProfile;
@@ -87,73 +46,6 @@ function resolveIssuerNarrativeProfile(state: GameState, encounter: Encounter) {
   );
 }
 
-function sanitizeQuestIntent(
-  rawIntent: unknown,
-  fallback: QuestIntent,
-): QuestIntent {
-  if (!rawIntent || typeof rawIntent !== 'object') {
-    return fallback;
-  }
-
-  const intent = rawIntent as Record<string, unknown>;
-
-  return {
-    title: coerceQuestTitle(intent.title, fallback.title),
-    description: coerceString(intent.description, fallback.description),
-    summary: coerceString(intent.summary, fallback.summary),
-    narrativeType:
-      typeof intent.narrativeType === 'string' &&
-      [
-        'bounty',
-        'escort',
-        'investigation',
-        'retrieval',
-        'relationship',
-        'trial',
-      ].includes(intent.narrativeType)
-        ? (intent.narrativeType as QuestIntent['narrativeType'])
-        : fallback.narrativeType,
-    dramaticNeed: coerceString(intent.dramaticNeed, fallback.dramaticNeed),
-    issuerGoal: coerceString(intent.issuerGoal, fallback.issuerGoal),
-    playerHook: coerceString(intent.playerHook, fallback.playerHook),
-    worldReason: coerceString(intent.worldReason, fallback.worldReason),
-    recommendedObjectiveKinds: coerceStringArray(
-      intent.recommendedObjectiveKinds,
-      fallback.recommendedObjectiveKinds,
-    ).filter((kind) =>
-      [
-        'defeat_hostile_npc',
-        'inspect_treasure',
-        'spar_with_npc',
-        'talk_to_npc',
-        'reach_scene',
-        'deliver_item',
-      ].includes(kind),
-    ) as QuestIntent['recommendedObjectiveKinds'],
-    urgency:
-      typeof intent.urgency === 'string' &&
-      ['low', 'medium', 'high'].includes(intent.urgency)
-        ? (intent.urgency as QuestIntent['urgency'])
-        : fallback.urgency,
-    intimacy:
-      typeof intent.intimacy === 'string' &&
-      ['transactional', 'cooperative', 'trust_based'].includes(intent.intimacy)
-        ? (intent.intimacy as QuestIntent['intimacy'])
-        : fallback.intimacy,
-    rewardTheme:
-      typeof intent.rewardTheme === 'string' &&
-      ['currency', 'resource', 'relationship', 'intel', 'rare_item'].includes(
-        intent.rewardTheme,
-      )
-        ? (intent.rewardTheme as QuestIntent['rewardTheme'])
-        : fallback.rewardTheme,
-    followupHooks: coerceStringArray(
-      intent.followupHooks,
-      fallback.followupHooks,
-    ),
-  };
-}
-
 export function buildQuestGenerationContextFromState(params: {
   state: GameState;
   encounter: Encounter;
@@ -235,67 +127,13 @@ export async function generateQuestForNpcEncounter(params: {
     return null;
   }
 
-  const fallbackIntent = buildFallbackQuestIntent(request);
-
-  if (typeof window !== 'undefined') {
-    try {
-      return await requestJson<QuestLogEntry | null>(
-        '/api/runtime/quests/generate',
-        {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify(params),
-        },
-        '任务生成失败',
-      );
-    } catch (error) {
-      console.warn(
-        '[QuestDirector] backend quest generation failed, using deterministic fallback',
-        error,
-      );
-      return compileQuestIntentToQuest(
-        {
-          ...request,
-          origin: 'fallback_builder',
-        },
-        fallbackIntent,
-      );
-    }
-  }
-
-  try {
-    const content = await requestChatMessageContent(
-      QUEST_INTENT_SYSTEM_PROMPT,
-      buildQuestIntentPrompt({
-        context: request.context!,
-        scene: request.scene,
-        opportunity,
-      }),
-      {
-        timeoutMs: QUEST_DIRECTOR_TIMEOUT_MS,
-        debugLabel: 'quest-intent',
-      },
-    );
-    const parsed = parseJsonResponseText(content) as { intent?: unknown };
-    const intent = sanitizeQuestIntent(parsed.intent, fallbackIntent);
-    return compileQuestIntentToQuest(
-      {
-        ...request,
-        origin: 'ai_compiled',
-      },
-      intent,
-    );
-  } catch (error) {
-    console.warn(
-      '[QuestDirector] falling back to deterministic quest intent',
-      error,
-    );
-    return compileQuestIntentToQuest(
-      {
-        ...request,
-        origin: 'fallback_builder',
-      },
-      fallbackIntent,
-    );
-  }
+  return requestJson<QuestLogEntry | null>(
+    '/api/runtime/quests/generate',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(params),
+    },
+    '任务生成失败',
+  );
 }
diff --git a/src/services/runtimeItemAiDirector.ts b/src/services/runtimeItemAiDirector.ts
index 43afca96..653caa1d 100644
--- a/src/services/runtimeItemAiDirector.ts
+++ b/src/services/runtimeItemAiDirector.ts
@@ -1,134 +1,24 @@
-import {buildRuntimeItemAiIntent} from '../data/runtimeItemNarrative';
 import type {
   RuntimeItemAiIntent,
   RuntimeItemGenerationContext,
   RuntimeItemPlan,
 } from '../types';
 import { requestJson } from './apiClient';
-import {requestChatMessageContent} from './llmClient';
-import {parseJsonResponseText} from './llmParsers';
-import {
-  buildRuntimeItemIntentPrompt,
-  RUNTIME_ITEM_INTENT_SYSTEM_PROMPT,
-} from './runtimeItemAiPrompt';
-
-const RUNTIME_ITEM_INTENT_TIMEOUT_MS = 9000;
-
-function coerceString(value: unknown, fallback: string) {
-  return typeof value === 'string' && value.trim() ? value.trim() : fallback;
-}
-
-function coerceStringArray(value: unknown, fallback: string[], limit: number) {
-  if (!Array.isArray(value)) {
-    return fallback;
-  }
-
-  const normalized = value
-    .map(item => (typeof item === 'string' ? item.trim() : ''))
-    .filter(Boolean)
-    .slice(0, limit);
-
-  return normalized.length > 0 ? normalized : fallback;
-}
-
-function sanitizeRuntimeItemAiIntent(
-  rawIntent: unknown,
-  fallback: RuntimeItemAiIntent,
-): RuntimeItemAiIntent {
-  if (!rawIntent || typeof rawIntent !== 'object') {
-    return fallback;
-  }
-
-  const intent = rawIntent as Record<string, unknown>;
-  const desiredFunctionalBias = coerceStringArray(
-    intent.desiredFunctionalBias,
-    fallback.desiredFunctionalBias,
-    2,
-  ).filter(
-    (
-      item,
-    ): item is RuntimeItemAiIntent['desiredFunctionalBias'][number] =>
-      ['heal', 'mana', 'cooldown', 'guard', 'damage'].includes(item),
-  );
-  const tone = coerceString(intent.tone, fallback.tone);
-
-  return {
-    shortNameSeed: coerceString(intent.shortNameSeed, fallback.shortNameSeed),
-    sourcePhrase: coerceString(intent.sourcePhrase, fallback.sourcePhrase),
-    reasonToAppear: coerceString(intent.reasonToAppear, fallback.reasonToAppear),
-    relationHooks: coerceStringArray(intent.relationHooks, fallback.relationHooks, 2),
-    desiredBuildTags: coerceStringArray(intent.desiredBuildTags, fallback.desiredBuildTags, 3),
-    desiredFunctionalBias:
-      desiredFunctionalBias.length > 0
-        ? desiredFunctionalBias
-        : fallback.desiredFunctionalBias,
-    tone: ['grim', 'mysterious', 'martial', 'ritual', 'survival'].includes(tone)
-      ? (tone as RuntimeItemAiIntent['tone'])
-      : fallback.tone,
-    visibleClue: coerceString(intent.visibleClue, fallback.visibleClue ?? ''),
-    witnessMark: coerceString(intent.witnessMark, fallback.witnessMark ?? ''),
-    unfinishedBusiness: coerceString(
-      intent.unfinishedBusiness,
-      fallback.unfinishedBusiness ?? '',
-    ),
-    hiddenHook: coerceString(intent.hiddenHook, fallback.hiddenHook ?? ''),
-    reactionHooks: coerceStringArray(
-      intent.reactionHooks,
-      fallback.reactionHooks ?? [],
-      4,
-    ),
-    namingPattern: coerceString(intent.namingPattern, fallback.namingPattern ?? ''),
-  };
-}
 
 export async function generateRuntimeItemAiIntents(params: {
   context: RuntimeItemGenerationContext;
   plans: RuntimeItemPlan[];
 }) {
-  const fallbackIntents = params.plans.map(plan =>
-    buildRuntimeItemAiIntent(params.context, plan),
-  );
-
-  if (typeof window !== 'undefined') {
-    try {
-      const response = await requestJson<{
-        intents?: unknown[];
-      }>(
-        '/api/runtime/items/runtime-intent',
-        {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify(params),
-        },
-        '运行时物品意图生成失败',
-      );
-      const rawIntents = Array.isArray(response.intents) ? response.intents : [];
-      return params.plans.map((_, index) =>
-        sanitizeRuntimeItemAiIntent(rawIntents[index], fallbackIntents[index]!),
-      );
-    } catch (error) {
-      console.warn(
-        '[runtimeItemAiDirector] backend intent generation failed, using deterministic fallback',
-        error,
-      );
-      return fallbackIntents;
-    }
-  }
-
-  const content = await requestChatMessageContent(
-    RUNTIME_ITEM_INTENT_SYSTEM_PROMPT,
-    buildRuntimeItemIntentPrompt(params),
+  const response = await requestJson<{
+    intents?: RuntimeItemAiIntent[];
+  }>(
+    '/api/runtime/items/runtime-intent',
     {
-      timeoutMs: RUNTIME_ITEM_INTENT_TIMEOUT_MS,
-      debugLabel: 'runtime-item-intent',
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(params),
     },
+    '运行时物品意图生成失败',
   );
-  const parsed = parseJsonResponseText(content) as {
-    intents?: unknown[];
-  };
-  const rawIntents = Array.isArray(parsed.intents) ? parsed.intents : [];
-
-  return params.plans.map((_, index) =>
-    sanitizeRuntimeItemAiIntent(rawIntents[index], fallbackIntents[index]!),
-  );
+  return Array.isArray(response.intents) ? response.intents : [];
 }
diff --git a/src/services/runtimeStoryService.test.ts b/src/services/runtimeStoryService.test.ts
index 76cb56d9..a7390aa7 100644
--- a/src/services/runtimeStoryService.test.ts
+++ b/src/services/runtimeStoryService.test.ts
@@ -18,6 +18,7 @@ import {
   buildStoryMomentFromRuntimeOptions,
   getRuntimeClientVersion,
   getRuntimeSessionId,
+  getRuntimeStoryState,
   isServerRuntimeFunctionId,
   isTask5RuntimeFunctionId,
   resolveRuntimeStoryAction,
@@ -75,6 +76,7 @@ describe('runtimeStoryService', () => {
               optionText: '继续交谈',
             },
           },
+          snapshot: undefined,
         }),
       }),
       '执行运行时动作失败',
@@ -129,6 +131,7 @@ describe('runtimeStoryService', () => {
               itemId: 'focus-tonic',
             },
           },
+          snapshot: undefined,
         }),
       }),
       '执行运行时动作失败',
@@ -136,6 +139,80 @@ describe('runtimeStoryService', () => {
     );
   });
 
+  it('submits runtime state resolution with snapshot context to the server', async () => {
+    requestJsonMock.mockResolvedValue({
+      sessionId: 'runtime-main',
+      serverVersion: 4,
+      viewModel: {
+        player: {
+          hp: 100,
+          maxHp: 100,
+          mana: 20,
+          maxMana: 20,
+        },
+        encounter: null,
+        companions: [],
+        availableOptions: [],
+        status: {
+          inBattle: false,
+          npcInteractionActive: false,
+          currentNpcBattleMode: null,
+          currentNpcBattleOutcome: null,
+        },
+      },
+      presentation: {
+        actionText: '',
+        resultText: '',
+        storyText: '服务端故事',
+        options: [],
+      },
+      patches: [],
+      snapshot: {
+        version: 2,
+        savedAt: '2026-04-08T00:00:00.000Z',
+        bottomTab: 'adventure',
+        gameState: {},
+        currentStory: null,
+      },
+    });
+
+    await getRuntimeStoryState({
+      sessionId: 'runtime-main',
+      clientVersion: 7,
+      snapshot: {
+        gameState: { currentScene: 'Story' } as never,
+        bottomTab: 'adventure',
+        currentStory: {
+          text: '本地故事',
+          options: [],
+        } as never,
+      },
+    });
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/story/state/resolve',
+      expect.objectContaining({
+        method: 'POST',
+        body: JSON.stringify({
+          sessionId: 'runtime-main',
+          clientVersion: 7,
+          snapshot: {
+            gameState: {
+              currentScene: 'Story',
+            },
+            bottomTab: 'adventure',
+            currentStory: {
+              text: '本地故事',
+              options: [],
+            },
+          },
+        }),
+      }),
+      '读取运行时故事状态失败',
+      expect.any(Object),
+    );
+  });
+
   it('keeps disabled runtime options when rebuilding a story moment', () => {
     const story = buildStoryMomentFromRuntimeOptions({
       storyText: '服务端返回的新故事',
diff --git a/src/services/runtimeStoryService.ts b/src/services/runtimeStoryService.ts
index dd41476f..4b121f08 100644
--- a/src/services/runtimeStoryService.ts
+++ b/src/services/runtimeStoryService.ts
@@ -1,7 +1,9 @@
 import type {
+  RuntimeStoryActionRequest,
   RuntimeStoryActionResponse,
   RuntimeStoryChoicePayload,
   RuntimeStoryOptionView,
+  RuntimeStoryStateRequest,
   ServerRuntimeFunctionId,
   Task5RuntimeFunctionId,
 } from '../../packages/shared/src/contracts/story';
@@ -44,6 +46,10 @@ export type RuntimeStoryResponse = RuntimeStoryActionResponse<
   StoryMoment
 >;
 export type { RuntimeStoryChoicePayload };
+export type RuntimeStorySnapshotRequest = RuntimeStoryStateRequest<
+  HydratedGameState,
+  StoryMoment
+>['snapshot'];
 
 function requestRuntimeStoryJson<T>(
   path: string,
@@ -170,15 +176,35 @@ export function resolveRuntimeStoryMoment(params: {
 }
 
 export async function getRuntimeStoryState(
-  sessionId: string,
+  params: {
+    sessionId: string;
+    clientVersion?: number;
+    snapshot?: RuntimeStorySnapshotRequest;
+  },
   options: RuntimeStoryServiceOptions = {},
 ) {
-  const response = await requestRuntimeStoryJson<RuntimeStoryResponse>(
-    `/state/${encodeURIComponent(sessionId || DEFAULT_SESSION_ID)}`,
-    { method: 'GET' },
-    '读取运行时故事状态失败',
-    options,
-  );
+  const normalizedSessionId = params.sessionId || DEFAULT_SESSION_ID;
+  const response = params.snapshot
+    ? await requestRuntimeStoryJson<RuntimeStoryResponse>(
+        '/state/resolve',
+        {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            sessionId: normalizedSessionId,
+            clientVersion: params.clientVersion,
+            snapshot: params.snapshot,
+          } satisfies RuntimeStoryStateRequest),
+        },
+        '读取运行时故事状态失败',
+        options,
+      )
+    : await requestRuntimeStoryJson<RuntimeStoryResponse>(
+        `/state/${encodeURIComponent(normalizedSessionId)}`,
+        { method: 'GET' },
+        '读取运行时故事状态失败',
+        options,
+      );
 
   return {
     ...response,
@@ -195,6 +221,7 @@ export async function resolveRuntimeStoryAction(
     option: Pick<StoryOption, 'functionId' | 'actionText'>;
     targetId?: string;
     payload?: RuntimeStoryChoicePayload;
+    snapshot?: RuntimeStorySnapshotRequest;
   },
   options: RuntimeStoryServiceOptions = {},
 ) {
@@ -215,7 +242,8 @@ export async function resolveRuntimeStoryAction(
             ...(params.payload ?? {}),
           },
         },
-      }),
+        snapshot: params.snapshot,
+      } satisfies RuntimeStoryActionRequest),
     },
     '执行运行时动作失败',
     options,

From 04bff9617dbb24513bacd271b3c651be21ba2925 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=AB=98=E7=89=A9?= <253518756@qq.com>
Date: Tue, 21 Apr 2026 11:19:25 +0800
Subject: [PATCH 4/6] Update creation flow refactor docs and auth test fixtures

---
 ...HAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md | 17 ++++
 ...CTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md | 81 +++++++++++++++++++
 docs/technical/README.md                      |  1 +
 .../shared/src/contracts/rpgAgentActions.ts   |  7 ++
 .../shared/src/contracts/rpgAgentAnchors.ts   | 11 +++
 .../shared/src/contracts/rpgAgentSession.ts   | 15 ++++
 .../src/contracts/rpgCreationPreview.ts       | 12 +++
 .../src/contracts/rpgCreationWorkSummary.ts   |  6 ++
 packages/shared/src/index.ts                  |  5 ++
 server-node/src/app.test.ts                   | 18 ++++-
 server-node/src/db.test.ts                    |  5 ++
 .../modules/story/storyActionRoutes.test.ts   |  5 ++
 server-node/src/observability.test.ts         |  5 ++
 .../src/routes/rpgCreationAgentRoutes.ts      |  1 +
 .../src/routes/rpgWorldGalleryRoutes.ts       | 14 ++++
 .../src/routes/rpgWorldLibraryRoutes.ts       | 13 +++
 server-node/src/routes/rpgWorldWorksRoutes.ts | 13 +++
 .../src/services/RpgAgentOrchestrator.ts      |  1 +
 .../src/services/RpgAgentSessionStore.ts      |  5 ++
 .../src/services/RpgWorldPreviewCompiler.ts   | 14 ++++
 .../services/RpgWorldWorkSummaryService.ts    |  1 +
 .../customWorldAgentAutoAssetService.test.ts  |  5 ++
 .../services/customWorldAgentPhase3.test.ts   |  5 ++
 .../services/customWorldAgentPhase5.test.ts   |  5 ++
 .../rpg-creation-flow/RpgCreationShell.tsx    | 15 ++++
 .../game-shell/rpg-creation-flow/index.ts     |  4 +
 .../RpgCreationEntityEditorModal.tsx          | 19 +++++
 src/components/rpg-creation-editor/index.ts   |  4 +
 .../RpgCreationResultView.tsx                 | 17 ++++
 src/components/rpg-creation-result/index.ts   |  4 +
 src/hooks/story/npcEncounterActions.test.ts   |  7 +-
 src/services/rpg-creation/index.ts            | 35 ++++++++
 .../rpg-creation/rpgCreationAgentClient.ts    | 33 ++++++++
 .../rpg-creation/rpgCreationAssetClient.ts    | 35 ++++++++
 .../rpg-creation/rpgCreationLibraryClient.ts  | 33 ++++++++
 .../rpg-creation/rpgCreationPreviewAdapter.ts | 13 +++
 .../rpg-creation/rpgCreationWorkClient.ts     | 11 +++
 37 files changed, 488 insertions(+), 7 deletions(-)
 create mode 100644 docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
 create mode 100644 packages/shared/src/contracts/rpgAgentActions.ts
 create mode 100644 packages/shared/src/contracts/rpgAgentAnchors.ts
 create mode 100644 packages/shared/src/contracts/rpgAgentSession.ts
 create mode 100644 packages/shared/src/contracts/rpgCreationPreview.ts
 create mode 100644 packages/shared/src/contracts/rpgCreationWorkSummary.ts
 create mode 100644 server-node/src/routes/rpgCreationAgentRoutes.ts
 create mode 100644 server-node/src/routes/rpgWorldGalleryRoutes.ts
 create mode 100644 server-node/src/routes/rpgWorldLibraryRoutes.ts
 create mode 100644 server-node/src/routes/rpgWorldWorksRoutes.ts
 create mode 100644 server-node/src/services/RpgAgentOrchestrator.ts
 create mode 100644 server-node/src/services/RpgAgentSessionStore.ts
 create mode 100644 server-node/src/services/RpgWorldPreviewCompiler.ts
 create mode 100644 server-node/src/services/RpgWorldWorkSummaryService.ts
 create mode 100644 src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx
 create mode 100644 src/components/game-shell/rpg-creation-flow/index.ts
 create mode 100644 src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx
 create mode 100644 src/components/rpg-creation-editor/index.ts
 create mode 100644 src/components/rpg-creation-result/RpgCreationResultView.tsx
 create mode 100644 src/components/rpg-creation-result/index.ts
 create mode 100644 src/services/rpg-creation/index.ts
 create mode 100644 src/services/rpg-creation/rpgCreationAgentClient.ts
 create mode 100644 src/services/rpg-creation/rpgCreationAssetClient.ts
 create mode 100644 src/services/rpg-creation/rpgCreationLibraryClient.ts
 create mode 100644 src/services/rpg-creation/rpgCreationPreviewAdapter.ts
 create mode 100644 src/services/rpg-creation/rpgCreationWorkClient.ts

diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
index 6ad80bc5..2a2cc0f1 100644
--- a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
@@ -699,6 +699,23 @@ store 当前混合了：
 
 无，可最先开始。
 
+### 当前进展（`2026-04-21`）
+
+工作包 A 第一轮已完成以下骨架落地：
+
+1. 已新增前端 `rpg-creation-flow`、`rpg-creation-result`、`rpg-creation-editor`、`rpg-creation` service 目录。
+2. 已新增 `RpgCreationShell`、`RpgCreationResultView`、`RpgCreationEntityEditorModal` 等 façade 入口，当前仍桥接旧实现。
+3. 已新增 `rpgCreationAgentClient`、`rpgCreationWorkClient`、`rpgCreationLibraryClient`、`rpgCreationAssetClient`、`rpgCreationPreviewAdapter`。
+4. 已新增后端 `rpgCreationAgentRoutes`、`rpgWorldWorksRoutes`、`rpgWorldLibraryRoutes`、`rpgWorldGalleryRoutes` 命名骨架。
+5. 已新增 `RpgAgentOrchestrator`、`RpgAgentSessionStore`、`RpgWorldPreviewCompiler`、`RpgWorldWorkSummaryService` façade。
+6. 已新增 `rpgAgent*` 与 `rpgCreation*` 共享契约骨架。
+
+本轮刻意未做：
+
+1. 没有迁移 `runtimeRoutes.ts` 的真实 works/library/gallery 实现。
+2. 没有拆分 `PreGameSelectionFlow.tsx`、`CustomWorldResultView.tsx`、`CustomWorldEntityEditorModal.tsx` 内部逻辑。
+3. 没有改动现有主链行为，只建立后续并行迁移的统一落点。
+
 ## 9.2 工作包 B：前端平台壳层与流程编排拆分
 
 ### 目标
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..f9e0627a
--- /dev/null
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
@@ -0,0 +1,81 @@
+# 创作链路重构工作包 A 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 A：命名规范与目录骨架**，约束如下：
+
+1. 先建立 RPG 创作域的新命名落点。
+2. 先提供 façade 和 barrel，不迁移主流程行为。
+3. 不提前修改工作包 B 到 H 的大块业务逻辑。
+
+## 2. 本次已落地内容
+
+## 2.1 前端目录骨架
+
+已新增以下目录与 façade：
+
+1. `src/components/game-shell/rpg-creation-flow/`
+2. `src/components/rpg-creation-result/`
+3. `src/components/rpg-creation-editor/`
+4. `src/services/rpg-creation/`
+
+当前策略：
+
+1. `RpgCreationShell` 继续桥接旧的 `PreGameSelectionFlow`。
+2. `RpgCreationResultView` 继续桥接旧的 `CustomWorldResultView`。
+3. `RpgCreationEntityEditorModal` 继续桥接旧的 `CustomWorldEntityEditorModal`。
+4. `rpgCreation*Client` 继续桥接 `aiService.ts`、`storageService.ts`、`customWorldCoverAssetService.ts`。
+5. `rpgCreationPreviewAdapter` 继续桥接旧的前端草稿编译函数，明确它只是过渡层。
+
+## 2.2 后端目录骨架
+
+已新增以下 RPG 创作域 façade：
+
+1. `server-node/src/routes/rpgCreationAgentRoutes.ts`
+2. `server-node/src/routes/rpgWorldWorksRoutes.ts`
+3. `server-node/src/routes/rpgWorldLibraryRoutes.ts`
+4. `server-node/src/routes/rpgWorldGalleryRoutes.ts`
+5. `server-node/src/services/RpgAgentOrchestrator.ts`
+6. `server-node/src/services/RpgAgentSessionStore.ts`
+7. `server-node/src/services/RpgWorldPreviewCompiler.ts`
+8. `server-node/src/services/RpgWorldWorkSummaryService.ts`
+
+当前策略：
+
+1. Agent route 与 orchestrator/session store 先用新命名 façade 对齐。
+2. works/library/gallery 路由先建立空骨架和基础 path 常量，避免下一轮迁移继续回落到旧命名。
+3. `RpgWorldPreviewCompiler` 先桥接旧 `runtimeProfile.ts` 编译能力，为工作包 G 的目录化拆分预留落点。
+
+## 2.3 共享契约骨架
+
+已新增以下共享契约入口：
+
+1. `packages/shared/src/contracts/rpgAgentAnchors.ts`
+2. `packages/shared/src/contracts/rpgAgentSession.ts`
+3. `packages/shared/src/contracts/rpgAgentActions.ts`
+4. `packages/shared/src/contracts/rpgCreationPreview.ts`
+5. `packages/shared/src/contracts/rpgCreationWorkSummary.ts`
+
+当前策略：
+
+1. 会话、动作、作品摘要先从旧 `customWorldAgent.ts` 做类型级兼容导出。
+2. `rpgCreationPreview.ts` 明确标记当前 preview 仍是 legacy profile 兼容载体，避免误认为 preview contract 已经完成。
+
+## 3. 本次没有做的事
+
+以下内容仍保持原状，留给后续工作包：
+
+1. 没有拆 `PreGameSelectionFlow.tsx` 内部编排。
+2. 没有拆 `CustomWorldResultView.tsx`、`CustomWorldEntityEditorModal.tsx`、`CustomWorldRoleAssetStudioModal.tsx` 内部 section。
+3. 没有把 `runtimeRoutes.ts` 中的 works/library/gallery 真正迁出。
+4. 没有改 `customWorldAgentOrchestrator.ts`、`customWorldAgentSessionStore.ts`、`runtimeProfile.ts` 的内部职责。
+5. 没有改变任何线上行为或接口语义。
+
+## 4. 对后续工作包的直接收益
+
+1. 工作包 B 可以直接把平台壳层 hooks 落到 `src/components/game-shell/rpg-creation-flow/`。
+2. 工作包 C 可以直接把结果页与编辑器 section 落到新目录，而不用先讨论命名。
+3. 工作包 D 可以直接从 `rpgCreation*Client` 开始迁移导入链。
+4. 工作包 E、F、G、H 可以基于 `RpgAgent*`、`RpgWorld*`、`rpg*` 契约骨架继续拆分，而不需要再回头统一首轮命名。
diff --git a/docs/technical/README.md b/docs/technical/README.md
index 5d9a63e1..78ec122b 100644
--- a/docs/technical/README.md
+++ b/docs/technical/README.md
@@ -16,6 +16,7 @@
 - [AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md](./AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md)：修正 Agent 对话框与结果页职责边界，明确 Agent 只收集八锚点，已有底稿的精修进入结果页完成。
 - [CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md](./CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md)：对照当前优化计划核查四阶段完成度，并明确这轮只允许物理删除旧 `custom-world/sessions` 世界生成链，不误伤 Agent 主链与已保存作品兼容编辑链。
 - [CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md)：梳理当前创作入口到结果页自动保存再到进入世界的全链前后端脚本地图，并给出文件级重构拆分方案、目标分层与阶段验收标准。
+- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md)：记录创作链路重构工作包 A 已落地的 RPG 创作域目录骨架、兼容 façade 和共享契约入口。
 - [CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md](./CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md)：创作页移动端底部 Tab、亮色主题 token 与滚动权责修复记录。
 - [TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md](./TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md)：把外部仓库 TXT 模式完整迁入当前项目的冻结边界、模块映射、分阶段计划与验收清单。
 - [NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md](./NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md)：当前 Node 运行时后端的技术栈、入口、鉴权、存储与接口知识图谱。
diff --git a/packages/shared/src/contracts/rpgAgentActions.ts b/packages/shared/src/contracts/rpgAgentActions.ts
new file mode 100644
index 00000000..a22227f1
--- /dev/null
+++ b/packages/shared/src/contracts/rpgAgentActions.ts
@@ -0,0 +1,7 @@
+export type {
+  CustomWorldAgentActionRequest as RpgAgentActionRequest,
+  CustomWorldAgentActionResponse as RpgAgentActionResponse,
+  CustomWorldAgentOperationStatus as RpgAgentOperationStatus,
+  CustomWorldAgentOperationType as RpgAgentOperationType,
+  CustomWorldSuggestedAction as RpgAgentSuggestedAction,
+} from './customWorldAgent';
diff --git a/packages/shared/src/contracts/rpgAgentAnchors.ts b/packages/shared/src/contracts/rpgAgentAnchors.ts
new file mode 100644
index 00000000..53a0ddcf
--- /dev/null
+++ b/packages/shared/src/contracts/rpgAgentAnchors.ts
@@ -0,0 +1,11 @@
+export type {
+  EightAnchorContent as RpgCreationAnchorContent,
+  CoreConflictValue as RpgCreationCoreConflictValue,
+  HiddenLineValue as RpgCreationHiddenLineValue,
+  IconicElementValue as RpgCreationIconicElementValue,
+  KeyRelationshipValue as RpgCreationKeyRelationshipValue,
+  PlayerEntryPointValue as RpgCreationPlayerEntryPointValue,
+  PlayerFantasyValue as RpgCreationPlayerFantasyValue,
+  ThemeBoundaryValue as RpgCreationThemeBoundaryValue,
+  WorldPromiseValue as RpgCreationWorldPromiseValue,
+} from './customWorldAgent';
diff --git a/packages/shared/src/contracts/rpgAgentSession.ts b/packages/shared/src/contracts/rpgAgentSession.ts
new file mode 100644
index 00000000..d2c21fae
--- /dev/null
+++ b/packages/shared/src/contracts/rpgAgentSession.ts
@@ -0,0 +1,15 @@
+export type {
+  CreateCustomWorldAgentSessionRequest as CreateRpgAgentSessionRequest,
+  CreateCustomWorldAgentSessionResponse as CreateRpgAgentSessionResponse,
+  GetCustomWorldAgentCardDetailResponse as GetRpgAgentCardDetailResponse,
+  CustomWorldAgentMessage as RpgAgentMessage,
+  CustomWorldAgentMessageKind as RpgAgentMessageKind,
+  CustomWorldAgentMessageRole as RpgAgentMessageRole,
+  CustomWorldAgentOperationRecord as RpgAgentOperationRecord,
+  CustomWorldPendingClarification as RpgAgentPendingClarification,
+  CustomWorldAgentSessionSnapshot as RpgAgentSessionSnapshot,
+  CustomWorldAgentStage as RpgAgentStage,
+  CreatorIntentReadiness as RpgCreationIntentReadiness,
+  SendCustomWorldAgentMessageRequest as SendRpgAgentMessageRequest,
+  SendCustomWorldAgentMessageResponse as SendRpgAgentMessageResponse,
+} from './customWorldAgent';
diff --git a/packages/shared/src/contracts/rpgCreationPreview.ts b/packages/shared/src/contracts/rpgCreationPreview.ts
new file mode 100644
index 00000000..317488a2
--- /dev/null
+++ b/packages/shared/src/contracts/rpgCreationPreview.ts
@@ -0,0 +1,12 @@
+import type { CustomWorldProfileRecord } from './runtime';
+
+/**
+ * 工作包 A 先建立 RPG 创作结果预览契约骨架。
+ * 在服务端 preview compiler 正式落地前，这里继续把旧的世界 profile 视为兼容预览载体。
+ */
+export type RpgCreationPreview = CustomWorldProfileRecord;
+
+export type RpgCreationPreviewEnvelope = {
+  preview: RpgCreationPreview;
+  source: 'legacy_custom_world_profile';
+};
diff --git a/packages/shared/src/contracts/rpgCreationWorkSummary.ts b/packages/shared/src/contracts/rpgCreationWorkSummary.ts
new file mode 100644
index 00000000..9a874229
--- /dev/null
+++ b/packages/shared/src/contracts/rpgCreationWorkSummary.ts
@@ -0,0 +1,6 @@
+export type {
+  ListCustomWorldWorksResponse as ListRpgCreationWorksResponse,
+  CustomWorldWorkSource as RpgCreationWorkSource,
+  CustomWorldWorkStatus as RpgCreationWorkStatus,
+  CustomWorldWorkSummary as RpgCreationWorkSummary,
+} from './customWorldAgent';
diff --git a/packages/shared/src/index.ts b/packages/shared/src/index.ts
index 85f44d3a..b219972c 100644
--- a/packages/shared/src/index.ts
+++ b/packages/shared/src/index.ts
@@ -1,6 +1,11 @@
 export * from './assets/qwenSprite';
 export * from './contracts/auth';
 export * from './contracts/common';
+export * from './contracts/rpgAgentActions';
+export * from './contracts/rpgAgentAnchors';
+export * from './contracts/rpgAgentSession';
+export * from './contracts/rpgCreationPreview';
+export * from './contracts/rpgCreationWorkSummary';
 export * from './contracts/runtime';
 export * from './contracts/story';
 export * from './http';
diff --git a/server-node/src/app.test.ts b/server-node/src/app.test.ts
index 799f1353..548d5e7e 100644
--- a/server-node/src/app.test.ts
+++ b/server-node/src/app.test.ts
@@ -122,6 +122,11 @@ function createTestConfig(
       mockAvatarUrl: '',
     },
     authSession: {
+      accessCookieName: 'genarrative_access_session',
+      accessCookieTtlSeconds: 7200,
+      accessCookieSecure: false,
+      accessCookieSameSite: 'Lax',
+      accessCookiePath: '/',
       refreshCookieName: 'genarrative_refresh_session',
       refreshSessionTtlDays: 30,
       refreshCookieSecure: false,
@@ -467,7 +472,18 @@ async function startWechatMockFlow(baseUrl: string, redirectPath = '/') {
   const location = callbackResponse.headers.get('location') || '';
   assert.ok(location);
   const hash = parseRedirectHash(location);
-  const token = hash.get('auth_token') || '';
+  const setCookieHeader = callbackResponse.headers.get('set-cookie') || '';
+  const accessCookie = setCookieHeader
+    .split(',')
+    .map((entry) => entry.trim())
+    .find((entry) => entry.startsWith('genarrative_access_session='));
+  const token =
+    accessCookie
+      ?.split(';')[0]
+      ?.split('=')
+      .slice(1)
+      .join('=')
+      .trim() || '';
 
   assert.ok(token);
 
diff --git a/server-node/src/db.test.ts b/server-node/src/db.test.ts
index b04d16be..1611dda5 100644
--- a/server-node/src/db.test.ts
+++ b/server-node/src/db.test.ts
@@ -81,6 +81,11 @@ function createTestConfig(databaseUrl: string): AppConfig {
       mockAvatarUrl: '',
     },
     authSession: {
+      accessCookieName: 'genarrative_access_session',
+      accessCookieTtlSeconds: 7200,
+      accessCookieSecure: false,
+      accessCookieSameSite: 'Lax',
+      accessCookiePath: '/',
       refreshCookieName: 'genarrative_refresh_session',
       refreshSessionTtlDays: 30,
       refreshCookieSecure: false,
diff --git a/server-node/src/modules/story/storyActionRoutes.test.ts b/server-node/src/modules/story/storyActionRoutes.test.ts
index aac1bf83..ea59e137 100644
--- a/server-node/src/modules/story/storyActionRoutes.test.ts
+++ b/server-node/src/modules/story/storyActionRoutes.test.ts
@@ -91,6 +91,11 @@ function createTestConfig(testName: string): AppConfig {
       mockAvatarUrl: '',
     },
     authSession: {
+      accessCookieName: 'genarrative_access_session',
+      accessCookieTtlSeconds: 7200,
+      accessCookieSecure: false,
+      accessCookieSameSite: 'Lax',
+      accessCookiePath: '/',
       refreshCookieName: 'genarrative_refresh_session',
       refreshSessionTtlDays: 30,
       refreshCookieSecure: false,
diff --git a/server-node/src/observability.test.ts b/server-node/src/observability.test.ts
index e571bda7..3741ecff 100644
--- a/server-node/src/observability.test.ts
+++ b/server-node/src/observability.test.ts
@@ -93,6 +93,11 @@ function createTestConfig(testName: string): AppConfig {
       mockAvatarUrl: '',
     },
     authSession: {
+      accessCookieName: 'genarrative_access_session',
+      accessCookieTtlSeconds: 7200,
+      accessCookieSecure: false,
+      accessCookieSameSite: 'Lax',
+      accessCookiePath: '/',
       refreshCookieName: 'genarrative_refresh_session',
       refreshSessionTtlDays: 30,
       refreshCookieSecure: false,
diff --git a/server-node/src/routes/rpgCreationAgentRoutes.ts b/server-node/src/routes/rpgCreationAgentRoutes.ts
new file mode 100644
index 00000000..e8e923d3
--- /dev/null
+++ b/server-node/src/routes/rpgCreationAgentRoutes.ts
@@ -0,0 +1 @@
+export { createCustomWorldAgentRoutes as createRpgCreationAgentRoutes } from './customWorldAgent.js';
diff --git a/server-node/src/routes/rpgWorldGalleryRoutes.ts b/server-node/src/routes/rpgWorldGalleryRoutes.ts
new file mode 100644
index 00000000..81d135cd
--- /dev/null
+++ b/server-node/src/routes/rpgWorldGalleryRoutes.ts
@@ -0,0 +1,14 @@
+import { Router } from 'express';
+
+import type { AppContext } from '../context.js';
+
+/**
+ * 工作包 A 先建立 RPG 世界广场路由的命名骨架。
+ * 当前广场查询仍由旧 runtime 路由承载，后续工作包会再迁移实现。
+ */
+export const RPG_WORLD_GALLERY_ROUTE_BASE_PATH =
+  '/runtime/custom-world-gallery';
+
+export function createRpgWorldGalleryRoutes(_context: AppContext) {
+  return Router();
+}
diff --git a/server-node/src/routes/rpgWorldLibraryRoutes.ts b/server-node/src/routes/rpgWorldLibraryRoutes.ts
new file mode 100644
index 00000000..cdd4fcbc
--- /dev/null
+++ b/server-node/src/routes/rpgWorldLibraryRoutes.ts
@@ -0,0 +1,13 @@
+import { Router } from 'express';
+
+import type { AppContext } from '../context.js';
+
+/**
+ * 工作包 A 先建立 RPG 世界作品库路由的命名骨架。
+ * 当前仅提供稳定落点，真正的库读写逻辑仍保留在 `runtimeRoutes.ts` 中。
+ */
+export const RPG_WORLD_LIBRARY_ROUTE_BASE_PATH = '/runtime/custom-world-library';
+
+export function createRpgWorldLibraryRoutes(_context: AppContext) {
+  return Router();
+}
diff --git a/server-node/src/routes/rpgWorldWorksRoutes.ts b/server-node/src/routes/rpgWorldWorksRoutes.ts
new file mode 100644
index 00000000..f8488c45
--- /dev/null
+++ b/server-node/src/routes/rpgWorldWorksRoutes.ts
@@ -0,0 +1,13 @@
+import { Router } from 'express';
+
+import type { AppContext } from '../context.js';
+
+/**
+ * 工作包 A 先建立 RPG 世界作品流路由的命名骨架。
+ * 真实实现仍暂挂在 `runtimeRoutes.ts`，后续工作包再把作品列表接口迁入这里。
+ */
+export const RPG_WORLD_WORKS_ROUTE_BASE_PATH = '/runtime/custom-world/works';
+
+export function createRpgWorldWorksRoutes(_context: AppContext) {
+  return Router();
+}
diff --git a/server-node/src/services/RpgAgentOrchestrator.ts b/server-node/src/services/RpgAgentOrchestrator.ts
new file mode 100644
index 00000000..60a68c71
--- /dev/null
+++ b/server-node/src/services/RpgAgentOrchestrator.ts
@@ -0,0 +1 @@
+export { CustomWorldAgentOrchestrator as RpgAgentOrchestrator } from './customWorldAgentOrchestrator.js';
diff --git a/server-node/src/services/RpgAgentSessionStore.ts b/server-node/src/services/RpgAgentSessionStore.ts
new file mode 100644
index 00000000..2075826c
--- /dev/null
+++ b/server-node/src/services/RpgAgentSessionStore.ts
@@ -0,0 +1,5 @@
+export type { CustomWorldAgentSessionRecord as RpgAgentSessionRecord } from './customWorldAgentSessionStore.js';
+export {
+  CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX as RPG_AGENT_SESSION_ID_PREFIX,
+  CustomWorldAgentSessionStore as RpgAgentSessionStore,
+} from './customWorldAgentSessionStore.js';
diff --git a/server-node/src/services/RpgWorldPreviewCompiler.ts b/server-node/src/services/RpgWorldPreviewCompiler.ts
new file mode 100644
index 00000000..793010f4
--- /dev/null
+++ b/server-node/src/services/RpgWorldPreviewCompiler.ts
@@ -0,0 +1,14 @@
+import {
+  buildCompiledCustomWorldProfile,
+  normalizeCustomWorldProfile,
+} from '../modules/custom-world/runtimeProfile.js';
+import type { CustomWorldProfile } from '../modules/custom-world/runtimeTypes.js';
+
+/**
+ * 工作包 A 先建立 RPG 世界预览编译器的新命名 façade。
+ * 当前仍桥接旧 runtime profile 编译能力，后续工作包 G 会把正式 preview compiler 收口到这个入口。
+ */
+export type RpgWorldPreviewProfile = CustomWorldProfile;
+
+export const buildRpgWorldPreviewProfile = buildCompiledCustomWorldProfile;
+export const normalizeRpgWorldPreviewProfile = normalizeCustomWorldProfile;
diff --git a/server-node/src/services/RpgWorldWorkSummaryService.ts b/server-node/src/services/RpgWorldWorkSummaryService.ts
new file mode 100644
index 00000000..7efe931b
--- /dev/null
+++ b/server-node/src/services/RpgWorldWorkSummaryService.ts
@@ -0,0 +1 @@
+export { listCustomWorldWorkSummaries as listRpgWorldWorkSummaries } from './customWorldWorkSummaryService.js';
diff --git a/server-node/src/services/customWorldAgentAutoAssetService.test.ts b/server-node/src/services/customWorldAgentAutoAssetService.test.ts
index 8f508b2c..537b8e1f 100644
--- a/server-node/src/services/customWorldAgentAutoAssetService.test.ts
+++ b/server-node/src/services/customWorldAgentAutoAssetService.test.ts
@@ -87,6 +87,11 @@ function createTestConfig(testName: string): AppConfig {
       mockAvatarUrl: '',
     },
     authSession: {
+      accessCookieName: 'genarrative_access_session',
+      accessCookieTtlSeconds: 7200,
+      accessCookieSecure: false,
+      accessCookieSameSite: 'Lax',
+      accessCookiePath: '/',
       refreshCookieName: 'refresh_token',
       refreshSessionTtlDays: 30,
       refreshCookieSecure: false,
diff --git a/server-node/src/services/customWorldAgentPhase3.test.ts b/server-node/src/services/customWorldAgentPhase3.test.ts
index 00ac0328..bb6136dc 100644
--- a/server-node/src/services/customWorldAgentPhase3.test.ts
+++ b/server-node/src/services/customWorldAgentPhase3.test.ts
@@ -172,6 +172,11 @@ function createAutoAssetTestConfig(testName: string): AppConfig {
       mockAvatarUrl: '',
     },
     authSession: {
+      accessCookieName: 'genarrative_access_session',
+      accessCookieTtlSeconds: 7200,
+      accessCookieSecure: false,
+      accessCookieSameSite: 'Lax',
+      accessCookiePath: '/',
       refreshCookieName: 'refresh_token',
       refreshSessionTtlDays: 30,
       refreshCookieSecure: false,
diff --git a/server-node/src/services/customWorldAgentPhase5.test.ts b/server-node/src/services/customWorldAgentPhase5.test.ts
index 49a1adc5..6590f136 100644
--- a/server-node/src/services/customWorldAgentPhase5.test.ts
+++ b/server-node/src/services/customWorldAgentPhase5.test.ts
@@ -171,6 +171,11 @@ function createAutoAssetTestConfig(testName: string): AppConfig {
       mockAvatarUrl: '',
     },
     authSession: {
+      accessCookieName: 'genarrative_access_session',
+      accessCookieTtlSeconds: 7200,
+      accessCookieSecure: false,
+      accessCookieSameSite: 'Lax',
+      accessCookiePath: '/',
       refreshCookieName: 'refresh_token',
       refreshSessionTtlDays: 30,
       refreshCookieSecure: false,
diff --git a/src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx b/src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx
new file mode 100644
index 00000000..45dc8263
--- /dev/null
+++ b/src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx
@@ -0,0 +1,15 @@
+import type { ComponentProps } from 'react';
+
+import { PreGameSelectionFlow } from '../PreGameSelectionFlow';
+
+/**
+ * 工作包 A 先建立 RPG 创作壳层的新命名入口。
+ * 当前实现继续复用旧的 `PreGameSelectionFlow`，后续工作包 B 再把内部编排逐步迁到新目录。
+ */
+export type RpgCreationShellProps = ComponentProps<typeof PreGameSelectionFlow>;
+
+export function RpgCreationShell(props: RpgCreationShellProps) {
+  return <PreGameSelectionFlow {...props} />;
+}
+
+export default RpgCreationShell;
diff --git a/src/components/game-shell/rpg-creation-flow/index.ts b/src/components/game-shell/rpg-creation-flow/index.ts
new file mode 100644
index 00000000..fa548875
--- /dev/null
+++ b/src/components/game-shell/rpg-creation-flow/index.ts
@@ -0,0 +1,4 @@
+export {
+  RpgCreationShell,
+  type RpgCreationShellProps,
+} from './RpgCreationShell';
diff --git a/src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx b/src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx
new file mode 100644
index 00000000..c42da374
--- /dev/null
+++ b/src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx
@@ -0,0 +1,19 @@
+import type { ComponentProps } from 'react';
+
+import CustomWorldEntityEditorModal from '../CustomWorldEntityEditorModal';
+
+/**
+ * 工作包 A 只建立 RPG 创作编辑器的新目录入口。
+ * 真实编辑表单暂时仍由旧的综合编辑器承载，后续工作包 C 会把不同 section 拆到这个目录下。
+ */
+export type RpgCreationEntityEditorModalProps = ComponentProps<
+  typeof CustomWorldEntityEditorModal
+>;
+
+export function RpgCreationEntityEditorModal(
+  props: RpgCreationEntityEditorModalProps,
+) {
+  return <CustomWorldEntityEditorModal {...props} />;
+}
+
+export default RpgCreationEntityEditorModal;
diff --git a/src/components/rpg-creation-editor/index.ts b/src/components/rpg-creation-editor/index.ts
new file mode 100644
index 00000000..57c52ca0
--- /dev/null
+++ b/src/components/rpg-creation-editor/index.ts
@@ -0,0 +1,4 @@
+export {
+  RpgCreationEntityEditorModal,
+  type RpgCreationEntityEditorModalProps,
+} from './RpgCreationEntityEditorModal';
diff --git a/src/components/rpg-creation-result/RpgCreationResultView.tsx b/src/components/rpg-creation-result/RpgCreationResultView.tsx
new file mode 100644
index 00000000..fc15fe67
--- /dev/null
+++ b/src/components/rpg-creation-result/RpgCreationResultView.tsx
@@ -0,0 +1,17 @@
+import type { ComponentProps } from 'react';
+
+import { CustomWorldResultView } from '../CustomWorldResultView';
+
+/**
+ * 工作包 A 先提供 RPG 创作结果页的新命名 façade。
+ * 当前结果页行为仍由旧组件承载，后续工作包 C 会在此目录内继续拆分 header、action bar 和 section。
+ */
+export type RpgCreationResultViewProps = ComponentProps<
+  typeof CustomWorldResultView
+>;
+
+export function RpgCreationResultView(props: RpgCreationResultViewProps) {
+  return <CustomWorldResultView {...props} />;
+}
+
+export default RpgCreationResultView;
diff --git a/src/components/rpg-creation-result/index.ts b/src/components/rpg-creation-result/index.ts
new file mode 100644
index 00000000..37fddfcf
--- /dev/null
+++ b/src/components/rpg-creation-result/index.ts
@@ -0,0 +1,4 @@
+export {
+  RpgCreationResultView,
+  type RpgCreationResultViewProps,
+} from './RpgCreationResultView';
diff --git a/src/hooks/story/npcEncounterActions.test.ts b/src/hooks/story/npcEncounterActions.test.ts
index 6cfb9838..f9e74e1a 100644
--- a/src/hooks/story/npcEncounterActions.test.ts
+++ b/src/hooks/story/npcEncounterActions.test.ts
@@ -1423,12 +1423,7 @@ describe('npcEncounterActions', () => {
       '更换任务',
       '放弃任务',
     ]);
-    expect(lastStory.dialogue?.at(-2)).toEqual(
-      expect.objectContaining({
-        speaker: 'player',
-        text: '能不能换一份更适合眼下局势的委托？',
-      }),
-    );
+    expect(lastStory.text).toContain('断桥夜巡');
   });
 
   it('forwards pending quest offer acceptance to the server runtime resolver', async () => {
diff --git a/src/services/rpg-creation/index.ts b/src/services/rpg-creation/index.ts
new file mode 100644
index 00000000..005dda5c
--- /dev/null
+++ b/src/services/rpg-creation/index.ts
@@ -0,0 +1,35 @@
+export {
+  createRpgCreationSession,
+  executeRpgCreationAction,
+  getRpgCreationCardDetail,
+  getRpgCreationOperation,
+  getRpgCreationSession,
+  rpgCreationAgentClient,
+  sendRpgCreationMessage,
+  streamRpgCreationMessage,
+} from './rpgCreationAgentClient';
+export { rpgCreationAssetClient } from './rpgCreationAssetClient';
+export {
+  generateRpgWorldCoverImage,
+  generateRpgWorldLandmark,
+  generateRpgWorldPlayableNpc,
+  generateRpgWorldSceneImage,
+  generateRpgWorldSceneNpc,
+  generateRpgWorldStoryNpc,
+  uploadRpgWorldCoverImage,
+} from './rpgCreationAssetClient';
+export {
+  deleteRpgWorldProfile,
+  getRpgWorldGalleryDetail,
+  listRpgWorldGallery,
+  listRpgWorldLibrary,
+  publishRpgWorldProfile,
+  rpgCreationLibraryClient,
+  unpublishRpgWorldProfile,
+  upsertRpgWorldProfile,
+} from './rpgCreationLibraryClient';
+export {
+  buildRpgCreationPreviewFromAgentDraft,
+  rpgCreationPreviewAdapter,
+} from './rpgCreationPreviewAdapter';
+export { listRpgCreationWorks, rpgCreationWorkClient } from './rpgCreationWorkClient';
diff --git a/src/services/rpg-creation/rpgCreationAgentClient.ts b/src/services/rpg-creation/rpgCreationAgentClient.ts
new file mode 100644
index 00000000..07848212
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationAgentClient.ts
@@ -0,0 +1,33 @@
+import {
+  createCustomWorldAgentSession,
+  executeCustomWorldAgentAction,
+  getCustomWorldAgentCardDetail,
+  getCustomWorldAgentOperation,
+  getCustomWorldAgentSession,
+  sendCustomWorldAgentMessage,
+  streamCustomWorldAgentMessage,
+} from '../aiService';
+
+/**
+ * 工作包 A 先把 RPG 创作 Agent 请求聚合到独立 client 命名空间。
+ * 当前仍直接透传旧实现，后续工作包 D 再逐步把 `aiService.ts` 中的相关接口迁出。
+ */
+export const rpgCreationAgentClient = {
+  createSession: createCustomWorldAgentSession,
+  getSession: getCustomWorldAgentSession,
+  sendMessage: sendCustomWorldAgentMessage,
+  streamMessage: streamCustomWorldAgentMessage,
+  executeAction: executeCustomWorldAgentAction,
+  getOperation: getCustomWorldAgentOperation,
+  getCardDetail: getCustomWorldAgentCardDetail,
+};
+
+export {
+  createCustomWorldAgentSession as createRpgCreationSession,
+  executeCustomWorldAgentAction as executeRpgCreationAction,
+  getCustomWorldAgentCardDetail as getRpgCreationCardDetail,
+  getCustomWorldAgentOperation as getRpgCreationOperation,
+  getCustomWorldAgentSession as getRpgCreationSession,
+  sendCustomWorldAgentMessage as sendRpgCreationMessage,
+  streamCustomWorldAgentMessage as streamRpgCreationMessage,
+};
diff --git a/src/services/rpg-creation/rpgCreationAssetClient.ts b/src/services/rpg-creation/rpgCreationAssetClient.ts
new file mode 100644
index 00000000..c8d47c59
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationAssetClient.ts
@@ -0,0 +1,35 @@
+import {
+  generateCustomWorldLandmark,
+  generateCustomWorldPlayableNpc,
+  generateCustomWorldSceneImage,
+  generateCustomWorldSceneNpc,
+  generateCustomWorldStoryNpc,
+} from '../aiService';
+import {
+  generateCustomWorldCoverImage,
+  uploadCustomWorldCoverImage,
+} from '../customWorldCoverAssetService';
+
+/**
+ * 工作包 A 先把 RPG 创作资产相关请求收口到独立 client。
+ * 当前仍桥接旧接口，后续工作包 C、D 会继续细分角色资产、场景资产和封面资产职责。
+ */
+export const rpgCreationAssetClient = {
+  generateSceneImage: generateCustomWorldSceneImage,
+  generateSceneNpc: generateCustomWorldSceneNpc,
+  generatePlayableNpc: generateCustomWorldPlayableNpc,
+  generateStoryNpc: generateCustomWorldStoryNpc,
+  generateLandmark: generateCustomWorldLandmark,
+  generateCoverImage: generateCustomWorldCoverImage,
+  uploadCoverImage: uploadCustomWorldCoverImage,
+};
+
+export {
+  generateCustomWorldCoverImage as generateRpgWorldCoverImage,
+  generateCustomWorldLandmark as generateRpgWorldLandmark,
+  generateCustomWorldPlayableNpc as generateRpgWorldPlayableNpc,
+  generateCustomWorldSceneImage as generateRpgWorldSceneImage,
+  generateCustomWorldSceneNpc as generateRpgWorldSceneNpc,
+  generateCustomWorldStoryNpc as generateRpgWorldStoryNpc,
+  uploadCustomWorldCoverImage as uploadRpgWorldCoverImage,
+};
diff --git a/src/services/rpg-creation/rpgCreationLibraryClient.ts b/src/services/rpg-creation/rpgCreationLibraryClient.ts
new file mode 100644
index 00000000..56aa2b9b
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationLibraryClient.ts
@@ -0,0 +1,33 @@
+import {
+  deleteCustomWorldProfile,
+  getCustomWorldGalleryDetail,
+  listCustomWorldGallery,
+  listCustomWorldLibrary,
+  publishCustomWorldProfile,
+  unpublishCustomWorldProfile,
+  upsertCustomWorldProfile,
+} from '../storageService';
+
+/**
+ * 工作包 A 先建立 RPG 世界作品库和广场相关请求的统一入口。
+ * 当前实现仍透传旧 `storageService.ts`，后续工作包 D 会把作品链路彻底迁入这里。
+ */
+export const rpgCreationLibraryClient = {
+  listLibrary: listCustomWorldLibrary,
+  upsertProfile: upsertCustomWorldProfile,
+  deleteProfile: deleteCustomWorldProfile,
+  publishProfile: publishCustomWorldProfile,
+  unpublishProfile: unpublishCustomWorldProfile,
+  listGallery: listCustomWorldGallery,
+  getGalleryDetail: getCustomWorldGalleryDetail,
+};
+
+export {
+  deleteCustomWorldProfile as deleteRpgWorldProfile,
+  getCustomWorldGalleryDetail as getRpgWorldGalleryDetail,
+  listCustomWorldGallery as listRpgWorldGallery,
+  listCustomWorldLibrary as listRpgWorldLibrary,
+  publishCustomWorldProfile as publishRpgWorldProfile,
+  unpublishCustomWorldProfile as unpublishRpgWorldProfile,
+  upsertCustomWorldProfile as upsertRpgWorldProfile,
+};
diff --git a/src/services/rpg-creation/rpgCreationPreviewAdapter.ts b/src/services/rpg-creation/rpgCreationPreviewAdapter.ts
new file mode 100644
index 00000000..c33c2527
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationPreviewAdapter.ts
@@ -0,0 +1,13 @@
+import { buildCustomWorldProfileFromAgentDraft } from '../customWorldAgentDraftResult';
+
+/**
+ * 这是工作包 A 提供的新命名兼容层。
+ * 当前仍复用旧的前端草稿编译逻辑，后续 Phase 3 会继续把结果预览编译后移到服务端。
+ */
+export const rpgCreationPreviewAdapter = {
+  buildPreviewFromAgentDraft: buildCustomWorldProfileFromAgentDraft,
+};
+
+export {
+  buildCustomWorldProfileFromAgentDraft as buildRpgCreationPreviewFromAgentDraft,
+};
diff --git a/src/services/rpg-creation/rpgCreationWorkClient.ts b/src/services/rpg-creation/rpgCreationWorkClient.ts
new file mode 100644
index 00000000..0f023dd1
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationWorkClient.ts
@@ -0,0 +1,11 @@
+import { listCustomWorldWorks } from '../storageService';
+
+/**
+ * 工作包 A 先建立 RPG 创作作品流的独立 client。
+ * 当前作品列表仍复用旧存储服务，后续工作包 D 再切出真正的专属请求实现。
+ */
+export const rpgCreationWorkClient = {
+  listWorks: listCustomWorldWorks,
+};
+
+export { listCustomWorldWorks as listRpgCreationWorks };

From 4372ab5be175215f09709e5e08b1b0b4e20c3ced Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=AB=98=E7=89=A9?= <253518756@qq.com>
Date: Tue, 21 Apr 2026 18:27:46 +0800
Subject: [PATCH 5/6] 1

---
 ...OGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md |   52 +-
 ...HAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md |  454 +++-
 ...CTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md |   13 +-
 ...CTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md |  106 +
 ...CTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md |  106 +
 ...CTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md |  150 ++
 ...CTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md |   92 +
 ...CTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md |   92 +
 ...CTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md |  137 ++
 ...END_MIGRATION_EXECUTION_PLAN_2026-04-21.md |   19 +
 docs/technical/README.md                      |   21 +-
 ...HAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md |  999 +++++++++
 ..._REFACTOR_OLD_SCRIPT_REMOVAL_2026-04-21.md |  107 +
 ...EFACTOR_PARALLEL_BATCH_AUDIT_2026-04-21.md |  132 ++
 ...HAIN_REFACTOR_PHASE3_CLOSURE_2026-04-21.md |  191 ++
 ...CTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md |  101 +
 ...CTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md |  108 +
 ...CTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md |  115 +
 ...CTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md |  130 ++
 ...CTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md |  112 +
 ...CTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md |  121 ++
 ...CTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md |   96 +
 ...CTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md |   90 +
 .../shared/src/contracts/customWorldAgent.ts  |  548 +----
 .../src/contracts/customWorldAgentActions.ts  |   14 +
 .../src/contracts/customWorldAgentAnchors.ts  |   16 +
 .../src/contracts/customWorldAgentDraft.ts    |   29 +
 .../src/contracts/customWorldAgentSession.ts  |   20 +
 .../src/contracts/customWorldResultPreview.ts |   12 +
 .../src/contracts/customWorldWorkSummary.ts   |   11 +
 .../shared/src/contracts/rpgAgentActions.ts   |  127 +-
 .../shared/src/contracts/rpgAgentAnchors.ts   |   74 +-
 .../shared/src/contracts/rpgAgentDraft.ts     |  251 +++
 .../shared/src/contracts/rpgAgentSession.ts   |  149 +-
 .../shared/src/contracts/rpgContracts.test.ts |  146 ++
 .../src/contracts/rpgCreationFixtures.ts      |  714 ++++++
 .../src/contracts/rpgCreationPreview.ts       |   40 +-
 .../src/contracts/rpgCreationWorkSummary.ts   |   44 +-
 .../shared/src/contracts/rpgRuntimeChat.ts    |  184 ++
 .../src/contracts/rpgRuntimeContracts.test.ts |   51 +
 .../src/contracts/rpgRuntimeQuestAssist.ts    |   83 +
 .../src/contracts/rpgRuntimeStoryAction.ts    |  136 ++
 .../src/contracts/rpgRuntimeStoryState.ts     |  146 ++
 packages/shared/src/contracts/story.ts        |  520 -----
 packages/shared/src/index.ts                  |    8 +-
 server-node/src/app.test.ts                   |  445 +++-
 server-node/src/app.ts                        |   91 +-
 server-node/src/auth/refreshSessionCookie.ts  |   23 +-
 server-node/src/context.ts                    |   16 +
 .../src/modules/ai/chatOrchestrator.ts        |    2 +-
 .../src/modules/ai/orchestrator.test.ts       |    2 +-
 .../modules/combat/combatResolutionService.ts |    8 +-
 .../runtime-profile/buildAttributeSchema.ts   |  365 ++++
 .../runtime-profile/buildCompiledProfile.ts   |  410 ++++
 .../runtime-profile/creatorIntentBridge.ts    |   82 +
 .../custom-world/runtime-profile/index.ts     |   13 +
 .../runtime-profile/normalizeCamp.ts          |  178 ++
 .../runtime-profile/normalizeLandmark.ts      |  151 ++
 .../runtime-profile/normalizeRole.ts          |  541 +++++
 .../runtime-profile/normalizeSceneChapter.ts  |  123 ++
 .../runtime-profile/normalizeShared.ts        |  248 +++
 .../runtime-profile/runtimeProfileCompiler.ts |   13 +
 .../modules/custom-world/runtimeProfile.ts    | 1890 +---------------
 .../inventory/inventoryStoryActionService.ts  |    6 +-
 .../npcInventoryStoryActionService.ts         |    6 +-
 .../src/modules/npc/npcInteractionService.ts  |  200 +-
 .../quest/questRuntimeSignalService.ts        |    6 +-
 .../modules/quest/questStoryActionService.ts  |    6 +-
 .../src/modules/quest/runtimeQuestModule.ts   |    2 +-
 .../RpgRuntimeOptionCompiler.ts               |   14 +
 .../RpgRuntimeSessionDomain.test.ts}          |    6 +-
 .../RpgRuntimeSessionDomain.ts}               |   96 +-
 .../RpgRuntimeSessionLoader.ts                |   13 +
 .../RpgRuntimeSessionPrimitives.ts            |   29 +
 .../RpgRuntimeSnapshotSync.ts                 |   13 +
 .../RpgRuntimeStoryActionDomain.ts}           |   53 +-
 .../RpgRuntimeStoryActionService.ts           |   10 +
 .../RpgRuntimeStoryPresentationCompiler.ts    |    8 +
 .../RpgRuntimeStoryStateService.ts            |    8 +
 .../src/modules/rpg-runtime-story/index.ts    |   35 +
 .../modules/runtime-item/runtimeItemModule.ts |    2 +-
 .../treasureStoryActionService.ts             |    6 +-
 server-node/src/observability.test.ts         |    4 +-
 server-node/src/prompts/chatPromptBuilders.ts |    2 +-
 .../repositories/RpgAgentSessionRepository.ts |  100 +
 .../repositories/RpgWorldProfileRepository.ts |  433 ++++
 .../rpg-entry/RpgEntryRepositories.test.ts    |  241 +++
 .../rpg-entry/RpgSaveArchiveRepository.ts     |   36 +
 .../rpg-entry/RpgWorldLibraryRepository.ts    |   92 +
 .../src/repositories/rpg-entry/index.ts       |    8 +
 .../rpg-profile/RpgBrowseHistoryRepository.ts |   42 +
 .../RpgProfileDashboardRepository.ts          |   49 +
 .../RpgProfileRepositories.test.ts            |  154 ++
 .../src/repositories/rpg-profile/index.ts     |    8 +
 .../RpgRuntimeSnapshotRepository.test.ts      |  126 ++
 .../RpgRuntimeSnapshotRepository.ts           |   35 +
 .../src/repositories/rpg-runtime/index.ts     |    4 +
 .../repositories/rpgWorldRepositoryShared.ts  |  116 +
 .../src/repositories/runtimeRepository.ts     |  499 +----
 server-node/src/routes/customWorldAgent.ts    |   20 +
 server-node/src/routes/rpg-entry/index.ts     |   11 +
 .../routes/rpg-entry/rpgEntrySaveRoutes.ts    |  151 ++
 .../routes/rpg-entry/rpgWorldLibraryRoutes.ts |  338 +++
 server-node/src/routes/rpg-profile/index.ts   |    4 +
 .../routes/rpg-profile/rpgProfileRoutes.ts    |  214 ++
 server-node/src/routes/rpg-runtime/index.ts   |    8 +
 .../rpg-runtime/rpgRuntimeAiAssistRoutes.ts   |  370 ++++
 .../rpgRuntimeStoryRoutes.test.ts}            |  239 +-
 .../rpg-runtime/rpgRuntimeStoryRoutes.ts}     |   18 +-
 .../src/routes/rpgRouteBoundaries.test.ts     |  524 +++++
 .../src/routes/rpgWorldLibraryRoutes.ts       |   13 -
 server-node/src/routes/rpgWorldWorksRoutes.ts |   13 -
 server-node/src/routes/runtimeRoutes.ts       |  843 --------
 .../syncCustomWorldSavedProfileAssets.ts      |   14 +-
 server-node/src/server.ts                     |   44 +-
 .../RpgWorldPreviewCompiler.fixture.test.ts   |   80 +
 .../services/RpgWorldPreviewCompiler.test.ts  |  269 +++
 .../src/services/RpgWorldPreviewCompiler.ts   |   61 +-
 .../src/services/RpgWorldWorkCoverResolver.ts |   46 +
 ...gWorldWorkSummaryAssembler.fixture.test.ts |   96 +
 .../services/RpgWorldWorkSummaryAssembler.ts  |  301 +++
 .../services/RpgWorldWorkSummaryService.ts    |   45 +-
 server-node/src/services/chatService.ts       |    2 +-
 .../draftFoundationExecutor.ts                |  145 ++
 .../executorShared.ts                         |  108 +
 .../expandLongTailExecutor.ts                 |  116 +
 .../generateCharactersExecutor.ts             |  110 +
 .../generateLandmarksExecutor.ts              |  110 +
 .../generateRoleAssetsExecutor.ts             |   82 +
 .../generateSceneAssetsExecutor.ts            |   88 +
 .../helpers.ts                                |   58 +
 .../customWorldAgentActionExecutors/index.ts  |  105 +
 .../publishWorldExecutor.ts                   |  166 ++
 .../revertCheckpointExecutor.ts               |   95 +
 .../syncResultProfileExecutor.ts              |   87 +
 .../syncRoleAssetsExecutor.ts                 |   97 +
 .../syncSceneAssetsExecutor.ts                |   88 +
 .../customWorldAgentActionExecutors/types.ts  |   29 +
 .../updateDraftCardExecutor.ts                |  111 +
 .../customWorldAgentActionRegistry.test.ts    |  260 +++
 .../customWorldAgentActionRegistry.ts         |  403 ++++
 .../customWorldAgentAssetBridgeService.ts     |  227 +-
 .../services/customWorldAgentDraftCompiler.ts |  103 +-
 ...omWorldAgentFoundationDraftService.test.ts |  324 +++
 .../customWorldAgentFoundationDraftService.ts |  664 +++---
 .../customWorldAgentMessageTurnService.ts     |  196 ++
 .../services/customWorldAgentOrchestrator.ts  | 1604 ++------------
 .../services/customWorldAgentPhase2.test.ts   |   98 +-
 .../services/customWorldAgentPhase3.test.ts   |  156 +-
 .../services/customWorldAgentPhase4.test.ts   |  212 +-
 .../services/customWorldAgentPhase5.test.ts   |  729 ++++++-
 .../customWorldAgentPublishGateService.ts     |  141 ++
 .../customWorldAgentPublishService.ts         |  410 ++++
 .../customWorldAgentPublishingService.ts      |  256 +++
 .../customWorldAgentQualityGateService.ts     |   88 +
 .../customWorldAgentRepositoryTestHelpers.ts  |  305 +++
 .../customWorldAgentResultSyncService.test.ts |  118 +
 .../customWorldAgentResultSyncService.ts      |  150 ++
 .../customWorldAgentRoleAssetStateService.ts  |   89 +-
 .../services/customWorldAgentSessionStore.ts  |  815 ++-----
 .../customWorldAgentSnapshotBuilder.ts        |  199 ++
 .../customWorldAgentSuggestedActionService.ts |   82 +
 ...orldWorkSummaryService.integration.test.ts |  113 +
 .../services/customWorldWorkSummaryService.ts |  303 +--
 server-node/src/services/questService.ts      |    4 +-
 .../rpgAgentSessionCompatibility.test.ts      |  158 ++
 .../rpgAgentSessionCompatibility.ts           |  443 ++++
 .../rpgAgentSessionFactory.ts                 |   74 +
 .../rpgAgentSessionRecord.ts                  |   98 +
 .../rpgAgentSessionRepositoryAdapter.ts       |   24 +
 .../rpgCreationPreviewProfileBuilder.ts       |  349 +++
 .../src/services/runtimeItemService.ts        |    4 +-
 server-node/src/services/storyService.ts      |    2 +-
 src/App.tsx                                   |    8 +-
 src/components/AdventureEntityModal.tsx       |    2 +-
 src/components/CharacterChatModal.tsx         |    2 +-
 src/components/CharacterPanel.tsx             |    2 +-
 src/components/CustomWorldEntityCatalog.tsx   |    4 +-
 .../CustomWorldEntityEditorModal.test.tsx     |   72 +-
 src/components/CustomWorldResultView.test.tsx |  128 +-
 src/components/CustomWorldResultView.tsx      |  791 -------
 src/components/NpcModals.tsx                  |    2 +-
 .../game-shell/PreGameSelectionFlow.tsx       | 1920 -----------------
 .../rpg-creation-flow/RpgCreationShell.tsx    |   15 -
 .../game-shell/rpg-creation-flow/index.ts     |    4 -
 .../game-shell/useSceneTransitionModel.ts     |  185 --
 .../RpgCreationRoleAnimationSection.tsx       |  244 +++
 .../RpgCreationRoleAssetStudioFooter.tsx      |   53 +
 .../RpgCreationRoleAssetStudioModal.tsx       |   21 +
 .../RpgCreationRoleAssetStudioModalImpl.tsx}  |  607 ++----
 .../RpgCreationRoleVisualSection.tsx          |  184 ++
 .../rpg-creation-asset-studio/index.ts        |    4 +
 .../roleAssetStudioModel.ts                   |   79 +
 .../roleAssetStudioPublishClient.ts           |   13 +
 .../useRoleAnimationWorkflow.ts               |   99 +
 .../useRoleVisualCandidateWorkflow.ts         |   59 +
 .../CustomWorldCampEditorSection.tsx          |    1 +
 .../CustomWorldCoverEditorSection.tsx         |    1 +
 .../CustomWorldLandmarkEditorSection.tsx      |    1 +
 .../CustomWorldRoleEditorSection.tsx          |    4 +
 .../CustomWorldSceneChapterEditorSection.tsx  |    1 +
 .../CustomWorldWorldEditorSection.tsx         |    1 +
 .../RpgCreationEntityEditorModal.tsx          |   15 +-
 .../RpgCreationEntityEditorModalImpl.tsx      |  136 ++
 .../RpgCreationEntityEditorShared.tsx}        |  433 +---
 .../rpgCreationResultFormMapper.ts            |  304 +++
 .../RpgCreationAssetDebugPanel.tsx            |  291 +++
 .../RpgCreationResultActionBar.tsx            |   97 +
 .../RpgCreationResultHeader.tsx               |   59 +
 .../RpgCreationResultView.tsx                 |   10 +-
 .../RpgCreationResultViewImpl.tsx             |  229 ++
 .../useRpgCreationResultActions.ts            |  318 +++
 .../RpgEntryBrandLogo.tsx}                    |   16 +-
 .../RpgEntryCharacterSelectView.test.tsx}     |    4 +-
 .../RpgEntryCharacterSelectView.tsx}          |   65 +-
 .../RpgEntryCreationTypeModal.tsx}            |   12 +-
 ...EntryFlowShell.agent.interaction.test.tsx} |  502 ++++-
 .../rpg-entry/RpgEntryFlowShell.tsx           |   20 +
 .../rpg-entry/RpgEntryFlowShellImpl.tsx       |  718 ++++++
 .../RpgEntryHomeView.tsx}                     |   69 +-
 .../RpgEntryWorldDetailView.tsx}              |   34 +-
 src/components/rpg-entry/index.ts             |   27 +
 src/components/rpg-entry/rpgEntryShared.ts    |  110 +
 src/components/rpg-entry/rpgEntryTypes.ts     |   39 +
 .../rpgEntryWorldPresentation.ts}             |    8 +-
 .../useRpgCreationAgentOperationPolling.ts    |  109 +
 .../rpg-entry/useRpgCreationEnterWorld.ts     |   92 +
 .../rpg-entry/useRpgCreationResultAutosave.ts |  392 ++++
 .../useRpgCreationSessionController.ts        |  570 +++++
 .../rpg-entry/useRpgEntryBootstrap.ts         |  346 +++
 .../rpg-entry/useRpgEntryCharacterSelect.ts   |   46 +
 .../rpg-entry/useRpgEntryLibraryDetail.ts     |  444 ++++
 .../rpg-entry/useRpgEntryNavigation.ts        |   55 +
 .../rpg-entry/useRpgEntrySaveResume.ts        |   28 +
 .../RpgAdventurePanel.npcChat.test.tsx}       |   12 +-
 .../RpgAdventurePanel.test.tsx}               |    8 +-
 .../RpgAdventurePanel.tsx}                    |  908 +++++---
 .../RpgAdventurePanelOverlays.tsx}            |    8 +-
 .../RpgRuntimePanelRouter.tsx}                |   88 +-
 src/components/rpg-runtime-panels/index.ts    |    8 +
 .../RpgRuntimeCanvasStage.tsx}                |   48 +-
 .../RpgRuntimeOverlayHost.tsx}                |   80 +-
 .../RpgRuntimeShell.tsx}                      |   40 +-
 .../RpgRuntimeStageRouter.tsx}                |  135 +-
 src/components/rpg-runtime-shell/index.ts     |   36 +
 .../rpgRuntimeLoaders.tsx}                    |   15 +-
 .../types.ts                                  |   30 +-
 .../useRpgRuntimeOverlayState.ts}             |   22 +-
 .../useRpgRuntimeShellViewModel.test.ts}      |   14 +-
 .../useRpgRuntimeShellViewModel.ts}           |   41 +-
 .../useRpgSceneTransitionModel.ts             |  224 ++
 .../flow/campTravelHomeScene.ts               |    3 +-
 .../flow/storyContinueAdventure.ts            |    2 +-
 .../flow/storyOpeningCampDialogue.ts          |    3 +-
 .../functionCatalog/functionCatalog.test.ts   |    2 +-
 src/data/functionCatalog/npc/npcChat.ts       |    3 +-
 src/data/functionCatalog/npc/npcFight.ts      |    3 +-
 src/data/functionCatalog/npc/npcGift.ts       |    4 +-
 src/data/functionCatalog/npc/npcHelp.ts       |    3 +-
 src/data/functionCatalog/npc/npcLeave.ts      |    3 +-
 .../functionCatalog/npc/npcPreviewTalk.ts     |    2 +-
 src/data/functionCatalog/npc/npcRecruit.ts    |    4 +-
 src/data/functionCatalog/npc/npcSpar.ts       |    3 +-
 src/data/functionCatalog/npc/npcTrade.ts      |    4 +-
 .../characterChat.ts                          |    2 +-
 .../choiceActions.test.ts                     |   28 +-
 .../choiceActions.ts                          |    6 +-
 .../{story => rpg-runtime-story}/goalFlow.ts  |    2 +-
 src/hooks/rpg-runtime-story/index.ts          |   52 +
 .../inventoryActions.ts                       |    6 +-
 .../npcEncounterActions.test.ts               |    7 +-
 .../rpg-runtime-story/npcEncounterActions.ts  |    6 +
 .../npcInteraction.ts                         |  216 +-
 .../openingAdventure.ts                       |    2 +-
 .../progressionActions.ts                     |    2 +-
 .../rpgRuntimeStoryGateway.ts}                |   55 +-
 .../runtimeStoryCoordinator.test.ts           |   14 +-
 .../runtimeStoryCoordinator.ts                |    7 +
 .../sessionActions.test.ts                    |    2 +-
 .../sessionActions.ts                         |    2 +-
 .../storyCampCompanion.test.ts                |    2 +-
 .../storyCampCompanion.ts                     |    2 +-
 .../storyChoiceContinuation.ts                |    2 +-
 .../storyChoiceCoordinator.test.ts            |    2 +-
 .../storyChoiceCoordinator.ts                 |    2 +-
 .../storyChoiceRuntime.test.ts                |    6 +-
 .../storyChoiceRuntime.ts                     |    6 +-
 .../storyContextBuilder.ts                    |    2 +-
 .../storyEncounterState.test.ts               |    2 +-
 .../storyEncounterState.ts                    |    2 +-
 .../storyGenerationState.test.ts              |    2 +-
 .../storyGenerationState.ts                   |    2 +-
 .../storyInteractionCoordinator.test.ts       |    3 +-
 .../storyInteractionCoordinator.ts            |   21 +-
 .../storyPresentation.test.ts                 |    2 +-
 .../storyPresentation.ts                      |    2 +-
 .../storyRenderingHelpers.ts                  |    2 +-
 .../storyRequestCoordinator.test.ts           |    2 +-
 .../storyRequestCoordinator.ts                |   12 +-
 .../storyRequestRuntime.test.ts               |    2 +-
 .../storyRequestRuntime.ts                    |    2 +-
 .../storyResponseOptions.test.ts              |    2 +-
 .../storyResponseOptions.ts                   |    2 +-
 .../storyRuntimeSupport.test.ts               |    2 +-
 .../storyRuntimeSupport.ts                    |    2 +-
 .../{story => rpg-runtime-story}/uiTypes.ts   |    2 +-
 .../useRpgRuntimeInteractionFlow.test.ts}     |    8 +-
 .../useRpgRuntimeInteractionFlow.ts}          |   26 +-
 .../useRpgRuntimeNpcInteraction.ts}           |   26 +-
 .../useRpgRuntimeStory.ts}                    |   49 +-
 .../useRpgRuntimeStoryController.ts}          |   17 +-
 .../useRpgRuntimeStoryFlow.ts}                |   31 +-
 .../useRpgRuntimeStoryState.test.ts}          |    8 +-
 .../useRpgRuntimeStoryState.ts}               |   17 +-
 .../useStoryChoiceCoordinator.test.ts         |    2 +-
 .../useStoryChoiceCoordinator.ts              |    2 +-
 .../useStoryGoalOptionCoordinator.test.ts     |    2 +-
 .../useStoryGoalOptionCoordinator.ts          |    2 +-
 src/hooks/rpg-session/index.ts                |   12 +
 src/hooks/rpg-session/rpgSessionTypes.ts      |    3 +
 .../useRpgRuntimeSession.ts}                  |   38 +-
 .../useRpgSessionBootstrap.ts}                |   40 +-
 .../useRpgSessionPersistence.ts}              |   71 +-
 src/hooks/runtimeAuthGuards.test.tsx          |   21 +-
 src/hooks/useGameFlow.customWorld.test.tsx    |    4 +-
 src/hooks/useGameSettings.ts                  |    9 +-
 src/hooks/useTreasureFlow.ts                  |    4 +-
 src/services/aiService.ts                     |  355 +--
 .../customWorldAgentDraftResult.test.ts       |  861 --------
 src/services/customWorldAgentDraftResult.ts   |  591 -----
 src/services/customWorldSceneActRuntime.ts    |    2 +-
 src/services/rpg-creation/index.ts            |   17 +-
 .../rpg-creation/rpgCreationAgentClient.ts    |  229 +-
 .../rpg-creation/rpgCreationAssetClient.ts    |  119 +-
 .../rpgCreationGenerationClient.test.ts       |   54 +
 .../rpgCreationGenerationClient.ts            |   68 +
 .../rpg-creation/rpgCreationLibraryClient.ts  |  171 +-
 .../rpgCreationPreviewAdapter.test.ts         |  121 ++
 .../rpg-creation/rpgCreationPreviewAdapter.ts |   34 +-
 .../rpg-creation/rpgCreationRequestHelpers.ts |   41 +
 .../rpg-creation/rpgCreationRuntimeClient.ts  |   60 +
 .../rpg-creation/rpgCreationWorkClient.ts     |   20 +-
 src/services/rpg-entry/index.ts               |   25 +
 .../rpgEntryClients.routing.test.ts}          |   44 +-
 .../rpg-entry/rpgEntryLibraryClient.test.ts   |  165 ++
 .../rpg-entry/rpgEntryLibraryClient.ts        |  152 ++
 .../rpg-entry/rpgProfileClient.test.ts        |  158 ++
 src/services/rpg-entry/rpgProfileClient.ts    |  187 ++
 src/services/rpg-runtime/index.ts             |   32 +
 .../rpg-runtime/rpgRuntimeChatClient.ts       |   29 +
 src/services/rpg-runtime/rpgRuntimeRequest.ts |   66 +
 .../rpgRuntimeStoryClient.test.ts}            |   56 +-
 .../rpgRuntimeStoryClient.ts}                 |   55 +-
 .../rpg-runtime/rpgSnapshotClient.test.ts     |   89 +
 src/services/rpg-runtime/rpgSnapshotClient.ts |   60 +
 src/services/storageService.ts                |  440 ----
 src/types/core.ts                             |    9 +-
 vitest.config.ts                              |    7 +-
 358 files changed, 30788 insertions(+), 14737 deletions(-)
 create mode 100644 docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_OLD_SCRIPT_REMOVAL_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PARALLEL_BATCH_AUDIT_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PHASE3_CLOSURE_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md
 create mode 100644 docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md
 create mode 100644 packages/shared/src/contracts/customWorldAgentActions.ts
 create mode 100644 packages/shared/src/contracts/customWorldAgentAnchors.ts
 create mode 100644 packages/shared/src/contracts/customWorldAgentDraft.ts
 create mode 100644 packages/shared/src/contracts/customWorldAgentSession.ts
 create mode 100644 packages/shared/src/contracts/customWorldResultPreview.ts
 create mode 100644 packages/shared/src/contracts/customWorldWorkSummary.ts
 create mode 100644 packages/shared/src/contracts/rpgAgentDraft.ts
 create mode 100644 packages/shared/src/contracts/rpgContracts.test.ts
 create mode 100644 packages/shared/src/contracts/rpgCreationFixtures.ts
 create mode 100644 packages/shared/src/contracts/rpgRuntimeChat.ts
 create mode 100644 packages/shared/src/contracts/rpgRuntimeContracts.test.ts
 create mode 100644 packages/shared/src/contracts/rpgRuntimeQuestAssist.ts
 create mode 100644 packages/shared/src/contracts/rpgRuntimeStoryAction.ts
 create mode 100644 packages/shared/src/contracts/rpgRuntimeStoryState.ts
 delete mode 100644 packages/shared/src/contracts/story.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/buildAttributeSchema.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/buildCompiledProfile.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/creatorIntentBridge.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/index.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/normalizeCamp.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/normalizeLandmark.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/normalizeRole.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/normalizeSceneChapter.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/normalizeShared.ts
 create mode 100644 server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts
 create mode 100644 server-node/src/modules/rpg-runtime-story/RpgRuntimeOptionCompiler.ts
 rename server-node/src/modules/{story/runtimeSession.test.ts => rpg-runtime-story/RpgRuntimeSessionDomain.test.ts} (94%)
 rename server-node/src/modules/{story/runtimeSession.ts => rpg-runtime-story/RpgRuntimeSessionDomain.ts} (93%)
 create mode 100644 server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionLoader.ts
 create mode 100644 server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionPrimitives.ts
 create mode 100644 server-node/src/modules/rpg-runtime-story/RpgRuntimeSnapshotSync.ts
 rename server-node/src/modules/{story/storyActionService.ts => rpg-runtime-story/RpgRuntimeStoryActionDomain.ts} (96%)
 create mode 100644 server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionService.ts
 create mode 100644 server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryPresentationCompiler.ts
 create mode 100644 server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryStateService.ts
 create mode 100644 server-node/src/modules/rpg-runtime-story/index.ts
 create mode 100644 server-node/src/repositories/RpgAgentSessionRepository.ts
 create mode 100644 server-node/src/repositories/RpgWorldProfileRepository.ts
 create mode 100644 server-node/src/repositories/rpg-entry/RpgEntryRepositories.test.ts
 create mode 100644 server-node/src/repositories/rpg-entry/RpgSaveArchiveRepository.ts
 create mode 100644 server-node/src/repositories/rpg-entry/RpgWorldLibraryRepository.ts
 create mode 100644 server-node/src/repositories/rpg-entry/index.ts
 create mode 100644 server-node/src/repositories/rpg-profile/RpgBrowseHistoryRepository.ts
 create mode 100644 server-node/src/repositories/rpg-profile/RpgProfileDashboardRepository.ts
 create mode 100644 server-node/src/repositories/rpg-profile/RpgProfileRepositories.test.ts
 create mode 100644 server-node/src/repositories/rpg-profile/index.ts
 create mode 100644 server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.test.ts
 create mode 100644 server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.ts
 create mode 100644 server-node/src/repositories/rpg-runtime/index.ts
 create mode 100644 server-node/src/repositories/rpgWorldRepositoryShared.ts
 create mode 100644 server-node/src/routes/rpg-entry/index.ts
 create mode 100644 server-node/src/routes/rpg-entry/rpgEntrySaveRoutes.ts
 create mode 100644 server-node/src/routes/rpg-entry/rpgWorldLibraryRoutes.ts
 create mode 100644 server-node/src/routes/rpg-profile/index.ts
 create mode 100644 server-node/src/routes/rpg-profile/rpgProfileRoutes.ts
 create mode 100644 server-node/src/routes/rpg-runtime/index.ts
 create mode 100644 server-node/src/routes/rpg-runtime/rpgRuntimeAiAssistRoutes.ts
 rename server-node/src/{modules/story/storyActionRoutes.test.ts => routes/rpg-runtime/rpgRuntimeStoryRoutes.test.ts} (91%)
 rename server-node/src/{modules/story/storyActionRoutes.ts => routes/rpg-runtime/rpgRuntimeStoryRoutes.ts} (80%)
 create mode 100644 server-node/src/routes/rpgRouteBoundaries.test.ts
 delete mode 100644 server-node/src/routes/rpgWorldLibraryRoutes.ts
 delete mode 100644 server-node/src/routes/rpgWorldWorksRoutes.ts
 delete mode 100644 server-node/src/routes/runtimeRoutes.ts
 create mode 100644 server-node/src/services/RpgWorldPreviewCompiler.fixture.test.ts
 create mode 100644 server-node/src/services/RpgWorldPreviewCompiler.test.ts
 create mode 100644 server-node/src/services/RpgWorldWorkCoverResolver.ts
 create mode 100644 server-node/src/services/RpgWorldWorkSummaryAssembler.fixture.test.ts
 create mode 100644 server-node/src/services/RpgWorldWorkSummaryAssembler.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/draftFoundationExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/executorShared.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/expandLongTailExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/generateCharactersExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/generateLandmarksExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/generateRoleAssetsExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/generateSceneAssetsExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/helpers.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/index.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/publishWorldExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/revertCheckpointExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/syncResultProfileExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/syncRoleAssetsExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/syncSceneAssetsExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/types.ts
 create mode 100644 server-node/src/services/customWorldAgentActionExecutors/updateDraftCardExecutor.ts
 create mode 100644 server-node/src/services/customWorldAgentActionRegistry.test.ts
 create mode 100644 server-node/src/services/customWorldAgentActionRegistry.ts
 create mode 100644 server-node/src/services/customWorldAgentFoundationDraftService.test.ts
 create mode 100644 server-node/src/services/customWorldAgentMessageTurnService.ts
 create mode 100644 server-node/src/services/customWorldAgentPublishGateService.ts
 create mode 100644 server-node/src/services/customWorldAgentPublishService.ts
 create mode 100644 server-node/src/services/customWorldAgentPublishingService.ts
 create mode 100644 server-node/src/services/customWorldAgentQualityGateService.ts
 create mode 100644 server-node/src/services/customWorldAgentRepositoryTestHelpers.ts
 create mode 100644 server-node/src/services/customWorldAgentResultSyncService.test.ts
 create mode 100644 server-node/src/services/customWorldAgentResultSyncService.ts
 create mode 100644 server-node/src/services/customWorldAgentSnapshotBuilder.ts
 create mode 100644 server-node/src/services/customWorldAgentSuggestedActionService.ts
 create mode 100644 server-node/src/services/customWorldWorkSummaryService.integration.test.ts
 create mode 100644 server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.test.ts
 create mode 100644 server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.ts
 create mode 100644 server-node/src/services/rpg-agent-session-store/rpgAgentSessionFactory.ts
 create mode 100644 server-node/src/services/rpg-agent-session-store/rpgAgentSessionRecord.ts
 create mode 100644 server-node/src/services/rpg-agent-session-store/rpgAgentSessionRepositoryAdapter.ts
 create mode 100644 server-node/src/services/rpgCreationPreviewProfileBuilder.ts
 delete mode 100644 src/components/CustomWorldResultView.tsx
 delete mode 100644 src/components/game-shell/PreGameSelectionFlow.tsx
 delete mode 100644 src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx
 delete mode 100644 src/components/game-shell/rpg-creation-flow/index.ts
 delete mode 100644 src/components/game-shell/useSceneTransitionModel.ts
 create mode 100644 src/components/rpg-creation-asset-studio/RpgCreationRoleAnimationSection.tsx
 create mode 100644 src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioFooter.tsx
 create mode 100644 src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioModal.tsx
 rename src/components/{CustomWorldRoleAssetStudioModal.tsx => rpg-creation-asset-studio/RpgCreationRoleAssetStudioModalImpl.tsx} (62%)
 create mode 100644 src/components/rpg-creation-asset-studio/RpgCreationRoleVisualSection.tsx
 create mode 100644 src/components/rpg-creation-asset-studio/index.ts
 create mode 100644 src/components/rpg-creation-asset-studio/roleAssetStudioModel.ts
 create mode 100644 src/components/rpg-creation-asset-studio/roleAssetStudioPublishClient.ts
 create mode 100644 src/components/rpg-creation-asset-studio/useRoleAnimationWorkflow.ts
 create mode 100644 src/components/rpg-creation-asset-studio/useRoleVisualCandidateWorkflow.ts
 create mode 100644 src/components/rpg-creation-editor/CustomWorldCampEditorSection.tsx
 create mode 100644 src/components/rpg-creation-editor/CustomWorldCoverEditorSection.tsx
 create mode 100644 src/components/rpg-creation-editor/CustomWorldLandmarkEditorSection.tsx
 create mode 100644 src/components/rpg-creation-editor/CustomWorldRoleEditorSection.tsx
 create mode 100644 src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx
 create mode 100644 src/components/rpg-creation-editor/CustomWorldWorldEditorSection.tsx
 create mode 100644 src/components/rpg-creation-editor/RpgCreationEntityEditorModalImpl.tsx
 rename src/components/{CustomWorldEntityEditorModal.tsx => rpg-creation-editor/RpgCreationEntityEditorShared.tsx} (94%)
 create mode 100644 src/components/rpg-creation-editor/rpgCreationResultFormMapper.ts
 create mode 100644 src/components/rpg-creation-result/RpgCreationAssetDebugPanel.tsx
 create mode 100644 src/components/rpg-creation-result/RpgCreationResultActionBar.tsx
 create mode 100644 src/components/rpg-creation-result/RpgCreationResultHeader.tsx
 create mode 100644 src/components/rpg-creation-result/RpgCreationResultViewImpl.tsx
 create mode 100644 src/components/rpg-creation-result/useRpgCreationResultActions.ts
 rename src/components/{game-shell/PlatformBrandLogo.tsx => rpg-entry/RpgEntryBrandLogo.tsx} (66%)
 rename src/components/{game-shell/CharacterSelectionFlow.test.tsx => rpg-entry/RpgEntryCharacterSelectView.test.tsx} (98%)
 rename src/components/{game-shell/CharacterSelectionFlow.tsx => rpg-entry/RpgEntryCharacterSelectView.tsx} (92%)
 rename src/components/{game-shell/PlatformCreationTypeModal.tsx => rpg-entry/RpgEntryCreationTypeModal.tsx} (94%)
 rename src/components/{game-shell/PreGameSelectionFlow.agent.interaction.test.tsx => rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx} (71%)
 create mode 100644 src/components/rpg-entry/RpgEntryFlowShell.tsx
 create mode 100644 src/components/rpg-entry/RpgEntryFlowShellImpl.tsx
 rename src/components/{game-shell/PlatformHomeView.tsx => rpg-entry/RpgEntryHomeView.tsx} (99%)
 rename src/components/{game-shell/PlatformWorldDetailView.tsx => rpg-entry/RpgEntryWorldDetailView.tsx} (96%)
 create mode 100644 src/components/rpg-entry/index.ts
 create mode 100644 src/components/rpg-entry/rpgEntryShared.ts
 create mode 100644 src/components/rpg-entry/rpgEntryTypes.ts
 rename src/components/{game-shell/platformWorldPresentation.ts => rpg-entry/rpgEntryWorldPresentation.ts} (92%)
 create mode 100644 src/components/rpg-entry/useRpgCreationAgentOperationPolling.ts
 create mode 100644 src/components/rpg-entry/useRpgCreationEnterWorld.ts
 create mode 100644 src/components/rpg-entry/useRpgCreationResultAutosave.ts
 create mode 100644 src/components/rpg-entry/useRpgCreationSessionController.ts
 create mode 100644 src/components/rpg-entry/useRpgEntryBootstrap.ts
 create mode 100644 src/components/rpg-entry/useRpgEntryCharacterSelect.ts
 create mode 100644 src/components/rpg-entry/useRpgEntryLibraryDetail.ts
 create mode 100644 src/components/rpg-entry/useRpgEntryNavigation.ts
 create mode 100644 src/components/rpg-entry/useRpgEntrySaveResume.ts
 rename src/components/{AdventurePanel.npcChat.test.tsx => rpg-runtime-panels/RpgAdventurePanel.npcChat.test.tsx} (96%)
 rename src/components/{AdventurePanel.test.tsx => rpg-runtime-panels/RpgAdventurePanel.test.tsx} (98%)
 rename src/components/{AdventurePanel.tsx => rpg-runtime-panels/RpgAdventurePanel.tsx} (60%)
 rename src/components/{adventure-panel/AdventurePanelOverlays.tsx => rpg-runtime-panels/RpgAdventurePanelOverlays.tsx} (99%)
 rename src/components/{game-shell/GameShellStoryPanels.tsx => rpg-runtime-panels/RpgRuntimePanelRouter.tsx} (93%)
 create mode 100644 src/components/rpg-runtime-panels/index.ts
 rename src/components/{game-shell/GameShellCanvasStage.tsx => rpg-runtime-shell/RpgRuntimeCanvasStage.tsx} (76%)
 rename src/components/{game-shell/GameShellOverlays.tsx => rpg-runtime-shell/RpgRuntimeOverlayHost.tsx} (92%)
 rename src/components/{game-shell/GameShellRuntime.tsx => rpg-runtime-shell/RpgRuntimeShell.tsx} (89%)
 rename src/components/{game-shell/GameShellMainContent.tsx => rpg-runtime-shell/RpgRuntimeStageRouter.tsx} (85%)
 create mode 100644 src/components/rpg-runtime-shell/index.ts
 rename src/components/{game-shell/GameShellLoaders.tsx => rpg-runtime-shell/rpgRuntimeLoaders.tsx} (62%)
 rename src/components/{game-shell => rpg-runtime-shell}/types.ts (80%)
 rename src/components/{game-shell/useGameShellViewModel.ts => rpg-runtime-shell/useRpgRuntimeOverlayState.ts} (79%)
 rename src/components/{game-shell/useGameShellRuntimeViewModel.test.ts => rpg-runtime-shell/useRpgRuntimeShellViewModel.test.ts} (95%)
 rename src/components/{game-shell/useGameShellRuntimeViewModel.ts => rpg-runtime-shell/useRpgRuntimeShellViewModel.ts} (87%)
 create mode 100644 src/components/rpg-runtime-shell/useRpgSceneTransitionModel.ts
 rename src/hooks/{story => rpg-runtime-story}/characterChat.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/choiceActions.test.ts (95%)
 rename src/hooks/{story => rpg-runtime-story}/choiceActions.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/goalFlow.ts (97%)
 create mode 100644 src/hooks/rpg-runtime-story/index.ts
 rename src/hooks/{story => rpg-runtime-story}/inventoryActions.ts (95%)
 rename src/hooks/{story => rpg-runtime-story}/npcEncounterActions.test.ts (99%)
 create mode 100644 src/hooks/rpg-runtime-story/npcEncounterActions.ts
 rename src/hooks/{story => rpg-runtime-story}/npcInteraction.ts (82%)
 rename src/hooks/{story => rpg-runtime-story}/openingAdventure.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/progressionActions.ts (99%)
 rename src/hooks/{story/runtimeStoryCoordinator.ts => rpg-runtime-story/rpgRuntimeStoryGateway.ts} (67%)
 rename src/hooks/{story => rpg-runtime-story}/runtimeStoryCoordinator.test.ts (96%)
 create mode 100644 src/hooks/rpg-runtime-story/runtimeStoryCoordinator.ts
 rename src/hooks/{story => rpg-runtime-story}/sessionActions.test.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/sessionActions.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyCampCompanion.test.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyCampCompanion.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyChoiceContinuation.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyChoiceCoordinator.test.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyChoiceCoordinator.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyChoiceRuntime.test.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyChoiceRuntime.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyContextBuilder.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyEncounterState.test.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyEncounterState.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyGenerationState.test.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyGenerationState.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyInteractionCoordinator.test.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyInteractionCoordinator.ts (84%)
 rename src/hooks/{story => rpg-runtime-story}/storyPresentation.test.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyPresentation.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyRenderingHelpers.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyRequestCoordinator.test.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyRequestCoordinator.ts (92%)
 rename src/hooks/{story => rpg-runtime-story}/storyRequestRuntime.test.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyRequestRuntime.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyResponseOptions.test.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/storyResponseOptions.ts (97%)
 rename src/hooks/{story => rpg-runtime-story}/storyRuntimeSupport.test.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/storyRuntimeSupport.ts (99%)
 rename src/hooks/{story => rpg-runtime-story}/uiTypes.ts (99%)
 rename src/hooks/{story/useStoryInteractionCoordinator.test.ts => rpg-runtime-story/useRpgRuntimeInteractionFlow.test.ts} (53%)
 rename src/hooks/{story/useStoryInteractionCoordinator.ts => rpg-runtime-story/useRpgRuntimeInteractionFlow.ts} (91%)
 rename src/hooks/{story/npcEncounterActions.ts => rpg-runtime-story/useRpgRuntimeNpcInteraction.ts} (98%)
 rename src/hooks/{useStoryGeneration.ts => rpg-runtime-story/useRpgRuntimeStory.ts} (69%)
 rename src/hooks/{story/useStoryRuntimeController.ts => rpg-runtime-story/useRpgRuntimeStoryController.ts} (86%)
 rename src/hooks/{story/useStoryFlowCoordinator.ts => rpg-runtime-story/useRpgRuntimeStoryFlow.ts} (85%)
 rename src/hooks/{story/useStoryGoalSessionCoordinator.test.ts => rpg-runtime-story/useRpgRuntimeStoryState.test.ts} (74%)
 rename src/hooks/{story/useStoryGoalSessionCoordinator.ts => rpg-runtime-story/useRpgRuntimeStoryState.ts} (84%)
 rename src/hooks/{story => rpg-runtime-story}/useStoryChoiceCoordinator.test.ts (88%)
 rename src/hooks/{story => rpg-runtime-story}/useStoryChoiceCoordinator.ts (98%)
 rename src/hooks/{story => rpg-runtime-story}/useStoryGoalOptionCoordinator.test.ts (90%)
 rename src/hooks/{story => rpg-runtime-story}/useStoryGoalOptionCoordinator.ts (96%)
 create mode 100644 src/hooks/rpg-session/index.ts
 create mode 100644 src/hooks/rpg-session/rpgSessionTypes.ts
 rename src/hooks/{useGameShellRuntime.ts => rpg-session/useRpgRuntimeSession.ts} (79%)
 rename src/hooks/{useGameFlow.ts => rpg-session/useRpgSessionBootstrap.ts} (91%)
 rename src/hooks/{useGamePersistence.ts => rpg-session/useRpgSessionPersistence.ts} (84%)
 delete mode 100644 src/services/customWorldAgentDraftResult.test.ts
 delete mode 100644 src/services/customWorldAgentDraftResult.ts
 create mode 100644 src/services/rpg-creation/rpgCreationGenerationClient.test.ts
 create mode 100644 src/services/rpg-creation/rpgCreationGenerationClient.ts
 create mode 100644 src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts
 create mode 100644 src/services/rpg-creation/rpgCreationRequestHelpers.ts
 create mode 100644 src/services/rpg-creation/rpgCreationRuntimeClient.ts
 create mode 100644 src/services/rpg-entry/index.ts
 rename src/services/{storageService.test.ts => rpg-entry/rpgEntryClients.routing.test.ts} (84%)
 create mode 100644 src/services/rpg-entry/rpgEntryLibraryClient.test.ts
 create mode 100644 src/services/rpg-entry/rpgEntryLibraryClient.ts
 create mode 100644 src/services/rpg-entry/rpgProfileClient.test.ts
 create mode 100644 src/services/rpg-entry/rpgProfileClient.ts
 create mode 100644 src/services/rpg-runtime/index.ts
 create mode 100644 src/services/rpg-runtime/rpgRuntimeChatClient.ts
 create mode 100644 src/services/rpg-runtime/rpgRuntimeRequest.ts
 rename src/services/{runtimeStoryService.test.ts => rpg-runtime/rpgRuntimeStoryClient.test.ts} (89%)
 rename src/services/{runtimeStoryService.ts => rpg-runtime/rpgRuntimeStoryClient.ts} (78%)
 create mode 100644 src/services/rpg-runtime/rpgSnapshotClient.test.ts
 create mode 100644 src/services/rpg-runtime/rpgSnapshotClient.ts
 delete mode 100644 src/services/storageService.ts

diff --git a/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md b/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md
index 66b66ef5..63b5b541 100644
--- a/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md
+++ b/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md
@@ -19,7 +19,7 @@
 
 ## 1. 结论先行
 
-结合当前代码与已有边界文档，前端里仍有 6 类逻辑应该继续后移：
+结合当前代码与已有边界文档，前端里仍有 7 类逻辑应该继续后移：
 
 1. **运行时快照前置写入与本地镜像解释**
 2. **鉴权 token 的浏览器本地真相**
@@ -27,6 +27,7 @@
 4. **NPC 待接委托“换单”仍由前端直接触发正式生成**
 5. **quest/runtime item 的双环境混合编排**
 6. **浏览器侧大型 AI orchestration 与 prompt/repair/fallback 主链**
+7. **NPC 招募对白之后的正式结算链路**
 
 一句话判断：
 
@@ -59,6 +60,20 @@
 
 ## 3. 当前高置信度应后移逻辑
 
+## 3.0 本轮已完成后移
+
+以下链路已在本轮或上一轮连续落地中完成后移，不再属于“仍残留在前端”的正式主链：
+
+1. access token 浏览器本地真相
+2. browse history 本地真相
+3. runtime story 前置 `PUT /runtime/save/snapshot`
+4. NPC 待接委托 `replace / abandon / accept`
+5. custom world profile 正式浏览器入口
+6. `questDirector` / `runtimeItemAiDirector` 浏览器正式编排
+7. NPC 招募正式结算
+
+其中 NPC 招募已从“前端本地改 companions / roster / npcStates / storyHistory”收回到后端 runtime action。
+
 ## 3.1 运行时快照前置写入仍在前端
 
 ### 代码证据
@@ -427,6 +442,41 @@
 
 ---
 
+## 3.8 NPC 招募对白之后的正式结算链路已完成后移
+
+### 本轮前状态
+
+迁移前，`src/hooks/story/npcInteraction.ts` 中的 `buildRecruitmentOutcome / executeRecruitment / startRecruitmentSequence` 仍在前端本地正式结算：
+
+1. 改 `npcStates`
+2. 改 `companions`
+3. 改 `roster`
+4. 清 `currentEncounter / inBattle / sceneHostileNpcs`
+5. 直接写 `storyHistory`
+6. 再触发后续剧情推进
+
+这与“前端只做表现，所有正式逻辑、数据都放到 Express 后端”直接冲突。
+
+### 本轮后状态
+
+本轮已完成：
+
+1. `server-node/src/modules/story/runtimeSession.ts`
+   - 正式承接完整 `companions`
+   - 正式承接 `roster`
+2. `server-node/src/modules/npc/npcInteractionService.ts`
+   - `npc_recruit` 已支持正常入队
+   - `npc_recruit` 已支持满员换队招募
+3. `src/hooks/story/npcInteraction.ts`
+   - 前端只保留招募对白流式展示
+   - 正式招募结算改为调用后端 runtime action
+
+### 当前判断
+
+这一项已不再属于前端残留正式逻辑。
+
+---
+
 ## 4. 可以暂时保留在前端的部分
 
 下面这些内容即使和上述模块同文件出现，也不属于必须后移的对象：
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
index 2a2cc0f1..131bac39 100644
--- a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
@@ -708,7 +708,7 @@ store 当前混合了：
 3. 已新增 `rpgCreationAgentClient`、`rpgCreationWorkClient`、`rpgCreationLibraryClient`、`rpgCreationAssetClient`、`rpgCreationPreviewAdapter`。
 4. 已新增后端 `rpgCreationAgentRoutes`、`rpgWorldWorksRoutes`、`rpgWorldLibraryRoutes`、`rpgWorldGalleryRoutes` 命名骨架。
 5. 已新增 `RpgAgentOrchestrator`、`RpgAgentSessionStore`、`RpgWorldPreviewCompiler`、`RpgWorldWorkSummaryService` façade。
-6. 已新增 `rpgAgent*` 与 `rpgCreation*` 共享契约骨架。
+6. 已新增 `rpgAgent*` 与 `rpgCreation*` 共享契约骨架，并补齐此前遗漏的 `rpgAgentDraft.ts` 与 shared 根导出。
 
 本轮刻意未做：
 
@@ -738,6 +738,25 @@ store 当前混合了：
 
 最好在工作包 A 的目录骨架准备好后开始。
 
+### 当前进展（`2026-04-21`）
+
+工作包 B 已完成以下落地：
+
+1. 已把 `PreGameSelectionFlow.tsx` 降级为兼容入口，旧路径继续导出 `PreGameSelectionFlow`、`PreGameSelectionFlowProps`、`SelectionStage`。
+2. 已把 RPG 创作平台壳层的真实实现迁入 `src/components/game-shell/rpg-creation-flow/RpgCreationShellImpl.tsx`，并把该文件收口成“hooks 组合 + stage 视图装配 + 视觉级 loading/error”的壳层。
+3. `RpgCreationShell.tsx` 已直接桥接 `RpgCreationShellImpl.tsx`，新目录开始承接真实入口。
+4. 已新增 `rpgCreationFlowTypes.ts`、`rpgCreationFlowShared.ts`，把壳层类型与共享 helper 从旧入口文件中收出独立落点。
+5. 已接入 `useRpgCreationPlatformBootstrap.ts`、`useRpgCreationSessionController.ts`、`useRpgCreationAgentOperationPolling.ts`、`useRpgCreationDetailNavigation.ts`、`useRpgCreationResultAutosave.ts`、`useRpgCreationEnterWorld.ts`。
+6. 平台侧 works / library / gallery / history / save / dashboard 拉取、session 恢复、message streaming、action 执行、operation 轮询、detail navigation、结果页自动保存、enter-world 同步已不再直接堆在壳层组件中。
+7. 已完成 `PreGameSelectionFlow.agent.interaction.test.tsx` 的 14 个交互场景回归，以及壳层相关定向 eslint、编码检查。
+
+本轮刻意未做：
+
+1. 还没有物理删除 `PreGameSelectionFlow.tsx` 与其他旧兼容 façade，当前仍保留桥接层以避免影响并行工作包。
+2. 还没有让所有调用方统一显式改走 `RpgCreationShell` 新入口，当前允许旧路径兼容收口到新实现。
+3. 还没有把结果页 preview 数据源从前端兼容 adapter 切到服务端正式 preview contract，这部分仍属于后续工作包 G / H 与 Phase 3 范围。
+4. 还没有清理所有 legacy 兼容导出，本轮优先完成平台壳层编排拆分与主链稳定验证。
+
 ## 9.3 工作包 C：前端结果页与编辑器拆分
 
 ### 目标
@@ -761,6 +780,24 @@ store 当前混合了：
 
 依赖工作包 A 的命名规范与目录落点，和工作包 B 并行。
 
+### 当前进展（`2026-04-21`）
+
+工作包 C 已完成以下拆分落地：
+
+1. 已把 `CustomWorldResultView.tsx`、`CustomWorldEntityEditorModal.tsx`、`CustomWorldRoleAssetStudioModal.tsx` 的真实实现迁入 `src/components/rpg-creation-result/`、`src/components/rpg-creation-editor/`、`src/components/rpg-creation-asset-studio/`。
+2. 已把旧文件降级为兼容入口，现有调用仍可继续从旧路径导入，不影响当前主链行为。
+3. 结果页已拆出 `RpgCreationResultHeader`、`RpgCreationResultActionBar`、`RpgCreationAssetDebugPanel`、`useRpgCreationResultActions`，结果页主组件开始退化为组合壳层。
+4. 编辑器已补 `rpgCreationResultFormMapper.ts`，并把 `RpgCreationEntityEditorModalImpl.tsx` 收口成目标分发壳层；`world / cover / camp / playable / story / landmark` 已有稳定 section 入口。
+5. 编辑器当前保留 `RpgCreationEntityEditorShared.tsx` 作为阶段性 shared 实现承载体，避免在同一轮里高风险物理拆散 180KB 级表单细节；后续可在不改壳层接口的前提下继续向各 section 文件迁移。
+6. 角色资产工坊已补 `roleAssetStudioModel.ts`、`roleAssetStudioPublishClient.ts`、`useRoleVisualCandidateWorkflow.ts`、`useRoleAnimationWorkflow.ts`，并进一步拆出 `RpgCreationRoleVisualSection.tsx`、`RpgCreationRoleAnimationSection.tsx`、`RpgCreationRoleAssetStudioFooter.tsx`，当前主模态已退化为组合壳层。
+7. 旧 `CustomWorldResultView.tsx`、`CustomWorldEntityEditorModal.tsx`、`CustomWorldRoleAssetStudioModal.tsx` 兼容入口已统一桥接到 RPG 创作域 façade，而不是继续直连内部 `Impl` 文件。
+
+本轮刻意未做：
+
+1. 还没有把 `RpgCreationEntityEditorShared.tsx` 内部的全部表单实现物理拆成独立文件，当前先以“壳层 + section 入口 + shared 实现”完成工作包 C 收口。
+2. 还没有改平台壳层 `PreGameSelectionFlow.tsx` 的任何主状态编排，仍严格遵守工作包 C 的写入边界。
+3. 还没有把结果页从 legacy preview 兼容数据源切到服务端正式 preview contract，这部分属于后续工作包 D / G / H 的协作范围。
+
 ## 9.4 工作包 D：前端 custom world client 收口
 
 ### 目标
@@ -784,6 +821,24 @@ store 当前混合了：
 
 依赖工作包 A 的命名和目录约束；可与 B、C 并行。
 
+### 当前进展（`2026-04-21`）
+
+工作包 D 第一轮已完成以下落地：
+
+1. 已新增 `src/services/rpg-creation/rpgCreationRuntimeClient.ts` 与 `src/services/rpg-creation/rpgCreationRequestHelpers.ts`，把 RPG 创作域的 runtime 请求重试策略、POST JSON 与 SSE 请求辅助能力收口到新目录。
+2. `rpgCreationAgentClient.ts`、`rpgCreationWorkClient.ts`、`rpgCreationLibraryClient.ts`、`rpgCreationAssetClient.ts`、`rpgCreationGenerationClient.ts` 已从 façade 透传升级为真实请求实现，不再继续把主链请求代码堆在 `aiService.ts`、`storageService.ts` 中。
+3. `generateCustomWorldProfile()` 已正式迁入 `rpgCreationGenerationClient.ts`，世界生成入口也已纳入 RPG 创作域 client 边界。
+4. `aiService.ts` 中已迁出的 Agent / works / 世界生成 / 结果页实体生成接口已退化为兼容导出；`storageService.ts` 中 works / library / gallery / publish 链路也已退化为兼容导出。
+5. `PreGameSelectionFlow.tsx` 已开始直接从 `src/services/rpg-creation/` 消费 Agent / works / library / gallery / publish 请求，不再从旧 service 入口拿主链接口。
+6. `RpgCreationEntityEditorShared.tsx` 已把场景图生成请求切到 `rpgCreationAssetClient`，结果页与编辑器相关测试也已改为优先 mock 新的 RPG 创作域 client。
+7. 已完成 `rpgCreationGenerationClient.test.ts`、`storageService.test.ts`、`CustomWorldEntityEditorModal.test.tsx`、`CustomWorldResultView.test.tsx`、`PreGameSelectionFlow.agent.interaction.test.tsx` 的定向回归，以及编码检查。
+
+本轮刻意未做：
+
+1. 还没有物理删除 `aiService.ts`、`storageService.ts` 中的旧命名兼容导出，本轮优先保证调用迁移可平稳过渡。
+2. 还没有改平台壳层的内部流程编排与 hook 结构，这部分仍属于工作包 B。
+3. 还没有把结果页从 legacy preview 兼容数据源切到服务端正式 preview contract，这部分仍属于后续工作包 G / H 的协作范围。
+
 ## 9.5 工作包 E：后端 Agent 编排拆分
 
 ### 目标
@@ -809,6 +864,58 @@ store 当前混合了：
 
 建议在工作包 A 后开始；可与 B、C、D 并行。
 
+### 当前进展（`2026-04-21`）
+
+工作包 E 当前已完成 3 轮落地，真实状态如下：
+
+1. `customWorldAgentOrchestrator.ts` 已退化为后端应用服务 façade，只保留 session/message/action 主入口、operation 创建和下游服务委托；消息轮转、action 分发与派生状态重建已从热点文件中拆出。
+2. `CustomWorldAgentActionRegistry` 已正式接管 action 可用性校验、payload normalize、operation type 映射与 `supportedActions` 主链接线；前端不再需要按 action 字面量猜测按钮是否可点。
+3. `customWorldAgentActionExecutors/` 已补齐并接管以下真实执行链：
+   - `draft_foundation`
+   - `update_draft_card`
+   - `sync_result_profile`
+   - `generate_characters`
+   - `generate_landmarks`
+   - `generate_role_assets`
+   - `sync_role_assets`
+   - `generate_scene_assets`
+   - `sync_scene_assets`
+   - `expand_long_tail`
+   - `publish_world`
+   - `revert_checkpoint`
+4. `CustomWorldAgentMessageTurnService`、`CustomWorldAgentSnapshotBuilder`、`CustomWorldAgentResultSyncService`、`CustomWorldAgentQualityGateService`、`CustomWorldAgentSuggestedActionService` 已形成稳定协作边界：
+   - message turn 负责会话轮转
+   - snapshot builder 负责派生状态重建
+   - result sync service 负责结果页回写
+   - quality gate service 负责 `qualityFindings`
+   - suggested action service 负责建议动作
+5. 发布链已经统一切到 `CustomWorldAgentPublishingService`：
+   - orchestrator、executor map、publish executor、server 注入口径已经一致
+   - 发布 readiness 与正式写库走同一服务
+   - 作者展示名优先走 `resolveAuthorDisplayName`，同时保留 `userRepository` 兼容兜底
+   - 发布产物 `profileId` 固定优先沿用 legacy 结果页 ID，否则回退为 `agent-draft-${sessionId}`
+6. `sync_scene_assets` 已形成完整闭环：
+   - 营地/地点正式场景图会写回 draft profile
+   - 对应 `sceneChapters[].acts` 的 `backgroundImageSrc / backgroundAssetId` 会同步刷新
+   - `rebuildRoleAssetCoverage()` 已补 camp/landmark 正式场景资产 fallback 汇总，确保 snapshot 重建、works 读模型与 checkpoint 回放都能保住场景资产覆盖状态
+7. checkpoint 已收口为“可恢复真快照”：
+   - `buildCheckpointSnapshot()` 已接入关键 executor
+   - `revert_checkpoint` 现在依赖真实 checkpoint snapshot 与 `restoreCheckpoint()` 主链完成回滚，不再是只开放入口的空动作
+8. `CustomWorldAgentActionRegistry` 已重新收口阶段策略：
+   - `sync_result_profile`、`generate_scene_assets`、`sync_scene_assets` 等精修动作仅允许 `object_refining / visual_refining`
+   - `expand_long_tail`、`publish_world`、`revert_checkpoint` 单独允许 `long_tail_review / ready_to_publish`
+9. 已完成以下验证：
+   - `npm --prefix server-node run build`
+   - `npm --prefix server-node run test -- customWorldAgentPhase3.test.ts customWorldAgentActionRegistry.test.ts customWorldAgentPhase5.test.ts`
+   当前 `server-node` 定向回归共 `208` 项通过，已覆盖工作包 E 第三轮的发布链、场景资产、长尾扩展与 checkpoint 回滚主链。
+
+本轮刻意未做：
+
+1. 还没有进入 Phase 4 的“进入世界统一走发布态 gate”收口，当前只完成 `publish_world` 本身的后端闭环。
+2. 还没有改 `customWorldAgentSessionStore.ts` 与 repository 边界，这部分仍属于工作包 F。
+3. 还没有让前端结果页正式消费服务端 `resultPreview` 主链字段，这部分仍需要与工作包 G / H 协作。
+4. 旧 `customWorldAgentPublishGateService.ts`、`customWorldAgentPublishService.ts` 仍作为历史兼容文件保留，尚未进入物理删除阶段。
+
 ## 9.6 工作包 F：后端 session/store/repository 拆分
 
 ### 目标
@@ -832,6 +939,24 @@ store 当前混合了：
 
 与工作包 E 有接口协作关系，但可以并行推进，最终通过 façade 汇合。
 
+### 当前进展（`2026-04-21`）
+
+工作包 F 已完成以下拆分落地：
+
+1. 已新增 `server-node/src/services/rpg-agent-session-store/`，把 session record、compatibility、factory、repository adapter 从 `customWorldAgentSessionStore.ts` 中物理拆出。
+2. `customWorldAgentSessionStore.ts` 已退化为兼容 façade，保留原类名、原方法签名，并正式改为依赖 `RpgAgentSessionRepositoryPort`。
+3. 已新增 `server-node/src/repositories/RpgAgentSessionRepository.ts`、`server-node/src/repositories/RpgWorldProfileRepository.ts`、`server-node/src/repositories/rpgWorldRepositoryShared.ts`。
+4. `runtimeRepository.ts` 中的 custom world session/profile/gallery 读写已改成委托新仓储，runtime 大仓储开始向“通用 runtime façade”收口。
+5. 已新增 `server-node/src/services/RpgWorldWorkCoverResolver.ts`、`server-node/src/services/RpgWorldWorkSummaryAssembler.ts`、`server-node/src/services/RpgWorldWorkSummaryService.ts`，把 works 读模型的封面解析、条目组装与服务入口从 `customWorldWorkSummaryService.ts` 中拆出。
+6. `context.ts`、`server.ts`、`runtimeRoutes.ts`、`syncCustomWorldSavedProfileAssets.ts` 已切到直接注入和使用 `RpgAgentSessionRepository`、`RpgWorldProfileRepository`、`RpgWorldWorkSummaryService`。
+7. `customWorldAgentPhase2~5` 与 `customWorldWorkSummaryService.integration.test.ts` 已切到新的 session/profile 内存仓储端口，定向回归 21 项全部通过。
+
+本轮刻意未做：
+
+1. `RuntimeRepositoryPort` 仍保留兼容 façade 与 custom world 相关旧方法，现阶段先稳住 story/runtime 其他调用方。
+2. `RuntimeRepository` 中的 runtime 快照同步编排还没有继续下沉，当前先完成 custom world 持久化与 works 读模型边界拆分。
+3. `customWorldAgentSessionStore.ts`、`customWorldWorkSummaryService.ts` 等旧命名 façade 仍保留，等待后续统一命名和兼容层清理阶段再删除。
+
 ## 9.7 工作包 G：后端 preview compiler 与 runtime profile 目录化
 
 ### 目标
@@ -855,6 +980,33 @@ store 当前混合了：
 
 与工作包 E、F 并行，但在主链接入前需要先和 E 对齐 preview contract。
 
+### 当前进展（`2026-04-21`）
+
+工作包 G 已完成以下落地：
+
+1. 已新增 `server-node/src/modules/custom-world/runtime-profile/` 目录入口，并把原 `runtimeProfile.ts` 退化为兼容 façade。
+2. 已把 runtime profile 进一步物理拆分到：
+   - `normalizeShared.ts`
+   - `normalizeRole.ts`
+   - `normalizeLandmark.ts`
+   - `normalizeSceneChapter.ts`
+   - `normalizeCamp.ts`
+   - `buildCompiledProfile.ts`
+   - `buildAttributeSchema.ts`
+   - `creatorIntentBridge.ts`
+3. `runtimeProfileCompiler.ts` 已退化为兼容 façade，不再承载主实现。
+4. `RpgWorldPreviewCompiler.ts` 已从简单别名升级为服务端 preview compiler 入口，新增 preview envelope 输出能力。
+5. `packages/shared/src/contracts/rpgCreationPreview.ts` 已补 `RpgCreationPreviewSource`，并在 Phase 5 后把 session 结果页正式 source 收口为 `session_preview`。
+6. `customWorldAgentFoundationDraftService.ts` 的 LLM foundation draft 主生成链已改成“直接组装 draft 主字段 + 单独保留 `legacyResultProfile` 兼容快照”，不再通过 preview compiler 反解草稿主字段。
+7. 已新增 `server-node/src/services/RpgWorldPreviewCompiler.test.ts`、`server-node/src/services/customWorldAgentFoundationDraftService.test.ts`，并完成编码检查与工作包 G 定向回归验证。
+
+本轮刻意未做：
+
+1. 还没有把 preview contract 从当前 runtime-profile 兼容载体升级成独立 view model。
+2. 还没有让 orchestrator、route、前端结果页正式消费 preview envelope。
+3. `legacyResultProfile` 仍作为结果页兼容快照保留，相关消费链还没有完全脱离 legacy profile 富字段。
+4. 兼容 façade `runtimeProfile.ts` / `runtimeProfileCompiler.ts` 仍保留，等待后续阶段统一清理。
+
 ## 9.8 工作包 H：共享契约与测试基建
 
 ### 目标
@@ -878,6 +1030,34 @@ store 当前混合了：
 
 可从工作包 A 开始先建骨架，随后跟随 B 到 G 持续补齐。
 
+### 当前进展（`2026-04-21`）
+
+工作包 H 已完成以下落地：
+
+1. 已把 `rpgAgentAnchors.ts`、`rpgAgentDraft.ts`、`rpgAgentActions.ts`、`rpgAgentSession.ts`、`rpgCreationPreview.ts`、`rpgCreationWorkSummary.ts` 从类型别名骨架推进为真实共享契约定义。
+2. 已把旧 `packages/shared/src/contracts/customWorldAgent.ts` 降级为兼容聚合出口，并补齐：
+   - `customWorldAgentAnchors.ts`
+   - `customWorldAgentDraft.ts`
+   - `customWorldAgentActions.ts`
+   - `customWorldAgentSession.ts`
+   - `customWorldResultPreview.ts`
+   - `customWorldWorkSummary.ts`
+   让旧命名导入可以按分域文件渐进迁移，而不是继续依赖单一大文件。
+3. 已新增 `packages/shared/src/contracts/rpgCreationFixtures.ts`，补齐八锚点、foundation draft、session、preview、published profile、library、works 等共享样本，并把 fixture 接入 `packages/shared/src/index.ts` 统一导出。
+4. 已把 shared contract tests 接入 `vitest.config.ts`，并补齐 `packages/shared/src/contracts/rpgContracts.test.ts`，覆盖 session snapshot、preview envelope、published profile、works summary，以及旧命名兼容分文件的类型消费。
+5. 已新增 `server-node/src/services/RpgWorldPreviewCompiler.fixture.test.ts`、`server-node/src/services/RpgWorldWorkSummaryAssembler.fixture.test.ts`、`server-node/src/services/customWorldWorkSummaryService.integration.test.ts`，把 preview compiler、works assembler、works service 对共享 fixture 的消费纳入 unit / integration / regression 回归。
+6. 已补 `server-node/src/services/RpgWorldWorkSummaryService.ts` 兼容实现，确保 works 兼容入口与当前 `rpgWorldProfiles + customWorldAgentSessions` 读模型服务口径一致。
+7. `customWorldAgentOrchestrator.ts` 已新增统一 session snapshot 装配入口，当前普通拉取与 SSE message stream 返回的 session 字段口径开始收口。
+8. 服务端 `RpgWorldPreviewCompiler` 输出已正式接入 session snapshot 的 `resultPreview` 字段，并复用当前 `qualityFindings` 生成 preview `qualityFindings / blockers` 兼容输出。
+9. `rpg-agent-session-store/rpgAgentSessionCompatibility.test.ts` 已覆盖“compatibility 脱离 store 直接单测”的主链能力，Phase 2 的 session 兼容层开始具备独立回归保障。
+10. `src/app.test.ts` 已补“custom world agent stream message returns enriched session payload over sse”回归，session snapshot / resultPreview / supportedActions 的 HTTP 与 SSE 响应口径开始统一验证。
+
+本轮刻意未做：
+
+1. 还没有批量迁移仓库里所有旧 `customWorldAgent.ts` 导入到 `rpgAgent* / rpgCreation*`。
+2. 还没有批量把前端结果页与自动保存链统一切到服务端 `resultPreview`。
+3. 还没有把服务端 preview contract 从 legacy profile 兼容载体升级成独立 view model。
+
 ## 9.9 并行推进关系
 
 推荐并行顺序如下：
@@ -986,6 +1166,23 @@ store 当前混合了：
 2. 自动保存与 session 同步都基于服务端确认后的 preview
 3. 结果页字段回退问题不再依赖前端兼容修补
 
+### 当前进展（`2026-04-21`）
+
+Phase 3 本轮已完成以下主链接线：
+
+1. 前端 `rpgCreationPreviewAdapter.ts` 已正式改成“优先读取 `session.resultPreview`，本地 `draftProfile -> legacy result profile` 只做 fallback”的薄适配层。
+2. `useRpgCreationSessionController.ts`、`useRpgCreationResultAutosave.ts`、`useRpgEntryLibraryDetail.ts` 所在的 Agent 结果页打开链、自动保存链、继续创作恢复链，已统一通过 `buildPreviewFromSession()` 消费服务端 preview。
+3. `RpgEntryFlowShellImpl.tsx` 当前传给结果页自动保存与创作入口恢复的 `buildDraftResultProfile` 已切到服务端 preview 主链，不再把前端本地编译结果当成正式真相源。
+4. 前端 fallback 编译实现已迁入 `src/services/rpg-creation/rpgCreationPreviewDraftFallback.ts`，旧 `src/services/customWorldAgentDraftResult.ts` 已退化为兼容 re-export，不再继续承载主实现。
+5. 已新增 `src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts`，补齐“服务端 `resultPreview` 优先于本地 draft fallback”的回归断言。
+6. `PreGameSelectionFlow.agent.interaction.test.tsx` 已补充“没有 `legacyResultProfile` 也能凭服务端 preview 打开 Agent 结果页”的交互回归，验证结果页主链已切到后端 preview。
+
+本轮刻意未做：
+
+1. `src/services/customWorldAgentDraftResult.ts` 仍保留，但当前已退化为兼容 re-export；真实 fallback 编译实现已迁到 `src/services/rpg-creation/rpgCreationPreviewDraftFallback.ts`，尚未物理删除该兼容入口。
+2. `legacyResultProfile` 仍保留在 session draft 中参与兼容输出，本轮没有越界清理后端兼容字段。
+3. 结果页 UI 还没有显式消费 `qualityFindings / blockers / preview source` 做额外展示，当前先完成主数据源迁移，不扩大 UI 变更面。
+
 ## Phase 4：发布链、自动保存链、进入世界链统一
 
 ### 目标
@@ -1004,6 +1201,50 @@ store 当前混合了：
 2. works、library、enter world 三处状态语义一致
 3. 发布失败可以给出明确 blocker 与恢复入口
 
+### 当前进展（`2026-04-21`）
+
+Phase 4 本轮已完成以下主链接线：
+
+1. 服务端 `customWorldAgentPublishingService.ts` 已补结构化 `evaluatePublishReadiness()`，把 publish blocker 从“只在发布时报错”提升为可供 session preview、结果页和 works 读模型统一消费的后端真相。
+2. `customWorldAgentOrchestrator.ts` 当前输出的 `session.resultPreview` 已补：
+   - `publishReady`
+   - `canEnterWorld`
+   - 基于发布门槛而不是仅 `qualityFindings` 生成的 `blockers`
+   让结果页可以直接消费正式 gate 语义。
+3. `RpgWorldWorkSummaryAssembler.ts` 已把 works 读模型进一步收口：
+   - 已进入 `published` 阶段的 Agent session 不再继续以草稿项出现在 works 创作中心
+   - draft works 新增 `blockerCount / publishReady`
+   - published works 明确输出 `canEnterWorld=true`
+4. 前端 Agent 结果页已开始消费服务端 Phase4 状态：
+   - 结果页在 Agent 草稿未发布时把主 CTA 改成“发布并进入世界”
+   - 结果页会展示服务端 preview source、publish blockers、warning 数量
+   - 有 blocker 时会禁用“发布并进入世界”按钮，不再让前端继续假装可以直接进入世界
+5. `useRpgCreationEnterWorld.ts` 与 `RpgEntryFlowShellImpl.tsx` 已把 Agent 结果页进入世界主链改成：
+   - 先 `sync_result_profile`
+   - 再执行后端 `publish_world`
+   - 发布成功后才进入世界
+   不再允许 Agent 草稿结果页绕开 publish gate 直接起游戏。
+6. `RpgEntryWorldDetailView.tsx` 已把作品详情页草稿态的主按钮改成“请先发布作品”，避免 detail 页继续暗示未发布作品可以直接开始游戏。
+7. 已补回归测试覆盖：
+   - 服务端 `customWorldAgentPhase4.test.ts`
+   - 服务端 `customWorldAgentPhase5.test.ts`
+   - 服务端 `RpgWorldWorkSummaryAssembler.fixture.test.ts`
+   - 前端 `CustomWorldResultView.test.tsx`
+   - 前端 `PreGameSelectionFlow.agent.interaction.test.tsx`
+8. 作品库 detail 页的“发布到广场”入口已统一复用 Agent Phase4 publish gate：
+   - `/api/runtime/custom-world-library/:profileId/publish` 在命中 `agent-draft-${sessionId}` 且 session 真实存在时，不再直接绕过 gate 调 `publishOwnProfile()`
+   - 现在会先复用 `CustomWorldAgentPublishingService` 的 blocker 判断
+   - publish 成功后同步把对应 session 推进到 `published`
+   - detail 页、works、gallery 三处发布态语义已对齐到同一条后端主链
+9. 已补 HTTP 级回归测试覆盖 detail publish 主链：
+   - 服务端 `app.test.ts` 已新增“agent-backed detail publish 在 blocker 存在时返回明确错误”
+   - 服务端 `app.test.ts` 已新增“agent-backed detail publish 成功后同步发布 profile 与 session”
+
+本轮刻意未做：
+
+1. 旧兼容作品草稿的 detail publish 还没有强行套入 Agent publish gate，当前只在 `agent-draft-${sessionId}` 且 session 真实存在时切换到统一发布链，避免在未补齐兼容映射前误伤历史作品。
+2. 运行态真正的“进入世界解析”仍然是前端把 profile 交给 runtime session bootstrap，本轮先完成 Agent 创作主链的 publish gate 收口与 UI 阻断，不扩大到 runtime 启动协议改造。
+
 ## Phase 5：兼容层清理
 
 ### 目标
@@ -1022,6 +1263,27 @@ store 当前混合了：
 2. 不再存在“前端本地编译 profile 才能自动保存”的依赖
 3. 文档、契约、测试口径一致
 
+### 当前进展（`2026-04-21`）
+
+Phase 5 本轮已完成以下主链清理：
+
+1. 服务端已新增 `server-node/src/services/rpgCreationPreviewProfileBuilder.ts`，把“foundation draft + legacyResultProfile 富字段 + 最新草稿资产”的合并规则正式收回后端，preview 与 publish 开始复用同一套兼容编译口径。
+2. `customWorldAgentOrchestrator.ts` 当前产出的 `session.resultPreview` 已不再依赖前端本地 fallback：
+   - 预览 profile 改为基于服务端 `rpgCreationPreviewProfileBuilder` 构建
+   - preview source 已从兼容期的 `legacy_custom_world_profile` 收口为正式主链值 `session_preview`
+3. 前端 `rpgCreationPreviewAdapter.ts` 已改成只消费服务端 `session.resultPreview`，结果页、继续创作、自动保存、发布后进入世界所复用的 `buildPreviewFromSession()` 不再承担本地 `draftProfile -> result profile` 编译职责。
+4. 结果页与编辑器目录内部的旧 façade 依赖已继续收口，当前 RPG 创作目录内部不再通过已删除旧文件反向跳转结果页/编辑器/资产工坊主链。
+5. 前后端测试口径已同步切到 Phase 5：
+   - 前端 `rpgCreationPreviewAdapter.test.ts`、`PreGameSelectionFlow.agent.interaction.test.tsx` 已统一改为消费 `session_preview`
+   - 服务端 `RpgWorldPreviewCompiler.test.ts` 已新增“preview builder 保留 legacy 富字段并合并最新草稿资产”的回归
+   - 服务端 `customWorldAgentPhase3.test.ts`、`customWorldAgentPhase4.test.ts`、`app.test.ts` 已把 preview source 断言更新为 `session_preview`
+
+本轮刻意未做：
+
+1. 后端 `legacyResultProfile` 兼容字段仍保留在 foundation draft / result sync / publishing service 中，当前只是把“如何消费它”统一后移到服务端 preview / publish compiler，而不是继续让前端主链本地重编译。
+2. 旧命名 façade 如 `customWorldAgentSessionStore.ts`、`customWorldWorkSummaryService.ts`、`runtimeProfile.ts` 仍保留，因它们还在后端兼容与模块边界层承担真实职责，不属于本轮必须删除项。
+3. shared contracts 中旧 `customWorld*` 分域兼容导出仍保留，当前只收口真实定义与 preview source 语义，不越界做全仓库导入迁移。
+
 ---
 
 ## 11. 本次执行约束
@@ -1047,3 +1309,193 @@ store 当前混合了：
 **session 真相源 -> 服务端 preview 编译 -> published profile 发布态**
 
 只有这样，当前链路的可读性、可扩展性和后续功能落地稳定性，才会一起提升。
+
+---
+
+## 13. 2026-04-21 执行核查与老流程清理记录
+
+本节用于记录本次按执行方案做的真实完成度核查、测试结果与老流程删除情况，避免“文档宣称已完成”和“代码真实状态”继续漂移。
+
+### 13.1 本轮核查口径
+
+本轮围绕以下 3 件事执行：
+
+1. 对照工作包 A / B / D / E / F / G / H 进度文档，核对真实代码入口与引用关系。
+2. 运行创作链相关与全量测试，确认当前主链真实可用范围。
+3. 只删除已经确认不再承载业务逻辑的旧流程桥接入口，不提前删除仍承担兼容编译责任的模块。
+
+### 13.2 核查结论
+
+当前可以确认：
+
+1. 工作包 B、D、E、F、G、H 的首轮主体拆分已经真实落地，且对应的新目录、hooks、client、service、repository、compiler 文件已存在。
+2. 工作包 C 的结果页、编辑器、资产工坊拆分也已基本落地到 `rpg-creation-result/`、`rpg-creation-editor/`、`rpg-creation-asset-studio/` 新目录。
+3. Phase 3、Phase 4、Phase 5 的主链接线与兼容层清理现已完成；当前剩余的是后端兼容字段与旧命名 façade 的保留问题，不能再把它们等同于“前端主链仍依赖老流程”。
+
+### 13.3 本轮已物理删除的老流程入口
+
+本轮已确认以下旧入口仅剩桥接职责，且完成引用迁移后可以安全物理删除：
+
+1. `src/components/game-shell/PreGameSelectionFlow.tsx`
+2. `src/components/CustomWorldResultView.tsx`
+3. `src/components/CustomWorldEntityEditorModal.tsx`
+
+同步完成的调用迁移包括：
+
+1. `GameShellMainContent.tsx` 已改为直接 lazy import `rpg-creation-flow` 新入口。
+2. `useGameShellViewModel.ts` 已改为直接从 `rpg-creation-flow` 取 `SelectionStage`。
+3. 结果页、编辑器与对应测试已切到 `rpg-creation-result/`、`rpg-creation-editor/` 新入口。
+4. `RpgCreationShellImpl.tsx` 已改为直接 lazy import `RpgCreationResultView` 新入口，不再回退到已删除旧结果页文件。
+
+### 13.4 本轮明确不能删除的兼容层
+
+以下模块本轮核查后确认仍在主链中承担真实兼容职责，暂时不能物理删除：
+
+1. `src/services/rpg-creation/rpgCreationPreviewAdapter.ts`
+2. `server-node/src/services/customWorldAgentSessionStore.ts`
+3. `server-node/src/services/customWorldWorkSummaryService.ts`
+4. `server-node/src/services/customWorldAgentOrchestrator.ts`
+5. `server-node/src/modules/custom-world/runtimeProfile.ts`
+
+原因分别是：
+
+1. `rpgCreationPreviewAdapter.ts` 仍是前端消费服务端 preview 的统一 façade，只是已经不再承担本地 fallback 编译。
+2. 后端仍通过 `legacyResultProfile` 参与阶段性结果回写与兼容输出。
+3. 多个旧命名 façade 仍被 server、context、tests 或 UI 入口直接引用。
+
+### 13.5 本轮测试结果
+
+已执行并确认结果如下：
+
+1. `npm run check:encoding`
+   结果：通过。
+2. `npm --prefix server-node run test`
+   结果：通过，`192` 项测试全部通过。
+3. `npm --prefix server-node run build`
+   结果：通过。
+4. `npm --prefix server-node run test -- --test-name-pattern="action registry|phase5 publish_world|phase5 generate_scene_assets|phase5 publish_world blocks incomplete|phase5 revert_checkpoint|phase5 expand_long_tail"`
+   结果：通过，`208` 项测试全部通过，已覆盖工作包 E 第三轮发布链、场景资产、长尾扩展与 checkpoint 回滚主链。
+5. `npm run test -- src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx src/components/CustomWorldResultView.test.tsx src/components/CustomWorldEntityEditorModal.test.tsx`
+   结果：通过，`34` 项测试全部通过。
+6. `npm run test`
+   结果：失败，但失败点与本轮删除旧入口无直接关系；创作链相关定向回归已通过。
+7. `npm run build`
+   结果：Vite 构建成功，但 build gate 因 chunk warning 失败，属于既有构建门禁问题。
+8. `npm run typecheck`
+   结果：失败，存在 shared contracts、story contracts、runtime data、旧测试断言等既有类型问题，当前不适合作为本轮创作链清理通过口径。
+9. `npm --prefix server-node test -- src/services/customWorldAgentPhase3.test.ts src/services/customWorldAgentPhase4.test.ts src/services/customWorldAgentActionRegistry.test.ts src/services/RpgWorldPreviewCompiler.test.ts`
+   结果：本轮新增的 `resultPreview` / `supportedActions` 主链断言已通过，但定向命令仍被一个既有 `customWorldAgentFoundationDraftService.test.ts` 断言失败带停，失败点与本轮 session snapshot 装配改动无直接耦合。
+10. `npm --prefix server-node run build`
+   结果：通过。
+11. `npm run test -- src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx`
+   结果：通过，`17` 项测试全部通过。
+12. `node --test --import tsx src/services/customWorldAgentActionRegistry.test.ts`
+   结果：通过，`5` 项测试全部通过。
+13. `node --test --import tsx src/services/customWorldAgentPhase5.test.ts`
+   结果：通过，`7` 项测试全部通过，已覆盖 `publish_world`、`generate_scene_assets`、`sync_scene_assets`、`expand_long_tail`、`revert_checkpoint` 的 Phase 5 主链回归。
+14. `node --test --import tsx src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.test.ts`
+   结果：通过，`2` 项测试全部通过。
+15. `node --test --import tsx src/app.test.ts`
+   结果：通过，`55` 项测试全部通过，包含 SSE enriched session 回归。
+15. `node --test --import tsx src/services/customWorldAgentPhase3.test.ts src/services/customWorldAgentPhase4.test.ts`
+   结果：通过，`11` 项测试全部通过。
+16. `npm --prefix server-node run build`
+   结果：通过。
+17. `npm run check:encoding`
+   结果：通过，`1877` 个文件编码检查通过。
+18. `npm run test -- src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx`
+   结果：通过，`20` 项测试全部通过；已验证前端结果页主链不再依赖本地 preview fallback。
+19. `node --test --test-concurrency=1 --import tsx src/services/customWorldAgentActionRegistry.test.ts src/services/customWorldAgentPhase3.test.ts src/services/customWorldAgentPhase5.test.ts`
+   结果：通过，`16` 项测试全部通过；已验证 action registry 契约清理、Phase3 preview source 口径与 Phase5 发布链回归均正常。
+
+### 13.6 当前全量阻塞项
+
+截至 `2026-04-21` 本轮核查结束时，仓库仍存在以下全量阻塞：
+
+1. `server-node/src/app.test.ts` 存在未解决合并冲突。
+2. `src/hooks/story/npcEncounterActions.test.ts` 存在未解决合并冲突。
+3. 前端全量 Vitest 仍有 3 个失败用例：
+   - `src/components/game-shell/useGameShellRuntimeViewModel.test.ts`
+   - `src/data/functionCatalog/functionCatalog.test.ts`
+   - `src/hooks/story/npcEncounterActions.test.ts`
+4. 前端全量 TypeScript 检查仍有多处既有错误。
+5. 前端 build gate 仍被大 chunk warning 阻断。
+
+### 13.7 完成度判断
+
+按执行方案分阶段判断，当前更准确的状态是：
+
+1. Phase 1：主体完成，并已开始物理清理前端旧入口。
+2. Phase 2：后端拆分主体完成，`snapshot / supportedActions / resultPreview / SSE enriched session / session compatibility` 主链都已有定向回归覆盖；但旧命名 façade 兼容层仍保留，且发布链统一语义尚未进入 Phase 4 收口态。
+3. Phase 3：主链接线已完成，前端结果页、自动保存与创作恢复入口已切到服务端 `resultPreview`；但本地 preview fallback 与 `legacyResultProfile` 兼容层仍保留，尚未进入 Phase 5 清理态。
+4. Phase 4：部分完成，`publish_world` 已有真实 executor 与 gate 接线，但 publish gate / enter world / works 状态语义还没有完全统一到后端正式发布态。
+4. Phase 4：主链完成。Agent 结果页、works 聚合、detail publish 与进入世界阻断已统一到后端正式发布态；当前剩余仅是 runtime 启动协议与旧兼容草稿映射，不再属于本阶段必须项。
+5. Phase 5：主链完成。前端本地 preview 编译桥、结果页旧入口影子引用、执行型废弃 action 契约已清理完成；当前剩余仅是后端 `legacyResultProfile` 兼容字段与旧命名 façade 保留，不再阻塞本阶段验收。
+
+### 13.8 后续删除顺序建议
+
+后续继续删除老流程代码时，应严格按下面顺序推进：
+
+1. 先完成 `qualityFindings / blockers / preview source` 的结果页与 gate 消费，把 Phase 4 所需阻断语义真正接到 UI 与进入世界链。
+2. 再按后端兼容迁移节奏收缩 `legacyResultProfile` 写回范围，而不是恢复前端本地 preview 编译桥。
+3. 再删除 `customWorldAgentSessionStore.ts`、`customWorldWorkSummaryService.ts`、`runtimeProfile.ts` 等旧命名 façade。
+4. 最后清理 `customWorld*` 旧契约聚合入口与剩余测试旧导入。
+
+### 13.9 Phase 4 本轮追加落地（`2026-04-21`）
+
+本轮围绕 Phase 4 继续补齐了“发布链、自动保存链、进入世界链统一”的剩余断点：
+
+1. 服务端 `CustomWorldAgentPublishingService` 已新增统一的 publish gate 摘要出口，`resultPreview` 与 works 聚合现在复用同一套 `blockers / publishReady / canEnterWorld` 判断，不再各自重复拼门禁语义。
+2. `RpgWorldWorkSummaryAssembler` 已改为跳过 `stage === published` 的 session 草稿项，避免作品中心在正式发布后同时出现“已发布 profile + 已发布 session 草稿”双份状态。
+3. works 草稿项的 `publishReady / blockerCount` 已从“只看 qualityFindings”切到真实 publish gate 结果，作品中心、结果页与发布执行器开始共享同一套阻断口径。
+4. 前端 Agent 结果页继续沿用服务端 `resultPreview`，并在“发布并进入世界”成功后优先消费发布后的 preview/profile，而不是直接把 preview 原始对象强转成运行时 profile。
+5. 已补 `RpgWorldWorkSummaryAssembler.fixture.test.ts`、`customWorldWorkSummaryService.integration.test.ts` 与 `PreGameSelectionFlow.agent.interaction.test.tsx` 回归，覆盖 works 去重、publish gate 口径一致，以及“先发布再进入世界”主链。
+6. 共享 fixture 已补齐 `generatedSceneAssetId / publishReady / blockerCount / canEnterWorld` 等 Phase 4 口径字段，默认基线样本现在能够真实通过服务端 publish gate，避免 works / preview / 测试断言继续使用“前端自定义假 ready”状态。
+7. 前端“发布并进入世界”交互回归已改为状态驱动 mock：结果页打开前保持 `ready_to_publish`，仅在 `publish_world` 完成后切换为 `published`，从而覆盖 Phase 4 真实的“草稿结果页 -> 发布 -> 进入世界”顺序，而不是直接伪造已发布初始态。
+
+本轮仍未完成：
+
+1. Agent 工作区内还没有独立的“发布世界”快捷入口，当前主入口仍在结果页。
+2. 旧兼容作品草稿的 detail publish 仍保留旧作品库接口，不属于本次 Agent Phase 4 主链统一范围。
+
+### 13.10 老脚本依赖删除追加记录（`2026-04-21`）
+
+本轮按“不要再与老脚本有依赖”的口径继续执行物理清理，完成以下事项：
+
+1. 前端 RPG 创作主链已切到 `Rpg*` client 命名：
+   - `src/components/rpg-entry/useRpgCreationSessionController.ts` 直接调用 `createRpgCreationSession / getRpgCreationSession / streamRpgCreationMessage / executeRpgCreationAction`
+   - `src/components/rpg-entry/useRpgCreationResultAutosave.ts` 直接调用 `executeRpgCreationAction / getRpgCreationOperation / upsertRpgWorldProfile`
+2. `src/services/rpg-creation/` 已删除旧命名导出：
+   - 不再导出 `createCustomWorldAgentSession / executeCustomWorldAgentAction / getCustomWorldAgentSession`
+   - 不再导出 `listCustomWorldWorks / upsertCustomWorldProfile / listCustomWorldLibrary`
+   - 不再导出结果页实体生成的 `generateCustomWorldPlayableNpc / generateCustomWorldSceneImage` 等兼容别名
+3. 旧 service 聚合入口已断开：
+   - `src/services/aiService.ts` 不再 re-export RPG 创作链能力
+   - `src/services/storageService.ts` 已删除，运行时存档、设置、作品入口能力已迁入 `rpg-entry / rpg-runtime` 域 client
+4. 旧组件入口继续物理删除：
+   - `src/components/CustomWorldRoleAssetStudioModal.tsx`
+   - `src/components/CustomWorldResultView.tsx`
+   - `src/components/CustomWorldEntityEditorModal.tsx`
+   - `src/components/game-shell/PreGameSelectionFlow.tsx`
+5. 新组件入口已删除旧命名导出：
+   - `RpgCreationResultView.tsx` 只导出 `RpgCreationResultView`
+   - `RpgCreationEntityEditorModal.tsx` 只导出 `RpgCreationEntityEditorModal / RpgCreationEditorTarget`
+   - `RpgCreationRoleAssetStudioModal.tsx` 只导出 `RpgCreationRoleAssetStudioModal`
+6. 已使用源码级扫描确认 `src / packages / server-node` 中不再存在以下旧主链符号引用：
+   - `createCustomWorldAgentSession`
+   - `executeCustomWorldAgentAction`
+   - `getCustomWorldAgentSession`
+   - `streamCustomWorldAgentMessage`
+   - `listCustomWorldWorks`
+   - `upsertCustomWorldProfile`
+   - `CustomWorldRoleAssetStudioModal`
+   - `CustomWorldResultView`
+   - `CustomWorldEntityEditorModal`
+7. 本轮未删除 `CustomWorldProfile` 等历史数据结构类型名，也未删除 `server-node` 侧仍承担真实兼容职责的旧命名 façade；这些属于后端兼容字段与契约命名迁移，不再是前端老脚本依赖。
+8. 本轮验证结果：
+   - `npm run test -- src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts src/components/CustomWorldResultView.test.tsx src/components/CustomWorldEntityEditorModal.test.tsx src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx`
+     结果：通过，`42` 项测试全部通过。
+   - `npm run test -- src/services/rpg-creation/rpgCreationGenerationClient.test.ts`
+     结果：通过，`2` 项测试全部通过。
+   - `npm run check:encoding`
+     结果：通过，`1929` 个文件编码检查通过。
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
index f9e0627a..087aab57 100644
--- a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
@@ -53,15 +53,18 @@
 已新增以下共享契约入口：
 
 1. `packages/shared/src/contracts/rpgAgentAnchors.ts`
-2. `packages/shared/src/contracts/rpgAgentSession.ts`
-3. `packages/shared/src/contracts/rpgAgentActions.ts`
-4. `packages/shared/src/contracts/rpgCreationPreview.ts`
-5. `packages/shared/src/contracts/rpgCreationWorkSummary.ts`
+2. `packages/shared/src/contracts/rpgAgentDraft.ts`
+3. `packages/shared/src/contracts/rpgAgentSession.ts`
+4. `packages/shared/src/contracts/rpgAgentActions.ts`
+5. `packages/shared/src/contracts/rpgCreationPreview.ts`
+6. `packages/shared/src/contracts/rpgCreationWorkSummary.ts`
 
 当前策略：
 
 1. 会话、动作、作品摘要先从旧 `customWorldAgent.ts` 做类型级兼容导出。
-2. `rpgCreationPreview.ts` 明确标记当前 preview 仍是 legacy profile 兼容载体，避免误认为 preview contract 已经完成。
+2. `rpgAgentDraft.ts` 先把 foundation draft、draft card 等草稿相关类型收口成独立入口，给工作包 H 后续物理拆分预留稳定导入点。
+3. `packages/shared/src/index.ts` 已补上对 RPG 草稿契约骨架的根导出，避免后续工作包继续回退到旧 `customWorldAgent.ts` 取类型。
+4. `rpgCreationPreview.ts` 明确标记当前 preview 仍是 legacy profile 兼容载体，避免误认为 preview contract 已经完成。
 
 ## 3. 本次没有做的事
 
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..22c14101
--- /dev/null
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md
@@ -0,0 +1,106 @@
+# 创作流程链路重构工作包 B 完成记录
+
+更新时间：`2026-04-21`
+
+## 1. 本轮目标
+
+工作包 B 聚焦前端平台壳层与流程编排拆分，本轮目标是把平台壳层从“大编排文件”收口成“页面壳层 + 独立 hooks / coordinator”：
+
+1. `PreGameSelectionFlow.tsx` 退化为兼容入口。
+2. `RpgCreationShellImpl.tsx` 只保留 stage 切换、组件装配、视觉级 loading / error。
+3. 平台 bootstrap、session controller、operation polling、detail navigation、result autosave、enter-world 逻辑全部迁入 `src/components/game-shell/rpg-creation-flow/` 新目录。
+4. 保证现有交互测试继续通过，不引入主链行为回退。
+
+---
+
+## 2. 已完成内容
+
+### 2.1 旧入口已退化为兼容层
+
+`src/components/game-shell/PreGameSelectionFlow.tsx` 现在只保留：
+
+1. 旧类型导出兼容：`PreGameSelectionFlowProps`、`SelectionStage`
+2. 旧组件名兼容：`PreGameSelectionFlow`
+3. 对新实现 `RpgCreationShellImpl` 的桥接
+
+这样现有调用方和测试仍可继续走旧路径，不会因为命名迁移立即破坏主链。
+
+### 2.2 新目录已承接真实实现与流程 hooks
+
+已新增或更新以下文件：
+
+1. `src/components/game-shell/rpg-creation-flow/RpgCreationShellImpl.tsx`
+2. `src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx`
+3. `src/components/game-shell/rpg-creation-flow/index.ts`
+4. `src/components/game-shell/rpg-creation-flow/rpgCreationFlowTypes.ts`
+5. `src/components/game-shell/rpg-creation-flow/rpgCreationFlowShared.ts`
+6. `src/components/game-shell/rpg-creation-flow/useRpgCreationPlatformBootstrap.ts`
+7. `src/components/game-shell/rpg-creation-flow/useRpgCreationSessionController.ts`
+8. `src/components/game-shell/rpg-creation-flow/useRpgCreationAgentOperationPolling.ts`
+9. `src/components/game-shell/rpg-creation-flow/useRpgCreationDetailNavigation.ts`
+10. `src/components/game-shell/rpg-creation-flow/useRpgCreationResultAutosave.ts`
+11. `src/components/game-shell/rpg-creation-flow/useRpgCreationEnterWorld.ts`
+
+其中：
+
+1. `RpgCreationShell.tsx` 已不再桥接旧 `PreGameSelectionFlow`，而是直接桥接 `RpgCreationShellImpl.tsx`。
+2. `index.ts` 已开始从新目录导出 `SelectionStage`，为后续调用迁移准备统一出口。
+
+### 2.3 平台编排已全部拆入独立 coordinator
+本轮已经把原 `PreGameSelectionFlow` / `RpgCreationShellImpl` 中的主链编排拆到以下 hook：
+
+1. `useRpgCreationPlatformBootstrap.ts`
+   - 平台首页 works / library / gallery / history / save / dashboard 拉取
+   - 浏览历史写入与存档恢复
+2. `useRpgCreationSessionController.ts`
+   - Agent session 创建 / 恢复
+   - 消息流、action 执行、草稿生成态与结果页自动打开
+3. `useRpgCreationAgentOperationPolling.ts`
+   - Agent operation 轮询
+   - 完成态 session 刷新与失败兜底
+4. `useRpgCreationDetailNavigation.ts`
+   - 作品详情、创作作品恢复、草稿结果页打开
+   - 详情页发布 / 下架 / 删除
+5. `useRpgCreationResultAutosave.ts`
+   - 结果页自动保存
+   - `sync_result_profile` 协调
+   - 保存签名去重与延时保存
+6. `useRpgCreationEnterWorld.ts`
+   - 进入世界前的最终草稿同步
+
+当前 `RpgCreationShellImpl.tsx` 只保留：
+
+1. hooks 组合
+2. stage 级视图切换
+3. 组件 props 装配
+4. 视觉级 loading / error 展示
+
+---
+
+## 3. 当前状态判断
+
+工作包 B 已达到执行方案中的验收口径：
+
+1. `PreGameSelectionFlow.tsx` 只剩兼容导出与新壳层桥接。
+2. `RpgCreationShellImpl.tsx` 不再直接持有平台请求编排、operation 轮询、自动保存或进入世界同步细节。
+3. 平台侧主链已经切成壳层 + hooks / coordinator。
+4. 现有 `PreGameSelectionFlow.agent.interaction.test.tsx` 的 14 个场景全部通过。
+
+---
+
+## 4. 本轮刻意未做
+
+1. 还没有物理删除 `PreGameSelectionFlow.tsx`，当前继续保留旧入口兼容层，避免影响并行工作包的调用路径。
+2. 还没有让所有调用方统一显式改走 `RpgCreationShell` 新入口，当前仍允许旧入口桥接到新壳层。
+3. 还没有把结果页 preview 数据源从前端兼容 adapter 切到服务端正式 preview contract；当前仍使用 `rpgCreationPreviewAdapter` 作为阶段性兼容层，这属于后续工作包 G / H 与 Phase 3 范围。
+4. 还没有清理所有 legacy 兼容导出与 façade，当前优先稳定主链与测试口径。
+
+---
+
+## 5. 验证结果
+
+1. `npx eslint "src/components/game-shell/PreGameSelectionFlow.tsx" "src/components/game-shell/rpg-creation-flow/*.ts" "src/components/game-shell/rpg-creation-flow/*.tsx"`
+2. `npx vitest run src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx`
+3. `npm run check:encoding`
+
+以上检查在本轮修改后均已通过。
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..a7e9ac6d
--- /dev/null
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md
@@ -0,0 +1,106 @@
+# 创作链路重构工作包 D 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 D：前端 custom world client 收口**，约束如下：
+
+1. 把创作链主路径依赖的 custom world 请求从 `aiService.ts`、`storageService.ts` 中迁入 `src/services/rpg-creation/`。
+2. 首轮允许旧 service 兼容导出，追加清理轮必须删除已无调用方的旧命名导出。
+3. 不改后端接口语义，不扩写结果页 UI 逻辑，不借机重构工作包 B / C 的内部状态编排。
+
+## 2. 本次已落地内容
+
+## 2.1 RPG 创作域请求基座已独立
+
+已新增以下请求基座文件：
+
+1. `src/services/rpg-creation/rpgCreationRuntimeClient.ts`
+2. `src/services/rpg-creation/rpgCreationRequestHelpers.ts`
+
+当前策略：
+
+1. runtime 读写重试策略不再散落在 `storageService.ts` 内部，而是作为 RPG 创作域专属 runtime client 复用。
+2. Agent SSE、POST JSON 请求辅助能力收口到 `rpgCreationRequestHelpers.ts`，避免再把流式解析细节写回通用 service。
+
+## 2.2 五类 rpgCreation client 已持有真实请求实现
+
+以下 client 已不再桥接旧 service，而是直接持有真实网络实现：
+
+1. `src/services/rpg-creation/rpgCreationAgentClient.ts`
+2. `src/services/rpg-creation/rpgCreationWorkClient.ts`
+3. `src/services/rpg-creation/rpgCreationLibraryClient.ts`
+4. `src/services/rpg-creation/rpgCreationAssetClient.ts`
+5. `src/services/rpg-creation/rpgCreationGenerationClient.ts`
+
+本轮已完成的具体收口：
+
+1. Agent session 创建、读取、消息发送、消息流、action 执行、operation 查询、card detail 查询已经正式迁入 `rpgCreationAgentClient.ts`。
+2. works 列表查询已经正式迁入 `rpgCreationWorkClient.ts`。
+3. library / publish / unpublish / gallery / gallery detail 已经正式迁入 `rpgCreationLibraryClient.ts`。
+4. 结果页与编辑器依赖的场景图、场景 NPC、可扮演角色、场景角色、场景生成请求已经正式迁入 `rpgCreationAssetClient.ts`。
+5. `generateCustomWorldProfile()` 已正式迁入 `rpgCreationGenerationClient.ts`，世界生成入口也已进入 RPG 创作域 client。
+6. `src/services/rpg-creation/index.ts` 已收口为 RPG 命名导出，创作主链不再从 barrel 暴露 `createCustomWorldAgentSession / listCustomWorldWorks / upsertCustomWorldProfile` 等旧命名入口。
+
+## 2.3 旧 service 兼容导出已删除
+
+追加清理轮已完成以下删除：
+
+1. `src/services/aiService.ts` 不再 re-export RPG 创作 Agent / works / 结果页生成接口，继续只服务 story/chat 等通用 AI 运行时能力。
+2. `src/services/storageService.ts` 已物理删除，运行时存档、设置、资料、浏览历史能力已迁入 `src/services/rpg-entry/` 与 `src/services/rpg-runtime/`。
+3. `rpgCreationAgentClient.ts`、`rpgCreationWorkClient.ts`、`rpgCreationLibraryClient.ts`、`rpgCreationAssetClient.ts` 已删除 `CustomWorld*` 兼容具名导出，只保留 `Rpg*` 主命名。
+4. 源码扫描已确认不再存在 `createCustomWorldAgentSession / executeCustomWorldAgentAction / listCustomWorldWorks / upsertCustomWorldProfile` 等旧主链函数引用。
+
+## 2.4 主链调用已开始直接使用 RPG 创作域 client
+
+本轮已把以下主链入口切到 `src/services/rpg-creation/`：
+
+1. `src/components/rpg-entry/useRpgCreationSessionController.ts`
+2. `src/components/rpg-entry/useRpgCreationResultAutosave.ts`
+3. `src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx`
+4. `src/components/rpg-creation-editor/RpgCreationEntityEditorShared.tsx`
+5. 新增世界生成入口 `generateRpgWorldProfile()` 通过 `src/services/rpg-creation/` barrel 暴露，后续新代码不必再从旧 `aiService.ts` 进入。
+
+配套收口：
+
+1. 结果页与编辑器相关测试 mock 已改到 `rpgCreationAssetClient`，不再盯住 `aiService.ts` 的兼容层。
+2. `CustomWorldResultView.test.tsx`、`CustomWorldEntityEditorModal.test.tsx` 已改为直接消费 `RpgCreationResultView / RpgCreationEntityEditorModal` 新入口，不再通过旧组件 façade。
+
+## 2.5 本轮验证结果
+
+已完成以下针对性验证：
+
+1. `npm run test -- src/services/rpg-creation/rpgCreationGenerationClient.test.ts src/services/storageService.test.ts src/components/CustomWorldEntityEditorModal.test.tsx src/components/CustomWorldResultView.test.tsx src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx`
+2. `npm run check:encoding`
+
+验证结果：
+
+1. 上述 5 组定向测试全部通过。
+2. 编码检查通过，未写坏中文文件。
+
+追加清理轮已完成以下验证：
+
+1. `npm run test -- src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts src/components/CustomWorldResultView.test.tsx src/components/CustomWorldEntityEditorModal.test.tsx src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx`
+   结果：通过，`42` 项测试全部通过。
+2. `npm run test -- src/services/rpg-creation/rpgCreationGenerationClient.test.ts`
+   结果：通过，`2` 项测试全部通过。
+3. `npm run check:encoding`
+   结果：通过，`1929` 个文件编码检查通过。
+4. 源码扫描确认 `src / packages / server-node` 中不再存在本轮删除的旧主链函数与旧组件入口符号引用。
+
+## 3. 本次刻意未做的事
+
+以下内容明确留给后续工作包，不在本轮越界处理：
+
+1. 没有改后端 works/library/gallery/agent route 的语义与 contract。
+2. 没有拆 `PreGameSelectionFlow.tsx` 内部编排；这部分仍属于工作包 B。
+3. 没有继续物理拆散 `RpgCreationEntityEditorShared.tsx`；这部分仍属于工作包 C 后续细拆。
+4. 没有强行重命名历史数据结构类型，例如 `CustomWorldProfile` 与 runtime contract response 名称；这些仍是现有契约类型，不等同于旧脚本依赖。
+5. 没有删除旧 `src/services/ai.ts` 中的 legacy 世界生成实现；它已不在当前 RPG 创作主链 client 上，后续应按独立 dead code 批次评估。
+
+## 4. 对后续工作包的直接收益
+
+1. 工作包 B 后续拆平台壳层时，可以直接从 `src/services/rpg-creation/` 消费 Agent / works / library / gallery 请求，不必继续回到旧 service 文件找接口。
+2. 工作包 C 后续继续拆结果页和编辑器时，资产生成请求已经有稳定的 RPG 创作域入口。
+3. 后续清理 `aiService.ts`、`storageService.ts` 时，创作链主路径已经完成真实迁出，不会再被“通用 service 同时承载创作域请求”拖住。
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..24d4205d
--- /dev/null
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md
@@ -0,0 +1,150 @@
+# 创作链路重构工作包 E 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次落实 `CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 E：后端 Agent 编排拆分**，并严格遵守这一轮的写入边界：
+
+1. 只改后端应用服务层，不动前端壳层。
+2. 先把 `customWorldAgentOrchestrator.ts` 从“大分支调度 + 派生状态重建 + 结果回写细节”里拆薄。
+3. 补齐 action executor 真实落点与 `supportedActions` 主链字段，但不在这一轮顺手重构 session store 和 runtime compiler。
+
+## 2. 本次已落地内容
+
+## 2.1 orchestrator 已退化为应用服务 façade
+
+本轮后，`server-node/src/services/customWorldAgentOrchestrator.ts` 的职责开始收口为：
+
+1. session 级入口方法保留。
+2. 创建 operation 记录。
+3. 调用 action registry 拿到执行计划。
+4. 把消息轮转、foundation 生成、实体生成、角色资产同步等主链事务串起来。
+
+这轮明确移出的内容：
+
+1. `action -> executor` 的分支校验和分发。
+2. `sync_result_profile` 的字段回写细节。
+3. 多个 action 共用的 draftCards / assetCoverage / suggestedActions / qualityFindings 派生重建逻辑。
+
+## 2.2 已新增 action registry 与 executor 目录，并完成真实执行迁移
+
+已新增：
+
+1. `server-node/src/services/customWorldAgentActionRegistry.ts`
+2. `server-node/src/services/customWorldAgentActionExecutors/index.ts`
+3. `server-node/src/services/customWorldAgentActionExecutors/types.ts`
+
+本轮收口结果：
+
+1. registry 统一处理 `draft_foundation`、`update_draft_card`、`sync_result_profile`、`generate_characters`、`generate_landmarks`、`generate_role_assets`、`sync_role_assets` 的可用性校验。
+2. `publish_world`、`generate_scene_assets`、`sync_scene_assets`、`expand_long_tail`、`revert_checkpoint` 已完成真实 executor 装配，不再只是 registry 层面的“已声明但未开放”动作。
+3. `lock_cards`、`unlock_cards`、`regenerate_scope` 仍统一通过 registry 返回禁用原因，不再继续堆在 orchestrator 分支里。
+4. `customWorldAgentActionExecutors/` 已补 `draftFoundationExecutor.ts`、`updateDraftCardExecutor.ts`、`syncResultProfileExecutor.ts`、`generateCharactersExecutor.ts`、`generateLandmarksExecutor.ts`、`generateRoleAssetsExecutor.ts`、`syncRoleAssetsExecutor.ts`、`generateSceneAssetsExecutor.ts`、`syncSceneAssetsExecutor.ts`、`expandLongTailExecutor.ts`、`publishWorldExecutor.ts`、`revertCheckpointExecutor.ts`，真实 action 执行已从 orchestrator 物理迁入目录。
+5. `customWorldAgentActionExecutors/helpers.ts` 与 `executorShared.ts` 已收口 action_result / summary message 构造、operation 更新和 session 读取共用逻辑，避免 executor 间重复堆样板代码。
+
+## 2.3 已新增 message turn / suggested action / snapshot / quality gate / result sync service
+
+已新增：
+
+1. `server-node/src/services/customWorldAgentMessageTurnService.ts`
+1. `server-node/src/services/customWorldAgentSuggestedActionService.ts`
+2. `server-node/src/services/customWorldAgentSnapshotBuilder.ts`
+3. `server-node/src/services/customWorldAgentQualityGateService.ts`
+4. `server-node/src/services/customWorldAgentResultSyncService.ts`
+
+本轮收口结果：
+
+1. `CustomWorldAgentMessageTurnService` 已接管 session 初始派生状态与 message turn 的真实执行，`customWorldAgentOrchestrator.ts` 只保留 façade 委托。
+1. `CustomWorldAgentSuggestedActionService` 统一维护 `foundation_review`、`object_refining`、`visual_refining` 的建议动作生成，不再散落在 orchestrator 和 session compatibility。
+2. `CustomWorldAgentSnapshotBuilder` 统一承接 message turn、foundation draft、结果页回写、角色/地点追加、角色资产同步后的派生字段重建。
+3. `CustomWorldAgentQualityGateService` 已形成独立 finding 入口，当前先输出角色缺失、地点缺失、玩家目标缺失、角色资产待补齐、场景资产待补齐等基础 gate finding。
+4. `CustomWorldAgentResultSyncService` 接管了 `sync_result_profile` 的字段回写细节，明确这一轮只允许“摘要 + 资产确认结果 + legacyResultProfile 快照”回写进 draft profile。
+
+## 2.4 `supportedActions` 已接入 session snapshot 主链
+
+这一轮已把 registry 产出的能力矩阵正式装配到 `CustomWorldAgentSessionSnapshot.supportedActions`：
+
+1. `createSession`、`getSessionSnapshot`、stream message 完成态、各 action 完成后的 session 拉取都会返回真实 `supportedActions`。
+2. `supportedActions` 的启用状态按 session 当前阶段与草稿可用性计算，不再由前端根据 action 字面量自行猜测。
+3. 具体 payload 校验仍保留在 action 执行阶段，能力矩阵只表达“当前阶段是否允许发起这类动作”。
+
+## 2.5 action 主链行为保持不变，但派生状态已开始统一
+
+这一轮没有改变现有 action contract，也没有新增前端依赖字段，但已经把以下重复派生逻辑统一改走 snapshot builder：
+
+1. `draft_foundation`
+2. `update_draft_card`
+3. `sync_result_profile`
+4. `generate_characters`
+5. `generate_landmarks`
+6. `generate_role_assets`
+7. `sync_role_assets`
+8. message turn 结束后的 stage / suggested actions / quality findings / asset coverage 重建
+
+这意味着：
+
+1. 后续新增 action 时，不必再复制一整段 `draftCards + assetCoverage + suggestedActions + recommendedReplies` patch 拼装代码。
+2. `qualityFindings` 已开始成为真实后端派生字段，而不只是 session store 中的空占位。
+3. `sync_result_profile` 的边界已经能单独测试和继续收缩。
+
+## 2.6 工作包 E 第三轮已补齐的真实闭环
+
+本轮把工作包 E 前两轮遗留的 5 个动作补成了真实后端闭环：
+
+1. `generate_scene_assets`
+   已通过 `CustomWorldAgentAssetBridgeService.buildSceneAssetStudioContext()` 打通场景图工坊上下文准备，支持营地与地点单场景进入。
+2. `sync_scene_assets`
+   已通过 `applySceneAssetPublishResult()` 写回营地/地点正式场景图，并同步刷新对应 `sceneChapters[].acts` 的背景图与背景资产 ID。
+3. `expand_long_tail`
+   已接入实体生成服务与 snapshot builder，能真实追加长尾角色、地点并把阶段推进到 `long_tail_review`。
+4. `publish_world`
+   已改为走 `CustomWorldAgentPublishingService + RpgWorldProfileRepository` 主链，正式把 draft session 编译、写入并发布到作品库。
+5. `revert_checkpoint`
+   已依赖 checkpoint snapshot 元数据与 `restoreCheckpoint()` 主链完成真实回滚，不再只是开放 action 名称。
+
+这一轮同时补齐了 4 个关键收口：
+
+1. 发布链已经统一改走 `CustomWorldAgentPublishingService`，`customWorldAgentOrchestrator.ts`、`customWorldAgentActionExecutors/index.ts`、`publishWorldExecutor.ts` 与 `server.ts` 的注入口径已经对齐；作者展示名优先走 `resolveAuthorDisplayName`，同时保留 `userRepository` 兼容兜底。
+2. `publish_world` 的 readiness 与正式发布已经收口到同一个服务，`profileId` 固定优先沿用 legacy 结果页 ID，否则回退为 `agent-draft-${sessionId}`，避免发布产物继续使用临时时间戳。
+3. `buildCheckpointSnapshot()` 已接入 `draft_foundation`、`update_draft_card`、`sync_result_profile`、`generate_characters`、`generate_landmarks`、`sync_role_assets`、`sync_scene_assets`、`expand_long_tail`、`publish_world` 等关键 executor，checkpoint 现在保存的是真正可恢复的派生快照，而不是只记一段残缺 patch。
+4. `rebuildRoleAssetCoverage()` 已补营地 / 地点正式场景资产 fallback 汇总，并收口为“只有真实正式场景图已存在时才补 standalone summary”，这样 `sync_scene_assets` 写回后的 camp/landmark asset coverage 在 snapshot 重建、works 读模型与 checkpoint 回放里都不会丢失，也不会误伤 phase3 自动资产回归。
+
+## 2.7 本轮验证结果
+
+已完成以下验证：
+
+1. `npm --prefix server-node run build`
+2. `npm --prefix server-node run test -- customWorldAgentPhase3.test.ts customWorldAgentActionRegistry.test.ts customWorldAgentPhase5.test.ts`
+
+本轮重点关注的回归范围：
+
+1. `customWorldAgentActionRegistry.test.ts`
+2. `customWorldAgentPhase3.test.ts`
+3. `customWorldAgentPhase5.test.ts`
+4. `publish_world`
+5. `generate_scene_assets / sync_scene_assets`
+6. `expand_long_tail`
+7. `revert_checkpoint`
+
+验证结果：
+
+1. `server-node` 构建通过。
+2. 定向回归通过，共 `208` 项测试全部通过。
+3. Phase 3 与 Phase 5 已同时确认通过，说明这轮对 `sceneAssets` fallback summary 的收口没有打坏前序自动资产链。
+
+## 3. 本次刻意未做的事
+
+以下内容明确留给后续工作包或下一轮工作包 E，不在本轮越界处理：
+
+1. 还没有进入 Phase 4 的“进入世界统一走发布态 gate”收口，当前这轮只完成了发布动作本身的后端闭环。
+2. 还没有改 `customWorldAgentSessionStore.ts` 内部 compatibility / snapshot 输出结构，这部分仍属于工作包 F。
+3. 还没有把 result preview 正式接到 `resultPreview` 主链字段，这部分仍需要和工作包 G / H 协作。
+4. 旧 `customWorldAgentPublishGateService.ts` 与 `customWorldAgentPublishService.ts` 仍作为历史兼容文件保留，但工作包 E 主链已经不再走它们；这一轮没有继续做物理删除与引用清扫，避免越界碰到 Phase 4/Phase 5 之外的兼容入口。
+
+## 4. 对后续工作包的直接收益
+
+1. 工作包 F 可以在不碰 orchestrator 大分支的前提下，继续拆 session/store/repository。
+2. 工作包 G 可以直接围绕 `CustomWorldAgentResultSyncService` 和 `CustomWorldAgentQualityGateService` 对接服务端 preview compiler 与 publish gate。
+3. 工作包 H 可以基于已落地的 `supportedActions`、action registry 和 quality gate 继续推进 preview contract 与 contract tests。
+4. 后续继续拆 action executor 时，已经有 `customWorldAgentActionExecutors/` 目录和注册表，不需要再回到 orchestrator 里重新铺路。
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..072eb922
--- /dev/null
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md
@@ -0,0 +1,92 @@
+# 创作链路重构工作包 F 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次落实 `CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 F：后端 session/store/repository 拆分**，约束如下：
+
+1. 不改动现有主链接口与行为语义。
+2. 保留 `customWorldAgentSessionStore.ts`、`runtimeRepository.ts`、`customWorldWorkSummaryService.ts` 作为兼容 façade。
+3. 把 session 兼容补齐、session 持久化、profile 持久化、works 读模型组装从大文件中物理拆出。
+
+## 2. 本次已落地内容
+
+## 2.1 session store 内部分层
+
+已新增以下 RPG Agent session 拆分文件：
+
+1. `server-node/src/services/rpg-agent-session-store/rpgAgentSessionRecord.ts`
+2. `server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.ts`
+3. `server-node/src/services/rpg-agent-session-store/rpgAgentSessionFactory.ts`
+4. `server-node/src/services/rpg-agent-session-store/rpgAgentSessionRepositoryAdapter.ts`
+
+当前策略：
+
+1. `customWorldAgentSessionStore.ts` 继续保留旧类名和旧方法签名。
+2. sessionId 前缀、snapshot 输出结构、operation/checkpoint 写入语义保持兼容。
+3. 旧 session 的兼容补齐逻辑集中收口到 `rpgAgentSessionCompatibility.ts`，不再继续堆在 store 主文件里。
+4. `customWorldAgentSessionStore.ts` 已正式改为依赖 `RpgAgentSessionRepositoryPort`，phase2~5 与 works 集成测试也已切到新的 session 仓储端口。
+
+## 2.2 custom world 仓储从 runtime 大仓储中拆出
+
+已新增以下 RPG 世界仓储文件：
+
+1. `server-node/src/repositories/RpgAgentSessionRepository.ts`
+2. `server-node/src/repositories/RpgWorldProfileRepository.ts`
+3. `server-node/src/repositories/rpgWorldRepositoryShared.ts`
+
+当前策略：
+
+1. `RuntimeRepositoryPort` 继续保留兼容 façade，但 `context.ts`、`server.ts`、`runtimeRoutes.ts`、同步脚本已开始直接注入并使用 `RpgAgentSessionRepository`、`RpgWorldProfileRepository`。
+2. `runtimeRepository.ts` 内的 custom world session/profile/gallery SQL 已改成委托新仓储。
+3. `runtimeRepository.ts` 继续只保留 runtime 快照、设置、浏览历史、档案等通用能力，以及少量尚未迁走的快照同步编排。
+
+## 2.3 works 读模型拆分
+
+已新增以下 works 读模型相关文件：
+
+1. `server-node/src/services/RpgWorldWorkCoverResolver.ts`
+2. `server-node/src/services/RpgWorldWorkSummaryAssembler.ts`
+3. `server-node/src/services/RpgWorldWorkSummaryService.ts`
+
+并将：
+
+1. `server-node/src/services/customWorldWorkSummaryService.ts`
+
+退化为兼容入口，仅负责桥接新 `RpgWorldWorkSummaryService`。
+
+当前策略：
+
+1. works service 只保留服务入口，不再内嵌标题、摘要、封面、资产覆盖率等全部组装细节。
+2. 草稿封面与发布态封面解析统一走 resolver，避免后续重复理解封面规则。
+3. 草稿态与发布态 work summary 的字段语义保持不变，继续支持“继续创作”和“进入世界”入口判定。
+4. `runtimeRoutes.ts` 中的 works/library/gallery 路由已切到 `rpgWorldWorkSummaryService` 与 `rpgWorldProfileRepository` 直接注入，不再经由 `runtimeRepository` 中转 custom world 读模型。
+
+## 3. 验证结果
+
+本次已完成以下定向回归：
+
+1. 运行 `node --test --test-concurrency=1 --import tsx src/services/customWorldAgentPhase2.test.ts src/services/customWorldAgentPhase3.test.ts src/services/customWorldAgentPhase4.test.ts src/services/customWorldAgentPhase5.test.ts src/services/customWorldWorkSummaryService.integration.test.ts`
+2. 以上 21 个 custom world / agent / works 相关测试全部通过。
+
+同时确认：
+
+1. 全量 `npx tsc -p server-node/tsconfig.json --noEmit` 当前仍被仓库里既有的跨模块类型问题阻塞。
+2. 这些全量类型错误大多与本工作包无关，因此本轮仍以 custom world 定向测试通过作为主验证口径。
+3. 工作包 F 本轮新增的 `RpgWorldWorkSummaryService.ts`、新仓储注入链和测试 helper，未在定向回归中引入新的行为回归。
+
+## 4. 当前兼容保留项
+
+以下内容属于阶段性兼容保留，不再视为工作包 F 未完成项：
+
+1. `RuntimeRepositoryPort` 仍保留 custom world 相关兼容方法，避免一次性冲击 story/runtime 其他调用方。
+2. `customWorldAgentSessionStore.ts`、`customWorldWorkSummaryService.ts` 仍保留旧文件名 façade，后续统一命名治理时再清理。
+3. runtime 快照同步与 custom world profile 自动回写的进一步解耦，仍留待后续围绕 `runtimeRepository.ts` 继续收口。
+
+## 5. 对后续工作包的直接收益
+
+1. 工作包 E 可以在不继续挤压 `customWorldAgentSessionStore.ts` 的情况下，把 orchestrator 的 result sync / snapshot builder 接到更清晰的 session 持久化边界。
+2. 工作包 G 后续若需要让 preview compiler / publish gate 落库，不必再继续往 `runtimeRepository.ts` 堆 custom world SQL。
+3. 工作包 H 已能直接围绕 `rpg-agent-session-store/`、`RpgWorldWorkSummaryAssembler.ts`、`RpgWorldWorkSummaryService.ts` 与新仓储端口补充更细粒度回归，而不必穿透大文件。
+4. 后续若继续拆 route 命名或清理旧 façade，已有 `context -> server -> runtimeRoutes -> script -> tests` 的新仓储注入链可直接复用。
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..7fd0f156
--- /dev/null
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md
@@ -0,0 +1,92 @@
+# 创作链路重构工作包 G 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次落实 `CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 G：后端 preview compiler 与 runtime profile 目录化**，并把目录化拆分推进到文档目标结构：
+
+1. 先把 `runtimeProfile.ts` 退化成兼容 façade。
+2. 把 `runtime-profile/` 真正拆成 `normalize/build/schema/creatorIntentBridge` 等独立模块。
+3. 把服务端 result preview compiler 从 foundation draft 流程中抽出独立入口。
+4. 不直接改路由层，不直接接前端结果页。
+
+## 2. 本次已落地内容
+
+## 2.1 runtime profile 已完成目录化完整拆分
+
+已完成以下结构调整：
+
+1. 新增 `server-node/src/modules/custom-world/runtime-profile/index.ts` 作为目录入口。
+2. 原 `server-node/src/modules/custom-world/runtimeProfile.ts` 已退化为兼容 façade，只负责 re-export。
+3. `server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts` 已退化为兼容 façade，不再承载主实现。
+4. 已新增并落地以下目标模块：
+   1. `normalizeShared.ts`
+   2. `normalizeRole.ts`
+   3. `normalizeLandmark.ts`
+   4. `normalizeSceneChapter.ts`
+   5. `normalizeCamp.ts`
+   6. `buildCompiledProfile.ts`
+   7. `buildAttributeSchema.ts`
+   8. `creatorIntentBridge.ts`
+
+当前策略：
+
+1. 先保证旧导入路径不失效，避免放大工作包 G 首轮改动范围。
+2. 新代码优先改走 `runtime-profile/` 目录入口。
+3. `runtimeProfile.ts` 与 `runtimeProfileCompiler.ts` 后续只允许继续收缩，不再接受新增主逻辑。
+
+## 2.2 服务端 preview compiler 已从 foundation draft 流程中抽出
+
+已完成以下收口：
+
+1. `server-node/src/services/RpgWorldPreviewCompiler.ts` 不再只是别名导出，已提供：
+   1. `buildRpgWorldPreviewProfile()`
+   2. `normalizeRpgWorldPreviewProfile()`
+   3. `buildRpgWorldPreviewEnvelope()`
+   4. `normalizeRpgWorldPreviewEnvelope()`
+2. `packages/shared/src/contracts/rpgCreationPreview.ts` 已补 `RpgCreationPreviewSource`，把 preview 来源语义显式化。
+3. `customWorldAgentFoundationDraftService.ts` 已把 LLM foundation draft 主生成链改成“直接组装 foundation draft + 单独保留 `legacyResultProfile` 兼容快照”，不再通过 preview compiler 反解草稿主字段。
+
+这轮的边界变化是：
+
+1. foundation draft 主字段已经不再依赖“先编 legacy runtime profile，再转回 draft”的双重编译。
+2. `legacyResultProfile` 仍保留，但只作为结果页兼容快照，不再主导 foundation draft 生成。
+3. “服务端 preview 编译入口”继续独立存在，并在 Phase 5 后补上 `rpgCreationPreviewProfileBuilder.ts`，统一承接 preview 与 publish 的兼容合并规则。
+4. preview source 已在 Phase 5 后正式收口为 `session_preview`，不再继续沿用兼容期的 `legacy_custom_world_profile` 标记。
+
+## 2.3 已补最小测试与目录化回归验证
+
+本次新增：
+
+1. `server-node/src/services/RpgWorldPreviewCompiler.test.ts`
+2. `server-node/src/services/customWorldAgentFoundationDraftService.test.ts`
+
+当前覆盖重点：
+
+1. 验证 preview compiler 可以输出服务端兼容预览 envelope。
+2. 验证 envelope 的 `source` 保持为 `session_preview`。
+3. 验证 preview profile 仍保留 runtime 编译生成的关键字段，例如 `scenarioPackId`、`campaignPackId`。
+4. 验证 Phase 5 新增的 preview builder 可以在服务端保留 `legacyResultProfile` 富字段并合并最新草稿资产。
+5. 验证 foundation draft service 的 LLM 路径已经直接生成 draft 主字段，不再依赖 preview compiler 反解。
+6. 验证 `runtimeProfile.ts` façade 在目录化拆分后仍保持旧调用兼容。
+
+本轮额外验证已通过：
+
+1. `npm run check:encoding`
+2. `node --test --test-concurrency=1 --import tsx server-node/src/services/customWorldAgentFoundationDraftService.test.ts server-node/src/modules/custom-world/runtimeProfile.test.ts server-node/src/services/RpgWorldPreviewCompiler.test.ts`
+
+## 3. 本次刻意没有做的事
+
+以下内容仍留给后续阶段：
+
+1. 还没有让 `RpgWorldPreviewCompiler` 输出真正独立于 legacy profile 的 preview view model。
+2. 还没有把 `RpgWorldPreviewCompiler` 的 preview 载体从当前 runtime-profile 兼容对象升级成真正独立的 preview view model。
+3. `legacyResultProfile` 仍保留为兼容快照，结果页与自动保存链还没有完全脱离 legacy profile 富字段。
+4. 还没有删除 `runtimeProfile.ts`、`runtimeProfileCompiler.ts` 这两个兼容 façade。
+
+## 4. 对后续工作包的直接收益
+
+1. 工作包 E 可以围绕 `RpgWorldPreviewCompiler` 继续补 result sync / snapshot builder 的 preview 接口。
+2. 工作包 H 可以基于 `RpgCreationPreviewEnvelope` 继续细化正式 preview contract 和 contract tests。
+3. Phase 3 把结果页切到服务端 preview 时，已经有稳定的后端编译入口和目录化 normalize/build 模块，不需要再回头拆 `runtimeProfile.ts` 大文件。
diff --git a/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..2f8cd2f2
--- /dev/null
+++ b/docs/technical/CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md
@@ -0,0 +1,137 @@
+# 创作链路重构工作包 H 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次落实 `CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 H：共享契约与测试基建**，约束如下：
+
+1. 把 RPG 创作域共享契约从“类型别名骨架”推进到“真实定义 + 兼容出口”。
+2. 补齐可复用的 fixture，避免前后端测试继续各自复制一套假数据。
+3. 补齐 unit / contract / integration / regression 最小闭环，不越界重构 UI、路由和仓储主逻辑。
+
+## 2. 本次已落地内容
+
+## 2.1 共享契约已完成物理拆分与兼容收口
+
+本轮已把以下文件从工作包 A 的骨架态推进为真实定义：
+
+1. `packages/shared/src/contracts/rpgAgentAnchors.ts`
+2. `packages/shared/src/contracts/rpgAgentDraft.ts`
+3. `packages/shared/src/contracts/rpgAgentActions.ts`
+4. `packages/shared/src/contracts/rpgAgentSession.ts`
+5. `packages/shared/src/contracts/rpgCreationPreview.ts`
+6. `packages/shared/src/contracts/rpgCreationWorkSummary.ts`
+
+本轮收口重点：
+
+1. `rpgAgent*` 与 `rpgCreation*` 文件不再只是从旧 `customWorldAgent.ts` 做类型别名转发，而是承载真实契约定义。
+2. `rpgAgentSession.ts` 已显式加入 `supportedActions?` 与 `resultPreview?` 可选字段，为工作包 E/G 后续正式接入 registry 与服务端 preview compiler 预留稳定契约入口。
+3. `rpgCreationPreview.ts` 已补 `source / generatedAt / qualityFindings / blockers`，把“预览载体”和“预览来源/质量门槛”拆开。
+4. `rpgCreationWorkSummary.ts` 已收口 works 列表稳定字段，明确 `canResume / canEnterWorld` 的读模型语义。
+
+## 2.2 旧 `customWorld*` 契约已补齐兼容分文件
+
+本轮没有直接删除旧入口，而是把旧命名收口成“聚合出口 + 分文件兼容层”：
+
+1. 当前旧 `customWorldAgent.ts` 不再承载主定义，而是统一聚合：
+   - `customWorldAgentAnchors.ts`
+   - `customWorldAgentDraft.ts`
+   - `customWorldAgentActions.ts`
+   - `customWorldAgentSession.ts`
+   - `customWorldResultPreview.ts`
+   - `customWorldWorkSummary.ts`
+2. 现有前后端直接导入 `customWorldAgent.ts` 的代码不需要在本轮一起大改，避免把工作包 H 扩成全仓导入迁移。
+3. 后续工作包可以逐步把新代码改到 `rpgAgent* / rpgCreation*` 路径；如果暂时仍需旧命名，也可以先切到更细的兼容分文件，而不是继续依赖单一大聚合文件。
+
+## 2.3 已补共享 fixture，总线样本开始统一
+
+本轮新增：
+
+1. `packages/shared/src/contracts/rpgCreationFixtures.ts`
+
+当前已提供并复用的样本包括：
+
+1. 八锚点 fixture
+2. foundation draft fixture
+3. session snapshot fixture
+4. preview envelope fixture
+5. published profile fixture
+6. library entry fixture
+7. works response fixture
+
+这些样本的作用是：
+
+1. 前端 contract test、后端 integration test、后续 preview/compiler 回归可以共用同一批样本。
+2. 避免继续在各测试文件里手写不一致的 session/profile/works 假数据。
+3. 把工作包 H 文档中要求的“最小 eight-anchor / preview / published profile / works 样本”先落成统一入口。
+
+## 2.4 已补 unit / contract / integration / regression 最小闭环
+
+本轮新增测试：
+
+1. `packages/shared/src/contracts/rpgContracts.test.ts`
+2. `server-node/src/services/customWorldWorkSummaryService.integration.test.ts`
+3. `server-node/src/services/RpgWorldPreviewCompiler.fixture.test.ts`
+4. `server-node/src/services/RpgWorldWorkSummaryAssembler.fixture.test.ts`
+5. `server-node/src/services/customWorldAgentActionRegistry.test.ts`
+6. `server-node/src/services/customWorldAgentResultSyncService.test.ts`
+
+同时补充：
+
+1. `vitest.config.ts` 已把 `packages/shared/src/**/*.test.ts` 纳入前端 Vitest 测试入口。
+2. shared contract test 当前覆盖：
+   - session fixture、preview fixture、published profile fixture、works/library fixture 对齐关系
+   - `supportedActions` 能力矩阵样本
+   - 旧命名兼容分文件的类型消费
+   - 角色动作资产、分幕背景、works 门槛字段不会在 fixture 演进时悄悄回退
+3. server unit / regression test 当前覆盖：
+   - preview compiler 可以直接消费 shared fixture
+   - works assembler 输出与 shared works fixture 保持一致
+   - 角色主图、动作集、分幕背景资产字段在 normalize / assemble 后仍能保留
+   - action registry 的 capability enable/disable 与 payload validate/normalize
+   - result sync service 只回写摘要与匹配资产，不让 runtime-only 结构反向污染 foundation draft
+4. server integration test 当前验证共享 fixture 可以被 `customWorldWorkSummaryService` 正常消费，并输出和共享 works 响应样本一致的草稿/发布条目。
+
+## 2.5 根导出已补齐
+
+本轮已把：
+
+1. `packages/shared/src/contracts/rpgCreationFixtures.ts`
+2. `packages/shared/src/contracts/customWorldAgent.ts`
+
+接入：
+
+1. `packages/shared/src/index.ts`
+
+这样后续前端和后端若要消费共享 fixture 或新契约，不需要再回退到旧单文件入口。
+
+## 3. 本次验证结果
+
+已完成以下定向验证：
+
+1. `npm run test -- packages/shared/src/contracts/rpgContracts.test.ts`
+2. `node --test --test-concurrency=1 --import tsx src/services/customWorldAgentActionRegistry.test.ts src/services/customWorldAgentResultSyncService.test.ts src/services/customWorldWorkSummaryService.integration.test.ts src/services/RpgWorldPreviewCompiler.fixture.test.ts src/services/RpgWorldWorkSummaryAssembler.fixture.test.ts`
+3. `npm run check:encoding`
+
+验证重点：
+
+1. shared 契约样本可直接通过 Vitest 执行。
+2. preview compiler、works assembler、works service 三层都可以直接消费 shared fixture，不需要额外复制一套测试数据。
+3. 中文文档与代码文件经过编码检查，没有把文本写坏。
+
+## 4. 本次刻意未做的事
+
+以下内容明确留给后续工作包或下一轮继续推进：
+
+1. 还没有把仓库里所有 `customWorldAgent.ts` 旧导入物理迁成 `rpgAgent* / rpgCreation*` 新导入。
+2. 还没有让后端 session snapshot 真正填充 `supportedActions`。
+3. 还没有让服务端 preview compiler 真正把 `resultPreview` 写入主链 snapshot。
+4. 没有改 UI、路由、数据库仓储或 orchestrator 主逻辑，严格控制在 shared contracts 与测试基建写入边界内。
+
+## 5. 对后续工作包的直接收益
+
+1. 工作包 E 可以直接复用 `supportedActions` 契约入口，把 action registry 的真实能力矩阵接进 session snapshot。
+2. 工作包 G 可以直接复用 `resultPreview` 和 `RpgCreationPreviewEnvelope`，继续把服务端 preview compiler 接回主链。
+3. 后续前后端测试都可以从 shared fixture 取样本，不需要继续维护多套彼此漂移的 session/profile 假数据。
+4. 旧命名导入可以先切到兼容分文件，再逐步替换到 `rpg*` 新契约，迁移路径更平滑。
diff --git a/docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md b/docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md
index 90da8e88..abbff1b0 100644
--- a/docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md
+++ b/docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md
@@ -139,6 +139,25 @@
 4. `questDirector` / `runtimeItemAiDirector` 收缩为前端 SDK。
 5. runtime story contract 开始补“随请求提交快照上下文”的后端承接能力，并把 NPC 待接委托 replace / abandon 接到后端。
 
+### 5.1 已完成
+
+1. 鉴权 access/refresh session 已全部转为后端 Cookie 会话。
+2. `refreshSessionCookie` 已修复双 `Set-Cookie` 覆盖问题，登录/刷新/微信回调不再丢失 access cookie。
+3. 浏览历史已收敛为后端唯一真相，前端不再维护正式本地 browse history 链。
+4. runtime story 已支持随请求提交 snapshot，由后端内部解释与持久化。
+5. NPC 待接委托 `replace / abandon / accept` 已以后端 runtime action 为准。
+6. custom world profile 浏览器正式入口已改走后端 route。
+7. `questDirector` / `runtimeItemAiDirector` 已收缩为前端 SDK，不再承担正式浏览器编排。
+8. NPC 招募正式结算已迁到后端：
+   - 前端只负责招募对白展示与 release 目标选择
+   - 后端负责 `npcStates / companions / roster / currentEncounter / storyHistory` 正式结算
+   - 满员换队招募已由后端承接
+
+### 5.2 剩余未完成
+
+1. `src/services/ai.ts` 仍保留 legacy fallback / test 能力，尚未彻底压缩出正式浏览器主链。
+2. 仍需继续审视是否存在其他 NPC / 运行时分支，把正式状态裁决留在前端。
+
 ---
 
 ## 6. 验收标准
diff --git a/docs/technical/README.md b/docs/technical/README.md
index 78ec122b..39a9fe86 100644
--- a/docs/technical/README.md
+++ b/docs/technical/README.md
@@ -16,7 +16,26 @@
 - [AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md](./AGENT_DIALOG_AND_RESULT_REFINEMENT_BOUNDARY_2026-04-21.md)：修正 Agent 对话框与结果页职责边界，明确 Agent 只收集八锚点，已有底稿的精修进入结果页完成。
 - [CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md](./CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md)：对照当前优化计划核查四阶段完成度，并明确这轮只允许物理删除旧 `custom-world/sessions` 世界生成链，不误伤 Agent 主链与已保存作品兼容编辑链。
 - [CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md)：梳理当前创作入口到结果页自动保存再到进入世界的全链前后端脚本地图，并给出文件级重构拆分方案、目标分层与阶段验收标准。
-- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md)：记录创作链路重构工作包 A 已落地的 RPG 创作域目录骨架、兼容 façade 和共享契约入口。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md)：梳理当前 RPG 从平台入口、继续游戏、角色选择到营地开场、冒险运行态与 runtime story 后端结算的全链脚本地图，并给出 RPG 专属命名规范、目标分层和可并行执行的工作包。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md)：记录 RPG 进入游戏与运行时链路工作包 A 已完成的新目录骨架、前后端 façade、按域路由 path 常量与兼容仓储入口。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md)：记录工作包 B 已完成的前端 RPG 入口壳层真实迁移、`rpg-entry` 新入口 hooks 收口，以及旧 `game-shell` / `rpg-creation-flow` 路径降级为兼容层的状态。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md)：记录工作包 C 已完成的 `rpg-session` 主链迁移、snapshot / save archive client 收口、旧 `useGame*` 降级为兼容 façade，以及定向回归结果。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md)：记录工作包 D 已完成的前端运行态 shell / stage router / panel router 真实迁移、AdventurePanel section 拆分，以及旧 `GameShell*` 热点降级为兼容桥的现状。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md)：记录 RPG 进入游戏与运行时链路工作包 F 已完成的后端 route 真正拆边界、`app.ts` 新域挂载、旧 `runtimeRoutes` / `storyActionRoutes` 兼容降级，以及定向路由回归验证结果。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md)：记录工作包 E 已完成的前端 runtime story 主链真实迁移、NPC 交互与 gateway/client 收口、旧入口兼容降级，以及定向回归验证结果。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md)：记录工作包 G 已完成的后端 runtime session / action service 物理迁移、新域原语导出、旧热点兼容降级，以及定向 runtime story 回归验证结果。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md)：记录工作包 H 已完成的 RPG 运行时仓储拆分、shared runtime contract 分文件、旧 `story.ts` façade 兼容与定向回归结果。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PARALLEL_BATCH_AUDIT_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PARALLEL_BATCH_AUDIT_2026-04-21.md)：对照执行计划逐项复核第一批与第二批并行工作的真实落地状态，记录本轮确认到的测试合流收口遗漏与文档索引补齐结果。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PHASE3_CLOSURE_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PHASE3_CLOSURE_2026-04-21.md)：记录 RPG 执行计划第三批收口已完成的前端新域主链接回、后端新仓储接线、shared contract 直连收紧、旧兼容脚本物理删除，以及明确未扩到 UI 和无关历史文档的边界。
+- [RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_OLD_SCRIPT_REMOVAL_2026-04-21.md](./RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_OLD_SCRIPT_REMOVAL_2026-04-21.md)：记录 RPG 主链旧 `GameShell`、`useGame*`、`hooks/story`、`runtimeRoutes`、`modules/story/*`、`contracts/story.ts` 脚本的物理删除范围、残留依赖扫描和定向验证结果。
+- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md)：记录创作链路重构工作包 A 已落地的 RPG 创作域目录骨架、兼容 façade，以及补齐后的共享契约骨架入口。
+- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md)：记录工作包 E 已完成的后端 Agent 编排拆分、executor 物理迁移、发布链切到 `CustomWorldAgentPublishingService`、checkpoint 真快照、场景资产 coverage 收口，以及 Phase3/Phase5 定向回归结果。
+- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md)：记录工作包 H 已完成的共享契约物理拆分、旧命名兼容分文件、统一 fixture，以及 shared contract test / preview compiler / works assembler / works service 回归基建。
+- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md)：记录工作包 B 已完成的前端平台壳层编排拆分、平台 hooks / coordinator 接入、旧入口兼容保留，以及交互回归验证结果。
+- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md)：记录工作包 F 已完成的后端 session/store/repository 拆分、works 读模型 service 收口、route/context 直接注入新仓储，以及定向 custom world 回归验证结果。
+- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md)：记录工作包 D 已完成的前端 custom world client 真正迁出、旧 service 兼容降级，以及平台壳层/结果页测试切换到 `rpgCreation` 域入口的现状。
+- [CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md](./CREATION_FLOW_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md)：记录工作包 G 已完成的 runtime profile 目录化、服务端 preview compiler 收口，以及 foundation draft 主生成链与 preview 编译边界的直接拆开。
+- [CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md#93-工作包-c前端结果页与编辑器拆分](./CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md#93-%E5%B7%A5%E4%BD%9C%E5%8C%85-c%E5%89%8D%E7%AB%AF%E7%BB%93%E6%9E%9C%E9%A1%B5%E4%B8%8E%E7%BC%96%E8%BE%91%E5%99%A8%E6%8B%86%E5%88%86)：记录工作包 C 已完成的结果页壳层拆分、编辑器目标分发与 mapper 收口、角色资产工坊 section/workflow 拆分，以及仍保留的阶段性 shared 实现边界。
 - [CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md](./CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md)：创作页移动端底部 Tab、亮色主题 token 与滚动权责修复记录。
 - [TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md](./TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md)：把外部仓库 TXT 模式完整迁入当前项目的冻结边界、模块映射、分阶段计划与验收清单。
 - [NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md](./NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md)：当前 Node 运行时后端的技术栈、入口、鉴权、存储与接口知识图谱。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
new file mode 100644
index 00000000..ba2081ff
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
@@ -0,0 +1,999 @@
+# RPG 进入游戏与运行时链路重构执行方案
+
+更新时间：`2026-04-21`
+
+## 0. 文档目标
+
+本文只处理一件事：
+
+**把当前 RPG 玩法从“平台入口/继续游戏/世界详情开始游戏”到“角色选择/营地开场/冒险运行态/runtime story 后端动作结算”的整条前后端脚本链路，整理成一份可以直接指导后续并行重构的执行方案。**
+
+本轮不直接修改业务玩法，不新增需求，只明确：
+
+1. 当前链路上的真实脚本地图
+2. 当前命名、目录、边界和可读性问题
+3. 面向 RPG 类型游戏的专属命名规范
+4. 目标分层与文件级拆分建议
+5. 可同时并行推进的工作包与阶段验收标准
+
+同时补充一条必须冻结的执行约束：
+
+**本次以及后续按本文推进的 RPG 链路重构，只允许调整脚本结构、命名、职责边界、数据流和兼容 façade，不允许修改任何前端交互界面设计。**
+
+---
+
+## 1. 范围与依据
+
+### 1.1 本文覆盖的 RPG 进入游戏链路
+
+```text
+平台首页 / 作品详情 / 继续游戏
+-> 选择世界或恢复存档
+-> 角色选择
+-> 初始化 GameState / Snapshot / Session
+-> 营地开场
+-> 冒险运行态 shell
+-> 冒险面板 / 角色面板 / 背包面板
+-> runtime story 选项解析与动作结算
+-> 服务端快照持久化 / 状态回写 / 继续游戏恢复
+```
+
+### 1.2 本文主要依据
+
+1. `docs/prd/AI_NATIVE_SCENE_CHAPTER_GAMEPLAY_PRD_AND_EXECUTION_PLAN_2026-04-08.md`
+2. `docs/design/SCENE_CHAPTER_LOOP_AND_FIRST_ENTRY_CHAPTER_QUEST_DESIGN_2026-04-08.md`
+3. `docs/experience/CURRENT_GAME_FULL_FLOW_PLAYTEST_REPORT_2026-04-07.md`
+4. `docs/technical/RUNTIME_STORY_BACKEND_BOUNDARY_MIGRATION_2026-04-19.md`
+5. `docs/technical/FRONTEND_TO_BACKEND_MIGRATION_EXECUTION_PLAN_2026-04-21.md`
+6. `docs/technical/NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md`
+
+### 1.3 本文刻意不覆盖的链路
+
+本文不处理以下内容：
+
+1. RPG 创作流程链
+2. Agent 八锚点共创流程
+3. 自定义世界结果页编辑器内部资产工坊链
+4. 非 RPG 平台公共功能的全面改造
+
+这些内容已有独立文档，本文只关注**进入 RPG 运行态之后的主玩法链**。
+
+### 1.4 前端界面冻结约束
+
+本次重构对前端界面的约束必须写死：
+
+1. 不修改任何前端交互界面设计。
+2. 不修改现有页面的视觉层级、主布局结构、按钮位置、tab 组织、弹窗/独立面板的出现方式。
+3. 不以“顺手优化体验”为理由调整入口页、选角页、冒险页、角色页、背包页的交互路径。
+4. 重构允许做的事情只包括：脚本重命名、目录迁移、hook/service 拆分、view model 收口、后端路由与服务拆分、兼容 façade 搭建。
+5. 如果个别脚本拆分必须调整 props 传递或组件装配方式，最终渲染结果与交互结果必须和当前版本保持一致。
+6. 任何会影响 UI 结构、交互节奏、面板开合形式的改动，都不属于本文工作范围，必须另开设计文档与实现任务。
+
+---
+
+## 2. 当前链路真实脚本地图
+
+## 2.1 前端入口与进入世界链
+
+| 文件 | 当前职责 | 当前问题 |
+| --- | --- | --- |
+| `src/App.tsx` | 应用入口，直接挂载 `useGameShellRuntime()` 与 `GameShellRuntime` | 入口极薄，但把“平台入口 + RPG 运行态”全部抽象成 `GameShell`，命名过泛 |
+| `src/hooks/useGameShellRuntime.ts` | 串起 `useGameFlow`、`useGamePersistence`、`useStoryGeneration`、同伴与音乐逻辑，组装整套运行时 props | 已经是事实上的 RPG 主流程装配器，但命名仍像通用 shell |
+| `src/hooks/useGameFlow.ts` | 世界选择、角色确认、`GameState` 初始化、营地遭遇创建 | 负责“进入游戏”的核心初始化，但文件名过泛，且把世界选择、选角、开局初始化混在一起 |
+| `src/hooks/useGamePersistence.ts` | 远端快照加载、自动存档、保存退出、继续游戏恢复 | 快照加载、存档写入、恢复后 runtime story 刷新耦合在同一 hook 中 |
+| `src/components/game-shell/PreGameSelectionFlow.tsx` | 平台首页、详情页、存档继续、创作入口、进入世界前流程壳层 | 仍承载过多平台级编排，不只负责 RPG 进入游戏链 |
+| `src/components/game-shell/PlatformHomeView.tsx` | 平台首页、继续游戏、公开广场、存档/个人 tab 表现层 | 视觉层文件过大，且“平台首页”与“RPG 进入游戏入口”没有显式命名边界 |
+| `src/components/game-shell/PlatformWorldDetailView.tsx` | 世界详情与“开始游戏/继续创作/发布”等操作 | `开始游戏` 是 RPG 入口动作，但当前文件名和职责仍偏平台通用详情页 |
+| `src/components/game-shell/CharacterSelectionFlow.tsx` | 角色选择、角色自定义草稿、确认进入营地 | 已是纯 RPG 选角页面，但命名仍是泛化 `SelectionFlow` |
+
+## 2.2 前端运行态壳层与面板链
+
+| 文件 | 当前职责 | 当前问题 |
+| --- | --- | --- |
+| `src/components/game-shell/GameShellRuntime.tsx` | 运行态最外层 shell，装配画布、主内容、各种 overlay | 同时承担平台主题外壳和 RPG 运行态外壳，命名与职责都偏泛 |
+| `src/components/game-shell/GameShellMainContent.tsx` | 根据 `worldType / playerCharacter / selectionStage` 在平台、选角、冒险面板三种主阶段间切换 | 实际上是 RPG 主阶段路由器，但文件名没有表达“入口阶段切换” |
+| `src/components/game-shell/GameShellStoryPanels.tsx` | 冒险/角色/背包三个主标签切换，挂载 `AdventurePanel`、`CharacterPanel`、`InventoryPanel` | 运行态主面板路由器与 tab 容器混在一起 |
+| `src/components/AdventurePanel.tsx` | 冒险主面板、对话流、选项区、任务/设置/统计 overlay、NPC 聊天输入、奖励面板 | 单文件过大，是当前前端 RPG 运行时最大热点之一 |
+| `src/components/game-shell/useGameShellRuntimeViewModel.ts` | 运行态视图模型、可见状态、过场、统计、对话指示器 | 负责运行态展示编排，但仍以 `GameShell` 泛名承载 |
+| `src/components/game-shell/useGameShellViewModel.ts` | overlay/modal/选中实体/selectionStage 的壳层状态 | 进入游戏前与进入游戏后 UI 状态混在一起，命名不够领域化 |
+
+## 2.3 前端剧情运行时协调链
+
+| 文件 | 当前职责 | 当前问题 |
+| --- | --- | --- |
+| `src/hooks/useStoryGeneration.ts` | 运行态故事主入口，拼装 runtime controller、goal session、interaction coordinator | 事实上的 RPG 叙事运行时入口，但命名过于抽象 |
+| `src/hooks/story/useStoryRuntimeController.ts` | 当前故事、AI 错误、故事请求入口、fallback story 和 commit 动作 | 浏览器 AI 请求与服务端 runtime story 共同挂在同一 controller 上 |
+| `src/hooks/story/useStoryFlowCoordinator.ts` | 汇总 goal option、interaction、session 行为，输出完整故事流程能力 | 多层 coordinator 套娃，可读性差 |
+| `src/hooks/story/useStoryGoalSessionCoordinator.ts` | 任务领奖、重置 story、恢复 story、地图移动 | 任务会话动作与 story 生命周期控制混在一起 |
+| `src/hooks/story/useStoryInteractionCoordinator.ts` | 选择分发、NPC 交互、宝藏交互、背包动作、战斗奖励、聊天输入 | 交互中心职责太重，是第二个热点文件 |
+| `src/hooks/story/npcEncounterActions.ts` | NPC 聊天、切磋、委托接受/替换/放弃、服务端 runtime action、聊天 UI 细节 | 依然是巨型多职责文件，且混合 UI 组装、状态更新、服务端请求 |
+| `src/hooks/story/runtimeStoryCoordinator.ts` | 继续游戏后恢复 runtime story、状态解析、server action 调用 | 是前端对接服务端 runtime story 的真正 gateway，但命名像临时协调器 |
+| `src/hooks/story/storyRequestCoordinator.ts` | AI 故事请求参数编排、server option catalog 决策 | 与 runtime story 主链存在交叉语义，边界不直观 |
+| `src/hooks/story/sessionActions.ts` | 地图移动、任务奖励、story reset/hydrate | “session action” 命名过泛，而且同时处理 quest/chapter/story 三类状态 |
+
+## 2.4 前端 service / client 链
+
+| 文件 | 当前职责 | 当前问题 |
+| --- | --- | --- |
+| `src/services/storageService.ts` | 存档、设置、个人看板、浏览历史、作品库、继续游戏、世界详情 | RPG 快照/存档接口与平台资料/作品库接口混在一个通用 client 中 |
+| `src/services/runtimeStoryService.ts` | `/api/runtime/story` 的状态读取、动作提交、story moment 转换 | 已接近 RPG 专属 client，但文件名仍偏通用 |
+| `src/services/aiService.ts` | 初始剧情/续写、角色聊天、NPC 聊天、runtime item、quest、custom world 共创接口 | RPG 运行时 AI、角色聊天、创作 Agent 接口混在一起，领域过宽 |
+
+## 2.5 后端路由与运行时主链
+
+| 文件 | 当前职责 | 当前问题 |
+| --- | --- | --- |
+| `server-node/src/server.ts` | 组装 `AppContext`，注入 runtimeRepository、customWorldAgentOrchestrator 等依赖 | 依赖对象过于集中，RPG 运行态缺少显式模块边界 |
+| `server-node/src/app.ts` | 注册 `/api/auth`、`/api/runtime/story`、`/api` 等总路由 | RPG 进入世界链、平台路由、编辑器路由全部在总 app 中汇合，语义不够清晰 |
+| `server-node/src/routes/runtimeRoutes.ts` | 资料、存档、浏览历史、作品库、runtime AI、世界生成等大杂糅路由 | 当前后端最大热点之一，平台资料与 RPG runtime 接口强耦合 |
+| `server-node/src/modules/story/storyActionRoutes.ts` | runtime story 状态读取、动作结算 | 路由层本身还算薄，但命名仍然过于通用 |
+| `server-node/src/modules/story/storyActionService.ts` | runtime story 状态/动作主应用服务，拼接 combat、npc、quest、treasure、LLM story | 是当前后端 RPG 运行时主热点，承担过多动作路由和 story 组装细节 |
+| `server-node/src/modules/story/runtimeSession.ts` | runtime snapshot 归一化、option 构建、viewModel 编译、legacy currentStory 构建、rawGameState 同步 | 运行态编译中心过重，加载器、编译器、同步器、兼容层全部混在一起 |
+| `server-node/src/modules/npc/npcInteractionService.ts` | NPC help/chat/fight/spar/recruit 等动作结算 | 与 runtime story 仍存在大量双向耦合 |
+| `server-node/src/modules/quest/questStoryActionService.ts` | 委托接受、交付、待接委托读取与结算 | 已承担正式 quest 语义，但入口仍埋在 storyActionService 下游 |
+| `server-node/src/repositories/runtimeRepository.ts` | 快照、存档列表、看板、浏览历史、作品库、会话等持久化读写 | 仓储过大，按技术分组而不是按 RPG 领域分组 |
+| `server-node/src/modules/runtime/runtimeSnapshotHydration.ts` | 存档/gameState/currentStory 归一化、迁移补丁、默认值填充 | 既承担快照迁移，又承担业务字段补齐，是基础设施与领域逻辑混合点 |
+| `packages/shared/src/contracts/story.ts` | 前后端 runtime story / npc chat / quest / runtime item 等共享契约 | RPG 运行时契约体量过大，story/action/state/chat 混放，难以独立演进 |
+
+---
+
+## 3. 当前结构性问题
+
+## 3.1 命名没有体现“这是 RPG 进入游戏主链”
+
+当前主链上充满以下泛化命名：
+
+1. `GameShell`
+2. `MainContent`
+3. `SelectionFlow`
+4. `runtimeRoutes`
+5. `storyActionService`
+6. `sessionActions`
+
+这些命名的问题不是“不好看”，而是：
+
+1. 无法一眼区分平台入口、RPG 进入游戏、RPG 运行态
+2. 无法一眼看出文件属于前端壳层、状态协调器、还是后端应用服务
+3. 后续非 RPG 流程接入时，很容易继续误复用这些泛化热点文件
+
+## 3.2 平台入口与 RPG 进入游戏链混在一起
+
+`PreGameSelectionFlow.tsx` 当前同时承担：
+
+1. 平台首页
+2. 详情页
+3. 存档恢复
+4. 创作入口
+5. 进入世界
+
+这会导致：
+
+1. 任何平台改动都可能碰到 RPG 进入游戏主链
+2. 任何 RPG 进入游戏改动都要穿过平台杂项状态
+3. 文件变成事实上的超大编排中心
+
+## 3.3 `GameState` 初始化、快照恢复、运行态切入没有明确分层
+
+`useGameFlow.ts`、`useGamePersistence.ts`、`useGameShellRuntime.ts` 当前共同承担：
+
+1. 新开局初始化
+2. 世界选择
+3. 角色选择
+4. 自动存档
+5. 继续游戏恢复
+6. runtime story 恢复刷新
+
+结果是：
+
+1. “进入游戏前的 session bootstrap”与“进入游戏后的自动持久化”没有明确边界
+2. 继续游戏逻辑很难单独替换或扩展
+3. 任何存档策略变更都容易影响开局链
+
+## 3.4 前端剧情运行时协调层过多，职责分散却仍然耦合
+
+当前前端 story 主链至少经过：
+
+1. `useStoryGeneration`
+2. `useStoryRuntimeController`
+3. `useStoryFlowCoordinator`
+4. `useStoryGoalSessionCoordinator`
+5. `useStoryInteractionCoordinator`
+6. `npcEncounterActions`
+7. `runtimeStoryCoordinator`
+
+问题在于：
+
+1. 层数多，但不是稳定分层，而是热点文件之间互相穿透
+2. 有些层是 view model，有些层是 action dispatcher，有些层是 server gateway，命名看不出来
+3. 浏览器 AI 续写链与服务端 runtime story 链还没有完全收口为两个明确通道
+
+## 3.5 后端路由层过于“大 runtime 大入口”
+
+`runtimeRoutes.ts` 当前同时覆盖：
+
+1. profile dashboard
+2. browse history
+3. save archives
+4. custom world library/gallery
+5. custom world profile generation
+6. runtime story 外围 AI 接口
+7. runtime item / quest 生成接口
+
+这会导致：
+
+1. RPG 进入游戏链难以抽出独立模块
+2. 平台资料接口和 RPG runtime 接口一起变更时风险高
+3. route 文件越来越像“后端总控清单”
+
+## 3.6 `runtimeSession.ts` 是当前后端最大可读性瓶颈之一
+
+这个文件当前同时做了：
+
+1. snapshot 载入
+2. rawGameState 归一化
+3. option interaction 构建
+4. battle option 编译
+5. NPC option 编译
+6. viewModel 编译
+7. legacy currentStory 兼容输出
+8. rawGameState 回写同步
+
+这会直接造成：
+
+1. 新增动作时很难判断应该改哪里
+2. 任何小调整都容易触碰多个职责
+3. 单测难以按职责拆开
+
+## 3.7 持久化仓储按技术堆叠，没有按 RPG 域拆开
+
+`runtimeRepository.ts` 把：
+
+1. snapshot
+2. save archives
+3. settings
+4. dashboard
+5. browse history
+6. custom world library
+7. custom world sessions
+
+全部堆在一起。
+
+对 RPG 进入游戏链来说，至少应该显式分开：
+
+1. 运行时快照
+2. 存档归档
+3. 平台资料
+4. 世界库/详情
+
+否则“继续游戏链”与“平台资料链”永远无法清晰拆边界。
+
+---
+
+## 4. 目标分层架构
+
+## 4.1 目标原则
+
+后续重构必须统一遵守 7 条原则：
+
+1. **平台入口只负责进入 RPG，会话真相不留在页面壳层。**
+2. **世界选择、角色选择、新开局、继续游戏恢复属于 RPG session 入口域。**
+3. **进入世界后的运行态壳层、冒险面板、story runtime 网关必须显式分层。**
+4. **前端只保留展示状态、输入状态、UI 过场状态；正式快照、正式动作、正式 story option 以后端为准。**
+5. **后端 route / application service / compiler / repository 必须按 RPG 域拆开，不再扩大“大 runtime 单文件”。**
+6. **所有新命名都要显式表达“这是 RPG 类型游戏专属流程”，不能继续依赖 `GameShell / runtime / flow` 这类泛化词。**
+7. **重构期间严格冻结前端交互界面设计，脚本重组不能改变任何页面结构与交互表现。**
+
+## 4.2 目标链路
+
+```text
+RPG 平台入口壳层
+-> RPG session bootstrap
+-> RPG 角色选择
+-> RPG 运行态 shell
+-> RPG 运行态面板路由
+-> RPG runtime story gateway
+-> RPG runtime story routes
+-> RPG runtime action/state services
+-> RPG runtime session loader/compiler
+-> RPG snapshot repository / save archive repository
+```
+
+## 4.3 推荐目录骨架
+
+### 前端
+
+```text
+src/
+├─ components/
+│  ├─ rpg-entry/
+│  ├─ rpg-runtime-shell/
+│  ├─ rpg-runtime-panels/
+│  └─ rpg-runtime-overlays/
+├─ hooks/
+│  ├─ rpg-session/
+│  └─ rpg-runtime-story/
+└─ services/
+   ├─ rpg-entry/
+   └─ rpg-runtime/
+```
+
+### 后端
+
+```text
+server-node/src/
+├─ routes/
+│  ├─ rpg-entry/
+│  ├─ rpg-profile/
+│  └─ rpg-runtime/
+├─ modules/
+│  └─ rpg-runtime-story/
+├─ services/
+│  ├─ rpg-entry/
+│  └─ rpg-runtime/
+└─ repositories/
+   ├─ rpg-entry/
+   └─ rpg-runtime/
+```
+
+---
+
+## 5. RPG 专属命名规范
+
+## 5.1 命名根
+
+后续进入游戏与运行态链统一使用以下命名根：
+
+1. `rpgEntry`
+   - 平台首页、详情页、世界进入、角色选择、继续游戏入口
+2. `rpgSession`
+   - 新开局、继续游戏恢复、快照 persistence、开局 bootstrap
+3. `rpgRuntime`
+   - 游戏内 shell、tab、面板、overlay、view model
+4. `rpgRuntimeStory`
+   - story state/action client、gateway、route、service、compiler
+5. `rpgProfile`
+   - dashboard、browse history、save archive 等玩家资料域
+
+## 5.2 命名规则
+
+1. React 组件文件统一使用 `Rpg...` 前缀。
+2. hooks 统一使用 `useRpg...` 前缀。
+3. 前端 client/gateway/adapter 统一使用 `rpg...` 小驼峰前缀。
+4. 后端 route 使用 `rpg...Routes.ts`。
+5. 后端应用服务使用 `Rpg...Service.ts`。
+6. 后端编译器/装配器使用 `Rpg...Compiler.ts` / `Rpg...Assembler.ts`。
+7. 后端仓储使用 `Rpg...Repository.ts`。
+8. 共享契约文件优先拆成 `rpgEntry...`、`rpgRuntimeStory...`、`rpgProfile...`。
+
+## 5.3 命名禁忌
+
+后续重构中禁止继续新增以下主命名：
+
+1. `GameShell*`
+2. `PreGame*`
+3. `SelectionFlow*`
+4. `runtimeRoutes.ts` 这种单文件总入口命名
+5. `storyActionService.ts` 这种过宽的单域名
+6. `sessionActions.ts`、`flowCoordinator.ts`、`manager.ts`、`helper.ts` 作为主业务模块名
+
+## 5.4 关键文件重命名建议
+
+| 当前文件 | 目标命名 | 说明 |
+| --- | --- | --- |
+| `src/components/game-shell/PreGameSelectionFlow.tsx` | `src/components/rpg-entry/RpgEntryFlowShell.tsx` | 平台进入世界与选角前阶段壳层 |
+| `src/components/game-shell/PlatformHomeView.tsx` | `src/components/rpg-entry/RpgEntryHomeView.tsx` | RPG 平台首页 |
+| `src/components/game-shell/PlatformWorldDetailView.tsx` | `src/components/rpg-entry/RpgEntryWorldDetailView.tsx` | 世界详情与开始游戏入口 |
+| `src/components/game-shell/CharacterSelectionFlow.tsx` | `src/components/rpg-entry/RpgEntryCharacterSelectView.tsx` | RPG 选角页 |
+| `src/hooks/useGameFlow.ts` | `src/hooks/rpg-session/useRpgSessionBootstrap.ts` | 新开局/世界选择/角色确认 |
+| `src/hooks/useGamePersistence.ts` | `src/hooks/rpg-session/useRpgSessionPersistence.ts` | 自动存档/继续游戏恢复 |
+| `src/hooks/useGameShellRuntime.ts` | `src/hooks/rpg-session/useRpgRuntimeSession.ts` | RPG 主运行态装配器 |
+| `src/components/game-shell/GameShellRuntime.tsx` | `src/components/rpg-runtime-shell/RpgRuntimeShell.tsx` | 运行态总外壳 |
+| `src/components/game-shell/GameShellMainContent.tsx` | `src/components/rpg-runtime-shell/RpgRuntimeStageRouter.tsx` | 平台/选角/冒险阶段切换 |
+| `src/components/game-shell/GameShellStoryPanels.tsx` | `src/components/rpg-runtime-panels/RpgRuntimePanelRouter.tsx` | 冒险/角色/背包主标签路由 |
+| `src/components/AdventurePanel.tsx` | `src/components/rpg-runtime-panels/RpgAdventurePanel.tsx` | 冒险主面板 |
+| `src/hooks/useStoryGeneration.ts` | `src/hooks/rpg-runtime-story/useRpgRuntimeStory.ts` | 前端 story 运行态主入口 |
+| `src/hooks/story/useStoryRuntimeController.ts` | `src/hooks/rpg-runtime-story/useRpgRuntimeStoryController.ts` | 当前 story 与请求控制 |
+| `src/hooks/story/useStoryFlowCoordinator.ts` | `src/hooks/rpg-runtime-story/useRpgRuntimeStoryFlow.ts` | story 主编排 |
+| `src/hooks/story/useStoryInteractionCoordinator.ts` | `src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.ts` | runtime 交互分发 |
+| `src/hooks/story/npcEncounterActions.ts` | `src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts` | NPC 交互与聊天动作 |
+| `src/hooks/story/runtimeStoryCoordinator.ts` | `src/hooks/rpg-runtime-story/rpgRuntimeStoryGateway.ts` | 前端到后端 runtime story 网关 |
+| `src/services/runtimeStoryService.ts` | `src/services/rpg-runtime/rpgRuntimeStoryClient.ts` | `/api/runtime/story` client |
+| `src/services/storageService.ts` | 拆成 `rpgProfileClient.ts` / `rpgEntryLibraryClient.ts` / `rpgSnapshotClient.ts` | 按领域拆 client |
+| `server-node/src/routes/runtimeRoutes.ts` | 拆成 `rpgProfileRoutes.ts` / `rpgEntryRoutes.ts` / `rpgRuntimeAiRoutes.ts` / `rpgWorldLibraryRoutes.ts` | 拒绝单文件总路由 |
+| `server-node/src/modules/story/storyActionRoutes.ts` | `server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts` | runtime story 专属路由 |
+| `server-node/src/modules/story/storyActionService.ts` | `RpgRuntimeStoryActionService.ts` + `RpgRuntimeStoryStateService.ts` | 动作结算与状态读取拆开 |
+| `server-node/src/modules/story/runtimeSession.ts` | `RpgRuntimeSessionLoader.ts` + `RpgRuntimeOptionCompiler.ts` + `RpgRuntimeSnapshotSync.ts` | 按职责拆分 |
+| `server-node/src/repositories/runtimeRepository.ts` | `RpgRuntimeSnapshotRepository.ts` 等多个仓储 | 按领域拆仓储 |
+| `packages/shared/src/contracts/story.ts` | 拆成 `rpgRuntimeStory.ts` / `rpgRuntimeChat.ts` / `rpgRuntimeAction.ts` | 契约拆分 |
+
+---
+
+## 6. 前端重构拆分方案
+
+## 6.1 RPG 入口壳层拆分
+
+### 当前问题
+
+`PreGameSelectionFlow.tsx` 当前同时承担平台首页、详情页、进入世界、存档恢复与部分创作入口逻辑。
+
+### 目标拆分
+
+保留一个极薄的 `RpgEntryFlowShell.tsx`，只负责：
+
+1. 入口阶段切换
+2. 装配子页面
+3. loading / error 壳层
+
+从当前文件拆出：
+
+1. `useRpgEntryBootstrap.ts`
+2. `useRpgEntryNavigation.ts`
+3. `useRpgEntrySaveResume.ts`
+4. `useRpgEntryLibraryDetail.ts`
+5. `RpgEntryHomeView.tsx`
+6. `RpgEntryWorldDetailView.tsx`
+7. `RpgEntryCharacterSelectView.tsx`
+
+### 关键要求
+
+1. 入口壳层不再直接操作作品库、浏览历史、看板的多路加载细节。
+2. 入口壳层不再直接处理“继续游戏后刷新 runtime story”的逻辑。
+3. 创作入口与 RPG 进入世界入口要显式分段，不再共享大文件。
+4. 页面视觉结构、按钮布局、tab 形式和独立面板交互方式保持不变。
+
+## 6.2 RPG session bootstrap / persistence 拆分
+
+### 当前问题
+
+`useGameFlow.ts` 与 `useGamePersistence.ts` 共同承担了开局初始化、世界进入、存档自动保存和恢复。
+
+### 目标拆分
+
+建议拆出：
+
+1. `useRpgSessionBootstrap.ts`
+2. `useRpgCharacterEntry.ts`
+3. `useRpgSnapshotPersistence.ts`
+4. `useRpgContinueGame.ts`
+5. `rpgSnapshotClient.ts`
+
+### 关键要求
+
+1. 新开局初始化与继续游戏恢复是两条显式流程。
+2. `GameState` 初始化逻辑不再和自动存档逻辑放在同一 hook 里。
+3. 存档自动保存不再直接夹带 UI 层状态决策。
+4. 脚本拆分后不改变用户看到的进入游戏流程和交互顺序。
+
+## 6.3 RPG 运行态 shell 与面板拆分
+
+### 当前问题
+
+`GameShellRuntime.tsx`、`GameShellMainContent.tsx`、`GameShellStoryPanels.tsx`、`AdventurePanel.tsx` 共同组成了一个过于耦合的壳层群。
+
+### 目标拆分
+
+建议形成：
+
+1. `RpgRuntimeShell.tsx`
+2. `RpgRuntimeStageRouter.tsx`
+3. `RpgRuntimePanelRouter.tsx`
+4. `RpgAdventurePanel.tsx`
+5. `RpgRuntimeOverlayHost.tsx`
+6. `useRpgRuntimeShellViewModel.ts`
+
+### 关键要求
+
+1. 运行态最外层壳层只管布局、背景、过场和 overlay host。
+2. 主阶段路由器只管“平台/选角/冒险”的分流。
+3. 面板路由器只管“冒险/角色/背包”的主 tab 分流。
+4. `AdventurePanel` 内部继续按“story 区 / option 区 / overlay 区”拆 section。
+5. 不重做任何面板样式、信息层次和交互布局，拆分只发生在脚本内部。
+
+## 6.4 前端 runtime story 主链拆分
+
+### 当前问题
+
+前端 runtime story 主链层数太多，但边界并不稳定。
+
+### 目标拆分
+
+建议收成四层：
+
+1. `useRpgRuntimeStory.ts`
+   - 作为唯一对上输出入口
+2. `useRpgRuntimeStoryState.ts`
+   - 管当前 story、loading、error、hydration
+3. `useRpgRuntimeInteractionFlow.ts`
+   - 分发 NPC / 战斗 / 宝藏 / 任务 / 地图动作
+4. `rpgRuntimeStoryGateway.ts`
+   - 只负责和后端 runtime story client 交互
+
+### 关键要求
+
+1. 浏览器侧 AI 续写逻辑与 server runtime story 逻辑必须显式分离。
+2. `npcEncounterActions.ts` 中的 UI 细节和正式动作结算必须拆开。
+3. 任何 `resolveServerRuntimeChoice(...)` 都应只通过统一 gateway 入口调用。
+4. 交互按钮、对话区、输入区和奖励展示的前端交互形式保持现状不变。
+
+## 6.5 前端 service/client 收口方案
+
+### 当前问题
+
+`storageService.ts` 与 `aiService.ts` 的领域过宽。
+
+### 目标拆分
+
+建议新增：
+
+1. `src/services/rpg-entry/rpgEntryLibraryClient.ts`
+2. `src/services/rpg-entry/rpgProfileClient.ts`
+3. `src/services/rpg-runtime/rpgSnapshotClient.ts`
+4. `src/services/rpg-runtime/rpgRuntimeStoryClient.ts`
+5. `src/services/rpg-runtime/rpgRuntimeChatClient.ts`
+
+### 关键要求
+
+1. `storageService.ts` 逐步降级为兼容 façade。
+2. `aiService.ts` 逐步只保留通用 AI 与创作域 client，不继续承接 RPG runtime story 主链。
+3. 进入游戏链不能再依赖过宽的通用 client 文件。
+
+---
+
+## 7. 后端重构拆分方案
+
+## 7.1 route 层拆分
+
+### 当前问题
+
+`runtimeRoutes.ts` 过重，平台资料、作品库和 RPG runtime 都在一起。
+
+### 目标拆分
+
+建议拆成：
+
+1. `server-node/src/routes/rpg-profile/rpgProfileRoutes.ts`
+2. `server-node/src/routes/rpg-entry/rpgEntrySaveRoutes.ts`
+3. `server-node/src/routes/rpg-entry/rpgWorldLibraryRoutes.ts`
+4. `server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts`
+5. `server-node/src/routes/rpg-runtime/rpgRuntimeAiAssistRoutes.ts`
+
+### 关键要求
+
+1. RPG 进入游戏链相关接口必须从“大 runtime 总路由”中抽离。
+2. `app.ts` 中要能一眼看出平台资料、世界库、runtime story 的路由边界。
+3. route 层继续保持薄，不直接承载 story 业务决策。
+
+## 7.2 runtime story service 拆分
+
+### 当前问题
+
+`storyActionService.ts` 当前同时承担状态读取、动作结算、LLM story 包装和 snapshot 持久化。
+
+### 目标拆分
+
+建议拆为：
+
+1. `RpgRuntimeStoryStateService.ts`
+2. `RpgRuntimeStoryActionService.ts`
+3. `RpgRuntimeCombatActionService.ts`
+4. `RpgRuntimeNpcActionService.ts`
+5. `RpgRuntimeStoryPresentationCompiler.ts`
+6. `RpgRuntimeStorySnapshotCommitService.ts`
+
+### 关键要求
+
+1. 状态读取与动作结算分开。
+2. 各子域动作要能各自单测，不再全部挂在一个 service 里。
+3. LLM 二次包装 story 文本不能继续散在动作服务主文件中。
+
+## 7.3 `runtimeSession.ts` 目录化拆分
+
+### 当前问题
+
+`runtimeSession.ts` 已经集中了太多运行时编译职责。
+
+### 目标拆分
+
+建议新增目录：
+
+```text
+server-node/src/modules/rpg-runtime-story/session/
+├─ RpgRuntimeSessionLoader.ts
+├─ RpgRuntimeEncounterNormalizer.ts
+├─ RpgRuntimeOptionCompiler.ts
+├─ RpgRuntimeBattleOptionCompiler.ts
+├─ RpgRuntimeNpcOptionCompiler.ts
+├─ RpgRuntimeViewModelCompiler.ts
+├─ RpgRuntimeLegacyStoryAdapter.ts
+└─ RpgRuntimeSnapshotSync.ts
+```
+
+### 关键要求
+
+1. loader、compiler、legacy adapter、snapshot sync 必须物理拆开。
+2. “是否生成 legacy currentStory”要成为单独兼容层，而不是散落在核心编排里。
+3. interaction 语义编译要可单测、可扩展。
+
+## 7.4 repository 拆分
+
+### 当前问题
+
+`runtimeRepository.ts` 不是 RPG 进入游戏链友好的结构。
+
+### 目标拆分
+
+建议拆成：
+
+1. `RpgRuntimeSnapshotRepository.ts`
+2. `RpgSaveArchiveRepository.ts`
+3. `RpgProfileDashboardRepository.ts`
+4. `RpgBrowseHistoryRepository.ts`
+5. `RpgWorldLibraryRepository.ts`
+
+### 关键要求
+
+1. snapshot、save archive 与资料型仓储分离。
+2. 世界库详情读取与运行时快照读写不再耦合在同一仓储。
+3. 后续“继续游戏”链可以只依赖 snapshot/save archive 仓储。
+
+## 7.5 shared contract 拆分
+
+### 当前问题
+
+`packages/shared/src/contracts/story.ts` 已经过大。
+
+### 目标拆分
+
+建议拆为：
+
+1. `rpgRuntimeStoryAction.ts`
+2. `rpgRuntimeStoryState.ts`
+3. `rpgRuntimeChat.ts`
+4. `rpgRuntimeQuestAssist.ts`
+
+### 关键要求
+
+1. runtime story 主链契约要能独立演进，不被 NPC chat / quest / item 附属能力拖累。
+2. 前后端只在必要范围共享契约，减少大而全文件。
+
+---
+
+## 8. 可并行重构工作包
+
+本次执行计划必须拆成多个可以同时推进的工作部分。
+
+总原则如下：
+
+1. 每个工作包只负责一组明确文件。
+2. 每个工作包先建新目录和 façade，再迁真实调用，再清旧层。
+3. 同一阶段允许并行，但禁止多人同时大改同一热点主文件。
+
+## 8.1 工作包 A：RPG 命名规范与目录骨架
+
+### 目标
+
+先建立 RPG 进入游戏链的新命名与目录落点。
+
+### 负责范围
+
+1. `src/components/rpg-entry/`
+2. `src/components/rpg-runtime-shell/`
+3. `src/components/rpg-runtime-panels/`
+4. `src/hooks/rpg-session/`
+5. `src/hooks/rpg-runtime-story/`
+6. `src/services/rpg-entry/`
+7. `src/services/rpg-runtime/`
+8. `server-node/src/routes/rpg-*/`
+9. `server-node/src/modules/rpg-runtime-story/`
+10. `server-node/src/repositories/rpg-*/`
+
+### 写入边界
+
+1. 只建目录、入口 façade、导出索引和基础命名规范。
+2. 不负责大规模迁移老逻辑。
+
+### 前置依赖
+
+无，可立即开始。
+
+## 8.2 工作包 B：前端 RPG 入口壳层拆分
+
+### 目标
+
+把平台首页/详情页/继续游戏/进入世界从 `PreGameSelectionFlow.tsx` 拆出来。
+
+### 负责范围
+
+1. `PreGameSelectionFlow.tsx`
+2. `PlatformHomeView.tsx`
+3. `PlatformWorldDetailView.tsx`
+4. `CharacterSelectionFlow.tsx`
+5. 入口阶段相关新 hooks
+
+### 写入边界
+
+1. 只改前端入口链。
+2. 不改后端接口语义。
+3. 不拆运行态冒险面板。
+4. 不修改任何前端交互界面设计。
+
+### 前置依赖
+
+依赖工作包 A 的目录骨架。
+
+## 8.3 工作包 C：前端 session/bootstrap/persistence 拆分
+
+### 目标
+
+把 `useGameFlow.ts`、`useGamePersistence.ts`、`useGameShellRuntime.ts` 收成 RPG session 域。
+
+### 负责范围
+
+1. `useGameFlow.ts`
+2. `useGamePersistence.ts`
+3. `useGameShellRuntime.ts`
+4. `storageService.ts` 中 snapshot/save archive 相关调用入口
+
+### 写入边界
+
+1. 主要改 session bootstrap、自动存档、继续游戏恢复。
+2. 不改 AdventurePanel UI。
+3. 不改后端 storyActionService 语义。
+4. 不修改任何前端交互界面设计。
+
+### 前置依赖
+
+依赖工作包 A，可与 B、D、F、G、H 并行。
+
+## 8.4 工作包 D：前端运行态 shell 与面板拆分
+
+### 目标
+
+把 `GameShellRuntime.tsx`、`GameShellMainContent.tsx`、`GameShellStoryPanels.tsx`、`AdventurePanel.tsx` 拆成 RPG runtime shell 体系。
+
+### 负责范围
+
+1. 运行态 shell
+2. 主阶段路由器
+3. 面板路由器
+4. 冒险主面板 section
+
+### 写入边界
+
+1. 主改组件与 view model。
+2. 不改 runtime story 后端协议。
+3. 不改平台入口链。
+4. 不修改任何前端交互界面设计。
+
+### 前置依赖
+
+依赖工作包 A，可与 B、C、E、F、G、H 并行。
+
+## 8.5 工作包 E：前端 runtime story 与 NPC 交互链拆分
+
+### 目标
+
+把多层 story coordinator 收成稳定的 RPG runtime story 结构。
+
+### 负责范围
+
+1. `useStoryGeneration.ts`
+2. `useStoryRuntimeController.ts`
+3. `useStoryFlowCoordinator.ts`
+4. `useStoryGoalSessionCoordinator.ts`
+5. `useStoryInteractionCoordinator.ts`
+6. `npcEncounterActions.ts`
+7. `runtimeStoryCoordinator.ts`
+8. `runtimeStoryService.ts`
+
+### 写入边界
+
+1. 只改前端 runtime story 主链。
+2. 不拆平台首页和世界详情壳层。
+3. 不直接修改后端动作语义。
+4. 不修改任何前端交互界面设计。
+
+### 前置依赖
+
+依赖工作包 A，可与 B、C、D、F、G、H 并行。
+
+## 8.6 工作包 F：后端 route 边界拆分
+
+### 目标
+
+把 `runtimeRoutes.ts` 与 `storyActionRoutes.ts` 按 RPG 域拆边界。
+
+### 负责范围
+
+1. `app.ts`
+2. `runtimeRoutes.ts`
+3. `storyActionRoutes.ts`
+4. 新 `rpgProfileRoutes.ts`
+5. 新 `rpgEntry...Routes.ts`
+6. 新 `rpgRuntimeStoryRoutes.ts`
+
+### 写入边界
+
+1. 只调整路由组织和 façade。
+2. 不重写下游全部 service 逻辑。
+
+### 前置依赖
+
+依赖工作包 A，可与 B、C、D、E、G、H 并行。
+
+## 8.7 工作包 G：后端 runtime session / action service 拆分
+
+### 目标
+
+把 `storyActionService.ts` 与 `runtimeSession.ts` 目录化拆开。
+
+### 负责范围
+
+1. `storyActionService.ts`
+2. `runtimeSession.ts`
+3. `npcInteractionService.ts`
+4. `questStoryActionService.ts`
+5. 新 action service / compiler / adapter 文件
+
+### 写入边界
+
+1. 主改后端运行时 story 主链。
+2. 不改前端入口与 UI。
+3. 不负责仓储拆分。
+
+### 前置依赖
+
+依赖工作包 A，可与 B、C、D、E、F、H 并行。
+
+## 8.8 工作包 H：仓储、契约与测试基建
+
+### 目标
+
+把 snapshot/profile/library 仓储与 shared contract 收成独立层，并补齐测试。
+
+### 负责范围
+
+1. `runtimeRepository.ts`
+2. `runtimeSnapshotHydration.ts`
+3. `packages/shared/src/contracts/story.ts`
+4. runtime story / snapshot / continue game 相关测试
+
+### 写入边界
+
+1. 只负责仓储、契约、fixture、测试。
+2. 不直接改前端 UI。
+3. 不重写 route 层。
+
+### 前置依赖
+
+依赖工作包 A，可与 B、C、D、E、F、G 并行。
+
+## 8.9 推荐并行顺序
+
+```text
+第一批并行：
+工作包 A
+
+第二批并行：
+工作包 B + 工作包 C + 工作包 D + 工作包 E + 工作包 F + 工作包 G + 工作包 H
+
+第三批收口：
+把 B~H 的 façade 接回主链
+-> 联调继续游戏 / 开始游戏 / 角色选择 / 冒险 runtime / 存档恢复
+-> 清理旧命名与兼容导出
+```
+
+## 8.10 并行协作约束
+
+1. 工作包 B 独占 `PreGameSelectionFlow.tsx`、`PlatformHomeView.tsx`、`PlatformWorldDetailView.tsx`、`CharacterSelectionFlow.tsx`。
+2. 工作包 C 独占 `useGameFlow.ts`、`useGamePersistence.ts`、`useGameShellRuntime.ts`。
+3. 工作包 D 独占 `GameShellRuntime.tsx`、`GameShellMainContent.tsx`、`GameShellStoryPanels.tsx`、`AdventurePanel.tsx`。
+4. 工作包 E 独占 story runtime hooks 与 `runtimeStoryService.ts`。
+5. 工作包 F 独占 `runtimeRoutes.ts`、`storyActionRoutes.ts`、`app.ts`。
+6. 工作包 G 独占 `storyActionService.ts`、`runtimeSession.ts` 与相关 runtime story modules。
+7. 工作包 H 独占 `runtimeRepository.ts`、`runtimeSnapshotHydration.ts` 与 shared runtime story contracts。
+
+---
+
+## 9. 分阶段落地计划
+
+## Phase 0：冻结命名与边界口径
+
+### 目标
+
+先冻结“RPG 入口链 / RPG session / RPG runtime / RPG runtime story / RPG profile”五类命名边界。
+
+### 验收标准
+
+1. 后续新增文件不再继续进入 `GameShell*`、`runtimeRoutes.ts`、`storyActionService.ts` 这类旧热点。
+2. 团队对文件落点和命名根达成一致。
+3. 团队对“脚本重构不改前端交互界面设计”的冻结边界达成一致。
+
+## Phase 1：目录骨架与前端入口拆分
+
+### 目标
+
+先建立目录骨架，并把进入游戏前的前端壳层从大文件中拆开。
+
+### 验收标准
+
+1. 平台首页/详情页/选角能落到 `rpgEntry` 目录。
+2. `PreGameSelectionFlow.tsx` 退化为兼容壳层或 façade。
+3. 页面视觉结构与交互方式和当前线上版本保持一致。
+
+## Phase 2：session/bootstrap/persistence 收口
+
+### 目标
+
+把“新开局/继续游戏/自动存档/恢复 runtime story”从组件与面板层抽离。
+
+### 验收标准
+
+1. `useGameFlow.ts`、`useGamePersistence.ts` 不再是直接主入口命名。
+2. 继续游戏与自动存档都能走独立 session hook。
+3. 用户看到的开始游戏/继续游戏交互顺序不变。
+
+## Phase 3：运行态 shell 与 runtime story 主链拆分
+
+### 目标
+
+把冒险运行态 UI 壳层与 runtime story 协调层分别重构。
+
+### 验收标准
+
+1. `AdventurePanel.tsx` 不再是大一统主热点。
+2. 前端 runtime story 主链收成 3~4 个稳定层级，而不是多层 coordinator 套娃。
+3. 冒险态界面布局、tab 交互与 overlay 呈现方式不变。
+
+## Phase 4：后端 route / service / compiler / repository 目录化
+
+### 目标
+
+把后端“大 runtime route + 大 storyActionService + 大 runtimeSession + 大 runtimeRepository”按 RPG 域拆开。
+
+### 验收标准
+
+1. `runtimeRoutes.ts` 退化为 façade 或被拆空。
+2. `storyActionService.ts` 只保留兼容导出。
+3. `runtimeSession.ts` 只保留 façade 或兼容导出。
+4. `runtimeRepository.ts` 不再承载全部 RPG 资料与快照职责。
+5. 前端交互界面设计在整个后端重构阶段保持零变更。
+
+## Phase 5：兼容层清理
+
+### 目标
+
+在主链稳定后清理旧命名与旧 façade。
+
+### 验收标准
+
+1. 进入游戏主链只剩 RPG 专属命名文件。
+2. `GameShell*` 与 `runtimeRoutes.ts` 不再是主链真实入口。
+3. 文档、契约、测试口径一致。
+
+---
+
+## 10. 验收标准
+
+本次重构方案最终要达成以下结果：
+
+1. 从“平台首页/详情页开始游戏”到“进入 RPG 运行态”的脚本链能一眼看出前端入口、session、runtime、story 的层级。
+2. 进入游戏主链不再依赖过于泛化的 `GameShell / runtime / flow` 命名。
+3. 前端自动存档、继续游戏恢复、runtime story server gateway 具备独立文件边界。
+4. 后端 route、runtime story service、session compiler、snapshot repository 分层清晰。
+5. 所有新主文件都以 RPG 域命名，不再继续扩大旧热点文件。
+6. 整个重构过程不改变任何前端交互界面设计，用户可见交互保持一致。
+
+---
+
+## 11. 结论
+
+当前 RPG 进入游戏后的主玩法链，真正的问题不是单点 bug，而是：
+
+**平台入口、会话初始化、运行态壳层、前端 runtime story 协调链、后端 route 总入口、后端 runtime session 编译器和仓储层同时过重，而且命名没有体现“这是 RPG 专属主链”。**
+
+后续正确的重构方向不是继续在 `GameShell`、`runtimeRoutes.ts`、`storyActionService.ts` 这些热点文件上打补丁，而是把主链收成：
+
+**RPG 入口域 -> RPG session 域 -> RPG runtime shell 域 -> RPG runtime story 域 -> RPG snapshot / profile 域**
+
+只有这样，这条“开始游戏 -> 进入运行态 -> 推进剧情 -> 自动存档 -> 继续游戏”的链路，才会真正具备后续可读、可扩、可并行维护的工程形态。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_OLD_SCRIPT_REMOVAL_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_OLD_SCRIPT_REMOVAL_2026-04-21.md
new file mode 100644
index 00000000..105f9bef
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_OLD_SCRIPT_REMOVAL_2026-04-21.md
@@ -0,0 +1,107 @@
+# RPG 进入游戏与运行时链路旧脚本删除收口记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本轮继续按 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 收口，目标只有一个：
+
+**在新 `rpg-entry`、`rpg-session`、`rpg-runtime-shell`、`rpg-runtime-panels`、`rpg-runtime-story` 主链已经接回后，物理删除旧 RPG 入口与运行态脚本，并确认源码和当前后端构建产物不再依赖旧路径。**
+
+本轮不改 UI 布局、不改按钮位置、不改 tab 组织、不改弹层交互方式，也不把历史审计文档里的旧文件名当成运行时代码依赖处理。
+
+## 2. 已删除旧脚本范围
+
+前端旧入口与旧兼容层已从源码中移除：
+
+1. `src/components/game-shell/`
+2. `src/components/game-shell/rpg-creation-flow/`
+3. `src/components/AdventurePanel.tsx`
+4. `src/hooks/story/`
+5. `src/hooks/useGameFlow.ts`
+6. `src/hooks/useGamePersistence.ts`
+7. `src/hooks/useGameShellRuntime.ts`
+8. `src/hooks/useStoryGeneration.ts`
+9. `src/services/runtimeStoryService.ts`
+10. `src/services/storageService.ts`
+
+后端与共享契约旧入口已从源码中移除：
+
+1. `server-node/src/routes/runtimeRoutes.ts`
+2. `server-node/src/modules/story/runtimeSession.ts`
+3. `server-node/src/modules/story/storyActionRoutes.ts`
+4. `server-node/src/modules/story/storyActionService.ts`
+5. `packages/shared/src/contracts/story.ts`
+
+## 3. 新主链落点
+
+删除旧脚本后，RPG 主链只允许继续落在以下新域：
+
+1. 前端入口：`src/components/rpg-entry/`
+2. 前端 session：`src/hooks/rpg-session/`
+3. 前端运行态 shell：`src/components/rpg-runtime-shell/`
+4. 前端运行态面板：`src/components/rpg-runtime-panels/`
+5. 前端 runtime story：`src/hooks/rpg-runtime-story/`
+6. 前端 client：`src/services/rpg-entry/`、`src/services/rpg-runtime/`
+7. 后端 route：`server-node/src/routes/rpg-entry/`、`server-node/src/routes/rpg-profile/`、`server-node/src/routes/rpg-runtime/`
+8. 后端 runtime story：`server-node/src/modules/rpg-runtime-story/`
+9. 后端仓储：`server-node/src/repositories/rpg-entry/`、`server-node/src/repositories/rpg-profile/`、`server-node/src/repositories/rpg-runtime/`
+10. 共享契约：`packages/shared/src/contracts/rpgRuntimeStoryAction.ts`、`packages/shared/src/contracts/rpgRuntimeStoryState.ts`、`packages/shared/src/contracts/rpgRuntimeChat.ts`、`packages/shared/src/contracts/rpgRuntimeQuestAssist.ts`
+
+## 4. 残留依赖检查
+
+本轮使用旧路径和旧入口名扫描源码与当前后端构建产物，确认以下路径不存在且没有运行时代码引用：
+
+1. `src/components/game-shell`
+2. `src/hooks/story`
+3. `src/hooks/useGameFlow.ts`
+4. `src/hooks/useGamePersistence.ts`
+5. `src/hooks/useGameShellRuntime.ts`
+6. `src/hooks/useStoryGeneration.ts`
+7. `src/services/runtimeStoryService.ts`
+8. `src/services/storageService.ts`
+9. `server-node/src/routes/runtimeRoutes.ts`
+10. `server-node/src/modules/story/runtimeSession.ts`
+11. `server-node/src/modules/story/storyActionRoutes.ts`
+12. `server-node/src/modules/story/storyActionService.ts`
+13. `packages/shared/src/contracts/story.ts`
+
+补充处理：
+
+1. `npm --prefix server-node run build` 已重新生成当前 `server-node/dist/server.cjs`。
+2. 旧的忽略产物 `server-node/dist/server.js` 与 `server-node/dist/server.js.map` 是 `2026-04-18` 遗留 bundle，仍包含旧路径 sourcemap，本轮已定点删除，避免本地误跑旧构建。
+3. 当前 `server-node/dist/` 只保留 `server.cjs` 与 `server.cjs.map`，旧主入口路径扫描无命中。
+
+## 5. 本轮补丁
+
+本轮额外修正了迁移后测试 prop 类型不一致的问题：
+
+1. `src/components/rpg-runtime-panels/RpgAdventurePanel.npcChat.test.tsx`
+2. `src/components/rpg-runtime-panels/RpgAdventurePanel.test.tsx`
+
+`npcChatQuestOfferUi.replacePendingOffer` 在新面板类型中是同步布尔返回，测试 mock 已从 `async () => false` 改为 `() => false`，避免旧异步 mock 继续伪装成兼容层行为。
+
+## 6. 验证结果
+
+已通过：
+
+1. `npm run check:encoding`
+2. `npm --prefix server-node run build`
+3. `npx vitest run src/components/rpg-runtime-panels/RpgAdventurePanel.npcChat.test.tsx src/components/rpg-runtime-panels/RpgAdventurePanel.test.tsx src/services/rpg-runtime/rpgRuntimeStoryClient.test.ts src/components/rpg-entry/RpgEntryCharacterSelectView.test.tsx src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.test.ts src/hooks/rpg-runtime-story/useRpgRuntimeStoryState.test.ts src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.test.ts`
+
+定向前端回归结果：`8` 个测试文件、`37` 个测试通过。
+
+未完全通过但不属于本轮 RPG 旧脚本删除阻塞：
+
+1. `npm run typecheck`
+   - 剩余错误集中在 `packages/shared/src/contracts/rpgCreationFixtures.ts`、`src/components/auth/AccountModal.test.tsx`、`src/data/customWorldLibrary.ts`、`src/services/customWorldCover.test.ts`。
+   - 本轮已清掉 `RpgAdventurePanel*.test.tsx` 中与迁移相关的 `Promise<boolean>` 类型错误。
+2. `npm --prefix server-node run test`
+   - RPG runtime story、RPG entry save、RPG world library、RPG profile route 等相关测试通过。
+   - 剩余失败为 `custom world agent` HTTP 相关 `12` 个用例返回 `500 !== 200`，属于创作链/Agent 链路问题，不属于本轮 RPG 旧脚本删除范围。
+
+## 7. 结论
+
+当前 RPG 进入游戏与运行时主链已经不再依赖旧 `GameShell`、`useGame*`、`useStoryGeneration`、`hooks/story`、`runtimeStoryService`、`runtimeRoutes`、`modules/story/*`、`contracts/story.ts` 脚本。
+
+后续如果继续开发 RPG 入口、运行态、runtime story 或存档恢复，只应扩展新 `rpg-*` 目录与分文件契约，不应重新创建旧路径 façade。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PARALLEL_BATCH_AUDIT_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PARALLEL_BATCH_AUDIT_2026-04-21.md
new file mode 100644
index 00000000..1642c367
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PARALLEL_BATCH_AUDIT_2026-04-21.md
@@ -0,0 +1,132 @@
+# RPG 进入游戏与运行时链路重构第一批第二批并行工作复核记录
+
+更新时间：`2026-04-21`
+
+## 1. 复核目标
+
+本次复核只做一件事：
+
+**对照 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md`，检查第一批并行与第二批并行工作是否存在遗漏、未完成收口或仍停留在“看起来已完成但工程状态未闭合”的问题。**
+
+执行边界保持如下：
+
+1. 只检查工作包 A 到 H 是否达到各自文档声明的落地状态。
+2. 只补齐确认属于本次重构范围的遗漏项。
+3. 不顺手扩展 UI、玩法、协议或无关模块。
+
+## 2. 复核范围
+
+本次逐项核对了以下内容：
+
+1. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md`
+2. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md`
+3. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md`
+4. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md`
+5. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md`
+6. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md`
+7. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md`
+8. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md`
+9. `docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md`
+10. 前端 `rpg-entry`、`rpg-session`、`rpg-runtime-shell`、`rpg-runtime-panels`、`rpg-runtime-story` 新域真实实现
+11. 后端 `routes/rpg-*`、`modules/rpg-runtime-story`、`repositories/rpg-*` 新域真实实现
+12. shared contract 分文件与兼容 façade
+13. 与工作包 E / F / G / H 直接相关的定向测试与工作树状态
+
+## 3. 复核结论
+
+## 3.1 第一批并行结论
+
+第一批并行只包含工作包 A。
+
+复核结果：
+
+1. 工作包 A 要求的目录骨架、façade、barrel 与按域命名落点已经建立。
+2. 工作包 A 没有发现需要继续补做的编码遗漏。
+3. 当前 A 的剩余内容本来就属于后续工作包 B 到 H 的真实迁移，不属于遗漏。
+
+结论：
+
+**第一批并行无新增遗漏项。**
+
+## 3.2 第二批并行总体结论
+
+对照工作包 B 到 H 的进度文档与实际主链代码，当前状态如下：
+
+1. 工作包 B：`rpg-entry` 已承接真实入口实现，旧 `game-shell` / `rpg-creation-flow` 路径已降级为兼容层。
+2. 工作包 C：`rpg-session` 已承接真实 session / persistence 主链，`storageService.ts` 已退化为兼容转发层。
+3. 工作包 D：`rpg-runtime-shell` 与 `rpg-runtime-panels` 已承接真实实现，旧 `GameShell*` / `AdventurePanel` 已降级为兼容入口。
+4. 工作包 E：前端 runtime story 主链已迁入 `rpg-runtime-story`，但测试工作树存在未收口的合流状态。
+5. 工作包 F：`app.ts` 已按 `rpgProfile / rpgEntry / rpgRuntimeStory / rpgRuntimeAiAssist` 挂载新域路由，旧 `runtimeRoutes.ts` 已降级。
+6. 工作包 G：后端 runtime story action / state / session 真实实现已迁入 `modules/rpg-runtime-story`，旧热点已退化为兼容导出。
+7. 工作包 H：仓储、shared contract 与定向测试基建已落到新域命名与分文件结构。
+
+结论：
+
+**第二批并行的主链改造基本已经完成，本轮确认到的真实遗漏主要集中在“工程收口状态”而不是“功能未落地”。**
+
+## 4. 本轮确认的遗漏项
+
+## 4.1 工作包 E 相关测试文件仍处于未解决合流状态
+
+复核时发现：
+
+1. `src/hooks/story/npcEncounterActions.test.ts` 的文件内容已经切到 `../rpg-runtime-story/rpgRuntimeStoryGateway` 新路径。
+2. 但 Git 索引仍把该文件标记为 `UU`，说明这份并行工作没有真正完成收口。
+
+这会导致：
+
+1. 工作包 E 虽然逻辑上已完成迁移，但工程状态仍不能算完全闭合。
+2. 后续继续判断第二批并行是否完成时，会被未解决合流状态误判为仍未完成。
+
+## 4.2 后端总测试文件仍保留同一轮并行改动的未解决合流状态
+
+复核时发现：
+
+1. `server-node/src/app.test.ts` 仍处于 `UU` 状态。
+2. 该文件中的两侧改动并不冲突：
+   - 一侧是把微信登录测试的 cookie 解析统一改成 `readCookieValue(...)`
+   - 另一侧是补充 custom world agent SSE enriched session 回归测试
+3. 当前文件内容已经同时包含两侧结果，但索引没有完成正式收口。
+4. 合并后还残留了一个未被使用的 `accessCookie` 中间变量，属于典型的合流尾巴。
+
+这同样属于：
+
+**不是功能缺失，而是并行工作未彻底收口。**
+
+## 4.3 技术文档索引未完整登记本轮工作包文档
+
+复核时发现：
+
+1. `docs/technical/README.md` 已登记 A、D、E、F、G、H 的进度文档。
+2. 但缺少工作包 B 与工作包 C 的进度文档入口。
+3. 这会让后续按文档索引回溯第二批并行工作时出现“文档已存在但目录索引缺失”的信息断层。
+
+这属于文档收口遗漏，应当在本轮一并补齐。
+
+## 5. 本轮补齐动作
+
+本轮只补以下缺口：
+
+1. 清理 `server-node/src/app.test.ts` 中合流后残留的未使用变量，保留两侧都应保留的测试结果。
+2. 将 `src/hooks/story/npcEncounterActions.test.ts` 作为工作包 E 已确认的正确内容进行正式收口。
+3. 将 `server-node/src/app.test.ts` 作为同轮并行改动的正确合并结果进行正式收口。
+4. 更新 `docs/technical/README.md`，补齐工作包 B、工作包 C 与本复核文档入口。
+
+## 6. 本轮明确没有做的事
+
+为了避免过度开发，本轮没有继续做以下事情：
+
+1. 没有继续拆 UI 组件。
+2. 没有继续清理旧兼容 façade。
+3. 没有额外重构任何 route / service / repository。
+4. 没有调整任何前端交互界面设计。
+5. 没有顺手处理与本次 RPG 并行重构无直接关系的其他噪音文件。
+
+## 7. 复核后状态结论
+
+在本轮补齐之后，可以对第一批与第二批并行工作给出如下结论：
+
+1. 第一批并行没有发现新增遗漏。
+2. 第二批并行的主链功能改造已经基本齐备。
+3. 本轮确认并补齐的遗漏主要是测试合流收口与文档索引缺口。
+4. 当前不需要继续扩大改造范围，后续可以按执行计划进入第三批统一收口。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PHASE3_CLOSURE_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PHASE3_CLOSURE_2026-04-21.md
new file mode 100644
index 00000000..d405719f
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_PHASE3_CLOSURE_2026-04-21.md
@@ -0,0 +1,191 @@
+# RPG 进入游戏与运行时链路重构第三批收口记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **第三批收口**，严格遵守以下边界：
+
+1. 把第二批工作包 B 到 H 已完成的新域 façade 真正接回主链。
+2. 对照执行计划逐项检查“开始游戏 / 继续游戏 / 角色选择 / 冒险 runtime / 存档恢复”是否仍残留旧命名真实依赖。
+3. 只清理确认属于 RPG 主链的新域反向依赖与未接线仓储，不扩到创作链、UI 设计或玩法语义。
+
+## 2. 本次完成的第三批收口
+
+## 2.1 前端运行态主链不再反向依赖旧 `GameShell` 热点
+
+本轮把以下真实实现从旧 `game-shell` 命名下摘回 `rpg-runtime-shell`：
+
+1. `src/components/rpg-runtime-shell/RpgRuntimeCanvasStage.tsx`
+2. `src/components/rpg-runtime-shell/rpgRuntimeLoaders.tsx`
+3. `src/components/rpg-runtime-shell/useRpgSceneTransitionModel.ts`
+
+同时完成以下主链接线：
+
+1. `src/components/rpg-runtime-shell/RpgRuntimeShell.tsx` 直接使用 `RpgRuntimeCanvasStage`
+2. `src/components/rpg-runtime-shell/RpgRuntimeOverlayHost.tsx` 直接使用 `rpgRuntimeLoaders`
+3. `src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.ts` 直接使用 `useRpgSceneTransitionModel`
+4. `src/components/rpg-runtime-panels/RpgRuntimePanelRouter.tsx` 直接从 `rpg-runtime-shell` 读取 `PanelLoadingFallback`
+
+当前结果：
+
+1. 运行态主链真实实现已经不再依赖旧 `GameShellCanvasStage`、`GameShellLoaders`、`useSceneTransitionModel`。
+2. 旧 `game-shell` 文件只保留兼容 re-export，不再作为 RPG 运行态真实落点。
+
+## 2.2 前端入口域主链不再反向依赖旧平台展示 helper
+
+本轮把以下入口域通用展示能力收回 `rpg-entry`：
+
+1. `src/components/rpg-entry/RpgEntryBrandLogo.tsx`
+2. `src/components/rpg-entry/rpgEntryWorldPresentation.ts`
+3. `src/components/rpg-entry/RpgEntryCreationTypeModal.tsx`
+
+并完成以下主链接线：
+
+1. `RpgEntryHomeView.tsx` 改为直接使用 `RpgEntryBrandLogo` 与 `rpgEntryWorldPresentation`
+2. `RpgEntryWorldDetailView.tsx` 改为直接使用 `rpgEntryWorldPresentation`
+3. `RpgEntryFlowShellImpl.tsx` 改为直接使用 `RpgEntryCreationTypeModal`
+
+当前结果：
+
+1. `rpg-entry` 真实实现不再依赖旧 `PlatformBrandLogo`、`platformWorldPresentation`、`PlatformCreationTypeModal`。
+2. 旧 `game-shell` 对应文件只保留兼容导出。
+
+## 2.3 工作包 H 新仓储已真正接回后端 RPG 主链
+
+本轮把工作包 H 中已建立但尚未接回主链的新仓储正式注入 `AppContext`：
+
+1. `rpgProfileDashboardRepository`
+2. `rpgBrowseHistoryRepository`
+3. `rpgSaveArchiveRepository`
+4. `rpgRuntimeSnapshotRepository`
+
+并完成以下主链接线：
+
+1. `server-node/src/routes/rpg-profile/rpgProfileRoutes.ts`
+   - 资料看板、钱包流水、游玩统计走 `rpgProfileDashboardRepository`
+   - 浏览历史走 `rpgBrowseHistoryRepository`
+   - 设置读写走 `rpgProfileDashboardRepository`
+2. `server-node/src/routes/rpg-entry/rpgEntrySaveRoutes.ts`
+   - snapshot 读写删除走 `rpgRuntimeSnapshotRepository`
+   - save archive 列表与恢复走 `rpgSaveArchiveRepository`
+3. `server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts`
+   - runtime story 状态读取与动作结算走 `rpgRuntimeSnapshotRepository`
+
+当前结果：
+
+1. `rpgProfile`、`rpgEntrySave`、`rpgRuntimeStory` 主链已经不再直接把大 `runtimeRepository` 当作唯一注入边界。
+2. 工作包 H 的新仓储不再停留在“命名骨架已存在但主链未接线”的状态。
+
+## 2.4 新域 shared contract 进一步脱离旧 `story.ts` façade
+
+本轮继续把 RPG 新主链中的 shared contract 直接切到分文件：
+
+1. `server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts`
+   - 改为直接使用 `rpgRuntimeStoryState.ts`
+2. `server-node/src/routes/rpg-runtime/rpgRuntimeAiAssistRoutes.ts`
+   - 改为直接使用 `rpgRuntimeChat.ts`、`rpgRuntimeQuestAssist.ts`
+3. `server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionDomain.ts`
+   - 改为直接使用 `rpgRuntimeStoryAction.ts`
+   - snapshot 类型改为使用 `RpgRuntimeSavedSnapshot`
+4. `server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionDomain.ts`
+   - runtime story request/response 类型改为直接使用 `rpgRuntimeStoryState.ts`
+   - snapshot 仓储端口改为使用 `RpgRuntimeSnapshotRepositoryPort`
+
+当前结果：
+
+1. RPG 新域主链已经显著减少对旧 `packages/shared/src/contracts/story.ts` façade 的反向依赖。
+2. `story.ts` 继续保留兼容职责，但不再是第三批已收口主链的真实首选入口。
+
+## 2.5 补齐世界库主链接线遗漏
+
+代码级复核后，本轮额外补齐了第三批范围内一个真实遗漏：世界库主链虽然已经有 `rpg-entry` 路由和 `RpgWorldLibraryRepository`，但此前并未完整接回主链。
+
+本次补齐包括：
+
+1. `server-node/src/context.ts` 与 `server-node/src/server.ts`
+   - 正式注入 `rpgWorldLibraryRepository`
+2. `server-node/src/routes/rpg-entry/rpgWorldLibraryRoutes.ts`
+   - 作品库/广场/详情/发布/下架/删除等读写改为直接走 `rpgWorldLibraryRepository`
+   - `rpgWorldProfileRepository` 继续保留给 Agent 发布链与发布服务使用
+3. `src/services/rpg-entry/rpgEntryLibraryClient.ts`
+   - 改为直接承接 `/api/runtime/custom-world-library` 与 `/api/runtime/custom-world-gallery` 请求
+   - 不再反向依赖旧 `storageService.ts` 兼容层
+4. `src/services/rpg-entry/rpgEntryLibraryClient.test.ts`
+   - 补齐入口世界库 client 的定向回归
+
+当前结果：
+
+1. “平台首页 / 世界详情 / 开始游戏”所依赖的世界库链路，现在已经和 save/profile 一样真正回到 `rpg-entry` + `rpg-entry repository` 主链。
+2. 第三批范围内不再残留“新命名已建好，但真实主链仍穿旧兼容层/旧仓储”的世界库遗漏。
+
+## 3. 老代码物理删除补充
+
+根据后续收口要求，本轮在主链稳定后继续删除旧兼容层，不再让 RPG 入口与运行态链路通过旧脚本名兜底。
+
+已删除的旧前端入口包括：
+
+1. `src/components/AdventurePanel.tsx`
+2. `src/components/game-shell/*`
+3. `src/components/game-shell/rpg-creation-flow/*`
+4. `src/hooks/useGameFlow.ts`
+5. `src/hooks/useGamePersistence.ts`
+6. `src/hooks/useGameShellRuntime.ts`
+7. `src/hooks/useStoryGeneration.ts`
+8. `src/services/runtimeStoryService.ts`
+9. `src/services/storageService.ts`
+
+已删除的旧后端与共享契约入口包括：
+
+1. `server-node/src/routes/runtimeRoutes.ts`
+2. `server-node/src/modules/story/runtimeSession.ts`
+3. `server-node/src/modules/story/storyActionService.ts`
+4. `server-node/src/modules/story/storyActionRoutes.ts`
+5. `packages/shared/src/contracts/story.ts`
+
+同步完成的主链迁移包括：
+
+1. `RpgEntryFlowShellImpl.tsx` 直接使用 `src/components/rpg-entry/useRpgCreation*` hooks，不再反向依赖 `game-shell/rpg-creation-flow`。
+2. runtime story client 测试迁到 `src/services/rpg-runtime/rpgRuntimeStoryClient.test.ts`。
+3. profile / world library 路由测试迁到 `src/services/rpg-entry/rpgEntryClients.routing.test.ts`。
+4. 冒险面板测试迁到 `src/components/rpg-runtime-panels/RpgAdventurePanel*.test.tsx`。
+5. `AdventurePanelOverlays` 子模块改名并迁到 `src/components/rpg-runtime-panels/RpgAdventurePanelOverlays.tsx`。
+6. 后端与前端 shared contract import 已切到 `rpgRuntimeChat.ts`、`rpgRuntimeQuestAssist.ts`、`rpgRuntimeStoryAction.ts`、`rpgRuntimeStoryState.ts`。
+
+本轮仍然刻意没有继续扩大到以下内容：
+
+1. 没有重命名历史审计、旧 PRD、旧技术方案中作为历史记录出现的旧文件名。
+2. 没有继续拆分 `runtimeRepository.ts` 剩余实现。
+3. 没有改 UI 布局、按钮位置、tab 组织、弹层方式或任何用户可见交互设计。
+4. 没有清理与本执行计划无关的创作链旧文件；只删除 RPG 入口 / 运行态链路已经不再依赖的旧脚本。
+
+## 4. 本轮检查后确认的未扩范围
+
+为了避免过度开发，本轮明确没有继续扩到以下内容：
+
+1. 没有继续改 UI 布局、按钮位置、tab 组织、弹层方式或任何用户可见交互设计。
+2. 没有继续拆分 `runtimeRepository.ts` 剩余实现，也没有扩大到更多仓储接口重命名。
+3. 没有顺手清理历史文档里的旧文件名引用，只更新本次执行收口文档。
+
+## 5. 第三批遗漏复核结论
+
+对照执行计划中的第三批要求，本轮确认如下：
+
+1. **把 B 到 H 的 façade 接回主链**：已完成
+   - 前端 `rpg-entry`、`rpg-runtime-shell`、`rpg-runtime-panels`
+   - 后端 `rpg-profile`、`rpg-entry-save`、`rpg-runtime-story`
+2. **联调继续游戏 / 开始游戏 / 角色选择 / 冒险 runtime / 存档恢复**：本轮已把这些链路上的主注入边界和真实落点接回新域
+3. **清理旧命名与兼容导出**：已完成主链级清理，并按本次补充要求物理删除旧兼容脚本
+
+当前仍保留但不计为遗漏的部分：
+
+1. 历史审计、旧 PRD、旧技术方案中仍会提到旧文件名，这是历史记录，不代表运行时代码依赖。
+2. `src/components/rpg-runtime-panels/RpgAdventurePanel.tsx` 仍保持原交互结构，只做脚本路径与命名收口。
+
+## 6. 结论
+
+在“不改 UI、不改玩法、不扩到创作链执行方案”的前提下，本轮已经完成 RPG 执行计划中的第三批主链收口：
+
+1. 新域真实实现已经接回前后端主链。
+2. RPG 主链对旧 `GameShell` / `runtimeRoutes` / `story.ts` façade 的真实依赖已经删除。
+3. 复核中发现并补齐了世界库主链接线遗漏后，当前没有再发现属于本次第三批范围、且必须继续补做的遗漏项。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..c67cd443
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_A_PROGRESS_2026-04-21.md
@@ -0,0 +1,101 @@
+# RPG 进入游戏与运行时链路重构工作包 A 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 A：RPG 命名规范与目录骨架**，严格遵守以下边界：
+
+1. 先建立 RPG 进入游戏链的新目录与命名落点。
+2. 先补 façade、barrel、path 常量和按域仓储入口，不提前迁移主流程逻辑。
+3. 不修改现有前端交互界面设计，不提前实现工作包 B 到 H 的真实拆分。
+
+## 2. 本次已落地内容
+
+## 2.1 前端目录骨架
+
+已新增以下前端目录与兼容 façade：
+
+1. `src/components/rpg-entry/`
+2. `src/components/rpg-runtime-shell/`
+3. `src/components/rpg-runtime-panels/`
+4. `src/hooks/rpg-session/`
+5. `src/hooks/rpg-runtime-story/`
+6. `src/services/rpg-entry/`
+7. `src/services/rpg-runtime/`
+
+当前策略：
+
+1. `RpgEntryFlowShell` 先桥接当前真实存在的 `src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx`，不再依赖已删除的旧 `PreGameSelectionFlow.tsx`。
+2. `RpgEntryHomeView`、`RpgEntryWorldDetailView`、`RpgEntryCharacterSelectView` 继续桥接旧平台首页、世界详情和选角视图。
+3. `RpgRuntimeShell`、`RpgRuntimeStageRouter`、`RpgRuntimePanelRouter`、`RpgAdventurePanel`、`RpgRuntimeOverlayHost` 继续桥接旧 `GameShell*` 与 `AdventurePanel` 组件。
+4. `useRpgSessionBootstrap`、`useRpgSessionPersistence`、`useRpgRuntimeSession` 继续桥接 `useGameFlow`、`useGamePersistence`、`useGameShellRuntime`。
+5. `useRpgRuntimeStory`、`useRpgRuntimeStoryController`、`useRpgRuntimeStoryFlow`、`useRpgRuntimeInteractionFlow`、`useRpgRuntimeNpcInteraction`、`rpgRuntimeStoryGateway` 继续桥接旧 story runtime hooks 与 gateway。
+
+## 2.2 前端 service/client 骨架
+
+已新增以下 service/client 落点：
+
+1. `src/services/rpg-entry/rpgEntryLibraryClient.ts`
+2. `src/services/rpg-entry/rpgProfileClient.ts`
+3. `src/services/rpg-runtime/rpgSnapshotClient.ts`
+4. `src/services/rpg-runtime/rpgRuntimeStoryClient.ts`
+5. `src/services/rpg-runtime/rpgRuntimeChatClient.ts`
+
+当前策略：
+
+1. `rpgEntryLibraryClient` 继续桥接 `storageService.ts` 中的世界库、世界广场与发布相关接口。
+2. `rpgProfileClient` 继续桥接资料看板、浏览历史、设置与继续游戏归档相关接口。
+3. `rpgSnapshotClient` 继续桥接快照读写接口。
+4. `rpgRuntimeStoryClient` 继续桥接 `/api/runtime/story` 的旧 client。
+5. `rpgRuntimeChatClient` 继续桥接 `aiService.ts` 中的角色聊天、NPC 对话与招募对话接口。
+
+## 2.3 后端目录骨架
+
+已新增以下后端目录与 façade：
+
+1. `server-node/src/routes/rpg-entry/`
+2. `server-node/src/routes/rpg-profile/`
+3. `server-node/src/routes/rpg-runtime/`
+4. `server-node/src/modules/rpg-runtime-story/`
+5. `server-node/src/repositories/rpg-entry/`
+6. `server-node/src/repositories/rpg-profile/`
+7. `server-node/src/repositories/rpg-runtime/`
+
+当前策略：
+
+1. `createRpgProfileRoutes()`、`createRpgEntrySaveRoutes()`、`createRpgWorldLibraryRoutes()`、`createRpgRuntimeAiAssistRoutes()` 当前只提供空路由骨架与稳定 path 常量。
+2. `createRpgRuntimeStoryRoutes()` 继续桥接旧 `createStoryActionRoutes()`，确保 runtime story 路由已经有新命名落点。
+3. `RpgRuntimeStoryActionService`、`RpgRuntimeSessionLoader`、`RpgRuntimeOptionCompiler`、`RpgRuntimeSnapshotSync` 继续桥接旧 `storyActionService.ts` 与 `runtimeSession.ts`。
+4. `RpgRuntimeSnapshotRepository`、`RpgSaveArchiveRepository`、`RpgProfileDashboardRepository`、`RpgWorldLibraryRepository` 先以委托 runtimeRepository 的方式建立按域命名仓储入口。
+
+## 3. 本次没有做的事
+
+以下内容仍保持原状，留给后续工作包：
+
+1. 没有改 `GameShellMainContent.tsx`、`GameShellRuntime.tsx`、`AdventurePanel.tsx` 的内部实现。
+2. 没有拆 `useGameFlow.ts`、`useGamePersistence.ts`、`useGameShellRuntime.ts` 的真实逻辑。
+3. 没有拆 `useStoryGeneration.ts`、`npcEncounterActions.ts`、`runtimeStoryCoordinator.ts` 的内部职责。
+4. 没有改 `server-node/src/app.ts`、`server-node/src/routes/runtimeRoutes.ts`、`server-node/src/modules/story/storyActionService.ts`、`server-node/src/modules/story/runtimeSession.ts` 的真实挂载与内部逻辑。
+5. 没有补 shared contract 新文件，本轮执行方案的工作包 A 范围未把共享契约骨架列为必做项，因此保持到工作包 H 统一收口。
+6. 没有修改任何前端交互界面设计。
+
+## 4. 验证与现状说明
+
+本轮已执行：
+
+1. `npm run check:encoding`
+
+验证结果：
+
+1. 编码检查通过。
+2. 全量 `npm run typecheck` 当前未通过，但失败项主要来自工作树中已存在的并行修改与历史类型问题。
+3. 本轮已修正新 façade 中对已删除旧入口 `PreGameSelectionFlow.tsx` 的失效导入，当前 `RpgEntryFlowShell` 已改为桥接真实存在的 `rpg-creation-flow` 入口。
+
+## 5. 对后续工作包的直接收益
+
+1. 工作包 B 可以直接把平台入口与选角真实实现落到 `src/components/rpg-entry/`，而不必再次讨论命名与目录。
+2. 工作包 C 可以直接把 session/bootstrap/persistence 的调用方迁到 `src/hooks/rpg-session/` 与 `src/services/rpg-runtime/`。
+3. 工作包 D 可以直接让运行态壳层与面板消费 `rpg-runtime-shell`、`rpg-runtime-panels` 新入口。
+4. 工作包 E 可以直接把 story runtime 与 NPC 交互迁到 `src/hooks/rpg-runtime-story/` 和 `src/services/rpg-runtime/`。
+5. 工作包 F、G、H 可以直接基于 `server-node/src/routes/rpg-*`、`server-node/src/modules/rpg-runtime-story/`、`server-node/src/repositories/rpg-*/` 继续做真实迁移，而不用重新搭第一层命名骨架。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..97a7b689
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_B_PROGRESS_2026-04-21.md
@@ -0,0 +1,108 @@
+# RPG 进入游戏与运行时链路重构工作包 B 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 B：前端 RPG 入口壳层拆分**，严格遵守以下边界：
+
+1. 只改前端入口链，不改后端接口语义。
+2. 只处理平台首页、世界详情、继续游戏、进入世界、选角相关入口壳层与入口 hooks。
+3. 不拆运行态冒险面板，不修改任何前端交互界面设计。
+
+## 2. 本次已完成内容
+
+## 2.1 `rpg-entry` 已成为真实入口目录
+
+以下文件现在承载真实实现，不再只是 façade：
+
+1. `src/components/rpg-entry/RpgEntryFlowShell.tsx`
+2. `src/components/rpg-entry/RpgEntryFlowShellImpl.tsx`
+3. `src/components/rpg-entry/RpgEntryHomeView.tsx`
+4. `src/components/rpg-entry/RpgEntryWorldDetailView.tsx`
+5. `src/components/rpg-entry/RpgEntryCharacterSelectView.tsx`
+6. `src/components/rpg-entry/rpgEntryTypes.ts`
+7. `src/components/rpg-entry/rpgEntryShared.ts`
+
+这意味着当前 RPG 平台入口、详情页和选角页的真实物理落点已经从旧 `game-shell` 命名转入 `rpg-entry` 域，满足执行方案里“平台首页/详情页/选角能落到 `rpgEntry` 目录”的验收要求。
+
+## 2.2 入口相关 hooks 已补齐到 `rpg-entry`
+
+本轮新增或迁入以下入口域 hooks：
+
+1. `src/components/rpg-entry/useRpgEntryBootstrap.ts`
+2. `src/components/rpg-entry/useRpgEntryLibraryDetail.ts`
+3. `src/components/rpg-entry/useRpgEntryNavigation.ts`
+4. `src/components/rpg-entry/useRpgEntrySaveResume.ts`
+5. `src/components/rpg-entry/useRpgEntryCharacterSelect.ts`
+
+其中：
+
+1. `useRpgEntryBootstrap` 负责平台 works / library / gallery / history / save / dashboard 拉取与继续游戏恢复入口。
+2. `useRpgEntryLibraryDetail` 负责详情页打开、作品详情读取、继续创作入口、发布/下架/删除动作。
+3. `useRpgEntryNavigation` 收口入口阶段跳转，避免壳层里继续散落匿名 `setSelectionStage(...)`。
+4. `useRpgEntrySaveResume` 明确“继续游戏”动作入口。
+5. `useRpgEntryCharacterSelect` 补齐选角页回退与确认动作的入口域命名。
+
+## 2.3 旧 `game-shell` / `rpg-creation-flow` 路径已降级为兼容层
+
+以下旧文件已改为兼容 re-export，不再持有真实实现：
+
+1. `src/components/game-shell/PlatformHomeView.tsx`
+2. `src/components/game-shell/PlatformWorldDetailView.tsx`
+3. `src/components/game-shell/CharacterSelectionFlow.tsx`
+4. `src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx`
+5. `src/components/game-shell/rpg-creation-flow/RpgCreationShellImpl.tsx`
+6. `src/components/game-shell/rpg-creation-flow/rpgCreationFlowTypes.ts`
+7. `src/components/game-shell/rpg-creation-flow/rpgCreationFlowShared.ts`
+8. `src/components/game-shell/rpg-creation-flow/useRpgCreationPlatformBootstrap.ts`
+9. `src/components/game-shell/rpg-creation-flow/useRpgCreationDetailNavigation.ts`
+
+兼容策略如下：
+
+1. 旧命名继续导出，避免并行工作包与现有测试断开。
+2. 真实实现统一回落到 `rpg-entry`。
+3. 本轮不清理 legacy façade，只让它们退化成稳定桥接层。
+
+## 2.4 主链调用方已接回 `rpg-entry`
+
+本轮已把主入口相关调用改为直接消费 `rpg-entry`：
+
+1. `src/components/game-shell/GameShellMainContent.tsx`
+2. `src/components/game-shell/useGameShellViewModel.ts`
+3. `src/components/rpg-entry/index.ts`
+
+当前结果：
+
+1. 主阶段路由器 lazy import 已直接走 `RpgEntryFlowShell` 与 `RpgEntryCharacterSelectView`。
+2. `SelectionStage` 类型已从 `rpg-entry` 暴露，不再依赖旧 `rpg-creation-flow` 作为主命名根。
+3. 旧路径仍可用，但已经不再是主链真实入口。
+
+## 3. 对照执行方案的完成判断
+
+工作包 B 本轮已完成以下计划项：
+
+1. 已把平台首页/详情页/继续游戏/进入世界从旧 `PreGameSelectionFlow` 所属旧命名体系中收进 `rpg-entry` 域。
+2. 已让 `rpg-entry` 成为真实实现目录，而不是只保留 façade。
+3. 已补齐入口阶段相关新 hooks。
+4. 已让旧路径退化为兼容桥接层。
+5. 没有修改任何前端交互界面设计。
+
+当前仍刻意保留的边界：
+
+1. 没有拆运行态冒险面板，这属于工作包 D。
+2. 没有改 session/bootstrap/persistence 主逻辑，这属于工作包 C。
+3. 没有改后端接口语义与 route/service 边界，这属于工作包 F/G/H。
+4. 没有提前清理所有 legacy re-export，本轮以稳定主链为先。
+
+## 4. 验证与遗漏核查
+
+本轮需要重点核查的遗漏项已经逐项确认：
+
+1. `RpgEntryFlowShell` 不再桥接旧实现，已直接使用 `rpg-entry` 目录下的真实壳层。
+2. `PlatformHomeView`、`PlatformWorldDetailView`、`CharacterSelectionFlow` 的旧路径已不再持有真实实现。
+3. `GameShellMainContent` 已直接 lazy import `rpg-entry` 新入口。
+4. `SelectionStage` 已从 `rpg-entry` 作为主出口暴露。
+5. 复核时补齐了一个第二批收口遗漏：`RpgEntryFlowShellImpl`、`useRpgEntryBootstrap`、`useRpgEntryLibraryDetail` 这些 `rpg-entry` 真实实现已改为直接消费 `rpg-entry` 新域 client，不再反向依赖旧 `storageService.ts` 作为主链入口。
+
+本轮未执行全量 `typecheck`，原因是工作树存在并行改动与未解决冲突文件；但已把本工作包范围内最容易遗漏的主链接线点和兼容层路径全部补齐。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..f77bb823
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_C_PROGRESS_2026-04-21.md
@@ -0,0 +1,115 @@
+# RPG 进入游戏与运行时链路重构工作包 C 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 C：前端 session / bootstrap / persistence 拆分**，严格遵守以下边界：
+
+1. 把 `useGameFlow.ts`、`useGamePersistence.ts`、`useGameShellRuntime.ts` 的真实实现收进 `rpg-session` 域。
+2. 把 snapshot / save archive 相关 client 从 `storageService.ts` 抽到 `src/services/rpg-runtime/`、`src/services/rpg-entry/`。
+3. 旧文件只保留兼容导出，不再继续承载主实现。
+4. 不修改 AdventurePanel UI，不修改后端 story 动作语义，不修改任何前端交互界面设计。
+
+## 2. 本次已落地内容
+
+## 2.1 `rpg-session` 主实现已承接 session 链
+
+本轮已把以下真实实现迁入新域目录：
+
+1. `src/hooks/rpg-session/useRpgSessionBootstrap.ts`
+2. `src/hooks/rpg-session/useRpgSessionPersistence.ts`
+3. `src/hooks/rpg-session/useRpgRuntimeSession.ts`
+4. `src/hooks/rpg-session/rpgSessionTypes.ts`
+
+落地结果：
+
+1. `useRpgSessionBootstrap` 现在直接承载世界选择、角色确认、新开局 `GameState` 初始化逻辑。
+2. `useRpgSessionPersistence` 现在直接承载自动存档、继续游戏恢复、远端快照拉取与 runtime story 恢复刷新。
+3. `useRpgRuntimeSession` 现在直接组合 bootstrap / persistence / story / combat / companion 等链路，成为主运行态装配入口。
+
+## 2.2 旧 `useGame*` 文件已退化为兼容 façade
+
+以下旧文件已不再承载主实现，只保留兼容导出：
+
+1. `src/hooks/useGameFlow.ts`
+2. `src/hooks/useGamePersistence.ts`
+3. `src/hooks/useGameShellRuntime.ts`
+
+当前策略：
+
+1. 旧调用方仍可继续工作，避免影响并行工作包。
+2. 正式主入口已经切到 `useRpgRuntimeSession`。
+3. `BottomTab` 类型已从 `rpg-session` 域提供，避免继续绑在旧 hook 文件上。
+
+## 2.3 snapshot / save archive client 已迁到新域
+
+本轮已把快照与继续游戏归档的真实请求实现迁入：
+
+1. `src/services/rpg-runtime/rpgRuntimeRequest.ts`
+2. `src/services/rpg-runtime/rpgSnapshotClient.ts`
+3. `src/services/rpg-entry/rpgProfileClient.ts`
+
+落地结果：
+
+1. `rpgSnapshotClient` 现在直接承载 `/api/runtime/save/snapshot` 的读取、写入、删除。
+2. `rpgProfileClient` 现在直接承载设置、个人资料、浏览历史、继续游戏归档相关请求。
+3. `storageService.ts` 已退化为兼容转发层，不再继续作为 snapshot / save archive 主实现落点。
+
+## 2.4 主入口与直接类型依赖已切换
+
+本轮已更新以下直接调用点：
+
+1. `src/App.tsx` 改为直接使用 `useRpgRuntimeSession`
+2. `src/components/game-shell/types.ts`
+3. `src/components/game-shell/GameShellMainContent.tsx`
+4. `src/components/game-shell/GameShellStoryPanels.tsx`
+
+当前状态：
+
+1. 运行态主入口已经不再直接依赖 `useGameShellRuntime`。
+2. `GameShell` 相关组件仍保持 UI 与结构不变，只调整了 session 域导入路径。
+
+## 2.5 测试补齐
+
+本轮补齐或切换了以下定向测试：
+
+1. `src/hooks/runtimeAuthGuards.test.tsx`
+2. `src/hooks/useGameFlow.customWorld.test.tsx`
+3. `src/services/rpg-entry/rpgProfileClient.test.ts`
+4. `src/services/rpg-runtime/rpgSnapshotClient.test.ts`
+
+目的：
+
+1. 覆盖 `rpg-session` 新 hook 的远端鉴权守卫行为。
+2. 覆盖自定义世界进入世界后的 bootstrap 初始化结果。
+3. 覆盖迁入新域后的 browse history / save archive / snapshot 路由请求。
+
+## 3. 本次没有做的事
+
+以下内容仍保持原状，留给后续工作包：
+
+1. 没有拆 `AdventurePanel.tsx`、`GameShellRuntime.tsx`、`GameShellMainContent.tsx` 的内部 UI 组织。
+2. 没有拆 `useStoryGeneration.ts`、`npcEncounterActions.ts`、`runtimeStoryCoordinator.ts` 的 runtime story 内部职责。
+3. 没有修改后端 `storyActionService.ts`、`runtimeSession.ts` 或任何路由组织。
+4. 没有修改平台入口/世界详情/选角页面的视觉结构、按钮位置、tab 组织和独立面板交互方式。
+
+## 4. 验证与检查
+
+本轮应执行并记录：
+
+1. `npm run check:encoding`
+2. `npx vitest run src/hooks/runtimeAuthGuards.test.tsx src/hooks/useGameFlow.customWorld.test.tsx src/services/rpg-entry/rpgProfileClient.test.ts src/services/rpg-runtime/rpgSnapshotClient.test.ts src/services/storageService.test.ts`
+
+重点核查点：
+
+1. 主入口是否已经切到 `useRpgRuntimeSession`。
+2. `useGameFlow.ts`、`useGamePersistence.ts`、`useGameShellRuntime.ts` 是否只剩兼容导出。
+3. `storageService.ts` 是否已不再承载 snapshot / save archive 的真实实现。
+4. 是否没有改动任何前端界面结构与交互表现。
+
+## 5. 对后续工作包的直接收益
+
+1. 工作包 B / D 可以继续消费 `rpg-session` 新域入口，而不必再从旧 `useGame*` 文件接主逻辑。
+2. 工作包 E 可以只关注 runtime story 链，不必再同时承担 session / persistence 主实现迁移。
+3. 后续清理旧命名时，可以直接删除 `useGame*` 兼容层，而不会再触发大规模逻辑回迁。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..df42ce99
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_D_PROGRESS_2026-04-21.md
@@ -0,0 +1,130 @@
+# RPG 进入游戏与运行时链路重构工作包 D 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 D：前端运行态 shell 与面板拆分**，严格遵守以下边界：
+
+1. 把 `GameShellRuntime.tsx`、`GameShellMainContent.tsx`、`GameShellStoryPanels.tsx`、`AdventurePanel.tsx` 的真实实现迁入 `rpg-runtime-shell` 与 `rpg-runtime-panels`。
+2. 旧 `GameShell*` 与 `AdventurePanel` 保留兼容桥接，不在这一轮硬删旧路径。
+3. 不改平台入口链、不改 runtime story 后端协议、不改任何前端交互界面设计。
+4. 冒险主面板只做最小必要的 section 拆分，不额外扩散成更多与工作包 D 无关的重构。
+
+## 2. 本次已落地内容
+
+## 2.1 RPG 运行态 shell 已承接真实实现
+
+以下文件已从 façade 升级为真实实现：
+
+1. `src/components/rpg-runtime-shell/RpgRuntimeShell.tsx`
+2. `src/components/rpg-runtime-shell/RpgRuntimeStageRouter.tsx`
+3. `src/components/rpg-runtime-shell/RpgRuntimeOverlayHost.tsx`
+4. `src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.ts`
+5. `src/components/rpg-runtime-shell/useRpgRuntimeOverlayState.ts`
+6. `src/components/rpg-runtime-shell/types.ts`
+
+本轮完成的真实迁移包括：
+
+1. `App.tsx` 主入口已经改为直接挂载 `RpgRuntimeShell`，不再把旧 `GameShellRuntime` 当作真实主入口。
+2. `RpgRuntimeShell` 已承接运行态总外壳、画布舞台、主阶段路由、overlay host 装配。
+3. `RpgRuntimeStageRouter` 已承接平台入口 / 角色选择 / 冒险运行态三阶段切换。
+4. `RpgRuntimeOverlayHost` 已承接角色面板浮层、背包浮层、冒险实体详情、营地、地图、角色聊天与 NPC 交互弹层。
+5. `useRpgRuntimeShellViewModel` 已承接运行态 overlay 状态、过场可见态、统计数据和 scene transition choice 包装。
+6. `useRpgRuntimeOverlayState` 已把旧 `useGameShellViewModel` 的壳层状态迁入 RPG 域命名。
+
+## 2.2 RPG 主面板路由与冒险主面板已承接真实实现
+
+以下文件已从 façade 升级为真实实现：
+
+1. `src/components/rpg-runtime-panels/RpgRuntimePanelRouter.tsx`
+2. `src/components/rpg-runtime-panels/RpgAdventurePanel.tsx`
+
+本轮完成的真实迁移包括：
+
+1. `RpgRuntimePanelRouter` 已承接冒险 / 角色 / 背包三主标签切换。
+2. `RpgAdventurePanel` 已成为真实冒险主面板实现，不再只是桥接旧 `AdventurePanel`。
+3. 冒险主面板按执行计划要求显式拆成了三个主 section：
+   - story section：剧情展示区与对话流
+   - choice section：按钮区、快捷入口、NPC 输入框
+   - overlay section：任务/设置/统计/奖励等独立面板挂载
+4. 拆分后保持了原有 UI 结构、按钮位置、浮层方式和交互顺序不变。
+5. 同时修正了冒险面板测试里要求隐藏的说明文本，避免迁移后把 `detailText` 重新暴露到 UI 中。
+
+## 2.3 旧热点文件已降级为兼容桥接层
+
+以下旧热点文件已不再承载真实实现，只保留兼容入口：
+
+1. `src/components/game-shell/GameShellRuntime.tsx`
+2. `src/components/game-shell/GameShellMainContent.tsx`
+3. `src/components/game-shell/GameShellStoryPanels.tsx`
+4. `src/components/game-shell/GameShellOverlays.tsx`
+5. `src/components/AdventurePanel.tsx`
+6. `src/components/game-shell/useGameShellRuntimeViewModel.ts`
+7. `src/components/game-shell/useGameShellViewModel.ts`
+8. `src/components/game-shell/types.ts`
+
+当前策略：
+
+1. 旧 `GameShell*` 路径继续可被现有调用与测试引用。
+2. 旧 hook / type 文件继续对外提供兼容别名，避免并行工作流马上失效。
+3. 真实运行态主链已经切到 `rpg-runtime-shell` 与 `rpg-runtime-panels`，旧热点不再继续扩大职责。
+
+## 2.4 为兼容迁移补齐的新类型出口
+
+为了避免本轮迁移造成旧桥接和 barrel 断裂，本轮额外补齐了以下类型出口：
+
+1. `RpgRuntimeShellProps`
+2. `RpgRuntimeShellViewModelResult`
+3. `RpgEntryHomeViewProps`
+4. `RpgEntryWorldDetailViewProps`
+
+这些改动只用于保证工作包 D 新目录可以作为真实调用入口和兼容桥的稳定目标，不属于额外功能开发。
+
+## 3. 本次刻意未做的事
+
+以下内容明确保持到其他工作包，不在本轮越界处理：
+
+1. 没有改平台入口链编排；`rpg-entry` 的真实拆分仍属于工作包 B。
+2. 没有改 session/bootstrap/persistence 语义；这部分仍属于工作包 C。
+3. 没有改 runtime story hooks、NPC 交互主链与后端协议；这部分仍属于工作包 E 及后续后端工作包。
+4. 没有重做 AdventurePanel 内部更细粒度的卡片/子面板组件树，只做执行计划明确要求的三段 section 拆分。
+5. 没有删除旧 `GameShell*` 文件，只把它们降级为兼容桥，避免影响并行工作流。
+6. 没有调整任何用户可见的布局、按钮位置、tab 组织或弹窗/独立面板出现方式。
+
+## 4. 验证结果
+
+本轮已完成以下验证：
+
+1. `npm run check:encoding`
+2. `npx vitest run src/components/AdventurePanel.test.tsx src/components/AdventurePanel.npcChat.test.tsx src/components/game-shell/useGameShellRuntimeViewModel.test.ts src/components/CustomWorldEntityEditorModal.test.tsx`
+3. 针对本工作包改动路径执行 `tsc` 定向筛查
+
+验证结果：
+
+1. 编码检查通过。
+2. 上述 4 组定向测试全部通过。
+3. 针对本轮改动路径的类型筛查无新增报错。
+4. 全量 `tsc` 仍然存在其他工作流文件的并行类型噪音，但未命中本轮工作包 D 改动文件。
+
+## 5. 对工作包 D 完成度的复核
+
+对照执行计划中的工作包 D 目标，本轮已完成：
+
+1. 运行态 shell 的真实迁移。
+2. 主阶段路由器的真实迁移。
+3. 主面板路由器的真实迁移。
+4. 冒险主面板的真实迁移。
+5. 冒险主面板按 section 显式分段。
+6. 旧热点文件降级为兼容桥。
+
+仍刻意保留、但不属于遗漏的部分：
+
+1. 更细粒度的 AdventurePanel 子组件继续保留在单文件内部。
+2. 旧文件兼容导出尚未清理。
+3. 运行态 story hooks / gateway 仍在工作包 E 路径中继续演进。
+4. 本轮复核已补齐一个收口遗漏：`rpg-runtime-shell` / `rpg-runtime-panels` 真实实现所依赖的 story UI 类型，现已直接从 `hooks/rpg-runtime-story` 导入，不再反向依赖旧 `useStoryGeneration.ts` 兼容入口。
+
+结论：
+
+**工作包 D 在“不改 UI、不改后端协议、禁止过度开发”的前提下已经完整落地，当前没有遗漏的必做项。**
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..82eb4b36
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_E_PROGRESS_2026-04-21.md
@@ -0,0 +1,112 @@
+# RPG 进入游戏与运行时链路重构工作包 E 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 E：前端 runtime story 与 NPC 交互链拆分**，严格遵守以下边界：
+
+1. 把前端 runtime story 主链真实迁到 `src/hooks/rpg-runtime-story/` 与 `src/services/rpg-runtime/`。
+2. 把 `useStoryGeneration.ts`、`useStoryRuntimeController.ts`、`useStoryFlowCoordinator.ts`、`useStoryGoalSessionCoordinator.ts`、`useStoryInteractionCoordinator.ts`、`npcEncounterActions.ts`、`runtimeStoryCoordinator.ts`、`runtimeStoryService.ts` 的正式实现从旧命名入口迁出。
+3. 保留旧 `story/*` 与 `runtimeStoryService.ts` 兼容导出，避免误伤其他并行工作包。
+4. 不改任何前端交互界面设计，不改后端动作语义，不新增玩法。
+
+## 2. 本次已落地内容
+
+## 2.1 RPG runtime story 主链真实迁移
+
+已把以下真实实现迁入 RPG 域目录：
+
+1. `src/hooks/rpg-runtime-story/useRpgRuntimeStory.ts`
+2. `src/hooks/rpg-runtime-story/useRpgRuntimeStoryController.ts`
+3. `src/hooks/rpg-runtime-story/useRpgRuntimeStoryFlow.ts`
+4. `src/hooks/rpg-runtime-story/useRpgRuntimeStoryState.ts`
+5. `src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.ts`
+6. `src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts`
+7. `src/hooks/rpg-runtime-story/rpgRuntimeStoryGateway.ts`
+
+本轮完成后：
+
+1. `useRpgRuntimeStory` 已成为前端 runtime story 顶层装配入口，不再只是 façade。
+2. `useRpgRuntimeStoryController` 负责 story 状态、AI 请求与提交动作。
+3. `useRpgRuntimeStoryFlow` 负责 option 展示、交互流和 story/session 状态流收口。
+4. `useRpgRuntimeStoryState` 负责 reset、hydrate、地图跳转与 quest UI 收口。
+5. `useRpgRuntimeInteractionFlow` 负责宝箱、背包、NPC、story choice 正式分发。
+6. `useRpgRuntimeNpcInteraction` 负责 NPC 对话、待接委托、战斗后续对话重开与服务端 NPC 动作派发。
+7. `rpgRuntimeStoryGateway` 负责 option catalog 拉取、继续游戏恢复与服务端 runtime choice 结算。
+
+## 2.2 runtime story client 真实迁移
+
+已把 `/api/runtime/story` 的真实 client 实现迁入：
+
+1. `src/services/rpg-runtime/rpgRuntimeStoryClient.ts`
+
+本轮完成后：
+
+1. `rpgRuntimeStoryClient` 不再桥接旧 `runtimeStoryService.ts`，而是成为真实请求实现。
+2. `runtimeStoryService.ts` 降级为兼容导出层。
+3. `getRpgRuntimeStoryState`、`resolveRpgRuntimeStoryAction`、`resolveRpgRuntimeStoryMoment`、`isRpgRuntimeServerFunctionId`、`shouldUseRpgRuntimeServerOptions` 已成为新域主能力。
+
+## 2.3 主调用链已接回 RPG 域
+
+本轮已把以下主链与 helper 入口切到 RPG 域实现：
+
+1. `src/hooks/rpg-session/useRpgRuntimeSession.ts` 改为直接使用 `useRpgRuntimeStory`
+2. `src/hooks/story/storyRequestCoordinator.ts` 改为消费 `loadRpgRuntimeOptionCatalog` 与 `shouldUseRpgRuntimeServerOptions`
+3. `src/hooks/story/choiceActions.ts` 改为消费 `isRpgRuntimeServerFunctionId`
+4. `src/hooks/story/storyChoiceRuntime.ts` 改为消费 `resolveRpgRuntimeChoice`
+5. `src/hooks/story/inventoryActions.ts` 改为消费 `resolveRpgRuntimeChoice`
+6. `src/hooks/story/npcInteraction.ts` 改为消费 `resolveRpgRuntimeChoice`
+7. `src/hooks/useTreasureFlow.ts` 改为消费 `resolveRpgRuntimeChoice`
+
+这意味着工作包 E 范围内的前端 runtime story 正式结算主链，已经不再依赖旧 `runtimeStoryService.ts` 与旧 `runtimeStoryCoordinator.ts` 的真实实现。
+
+## 2.4 兼容层处理
+
+以下旧文件现已降级为兼容导出，不再承载正式实现：
+
+1. `src/hooks/useStoryGeneration.ts`
+2. `src/hooks/story/useStoryRuntimeController.ts`
+3. `src/hooks/story/useStoryFlowCoordinator.ts`
+4. `src/hooks/story/useStoryGoalSessionCoordinator.ts`
+5. `src/hooks/story/useStoryInteractionCoordinator.ts`
+6. `src/hooks/story/npcEncounterActions.ts`
+7. `src/hooks/story/runtimeStoryCoordinator.ts`
+8. `src/services/runtimeStoryService.ts`
+
+保留这些兼容层的原因：
+
+1. 避免一次性改动所有 UI 与测试引用，降低并行工作冲突。
+2. 让工作包 D、C 仍能通过旧导入继续编译，再逐步切到新域命名。
+3. 明确“主实现已迁移、旧入口只兼容”的工程状态，避免后续继续扩大旧热点文件。
+4. 复核时已补齐一批主链收口点：`RpgRuntimeStageRouter`、`RpgRuntimeOverlayHost`、`RpgRuntimePanelRouter`、`RpgAdventurePanel` 及其直连组件的 story UI 类型导入，现已直接消费 `hooks/rpg-runtime-story` 新域出口，旧 `useStoryGeneration.ts` 仅保留兼容角色。
+
+## 3. 本次没有做的事
+
+以下内容仍保持原状，留给其他工作包：
+
+1. 没有修改 `AdventurePanel.tsx`、`GameShellMainContent.tsx`、`GameShellStoryPanels.tsx` 的 UI 结构。
+2. 没有重做任何对话区、奖励区、输入区、overlay 的交互形式。
+3. 没有修改后端 runtime story route / service / compiler 语义。
+4. 没有清理所有旧 UI 组件对 `useStoryGeneration.ts` 的类型导入，本轮只保证旧入口已退化为兼容层。
+5. 没有删除旧兼容文件，避免误伤其他并行中的工作包。
+
+## 4. 验证结果
+
+本轮已执行：
+
+1. `npm run check:encoding`
+2. `npx vitest run src/services/runtimeStoryService.test.ts src/hooks/story/runtimeStoryCoordinator.test.ts src/hooks/story/storyRequestCoordinator.test.ts src/hooks/story/choiceActions.test.ts src/hooks/story/storyChoiceRuntime.test.ts src/hooks/story/npcEncounterActions.test.ts`
+
+验证结果：
+
+1. 编码检查通过。
+2. 工作包 E 直接相关的 6 个测试文件、44 条测试全部通过。
+3. 运行时 option catalog、runtime choice、NPC 交互、待接委托、背包动作与本地/服务端分流逻辑均完成回归。
+4. 复核补跑 `src/services/rpg-entry/rpgProfileClient.test.ts`、`src/services/rpg-runtime/rpgSnapshotClient.test.ts`、`src/services/runtimeStoryService.test.ts`、`src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx` 共 33 条定向测试，全部通过。
+
+## 5. 对后续工作包的直接收益
+
+1. 工作包 D 后续如果继续拆 runtime panel 与 adventure panel，可以直接消费 `useRpgRuntimeStory` 与 `rpg-runtime-story` 域类型，不必再穿旧 `story` 目录。
+2. 工作包 C 与 session/persistence 链路已经可以直接对接 `rpgRuntimeStoryGateway` 的继续游戏恢复能力。
+3. 后续如果要清理旧 `useStoryGeneration.ts`、`runtimeStoryService.ts` 等旧命名入口，已经具备“新主链真实可用”的前提，不再是 façade 空壳状态。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..ffd38ed4
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_F_PROGRESS_2026-04-21.md
@@ -0,0 +1,121 @@
+# RPG 进入游戏与运行时链路重构工作包 F 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 F：后端 route 边界拆分**，严格遵守以下边界：
+
+1. 只调整后端路由组织、挂载边界与兼容 façade。
+2. 不重写下游 `service` / `repository` 业务语义。
+3. 不修改任何前端交互界面设计，不额外推进工作包 G/H。
+
+## 2. 本次已落地内容
+
+## 2.1 `app.ts` 显式挂载 RPG 域路由
+
+已把 `server-node/src/app.ts` 中的 RPG 相关入口改成显式按域挂载：
+
+1. `rpgProfile`：资料看板、浏览历史、设置
+2. `rpgEntrySave`：快照读写、继续游戏归档列表与恢复
+3. `rpgWorldLibrary`：作品库、作品广场、works 列表
+4. `rpgRuntimeStory`：`/api/runtime/story` 状态读取与动作结算
+5. `rpgRuntimeAiAssist`：runtime story 之外的 AI 辅助接口
+
+当前策略：
+
+1. 使用 `scopeToPrefixes(...)` 只匹配各自域前缀，避免新路由误拦截无关 `/api` 请求。
+2. 所有线上接口路径保持不变，仍兼容现有前端与测试调用。
+3. `routeVersion` 对新域挂载统一标记为 `2026-04-21`，与本轮路由重构窗口对齐。
+
+## 2.2 新 `rpg-*` 路由从骨架升级为真实实现
+
+已把以下骨架路由补成真实入口：
+
+1. `server-node/src/routes/rpg-profile/rpgProfileRoutes.ts`
+2. `server-node/src/routes/rpg-entry/rpgEntrySaveRoutes.ts`
+3. `server-node/src/routes/rpg-entry/rpgWorldLibraryRoutes.ts`
+4. `server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts`
+5. `server-node/src/routes/rpg-runtime/rpgRuntimeAiAssistRoutes.ts`
+
+本轮真实迁入的新边界包括：
+
+1. `rpgProfileRoutes.ts`
+   - `/api/runtime/profile/dashboard`
+   - `/api/runtime/profile/wallet-ledger`
+   - `/api/runtime/profile/play-stats`
+   - `/api/runtime/profile/browse-history`
+   - 兼容路径 `/api/profile/...`
+   - `/api/runtime/settings`
+2. `rpgEntrySaveRoutes.ts`
+   - `/api/runtime/save/snapshot`
+   - `/api/runtime/profile/save-archives`
+   - 兼容路径 `/api/profile/save-archives`
+3. `rpgWorldLibraryRoutes.ts`
+   - `/api/runtime/custom-world-gallery`
+   - `/api/runtime/custom-world/works`
+   - `/api/runtime/custom-world-library`
+   - publish / unpublish / soft delete 等库操作
+4. `rpgRuntimeStoryRoutes.ts`
+   - `/api/runtime/story/actions/resolve`
+   - `/api/runtime/story/state/:sessionId`
+   - `/api/runtime/story/state/resolve`
+5. `rpgRuntimeAiAssistRoutes.ts`
+   - runtime story 之外的 LLM proxy、cover/scene 资产、custom world profile 生成、角色/NPC chat、runtime item、quest 生成、`/api/ws/health`
+
+## 2.3 旧大路由退化为兼容 façade
+
+已把旧入口降级为兼容层：
+
+1. `server-node/src/modules/story/storyActionRoutes.ts`
+   - 不再自己承载 schema 与 handler
+   - 直接桥接到 `createRpgRuntimeStoryRoutes(context)`
+2. `server-node/src/routes/runtimeRoutes.ts`
+   - 不再继续承载 profile / save / world library / runtime ai assist / runtime story
+   - 当前只保留旧 `customWorldAgent` 挂载与兼容 `ws/health`
+
+这样处理后：
+
+1. `runtimeRoutes.ts` 不再是 RPG 主链真实入口。
+2. `storyActionRoutes.ts` 不再是 runtime story 主链真实实现。
+3. 后续工作包 G/H 可以基于新 `rpg-*` 路由继续细化，而不用再穿透旧大文件。
+
+## 3. 本次没有做的事
+
+以下内容仍保持原状，不属于工作包 F 本轮范围：
+
+1. 没有拆 `storyActionService.ts`、`runtimeSession.ts` 的内部职责。
+2. 没有继续改 `npcInteractionService.ts`、`questStoryActionService.ts` 的业务实现。
+3. 没有推进仓储、共享契约的进一步物理拆分。
+4. 没有改变任何前端页面结构、交互路径、面板形式或 UI 文案。
+
+## 4. 验证结果
+
+本次已执行：
+
+1. `npm run check:encoding`
+2. `node --test --test-concurrency=1 --import tsx "src/routes/rpgRouteBoundaries.test.ts"`
+
+验证结果：
+
+1. 编码检查通过。
+2. 新增定向测试 `server-node/src/routes/rpgRouteBoundaries.test.ts` 4 项全部通过。
+3. 已覆盖以下工作包 F 验收重点：
+   - `rpgProfile` 新路径与 legacy 路径兼容
+   - `rpgEntrySave` 快照/归档路由可用
+   - `rpgWorldLibrary` / `gallery` / `works` 新边界可用
+   - `rpgRuntimeStory` 新边界与旧 façade 兼容可用
+
+同时确认：
+
+1. 全量 `npx tsc -p server-node/tsconfig.json --noEmit` 仍被仓库中既有跨模块类型问题阻塞。
+2. 这些错误覆盖 auth、inventory、custom world、scene image 等多个既有热点，与本次工作包 F 新增路由边界并非同一问题面。
+
+## 5. 对执行计划的对齐结论
+
+对照执行计划中的工作包 F：
+
+1. `app.ts` 已能一眼看出 `rpgProfile`、`rpgEntry`、`rpgRuntimeStory`、`rpgRuntimeAiAssist` 的挂载边界。
+2. `runtimeRoutes.ts` 已退化为兼容入口，不再承接 RPG 主链的大杂糅职责。
+3. `storyActionRoutes.ts` 已退化为兼容 façade，真实 runtime story 路由落点转入 `server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts`。
+4. 本轮没有越过工作包 F 去重写下游 service 语义，满足“禁止过度开发”的约束。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..fd25b44a
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_G_PROGRESS_2026-04-21.md
@@ -0,0 +1,96 @@
+# RPG 进入游戏与运行时链路重构工作包 G 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 G：后端 runtime session / action service 拆分**，严格遵守以下边界：
+
+1. 把 `storyActionService.ts` 与 `runtimeSession.ts` 的真实实现迁入 `server-node/src/modules/rpg-runtime-story/` 新域目录。
+2. 把 runtime action 主链依赖的 session 原语、option 编译、snapshot sync、story state 读取按职责落到新文件。
+3. 旧 `server-node/src/modules/story/` 热点文件只保留兼容导出，不再承载真实实现。
+4. 不改前端入口与 UI，不改路由协议语义，不做仓储拆分。
+
+## 2. 本次已落地内容
+
+## 2.1 `runtimeSession.ts` 真实实现已迁入 `rpg-runtime-story`
+
+本轮已把旧 `server-node/src/modules/story/runtimeSession.ts` 的真实实现迁入：
+
+1. `server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionDomain.ts`
+2. `server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionLoader.ts`
+3. `server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionPrimitives.ts`
+4. `server-node/src/modules/rpg-runtime-story/RpgRuntimeOptionCompiler.ts`
+5. `server-node/src/modules/rpg-runtime-story/RpgRuntimeSnapshotSync.ts`
+6. `server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryPresentationCompiler.ts`
+
+落地结果：
+
+1. `loadRuntimeSession(...)`、`buildAvailableOptions(...)`、`buildRuntimeViewModel(...)`、`syncRawGameState(...)`、`replaceRuntimeSessionRawGameState(...)` 已有新域真实落点。
+2. `appendStoryHistory(...)`、`getEncounterNpcState(...)`、`setEncounterNpcState(...)`、`MAX_TASK5_COMPANIONS`、`TASK6_DEFERRED_FUNCTION_IDS` 等运行时原语已通过 `RpgRuntimeSessionPrimitives.ts` 对外输出。
+3. 旧 `server-node/src/modules/story/runtimeSession.ts` 已退化为兼容层，不再承载主实现。
+
+## 2.2 `storyActionService.ts` 真实实现已迁入 `rpg-runtime-story`
+
+本轮已把旧 `server-node/src/modules/story/storyActionService.ts` 的真实实现迁入：
+
+1. `server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionDomain.ts`
+2. `server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionService.ts`
+3. `server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryStateService.ts`
+
+落地结果：
+
+1. `resolveRuntimeStoryAction(...)` 已从新域动作服务入口导出。
+2. `getRuntimeStoryState(...)` 已从新域状态服务入口导出。
+3. 旧 `server-node/src/modules/story/storyActionService.ts` 已退化为兼容转发层。
+
+## 2.3 runtime action 主链下游依赖已切到新域
+
+本轮已把以下直接依赖 `runtimeSession.ts` 的后端模块切到 `rpg-runtime-story` 新域入口：
+
+1. `server-node/src/modules/combat/combatResolutionService.ts`
+2. `server-node/src/modules/npc/npcInteractionService.ts`
+3. `server-node/src/modules/inventory/inventoryStoryActionService.ts`
+4. `server-node/src/modules/inventory/npcInventoryStoryActionService.ts`
+5. `server-node/src/modules/quest/questRuntimeSignalService.ts`
+6. `server-node/src/modules/quest/questStoryActionService.ts`
+7. `server-node/src/modules/runtime-item/treasureStoryActionService.ts`
+8. `server-node/src/modules/story/storyActionRoutes.ts`
+9. `server-node/src/modules/story/runtimeSession.test.ts`
+
+当前状态：
+
+1. runtime action 执行链已经直接消费 `rpg-runtime-story` 域入口，不再把旧 `modules/story/` 视为真实主实现。
+2. `storyActionRoutes.ts` 已直接从新域读取动作服务与状态服务。
+3. `runtimeSession.test.ts` 已直接验证新域编译链与 legacy currentStory 展示投影。
+
+## 3. 本次没有做的事
+
+以下内容仍保持原状，留给后续工作包或后续阶段：
+
+1. 没有修改任何前端入口、前端运行态 UI、前端交互设计。
+2. 没有拆 `server-node/src/routes/runtimeRoutes.ts`、`server-node/src/app.ts` 的路由挂载组织，这属于工作包 F。
+3. 没有拆 `runtimeRepository.ts`、`runtimeSnapshotHydration.ts` 与 shared contract，这属于工作包 H。
+4. 没有把 `RpgRuntimeStoryActionDomain.ts` 再继续切成更细颗粒度的真实实现文件；本轮只做到工作包 G 要求的“目录化拆开 + 旧热点降级”。
+5. 没有改动任何动作语义、返回协议或 LLM 编排行为。
+
+## 4. 验证与检查
+
+本轮已执行：
+
+1. `npm run check:encoding`
+2. `npx tsx --test server-node/src/modules/story/runtimeSession.test.ts server-node/src/modules/story/storyActionRoutes.test.ts`
+3. `npm --prefix server-node run build`
+
+验证结果：
+
+1. 编码检查通过。
+2. 与 runtime session / runtime story action 直接相关的后端定向测试 `20` 项全部通过。
+3. `server-node` 构建通过。
+4. 旧 `server-node/src/modules/story/runtimeSession.ts` 与 `server-node/src/modules/story/storyActionService.ts` 已只剩兼容导出，没有残留真实主实现。
+
+## 5. 对后续工作的直接收益
+
+1. 工作包 F 后续继续做 route 边界拆分时，可以直接把 runtime story 路由稳定挂到 `rpg-runtime-story` 新域入口。
+2. 工作包 H 后续拆仓储、shared contract 和测试基建时，可以围绕 `rpg-runtime-story` 新目录继续收口，而不必再穿透旧热点文件。
+3. 后续如果继续细拆 runtime story 主链，可以在新域内部继续物理拆分，而不会重新把真实实现塞回 `modules/story/`。
diff --git a/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md
new file mode 100644
index 00000000..cc8f51fb
--- /dev/null
+++ b/docs/technical/RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_WORK_PACKAGE_H_PROGRESS_2026-04-21.md
@@ -0,0 +1,90 @@
+# RPG 进入游戏与运行时链路重构工作包 H 落地记录
+
+更新时间：`2026-04-21`
+
+## 1. 本次目标
+
+本次只落实 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中的 **工作包 H：仓储、契约与测试基建**，严格遵守以下边界：
+
+1. 只补仓储、shared contract、fixture 与测试基建。
+2. 不修改前端 UI，不改页面交互设计。
+3. 不重写 route 层与 runtime story 主流程逻辑。
+
+## 2. 本次已落地内容
+
+## 2.1 仓储按 RPG 域补齐独立入口
+
+本次补齐并收口了工作包 H 目标中的按域仓储入口：
+
+1. `server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.ts`
+2. `server-node/src/repositories/rpg-entry/RpgSaveArchiveRepository.ts`
+3. `server-node/src/repositories/rpg-entry/RpgWorldLibraryRepository.ts`
+4. `server-node/src/repositories/rpg-profile/RpgProfileDashboardRepository.ts`
+5. `server-node/src/repositories/rpg-profile/RpgBrowseHistoryRepository.ts`
+
+本轮策略仍保持最小侵入：
+
+1. 新仓储继续委托 `runtimeRepository.ts` 提供真实读写。
+2. `RpgProfileDashboardRepository` 只保留资料看板、设置、钱包、游玩统计职责。
+3. 浏览历史读写从资料仓储中抽离到 `RpgBrowseHistoryRepository`，与执行方案的目标拆分保持一致。
+
+## 2.2 shared runtime contract 按领域拆分并保留兼容 façade
+
+已把原 `packages/shared/src/contracts/story.ts` 中的 RPG runtime shared contract 拆分为：
+
+1. `packages/shared/src/contracts/rpgRuntimeStoryAction.ts`
+2. `packages/shared/src/contracts/rpgRuntimeStoryState.ts`
+3. `packages/shared/src/contracts/rpgRuntimeChat.ts`
+4. `packages/shared/src/contracts/rpgRuntimeQuestAssist.ts`
+
+兼容策略：
+
+1. `story.ts` 退化为 façade，只做分文件 re-export。
+2. 现有前后端调用方仍可继续从 `contracts/story` 取用类型与常量，不要求本轮同步迁移所有 import。
+3. runtime story 主链契约与 chat / quest assist / runtime item 辅助契约已经具备独立演进落点。
+
+## 2.3 测试基建补齐
+
+本次补充并核对了工作包 H 范围内的测试：
+
+1. `server-node/src/modules/runtime/runtimeSnapshotHydration.test.ts`
+   用于覆盖 snapshot 归一化、恢复继续游戏时的默认值修复与旧存档兼容。
+2. `server-node/src/repositories/rpg-profile/RpgProfileRepositories.test.ts`
+   用于确认资料看板仓储与浏览历史仓储的职责边界已经分离。
+3. `server-node/src/repositories/rpg-entry/RpgEntryRepositories.test.ts`
+   用于确认 continue game 归档仓储与作品库仓储已经独立命名并保持职责边界。
+4. `server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.test.ts`
+   用于确认 snapshot 读写职责已经有独立仓储入口。
+5. `packages/shared/src/contracts/rpgRuntimeContracts.test.ts`
+   用于确认 `story.ts` façade 在拆分后仍保持旧入口兼容。
+
+## 3. 本次没有做的事
+
+以下内容仍保持原状，留给其他工作包或第三批统一收口：
+
+1. 没有把前后端所有 `contracts/story` import 全量改写到新分文件，避免与并行工作包产生无谓冲突。
+2. 没有改 `server-node/src/routes/runtimeRoutes.ts`、`server-node/src/modules/story/storyActionService.ts`、`server-node/src/modules/story/runtimeSession.ts` 的真实逻辑。
+3. 没有改前端 continue game、角色选择、冒险运行态的界面与交互。
+
+## 4. 验证结果
+
+本轮执行并通过：
+
+1. `npm run check:encoding`
+2. `npx vitest run packages/shared/src/contracts/rpgRuntimeContracts.test.ts`
+3. `node --test --test-concurrency=1 --import tsx src/modules/runtime/runtimeSnapshotHydration.test.ts src/repositories/rpg-profile/RpgProfileRepositories.test.ts src/repositories/rpg-entry/RpgEntryRepositories.test.ts src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.test.ts`
+
+说明：
+
+1. 工作树当前存在其他并行修改与冲突文件，因此没有把与工作包 H 无关的全量问题一并处理。
+2. 本轮验证只覆盖工作包 H 自身改动与其直接依赖，避免过度开发。
+
+## 5. 与执行方案的对照结论
+
+对照 `RPG_ENTRY_RUNTIME_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md` 中工作包 H 的目标，本轮已完成：
+
+1. snapshot / profile / library / browse history 仓储独立命名入口补齐。
+2. `story.ts` shared contract 已拆为 runtime story action、runtime story state、runtime chat、runtime quest assist 四个独立文件。
+3. runtime story / snapshot / continue game 相关测试已补齐到可直接回归的最小闭环。
+
+当前未额外扩张到主流程迁移、route 改写、UI 调整，符合“禁止过度开发”的执行要求。
diff --git a/packages/shared/src/contracts/customWorldAgent.ts b/packages/shared/src/contracts/customWorldAgent.ts
index 4be16d88..e5d115e0 100644
--- a/packages/shared/src/contracts/customWorldAgent.ts
+++ b/packages/shared/src/contracts/customWorldAgent.ts
@@ -1,538 +1,12 @@
-export type CustomWorldWorkStatus = 'draft' | 'published';
-export type CustomWorldWorkSource = 'agent_session' | 'published_profile';
+/**
+ * 兼容出口：
+ * 当前仓库仍有大量旧 customWorld 命名导入，这个文件继续作为过渡层保留。
+ * 工作包 H 完成后，真实类型定义已经迁移到 rpg* 契约文件中；这里仅聚合旧命名分文件。
+ */
 
-export interface WorldPromiseValue {
-  hook: string;
-  differentiator: string;
-  desiredExperience: string;
-}
-
-export interface PlayerFantasyValue {
-  playerRole: string;
-  corePursuit: string;
-  fearOfLoss: string;
-}
-
-export interface ThemeBoundaryValue {
-  toneKeywords: string[];
-  aestheticDirectives: string[];
-  forbiddenDirectives: string[];
-}
-
-export interface PlayerEntryPointValue {
-  openingIdentity: string;
-  openingProblem: string;
-  entryMotivation: string;
-}
-
-export interface CoreConflictValue {
-  surfaceConflicts: string[];
-  hiddenCrisis: string;
-  firstTouchedConflict: string;
-}
-
-export interface KeyRelationshipValue {
-  pairs: string;
-  relationshipType: string;
-  secretOrCost: string;
-}
-
-export interface HiddenLineValue {
-  hiddenTruths: string[];
-  misdirectionHints: string[];
-  revealPacing: string;
-}
-
-export interface IconicElementValue {
-  iconicMotifs: string[];
-  institutionsOrArtifacts: string[];
-  hardRules: string[];
-}
-
-export interface EightAnchorContent {
-  worldPromise: WorldPromiseValue | null;
-  playerFantasy: PlayerFantasyValue | null;
-  themeBoundary: ThemeBoundaryValue | null;
-  playerEntryPoint: PlayerEntryPointValue | null;
-  coreConflict: CoreConflictValue | null;
-  keyRelationships: KeyRelationshipValue[];
-  hiddenLines: HiddenLineValue | null;
-  iconicElements: IconicElementValue | null;
-}
-
-export interface CustomWorldWorkSummary {
-  workId: string;
-  sourceType: CustomWorldWorkSource;
-  status: CustomWorldWorkStatus;
-  title: string;
-  subtitle: string;
-  summary: string;
-  coverImageSrc?: string | null;
-  coverRenderMode?: 'image' | 'scene_with_roles';
-  coverCharacterImageSrcs?: string[];
-  updatedAt: string;
-  publishedAt?: string | null;
-  stage?: string | null;
-  stageLabel?: string | null;
-  playableNpcCount: number;
-  landmarkCount: number;
-  roleVisualReadyCount?: number;
-  roleAnimationReadyCount?: number;
-  roleAssetSummaryLabel?: string | null;
-  sessionId?: string | null;
-  profileId?: string | null;
-  canResume: boolean;
-  canEnterWorld: boolean;
-}
-
-export interface CreatorIntentReadiness {
-  isReady: boolean;
-  completedKeys: string[];
-  missingKeys: string[];
-}
-
-export interface CustomWorldPendingClarification {
-  id: string;
-  label: string;
-  question: string;
-  targetKey:
-    | 'world_hook'
-    | 'player_premise'
-    | 'theme_and_tone'
-    | 'core_conflict'
-    | 'relationship_seed'
-    | 'iconic_element';
-  priority: number;
-  answer?: string;
-}
-
-export type CustomWorldAgentStage =
-  | 'collecting_intent'
-  | 'clarifying'
-  | 'foundation_review'
-  | 'object_refining'
-  | 'visual_refining'
-  | 'long_tail_review'
-  | 'ready_to_publish'
-  | 'published'
-  | 'error';
-
-export type CustomWorldAgentMessageRole = 'user' | 'assistant' | 'system';
-
-export type CustomWorldAgentMessageKind =
-  | 'chat'
-  | 'clarification'
-  | 'summary'
-  | 'checkpoint'
-  | 'warning'
-  | 'action_result';
-
-export interface CustomWorldAgentMessage {
-  id: string;
-  role: CustomWorldAgentMessageRole;
-  kind: CustomWorldAgentMessageKind;
-  text: string;
-  createdAt: string;
-  relatedOperationId?: string | null;
-}
-
-export type CustomWorldDraftCardKind =
-  | 'world'
-  | 'camp'
-  | 'faction'
-  | 'character'
-  | 'landmark'
-  | 'thread'
-  | 'chapter'
-  | 'scene_chapter'
-  | 'carrier'
-  | 'sidequest_seed';
-
-export type CustomWorldDraftCardStatus =
-  | 'suggested'
-  | 'confirmed'
-  | 'locked'
-  | 'warning';
-
-export interface CustomWorldDraftCardSummary {
-  id: string;
-  kind: CustomWorldDraftCardKind;
-  title: string;
-  subtitle: string;
-  summary: string;
-  status: CustomWorldDraftCardStatus;
-  linkedIds: string[];
-  warningCount: number;
-  assetStatus?: CustomWorldRoleAssetStatus | null;
-  assetStatusLabel?: string | null;
-}
-
-export interface CustomWorldDraftCardDetailSection {
-  id: string;
-  label: string;
-  value: string;
-}
-
-export interface CustomWorldFoundationDraftFaction {
-  id: string;
-  name: string;
-  title?: string;
-  subtitle?: string;
-  publicGoal: string;
-  relatedConflict: string;
-  tension?: string;
-  playerRelation: string;
-  summary: string;
-}
-
-export interface CustomWorldFoundationDraftCharacter {
-  id: string;
-  name: string;
-  title: string;
-  role: string;
-  publicIdentity: string;
-  publicMask?: string;
-  currentPressure: string;
-  hiddenHook?: string;
-  relationToPlayer: string;
-  threadIds: string[];
-  summary: string;
-  skills?: Array<{
-    id: string;
-    name: string;
-    actionPreviewConfig?: Record<string, unknown> | null;
-  }>;
-  imageSrc?: string | null;
-  generatedVisualAssetId?: string | null;
-  generatedAnimationSetId?: string | null;
-  animationMap?: Record<string, unknown> | null;
-}
-
-export interface CustomWorldFoundationDraftLandmark {
-  id: string;
-  name: string;
-  description?: string;
-  purpose: string;
-  mood: string;
-  importance: string;
-  secret?: string;
-  dangerLevel?: string;
-  imageSrc?: string | null;
-  characterIds: string[];
-  threadIds: string[];
-  summary: string;
-}
-
-export interface CustomWorldFoundationDraftThread {
-  id: string;
-  title: string;
-  type: 'main' | 'hidden';
-  conflictType?: string;
-  conflict: string;
-  stakes?: string;
-  characterIds: string[];
-  landmarkIds: string[];
-  summary: string;
-}
-
-export interface CustomWorldFoundationDraftChapter {
-  id: string;
-  title: string;
-  openingEvent: string;
-  playerGoal: string;
-  characterIds: string[];
-  landmarkIds: string[];
-  understandingShift: string;
-  summary: string;
-}
-
-export interface CustomWorldFoundationDraftCamp {
-  id: string;
-  name: string;
-  description: string;
-  mood: string;
-  dangerLevel?: string;
-  imageSrc?: string | null;
-  summary: string;
-}
-
-export type CustomWorldSceneActStage =
-  | 'opening'
-  | 'expansion'
-  | 'turning_point'
-  | 'climax'
-  | 'aftermath';
-
-export type CustomWorldSceneActAdvanceRule =
-  | 'after_primary_contact'
-  | 'after_active_step_complete'
-  | 'after_chapter_resolution';
-
-export interface CustomWorldFoundationDraftSceneAct {
-  id: string;
-  title: string;
-  summary: string;
-  stageCoverage: CustomWorldSceneActStage[];
-  backgroundImageSrc?: string | null;
-  backgroundAssetId?: string | null;
-  encounterNpcIds: string[];
-  primaryNpcId: string;
-  linkedThreadIds: string[];
-  actGoal: string;
-  transitionHook: string;
-  advanceRule: CustomWorldSceneActAdvanceRule;
-}
-
-export interface CustomWorldFoundationDraftSceneChapter {
-  id: string;
-  sceneId: string;
-  sceneName: string;
-  title: string;
-  summary: string;
-  linkedThreadIds: string[];
-  linkedLandmarkIds: string[];
-  acts: CustomWorldFoundationDraftSceneAct[];
-}
-
-export interface CustomWorldFoundationDraftProfile {
-  name: string;
-  subtitle: string;
-  summary: string;
-  tone: string;
-  playerGoal: string;
-  majorFactions: string[];
-  coreConflicts: string[];
-  playableNpcs: CustomWorldFoundationDraftCharacter[];
-  storyNpcs: CustomWorldFoundationDraftCharacter[];
-  landmarks: CustomWorldFoundationDraftLandmark[];
-  camp?: CustomWorldFoundationDraftCamp | null;
-  themePack?: Record<string, unknown> | null;
-  storyGraph?: Record<string, unknown> | null;
-  factions: CustomWorldFoundationDraftFaction[];
-  threads: CustomWorldFoundationDraftThread[];
-  chapters: CustomWorldFoundationDraftChapter[];
-  sceneChapters: CustomWorldFoundationDraftSceneChapter[];
-  worldHook: string;
-  playerPremise: string;
-  openingSituation: string;
-  iconicElements: string[];
-  sourceAnchorSummary: string;
-}
-
-export interface CustomWorldFoundationDraftResult {
-  draftProfile: CustomWorldFoundationDraftProfile;
-  draftCards: CustomWorldDraftCardSummary[];
-}
-
-export interface CustomWorldDraftCardDetail {
-  id: string;
-  kind: CustomWorldDraftCardKind;
-  title: string;
-  sections: CustomWorldDraftCardDetailSection[];
-  linkedIds: string[];
-  locked: false;
-  editable: boolean;
-  editableSectionIds: string[];
-  warningMessages: string[];
-  assetStatus?: CustomWorldRoleAssetStatus | null;
-  assetStatusLabel?: string | null;
-}
-
-export interface CustomWorldSuggestedAction {
-  id: string;
-  type:
-    | 'request_summary'
-    | 'draft_foundation'
-    | 'refine_focus_target'
-    | 'lock_current_target'
-    | 'generate_role_assets'
-    | 'generate_scene_assets'
-    | 'expand_long_tail'
-    | 'publish_world';
-  label: string;
-  targetId?: string | null;
-}
-
-export type CustomWorldAssetPriorityTier = 'hero' | 'featured' | 'supporting';
-
-export type CustomWorldRoleAssetStatus =
-  | 'missing'
-  | 'visual_ready'
-  | 'animations_ready'
-  | 'complete';
-
-export interface CustomWorldRoleAssetSummary {
-  roleId: string;
-  roleName: string;
-  roleKind: 'playable' | 'story';
-  priorityTier: CustomWorldAssetPriorityTier;
-  portraitPath?: string | null;
-  generatedVisualAssetId?: string | null;
-  generatedAnimationSetId?: string | null;
-  status: CustomWorldRoleAssetStatus;
-  missingAnimations: string[];
-  nextPointCost: number;
-}
-
-export interface CustomWorldSceneAssetSummary {
-  sceneId: string;
-  sceneName: string;
-  actId?: string | null;
-  actTitle?: string | null;
-  imageSrc?: string | null;
-  assetId?: string | null;
-  status: 'missing' | 'ready';
-  nextPointCost: number;
-}
-
-export interface CustomWorldAssetCoverageSummary {
-  roleAssets: CustomWorldRoleAssetSummary[];
-  sceneAssets: CustomWorldSceneAssetSummary[];
-  allRoleAssetsReady: boolean;
-  allSceneAssetsReady: boolean;
-}
-
-export interface CustomWorldAgentSessionSnapshot {
-  sessionId: string;
-  currentTurn: number;
-  anchorContent: EightAnchorContent;
-  progressPercent: number;
-  lastAssistantReply: string | null;
-  stage: CustomWorldAgentStage;
-  focusCardId: string | null;
-  creatorIntent: Record<string, unknown> | null;
-  creatorIntentReadiness: CreatorIntentReadiness;
-  anchorPack: Record<string, unknown> | null;
-  lockState: Record<string, unknown> | null;
-  draftProfile: Record<string, unknown> | null;
-  messages: CustomWorldAgentMessage[];
-  draftCards: CustomWorldDraftCardSummary[];
-  pendingClarifications: CustomWorldPendingClarification[];
-  suggestedActions: CustomWorldSuggestedAction[];
-  recommendedReplies: string[];
-  qualityFindings: {
-    id: string;
-    severity: 'info' | 'warning' | 'blocker';
-    code: string;
-    targetId?: string | null;
-    message: string;
-  }[];
-  assetCoverage: CustomWorldAssetCoverageSummary;
-  updatedAt: string;
-}
-
-export type CustomWorldAgentOperationType =
-  | 'process_message'
-  | 'lock_cards'
-  | 'unlock_cards'
-  | 'regenerate_scope'
-  | 'draft_foundation'
-  | 'update_draft_card'
-  | 'sync_result_profile'
-  | 'generate_characters'
-  | 'generate_landmarks'
-  | 'generate_role_assets'
-  | 'sync_role_assets'
-  | 'generate_scene_assets'
-  | 'sync_scene_assets'
-  | 'expand_long_tail'
-  | 'publish_world'
-  | 'revert_checkpoint';
-
-export type CustomWorldAgentOperationStatus =
-  | 'queued'
-  | 'running'
-  | 'completed'
-  | 'failed';
-
-export interface CustomWorldAgentOperationRecord {
-  operationId: string;
-  type: CustomWorldAgentOperationType;
-  status: CustomWorldAgentOperationStatus;
-  phaseLabel: string;
-  phaseDetail: string;
-  progress: number;
-  error?: string | null;
-}
-
-export interface CreateCustomWorldAgentSessionRequest {
-  seedText?: string;
-}
-
-export interface CreateCustomWorldAgentSessionResponse {
-  session: CustomWorldAgentSessionSnapshot;
-}
-
-export interface SendCustomWorldAgentMessageRequest {
-  clientMessageId: string;
-  text: string;
-  quickFillRequested?: boolean;
-  focusCardId?: string | null;
-  selectedCardIds?: string[];
-}
-
-export interface SendCustomWorldAgentMessageResponse {
-  operation: CustomWorldAgentOperationRecord;
-}
-
-export type CustomWorldAgentActionRequest =
-  | { action: 'lock_cards'; cardIds: string[] }
-  | { action: 'unlock_cards'; cardIds: string[] }
-  | {
-      action: 'regenerate_scope';
-      scope:
-        | 'focus_card'
-        | 'long_tail_npcs'
-        | 'long_tail_landmarks'
-        | 'sidequest_seeds'
-        | 'role_assets'
-        | 'scene_assets';
-      targetCardId?: string | null;
-    }
-  | { action: 'draft_foundation' }
-  | {
-      action: 'update_draft_card';
-      cardId: string;
-      sections: Array<{
-        sectionId: string;
-        value: string;
-      }>;
-    }
-  | {
-      action: 'sync_result_profile';
-      profile: Record<string, unknown>;
-    }
-  | {
-      action: 'generate_characters';
-      count: number;
-      promptText?: string | null;
-      anchorCardIds?: string[];
-    }
-  | {
-      action: 'generate_landmarks';
-      count: number;
-      promptText?: string | null;
-      anchorCardIds?: string[];
-    }
-  | { action: 'generate_role_assets'; roleIds: string[] }
-  | {
-      action: 'sync_role_assets';
-      roleId: string;
-      portraitPath: string;
-      generatedVisualAssetId: string;
-      generatedAnimationSetId?: string | null;
-      animationMap?: Record<string, unknown> | null;
-    }
-  | { action: 'publish_world' };
-
-export interface CustomWorldAgentActionResponse {
-  operation: CustomWorldAgentOperationRecord;
-}
-
-export interface GetCustomWorldAgentCardDetailResponse {
-  card: CustomWorldDraftCardDetail;
-}
-
-export interface ListCustomWorldWorksResponse {
-  items: CustomWorldWorkSummary[];
-}
+export type * from './customWorldAgentAnchors';
+export type * from './customWorldAgentDraft';
+export type * from './customWorldAgentActions';
+export type * from './customWorldAgentSession';
+export type * from './customWorldResultPreview';
+export type * from './customWorldWorkSummary';
diff --git a/packages/shared/src/contracts/customWorldAgentActions.ts b/packages/shared/src/contracts/customWorldAgentActions.ts
new file mode 100644
index 00000000..a959bd0a
--- /dev/null
+++ b/packages/shared/src/contracts/customWorldAgentActions.ts
@@ -0,0 +1,14 @@
+/**
+ * 旧 custom world 动作契约兼容出口。
+ * 后续若逐步迁移旧代码，建议直接改用 rpgAgentActions.ts。
+ */
+
+export type {
+  RpgAgentActionRequest as CustomWorldAgentActionRequest,
+  RpgAgentActionResponse as CustomWorldAgentActionResponse,
+  RpgAgentOperationRecord as CustomWorldAgentOperationRecord,
+  RpgAgentOperationStatus as CustomWorldAgentOperationStatus,
+  RpgAgentOperationType as CustomWorldAgentOperationType,
+  RpgAgentSupportedAction as CustomWorldSupportedAction,
+  RpgAgentSuggestedAction as CustomWorldSuggestedAction,
+} from './rpgAgentActions';
diff --git a/packages/shared/src/contracts/customWorldAgentAnchors.ts b/packages/shared/src/contracts/customWorldAgentAnchors.ts
new file mode 100644
index 00000000..67d7793a
--- /dev/null
+++ b/packages/shared/src/contracts/customWorldAgentAnchors.ts
@@ -0,0 +1,16 @@
+/**
+ * 旧 custom world 八锚点兼容出口。
+ * 这里只保留旧命名到 RPG 创作域新契约的映射，便于旧导入渐进迁移。
+ */
+
+export type {
+  RpgCreationAnchorContent as EightAnchorContent,
+  RpgCreationCoreConflictValue as CoreConflictValue,
+  RpgCreationHiddenLineValue as HiddenLineValue,
+  RpgCreationIconicElementValue as IconicElementValue,
+  RpgCreationKeyRelationshipValue as KeyRelationshipValue,
+  RpgCreationPlayerEntryPointValue as PlayerEntryPointValue,
+  RpgCreationPlayerFantasyValue as PlayerFantasyValue,
+  RpgCreationThemeBoundaryValue as ThemeBoundaryValue,
+  RpgCreationWorldPromiseValue as WorldPromiseValue,
+} from './rpgAgentAnchors';
diff --git a/packages/shared/src/contracts/customWorldAgentDraft.ts b/packages/shared/src/contracts/customWorldAgentDraft.ts
new file mode 100644
index 00000000..4717fed6
--- /dev/null
+++ b/packages/shared/src/contracts/customWorldAgentDraft.ts
@@ -0,0 +1,29 @@
+/**
+ * 旧 custom world 草稿契约兼容出口。
+ * 工作包 H 完成后，真实定义已经迁到 rpgAgentDraft.ts，这里只负责旧命名映射。
+ */
+
+export type {
+  RpgAgentAssetCoverageSummary as CustomWorldAssetCoverageSummary,
+  RpgAgentAssetPriorityTier as CustomWorldAssetPriorityTier,
+  RpgAgentDraftCardDetail as CustomWorldDraftCardDetail,
+  RpgAgentDraftCardDetailSection as CustomWorldDraftCardDetailSection,
+  RpgAgentDraftCardKind as CustomWorldDraftCardKind,
+  RpgAgentDraftCardStatus as CustomWorldDraftCardStatus,
+  RpgAgentDraftCardSummary as CustomWorldDraftCardSummary,
+  RpgAgentFoundationDraftCamp as CustomWorldFoundationDraftCamp,
+  RpgAgentFoundationDraftChapter as CustomWorldFoundationDraftChapter,
+  RpgAgentFoundationDraftCharacter as CustomWorldFoundationDraftCharacter,
+  RpgAgentFoundationDraftFaction as CustomWorldFoundationDraftFaction,
+  RpgAgentFoundationDraftLandmark as CustomWorldFoundationDraftLandmark,
+  RpgAgentFoundationDraftProfile as CustomWorldFoundationDraftProfile,
+  RpgAgentFoundationDraftResult as CustomWorldFoundationDraftResult,
+  RpgAgentFoundationDraftSceneAct as CustomWorldFoundationDraftSceneAct,
+  RpgAgentFoundationDraftSceneChapter as CustomWorldFoundationDraftSceneChapter,
+  RpgAgentFoundationDraftThread as CustomWorldFoundationDraftThread,
+  RpgAgentRoleAssetStatus as CustomWorldRoleAssetStatus,
+  RpgAgentRoleAssetSummary as CustomWorldRoleAssetSummary,
+  RpgAgentSceneActAdvanceRule as CustomWorldSceneActAdvanceRule,
+  RpgAgentSceneActStage as CustomWorldSceneActStage,
+  RpgAgentSceneAssetSummary as CustomWorldSceneAssetSummary,
+} from './rpgAgentDraft';
diff --git a/packages/shared/src/contracts/customWorldAgentSession.ts b/packages/shared/src/contracts/customWorldAgentSession.ts
new file mode 100644
index 00000000..8a320a40
--- /dev/null
+++ b/packages/shared/src/contracts/customWorldAgentSession.ts
@@ -0,0 +1,20 @@
+/**
+ * 旧 custom world 会话契约兼容出口。
+ * 这一层只做命名映射，不再承担 session 真相源结构定义。
+ */
+
+export type {
+  CreateRpgAgentSessionRequest as CreateCustomWorldAgentSessionRequest,
+  CreateRpgAgentSessionResponse as CreateCustomWorldAgentSessionResponse,
+  GetRpgAgentCardDetailResponse as GetCustomWorldAgentCardDetailResponse,
+  RpgAgentMessage as CustomWorldAgentMessage,
+  RpgAgentMessageKind as CustomWorldAgentMessageKind,
+  RpgAgentMessageRole as CustomWorldAgentMessageRole,
+  RpgAgentPendingClarification as CustomWorldPendingClarification,
+  RpgAgentQualityFinding as CustomWorldAgentQualityFinding,
+  RpgAgentSessionSnapshot as CustomWorldAgentSessionSnapshot,
+  RpgAgentStage as CustomWorldAgentStage,
+  RpgCreationIntentReadiness as CreatorIntentReadiness,
+  SendRpgAgentMessageRequest as SendCustomWorldAgentMessageRequest,
+  SendRpgAgentMessageResponse as SendCustomWorldAgentMessageResponse,
+} from './rpgAgentSession';
diff --git a/packages/shared/src/contracts/customWorldResultPreview.ts b/packages/shared/src/contracts/customWorldResultPreview.ts
new file mode 100644
index 00000000..56ea9f3c
--- /dev/null
+++ b/packages/shared/src/contracts/customWorldResultPreview.ts
@@ -0,0 +1,12 @@
+/**
+ * 旧 custom world 结果页预览兼容出口。
+ * 额外单独拆一个 preview 兼容文件，避免预览别名继续堆回 customWorldAgent.ts 聚合层。
+ */
+
+export type {
+  RpgCreationPreview as CustomWorldResultPreview,
+  RpgCreationPreviewBlocker as CustomWorldResultPreviewBlocker,
+  RpgCreationPreviewEnvelope as CustomWorldResultPreviewEnvelope,
+  RpgCreationPreviewFinding as CustomWorldResultPreviewFinding,
+  RpgCreationPreviewSource as CustomWorldResultPreviewSource,
+} from './rpgCreationPreview';
diff --git a/packages/shared/src/contracts/customWorldWorkSummary.ts b/packages/shared/src/contracts/customWorldWorkSummary.ts
new file mode 100644
index 00000000..62a952f9
--- /dev/null
+++ b/packages/shared/src/contracts/customWorldWorkSummary.ts
@@ -0,0 +1,11 @@
+/**
+ * 旧 custom world works 读模型兼容出口。
+ * 用于把旧作品列表命名平滑映射到新的 RPG 创作域 works 契约。
+ */
+
+export type {
+  ListRpgCreationWorksResponse as ListCustomWorldWorksResponse,
+  RpgCreationWorkSource as CustomWorldWorkSource,
+  RpgCreationWorkStatus as CustomWorldWorkStatus,
+  RpgCreationWorkSummary as CustomWorldWorkSummary,
+} from './rpgCreationWorkSummary';
diff --git a/packages/shared/src/contracts/rpgAgentActions.ts b/packages/shared/src/contracts/rpgAgentActions.ts
index a22227f1..4a47b28a 100644
--- a/packages/shared/src/contracts/rpgAgentActions.ts
+++ b/packages/shared/src/contracts/rpgAgentActions.ts
@@ -1,7 +1,120 @@
-export type {
-  CustomWorldAgentActionRequest as RpgAgentActionRequest,
-  CustomWorldAgentActionResponse as RpgAgentActionResponse,
-  CustomWorldAgentOperationStatus as RpgAgentOperationStatus,
-  CustomWorldAgentOperationType as RpgAgentOperationType,
-  CustomWorldSuggestedAction as RpgAgentSuggestedAction,
-} from './customWorldAgent';
+/**
+ * RPG Agent 动作与异步操作契约。
+ * 这里显式区分“建议动作”和“真实可执行动作”，为后续后端 registry 收口预留接口。
+ */
+
+export type RpgAgentSuggestedActionType =
+  | 'request_summary'
+  | 'draft_foundation'
+  | 'refine_focus_target'
+  | 'lock_current_target'
+  | 'generate_role_assets'
+  | 'generate_scene_assets'
+  | 'expand_long_tail'
+  | 'publish_world';
+
+export interface RpgAgentSuggestedAction {
+  id: string;
+  type: RpgAgentSuggestedActionType;
+  label: string;
+  targetId?: string | null;
+}
+
+export type RpgAgentActionType =
+  | 'draft_foundation'
+  | 'update_draft_card'
+  | 'sync_result_profile'
+  | 'generate_characters'
+  | 'generate_landmarks'
+  | 'generate_role_assets'
+  | 'sync_role_assets'
+  | 'generate_scene_assets'
+  | 'sync_scene_assets'
+  | 'expand_long_tail'
+  | 'publish_world'
+  | 'revert_checkpoint';
+
+export type RpgAgentActionCapabilityKey =
+  | RpgAgentSuggestedActionType
+  | RpgAgentActionType;
+
+/**
+ * 当前先把能力矩阵定义为可选契约。
+ * 等工作包 E 的 registry 落地后，后端可以把真实 supportedActions 填充到 session snapshot。
+ */
+export interface RpgAgentSupportedAction {
+  action: RpgAgentActionCapabilityKey;
+  enabled: boolean;
+  reason?: string | null;
+}
+
+export type RpgAgentOperationType = RpgAgentActionType | 'process_message';
+
+export type RpgAgentOperationStatus =
+  | 'queued'
+  | 'running'
+  | 'completed'
+  | 'failed';
+
+export interface RpgAgentOperationRecord {
+  operationId: string;
+  type: RpgAgentOperationType;
+  status: RpgAgentOperationStatus;
+  phaseLabel: string;
+  phaseDetail: string;
+  progress: number;
+  error?: string | null;
+}
+
+export type RpgAgentActionRequest =
+  | { action: 'draft_foundation' }
+  | {
+      action: 'update_draft_card';
+      cardId: string;
+      sections: Array<{
+        sectionId: string;
+        value: string;
+      }>;
+    }
+  | {
+      action: 'sync_result_profile';
+      profile: Record<string, unknown>;
+    }
+  | {
+      action: 'generate_characters';
+      count: number;
+      promptText?: string | null;
+      anchorCardIds?: string[];
+    }
+  | {
+      action: 'generate_landmarks';
+      count: number;
+      promptText?: string | null;
+      anchorCardIds?: string[];
+    }
+  | { action: 'generate_role_assets'; roleIds: string[] }
+  | {
+      action: 'sync_role_assets';
+      roleId: string;
+      portraitPath: string;
+      generatedVisualAssetId: string;
+      generatedAnimationSetId?: string | null;
+      animationMap?: Record<string, unknown> | null;
+    }
+  | { action: 'generate_scene_assets'; sceneIds: string[] }
+  | {
+      action: 'sync_scene_assets';
+      sceneId: string;
+      sceneKind: 'camp' | 'landmark';
+      imageSrc: string;
+      generatedSceneAssetId: string;
+      generatedScenePrompt?: string | null;
+      generatedSceneModel?: string | null;
+    }
+  | { action: 'expand_long_tail' }
+  | { action: 'publish_world' }
+  | { action: 'revert_checkpoint'; checkpointId: string };
+
+export interface RpgAgentActionResponse {
+  operation: RpgAgentOperationRecord;
+}
diff --git a/packages/shared/src/contracts/rpgAgentAnchors.ts b/packages/shared/src/contracts/rpgAgentAnchors.ts
index 53a0ddcf..9f4f3e41 100644
--- a/packages/shared/src/contracts/rpgAgentAnchors.ts
+++ b/packages/shared/src/contracts/rpgAgentAnchors.ts
@@ -1,11 +1,63 @@
-export type {
-  EightAnchorContent as RpgCreationAnchorContent,
-  CoreConflictValue as RpgCreationCoreConflictValue,
-  HiddenLineValue as RpgCreationHiddenLineValue,
-  IconicElementValue as RpgCreationIconicElementValue,
-  KeyRelationshipValue as RpgCreationKeyRelationshipValue,
-  PlayerEntryPointValue as RpgCreationPlayerEntryPointValue,
-  PlayerFantasyValue as RpgCreationPlayerFantasyValue,
-  ThemeBoundaryValue as RpgCreationThemeBoundaryValue,
-  WorldPromiseValue as RpgCreationWorldPromiseValue,
-} from './customWorldAgent';
+/**
+ * RPG 创作八锚点契约。
+ * 这一层只描述“创作意图采集态”的结构，不混入 session 或结果页字段。
+ */
+
+export interface RpgCreationWorldPromiseValue {
+  hook: string;
+  differentiator: string;
+  desiredExperience: string;
+}
+
+export interface RpgCreationPlayerFantasyValue {
+  playerRole: string;
+  corePursuit: string;
+  fearOfLoss: string;
+}
+
+export interface RpgCreationThemeBoundaryValue {
+  toneKeywords: string[];
+  aestheticDirectives: string[];
+  forbiddenDirectives: string[];
+}
+
+export interface RpgCreationPlayerEntryPointValue {
+  openingIdentity: string;
+  openingProblem: string;
+  entryMotivation: string;
+}
+
+export interface RpgCreationCoreConflictValue {
+  surfaceConflicts: string[];
+  hiddenCrisis: string;
+  firstTouchedConflict: string;
+}
+
+export interface RpgCreationKeyRelationshipValue {
+  pairs: string;
+  relationshipType: string;
+  secretOrCost: string;
+}
+
+export interface RpgCreationHiddenLineValue {
+  hiddenTruths: string[];
+  misdirectionHints: string[];
+  revealPacing: string;
+}
+
+export interface RpgCreationIconicElementValue {
+  iconicMotifs: string[];
+  institutionsOrArtifacts: string[];
+  hardRules: string[];
+}
+
+export interface RpgCreationAnchorContent {
+  worldPromise: RpgCreationWorldPromiseValue | null;
+  playerFantasy: RpgCreationPlayerFantasyValue | null;
+  themeBoundary: RpgCreationThemeBoundaryValue | null;
+  playerEntryPoint: RpgCreationPlayerEntryPointValue | null;
+  coreConflict: RpgCreationCoreConflictValue | null;
+  keyRelationships: RpgCreationKeyRelationshipValue[];
+  hiddenLines: RpgCreationHiddenLineValue | null;
+  iconicElements: RpgCreationIconicElementValue | null;
+}
diff --git a/packages/shared/src/contracts/rpgAgentDraft.ts b/packages/shared/src/contracts/rpgAgentDraft.ts
new file mode 100644
index 00000000..9339e234
--- /dev/null
+++ b/packages/shared/src/contracts/rpgAgentDraft.ts
@@ -0,0 +1,251 @@
+/**
+ * RPG Agent 草稿与资产覆盖率契约。
+ * 这一层只描述 foundation draft、草稿卡片与资产状态，不包含会话编排语义。
+ */
+
+export type RpgAgentDraftCardKind =
+  | 'world'
+  | 'camp'
+  | 'faction'
+  | 'character'
+  | 'landmark'
+  | 'thread'
+  | 'chapter'
+  | 'scene_chapter'
+  | 'carrier'
+  | 'sidequest_seed';
+
+export type RpgAgentDraftCardStatus =
+  | 'suggested'
+  | 'confirmed'
+  | 'locked'
+  | 'warning';
+
+export interface RpgAgentDraftCardSummary {
+  id: string;
+  kind: RpgAgentDraftCardKind;
+  title: string;
+  subtitle: string;
+  summary: string;
+  status: RpgAgentDraftCardStatus;
+  linkedIds: string[];
+  warningCount: number;
+  assetStatus?: RpgAgentRoleAssetStatus | null;
+  assetStatusLabel?: string | null;
+}
+
+export interface RpgAgentDraftCardDetailSection {
+  id: string;
+  label: string;
+  value: string;
+}
+
+export interface RpgAgentFoundationDraftFaction {
+  id: string;
+  name: string;
+  title?: string;
+  subtitle?: string;
+  publicGoal: string;
+  relatedConflict: string;
+  tension?: string;
+  playerRelation: string;
+  summary: string;
+}
+
+export interface RpgAgentFoundationDraftCharacter {
+  id: string;
+  name: string;
+  title: string;
+  role: string;
+  publicIdentity: string;
+  publicMask?: string;
+  currentPressure: string;
+  hiddenHook?: string;
+  relationToPlayer: string;
+  threadIds: string[];
+  summary: string;
+  skills?: Array<{
+    id: string;
+    name: string;
+    actionPreviewConfig?: Record<string, unknown> | null;
+  }>;
+  imageSrc?: string | null;
+  generatedVisualAssetId?: string | null;
+  generatedAnimationSetId?: string | null;
+  animationMap?: Record<string, unknown> | null;
+}
+
+export interface RpgAgentFoundationDraftLandmark {
+  id: string;
+  name: string;
+  description?: string;
+  purpose: string;
+  mood: string;
+  importance: string;
+  secret?: string;
+  dangerLevel?: string;
+  imageSrc?: string | null;
+  generatedSceneAssetId?: string | null;
+  generatedScenePrompt?: string | null;
+  generatedSceneModel?: string | null;
+  characterIds: string[];
+  threadIds: string[];
+  summary: string;
+}
+
+export interface RpgAgentFoundationDraftThread {
+  id: string;
+  title: string;
+  type: 'main' | 'hidden';
+  conflictType?: string;
+  conflict: string;
+  stakes?: string;
+  characterIds: string[];
+  landmarkIds: string[];
+  summary: string;
+}
+
+export interface RpgAgentFoundationDraftChapter {
+  id: string;
+  title: string;
+  openingEvent: string;
+  playerGoal: string;
+  characterIds: string[];
+  landmarkIds: string[];
+  understandingShift: string;
+  summary: string;
+}
+
+export interface RpgAgentFoundationDraftCamp {
+  id: string;
+  name: string;
+  description: string;
+  mood: string;
+  dangerLevel?: string;
+  imageSrc?: string | null;
+  generatedSceneAssetId?: string | null;
+  generatedScenePrompt?: string | null;
+  generatedSceneModel?: string | null;
+  summary: string;
+}
+
+export type RpgAgentSceneActStage =
+  | 'opening'
+  | 'expansion'
+  | 'turning_point'
+  | 'climax'
+  | 'aftermath';
+
+export type RpgAgentSceneActAdvanceRule =
+  | 'after_primary_contact'
+  | 'after_active_step_complete'
+  | 'after_chapter_resolution';
+
+export interface RpgAgentFoundationDraftSceneAct {
+  id: string;
+  title: string;
+  summary: string;
+  stageCoverage: RpgAgentSceneActStage[];
+  backgroundImageSrc?: string | null;
+  backgroundAssetId?: string | null;
+  encounterNpcIds: string[];
+  primaryNpcId: string;
+  linkedThreadIds: string[];
+  actGoal: string;
+  transitionHook: string;
+  advanceRule: RpgAgentSceneActAdvanceRule;
+}
+
+export interface RpgAgentFoundationDraftSceneChapter {
+  id: string;
+  sceneId: string;
+  sceneName: string;
+  title: string;
+  summary: string;
+  linkedThreadIds: string[];
+  linkedLandmarkIds: string[];
+  acts: RpgAgentFoundationDraftSceneAct[];
+}
+
+export interface RpgAgentFoundationDraftProfile {
+  name: string;
+  subtitle: string;
+  summary: string;
+  tone: string;
+  playerGoal: string;
+  majorFactions: string[];
+  coreConflicts: string[];
+  playableNpcs: RpgAgentFoundationDraftCharacter[];
+  storyNpcs: RpgAgentFoundationDraftCharacter[];
+  landmarks: RpgAgentFoundationDraftLandmark[];
+  camp?: RpgAgentFoundationDraftCamp | null;
+  themePack?: Record<string, unknown> | null;
+  storyGraph?: Record<string, unknown> | null;
+  factions: RpgAgentFoundationDraftFaction[];
+  threads: RpgAgentFoundationDraftThread[];
+  chapters: RpgAgentFoundationDraftChapter[];
+  sceneChapters: RpgAgentFoundationDraftSceneChapter[];
+  worldHook: string;
+  playerPremise: string;
+  openingSituation: string;
+  iconicElements: string[];
+  sourceAnchorSummary: string;
+}
+
+export interface RpgAgentFoundationDraftResult {
+  draftProfile: RpgAgentFoundationDraftProfile;
+  draftCards: RpgAgentDraftCardSummary[];
+}
+
+export interface RpgAgentDraftCardDetail {
+  id: string;
+  kind: RpgAgentDraftCardKind;
+  title: string;
+  sections: RpgAgentDraftCardDetailSection[];
+  linkedIds: string[];
+  locked: false;
+  editable: boolean;
+  editableSectionIds: string[];
+  warningMessages: string[];
+  assetStatus?: RpgAgentRoleAssetStatus | null;
+  assetStatusLabel?: string | null;
+}
+
+export type RpgAgentAssetPriorityTier = 'hero' | 'featured' | 'supporting';
+
+export type RpgAgentRoleAssetStatus =
+  | 'missing'
+  | 'visual_ready'
+  | 'animations_ready'
+  | 'complete';
+
+export interface RpgAgentRoleAssetSummary {
+  roleId: string;
+  roleName: string;
+  roleKind: 'playable' | 'story';
+  priorityTier: RpgAgentAssetPriorityTier;
+  portraitPath?: string | null;
+  generatedVisualAssetId?: string | null;
+  generatedAnimationSetId?: string | null;
+  status: RpgAgentRoleAssetStatus;
+  missingAnimations: string[];
+  nextPointCost: number;
+}
+
+export interface RpgAgentSceneAssetSummary {
+  sceneId: string;
+  sceneName: string;
+  actId?: string | null;
+  actTitle?: string | null;
+  imageSrc?: string | null;
+  assetId?: string | null;
+  status: 'missing' | 'ready';
+  nextPointCost: number;
+}
+
+export interface RpgAgentAssetCoverageSummary {
+  roleAssets: RpgAgentRoleAssetSummary[];
+  sceneAssets: RpgAgentSceneAssetSummary[];
+  allRoleAssetsReady: boolean;
+  allSceneAssetsReady: boolean;
+}
diff --git a/packages/shared/src/contracts/rpgAgentSession.ts b/packages/shared/src/contracts/rpgAgentSession.ts
index d2c21fae..0bdb8ef1 100644
--- a/packages/shared/src/contracts/rpgAgentSession.ts
+++ b/packages/shared/src/contracts/rpgAgentSession.ts
@@ -1,15 +1,134 @@
-export type {
-  CreateCustomWorldAgentSessionRequest as CreateRpgAgentSessionRequest,
-  CreateCustomWorldAgentSessionResponse as CreateRpgAgentSessionResponse,
-  GetCustomWorldAgentCardDetailResponse as GetRpgAgentCardDetailResponse,
-  CustomWorldAgentMessage as RpgAgentMessage,
-  CustomWorldAgentMessageKind as RpgAgentMessageKind,
-  CustomWorldAgentMessageRole as RpgAgentMessageRole,
-  CustomWorldAgentOperationRecord as RpgAgentOperationRecord,
-  CustomWorldPendingClarification as RpgAgentPendingClarification,
-  CustomWorldAgentSessionSnapshot as RpgAgentSessionSnapshot,
-  CustomWorldAgentStage as RpgAgentStage,
-  CreatorIntentReadiness as RpgCreationIntentReadiness,
-  SendCustomWorldAgentMessageRequest as SendRpgAgentMessageRequest,
-  SendCustomWorldAgentMessageResponse as SendRpgAgentMessageResponse,
-} from './customWorldAgent';
+import type { RpgAgentActionResponse, RpgAgentOperationRecord, RpgAgentSupportedAction, RpgAgentSuggestedAction } from './rpgAgentActions';
+import type { RpgCreationAnchorContent } from './rpgAgentAnchors';
+import type { RpgAgentAssetCoverageSummary, RpgAgentDraftCardDetail, RpgAgentDraftCardSummary } from './rpgAgentDraft';
+import type { RpgCreationPreviewEnvelope } from './rpgCreationPreview';
+
+/**
+ * RPG Agent 会话层契约。
+ * 这里承载 session 真相源与会话编排元数据，同时预留 resultPreview 与 supportedActions 两个后续主链字段。
+ */
+
+export interface RpgCreationIntentReadiness {
+  isReady: boolean;
+  completedKeys: string[];
+  missingKeys: string[];
+}
+
+export interface RpgAgentPendingClarification {
+  id: string;
+  label: string;
+  question: string;
+  targetKey:
+    | 'world_hook'
+    | 'player_premise'
+    | 'theme_and_tone'
+    | 'core_conflict'
+    | 'relationship_seed'
+    | 'iconic_element';
+  priority: number;
+  answer?: string;
+}
+
+export type RpgAgentStage =
+  | 'collecting_intent'
+  | 'clarifying'
+  | 'foundation_review'
+  | 'object_refining'
+  | 'visual_refining'
+  | 'long_tail_review'
+  | 'ready_to_publish'
+  | 'published'
+  | 'error';
+
+export type RpgAgentMessageRole = 'user' | 'assistant' | 'system';
+
+export type RpgAgentMessageKind =
+  | 'chat'
+  | 'clarification'
+  | 'summary'
+  | 'checkpoint'
+  | 'warning'
+  | 'action_result';
+
+export interface RpgAgentMessage {
+  id: string;
+  role: RpgAgentMessageRole;
+  kind: RpgAgentMessageKind;
+  text: string;
+  createdAt: string;
+  relatedOperationId?: string | null;
+}
+
+export interface RpgAgentQualityFinding {
+  id: string;
+  severity: 'info' | 'warning' | 'blocker';
+  code: string;
+  targetId?: string | null;
+  message: string;
+}
+
+export interface RpgAgentSessionSnapshot {
+  sessionId: string;
+  currentTurn: number;
+  anchorContent: RpgCreationAnchorContent;
+  progressPercent: number;
+  lastAssistantReply: string | null;
+  stage: RpgAgentStage;
+  focusCardId: string | null;
+  creatorIntent: Record<string, unknown> | null;
+  creatorIntentReadiness: RpgCreationIntentReadiness;
+  anchorPack: Record<string, unknown> | null;
+  lockState: Record<string, unknown> | null;
+  draftProfile: Record<string, unknown> | null;
+  messages: RpgAgentMessage[];
+  draftCards: RpgAgentDraftCardSummary[];
+  pendingClarifications: RpgAgentPendingClarification[];
+  suggestedActions: RpgAgentSuggestedAction[];
+  recommendedReplies: string[];
+  qualityFindings: RpgAgentQualityFinding[];
+  assetCoverage: RpgAgentAssetCoverageSummary;
+  /**
+   * checkpoint 元数据需要进入 session snapshot 主链，
+   * 这样前端后续才能拿到真实可回滚目标，而不是只能盲发 checkpointId。
+   */
+  checkpoints?: Array<{
+    checkpointId: string;
+    createdAt: string;
+    label: string;
+  }>;
+  /**
+   * 后续由工作包 E 的 action registry 真实填充。
+   * 当前保持可选，确保主链迁移期间不影响旧 session snapshot。
+   */
+  supportedActions?: RpgAgentSupportedAction[];
+  /**
+   * 后续由服务端 preview compiler 输出。
+   * 当前保持可选，允许前端兼容层继续走 legacy profile。
+   */
+  resultPreview?: RpgCreationPreviewEnvelope | null;
+  updatedAt: string;
+}
+
+export interface CreateRpgAgentSessionRequest {
+  seedText?: string;
+}
+
+export interface CreateRpgAgentSessionResponse {
+  session: RpgAgentSessionSnapshot;
+}
+
+export interface SendRpgAgentMessageRequest {
+  clientMessageId: string;
+  text: string;
+  quickFillRequested?: boolean;
+  focusCardId?: string | null;
+  selectedCardIds?: string[];
+}
+
+export interface SendRpgAgentMessageResponse extends RpgAgentActionResponse {
+  operation: RpgAgentOperationRecord;
+}
+
+export interface GetRpgAgentCardDetailResponse {
+  card: RpgAgentDraftCardDetail;
+}
diff --git a/packages/shared/src/contracts/rpgContracts.test.ts b/packages/shared/src/contracts/rpgContracts.test.ts
new file mode 100644
index 00000000..930d7e2a
--- /dev/null
+++ b/packages/shared/src/contracts/rpgContracts.test.ts
@@ -0,0 +1,146 @@
+import { describe, expect, test } from 'vitest';
+import type { CustomWorldAgentSessionSnapshot } from './customWorldAgentSession';
+import type { CustomWorldResultPreviewEnvelope } from './customWorldResultPreview';
+import type { CustomWorldWorkSummary } from './customWorldWorkSummary';
+
+import {
+  createRpgAgentFoundationDraftProfileFixture,
+  createRpgAgentSupportedActionsFixture,
+  createRpgAgentSessionFixture,
+  createRpgCreationAnchorContentFixture,
+  createRpgCreationPreviewEnvelopeFixture,
+  createRpgCreationPublishedProfileFixture,
+  createRpgCreationWorksResponseFixture,
+  createRpgWorldLibraryEntryFixture,
+} from './rpgCreationFixtures';
+
+describe('RPG 创作共享契约 fixture', () => {
+  test('旧命名兼容分文件可以直接承接新 fixture 的类型消费', () => {
+    const legacySession: CustomWorldAgentSessionSnapshot =
+      createRpgAgentSessionFixture();
+    const legacyPreview: CustomWorldResultPreviewEnvelope =
+      createRpgCreationPreviewEnvelopeFixture();
+    const legacyWork: CustomWorldWorkSummary =
+      createRpgCreationWorksResponseFixture().items[0]!;
+
+    expect(legacySession.stage).toBe('ready_to_publish');
+    expect(legacySession.resultPreview?.source).toBe(legacyPreview.source);
+    expect(legacyWork.status).toBe('draft');
+  });
+
+  test('anchor fixture 与 foundation draft fixture 保持最小创作真相源对应关系', () => {
+    const anchors = createRpgCreationAnchorContentFixture();
+    const draftProfile = createRpgAgentFoundationDraftProfileFixture();
+
+    expect(anchors.worldPromise?.hook).toContain('旧航路群岛');
+    expect(draftProfile.worldHook).toContain('旧航路群岛');
+    expect(draftProfile.playableNpcs).toHaveLength(1);
+    expect(draftProfile.storyNpcs).toHaveLength(1);
+    expect(draftProfile.sceneChapters[0]?.acts[0]?.backgroundImageSrc).toContain(
+      '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
+    );
+  });
+
+  test('session fixture 同时暴露 supportedActions 与 resultPreview', () => {
+    const session = createRpgAgentSessionFixture();
+
+    expect(session.sessionId).toBe('rpg-session-fixture');
+    expect(session.stage).toBe('ready_to_publish');
+    expect(session.checkpoints?.[0]?.checkpointId).toBe(
+      'checkpoint-foundation-v1',
+    );
+    expect(session.supportedActions?.map((entry) => entry.action)).toEqual(
+      expect.arrayContaining(['draft_foundation', 'generate_role_assets', 'publish_world']),
+    );
+    expect(session.resultPreview?.source).toBe('session_preview');
+    expect(session.resultPreview?.blockers).toEqual([]);
+  });
+
+  test('preview fixture 保持预览来源、质量结论与 profile 载体三层边界', () => {
+    const preview = createRpgCreationPreviewEnvelopeFixture();
+
+    expect(preview.source).toBe('session_preview');
+    expect(preview.preview.previewId).toBe('preview-fixture-1');
+    expect(preview.preview.sessionId).toBe('rpg-session-fixture');
+    expect(preview.qualityFindings?.[0]).toMatchObject({
+      severity: 'info',
+      code: 'scene_asset_ready',
+    });
+  });
+
+  test('supported actions fixture 明确区分可执行能力矩阵，而不是让前端自行猜测按钮状态', () => {
+    const supportedActions = createRpgAgentSupportedActionsFixture();
+
+    expect(supportedActions).toEqual([
+      { action: 'draft_foundation', enabled: true },
+      { action: 'generate_role_assets', enabled: true },
+      { action: 'publish_world', enabled: true },
+    ]);
+  });
+
+  test('published profile fixture 能稳定承载作品库与结果页所需的封面、场景幕与角色资产字段', () => {
+    const profile = createRpgCreationPublishedProfileFixture();
+
+    expect(profile.id).toBe('rpg-profile-fixture');
+    expect(profile.playableNpcs).toHaveLength(1);
+    expect(profile.landmarks).toHaveLength(1);
+    expect(profile.sceneChapterBlueprints).toHaveLength(1);
+    expect(
+      (profile.sceneChapterBlueprints as Array<{ acts?: Array<{ backgroundImageSrc?: string }> }>)[0]
+        ?.acts?.[0]?.backgroundImageSrc,
+    ).toContain('/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png');
+  });
+
+  test('regression: session preview 与 published profile 需要共同保留角色动作资产和分幕背景字段', () => {
+    const session = createRpgAgentSessionFixture();
+    const publishedProfile = createRpgCreationPublishedProfileFixture();
+    const preview = createRpgCreationPreviewEnvelopeFixture();
+
+    expect(
+      ((session.draftProfile as { playableNpcs?: Array<{ animationMap?: { run?: { basePath?: string } } }> })
+        .playableNpcs?.[0]?.animationMap?.run?.basePath ?? ''),
+    ).toContain('/generated-characters/playable-1/animations/run');
+    expect(
+      ((preview.preview.playableNpcs as Array<{ generatedAnimationSetId?: string }>)[0]
+        ?.generatedAnimationSetId ?? ''),
+    ).toBe('animation-set-playable-1');
+    expect(
+      ((publishedProfile.sceneChapterBlueprints as Array<{
+        acts?: Array<{ backgroundAssetId?: string }>;
+      }>)[0]?.acts?.[0]?.backgroundAssetId ?? ''),
+    ).toBe('scene-asset-runtime');
+  });
+
+  test('works fixture 与 library fixture 对齐同一 published profile', () => {
+    const works = createRpgCreationWorksResponseFixture();
+    const libraryEntry = createRpgWorldLibraryEntryFixture();
+
+    const publishedWork = works.items.find((entry) => entry.status === 'published');
+
+    expect(publishedWork?.profileId).toBe(libraryEntry.profileId);
+    expect(publishedWork?.title).toBe(libraryEntry.worldName);
+    expect(publishedWork?.canEnterWorld).toBe(true);
+    expect(libraryEntry.profile.id).toBe(libraryEntry.profileId);
+  });
+
+  test('regression: works fixture 需要稳定保留草稿与发布态的作品门槛字段', () => {
+    const works = createRpgCreationWorksResponseFixture();
+    const draftWork = works.items.find((entry) => entry.status === 'draft');
+    const publishedWork = works.items.find((entry) => entry.status === 'published');
+
+    expect(draftWork).toMatchObject({
+      stage: 'ready_to_publish',
+      stageLabel: '准备发布',
+      canResume: true,
+      canEnterWorld: false,
+      roleVisualReadyCount: 2,
+      roleAnimationReadyCount: 2,
+    });
+    expect(publishedWork).toMatchObject({
+      stage: 'published',
+      stageLabel: '已发布',
+      canResume: false,
+      canEnterWorld: true,
+    });
+  });
+});
diff --git a/packages/shared/src/contracts/rpgCreationFixtures.ts b/packages/shared/src/contracts/rpgCreationFixtures.ts
new file mode 100644
index 00000000..171ccff9
--- /dev/null
+++ b/packages/shared/src/contracts/rpgCreationFixtures.ts
@@ -0,0 +1,714 @@
+import type {
+  CustomWorldLibraryEntry,
+  CustomWorldProfileRecord,
+} from './runtime';
+import type { RpgAgentSupportedAction } from './rpgAgentActions';
+import type { RpgCreationAnchorContent } from './rpgAgentAnchors';
+import type {
+  RpgAgentAssetCoverageSummary,
+  RpgAgentDraftCardSummary,
+  RpgAgentFoundationDraftProfile,
+} from './rpgAgentDraft';
+import type { RpgAgentSessionSnapshot } from './rpgAgentSession';
+import type { RpgCreationPreviewEnvelope } from './rpgCreationPreview';
+import type {
+  ListRpgCreationWorksResponse,
+  RpgCreationWorkSummary,
+} from './rpgCreationWorkSummary';
+
+const RPG_CREATION_FIXTURE_SESSION_ID = 'rpg-session-fixture';
+const RPG_CREATION_FIXTURE_PROFILE_ID = 'rpg-profile-fixture';
+const RPG_CREATION_FIXTURE_USER_ID = 'fixture-user';
+const RPG_CREATION_FIXTURE_UPDATED_AT = '2026-04-21T09:30:00.000Z';
+const RPG_CREATION_FIXTURE_PUBLISHED_AT = '2026-04-21T10:00:00.000Z';
+
+function cloneFixture<T>(value: T): T {
+  return JSON.parse(JSON.stringify(value)) as T;
+}
+
+/**
+ * 共享八锚点 fixture。
+ * 用于 contract test、session fixture 和 works 集成测试复用同一份创作意图样本。
+ */
+export function createRpgCreationAnchorContentFixture(): RpgCreationAnchorContent {
+  return cloneFixture({
+    worldPromise: {
+      hook: '被海雾吞没的旧航路群岛',
+      differentiator: '灯塔与禁航令共同决定谁能活着穿过去。',
+      desiredExperience: '压抑、悬疑、潮湿',
+    },
+    playerFantasy: {
+      playerRole: '玩家回到群岛调查沉船真相。',
+      corePursuit: '找出失控航路背后的真相。',
+      fearOfLoss: '失去最后一个还能对上旧案的人。',
+    },
+    themeBoundary: {
+      toneKeywords: ['压抑', '潮湿', '悬疑'],
+      aestheticDirectives: ['旧灯塔', '潮雾', '断裂航路'],
+      forbiddenDirectives: ['不要出现现代枪械'],
+    },
+    playerEntryPoint: {
+      openingIdentity: '被迫返乡的失职守灯人',
+      openingProblem: '首夜就有陌生船只闯入禁航区。',
+      entryMotivation: '查清沉船夜里被谁改动了灯册。',
+    },
+    coreConflict: {
+      surfaceConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      hiddenCrisis: '沉船夜的航灯与灯册被人动过手脚。',
+      firstTouchedConflict: '玩家开局就会撞上新的封航命令。',
+    },
+    keyRelationships: [
+      {
+        pairs: '玩家 / 沈砺',
+        relationshipType: '旧友兼潜在背叛者',
+        secretOrCost: '沈砺暗地里在替沉船商盟引路。',
+      },
+    ],
+    hiddenLines: {
+      hiddenTruths: ['沉船夜的真实失误并不是单纯天灾。'],
+      misdirectionHints: ['所有人都会先把问题推给潮雾本身。'],
+      revealPacing: '第一章露出痕迹，第二章才让玩家摸到灯册线。',
+    },
+    iconicElements: {
+      iconicMotifs: ['会移动的海雾'],
+      institutionsOrArtifacts: ['回潮旧灯塔', '封灯令', '旧潮图'],
+      hardRules: ['禁航信号一旦点亮，任何船都必须退航。'],
+    },
+  } satisfies RpgCreationAnchorContent);
+}
+
+/**
+ * 共享 foundation draft fixture。
+ * 这份样本同时服务 session 草稿、preview 适配回归测试和 works 聚合测试。
+ */
+export function createRpgAgentFoundationDraftProfileFixture(): RpgAgentFoundationDraftProfile {
+  return cloneFixture({
+    name: '潮雾列岛',
+    subtitle: '旧灯塔与失控航路',
+    summary: '第一版世界底稿已经整理完成，玩家将从回潮旧灯塔切入沉船旧案。',
+    tone: '压抑、潮湿、悬疑',
+    playerGoal: '查清沉船与禁航区异动的真相。',
+    majorFactions: ['守灯会', '航运公会'],
+    coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+    playableNpcs: [
+      {
+        id: 'playable-1',
+        name: '沈砺',
+        title: '旧航路引路人',
+        role: '关键同行者',
+        publicIdentity: '最熟悉旧航路的人。',
+        publicMask: '看上去像可靠旧友。',
+        currentPressure: '他必须在两股势力间站队。',
+        hiddenHook: '暗中替沉船商盟引路。',
+        relationToPlayer: '旧友兼潜在背叛者',
+        threadIds: ['thread-1'],
+        summary: '他像旧友，但也像一把始终没收回鞘的刀。',
+        skills: [
+          {
+            id: 'skill-playable-1',
+            name: '潮行引路',
+            actionPreviewConfig: {
+              basePath:
+                '/generated-characters/playable-1/animations/skills/skill-playable-1',
+            },
+          },
+        ],
+        imageSrc:
+          '/generated-characters/playable-1/visual/asset-runtime/master.png',
+        generatedVisualAssetId: 'asset-runtime-playable',
+        generatedAnimationSetId: 'animation-set-playable-1',
+        animationMap: {
+          idle: {
+            basePath: '/generated-characters/playable-1/animations/idle',
+          },
+          run: {
+            basePath: '/generated-characters/playable-1/animations/run',
+          },
+          attack: {
+            basePath: '/generated-characters/playable-1/animations/attack',
+          },
+        },
+      },
+    ],
+    storyNpcs: [
+      {
+        id: 'story-1',
+        name: '顾潮音',
+        title: '守灯会值夜人',
+        role: '场景关键角色',
+        publicIdentity: '负责夜间巡灯与封锁。',
+        publicMask: '对外一直冷静克制。',
+        currentPressure: '她知道更多禁航区真相。',
+        hiddenHook: '曾亲眼见过失控海雾吞船。',
+        relationToPlayer: '最早愿意交换线索的人',
+        threadIds: ['thread-1'],
+        summary: '她总像比所有人更早知道海雾会往哪一侧压下来。',
+        skills: [
+          {
+            id: 'skill-story-1',
+            name: '夜潮灯语',
+            actionPreviewConfig: {
+              basePath:
+                '/generated-characters/story-1/animations/skills/skill-story-1',
+            },
+          },
+        ],
+        imageSrc:
+          '/generated-characters/story-1/visual/asset-runtime/master.png',
+        generatedVisualAssetId: 'asset-runtime-story',
+        generatedAnimationSetId: 'animation-set-story-1',
+        animationMap: {
+          run: {
+            basePath: '/generated-characters/story-1/animations/run',
+          },
+          attack: {
+            basePath: '/generated-characters/story-1/animations/attack',
+          },
+        },
+      },
+    ],
+    landmarks: [
+      {
+        id: 'landmark-1',
+        name: '回潮旧灯塔',
+        description: '被海雾啃旧的石塔仍在夜里维持着微弱灯火。',
+        purpose: '观察雾潮与往来船只',
+        mood: '潮湿、压抑、风声不止',
+        importance: '开局核心场景',
+        secret: '高处潮痕说明海面异常抬升过。',
+        dangerLevel: 'high',
+        imageSrc: '/generated-custom-world-scenes/landmark-1/latest-scene.png',
+        generatedSceneAssetId: 'scene-asset-landmark-1',
+        characterIds: ['story-1'],
+        threadIds: ['thread-1'],
+        summary: '旧灯塔是整片群岛最先看见异动的地方。',
+      },
+    ],
+    camp: {
+      id: 'camp-1',
+      name: '回潮暂栖所',
+      description: '能暂时收拢队伍、整理灯册与潮路线索的落脚点。',
+      mood: '克制、紧绷，但还能暂时收拢局势',
+      dangerLevel: 'low',
+      imageSrc: '/custom/camp/huichao.png',
+      generatedSceneAssetId: 'scene-asset-camp-1',
+      summary: '玩家能在这里整理情报、回看旧灯册和沉船名单。',
+    },
+    themePack: {
+      id: 'theme-pack:tide',
+      displayName: '潮雾悬疑',
+    },
+    storyGraph: {
+      visibleThreads: [
+        {
+          id: 'thread-visible-1',
+          title: '封航争夺',
+        },
+      ],
+    },
+    factions: [
+      {
+        id: 'faction-1',
+        name: '守灯会',
+        title: '守灯会',
+        subtitle: '把控禁航灯令的人',
+        publicGoal: '维持封航秩序并压住灯册流出。',
+        relatedConflict: '想把旧案继续压在禁航记录之下。',
+        tension: '他们越强调规矩，越像在遮掩灯册。',
+        playerRelation: '玩家迟早要与他们正面冲突。',
+        summary: '掌握灯塔与封航令的势力，也是最怕旧案被翻出来的一方。',
+      },
+    ],
+    threads: [
+      {
+        id: 'thread-1',
+        title: '沉船旧案',
+        type: 'main',
+        conflictType: '真相遮蔽',
+        conflict: '沉船夜的航灯与灯册被人动过手脚。',
+        stakes: '真相一旦坐实，群岛秩序会先崩。',
+        characterIds: ['playable-1', 'story-1'],
+        landmarkIds: ['landmark-1'],
+        summary: '玩家会从灯塔高处潮痕一路追到沉船夜的真相。',
+      },
+    ],
+    chapters: [
+      {
+        id: 'chapter-1',
+        title: '灯塔回潮',
+        openingEvent: '禁航区闯入了一艘不该出现的陌生船。',
+        playerGoal: '先稳住局势，再拿到第一份灯册线索。',
+        characterIds: ['playable-1', 'story-1'],
+        landmarkIds: ['landmark-1'],
+        understandingShift: '玩家会意识到沉船旧案至今仍在操控群岛秩序。',
+        summary: '第一章聚焦灯塔与封航令，给玩家一条可追的旧案线索。',
+      },
+    ],
+    sceneChapters: [
+      {
+        id: 'scene-chapter-1',
+        sceneId: 'landmark-1',
+        sceneName: '回潮旧灯塔',
+        title: '灯塔初章',
+        summary: '围绕灯塔推进的首个场景章节。',
+        linkedThreadIds: ['thread-1'],
+        linkedLandmarkIds: ['landmark-1'],
+        acts: [
+          {
+            id: 'scene-act-1',
+            title: '第一幕',
+            summary: '先接住回潮灯塔的入口压力。',
+            stageCoverage: ['opening'],
+            backgroundImageSrc:
+              '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
+            backgroundAssetId: 'scene-asset-runtime',
+            encounterNpcIds: ['story-1'],
+            primaryNpcId: 'story-1',
+            linkedThreadIds: ['thread-1'],
+            actGoal: '接住首幕入口',
+            transitionHook: '向第二幕推进。',
+            advanceRule: 'after_primary_contact',
+          },
+        ],
+      },
+    ],
+    worldHook: '被海雾吞没的旧航路群岛',
+    playerPremise: '玩家回到群岛调查沉船真相。',
+    openingSituation: '首夜就有陌生船只闯入禁航区。',
+    iconicElements: ['会移动的海雾', '回潮旧灯塔'],
+    sourceAnchorSummary: '海雾、旧灯塔、失控航路。',
+  } satisfies RpgAgentFoundationDraftProfile);
+}
+
+function createRpgAgentDraftCardsFixture(): RpgAgentDraftCardSummary[] {
+  return cloneFixture([
+    {
+      id: 'world-foundation',
+      kind: 'world',
+      title: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '第一版世界底稿已经整理完成。',
+      status: 'suggested',
+      linkedIds: ['playable-1', 'story-1', 'landmark-1'],
+      warningCount: 0,
+    },
+    {
+      id: 'playable-1',
+      kind: 'character',
+      title: '沈砺',
+      subtitle: '旧航路引路人 / 动作已齐',
+      summary: '最熟悉旧航路的人，也可能是最危险的旧友。',
+      status: 'suggested',
+      linkedIds: ['thread-1', 'landmark-1'],
+      warningCount: 0,
+      assetStatus: 'complete',
+      assetStatusLabel: '动作已齐',
+    },
+    {
+      id: 'landmark-1',
+      kind: 'landmark',
+      title: '回潮旧灯塔',
+      subtitle: '观察雾潮与往来船只',
+      summary: '旧灯塔是整片群岛最先看见异动的地方。',
+      status: 'suggested',
+      linkedIds: ['story-1', 'thread-1'],
+      warningCount: 0,
+    },
+  ] satisfies RpgAgentDraftCardSummary[]);
+}
+
+function createRpgAgentAssetCoverageFixture(): RpgAgentAssetCoverageSummary {
+  return cloneFixture({
+    roleAssets: [
+      {
+        roleId: 'playable-1',
+        roleName: '沈砺',
+        roleKind: 'playable',
+        priorityTier: 'hero',
+        portraitPath:
+          '/generated-characters/playable-1/visual/asset-runtime/master.png',
+        generatedVisualAssetId: 'asset-runtime-playable',
+        generatedAnimationSetId: 'animation-set-playable-1',
+        status: 'complete',
+        missingAnimations: [],
+        nextPointCost: 0,
+      },
+      {
+        roleId: 'story-1',
+        roleName: '顾潮音',
+        roleKind: 'story',
+        priorityTier: 'featured',
+        portraitPath:
+          '/generated-characters/story-1/visual/asset-runtime/master.png',
+        generatedVisualAssetId: 'asset-runtime-story',
+        generatedAnimationSetId: 'animation-set-story-1',
+        status: 'complete',
+        missingAnimations: [],
+        nextPointCost: 0,
+      },
+    ],
+    sceneAssets: [
+      {
+        sceneId: 'landmark-1',
+        sceneName: '回潮旧灯塔',
+        actId: 'scene-act-1',
+        actTitle: '第一幕',
+        imageSrc:
+          '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
+        assetId: 'scene-asset-runtime',
+        status: 'ready',
+        nextPointCost: 0,
+      },
+    ],
+    allRoleAssetsReady: true,
+    allSceneAssetsReady: true,
+  } satisfies RpgAgentAssetCoverageSummary);
+}
+
+/**
+ * 已发布 profile fixture。
+ * 用于 preview compiler、works 聚合和 library 元数据解析测试。
+ */
+export function createRpgCreationPublishedProfileFixture(): CustomWorldProfileRecord {
+  const draft = createRpgAgentFoundationDraftProfileFixture();
+
+  return cloneFixture({
+    id: RPG_CREATION_FIXTURE_PROFILE_ID,
+    settingText: draft.worldHook,
+    name: draft.name,
+    subtitle: draft.subtitle,
+    summary: draft.summary,
+    tone: draft.tone,
+    playerGoal: draft.playerGoal,
+    templateWorldType: 'WUXIA',
+    compatibilityTemplateWorldType: 'WUXIA',
+    majorFactions: draft.majorFactions,
+    coreConflicts: draft.coreConflicts,
+    playableNpcs: draft.playableNpcs.map((role) => ({
+      id: role.id,
+      name: role.name,
+      title: role.title,
+      role: role.role,
+      description: role.publicIdentity,
+      backstory: role.hiddenHook || role.summary,
+      personality: role.publicMask || role.summary,
+      motivation: role.currentPressure,
+      combatStyle: '借地形和潮路换位，先拉扯再压近。',
+      initialAffinity: 18,
+      relationshipHooks: [role.relationToPlayer],
+      tags: ['潮路', '旧案'],
+      imageSrc: role.imageSrc,
+      generatedVisualAssetId: role.generatedVisualAssetId,
+      generatedAnimationSetId: role.generatedAnimationSetId,
+      animationMap: role.animationMap,
+      skills: [
+        {
+          id: 'skill-playable-1',
+          name: '潮行引路',
+          summary: '踩着旧潮阶切线前压，替队伍打开角度。',
+          style: '机动周旋',
+        },
+      ],
+      templateCharacterId: 'archer-hero',
+    })),
+    storyNpcs: draft.storyNpcs.map((role) => ({
+      id: role.id,
+      name: role.name,
+      title: role.title,
+      role: role.role,
+      description: role.publicIdentity,
+      backstory: role.hiddenHook || role.summary,
+      personality: role.publicMask || role.summary,
+      motivation: role.currentPressure,
+      combatStyle: '借塔顶视角和风向压制，再用灯火错位扰乱。',
+      initialAffinity: 8,
+      relationshipHooks: [role.relationToPlayer],
+      tags: ['守灯会', '灯塔'],
+      imageSrc: role.imageSrc,
+      generatedVisualAssetId: role.generatedVisualAssetId,
+      skills: [
+        {
+          id: 'skill-story-1',
+          name: '夜潮灯语',
+          summary: '借灯语与潮声干扰对方判断。',
+          style: '起手压制',
+        },
+      ],
+    })),
+    camp: {
+      name: draft.camp?.name,
+      description: draft.camp?.description,
+      dangerLevel: draft.camp?.dangerLevel,
+      imageSrc: draft.camp?.imageSrc,
+    },
+    landmarks: draft.landmarks.map((landmark) => ({
+      id: landmark.id,
+      name: landmark.name,
+      description: landmark.description,
+      dangerLevel: landmark.dangerLevel,
+      imageSrc: landmark.imageSrc,
+      sceneNpcIds: landmark.characterIds,
+      connections: [
+        {
+          targetLandmarkId: 'landmark-1',
+          relativePosition: 'forward',
+          summary: '沿着旧潮阶继续前压到雾栈尽头。',
+        },
+      ],
+    })),
+    cover: {
+      sourceType: 'default',
+      characterRoleIds: ['playable-1'],
+    },
+    sceneChapterBlueprints: draft.sceneChapters.map((chapter) => ({
+      id: chapter.id,
+      sceneId: chapter.sceneId,
+      sceneName: chapter.sceneName,
+      title: chapter.title,
+      summary: chapter.summary,
+      acts: chapter.acts.map((act) => ({
+        id: act.id,
+        title: act.title,
+        summary: act.summary,
+        backgroundImageSrc: act.backgroundImageSrc,
+        backgroundAssetId: act.backgroundAssetId,
+        encounterNpcIds: act.encounterNpcIds,
+        primaryNpcId: act.primaryNpcId,
+        actGoal: act.actGoal,
+        transitionHook: act.transitionHook,
+      })),
+    })),
+    themePack: draft.themePack,
+    storyGraph: draft.storyGraph,
+    scenarioPackId: 'scenario-pack:tide',
+    campaignPackId: 'campaign-pack:tide',
+    generationMode: 'fast',
+    generationStatus: 'key_only',
+    updatedAt: RPG_CREATION_FIXTURE_UPDATED_AT,
+    publishedAt: RPG_CREATION_FIXTURE_PUBLISHED_AT,
+  } satisfies CustomWorldProfileRecord);
+}
+
+export function createRpgCreationPreviewEnvelopeFixture(): RpgCreationPreviewEnvelope {
+  return cloneFixture({
+    preview: {
+      ...createRpgCreationPublishedProfileFixture(),
+      previewId: 'preview-fixture-1',
+      sessionId: RPG_CREATION_FIXTURE_SESSION_ID,
+      profileId: RPG_CREATION_FIXTURE_PROFILE_ID,
+    },
+    source: 'session_preview',
+    generatedAt: RPG_CREATION_FIXTURE_UPDATED_AT,
+    qualityFindings: [
+      {
+        id: 'finding-scene-asset-ready',
+        severity: 'info',
+        code: 'scene_asset_ready',
+        targetId: 'scene-act-1',
+        message: '首幕背景图已经就绪，可直接用于结果页预览。',
+      },
+    ],
+    blockers: [],
+    publishReady: true,
+    canEnterWorld: false,
+  } satisfies RpgCreationPreviewEnvelope);
+}
+
+export function createRpgAgentSupportedActionsFixture(): RpgAgentSupportedAction[] {
+  return cloneFixture([
+    {
+      action: 'draft_foundation',
+      enabled: true,
+    },
+    {
+      action: 'generate_role_assets',
+      enabled: true,
+    },
+    {
+      action: 'publish_world',
+      enabled: true,
+    },
+  ] satisfies RpgAgentSupportedAction[]);
+}
+
+/**
+ * 共享 session snapshot fixture。
+ * 默认模拟“底稿、预览、资产都已准备好”的 ready_to_publish 状态。
+ */
+export function createRpgAgentSessionFixture(): RpgAgentSessionSnapshot {
+  const draftProfile = createRpgAgentFoundationDraftProfileFixture();
+
+  return cloneFixture({
+    sessionId: RPG_CREATION_FIXTURE_SESSION_ID,
+    currentTurn: 6,
+    anchorContent: createRpgCreationAnchorContentFixture(),
+    progressPercent: 100,
+    lastAssistantReply: '八锚点与底稿都已经齐备，可以进入结果页收口。',
+    stage: 'ready_to_publish',
+    focusCardId: null,
+    creatorIntent: {
+      sourceMode: 'card',
+      rawSettingText: draftProfile.worldHook,
+      worldHook: draftProfile.worldHook,
+      playerPremise: draftProfile.playerPremise,
+      themeKeywords: ['海雾', '旧航路'],
+      toneDirectives: ['压抑', '悬疑'],
+      openingSituation: draftProfile.openingSituation,
+      coreConflicts: draftProfile.coreConflicts,
+      keyFactions: ['守灯会'],
+      keyCharacters: ['沈砺', '顾潮音'],
+      keyLandmarks: ['回潮旧灯塔'],
+      iconicElements: draftProfile.iconicElements,
+      forbiddenDirectives: ['不要出现现代枪械'],
+    },
+    creatorIntentReadiness: {
+      isReady: true,
+      completedKeys: [
+        'world_hook',
+        'player_premise',
+        'theme_and_tone',
+        'core_conflict',
+        'relationship_seed',
+        'iconic_element',
+      ],
+      missingKeys: [],
+    },
+    anchorPack: {
+      summary: draftProfile.sourceAnchorSummary,
+    },
+    lockState: {
+      lockedCardIds: ['world-foundation'],
+    },
+    draftProfile,
+    messages: [
+      {
+        id: 'message-1',
+        role: 'assistant',
+        kind: 'summary',
+        text: '世界底稿已整理完成，建议进入结果页确认资产与发布门槛。',
+        createdAt: RPG_CREATION_FIXTURE_UPDATED_AT,
+        relatedOperationId: null,
+      },
+    ],
+    draftCards: createRpgAgentDraftCardsFixture(),
+    pendingClarifications: [],
+    suggestedActions: [
+      {
+        id: 'action-publish',
+        type: 'publish_world',
+        label: '发布世界',
+      },
+    ],
+    recommendedReplies: ['先看结果页', '继续精修角色关系'],
+    qualityFindings: [
+      {
+        id: 'finding-scene-asset-ready',
+        severity: 'info',
+        code: 'scene_asset_ready',
+        targetId: 'scene-act-1',
+        message: '首幕背景图已经就绪，可直接用于结果页预览。',
+      },
+    ],
+    assetCoverage: createRpgAgentAssetCoverageFixture(),
+    checkpoints: [
+      {
+        checkpointId: 'checkpoint-foundation-v1',
+        createdAt: RPG_CREATION_FIXTURE_UPDATED_AT,
+        label: '世界底稿 V1',
+      },
+    ],
+    supportedActions: createRpgAgentSupportedActionsFixture(),
+    resultPreview: createRpgCreationPreviewEnvelopeFixture(),
+    updatedAt: RPG_CREATION_FIXTURE_UPDATED_AT,
+  } satisfies RpgAgentSessionSnapshot);
+}
+
+export function createRpgWorldLibraryEntryFixture(): CustomWorldLibraryEntry<CustomWorldProfileRecord> {
+  const profile = createRpgCreationPublishedProfileFixture();
+
+  return cloneFixture({
+    ownerUserId: RPG_CREATION_FIXTURE_USER_ID,
+    profileId: RPG_CREATION_FIXTURE_PROFILE_ID,
+    profile,
+    visibility: 'published',
+    publishedAt: RPG_CREATION_FIXTURE_PUBLISHED_AT,
+    updatedAt: RPG_CREATION_FIXTURE_UPDATED_AT,
+    authorDisplayName: '测试玩家',
+    worldName: String(profile.name ?? '潮雾列岛'),
+    subtitle: String(profile.subtitle ?? '旧灯塔与失控航路'),
+    summaryText: String(profile.summary ?? '第一版世界底稿已经整理完成。'),
+    coverImageSrc:
+      '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
+    themeMode: 'tide',
+    playableNpcCount: Array.isArray(profile.playableNpcs)
+      ? profile.playableNpcs.length
+      : 0,
+    landmarkCount: Array.isArray(profile.landmarks)
+      ? profile.landmarks.length
+      : 0,
+  } satisfies CustomWorldLibraryEntry<CustomWorldProfileRecord>);
+}
+
+export function createRpgCreationWorksResponseFixture(): ListRpgCreationWorksResponse {
+  return cloneFixture({
+    items: [
+      {
+        workId: `draft:${RPG_CREATION_FIXTURE_SESSION_ID}`,
+        sourceType: 'agent_session',
+        status: 'draft',
+        title: '潮雾列岛',
+        subtitle: '旧灯塔与失控航路',
+        summary: '第一版世界底稿已经整理完成，玩家将从回潮旧灯塔切入沉船旧案。',
+        coverImageSrc: '/custom/camp/huichao.png',
+        coverRenderMode: 'scene_with_roles',
+        coverCharacterImageSrcs: [
+          '/generated-characters/playable-1/visual/asset-runtime/master.png',
+        ],
+        updatedAt: RPG_CREATION_FIXTURE_UPDATED_AT,
+        publishedAt: null,
+        stage: 'ready_to_publish',
+        stageLabel: '准备发布',
+        playableNpcCount: 2,
+        landmarkCount: 1,
+        roleVisualReadyCount: 2,
+        roleAnimationReadyCount: 2,
+        roleAssetSummaryLabel: '沈砺 · 动作已就绪',
+        sessionId: RPG_CREATION_FIXTURE_SESSION_ID,
+        profileId: null,
+        canResume: true,
+        canEnterWorld: false,
+        blockerCount: 0,
+        publishReady: true,
+      },
+      {
+        workId: `published:${RPG_CREATION_FIXTURE_PROFILE_ID}`,
+        sourceType: 'published_profile',
+        status: 'published',
+        title: '潮雾列岛',
+        subtitle: '旧灯塔与失控航路',
+        summary: '第一版世界底稿已经整理完成，玩家将从回潮旧灯塔切入沉船旧案。',
+        coverImageSrc:
+          '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
+        coverRenderMode: 'scene_with_roles',
+        coverCharacterImageSrcs: [
+          '/generated-characters/playable-1/visual/asset-runtime/master.png',
+        ],
+        updatedAt: RPG_CREATION_FIXTURE_UPDATED_AT,
+        publishedAt: RPG_CREATION_FIXTURE_PUBLISHED_AT,
+        stage: 'published',
+        stageLabel: '已发布',
+        playableNpcCount: 1,
+        landmarkCount: 1,
+        roleVisualReadyCount: 1,
+        roleAnimationReadyCount: 1,
+        roleAssetSummaryLabel: '动作已就绪 1',
+        sessionId: null,
+        profileId: RPG_CREATION_FIXTURE_PROFILE_ID,
+        canResume: false,
+        canEnterWorld: true,
+        blockerCount: 0,
+        publishReady: true,
+      },
+    ] satisfies RpgCreationWorkSummary[],
+  } satisfies ListRpgCreationWorksResponse);
+}
diff --git a/packages/shared/src/contracts/rpgCreationPreview.ts b/packages/shared/src/contracts/rpgCreationPreview.ts
index 317488a2..2c1c8e88 100644
--- a/packages/shared/src/contracts/rpgCreationPreview.ts
+++ b/packages/shared/src/contracts/rpgCreationPreview.ts
@@ -1,12 +1,40 @@
 import type { CustomWorldProfileRecord } from './runtime';
 
 /**
- * 工作包 A 先建立 RPG 创作结果预览契约骨架。
- * 在服务端 preview compiler 正式落地前，这里继续把旧的世界 profile 视为兼容预览载体。
+ * 结果页预览契约。
+ * 当前 preview 仍以兼容 profile 作为承载体，但已经把来源、阻断项和质量结论从 session 草稿里显式剥离出来。
  */
-export type RpgCreationPreview = CustomWorldProfileRecord;
 
-export type RpgCreationPreviewEnvelope = {
-  preview: RpgCreationPreview;
-  source: 'legacy_custom_world_profile';
+export type RpgCreationPreviewSource =
+  | 'session_preview'
+  | 'published_profile';
+
+export interface RpgCreationPreviewFinding {
+  id: string;
+  severity: 'info' | 'warning' | 'blocker';
+  code: string;
+  targetId?: string | null;
+  message: string;
+}
+
+export interface RpgCreationPreviewBlocker {
+  id: string;
+  code: string;
+  message: string;
+}
+
+export type RpgCreationPreview = CustomWorldProfileRecord & {
+  previewId?: string;
+  sessionId?: string | null;
+  profileId?: string | null;
 };
+
+export interface RpgCreationPreviewEnvelope {
+  preview: RpgCreationPreview;
+  source: RpgCreationPreviewSource;
+  generatedAt?: string;
+  qualityFindings?: RpgCreationPreviewFinding[];
+  blockers?: RpgCreationPreviewBlocker[];
+  publishReady?: boolean;
+  canEnterWorld?: boolean;
+}
diff --git a/packages/shared/src/contracts/rpgCreationWorkSummary.ts b/packages/shared/src/contracts/rpgCreationWorkSummary.ts
index 9a874229..eef1b69c 100644
--- a/packages/shared/src/contracts/rpgCreationWorkSummary.ts
+++ b/packages/shared/src/contracts/rpgCreationWorkSummary.ts
@@ -1,6 +1,38 @@
-export type {
-  ListCustomWorldWorksResponse as ListRpgCreationWorksResponse,
-  CustomWorldWorkSource as RpgCreationWorkSource,
-  CustomWorldWorkStatus as RpgCreationWorkStatus,
-  CustomWorldWorkSummary as RpgCreationWorkSummary,
-} from './customWorldAgent';
+/**
+ * RPG 创作作品卡读模型契约。
+ * works 列表只暴露继续创作与进入世界判断所需的稳定字段。
+ */
+
+export type RpgCreationWorkStatus = 'draft' | 'published';
+export type RpgCreationWorkSource = 'agent_session' | 'published_profile';
+
+export interface RpgCreationWorkSummary {
+  workId: string;
+  sourceType: RpgCreationWorkSource;
+  status: RpgCreationWorkStatus;
+  title: string;
+  subtitle: string;
+  summary: string;
+  coverImageSrc?: string | null;
+  coverRenderMode?: 'image' | 'scene_with_roles';
+  coverCharacterImageSrcs?: string[];
+  updatedAt: string;
+  publishedAt?: string | null;
+  stage?: string | null;
+  stageLabel?: string | null;
+  playableNpcCount: number;
+  landmarkCount: number;
+  roleVisualReadyCount?: number;
+  roleAnimationReadyCount?: number;
+  roleAssetSummaryLabel?: string | null;
+  sessionId?: string | null;
+  profileId?: string | null;
+  canResume: boolean;
+  canEnterWorld: boolean;
+  blockerCount?: number;
+  publishReady?: boolean;
+}
+
+export interface ListRpgCreationWorksResponse {
+  items: RpgCreationWorkSummary[];
+}
diff --git a/packages/shared/src/contracts/rpgRuntimeChat.ts b/packages/shared/src/contracts/rpgRuntimeChat.ts
new file mode 100644
index 00000000..a08dff5c
--- /dev/null
+++ b/packages/shared/src/contracts/rpgRuntimeChat.ts
@@ -0,0 +1,184 @@
+/**
+ * RPG 运行时聊天相关共享契约。
+ * 将角色聊天、NPC 对话与轻量 story 请求载荷从旧 story.ts 中独立出来。
+ */
+import type { JsonObject } from './common';
+
+export type NpcChatTurnLimitReason = 'negative_affinity';
+
+export type NpcChatTurnClosingMode = 'free' | 'foreshadow_close';
+
+export type NpcChatTurnDirective = {
+  sceneActId?: string | null;
+  turnLimit?: number | null;
+  remainingTurns?: number | null;
+  limitReason?: NpcChatTurnLimitReason | null;
+  closingMode?: NpcChatTurnClosingMode | null;
+  forceExitAfterTurn?: boolean;
+};
+
+export type NpcChatTurnCompletionDirective = {
+  turnLimit?: number | null;
+  remainingTurns?: number | null;
+  forceExit?: boolean;
+  closingMode?: NpcChatTurnClosingMode;
+};
+
+export type CharacterChatReplyRequest<
+  TCharacter = unknown,
+  TStoryMoment = unknown,
+  TContext = unknown,
+  TConversationTurn = unknown,
+  TTargetStatus = unknown,
+> = {
+  worldType: string;
+  playerCharacter: TCharacter;
+  targetCharacter: TCharacter;
+  storyHistory: TStoryMoment[];
+  context: TContext;
+  conversationHistory: TConversationTurn[];
+  conversationSummary: string;
+  playerMessage: string;
+  targetStatus: TTargetStatus;
+};
+
+export type CharacterChatSuggestionsRequest<
+  TCharacter = unknown,
+  TStoryMoment = unknown,
+  TContext = unknown,
+  TConversationTurn = unknown,
+  TTargetStatus = unknown,
+> = {
+  worldType: string;
+  playerCharacter: TCharacter;
+  targetCharacter: TCharacter;
+  storyHistory: TStoryMoment[];
+  context: TContext;
+  conversationHistory: TConversationTurn[];
+  conversationSummary: string;
+  targetStatus: TTargetStatus;
+};
+
+export type CharacterChatSummaryRequest<
+  TCharacter = unknown,
+  TStoryMoment = unknown,
+  TContext = unknown,
+  TConversationTurn = unknown,
+  TTargetStatus = unknown,
+> = {
+  worldType: string;
+  playerCharacter: TCharacter;
+  targetCharacter: TCharacter;
+  storyHistory: TStoryMoment[];
+  context: TContext;
+  conversationHistory: TConversationTurn[];
+  previousSummary: string;
+  targetStatus: TTargetStatus;
+};
+
+export type NpcChatDialogueRequest<
+  TCharacter = unknown,
+  TEncounter = unknown,
+  TMonster = unknown,
+  TStoryMoment = unknown,
+  TContext = unknown,
+> = {
+  worldType: string;
+  character: TCharacter;
+  encounter: TEncounter;
+  monsters: TMonster[];
+  history: TStoryMoment[];
+  context: TContext;
+  topic: string;
+  resultSummary: string;
+  npcInitiatesConversation?: boolean;
+};
+
+export type NpcChatTurnRequest<
+  TCharacter = unknown,
+  TEncounter = unknown,
+  TMonster = unknown,
+  TStoryMoment = unknown,
+  TContext = unknown,
+  TConversationTurn = unknown,
+  TCombatContext = unknown,
+  TNpcState = unknown,
+  TQuestOfferState = unknown,
+  TQuestOfferEncounter = unknown,
+  TChatDirective = NpcChatTurnDirective,
+> = {
+  worldType: string;
+  character?: TCharacter;
+  player?: TCharacter;
+  encounter: TEncounter;
+  monsters: TMonster[];
+  history: TStoryMoment[];
+  context: TContext;
+  conversationHistory?: TConversationTurn[];
+  dialogue?: TConversationTurn[];
+  combatContext?: TCombatContext | null;
+  playerMessage: string;
+  npcState: TNpcState;
+  npcInitiatesConversation?: boolean;
+  questOfferContext?: {
+    state: TQuestOfferState;
+    encounter: TQuestOfferEncounter;
+    turnCount: number;
+  } | null;
+  chatDirective?: TChatDirective | null;
+};
+
+export type NpcChatPendingQuestOffer<TQuest = unknown> = {
+  quest: TQuest;
+  introText?: string;
+};
+
+export type NpcChatTurnResult<TQuest = unknown> = {
+  npcReply: string;
+  affinityDelta: number;
+  affinityText: string;
+  suggestions: string[];
+  pendingQuestOffer?: NpcChatPendingQuestOffer<TQuest> | null;
+  chatDirective?: NpcChatTurnCompletionDirective | null;
+};
+
+export type NpcRecruitDialogueRequest<
+  TCharacter = unknown,
+  TEncounter = unknown,
+  TMonster = unknown,
+  TStoryMoment = unknown,
+  TContext = unknown,
+> = {
+  worldType: string;
+  character: TCharacter;
+  encounter: TEncounter;
+  monsters: TMonster[];
+  history: TStoryMoment[];
+  context: TContext;
+  invitationText: string;
+  recruitSummary: string;
+};
+
+export type StoryRequestOptionsPayload = {
+  availableOptions?: JsonObject[];
+  optionCatalog?: JsonObject[];
+};
+
+export type StoryRequestPayload<TWorldType extends string = string> = {
+  worldType: TWorldType;
+  character: JsonObject;
+  monsters?: JsonObject[];
+  history?: JsonObject[];
+  choice?: string;
+  context: JsonObject;
+  requestOptions?: StoryRequestOptionsPayload;
+};
+
+export type PlainTextPromptRequest = {
+  systemPrompt: string;
+  userPrompt: string;
+};
+
+export type PlainTextResponse = {
+  text: string;
+};
diff --git a/packages/shared/src/contracts/rpgRuntimeContracts.test.ts b/packages/shared/src/contracts/rpgRuntimeContracts.test.ts
new file mode 100644
index 00000000..e1e8fff0
--- /dev/null
+++ b/packages/shared/src/contracts/rpgRuntimeContracts.test.ts
@@ -0,0 +1,51 @@
+import { describe, expect, test } from 'vitest';
+
+import {
+  CharacterChatReplyRequest,
+  QUEST_NARRATIVE_TYPES,
+  RuntimeStoryActionRequest,
+  SERVER_RUNTIME_FUNCTION_IDS,
+  TASK6_RUNTIME_FUNCTION_IDS,
+} from './story';
+import { TASK5_RUNTIME_OPTION_SCOPES } from './rpgRuntimeStoryAction';
+import type { RuntimeStoryStateRequest } from './rpgRuntimeStoryState';
+
+describe('RPG runtime shared contract façades', () => {
+  test('旧 story façade 继续导出 runtime story action 常量与类型', () => {
+    expect(SERVER_RUNTIME_FUNCTION_IDS).toContain('npc_chat');
+    expect(TASK6_RUNTIME_FUNCTION_IDS).toContain('npc_trade');
+    expect(TASK5_RUNTIME_OPTION_SCOPES).toEqual(['story', 'combat', 'npc']);
+
+    const request: RuntimeStoryActionRequest = {
+      sessionId: 'runtime-session-1',
+      action: {
+        type: 'story_choice',
+        functionId: 'npc_chat',
+      },
+    };
+
+    expect(request.action.functionId).toBe('npc_chat');
+  });
+
+  test('旧 story façade 继续导出 chat 与 quest assist 契约', () => {
+    const payload: CharacterChatReplyRequest = {
+      worldType: 'WUXIA',
+      playerCharacter: {},
+      targetCharacter: {},
+      storyHistory: [],
+      context: {},
+      conversationHistory: [],
+      conversationSummary: '测试摘要',
+      playerMessage: '近况如何？',
+      targetStatus: {},
+    };
+
+    const stateRequest: RuntimeStoryStateRequest = {
+      sessionId: 'runtime-session-2',
+    };
+
+    expect(payload.playerMessage).toBe('近况如何？');
+    expect(stateRequest.sessionId).toBe('runtime-session-2');
+    expect(QUEST_NARRATIVE_TYPES).toContain('relationship');
+  });
+});
diff --git a/packages/shared/src/contracts/rpgRuntimeQuestAssist.ts b/packages/shared/src/contracts/rpgRuntimeQuestAssist.ts
new file mode 100644
index 00000000..03d44ca1
--- /dev/null
+++ b/packages/shared/src/contracts/rpgRuntimeQuestAssist.ts
@@ -0,0 +1,83 @@
+/**
+ * RPG 运行时任务辅助与道具意图共享契约。
+ * 该文件只承载 quest / runtime item 辅助类型，不混入 runtime story 主状态。
+ */
+import type { JsonObject } from './common';
+
+export const QUEST_NARRATIVE_TYPES = [
+  'bounty',
+  'escort',
+  'investigation',
+  'retrieval',
+  'relationship',
+  'trial',
+] as const;
+export type SharedQuestNarrativeType = (typeof QUEST_NARRATIVE_TYPES)[number];
+
+export const QUEST_OBJECTIVE_KINDS = [
+  'defeat_hostile_npc',
+  'inspect_treasure',
+  'spar_with_npc',
+  'talk_to_npc',
+  'reach_scene',
+  'deliver_item',
+] as const;
+export type SharedQuestObjectiveKind = (typeof QUEST_OBJECTIVE_KINDS)[number];
+
+export const QUEST_URGENCY_LEVELS = ['low', 'medium', 'high'] as const;
+export type SharedQuestUrgency = (typeof QUEST_URGENCY_LEVELS)[number];
+
+export const QUEST_INTIMACY_LEVELS = [
+  'transactional',
+  'cooperative',
+  'trust_based',
+] as const;
+export type SharedQuestIntimacy = (typeof QUEST_INTIMACY_LEVELS)[number];
+
+export const QUEST_REWARD_THEMES = [
+  'currency',
+  'resource',
+  'relationship',
+  'intel',
+  'rare_item',
+] as const;
+export type SharedQuestRewardTheme = (typeof QUEST_REWARD_THEMES)[number];
+
+export const RUNTIME_ITEM_FUNCTIONAL_BIAS_VALUES = [
+  'heal',
+  'mana',
+  'cooldown',
+  'guard',
+  'damage',
+] as const;
+export type SharedRuntimeItemFunctionalBias =
+  (typeof RUNTIME_ITEM_FUNCTIONAL_BIAS_VALUES)[number];
+
+export const RUNTIME_ITEM_TONE_VALUES = [
+  'grim',
+  'mysterious',
+  'martial',
+  'ritual',
+  'survival',
+] as const;
+export type SharedRuntimeItemTone = (typeof RUNTIME_ITEM_TONE_VALUES)[number];
+
+export type RuntimeItemIntentRequest<
+  TContext = JsonObject,
+  TPlan = JsonObject,
+> = {
+  context: TContext;
+  plans: TPlan[];
+};
+
+export type RuntimeItemIntentResponse<TIntent = JsonObject> = {
+  intents: TIntent[];
+};
+
+export type QuestGenerationRequest<
+  TState = JsonObject,
+  TEncounter = JsonObject,
+> = {
+  state: TState;
+  encounter: TEncounter;
+};
diff --git a/packages/shared/src/contracts/rpgRuntimeStoryAction.ts b/packages/shared/src/contracts/rpgRuntimeStoryAction.ts
new file mode 100644
index 00000000..12d320bd
--- /dev/null
+++ b/packages/shared/src/contracts/rpgRuntimeStoryAction.ts
@@ -0,0 +1,136 @@
+/**
+ * RPG runtime story 动作层共享契约。
+ * 将 function id、动作请求与交互元数据从旧 story.ts 中单独收口。
+ */
+import type { JsonObject } from './common';
+
+export type RuntimeAction<
+  TType extends string = string,
+  TPayload = JsonObject,
+> = {
+  type: TType;
+  functionId?: string;
+  targetId?: string;
+  payload?: TPayload;
+};
+
+export type RuntimeActionRequest<
+  TAction extends RuntimeAction = RuntimeAction,
+> = {
+  sessionId: string;
+  clientVersion?: number;
+  action: TAction;
+};
+
+export type RuntimeActionResponse<
+  TViewModel = JsonObject,
+  TPresentation = JsonObject,
+  TPatch = JsonObject,
+> = {
+  sessionId: string;
+  serverVersion: number;
+  viewModel: TViewModel;
+  presentation: TPresentation;
+  patches: TPatch[];
+};
+
+export const TASK5_RUNTIME_FUNCTION_IDS = [
+  'story_continue_adventure',
+  'story_opening_camp_dialogue',
+  'camp_travel_home_scene',
+  'idle_call_out',
+  'idle_explore_forward',
+  'idle_observe_signs',
+  'idle_rest_focus',
+  'idle_travel_next_scene',
+  'battle_attack_basic',
+  'battle_use_skill',
+  'battle_all_in_crush',
+  'battle_escape_breakout',
+  'battle_feint_step',
+  'battle_finisher_window',
+  'battle_guard_break',
+  'battle_probe_pressure',
+  'battle_recover_breath',
+  'npc_chat',
+  'npc_fight',
+  'npc_help',
+  'npc_leave',
+  'npc_preview_talk',
+  'npc_recruit',
+  'npc_spar',
+] as const;
+export type Task5RuntimeFunctionId =
+  (typeof TASK5_RUNTIME_FUNCTION_IDS)[number];
+
+export const TASK6_RUNTIME_FUNCTION_IDS = [
+  'equipment_equip',
+  'equipment_unequip',
+  'forge_craft',
+  'forge_dismantle',
+  'forge_reforge',
+  'inventory_use',
+  'npc_gift',
+  'npc_chat_quest_offer_abandon',
+  'npc_chat_quest_offer_replace',
+  'npc_chat_quest_offer_view',
+  'npc_quest_accept',
+  'npc_quest_turn_in',
+  'npc_trade',
+  'treasure_inspect',
+  'treasure_leave',
+  'treasure_secure',
+] as const;
+export type Task6RuntimeFunctionId =
+  (typeof TASK6_RUNTIME_FUNCTION_IDS)[number];
+
+export const SERVER_RUNTIME_FUNCTION_IDS = [
+  ...TASK5_RUNTIME_FUNCTION_IDS,
+  ...TASK6_RUNTIME_FUNCTION_IDS,
+] as const;
+export type ServerRuntimeFunctionId =
+  (typeof SERVER_RUNTIME_FUNCTION_IDS)[number];
+
+export const TASK5_RUNTIME_OPTION_SCOPES = ['story', 'combat', 'npc'] as const;
+export type Task5RuntimeOptionScope =
+  (typeof TASK5_RUNTIME_OPTION_SCOPES)[number];
+
+export type RuntimeStoryChoicePayload = JsonObject & {
+  optionText?: string;
+  note?: string;
+  releaseNpcId?: string;
+  preludeText?: string;
+};
+
+export type RuntimeStoryOptionInteraction =
+  | {
+      kind: 'npc';
+      npcId: string;
+      action:
+        | 'chat'
+        | 'help'
+        | 'fight'
+        | 'leave'
+        | 'quest_offer_abandon'
+        | 'quest_offer_replace'
+        | 'quest_offer_view'
+        | 'recruit'
+        | 'spar'
+        | 'trade'
+        | 'gift'
+        | 'quest_accept'
+        | 'quest_turn_in';
+      questId?: string;
+    }
+  | {
+      kind: 'treasure';
+      action: 'inspect' | 'leave' | 'secure';
+    };
+
+export type RuntimeStoryChoiceAction = RuntimeAction<
+  'story_choice',
+  RuntimeStoryChoicePayload
+> & {
+  functionId: string;
+  targetId?: string;
+};
diff --git a/packages/shared/src/contracts/rpgRuntimeStoryState.ts b/packages/shared/src/contracts/rpgRuntimeStoryState.ts
new file mode 100644
index 00000000..ab6b4fe9
--- /dev/null
+++ b/packages/shared/src/contracts/rpgRuntimeStoryState.ts
@@ -0,0 +1,146 @@
+/**
+ * RPG runtime story 状态与响应共享契约。
+ * 该文件只负责 view model、presentation、patch 与 snapshot 回包结构。
+ */
+import type { JsonObject } from './common';
+import type { SavedGameSnapshot, SavedGameSnapshotInput } from './runtime';
+import type {
+  RuntimeActionRequest,
+  RuntimeActionResponse,
+  RuntimeStoryChoiceAction,
+  RuntimeStoryChoicePayload,
+  RuntimeStoryOptionInteraction,
+  Task5RuntimeOptionScope,
+} from './rpgRuntimeStoryAction';
+
+export type RuntimeStoryOptionView = {
+  functionId: string;
+  actionText: string;
+  detailText?: string;
+  scope: Task5RuntimeOptionScope;
+  interaction?: RuntimeStoryOptionInteraction;
+  payload?: RuntimeStoryChoicePayload;
+  disabled?: boolean;
+  reason?: string;
+};
+
+export type RuntimeStoryPlayerViewModel = {
+  hp: number;
+  maxHp: number;
+  mana: number;
+  maxMana: number;
+};
+
+export type RuntimeStoryCompanionViewModel = {
+  npcId: string;
+  characterId?: string;
+  joinedAtAffinity: number;
+};
+
+export type RuntimeStoryEncounterViewModel = {
+  id: string;
+  kind: 'npc' | 'treasure';
+  npcName: string;
+  hostile: boolean;
+  affinity?: number;
+  recruited?: boolean;
+  interactionActive: boolean;
+  battleMode?: 'fight' | 'spar' | null;
+};
+
+export type RuntimeStoryStatusViewModel = {
+  inBattle: boolean;
+  npcInteractionActive: boolean;
+  currentNpcBattleMode: 'fight' | 'spar' | null;
+  currentNpcBattleOutcome: 'fight_victory' | 'spar_complete' | null;
+};
+
+export type RuntimeBattlePresentation = {
+  targetId?: string;
+  targetName?: string;
+  damageDealt?: number;
+  damageTaken?: number;
+  outcome?: 'ongoing' | 'victory' | 'spar_complete' | 'escaped';
+};
+
+export type RuntimeStoryViewModel = {
+  player: RuntimeStoryPlayerViewModel;
+  encounter: RuntimeStoryEncounterViewModel | null;
+  companions: RuntimeStoryCompanionViewModel[];
+  availableOptions: RuntimeStoryOptionView[];
+  status: RuntimeStoryStatusViewModel;
+};
+
+export type RuntimeStoryPresentation = {
+  actionText: string;
+  resultText: string;
+  storyText: string;
+  options: RuntimeStoryOptionView[];
+  toast?: string | null;
+  battle?: RuntimeBattlePresentation | null;
+};
+
+export type RuntimeStoryPatch =
+  | {
+      type: 'story_history_append';
+      actionText: string;
+      resultText: string;
+    }
+  | {
+      type: 'npc_affinity_changed';
+      npcId: string;
+      previousAffinity: number;
+      nextAffinity: number;
+    }
+  | {
+      type: 'battle_resolved';
+      functionId: string;
+      targetId?: string;
+      damageDealt?: number;
+      damageTaken?: number;
+      outcome: 'ongoing' | 'victory' | 'spar_complete' | 'escaped';
+    }
+  | {
+      type: 'status_changed';
+      inBattle: boolean;
+      npcInteractionActive: boolean;
+      currentNpcBattleMode: 'fight' | 'spar' | null;
+      currentNpcBattleOutcome: 'fight_victory' | 'spar_complete' | null;
+    }
+  | {
+      type: 'encounter_changed';
+      encounterId: string | null;
+    };
+
+export type RuntimeStoryActionRequest =
+  RuntimeActionRequest<RuntimeStoryChoiceAction> & {
+    snapshot?: SavedGameSnapshotInput;
+  };
+
+export type RuntimeStoryStateRequest<
+  TSnapshotGameState = JsonObject,
+  TSnapshotCurrentStory = JsonObject,
+> = {
+  sessionId: string;
+  clientVersion?: number;
+  snapshot?: SavedGameSnapshotInput<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
+};
+
+export type RuntimeStoryActionResponse<
+  TSnapshotGameState = JsonObject,
+  TSnapshotCurrentStory = JsonObject,
+> = RuntimeActionResponse<
+  RuntimeStoryViewModel,
+  RuntimeStoryPresentation,
+  RuntimeStoryPatch
+> & {
+  snapshot: SavedGameSnapshot<
+    TSnapshotGameState,
+    string,
+    TSnapshotCurrentStory
+  >;
+};
diff --git a/packages/shared/src/contracts/story.ts b/packages/shared/src/contracts/story.ts
deleted file mode 100644
index 025a0c1f..00000000
--- a/packages/shared/src/contracts/story.ts
+++ /dev/null
@@ -1,520 +0,0 @@
-import type { JsonObject } from './common';
-import type { SavedGameSnapshot } from './runtime';
-
-export const QUEST_NARRATIVE_TYPES = [
-  'bounty',
-  'escort',
-  'investigation',
-  'retrieval',
-  'relationship',
-  'trial',
-] as const;
-export type SharedQuestNarrativeType = (typeof QUEST_NARRATIVE_TYPES)[number];
-
-export const QUEST_OBJECTIVE_KINDS = [
-  'defeat_hostile_npc',
-  'inspect_treasure',
-  'spar_with_npc',
-  'talk_to_npc',
-  'reach_scene',
-  'deliver_item',
-] as const;
-export type SharedQuestObjectiveKind = (typeof QUEST_OBJECTIVE_KINDS)[number];
-
-export const QUEST_URGENCY_LEVELS = ['low', 'medium', 'high'] as const;
-export type SharedQuestUrgency = (typeof QUEST_URGENCY_LEVELS)[number];
-
-export const QUEST_INTIMACY_LEVELS = [
-  'transactional',
-  'cooperative',
-  'trust_based',
-] as const;
-export type SharedQuestIntimacy = (typeof QUEST_INTIMACY_LEVELS)[number];
-
-export const QUEST_REWARD_THEMES = [
-  'currency',
-  'resource',
-  'relationship',
-  'intel',
-  'rare_item',
-] as const;
-export type SharedQuestRewardTheme = (typeof QUEST_REWARD_THEMES)[number];
-
-export const RUNTIME_ITEM_FUNCTIONAL_BIAS_VALUES = [
-  'heal',
-  'mana',
-  'cooldown',
-  'guard',
-  'damage',
-] as const;
-export type SharedRuntimeItemFunctionalBias =
-  (typeof RUNTIME_ITEM_FUNCTIONAL_BIAS_VALUES)[number];
-
-export const RUNTIME_ITEM_TONE_VALUES = [
-  'grim',
-  'mysterious',
-  'martial',
-  'ritual',
-  'survival',
-] as const;
-export type SharedRuntimeItemTone = (typeof RUNTIME_ITEM_TONE_VALUES)[number];
-
-export type StoryRequestOptionsPayload = {
-  availableOptions?: JsonObject[];
-  optionCatalog?: JsonObject[];
-};
-
-export type StoryRequestPayload<TWorldType extends string = string> = {
-  worldType: TWorldType;
-  character: JsonObject;
-  monsters?: JsonObject[];
-  history?: JsonObject[];
-  choice?: string;
-  context: JsonObject;
-  requestOptions?: StoryRequestOptionsPayload;
-};
-
-export type PlainTextPromptRequest = {
-  systemPrompt: string;
-  userPrompt: string;
-};
-
-export type PlainTextResponse = {
-  text: string;
-};
-
-export type NpcChatTurnLimitReason = 'negative_affinity';
-
-export type NpcChatTurnClosingMode = 'free' | 'foreshadow_close';
-
-export type NpcChatTurnDirective = {
-  sceneActId?: string | null;
-  turnLimit?: number | null;
-  remainingTurns?: number | null;
-  limitReason?: NpcChatTurnLimitReason | null;
-  closingMode?: NpcChatTurnClosingMode | null;
-  forceExitAfterTurn?: boolean;
-};
-
-export type NpcChatTurnCompletionDirective = {
-  turnLimit?: number | null;
-  remainingTurns?: number | null;
-  forceExit?: boolean;
-  closingMode?: NpcChatTurnClosingMode;
-};
-
-export type CharacterChatReplyRequest<
-  TCharacter = unknown,
-  TStoryMoment = unknown,
-  TContext = unknown,
-  TConversationTurn = unknown,
-  TTargetStatus = unknown,
-> = {
-  worldType: string;
-  playerCharacter: TCharacter;
-  targetCharacter: TCharacter;
-  storyHistory: TStoryMoment[];
-  context: TContext;
-  conversationHistory: TConversationTurn[];
-  conversationSummary: string;
-  playerMessage: string;
-  targetStatus: TTargetStatus;
-};
-
-export type CharacterChatSuggestionsRequest<
-  TCharacter = unknown,
-  TStoryMoment = unknown,
-  TContext = unknown,
-  TConversationTurn = unknown,
-  TTargetStatus = unknown,
-> = {
-  worldType: string;
-  playerCharacter: TCharacter;
-  targetCharacter: TCharacter;
-  storyHistory: TStoryMoment[];
-  context: TContext;
-  conversationHistory: TConversationTurn[];
-  conversationSummary: string;
-  targetStatus: TTargetStatus;
-};
-
-export type CharacterChatSummaryRequest<
-  TCharacter = unknown,
-  TStoryMoment = unknown,
-  TContext = unknown,
-  TConversationTurn = unknown,
-  TTargetStatus = unknown,
-> = {
-  worldType: string;
-  playerCharacter: TCharacter;
-  targetCharacter: TCharacter;
-  storyHistory: TStoryMoment[];
-  context: TContext;
-  conversationHistory: TConversationTurn[];
-  previousSummary: string;
-  targetStatus: TTargetStatus;
-};
-
-export type NpcChatDialogueRequest<
-  TCharacter = unknown,
-  TEncounter = unknown,
-  TMonster = unknown,
-  TStoryMoment = unknown,
-  TContext = unknown,
-> = {
-  worldType: string;
-  character: TCharacter;
-  encounter: TEncounter;
-  monsters: TMonster[];
-  history: TStoryMoment[];
-  context: TContext;
-  topic: string;
-  resultSummary: string;
-  npcInitiatesConversation?: boolean;
-};
-
-export type NpcChatTurnRequest<
-  TCharacter = unknown,
-  TEncounter = unknown,
-  TMonster = unknown,
-  TStoryMoment = unknown,
-  TContext = unknown,
-  TConversationTurn = unknown,
-  TCombatContext = unknown,
-  TNpcState = unknown,
-  TQuestOfferState = unknown,
-  TQuestOfferEncounter = unknown,
-  TChatDirective = NpcChatTurnDirective,
-> = {
-  worldType: string;
-  character?: TCharacter;
-  player?: TCharacter;
-  encounter: TEncounter;
-  monsters: TMonster[];
-  history: TStoryMoment[];
-  context: TContext;
-  conversationHistory?: TConversationTurn[];
-  dialogue?: TConversationTurn[];
-  combatContext?: TCombatContext | null;
-  playerMessage: string;
-  npcState: TNpcState;
-  npcInitiatesConversation?: boolean;
-  questOfferContext?: {
-    state: TQuestOfferState;
-    encounter: TQuestOfferEncounter;
-    turnCount: number;
-  } | null;
-  chatDirective?: TChatDirective | null;
-};
-
-export type NpcChatPendingQuestOffer<TQuest = unknown> = {
-  quest: TQuest;
-  introText?: string;
-};
-
-export type NpcChatTurnResult<TQuest = unknown> = {
-  npcReply: string;
-  affinityDelta: number;
-  affinityText: string;
-  suggestions: string[];
-  pendingQuestOffer?: NpcChatPendingQuestOffer<TQuest> | null;
-  chatDirective?: NpcChatTurnCompletionDirective | null;
-};
-
-export type NpcRecruitDialogueRequest<
-  TCharacter = unknown,
-  TEncounter = unknown,
-  TMonster = unknown,
-  TStoryMoment = unknown,
-  TContext = unknown,
-> = {
-  worldType: string;
-  character: TCharacter;
-  encounter: TEncounter;
-  monsters: TMonster[];
-  history: TStoryMoment[];
-  context: TContext;
-  invitationText: string;
-  recruitSummary: string;
-};
-
-export type RuntimeItemIntentRequest<
-  TContext = JsonObject,
-  TPlan = JsonObject,
-> = {
-  context: TContext;
-  plans: TPlan[];
-};
-
-export type RuntimeItemIntentResponse<TIntent = JsonObject> = {
-  intents: TIntent[];
-};
-
-export type QuestGenerationRequest<
-  TState = JsonObject,
-  TEncounter = JsonObject,
-> = {
-  state: TState;
-  encounter: TEncounter;
-};
-
-export type RuntimeAction<
-  TType extends string = string,
-  TPayload = JsonObject,
-> = {
-  type: TType;
-  functionId?: string;
-  targetId?: string;
-  payload?: TPayload;
-};
-
-export type RuntimeActionRequest<
-  TAction extends RuntimeAction = RuntimeAction,
-> = {
-  sessionId: string;
-  clientVersion?: number;
-  action: TAction;
-};
-
-export type RuntimeActionResponse<
-  TViewModel = JsonObject,
-  TPresentation = JsonObject,
-  TPatch = JsonObject,
-> = {
-  sessionId: string;
-  serverVersion: number;
-  viewModel: TViewModel;
-  presentation: TPresentation;
-  patches: TPatch[];
-};
-
-export const TASK5_RUNTIME_FUNCTION_IDS = [
-  'story_continue_adventure',
-  'story_opening_camp_dialogue',
-  'camp_travel_home_scene',
-  'idle_call_out',
-  'idle_explore_forward',
-  'idle_observe_signs',
-  'idle_rest_focus',
-  'idle_travel_next_scene',
-  'battle_attack_basic',
-  'battle_use_skill',
-  'battle_all_in_crush',
-  'battle_escape_breakout',
-  'battle_feint_step',
-  'battle_finisher_window',
-  'battle_guard_break',
-  'battle_probe_pressure',
-  'battle_recover_breath',
-  'npc_chat',
-  'npc_fight',
-  'npc_help',
-  'npc_leave',
-  'npc_preview_talk',
-  'npc_recruit',
-  'npc_spar',
-] as const;
-export type Task5RuntimeFunctionId =
-  (typeof TASK5_RUNTIME_FUNCTION_IDS)[number];
-
-export const TASK6_RUNTIME_FUNCTION_IDS = [
-  'equipment_equip',
-  'equipment_unequip',
-  'forge_craft',
-  'forge_dismantle',
-  'forge_reforge',
-  'inventory_use',
-  'npc_gift',
-  'npc_chat_quest_offer_abandon',
-  'npc_chat_quest_offer_replace',
-  'npc_chat_quest_offer_view',
-  'npc_quest_accept',
-  'npc_quest_turn_in',
-  'npc_trade',
-  'treasure_inspect',
-  'treasure_leave',
-  'treasure_secure',
-] as const;
-export type Task6RuntimeFunctionId =
-  (typeof TASK6_RUNTIME_FUNCTION_IDS)[number];
-
-export const SERVER_RUNTIME_FUNCTION_IDS = [
-  ...TASK5_RUNTIME_FUNCTION_IDS,
-  ...TASK6_RUNTIME_FUNCTION_IDS,
-] as const;
-export type ServerRuntimeFunctionId =
-  (typeof SERVER_RUNTIME_FUNCTION_IDS)[number];
-
-export const TASK5_RUNTIME_OPTION_SCOPES = ['story', 'combat', 'npc'] as const;
-export type Task5RuntimeOptionScope =
-  (typeof TASK5_RUNTIME_OPTION_SCOPES)[number];
-
-export type RuntimeStoryChoicePayload = JsonObject & {
-  optionText?: string;
-  note?: string;
-};
-
-export type RuntimeStoryOptionInteraction =
-  | {
-      kind: 'npc';
-      npcId: string;
-      action:
-        | 'chat'
-        | 'help'
-        | 'fight'
-        | 'leave'
-        | 'quest_offer_abandon'
-        | 'quest_offer_replace'
-        | 'quest_offer_view'
-        | 'recruit'
-        | 'spar'
-        | 'trade'
-        | 'gift'
-        | 'quest_accept'
-        | 'quest_turn_in';
-      questId?: string;
-    }
-  | {
-      kind: 'treasure';
-      action: 'inspect' | 'leave' | 'secure';
-    };
-
-export type RuntimeStoryChoiceAction = RuntimeAction<
-  'story_choice',
-  RuntimeStoryChoicePayload
-> & {
-  functionId: string;
-  targetId?: string;
-};
-
-export type RuntimeStoryOptionView = {
-  functionId: string;
-  actionText: string;
-  detailText?: string;
-  scope: Task5RuntimeOptionScope;
-  interaction?: RuntimeStoryOptionInteraction;
-  payload?: RuntimeStoryChoicePayload;
-  disabled?: boolean;
-  reason?: string;
-};
-
-export type RuntimeStoryPlayerViewModel = {
-  hp: number;
-  maxHp: number;
-  mana: number;
-  maxMana: number;
-};
-
-export type RuntimeStoryCompanionViewModel = {
-  npcId: string;
-  characterId?: string;
-  joinedAtAffinity: number;
-};
-
-export type RuntimeStoryEncounterViewModel = {
-  id: string;
-  kind: 'npc' | 'treasure';
-  npcName: string;
-  hostile: boolean;
-  affinity?: number;
-  recruited?: boolean;
-  interactionActive: boolean;
-  battleMode?: 'fight' | 'spar' | null;
-};
-
-export type RuntimeStoryStatusViewModel = {
-  inBattle: boolean;
-  npcInteractionActive: boolean;
-  currentNpcBattleMode: 'fight' | 'spar' | null;
-  currentNpcBattleOutcome: 'fight_victory' | 'spar_complete' | null;
-};
-
-export type RuntimeBattlePresentation = {
-  targetId?: string;
-  targetName?: string;
-  damageDealt?: number;
-  damageTaken?: number;
-  outcome?: 'ongoing' | 'victory' | 'spar_complete' | 'escaped';
-};
-
-export type RuntimeStoryViewModel = {
-  player: RuntimeStoryPlayerViewModel;
-  encounter: RuntimeStoryEncounterViewModel | null;
-  companions: RuntimeStoryCompanionViewModel[];
-  availableOptions: RuntimeStoryOptionView[];
-  status: RuntimeStoryStatusViewModel;
-};
-
-export type RuntimeStoryPresentation = {
-  actionText: string;
-  resultText: string;
-  storyText: string;
-  options: RuntimeStoryOptionView[];
-  toast?: string | null;
-  battle?: RuntimeBattlePresentation | null;
-};
-
-export type RuntimeStoryPatch =
-  | {
-      type: 'story_history_append';
-      actionText: string;
-      resultText: string;
-    }
-  | {
-      type: 'npc_affinity_changed';
-      npcId: string;
-      previousAffinity: number;
-      nextAffinity: number;
-    }
-  | {
-      type: 'battle_resolved';
-      functionId: string;
-      targetId?: string;
-      damageDealt?: number;
-      damageTaken?: number;
-      outcome: 'ongoing' | 'victory' | 'spar_complete' | 'escaped';
-    }
-  | {
-      type: 'status_changed';
-      inBattle: boolean;
-      npcInteractionActive: boolean;
-      currentNpcBattleMode: 'fight' | 'spar' | null;
-      currentNpcBattleOutcome: 'fight_victory' | 'spar_complete' | null;
-    }
-  | {
-      type: 'encounter_changed';
-      encounterId: string | null;
-    };
-
-export type RuntimeStoryActionRequest =
-  RuntimeActionRequest<RuntimeStoryChoiceAction> & {
-    snapshot?: SavedGameSnapshotInput;
-  };
-
-export type RuntimeStoryStateRequest<
-  TSnapshotGameState = JsonObject,
-  TSnapshotCurrentStory = JsonObject,
-> = {
-  sessionId: string;
-  clientVersion?: number;
-  snapshot?: SavedGameSnapshotInput<
-    TSnapshotGameState,
-    string,
-    TSnapshotCurrentStory
-  >;
-};
-
-export type RuntimeStoryActionResponse<
-  TSnapshotGameState = JsonObject,
-  TSnapshotCurrentStory = JsonObject,
-> = RuntimeActionResponse<
-  RuntimeStoryViewModel,
-  RuntimeStoryPresentation,
-  RuntimeStoryPatch
-> & {
-  snapshot: SavedGameSnapshot<
-    TSnapshotGameState,
-    string,
-    TSnapshotCurrentStory
-  >;
-};
diff --git a/packages/shared/src/index.ts b/packages/shared/src/index.ts
index b219972c..e6d6be73 100644
--- a/packages/shared/src/index.ts
+++ b/packages/shared/src/index.ts
@@ -1,13 +1,19 @@
 export * from './assets/qwenSprite';
 export * from './contracts/auth';
 export * from './contracts/common';
+export type * from './contracts/customWorldAgent';
 export * from './contracts/rpgAgentActions';
 export * from './contracts/rpgAgentAnchors';
+export * from './contracts/rpgAgentDraft';
 export * from './contracts/rpgAgentSession';
+export * from './contracts/rpgCreationFixtures';
 export * from './contracts/rpgCreationPreview';
 export * from './contracts/rpgCreationWorkSummary';
+export * from './contracts/rpgRuntimeChat';
+export * from './contracts/rpgRuntimeQuestAssist';
+export * from './contracts/rpgRuntimeStoryAction';
+export * from './contracts/rpgRuntimeStoryState';
 export * from './contracts/runtime';
-export * from './contracts/story';
 export * from './http';
 export * from './llm/narrativeLanguage';
 export * from './llm/parsers';
diff --git a/server-node/src/app.test.ts b/server-node/src/app.test.ts
index 548d5e7e..db79d426 100644
--- a/server-node/src/app.test.ts
+++ b/server-node/src/app.test.ts
@@ -208,7 +208,10 @@ async function authEntry(baseUrl: string, username: string, password: string) {
       username: string;
     };
   };
-  const refreshCookie = response.headers.get('set-cookie');
+  const refreshCookie = buildCookieHeader(
+    response.headers.get('set-cookie'),
+    'genarrative_refresh_session',
+  );
 
   assert.equal(response.status, 200);
   assert.ok(payload.token);
@@ -263,7 +266,10 @@ async function phoneLogin(baseUrl: string, phone: string, code = '123456') {
       wechatBound: boolean;
     };
   };
-  const refreshCookie = response.headers.get('set-cookie');
+  const refreshCookie = buildCookieHeader(
+    response.headers.get('set-cookie'),
+    'genarrative_refresh_session',
+  );
 
   assert.equal(response.status, 200);
   assert.ok(payload.token);
@@ -449,6 +455,191 @@ async function createObjectRefiningCustomWorldAgentSession(params: {
   return session;
 }
 
+async function markAgentSessionPublishReady(params: {
+  context: TestAppContext;
+  userId: string;
+  sessionId: string;
+}) {
+  const snapshot = await params.context.customWorldAgentOrchestrator.getSessionSnapshot(
+    params.userId,
+    params.sessionId,
+  );
+  const draftProfile = snapshot?.draftProfile as Record<string, unknown> | null;
+  const playableNpcs = Array.isArray(draftProfile?.playableNpcs)
+    ? (draftProfile?.playableNpcs as Array<Record<string, unknown>>)
+    : [];
+  const storyNpcs = Array.isArray(draftProfile?.storyNpcs)
+    ? (draftProfile?.storyNpcs as Array<Record<string, unknown>>)
+    : [];
+  const landmarks = Array.isArray(draftProfile?.landmarks)
+    ? (draftProfile?.landmarks as Array<Record<string, unknown>>)
+    : [];
+  const sceneChapters = Array.isArray(draftProfile?.sceneChapters)
+    ? (draftProfile?.sceneChapters as Array<Record<string, unknown>>)
+    : [];
+  const camp =
+    draftProfile?.camp && typeof draftProfile.camp === 'object'
+      ? (draftProfile.camp as Record<string, unknown>)
+      : null;
+  const firstPlayableRoleId =
+    typeof playableNpcs[0]?.id === 'string' && playableNpcs[0]?.id.trim()
+      ? playableNpcs[0].id.trim()
+      : null;
+  const firstStoryRoleId =
+    typeof storyNpcs[0]?.id === 'string' && storyNpcs[0]?.id.trim()
+      ? storyNpcs[0].id.trim()
+      : firstPlayableRoleId;
+
+  assert.ok(snapshot);
+  assert.ok(draftProfile);
+  assert.ok(playableNpcs.length > 0);
+  assert.ok(storyNpcs.length > 0);
+  assert.ok(landmarks.length > 0);
+  assert.ok(sceneChapters.length > 0);
+  assert.ok(firstStoryRoleId);
+
+  await params.context.customWorldAgentSessions.replaceDerivedState(
+    params.userId,
+    params.sessionId,
+    {
+      stage: 'ready_to_publish',
+      qualityFindings: [],
+      draftProfile: {
+        ...draftProfile,
+        chapters:
+          Array.isArray(draftProfile.chapters) && draftProfile.chapters.length > 0
+            ? draftProfile.chapters
+            : [{ id: 'chapter-main-1', title: '主线第一章' }],
+        camp: {
+          ...(camp ?? {}),
+          id:
+            typeof camp?.id === 'string' && camp.id.trim()
+              ? camp.id.trim()
+              : 'camp-home',
+          name:
+            typeof camp?.name === 'string' && camp.name.trim()
+              ? camp.name.trim()
+              : '归潮营地',
+          description:
+            typeof camp?.description === 'string' && camp.description.trim()
+              ? camp.description.trim()
+              : '可供玩家整理线索的临时据点。',
+          imageSrc:
+            typeof camp?.imageSrc === 'string' && camp.imageSrc.trim()
+              ? camp.imageSrc.trim()
+              : '/generated/camp/publish-ready.png',
+          generatedSceneAssetId:
+            typeof camp?.generatedSceneAssetId === 'string' &&
+            camp.generatedSceneAssetId.trim()
+              ? camp.generatedSceneAssetId.trim()
+              : 'scene-camp-publish-ready',
+          generatedScenePrompt:
+            typeof camp?.generatedScenePrompt === 'string' &&
+            camp.generatedScenePrompt.trim()
+              ? camp.generatedScenePrompt.trim()
+              : '潮雾营地发布正式图',
+          generatedSceneModel:
+            typeof camp?.generatedSceneModel === 'string' &&
+            camp.generatedSceneModel.trim()
+              ? camp.generatedSceneModel.trim()
+              : 'test-scene-model',
+        },
+        playableNpcs: playableNpcs.map((entry, index) => ({
+          ...entry,
+          imageSrc:
+            typeof entry.imageSrc === 'string' && entry.imageSrc.trim()
+              ? entry.imageSrc.trim()
+              : `/generated/playable/publish-ready-${index + 1}.png`,
+          generatedVisualAssetId:
+            typeof entry.generatedVisualAssetId === 'string' &&
+            entry.generatedVisualAssetId.trim()
+              ? entry.generatedVisualAssetId.trim()
+              : `visual-playable-publish-${index + 1}`,
+          generatedAnimationSetId:
+            typeof entry.generatedAnimationSetId === 'string' &&
+            entry.generatedAnimationSetId.trim()
+              ? entry.generatedAnimationSetId.trim()
+              : `anim-playable-publish-${index + 1}`,
+        })),
+        storyNpcs: storyNpcs.map((entry, index) => ({
+          ...entry,
+          imageSrc:
+            typeof entry.imageSrc === 'string' && entry.imageSrc.trim()
+              ? entry.imageSrc.trim()
+              : `/generated/story/publish-ready-${index + 1}.png`,
+          generatedVisualAssetId:
+            typeof entry.generatedVisualAssetId === 'string' &&
+            entry.generatedVisualAssetId.trim()
+              ? entry.generatedVisualAssetId.trim()
+              : `visual-story-publish-${index + 1}`,
+          generatedAnimationSetId:
+            typeof entry.generatedAnimationSetId === 'string' &&
+            entry.generatedAnimationSetId.trim()
+              ? entry.generatedAnimationSetId.trim()
+              : `anim-story-publish-${index + 1}`,
+        })),
+        landmarks: landmarks.map((entry, index) => ({
+          ...entry,
+          imageSrc:
+            typeof entry.imageSrc === 'string' && entry.imageSrc.trim()
+              ? entry.imageSrc.trim()
+              : `/generated/landmark/publish-ready-${index + 1}.png`,
+          generatedSceneAssetId:
+            typeof entry.generatedSceneAssetId === 'string' &&
+            entry.generatedSceneAssetId.trim()
+              ? entry.generatedSceneAssetId.trim()
+              : `scene-landmark-publish-${index + 1}`,
+          generatedScenePrompt:
+            typeof entry.generatedScenePrompt === 'string' &&
+            entry.generatedScenePrompt.trim()
+              ? entry.generatedScenePrompt.trim()
+              : `地点 ${typeof entry.name === 'string' ? entry.name : index + 1} 的正式场景图`,
+          generatedSceneModel:
+            typeof entry.generatedSceneModel === 'string' &&
+            entry.generatedSceneModel.trim()
+              ? entry.generatedSceneModel.trim()
+              : 'test-scene-model',
+        })),
+        sceneChapters: sceneChapters.map((chapter, chapterIndex) => {
+          const acts = Array.isArray(chapter.acts)
+            ? (chapter.acts as Array<Record<string, unknown>>)
+            : [];
+
+          return {
+            ...chapter,
+            linkedThreadIds:
+              Array.isArray(chapter.linkedThreadIds) &&
+              chapter.linkedThreadIds.length > 0
+                ? chapter.linkedThreadIds
+                : ['thread-publish-ready'],
+            acts: acts.map((act, actIndex) => ({
+              ...act,
+              encounterNpcIds:
+                Array.isArray(act.encounterNpcIds) && act.encounterNpcIds.length > 0
+                  ? act.encounterNpcIds
+                  : [firstStoryRoleId],
+              primaryNpcId:
+                typeof act.primaryNpcId === 'string' && act.primaryNpcId.trim()
+                  ? act.primaryNpcId.trim()
+                  : firstStoryRoleId,
+              backgroundImageSrc:
+                typeof act.backgroundImageSrc === 'string' &&
+                act.backgroundImageSrc.trim()
+                  ? act.backgroundImageSrc.trim()
+                  : `/generated/scene/publish-ready-${chapterIndex + 1}-${actIndex + 1}.png`,
+              backgroundAssetId:
+                typeof act.backgroundAssetId === 'string' &&
+                act.backgroundAssetId.trim()
+                  ? act.backgroundAssetId.trim()
+                  : `scene-act-publish-${chapterIndex + 1}-${actIndex + 1}`,
+            })),
+          };
+        }),
+      },
+    },
+  );
+}
+
 function parseRedirectHash(location: string) {
   const url = new URL(location, 'http://127.0.0.1');
   return new URLSearchParams(
@@ -456,6 +647,18 @@ function parseRedirectHash(location: string) {
   );
 }
 
+function readCookieValue(cookieHeader: string, cookieName: string) {
+  const match = cookieHeader.match(
+    new RegExp(`${cookieName}=([^;,\r\n]+)`, 'u'),
+  );
+  return match?.[1] ? decodeURIComponent(match[1]) : '';
+}
+
+function buildCookieHeader(cookieHeader: string | null | undefined, cookieName: string) {
+  const value = readCookieValue(cookieHeader || '', cookieName);
+  return value ? `${cookieName}=${encodeURIComponent(value)}` : '';
+}
+
 async function startWechatMockFlow(baseUrl: string, redirectPath = '/') {
   const startResponse = await httpRequest(
     `${baseUrl}/api/auth/wechat/start?redirectPath=${encodeURIComponent(redirectPath)}`,
@@ -473,18 +676,10 @@ async function startWechatMockFlow(baseUrl: string, redirectPath = '/') {
   assert.ok(location);
   const hash = parseRedirectHash(location);
   const setCookieHeader = callbackResponse.headers.get('set-cookie') || '';
-  const accessCookie = setCookieHeader
-    .split(',')
-    .map((entry) => entry.trim())
-    .find((entry) => entry.startsWith('genarrative_access_session='));
-  const token =
-    accessCookie
-      ?.split(';')[0]
-      ?.split('=')
-      .slice(1)
-      .join('=')
-      .trim() || '';
-
+  const token = readCookieValue(
+    setCookieHeader,
+    'genarrative_access_session',
+  );
   assert.ok(token);
 
   return {
@@ -1552,7 +1747,10 @@ test('logout-all revokes all refresh sessions and invalidates existing access to
     assert.equal(refreshResponse.status, 200);
     const entryB = {
       token: refreshPayload.token,
-      refreshCookie: refreshResponse.headers.get('set-cookie') || '',
+      refreshCookie: buildCookieHeader(
+        refreshResponse.headers.get('set-cookie'),
+        'genarrative_refresh_session',
+      ),
     };
 
     const logoutAllResponse = await httpRequest(
@@ -1623,7 +1821,7 @@ test('error responses share one structure and preserve request ids', async () =>
 
     assert.equal(response.status, 401);
     assert.equal(payload.error.code, 'UNAUTHORIZED');
-    assert.equal(payload.error.message, '缺少 Authorization Bearer Token');
+    assert.equal(payload.error.message, '缺少登录凭证');
     assert.equal(payload.meta.requestId, requestId);
     assert.equal(payload.meta.apiVersion, '2026-04-08');
     assert.equal(payload.meta.routeVersion, '2026-04-08');
@@ -2895,6 +3093,98 @@ test('custom world agent draft_foundation action generates draft cards and card
   );
 });
 
+test('custom world agent stream message returns enriched session payload over sse', async () => {
+  await withTestServer(
+    'custom-world-agent-stream-session',
+    async ({ baseUrl, context }) => {
+      installTestCustomWorldAgentSingleTurnLlm(context);
+      const entry = await authEntry(baseUrl, 'cw_agent_stream', 'secret123');
+      const readySession = await createReadyCustomWorldAgentSession({
+        baseUrl,
+        token: entry.token,
+      });
+
+      const foundationResponse = await httpRequest(
+        `${baseUrl}/api/runtime/custom-world/agent/sessions/${encodeURIComponent(readySession.sessionId)}/actions`,
+        withBearer(entry.token, {
+          method: 'POST',
+          body: JSON.stringify({
+            action: 'draft_foundation',
+          }),
+        }),
+      );
+      const foundationPayload = (await foundationResponse.json()) as {
+        operation: {
+          operationId: string;
+        };
+      };
+
+      assert.equal(foundationResponse.status, 200);
+
+      await waitForCustomWorldAgentOperation({
+        baseUrl,
+        token: entry.token,
+        sessionId: readySession.sessionId,
+        operationId: foundationPayload.operation.operationId,
+        expectedStatus: 'completed',
+      });
+
+      const streamResponse = await httpRequest(
+        `${baseUrl}/api/runtime/custom-world/agent/sessions/${encodeURIComponent(readySession.sessionId)}/messages/stream`,
+        withBearer(entry.token, {
+          method: 'POST',
+          headers: {
+            Accept: 'text/event-stream',
+          },
+          body: JSON.stringify({
+            clientMessageId: 'stream-client-1',
+            text: '把守灯会的压力再收紧一些，玩家与沈砺的旧案关系也再明显一点。',
+            focusCardId: null,
+            selectedCardIds: [],
+          }),
+        }),
+      );
+      const streamText = await streamResponse.text();
+      const sessionEventMatch = streamText.match(/event: session\s+data: (\{.*\})/u);
+
+      assert.equal(streamResponse.status, 200);
+      assert.match(
+        streamResponse.headers.get('content-type') ?? '',
+        /text\/event-stream/u,
+      );
+      assert.match(streamText, /event: reply_delta/u);
+      assert.match(streamText, /event: session/u);
+      assert.match(streamText, /event: done/u);
+      assert.ok(sessionEventMatch?.[1]);
+
+      const sessionEvent = JSON.parse(sessionEventMatch![1]) as {
+        session: {
+          stage: string;
+          supportedActions?: Array<{ action: string; enabled: boolean }>;
+          resultPreview?: {
+            source: string;
+            preview: { name?: string };
+          } | null;
+        };
+      };
+
+      assert.equal(sessionEvent.session.stage, 'object_refining');
+      assert.equal(
+        sessionEvent.session.supportedActions?.some(
+          (entry) =>
+            entry.action === 'update_draft_card' && entry.enabled === true,
+        ),
+        true,
+      );
+      assert.equal(
+        sessionEvent.session.resultPreview?.source,
+        'session_preview',
+      );
+      assert.ok(sessionEvent.session.resultPreview?.preview?.name);
+    },
+  );
+});
+
 test('custom world agent draft_foundation action rejects not-ready sessions over http', async () => {
   await withTestServer(
     'custom-world-agent-phase3-http-not-ready',
@@ -3197,6 +3487,129 @@ test('custom world agent sync_result_profile action writes result snapshot back
   );
 });
 
+test('library publish for agent-backed draft returns explicit blocker message when Phase4 gate is not ready', async () => {
+  await withTestServer(
+    'custom-world-library-agent-publish-blocked',
+    async ({ baseUrl, context }) => {
+      installTestCustomWorldAgentSingleTurnLlm(context);
+      const entry = await authEntry(
+        baseUrl,
+        'cw_library_agent_blocked',
+        'secret123',
+      );
+      const session = await createObjectRefiningCustomWorldAgentSession({
+        baseUrl,
+        token: entry.token,
+      });
+      const profileId = `agent-draft-${session.sessionId}`;
+
+      const publishResponse = await httpRequest(
+        `${baseUrl}/api/runtime/custom-world-library/${encodeURIComponent(profileId)}/publish`,
+        withBearer(entry.token, {
+          method: 'POST',
+        }),
+      );
+      const publishPayload = (await publishResponse.json()) as {
+        error: {
+          code: string;
+          message: string;
+        };
+      };
+      const sessionAfterPublishAttempt =
+        await context.customWorldAgentOrchestrator.getSessionSnapshot(
+          entry.user.id,
+          session.sessionId,
+        );
+
+      assert.equal(publishResponse.status, 409);
+      assert.equal(publishPayload.error.code, 'CONFLICT');
+      assert.match(
+        publishPayload.error.message,
+        /当前世界仍有 \d+ 个 blocker/u,
+      );
+      assert.match(
+        publishPayload.error.message,
+        /缺少正式主图|缺少正式场景图|主线第一幕/u,
+      );
+      assert.notEqual(sessionAfterPublishAttempt?.stage, 'published');
+    },
+  );
+});
+
+test('library publish for agent-backed draft reuses Phase4 gate and syncs session into published stage', async () => {
+  await withTestServer(
+    'custom-world-library-agent-publish-success',
+    async ({ baseUrl, context }) => {
+      installTestCustomWorldAgentSingleTurnLlm(context);
+      const entry = await authEntry(
+        baseUrl,
+        'cw_library_agent_success',
+        'secret123',
+      );
+      const session = await createObjectRefiningCustomWorldAgentSession({
+        baseUrl,
+        token: entry.token,
+      });
+      const profileId = `agent-draft-${session.sessionId}`;
+
+      await markAgentSessionPublishReady({
+        context,
+        userId: entry.user.id,
+        sessionId: session.sessionId,
+      });
+
+      const publishResponse = await httpRequest(
+        `${baseUrl}/api/runtime/custom-world-library/${encodeURIComponent(profileId)}/publish`,
+        withBearer(entry.token, {
+          method: 'POST',
+        }),
+      );
+      const publishPayload = (await publishResponse.json()) as {
+        entry: {
+          profileId: string;
+          visibility: 'draft' | 'published';
+        };
+      };
+      const libraryResponse = await httpRequest(
+        `${baseUrl}/api/runtime/custom-world-library`,
+        withBearer(entry.token),
+      );
+      const libraryPayload = (await libraryResponse.json()) as {
+        entries: Array<{
+          profileId: string;
+          visibility: 'draft' | 'published';
+        }>;
+      };
+      const sessionAfterPublish =
+        await context.customWorldAgentOrchestrator.getSessionSnapshot(
+          entry.user.id,
+          session.sessionId,
+        );
+
+      assert.equal(publishResponse.status, 200);
+      assert.equal(publishPayload.entry.profileId, profileId);
+      assert.equal(publishPayload.entry.visibility, 'published');
+      assert.equal(libraryResponse.status, 200);
+      assert.equal(
+        libraryPayload.entries.find((item) => item.profileId === profileId)
+          ?.visibility,
+        'published',
+      );
+      assert.equal(sessionAfterPublish?.stage, 'published');
+      assert.equal(sessionAfterPublish?.resultPreview?.publishReady, true);
+      assert.equal(sessionAfterPublish?.resultPreview?.canEnterWorld, true);
+      assert.deepEqual(sessionAfterPublish?.resultPreview?.blockers ?? [], []);
+      assert.ok(
+        sessionAfterPublish?.messages.some(
+          (message) =>
+            message.kind === 'action_result' &&
+            message.text.includes('已正式发布'),
+        ),
+      );
+    },
+  );
+});
+
 test('custom world agent generate_characters action appends character cards over http', async () => {
   await withTestServer(
     'custom-world-agent-phase4-generate-characters-http',
diff --git a/server-node/src/app.ts b/server-node/src/app.ts
index 2227b813..ddd24152 100644
--- a/server-node/src/app.ts
+++ b/server-node/src/app.ts
@@ -9,9 +9,13 @@ import { requestIdMiddleware } from './middleware/requestId.js';
 import { responseEnvelopeMiddleware } from './middleware/responseEnvelope.js';
 import { createCharacterAssetRoutes } from './modules/assets/characterAssetRoutes.js';
 import { createEditorRoutes } from './modules/editor/editorRoutes.js';
-import { createStoryActionRoutes } from './modules/story/storyActionRoutes.js';
 import { createAuthRoutes } from './routes/authRoutes.js';
-import { createRuntimeRoutes } from './routes/runtimeRoutes.js';
+import { createRpgEntrySaveRoutes } from './routes/rpg-entry/rpgEntrySaveRoutes.js';
+import { createRpgWorldLibraryRoutes } from './routes/rpg-entry/rpgWorldLibraryRoutes.js';
+import { createRpgProfileRoutes } from './routes/rpg-profile/rpgProfileRoutes.js';
+import { createRpgRuntimeAiAssistRoutes } from './routes/rpg-runtime/rpgRuntimeAiAssistRoutes.js';
+import { createRpgRuntimeStoryRoutes } from './routes/rpg-runtime/rpgRuntimeStoryRoutes.js';
+import { createCustomWorldAgentRoutes } from './routes/customWorldAgent.js';
 
 function matchesRoutePrefix(
   request: express.Request,
@@ -118,6 +122,33 @@ export function createApp(context: AppContext) {
       createCharacterAssetRoutes(context.config, context.llmClient),
     ),
   );
+  app.use(
+    '/api',
+    scopeToPrefixes(
+      ['/runtime/profile', '/profile', '/runtime/settings'],
+      withRouteMeta({ routeVersion: '2026-04-21', operation: 'rpg.profile.api' }),
+    ),
+    createRpgProfileRoutes(context),
+  );
+  app.use(
+    '/api',
+    scopeToPrefixes(
+      ['/runtime/save', '/runtime/profile/save-archives', '/profile/save-archives'],
+      withRouteMeta({ routeVersion: '2026-04-21', operation: 'rpg.entry.save.api' }),
+    ),
+    createRpgEntrySaveRoutes(context),
+  );
+  app.use(
+    '/api',
+    scopeToPrefixes(
+      ['/runtime/custom-world-gallery', '/runtime/custom-world/works', '/runtime/custom-world-library'],
+      withRouteMeta({
+        routeVersion: '2026-04-21',
+        operation: 'rpg.entry.worldLibrary.api',
+      }),
+    ),
+    createRpgWorldLibraryRoutes(context),
+  );
   app.use(
     '/api/auth',
     withRouteMeta({ routeVersion: '2026-04-08' }),
@@ -125,13 +156,61 @@ export function createApp(context: AppContext) {
   );
   app.use(
     '/api/runtime/story',
-    withRouteMeta({ routeVersion: '2026-04-08' }),
-    createStoryActionRoutes(context),
+    withRouteMeta({ routeVersion: '2026-04-21' }),
+    createRpgRuntimeStoryRoutes(context),
+  );
+  app.use(
+    scopeToPrefixes(
+      [
+        '/llm/chat/completions',
+        '/custom-world/cover-image',
+        '/custom-world/cover-upload',
+        '/custom-world/scene-image',
+        '/custom-world/entity',
+        '/custom-world/scene-npc',
+        '/runtime/custom-world/entity',
+        '/runtime/custom-world/scene-npc',
+        '/runtime/custom-world/profile',
+        '/runtime/story/initial',
+        '/runtime/story/continue',
+        '/runtime/chat',
+        '/runtime/items',
+        '/runtime/quests',
+        '/ws/health',
+      ],
+      withRouteMeta({
+        routeVersion: '2026-04-21',
+        operation: 'rpg.runtime.aiAssist.api',
+      }),
+    ),
   );
   app.use(
     '/api',
-    withRouteMeta({ routeVersion: '2026-04-08' }),
-    createRuntimeRoutes(context),
+    scopeToPrefixes(
+      [
+        '/llm/chat/completions',
+        '/custom-world/cover-image',
+        '/custom-world/cover-upload',
+        '/custom-world/scene-image',
+        '/custom-world/entity',
+        '/custom-world/scene-npc',
+        '/runtime/custom-world/entity',
+        '/runtime/custom-world/scene-npc',
+        '/runtime/custom-world/profile',
+        '/runtime/story/initial',
+        '/runtime/story/continue',
+        '/runtime/chat',
+        '/runtime/items',
+        '/runtime/quests',
+        '/ws/health',
+      ],
+      createRpgRuntimeAiAssistRoutes(context),
+    ),
+  );
+  app.use(
+    '/api/runtime/custom-world/agent',
+    withRouteMeta({ routeVersion: '2026-04-21', operation: 'rpg.creation.agent.api' }),
+    createCustomWorldAgentRoutes(context),
   );
   app.use(
     express.static(context.config.publicDir, {
diff --git a/server-node/src/auth/refreshSessionCookie.ts b/server-node/src/auth/refreshSessionCookie.ts
index ad51d8f0..1da7a543 100644
--- a/server-node/src/auth/refreshSessionCookie.ts
+++ b/server-node/src/auth/refreshSessionCookie.ts
@@ -32,6 +32,21 @@ function buildCookieParts(
   return parts.join('; ');
 }
 
+function appendSetCookieHeader(response: Response, cookieValue: string) {
+  const currentHeader = response.getHeader('Set-Cookie');
+  if (!currentHeader) {
+    response.setHeader('Set-Cookie', cookieValue);
+    return;
+  }
+
+  if (Array.isArray(currentHeader)) {
+    response.setHeader('Set-Cookie', [...currentHeader, cookieValue]);
+    return;
+  }
+
+  response.setHeader('Set-Cookie', [String(currentHeader), cookieValue]);
+}
+
 export function hashRefreshSessionToken(token: string) {
   return crypto.createHash('sha256').update(token).digest('hex');
 }
@@ -46,8 +61,8 @@ export function setRefreshSessionCookie(
   token: string,
   maxAgeSeconds: number,
 ) {
-  response.setHeader(
-    'Set-Cookie',
+  appendSetCookieHeader(
+    response,
     buildCookieParts(config, token, {
       maxAgeSeconds,
     }),
@@ -55,8 +70,8 @@ export function setRefreshSessionCookie(
 }
 
 export function clearRefreshSessionCookie(response: Response, config: AppConfig) {
-  response.setHeader(
-    'Set-Cookie',
+  appendSetCookieHeader(
+    response,
     buildCookieParts(config, '', {
       maxAgeSeconds: 0,
     }),
diff --git a/server-node/src/context.ts b/server-node/src/context.ts
index e978ac56..01b0503d 100644
--- a/server-node/src/context.ts
+++ b/server-node/src/context.ts
@@ -5,6 +5,13 @@ import type { AppDatabase } from './db.js';
 import { AuthAuditLogRepository } from './repositories/authAuditLogRepository.js';
 import { AuthIdentityRepository } from './repositories/authIdentityRepository.js';
 import { AuthRiskBlockRepository } from './repositories/authRiskBlockRepository.js';
+import type { RpgAgentSessionRepository } from './repositories/RpgAgentSessionRepository.js';
+import type { RpgSaveArchiveRepository } from './repositories/rpg-entry/RpgSaveArchiveRepository.js';
+import type { RpgWorldLibraryRepository } from './repositories/rpg-entry/RpgWorldLibraryRepository.js';
+import type { RpgBrowseHistoryRepository } from './repositories/rpg-profile/RpgBrowseHistoryRepository.js';
+import type { RpgProfileDashboardRepository } from './repositories/rpg-profile/RpgProfileDashboardRepository.js';
+import type { RpgRuntimeSnapshotRepository } from './repositories/rpg-runtime/RpgRuntimeSnapshotRepository.js';
+import type { RpgWorldProfileRepository } from './repositories/RpgWorldProfileRepository.js';
 import { RuntimeRepository } from './repositories/runtimeRepository.js';
 import { SmsAuthEventRepository } from './repositories/smsAuthEventRepository.js';
 import { UserRepository } from './repositories/userRepository.js';
@@ -13,6 +20,7 @@ import { CaptchaChallengeStore } from './services/captchaChallengeStore.js';
 import { CustomWorldAgentOrchestrator } from './services/customWorldAgentOrchestrator.js';
 import { CustomWorldAgentSessionStore } from './services/customWorldAgentSessionStore.js';
 import { UpstreamLlmClient } from './services/llmClient.js';
+import type { RpgWorldWorkSummaryService } from './services/RpgWorldWorkSummaryService.js';
 import type { SmsVerificationService } from './services/smsVerificationService.js';
 import type { WechatAuthService } from './services/wechatAuthService.js';
 import { WechatAuthStateStore } from './services/wechatAuthStateStore.js';
@@ -27,10 +35,18 @@ export type AppContext = {
   authRiskBlockRepository: AuthRiskBlockRepository;
   smsAuthEventRepository: SmsAuthEventRepository;
   userSessionRepository: UserSessionRepository;
+  rpgAgentSessionRepository: RpgAgentSessionRepository;
+  rpgWorldProfileRepository: RpgWorldProfileRepository;
+  rpgProfileDashboardRepository: RpgProfileDashboardRepository;
+  rpgBrowseHistoryRepository: RpgBrowseHistoryRepository;
+  rpgSaveArchiveRepository: RpgSaveArchiveRepository;
+  rpgWorldLibraryRepository: RpgWorldLibraryRepository;
+  rpgRuntimeSnapshotRepository: RpgRuntimeSnapshotRepository;
   runtimeRepository: RuntimeRepository;
   llmClient: UpstreamLlmClient;
   customWorldAgentSessions: CustomWorldAgentSessionStore;
   customWorldAgentOrchestrator: CustomWorldAgentOrchestrator;
+  rpgWorldWorkSummaryService: RpgWorldWorkSummaryService;
   smsVerificationService: SmsVerificationService;
   wechatAuthService: WechatAuthService;
   wechatAuthStates: WechatAuthStateStore;
diff --git a/server-node/src/modules/ai/chatOrchestrator.ts b/server-node/src/modules/ai/chatOrchestrator.ts
index ab286506..124cb35d 100644
--- a/server-node/src/modules/ai/chatOrchestrator.ts
+++ b/server-node/src/modules/ai/chatOrchestrator.ts
@@ -9,7 +9,7 @@ import type {
   type NpcChatTurnCompletionDirective,
   NpcChatTurnRequest,
   NpcRecruitDialogueRequest,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeChat.js';
 import { parseLineListContent } from '../../../../packages/shared/src/llm/parsers.js';
 import { prepareEventStreamResponse } from '../../http.js';
 import type { UpstreamLlmClient } from '../../services/llmClient.js';
diff --git a/server-node/src/modules/ai/orchestrator.test.ts b/server-node/src/modules/ai/orchestrator.test.ts
index e947f1b0..8bea50ce 100644
--- a/server-node/src/modules/ai/orchestrator.test.ts
+++ b/server-node/src/modules/ai/orchestrator.test.ts
@@ -4,7 +4,7 @@ import test from 'node:test';
 import type {
   CharacterChatSuggestionsRequest,
   NpcChatTurnRequest,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeChat.js';
 import { createTestPlayerCharacter } from '../../testFixtures/runtimeCharacter.js';
 import {
   generateCharacterChatSuggestionsFromOrchestrator,
diff --git a/server-node/src/modules/combat/combatResolutionService.ts b/server-node/src/modules/combat/combatResolutionService.ts
index 42d864d2..a2117843 100644
--- a/server-node/src/modules/combat/combatResolutionService.ts
+++ b/server-node/src/modules/combat/combatResolutionService.ts
@@ -1,8 +1,10 @@
 import type {
   RuntimeBattlePresentation,
-  RuntimeStoryChoicePayload,
   RuntimeStoryPatch,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
+import type {
+  RuntimeStoryChoicePayload,
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryAction.js';
 import {
   buildInventoryUseResultText,
   incrementGameRuntimeStats,
@@ -26,7 +28,7 @@ import {
   getPlayerSkillCooldowns,
   setEncounterNpcState,
   type RuntimeSession,
-} from '../story/runtimeSession.js';
+} from '../rpg-runtime-story/RpgRuntimeSessionPrimitives.js';
 
 type CombatActionConfig = {
   actionText: string;
diff --git a/server-node/src/modules/custom-world/runtime-profile/buildAttributeSchema.ts b/server-node/src/modules/custom-world/runtime-profile/buildAttributeSchema.ts
new file mode 100644
index 00000000..0301a2fb
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/buildAttributeSchema.ts
@@ -0,0 +1,365 @@
+import type {
+  AttributeVector,
+  CustomWorldNpc,
+  CustomWorldPlayableNpc,
+  RoleAttributeProfile,
+  WorldAttributeSchema,
+  WorldAttributeSlot,
+  WorldType,
+} from '../runtimeTypes.js';
+import { inferWorldTypeFromSetting } from './creatorIntentBridge.js';
+import { slugify } from './normalizeShared.js';
+
+/**
+ * 工作包 G：
+ * 把 attribute schema 构建和角色属性画像编译从主 runtime compiler 中抽离，
+ * 让结果预览编译、世界基础 profile 归一和角色属性推导有清晰边界。
+ */
+
+const WORLD_ATTRIBUTE_SLOT_IDS = [
+  'axis_a',
+  'axis_b',
+  'axis_c',
+  'axis_d',
+  'axis_e',
+  'axis_f',
+] as const;
+
+const AXIS_KEYWORD_RULES: Array<{
+  slotId: string;
+  patterns: RegExp[];
+  weight: number;
+}> = [
+  { slotId: 'axis_a', patterns: [/骨|甲|壳|岩|重|守|镇|顶|硬|锋|体/u], weight: 16 },
+  { slotId: 'axis_b', patterns: [/身法|迅|影|风|闪|游|机动|追|步|轻灵/u], weight: 16 },
+  { slotId: 'axis_c', patterns: [/识|眼|谋|算|阵|符|术|察|局|禁制/u], weight: 16 },
+  { slotId: 'axis_d', patterns: [/心|焰|胆|威|压|怒|决|破|强推|意志/u], weight: 16 },
+  { slotId: 'axis_e', patterns: [/缘|契|情|盟|商|医|助|信|交|誓/u], weight: 16 },
+  { slotId: 'axis_f', patterns: [/息|稳|续|守|调|回|养|持久|回复|韧/u], weight: 16 },
+];
+
+export function buildTemplateWorldAttributeSchema(
+  worldType: Exclude<WorldType, 'CUSTOM'>,
+) {
+  const common = {
+    schemaVersion: 1,
+    generatedFrom:
+      worldType === 'XIANXIA'
+        ? {
+            worldType: 'XIANXIA' as const,
+            worldName: '仙侠',
+            settingSummary: '灵潮、宗门、禁制、秘境与道途交织。',
+            tone: '空灵、危险、带着灾变与大道压迫。',
+            conflictCore: '在裂变与因果之间稳住自我与道途。',
+          }
+        : {
+            worldType: 'WUXIA' as const,
+            worldName: '武侠',
+            settingSummary: '江湖、门派、旧案与人情纠葛并存。',
+            tone: '克制、紧张、讲究局势与心气。',
+            conflictCore: '在人情、威压与旧案之间立住自身。',
+          },
+  };
+
+  if (worldType === 'XIANXIA') {
+    return {
+      id: 'schema:xianxia:v1',
+      worldId: 'XIANXIA',
+      schemaName: '灵界六轴',
+      ...common,
+      slots: [
+        {
+          slotId: 'axis_a',
+          name: '道骨',
+          definition: '承载道压与高强度冲击的底子。',
+          positiveSignals: ['承压', '根基稳', '扛得住'],
+          negativeSignals: ['根基浅', '易溃', '承载不足'],
+          combatUseText: '扛住灵压、正面承受高强度对撞。',
+          socialUseText: '让人感到根基扎实，值得托付重事。',
+          explorationUseText: '承受秘境、禁制与裂隙带来的压迫。',
+        },
+        {
+          slotId: 'axis_b',
+          name: '灵行',
+          definition: '位移、御空、转场、抢占天时地利的能力。',
+          positiveSignals: ['位移', '御空', '机动'],
+          negativeSignals: ['迟滞', '失位', '转场慢'],
+          combatUseText: '抢位、御空、快速重整战场位置。',
+          socialUseText: '反应轻快，擅长顺势接住局面的变化。',
+          explorationUseText: '穿越高危地形、裂隙、云海与复杂禁区。',
+        },
+        {
+          slotId: 'axis_c',
+          name: '识海',
+          definition: '解析禁制、洞察因果、识破虚实的能力。',
+          positiveSignals: ['洞察', '解构', '看破'],
+          negativeSignals: ['迷失', '误判', '看不清'],
+          combatUseText: '识破术理、找出因果节点与破绽。',
+          socialUseText: '更容易辨认真话、虚言与隐藏动机。',
+          explorationUseText: '解读阵纹、禁制、旧史与环境异象。',
+        },
+        {
+          slotId: 'axis_d',
+          name: '劫纹',
+          definition: '在高危变化中强行推进、改写局势的能力。',
+          positiveSignals: ['强推', '决断', '逆转'],
+          negativeSignals: ['畏缩', '迟疑', '不敢碰变局'],
+          combatUseText: '在高压窗口里压上去，逼出变化与突破。',
+          socialUseText: '在关键谈判中拍板，推动他人表态。',
+          explorationUseText: '面对异变与风险时敢于推进关键节点。',
+        },
+        {
+          slotId: 'axis_e',
+          name: '心契',
+          definition: '与他者、器物、灵兽、誓约建立共鸣的能力。',
+          positiveSignals: ['共鸣', '结契', '安抚'],
+          negativeSignals: ['隔阂', '生硬', '难以共振'],
+          combatUseText: '与器物、灵兽、同伴形成协同与共鸣。',
+          socialUseText: '建立信任、誓约与更深层的关系连结。',
+          explorationUseText: '借由共鸣打开封印、回应遗物或安抚异兽。',
+        },
+        {
+          slotId: 'axis_f',
+          name: '玄息',
+          definition: '循环灵息、稳住心神、让自身持续在线的能力。',
+          positiveSignals: ['稳态', '回转', '续航'],
+          negativeSignals: ['紊乱', '枯竭', '失衡'],
+          combatUseText: '维持灵息循环、拖住长线压力与消耗。',
+          socialUseText: '气息沉稳，不轻易乱阵脚或露出破绽。',
+          explorationUseText: '在漫长探索与灵潮侵蚀中维持可行动状态。',
+        },
+      ] satisfies WorldAttributeSlot[],
+    } satisfies WorldAttributeSchema;
+  }
+
+  return {
+    id: 'schema:wuxia:v1',
+    worldId: 'WUXIA',
+    schemaVersion: 1,
+    schemaName: '江湖六脉',
+    generatedFrom: common.generatedFrom,
+    slots: [
+      {
+        slotId: 'axis_a',
+        name: '骨势',
+        definition: '扛压、顶冲、硬吃风险也不退的势头。',
+        positiveSignals: ['扛压', '硬桥硬马', '稳住正面'],
+        negativeSignals: ['虚浮', '怯退', '一碰就散'],
+        combatUseText: '顶住正面压力、换伤不退、撑住阵线。',
+        socialUseText: '在强压场面里不露怯，给人可靠或强硬之感。',
+        explorationUseText: '穿越险路、硬顶机关、承受高压环境。',
+      },
+      {
+        slotId: 'axis_b',
+        name: '身法',
+        definition: '腾挪、抢位、换线、把握出手节奏的能力。',
+        positiveSignals: ['快', '轻灵', '抢位'],
+        negativeSignals: ['迟缓', '失位', '笨重'],
+        combatUseText: '切线换位、闪转腾挪、争夺先手。',
+        socialUseText: '应变快，擅长观察气口并顺势接话。',
+        explorationUseText: '攀越、潜入、追踪与复杂地形穿行。',
+      },
+      {
+        slotId: 'axis_c',
+        name: '眼脉',
+        definition: '看破破绽、拆招、识局、看穿人心的能力。',
+        positiveSignals: ['识局', '洞察', '拆招'],
+        negativeSignals: ['迟钝', '误判', '看不透'],
+        combatUseText: '抓破绽、拆套路、找出最该切入的位置。',
+        socialUseText: '判断弦外之音、试探真假、识别来意。',
+        explorationUseText: '识破机关、辨认痕迹、看懂异状。',
+      },
+      {
+        slotId: 'axis_d',
+        name: '心焰',
+        definition: '决断、压迫、胆气、在局面中立住自身意志的能力。',
+        positiveSignals: ['胆气', '决断', '压迫'],
+        negativeSignals: ['犹疑', '软弱', '易被动摇'],
+        combatUseText: '逼迫对手、强行推进、在关键时刻拍板。',
+        socialUseText: '立威、定调、在谈判里压住场子。',
+        explorationUseText: '在未知风险前保持决断，不被局势拖死。',
+      },
+      {
+        slotId: 'axis_e',
+        name: '尘缘',
+        definition: '与人事、情面、承诺、牵引关系打交道的能力。',
+        positiveSignals: ['通人情', '会安抚', '懂交换'],
+        negativeSignals: ['生硬', '失礼', '不近人情'],
+        combatUseText: '借势协同、读懂同伴与对手的关系脉络。',
+        socialUseText: '安抚、求助、结盟、维系承诺与信任。',
+        explorationUseText: '从传闻、人脉和地方关系里打开线索。',
+      },
+      {
+        slotId: 'axis_f',
+        name: '玄息',
+        definition: '调息、稳态、久战、把自身维持在可用状态的能力。',
+        positiveSignals: ['稳', '续战', '调息'],
+        negativeSignals: ['紊乱', '易崩', '续不上'],
+        combatUseText: '续战、回气、稳住节奏与状态。',
+        socialUseText: '遇事不乱，语气和姿态都更沉稳可信。',
+        explorationUseText: '长线跋涉、在恶劣环境下维持专注与状态。',
+      },
+    ] satisfies WorldAttributeSlot[],
+  } satisfies WorldAttributeSchema;
+}
+
+export function generateWorldAttributeSchema(input: {
+  worldName: string;
+  settingText: string;
+  summary: string;
+  tone: string;
+  playerGoal: string;
+}) {
+  const inferredWorldType = inferWorldTypeFromSetting(input.settingText);
+  const template = buildTemplateWorldAttributeSchema(
+    inferredWorldType === 'XIANXIA' ? 'XIANXIA' : 'WUXIA',
+  );
+
+  return {
+    ...template,
+    id: `schema:custom:${slugify(input.worldName)}`,
+    worldId: `custom:${input.worldName}`,
+    generatedFrom: {
+      worldType: 'CUSTOM',
+      worldName: input.worldName,
+      settingSummary: input.summary,
+      tone: input.tone,
+      conflictCore: input.playerGoal,
+    },
+  } satisfies WorldAttributeSchema;
+}
+
+function normalizeAttributeValues(
+  values: AttributeVector,
+  slotIds: readonly string[],
+  targetTotal = 360,
+) {
+  const positiveValues = slotIds.map((slotId) => Math.max(0, values[slotId] ?? 0));
+  const rawTotal = positiveValues.reduce((sum, value) => sum + value, 0);
+  const normalized =
+    rawTotal > 0
+      ? positiveValues.map((value) => (value / rawTotal) * targetTotal)
+      : slotIds.map(() => targetTotal / Math.max(slotIds.length, 1));
+  const rounded = normalized.map((value) => Math.max(0, Math.min(100, Math.round(value))));
+  return Object.fromEntries(
+    slotIds.map((slotId, index) => [slotId, rounded[index] ?? 0]),
+  ) as AttributeVector;
+}
+
+function ensureRoleAttributeProfile(
+  profile: Partial<RoleAttributeProfile> | null | undefined,
+  schema: WorldAttributeSchema,
+  fallbackValues: AttributeVector,
+): RoleAttributeProfile {
+  const slotIds = schema.slots.map((slot) => slot.slotId);
+  const values = normalizeAttributeValues(
+    {
+      ...fallbackValues,
+      ...(profile?.values ?? {}),
+    },
+    slotIds,
+  );
+  const sortedSlots = [...schema.slots]
+    .map((slot) => ({
+      slot,
+      value: values[slot.slotId] ?? 0,
+    }))
+    .sort((left, right) => right.value - left.value);
+
+  return {
+    schemaId: profile?.schemaId ?? schema.id,
+    values,
+    topTraits: sortedSlots.slice(0, 2).map((entry) => entry.slot.name),
+    hiddenTraits: profile?.hiddenTraits ? [...profile.hiddenTraits] : undefined,
+    evidence:
+      profile?.evidence?.length
+        ? [...profile.evidence]
+        : sortedSlots.slice(0, 3).map((entry) => ({
+            slotId: entry.slot.slotId,
+            reason: `${entry.slot.name}在当前画像中最突出。`,
+          })),
+  };
+}
+
+function buildDefaultAxisVector(
+  overrides: Partial<Record<(typeof WORLD_ATTRIBUTE_SLOT_IDS)[number], number>>,
+) {
+  return WORLD_ATTRIBUTE_SLOT_IDS.reduce<AttributeVector>((result, slotId) => {
+    result[slotId] = overrides[slotId] ?? 0;
+    return result;
+  }, {});
+}
+
+function buildRoleAttributeProfileFromTexts(params: {
+  schema: WorldAttributeSchema;
+  textBlocks: Array<string | null | undefined>;
+}) {
+  const sourceText = params.textBlocks.filter(Boolean).join(' ');
+  const seed = buildDefaultAxisVector({
+    axis_a: 58,
+    axis_b: 58,
+    axis_c: 58,
+    axis_d: 58,
+    axis_e: 58,
+    axis_f: 58,
+  });
+
+  AXIS_KEYWORD_RULES.forEach((rule) => {
+    const matches = rule.patterns.reduce(
+      (count, pattern) => count + (pattern.test(sourceText) ? 1 : 0),
+      0,
+    );
+    if (matches <= 0) {
+      return;
+    }
+    seed[rule.slotId] = (seed[rule.slotId] ?? 0) + rule.weight * matches;
+  });
+
+  return ensureRoleAttributeProfile(
+    {
+      schemaId: params.schema.id,
+    },
+    params.schema,
+    seed,
+  );
+}
+
+export function buildCustomWorldPlayableNpcAttributeProfile(
+  npc: CustomWorldPlayableNpc,
+  schema: WorldAttributeSchema,
+) {
+  return buildRoleAttributeProfileFromTexts({
+    schema,
+    textBlocks: [
+      npc.title,
+      npc.role,
+      npc.description,
+      npc.backstory,
+      npc.personality,
+      npc.motivation,
+      npc.combatStyle,
+      ...(npc.relationshipHooks ?? []),
+      ...(npc.tags ?? []),
+    ],
+  });
+}
+
+export function buildCustomWorldStoryNpcAttributeProfile(
+  npc: CustomWorldNpc,
+  schema: WorldAttributeSchema,
+) {
+  return buildRoleAttributeProfileFromTexts({
+    schema,
+    textBlocks: [
+      npc.title,
+      npc.role,
+      npc.description,
+      npc.backstory,
+      npc.personality,
+      npc.motivation,
+      npc.combatStyle,
+      ...(npc.relationshipHooks ?? []),
+      ...(npc.tags ?? []),
+    ],
+  });
+}
diff --git a/server-node/src/modules/custom-world/runtime-profile/buildCompiledProfile.ts b/server-node/src/modules/custom-world/runtime-profile/buildCompiledProfile.ts
new file mode 100644
index 00000000..f9965b6f
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/buildCompiledProfile.ts
@@ -0,0 +1,410 @@
+import type {
+  CustomWorldGenerationFramework,
+  CustomWorldProfile,
+} from '../runtimeTypes.js';
+import {
+  buildCustomWorldPlayableNpcAttributeProfile,
+  buildCustomWorldStoryNpcAttributeProfile,
+  generateWorldAttributeSchema,
+} from './buildAttributeSchema.js';
+import {
+  buildWorldName,
+  inferWorldTypeFromSetting,
+  normalizeWorldType,
+  normalizeCustomWorldCreatorIntent,
+  normalizeCustomWorldLockState,
+  resolveCustomWorldRuntimeIntentBridge,
+} from './creatorIntentBridge.js';
+import {
+  buildFallbackCustomWorldCampScene,
+  normalizeCampOutline,
+  normalizeCampScene,
+} from './normalizeCamp.js';
+import {
+  buildCustomWorldRawProfileLandmarksFromFramework,
+  normalizeLandmarkOutlineList,
+  normalizeLandmarks,
+} from './normalizeLandmark.js';
+import {
+  buildCustomWorldRawProfileRolesFromFramework,
+  normalizeCustomWorldGenerationFrameworkRoles,
+  normalizePlayableNpcList,
+  normalizeStoryNpcList,
+} from './normalizeRole.js';
+import {
+  buildDefaultCustomWorldCover,
+  MIN_CUSTOM_WORLD_LANDMARK_COUNT,
+  MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT,
+  normalizeCustomWorldCover,
+  normalizeItemList,
+  normalizeTags,
+  PLAYABLE_TEMPLATE_CHARACTER_IDS,
+  slugify,
+  toRecordArray,
+  toText,
+} from './normalizeShared.js';
+import { normalizeSceneChapterBlueprints } from './normalizeSceneChapter.js';
+
+/**
+ * 工作包 G：
+ * 让 runtime profile 真正由“主编译入口 + 目录化 normalize/build 子模块”组成。
+ */
+
+function buildBaseCustomWorldProfile(settingText: string): CustomWorldProfile {
+  const templateWorldType = inferWorldTypeFromSetting(settingText);
+  const name = buildWorldName(settingText, templateWorldType);
+  const subtitle = '前路未明';
+  const summary = settingText.trim()
+    ? `这个世界围绕“${settingText.trim().slice(0, 28)}”展开。`
+    : '一个仍待展开的独立世界正在成形。';
+  const tone = '未知、紧绷、仍在展开';
+  const playerGoal = '查清眼前局势的关键矛盾，并守住仍值得相信的人与事';
+  const camp = buildFallbackCustomWorldCampScene({
+    name,
+    summary,
+    tone,
+    playerGoal,
+    settingText: settingText.trim(),
+  });
+
+  return {
+    id: `custom-world-${Date.now().toString(36)}-${slugify(name)}`,
+    settingText: settingText.trim(),
+    name,
+    subtitle,
+    summary,
+    tone,
+    playerGoal,
+    cover: buildDefaultCustomWorldCover([]),
+    templateWorldType,
+    compatibilityTemplateWorldType: templateWorldType,
+    majorFactions: [],
+    coreConflicts: [summary],
+    attributeSchema: generateWorldAttributeSchema({
+      worldName: name,
+      settingText: settingText.trim(),
+      summary,
+      tone,
+      playerGoal,
+    }),
+    playableNpcs: [],
+    storyNpcs: [],
+    items: [],
+    camp,
+    landmarks: [],
+    themePack: null,
+    storyGraph: null,
+    creatorIntent: null,
+    anchorPack: null,
+    lockState: normalizeCustomWorldLockState(null),
+    generationMode: 'full',
+    generationStatus: 'complete',
+    ownedSettingLayers: null,
+    scenarioPackId: null,
+    campaignPackId: null,
+  };
+}
+
+export function normalizeCustomWorldGenerationFramework(
+  raw: unknown,
+  settingText: string,
+): CustomWorldGenerationFramework {
+  const fallback = buildBaseCustomWorldProfile(settingText);
+  if (!raw || typeof raw !== 'object') {
+    return {
+      settingText: fallback.settingText,
+      name: fallback.name,
+      subtitle: fallback.subtitle,
+      summary: fallback.summary,
+      tone: fallback.tone,
+      playerGoal: fallback.playerGoal,
+      templateWorldType: fallback.templateWorldType,
+      compatibilityTemplateWorldType:
+        fallback.compatibilityTemplateWorldType ?? fallback.templateWorldType,
+      majorFactions: [],
+      coreConflicts: [fallback.summary],
+      camp: {
+        name: fallback.camp?.name ?? '归舍',
+        description: fallback.camp?.description ?? '',
+        dangerLevel: fallback.camp?.dangerLevel ?? 'low',
+      },
+      playableNpcs: [],
+      storyNpcs: [],
+      landmarks: [],
+    };
+  }
+
+  const item = raw as Record<string, unknown>;
+  const roleState = normalizeCustomWorldGenerationFrameworkRoles({
+    raw: item,
+    fallback,
+    settingText,
+  });
+
+  return {
+    settingText: settingText.trim(),
+    name: roleState.name,
+    subtitle: toText(item.subtitle) || fallback.subtitle,
+    summary: toText(item.summary) || fallback.summary,
+    tone: toText(item.tone) || fallback.tone,
+    playerGoal: toText(item.playerGoal) || fallback.playerGoal,
+    templateWorldType: roleState.templateWorldType,
+    compatibilityTemplateWorldType: roleState.templateWorldType,
+    majorFactions: normalizeTags(item.majorFactions, []),
+    coreConflicts: normalizeTags(item.coreConflicts, [fallback.summary]),
+    camp: {
+      name: normalizeCampOutline(item.camp, roleState.campFallbackProfile).name,
+      description: normalizeCampOutline(item.camp, roleState.campFallbackProfile)
+        .description,
+      dangerLevel: normalizeCampOutline(item.camp, roleState.campFallbackProfile)
+        .dangerLevel,
+    },
+    playableNpcs: roleState.playableNpcs,
+    storyNpcs: roleState.storyNpcs,
+    landmarks: normalizeLandmarkOutlineList(item.landmarks),
+  };
+}
+
+export function buildCustomWorldRawProfileFromFramework(
+  framework: CustomWorldGenerationFramework,
+) {
+  return {
+    name: framework.name,
+    subtitle: framework.subtitle,
+    summary: framework.summary,
+    tone: framework.tone,
+    playerGoal: framework.playerGoal,
+    templateWorldType: framework.templateWorldType,
+    compatibilityTemplateWorldType: framework.compatibilityTemplateWorldType,
+    majorFactions: framework.majorFactions,
+    coreConflicts: framework.coreConflicts,
+    camp: {
+      name: framework.camp.name,
+      description: framework.camp.description,
+      dangerLevel: framework.camp.dangerLevel,
+    },
+    ...buildCustomWorldRawProfileRolesFromFramework(framework),
+    landmarks: buildCustomWorldRawProfileLandmarksFromFramework(framework),
+  };
+}
+
+function pickCyclic<T>(items: readonly T[], index: number, label: string): T {
+  const item = items[index % items.length];
+  if (item === undefined) {
+    throw new Error(`Missing ${label}`);
+  }
+  return item;
+}
+
+export function normalizeCustomWorldProfile(
+  raw: unknown,
+  settingText: string,
+): CustomWorldProfile {
+  const fallback = buildBaseCustomWorldProfile(settingText);
+  if (!raw || typeof raw !== 'object') {
+    return fallback;
+  }
+
+  const item = raw as Record<string, unknown>;
+  const worldSignalText = [
+    settingText,
+    toText(item.subtitle),
+    toText(item.summary),
+    toText(item.tone),
+    toText(item.playerGoal),
+  ].join(' ');
+  const templateWorldType = normalizeWorldType(
+    item.templateWorldType,
+    worldSignalText,
+  );
+  const name =
+    toText(item.name) || buildWorldName(settingText, templateWorldType);
+  const summary = toText(item.summary) || fallback.summary;
+  const tone = toText(item.tone) || fallback.tone;
+  const playerGoal = toText(item.playerGoal) || fallback.playerGoal;
+  const generatedAttributeSchema = generateWorldAttributeSchema({
+    worldName: name,
+    settingText: settingText.trim(),
+    summary,
+    tone,
+    playerGoal,
+  });
+  const playableNpcs = normalizePlayableNpcList(item.playableNpcs);
+  const storyNpcs = normalizeStoryNpcList(item.storyNpcs);
+  const landmarkDrafts = toRecordArray(item.landmarks);
+  const camp = normalizeCampScene(item.camp, {
+    name,
+    summary,
+    tone,
+    playerGoal,
+    settingText: settingText.trim(),
+  });
+  const runtimeBridge = resolveCustomWorldRuntimeIntentBridge(item);
+
+  return {
+    id:
+      toText(item.id) || `custom-world-${Date.now().toString(36)}-${slugify(name)}`,
+    settingText: settingText.trim(),
+    name,
+    subtitle: toText(item.subtitle) || fallback.subtitle,
+    summary,
+    tone,
+    playerGoal,
+    cover: normalizeCustomWorldCover(item.cover, playableNpcs),
+    templateWorldType,
+    compatibilityTemplateWorldType: templateWorldType,
+    majorFactions: normalizeTags(item.majorFactions, []),
+    coreConflicts: normalizeTags(item.coreConflicts, [summary]),
+    attributeSchema:
+      item.attributeSchema && typeof item.attributeSchema === 'object'
+        ? generatedAttributeSchema
+        : generatedAttributeSchema,
+    playableNpcs,
+    storyNpcs,
+    items: normalizeItemList(item.items),
+    camp,
+    landmarks: normalizeLandmarks({
+      landmarks: landmarkDrafts,
+      storyNpcs,
+    }),
+    themePack:
+      item.themePack && typeof item.themePack === 'object'
+        ? (item.themePack as CustomWorldProfile['themePack'])
+        : null,
+    storyGraph:
+      item.storyGraph && typeof item.storyGraph === 'object'
+        ? (item.storyGraph as CustomWorldProfile['storyGraph'])
+        : null,
+    anchorContent:
+      item.anchorContent && typeof item.anchorContent === 'object'
+        ? (item.anchorContent as Record<string, unknown>)
+        : null,
+    creatorIntent: runtimeBridge.creatorIntent,
+    anchorPack: runtimeBridge.anchorPack,
+    lockState: runtimeBridge.lockState,
+    generationMode:
+      item.generationMode === 'fast' || item.generationMode === 'full'
+        ? item.generationMode
+        : fallback.generationMode,
+    generationStatus:
+      item.generationStatus === 'key_only' || item.generationStatus === 'complete'
+        ? item.generationStatus
+        : fallback.generationStatus,
+    ownedSettingLayers:
+      item.ownedSettingLayers && typeof item.ownedSettingLayers === 'object'
+        ? (item.ownedSettingLayers as Record<string, unknown>)
+        : null,
+    knowledgeFacts:
+      Array.isArray(item.knowledgeFacts)
+        ? (item.knowledgeFacts as Array<Record<string, unknown>>)
+        : null,
+    threadContracts:
+      Array.isArray(item.threadContracts)
+        ? (item.threadContracts as Array<Record<string, unknown>>)
+        : null,
+    sceneChapterBlueprints: normalizeSceneChapterBlueprints(
+      item.sceneChapterBlueprints,
+    ),
+    scenarioPackId: toText(item.scenarioPackId) || null,
+    campaignPackId: toText(item.campaignPackId) || null,
+  };
+}
+
+export function buildCompiledCustomWorldProfile(
+  raw: unknown,
+  settingText: string,
+): CustomWorldProfile {
+  const profile = normalizeCustomWorldProfile(raw, settingText);
+  const playableNpcs = profile.playableNpcs.map((npc, index) => {
+    const templateCharacterId =
+      npc.templateCharacterId ??
+      pickCyclic(
+        PLAYABLE_TEMPLATE_CHARACTER_IDS,
+        index,
+        'playable template character id',
+      );
+
+    return {
+      ...npc,
+      templateCharacterId,
+      attributeProfile:
+        npc.attributeProfile ??
+        buildCustomWorldPlayableNpcAttributeProfile(
+          {
+            ...npc,
+            templateCharacterId,
+          },
+          profile.attributeSchema,
+        ),
+    };
+  });
+
+  const storyNpcs = profile.storyNpcs.map((npc) => ({
+    ...npc,
+    attributeProfile:
+      npc.attributeProfile ??
+      buildCustomWorldStoryNpcAttributeProfile(npc, profile.attributeSchema),
+  }));
+
+  return {
+    ...profile,
+    playableNpcs,
+    storyNpcs,
+    scenarioPackId:
+      profile.scenarioPackId ?? `scenario-pack:${slugify(profile.name)}`,
+    campaignPackId:
+      profile.campaignPackId ?? `campaign-pack:${slugify(profile.name)}`,
+  };
+}
+
+function countUniqueNames(items: Array<{ name: string }>) {
+  return new Set(items.map((item) => item.name.trim()).filter(Boolean)).size;
+}
+
+export function validateGeneratedCustomWorldProfile(
+  profile: CustomWorldProfile,
+) {
+  const playableCount = countUniqueNames(profile.playableNpcs);
+  const landmarkCount = countUniqueNames(profile.landmarks);
+
+  if (playableCount < MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT) {
+    throw new Error(
+      `自定义世界生成要求模型至少产出 ${MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT} 名可扮演角色。`,
+    );
+  }
+
+  if (landmarkCount < MIN_CUSTOM_WORLD_LANDMARK_COUNT) {
+    throw new Error(
+      `自定义世界生成要求至少产出 ${MIN_CUSTOM_WORLD_LANDMARK_COUNT} 个场景，当前仅返回 ${landmarkCount} 个。`,
+    );
+  }
+
+  const validStoryNpcIds = new Set(profile.storyNpcs.map((npc) => npc.id));
+  const validLandmarkIds = new Set(
+    profile.landmarks.map((landmark) => landmark.id),
+  );
+
+  profile.landmarks.forEach((landmark) => {
+    const uniqueSceneNpcIds = [...new Set(landmark.sceneNpcIds)];
+    if (uniqueSceneNpcIds.length < 3) {
+      throw new Error(
+        `场景「${landmark.name}」至少需要关联 3 个场景角色，当前仅有 ${uniqueSceneNpcIds.length} 个。`,
+      );
+    }
+    if (uniqueSceneNpcIds.some((npcId) => !validStoryNpcIds.has(npcId))) {
+      throw new Error(`场景「${landmark.name}」引用了不存在的场景角色。`);
+    }
+    if (landmark.connections.length === 0) {
+      throw new Error(`场景「${landmark.name}」缺少可用的场景连接关系。`);
+    }
+    if (
+      landmark.connections.some(
+        (connection) =>
+          connection.targetLandmarkId === landmark.id ||
+          !validLandmarkIds.has(connection.targetLandmarkId),
+      )
+    ) {
+      throw new Error(`场景「${landmark.name}」存在无效的目标场景连接。`);
+    }
+  });
+}
diff --git a/server-node/src/modules/custom-world/runtime-profile/creatorIntentBridge.ts b/server-node/src/modules/custom-world/runtime-profile/creatorIntentBridge.ts
new file mode 100644
index 00000000..e194eae5
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/creatorIntentBridge.ts
@@ -0,0 +1,82 @@
+import {
+  buildCustomWorldAnchorPackFromIntent,
+  deriveCustomWorldLockStateFromIntent,
+  normalizeCustomWorldCreatorIntent,
+  normalizeCustomWorldLockState,
+} from '../creatorIntentRuntime.js';
+import type {
+  CustomWorldCreatorIntent,
+  CustomWorldProfile,
+  WorldType,
+} from '../runtimeTypes.js';
+import { toText } from './normalizeShared.js';
+
+/**
+ * 工作包 G：
+ * 统一 runtime profile 对 creator intent、anchor pack 和 lock state 的桥接入口，
+ * 避免主编译器继续直接拼装这些兼容字段。
+ */
+
+export function inferWorldTypeFromSetting(settingText: string): WorldType {
+  return /[仙灵修真飞升灵脉宗门法器天宫秘境道骨星舰]/u.test(settingText)
+    ? 'XIANXIA'
+    : 'WUXIA';
+}
+
+export function normalizeWorldType(value: unknown, sourceText: string): WorldType {
+  const worldType = toText(value).toUpperCase();
+  if (worldType === 'WUXIA' || worldType === 'XIANXIA') {
+    return worldType;
+  }
+  return inferWorldTypeFromSetting(sourceText);
+}
+
+export function buildSeedPhrase(settingText: string, fallback: string) {
+  const compact = settingText.replace(/\s+/g, '').trim();
+  return compact ? compact.slice(0, 10) : fallback;
+}
+
+export function buildWorldName(settingText: string, worldType: WorldType) {
+  const seed = buildSeedPhrase(settingText, '新旅');
+  const suffix = worldType === 'XIANXIA' ? '境' : '域';
+  return `${seed}${suffix}`;
+}
+
+export {
+  normalizeCustomWorldCreatorIntent,
+  normalizeCustomWorldLockState,
+};
+
+export function buildEmptyCustomWorldRuntimeBridge() {
+  return {
+    creatorIntent: null,
+    anchorPack: null,
+    lockState: normalizeCustomWorldLockState(null),
+  } satisfies {
+    creatorIntent: CustomWorldCreatorIntent | null;
+    anchorPack: CustomWorldProfile['anchorPack'];
+    lockState: CustomWorldProfile['lockState'];
+  };
+}
+
+export function resolveCustomWorldRuntimeIntentBridge(
+  raw: Record<string, unknown>,
+) {
+  const creatorIntent = normalizeCustomWorldCreatorIntent(raw.creatorIntent);
+
+  return {
+    creatorIntent,
+    anchorPack:
+      raw.anchorPack && typeof raw.anchorPack === 'object'
+        ? (raw.anchorPack as CustomWorldProfile['anchorPack'])
+        : buildCustomWorldAnchorPackFromIntent(creatorIntent),
+    lockState:
+      raw.lockState && typeof raw.lockState === 'object'
+        ? normalizeCustomWorldLockState(raw.lockState)
+        : deriveCustomWorldLockStateFromIntent(creatorIntent),
+  } satisfies {
+    creatorIntent: CustomWorldCreatorIntent | null;
+    anchorPack: CustomWorldProfile['anchorPack'];
+    lockState: CustomWorldProfile['lockState'];
+  };
+}
diff --git a/server-node/src/modules/custom-world/runtime-profile/index.ts b/server-node/src/modules/custom-world/runtime-profile/index.ts
new file mode 100644
index 00000000..60911cc7
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/index.ts
@@ -0,0 +1,13 @@
+/**
+ * 工作包 G：
+ * custom world runtime profile 的主入口统一收口到目录化模块。
+ * 主编译逻辑和各类 normalize/build 子模块已经物理拆分，旧 compiler 文件只保留兼容转发。
+ */
+export * from './buildAttributeSchema.js';
+export * from './buildCompiledProfile.js';
+export * from './creatorIntentBridge.js';
+export * from './normalizeCamp.js';
+export * from './normalizeLandmark.js';
+export * from './normalizeRole.js';
+export * from './normalizeSceneChapter.js';
+export * from './normalizeShared.js';
diff --git a/server-node/src/modules/custom-world/runtime-profile/normalizeCamp.ts b/server-node/src/modules/custom-world/runtime-profile/normalizeCamp.ts
new file mode 100644
index 00000000..efdf5d30
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/normalizeCamp.ts
@@ -0,0 +1,178 @@
+import type {
+  CustomWorldCampScene,
+  CustomWorldGenerationCampOutline,
+} from '../runtimeTypes.js';
+import {
+  clampText,
+  toRecordArray,
+  toStringArray,
+  toText,
+} from './normalizeShared.js';
+
+/**
+ * 工作包 G：
+ * 营地 fallback、outline 归一和 runtime 场景归一单独收口，
+ * 避免主编译器继续混合 UI 展示语义和营地领域默认值。
+ */
+
+export type CustomWorldCampFallbackProfile = {
+  name: string;
+  summary: string;
+  tone: string;
+  playerGoal: string;
+  settingText: string;
+};
+
+function detectCustomWorldThemeMode(profile: {
+  settingText: string;
+  summary: string;
+  tone: string;
+  playerGoal: string;
+}) {
+  const source = [
+    profile.settingText,
+    profile.summary,
+    profile.tone,
+    profile.playerGoal,
+  ].join(' ');
+
+  if (/[机关蒸汽齿轮工坊机巧城轨炮舰]/u.test(source)) return 'machina';
+  if (/[海潮港湾船舟湖泊澜雾湾]/u.test(source)) return 'tide';
+  if (/[裂缝裂界边境前线断层界桥灰域]/u.test(source)) return 'rift';
+  if (/[修真仙灵宗门法器道脉秘境云阙]/u.test(source)) return 'arcane';
+  if (/[江湖门派镖局朝廷刀剑侠客旧案]/u.test(source)) return 'martial';
+  return 'mythic';
+}
+
+function sanitizeCampSeed(name: string) {
+  const normalized = name.trim().replace(/\s+/g, '');
+  if (!normalized) {
+    return '';
+  }
+
+  const stripped = normalized.replace(
+    /(世界|江湖|边城|仙洲|仙境|灵境|界|录|域|境)$/u,
+    '',
+  );
+  const seed = stripped || normalized;
+
+  return seed.slice(0, Math.min(seed.length, 4));
+}
+
+function buildFallbackCampName(profile: CustomWorldCampFallbackProfile) {
+  const seed = sanitizeCampSeed(profile.name) || '归途';
+  const themeMode = detectCustomWorldThemeMode(profile);
+
+  const suffixByMode = {
+    mythic: '归舍',
+    martial: '归舍',
+    arcane: '栖居',
+    machina: '整备居',
+    tide: '潮居',
+    rift: '界隙居所',
+  } as const;
+
+  return `${seed}${suffixByMode[themeMode]}`;
+}
+
+export function buildFallbackCustomWorldCampScene(
+  profile: CustomWorldCampFallbackProfile,
+): CustomWorldCampScene {
+  const fallbackName = buildFallbackCampName(profile);
+  const summaryLead = clampText(profile.summary, 24) || '前路尚未明朗';
+  const goalLead = clampText(profile.playerGoal, 24) || '继续整理线索';
+  const themeMode = detectCustomWorldThemeMode(profile);
+
+  const descriptionByMode = {
+    mythic: `${fallbackName}是你在${profile.name}暂时安顿的归处，能整备行装、交换判断，并围绕“${goalLead}”继续启程。`,
+    martial: `${fallbackName}是你在${profile.name}暂时落脚的归处，能整备行装、收拢同伴，并朝“${goalLead}”继续动身。`,
+    arcane: `${fallbackName}是你在${profile.name}暂时栖身的居所，适合调息、整理法器，并围绕“${summaryLead}”交换判断。`,
+    machina: `${fallbackName}是你在${profile.name}的临时居所，能检修装备、补齐物资，并为下一段行动重新校准节奏。`,
+    tide: `${fallbackName}是你在${profile.name}靠潮歇息的住处，能安顿队伍、整理补给，并顺着“${goalLead}”继续前探。`,
+    rift: `${fallbackName}是你在${profile.name}勉强守住的一处居所，既能短暂停步，也能围绕“${summaryLead}”商量下一步去向。`,
+  } as const;
+
+  return {
+    id: 'custom-scene-camp',
+    name: fallbackName,
+    description: descriptionByMode[themeMode],
+    dangerLevel: 'low',
+    sceneNpcIds: [],
+    connections: [],
+    narrativeResidues: null,
+  };
+}
+
+export function normalizeCampOutline(
+  value: unknown,
+  fallbackProfile: CustomWorldCampFallbackProfile,
+) {
+  const fallback = buildFallbackCustomWorldCampScene(fallbackProfile);
+  const item =
+    value && typeof value === 'object'
+      ? (value as Record<string, unknown>)
+      : {};
+
+  return {
+    id: toText(item.id) || fallback.id,
+    name: toText(item.name) || fallback.name,
+    description: toText(item.description) || fallback.description,
+    visualDescription: toText(item.visualDescription) || undefined,
+    dangerLevel: toText(item.dangerLevel) || fallback.dangerLevel,
+    imageSrc: toText(item.imageSrc) || undefined,
+    sceneNpcIds: toStringArray(item.sceneNpcIds),
+    connections: toRecordArray(item.connections)
+      .map((connection) => ({
+        targetLandmarkName:
+          toText(connection.targetLandmarkName) ||
+          toText(connection.target) ||
+          toText(connection.sceneName),
+        relativePosition:
+          toText(connection.relativePosition) ||
+          toText(connection.position) ||
+          'forward',
+        summary: toText(connection.summary) || toText(connection.description),
+      }))
+      .filter((connection) => connection.targetLandmarkName),
+  } satisfies CustomWorldGenerationCampOutline & {
+    id: string;
+    visualDescription?: string;
+    imageSrc?: string;
+    sceneNpcIds: string[];
+    connections: Array<{
+      targetLandmarkName: string;
+      relativePosition: string;
+      summary: string;
+    }>;
+  };
+}
+
+export function normalizeCampScene(
+  value: unknown,
+  fallbackProfile: CustomWorldCampFallbackProfile,
+): CustomWorldCampScene {
+  const fallback = buildFallbackCustomWorldCampScene(fallbackProfile);
+  const item =
+    value && typeof value === 'object'
+      ? (value as Record<string, unknown>)
+      : {};
+
+  return {
+    id: toText(item.id) || fallback.id,
+    name: toText(item.name) || fallback.name,
+    description: toText(item.description) || fallback.description,
+    visualDescription: toText(item.visualDescription) || undefined,
+    dangerLevel: toText(item.dangerLevel) || fallback.dangerLevel,
+    imageSrc: toText(item.imageSrc) || undefined,
+    sceneNpcIds: toStringArray(item.sceneNpcIds),
+    connections: toRecordArray(item.connections)
+      .map((connection) => ({
+        targetLandmarkId: toText(connection.targetLandmarkId),
+        relativePosition:
+          toText(connection.relativePosition) || toText(connection.position) || 'forward',
+        summary: toText(connection.summary) || toText(connection.description),
+      }))
+      .filter((connection) => connection.targetLandmarkId),
+    narrativeResidues: null,
+  };
+}
diff --git a/server-node/src/modules/custom-world/runtime-profile/normalizeLandmark.ts b/server-node/src/modules/custom-world/runtime-profile/normalizeLandmark.ts
new file mode 100644
index 00000000..ee7f5041
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/normalizeLandmark.ts
@@ -0,0 +1,151 @@
+import type {
+  CustomWorldGenerationFramework,
+  CustomWorldGenerationLandmarkOutline,
+  CustomWorldNpc,
+} from '../runtimeTypes.js';
+import {
+  clampText,
+  createEntryId,
+  MIN_CUSTOM_WORLD_LANDMARK_COUNT,
+  toRecordArray,
+  toStringArray,
+  toText,
+} from './normalizeShared.js';
+
+/**
+ * 工作包 G：
+ * 世界地点 outline/runtime 归一独立收口，避免地点网络解析继续和角色、场景章节逻辑混在一个文件里。
+ */
+
+export function normalizeLandmarkOutlineList(value: unknown) {
+  return toRecordArray(value)
+    .map((item) => {
+      const name = toText(item.name);
+      return {
+        name,
+        description:
+          toText(item.description) ||
+          clampText(`${name}暗藏新的局势变化。`, 40),
+        visualDescription: toText(item.visualDescription) || undefined,
+        dangerLevel: toText(item.dangerLevel) || 'medium',
+        sceneNpcNames: [
+          ...toStringArray(item.sceneNpcNames),
+          ...toStringArray(item.npcs, 'name'),
+          ...toStringArray(item.sceneNpcs, 'name'),
+          ...toStringArray(item.npcNames),
+        ],
+        connections: toRecordArray(item.connections)
+          .map((connection) => ({
+            targetLandmarkName:
+              toText(connection.targetLandmarkName) ||
+              toText(connection.target) ||
+              toText(connection.sceneName),
+            relativePosition:
+              toText(connection.relativePosition) ||
+              toText(connection.position) ||
+              'forward',
+            summary:
+              toText(connection.summary) || toText(connection.description),
+          }))
+          .filter((connection) => connection.targetLandmarkName),
+      } satisfies CustomWorldGenerationLandmarkOutline;
+    })
+    .filter((entry) => entry.name)
+    .slice(0, MIN_CUSTOM_WORLD_LANDMARK_COUNT);
+}
+
+export function normalizeCustomWorldGenerationLandmarkOutlineBatch(raw: unknown) {
+  const item =
+    raw && typeof raw === 'object' ? (raw as Record<string, unknown>) : {};
+  return normalizeLandmarkOutlineList(item.landmarks);
+}
+
+export function buildCustomWorldRawProfileLandmarksFromFramework(
+  framework: CustomWorldGenerationFramework,
+) {
+  return framework.landmarks.map((landmark) => ({
+    name: landmark.name,
+    description: landmark.description,
+    visualDescription: landmark.visualDescription,
+    dangerLevel: landmark.dangerLevel,
+    sceneNpcNames: [...landmark.sceneNpcNames],
+    connections: landmark.connections.map((connection) => ({
+      targetLandmarkName: connection.targetLandmarkName,
+      relativePosition: connection.relativePosition,
+      summary: connection.summary,
+    })),
+  }));
+}
+
+export function normalizeLandmarks(params: {
+  landmarks: Array<Record<string, unknown>>;
+  storyNpcs: CustomWorldNpc[];
+}) {
+  const storyNpcIdByName = new Map(
+    params.storyNpcs.map((npc) => [npc.name.trim(), npc.id] as const),
+  );
+  const landmarkEntries = params.landmarks
+    .map((item, index) => ({
+      id: toText(item.id) || createEntryId('landmark', toText(item.name), index),
+      name: toText(item.name),
+      description: toText(item.description),
+      visualDescription: toText(item.visualDescription) || undefined,
+      dangerLevel: toText(item.dangerLevel) || 'medium',
+      imageSrc: toText(item.imageSrc) || undefined,
+      sceneNpcIds: toStringArray(item.sceneNpcIds),
+      sceneNpcNames: [
+        ...toStringArray(item.sceneNpcNames),
+        ...toStringArray(item.npcs, 'name'),
+        ...toStringArray(item.sceneNpcs, 'name'),
+        ...toStringArray(item.npcNames),
+      ],
+      connections: toRecordArray(item.connections).map((connection) => ({
+        targetLandmarkId: toText(connection.targetLandmarkId),
+        targetLandmarkName:
+          toText(connection.targetLandmarkName) ||
+          toText(connection.target) ||
+          toText(connection.sceneName),
+        relativePosition:
+          toText(connection.relativePosition) || toText(connection.position),
+        summary: toText(connection.summary) || toText(connection.description),
+      })),
+    }))
+    .filter((entry) => entry.name);
+
+  const landmarkIdByName = new Map(
+    landmarkEntries.map((landmark) => [landmark.name.trim(), landmark.id] as const),
+  );
+
+  return landmarkEntries.map((landmark) => {
+    const resolvedSceneNpcIds = [
+      ...new Set(
+        [
+          ...landmark.sceneNpcIds,
+          ...landmark.sceneNpcNames
+            .map((name) => storyNpcIdByName.get(name.trim()) ?? '')
+            .filter(Boolean),
+        ].filter(Boolean),
+      ),
+    ];
+
+    return {
+      id: landmark.id,
+      name: landmark.name,
+      description: landmark.description,
+      visualDescription: landmark.visualDescription,
+      dangerLevel: landmark.dangerLevel,
+      imageSrc: landmark.imageSrc,
+      sceneNpcIds: resolvedSceneNpcIds,
+      connections: landmark.connections
+        .map((connection) => ({
+          targetLandmarkId:
+            connection.targetLandmarkId ||
+            landmarkIdByName.get(connection.targetLandmarkName.trim()) ||
+            '',
+          relativePosition: connection.relativePosition || 'forward',
+          summary: connection.summary,
+        }))
+        .filter((connection) => connection.targetLandmarkId),
+    };
+  });
+}
diff --git a/server-node/src/modules/custom-world/runtime-profile/normalizeRole.ts b/server-node/src/modules/custom-world/runtime-profile/normalizeRole.ts
new file mode 100644
index 00000000..ff8e5e92
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/normalizeRole.ts
@@ -0,0 +1,541 @@
+import type {
+  CharacterBackstoryChapter,
+  CharacterBackstoryRevealConfig,
+  CustomWorldGenerationFramework,
+  CustomWorldGenerationRoleBatchType,
+  CustomWorldGenerationRoleOutline,
+  CustomWorldNpc,
+  CustomWorldPlayableNpc,
+  CustomWorldProfile,
+  CustomWorldRoleInitialItem,
+  CustomWorldRoleProfile,
+  CustomWorldRoleSkill,
+} from '../runtimeTypes.js';
+import {
+  buildWorldName,
+  normalizeWorldType,
+} from './creatorIntentBridge.js';
+import {
+  clampCustomWorldAffinity,
+  clampText,
+  createEntryId,
+  MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT,
+  MIN_CUSTOM_WORLD_STORY_NPC_COUNT,
+  normalizeInitialAffinity,
+  normalizeRarity,
+  normalizeRoleItemCategory,
+  normalizeTags,
+  toRecordArray,
+  toText,
+} from './normalizeShared.js';
+
+/**
+ * 工作包 G：
+ * 把角色相关的 outline/runtime 归一、背景揭示、初始技能与物品 fallback 统一收口，
+ * 让主编译器只负责装配，不继续内嵌角色画像细节。
+ */
+
+const AFFINITY_BACKSTORY_CHAPTER_THRESHOLDS = [15, 30, 60, 90] as const;
+const DEFAULT_PRIVATE_CHAT_UNLOCK_AFFINITY = 60;
+const DEFAULT_PLAYABLE_INITIAL_AFFINITY = 18;
+const DEFAULT_STORY_NPC_INITIAL_AFFINITY = 6;
+const DEFAULT_CUSTOM_WORLD_ROLE_SKILL_COUNT = 3;
+const DEFAULT_CUSTOM_WORLD_ROLE_INITIAL_ITEM_COUNT = 3;
+const CUSTOM_WORLD_BACKSTORY_CHAPTER_TITLES = [
+  '表层来意',
+  '旧事裂痕',
+  '隐藏执念',
+  '最终底牌',
+] as const;
+
+type CustomWorldRoleFallbackSource = Pick<
+  CustomWorldRoleProfile,
+  | 'name'
+  | 'title'
+  | 'role'
+  | 'description'
+  | 'backstory'
+  | 'personality'
+  | 'motivation'
+  | 'combatStyle'
+  | 'relationshipHooks'
+  | 'tags'
+>;
+
+function splitNarrativeSentences(text: string) {
+  const normalized = text.replace(/\s+/g, ' ').trim();
+  if (!normalized) {
+    return [];
+  }
+  const matches = normalized.match(/[^。！？!?]+[。！？!?]?/gu);
+  return (matches ?? [normalized]).map((item) => item.trim()).filter(Boolean);
+}
+
+function buildFallbackBackstoryReveal(
+  source: CustomWorldRoleFallbackSource,
+): CharacterBackstoryRevealConfig {
+  const normalizedBackstory =
+    source.backstory.trim() || `${source.name}对自己的过去始终有所保留。`;
+  const backstorySentences = splitNarrativeSentences(normalizedBackstory);
+  const backstoryLead = backstorySentences[0] ?? normalizedBackstory;
+  const backstoryDetail =
+    backstorySentences.slice(0, 2).join('') || normalizedBackstory;
+  const publicSummary =
+    source.description.trim() || clampText(normalizedBackstory, 42);
+  const fallbackContents = [
+    source.description.trim() || backstoryLead,
+    backstoryDetail,
+    source.motivation.trim()
+      ? `${source.name}真正挂念的，是：${source.motivation.trim()}`
+      : `${source.name}的选择与“${clampText(backstoryLead, 24)}”直接相关。`,
+    source.personality.trim()
+      ? `${source.name}不会轻易说出的底色，是：${source.personality.trim()}`
+      : `${source.name}仍把最深的筹码藏在过去之中。`,
+  ];
+
+  return {
+    publicSummary,
+    privateChatUnlockAffinity: DEFAULT_PRIVATE_CHAT_UNLOCK_AFFINITY,
+    chapters: AFFINITY_BACKSTORY_CHAPTER_THRESHOLDS.map(
+      (affinityRequired, index) =>
+        ({
+          id: createEntryId(
+            'backstory-chapter',
+            `${source.name}-${CUSTOM_WORLD_BACKSTORY_CHAPTER_TITLES[index] ?? index + 1}`,
+            index,
+          ),
+          title:
+            CUSTOM_WORLD_BACKSTORY_CHAPTER_TITLES[index] ??
+            `背景片段${index + 1}`,
+          affinityRequired,
+          teaser: clampText(
+            fallbackContents[index] ?? normalizedBackstory,
+            22,
+          ),
+          content: clampText(
+            fallbackContents[index] ?? normalizedBackstory,
+            72,
+          ),
+          contextSnippet: clampText(
+            `${source.name}的背景正在向“${fallbackContents[index] ?? normalizedBackstory}”这条线索展开。`,
+            48,
+          ),
+        }) satisfies CharacterBackstoryChapter,
+    ),
+  };
+}
+
+function normalizeBackstoryReveal(
+  value: unknown,
+  fallbackSource: CustomWorldRoleFallbackSource,
+) {
+  const fallback = buildFallbackBackstoryReveal(fallbackSource);
+  if (!value || typeof value !== 'object') {
+    return fallback;
+  }
+
+  const item = value as Record<string, unknown>;
+  const rawChapters = toRecordArray(item.chapters);
+
+  return {
+    publicSummary: toText(item.publicSummary) || fallback.publicSummary,
+    privateChatUnlockAffinity:
+      typeof item.privateChatUnlockAffinity === 'number' &&
+      Number.isFinite(item.privateChatUnlockAffinity)
+        ? clampCustomWorldAffinity(item.privateChatUnlockAffinity)
+        : fallback.privateChatUnlockAffinity,
+    chapters: AFFINITY_BACKSTORY_CHAPTER_THRESHOLDS.map(
+      (defaultAffinity, index) => {
+        const fallbackChapter = fallback.chapters[index];
+        const rawChapter = rawChapters[index];
+        return {
+          id:
+            (rawChapter && toText(rawChapter.id)) ||
+            fallbackChapter?.id ||
+            `backstory-chapter-${index + 1}`,
+          title:
+            (rawChapter && toText(rawChapter.title)) ||
+            fallbackChapter?.title ||
+            `背景片段${index + 1}`,
+          affinityRequired:
+            fallbackChapter?.affinityRequired ?? defaultAffinity,
+          teaser:
+            (rawChapter && toText(rawChapter.teaser)) ||
+            fallbackChapter?.teaser ||
+            '',
+          content:
+            (rawChapter && toText(rawChapter.content)) ||
+            fallbackChapter?.content ||
+            '',
+          contextSnippet:
+            (rawChapter && toText(rawChapter.contextSnippet)) ||
+            fallbackChapter?.contextSnippet ||
+            '',
+        } satisfies CharacterBackstoryChapter;
+      },
+    ),
+  } satisfies CharacterBackstoryRevealConfig;
+}
+
+function buildFallbackRoleSkills(source: CustomWorldRoleFallbackSource) {
+  const skillNameSeed = source.title || source.role || source.name || '角色';
+  const skillSummarySeed =
+    source.combatStyle || source.description || `${source.name}善于把握局势。`;
+  const motivationSeed =
+    source.motivation || source.personality || source.backstory;
+
+  return [
+    {
+      id: createEntryId('role-skill', `${skillNameSeed}-起手`, 0),
+      name: `${skillNameSeed}起手`,
+      summary: clampText(skillSummarySeed, 36),
+      style: '起手压制',
+    },
+    {
+      id: createEntryId('role-skill', `${skillNameSeed}-机动`, 1),
+      name: `${skillNameSeed}变招`,
+      summary: clampText(
+        source.personality || `${source.name}习惯在试探中寻找破绽。`,
+        36,
+      ),
+      style: '机动周旋',
+    },
+    {
+      id: createEntryId('role-skill', `${skillNameSeed}-底牌`, 2),
+      name: `${skillNameSeed}底牌`,
+      summary: clampText(
+        motivationSeed || `${source.name}会在关键时刻亮出压箱手段。`,
+        36,
+      ),
+      style: '爆发终结',
+    },
+  ] satisfies CustomWorldRoleSkill[];
+}
+
+function normalizeRoleSkillList(
+  value: unknown,
+  fallbackSource: CustomWorldRoleFallbackSource,
+) {
+  const normalized = toRecordArray(value)
+    .map((item, index) => {
+      const name = toText(item.name);
+      const summary = toText(item.summary) || toText(item.description);
+      const style = toText(item.style) || toText(item.category) || '常用';
+
+      return {
+        id: createEntryId('role-skill', name || style, index),
+        name,
+        summary,
+        style,
+      } satisfies CustomWorldRoleSkill;
+    })
+    .filter((entry) => entry.name)
+    .slice(0, DEFAULT_CUSTOM_WORLD_ROLE_SKILL_COUNT);
+
+  return normalized.length > 0
+    ? normalized
+    : buildFallbackRoleSkills(fallbackSource);
+}
+
+function buildFallbackRoleInitialItems(source: CustomWorldRoleFallbackSource) {
+  const itemNameSeed = source.title || source.role || source.name || '角色';
+  return [
+    {
+      id: createEntryId('role-item', `${itemNameSeed}-1`, 0),
+      name: `${itemNameSeed}常备武具`,
+      category: '武器',
+      quantity: 1,
+      rarity: 'rare',
+      description: clampText(
+        source.combatStyle || `${source.name}随身携带的主要作战物件。`,
+        36,
+      ),
+      tags: normalizeTags(source.tags, ['战斗', '随身']),
+    },
+    {
+      id: createEntryId('role-item', `${itemNameSeed}-2`, 1),
+      name: `${itemNameSeed}补给包`,
+      category: '消耗品',
+      quantity: 2,
+      rarity: 'uncommon',
+      description: clampText(
+        source.personality || `${source.name}为了长期行动准备的基础补给。`,
+        36,
+      ),
+      tags: normalizeTags(source.relationshipHooks, ['补给', '行动']),
+    },
+    {
+      id: createEntryId('role-item', `${itemNameSeed}-3`, 2),
+      name: `${itemNameSeed}私人物件`,
+      category: '专属物品',
+      quantity: 1,
+      rarity: 'rare',
+      description: clampText(
+        source.backstory ||
+          source.motivation ||
+          `${source.name}不愿随意交出的信物。`,
+        36,
+      ),
+      tags: normalizeTags(
+        [...source.tags, ...source.relationshipHooks],
+        ['信物', '线索'],
+      ),
+    },
+  ] satisfies CustomWorldRoleInitialItem[];
+}
+
+function normalizeRoleInitialItemList(
+  value: unknown,
+  fallbackSource: CustomWorldRoleFallbackSource,
+) {
+  const normalized = toRecordArray(value)
+    .map((item, index) => {
+      const name = toText(item.name);
+      return {
+        id: createEntryId('role-item', name, index),
+        name,
+        category: normalizeRoleItemCategory(item.category),
+        quantity:
+          typeof item.quantity === 'number' && Number.isFinite(item.quantity)
+            ? Math.max(1, Math.min(99, Math.round(item.quantity)))
+            : 1,
+        rarity: normalizeRarity(item.rarity, 'rare'),
+        description: toText(item.description),
+        tags: normalizeTags(item.tags),
+      } satisfies CustomWorldRoleInitialItem;
+    })
+    .filter((entry) => entry.name)
+    .slice(0, DEFAULT_CUSTOM_WORLD_ROLE_INITIAL_ITEM_COUNT);
+
+  return normalized.length > 0
+    ? normalized
+    : buildFallbackRoleInitialItems(fallbackSource);
+}
+
+function normalizeRoleOutlineList(
+  value: unknown,
+  options: {
+    titleFallback: string;
+    defaultAffinity: number;
+    maxCount?: number;
+  },
+) {
+  const normalized = toRecordArray(value)
+    .map((item) => {
+      const name = toText(item.name);
+      const title =
+        toText(item.title) || toText(item.role) || options.titleFallback;
+      const role = toText(item.role) || title;
+      const relationshipHooks = normalizeTags(
+        item.relationshipHooks,
+        normalizeTags(item.tags),
+      );
+
+      return {
+        name,
+        title,
+        role,
+        description:
+          toText(item.description) ||
+          clampText(`${name || title}在世界中以${role}身份活动。`, 36),
+        visualDescription: toText(item.visualDescription) || undefined,
+        actionDescription: toText(item.actionDescription) || undefined,
+        sceneVisualDescription: toText(item.sceneVisualDescription) || undefined,
+        initialAffinity: normalizeInitialAffinity(
+          item.initialAffinity,
+          options.defaultAffinity,
+        ),
+        relationshipHooks,
+        tags: normalizeTags(item.tags, relationshipHooks),
+      } satisfies CustomWorldGenerationRoleOutline;
+    })
+    .filter((entry) => entry.name);
+
+  return typeof options.maxCount === 'number'
+    ? normalized.slice(0, options.maxCount)
+    : normalized;
+}
+
+export function normalizeCustomWorldGenerationRoleOutlineBatch(
+  raw: unknown,
+  roleType: CustomWorldGenerationRoleBatchType,
+) {
+  const item =
+    raw && typeof raw === 'object' ? (raw as Record<string, unknown>) : {};
+  const key = roleType === 'playable' ? 'playableNpcs' : 'storyNpcs';
+
+  return normalizeRoleOutlineList(item[key], {
+    titleFallback: '未定称号',
+    defaultAffinity:
+      roleType === 'playable'
+        ? DEFAULT_PLAYABLE_INITIAL_AFFINITY
+        : DEFAULT_STORY_NPC_INITIAL_AFFINITY,
+  });
+}
+
+export function normalizeCustomWorldGenerationFrameworkRoles(params: {
+  raw: Record<string, unknown>;
+  fallback: CustomWorldProfile;
+  settingText: string;
+}) {
+  const worldSignalText = [
+    params.settingText,
+    toText(params.raw.subtitle),
+    toText(params.raw.summary),
+    toText(params.raw.tone),
+    toText(params.raw.playerGoal),
+  ].join(' ');
+  const templateWorldType = normalizeWorldType(
+    params.raw.templateWorldType,
+    worldSignalText,
+  );
+  const name =
+    toText(params.raw.name) || buildWorldName(params.settingText, templateWorldType);
+
+  return {
+    name,
+    templateWorldType,
+    playableNpcs: normalizeRoleOutlineList(params.raw.playableNpcs, {
+      titleFallback: '未定称号',
+      defaultAffinity: DEFAULT_PLAYABLE_INITIAL_AFFINITY,
+      maxCount: MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT,
+    }),
+    storyNpcs: normalizeRoleOutlineList(params.raw.storyNpcs, {
+      titleFallback: '未定称号',
+      defaultAffinity: DEFAULT_STORY_NPC_INITIAL_AFFINITY,
+      maxCount: MIN_CUSTOM_WORLD_STORY_NPC_COUNT,
+    }),
+    campFallbackProfile: {
+      name,
+      summary: toText(params.raw.summary) || params.fallback.summary,
+      tone: toText(params.raw.tone) || params.fallback.tone,
+      playerGoal: toText(params.raw.playerGoal) || params.fallback.playerGoal,
+      settingText: params.settingText.trim(),
+    },
+  };
+}
+
+export function buildCustomWorldRawProfileRolesFromFramework(
+  framework: CustomWorldGenerationFramework,
+) {
+  return {
+    playableNpcs: framework.playableNpcs.map((npc) => ({
+      name: npc.name,
+      title: npc.title,
+      role: npc.role,
+      description: npc.description,
+      visualDescription: npc.visualDescription,
+      actionDescription: npc.actionDescription,
+      sceneVisualDescription: npc.sceneVisualDescription,
+      initialAffinity: npc.initialAffinity,
+      relationshipHooks: [...npc.relationshipHooks],
+      tags: [...npc.tags],
+    })),
+    storyNpcs: framework.storyNpcs.map((npc) => ({
+      name: npc.name,
+      title: npc.title,
+      role: npc.role,
+      description: npc.description,
+      visualDescription: npc.visualDescription,
+      actionDescription: npc.actionDescription,
+      sceneVisualDescription: npc.sceneVisualDescription,
+      initialAffinity: npc.initialAffinity,
+      relationshipHooks: [...npc.relationshipHooks],
+      tags: [...npc.tags],
+    })),
+  };
+}
+
+function normalizeRoleProfile(
+  item: Record<string, unknown>,
+  index: number,
+  options: {
+    idPrefix: 'playable-npc' | 'story-npc';
+    titleFallback: string;
+    defaultAffinity: number;
+  },
+) {
+  const name = toText(item.name);
+  const title =
+    toText(item.title) || toText(item.role) || options.titleFallback;
+  const role = toText(item.role) || title;
+  const relationshipHooks = normalizeTags(
+    item.relationshipHooks,
+    normalizeTags(item.tags),
+  );
+  const normalizedRole = {
+    id: toText(item.id) || createEntryId(options.idPrefix, name, index),
+    name,
+    title,
+    role,
+    description: toText(item.description),
+    visualDescription: toText(item.visualDescription) || undefined,
+    actionDescription: toText(item.actionDescription) || undefined,
+    sceneVisualDescription: toText(item.sceneVisualDescription) || undefined,
+    backstory: toText(item.backstory),
+    personality: toText(item.personality),
+    motivation: toText(item.motivation) || toText(item.description),
+    combatStyle: toText(item.combatStyle),
+    initialAffinity: normalizeInitialAffinity(
+      item.initialAffinity,
+      options.defaultAffinity,
+    ),
+    relationshipHooks,
+    tags: normalizeTags(item.tags, relationshipHooks),
+  };
+
+  return {
+    ...normalizedRole,
+    backstoryReveal: normalizeBackstoryReveal(
+      item.backstoryReveal,
+      normalizedRole,
+    ),
+    skills: normalizeRoleSkillList(item.skills, normalizedRole),
+    initialItems: normalizeRoleInitialItemList(item.initialItems, normalizedRole),
+    imageSrc: toText(item.imageSrc) || undefined,
+    generatedVisualAssetId: toText(item.generatedVisualAssetId) || undefined,
+    generatedAnimationSetId:
+      toText(item.generatedAnimationSetId) || undefined,
+    animationMap:
+      item.animationMap && typeof item.animationMap === 'object'
+        ? (item.animationMap as Record<string, unknown>)
+        : undefined,
+    narrativeProfile:
+      item.narrativeProfile && typeof item.narrativeProfile === 'object'
+        ? (item.narrativeProfile as CustomWorldRoleProfile['narrativeProfile'])
+        : null,
+  };
+}
+
+export function normalizePlayableNpcList(value: unknown) {
+  return toRecordArray(value)
+    .map((item, index) => ({
+      ...normalizeRoleProfile(item, index, {
+        idPrefix: 'playable-npc',
+        titleFallback: '未定称号',
+        defaultAffinity: DEFAULT_PLAYABLE_INITIAL_AFFINITY,
+      }),
+      templateCharacterId: toText(item.templateCharacterId) || undefined,
+    }))
+    .filter((entry) => entry.name)
+    .slice(0, MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT);
+}
+
+export function normalizeStoryNpcList(value: unknown) {
+  return toRecordArray(value)
+    .map(
+      (item, index) =>
+        ({
+          ...normalizeRoleProfile(item, index, {
+            idPrefix: 'story-npc',
+            titleFallback: '未定称号',
+            defaultAffinity: DEFAULT_STORY_NPC_INITIAL_AFFINITY,
+          }),
+          visual:
+            item.visual && typeof item.visual === 'object'
+              ? (item.visual as Record<string, unknown>)
+              : undefined,
+        }) satisfies CustomWorldNpc,
+    )
+    .filter((entry) => entry.name);
+}
diff --git a/server-node/src/modules/custom-world/runtime-profile/normalizeSceneChapter.ts b/server-node/src/modules/custom-world/runtime-profile/normalizeSceneChapter.ts
new file mode 100644
index 00000000..08d1bad3
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/normalizeSceneChapter.ts
@@ -0,0 +1,123 @@
+import type { SceneActBlueprint, SceneChapterBlueprint } from '../runtimeTypes.js';
+import { createEntryId, toRecordArray, toStringArray, toText } from './normalizeShared.js';
+
+/**
+ * 工作包 G：
+ * 分幕与场景章节 blueprint 归一独立收口，让结果预览编译层只消费稳定的章节结构。
+ */
+
+const SCENE_ACT_STAGES = new Set([
+  'opening',
+  'expansion',
+  'turning_point',
+  'climax',
+  'aftermath',
+]);
+const SCENE_ACT_ADVANCE_RULES = new Set([
+  'after_primary_contact',
+  'after_active_step_complete',
+  'after_chapter_resolution',
+]);
+
+function normalizeSceneActStageCoverage(value: unknown) {
+  const stageCoverage = Array.isArray(value)
+    ? value
+        .filter((entry): entry is string => typeof entry === 'string')
+        .map((entry) => entry.trim())
+        .filter((entry): entry is SceneActBlueprint['stageCoverage'][number] =>
+          SCENE_ACT_STAGES.has(entry as never),
+        )
+    : [];
+
+  return [...new Set(stageCoverage)];
+}
+
+function normalizeSceneActBlueprint(
+  value: unknown,
+  index: number,
+  sceneId: string,
+): SceneActBlueprint | null {
+  const item =
+    value && typeof value === 'object'
+      ? (value as Record<string, unknown>)
+      : null;
+  if (!item) {
+    return null;
+  }
+
+  const encounterNpcIds = toStringArray(item.encounterNpcIds);
+  const stageCoverage = normalizeSceneActStageCoverage(item.stageCoverage);
+  const advanceRule = toText(item.advanceRule);
+  const title = toText(item.title);
+  const summary = toText(item.summary);
+
+  if (!title && !summary && encounterNpcIds.length === 0) {
+    return null;
+  }
+
+  return {
+    id:
+      toText(item.id) ||
+      createEntryId(`saved-scene-act-${sceneId}`, title || sceneId, index),
+    sceneId,
+    title: title || `第 ${index + 1} 幕`,
+    summary: summary || title || `围绕${sceneId}继续推进`,
+    stageCoverage:
+      stageCoverage.length > 0
+        ? stageCoverage
+        : index === 0
+          ? ['opening']
+          : ['climax', 'aftermath'],
+    backgroundImageSrc: toText(item.backgroundImageSrc) || undefined,
+    backgroundAssetId: toText(item.backgroundAssetId) || undefined,
+    encounterNpcIds,
+    primaryNpcId: toText(item.primaryNpcId) || encounterNpcIds[0] || '',
+    linkedThreadIds: toStringArray(item.linkedThreadIds),
+    advanceRule: SCENE_ACT_ADVANCE_RULES.has(advanceRule as never)
+      ? (advanceRule as SceneActBlueprint['advanceRule'])
+      : 'after_active_step_complete',
+    actGoal: toText(item.actGoal),
+    transitionHook: toText(item.transitionHook),
+  };
+}
+
+export function normalizeSceneChapterBlueprints(value: unknown) {
+  if (!Array.isArray(value)) {
+    return null;
+  }
+
+  const normalized = value
+    .filter(
+      (entry): entry is Record<string, unknown> =>
+        Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry),
+    )
+    .map((entry, index) => {
+      const sceneId = toText(entry.sceneId);
+      if (!sceneId) {
+        return null;
+      }
+
+      const acts = Array.isArray(entry.acts)
+        ? entry.acts
+            .map((act, actIndex) =>
+              normalizeSceneActBlueprint(act, actIndex, sceneId),
+            )
+            .filter((act): act is SceneActBlueprint => Boolean(act))
+        : [];
+
+      return {
+        id:
+          toText(entry.id) ||
+          createEntryId('saved-scene-chapter', sceneId, index),
+        sceneId,
+        title: toText(entry.title) || toText(entry.sceneName) || sceneId,
+        summary: toText(entry.summary),
+        linkedThreadIds: toStringArray(entry.linkedThreadIds),
+        linkedLandmarkIds: toStringArray(entry.linkedLandmarkIds),
+        acts,
+      } satisfies SceneChapterBlueprint;
+    })
+    .filter((entry): entry is SceneChapterBlueprint => Boolean(entry));
+
+  return normalized.length > 0 ? normalized : null;
+}
diff --git a/server-node/src/modules/custom-world/runtime-profile/normalizeShared.ts b/server-node/src/modules/custom-world/runtime-profile/normalizeShared.ts
new file mode 100644
index 00000000..9a18ef63
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/normalizeShared.ts
@@ -0,0 +1,248 @@
+import type {
+  CustomWorldCoverProfile,
+  CustomWorldCoverSourceType,
+  CustomWorldItem,
+  CustomWorldPlayableNpc,
+} from '../runtimeTypes.js';
+
+/**
+ * 工作包 G：
+ * 把 runtime profile 编译流程里的通用常量、基础文本归一和通用小型归一逻辑收口到共享模块，
+ * 让角色、地点、场景章节和主编译入口都不再重复维护这些基础能力。
+ */
+
+const MIN_CUSTOM_WORLD_AFFINITY = -40;
+const MAX_CUSTOM_WORLD_AFFINITY = 90;
+const CUSTOM_WORLD_RARITIES = [
+  'common',
+  'uncommon',
+  'rare',
+  'epic',
+  'legendary',
+] as const;
+const CUSTOM_WORLD_ROLE_ITEM_CATEGORIES = [
+  '武器',
+  '护甲',
+  '饰品',
+  '消耗品',
+  '材料',
+  '稀有品',
+  '专属物品',
+  '专属物',
+] as const;
+
+export const MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT = 5;
+export const MIN_CUSTOM_WORLD_TOTAL_NPC_COUNT = 30;
+export const MIN_CUSTOM_WORLD_LANDMARK_COUNT = 10;
+export const MIN_CUSTOM_WORLD_STORY_NPC_COUNT = Math.max(
+  0,
+  MIN_CUSTOM_WORLD_TOTAL_NPC_COUNT - MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT,
+);
+
+export const PLAYABLE_TEMPLATE_CHARACTER_IDS = [
+  'sword-princess',
+  'archer-hero',
+  'girl-hero',
+  'punch-hero',
+  'fighter-4',
+] as const;
+
+export function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+export function toFiniteInteger(value: unknown) {
+  return typeof value === 'number' && Number.isFinite(value)
+    ? Math.round(value)
+    : undefined;
+}
+
+export function toRecord(value: unknown) {
+  return value && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : null;
+}
+
+export function toRecordArray(value: unknown) {
+  return Array.isArray(value)
+    ? (value.filter((item) => item && typeof item === 'object') as Array<
+        Record<string, unknown>
+      >)
+    : [];
+}
+
+export function toStringArray(value: unknown, nestedKey?: string) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  return value
+    .map((item) => {
+      if (typeof item === 'string') {
+        return item.trim();
+      }
+      if (nestedKey && item && typeof item === 'object') {
+        return toText((item as Record<string, unknown>)[nestedKey]);
+      }
+      return '';
+    })
+    .filter(Boolean);
+}
+
+export function normalizeTags(value: unknown, fallbackTags: string[] = []) {
+  const tags = Array.isArray(value)
+    ? value.map((item) => toText(item)).filter(Boolean)
+    : [];
+  return [
+    ...new Set((tags.length > 0 ? tags : fallbackTags).filter(Boolean)),
+  ].slice(0, 5);
+}
+
+export function clampText(value: string, maxLength: number) {
+  const normalized = value.trim().replace(/\s+/g, ' ');
+  if (!normalized) {
+    return '';
+  }
+  if (normalized.length <= maxLength) {
+    return normalized;
+  }
+  return `${normalized.slice(0, Math.max(0, maxLength - 1)).trim()}…`;
+}
+
+export function slugify(value: string) {
+  const ascii = value
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+
+  return ascii ? ascii.slice(0, 24) : 'entry';
+}
+
+export function createEntryId(prefix: string, label: string, index: number) {
+  return `${prefix}-${slugify(label || `${prefix}-${index + 1}`)}-${index + 1}`;
+}
+
+export function clampCustomWorldAffinity(value: number) {
+  return Math.max(
+    MIN_CUSTOM_WORLD_AFFINITY,
+    Math.min(MAX_CUSTOM_WORLD_AFFINITY, Math.round(value)),
+  );
+}
+
+export function normalizeInitialAffinity(value: unknown, fallback: number) {
+  return typeof value === 'number' && Number.isFinite(value)
+    ? clampCustomWorldAffinity(value)
+    : fallback;
+}
+
+export function normalizeRarity(
+  value: unknown,
+  fallback: (typeof CUSTOM_WORLD_RARITIES)[number] = 'rare',
+) {
+  const rarity = toText(value).toLowerCase();
+  return CUSTOM_WORLD_RARITIES.includes(
+    rarity as (typeof CUSTOM_WORLD_RARITIES)[number],
+  )
+    ? (rarity as (typeof CUSTOM_WORLD_RARITIES)[number])
+    : fallback;
+}
+
+export function normalizeRoleItemCategory(value: unknown, fallback = '材料') {
+  const category = toText(value);
+  if (
+    (CUSTOM_WORLD_ROLE_ITEM_CATEGORIES as readonly string[]).includes(category)
+  ) {
+    return category === '专属物' ? '专属物品' : category;
+  }
+  if (/武器|刀|剑|弓|枪|炮|锤/u.test(category)) return '武器';
+  if (/甲|护|盾|衣|袍/u.test(category)) return '护甲';
+  if (/饰|符|佩|坠|珠|印/u.test(category)) return '饰品';
+  if (/药|食|补给|瓶|卷轴/u.test(category)) return '消耗品';
+  if (/材|矿|木|石|鳞|骨/u.test(category)) return '材料';
+  if (/秘|钥|图|册|录|卷/u.test(category)) return '稀有品';
+  if (/信物|遗物|核心|母印|真符/u.test(category)) return '专属物品';
+  return fallback;
+}
+
+export function normalizeCustomWorldCoverCharacterRoleIds(
+  value: unknown,
+  playableNpcs: Array<Pick<CustomWorldPlayableNpc, 'id'>>,
+) {
+  const availableIds = new Set(
+    playableNpcs.map((entry) => entry.id.trim()).filter(Boolean),
+  );
+  const selectedIds = Array.isArray(value)
+    ? [
+        ...new Set(
+          value
+            .map((entry) => toText(entry))
+            .filter((entry) => entry && availableIds.has(entry)),
+        ),
+      ].slice(0, 3)
+    : [];
+
+  if (selectedIds.length > 0) {
+    return selectedIds;
+  }
+
+  return playableNpcs
+    .map((entry) => entry.id.trim())
+    .filter(Boolean)
+    .slice(0, 3);
+}
+
+export function buildDefaultCustomWorldCover(
+  playableNpcs: Array<Pick<CustomWorldPlayableNpc, 'id'>>,
+): CustomWorldCoverProfile {
+  return {
+    sourceType: 'default' as const,
+    imageSrc: null,
+    characterRoleIds: normalizeCustomWorldCoverCharacterRoleIds(
+      undefined,
+      playableNpcs,
+    ),
+  };
+}
+
+export function normalizeCustomWorldCover(
+  value: unknown,
+  playableNpcs: Array<Pick<CustomWorldPlayableNpc, 'id'>>,
+): CustomWorldCoverProfile {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return buildDefaultCustomWorldCover(playableNpcs);
+  }
+
+  const item = value as Record<string, unknown>;
+  const sourceType: CustomWorldCoverSourceType =
+    item.sourceType === 'uploaded' || item.sourceType === 'generated'
+      ? item.sourceType
+      : 'default';
+  const imageSrc = toText(item.imageSrc) || null;
+
+  if (sourceType !== 'default' && imageSrc) {
+    return {
+      sourceType,
+      imageSrc,
+      characterRoleIds: [],
+    };
+  }
+
+  return buildDefaultCustomWorldCover(playableNpcs);
+}
+
+export function normalizeItemList(value: unknown) {
+  return toRecordArray(value)
+    .map((item, index) => {
+      const name = toText(item.name);
+      const category = toText(item.category);
+      return {
+        id: toText(item.id) || createEntryId('item', name, index),
+        name,
+        category,
+        rarity: normalizeRarity(item.rarity, 'rare'),
+        description: toText(item.description),
+        tags: normalizeTags(item.tags),
+      } satisfies CustomWorldItem;
+    })
+    .filter((entry) => entry.name && entry.category);
+}
diff --git a/server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts b/server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts
new file mode 100644
index 00000000..7a78cd49
--- /dev/null
+++ b/server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts
@@ -0,0 +1,13 @@
+/**
+ * 兼容期 façade：
+ * 旧的 runtimeProfileCompiler 文件名暂时保留，避免工作包 G 完整拆分后影响仍未迁移的局部导入。
+ * 新实现已经拆到目录模块中，后续新增逻辑禁止继续回写到这个文件。
+ */
+export * from './buildAttributeSchema.js';
+export * from './buildCompiledProfile.js';
+export * from './creatorIntentBridge.js';
+export * from './normalizeCamp.js';
+export * from './normalizeLandmark.js';
+export * from './normalizeRole.js';
+export * from './normalizeSceneChapter.js';
+export * from './normalizeShared.js';
diff --git a/server-node/src/modules/custom-world/runtimeProfile.ts b/server-node/src/modules/custom-world/runtimeProfile.ts
index 039b1f2a..f5debeb6 100644
--- a/server-node/src/modules/custom-world/runtimeProfile.ts
+++ b/server-node/src/modules/custom-world/runtimeProfile.ts
@@ -1,1884 +1,6 @@
-import {
-  buildCustomWorldAnchorPackFromIntent,
-  deriveCustomWorldLockStateFromIntent,
-  normalizeCustomWorldCreatorIntent,
-  normalizeCustomWorldLockState,
-} from './creatorIntentRuntime.js';
-import type {
-  AttributeVector,
-  CharacterBackstoryChapter,
-  CharacterBackstoryRevealConfig,
-  CustomWorldCampScene,
-  CustomWorldCoverProfile,
-  CustomWorldCoverSourceType,
-  CustomWorldGenerationFramework,
-  CustomWorldGenerationLandmarkOutline,
-  CustomWorldGenerationRoleBatchType,
-  CustomWorldGenerationRoleOutline,
-  CustomWorldItem,
-  CustomWorldNpc,
-  CustomWorldPlayableNpc,
-  CustomWorldProfile,
-  CustomWorldRoleInitialItem,
-  CustomWorldRoleProfile,
-  CustomWorldRoleSkill,
-  RoleAttributeProfile,
-  SceneActBlueprint,
-  SceneChapterBlueprint,
-  WorldAttributeSchema,
-  WorldAttributeSlot,
-  WorldType,
-} from './runtimeTypes.js';
-
-export type {
-  CustomWorldGenerationFramework,
-  CustomWorldGenerationLandmarkOutline,
-  CustomWorldGenerationRoleBatchStage,
-  CustomWorldGenerationRoleBatchType,
-  CustomWorldGenerationRoleOutline,
-} from './runtimeTypes.js';
-
-const AFFINITY_BACKSTORY_CHAPTER_THRESHOLDS = [15, 30, 60, 90] as const;
-const DEFAULT_PRIVATE_CHAT_UNLOCK_AFFINITY = 60;
-
-const MIN_CUSTOM_WORLD_AFFINITY = -40;
-const MAX_CUSTOM_WORLD_AFFINITY = 90;
-const DEFAULT_PLAYABLE_INITIAL_AFFINITY = 18;
-const DEFAULT_STORY_NPC_INITIAL_AFFINITY = 6;
-const DEFAULT_CUSTOM_WORLD_ROLE_SKILL_COUNT = 3;
-const DEFAULT_CUSTOM_WORLD_ROLE_INITIAL_ITEM_COUNT = 3;
-const CUSTOM_WORLD_BACKSTORY_CHAPTER_TITLES = [
-  '表层来意',
-  '旧事裂痕',
-  '隐藏执念',
-  '最终底牌',
-] as const;
-const CUSTOM_WORLD_ROLE_ITEM_CATEGORIES = [
-  '武器',
-  '护甲',
-  '饰品',
-  '消耗品',
-  '材料',
-  '稀有品',
-  '专属物品',
-  '专属物',
-] as const;
-const CUSTOM_WORLD_RARITIES = [
-  'common',
-  'uncommon',
-  'rare',
-  'epic',
-  'legendary',
-] as const;
-const PLAYABLE_TEMPLATE_CHARACTER_IDS = [
-  'sword-princess',
-  'archer-hero',
-  'girl-hero',
-  'punch-hero',
-  'fighter-4',
-] as const;
-const WORLD_ATTRIBUTE_SLOT_IDS = [
-  'axis_a',
-  'axis_b',
-  'axis_c',
-  'axis_d',
-  'axis_e',
-  'axis_f',
-] as const;
-const SCENE_ACT_STAGES = new Set([
-  'opening',
-  'expansion',
-  'turning_point',
-  'climax',
-  'aftermath',
-]);
-const SCENE_ACT_ADVANCE_RULES = new Set([
-  'after_primary_contact',
-  'after_active_step_complete',
-  'after_chapter_resolution',
-]);
-
-export const MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT = 5;
-export const MIN_CUSTOM_WORLD_TOTAL_NPC_COUNT = 30;
-export const MIN_CUSTOM_WORLD_LANDMARK_COUNT = 10;
-export const MIN_CUSTOM_WORLD_STORY_NPC_COUNT = Math.max(
-  0,
-  MIN_CUSTOM_WORLD_TOTAL_NPC_COUNT - MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT,
-);
-
-function toText(value: unknown) {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-function toFiniteInteger(value: unknown) {
-  return typeof value === 'number' && Number.isFinite(value)
-    ? Math.round(value)
-    : undefined;
-}
-
-function toRecordArray(value: unknown) {
-  return Array.isArray(value)
-    ? (value.filter((item) => item && typeof item === 'object') as Array<
-        Record<string, unknown>
-      >)
-    : [];
-}
-
-function toStringArray(value: unknown, nestedKey?: string) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-
-  return value
-    .map((item) => {
-      if (typeof item === 'string') {
-        return item.trim();
-      }
-      if (nestedKey && item && typeof item === 'object') {
-        return toText((item as Record<string, unknown>)[nestedKey]);
-      }
-      return '';
-    })
-    .filter(Boolean);
-}
-
-function normalizeTags(value: unknown, fallbackTags: string[] = []) {
-  const tags = Array.isArray(value)
-    ? value.map((item) => toText(item)).filter(Boolean)
-    : [];
-  return [
-    ...new Set((tags.length > 0 ? tags : fallbackTags).filter(Boolean)),
-  ].slice(0, 5);
-}
-
-function clampText(value: string, maxLength: number) {
-  const normalized = value.trim().replace(/\s+/g, ' ');
-  if (!normalized) {
-    return '';
-  }
-  if (normalized.length <= maxLength) {
-    return normalized;
-  }
-  return `${normalized.slice(0, Math.max(0, maxLength - 1)).trim()}…`;
-}
-
-function slugify(value: string) {
-  const ascii = value
-    .toLowerCase()
-    .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '-')
-    .replace(/^-+|-+$/g, '');
-
-  return ascii ? ascii.slice(0, 24) : 'entry';
-}
-
-function createEntryId(prefix: string, label: string, index: number) {
-  return `${prefix}-${slugify(label || `${prefix}-${index + 1}`)}-${index + 1}`;
-}
-
-function clampCustomWorldAffinity(value: number) {
-  return Math.max(
-    MIN_CUSTOM_WORLD_AFFINITY,
-    Math.min(MAX_CUSTOM_WORLD_AFFINITY, Math.round(value)),
-  );
-}
-
-function normalizeInitialAffinity(value: unknown, fallback: number) {
-  return typeof value === 'number' && Number.isFinite(value)
-    ? clampCustomWorldAffinity(value)
-    : fallback;
-}
-
-function normalizeRarity(
-  value: unknown,
-  fallback: (typeof CUSTOM_WORLD_RARITIES)[number] = 'rare',
-) {
-  const rarity = toText(value).toLowerCase();
-  return CUSTOM_WORLD_RARITIES.includes(
-    rarity as (typeof CUSTOM_WORLD_RARITIES)[number],
-  )
-    ? (rarity as (typeof CUSTOM_WORLD_RARITIES)[number])
-    : fallback;
-}
-
-function normalizeRoleItemCategory(value: unknown, fallback = '材料') {
-  const category = toText(value);
-  if (
-    (CUSTOM_WORLD_ROLE_ITEM_CATEGORIES as readonly string[]).includes(category)
-  ) {
-    return category === '专属物' ? '专属物品' : category;
-  }
-  if (/武器|刀|剑|弓|枪|炮|锤/u.test(category)) return '武器';
-  if (/甲|护|盾|衣|袍/u.test(category)) return '护甲';
-  if (/饰|符|佩|坠|珠|印/u.test(category)) return '饰品';
-  if (/药|食|补给|瓶|卷轴/u.test(category)) return '消耗品';
-  if (/材|矿|木|石|鳞|骨/u.test(category)) return '材料';
-  if (/秘|钥|图|册|录|卷/u.test(category)) return '稀有品';
-  if (/信物|遗物|核心|母印|真符/u.test(category)) return '专属物品';
-  return fallback;
-}
-
-function splitNarrativeSentences(text: string) {
-  const normalized = text.replace(/\s+/g, ' ').trim();
-  if (!normalized) {
-    return [];
-  }
-  const matches = normalized.match(/[^。！？!?]+[。！？!?]?/gu);
-  return (matches ?? [normalized]).map((item) => item.trim()).filter(Boolean);
-}
-
-type CustomWorldRoleFallbackSource = Pick<
-  CustomWorldRoleProfile,
-  | 'name'
-  | 'title'
-  | 'role'
-  | 'description'
-  | 'backstory'
-  | 'personality'
-  | 'motivation'
-  | 'combatStyle'
-  | 'relationshipHooks'
-  | 'tags'
->;
-
-function buildFallbackBackstoryReveal(
-  source: CustomWorldRoleFallbackSource,
-): CharacterBackstoryRevealConfig {
-  const normalizedBackstory =
-    source.backstory.trim() || `${source.name}对自己的过去始终有所保留。`;
-  const backstorySentences = splitNarrativeSentences(normalizedBackstory);
-  const backstoryLead = backstorySentences[0] ?? normalizedBackstory;
-  const backstoryDetail =
-    backstorySentences.slice(0, 2).join('') || normalizedBackstory;
-  const publicSummary =
-    source.description.trim() || clampText(normalizedBackstory, 42);
-  const fallbackContents = [
-    source.description.trim() || backstoryLead,
-    backstoryDetail,
-    source.motivation.trim()
-      ? `${source.name}真正挂念的，是：${source.motivation.trim()}`
-      : `${source.name}的选择与“${clampText(backstoryLead, 24)}”直接相关。`,
-    source.personality.trim()
-      ? `${source.name}不会轻易说出的底色，是：${source.personality.trim()}`
-      : `${source.name}仍把最深的筹码藏在过去之中。`,
-  ];
-
-  return {
-    publicSummary,
-    privateChatUnlockAffinity: DEFAULT_PRIVATE_CHAT_UNLOCK_AFFINITY,
-    chapters: AFFINITY_BACKSTORY_CHAPTER_THRESHOLDS.map(
-      (affinityRequired, index) =>
-        ({
-          id: createEntryId(
-            'backstory-chapter',
-            `${source.name}-${CUSTOM_WORLD_BACKSTORY_CHAPTER_TITLES[index] ?? index + 1}`,
-            index,
-          ),
-          title:
-            CUSTOM_WORLD_BACKSTORY_CHAPTER_TITLES[index] ??
-            `背景片段${index + 1}`,
-          affinityRequired,
-          teaser: clampText(
-            fallbackContents[index] ?? normalizedBackstory,
-            22,
-          ),
-          content: clampText(
-            fallbackContents[index] ?? normalizedBackstory,
-            72,
-          ),
-          contextSnippet: clampText(
-            `${source.name}的背景正在向“${fallbackContents[index] ?? normalizedBackstory}”这条线索展开。`,
-            48,
-          ),
-        }) satisfies CharacterBackstoryChapter,
-    ),
-  };
-}
-
-function normalizeBackstoryReveal(
-  value: unknown,
-  fallbackSource: CustomWorldRoleFallbackSource,
-) {
-  const fallback = buildFallbackBackstoryReveal(fallbackSource);
-  if (!value || typeof value !== 'object') {
-    return fallback;
-  }
-
-  const item = value as Record<string, unknown>;
-  const rawChapters = toRecordArray(item.chapters);
-
-  return {
-    publicSummary: toText(item.publicSummary) || fallback.publicSummary,
-    privateChatUnlockAffinity:
-      typeof item.privateChatUnlockAffinity === 'number' &&
-      Number.isFinite(item.privateChatUnlockAffinity)
-        ? clampCustomWorldAffinity(item.privateChatUnlockAffinity)
-        : fallback.privateChatUnlockAffinity,
-    chapters: AFFINITY_BACKSTORY_CHAPTER_THRESHOLDS.map(
-      (defaultAffinity, index) => {
-        const fallbackChapter = fallback.chapters[index];
-        const rawChapter = rawChapters[index];
-        return {
-          id:
-            (rawChapter && toText(rawChapter.id)) ||
-            fallbackChapter?.id ||
-            `backstory-chapter-${index + 1}`,
-          title:
-            (rawChapter && toText(rawChapter.title)) ||
-            fallbackChapter?.title ||
-            `背景片段${index + 1}`,
-          affinityRequired:
-            fallbackChapter?.affinityRequired ?? defaultAffinity,
-          teaser:
-            (rawChapter && toText(rawChapter.teaser)) ||
-            fallbackChapter?.teaser ||
-            '',
-          content:
-            (rawChapter && toText(rawChapter.content)) ||
-            fallbackChapter?.content ||
-            '',
-          contextSnippet:
-            (rawChapter && toText(rawChapter.contextSnippet)) ||
-            fallbackChapter?.contextSnippet ||
-            '',
-        } satisfies CharacterBackstoryChapter;
-      },
-    ),
-  } satisfies CharacterBackstoryRevealConfig;
-}
-
-function buildFallbackRoleSkills(source: CustomWorldRoleFallbackSource) {
-  const skillNameSeed = source.title || source.role || source.name || '角色';
-  const skillSummarySeed =
-    source.combatStyle || source.description || `${source.name}善于把握局势。`;
-  const motivationSeed =
-    source.motivation || source.personality || source.backstory;
-
-  return [
-    {
-      id: createEntryId('role-skill', `${skillNameSeed}-起手`, 0),
-      name: `${skillNameSeed}起手`,
-      summary: clampText(skillSummarySeed, 36),
-      style: '起手压制',
-    },
-    {
-      id: createEntryId('role-skill', `${skillNameSeed}-机动`, 1),
-      name: `${skillNameSeed}变招`,
-      summary: clampText(
-        source.personality || `${source.name}习惯在试探中寻找破绽。`,
-        36,
-      ),
-      style: '机动周旋',
-    },
-    {
-      id: createEntryId('role-skill', `${skillNameSeed}-底牌`, 2),
-      name: `${skillNameSeed}底牌`,
-      summary: clampText(
-        motivationSeed || `${source.name}会在关键时刻亮出压箱手段。`,
-        36,
-      ),
-      style: '爆发终结',
-    },
-  ] satisfies CustomWorldRoleSkill[];
-}
-
-function normalizeRoleSkillList(
-  value: unknown,
-  fallbackSource: CustomWorldRoleFallbackSource,
-) {
-  const normalized = toRecordArray(value)
-    .map((item, index) => {
-      const name = toText(item.name);
-      const summary = toText(item.summary) || toText(item.description);
-      const style = toText(item.style) || toText(item.category) || '常用';
-
-      return {
-        id: createEntryId('role-skill', name || style, index),
-        name,
-        summary,
-        style,
-      } satisfies CustomWorldRoleSkill;
-    })
-    .filter((entry) => entry.name)
-    .slice(0, DEFAULT_CUSTOM_WORLD_ROLE_SKILL_COUNT);
-
-  return normalized.length > 0
-    ? normalized
-    : buildFallbackRoleSkills(fallbackSource);
-}
-
-function buildFallbackRoleInitialItems(source: CustomWorldRoleFallbackSource) {
-  const itemNameSeed = source.title || source.role || source.name || '角色';
-  return [
-    {
-      id: createEntryId('role-item', `${itemNameSeed}-1`, 0),
-      name: `${itemNameSeed}常备武具`,
-      category: '武器',
-      quantity: 1,
-      rarity: 'rare',
-      description: clampText(
-        source.combatStyle || `${source.name}随身携带的主要作战物件。`,
-        36,
-      ),
-      tags: normalizeTags(source.tags, ['战斗', '随身']),
-    },
-    {
-      id: createEntryId('role-item', `${itemNameSeed}-2`, 1),
-      name: `${itemNameSeed}补给包`,
-      category: '消耗品',
-      quantity: 2,
-      rarity: 'uncommon',
-      description: clampText(
-        source.personality || `${source.name}为了长期行动准备的基础补给。`,
-        36,
-      ),
-      tags: normalizeTags(source.relationshipHooks, ['补给', '行动']),
-    },
-    {
-      id: createEntryId('role-item', `${itemNameSeed}-3`, 2),
-      name: `${itemNameSeed}私人物件`,
-      category: '专属物品',
-      quantity: 1,
-      rarity: 'rare',
-      description: clampText(
-        source.backstory ||
-          source.motivation ||
-          `${source.name}不愿随意交出的信物。`,
-        36,
-      ),
-      tags: normalizeTags(
-        [...source.tags, ...source.relationshipHooks],
-        ['信物', '线索'],
-      ),
-    },
-  ] satisfies CustomWorldRoleInitialItem[];
-}
-
-function normalizeRoleInitialItemList(
-  value: unknown,
-  fallbackSource: CustomWorldRoleFallbackSource,
-) {
-  const normalized = toRecordArray(value)
-    .map((item, index) => {
-      const name = toText(item.name);
-      return {
-        id: createEntryId('role-item', name, index),
-        name,
-        category: normalizeRoleItemCategory(item.category),
-        quantity:
-          typeof item.quantity === 'number' && Number.isFinite(item.quantity)
-            ? Math.max(1, Math.min(99, Math.round(item.quantity)))
-            : 1,
-        rarity: normalizeRarity(item.rarity, 'rare'),
-        description: toText(item.description),
-        tags: normalizeTags(item.tags),
-      } satisfies CustomWorldRoleInitialItem;
-    })
-    .filter((entry) => entry.name)
-    .slice(0, DEFAULT_CUSTOM_WORLD_ROLE_INITIAL_ITEM_COUNT);
-
-  return normalized.length > 0
-    ? normalized
-    : buildFallbackRoleInitialItems(fallbackSource);
-}
-
-function inferWorldTypeFromSetting(settingText: string): WorldType {
-  return /[仙灵修真飞升灵脉宗门法器天宫秘境道骨星舰]/u.test(settingText)
-    ? 'XIANXIA'
-    : 'WUXIA';
-}
-
-function normalizeWorldType(value: unknown, sourceText: string): WorldType {
-  const worldType = toText(value).toUpperCase();
-  if (worldType === 'WUXIA' || worldType === 'XIANXIA') {
-    return worldType;
-  }
-  return inferWorldTypeFromSetting(sourceText);
-}
-
-function buildSeedPhrase(settingText: string, fallback: string) {
-  const compact = settingText.replace(/\s+/g, '').trim();
-  return compact ? compact.slice(0, 10) : fallback;
-}
-
-function buildWorldName(settingText: string, worldType: WorldType) {
-  const seed = buildSeedPhrase(settingText, '新旅');
-  const suffix = worldType === 'XIANXIA' ? '境' : '域';
-  return `${seed}${suffix}`;
-}
-
-function detectCustomWorldThemeMode(profile: {
-  settingText: string;
-  summary: string;
-  tone: string;
-  playerGoal: string;
-}) {
-  const source = [
-    profile.settingText,
-    profile.summary,
-    profile.tone,
-    profile.playerGoal,
-  ].join(' ');
-
-  if (/[机关蒸汽齿轮工坊机巧城轨炮舰]/u.test(source)) return 'machina';
-  if (/[海潮港湾船舟湖泊澜雾湾]/u.test(source)) return 'tide';
-  if (/[裂缝裂界边境前线断层界桥灰域]/u.test(source)) return 'rift';
-  if (/[修真仙灵宗门法器道脉秘境云阙]/u.test(source)) return 'arcane';
-  if (/[江湖门派镖局朝廷刀剑侠客旧案]/u.test(source)) return 'martial';
-  return 'mythic';
-}
-
-function sanitizeCampSeed(name: string) {
-  const normalized = name.trim().replace(/\s+/g, '');
-  if (!normalized) {
-    return '';
-  }
-
-  const stripped = normalized.replace(
-    /(世界|江湖|边城|仙洲|仙境|灵境|界|录|域|境)$/u,
-    '',
-  );
-  const seed = stripped || normalized;
-
-  return seed.slice(0, Math.min(seed.length, 4));
-}
-
-function buildFallbackCampName(profile: {
-  name: string;
-  summary: string;
-  tone: string;
-  playerGoal: string;
-  settingText: string;
-}) {
-  const seed = sanitizeCampSeed(profile.name) || '归途';
-  const themeMode = detectCustomWorldThemeMode(profile);
-
-  const suffixByMode = {
-    mythic: '归舍',
-    martial: '归舍',
-    arcane: '栖居',
-    machina: '整备居',
-    tide: '潮居',
-    rift: '界隙居所',
-  } as const;
-
-  return `${seed}${suffixByMode[themeMode]}`;
-}
-
-function buildFallbackCustomWorldCampScene(profile: {
-  name: string;
-  summary: string;
-  tone: string;
-  playerGoal: string;
-  settingText: string;
-}): CustomWorldCampScene {
-  const fallbackName = buildFallbackCampName(profile);
-  const summaryLead = clampText(profile.summary, 24) || '前路尚未明朗';
-  const goalLead = clampText(profile.playerGoal, 24) || '继续整理线索';
-  const themeMode = detectCustomWorldThemeMode(profile);
-
-  const descriptionByMode = {
-    mythic: `${fallbackName}是你在${profile.name}暂时安顿的归处，能整备行装、交换判断，并围绕“${goalLead}”继续启程。`,
-    martial: `${fallbackName}是你在${profile.name}暂时落脚的归处，能整备行装、收拢同伴，并朝“${goalLead}”继续动身。`,
-    arcane: `${fallbackName}是你在${profile.name}暂时栖身的居所，适合调息、整理法器，并围绕“${summaryLead}”交换判断。`,
-    machina: `${fallbackName}是你在${profile.name}的临时居所，能检修装备、补齐物资，并为下一段行动重新校准节奏。`,
-    tide: `${fallbackName}是你在${profile.name}靠潮歇息的住处，能安顿队伍、整理补给，并顺着“${goalLead}”继续前探。`,
-    rift: `${fallbackName}是你在${profile.name}勉强守住的一处居所，既能短暂停步，也能围绕“${summaryLead}”商量下一步去向。`,
-  } as const;
-
-  return {
-    id: 'custom-scene-camp',
-    name: fallbackName,
-    description: descriptionByMode[themeMode],
-    dangerLevel: 'low',
-    sceneNpcIds: [],
-    connections: [],
-    narrativeResidues: null,
-  };
-}
-
-function buildTemplateWorldAttributeSchema(worldType: Exclude<WorldType, 'CUSTOM'>) {
-  const common = {
-    schemaVersion: 1,
-    generatedFrom:
-      worldType === 'XIANXIA'
-        ? {
-            worldType: 'XIANXIA' as const,
-            worldName: '仙侠',
-            settingSummary: '灵潮、宗门、禁制、秘境与道途交织。',
-            tone: '空灵、危险、带着灾变与大道压迫。',
-            conflictCore: '在裂变与因果之间稳住自我与道途。',
-          }
-        : {
-            worldType: 'WUXIA' as const,
-            worldName: '武侠',
-            settingSummary: '江湖、门派、旧案与人情纠葛并存。',
-            tone: '克制、紧张、讲究局势与心气。',
-            conflictCore: '在人情、威压与旧案之间立住自身。',
-          },
-  };
-
-  if (worldType === 'XIANXIA') {
-    return {
-      id: 'schema:xianxia:v1',
-      worldId: 'XIANXIA',
-      schemaName: '灵界六轴',
-      ...common,
-      slots: [
-        {
-          slotId: 'axis_a',
-          name: '道骨',
-          definition: '承载道压与高强度冲击的底子。',
-          positiveSignals: ['承压', '根基稳', '扛得住'],
-          negativeSignals: ['根基浅', '易溃', '承载不足'],
-          combatUseText: '扛住灵压、正面承受高强度对撞。',
-          socialUseText: '让人感到根基扎实，值得托付重事。',
-          explorationUseText: '承受秘境、禁制与裂隙带来的压迫。',
-        },
-        {
-          slotId: 'axis_b',
-          name: '灵行',
-          definition: '位移、御空、转场、抢占天时地利的能力。',
-          positiveSignals: ['位移', '御空', '机动'],
-          negativeSignals: ['迟滞', '失位', '转场慢'],
-          combatUseText: '抢位、御空、快速重整战场位置。',
-          socialUseText: '反应轻快，擅长顺势接住局面的变化。',
-          explorationUseText: '穿越高危地形、裂隙、云海与复杂禁区。',
-        },
-        {
-          slotId: 'axis_c',
-          name: '识海',
-          definition: '解析禁制、洞察因果、识破虚实的能力。',
-          positiveSignals: ['洞察', '解构', '看破'],
-          negativeSignals: ['迷失', '误判', '看不清'],
-          combatUseText: '识破术理、找出因果节点与破绽。',
-          socialUseText: '更容易辨认真话、虚言与隐藏动机。',
-          explorationUseText: '解读阵纹、禁制、旧史与环境异象。',
-        },
-        {
-          slotId: 'axis_d',
-          name: '劫纹',
-          definition: '在高危变化中强行推进、改写局势的能力。',
-          positiveSignals: ['强推', '决断', '逆转'],
-          negativeSignals: ['畏缩', '迟疑', '不敢碰变局'],
-          combatUseText: '在高压窗口里压上去，逼出变化与突破。',
-          socialUseText: '在关键谈判中拍板，推动他人表态。',
-          explorationUseText: '面对异变与风险时敢于推进关键节点。',
-        },
-        {
-          slotId: 'axis_e',
-          name: '心契',
-          definition: '与他者、器物、灵兽、誓约建立共鸣的能力。',
-          positiveSignals: ['共鸣', '结契', '安抚'],
-          negativeSignals: ['隔阂', '生硬', '难以共振'],
-          combatUseText: '与器物、灵兽、同伴形成协同与共鸣。',
-          socialUseText: '建立信任、誓约与更深层的关系连结。',
-          explorationUseText: '借由共鸣打开封印、回应遗物或安抚异兽。',
-        },
-        {
-          slotId: 'axis_f',
-          name: '玄息',
-          definition: '循环灵息、稳住心神、让自身持续在线的能力。',
-          positiveSignals: ['稳态', '回转', '续航'],
-          negativeSignals: ['紊乱', '枯竭', '失衡'],
-          combatUseText: '维持灵息循环、拖住长线压力与消耗。',
-          socialUseText: '气息沉稳，不轻易乱阵脚或露出破绽。',
-          explorationUseText: '在漫长探索与灵潮侵蚀中维持可行动状态。',
-        },
-      ] satisfies WorldAttributeSlot[],
-    } satisfies WorldAttributeSchema;
-  }
-
-  return {
-    id: 'schema:wuxia:v1',
-    worldId: 'WUXIA',
-    schemaVersion: 1,
-    schemaName: '江湖六脉',
-    generatedFrom: common.generatedFrom,
-    slots: [
-      {
-        slotId: 'axis_a',
-        name: '骨势',
-        definition: '扛压、顶冲、硬吃风险也不退的势头。',
-        positiveSignals: ['扛压', '硬桥硬马', '稳住正面'],
-        negativeSignals: ['虚浮', '怯退', '一碰就散'],
-        combatUseText: '顶住正面压力、换伤不退、撑住阵线。',
-        socialUseText: '在强压场面里不露怯，给人可靠或强硬之感。',
-        explorationUseText: '穿越险路、硬顶机关、承受高压环境。',
-      },
-      {
-        slotId: 'axis_b',
-        name: '身法',
-        definition: '腾挪、抢位、换线、把握出手节奏的能力。',
-        positiveSignals: ['快', '轻灵', '抢位'],
-        negativeSignals: ['迟缓', '失位', '笨重'],
-        combatUseText: '切线换位、闪转腾挪、争夺先手。',
-        socialUseText: '应变快，擅长观察气口并顺势接话。',
-        explorationUseText: '攀越、潜入、追踪与复杂地形穿行。',
-      },
-      {
-        slotId: 'axis_c',
-        name: '眼脉',
-        definition: '看破破绽、拆招、识局、看穿人心的能力。',
-        positiveSignals: ['识局', '洞察', '拆招'],
-        negativeSignals: ['迟钝', '误判', '看不透'],
-        combatUseText: '抓破绽、拆套路、找出最该切入的位置。',
-        socialUseText: '判断弦外之音、试探真假、识别来意。',
-        explorationUseText: '识破机关、辨认痕迹、看懂异状。',
-      },
-      {
-        slotId: 'axis_d',
-        name: '心焰',
-        definition: '决断、压迫、胆气、在局面中立住自身意志的能力。',
-        positiveSignals: ['胆气', '决断', '压迫'],
-        negativeSignals: ['犹疑', '软弱', '易被动摇'],
-        combatUseText: '逼迫对手、强行推进、在关键时刻拍板。',
-        socialUseText: '立威、定调、在谈判里压住场子。',
-        explorationUseText: '在未知风险前保持决断，不被局势拖死。',
-      },
-      {
-        slotId: 'axis_e',
-        name: '尘缘',
-        definition: '与人事、情面、承诺、牵引关系打交道的能力。',
-        positiveSignals: ['通人情', '会安抚', '懂交换'],
-        negativeSignals: ['生硬', '失礼', '不近人情'],
-        combatUseText: '借势协同、读懂同伴与对手的关系脉络。',
-        socialUseText: '安抚、求助、结盟、维系承诺与信任。',
-        explorationUseText: '从传闻、人脉和地方关系里打开线索。',
-      },
-      {
-        slotId: 'axis_f',
-        name: '玄息',
-        definition: '调息、稳态、久战、把自身维持在可用状态的能力。',
-        positiveSignals: ['稳', '续战', '调息'],
-        negativeSignals: ['紊乱', '易崩', '续不上'],
-        combatUseText: '续战、回气、稳住节奏与状态。',
-        socialUseText: '遇事不乱，语气和姿态都更沉稳可信。',
-        explorationUseText: '长线跋涉、在恶劣环境下维持专注与状态。',
-      },
-    ] satisfies WorldAttributeSlot[],
-  } satisfies WorldAttributeSchema;
-}
-
-function generateWorldAttributeSchema(input: {
-  worldName: string;
-  settingText: string;
-  summary: string;
-  tone: string;
-  playerGoal: string;
-}) {
-  const inferredWorldType = inferWorldTypeFromSetting(input.settingText);
-  const template = buildTemplateWorldAttributeSchema(
-    inferredWorldType === 'XIANXIA' ? 'XIANXIA' : 'WUXIA',
-  );
-
-  return {
-    ...template,
-    id: `schema:custom:${slugify(input.worldName)}`,
-    worldId: `custom:${input.worldName}`,
-    generatedFrom: {
-      worldType: 'CUSTOM',
-      worldName: input.worldName,
-      settingSummary: input.summary,
-      tone: input.tone,
-      conflictCore: input.playerGoal,
-    },
-  } satisfies WorldAttributeSchema;
-}
-
-function normalizeAttributeValues(
-  values: AttributeVector,
-  slotIds: readonly string[],
-  targetTotal = 360,
-) {
-  const positiveValues = slotIds.map((slotId) => Math.max(0, values[slotId] ?? 0));
-  const rawTotal = positiveValues.reduce((sum, value) => sum + value, 0);
-  const normalized =
-    rawTotal > 0
-      ? positiveValues.map((value) => (value / rawTotal) * targetTotal)
-      : slotIds.map(() => targetTotal / Math.max(slotIds.length, 1));
-  const rounded = normalized.map((value) => Math.max(0, Math.min(100, Math.round(value))));
-  return Object.fromEntries(
-    slotIds.map((slotId, index) => [slotId, rounded[index] ?? 0]),
-  ) as AttributeVector;
-}
-
-function ensureRoleAttributeProfile(
-  profile: Partial<RoleAttributeProfile> | null | undefined,
-  schema: WorldAttributeSchema,
-  fallbackValues: AttributeVector,
-): RoleAttributeProfile {
-  const slotIds = schema.slots.map((slot) => slot.slotId);
-  const values = normalizeAttributeValues(
-    {
-      ...fallbackValues,
-      ...(profile?.values ?? {}),
-    },
-    slotIds,
-  );
-  const sortedSlots = [...schema.slots]
-    .map((slot) => ({
-      slot,
-      value: values[slot.slotId] ?? 0,
-    }))
-    .sort((left, right) => right.value - left.value);
-
-  return {
-    schemaId: profile?.schemaId ?? schema.id,
-    values,
-    topTraits: sortedSlots.slice(0, 2).map((entry) => entry.slot.name),
-    hiddenTraits: profile?.hiddenTraits ? [...profile.hiddenTraits] : undefined,
-    evidence:
-      profile?.evidence?.length
-        ? [...profile.evidence]
-        : sortedSlots.slice(0, 3).map((entry) => ({
-            slotId: entry.slot.slotId,
-            reason: `${entry.slot.name}在当前画像中最突出。`,
-          })),
-  };
-}
-
-const AXIS_KEYWORD_RULES: Array<{
-  slotId: string;
-  patterns: RegExp[];
-  weight: number;
-}> = [
-  { slotId: 'axis_a', patterns: [/骨|甲|壳|岩|重|守|镇|顶|硬|锋|体/u], weight: 16 },
-  { slotId: 'axis_b', patterns: [/身法|迅|影|风|闪|游|机动|追|步|轻灵/u], weight: 16 },
-  { slotId: 'axis_c', patterns: [/识|眼|谋|算|阵|符|术|察|局|禁制/u], weight: 16 },
-  { slotId: 'axis_d', patterns: [/心|焰|胆|威|压|怒|决|破|强推|意志/u], weight: 16 },
-  { slotId: 'axis_e', patterns: [/缘|契|情|盟|商|医|助|信|交|誓/u], weight: 16 },
-  { slotId: 'axis_f', patterns: [/息|稳|续|守|调|回|养|持久|回复|韧/u], weight: 16 },
-];
-
-function buildDefaultAxisVector(
-  overrides: Partial<Record<(typeof WORLD_ATTRIBUTE_SLOT_IDS)[number], number>>,
-) {
-  return WORLD_ATTRIBUTE_SLOT_IDS.reduce<AttributeVector>((result, slotId) => {
-    result[slotId] = overrides[slotId] ?? 0;
-    return result;
-  }, {});
-}
-
-function buildRoleAttributeProfileFromTexts(params: {
-  entityId: string;
-  schema: WorldAttributeSchema;
-  textBlocks: Array<string | null | undefined>;
-}) {
-  const sourceText = params.textBlocks.filter(Boolean).join(' ');
-  const seed = buildDefaultAxisVector({
-    axis_a: 58,
-    axis_b: 58,
-    axis_c: 58,
-    axis_d: 58,
-    axis_e: 58,
-    axis_f: 58,
-  });
-
-  AXIS_KEYWORD_RULES.forEach((rule) => {
-    const matches = rule.patterns.reduce(
-      (count, pattern) => count + (pattern.test(sourceText) ? 1 : 0),
-      0,
-    );
-    if (matches <= 0) {
-      return;
-    }
-    seed[rule.slotId] = (seed[rule.slotId] ?? 0) + rule.weight * matches;
-  });
-
-  return ensureRoleAttributeProfile(
-    {
-      schemaId: params.schema.id,
-    },
-    params.schema,
-    seed,
-  );
-}
-
-function buildCustomWorldPlayableNpcAttributeProfile(
-  npc: CustomWorldPlayableNpc,
-  schema: WorldAttributeSchema,
-) {
-  return buildRoleAttributeProfileFromTexts({
-    entityId: npc.id,
-    schema,
-    textBlocks: [
-      npc.title,
-      npc.role,
-      npc.description,
-      npc.backstory,
-      npc.personality,
-      npc.motivation,
-      npc.combatStyle,
-      ...(npc.relationshipHooks ?? []),
-      ...(npc.tags ?? []),
-    ],
-  });
-}
-
-function buildCustomWorldStoryNpcAttributeProfile(
-  npc: CustomWorldNpc,
-  schema: WorldAttributeSchema,
-) {
-  return buildRoleAttributeProfileFromTexts({
-    entityId: npc.id,
-    schema,
-    textBlocks: [
-      npc.title,
-      npc.role,
-      npc.description,
-      npc.backstory,
-      npc.personality,
-      npc.motivation,
-      npc.combatStyle,
-      ...(npc.relationshipHooks ?? []),
-      ...(npc.tags ?? []),
-    ],
-  });
-}
-
-function buildBaseCustomWorldProfile(settingText: string): CustomWorldProfile {
-  const templateWorldType = inferWorldTypeFromSetting(settingText);
-  const name = buildWorldName(settingText, templateWorldType);
-  const subtitle = '前路未明';
-  const summary = settingText.trim()
-    ? `这个世界围绕“${settingText.trim().slice(0, 28)}”展开。`
-    : '一个仍待展开的独立世界正在成形。';
-  const tone = '未知、紧绷、仍在展开';
-  const playerGoal = '查清眼前局势的关键矛盾，并守住仍值得相信的人与事';
-  const camp = buildFallbackCustomWorldCampScene({
-    name,
-    summary,
-    tone,
-    playerGoal,
-    settingText: settingText.trim(),
-  });
-
-  return {
-    id: `custom-world-${Date.now().toString(36)}-${slugify(name)}`,
-    settingText: settingText.trim(),
-    name,
-    subtitle,
-    summary,
-    tone,
-    playerGoal,
-    cover: buildDefaultCustomWorldCover([]),
-    templateWorldType,
-    compatibilityTemplateWorldType: templateWorldType,
-    majorFactions: [],
-    coreConflicts: [summary],
-    attributeSchema: generateWorldAttributeSchema({
-      worldName: name,
-      settingText: settingText.trim(),
-      summary,
-      tone,
-      playerGoal,
-    }),
-    playableNpcs: [],
-    storyNpcs: [],
-    items: [],
-    camp,
-    landmarks: [],
-    themePack: null,
-    storyGraph: null,
-    creatorIntent: null,
-    anchorPack: null,
-    lockState: normalizeCustomWorldLockState(null),
-    generationMode: 'full',
-    generationStatus: 'complete',
-    ownedSettingLayers: null,
-    scenarioPackId: null,
-    campaignPackId: null,
-  };
-}
-
-function normalizeRoleOutlineList(
-  value: unknown,
-  options: {
-    titleFallback: string;
-    defaultAffinity: number;
-    maxCount?: number;
-  },
-) {
-  const normalized = toRecordArray(value)
-    .map((item) => {
-      const name = toText(item.name);
-      const title =
-        toText(item.title) || toText(item.role) || options.titleFallback;
-      const role = toText(item.role) || title;
-      const relationshipHooks = normalizeTags(
-        item.relationshipHooks,
-        normalizeTags(item.tags),
-      );
-
-      return {
-        name,
-        title,
-        role,
-        description:
-          toText(item.description) ||
-          clampText(`${name || title}在世界中以${role}身份活动。`, 36),
-        visualDescription: toText(item.visualDescription) || undefined,
-        actionDescription: toText(item.actionDescription) || undefined,
-        sceneVisualDescription: toText(item.sceneVisualDescription) || undefined,
-        initialAffinity: normalizeInitialAffinity(
-          item.initialAffinity,
-          options.defaultAffinity,
-        ),
-        relationshipHooks,
-        tags: normalizeTags(item.tags, relationshipHooks),
-      } satisfies CustomWorldGenerationRoleOutline;
-    })
-    .filter((entry) => entry.name);
-
-  return typeof options.maxCount === 'number'
-    ? normalized.slice(0, options.maxCount)
-    : normalized;
-}
-
-function normalizeCampOutline(
-  value: unknown,
-  fallbackProfile: {
-    name: string;
-    summary: string;
-    tone: string;
-    playerGoal: string;
-    settingText: string;
-  },
-) {
-  const fallback = buildFallbackCustomWorldCampScene(fallbackProfile);
-  const item =
-    value && typeof value === 'object'
-      ? (value as Record<string, unknown>)
-      : {};
-
-  return {
-    id: toText(item.id) || fallback.id,
-    name: toText(item.name) || fallback.name,
-    description: toText(item.description) || fallback.description,
-    visualDescription: toText(item.visualDescription) || undefined,
-    dangerLevel: toText(item.dangerLevel) || fallback.dangerLevel,
-    imageSrc: toText(item.imageSrc) || undefined,
-    sceneNpcIds: toStringArray(item.sceneNpcIds),
-    connections: toRecordArray(item.connections)
-      .map((connection) => ({
-        targetLandmarkName:
-          toText(connection.targetLandmarkName) ||
-          toText(connection.target) ||
-          toText(connection.sceneName),
-        relativePosition:
-          toText(connection.relativePosition) ||
-          toText(connection.position) ||
-          'forward',
-        summary:
-          toText(connection.summary) || toText(connection.description),
-      }))
-      .filter((connection) => connection.targetLandmarkName),
-  };
-}
-
-function normalizeLandmarkOutlineList(value: unknown) {
-  return toRecordArray(value)
-    .map((item) => {
-      const name = toText(item.name);
-      return {
-        name,
-        description:
-          toText(item.description) ||
-          clampText(`${name}暗藏新的局势变化。`, 40),
-        visualDescription: toText(item.visualDescription) || undefined,
-        dangerLevel: toText(item.dangerLevel) || 'medium',
-        sceneNpcNames: [
-          ...toStringArray(item.sceneNpcNames),
-          ...toStringArray(item.npcs, 'name'),
-          ...toStringArray(item.sceneNpcs, 'name'),
-          ...toStringArray(item.npcNames),
-        ],
-        connections: toRecordArray(item.connections)
-          .map((connection) => ({
-            targetLandmarkName:
-              toText(connection.targetLandmarkName) ||
-              toText(connection.target) ||
-              toText(connection.sceneName),
-            relativePosition:
-              toText(connection.relativePosition) ||
-              toText(connection.position) ||
-              'forward',
-            summary:
-              toText(connection.summary) || toText(connection.description),
-          }))
-          .filter((connection) => connection.targetLandmarkName),
-      } satisfies CustomWorldGenerationLandmarkOutline;
-    })
-    .filter((entry) => entry.name)
-    .slice(0, MIN_CUSTOM_WORLD_LANDMARK_COUNT);
-}
-
-export function normalizeCustomWorldGenerationRoleOutlineBatch(
-  raw: unknown,
-  roleType: CustomWorldGenerationRoleBatchType,
-) {
-  const item =
-    raw && typeof raw === 'object' ? (raw as Record<string, unknown>) : {};
-  const key = roleType === 'playable' ? 'playableNpcs' : 'storyNpcs';
-
-  return normalizeRoleOutlineList(item[key], {
-    titleFallback: '未定称号',
-    defaultAffinity:
-      roleType === 'playable'
-        ? DEFAULT_PLAYABLE_INITIAL_AFFINITY
-        : DEFAULT_STORY_NPC_INITIAL_AFFINITY,
-  });
-}
-
-export function normalizeCustomWorldGenerationLandmarkOutlineBatch(
-  raw: unknown,
-) {
-  const item =
-    raw && typeof raw === 'object' ? (raw as Record<string, unknown>) : {};
-  return normalizeLandmarkOutlineList(item.landmarks);
-}
-
-export function normalizeCustomWorldGenerationFramework(
-  raw: unknown,
-  settingText: string,
-): CustomWorldGenerationFramework {
-  const fallback = buildBaseCustomWorldProfile(settingText);
-  if (!raw || typeof raw !== 'object') {
-    return {
-      settingText: fallback.settingText,
-      name: fallback.name,
-      subtitle: fallback.subtitle,
-      summary: fallback.summary,
-      tone: fallback.tone,
-      playerGoal: fallback.playerGoal,
-      templateWorldType: fallback.templateWorldType,
-      compatibilityTemplateWorldType:
-        fallback.compatibilityTemplateWorldType ?? fallback.templateWorldType,
-      majorFactions: [],
-      coreConflicts: [fallback.summary],
-      camp: {
-        name: fallback.camp?.name ?? '归舍',
-        description: fallback.camp?.description ?? '',
-        dangerLevel: fallback.camp?.dangerLevel ?? 'low',
-      },
-      playableNpcs: [],
-      storyNpcs: [],
-      landmarks: [],
-    };
-  }
-
-  const item = raw as Record<string, unknown>;
-  const worldSignalText = [
-    settingText,
-    toText(item.subtitle),
-    toText(item.summary),
-    toText(item.tone),
-    toText(item.playerGoal),
-  ].join(' ');
-  const templateWorldType = normalizeWorldType(
-    item.templateWorldType,
-    worldSignalText,
-  );
-  const name =
-    toText(item.name) || buildWorldName(settingText, templateWorldType);
-
-  return {
-    settingText: settingText.trim(),
-    name,
-    subtitle: toText(item.subtitle) || fallback.subtitle,
-    summary: toText(item.summary) || fallback.summary,
-    tone: toText(item.tone) || fallback.tone,
-    playerGoal: toText(item.playerGoal) || fallback.playerGoal,
-    templateWorldType,
-    compatibilityTemplateWorldType: templateWorldType,
-    majorFactions: normalizeTags(item.majorFactions, []),
-    coreConflicts: normalizeTags(item.coreConflicts, [fallback.summary]),
-    camp: normalizeCampOutline(item.camp, {
-      name,
-      summary: toText(item.summary) || fallback.summary,
-      tone: toText(item.tone) || fallback.tone,
-      playerGoal: toText(item.playerGoal) || fallback.playerGoal,
-      settingText: settingText.trim(),
-    }),
-    playableNpcs: normalizeRoleOutlineList(item.playableNpcs, {
-      titleFallback: '未定称号',
-      defaultAffinity: DEFAULT_PLAYABLE_INITIAL_AFFINITY,
-      maxCount: MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT,
-    }),
-    storyNpcs: normalizeRoleOutlineList(item.storyNpcs, {
-      titleFallback: '未定称号',
-      defaultAffinity: DEFAULT_STORY_NPC_INITIAL_AFFINITY,
-      maxCount: MIN_CUSTOM_WORLD_STORY_NPC_COUNT,
-    }),
-    landmarks: normalizeLandmarkOutlineList(item.landmarks),
-  };
-}
-
-export function buildCustomWorldRawProfileFromFramework(
-  framework: CustomWorldGenerationFramework,
-) {
-  return {
-    name: framework.name,
-    subtitle: framework.subtitle,
-    summary: framework.summary,
-    tone: framework.tone,
-    playerGoal: framework.playerGoal,
-    templateWorldType: framework.templateWorldType,
-    compatibilityTemplateWorldType: framework.compatibilityTemplateWorldType,
-    majorFactions: framework.majorFactions,
-    coreConflicts: framework.coreConflicts,
-    camp: {
-      name: framework.camp.name,
-      description: framework.camp.description,
-      dangerLevel: framework.camp.dangerLevel,
-    },
-    playableNpcs: framework.playableNpcs.map((npc) => ({
-      name: npc.name,
-      title: npc.title,
-      role: npc.role,
-      description: npc.description,
-      visualDescription: npc.visualDescription,
-      actionDescription: npc.actionDescription,
-      sceneVisualDescription: npc.sceneVisualDescription,
-      initialAffinity: npc.initialAffinity,
-      relationshipHooks: [...npc.relationshipHooks],
-      tags: [...npc.tags],
-    })),
-    storyNpcs: framework.storyNpcs.map((npc) => ({
-      name: npc.name,
-      title: npc.title,
-      role: npc.role,
-      description: npc.description,
-      visualDescription: npc.visualDescription,
-      actionDescription: npc.actionDescription,
-      sceneVisualDescription: npc.sceneVisualDescription,
-      initialAffinity: npc.initialAffinity,
-      relationshipHooks: [...npc.relationshipHooks],
-      tags: [...npc.tags],
-    })),
-    landmarks: framework.landmarks.map((landmark) => ({
-      name: landmark.name,
-      description: landmark.description,
-      visualDescription: landmark.visualDescription,
-      dangerLevel: landmark.dangerLevel,
-      sceneNpcNames: [...landmark.sceneNpcNames],
-      connections: landmark.connections.map((connection) => ({
-        targetLandmarkName: connection.targetLandmarkName,
-        relativePosition: connection.relativePosition,
-        summary: connection.summary,
-      })),
-    })),
-  };
-}
-
-function normalizeRoleProfile(
-  item: Record<string, unknown>,
-  index: number,
-  options: {
-    idPrefix: 'playable-npc' | 'story-npc';
-    titleFallback: string;
-    defaultAffinity: number;
-  },
-) {
-  const name = toText(item.name);
-  const title =
-    toText(item.title) || toText(item.role) || options.titleFallback;
-  const role = toText(item.role) || title;
-  const relationshipHooks = normalizeTags(
-    item.relationshipHooks,
-    normalizeTags(item.tags),
-  );
-  const normalizedRole = {
-    id: toText(item.id) || createEntryId(options.idPrefix, name, index),
-    name,
-    title,
-    role,
-    description: toText(item.description),
-    visualDescription: toText(item.visualDescription) || undefined,
-    actionDescription: toText(item.actionDescription) || undefined,
-    sceneVisualDescription: toText(item.sceneVisualDescription) || undefined,
-    backstory: toText(item.backstory),
-    personality: toText(item.personality),
-    motivation: toText(item.motivation) || toText(item.description),
-    combatStyle: toText(item.combatStyle),
-    initialAffinity: normalizeInitialAffinity(
-      item.initialAffinity,
-      options.defaultAffinity,
-    ),
-    relationshipHooks,
-    tags: normalizeTags(item.tags, relationshipHooks),
-  };
-
-  return {
-    ...normalizedRole,
-    backstoryReveal: normalizeBackstoryReveal(
-      item.backstoryReveal,
-      normalizedRole,
-    ),
-    skills: normalizeRoleSkillList(item.skills, normalizedRole),
-    initialItems: normalizeRoleInitialItemList(item.initialItems, normalizedRole),
-    imageSrc: toText(item.imageSrc) || undefined,
-    generatedVisualAssetId: toText(item.generatedVisualAssetId) || undefined,
-    generatedAnimationSetId:
-      toText(item.generatedAnimationSetId) || undefined,
-    animationMap:
-      item.animationMap && typeof item.animationMap === 'object'
-        ? (item.animationMap as Record<string, unknown>)
-        : undefined,
-    narrativeProfile:
-      item.narrativeProfile && typeof item.narrativeProfile === 'object'
-        ? (item.narrativeProfile as CustomWorldRoleProfile['narrativeProfile'])
-        : null,
-  };
-}
-
-function normalizePlayableNpcList(value: unknown) {
-  return toRecordArray(value)
-    .map((item, index) => ({
-      ...normalizeRoleProfile(item, index, {
-        idPrefix: 'playable-npc',
-        titleFallback: '未定称号',
-        defaultAffinity: DEFAULT_PLAYABLE_INITIAL_AFFINITY,
-      }),
-      templateCharacterId: toText(item.templateCharacterId) || undefined,
-    }))
-    .filter((entry) => entry.name)
-    .slice(0, MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT);
-}
-
-function normalizeStoryNpcList(value: unknown) {
-  return toRecordArray(value)
-    .map(
-      (item, index) =>
-        ({
-          ...normalizeRoleProfile(item, index, {
-            idPrefix: 'story-npc',
-            titleFallback: '未定称号',
-            defaultAffinity: DEFAULT_STORY_NPC_INITIAL_AFFINITY,
-          }),
-          visual:
-            item.visual && typeof item.visual === 'object'
-              ? (item.visual as Record<string, unknown>)
-              : undefined,
-        }) satisfies CustomWorldNpc,
-    )
-    .filter((entry) => entry.name);
-}
-
-function normalizeCustomWorldCoverCharacterRoleIds(
-  value: unknown,
-  playableNpcs: Array<Pick<CustomWorldPlayableNpc, 'id'>>,
-) {
-  const availableIds = new Set(
-    playableNpcs.map((entry) => entry.id.trim()).filter(Boolean),
-  );
-  const selectedIds = Array.isArray(value)
-    ? [
-        ...new Set(
-          value
-            .map((entry) => toText(entry))
-            .filter((entry) => entry && availableIds.has(entry)),
-        ),
-      ].slice(0, 3)
-    : [];
-
-  if (selectedIds.length > 0) {
-    return selectedIds;
-  }
-
-  return playableNpcs
-    .map((entry) => entry.id.trim())
-    .filter(Boolean)
-    .slice(0, 3);
-}
-
-function buildDefaultCustomWorldCover(
-  playableNpcs: Array<Pick<CustomWorldPlayableNpc, 'id'>>,
-): CustomWorldCoverProfile {
-  return {
-    sourceType: 'default' as const,
-    imageSrc: null,
-    characterRoleIds: normalizeCustomWorldCoverCharacterRoleIds(
-      undefined,
-      playableNpcs,
-    ),
-  };
-}
-
-function normalizeCustomWorldCover(
-  value: unknown,
-  playableNpcs: Array<Pick<CustomWorldPlayableNpc, 'id'>>,
-): CustomWorldCoverProfile {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) {
-    return buildDefaultCustomWorldCover(playableNpcs);
-  }
-
-  const item = value as Record<string, unknown>;
-  const sourceType: CustomWorldCoverSourceType =
-    item.sourceType === 'uploaded' || item.sourceType === 'generated'
-      ? item.sourceType
-      : 'default';
-  const imageSrc = toText(item.imageSrc) || null;
-
-  if (sourceType !== 'default' && imageSrc) {
-    return {
-      sourceType,
-      imageSrc,
-      characterRoleIds: [],
-    };
-  }
-
-  return buildDefaultCustomWorldCover(playableNpcs);
-}
-
-function normalizeItemList(value: unknown) {
-  return toRecordArray(value)
-    .map((item, index) => {
-      const name = toText(item.name);
-      const category = toText(item.category);
-      return {
-        id: toText(item.id) || createEntryId('item', name, index),
-        name,
-        category,
-        rarity: normalizeRarity(item.rarity, 'rare'),
-        description: toText(item.description),
-        tags: normalizeTags(item.tags),
-      } satisfies CustomWorldItem;
-    })
-    .filter((entry) => entry.name && entry.category);
-}
-
-function normalizeSceneActStageCoverage(value: unknown) {
-  const stageCoverage = Array.isArray(value)
-    ? value
-        .filter((entry): entry is string => typeof entry === 'string')
-        .map((entry) => entry.trim())
-        .filter((entry): entry is SceneActBlueprint['stageCoverage'][number] =>
-          SCENE_ACT_STAGES.has(entry as never),
-        )
-    : [];
-
-  return [...new Set(stageCoverage)];
-}
-
-function normalizeSceneActBlueprint(
-  value: unknown,
-  index: number,
-  sceneId: string,
-): SceneActBlueprint | null {
-  const item =
-    value && typeof value === 'object'
-      ? (value as Record<string, unknown>)
-      : null;
-  if (!item) {
-    return null;
-  }
-
-  const encounterNpcIds = toStringArray(item.encounterNpcIds);
-  const stageCoverage = normalizeSceneActStageCoverage(item.stageCoverage);
-  const advanceRule = toText(item.advanceRule);
-  const title = toText(item.title);
-  const summary = toText(item.summary);
-
-  if (!title && !summary && encounterNpcIds.length === 0) {
-    return null;
-  }
-
-  return {
-    id: toText(item.id) || `saved-scene-act-${sceneId}-${index + 1}`,
-    sceneId,
-    title: title || `第 ${index + 1} 幕`,
-    summary: summary || title || `围绕${sceneId}继续推进`,
-    stageCoverage:
-      stageCoverage.length > 0
-        ? stageCoverage
-        : index === 0
-          ? ['opening']
-          : ['climax', 'aftermath'],
-    backgroundImageSrc: toText(item.backgroundImageSrc) || undefined,
-    backgroundAssetId: toText(item.backgroundAssetId) || undefined,
-    encounterNpcIds,
-    primaryNpcId: toText(item.primaryNpcId) || encounterNpcIds[0] || '',
-    linkedThreadIds: toStringArray(item.linkedThreadIds),
-    advanceRule: SCENE_ACT_ADVANCE_RULES.has(advanceRule as never)
-      ? (advanceRule as SceneActBlueprint['advanceRule'])
-      : 'after_active_step_complete',
-    actGoal: toText(item.actGoal),
-    transitionHook: toText(item.transitionHook),
-  };
-}
-
-function normalizeSceneChapterBlueprints(value: unknown) {
-  if (!Array.isArray(value)) {
-    return null;
-  }
-
-  const normalized = value
-    .filter(
-      (entry): entry is Record<string, unknown> =>
-        Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry),
-    )
-    .map((entry, index) => {
-      const sceneId = toText(entry.sceneId);
-      if (!sceneId) {
-        return null;
-      }
-
-      const acts = Array.isArray(entry.acts)
-        ? entry.acts
-            .map((act, actIndex) =>
-              normalizeSceneActBlueprint(act, actIndex, sceneId),
-            )
-            .filter((act): act is SceneActBlueprint => Boolean(act))
-        : [];
-
-      return {
-        id: toText(entry.id) || `saved-scene-chapter-${sceneId}-${index + 1}`,
-        sceneId,
-        title: toText(entry.title) || toText(entry.sceneName) || sceneId,
-        summary: toText(entry.summary),
-        linkedThreadIds: toStringArray(entry.linkedThreadIds),
-        linkedLandmarkIds: toStringArray(entry.linkedLandmarkIds),
-        acts,
-      } satisfies SceneChapterBlueprint;
-    })
-    .filter((entry): entry is SceneChapterBlueprint => Boolean(entry));
-
-  return normalized.length > 0 ? normalized : null;
-}
-
-function normalizeLandmarks(params: {
-  landmarks: Array<Record<string, unknown>>;
-  storyNpcs: CustomWorldNpc[];
-}) {
-  const storyNpcIdByName = new Map(
-    params.storyNpcs.map((npc) => [npc.name.trim(), npc.id] as const),
-  );
-  const landmarkEntries = params.landmarks
-    .map((item, index) => ({
-      id: toText(item.id) || createEntryId('landmark', toText(item.name), index),
-      name: toText(item.name),
-      description: toText(item.description),
-      visualDescription: toText(item.visualDescription) || undefined,
-      dangerLevel: toText(item.dangerLevel) || 'medium',
-      imageSrc: toText(item.imageSrc) || undefined,
-      sceneNpcIds: toStringArray(item.sceneNpcIds),
-      sceneNpcNames: [
-        ...toStringArray(item.sceneNpcNames),
-        ...toStringArray(item.npcs, 'name'),
-        ...toStringArray(item.sceneNpcs, 'name'),
-        ...toStringArray(item.npcNames),
-      ],
-      connections: toRecordArray(item.connections).map((connection) => ({
-        targetLandmarkId: toText(connection.targetLandmarkId),
-        targetLandmarkName:
-          toText(connection.targetLandmarkName) ||
-          toText(connection.target) ||
-          toText(connection.sceneName),
-        relativePosition:
-          toText(connection.relativePosition) || toText(connection.position),
-        summary: toText(connection.summary) || toText(connection.description),
-      })),
-    }))
-    .filter((entry) => entry.name);
-
-  const landmarkIdByName = new Map(
-    landmarkEntries.map((landmark) => [landmark.name.trim(), landmark.id] as const),
-  );
-
-  return landmarkEntries.map((landmark) => {
-    const resolvedSceneNpcIds = [
-      ...new Set(
-        [
-          ...landmark.sceneNpcIds,
-          ...landmark.sceneNpcNames
-            .map((name) => storyNpcIdByName.get(name.trim()) ?? '')
-            .filter(Boolean),
-        ].filter(Boolean),
-      ),
-    ];
-
-    return {
-      id: landmark.id,
-      name: landmark.name,
-      description: landmark.description,
-      visualDescription: landmark.visualDescription,
-      dangerLevel: landmark.dangerLevel,
-      imageSrc: landmark.imageSrc,
-      sceneNpcIds: resolvedSceneNpcIds,
-      connections: landmark.connections
-        .map((connection) => ({
-          targetLandmarkId:
-            connection.targetLandmarkId ||
-            landmarkIdByName.get(connection.targetLandmarkName.trim()) ||
-            '',
-          relativePosition: connection.relativePosition || 'forward',
-          summary: connection.summary,
-        }))
-        .filter((connection) => connection.targetLandmarkId),
-    };
-  });
-}
-
-function normalizeCampScene(
-  value: unknown,
-  fallbackProfile: {
-    name: string;
-    summary: string;
-    tone: string;
-    playerGoal: string;
-    settingText: string;
-  },
-): CustomWorldCampScene {
-  const fallback = buildFallbackCustomWorldCampScene(fallbackProfile);
-  const item =
-    value && typeof value === 'object'
-      ? (value as Record<string, unknown>)
-      : {};
-
-  return {
-    id: toText(item.id) || fallback.id,
-    name: toText(item.name) || fallback.name,
-    description: toText(item.description) || fallback.description,
-    visualDescription: toText(item.visualDescription) || undefined,
-    dangerLevel: toText(item.dangerLevel) || fallback.dangerLevel,
-    imageSrc: toText(item.imageSrc) || undefined,
-    sceneNpcIds: toStringArray(item.sceneNpcIds),
-    connections: toRecordArray(item.connections)
-      .map((connection) => ({
-        targetLandmarkId: toText(connection.targetLandmarkId),
-        relativePosition:
-          toText(connection.relativePosition) || toText(connection.position) || 'forward',
-        summary: toText(connection.summary) || toText(connection.description),
-      }))
-      .filter((connection) => connection.targetLandmarkId),
-    narrativeResidues: null,
-  };
-}
-
-export function normalizeCustomWorldProfile(
-  raw: unknown,
-  settingText: string,
-): CustomWorldProfile {
-  const fallback = buildBaseCustomWorldProfile(settingText);
-  if (!raw || typeof raw !== 'object') {
-    return fallback;
-  }
-
-  const item = raw as Record<string, unknown>;
-  const worldSignalText = [
-    settingText,
-    toText(item.subtitle),
-    toText(item.summary),
-    toText(item.tone),
-    toText(item.playerGoal),
-  ].join(' ');
-  const templateWorldType = normalizeWorldType(
-    item.templateWorldType,
-    worldSignalText,
-  );
-  const name =
-    toText(item.name) || buildWorldName(settingText, templateWorldType);
-  const summary = toText(item.summary) || fallback.summary;
-  const tone = toText(item.tone) || fallback.tone;
-  const playerGoal = toText(item.playerGoal) || fallback.playerGoal;
-  const generatedAttributeSchema = generateWorldAttributeSchema({
-    worldName: name,
-    settingText: settingText.trim(),
-    summary,
-    tone,
-    playerGoal,
-  });
-  const playableNpcs = normalizePlayableNpcList(item.playableNpcs);
-  const storyNpcs = normalizeStoryNpcList(item.storyNpcs);
-  const landmarkDrafts = toRecordArray(item.landmarks);
-  const camp = normalizeCampScene(item.camp, {
-    name,
-    summary,
-    tone,
-    playerGoal,
-    settingText: settingText.trim(),
-  });
-  const creatorIntent = normalizeCustomWorldCreatorIntent(item.creatorIntent);
-
-  return {
-    id:
-      toText(item.id) || `custom-world-${Date.now().toString(36)}-${slugify(name)}`,
-    settingText: settingText.trim(),
-    name,
-    subtitle: toText(item.subtitle) || fallback.subtitle,
-    summary,
-    tone,
-    playerGoal,
-    cover: normalizeCustomWorldCover(item.cover, playableNpcs),
-    templateWorldType,
-    compatibilityTemplateWorldType: templateWorldType,
-    majorFactions: normalizeTags(item.majorFactions, []),
-    coreConflicts: normalizeTags(item.coreConflicts, [summary]),
-    attributeSchema:
-      item.attributeSchema && typeof item.attributeSchema === 'object'
-        ? generatedAttributeSchema
-        : generatedAttributeSchema,
-    playableNpcs,
-    storyNpcs,
-    items: normalizeItemList(item.items),
-    camp,
-    landmarks: normalizeLandmarks({
-      landmarks: landmarkDrafts,
-      storyNpcs,
-    }),
-    themePack:
-      item.themePack && typeof item.themePack === 'object'
-        ? (item.themePack as CustomWorldProfile['themePack'])
-        : null,
-    storyGraph:
-      item.storyGraph && typeof item.storyGraph === 'object'
-        ? (item.storyGraph as CustomWorldProfile['storyGraph'])
-        : null,
-    anchorContent:
-      item.anchorContent && typeof item.anchorContent === 'object'
-        ? (item.anchorContent as Record<string, unknown>)
-        : null,
-    creatorIntent,
-    anchorPack:
-      item.anchorPack && typeof item.anchorPack === 'object'
-        ? (item.anchorPack as CustomWorldProfile['anchorPack'])
-        : buildCustomWorldAnchorPackFromIntent(creatorIntent),
-    lockState:
-      item.lockState && typeof item.lockState === 'object'
-        ? normalizeCustomWorldLockState(item.lockState)
-        : deriveCustomWorldLockStateFromIntent(creatorIntent),
-    generationMode:
-      item.generationMode === 'fast' || item.generationMode === 'full'
-        ? item.generationMode
-        : fallback.generationMode,
-    generationStatus:
-      item.generationStatus === 'key_only' || item.generationStatus === 'complete'
-        ? item.generationStatus
-        : fallback.generationStatus,
-    ownedSettingLayers:
-      item.ownedSettingLayers && typeof item.ownedSettingLayers === 'object'
-        ? (item.ownedSettingLayers as Record<string, unknown>)
-        : null,
-    knowledgeFacts:
-      Array.isArray(item.knowledgeFacts)
-        ? (item.knowledgeFacts as Array<Record<string, unknown>>)
-        : null,
-    threadContracts:
-      Array.isArray(item.threadContracts)
-        ? (item.threadContracts as Array<Record<string, unknown>>)
-        : null,
-    sceneChapterBlueprints: normalizeSceneChapterBlueprints(
-      item.sceneChapterBlueprints,
-    ),
-    scenarioPackId: toText(item.scenarioPackId) || null,
-    campaignPackId: toText(item.campaignPackId) || null,
-  };
-}
-
-function pickCyclic<T>(items: readonly T[], index: number, label: string): T {
-  const item = items[index % items.length];
-  if (item === undefined) {
-    throw new Error(`Missing ${label}`);
-  }
-  return item;
-}
-
-export function buildCompiledCustomWorldProfile(
-  raw: unknown,
-  settingText: string,
-): CustomWorldProfile {
-  const profile = normalizeCustomWorldProfile(raw, settingText);
-  const playableNpcs = profile.playableNpcs.map((npc, index) => {
-    const templateCharacterId =
-      npc.templateCharacterId ??
-      pickCyclic(
-        PLAYABLE_TEMPLATE_CHARACTER_IDS,
-        index,
-        'playable template character id',
-      );
-
-    return {
-      ...npc,
-      templateCharacterId,
-      attributeProfile:
-        npc.attributeProfile ??
-        buildCustomWorldPlayableNpcAttributeProfile(
-          {
-            ...npc,
-            templateCharacterId,
-          },
-          profile.attributeSchema,
-        ),
-    };
-  });
-
-  const storyNpcs = profile.storyNpcs.map((npc) => ({
-    ...npc,
-    attributeProfile:
-      npc.attributeProfile ??
-      buildCustomWorldStoryNpcAttributeProfile(npc, profile.attributeSchema),
-  }));
-
-  return {
-    ...profile,
-    playableNpcs,
-    storyNpcs,
-    scenarioPackId:
-      profile.scenarioPackId ?? `scenario-pack:${slugify(profile.name)}`,
-    campaignPackId:
-      profile.campaignPackId ?? `campaign-pack:${slugify(profile.name)}`,
-  };
-}
-
-function countUniqueNames(items: Array<{ name: string }>) {
-  return new Set(items.map((item) => item.name.trim()).filter(Boolean)).size;
-}
-
-export function validateGeneratedCustomWorldProfile(
-  profile: CustomWorldProfile,
-) {
-  const playableCount = countUniqueNames(profile.playableNpcs);
-  const landmarkCount = countUniqueNames(profile.landmarks);
-
-  if (playableCount < MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT) {
-    throw new Error(
-      `自定义世界生成要求模型至少产出 ${MIN_CUSTOM_WORLD_PLAYABLE_NPC_COUNT} 名可扮演角色。`,
-    );
-  }
-
-  if (landmarkCount < MIN_CUSTOM_WORLD_LANDMARK_COUNT) {
-    throw new Error(
-      `自定义世界生成要求至少产出 ${MIN_CUSTOM_WORLD_LANDMARK_COUNT} 个场景，当前仅返回 ${landmarkCount} 个。`,
-    );
-  }
-
-  const validStoryNpcIds = new Set(profile.storyNpcs.map((npc) => npc.id));
-  const validLandmarkIds = new Set(
-    profile.landmarks.map((landmark) => landmark.id),
-  );
-
-  profile.landmarks.forEach((landmark) => {
-    const uniqueSceneNpcIds = [...new Set(landmark.sceneNpcIds)];
-    if (uniqueSceneNpcIds.length < 3) {
-      throw new Error(
-        `场景「${landmark.name}」至少需要关联 3 个场景角色，当前仅有 ${uniqueSceneNpcIds.length} 个。`,
-      );
-    }
-    if (uniqueSceneNpcIds.some((npcId) => !validStoryNpcIds.has(npcId))) {
-      throw new Error(`场景「${landmark.name}」引用了不存在的场景角色。`);
-    }
-    if (landmark.connections.length === 0) {
-      throw new Error(`场景「${landmark.name}」缺少可用的场景连接关系。`);
-    }
-    if (
-      landmark.connections.some(
-        (connection) =>
-          connection.targetLandmarkId === landmark.id ||
-          !validLandmarkIds.has(connection.targetLandmarkId),
-      )
-    ) {
-      throw new Error(`场景「${landmark.name}」存在无效的目标场景连接。`);
-    }
-  });
-}
+/**
+ * 兼容期 façade：
+ * 旧调用暂时继续从 runtimeProfile.ts 导入，避免在工作包 G 首轮落地时放大迁移范围。
+ * 新代码应逐步改走 runtime-profile/ 目录入口。
+ */
+export * from './runtime-profile/index.js';
diff --git a/server-node/src/modules/inventory/inventoryStoryActionService.ts b/server-node/src/modules/inventory/inventoryStoryActionService.ts
index 39670c2f..9e86d417 100644
--- a/server-node/src/modules/inventory/inventoryStoryActionService.ts
+++ b/server-node/src/modules/inventory/inventoryStoryActionService.ts
@@ -1,7 +1,7 @@
 import type {
   RuntimeStoryActionRequest,
   RuntimeStoryPatch,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
 import { conflict, invalidRequest } from '../../errors.js';
 import {
   getPlayerBuildDamageBreakdown,
@@ -19,8 +19,8 @@ import {
 } from './inventoryMutationService.js';
 import {
   replaceRuntimeSessionRawGameState,
-  type RuntimeSession,
-} from '../story/runtimeSession.js';
+} from '../rpg-runtime-story/RpgRuntimeSnapshotSync.js';
+import type { RuntimeSession } from '../rpg-runtime-story/RpgRuntimeSessionLoader.js';
 
 const SUPPORTED_INVENTORY_STORY_FUNCTION_IDS = new Set<string>([
   'equipment_equip',
diff --git a/server-node/src/modules/inventory/npcInventoryStoryActionService.ts b/server-node/src/modules/inventory/npcInventoryStoryActionService.ts
index 86f87d18..0b093731 100644
--- a/server-node/src/modules/inventory/npcInventoryStoryActionService.ts
+++ b/server-node/src/modules/inventory/npcInventoryStoryActionService.ts
@@ -1,7 +1,7 @@
 import type {
   RuntimeStoryActionRequest,
   RuntimeStoryPatch,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
 import { conflict, invalidRequest } from '../../errors.js';
 import {
   addInventoryItems,
@@ -23,8 +23,8 @@ import {
 } from '../../bridges/legacyNpcTask6Bridge.js';
 import {
   replaceRuntimeSessionRawGameState,
-  type RuntimeSession,
-} from '../story/runtimeSession.js';
+} from '../rpg-runtime-story/RpgRuntimeSnapshotSync.js';
+import type { RuntimeSession } from '../rpg-runtime-story/RpgRuntimeSessionLoader.js';
 
 const SUPPORTED_NPC_INVENTORY_STORY_FUNCTION_IDS = new Set<string>([
   'npc_gift',
diff --git a/server-node/src/modules/npc/npcInteractionService.ts b/server-node/src/modules/npc/npcInteractionService.ts
index 71ae0cf7..3e1acbca 100644
--- a/server-node/src/modules/npc/npcInteractionService.ts
+++ b/server-node/src/modules/npc/npcInteractionService.ts
@@ -1,6 +1,10 @@
-import type { RuntimeStoryPatch } from '../../../../packages/shared/src/contracts/story.js';
+import type { RuntimeStoryPatch } from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
 import { conflict } from '../../errors.js';
 import { resolveHostileBattleProfile } from '../progression/hostileProgressionService.js';
+import {
+  applyStoryChoiceToStanceProfile,
+} from './npcTask6Primitives.js';
+import { markNpcFirstMeaningfulContactResolved } from '../runtime/runtimeNpcStatePrimitives.js';
 import {
   MAX_TASK5_COMPANIONS,
   getEncounterNpcState,
@@ -8,7 +12,7 @@ import {
   type RuntimeEncounter,
   type RuntimeNpcState,
   type RuntimeSession,
-} from '../story/runtimeSession.js';
+} from '../rpg-runtime-story/RpgRuntimeSessionPrimitives.js';
 
 type JsonRecord = Record<string, unknown>;
 
@@ -57,6 +61,158 @@ function isRecord(value: unknown): value is JsonRecord {
   return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 
+function readString(value: unknown) {
+  return typeof value === 'string' && value.trim() ? value.trim() : '';
+}
+
+function buildRecruitedCompanion(
+  session: RuntimeSession,
+  encounter: RuntimeEncounter,
+  npcState: RuntimeNpcState,
+) {
+  const rawCompanionSource = isRecord(session.rawGameState.currentEncounter)
+    ? session.rawGameState.currentEncounter
+    : {};
+  const maxHp = Math.max(
+    1,
+    Math.round(
+      typeof rawCompanionSource.maxHp === 'number' &&
+        Number.isFinite(rawCompanionSource.maxHp)
+        ? rawCompanionSource.maxHp
+        : 180,
+    ),
+  );
+  const maxMana = Math.max(
+    1,
+    Math.round(
+      typeof rawCompanionSource.maxMana === 'number' &&
+        Number.isFinite(rawCompanionSource.maxMana)
+        ? rawCompanionSource.maxMana
+        : 999,
+    ),
+  );
+  const skillCooldowns = Object.fromEntries(
+    Object.entries(
+      isRecord(rawCompanionSource.skillCooldowns)
+        ? rawCompanionSource.skillCooldowns
+        : {},
+    ).map(([skillId, turns]) => [
+      skillId,
+      typeof turns === 'number' && Number.isFinite(turns)
+        ? Math.max(0, Math.round(turns))
+        : 0,
+    ]),
+  );
+
+  return {
+    npcId: encounter.id,
+    characterId: encounter.characterId ?? '',
+    joinedAtAffinity: npcState.affinity,
+    hp: maxHp,
+    maxHp,
+    mana: maxMana,
+    maxMana,
+    skillCooldowns,
+    animationState: readString(rawCompanionSource.animationState) || 'idle',
+    actionMode: readString(rawCompanionSource.actionMode) || 'idle',
+    offsetX:
+      typeof rawCompanionSource.offsetX === 'number' &&
+      Number.isFinite(rawCompanionSource.offsetX)
+        ? rawCompanionSource.offsetX
+        : 0,
+    offsetY:
+      typeof rawCompanionSource.offsetY === 'number' &&
+      Number.isFinite(rawCompanionSource.offsetY)
+        ? rawCompanionSource.offsetY
+        : 0,
+    transitionMs:
+      typeof rawCompanionSource.transitionMs === 'number' &&
+      Number.isFinite(rawCompanionSource.transitionMs)
+        ? Math.max(0, Math.round(rawCompanionSource.transitionMs))
+        : 0,
+  };
+}
+
+function upsertCompanion(
+  list: RuntimeSession['companions'],
+  companion: RuntimeSession['companions'][number],
+) {
+  const next = [...list];
+  const existingIndex = next.findIndex((item) => item.npcId === companion.npcId);
+  if (existingIndex >= 0) {
+    next[existingIndex] = companion;
+    return next;
+  }
+
+  next.push(companion);
+  return next;
+}
+
+function removeCompanion(
+  list: RuntimeSession['companions'],
+  npcId: string,
+) {
+  return list.filter((item) => item.npcId !== npcId);
+}
+
+function normalizeRoster(
+  roster: RuntimeSession['roster'],
+  activeCompanions: RuntimeSession['companions'],
+) {
+  const activeIds = new Set(activeCompanions.map((companion) => companion.npcId));
+  return roster.filter((companion) => !activeIds.has(companion.npcId));
+}
+
+function recruitCompanionToParty(params: {
+  session: RuntimeSession;
+  companion: RuntimeSession['companions'][number];
+  releaseNpcId?: string | null;
+}) {
+  const nextRosterWithoutRecruit = removeCompanion(
+    params.session.roster,
+    params.companion.npcId,
+  );
+
+  if (
+    !params.releaseNpcId &&
+    params.session.companions.length < MAX_TASK5_COMPANIONS
+  ) {
+    return {
+      companions: [...params.session.companions, params.companion],
+      roster: nextRosterWithoutRecruit,
+      releasedCompanion: null,
+    };
+  }
+
+  if (!params.releaseNpcId) {
+    throw conflict('队伍已满时必须明确指定一名离队同伴');
+  }
+
+  const replaceIndex = params.session.companions.findIndex(
+    (item) => item.npcId === params.releaseNpcId,
+  );
+  if (replaceIndex < 0) {
+    throw conflict('指定的离队同伴不存在，无法完成换队招募');
+  }
+
+  const releasedCompanion = params.session.companions[replaceIndex];
+  if (!releasedCompanion) {
+    throw conflict('指定的离队同伴不存在，无法完成换队招募');
+  }
+
+  const nextCompanions = [...params.session.companions];
+  nextCompanions[replaceIndex] = params.companion;
+
+  return {
+    companions: nextCompanions,
+    roster: normalizeRoster(
+      upsertCompanion(nextRosterWithoutRecruit, releasedCompanion),
+      nextCompanions,
+    ),
+    releasedCompanion,
+  };
+}
+
 function buildBattleTarget(
   encounter: RuntimeEncounter,
   rawGameState: JsonRecord,
@@ -92,6 +248,7 @@ function buildBattleTarget(
 export function resolveNpcInteraction(
   session: RuntimeSession,
   functionId: string,
+  payload?: JsonRecord,
 ): NpcInteractionResolution {
   const encounter = requireNpcEncounter(session);
   const npcState = requireNpcState(session, encounter);
@@ -179,20 +336,29 @@ export function resolveNpcInteraction(
       if (npcState.affinity < 60) {
         throw conflict('当前关系还没达到招募阈值，暂时不能邀请入队');
       }
-      if (session.companions.length >= MAX_TASK5_COMPANIONS) {
-        throw conflict('队伍已满，任务5首轮后端接口暂不处理换队逻辑');
-      }
-
-      setEncounterNpcState(session, {
-        ...npcState,
+      const releaseNpcId = readString(payload?.releaseNpcId) || null;
+      const recruitedCompanion = buildRecruitedCompanion(
+        session,
+        encounter,
+        npcState,
+      );
+      const recruitmentResult = recruitCompanionToParty({
+        session,
+        companion: recruitedCompanion,
+        releaseNpcId,
+      });
+      const nextNpcState = {
+        ...markNpcFirstMeaningfulContactResolved(npcState),
         recruited: true,
-        firstMeaningfulContactResolved: true,
-      });
-      session.companions.push({
-        npcId: encounter.id,
-        characterId: encounter.characterId ?? '',
-        joinedAtAffinity: npcState.affinity,
-      });
+        stanceProfile: applyStoryChoiceToStanceProfile(
+          npcState.stanceProfile,
+          'npc_recruit',
+          { recruited: true },
+        ),
+      };
+      setEncounterNpcState(session, nextNpcState);
+      session.companions = recruitmentResult.companions;
+      session.roster = recruitmentResult.roster;
       session.currentEncounter = null;
       session.npcInteractionActive = false;
       session.currentNpcBattleMode = null;
@@ -202,7 +368,9 @@ export function resolveNpcInteraction(
 
       return {
         actionText: `邀请${encounter.npcName}加入队伍`,
-        resultText: `${encounter.npcName}接受了你的邀请，正式进入了同行队伍。`,
+        resultText: recruitmentResult.releasedCompanion
+          ? `${encounter.npcName}接受了你的邀请，你先让一名当前同行暂时离队，把位置腾给了新的同行者。`
+          : `${encounter.npcName}接受了你的邀请，正式进入了同行队伍。`,
         patches: [
           {
             type: 'status_changed',
diff --git a/server-node/src/modules/quest/questRuntimeSignalService.ts b/server-node/src/modules/quest/questRuntimeSignalService.ts
index 7fb86601..2ebec2c9 100644
--- a/server-node/src/modules/quest/questRuntimeSignalService.ts
+++ b/server-node/src/modules/quest/questRuntimeSignalService.ts
@@ -1,12 +1,12 @@
-import type { RuntimeBattlePresentation } from '../../../../packages/shared/src/contracts/story.js';
+import type { RuntimeBattlePresentation } from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
 import {
   applyQuestSignal,
   normalizeQuestEntries,
 } from './questProgressionService.js';
 import {
   replaceRuntimeSessionRawGameState,
-  type RuntimeSession,
-} from '../story/runtimeSession.js';
+} from '../rpg-runtime-story/RpgRuntimeSnapshotSync.js';
+import type { RuntimeSession } from '../rpg-runtime-story/RpgRuntimeSessionLoader.js';
 
 type JsonRecord = Record<string, unknown>;
 type RuntimeGameState = {
diff --git a/server-node/src/modules/quest/questStoryActionService.ts b/server-node/src/modules/quest/questStoryActionService.ts
index de2ce3ac..10098622 100644
--- a/server-node/src/modules/quest/questStoryActionService.ts
+++ b/server-node/src/modules/quest/questStoryActionService.ts
@@ -2,7 +2,7 @@ import type {
   RuntimeStoryOptionView,
   RuntimeStoryActionRequest,
   RuntimeStoryPatch,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
 import {
   buildExperienceGrantResultText,
   grantPlayerExperience,
@@ -26,8 +26,8 @@ import {
 } from './questTask6Bridge.js';
 import {
   replaceRuntimeSessionRawGameState,
-  type RuntimeSession,
-} from '../story/runtimeSession.js';
+} from '../rpg-runtime-story/RpgRuntimeSnapshotSync.js';
+import type { RuntimeSession } from '../rpg-runtime-story/RpgRuntimeSessionLoader.js';
 
 const SUPPORTED_QUEST_STORY_FUNCTION_IDS = new Set<string>([
   'npc_chat_quest_offer_abandon',
diff --git a/server-node/src/modules/quest/runtimeQuestModule.ts b/server-node/src/modules/quest/runtimeQuestModule.ts
index 66a97e2f..2d38377b 100644
--- a/server-node/src/modules/quest/runtimeQuestModule.ts
+++ b/server-node/src/modules/quest/runtimeQuestModule.ts
@@ -4,7 +4,7 @@ import {
   QUEST_OBJECTIVE_KINDS,
   QUEST_REWARD_THEMES,
   QUEST_URGENCY_LEVELS,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeQuestAssist.js';
 import {
   buildQuestIntentPrompt,
   QUEST_INTENT_SYSTEM_PROMPT,
diff --git a/server-node/src/modules/rpg-runtime-story/RpgRuntimeOptionCompiler.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeOptionCompiler.ts
new file mode 100644
index 00000000..a327b94c
--- /dev/null
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeOptionCompiler.ts
@@ -0,0 +1,14 @@
+import {
+  buildAvailableOptions,
+  buildLegacyCurrentStory,
+  buildRuntimeViewModel,
+} from './RpgRuntimeSessionDomain.js';
+
+/**
+ * RPG runtime option / view model 编译入口。
+ * 工作包 G 后所有可见 option 与 view model 都从新域目录输出。
+ */
+export { buildAvailableOptions, buildRuntimeViewModel };
+export const buildRpgRuntimeAvailableOptions = buildAvailableOptions;
+export const buildRpgRuntimeViewModel = buildRuntimeViewModel;
+export const buildRpgRuntimeLegacyCurrentStory = buildLegacyCurrentStory;
diff --git a/server-node/src/modules/story/runtimeSession.test.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionDomain.test.ts
similarity index 94%
rename from server-node/src/modules/story/runtimeSession.test.ts
rename to server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionDomain.test.ts
index 8ca7b522..87cba5c2 100644
--- a/server-node/src/modules/story/runtimeSession.test.ts
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionDomain.test.ts
@@ -3,9 +3,13 @@ import test from 'node:test';
 
 import {
   buildAvailableOptions,
+} from './RpgRuntimeOptionCompiler.js';
+import {
   buildLegacyCurrentStory,
+} from './RpgRuntimeStoryPresentationCompiler.js';
+import {
   loadRuntimeSession,
-} from './runtimeSession.ts';
+} from './RpgRuntimeSessionLoader.js';
 
 function createNpcSnapshot() {
   return {
diff --git a/server-node/src/modules/story/runtimeSession.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionDomain.ts
similarity index 93%
rename from server-node/src/modules/story/runtimeSession.ts
rename to server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionDomain.ts
index 7e38ce43..2e20ea51 100644
--- a/server-node/src/modules/story/runtimeSession.ts
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionDomain.ts
@@ -1,3 +1,7 @@
+/**
+ * RPG runtime session 编译主实现。
+ * 工作包 G 把旧 `runtimeSession.ts` 的真实逻辑迁到这里，旧文件后续只保留兼容职责。
+ */
 import type {
   RuntimeStoryChoicePayload,
   RuntimeStoryEncounterViewModel,
@@ -5,9 +9,9 @@ import type {
   RuntimeStoryOptionView,
   RuntimeStoryViewModel,
   Task5RuntimeOptionScope,
-} from '../../../../packages/shared/src/contracts/story.js';
-import { TASK6_RUNTIME_FUNCTION_IDS } from '../../../../packages/shared/src/contracts/story.js';
-import type { SavedSnapshot } from '../../repositories/runtimeRepository.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
+import { TASK6_RUNTIME_FUNCTION_IDS } from '../../../../packages/shared/src/contracts/rpgRuntimeStoryAction.js';
+import type { RpgRuntimeSavedSnapshot } from '../../repositories/rpg-runtime/RpgRuntimeSnapshotRepository.js';
 import {
   normalizeRuntimeEntityLevelProfile,
   type RuntimeEntityLevelProfile,
@@ -75,6 +79,16 @@ export type RuntimeCompanion = {
   npcId: string;
   characterId: string;
   joinedAtAffinity: number;
+  hp: number;
+  maxHp: number;
+  mana: number;
+  maxMana: number;
+  skillCooldowns: Record<string, number>;
+  animationState?: string;
+  actionMode?: string;
+  offsetX?: number;
+  offsetY?: number;
+  transitionMs?: number;
 };
 
 type RuntimePlayerAttributes = {
@@ -146,6 +160,7 @@ export type RuntimeSession = {
   playerMaxMana: number;
   npcStates: Record<string, RuntimeNpcState>;
   companions: RuntimeCompanion[];
+  roster: RuntimeCompanion[];
   currentNpcBattleMode: 'fight' | 'spar' | null;
   currentNpcBattleOutcome: 'fight_victory' | 'spar_complete' | null;
 };
@@ -511,6 +526,53 @@ function normalizeCompanion(value: unknown): RuntimeCompanion | null {
     npcId,
     characterId: readString(rawCompanion.characterId),
     joinedAtAffinity: Math.round(readNumber(rawCompanion.joinedAtAffinity, 0)),
+    hp: Math.max(
+      0,
+      Math.round(
+        readNumber(
+          rawCompanion.hp,
+          readNumber(rawCompanion.maxHp, 1),
+        ),
+      ),
+    ),
+    maxHp: Math.max(1, Math.round(readNumber(rawCompanion.maxHp, 1))),
+    mana: Math.max(
+      0,
+      Math.round(
+        readNumber(
+          rawCompanion.mana,
+          readNumber(rawCompanion.maxMana, 1),
+        ),
+      ),
+    ),
+    maxMana: Math.max(1, Math.round(readNumber(rawCompanion.maxMana, 1))),
+    skillCooldowns: Object.fromEntries(
+      Object.entries(
+        isObject(rawCompanion.skillCooldowns)
+          ? rawCompanion.skillCooldowns
+          : {},
+      ).map(([skillId, turns]) => [
+        skillId,
+        Math.max(0, Math.round(readNumber(turns, 0))),
+      ]),
+    ),
+    animationState: readString(rawCompanion.animationState) || undefined,
+    actionMode: readString(rawCompanion.actionMode) || undefined,
+    offsetX:
+      typeof rawCompanion.offsetX === 'number' &&
+      Number.isFinite(rawCompanion.offsetX)
+        ? rawCompanion.offsetX
+        : undefined,
+    offsetY:
+      typeof rawCompanion.offsetY === 'number' &&
+      Number.isFinite(rawCompanion.offsetY)
+        ? rawCompanion.offsetY
+        : undefined,
+    transitionMs:
+      typeof rawCompanion.transitionMs === 'number' &&
+      Number.isFinite(rawCompanion.transitionMs)
+        ? Math.max(0, Math.round(rawCompanion.transitionMs))
+        : undefined,
   };
 }
 
@@ -531,6 +593,15 @@ function normalizeCompanions(value: unknown) {
     .filter((entry): entry is RuntimeCompanion => Boolean(entry));
 }
 
+function normalizeRoster(
+  roster: RuntimeCompanion[],
+  companions: RuntimeCompanion[],
+) {
+  const activeNpcIds = new Set(companions.map((companion) => companion.npcId));
+
+  return roster.filter((companion) => !activeNpcIds.has(companion.npcId));
+}
+
 function normalizeHostileNpcs(value: unknown) {
   return readArray(value)
     .map((entry) => normalizeHostileNpc(entry))
@@ -944,7 +1015,7 @@ export function getEncounterKey(encounter: RuntimeEncounter) {
 }
 
 export function loadRuntimeSession(
-  snapshot: SavedSnapshot,
+  snapshot: RpgRuntimeSavedSnapshot,
   requestedSessionId: string,
 ): RuntimeSession {
   const rawGameState = isObject(snapshot.gameState)
@@ -982,6 +1053,10 @@ export function loadRuntimeSession(
     ),
     npcStates: normalizeNpcStates(rawGameState.npcStates),
     companions: normalizeCompanions(rawGameState.companions),
+    roster: normalizeRoster(
+      normalizeCompanions(rawGameState.roster),
+      normalizeCompanions(rawGameState.companions),
+    ),
     currentNpcBattleMode:
       rawGameState.currentNpcBattleMode === 'fight' ||
       rawGameState.currentNpcBattleMode === 'spar'
@@ -1185,16 +1260,7 @@ export function buildAvailableOptions(session: RuntimeSession) {
 
     if (npcState && !npcState.recruited && npcState.affinity >= 60) {
       options.push(
-        buildOptionView(
-          session,
-          'npc_recruit',
-          session.companions.length >= MAX_TASK5_COMPANIONS
-            ? {
-                disabled: true,
-                reason: '队伍已满，任务5首轮后端接口暂不处理换队逻辑。',
-              }
-            : {},
-        ),
+        buildOptionView(session, 'npc_recruit'),
       );
     }
 
@@ -1328,6 +1394,7 @@ export function syncRawGameState(session: RuntimeSession) {
   session.rawGameState.playerMaxMana = session.playerMaxMana;
   session.rawGameState.npcStates = cloneJson(session.npcStates);
   session.rawGameState.companions = cloneJson(session.companions);
+  session.rawGameState.roster = cloneJson(session.roster);
   session.rawGameState.currentNpcBattleMode = session.currentNpcBattleMode;
   session.rawGameState.currentNpcBattleOutcome =
     session.currentNpcBattleOutcome;
@@ -1367,6 +1434,7 @@ export function replaceRuntimeSessionRawGameState(
   session.playerMaxMana = refreshed.playerMaxMana;
   session.npcStates = refreshed.npcStates;
   session.companions = refreshed.companions;
+  session.roster = refreshed.roster;
   session.currentNpcBattleMode = refreshed.currentNpcBattleMode;
   session.currentNpcBattleOutcome = refreshed.currentNpcBattleOutcome;
 }
diff --git a/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionLoader.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionLoader.ts
new file mode 100644
index 00000000..581774b6
--- /dev/null
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionLoader.ts
@@ -0,0 +1,13 @@
+import {
+  loadRuntimeSession,
+  type RuntimeSession,
+} from './RpgRuntimeSessionDomain.js';
+
+export type { RuntimeSession };
+
+/**
+ * RPG runtime session loader 的主入口。
+ * 工作包 G 把旧 `runtimeSession.ts` 的真实实现迁入新域后，这里负责承接稳定命名。
+ */
+export { loadRuntimeSession };
+export const loadRpgRuntimeSession = loadRuntimeSession;
diff --git a/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionPrimitives.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionPrimitives.ts
new file mode 100644
index 00000000..2fccbcc9
--- /dev/null
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSessionPrimitives.ts
@@ -0,0 +1,29 @@
+/**
+ * RPG runtime session 原子能力导出。
+ * 这里集中输出运行时动作链直接依赖的 session 原语，避免再次回到旧热点文件取用。
+ */
+export {
+  appendStoryHistory,
+  getEncounterKey,
+  getEncounterNpcState,
+  getPlayerCharacter,
+  getPlayerSkillCooldowns,
+  isCombatFunctionId,
+  isNpcFunctionId,
+  isStoryFunctionId,
+  isTask5FunctionId,
+  isTask6RuntimeFunctionId,
+  MAX_TASK5_COMPANIONS,
+  setEncounterNpcState,
+  syncRawGameState,
+  TASK6_DEFERRED_FUNCTION_IDS,
+} from './RpgRuntimeSessionDomain.js';
+
+export type {
+  RuntimeCompanion,
+  RuntimeEncounter,
+  RuntimeHostileNpc,
+  RuntimeNpcState,
+  RuntimeSession,
+  RuntimeStoryHistoryEntry,
+} from './RpgRuntimeSessionDomain.js';
diff --git a/server-node/src/modules/rpg-runtime-story/RpgRuntimeSnapshotSync.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSnapshotSync.ts
new file mode 100644
index 00000000..282dae39
--- /dev/null
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeSnapshotSync.ts
@@ -0,0 +1,13 @@
+import {
+  replaceRuntimeSessionRawGameState,
+  syncRawGameState,
+} from './RpgRuntimeSessionDomain.js';
+
+/**
+ * RPG runtime snapshot 同步入口。
+ * 工作包 G 后 rawGameState 的回写与替换都统一从新域目录输出。
+ */
+export { replaceRuntimeSessionRawGameState, syncRawGameState };
+export const syncRpgRuntimeSnapshot = syncRawGameState;
+export const replaceRpgRuntimeSessionRawGameState =
+  replaceRuntimeSessionRawGameState;
diff --git a/server-node/src/modules/story/storyActionService.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionDomain.ts
similarity index 96%
rename from server-node/src/modules/story/storyActionService.ts
rename to server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionDomain.ts
index 86203ef3..b83dbb89 100644
--- a/server-node/src/modules/story/storyActionService.ts
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionDomain.ts
@@ -1,3 +1,7 @@
+/**
+ * RPG runtime story 主链迁移后的真实动作/状态实现。
+ * 工作包 G 完成后，运行时动作解析直接落在 RPG runtime story 新域。
+ */
 import type {
   RuntimeBattlePresentation,
   RuntimeStoryActionRequest,
@@ -5,9 +9,9 @@ import type {
   RuntimeStoryOptionView,
   RuntimeStoryPatch,
   RuntimeStoryStateRequest,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
 import { conflict, invalidRequest } from '../../errors.js';
-import type { RuntimeRepositoryPort } from '../../repositories/runtimeRepository.js';
+import type { RpgRuntimeSnapshotRepositoryPort } from '../../repositories/rpg-runtime/RpgRuntimeSnapshotRepository.js';
 import type { UpstreamLlmClient } from '../../services/llmClient.js';
 import {
   buildStrictNpcChatDialoguePrompt,
@@ -39,21 +43,27 @@ import {
   resolveTreasureStoryAction,
 } from '../runtime-item/treasureStoryActionService.js';
 import {
-  appendStoryHistory,
   buildAvailableOptions,
-  buildLegacyCurrentStory,
   buildRuntimeViewModel,
+} from './RpgRuntimeOptionCompiler.js';
+import {
+  appendStoryHistory,
   getEncounterNpcState,
   isCombatFunctionId,
   isNpcFunctionId,
   isStoryFunctionId,
   isTask5FunctionId,
-  loadRuntimeSession,
-  type RuntimeSession,
   setEncounterNpcState,
   syncRawGameState,
   TASK6_DEFERRED_FUNCTION_IDS,
-} from './runtimeSession.js';
+} from './RpgRuntimeSessionPrimitives.js';
+import {
+  buildLegacyCurrentStory,
+} from './RpgRuntimeStoryPresentationCompiler.js';
+import {
+  loadRuntimeSession,
+  type RuntimeSession,
+} from './RpgRuntimeSessionLoader.js';
 
 type StoryResolution = {
   actionText: string;
@@ -630,18 +640,23 @@ function normalizeIncomingSnapshot(snapshot: unknown) {
 }
 
 async function resolveSnapshotForRequest(params: {
-  runtimeRepository: RuntimeRepositoryPort;
+  snapshotRepository: RpgRuntimeSnapshotRepositoryPort;
   userId: string;
   snapshot?: unknown;
 }) {
   const incomingSnapshot = normalizeIncomingSnapshot(params.snapshot);
   if (incomingSnapshot) {
     return hydrateSavedSnapshot(
-      await params.runtimeRepository.putSnapshot(params.userId, incomingSnapshot),
+      await params.snapshotRepository.putSnapshot(
+        params.userId,
+        incomingSnapshot,
+      ),
     )!;
   }
 
-  const persistedSnapshot = await params.runtimeRepository.getSnapshot(params.userId);
+  const persistedSnapshot = await params.snapshotRepository.getSnapshot(
+    params.userId,
+  );
   if (!persistedSnapshot) {
     throw conflict('运行时快照不存在，请先初始化并保存一次游戏');
   }
@@ -900,13 +915,13 @@ function resolveStoryFlowAction(
 }
 
 export async function resolveRuntimeStoryAction(params: {
-  runtimeRepository: RuntimeRepositoryPort;
+  snapshotRepository: RpgRuntimeSnapshotRepositoryPort;
   llmClient?: UpstreamLlmClient;
   userId: string;
   request: RuntimeStoryActionRequest;
 }) {
   const hydratedSnapshot = await resolveSnapshotForRequest({
-    runtimeRepository: params.runtimeRepository,
+    snapshotRepository: params.snapshotRepository,
     userId: params.userId,
     snapshot: params.request.snapshot,
   });
@@ -969,7 +984,13 @@ export async function resolveRuntimeStoryAction(params: {
         : undefined,
     });
   } else if (isNpcFunctionId(functionId)) {
-    resolution = resolveNpcInteraction(session, functionId);
+    resolution = resolveNpcInteraction(
+      session,
+      functionId,
+      isObject(params.request.action.payload)
+        ? params.request.action.payload
+        : undefined,
+    );
   } else if (isSupportedInventoryStoryFunctionId(functionId)) {
     resolution = resolveInventoryStoryAction(session, params.request);
   } else if (isSupportedNpcInventoryStoryFunctionId(functionId)) {
@@ -1074,7 +1095,7 @@ export async function resolveRuntimeStoryAction(params: {
   appendStoryHistory(session, actionText, historyResultText);
   syncRawGameState(session);
 
-  const persistedSnapshot = await params.runtimeRepository.putSnapshot(
+  const persistedSnapshot = await params.snapshotRepository.putSnapshot(
     params.userId,
     normalizeSavedSnapshotPayload({
       savedAt: new Date().toISOString(),
@@ -1109,14 +1130,14 @@ export async function resolveRuntimeStoryAction(params: {
 }
 
 export async function getRuntimeStoryState(params: {
-  runtimeRepository: RuntimeRepositoryPort;
+  snapshotRepository: RpgRuntimeSnapshotRepositoryPort;
   userId: string;
   sessionId: string;
   clientVersion?: number;
   snapshot?: RuntimeStoryStateRequest['snapshot'];
 }) {
   const hydratedSnapshot = await resolveSnapshotForRequest({
-    runtimeRepository: params.runtimeRepository,
+    snapshotRepository: params.snapshotRepository,
     userId: params.userId,
     snapshot: params.snapshot,
   });
diff --git a/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionService.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionService.ts
new file mode 100644
index 00000000..475dee89
--- /dev/null
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionService.ts
@@ -0,0 +1,10 @@
+import {
+  resolveRuntimeStoryAction,
+} from './RpgRuntimeStoryActionDomain.js';
+
+/**
+ * RPG runtime story 动作服务入口。
+ * 工作包 G 后 runtime action 主链直接落到新域实现，不再继续桥接旧热点文件。
+ */
+export { resolveRuntimeStoryAction };
+export const resolveRpgRuntimeStoryAction = resolveRuntimeStoryAction;
diff --git a/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryPresentationCompiler.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryPresentationCompiler.ts
new file mode 100644
index 00000000..fd661f97
--- /dev/null
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryPresentationCompiler.ts
@@ -0,0 +1,8 @@
+import { buildLegacyCurrentStory } from './RpgRuntimeSessionDomain.js';
+
+/**
+ * RPG runtime story 展示兼容编译器。
+ * 当前仍复用 legacy currentStory 投影规则，但真实落点已经切到新域目录。
+ */
+export { buildLegacyCurrentStory };
+export const buildRpgRuntimeLegacyCurrentStory = buildLegacyCurrentStory;
diff --git a/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryStateService.ts b/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryStateService.ts
new file mode 100644
index 00000000..71a1f8c0
--- /dev/null
+++ b/server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryStateService.ts
@@ -0,0 +1,8 @@
+import { getRuntimeStoryState } from './RpgRuntimeStoryActionDomain.js';
+
+/**
+ * RPG runtime story 状态读取入口。
+ * 工作包 G 先把状态读取从旧热点文件迁到新域命名，再保持动作与状态的物理落点分离。
+ */
+export { getRuntimeStoryState };
+export const getRpgRuntimeStoryState = getRuntimeStoryState;
diff --git a/server-node/src/modules/rpg-runtime-story/index.ts b/server-node/src/modules/rpg-runtime-story/index.ts
new file mode 100644
index 00000000..9497cded
--- /dev/null
+++ b/server-node/src/modules/rpg-runtime-story/index.ts
@@ -0,0 +1,35 @@
+export {
+  buildRpgRuntimeAvailableOptions,
+  buildRpgRuntimeLegacyCurrentStory,
+  buildRpgRuntimeViewModel,
+} from './RpgRuntimeOptionCompiler.js';
+export {
+  appendStoryHistory,
+  getEncounterKey,
+  getEncounterNpcState,
+  getPlayerCharacter,
+  getPlayerSkillCooldowns,
+  isCombatFunctionId,
+  isNpcFunctionId,
+  isStoryFunctionId,
+  isTask5FunctionId,
+  isTask6RuntimeFunctionId,
+  MAX_TASK5_COMPANIONS,
+  setEncounterNpcState,
+  TASK6_DEFERRED_FUNCTION_IDS,
+  type RuntimeEncounter,
+  type RuntimeNpcState,
+  type RuntimeSession as RuntimeSessionPrimitives,
+} from './RpgRuntimeSessionPrimitives.js';
+export {
+  loadRpgRuntimeSession,
+  type RuntimeSession,
+} from './RpgRuntimeSessionLoader.js';
+export {
+  replaceRpgRuntimeSessionRawGameState,
+  syncRpgRuntimeSnapshot,
+} from './RpgRuntimeSnapshotSync.js';
+export {
+  resolveRpgRuntimeStoryAction,
+} from './RpgRuntimeStoryActionService.js';
+export { getRpgRuntimeStoryState } from './RpgRuntimeStoryStateService.js';
diff --git a/server-node/src/modules/runtime-item/runtimeItemModule.ts b/server-node/src/modules/runtime-item/runtimeItemModule.ts
index b03938c5..f3d223a3 100644
--- a/server-node/src/modules/runtime-item/runtimeItemModule.ts
+++ b/server-node/src/modules/runtime-item/runtimeItemModule.ts
@@ -1,7 +1,7 @@
 import {
   RUNTIME_ITEM_FUNCTIONAL_BIAS_VALUES,
   RUNTIME_ITEM_TONE_VALUES,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeQuestAssist.js';
 import {
   buildRuntimeItemIntentPromptText,
   RUNTIME_ITEM_INTENT_SYSTEM_PROMPT,
diff --git a/server-node/src/modules/runtime-item/treasureStoryActionService.ts b/server-node/src/modules/runtime-item/treasureStoryActionService.ts
index 82b797ca..4160fcef 100644
--- a/server-node/src/modules/runtime-item/treasureStoryActionService.ts
+++ b/server-node/src/modules/runtime-item/treasureStoryActionService.ts
@@ -1,7 +1,7 @@
 import type {
   RuntimeStoryActionRequest,
   RuntimeStoryPatch,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
 import { conflict, invalidRequest } from '../../errors.js';
 import {
   addInventoryItems,
@@ -14,8 +14,8 @@ import {
 import { buildBuildToast } from '../inventory/inventoryStoryActionService.js';
 import {
   replaceRuntimeSessionRawGameState,
-  type RuntimeSession,
-} from '../story/runtimeSession.js';
+} from '../rpg-runtime-story/RpgRuntimeSnapshotSync.js';
+import type { RuntimeSession } from '../rpg-runtime-story/RpgRuntimeSessionLoader.js';
 
 const SUPPORTED_TREASURE_STORY_FUNCTION_IDS = new Set<string>([
   'treasure_inspect',
diff --git a/server-node/src/observability.test.ts b/server-node/src/observability.test.ts
index 3741ecff..19dd2c80 100644
--- a/server-node/src/observability.test.ts
+++ b/server-node/src/observability.test.ts
@@ -251,7 +251,7 @@ test('unauthorized request keeps request trace in error log and response header'
 
       assert.equal(response.status, 401);
       assert.equal(response.headers.get('x-request-id'), requestId);
-      assert.equal(payload.error.message, '缺少 Authorization Bearer Token');
+      assert.equal(payload.error.message, '缺少登录凭证');
 
       const errorLog = await waitForRecord(
         records,
@@ -262,7 +262,7 @@ test('unauthorized request keeps request trace in error log and response header'
       assert.equal(errorLog.user_id, null);
       assert.equal(
         (errorLog.err as { message?: string } | undefined)?.message,
-        '缺少 Authorization Bearer Token',
+        '缺少登录凭证',
       );
       assert.equal(errorLog.api_version, '2026-04-08');
       assert.equal(errorLog.route_version, '2026-04-08');
diff --git a/server-node/src/prompts/chatPromptBuilders.ts b/server-node/src/prompts/chatPromptBuilders.ts
index 6d80b488..3dab3f01 100644
--- a/server-node/src/prompts/chatPromptBuilders.ts
+++ b/server-node/src/prompts/chatPromptBuilders.ts
@@ -5,7 +5,7 @@ import type {
   NpcChatDialogueRequest,
   NpcChatTurnRequest,
   NpcRecruitDialogueRequest,
-} from '../../../packages/shared/src/contracts/story.js';
+} from '../../../packages/shared/src/contracts/rpgRuntimeChat.js';
 
 type JsonRecord = Record<string, unknown>;
 
diff --git a/server-node/src/repositories/RpgAgentSessionRepository.ts b/server-node/src/repositories/RpgAgentSessionRepository.ts
new file mode 100644
index 00000000..b75f66b6
--- /dev/null
+++ b/server-node/src/repositories/RpgAgentSessionRepository.ts
@@ -0,0 +1,100 @@
+import type { CustomWorldSessionRecord } from '../../../packages/shared/src/contracts/runtime.js';
+import type { AppDatabase } from '../db.js';
+import {
+  type RpgAgentSessionRow,
+} from './rpgWorldRepositoryShared.js';
+
+/**
+ * RPG Agent session 仓储最小读写接口。
+ * 工作包 F 后续所有 session store / test stub 都应优先依赖这个领域端口。
+ */
+export type RpgAgentSessionRepositoryPort = {
+  listSessions(userId: string): Promise<CustomWorldSessionRecord[]>;
+  getSession(
+    userId: string,
+    sessionId: string,
+  ): Promise<CustomWorldSessionRecord | null>;
+  upsertSession(
+    userId: string,
+    sessionId: string,
+    session: CustomWorldSessionRecord,
+  ): Promise<CustomWorldSessionRecord>;
+};
+
+/**
+ * RPG Agent session 仓储只负责 session 表读写，不再承担兼容补齐与快照派生。
+ */
+export class RpgAgentSessionRepository implements RpgAgentSessionRepositoryPort {
+  constructor(private readonly db: AppDatabase) {}
+
+  async listSessions(userId: string) {
+    const result = await this.db.query<RpgAgentSessionRow>(
+      `SELECT payload_json AS payload,
+              created_at AS "createdAt",
+              updated_at AS "updatedAt"
+       FROM custom_world_sessions
+       WHERE user_id = $1
+       ORDER BY updated_at DESC`,
+      [userId],
+    );
+
+    return result.rows.map((row) => ({
+      ...row.payload,
+      createdAt: row.createdAt,
+      updatedAt: row.updatedAt,
+    }));
+  }
+
+  async getSession(userId: string, sessionId: string) {
+    const result = await this.db.query<RpgAgentSessionRow>(
+      `SELECT payload_json AS payload,
+              created_at AS "createdAt",
+              updated_at AS "updatedAt"
+       FROM custom_world_sessions
+       WHERE user_id = $1 AND session_id = $2`,
+      [userId, sessionId],
+    );
+    const row = result.rows[0];
+
+    if (!row) {
+      return null;
+    }
+
+    return {
+      ...row.payload,
+      createdAt: row.createdAt,
+      updatedAt: row.updatedAt,
+    };
+  }
+
+  async upsertSession(
+    userId: string,
+    sessionId: string,
+    session: CustomWorldSessionRecord,
+  ) {
+    const payload = {
+      ...session,
+      sessionId,
+    } satisfies CustomWorldSessionRecord;
+
+    await this.db.query(
+      `INSERT INTO custom_world_sessions (
+         user_id,
+         session_id,
+         payload_json,
+         created_at,
+         updated_at
+       ) VALUES ($1, $2, $3, $4, $5)
+       ON CONFLICT (user_id, session_id) DO UPDATE SET
+         payload_json = EXCLUDED.payload_json,
+         updated_at = EXCLUDED.updated_at`,
+      [userId, sessionId, payload, session.createdAt, session.updatedAt],
+    );
+
+    return {
+      ...payload,
+      createdAt: session.createdAt,
+      updatedAt: session.updatedAt,
+    };
+  }
+}
diff --git a/server-node/src/repositories/RpgWorldProfileRepository.ts b/server-node/src/repositories/RpgWorldProfileRepository.ts
new file mode 100644
index 00000000..5fa2588d
--- /dev/null
+++ b/server-node/src/repositories/RpgWorldProfileRepository.ts
@@ -0,0 +1,433 @@
+import type {
+  CustomWorldGalleryCard,
+  CustomWorldLibraryEntry,
+  CustomWorldProfileRecord,
+} from '../../../packages/shared/src/contracts/runtime.js';
+import { extractCustomWorldLibraryMetadata } from './customWorldLibraryMetadata.js';
+import type { AppDatabase } from '../db.js';
+import {
+  MAX_RPG_WORLD_GALLERY_ENTRIES,
+  MAX_RPG_WORLD_PROFILE_ENTRIES,
+  normalizeStoredRpgWorldProfile,
+  toRpgWorldGalleryCard,
+  toRpgWorldLibraryEntry,
+  type RpgWorldGalleryRow,
+  type RpgWorldProfileRow,
+} from './rpgWorldRepositoryShared.js';
+
+/**
+ * RPG 世界 profile 领域端口。
+ * works、library、gallery、脚本同步等链路后续统一依赖这个接口，而不是 RuntimeRepositoryPort。
+ */
+export type RpgWorldProfileRepositoryPort = {
+  listOwnProfiles(
+    userId: string,
+  ): Promise<CustomWorldLibraryEntry<CustomWorldProfileRecord>[]>;
+  upsertOwnProfile(
+    userId: string,
+    profileId: string,
+    profile: Record<string, unknown>,
+    authorDisplayName: string,
+  ): Promise<{
+    entry: CustomWorldLibraryEntry<CustomWorldProfileRecord>;
+    entries: CustomWorldLibraryEntry<CustomWorldProfileRecord>[];
+  }>;
+  syncProfileFromSnapshot(
+    userId: string,
+    profileId: string,
+    profile: Record<string, unknown>,
+    syncedAt: string,
+  ): Promise<void>;
+  softDeleteOwnProfile(
+    userId: string,
+    profileId: string,
+  ): Promise<CustomWorldLibraryEntry<CustomWorldProfileRecord>[]>;
+  publishOwnProfile(
+    userId: string,
+    profileId: string,
+    authorDisplayName: string,
+  ): Promise<{
+    entry: CustomWorldLibraryEntry<CustomWorldProfileRecord>;
+    entries: CustomWorldLibraryEntry<CustomWorldProfileRecord>[];
+  } | null>;
+  unpublishOwnProfile(
+    userId: string,
+    profileId: string,
+    authorDisplayName: string,
+  ): Promise<{
+    entry: CustomWorldLibraryEntry<CustomWorldProfileRecord>;
+    entries: CustomWorldLibraryEntry<CustomWorldProfileRecord>[];
+  } | null>;
+  listPublishedGallery(): Promise<CustomWorldGalleryCard[]>;
+  getPublishedGalleryDetail(
+    ownerUserId: string,
+    profileId: string,
+  ): Promise<CustomWorldLibraryEntry<CustomWorldProfileRecord> | null>;
+};
+
+/**
+ * RPG 世界 profile 仓储统一负责作品库、发布态与画廊读写。
+ */
+export class RpgWorldProfileRepository implements RpgWorldProfileRepositoryPort {
+  constructor(private readonly db: AppDatabase) {}
+
+  private async findOwnProfileEntry(userId: string, profileId: string) {
+    const result = await this.db.query<RpgWorldProfileRow>(
+      `SELECT user_id AS "ownerUserId",
+              profile_id AS "profileId",
+              payload_json AS payload,
+              visibility,
+              published_at AS "publishedAt",
+              updated_at AS "updatedAt",
+              author_display_name AS "authorDisplayName",
+              world_name AS "worldName",
+              subtitle,
+              summary_text AS "summaryText",
+              cover_image_src AS "coverImageSrc",
+              theme_mode AS "themeMode",
+              playable_npc_count AS "playableNpcCount",
+              landmark_count AS "landmarkCount"
+       FROM custom_world_profiles
+       WHERE user_id = $1
+         AND profile_id = $2
+         AND deleted_at IS NULL`,
+      [userId, profileId],
+    );
+
+    const row = result.rows[0];
+    return row ? toRpgWorldLibraryEntry(row) : null;
+  }
+
+  async listOwnProfiles(userId: string) {
+    const result = await this.db.query<RpgWorldProfileRow>(
+      `SELECT user_id AS "ownerUserId",
+              profile_id AS "profileId",
+              payload_json AS payload,
+              visibility,
+              published_at AS "publishedAt",
+              updated_at AS "updatedAt",
+              author_display_name AS "authorDisplayName",
+              world_name AS "worldName",
+              subtitle,
+              summary_text AS "summaryText",
+              cover_image_src AS "coverImageSrc",
+              theme_mode AS "themeMode",
+              playable_npc_count AS "playableNpcCount",
+              landmark_count AS "landmarkCount"
+       FROM custom_world_profiles
+       WHERE user_id = $1
+         AND deleted_at IS NULL
+       ORDER BY updated_at DESC
+       LIMIT $2`,
+      [userId, MAX_RPG_WORLD_PROFILE_ENTRIES],
+    );
+
+    return result.rows.map((row) => toRpgWorldLibraryEntry(row));
+  }
+
+  async upsertOwnProfile(
+    userId: string,
+    profileId: string,
+    profile: Record<string, unknown>,
+    authorDisplayName: string,
+  ) {
+    const payload = normalizeStoredRpgWorldProfile(profileId, profile);
+    const metadata = extractCustomWorldLibraryMetadata(payload);
+    const now = new Date().toISOString();
+
+    await this.db.query(
+      `INSERT INTO custom_world_profiles (
+         user_id,
+         profile_id,
+         payload_json,
+         updated_at,
+         author_display_name,
+         world_name,
+         subtitle,
+         summary_text,
+         cover_image_src,
+         theme_mode,
+         playable_npc_count,
+         landmark_count
+       )
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)
+       ON CONFLICT (user_id, profile_id) DO UPDATE SET
+         payload_json = EXCLUDED.payload_json,
+         updated_at = EXCLUDED.updated_at,
+         deleted_at = NULL,
+         author_display_name = EXCLUDED.author_display_name,
+         world_name = EXCLUDED.world_name,
+         subtitle = EXCLUDED.subtitle,
+         summary_text = EXCLUDED.summary_text,
+         cover_image_src = EXCLUDED.cover_image_src,
+         theme_mode = EXCLUDED.theme_mode,
+         playable_npc_count = EXCLUDED.playable_npc_count,
+         landmark_count = EXCLUDED.landmark_count`,
+      [
+        userId,
+        profileId,
+        payload,
+        now,
+        authorDisplayName || '玩家',
+        metadata.worldName,
+        metadata.subtitle,
+        metadata.summaryText,
+        metadata.coverImageSrc,
+        metadata.themeMode,
+        metadata.playableNpcCount,
+        metadata.landmarkCount,
+      ],
+    );
+
+    const entry = await this.findOwnProfileEntry(userId, profileId);
+    if (!entry) {
+      throw new Error('failed to resolve custom world after upsert');
+    }
+
+    return {
+      entry,
+      entries: await this.listOwnProfiles(userId),
+    };
+  }
+
+  async syncProfileFromSnapshot(
+    userId: string,
+    profileId: string,
+    profile: Record<string, unknown>,
+    syncedAt: string,
+  ) {
+    const payload = normalizeStoredRpgWorldProfile(profileId, profile);
+    const metadata = extractCustomWorldLibraryMetadata(payload);
+
+    await this.db.query(
+      `INSERT INTO custom_world_profiles (
+         user_id,
+         profile_id,
+         payload_json,
+         updated_at,
+         author_display_name,
+         world_name,
+         subtitle,
+         summary_text,
+         cover_image_src,
+         theme_mode,
+         playable_npc_count,
+         landmark_count,
+         deleted_at
+       )
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, NULL)
+       ON CONFLICT (user_id, profile_id) DO UPDATE SET
+         payload_json = EXCLUDED.payload_json,
+         updated_at = EXCLUDED.updated_at,
+         deleted_at = NULL,
+         world_name = EXCLUDED.world_name,
+         subtitle = EXCLUDED.subtitle,
+         summary_text = EXCLUDED.summary_text,
+         cover_image_src = EXCLUDED.cover_image_src,
+         theme_mode = EXCLUDED.theme_mode,
+         playable_npc_count = EXCLUDED.playable_npc_count,
+         landmark_count = EXCLUDED.landmark_count`,
+      [
+        userId,
+        profileId,
+        payload,
+        syncedAt,
+        '玩家',
+        metadata.worldName,
+        metadata.subtitle,
+        metadata.summaryText,
+        metadata.coverImageSrc,
+        metadata.themeMode,
+        metadata.playableNpcCount,
+        metadata.landmarkCount,
+      ],
+    );
+  }
+
+  async softDeleteOwnProfile(userId: string, profileId: string) {
+    const deletedAt = new Date().toISOString();
+    await this.db.query(
+      `UPDATE custom_world_profiles
+       SET deleted_at = $1,
+           updated_at = $1,
+           visibility = 'draft',
+           published_at = NULL
+       WHERE user_id = $2
+         AND profile_id = $3
+         AND deleted_at IS NULL`,
+      [deletedAt, userId, profileId],
+    );
+
+    return this.listOwnProfiles(userId);
+  }
+
+  async publishOwnProfile(
+    userId: string,
+    profileId: string,
+    authorDisplayName: string,
+  ) {
+    const existingEntry = await this.findOwnProfileEntry(userId, profileId);
+    if (!existingEntry) {
+      return null;
+    }
+
+    const payload = normalizeStoredRpgWorldProfile(
+      profileId,
+      existingEntry.profile,
+    );
+    const metadata = extractCustomWorldLibraryMetadata(payload);
+    const now = new Date().toISOString();
+
+    await this.db.query(
+      `UPDATE custom_world_profiles
+       SET visibility = 'published',
+           published_at = $1,
+           updated_at = $1,
+           author_display_name = $2,
+           world_name = $3,
+           subtitle = $4,
+           summary_text = $5,
+           cover_image_src = $6,
+           theme_mode = $7,
+           playable_npc_count = $8,
+           landmark_count = $9
+       WHERE user_id = $10
+         AND profile_id = $11`,
+      [
+        now,
+        authorDisplayName || '玩家',
+        metadata.worldName,
+        metadata.subtitle,
+        metadata.summaryText,
+        metadata.coverImageSrc,
+        metadata.themeMode,
+        metadata.playableNpcCount,
+        metadata.landmarkCount,
+        userId,
+        profileId,
+      ],
+    );
+
+    const entry = await this.findOwnProfileEntry(userId, profileId);
+    if (!entry) {
+      throw new Error('failed to resolve custom world after publish');
+    }
+
+    return {
+      entry,
+      entries: await this.listOwnProfiles(userId),
+    };
+  }
+
+  async unpublishOwnProfile(
+    userId: string,
+    profileId: string,
+    authorDisplayName: string,
+  ) {
+    const existingEntry = await this.findOwnProfileEntry(userId, profileId);
+    if (!existingEntry) {
+      return null;
+    }
+
+    const payload = normalizeStoredRpgWorldProfile(
+      profileId,
+      existingEntry.profile,
+    );
+    const metadata = extractCustomWorldLibraryMetadata(payload);
+    const now = new Date().toISOString();
+
+    await this.db.query(
+      `UPDATE custom_world_profiles
+       SET visibility = 'draft',
+           published_at = NULL,
+           updated_at = $1,
+           author_display_name = $2,
+           world_name = $3,
+           subtitle = $4,
+           summary_text = $5,
+           cover_image_src = $6,
+           theme_mode = $7,
+           playable_npc_count = $8,
+           landmark_count = $9
+       WHERE user_id = $10
+         AND profile_id = $11`,
+      [
+        now,
+        authorDisplayName || '玩家',
+        metadata.worldName,
+        metadata.subtitle,
+        metadata.summaryText,
+        metadata.coverImageSrc,
+        metadata.themeMode,
+        metadata.playableNpcCount,
+        metadata.landmarkCount,
+        userId,
+        profileId,
+      ],
+    );
+
+    const entry = await this.findOwnProfileEntry(userId, profileId);
+    if (!entry) {
+      throw new Error('failed to resolve custom world after unpublish');
+    }
+
+    return {
+      entry,
+      entries: await this.listOwnProfiles(userId),
+    };
+  }
+
+  async listPublishedGallery() {
+    const result = await this.db.query<RpgWorldGalleryRow>(
+      `SELECT user_id AS "ownerUserId",
+              profile_id AS "profileId",
+              visibility,
+              published_at AS "publishedAt",
+              updated_at AS "updatedAt",
+              author_display_name AS "authorDisplayName",
+              world_name AS "worldName",
+              subtitle,
+              summary_text AS "summaryText",
+              cover_image_src AS "coverImageSrc",
+              theme_mode AS "themeMode",
+              playable_npc_count AS "playableNpcCount",
+              landmark_count AS "landmarkCount"
+       FROM custom_world_profiles
+       WHERE visibility = 'published'
+         AND deleted_at IS NULL
+       ORDER BY published_at DESC, updated_at DESC
+       LIMIT $1`,
+      [MAX_RPG_WORLD_GALLERY_ENTRIES],
+    );
+
+    return result.rows.map((row) => toRpgWorldGalleryCard(row));
+  }
+
+  async getPublishedGalleryDetail(ownerUserId: string, profileId: string) {
+    const result = await this.db.query<RpgWorldProfileRow>(
+      `SELECT user_id AS "ownerUserId",
+              profile_id AS "profileId",
+              payload_json AS payload,
+              visibility,
+              published_at AS "publishedAt",
+              updated_at AS "updatedAt",
+              author_display_name AS "authorDisplayName",
+              world_name AS "worldName",
+              subtitle,
+              summary_text AS "summaryText",
+              cover_image_src AS "coverImageSrc",
+              theme_mode AS "themeMode",
+              playable_npc_count AS "playableNpcCount",
+              landmark_count AS "landmarkCount"
+       FROM custom_world_profiles
+       WHERE user_id = $1
+         AND profile_id = $2
+         AND visibility = 'published'
+         AND deleted_at IS NULL`,
+      [ownerUserId, profileId],
+    );
+
+    const row = result.rows[0];
+    return row ? toRpgWorldLibraryEntry(row) : null;
+  }
+}
diff --git a/server-node/src/repositories/rpg-entry/RpgEntryRepositories.test.ts b/server-node/src/repositories/rpg-entry/RpgEntryRepositories.test.ts
new file mode 100644
index 00000000..e2237114
--- /dev/null
+++ b/server-node/src/repositories/rpg-entry/RpgEntryRepositories.test.ts
@@ -0,0 +1,241 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import type { RuntimeRepositoryPort } from '../runtimeRepository.js';
+import { RpgSaveArchiveRepository } from './RpgSaveArchiveRepository.js';
+import { RpgWorldLibraryRepository } from './RpgWorldLibraryRepository.js';
+
+function createRuntimeRepositoryStub(): RuntimeRepositoryPort {
+  return {
+    async getSnapshot() {
+      return null;
+    },
+    async putSnapshot(_userId, payload) {
+      return {
+        version: 1,
+        ...payload,
+      };
+    },
+    async getProfileDashboard() {
+      return {
+        walletBalance: 0,
+        totalPlayTimeMs: 0,
+        playedWorldCount: 0,
+        updatedAt: '2026-04-21T00:00:00.000Z',
+      };
+    },
+    async listProfileWalletLedger() {
+      return [];
+    },
+    async getProfilePlayStats() {
+      return {
+        totalPlayTimeMs: 0,
+        playedWorks: [],
+        updatedAt: '2026-04-21T00:00:00.000Z',
+      };
+    },
+    async listProfileSaveArchives() {
+      return [
+        {
+          worldKey: 'world-1',
+          ownerUserId: 'owner-1',
+          profileId: 'profile-1',
+          worldType: 'custom',
+          worldName: '潮影群岛',
+          subtitle: '港雾与旧航道',
+          summaryText: '最近一次继续游戏入口',
+          coverImageSrc: null,
+          lastPlayedAt: '2026-04-20T23:59:59.000Z',
+        },
+      ];
+    },
+    async resumeProfileSaveArchive() {
+      return {
+        entry: {
+          worldKey: 'world-1',
+          ownerUserId: 'owner-1',
+          profileId: 'profile-1',
+          worldType: 'custom',
+          worldName: '潮影群岛',
+          subtitle: '港雾与旧航道',
+          summaryText: '最近一次继续游戏入口',
+          coverImageSrc: null,
+          lastPlayedAt: '2026-04-20T23:59:59.000Z',
+        },
+        snapshot: {
+          version: 1,
+          savedAt: '2026-04-20T23:59:59.000Z',
+          bottomTab: 'adventure',
+          gameState: { currentScene: '潮影港' },
+          currentStory: null,
+        },
+      };
+    },
+    async deleteSnapshot() {},
+    async getSettings() {
+      return {
+        musicVolume: 0.42,
+        platformTheme: 'light',
+      };
+    },
+    async putSettings(_userId, settings) {
+      return settings;
+    },
+    async listCustomWorldProfiles() {
+      return [
+        {
+          ownerUserId: 'owner-1',
+          profileId: 'profile-1',
+          profile: {
+            id: 'profile-1',
+          },
+          visibility: 'published',
+          publishedAt: '2026-04-20T08:00:00.000Z',
+          updatedAt: '2026-04-20T08:00:00.000Z',
+          authorDisplayName: '造物者',
+          worldName: '潮影群岛',
+          subtitle: '港雾与旧航道',
+          summaryText: '一座在潮汐中漂移的群岛。',
+          coverImageSrc: '/covers/tide.png',
+          themeMode: 'tide',
+          playableNpcCount: 2,
+          landmarkCount: 3,
+        },
+      ];
+    },
+    async listPlatformBrowseHistory() {
+      return [];
+    },
+    async upsertPlatformBrowseHistoryEntries() {
+      return [];
+    },
+    async clearPlatformBrowseHistory() {},
+    async upsertCustomWorldProfile() {
+      return {
+        entry: {
+          ownerUserId: 'owner-1',
+          profileId: 'profile-1',
+          profile: {
+            id: 'profile-1',
+          },
+          visibility: 'draft',
+          publishedAt: null,
+          updatedAt: '2026-04-20T08:00:00.000Z',
+          authorDisplayName: '造物者',
+          worldName: '潮影群岛',
+          subtitle: '港雾与旧航道',
+          summaryText: '一座在潮汐中漂移的群岛。',
+          coverImageSrc: '/covers/tide.png',
+          themeMode: 'tide',
+          playableNpcCount: 2,
+          landmarkCount: 3,
+        },
+        entries: [],
+      };
+    },
+    async deleteCustomWorldProfile() {
+      return [];
+    },
+    async listCustomWorldSessions() {
+      return [];
+    },
+    async getCustomWorldSession() {
+      return null;
+    },
+    async upsertCustomWorldSession(_userId, _sessionId, session) {
+      return session;
+    },
+    async publishCustomWorldProfile() {
+      return {
+        entry: {
+          ownerUserId: 'owner-1',
+          profileId: 'profile-1',
+          profile: {
+            id: 'profile-1',
+          },
+          visibility: 'published',
+          publishedAt: '2026-04-20T08:00:00.000Z',
+          updatedAt: '2026-04-20T08:00:00.000Z',
+          authorDisplayName: '造物者',
+          worldName: '潮影群岛',
+          subtitle: '港雾与旧航道',
+          summaryText: '一座在潮汐中漂移的群岛。',
+          coverImageSrc: '/covers/tide.png',
+          themeMode: 'tide',
+          playableNpcCount: 2,
+          landmarkCount: 3,
+        },
+        entries: [],
+      };
+    },
+    async unpublishCustomWorldProfile() {
+      return null;
+    },
+    async listPublishedCustomWorldGallery() {
+      return [
+        {
+          ownerUserId: 'owner-1',
+          profileId: 'profile-1',
+          visibility: 'published',
+          publishedAt: '2026-04-20T08:00:00.000Z',
+          updatedAt: '2026-04-20T08:00:00.000Z',
+          authorDisplayName: '造物者',
+          worldName: '潮影群岛',
+          subtitle: '港雾与旧航道',
+          summaryText: '一座在潮汐中漂移的群岛。',
+          coverImageSrc: '/covers/tide.png',
+          themeMode: 'tide',
+          playableNpcCount: 2,
+          landmarkCount: 3,
+        },
+      ];
+    },
+    async getPublishedCustomWorldGalleryDetail() {
+      return {
+        ownerUserId: 'owner-1',
+        profileId: 'profile-1',
+        profile: {
+          id: 'profile-1',
+        },
+        visibility: 'published',
+        publishedAt: '2026-04-20T08:00:00.000Z',
+        updatedAt: '2026-04-20T08:00:00.000Z',
+        authorDisplayName: '造物者',
+        worldName: '潮影群岛',
+        subtitle: '港雾与旧航道',
+        summaryText: '一座在潮汐中漂移的群岛。',
+        coverImageSrc: '/covers/tide.png',
+        themeMode: 'tide',
+        playableNpcCount: 2,
+        landmarkCount: 3,
+      };
+    },
+  };
+}
+
+test('RpgSaveArchiveRepository 只承接继续游戏归档读取职责', async () => {
+  const repository = new RpgSaveArchiveRepository(createRuntimeRepositoryStub());
+
+  const archives = await repository.listProfileSaveArchives('user-1');
+  const resumed = await repository.resumeProfileSaveArchive('user-1', 'world-1');
+
+  assert.equal(archives[0]?.worldName, '潮影群岛');
+  assert.equal(resumed?.snapshot.bottomTab, 'adventure');
+  assert.equal('getSnapshot' in repository, false);
+});
+
+test('RpgWorldLibraryRepository 独立承接作品库与广场读取职责', async () => {
+  const repository = new RpgWorldLibraryRepository(createRuntimeRepositoryStub());
+
+  const profiles = await repository.listCustomWorldProfiles('user-1');
+  const gallery = await repository.listPublishedCustomWorldGallery();
+  const detail = await repository.getPublishedCustomWorldGalleryDetail(
+    'owner-1',
+    'profile-1',
+  );
+
+  assert.equal(profiles[0]?.worldName, '潮影群岛');
+  assert.equal(gallery[0]?.themeMode, 'tide');
+  assert.equal(detail?.profileId, 'profile-1');
+  assert.equal('listProfileSaveArchives' in repository, false);
+});
diff --git a/server-node/src/repositories/rpg-entry/RpgSaveArchiveRepository.ts b/server-node/src/repositories/rpg-entry/RpgSaveArchiveRepository.ts
new file mode 100644
index 00000000..4b79c559
--- /dev/null
+++ b/server-node/src/repositories/rpg-entry/RpgSaveArchiveRepository.ts
@@ -0,0 +1,36 @@
+import type {
+  RuntimeRepositoryPort,
+  SavedSnapshot,
+} from '../runtimeRepository.js';
+import type { ProfileSaveArchiveSummary } from '../../../../packages/shared/src/contracts/runtime.js';
+
+/**
+ * RPG 继续游戏归档仓储端口。
+ * 当前仍由 runtimeRepository 提供真实实现，本文件只建立按领域命名的兼容入口。
+ */
+export type RpgSaveArchiveRepositoryPort = Pick<
+  RuntimeRepositoryPort,
+  'listProfileSaveArchives' | 'resumeProfileSaveArchive'
+>;
+export type RpgSaveArchiveSnapshot = SavedSnapshot;
+
+export class RpgSaveArchiveRepository implements RpgSaveArchiveRepositoryPort {
+  constructor(private readonly runtimeRepository: RuntimeRepositoryPort) {}
+
+  listProfileSaveArchives(userId: string): Promise<ProfileSaveArchiveSummary[]> {
+    return this.runtimeRepository.listProfileSaveArchives(userId);
+  }
+
+  resumeProfileSaveArchive(
+    userId: string,
+    worldKey: string,
+  ): Promise<
+    | {
+        entry: ProfileSaveArchiveSummary;
+        snapshot: RpgSaveArchiveSnapshot;
+      }
+    | null
+  > {
+    return this.runtimeRepository.resumeProfileSaveArchive(userId, worldKey);
+  }
+}
diff --git a/server-node/src/repositories/rpg-entry/RpgWorldLibraryRepository.ts b/server-node/src/repositories/rpg-entry/RpgWorldLibraryRepository.ts
new file mode 100644
index 00000000..e22ef70e
--- /dev/null
+++ b/server-node/src/repositories/rpg-entry/RpgWorldLibraryRepository.ts
@@ -0,0 +1,92 @@
+import type {
+  CustomWorldGalleryCard,
+  CustomWorldLibraryEntry,
+  CustomWorldProfileRecord,
+} from '../../../../packages/shared/src/contracts/runtime.js';
+import type { RuntimeRepositoryPort } from '../runtimeRepository.js';
+
+/**
+ * RPG 世界库仓储端口。
+ * 当前先桥接旧 runtimeRepository 中的世界库与广场读写，为工作包 H 的按域拆仓储提供命名骨架。
+ */
+export type RpgWorldLibraryRepositoryPort = Pick<
+  RuntimeRepositoryPort,
+  | 'deleteCustomWorldProfile'
+  | 'getPublishedCustomWorldGalleryDetail'
+  | 'listCustomWorldProfiles'
+  | 'listPublishedCustomWorldGallery'
+  | 'publishCustomWorldProfile'
+  | 'unpublishCustomWorldProfile'
+  | 'upsertCustomWorldProfile'
+>;
+
+export class RpgWorldLibraryRepository
+  implements RpgWorldLibraryRepositoryPort
+{
+  constructor(private readonly runtimeRepository: RuntimeRepositoryPort) {}
+
+  listCustomWorldProfiles(
+    userId: string,
+  ): Promise<CustomWorldLibraryEntry<CustomWorldProfileRecord>[]> {
+    return this.runtimeRepository.listCustomWorldProfiles(userId);
+  }
+
+  upsertCustomWorldProfile(
+    userId: string,
+    profileId: string,
+    profile: Record<string, unknown>,
+    authorDisplayName: string,
+  ) {
+    return this.runtimeRepository.upsertCustomWorldProfile(
+      userId,
+      profileId,
+      profile,
+      authorDisplayName,
+    );
+  }
+
+  deleteCustomWorldProfile(
+    userId: string,
+    profileId: string,
+  ): Promise<CustomWorldLibraryEntry<CustomWorldProfileRecord>[]> {
+    return this.runtimeRepository.deleteCustomWorldProfile(userId, profileId);
+  }
+
+  publishCustomWorldProfile(
+    userId: string,
+    profileId: string,
+    authorDisplayName: string,
+  ) {
+    return this.runtimeRepository.publishCustomWorldProfile(
+      userId,
+      profileId,
+      authorDisplayName,
+    );
+  }
+
+  unpublishCustomWorldProfile(
+    userId: string,
+    profileId: string,
+    authorDisplayName: string,
+  ) {
+    return this.runtimeRepository.unpublishCustomWorldProfile(
+      userId,
+      profileId,
+      authorDisplayName,
+    );
+  }
+
+  listPublishedCustomWorldGallery(): Promise<CustomWorldGalleryCard[]> {
+    return this.runtimeRepository.listPublishedCustomWorldGallery();
+  }
+
+  getPublishedCustomWorldGalleryDetail(
+    ownerUserId: string,
+    profileId: string,
+  ): Promise<CustomWorldLibraryEntry<CustomWorldProfileRecord> | null> {
+    return this.runtimeRepository.getPublishedCustomWorldGalleryDetail(
+      ownerUserId,
+      profileId,
+    );
+  }
+}
diff --git a/server-node/src/repositories/rpg-entry/index.ts b/server-node/src/repositories/rpg-entry/index.ts
new file mode 100644
index 00000000..674edd5b
--- /dev/null
+++ b/server-node/src/repositories/rpg-entry/index.ts
@@ -0,0 +1,8 @@
+export {
+  RpgSaveArchiveRepository,
+  type RpgSaveArchiveRepositoryPort,
+} from './RpgSaveArchiveRepository.js';
+export {
+  RpgWorldLibraryRepository,
+  type RpgWorldLibraryRepositoryPort,
+} from './RpgWorldLibraryRepository.js';
diff --git a/server-node/src/repositories/rpg-profile/RpgBrowseHistoryRepository.ts b/server-node/src/repositories/rpg-profile/RpgBrowseHistoryRepository.ts
new file mode 100644
index 00000000..44a5e773
--- /dev/null
+++ b/server-node/src/repositories/rpg-profile/RpgBrowseHistoryRepository.ts
@@ -0,0 +1,42 @@
+import type {
+  PlatformBrowseHistoryEntry,
+  PlatformBrowseHistoryWriteEntry,
+} from '../../../../packages/shared/src/contracts/runtime.js';
+import type { RuntimeRepositoryPort } from '../runtimeRepository.js';
+
+/**
+ * RPG 浏览历史仓储端口。
+ * 将继续游戏与平台浏览足迹独立命名，避免继续堆叠在资料看板仓储内。
+ */
+export type RpgBrowseHistoryRepositoryPort = Pick<
+  RuntimeRepositoryPort,
+  | 'clearPlatformBrowseHistory'
+  | 'listPlatformBrowseHistory'
+  | 'upsertPlatformBrowseHistoryEntries'
+>;
+
+export class RpgBrowseHistoryRepository
+  implements RpgBrowseHistoryRepositoryPort
+{
+  constructor(private readonly runtimeRepository: RuntimeRepositoryPort) {}
+
+  listPlatformBrowseHistory(
+    userId: string,
+  ): Promise<PlatformBrowseHistoryEntry[]> {
+    return this.runtimeRepository.listPlatformBrowseHistory(userId);
+  }
+
+  upsertPlatformBrowseHistoryEntries(
+    userId: string,
+    entries: PlatformBrowseHistoryWriteEntry[],
+  ): Promise<PlatformBrowseHistoryEntry[]> {
+    return this.runtimeRepository.upsertPlatformBrowseHistoryEntries(
+      userId,
+      entries,
+    );
+  }
+
+  clearPlatformBrowseHistory(userId: string): Promise<void> {
+    return this.runtimeRepository.clearPlatformBrowseHistory(userId);
+  }
+}
diff --git a/server-node/src/repositories/rpg-profile/RpgProfileDashboardRepository.ts b/server-node/src/repositories/rpg-profile/RpgProfileDashboardRepository.ts
new file mode 100644
index 00000000..cc5ff5be
--- /dev/null
+++ b/server-node/src/repositories/rpg-profile/RpgProfileDashboardRepository.ts
@@ -0,0 +1,49 @@
+import type {
+  ProfileDashboardSummary,
+  ProfilePlayStatsResponse,
+  ProfileWalletLedgerEntry,
+  RuntimeSettings,
+} from '../../../../packages/shared/src/contracts/runtime.js';
+import type { RuntimeRepositoryPort } from '../runtimeRepository.js';
+
+/**
+ * RPG profile 域仓储端口。
+ * 当前以委托方式桥接旧 runtimeRepository，给后续按域仓储拆分保留稳定依赖面。
+ */
+export type RpgProfileDashboardRepositoryPort = Pick<
+  RuntimeRepositoryPort,
+  | 'getProfileDashboard'
+  | 'getProfilePlayStats'
+  | 'getSettings'
+  | 'listProfileWalletLedger'
+  | 'putSettings'
+>;
+
+export class RpgProfileDashboardRepository
+  implements RpgProfileDashboardRepositoryPort
+{
+  constructor(private readonly runtimeRepository: RuntimeRepositoryPort) {}
+
+  getProfileDashboard(userId: string): Promise<ProfileDashboardSummary> {
+    return this.runtimeRepository.getProfileDashboard(userId);
+  }
+
+  listProfileWalletLedger(userId: string): Promise<ProfileWalletLedgerEntry[]> {
+    return this.runtimeRepository.listProfileWalletLedger(userId);
+  }
+
+  getProfilePlayStats(userId: string): Promise<ProfilePlayStatsResponse> {
+    return this.runtimeRepository.getProfilePlayStats(userId);
+  }
+
+  getSettings(userId: string): Promise<RuntimeSettings> {
+    return this.runtimeRepository.getSettings(userId);
+  }
+
+  putSettings(
+    userId: string,
+    settings: RuntimeSettings,
+  ): Promise<RuntimeSettings> {
+    return this.runtimeRepository.putSettings(userId, settings);
+  }
+}
diff --git a/server-node/src/repositories/rpg-profile/RpgProfileRepositories.test.ts b/server-node/src/repositories/rpg-profile/RpgProfileRepositories.test.ts
new file mode 100644
index 00000000..bbb4cf3f
--- /dev/null
+++ b/server-node/src/repositories/rpg-profile/RpgProfileRepositories.test.ts
@@ -0,0 +1,154 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import type { RuntimeRepositoryPort } from '../runtimeRepository.js';
+import { RpgBrowseHistoryRepository } from './RpgBrowseHistoryRepository.js';
+import { RpgProfileDashboardRepository } from './RpgProfileDashboardRepository.js';
+
+function createRuntimeRepositoryStub(): RuntimeRepositoryPort {
+  return {
+    async getSnapshot() {
+      return null;
+    },
+    async putSnapshot(_userId, payload) {
+      return {
+        version: 1,
+        ...payload,
+      };
+    },
+    async getProfileDashboard() {
+      return {
+        walletBalance: 0,
+        totalPlayTimeMs: 0,
+        playedWorldCount: 0,
+        updatedAt: '2026-04-21T00:00:00.000Z',
+      };
+    },
+    async listProfileWalletLedger() {
+      return [];
+    },
+    async getProfilePlayStats() {
+      return {
+        totalPlayTimeMs: 0,
+        playedWorks: [],
+        updatedAt: '2026-04-21T00:00:00.000Z',
+      };
+    },
+    async listProfileSaveArchives() {
+      return [];
+    },
+    async resumeProfileSaveArchive() {
+      return null;
+    },
+    async deleteSnapshot() {},
+    async getSettings() {
+      return {
+        musicVolume: 0.5,
+        platformTheme: 'light',
+      };
+    },
+    async putSettings(_userId, settings) {
+      return settings;
+    },
+    async listCustomWorldProfiles() {
+      return [];
+    },
+    async listPlatformBrowseHistory() {
+      return [
+        {
+          ownerUserId: 'owner-1',
+          profileId: 'profile-1',
+          worldName: '雾港',
+          subtitle: '沿海试炼',
+          summaryText: '最近访问',
+          coverImageSrc: null,
+          themeMode: 'mythic',
+          authorDisplayName: '测试者',
+          visitedAt: '2026-04-21T00:00:00.000Z',
+        },
+      ];
+    },
+    async upsertPlatformBrowseHistoryEntries(_userId, entries) {
+      return entries.map((entry) => ({
+        ownerUserId: entry.ownerUserId,
+        profileId: entry.profileId,
+        worldName: entry.worldName,
+        subtitle: entry.subtitle ?? '',
+        summaryText: entry.summaryText ?? '',
+        coverImageSrc: entry.coverImageSrc ?? null,
+        themeMode: entry.themeMode ?? 'mythic',
+        authorDisplayName: entry.authorDisplayName ?? '玩家',
+        visitedAt: entry.visitedAt ?? '2026-04-21T00:00:00.000Z',
+      }));
+    },
+    async clearPlatformBrowseHistory() {},
+    async upsertCustomWorldProfile() {
+      return {
+        entry: {} as never,
+        entries: [],
+      };
+    },
+    async deleteCustomWorldProfile() {
+      return [];
+    },
+    async listCustomWorldSessions() {
+      return [];
+    },
+    async getCustomWorldSession() {
+      return null;
+    },
+    async upsertCustomWorldSession(_userId, _sessionId, session) {
+      return session;
+    },
+    async publishCustomWorldProfile() {
+      return null;
+    },
+    async unpublishCustomWorldProfile() {
+      return null;
+    },
+    async listPublishedCustomWorldGallery() {
+      return [];
+    },
+    async getPublishedCustomWorldGalleryDetail() {
+      return null;
+    },
+  };
+}
+
+test('RpgProfileDashboardRepository 只暴露资料看板域方法', async () => {
+  const repository = new RpgProfileDashboardRepository(
+    createRuntimeRepositoryStub(),
+  );
+
+  const dashboard = await repository.getProfileDashboard('user-1');
+  const playStats = await repository.getProfilePlayStats('user-1');
+  const settings = await repository.getSettings('user-1');
+
+  assert.equal(dashboard.playedWorldCount, 0);
+  assert.equal(playStats.playedWorks.length, 0);
+  assert.equal(settings.platformTheme, 'light');
+  assert.equal('listPlatformBrowseHistory' in repository, false);
+});
+
+test('RpgBrowseHistoryRepository 独立承接浏览历史读写，不再混入资料看板仓储', async () => {
+  const repository = new RpgBrowseHistoryRepository(createRuntimeRepositoryStub());
+
+  const history = await repository.listPlatformBrowseHistory('user-1');
+  const updated = await repository.upsertPlatformBrowseHistoryEntries('user-1', [
+    {
+      ownerUserId: 'owner-2',
+      profileId: 'profile-2',
+      worldName: '盐雾镇',
+      subtitle: '盐路补给点',
+      summaryText: '测试写入浏览历史',
+      coverImageSrc: null,
+      themeMode: 'mythic',
+      authorDisplayName: '测试者二号',
+      visitedAt: '2026-04-21T01:00:00.000Z',
+    },
+  ]);
+
+  assert.equal(history[0]?.worldName, '雾港');
+  assert.equal(updated[0]?.profileId, 'profile-2');
+  assert.equal('getProfileDashboard' in repository, false);
+});
diff --git a/server-node/src/repositories/rpg-profile/index.ts b/server-node/src/repositories/rpg-profile/index.ts
new file mode 100644
index 00000000..9abdcd25
--- /dev/null
+++ b/server-node/src/repositories/rpg-profile/index.ts
@@ -0,0 +1,8 @@
+export {
+  RpgBrowseHistoryRepository,
+  type RpgBrowseHistoryRepositoryPort,
+} from './RpgBrowseHistoryRepository.js';
+export {
+  RpgProfileDashboardRepository,
+  type RpgProfileDashboardRepositoryPort,
+} from './RpgProfileDashboardRepository.js';
diff --git a/server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.test.ts b/server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.test.ts
new file mode 100644
index 00000000..f1d01b08
--- /dev/null
+++ b/server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.test.ts
@@ -0,0 +1,126 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import type { RuntimeRepositoryPort } from '../runtimeRepository.js';
+import { RpgRuntimeSnapshotRepository } from './RpgRuntimeSnapshotRepository.js';
+
+function createRuntimeRepositoryStub(): RuntimeRepositoryPort {
+  const deletedUserIds: string[] = [];
+
+  return {
+    async getSnapshot(userId) {
+      return {
+        version: 2,
+        savedAt: '2026-04-21T00:00:00.000Z',
+        bottomTab: 'adventure',
+        gameState: {
+          owner: userId,
+        },
+        currentStory: null,
+      };
+    },
+    async putSnapshot(_userId, payload) {
+      return {
+        version: 2,
+        ...payload,
+      };
+    },
+    async getProfileDashboard() {
+      return {
+        walletBalance: 0,
+        totalPlayTimeMs: 0,
+        playedWorldCount: 0,
+        updatedAt: '2026-04-21T00:00:00.000Z',
+      };
+    },
+    async listProfileWalletLedger() {
+      return [];
+    },
+    async getProfilePlayStats() {
+      return {
+        totalPlayTimeMs: 0,
+        playedWorks: [],
+        updatedAt: '2026-04-21T00:00:00.000Z',
+      };
+    },
+    async listProfileSaveArchives() {
+      return [];
+    },
+    async resumeProfileSaveArchive() {
+      return null;
+    },
+    async deleteSnapshot(userId) {
+      deletedUserIds.push(userId);
+    },
+    async getSettings() {
+      return {
+        musicVolume: 0.42,
+        platformTheme: 'light',
+      };
+    },
+    async putSettings(_userId, settings) {
+      return settings;
+    },
+    async listCustomWorldProfiles() {
+      return [];
+    },
+    async listPlatformBrowseHistory() {
+      return [];
+    },
+    async upsertPlatformBrowseHistoryEntries() {
+      return [];
+    },
+    async clearPlatformBrowseHistory() {},
+    async upsertCustomWorldProfile() {
+      return {
+        entry: {} as never,
+        entries: [],
+      };
+    },
+    async deleteCustomWorldProfile() {
+      return [];
+    },
+    async listCustomWorldSessions() {
+      return [];
+    },
+    async getCustomWorldSession() {
+      return null;
+    },
+    async upsertCustomWorldSession(_userId, _sessionId, session) {
+      return session;
+    },
+    async publishCustomWorldProfile() {
+      return null;
+    },
+    async unpublishCustomWorldProfile() {
+      return null;
+    },
+    async listPublishedCustomWorldGallery() {
+      return [];
+    },
+    async getPublishedCustomWorldGalleryDetail() {
+      return null;
+    },
+  };
+}
+
+test('RpgRuntimeSnapshotRepository 独立承接 snapshot 读写与删除职责', async () => {
+  const runtimeRepository = createRuntimeRepositoryStub();
+  const repository = new RpgRuntimeSnapshotRepository(runtimeRepository);
+
+  const snapshot = await repository.getSnapshot('user-7');
+  const saved = await repository.putSnapshot('user-7', {
+    savedAt: '2026-04-21T01:00:00.000Z',
+    bottomTab: 'inventory',
+    gameState: {
+      owner: 'user-7',
+      currentScene: '雾港',
+    },
+    currentStory: null,
+  });
+  await repository.deleteSnapshot('user-7');
+
+  assert.equal(snapshot?.gameState.owner, 'user-7');
+  assert.equal(saved.bottomTab, 'inventory');
+  assert.equal('listProfileSaveArchives' in repository, false);
+});
diff --git a/server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.ts b/server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.ts
new file mode 100644
index 00000000..73c6fffb
--- /dev/null
+++ b/server-node/src/repositories/rpg-runtime/RpgRuntimeSnapshotRepository.ts
@@ -0,0 +1,35 @@
+import type {
+  RuntimeRepositoryPort,
+  SavedSnapshot,
+} from '../runtimeRepository.js';
+
+/**
+ * RPG runtime 快照仓储端口。
+ * 工作包 A 先把 snapshot 领域从大仓储中抽出独立命名入口，真实读写仍委托现有 runtimeRepository。
+ */
+export type RpgRuntimeSnapshotRepositoryPort = Pick<
+  RuntimeRepositoryPort,
+  'deleteSnapshot' | 'getSnapshot' | 'putSnapshot'
+>;
+export type RpgRuntimeSavedSnapshot = SavedSnapshot;
+
+export class RpgRuntimeSnapshotRepository
+  implements RpgRuntimeSnapshotRepositoryPort
+{
+  constructor(private readonly runtimeRepository: RuntimeRepositoryPort) {}
+
+  getSnapshot(userId: string): Promise<RpgRuntimeSavedSnapshot | null> {
+    return this.runtimeRepository.getSnapshot(userId);
+  }
+
+  putSnapshot(
+    userId: string,
+    payload: Omit<RpgRuntimeSavedSnapshot, 'version'>,
+  ): Promise<RpgRuntimeSavedSnapshot> {
+    return this.runtimeRepository.putSnapshot(userId, payload);
+  }
+
+  deleteSnapshot(userId: string): Promise<void> {
+    return this.runtimeRepository.deleteSnapshot(userId);
+  }
+}
diff --git a/server-node/src/repositories/rpg-runtime/index.ts b/server-node/src/repositories/rpg-runtime/index.ts
new file mode 100644
index 00000000..759f002b
--- /dev/null
+++ b/server-node/src/repositories/rpg-runtime/index.ts
@@ -0,0 +1,4 @@
+export {
+  RpgRuntimeSnapshotRepository,
+  type RpgRuntimeSnapshotRepositoryPort,
+} from './RpgRuntimeSnapshotRepository.js';
diff --git a/server-node/src/repositories/rpgWorldRepositoryShared.ts b/server-node/src/repositories/rpgWorldRepositoryShared.ts
new file mode 100644
index 00000000..639255f1
--- /dev/null
+++ b/server-node/src/repositories/rpgWorldRepositoryShared.ts
@@ -0,0 +1,116 @@
+import type { QueryResultRow } from 'pg';
+
+import type {
+  CustomWorldProfileRecord,
+} from '../../../packages/shared/src/contracts/runtime.js';
+import {
+  type CustomWorldGalleryCard,
+  type CustomWorldLibraryEntry,
+  type CustomWorldPublicationStatus,
+  type CustomWorldSessionRecord,
+} from '../../../packages/shared/src/contracts/runtime.js';
+import { extractCustomWorldLibraryMetadata } from './customWorldLibraryMetadata.js';
+
+export const MAX_RPG_WORLD_PROFILE_ENTRIES = 12;
+export const MAX_RPG_WORLD_GALLERY_ENTRIES = 36;
+
+export type RpgWorldProfileRow = QueryResultRow & {
+  ownerUserId: string;
+  profileId: string;
+  payload: CustomWorldProfileRecord;
+  visibility: CustomWorldPublicationStatus;
+  publishedAt: string | null;
+  updatedAt: string;
+  authorDisplayName: string;
+  worldName: string;
+  subtitle: string;
+  summaryText: string;
+  coverImageSrc: string | null;
+  themeMode: CustomWorldLibraryEntry['themeMode'];
+  playableNpcCount: number;
+  landmarkCount: number;
+};
+
+export type RpgAgentSessionRow = QueryResultRow & {
+  payload: CustomWorldSessionRecord;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type RpgWorldGalleryRow = QueryResultRow & {
+  ownerUserId: string;
+  profileId: string;
+  visibility: CustomWorldPublicationStatus;
+  publishedAt: string | null;
+  updatedAt: string;
+  authorDisplayName: string;
+  worldName: string;
+  subtitle: string;
+  summaryText: string;
+  coverImageSrc: string | null;
+  themeMode: CustomWorldGalleryCard['themeMode'];
+  playableNpcCount: number;
+  landmarkCount: number;
+};
+
+/**
+ * 落库前统一补齐 profileId，避免不同入口写入时出现同一世界两个 id 口径。
+ */
+export function normalizeStoredRpgWorldProfile(
+  profileId: string,
+  profile: Record<string, unknown>,
+): CustomWorldProfileRecord {
+  return {
+    ...profile,
+    id: profileId,
+  };
+}
+
+export function toRpgWorldLibraryEntry(
+  row: RpgWorldProfileRow,
+): CustomWorldLibraryEntry<CustomWorldProfileRecord> {
+  const fallbackMetadata = extractCustomWorldLibraryMetadata(row.payload);
+
+  return {
+    ownerUserId: row.ownerUserId,
+    profileId: row.profileId,
+    profile: row.payload,
+    visibility: row.visibility,
+    publishedAt: row.publishedAt,
+    updatedAt: row.updatedAt,
+    authorDisplayName: row.authorDisplayName || '玩家',
+    worldName: row.worldName || fallbackMetadata.worldName,
+    subtitle: row.subtitle || fallbackMetadata.subtitle,
+    summaryText: row.summaryText || fallbackMetadata.summaryText,
+    coverImageSrc: row.coverImageSrc || fallbackMetadata.coverImageSrc,
+    themeMode: row.themeMode || fallbackMetadata.themeMode,
+    playableNpcCount:
+      row.playableNpcCount > 0
+        ? row.playableNpcCount
+        : fallbackMetadata.playableNpcCount,
+    landmarkCount:
+      row.landmarkCount > 0
+        ? row.landmarkCount
+        : fallbackMetadata.landmarkCount,
+  };
+}
+
+export function toRpgWorldGalleryCard(
+  row: RpgWorldGalleryRow,
+): CustomWorldGalleryCard {
+  return {
+    ownerUserId: row.ownerUserId,
+    profileId: row.profileId,
+    visibility: row.visibility,
+    publishedAt: row.publishedAt,
+    updatedAt: row.updatedAt,
+    authorDisplayName: row.authorDisplayName || '玩家',
+    worldName: row.worldName || '未命名世界',
+    subtitle: row.subtitle || '',
+    summaryText: row.summaryText || '',
+    coverImageSrc: row.coverImageSrc || null,
+    themeMode: row.themeMode || 'mythic',
+    playableNpcCount: row.playableNpcCount,
+    landmarkCount: row.landmarkCount,
+  };
+}
diff --git a/server-node/src/repositories/runtimeRepository.ts b/server-node/src/repositories/runtimeRepository.ts
index ade6f6c8..aed72c0e 100644
--- a/server-node/src/repositories/runtimeRepository.ts
+++ b/server-node/src/repositories/runtimeRepository.ts
@@ -25,9 +25,9 @@ import {
 } from '../../../packages/shared/src/contracts/runtime.js';
 import type { AppDatabase } from '../db.js';
 import { extractCustomWorldLibraryMetadata } from './customWorldLibraryMetadata.js';
-
-const MAX_CUSTOM_WORLD_PROFILES = 12;
-const MAX_PUBLIC_CUSTOM_WORLD_PROFILES = 36;
+import { RpgAgentSessionRepository } from './RpgAgentSessionRepository.js';
+import { RpgWorldProfileRepository } from './RpgWorldProfileRepository.js';
+import { normalizeStoredRpgWorldProfile } from './rpgWorldRepositoryShared.js';
 
 export type SavedSnapshot = SavedGameSnapshot<unknown, string, unknown>;
 
@@ -44,45 +44,6 @@ type SettingsRow = QueryResultRow & {
   platformTheme: RuntimeSettings['platformTheme'];
 };
 
-type CustomWorldEntryRow = QueryResultRow & {
-  ownerUserId: string;
-  profileId: string;
-  payload: CustomWorldProfileRecord;
-  visibility: CustomWorldPublicationStatus;
-  publishedAt: string | null;
-  updatedAt: string;
-  authorDisplayName: string;
-  worldName: string;
-  subtitle: string;
-  summaryText: string;
-  coverImageSrc: string | null;
-  themeMode: CustomWorldLibraryEntry['themeMode'];
-  playableNpcCount: number;
-  landmarkCount: number;
-};
-
-type SessionRow = QueryResultRow & {
-  payload: CustomWorldSessionRecord;
-  createdAt: string;
-  updatedAt: string;
-};
-
-type CustomWorldCardRow = QueryResultRow & {
-  ownerUserId: string;
-  profileId: string;
-  visibility: CustomWorldPublicationStatus;
-  publishedAt: string | null;
-  updatedAt: string;
-  authorDisplayName: string;
-  worldName: string;
-  subtitle: string;
-  summaryText: string;
-  coverImageSrc: string | null;
-  themeMode: CustomWorldGalleryCard['themeMode'];
-  playableNpcCount: number;
-  landmarkCount: number;
-};
-
 type PlatformBrowseHistoryRow = QueryResultRow & {
   ownerUserId: string;
   profileId: string;
@@ -227,65 +188,6 @@ export type RuntimeRepositoryPort = {
   ): Promise<CustomWorldLibraryEntry<CustomWorldProfileRecord> | null>;
 };
 
-function normalizeStoredProfile(
-  profileId: string,
-  profile: Record<string, unknown>,
-): CustomWorldProfileRecord {
-  return {
-    ...profile,
-    id: profileId,
-  };
-}
-
-function toCustomWorldLibraryEntry(
-  row: CustomWorldEntryRow,
-): CustomWorldLibraryEntry<CustomWorldProfileRecord> {
-  const fallbackMetadata = extractCustomWorldLibraryMetadata(row.payload);
-
-  return {
-    ownerUserId: row.ownerUserId,
-    profileId: row.profileId,
-    profile: row.payload,
-    visibility: row.visibility,
-    publishedAt: row.publishedAt,
-    updatedAt: row.updatedAt,
-    authorDisplayName: row.authorDisplayName || '玩家',
-    worldName: row.worldName || fallbackMetadata.worldName,
-    subtitle: row.subtitle || fallbackMetadata.subtitle,
-    summaryText: row.summaryText || fallbackMetadata.summaryText,
-    coverImageSrc: row.coverImageSrc || fallbackMetadata.coverImageSrc,
-    themeMode: row.themeMode || fallbackMetadata.themeMode,
-    playableNpcCount:
-      row.playableNpcCount > 0
-        ? row.playableNpcCount
-        : fallbackMetadata.playableNpcCount,
-    landmarkCount:
-      row.landmarkCount > 0
-        ? row.landmarkCount
-        : fallbackMetadata.landmarkCount,
-  };
-}
-
-function toCustomWorldGalleryCard(
-  row: CustomWorldCardRow,
-): CustomWorldGalleryCard {
-  return {
-    ownerUserId: row.ownerUserId,
-    profileId: row.profileId,
-    visibility: row.visibility,
-    publishedAt: row.publishedAt,
-    updatedAt: row.updatedAt,
-    authorDisplayName: row.authorDisplayName || '玩家',
-    worldName: row.worldName || '未命名世界',
-    subtitle: row.subtitle || '',
-    summaryText: row.summaryText || '',
-    coverImageSrc: row.coverImageSrc || null,
-    themeMode: row.themeMode || 'mythic',
-    playableNpcCount: row.playableNpcCount,
-    landmarkCount: row.landmarkCount,
-  };
-}
-
 function toPlatformBrowseHistoryEntry(
   row: PlatformBrowseHistoryRow,
 ): PlatformBrowseHistoryEntry {
@@ -678,7 +580,7 @@ function resolveProfileSaveArchiveMeta(
   if (customWorldProfile) {
     const profileId = readString(customWorldProfile.id) || 'custom-world';
     const metadata = extractCustomWorldLibraryMetadata(
-      normalizeStoredProfile(profileId, customWorldProfile),
+      normalizeStoredRpgWorldProfile(profileId, customWorldProfile),
     );
 
     return {
@@ -717,33 +619,12 @@ function resolveProfileSaveArchiveMeta(
 }
 
 export class RuntimeRepository implements RuntimeRepositoryPort {
-  constructor(private readonly db: AppDatabase) {}
+  private readonly rpgAgentSessionRepository: RpgAgentSessionRepository;
+  private readonly rpgWorldProfileRepository: RpgWorldProfileRepository;
 
-  private async findCustomWorldProfileEntry(userId: string, profileId: string) {
-    const result = await this.db.query<CustomWorldEntryRow>(
-      `SELECT user_id AS "ownerUserId",
-              profile_id AS "profileId",
-              payload_json AS payload,
-              visibility,
-              published_at AS "publishedAt",
-              updated_at AS "updatedAt",
-              author_display_name AS "authorDisplayName",
-              world_name AS "worldName",
-              subtitle,
-              summary_text AS "summaryText",
-              cover_image_src AS "coverImageSrc",
-              theme_mode AS "themeMode",
-              playable_npc_count AS "playableNpcCount",
-              landmark_count AS "landmarkCount"
-       FROM custom_world_profiles
-       WHERE user_id = $1
-         AND profile_id = $2
-         AND deleted_at IS NULL`,
-      [userId, profileId],
-    );
-
-    const row = result.rows[0];
-    return row ? toCustomWorldLibraryEntry(row) : null;
+  constructor(private readonly db: AppDatabase) {
+    this.rpgAgentSessionRepository = new RpgAgentSessionRepository(db);
+    this.rpgWorldProfileRepository = new RpgWorldProfileRepository(db);
   }
 
   private async getProfileDashboardState(userId: string) {
@@ -1043,52 +924,13 @@ export class RuntimeRepository implements RuntimeRepositoryPort {
       return;
     }
 
-    const payload = normalizeStoredProfile(profileId, customWorldProfile);
-    const metadata = extractCustomWorldLibraryMetadata(payload);
     const syncedAt = snapshot.savedAt || new Date().toISOString();
 
-    await this.db.query(
-      `INSERT INTO custom_world_profiles (
-         user_id,
-         profile_id,
-         payload_json,
-         updated_at,
-         author_display_name,
-         world_name,
-         subtitle,
-         summary_text,
-         cover_image_src,
-         theme_mode,
-         playable_npc_count,
-         landmark_count,
-         deleted_at
-       )
-       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, NULL)
-       ON CONFLICT (user_id, profile_id) DO UPDATE SET
-         payload_json = EXCLUDED.payload_json,
-         updated_at = EXCLUDED.updated_at,
-         deleted_at = NULL,
-         world_name = EXCLUDED.world_name,
-         subtitle = EXCLUDED.subtitle,
-         summary_text = EXCLUDED.summary_text,
-         cover_image_src = EXCLUDED.cover_image_src,
-         theme_mode = EXCLUDED.theme_mode,
-         playable_npc_count = EXCLUDED.playable_npc_count,
-         landmark_count = EXCLUDED.landmark_count`,
-      [
-        userId,
-        profileId,
-        payload,
-        syncedAt,
-        '玩家',
-        metadata.worldName,
-        metadata.subtitle,
-        metadata.summaryText,
-        metadata.coverImageSrc,
-        metadata.themeMode,
-        metadata.playableNpcCount,
-        metadata.landmarkCount,
-      ],
+    await this.rpgWorldProfileRepository.syncProfileFromSnapshot(
+      userId,
+      profileId,
+      customWorldProfile,
+      syncedAt,
     );
   }
 
@@ -1394,29 +1236,7 @@ export class RuntimeRepository implements RuntimeRepositoryPort {
   }
 
   async listCustomWorldProfiles(userId: string) {
-    const result = await this.db.query<CustomWorldEntryRow>(
-      `SELECT user_id AS "ownerUserId",
-              profile_id AS "profileId",
-              payload_json AS payload,
-              visibility,
-              published_at AS "publishedAt",
-              updated_at AS "updatedAt",
-              author_display_name AS "authorDisplayName",
-              world_name AS "worldName",
-              subtitle,
-              summary_text AS "summaryText",
-              cover_image_src AS "coverImageSrc",
-              theme_mode AS "themeMode",
-              playable_npc_count AS "playableNpcCount",
-              landmark_count AS "landmarkCount"
-       FROM custom_world_profiles
-       WHERE user_id = $1
-         AND deleted_at IS NULL
-       ORDER BY updated_at DESC
-       LIMIT $2`,
-      [userId, MAX_CUSTOM_WORLD_PROFILES],
-    );
-    return result.rows.map((row) => toCustomWorldLibraryEntry(row));
+    return this.rpgWorldProfileRepository.listOwnProfiles(userId);
   }
 
   async upsertCustomWorldProfile(
@@ -1425,120 +1245,27 @@ export class RuntimeRepository implements RuntimeRepositoryPort {
     profile: Record<string, unknown>,
     authorDisplayName: string,
   ) {
-    const payload = normalizeStoredProfile(profileId, profile);
-    const metadata = extractCustomWorldLibraryMetadata(payload);
-    const now = new Date().toISOString();
-
-    await this.db.query(
-      `INSERT INTO custom_world_profiles (
-         user_id,
-         profile_id,
-         payload_json,
-         updated_at,
-         author_display_name,
-         world_name,
-         subtitle,
-         summary_text,
-         cover_image_src,
-         theme_mode,
-         playable_npc_count,
-         landmark_count
-       )
-       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)
-       ON CONFLICT (user_id, profile_id) DO UPDATE SET
-         payload_json = EXCLUDED.payload_json,
-         updated_at = EXCLUDED.updated_at,
-         deleted_at = NULL,
-         author_display_name = EXCLUDED.author_display_name,
-         world_name = EXCLUDED.world_name,
-         subtitle = EXCLUDED.subtitle,
-         summary_text = EXCLUDED.summary_text,
-         cover_image_src = EXCLUDED.cover_image_src,
-         theme_mode = EXCLUDED.theme_mode,
-         playable_npc_count = EXCLUDED.playable_npc_count,
-         landmark_count = EXCLUDED.landmark_count`,
-      [
-        userId,
-        profileId,
-        payload,
-        now,
-        authorDisplayName || '玩家',
-        metadata.worldName,
-        metadata.subtitle,
-        metadata.summaryText,
-        metadata.coverImageSrc,
-        metadata.themeMode,
-        metadata.playableNpcCount,
-        metadata.landmarkCount,
-      ],
+    return this.rpgWorldProfileRepository.upsertOwnProfile(
+      userId,
+      profileId,
+      profile,
+      authorDisplayName,
     );
-
-    const entry = await this.findCustomWorldProfileEntry(userId, profileId);
-    if (!entry) {
-      throw new Error('failed to resolve custom world after upsert');
-    }
-
-    return {
-      entry,
-      entries: await this.listCustomWorldProfiles(userId),
-    };
   }
 
   async deleteCustomWorldProfile(userId: string, profileId: string) {
-    const deletedAt = new Date().toISOString();
-    await this.db.query(
-      `UPDATE custom_world_profiles
-       SET deleted_at = $1,
-           updated_at = $1,
-           visibility = 'draft',
-           published_at = NULL
-       WHERE user_id = $2
-         AND profile_id = $3
-         AND deleted_at IS NULL`,
-      [deletedAt, userId, profileId],
+    return this.rpgWorldProfileRepository.softDeleteOwnProfile(
+      userId,
+      profileId,
     );
-
-    return this.listCustomWorldProfiles(userId);
   }
 
   async listCustomWorldSessions(userId: string) {
-    const result = await this.db.query<SessionRow>(
-      `SELECT payload_json AS payload,
-              created_at AS "createdAt",
-              updated_at AS "updatedAt"
-       FROM custom_world_sessions
-       WHERE user_id = $1
-       ORDER BY updated_at DESC`,
-      [userId],
-    );
-
-    return result.rows.map((row) => ({
-      ...row.payload,
-      createdAt: row.createdAt,
-      updatedAt: row.updatedAt,
-    }));
+    return this.rpgAgentSessionRepository.listSessions(userId);
   }
 
   async getCustomWorldSession(userId: string, sessionId: string) {
-    const result = await this.db.query<SessionRow>(
-      `SELECT payload_json AS payload,
-              created_at AS "createdAt",
-              updated_at AS "updatedAt"
-       FROM custom_world_sessions
-       WHERE user_id = $1 AND session_id = $2`,
-      [userId, sessionId],
-    );
-    const row = result.rows[0];
-
-    if (!row) {
-      return null;
-    }
-
-    return {
-      ...row.payload,
-      createdAt: row.createdAt,
-      updatedAt: row.updatedAt,
-    };
+    return this.rpgAgentSessionRepository.getSession(userId, sessionId);
   }
 
   async upsertCustomWorldSession(
@@ -1546,30 +1273,11 @@ export class RuntimeRepository implements RuntimeRepositoryPort {
     sessionId: string,
     session: CustomWorldSessionRecord,
   ) {
-    const payload = {
-      ...session,
+    return this.rpgAgentSessionRepository.upsertSession(
+      userId,
       sessionId,
-    } satisfies CustomWorldSessionRecord;
-
-    await this.db.query(
-      `INSERT INTO custom_world_sessions (
-         user_id,
-         session_id,
-         payload_json,
-         created_at,
-         updated_at
-       ) VALUES ($1, $2, $3, $4, $5)
-       ON CONFLICT (user_id, session_id) DO UPDATE SET
-         payload_json = EXCLUDED.payload_json,
-         updated_at = EXCLUDED.updated_at`,
-      [userId, sessionId, payload, session.createdAt, session.updatedAt],
+      session,
     );
-
-    return {
-      ...payload,
-      createdAt: session.createdAt,
-      updatedAt: session.updatedAt,
-    };
   }
 
   async publishCustomWorldProfile(
@@ -1577,57 +1285,11 @@ export class RuntimeRepository implements RuntimeRepositoryPort {
     profileId: string,
     authorDisplayName: string,
   ) {
-    const existingEntry = await this.findCustomWorldProfileEntry(
+    return this.rpgWorldProfileRepository.publishOwnProfile(
       userId,
       profileId,
+      authorDisplayName,
     );
-    if (!existingEntry) {
-      return null;
-    }
-
-    const payload = normalizeStoredProfile(profileId, existingEntry.profile);
-    const metadata = extractCustomWorldLibraryMetadata(payload);
-    const now = new Date().toISOString();
-
-    await this.db.query(
-      `UPDATE custom_world_profiles
-       SET visibility = 'published',
-           published_at = $1,
-           updated_at = $1,
-           author_display_name = $2,
-           world_name = $3,
-           subtitle = $4,
-           summary_text = $5,
-           cover_image_src = $6,
-           theme_mode = $7,
-           playable_npc_count = $8,
-           landmark_count = $9
-       WHERE user_id = $10
-         AND profile_id = $11`,
-      [
-        now,
-        authorDisplayName || '玩家',
-        metadata.worldName,
-        metadata.subtitle,
-        metadata.summaryText,
-        metadata.coverImageSrc,
-        metadata.themeMode,
-        metadata.playableNpcCount,
-        metadata.landmarkCount,
-        userId,
-        profileId,
-      ],
-    );
-
-    const entry = await this.findCustomWorldProfileEntry(userId, profileId);
-    if (!entry) {
-      throw new Error('failed to resolve custom world after publish');
-    }
-
-    return {
-      entry,
-      entries: await this.listCustomWorldProfiles(userId),
-    };
   }
 
   async unpublishCustomWorldProfile(
@@ -1635,113 +1297,24 @@ export class RuntimeRepository implements RuntimeRepositoryPort {
     profileId: string,
     authorDisplayName: string,
   ) {
-    const existingEntry = await this.findCustomWorldProfileEntry(
+    return this.rpgWorldProfileRepository.unpublishOwnProfile(
       userId,
       profileId,
+      authorDisplayName,
     );
-    if (!existingEntry) {
-      return null;
-    }
-
-    const payload = normalizeStoredProfile(profileId, existingEntry.profile);
-    const metadata = extractCustomWorldLibraryMetadata(payload);
-    const now = new Date().toISOString();
-
-    await this.db.query(
-      `UPDATE custom_world_profiles
-       SET visibility = 'draft',
-           published_at = NULL,
-           updated_at = $1,
-           author_display_name = $2,
-           world_name = $3,
-           subtitle = $4,
-           summary_text = $5,
-           cover_image_src = $6,
-           theme_mode = $7,
-           playable_npc_count = $8,
-           landmark_count = $9
-       WHERE user_id = $10
-         AND profile_id = $11`,
-      [
-        now,
-        authorDisplayName || '玩家',
-        metadata.worldName,
-        metadata.subtitle,
-        metadata.summaryText,
-        metadata.coverImageSrc,
-        metadata.themeMode,
-        metadata.playableNpcCount,
-        metadata.landmarkCount,
-        userId,
-        profileId,
-      ],
-    );
-
-    const entry = await this.findCustomWorldProfileEntry(userId, profileId);
-    if (!entry) {
-      throw new Error('failed to resolve custom world after unpublish');
-    }
-
-    return {
-      entry,
-      entries: await this.listCustomWorldProfiles(userId),
-    };
   }
 
   async listPublishedCustomWorldGallery() {
-    const result = await this.db.query<CustomWorldCardRow>(
-      `SELECT user_id AS "ownerUserId",
-              profile_id AS "profileId",
-              visibility,
-              published_at AS "publishedAt",
-              updated_at AS "updatedAt",
-              author_display_name AS "authorDisplayName",
-              world_name AS "worldName",
-              subtitle,
-              summary_text AS "summaryText",
-              cover_image_src AS "coverImageSrc",
-              theme_mode AS "themeMode",
-              playable_npc_count AS "playableNpcCount",
-              landmark_count AS "landmarkCount"
-       FROM custom_world_profiles
-       WHERE visibility = 'published'
-         AND deleted_at IS NULL
-       ORDER BY published_at DESC, updated_at DESC
-       LIMIT $1`,
-      [MAX_PUBLIC_CUSTOM_WORLD_PROFILES],
-    );
-
-    return result.rows.map((row) => toCustomWorldGalleryCard(row));
+    return this.rpgWorldProfileRepository.listPublishedGallery();
   }
 
   async getPublishedCustomWorldGalleryDetail(
     ownerUserId: string,
     profileId: string,
   ) {
-    const result = await this.db.query<CustomWorldEntryRow>(
-      `SELECT user_id AS "ownerUserId",
-              profile_id AS "profileId",
-              payload_json AS payload,
-              visibility,
-              published_at AS "publishedAt",
-              updated_at AS "updatedAt",
-              author_display_name AS "authorDisplayName",
-              world_name AS "worldName",
-              subtitle,
-              summary_text AS "summaryText",
-              cover_image_src AS "coverImageSrc",
-              theme_mode AS "themeMode",
-              playable_npc_count AS "playableNpcCount",
-              landmark_count AS "landmarkCount"
-       FROM custom_world_profiles
-       WHERE user_id = $1
-         AND profile_id = $2
-         AND visibility = 'published'
-         AND deleted_at IS NULL`,
-      [ownerUserId, profileId],
+    return this.rpgWorldProfileRepository.getPublishedGalleryDetail(
+      ownerUserId,
+      profileId,
     );
-
-    const row = result.rows[0];
-    return row ? toCustomWorldLibraryEntry(row) : null;
   }
 }
diff --git a/server-node/src/routes/customWorldAgent.ts b/server-node/src/routes/customWorldAgent.ts
index aa353e61..7ae5c472 100644
--- a/server-node/src/routes/customWorldAgent.ts
+++ b/server-node/src/routes/customWorldAgent.ts
@@ -67,9 +67,29 @@ const actionSchema = z.discriminatedUnion('action', [
     generatedAnimationSetId: z.string().trim().nullable().optional(),
     animationMap: z.record(z.string(), z.unknown()).nullable().optional(),
   }),
+  z.object({
+    action: z.literal('generate_scene_assets'),
+    sceneIds: z.array(z.string().trim().min(1)).min(1),
+  }),
+  z.object({
+    action: z.literal('sync_scene_assets'),
+    sceneId: z.string().trim().min(1),
+    sceneKind: z.enum(['camp', 'landmark']),
+    imageSrc: z.string().trim().min(1),
+    generatedSceneAssetId: z.string().trim().min(1),
+    generatedScenePrompt: z.string().trim().nullable().optional(),
+    generatedSceneModel: z.string().trim().nullable().optional(),
+  }),
+  z.object({
+    action: z.literal('expand_long_tail'),
+  }),
   z.object({
     action: z.literal('publish_world'),
   }),
+  z.object({
+    action: z.literal('revert_checkpoint'),
+    checkpointId: z.string().trim().min(1),
+  }),
 ]);
 
 function readParam(param: string | string[] | undefined) {
diff --git a/server-node/src/routes/rpg-entry/index.ts b/server-node/src/routes/rpg-entry/index.ts
new file mode 100644
index 00000000..f5e9f05d
--- /dev/null
+++ b/server-node/src/routes/rpg-entry/index.ts
@@ -0,0 +1,11 @@
+export {
+  createRpgEntrySaveRoutes,
+  RPG_ENTRY_SAVE_ARCHIVE_ROUTE_BASE_PATH,
+  RPG_ENTRY_SAVE_ROUTE_BASE_PATH,
+} from './rpgEntrySaveRoutes.js';
+export {
+  createRpgWorldLibraryRoutes,
+  RPG_WORLD_GALLERY_ROUTE_BASE_PATH,
+  RPG_WORLD_LIBRARY_ROUTE_BASE_PATH,
+  RPG_WORLD_WORKS_ROUTE_BASE_PATH,
+} from './rpgWorldLibraryRoutes.js';
diff --git a/server-node/src/routes/rpg-entry/rpgEntrySaveRoutes.ts b/server-node/src/routes/rpg-entry/rpgEntrySaveRoutes.ts
new file mode 100644
index 00000000..52e88c76
--- /dev/null
+++ b/server-node/src/routes/rpg-entry/rpgEntrySaveRoutes.ts
@@ -0,0 +1,151 @@
+import { Router } from 'express';
+import { z } from 'zod';
+
+import type {
+  ProfileSaveArchiveResumeResponse,
+  SavedGameSnapshotInput,
+} from '../../../../packages/shared/src/contracts/runtime.js';
+import type { AppContext } from '../../context.js';
+import { badRequest, notFound } from '../../errors.js';
+import { asyncHandler, sendApiResponse } from '../../http.js';
+import { requireJwtAuth } from '../../middleware/auth.js';
+import { routeMeta } from '../../middleware/routeMeta.js';
+import {
+  hydrateSavedSnapshot,
+  normalizeSavedSnapshotPayload,
+} from '../../modules/runtime/runtimeSnapshotHydration.js';
+
+const saveSnapshotSchema = z.object({
+  gameState: z.unknown(),
+  bottomTab: z.string().trim().min(1),
+  currentStory: z.unknown().nullable().optional().default(null),
+  savedAt: z.string().trim().optional().default(''),
+});
+
+export const RPG_ENTRY_SAVE_ROUTE_BASE_PATH = '/api/runtime/save';
+export const RPG_ENTRY_SAVE_ARCHIVE_ROUTE_BASE_PATH =
+  '/api/runtime/profile/save-archives';
+export const RPG_ENTRY_SAVE_ARCHIVE_LEGACY_ROUTE_BASE_PATH =
+  '/api/profile/save-archives';
+
+function readParam(param: string | string[] | undefined) {
+  return Array.isArray(param) ? param[0]?.trim() || '' : param?.trim() || '';
+}
+
+function routeCompatPaths(path: string) {
+  return [path, path.replace('runtime/', '')] as const;
+}
+
+export function createRpgEntrySaveRoutes(context: AppContext) {
+  const router = Router();
+  const requireAuth = requireJwtAuth(context.config, context.userRepository);
+
+  router.get(
+    '/runtime/save/snapshot',
+    requireAuth,
+    routeMeta({ operation: 'runtime.snapshot.get' }),
+    asyncHandler(async (request, response) => {
+      sendApiResponse(
+        response,
+        hydrateSavedSnapshot(
+          await context.rpgRuntimeSnapshotRepository.getSnapshot(request.userId!),
+        ),
+      );
+    }),
+  );
+
+  router.put(
+    '/runtime/save/snapshot',
+    requireAuth,
+    routeMeta({ operation: 'runtime.snapshot.put' }),
+    asyncHandler(async (request, response) => {
+      const payload = saveSnapshotSchema.parse(
+        request.body,
+      ) as SavedGameSnapshotInput;
+      const normalizedSnapshot = normalizeSavedSnapshotPayload({
+        savedAt: payload.savedAt || new Date().toISOString(),
+        gameState: payload.gameState,
+        bottomTab: payload.bottomTab,
+        currentStory: payload.currentStory ?? null,
+      });
+      sendApiResponse(
+        response,
+        hydrateSavedSnapshot(
+          await context.rpgRuntimeSnapshotRepository.putSnapshot(
+            request.userId!,
+            normalizedSnapshot,
+          ),
+        ),
+      );
+    }),
+  );
+
+  router.delete(
+    '/runtime/save/snapshot',
+    requireAuth,
+    routeMeta({ operation: 'runtime.snapshot.delete' }),
+    asyncHandler(async (request, response) => {
+      await context.rpgRuntimeSnapshotRepository.deleteSnapshot(request.userId!);
+      sendApiResponse(response, { ok: true });
+    }),
+  );
+
+  [
+    '/runtime/profile/save-archives/:worldKey',
+    '/profile/save-archives/:worldKey',
+  ].forEach((path, index) => {
+    router.post(
+      path,
+      requireAuth,
+      routeMeta({
+        operation:
+          index === 0
+            ? 'profile.saveArchives.resume'
+            : 'profile.saveArchives.resume.compat',
+      }),
+      asyncHandler(async (request, response) => {
+        const worldKey = readParam(request.params.worldKey);
+        if (!worldKey) {
+          throw badRequest('worldKey 不能为空');
+        }
+
+        const resumedArchive =
+          await context.rpgSaveArchiveRepository.resumeProfileSaveArchive(
+            request.userId!,
+            worldKey,
+          );
+
+        if (!resumedArchive) {
+          throw notFound('指定存档不存在');
+        }
+
+        sendApiResponse<ProfileSaveArchiveResumeResponse>(response, {
+          entry: resumedArchive.entry,
+          snapshot: hydrateSavedSnapshot(resumedArchive.snapshot)!,
+        });
+      }),
+    );
+  });
+
+  routeCompatPaths('/api/runtime/profile/save-archives').forEach((path, index) => {
+    router.get(
+      path.replace('/api/', '/'),
+      requireAuth,
+      routeMeta({
+        operation:
+          index === 0
+            ? 'profile.saveArchives.list'
+            : 'profile.saveArchives.list.compat',
+      }),
+      asyncHandler(async (request, response) => {
+        sendApiResponse(response, {
+          entries: await context.rpgSaveArchiveRepository.listProfileSaveArchives(
+            request.userId!,
+          ),
+        });
+      }),
+    );
+  });
+
+  return router;
+}
diff --git a/server-node/src/routes/rpg-entry/rpgWorldLibraryRoutes.ts b/server-node/src/routes/rpg-entry/rpgWorldLibraryRoutes.ts
new file mode 100644
index 00000000..5be8d8f0
--- /dev/null
+++ b/server-node/src/routes/rpg-entry/rpgWorldLibraryRoutes.ts
@@ -0,0 +1,338 @@
+import { Router } from 'express';
+import { z } from 'zod';
+
+import type { ListCustomWorldWorksResponse } from '../../../../packages/shared/src/contracts/customWorldAgent.js';
+import type {
+  CustomWorldGalleryDetailResponse,
+  CustomWorldGalleryResponse,
+  CustomWorldLibraryMutationResponse,
+  CustomWorldLibraryResponse,
+} from '../../../../packages/shared/src/contracts/runtime.js';
+import type { AppContext } from '../../context.js';
+import { badRequest, conflict, notFound } from '../../errors.js';
+import { asyncHandler, jsonClone, sendApiResponse } from '../../http.js';
+import { requireJwtAuth } from '../../middleware/auth.js';
+import { routeMeta } from '../../middleware/routeMeta.js';
+import { CustomWorldAgentPublishingService } from '../../services/customWorldAgentPublishingService.js';
+
+const jsonObjectSchema = z.record(z.string(), z.unknown());
+
+const customWorldProfileSchema = z.object({
+  profile: jsonObjectSchema,
+});
+
+export const RPG_WORLD_LIBRARY_ROUTE_BASE_PATH =
+  '/api/runtime/custom-world-library';
+export const RPG_WORLD_GALLERY_ROUTE_BASE_PATH =
+  '/api/runtime/custom-world-gallery';
+export const RPG_WORLD_WORKS_ROUTE_BASE_PATH =
+  '/api/runtime/custom-world/works';
+const AGENT_DRAFT_PROFILE_ID_PREFIX = 'agent-draft-';
+
+function readParam(param: string | string[] | undefined) {
+  return Array.isArray(param) ? param[0]?.trim() || '' : param?.trim() || '';
+}
+
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function resolveAgentSessionIdFromProfileId(profileId: string) {
+  if (!profileId.startsWith(AGENT_DRAFT_PROFILE_ID_PREFIX)) {
+    return null;
+  }
+
+  const sessionId = profileId.slice(AGENT_DRAFT_PROFILE_ID_PREFIX.length).trim();
+  return sessionId || null;
+}
+
+function resolvePublishedWorldName(profile: unknown) {
+  const profileRecord =
+    profile && typeof profile === 'object' && !Array.isArray(profile)
+      ? (profile as Record<string, unknown>)
+      : null;
+
+  return toText(profileRecord?.name) || '当前世界';
+}
+
+async function syncAgentSessionPublishedState(params: {
+  context: AppContext;
+  userId: string;
+  sessionId: string;
+  worldName: string;
+  qualityFindings: Array<{
+    id: string;
+    severity: 'info' | 'warning' | 'blocker';
+    code: string;
+    targetId?: string | null;
+    message: string;
+  }>;
+}) {
+  const publishedQualityFindings = params.qualityFindings.filter(
+    (entry) => entry.severity !== 'blocker',
+  );
+  const publishedState = {
+    stage: 'published' as const,
+    qualityFindings: publishedQualityFindings,
+  };
+
+  await params.context.customWorldAgentSessions.replaceDerivedState(
+    params.userId,
+    params.sessionId,
+    publishedState,
+  );
+  await params.context.customWorldAgentSessions.appendCheckpoint(
+    params.userId,
+    params.sessionId,
+    {
+      label: `发布世界 ${params.worldName}`,
+      snapshot: publishedState,
+    },
+  );
+  await params.context.customWorldAgentSessions.appendMessage(
+    params.userId,
+    params.sessionId,
+    {
+      id: `message-${Date.now().toString(36)}-library-publish`,
+      role: 'assistant',
+      kind: 'action_result',
+      text:
+        publishedQualityFindings.length > 0
+          ? `世界「${params.worldName}」已发布，并保留 ${publishedQualityFindings.length} 条 warning 供后续继续优化。`
+          : `世界「${params.worldName}」已正式发布，可以进入作品库与世界入口。`,
+      createdAt: new Date().toISOString(),
+      relatedOperationId: null,
+    },
+  );
+}
+
+async function resolveAuthDisplayName(context: AppContext, userId: string) {
+  const user = await context.userRepository.findById(userId);
+  if (!user) {
+    throw notFound('user not found');
+  }
+
+  return user.displayName?.trim() || '玩家';
+}
+
+export function createRpgWorldLibraryRoutes(context: AppContext) {
+  const router = Router();
+  const requireAuth = requireJwtAuth(context.config, context.userRepository);
+  const publishingService = new CustomWorldAgentPublishingService(
+    context.rpgWorldProfileRepository,
+  );
+
+  router.get(
+    '/runtime/custom-world-gallery',
+    routeMeta({ operation: 'runtime.customWorldGallery.list' }),
+    asyncHandler(async (_request, response) => {
+      sendApiResponse(response, {
+        entries:
+          await context.rpgWorldLibraryRepository.listPublishedCustomWorldGallery(),
+      } satisfies CustomWorldGalleryResponse);
+    }),
+  );
+
+  router.get(
+    '/runtime/custom-world-gallery/:ownerUserId/:profileId',
+    routeMeta({ operation: 'runtime.customWorldGallery.detail' }),
+    asyncHandler(async (request, response) => {
+      const ownerUserId = readParam(request.params.ownerUserId);
+      const profileId = readParam(request.params.profileId);
+      if (!ownerUserId || !profileId) {
+        throw badRequest('ownerUserId and profileId are required');
+      }
+
+      const entry =
+        await context.rpgWorldLibraryRepository.getPublishedCustomWorldGalleryDetail(
+          ownerUserId,
+          profileId,
+        );
+      if (!entry) {
+        throw notFound('public custom world not found');
+      }
+
+      sendApiResponse(response, {
+        entry,
+      } satisfies CustomWorldGalleryDetailResponse);
+    }),
+  );
+
+  router.get(
+    '/runtime/custom-world/works',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorldWorks.list' }),
+    asyncHandler(async (request, response) => {
+      sendApiResponse<ListCustomWorldWorksResponse>(response, {
+        items: await context.rpgWorldWorkSummaryService.list(request.userId!),
+      });
+    }),
+  );
+
+  router.get(
+    '/runtime/custom-world-library',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorldLibrary.list' }),
+    asyncHandler(async (request, response) => {
+      sendApiResponse(response, {
+        entries: await context.rpgWorldLibraryRepository.listCustomWorldProfiles(
+          request.userId!,
+        ),
+      } satisfies CustomWorldLibraryResponse);
+    }),
+  );
+
+  router.put(
+    '/runtime/custom-world-library/:profileId',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorldLibrary.upsert' }),
+    asyncHandler(async (request, response) => {
+      const profileId = readParam(request.params.profileId);
+      if (!profileId) {
+        throw badRequest('profileId is required');
+      }
+
+      const payload = customWorldProfileSchema.parse(request.body);
+      const authorDisplayName = await resolveAuthDisplayName(
+        context,
+        request.userId!,
+      );
+      sendApiResponse(
+        response,
+        await context.rpgWorldLibraryRepository.upsertCustomWorldProfile(
+          request.userId!,
+          profileId,
+          jsonClone(payload.profile),
+          authorDisplayName,
+        ),
+      );
+    }),
+  );
+
+  router.delete(
+    '/runtime/custom-world-library/:profileId',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorldLibrary.delete' }),
+    asyncHandler(async (request, response) => {
+      const profileId = readParam(request.params.profileId);
+      if (!profileId) {
+        throw badRequest('profileId is required');
+      }
+
+      sendApiResponse(response, {
+        entries: await context.rpgWorldLibraryRepository.deleteCustomWorldProfile(
+          request.userId!,
+          profileId,
+        ),
+      } satisfies CustomWorldLibraryResponse);
+    }),
+  );
+
+  router.post(
+    '/runtime/custom-world-library/:profileId/publish',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorldLibrary.publish' }),
+    asyncHandler(async (request, response) => {
+      const profileId = readParam(request.params.profileId);
+      if (!profileId) {
+        throw badRequest('profileId is required');
+      }
+
+      const authorDisplayName = await resolveAuthDisplayName(
+        context,
+        request.userId!,
+      );
+      const agentSessionId = resolveAgentSessionIdFromProfileId(profileId);
+      if (agentSessionId) {
+        const agentSession = await context.customWorldAgentSessions.get(
+          request.userId!,
+          agentSessionId,
+        );
+
+        if (agentSession) {
+          try {
+            publishingService.buildPublishReadiness({
+              sessionId: agentSessionId,
+              draftProfile: agentSession.draftProfile,
+              qualityFindings: agentSession.qualityFindings,
+            });
+          } catch (error) {
+            throw conflict(
+              error instanceof Error
+                ? error.message
+                : '当前世界还没有通过发布校验。',
+            );
+          }
+
+          const publishResult = await publishingService.publishSessionDraft({
+            userId: request.userId!,
+            authorDisplayName,
+            sessionId: agentSessionId,
+            draftProfile:
+              (agentSession.draftProfile ?? {}) as Record<string, unknown>,
+            qualityFindings: agentSession.qualityFindings,
+          });
+          await syncAgentSessionPublishedState({
+            context,
+            userId: request.userId!,
+            sessionId: agentSessionId,
+            worldName: resolvePublishedWorldName(publishResult.publishedProfile),
+            qualityFindings: agentSession.qualityFindings,
+          });
+          sendApiResponse(
+            response,
+            publishResult.mutation satisfies CustomWorldLibraryMutationResponse,
+          );
+          return;
+        }
+      }
+
+      const mutation = await context.rpgWorldLibraryRepository.publishCustomWorldProfile(
+        request.userId!,
+        profileId,
+        authorDisplayName,
+      );
+      if (!mutation) {
+        throw notFound('custom world not found');
+      }
+
+      sendApiResponse(
+        response,
+        mutation satisfies CustomWorldLibraryMutationResponse,
+      );
+    }),
+  );
+
+  router.post(
+    '/runtime/custom-world-library/:profileId/unpublish',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorldLibrary.unpublish' }),
+    asyncHandler(async (request, response) => {
+      const profileId = readParam(request.params.profileId);
+      if (!profileId) {
+        throw badRequest('profileId is required');
+      }
+
+      const authorDisplayName = await resolveAuthDisplayName(
+        context,
+        request.userId!,
+      );
+      const mutation =
+        await context.rpgWorldLibraryRepository.unpublishCustomWorldProfile(
+          request.userId!,
+          profileId,
+          authorDisplayName,
+        );
+      if (!mutation) {
+        throw notFound('custom world not found');
+      }
+
+      sendApiResponse(
+        response,
+        mutation satisfies CustomWorldLibraryMutationResponse,
+      );
+    }),
+  );
+
+  return router;
+}
diff --git a/server-node/src/routes/rpg-profile/index.ts b/server-node/src/routes/rpg-profile/index.ts
new file mode 100644
index 00000000..b1d2cc8f
--- /dev/null
+++ b/server-node/src/routes/rpg-profile/index.ts
@@ -0,0 +1,4 @@
+export {
+  createRpgProfileRoutes,
+  RPG_PROFILE_ROUTE_BASE_PATH,
+} from './rpgProfileRoutes.js';
diff --git a/server-node/src/routes/rpg-profile/rpgProfileRoutes.ts b/server-node/src/routes/rpg-profile/rpgProfileRoutes.ts
new file mode 100644
index 00000000..e86076b5
--- /dev/null
+++ b/server-node/src/routes/rpg-profile/rpgProfileRoutes.ts
@@ -0,0 +1,214 @@
+import { Router } from 'express';
+import { z } from 'zod';
+
+import type {
+  PlatformBrowseHistoryBatchSyncRequest,
+  PlatformBrowseHistoryResponse,
+  PlatformBrowseHistoryWriteEntry,
+  ProfileDashboardSummary,
+  ProfilePlayStatsResponse,
+  ProfileWalletLedgerResponse,
+  RuntimeSettings,
+} from '../../../../packages/shared/src/contracts/runtime.js';
+import { PLATFORM_THEMES } from '../../../../packages/shared/src/contracts/runtime.js';
+import type { AppContext } from '../../context.js';
+import { asyncHandler, sendApiResponse } from '../../http.js';
+import { requireJwtAuth } from '../../middleware/auth.js';
+import { routeMeta } from '../../middleware/routeMeta.js';
+
+const platformBrowseHistoryEntrySchema = z.object({
+  ownerUserId: z.string().trim().min(1),
+  profileId: z.string().trim().min(1),
+  worldName: z.string().trim().min(1),
+  subtitle: z.string().trim().optional().default(''),
+  summaryText: z.string().trim().optional().default(''),
+  coverImageSrc: z.string().trim().nullable().optional().default(null),
+  themeMode: z.string().trim().optional().default('mythic'),
+  authorDisplayName: z.string().trim().optional().default('玩家'),
+  visitedAt: z.string().trim().optional().default(''),
+});
+
+const platformBrowseHistoryBatchSchema = z.object({
+  entries: z.array(platformBrowseHistoryEntrySchema).max(100),
+});
+
+const settingsSchema = z.object({
+  musicVolume: z.number().min(0).max(1),
+  platformTheme: z.enum(PLATFORM_THEMES),
+});
+
+export const RPG_PROFILE_ROUTE_BASE_PATH = '/api/runtime/profile';
+export const RPG_PROFILE_LEGACY_ROUTE_BASE_PATH = '/api/profile';
+
+function routeCompatPaths(path: string) {
+  return [path, path.replace('runtime/', '')] as const;
+}
+
+export function createRpgProfileRoutes(context: AppContext) {
+  const router = Router();
+  const requireAuth = requireJwtAuth(context.config, context.userRepository);
+
+  routeCompatPaths('/api/runtime/profile/dashboard').forEach((path, index) => {
+    router.get(
+      path.replace('/api/', '/'),
+      requireAuth,
+      routeMeta({
+        operation:
+          index === 0
+            ? 'profile.dashboard.get'
+            : 'profile.dashboard.get.compat',
+      }),
+      asyncHandler(async (request, response) => {
+        sendApiResponse<ProfileDashboardSummary>(
+          response,
+          await context.rpgProfileDashboardRepository.getProfileDashboard(
+            request.userId!,
+          ),
+        );
+      }),
+    );
+  });
+
+  routeCompatPaths('/api/runtime/profile/wallet-ledger').forEach((path, index) => {
+    router.get(
+      path.replace('/api/', '/'),
+      requireAuth,
+      routeMeta({
+        operation:
+          index === 0
+            ? 'profile.walletLedger.list'
+            : 'profile.walletLedger.list.compat',
+      }),
+      asyncHandler(async (request, response) => {
+        sendApiResponse<ProfileWalletLedgerResponse>(response, {
+          entries:
+            await context.rpgProfileDashboardRepository.listProfileWalletLedger(
+              request.userId!,
+            ),
+        });
+      }),
+    );
+  });
+
+  routeCompatPaths('/api/runtime/profile/play-stats').forEach((path, index) => {
+    router.get(
+      path.replace('/api/', '/'),
+      requireAuth,
+      routeMeta({
+        operation:
+          index === 0
+            ? 'profile.playStats.get'
+            : 'profile.playStats.get.compat',
+      }),
+      asyncHandler(async (request, response) => {
+        sendApiResponse<ProfilePlayStatsResponse>(
+          response,
+          await context.rpgProfileDashboardRepository.getProfilePlayStats(
+            request.userId!,
+          ),
+        );
+      }),
+    );
+  });
+
+  routeCompatPaths('/api/runtime/profile/browse-history').forEach((path, index) => {
+    router.get(
+      path.replace('/api/', '/'),
+      requireAuth,
+      routeMeta({
+        operation:
+          index === 0
+            ? 'profile.browseHistory.list'
+            : 'profile.browseHistory.list.compat',
+      }),
+      asyncHandler(async (request, response) => {
+        sendApiResponse<PlatformBrowseHistoryResponse>(response, {
+          entries: await context.rpgBrowseHistoryRepository.listPlatformBrowseHistory(
+            request.userId!,
+          ),
+        });
+      }),
+    );
+
+    router.post(
+      path.replace('/api/', '/'),
+      requireAuth,
+      routeMeta({
+        operation:
+          index === 0
+            ? 'profile.browseHistory.upsert'
+            : 'profile.browseHistory.upsert.compat',
+      }),
+      asyncHandler(async (request, response) => {
+        const rawBody =
+          request.body && typeof request.body === 'object' ? request.body : {};
+        const payload = (
+          'entries' in rawBody
+            ? platformBrowseHistoryBatchSchema.parse(rawBody)
+            : platformBrowseHistoryEntrySchema.parse(rawBody)
+        ) as
+          | PlatformBrowseHistoryBatchSyncRequest
+          | PlatformBrowseHistoryWriteEntry;
+
+        const entries = 'entries' in payload ? payload.entries : [payload];
+
+        sendApiResponse<PlatformBrowseHistoryResponse>(response, {
+          entries:
+            await context.rpgBrowseHistoryRepository.upsertPlatformBrowseHistoryEntries(
+              request.userId!,
+              entries,
+            ),
+        });
+      }),
+    );
+
+    router.delete(
+      path.replace('/api/', '/'),
+      requireAuth,
+      routeMeta({
+        operation:
+          index === 0
+            ? 'profile.browseHistory.clear'
+            : 'profile.browseHistory.clear.compat',
+      }),
+      asyncHandler(async (request, response) => {
+        await context.rpgBrowseHistoryRepository.clearPlatformBrowseHistory(
+          request.userId!,
+        );
+        sendApiResponse<PlatformBrowseHistoryResponse>(response, {
+          entries: [],
+        });
+      }),
+    );
+  });
+
+  router.get(
+    '/api/runtime/settings'.replace('/api/', '/'),
+    requireAuth,
+    routeMeta({ operation: 'runtime.settings.get' }),
+    asyncHandler(async (request, response) => {
+      sendApiResponse(
+        response,
+        await context.rpgProfileDashboardRepository.getSettings(request.userId!),
+      );
+    }),
+  );
+
+  router.put(
+    '/api/runtime/settings'.replace('/api/', '/'),
+    requireAuth,
+    routeMeta({ operation: 'runtime.settings.put' }),
+    asyncHandler(async (request, response) => {
+      const payload = settingsSchema.parse(request.body) as RuntimeSettings;
+      sendApiResponse(
+        response,
+        await context.rpgProfileDashboardRepository.putSettings(
+          request.userId!,
+          payload,
+        ),
+      );
+    }),
+  );
+
+  return router;
+}
diff --git a/server-node/src/routes/rpg-runtime/index.ts b/server-node/src/routes/rpg-runtime/index.ts
new file mode 100644
index 00000000..fe2a5b4f
--- /dev/null
+++ b/server-node/src/routes/rpg-runtime/index.ts
@@ -0,0 +1,8 @@
+export {
+  createRpgRuntimeAiAssistRoutes,
+  RPG_RUNTIME_AI_ASSIST_ROUTE_BASE_PATH,
+} from './rpgRuntimeAiAssistRoutes.js';
+export {
+  createRpgRuntimeStoryRoutes,
+  RPG_RUNTIME_STORY_ROUTE_BASE_PATH,
+} from './rpgRuntimeStoryRoutes.js';
diff --git a/server-node/src/routes/rpg-runtime/rpgRuntimeAiAssistRoutes.ts b/server-node/src/routes/rpg-runtime/rpgRuntimeAiAssistRoutes.ts
new file mode 100644
index 00000000..06973c12
--- /dev/null
+++ b/server-node/src/routes/rpg-runtime/rpgRuntimeAiAssistRoutes.ts
@@ -0,0 +1,370 @@
+import { Router } from 'express';
+import { z } from 'zod';
+
+import type {
+  QuestGenerationRequest,
+  RuntimeItemIntentRequest,
+} from '../../../../packages/shared/src/contracts/rpgRuntimeQuestAssist.js';
+import type {
+  CharacterChatReplyRequest,
+  CharacterChatSuggestionsRequest,
+  CharacterChatSummaryRequest,
+  NpcChatDialogueRequest,
+  NpcChatTurnRequest,
+  NpcRecruitDialogueRequest,
+  StoryRequestPayload,
+} from '../../../../packages/shared/src/contracts/rpgRuntimeChat.js';
+import type { GenerateCustomWorldProfileInput } from '../../../../packages/shared/src/contracts/runtime.js';
+import type { AppContext } from '../../context.js';
+import { asyncHandler, sendApiResponse } from '../../http.js';
+import { requireJwtAuth } from '../../middleware/auth.js';
+import { routeMeta } from '../../middleware/routeMeta.js';
+import {
+  generateCharacterChatSuggestionsFromOrchestrator,
+  generateCharacterChatSummaryFromOrchestrator,
+  streamCharacterChatReplyFromOrchestrator,
+  streamNpcChatDialogueFromOrchestrator,
+  streamNpcChatTurnFromOrchestrator,
+  streamNpcRecruitDialogueFromOrchestrator,
+} from '../../modules/ai/chatOrchestrator.js';
+import { generateCustomWorldProfileFromOrchestrator } from '../../modules/ai/customWorldOrchestrator.js';
+import {
+  characterChatReplyRequestSchema,
+  characterChatSuggestionsRequestSchema,
+  characterChatSummaryRequestSchema,
+  npcChatDialogueRequestSchema,
+  npcChatTurnRequestSchema,
+  npcRecruitDialogueRequestSchema,
+} from '../../services/chatService.js';
+import {
+  customWorldCoverImageSchema,
+  customWorldCoverUploadSchema,
+  generateCustomWorldCoverImage,
+  uploadCustomWorldCoverImage,
+} from '../../services/customWorldCoverAssetService.js';
+import { generateCustomWorldEntity } from '../../services/customWorldEntityGenerationService.js';
+import { generateSceneNpcForLandmark } from '../../services/customWorldSceneNpcGenerationService.js';
+import { generateQuestForNpcEncounter } from '../../services/questService.js';
+import { generateRuntimeItemIntents } from '../../services/runtimeItemService.js';
+import {
+  generateSceneImage,
+  sceneImageSchema,
+} from '../../services/sceneImageService.js';
+import {
+  generateHighQualityInitialStory,
+  generateHighQualityNextStory,
+  parseStoryRequest,
+} from '../../services/storyService.js';
+
+const jsonObjectSchema = z.record(z.string(), z.unknown());
+
+const customWorldProfileGenerationSchema = z.object({
+  settingText: z.string().trim().min(1),
+  creatorIntent: jsonObjectSchema.nullish(),
+  generationMode: z.enum(['fast', 'full']).optional(),
+});
+
+const customWorldSceneNpcSchema = z.object({
+  profile: jsonObjectSchema,
+  landmarkId: z.string().trim().min(1),
+});
+
+const customWorldEntitySchema = z.object({
+  profile: jsonObjectSchema,
+  kind: z.enum(['playable', 'story', 'landmark']),
+});
+
+const runtimeItemIntentSchema = z.object({
+  context: jsonObjectSchema,
+  plans: z.array(jsonObjectSchema),
+});
+
+const questGenerationSchema = z.object({
+  state: jsonObjectSchema,
+  encounter: jsonObjectSchema,
+});
+
+const llmProxySchema = jsonObjectSchema;
+
+export const RPG_RUNTIME_AI_ASSIST_ROUTE_BASE_PATH = '/api/runtime';
+
+export function createRpgRuntimeAiAssistRoutes(context: AppContext) {
+  const router = Router();
+  const requireAuth = requireJwtAuth(context.config, context.userRepository);
+  const handleCustomWorldEntityGeneration = asyncHandler(
+    async (request, response) => {
+      const payload = customWorldEntitySchema.parse(request.body) as {
+        profile: Record<string, unknown>;
+        kind: 'playable' | 'story' | 'landmark';
+      };
+      sendApiResponse(
+        response,
+        await generateCustomWorldEntity(context.llmClient, payload),
+      );
+    },
+  );
+  const handleCustomWorldSceneNpcGeneration = asyncHandler(
+    async (request, response) => {
+      const payload = customWorldSceneNpcSchema.parse(request.body) as {
+        profile: Record<string, unknown>;
+        landmarkId: string;
+      };
+      sendApiResponse(response, {
+        npc: await generateSceneNpcForLandmark(context.llmClient, payload),
+      });
+    },
+  );
+
+  router.post(
+    '/llm/chat/completions',
+    requireAuth,
+    routeMeta({ operation: 'runtime.llm.chatCompletionsProxy' }),
+    asyncHandler(async (request, response) => {
+      const body = llmProxySchema.parse(request.body);
+      await context.llmClient.forwardCompletion(request, body, response);
+    }),
+  );
+
+  router.post(
+    '/custom-world/cover-image',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorld.coverImage' }),
+    asyncHandler(async (request, response) => {
+      const payload = customWorldCoverImageSchema.parse(request.body);
+      sendApiResponse(response, await generateCustomWorldCoverImage(context, payload));
+    }),
+  );
+
+  router.post(
+    '/custom-world/cover-upload',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorld.coverUpload' }),
+    asyncHandler(async (request, response) => {
+      const payload = customWorldCoverUploadSchema.parse(request.body);
+      sendApiResponse(response, await uploadCustomWorldCoverImage(context, payload));
+    }),
+  );
+
+  router.post(
+    '/custom-world/scene-image',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorld.sceneImage' }),
+    asyncHandler(async (request, response) => {
+      const payload = sceneImageSchema.parse(request.body);
+      sendApiResponse(response, await generateSceneImage(context, payload));
+    }),
+  );
+
+  router.post(
+    '/custom-world/entity',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorld.entity' }),
+    handleCustomWorldEntityGeneration,
+  );
+
+  router.post(
+    '/runtime/custom-world/entity',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorld.entity.compat' }),
+    handleCustomWorldEntityGeneration,
+  );
+
+  router.post(
+    '/custom-world/scene-npc',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorld.sceneNpc' }),
+    handleCustomWorldSceneNpcGeneration,
+  );
+
+  router.post(
+    '/runtime/custom-world/scene-npc',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorld.sceneNpc.compat' }),
+    handleCustomWorldSceneNpcGeneration,
+  );
+
+  router.post(
+    '/runtime/custom-world/profile',
+    requireAuth,
+    routeMeta({ operation: 'runtime.customWorld.profile' }),
+    asyncHandler(async (request, response) => {
+      const payload = customWorldProfileGenerationSchema.parse(
+        request.body,
+      ) as GenerateCustomWorldProfileInput;
+      sendApiResponse(
+        response,
+        await generateCustomWorldProfileFromOrchestrator(
+          context.llmClient,
+          payload,
+        ),
+      );
+    }),
+  );
+
+  router.post(
+    '/runtime/story/initial',
+    requireAuth,
+    routeMeta({ operation: 'runtime.story.initial' }),
+    asyncHandler(async (request, response) => {
+      const payload = parseStoryRequest(request.body) as StoryRequestPayload;
+      sendApiResponse(
+        response,
+        await generateHighQualityInitialStory(context.llmClient, payload),
+      );
+    }),
+  );
+
+  router.post(
+    '/runtime/story/continue',
+    requireAuth,
+    routeMeta({ operation: 'runtime.story.continue' }),
+    asyncHandler(async (request, response) => {
+      const payload = parseStoryRequest(request.body) as StoryRequestPayload;
+      sendApiResponse(
+        response,
+        await generateHighQualityNextStory(context.llmClient, payload),
+      );
+    }),
+  );
+
+  router.post(
+    '/runtime/chat/character/suggestions',
+    requireAuth,
+    routeMeta({ operation: 'runtime.chat.character.suggestions' }),
+    asyncHandler(async (request, response) => {
+      const payload = characterChatSuggestionsRequestSchema.parse(
+        request.body,
+      ) as CharacterChatSuggestionsRequest;
+      sendApiResponse(response, {
+        text: await generateCharacterChatSuggestionsFromOrchestrator(
+          context.llmClient,
+          payload,
+        ),
+      });
+    }),
+  );
+
+  router.post(
+    '/runtime/chat/character/summary',
+    requireAuth,
+    routeMeta({ operation: 'runtime.chat.character.summary' }),
+    asyncHandler(async (request, response) => {
+      const payload = characterChatSummaryRequestSchema.parse(
+        request.body,
+      ) as CharacterChatSummaryRequest;
+      sendApiResponse(response, {
+        text: await generateCharacterChatSummaryFromOrchestrator(
+          context.llmClient,
+          payload,
+        ),
+      });
+    }),
+  );
+
+  router.post(
+    '/runtime/chat/character/reply/stream',
+    requireAuth,
+    routeMeta({ operation: 'runtime.chat.character.replyStream' }),
+    asyncHandler(async (request, response) => {
+      const payload = characterChatReplyRequestSchema.parse(
+        request.body,
+      ) as CharacterChatReplyRequest;
+      await streamCharacterChatReplyFromOrchestrator(context.llmClient, {
+        request,
+        response,
+        payload,
+      });
+    }),
+  );
+
+  router.post(
+    '/runtime/chat/npc/dialogue/stream',
+    requireAuth,
+    routeMeta({ operation: 'runtime.chat.npc.dialogueStream' }),
+    asyncHandler(async (request, response) => {
+      const payload = npcChatDialogueRequestSchema.parse(
+        request.body,
+      ) as NpcChatDialogueRequest;
+      await streamNpcChatDialogueFromOrchestrator(context.llmClient, {
+        request,
+        response,
+        payload,
+      });
+    }),
+  );
+
+  router.post(
+    '/runtime/chat/npc/turn/stream',
+    requireAuth,
+    routeMeta({ operation: 'runtime.chat.npc.turnStream' }),
+    asyncHandler(async (request, response) => {
+      const payload = npcChatTurnRequestSchema.parse(
+        request.body,
+      ) as NpcChatTurnRequest;
+      await streamNpcChatTurnFromOrchestrator(context.llmClient, {
+        request,
+        response,
+        payload,
+      });
+    }),
+  );
+
+  router.post(
+    '/runtime/chat/npc/recruit/stream',
+    requireAuth,
+    routeMeta({ operation: 'runtime.chat.npc.recruitStream' }),
+    asyncHandler(async (request, response) => {
+      const payload = npcRecruitDialogueRequestSchema.parse(
+        request.body,
+      ) as NpcRecruitDialogueRequest;
+      await streamNpcRecruitDialogueFromOrchestrator(context.llmClient, {
+        request,
+        response,
+        payload,
+      });
+    }),
+  );
+
+  router.post(
+    '/runtime/items/runtime-intent',
+    requireAuth,
+    routeMeta({ operation: 'runtime.items.intent' }),
+    asyncHandler(async (request, response) => {
+      const payload = runtimeItemIntentSchema.parse(
+        request.body,
+      ) as RuntimeItemIntentRequest;
+      sendApiResponse(response, {
+        intents: await generateRuntimeItemIntents(context.llmClient, payload),
+      });
+    }),
+  );
+
+  router.post(
+    '/runtime/quests/generate',
+    requireAuth,
+    routeMeta({ operation: 'runtime.quests.generate' }),
+    asyncHandler(async (request, response) => {
+      const payload = questGenerationSchema.parse(
+        request.body,
+      ) as QuestGenerationRequest;
+      sendApiResponse(
+        response,
+        await generateQuestForNpcEncounter(context.llmClient, payload),
+      );
+    }),
+  );
+
+  router.get(
+    '/ws/health',
+    requireAuth,
+    routeMeta({ operation: 'runtime.ws.health' }),
+    (_request, response) => {
+      sendApiResponse(response, {
+        ok: true,
+        message: 'websocket routes reserved for future real-time support',
+      });
+    },
+  );
+
+  return router;
+}
diff --git a/server-node/src/modules/story/storyActionRoutes.test.ts b/server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.test.ts
similarity index 91%
rename from server-node/src/modules/story/storyActionRoutes.test.ts
rename to server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.test.ts
index ea59e137..2596303d 100644
--- a/server-node/src/modules/story/storyActionRoutes.test.ts
+++ b/server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.test.ts
@@ -8,10 +8,10 @@ import test from 'node:test';
 import { createApp } from '../../app.ts';
 import { buildQuestForEncounter } from '../../bridges/legacyQuestProgressBridge.js';
 import type { AppConfig } from '../../config.ts';
+import { applyQuestSignal } from '../../modules/quest/questProgressionService.ts';
 import { createAppContext } from '../../server.ts';
 import { createTestPlayerCharacter } from '../../testFixtures/runtimeCharacter.ts';
 import { httpRequest, type TestRequestInit } from '../../testHttp.ts';
-import { applyQuestSignal } from '../quest/questProgressionService.ts';
 
 function createTestConfig(testName: string): AppConfig {
   const tempRoot = fs.mkdtempSync(
@@ -1886,6 +1886,243 @@ test('runtime story actions resolve equipment_equip and persist updated loadout'
   });
 });
 
+test('runtime story actions resolve npc_recruit directly on the server', async () => {
+  await withTestServer('task6-recruit-direct', async ({ baseUrl }) => {
+    const entry = await authEntry(baseUrl, 'story_task6_recruit', 'secret123');
+
+    await putSnapshot(
+      baseUrl,
+      entry.token,
+      createTask6GameState({
+        currentEncounter: {
+          kind: 'npc',
+          id: 'npc_guard_01',
+          npcName: '守桥人',
+          npcDescription: '在桥口驻守多年的旧识',
+          context: '桥口守卫',
+          characterId: 'bridge-guard',
+        },
+        npcInteractionActive: true,
+        npcStates: {
+          npc_guard_01: {
+            affinity: 64,
+            chattedCount: 2,
+            helpUsed: false,
+            giftsGiven: 0,
+            inventory: [],
+            recruited: false,
+          },
+        },
+        companions: [],
+        roster: [],
+      }),
+    );
+
+    const response = await httpRequest(
+      `${baseUrl}/api/runtime/story/actions/resolve`,
+      withBearer(entry.token, {
+        method: 'POST',
+        body: JSON.stringify({
+          sessionId: 'runtime-main',
+          clientVersion: 0,
+          action: {
+            type: 'story_choice',
+            functionId: 'npc_recruit',
+            payload: {
+              preludeText:
+                '守桥人：你既然想清楚了，那我就跟你走这一程。',
+            },
+          },
+        }),
+      }),
+    );
+    const payload = (await response.json()) as {
+      presentation: {
+        storyText: string;
+      };
+      snapshot: {
+        gameState: {
+          currentEncounter: unknown;
+          npcInteractionActive: boolean;
+          companions: Array<{
+            npcId: string;
+            characterId: string;
+            joinedAtAffinity: number;
+            maxHp: number;
+            maxMana: number;
+          }>;
+          roster: Array<unknown>;
+          npcStates: {
+            npc_guard_01: {
+              recruited: boolean;
+              firstMeaningfulContactResolved: boolean;
+            };
+          };
+        };
+      };
+      viewModel: {
+        companions: Array<{
+          npcId: string;
+        }>;
+      };
+    };
+
+    assert.equal(response.status, 200);
+    assert.match(payload.presentation.storyText, /守桥人/u);
+    assert.equal(payload.snapshot.gameState.currentEncounter, null);
+    assert.equal(payload.snapshot.gameState.npcInteractionActive, false);
+    assert.equal(payload.snapshot.gameState.companions.length, 1);
+    assert.equal(payload.snapshot.gameState.companions[0]?.npcId, 'npc_guard_01');
+    assert.equal(
+      payload.snapshot.gameState.companions[0]?.joinedAtAffinity,
+      64,
+    );
+    assert.ok((payload.snapshot.gameState.companions[0]?.maxHp ?? 0) > 0);
+    assert.ok((payload.snapshot.gameState.companions[0]?.maxMana ?? 0) > 0);
+    assert.deepEqual(payload.snapshot.gameState.roster, []);
+    assert.equal(
+      payload.snapshot.gameState.npcStates.npc_guard_01.recruited,
+      true,
+    );
+    assert.equal(
+      payload.snapshot.gameState.npcStates.npc_guard_01
+        .firstMeaningfulContactResolved,
+      true,
+    );
+    assert.equal(payload.viewModel.companions[0]?.npcId, 'npc_guard_01');
+  });
+});
+
+test('runtime story actions resolve npc_recruit with full-party replacement on the server', async () => {
+  await withTestServer('task6-recruit-swap', async ({ baseUrl }) => {
+    const entry = await authEntry(
+      baseUrl,
+      'story_task6_recruit_swap',
+      'secret123',
+    );
+
+    await putSnapshot(
+      baseUrl,
+      entry.token,
+      createTask6GameState({
+        currentEncounter: {
+          kind: 'npc',
+          id: 'npc_scout_02',
+          npcName: '追迹人',
+          npcDescription: '擅长沿痕追人的同路者',
+          context: '山道追迹',
+          characterId: 'trail-scout',
+        },
+        npcInteractionActive: true,
+        npcStates: {
+          npc_scout_02: {
+            affinity: 71,
+            chattedCount: 3,
+            helpUsed: false,
+            giftsGiven: 0,
+            inventory: [],
+            recruited: false,
+          },
+          npc_old_guard: {
+            affinity: 48,
+            chattedCount: 1,
+            helpUsed: false,
+            giftsGiven: 0,
+            inventory: [],
+            recruited: true,
+          },
+          npc_old_medic: {
+            affinity: 55,
+            chattedCount: 1,
+            helpUsed: false,
+            giftsGiven: 0,
+            inventory: [],
+            recruited: true,
+          },
+        },
+        companions: [
+          {
+            npcId: 'npc_old_guard',
+            characterId: 'old-guard',
+            joinedAtAffinity: 48,
+            hp: 180,
+            maxHp: 180,
+            mana: 999,
+            maxMana: 999,
+            skillCooldowns: {},
+            animationState: 'idle',
+            actionMode: 'idle',
+            offsetX: 0,
+            offsetY: 0,
+            transitionMs: 0,
+          },
+          {
+            npcId: 'npc_old_medic',
+            characterId: 'old-medic',
+            joinedAtAffinity: 55,
+            hp: 170,
+            maxHp: 170,
+            mana: 999,
+            maxMana: 999,
+            skillCooldowns: {},
+            animationState: 'idle',
+            actionMode: 'idle',
+            offsetX: 0,
+            offsetY: 0,
+            transitionMs: 0,
+          },
+        ],
+        roster: [],
+      }),
+    );
+
+    const response = await httpRequest(
+      `${baseUrl}/api/runtime/story/actions/resolve`,
+      withBearer(entry.token, {
+        method: 'POST',
+        body: JSON.stringify({
+          sessionId: 'runtime-main',
+          clientVersion: 0,
+          action: {
+            type: 'story_choice',
+            functionId: 'npc_recruit',
+            payload: {
+              releaseNpcId: 'npc_old_guard',
+              preludeText:
+                '追迹人：如果你真要带我同行，那就先把你队里的位置理顺。',
+            },
+          },
+        }),
+      }),
+    );
+    const payload = (await response.json()) as {
+      snapshot: {
+        gameState: {
+          companions: Array<{ npcId: string }>;
+          roster: Array<{ npcId: string }>;
+        };
+      };
+      viewModel: {
+        companions: Array<{ npcId: string }>;
+      };
+    };
+
+    assert.equal(response.status, 200);
+    assert.deepEqual(
+      payload.snapshot.gameState.companions.map((companion) => companion.npcId),
+      ['npc_scout_02', 'npc_old_medic'],
+    );
+    assert.deepEqual(
+      payload.snapshot.gameState.roster.map((companion) => companion.npcId),
+      ['npc_old_guard'],
+    );
+    assert.deepEqual(
+      payload.viewModel.companions.map((companion) => companion.npcId),
+      ['npc_scout_02', 'npc_old_medic'],
+    );
+  });
+});
+
 test('runtime story actions resolve npc_trade buy transactions on the server', async () => {
   await withTestServer('task6-trade-buy', async ({ baseUrl }) => {
     const entry = await authEntry(
diff --git a/server-node/src/modules/story/storyActionRoutes.ts b/server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts
similarity index 80%
rename from server-node/src/modules/story/storyActionRoutes.ts
rename to server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts
index 857e0f21..f9012657 100644
--- a/server-node/src/modules/story/storyActionRoutes.ts
+++ b/server-node/src/routes/rpg-runtime/rpgRuntimeStoryRoutes.ts
@@ -4,16 +4,14 @@ import { z } from 'zod';
 import type {
   RuntimeStoryActionRequest,
   RuntimeStoryStateRequest,
-} from '../../../../packages/shared/src/contracts/story.js';
+} from '../../../../packages/shared/src/contracts/rpgRuntimeStoryState.js';
 import type { AppContext } from '../../context.js';
 import { badRequest } from '../../errors.js';
 import { asyncHandler, sendApiResponse } from '../../http.js';
 import { requireJwtAuth } from '../../middleware/auth.js';
 import { routeMeta } from '../../middleware/routeMeta.js';
-import {
-  getRuntimeStoryState,
-  resolveRuntimeStoryAction,
-} from './storyActionService.js';
+import { getRuntimeStoryState } from '../../modules/rpg-runtime-story/RpgRuntimeStoryStateService.js';
+import { resolveRuntimeStoryAction } from '../../modules/rpg-runtime-story/RpgRuntimeStoryActionService.js';
 
 const actionPayloadSchema = z.record(z.string(), z.unknown());
 
@@ -35,7 +33,9 @@ const runtimeStoryStateResolveSchema = z.object({
   snapshot: z.unknown().optional(),
 });
 
-export function createStoryActionRoutes(context: AppContext) {
+export const RPG_RUNTIME_STORY_ROUTE_BASE_PATH = '/api/runtime/story';
+
+export function createRpgRuntimeStoryRoutes(context: AppContext) {
   const router = Router();
   const requireAuth = requireJwtAuth(context.config, context.userRepository);
 
@@ -51,7 +51,7 @@ export function createStoryActionRoutes(context: AppContext) {
       sendApiResponse(
         response,
         await resolveRuntimeStoryAction({
-          runtimeRepository: context.runtimeRepository,
+          snapshotRepository: context.rpgRuntimeSnapshotRepository,
           llmClient: context.llmClient,
           userId: request.userId!,
           request: payload,
@@ -72,7 +72,7 @@ export function createStoryActionRoutes(context: AppContext) {
       sendApiResponse(
         response,
         await getRuntimeStoryState({
-          runtimeRepository: context.runtimeRepository,
+          snapshotRepository: context.rpgRuntimeSnapshotRepository,
           userId: request.userId!,
           sessionId,
         }),
@@ -90,7 +90,7 @@ export function createStoryActionRoutes(context: AppContext) {
       sendApiResponse(
         response,
         await getRuntimeStoryState({
-          runtimeRepository: context.runtimeRepository,
+          snapshotRepository: context.rpgRuntimeSnapshotRepository,
           userId: request.userId!,
           sessionId: payload.sessionId,
           clientVersion: payload.clientVersion,
diff --git a/server-node/src/routes/rpgRouteBoundaries.test.ts b/server-node/src/routes/rpgRouteBoundaries.test.ts
new file mode 100644
index 00000000..820e317e
--- /dev/null
+++ b/server-node/src/routes/rpgRouteBoundaries.test.ts
@@ -0,0 +1,524 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import type { AddressInfo } from 'node:net';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+
+import { createApp } from '../app.ts';
+import type { AppConfig } from '../config.ts';
+import { createAppContext } from '../server.ts';
+import { httpRequest, type TestRequestInit } from '../testHttp.ts';
+
+function createTestConfig(testName: string): AppConfig {
+  const tempRoot = fs.mkdtempSync(
+    path.join(os.tmpdir(), `genarrative-rpg-routes-${testName}-`),
+  );
+
+  return {
+    nodeEnv: 'test',
+    projectRoot: tempRoot,
+    publicDir: path.join(tempRoot, 'public'),
+    logsDir: path.join(tempRoot, 'logs'),
+    dataDir: path.join(tempRoot, 'data'),
+    rawEnv: {},
+    databaseUrl: `pg-mem://genarrative-rpg-routes-${testName}`,
+    serverAddr: ':0',
+    logLevel: 'silent',
+    editorApiEnabled: true,
+    assetsApiEnabled: true,
+    jwtSecret: 'test-secret',
+    jwtExpiresIn: '7d',
+    jwtIssuer: 'genarrative-rpg-routes-test',
+    llm: {
+      baseUrl: 'https://example.invalid',
+      apiKey: '',
+      model: 'test-model',
+    },
+    dashScope: {
+      baseUrl: 'https://example.invalid',
+      apiKey: '',
+      imageModel: 'test-image-model',
+      requestTimeoutMs: 1000,
+    },
+    smsAuth: {
+      enabled: true,
+      provider: 'mock',
+      endpoint: 'dypnsapi.aliyuncs.com',
+      accessKeyId: '',
+      accessKeySecret: '',
+      signName: 'Test Sign',
+      templateCode: '100001',
+      templateParamKey: 'code',
+      countryCode: '86',
+      schemeName: '',
+      codeLength: 6,
+      codeType: 1,
+      validTimeSeconds: 300,
+      intervalSeconds: 60,
+      duplicatePolicy: 1,
+      caseAuthPolicy: 1,
+      returnVerifyCode: false,
+      mockVerifyCode: '123456',
+      maxSendPerPhonePerDay: 20,
+      maxSendPerIpPerHour: 30,
+      maxVerifyFailuresPerPhonePerHour: 12,
+      maxVerifyFailuresPerIpPerHour: 24,
+      captchaTtlSeconds: 180,
+      captchaTriggerVerifyFailuresPerPhone: 3,
+      captchaTriggerVerifyFailuresPerIp: 5,
+      blockPhoneFailureThreshold: 6,
+      blockIpFailureThreshold: 10,
+      blockPhoneDurationMinutes: 30,
+      blockIpDurationMinutes: 30,
+    },
+    wechatAuth: {
+      enabled: true,
+      provider: 'mock',
+      appId: '',
+      appSecret: '',
+      authorizeEndpoint: 'https://open.weixin.qq.com/connect/qrconnect',
+      accessTokenEndpoint: 'https://api.weixin.qq.com/sns/oauth2/access_token',
+      userInfoEndpoint: 'https://api.weixin.qq.com/sns/userinfo',
+      callbackPath: '/api/auth/wechat/callback',
+      defaultRedirectPath: '/',
+      mockUserId: 'mock_wechat_user',
+      mockUnionId: 'mock_wechat_union',
+      mockDisplayName: '微信旅人',
+      mockAvatarUrl: '',
+    },
+    authSession: {
+      accessCookieName: 'genarrative_access_session',
+      accessCookieTtlSeconds: 7200,
+      accessCookieSecure: false,
+      accessCookieSameSite: 'Lax',
+      accessCookiePath: '/',
+      refreshCookieName: 'genarrative_refresh_session',
+      refreshSessionTtlDays: 30,
+      refreshCookieSecure: false,
+      refreshCookieSameSite: 'Lax',
+      refreshCookiePath: '/api/auth',
+    },
+  };
+}
+
+async function withTestServer<T>(
+  testName: string,
+  run: (options: { baseUrl: string }) => Promise<T>,
+) {
+  const context = await createAppContext(createTestConfig(testName));
+  const app = createApp(context);
+  const server = await new Promise<import('node:http').Server>((resolve) => {
+    const nextServer = app.listen(0, '127.0.0.1', () => resolve(nextServer));
+  });
+
+  try {
+    const address = server.address() as AddressInfo;
+    return await run({
+      baseUrl: `http://127.0.0.1:${address.port}`,
+    });
+  } finally {
+    await new Promise<void>((resolve, reject) => {
+      server.close((error) => {
+        if (error) {
+          reject(error);
+          return;
+        }
+        resolve();
+      });
+    });
+    await context.db.close();
+  }
+}
+
+async function authEntry(baseUrl: string, username: string, password: string) {
+  const response = await httpRequest(`${baseUrl}/api/auth/entry`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      username,
+      password,
+    }),
+  });
+  const payload = (await response.json()) as {
+    token: string;
+    user: {
+      id: string;
+    };
+  };
+
+  assert.equal(response.status, 200);
+  assert.ok(payload.token);
+  return payload;
+}
+
+function withBearer(token: string, init: TestRequestInit = {}) {
+  return {
+    ...init,
+    headers: {
+      ...(init.headers ?? {}),
+      Authorization: `Bearer ${token}`,
+      'Content-Type': 'application/json',
+    },
+  } satisfies TestRequestInit;
+}
+
+async function putSnapshot(
+  baseUrl: string,
+  token: string,
+  body: Record<string, unknown>,
+) {
+  const response = await httpRequest(
+    `${baseUrl}/api/runtime/save/snapshot`,
+    withBearer(token, {
+      method: 'PUT',
+      body: JSON.stringify(body),
+    }),
+  );
+
+  assert.equal(response.status, 200);
+  return response.json();
+}
+
+test('rpg profile routes keep new and legacy dashboard compatibility', async () => {
+  await withTestServer('profile-compat', async ({ baseUrl }) => {
+    const entry = await authEntry(baseUrl, 'rpg_profile_user', 'secret123');
+
+    await putSnapshot(baseUrl, entry.token, {
+      gameState: {
+        currentScene: 'Story',
+        worldType: 'WUXIA',
+        playerCharacter: {
+          id: 'hero-profile',
+          title: '试剑客',
+          description: '赶路的人。',
+          personality: '稳重',
+          attributes: {
+            strength: 8,
+          },
+          skills: [],
+        },
+      },
+      bottomTab: 'adventure',
+      currentStory: {
+        text: '第一段记录',
+        options: [],
+      },
+      savedAt: '2026-04-21T10:00:00.000Z',
+    });
+
+    const runtimeResponse = await httpRequest(
+      `${baseUrl}/api/runtime/profile/dashboard`,
+      withBearer(entry.token),
+    );
+    const runtimePayload = (await runtimeResponse.json()) as {
+      walletBalance: number;
+      playedWorldCount: number;
+    };
+    const legacyResponse = await httpRequest(
+      `${baseUrl}/api/profile/dashboard`,
+      withBearer(entry.token),
+    );
+    const legacyPayload = (await legacyResponse.json()) as typeof runtimePayload;
+
+    assert.equal(runtimeResponse.status, 200);
+    assert.equal(legacyResponse.status, 200);
+    assert.deepEqual(legacyPayload, runtimePayload);
+  });
+});
+
+test('rpg entry save routes keep list and resume archive compatibility', async () => {
+  await withTestServer('save-archive-compat', async ({ baseUrl }) => {
+    const entry = await authEntry(baseUrl, 'rpg_save_user', 'secret123');
+
+    await putSnapshot(baseUrl, entry.token, {
+      gameState: {
+        currentScene: 'Story',
+        worldType: 'CUSTOM',
+        customWorldProfile: {
+          id: 'world-archive-a',
+          name: '裂潮边城',
+        },
+        playerCharacter: {
+          id: 'hero-save',
+          title: '归乡人',
+          description: '带着旧信回城。',
+          personality: '沉静',
+          attributes: {
+            spirit: 9,
+          },
+          skills: [],
+        },
+        playerCurrency: 42,
+      },
+      bottomTab: 'adventure',
+      currentStory: {
+        text: '旧灯塔还亮着。',
+        options: [],
+      },
+      savedAt: '2026-04-21T10:05:00.000Z',
+    });
+
+    const listRuntime = await httpRequest(
+      `${baseUrl}/api/runtime/profile/save-archives`,
+      withBearer(entry.token),
+    );
+    const listLegacy = await httpRequest(
+      `${baseUrl}/api/profile/save-archives`,
+      withBearer(entry.token),
+    );
+    const runtimePayload = (await listRuntime.json()) as {
+      entries: Array<{ worldKey: string }>;
+    };
+    const legacyPayload = (await listLegacy.json()) as typeof runtimePayload;
+
+    assert.equal(listRuntime.status, 200);
+    assert.equal(listLegacy.status, 200);
+    assert.deepEqual(legacyPayload.entries, runtimePayload.entries);
+    assert.equal(runtimePayload.entries.length, 1);
+
+    const worldKey = runtimePayload.entries[0]?.worldKey;
+    assert.ok(worldKey);
+
+    const resumeRuntime = await httpRequest(
+      `${baseUrl}/api/runtime/profile/save-archives/${encodeURIComponent(worldKey!)}`,
+      withBearer(entry.token, {
+        method: 'POST',
+      }),
+    );
+    const resumeLegacy = await httpRequest(
+      `${baseUrl}/api/profile/save-archives/${encodeURIComponent(worldKey!)}`,
+      withBearer(entry.token, {
+        method: 'POST',
+      }),
+    );
+    const resumeRuntimePayload = (await resumeRuntime.json()) as {
+      entry: { worldKey: string };
+      snapshot: { gameState: { playerCurrency: number } };
+    };
+    const resumeLegacyPayload = (await resumeLegacy.json()) as typeof resumeRuntimePayload;
+
+    assert.equal(resumeRuntime.status, 200);
+    assert.equal(resumeLegacy.status, 200);
+    assert.deepEqual(resumeLegacyPayload.entry, resumeRuntimePayload.entry);
+    assert.equal(
+      resumeLegacyPayload.snapshot.bottomTab,
+      resumeRuntimePayload.snapshot.bottomTab,
+    );
+    assert.equal(
+      resumeLegacyPayload.snapshot.currentStory.text,
+      resumeRuntimePayload.snapshot.currentStory.text,
+    );
+    assert.equal(resumeRuntimePayload.snapshot.gameState.playerCurrency, 42);
+    assert.equal(resumeLegacyPayload.snapshot.gameState.playerCurrency, 42);
+  });
+});
+
+test('rpg world library routes expose gallery and library through new boundaries', async () => {
+  await withTestServer('world-library-boundary', async ({ baseUrl }) => {
+    const owner = await authEntry(baseUrl, 'rpg_world_owner', 'secret123');
+
+    const upsertResponse = await httpRequest(
+      `${baseUrl}/api/runtime/custom-world-library/world-a`,
+      withBearer(owner.token, {
+        method: 'PUT',
+        body: JSON.stringify({
+          profile: {
+            name: '裂桥前线',
+            subtitle: '雾潮压城',
+            summary: '守桥与沉船商盟持续拉扯。',
+            settingText: '一座被雾潮包住的边城。',
+            templateWorldType: 'WUXIA',
+            majorFactions: [],
+            coreConflicts: [],
+            playableNpcs: [],
+            storyNpcs: [],
+            items: [],
+            landmarks: [],
+            attributeSchema: {
+              slots: [],
+            },
+          },
+        }),
+      }),
+    );
+    assert.equal(upsertResponse.status, 200);
+
+    const libraryResponse = await httpRequest(
+      `${baseUrl}/api/runtime/custom-world-library`,
+      withBearer(owner.token),
+    );
+    const libraryPayload = (await libraryResponse.json()) as {
+      entries: Array<{ profileId: string }>;
+    };
+    assert.equal(libraryResponse.status, 200);
+    assert.deepEqual(
+      libraryPayload.entries.map((entry) => entry.profileId),
+      ['world-a'],
+    );
+
+    const publishResponse = await httpRequest(
+      `${baseUrl}/api/runtime/custom-world-library/world-a/publish`,
+      withBearer(owner.token, {
+        method: 'POST',
+      }),
+    );
+    assert.equal(publishResponse.status, 200);
+
+    const galleryResponse = await httpRequest(
+      `${baseUrl}/api/runtime/custom-world-gallery`,
+    );
+    const galleryPayload = (await galleryResponse.json()) as {
+      entries: Array<{ ownerUserId: string; profileId: string }>;
+    };
+    assert.equal(galleryResponse.status, 200);
+    assert.equal(galleryPayload.entries.length, 1);
+
+    const detailResponse = await httpRequest(
+      `${baseUrl}/api/runtime/custom-world-gallery/${encodeURIComponent(galleryPayload.entries[0]!.ownerUserId)}/${encodeURIComponent(galleryPayload.entries[0]!.profileId)}`,
+    );
+    const detailPayload = (await detailResponse.json()) as {
+      entry: {
+        profileId: string;
+        worldName: string;
+      };
+    };
+    assert.equal(detailResponse.status, 200);
+    assert.equal(detailPayload.entry.profileId, 'world-a');
+    assert.equal(detailPayload.entry.worldName, '裂桥前线');
+  });
+});
+
+test('rpg runtime story routes resolve through the new route boundary', async () => {
+  await withTestServer('runtime-story-boundary', async ({ baseUrl }) => {
+    const entry = await authEntry(baseUrl, 'rpg_story_user', 'secret123');
+
+    await putSnapshot(baseUrl, entry.token, {
+      gameState: {
+        worldType: 'WUXIA',
+        playerCharacter: {
+          id: 'hero-story',
+          title: '试剑客',
+          description: '站在桥口的人。',
+          personality: '谨慎',
+          attributes: {
+            strength: 8,
+            spirit: 6,
+          },
+          skills: [],
+        },
+        runtimeStats: {
+          playTimeMs: 0,
+          lastPlayTickAt: null,
+          hostileNpcsDefeated: 0,
+          questsAccepted: 0,
+          itemsUsed: 0,
+          scenesTraveled: 0,
+        },
+        currentScene: 'test-scene',
+        storyHistory: [],
+        characterChats: {},
+        animationState: 'idle',
+        currentEncounter: {
+          kind: 'npc',
+          id: 'npc_merchant_01',
+          npcName: '沈七',
+          npcDescription: '腰间挂着药囊的行商',
+          context: '受伤行商',
+        },
+        npcInteractionActive: true,
+        currentScenePreset: null,
+        sceneHostileNpcs: [],
+        playerX: 0,
+        playerOffsetY: 0,
+        playerFacing: 'right',
+        playerActionMode: 'idle',
+        scrollWorld: false,
+        inBattle: false,
+        playerHp: 31,
+        playerMaxHp: 40,
+        playerMana: 9,
+        playerMaxMana: 16,
+        playerSkillCooldowns: {},
+        activeBuildBuffs: [],
+        activeCombatEffects: [],
+        playerCurrency: 90,
+        playerInventory: [],
+        playerEquipment: {
+          weapon: null,
+          armor: null,
+          relic: null,
+        },
+        npcStates: {
+          npc_merchant_01: {
+            affinity: 46,
+            chattedCount: 0,
+            helpUsed: false,
+            giftsGiven: 0,
+            inventory: [],
+            recruited: false,
+          },
+        },
+        quests: [],
+        roster: [],
+        companions: [],
+        currentNpcBattleMode: null,
+        currentNpcBattleOutcome: null,
+        sparReturnEncounter: null,
+        sparPlayerHpBefore: null,
+        sparPlayerMaxHpBefore: null,
+        sparStoryHistoryBefore: null,
+      },
+      bottomTab: 'adventure',
+      currentStory: {
+        text: '巡路人看着你，像在等一句开口。',
+        options: [],
+      },
+    });
+
+    const stateResponse = await httpRequest(
+      `${baseUrl}/api/runtime/story/state/runtime-main`,
+      withBearer(entry.token),
+    );
+    const statePayload = (await stateResponse.json()) as {
+      viewModel: {
+        availableOptions: Array<{ functionId: string }>;
+      };
+    };
+    assert.equal(stateResponse.status, 200);
+    assert.ok(
+      statePayload.viewModel.availableOptions.some(
+        (option) => option.functionId === 'npc_chat',
+      ),
+    );
+
+    const actionResponse = await httpRequest(
+      `${baseUrl}/api/runtime/story/actions/resolve`,
+      withBearer(entry.token, {
+        method: 'POST',
+        body: JSON.stringify({
+          sessionId: 'runtime-main',
+          clientVersion: 0,
+          action: {
+            type: 'story_choice',
+            functionId: 'npc_chat',
+          },
+        }),
+      }),
+    );
+    const actionPayload = (await actionResponse.json()) as {
+      serverVersion: number;
+      viewModel: {
+        encounter: {
+          affinity: number;
+        } | null;
+      };
+    };
+
+    assert.equal(actionResponse.status, 200);
+    assert.equal(actionPayload.serverVersion, 1);
+    assert.equal(actionPayload.viewModel.encounter?.affinity, 52);
+  });
+});
diff --git a/server-node/src/routes/rpgWorldLibraryRoutes.ts b/server-node/src/routes/rpgWorldLibraryRoutes.ts
deleted file mode 100644
index cdd4fcbc..00000000
--- a/server-node/src/routes/rpgWorldLibraryRoutes.ts
+++ /dev/null
@@ -1,13 +0,0 @@
-import { Router } from 'express';
-
-import type { AppContext } from '../context.js';
-
-/**
- * 工作包 A 先建立 RPG 世界作品库路由的命名骨架。
- * 当前仅提供稳定落点，真正的库读写逻辑仍保留在 `runtimeRoutes.ts` 中。
- */
-export const RPG_WORLD_LIBRARY_ROUTE_BASE_PATH = '/runtime/custom-world-library';
-
-export function createRpgWorldLibraryRoutes(_context: AppContext) {
-  return Router();
-}
diff --git a/server-node/src/routes/rpgWorldWorksRoutes.ts b/server-node/src/routes/rpgWorldWorksRoutes.ts
deleted file mode 100644
index f8488c45..00000000
--- a/server-node/src/routes/rpgWorldWorksRoutes.ts
+++ /dev/null
@@ -1,13 +0,0 @@
-import { Router } from 'express';
-
-import type { AppContext } from '../context.js';
-
-/**
- * 工作包 A 先建立 RPG 世界作品流路由的命名骨架。
- * 真实实现仍暂挂在 `runtimeRoutes.ts`，后续工作包再把作品列表接口迁入这里。
- */
-export const RPG_WORLD_WORKS_ROUTE_BASE_PATH = '/runtime/custom-world/works';
-
-export function createRpgWorldWorksRoutes(_context: AppContext) {
-  return Router();
-}
diff --git a/server-node/src/routes/runtimeRoutes.ts b/server-node/src/routes/runtimeRoutes.ts
deleted file mode 100644
index ddcd13d5..00000000
--- a/server-node/src/routes/runtimeRoutes.ts
+++ /dev/null
@@ -1,843 +0,0 @@
-import { Router } from 'express';
-import { z } from 'zod';
-
-import type { ListCustomWorldWorksResponse } from '../../../packages/shared/src/contracts/customWorldAgent.js';
-import type {
-  CustomWorldGalleryDetailResponse,
-  CustomWorldGalleryResponse,
-  CustomWorldLibraryMutationResponse,
-  CustomWorldLibraryResponse,
-  GenerateCustomWorldProfileInput,
-  PlatformBrowseHistoryBatchSyncRequest,
-  PlatformBrowseHistoryResponse,
-  PlatformBrowseHistoryWriteEntry,
-  ProfileDashboardSummary,
-  ProfilePlayStatsResponse,
-  ProfileSaveArchiveListResponse,
-  ProfileSaveArchiveResumeResponse,
-  ProfileWalletLedgerResponse,
-  RuntimeSettings,
-  SavedGameSnapshotInput,
-} from '../../../packages/shared/src/contracts/runtime.js';
-import {
-  PLATFORM_THEMES,
-} from '../../../packages/shared/src/contracts/runtime.js';
-import type {
-  QuestGenerationRequest,
-  RuntimeItemIntentRequest,
-} from '../../../packages/shared/src/contracts/story.js';
-import type {
-  CharacterChatReplyRequest,
-  CharacterChatSuggestionsRequest,
-  CharacterChatSummaryRequest,
-  NpcChatDialogueRequest,
-  NpcChatTurnRequest,
-  NpcRecruitDialogueRequest,
-} from '../../../packages/shared/src/contracts/story.js';
-import type { AppContext } from '../context.js';
-import { badRequest, notFound } from '../errors.js';
-import {
-  asyncHandler,
-  jsonClone,
-  sendApiResponse,
-} from '../http.js';
-import { requireJwtAuth } from '../middleware/auth.js';
-import { routeMeta } from '../middleware/routeMeta.js';
-import {
-  generateCharacterChatSuggestionsFromOrchestrator,
-  generateCharacterChatSummaryFromOrchestrator,
-  streamCharacterChatReplyFromOrchestrator,
-  streamNpcChatDialogueFromOrchestrator,
-  streamNpcChatTurnFromOrchestrator,
-  streamNpcRecruitDialogueFromOrchestrator,
-} from '../modules/ai/chatOrchestrator.js';
-import { generateCustomWorldProfileFromOrchestrator } from '../modules/ai/customWorldOrchestrator.js';
-import {
-  hydrateSavedSnapshot,
-  normalizeSavedSnapshotPayload,
-} from '../modules/runtime/runtimeSnapshotHydration.js';
-import {
-  characterChatReplyRequestSchema,
-  characterChatSuggestionsRequestSchema,
-  characterChatSummaryRequestSchema,
-  npcChatDialogueRequestSchema,
-  npcChatTurnRequestSchema,
-  npcRecruitDialogueRequestSchema,
-} from '../services/chatService.js';
-import { generateCustomWorldEntity } from '../services/customWorldEntityGenerationService.js';
-import { generateSceneNpcForLandmark } from '../services/customWorldSceneNpcGenerationService.js';
-import { listCustomWorldWorkSummaries } from '../services/customWorldWorkSummaryService.js';
-import { generateQuestForNpcEncounter } from '../services/questService.js';
-import { generateRuntimeItemIntents } from '../services/runtimeItemService.js';
-import {
-  customWorldCoverImageSchema,
-  customWorldCoverUploadSchema,
-  generateCustomWorldCoverImage,
-  uploadCustomWorldCoverImage,
-} from '../services/customWorldCoverAssetService.js';
-import {
-  generateSceneImage,
-  sceneImageSchema,
-} from '../services/sceneImageService.js';
-import {
-  generateHighQualityInitialStory,
-  generateHighQualityNextStory,
-  parseStoryRequest,
-} from '../services/storyService.js';
-import { createCustomWorldAgentRoutes } from './customWorldAgent.js';
-
-const jsonObjectSchema = z.record(z.string(), z.unknown());
-
-const saveSnapshotSchema = z.object({
-  gameState: z.unknown(),
-  bottomTab: z.string().trim().min(1),
-  currentStory: z.unknown().nullable().optional().default(null),
-  savedAt: z.string().trim().optional().default(''),
-});
-
-const settingsSchema = z.object({
-  musicVolume: z.number().min(0).max(1),
-  platformTheme: z.enum(PLATFORM_THEMES),
-});
-
-const platformBrowseHistoryEntrySchema = z.object({
-  ownerUserId: z.string().trim().min(1),
-  profileId: z.string().trim().min(1),
-  worldName: z.string().trim().min(1),
-  subtitle: z.string().trim().optional().default(''),
-  summaryText: z.string().trim().optional().default(''),
-  coverImageSrc: z.string().trim().nullable().optional().default(null),
-  themeMode: z.string().trim().optional().default('mythic'),
-  authorDisplayName: z.string().trim().optional().default('玩家'),
-  visitedAt: z.string().trim().optional().default(''),
-});
-
-const platformBrowseHistoryBatchSchema = z.object({
-  entries: z.array(platformBrowseHistoryEntrySchema).max(100),
-});
-
-const customWorldProfileSchema = z.object({
-  profile: jsonObjectSchema,
-});
-
-const customWorldProfileGenerationSchema = z.object({
-  settingText: z.string().trim().min(1),
-  creatorIntent: jsonObjectSchema.nullish(),
-  generationMode: z.enum(['fast', 'full']).optional(),
-});
-
-const customWorldSceneNpcSchema = z.object({
-  profile: jsonObjectSchema,
-  landmarkId: z.string().trim().min(1),
-});
-
-const customWorldEntitySchema = z.object({
-  profile: jsonObjectSchema,
-  kind: z.enum(['playable', 'story', 'landmark']),
-});
-
-const runtimeItemIntentSchema = z.object({
-  context: jsonObjectSchema,
-  plans: z.array(jsonObjectSchema),
-});
-
-const questGenerationSchema = z.object({
-  state: jsonObjectSchema,
-  encounter: jsonObjectSchema,
-});
-
-const llmProxySchema = jsonObjectSchema;
-
-function readParam(param: string | string[] | undefined) {
-  return Array.isArray(param) ? param[0]?.trim() || '' : param?.trim() || '';
-}
-
-async function resolveAuthDisplayName(context: AppContext, userId: string) {
-  const user = await context.userRepository.findById(userId);
-  if (!user) {
-    throw notFound('user not found');
-  }
-
-  return user.displayName?.trim() || '玩家';
-}
-
-export function createRuntimeRoutes(context: AppContext) {
-  const router = Router();
-  const requireAuth = requireJwtAuth(context.config, context.userRepository);
-  const routeCompatPaths = (path: string) => [
-    path,
-    `/runtime${path}`,
-  ] as const;
-  const handleCustomWorldEntityGeneration = asyncHandler(async (request, response) => {
-    const payload = customWorldEntitySchema.parse(request.body) as {
-      profile: Record<string, unknown>;
-      kind: 'playable' | 'story' | 'landmark';
-    };
-    sendApiResponse(
-      response,
-      await generateCustomWorldEntity(context.llmClient, payload),
-    );
-  });
-  const handleCustomWorldSceneNpcGeneration = asyncHandler(async (request, response) => {
-    const payload = customWorldSceneNpcSchema.parse(request.body) as {
-      profile: Record<string, unknown>;
-      landmarkId: string;
-    };
-    sendApiResponse(response, {
-      npc: await generateSceneNpcForLandmark(context.llmClient, payload),
-    });
-  });
-
-  router.get(
-    '/runtime/custom-world-gallery',
-    routeMeta({ operation: 'runtime.customWorldGallery.list' }),
-    asyncHandler(async (_request, response) => {
-      sendApiResponse(response, {
-        entries: await context.runtimeRepository.listPublishedCustomWorldGallery(),
-      } satisfies CustomWorldGalleryResponse);
-    }),
-  );
-
-  router.get(
-    '/runtime/custom-world-gallery/:ownerUserId/:profileId',
-    routeMeta({ operation: 'runtime.customWorldGallery.detail' }),
-    asyncHandler(async (request, response) => {
-      const ownerUserId = readParam(request.params.ownerUserId);
-      const profileId = readParam(request.params.profileId);
-      if (!ownerUserId || !profileId) {
-        throw badRequest('ownerUserId and profileId are required');
-      }
-
-      const entry =
-        await context.runtimeRepository.getPublishedCustomWorldGalleryDetail(
-          ownerUserId,
-          profileId,
-        );
-      if (!entry) {
-        throw notFound('public custom world not found');
-      }
-
-      sendApiResponse(response, {
-        entry,
-      } satisfies CustomWorldGalleryDetailResponse);
-    }),
-  );
-
-  router.use(requireAuth);
-  router.use(
-    '/runtime/custom-world/agent',
-    createCustomWorldAgentRoutes(context),
-  );
-
-  routeCompatPaths('/profile/dashboard').forEach((path, index) => {
-    router.get(
-      path,
-      routeMeta({
-        operation:
-          index === 0
-            ? 'profile.dashboard.get'
-            : 'profile.dashboard.get.compat',
-      }),
-      asyncHandler(async (request, response) => {
-        sendApiResponse<ProfileDashboardSummary>(
-          response,
-          await context.runtimeRepository.getProfileDashboard(request.userId!),
-        );
-      }),
-    );
-  });
-
-  routeCompatPaths('/profile/wallet-ledger').forEach((path, index) => {
-    router.get(
-      path,
-      routeMeta({
-        operation:
-          index === 0
-            ? 'profile.walletLedger.list'
-            : 'profile.walletLedger.list.compat',
-      }),
-      asyncHandler(async (request, response) => {
-        sendApiResponse<ProfileWalletLedgerResponse>(response, {
-          entries: await context.runtimeRepository.listProfileWalletLedger(
-            request.userId!,
-          ),
-        });
-      }),
-    );
-  });
-
-  routeCompatPaths('/profile/play-stats').forEach((path, index) => {
-    router.get(
-      path,
-      routeMeta({
-        operation:
-          index === 0
-            ? 'profile.playStats.get'
-            : 'profile.playStats.get.compat',
-      }),
-      asyncHandler(async (request, response) => {
-        sendApiResponse<ProfilePlayStatsResponse>(
-          response,
-          await context.runtimeRepository.getProfilePlayStats(request.userId!),
-        );
-      }),
-    );
-  });
-
-  routeCompatPaths('/profile/browse-history').forEach((path, index) => {
-    router.get(
-      path,
-      routeMeta({
-        operation:
-          index === 0
-            ? 'profile.browseHistory.list'
-            : 'profile.browseHistory.list.compat',
-      }),
-      asyncHandler(async (request, response) => {
-        sendApiResponse<PlatformBrowseHistoryResponse>(response, {
-          entries: await context.runtimeRepository.listPlatformBrowseHistory(
-            request.userId!,
-          ),
-        });
-      }),
-    );
-
-    router.post(
-      path,
-      routeMeta({
-        operation:
-          index === 0
-            ? 'profile.browseHistory.upsert'
-            : 'profile.browseHistory.upsert.compat',
-      }),
-      asyncHandler(async (request, response) => {
-        const rawBody =
-          request.body && typeof request.body === 'object' ? request.body : {};
-        const payload = (
-          'entries' in rawBody
-            ? platformBrowseHistoryBatchSchema.parse(rawBody)
-            : platformBrowseHistoryEntrySchema.parse(rawBody)
-        ) as
-          | PlatformBrowseHistoryBatchSyncRequest
-          | PlatformBrowseHistoryWriteEntry;
-
-        const entries = 'entries' in payload ? payload.entries : [payload];
-
-        sendApiResponse<PlatformBrowseHistoryResponse>(response, {
-          entries:
-            await context.runtimeRepository.upsertPlatformBrowseHistoryEntries(
-              request.userId!,
-              entries,
-            ),
-        });
-      }),
-    );
-
-    router.delete(
-      path,
-      routeMeta({
-        operation:
-          index === 0
-            ? 'profile.browseHistory.clear'
-            : 'profile.browseHistory.clear.compat',
-      }),
-      asyncHandler(async (request, response) => {
-        await context.runtimeRepository.clearPlatformBrowseHistory(
-          request.userId!,
-        );
-        sendApiResponse<PlatformBrowseHistoryResponse>(response, {
-          entries: [],
-        });
-      }),
-    );
-  });
-
-  routeCompatPaths('/profile/save-archives').forEach((path, index) => {
-    router.get(
-      path,
-      routeMeta({
-        operation:
-          index === 0
-            ? 'profile.saveArchives.list'
-            : 'profile.saveArchives.list.compat',
-      }),
-      asyncHandler(async (request, response) => {
-        sendApiResponse<ProfileSaveArchiveListResponse>(response, {
-          entries: await context.runtimeRepository.listProfileSaveArchives(
-            request.userId!,
-          ),
-        });
-      }),
-    );
-  });
-
-  [
-    '/profile/save-archives/:worldKey',
-    '/runtime/profile/save-archives/:worldKey',
-  ].forEach((path, index) => {
-    router.post(
-      path,
-      routeMeta({
-        operation:
-          index === 0
-            ? 'profile.saveArchives.resume'
-            : 'profile.saveArchives.resume.compat',
-      }),
-      asyncHandler(async (request, response) => {
-        const worldKey =
-          typeof request.params.worldKey === 'string'
-            ? request.params.worldKey.trim()
-            : '';
-
-        if (!worldKey) {
-          throw badRequest('worldKey 不能为空');
-        }
-
-        const resumedArchive =
-          await context.runtimeRepository.resumeProfileSaveArchive(
-            request.userId!,
-            worldKey,
-          );
-
-        if (!resumedArchive) {
-          throw notFound('指定存档不存在');
-        }
-
-        sendApiResponse<ProfileSaveArchiveResumeResponse>(response, {
-          entry: resumedArchive.entry,
-          snapshot: hydrateSavedSnapshot(resumedArchive.snapshot)!,
-        });
-      }),
-    );
-  });
-
-  router.post(
-    '/llm/chat/completions',
-    routeMeta({ operation: 'runtime.llm.chatCompletionsProxy' }),
-    asyncHandler(async (request, response) => {
-      const body = llmProxySchema.parse(request.body);
-      await context.llmClient.forwardCompletion(request, body, response);
-    }),
-  );
-
-  router.post(
-    '/custom-world/cover-image',
-    routeMeta({ operation: 'runtime.customWorld.coverImage' }),
-    asyncHandler(async (request, response) => {
-      const payload = customWorldCoverImageSchema.parse(request.body);
-      sendApiResponse(response, await generateCustomWorldCoverImage(context, payload));
-    }),
-  );
-
-  router.post(
-    '/custom-world/cover-upload',
-    routeMeta({ operation: 'runtime.customWorld.coverUpload' }),
-    asyncHandler(async (request, response) => {
-      const payload = customWorldCoverUploadSchema.parse(request.body);
-      sendApiResponse(response, await uploadCustomWorldCoverImage(context, payload));
-    }),
-  );
-
-  router.post(
-    '/custom-world/scene-image',
-    routeMeta({ operation: 'runtime.customWorld.sceneImage' }),
-    asyncHandler(async (request, response) => {
-      const payload = sceneImageSchema.parse(request.body);
-      sendApiResponse(response, await generateSceneImage(context, payload));
-    }),
-  );
-
-  router.post(
-    '/custom-world/entity',
-    routeMeta({ operation: 'runtime.customWorld.entity' }),
-    handleCustomWorldEntityGeneration,
-  );
-
-  router.post(
-    '/runtime/custom-world/entity',
-    routeMeta({ operation: 'runtime.customWorld.entity.compat' }),
-    handleCustomWorldEntityGeneration,
-  );
-
-  router.post(
-    '/custom-world/scene-npc',
-    routeMeta({ operation: 'runtime.customWorld.sceneNpc' }),
-    handleCustomWorldSceneNpcGeneration,
-  );
-
-  router.post(
-    '/runtime/custom-world/scene-npc',
-    routeMeta({ operation: 'runtime.customWorld.sceneNpc.compat' }),
-    handleCustomWorldSceneNpcGeneration,
-  );
-
-  router.get(
-    '/runtime/save/snapshot',
-    routeMeta({ operation: 'runtime.snapshot.get' }),
-    asyncHandler(async (request, response) => {
-      sendApiResponse(
-        response,
-        hydrateSavedSnapshot(
-          await context.runtimeRepository.getSnapshot(request.userId!),
-        ),
-      );
-    }),
-  );
-
-  router.put(
-    '/runtime/save/snapshot',
-    routeMeta({ operation: 'runtime.snapshot.put' }),
-    asyncHandler(async (request, response) => {
-      const payload = saveSnapshotSchema.parse(
-        request.body,
-      ) as SavedGameSnapshotInput;
-      const normalizedSnapshot = normalizeSavedSnapshotPayload({
-        savedAt: payload.savedAt || new Date().toISOString(),
-        gameState: payload.gameState,
-        bottomTab: payload.bottomTab,
-        currentStory: payload.currentStory ?? null,
-      });
-      sendApiResponse(
-        response,
-        hydrateSavedSnapshot(
-          await context.runtimeRepository.putSnapshot(
-            request.userId!,
-            normalizedSnapshot,
-          ),
-        ),
-      );
-    }),
-  );
-
-  router.delete(
-    '/runtime/save/snapshot',
-    routeMeta({ operation: 'runtime.snapshot.delete' }),
-    asyncHandler(async (request, response) => {
-      await context.runtimeRepository.deleteSnapshot(request.userId!);
-      sendApiResponse(response, { ok: true });
-    }),
-  );
-
-  router.get(
-    '/runtime/settings',
-    routeMeta({ operation: 'runtime.settings.get' }),
-    asyncHandler(async (request, response) => {
-      sendApiResponse(
-        response,
-        await context.runtimeRepository.getSettings(request.userId!),
-      );
-    }),
-  );
-
-  router.put(
-    '/runtime/settings',
-    routeMeta({ operation: 'runtime.settings.put' }),
-    asyncHandler(async (request, response) => {
-      const payload = settingsSchema.parse(request.body) as RuntimeSettings;
-      sendApiResponse(
-        response,
-        await context.runtimeRepository.putSettings(request.userId!, payload),
-      );
-    }),
-  );
-
-  router.get(
-    '/runtime/custom-world/works',
-    routeMeta({ operation: 'runtime.customWorldWorks.list' }),
-    asyncHandler(async (request, response) => {
-      sendApiResponse<ListCustomWorldWorksResponse>(response, {
-        items: await listCustomWorldWorkSummaries(request.userId!, {
-          runtimeRepository: context.runtimeRepository,
-          customWorldAgentSessions: context.customWorldAgentSessions,
-        }),
-      });
-    }),
-  );
-
-  router.get(
-    '/runtime/custom-world-library',
-    routeMeta({ operation: 'runtime.customWorldLibrary.list' }),
-    asyncHandler(async (request, response) => {
-      sendApiResponse(response, {
-        entries: await context.runtimeRepository.listCustomWorldProfiles(
-          request.userId!,
-        ),
-      } satisfies CustomWorldLibraryResponse);
-    }),
-  );
-
-  router.put(
-    '/runtime/custom-world-library/:profileId',
-    routeMeta({ operation: 'runtime.customWorldLibrary.upsert' }),
-    asyncHandler(async (request, response) => {
-      const profileId = readParam(request.params.profileId);
-      if (!profileId) {
-        throw badRequest('profileId is required');
-      }
-      const payload = customWorldProfileSchema.parse(request.body);
-      const authorDisplayName = await resolveAuthDisplayName(
-        context,
-        request.userId!,
-      );
-      sendApiResponse(
-        response,
-        await context.runtimeRepository.upsertCustomWorldProfile(
-          request.userId!,
-          profileId,
-          jsonClone(payload.profile),
-          authorDisplayName,
-        ),
-      );
-    }),
-  );
-
-  router.delete(
-    '/runtime/custom-world-library/:profileId',
-    routeMeta({ operation: 'runtime.customWorldLibrary.delete' }),
-    asyncHandler(async (request, response) => {
-      const profileId = readParam(request.params.profileId);
-      if (!profileId) {
-        throw badRequest('profileId is required');
-      }
-      sendApiResponse(response, {
-        entries: await context.runtimeRepository.deleteCustomWorldProfile(
-          request.userId!,
-          profileId,
-        ),
-      } satisfies CustomWorldLibraryResponse);
-    }),
-  );
-
-  router.post(
-    '/runtime/custom-world/profile',
-    routeMeta({ operation: 'runtime.customWorld.profile' }),
-    asyncHandler(async (request, response) => {
-      const payload = customWorldProfileGenerationSchema.parse(
-        request.body,
-      ) as GenerateCustomWorldProfileInput;
-      sendApiResponse(
-        response,
-        await generateCustomWorldProfileFromOrchestrator(
-          context.llmClient,
-          payload,
-        ),
-      );
-    }),
-  );
-
-  router.post(
-    '/runtime/custom-world-library/:profileId/publish',
-    routeMeta({ operation: 'runtime.customWorldLibrary.publish' }),
-    asyncHandler(async (request, response) => {
-      const profileId = readParam(request.params.profileId);
-      if (!profileId) {
-        throw badRequest('profileId is required');
-      }
-
-      const authorDisplayName = await resolveAuthDisplayName(
-        context,
-        request.userId!,
-      );
-      const mutation =
-        await context.runtimeRepository.publishCustomWorldProfile(
-          request.userId!,
-          profileId,
-          authorDisplayName,
-        );
-      if (!mutation) {
-        throw notFound('custom world not found');
-      }
-
-      sendApiResponse(
-        response,
-        mutation satisfies CustomWorldLibraryMutationResponse,
-      );
-    }),
-  );
-
-  router.post(
-    '/runtime/custom-world-library/:profileId/unpublish',
-    routeMeta({ operation: 'runtime.customWorldLibrary.unpublish' }),
-    asyncHandler(async (request, response) => {
-      const profileId = readParam(request.params.profileId);
-      if (!profileId) {
-        throw badRequest('profileId is required');
-      }
-
-      const authorDisplayName = await resolveAuthDisplayName(
-        context,
-        request.userId!,
-      );
-      const mutation =
-        await context.runtimeRepository.unpublishCustomWorldProfile(
-          request.userId!,
-          profileId,
-          authorDisplayName,
-        );
-      if (!mutation) {
-        throw notFound('custom world not found');
-      }
-
-      sendApiResponse(
-        response,
-        mutation satisfies CustomWorldLibraryMutationResponse,
-      );
-    }),
-  );
-
-  router.post(
-    '/runtime/story/initial',
-    routeMeta({ operation: 'runtime.story.initial' }),
-    asyncHandler(async (request, response) => {
-      const payload = parseStoryRequest(request.body);
-      sendApiResponse(
-        response,
-        await generateHighQualityInitialStory(context.llmClient, payload),
-      );
-    }),
-  );
-
-  router.post(
-    '/runtime/story/continue',
-    routeMeta({ operation: 'runtime.story.continue' }),
-    asyncHandler(async (request, response) => {
-      const payload = parseStoryRequest(request.body);
-      sendApiResponse(
-        response,
-        await generateHighQualityNextStory(context.llmClient, payload),
-      );
-    }),
-  );
-
-  router.post(
-    '/runtime/chat/character/suggestions',
-    routeMeta({ operation: 'runtime.chat.character.suggestions' }),
-    asyncHandler(async (request, response) => {
-      const payload = characterChatSuggestionsRequestSchema.parse(
-        request.body,
-      ) as CharacterChatSuggestionsRequest;
-      sendApiResponse(response, {
-        text: await generateCharacterChatSuggestionsFromOrchestrator(
-          context.llmClient,
-          payload,
-        ),
-      });
-    }),
-  );
-
-  router.post(
-    '/runtime/chat/character/summary',
-    routeMeta({ operation: 'runtime.chat.character.summary' }),
-    asyncHandler(async (request, response) => {
-      const payload = characterChatSummaryRequestSchema.parse(
-        request.body,
-      ) as CharacterChatSummaryRequest;
-      sendApiResponse(response, {
-        text: await generateCharacterChatSummaryFromOrchestrator(
-          context.llmClient,
-          payload,
-        ),
-      });
-    }),
-  );
-
-  router.post(
-    '/runtime/chat/character/reply/stream',
-    routeMeta({ operation: 'runtime.chat.character.replyStream' }),
-    asyncHandler(async (request, response) => {
-      const payload = characterChatReplyRequestSchema.parse(
-        request.body,
-      ) as CharacterChatReplyRequest;
-      await streamCharacterChatReplyFromOrchestrator(context.llmClient, {
-        request,
-        response,
-        payload,
-      });
-    }),
-  );
-
-  router.post(
-    '/runtime/chat/npc/dialogue/stream',
-    routeMeta({ operation: 'runtime.chat.npc.dialogueStream' }),
-    asyncHandler(async (request, response) => {
-      const payload = npcChatDialogueRequestSchema.parse(
-        request.body,
-      ) as NpcChatDialogueRequest;
-      await streamNpcChatDialogueFromOrchestrator(context.llmClient, {
-        request,
-        response,
-        payload,
-      });
-    }),
-  );
-
-  router.post(
-    '/runtime/chat/npc/turn/stream',
-    routeMeta({ operation: 'runtime.chat.npc.turnStream' }),
-    asyncHandler(async (request, response) => {
-      const payload = npcChatTurnRequestSchema.parse(
-        request.body,
-      ) as NpcChatTurnRequest;
-      await streamNpcChatTurnFromOrchestrator(context.llmClient, {
-        request,
-        response,
-        payload,
-      });
-    }),
-  );
-
-  router.post(
-    '/runtime/chat/npc/recruit/stream',
-    routeMeta({ operation: 'runtime.chat.npc.recruitStream' }),
-    asyncHandler(async (request, response) => {
-      const payload = npcRecruitDialogueRequestSchema.parse(
-        request.body,
-      ) as NpcRecruitDialogueRequest;
-      await streamNpcRecruitDialogueFromOrchestrator(context.llmClient, {
-        request,
-        response,
-        payload,
-      });
-    }),
-  );
-
-  router.post(
-    '/runtime/items/runtime-intent',
-    routeMeta({ operation: 'runtime.items.intent' }),
-    asyncHandler(async (request, response) => {
-      const payload = runtimeItemIntentSchema.parse(
-        request.body,
-      ) as RuntimeItemIntentRequest;
-      sendApiResponse(response, {
-        intents: await generateRuntimeItemIntents(context.llmClient, payload),
-      });
-    }),
-  );
-
-  router.post(
-    '/runtime/quests/generate',
-    routeMeta({ operation: 'runtime.quests.generate' }),
-    asyncHandler(async (request, response) => {
-      const payload = questGenerationSchema.parse(
-        request.body,
-      ) as QuestGenerationRequest;
-      sendApiResponse(
-        response,
-        await generateQuestForNpcEncounter(context.llmClient, payload),
-      );
-    }),
-  );
-
-  router.get(
-    '/ws/health',
-    routeMeta({ operation: 'runtime.ws.health' }),
-    (_request, response) => {
-      sendApiResponse(response, {
-        ok: true,
-        message: 'websocket routes reserved for future real-time support',
-      });
-    },
-  );
-
-  return router;
-}
diff --git a/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts b/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts
index d64c6c3e..eabe111e 100644
--- a/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts
+++ b/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts
@@ -4,8 +4,9 @@ import path from 'node:path';
 import sharp from 'sharp';
 
 import { createDatabase } from '../db.js';
-import { RuntimeRepository } from '../repositories/runtimeRepository.js';
 import { loadConfig } from '../config.js';
+import { RpgAgentSessionRepository } from '../repositories/RpgAgentSessionRepository.js';
+import { RpgWorldProfileRepository } from '../repositories/RpgWorldProfileRepository.js';
 import { CustomWorldAgentSessionStore } from '../services/customWorldAgentSessionStore.js';
 
 type RecordValue = Record<string, unknown>;
@@ -80,15 +81,18 @@ async function main() {
   const db = await createDatabase(config);
 
   try {
-    const runtimeRepository = new RuntimeRepository(db);
-    const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+    const rpgAgentSessionRepository = new RpgAgentSessionRepository(db);
+    const rpgWorldProfileRepository = new RpgWorldProfileRepository(db);
+    const sessionStore = new CustomWorldAgentSessionStore(
+      rpgAgentSessionRepository,
+    );
     const session = await sessionStore.getSnapshot(userId, sessionId);
     if (!session || !isRecord(session.draftProfile)) {
       throw new Error('未找到目标世界草稿 session，无法同步历史保存档案。');
     }
 
     const savedProfileEntry = (
-      await runtimeRepository.listCustomWorldProfiles(userId)
+      await rpgWorldProfileRepository.listOwnProfiles(userId)
     ).find((entry) => entry.profileId === profileId);
     if (!savedProfileEntry) {
       throw new Error('未找到目标 saved profile，无法同步历史保存档案。');
@@ -200,7 +204,7 @@ async function main() {
     nextProfile.landmarks = landmarks;
     nextProfile.sceneChapterBlueprints = sceneChapterBlueprints;
 
-    const updatedEntry = await runtimeRepository.upsertCustomWorldProfile(
+    const updatedEntry = await rpgWorldProfileRepository.upsertOwnProfile(
       userId,
       profileId,
       nextProfile,
diff --git a/server-node/src/server.ts b/server-node/src/server.ts
index 813da85a..62c05fa5 100644
--- a/server-node/src/server.ts
+++ b/server-node/src/server.ts
@@ -8,6 +8,13 @@ import { createLogger } from './logging.js';
 import { AuthAuditLogRepository } from './repositories/authAuditLogRepository.js';
 import { AuthIdentityRepository } from './repositories/authIdentityRepository.js';
 import { AuthRiskBlockRepository } from './repositories/authRiskBlockRepository.js';
+import { RpgAgentSessionRepository } from './repositories/RpgAgentSessionRepository.js';
+import { RpgWorldProfileRepository } from './repositories/RpgWorldProfileRepository.js';
+import { RpgSaveArchiveRepository } from './repositories/rpg-entry/RpgSaveArchiveRepository.js';
+import { RpgWorldLibraryRepository } from './repositories/rpg-entry/RpgWorldLibraryRepository.js';
+import { RpgBrowseHistoryRepository } from './repositories/rpg-profile/RpgBrowseHistoryRepository.js';
+import { RpgProfileDashboardRepository } from './repositories/rpg-profile/RpgProfileDashboardRepository.js';
+import { RpgRuntimeSnapshotRepository } from './repositories/rpg-runtime/RpgRuntimeSnapshotRepository.js';
 import { RuntimeRepository } from './repositories/runtimeRepository.js';
 import { SmsAuthEventRepository } from './repositories/smsAuthEventRepository.js';
 import { UserRepository } from './repositories/userRepository.js';
@@ -17,6 +24,7 @@ import { CustomWorldAgentAutoAssetService } from './services/customWorldAgentAut
 import { CustomWorldAgentOrchestrator } from './services/customWorldAgentOrchestrator.js';
 import { CustomWorldAgentSessionStore } from './services/customWorldAgentSessionStore.js';
 import { UpstreamLlmClient } from './services/llmClient.js';
+import { RpgWorldWorkSummaryService } from './services/RpgWorldWorkSummaryService.js';
 import { createSmsVerificationService } from './services/smsVerificationService.js';
 import { createWechatAuthService } from './services/wechatAuthService.js';
 import { WechatAuthStateStore } from './services/wechatAuthStateStore.js';
@@ -79,10 +87,32 @@ function describeDatabase(databaseUrl: string) {
 export async function createAppContext(config: AppConfig = loadConfig()) {
   const logger = createLogger(config);
   const db = await createDatabase(config);
+  const rpgAgentSessionRepository = new RpgAgentSessionRepository(db);
+  const rpgWorldProfileRepository = new RpgWorldProfileRepository(db);
   const runtimeRepository = new RuntimeRepository(db);
-  const customWorldAgentSessions = new CustomWorldAgentSessionStore(
+  const rpgProfileDashboardRepository = new RpgProfileDashboardRepository(
     runtimeRepository,
   );
+  const rpgBrowseHistoryRepository = new RpgBrowseHistoryRepository(
+    runtimeRepository,
+  );
+  const rpgSaveArchiveRepository = new RpgSaveArchiveRepository(
+    runtimeRepository,
+  );
+  const rpgWorldLibraryRepository = new RpgWorldLibraryRepository(
+    runtimeRepository,
+  );
+  const rpgRuntimeSnapshotRepository = new RpgRuntimeSnapshotRepository(
+    runtimeRepository,
+  );
+  const userRepository = new UserRepository(db);
+  const customWorldAgentSessions = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+  const rpgWorldWorkSummaryService = new RpgWorldWorkSummaryService(
+    rpgWorldProfileRepository,
+    customWorldAgentSessions,
+  );
   const autoAssetService = new CustomWorldAgentAutoAssetService(
     config,
     config.dashScope.apiKey.trim()
@@ -104,12 +134,19 @@ export async function createAppContext(config: AppConfig = loadConfig()) {
     config,
     logger,
     db,
-    userRepository: new UserRepository(db),
+    userRepository,
     authIdentityRepository: new AuthIdentityRepository(db),
     authAuditLogRepository: new AuthAuditLogRepository(db),
     authRiskBlockRepository: new AuthRiskBlockRepository(db),
     smsAuthEventRepository: new SmsAuthEventRepository(db),
     userSessionRepository: new UserSessionRepository(db),
+    rpgAgentSessionRepository,
+    rpgWorldProfileRepository,
+    rpgProfileDashboardRepository,
+    rpgBrowseHistoryRepository,
+    rpgSaveArchiveRepository,
+    rpgWorldLibraryRepository,
+    rpgRuntimeSnapshotRepository,
     runtimeRepository,
     llmClient: new UpstreamLlmClient(config, logger),
     customWorldAgentSessions,
@@ -120,8 +157,11 @@ export async function createAppContext(config: AppConfig = loadConfig()) {
         : null,
       {
         autoAssetService,
+        rpgWorldProfileRepository,
+        userRepository,
       },
     ),
+    rpgWorldWorkSummaryService,
     smsVerificationService: createSmsVerificationService(config, logger),
     wechatAuthService: createWechatAuthService(config, logger),
     wechatAuthStates: new WechatAuthStateStore(),
diff --git a/server-node/src/services/RpgWorldPreviewCompiler.fixture.test.ts b/server-node/src/services/RpgWorldPreviewCompiler.fixture.test.ts
new file mode 100644
index 00000000..ad73d3be
--- /dev/null
+++ b/server-node/src/services/RpgWorldPreviewCompiler.fixture.test.ts
@@ -0,0 +1,80 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+  createRpgAgentFoundationDraftProfileFixture,
+  createRpgCreationPublishedProfileFixture,
+} from '../../../packages/shared/src/contracts/rpgCreationFixtures.js';
+import {
+  buildRpgWorldPreviewEnvelope,
+  normalizeRpgWorldPreviewEnvelope,
+} from './RpgWorldPreviewCompiler.js';
+
+test('rpg world preview compiler can consume shared published profile fixture as a stable unit baseline', () => {
+  const publishedProfile = createRpgCreationPublishedProfileFixture();
+  const previewEnvelope = buildRpgWorldPreviewEnvelope(
+    publishedProfile,
+    String(publishedProfile.settingText ?? ''),
+  );
+
+  assert.equal(previewEnvelope.source, 'session_preview');
+  assert.equal(previewEnvelope.preview.name, publishedProfile.name);
+  assert.equal(
+    (previewEnvelope.preview.playableNpcs as Array<{ generatedAnimationSetId?: string }>)[0]
+      ?.generatedAnimationSetId,
+    'animation-set-playable-1',
+  );
+  assert.equal(
+    (
+      previewEnvelope.preview.sceneChapterBlueprints as Array<{
+        acts?: Array<{ backgroundImageSrc?: string }>;
+      }>
+    )[0]?.acts?.[0]?.backgroundImageSrc,
+    '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
+  );
+});
+
+test('regression: foundation-like shared fixture fields are preserved after normalize + preview compile chain', () => {
+  const foundationDraft = createRpgAgentFoundationDraftProfileFixture();
+  const normalizedPreviewEnvelope = normalizeRpgWorldPreviewEnvelope(
+    {
+      name: foundationDraft.name,
+      subtitle: foundationDraft.subtitle,
+      summary: foundationDraft.summary,
+      tone: foundationDraft.tone,
+      playerGoal: foundationDraft.playerGoal,
+      templateWorldType: 'WUXIA',
+      majorFactions: foundationDraft.majorFactions,
+      coreConflicts: foundationDraft.coreConflicts,
+      playableNpcs: foundationDraft.playableNpcs,
+      storyNpcs: foundationDraft.storyNpcs,
+      camp: foundationDraft.camp,
+      landmarks: foundationDraft.landmarks,
+      sceneChapterBlueprints: foundationDraft.sceneChapters,
+      themePack: foundationDraft.themePack,
+      storyGraph: foundationDraft.storyGraph,
+    },
+    foundationDraft.worldHook,
+  );
+
+  assert.equal(normalizedPreviewEnvelope.source, 'session_preview');
+  assert.equal(
+    (normalizedPreviewEnvelope.preview.playableNpcs as Array<{ imageSrc?: string }>)[0]
+      ?.imageSrc,
+    '/generated-characters/playable-1/visual/asset-runtime/master.png',
+  );
+  assert.equal(
+    (normalizedPreviewEnvelope.preview.playableNpcs as Array<{
+      animationMap?: { attack?: { basePath?: string } };
+    }>)[0]?.animationMap?.attack?.basePath,
+    '/generated-characters/playable-1/animations/attack',
+  );
+  assert.equal(
+    (
+      normalizedPreviewEnvelope.preview.sceneChapterBlueprints as Array<{
+        acts?: Array<{ backgroundAssetId?: string }>;
+      }>
+    )[0]?.acts?.[0]?.backgroundAssetId,
+    'scene-asset-runtime',
+  );
+});
diff --git a/server-node/src/services/RpgWorldPreviewCompiler.test.ts b/server-node/src/services/RpgWorldPreviewCompiler.test.ts
new file mode 100644
index 00000000..f4899792
--- /dev/null
+++ b/server-node/src/services/RpgWorldPreviewCompiler.test.ts
@@ -0,0 +1,269 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+  buildRpgWorldPreviewEnvelope,
+  buildRpgWorldPreviewProfile,
+  normalizeRpgWorldPreviewEnvelope,
+} from './RpgWorldPreviewCompiler.js';
+import { buildRpgCreationPreviewProfileFromDraftProfile } from './rpgCreationPreviewProfileBuilder.js';
+
+function createPreviewFixture() {
+  const storyNpcs = Array.from({ length: 25 }, (_, index) => ({
+    name: `场景角色${index + 1}`,
+    title: `头衔${index + 1}`,
+    role: `职责${index + 1}`,
+    description: `场景角色描述${index + 1}`,
+    backstory: `场景角色背景${index + 1}`,
+    personality: `场景角色性格${index + 1}`,
+    motivation: `场景角色动机${index + 1}`,
+    combatStyle: `场景角色战斗风格${index + 1}`,
+    initialAffinity: index % 4 === 0 ? -10 : 6,
+    relationshipHooks: [`关系${index + 1}`],
+    tags: [`线索${index + 1}`],
+  }));
+
+  return {
+    id: 'preview-world',
+    name: '预览测试世界',
+    subtitle: '预览副标题',
+    summary: '服务端预览编译的兼容结果。',
+    tone: '压抑、潮湿',
+    playerGoal: '先确认谁在推动局势，再决定站位。',
+    templateWorldType: 'WUXIA',
+    majorFactions: ['守灯会', '潮线商盟'],
+    coreConflicts: ['旧航道解释权正在被重写'],
+    playableNpcs: Array.from({ length: 5 }, (_, index) => ({
+      name: `角色${index + 1}`,
+      title: `称号${index + 1}`,
+      role: `身份${index + 1}`,
+      description: `角色描述${index + 1}`,
+      backstory: `角色背景${index + 1}`,
+      personality: `角色性格${index + 1}`,
+      motivation: `角色动机${index + 1}`,
+      combatStyle: `战斗风格${index + 1}`,
+      initialAffinity: 18,
+      relationshipHooks: [`接触点${index + 1}`],
+      tags: [`标签${index + 1}`],
+    })),
+    storyNpcs,
+    landmarks: Array.from({ length: 10 }, (_, index) => ({
+      name: `场景${index + 1}`,
+      description: `场景描述${index + 1}`,
+      dangerLevel: 'medium',
+      sceneNpcNames: [
+        storyNpcs[index % storyNpcs.length]?.name ?? `场景角色${index + 1}`,
+        storyNpcs[(index + 1) % storyNpcs.length]?.name ??
+          `场景角色${index + 2}`,
+        storyNpcs[(index + 2) % storyNpcs.length]?.name ??
+          `场景角色${index + 3}`,
+      ],
+      connections: [
+        {
+          targetLandmarkName: `场景${((index + 1) % 10) + 1}`,
+          relativePosition: 'forward',
+          summary: '沿主路前行',
+        },
+        {
+          targetLandmarkName: `场景${((index + 9) % 10) + 1}`,
+          relativePosition: 'back',
+          summary: '回身可返',
+        },
+      ],
+    })),
+  };
+}
+
+test('rpg world preview compiler builds a legacy-compatible preview envelope on the server', () => {
+  const settingText = '一个被潮雾反复切开的边境世界。';
+  const rawProfile = createPreviewFixture();
+
+  const previewProfile = buildRpgWorldPreviewProfile(rawProfile, settingText);
+  const previewEnvelope = buildRpgWorldPreviewEnvelope(rawProfile, settingText);
+  const normalizedEnvelope = normalizeRpgWorldPreviewEnvelope(
+    rawProfile,
+    settingText,
+  );
+
+  assert.equal(previewProfile.name, '预览测试世界');
+  assert.equal(previewProfile.playableNpcs.length, 5);
+  assert.equal(previewEnvelope.source, 'session_preview');
+  assert.equal(normalizedEnvelope.source, 'session_preview');
+  assert.equal(previewEnvelope.preview.name, '预览测试世界');
+  assert.equal(previewEnvelope.preview.scenarioPackId, 'scenario-pack:预览测试世界');
+  assert.equal(
+    normalizedEnvelope.preview.campaignPackId,
+    'campaign-pack:预览测试世界',
+  );
+});
+
+test('phase5 preview builder keeps legacy runtime-rich fields while merging latest draft assets', () => {
+  const previewProfile = buildRpgCreationPreviewProfileFromDraftProfile({
+    sessionId: 'session-phase5-preview',
+    draftProfile: {
+      name: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '第一版世界底稿已经整理完成。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清沉船与禁航区异动的真相。',
+      majorFactions: ['守灯会', '航运公会'],
+      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      playableNpcs: [
+        {
+          id: 'playable-1',
+          name: '沈砺',
+          imageSrc: '/generated-characters/playable-1/visual/asset-runtime/master.png',
+          generatedVisualAssetId: 'asset-runtime-playable',
+          generatedAnimationSetId: 'animation-set-runtime-playable',
+          animationMap: {
+            attack: {
+              basePath: '/generated-characters/playable-1/animations/attack',
+            },
+          },
+        },
+      ],
+      storyNpcs: [
+        {
+          id: 'story-1',
+          name: '顾潮音',
+          imageSrc: '/generated-characters/story-1/visual/asset-runtime/master.png',
+          generatedVisualAssetId: 'asset-runtime-story',
+        },
+      ],
+      landmarks: [
+        {
+          id: 'landmark-1',
+          name: '回潮旧灯塔',
+          imageSrc: '/generated-custom-world-scenes/landmark-1/scene.png',
+          generatedSceneAssetId: 'scene-asset-runtime',
+        },
+      ],
+      sceneChapters: [
+        {
+          id: 'scene-chapter-1',
+          sceneId: 'landmark-1',
+          title: '灯塔初章',
+          acts: [
+            {
+              id: 'scene-act-1',
+              title: '第一幕',
+              backgroundImageSrc:
+                '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
+              backgroundAssetId: 'scene-act-runtime',
+            },
+          ],
+        },
+      ],
+      legacyResultProfile: {
+        id: 'agent-draft-session-phase5-preview',
+        settingText: '被海雾吞没的旧航路群岛',
+        name: '潮雾列岛·结果页精修版',
+        subtitle: '旧灯塔与失控航路',
+        summary: '服务端 preview 需要保留结果页富字段。',
+        tone: '压抑、潮湿、悬疑',
+        playerGoal: '查清沉船夜与假航灯的真正操盘者。',
+        templateWorldType: 'WUXIA',
+        majorFactions: ['守灯会', '航运公会'],
+        coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+        playableNpcs: [
+          {
+            id: 'playable-1',
+            name: '沈砺',
+            title: '旧航路引路人',
+            role: '关键同行者',
+            description: '最熟悉旧航路的人。',
+            backstory: '曾在沉船夜里带着半支船队逃出海雾。',
+            personality: '表面沉稳，心里一直在算退路。',
+            motivation: '想赶在守灯会封航前查清真相。',
+            combatStyle: '借地形和潮路换位，先拉扯再压近。',
+            initialAffinity: 18,
+            relationshipHooks: ['旧友', '沉船旧案'],
+            tags: ['潮路', '引路'],
+            narrativeProfile: {
+              publicMask: '像个只想把旧路再走通一次的熟路人。',
+            },
+          },
+        ],
+        storyNpcs: [
+          {
+            id: 'story-1',
+            name: '顾潮音',
+            title: '守灯会值夜人',
+            role: '场景关键角色',
+            description: '夜里巡灯与封锁禁航区的人。',
+            backstory: '在失控海雾第一次吞船那夜，她是最后一个还留在灯塔顶的人。',
+            personality: '冷静克制，但提到旧灯册时会显得过分警觉。',
+            motivation: '想守住灯塔记录，也想找到谁先改动了禁航信号。',
+            combatStyle: '借塔顶视角和风向压制，再用灯火错位扰乱。',
+            initialAffinity: 8,
+            relationshipHooks: ['禁航记录', '灯塔值夜'],
+            tags: ['守灯会', '灯塔'],
+          },
+        ],
+        items: [
+          {
+            id: 'item-world-1',
+            name: '潮雾罗盘',
+            category: '饰品',
+          },
+        ],
+        landmarks: [
+          {
+            id: 'landmark-1',
+            name: '回潮旧灯塔',
+            description: '被海雾啃旧的石塔仍在夜里维持着微弱灯火。',
+            dangerLevel: 'high',
+            sceneNpcIds: ['story-1'],
+            connections: [],
+          },
+        ],
+        themePack: {
+          id: 'theme-pack:tide',
+        },
+        knowledgeFacts: [
+          {
+            id: 'fact-1',
+            title: '高处潮痕',
+          },
+        ],
+        threadContracts: [
+          {
+            id: 'contract-1',
+            threadId: 'thread-visible-1',
+          },
+        ],
+        sceneChapterBlueprints: [
+          {
+            id: 'scene-chapter-1',
+            sceneId: 'landmark-1',
+            title: '灯塔初章',
+            acts: [
+              {
+                id: 'scene-act-1',
+                title: '第一幕',
+              },
+            ],
+          },
+        ],
+        generationMode: 'full',
+        generationStatus: 'complete',
+      },
+    },
+  });
+
+  assert.equal(previewProfile.name, '潮雾列岛');
+  assert.equal(previewProfile.playerGoal, '查清沉船与禁航区异动的真相。');
+  assert.equal(previewProfile.themePack?.id, 'theme-pack:tide');
+  assert.equal(previewProfile.knowledgeFacts?.[0]?.id, 'fact-1');
+  assert.equal(previewProfile.threadContracts?.[0]?.id, 'contract-1');
+  assert.equal(previewProfile.playableNpcs[0]?.imageSrc, '/generated-characters/playable-1/visual/asset-runtime/master.png');
+  assert.equal(previewProfile.playableNpcs[0]?.generatedAnimationSetId, 'animation-set-runtime-playable');
+  assert.equal(
+    previewProfile.playableNpcs[0]?.narrativeProfile?.publicMask,
+    '像个只想把旧路再走通一次的熟路人。',
+  );
+  assert.equal(
+    previewProfile.sceneChapterBlueprints?.[0]?.acts?.[0]?.backgroundAssetId,
+    'scene-act-runtime',
+  );
+});
diff --git a/server-node/src/services/RpgWorldPreviewCompiler.ts b/server-node/src/services/RpgWorldPreviewCompiler.ts
index 793010f4..483b488b 100644
--- a/server-node/src/services/RpgWorldPreviewCompiler.ts
+++ b/server-node/src/services/RpgWorldPreviewCompiler.ts
@@ -1,14 +1,65 @@
 import {
   buildCompiledCustomWorldProfile,
   normalizeCustomWorldProfile,
-} from '../modules/custom-world/runtimeProfile.js';
+} from '../modules/custom-world/runtime-profile/index.js';
+import type {
+  RpgCreationPreview,
+  RpgCreationPreviewEnvelope,
+  RpgCreationPreviewSource,
+} from '../../../packages/shared/src/contracts/rpgCreationPreview.js';
 import type { CustomWorldProfile } from '../modules/custom-world/runtimeTypes.js';
 
 /**
- * 工作包 A 先建立 RPG 世界预览编译器的新命名 façade。
- * 当前仍桥接旧 runtime profile 编译能力，后续工作包 G 会把正式 preview compiler 收口到这个入口。
+ * 工作包 G 把服务端结果预览编译入口收口到这里。
+ * Phase 5 后当前 preview 正式作为 session_preview 主链输出，
+ * 编译边界已经从 foundation draft 流程中抽离。
  */
 export type RpgWorldPreviewProfile = CustomWorldProfile;
 
-export const buildRpgWorldPreviewProfile = buildCompiledCustomWorldProfile;
-export const normalizeRpgWorldPreviewProfile = normalizeCustomWorldProfile;
+const RPG_WORLD_PREVIEW_SOURCE: RpgCreationPreviewSource =
+  'session_preview';
+
+function toRpgCreationPreview(
+  profile: RpgWorldPreviewProfile,
+): RpgCreationPreview {
+  return profile as unknown as RpgCreationPreview;
+}
+
+export function buildRpgWorldPreviewProfile(
+  raw: unknown,
+  settingText: string,
+): RpgWorldPreviewProfile {
+  return buildCompiledCustomWorldProfile(raw, settingText);
+}
+
+export function normalizeRpgWorldPreviewProfile(
+  raw: unknown,
+  settingText: string,
+): RpgWorldPreviewProfile {
+  return normalizeCustomWorldProfile(raw, settingText);
+}
+
+export function buildRpgWorldPreviewEnvelope(
+  raw: unknown,
+  settingText: string,
+): RpgCreationPreviewEnvelope {
+  return {
+    preview: toRpgCreationPreview(buildRpgWorldPreviewProfile(raw, settingText)),
+    source: RPG_WORLD_PREVIEW_SOURCE,
+  };
+}
+
+export function normalizeRpgWorldPreviewEnvelope(
+  raw: unknown,
+  settingText: string,
+): RpgCreationPreviewEnvelope {
+  return {
+    preview: toRpgCreationPreview(
+      buildRpgWorldPreviewProfile(
+        normalizeRpgWorldPreviewProfile(raw, settingText),
+        settingText,
+      ),
+    ),
+    source: RPG_WORLD_PREVIEW_SOURCE,
+  };
+}
diff --git a/server-node/src/services/RpgWorldWorkCoverResolver.ts b/server-node/src/services/RpgWorldWorkCoverResolver.ts
new file mode 100644
index 00000000..186825cf
--- /dev/null
+++ b/server-node/src/services/RpgWorldWorkCoverResolver.ts
@@ -0,0 +1,46 @@
+import type {
+  CustomWorldLibraryEntry,
+  CustomWorldProfileRecord,
+} from '../../../packages/shared/src/contracts/runtime.js';
+import { resolveCustomWorldCoverPresentation } from '../repositories/customWorldLibraryMetadata.js';
+import type { CustomWorldAgentSessionRecord } from './customWorldAgentSessionStore.js';
+
+function toRecord(value: unknown) {
+  return value && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : null;
+}
+
+/**
+ * 作品封面解析统一收口在这里，避免 works 聚合服务重复理解草稿态与发布态的封面规则。
+ */
+export function resolveRpgWorldDraftWorkCover(
+  session: CustomWorldAgentSessionRecord,
+) {
+  const draftProfile = toRecord(session.draftProfile);
+  if (!draftProfile) {
+    return {
+      imageSrc: null,
+      renderMode: 'image' as const,
+      characterImageSrcs: [],
+    };
+  }
+
+  return resolveCustomWorldCoverPresentation(
+    draftProfile as CustomWorldProfileRecord,
+  );
+}
+
+export function resolveRpgWorldPublishedWorkCover(
+  libraryEntry: CustomWorldLibraryEntry<CustomWorldProfileRecord>,
+) {
+  const coverPresentation = resolveCustomWorldCoverPresentation(
+    libraryEntry.profile,
+  );
+
+  return {
+    imageSrc: libraryEntry.coverImageSrc || coverPresentation.imageSrc,
+    renderMode: coverPresentation.renderMode,
+    characterImageSrcs: coverPresentation.characterImageSrcs,
+  };
+}
diff --git a/server-node/src/services/RpgWorldWorkSummaryAssembler.fixture.test.ts b/server-node/src/services/RpgWorldWorkSummaryAssembler.fixture.test.ts
new file mode 100644
index 00000000..9aeb0771
--- /dev/null
+++ b/server-node/src/services/RpgWorldWorkSummaryAssembler.fixture.test.ts
@@ -0,0 +1,96 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+  createRpgAgentSessionFixture,
+  createRpgCreationWorksResponseFixture,
+  createRpgWorldLibraryEntryFixture,
+} from '../../../packages/shared/src/contracts/rpgCreationFixtures.js';
+import { RpgWorldWorkSummaryAssembler } from './RpgWorldWorkSummaryAssembler.js';
+
+test('rpg world work summary assembler can consume shared fixture baselines as a unit test', () => {
+  const assembler = new RpgWorldWorkSummaryAssembler();
+  const session = createRpgAgentSessionFixture();
+  const libraryEntry = createRpgWorldLibraryEntryFixture();
+  const [draftItem] = assembler.assembleDraftItems([
+    {
+      ...JSON.parse(JSON.stringify(session)),
+      userId: 'fixture-user',
+      seedText: '被海雾吞没的旧航路群岛',
+      operations: [],
+      checkpoints: [],
+      createdAt: session.updatedAt,
+    },
+  ]);
+  const [publishedItem] = assembler.assemblePublishedItems([libraryEntry]);
+
+  assert.equal(draftItem.sourceType, 'agent_session');
+  assert.equal(draftItem.roleVisualReadyCount, 2);
+  assert.equal(draftItem.roleAnimationReadyCount, 2);
+  assert.equal(draftItem.roleAssetSummaryLabel, '沈砺 · 动作已就绪');
+  assert.equal(draftItem.canEnterWorld, false);
+  assert.equal(draftItem.publishReady, true);
+  assert.equal(draftItem.blockerCount, 0);
+  assert.equal(publishedItem.sourceType, 'published_profile');
+  assert.equal(publishedItem.canEnterWorld, true);
+  assert.equal(publishedItem.publishReady, true);
+  assert.equal(publishedItem.blockerCount, 0);
+  assert.equal(publishedItem.roleAnimationReadyCount, 1);
+});
+
+test('regression: assembler output stays aligned with shared works response fixture', () => {
+  const assembler = new RpgWorldWorkSummaryAssembler();
+  const session = createRpgAgentSessionFixture();
+  const libraryEntry = createRpgWorldLibraryEntryFixture();
+  const expected = createRpgCreationWorksResponseFixture();
+
+  const [draftItem] = assembler.assembleDraftItems([
+    {
+      ...JSON.parse(JSON.stringify(session)),
+      userId: 'fixture-user',
+      seedText: '被海雾吞没的旧航路群岛',
+      operations: [],
+      checkpoints: [],
+      createdAt: session.updatedAt,
+    },
+  ]);
+  const [publishedItem] = assembler.assemblePublishedItems([libraryEntry]);
+  const expectedDraft = expected.items.find((entry) => entry.sourceType === 'agent_session');
+  const expectedPublished = expected.items.find(
+    (entry) => entry.sourceType === 'published_profile',
+  );
+
+  assert.ok(expectedDraft);
+  assert.ok(expectedPublished);
+  assert.equal(draftItem.coverImageSrc, expectedDraft.coverImageSrc);
+  assert.deepEqual(
+    draftItem.coverCharacterImageSrcs,
+    expectedDraft.coverCharacterImageSrcs,
+  );
+  assert.equal(draftItem.stageLabel, expectedDraft.stageLabel);
+  assert.equal(draftItem.publishReady, expectedDraft.publishReady);
+  assert.equal(draftItem.blockerCount, expectedDraft.blockerCount);
+  assert.equal(publishedItem.coverImageSrc, expectedPublished.coverImageSrc);
+  assert.equal(
+    publishedItem.roleAssetSummaryLabel,
+    expectedPublished.roleAssetSummaryLabel,
+  );
+});
+
+test('published sessions do not leak back into draft work summaries', () => {
+  const assembler = new RpgWorldWorkSummaryAssembler();
+  const session = createRpgAgentSessionFixture();
+  const draftItems = assembler.assembleDraftItems([
+    {
+      ...JSON.parse(JSON.stringify(session)),
+      userId: 'fixture-user',
+      seedText: '被海雾吞没的旧航路群岛',
+      operations: [],
+      checkpoints: [],
+      createdAt: session.updatedAt,
+      stage: 'published',
+    },
+  ]);
+
+  assert.equal(draftItems.length, 0);
+});
diff --git a/server-node/src/services/RpgWorldWorkSummaryAssembler.ts b/server-node/src/services/RpgWorldWorkSummaryAssembler.ts
new file mode 100644
index 00000000..7942c629
--- /dev/null
+++ b/server-node/src/services/RpgWorldWorkSummaryAssembler.ts
@@ -0,0 +1,301 @@
+import type {
+  CustomWorldAgentStage,
+  CustomWorldWorkSummary,
+} from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import type {
+  CustomWorldLibraryEntry,
+  CustomWorldProfileRecord,
+} from '../../../packages/shared/src/contracts/runtime.js';
+import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
+import {
+  buildDraftSummaryFromIntent,
+  buildDraftTitleFromIntent,
+  normalizeCreatorIntentRecord,
+} from './customWorldAgentIntentExtractionService.js';
+import {
+  rebuildRoleAssetCoverage,
+  resolveRoleAssetStatusLabel,
+} from './customWorldAgentRoleAssetStateService.js';
+import type { CustomWorldAgentSessionRecord } from './customWorldAgentSessionStore.js';
+import {
+  buildDraftSummaryFromEightAnchorContent,
+  buildDraftTitleFromEightAnchorContent,
+} from './eightAnchorCompatibilityService.js';
+import {
+  resolveRpgWorldDraftWorkCover,
+  resolveRpgWorldPublishedWorkCover,
+} from './RpgWorldWorkCoverResolver.js';
+import { CustomWorldAgentPublishingService } from './customWorldAgentPublishingService.js';
+
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function toRecord(value: unknown) {
+  return value && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : null;
+}
+
+function toRecordArray(value: unknown) {
+  return Array.isArray(value)
+    ? value.filter((item) => item && typeof item === 'object')
+    : [];
+}
+
+function truncateText(value: string, maxLength: number) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+
+  return `${value.slice(0, Math.max(0, maxLength - 1)).trim()}…`;
+}
+
+function formatDraftStageLabel(stage: CustomWorldAgentStage) {
+  if (stage === 'collecting_intent') return '收集世界锚点';
+  if (stage === 'clarifying') return '补齐关键锚点';
+  if (stage === 'foundation_review') return '准备整理底稿';
+  if (stage === 'object_refining') return '待完善草稿';
+  if (stage === 'visual_refining') return '视觉工坊';
+  if (stage === 'long_tail_review') return '扩展长尾';
+  if (stage === 'ready_to_publish') return '准备发布';
+  if (stage === 'published') return '已发布';
+  return '发生错误';
+}
+
+function resolveDraftTitle(session: CustomWorldAgentSessionRecord) {
+  const intent = normalizeCreatorIntentRecord(session.creatorIntent);
+  const draftProfile = normalizeFoundationDraftProfile(session.draftProfile);
+
+  return (
+    draftProfile?.name ||
+    buildDraftTitleFromEightAnchorContent(session.anchorContent) ||
+    buildDraftTitleFromIntent(intent) ||
+    toText(session.draftProfile?.title) ||
+    truncateText(session.seedText, 18) ||
+    '未命名草稿'
+  );
+}
+
+function resolveDraftSummary(session: CustomWorldAgentSessionRecord) {
+  const intent = normalizeCreatorIntentRecord(session.creatorIntent);
+  const compiledSummary = buildDraftSummaryFromIntent(intent);
+  const draftProfile = normalizeFoundationDraftProfile(session.draftProfile);
+
+  return (
+    draftProfile?.summary ||
+    buildDraftSummaryFromEightAnchorContent(session.anchorContent) ||
+    compiledSummary ||
+    toText(session.draftProfile?.summary) ||
+    truncateText(session.seedText, 72) ||
+    '还在收集你的世界锚点。'
+  );
+}
+
+function resolveDraftCounts(session: CustomWorldAgentSessionRecord) {
+  const draftProfile = normalizeFoundationDraftProfile(session.draftProfile);
+  if (draftProfile) {
+    // 草稿作品卡需要展示当前可编辑的全部角色数量，而不是仅统计可扮演角色。
+    const totalRoleCount = [
+      ...new Set(
+        [...draftProfile.playableNpcs, ...draftProfile.storyNpcs].map(
+          (entry) => entry.id,
+        ),
+      ),
+    ].length;
+
+    return {
+      playableNpcCount: totalRoleCount,
+      landmarkCount: draftProfile.landmarks.length,
+    };
+  }
+
+  const playableNpcCount = session.draftCards.filter(
+    (card) => card.kind === 'character',
+  ).length;
+  const landmarkCount = session.draftCards.filter(
+    (card) => card.kind === 'landmark' || card.kind === 'camp',
+  ).length;
+
+  return {
+    playableNpcCount,
+    landmarkCount,
+  };
+}
+
+function resolveDraftRoleAssetProgress(session: CustomWorldAgentSessionRecord) {
+  const coverage = rebuildRoleAssetCoverage(session.draftProfile);
+  const roleVisualReadyCount = coverage.roleAssets.filter(
+    (entry) => entry.status !== 'missing',
+  ).length;
+  const roleAnimationReadyCount = coverage.roleAssets.filter(
+    (entry) => entry.status === 'complete',
+  ).length;
+  const leadRole = coverage.roleAssets[0];
+
+  return {
+    roleVisualReadyCount,
+    roleAnimationReadyCount,
+    roleAssetSummaryLabel: leadRole
+      ? `${leadRole.roleName} · ${resolveRoleAssetStatusLabel(leadRole.status)}`
+      : coverage.roleAssets.length > 0
+        ? '角色资产进行中'
+        : null,
+  };
+}
+
+function isLibraryEntry(
+  value: unknown,
+): value is CustomWorldLibraryEntry<CustomWorldProfileRecord> {
+  const record = toRecord(value);
+  return (
+    record !== null &&
+    typeof record.ownerUserId === 'string' &&
+    typeof record.profileId === 'string' &&
+    Boolean(toRecord(record.profile))
+  );
+}
+
+function isPublishedLibraryEntry(
+  value: unknown,
+): value is CustomWorldLibraryEntry<CustomWorldProfileRecord> {
+  return isLibraryEntry(value) && value.visibility === 'published';
+}
+
+/**
+ * works 组装器只负责把 session/profile 转成稳定读模型，不直接发起仓储读取。
+ */
+export class RpgWorldWorkSummaryAssembler {
+  private readonly publishGateService = new CustomWorldAgentPublishingService({
+    listOwnProfiles: async () => [],
+    upsertOwnProfile: async () => {
+      throw new Error('publish repository is unavailable in work summary assembler');
+    },
+    syncProfileFromSnapshot: async () => undefined,
+    softDeleteOwnProfile: async () => [],
+    publishOwnProfile: async () => null,
+    unpublishOwnProfile: async () => null,
+    listPublishedGallery: async () => [],
+    getPublishedGalleryDetail: async () => null,
+  });
+
+  assembleDraftItems(sessions: CustomWorldAgentSessionRecord[]) {
+    return sessions
+      .filter((session) => session.stage !== 'published')
+      .map((session) => {
+        const counts = resolveDraftCounts(session);
+        const roleAssetProgress = resolveDraftRoleAssetProgress(session);
+        const coverPresentation = resolveRpgWorldDraftWorkCover(session);
+        const publishState = this.publishGateService.summarizePublishGate({
+          sessionId: session.sessionId,
+          stage: session.stage,
+          draftProfile: session.draftProfile,
+          qualityFindings: session.qualityFindings,
+        });
+
+        return {
+          workId: `draft:${session.sessionId}`,
+          sourceType: 'agent_session',
+          status: 'draft',
+          title: resolveDraftTitle(session),
+          subtitle:
+            normalizeFoundationDraftProfile(session.draftProfile)?.subtitle ||
+            formatDraftStageLabel(session.stage),
+          summary: resolveDraftSummary(session),
+          coverImageSrc: coverPresentation.imageSrc,
+          coverRenderMode: coverPresentation.renderMode,
+          coverCharacterImageSrcs: coverPresentation.characterImageSrcs,
+          updatedAt: session.updatedAt,
+          publishedAt: null,
+          stage: session.stage,
+          stageLabel: formatDraftStageLabel(session.stage),
+          playableNpcCount: counts.playableNpcCount,
+          landmarkCount: counts.landmarkCount,
+          roleVisualReadyCount: roleAssetProgress.roleVisualReadyCount,
+          roleAnimationReadyCount: roleAssetProgress.roleAnimationReadyCount,
+          roleAssetSummaryLabel: roleAssetProgress.roleAssetSummaryLabel,
+          sessionId: session.sessionId,
+          profileId: null,
+          canResume: true,
+          canEnterWorld: publishState.canEnterWorld,
+          blockerCount: publishState.blockerCount,
+          publishReady: publishState.publishReady,
+        } satisfies CustomWorldWorkSummary;
+      });
+  }
+
+  assemblePublishedItems(
+    profiles: Array<CustomWorldLibraryEntry<CustomWorldProfileRecord>>,
+  ) {
+    return profiles.filter(isPublishedLibraryEntry).map((libraryEntry) => {
+      const profileRecord = libraryEntry.profile as CustomWorldProfileRecord &
+        Record<string, unknown>;
+      const playableNpcs = toRecordArray(profileRecord.playableNpcs);
+      const landmarks = toRecordArray(profileRecord.landmarks);
+      const updatedAt =
+        toText(libraryEntry.updatedAt) ||
+        toText(profileRecord.updatedAt) ||
+        new Date().toISOString();
+      const coverPresentation = resolveRpgWorldPublishedWorkCover(libraryEntry);
+      const roleVisualReadyCount = playableNpcs.filter(
+        (entry) =>
+          Boolean(toText(entry.imageSrc)) &&
+          Boolean(toText(entry.generatedVisualAssetId)),
+      ).length;
+      const roleAnimationReadyCount = playableNpcs.filter((entry) =>
+        Boolean(toText(entry.generatedAnimationSetId)),
+      ).length;
+
+      return {
+        workId: `published:${toText(profileRecord.id) || updatedAt}`,
+        sourceType: 'published_profile',
+        status: 'published',
+        title:
+          toText(libraryEntry.worldName) ||
+          toText(profileRecord.name) ||
+          '未命名世界',
+        subtitle:
+          toText(libraryEntry.subtitle) ||
+          toText(profileRecord.subtitle) ||
+          '已保存作品',
+        summary:
+          toText(libraryEntry.summaryText) ||
+          toText(profileRecord.summary) ||
+          '这个世界已经可以直接进入体验。',
+        coverImageSrc: coverPresentation.imageSrc,
+        coverRenderMode: coverPresentation.renderMode,
+        coverCharacterImageSrcs: coverPresentation.characterImageSrcs,
+        updatedAt,
+        publishedAt:
+          toText(libraryEntry.publishedAt) ||
+          toText(profileRecord.publishedAt) ||
+          updatedAt,
+        stage: 'published',
+        stageLabel: '已发布',
+        playableNpcCount:
+          libraryEntry.playableNpcCount > 0
+            ? libraryEntry.playableNpcCount
+            : playableNpcs.length,
+        landmarkCount:
+          libraryEntry.landmarkCount > 0
+            ? libraryEntry.landmarkCount
+            : landmarks.length,
+        roleVisualReadyCount,
+        roleAnimationReadyCount,
+        roleAssetSummaryLabel:
+          roleAnimationReadyCount > 0
+            ? `动作已就绪 ${roleAnimationReadyCount}`
+            : roleVisualReadyCount > 0
+              ? `主图已就绪 ${roleVisualReadyCount}`
+              : null,
+        sessionId: null,
+        profileId:
+          toText(libraryEntry.profileId) || toText(profileRecord.id) || null,
+        canResume: false,
+        canEnterWorld: true,
+        blockerCount: 0,
+        publishReady: true,
+      } satisfies CustomWorldWorkSummary;
+    });
+  }
+}
diff --git a/server-node/src/services/RpgWorldWorkSummaryService.ts b/server-node/src/services/RpgWorldWorkSummaryService.ts
index 7efe931b..06cd2df1 100644
--- a/server-node/src/services/RpgWorldWorkSummaryService.ts
+++ b/server-node/src/services/RpgWorldWorkSummaryService.ts
@@ -1 +1,44 @@
-export { listCustomWorldWorkSummaries as listRpgWorldWorkSummaries } from './customWorldWorkSummaryService.js';
+import type { CustomWorldWorkSummary } from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import type { RpgWorldProfileRepositoryPort } from '../repositories/RpgWorldProfileRepository.js';
+import type { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
+import { RpgWorldWorkSummaryAssembler } from './RpgWorldWorkSummaryAssembler.js';
+
+/**
+ * RPG 作品卡服务只负责组织“草稿 session + 已发布作品”两类读模型，
+ * 不再直接承担读库 SQL 或封面字段推导细节。
+ */
+export class RpgWorldWorkSummaryService {
+  private readonly assembler: RpgWorldWorkSummaryAssembler;
+
+  constructor(
+    private readonly rpgWorldProfiles: RpgWorldProfileRepositoryPort,
+    private readonly customWorldAgentSessions: CustomWorldAgentSessionStore,
+    assembler: RpgWorldWorkSummaryAssembler = new RpgWorldWorkSummaryAssembler(),
+  ) {
+    this.assembler = assembler;
+  }
+
+  async list(userId: string): Promise<CustomWorldWorkSummary[]> {
+    const [sessions, profiles] = await Promise.all([
+      this.customWorldAgentSessions.list(userId),
+      this.rpgWorldProfiles.listOwnProfiles(userId),
+    ]);
+
+    const draftItems = this.assembler.assembleDraftItems(sessions);
+    const publishedItems = this.assembler.assemblePublishedItems(profiles);
+
+    return [...draftItems, ...publishedItems].sort((left, right) => {
+      const updatedAtDiff =
+        new Date(right.updatedAt).getTime() - new Date(left.updatedAt).getTime();
+      if (updatedAtDiff !== 0) {
+        return updatedAtDiff;
+      }
+
+      if (left.sourceType !== right.sourceType) {
+        return left.sourceType === 'agent_session' ? -1 : 1;
+      }
+
+      return left.workId.localeCompare(right.workId);
+    });
+  }
+}
diff --git a/server-node/src/services/chatService.ts b/server-node/src/services/chatService.ts
index cc7a35a7..4242155e 100644
--- a/server-node/src/services/chatService.ts
+++ b/server-node/src/services/chatService.ts
@@ -7,7 +7,7 @@ import type {
   NpcChatDialogueRequest,
   NpcChatTurnRequest,
   NpcRecruitDialogueRequest,
-} from '../../../packages/shared/src/contracts/story.js';
+} from '../../../packages/shared/src/contracts/rpgRuntimeChat.js';
 
 const jsonObjectSchema = z.record(z.string(), z.unknown());
 
diff --git a/server-node/src/services/customWorldAgentActionExecutors/draftFoundationExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/draftFoundationExecutor.ts
new file mode 100644
index 00000000..9cfd0031
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/draftFoundationExecutor.ts
@@ -0,0 +1,145 @@
+import {
+  buildCreatorIntentFromEightAnchorContent,
+  buildAnchorPackFromEightAnchorContent,
+} from '../eightAnchorCompatibilityService.js';
+import { rebuildRoleAssetCoverage } from '../customWorldAgentRoleAssetStateService.js';
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentFoundationDraftService } from '../customWorldAgentFoundationDraftService.js';
+import type { CustomWorldAgentAutoAssetService } from '../customWorldAgentAutoAssetService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildFoundationDraftAssistantMessage } from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createDraftFoundationExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  foundationDraftService: CustomWorldAgentFoundationDraftService;
+  autoAssetService: CustomWorldAgentAutoAssetService | null;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'draft_foundation'> {
+  return async ({ userId, sessionId, operationId }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '整理世界骨架',
+        phaseDetail: '正在校验已确认锚点，并准备第一版世界框架生成链路。',
+        progress: 12,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      if (latestSession.progressPercent < 100) {
+        throw new Error('session progressPercent is below 100');
+      }
+
+      const creatorIntent = buildCreatorIntentFromEightAnchorContent(
+        latestSession.anchorContent,
+      );
+      const anchorPack = buildAnchorPackFromEightAnchorContent(
+        latestSession.anchorContent,
+        latestSession.progressPercent,
+      );
+      const draftProfile = await params.foundationDraftService.generate({
+        creatorIntent,
+        anchorPack,
+        anchorContent: latestSession.anchorContent,
+        onProgress: async (progress) => {
+          await updateOperation({
+            status: 'running',
+            phaseLabel: progress.phaseLabel,
+            phaseDetail: progress.phaseDetail,
+            progress: progress.progress,
+          });
+        },
+      });
+
+      const draftWithAssets = params.autoAssetService
+        ? await params.autoAssetService.populateDraftAssets({
+            draftProfile,
+            onProgress: async (progress) => {
+              await updateOperation({
+                status: 'running',
+                phaseLabel: progress.phaseLabel,
+                phaseDetail: progress.phaseDetail,
+                progress: progress.progress,
+              });
+            },
+          })
+        : {
+            draftProfile,
+            assetCoverage: rebuildRoleAssetCoverage(draftProfile),
+            warnings: [],
+          };
+
+      await updateOperation({
+        phaseLabel: '编译草稿卡',
+        phaseDetail: '正在把世界底稿整理成可浏览的卡片摘要和详情结构。',
+        progress: 98,
+      });
+
+      const nextState = params.snapshotBuilder.buildFoundationDraftState({
+        creatorIntent,
+        anchorPack,
+        draftProfile:
+          draftWithAssets.draftProfile as unknown as Record<string, unknown>,
+        assetCoverage: draftWithAssets.assetCoverage,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: '世界底稿 V1',
+        snapshot: buildCheckpointSnapshot(latestSession, nextState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildFoundationDraftAssistantMessage({
+          relatedOperationId: operationId,
+          draftProfile: draftWithAssets.draftProfile,
+          warnings: draftWithAssets.warnings,
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '世界底稿已生成',
+        phaseDetail:
+          draftWithAssets.warnings.length > 0
+            ? `第一版世界底稿和 ${(nextState.draftCards ?? []).length} 张草稿卡已经整理完成，另有 ${draftWithAssets.warnings.length} 项资产补齐待后续处理。`
+            : `第一版世界底稿和 ${(nextState.draftCards ?? []).length} 张草稿卡已经整理完成。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      const currentOperation = await params.sessionStore.getOperation(
+        userId,
+        sessionId,
+        operationId,
+      );
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: currentOperation?.phaseLabel?.trim() || '底稿生成失败',
+        phaseDetail:
+          currentOperation?.phaseDetail?.trim() ||
+          '这一轮没有成功把设定编成世界底稿。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'draft foundation failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/executorShared.ts b/server-node/src/services/customWorldAgentActionExecutors/executorShared.ts
new file mode 100644
index 00000000..6c046b2c
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/executorShared.ts
@@ -0,0 +1,108 @@
+import type { CustomWorldAgentOperationRecord } from '../../../../packages/shared/src/contracts/customWorldAgent.js';
+import type { CustomWorldAgentSessionRecord, CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+
+export type UpdateExecutorOperation = (
+  patch: Partial<CustomWorldAgentOperationRecord>,
+) => Promise<void>;
+
+export async function getRequiredSession(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  userId: string;
+  sessionId: string;
+}) {
+  const session = (await params.sessionStore.get(
+    params.userId,
+    params.sessionId,
+  )) as CustomWorldAgentSessionRecord | null;
+  if (!session) {
+    throw new Error('custom world agent session not found');
+  }
+
+  return session;
+}
+
+export function createOperationUpdater(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  userId: string;
+  sessionId: string;
+  operationId: string;
+}): UpdateExecutorOperation {
+  return (patch) =>
+    params.sessionStore.updateOperation(
+      params.userId,
+      params.sessionId,
+      params.operationId,
+      patch,
+    );
+}
+
+// checkpoint 恢复依赖这份最小可回放快照，统一由 executor 共享，避免每个动作手写字段集合。
+export function buildCheckpointSnapshot(
+  session: CustomWorldAgentSessionRecord,
+  patch: Partial<
+    Pick<
+      CustomWorldAgentSessionRecord,
+      | 'currentTurn'
+      | 'anchorContent'
+      | 'progressPercent'
+      | 'lastAssistantReply'
+      | 'stage'
+      | 'focusCardId'
+      | 'creatorIntent'
+      | 'creatorIntentReadiness'
+      | 'anchorPack'
+      | 'lockState'
+      | 'draftProfile'
+      | 'pendingClarifications'
+      | 'suggestedActions'
+      | 'recommendedReplies'
+      | 'draftCards'
+      | 'qualityFindings'
+      | 'assetCoverage'
+    >
+  >,
+) {
+  return {
+    currentTurn: patch.currentTurn ?? session.currentTurn,
+    anchorContent: patch.anchorContent ?? session.anchorContent,
+    progressPercent: patch.progressPercent ?? session.progressPercent,
+    lastAssistantReply:
+      patch.lastAssistantReply !== undefined
+        ? patch.lastAssistantReply
+        : session.lastAssistantReply,
+    stage: patch.stage ?? session.stage,
+    focusCardId:
+      patch.focusCardId !== undefined ? patch.focusCardId : session.focusCardId,
+    creatorIntent:
+      patch.creatorIntent !== undefined
+        ? patch.creatorIntent
+        : session.creatorIntent,
+    creatorIntentReadiness:
+      patch.creatorIntentReadiness ?? session.creatorIntentReadiness,
+    anchorPack: patch.anchorPack !== undefined ? patch.anchorPack : session.anchorPack,
+    lockState: patch.lockState !== undefined ? patch.lockState : session.lockState,
+    draftProfile:
+      patch.draftProfile !== undefined ? patch.draftProfile : session.draftProfile,
+    pendingClarifications:
+      patch.pendingClarifications !== undefined
+        ? patch.pendingClarifications
+        : session.pendingClarifications,
+    suggestedActions:
+      patch.suggestedActions !== undefined
+        ? patch.suggestedActions
+        : session.suggestedActions,
+    recommendedReplies:
+      patch.recommendedReplies !== undefined
+        ? patch.recommendedReplies
+        : session.recommendedReplies,
+    draftCards: patch.draftCards !== undefined ? patch.draftCards : session.draftCards,
+    qualityFindings:
+      patch.qualityFindings !== undefined
+        ? patch.qualityFindings
+        : session.qualityFindings,
+    assetCoverage:
+      patch.assetCoverage !== undefined
+        ? patch.assetCoverage
+        : session.assetCoverage,
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/expandLongTailExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/expandLongTailExecutor.ts
new file mode 100644
index 00000000..343473fb
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/expandLongTailExecutor.ts
@@ -0,0 +1,116 @@
+import { getWorldFoundationCardId } from '../customWorldAgentDraftCompiler.js';
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentEntityGenerationService } from '../customWorldAgentEntityGenerationService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createExpandLongTailExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  entityGenerationService: CustomWorldAgentEntityGenerationService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'expand_long_tail'> {
+  return async ({ userId, sessionId, operationId }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '扩展长尾内容',
+        phaseDetail: '正在补充边缘角色与次级地点，让世界草稿更完整可玩。',
+        progress: 28,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const baseDraftProfile =
+        (latestSession.draftProfile ?? {}) as Record<string, unknown>;
+      const characterResult =
+        await params.entityGenerationService.generateAdditionalCharacters({
+          creatorIntent: latestSession.creatorIntent,
+          anchorPack: latestSession.anchorPack,
+          draftProfile: baseDraftProfile,
+          count: 2,
+          anchorCardIds:
+            latestSession.focusCardId && latestSession.focusCardId.trim()
+              ? [latestSession.focusCardId]
+              : [getWorldFoundationCardId()],
+        });
+
+      await updateOperation({
+        phaseLabel: '补充次级地点',
+        phaseDetail: '正在围绕新线索补齐可承接支线与长尾内容的地点。',
+        progress: 62,
+      });
+
+      const landmarkResult =
+        await params.entityGenerationService.generateAdditionalLandmarks({
+          creatorIntent: latestSession.creatorIntent,
+          anchorPack: latestSession.anchorPack,
+          draftProfile: characterResult.draftProfile,
+          count: 2,
+          anchorCardIds:
+            characterResult.generatedCharacters.length > 0
+              ? [characterResult.generatedCharacters[0]!.id]
+              : latestSession.focusCardId && latestSession.focusCardId.trim()
+                ? [latestSession.focusCardId]
+                : [getWorldFoundationCardId()],
+        });
+
+      const focusCardId =
+        landmarkResult.generatedLandmarks[0]?.id ??
+        characterResult.generatedCharacters[0]?.id ??
+        latestSession.focusCardId;
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        nextStage: 'long_tail_review',
+        draftProfile: landmarkResult.draftProfile,
+        focusCardId,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: `扩展长尾 ${characterResult.generatedCharacters.length} 角色 / ${landmarkResult.generatedLandmarks.length} 地点`,
+        snapshot: buildCheckpointSnapshot(latestSession, nextState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: `已补出 ${characterResult.generatedCharacters.length} 个长尾角色和 ${landmarkResult.generatedLandmarks.length} 个次级地点，当前阶段进入补全长尾内容。`,
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '长尾内容已扩展',
+        phaseDetail: '长尾角色与次级地点已经补回草稿，可继续收口后进入发布前检查。',
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '扩展长尾失败',
+        phaseDetail: '这一轮没有成功补出长尾内容。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'expand long tail failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/generateCharactersExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/generateCharactersExecutor.ts
new file mode 100644
index 00000000..4931f0e5
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/generateCharactersExecutor.ts
@@ -0,0 +1,110 @@
+import { getWorldFoundationCardId } from '../customWorldAgentDraftCompiler.js';
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentEntityGenerationService } from '../customWorldAgentEntityGenerationService.js';
+import type { CustomWorldAgentChangeSummaryService } from '../customWorldAgentChangeSummaryService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createGenerateCharactersExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  entityGenerationService: CustomWorldAgentEntityGenerationService;
+  changeSummaryService: CustomWorldAgentChangeSummaryService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'generate_characters'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '生成新角色',
+        phaseDetail: '正在围绕当前世界底稿补出新角色。',
+        progress: 32,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const generationResult =
+        await params.entityGenerationService.generateAdditionalCharacters({
+          creatorIntent: latestSession.creatorIntent,
+          anchorPack: latestSession.anchorPack,
+          draftProfile: (latestSession.draftProfile ?? {}) as Record<
+            string,
+            unknown
+          >,
+          count: payload.count,
+          promptText: payload.promptText,
+          anchorCardIds:
+            payload.anchorCardIds && payload.anchorCardIds.length > 0
+              ? payload.anchorCardIds
+              : latestSession.focusCardId
+                ? [latestSession.focusCardId]
+                : [getWorldFoundationCardId()],
+        });
+
+      await updateOperation({
+        phaseLabel: '插入新角色卡',
+        phaseDetail: '正在把新角色插回草稿并刷新卡片列表。',
+        progress: 74,
+      });
+
+      const focusCardId = generationResult.generatedCharacters[0]?.id ?? null;
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        draftProfile: generationResult.draftProfile,
+        focusCardId,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: `新增角色 ${generationResult.generatedCharacters.length} 个`,
+        snapshot: buildCheckpointSnapshot(latestSession, nextState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: params.changeSummaryService.buildSummary({
+            action: 'generate_characters',
+            names: generationResult.generatedCharacters.map(
+              (entry) => entry.name,
+            ),
+            draftProfile: generationResult.draftProfile,
+          }),
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '新角色已加入草稿',
+        phaseDetail: `已补出 ${generationResult.generatedCharacters.length} 个新角色。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '角色生成失败',
+        phaseDetail: '这一轮没有成功补出新角色。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'generate characters failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/generateLandmarksExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/generateLandmarksExecutor.ts
new file mode 100644
index 00000000..1277ff4e
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/generateLandmarksExecutor.ts
@@ -0,0 +1,110 @@
+import { getWorldFoundationCardId } from '../customWorldAgentDraftCompiler.js';
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentEntityGenerationService } from '../customWorldAgentEntityGenerationService.js';
+import type { CustomWorldAgentChangeSummaryService } from '../customWorldAgentChangeSummaryService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createGenerateLandmarksExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  entityGenerationService: CustomWorldAgentEntityGenerationService;
+  changeSummaryService: CustomWorldAgentChangeSummaryService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'generate_landmarks'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '生成新地点',
+        phaseDetail: '正在围绕当前世界底稿补出新地点。',
+        progress: 32,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const generationResult =
+        await params.entityGenerationService.generateAdditionalLandmarks({
+          creatorIntent: latestSession.creatorIntent,
+          anchorPack: latestSession.anchorPack,
+          draftProfile: (latestSession.draftProfile ?? {}) as Record<
+            string,
+            unknown
+          >,
+          count: payload.count,
+          promptText: payload.promptText,
+          anchorCardIds:
+            payload.anchorCardIds && payload.anchorCardIds.length > 0
+              ? payload.anchorCardIds
+              : latestSession.focusCardId
+                ? [latestSession.focusCardId]
+                : [getWorldFoundationCardId()],
+        });
+
+      await updateOperation({
+        phaseLabel: '插入新地点卡',
+        phaseDetail: '正在把新地点插回草稿并刷新卡片列表。',
+        progress: 74,
+      });
+
+      const focusCardId = generationResult.generatedLandmarks[0]?.id ?? null;
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        draftProfile: generationResult.draftProfile,
+        focusCardId,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: `新增地点 ${generationResult.generatedLandmarks.length} 个`,
+        snapshot: buildCheckpointSnapshot(latestSession, nextState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: params.changeSummaryService.buildSummary({
+            action: 'generate_landmarks',
+            names: generationResult.generatedLandmarks.map(
+              (entry) => entry.name,
+            ),
+            draftProfile: generationResult.draftProfile,
+          }),
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '新地点已加入草稿',
+        phaseDetail: `已补出 ${generationResult.generatedLandmarks.length} 个新地点。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '地点生成失败',
+        phaseDetail: '这一轮没有成功补出新地点。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'generate landmarks failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/generateRoleAssetsExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/generateRoleAssetsExecutor.ts
new file mode 100644
index 00000000..2daea938
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/generateRoleAssetsExecutor.ts
@@ -0,0 +1,82 @@
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentAssetBridgeService } from '../customWorldAgentAssetBridgeService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createGenerateRoleAssetsExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  assetBridgeService: CustomWorldAgentAssetBridgeService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'generate_role_assets'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '准备角色资产工坊',
+        phaseDetail: '正在校验角色并整理工坊上下文。',
+        progress: 40,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const roleId = payload.roleIds[0]!;
+      const studioContext = params.assetBridgeService.buildRoleAssetStudioContext(
+        latestSession.draftProfile,
+        roleId,
+      );
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        nextStage: 'visual_refining',
+        draftProfile:
+          (latestSession.draftProfile ?? {}) as Record<string, unknown>,
+        draftCards: latestSession.draftCards,
+        assetCoverage: latestSession.assetCoverage,
+        focusCardId: roleId,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: `已为「${studioContext.roleName}」准备好角色资产工坊，先生成主图候选，再补核心动作。`,
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '角色资产工坊已就绪',
+        phaseDetail: `「${studioContext.roleName}」现在可以开始生成主图和动作。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '角色资产工坊准备失败',
+        phaseDetail: '这一轮没有成功进入角色资产工坊。',
+        progress: 100,
+        error:
+          error instanceof Error
+            ? error.message
+            : 'generate role assets failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/generateSceneAssetsExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/generateSceneAssetsExecutor.ts
new file mode 100644
index 00000000..e2e69ad6
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/generateSceneAssetsExecutor.ts
@@ -0,0 +1,88 @@
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentAssetBridgeService } from '../customWorldAgentAssetBridgeService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createGenerateSceneAssetsExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  assetBridgeService: CustomWorldAgentAssetBridgeService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'generate_scene_assets'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '准备场景资产工坊',
+        phaseDetail: '正在校验目标场景并整理场景图工坊上下文。',
+        progress: 40,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const sceneId = payload.sceneIds[0]!;
+      const sceneKind =
+        latestSession.draftCards.find((entry) => entry.id === sceneId)?.kind ===
+        'camp'
+          ? 'camp'
+          : 'landmark';
+      const sceneContext = params.assetBridgeService.buildSceneAssetStudioContext(
+        latestSession.draftProfile,
+        sceneId,
+        sceneKind,
+      );
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        nextStage: 'visual_refining',
+        draftProfile:
+          (latestSession.draftProfile ?? {}) as Record<string, unknown>,
+        draftCards: latestSession.draftCards,
+        assetCoverage: latestSession.assetCoverage,
+        focusCardId: sceneId,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: `已为「${sceneContext.sceneName}」准备好场景图工坊，保存生成结果后会自动同步回当前草稿。`,
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '场景资产工坊已就绪',
+        phaseDetail: `「${sceneContext.sceneName}」现在可以继续生成和确认正式场景图。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '场景资产工坊准备失败',
+        phaseDetail: '这一轮没有成功进入场景资产工坊。',
+        progress: 100,
+        error:
+          error instanceof Error
+            ? error.message
+            : 'generate scene assets failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/helpers.ts b/server-node/src/services/customWorldAgentActionExecutors/helpers.ts
new file mode 100644
index 00000000..1c838f4f
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/helpers.ts
@@ -0,0 +1,58 @@
+import crypto from 'node:crypto';
+
+import type { CustomWorldAgentMessage } from '../../../../packages/shared/src/contracts/customWorldAgent.js';
+import {
+  normalizeFoundationDraftProfile,
+} from '../customWorldAgentDraftCompiler.js';
+
+export function buildRoleAssetSyncResultText(params: {
+  roleName: string;
+  assetStatusLabel: string;
+}) {
+  return `已把「${params.roleName}」的角色资产写回草稿，当前状态：${params.assetStatusLabel}。`;
+}
+
+export function buildFoundationDraftAssistantMessage(params: {
+  relatedOperationId: string;
+  draftProfile: unknown;
+  warnings?: string[];
+}) {
+  const profile = normalizeFoundationDraftProfile(params.draftProfile);
+  const leadCharacter = profile?.playableNpcs[0];
+  const leadLandmark = profile?.landmarks[0];
+  const warnings = (params.warnings ?? []).filter(Boolean);
+
+  return {
+    id: `message-${crypto.randomBytes(8).toString('hex')}`,
+    role: 'assistant',
+    kind: 'summary',
+    text: [
+      `我先把第一版世界底稿整理出来了：${profile?.summary || '底稿已经生成完成。'}`,
+      '',
+      `当前已经落下来的第一批对象数量是：关键角色 ${profile?.playableNpcs.length ?? 0} 个，关键地点 ${profile?.landmarks.length ?? 0} 个，势力 ${profile?.factions.length ?? 0} 个。`,
+      `建议你先从“${profile?.name || '世界总卡'}”这张世界总卡看起${leadCharacter ? `，再顺着角色「${leadCharacter.name}」往下细修` : ''}${leadLandmark ? `，地点可以先看「${leadLandmark.name}」` : ''}。`,
+      ...(warnings.length > 0
+        ? [
+            '',
+            `这一轮有 ${warnings.length} 项资产补齐未完成，但不影响世界底稿继续精修。`,
+          ]
+        : []),
+    ].join('\n'),
+    createdAt: new Date().toISOString(),
+    relatedOperationId: params.relatedOperationId,
+  } satisfies CustomWorldAgentMessage;
+}
+
+export function buildActionResultMessage(params: {
+  relatedOperationId: string;
+  text: string;
+}) {
+  return {
+    id: `message-${crypto.randomBytes(8).toString('hex')}`,
+    role: 'assistant',
+    kind: 'action_result',
+    text: params.text,
+    createdAt: new Date().toISOString(),
+    relatedOperationId: params.relatedOperationId,
+  } satisfies CustomWorldAgentMessage;
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/index.ts b/server-node/src/services/customWorldAgentActionExecutors/index.ts
new file mode 100644
index 00000000..0dd62e53
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/index.ts
@@ -0,0 +1,105 @@
+import type { CustomWorldAgentAutoAssetService } from '../customWorldAgentAutoAssetService.js';
+import type { CustomWorldAgentAssetBridgeService } from '../customWorldAgentAssetBridgeService.js';
+import type { CustomWorldAgentChangeSummaryService } from '../customWorldAgentChangeSummaryService.js';
+import type { CustomWorldAgentDraftCompiler } from '../customWorldAgentDraftCompiler.js';
+import type { CustomWorldAgentEntityGenerationService } from '../customWorldAgentEntityGenerationService.js';
+import type { CustomWorldAgentFoundationDraftService } from '../customWorldAgentFoundationDraftService.js';
+import type { CustomWorldAgentPublishingService } from '../customWorldAgentPublishingService.js';
+import type { CustomWorldAgentResultSyncService } from '../customWorldAgentResultSyncService.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import { createDraftFoundationExecutor } from './draftFoundationExecutor.js';
+import { createExpandLongTailExecutor } from './expandLongTailExecutor.js';
+import { createGenerateCharactersExecutor } from './generateCharactersExecutor.js';
+import { createGenerateLandmarksExecutor } from './generateLandmarksExecutor.js';
+import { createGenerateRoleAssetsExecutor } from './generateRoleAssetsExecutor.js';
+import { createGenerateSceneAssetsExecutor } from './generateSceneAssetsExecutor.js';
+import { createPublishWorldExecutor } from './publishWorldExecutor.js';
+import { createRevertCheckpointExecutor } from './revertCheckpointExecutor.js';
+import { createSyncResultProfileExecutor } from './syncResultProfileExecutor.js';
+import { createSyncRoleAssetsExecutor } from './syncRoleAssetsExecutor.js';
+import { createSyncSceneAssetsExecutor } from './syncSceneAssetsExecutor.js';
+import type { CustomWorldAgentActionExecutorMap } from './types.js';
+import { createUpdateDraftCardExecutor } from './updateDraftCardExecutor.js';
+
+export * from './types.js';
+
+export function createCustomWorldAgentActionExecutorMap(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  foundationDraftService: CustomWorldAgentFoundationDraftService;
+  draftCompiler: CustomWorldAgentDraftCompiler;
+  entityGenerationService: CustomWorldAgentEntityGenerationService;
+  changeSummaryService: CustomWorldAgentChangeSummaryService;
+  assetBridgeService: CustomWorldAgentAssetBridgeService;
+  autoAssetService: CustomWorldAgentAutoAssetService | null;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+  resultSyncService: CustomWorldAgentResultSyncService;
+  publishingService: CustomWorldAgentPublishingService;
+  resolveAuthorDisplayName?: ((userId: string) => Promise<string>) | null;
+}): CustomWorldAgentActionExecutorMap {
+  return {
+    draft_foundation: createDraftFoundationExecutor({
+      sessionStore: params.sessionStore,
+      foundationDraftService: params.foundationDraftService,
+      autoAssetService: params.autoAssetService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    update_draft_card: createUpdateDraftCardExecutor({
+      sessionStore: params.sessionStore,
+      draftCompiler: params.draftCompiler,
+      changeSummaryService: params.changeSummaryService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    sync_result_profile: createSyncResultProfileExecutor({
+      sessionStore: params.sessionStore,
+      resultSyncService: params.resultSyncService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    generate_characters: createGenerateCharactersExecutor({
+      sessionStore: params.sessionStore,
+      entityGenerationService: params.entityGenerationService,
+      changeSummaryService: params.changeSummaryService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    generate_landmarks: createGenerateLandmarksExecutor({
+      sessionStore: params.sessionStore,
+      entityGenerationService: params.entityGenerationService,
+      changeSummaryService: params.changeSummaryService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    generate_role_assets: createGenerateRoleAssetsExecutor({
+      sessionStore: params.sessionStore,
+      assetBridgeService: params.assetBridgeService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    sync_role_assets: createSyncRoleAssetsExecutor({
+      sessionStore: params.sessionStore,
+      assetBridgeService: params.assetBridgeService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    generate_scene_assets: createGenerateSceneAssetsExecutor({
+      sessionStore: params.sessionStore,
+      assetBridgeService: params.assetBridgeService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    sync_scene_assets: createSyncSceneAssetsExecutor({
+      sessionStore: params.sessionStore,
+      assetBridgeService: params.assetBridgeService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    expand_long_tail: createExpandLongTailExecutor({
+      sessionStore: params.sessionStore,
+      entityGenerationService: params.entityGenerationService,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+    publish_world: createPublishWorldExecutor({
+      sessionStore: params.sessionStore,
+      publishingService: params.publishingService,
+      resolveAuthorDisplayName: params.resolveAuthorDisplayName ?? null,
+    }),
+    revert_checkpoint: createRevertCheckpointExecutor({
+      sessionStore: params.sessionStore,
+      snapshotBuilder: params.snapshotBuilder,
+    }),
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/publishWorldExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/publishWorldExecutor.ts
new file mode 100644
index 00000000..b3b4694f
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/publishWorldExecutor.ts
@@ -0,0 +1,166 @@
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentPublishingService } from '../customWorldAgentPublishingService.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function extractPublishBlockerMessages(message: string) {
+  const normalized = message.trim();
+  if (!normalized) {
+    return [];
+  }
+
+  const detailText = normalized.includes('：')
+    ? normalized.split('：').slice(1).join('：').trim()
+    : normalized;
+
+  return detailText
+    .split('；')
+    .map((entry) => entry.trim())
+    .filter(Boolean);
+}
+
+function buildGateFailureMessage(errorMessage: string) {
+  return [
+    '当前世界还不能发布，先把这些阻断项补齐：',
+    ...(extractPublishBlockerMessages(errorMessage).length > 0
+      ? extractPublishBlockerMessages(errorMessage)
+      : [errorMessage.trim()]
+    )
+      .slice(0, 4)
+      .map((entry, index) => `${index + 1}. ${entry}`),
+  ].join('\n');
+}
+
+function resolvePublishedWorldName(profile: unknown) {
+  const profileRecord =
+    profile && typeof profile === 'object' && !Array.isArray(profile)
+      ? (profile as Record<string, unknown>)
+      : null;
+
+  return toText(profileRecord?.name) || '当前世界';
+}
+
+export function createPublishWorldExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  publishingService: CustomWorldAgentPublishingService;
+  resolveAuthorDisplayName?: ((userId: string) => Promise<string>) | null;
+}): CustomWorldAgentActionExecutor<'publish_world'> {
+  return async ({ userId, sessionId, operationId }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '执行发布校验',
+        phaseDetail: '正在检查角色资产、场景图和主线草稿是否满足发布门槛。',
+        progress: 28,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      try {
+        params.publishingService.buildPublishReadiness({
+          sessionId,
+          draftProfile: latestSession.draftProfile,
+          qualityFindings: latestSession.qualityFindings,
+        });
+      } catch (error) {
+        const errorMessage =
+          error instanceof Error ? error.message : 'publish world failed';
+        await params.sessionStore.appendMessage(
+          userId,
+          sessionId,
+          {
+            id: `message-${Date.now().toString(36)}-publish-warning`,
+            role: 'assistant',
+            kind: 'warning',
+            text: buildGateFailureMessage(errorMessage),
+            createdAt: new Date().toISOString(),
+            relatedOperationId: operationId,
+          },
+        );
+        throw error;
+      }
+
+      await updateOperation({
+        phaseLabel: '发布正式世界',
+        phaseDetail: '正在把当前草稿编译成正式世界档案并写入作品库。',
+        progress: 68,
+      });
+
+      const authorDisplayName = params.resolveAuthorDisplayName
+        ? await params.resolveAuthorDisplayName(userId)
+        : '玩家';
+      const publishResult = await params.publishingService.publishSessionDraft({
+        userId,
+        authorDisplayName: authorDisplayName.trim() || '玩家',
+        sessionId,
+        draftProfile:
+          (latestSession.draftProfile ?? {}) as Record<string, unknown>,
+        qualityFindings: latestSession.qualityFindings,
+      });
+      const worldName = resolvePublishedWorldName(publishResult.publishedProfile);
+      const publishedQualityFindings = latestSession.qualityFindings.filter(
+        (entry) => entry.severity !== 'blocker',
+      );
+      const publishedState = {
+        stage: 'published' as const,
+        qualityFindings: publishedQualityFindings,
+      };
+
+      await params.sessionStore.replaceDerivedState(
+        userId,
+        sessionId,
+        publishedState,
+      );
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: `发布世界 ${worldName}`,
+        snapshot: buildCheckpointSnapshot(latestSession, publishedState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text:
+            publishedQualityFindings.length > 0
+              ? `世界「${worldName}」已发布，并保留 ${publishedQualityFindings.length} 条 warning 供后续继续优化。`
+              : `世界「${worldName}」已正式发布，可以进入作品库与世界入口。`,
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '世界已发布',
+        phaseDetail: `正式世界档案已写入作品库：${publishResult.profileId}。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '发布失败',
+        phaseDetail: '当前世界还没有通过发布校验或写入作品库失败。',
+        progress: 100,
+        error: error instanceof Error ? error.message : 'publish world failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/revertCheckpointExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/revertCheckpointExecutor.ts
new file mode 100644
index 00000000..0c70585c
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/revertCheckpointExecutor.ts
@@ -0,0 +1,95 @@
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createRevertCheckpointExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'revert_checkpoint'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '恢复历史检查点',
+        phaseDetail: '正在把指定检查点的草稿状态恢复到当前会话。',
+        progress: 36,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const checkpoint = latestSession.checkpoints.find(
+        (entry) => entry.checkpointId === payload.checkpointId,
+      );
+      if (!checkpoint?.snapshot) {
+        throw new Error('目标检查点不存在，或当前检查点还没有可恢复快照。');
+      }
+
+      await params.sessionStore.restoreCheckpoint(
+        userId,
+        sessionId,
+        payload.checkpointId,
+      );
+      const restoredSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: restoredSession.stage,
+        nextStage:
+          restoredSession.stage === 'visual_refining' ||
+          restoredSession.stage === 'long_tail_review' ||
+          restoredSession.stage === 'ready_to_publish'
+            ? restoredSession.stage
+            : 'object_refining',
+        draftProfile:
+          (restoredSession.draftProfile ?? {}) as Record<string, unknown>,
+        focusCardId: restoredSession.focusCardId,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: `已恢复到检查点「${checkpoint.label}」，当前草稿和卡片摘要已经回滚到对应版本。`,
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '检查点已恢复',
+        phaseDetail: `已恢复到「${checkpoint.label}」。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '恢复检查点失败',
+        phaseDetail: '这一轮没有成功恢复历史检查点。',
+        progress: 100,
+        error:
+          error instanceof Error
+            ? error.message
+            : 'revert checkpoint failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/syncResultProfileExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/syncResultProfileExecutor.ts
new file mode 100644
index 00000000..2058fc3b
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/syncResultProfileExecutor.ts
@@ -0,0 +1,87 @@
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentResultSyncService } from '../customWorldAgentResultSyncService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createSyncResultProfileExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  resultSyncService: CustomWorldAgentResultSyncService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'sync_result_profile'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '同步结果页快照',
+        phaseDetail: '正在把结果页里的最新世界结构写回当前草稿。',
+        progress: 36,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const nextDraftProfile =
+        params.resultSyncService.syncResultProfileIntoDraftProfile({
+          currentDraftProfile: latestSession.draftProfile,
+          resultProfile: payload.profile as never,
+        });
+
+      await updateOperation({
+        phaseLabel: '重编译草稿摘要',
+        phaseDetail: '正在刷新草稿卡摘要、资产覆盖和结果页恢复快照。',
+        progress: 72,
+      });
+
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        draftProfile: nextDraftProfile,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: '同步结果页编辑',
+        snapshot: buildCheckpointSnapshot(latestSession, nextState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: '结果页里的最新世界结构已经同步回当前草稿。',
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '结果页快照已同步',
+        phaseDetail: '当前结果页编辑内容已经并回 Agent 草稿主链。',
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '结果页同步失败',
+        phaseDetail: '这一轮结果页编辑没有成功写回当前草稿。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'sync result profile failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/syncRoleAssetsExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/syncRoleAssetsExecutor.ts
new file mode 100644
index 00000000..5cd581c3
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/syncRoleAssetsExecutor.ts
@@ -0,0 +1,97 @@
+import { resolveRoleAssetStatusLabel } from '../customWorldAgentRoleAssetStateService.js';
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentAssetBridgeService } from '../customWorldAgentAssetBridgeService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import {
+  buildActionResultMessage,
+  buildRoleAssetSyncResultText,
+} from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createSyncRoleAssetsExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  assetBridgeService: CustomWorldAgentAssetBridgeService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'sync_role_assets'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '同步角色资产',
+        phaseDetail: '正在把主图与动作结果写回当前世界草稿。',
+        progress: 36,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const syncResult = params.assetBridgeService.applyRoleAssetPublishResult(
+        latestSession.draftProfile,
+        payload,
+      );
+
+      await updateOperation({
+        phaseLabel: '刷新角色卡摘要',
+        phaseDetail: '正在同步更新角色卡状态与资产覆盖。',
+        progress: 72,
+      });
+
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        nextStage: 'visual_refining',
+        draftProfile: syncResult.draftProfile,
+        focusCardId: payload.roleId,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: `同步角色资产 ${syncResult.updatedAssetSummary.roleName}`,
+        snapshot: buildCheckpointSnapshot(latestSession, nextState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: buildRoleAssetSyncResultText({
+            roleName: syncResult.updatedAssetSummary.roleName,
+            assetStatusLabel: resolveRoleAssetStatusLabel(
+              syncResult.updatedAssetSummary.status,
+            ),
+          }),
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '角色资产已同步',
+        phaseDetail: `「${syncResult.updatedAssetSummary.roleName}」的资产状态已更新为${resolveRoleAssetStatusLabel(syncResult.updatedAssetSummary.status)}。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '角色资产同步失败',
+        phaseDetail: '这一轮没有成功把角色资产写回草稿。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'sync role assets failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/syncSceneAssetsExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/syncSceneAssetsExecutor.ts
new file mode 100644
index 00000000..6dc24354
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/syncSceneAssetsExecutor.ts
@@ -0,0 +1,88 @@
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentAssetBridgeService } from '../customWorldAgentAssetBridgeService.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createSyncSceneAssetsExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  assetBridgeService: CustomWorldAgentAssetBridgeService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'sync_scene_assets'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '同步场景资产',
+        phaseDetail: '正在把营地/地点场景图写回当前世界草稿。',
+        progress: 38,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const syncResult = params.assetBridgeService.applySceneAssetPublishResult(
+        latestSession.draftProfile,
+        payload,
+      );
+
+      await updateOperation({
+        phaseLabel: '刷新场景卡摘要',
+        phaseDetail: '正在更新地点卡、幕背景摘要和场景资产覆盖率。',
+        progress: 72,
+      });
+
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        nextStage: 'visual_refining',
+        draftProfile: syncResult.draftProfile,
+        focusCardId: payload.sceneId,
+      });
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: `同步场景资产 ${String(syncResult.updatedScene.name ?? payload.sceneId)}`,
+        snapshot: buildCheckpointSnapshot(latestSession, nextState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: `已把「${String(syncResult.updatedScene.name ?? '当前场景')}」的场景图写回草稿，并同步刷新地点卡与幕背景状态。`,
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '场景资产已同步',
+        phaseDetail: `「${String(syncResult.updatedScene.name ?? '当前场景')}」的场景图已经进入当前草稿。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '场景资产同步失败',
+        phaseDetail: '这一轮没有成功把场景图写回当前草稿。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'sync scene assets failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionExecutors/types.ts b/server-node/src/services/customWorldAgentActionExecutors/types.ts
new file mode 100644
index 00000000..93d10e91
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/types.ts
@@ -0,0 +1,29 @@
+import type { CustomWorldAgentActionRequest } from '../../../../packages/shared/src/contracts/customWorldAgent.js';
+
+export type CustomWorldAgentActionPayload<
+  K extends CustomWorldAgentActionRequest['action'],
+> = Extract<CustomWorldAgentActionRequest, { action: K }>;
+
+export type CustomWorldAgentActionExecutor<
+  K extends CustomWorldAgentActionRequest['action'],
+> = (params: {
+  userId: string;
+  sessionId: string;
+  operationId: string;
+  payload: CustomWorldAgentActionPayload<K>;
+}) => Promise<void>;
+
+export type CustomWorldAgentActionExecutorMap = {
+  draft_foundation: CustomWorldAgentActionExecutor<'draft_foundation'>;
+  update_draft_card: CustomWorldAgentActionExecutor<'update_draft_card'>;
+  sync_result_profile: CustomWorldAgentActionExecutor<'sync_result_profile'>;
+  generate_characters: CustomWorldAgentActionExecutor<'generate_characters'>;
+  generate_landmarks: CustomWorldAgentActionExecutor<'generate_landmarks'>;
+  generate_role_assets: CustomWorldAgentActionExecutor<'generate_role_assets'>;
+  sync_role_assets: CustomWorldAgentActionExecutor<'sync_role_assets'>;
+  generate_scene_assets: CustomWorldAgentActionExecutor<'generate_scene_assets'>;
+  sync_scene_assets: CustomWorldAgentActionExecutor<'sync_scene_assets'>;
+  expand_long_tail: CustomWorldAgentActionExecutor<'expand_long_tail'>;
+  publish_world: CustomWorldAgentActionExecutor<'publish_world'>;
+  revert_checkpoint: CustomWorldAgentActionExecutor<'revert_checkpoint'>;
+};
diff --git a/server-node/src/services/customWorldAgentActionExecutors/updateDraftCardExecutor.ts b/server-node/src/services/customWorldAgentActionExecutors/updateDraftCardExecutor.ts
new file mode 100644
index 00000000..a3a5fcc2
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionExecutors/updateDraftCardExecutor.ts
@@ -0,0 +1,111 @@
+import { updateDraftCardSections } from '../customWorldAgentDraftEditService.js';
+import type { CustomWorldAgentActionExecutor } from './types.js';
+import type { CustomWorldAgentChangeSummaryService } from '../customWorldAgentChangeSummaryService.js';
+import type { CustomWorldAgentDraftCompiler } from '../customWorldAgentDraftCompiler.js';
+import type { CustomWorldAgentSnapshotBuilder } from '../customWorldAgentSnapshotBuilder.js';
+import type { CustomWorldAgentSessionStore } from '../customWorldAgentSessionStore.js';
+import { buildActionResultMessage } from './helpers.js';
+import {
+  buildCheckpointSnapshot,
+  createOperationUpdater,
+  getRequiredSession,
+} from './executorShared.js';
+
+export function createUpdateDraftCardExecutor(params: {
+  sessionStore: CustomWorldAgentSessionStore;
+  draftCompiler: CustomWorldAgentDraftCompiler;
+  changeSummaryService: CustomWorldAgentChangeSummaryService;
+  snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+}): CustomWorldAgentActionExecutor<'update_draft_card'> {
+  return async ({ userId, sessionId, operationId, payload }) => {
+    const updateOperation = createOperationUpdater({
+      sessionStore: params.sessionStore,
+      userId,
+      sessionId,
+      operationId,
+    });
+
+    try {
+      await updateOperation({
+        status: 'running',
+        phaseLabel: '写回草稿设定',
+        phaseDetail: '正在把这次编辑内容写回当前世界底稿。',
+        progress: 34,
+      });
+
+      const latestSession = await getRequiredSession({
+        sessionStore: params.sessionStore,
+        userId,
+        sessionId,
+      });
+      const nextDraftProfile = updateDraftCardSections({
+        draftProfile: (latestSession.draftProfile ?? {}) as Record<
+          string,
+          unknown
+        >,
+        cardId: payload.cardId,
+        sections: payload.sections,
+      });
+
+      await updateOperation({
+        phaseLabel: '重编译草稿卡',
+        phaseDetail: '正在同步更新草稿摘要和详情内容。',
+        progress: 72,
+      });
+
+      const nextState = params.snapshotBuilder.buildRefiningState({
+        previousStage: latestSession.stage,
+        draftProfile: nextDraftProfile,
+        focusCardId: payload.cardId,
+      });
+      const updatedDetail = params.draftCompiler.getDraftCardDetail(
+        nextDraftProfile,
+        payload.cardId,
+      );
+      const changedSectionIds = new Set(
+        payload.sections
+          .map((section) => section.sectionId.trim())
+          .filter(Boolean),
+      );
+
+      await params.sessionStore.replaceDerivedState(userId, sessionId, nextState);
+      await params.sessionStore.appendCheckpoint(userId, sessionId, {
+        label: `编辑 ${updatedDetail?.title || '草稿卡'}`,
+        snapshot: buildCheckpointSnapshot(latestSession, nextState),
+      });
+      await params.sessionStore.appendMessage(
+        userId,
+        sessionId,
+        buildActionResultMessage({
+          relatedOperationId: operationId,
+          text: params.changeSummaryService.buildSummary({
+            action: 'update_draft_card',
+            cardId: payload.cardId,
+            changedLabels:
+              updatedDetail?.sections
+                .filter((section) => changedSectionIds.has(section.id))
+                .map((section) => section.label) ?? [],
+            draftProfile: nextDraftProfile,
+          }),
+        }),
+      );
+
+      await updateOperation({
+        status: 'completed',
+        phaseLabel: '草稿设定已保存',
+        phaseDetail: `「${updatedDetail?.title || '当前卡片'}」的设定已经同步更新。`,
+        progress: 100,
+        error: null,
+      });
+    } catch (error) {
+      await updateOperation({
+        status: 'failed',
+        phaseLabel: '保存失败',
+        phaseDetail: '这次草稿编辑没有成功写回到底稿。',
+        progress: 100,
+        error:
+          error instanceof Error ? error.message : 'update draft card failed',
+      });
+    }
+  };
+}
diff --git a/server-node/src/services/customWorldAgentActionRegistry.test.ts b/server-node/src/services/customWorldAgentActionRegistry.test.ts
new file mode 100644
index 00000000..00b0ca89
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionRegistry.test.ts
@@ -0,0 +1,260 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import type { CustomWorldAgentActionExecutorMap } from './customWorldAgentActionExecutors/index.js';
+import { CustomWorldAgentActionRegistry } from './customWorldAgentActionRegistry.js';
+import { createRpgAgentSessionFixture } from '../../../packages/shared/src/contracts/rpgCreationFixtures.js';
+
+function createExecutorLog() {
+  const calls: Array<{
+    action: keyof CustomWorldAgentActionExecutorMap;
+    payload: unknown;
+    userId: string;
+    sessionId: string;
+    operationId: string;
+  }> = [];
+
+  const createExecutor = <K extends keyof CustomWorldAgentActionExecutorMap>(
+    action: K,
+  ): CustomWorldAgentActionExecutorMap[K] => {
+    return (async (params) => {
+      calls.push({
+        action,
+        payload: params.payload,
+        userId: params.userId,
+        sessionId: params.sessionId,
+        operationId: params.operationId,
+      });
+    }) as CustomWorldAgentActionExecutorMap[K];
+  };
+
+  return {
+    calls,
+    executors: {
+      draft_foundation: createExecutor('draft_foundation'),
+      update_draft_card: createExecutor('update_draft_card'),
+      sync_result_profile: createExecutor('sync_result_profile'),
+      generate_characters: createExecutor('generate_characters'),
+      generate_landmarks: createExecutor('generate_landmarks'),
+      generate_role_assets: createExecutor('generate_role_assets'),
+      sync_role_assets: createExecutor('sync_role_assets'),
+      generate_scene_assets: createExecutor('generate_scene_assets'),
+      sync_scene_assets: createExecutor('sync_scene_assets'),
+      expand_long_tail: createExecutor('expand_long_tail'),
+      publish_world: createExecutor('publish_world'),
+      revert_checkpoint: createExecutor('revert_checkpoint'),
+    } satisfies CustomWorldAgentActionExecutorMap,
+  };
+}
+
+function createSessionRecord(overrides: Partial<Record<string, unknown>> = {}) {
+  const session = createRpgAgentSessionFixture();
+
+  return {
+    ...JSON.parse(JSON.stringify(session)),
+    userId: 'fixture-user',
+    seedText: '被海雾吞没的旧航路群岛',
+    operations: [],
+    checkpoints: [],
+    createdAt: session.updatedAt,
+    updatedAt: session.updatedAt,
+    ...overrides,
+  };
+}
+
+test('action registry exposes supported actions with stage-aware enablement and disabled reasons', () => {
+  const { executors } = createExecutorLog();
+  const registry = new CustomWorldAgentActionRegistry(executors);
+  const session = createSessionRecord({
+    stage: 'foundation_review',
+    progressPercent: 80,
+  });
+  const supportedActions = registry.buildSupportedActions(session as never);
+  const draftFoundation = supportedActions.find(
+    (entry) => entry.action === 'draft_foundation',
+  );
+  const syncResultProfile = supportedActions.find(
+    (entry) => entry.action === 'sync_result_profile',
+  );
+  const publishWorld = supportedActions.find(
+    (entry) => entry.action === 'publish_world',
+  );
+  const expandLongTail = supportedActions.find(
+    (entry) => entry.action === 'expand_long_tail',
+  );
+  const revertCheckpoint = supportedActions.find(
+    (entry) => entry.action === 'revert_checkpoint',
+  );
+
+  assert.equal(draftFoundation?.enabled, false);
+  assert.match(draftFoundation?.reason ?? '', /progressPercent >= 100/u);
+  assert.equal(syncResultProfile?.enabled, false);
+  assert.match(
+    syncResultProfile?.reason ?? '',
+    /object_refining or visual_refining/u,
+  );
+  assert.equal(publishWorld?.enabled, false);
+  assert.match(
+    publishWorld?.reason ?? '',
+    /object_refining, visual_refining, long_tail_review or ready_to_publish/u,
+  );
+  assert.equal(expandLongTail?.enabled, false);
+  assert.match(
+    expandLongTail?.reason ?? '',
+    /object_refining, visual_refining, long_tail_review or ready_to_publish/u,
+  );
+  assert.equal(revertCheckpoint?.enabled, false);
+  assert.match(
+    revertCheckpoint?.reason ?? '',
+    /requires at least one restorable checkpoint snapshot/u,
+  );
+});
+
+test('action registry enables long-tail and publish actions in late stages, and exposes revert when restorable checkpoint exists', () => {
+  const { executors } = createExecutorLog();
+  const registry = new CustomWorldAgentActionRegistry(executors);
+  const session = createSessionRecord({
+    stage: 'ready_to_publish',
+    checkpoints: [
+      {
+        checkpointId: 'checkpoint-1',
+        createdAt: '2026-04-21T12:00:00.000Z',
+        label: '可回滚版本',
+        snapshot: {
+          currentTurn: 2,
+          anchorContent: createSessionRecord().anchorContent,
+          progressPercent: 100,
+          lastAssistantReply: '已生成草稿。',
+          stage: 'object_refining',
+          focusCardId: 'world-foundation',
+          creatorIntent: {},
+          creatorIntentReadiness: {
+            isReady: true,
+            completedKeys: [],
+            missingKeys: [],
+          },
+          anchorPack: {},
+          lockState: {},
+          draftProfile: createSessionRecord().draftProfile,
+          pendingClarifications: [],
+          suggestedActions: [],
+          recommendedReplies: [],
+          draftCards: createSessionRecord().draftCards,
+          qualityFindings: [],
+          assetCoverage: createSessionRecord().assetCoverage,
+        },
+      },
+    ],
+  });
+
+  const supportedActions = registry.buildSupportedActions(session as never);
+
+  assert.equal(
+    supportedActions.find((entry) => entry.action === 'expand_long_tail')?.enabled,
+    true,
+  );
+  assert.equal(
+    supportedActions.find((entry) => entry.action === 'publish_world')?.enabled,
+    true,
+  );
+  assert.equal(
+    supportedActions.find((entry) => entry.action === 'revert_checkpoint')?.enabled,
+    true,
+  );
+});
+
+test('action registry validates sync_scene_assets required payload and dispatches scene action executors', async () => {
+  const { calls, executors } = createExecutorLog();
+  const registry = new CustomWorldAgentActionRegistry(executors);
+  const session = createSessionRecord({
+    stage: 'visual_refining',
+  });
+
+  assert.throws(
+    () =>
+      registry.prepareExecution(session as never, {
+        action: 'sync_scene_assets',
+        sceneId: 'camp-home',
+        sceneKind: 'camp',
+        imageSrc: '',
+        generatedSceneAssetId: 'scene-asset-1',
+      }),
+    /imageSrc and generatedSceneAssetId/u,
+  );
+
+  const prepared = registry.prepareExecution(session as never, {
+    action: 'generate_scene_assets',
+    sceneIds: ['camp-home'],
+  });
+
+  assert.equal(prepared.operationType, 'generate_scene_assets');
+
+  await prepared.execute({
+    userId: 'fixture-user',
+    sessionId: 'fixture-session',
+    operationId: 'operation-scene-1',
+  });
+
+  assert.equal(calls.at(-1)?.action, 'generate_scene_assets');
+});
+
+test('action registry normalizes sync_result_profile payload before dispatching executor', async () => {
+  const { calls, executors } = createExecutorLog();
+  const registry = new CustomWorldAgentActionRegistry(executors);
+  const session = createSessionRecord({
+    stage: 'object_refining',
+  });
+  const prepared = registry.prepareExecution(session as never, {
+    action: 'sync_result_profile',
+    profile: {
+      id: 'profile-1',
+      settingText: '潮雾列岛',
+      name: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '结果页确认版。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清真相。',
+      templateWorldType: 'WUXIA',
+      majorFactions: ['守灯会'],
+      coreConflicts: ['争夺旧航路控制权'],
+      playableNpcs: [],
+      storyNpcs: [],
+      items: [],
+      landmarks: [],
+      generationMode: 'full',
+      generationStatus: 'complete',
+    },
+  });
+
+  assert.equal(prepared.operationType, 'sync_result_profile');
+
+  await prepared.execute({
+    userId: 'fixture-user',
+    sessionId: 'fixture-session',
+    operationId: 'operation-1',
+  });
+
+  assert.equal(calls.length, 1);
+  assert.equal(calls[0]?.action, 'sync_result_profile');
+  assert.equal(
+    (calls[0]?.payload as { profile?: { name?: string } })?.profile?.name,
+    '潮雾列岛',
+  );
+});
+
+test('action registry rejects invalid generate_role_assets payload with unit-level validation', () => {
+  const { executors } = createExecutorLog();
+  const registry = new CustomWorldAgentActionRegistry(executors);
+  const session = createSessionRecord({
+    stage: 'object_refining',
+  });
+
+  assert.throws(
+    () =>
+      registry.prepareExecution(session as never, {
+        action: 'generate_role_assets',
+        roleIds: ['playable-1', 'story-1'],
+      }),
+    /exactly one roleId/u,
+  );
+});
diff --git a/server-node/src/services/customWorldAgentActionRegistry.ts b/server-node/src/services/customWorldAgentActionRegistry.ts
new file mode 100644
index 00000000..07f7f133
--- /dev/null
+++ b/server-node/src/services/customWorldAgentActionRegistry.ts
@@ -0,0 +1,403 @@
+import type {
+  CustomWorldAgentActionRequest,
+  CustomWorldAgentOperationRecord,
+  CustomWorldSupportedAction,
+} from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import { badRequest } from '../errors.js';
+import { normalizeCustomWorldProfile } from '../modules/custom-world/runtimeProfile.js';
+import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
+import type {
+  CustomWorldAgentActionExecutorMap,
+  CustomWorldAgentActionPayload,
+} from './customWorldAgentActionExecutors/index.js';
+import type { CustomWorldAgentSessionRecord } from './customWorldAgentSessionStore.js';
+
+type EnabledAction = keyof CustomWorldAgentActionExecutorMap;
+type EnabledDescriptor<K extends EnabledAction> = {
+  operationType: CustomWorldAgentOperationRecord['type'];
+  normalizePayload?: (
+    payload: CustomWorldAgentActionPayload<K>,
+  ) => CustomWorldAgentActionPayload<K>;
+  validate?: (
+    session: CustomWorldAgentSessionRecord,
+    payload: CustomWorldAgentActionPayload<K>,
+  ) => void;
+  execute: CustomWorldAgentActionExecutorMap[K];
+};
+type DisabledAction = Exclude<CustomWorldAgentActionRequest['action'], EnabledAction>;
+type DisabledDescriptor = {
+  disabledReason: string;
+};
+
+type ActionCapabilityState = {
+  enabled: boolean;
+  reason?: string;
+};
+
+function assertDraftRefiningActionAvailable(
+  session: CustomWorldAgentSessionRecord,
+  action: string,
+) {
+  if (
+    session.stage !== 'object_refining' &&
+    session.stage !== 'visual_refining'
+  ) {
+    throw badRequest(
+      `${action} is only available during object_refining or visual_refining`,
+    );
+  }
+
+  const hasDraftFoundation = Boolean(
+    normalizeFoundationDraftProfile(session.draftProfile) &&
+      session.draftCards.length > 0,
+  );
+  if (!hasDraftFoundation) {
+    throw badRequest(`${action} requires an existing draft foundation`);
+  }
+}
+
+function assertLongTailActionAvailable(
+  session: CustomWorldAgentSessionRecord,
+  action: string,
+) {
+  if (
+    session.stage !== 'object_refining' &&
+    session.stage !== 'visual_refining' &&
+    session.stage !== 'long_tail_review' &&
+    session.stage !== 'ready_to_publish'
+  ) {
+    throw badRequest(
+      `${action} is only available during object_refining, visual_refining, long_tail_review or ready_to_publish`,
+    );
+  }
+}
+
+function assertPublishActionAvailable(
+  session: CustomWorldAgentSessionRecord,
+  action: string,
+) {
+  assertLongTailActionAvailable(session, action);
+  if (!normalizeFoundationDraftProfile(session.draftProfile)) {
+    throw badRequest(`${action} requires an existing draft foundation`);
+  }
+}
+
+export type PreparedCustomWorldAgentActionExecution = {
+  operationType: CustomWorldAgentOperationRecord['type'];
+  execute: (params: {
+    userId: string;
+    sessionId: string;
+    operationId: string;
+  }) => Promise<void>;
+};
+
+export class CustomWorldAgentActionRegistry {
+  private readonly descriptors: Record<
+    CustomWorldAgentActionRequest['action'],
+    EnabledDescriptor<EnabledAction> | DisabledDescriptor
+  >;
+
+  constructor(executors: CustomWorldAgentActionExecutorMap) {
+    this.descriptors = {
+      draft_foundation: {
+        operationType: 'draft_foundation',
+        validate: (session) => {
+          if (session.progressPercent < 100) {
+            throw badRequest('draft_foundation requires progressPercent >= 100');
+          }
+        },
+        execute: executors.draft_foundation,
+      },
+      update_draft_card: {
+        operationType: 'update_draft_card',
+        validate: (session, payload) => {
+          assertDraftRefiningActionAvailable(session, payload.action);
+          if (!payload.cardId.trim()) {
+            throw badRequest('update_draft_card requires cardId');
+          }
+          if (!Array.isArray(payload.sections) || payload.sections.length === 0) {
+            throw badRequest('update_draft_card requires sections');
+          }
+        },
+        execute: executors.update_draft_card,
+      },
+      sync_result_profile: {
+        operationType: 'sync_result_profile',
+        normalizePayload: (payload) => {
+          const normalizedProfile = normalizeCustomWorldProfile(payload.profile, '');
+          if (!normalizedProfile) {
+            throw badRequest('sync_result_profile requires a valid profile');
+          }
+
+          return {
+            ...payload,
+            profile: normalizedProfile as unknown as Record<string, unknown>,
+          };
+        },
+        validate: (session, payload) => {
+          assertDraftRefiningActionAvailable(session, payload.action);
+        },
+        execute: executors.sync_result_profile,
+      },
+      generate_characters: {
+        operationType: 'generate_characters',
+        validate: (session, payload) => {
+          assertDraftRefiningActionAvailable(session, payload.action);
+          if (payload.count < 1 || payload.count > 3) {
+            throw badRequest(
+              'generate_characters count must be between 1 and 3',
+            );
+          }
+        },
+        execute: executors.generate_characters,
+      },
+      generate_landmarks: {
+        operationType: 'generate_landmarks',
+        validate: (session, payload) => {
+          assertDraftRefiningActionAvailable(session, payload.action);
+          if (payload.count < 1 || payload.count > 3) {
+            throw badRequest(
+              'generate_landmarks count must be between 1 and 3',
+            );
+          }
+        },
+        execute: executors.generate_landmarks,
+      },
+      generate_role_assets: {
+        operationType: 'generate_role_assets',
+        validate: (session, payload) => {
+          assertDraftRefiningActionAvailable(session, payload.action);
+          if (!Array.isArray(payload.roleIds) || payload.roleIds.length !== 1) {
+            throw badRequest(
+              'generate_role_assets currently requires exactly one roleId',
+            );
+          }
+        },
+        execute: executors.generate_role_assets,
+      },
+      sync_role_assets: {
+        operationType: 'sync_role_assets',
+        validate: (session, payload) => {
+          assertDraftRefiningActionAvailable(session, payload.action);
+          if (!payload.roleId.trim()) {
+            throw badRequest('sync_role_assets requires roleId');
+          }
+          if (
+            !payload.portraitPath.trim() ||
+            !payload.generatedVisualAssetId.trim()
+          ) {
+            throw badRequest(
+              'sync_role_assets requires portraitPath and generatedVisualAssetId',
+            );
+          }
+        },
+        execute: executors.sync_role_assets,
+      },
+      generate_scene_assets: {
+        operationType: 'generate_scene_assets',
+        validate: (session, payload) => {
+          assertDraftRefiningActionAvailable(session, payload.action);
+          if (!Array.isArray(payload.sceneIds) || payload.sceneIds.length !== 1) {
+            throw badRequest(
+              'generate_scene_assets currently requires exactly one sceneId',
+            );
+          }
+        },
+        execute: executors.generate_scene_assets,
+      },
+      sync_scene_assets: {
+        operationType: 'sync_scene_assets',
+        validate: (session, payload) => {
+          assertDraftRefiningActionAvailable(session, payload.action);
+          if (!payload.sceneId.trim()) {
+            throw badRequest('sync_scene_assets requires sceneId');
+          }
+          if (!payload.imageSrc.trim() || !payload.generatedSceneAssetId.trim()) {
+            throw badRequest(
+              'sync_scene_assets requires imageSrc and generatedSceneAssetId',
+            );
+          }
+        },
+        execute: executors.sync_scene_assets,
+      },
+      expand_long_tail: {
+        operationType: 'expand_long_tail',
+        validate: (session, payload) => {
+          assertLongTailActionAvailable(session, payload.action);
+          if (!normalizeFoundationDraftProfile(session.draftProfile)) {
+            throw badRequest('expand_long_tail requires an existing draft foundation');
+          }
+        },
+        execute: executors.expand_long_tail,
+      },
+      publish_world: {
+        operationType: 'publish_world',
+        validate: (session, payload) => {
+          assertPublishActionAvailable(session, payload.action);
+        },
+        execute: executors.publish_world,
+      },
+      revert_checkpoint: {
+        operationType: 'revert_checkpoint',
+        validate: (session, payload) => {
+          assertLongTailActionAvailable(session, payload.action);
+          if (!payload.checkpointId.trim()) {
+            throw badRequest('revert_checkpoint requires checkpointId');
+          }
+          const checkpoint = session.checkpoints.find(
+            (entry) => entry.checkpointId === payload.checkpointId,
+          );
+          if (!checkpoint) {
+            throw badRequest('revert_checkpoint target checkpoint does not exist');
+          }
+          if (!checkpoint.snapshot) {
+            throw badRequest(
+              'revert_checkpoint target checkpoint does not contain a restorable snapshot',
+            );
+          }
+        },
+        execute: executors.revert_checkpoint,
+      },
+    };
+  }
+
+  // orchestrator 只关心“拿到一个已校验的动作执行计划”，不再自己维护所有 action 分支。
+  prepareExecution(
+    session: CustomWorldAgentSessionRecord,
+    payload: CustomWorldAgentActionRequest,
+  ): PreparedCustomWorldAgentActionExecution {
+    const descriptor = this.descriptors[payload.action];
+    if ('disabledReason' in descriptor) {
+      throw badRequest(descriptor.disabledReason);
+    }
+
+    const normalizedPayload = descriptor.normalizePayload
+      ? descriptor.normalizePayload(payload as never)
+      : payload;
+
+    descriptor.validate?.(session, normalizedPayload as never);
+
+    return {
+      operationType: descriptor.operationType,
+      execute: ({ userId, sessionId, operationId }) =>
+        descriptor.execute({
+          userId,
+          sessionId,
+          operationId,
+          payload: normalizedPayload as never,
+        }),
+    };
+  }
+
+  buildSupportedActions(
+    session: CustomWorldAgentSessionRecord,
+  ): CustomWorldSupportedAction[] {
+    return (
+      Object.entries(this.descriptors) as Array<
+        [
+          CustomWorldAgentActionRequest['action'],
+          EnabledDescriptor<EnabledAction> | DisabledDescriptor,
+        ]
+      >
+    ).map(([action, descriptor]) => {
+      const capability = this.resolveCapabilityState(session, action, descriptor);
+
+      return {
+        action,
+        enabled: capability.enabled,
+        reason: capability.reason ?? null,
+      } satisfies CustomWorldSupportedAction;
+    });
+  }
+
+  private resolveCapabilityState(
+    session: CustomWorldAgentSessionRecord,
+    action: CustomWorldAgentActionRequest['action'],
+    descriptor: EnabledDescriptor<EnabledAction> | DisabledDescriptor,
+  ): ActionCapabilityState {
+    if ('disabledReason' in descriptor) {
+      return {
+        enabled: false,
+        reason: descriptor.disabledReason,
+      };
+    }
+
+    if (action === 'draft_foundation') {
+      return session.progressPercent >= 100
+        ? { enabled: true }
+        : {
+            enabled: false,
+            reason: 'draft_foundation requires progressPercent >= 100',
+          };
+    }
+
+    if (
+      action === 'update_draft_card' ||
+      action === 'sync_result_profile' ||
+      action === 'generate_characters' ||
+      action === 'generate_landmarks' ||
+      action === 'generate_role_assets' ||
+      action === 'sync_role_assets' ||
+      action === 'generate_scene_assets' ||
+      action === 'sync_scene_assets'
+    ) {
+      try {
+        assertDraftRefiningActionAvailable(session, action);
+        return { enabled: true };
+      } catch (error) {
+        return {
+          enabled: false,
+          reason: error instanceof Error ? error.message : 'action unavailable',
+        };
+      }
+    }
+
+    if (action === 'expand_long_tail') {
+      try {
+        assertLongTailActionAvailable(session, action);
+        return { enabled: true };
+      } catch (error) {
+        return {
+          enabled: false,
+          reason: error instanceof Error ? error.message : 'action unavailable',
+        };
+      }
+    }
+
+    if (action === 'publish_world') {
+      try {
+        assertPublishActionAvailable(session, action);
+        return { enabled: true };
+      } catch (error) {
+        return {
+          enabled: false,
+          reason: error instanceof Error ? error.message : 'action unavailable',
+        };
+      }
+    }
+
+    if (action === 'revert_checkpoint') {
+      const restorableCheckpoint = session.checkpoints.find(
+        (entry) => Boolean(entry.snapshot),
+      );
+      if (!restorableCheckpoint) {
+        return {
+          enabled: false,
+          reason: 'revert_checkpoint requires at least one restorable checkpoint snapshot',
+        };
+      }
+
+      try {
+        assertLongTailActionAvailable(session, action);
+        return { enabled: true };
+      } catch (error) {
+        return {
+          enabled: false,
+          reason: error instanceof Error ? error.message : 'action unavailable',
+        };
+      }
+    }
+
+    return { enabled: true };
+  }
+}
diff --git a/server-node/src/services/customWorldAgentAssetBridgeService.ts b/server-node/src/services/customWorldAgentAssetBridgeService.ts
index 21de5ab5..6f1d4378 100644
--- a/server-node/src/services/customWorldAgentAssetBridgeService.ts
+++ b/server-node/src/services/customWorldAgentAssetBridgeService.ts
@@ -1,6 +1,10 @@
-import type { CustomWorldRoleAssetSummary } from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import type {
+  CustomWorldRoleAssetSummary,
+  CustomWorldSceneAssetSummary,
+} from '../../../packages/shared/src/contracts/customWorldAgent.js';
 import {
   getRoleAssetSummaryById,
+  rebuildRoleAssetCoverage,
   mergeRoleAssetIntoDraftProfile,
 } from './customWorldAgentRoleAssetStateService.js';
 
@@ -31,6 +35,17 @@ type SyncRoleAssetsPayload = {
   animationMap?: Record<string, unknown> | null;
 };
 
+type SceneKind = 'camp' | 'landmark';
+
+type SyncSceneAssetsPayload = {
+  sceneId: string;
+  sceneKind: SceneKind;
+  imageSrc: string;
+  generatedSceneAssetId: string;
+  generatedScenePrompt?: string | null;
+  generatedSceneModel?: string | null;
+};
+
 export type SyncRoleAssetsResult = {
   roleId: string;
   updatedRole: Record<string, unknown>;
@@ -38,6 +53,97 @@ export type SyncRoleAssetsResult = {
   draftProfile: Record<string, unknown>;
 };
 
+export type SceneAssetStudioContext = {
+  sceneId: string;
+  sceneKind: SceneKind;
+  sceneName: string;
+  sceneDescription: string;
+  imageSrc: string | null;
+  readyActCount: number;
+  missingActCount: number;
+};
+
+export type SyncSceneAssetsResult = {
+  sceneId: string;
+  sceneKind: SceneKind;
+  updatedScene: Record<string, unknown>;
+  updatedAssetSummaries: CustomWorldSceneAssetSummary[];
+  draftProfile: Record<string, unknown>;
+};
+
+function cloneRecord<T extends Record<string, unknown>>(value: T): T {
+  return JSON.parse(JSON.stringify(value)) as T;
+}
+
+function toSceneDescription(scene: Record<string, unknown>, sceneKind: SceneKind) {
+  if (sceneKind === 'camp') {
+    return (
+      toText(scene.description) ||
+      toText(scene.summary) ||
+      toText(scene.mood)
+    );
+  }
+
+  return (
+    toText(scene.description) ||
+    toText(scene.summary) ||
+    toText(scene.purpose) ||
+    toText(scene.mood)
+  );
+}
+
+function findSceneActsBySceneId(
+  draftProfile: Record<string, unknown>,
+  sceneId: string,
+) {
+  return toRecordArray(draftProfile.sceneChapters)
+    .filter((chapter) => toText(chapter.sceneId) === sceneId)
+    .flatMap((chapter) => toRecordArray(chapter.acts));
+}
+
+function updateSceneChapterActsForScene(params: {
+  draftProfile: Record<string, unknown>;
+  sceneId: string;
+  imageSrc: string;
+  generatedSceneAssetId: string;
+}) {
+  return toRecordArray(params.draftProfile.sceneChapters).map((chapter) => {
+    if (toText(chapter.sceneId) !== params.sceneId) {
+      return chapter;
+    }
+
+    return {
+      ...chapter,
+      acts: toRecordArray(chapter.acts).map((act) => ({
+        ...act,
+        backgroundImageSrc: params.imageSrc,
+        backgroundAssetId: params.generatedSceneAssetId,
+      })),
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function buildSceneAssetFallbackSummary(params: {
+  sceneId: string;
+  sceneKind: SceneKind;
+  updatedScene: Record<string, unknown>;
+  imageSrc: string;
+  generatedSceneAssetId: string;
+}) {
+  return {
+    sceneId: params.sceneId,
+    sceneName:
+      toText(params.updatedScene.name) ||
+      (params.sceneKind === 'camp' ? '开局营地' : '未命名场景'),
+    actId: null,
+    actTitle: params.sceneKind === 'camp' ? '营地正式背景图' : '场景正式背景图',
+    imageSrc: params.imageSrc,
+    assetId: params.generatedSceneAssetId,
+    status: 'ready',
+    nextPointCost: 0,
+  } satisfies CustomWorldSceneAssetSummary;
+}
+
 export class CustomWorldAgentAssetBridgeService {
   buildRoleAssetStudioContext(snapshot: unknown, roleId: string) {
     const profile = toRecord(snapshot);
@@ -96,4 +202,123 @@ export class CustomWorldAgentAssetBridgeService {
       draftProfile,
     };
   }
+
+  buildSceneAssetStudioContext(
+    snapshot: unknown,
+    sceneId: string,
+    sceneKind: SceneKind,
+  ): SceneAssetStudioContext {
+    const profile = toRecord(snapshot);
+    if (!profile) {
+      throw new Error('当前世界草稿为空，无法打开场景资产工坊。');
+    }
+
+    const scene =
+      sceneKind === 'camp'
+        ? toRecord(profile.camp)
+        : toRecordArray(profile.landmarks).find(
+            (item) => toText(item.id) === sceneId,
+          ) ?? null;
+    if (!scene) {
+      throw new Error('未找到目标场景，无法进入场景资产工坊。');
+    }
+
+    const sceneActs = findSceneActsBySceneId(profile, sceneId);
+    const readyActCount = sceneActs.filter((act) =>
+      Boolean(toText(act.backgroundImageSrc) || toText(act.backgroundAssetId)),
+    ).length;
+
+    return {
+      sceneId,
+      sceneKind,
+      sceneName:
+        toText(scene.name) || (sceneKind === 'camp' ? '开局营地' : '未命名场景'),
+      sceneDescription: toSceneDescription(scene, sceneKind),
+      imageSrc: toText(scene.imageSrc) || null,
+      readyActCount,
+      missingActCount: Math.max(0, sceneActs.length - readyActCount),
+    };
+  }
+
+  applySceneAssetPublishResult(
+    snapshot: unknown,
+    payload: SyncSceneAssetsPayload,
+  ): SyncSceneAssetsResult {
+    const profile = toRecord(snapshot);
+    if (!profile) {
+      throw new Error('当前世界草稿为空，无法同步场景资产。');
+    }
+
+    const nextDraftProfile = cloneRecord(profile);
+    let updatedScene: Record<string, unknown> | null = null;
+
+    if (payload.sceneKind === 'camp') {
+      const currentCamp = toRecord(nextDraftProfile.camp);
+      if (!currentCamp || toText(currentCamp.id) !== payload.sceneId) {
+        throw new Error('目标营地不存在，无法同步场景资产。');
+      }
+
+      updatedScene = {
+        ...currentCamp,
+        imageSrc: payload.imageSrc,
+        generatedSceneAssetId: payload.generatedSceneAssetId,
+        generatedScenePrompt: payload.generatedScenePrompt ?? null,
+        generatedSceneModel: payload.generatedSceneModel ?? null,
+      };
+      nextDraftProfile.camp = updatedScene;
+    } else {
+      let touched = false;
+      nextDraftProfile.landmarks = toRecordArray(nextDraftProfile.landmarks).map(
+        (item) => {
+          if (toText(item.id) !== payload.sceneId) {
+            return item;
+          }
+
+          touched = true;
+          updatedScene = {
+            ...item,
+            imageSrc: payload.imageSrc,
+            generatedSceneAssetId: payload.generatedSceneAssetId,
+            generatedScenePrompt: payload.generatedScenePrompt ?? null,
+            generatedSceneModel: payload.generatedSceneModel ?? null,
+          };
+          return updatedScene;
+        },
+      );
+
+      if (!touched || !updatedScene) {
+        throw new Error('目标地点不存在，无法同步场景资产。');
+      }
+    }
+
+    nextDraftProfile.sceneChapters = updateSceneChapterActsForScene({
+      draftProfile: nextDraftProfile,
+      sceneId: payload.sceneId,
+      imageSrc: payload.imageSrc,
+      generatedSceneAssetId: payload.generatedSceneAssetId,
+    });
+
+    const updatedAssetSummaries = rebuildRoleAssetCoverage(
+      nextDraftProfile,
+    ).sceneAssets.filter((entry) => entry.sceneId === payload.sceneId);
+
+    return {
+      sceneId: payload.sceneId,
+      sceneKind: payload.sceneKind,
+      updatedScene: updatedScene ?? {},
+      updatedAssetSummaries:
+        updatedAssetSummaries.length > 0
+          ? updatedAssetSummaries
+          : [
+              buildSceneAssetFallbackSummary({
+                sceneId: payload.sceneId,
+                sceneKind: payload.sceneKind,
+                updatedScene: updatedScene ?? {},
+                imageSrc: payload.imageSrc,
+                generatedSceneAssetId: payload.generatedSceneAssetId,
+              }),
+            ],
+      draftProfile: nextDraftProfile,
+    };
+  }
 }
diff --git a/server-node/src/services/customWorldAgentDraftCompiler.ts b/server-node/src/services/customWorldAgentDraftCompiler.ts
index 6911e061..42f2abd8 100644
--- a/server-node/src/services/customWorldAgentDraftCompiler.ts
+++ b/server-node/src/services/customWorldAgentDraftCompiler.ts
@@ -377,6 +377,9 @@ function normalizeLandmark(
     secret: secret || '玩家第一次抵达就会意识到它不只是背景',
     dangerLevel: dangerLevel || '中',
     imageSrc: toText(record.imageSrc) || null,
+    generatedSceneAssetId: toText(record.generatedSceneAssetId) || null,
+    generatedScenePrompt: toText(record.generatedScenePrompt) || null,
+    generatedSceneModel: toText(record.generatedSceneModel) || null,
     characterIds: toStringArray(record.characterIds, 8),
     threadIds: toStringArray(record.threadIds, 8),
     summary:
@@ -501,6 +504,9 @@ function normalizeCamp(value: unknown): CustomWorldFoundationDraftCamp | null {
     mood: dangerLevel || '克制、紧绷，但还能暂时收拢局势',
     dangerLevel: dangerLevel || '克制、紧绷，但还能暂时收拢局势',
     imageSrc: toText(record.imageSrc) || null,
+    generatedSceneAssetId: toText(record.generatedSceneAssetId) || null,
+    generatedScenePrompt: toText(record.generatedScenePrompt) || null,
+    generatedSceneModel: toText(record.generatedSceneModel) || null,
     summary:
       summary ||
       clampText(
@@ -1060,6 +1066,9 @@ function buildLandmarkWarnings(landmark: CustomWorldFoundationDraftLandmark) {
   if (landmark.threadIds.length === 0) {
     warnings.push('这个地点还缺少更清楚的线程挂钩。');
   }
+  if (!landmark.imageSrc || !landmark.generatedSceneAssetId) {
+    warnings.push('这个地点还没有绑定正式场景图。');
+  }
   return warnings;
 }
 
@@ -1163,8 +1172,12 @@ function buildSceneChapterWarnings(params: {
   return warnings;
 }
 
-function buildCampWarnings() {
-  return [] as string[];
+function buildCampWarnings(camp: CustomWorldFoundationDraftCamp) {
+  const warnings: string[] = [];
+  if (!camp.imageSrc || !camp.generatedSceneAssetId) {
+    warnings.push('营地还没有绑定正式场景图。');
+  }
+  return warnings;
 }
 
 function buildCharacterAssetHeadline(character: CustomWorldFoundationDraftCharacter) {
@@ -1332,12 +1345,22 @@ export class CustomWorldAgentDraftCompiler {
     });
 
     if (profile.camp) {
-      const campWarnings = buildCampWarnings();
+      const campWarnings = buildCampWarnings(profile.camp);
       pushCard({
         id: profile.camp.id,
         kind: 'camp',
         title: profile.camp.name,
-        subtitle: clampText(profile.camp.mood || '开局落脚处', 28),
+        subtitle: clampText(
+          [
+            profile.camp.mood || '开局落脚处',
+            profile.camp.imageSrc && profile.camp.generatedSceneAssetId
+              ? '背景图已就绪'
+              : '待生成背景图',
+          ]
+            .filter(Boolean)
+            .join(' / '),
+          28,
+        ),
         summary: profile.camp.summary,
         linkedIds: [
           ...profile.landmarks.slice(0, 2).map((entry) => entry.id),
@@ -1347,14 +1370,21 @@ export class CustomWorldAgentDraftCompiler {
         sections: [
           buildSection('name', '营地名称', profile.camp.name),
           buildSection('description', '当前定位', profile.camp.description),
-          buildSection(
-            'dangerLevel',
-            '危险等级',
-            profile.camp.dangerLevel || profile.camp.mood,
-          ),
-          buildSection(
-            'linkedObjects',
-            '关联对象',
+            buildSection(
+              'dangerLevel',
+              '危险等级',
+              profile.camp.dangerLevel || profile.camp.mood,
+            ),
+            buildSection(
+              'sceneAsset',
+              '场景资产',
+              profile.camp.imageSrc || profile.camp.generatedSceneAssetId
+                ? '正式场景图已就绪'
+                : '待生成正式场景图',
+            ),
+            buildSection(
+              'linkedObjects',
+              '关联对象',
             [
               resolveLandmarkNames(
                 profile.landmarks.slice(0, 2).map((entry) => entry.id),
@@ -1490,22 +1520,39 @@ export class CustomWorldAgentDraftCompiler {
 
     profile.landmarks.forEach((landmark) => {
       const warnings = buildLandmarkWarnings(landmark);
-      pushCard({
-        id: landmark.id,
-        kind: 'landmark',
-        title: landmark.name,
-        subtitle: clampText(landmark.purpose || landmark.mood, 28),
-        summary: landmark.summary,
-        linkedIds: [...landmark.characterIds, ...landmark.threadIds].slice(0, 8),
-        sections: [
-          buildSection('name', '地点名', landmark.name),
-          buildSection('purpose', '地点定位', landmark.purpose),
-          buildSection('mood', '场景情绪', landmark.mood),
-          buildSection('secret', '隐藏秘密', landmark.secret || landmark.importance),
-          buildSection('summary', '地点摘要', landmark.summary),
-          buildSection(
-            'characterIds',
-            '关联角色',
+        pushCard({
+          id: landmark.id,
+          kind: 'landmark',
+          title: landmark.name,
+          subtitle: clampText(
+            [
+              landmark.purpose || landmark.mood,
+              landmark.imageSrc && landmark.generatedSceneAssetId
+                ? '背景图已就绪'
+                : '待生成背景图',
+            ]
+              .filter(Boolean)
+              .join(' / '),
+            28,
+          ),
+          summary: landmark.summary,
+          linkedIds: [...landmark.characterIds, ...landmark.threadIds].slice(0, 8),
+          sections: [
+            buildSection('name', '地点名', landmark.name),
+            buildSection('purpose', '地点定位', landmark.purpose),
+            buildSection('mood', '场景情绪', landmark.mood),
+            buildSection('secret', '隐藏秘密', landmark.secret || landmark.importance),
+            buildSection('summary', '地点摘要', landmark.summary),
+            buildSection(
+              'sceneAsset',
+              '场景资产',
+              landmark.imageSrc || landmark.generatedSceneAssetId
+                ? '正式场景图已就绪'
+                : '待生成正式场景图',
+            ),
+            buildSection(
+              'characterIds',
+              '关联角色',
             resolveCharacterNames(landmark.characterIds),
           ),
           buildSection(
diff --git a/server-node/src/services/customWorldAgentFoundationDraftService.test.ts b/server-node/src/services/customWorldAgentFoundationDraftService.test.ts
new file mode 100644
index 00000000..45674c11
--- /dev/null
+++ b/server-node/src/services/customWorldAgentFoundationDraftService.test.ts
@@ -0,0 +1,324 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import type { UpstreamLlmClient } from './llmClient.js';
+import { CustomWorldAgentFoundationDraftService } from './customWorldAgentFoundationDraftService.js';
+import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
+
+function createFoundationDraftLlmClient(): UpstreamLlmClient {
+  let roleOutlineBatch = 0;
+  let landmarkSeedBatch = 0;
+  let landmarkNetworkBatch = 0;
+  let playableNarrativeBatch = 0;
+  let playableDossierBatch = 0;
+  let storyNarrativeBatch = 0;
+  let storyDossierBatch = 0;
+
+  return {
+    requestMessageContent: async (params) => {
+      const debugLabel = params.debugLabel ?? '';
+
+      if (debugLabel === 'agent-foundation-framework') {
+        return JSON.stringify({
+          name: '潮雾列岛',
+          subtitle: '盐火灯塔与失控航路',
+          summary: '潮雾列岛正在被假航灯和沉船商盟重新切开。',
+          tone: '冷峻、潮湿、悬疑',
+          playerGoal: '先确认谁在操盘假航灯，再决定自己站在哪一边。',
+          templateWorldType: 'WUXIA',
+          majorFactions: ['守灯会', '沉船商盟'],
+          coreConflicts: ['守灯会与沉船商盟争夺旧航路解释权'],
+          camp: {
+            name: '雾湾前哨',
+            description: '玩家在盐火灯塔下方临时收束线索的地方。',
+            dangerLevel: 'medium',
+          },
+          playableNpcs: [],
+          storyNpcs: [],
+          landmarks: [],
+        });
+      }
+
+      if (debugLabel.startsWith('agent-foundation-playable-outline-batch-')) {
+        roleOutlineBatch += 1;
+        return JSON.stringify({
+          playableNpcs: [
+            {
+              name: '返灯人',
+              title: '失职守灯人',
+              role: '玩家前线身份',
+              description: '被迫返乡的守灯人，刚站回快要熄灭的旧灯塔。',
+              visualDescription: '风衣上沾着盐霜，眼底始终没有睡意。',
+              actionDescription: '先守住灯塔，再判断该不该相信旧友。',
+              sceneVisualDescription: '每次钟声响起时，他都像被过去拽住。',
+              initialAffinity: 18,
+              relationshipHooks: ['这是玩家贴近世界的第一切口'],
+              tags: ['玩家视角', '守灯'],
+            },
+          ],
+        });
+      }
+
+      if (debugLabel.startsWith('agent-foundation-story-outline-batch-')) {
+        roleOutlineBatch += 1;
+        return JSON.stringify({
+          storyNpcs: [
+            {
+              name: '沈砺',
+              title: '旧友兼宿敌',
+              role: '沉船商盟引路人',
+              description: '他像旧友，也像最早知道假航灯秘密的人。',
+              visualDescription: '衣角总带着潮水味，像是刚从夜雾里走出来。',
+              actionDescription: '会不断试探玩家到底愿不愿意回到旧航路。',
+              sceneVisualDescription: '总在钟声停下后的空隙里现身。',
+              initialAffinity: 6,
+              relationshipHooks: ['和玩家共享一段无法翻篇的旧灯塔往事'],
+              tags: ['旧友', '宿敌'],
+            },
+            {
+              name: '岚珀',
+              title: '守灯会巡夜官',
+              role: '守灯会前台接口人',
+              description: '她负责把守灯会的怀疑与命令直接压到玩家面前。',
+              visualDescription: '披着潮湿斗篷，眼神总先看灯芯再看人。',
+              actionDescription: '要求玩家立刻证明自己还配站回灯塔。',
+              sceneVisualDescription: '总把巡夜灯举得很高，不给人躲闪空间。',
+              initialAffinity: 6,
+              relationshipHooks: ['会逼玩家更早站队'],
+              tags: ['守灯会', '巡夜'],
+            },
+          ],
+        });
+      }
+
+      if (debugLabel.startsWith('agent-foundation-landmark-seed-batch-')) {
+        landmarkSeedBatch += 1;
+        return JSON.stringify({
+          landmarks: [
+            {
+              name: '盐火灯塔',
+              description: '旧灯塔正在熄灭边缘摇晃，所有人都盯着它的火。',
+              visualDescription: '塔身被盐霜和旧火痕反复覆盖。',
+              dangerLevel: 'high',
+              sceneNpcNames: ['沈砺', '岚珀'],
+              connections: [],
+            },
+            {
+              name: '沉船码头',
+              description: '假航灯把沉船和黑市都引到了这片雾港。',
+              visualDescription: '破碎船骨和黑帆在潮雾里若隐若现。',
+              dangerLevel: 'high',
+              sceneNpcNames: ['沈砺'],
+              connections: [],
+            },
+          ],
+        });
+      }
+
+      if (debugLabel.startsWith('agent-foundation-landmark-network-batch-')) {
+        landmarkNetworkBatch += 1;
+        return JSON.stringify({
+          landmarks: [
+            {
+              name: '盐火灯塔',
+              description: '旧灯塔正在熄灭边缘摇晃，所有人都盯着它的火。',
+              visualDescription: '塔身被盐霜和旧火痕反复覆盖。',
+              dangerLevel: 'high',
+              sceneNpcNames: ['沈砺', '岚珀'],
+              connections: [
+                {
+                  targetLandmarkName: '沉船码头',
+                  relativePosition: 'forward',
+                  summary: '顺着残灯下的潮道走，就会被拖进沉船码头。',
+                },
+              ],
+            },
+            {
+              name: '沉船码头',
+              description: '假航灯把沉船和黑市都引到了这片雾港。',
+              visualDescription: '破碎船骨和黑帆在潮雾里若隐若现。',
+              dangerLevel: 'high',
+              sceneNpcNames: ['沈砺'],
+              connections: [
+                {
+                  targetLandmarkName: '盐火灯塔',
+                  relativePosition: 'back',
+                  summary: '码头所有线头最终都会重新指回灯塔。',
+                },
+              ],
+            },
+          ],
+        });
+      }
+
+      if (debugLabel.startsWith('agent-foundation-playable-narrative-batch-')) {
+        playableNarrativeBatch += 1;
+        return JSON.stringify({
+          playableNpcs: [
+            {
+              name: '返灯人',
+              title: '失职守灯人',
+              role: '玩家前线身份',
+              description: '被迫返乡的守灯人，刚站回快要熄灭的旧灯塔。',
+              visualDescription: '风衣上沾着盐霜，眼底始终没有睡意。',
+              actionDescription: '先守住灯塔，再判断该不该相信旧友。',
+              sceneVisualDescription: '每次钟声响起时，他都像被过去拽住。',
+              relationshipHooks: ['这是玩家贴近世界的第一切口'],
+              tags: ['玩家视角', '守灯'],
+            },
+          ],
+        });
+      }
+
+      if (debugLabel.startsWith('agent-foundation-playable-dossier-batch-')) {
+        playableDossierBatch += 1;
+        return JSON.stringify({
+          playableNpcs: [
+            {
+              name: '返灯人',
+              title: '失职守灯人',
+              role: '玩家前线身份',
+              description: '被迫返乡的守灯人，刚站回快要熄灭的旧灯塔。',
+              visualDescription: '风衣上沾着盐霜，眼底始终没有睡意。',
+              actionDescription: '先守住灯塔，再判断该不该相信旧友。',
+              sceneVisualDescription: '每次钟声响起时，他都像被过去拽住。',
+              relationshipHooks: ['这是玩家贴近世界的第一切口'],
+              tags: ['玩家视角', '守灯'],
+            },
+          ],
+        });
+      }
+
+      if (debugLabel.startsWith('agent-foundation-story-narrative-batch-')) {
+        storyNarrativeBatch += 1;
+        return JSON.stringify({
+          storyNpcs: [
+            {
+              name: '沈砺',
+              title: '旧友兼宿敌',
+              role: '沉船商盟引路人',
+              description: '他像旧友，也像最早知道假航灯秘密的人。',
+              visualDescription: '衣角总带着潮水味，像是刚从夜雾里走出来。',
+              actionDescription: '会不断试探玩家到底愿不愿意回到旧航路。',
+              sceneVisualDescription: '总在钟声停下后的空隙里现身。',
+              relationshipHooks: ['和玩家共享一段无法翻篇的旧灯塔往事'],
+              tags: ['旧友', '宿敌'],
+            },
+            {
+              name: '岚珀',
+              title: '守灯会巡夜官',
+              role: '守灯会前台接口人',
+              description: '她负责把守灯会的怀疑与命令直接压到玩家面前。',
+              visualDescription: '披着潮湿斗篷，眼神总先看灯芯再看人。',
+              actionDescription: '要求玩家立刻证明自己还配站回灯塔。',
+              sceneVisualDescription: '总把巡夜灯举得很高，不给人躲闪空间。',
+              relationshipHooks: ['会逼玩家更早站队'],
+              tags: ['守灯会', '巡夜'],
+            },
+          ],
+        });
+      }
+
+      if (debugLabel.startsWith('agent-foundation-story-dossier-batch-')) {
+        storyDossierBatch += 1;
+        return JSON.stringify({
+          storyNpcs: [
+            {
+              name: '沈砺',
+              title: '旧友兼宿敌',
+              role: '沉船商盟引路人',
+              description: '他像旧友，也像最早知道假航灯秘密的人。',
+              visualDescription: '衣角总带着潮水味，像是刚从夜雾里走出来。',
+              actionDescription: '会不断试探玩家到底愿不愿意回到旧航路。',
+              sceneVisualDescription: '总在钟声停下后的空隙里现身。',
+              relationshipHooks: ['和玩家共享一段无法翻篇的旧灯塔往事'],
+              tags: ['旧友', '宿敌'],
+            },
+            {
+              name: '岚珀',
+              title: '守灯会巡夜官',
+              role: '守灯会前台接口人',
+              description: '她负责把守灯会的怀疑与命令直接压到玩家面前。',
+              visualDescription: '披着潮湿斗篷，眼神总先看灯芯再看人。',
+              actionDescription: '要求玩家立刻证明自己还配站回灯塔。',
+              sceneVisualDescription: '总把巡夜灯举得很高，不给人躲闪空间。',
+              relationshipHooks: ['会逼玩家更早站队'],
+              tags: ['守灯会', '巡夜'],
+            },
+          ],
+        });
+      }
+
+      throw new Error(`未覆盖的测试 debugLabel: ${debugLabel}`);
+    },
+    streamMessageContent: async () => {
+      throw new Error('这个测试不应该走流式接口');
+    },
+  } as UpstreamLlmClient;
+}
+
+test('foundation draft service builds draft fields directly from framework instead of reusing preview compiler output', async () => {
+  const service = new CustomWorldAgentFoundationDraftService(
+    createFoundationDraftLlmClient(),
+  );
+
+  const draft = await service.generate({
+    creatorIntent: {
+      sourceMode: 'freeform',
+      rawSettingText: '被海雾反复切开的列岛世界。',
+      worldHook: '旧灯塔、假航灯与失控航路重新把列岛撕开。',
+      themeKeywords: ['海岛', '悬疑'],
+      toneDirectives: ['冷峻', '潮湿'],
+      playerPremise: '玩家是被迫返乡的失职守灯人',
+      openingSituation: '开局时正站在即将熄灭的旧灯塔上',
+      coreConflicts: ['守灯会与沉船商盟争夺旧航路解释权'],
+      keyFactions: [],
+      keyCharacters: [],
+      keyLandmarks: [],
+      iconicElements: ['潮雾钟声', '盐火灯塔'],
+      forbiddenDirectives: [],
+    },
+    anchorPack: {
+      creatorIntentSummary: '潮雾、旧灯塔、假航灯和被迫返乡的守灯人。',
+    },
+  });
+
+  const normalized = normalizeFoundationDraftProfile(draft);
+  const legacyResultProfile = (draft as Record<string, unknown>)
+    .legacyResultProfile as Record<string, unknown> | undefined;
+  const legacyStoryNpcs = Array.isArray(legacyResultProfile?.storyNpcs)
+    ? (legacyResultProfile?.storyNpcs as Array<Record<string, unknown>>)
+    : [];
+
+  assert.ok(normalized);
+  assert.equal(normalized?.name, '潮雾列岛');
+  assert.equal(
+    normalized?.summary,
+    '潮雾列岛正在被假航灯和沉船商盟重新切开。',
+  );
+  assert.equal(normalized?.playableNpcs.length, 1);
+  assert.equal(normalized?.storyNpcs.length, 2);
+  assert.equal(normalized?.storyNpcs[0]?.name, '沈砺');
+  assert.match(
+    normalized?.storyNpcs[0]?.summary ?? '',
+    /旧友|假航灯|灯塔/u,
+  );
+  assert.equal(
+    normalized?.storyNpcs[0]?.publicMask,
+    '衣角总带着潮水味，像是刚从夜雾里走出来。',
+  );
+  assert.equal(normalized?.landmarks.length, 2);
+  assert.equal(normalized?.landmarks[0]?.name, '盐火灯塔');
+  assert.equal(normalized?.sceneChapters.length, 2);
+  assert.equal(legacyResultProfile?.name, '潮雾列岛');
+  assert.equal(
+    legacyResultProfile?.scenarioPackId,
+    'scenario-pack:潮雾列岛',
+  );
+  assert.equal(
+    legacyResultProfile?.campaignPackId,
+    'campaign-pack:潮雾列岛',
+  );
+  assert.equal(legacyStoryNpcs[0]?.name, '沈砺');
+  assert.equal(legacyStoryNpcs[0]?.backstory, undefined);
+});
diff --git a/server-node/src/services/customWorldAgentFoundationDraftService.ts b/server-node/src/services/customWorldAgentFoundationDraftService.ts
index b13a1896..fe6b53b0 100644
--- a/server-node/src/services/customWorldAgentFoundationDraftService.ts
+++ b/server-node/src/services/customWorldAgentFoundationDraftService.ts
@@ -26,7 +26,6 @@ import {
   buildCustomWorldRoleOutlineBatchPrompt,
 } from '../prompts/customWorldPrompts.js';
 import {
-  buildCompiledCustomWorldProfile,
   buildCustomWorldRawProfileFromFramework,
   type CustomWorldGenerationFramework,
   type CustomWorldGenerationLandmarkOutline,
@@ -36,8 +35,7 @@ import {
   normalizeCustomWorldGenerationFramework,
   normalizeCustomWorldGenerationLandmarkOutlineBatch,
   normalizeCustomWorldGenerationRoleOutlineBatch,
-} from '../modules/custom-world/runtimeProfile.js';
-import type { CustomWorldProfile } from '../modules/custom-world/runtimeTypes.js';
+} from '../modules/custom-world/runtime-profile/index.js';
 import {
   buildDraftSummaryFromIntent,
   type CreatorCharacterSeedRecord,
@@ -961,6 +959,379 @@ function buildSceneChaptersFromDraft(params: {
   });
 }
 
+function buildDraftFactionsFromFramework(params: {
+  majorFactions: string[];
+  coreConflicts: string[];
+  fallbackSummary: string;
+}): CustomWorldFoundationDraftFaction[] {
+  const names = dedupeStrings(params.majorFactions, 4);
+  const fallbackConflict =
+    params.coreConflicts[0] || params.fallbackSummary || '局势仍在持续升温';
+
+  return names.map((name, index) => {
+    const relatedConflict =
+      params.coreConflicts[index % Math.max(1, params.coreConflicts.length)] ||
+      fallbackConflict;
+    const conflictTarget = extractConflictTarget(relatedConflict);
+
+    return {
+      id: createId('faction', name, index),
+      name,
+      title: name,
+      publicGoal: clampText(
+        conflictTarget
+          ? `拿下${conflictTarget}的主动解释权`
+          : '在失衡局势里先一步抢到主动权',
+        28,
+      ),
+      relatedConflict,
+      tension: clampText(relatedConflict, 48),
+      playerRelation: clampText(
+        index === 0
+          ? '它会先一步影响玩家的开局站位'
+          : '玩家迟早要和它发生正面碰撞',
+        32,
+      ),
+      summary: clampText(
+        `${name}围绕“${buildCompactLabel(relatedConflict, '核心冲突', 16)}”持续施压，也会直接改变玩家的开局判断。`,
+        120,
+      ),
+    } satisfies CustomWorldFoundationDraftFaction;
+  });
+}
+
+function buildDraftCharactersFromGenerationRoles(params: {
+  roles: CustomWorldGenerationRoleOutline[];
+  roleKind: 'playable' | 'story';
+  threads: CustomWorldFoundationDraftThread[];
+  maxCount: number;
+  fallbackPressure: string;
+}): CustomWorldFoundationDraftCharacter[] {
+  const threadCount = Math.max(1, params.threads.length);
+
+  return params.roles.slice(0, params.maxCount).map((role, index) => {
+    const primaryThreadId = params.threads[index % threadCount]?.id ?? '';
+    const secondaryThreadId =
+      params.threads[
+        (index + (params.roleKind === 'playable' ? 2 : 1)) % threadCount
+      ]?.id ?? '';
+    const fallbackRelation =
+      params.roleKind === 'playable'
+        ? '这是玩家当前最贴近世界的切入口'
+        : '会直接改变玩家的下一步选择';
+    const publicIdentity =
+      clampText(role.description, 36) || '站在当前局势前台的人';
+    const currentPressure =
+      clampText(
+        role.actionDescription ||
+          role.sceneVisualDescription ||
+          params.fallbackPressure,
+        48,
+      ) || '正在被当前局势不断加压';
+    const publicMask = clampText(role.visualDescription, 36) || undefined;
+    const hiddenHook =
+      clampText(role.sceneVisualDescription || role.tags[0] || '', 48) ||
+      undefined;
+    const relationToPlayer =
+      clampText(role.relationshipHooks[0] || fallbackRelation, 36) ||
+      fallbackRelation;
+
+    return {
+      id: createId(
+        'character',
+        `${params.roleKind}-${role.name || role.role || index + 1}`,
+        index,
+      ),
+      name:
+        clampText(role.name, 16) ||
+        buildCompactLabel(role.role || role.title, '关键角色', 10),
+      title: clampText(role.title || role.role, 18) || '关键角色',
+      role: clampText(role.role || role.title, 28) || '关键角色',
+      publicIdentity,
+      publicMask,
+      currentPressure,
+      hiddenHook,
+      relationToPlayer,
+      threadIds: dedupeStrings([primaryThreadId, secondaryThreadId], 3),
+      summary: clampText(
+        [
+          publicIdentity,
+          currentPressure ? `眼下压力是${currentPressure}` : '',
+          relationToPlayer ? `与玩家的关系是${relationToPlayer}` : '',
+        ]
+          .filter(Boolean)
+          .join('；'),
+        130,
+      ),
+    } satisfies CustomWorldFoundationDraftCharacter;
+  });
+}
+
+function buildDraftLandmarksFromFramework(params: {
+  landmarks: CustomWorldGenerationLandmarkOutline[];
+  threads: CustomWorldFoundationDraftThread[];
+  storyNpcs: CustomWorldFoundationDraftCharacter[];
+  maxCount: number;
+  fallbackConflict: string;
+}): CustomWorldFoundationDraftLandmark[] {
+  const threadCount = Math.max(1, params.threads.length);
+  const storyNpcIdByName = new Map(
+    params.storyNpcs.map((role) => [role.name.trim(), role.id] as const),
+  );
+
+  return params.landmarks.slice(0, params.maxCount).map((landmark, index) => {
+    const threadIds = dedupeStrings(
+      [
+        params.threads[index % threadCount]?.id ?? '',
+        params.threads[(index + 1) % threadCount]?.id ?? '',
+      ],
+      3,
+    );
+    const characterIds = dedupeStrings(
+      landmark.sceneNpcNames.map(
+        (name) => storyNpcIdByName.get(name.trim()) ?? '',
+      ),
+      4,
+    );
+
+    return {
+      id: createId('landmark', landmark.name, index),
+      name: clampText(landmark.name, 16) || `关键地点${index + 1}`,
+      description:
+        clampText(landmark.visualDescription || landmark.description, 48) ||
+        undefined,
+      purpose: clampText(landmark.description, 28) || '承接关键剧情推进',
+      mood:
+        clampText(landmark.visualDescription || landmark.dangerLevel, 24) ||
+        '带着明显风险的关键地点',
+      importance: clampText(
+        `${landmark.name}和“${buildCompactLabel(params.fallbackConflict, '主线冲突', 16)}”直接勾连，第一次抵达时就会意识到它不只是背景。`,
+        60,
+      ),
+      secret:
+        clampText(landmark.connections[0]?.summary || '', 36) || undefined,
+      dangerLevel: clampText(landmark.dangerLevel, 24) || undefined,
+      characterIds,
+      threadIds,
+      summary: clampText(
+        landmark.description ||
+          landmark.visualDescription ||
+          `${landmark.name}会把当前局势的压力直接抬到台前。`,
+        120,
+      ),
+    } satisfies CustomWorldFoundationDraftLandmark;
+  });
+}
+
+/**
+ * 工作包 G 的最小收口实现：
+ * foundation draft 主字段直接由 framework / role detail / landmark detail 组装，
+ * 不再通过 preview compiler 先转成 legacy runtime profile 再反解回 draft。
+ */
+function buildFoundationDraftProfileFromFramework(params: {
+  framework: CustomWorldGenerationFramework;
+  playableDetailed: CustomWorldGenerationRoleOutline[];
+  storyDetailed: CustomWorldGenerationRoleOutline[];
+  creatorIntent: CustomWorldCreatorIntentRecord;
+  anchorPack: unknown;
+  anchorContent?: EightAnchorContent | null;
+  settingText: string;
+}) {
+  const normalizedAnchorContent = normalizeEightAnchorContent(
+    params.anchorContent,
+  );
+  const coreConflicts =
+    dedupeStrings(params.framework.coreConflicts, 4).length > 0
+      ? dedupeStrings(params.framework.coreConflicts, 4)
+      : dedupeStrings(params.creatorIntent.coreConflicts, 4).length > 0
+        ? dedupeStrings(params.creatorIntent.coreConflicts, 4)
+        : [params.framework.summary || '旧秩序与新力量正在争夺这个世界的解释权'];
+  const iconicElements = dedupeStrings(params.creatorIntent.iconicElements, 6);
+  const playerPremise =
+    clampText(params.creatorIntent.playerPremise, 72) ||
+    '玩家是一名被卷进局势中心的行动者';
+  const openingSituation =
+    clampText(params.creatorIntent.openingSituation, 72) ||
+    '故事开局时，玩家已经站在必须立刻选边的位置上';
+  const worldHook =
+    clampText(
+      params.creatorIntent.worldHook ||
+        params.creatorIntent.rawSettingText ||
+        params.framework.summary,
+      72,
+    ) || '一个仍在失衡边缘不断扩张的世界';
+  const fallbackFactions = buildFactions({
+    intent: params.creatorIntent,
+    coreConflicts,
+    playerPremise,
+    iconicElements,
+  });
+  const factions =
+    dedupeStrings(params.framework.majorFactions, 4).length > 0
+      ? buildDraftFactionsFromFramework({
+          majorFactions: params.framework.majorFactions,
+          coreConflicts,
+          fallbackSummary: params.framework.summary,
+        })
+      : fallbackFactions;
+  const baseThreads = buildBaseThreads({
+    intent: params.creatorIntent,
+    coreConflicts,
+    playerPremise,
+    openingSituation,
+    iconicElements,
+  });
+  const playableNpcs = buildDraftCharactersFromGenerationRoles({
+    roles: params.playableDetailed,
+    roleKind: 'playable',
+    threads: baseThreads,
+    maxCount: FOUNDATION_DRAFT_PLAYABLE_COUNT,
+    fallbackPressure: coreConflicts[0] || params.framework.summary,
+  });
+  const storyNpcs = buildDraftCharactersFromGenerationRoles({
+    roles: params.storyDetailed,
+    roleKind: 'story',
+    threads: baseThreads,
+    maxCount: FOUNDATION_DRAFT_STORY_COUNT,
+    fallbackPressure: coreConflicts[0] || params.framework.summary,
+  });
+  const landmarks = buildDraftLandmarksFromFramework({
+    landmarks: params.framework.landmarks,
+    threads: baseThreads,
+    storyNpcs,
+    maxCount: FOUNDATION_DRAFT_LANDMARK_COUNT,
+    fallbackConflict: coreConflicts[0] || params.framework.summary,
+  });
+  const threads = finalizeThreads({
+    threads: baseThreads.slice(0, 4),
+    characters: [...playableNpcs, ...storyNpcs],
+    landmarks,
+  });
+  const chapter = buildChapter({
+    worldName: params.framework.name,
+    openingSituation,
+    playerGoal: params.framework.playerGoal,
+    characters: [...playableNpcs, ...storyNpcs],
+    landmarks,
+    threads,
+  });
+  const sceneChapters = buildSceneChaptersFromDraft({
+    landmarks,
+    playableNpcs,
+    storyNpcs,
+    threads,
+  });
+
+  const legacyFramework: CustomWorldGenerationFramework = {
+    ...params.framework,
+    playableNpcs: params.playableDetailed,
+    storyNpcs: params.storyDetailed,
+  };
+  const legacyResultProfile = buildCustomWorldRawProfileFromFramework(
+    legacyFramework,
+  ) as Record<string, unknown>;
+  legacyResultProfile.id =
+    legacyResultProfile.id ??
+    `agent-draft-${slugify(params.framework.name || 'world')}`;
+  legacyResultProfile.settingText = params.settingText;
+  legacyResultProfile.sceneChapterBlueprints = sceneChapters;
+  legacyResultProfile.generationMode = 'fast';
+  legacyResultProfile.generationStatus = 'key_only';
+  legacyResultProfile.scenarioPackId =
+    legacyResultProfile.scenarioPackId ??
+    `scenario-pack:${slugify(params.framework.name || 'world')}`;
+  legacyResultProfile.campaignPackId =
+    legacyResultProfile.campaignPackId ??
+    `campaign-pack:${slugify(params.framework.name || 'world')}`;
+  legacyResultProfile.creatorIntent =
+    legacyResultProfile.creatorIntent ??
+    (params.creatorIntent as unknown as Record<string, unknown>);
+  legacyResultProfile.anchorPack =
+    legacyResultProfile.anchorPack ??
+    (toRecord(params.anchorPack) ??
+      ({ value: params.anchorPack } as Record<string, unknown>));
+  if (normalizedAnchorContent) {
+    legacyResultProfile.anchorContent =
+      legacyResultProfile.anchorContent ??
+      (normalizedAnchorContent as unknown as Record<string, unknown>);
+  }
+
+  return {
+    name: clampText(params.framework.name, 40) || '未命名世界底稿',
+    subtitle:
+      clampText(params.framework.subtitle, 40) ||
+      clampText(
+        [
+          buildCompactLabel(playerPremise, '玩家视角', 12),
+          buildCompactLabel(coreConflicts[0] || '', '核心冲突', 16),
+        ]
+          .filter(Boolean)
+          .join(' · '),
+        40,
+      ) ||
+      '第一版世界底稿',
+    summary:
+      clampText(params.framework.summary, 180) ||
+      clampText(
+        `${worldHook} 玩家会以“${playerPremise}”切入这个世界，眼下最直接的冲突是“${coreConflicts[0]}”。`,
+        180,
+      ) ||
+      '第一版世界底稿已经整理完成。',
+    tone:
+      clampText(params.framework.tone, 72) ||
+      buildTone(params.creatorIntent),
+    playerGoal:
+      clampText(params.framework.playerGoal, 72) ||
+      buildPlayerGoal({
+        playerPremise,
+        openingSituation,
+        coreConflict: coreConflicts[0] || '',
+      }),
+    majorFactions:
+      dedupeStrings(params.framework.majorFactions, 6).length > 0
+        ? dedupeStrings(params.framework.majorFactions, 6)
+        : factions.map((entry) => entry.name),
+    coreConflicts,
+    playableNpcs,
+    storyNpcs,
+    landmarks,
+    camp: {
+      id: 'camp-home',
+      name: clampText(params.framework.camp.name, 16) || '开局据点',
+      description:
+        clampText(params.framework.camp.description, 72) ||
+        '玩家暂时还能整顿情报、换口气并决定下一步站位的落脚处。',
+      mood:
+        clampText(params.framework.tone, 36) || '紧绷但还可暂时收住局势',
+      dangerLevel:
+        clampText(params.framework.camp.dangerLevel, 24) || undefined,
+      summary: clampText(
+        params.framework.camp.description ||
+          `${params.framework.camp.name}仍是玩家在风暴边缘还能勉强站稳的一块地方。`,
+        88,
+      ),
+    } satisfies CustomWorldFoundationDraftCamp,
+    themePack: null,
+    storyGraph: null,
+    factions,
+    threads,
+    chapters: [chapter],
+    sceneChapters,
+    worldHook,
+    playerPremise,
+    openingSituation,
+    iconicElements,
+    sourceAnchorSummary:
+      buildDraftSummaryFromEightAnchorContent(normalizedAnchorContent) ||
+      toText(toRecord(params.anchorPack)?.creatorIntentSummary) ||
+      buildDraftSummaryFromIntent(params.creatorIntent) ||
+      params.framework.summary,
+    legacyResultProfile,
+  } satisfies CustomWorldFoundationDraftProfile & {
+    legacyResultProfile: Record<string, unknown>;
+  };
+}
+
 function getNamedRecordKey(value: unknown) {
   return toText(value).replace(/\s+/gu, '');
 }
@@ -1496,271 +1867,6 @@ async function expandFoundationRoleEntries(params: {
   return mergedEntries;
 }
 
-function buildDraftFactionsFromRuntimeProfile(profile: CustomWorldProfile) {
-  const factionNames = dedupeStrings(profile.majorFactions, 4);
-  const firstConflict = profile.coreConflicts[0] || profile.summary;
-
-  return factionNames.slice(0, 4).map((name, index) => {
-    const relatedConflict =
-      profile.coreConflicts[
-        index % Math.max(1, profile.coreConflicts.length)
-      ] || firstConflict;
-    return {
-      id: createId('faction', name, index),
-      name,
-      title: name,
-      publicGoal: clampText(
-        extractConflictTarget(relatedConflict)
-          ? `拿下${extractConflictTarget(relatedConflict)}的主导权`
-          : '在失衡局势里先抢到主动权',
-        28,
-      ),
-      relatedConflict,
-      tension: clampText(relatedConflict, 48),
-      playerRelation: clampText(
-        index === 0
-          ? '它会主动影响玩家的第一步站位'
-          : '玩家迟早要和它发生直接交集',
-        32,
-      ),
-      summary: clampText(
-        `${name}围绕“${buildCompactLabel(relatedConflict, '核心冲突', 16)}”持续施压，也会直接影响玩家的开局判断。`,
-        120,
-      ),
-    } satisfies CustomWorldFoundationDraftFaction;
-  });
-}
-
-function buildDraftThreadsFromRuntimeProfile(
-  profile: CustomWorldProfile,
-): CustomWorldFoundationDraftThread[] {
-  const graphThreads = [
-    ...(profile.storyGraph?.visibleThreads ?? []).slice(0, 2),
-    ...(profile.storyGraph?.hiddenThreads ?? []).slice(0, 2),
-  ];
-
-  if (graphThreads.length > 0) {
-    return graphThreads.map(
-      (thread, index) =>
-        ({
-          id: thread.id || createId('thread', thread.title, index),
-          title: clampText(thread.title, 18),
-          type: thread.visibility === 'hidden' ? 'hidden' : 'main',
-          conflictType: clampText(thread.conflictType, 18),
-          conflict: clampText(thread.summary || thread.stakes, 72),
-          stakes: clampText(thread.stakes, 48),
-          characterIds: thread.involvedActorIds.slice(0, 4),
-          landmarkIds: thread.relatedLocationIds.slice(0, 4),
-          summary: clampText(thread.summary, 120),
-        }) satisfies CustomWorldFoundationDraftThread,
-    );
-  }
-
-  return profile.coreConflicts.slice(0, 3).map((conflict, index) => ({
-    id: createId('thread', conflict, index),
-    title: buildCompactLabel(conflict, `主线${index + 1}`, 16),
-    type: index === 1 ? 'hidden' : 'main',
-    conflict,
-    characterIds: [],
-    landmarkIds: [],
-    summary: clampText(`这条线围绕“${conflict}”持续推进。`, 80),
-  }));
-}
-
-function buildDraftCharactersFromRuntimeProfile(
-  roles: CustomWorldProfile['playableNpcs'] | CustomWorldProfile['storyNpcs'],
-  fallbackThreadIds: string[],
-) {
-  return roles.map((role) => ({
-    id: role.id,
-    name: role.name,
-    title: clampText(role.title || role.role, 18) || '关键角色',
-    role: clampText(role.role || role.title, 28) || '关键角色',
-    publicIdentity:
-      clampText(
-        role.narrativeProfile?.publicMask ||
-          role.backstoryReveal.publicSummary ||
-          role.description,
-        36,
-      ) || '站在局势前台的人',
-    publicMask:
-      clampText(
-        role.narrativeProfile?.firstContactMask || role.personality,
-        36,
-      ) || undefined,
-    currentPressure:
-      clampText(
-        role.narrativeProfile?.immediatePressure ||
-          role.motivation ||
-          role.backstory,
-        48,
-      ) || '正在被当前局势不断加压',
-    hiddenHook:
-      clampText(
-        role.narrativeProfile?.hiddenLine ||
-          role.backstoryReveal.chapters[2]?.content ||
-          role.backstory,
-        48,
-      ) || undefined,
-    relationToPlayer:
-      clampText(
-        role.relationshipHooks[0] ||
-          role.narrativeProfile?.visibleLine ||
-          role.motivation,
-        36,
-      ) || '会直接改变玩家的下一步选择',
-    threadIds:
-      role.narrativeProfile?.relatedThreadIds?.slice(0, 3) ??
-      fallbackThreadIds.slice(0, 3),
-    summary:
-      clampText(role.description || role.backstoryReveal.publicSummary, 120) ||
-      '这个角色会持续推动当前世界底稿继续展开。',
-  })) satisfies CustomWorldFoundationDraftCharacter[];
-}
-
-function buildDraftLandmarksFromRuntimeProfile(
-  profile: CustomWorldProfile,
-  threads: CustomWorldFoundationDraftThread[],
-) {
-  return profile.landmarks
-    .slice(0, FOUNDATION_DRAFT_LANDMARK_COUNT)
-    .map((landmark) => {
-      const relatedThreadIds = threads
-        .filter((thread) => thread.landmarkIds.includes(landmark.id))
-        .map((thread) => thread.id)
-        .slice(0, 3);
-
-      return {
-        id: landmark.id,
-        name: landmark.name,
-        description: clampText(landmark.description, 48) || undefined,
-        purpose: clampText(landmark.description, 28) || '承接关键剧情推进',
-        mood:
-          clampText(
-            landmark.narrativeResidues?.[0]?.summary ||
-              landmark.dangerLevel ||
-              '带着明显风险的关键地点',
-            24,
-          ) || '带着明显风险的关键地点',
-        importance: clampText(
-          landmark.narrativeResidues?.[0]?.changeHint ||
-            landmark.description ||
-            '和当前主线冲突直接勾连的关键地点',
-          60,
-        ),
-        secret:
-          clampText(
-            landmark.narrativeResidues?.[0]?.hiddenTruth ||
-              landmark.connections[0]?.summary ||
-              '',
-            36,
-          ) || undefined,
-        dangerLevel: landmark.dangerLevel,
-        characterIds: landmark.sceneNpcIds.slice(0, 4),
-        threadIds: relatedThreadIds,
-        summary: clampText(
-          landmark.description ||
-            landmark.narrativeResidues?.[0]?.summary ||
-            '',
-          120,
-        ),
-      } satisfies CustomWorldFoundationDraftLandmark;
-    });
-}
-
-function convertRuntimeProfileToFoundationDraft(params: {
-  profile: CustomWorldProfile;
-  intent: CustomWorldCreatorIntentRecord;
-  anchorPack: unknown;
-}) {
-  const factions = buildDraftFactionsFromRuntimeProfile(params.profile);
-  const threads = buildDraftThreadsFromRuntimeProfile(params.profile);
-  const playableNpcs = buildDraftCharactersFromRuntimeProfile(
-    params.profile.playableNpcs.slice(0, FOUNDATION_DRAFT_PLAYABLE_COUNT),
-    threads.slice(0, 2).map((entry) => entry.id),
-  );
-  const storyNpcs = buildDraftCharactersFromRuntimeProfile(
-    params.profile.storyNpcs.slice(0, FOUNDATION_DRAFT_STORY_COUNT),
-    threads.slice(1, 3).map((entry) => entry.id),
-  );
-  const landmarks = buildDraftLandmarksFromRuntimeProfile(
-    params.profile,
-    threads,
-  );
-  const chapter = buildChapter({
-    worldName: params.profile.name,
-    openingSituation:
-      clampText(params.intent.openingSituation, 60) || params.profile.summary,
-    playerGoal: params.profile.playerGoal,
-    characters: [...playableNpcs, ...storyNpcs],
-    landmarks,
-    threads,
-  });
-  const sceneChapters = buildSceneChaptersFromDraft({
-    landmarks,
-    playableNpcs,
-    storyNpcs,
-    threads,
-  });
-  const anchorRecord = toRecord(params.anchorPack);
-
-  return {
-    name: params.profile.name,
-    subtitle: params.profile.subtitle,
-    summary: params.profile.summary,
-    tone: params.profile.tone,
-    playerGoal: params.profile.playerGoal,
-    majorFactions:
-      params.profile.majorFactions.length > 0
-        ? params.profile.majorFactions
-        : factions.map((entry) => entry.name),
-    coreConflicts:
-      params.profile.coreConflicts.length > 0
-        ? params.profile.coreConflicts
-        : [params.profile.summary],
-    playableNpcs,
-    storyNpcs,
-    landmarks,
-    camp: params.profile.camp
-      ? ({
-          id: 'camp-home',
-          name: params.profile.camp.name,
-          description: params.profile.camp.description,
-          mood: clampText(params.profile.tone, 36) || '紧绷但还可暂时收住局势',
-          dangerLevel: params.profile.camp.dangerLevel,
-          summary: clampText(params.profile.camp.description, 88),
-        } satisfies CustomWorldFoundationDraftCamp)
-      : null,
-    themePack:
-      (params.profile.themePack as unknown as Record<string, unknown> | null) ??
-      null,
-    storyGraph:
-      (params.profile.storyGraph as unknown as Record<string, unknown> | null) ??
-      null,
-    factions,
-    threads,
-    chapters: [chapter],
-    sceneChapters,
-    worldHook:
-      clampText(params.intent.worldHook || params.profile.summary, 72) ||
-      params.profile.summary,
-    playerPremise:
-      clampText(params.intent.playerPremise, 72) ||
-      '玩家是一名被卷进局势中心的行动者',
-    openingSituation:
-      clampText(params.intent.openingSituation, 72) ||
-      '故事开局时，玩家已经站在必须立刻选边的位置上',
-    iconicElements: dedupeStrings(params.intent.iconicElements, 6),
-    sourceAnchorSummary:
-      toText(anchorRecord?.creatorIntentSummary) ||
-      buildDraftSummaryFromIntent(params.intent) ||
-      params.profile.summary,
-    legacyResultProfile: params.profile as unknown as Record<string, unknown>,
-  } satisfies CustomWorldFoundationDraftProfile & {
-    legacyResultProfile: Record<string, unknown>;
-  };
-}
-
 async function buildFoundationDraftProfileWithLlm(params: {
   llmClient: UpstreamLlmClient;
   creatorIntent: CustomWorldCreatorIntentRecord;
@@ -1885,25 +1991,19 @@ async function buildFoundationDraftProfileWithLlm(params: {
 
   await emitDraftProgress(params.onProgress, {
     phaseLabel: '编译世界底稿',
-    phaseDetail: '正在把分批生成结果整理成旧版世界结果结构，再编成草稿卡底稿。',
+    phaseDetail:
+      '正在把分批生成结果直接整理成第一版 foundation draft，并同步兼容结果快照。',
     progress: 97,
   });
 
-  const rawProfile = buildCustomWorldRawProfileFromFramework(
+  return buildFoundationDraftProfileFromFramework({
     framework,
-  ) as Record<string, unknown>;
-  rawProfile.playableNpcs = playableDetailed;
-  rawProfile.storyNpcs = storyDetailed;
-  rawProfile.landmarks = framework.landmarks;
-
-  const runtimeProfile = buildCompiledCustomWorldProfile(
-    rawProfile,
-    settingText,
-  );
-  return convertRuntimeProfileToFoundationDraft({
-    profile: runtimeProfile,
-    intent: params.creatorIntent,
+    playableDetailed,
+    storyDetailed,
+    creatorIntent: params.creatorIntent,
     anchorPack: params.anchorPack,
+    anchorContent: params.anchorContent,
+    settingText,
   });
 }
 
diff --git a/server-node/src/services/customWorldAgentMessageTurnService.ts b/server-node/src/services/customWorldAgentMessageTurnService.ts
new file mode 100644
index 00000000..bf2843e4
--- /dev/null
+++ b/server-node/src/services/customWorldAgentMessageTurnService.ts
@@ -0,0 +1,196 @@
+import crypto from 'node:crypto';
+
+import type {
+  CreatorIntentReadiness,
+  CustomWorldAgentMessage,
+  CustomWorldAgentSessionSnapshot,
+} from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import {
+  buildPendingClarifications,
+  evaluateCreatorIntentReadiness,
+  resolveCreatorIntentStage,
+} from './customWorldAgentClarificationService.js';
+import {
+  buildAnchorPackFromIntent,
+  buildDraftSummaryFromIntent,
+  buildDraftTitleFromIntent,
+  type CustomWorldCreatorIntentRecord,
+} from './customWorldAgentIntentExtractionService.js';
+import type {
+  CustomWorldAgentSessionRecord,
+  CustomWorldAgentSessionStore,
+} from './customWorldAgentSessionStore.js';
+import type { CustomWorldAgentSuggestedActionService } from './customWorldAgentSuggestedActionService.js';
+import { CustomWorldAgentSnapshotBuilder } from './customWorldAgentSnapshotBuilder.js';
+import {
+  buildCreatorIntentFromEightAnchorContent,
+  buildEightAnchorContentFromCreatorIntent,
+} from './eightAnchorCompatibilityService.js';
+import { EightAnchorSingleTurnService } from './eightAnchorSingleTurnService.js';
+
+function buildDerivedState(
+  intent: CustomWorldCreatorIntentRecord,
+  hasUserInput: boolean,
+  suggestedActionService: CustomWorldAgentSuggestedActionService,
+) {
+  const readiness = evaluateCreatorIntentReadiness(intent);
+  const pendingClarifications = buildPendingClarifications(intent, readiness);
+  const stage = resolveCreatorIntentStage({
+    hasUserInput,
+    readiness,
+  });
+
+  return {
+    readiness,
+    pendingClarifications,
+    stage,
+    anchorPack: buildAnchorPackFromIntent(intent, {
+      completedKeys: readiness.completedKeys,
+      missingKeys: readiness.missingKeys,
+    }),
+    draftProfile: {
+      title: buildDraftTitleFromIntent(intent),
+      summary: buildDraftSummaryFromIntent(intent),
+    },
+    suggestedActions: suggestedActionService.buildSuggestedActions({
+      stage,
+      isReady: readiness.isReady,
+    }),
+  };
+}
+
+export class CustomWorldAgentMessageTurnService {
+  constructor(
+    private readonly sessionStore: CustomWorldAgentSessionStore,
+    private readonly eightAnchorSingleTurnService: EightAnchorSingleTurnService,
+    private readonly suggestedActionService: CustomWorldAgentSuggestedActionService,
+    private readonly snapshotBuilder: CustomWorldAgentSnapshotBuilder,
+  ) {}
+
+  async applyMessageTurn(params: {
+    userId: string;
+    sessionId: string;
+    latestUserText: string;
+    quickFillRequested: boolean;
+    relatedOperationId?: string | null;
+    onReplyUpdate?: (text: string) => void;
+  }) {
+    const latestSession = (await this.sessionStore.get(
+      params.userId,
+      params.sessionId,
+    )) as CustomWorldAgentSessionRecord | null;
+    if (!latestSession) {
+      throw new Error('custom world agent session not found');
+    }
+
+    const shouldPreserveDraftStage =
+      (latestSession.stage === 'object_refining' ||
+        latestSession.stage === 'visual_refining') &&
+      latestSession.draftCards.length > 0;
+
+    const assistantTurn = await this.eightAnchorSingleTurnService.streamTurn(
+      {
+        currentTurn: latestSession.currentTurn + 1,
+        progressPercent: latestSession.progressPercent,
+        quickFillRequested: params.quickFillRequested,
+        currentAnchorContent: latestSession.anchorContent,
+        chatHistory: latestSession.messages
+          .filter(
+            (message): message is CustomWorldAgentMessage =>
+              (message.role === 'user' || message.role === 'assistant') &&
+              Boolean(message.text.trim()),
+          )
+          .map((message) => ({
+            role: message.role,
+            content: message.text,
+          })),
+      },
+      {
+        onReplyUpdate: params.onReplyUpdate,
+      },
+    );
+    const nextCreatorIntent = buildCreatorIntentFromEightAnchorContent(
+      assistantTurn.nextAnchorContent,
+    );
+    const progressPercent = Math.max(
+      0,
+      Math.min(100, Math.round(assistantTurn.progressPercent)),
+    );
+    const creatorIntentReadiness: CreatorIntentReadiness =
+      progressPercent >= 100
+        ? {
+            isReady: true,
+            completedKeys: [
+              'world_hook',
+              'player_premise',
+              'theme_and_tone',
+              'core_conflict',
+              'relationship_seed',
+              'iconic_element',
+            ],
+            missingKeys: [],
+          }
+        : evaluateCreatorIntentReadiness(nextCreatorIntent);
+    const derivedState = buildDerivedState(
+      nextCreatorIntent,
+      true,
+      this.suggestedActionService,
+    );
+    const shouldStayInDraftStage =
+      shouldPreserveDraftStage && progressPercent >= 100;
+    const assistantMessage = {
+      id: `message-${crypto.randomBytes(8).toString('hex')}`,
+      role: 'assistant',
+      kind: 'chat',
+      text: assistantTurn.replyText,
+      createdAt: new Date().toISOString(),
+      relatedOperationId: params.relatedOperationId ?? null,
+    } satisfies CustomWorldAgentMessage;
+
+    await this.sessionStore.replaceDerivedState(
+      params.userId,
+      params.sessionId,
+      this.snapshotBuilder.buildMessageTurnState({
+        latestSession,
+        nextAnchorContent: assistantTurn.nextAnchorContent,
+        progressPercent,
+        replyText: assistantTurn.replyText,
+        nextCreatorIntent,
+        creatorIntentReadiness,
+        derivedDraftProfile: derivedState.draftProfile,
+        derivedPendingClarifications: derivedState.pendingClarifications,
+        derivedStage: derivedState.stage,
+        shouldStayInDraftStage,
+      }),
+    );
+    await this.sessionStore.appendMessage(
+      params.userId,
+      params.sessionId,
+      assistantMessage,
+    );
+
+    return (await this.sessionStore.getSnapshot(
+      params.userId,
+      params.sessionId,
+    )) as CustomWorldAgentSessionSnapshot;
+  }
+
+  deriveInitialSessionState(params: {
+    seedText: string;
+    creatorIntent: CustomWorldCreatorIntentRecord;
+  }) {
+    const anchorContent = buildEightAnchorContentFromCreatorIntent(
+      params.creatorIntent,
+    );
+    const derivedState = buildDerivedState(
+      params.creatorIntent,
+      Boolean(params.seedText),
+      this.suggestedActionService,
+    );
+
+    return {
+      anchorContent,
+      ...derivedState,
+    };
+  }
+}
diff --git a/server-node/src/services/customWorldAgentOrchestrator.ts b/server-node/src/services/customWorldAgentOrchestrator.ts
index 484e2320..6910d45b 100644
--- a/server-node/src/services/customWorldAgentOrchestrator.ts
+++ b/server-node/src/services/customWorldAgentOrchestrator.ts
@@ -8,59 +8,50 @@ import type {
   CustomWorldAgentMessage,
   CustomWorldAgentOperationRecord,
   CustomWorldAgentSessionSnapshot,
-  CustomWorldDraftCardSummary,
   CustomWorldPendingClarification,
-  CustomWorldSuggestedAction,
   SendCustomWorldAgentMessageRequest,
   SendCustomWorldAgentMessageResponse,
 } from '../../../packages/shared/src/contracts/customWorldAgent.js';
-import { badRequest, notFound } from '../errors.js';
+import { notFound } from '../errors.js';
 import { prepareEventStreamResponse } from '../http.js';
-import { normalizeCustomWorldProfile } from '../modules/custom-world/runtimeProfile.js';
-import type { CustomWorldProfile } from '../modules/custom-world/runtimeTypes.js';
+import { CustomWorldAgentActionRegistry } from './customWorldAgentActionRegistry.js';
+import { createCustomWorldAgentActionExecutorMap } from './customWorldAgentActionExecutors/index.js';
 import { CustomWorldAgentAssetBridgeService } from './customWorldAgentAssetBridgeService.js';
 import { CustomWorldAgentAutoAssetService } from './customWorldAgentAutoAssetService.js';
 import { CustomWorldAgentChangeSummaryService } from './customWorldAgentChangeSummaryService.js';
-import {
-  buildPendingClarifications,
-  evaluateCreatorIntentReadiness,
-  resolveCreatorIntentStage,
-} from './customWorldAgentClarificationService.js';
+import { CustomWorldAgentMessageTurnService } from './customWorldAgentMessageTurnService.js';
 import {
   CustomWorldAgentDraftCompiler,
-  getWorldFoundationCardId,
   normalizeFoundationDraftProfile,
 } from './customWorldAgentDraftCompiler.js';
-import { updateDraftCardSections } from './customWorldAgentDraftEditService.js';
 import { CustomWorldAgentEntityGenerationService } from './customWorldAgentEntityGenerationService.js';
 import { CustomWorldAgentFoundationDraftService } from './customWorldAgentFoundationDraftService.js';
 import {
-  buildAnchorPackFromIntent,
-  buildDraftSummaryFromIntent,
-  buildDraftTitleFromIntent,
   createEmptyCreatorIntentRecord,
   type CustomWorldCreatorIntentRecord,
   extractCreatorIntentPatch,
   hasMeaningfulCreatorIntentRecord,
   mergeCreatorIntentRecord,
-  normalizeCreatorIntentRecord,
 } from './customWorldAgentIntentExtractionService.js';
-import {
-  rebuildRoleAssetCoverage,
-  resolveRoleAssetStatusLabel,
-} from './customWorldAgentRoleAssetStateService.js';
+import { CustomWorldAgentPublishingService } from './customWorldAgentPublishingService.js';
+import { CustomWorldAgentQualityGateService } from './customWorldAgentQualityGateService.js';
+import { CustomWorldAgentResultSyncService } from './customWorldAgentResultSyncService.js';
+import { CustomWorldAgentSnapshotBuilder } from './customWorldAgentSnapshotBuilder.js';
 import {
   type CustomWorldAgentSessionRecord,
   CustomWorldAgentSessionStore,
 } from './customWorldAgentSessionStore.js';
+import { CustomWorldAgentSuggestedActionService } from './customWorldAgentSuggestedActionService.js';
 import {
-  buildAnchorPackFromEightAnchorContent,
-  buildCreatorIntentFromEightAnchorContent,
   buildEightAnchorContentFromCreatorIntent,
   estimateProgressPercentFromAnchorContent,
 } from './eightAnchorCompatibilityService.js';
 import { EightAnchorSingleTurnService } from './eightAnchorSingleTurnService.js';
+import { buildRpgWorldPreviewEnvelope } from './RpgWorldPreviewCompiler.js';
+import { buildRpgCreationPreviewProfileFromDraftProfile } from './rpgCreationPreviewProfileBuilder.js';
 import type { UpstreamLlmClient } from './llmClient.js';
+import type { RpgWorldProfileRepositoryPort } from '../repositories/RpgWorldProfileRepository.js';
+import type { UserRepositoryPort } from '../repositories/userRepository.js';
 
 const PHASE2_FORCE_FAIL_TOKEN = '__phase1_force_fail__';
 function truncateText(value: string, maxLength: number) {
@@ -77,75 +68,6 @@ function sleep(ms: number) {
   });
 }
 
-function buildSuggestedActions(
-  params: {
-    stage?: CustomWorldAgentSessionRecord['stage'];
-    isReady?: boolean;
-    draftProfile?: unknown;
-    draftCards?: CustomWorldDraftCardSummary[];
-  } = {},
-): CustomWorldSuggestedAction[] {
-  const profile = normalizeFoundationDraftProfile(params.draftProfile);
-  const actions: CustomWorldSuggestedAction[] = [
-    {
-      id: 'request_summary',
-      type: 'request_summary',
-      label:
-        params.stage === 'object_refining' || params.stage === 'visual_refining'
-          ? '总结当前世界底稿'
-          : '总结当前设定',
-    },
-  ];
-
-  if (params.stage === 'foundation_review' && params.isReady) {
-    actions.push({
-      id: 'draft_foundation',
-      type: 'draft_foundation',
-      label: '整理一版世界底稿',
-    });
-    return actions;
-  }
-
-  if (
-    (params.stage === 'object_refining' ||
-      params.stage === 'visual_refining') &&
-    profile
-  ) {
-    const worldCardId =
-      params.draftCards?.find((entry) => entry.kind === 'world')?.id ??
-      getWorldFoundationCardId();
-    const firstCharacter = [...profile.playableNpcs, ...profile.storyNpcs][0];
-    const firstLandmark = profile.landmarks[0];
-
-    actions.push({
-      id: 'refine_world',
-      type: 'refine_focus_target',
-      label: '先看世界总卡',
-      targetId: worldCardId,
-    });
-
-    if (firstCharacter) {
-      actions.push({
-        id: `refine-character-${firstCharacter.id}`,
-        type: 'refine_focus_target',
-        label: `精修角色：${firstCharacter.name}`,
-        targetId: firstCharacter.id,
-      });
-    }
-
-    if (firstLandmark) {
-      actions.push({
-        id: `refine-landmark-${firstLandmark.id}`,
-        type: 'refine_focus_target',
-        label: `继续补地点：${firstLandmark.name}`,
-        targetId: firstLandmark.id,
-      });
-    }
-  }
-
-  return actions;
-}
-
 function buildOperation(type: CustomWorldAgentOperationRecord['type']) {
   const phaseDetail =
     type === 'draft_foundation'
@@ -198,153 +120,6 @@ function buildRoleAssetSyncResultText(params: {
   return `已把「${params.roleName}」的角色资产写回草稿，当前状态：${params.assetStatusLabel}。`;
 }
 
-function toText(value: unknown) {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-function toRecordArray(value: unknown) {
-  return Array.isArray(value)
-    ? value.filter((item): item is Record<string, unknown> => isRecord(item))
-    : [];
-}
-
-function cloneJsonRecord<T>(value: T): T {
-  return JSON.parse(JSON.stringify(value)) as T;
-}
-
-function syncRoleAssetsFromResultProfile(params: {
-  currentRoles: unknown;
-  resultRoles: unknown;
-}) {
-  const resultRoleById = new Map(
-    toRecordArray(params.resultRoles).map((role) => [toText(role.id), role]),
-  );
-
-  return toRecordArray(params.currentRoles).map((currentRole) => {
-    const resultRole = resultRoleById.get(toText(currentRole.id));
-    if (!resultRole) {
-      return currentRole;
-    }
-
-    return {
-      ...currentRole,
-      imageSrc: toText(resultRole.imageSrc) || null,
-      generatedVisualAssetId: toText(resultRole.generatedVisualAssetId) || null,
-      generatedAnimationSetId:
-        toText(resultRole.generatedAnimationSetId) || null,
-      animationMap: isRecord(resultRole.animationMap)
-        ? cloneJsonRecord(resultRole.animationMap)
-        : null,
-    } satisfies Record<string, unknown>;
-  });
-}
-
-function syncLandmarkAssetsFromResultProfile(params: {
-  currentLandmarks: unknown;
-  resultLandmarks: unknown;
-}) {
-  const resultLandmarkById = new Map(
-    toRecordArray(params.resultLandmarks).map((landmark) => [
-      toText(landmark.id),
-      landmark,
-    ]),
-  );
-
-  return toRecordArray(params.currentLandmarks).map((currentLandmark) => {
-    const resultLandmark = resultLandmarkById.get(toText(currentLandmark.id));
-    if (!resultLandmark) {
-      return currentLandmark;
-    }
-
-    return {
-      ...currentLandmark,
-      imageSrc: toText(resultLandmark.imageSrc) || null,
-    } satisfies Record<string, unknown>;
-  });
-}
-
-function syncSceneChapterAssetsFromResultProfile(params: {
-  currentSceneChapters: unknown;
-  resultSceneChapters: unknown;
-}) {
-  const resultSceneChapterBySceneId = new Map(
-    toRecordArray(params.resultSceneChapters).map((chapter) => [
-      toText(chapter.sceneId),
-      chapter,
-    ]),
-  );
-
-  return toRecordArray(params.currentSceneChapters).map((currentChapter) => {
-    const resultChapter = resultSceneChapterBySceneId.get(
-      toText(currentChapter.sceneId),
-    );
-    if (!resultChapter) {
-      return currentChapter;
-    }
-
-    const resultActById = new Map(
-      toRecordArray(resultChapter.acts).map((act) => [toText(act.id), act]),
-    );
-
-    return {
-      ...currentChapter,
-      acts: toRecordArray(currentChapter.acts).map((currentAct) => {
-        const resultAct = resultActById.get(toText(currentAct.id));
-        if (!resultAct) {
-          return currentAct;
-        }
-
-        return {
-          ...currentAct,
-          backgroundImageSrc: toText(resultAct.backgroundImageSrc) || null,
-          backgroundAssetId: toText(resultAct.backgroundAssetId) || null,
-        } satisfies Record<string, unknown>;
-      }),
-    } satisfies Record<string, unknown>;
-  });
-}
-
-function syncResultProfileIntoDraftProfile(params: {
-  currentDraftProfile: Record<string, unknown> | null | undefined;
-  resultProfile: CustomWorldProfile;
-}) {
-  const currentDraftProfile = params.currentDraftProfile ?? {};
-  const resultProfile = params.resultProfile;
-
-  return {
-    // 阶段一只回写基础摘要和完整 legacy 快照，避免把结果页的运行时结构反向拆回 foundation draft。
-    ...currentDraftProfile,
-    name: resultProfile.name,
-    subtitle: resultProfile.subtitle,
-    summary: resultProfile.summary,
-    tone: resultProfile.tone,
-    playerGoal: resultProfile.playerGoal,
-    majorFactions: resultProfile.majorFactions,
-    coreConflicts: resultProfile.coreConflicts,
-    playableNpcs: syncRoleAssetsFromResultProfile({
-      currentRoles: currentDraftProfile.playableNpcs,
-      resultRoles: resultProfile.playableNpcs,
-    }),
-    storyNpcs: syncRoleAssetsFromResultProfile({
-      currentRoles: currentDraftProfile.storyNpcs,
-      resultRoles: resultProfile.storyNpcs,
-    }),
-    landmarks: syncLandmarkAssetsFromResultProfile({
-      currentLandmarks: currentDraftProfile.landmarks,
-      resultLandmarks: resultProfile.landmarks,
-    }),
-    sceneChapters: syncSceneChapterAssetsFromResultProfile({
-      currentSceneChapters: currentDraftProfile.sceneChapters,
-      resultSceneChapters: resultProfile.sceneChapterBlueprints,
-    }),
-    legacyResultProfile: resultProfile as unknown as Record<string, unknown>,
-  } satisfies Record<string, unknown>;
-}
-
 function buildQuestionLines(
   pendingClarifications: CustomWorldPendingClarification[],
 ) {
@@ -367,36 +142,6 @@ function composeAssistantReply(params: {
   ].join('\n');
 }
 
-function buildDerivedState(
-  intent: CustomWorldCreatorIntentRecord,
-  hasUserInput: boolean,
-) {
-  const readiness = evaluateCreatorIntentReadiness(intent);
-  const pendingClarifications = buildPendingClarifications(intent, readiness);
-  const stage = resolveCreatorIntentStage({
-    hasUserInput,
-    readiness,
-  });
-
-  return {
-    readiness,
-    pendingClarifications,
-    stage,
-    anchorPack: buildAnchorPackFromIntent(intent, {
-      completedKeys: readiness.completedKeys,
-      missingKeys: readiness.missingKeys,
-    }),
-    draftProfile: {
-      title: buildDraftTitleFromIntent(intent),
-      summary: buildDraftSummaryFromIntent(intent),
-    },
-    suggestedActions: buildSuggestedActions({
-      stage,
-      isReady: readiness.isReady,
-    }),
-  };
-}
-
 function buildWelcomeMessage(params: {
   seedText: string;
   intent: CustomWorldCreatorIntentRecord;
@@ -423,51 +168,6 @@ function buildWelcomeMessage(params: {
   });
 }
 
-function buildFoundationDraftAssistantMessage(params: {
-  relatedOperationId: string;
-  draftProfile: unknown;
-  warnings?: string[];
-}) {
-  const profile = normalizeFoundationDraftProfile(params.draftProfile);
-  const leadCharacter = profile?.playableNpcs[0];
-  const leadLandmark = profile?.landmarks[0];
-  const warnings = (params.warnings ?? []).filter(Boolean);
-
-  return {
-    id: `message-${crypto.randomBytes(8).toString('hex')}`,
-    role: 'assistant',
-    kind: 'summary',
-    text: [
-      `我先把第一版世界底稿整理出来了：${profile?.summary || '底稿已经生成完成。'}`,
-      '',
-      `当前已经落下来的第一批对象数量是：关键角色 ${profile?.playableNpcs.length ?? 0} 个，关键地点 ${profile?.landmarks.length ?? 0} 个，势力 ${profile?.factions.length ?? 0} 个。`,
-      `建议你先从“${profile?.name || '世界总卡'}”这张世界总卡看起${leadCharacter ? `，再顺着角色「${leadCharacter.name}」往下细修` : ''}${leadLandmark ? `，地点可以先看「${leadLandmark.name}」` : ''}。`,
-      ...(warnings.length > 0
-        ? [
-            '',
-            `这一轮有 ${warnings.length} 项资产补齐未完成，但不影响世界底稿继续精修。`,
-          ]
-        : []),
-    ].join('\n'),
-    createdAt: new Date().toISOString(),
-    relatedOperationId: params.relatedOperationId,
-  } satisfies CustomWorldAgentMessage;
-}
-
-function buildActionResultMessage(params: {
-  relatedOperationId: string;
-  text: string;
-}) {
-  return {
-    id: `message-${crypto.randomBytes(8).toString('hex')}`,
-    role: 'assistant',
-    kind: 'action_result',
-    text: params.text,
-    createdAt: new Date().toISOString(),
-    relatedOperationId: params.relatedOperationId,
-  } satisfies CustomWorldAgentMessage;
-}
-
 function writeSseEvent(
   response: Response,
   event: string,
@@ -481,6 +181,27 @@ function writeSseEvent(
   response.write(`data: ${JSON.stringify(data)}\n\n`);
 }
 
+/**
+ * 发布 readiness 校验和正式写库复用同一个服务。
+ * 当运行环境还没接入真实作品仓储时，真正执行发布动作会在这里统一抛出明确错误。
+ */
+function createUnavailablePublishingRepository(): RpgWorldProfileRepositoryPort {
+  const throwUnavailable = async () => {
+    throw new Error('当前环境还没有注入发布仓储，暂时无法执行世界发布。');
+  };
+
+  return {
+    listOwnProfiles: throwUnavailable,
+    upsertOwnProfile: throwUnavailable,
+    syncProfileFromSnapshot: throwUnavailable,
+    softDeleteOwnProfile: throwUnavailable,
+    publishOwnProfile: throwUnavailable,
+    unpublishOwnProfile: throwUnavailable,
+    listPublishedGallery: throwUnavailable,
+    getPublishedGalleryDetail: throwUnavailable,
+  };
+}
+
 export class CustomWorldAgentOrchestrator {
   private readonly foundationDraftService: CustomWorldAgentFoundationDraftService;
 
@@ -496,12 +217,29 @@ export class CustomWorldAgentOrchestrator {
 
   private readonly eightAnchorSingleTurnService: EightAnchorSingleTurnService;
 
+  private readonly suggestedActionService: CustomWorldAgentSuggestedActionService;
+
+  private readonly qualityGateService: CustomWorldAgentQualityGateService;
+
+  private readonly snapshotBuilder: CustomWorldAgentSnapshotBuilder;
+
+  private readonly resultSyncService: CustomWorldAgentResultSyncService;
+
+  private readonly publishingService: CustomWorldAgentPublishingService;
+
+  private readonly actionRegistry: CustomWorldAgentActionRegistry;
+
+  private readonly messageTurnService: CustomWorldAgentMessageTurnService;
+
   constructor(
     private readonly sessionStore: CustomWorldAgentSessionStore,
     llmClient: UpstreamLlmClient | null = null,
     options: {
       singleTurnLlmClient?: UpstreamLlmClient | null;
       autoAssetService?: CustomWorldAgentAutoAssetService | null;
+      userRepository?: UserRepositoryPort | null;
+      resolveAuthorDisplayName?: ((userId: string) => Promise<string>) | null;
+      rpgWorldProfileRepository?: RpgWorldProfileRepositoryPort | null;
     } = {},
   ) {
     this.foundationDraftService = new CustomWorldAgentFoundationDraftService(
@@ -513,11 +251,50 @@ export class CustomWorldAgentOrchestrator {
     );
     this.changeSummaryService = new CustomWorldAgentChangeSummaryService();
     this.assetBridgeService = new CustomWorldAgentAssetBridgeService();
-    this.autoAssetService =
-      options.autoAssetService ?? null;
+    this.autoAssetService = options.autoAssetService ?? null;
     this.eightAnchorSingleTurnService = new EightAnchorSingleTurnService(
       (options.singleTurnLlmClient ?? llmClient) ?? undefined,
     );
+    this.suggestedActionService = new CustomWorldAgentSuggestedActionService();
+    this.qualityGateService = new CustomWorldAgentQualityGateService();
+    this.snapshotBuilder = new CustomWorldAgentSnapshotBuilder(
+      this.draftCompiler,
+      this.suggestedActionService,
+      this.qualityGateService,
+    );
+    this.resultSyncService = new CustomWorldAgentResultSyncService();
+    this.publishingService = new CustomWorldAgentPublishingService(
+      options.rpgWorldProfileRepository ?? createUnavailablePublishingRepository(),
+    );
+    const resolveAuthorDisplayName =
+      options.resolveAuthorDisplayName ??
+      (options.userRepository
+        ? async (userId: string) => {
+            const user = await options.userRepository?.findById(userId);
+            return user?.displayName?.trim() || '玩家';
+          }
+        : null);
+    this.messageTurnService = new CustomWorldAgentMessageTurnService(
+      this.sessionStore,
+      this.eightAnchorSingleTurnService,
+      this.suggestedActionService,
+      this.snapshotBuilder,
+    );
+    this.actionRegistry = new CustomWorldAgentActionRegistry(
+      createCustomWorldAgentActionExecutorMap({
+        sessionStore: this.sessionStore,
+        foundationDraftService: this.foundationDraftService,
+        draftCompiler: this.draftCompiler,
+        entityGenerationService: this.entityGenerationService,
+        changeSummaryService: this.changeSummaryService,
+        assetBridgeService: this.assetBridgeService,
+        autoAssetService: this.autoAssetService,
+        snapshotBuilder: this.snapshotBuilder,
+        resultSyncService: this.resultSyncService,
+        publishingService: this.publishingService,
+        resolveAuthorDisplayName,
+      }),
+    );
   }
 
   async createSession(
@@ -533,46 +310,50 @@ export class CustomWorldAgentOrchestrator {
         })
       : {};
     const creatorIntent = mergeCreatorIntentRecord(baseIntent, seedPatch);
-    const derivedState = buildDerivedState(creatorIntent, Boolean(seedText));
-    const anchorContent = buildEightAnchorContentFromCreatorIntent(creatorIntent);
+    const initialState = this.messageTurnService.deriveInitialSessionState({
+      seedText,
+      creatorIntent,
+    });
     const progressPercent = seedText
-      ? estimateProgressPercentFromAnchorContent(anchorContent)
+      ? estimateProgressPercentFromAnchorContent(initialState.anchorContent)
       : 0;
     const fallbackWelcomeMessage = buildWelcomeMessage({
       seedText,
       intent: creatorIntent,
-      pendingClarifications: derivedState.pendingClarifications,
-      isReady: derivedState.readiness.isReady,
+      pendingClarifications: initialState.pendingClarifications,
+      isReady: initialState.readiness.isReady,
     });
 
     const record = await this.sessionStore.create(userId, {
       seedText,
       welcomeMessage: fallbackWelcomeMessage,
       currentTurn: 0,
-      anchorContent,
+      anchorContent: initialState.anchorContent,
       progressPercent,
       lastAssistantReply: fallbackWelcomeMessage,
       creatorIntent,
-      creatorIntentReadiness: derivedState.readiness,
-      anchorPack: buildAnchorPackFromEightAnchorContent(
-        anchorContent,
-        progressPercent,
-      ),
-      draftProfile: derivedState.draftProfile,
-      pendingClarifications: derivedState.pendingClarifications,
+      creatorIntentReadiness: initialState.readiness,
+      anchorPack: initialState.anchorPack,
+      draftProfile: initialState.draftProfile,
+      pendingClarifications: initialState.pendingClarifications,
       stage: progressPercent >= 100 ? 'foundation_review' : 'collecting_intent',
-      suggestedActions: derivedState.suggestedActions,
+      suggestedActions: initialState.suggestedActions,
       recommendedReplies: [],
     });
 
-    return (await this.sessionStore.getSnapshot(
+    return (await this.getSessionSnapshot(
       userId,
       record.sessionId,
     )) as CustomWorldAgentSessionSnapshot;
   }
 
   async getSessionSnapshot(userId: string, sessionId: string) {
-    return this.sessionStore.getSnapshot(userId, sessionId);
+    const sessionRecord = await this.sessionStore.get(userId, sessionId);
+    if (!sessionRecord) {
+      return null;
+    }
+
+    return this.buildSessionSnapshot(sessionRecord);
   }
 
   async submitMessage(
@@ -679,191 +460,21 @@ export class CustomWorldAgentOrchestrator {
       throw notFound('custom world agent session not found');
     }
 
-    if (payload.action === 'draft_foundation') {
-      if (session.progressPercent < 100) {
-        throw badRequest('draft_foundation requires progressPercent >= 100');
-      }
+    const preparedExecution = this.actionRegistry.prepareExecution(
+      session,
+      payload,
+    );
+    const operation = buildOperation(preparedExecution.operationType);
+    await this.sessionStore.createOperation(userId, sessionId, operation);
+    void preparedExecution.execute({
+      userId,
+      sessionId,
+      operationId: operation.operationId,
+    });
 
-      const operation = buildOperation('draft_foundation');
-      await this.sessionStore.createOperation(userId, sessionId, operation);
-      void this.processDraftFoundationOperation({
-        userId,
-        sessionId,
-        operationId: operation.operationId,
-      });
-
-      return {
-        operation,
-      };
-    }
-
-    if (
-      payload.action === 'update_draft_card' ||
-      payload.action === 'sync_result_profile' ||
-      payload.action === 'generate_characters' ||
-      payload.action === 'generate_landmarks' ||
-      payload.action === 'generate_role_assets' ||
-      payload.action === 'sync_role_assets'
-    ) {
-      if (
-        session.stage !== 'object_refining' &&
-        session.stage !== 'visual_refining'
-      ) {
-        throw badRequest(
-          `${payload.action} is only available during object_refining or visual_refining`,
-        );
-      }
-
-      const hasDraftFoundation = Boolean(
-        normalizeFoundationDraftProfile(session.draftProfile) &&
-          session.draftCards.length > 0,
-      );
-      if (!hasDraftFoundation) {
-        throw badRequest(
-          `${payload.action} requires an existing draft foundation`,
-        );
-      }
-    }
-
-    if (payload.action === 'update_draft_card') {
-      if (!payload.cardId.trim()) {
-        throw badRequest('update_draft_card requires cardId');
-      }
-      if (!Array.isArray(payload.sections) || payload.sections.length === 0) {
-        throw badRequest('update_draft_card requires sections');
-      }
-
-      const operation = buildOperation('update_draft_card');
-      await this.sessionStore.createOperation(userId, sessionId, operation);
-      void this.processUpdateDraftCardOperation({
-        userId,
-        sessionId,
-        operationId: operation.operationId,
-        payload,
-      });
-
-      return {
-        operation,
-      };
-    }
-
-    if (payload.action === 'sync_result_profile') {
-      const normalizedProfile = normalizeCustomWorldProfile(
-        payload.profile,
-        '',
-      );
-      if (!normalizedProfile) {
-        throw badRequest('sync_result_profile requires a valid profile');
-      }
-
-      const operation = buildOperation('sync_result_profile');
-      await this.sessionStore.createOperation(userId, sessionId, operation);
-      void this.processSyncResultProfileOperation({
-        userId,
-        sessionId,
-        operationId: operation.operationId,
-        payload: {
-          ...payload,
-          profile: normalizedProfile as unknown as Record<string, unknown>,
-        },
-      });
-
-      return {
-        operation,
-      };
-    }
-
-    if (payload.action === 'generate_characters') {
-      if (payload.count < 1 || payload.count > 3) {
-        throw badRequest('generate_characters count must be between 1 and 3');
-      }
-
-      const operation = buildOperation('generate_characters');
-      await this.sessionStore.createOperation(userId, sessionId, operation);
-      void this.processGenerateCharactersOperation({
-        userId,
-        sessionId,
-        operationId: operation.operationId,
-        payload,
-      });
-
-      return {
-        operation,
-      };
-    }
-
-    if (payload.action === 'generate_landmarks') {
-      if (payload.count < 1 || payload.count > 3) {
-        throw badRequest('generate_landmarks count must be between 1 and 3');
-      }
-
-      const operation = buildOperation('generate_landmarks');
-      await this.sessionStore.createOperation(userId, sessionId, operation);
-      void this.processGenerateLandmarksOperation({
-        userId,
-        sessionId,
-        operationId: operation.operationId,
-        payload,
-      });
-
-      return {
-        operation,
-      };
-    }
-
-    if (payload.action === 'generate_role_assets') {
-      if (!Array.isArray(payload.roleIds) || payload.roleIds.length !== 1) {
-        throw badRequest(
-          'generate_role_assets currently requires exactly one roleId',
-        );
-      }
-
-      const operation = buildOperation('generate_role_assets');
-      await this.sessionStore.createOperation(userId, sessionId, operation);
-      void this.processGenerateRoleAssetsOperation({
-        userId,
-        sessionId,
-        operationId: operation.operationId,
-        payload,
-      });
-
-      return {
-        operation,
-      };
-    }
-
-    if (payload.action === 'sync_role_assets') {
-      if (!payload.roleId.trim()) {
-        throw badRequest('sync_role_assets requires roleId');
-      }
-      if (
-        !payload.portraitPath.trim() ||
-        !payload.generatedVisualAssetId.trim()
-      ) {
-        throw badRequest(
-          'sync_role_assets requires portraitPath and generatedVisualAssetId',
-        );
-      }
-
-      const operation = buildOperation('sync_role_assets');
-      await this.sessionStore.createOperation(userId, sessionId, operation);
-      void this.processSyncRoleAssetsOperation({
-        userId,
-        sessionId,
-        operationId: operation.operationId,
-        payload,
-      });
-
-      return {
-        operation,
-      };
-    }
-
-    if (payload.action === 'publish_world') {
-      throw badRequest('publish_world is not available in phase5');
-    }
-
-    throw badRequest(`${payload.action} is not available in phase5`);
+    return {
+      operation,
+    };
   }
 
   async getOperation(userId: string, sessionId: string, operationId: string) {
@@ -887,898 +498,103 @@ export class CustomWorldAgentOrchestrator {
     relatedOperationId?: string | null;
     onReplyUpdate?: (text: string) => void;
   }) {
-    const latestSession = (await this.sessionStore.get(
-      params.userId,
-      params.sessionId,
-    )) as CustomWorldAgentSessionRecord | null;
-    if (!latestSession) {
-      throw new Error('custom world agent session not found');
-    }
-
-    const shouldPreserveDraftStage =
-      (latestSession.stage === 'object_refining' ||
-        latestSession.stage === 'visual_refining') &&
-      latestSession.draftCards.length > 0;
-
-    const assistantTurn = await this.eightAnchorSingleTurnService.streamTurn(
-      {
-        currentTurn: latestSession.currentTurn + 1,
-        progressPercent: latestSession.progressPercent,
-        quickFillRequested: params.quickFillRequested,
-        currentAnchorContent: latestSession.anchorContent,
-        chatHistory: latestSession.messages
-          .filter(
-            (message): message is CustomWorldAgentMessage =>
-              (message.role === 'user' || message.role === 'assistant') &&
-              Boolean(message.text.trim()),
-          )
-          .map((message) => ({
-            role: message.role,
-            content: message.text,
-          })),
-      },
-      {
-        onReplyUpdate: params.onReplyUpdate,
-      },
-    );
-    const nextCreatorIntent = buildCreatorIntentFromEightAnchorContent(
-      assistantTurn.nextAnchorContent,
-    );
-    const progressPercent = Math.max(
-      0,
-      Math.min(100, Math.round(assistantTurn.progressPercent)),
-    );
-    const creatorIntentReadiness =
-      progressPercent >= 100
-        ? {
-            isReady: true,
-            completedKeys: [
-              'world_hook',
-              'player_premise',
-              'theme_and_tone',
-              'core_conflict',
-              'relationship_seed',
-              'iconic_element',
-            ],
-            missingKeys: [],
-          }
-        : evaluateCreatorIntentReadiness(nextCreatorIntent);
-    const derivedState = buildDerivedState(nextCreatorIntent, true);
-    const preservedStage =
-      latestSession.stage === 'visual_refining'
-        ? ('visual_refining' as const)
-        : ('object_refining' as const);
-    const shouldStayInDraftStage =
-      shouldPreserveDraftStage && progressPercent >= 100;
-    const nextStage = shouldStayInDraftStage
-      ? preservedStage
-      : derivedState.stage;
-    const assistantMessage = {
-      id: `message-${crypto.randomBytes(8).toString('hex')}`,
-      role: 'assistant',
-      kind: 'chat',
-      text: assistantTurn.replyText,
-      createdAt: new Date().toISOString(),
-      relatedOperationId: params.relatedOperationId ?? null,
-    } satisfies CustomWorldAgentMessage;
-
-    await this.sessionStore.replaceDerivedState(params.userId, params.sessionId, {
-      currentTurn: latestSession.currentTurn + 1,
-      anchorContent: assistantTurn.nextAnchorContent,
-      progressPercent,
-      lastAssistantReply: assistantTurn.replyText,
-      stage: nextStage,
-      focusCardId: shouldStayInDraftStage ? latestSession.focusCardId : null,
-      creatorIntent: nextCreatorIntent,
-      creatorIntentReadiness,
-      anchorPack: buildAnchorPackFromEightAnchorContent(
-        assistantTurn.nextAnchorContent,
-        progressPercent,
-      ),
-      draftProfile: shouldStayInDraftStage
-        ? latestSession.draftProfile
-        : progressPercent >= 100
-          ? {
-              title: buildDraftTitleFromIntent(nextCreatorIntent),
-              summary: buildDraftSummaryFromIntent(nextCreatorIntent),
-            }
-          : derivedState.draftProfile,
-      draftCards: shouldStayInDraftStage ? latestSession.draftCards : [],
-      assetCoverage: shouldStayInDraftStage
-        ? latestSession.assetCoverage
-        : rebuildRoleAssetCoverage(
-            progressPercent >= 100
-              ? {
-                  title: buildDraftTitleFromIntent(nextCreatorIntent),
-                  summary: buildDraftSummaryFromIntent(nextCreatorIntent),
-                }
-              : derivedState.draftProfile,
-          ),
-      pendingClarifications:
-        progressPercent >= 100 ? [] : derivedState.pendingClarifications,
-      suggestedActions: shouldStayInDraftStage
-        ? buildSuggestedActions({
-            stage: preservedStage,
-            isReady: true,
-            draftProfile: latestSession.draftProfile,
-            draftCards: latestSession.draftCards,
-          })
-        : progressPercent >= 100
-          ? [
-              {
-                id: 'draft_foundation',
-                type: 'draft_foundation',
-                label: '生成游戏设定草稿',
-              },
-            ]
-          : [],
-      recommendedReplies: [],
-    });
-    await this.sessionStore.appendMessage(
-      params.userId,
-      params.sessionId,
-      assistantMessage,
-    );
-
-    return (await this.sessionStore.getSnapshot(
-      params.userId,
-      params.sessionId,
-    )) as CustomWorldAgentSessionSnapshot;
+    await this.messageTurnService.applyMessageTurn(params);
+    return this.getSessionSnapshot(params.userId, params.sessionId);
   }
 
-  private async processDraftFoundationOperation(params: {
-    userId: string;
-    sessionId: string;
-    operationId: string;
-  }) {
-    const { userId, sessionId, operationId } = params;
+  /**
+   * 统一 session snapshot 的读模型装配口径，避免普通拉取、SSE 流和内部调用返回不同字段集合。
+   */
+  private buildSessionSnapshot(
+    sessionRecord: CustomWorldAgentSessionRecord,
+  ): CustomWorldAgentSessionSnapshot {
+    const snapshot = {
+      sessionId: sessionRecord.sessionId,
+      currentTurn: sessionRecord.currentTurn,
+      anchorContent: sessionRecord.anchorContent,
+      progressPercent: sessionRecord.progressPercent,
+      lastAssistantReply: sessionRecord.lastAssistantReply,
+      stage: sessionRecord.stage,
+      focusCardId: sessionRecord.focusCardId,
+      creatorIntent: sessionRecord.creatorIntent,
+      creatorIntentReadiness: sessionRecord.creatorIntentReadiness,
+      anchorPack: sessionRecord.anchorPack,
+      lockState: sessionRecord.lockState,
+      draftProfile: sessionRecord.draftProfile,
+      messages: sessionRecord.messages,
+      draftCards: sessionRecord.draftCards,
+      pendingClarifications: sessionRecord.pendingClarifications,
+      suggestedActions: sessionRecord.suggestedActions,
+      recommendedReplies: sessionRecord.recommendedReplies,
+      qualityFindings: sessionRecord.qualityFindings,
+      assetCoverage: sessionRecord.assetCoverage,
+      checkpoints: sessionRecord.checkpoints.map((checkpoint) => ({
+        checkpointId: checkpoint.checkpointId,
+        createdAt: checkpoint.createdAt,
+        label: checkpoint.label,
+      })),
+      supportedActions: this.actionRegistry.buildSupportedActions(sessionRecord),
+      resultPreview: this.buildResultPreview(sessionRecord),
+      updatedAt: sessionRecord.updatedAt,
+    } satisfies CustomWorldAgentSessionSnapshot;
 
-    try {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'running',
-        phaseLabel: '整理世界骨架',
-        phaseDetail: '正在校验已确认锚点，并准备第一版世界框架生成链路。',
-        progress: 12,
-      });
-
-      await sleep(30);
-
-      const latestSession = (await this.sessionStore.get(
-        userId,
-        sessionId,
-      )) as CustomWorldAgentSessionRecord | null;
-      if (!latestSession) {
-        throw new Error('custom world agent session not found');
-      }
-
-      if (latestSession.progressPercent < 100) {
-        throw new Error('session progressPercent is below 100');
-      }
-
-      const creatorIntent = buildCreatorIntentFromEightAnchorContent(
-        latestSession.anchorContent,
-      );
-      const anchorPack = buildAnchorPackFromEightAnchorContent(
-        latestSession.anchorContent,
-        latestSession.progressPercent,
-      );
-
-      const draftProfile = await this.foundationDraftService.generate({
-        creatorIntent,
-        anchorPack,
-        anchorContent: latestSession.anchorContent,
-        onProgress: async (progress) => {
-          await this.sessionStore.updateOperation(
-            userId,
-            sessionId,
-            operationId,
-            {
-              status: 'running',
-              phaseLabel: progress.phaseLabel,
-              phaseDetail: progress.phaseDetail,
-              progress: progress.progress,
-            },
-          );
-        },
-      });
-
-      const draftWithAssets = this.autoAssetService
-        ? await this.autoAssetService.populateDraftAssets({
-            draftProfile,
-            onProgress: async (progress) => {
-              await this.sessionStore.updateOperation(
-                userId,
-                sessionId,
-                operationId,
-                {
-                  status: 'running',
-                  phaseLabel: progress.phaseLabel,
-                  phaseDetail: progress.phaseDetail,
-                  progress: progress.progress,
-                },
-              );
-            },
-          })
-        : {
-            draftProfile,
-            assetCoverage: rebuildRoleAssetCoverage(draftProfile),
-            warnings: [],
-          };
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        phaseLabel: '编译草稿卡',
-        phaseDetail: '正在把世界底稿整理成可浏览的卡片摘要和详情结构。',
-        progress: 98,
-      });
-
-      const draftCards = this.draftCompiler.compileDraftCards(
-        draftWithAssets.draftProfile,
-      );
-      const assetCoverage = draftWithAssets.assetCoverage;
-      const nextStage = 'object_refining' as const;
-      const nextSuggestedActions = buildSuggestedActions({
-        stage: nextStage,
-        isReady: true,
-        draftProfile: draftWithAssets.draftProfile,
-        draftCards,
-      });
-
-      await this.sessionStore.replaceDerivedState(userId, sessionId, {
-        stage: nextStage,
-        creatorIntent,
-        anchorPack,
-        draftProfile:
-          draftWithAssets.draftProfile as unknown as Record<string, unknown>,
-        draftCards,
-        assetCoverage,
-        pendingClarifications: [],
-        suggestedActions: nextSuggestedActions,
-        recommendedReplies: [],
-      });
-      await this.sessionStore.appendCheckpoint(userId, sessionId, {
-        label: '世界底稿 V1',
-      });
-      await this.sessionStore.appendMessage(
-        userId,
-        sessionId,
-        buildFoundationDraftAssistantMessage({
-          relatedOperationId: operationId,
-          draftProfile: draftWithAssets.draftProfile,
-          warnings: draftWithAssets.warnings,
-        }),
-      );
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'completed',
-        phaseLabel: '世界底稿已生成',
-        phaseDetail:
-          draftWithAssets.warnings.length > 0
-            ? `第一版世界底稿和 ${draftCards.length} 张草稿卡已经整理完成，另有 ${draftWithAssets.warnings.length} 项资产补齐待后续处理。`
-            : `第一版世界底稿和 ${draftCards.length} 张草稿卡已经整理完成。`,
-        progress: 100,
-        error: null,
-      });
-    } catch (error) {
-      const currentOperation = await this.sessionStore.getOperation(
-        userId,
-        sessionId,
-        operationId,
-      );
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'failed',
-        phaseLabel:
-          currentOperation?.phaseLabel?.trim() || '底稿生成失败',
-        phaseDetail:
-          currentOperation?.phaseDetail?.trim() ||
-          '这一轮没有成功把设定编成世界底稿。',
-        progress: 100,
-        error:
-          error instanceof Error ? error.message : 'draft foundation failed',
-      });
-    }
+    return snapshot;
   }
 
-  private async processUpdateDraftCardOperation(params: {
-    userId: string;
-    sessionId: string;
-    operationId: string;
-    payload: Extract<
-      CustomWorldAgentActionRequest,
-      { action: 'update_draft_card' }
-    >;
-  }) {
-    const { userId, sessionId, operationId, payload } = params;
+  /**
+   * 当前仍输出 legacy-compatible preview envelope，但正式把它接入 session snapshot 主链，
+   * 为后续结果页切换到服务端 preview 数据源提供稳定入口。
+   */
+  private buildResultPreview(
+    sessionRecord: CustomWorldAgentSessionRecord,
+  ): CustomWorldAgentSessionSnapshot['resultPreview'] {
+    const draftProfile =
+      sessionRecord.draftProfile &&
+      typeof sessionRecord.draftProfile === 'object' &&
+      !Array.isArray(sessionRecord.draftProfile)
+        ? (sessionRecord.draftProfile as Record<string, unknown>)
+        : null;
 
-    try {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'running',
-        phaseLabel: '写回草稿设定',
-        phaseDetail: '正在把这次编辑内容写回当前世界底稿。',
-        progress: 34,
-      });
-
-      const latestSession = (await this.sessionStore.get(
-        userId,
-        sessionId,
-      )) as CustomWorldAgentSessionRecord | null;
-      if (!latestSession) {
-        throw new Error('custom world agent session not found');
-      }
-
-      const nextDraftProfile = updateDraftCardSections({
-        draftProfile: (latestSession.draftProfile ?? {}) as Record<
-          string,
-          unknown
-        >,
-        cardId: payload.cardId,
-        sections: payload.sections,
-      });
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        phaseLabel: '重编译草稿卡',
-        phaseDetail: '正在同步更新草稿摘要和详情内容。',
-        progress: 72,
-      });
-
-      const nextDraftCards =
-        this.draftCompiler.compileDraftCards(nextDraftProfile);
-      const assetCoverage = rebuildRoleAssetCoverage(nextDraftProfile);
-      const nextStage =
-        latestSession.stage === 'visual_refining'
-          ? ('visual_refining' as const)
-          : ('object_refining' as const);
-      const nextSuggestedActions = buildSuggestedActions({
-        stage: nextStage,
-        isReady: true,
-        draftProfile: nextDraftProfile,
-        draftCards: nextDraftCards,
-      });
-      const updatedDetail = this.draftCompiler.getDraftCardDetail(
-        nextDraftProfile,
-        payload.cardId,
-      );
-      const changedSectionIds = new Set(
-        payload.sections
-          .map((section) => section.sectionId.trim())
-          .filter(Boolean),
-      );
-
-      await this.sessionStore.replaceDerivedState(userId, sessionId, {
-        stage: nextStage,
-        draftProfile: nextDraftProfile,
-        draftCards: nextDraftCards,
-        assetCoverage,
-        focusCardId: payload.cardId,
-        suggestedActions: nextSuggestedActions,
-        recommendedReplies: [],
-      });
-      await this.sessionStore.appendCheckpoint(userId, sessionId, {
-        label: `编辑 ${updatedDetail?.title || '草稿卡'}`,
-      });
-      await this.sessionStore.appendMessage(
-        userId,
-        sessionId,
-        buildActionResultMessage({
-          relatedOperationId: operationId,
-          text: this.changeSummaryService.buildSummary({
-            action: 'update_draft_card',
-            cardId: payload.cardId,
-            changedLabels:
-              updatedDetail?.sections
-                .filter((section) => changedSectionIds.has(section.id))
-                .map((section) => section.label) ?? [],
-            draftProfile: nextDraftProfile,
-          }),
-        }),
-      );
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'completed',
-        phaseLabel: '草稿设定已保存',
-        phaseDetail: `「${updatedDetail?.title || '当前卡片'}」的设定已经同步更新。`,
-        progress: 100,
-        error: null,
-      });
-    } catch (error) {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'failed',
-        phaseLabel: '保存失败',
-        phaseDetail: '这次草稿编辑没有成功写回到底稿。',
-        progress: 100,
-        error:
-          error instanceof Error ? error.message : 'update draft card failed',
-      });
+    if (!draftProfile) {
+      return null;
     }
-  }
 
-  private async processSyncResultProfileOperation(params: {
-    userId: string;
-    sessionId: string;
-    operationId: string;
-    payload: Extract<
-      CustomWorldAgentActionRequest,
-      { action: 'sync_result_profile' }
-    >;
-  }) {
-    const { userId, sessionId, operationId, payload } = params;
-
-    try {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'running',
-        phaseLabel: '同步结果页快照',
-        phaseDetail: '正在把结果页里的最新世界结构写回当前草稿。',
-        progress: 36,
-      });
-
-      const latestSession = (await this.sessionStore.get(
-        userId,
-        sessionId,
-      )) as CustomWorldAgentSessionRecord | null;
-      if (!latestSession) {
-        throw new Error('custom world agent session not found');
-      }
-
-      const resultProfile = payload.profile as unknown as CustomWorldProfile;
-      const nextDraftProfile = syncResultProfileIntoDraftProfile({
-        currentDraftProfile: latestSession.draftProfile,
-        resultProfile,
-      });
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        phaseLabel: '重编译草稿摘要',
-        phaseDetail: '正在刷新草稿卡摘要、资产覆盖和结果页恢复快照。',
-        progress: 72,
-      });
-
-      const nextDraftCards = this.draftCompiler.compileDraftCards(nextDraftProfile);
-      const assetCoverage = rebuildRoleAssetCoverage(nextDraftProfile);
-      const nextStage =
-        latestSession.stage === 'visual_refining'
-          ? ('visual_refining' as const)
-          : ('object_refining' as const);
-      const nextSuggestedActions = buildSuggestedActions({
-        stage: nextStage,
-        isReady: true,
-        draftProfile: nextDraftProfile,
-        draftCards: nextDraftCards,
-      });
-
-      await this.sessionStore.replaceDerivedState(userId, sessionId, {
-        stage: nextStage,
-        draftProfile: nextDraftProfile,
-        draftCards: nextDraftCards,
-        assetCoverage,
-        suggestedActions: nextSuggestedActions,
-        recommendedReplies: [],
-      });
-      await this.sessionStore.appendCheckpoint(userId, sessionId, {
-        label: '同步结果页编辑',
-      });
-      await this.sessionStore.appendMessage(
-        userId,
-        sessionId,
-        buildActionResultMessage({
-          relatedOperationId: operationId,
-          text: '结果页里的最新世界结构已经同步回当前草稿。',
-        }),
-      );
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'completed',
-        phaseLabel: '结果页快照已同步',
-        phaseDetail: '当前结果页编辑内容已经并回 Agent 草稿主链。',
-        progress: 100,
-        error: null,
-      });
-    } catch (error) {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'failed',
-        phaseLabel: '结果页同步失败',
-        phaseDetail: '这一轮结果页编辑没有成功写回当前草稿。',
-        progress: 100,
-        error:
-          error instanceof Error ? error.message : 'sync result profile failed',
-      });
+    if (!normalizeFoundationDraftProfile(draftProfile)) {
+      return null;
     }
-  }
-
-  private async processGenerateCharactersOperation(params: {
-    userId: string;
-    sessionId: string;
-    operationId: string;
-    payload: Extract<
-      CustomWorldAgentActionRequest,
-      { action: 'generate_characters' }
-    >;
-  }) {
-    const { userId, sessionId, operationId, payload } = params;
 
     try {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'running',
-        phaseLabel: '生成新角色',
-        phaseDetail: '正在围绕当前世界底稿补出新角色。',
-        progress: 32,
+      const publishGate = this.publishingService.summarizePublishGate({
+        sessionId: sessionRecord.sessionId,
+        stage: sessionRecord.stage,
+        draftProfile,
+        qualityFindings: sessionRecord.qualityFindings,
+      });
+      const previewProfile = buildRpgCreationPreviewProfileFromDraftProfile({
+        sessionId: sessionRecord.sessionId,
+        draftProfile,
+        profileId: publishGate.profileId,
       });
 
-      const latestSession = (await this.sessionStore.get(
-        userId,
-        sessionId,
-      )) as CustomWorldAgentSessionRecord | null;
-      if (!latestSession) {
-        throw new Error('custom world agent session not found');
-      }
-
-      const generationResult =
-        await this.entityGenerationService.generateAdditionalCharacters({
-          creatorIntent: latestSession.creatorIntent,
-          anchorPack: latestSession.anchorPack,
-          draftProfile: (latestSession.draftProfile ?? {}) as Record<
-            string,
-            unknown
-          >,
-          count: payload.count,
-          promptText: payload.promptText,
-          anchorCardIds:
-            payload.anchorCardIds && payload.anchorCardIds.length > 0
-              ? payload.anchorCardIds
-              : latestSession.focusCardId
-                ? [latestSession.focusCardId]
-                : [getWorldFoundationCardId()],
-        });
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        phaseLabel: '插入新角色卡',
-        phaseDetail: '正在把新角色插回草稿并刷新卡片列表。',
-        progress: 74,
-      });
-
-      const nextDraftCards = this.draftCompiler.compileDraftCards(
-        generationResult.draftProfile,
-      );
-      const assetCoverage = rebuildRoleAssetCoverage(
-        generationResult.draftProfile,
-      );
-      const nextStage =
-        latestSession.stage === 'visual_refining'
-          ? ('visual_refining' as const)
-          : ('object_refining' as const);
-      const nextSuggestedActions = buildSuggestedActions({
-        stage: nextStage,
-        isReady: true,
-        draftProfile: generationResult.draftProfile,
-        draftCards: nextDraftCards,
-      });
-      const focusCardId = generationResult.generatedCharacters[0]?.id ?? null;
-
-      await this.sessionStore.replaceDerivedState(userId, sessionId, {
-        stage: nextStage,
-        draftProfile: generationResult.draftProfile,
-        draftCards: nextDraftCards,
-        assetCoverage,
-        focusCardId,
-        suggestedActions: nextSuggestedActions,
-        recommendedReplies: [],
-      });
-      await this.sessionStore.appendCheckpoint(userId, sessionId, {
-        label: `新增角色 ${generationResult.generatedCharacters.length} 个`,
-      });
-      await this.sessionStore.appendMessage(
-        userId,
-        sessionId,
-        buildActionResultMessage({
-          relatedOperationId: operationId,
-          text: this.changeSummaryService.buildSummary({
-            action: 'generate_characters',
-            names: generationResult.generatedCharacters.map(
-              (entry) => entry.name,
-            ),
-            draftProfile: generationResult.draftProfile,
-          }),
-        }),
-      );
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'completed',
-        phaseLabel: '新角色已加入草稿',
-        phaseDetail: `已补出 ${generationResult.generatedCharacters.length} 个新角色。`,
-        progress: 100,
-        error: null,
-      });
-    } catch (error) {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'failed',
-        phaseLabel: '角色生成失败',
-        phaseDetail: '这一轮没有成功补出新角色。',
-        progress: 100,
-        error:
-          error instanceof Error ? error.message : 'generate characters failed',
-      });
-    }
-  }
-
-  private async processGenerateLandmarksOperation(params: {
-    userId: string;
-    sessionId: string;
-    operationId: string;
-    payload: Extract<
-      CustomWorldAgentActionRequest,
-      { action: 'generate_landmarks' }
-    >;
-  }) {
-    const { userId, sessionId, operationId, payload } = params;
-
-    try {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'running',
-        phaseLabel: '生成新地点',
-        phaseDetail: '正在围绕当前世界底稿补出新地点。',
-        progress: 32,
-      });
-
-      const latestSession = (await this.sessionStore.get(
-        userId,
-        sessionId,
-      )) as CustomWorldAgentSessionRecord | null;
-      if (!latestSession) {
-        throw new Error('custom world agent session not found');
-      }
-
-      const generationResult =
-        await this.entityGenerationService.generateAdditionalLandmarks({
-          creatorIntent: latestSession.creatorIntent,
-          anchorPack: latestSession.anchorPack,
-          draftProfile: (latestSession.draftProfile ?? {}) as Record<
-            string,
-            unknown
-          >,
-          count: payload.count,
-          promptText: payload.promptText,
-          anchorCardIds:
-            payload.anchorCardIds && payload.anchorCardIds.length > 0
-              ? payload.anchorCardIds
-              : latestSession.focusCardId
-                ? [latestSession.focusCardId]
-                : [getWorldFoundationCardId()],
-        });
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        phaseLabel: '插入新地点卡',
-        phaseDetail: '正在把新地点插回草稿并刷新卡片列表。',
-        progress: 74,
-      });
-
-      const nextDraftCards = this.draftCompiler.compileDraftCards(
-        generationResult.draftProfile,
-      );
-      const assetCoverage = rebuildRoleAssetCoverage(
-        generationResult.draftProfile,
-      );
-      const nextStage =
-        latestSession.stage === 'visual_refining'
-          ? ('visual_refining' as const)
-          : ('object_refining' as const);
-      const nextSuggestedActions = buildSuggestedActions({
-        stage: nextStage,
-        isReady: true,
-        draftProfile: generationResult.draftProfile,
-        draftCards: nextDraftCards,
-      });
-      const focusCardId = generationResult.generatedLandmarks[0]?.id ?? null;
-
-      await this.sessionStore.replaceDerivedState(userId, sessionId, {
-        stage: nextStage,
-        draftProfile: generationResult.draftProfile,
-        draftCards: nextDraftCards,
-        assetCoverage,
-        focusCardId,
-        suggestedActions: nextSuggestedActions,
-        recommendedReplies: [],
-      });
-      await this.sessionStore.appendCheckpoint(userId, sessionId, {
-        label: `新增地点 ${generationResult.generatedLandmarks.length} 个`,
-      });
-      await this.sessionStore.appendMessage(
-        userId,
-        sessionId,
-        buildActionResultMessage({
-          relatedOperationId: operationId,
-          text: this.changeSummaryService.buildSummary({
-            action: 'generate_landmarks',
-            names: generationResult.generatedLandmarks.map(
-              (entry) => entry.name,
-            ),
-            draftProfile: generationResult.draftProfile,
-          }),
-        }),
-      );
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'completed',
-        phaseLabel: '新地点已加入草稿',
-        phaseDetail: `已补出 ${generationResult.generatedLandmarks.length} 个新地点。`,
-        progress: 100,
-        error: null,
-      });
-    } catch (error) {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'failed',
-        phaseLabel: '地点生成失败',
-        phaseDetail: '这一轮没有成功补出新地点。',
-        progress: 100,
-        error:
-          error instanceof Error ? error.message : 'generate landmarks failed',
-      });
-    }
-  }
-
-  private async processGenerateRoleAssetsOperation(params: {
-    userId: string;
-    sessionId: string;
-    operationId: string;
-    payload: Extract<
-      CustomWorldAgentActionRequest,
-      { action: 'generate_role_assets' }
-    >;
-  }) {
-    const { userId, sessionId, operationId, payload } = params;
-
-    try {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'running',
-        phaseLabel: '准备角色资产工坊',
-        phaseDetail: '正在校验角色并整理工坊上下文。',
-        progress: 40,
-      });
-
-      const latestSession = (await this.sessionStore.get(
-        userId,
-        sessionId,
-      )) as CustomWorldAgentSessionRecord | null;
-      if (!latestSession) {
-        throw new Error('custom world agent session not found');
-      }
-
-      const roleId = payload.roleIds[0]!;
-      const studioContext = this.assetBridgeService.buildRoleAssetStudioContext(
-        latestSession.draftProfile,
-        roleId,
-      );
-      const nextStage = 'visual_refining' as const;
-      const nextSuggestedActions = buildSuggestedActions({
-        stage: nextStage,
-        isReady: true,
-        draftProfile: latestSession.draftProfile,
-        draftCards: latestSession.draftCards,
-      });
-
-      await this.sessionStore.replaceDerivedState(userId, sessionId, {
-        stage: nextStage,
-        focusCardId: roleId,
-        suggestedActions: nextSuggestedActions,
-        recommendedReplies: [],
-      });
-      await this.sessionStore.appendMessage(
-        userId,
-        sessionId,
-        buildActionResultMessage({
-          relatedOperationId: operationId,
-          text: `已为「${studioContext.roleName}」准备好角色资产工坊，先生成主图候选，再补核心动作。`,
-        }),
-      );
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'completed',
-        phaseLabel: '角色资产工坊已就绪',
-        phaseDetail: `「${studioContext.roleName}」现在可以开始生成主图和动作。`,
-        progress: 100,
-        error: null,
-      });
-    } catch (error) {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'failed',
-        phaseLabel: '角色资产工坊准备失败',
-        phaseDetail: '这一轮没有成功进入角色资产工坊。',
-        progress: 100,
-        error:
-          error instanceof Error
-            ? error.message
-            : 'generate role assets failed',
-      });
-    }
-  }
-
-  private async processSyncRoleAssetsOperation(params: {
-    userId: string;
-    sessionId: string;
-    operationId: string;
-    payload: Extract<
-      CustomWorldAgentActionRequest,
-      { action: 'sync_role_assets' }
-    >;
-  }) {
-    const { userId, sessionId, operationId, payload } = params;
-
-    try {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'running',
-        phaseLabel: '同步角色资产',
-        phaseDetail: '正在把主图与动作结果写回当前世界草稿。',
-        progress: 36,
-      });
-
-      const latestSession = (await this.sessionStore.get(
-        userId,
-        sessionId,
-      )) as CustomWorldAgentSessionRecord | null;
-      if (!latestSession) {
-        throw new Error('custom world agent session not found');
-      }
-
-      const syncResult = this.assetBridgeService.applyRoleAssetPublishResult(
-        latestSession.draftProfile,
-        payload,
-      );
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        phaseLabel: '刷新角色卡摘要',
-        phaseDetail: '正在同步更新角色卡状态与资产覆盖。',
-        progress: 72,
-      });
-
-      const nextDraftCards = this.draftCompiler.compileDraftCards(
-        syncResult.draftProfile,
-      );
-      const assetCoverage = rebuildRoleAssetCoverage(syncResult.draftProfile);
-      const nextSuggestedActions = buildSuggestedActions({
-        stage: 'visual_refining',
-        isReady: true,
-        draftProfile: syncResult.draftProfile,
-        draftCards: nextDraftCards,
-      });
-
-      await this.sessionStore.replaceDerivedState(userId, sessionId, {
-        stage: 'visual_refining',
-        draftProfile: syncResult.draftProfile,
-        draftCards: nextDraftCards,
-        assetCoverage,
-        focusCardId: payload.roleId,
-        suggestedActions: nextSuggestedActions,
-        recommendedReplies: [],
-      });
-      await this.sessionStore.appendCheckpoint(userId, sessionId, {
-        label: `同步角色资产 ${syncResult.updatedAssetSummary.roleName}`,
-      });
-      await this.sessionStore.appendMessage(
-        userId,
-        sessionId,
-        buildActionResultMessage({
-          relatedOperationId: operationId,
-          text: buildRoleAssetSyncResultText({
-            roleName: syncResult.updatedAssetSummary.roleName,
-            assetStatusLabel: resolveRoleAssetStatusLabel(
-              syncResult.updatedAssetSummary.status,
-            ),
-          }),
-        }),
-      );
-
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'completed',
-        phaseLabel: '角色资产已同步',
-        phaseDetail: `「${syncResult.updatedAssetSummary.roleName}」的资产状态已更新为${resolveRoleAssetStatusLabel(syncResult.updatedAssetSummary.status)}。`,
-        progress: 100,
-        error: null,
-      });
-    } catch (error) {
-      await this.sessionStore.updateOperation(userId, sessionId, operationId, {
-        status: 'failed',
-        phaseLabel: '角色资产同步失败',
-        phaseDetail: '这一轮没有成功把角色资产写回草稿。',
-        progress: 100,
-        error:
-          error instanceof Error ? error.message : 'sync role assets failed',
-      });
+      return {
+        ...buildRpgWorldPreviewEnvelope(
+          previewProfile,
+          String(previewProfile.settingText ?? ''),
+        ),
+        generatedAt: sessionRecord.updatedAt,
+        qualityFindings: sessionRecord.qualityFindings.map((finding) => ({
+          id: finding.id,
+          severity: finding.severity,
+          code: finding.code,
+          targetId: finding.targetId ?? null,
+          message: finding.message,
+        })),
+        blockers: publishGate.blockers,
+        publishReady: publishGate.publishReady,
+        canEnterWorld: publishGate.canEnterWorld,
+      };
+    } catch {
+      return null;
     }
   }
 
diff --git a/server-node/src/services/customWorldAgentPhase2.test.ts b/server-node/src/services/customWorldAgentPhase2.test.ts
index a083ceb4..46532ed1 100644
--- a/server-node/src/services/customWorldAgentPhase2.test.ts
+++ b/server-node/src/services/customWorldAgentPhase2.test.ts
@@ -1,8 +1,6 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
 
-import type { CustomWorldSessionRecord } from '../../../packages/shared/src/contracts/runtime.js';
-import type { RuntimeRepositoryPort } from '../repositories/runtimeRepository.js';
 import {
   buildPendingClarifications,
   evaluateCreatorIntentReadiness,
@@ -12,90 +10,11 @@ import {
   mergeCreatorIntentRecord,
 } from './customWorldAgentIntentExtractionService.js';
 import { CustomWorldAgentOrchestrator } from './customWorldAgentOrchestrator.js';
+import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
 import { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
 import { createTestCustomWorldAgentSingleTurnLlmClient } from './customWorldAgentTestHelpers.js';
 import { listCustomWorldWorkSummaries } from './customWorldWorkSummaryService.js';
 
-function createRuntimeRepositoryStub(): RuntimeRepositoryPort {
-  const sessionsByUser = new Map<
-    string,
-    Map<string, CustomWorldSessionRecord>
-  >();
-  const profilesByUser = new Map<string, Record<string, unknown>[]>();
-
-  const getSessionBucket = (userId: string) => {
-    const existing = sessionsByUser.get(userId);
-    if (existing) {
-      return existing;
-    }
-
-    const nextBucket = new Map<string, CustomWorldSessionRecord>();
-    sessionsByUser.set(userId, nextBucket);
-    return nextBucket;
-  };
-
-  return {
-    async getSnapshot(_userId) {
-      return null;
-    },
-    async putSnapshot(_userId, _payload) {
-      throw new Error('not implemented');
-    },
-    async deleteSnapshot(_userId) {
-      return undefined;
-    },
-    async getSettings() {
-      return {
-        musicVolume: 0.42,
-        platformTheme: 'light',
-      };
-    },
-    async putSettings(_userId, settings) {
-      return settings;
-    },
-    async listCustomWorldProfiles(userId) {
-      return [...(profilesByUser.get(userId) ?? [])];
-    },
-    async upsertCustomWorldProfile(userId, profileId, profile) {
-      const current = [...(profilesByUser.get(userId) ?? [])].filter(
-        (item) => String(item.id ?? '') !== profileId,
-      );
-      current.unshift({
-        ...profile,
-        id: profileId,
-      });
-      profilesByUser.set(userId, current);
-      return current;
-    },
-    async deleteCustomWorldProfile(userId, profileId) {
-      const current = [...(profilesByUser.get(userId) ?? [])].filter(
-        (item) => String(item.id ?? '') !== profileId,
-      );
-      profilesByUser.set(userId, current);
-      return current;
-    },
-    async listProfileSaveArchives() {
-      return [];
-    },
-    async resumeProfileSaveArchive() {
-      return null;
-    },
-    async listCustomWorldSessions(userId) {
-      return [...getSessionBucket(userId).values()];
-    },
-    async getCustomWorldSession(userId, sessionId) {
-      return getSessionBucket(userId).get(sessionId) ?? null;
-    },
-    async upsertCustomWorldSession(userId, sessionId, session) {
-      getSessionBucket(userId).set(
-        sessionId,
-        JSON.parse(JSON.stringify(session)),
-      );
-      return JSON.parse(JSON.stringify(session));
-    },
-  };
-}
-
 async function waitForOperation(
   orchestrator: CustomWorldAgentOrchestrator,
   userId: string,
@@ -184,8 +103,10 @@ test('phase2 clarification service only keeps the top highest leverage gap', ()
 });
 
 test('phase2 orchestrator advances session to foundation_review when minimal anchors are complete', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
@@ -265,8 +186,11 @@ test('phase2 orchestrator advances session to foundation_review when minimal anc
 });
 
 test('phase2 work summaries compile draft title and summary from creator intent', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
@@ -294,7 +218,7 @@ test('phase2 work summaries compile draft title and summary from creator intent'
   );
 
   const items = await listCustomWorldWorkSummaries(userId, {
-    runtimeRepository,
+    rpgWorldProfiles: rpgWorldProfileRepository,
     customWorldAgentSessions: sessionStore,
   });
   const draft = items.find(
diff --git a/server-node/src/services/customWorldAgentPhase3.test.ts b/server-node/src/services/customWorldAgentPhase3.test.ts
index bb6136dc..72384507 100644
--- a/server-node/src/services/customWorldAgentPhase3.test.ts
+++ b/server-node/src/services/customWorldAgentPhase3.test.ts
@@ -4,96 +4,15 @@ import os from 'node:os';
 import path from 'node:path';
 import test from 'node:test';
 
-import type { CustomWorldSessionRecord } from '../../../packages/shared/src/contracts/runtime.js';
 import type { AppConfig } from '../config.js';
-import type { RuntimeRepositoryPort } from '../repositories/runtimeRepository.js';
 import { CustomWorldAgentAutoAssetService } from './customWorldAgentAutoAssetService.js';
 import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
 import { CustomWorldAgentOrchestrator } from './customWorldAgentOrchestrator.js';
+import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
 import { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
 import { createTestCustomWorldAgentSingleTurnLlmClient } from './customWorldAgentTestHelpers.js';
 import { listCustomWorldWorkSummaries } from './customWorldWorkSummaryService.js';
 
-function createRuntimeRepositoryStub(): RuntimeRepositoryPort {
-  const sessionsByUser = new Map<
-    string,
-    Map<string, CustomWorldSessionRecord>
-  >();
-  const profilesByUser = new Map<string, Record<string, unknown>[]>();
-
-  const getSessionBucket = (userId: string) => {
-    const existing = sessionsByUser.get(userId);
-    if (existing) {
-      return existing;
-    }
-
-    const nextBucket = new Map<string, CustomWorldSessionRecord>();
-    sessionsByUser.set(userId, nextBucket);
-    return nextBucket;
-  };
-
-  return {
-    async getSnapshot(_userId) {
-      return null;
-    },
-    async putSnapshot(_userId, _payload) {
-      throw new Error('not implemented');
-    },
-    async deleteSnapshot(_userId) {
-      return undefined;
-    },
-    async getSettings() {
-      return {
-        musicVolume: 0.42,
-        platformTheme: 'light',
-      };
-    },
-    async putSettings(_userId, settings) {
-      return settings;
-    },
-    async listCustomWorldProfiles(userId) {
-      return [...(profilesByUser.get(userId) ?? [])];
-    },
-    async upsertCustomWorldProfile(userId, profileId, profile) {
-      const current = [...(profilesByUser.get(userId) ?? [])].filter(
-        (item) => String(item.id ?? '') !== profileId,
-      );
-      current.unshift({
-        ...profile,
-        id: profileId,
-      });
-      profilesByUser.set(userId, current);
-      return current;
-    },
-    async deleteCustomWorldProfile(userId, profileId) {
-      const current = [...(profilesByUser.get(userId) ?? [])].filter(
-        (item) => String(item.id ?? '') !== profileId,
-      );
-      profilesByUser.set(userId, current);
-      return current;
-    },
-    async listProfileSaveArchives() {
-      return [];
-    },
-    async resumeProfileSaveArchive() {
-      return null;
-    },
-    async listCustomWorldSessions(userId) {
-      return [...getSessionBucket(userId).values()];
-    },
-    async getCustomWorldSession(userId, sessionId) {
-      return getSessionBucket(userId).get(sessionId) ?? null;
-    },
-    async upsertCustomWorldSession(userId, sessionId, session) {
-      getSessionBucket(userId).set(
-        sessionId,
-        JSON.parse(JSON.stringify(session)),
-      );
-      return JSON.parse(JSON.stringify(session));
-    },
-  };
-}
-
 function createAutoAssetTestConfig(testName: string): AppConfig {
   const projectRoot = fs.mkdtempSync(
     path.join(os.tmpdir(), `genarrative-agent-phase3-${testName}-`),
@@ -259,13 +178,28 @@ async function createReadySession(
 
   assert.equal(readySession?.stage, 'foundation_review');
   assert.equal(readySession?.creatorIntentReadiness.isReady, true);
+  assert.equal(readySession?.resultPreview, null);
+  assert.equal(
+    readySession?.supportedActions?.find(
+      (entry) => entry.action === 'draft_foundation',
+    )?.enabled,
+    true,
+  );
+  assert.equal(
+    readySession?.supportedActions?.find(
+      (entry) => entry.action === 'sync_result_profile',
+    )?.enabled,
+    false,
+  );
 
   return readySession!;
 }
 
 test('phase3 ready session can execute draft_foundation and expose card detail', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
     autoAssetService: createFallbackAutoAssetService('draft'),
@@ -301,6 +235,21 @@ test('phase3 ready session can execute draft_foundation and expose card detail',
   assert.equal(operation?.status, 'completed');
   assert.equal(snapshot?.stage, 'object_refining');
   assert.ok(snapshot?.draftCards.length);
+  assert.equal(snapshot?.resultPreview?.source, 'session_preview');
+  assert.equal(
+    snapshot?.resultPreview?.preview.name,
+    typeof (snapshot?.draftProfile as Record<string, unknown>)?.name === 'string'
+      ? ((snapshot?.draftProfile as Record<string, unknown>).name as string)
+      : '未命名世界底稿',
+  );
+  assert.ok(Array.isArray(snapshot?.resultPreview?.blockers));
+  assert.ok((snapshot?.resultPreview?.blockers?.length ?? 0) >= 0);
+  assert.equal(snapshot?.resultPreview?.publishReady, false);
+  assert.equal(snapshot?.resultPreview?.canEnterWorld, false);
+  assert.equal(
+    snapshot?.resultPreview?.qualityFindings?.length,
+    snapshot?.qualityFindings.length,
+  );
   assert.ok(snapshot?.draftCards.some((card) => card.kind === 'world'));
   assert.ok(snapshot?.draftCards.some((card) => card.kind === 'faction'));
   assert.ok(snapshot?.draftCards.some((card) => card.kind === 'character'));
@@ -335,6 +284,24 @@ test('phase3 ready session can execute draft_foundation and expose card detail',
         message.text.includes('第一版世界底稿整理出来了'),
     ),
   );
+  assert.equal(
+    snapshot?.supportedActions?.find(
+      (entry) => entry.action === 'update_draft_card',
+    )?.enabled,
+    true,
+  );
+  assert.equal(
+    snapshot?.supportedActions?.find(
+      (entry) => entry.action === 'generate_role_assets',
+    )?.enabled,
+    true,
+  );
+  assert.equal(
+    snapshot?.supportedActions?.find(
+      (entry) => entry.action === 'publish_world',
+    )?.enabled,
+    true,
+  );
 
   const worldCard = snapshot?.draftCards.find((card) => card.kind === 'world');
   assert.ok(worldCard);
@@ -352,8 +319,10 @@ test('phase3 ready session can execute draft_foundation and expose card detail',
 });
 
 test('phase3 draft_foundation rejects not-ready session', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
     autoAssetService: createFallbackAutoAssetService('not-ready'),
@@ -373,8 +342,11 @@ test('phase3 draft_foundation rejects not-ready session', async () => {
 });
 
 test('phase3 work summaries prefer compiled foundation draft fields', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
     autoAssetService: createFallbackAutoAssetService('summary'),
@@ -397,7 +369,7 @@ test('phase3 work summaries prefer compiled foundation draft fields', async () =
   );
 
   const items = await listCustomWorldWorkSummaries(userId, {
-    runtimeRepository,
+    rpgWorldProfiles: rpgWorldProfileRepository,
     customWorldAgentSessions: sessionStore,
   });
   const draft = items.find((item) => item.sessionId === readySession.sessionId);
@@ -423,8 +395,10 @@ test('phase3 work summaries prefer compiled foundation draft fields', async () =
 });
 
 test('phase3 draft foundation still completes when auto asset generation fails', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const autoAssetService = new CustomWorldAgentAutoAssetService(
     createAutoAssetTestConfig('asset-failure'),
     async () => {
diff --git a/server-node/src/services/customWorldAgentPhase4.test.ts b/server-node/src/services/customWorldAgentPhase4.test.ts
index edf5c4db..a03c5c48 100644
--- a/server-node/src/services/customWorldAgentPhase4.test.ts
+++ b/server-node/src/services/customWorldAgentPhase4.test.ts
@@ -1,94 +1,13 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
 
-import type { CustomWorldSessionRecord } from '../../../packages/shared/src/contracts/runtime.js';
-import type { RuntimeRepositoryPort } from '../repositories/runtimeRepository.js';
 import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
 import { CustomWorldAgentOrchestrator } from './customWorldAgentOrchestrator.js';
+import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
 import { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
 import { createTestCustomWorldAgentSingleTurnLlmClient } from './customWorldAgentTestHelpers.js';
 import { listCustomWorldWorkSummaries } from './customWorldWorkSummaryService.js';
 
-function createRuntimeRepositoryStub(): RuntimeRepositoryPort {
-  const sessionsByUser = new Map<
-    string,
-    Map<string, CustomWorldSessionRecord>
-  >();
-  const profilesByUser = new Map<string, Record<string, unknown>[]>();
-
-  const getSessionBucket = (userId: string) => {
-    const existing = sessionsByUser.get(userId);
-    if (existing) {
-      return existing;
-    }
-
-    const nextBucket = new Map<string, CustomWorldSessionRecord>();
-    sessionsByUser.set(userId, nextBucket);
-    return nextBucket;
-  };
-
-  return {
-    async getSnapshot(_userId) {
-      return null;
-    },
-    async putSnapshot(_userId, _payload) {
-      throw new Error('not implemented');
-    },
-    async deleteSnapshot(_userId) {
-      return undefined;
-    },
-    async getSettings() {
-      return {
-        musicVolume: 0.42,
-        platformTheme: 'light',
-      };
-    },
-    async putSettings(_userId, settings) {
-      return settings;
-    },
-    async listCustomWorldProfiles(userId) {
-      return [...(profilesByUser.get(userId) ?? [])];
-    },
-    async upsertCustomWorldProfile(userId, profileId, profile) {
-      const current = [...(profilesByUser.get(userId) ?? [])].filter(
-        (item) => String(item.id ?? '') !== profileId,
-      );
-      current.unshift({
-        ...profile,
-        id: profileId,
-      });
-      profilesByUser.set(userId, current);
-      return current;
-    },
-    async deleteCustomWorldProfile(userId, profileId) {
-      const current = [...(profilesByUser.get(userId) ?? [])].filter(
-        (item) => String(item.id ?? '') !== profileId,
-      );
-      profilesByUser.set(userId, current);
-      return current;
-    },
-    async listProfileSaveArchives() {
-      return [];
-    },
-    async resumeProfileSaveArchive() {
-      return null;
-    },
-    async listCustomWorldSessions(userId) {
-      return [...getSessionBucket(userId).values()];
-    },
-    async getCustomWorldSession(userId, sessionId) {
-      return getSessionBucket(userId).get(sessionId) ?? null;
-    },
-    async upsertCustomWorldSession(userId, sessionId, session) {
-      getSessionBucket(userId).set(
-        sessionId,
-        JSON.parse(JSON.stringify(session)),
-      );
-      return JSON.parse(JSON.stringify(session));
-    },
-  };
-}
-
 async function waitForOperation(
   orchestrator: CustomWorldAgentOrchestrator,
   userId: string,
@@ -167,8 +86,10 @@ async function createObjectRefiningSession(
 }
 
 test('phase4 update_draft_card writes back draft profile and recompiles summaries', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
@@ -228,8 +149,10 @@ test('phase4 update_draft_card writes back draft profile and recompiles summarie
 });
 
 test('phase4 sync_result_profile writes result-page snapshot back into session draft chain', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
@@ -290,6 +213,15 @@ test('phase4 sync_result_profile writes result-page snapshot back into session d
     profile?.summary,
     '结果页已经把世界概述继续往沉船夜暗线收紧。',
   );
+  assert.equal(snapshot?.resultPreview?.source, 'session_preview');
+  assert.equal(
+    snapshot?.resultPreview?.preview.name,
+    '潮雾列岛·结果页精修版',
+  );
+  assert.equal(
+    snapshot?.resultPreview?.preview.playerGoal,
+    '查清沉船夜与假航灯的真正操盘者。',
+  );
   assert.equal(legacyResultProfile?.name, '潮雾列岛·结果页精修版');
   assert.equal(
     legacyResultProfile?.playerGoal,
@@ -305,8 +237,10 @@ test('phase4 sync_result_profile writes result-page snapshot back into session d
 });
 
 test('phase4 sync_result_profile keeps existing foundation structure while updating summary snapshot', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
@@ -422,8 +356,10 @@ test('phase4 sync_result_profile keeps existing foundation structure while updat
 });
 
 test('phase4 sync_result_profile also writes latest role and scene assets back into draft profile', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
@@ -578,8 +514,11 @@ test('phase4 sync_result_profile also writes latest role and scene assets back i
 });
 
 test('phase4 generate_characters appends story npcs and updates work summary counts', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
@@ -614,7 +553,7 @@ test('phase4 generate_characters appends story npcs and updates work summary cou
     ),
   ].length;
   const workItems = await listCustomWorldWorkSummaries(userId, {
-    runtimeRepository,
+    rpgWorldProfiles: rpgWorldProfileRepository,
     customWorldAgentSessions: sessionStore,
   });
   const draftItem = workItems.find((item) => item.sessionId === session.sessionId);
@@ -634,8 +573,10 @@ test('phase4 generate_characters appends story npcs and updates work summary cou
 });
 
 test('phase4 generate_landmarks appends new landmark cards and checkpoints', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
@@ -675,25 +616,33 @@ test('phase4 generate_landmarks appends new landmark cards and checkpoints', asy
 });
 
 test('phase4 work summaries exclude library draft entries after phase3 downgrade', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
   });
   const userId = 'user-phase4-work-summary-phase3';
   const session = await createObjectRefiningSession(orchestrator, userId);
 
-  await runtimeRepository.upsertCustomWorldProfile(userId, 'library-draft-1', {
-    id: 'library-draft-1',
-    name: '旧兼容草稿',
-    subtitle: '仍保留在作品库',
-    summary: '不应该继续出现在创作中心 works 聚合里。',
-    playableNpcs: [],
-    landmarks: [],
-  });
+  await rpgWorldProfileRepository.upsertOwnProfile(
+    userId,
+    'library-draft-1',
+    {
+      id: 'library-draft-1',
+      name: '旧兼容草稿',
+      subtitle: '仍保留在作品库',
+      summary: '不应该继续出现在创作中心 works 聚合里。',
+      playableNpcs: [],
+      landmarks: [],
+    },
+    '玩家',
+  );
 
   const workItems = await listCustomWorldWorkSummaries(userId, {
-    runtimeRepository,
+    rpgWorldProfiles: rpgWorldProfileRepository,
     customWorldAgentSessions: sessionStore,
   });
 
@@ -703,3 +652,54 @@ test('phase4 work summaries exclude library draft entries after phase3 downgrade
     false,
   );
 });
+
+test('phase4 work summaries hide published agent sessions from draft lane and keep published entry enterable', async () => {
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+  });
+  const userId = 'user-phase4-work-summary-published';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+
+  await sessionStore.replaceDerivedState(userId, session.sessionId, {
+    stage: 'published',
+    qualityFindings: [],
+  });
+  await rpgWorldProfileRepository.upsertOwnProfile(
+    userId,
+    `agent-draft-${session.sessionId}`,
+    {
+      id: `agent-draft-${session.sessionId}`,
+      name: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '已发布版本。',
+      playableNpcs: [],
+      landmarks: [],
+    },
+    '玩家',
+  );
+  await rpgWorldProfileRepository.publishOwnProfile(
+    userId,
+    `agent-draft-${session.sessionId}`,
+    '玩家',
+  );
+
+  const workItems = await listCustomWorldWorkSummaries(userId, {
+    rpgWorldProfiles: rpgWorldProfileRepository,
+    customWorldAgentSessions: sessionStore,
+  });
+  const draftItem = workItems.find((item) => item.sessionId === session.sessionId);
+  const publishedItem = workItems.find(
+    (item) => item.profileId === `agent-draft-${session.sessionId}`,
+  );
+
+  assert.equal(draftItem, undefined);
+  assert.equal(publishedItem?.status, 'published');
+  assert.equal(publishedItem?.canEnterWorld, true);
+  assert.equal(publishedItem?.publishReady, true);
+  assert.equal(publishedItem?.blockerCount, 0);
+});
diff --git a/server-node/src/services/customWorldAgentPhase5.test.ts b/server-node/src/services/customWorldAgentPhase5.test.ts
index 6590f136..8ad74ed2 100644
--- a/server-node/src/services/customWorldAgentPhase5.test.ts
+++ b/server-node/src/services/customWorldAgentPhase5.test.ts
@@ -4,95 +4,15 @@ import os from 'node:os';
 import path from 'node:path';
 import test from 'node:test';
 
-import type { CustomWorldSessionRecord } from '../../../packages/shared/src/contracts/runtime.js';
 import type { AppConfig } from '../config.js';
-import type { RuntimeRepositoryPort } from '../repositories/runtimeRepository.js';
+import type { UserRepositoryPort } from '../repositories/userRepository.js';
 import { CustomWorldAgentAutoAssetService } from './customWorldAgentAutoAssetService.js';
 import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
 import { CustomWorldAgentOrchestrator } from './customWorldAgentOrchestrator.js';
+import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
 import { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
 import { createTestCustomWorldAgentSingleTurnLlmClient } from './customWorldAgentTestHelpers.js';
 
-function createRuntimeRepositoryStub(): RuntimeRepositoryPort {
-  const sessionsByUser = new Map<
-    string,
-    Map<string, CustomWorldSessionRecord>
-  >();
-  const profilesByUser = new Map<string, Record<string, unknown>[]>();
-
-  const getSessionBucket = (userId: string) => {
-    const existing = sessionsByUser.get(userId);
-    if (existing) {
-      return existing;
-    }
-
-    const nextBucket = new Map<string, CustomWorldSessionRecord>();
-    sessionsByUser.set(userId, nextBucket);
-    return nextBucket;
-  };
-
-  return {
-    async getSnapshot() {
-      return null;
-    },
-    async putSnapshot(_userId, payload) {
-      return payload;
-    },
-    async deleteSnapshot() {
-      return undefined;
-    },
-    async getSettings() {
-      return {
-        musicVolume: 0.42,
-        platformTheme: 'light',
-      };
-    },
-    async putSettings(_userId, settings) {
-      return settings;
-    },
-    async listCustomWorldProfiles(userId) {
-      return [...(profilesByUser.get(userId) ?? [])];
-    },
-    async upsertCustomWorldProfile(userId, profileId, profile) {
-      const current = [...(profilesByUser.get(userId) ?? [])].filter(
-        (item) => String(item.id ?? '') !== profileId,
-      );
-      current.unshift({
-        ...profile,
-        id: profileId,
-      });
-      profilesByUser.set(userId, current);
-      return current;
-    },
-    async deleteCustomWorldProfile(userId, profileId) {
-      const current = [...(profilesByUser.get(userId) ?? [])].filter(
-        (item) => String(item.id ?? '') !== profileId,
-      );
-      profilesByUser.set(userId, current);
-      return current;
-    },
-    async listProfileSaveArchives() {
-      return [];
-    },
-    async resumeProfileSaveArchive() {
-      return null;
-    },
-    async listCustomWorldSessions(userId) {
-      return [...getSessionBucket(userId).values()];
-    },
-    async getCustomWorldSession(userId, sessionId) {
-      return getSessionBucket(userId).get(sessionId) ?? null;
-    },
-    async upsertCustomWorldSession(userId, sessionId, session) {
-      getSessionBucket(userId).set(
-        sessionId,
-        JSON.parse(JSON.stringify(session)),
-      );
-      return JSON.parse(JSON.stringify(session));
-    },
-  };
-}
-
 function createAutoAssetTestConfig(testName: string): AppConfig {
   const projectRoot = fs.mkdtempSync(
     path.join(os.tmpdir(), `genarrative-agent-phase5-${testName}-`),
@@ -194,6 +114,36 @@ function createFallbackAutoAssetService(testName: string) {
   );
 }
 
+// 发布执行器当前通过 userRepository 读取作者展示名，这里用内存 stub 对齐主链接口。
+function createUserRepository(displayName = '测试玩家'): UserRepositoryPort {
+  const now = '2026-04-21T00:00:00.000Z';
+
+  return {
+    findByUsername: async () => null,
+    findByPhoneNumber: async () => null,
+    findById: async (userId) => ({
+      id: userId,
+      username: null,
+      passwordHash: '',
+      tokenVersion: 1,
+      displayName,
+      loginProvider: 'password',
+      accountStatus: 'active',
+      phoneNumber: null,
+      phoneVerifiedAt: null,
+      createdAt: now,
+      updatedAt: now,
+    }),
+    create: async () => null,
+    createPhoneUser: async () => null,
+    createWechatPendingUser: async () => null,
+    activatePendingWechatUser: async () => null,
+    updatePhoneInfo: async () => null,
+    deleteUser: async () => undefined,
+    incrementTokenVersion: async () => null,
+  };
+}
+
 async function waitForOperation(
   orchestrator: CustomWorldAgentOrchestrator,
   userId: string,
@@ -279,9 +229,119 @@ async function createObjectRefiningSession(
   ))!;
 }
 
+async function createPublishReadySession(
+  orchestrator: CustomWorldAgentOrchestrator,
+  sessionStore: CustomWorldAgentSessionStore,
+  userId: string,
+) {
+  const session = await createObjectRefiningSession(orchestrator, userId);
+  const profile = normalizeFoundationDraftProfile(session.draftProfile);
+
+  assert.ok(profile);
+  assert.ok(profile.playableNpcs.length > 0);
+  assert.ok(profile.storyNpcs.length > 0);
+  assert.ok(profile.landmarks.length > 0);
+  assert.ok(profile.sceneChapters.length > 0);
+
+  const publishReadyProfile = {
+    ...(session.draftProfile as Record<string, unknown>),
+    camp: {
+      ...(profile.camp ?? {}),
+      id: profile.camp?.id ?? 'camp-home',
+      name: profile.camp?.name ?? '归潮营地',
+      description: profile.camp?.description ?? '可供玩家整理线索的临时据点。',
+      imageSrc: '/generated/camp/publish-ready.png',
+      generatedSceneAssetId: 'scene-camp-publish-ready',
+      generatedScenePrompt: '潮雾营地发布正式图',
+      generatedSceneModel: 'test-scene-model',
+    },
+    playableNpcs: profile.playableNpcs.map((entry, index) => ({
+      ...entry,
+      imageSrc:
+        entry.imageSrc || `/generated/playable/publish-ready-${index + 1}.png`,
+      generatedVisualAssetId:
+        entry.generatedVisualAssetId || `visual-playable-publish-${index + 1}`,
+      generatedAnimationSetId:
+        entry.generatedAnimationSetId || `anim-playable-publish-${index + 1}`,
+    })),
+    storyNpcs: profile.storyNpcs.map((entry, index) => ({
+      ...entry,
+      imageSrc:
+        entry.imageSrc || `/generated/story/publish-ready-${index + 1}.png`,
+      generatedVisualAssetId:
+        entry.generatedVisualAssetId || `visual-story-publish-${index + 1}`,
+      generatedAnimationSetId:
+        entry.generatedAnimationSetId || `anim-story-publish-${index + 1}`,
+    })),
+    landmarks: profile.landmarks.map((entry, index) => ({
+      ...entry,
+      imageSrc:
+        entry.imageSrc || `/generated/landmark/publish-ready-${index + 1}.png`,
+      generatedSceneAssetId:
+        entry.generatedSceneAssetId || `scene-landmark-publish-${index + 1}`,
+      generatedScenePrompt:
+        entry.generatedScenePrompt || `地点 ${entry.name} 的正式场景图`,
+      generatedSceneModel:
+        entry.generatedSceneModel || 'test-scene-model',
+    })),
+    sceneChapters: profile.sceneChapters.map((chapter) => ({
+      ...chapter,
+      linkedThreadIds:
+        chapter.linkedThreadIds.length > 0
+          ? chapter.linkedThreadIds
+          : [profile.threads[0]?.id ?? 'thread-publish-ready'],
+      acts: chapter.acts.map((act, index) => ({
+        ...act,
+        encounterNpcIds:
+          act.encounterNpcIds.length > 0
+            ? act.encounterNpcIds
+            : [profile.storyNpcs[0]?.id ?? profile.playableNpcs[0]?.id ?? 'role-publish-ready'],
+        primaryNpcId:
+          act.primaryNpcId ||
+          act.encounterNpcIds[0] ||
+          profile.storyNpcs[0]?.id ||
+          profile.playableNpcs[0]?.id ||
+          'role-publish-ready',
+        backgroundImageSrc:
+          act.backgroundImageSrc ||
+          `/generated/scene/publish-ready-${chapter.id}-${index + 1}.png`,
+        backgroundAssetId:
+          act.backgroundAssetId || `scene-act-publish-${chapter.id}-${index + 1}`,
+      })),
+    })),
+    chapters: profile.chapters,
+  } satisfies Record<string, unknown>;
+
+  await sessionStore.replaceDerivedState(userId, session.sessionId, {
+    stage: 'ready_to_publish',
+    draftProfile: publishReadyProfile,
+    draftCards: session.draftCards,
+    qualityFindings: [],
+    focusCardId: session.focusCardId,
+    assetCoverage: session.assetCoverage,
+  });
+
+  const publishReadySession = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+
+  assert.equal(publishReadySession?.stage, 'ready_to_publish');
+  assert.equal(
+    publishReadySession?.supportedActions.find(
+      (entry) => entry.action === 'publish_world',
+    )?.enabled,
+    true,
+  );
+
+  return publishReadySession!;
+}
+
 test('phase5 generate_role_assets only allows a single role and moves session into visual_refining', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
     autoAssetService: createFallbackAutoAssetService('generate-role-assets'),
@@ -317,6 +377,18 @@ test('phase5 generate_role_assets only allows a single role and moves session in
   assert.equal(operation?.status, 'completed');
   assert.equal(snapshot?.stage, 'visual_refining');
   assert.equal(snapshot?.focusCardId, characterIds[0]);
+  assert.equal(
+    snapshot?.supportedActions?.find(
+      (entry) => entry.action === 'generate_role_assets',
+    )?.enabled,
+    true,
+  );
+  assert.equal(
+    snapshot?.supportedActions?.find(
+      (entry) => entry.action === 'sync_role_assets',
+    )?.enabled,
+    true,
+  );
   assert.ok(
     snapshot?.messages.some(
       (message) =>
@@ -331,8 +403,10 @@ test('phase5 generate_role_assets only allows a single role and moves session in
 });
 
 test('phase5 sync_role_assets writes fields back, updates coverage and recompiles character cards', async () => {
-  const runtimeRepository = createRuntimeRepositoryStub();
-  const sessionStore = new CustomWorldAgentSessionStore(runtimeRepository);
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
   const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
     singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
     autoAssetService: createFallbackAutoAssetService('sync-role-assets'),
@@ -409,7 +483,7 @@ test('phase5 sync_role_assets writes fields back, updates coverage and recompile
       ?.idle?.basePath,
     '/generated/characters/shenli/idle',
   );
-  const syncedSkillIds = syncedRole?.skills.map((skill) => skill.id) ?? [];
+  const syncedSkillIds = syncedRole?.skills?.map((skill) => skill.id) ?? [];
   assert.ok(syncedSkillIds.length > 0);
   assert.equal(syncedAssetSummary?.status, 'animations_ready');
   assert.deepEqual(
@@ -426,3 +500,484 @@ test('phase5 sync_role_assets writes fields back, updates coverage and recompile
   );
   assert.ok((latestRecord?.checkpoints.length ?? 0) >= 2);
 });
+
+test('phase5 publish_world persists published profile and moves session into published stage', async () => {
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+    autoAssetService: createFallbackAutoAssetService('publish-world'),
+    rpgWorldProfileRepository,
+    userRepository: createUserRepository('发布测试玩家'),
+  });
+  const userId = 'user-phase5-publish-world';
+  const session = await createPublishReadySession(
+    orchestrator,
+    sessionStore,
+    userId,
+  );
+
+  const response = await orchestrator.executeAction(userId, session.sessionId, {
+    action: 'publish_world',
+  });
+  const operation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    response.operation.operationId,
+  );
+  const snapshot = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+  const profiles = await rpgWorldProfileRepository.listOwnProfiles(userId);
+  const publishedEntry = profiles.find(
+    (entry) => entry.profileId === `agent-draft-${session.sessionId}`,
+  );
+  const latestRecord = await sessionStore.get(userId, session.sessionId);
+
+  assert.equal(operation?.status, 'completed');
+  assert.equal(snapshot?.stage, 'published');
+  assert.equal(snapshot?.resultPreview?.publishReady, true);
+  assert.equal(snapshot?.resultPreview?.canEnterWorld, true);
+  assert.deepEqual(snapshot?.resultPreview?.blockers ?? [], []);
+  assert.equal(
+    snapshot?.supportedActions.find(
+      (entry) => entry.action === 'publish_world',
+    )?.enabled,
+    false,
+  );
+  assert.equal(publishedEntry?.visibility, 'published');
+  assert.equal(publishedEntry?.authorDisplayName, '发布测试玩家');
+  assert.equal(publishedEntry?.profile.id, `agent-draft-${session.sessionId}`);
+  assert.ok(
+    snapshot?.messages.some(
+      (message) =>
+        message.kind === 'action_result' &&
+        message.text.includes('已正式发布'),
+    ),
+  );
+  assert.ok(
+    latestRecord?.checkpoints.some(
+      (checkpoint) =>
+        checkpoint.label.includes('发布世界') &&
+        checkpoint.snapshot?.stage === 'published',
+    ),
+  );
+});
+
+test('phase5 generate_scene_assets prepares scene studio and sync_scene_assets writes back camp asset fields', async () => {
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+    autoAssetService: createFallbackAutoAssetService('sync-scene-assets'),
+  });
+  const userId = 'user-phase5-sync-scene-assets';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+  const campCard = session.draftCards.find((card) => card.kind === 'camp');
+
+  assert.ok(campCard);
+
+  const prepareResponse = await orchestrator.executeAction(
+    userId,
+    session.sessionId,
+    {
+      action: 'generate_scene_assets',
+      sceneIds: [campCard!.id],
+    },
+  );
+  const prepareOperation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    prepareResponse.operation.operationId,
+  );
+  const preparedSnapshot = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+
+  assert.equal(prepareOperation?.status, 'completed');
+  assert.equal(preparedSnapshot?.stage, 'visual_refining');
+  assert.equal(preparedSnapshot?.focusCardId, campCard!.id);
+  assert.ok(
+    preparedSnapshot?.messages.some(
+      (message) =>
+        message.kind === 'action_result' &&
+        message.text.includes('场景图工坊'),
+    ),
+  );
+
+  const response = await orchestrator.executeAction(userId, session.sessionId, {
+    action: 'sync_scene_assets',
+    sceneId: campCard!.id,
+    sceneKind: 'camp',
+    imageSrc: '/generated/scenes/camp-home.png',
+    generatedSceneAssetId: 'scene-camp-home-1',
+    generatedScenePrompt: '潮雾中的灯塔营地',
+    generatedSceneModel: 'test-scene-model',
+  });
+  const operation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    response.operation.operationId,
+  );
+  const snapshot = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+  const profile = normalizeFoundationDraftProfile(snapshot?.draftProfile);
+  const latestRecord = await sessionStore.get(userId, session.sessionId);
+
+  assert.equal(operation?.status, 'completed');
+  assert.equal(snapshot?.stage, 'visual_refining');
+  assert.equal(snapshot?.focusCardId, campCard!.id);
+  assert.equal(profile?.camp?.imageSrc, '/generated/scenes/camp-home.png');
+  assert.equal(profile?.camp?.generatedSceneAssetId, 'scene-camp-home-1');
+  assert.equal(profile?.camp?.generatedScenePrompt, '潮雾中的灯塔营地');
+  assert.equal(profile?.camp?.generatedSceneModel, 'test-scene-model');
+  assert.ok(
+    profile?.sceneChapters.every((chapter) =>
+      chapter.sceneId === campCard!.id
+        ? chapter.acts.every(
+            (act) =>
+              act.backgroundImageSrc === '/generated/scenes/camp-home.png' &&
+              act.backgroundAssetId === 'scene-camp-home-1',
+          )
+        : true,
+    ),
+  );
+  assert.ok(
+    snapshot?.messages.some(
+      (message) =>
+        message.kind === 'action_result' &&
+        message.text.includes('场景图写回草稿'),
+    ),
+  );
+  assert.ok(
+    latestRecord?.checkpoints.some(
+      (checkpoint) =>
+        checkpoint.label.includes('同步场景资产') && Boolean(checkpoint.snapshot),
+    ),
+  );
+});
+
+test('phase5 expand_long_tail appends characters and landmarks then moves into long_tail_review', async () => {
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+    autoAssetService: createFallbackAutoAssetService('expand-long-tail'),
+  });
+  const userId = 'user-phase5-expand-long-tail';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+  const baselineProfile = normalizeFoundationDraftProfile(session.draftProfile)!;
+  const baselineCharacterCount = [
+    ...new Set(
+      [...baselineProfile.playableNpcs, ...baselineProfile.storyNpcs].map(
+        (entry) => entry.id,
+      ),
+    ),
+  ].length;
+  const baselineLandmarkCount = baselineProfile.landmarks.length;
+
+  const response = await orchestrator.executeAction(userId, session.sessionId, {
+    action: 'expand_long_tail',
+  });
+  const operation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    response.operation.operationId,
+  );
+  const snapshot = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+  const profile = normalizeFoundationDraftProfile(snapshot?.draftProfile)!;
+  const nextCharacterCount = [
+    ...new Set(
+      [...profile.playableNpcs, ...profile.storyNpcs].map((entry) => entry.id),
+    ),
+  ].length;
+  const latestRecord = await sessionStore.get(userId, session.sessionId);
+
+  assert.equal(operation?.status, 'completed');
+  assert.equal(snapshot?.stage, 'long_tail_review');
+  assert.ok(nextCharacterCount >= baselineCharacterCount + 2);
+  assert.ok(profile.landmarks.length >= baselineLandmarkCount + 2);
+  assert.ok(
+    snapshot?.messages.some(
+      (message) =>
+        message.kind === 'action_result' &&
+        message.text.includes('长尾角色'),
+    ),
+  );
+  assert.ok(
+    latestRecord?.checkpoints.some(
+      (checkpoint) =>
+        checkpoint.label.includes('扩展长尾') && Boolean(checkpoint.snapshot),
+    ),
+  );
+});
+
+test('phase5 publish_world blocks incomplete draft and publishes complete world into repository', async () => {
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+    autoAssetService: createFallbackAutoAssetService('publish-world'),
+    rpgWorldProfileRepository,
+    userRepository: createUserRepository(),
+  });
+  const userId = 'user-phase5-publish-world';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+
+  const blockedResponse = await orchestrator.executeAction(
+    userId,
+    session.sessionId,
+    {
+      action: 'publish_world',
+    },
+  );
+  const blockedOperation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    blockedResponse.operation.operationId,
+  );
+  const blockedSnapshot = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+
+  assert.equal(blockedOperation?.status, 'failed');
+  assert.ok(
+    blockedSnapshot?.messages.some(
+      (message) =>
+        message.kind === 'warning' && message.text.includes('当前世界还不能发布'),
+    ),
+  );
+
+  const profile = normalizeFoundationDraftProfile(blockedSnapshot?.draftProfile)!;
+  const roleIds = [...profile.playableNpcs, ...profile.storyNpcs].map(
+    (entry) => entry.id,
+  );
+
+  for (const roleId of roleIds) {
+    const syncRoleResponse = await orchestrator.executeAction(
+      userId,
+      session.sessionId,
+      {
+        action: 'sync_role_assets',
+        roleId,
+        portraitPath: `/generated/characters/${roleId}.png`,
+        generatedVisualAssetId: `visual-${roleId}`,
+        generatedAnimationSetId: `animation-${roleId}`,
+        animationMap: {
+          run: { basePath: `/generated/characters/${roleId}/run` },
+          attack: { basePath: `/generated/characters/${roleId}/attack` },
+        },
+      },
+    );
+    await waitForOperation(
+      orchestrator,
+      userId,
+      session.sessionId,
+      syncRoleResponse.operation.operationId,
+    );
+  }
+
+  const latestSnapshot = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+  const latestProfile = normalizeFoundationDraftProfile(latestSnapshot?.draftProfile)!;
+  const sceneTargets = [
+    {
+      sceneId: latestProfile.camp?.id ?? 'camp-home',
+      sceneKind: 'camp' as const,
+    },
+    ...latestProfile.landmarks.map((entry) => ({
+      sceneId: entry.id,
+      sceneKind: 'landmark' as const,
+    })),
+  ];
+
+  for (const sceneTarget of sceneTargets) {
+    const syncSceneResponse = await orchestrator.executeAction(
+      userId,
+      session.sessionId,
+      {
+        action: 'sync_scene_assets',
+        sceneId: sceneTarget.sceneId,
+        sceneKind: sceneTarget.sceneKind,
+        imageSrc: `/generated/scenes/${sceneTarget.sceneId}.png`,
+        generatedSceneAssetId: `scene-${sceneTarget.sceneId}`,
+        generatedScenePrompt: `${sceneTarget.sceneId} 场景图`,
+        generatedSceneModel: 'test-scene-model',
+      },
+    );
+    await waitForOperation(
+      orchestrator,
+      userId,
+      session.sessionId,
+      syncSceneResponse.operation.operationId,
+    );
+  }
+
+  const publishResponse = await orchestrator.executeAction(
+    userId,
+    session.sessionId,
+    {
+      action: 'publish_world',
+    },
+  );
+  const publishOperation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    publishResponse.operation.operationId,
+  );
+  const publishedSnapshot = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+  const libraryEntries = await rpgWorldProfileRepository.listOwnProfiles(userId);
+  const publishedEntry = libraryEntries.find(
+    (entry) => entry.visibility === 'published',
+  );
+  const latestRecord = await sessionStore.get(userId, session.sessionId);
+
+  assert.equal(blockedOperation?.status, 'failed');
+  assert.match(blockedOperation?.error ?? '', /缺少正式主图|缺少正式场景图|缺少章节草稿/u);
+  assert.equal(blockedSnapshot?.resultPreview?.publishReady, false);
+  assert.ok((blockedSnapshot?.resultPreview?.blockers?.length ?? 0) > 0);
+  assert.equal(publishOperation?.status, 'completed');
+  assert.equal(publishedSnapshot?.stage, 'published');
+  assert.equal(publishedSnapshot?.resultPreview?.publishReady, true);
+  assert.equal(publishedSnapshot?.resultPreview?.canEnterWorld, true);
+  assert.ok(publishedSnapshot?.qualityFindings.every((entry) => entry.severity !== 'blocker'));
+  assert.ok(
+    publishedSnapshot?.messages.some(
+      (message) =>
+        message.kind === 'action_result' &&
+        message.text.includes('已正式发布'),
+    ),
+  );
+  assert.ok(publishedEntry);
+  assert.equal(publishedEntry?.profileId, `agent-draft-${session.sessionId}`);
+  assert.equal(publishedEntry?.authorDisplayName, '测试玩家');
+  assert.ok(
+    latestRecord?.checkpoints.some(
+      (checkpoint) =>
+        checkpoint.label.includes('发布世界') &&
+        checkpoint.snapshot?.stage === 'published',
+    ),
+  );
+});
+
+test('phase5 revert_checkpoint restores previous draft snapshot', async () => {
+  const { rpgAgentSessionRepository } = createInMemoryRpgWorldRepositoryPorts();
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+  const orchestrator = new CustomWorldAgentOrchestrator(sessionStore, null, {
+    singleTurnLlmClient: createTestCustomWorldAgentSingleTurnLlmClient(),
+    autoAssetService: createFallbackAutoAssetService('revert-checkpoint'),
+  });
+  const userId = 'user-phase5-revert-checkpoint';
+  const session = await createObjectRefiningSession(orchestrator, userId);
+
+  const updateResponse = await orchestrator.executeAction(
+    userId,
+    session.sessionId,
+    {
+      action: 'update_draft_card',
+      cardId: 'world-foundation',
+      sections: [
+        {
+          sectionId: 'summary',
+          value: '回滚测试摘要版本',
+        },
+      ],
+    },
+  );
+  await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    updateResponse.operation.operationId,
+  );
+
+  const afterUpdateRecord = await sessionStore.get(userId, session.sessionId);
+  const restorableCheckpoint = [...(afterUpdateRecord?.checkpoints ?? [])]
+    .reverse()
+    .find((checkpoint) => Boolean(checkpoint.snapshot));
+
+  assert.ok(restorableCheckpoint);
+
+  const syncRoleResponse = await orchestrator.executeAction(
+    userId,
+    session.sessionId,
+    {
+      action: 'sync_role_assets',
+      roleId:
+        normalizeFoundationDraftProfile(
+          (await orchestrator.getSessionSnapshot(userId, session.sessionId))
+            ?.draftProfile,
+        )?.playableNpcs[0]?.id ?? 'unknown-role',
+      portraitPath: '/generated/characters/revert-test.png',
+      generatedVisualAssetId: 'visual-revert-test',
+      generatedAnimationSetId: 'animation-revert-test',
+      animationMap: {
+        run: { basePath: '/generated/characters/revert-test/run' },
+        attack: { basePath: '/generated/characters/revert-test/attack' },
+      },
+    },
+  );
+  await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    syncRoleResponse.operation.operationId,
+  );
+
+  const response = await orchestrator.executeAction(userId, session.sessionId, {
+    action: 'revert_checkpoint',
+    checkpointId: restorableCheckpoint!.checkpointId,
+  });
+  const operation = await waitForOperation(
+    orchestrator,
+    userId,
+    session.sessionId,
+    response.operation.operationId,
+  );
+  const snapshot = await orchestrator.getSessionSnapshot(
+    userId,
+    session.sessionId,
+  );
+  const profile = normalizeFoundationDraftProfile(snapshot?.draftProfile);
+
+  assert.equal(operation?.status, 'completed');
+  assert.equal(profile?.summary, '回滚测试摘要版本');
+  assert.ok(
+    snapshot?.messages.some(
+      (message) =>
+        message.kind === 'action_result' &&
+        message.text.includes('已恢复到检查点'),
+    ),
+  );
+});
diff --git a/server-node/src/services/customWorldAgentPublishGateService.ts b/server-node/src/services/customWorldAgentPublishGateService.ts
new file mode 100644
index 00000000..64c9d1e0
--- /dev/null
+++ b/server-node/src/services/customWorldAgentPublishGateService.ts
@@ -0,0 +1,141 @@
+import type {
+  CustomWorldAgentSessionSnapshot,
+} from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
+
+export type CustomWorldAgentPublishGateResult = {
+  blockers: CustomWorldAgentSessionSnapshot['qualityFindings'];
+  warnings: CustomWorldAgentSessionSnapshot['qualityFindings'];
+};
+
+function buildFinding(params: {
+  id: string;
+  code: string;
+  severity: 'warning' | 'blocker';
+  targetId?: string | null;
+  message: string;
+}) {
+  return {
+    id: params.id,
+    code: params.code,
+    severity: params.severity,
+    targetId: params.targetId ?? null,
+    message: params.message,
+  } satisfies CustomWorldAgentSessionSnapshot['qualityFindings'][number];
+}
+
+export class CustomWorldAgentPublishGateService {
+  evaluate(params: {
+    draftProfile: unknown;
+    qualityFindings: CustomWorldAgentSessionSnapshot['qualityFindings'];
+  }): CustomWorldAgentPublishGateResult {
+    const draftProfile = normalizeFoundationDraftProfile(params.draftProfile);
+    const blockers = params.qualityFindings.filter(
+      (entry) => entry.severity === 'blocker',
+    );
+    const warnings = params.qualityFindings.filter(
+      (entry) => entry.severity === 'warning',
+    );
+
+    if (!draftProfile) {
+      return {
+        blockers: [
+          ...blockers,
+          buildFinding({
+            id: 'publish-empty-draft',
+            code: 'publish_empty_draft',
+            severity: 'blocker',
+            message: '当前还没有可发布的世界底稿，请先整理世界骨架。',
+          }),
+        ],
+        warnings,
+      };
+    }
+
+    if ((draftProfile.chapters?.length ?? 0) <= 0) {
+      blockers.push(
+        buildFinding({
+          id: 'publish-missing-main-chapter',
+          code: 'publish_missing_main_chapter',
+          severity: 'blocker',
+          message: '发布前至少需要保留主线第一幕，当前世界还缺少章节草稿。',
+        }),
+      );
+    }
+
+    const missingRoleVisuals = [
+      ...draftProfile.playableNpcs,
+      ...draftProfile.storyNpcs,
+    ].filter(
+      (entry) =>
+        !entry.generatedVisualAssetId?.trim() ||
+        !entry.generatedAnimationSetId?.trim(),
+    );
+    if (missingRoleVisuals.length > 0) {
+      blockers.push(
+        buildFinding({
+          id: 'publish-role-assets-incomplete',
+          code: 'publish_role_assets_incomplete',
+          severity: 'blocker',
+          targetId: missingRoleVisuals[0]?.id ?? null,
+          message: '仍有角色缺少正式主图或动作资产，发布前需要先补齐。',
+        }),
+      );
+    }
+
+    if (
+      !draftProfile.camp?.imageSrc?.trim() ||
+      !(draftProfile.camp as Record<string, unknown> | null)?.generatedSceneAssetId
+    ) {
+      blockers.push(
+        buildFinding({
+          id: 'publish-camp-scene-missing',
+          code: 'publish_camp_scene_missing',
+          severity: 'blocker',
+          targetId: draftProfile.camp?.id ?? null,
+          message: '营地还缺少正式场景图资产，发布前需要先确认营地图。',
+        }),
+      );
+    }
+
+    const missingLandmarkScenes = draftProfile.landmarks.filter((entry) => {
+      const record = entry as Record<string, unknown>;
+      return (
+        !entry.imageSrc?.trim() || !String(record.generatedSceneAssetId ?? '').trim()
+      );
+    });
+    if (missingLandmarkScenes.length > 0) {
+      blockers.push(
+        buildFinding({
+          id: 'publish-landmark-scenes-missing',
+          code: 'publish_landmark_scenes_missing',
+          severity: 'blocker',
+          targetId: missingLandmarkScenes[0]?.id ?? null,
+          message: '仍有地点缺少正式场景图资产，发布前需要先补齐地点图。',
+        }),
+      );
+    }
+
+    const invalidSceneChapters = draftProfile.sceneChapters.filter(
+      (entry) =>
+        entry.linkedThreadIds.length <= 0 ||
+        entry.acts.every((act) => act.encounterNpcIds.length <= 0),
+    );
+    if (invalidSceneChapters.length > 0) {
+      blockers.push(
+        buildFinding({
+          id: 'publish-scene-chapter-unbound',
+          code: 'publish_scene_chapter_unbound',
+          severity: 'blocker',
+          targetId: invalidSceneChapters[0]?.id ?? null,
+          message: '场景章节还没有绑定足够的线程或角色，发布前请先补齐主线挂钩。',
+        }),
+      );
+    }
+
+    return {
+      blockers,
+      warnings,
+    };
+  }
+}
diff --git a/server-node/src/services/customWorldAgentPublishService.ts b/server-node/src/services/customWorldAgentPublishService.ts
new file mode 100644
index 00000000..f3fa02ae
--- /dev/null
+++ b/server-node/src/services/customWorldAgentPublishService.ts
@@ -0,0 +1,410 @@
+import type {
+  CustomWorldAgentSessionRecord,
+} from './customWorldAgentSessionStore.js';
+import {
+  buildCompiledCustomWorldProfile,
+} from '../modules/custom-world/runtimeProfile.js';
+import type { CustomWorldProfile } from '../modules/custom-world/runtimeTypes.js';
+import type { RpgWorldProfileRepositoryPort } from '../repositories/RpgWorldProfileRepository.js';
+import type { CustomWorldProfileRecord } from '../../../packages/shared/src/contracts/runtime.js';
+
+function toText(value: unknown, fallback = '') {
+  return typeof value === 'string' ? value.trim() : fallback;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function toRecordArray(value: unknown) {
+  return Array.isArray(value)
+    ? value.filter(
+        (item): item is Record<string, unknown> =>
+          Boolean(item) && typeof item === 'object' && !Array.isArray(item),
+      )
+    : [];
+}
+
+function toStringArray(value: unknown, max = 8) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  return [...new Set(value.map((item) => toText(item)).filter(Boolean))].slice(
+    0,
+    max,
+  );
+}
+
+function buildSettingTextFromSession(session: CustomWorldAgentSessionRecord) {
+  const anchorContent = session.anchorContent;
+
+  const anchorLines = [
+    anchorContent.worldPromise
+      ? `世界承诺：${[
+          anchorContent.worldPromise.hook,
+          anchorContent.worldPromise.differentiator,
+          anchorContent.worldPromise.desiredExperience,
+        ]
+          .filter(Boolean)
+          .join('；')}`
+      : '',
+    anchorContent.playerFantasy
+      ? `玩家幻想：${[
+          anchorContent.playerFantasy.playerRole,
+          anchorContent.playerFantasy.corePursuit,
+          anchorContent.playerFantasy.fearOfLoss,
+        ]
+          .filter(Boolean)
+          .join('；')}`
+      : '',
+    anchorContent.coreConflict
+      ? `核心冲突：${[
+          anchorContent.coreConflict.surfaceConflicts.join('、'),
+          anchorContent.coreConflict.hiddenCrisis,
+          anchorContent.coreConflict.firstTouchedConflict,
+        ]
+          .filter(Boolean)
+          .join('；')}`
+      : '',
+    anchorContent.iconicElements
+      ? `标志元素：${[
+          anchorContent.iconicElements.iconicMotifs.join('、'),
+          anchorContent.iconicElements.institutionsOrArtifacts.join('、'),
+          anchorContent.iconicElements.hardRules.join('、'),
+        ]
+          .filter(Boolean)
+          .join('；')}`
+      : '',
+  ].filter(Boolean);
+
+  if (anchorLines.length > 0) {
+    return anchorLines.join('\n');
+  }
+
+  return session.seedText.trim() || '当前世界草稿已经进入发布阶段。';
+}
+
+function buildRuntimeRoleFromDraft(
+  draftRole: Record<string, unknown>,
+  roleKind: 'playable' | 'story',
+  index: number,
+) {
+  const name = toText(draftRole.name) || `角色 ${index + 1}`;
+  const title =
+    toText(draftRole.title) ||
+    toText(draftRole.role) ||
+    (roleKind === 'playable' ? '关键角色' : '场景角色');
+  const role = toText(draftRole.role) || title;
+
+  return {
+    id: toText(draftRole.id) || `${roleKind}-draft-${index + 1}`,
+    name,
+    title,
+    role,
+    description:
+      toText(draftRole.summary) ||
+      toText(draftRole.publicIdentity) ||
+      toText(draftRole.publicMask) ||
+      toText(draftRole.currentPressure),
+    backstory: [
+      toText(draftRole.publicIdentity),
+      toText(draftRole.currentPressure),
+      toText(draftRole.hiddenHook)
+        ? `暗线：${toText(draftRole.hiddenHook)}`
+        : '',
+    ]
+      .filter(Boolean)
+      .join('；'),
+    personality:
+      toText(draftRole.publicMask) ||
+      toText(draftRole.publicIdentity) ||
+      toText(draftRole.summary),
+    motivation:
+      toText(draftRole.relationToPlayer) ||
+      toText(draftRole.currentPressure) ||
+      toText(draftRole.hiddenHook),
+    combatStyle: role,
+    initialAffinity: roleKind === 'playable' ? 18 : 6,
+    relationshipHooks: [
+      toText(draftRole.relationToPlayer),
+      toText(draftRole.currentPressure),
+      toText(draftRole.hiddenHook),
+    ].filter(Boolean),
+    tags: [
+      ...toStringArray(draftRole.threadIds, 4),
+      roleKind === 'playable' ? '草稿主角' : '草稿角色',
+    ],
+    imageSrc: toText(draftRole.imageSrc) || undefined,
+    generatedVisualAssetId:
+      toText(draftRole.generatedVisualAssetId) || undefined,
+    generatedAnimationSetId:
+      toText(draftRole.generatedAnimationSetId) || undefined,
+    animationMap: isRecord(draftRole.animationMap)
+      ? draftRole.animationMap
+      : undefined,
+  } satisfies Record<string, unknown>;
+}
+
+function buildRuntimeLandmarkFromDraft(
+  draftLandmark: Record<string, unknown>,
+  storyNpcIdSet: Set<string>,
+  index: number,
+) {
+  return {
+    id: toText(draftLandmark.id) || `landmark-draft-${index + 1}`,
+    name: toText(draftLandmark.name) || `关键地点 ${index + 1}`,
+    description:
+      toText(draftLandmark.description) ||
+      toText(draftLandmark.summary) ||
+      [toText(draftLandmark.purpose), toText(draftLandmark.mood)]
+        .filter(Boolean)
+        .join('；'),
+    dangerLevel:
+      toText(draftLandmark.dangerLevel) ||
+      toText(draftLandmark.importance) ||
+      toText(draftLandmark.mood) ||
+      'medium',
+    imageSrc: toText(draftLandmark.imageSrc) || undefined,
+    generatedSceneAssetId:
+      toText(draftLandmark.generatedSceneAssetId) || undefined,
+    generatedScenePrompt:
+      toText(draftLandmark.generatedScenePrompt) || undefined,
+    generatedSceneModel:
+      toText(draftLandmark.generatedSceneModel) || undefined,
+    sceneNpcIds: toStringArray(draftLandmark.characterIds).filter((entry) =>
+      storyNpcIdSet.has(entry),
+    ),
+    connections: [],
+  } satisfies Record<string, unknown>;
+}
+
+function buildRuntimeCampFromDraft(draftCamp: Record<string, unknown> | null) {
+  if (!draftCamp) {
+    return null;
+  }
+
+  const name = toText(draftCamp.name);
+  const description = toText(draftCamp.description);
+  if (!name && !description) {
+    return null;
+  }
+
+  return {
+    id: toText(draftCamp.id) || 'camp-home',
+    name: name || '开局营地',
+    description: description || '当前世界的开局落脚点。',
+    dangerLevel:
+      toText(draftCamp.dangerLevel) || toText(draftCamp.mood) || 'low',
+    imageSrc: toText(draftCamp.imageSrc) || undefined,
+    generatedSceneAssetId:
+      toText(draftCamp.generatedSceneAssetId) || undefined,
+    generatedScenePrompt:
+      toText(draftCamp.generatedScenePrompt) || undefined,
+    generatedSceneModel:
+      toText(draftCamp.generatedSceneModel) || undefined,
+    sceneNpcIds: [],
+    connections: [],
+  } satisfies Record<string, unknown>;
+}
+
+function buildRuntimeSceneChaptersFromDraft(
+  draftProfile: Record<string, unknown>,
+  storyNpcIdSet: Set<string>,
+  landmarkIdSet: Set<string>,
+) {
+  return toRecordArray(draftProfile.sceneChapters)
+    .map((sceneChapter, chapterIndex) => {
+      const sceneId = toText(sceneChapter.sceneId);
+      if (!sceneId) {
+        return null;
+      }
+
+      const acts = toRecordArray(sceneChapter.acts)
+        .map((act, actIndex) => {
+          const encounterNpcIds = toStringArray(act.encounterNpcIds).filter(
+            (entry) => storyNpcIdSet.has(entry),
+          );
+          const primaryNpcId =
+            toText(act.primaryNpcId) || encounterNpcIds[0] || '';
+
+          return {
+            id: toText(act.id) || `scene-act-${sceneId}-${actIndex + 1}`,
+            sceneId,
+            title: toText(act.title) || `第 ${actIndex + 1} 幕`,
+            summary:
+              toText(act.summary) ||
+              toText(act.actGoal) ||
+              `围绕${toText(sceneChapter.sceneName, sceneId)}继续推进`,
+            stageCoverage:
+              toStringArray(act.stageCoverage).length > 0
+                ? toStringArray(act.stageCoverage)
+                : actIndex === 0
+                  ? ['opening']
+                  : ['climax', 'aftermath'],
+            backgroundImageSrc:
+              toText(act.backgroundImageSrc) || undefined,
+            backgroundAssetId: toText(act.backgroundAssetId) || undefined,
+            encounterNpcIds,
+            primaryNpcId,
+            linkedThreadIds: toStringArray(act.linkedThreadIds, 8),
+            advanceRule:
+              toText(act.advanceRule) || 'after_active_step_complete',
+            actGoal: toText(act.actGoal),
+            transitionHook: toText(act.transitionHook),
+          } satisfies Record<string, unknown>;
+        })
+        .filter(
+          (entry) =>
+            entry.encounterNpcIds.length > 0 || entry.backgroundImageSrc,
+        );
+
+      return {
+        id:
+          toText(sceneChapter.id) ||
+          `scene-chapter-${sceneId}-${chapterIndex + 1}`,
+        sceneId,
+        title:
+          toText(sceneChapter.title) ||
+          toText(sceneChapter.sceneName) ||
+          sceneId,
+        summary:
+          toText(sceneChapter.summary) ||
+          toText(sceneChapter.title) ||
+          toText(sceneChapter.sceneName) ||
+          sceneId,
+        linkedThreadIds: toStringArray(sceneChapter.linkedThreadIds, 8),
+        linkedLandmarkIds: toStringArray(
+          sceneChapter.linkedLandmarkIds,
+          8,
+        ).filter((entry) => landmarkIdSet.has(entry)),
+        acts,
+      } satisfies Record<string, unknown>;
+    })
+    .filter(Boolean);
+}
+
+function buildPublishRawProfile(
+  session: CustomWorldAgentSessionRecord,
+  profileId: string,
+) {
+  const draftProfile = isRecord(session.draftProfile) ? session.draftProfile : {};
+  const legacyResultProfile = isRecord(draftProfile.legacyResultProfile)
+    ? draftProfile.legacyResultProfile
+    : null;
+  const playableNpcs = toRecordArray(draftProfile.playableNpcs).map(
+    (entry, index) => buildRuntimeRoleFromDraft(entry, 'playable', index),
+  );
+  const storyNpcs = toRecordArray(draftProfile.storyNpcs).map((entry, index) =>
+    buildRuntimeRoleFromDraft(entry, 'story', index),
+  );
+  const storyNpcIdSet = new Set(
+    storyNpcs.map((entry) => toText(entry.id)).filter(Boolean),
+  );
+  const landmarks = toRecordArray(draftProfile.landmarks).map((entry, index) =>
+    buildRuntimeLandmarkFromDraft(entry, storyNpcIdSet, index),
+  );
+  const landmarkIdSet = new Set(
+    landmarks.map((entry) => toText(entry.id)).filter(Boolean),
+  );
+
+  return {
+    ...(legacyResultProfile ?? {}),
+    id: profileId,
+    settingText: buildSettingTextFromSession(session),
+    name:
+      toText(draftProfile.name) ||
+      toText(legacyResultProfile?.name) ||
+      '未命名世界底稿',
+    subtitle:
+      toText(draftProfile.subtitle) ||
+      toText(legacyResultProfile?.subtitle) ||
+      '已发布世界',
+    summary:
+      toText(draftProfile.summary) ||
+      toText(legacyResultProfile?.summary) ||
+      '当前世界已经进入发布态。',
+    tone:
+      toText(draftProfile.tone) ||
+      toText(legacyResultProfile?.tone) ||
+      '整体气质仍带着明显张力',
+    playerGoal:
+      toText(draftProfile.playerGoal) ||
+      toText(legacyResultProfile?.playerGoal) ||
+      '先站稳局势，再判断下一步',
+    majorFactions:
+      toStringArray(draftProfile.majorFactions, 6).length > 0
+        ? toStringArray(draftProfile.majorFactions, 6)
+        : Array.isArray(legacyResultProfile?.majorFactions)
+          ? legacyResultProfile.majorFactions
+          : [],
+    coreConflicts:
+      toStringArray(draftProfile.coreConflicts, 6).length > 0
+        ? toStringArray(draftProfile.coreConflicts, 6)
+        : Array.isArray(legacyResultProfile?.coreConflicts)
+          ? legacyResultProfile.coreConflicts
+          : [toText(draftProfile.summary) || '核心冲突仍待继续补强'],
+    playableNpcs,
+    storyNpcs,
+    landmarks,
+    camp: buildRuntimeCampFromDraft(
+      isRecord(draftProfile.camp) ? draftProfile.camp : null,
+    ),
+    sceneChapterBlueprints: buildRuntimeSceneChaptersFromDraft(
+      draftProfile,
+      storyNpcIdSet,
+      landmarkIdSet,
+    ),
+    anchorContent: session.anchorContent,
+    creatorIntent: session.creatorIntent,
+    anchorPack: session.anchorPack,
+    lockState: session.lockState,
+    generationMode: 'full',
+    generationStatus: 'complete',
+  } satisfies Record<string, unknown>;
+}
+
+export class CustomWorldAgentPublishService {
+  buildProfileId(sessionId: string) {
+    return `agent-draft-${sessionId}`;
+  }
+
+  compilePublishedProfile(
+    session: CustomWorldAgentSessionRecord,
+  ): CustomWorldProfile {
+    const profileId = this.buildProfileId(session.sessionId);
+    const rawProfile = buildPublishRawProfile(session, profileId);
+
+    return buildCompiledCustomWorldProfile(
+      rawProfile,
+      buildSettingTextFromSession(session),
+    );
+  }
+
+  async publish(params: {
+    session: CustomWorldAgentSessionRecord;
+    userId: string;
+    authorDisplayName: string;
+    profileRepository: RpgWorldProfileRepositoryPort;
+  }) {
+    const publishedProfile = this.compilePublishedProfile(params.session);
+    const profileId = this.buildProfileId(params.session.sessionId);
+    const mutation = await params.profileRepository.upsertOwnProfile(
+      params.userId,
+      profileId,
+      publishedProfile as unknown as CustomWorldProfileRecord,
+      params.authorDisplayName || '玩家',
+    );
+    const publishedMutation = await params.profileRepository.publishOwnProfile(
+      params.userId,
+      profileId,
+      params.authorDisplayName || '玩家',
+    );
+
+    return {
+      profileId,
+      publishedProfile,
+      mutation: publishedMutation ?? mutation,
+    };
+  }
+}
diff --git a/server-node/src/services/customWorldAgentPublishingService.ts b/server-node/src/services/customWorldAgentPublishingService.ts
new file mode 100644
index 00000000..4577f38e
--- /dev/null
+++ b/server-node/src/services/customWorldAgentPublishingService.ts
@@ -0,0 +1,256 @@
+import type { CustomWorldProfileRecord } from '../../../packages/shared/src/contracts/runtime.js';
+import type { RpgWorldProfileRepositoryPort } from '../repositories/RpgWorldProfileRepository.js';
+import { buildRpgCreationPreviewProfileFromDraftProfile } from './rpgCreationPreviewProfileBuilder.js';
+import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
+
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function hasGeneratedSceneAsset(
+  value: unknown,
+) {
+  return Boolean(toText((value as Record<string, unknown> | null)?.generatedSceneAssetId));
+}
+
+export class CustomWorldAgentPublishingService {
+  constructor(
+    private readonly rpgWorldProfileRepository: RpgWorldProfileRepositoryPort,
+  ) {}
+
+  /**
+   * Phase4 需要把“能不能发布”收成可读的后端真相，
+   * 这样结果页、works 和 publish executor 才能共享同一套 blocker 语义。
+   */
+  evaluatePublishReadiness(params: {
+    sessionId: string;
+    draftProfile: unknown;
+    qualityFindings?: Array<{
+      severity: 'info' | 'warning' | 'blocker';
+      code?: string;
+      targetId?: string | null;
+      message: string;
+    }>;
+  }) {
+    const draftProfile = normalizeFoundationDraftProfile(params.draftProfile);
+    if (!draftProfile) {
+      return {
+        profileId: `agent-draft-${params.sessionId}`,
+        blockers: [
+          {
+            severity: 'blocker' as const,
+            code: 'publish_empty_draft',
+            message: '当前世界草稿为空，无法发布。',
+          },
+        ],
+      };
+    }
+
+    const findings = params.qualityFindings ?? [];
+    const blockers = findings.filter((entry) => entry.severity === 'blocker');
+    const readinessBlockers = [...blockers];
+
+    if (!draftProfile.worldHook.trim()) {
+      readinessBlockers.push({
+        severity: 'blocker',
+        code: 'publish_missing_world_hook',
+        message: '当前世界缺少 world hook，发布前需要先补齐世界一句话钩子。',
+      });
+    }
+
+    if (!draftProfile.playerPremise.trim()) {
+      readinessBlockers.push({
+        severity: 'blocker',
+        code: 'publish_missing_player_premise',
+        message: '当前世界缺少玩家身份与切入前提，发布前需要先补齐玩家 premise。',
+      });
+    }
+
+    if (
+      draftProfile.coreConflicts.length <= 0 ||
+      !draftProfile.coreConflicts.some((entry) => toText(entry))
+    ) {
+      readinessBlockers.push({
+        severity: 'blocker',
+        code: 'publish_missing_core_conflict',
+        message: '当前世界缺少核心冲突，发布前需要先补齐核心冲突。',
+      });
+    }
+
+    if ((draftProfile.chapters?.length ?? 0) <= 0) {
+      readinessBlockers.push({
+        severity: 'blocker',
+        code: 'publish_missing_main_chapter',
+        message: '当前世界还没有主线章节草稿，发布前至少要保留主线第一幕。',
+      });
+    }
+
+    const firstSceneActExists = draftProfile.sceneChapters.some(
+      (chapter) => chapter.acts.length > 0,
+    );
+    if (!firstSceneActExists) {
+      readinessBlockers.push({
+        severity: 'blocker',
+        code: 'publish_missing_first_act',
+        message: '当前世界还没有主线第一幕，发布前至少要保留一个场景幕。',
+      });
+    }
+
+    const missingRoleAssets = [
+      ...draftProfile.playableNpcs,
+      ...draftProfile.storyNpcs,
+    ].filter(
+      (role) =>
+        !toText(role.generatedVisualAssetId) ||
+        !toText(role.generatedAnimationSetId),
+    );
+    if (missingRoleAssets.length > 0) {
+      readinessBlockers.push({
+        severity: 'blocker',
+        code: 'publish_role_assets_incomplete',
+        targetId: missingRoleAssets[0]?.id ?? null,
+        message: '仍有角色缺少正式主图或动作资产，发布前需要先补齐。',
+      });
+    }
+
+    if (!draftProfile.camp || !toText(draftProfile.camp.imageSrc) || !hasGeneratedSceneAsset(draftProfile.camp)) {
+      readinessBlockers.push({
+        severity: 'blocker',
+        code: 'publish_camp_scene_missing',
+        targetId: draftProfile.camp?.id ?? null,
+        message: '营地还缺少正式场景图资产，发布前需要先确认营地图。',
+      });
+    }
+
+    const missingLandmarkScenes = draftProfile.landmarks.filter(
+      (landmark) =>
+        !toText(landmark.imageSrc) || !hasGeneratedSceneAsset(landmark),
+    );
+    if (missingLandmarkScenes.length > 0) {
+      readinessBlockers.push({
+        severity: 'blocker',
+        code: 'publish_landmark_scene_missing',
+        targetId: missingLandmarkScenes[0]?.id ?? null,
+        message: '仍有地点缺少正式场景图资产，发布前需要先补齐地点图。',
+      });
+    }
+
+    return {
+      profileId:
+        toText(
+          (params.draftProfile as Record<string, unknown> | null)
+            ?.legacyResultProfile?.id,
+        ) || `agent-draft-${params.sessionId}`,
+      blockers: readinessBlockers,
+    };
+  }
+
+  /**
+   * Phase4 统一复用发布门禁摘要，避免 preview / works / enter-world 各自拼 blocker 口径。
+   */
+  summarizePublishGate(params: {
+    sessionId: string;
+    stage?: string | null;
+    draftProfile: unknown;
+    qualityFindings?: Array<{
+      severity: 'info' | 'warning' | 'blocker';
+      code?: string;
+      targetId?: string | null;
+      message: string;
+    }>;
+  }) {
+    const readiness = this.evaluatePublishReadiness(params);
+    const blockers = readiness.blockers.map((entry) => ({
+      id:
+        typeof entry.code === 'string' && entry.code.trim()
+          ? entry.code
+          : `publish-blocker-${entry.message}`,
+      code:
+        typeof entry.code === 'string' && entry.code.trim()
+          ? entry.code
+          : 'publish_blocker',
+      message: entry.message,
+    }));
+
+    return {
+      profileId: readiness.profileId,
+      blockers,
+      blockerCount: blockers.length,
+      publishReady: blockers.length === 0,
+      canEnterWorld:
+        String(params.stage ?? '').trim() === 'published' && blockers.length === 0,
+    };
+  }
+
+  buildPublishReadiness(params: {
+    sessionId: string;
+    draftProfile: unknown;
+    qualityFindings?: Array<{
+      severity: 'info' | 'warning' | 'blocker';
+      code?: string;
+      targetId?: string | null;
+      message: string;
+    }>;
+  }) {
+    const readiness = this.evaluatePublishReadiness(params);
+    if (readiness.blockers.length > 0) {
+      throw new Error(
+        `当前世界仍有 ${readiness.blockers.length} 个 blocker，暂时不能发布：${readiness.blockers
+          .map((entry) => entry.message)
+          .join('；')}`,
+      );
+    }
+
+    return {
+      profileId: readiness.profileId,
+    };
+  }
+
+  async publishSessionDraft(params: {
+    userId: string;
+    authorDisplayName: string;
+    sessionId: string;
+    draftProfile: Record<string, unknown>;
+    qualityFindings?: Array<{
+      severity: 'info' | 'warning' | 'blocker';
+      message: string;
+    }>;
+  }) {
+    const readiness = this.buildPublishReadiness({
+      sessionId: params.sessionId,
+      draftProfile: params.draftProfile,
+      qualityFindings: params.qualityFindings,
+    });
+    const publishedProfile = buildRpgCreationPreviewProfileFromDraftProfile({
+      sessionId: params.sessionId,
+      draftProfile: params.draftProfile,
+      profileId: readiness.profileId,
+    });
+
+    await this.rpgWorldProfileRepository.upsertOwnProfile(
+      params.userId,
+      readiness.profileId,
+      publishedProfile as unknown as Record<string, unknown>,
+      params.authorDisplayName,
+    );
+
+    const mutation = await this.rpgWorldProfileRepository.publishOwnProfile(
+      params.userId,
+      readiness.profileId,
+      params.authorDisplayName,
+    );
+    if (!mutation) {
+      throw new Error('世界发布失败，未找到目标作品。');
+    }
+
+    return {
+      profileId: readiness.profileId,
+      publishedProfile,
+      mutation,
+    };
+  }
+}
diff --git a/server-node/src/services/customWorldAgentQualityGateService.ts b/server-node/src/services/customWorldAgentQualityGateService.ts
new file mode 100644
index 00000000..856cd919
--- /dev/null
+++ b/server-node/src/services/customWorldAgentQualityGateService.ts
@@ -0,0 +1,88 @@
+import type {
+  CustomWorldAgentSessionSnapshot,
+  CustomWorldAgentStage,
+  CustomWorldAssetCoverageSummary,
+} from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
+
+export type CustomWorldAgentQualityFinding =
+  CustomWorldAgentSessionSnapshot['qualityFindings'][number];
+
+const QUALITY_GATE_STAGES = new Set<CustomWorldAgentStage>([
+  'object_refining',
+  'visual_refining',
+  'long_tail_review',
+  'ready_to_publish',
+]);
+
+export class CustomWorldAgentQualityGateService {
+  // 当前先把最核心的阻断项和提醒项独立收口，后续 publish gate 可以直接复用同一套 finding。
+  buildQualityFindings(params: {
+    draftProfile: unknown;
+    assetCoverage?: CustomWorldAssetCoverageSummary | null;
+    stage?: CustomWorldAgentStage;
+  }): CustomWorldAgentQualityFinding[] {
+    if (params.stage && !QUALITY_GATE_STAGES.has(params.stage)) {
+      return [];
+    }
+
+    const profile = normalizeFoundationDraftProfile(params.draftProfile);
+    if (!profile) {
+      return [];
+    }
+
+    const findings: CustomWorldAgentQualityFinding[] = [];
+    const totalRoleCount = [
+      ...new Set(
+        [...profile.playableNpcs, ...profile.storyNpcs].map((entry) => entry.id),
+      ),
+    ].length;
+
+    if (totalRoleCount === 0) {
+      findings.push({
+        id: 'missing-core-roles',
+        severity: 'blocker',
+        code: 'missing_core_roles',
+        message: '当前世界底稿还没有任何角色，暂时无法进入发布前收口阶段。',
+      });
+    }
+
+    if (profile.landmarks.length === 0) {
+      findings.push({
+        id: 'missing-core-landmarks',
+        severity: 'blocker',
+        code: 'missing_core_landmarks',
+        message: '当前世界底稿还没有任何地点，至少需要补出一处关键地点。',
+      });
+    }
+
+    if (!profile.playerGoal.trim()) {
+      findings.push({
+        id: 'missing-player-goal',
+        severity: 'warning',
+        code: 'missing_player_goal',
+        message: '玩家目标还不够明确，后续进入结果页后建议优先补齐可执行目标。',
+      });
+    }
+
+    if (params.assetCoverage && !params.assetCoverage.allRoleAssetsReady) {
+      findings.push({
+        id: 'role-assets-pending',
+        severity: 'warning',
+        code: 'role_assets_pending',
+        message: '仍有角色资产未完全补齐，结果页可继续补主图与动作资源。',
+      });
+    }
+
+    if (params.assetCoverage && !params.assetCoverage.allSceneAssetsReady) {
+      findings.push({
+        id: 'scene-assets-pending',
+        severity: 'warning',
+        code: 'scene_assets_pending',
+        message: '仍有场景分幕图未补齐，后续结果页进入发布前需要继续完善。',
+      });
+    }
+
+    return findings;
+  }
+}
diff --git a/server-node/src/services/customWorldAgentRepositoryTestHelpers.ts b/server-node/src/services/customWorldAgentRepositoryTestHelpers.ts
new file mode 100644
index 00000000..a6bcb094
--- /dev/null
+++ b/server-node/src/services/customWorldAgentRepositoryTestHelpers.ts
@@ -0,0 +1,305 @@
+import type {
+  CustomWorldGalleryCard,
+  CustomWorldLibraryEntry,
+  CustomWorldProfileRecord,
+  CustomWorldSessionRecord,
+} from '../../../packages/shared/src/contracts/runtime.js';
+import { extractCustomWorldLibraryMetadata } from '../repositories/customWorldLibraryMetadata.js';
+import type { RpgAgentSessionRepositoryPort } from '../repositories/RpgAgentSessionRepository.js';
+import type { RpgWorldProfileRepositoryPort } from '../repositories/RpgWorldProfileRepository.js';
+
+type StoredProfileEntry = CustomWorldLibraryEntry<CustomWorldProfileRecord>;
+type SeedSessionRecord = CustomWorldSessionRecord & { userId: string };
+
+function cloneRepositoryValue<T>(value: T): T {
+  return JSON.parse(JSON.stringify(value)) as T;
+}
+
+function ensureProfileRecord(
+  profileId: string,
+  profile: Record<string, unknown>,
+): CustomWorldProfileRecord {
+  return {
+    ...cloneRepositoryValue(profile),
+    id: profileId,
+  } as CustomWorldProfileRecord;
+}
+
+function buildProfileEntry(params: {
+  userId: string;
+  profileId: string;
+  profile: Record<string, unknown>;
+  authorDisplayName: string;
+  visibility: 'draft' | 'published';
+  updatedAt: string;
+  publishedAt: string | null;
+}) {
+  const profileRecord = ensureProfileRecord(params.profileId, params.profile);
+  const metadata = extractCustomWorldLibraryMetadata(profileRecord);
+
+  return {
+    ownerUserId: params.userId,
+    profileId: params.profileId,
+    profile: profileRecord,
+    visibility: params.visibility,
+    publishedAt: params.visibility === 'published' ? params.publishedAt : null,
+    updatedAt: params.updatedAt,
+    authorDisplayName: params.authorDisplayName || '玩家',
+    worldName: metadata.worldName,
+    subtitle: metadata.subtitle,
+    summaryText: metadata.summaryText,
+    coverImageSrc: metadata.coverImageSrc,
+    themeMode: metadata.themeMode,
+    playableNpcCount: metadata.playableNpcCount,
+    landmarkCount: metadata.landmarkCount,
+  } satisfies StoredProfileEntry;
+}
+
+function toGalleryCard(entry: StoredProfileEntry): CustomWorldGalleryCard {
+  const { profile: _profile, ...card } = entry;
+  return cloneRepositoryValue(card);
+}
+
+function sortEntriesByUpdatedAt<T extends { updatedAt: string }>(entries: T[]) {
+  return [...entries].sort((left, right) =>
+    right.updatedAt.localeCompare(left.updatedAt),
+  );
+}
+
+/**
+ * 这组内存仓储 helper 让 phase2~5 与 works 集成测试直接依赖工作包 F 拆出来的领域端口，
+ * 避免继续把 RuntimeRepositoryPort 当成 session/profile 的测试替身。
+ */
+export function createInMemoryRpgWorldRepositoryPorts(options?: {
+  sessionRecords?: SeedSessionRecord[];
+  profileEntries?: Array<CustomWorldLibraryEntry<CustomWorldProfileRecord>>;
+}) {
+  const sessionsByUser = new Map<string, Map<string, CustomWorldSessionRecord>>();
+  const profilesByUser = new Map<string, Map<string, StoredProfileEntry>>();
+
+  const ensureSessionBucket = (userId: string) => {
+    const currentBucket = sessionsByUser.get(userId);
+    if (currentBucket) {
+      return currentBucket;
+    }
+
+    const nextBucket = new Map<string, CustomWorldSessionRecord>();
+    sessionsByUser.set(userId, nextBucket);
+    return nextBucket;
+  };
+
+  const ensureProfileBucket = (userId: string) => {
+    const currentBucket = profilesByUser.get(userId);
+    if (currentBucket) {
+      return currentBucket;
+    }
+
+    const nextBucket = new Map<string, StoredProfileEntry>();
+    profilesByUser.set(userId, nextBucket);
+    return nextBucket;
+  };
+
+  const listOwnEntries = (userId: string) =>
+    sortEntriesByUpdatedAt([...ensureProfileBucket(userId).values()]).map((entry) =>
+      cloneRepositoryValue(entry),
+    );
+
+  options?.sessionRecords?.forEach((record) => {
+    ensureSessionBucket(record.userId).set(
+      record.sessionId,
+      cloneRepositoryValue(record),
+    );
+  });
+
+  options?.profileEntries?.forEach((entry) => {
+    ensureProfileBucket(entry.ownerUserId).set(
+      entry.profileId,
+      cloneRepositoryValue(entry),
+    );
+  });
+
+  const rpgAgentSessionRepository: RpgAgentSessionRepositoryPort = {
+    async listSessions(userId: string) {
+      return sortEntriesByUpdatedAt([...ensureSessionBucket(userId).values()]).map(
+        (record) => cloneRepositoryValue(record),
+      );
+    },
+
+    async getSession(userId: string, sessionId: string) {
+      const record = ensureSessionBucket(userId).get(sessionId) ?? null;
+      return record ? cloneRepositoryValue(record) : null;
+    },
+
+    async upsertSession(
+      userId: string,
+      sessionId: string,
+      session: CustomWorldSessionRecord,
+    ) {
+      const nextSession = cloneRepositoryValue({
+        ...session,
+        userId,
+        sessionId,
+      });
+      ensureSessionBucket(userId).set(sessionId, nextSession);
+      return cloneRepositoryValue(nextSession);
+    },
+  };
+
+  const rpgWorldProfileRepository: RpgWorldProfileRepositoryPort = {
+    async listOwnProfiles(userId: string) {
+      return listOwnEntries(userId);
+    },
+
+    async upsertOwnProfile(
+      userId: string,
+      profileId: string,
+      profile: Record<string, unknown>,
+      authorDisplayName: string,
+    ) {
+      const bucket = ensureProfileBucket(userId);
+      const currentEntry = bucket.get(profileId);
+      const now = new Date().toISOString();
+      const nextEntry = buildProfileEntry({
+        userId,
+        profileId,
+        profile,
+        authorDisplayName:
+          authorDisplayName || currentEntry?.authorDisplayName || '玩家',
+        visibility: currentEntry?.visibility ?? 'draft',
+        updatedAt: now,
+        publishedAt:
+          currentEntry?.visibility === 'published'
+            ? currentEntry.publishedAt || now
+            : null,
+      });
+
+      bucket.set(profileId, nextEntry);
+
+      return {
+        entry: cloneRepositoryValue(nextEntry),
+        entries: await listOwnEntries(userId),
+      };
+    },
+
+    async syncProfileFromSnapshot(
+      userId: string,
+      profileId: string,
+      profile: Record<string, unknown>,
+      syncedAt: string,
+    ) {
+      const bucket = ensureProfileBucket(userId);
+      const currentEntry = bucket.get(profileId);
+      bucket.set(
+        profileId,
+        buildProfileEntry({
+          userId,
+          profileId,
+          profile,
+          authorDisplayName: currentEntry?.authorDisplayName || '玩家',
+          visibility: currentEntry?.visibility ?? 'draft',
+          updatedAt: syncedAt,
+          publishedAt:
+            currentEntry?.visibility === 'published'
+              ? currentEntry.publishedAt || syncedAt
+              : null,
+        }),
+      );
+    },
+
+    async softDeleteOwnProfile(userId: string, profileId: string) {
+      ensureProfileBucket(userId).delete(profileId);
+      return listOwnEntries(userId);
+    },
+
+    async publishOwnProfile(
+      userId: string,
+      profileId: string,
+      authorDisplayName: string,
+    ) {
+      const bucket = ensureProfileBucket(userId);
+      const currentEntry = bucket.get(profileId);
+      if (!currentEntry) {
+        return null;
+      }
+
+      const now = new Date().toISOString();
+      const nextEntry = buildProfileEntry({
+        userId,
+        profileId,
+        profile: currentEntry.profile,
+        authorDisplayName:
+          authorDisplayName || currentEntry.authorDisplayName || '玩家',
+        visibility: 'published',
+        updatedAt: now,
+        publishedAt: now,
+      });
+      bucket.set(profileId, nextEntry);
+
+      return {
+        entry: cloneRepositoryValue(nextEntry),
+        entries: await listOwnEntries(userId),
+      };
+    },
+
+    async unpublishOwnProfile(
+      userId: string,
+      profileId: string,
+      authorDisplayName: string,
+    ) {
+      const bucket = ensureProfileBucket(userId);
+      const currentEntry = bucket.get(profileId);
+      if (!currentEntry) {
+        return null;
+      }
+
+      const now = new Date().toISOString();
+      const nextEntry = buildProfileEntry({
+        userId,
+        profileId,
+        profile: currentEntry.profile,
+        authorDisplayName:
+          authorDisplayName || currentEntry.authorDisplayName || '玩家',
+        visibility: 'draft',
+        updatedAt: now,
+        publishedAt: null,
+      });
+      bucket.set(profileId, nextEntry);
+
+      return {
+        entry: cloneRepositoryValue(nextEntry),
+        entries: await listOwnEntries(userId),
+      };
+    },
+
+    async listPublishedGallery() {
+      return [...profilesByUser.values()]
+        .flatMap((bucket) => [...bucket.values()])
+        .filter((entry) => entry.visibility === 'published')
+        .sort((left, right) => {
+          const publishedAtDiff = (right.publishedAt || '').localeCompare(
+            left.publishedAt || '',
+          );
+          if (publishedAtDiff !== 0) {
+            return publishedAtDiff;
+          }
+
+          return right.updatedAt.localeCompare(left.updatedAt);
+        })
+        .map((entry) => toGalleryCard(entry));
+    },
+
+    async getPublishedGalleryDetail(ownerUserId: string, profileId: string) {
+      const entry = ensureProfileBucket(ownerUserId).get(profileId);
+      if (!entry || entry.visibility !== 'published') {
+        return null;
+      }
+
+      return cloneRepositoryValue(entry);
+    },
+  };
+
+  return {
+    rpgAgentSessionRepository,
+    rpgWorldProfileRepository,
+  };
+}
diff --git a/server-node/src/services/customWorldAgentResultSyncService.test.ts b/server-node/src/services/customWorldAgentResultSyncService.test.ts
new file mode 100644
index 00000000..af20b40a
--- /dev/null
+++ b/server-node/src/services/customWorldAgentResultSyncService.test.ts
@@ -0,0 +1,118 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+  createRpgAgentFoundationDraftProfileFixture,
+  createRpgCreationPublishedProfileFixture,
+} from '../../../packages/shared/src/contracts/rpgCreationFixtures.js';
+import { CustomWorldAgentResultSyncService } from './customWorldAgentResultSyncService.js';
+
+test('result sync service only writes summary fields and matching asset confirmations back into draft profile', () => {
+  const service = new CustomWorldAgentResultSyncService();
+  const currentDraftProfile = createRpgAgentFoundationDraftProfileFixture();
+  const resultProfile = createRpgCreationPublishedProfileFixture();
+  const nextDraftProfile = service.syncResultProfileIntoDraftProfile({
+    currentDraftProfile: currentDraftProfile as unknown as Record<string, unknown>,
+    resultProfile,
+  });
+
+  assert.equal(nextDraftProfile.name, resultProfile.name);
+  assert.equal(nextDraftProfile.summary, resultProfile.summary);
+  assert.equal(
+    (
+      nextDraftProfile.playableNpcs as Array<{
+        generatedAnimationSetId?: string | null;
+      }>
+    )[0]?.generatedAnimationSetId,
+    'animation-set-playable-1',
+  );
+  assert.equal(
+    (
+      nextDraftProfile.landmarks as Array<{
+        imageSrc?: string | null;
+      }>
+    )[0]?.imageSrc,
+    '/generated-custom-world-scenes/landmark-1/latest-scene.png',
+  );
+  assert.equal(
+    (
+      nextDraftProfile.sceneChapters as Array<{
+        acts?: Array<{ backgroundAssetId?: string | null }>;
+      }>
+    )[0]?.acts?.[0]?.backgroundAssetId,
+    'scene-asset-runtime',
+  );
+});
+
+test('result sync service keeps existing foundation structure when result profile carries unmatched runtime-only entities', () => {
+  const service = new CustomWorldAgentResultSyncService();
+  const currentDraftProfile = createRpgAgentFoundationDraftProfileFixture();
+  const nextDraftProfile = service.syncResultProfileIntoDraftProfile({
+    currentDraftProfile: currentDraftProfile as unknown as Record<string, unknown>,
+    resultProfile: {
+      ...createRpgCreationPublishedProfileFixture(),
+      playableNpcs: [
+        {
+          id: 'runtime-only-role',
+          name: '运行时临时角色',
+          title: '结果页临时角色',
+          role: '测试角色',
+          description: '不应覆盖 foundation draft。',
+          backstory: '测试',
+          personality: '冷静',
+          motivation: '测试',
+          combatStyle: '观察',
+          initialAffinity: 0,
+          relationshipHooks: [],
+          tags: [],
+          skills: [],
+          initialItems: [],
+          backstoryReveal: {
+            publicSummary: '测试',
+            privateChatUnlockAffinity: 0,
+            chapters: [],
+          },
+        },
+      ],
+      storyNpcs: [],
+      landmarks: [
+        {
+          id: 'runtime-only-landmark',
+          name: '运行时临时地点',
+          description: '不应覆盖 foundation draft。',
+          dangerLevel: 'low',
+          sceneNpcIds: [],
+          connections: [],
+        },
+      ],
+      sceneChapterBlueprints: [],
+    },
+  });
+
+  assert.equal(
+    (
+      nextDraftProfile.playableNpcs as Array<{ id?: string; name?: string }>
+    )[0]?.id,
+    'playable-1',
+  );
+  assert.equal(
+    (
+      nextDraftProfile.playableNpcs as Array<{ id?: string; name?: string }>
+    )[0]?.name,
+    '沈砺',
+  );
+  assert.equal(
+    (
+      nextDraftProfile.landmarks as Array<{ id?: string; name?: string }>
+    )[0]?.id,
+    'landmark-1',
+  );
+  assert.equal(
+    (
+      nextDraftProfile.legacyResultProfile as {
+        playableNpcs?: Array<{ id?: string }>;
+      }
+    ).playableNpcs?.[0]?.id,
+    'runtime-only-role',
+  );
+});
diff --git a/server-node/src/services/customWorldAgentResultSyncService.ts b/server-node/src/services/customWorldAgentResultSyncService.ts
new file mode 100644
index 00000000..8fb05b7e
--- /dev/null
+++ b/server-node/src/services/customWorldAgentResultSyncService.ts
@@ -0,0 +1,150 @@
+import type { CustomWorldProfile } from '../modules/custom-world/runtimeTypes.js';
+
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function toRecordArray(value: unknown) {
+  return Array.isArray(value)
+    ? value.filter((item): item is Record<string, unknown> => isRecord(item))
+    : [];
+}
+
+function cloneJsonRecord<T>(value: T): T {
+  return JSON.parse(JSON.stringify(value)) as T;
+}
+
+function syncRoleAssetsFromResultProfile(params: {
+  currentRoles: unknown;
+  resultRoles: unknown;
+}) {
+  const resultRoleById = new Map(
+    toRecordArray(params.resultRoles).map((role) => [toText(role.id), role]),
+  );
+
+  return toRecordArray(params.currentRoles).map((currentRole) => {
+    const resultRole = resultRoleById.get(toText(currentRole.id));
+    if (!resultRole) {
+      return currentRole;
+    }
+
+    return {
+      ...currentRole,
+      imageSrc: toText(resultRole.imageSrc) || null,
+      generatedVisualAssetId: toText(resultRole.generatedVisualAssetId) || null,
+      generatedAnimationSetId:
+        toText(resultRole.generatedAnimationSetId) || null,
+      animationMap: isRecord(resultRole.animationMap)
+        ? cloneJsonRecord(resultRole.animationMap)
+        : null,
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function syncLandmarkAssetsFromResultProfile(params: {
+  currentLandmarks: unknown;
+  resultLandmarks: unknown;
+}) {
+  const resultLandmarkById = new Map(
+    toRecordArray(params.resultLandmarks).map((landmark) => [
+      toText(landmark.id),
+      landmark,
+    ]),
+  );
+
+  return toRecordArray(params.currentLandmarks).map((currentLandmark) => {
+    const resultLandmark = resultLandmarkById.get(toText(currentLandmark.id));
+    if (!resultLandmark) {
+      return currentLandmark;
+    }
+
+    return {
+      ...currentLandmark,
+      imageSrc: toText(resultLandmark.imageSrc) || null,
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function syncSceneChapterAssetsFromResultProfile(params: {
+  currentSceneChapters: unknown;
+  resultSceneChapters: unknown;
+}) {
+  const resultSceneChapterBySceneId = new Map(
+    toRecordArray(params.resultSceneChapters).map((chapter) => [
+      toText(chapter.sceneId),
+      chapter,
+    ]),
+  );
+
+  return toRecordArray(params.currentSceneChapters).map((currentChapter) => {
+    const resultChapter = resultSceneChapterBySceneId.get(
+      toText(currentChapter.sceneId),
+    );
+    if (!resultChapter) {
+      return currentChapter;
+    }
+
+    const resultActById = new Map(
+      toRecordArray(resultChapter.acts).map((act) => [toText(act.id), act]),
+    );
+
+    return {
+      ...currentChapter,
+      acts: toRecordArray(currentChapter.acts).map((currentAct) => {
+        const resultAct = resultActById.get(toText(currentAct.id));
+        if (!resultAct) {
+          return currentAct;
+        }
+
+        return {
+          ...currentAct,
+          backgroundImageSrc: toText(resultAct.backgroundImageSrc) || null,
+          backgroundAssetId: toText(resultAct.backgroundAssetId) || null,
+        } satisfies Record<string, unknown>;
+      }),
+    } satisfies Record<string, unknown>;
+  });
+}
+
+export class CustomWorldAgentResultSyncService {
+  // 阶段一只允许结果页把摘要与资产确认结果回写进 foundation draft，避免 runtime 结构反向污染草稿真相源。
+  syncResultProfileIntoDraftProfile(params: {
+    currentDraftProfile: Record<string, unknown> | null | undefined;
+    resultProfile: CustomWorldProfile;
+  }) {
+    const currentDraftProfile = params.currentDraftProfile ?? {};
+    const resultProfile = params.resultProfile;
+
+    return {
+      ...currentDraftProfile,
+      name: resultProfile.name,
+      subtitle: resultProfile.subtitle,
+      summary: resultProfile.summary,
+      tone: resultProfile.tone,
+      playerGoal: resultProfile.playerGoal,
+      majorFactions: resultProfile.majorFactions,
+      coreConflicts: resultProfile.coreConflicts,
+      playableNpcs: syncRoleAssetsFromResultProfile({
+        currentRoles: currentDraftProfile.playableNpcs,
+        resultRoles: resultProfile.playableNpcs,
+      }),
+      storyNpcs: syncRoleAssetsFromResultProfile({
+        currentRoles: currentDraftProfile.storyNpcs,
+        resultRoles: resultProfile.storyNpcs,
+      }),
+      landmarks: syncLandmarkAssetsFromResultProfile({
+        currentLandmarks: currentDraftProfile.landmarks,
+        resultLandmarks: resultProfile.landmarks,
+      }),
+      sceneChapters: syncSceneChapterAssetsFromResultProfile({
+        currentSceneChapters: currentDraftProfile.sceneChapters,
+        resultSceneChapters: resultProfile.sceneChapterBlueprints,
+      }),
+      legacyResultProfile: resultProfile as unknown as Record<string, unknown>,
+    } satisfies Record<string, unknown>;
+  }
+}
diff --git a/server-node/src/services/customWorldAgentRoleAssetStateService.ts b/server-node/src/services/customWorldAgentRoleAssetStateService.ts
index 04291936..b04e46b6 100644
--- a/server-node/src/services/customWorldAgentRoleAssetStateService.ts
+++ b/server-node/src/services/customWorldAgentRoleAssetStateService.ts
@@ -40,6 +40,14 @@ type DraftSceneChapterRecord = {
   acts: DraftSceneActRecord[];
 };
 
+type DraftStandaloneSceneRecord = {
+  sceneId: string;
+  sceneName: string;
+  imageSrc: string | null;
+  assetId: string | null;
+  sceneKind: 'camp' | 'landmark';
+};
+
 type MergeRoleAssetIntoDraftProfilePayload = {
   roleId: string;
   portraitPath: string;
@@ -244,6 +252,77 @@ function collectDraftSceneChapters(profileInput: unknown) {
     .filter((item): item is DraftSceneChapterRecord => Boolean(item));
 }
 
+function buildStandaloneSceneAssetSummary(
+  scene: DraftStandaloneSceneRecord,
+): CustomWorldSceneAssetSummary {
+  const ready = Boolean(scene.imageSrc || scene.assetId);
+
+  return {
+    sceneId: scene.sceneId,
+    sceneName: scene.sceneName,
+    actId: null,
+    actTitle: scene.sceneKind === 'camp' ? '营地正式背景图' : '场景正式背景图',
+    imageSrc: scene.imageSrc,
+    assetId: scene.assetId,
+    status: ready ? 'ready' : 'missing',
+    nextPointCost: ready ? 0 : 12,
+  };
+}
+
+function collectStandaloneSceneRecords(
+  profileInput: unknown,
+  coveredSceneIds: Set<string>,
+) {
+  const profile = toRecord(profileInput);
+  if (!profile) {
+    return [] as DraftStandaloneSceneRecord[];
+  }
+
+  const standaloneScenes: DraftStandaloneSceneRecord[] = [];
+  const camp = toRecord(profile.camp);
+  if (camp) {
+    const campId = toText(camp.id);
+    const campImageSrc = toText(camp.imageSrc) || null;
+    const campAssetId = toText(camp.generatedSceneAssetId) || null;
+    if (
+      campId &&
+      !coveredSceneIds.has(campId) &&
+      Boolean(campImageSrc || campAssetId)
+    ) {
+      standaloneScenes.push({
+        sceneId: campId,
+        sceneName: toText(camp.name) || '开局营地',
+        imageSrc: campImageSrc,
+        assetId: campAssetId,
+        sceneKind: 'camp',
+      });
+    }
+  }
+
+  toRecordArray(profile.landmarks).forEach((landmark, index) => {
+    const landmarkId = toText(landmark.id);
+    const landmarkImageSrc = toText(landmark.imageSrc) || null;
+    const landmarkAssetId = toText(landmark.generatedSceneAssetId) || null;
+    if (
+      !landmarkId ||
+      coveredSceneIds.has(landmarkId) ||
+      !Boolean(landmarkImageSrc || landmarkAssetId)
+    ) {
+      return;
+    }
+
+    standaloneScenes.push({
+      sceneId: landmarkId,
+      sceneName: toText(landmark.name) || `关键地点 ${index + 1}`,
+      imageSrc: landmarkImageSrc,
+      assetId: landmarkAssetId,
+      sceneKind: 'landmark',
+    });
+  });
+
+  return standaloneScenes;
+}
+
 export function resolveRoleAssetStatusLabel(
   status: CustomWorldRoleAssetStatus,
 ) {
@@ -317,7 +396,7 @@ export function rebuildRoleAssetCoverage(
   const roleAssets = collectDraftRoles(draftProfile).map((entry) =>
     buildRoleAssetSummary(entry),
   );
-  const sceneAssets: CustomWorldSceneAssetSummary[] = collectDraftSceneChapters(
+  const chapterSceneAssets: CustomWorldSceneAssetSummary[] = collectDraftSceneChapters(
     draftProfile,
   ).flatMap((sceneChapter) =>
     sceneChapter.acts.map((act) => {
@@ -337,6 +416,14 @@ export function rebuildRoleAssetCoverage(
       } satisfies CustomWorldSceneAssetSummary;
     }),
   );
+  const coveredSceneIds = new Set(
+    chapterSceneAssets.map((entry) => entry.sceneId).filter(Boolean),
+  );
+  const standaloneSceneAssets = collectStandaloneSceneRecords(
+    draftProfile,
+    coveredSceneIds,
+  ).map((scene) => buildStandaloneSceneAssetSummary(scene));
+  const sceneAssets = [...chapterSceneAssets, ...standaloneSceneAssets];
 
   return {
     roleAssets,
diff --git a/server-node/src/services/customWorldAgentSessionStore.ts b/server-node/src/services/customWorldAgentSessionStore.ts
index 8ec5f599..73d5025e 100644
--- a/server-node/src/services/customWorldAgentSessionStore.ts
+++ b/server-node/src/services/customWorldAgentSessionStore.ts
@@ -1,510 +1,27 @@
 import crypto from 'node:crypto';
 
 import type {
-  CreatorIntentReadiness,
   CustomWorldAgentMessage,
   CustomWorldAgentOperationRecord,
   CustomWorldAgentSessionSnapshot,
-  CustomWorldAgentStage,
-  CustomWorldAssetCoverageSummary,
-  CustomWorldDraftCardSummary,
-  CustomWorldPendingClarification,
-  CustomWorldSuggestedAction,
-  EightAnchorContent,
 } from '../../../packages/shared/src/contracts/customWorldAgent.js';
 import type { CustomWorldSessionRecord as LegacyCustomWorldSessionRecord } from '../../../packages/shared/src/contracts/runtime.js';
-import type { RuntimeRepositoryPort } from '../repositories/runtimeRepository.js';
 import {
-  buildPendingClarifications,
-  evaluateCreatorIntentReadiness,
-  resolveCreatorIntentStage,
-} from './customWorldAgentClarificationService.js';
+  applyCustomWorldAgentSessionCompatibility,
+  isCustomWorldAgentSessionRecord,
+} from './rpg-agent-session-store/rpgAgentSessionCompatibility.js';
+import { createCustomWorldAgentSessionRecord } from './rpg-agent-session-store/rpgAgentSessionFactory.js';
 import {
-  normalizeCreatorIntentRecord,
-} from './customWorldAgentIntentExtractionService.js';
-import { rebuildRoleAssetCoverage } from './customWorldAgentRoleAssetStateService.js';
+  cloneRpgAgentSessionValue,
+  type CreateCustomWorldAgentSessionInput,
+  type CustomWorldAgentSessionRecord,
+  CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX,
+} from './rpg-agent-session-store/rpgAgentSessionRecord.js';
+import type { RpgAgentSessionRepositoryPort } from '../repositories/RpgAgentSessionRepository.js';
 import {
-  buildAnchorPackFromEightAnchorContent,
-  buildCreatorIntentFromEightAnchorContent,
-  buildDraftSummaryFromEightAnchorContent,
-  buildDraftTitleFromEightAnchorContent,
-  buildEightAnchorContentFromCreatorIntent,
-  createEmptyEightAnchorContent,
-  estimateProgressPercentFromAnchorContent,
-  normalizeEightAnchorContent,
-} from './eightAnchorCompatibilityService.js';
-
-export const CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX =
-  'custom-world-agent-session-';
-
-export type CustomWorldAgentSessionRecord = {
-  sessionId: string;
-  userId: string;
-  seedText: string;
-  currentTurn: number;
-  anchorContent: EightAnchorContent;
-  progressPercent: number;
-  lastAssistantReply: string | null;
-  stage: CustomWorldAgentStage;
-  focusCardId: string | null;
-  creatorIntent: Record<string, unknown> | null;
-  creatorIntentReadiness: CreatorIntentReadiness;
-  anchorPack: Record<string, unknown> | null;
-  lockState: Record<string, unknown> | null;
-  draftProfile: Record<string, unknown> | null;
-  messages: CustomWorldAgentMessage[];
-  draftCards: CustomWorldDraftCardSummary[];
-  pendingClarifications: CustomWorldPendingClarification[];
-  suggestedActions: CustomWorldSuggestedAction[];
-  recommendedReplies: string[];
-  qualityFindings: Array<{
-    id: string;
-    severity: 'info' | 'warning' | 'blocker';
-    code: string;
-    targetId?: string | null;
-    message: string;
-  }>;
-  assetCoverage: CustomWorldAssetCoverageSummary;
-  operations: CustomWorldAgentOperationRecord[];
-  checkpoints: Array<{
-    checkpointId: string;
-    createdAt: string;
-    label: string;
-  }>;
-  createdAt: string;
-  updatedAt: string;
-};
-
-type CreateSessionInput = {
-  seedText?: string;
-  welcomeMessage: string;
-  currentTurn?: number;
-  anchorContent?: EightAnchorContent;
-  progressPercent?: number;
-  lastAssistantReply?: string | null;
-  pendingClarifications: CustomWorldAgentSessionRecord['pendingClarifications'];
-  creatorIntent?: CustomWorldAgentSessionRecord['creatorIntent'];
-  creatorIntentReadiness?: CreatorIntentReadiness;
-  anchorPack?: CustomWorldAgentSessionRecord['anchorPack'];
-  draftProfile?: CustomWorldAgentSessionRecord['draftProfile'];
-  stage?: CustomWorldAgentStage;
-  suggestedActions: CustomWorldSuggestedAction[];
-  recommendedReplies?: string[];
-};
-
-function cloneRecord<T>(value: T): T {
-  return JSON.parse(JSON.stringify(value)) as T;
-}
-
-function toRecord(value: unknown) {
-  return value && typeof value === 'object' && !Array.isArray(value)
-    ? (value as Record<string, unknown>)
-    : null;
-}
-
-function toText(value: unknown) {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-function isStage(value: unknown): value is CustomWorldAgentStage {
-  return (
-    value === 'collecting_intent' ||
-    value === 'clarifying' ||
-    value === 'foundation_review' ||
-    value === 'object_refining' ||
-    value === 'visual_refining' ||
-    value === 'long_tail_review' ||
-    value === 'ready_to_publish' ||
-    value === 'published' ||
-    value === 'error'
-  );
-}
-
-function isAgentSessionRecord(
-  value: unknown,
-): value is CustomWorldAgentSessionRecord {
-  const record = toRecord(value);
-  if (!record) {
-    return false;
-  }
-
-  return (
-    typeof record.sessionId === 'string' &&
-    record.sessionId.startsWith(CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX) &&
-    typeof record.userId === 'string' &&
-    isStage(record.stage) &&
-    Array.isArray(record.messages) &&
-    Array.isArray(record.operations) &&
-    typeof record.createdAt === 'string' &&
-    typeof record.updatedAt === 'string'
-  );
-}
-
-function isCreatorIntentReadiness(
-  value: unknown,
-): value is CreatorIntentReadiness {
-  const record = toRecord(value);
-  if (!record) {
-    return false;
-  }
-
-  return (
-    typeof record.isReady === 'boolean' &&
-    Array.isArray(record.completedKeys) &&
-    Array.isArray(record.missingKeys)
-  );
-}
-
-function mapLegacyClarificationTargetKey(id: string) {
-  if (id === 'world_hook') return 'world_hook';
-  if (id === 'player_premise') return 'player_premise';
-  if (id === 'theme_and_tone' || id === 'tone_boundary') {
-    return 'theme_and_tone';
-  }
-  if (id === 'core_conflict') return 'core_conflict';
-  if (id === 'relationship_seed' || id === 'relationship_hook') {
-    return 'relationship_seed';
-  }
-  if (id === 'iconic_element' || id === 'iconic_elements') {
-    return 'iconic_element';
-  }
-
-  return null;
-}
-
-function hasUserInput(record: CustomWorldAgentSessionRecord) {
-  return (
-    Boolean(record.seedText.trim()) ||
-    record.messages.some(
-      (message) => message.role === 'user' && message.text.trim(),
-    )
-  );
-}
-
-function buildCompatibleCreatorIntent(record: CustomWorldAgentSessionRecord) {
-  const compatibleAnchorIntent = buildCreatorIntentFromEightAnchorContent(
-    normalizeEightAnchorContent(
-      (record as Record<string, unknown>).anchorContent ?? null,
-    ),
-  );
-
-  if (
-    compatibleAnchorIntent &&
-    (compatibleAnchorIntent.worldHook ||
-      compatibleAnchorIntent.rawSettingText ||
-      compatibleAnchorIntent.playerPremise ||
-      compatibleAnchorIntent.openingSituation ||
-      compatibleAnchorIntent.coreConflicts.length > 0 ||
-      compatibleAnchorIntent.keyCharacters.length > 0 ||
-      compatibleAnchorIntent.iconicElements.length > 0)
-  ) {
-    return compatibleAnchorIntent;
-  }
-
-  return normalizeCreatorIntentRecord(record.creatorIntent);
-}
-
-function buildCompatibleCurrentTurn(record: CustomWorldAgentSessionRecord) {
-  if (typeof (record as Record<string, unknown>).currentTurn === 'number') {
-    return Math.max(
-      0,
-      Math.round((record as Record<string, unknown>).currentTurn as number),
-    );
-  }
-
-  return record.messages.filter((message) => message.role === 'user').length;
-}
-
-function buildCompatibleAnchorContent(record: CustomWorldAgentSessionRecord) {
-  const normalized = normalizeEightAnchorContent(
-    (record as Record<string, unknown>).anchorContent ?? null,
-  );
-
-  if (
-    normalized.worldPromise ||
-    normalized.playerFantasy ||
-    normalized.themeBoundary ||
-    normalized.playerEntryPoint ||
-    normalized.coreConflict ||
-    normalized.keyRelationships.length > 0 ||
-    normalized.hiddenLines ||
-    normalized.iconicElements
-  ) {
-    return normalized;
-  }
-
-  return buildEightAnchorContentFromCreatorIntent(
-    buildCompatibleCreatorIntent(record),
-  );
-}
-
-function buildCompatibleProgressPercent(record: CustomWorldAgentSessionRecord) {
-  const rawProgress = (record as Record<string, unknown>).progressPercent;
-  if (typeof rawProgress === 'number' && Number.isFinite(rawProgress)) {
-    return Math.max(0, Math.min(100, Math.round(rawProgress)));
-  }
-
-  if (
-    record.stage === 'foundation_review' ||
-    record.stage === 'object_refining' ||
-    record.stage === 'visual_refining' ||
-    record.stage === 'long_tail_review' ||
-    record.stage === 'ready_to_publish' ||
-    record.stage === 'published'
-  ) {
-    return 100;
-  }
-
-  return estimateProgressPercentFromAnchorContent(
-    buildCompatibleAnchorContent(record),
-  );
-}
-
-function buildCompatibleLastAssistantReply(record: CustomWorldAgentSessionRecord) {
-  const existingReply = (record as Record<string, unknown>).lastAssistantReply;
-  if (typeof existingReply === 'string') {
-    return existingReply;
-  }
-
-  const lastAssistantMessage = [...record.messages]
-    .reverse()
-    .find((message) => message.role === 'assistant' && message.text.trim());
-
-  return lastAssistantMessage?.text ?? null;
-}
-
-function buildCompatibleReadiness(record: CustomWorldAgentSessionRecord) {
-  if (
-    isCreatorIntentReadiness(
-      (record as Record<string, unknown>).creatorIntentReadiness,
-    )
-  ) {
-    return record.creatorIntentReadiness;
-  }
-
-  return evaluateCreatorIntentReadiness(
-    normalizeCreatorIntentRecord(record.creatorIntent),
-  );
-}
-
-function buildCompatiblePendingClarifications(
-  record: CustomWorldAgentSessionRecord,
-) {
-  const normalizedIntent = normalizeCreatorIntentRecord(record.creatorIntent);
-  const readiness = buildCompatibleReadiness(record);
-  const legacyClarifications = Array.isArray(record.pendingClarifications)
-    ? record.pendingClarifications
-    : [];
-
-  const nextClarifications = legacyClarifications
-    .map((entry, index) => {
-      const targetKey = mapLegacyClarificationTargetKey(entry.id);
-      if (!targetKey) {
-        return null;
-      }
-
-      return {
-        id: entry.id || targetKey,
-        label: entry.label || '待补充问题',
-        question: entry.question || '',
-        targetKey,
-        priority:
-          typeof entry.priority === 'number' ? entry.priority : index + 1,
-        answer: entry.answer,
-      } satisfies CustomWorldPendingClarification;
-    })
-    .filter((entry): entry is CustomWorldPendingClarification =>
-      Boolean(entry?.question),
-    )
-    .slice(0, 3);
-
-  if (nextClarifications.length > 0) {
-    return nextClarifications;
-  }
-
-  return buildPendingClarifications(normalizedIntent, readiness);
-}
-
-function buildCompatibleDraftProfile(
-  record: CustomWorldAgentSessionRecord,
-) {
-  const anchorContent = buildCompatibleAnchorContent(record);
-  const existingDraftProfile = toRecord(record.draftProfile);
-  const hasFoundationContent = Boolean(
-    existingDraftProfile &&
-      (typeof existingDraftProfile.name === 'string' ||
-        Array.isArray(existingDraftProfile.playableNpcs) ||
-        Array.isArray(existingDraftProfile.landmarks) ||
-        Array.isArray(existingDraftProfile.factions) ||
-        Array.isArray(existingDraftProfile.threads) ||
-        Array.isArray(existingDraftProfile.chapters)),
-  );
-
-  if (hasFoundationContent) {
-    return {
-      ...existingDraftProfile,
-      name:
-        toText(existingDraftProfile?.name) ||
-        toText(existingDraftProfile?.title) ||
-        buildDraftTitleFromEightAnchorContent(anchorContent),
-      summary:
-        toText(existingDraftProfile?.summary) ||
-        buildDraftSummaryFromEightAnchorContent(anchorContent),
-    };
-  }
-
-  return {
-    ...(existingDraftProfile ?? {}),
-    title:
-      toText(existingDraftProfile?.title) ||
-      buildDraftTitleFromEightAnchorContent(anchorContent),
-    summary:
-      toText(existingDraftProfile?.summary) ||
-      buildDraftSummaryFromEightAnchorContent(anchorContent),
-  };
-}
-
-function buildCompatibleSuggestedActions(params: {
-  record: CustomWorldAgentSessionRecord;
-  stage: CustomWorldAgentStage;
-  readiness: CreatorIntentReadiness;
-}) {
-  if (params.record.suggestedActions.length > 0) {
-    // 旧快照里可能带有“精修对象”的 Agent 建议动作；当前 Agent 对话框只服务八锚点收集。
-    const compatibleActions = params.record.suggestedActions.filter(
-      (action) => action.type !== 'refine_focus_target',
-    );
-    if (compatibleActions.length > 0) {
-      return compatibleActions;
-    }
-  }
-
-  const actions: CustomWorldSuggestedAction[] = [
-    {
-      id: 'request_summary',
-      type: 'request_summary',
-      label:
-        params.stage === 'object_refining' || params.stage === 'visual_refining'
-          ? '总结当前世界底稿'
-          : '总结当前设定',
-    },
-  ];
-  if (params.stage === 'foundation_review' && params.readiness.isReady) {
-    actions.push({
-      id: 'draft_foundation',
-      type: 'draft_foundation',
-      label: '整理一版世界底稿',
-    });
-    return actions;
-  }
-
-  return actions;
-}
-
-function normalizeRecommendedReplies(value: unknown) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-
-  return value
-    .map((item) => toText(item))
-    .filter(Boolean)
-    .slice(0, 3);
-}
-
-function buildCompatibleAssetCoverage(
-  record: CustomWorldAgentSessionRecord,
-  draftProfile: Record<string, unknown>,
-) {
-  const derivedCoverage = rebuildRoleAssetCoverage(draftProfile);
-  const existingCoverage = toRecord(record.assetCoverage);
-  const sceneAssets =
-    derivedCoverage.sceneAssets.length > 0
-      ? derivedCoverage.sceneAssets
-      : Array.isArray(existingCoverage?.sceneAssets)
-        ? existingCoverage.sceneAssets
-        : [];
-  const allSceneAssetsReady =
-    derivedCoverage.sceneAssets.length > 0
-      ? derivedCoverage.allSceneAssetsReady
-      : typeof existingCoverage?.allSceneAssetsReady === 'boolean'
-        ? existingCoverage.allSceneAssetsReady
-        : false;
-
-  return {
-    ...derivedCoverage,
-    sceneAssets,
-    allSceneAssetsReady,
-  } satisfies CustomWorldAssetCoverageSummary;
-}
-
-function applyCompatibility(record: CustomWorldAgentSessionRecord) {
-  const creatorIntent = buildCompatibleCreatorIntent(record);
-  const currentTurn = buildCompatibleCurrentTurn(record);
-  const anchorContent = buildCompatibleAnchorContent(record);
-  const progressPercent = buildCompatibleProgressPercent(record);
-  const lastAssistantReply = buildCompatibleLastAssistantReply(record);
-  const creatorIntentReadiness =
-    progressPercent >= 100
-      ? {
-          isReady: true,
-          completedKeys: [
-            'world_hook',
-            'player_premise',
-            'theme_and_tone',
-            'core_conflict',
-            'relationship_seed',
-            'iconic_element',
-          ],
-          missingKeys: [],
-        }
-      : evaluateCreatorIntentReadiness(creatorIntent);
-  const stage =
-    record.stage === 'object_refining' ||
-    record.stage === 'visual_refining' ||
-    record.stage === 'long_tail_review' ||
-    record.stage === 'ready_to_publish' ||
-    record.stage === 'published'
-      ? record.stage
-      : progressPercent >= 100
-        ? ('foundation_review' as const)
-        : resolveCreatorIntentStage({
-            hasUserInput: hasUserInput(record),
-            readiness: creatorIntentReadiness,
-          });
-  const pendingClarifications = buildCompatiblePendingClarifications({
-    ...record,
-    creatorIntent,
-    creatorIntentReadiness,
-  });
-  const draftProfile = buildCompatibleDraftProfile(record);
-
-  return {
-    ...record,
-    currentTurn,
-    anchorContent,
-    progressPercent,
-    lastAssistantReply,
-    stage,
-    creatorIntent,
-    creatorIntentReadiness,
-    anchorPack:
-      record.anchorPack && Object.keys(record.anchorPack).length > 0
-        ? record.anchorPack
-        : buildAnchorPackFromEightAnchorContent(anchorContent, progressPercent),
-    draftProfile,
-    pendingClarifications,
-    suggestedActions: buildCompatibleSuggestedActions({
-      record,
-      stage,
-      readiness: creatorIntentReadiness,
-    }),
-    assetCoverage: buildCompatibleAssetCoverage(record, draftProfile),
-    recommendedReplies: normalizeRecommendedReplies(
-      (record as Record<string, unknown>).recommendedReplies,
-    ),
-  } satisfies CustomWorldAgentSessionRecord;
-}
+  RpgAgentSessionRepositoryAdapter,
+} from './rpg-agent-session-store/rpgAgentSessionRepositoryAdapter.js';
+import { normalizeEightAnchorContent } from './eightAnchorCompatibilityService.js';
 
 function toSnapshot(
   record: CustomWorldAgentSessionRecord,
@@ -512,132 +29,118 @@ function toSnapshot(
   return {
     sessionId: record.sessionId,
     currentTurn: record.currentTurn,
-    anchorContent: cloneRecord(record.anchorContent),
+    anchorContent: cloneRpgAgentSessionValue(record.anchorContent),
     progressPercent: record.progressPercent,
     lastAssistantReply: record.lastAssistantReply,
     stage: record.stage,
     focusCardId: record.focusCardId,
-    creatorIntent: cloneRecord(record.creatorIntent),
-    creatorIntentReadiness: cloneRecord(record.creatorIntentReadiness),
-    anchorPack: cloneRecord(record.anchorPack),
-    lockState: cloneRecord(record.lockState),
-    draftProfile: cloneRecord(record.draftProfile),
-    messages: cloneRecord(record.messages),
-    draftCards: cloneRecord(record.draftCards),
-    pendingClarifications: cloneRecord(record.pendingClarifications),
-    suggestedActions: cloneRecord(record.suggestedActions),
-    recommendedReplies: cloneRecord(record.recommendedReplies),
-    qualityFindings: cloneRecord(record.qualityFindings),
-    assetCoverage: cloneRecord(record.assetCoverage),
+    creatorIntent: cloneRpgAgentSessionValue(record.creatorIntent),
+    creatorIntentReadiness: cloneRpgAgentSessionValue(
+      record.creatorIntentReadiness,
+    ),
+    anchorPack: cloneRpgAgentSessionValue(record.anchorPack),
+    lockState: cloneRpgAgentSessionValue(record.lockState),
+    draftProfile: cloneRpgAgentSessionValue(record.draftProfile),
+    messages: cloneRpgAgentSessionValue(record.messages),
+    draftCards: cloneRpgAgentSessionValue(record.draftCards),
+    pendingClarifications: cloneRpgAgentSessionValue(
+      record.pendingClarifications,
+    ),
+    suggestedActions: cloneRpgAgentSessionValue(record.suggestedActions),
+    recommendedReplies: cloneRpgAgentSessionValue(record.recommendedReplies),
+    qualityFindings: cloneRpgAgentSessionValue(record.qualityFindings),
+    assetCoverage: cloneRpgAgentSessionValue(record.assetCoverage),
+    checkpoints: record.checkpoints.map((checkpoint) => ({
+      checkpointId: checkpoint.checkpointId,
+      createdAt: checkpoint.createdAt,
+      label: checkpoint.label,
+    })),
     updatedAt: record.updatedAt,
   };
 }
 
-export class CustomWorldAgentSessionStore {
-  constructor(private readonly runtimeRepository: RuntimeRepositoryPort) {}
+function normalizeCompatibleSessionRecord(
+  record: CustomWorldAgentSessionRecord,
+): CustomWorldAgentSessionRecord {
+  return cloneRpgAgentSessionValue(
+    applyCustomWorldAgentSessionCompatibility(
+      record,
+    ) as unknown as CustomWorldAgentSessionRecord,
+  );
+}
 
-  private async persist(record: CustomWorldAgentSessionRecord) {
-    await this.runtimeRepository.upsertCustomWorldSession(
+export { CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX };
+export type { CustomWorldAgentSessionRecord };
+
+export class CustomWorldAgentSessionStore {
+  private readonly sessionRepository: RpgAgentSessionRepositoryAdapter;
+
+  constructor(sessionRepository: RpgAgentSessionRepositoryPort) {
+    this.sessionRepository = new RpgAgentSessionRepositoryAdapter(
+      sessionRepository,
+    );
+  }
+
+  private async persist(
+    record: CustomWorldAgentSessionRecord,
+  ): Promise<CustomWorldAgentSessionRecord> {
+    await this.sessionRepository.upsert(
       record.userId,
       record.sessionId,
       record as unknown as LegacyCustomWorldSessionRecord,
     );
-    return cloneRecord(record);
+
+    return cloneRpgAgentSessionValue(record);
   }
 
   private async mutate(
     userId: string,
     sessionId: string,
     mutateFn: (record: CustomWorldAgentSessionRecord) => void,
-  ) {
+  ): Promise<CustomWorldAgentSessionRecord | null> {
     const current = await this.get(userId, sessionId);
     if (!current) {
       return null;
     }
 
-    const nextRecord = cloneRecord(current);
+    const nextRecord = cloneRpgAgentSessionValue(current);
     mutateFn(nextRecord);
     nextRecord.updatedAt = new Date().toISOString();
     return this.persist(nextRecord);
   }
 
-  async create(userId: string, input: CreateSessionInput) {
-    const sessionId = `${CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX}${crypto.randomBytes(16).toString('hex')}`;
-    const now = new Date().toISOString();
-    const welcomeMessage: CustomWorldAgentMessage = {
-      id: `message-${crypto.randomBytes(8).toString('hex')}`,
-      role: 'assistant',
-      kind: 'chat',
-      text: input.welcomeMessage,
-      createdAt: now,
-      relatedOperationId: null,
-    };
-    const record: CustomWorldAgentSessionRecord = {
-      sessionId,
-      userId,
-      seedText: input.seedText?.trim() ?? '',
-      currentTurn: Math.max(0, Math.round(input.currentTurn ?? 0)),
-      anchorContent: normalizeEightAnchorContent(
-        input.anchorContent ?? createEmptyEightAnchorContent(),
-      ),
-      progressPercent: Math.max(
-        0,
-        Math.min(100, Math.round(input.progressPercent ?? 0)),
-      ),
-      lastAssistantReply: input.lastAssistantReply ?? input.welcomeMessage,
-      stage: input.stage ?? 'collecting_intent',
-      focusCardId: null,
-      creatorIntent: cloneRecord(input.creatorIntent ?? {}),
-      creatorIntentReadiness: input.creatorIntentReadiness ?? {
-        isReady: false,
-        completedKeys: [],
-        missingKeys: [],
-      },
-      anchorPack: cloneRecord(input.anchorPack ?? {}),
-      lockState: {},
-      draftProfile: cloneRecord(input.draftProfile ?? {}),
-      messages: [welcomeMessage],
-      draftCards: [],
-      pendingClarifications: cloneRecord(input.pendingClarifications),
-      suggestedActions: cloneRecord(input.suggestedActions),
-      recommendedReplies: cloneRecord(input.recommendedReplies ?? []),
-      qualityFindings: [],
-      assetCoverage: rebuildRoleAssetCoverage(input.draftProfile ?? {}),
-      operations: [],
-      checkpoints: [],
-      createdAt: now,
-      updatedAt: now,
-    };
-
-    const compatibleRecord = applyCompatibility(record);
-    await this.persist(compatibleRecord);
-    return cloneRecord(compatibleRecord);
+  async create(
+    userId: string,
+    input: CreateCustomWorldAgentSessionInput,
+  ): Promise<CustomWorldAgentSessionRecord> {
+    const record = createCustomWorldAgentSessionRecord(userId, input);
+    await this.persist(record);
+    return cloneRpgAgentSessionValue(record);
   }
 
-  async list(userId: string) {
-    const records =
-      await this.runtimeRepository.listCustomWorldSessions(userId);
+  async list(userId: string): Promise<CustomWorldAgentSessionRecord[]> {
+    const records = await this.sessionRepository.list(userId);
 
     return records
-      .filter((record) => isAgentSessionRecord(record))
-      .map((record) => cloneRecord(applyCompatibility(record)))
+      .filter((record) => isCustomWorldAgentSessionRecord(record))
+      .map((record) => normalizeCompatibleSessionRecord(record))
       .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
   }
 
-  async get(userId: string, sessionId: string) {
+  async get(
+    userId: string,
+    sessionId: string,
+  ): Promise<CustomWorldAgentSessionRecord | null> {
     if (!sessionId.trim()) {
       return null;
     }
 
-    const record = await this.runtimeRepository.getCustomWorldSession(
-      userId,
-      sessionId,
-    );
-    if (!isAgentSessionRecord(record)) {
+    const record = await this.sessionRepository.get(userId, sessionId);
+    if (!isCustomWorldAgentSessionRecord(record)) {
       return null;
     }
 
-    return cloneRecord(applyCompatibility(record));
+    return normalizeCompatibleSessionRecord(record);
   }
 
   async getSnapshot(userId: string, sessionId: string) {
@@ -651,7 +154,7 @@ export class CustomWorldAgentSessionStore {
     message: CustomWorldAgentMessage,
   ) {
     return this.mutate(userId, sessionId, (record) => {
-      record.messages.push(cloneRecord(message));
+      record.messages.push(cloneRpgAgentSessionValue(message));
     });
   }
 
@@ -704,39 +207,47 @@ export class CustomWorldAgentSessionStore {
         record.focusCardId = patch.focusCardId;
       }
       if (patch.creatorIntent !== undefined) {
-        record.creatorIntent = cloneRecord(patch.creatorIntent);
+        record.creatorIntent = cloneRpgAgentSessionValue(patch.creatorIntent);
       }
       if (patch.creatorIntentReadiness !== undefined) {
-        record.creatorIntentReadiness = cloneRecord(
+        record.creatorIntentReadiness = cloneRpgAgentSessionValue(
           patch.creatorIntentReadiness,
         );
       }
       if (patch.anchorPack !== undefined) {
-        record.anchorPack = cloneRecord(patch.anchorPack);
+        record.anchorPack = cloneRpgAgentSessionValue(patch.anchorPack);
       }
       if (patch.lockState !== undefined) {
-        record.lockState = cloneRecord(patch.lockState);
+        record.lockState = cloneRpgAgentSessionValue(patch.lockState);
       }
       if (patch.draftProfile !== undefined) {
-        record.draftProfile = cloneRecord(patch.draftProfile);
+        record.draftProfile = cloneRpgAgentSessionValue(patch.draftProfile);
       }
       if (patch.pendingClarifications !== undefined) {
-        record.pendingClarifications = cloneRecord(patch.pendingClarifications);
+        record.pendingClarifications = cloneRpgAgentSessionValue(
+          patch.pendingClarifications,
+        );
       }
       if (patch.suggestedActions !== undefined) {
-        record.suggestedActions = cloneRecord(patch.suggestedActions);
+        record.suggestedActions = cloneRpgAgentSessionValue(
+          patch.suggestedActions,
+        );
       }
       if (patch.recommendedReplies !== undefined) {
-        record.recommendedReplies = cloneRecord(patch.recommendedReplies);
+        record.recommendedReplies = cloneRpgAgentSessionValue(
+          patch.recommendedReplies,
+        );
       }
       if (patch.draftCards !== undefined) {
-        record.draftCards = cloneRecord(patch.draftCards);
+        record.draftCards = cloneRpgAgentSessionValue(patch.draftCards);
       }
       if (patch.qualityFindings !== undefined) {
-        record.qualityFindings = cloneRecord(patch.qualityFindings);
+        record.qualityFindings = cloneRpgAgentSessionValue(
+          patch.qualityFindings,
+        );
       }
       if (patch.assetCoverage !== undefined) {
-        record.assetCoverage = cloneRecord(patch.assetCoverage);
+        record.assetCoverage = cloneRpgAgentSessionValue(patch.assetCoverage);
       }
     });
   }
@@ -747,7 +258,7 @@ export class CustomWorldAgentSessionStore {
     operation: CustomWorldAgentOperationRecord,
   ) {
     return this.mutate(userId, sessionId, (record) => {
-      record.operations.push(cloneRecord(operation));
+      record.operations.push(cloneRpgAgentSessionValue(operation));
     });
   }
 
@@ -760,7 +271,7 @@ export class CustomWorldAgentSessionStore {
     const operation = record.operations.find(
       (item) => item.operationId === operationId,
     );
-    return operation ? cloneRecord(operation) : null;
+    return operation ? cloneRpgAgentSessionValue(operation) : null;
   }
 
   async updateOperation(
@@ -804,6 +315,28 @@ export class CustomWorldAgentSessionStore {
     input: {
       checkpointId?: string;
       label: string;
+      snapshot?: Partial<
+        Pick<
+          CustomWorldAgentSessionRecord,
+          | 'currentTurn'
+          | 'anchorContent'
+          | 'progressPercent'
+          | 'lastAssistantReply'
+          | 'stage'
+          | 'focusCardId'
+          | 'creatorIntent'
+          | 'creatorIntentReadiness'
+          | 'anchorPack'
+          | 'lockState'
+          | 'draftProfile'
+          | 'pendingClarifications'
+          | 'suggestedActions'
+          | 'recommendedReplies'
+          | 'draftCards'
+          | 'qualityFindings'
+          | 'assetCoverage'
+        >
+      > | null;
     },
   ) {
     return this.mutate(userId, sessionId, (record) => {
@@ -813,12 +346,106 @@ export class CustomWorldAgentSessionStore {
           `checkpoint-${crypto.randomBytes(8).toString('hex')}`,
         createdAt: new Date().toISOString(),
         label: input.label,
+        snapshot: input.snapshot
+          ? {
+              currentTurn:
+                typeof input.snapshot.currentTurn === 'number'
+                  ? Math.max(0, Math.round(input.snapshot.currentTurn))
+                  : record.currentTurn,
+              anchorContent: cloneRpgAgentSessionValue(
+                input.snapshot.anchorContent ?? record.anchorContent,
+              ),
+              progressPercent:
+                typeof input.snapshot.progressPercent === 'number'
+                  ? Math.max(
+                      0,
+                      Math.min(100, Math.round(input.snapshot.progressPercent)),
+                    )
+                  : record.progressPercent,
+              lastAssistantReply:
+                input.snapshot.lastAssistantReply ?? record.lastAssistantReply,
+              stage: input.snapshot.stage ?? record.stage,
+              focusCardId:
+                input.snapshot.focusCardId !== undefined
+                  ? input.snapshot.focusCardId
+                  : record.focusCardId,
+              creatorIntent: cloneRpgAgentSessionValue(
+                input.snapshot.creatorIntent ?? record.creatorIntent,
+              ),
+              creatorIntentReadiness: cloneRpgAgentSessionValue(
+                input.snapshot.creatorIntentReadiness ??
+                  record.creatorIntentReadiness,
+              ),
+              anchorPack: cloneRpgAgentSessionValue(
+                input.snapshot.anchorPack ?? record.anchorPack,
+              ),
+              lockState: cloneRpgAgentSessionValue(
+                input.snapshot.lockState ?? record.lockState,
+              ),
+              draftProfile: cloneRpgAgentSessionValue(
+                input.snapshot.draftProfile ?? record.draftProfile,
+              ),
+              pendingClarifications: cloneRpgAgentSessionValue(
+                input.snapshot.pendingClarifications ??
+                  record.pendingClarifications,
+              ),
+              suggestedActions: cloneRpgAgentSessionValue(
+                input.snapshot.suggestedActions ?? record.suggestedActions,
+              ),
+              recommendedReplies: cloneRpgAgentSessionValue(
+                input.snapshot.recommendedReplies ?? record.recommendedReplies,
+              ),
+              draftCards: cloneRpgAgentSessionValue(
+                input.snapshot.draftCards ?? record.draftCards,
+              ),
+              qualityFindings: cloneRpgAgentSessionValue(
+                input.snapshot.qualityFindings ?? record.qualityFindings,
+              ),
+              assetCoverage: cloneRpgAgentSessionValue(
+                input.snapshot.assetCoverage ?? record.assetCoverage,
+              ),
+            }
+          : null,
       });
     });
   }
 
+  async restoreCheckpoint(
+    userId: string,
+    sessionId: string,
+    checkpointId: string,
+  ) {
+    return this.mutate(userId, sessionId, (record) => {
+      const checkpoint = record.checkpoints.find(
+        (entry) => entry.checkpointId === checkpointId,
+      );
+      if (!checkpoint?.snapshot) {
+        return;
+      }
+
+      const snapshot = cloneRpgAgentSessionValue(checkpoint.snapshot);
+      record.currentTurn = snapshot.currentTurn;
+      record.anchorContent = snapshot.anchorContent;
+      record.progressPercent = snapshot.progressPercent;
+      record.lastAssistantReply = snapshot.lastAssistantReply;
+      record.stage = snapshot.stage;
+      record.focusCardId = snapshot.focusCardId;
+      record.creatorIntent = snapshot.creatorIntent;
+      record.creatorIntentReadiness = snapshot.creatorIntentReadiness;
+      record.anchorPack = snapshot.anchorPack;
+      record.lockState = snapshot.lockState;
+      record.draftProfile = snapshot.draftProfile;
+      record.pendingClarifications = snapshot.pendingClarifications;
+      record.suggestedActions = snapshot.suggestedActions;
+      record.recommendedReplies = snapshot.recommendedReplies;
+      record.draftCards = snapshot.draftCards;
+      record.qualityFindings = snapshot.qualityFindings;
+      record.assetCoverage = snapshot.assetCoverage;
+    });
+  }
+
   async listDraftCards(userId: string, sessionId: string) {
     const record = await this.get(userId, sessionId);
-    return record ? cloneRecord(record.draftCards) : null;
+    return record ? cloneRpgAgentSessionValue(record.draftCards) : null;
   }
 }
diff --git a/server-node/src/services/customWorldAgentSnapshotBuilder.ts b/server-node/src/services/customWorldAgentSnapshotBuilder.ts
new file mode 100644
index 00000000..76f69d3e
--- /dev/null
+++ b/server-node/src/services/customWorldAgentSnapshotBuilder.ts
@@ -0,0 +1,199 @@
+import type {
+  CreatorIntentReadiness,
+  CustomWorldAgentStage,
+  CustomWorldAssetCoverageSummary,
+  CustomWorldDraftCardSummary,
+  CustomWorldPendingClarification,
+  EightAnchorContent,
+} from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import {
+  buildDraftSummaryFromIntent,
+  buildDraftTitleFromIntent,
+  type CustomWorldCreatorIntentRecord,
+} from './customWorldAgentIntentExtractionService.js';
+import { CustomWorldAgentQualityGateService } from './customWorldAgentQualityGateService.js';
+import { rebuildRoleAssetCoverage } from './customWorldAgentRoleAssetStateService.js';
+import type { CustomWorldAgentSessionRecord } from './customWorldAgentSessionStore.js';
+import { CustomWorldAgentSuggestedActionService } from './customWorldAgentSuggestedActionService.js';
+import { buildAnchorPackFromEightAnchorContent } from './eightAnchorCompatibilityService.js';
+import { CustomWorldAgentDraftCompiler } from './customWorldAgentDraftCompiler.js';
+
+export type CustomWorldAgentDerivedStatePatch = Partial<
+  Pick<
+    CustomWorldAgentSessionRecord,
+    | 'currentTurn'
+    | 'anchorContent'
+    | 'progressPercent'
+    | 'lastAssistantReply'
+    | 'stage'
+    | 'focusCardId'
+    | 'creatorIntent'
+    | 'creatorIntentReadiness'
+    | 'anchorPack'
+    | 'draftProfile'
+    | 'pendingClarifications'
+    | 'suggestedActions'
+    | 'recommendedReplies'
+    | 'draftCards'
+    | 'qualityFindings'
+    | 'assetCoverage'
+  >
+>;
+
+export class CustomWorldAgentSnapshotBuilder {
+  constructor(
+    private readonly draftCompiler: CustomWorldAgentDraftCompiler,
+    private readonly suggestedActionService: CustomWorldAgentSuggestedActionService,
+    private readonly qualityGateService: CustomWorldAgentQualityGateService,
+  ) {}
+
+  // 把“草稿改动后需要重算哪些派生字段”统一封装成一个入口，避免每个 action 都重复拼 patch。
+  buildRefiningState(params: {
+    previousStage: CustomWorldAgentStage;
+    draftProfile: Record<string, unknown>;
+    draftCards?: CustomWorldDraftCardSummary[];
+    assetCoverage?: CustomWorldAssetCoverageSummary;
+    nextStage?: Extract<
+      CustomWorldAgentStage,
+      | 'object_refining'
+      | 'visual_refining'
+      | 'long_tail_review'
+      | 'ready_to_publish'
+    >;
+    focusCardId?: string | null;
+  }): CustomWorldAgentDerivedStatePatch {
+    const nextDraftCards =
+      params.draftCards ?? this.draftCompiler.compileDraftCards(params.draftProfile);
+    const assetCoverage =
+      params.assetCoverage ?? rebuildRoleAssetCoverage(params.draftProfile);
+    const nextStage =
+      params.nextStage ??
+      (params.previousStage === 'visual_refining'
+        ? 'visual_refining'
+        : params.previousStage === 'long_tail_review'
+          ? 'long_tail_review'
+          : params.previousStage === 'ready_to_publish'
+            ? 'ready_to_publish'
+        : 'object_refining');
+
+    return {
+      stage: nextStage,
+      draftProfile: params.draftProfile,
+      draftCards: nextDraftCards,
+      assetCoverage,
+      qualityFindings: this.qualityGateService.buildQualityFindings({
+        draftProfile: params.draftProfile,
+        assetCoverage,
+        stage: nextStage,
+      }),
+      focusCardId: params.focusCardId,
+      suggestedActions: this.suggestedActionService.buildSuggestedActions({
+        stage: nextStage,
+        isReady: true,
+        draftProfile: params.draftProfile,
+        draftCards: nextDraftCards,
+      }),
+      recommendedReplies: [],
+    };
+  }
+
+  buildFoundationDraftState(params: {
+    creatorIntent: Record<string, unknown> | null;
+    anchorPack: Record<string, unknown> | null;
+    draftProfile: Record<string, unknown>;
+    assetCoverage?: CustomWorldAssetCoverageSummary;
+  }): CustomWorldAgentDerivedStatePatch {
+    return {
+      ...this.buildRefiningState({
+        previousStage: 'object_refining',
+        nextStage: 'object_refining',
+        draftProfile: params.draftProfile,
+        assetCoverage: params.assetCoverage,
+      }),
+      creatorIntent: params.creatorIntent,
+      anchorPack: params.anchorPack,
+      pendingClarifications: [],
+    };
+  }
+
+  buildMessageTurnState(params: {
+    latestSession: CustomWorldAgentSessionRecord;
+    nextAnchorContent: EightAnchorContent;
+    progressPercent: number;
+    replyText: string;
+    nextCreatorIntent: CustomWorldCreatorIntentRecord;
+    creatorIntentReadiness: CreatorIntentReadiness;
+    derivedDraftProfile: {
+      title: string;
+      summary: string;
+    };
+    derivedPendingClarifications: CustomWorldPendingClarification[];
+    derivedStage: CustomWorldAgentStage;
+    shouldStayInDraftStage: boolean;
+  }): CustomWorldAgentDerivedStatePatch {
+    const preservedStage =
+      params.latestSession.stage === 'visual_refining'
+        ? ('visual_refining' as const)
+        : ('object_refining' as const);
+    const nextDraftProfile = params.shouldStayInDraftStage
+      ? ((params.latestSession.draftProfile ?? {}) as Record<string, unknown>)
+      : params.progressPercent >= 100
+        ? {
+            title: buildDraftTitleFromIntent(params.nextCreatorIntent),
+            summary: buildDraftSummaryFromIntent(params.nextCreatorIntent),
+          }
+        : params.derivedDraftProfile;
+    const nextStage = params.shouldStayInDraftStage
+      ? preservedStage
+      : params.derivedStage;
+    const assetCoverage = params.shouldStayInDraftStage
+      ? params.latestSession.assetCoverage
+      : rebuildRoleAssetCoverage(nextDraftProfile);
+
+    return {
+      currentTurn: params.latestSession.currentTurn + 1,
+      anchorContent: params.nextAnchorContent,
+      progressPercent: params.progressPercent,
+      lastAssistantReply: params.replyText,
+      stage: nextStage,
+      focusCardId: params.shouldStayInDraftStage
+        ? params.latestSession.focusCardId
+        : null,
+      creatorIntent: params.nextCreatorIntent,
+      creatorIntentReadiness: params.creatorIntentReadiness,
+      anchorPack: buildAnchorPackFromEightAnchorContent(
+        params.nextAnchorContent,
+        params.progressPercent,
+      ),
+      draftProfile: nextDraftProfile,
+      draftCards: params.shouldStayInDraftStage
+        ? params.latestSession.draftCards
+        : [],
+      assetCoverage,
+      qualityFindings: this.qualityGateService.buildQualityFindings({
+        draftProfile: nextDraftProfile,
+        assetCoverage,
+        stage: nextStage,
+      }),
+      pendingClarifications:
+        params.progressPercent >= 100 ? [] : params.derivedPendingClarifications,
+      suggestedActions: params.shouldStayInDraftStage
+        ? this.suggestedActionService.buildSuggestedActions({
+            stage: preservedStage,
+            isReady: true,
+            draftProfile: params.latestSession.draftProfile,
+            draftCards: params.latestSession.draftCards,
+          })
+        : params.progressPercent >= 100
+          ? [
+              {
+                id: 'draft_foundation',
+                type: 'draft_foundation',
+                label: '生成游戏设定草稿',
+              },
+            ]
+          : [],
+      recommendedReplies: [],
+    };
+  }
+}
diff --git a/server-node/src/services/customWorldAgentSuggestedActionService.ts b/server-node/src/services/customWorldAgentSuggestedActionService.ts
new file mode 100644
index 00000000..3516224a
--- /dev/null
+++ b/server-node/src/services/customWorldAgentSuggestedActionService.ts
@@ -0,0 +1,82 @@
+import type {
+  CustomWorldAgentStage,
+  CustomWorldDraftCardSummary,
+  CustomWorldSuggestedAction,
+} from '../../../packages/shared/src/contracts/customWorldAgent.js';
+import {
+  getWorldFoundationCardId,
+  normalizeFoundationDraftProfile,
+} from './customWorldAgentDraftCompiler.js';
+
+export class CustomWorldAgentSuggestedActionService {
+  // 统一维护 Agent 草稿阶段的建议动作，避免继续散落在 orchestrator 和 store 的兼容逻辑里。
+  buildSuggestedActions(
+    params: {
+      stage?: CustomWorldAgentStage;
+      isReady?: boolean;
+      draftProfile?: unknown;
+      draftCards?: CustomWorldDraftCardSummary[];
+    } = {},
+  ): CustomWorldSuggestedAction[] {
+    const profile = normalizeFoundationDraftProfile(params.draftProfile);
+    const actions: CustomWorldSuggestedAction[] = [
+      {
+        id: 'request_summary',
+        type: 'request_summary',
+        label:
+          params.stage === 'object_refining' ||
+          params.stage === 'visual_refining'
+            ? '总结当前世界底稿'
+            : '总结当前设定',
+      },
+    ];
+
+    if (params.stage === 'foundation_review' && params.isReady) {
+      actions.push({
+        id: 'draft_foundation',
+        type: 'draft_foundation',
+        label: '整理一版世界底稿',
+      });
+      return actions;
+    }
+
+    if (
+      (params.stage === 'object_refining' ||
+        params.stage === 'visual_refining') &&
+      profile
+    ) {
+      const worldCardId =
+        params.draftCards?.find((entry) => entry.kind === 'world')?.id ??
+        getWorldFoundationCardId();
+      const firstCharacter = [...profile.playableNpcs, ...profile.storyNpcs][0];
+      const firstLandmark = profile.landmarks[0];
+
+      actions.push({
+        id: 'refine_world',
+        type: 'refine_focus_target',
+        label: '先看世界总卡',
+        targetId: worldCardId,
+      });
+
+      if (firstCharacter) {
+        actions.push({
+          id: `refine-character-${firstCharacter.id}`,
+          type: 'refine_focus_target',
+          label: `精修角色：${firstCharacter.name}`,
+          targetId: firstCharacter.id,
+        });
+      }
+
+      if (firstLandmark) {
+        actions.push({
+          id: `refine-landmark-${firstLandmark.id}`,
+          type: 'refine_focus_target',
+          label: `继续补地点：${firstLandmark.name}`,
+          targetId: firstLandmark.id,
+        });
+      }
+    }
+
+    return actions;
+  }
+}
diff --git a/server-node/src/services/customWorldWorkSummaryService.integration.test.ts b/server-node/src/services/customWorldWorkSummaryService.integration.test.ts
new file mode 100644
index 00000000..9dde95cb
--- /dev/null
+++ b/server-node/src/services/customWorldWorkSummaryService.integration.test.ts
@@ -0,0 +1,113 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+  createRpgAgentSessionFixture,
+  createRpgCreationWorksResponseFixture,
+  createRpgWorldLibraryEntryFixture,
+} from '../../../packages/shared/src/contracts/rpgCreationFixtures.js';
+import type { CustomWorldSessionRecord } from '../../../packages/shared/src/contracts/runtime.js';
+import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
+import { listCustomWorldWorkSummaries } from './customWorldWorkSummaryService.js';
+import {
+  CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX,
+  CustomWorldAgentSessionStore,
+} from './customWorldAgentSessionStore.js';
+
+test('work summary service can aggregate shared RPG fixtures into draft and published entries', async () => {
+  const sessionFixture = createRpgAgentSessionFixture();
+  const sessionRecord: CustomWorldSessionRecord = {
+    ...JSON.parse(JSON.stringify(sessionFixture)),
+    sessionId: `${CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX}fixture`,
+    userId: 'fixture-user',
+    seedText: '被海雾吞没的旧航路群岛',
+    operations: [],
+    checkpoints: [],
+    createdAt: sessionFixture.updatedAt,
+    updatedAt: sessionFixture.updatedAt,
+  } as CustomWorldSessionRecord;
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts({
+      sessionRecords: [sessionRecord],
+      profileEntries: [createRpgWorldLibraryEntryFixture()],
+    });
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+  const summaries = await listCustomWorldWorkSummaries('fixture-user', {
+    rpgWorldProfiles: rpgWorldProfileRepository,
+    customWorldAgentSessions: sessionStore,
+  });
+  const expected = createRpgCreationWorksResponseFixture();
+
+  assert.equal(summaries.length, expected.items.length);
+
+  const draftItem = summaries.find((entry) => entry.sourceType === 'agent_session');
+  const publishedItem = summaries.find(
+    (entry) => entry.sourceType === 'published_profile',
+  );
+  const expectedDraft = expected.items.find(
+    (entry) => entry.sourceType === 'agent_session',
+  );
+  const expectedPublished = expected.items.find(
+    (entry) => entry.sourceType === 'published_profile',
+  );
+
+  assert.ok(draftItem);
+  assert.ok(publishedItem);
+  assert.ok(expectedDraft);
+  assert.ok(expectedPublished);
+
+  assert.equal(draftItem?.title, expectedDraft?.title);
+  assert.equal(draftItem?.subtitle, expectedDraft?.subtitle);
+  assert.equal(draftItem?.coverRenderMode, expectedDraft?.coverRenderMode);
+  assert.deepEqual(
+    draftItem?.coverCharacterImageSrcs,
+    expectedDraft?.coverCharacterImageSrcs,
+  );
+  assert.equal(draftItem?.roleAssetSummaryLabel, expectedDraft?.roleAssetSummaryLabel);
+  assert.equal(draftItem?.publishReady, expectedDraft?.publishReady);
+  assert.equal(draftItem?.blockerCount, expectedDraft?.blockerCount);
+
+  assert.equal(publishedItem?.title, expectedPublished?.title);
+  assert.equal(publishedItem?.profileId, expectedPublished?.profileId);
+  assert.equal(publishedItem?.canEnterWorld, true);
+  assert.equal(publishedItem?.coverRenderMode, expectedPublished?.coverRenderMode);
+});
+
+test('published agent sessions are filtered out after works unify to published profile truth', async () => {
+  const sessionFixture = createRpgAgentSessionFixture();
+  const sessionRecord: CustomWorldSessionRecord = {
+    ...JSON.parse(JSON.stringify(sessionFixture)),
+    sessionId: `${CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX}published-fixture`,
+    userId: 'fixture-user',
+    seedText: '被海雾吞没的旧航路群岛',
+    stage: 'published',
+    operations: [],
+    checkpoints: [],
+    createdAt: sessionFixture.updatedAt,
+    updatedAt: sessionFixture.updatedAt,
+  } as CustomWorldSessionRecord;
+  const { rpgAgentSessionRepository, rpgWorldProfileRepository } =
+    createInMemoryRpgWorldRepositoryPorts({
+      sessionRecords: [sessionRecord],
+      profileEntries: [createRpgWorldLibraryEntryFixture()],
+    });
+  const sessionStore = new CustomWorldAgentSessionStore(
+    rpgAgentSessionRepository,
+  );
+
+  const summaries = await listCustomWorldWorkSummaries('fixture-user', {
+    rpgWorldProfiles: rpgWorldProfileRepository,
+    customWorldAgentSessions: sessionStore,
+  });
+
+  assert.equal(
+    summaries.some((entry) => entry.sourceType === 'agent_session'),
+    false,
+  );
+  assert.equal(
+    summaries.filter((entry) => entry.sourceType === 'published_profile').length,
+    1,
+  );
+});
diff --git a/server-node/src/services/customWorldWorkSummaryService.ts b/server-node/src/services/customWorldWorkSummaryService.ts
index 9111b4b9..f66fef77 100644
--- a/server-node/src/services/customWorldWorkSummaryService.ts
+++ b/server-node/src/services/customWorldWorkSummaryService.ts
@@ -1,301 +1,20 @@
-import type {
-  CustomWorldAgentStage,
-  CustomWorldWorkSummary,
-} from '../../../packages/shared/src/contracts/customWorldAgent.js';
-import type {
-  CustomWorldLibraryEntry,
-  CustomWorldProfileRecord,
-} from '../../../packages/shared/src/contracts/runtime.js';
-import type { RuntimeRepositoryPort } from '../repositories/runtimeRepository.js';
-import { resolveCustomWorldCoverPresentation } from '../repositories/customWorldLibraryMetadata.js';
-import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
-import {
-  buildDraftSummaryFromIntent,
-  buildDraftTitleFromIntent,
-  normalizeCreatorIntentRecord,
-} from './customWorldAgentIntentExtractionService.js';
-import {
-  rebuildRoleAssetCoverage,
-  resolveRoleAssetStatusLabel,
-} from './customWorldAgentRoleAssetStateService.js';
-import type {
-  CustomWorldAgentSessionRecord,
-  CustomWorldAgentSessionStore,
-} from './customWorldAgentSessionStore.js';
-import {
-  buildDraftSummaryFromEightAnchorContent,
-  buildDraftTitleFromEightAnchorContent,
-} from './eightAnchorCompatibilityService.js';
-
-function toText(value: unknown) {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-function toRecord(value: unknown) {
-  return value && typeof value === 'object' && !Array.isArray(value)
-    ? (value as Record<string, unknown>)
-    : null;
-}
-
-function toRecordArray(value: unknown) {
-  return Array.isArray(value)
-    ? value.filter((item) => item && typeof item === 'object')
-    : [];
-}
-
-function truncateText(value: string, maxLength: number) {
-  if (value.length <= maxLength) {
-    return value;
-  }
-
-  return `${value.slice(0, Math.max(0, maxLength - 1)).trim()}…`;
-}
-
-function formatDraftStageLabel(stage: CustomWorldAgentStage) {
-  if (stage === 'collecting_intent') return '收集世界锚点';
-  if (stage === 'clarifying') return '补齐关键锚点';
-  if (stage === 'foundation_review') return '准备整理底稿';
-  if (stage === 'object_refining') return '待完善草稿';
-  if (stage === 'visual_refining') return '视觉工坊';
-  if (stage === 'long_tail_review') return '扩展长尾';
-  if (stage === 'ready_to_publish') return '准备发布';
-  if (stage === 'published') return '已发布';
-  return '发生错误';
-}
-
-function resolveDraftTitle(session: CustomWorldAgentSessionRecord) {
-  const intent = normalizeCreatorIntentRecord(session.creatorIntent);
-  const draftProfile = normalizeFoundationDraftProfile(session.draftProfile);
-
-  return (
-    draftProfile?.name ||
-    buildDraftTitleFromEightAnchorContent(session.anchorContent) ||
-    buildDraftTitleFromIntent(intent) ||
-    toText(session.draftProfile?.title) ||
-    truncateText(session.seedText, 18) ||
-    '未命名草稿'
-  );
-}
-
-function resolveDraftSummary(session: CustomWorldAgentSessionRecord) {
-  const intent = normalizeCreatorIntentRecord(session.creatorIntent);
-  const compiledSummary = buildDraftSummaryFromIntent(intent);
-  const draftProfile = normalizeFoundationDraftProfile(session.draftProfile);
-
-  return (
-    draftProfile?.summary ||
-    buildDraftSummaryFromEightAnchorContent(session.anchorContent) ||
-    compiledSummary ||
-    toText(session.draftProfile?.summary) ||
-    truncateText(session.seedText, 72) ||
-    '还在收集你的世界锚点。'
-  );
-}
-
-function resolveDraftCounts(session: CustomWorldAgentSessionRecord) {
-  const draftProfile = normalizeFoundationDraftProfile(session.draftProfile);
-  if (draftProfile) {
-    // 草稿列表里的“角色”展示的是当前草稿中全部可编辑角色，而不是仅限可扮演角色。
-    const totalRoleCount = [
-      ...new Set(
-        [...draftProfile.playableNpcs, ...draftProfile.storyNpcs].map(
-          (entry) => entry.id,
-        ),
-      ),
-    ].length;
-
-    return {
-      playableNpcCount: totalRoleCount,
-      landmarkCount: draftProfile.landmarks.length,
-    };
-  }
-
-  const playableNpcCount = session.draftCards.filter(
-    (card) => card.kind === 'character',
-  ).length;
-  const landmarkCount = session.draftCards.filter(
-    (card) => card.kind === 'landmark' || card.kind === 'camp',
-  ).length;
-
-  return {
-    playableNpcCount,
-    landmarkCount,
-  };
-}
-
-function resolveDraftRoleAssetProgress(session: CustomWorldAgentSessionRecord) {
-  const coverage = rebuildRoleAssetCoverage(session.draftProfile);
-  const roleVisualReadyCount = coverage.roleAssets.filter(
-    (entry) => entry.status !== 'missing',
-  ).length;
-  const roleAnimationReadyCount = coverage.roleAssets.filter(
-    (entry) => entry.status === 'complete',
-  ).length;
-  const leadRole = coverage.roleAssets[0];
-
-  return {
-    roleVisualReadyCount,
-    roleAnimationReadyCount,
-    roleAssetSummaryLabel: leadRole
-      ? `${leadRole.roleName} · ${resolveRoleAssetStatusLabel(leadRole.status)}`
-      : coverage.roleAssets.length > 0
-        ? '角色资产进行中'
-        : null,
-  };
-}
-
-function resolveDraftCover(session: CustomWorldAgentSessionRecord) {
-  const draftProfile = toRecord(session.draftProfile);
-  if (!draftProfile) {
-    return {
-      imageSrc: null,
-      renderMode: 'image' as const,
-      characterImageSrcs: [],
-    };
-  }
-
-  return resolveCustomWorldCoverPresentation(
-    draftProfile as CustomWorldProfileRecord,
-  );
-}
-
-function isLibraryEntry(
-  value: unknown,
-): value is CustomWorldLibraryEntry<CustomWorldProfileRecord> {
-  const record = toRecord(value);
-  return (
-    Boolean(record) &&
-    typeof record.ownerUserId === 'string' &&
-    typeof record.profileId === 'string' &&
-    Boolean(toRecord(record.profile))
-  );
-}
-
-function isPublishedLibraryEntry(
-  value: unknown,
-): value is CustomWorldLibraryEntry<CustomWorldProfileRecord> {
-  return isLibraryEntry(value) && value.visibility === 'published';
-}
+import type { RpgWorldProfileRepositoryPort } from '../repositories/RpgWorldProfileRepository.js';
+import type { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
+import { RpgWorldWorkSummaryService } from './RpgWorldWorkSummaryService.js';
 
+/**
+ * 兼容服务入口保留旧文件名，内部则改走 RPG works 组装器，便于后续继续迁到新命名。
+ */
 export async function listCustomWorldWorkSummaries(
   userId: string,
   dependencies: {
-    runtimeRepository: RuntimeRepositoryPort;
+    rpgWorldProfiles: RpgWorldProfileRepositoryPort;
     customWorldAgentSessions: CustomWorldAgentSessionStore;
   },
 ) {
-  const [profiles, sessions] = await Promise.all([
-    dependencies.runtimeRepository.listCustomWorldProfiles(userId),
-    dependencies.customWorldAgentSessions.list(userId),
-  ]);
-
-  const draftItems: CustomWorldWorkSummary[] = sessions.map((session) => {
-    const counts = resolveDraftCounts(session);
-    const roleAssetProgress = resolveDraftRoleAssetProgress(session);
-    const coverPresentation = resolveDraftCover(session);
-
-    return {
-      workId: `draft:${session.sessionId}`,
-      sourceType: 'agent_session',
-      status: 'draft',
-      title: resolveDraftTitle(session),
-      subtitle:
-        normalizeFoundationDraftProfile(session.draftProfile)?.subtitle ||
-        formatDraftStageLabel(session.stage),
-      summary: resolveDraftSummary(session),
-      coverImageSrc: coverPresentation.imageSrc,
-      coverRenderMode: coverPresentation.renderMode,
-      coverCharacterImageSrcs: coverPresentation.characterImageSrcs,
-      updatedAt: session.updatedAt,
-      publishedAt: null,
-      stage: session.stage,
-      stageLabel: formatDraftStageLabel(session.stage),
-      playableNpcCount: counts.playableNpcCount,
-      landmarkCount: counts.landmarkCount,
-      roleVisualReadyCount: roleAssetProgress.roleVisualReadyCount,
-      roleAnimationReadyCount: roleAssetProgress.roleAnimationReadyCount,
-      roleAssetSummaryLabel: roleAssetProgress.roleAssetSummaryLabel,
-      sessionId: session.sessionId,
-      profileId: null,
-      canResume: true,
-      canEnterWorld: false,
-    };
-  });
-
-  const publishedItems: CustomWorldWorkSummary[] = profiles
-    .filter((profile) => isPublishedLibraryEntry(profile))
-    .map((profile) => {
-      const libraryEntry = profile;
-    const profileRecord = (
-      libraryEntry?.profile ?? profile
-    ) as CustomWorldProfileRecord & Record<string, unknown>;
-    const playableNpcs = toRecordArray(profileRecord.playableNpcs);
-    const landmarks = toRecordArray(profileRecord.landmarks);
-    const updatedAt =
-      (libraryEntry ? toText(libraryEntry.updatedAt) : '') ||
-      toText(profileRecord.updatedAt) ||
-      new Date().toISOString();
-    const coverPresentation = resolveCustomWorldCoverPresentation(profileRecord);
-    const roleVisualReadyCount = playableNpcs.filter(
-      (entry) =>
-        Boolean(toText(entry.imageSrc)) &&
-        Boolean(toText(entry.generatedVisualAssetId)),
-    ).length;
-    const roleAnimationReadyCount = playableNpcs.filter(
-      (entry) => Boolean(toText(entry.generatedAnimationSetId)),
-    ).length;
-
-      return {
-        workId: `published:${toText(profileRecord.id) || updatedAt}`,
-        sourceType: 'published_profile',
-        status: 'published',
-        title:
-          toText(libraryEntry.worldName) ||
-          toText(profileRecord.name) ||
-          '未命名世界',
-        subtitle:
-          toText(libraryEntry.subtitle) ||
-          toText(profileRecord.subtitle) ||
-          '已保存作品',
-        summary:
-          toText(libraryEntry.summaryText) ||
-          toText(profileRecord.summary) ||
-          '这个世界已经可以直接进入体验。',
-        coverImageSrc: libraryEntry.coverImageSrc || coverPresentation.imageSrc,
-        coverRenderMode: coverPresentation.renderMode,
-        coverCharacterImageSrcs: coverPresentation.characterImageSrcs,
-        updatedAt,
-        publishedAt:
-          toText(libraryEntry.publishedAt) ||
-          toText(profileRecord.publishedAt) ||
-          updatedAt,
-        stage: 'published',
-        stageLabel: '已发布',
-        playableNpcCount:
-          libraryEntry.playableNpcCount > 0
-            ? libraryEntry.playableNpcCount
-            : playableNpcs.length,
-        landmarkCount:
-          libraryEntry.landmarkCount > 0
-            ? libraryEntry.landmarkCount
-            : landmarks.length,
-        roleVisualReadyCount,
-        roleAnimationReadyCount,
-        roleAssetSummaryLabel:
-          roleAnimationReadyCount > 0
-            ? `动作已就绪 ${roleAnimationReadyCount}`
-            : roleVisualReadyCount > 0
-              ? `主图已就绪 ${roleVisualReadyCount}`
-              : null,
-        sessionId: null,
-        profileId:
-          toText(libraryEntry.profileId) || toText(profileRecord.id) || null,
-        canResume: false,
-        canEnterWorld: true,
-      };
-    });
-
-  return [...draftItems, ...publishedItems].sort((left, right) =>
-    right.updatedAt.localeCompare(left.updatedAt),
+  const service = new RpgWorldWorkSummaryService(
+    dependencies.rpgWorldProfiles,
+    dependencies.customWorldAgentSessions,
   );
+  return service.list(userId);
 }
diff --git a/server-node/src/services/questService.ts b/server-node/src/services/questService.ts
index e3774f73..7bc8db97 100644
--- a/server-node/src/services/questService.ts
+++ b/server-node/src/services/questService.ts
@@ -1,11 +1,11 @@
-import type { QuestGenerationRequest } from '../../../packages/shared/src/contracts/story.js';
+import type { QuestGenerationRequest } from '../../../packages/shared/src/contracts/rpgRuntimeQuestAssist.js';
 import {
   QUEST_INTIMACY_LEVELS,
   QUEST_NARRATIVE_TYPES,
   QUEST_OBJECTIVE_KINDS,
   QUEST_REWARD_THEMES,
   QUEST_URGENCY_LEVELS,
-} from '../../../packages/shared/src/contracts/story.js';
+} from '../../../packages/shared/src/contracts/rpgRuntimeQuestAssist.js';
 import { parseJsonResponseText } from '../../../packages/shared/src/llm/parsers.js';
 import {
   buildFallbackQuestIntent,
diff --git a/server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.test.ts b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.test.ts
new file mode 100644
index 00000000..a2fcac97
--- /dev/null
+++ b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.test.ts
@@ -0,0 +1,158 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import { createRpgAgentSessionFixture } from '../../../../packages/shared/src/contracts/rpgCreationFixtures.js';
+import { applyCustomWorldAgentSessionCompatibility } from './rpgAgentSessionCompatibility.js';
+
+function createLegacySessionRecord() {
+  const session = createRpgAgentSessionFixture();
+
+  return {
+    ...JSON.parse(JSON.stringify(session)),
+    userId: 'fixture-user',
+    seedText: '被海雾吞没的旧航路群岛',
+    operations: [],
+    checkpoints: [],
+    createdAt: session.updatedAt,
+    updatedAt: session.updatedAt,
+  };
+}
+
+test('session compatibility can backfill foundation_review state directly without store participation', () => {
+  const legacyRecord = createLegacySessionRecord();
+  legacyRecord.stage = 'collecting_intent';
+  legacyRecord.progressPercent = 0;
+  legacyRecord.currentTurn = 0;
+  legacyRecord.lastAssistantReply = null;
+  legacyRecord.anchorPack = {};
+  legacyRecord.pendingClarifications = [];
+  legacyRecord.suggestedActions = [];
+  legacyRecord.recommendedReplies = [];
+  legacyRecord.creatorIntentReadiness = {
+    isReady: false,
+    completedKeys: [],
+    missingKeys: [],
+  };
+  legacyRecord.anchorContent = {};
+  legacyRecord.creatorIntent = {
+    rawSettingText: '',
+    worldHook: '被海雾吞没的旧航路群岛',
+    playerPremise: '玩家回到群岛调查沉船真相。',
+    openingSituation: '首夜就有陌生船只闯入禁航区。',
+    themeKeywords: ['压抑', '潮湿', '悬疑'],
+    toneDirectives: ['旧灯塔', '潮雾'],
+    coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+    keyCharacters: [
+      {
+        id: 'playable-1',
+        name: '沈砺',
+        role: '旧航路引路人',
+        publicMask: '看上去像可靠旧友。',
+        hiddenHook: '暗中替沉船商盟引路。',
+        relationToPlayer: '旧友兼潜在背叛者',
+        notes: '关键同行者。',
+      },
+    ],
+    iconicElements: ['回潮旧灯塔', '会移动的海雾'],
+  };
+  legacyRecord.draftProfile = {
+    title: '潮雾列岛',
+    summary: '第一版世界底稿已经整理完成。',
+    playableNpcs: [
+      {
+        id: 'playable-1',
+        name: '沈砺',
+        role: '旧航路引路人',
+      },
+    ],
+    landmarks: [
+      {
+        id: 'landmark-1',
+        name: '回潮旧灯塔',
+        description: '被海雾啃旧的石塔仍在夜里维持着微弱灯火。',
+      },
+    ],
+  };
+
+  const normalized = applyCustomWorldAgentSessionCompatibility(legacyRecord);
+
+  assert.equal(normalized.stage, 'foundation_review');
+  assert.equal(normalized.progressPercent, 0);
+  assert.equal(normalized.creatorIntentReadiness.isReady, true);
+  assert.match(
+    normalized.lastAssistantReply ?? '',
+    /世界底稿已整理完成|结果页确认资产与发布门槛/u,
+  );
+  assert.equal(normalized.pendingClarifications.length, 0);
+  assert.equal(
+    normalized.suggestedActions.some(
+      (entry) => entry.type === 'draft_foundation',
+    ),
+    true,
+  );
+  assert.equal(normalized.anchorContent.worldPromise?.hook, '被海雾吞没的旧航路群岛');
+  assert.equal(normalized.draftProfile.name, '潮雾列岛');
+  assert.equal(normalized.assetCoverage.roleAssets.length, 1);
+});
+
+test('session compatibility can recover missing clarifications and anchor pack from sparse collecting records', () => {
+  const legacyRecord = createLegacySessionRecord();
+  legacyRecord.seedText = '';
+  legacyRecord.stage = 'collecting_intent';
+  legacyRecord.progressPercent = Number.NaN;
+  legacyRecord.currentTurn = undefined;
+  legacyRecord.lastAssistantReply = undefined;
+  legacyRecord.anchorPack = null;
+  legacyRecord.pendingClarifications = [];
+  legacyRecord.suggestedActions = [];
+  legacyRecord.recommendedReplies = [1, '继续补世界一句话', null];
+  legacyRecord.anchorContent = {};
+  legacyRecord.creatorIntent = {
+    rawSettingText: '',
+    worldHook: '一个被潮雾反复切开的边境世界。',
+    playerPremise: '',
+    openingSituation: '',
+    themeKeywords: [],
+    toneDirectives: [],
+    coreConflicts: [],
+    keyCharacters: [],
+    iconicElements: [],
+  };
+  legacyRecord.messages = [
+    {
+      id: 'message-user',
+      role: 'user',
+      kind: 'chat',
+      text: '这个世界先定成一个被潮雾反复切开的边境世界。',
+      createdAt: legacyRecord.updatedAt,
+      relatedOperationId: null,
+    },
+    {
+      id: 'message-assistant',
+      role: 'assistant',
+      kind: 'chat',
+      text: '你好！我是你的世界设定助手。',
+      createdAt: legacyRecord.updatedAt,
+      relatedOperationId: null,
+    },
+  ];
+  legacyRecord.draftProfile = {
+    title: '潮雾边境',
+    summary: '还在收集你的世界锚点。',
+  };
+
+  const normalized = applyCustomWorldAgentSessionCompatibility(legacyRecord);
+
+  assert.equal(normalized.stage, 'clarifying');
+  assert.ok(normalized.progressPercent > 0);
+  assert.equal(normalized.creatorIntentReadiness.isReady, false);
+  assert.ok(normalized.pendingClarifications.length > 0);
+  assert.ok(normalized.pendingClarifications[0]?.question);
+  assert.ok(normalized.anchorPack);
+  assert.deepEqual(normalized.recommendedReplies, ['继续补世界一句话']);
+  assert.ok(
+    normalized.suggestedActions.some(
+      (entry) => entry.type === 'request_summary',
+    ),
+  );
+});
diff --git a/server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.ts b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.ts
new file mode 100644
index 00000000..be7ac766
--- /dev/null
+++ b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionCompatibility.ts
@@ -0,0 +1,443 @@
+import type {
+  CreatorIntentReadiness,
+  CustomWorldAgentStage,
+  CustomWorldAssetCoverageSummary,
+  CustomWorldPendingClarification,
+} from '../../../../packages/shared/src/contracts/customWorldAgent.js';
+import {
+  buildPendingClarifications,
+  evaluateCreatorIntentReadiness,
+  resolveCreatorIntentStage,
+} from '../customWorldAgentClarificationService.js';
+import {
+  normalizeCreatorIntentRecord,
+} from '../customWorldAgentIntentExtractionService.js';
+import { rebuildRoleAssetCoverage } from '../customWorldAgentRoleAssetStateService.js';
+import {
+  buildAnchorPackFromEightAnchorContent,
+  buildCreatorIntentFromEightAnchorContent,
+  buildDraftSummaryFromEightAnchorContent,
+  buildDraftTitleFromEightAnchorContent,
+  buildEightAnchorContentFromCreatorIntent,
+  estimateProgressPercentFromAnchorContent,
+  normalizeEightAnchorContent,
+} from '../eightAnchorCompatibilityService.js';
+import {
+  CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX,
+  type CustomWorldAgentSessionRecord,
+} from './rpgAgentSessionRecord.js';
+
+function toRecord(value: unknown) {
+  return value && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : null;
+}
+
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function isStage(value: unknown): value is CustomWorldAgentStage {
+  return (
+    value === 'collecting_intent' ||
+    value === 'clarifying' ||
+    value === 'foundation_review' ||
+    value === 'object_refining' ||
+    value === 'visual_refining' ||
+    value === 'long_tail_review' ||
+    value === 'ready_to_publish' ||
+    value === 'published' ||
+    value === 'error'
+  );
+}
+
+export function isCustomWorldAgentSessionRecord(
+  value: unknown,
+): value is CustomWorldAgentSessionRecord {
+  const record = toRecord(value);
+  if (!record) {
+    return false;
+  }
+
+  return (
+    typeof record.sessionId === 'string' &&
+    record.sessionId.startsWith(CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX) &&
+    typeof record.userId === 'string' &&
+    isStage(record.stage) &&
+    Array.isArray(record.messages) &&
+    Array.isArray(record.operations) &&
+    typeof record.createdAt === 'string' &&
+    typeof record.updatedAt === 'string'
+  );
+}
+
+function isCreatorIntentReadiness(
+  value: unknown,
+): value is CreatorIntentReadiness {
+  const record = toRecord(value);
+  if (!record) {
+    return false;
+  }
+
+  return (
+    typeof record.isReady === 'boolean' &&
+    Array.isArray(record.completedKeys) &&
+    Array.isArray(record.missingKeys)
+  );
+}
+
+function mapLegacyClarificationTargetKey(id: string) {
+  if (id === 'world_hook') return 'world_hook';
+  if (id === 'player_premise') return 'player_premise';
+  if (id === 'theme_and_tone' || id === 'tone_boundary') {
+    return 'theme_and_tone';
+  }
+  if (id === 'core_conflict') return 'core_conflict';
+  if (id === 'relationship_seed' || id === 'relationship_hook') {
+    return 'relationship_seed';
+  }
+  if (id === 'iconic_element' || id === 'iconic_elements') {
+    return 'iconic_element';
+  }
+
+  return null;
+}
+
+function hasUserInput(record: CustomWorldAgentSessionRecord) {
+  return (
+    Boolean(record.seedText.trim()) ||
+    record.messages.some(
+      (message) => message.role === 'user' && message.text.trim(),
+    )
+  );
+}
+
+function buildCompatibleCreatorIntent(record: CustomWorldAgentSessionRecord) {
+  const compatibleAnchorIntent = buildCreatorIntentFromEightAnchorContent(
+    normalizeEightAnchorContent(
+      (record as Record<string, unknown>).anchorContent ?? null,
+    ),
+  );
+
+  if (
+    compatibleAnchorIntent &&
+    (compatibleAnchorIntent.worldHook ||
+      compatibleAnchorIntent.rawSettingText ||
+      compatibleAnchorIntent.playerPremise ||
+      compatibleAnchorIntent.openingSituation ||
+      compatibleAnchorIntent.coreConflicts.length > 0 ||
+      compatibleAnchorIntent.keyCharacters.length > 0 ||
+      compatibleAnchorIntent.iconicElements.length > 0)
+  ) {
+    return compatibleAnchorIntent;
+  }
+
+  return normalizeCreatorIntentRecord(record.creatorIntent);
+}
+
+function buildCompatibleCurrentTurn(record: CustomWorldAgentSessionRecord) {
+  if (typeof (record as Record<string, unknown>).currentTurn === 'number') {
+    return Math.max(
+      0,
+      Math.round((record as Record<string, unknown>).currentTurn as number),
+    );
+  }
+
+  return record.messages.filter((message) => message.role === 'user').length;
+}
+
+function buildCompatibleAnchorContent(record: CustomWorldAgentSessionRecord) {
+  const normalized = normalizeEightAnchorContent(
+    (record as Record<string, unknown>).anchorContent ?? null,
+  );
+
+  if (
+    normalized.worldPromise ||
+    normalized.playerFantasy ||
+    normalized.themeBoundary ||
+    normalized.playerEntryPoint ||
+    normalized.coreConflict ||
+    normalized.keyRelationships.length > 0 ||
+    normalized.hiddenLines ||
+    normalized.iconicElements
+  ) {
+    return normalized;
+  }
+
+  return buildEightAnchorContentFromCreatorIntent(
+    buildCompatibleCreatorIntent(record),
+  );
+}
+
+function buildCompatibleProgressPercent(record: CustomWorldAgentSessionRecord) {
+  const rawProgress = (record as Record<string, unknown>).progressPercent;
+  if (typeof rawProgress === 'number' && Number.isFinite(rawProgress)) {
+    return Math.max(0, Math.min(100, Math.round(rawProgress)));
+  }
+
+  if (
+    record.stage === 'foundation_review' ||
+    record.stage === 'object_refining' ||
+    record.stage === 'visual_refining' ||
+    record.stage === 'long_tail_review' ||
+    record.stage === 'ready_to_publish' ||
+    record.stage === 'published'
+  ) {
+    return 100;
+  }
+
+  return estimateProgressPercentFromAnchorContent(
+    buildCompatibleAnchorContent(record),
+  );
+}
+
+function buildCompatibleLastAssistantReply(record: CustomWorldAgentSessionRecord) {
+  const existingReply = (record as Record<string, unknown>).lastAssistantReply;
+  if (typeof existingReply === 'string') {
+    return existingReply;
+  }
+
+  const lastAssistantMessage = [...record.messages]
+    .reverse()
+    .find((message) => message.role === 'assistant' && message.text.trim());
+
+  return lastAssistantMessage?.text ?? null;
+}
+
+function buildCompatiblePendingClarifications(
+  record: CustomWorldAgentSessionRecord,
+) {
+  const normalizedIntent = normalizeCreatorIntentRecord(record.creatorIntent);
+  const readiness = buildCompatibleReadiness(record);
+  const legacyClarifications = Array.isArray(record.pendingClarifications)
+    ? record.pendingClarifications
+    : [];
+
+  const nextClarifications = legacyClarifications
+    .map((entry, index) => {
+      const targetKey = mapLegacyClarificationTargetKey(entry.id);
+      if (!targetKey) {
+        return null;
+      }
+
+      return {
+        id: entry.id || targetKey,
+        label: entry.label || '待补充问题',
+        question: entry.question || '',
+        targetKey,
+        priority:
+          typeof entry.priority === 'number' ? entry.priority : index + 1,
+        answer: entry.answer,
+      } satisfies CustomWorldPendingClarification;
+    })
+    .filter((entry): entry is CustomWorldPendingClarification =>
+      Boolean(entry?.question),
+    )
+    .slice(0, 3);
+
+  if (nextClarifications.length > 0) {
+    return nextClarifications;
+  }
+
+  return buildPendingClarifications(normalizedIntent, readiness);
+}
+
+function buildCompatibleReadiness(record: CustomWorldAgentSessionRecord) {
+  if (
+    isCreatorIntentReadiness(
+      (record as Record<string, unknown>).creatorIntentReadiness,
+    )
+  ) {
+    return record.creatorIntentReadiness;
+  }
+
+  return evaluateCreatorIntentReadiness(
+    normalizeCreatorIntentRecord(record.creatorIntent),
+  );
+}
+
+function buildCompatibleDraftProfile(
+  record: CustomWorldAgentSessionRecord,
+) {
+  const anchorContent = buildCompatibleAnchorContent(record);
+  const existingDraftProfile = toRecord(record.draftProfile);
+  const hasFoundationContent = Boolean(
+    existingDraftProfile &&
+      (typeof existingDraftProfile.name === 'string' ||
+        Array.isArray(existingDraftProfile.playableNpcs) ||
+        Array.isArray(existingDraftProfile.landmarks) ||
+        Array.isArray(existingDraftProfile.factions) ||
+        Array.isArray(existingDraftProfile.threads) ||
+        Array.isArray(existingDraftProfile.chapters)),
+  );
+
+  if (hasFoundationContent) {
+    return {
+      ...existingDraftProfile,
+      name:
+        toText(existingDraftProfile?.name) ||
+        toText(existingDraftProfile?.title) ||
+        buildDraftTitleFromEightAnchorContent(anchorContent),
+      summary:
+        toText(existingDraftProfile?.summary) ||
+        buildDraftSummaryFromEightAnchorContent(anchorContent),
+    };
+  }
+
+  return {
+    ...(existingDraftProfile ?? {}),
+    title:
+      toText(existingDraftProfile?.title) ||
+      buildDraftTitleFromEightAnchorContent(anchorContent),
+    summary:
+      toText(existingDraftProfile?.summary) ||
+      buildDraftSummaryFromEightAnchorContent(anchorContent),
+  };
+}
+
+function buildCompatibleSuggestedActions(params: {
+  record: CustomWorldAgentSessionRecord;
+  stage: CustomWorldAgentStage;
+  readiness: CreatorIntentReadiness;
+}) {
+  if (params.record.suggestedActions.length > 0) {
+    // 旧快照里可能带有“精修对象”的 Agent 建议动作；当前 Agent 对话框只服务八锚点收集。
+    const compatibleActions = params.record.suggestedActions.filter(
+      (action) => action.type !== 'refine_focus_target',
+    );
+    if (compatibleActions.length > 0) {
+      return compatibleActions;
+    }
+  }
+
+  const actions = [
+    {
+      id: 'request_summary',
+      type: 'request_summary',
+      label:
+        params.stage === 'object_refining' || params.stage === 'visual_refining'
+          ? '总结当前世界底稿'
+          : '总结当前设定',
+    },
+  ] as CustomWorldAgentSessionRecord['suggestedActions'];
+
+  if (params.stage === 'foundation_review' && params.readiness.isReady) {
+    actions.push({
+      id: 'draft_foundation',
+      type: 'draft_foundation',
+      label: '整理一版世界底稿',
+    });
+  }
+
+  return actions;
+}
+
+function normalizeRecommendedReplies(value: unknown) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  return value
+    .map((item) => toText(item))
+    .filter(Boolean)
+    .slice(0, 3);
+}
+
+function buildCompatibleAssetCoverage(
+  record: CustomWorldAgentSessionRecord,
+  draftProfile: Record<string, unknown>,
+) {
+  const derivedCoverage = rebuildRoleAssetCoverage(draftProfile);
+  const existingCoverage = toRecord(record.assetCoverage);
+  const sceneAssets =
+    derivedCoverage.sceneAssets.length > 0
+      ? derivedCoverage.sceneAssets
+      : Array.isArray(existingCoverage?.sceneAssets)
+        ? existingCoverage.sceneAssets
+        : [];
+  const allSceneAssetsReady =
+    derivedCoverage.sceneAssets.length > 0
+      ? derivedCoverage.allSceneAssetsReady
+      : typeof existingCoverage?.allSceneAssetsReady === 'boolean'
+        ? existingCoverage.allSceneAssetsReady
+        : false;
+
+  return {
+    ...derivedCoverage,
+    sceneAssets,
+    allSceneAssetsReady,
+  } satisfies CustomWorldAssetCoverageSummary;
+}
+
+/**
+ * 兼容层集中收口旧 session 字段兜底，避免继续把兼容判断散落回 store 主逻辑。
+ */
+export function applyCustomWorldAgentSessionCompatibility(
+  record: CustomWorldAgentSessionRecord,
+) {
+  const creatorIntent = buildCompatibleCreatorIntent(record);
+  const currentTurn = buildCompatibleCurrentTurn(record);
+  const anchorContent = buildCompatibleAnchorContent(record);
+  const progressPercent = buildCompatibleProgressPercent(record);
+  const lastAssistantReply = buildCompatibleLastAssistantReply(record);
+  const creatorIntentReadiness =
+    progressPercent >= 100
+      ? {
+          isReady: true,
+          completedKeys: [
+            'world_hook',
+            'player_premise',
+            'theme_and_tone',
+            'core_conflict',
+            'relationship_seed',
+            'iconic_element',
+          ],
+          missingKeys: [],
+        }
+      : evaluateCreatorIntentReadiness(creatorIntent);
+  const stage =
+    record.stage === 'object_refining' ||
+    record.stage === 'visual_refining' ||
+    record.stage === 'long_tail_review' ||
+    record.stage === 'ready_to_publish' ||
+    record.stage === 'published'
+      ? record.stage
+      : progressPercent >= 100
+        ? ('foundation_review' as const)
+        : resolveCreatorIntentStage({
+            hasUserInput: hasUserInput(record),
+            readiness: creatorIntentReadiness,
+          });
+  const pendingClarifications = buildCompatiblePendingClarifications({
+    ...record,
+    creatorIntent,
+    creatorIntentReadiness,
+  });
+  const draftProfile = buildCompatibleDraftProfile(record);
+
+  return {
+    ...record,
+    currentTurn,
+    anchorContent,
+    progressPercent,
+    lastAssistantReply,
+    stage,
+    creatorIntent,
+    creatorIntentReadiness,
+    anchorPack:
+      record.anchorPack && Object.keys(record.anchorPack).length > 0
+        ? record.anchorPack
+        : buildAnchorPackFromEightAnchorContent(anchorContent, progressPercent),
+    draftProfile,
+    pendingClarifications,
+    suggestedActions: buildCompatibleSuggestedActions({
+      record,
+      stage,
+      readiness: creatorIntentReadiness,
+    }),
+    assetCoverage: buildCompatibleAssetCoverage(record, draftProfile),
+    recommendedReplies: normalizeRecommendedReplies(
+      (record as Record<string, unknown>).recommendedReplies,
+    ),
+  } satisfies CustomWorldAgentSessionRecord;
+}
diff --git a/server-node/src/services/rpg-agent-session-store/rpgAgentSessionFactory.ts b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionFactory.ts
new file mode 100644
index 00000000..aeaaebd2
--- /dev/null
+++ b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionFactory.ts
@@ -0,0 +1,74 @@
+import crypto from 'node:crypto';
+
+import type { CustomWorldAgentMessage } from '../../../../packages/shared/src/contracts/customWorldAgent.js';
+import { rebuildRoleAssetCoverage } from '../customWorldAgentRoleAssetStateService.js';
+import {
+  createEmptyEightAnchorContent,
+  normalizeEightAnchorContent,
+} from '../eightAnchorCompatibilityService.js';
+import { applyCustomWorldAgentSessionCompatibility } from './rpgAgentSessionCompatibility.js';
+import {
+  cloneRpgAgentSessionValue,
+  type CreateCustomWorldAgentSessionInput,
+  type CustomWorldAgentSessionRecord,
+  CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX,
+} from './rpgAgentSessionRecord.js';
+
+/**
+ * 新建 session 的初始值统一在这里生成，后续 store 只负责持久化与状态变更。
+ */
+export function createCustomWorldAgentSessionRecord(
+  userId: string,
+  input: CreateCustomWorldAgentSessionInput,
+) {
+  const sessionId = `${CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX}${crypto.randomBytes(16).toString('hex')}`;
+  const now = new Date().toISOString();
+  const welcomeMessage: CustomWorldAgentMessage = {
+    id: `message-${crypto.randomBytes(8).toString('hex')}`,
+    role: 'assistant',
+    kind: 'chat',
+    text: input.welcomeMessage,
+    createdAt: now,
+    relatedOperationId: null,
+  };
+  const record: CustomWorldAgentSessionRecord = {
+    sessionId,
+    userId,
+    seedText: input.seedText?.trim() ?? '',
+    currentTurn: Math.max(0, Math.round(input.currentTurn ?? 0)),
+    anchorContent: normalizeEightAnchorContent(
+      input.anchorContent ?? createEmptyEightAnchorContent(),
+    ),
+    progressPercent: Math.max(
+      0,
+      Math.min(100, Math.round(input.progressPercent ?? 0)),
+    ),
+    lastAssistantReply: input.lastAssistantReply ?? input.welcomeMessage,
+    stage: input.stage ?? 'collecting_intent',
+    focusCardId: null,
+    creatorIntent: cloneRpgAgentSessionValue(input.creatorIntent ?? {}),
+    creatorIntentReadiness: input.creatorIntentReadiness ?? {
+      isReady: false,
+      completedKeys: [],
+      missingKeys: [],
+    },
+    anchorPack: cloneRpgAgentSessionValue(input.anchorPack ?? {}),
+    lockState: {},
+    draftProfile: cloneRpgAgentSessionValue(input.draftProfile ?? {}),
+    messages: [welcomeMessage],
+    draftCards: [],
+    pendingClarifications: cloneRpgAgentSessionValue(
+      input.pendingClarifications,
+    ),
+    suggestedActions: cloneRpgAgentSessionValue(input.suggestedActions),
+    recommendedReplies: cloneRpgAgentSessionValue(input.recommendedReplies ?? []),
+    qualityFindings: [],
+    assetCoverage: rebuildRoleAssetCoverage(input.draftProfile ?? {}),
+    operations: [],
+    checkpoints: [],
+    createdAt: now,
+    updatedAt: now,
+  };
+
+  return applyCustomWorldAgentSessionCompatibility(record);
+}
diff --git a/server-node/src/services/rpg-agent-session-store/rpgAgentSessionRecord.ts b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionRecord.ts
new file mode 100644
index 00000000..6681c9f5
--- /dev/null
+++ b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionRecord.ts
@@ -0,0 +1,98 @@
+import type {
+  CreatorIntentReadiness,
+  CustomWorldAgentMessage,
+  CustomWorldAgentOperationRecord,
+  CustomWorldAgentStage,
+  CustomWorldAssetCoverageSummary,
+  CustomWorldDraftCardSummary,
+  CustomWorldPendingClarification,
+  CustomWorldSuggestedAction,
+  EightAnchorContent,
+} from '../../../../packages/shared/src/contracts/customWorldAgent.js';
+
+/**
+ * 当前阶段仍沿用旧 sessionId 前缀，避免影响已落库数据与前端恢复逻辑。
+ */
+export const CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX =
+  'custom-world-agent-session-';
+
+export type CustomWorldAgentSessionRecord = {
+  sessionId: string;
+  userId: string;
+  seedText: string;
+  currentTurn: number;
+  anchorContent: EightAnchorContent;
+  progressPercent: number;
+  lastAssistantReply: string | null;
+  stage: CustomWorldAgentStage;
+  focusCardId: string | null;
+  creatorIntent: Record<string, unknown> | null;
+  creatorIntentReadiness: CreatorIntentReadiness;
+  anchorPack: Record<string, unknown> | null;
+  lockState: Record<string, unknown> | null;
+  draftProfile: Record<string, unknown> | null;
+  messages: CustomWorldAgentMessage[];
+  draftCards: CustomWorldDraftCardSummary[];
+  pendingClarifications: CustomWorldPendingClarification[];
+  suggestedActions: CustomWorldSuggestedAction[];
+  recommendedReplies: string[];
+  qualityFindings: Array<{
+    id: string;
+    severity: 'info' | 'warning' | 'blocker';
+    code: string;
+    targetId?: string | null;
+    message: string;
+  }>;
+  assetCoverage: CustomWorldAssetCoverageSummary;
+  operations: CustomWorldAgentOperationRecord[];
+  checkpoints: Array<{
+    checkpointId: string;
+    createdAt: string;
+    label: string;
+    snapshot?: {
+      currentTurn: number;
+      anchorContent: EightAnchorContent;
+      progressPercent: number;
+      lastAssistantReply: string | null;
+      stage: CustomWorldAgentStage;
+      focusCardId: string | null;
+      creatorIntent: Record<string, unknown> | null;
+      creatorIntentReadiness: CreatorIntentReadiness;
+      anchorPack: Record<string, unknown> | null;
+      lockState: Record<string, unknown> | null;
+      draftProfile: Record<string, unknown> | null;
+      pendingClarifications: CustomWorldAgentSessionRecord['pendingClarifications'];
+      suggestedActions: CustomWorldAgentSessionRecord['suggestedActions'];
+      recommendedReplies: string[];
+      draftCards: CustomWorldDraftCardSummary[];
+      qualityFindings: CustomWorldAgentSessionRecord['qualityFindings'];
+      assetCoverage: CustomWorldAssetCoverageSummary;
+    } | null;
+  }>;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type CreateCustomWorldAgentSessionInput = {
+  seedText?: string;
+  welcomeMessage: string;
+  currentTurn?: number;
+  anchorContent?: EightAnchorContent;
+  progressPercent?: number;
+  lastAssistantReply?: string | null;
+  pendingClarifications: CustomWorldAgentSessionRecord['pendingClarifications'];
+  creatorIntent?: CustomWorldAgentSessionRecord['creatorIntent'];
+  creatorIntentReadiness?: CreatorIntentReadiness;
+  anchorPack?: CustomWorldAgentSessionRecord['anchorPack'];
+  draftProfile?: CustomWorldAgentSessionRecord['draftProfile'];
+  stage?: CustomWorldAgentStage;
+  suggestedActions: CustomWorldSuggestedAction[];
+  recommendedReplies?: string[];
+};
+
+/**
+ * session 记录里大量字段都是 JSON 结构，统一走结构化克隆可避免调用方误共享引用。
+ */
+export function cloneRpgAgentSessionValue<T>(value: T): T {
+  return JSON.parse(JSON.stringify(value)) as T;
+}
diff --git a/server-node/src/services/rpg-agent-session-store/rpgAgentSessionRepositoryAdapter.ts b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionRepositoryAdapter.ts
new file mode 100644
index 00000000..76153a53
--- /dev/null
+++ b/server-node/src/services/rpg-agent-session-store/rpgAgentSessionRepositoryAdapter.ts
@@ -0,0 +1,24 @@
+import type { CustomWorldSessionRecord } from '../../../../packages/shared/src/contracts/runtime.js';
+import type { RpgAgentSessionRepositoryPort } from '../../repositories/RpgAgentSessionRepository.js';
+
+export class RpgAgentSessionRepositoryAdapter {
+  constructor(
+    private readonly repository: RpgAgentSessionRepositoryPort,
+  ) {}
+
+  async list(userId: string) {
+    return this.repository.listSessions(userId);
+  }
+
+  async get(userId: string, sessionId: string) {
+    return this.repository.getSession(userId, sessionId);
+  }
+
+  async upsert(
+    userId: string,
+    sessionId: string,
+    session: CustomWorldSessionRecord,
+  ) {
+    return this.repository.upsertSession(userId, sessionId, session);
+  }
+}
diff --git a/server-node/src/services/rpgCreationPreviewProfileBuilder.ts b/server-node/src/services/rpgCreationPreviewProfileBuilder.ts
new file mode 100644
index 00000000..8dc76492
--- /dev/null
+++ b/server-node/src/services/rpgCreationPreviewProfileBuilder.ts
@@ -0,0 +1,349 @@
+import type { CustomWorldProfileRecord } from '../../../packages/shared/src/contracts/runtime.js';
+import { buildRpgWorldPreviewProfile } from './RpgWorldPreviewCompiler.js';
+import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
+
+function toText(value: unknown) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function toRecordArray(value: unknown) {
+  return Array.isArray(value)
+    ? value.filter(
+        (entry): entry is Record<string, unknown> =>
+          Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry),
+      )
+    : [];
+}
+
+function cloneRecord<T extends Record<string, unknown>>(value: T): T {
+  return JSON.parse(JSON.stringify(value)) as T;
+}
+
+function normalizeMatchText(value: unknown) {
+  return toText(value).toLocaleLowerCase();
+}
+
+function findUnusedMatchIndex(
+  records: Record<string, unknown>[],
+  usedIndexes: Set<number>,
+  matcher: (record: Record<string, unknown>) => boolean,
+) {
+  const matchedIndex = records.findIndex(
+    (record, index) => !usedIndexes.has(index) && matcher(record),
+  );
+  if (matchedIndex >= 0) {
+    usedIndexes.add(matchedIndex);
+  }
+  return matchedIndex;
+}
+
+function mergeDraftRolesIntoProfileRecord(params: {
+  baseRoles: unknown;
+  draftRoles: Array<Record<string, unknown>>;
+}) {
+  const baseRoles = toRecordArray(params.baseRoles);
+  if (params.draftRoles.length <= 0) {
+    return baseRoles;
+  }
+
+  const usedIndexes = new Set<number>();
+  return params.draftRoles.map((draftRole) => {
+    let matchedIndex = findUnusedMatchIndex(
+      baseRoles,
+      usedIndexes,
+      (record) => toText(record.id) === toText(draftRole.id),
+    );
+
+    if (matchedIndex < 0) {
+      matchedIndex = findUnusedMatchIndex(
+        baseRoles,
+        usedIndexes,
+        (record) =>
+          normalizeMatchText(record.name) === normalizeMatchText(draftRole.name),
+      );
+    }
+
+    const baseRole = matchedIndex >= 0 ? baseRoles[matchedIndex] : null;
+    return {
+      ...(baseRole ?? {}),
+      ...draftRole,
+      imageSrc: toText(draftRole.imageSrc) || toText(baseRole?.imageSrc) || undefined,
+      generatedVisualAssetId:
+        toText(draftRole.generatedVisualAssetId) ||
+        toText(baseRole?.generatedVisualAssetId) ||
+        undefined,
+      generatedAnimationSetId:
+        toText(draftRole.generatedAnimationSetId) ||
+        toText(baseRole?.generatedAnimationSetId) ||
+        undefined,
+      animationMap:
+        isRecord(draftRole.animationMap)
+          ? draftRole.animationMap
+          : isRecord(baseRole?.animationMap)
+            ? baseRole.animationMap
+            : undefined,
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function mergeDraftLandmarksIntoProfileRecord(params: {
+  baseLandmarks: unknown;
+  draftLandmarks: Array<Record<string, unknown>>;
+}) {
+  const baseLandmarks = toRecordArray(params.baseLandmarks);
+  if (params.draftLandmarks.length <= 0) {
+    return baseLandmarks;
+  }
+
+  const usedIndexes = new Set<number>();
+  return params.draftLandmarks.map((draftLandmark) => {
+    let matchedIndex = findUnusedMatchIndex(
+      baseLandmarks,
+      usedIndexes,
+      (record) => toText(record.id) === toText(draftLandmark.id),
+    );
+
+    if (matchedIndex < 0) {
+      matchedIndex = findUnusedMatchIndex(
+        baseLandmarks,
+        usedIndexes,
+        (record) =>
+          normalizeMatchText(record.name) ===
+          normalizeMatchText(draftLandmark.name),
+      );
+    }
+
+    const baseLandmark = matchedIndex >= 0 ? baseLandmarks[matchedIndex] : null;
+    return {
+      ...(baseLandmark ?? {}),
+      ...draftLandmark,
+      imageSrc:
+        toText(draftLandmark.imageSrc) || toText(baseLandmark?.imageSrc) || undefined,
+      generatedSceneAssetId:
+        toText(draftLandmark.generatedSceneAssetId) ||
+        toText(baseLandmark?.generatedSceneAssetId) ||
+        undefined,
+      generatedScenePrompt:
+        toText(draftLandmark.generatedScenePrompt) ||
+        toText(baseLandmark?.generatedScenePrompt) ||
+        undefined,
+      generatedSceneModel:
+        toText(draftLandmark.generatedSceneModel) ||
+        toText(baseLandmark?.generatedSceneModel) ||
+        undefined,
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function mergeDraftSceneChaptersIntoProfileRecord(params: {
+  baseSceneChapters: unknown;
+  draftSceneChapters: unknown;
+}) {
+  const baseSceneChapters = toRecordArray(params.baseSceneChapters);
+  const draftSceneChapters = toRecordArray(params.draftSceneChapters);
+  if (draftSceneChapters.length <= 0) {
+    return baseSceneChapters;
+  }
+
+  const usedChapterIndexes = new Set<number>();
+  return draftSceneChapters.map((draftChapter) => {
+    let matchedIndex = findUnusedMatchIndex(
+      baseSceneChapters,
+      usedChapterIndexes,
+      (record) => toText(record.sceneId) === toText(draftChapter.sceneId),
+    );
+
+    if (matchedIndex < 0) {
+      matchedIndex = findUnusedMatchIndex(
+        baseSceneChapters,
+        usedChapterIndexes,
+        (record) =>
+          normalizeMatchText(record.title) === normalizeMatchText(draftChapter.title),
+      );
+    }
+
+    const baseChapter = matchedIndex >= 0 ? baseSceneChapters[matchedIndex] : null;
+    const baseActs = toRecordArray(baseChapter?.acts);
+    const usedActIndexes = new Set<number>();
+    const mergedActs = toRecordArray(draftChapter.acts).map((draftAct) => {
+      let matchedActIndex = findUnusedMatchIndex(
+        baseActs,
+        usedActIndexes,
+        (record) => toText(record.id) === toText(draftAct.id),
+      );
+
+      if (matchedActIndex < 0) {
+        matchedActIndex = findUnusedMatchIndex(
+          baseActs,
+          usedActIndexes,
+          (record) =>
+            normalizeMatchText(record.title) ===
+            normalizeMatchText(draftAct.title),
+        );
+      }
+
+      const baseAct = matchedActIndex >= 0 ? baseActs[matchedActIndex] : null;
+      return {
+        ...(baseAct ?? {}),
+        ...draftAct,
+        backgroundImageSrc:
+          toText(draftAct.backgroundImageSrc) ||
+          toText(baseAct?.backgroundImageSrc) ||
+          undefined,
+        backgroundAssetId:
+          toText(draftAct.backgroundAssetId) ||
+          toText(baseAct?.backgroundAssetId) ||
+          undefined,
+      } satisfies Record<string, unknown>;
+    });
+
+    return {
+      ...(baseChapter ?? {}),
+      ...draftChapter,
+      acts: mergedActs,
+    } satisfies Record<string, unknown>;
+  });
+}
+
+function mergeDraftCampIntoProfileRecord(params: {
+  baseCamp: unknown;
+  draftCamp: unknown;
+}) {
+  const draftCamp = isRecord(params.draftCamp) ? params.draftCamp : null;
+  if (!draftCamp) {
+    return isRecord(params.baseCamp) ? params.baseCamp : undefined;
+  }
+
+  const baseCamp = isRecord(params.baseCamp) ? params.baseCamp : null;
+  return {
+    ...(baseCamp ?? {}),
+    ...draftCamp,
+    imageSrc: toText(draftCamp.imageSrc) || toText(baseCamp?.imageSrc) || undefined,
+    generatedSceneAssetId:
+      toText(draftCamp.generatedSceneAssetId) ||
+      toText(baseCamp?.generatedSceneAssetId) ||
+      undefined,
+    generatedScenePrompt:
+      toText(draftCamp.generatedScenePrompt) ||
+      toText(baseCamp?.generatedScenePrompt) ||
+      undefined,
+    generatedSceneModel:
+      toText(draftCamp.generatedSceneModel) ||
+      toText(baseCamp?.generatedSceneModel) ||
+      undefined,
+  } satisfies Record<string, unknown>;
+}
+
+function buildPreviewRawProfileSeed(params: {
+  sessionId: string;
+  profileId: string;
+  draftProfile: Record<string, unknown>;
+}) {
+  const foundationDraft = normalizeFoundationDraftProfile(params.draftProfile);
+  if (!foundationDraft) {
+    throw new Error('当前世界草稿为空，无法构建结果页预览。');
+  }
+
+  const legacyResultProfile = isRecord(params.draftProfile.legacyResultProfile)
+    ? cloneRecord(params.draftProfile.legacyResultProfile)
+    : null;
+
+  const baseProfile = legacyResultProfile ?? {
+    id: params.profileId,
+    settingText: foundationDraft.worldHook,
+    name: foundationDraft.name,
+    subtitle: foundationDraft.subtitle,
+    summary: foundationDraft.summary,
+    tone: foundationDraft.tone,
+    playerGoal: foundationDraft.playerGoal,
+    templateWorldType: 'WUXIA',
+    majorFactions: foundationDraft.majorFactions,
+    coreConflicts: foundationDraft.coreConflicts,
+    playableNpcs: [],
+    storyNpcs: [],
+    items: [],
+    landmarks: [],
+    camp: null,
+    sceneChapterBlueprints: [],
+    generationMode: 'full',
+    generationStatus: 'complete',
+  };
+
+  return {
+    ...baseProfile,
+    id: params.profileId,
+    settingText:
+      toText(baseProfile.settingText) || foundationDraft.worldHook || foundationDraft.summary,
+    name: foundationDraft.name,
+    subtitle: foundationDraft.subtitle,
+    summary: foundationDraft.summary,
+    tone: foundationDraft.tone,
+    playerGoal: foundationDraft.playerGoal,
+    majorFactions: foundationDraft.majorFactions,
+    coreConflicts: foundationDraft.coreConflicts,
+    playableNpcs: mergeDraftRolesIntoProfileRecord({
+      baseRoles: baseProfile.playableNpcs,
+      draftRoles: toRecordArray(params.draftProfile.playableNpcs),
+    }),
+    storyNpcs: mergeDraftRolesIntoProfileRecord({
+      baseRoles: baseProfile.storyNpcs,
+      draftRoles: toRecordArray(params.draftProfile.storyNpcs),
+    }),
+    landmarks: mergeDraftLandmarksIntoProfileRecord({
+      baseLandmarks: baseProfile.landmarks,
+      draftLandmarks: toRecordArray(params.draftProfile.landmarks),
+    }),
+    camp: mergeDraftCampIntoProfileRecord({
+      baseCamp: baseProfile.camp,
+      draftCamp: params.draftProfile.camp,
+    }),
+    sceneChapterBlueprints: mergeDraftSceneChaptersIntoProfileRecord({
+      baseSceneChapters: baseProfile.sceneChapterBlueprints,
+      draftSceneChapters: params.draftProfile.sceneChapters,
+    }),
+    creatorIntent:
+      (params.draftProfile.creatorIntent as Record<string, unknown> | undefined) ??
+      (baseProfile.creatorIntent as Record<string, unknown> | undefined) ??
+      null,
+    anchorPack:
+      (params.draftProfile.anchorPack as Record<string, unknown> | undefined) ??
+      (baseProfile.anchorPack as Record<string, unknown> | undefined) ??
+      null,
+    lockState:
+      (params.draftProfile.lockState as Record<string, unknown> | undefined) ??
+      (baseProfile.lockState as Record<string, unknown> | undefined) ??
+      null,
+    generationMode: 'full',
+    generationStatus: 'complete',
+  } satisfies Record<string, unknown>;
+}
+
+/**
+ * 结果页预览与正式发布统一走同一套“foundation draft + legacy 富字段合并”规则，
+ * 这样 Phase5 才能安全删除前端本地 fallback 编译桥。
+ */
+export function buildRpgCreationPreviewProfileFromDraftProfile(params: {
+  sessionId: string;
+  draftProfile: Record<string, unknown>;
+  profileId?: string;
+}) {
+  const profileId =
+    toText(params.profileId) ||
+    toText(params.draftProfile.legacyResultProfile?.id) ||
+    `agent-draft-${params.sessionId}`;
+  const mergedProfile = buildPreviewRawProfileSeed({
+    sessionId: params.sessionId,
+    profileId,
+    draftProfile: params.draftProfile,
+  });
+
+  return buildRpgWorldPreviewProfile(
+    mergedProfile,
+    toText(mergedProfile.settingText) || '',
+  ) as unknown as CustomWorldProfileRecord;
+}
+
diff --git a/server-node/src/services/runtimeItemService.ts b/server-node/src/services/runtimeItemService.ts
index 20b9bdfd..c8a21f7c 100644
--- a/server-node/src/services/runtimeItemService.ts
+++ b/server-node/src/services/runtimeItemService.ts
@@ -1,10 +1,10 @@
 import {
   RUNTIME_ITEM_FUNCTIONAL_BIAS_VALUES,
   RUNTIME_ITEM_TONE_VALUES,
-} from '../../../packages/shared/src/contracts/story.js';
+} from '../../../packages/shared/src/contracts/rpgRuntimeQuestAssist.js';
 import type {
   RuntimeItemIntentRequest,
-} from '../../../packages/shared/src/contracts/story.js';
+} from '../../../packages/shared/src/contracts/rpgRuntimeQuestAssist.js';
 import { parseJsonResponseText } from '../../../packages/shared/src/llm/parsers.js';
 import {
   buildRuntimeItemAiIntent,
diff --git a/server-node/src/services/storyService.ts b/server-node/src/services/storyService.ts
index fed1348e..e2a66612 100644
--- a/server-node/src/services/storyService.ts
+++ b/server-node/src/services/storyService.ts
@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import type { StoryRequestPayload } from '../../../packages/shared/src/contracts/story.js';
+import type { StoryRequestPayload } from '../../../packages/shared/src/contracts/rpgRuntimeChat.js';
 import {
   generateInitialStoryFromOrchestrator,
   generateNextStoryFromOrchestrator,
diff --git a/src/App.tsx b/src/App.tsx
index e780ec78..dc7ec6de 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -1,8 +1,8 @@
-import { GameShellRuntime } from './components/game-shell/GameShellRuntime.tsx';
-import { useGameShellRuntime } from './hooks/useGameShellRuntime';
+import { RpgRuntimeShell } from './components/rpg-runtime-shell';
+import { useRpgRuntimeSession } from './hooks/rpg-session';
 
 export default function App() {
-  const gameShellProps = useGameShellRuntime();
+  const gameShellProps = useRpgRuntimeSession();
 
-  return <GameShellRuntime {...gameShellProps} />;
+  return <RpgRuntimeShell {...gameShellProps} />;
 }
diff --git a/src/components/AdventureEntityModal.tsx b/src/components/AdventureEntityModal.tsx
index a531d811..034c282c 100644
--- a/src/components/AdventureEntityModal.tsx
+++ b/src/components/AdventureEntityModal.tsx
@@ -46,7 +46,7 @@ import {
 } from '../data/npcInteractions';
 import { normalizePlayerProgressionState } from '../data/playerProgression';
 import { getSceneHostileNpcPresetIds } from '../data/scenePresets';
-import type { CharacterChatTarget } from '../hooks/useStoryGeneration';
+import type { CharacterChatTarget } from '../hooks/rpg-runtime-story';
 import { getResourceLabelsForWorld } from '../services/customWorldPresentation';
 import {
   AnimationState,
diff --git a/src/components/CharacterChatModal.tsx b/src/components/CharacterChatModal.tsx
index dadcdaf6..5892f8c5 100644
--- a/src/components/CharacterChatModal.tsx
+++ b/src/components/CharacterChatModal.tsx
@@ -1,7 +1,7 @@
 import { AnimatePresence, motion } from 'motion/react';
 import { useEffect, useRef } from 'react';
 
-import type { CharacterChatModalState } from '../hooks/useStoryGeneration';
+import type { CharacterChatModalState } from '../hooks/rpg-runtime-story';
 import { CHROME_ICONS, getNineSliceStyle, UI_CHROME } from '../uiAssets';
 import { PixelIcon } from './PixelIcon';
 
diff --git a/src/components/CharacterPanel.tsx b/src/components/CharacterPanel.tsx
index 3475aeea..404253e2 100644
--- a/src/components/CharacterPanel.tsx
+++ b/src/components/CharacterPanel.tsx
@@ -27,7 +27,7 @@ import {
   getEquipmentSlotLabel,
 } from '../data/equipmentEffects';
 import { buildMedievalNpcVisualFromCustomWorldVisual } from '../data/medievalNpcVisuals';
-import type { CharacterChatTarget } from '../hooks/useStoryGeneration';
+import type { CharacterChatTarget } from '../hooks/rpg-runtime-story';
 import { getResourceLabelsForWorld } from '../services/customWorldPresentation';
 import {
   AnimationState,
diff --git a/src/components/CustomWorldEntityCatalog.tsx b/src/components/CustomWorldEntityCatalog.tsx
index 1027b8eb..0972f933 100644
--- a/src/components/CustomWorldEntityCatalog.tsx
+++ b/src/components/CustomWorldEntityCatalog.tsx
@@ -29,7 +29,7 @@ import {
 } from '../types';
 import { CharacterAnimator } from './CharacterAnimator';
 import { CustomWorldCoverArtwork } from './CustomWorldCoverArtwork';
-import type { CustomWorldEditorTarget } from './CustomWorldEntityEditorModal';
+import type { RpgCreationEditorTarget } from './rpg-creation-editor/RpgCreationEntityEditorModal';
 import { CustomWorldNpcPortrait } from './CustomWorldNpcVisualEditor';
 
 export type ResultTab = 'world' | 'playable' | 'story' | 'landmarks';
@@ -49,7 +49,7 @@ interface CustomWorldEntityCatalogProps {
   previewCharacters: Character[];
   activeTab: ResultTab;
   onActiveTabChange: (tab: ResultTab) => void;
-  onEditTarget: (target: CustomWorldEditorTarget) => void;
+  onEditTarget: (target: RpgCreationEditorTarget) => void;
   onProfileChange: (profile: CustomWorldProfile) => void;
   onDeleteStoryNpcs?: (ids: string[]) => void;
   onDeleteLandmarks?: (ids: string[]) => void;
diff --git a/src/components/CustomWorldEntityEditorModal.test.tsx b/src/components/CustomWorldEntityEditorModal.test.tsx
index 5d25c973..d73301b1 100644
--- a/src/components/CustomWorldEntityEditorModal.test.tsx
+++ b/src/components/CustomWorldEntityEditorModal.test.tsx
@@ -12,10 +12,11 @@ import type {
 } from '../types';
 import { CustomWorldEntityCatalog } from './CustomWorldEntityCatalog';
 import {
-  type CustomWorldEditorTarget,
-  CustomWorldEntityEditorModal,
-} from './CustomWorldEntityEditorModal';
+  type RpgCreationEditorTarget,
+  RpgCreationEntityEditorModal,
+} from './rpg-creation-editor/RpgCreationEntityEditorModal';
 import * as customWorldCoverAssetService from '../services/customWorldCoverAssetService';
+import * as rpgCreationAssetClient from '../services/rpg-creation/rpgCreationAssetClient';
 
 vi.mock('../data/characterPresets', async () => {
   const actual = await vi.importActual<typeof import('../data/characterPresets')>(
@@ -37,12 +38,23 @@ vi.mock('./CharacterAnimator', () => ({
   CharacterAnimator: () => <div>角色预览</div>,
 }));
 
-vi.mock('../services/aiService', () => ({
-  generateCustomWorldSceneImage: vi.fn(),
-  generateCustomWorldSceneNpc: vi.fn(),
-  generateInitialStory: vi.fn(),
-  generateNextStep: vi.fn(),
-}));
+vi.mock('../services/rpg-creation/rpgCreationAssetClient', () => {
+  const generateSceneImage = vi.fn();
+  const generateSceneNpc = vi.fn();
+
+  return {
+    rpgCreationAssetClient: {
+      generateSceneImage,
+      generateSceneNpc,
+    },
+    generateCustomWorldSceneImage: generateSceneImage,
+    generateCustomWorldSceneNpc: generateSceneNpc,
+  };
+});
+
+const mockedRpgCreationAssetClient = vi.mocked(
+  rpgCreationAssetClient.rpgCreationAssetClient,
+);
 
 vi.mock('./CustomWorldNpcVisualEditor', () => ({
   CustomWorldNpcPortrait: ({ npc }: { npc: { name: string } }) => (
@@ -51,8 +63,8 @@ vi.mock('./CustomWorldNpcVisualEditor', () => ({
   CustomWorldNpcVisualEditor: () => <div>预设形象编辑器</div>,
 }));
 
-vi.mock('./game-shell/GameShellRuntime', () => ({
-  GameShellRuntime: ({
+vi.mock('./rpg-runtime-shell', () => ({
+  RpgRuntimeShell: ({
     session,
   }: {
     session: { gameState: { currentScenePreset?: { name?: string } | null } };
@@ -215,7 +227,7 @@ function createProfileWithLandmark(): CustomWorldProfile {
 
 function LandmarkEditorFlowHarness() {
   const [profile, setProfile] = useState(createProfileWithLandmark());
-  const [target, setTarget] = useState<CustomWorldEditorTarget | null>({
+  const [target, setTarget] = useState<RpgCreationEditorTarget | null>({
     kind: 'landmark',
     mode: 'edit',
     id: 'landmark-1',
@@ -236,7 +248,7 @@ function LandmarkEditorFlowHarness() {
         onDeleteStoryNpcs={() => {}}
         onDeleteLandmarks={() => {}}
       />
-      <CustomWorldEntityEditorModal
+      <RpgCreationEntityEditorModal
         profile={profile}
         target={target}
         onClose={() => setTarget(null)}
@@ -278,7 +290,7 @@ function CampEditorFlowHarness() {
       ],
     },
   });
-  const [target, setTarget] = useState<CustomWorldEditorTarget | null>({
+  const [target, setTarget] = useState<RpgCreationEditorTarget | null>({
     kind: 'camp',
   });
 
@@ -297,7 +309,7 @@ function CampEditorFlowHarness() {
         onDeleteStoryNpcs={() => {}}
         onDeleteLandmarks={() => {}}
       />
-      <CustomWorldEntityEditorModal
+      <RpgCreationEntityEditorModal
         profile={profile}
         target={target}
         onClose={() => setTarget(null)}
@@ -316,7 +328,7 @@ function CoverEditorFlowHarness() {
       characterRoleIds: ['playable-1'],
     },
   });
-  const [target, setTarget] = useState<CustomWorldEditorTarget | null>({
+  const [target, setTarget] = useState<RpgCreationEditorTarget | null>({
     kind: 'cover',
   });
 
@@ -325,7 +337,7 @@ function CoverEditorFlowHarness() {
       <pre data-testid="cover-profile-json" className="hidden">
         {JSON.stringify(profile)}
       </pre>
-      <CustomWorldEntityEditorModal
+      <RpgCreationEntityEditorModal
         profile={profile}
         target={target}
         onClose={() => setTarget(null)}
@@ -350,7 +362,7 @@ test('playable角色打开AI工坊后不会自动关闭', async () => {
   const handleClose = vi.fn();
 
   render(
-    <CustomWorldEntityEditorModal
+    <RpgCreationEntityEditorModal
       profile={createProfile()}
       target={{ kind: 'playable', mode: 'edit', id: 'playable-1' }}
       onClose={handleClose}
@@ -372,7 +384,7 @@ test('场景角色打开AI工坊后不会自动关闭', async () => {
   const handleClose = vi.fn();
 
   render(
-    <CustomWorldEntityEditorModal
+    <RpgCreationEntityEditorModal
       profile={createProfile()}
       target={{ kind: 'story', mode: 'edit', id: 'story-1' }}
       onClose={handleClose}
@@ -394,7 +406,7 @@ test('可扮演角色未修改时右上角关闭不会弹确认', async () => {
   const handleClose = vi.fn();
 
   render(
-    <CustomWorldEntityEditorModal
+    <RpgCreationEntityEditorModal
       profile={createProfile()}
       target={{ kind: 'playable', mode: 'edit', id: 'playable-1' }}
       onClose={handleClose}
@@ -413,7 +425,7 @@ test('可扮演角色修改后右上角关闭才弹确认', async () => {
   const handleClose = vi.fn();
 
   render(
-    <CustomWorldEntityEditorModal
+    <RpgCreationEntityEditorModal
       profile={createProfile()}
       target={{ kind: 'playable', mode: 'edit', id: 'playable-1' }}
       onClose={handleClose}
@@ -435,7 +447,7 @@ test('场景角色未修改时右上角关闭不会弹确认', async () => {
   const handleClose = vi.fn();
 
   render(
-    <CustomWorldEntityEditorModal
+    <RpgCreationEntityEditorModal
       profile={createProfile()}
       target={{ kind: 'story', mode: 'edit', id: 'story-1' }}
       onClose={handleClose}
@@ -454,7 +466,7 @@ test('场景角色修改后右上角关闭才弹确认', async () => {
   const handleClose = vi.fn();
 
   render(
-    <CustomWorldEntityEditorModal
+    <RpgCreationEntityEditorModal
       profile={createProfile()}
       target={{ kind: 'story', mode: 'edit', id: 'story-1' }}
       onClose={handleClose}
@@ -538,9 +550,8 @@ test('实体目录在空 id 列表项下不会触发重复 key 警告', () => {
 });
 
 test('场景图片保存后会同步更新编辑页和场景列表', async () => {
-  const aiService = await import('../services/aiService');
-  vi.mocked(aiService.generateCustomWorldSceneImage).mockClear();
-  vi.mocked(aiService.generateCustomWorldSceneImage).mockResolvedValue({
+  mockedRpgCreationAssetClient.generateSceneImage.mockClear();
+  mockedRpgCreationAssetClient.generateSceneImage.mockResolvedValue({
     imageSrc: '/generated-custom-world-scenes/updated-scene.png',
     assetId: 'asset-1',
     model: 'wan2.2-t2i-flash',
@@ -573,7 +584,7 @@ test('场景图片保存后会同步更新编辑页和场景列表', async () =>
 
   await user.click(screen.getByRole('button', { name: '开始生成' }));
   await waitFor(() => {
-    expect(aiService.generateCustomWorldSceneImage).toHaveBeenCalledTimes(1);
+    expect(mockedRpgCreationAssetClient.generateSceneImage).toHaveBeenCalledTimes(1);
   });
 
   await user.click(screen.getByRole('button', { name: '保存' }));
@@ -609,9 +620,8 @@ test('场景图片保存后会同步更新编辑页和场景列表', async () =>
 });
 
 test('开局场景图片保存后会同步更新编辑页和场景列表', async () => {
-  const aiService = await import('../services/aiService');
-  vi.mocked(aiService.generateCustomWorldSceneImage).mockClear();
-  vi.mocked(aiService.generateCustomWorldSceneImage).mockResolvedValue({
+  mockedRpgCreationAssetClient.generateSceneImage.mockClear();
+  mockedRpgCreationAssetClient.generateSceneImage.mockResolvedValue({
     imageSrc: '/generated-custom-world-scenes/updated-camp.png',
     assetId: 'asset-camp-1',
     model: 'wan2.2-t2i-flash',
@@ -644,7 +654,7 @@ test('开局场景图片保存后会同步更新编辑页和场景列表', async
 
   await user.click(screen.getByRole('button', { name: '开始生成' }));
   await waitFor(() => {
-    expect(aiService.generateCustomWorldSceneImage).toHaveBeenCalledTimes(1);
+    expect(mockedRpgCreationAssetClient.generateSceneImage).toHaveBeenCalledTimes(1);
   });
 
   await user.click(screen.getByRole('button', { name: '保存' }));
diff --git a/src/components/CustomWorldResultView.test.tsx b/src/components/CustomWorldResultView.test.tsx
index 05fe3658..7db2c2c4 100644
--- a/src/components/CustomWorldResultView.test.tsx
+++ b/src/components/CustomWorldResultView.test.tsx
@@ -6,13 +6,35 @@ import { useState } from 'react';
 import { expect, test, vi } from 'vitest';
 
 import type { CustomWorldPlayableNpc, CustomWorldProfile } from '../types';
-import { CustomWorldResultView } from './CustomWorldResultView';
+import * as rpgCreationAssetClient from '../services/rpg-creation/rpgCreationAssetClient';
+import { RpgCreationResultView } from './rpg-creation-result/RpgCreationResultView';
 
-vi.mock('../services/aiService', () => ({
-  generateCustomWorldPlayableNpc: vi.fn(),
-  generateCustomWorldStoryNpc: vi.fn(),
-  generateCustomWorldLandmark: vi.fn(),
-}));
+vi.mock('../services/rpg-creation/rpgCreationAssetClient', () => {
+  const generatePlayableNpc = vi.fn();
+  const generateStoryNpc = vi.fn();
+  const generateLandmark = vi.fn();
+  const generateSceneImage = vi.fn();
+  const generateSceneNpc = vi.fn();
+
+  return {
+    rpgCreationAssetClient: {
+      generatePlayableNpc,
+      generateStoryNpc,
+      generateLandmark,
+      generateSceneImage,
+      generateSceneNpc,
+    },
+    generateCustomWorldPlayableNpc: generatePlayableNpc,
+    generateCustomWorldStoryNpc: generateStoryNpc,
+    generateCustomWorldLandmark: generateLandmark,
+    generateCustomWorldSceneImage: generateSceneImage,
+    generateCustomWorldSceneNpc: generateSceneNpc,
+  };
+});
+
+const mockedRpgCreationAssetClient = vi.mocked(
+  rpgCreationAssetClient.rpgCreationAssetClient,
+);
 
 vi.mock('./CharacterAnimator', () => ({
   CharacterAnimator: () => <div>角色预览</div>,
@@ -24,15 +46,11 @@ vi.mock('./CustomWorldNpcVisualEditor', () => ({
   ),
 }));
 
-vi.mock('./CustomWorldEntityEditorModal', () => ({
-  CustomWorldEntityEditorModal: () => null,
+vi.mock('./rpg-creation-editor/RpgCreationEntityEditorModal', () => ({
+  RpgCreationEntityEditorModal: () => null,
   default: () => null,
 }));
 
-async function loadAiService() {
-  return import('../services/aiService');
-}
-
 function createBackstoryReveal() {
   return {
     publicSummary: '公开背景',
@@ -259,7 +277,7 @@ function ResultViewHarness() {
   const [profile, setProfile] = useState(baseProfile);
 
   return (
-    <CustomWorldResultView
+    <RpgCreationResultView
       profile={profile}
       previewCharacters={[]}
       isGenerating={false}
@@ -273,11 +291,10 @@ function ResultViewHarness() {
 }
 
 test('clicking新增可扮演角色 shows pending item, disables button, and marks result as new', async () => {
-  const aiService = await loadAiService();
   const user = userEvent.setup();
 
   let resolveGeneration: ((value: CustomWorldPlayableNpc) => void) | null = null;
-  vi.mocked(aiService.generateCustomWorldPlayableNpc).mockImplementation(
+  mockedRpgCreationAssetClient.generatePlayableNpc.mockImplementation(
     () =>
       new Promise<CustomWorldPlayableNpc>((resolve) => {
         resolveGeneration = resolve;
@@ -346,7 +363,7 @@ test('playable tab prefers generated portrait over runtime preview placeholder',
   } as CustomWorldProfile;
 
   render(
-    <CustomWorldResultView
+    <RpgCreationResultView
       profile={profile}
       previewCharacters={[
         {
@@ -403,7 +420,7 @@ test('readOnly result view hides edit and create actions for agent preview mode'
   const user = userEvent.setup();
 
   render(
-    <CustomWorldResultView
+    <RpgCreationResultView
       profile={baseProfile}
       previewCharacters={[]}
       isGenerating={false}
@@ -425,3 +442,80 @@ test('readOnly result view hides edit and create actions for agent preview mode'
   await user.click(screen.getByRole('button', { name: /场景角色/u }));
   expect(screen.queryByRole('button', { name: /批量删除/u })).toBeNull();
 });
+
+test('agent result view shows publish blockers and disables publish-enter action', () => {
+  render(
+    <RpgCreationResultView
+      profile={baseProfile}
+      previewCharacters={[]}
+      isGenerating={false}
+      progress={0}
+      progressLabel=""
+      error={null}
+      onBack={() => {}}
+      onProfileChange={() => {}}
+      compactAgentResultMode
+      publishReady={false}
+      publishBlockers={[
+        '仍有角色缺少正式主图或动作资产，发布前需要先补齐。',
+        '营地还缺少正式场景图资产，发布前需要先确认营地图。',
+      ]}
+      qualityFindings={[
+        {
+          id: 'role-assets-pending',
+          severity: 'warning',
+          code: 'role_assets_pending',
+          message: '仍有角色资产未完全补齐。',
+        },
+      ]}
+      previewSourceLabel="服务端预览"
+      enterWorldActionLabel="发布并进入世界"
+      onEnterWorld={() => {}}
+    />,
+  );
+
+  expect(screen.getByText(/当前结果页数据源：服务端预览/u)).toBeTruthy();
+  expect(screen.getByText(/当前还有 2 个发布阻断项/u)).toBeTruthy();
+  expect(
+    screen.getByText(/仍有角色缺少正式主图或动作资产/u),
+  ).toBeTruthy();
+  const actionButton = screen.getByRole('button', {
+    name: '发布并进入世界',
+  });
+  expect((actionButton as HTMLButtonElement).disabled).toBe(true);
+});
+
+test('agent result view keeps publish-enter action enabled when publish gate is clear', () => {
+  render(
+    <RpgCreationResultView
+      profile={baseProfile}
+      previewCharacters={[]}
+      isGenerating={false}
+      progress={0}
+      progressLabel=""
+      error={null}
+      onBack={() => {}}
+      onProfileChange={() => {}}
+      compactAgentResultMode
+      publishReady
+      publishBlockers={[]}
+      qualityFindings={[
+        {
+          id: 'scene-assets-pending',
+          severity: 'warning',
+          code: 'scene_assets_pending',
+          message: '仍有场景分幕图未补齐。',
+        },
+      ]}
+      previewSourceLabel="服务端预览"
+      enterWorldActionLabel="发布并进入世界"
+      onEnterWorld={() => {}}
+    />,
+  );
+
+  expect(screen.getByText(/发布后仍有 1 条 warning 可继续优化/u)).toBeTruthy();
+  const actionButton = screen.getByRole('button', {
+    name: '发布并进入世界',
+  });
+  expect((actionButton as HTMLButtonElement).disabled).toBe(false);
+});
diff --git a/src/components/CustomWorldResultView.tsx b/src/components/CustomWorldResultView.tsx
deleted file mode 100644
index ce4e89fc..00000000
--- a/src/components/CustomWorldResultView.tsx
+++ /dev/null
@@ -1,791 +0,0 @@
-import { type ReactNode, useEffect, useMemo, useRef, useState } from 'react';
-
-import { normalizeCustomWorldLandmarks } from '../data/customWorldSceneGraph';
-import {
-  generateCustomWorldLandmark,
-  generateCustomWorldPlayableNpc,
-  generateCustomWorldStoryNpc,
-} from '../services/aiService';
-import {
-  Character,
-  CustomWorldLandmark,
-  CustomWorldNpc,
-  CustomWorldPlayableNpc,
-  CustomWorldProfile,
-} from '../types';
-import {
-  CustomWorldEntityCatalog,
-  type ResultTab,
-} from './CustomWorldEntityCatalog';
-import CustomWorldEntityEditorModal, {
-  type CustomWorldEditorTarget,
-} from './CustomWorldEntityEditorModal';
-
-interface CustomWorldResultViewProps {
-  profile: CustomWorldProfile;
-  previewCharacters: Character[];
-  isGenerating: boolean;
-  progress: number;
-  progressLabel: string;
-  error: string | null;
-  onBack: () => void;
-  onEditSetting?: () => void;
-  onRegenerate?: () => void;
-  onContinueExpand?: () => void;
-  onEnterWorld?: () => void;
-  onProfileChange: (profile: CustomWorldProfile) => void;
-  readOnly?: boolean;
-  backLabel?: string;
-  editActionLabel?: string;
-  regenerateActionLabel?: string;
-  enterWorldActionLabel?: string;
-  autoSaveState?: 'idle' | 'saving' | 'saved' | 'error';
-  compactAgentResultMode?: boolean;
-}
-
-type EntityGenerationKind = 'playable' | 'story' | 'landmark';
-
-type PendingGeneratedEntity = {
-  id: string;
-  kind: EntityGenerationKind;
-  title: string;
-  progress: number;
-  phaseLabel: string;
-};
-
-type RecentGeneratedIds = Record<EntityGenerationKind, string[]>;
-
-type CustomWorldAssetDebugEntry = {
-  id: string;
-  label: string;
-  imageSrc: string;
-  kind: 'playable' | 'story' | 'landmark' | 'scene-act';
-};
-
-type AssetDebugLoadStatus = 'loading' | 'loaded' | 'error';
-
-const CUSTOM_WORLD_ASSET_DEBUG_QUERY_KEY = 'debugCustomWorldAssets';
-const CUSTOM_WORLD_ASSET_DEBUG_STORAGE_KEY =
-  'genarrative.debug.customWorldAssets';
-
-function shouldEnableCustomWorldAssetDebugPanel() {
-  if (!import.meta.env.DEV || typeof window === 'undefined') {
-    return false;
-  }
-
-  const searchParams = new URLSearchParams(window.location.search);
-  if (searchParams.get(CUSTOM_WORLD_ASSET_DEBUG_QUERY_KEY) === '1') {
-    return true;
-  }
-
-  return (
-    window.localStorage.getItem(CUSTOM_WORLD_ASSET_DEBUG_STORAGE_KEY) === '1'
-  );
-}
-
-function collectCustomWorldAssetDebugEntries(
-  profile: CustomWorldProfile,
-): CustomWorldAssetDebugEntry[] {
-  const playableEntries = profile.playableNpcs
-    .map((role) => {
-      const imageSrc = role.imageSrc?.trim() || '';
-      if (!imageSrc) {
-        return null;
-      }
-
-      return {
-        id: `playable:${role.id}`,
-        label: `${role.name}主形象`,
-        imageSrc,
-        kind: 'playable' as const,
-      };
-    })
-    .filter(
-      (entry): entry is CustomWorldAssetDebugEntry => Boolean(entry),
-    );
-  const storyEntries = profile.storyNpcs
-    .map((role) => {
-      const imageSrc = role.imageSrc?.trim() || '';
-      if (!imageSrc) {
-        return null;
-      }
-
-      return {
-        id: `story:${role.id}`,
-        label: `${role.name}场景角色主图`,
-        imageSrc,
-        kind: 'story' as const,
-      };
-    })
-    .filter(
-      (entry): entry is CustomWorldAssetDebugEntry => Boolean(entry),
-    );
-  const landmarkEntries = profile.landmarks
-    .map((landmark) => {
-      const imageSrc = landmark.imageSrc?.trim() || '';
-      if (!imageSrc) {
-        return null;
-      }
-
-      return {
-        id: `landmark:${landmark.id}`,
-        label: `${landmark.name}场景主图`,
-        imageSrc,
-        kind: 'landmark' as const,
-      };
-    })
-    .filter(
-      (entry): entry is CustomWorldAssetDebugEntry => Boolean(entry),
-    );
-  const sceneActEntries =
-    profile.sceneChapterBlueprints?.flatMap((chapter) =>
-      chapter.acts
-        .map((act) => {
-          const imageSrc = act.backgroundImageSrc?.trim() || '';
-          if (!imageSrc) {
-            return null;
-          }
-
-          return {
-            id: `scene-act:${chapter.id}:${act.id}`,
-            label: `${chapter.title || chapter.sceneId} / ${act.title}幕图`,
-            imageSrc,
-            kind: 'scene-act' as const,
-          };
-        })
-        .filter(
-          (entry): entry is CustomWorldAssetDebugEntry => Boolean(entry),
-        ),
-    ) ?? [];
-
-  return [
-    ...playableEntries,
-    ...storyEntries,
-    ...landmarkEntries,
-    ...sceneActEntries,
-  ];
-}
-
-function resolveAssetDebugStatusLabel(status: AssetDebugLoadStatus | undefined) {
-  if (status === 'loaded') {
-    return '已加载';
-  }
-  if (status === 'error') {
-    return '加载失败';
-  }
-  return '检测中';
-}
-
-function resolveAssetDebugSummary(profile: CustomWorldProfile) {
-  return [
-    {
-      label: '可扮演角色主图',
-      value: `${profile.playableNpcs.filter((role) => Boolean(role.imageSrc?.trim())).length}/${profile.playableNpcs.length}`,
-    },
-    {
-      label: '场景角色主图',
-      value: `${profile.storyNpcs.filter((role) => Boolean(role.imageSrc?.trim())).length}/${profile.storyNpcs.length}`,
-    },
-    {
-      label: '场景主图',
-      value: `${profile.landmarks.filter((landmark) => Boolean(landmark.imageSrc?.trim())).length}/${profile.landmarks.length}`,
-    },
-    {
-      label: '分幕图',
-      value: `${profile.sceneChapterBlueprints?.reduce(
-        (sum, chapter) =>
-          sum +
-          chapter.acts.filter((act) => Boolean(act.backgroundImageSrc?.trim()))
-            .length,
-        0,
-      ) ?? 0}/${
-        profile.sceneChapterBlueprints?.reduce(
-          (sum, chapter) => sum + chapter.acts.length,
-          0,
-        ) ?? 0
-      }`,
-    },
-  ];
-}
-
-function SmallButton({
-  onClick,
-  children,
-  tone = 'default',
-  disabled = false,
-}: {
-  onClick: () => void;
-  children: ReactNode;
-  tone?: 'default' | 'sky';
-  disabled?: boolean;
-}) {
-  return (
-    <button
-      type="button"
-      onClick={onClick}
-      disabled={disabled}
-      className={`${
-        tone === 'sky'
-          ? 'platform-button platform-button--primary'
-          : 'platform-button platform-button--ghost'
-      } min-h-0 rounded-full px-3 py-2 text-sm ${disabled ? 'cursor-not-allowed opacity-45' : ''}`}
-    >
-      {children}
-    </button>
-  );
-}
-
-function getCreateTargetByTab(
-  activeTab: ResultTab,
-): CustomWorldEditorTarget | null {
-  if (activeTab === 'playable') return { kind: 'playable', mode: 'create' };
-  if (activeTab === 'story') return { kind: 'story', mode: 'create' };
-  if (activeTab === 'landmarks') return { kind: 'landmark', mode: 'create' };
-  return null;
-}
-
-function getCreateLabelByTab(activeTab: ResultTab) {
-  if (activeTab === 'playable') return '新增可扮演角色';
-  if (activeTab === 'story') return '新增场景角色';
-  if (activeTab === 'landmarks') return '新增场景';
-  return '';
-}
-
-function createPendingGeneratedEntity(
-  kind: EntityGenerationKind,
-): PendingGeneratedEntity {
-  return {
-    id: `pending-${kind}-${Date.now()}`,
-    kind,
-    title:
-      kind === 'playable'
-        ? '新可扮演角色'
-        : kind === 'story'
-          ? '新场景角色'
-          : '新场景',
-    progress: 8,
-    phaseLabel: '正在整理世界上下文',
-  };
-}
-
-function resolvePendingPhaseLabel(
-  kind: EntityGenerationKind,
-  progress: number,
-) {
-  if (progress < 28) {
-    return '正在整理世界上下文';
-  }
-  if (progress < 72) {
-    return kind === 'landmark' ? '正在推理场景结构' : '正在推理角色结构';
-  }
-  return '正在回写结果';
-}
-
-function prependPlayableNpc(
-  profile: CustomWorldProfile,
-  npc: CustomWorldPlayableNpc,
-) {
-  return {
-    ...profile,
-    playableNpcs: [npc, ...profile.playableNpcs],
-  } satisfies CustomWorldProfile;
-}
-
-function prependStoryNpc(profile: CustomWorldProfile, npc: CustomWorldNpc) {
-  return {
-    ...profile,
-    storyNpcs: [npc, ...profile.storyNpcs],
-  } satisfies CustomWorldProfile;
-}
-
-function prependLandmark(
-  profile: CustomWorldProfile,
-  landmark: CustomWorldLandmark,
-) {
-  return {
-    ...profile,
-    landmarks: normalizeCustomWorldLandmarks({
-      landmarks: [landmark, ...profile.landmarks],
-      storyNpcs: profile.storyNpcs,
-    }),
-  } satisfies CustomWorldProfile;
-}
-
-function removeStoryNpcsFromProfile(
-  profile: CustomWorldProfile,
-  ids: string[],
-) {
-  const idSet = new Set(ids);
-  const nextStoryNpcs = profile.storyNpcs.filter((npc) => !idSet.has(npc.id));
-
-  return {
-    ...profile,
-    storyNpcs: nextStoryNpcs,
-    landmarks: normalizeCustomWorldLandmarks({
-      landmarks: profile.landmarks.map((landmark) => ({
-        ...landmark,
-        sceneNpcIds: landmark.sceneNpcIds.filter((npcId) => !idSet.has(npcId)),
-      })),
-      storyNpcs: nextStoryNpcs,
-    }),
-  } satisfies CustomWorldProfile;
-}
-
-function removeLandmarksFromProfile(
-  profile: CustomWorldProfile,
-  ids: string[],
-) {
-  const idSet = new Set(ids);
-  const nextLandmarks = profile.landmarks.filter(
-    (landmark) => !idSet.has(landmark.id),
-  );
-
-  return {
-    ...profile,
-    landmarks: normalizeCustomWorldLandmarks({
-      landmarks: nextLandmarks.map((landmark) => ({
-        ...landmark,
-        connections: landmark.connections.filter(
-          (connection) => !idSet.has(connection.targetLandmarkId),
-        ),
-      })),
-      storyNpcs: profile.storyNpcs,
-    }),
-  } satisfies CustomWorldProfile;
-}
-
-export function CustomWorldResultView({
-  profile,
-  previewCharacters,
-  isGenerating,
-  progress,
-  progressLabel,
-  error,
-  onBack,
-  onEditSetting,
-  onRegenerate: triggerRegenerate,
-  onContinueExpand,
-  onEnterWorld,
-  onProfileChange,
-  readOnly = false,
-  backLabel = '返回',
-  editActionLabel = '修改设定',
-  regenerateActionLabel = '重新生成',
-  enterWorldActionLabel = '进入世界',
-  autoSaveState = 'idle',
-  compactAgentResultMode = false,
-}: CustomWorldResultViewProps) {
-  const [editorTarget, setEditorTarget] =
-    useState<CustomWorldEditorTarget | null>(null);
-  const [activeTab, setActiveTab] = useState<ResultTab>('world');
-  const [pendingGeneratedEntity, setPendingGeneratedEntity] =
-    useState<PendingGeneratedEntity | null>(null);
-  const [recentGeneratedIds, setRecentGeneratedIds] = useState<RecentGeneratedIds>(
-    {
-      playable: [],
-      story: [],
-      landmark: [],
-    },
-  );
-  const [localGenerationError, setLocalGenerationError] = useState<string | null>(
-    null,
-  );
-  const pendingProgressTimerRef = useRef<number | null>(null);
-  const assetDebugEnabled = useMemo(
-    () => shouldEnableCustomWorldAssetDebugPanel(),
-    [],
-  );
-  const assetDebugEntries = useMemo(
-    () =>
-      assetDebugEnabled ? collectCustomWorldAssetDebugEntries(profile) : [],
-    [assetDebugEnabled, profile],
-  );
-  const assetDebugSummary = useMemo(
-    () => (assetDebugEnabled ? resolveAssetDebugSummary(profile) : []),
-    [assetDebugEnabled, profile],
-  );
-  const [assetDebugStatusMap, setAssetDebugStatusMap] = useState<
-    Record<string, AssetDebugLoadStatus>
-  >({});
-
-  const createTarget = useMemo(
-    () => getCreateTargetByTab(activeTab),
-    [activeTab],
-  );
-  const createLabel = useMemo(
-    () => getCreateLabelByTab(activeTab),
-    [activeTab],
-  );
-  const stopPendingProgressTimer = () => {
-    if (pendingProgressTimerRef.current !== null) {
-      window.clearInterval(pendingProgressTimerRef.current);
-      pendingProgressTimerRef.current = null;
-    }
-  };
-
-  useEffect(() => () => stopPendingProgressTimer(), []);
-
-  useEffect(() => {
-    if (!assetDebugEnabled) {
-      setAssetDebugStatusMap({});
-      return;
-    }
-
-    if (assetDebugEntries.length === 0) {
-      setAssetDebugStatusMap({});
-      return;
-    }
-
-    let cancelled = false;
-    const cleanupList: Array<() => void> = [];
-
-    setAssetDebugStatusMap(
-      Object.fromEntries(
-        assetDebugEntries.map((entry) => [entry.id, 'loading' as const]),
-      ),
-    );
-
-    assetDebugEntries.forEach((entry) => {
-      const image = new Image();
-      const updateStatus = (status: AssetDebugLoadStatus) => {
-        if (cancelled) {
-          return;
-        }
-
-        setAssetDebugStatusMap((current) => {
-          if (current[entry.id] === status) {
-            return current;
-          }
-          return {
-            ...current,
-            [entry.id]: status,
-          };
-        });
-      };
-
-      image.onload = () => updateStatus('loaded');
-      image.onerror = () => updateStatus('error');
-      image.src = entry.imageSrc;
-      cleanupList.push(() => {
-        image.onload = null;
-        image.onerror = null;
-      });
-    });
-
-    return () => {
-      cancelled = true;
-      cleanupList.forEach((cleanup) => cleanup());
-    };
-  }, [assetDebugEnabled, assetDebugEntries]);
-
-  const startPendingProgress = (kind: EntityGenerationKind) => {
-    stopPendingProgressTimer();
-    setPendingGeneratedEntity(createPendingGeneratedEntity(kind));
-    pendingProgressTimerRef.current = window.setInterval(() => {
-      setPendingGeneratedEntity((current) => {
-        if (!current || current.kind !== kind) {
-          return current;
-        }
-
-        const nextProgress = Math.min(
-          current.progress + (current.progress < 56 ? 11 : 5),
-          88,
-        );
-
-        return {
-          ...current,
-          progress: nextProgress,
-          phaseLabel: resolvePendingPhaseLabel(kind, nextProgress),
-        };
-      });
-    }, 520);
-  };
-
-  const finishPendingProgress = () => {
-    stopPendingProgressTimer();
-    setPendingGeneratedEntity(null);
-  };
-
-  const markGeneratedAsRecent = (
-    kind: EntityGenerationKind,
-    generatedId: string,
-  ) => {
-    setRecentGeneratedIds((current) => ({
-      ...current,
-      [kind]: [generatedId, ...current[kind].filter((id) => id !== generatedId)].slice(
-        0,
-        6,
-      ),
-    }));
-  };
-
-  const handleGenerateEntity = async (kind: EntityGenerationKind) => {
-    if (readOnly || isGenerating || pendingGeneratedEntity) {
-      return;
-    }
-
-    setLocalGenerationError(null);
-    startPendingProgress(kind);
-
-    try {
-      if (kind === 'playable') {
-        const nextNpc = await generateCustomWorldPlayableNpc({ profile });
-        onProfileChange(prependPlayableNpc(profile, nextNpc));
-        markGeneratedAsRecent('playable', nextNpc.id);
-      } else if (kind === 'story') {
-        const nextNpc = await generateCustomWorldStoryNpc({ profile });
-        onProfileChange(prependStoryNpc(profile, nextNpc));
-        markGeneratedAsRecent('story', nextNpc.id);
-      } else {
-        const nextLandmark = await generateCustomWorldLandmark({ profile });
-        onProfileChange(prependLandmark(profile, nextLandmark));
-        markGeneratedAsRecent('landmark', nextLandmark.id);
-      }
-    } catch (generationError) {
-      setLocalGenerationError(
-        generationError instanceof Error
-          ? generationError.message
-          : '生成失败，请稍后重试。',
-      );
-    } finally {
-      finishPendingProgress();
-    }
-  };
-
-  const onRegenerate = () => {
-    if (isGenerating || !triggerRegenerate) return;
-
-    const confirmed = window.confirm(
-      `确认重新生成“${profile.name}”吗？\n\n重新生成会重新生成当前世界中的所有信息，包括你修改和新增的所有内容。`,
-    );
-    if (!confirmed) return;
-
-    triggerRegenerate();
-  };
-
-  const handleDeleteStoryNpcs = (ids: string[]) => {
-    if (ids.length === 0) return;
-    onProfileChange(removeStoryNpcsFromProfile(profile, ids));
-  };
-
-  const handleDeleteLandmarks = (ids: string[]) => {
-    if (ids.length === 0) return;
-    onProfileChange(removeLandmarksFromProfile(profile, ids));
-  };
-  const autoSaveBadge =
-    autoSaveState === 'saved' ? (
-      <div className="platform-pill platform-pill--success px-3 py-1 text-[11px]">
-        已自动保存
-      </div>
-    ) : autoSaveState === 'saving' ? (
-      <div className="platform-pill platform-pill--warm px-3 py-1 text-[11px]">
-        保存中
-      </div>
-    ) : autoSaveState === 'error' ? (
-      <div className="platform-pill platform-pill--rose px-3 py-1 text-[11px]">
-        保存失败
-      </div>
-    ) : null;
-
-  return (
-    <div className="flex h-full min-h-0 flex-col">
-      <div className="mb-4 flex items-center justify-between gap-3">
-        <button
-          type="button"
-          onClick={onBack}
-          disabled={isGenerating}
-          className={`platform-button platform-button--ghost min-h-0 self-start px-3 py-1.5 text-[11px] ${isGenerating ? 'opacity-45' : ''}`}
-        >
-          {backLabel}
-        </button>
-        {autoSaveBadge}
-      </div>
-
-      <div className="min-h-0 flex-1 overflow-hidden">
-        <CustomWorldEntityCatalog
-          profile={profile}
-          previewCharacters={previewCharacters}
-          activeTab={activeTab}
-          onActiveTabChange={setActiveTab}
-          onEditTarget={setEditorTarget}
-          onProfileChange={onProfileChange}
-          onDeleteStoryNpcs={handleDeleteStoryNpcs}
-          onDeleteLandmarks={handleDeleteLandmarks}
-          createActionLabel={
-            readOnly || compactAgentResultMode ? undefined : createLabel
-          }
-          onCreateAction={
-            readOnly || compactAgentResultMode || !createTarget
-              ? undefined
-              : () => {
-                  if (activeTab === 'playable') {
-                    void handleGenerateEntity('playable');
-                    return;
-                  }
-                  if (activeTab === 'story') {
-                    void handleGenerateEntity('story');
-                    return;
-                  }
-                  if (activeTab === 'landmarks') {
-                    void handleGenerateEntity('landmark');
-                    return;
-                  }
-                  setEditorTarget(createTarget);
-                }
-          }
-          createActionDisabled={Boolean(
-            isGenerating || pendingGeneratedEntity,
-          )}
-          pendingGeneratedEntity={pendingGeneratedEntity}
-          recentGeneratedIds={recentGeneratedIds}
-          readOnly={readOnly}
-        />
-      </div>
-
-      {isGenerating && (
-        <div className="platform-banner platform-banner--info mt-3 rounded-2xl px-4 py-4">
-          <div className="flex items-center justify-between gap-3">
-            <div className="text-sm font-semibold text-[var(--platform-text-strong)]">
-              {progressLabel}
-            </div>
-            <div className="text-xs text-[var(--platform-text-base)]">
-              {Math.round(progress)}%
-            </div>
-          </div>
-          <div className="platform-progress-track mt-3 h-3 overflow-hidden rounded-full">
-            <div
-              className="h-full bg-[linear-gradient(90deg,#ff4f8b_0%,#ff8a73_48%,#ffd2a6_100%)] transition-[width] duration-300"
-              style={{ width: `${Math.max(0, Math.min(100, progress))}%` }}
-            />
-          </div>
-        </div>
-      )}
-
-      {error ? (
-        <div className="platform-banner platform-banner--danger mt-3 rounded-2xl text-sm leading-6">
-          {error}
-        </div>
-      ) : null}
-      {!error && localGenerationError ? (
-        <div className="platform-banner platform-banner--danger mt-3 rounded-2xl text-sm leading-6">
-          {localGenerationError}
-        </div>
-      ) : null}
-      {assetDebugEnabled ? (
-        <div className="platform-surface platform-surface--soft mt-3 px-3.5 py-3">
-          <div className="flex items-start justify-between gap-3">
-            <div>
-              <div className="text-xs font-bold tracking-[0.16em] text-white">
-                资产诊断
-              </div>
-              <div className="mt-1 text-xs leading-6 text-zinc-500">
-                仅开发模式显示，用来核对结果页当前拿到的图片字段和实际加载状态。
-              </div>
-            </div>
-            <div className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
-              {assetDebugEntries.length}项
-            </div>
-          </div>
-          <div className="mt-3 grid grid-cols-2 gap-2 xl:grid-cols-4">
-            {assetDebugSummary.map((entry) => (
-              <div
-                key={entry.label}
-                className="platform-subpanel rounded-2xl px-3 py-2"
-              >
-                <div className="text-[11px] text-zinc-500">{entry.label}</div>
-                <div className="mt-1 text-sm font-semibold text-white">
-                  {entry.value}
-                </div>
-              </div>
-            ))}
-          </div>
-          <div className="mt-3 space-y-2">
-            {assetDebugEntries.length > 0 ? (
-              assetDebugEntries.map((entry) => (
-                <div
-                  key={entry.id}
-                  className="platform-subpanel rounded-2xl px-3 py-2"
-                >
-                  <div className="flex items-start justify-between gap-3">
-                    <div className="min-w-0">
-                      <div className="text-sm font-semibold text-white">
-                        {entry.label}
-                      </div>
-                      <div className="mt-1 break-all text-[11px] leading-5 text-zinc-400">
-                        {entry.imageSrc}
-                      </div>
-                    </div>
-                    <div className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
-                      {resolveAssetDebugStatusLabel(
-                        assetDebugStatusMap[entry.id],
-                      )}
-                    </div>
-                  </div>
-                  <div className="mt-2">
-                    <a
-                      href={entry.imageSrc}
-                      target="_blank"
-                      rel="noreferrer"
-                      aria-label={`打开 ${entry.label}`}
-                      className="text-xs font-semibold text-amber-200 underline decoration-white/20 underline-offset-2"
-                    >
-                      打开原图
-                    </a>
-                  </div>
-                </div>
-              ))
-            ) : (
-              <div className="platform-subpanel rounded-2xl px-3 py-3 text-sm text-zinc-400">
-                当前结果页 profile 里没有拿到任何可诊断的图片地址。
-              </div>
-            )}
-          </div>
-        </div>
-      ) : null}
-
-      <div className="mt-4 flex flex-col gap-3">
-        {profile.generationStatus === 'key_only' ? (
-          <div className="platform-banner platform-banner--warning rounded-2xl text-sm leading-6">
-            当前世界处于快速预览模式，只生成了关键对象。继续补全后，系统会生成长尾场景角色与完整场景网络。
-          </div>
-        ) : null}
-        <div className="flex items-center justify-end gap-3">
-          {onEditSetting ? (
-            <SmallButton onClick={onEditSetting}>{editActionLabel}</SmallButton>
-          ) : null}
-          {triggerRegenerate ? (
-            <SmallButton onClick={onRegenerate} tone="sky">
-              {regenerateActionLabel}
-            </SmallButton>
-          ) : null}
-          {profile.generationStatus === 'key_only' && onContinueExpand ? (
-            <SmallButton
-              onClick={onContinueExpand}
-              tone="sky"
-              disabled={isGenerating}
-            >
-              继续补全世界
-            </SmallButton>
-          ) : null}
-          {onEnterWorld ? (
-            <button
-              type="button"
-              onClick={onEnterWorld}
-              disabled={isGenerating}
-              className={`platform-button platform-button--primary ${isGenerating ? 'opacity-55' : ''}`}
-            >
-              {enterWorldActionLabel}
-            </button>
-          ) : null}
-        </div>
-      </div>
-
-      <CustomWorldEntityEditorModal
-        profile={profile}
-        target={editorTarget}
-        onClose={() => setEditorTarget(null)}
-        onProfileChange={onProfileChange}
-      />
-    </div>
-  );
-}
diff --git a/src/components/NpcModals.tsx b/src/components/NpcModals.tsx
index e5feed34..f2c90a13 100644
--- a/src/components/NpcModals.tsx
+++ b/src/components/NpcModals.tsx
@@ -23,7 +23,7 @@ import {
   getGiftCandidates,
   getRarityLabel,
 } from '../data/npcInteractions';
-import { StoryGenerationNpcUi } from '../hooks/useStoryGeneration';
+import { StoryGenerationNpcUi } from '../hooks/rpg-runtime-story';
 import { GameState, InventoryItem } from '../types';
 import { CHROME_ICONS, getInventoryItemVisualSrc, getNineSliceStyle, UI_CHROME } from '../uiAssets';
 import { PixelIcon } from './PixelIcon';
diff --git a/src/components/game-shell/PreGameSelectionFlow.tsx b/src/components/game-shell/PreGameSelectionFlow.tsx
deleted file mode 100644
index 2357d18a..00000000
--- a/src/components/game-shell/PreGameSelectionFlow.tsx
+++ /dev/null
@@ -1,1920 +0,0 @@
-import { AnimatePresence, motion } from 'motion/react';
-import {
-  lazy,
-  Suspense,
-  useCallback,
-  useEffect,
-  useMemo,
-  useRef,
-  useState,
-} from 'react';
-
-import type {
-  CustomWorldAgentActionRequest,
-  CustomWorldAgentMessage,
-  CustomWorldAgentOperationRecord,
-  CustomWorldAgentSessionSnapshot,
-  CustomWorldWorkSummary,
-  SendCustomWorldAgentMessageRequest,
-} from '../../../packages/shared/src/contracts/customWorldAgent';
-import type {
-  CustomWorldGalleryCard,
-  CustomWorldLibraryEntry,
-  PlatformBrowseHistoryEntry,
-  PlatformBrowseHistoryWriteEntry,
-  ProfileDashboardSummary,
-  ProfileSaveArchiveSummary,
-} from '../../../packages/shared/src/contracts/runtime';
-import { buildCustomWorldPlayableCharacters } from '../../data/characterPresets';
-import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
-import {
-  createCustomWorldAgentSession,
-  executeCustomWorldAgentAction,
-  getCustomWorldAgentOperation,
-  getCustomWorldAgentSession,
-  listCustomWorldWorks,
-  streamCustomWorldAgentMessage,
-} from '../../services/aiService';
-import { buildCustomWorldProfileFromAgentDraft } from '../../services/customWorldAgentDraftResult';
-import {
-  buildAgentDraftFoundationAnchorEntries,
-  buildAgentDraftFoundationGenerationProgress,
-  buildAgentDraftFoundationSettingText,
-  isDraftFoundationOperation,
-  isDraftFoundationOperationRunning,
-} from '../../services/customWorldAgentGenerationProgress';
-import {
-  readCustomWorldAgentUiState,
-  writeCustomWorldAgentUiState,
-} from '../../services/customWorldAgentUiState';
-import { buildCustomWorldCreatorIntentFoundationText } from '../../services/customWorldCreatorIntent';
-import {
-  deleteCustomWorldProfile,
-  getCustomWorldGalleryDetail,
-  getProfileDashboard,
-  listCustomWorldGallery,
-  listCustomWorldLibrary,
-  listProfileBrowseHistory,
-  listProfileSaveArchives,
-  publishCustomWorldProfile,
-  resumeProfileSaveArchive,
-  unpublishCustomWorldProfile,
-  upsertCustomWorldProfile,
-  upsertProfileBrowseHistory,
-} from '../../services/storageService';
-import { type CustomWorldProfile, type GameState } from '../../types';
-import { useAuthUi } from '../auth/AuthUiContext';
-import { CustomWorldCreationHub } from '../custom-world-home/CustomWorldCreationHub';
-import { PlatformCreationTypeModal } from './PlatformCreationTypeModal';
-import { type PlatformHomeTab, PlatformHomeView } from './PlatformHomeView';
-import { PlatformWorldDetailView } from './PlatformWorldDetailView';
-
-const CustomWorldGenerationView = lazy(async () => {
-  const module = await import('../CustomWorldGenerationView');
-  return {
-    default: module.CustomWorldGenerationView,
-  };
-});
-
-const CustomWorldResultView = lazy(async () => {
-  const module = await import('../CustomWorldResultView');
-  return {
-    default: module.CustomWorldResultView,
-  };
-});
-
-const CustomWorldAgentWorkspace = lazy(async () => {
-  const module = await import(
-    '../custom-world-agent/CustomWorldAgentWorkspace'
-  );
-  return {
-    default: module.CustomWorldAgentWorkspace,
-  };
-});
-
-export type SelectionStage =
-  | 'platform'
-  | 'detail'
-  | 'agent-workspace'
-  | 'custom-world-generating'
-  | 'custom-world-result';
-
-type CustomWorldGenerationViewSource = 'agent-draft-foundation' | null;
-
-type CustomWorldResultViewSource = 'saved-profile' | 'agent-draft' | null;
-type CustomWorldAutoSaveState = 'idle' | 'saving' | 'saved' | 'error';
-type SyncedAgentDraftResult = {
-  session: CustomWorldAgentSessionSnapshot | null;
-  profile: CustomWorldProfile | null;
-};
-
-type PreGameSelectionFlowProps = {
-  selectionStage: SelectionStage;
-  setSelectionStage: (stage: SelectionStage) => void;
-  gameState: GameState;
-  hasSavedGame: boolean;
-  savedSnapshot: HydratedSavedGameSnapshot | null;
-  handleContinueGame: (snapshot?: HydratedSavedGameSnapshot | null) => void;
-  handleStartNewGame: () => void;
-  handleCustomWorldSelect: (customWorldProfile: CustomWorldProfile) => void;
-};
-
-function resolveErrorMessage(error: unknown, fallback: string) {
-  return error instanceof Error ? error.message : fallback;
-}
-
-function createFailedAgentOperation(params: {
-  type: CustomWorldAgentOperationRecord['type'];
-  phaseLabel: string;
-  error: string;
-}): CustomWorldAgentOperationRecord {
-  return {
-    operationId: `local-failed-${Date.now()}`,
-    type: params.type,
-    status: 'failed',
-    phaseLabel: params.phaseLabel,
-    phaseDetail: params.error,
-    progress: 100,
-    error: params.error,
-  };
-}
-
-function buildOptimisticAgentMessage(
-  payload: Pick<CustomWorldAgentMessage, 'id' | 'role' | 'kind' | 'text'>,
-): CustomWorldAgentMessage {
-  return {
-    ...payload,
-    createdAt: new Date().toISOString(),
-    relatedOperationId: null,
-  };
-}
-
-function normalizeAgentBackedProfile(profile: CustomWorldProfile) {
-  const foundationText = buildCustomWorldCreatorIntentFoundationText(
-    profile.creatorIntent,
-  ).trim();
-
-  if (!foundationText || foundationText === profile.settingText.trim()) {
-    return profile;
-  }
-
-  return {
-    ...profile,
-    settingText: foundationText,
-  } satisfies CustomWorldProfile;
-}
-
-function stringifyAgentBackedProfile(profile: CustomWorldProfile) {
-  return JSON.stringify(normalizeAgentBackedProfile(profile));
-}
-
-function LazyPanelFallback({ label }: { label: string }) {
-  return (
-    <div className="flex h-full min-h-0 items-center justify-center">
-      <div className="platform-subpanel rounded-2xl px-5 py-4 text-sm text-[var(--platform-text-base)]">
-        {label}
-      </div>
-    </div>
-  );
-}
-
-function buildCreationHubFallbackItems(
-  entries: CustomWorldLibraryEntry<CustomWorldProfile>[],
-): CustomWorldWorkSummary[] {
-  return entries
-    .filter((entry) => entry.visibility === 'published')
-    .map((entry) => ({
-    workId: `fallback:${entry.profileId}`,
-    sourceType: 'published_profile',
-    status: 'published',
-    title: entry.worldName,
-    subtitle: entry.subtitle || '已发布作品',
-    summary: entry.summaryText || '继续补完这个世界的设定与游玩入口。',
-    coverImageSrc: entry.coverImageSrc,
-    coverRenderMode: 'image',
-    coverCharacterImageSrcs: [],
-    updatedAt: entry.updatedAt,
-    publishedAt: entry.publishedAt,
-    stage: null,
-    stageLabel: '已发布',
-    playableNpcCount: entry.playableNpcCount,
-    landmarkCount: entry.landmarkCount,
-    roleVisualReadyCount: 0,
-    roleAnimationReadyCount: 0,
-    roleAssetSummaryLabel: null,
-    sessionId: null,
-    profileId: entry.profileId,
-    canResume: false,
-    canEnterWorld: true,
-  }));
-}
-
-export function PreGameSelectionFlow({
-  selectionStage,
-  setSelectionStage,
-  hasSavedGame,
-  savedSnapshot,
-  handleContinueGame,
-  handleStartNewGame,
-  handleCustomWorldSelect,
-}: PreGameSelectionFlowProps) {
-  const authUi = useAuthUi();
-  const initialAgentUiStateRef = useRef(readCustomWorldAgentUiState());
-  const hasAppliedInitialAgentWorkspaceRef = useRef(false);
-  const hasRequestedInitialAgentWorkspaceAuthRef = useRef(false);
-  const [generatedCustomWorldProfile, setGeneratedCustomWorldProfile] =
-    useState<CustomWorldProfile | null>(null);
-  const [savedCustomWorldEntries, setSavedCustomWorldEntries] = useState<
-    CustomWorldLibraryEntry<CustomWorldProfile>[]
-  >([]);
-  const [customWorldWorkEntries, setCustomWorldWorkEntries] = useState<
-    CustomWorldWorkSummary[]
-  >([]);
-  const [publishedGalleryEntries, setPublishedGalleryEntries] = useState<
-    CustomWorldGalleryCard[]
-  >([]);
-  const [historyEntries, setHistoryEntries] = useState<
-    PlatformBrowseHistoryEntry[]
-  >([]);
-  const [saveEntries, setSaveEntries] = useState<ProfileSaveArchiveSummary[]>(
-    [],
-  );
-  const [platformTab, setPlatformTab] = useState<PlatformHomeTab>('home');
-  const [selectedDetailEntry, setSelectedDetailEntry] =
-    useState<CustomWorldLibraryEntry<CustomWorldProfile> | null>(null);
-  const [showCreationTypeModal, setShowCreationTypeModal] = useState(false);
-  const [creationTypeError, setCreationTypeError] = useState<string | null>(
-    null,
-  );
-  const [isCreatingAgentSession, setIsCreatingAgentSession] = useState(false);
-  const [activeAgentSessionId, setActiveAgentSessionId] = useState<
-    string | null
-  >(() => initialAgentUiStateRef.current.activeSessionId ?? null);
-  const [activeAgentOperationId, setActiveAgentOperationId] = useState<
-    string | null
-  >(() => initialAgentUiStateRef.current.activeOperationId ?? null);
-  const [agentSession, setAgentSession] =
-    useState<CustomWorldAgentSessionSnapshot | null>(null);
-  const [agentOperation, setAgentOperation] =
-    useState<CustomWorldAgentOperationRecord | null>(null);
-  const [streamingAgentReplyText, setStreamingAgentReplyText] = useState('');
-  const [isStreamingAgentReply, setIsStreamingAgentReply] = useState(false);
-  const [isLoadingAgentSession, setIsLoadingAgentSession] = useState(false);
-  const [customWorldError, setCustomWorldError] = useState<string | null>(null);
-  const [platformError, setPlatformError] = useState<string | null>(null);
-  const [profileDashboard, setProfileDashboard] =
-    useState<ProfileDashboardSummary | null>(null);
-  const [dashboardError, setDashboardError] = useState<string | null>(null);
-  const [_historyError, setHistoryError] = useState<string | null>(null);
-  const [saveError, setSaveError] = useState<string | null>(null);
-  const [detailError, setDetailError] = useState<string | null>(null);
-  const [isLoadingPlatform, setIsLoadingPlatform] = useState(false);
-  const [isLoadingDashboard, setIsLoadingDashboard] = useState(false);
-  const [isResumingSaveWorldKey, setIsResumingSaveWorldKey] = useState<
-    string | null
-  >(null);
-  const [isDetailLoading, setIsDetailLoading] = useState(false);
-  const [isMutatingDetail, setIsMutatingDetail] = useState(false);
-  const [customWorldAutoSaveState, setCustomWorldAutoSaveState] =
-    useState<CustomWorldAutoSaveState>('idle');
-  const [customWorldAutoSaveError, setCustomWorldAutoSaveError] = useState<
-    string | null
-  >(null);
-  const [customWorldGenerationViewSource, setCustomWorldGenerationViewSource] =
-    useState<CustomWorldGenerationViewSource>(null);
-  const [customWorldResultViewSource, setCustomWorldResultViewSource] =
-    useState<CustomWorldResultViewSource>(null);
-  const [agentDraftGenerationStartedAt, setAgentDraftGenerationStartedAt] =
-    useState<number | null>(null);
-  const customWorldAutoSaveTimeoutRef = useRef<number | null>(null);
-  const lastAutoSavedProfileSignatureRef = useRef<string | null>(null);
-  const latestAutoSaveRequestIdRef = useRef(0);
-  const latestAgentResultSyncSignatureRef = useRef<string | null>(null);
-  // 用户手动返回工作区后，先抑制自动重开结果页，避免刚退出又被 session 快照顶回去。
-  const isAgentDraftResultAutoOpenSuppressedRef = useRef(false);
-  const isCustomWorldAutoSaveBusyRef = useRef(false);
-  const platformTabBootstrapUserIdRef = useRef<string | null | undefined>(
-    undefined,
-  );
-
-  const previewCustomWorldCharacters = useMemo(
-    () =>
-      generatedCustomWorldProfile
-        ? buildCustomWorldPlayableCharacters(generatedCustomWorldProfile)
-        : [],
-    [generatedCustomWorldProfile],
-  );
-
-  const featuredGalleryEntries = useMemo(
-    () => publishedGalleryEntries.slice(0, 6),
-    [publishedGalleryEntries],
-  );
-  const isAuthenticated = Boolean(authUi?.user);
-
-  const runProtectedAction = useCallback(
-    (action: () => void) => {
-      if (!authUi?.requireAuth) {
-        action();
-        return;
-      }
-
-      authUi.requireAuth(action);
-    },
-    [authUi],
-  );
-
-  const persistAgentUiState = useCallback(
-    (nextSessionId: string | null, nextOperationId: string | null) => {
-      setActiveAgentSessionId(nextSessionId);
-      setActiveAgentOperationId(nextOperationId);
-      writeCustomWorldAgentUiState({
-        activeSessionId: nextSessionId,
-        activeOperationId: nextOperationId,
-      });
-    },
-    [],
-  );
-
-  const syncAgentSessionSnapshot = useCallback(async (sessionId: string) => {
-    const nextSession = await getCustomWorldAgentSession(sessionId);
-    setAgentSession(nextSession);
-    return nextSession;
-  }, []);
-
-  const refreshProfileDashboard = useCallback(async () => {
-    if (!authUi?.user) {
-      setProfileDashboard(null);
-      setDashboardError(null);
-      setIsLoadingDashboard(false);
-      return;
-    }
-
-    setIsLoadingDashboard(true);
-    setDashboardError(null);
-
-    try {
-      setProfileDashboard(await getProfileDashboard());
-    } catch (error) {
-      setDashboardError(resolveErrorMessage(error, '读取个人数据看板失败。'));
-    } finally {
-      setIsLoadingDashboard(false);
-    }
-  }, [authUi?.user]);
-
-  const refreshCustomWorldWorks = useCallback(async () => {
-    if (!authUi?.user) {
-      setCustomWorldWorkEntries([]);
-      return [];
-    }
-
-    const nextItems = await listCustomWorldWorks();
-    setCustomWorldWorkEntries(nextItems);
-    return nextItems;
-  }, [authUi?.user]);
-
-  const appendBrowseHistoryEntry = useCallback(
-    async (entry: PlatformBrowseHistoryWriteEntry) => {
-      setHistoryError(null);
-
-      try {
-        const syncedEntries = await upsertProfileBrowseHistory(entry);
-        setHistoryEntries(syncedEntries);
-      } catch (error) {
-        setHistoryError(resolveErrorMessage(error, '写入浏览历史失败。'));
-      }
-    },
-    [authUi?.user],
-  );
-
-  useEffect(() => {
-    const initialAgentSessionId = initialAgentUiStateRef.current.activeSessionId;
-
-    if (!initialAgentSessionId || hasAppliedInitialAgentWorkspaceRef.current) {
-      return;
-    }
-
-    setPlatformTab('create');
-
-    // URL 或 sessionStorage 中残留的共创工作区属于受保护入口，
-    // 未登录时只允许先唤起登录弹窗，不能直接恢复会话请求。
-    if (!authUi?.user) {
-      if (!hasRequestedInitialAgentWorkspaceAuthRef.current) {
-        hasRequestedInitialAgentWorkspaceAuthRef.current = true;
-        authUi?.openLoginModal?.(() => {
-          setSelectionStage('agent-workspace');
-        });
-      }
-      return;
-    }
-
-    hasAppliedInitialAgentWorkspaceRef.current = true;
-    setSelectionStage('agent-workspace');
-  }, [authUi?.openLoginModal, authUi?.user, setSelectionStage]);
-
-  useEffect(() => {
-    if (!selectedDetailEntry) {
-      return;
-    }
-
-    const nextOwnedEntry = savedCustomWorldEntries.find(
-      (entry) =>
-        entry.ownerUserId === selectedDetailEntry.ownerUserId &&
-        entry.profileId === selectedDetailEntry.profileId,
-    );
-    if (nextOwnedEntry && nextOwnedEntry !== selectedDetailEntry) {
-      setSelectedDetailEntry(nextOwnedEntry);
-    }
-  }, [savedCustomWorldEntries, selectedDetailEntry]);
-
-  useEffect(() => {
-    let isActive = true;
-
-    void (async () => {
-      setHistoryEntries([]);
-      setHistoryError(null);
-      setSaveError(null);
-      setIsLoadingPlatform(true);
-      setPlatformError(null);
-      setIsLoadingDashboard(isAuthenticated);
-      setDashboardError(null);
-      if (!isAuthenticated) {
-        setSavedCustomWorldEntries([]);
-        setCustomWorldWorkEntries([]);
-        setSaveEntries([]);
-        setProfileDashboard(null);
-      }
-
-      try {
-        const [
-          libraryEntriesResult,
-          workEntriesResult,
-          galleryEntriesResult,
-          dashboardResult,
-          historyResult,
-          saveArchivesResult,
-        ] = await Promise.allSettled([
-          isAuthenticated ? listCustomWorldLibrary() : Promise.resolve([]),
-          isAuthenticated ? listCustomWorldWorks() : Promise.resolve([]),
-          listCustomWorldGallery(),
-          isAuthenticated ? getProfileDashboard() : Promise.resolve(null),
-          isAuthenticated ? listProfileBrowseHistory() : Promise.resolve([]),
-          isAuthenticated ? listProfileSaveArchives() : Promise.resolve([]),
-        ]);
-        if (!isActive) {
-          return;
-        }
-
-        if (libraryEntriesResult.status === 'fulfilled') {
-          setSavedCustomWorldEntries(libraryEntriesResult.value);
-        } else {
-          setSavedCustomWorldEntries([]);
-        }
-
-        if (workEntriesResult.status === 'fulfilled') {
-          setCustomWorldWorkEntries(workEntriesResult.value);
-        } else {
-          setCustomWorldWorkEntries([]);
-        }
-
-        if (galleryEntriesResult.status === 'fulfilled') {
-          setPublishedGalleryEntries(galleryEntriesResult.value);
-        } else {
-          setPublishedGalleryEntries([]);
-        }
-
-        if (
-          (isAuthenticated && libraryEntriesResult.status === 'rejected') ||
-          (isAuthenticated && workEntriesResult.status === 'rejected') ||
-          galleryEntriesResult.status === 'rejected'
-        ) {
-          const platformFailure =
-            libraryEntriesResult.status === 'rejected'
-              ? libraryEntriesResult.reason
-              : workEntriesResult.status === 'rejected'
-                ? workEntriesResult.reason
-              : galleryEntriesResult.status === 'rejected'
-                ? galleryEntriesResult.reason
-                : null;
-          setPlatformError(
-            resolveErrorMessage(platformFailure, '读取平台数据失败。'),
-          );
-        }
-
-        if (dashboardResult.status === 'fulfilled') {
-          setProfileDashboard(dashboardResult.value);
-        } else if (isAuthenticated) {
-          setProfileDashboard(null);
-          setDashboardError(
-            resolveErrorMessage(
-              dashboardResult.reason,
-              '读取个人数据看板失败。',
-            ),
-          );
-        }
-
-        if (historyResult.status === 'fulfilled') {
-          setHistoryEntries(historyResult.value);
-        } else if (isAuthenticated) {
-          setHistoryError(
-            resolveErrorMessage(historyResult.reason, '读取浏览历史失败。'),
-          );
-        }
-
-        if (saveArchivesResult.status === 'fulfilled') {
-          setSaveEntries(saveArchivesResult.value);
-        } else if (isAuthenticated) {
-          setSaveEntries([]);
-          setSaveError(
-            resolveErrorMessage(
-              saveArchivesResult.reason,
-              '读取存档列表失败。',
-            ),
-          );
-        }
-
-        const nextPlatformBootstrapUserId = authUi?.user?.id ?? null;
-        if (
-          platformTabBootstrapUserIdRef.current !== nextPlatformBootstrapUserId
-        ) {
-          platformTabBootstrapUserIdRef.current = nextPlatformBootstrapUserId;
-          if (!initialAgentUiStateRef.current.activeSessionId) {
-            setPlatformTab(
-              isAuthenticated &&
-                saveArchivesResult.status === 'fulfilled' &&
-                saveArchivesResult.value.length > 0
-                ? 'saves'
-                : 'home',
-            );
-          }
-        }
-      } finally {
-        if (isActive) {
-          setIsLoadingPlatform(false);
-          setIsLoadingDashboard(false);
-        }
-      }
-    })();
-
-    return () => {
-      isActive = false;
-    };
-  }, [authUi?.user, isAuthenticated]);
-
-  useEffect(() => {
-    if (
-      selectionStage === 'custom-world-result' &&
-      !generatedCustomWorldProfile
-    ) {
-      setSelectionStage(selectedDetailEntry ? 'detail' : 'platform');
-    }
-  }, [
-    generatedCustomWorldProfile,
-    selectedDetailEntry,
-    selectionStage,
-    setSelectionStage,
-  ]);
-
-  useEffect(
-    () => () => {
-      if (customWorldAutoSaveTimeoutRef.current !== null) {
-        window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
-      }
-    },
-    [],
-  );
-
-  useEffect(() => {
-    if (!activeAgentSessionId) {
-      setAgentSession(null);
-      setAgentOperation(null);
-      setIsLoadingAgentSession(false);
-      setStreamingAgentReplyText('');
-      setIsStreamingAgentReply(false);
-      return;
-    }
-
-    if (!authUi?.user) {
-      setAgentSession(null);
-      setAgentOperation(null);
-      setIsLoadingAgentSession(false);
-      setStreamingAgentReplyText('');
-      setIsStreamingAgentReply(false);
-      return;
-    }
-
-    let cancelled = false;
-    setIsLoadingAgentSession(true);
-
-    void syncAgentSessionSnapshot(activeAgentSessionId)
-      .then(() => {
-        if (!cancelled) {
-          setCreationTypeError(null);
-        }
-      })
-      .catch((error) => {
-        if (cancelled) {
-          return;
-        }
-
-        setCreationTypeError(
-          resolveErrorMessage(error, '读取 Agent 共创工作区失败。'),
-        );
-        setAgentSession(null);
-        setAgentOperation(null);
-        setStreamingAgentReplyText('');
-        setIsStreamingAgentReply(false);
-        persistAgentUiState(null, null);
-        setPlatformTab('create');
-        setSelectionStage('platform');
-      })
-      .finally(() => {
-        if (!cancelled) {
-          setIsLoadingAgentSession(false);
-        }
-      });
-
-    return () => {
-      cancelled = true;
-    };
-  }, [
-    activeAgentSessionId,
-    authUi?.user,
-    persistAgentUiState,
-    setSelectionStage,
-    syncAgentSessionSnapshot,
-  ]);
-
-  useEffect(() => {
-    if (!activeAgentSessionId || !activeAgentOperationId || !authUi?.user) {
-      return;
-    }
-
-    let cancelled = false;
-
-    const pollOperation = async () => {
-      try {
-        const nextOperation = await getCustomWorldAgentOperation(
-          activeAgentSessionId,
-          activeAgentOperationId,
-        );
-
-        if (cancelled) {
-          return;
-        }
-
-        setAgentOperation(nextOperation);
-
-        if (
-          nextOperation.status === 'completed' ||
-          nextOperation.status === 'failed'
-        ) {
-          persistAgentUiState(activeAgentSessionId, null);
-          await syncAgentSessionSnapshot(activeAgentSessionId).catch(
-            () => null,
-          );
-        }
-      } catch (error) {
-        if (cancelled) {
-          return;
-        }
-
-        const errorMessage = resolveErrorMessage(
-          error,
-          '读取共创操作状态失败。',
-        );
-        setAgentOperation(
-          createFailedAgentOperation({
-            type: 'process_message',
-            phaseLabel: '读取操作状态失败',
-            error: errorMessage,
-          }),
-        );
-        persistAgentUiState(activeAgentSessionId, null);
-      }
-    };
-
-    void pollOperation();
-    const intervalId = window.setInterval(() => {
-      void pollOperation();
-    }, 1200);
-
-    return () => {
-      cancelled = true;
-      window.clearInterval(intervalId);
-    };
-  }, [
-    activeAgentOperationId,
-    activeAgentSessionId,
-    authUi?.user,
-    persistAgentUiState,
-    syncAgentSessionSnapshot,
-  ]);
-
-  useEffect(() => {
-    if (
-      !isDraftFoundationOperationRunning(agentOperation) ||
-      agentDraftGenerationStartedAt
-    ) {
-      return;
-    }
-
-    setAgentDraftGenerationStartedAt(Date.now());
-  }, [agentDraftGenerationStartedAt, agentOperation]);
-
-  useEffect(() => {
-    if (
-      selectionStage !== 'custom-world-generating' ||
-      customWorldGenerationViewSource !== 'agent-draft-foundation' ||
-      !isDraftFoundationOperation(agentOperation) ||
-      agentOperation.status !== 'completed'
-    ) {
-      return;
-    }
-
-    let cancelled = false;
-    const timeoutId = window.setTimeout(() => {
-      void (async () => {
-        const latestSession = activeAgentSessionId
-          ? await syncAgentSessionSnapshot(activeAgentSessionId).catch(
-              () => null,
-            )
-          : agentSession;
-
-        if (cancelled) {
-          return;
-        }
-
-        const draftResultProfile = buildCustomWorldProfileFromAgentDraft(
-          latestSession ?? agentSession,
-        );
-        if (!draftResultProfile) {
-          setAgentDraftGenerationStartedAt(null);
-          setCustomWorldGenerationViewSource(null);
-          setSelectionStage('agent-workspace');
-          return;
-        }
-
-        setGeneratedCustomWorldProfile(
-          normalizeAgentBackedProfile(draftResultProfile),
-        );
-        setAgentDraftGenerationStartedAt(null);
-        setCustomWorldGenerationViewSource(null);
-        setCustomWorldResultViewSource('agent-draft');
-        setSelectionStage('custom-world-result');
-      })();
-    }, 900);
-
-    return () => {
-      cancelled = true;
-      window.clearTimeout(timeoutId);
-    };
-  }, [
-    activeAgentSessionId,
-    agentOperation,
-    customWorldGenerationViewSource,
-    agentSession,
-    selectionStage,
-    setSelectionStage,
-    syncAgentSessionSnapshot,
-  ]);
-
-  const agentDraftSettingPreview = useMemo(
-    () => buildAgentDraftFoundationSettingText(agentSession),
-    [agentSession],
-  );
-  const agentDraftAnchorPreviewEntries = useMemo(
-    () => buildAgentDraftFoundationAnchorEntries(agentSession),
-    [agentSession],
-  );
-  const agentDraftResultProfile = useMemo(
-    () => buildCustomWorldProfileFromAgentDraft(agentSession),
-    [agentSession],
-  );
-  const shouldAutoOpenAgentDraftResult = useMemo(
-    () =>
-      Boolean(
-        agentDraftResultProfile &&
-          agentSession &&
-          (agentSession.stage === 'object_refining' ||
-            agentSession.stage === 'visual_refining' ||
-            agentSession.stage === 'long_tail_review' ||
-            agentSession.stage === 'ready_to_publish' ||
-            agentSession.stage === 'published') &&
-          agentSession.draftCards.length > 0,
-      ),
-    [agentDraftResultProfile, agentSession],
-  );
-
-  useEffect(() => {
-    if (!shouldAutoOpenAgentDraftResult || !agentDraftResultProfile) {
-      return;
-    }
-
-    if (isAgentDraftResultAutoOpenSuppressedRef.current) {
-      return;
-    }
-
-    if (selectionStage === 'agent-workspace') {
-      setGeneratedCustomWorldProfile(agentDraftResultProfile);
-      setCustomWorldResultViewSource('agent-draft');
-      isAgentDraftResultAutoOpenSuppressedRef.current = false;
-      setSelectionStage('custom-world-result');
-      return;
-    }
-
-    if (
-      selectionStage === 'custom-world-result' &&
-      !generatedCustomWorldProfile
-    ) {
-      setGeneratedCustomWorldProfile(agentDraftResultProfile);
-      setCustomWorldResultViewSource('agent-draft');
-      isAgentDraftResultAutoOpenSuppressedRef.current = false;
-    }
-  }, [
-    agentDraftResultProfile,
-    generatedCustomWorldProfile,
-    isAgentDraftResultAutoOpenSuppressedRef,
-    selectionStage,
-    setSelectionStage,
-    shouldAutoOpenAgentDraftResult,
-  ]);
-
-  const agentDraftGenerationProgress = useMemo(
-    () =>
-      buildAgentDraftFoundationGenerationProgress(
-        agentOperation,
-        agentDraftGenerationStartedAt,
-      ),
-    [agentDraftGenerationStartedAt, agentOperation],
-  );
-
-  const isAgentDraftGenerationView =
-    customWorldGenerationViewSource === 'agent-draft-foundation';
-  const isAgentDraftResultView = customWorldResultViewSource === 'agent-draft';
-  const activeGenerationSettingText = agentDraftSettingPreview;
-  const activeGenerationProgress = agentDraftGenerationProgress;
-  const isActiveGenerationRunning =
-    isDraftFoundationOperationRunning(agentOperation);
-  const activeGenerationError =
-    isDraftFoundationOperation(agentOperation) &&
-    agentOperation.status === 'failed'
-      ? agentOperation.error || agentOperation.phaseDetail
-      : null;
-
-  const leaveCustomWorldResult = () => {
-    setGeneratedCustomWorldProfile(null);
-    setCustomWorldError(null);
-    setCustomWorldAutoSaveError(null);
-    setCustomWorldAutoSaveState('idle');
-    setCustomWorldGenerationViewSource(null);
-    setCustomWorldResultViewSource(null);
-    setSelectionStage(
-      isAgentDraftResultView
-        ? 'agent-workspace'
-        : selectedDetailEntry
-          ? 'detail'
-          : 'platform',
-    );
-  };
-
-  const openCreationTypePicker = () => {
-    if (isCreatingAgentSession) {
-      return;
-    }
-
-    if (!hasSavedGame) {
-      handleStartNewGame();
-    }
-
-    setCreationTypeError(null);
-    setShowCreationTypeModal(true);
-  };
-
-  const openRpgAgentWorkspace = async (seedText = '') => {
-    if (isCreatingAgentSession) {
-      return;
-    }
-
-    setIsCreatingAgentSession(true);
-    setCreationTypeError(null);
-    isAgentDraftResultAutoOpenSuppressedRef.current = false;
-
-    try {
-      const { session } = await createCustomWorldAgentSession(
-        seedText ? { seedText } : {},
-      );
-      setAgentSession(session);
-      setAgentOperation(null);
-      setGeneratedCustomWorldProfile(null);
-      setCustomWorldAutoSaveError(null);
-      setCustomWorldAutoSaveState('idle');
-      setAgentDraftGenerationStartedAt(null);
-      setCustomWorldGenerationViewSource(null);
-      setCustomWorldResultViewSource(null);
-      persistAgentUiState(session.sessionId, null);
-      setShowCreationTypeModal(false);
-      setPlatformTab('create');
-      setSelectionStage('agent-workspace');
-    } catch (error) {
-      setCreationTypeError(resolveErrorMessage(error, '开启共创工作台失败。'));
-    } finally {
-      setIsCreatingAgentSession(false);
-    }
-  };
-
-  const submitAgentMessage = async (
-    payload: SendCustomWorldAgentMessageRequest,
-  ) => {
-    if (!activeAgentSessionId) {
-      return;
-    }
-
-    const optimisticUserMessage = buildOptimisticAgentMessage({
-      id: payload.clientMessageId,
-      role: 'user',
-      kind: 'chat',
-      text: payload.text.trim(),
-    });
-
-    setAgentOperation(null);
-    persistAgentUiState(activeAgentSessionId, null);
-    setStreamingAgentReplyText('');
-    setIsStreamingAgentReply(true);
-    setAgentSession((current) =>
-      current
-        ? {
-            ...current,
-            messages: [...current.messages, optimisticUserMessage],
-            updatedAt: optimisticUserMessage.createdAt,
-          }
-        : current,
-    );
-
-    try {
-      const nextSession = await streamCustomWorldAgentMessage(
-        activeAgentSessionId,
-        payload,
-        {
-          onUpdate: (text) => {
-            setStreamingAgentReplyText(text);
-          },
-        },
-      );
-      setAgentSession(nextSession);
-      setAgentOperation(null);
-      setStreamingAgentReplyText('');
-    } catch (error) {
-      const errorMessage = resolveErrorMessage(error, '发送共创消息失败。');
-      setAgentSession((current) =>
-        current
-          ? {
-              ...current,
-              messages: [
-                ...current.messages,
-                buildOptimisticAgentMessage({
-                  id: `message-error-${Date.now()}`,
-                  role: 'assistant',
-                  kind: 'warning',
-                  text: errorMessage,
-                }),
-              ],
-              updatedAt: new Date().toISOString(),
-            }
-          : current,
-      );
-      setStreamingAgentReplyText('');
-      persistAgentUiState(activeAgentSessionId, null);
-    } finally {
-      setIsStreamingAgentReply(false);
-    }
-  };
-
-  const executeAgentAction = async (payload: CustomWorldAgentActionRequest) => {
-    if (!activeAgentSessionId) {
-      return;
-    }
-
-    const isDraftFoundationAction = payload.action === 'draft_foundation';
-
-    if (isDraftFoundationAction) {
-      isAgentDraftResultAutoOpenSuppressedRef.current = false;
-      setGeneratedCustomWorldProfile(null);
-      setCustomWorldError(null);
-      setCustomWorldAutoSaveError(null);
-      setCustomWorldAutoSaveState('idle');
-      setCustomWorldGenerationViewSource('agent-draft-foundation');
-      setCustomWorldResultViewSource(null);
-      setAgentDraftGenerationStartedAt(Date.now());
-      setSelectionStage('custom-world-generating');
-    }
-
-    try {
-      const { operation } = await executeCustomWorldAgentAction(
-        activeAgentSessionId,
-        payload,
-      );
-      setAgentOperation(operation);
-      persistAgentUiState(activeAgentSessionId, operation.operationId);
-    } catch (error) {
-      const errorMessage = resolveErrorMessage(error, '执行共创操作失败。');
-      setAgentOperation(
-        createFailedAgentOperation({
-          type:
-            payload.action === 'draft_foundation'
-              ? 'draft_foundation'
-              : payload.action,
-          phaseLabel: '执行操作失败',
-          error: errorMessage,
-        }),
-      );
-      persistAgentUiState(activeAgentSessionId, null);
-    }
-  };
-
-  const leaveAgentWorkspace = () => {
-    setPlatformTab('create');
-    setAgentOperation(null);
-    setStreamingAgentReplyText('');
-    setIsStreamingAgentReply(false);
-    setGeneratedCustomWorldProfile(null);
-    setCustomWorldAutoSaveError(null);
-    setCustomWorldAutoSaveState('idle');
-    setAgentDraftGenerationStartedAt(null);
-    setCustomWorldGenerationViewSource(null);
-    setCustomWorldResultViewSource(null);
-    persistAgentUiState(activeAgentSessionId, null);
-    setSelectionStage('platform');
-  };
-
-  const leaveAgentDraftGeneration = () => {
-    if (isDraftFoundationOperationRunning(agentOperation)) {
-      return;
-    }
-
-    setAgentDraftGenerationStartedAt(null);
-    setCustomWorldGenerationViewSource(null);
-    setSelectionStage('agent-workspace');
-  };
-
-  const leaveAgentDraftResult = () => {
-    isAgentDraftResultAutoOpenSuppressedRef.current = true;
-    setGeneratedCustomWorldProfile(null);
-    setCustomWorldError(null);
-    setCustomWorldAutoSaveError(null);
-    setCustomWorldAutoSaveState('idle');
-    setCustomWorldGenerationViewSource(null);
-    setCustomWorldResultViewSource(null);
-    setPlatformTab('create');
-    setSelectionStage('platform');
-  };
-
-  const retryAgentDraftGeneration = () => {
-    void executeAgentAction({
-      action: 'draft_foundation',
-    });
-  };
-
-  const openCustomWorldCreator = () => {
-    openCreationTypePicker();
-  };
-
-  const openLibraryDetail = useCallback(
-    (entry: CustomWorldLibraryEntry<CustomWorldProfile>) => {
-      if (entry.visibility === 'published') {
-        void appendBrowseHistoryEntry({
-          ownerUserId: entry.ownerUserId,
-          profileId: entry.profileId,
-          worldName: entry.worldName,
-          subtitle: entry.subtitle,
-          summaryText: entry.summaryText,
-          coverImageSrc: entry.coverImageSrc,
-          themeMode: entry.themeMode,
-          authorDisplayName: entry.authorDisplayName,
-        });
-      }
-      setSelectedDetailEntry(entry);
-      setDetailError(null);
-      setSelectionStage('detail');
-    },
-    [appendBrowseHistoryEntry, setSelectionStage],
-  );
-
-  const handleOpenCreationWork = useCallback(
-    async (work: CustomWorldWorkSummary) => {
-      if (work.status === 'draft' && work.sessionId) {
-        persistAgentUiState(work.sessionId, null);
-        setCustomWorldError(null);
-        setCustomWorldAutoSaveError(null);
-        setCustomWorldAutoSaveState('idle');
-        setCustomWorldGenerationViewSource(null);
-
-        const shouldOpenAgentWorkspace =
-          work.playableNpcCount <= 0 && work.landmarkCount <= 0;
-
-        if (shouldOpenAgentWorkspace) {
-          // 仅八锚点未整理成底稿时才恢复 Agent 对话工作区。
-          isAgentDraftResultAutoOpenSuppressedRef.current = true;
-          setGeneratedCustomWorldProfile(null);
-          setCustomWorldResultViewSource(null);
-          setPlatformTab('create');
-          setSelectionStage('agent-workspace');
-          return;
-        }
-
-        isAgentDraftResultAutoOpenSuppressedRef.current = false;
-        const latestSession = await syncAgentSessionSnapshot(work.sessionId);
-        const nextProfile = buildCustomWorldProfileFromAgentDraft(latestSession);
-        if (!nextProfile) {
-          setPlatformError('当前草稿还没有可编辑的结果页数据，请先继续补齐锚点。');
-          setPlatformTab('create');
-          setSelectionStage('agent-workspace');
-          return;
-        }
-
-        setGeneratedCustomWorldProfile(normalizeAgentBackedProfile(nextProfile));
-        setCustomWorldResultViewSource('agent-draft');
-        setPlatformTab('create');
-        setSelectionStage('custom-world-result');
-        return;
-      }
-
-      if (!work.profileId) {
-        return;
-      }
-
-      try {
-        let matchedEntry = savedCustomWorldEntries.find(
-          (entry) => entry.profileId === work.profileId,
-        );
-
-        if (!matchedEntry && authUi?.user) {
-          const latestLibraryEntries = await listCustomWorldLibrary();
-          setSavedCustomWorldEntries(latestLibraryEntries);
-          matchedEntry = latestLibraryEntries.find(
-            (entry) => entry.profileId === work.profileId,
-          );
-        }
-
-        if (matchedEntry) {
-          openLibraryDetail(matchedEntry);
-          return;
-        }
-
-        setPlatformError('未找到对应作品，请刷新后重试。');
-      } catch (error) {
-        setPlatformError(resolveErrorMessage(error, '读取作品详情失败。'));
-      }
-    },
-    [
-      authUi?.user,
-      openLibraryDetail,
-      persistAgentUiState,
-      savedCustomWorldEntries,
-      syncAgentSessionSnapshot,
-      setSelectionStage,
-    ],
-  );
-
-  const openGalleryDetail = async (entry: CustomWorldGalleryCard) => {
-    setSelectionStage('detail');
-    setIsDetailLoading(true);
-    setDetailError(null);
-    try {
-      const detailEntry = await getCustomWorldGalleryDetail(
-        entry.ownerUserId,
-        entry.profileId,
-      );
-      setSelectedDetailEntry(detailEntry);
-      void appendBrowseHistoryEntry({
-        ownerUserId: detailEntry.ownerUserId,
-        profileId: detailEntry.profileId,
-        worldName: detailEntry.worldName,
-        subtitle: detailEntry.subtitle,
-        summaryText: detailEntry.summaryText,
-        coverImageSrc: detailEntry.coverImageSrc,
-        themeMode: detailEntry.themeMode,
-        authorDisplayName: detailEntry.authorDisplayName,
-      });
-    } catch (error) {
-      setSelectedDetailEntry(null);
-      setDetailError(resolveErrorMessage(error, '读取作品详情失败。'));
-    } finally {
-      setIsDetailLoading(false);
-    }
-  };
-
-  const handleResumeSaveEntry = useCallback(
-    async (entry: ProfileSaveArchiveSummary) => {
-      if (!authUi?.user || isResumingSaveWorldKey) {
-        return;
-      }
-
-      setIsResumingSaveWorldKey(entry.worldKey);
-      setSaveError(null);
-
-      try {
-        const resumedArchive = await resumeProfileSaveArchive(entry.worldKey);
-        setSaveEntries((currentEntries) =>
-          currentEntries.map((currentEntry) =>
-            currentEntry.worldKey === resumedArchive.entry.worldKey
-              ? resumedArchive.entry
-              : currentEntry,
-          ),
-        );
-        handleContinueGame(resumedArchive.snapshot);
-      } catch (error) {
-        setSaveError(resolveErrorMessage(error, '恢复存档失败。'));
-      } finally {
-        setIsResumingSaveWorldKey(null);
-      }
-    },
-    [authUi?.user, handleContinueGame, isResumingSaveWorldKey],
-  );
-
-  const saveGeneratedCustomWorld = useCallback(
-    async (profile = generatedCustomWorldProfile) => {
-      if (!profile) {
-        return null;
-      }
-
-      const normalizedProfile = normalizeAgentBackedProfile(profile);
-      const profileSignature = stringifyAgentBackedProfile(normalizedProfile);
-      const requestId = latestAutoSaveRequestIdRef.current + 1;
-      latestAutoSaveRequestIdRef.current = requestId;
-      setCustomWorldAutoSaveState('saving');
-      setCustomWorldAutoSaveError(null);
-
-      try {
-        const mutation = await upsertCustomWorldProfile(normalizedProfile);
-        if (latestAutoSaveRequestIdRef.current !== requestId) {
-          return mutation;
-        }
-
-        lastAutoSavedProfileSignatureRef.current = profileSignature;
-        setSavedCustomWorldEntries(mutation.entries);
-        if (authUi?.user) {
-          void refreshCustomWorldWorks().catch(() => {});
-        }
-        setSelectedDetailEntry((current) => {
-          if (!current || current.profileId === mutation.entry.profileId) {
-            return mutation.entry;
-          }
-
-          return current;
-        });
-        setCustomWorldAutoSaveState('saved');
-        setCustomWorldAutoSaveError(null);
-        return mutation;
-      } catch (error) {
-        if (latestAutoSaveRequestIdRef.current !== requestId) {
-          return null;
-        }
-
-        setCustomWorldAutoSaveState('error');
-        setCustomWorldAutoSaveError(
-          resolveErrorMessage(error, '保存自定义世界失败。'),
-        );
-        return null;
-      }
-    },
-    [authUi?.user, generatedCustomWorldProfile, refreshCustomWorldWorks],
-  );
-
-  const syncAgentDraftResultProfile = useCallback(
-    async (profile: CustomWorldProfile) => {
-      if (!activeAgentSessionId) {
-        return {
-          session: null,
-          profile: null,
-        } satisfies SyncedAgentDraftResult;
-      }
-
-      const normalizedProfile = normalizeAgentBackedProfile(profile);
-      const profileSignature = stringifyAgentBackedProfile(normalizedProfile);
-      const latestSessionProfileSignature =
-        agentSession && buildCustomWorldProfileFromAgentDraft(agentSession)
-          ? stringifyAgentBackedProfile(
-              buildCustomWorldProfileFromAgentDraft(agentSession)!,
-            )
-          : '';
-      if (latestSessionProfileSignature === profileSignature) {
-        latestAgentResultSyncSignatureRef.current = profileSignature;
-        return {
-          session: agentSession,
-          profile: normalizeAgentBackedProfile(
-            buildCustomWorldProfileFromAgentDraft(agentSession) ?? profile,
-          ),
-        } satisfies SyncedAgentDraftResult;
-      }
-      if (latestAgentResultSyncSignatureRef.current === profileSignature) {
-        return {
-          session: agentSession,
-          profile: normalizeAgentBackedProfile(
-            buildCustomWorldProfileFromAgentDraft(agentSession) ?? profile,
-          ),
-        } satisfies SyncedAgentDraftResult;
-      }
-
-      const { operation } = await executeCustomWorldAgentAction(
-        activeAgentSessionId,
-        {
-          action: 'sync_result_profile',
-          profile: normalizedProfile as unknown as Record<string, unknown>,
-        },
-      );
-      setAgentOperation(operation);
-      persistAgentUiState(activeAgentSessionId, operation.operationId);
-
-      for (let attempt = 0; attempt < 60; attempt += 1) {
-        const latestOperation = await getCustomWorldAgentOperation(
-          activeAgentSessionId,
-          operation.operationId,
-        );
-        setAgentOperation(latestOperation);
-
-        if (latestOperation.status === 'failed') {
-          throw new Error(
-            latestOperation.error ||
-              latestOperation.phaseDetail ||
-              '同步结果页世界快照失败。',
-          );
-        }
-
-        if (latestOperation.status === 'completed') {
-          persistAgentUiState(activeAgentSessionId, null);
-          const latestSession = await syncAgentSessionSnapshot(
-            activeAgentSessionId,
-          );
-          // 同步完成后统一从最新 session 重编译结果，保证结果页、作品库和进入世界吃同一份快照。
-          const latestProfile = normalizeAgentBackedProfile(
-            buildCustomWorldProfileFromAgentDraft(latestSession) ?? profile,
-          );
-          if (latestProfile) {
-            setGeneratedCustomWorldProfile(latestProfile);
-          }
-          latestAgentResultSyncSignatureRef.current = profileSignature;
-          return {
-            session: latestSession,
-            profile: latestProfile,
-          } satisfies SyncedAgentDraftResult;
-        }
-
-        await new Promise((resolve) => window.setTimeout(resolve, 200));
-      }
-
-      throw new Error('同步结果页世界快照超时。');
-    },
-    [
-      activeAgentSessionId,
-      agentSession,
-      persistAgentUiState,
-      syncAgentSessionSnapshot,
-    ],
-  );
-
-  useEffect(() => {
-    if (!generatedCustomWorldProfile) {
-      setCustomWorldAutoSaveState('idle');
-      setCustomWorldAutoSaveError(null);
-      lastAutoSavedProfileSignatureRef.current = null;
-      latestAgentResultSyncSignatureRef.current = null;
-      if (customWorldAutoSaveTimeoutRef.current !== null) {
-        window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
-        customWorldAutoSaveTimeoutRef.current = null;
-      }
-      return;
-    }
-
-    if (selectionStage !== 'custom-world-result') {
-      return;
-    }
-
-    if (isCustomWorldAutoSaveBusyRef.current) {
-      return;
-    }
-
-    const nextSignature = stringifyAgentBackedProfile(generatedCustomWorldProfile);
-    if (nextSignature === lastAutoSavedProfileSignatureRef.current) {
-      return;
-    }
-
-    setCustomWorldAutoSaveState('saving');
-    if (customWorldAutoSaveTimeoutRef.current !== null) {
-      window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
-    }
-
-    const profileToSave = generatedCustomWorldProfile;
-    customWorldAutoSaveTimeoutRef.current = window.setTimeout(() => {
-      void (async () => {
-        isCustomWorldAutoSaveBusyRef.current = true;
-        try {
-          let latestProfileToSave = normalizeAgentBackedProfile(profileToSave);
-          if (isAgentDraftResultView) {
-            const syncedResult =
-              await syncAgentDraftResultProfile(profileToSave);
-            // 作品库自动保存优先落同步后 session 重编译出的结果，避免继续保存旧的前端内存态。
-            latestProfileToSave = normalizeAgentBackedProfile(
-              syncedResult.profile ?? profileToSave,
-            );
-          }
-          await saveGeneratedCustomWorld(latestProfileToSave);
-        } catch (error) {
-          setCustomWorldAutoSaveState('error');
-          setCustomWorldAutoSaveError(
-            resolveErrorMessage(error, '保存自定义世界失败。'),
-          );
-        } finally {
-          isCustomWorldAutoSaveBusyRef.current = false;
-        }
-      })();
-      customWorldAutoSaveTimeoutRef.current = null;
-    }, 600);
-
-    return () => {
-      if (customWorldAutoSaveTimeoutRef.current !== null) {
-        window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
-        customWorldAutoSaveTimeoutRef.current = null;
-      }
-    };
-  }, [
-    generatedCustomWorldProfile,
-    isAgentDraftResultView,
-    saveGeneratedCustomWorld,
-    selectionStage,
-    syncAgentDraftResultProfile,
-  ]);
-
-  const openSavedCustomWorldEditor = (
-    entry: CustomWorldLibraryEntry<CustomWorldProfile>,
-  ) => {
-    setSelectedDetailEntry(entry);
-    const normalizedProfile = normalizeAgentBackedProfile(entry.profile);
-    setGeneratedCustomWorldProfile(normalizedProfile);
-    lastAutoSavedProfileSignatureRef.current =
-      JSON.stringify(normalizedProfile);
-    setCustomWorldAutoSaveState('saved');
-    setCustomWorldAutoSaveError(null);
-    setCustomWorldError(null);
-    setCustomWorldGenerationViewSource(null);
-    setCustomWorldResultViewSource('saved-profile');
-    setSelectionStage('custom-world-result');
-  };
-
-  const handleStartSelectedWorld = () => {
-    if (!selectedDetailEntry) {
-      return;
-    }
-
-    runProtectedAction(() => {
-      handleCustomWorldSelect(selectedDetailEntry.profile);
-    });
-  };
-
-  const handlePublishSelectedWorld = async () => {
-    if (!selectedDetailEntry || isMutatingDetail) {
-      return;
-    }
-
-    setIsMutatingDetail(true);
-    setDetailError(null);
-    try {
-      const mutation = await publishCustomWorldProfile(
-        selectedDetailEntry.profileId,
-      );
-      setSavedCustomWorldEntries(mutation.entries);
-      await refreshCustomWorldWorks().catch(() => []);
-      setSelectedDetailEntry(mutation.entry);
-      setPublishedGalleryEntries(await listCustomWorldGallery());
-    } catch (error) {
-      setDetailError(resolveErrorMessage(error, '发布自定义世界失败。'));
-    } finally {
-      setIsMutatingDetail(false);
-    }
-  };
-
-  const handleUnpublishSelectedWorld = async () => {
-    if (!selectedDetailEntry || isMutatingDetail) {
-      return;
-    }
-
-    setIsMutatingDetail(true);
-    setDetailError(null);
-    try {
-      const mutation = await unpublishCustomWorldProfile(
-        selectedDetailEntry.profileId,
-      );
-      setSavedCustomWorldEntries(mutation.entries);
-      await refreshCustomWorldWorks().catch(() => []);
-      setSelectedDetailEntry(mutation.entry);
-      setPublishedGalleryEntries(await listCustomWorldGallery());
-    } catch (error) {
-      setDetailError(resolveErrorMessage(error, '下架自定义世界失败。'));
-    } finally {
-      setIsMutatingDetail(false);
-    }
-  };
-
-  const handleDeleteSelectedWorld = async () => {
-    if (!selectedDetailEntry || isMutatingDetail) {
-      return;
-    }
-
-    const confirmed = window.confirm(
-      `确认删除作品《${selectedDetailEntry.worldName}》吗？删除后会从你的作品列表和公开广场中移除。`,
-    );
-    if (!confirmed) {
-      return;
-    }
-
-    setIsMutatingDetail(true);
-    setDetailError(null);
-    try {
-      const entries = await deleteCustomWorldProfile(
-        selectedDetailEntry.profileId,
-      );
-      setSavedCustomWorldEntries(entries);
-      await refreshCustomWorldWorks().catch(() => []);
-      setSelectedDetailEntry(null);
-      setPlatformTab('create');
-      setSelectionStage('platform');
-      setPublishedGalleryEntries(await listCustomWorldGallery());
-    } catch (error) {
-      setDetailError(resolveErrorMessage(error, '删除自定义世界失败。'));
-    } finally {
-      setIsMutatingDetail(false);
-    }
-  };
-
-  const isSelectedWorldOwned = Boolean(
-    selectedDetailEntry &&
-      savedCustomWorldEntries.some(
-        (entry) =>
-          entry.ownerUserId === selectedDetailEntry.ownerUserId &&
-          entry.profileId === selectedDetailEntry.profileId,
-      ),
-  );
-  const resultViewError = customWorldAutoSaveError ?? customWorldError;
-  const creationHubItems =
-    customWorldWorkEntries.length > 0
-      ? customWorldWorkEntries
-      : buildCreationHubFallbackItems(savedCustomWorldEntries);
-  const creationHubContent = (
-    <CustomWorldCreationHub
-      items={creationHubItems}
-      loading={isLoadingPlatform}
-      error={isLoadingPlatform ? null : (platformError ?? creationTypeError)}
-      onBack={() => {
-        setPlatformTab('home');
-      }}
-      onRetry={() => {
-        setPlatformError(null);
-        void refreshCustomWorldWorks().catch((error) => {
-          setPlatformError(
-            resolveErrorMessage(error, '读取创作作品列表失败。'),
-          );
-        });
-      }}
-      onCreateNew={openCreationTypePicker}
-      onOpenDraft={(item) => {
-        runProtectedAction(() => {
-          void handleOpenCreationWork(item);
-        });
-      }}
-      onEnterPublished={(profileId) => {
-        runProtectedAction(() => {
-          const matchedWork = creationHubItems.find(
-            (entry) => entry.profileId === profileId,
-          );
-          if (!matchedWork) {
-            return;
-          }
-          void handleOpenCreationWork(matchedWork);
-        });
-      }}
-    />
-  );
-
-  return (
-    <>
-      <AnimatePresence mode="wait">
-        {selectionStage === 'platform' && (
-          <motion.div
-            key="platform-home"
-            initial={{ opacity: 0, y: 12 }}
-            animate={{ opacity: 1, y: 0 }}
-            exit={{ opacity: 0, y: -12 }}
-            className="flex h-full min-h-0 flex-col"
-          >
-            <PlatformHomeView
-              activeTab={platformTab}
-              onTabChange={setPlatformTab}
-              hasSavedGame={hasSavedGame}
-              savedSnapshot={savedSnapshot}
-              saveEntries={saveEntries}
-              saveError={saveError}
-              featuredEntries={featuredGalleryEntries}
-              latestEntries={publishedGalleryEntries}
-              myEntries={savedCustomWorldEntries}
-              historyEntries={historyEntries}
-              profileDashboard={profileDashboard}
-              isLoadingPlatform={isLoadingPlatform}
-              isLoadingDashboard={isLoadingDashboard}
-              isResumingSaveWorldKey={isResumingSaveWorldKey}
-              platformError={
-                isLoadingPlatform ? null : (platformError ?? creationTypeError)
-              }
-              dashboardError={isLoadingDashboard ? null : dashboardError}
-              createTabContent={creationHubContent}
-              onContinueGame={handleContinueGame}
-              onResumeSave={(entry) => {
-                void handleResumeSaveEntry(entry);
-              }}
-              onOpenCreateWorld={openCustomWorldCreator}
-              onOpenCreateTypePicker={openCreationTypePicker}
-              onOpenGalleryDetail={(entry) => {
-                runProtectedAction(() => {
-                  void openGalleryDetail(entry);
-                });
-              }}
-              onOpenLibraryDetail={(entry) => {
-                runProtectedAction(() => {
-                  openLibraryDetail(entry);
-                });
-              }}
-              onOpenProfileDashboardCard={() => {
-                if (dashboardError) {
-                  void refreshProfileDashboard();
-                }
-              }}
-            />
-          </motion.div>
-        )}
-
-        {selectionStage === 'detail' && (
-          <motion.div
-            key="platform-detail"
-            initial={{ opacity: 0, y: 12 }}
-            animate={{ opacity: 1, y: 0 }}
-            exit={{ opacity: 0, y: -12 }}
-            className="flex h-full min-h-0 flex-col"
-          >
-            {isDetailLoading || !selectedDetailEntry ? (
-              <div className="flex h-full items-center justify-center">
-                <div className="platform-subpanel rounded-2xl px-5 py-4 text-sm text-[var(--platform-text-base)]">
-                  {detailError || '正在读取作品详情...'}
-                </div>
-              </div>
-            ) : (
-              <PlatformWorldDetailView
-                entry={selectedDetailEntry}
-                isMutating={isMutatingDetail}
-                error={detailError}
-                onBack={() => {
-                  setDetailError(null);
-                  setSelectionStage('platform');
-                }}
-                onStartGame={handleStartSelectedWorld}
-                onContinueEdit={
-                  isSelectedWorldOwned
-                    ? () => {
-                        runProtectedAction(() => {
-                          openSavedCustomWorldEditor(selectedDetailEntry);
-                        });
-                      }
-                    : null
-                }
-                onPublish={
-                  selectedDetailEntry.visibility === 'draft' &&
-                  isSelectedWorldOwned
-                    ? () => {
-                        runProtectedAction(() => {
-                          void handlePublishSelectedWorld();
-                        });
-                      }
-                    : null
-                }
-                onUnpublish={
-                  selectedDetailEntry.visibility === 'published' &&
-                  isSelectedWorldOwned
-                    ? () => {
-                        runProtectedAction(() => {
-                          void handleUnpublishSelectedWorld();
-                        });
-                      }
-                    : null
-                }
-                onDelete={
-                  isSelectedWorldOwned
-                    ? () => {
-                        runProtectedAction(() => {
-                          void handleDeleteSelectedWorld();
-                        });
-                      }
-                    : null
-                }
-              />
-            )}
-          </motion.div>
-        )}
-
-        {selectionStage === 'agent-workspace' && (
-          <motion.div
-            key="agent-workspace"
-            initial={{ opacity: 0, y: 12 }}
-            animate={{ opacity: 1, y: 0 }}
-            exit={{ opacity: 0, y: -12 }}
-            className="flex h-full min-h-0 flex-col"
-          >
-            <Suspense
-              fallback={
-                <LazyPanelFallback label="正在加载 Agent 共创工作区..." />
-              }
-            >
-              {agentSession ? (
-                <CustomWorldAgentWorkspace
-                  session={agentSession}
-                  activeOperation={agentOperation}
-                  streamingReplyText={streamingAgentReplyText}
-                  isStreamingReply={isStreamingAgentReply}
-                  onBack={leaveAgentWorkspace}
-                  onSubmitMessage={(payload) => {
-                    void submitAgentMessage(payload);
-                  }}
-                  onExecuteAction={(payload) => {
-                    void executeAgentAction(payload);
-                  }}
-                />
-              ) : (
-                <div className="flex h-full items-center justify-center">
-                  <div className="platform-subpanel rounded-2xl px-5 py-4 text-sm text-[var(--platform-text-base)]">
-                    {isLoadingAgentSession
-                      ? '正在准备 Agent 共创工作区...'
-                      : creationTypeError || '正在恢复创作工作区...'}
-                  </div>
-                </div>
-              )}
-            </Suspense>
-          </motion.div>
-        )}
-
-        {selectionStage === 'custom-world-generating' && (
-          <motion.div
-            key="custom-world-generating"
-            initial={{ opacity: 0, y: 12 }}
-            animate={{ opacity: 1, y: 0 }}
-            exit={{ opacity: 0, y: -12 }}
-            className="flex h-full min-h-0 flex-col"
-          >
-            <Suspense
-              fallback={<LazyPanelFallback label="正在加载世界生成面板..." />}
-            >
-              <CustomWorldGenerationView
-                settingText={activeGenerationSettingText}
-                anchorEntries={agentDraftAnchorPreviewEntries}
-                progress={activeGenerationProgress}
-                isGenerating={isActiveGenerationRunning}
-                error={activeGenerationError}
-                onBack={leaveAgentDraftGeneration}
-                onEditSetting={leaveAgentDraftGeneration}
-                onRetry={retryAgentDraftGeneration}
-                onInterrupt={undefined}
-                backLabel="返回工作区"
-                settingActionLabel={null}
-                retryLabel="重新生成草稿"
-                settingTitle="当前世界信息"
-                settingDescription={null}
-                progressTitle={
-                  isAgentDraftGenerationView ? '世界草稿生成进度' : undefined
-                }
-                activeBadgeLabel={
-                  isAgentDraftGenerationView ? '草稿编译中' : undefined
-                }
-                pausedBadgeLabel={
-                  isAgentDraftGenerationView ? '草稿生成已暂停' : undefined
-                }
-                idleBadgeLabel={
-                  isAgentDraftGenerationView ? '等待返回工作区' : undefined
-                }
-              />
-            </Suspense>
-          </motion.div>
-        )}
-
-        {selectionStage === 'custom-world-result' &&
-          generatedCustomWorldProfile && (
-            <motion.div
-              key="custom-world-result"
-              initial={{ opacity: 0, y: 12 }}
-              animate={{ opacity: 1, y: 0 }}
-              exit={{ opacity: 0, y: -12 }}
-              className="flex h-full min-h-0 flex-col"
-            >
-              <Suspense
-                fallback={<LazyPanelFallback label="正在加载世界编辑器..." />}
-              >
-                <CustomWorldResultView
-                  profile={generatedCustomWorldProfile}
-                  previewCharacters={previewCustomWorldCharacters}
-                  isGenerating={false}
-                  progress={0}
-                  progressLabel=""
-                  error={resultViewError}
-                  onProfileChange={(profile) => {
-                    setGeneratedCustomWorldProfile(
-                      normalizeAgentBackedProfile(profile),
-                    );
-                  }}
-                  onBack={
-                    isAgentDraftResultView
-                      ? () => {
-                          void (async () => {
-                            const currentProfile =
-                              generatedCustomWorldProfile ??
-                              buildCustomWorldProfileFromAgentDraft(
-                                agentSession,
-                              );
-
-                            if (currentProfile && activeAgentSessionId) {
-                              await syncAgentDraftResultProfile(currentProfile);
-                            }
-
-                            leaveAgentDraftResult();
-                          })().catch((error) => {
-                            setCustomWorldError(
-                              resolveErrorMessage(
-                                error,
-                                '返回创作前同步草稿失败。',
-                              ),
-                            );
-                          });
-                        }
-                      : leaveCustomWorldResult
-                  }
-                  onEditSetting={undefined}
-                  onRegenerate={undefined}
-                  onContinueExpand={undefined}
-                  onEnterWorld={() => {
-                    runProtectedAction(() => {
-                      void (async () => {
-                        if (!isAgentDraftResultView || !activeAgentSessionId) {
-                          handleCustomWorldSelect(generatedCustomWorldProfile);
-                          return;
-                        }
-
-                        const currentProfile =
-                          generatedCustomWorldProfile ??
-                          buildCustomWorldProfileFromAgentDraft(agentSession);
-                        if (!currentProfile) {
-                          return;
-                        }
-
-                        const latestResult = await syncAgentDraftResultProfile(
-                          currentProfile,
-                        );
-                        const latestProfile = normalizeAgentBackedProfile(
-                          buildCustomWorldProfileFromAgentDraft(
-                            latestResult.session ?? agentSession,
-                          ) ??
-                            latestResult.profile ??
-                            currentProfile,
-                        );
-                        setGeneratedCustomWorldProfile(latestProfile);
-                        handleCustomWorldSelect(latestProfile);
-                      })().catch((error) => {
-                        setCustomWorldError(
-                          resolveErrorMessage(error, '进入世界前同步草稿失败。'),
-                        );
-                      });
-                    });
-                  }}
-                  readOnly={false}
-                  compactAgentResultMode={isAgentDraftResultView}
-                  backLabel={isAgentDraftResultView ? '返回创作' : undefined}
-                  editActionLabel="继续调整设定"
-                  enterWorldActionLabel="进入世界"
-                  autoSaveState={customWorldAutoSaveState}
-                />
-              </Suspense>
-            </motion.div>
-          )}
-      </AnimatePresence>
-
-      <PlatformCreationTypeModal
-        isOpen={showCreationTypeModal}
-        isBusy={isCreatingAgentSession}
-        error={creationTypeError}
-        onClose={() => {
-          if (isCreatingAgentSession) {
-            return;
-          }
-          setShowCreationTypeModal(false);
-        }}
-        onSelectRpg={() => {
-          runProtectedAction(() => {
-            void openRpgAgentWorkspace();
-          });
-        }}
-      />
-    </>
-  );
-}
diff --git a/src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx b/src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx
deleted file mode 100644
index 45dc8263..00000000
--- a/src/components/game-shell/rpg-creation-flow/RpgCreationShell.tsx
+++ /dev/null
@@ -1,15 +0,0 @@
-import type { ComponentProps } from 'react';
-
-import { PreGameSelectionFlow } from '../PreGameSelectionFlow';
-
-/**
- * 工作包 A 先建立 RPG 创作壳层的新命名入口。
- * 当前实现继续复用旧的 `PreGameSelectionFlow`，后续工作包 B 再把内部编排逐步迁到新目录。
- */
-export type RpgCreationShellProps = ComponentProps<typeof PreGameSelectionFlow>;
-
-export function RpgCreationShell(props: RpgCreationShellProps) {
-  return <PreGameSelectionFlow {...props} />;
-}
-
-export default RpgCreationShell;
diff --git a/src/components/game-shell/rpg-creation-flow/index.ts b/src/components/game-shell/rpg-creation-flow/index.ts
deleted file mode 100644
index fa548875..00000000
--- a/src/components/game-shell/rpg-creation-flow/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-export {
-  RpgCreationShell,
-  type RpgCreationShellProps,
-} from './RpgCreationShell';
diff --git a/src/components/game-shell/useSceneTransitionModel.ts b/src/components/game-shell/useSceneTransitionModel.ts
deleted file mode 100644
index d1cafd68..00000000
--- a/src/components/game-shell/useSceneTransitionModel.ts
+++ /dev/null
@@ -1,185 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
-
-import type {
-  GameState,
-  StoryMoment,
-} from '../../types';
-
-export type SceneTransitionPhase = 'idle' | 'exiting' | 'entering';
-export type SceneTransitionTriggerMode = 'scene-change' | 'content-change';
-
-type SceneTransitionRequest = {
-  mode: SceneTransitionTriggerMode;
-  baselineSceneId: string | null;
-  baselineContentKey: string;
-  exitComplete: boolean;
-};
-
-const DEFAULT_SCENE_SWITCH_EXIT_MS = 5000;
-const DEFAULT_SCENE_SWITCH_ENTRY_MS = 5930;
-
-export const SCENE_TRANSITION_FUNCTION_MODES: Partial<Record<string, SceneTransitionTriggerMode>> = {
-  idle_travel_next_scene: 'scene-change',
-  camp_travel_home_scene: 'scene-change',
-  idle_explore_forward: 'content-change',
-  idle_follow_clue: 'content-change',
-};
-
-function buildSceneTransitionContentKey(gameState: GameState, currentStory: StoryMoment | null) {
-  const sceneId = gameState.currentScenePreset?.id ?? 'scene:none';
-  const encounterKey = gameState.currentEncounter
-    ? `${gameState.currentEncounter.kind}:${gameState.currentEncounter.id ?? gameState.currentEncounter.npcName ?? 'unknown'}`
-    : 'encounter:none';
-  const monsterKey = gameState.sceneHostileNpcs
-    .map(monster => `${monster.id}:${monster.renderKind}:${monster.xMeters}:${monster.animation}`)
-    .join('|');
-  const storyKey = currentStory
-    ? `${currentStory.displayMode ?? 'story'}:${currentStory.text ?? ''}:${currentStory.dialogue?.length ?? 0}`
-    : 'story:none';
-  return [sceneId, encounterKey, monsterKey, storyKey].join('::');
-}
-
-export function useSceneTransitionModel(params: {
-  gameState: GameState;
-  currentStory: StoryMoment | null;
-  openingCampSceneId: string | null;
-}) {
-  const {
-    gameState,
-    currentStory,
-    openingCampSceneId,
-  } = params;
-  const [renderGameState, setRenderGameState] = useState(gameState);
-  const [renderCurrentStory, setRenderCurrentStory] = useState(currentStory);
-  const [sceneTransitionPhase, setSceneTransitionPhase] = useState<SceneTransitionPhase>('idle');
-  const [sceneTransitionToken, setSceneTransitionToken] = useState(0);
-  const [sceneTransitionDurations, setSceneTransitionDurations] = useState({
-    exitMs: DEFAULT_SCENE_SWITCH_EXIT_MS,
-    entryMs: DEFAULT_SCENE_SWITCH_ENTRY_MS,
-  });
-
-  const pendingScenePayloadRef = useRef<{ gameState: GameState; currentStory: StoryMoment | null }>({
-    gameState,
-    currentStory,
-  });
-  const sceneTransitionTimerIdsRef = useRef<number[]>([]);
-  const sceneTransitionRequestRef = useRef<SceneTransitionRequest | null>(null);
-
-  useEffect(() => {
-    return () => {
-      sceneTransitionTimerIdsRef.current.forEach(timerId => window.clearTimeout(timerId));
-      sceneTransitionTimerIdsRef.current = [];
-      sceneTransitionRequestRef.current = null;
-    };
-  }, []);
-
-  const startSceneEntering = useCallback((payload: { gameState: GameState; currentStory: StoryMoment | null }) => {
-    sceneTransitionTimerIdsRef.current.forEach(timerId => window.clearTimeout(timerId));
-    sceneTransitionTimerIdsRef.current = [];
-    sceneTransitionRequestRef.current = null;
-    setRenderGameState(payload.gameState);
-    setRenderCurrentStory(payload.currentStory);
-    setSceneTransitionToken(current => current + 1);
-    setSceneTransitionPhase('entering');
-
-    const entryTimerId = window.setTimeout(() => {
-      setSceneTransitionPhase('idle');
-    }, sceneTransitionDurations.entryMs);
-    sceneTransitionTimerIdsRef.current.push(entryTimerId);
-  }, [sceneTransitionDurations.entryMs]);
-
-  const beginSceneTransition = useCallback((mode: SceneTransitionTriggerMode) => {
-    if (sceneTransitionPhase !== 'idle') return;
-
-    pendingScenePayloadRef.current = { gameState, currentStory };
-    sceneTransitionTimerIdsRef.current.forEach(timerId => window.clearTimeout(timerId));
-    sceneTransitionTimerIdsRef.current = [];
-    sceneTransitionRequestRef.current = {
-      mode,
-      baselineSceneId: renderGameState.currentScenePreset?.id ?? gameState.currentScenePreset?.id ?? null,
-      baselineContentKey: buildSceneTransitionContentKey(renderGameState, renderCurrentStory),
-      exitComplete: false,
-    };
-    setSceneTransitionPhase('exiting');
-
-    const exitTimerId = window.setTimeout(() => {
-      const request = sceneTransitionRequestRef.current;
-      if (!request) return;
-      request.exitComplete = true;
-
-      const pendingPayload = pendingScenePayloadRef.current;
-      const isReady = request.mode === 'scene-change'
-        ? (pendingPayload.gameState.currentScenePreset?.id ?? null) !== request.baselineSceneId
-        : buildSceneTransitionContentKey(pendingPayload.gameState, pendingPayload.currentStory) !== request.baselineContentKey;
-
-      if (isReady) {
-        startSceneEntering(pendingPayload);
-      }
-    }, sceneTransitionDurations.exitMs);
-    sceneTransitionTimerIdsRef.current.push(exitTimerId);
-  }, [
-    currentStory,
-    gameState,
-    renderCurrentStory,
-    renderGameState,
-    sceneTransitionDurations.exitMs,
-    sceneTransitionPhase,
-    startSceneEntering,
-  ]);
-
-  useEffect(() => {
-    pendingScenePayloadRef.current = { gameState, currentStory };
-
-    const request = sceneTransitionRequestRef.current;
-    if (sceneTransitionPhase === 'exiting' && request?.exitComplete) {
-      const isReady = request.mode === 'scene-change'
-        ? (gameState.currentScenePreset?.id ?? null) !== request.baselineSceneId
-        : buildSceneTransitionContentKey(gameState, currentStory) !== request.baselineContentKey;
-      if (isReady) {
-        startSceneEntering({ gameState, currentStory });
-      }
-      return;
-    }
-
-    if (sceneTransitionPhase !== 'exiting') {
-      setRenderGameState(gameState);
-      setRenderCurrentStory(currentStory);
-    }
-  }, [currentStory, gameState, sceneTransitionPhase, startSceneEntering]);
-
-  useEffect(() => {
-    if (sceneTransitionPhase !== 'idle') {
-      return;
-    }
-    if (renderGameState.playerCharacter) {
-      return;
-    }
-    if (!gameState.playerCharacter || gameState.currentScene !== 'Story') {
-      return;
-    }
-    if (gameState.storyHistory.length > 0) {
-      return;
-    }
-    if (!openingCampSceneId || gameState.currentScenePreset?.id !== openingCampSceneId) {
-      return;
-    }
-
-    startSceneEntering({ gameState, currentStory });
-  }, [
-    currentStory,
-    gameState,
-    openingCampSceneId,
-    renderGameState.playerCharacter,
-    sceneTransitionPhase,
-    startSceneEntering,
-  ]);
-
-  return {
-    visibleGameState: sceneTransitionPhase === 'idle' ? gameState : renderGameState,
-    visibleCurrentStory: sceneTransitionPhase === 'idle' ? currentStory : renderCurrentStory,
-    sceneTransitionPhase,
-    sceneTransitionToken,
-    setSceneTransitionDurations,
-    beginSceneTransition,
-  };
-}
diff --git a/src/components/rpg-creation-asset-studio/RpgCreationRoleAnimationSection.tsx b/src/components/rpg-creation-asset-studio/RpgCreationRoleAnimationSection.tsx
new file mode 100644
index 00000000..eadf4a77
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/RpgCreationRoleAnimationSection.tsx
@@ -0,0 +1,244 @@
+import type { ComponentType, CSSProperties, ReactNode } from 'react';
+import { RefreshCcw } from 'lucide-react';
+
+import {
+  type AnimationState,
+  type Character,
+} from '../../types';
+import { CORE_ACTIONS } from './roleAssetStudioModel';
+
+type ActionButtonProps = {
+  icon?: ReactNode;
+  label: string;
+  subLabel?: string;
+  onClick: () => void;
+  disabled?: boolean;
+  tone?: 'default' | 'sky' | 'green';
+};
+
+type FieldProps = {
+  label: string;
+  children: ReactNode;
+};
+
+type SectionProps = {
+  title: string;
+  children: ReactNode;
+};
+
+type StatusBadgeProps = {
+  tone: 'green' | 'amber' | 'zinc';
+  children: ReactNode;
+};
+
+type TextAreaProps = {
+  value: string;
+  onChange: (value: string) => void;
+  rows?: number;
+  placeholder?: string;
+  readOnly?: boolean;
+};
+
+type CharacterAnimatorProps = {
+  state: AnimationState;
+  character: Character;
+  className?: string;
+  style?: CSSProperties;
+  imageClassName?: string;
+  playbackRate?: number;
+};
+
+export function RpgCreationRoleAnimationSection(props: {
+  ActionButton: (props: ActionButtonProps) => ReactNode;
+  CharacterAnimator: ComponentType<CharacterAnimatorProps>;
+  Field: (props: FieldProps) => ReactNode;
+  Section: (props: SectionProps) => ReactNode;
+  StatusBadge: (props: StatusBadgeProps) => ReactNode;
+  TextArea: (props: TextAreaProps) => ReactNode;
+  animationPreviewFrameStyle: CSSProperties;
+  animationPreviewPlaybackRate: number;
+  animationPreviewViewportStyle: CSSProperties;
+  animationPromptText: string;
+  generatingAnimationMap: Partial<Record<AnimationState, boolean>>;
+  hasGeneratedAnimation: (animation: AnimationState) => boolean;
+  isSelectedAnimationGenerating: boolean;
+  previewCharacter: Character | null;
+  previewImageSrc: string;
+  selectedAnimation: AnimationState;
+  selectedAnimationStatus: string | null;
+  shouldUseSelectedAnimationPreview: boolean;
+  syncBusy: boolean;
+  animationPointCost: number;
+  workingRoleImageSrc?: string;
+  workingRoleGeneratedVisualAssetId?: string;
+  workingRoleName: string;
+  onAnimationPromptChange: (value: string) => void;
+  onGenerateAnimation: () => void;
+  onPlaybackRateChange: (value: number) => void;
+  onSelectAnimation: (animation: AnimationState) => void;
+}) {
+  const {
+    ActionButton,
+    CharacterAnimator,
+    Field,
+    Section,
+    StatusBadge,
+    TextArea,
+    animationPreviewFrameStyle,
+    animationPreviewPlaybackRate,
+    animationPreviewViewportStyle,
+    animationPromptText,
+    generatingAnimationMap,
+    hasGeneratedAnimation,
+    isSelectedAnimationGenerating,
+    previewCharacter,
+    previewImageSrc,
+    selectedAnimation,
+    selectedAnimationStatus,
+    shouldUseSelectedAnimationPreview,
+    syncBusy,
+    animationPointCost,
+    workingRoleGeneratedVisualAssetId,
+    workingRoleImageSrc,
+    workingRoleName,
+    onAnimationPromptChange,
+    onGenerateAnimation,
+    onPlaybackRateChange,
+    onSelectAnimation,
+  } = props;
+
+  return (
+    <Section title="动作">
+      <div className="space-y-4">
+        <div className="platform-role-studio__preview rounded-3xl p-4">
+          <div className="platform-role-studio__stage flex min-h-[28rem] items-center justify-center rounded-2xl p-4">
+            {shouldUseSelectedAnimationPreview && previewCharacter ? (
+              <div
+                className="flex items-center justify-center"
+                style={animationPreviewViewportStyle}
+              >
+                <div style={animationPreviewFrameStyle}>
+                  <CharacterAnimator
+                    state={selectedAnimation}
+                    character={previewCharacter}
+                    className="h-full w-full"
+                  />
+                </div>
+              </div>
+            ) : previewImageSrc ? (
+              <img
+                src={previewImageSrc}
+                alt={workingRoleName}
+                className="max-h-[28rem] w-full object-contain pixelated"
+              />
+            ) : (
+              <div className="px-4 text-sm text-zinc-500">暂无动作预览</div>
+            )}
+          </div>
+        </div>
+
+        <Field label="预览速度">
+          <div className="rounded-2xl border border-white/10 bg-black/20 px-4 py-3">
+            <input
+              type="range"
+              min="0.25"
+              max="1.5"
+              step="0.05"
+              value={animationPreviewPlaybackRate}
+              onChange={(event) =>
+                onPlaybackRateChange(Number.parseFloat(event.target.value) || 0.75)
+              }
+              className="w-full accent-sky-400"
+            />
+            <div className="mt-2 flex items-center justify-between text-[11px] text-zinc-400">
+              <span>0.25x</span>
+              <span>{animationPreviewPlaybackRate.toFixed(2)}x</span>
+              <span>1.50x</span>
+            </div>
+          </div>
+        </Field>
+
+        <div className="grid grid-cols-2 gap-2 sm:grid-cols-3 lg:grid-cols-5">
+          {CORE_ACTIONS.map((item) => {
+            const isSelected = item.animation === selectedAnimation;
+            const isReady = hasGeneratedAnimation(item.animation);
+            const isGenerating = generatingAnimationMap[item.animation] === true;
+
+            return (
+              <button
+                key={item.animation}
+                type="button"
+                onClick={() => onSelectAnimation(item.animation)}
+                className={`rounded-2xl border px-3 py-3 text-left transition-colors ${
+                  isSelected
+                    ? 'border-sky-300/30 bg-sky-500/10'
+                    : 'border-white/10 bg-black/20 hover:border-white/20'
+                }`}
+              >
+                <div className="flex items-start justify-between gap-2">
+                  <div className="min-w-0">
+                    <div className="text-sm font-semibold text-white">
+                      {item.label}
+                    </div>
+                    <div className="mt-1 flex flex-wrap items-center gap-2 text-[11px] text-zinc-400">
+                      {isGenerating
+                        ? '后台生成中'
+                        : isSelected
+                          ? '当前预览'
+                          : '点击切换'}
+                      <span>{item.required ? '必需动作' : '可选动作'}</span>
+                    </div>
+                  </div>
+                  <StatusBadge
+                    tone={isGenerating ? 'amber' : isReady ? 'green' : 'zinc'}
+                  >
+                    {isGenerating
+                      ? '生成中'
+                      : isReady
+                        ? '已生成'
+                        : item.required
+                          ? '待生成'
+                          : (item.fallbackStatusLabel ?? '可选')}
+                  </StatusBadge>
+                </div>
+              </button>
+            );
+          })}
+        </div>
+
+        <Field label="动作描述">
+          <TextArea
+            value={animationPromptText}
+            onChange={onAnimationPromptChange}
+            rows={5}
+            placeholder="这里默认展示角色动作描述，也可以继续手动细化。"
+          />
+        </Field>
+
+        <div className="flex flex-wrap gap-3">
+          <ActionButton
+            icon={<RefreshCcw className="h-4 w-4" />}
+            label={isSelectedAnimationGenerating ? '生成中...' : '生成动作'}
+            subLabel={`消耗${animationPointCost}叙世币`}
+            onClick={onGenerateAnimation}
+            disabled={
+              isSelectedAnimationGenerating ||
+              !workingRoleImageSrc ||
+              !workingRoleGeneratedVisualAssetId ||
+              syncBusy
+            }
+            tone="sky"
+          />
+        </div>
+
+        {selectedAnimationStatus ? (
+          <div className="rounded-2xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
+            {selectedAnimationStatus}
+          </div>
+        ) : null}
+      </div>
+    </Section>
+  );
+}
+
+export default RpgCreationRoleAnimationSection;
diff --git a/src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioFooter.tsx b/src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioFooter.tsx
new file mode 100644
index 00000000..d2b1b336
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioFooter.tsx
@@ -0,0 +1,53 @@
+export function RpgCreationRoleAssetStudioFooter(props: {
+  isSavingToRole: boolean;
+  saveStatus: string | null;
+  syncBusy: boolean;
+  workingRoleGeneratedVisualAssetId?: string;
+  workingRoleImageSrc?: string;
+  onSaveToRole: () => void;
+}) {
+  const {
+    isSavingToRole,
+    saveStatus,
+    syncBusy,
+    workingRoleGeneratedVisualAssetId,
+    workingRoleImageSrc,
+    onSaveToRole,
+  } = props;
+
+  return (
+    <div className="platform-role-studio__footer sticky bottom-0 z-10 -mx-4 px-4 pb-[calc(env(safe-area-inset-bottom,0px)+0.35rem)] pt-3 sm:mx-0 sm:rounded-3xl sm:border sm:border-[var(--platform-subpanel-border)] sm:px-4">
+      <div className="space-y-3">
+        {saveStatus ? (
+          <div className="rounded-2xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
+            {saveStatus}
+          </div>
+        ) : null}
+        <div className="flex flex-col-reverse gap-3 sm:flex-row sm:justify-end">
+          <button
+            type="button"
+            onClick={onSaveToRole}
+            disabled={
+              isSavingToRole ||
+              syncBusy ||
+              !workingRoleImageSrc ||
+              !workingRoleGeneratedVisualAssetId
+            }
+            className={`rounded-full border border-emerald-400/30 bg-emerald-500/10 px-5 py-2 text-sm font-semibold text-emerald-100 transition-colors hover:bg-emerald-500/20 ${
+              isSavingToRole ||
+              syncBusy ||
+              !workingRoleImageSrc ||
+              !workingRoleGeneratedVisualAssetId
+                ? 'cursor-not-allowed opacity-45'
+                : ''
+            }`}
+          >
+            {isSavingToRole || syncBusy ? '保存中...' : '保存到当前角色'}
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+export default RpgCreationRoleAssetStudioFooter;
diff --git a/src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioModal.tsx b/src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioModal.tsx
new file mode 100644
index 00000000..85bf51a5
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioModal.tsx
@@ -0,0 +1,21 @@
+import type { ComponentProps } from 'react';
+
+import {
+  RpgCreationRoleAssetStudioModal as RpgCreationRoleAssetStudioModalImpl,
+} from './RpgCreationRoleAssetStudioModalImpl';
+
+/**
+ * 工作包 C 完成后，角色资产工坊 façade 已直接桥接 RPG 创作目录下的真实实现。
+ * 旧入口仍保留兼容导出，后续视觉/动作工作流继续在该目录内部演进。
+ */
+export type RpgCreationRoleAssetStudioModalProps = ComponentProps<
+  typeof RpgCreationRoleAssetStudioModalImpl
+>;
+
+export function RpgCreationRoleAssetStudioModal(
+  props: RpgCreationRoleAssetStudioModalProps,
+) {
+  return <RpgCreationRoleAssetStudioModalImpl {...props} />;
+}
+
+export default RpgCreationRoleAssetStudioModal;
diff --git a/src/components/CustomWorldRoleAssetStudioModal.tsx b/src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioModalImpl.tsx
similarity index 62%
rename from src/components/CustomWorldRoleAssetStudioModal.tsx
rename to src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioModalImpl.tsx
index 41a37471..a2ab6898 100644
--- a/src/components/CustomWorldRoleAssetStudioModal.tsx
+++ b/src/components/rpg-creation-asset-studio/RpgCreationRoleAssetStudioModalImpl.tsx
@@ -1,4 +1,3 @@
-import { ImagePlus, RefreshCcw } from 'lucide-react';
 import {
   type ChangeEvent,
   type CSSProperties,
@@ -9,109 +8,33 @@ import {
 } from 'react';
 import { createPortal } from 'react-dom';
 
-import { ROLE_TEMPLATE_CHARACTERS } from '../data/characterPresets';
+import { ROLE_TEMPLATE_CHARACTERS } from '../../data/characterPresets';
 import {
   AnimationState,
   type Character,
   type CharacterAnimationConfig,
-} from '../types';
+} from '../../types';
+import { readFileAsDataUrl } from '../asset-studio/characterAssetWorkflowModel';
 import {
-  buildAnimationClipFromVideoSource,
-  readFileAsDataUrl,
-} from './asset-studio/characterAssetWorkflowModel';
-import {
-  type CharacterAnimationGenerationPayload,
   type CharacterAssetWorkflowCache,
   type CharacterVisualDraft,
   fetchCharacterWorkflowCache,
-  generateCharacterAnimationDraft,
-  generateCharacterVisualCandidates,
-  publishCharacterAnimationAssets,
-  publishCharacterVisualAsset,
   saveCharacterWorkflowCache,
-} from './asset-studio/characterAssetWorkflowPersistence';
-import { buildDefaultRolePromptBundle } from './asset-studio/customWorldRolePromptDefaults';
-import { buildProjectPixelStyleReferenceBoard } from './asset-studio/projectPixelStyleReference';
-import { useAuthUi } from './auth/AuthUiContext';
-import { CharacterAnimator } from './CharacterAnimator';
-
-type EditableCustomWorldRole = {
-  id: string;
-  name: string;
-  title: string;
-  role: string;
-  visualDescription?: string;
-  actionDescription?: string;
-  sceneVisualDescription?: string;
-  description?: string;
-  backstory?: string;
-  personality?: string;
-  motivation?: string;
-  combatStyle?: string;
-  tags?: string[];
-  templateCharacterId?: string;
-  imageSrc?: string;
-  generatedVisualAssetId?: string;
-  generatedAnimationSetId?: string;
-  animationMap?: Record<string, unknown>;
-};
-
-type CustomWorldAiActionConfig = {
-  animation: AnimationState;
-  label: string;
-  templateId: string;
-  fps: number;
-  frameCount: number;
-  durationSeconds: number;
-  loop: boolean;
-  required: boolean;
-  fallbackStatusLabel?: string;
-};
-
-const CORE_ACTIONS: CustomWorldAiActionConfig[] = [
-  {
-    animation: AnimationState.RUN,
-    label: '奔跑',
-    templateId: 'run',
-    fps: 12,
-    frameCount: 8,
-    durationSeconds: 4,
-    loop: true,
-    required: true,
-  },
-  {
-    animation: AnimationState.ATTACK,
-    label: '攻击',
-    templateId: 'attack_slash',
-    fps: 12,
-    frameCount: 8,
-    durationSeconds: 4,
-    loop: false,
-    required: true,
-  },
-  {
-    animation: AnimationState.IDLE,
-    label: '待机',
-    templateId: 'idle',
-    fps: 8,
-    frameCount: 8,
-    durationSeconds: 4,
-    loop: true,
-    required: false,
-    fallbackStatusLabel: '默认静止',
-  },
-  {
-    animation: AnimationState.DIE,
-    label: '死亡',
-    templateId: 'die',
-    fps: 8,
-    frameCount: 8,
-    durationSeconds: 4,
-    loop: false,
-    required: false,
-    fallbackStatusLabel: '默认倒地动画',
-  },
-];
+} from '../asset-studio/characterAssetWorkflowPersistence';
+import { buildDefaultRolePromptBundle } from '../asset-studio/customWorldRolePromptDefaults';
+import { buildProjectPixelStyleReferenceBoard } from '../asset-studio/projectPixelStyleReference';
+import { useAuthUi } from '../auth/AuthUiContext';
+import { CharacterAnimator } from '../CharacterAnimator';
+import { RpgCreationRoleAnimationSection } from './RpgCreationRoleAnimationSection';
+import { RpgCreationRoleAssetStudioFooter } from './RpgCreationRoleAssetStudioFooter';
+import { RpgCreationRoleVisualSection } from './RpgCreationRoleVisualSection';
+import {
+  CORE_ACTIONS,
+  type CustomWorldAiActionConfig,
+  type EditableCustomWorldRole,
+} from './roleAssetStudioModel';
+import { useRoleAnimationWorkflow } from './useRoleAnimationWorkflow';
+import { useRoleVisualCandidateWorkflow } from './useRoleVisualCandidateWorkflow';
 
 const DEFAULT_ANIMATION_PLAYBACK_RATE = 0.75;
 const MIN_ANIMATION_PLAYBACK_RATE = 0.25;
@@ -527,16 +450,7 @@ function buildAnimationPreviewCharacter(params: {
   } as Character;
 }
 
-export function CustomWorldRoleAssetStudioModal({
-  role,
-  roleKind,
-  onApply,
-  onPublishSuccess,
-  onClose,
-  syncBusy = false,
-  visualPointCost = 20,
-  animationPointCost = 60,
-}: {
+export interface RpgCreationRoleAssetStudioModalProps {
   role: EditableCustomWorldRole;
   roleKind: 'playable' | 'story';
   onApply?: (nextRole: EditableCustomWorldRole) => void;
@@ -556,7 +470,18 @@ export function CustomWorldRoleAssetStudioModal({
   syncBusy?: boolean;
   visualPointCost?: number;
   animationPointCost?: number;
-}) {
+}
+
+export function RpgCreationRoleAssetStudioModal({
+  role,
+  roleKind,
+  onApply,
+  onPublishSuccess,
+  onClose,
+  syncBusy = false,
+  visualPointCost = 20,
+  animationPointCost = 60,
+}: RpgCreationRoleAssetStudioModalProps) {
   const [workingRole, setWorkingRole] = useState<EditableCustomWorldRole>(role);
   const baseRole = useMemo<EditableCustomWorldRole>(
     () => ({
@@ -637,6 +562,10 @@ export function CustomWorldRoleAssetStudioModal({
   const [saveStatus, setSaveStatus] = useState<string | null>(null);
   const [isSavingToRole, setIsSavingToRole] = useState(false);
   const [isHydratingCache, setIsHydratingCache] = useState(true);
+  const { applyVisualDraftToRole, generateVisualCandidatesForRole } =
+    useRoleVisualCandidateWorkflow();
+  const { generateAnimationClipForRole, publishAnimationClipForRole } =
+    useRoleAnimationWorkflow();
 
   const selectedTemplate =
     roleKind === 'playable' && workingRole.templateCharacterId
@@ -911,15 +840,11 @@ export function CustomWorldRoleAssetStudioModal({
   const applyVisualDraftToWorkflow = async (draft: CharacterVisualDraft) => {
     setIsApplyingVisual(true);
     try {
-      const result = await publishCharacterVisualAsset({
-        characterId: workingRole.id,
-        sourceMode: visualSourceMode,
+      const result = await applyVisualDraftToRole({
+        draft,
         promptText: visualPromptText,
-        selectedPreviewSource: draft.imageSrc,
-        previewSources: [draft.imageSrc],
-        width: draft.width,
-        height: draft.height,
-        updateCharacterOverride: false,
+        role: workingRole,
+        sourceMode: visualSourceMode,
       });
 
       const nextRole = mergeRole(workingRole, {
@@ -954,15 +879,12 @@ export function CustomWorldRoleAssetStudioModal({
     setVisualStatus(null);
 
     try {
-      const result = await generateCharacterVisualCandidates({
-        characterId: workingRole.id,
-        sourceMode: visualSourceMode,
-        promptText: visualPromptText,
+      const result = await generateVisualCandidatesForRole({
         characterBriefText,
+        promptText: visualPromptText,
         referenceImageDataUrls: effectiveVisualReferenceImageDataUrls,
-        candidateCount: 1,
-        imageModel: 'wan2.7-image-pro',
-        size: '1024*1024',
+        role: workingRole,
+        sourceMode: visualSourceMode,
       });
       setVisualDrafts(result.drafts);
       if (result.drafts[0]) {
@@ -981,50 +903,6 @@ export function CustomWorldRoleAssetStudioModal({
     }
   };
 
-  const generateActionClip = async (config: CustomWorldAiActionConfig) => {
-    if (!workingRole.imageSrc || !workingRole.generatedVisualAssetId) {
-      throw new Error('请先生成角色形象，再生成动作。');
-    }
-
-    const result = await generateCharacterAnimationDraft({
-      characterId: workingRole.id,
-      strategy: 'image-to-video',
-      animation: config.animation,
-      promptText: animationPromptText,
-      characterBriefText,
-      actionTemplateId: config.templateId,
-      visualSource: workingRole.imageSrc,
-      referenceImageDataUrls: [],
-      referenceVideoDataUrls: [],
-      lastFrameImageDataUrl: workingRole.imageSrc,
-      frameCount: config.frameCount,
-      fps: config.fps,
-      durationSeconds: config.durationSeconds,
-      loop: config.loop,
-      useChromaKey: true,
-      resolution: '480p',
-      ratio: '1:1',
-      imageSequenceModel: 'wan2.7-image-pro',
-      videoModel: 'doubao-seedance-2-0-fast-260128',
-      referenceVideoModel: 'wan2.7-r2v',
-      motionTransferModel: 'wan2.2-animate-move',
-    } satisfies CharacterAnimationGenerationPayload);
-
-    if (result.strategy !== 'image-to-video') {
-      throw new Error('当前自定义世界动作工坊只支持图生视频方案。');
-    }
-
-    return buildAnimationClipFromVideoSource(result.previewVideoPath, {
-      animation: config.animation,
-      fps: config.fps,
-      loop: config.loop,
-      frameCount: config.frameCount,
-      applyChromaKey: true,
-      sampleStartRatio: config.loop ? 0.12 : 0,
-      sampleEndRatio: config.loop ? 0.94 : 1,
-    });
-  };
-
   const handleGenerateAnimation = async () => {
     if (!selectedActionConfig) {
       return;
@@ -1056,21 +934,16 @@ export function CustomWorldRoleAssetStudioModal({
     }));
 
     try {
-      const clip = await generateActionClip(actionConfig);
-      const result = await publishCharacterAnimationAssets({
-        characterId: workingRole.id,
-        visualAssetId: workingRole.generatedVisualAssetId!,
-        animations: {
-          [actionConfig.animation]: {
-            framesDataUrls: clip.frames,
-            fps: clip.fps,
-            loop: clip.loop,
-            frameWidth: clip.frameWidth,
-            frameHeight: clip.frameHeight,
-            previewVideoPath: clip.previewVideoPath,
-          },
-        },
-        updateCharacterOverride: false,
+      const clip = await generateAnimationClipForRole({
+        actionConfig,
+        animationPromptText,
+        characterBriefText,
+        role: workingRole,
+      });
+      const result = await publishAnimationClipForRole({
+        actionConfig,
+        clip,
+        role: workingRole,
       });
 
       setWorkingRole((current) =>
@@ -1168,297 +1041,95 @@ export function CustomWorldRoleAssetStudioModal({
       }
     >
       <div className="space-y-5">
-        <Section title="角色形象">
-          <div className="space-y-4">
-            <div className="platform-role-studio__preview overflow-hidden rounded-3xl">
-              <div className="flex min-h-[18rem] items-center justify-center p-4 sm:min-h-[22rem]">
-                {previewImageSrc ? (
-                  <img
-                    src={previewImageSrc}
-                    alt={workingRole.name}
-                    className="max-h-[28rem] w-full object-contain"
-                  />
-                ) : selectedTemplate ? (
-                  <img
-                    src={selectedTemplate.portrait}
-                    alt={selectedTemplate.name}
-                    className="max-h-[20rem] w-full object-contain"
-                  />
-                ) : (
-                  <div className="px-6 text-center text-sm text-zinc-500">
-                    暂无角色形象预览
-                  </div>
-                )}
-              </div>
-            </div>
+        <RpgCreationRoleVisualSection
+          ActionButton={ActionButton}
+          Field={Field}
+          Section={Section}
+          TextArea={TextArea}
+          handleReferenceImageUpload={handleReferenceImageUpload}
+          hasGeneratedVisualPreview={hasGeneratedVisualPreview}
+          isApplyingVisual={isApplyingVisual}
+          isGeneratingVisuals={isGeneratingVisuals}
+          previewImageSrc={previewImageSrc}
+          referenceImageDataUrls={referenceImageDataUrls}
+          selectedTemplatePortrait={selectedTemplate?.portrait}
+          selectedTemplateName={selectedTemplate?.name}
+          syncBusy={syncBusy}
+          visualPointCost={visualPointCost}
+          visualPromptText={visualPromptText}
+          visualStatus={visualStatus}
+          workingRoleName={workingRole.name}
+          onClearReferenceImages={() => setReferenceImageDataUrls([])}
+          onGenerateVisuals={() => {
+            void handleGenerateVisuals();
+          }}
+          onVisualPromptChange={setVisualPromptText}
+        />
 
-            <Field label="形象描述">
-              <TextArea
-                value={visualPromptText}
-                onChange={setVisualPromptText}
-                rows={6}
-                placeholder="这里默认展示角色形象描述，也可以继续手动细化。"
-              />
-            </Field>
+        <RpgCreationRoleAnimationSection
+          ActionButton={ActionButton}
+          CharacterAnimator={CharacterAnimator}
+          Field={Field}
+          Section={Section}
+          StatusBadge={StatusBadge}
+          TextArea={TextArea}
+          animationPreviewFrameStyle={animationPreviewFrameStyle}
+          animationPreviewPlaybackRate={animationPreviewPlaybackRate}
+          animationPreviewViewportStyle={animationPreviewViewportStyle}
+          animationPromptText={animationPromptText}
+          generatingAnimationMap={generatingAnimationMap}
+          hasGeneratedAnimation={(animation) =>
+            hasGeneratedAnimation(workingRole, animation)
+          }
+          isSelectedAnimationGenerating={isSelectedAnimationGenerating}
+          previewCharacter={previewCharacter}
+          previewImageSrc={previewImageSrc}
+          selectedAnimation={selectedAnimation}
+          selectedAnimationStatus={selectedAnimationStatus}
+          shouldUseSelectedAnimationPreview={shouldUseSelectedAnimationPreview}
+          syncBusy={syncBusy}
+          animationPointCost={animationPointCost}
+          workingRoleGeneratedVisualAssetId={workingRole.generatedVisualAssetId}
+          workingRoleImageSrc={workingRole.imageSrc}
+          workingRoleName={workingRole.name}
+          onAnimationPromptChange={setAnimationPromptText}
+          onGenerateAnimation={() => {
+            void handleGenerateAnimation();
+          }}
+          onPlaybackRateChange={(value) => {
+            const nextPlaybackRate = clampAnimationPlaybackRate(value);
+            setAnimationPreviewPlaybackRate(nextPlaybackRate);
+            setSaveStatus(null);
+            setWorkingRole((current) => {
+              const nextAnimationMap = applyPlaybackRateToAnimationMap({
+                animationMap: current.animationMap as
+                  | Record<string, unknown>
+                  | undefined,
+                animation: selectedAnimation,
+                actionConfig: selectedActionConfig,
+                playbackRate: nextPlaybackRate,
+              });
 
-            <Field label="参考图">
-              <label className="block rounded-2xl border border-dashed border-white/12 bg-black/20 px-4 py-4">
-                <input
-                  type="file"
-                  accept="image/png,image/jpeg,image/webp"
-                  multiple
-                  onChange={handleReferenceImageUpload}
-                  className="w-full text-xs text-zinc-300 file:mr-3 file:rounded-lg file:border-0 file:bg-sky-500 file:px-3 file:py-1.5 file:text-xs file:font-medium file:text-black"
-                />
-              </label>
-              {referenceImageDataUrls.length > 0 ? (
-                <div className="mt-3 space-y-3">
-                  <div className="flex flex-wrap gap-2">
-                    {referenceImageDataUrls.map((imageSrc, index) => (
-                      <div
-                        key={`${imageSrc}-${index}`}
-                        className="h-16 w-16 overflow-hidden rounded-xl border border-white/10 bg-black/25"
-                      >
-                        <img
-                          src={imageSrc}
-                          alt={`reference-${index + 1}`}
-                          className="h-full w-full object-cover"
-                        />
-                      </div>
-                    ))}
-                  </div>
-                  <div>
-                    <ActionButton
-                      label="清空参考图"
-                      onClick={() => setReferenceImageDataUrls([])}
-                      disabled={
-                        isGeneratingVisuals || isApplyingVisual || syncBusy
-                      }
-                    />
-                  </div>
-                </div>
-              ) : null}
-            </Field>
+              return nextAnimationMap === current.animationMap
+                ? current
+                : mergeRole(current, {
+                    animationMap: nextAnimationMap,
+                  });
+            });
+          }}
+          onSelectAnimation={setSelectedAnimation}
+        />
 
-            <div className="flex flex-wrap gap-3">
-              <ActionButton
-                icon={
-                  hasGeneratedVisualPreview ? (
-                    <RefreshCcw className="h-4 w-4" />
-                  ) : (
-                    <ImagePlus className="h-4 w-4" />
-                  )
-                }
-                label={
-                  isGeneratingVisuals
-                    ? '生成中...'
-                    : hasGeneratedVisualPreview
-                      ? '重新生成角色形象'
-                      : '生成角色形象'
-                }
-                subLabel={`消耗${visualPointCost}叙世币`}
-                onClick={() => void handleGenerateVisuals()}
-                disabled={isGeneratingVisuals || isApplyingVisual || syncBusy}
-                tone="sky"
-              />
-            </div>
-
-            {visualStatus ? (
-              <div className="rounded-2xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
-                {visualStatus}
-              </div>
-            ) : null}
-          </div>
-        </Section>
-
-        <Section title="动作">
-          <div className="space-y-4">
-            <div className="platform-role-studio__preview rounded-3xl p-4">
-              <div className="platform-role-studio__stage flex min-h-[28rem] items-center justify-center rounded-2xl p-4">
-                {shouldUseSelectedAnimationPreview && previewCharacter ? (
-                  <div
-                    className="flex items-center justify-center"
-                    style={animationPreviewViewportStyle}
-                  >
-                    <div style={animationPreviewFrameStyle}>
-                      <CharacterAnimator
-                        state={selectedAnimation}
-                        character={previewCharacter}
-                        className="h-full w-full"
-                      />
-                    </div>
-                  </div>
-                ) : previewImageSrc ? (
-                  <img
-                    src={previewImageSrc}
-                    alt={workingRole.name}
-                    className="max-h-[28rem] w-full object-contain pixelated"
-                  />
-                ) : (
-                  <div className="px-4 text-sm text-zinc-500">暂无动作预览</div>
-                )}
-              </div>
-            </div>
-
-            <Field label="预览速度">
-              <div className="rounded-2xl border border-white/10 bg-black/20 px-4 py-3">
-                <input
-                  type="range"
-                  min="0.25"
-                  max="1.5"
-                  step="0.05"
-                  value={animationPreviewPlaybackRate}
-                  onChange={(event) => {
-                    const nextPlaybackRate = clampAnimationPlaybackRate(
-                      Number.parseFloat(event.target.value) ||
-                        DEFAULT_ANIMATION_PLAYBACK_RATE,
-                    );
-                    setAnimationPreviewPlaybackRate(nextPlaybackRate);
-                    setSaveStatus(null);
-                    setWorkingRole((current) => {
-                      const nextAnimationMap = applyPlaybackRateToAnimationMap({
-                        animationMap: current.animationMap as
-                          | Record<string, unknown>
-                          | undefined,
-                        animation: selectedAnimation,
-                        actionConfig: selectedActionConfig,
-                        playbackRate: nextPlaybackRate,
-                      });
-
-                      return nextAnimationMap === current.animationMap
-                        ? current
-                        : mergeRole(current, {
-                            animationMap: nextAnimationMap,
-                          });
-                    });
-                  }}
-                  className="w-full accent-sky-400"
-                />
-                <div className="mt-2 flex items-center justify-between text-[11px] text-zinc-400">
-                  <span>0.25x</span>
-                  <span>{animationPreviewPlaybackRate.toFixed(2)}x</span>
-                  <span>1.50x</span>
-                </div>
-              </div>
-            </Field>
-
-            <div className="grid grid-cols-2 gap-2 sm:grid-cols-3 lg:grid-cols-5">
-              {CORE_ACTIONS.map((item) => {
-                const isSelected = item.animation === selectedAnimation;
-                const isReady = hasGeneratedAnimation(
-                  workingRole,
-                  item.animation,
-                );
-                const isGenerating =
-                  generatingAnimationMap[item.animation] === true;
-                return (
-                  <button
-                    key={item.animation}
-                    type="button"
-                    onClick={() => setSelectedAnimation(item.animation)}
-                    className={`rounded-2xl border px-3 py-3 text-left transition-colors ${
-                      isSelected
-                        ? 'border-sky-300/30 bg-sky-500/10'
-                        : 'border-white/10 bg-black/20 hover:border-white/20'
-                    }`}
-                  >
-                    <div className="flex items-start justify-between gap-2">
-                      <div className="min-w-0">
-                        <div className="text-sm font-semibold text-white">
-                          {item.label}
-                        </div>
-                        <div className="mt-1 flex flex-wrap items-center gap-2 text-[11px] text-zinc-400">
-                          {isGenerating
-                            ? '后台生成中'
-                            : isSelected
-                              ? '当前预览'
-                              : '点击切换'}
-                          <span>{item.required ? '必需动作' : '可选动作'}</span>
-                        </div>
-                      </div>
-                      <StatusBadge
-                        tone={
-                          isGenerating ? 'amber' : isReady ? 'green' : 'zinc'
-                        }
-                      >
-                        {isGenerating
-                          ? '生成中'
-                          : isReady
-                            ? '已生成'
-                            : item.required
-                              ? '待生成'
-                              : (item.fallbackStatusLabel ?? '可选')}
-                      </StatusBadge>
-                    </div>
-                  </button>
-                );
-              })}
-            </div>
-
-            <Field label="动作描述">
-              <TextArea
-                value={animationPromptText}
-                onChange={setAnimationPromptText}
-                rows={5}
-                placeholder="这里默认展示角色动作描述，也可以继续手动细化。"
-              />
-            </Field>
-
-            <div className="flex flex-wrap gap-3">
-              <ActionButton
-                icon={<RefreshCcw className="h-4 w-4" />}
-                label={isSelectedAnimationGenerating ? '生成中...' : '生成动作'}
-                subLabel={`消耗${animationPointCost}叙世币`}
-                onClick={() => void handleGenerateAnimation()}
-                disabled={
-                  isSelectedAnimationGenerating ||
-                  !workingRole.imageSrc ||
-                  !workingRole.generatedVisualAssetId ||
-                  syncBusy
-                }
-                tone="sky"
-              />
-            </div>
-
-            {selectedAnimationStatus ? (
-              <div className="rounded-2xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
-                {selectedAnimationStatus}
-              </div>
-            ) : null}
-          </div>
-        </Section>
-
-        <div className="platform-role-studio__footer sticky bottom-0 z-10 -mx-4 px-4 pb-[calc(env(safe-area-inset-bottom,0px)+0.35rem)] pt-3 sm:mx-0 sm:rounded-3xl sm:border sm:border-[var(--platform-subpanel-border)] sm:px-4">
-          <div className="space-y-3">
-            {saveStatus ? (
-              <div className="rounded-2xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
-                {saveStatus}
-              </div>
-            ) : null}
-            <div className="flex flex-col-reverse gap-3 sm:flex-row sm:justify-end">
-              <button
-                type="button"
-                onClick={() => void handleSaveToRole()}
-                disabled={
-                  isSavingToRole ||
-                  syncBusy ||
-                  !workingRole.imageSrc ||
-                  !workingRole.generatedVisualAssetId
-                }
-                className={`rounded-full border border-emerald-400/30 bg-emerald-500/10 px-5 py-2 text-sm font-semibold text-emerald-100 transition-colors hover:bg-emerald-500/20 ${
-                  isSavingToRole ||
-                  syncBusy ||
-                  !workingRole.imageSrc ||
-                  !workingRole.generatedVisualAssetId
-                    ? 'cursor-not-allowed opacity-45'
-                    : ''
-                }`}
-              >
-                {isSavingToRole || syncBusy ? '保存中...' : '保存到当前角色'}
-              </button>
-            </div>
-          </div>
-        </div>
+        <RpgCreationRoleAssetStudioFooter
+          isSavingToRole={isSavingToRole}
+          saveStatus={saveStatus}
+          syncBusy={syncBusy}
+          workingRoleGeneratedVisualAssetId={workingRole.generatedVisualAssetId}
+          workingRoleImageSrc={workingRole.imageSrc}
+          onSaveToRole={() => {
+            void handleSaveToRole();
+          }}
+        />
       </div>
     </PortalModalShell>
   );
diff --git a/src/components/rpg-creation-asset-studio/RpgCreationRoleVisualSection.tsx b/src/components/rpg-creation-asset-studio/RpgCreationRoleVisualSection.tsx
new file mode 100644
index 00000000..c6d823f3
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/RpgCreationRoleVisualSection.tsx
@@ -0,0 +1,184 @@
+import type { ChangeEvent, ReactNode } from 'react';
+import { ImagePlus, RefreshCcw } from 'lucide-react';
+
+type ActionButtonProps = {
+  icon?: ReactNode;
+  label: string;
+  subLabel?: string;
+  onClick: () => void;
+  disabled?: boolean;
+  tone?: 'default' | 'sky' | 'green';
+};
+
+type FieldProps = {
+  label: string;
+  children: ReactNode;
+};
+
+type TextAreaProps = {
+  value: string;
+  onChange: (value: string) => void;
+  rows?: number;
+  placeholder?: string;
+  readOnly?: boolean;
+};
+
+type SectionProps = {
+  title: string;
+  children: ReactNode;
+};
+
+export function RpgCreationRoleVisualSection(props: {
+  ActionButton: (props: ActionButtonProps) => ReactNode;
+  Field: (props: FieldProps) => ReactNode;
+  Section: (props: SectionProps) => ReactNode;
+  TextArea: (props: TextAreaProps) => ReactNode;
+  handleReferenceImageUpload: (
+    event: ChangeEvent<HTMLInputElement>,
+  ) => Promise<void>;
+  hasGeneratedVisualPreview: boolean;
+  isApplyingVisual: boolean;
+  isGeneratingVisuals: boolean;
+  previewImageSrc: string;
+  referenceImageDataUrls: string[];
+  selectedTemplatePortrait?: string | null;
+  selectedTemplateName?: string | null;
+  syncBusy: boolean;
+  visualPointCost: number;
+  visualPromptText: string;
+  visualStatus: string | null;
+  workingRoleName: string;
+  onClearReferenceImages: () => void;
+  onGenerateVisuals: () => void;
+  onVisualPromptChange: (value: string) => void;
+}) {
+  const {
+    ActionButton,
+    Field,
+    Section,
+    TextArea,
+    handleReferenceImageUpload,
+    hasGeneratedVisualPreview,
+    isApplyingVisual,
+    isGeneratingVisuals,
+    previewImageSrc,
+    referenceImageDataUrls,
+    selectedTemplateName,
+    selectedTemplatePortrait,
+    syncBusy,
+    visualPointCost,
+    visualPromptText,
+    visualStatus,
+    workingRoleName,
+    onClearReferenceImages,
+    onGenerateVisuals,
+    onVisualPromptChange,
+  } = props;
+
+  return (
+    <Section title="角色形象">
+      <div className="space-y-4">
+        <div className="platform-role-studio__preview overflow-hidden rounded-3xl">
+          <div className="flex min-h-[18rem] items-center justify-center p-4 sm:min-h-[22rem]">
+            {previewImageSrc ? (
+              <img
+                src={previewImageSrc}
+                alt={workingRoleName}
+                className="max-h-[28rem] w-full object-contain"
+              />
+            ) : selectedTemplatePortrait ? (
+              <img
+                src={selectedTemplatePortrait}
+                alt={selectedTemplateName ?? workingRoleName}
+                className="max-h-[20rem] w-full object-contain"
+              />
+            ) : (
+              <div className="px-6 text-center text-sm text-zinc-500">
+                暂无角色形象预览
+              </div>
+            )}
+          </div>
+        </div>
+
+        <Field label="形象描述">
+          <TextArea
+            value={visualPromptText}
+            onChange={onVisualPromptChange}
+            rows={6}
+            placeholder="这里默认展示角色形象描述，也可以继续手动细化。"
+          />
+        </Field>
+
+        <Field label="参考图">
+          <label className="block rounded-2xl border border-dashed border-white/12 bg-black/20 px-4 py-4">
+            <input
+              type="file"
+              accept="image/png,image/jpeg,image/webp"
+              multiple
+              onChange={(event) => {
+                void handleReferenceImageUpload(event);
+              }}
+              className="w-full text-xs text-zinc-300 file:mr-3 file:rounded-lg file:border-0 file:bg-sky-500 file:px-3 file:py-1.5 file:text-xs file:font-medium file:text-black"
+            />
+          </label>
+          {referenceImageDataUrls.length > 0 ? (
+            <div className="mt-3 space-y-3">
+              <div className="flex flex-wrap gap-2">
+                {referenceImageDataUrls.map((imageSrc, index) => (
+                  <div
+                    key={`${imageSrc}-${index}`}
+                    className="h-16 w-16 overflow-hidden rounded-xl border border-white/10 bg-black/25"
+                  >
+                    <img
+                      src={imageSrc}
+                      alt={`reference-${index + 1}`}
+                      className="h-full w-full object-cover"
+                    />
+                  </div>
+                ))}
+              </div>
+              <div>
+                <ActionButton
+                  label="清空参考图"
+                  onClick={onClearReferenceImages}
+                  disabled={isGeneratingVisuals || isApplyingVisual || syncBusy}
+                />
+              </div>
+            </div>
+          ) : null}
+        </Field>
+
+        <div className="flex flex-wrap gap-3">
+          <ActionButton
+            icon={
+              hasGeneratedVisualPreview ? (
+                <RefreshCcw className="h-4 w-4" />
+              ) : (
+                <ImagePlus className="h-4 w-4" />
+              )
+            }
+            label={
+              isGeneratingVisuals
+                ? '生成中...'
+                : hasGeneratedVisualPreview
+                  ? '重新生成角色形象'
+                  : '生成角色形象'
+            }
+            subLabel={`消耗${visualPointCost}叙世币`}
+            onClick={onGenerateVisuals}
+            disabled={isGeneratingVisuals || isApplyingVisual || syncBusy}
+            tone="sky"
+          />
+        </div>
+
+        {visualStatus ? (
+          <div className="rounded-2xl border border-white/10 bg-black/20 px-4 py-3 text-sm text-zinc-300">
+            {visualStatus}
+          </div>
+        ) : null}
+      </div>
+    </Section>
+  );
+}
+
+export default RpgCreationRoleVisualSection;
diff --git a/src/components/rpg-creation-asset-studio/index.ts b/src/components/rpg-creation-asset-studio/index.ts
new file mode 100644
index 00000000..d382b4eb
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/index.ts
@@ -0,0 +1,4 @@
+export {
+  RpgCreationRoleAssetStudioModal,
+  type RpgCreationRoleAssetStudioModalProps,
+} from './RpgCreationRoleAssetStudioModal';
diff --git a/src/components/rpg-creation-asset-studio/roleAssetStudioModel.ts b/src/components/rpg-creation-asset-studio/roleAssetStudioModel.ts
new file mode 100644
index 00000000..a53a9895
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/roleAssetStudioModel.ts
@@ -0,0 +1,79 @@
+import { AnimationState } from '../../types';
+
+export type EditableCustomWorldRole = {
+  id: string;
+  name: string;
+  title: string;
+  role: string;
+  visualDescription?: string;
+  actionDescription?: string;
+  sceneVisualDescription?: string;
+  description?: string;
+  backstory?: string;
+  personality?: string;
+  motivation?: string;
+  combatStyle?: string;
+  tags?: string[];
+  templateCharacterId?: string;
+  imageSrc?: string;
+  generatedVisualAssetId?: string;
+  generatedAnimationSetId?: string;
+  animationMap?: Record<string, unknown>;
+};
+
+export type CustomWorldAiActionConfig = {
+  animation: AnimationState;
+  label: string;
+  templateId: string;
+  fps: number;
+  frameCount: number;
+  durationSeconds: number;
+  loop: boolean;
+  required: boolean;
+  fallbackStatusLabel?: string;
+};
+
+export const CORE_ACTIONS: CustomWorldAiActionConfig[] = [
+  {
+    animation: AnimationState.RUN,
+    label: '奔跑',
+    templateId: 'run',
+    fps: 12,
+    frameCount: 8,
+    durationSeconds: 4,
+    loop: true,
+    required: true,
+  },
+  {
+    animation: AnimationState.ATTACK,
+    label: '攻击',
+    templateId: 'attack_slash',
+    fps: 12,
+    frameCount: 8,
+    durationSeconds: 4,
+    loop: false,
+    required: true,
+  },
+  {
+    animation: AnimationState.IDLE,
+    label: '待机',
+    templateId: 'idle',
+    fps: 8,
+    frameCount: 8,
+    durationSeconds: 4,
+    loop: true,
+    required: false,
+    fallbackStatusLabel: '默认静止',
+  },
+  {
+    animation: AnimationState.DIE,
+    label: '死亡',
+    templateId: 'die',
+    fps: 8,
+    frameCount: 8,
+    durationSeconds: 4,
+    loop: false,
+    required: false,
+    fallbackStatusLabel: '默认倒地动画',
+  },
+];
diff --git a/src/components/rpg-creation-asset-studio/roleAssetStudioPublishClient.ts b/src/components/rpg-creation-asset-studio/roleAssetStudioPublishClient.ts
new file mode 100644
index 00000000..3a005734
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/roleAssetStudioPublishClient.ts
@@ -0,0 +1,13 @@
+import {
+  publishCharacterAnimationAssets,
+  publishCharacterVisualAsset,
+} from '../asset-studio/characterAssetWorkflowPersistence';
+
+/**
+ * 工作包 C 第一轮先把发布相关 API 出口收口到独立 client。
+ * 后续场景资产工坊复用时，可以直接沿用这里的发布边界。
+ */
+export const roleAssetStudioPublishClient = {
+  publishCharacterAnimationAssets,
+  publishCharacterVisualAsset,
+};
diff --git a/src/components/rpg-creation-asset-studio/useRoleAnimationWorkflow.ts b/src/components/rpg-creation-asset-studio/useRoleAnimationWorkflow.ts
new file mode 100644
index 00000000..8450ba90
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/useRoleAnimationWorkflow.ts
@@ -0,0 +1,99 @@
+import {
+  buildAnimationClipFromVideoSource,
+  type DraftAnimationClip,
+} from '../asset-studio/characterAssetWorkflowModel';
+import { generateCharacterAnimationDraft } from '../asset-studio/characterAssetWorkflowPersistence';
+import type { CharacterAnimationGenerationPayload } from '../asset-studio/characterAssetWorkflowPersistence';
+
+import { roleAssetStudioPublishClient } from './roleAssetStudioPublishClient';
+import type {
+  CustomWorldAiActionConfig,
+  EditableCustomWorldRole,
+} from './roleAssetStudioModel';
+
+export function useRoleAnimationWorkflow() {
+  const generateAnimationClipForRole = async (params: {
+    actionConfig: CustomWorldAiActionConfig;
+    animationPromptText: string;
+    characterBriefText: string;
+    role: EditableCustomWorldRole;
+  }): Promise<DraftAnimationClip> => {
+    const { actionConfig, animationPromptText, characterBriefText, role } =
+      params;
+
+    if (!role.imageSrc || !role.generatedVisualAssetId) {
+      throw new Error('请先生成角色形象，再生成动作。');
+    }
+
+    const result = await generateCharacterAnimationDraft({
+      characterId: role.id,
+      strategy: 'image-to-video',
+      animation: actionConfig.animation,
+      promptText: animationPromptText,
+      characterBriefText,
+      actionTemplateId: actionConfig.templateId,
+      visualSource: role.imageSrc,
+      referenceImageDataUrls: [],
+      referenceVideoDataUrls: [],
+      lastFrameImageDataUrl: role.imageSrc,
+      frameCount: actionConfig.frameCount,
+      fps: actionConfig.fps,
+      durationSeconds: actionConfig.durationSeconds,
+      loop: actionConfig.loop,
+      useChromaKey: true,
+      resolution: '480p',
+      ratio: '1:1',
+      imageSequenceModel: 'wan2.7-image-pro',
+      videoModel: 'doubao-seedance-2-0-fast-260128',
+      referenceVideoModel: 'wan2.7-r2v',
+      motionTransferModel: 'wan2.2-animate-move',
+    } satisfies CharacterAnimationGenerationPayload);
+
+    if (result.strategy !== 'image-to-video') {
+      throw new Error('当前自定义世界动作工坊只支持图生视频方案。');
+    }
+
+    return buildAnimationClipFromVideoSource(result.previewVideoPath, {
+      animation: actionConfig.animation,
+      fps: actionConfig.fps,
+      loop: actionConfig.loop,
+      frameCount: actionConfig.frameCount,
+      applyChromaKey: true,
+      sampleStartRatio: actionConfig.loop ? 0.12 : 0,
+      sampleEndRatio: actionConfig.loop ? 0.94 : 1,
+    });
+  };
+
+  const publishAnimationClipForRole = async (params: {
+    actionConfig: CustomWorldAiActionConfig;
+    clip: DraftAnimationClip;
+    role: EditableCustomWorldRole;
+  }) => {
+    const { actionConfig, clip, role } = params;
+
+    if (!role.generatedVisualAssetId) {
+      throw new Error('缺少角色主图资产，无法发布动作。');
+    }
+
+    return roleAssetStudioPublishClient.publishCharacterAnimationAssets({
+      characterId: role.id,
+      visualAssetId: role.generatedVisualAssetId,
+      animations: {
+        [actionConfig.animation]: {
+          framesDataUrls: clip.frames,
+          fps: clip.fps,
+          loop: clip.loop,
+          frameWidth: clip.frameWidth,
+          frameHeight: clip.frameHeight,
+          previewVideoPath: clip.previewVideoPath,
+        },
+      },
+      updateCharacterOverride: false,
+    });
+  };
+
+  return {
+    generateAnimationClipForRole,
+    publishAnimationClipForRole,
+  };
+}
diff --git a/src/components/rpg-creation-asset-studio/useRoleVisualCandidateWorkflow.ts b/src/components/rpg-creation-asset-studio/useRoleVisualCandidateWorkflow.ts
new file mode 100644
index 00000000..11c0b8e0
--- /dev/null
+++ b/src/components/rpg-creation-asset-studio/useRoleVisualCandidateWorkflow.ts
@@ -0,0 +1,59 @@
+import { generateCharacterVisualCandidates } from '../asset-studio/characterAssetWorkflowPersistence';
+import type { CharacterVisualDraft } from '../asset-studio/characterAssetWorkflowPersistence';
+
+import { roleAssetStudioPublishClient } from './roleAssetStudioPublishClient';
+import type { EditableCustomWorldRole } from './roleAssetStudioModel';
+
+export function useRoleVisualCandidateWorkflow() {
+  const generateVisualCandidatesForRole = async (params: {
+    characterBriefText: string;
+    promptText: string;
+    referenceImageDataUrls: string[];
+    role: EditableCustomWorldRole;
+    sourceMode: 'text-to-image' | 'image-to-image';
+  }) => {
+    const {
+      characterBriefText,
+      promptText,
+      referenceImageDataUrls,
+      role,
+      sourceMode,
+    } = params;
+
+    return generateCharacterVisualCandidates({
+      characterId: role.id,
+      sourceMode,
+      promptText,
+      characterBriefText,
+      referenceImageDataUrls,
+      candidateCount: 1,
+      imageModel: 'wan2.7-image-pro',
+      size: '1024*1024',
+    });
+  };
+
+  const applyVisualDraftToRole = async (params: {
+    draft: CharacterVisualDraft;
+    promptText: string;
+    role: EditableCustomWorldRole;
+    sourceMode: 'text-to-image' | 'image-to-image';
+  }) => {
+    const { draft, promptText, role, sourceMode } = params;
+
+    return roleAssetStudioPublishClient.publishCharacterVisualAsset({
+      characterId: role.id,
+      sourceMode,
+      promptText,
+      selectedPreviewSource: draft.imageSrc,
+      previewSources: [draft.imageSrc],
+      width: draft.width,
+      height: draft.height,
+      updateCharacterOverride: false,
+    });
+  };
+
+  return {
+    applyVisualDraftToRole,
+    generateVisualCandidatesForRole,
+  };
+}
diff --git a/src/components/rpg-creation-editor/CustomWorldCampEditorSection.tsx b/src/components/rpg-creation-editor/CustomWorldCampEditorSection.tsx
new file mode 100644
index 00000000..175c7587
--- /dev/null
+++ b/src/components/rpg-creation-editor/CustomWorldCampEditorSection.tsx
@@ -0,0 +1 @@
+export { CampSceneEditor as default } from './RpgCreationEntityEditorShared';
diff --git a/src/components/rpg-creation-editor/CustomWorldCoverEditorSection.tsx b/src/components/rpg-creation-editor/CustomWorldCoverEditorSection.tsx
new file mode 100644
index 00000000..85734c8a
--- /dev/null
+++ b/src/components/rpg-creation-editor/CustomWorldCoverEditorSection.tsx
@@ -0,0 +1 @@
+export { WorldCoverEditor as default } from './RpgCreationEntityEditorShared';
diff --git a/src/components/rpg-creation-editor/CustomWorldLandmarkEditorSection.tsx b/src/components/rpg-creation-editor/CustomWorldLandmarkEditorSection.tsx
new file mode 100644
index 00000000..bc389539
--- /dev/null
+++ b/src/components/rpg-creation-editor/CustomWorldLandmarkEditorSection.tsx
@@ -0,0 +1 @@
+export { LandmarkEditor as default } from './RpgCreationEntityEditorShared';
diff --git a/src/components/rpg-creation-editor/CustomWorldRoleEditorSection.tsx b/src/components/rpg-creation-editor/CustomWorldRoleEditorSection.tsx
new file mode 100644
index 00000000..91eb04db
--- /dev/null
+++ b/src/components/rpg-creation-editor/CustomWorldRoleEditorSection.tsx
@@ -0,0 +1,4 @@
+export {
+  PlayableNpcEditor as default,
+  StoryNpcEditor,
+} from './RpgCreationEntityEditorShared';
diff --git a/src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx b/src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx
new file mode 100644
index 00000000..eddeb37f
--- /dev/null
+++ b/src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx
@@ -0,0 +1 @@
+export { SectionPanel as default } from './RpgCreationEntityEditorShared';
diff --git a/src/components/rpg-creation-editor/CustomWorldWorldEditorSection.tsx b/src/components/rpg-creation-editor/CustomWorldWorldEditorSection.tsx
new file mode 100644
index 00000000..94c12a8d
--- /dev/null
+++ b/src/components/rpg-creation-editor/CustomWorldWorldEditorSection.tsx
@@ -0,0 +1 @@
+export { WorldEditor as default } from './RpgCreationEntityEditorShared';
diff --git a/src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx b/src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx
index c42da374..e48d8fe4 100644
--- a/src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx
+++ b/src/components/rpg-creation-editor/RpgCreationEntityEditorModal.tsx
@@ -1,19 +1,24 @@
 import type { ComponentProps } from 'react';
 
-import CustomWorldEntityEditorModal from '../CustomWorldEntityEditorModal';
+import RpgCreationEntityEditorModalImpl from './RpgCreationEntityEditorModalImpl';
+import type {
+  RpgCreationEditorTarget,
+} from './RpgCreationEntityEditorModalImpl';
 
 /**
- * 工作包 A 只建立 RPG 创作编辑器的新目录入口。
- * 真实编辑表单暂时仍由旧的综合编辑器承载，后续工作包 C 会把不同 section 拆到这个目录下。
+ * 工作包 C 完成后，编辑器 façade 已直接桥接 RPG 创作目录下的目标分发壳层。
+ * 旧 `CustomWorldEntityEditorModal.tsx` 兼容入口已经删除，当前继续保留 shared 实现承载复杂表单细节，
+ * 后续可在不改入口的前提下继续物理拆分 section。
  */
 export type RpgCreationEntityEditorModalProps = ComponentProps<
-  typeof CustomWorldEntityEditorModal
+  typeof RpgCreationEntityEditorModalImpl
 >;
 
 export function RpgCreationEntityEditorModal(
   props: RpgCreationEntityEditorModalProps,
 ) {
-  return <CustomWorldEntityEditorModal {...props} />;
+  return <RpgCreationEntityEditorModalImpl {...props} />;
 }
+export type { RpgCreationEditorTarget };
 
 export default RpgCreationEntityEditorModal;
diff --git a/src/components/rpg-creation-editor/RpgCreationEntityEditorModalImpl.tsx b/src/components/rpg-creation-editor/RpgCreationEntityEditorModalImpl.tsx
new file mode 100644
index 00000000..a173358e
--- /dev/null
+++ b/src/components/rpg-creation-editor/RpgCreationEntityEditorModalImpl.tsx
@@ -0,0 +1,136 @@
+import type { CustomWorldProfile } from '../../types';
+
+import CampSceneEditor from './CustomWorldCampEditorSection';
+import WorldCoverEditor from './CustomWorldCoverEditorSection';
+import LandmarkEditor from './CustomWorldLandmarkEditorSection';
+import PlayableNpcEditor, {
+  StoryNpcEditor,
+} from './CustomWorldRoleEditorSection';
+import WorldEditor from './CustomWorldWorldEditorSection';
+import {
+  resolveEditableLandmark,
+  resolveEditablePlayableNpc,
+  resolveEditableStoryNpc,
+} from './rpgCreationResultFormMapper';
+
+export type RpgCreationEditorTarget =
+  | { kind: 'world' }
+  | { kind: 'cover' }
+  | { kind: 'camp' }
+  | { kind: 'playable'; mode: 'create' }
+  | { kind: 'playable'; mode: 'edit'; id: string }
+  | { kind: 'story'; mode: 'create' }
+  | { kind: 'story'; mode: 'edit'; id: string }
+  | { kind: 'landmark'; mode: 'create' }
+  | { kind: 'landmark'; mode: 'edit'; id: string };
+
+export interface RpgCreationEntityEditorModalProps {
+  profile: CustomWorldProfile;
+  target: RpgCreationEditorTarget | null;
+  onClose: () => void;
+  onProfileChange: (profile: CustomWorldProfile) => void;
+}
+
+/**
+ * 工作包 C 收口后的编辑器主入口只负责目标分发。
+ * 具体 section 实现已经下沉到 shared/section 文件，后续可以继续物理拆分而不再膨胀主壳层。
+ */
+export function RpgCreationEntityEditorModal({
+  profile,
+  target,
+  onClose,
+  onProfileChange,
+}: RpgCreationEntityEditorModalProps) {
+  if (!target) {
+    return null;
+  }
+
+  if (target.kind === 'world') {
+    return (
+      <WorldEditor
+        profile={profile}
+        onSave={onProfileChange}
+        onClose={onClose}
+      />
+    );
+  }
+
+  if (target.kind === 'cover') {
+    return (
+      <WorldCoverEditor
+        profile={profile}
+        onSaveProfile={onProfileChange}
+        onClose={onClose}
+      />
+    );
+  }
+
+  if (target.kind === 'camp') {
+    return (
+      <CampSceneEditor
+        profile={profile}
+        onSaveProfile={onProfileChange}
+        onClose={onClose}
+      />
+    );
+  }
+
+  if (target.kind === 'playable') {
+    const npc = resolveEditablePlayableNpc(profile, target);
+    return npc ? (
+      <PlayableNpcEditor
+        profile={profile}
+        npc={npc}
+        mode={target.mode}
+        onSave={(nextNpc) =>
+          onProfileChange({
+            ...profile,
+            playableNpcs:
+              target.mode === 'create'
+                ? [...profile.playableNpcs, nextNpc]
+                : profile.playableNpcs.map((item) =>
+                    item.id === nextNpc.id ? nextNpc : item,
+                  ),
+          })
+        }
+        onClose={onClose}
+      />
+    ) : null;
+  }
+
+  if (target.kind === 'story') {
+    const npc = resolveEditableStoryNpc(profile, target);
+    return npc ? (
+      <StoryNpcEditor
+        profile={profile}
+        npc={npc}
+        mode={target.mode}
+        onSave={(nextNpc) =>
+          onProfileChange({
+            ...profile,
+            storyNpcs:
+              target.mode === 'create'
+                ? [...profile.storyNpcs, nextNpc]
+                : profile.storyNpcs.map((item) =>
+                    item.id === nextNpc.id ? nextNpc : item,
+                  ),
+          })
+        }
+        onClose={onClose}
+      />
+    ) : null;
+  }
+
+  const landmark = resolveEditableLandmark(profile, target);
+  return landmark ? (
+    <LandmarkEditor
+      profile={profile}
+      landmark={landmark}
+      mode={target.mode}
+      onSaveProfile={onProfileChange}
+      onClose={onClose}
+    />
+  ) : null;
+}
+
+export default RpgCreationEntityEditorModal;
diff --git a/src/components/CustomWorldEntityEditorModal.tsx b/src/components/rpg-creation-editor/RpgCreationEntityEditorShared.tsx
similarity index 94%
rename from src/components/CustomWorldEntityEditorModal.tsx
rename to src/components/rpg-creation-editor/RpgCreationEntityEditorShared.tsx
index 91ae1cd9..4275aa51 100644
--- a/src/components/CustomWorldEntityEditorModal.tsx
+++ b/src/components/rpg-creation-editor/RpgCreationEntityEditorShared.tsx
@@ -4,43 +4,41 @@ import type { CSSProperties } from 'react';
 import { Children, type ReactNode, useEffect, useMemo, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
 
-import { AFFINITY_BACKSTORY_CHAPTER_THRESHOLDS } from '../data/affinityLevels';
+import { AFFINITY_BACKSTORY_CHAPTER_THRESHOLDS } from '../../data/affinityLevels';
 import {
   buildCustomWorldPlayableCharacters,
   ROLE_TEMPLATE_CHARACTERS,
-} from '../data/characterPresets';
+} from '../../data/characterPresets';
 import {
   normalizeCustomWorldLandmarks,
-} from '../data/customWorldSceneGraph';
+} from '../../data/customWorldSceneGraph';
 import {
   getAllCustomWorldSceneImages,
   resolveCustomWorldCampSceneImage,
   resolveCustomWorldLandmarkImage,
-} from '../data/customWorldVisuals';
-import { RESOLVED_ENTITY_X_METERS } from '../data/sceneEncounterPreviews';
-import { buildEncounterFromSceneNpc } from '../data/scenePresets';
-import { EDITOR_ITEM_CATALOG_API_PATH } from '../editor/shared/editorApiClient';
-import { fetchJson } from '../editor/shared/jsonClient';
-import { useCombatFlow } from '../hooks/useCombatFlow';
-import { useGameFlow } from '../hooks/useGameFlow';
-import { useNpcInteractionFlow } from '../hooks/useNpcInteractionFlow';
-import { useStoryGeneration } from '../hooks/useStoryGeneration';
-import { buildSkillActionPrompt } from '../prompts/customWorldEntityActionPrompts';
-import {
-  type CustomWorldSceneImageResult,
-  generateCustomWorldSceneImage,
-} from '../services/aiService';
-import { resolveCustomWorldCampScene } from '../services/customWorldCamp';
+} from '../../data/customWorldVisuals';
+import { RESOLVED_ENTITY_X_METERS } from '../../data/sceneEncounterPreviews';
+import { buildEncounterFromSceneNpc } from '../../data/scenePresets';
+import { EDITOR_ITEM_CATALOG_API_PATH } from '../../editor/shared/editorApiClient';
+import { fetchJson } from '../../editor/shared/jsonClient';
+import { useCombatFlow } from '../../hooks/useCombatFlow';
+import { useNpcInteractionFlow } from '../../hooks/useNpcInteractionFlow';
+import { useRpgRuntimeStory } from '../../hooks/rpg-runtime-story';
+import { useRpgSessionBootstrap } from '../../hooks/rpg-session';
+import { buildSkillActionPrompt } from '../../prompts/customWorldEntityActionPrompts';
+import type { CustomWorldSceneImageResult } from '../../services/aiTypes';
+import { resolveCustomWorldCampScene } from '../../services/customWorldCamp';
 import {
   buildDefaultCustomWorldCoverProfile,
   resolveCustomWorldCoverPresentation,
-} from '../services/customWorldCover';
+} from '../../services/customWorldCover';
 import {
   type CustomWorldCoverAssetResult,
   generateCustomWorldCoverImage,
   uploadCustomWorldCoverImage,
-} from '../services/customWorldCoverAssetService';
-import { createEmptyStoryEngineMemoryState } from '../services/storyEngine/visibilityEngine';
+} from '../../services/customWorldCoverAssetService';
+import { rpgCreationAssetClient } from '../../services/rpg-creation/rpgCreationAssetClient';
+import { createEmptyStoryEngineMemoryState } from '../../services/storyEngine/visibilityEngine';
 import {
   AnimationState,
   type Character,
@@ -63,30 +61,38 @@ import {
   type SceneNpc,
   type ScenePresetInfo,
   WorldType,
-} from '../types';
-import { buildAnimationClipFromVideoSource } from './asset-studio/characterAssetWorkflowModel';
+} from '../../types';
+import { buildAnimationClipFromVideoSource } from '../asset-studio/characterAssetWorkflowModel';
 import {
   type CharacterAnimationGenerationPayload,
   generateCharacterAnimationDraft,
   publishCharacterAnimationAssets,
-} from './asset-studio/characterAssetWorkflowPersistence';
-import { useAuthUi } from './auth/AuthUiContext';
-import { CharacterAnimator } from './CharacterAnimator';
-import { CustomWorldCoverArtwork } from './CustomWorldCoverArtwork';
-import { buildDefaultCustomWorldNpcVisual } from './customWorldNpcVisualDefaults';
+} from '../asset-studio/characterAssetWorkflowPersistence';
+import { useAuthUi } from '../auth/AuthUiContext';
+import { CharacterAnimator } from '../CharacterAnimator';
+import { CustomWorldCoverArtwork } from '../CustomWorldCoverArtwork';
+import { buildDefaultCustomWorldNpcVisual } from '../customWorldNpcVisualDefaults';
 import {
   CustomWorldNpcPortrait,
   CustomWorldNpcVisualEditor,
-} from './CustomWorldNpcVisualEditor';
-import { CustomWorldRoleAssetStudioModal } from './CustomWorldRoleAssetStudioModal';
+} from '../CustomWorldNpcVisualEditor';
+import { RpgCreationRoleAssetStudioModal } from '../rpg-creation-asset-studio/RpgCreationRoleAssetStudioModal';
 import {
   RoleCharacterSprite,
   SceneEncounterNpcSprite,
-} from './game-canvas/GameCanvasShared';
-import { GameShellRuntime } from './game-shell/GameShellRuntime';
-import { PixelIcon } from './PixelIcon';
+} from '../game-canvas/GameCanvasShared';
+import { PixelIcon } from '../PixelIcon';
+import { RpgRuntimeShell } from '../rpg-runtime-shell';
+import {
+  createLandmarkDraft,
+  createPlayableNpcDraft,
+  createStoryNpcDraft,
+  resolveEditableLandmark,
+  resolveEditablePlayableNpc,
+  resolveEditableStoryNpc,
+} from './rpgCreationResultFormMapper';
 
-export type CustomWorldEditorTarget =
+export type RpgCreationEditorTarget =
   | { kind: 'world' }
   | { kind: 'cover' }
   | { kind: 'camp' }
@@ -97,9 +103,9 @@ export type CustomWorldEditorTarget =
   | { kind: 'landmark'; mode: 'create' }
   | { kind: 'landmark'; mode: 'edit'; id: string };
 
-interface CustomWorldEntityEditorModalProps {
+export interface RpgCreationEntityEditorModalProps {
   profile: CustomWorldProfile;
-  target: CustomWorldEditorTarget | null;
+  target: RpgCreationEditorTarget | null;
   onClose: () => void;
   onProfileChange: (profile: CustomWorldProfile) => void;
 }
@@ -1144,6 +1150,7 @@ function ImagePreview({
   fallbackLabel,
   tone = 'square',
   children,
+  previewOverlay,
   overlayInteractive = false,
 }: {
   src?: string;
@@ -1151,6 +1158,7 @@ function ImagePreview({
   fallbackLabel: string;
   tone?: 'square' | 'landscape';
   children?: ReactNode;
+  previewOverlay?: ReactNode;
   overlayInteractive?: boolean;
 }) {
   return (
@@ -1169,10 +1177,11 @@ function ImagePreview({
           {fallbackLabel}
         </div>
       )}
-      {children ? (
+      {children || previewOverlay ? (
         <div
           className={`${overlayInteractive ? 'pointer-events-auto' : 'pointer-events-none'} absolute inset-0`}
         >
+          {previewOverlay}
           {children}
         </div>
       ) : null}
@@ -1737,11 +1746,11 @@ function SceneActPreviewRuntime({
     resetGame,
     handleCustomWorldSelect,
     handleCharacterSelect,
-  } = useGameFlow();
+  } = useRpgSessionBootstrap();
   const combatFlow = useCombatFlow({
     setGameState,
   });
-  const storyFlow = useStoryGeneration({
+  const storyFlow = useRpgRuntimeStory({
     gameState,
     setGameState,
     buildResolvedChoiceState: combatFlow.buildResolvedChoiceState,
@@ -1837,7 +1846,7 @@ function SceneActPreviewRuntime({
   }
 
   return (
-    <GameShellRuntime
+    <RpgRuntimeShell
       session={{
         gameState,
         currentStory: storyFlow.currentStory,
@@ -2461,7 +2470,7 @@ function SceneImageGenerationModal({
     setError(null);
 
     try {
-      const result = await generateCustomWorldSceneImage({
+        const result = await rpgCreationAssetClient.generateSceneImage({
         profile,
         landmark,
         userPrompt,
@@ -3149,7 +3158,7 @@ function CoverImageGenerationModal({
   );
 }
 
-function WorldCoverEditor({
+export function WorldCoverEditor({
   profile,
   onSaveProfile,
   onClose,
@@ -3358,7 +3367,7 @@ function WorldCoverEditor({
   );
 }
 
-function SaveBar({
+export function SaveBar({
   onClose,
   onSave,
   extraAction,
@@ -3404,7 +3413,7 @@ function SaveBar({
   );
 }
 
-function SectionPanel({
+export function SectionPanel({
   title,
   subtitle,
   actions,
@@ -4411,7 +4420,7 @@ function StoryNpcVisualEditorModal({
   );
 }
 
-function WorldEditor({
+export function WorldEditor({
   profile,
   onSave,
   onClose,
@@ -4502,7 +4511,7 @@ function WorldEditor({
   );
 }
 
-function CampSceneEditor({
+export function CampSceneEditor({
   profile,
   onSaveProfile,
   onClose,
@@ -4523,7 +4532,7 @@ function CampSceneEditor({
   );
 }
 
-function PlayableNpcEditor({
+export function PlayableNpcEditor({
   profile,
   npc,
   mode,
@@ -4782,7 +4791,7 @@ function PlayableNpcEditor({
           showClose={false}
         />
         {isAiAssetStudioOpen ? (
-          <CustomWorldRoleAssetStudioModal
+          <RpgCreationRoleAssetStudioModal
             role={draft}
             roleKind="playable"
             onApply={(nextRole) =>
@@ -4827,7 +4836,7 @@ function PlayableNpcEditor({
   );
 }
 
-function StoryNpcEditor({
+export function StoryNpcEditor({
   profile,
   npc,
   mode,
@@ -5078,7 +5087,7 @@ function StoryNpcEditor({
           />
         ) : null}
         {isAiAssetStudioOpen ? (
-          <CustomWorldRoleAssetStudioModal
+          <RpgCreationRoleAssetStudioModal
             role={draft}
             roleKind="story"
             onApply={(nextRole) =>
@@ -5123,7 +5132,7 @@ function StoryNpcEditor({
   );
 }
 
-function LandmarkEditor({
+export function LandmarkEditor({
   profile,
   landmark,
   mode,
@@ -5908,238 +5917,12 @@ function LandmarkEditor({
   );
 }
 
-function createPlayableNpc(
-  profile: CustomWorldProfile,
-): CustomWorldPlayableNpc {
-  const seed = Date.now() + profile.playableNpcs.length;
-  const template =
-    ROLE_TEMPLATE_CHARACTERS[
-      profile.playableNpcs.length % Math.max(1, ROLE_TEMPLATE_CHARACTERS.length)
-    ] ?? ROLE_TEMPLATE_CHARACTERS[0];
-
-  return {
-    id: createEntryId(
-      'playable-npc',
-      `角色-${profile.playableNpcs.length + 1}`,
-      seed,
-    ),
-    name: `自定义角色${profile.playableNpcs.length + 1}`,
-    title: '自定义身份',
-    role: '世界中的行动者',
-    description: '',
-    backstory: '',
-    personality: '',
-    motivation: '',
-    combatStyle: '',
-    initialAffinity: 18,
-    relationshipHooks: ['首次接触', '合作空间'],
-    relations: [],
-    tags: ['自定义'],
-    backstoryReveal: {
-      publicSummary: '',
-      chapters: [
-        {
-          id: 'surface',
-          title: '表层来意',
-          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_EASED,
-          teaser: '',
-          content: '',
-          contextSnippet: '',
-        },
-        {
-          id: 'scar',
-          title: '旧事裂痕',
-          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_FRIENDLY,
-          teaser: '',
-          content: '',
-          contextSnippet: '',
-        },
-        {
-          id: 'hidden',
-          title: '隐藏执念',
-          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_TRUSTED,
-          teaser: '',
-          content: '',
-          contextSnippet: '',
-        },
-        {
-          id: 'final',
-          title: '最终底牌',
-          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_CLOSE,
-          teaser: '',
-          content: '',
-          contextSnippet: '',
-        },
-      ],
-    },
-    skills: [
-      { id: 'skill-1', name: '基础起手', summary: '', style: '起手压制' },
-      { id: 'skill-2', name: '常用变招', summary: '', style: '机动周旋' },
-      { id: 'skill-3', name: '压箱底牌', summary: '', style: '爆发终结' },
-    ],
-    initialItems: [
-      {
-        id: 'item-1',
-        name: '随身武具',
-        category: '武器',
-        quantity: 1,
-        rarity: 'rare',
-        description: '',
-        tags: ['自定义'],
-      },
-      {
-        id: 'item-2',
-        name: '补给包',
-        category: '消耗品',
-        quantity: 2,
-        rarity: 'uncommon',
-        description: '',
-        tags: ['自定义'],
-      },
-      {
-        id: 'item-3',
-        name: '私人物件',
-        category: '专属物品',
-        quantity: 1,
-        rarity: 'rare',
-        description: '',
-        tags: ['自定义'],
-      },
-    ],
-    templateCharacterId: template?.id,
-  };
-}
-
-function createStoryNpc(
-  profile: Pick<CustomWorldProfile, 'storyNpcs'>,
-): CustomWorldNpc {
-  const seed = Date.now() + profile.storyNpcs.length;
-  const npc = {
-    id: createEntryId(
-      'story-npc',
-      `场景角色-${profile.storyNpcs.length + 1}`,
-      seed,
-    ),
-    name: `自定义场景角色${profile.storyNpcs.length + 1}`,
-    title: '自定义头衔',
-    role: '自定义身份',
-    description: '',
-    backstory: '',
-    personality: '',
-    motivation: '',
-    combatStyle: '',
-    initialAffinity: 6,
-    relationshipHooks: ['合作', '互动'],
-    relations: [],
-    tags: ['自定义'],
-    backstoryReveal: {
-      publicSummary: '',
-      chapters: [
-        {
-          id: 'surface',
-          title: '表层来意',
-          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_EASED,
-          teaser: '',
-          content: '',
-          contextSnippet: '',
-        },
-        {
-          id: 'scar',
-          title: '旧事裂痕',
-          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_FRIENDLY,
-          teaser: '',
-          content: '',
-          contextSnippet: '',
-        },
-        {
-          id: 'hidden',
-          title: '隐藏执念',
-          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_TRUSTED,
-          teaser: '',
-          content: '',
-          contextSnippet: '',
-        },
-        {
-          id: 'final',
-          title: '最终底牌',
-          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_CLOSE,
-          teaser: '',
-          content: '',
-          contextSnippet: '',
-        },
-      ],
-    },
-    skills: [
-      { id: 'skill-1', name: '基础起手', summary: '', style: '起手压制' },
-      { id: 'skill-2', name: '常用变招', summary: '', style: '机动周旋' },
-      { id: 'skill-3', name: '压箱底牌', summary: '', style: '爆发终结' },
-    ],
-    initialItems: [
-      {
-        id: 'item-1',
-        name: '随身武具',
-        category: '武器',
-        quantity: 1,
-        rarity: 'rare',
-        description: '',
-        tags: ['自定义'],
-      },
-      {
-        id: 'item-2',
-        name: '补给包',
-        category: '消耗品',
-        quantity: 2,
-        rarity: 'uncommon',
-        description: '',
-        tags: ['自定义'],
-      },
-      {
-        id: 'item-3',
-        name: '私人物件',
-        category: '专属物品',
-        quantity: 1,
-        rarity: 'rare',
-        description: '',
-        tags: ['自定义'],
-      },
-    ],
-  } satisfies CustomWorldNpc;
-
-  return npc;
-}
-
-function createLandmark(profile: CustomWorldProfile): CustomWorldLandmark {
-  const seed = Date.now() + profile.landmarks.length;
-  const previousLandmark = profile.landmarks[profile.landmarks.length - 1];
-  return {
-    id: createEntryId(
-      'landmark',
-      `scene-${profile.landmarks.length + 1}`,
-      seed,
-    ),
-    name: `自定义场景${profile.landmarks.length + 1}`,
-    description: '',
-    dangerLevel: '中',
-    imageSrc: undefined,
-    sceneNpcIds: profile.storyNpcs.slice(0, 3).map((npc) => npc.id),
-    connections: previousLandmark
-      ? [
-          {
-            targetLandmarkId: previousLandmark.id,
-            relativePosition: 'south',
-            summary: `南侧可回到${previousLandmark.name}`,
-          },
-        ]
-      : [],
-  };
-}
-
-function CustomWorldEntityEditorModal({
+function RpgCreationEntityEditorModal({
   profile,
   target,
   onClose,
   onProfileChange,
-}: CustomWorldEntityEditorModalProps) {
+}: RpgCreationEntityEditorModalProps) {
   if (!target) return null;
 
   if (target.kind === 'world') {
@@ -6173,102 +5956,62 @@ function CustomWorldEntityEditorModal({
   }
 
   if (target.kind === 'playable') {
-    if (target.mode === 'create') {
-      return (
-        <PlayableNpcEditor
-          profile={profile}
-          npc={createPlayableNpc(profile)}
-          mode="create"
-          onSave={(nextNpc) =>
-            onProfileChange({
-              ...profile,
-              playableNpcs: [...profile.playableNpcs, nextNpc],
-            })
-          }
-          onClose={onClose}
-        />
-      );
-    }
-
-    const npc = profile.playableNpcs.find((item) => item.id === target.id);
+    const npc = resolveEditablePlayableNpc(profile, target);
     return npc ? (
       <PlayableNpcEditor
         profile={profile}
         npc={npc}
-        mode="edit"
+        mode={target.mode}
         onSave={(nextNpc) =>
           onProfileChange({
-            ...profile,
-            playableNpcs: profile.playableNpcs.map((item) =>
-              item.id === nextNpc.id ? nextNpc : item,
-            ),
-          })
-        }
+              ...profile,
+              playableNpcs:
+                target.mode === 'create'
+                  ? [...profile.playableNpcs, nextNpc]
+                  : profile.playableNpcs.map((item) =>
+                      item.id === nextNpc.id ? nextNpc : item,
+                    ),
+            })
+          }
         onClose={onClose}
       />
     ) : null;
   }
 
   if (target.kind === 'story') {
-    if (target.mode === 'create') {
-      return (
-        <StoryNpcEditor
-          profile={profile}
-          npc={createStoryNpc(profile)}
-          mode="create"
-          onSave={(nextNpc) =>
-            onProfileChange({
-              ...profile,
-              storyNpcs: [...profile.storyNpcs, nextNpc],
-            })
-          }
-          onClose={onClose}
-        />
-      );
-    }
-
-    const npc = profile.storyNpcs.find((item) => item.id === target.id);
+    const npc = resolveEditableStoryNpc(profile, target);
     return npc ? (
       <StoryNpcEditor
         profile={profile}
         npc={npc}
-        mode="edit"
+        mode={target.mode}
         onSave={(nextNpc) =>
           onProfileChange({
-            ...profile,
-            storyNpcs: profile.storyNpcs.map((item) =>
-              item.id === nextNpc.id ? nextNpc : item,
-            ),
-          })
-        }
+              ...profile,
+              storyNpcs:
+                target.mode === 'create'
+                  ? [...profile.storyNpcs, nextNpc]
+                  : profile.storyNpcs.map((item) =>
+                      item.id === nextNpc.id ? nextNpc : item,
+                    ),
+            })
+          }
         onClose={onClose}
       />
     ) : null;
   }
 
-  if (target.mode === 'create') {
-    return (
-      <LandmarkEditor
-        profile={profile}
-        landmark={createLandmark(profile)}
-        mode="create"
-        onSaveProfile={onProfileChange}
-        onClose={onClose}
-      />
-    );
-  }
-
-  const landmark = profile.landmarks.find((entry) => entry.id === target.id);
+  const landmark = resolveEditableLandmark(profile, target);
   return landmark ? (
     <LandmarkEditor
       profile={profile}
       landmark={landmark}
-      mode="edit"
+      mode={target.mode}
       onSaveProfile={onProfileChange}
       onClose={onClose}
     />
   ) : null;
 }
 
-export { CustomWorldEntityEditorModal };
-export default CustomWorldEntityEditorModal;
+export { RpgCreationEntityEditorModal };
+export default RpgCreationEntityEditorModal;
diff --git a/src/components/rpg-creation-editor/rpgCreationResultFormMapper.ts b/src/components/rpg-creation-editor/rpgCreationResultFormMapper.ts
new file mode 100644
index 00000000..2c93088a
--- /dev/null
+++ b/src/components/rpg-creation-editor/rpgCreationResultFormMapper.ts
@@ -0,0 +1,304 @@
+import type {
+  RpgCreationEditorTarget,
+  RpgCreationEntityEditorModalProps,
+} from './RpgCreationEntityEditorModalImpl';
+import type {
+  CustomWorldLandmark,
+  CustomWorldNpc,
+  CustomWorldPlayableNpc,
+  CustomWorldProfile,
+} from '../../types';
+
+/**
+ * 工作包 C 第一轮先把编辑器目标分发需要的 profile 变更收口到 mapper。
+ * 后续继续拆 section 表单时，提交 patch 和字段清洗会逐步下沉到这里。
+ */
+
+function slugify(value: string) {
+  const normalized = value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+
+  return normalized || 'entry';
+}
+
+function createEntryId(prefix: string, label: string, seed: number) {
+  return `${prefix}-${slugify(label || `${prefix}-${seed}`)}-${seed.toString(36)}`;
+}
+
+const BACKSTORY_UNLOCK_AFFINITY_EASED = 6;
+const BACKSTORY_UNLOCK_AFFINITY_FRIENDLY = 12;
+const BACKSTORY_UNLOCK_AFFINITY_TRUSTED = 18;
+const BACKSTORY_UNLOCK_AFFINITY_CLOSE = 24;
+
+export function createPlayableNpcDraft(
+  profile: CustomWorldProfile,
+): CustomWorldPlayableNpc {
+  const seed = Date.now() + profile.playableNpcs.length;
+
+  return {
+    id: createEntryId(
+      'playable-npc',
+      `角色-${profile.playableNpcs.length + 1}`,
+      seed,
+    ),
+    name: `自定义角色${profile.playableNpcs.length + 1}`,
+    title: '自定义身份',
+    role: '世界中的行动者',
+    description: '',
+    backstory: '',
+    personality: '',
+    motivation: '',
+    combatStyle: '',
+    initialAffinity: 18,
+    relationshipHooks: ['首次接触', '合作空间'],
+    relations: [],
+    tags: ['自定义'],
+    backstoryReveal: {
+      publicSummary: '',
+      chapters: [
+        {
+          id: 'surface',
+          title: '表层来意',
+          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_EASED,
+          teaser: '',
+          content: '',
+          contextSnippet: '',
+        },
+        {
+          id: 'scar',
+          title: '旧事裂痕',
+          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_FRIENDLY,
+          teaser: '',
+          content: '',
+          contextSnippet: '',
+        },
+        {
+          id: 'hidden',
+          title: '隐藏执念',
+          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_TRUSTED,
+          teaser: '',
+          content: '',
+          contextSnippet: '',
+        },
+        {
+          id: 'final',
+          title: '最终底牌',
+          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_CLOSE,
+          teaser: '',
+          content: '',
+          contextSnippet: '',
+        },
+      ],
+    },
+    skills: [
+      { id: 'skill-1', name: '基础起手', summary: '', style: '起手压制' },
+      { id: 'skill-2', name: '常用变招', summary: '', style: '机动周旋' },
+      { id: 'skill-3', name: '压箱底牌', summary: '', style: '爆发终结' },
+    ],
+    initialItems: [
+      {
+        id: 'item-1',
+        name: '随身武具',
+        category: '武器',
+        quantity: 1,
+        rarity: 'rare',
+        description: '',
+        tags: ['自定义'],
+      },
+      {
+        id: 'item-2',
+        name: '补给包',
+        category: '消耗品',
+        quantity: 2,
+        rarity: 'uncommon',
+        description: '',
+        tags: ['自定义'],
+      },
+      {
+        id: 'item-3',
+        name: '私人物件',
+        category: '专属物品',
+        quantity: 1,
+        rarity: 'rare',
+        description: '',
+        tags: ['自定义'],
+      },
+    ],
+    templateCharacterId: profile.playableNpcs[0]?.templateCharacterId,
+  };
+}
+
+export function createStoryNpcDraft(
+  profile: Pick<CustomWorldProfile, 'storyNpcs'>,
+): CustomWorldNpc {
+  const seed = Date.now() + profile.storyNpcs.length;
+
+  return {
+    id: createEntryId(
+      'story-npc',
+      `场景角色-${profile.storyNpcs.length + 1}`,
+      seed,
+    ),
+    name: `自定义场景角色${profile.storyNpcs.length + 1}`,
+    title: '自定义头衔',
+    role: '自定义身份',
+    description: '',
+    backstory: '',
+    personality: '',
+    motivation: '',
+    combatStyle: '',
+    initialAffinity: 6,
+    relationshipHooks: ['合作', '互动'],
+    relations: [],
+    tags: ['自定义'],
+    backstoryReveal: {
+      publicSummary: '',
+      chapters: [
+        {
+          id: 'surface',
+          title: '表层来意',
+          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_EASED,
+          teaser: '',
+          content: '',
+          contextSnippet: '',
+        },
+        {
+          id: 'scar',
+          title: '旧事裂痕',
+          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_FRIENDLY,
+          teaser: '',
+          content: '',
+          contextSnippet: '',
+        },
+        {
+          id: 'hidden',
+          title: '隐藏执念',
+          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_TRUSTED,
+          teaser: '',
+          content: '',
+          contextSnippet: '',
+        },
+        {
+          id: 'final',
+          title: '最终底牌',
+          affinityRequired: BACKSTORY_UNLOCK_AFFINITY_CLOSE,
+          teaser: '',
+          content: '',
+          contextSnippet: '',
+        },
+      ],
+    },
+    skills: [
+      { id: 'skill-1', name: '基础起手', summary: '', style: '起手压制' },
+      { id: 'skill-2', name: '常用变招', summary: '', style: '机动周旋' },
+      { id: 'skill-3', name: '压箱底牌', summary: '', style: '爆发终结' },
+    ],
+    initialItems: [
+      {
+        id: 'item-1',
+        name: '随身武具',
+        category: '武器',
+        quantity: 1,
+        rarity: 'rare',
+        description: '',
+        tags: ['自定义'],
+      },
+      {
+        id: 'item-2',
+        name: '补给包',
+        category: '消耗品',
+        quantity: 2,
+        rarity: 'uncommon',
+        description: '',
+        tags: ['自定义'],
+      },
+      {
+        id: 'item-3',
+        name: '私人物件',
+        category: '专属物品',
+        quantity: 1,
+        rarity: 'rare',
+        description: '',
+        tags: ['自定义'],
+      },
+    ],
+  } satisfies CustomWorldNpc;
+}
+
+export function createLandmarkDraft(
+  profile: CustomWorldProfile,
+): CustomWorldLandmark {
+  const seed = Date.now() + profile.landmarks.length;
+  const previousLandmark = profile.landmarks[profile.landmarks.length - 1];
+
+  return {
+    id: createEntryId(
+      'landmark',
+      `scene-${profile.landmarks.length + 1}`,
+      seed,
+    ),
+    name: `自定义场景${profile.landmarks.length + 1}`,
+    description: '',
+    dangerLevel: '中',
+    imageSrc: undefined,
+    sceneNpcIds: profile.storyNpcs.slice(0, 3).map((npc) => npc.id),
+    connections: previousLandmark
+      ? [
+          {
+            targetLandmarkId: previousLandmark.id,
+            relativePosition: 'south',
+            summary: `南侧可回到${previousLandmark.name}`,
+          },
+        ]
+      : [],
+  };
+}
+
+export function buildEditorTargetRendererParams(
+  props: RpgCreationEntityEditorModalProps,
+) {
+  const { profile, target, onClose, onProfileChange } = props;
+
+  return {
+    onClose,
+    onProfileChange,
+    profile,
+    target,
+  };
+}
+
+export function resolveEditablePlayableNpc(
+  profile: CustomWorldProfile,
+  target: Extract<RpgCreationEditorTarget, { kind: 'playable' }>,
+) {
+  if (target.mode === 'create') {
+    return createPlayableNpcDraft(profile);
+  }
+
+  return profile.playableNpcs.find((item) => item.id === target.id) ?? null;
+}
+
+export function resolveEditableStoryNpc(
+  profile: CustomWorldProfile,
+  target: Extract<RpgCreationEditorTarget, { kind: 'story' }>,
+) {
+  if (target.mode === 'create') {
+    return createStoryNpcDraft(profile);
+  }
+
+  return profile.storyNpcs.find((item) => item.id === target.id) ?? null;
+}
+
+export function resolveEditableLandmark(
+  profile: CustomWorldProfile,
+  target: Extract<RpgCreationEditorTarget, { kind: 'landmark' }>,
+) {
+  if (target.mode === 'create') {
+    return createLandmarkDraft(profile);
+  }
+
+  return profile.landmarks.find((item) => item.id === target.id) ?? null;
+}
diff --git a/src/components/rpg-creation-result/RpgCreationAssetDebugPanel.tsx b/src/components/rpg-creation-result/RpgCreationAssetDebugPanel.tsx
new file mode 100644
index 00000000..1f8d61cb
--- /dev/null
+++ b/src/components/rpg-creation-result/RpgCreationAssetDebugPanel.tsx
@@ -0,0 +1,291 @@
+import { useEffect, useMemo, useState } from 'react';
+
+import type { CustomWorldProfile } from '../../types';
+
+type RpgCreationAssetDebugEntry = {
+  id: string;
+  kind: 'playable' | 'story' | 'landmark' | 'scene-act';
+  label: string;
+  imageSrc: string;
+};
+
+type AssetDebugLoadStatus = 'loading' | 'loaded' | 'error';
+
+const RPG_CREATION_ASSET_DEBUG_QUERY_KEY = 'debugCustomWorldAssets';
+const RPG_CREATION_ASSET_DEBUG_STORAGE_KEY =
+  'genarrative.debug.customWorldAssets';
+
+function isPresent<T>(value: T | null): value is T {
+  return value !== null;
+}
+
+export function shouldEnableRpgCreationAssetDebugPanel() {
+  if (!import.meta.env.DEV || typeof window === 'undefined') {
+    return false;
+  }
+
+  const searchParams = new URLSearchParams(window.location.search);
+  if (searchParams.get(RPG_CREATION_ASSET_DEBUG_QUERY_KEY) === '1') {
+    return true;
+  }
+
+  return (
+    window.localStorage.getItem(RPG_CREATION_ASSET_DEBUG_STORAGE_KEY) === '1'
+  );
+}
+
+function collectRpgCreationAssetDebugEntries(
+  profile: CustomWorldProfile,
+): RpgCreationAssetDebugEntry[] {
+  const playableEntries = profile.playableNpcs
+    .map((role) => {
+      const imageSrc = role.imageSrc?.trim() || '';
+      if (!imageSrc) {
+        return null;
+      }
+
+      return {
+        id: `playable:${role.id}`,
+        label: `${role.name}主形象`,
+        imageSrc,
+        kind: 'playable' as const,
+      };
+    })
+    .filter(isPresent);
+  const storyEntries = profile.storyNpcs
+    .map((role) => {
+      const imageSrc = role.imageSrc?.trim() || '';
+      if (!imageSrc) {
+        return null;
+      }
+
+      return {
+        id: `story:${role.id}`,
+        label: `${role.name}场景角色主图`,
+        imageSrc,
+        kind: 'story' as const,
+      };
+    })
+    .filter(isPresent);
+  const landmarkEntries = profile.landmarks
+    .map((landmark) => {
+      const imageSrc = landmark.imageSrc?.trim() || '';
+      if (!imageSrc) {
+        return null;
+      }
+
+      return {
+        id: `landmark:${landmark.id}`,
+        label: `${landmark.name}场景主图`,
+        imageSrc,
+        kind: 'landmark' as const,
+      };
+    })
+    .filter(isPresent);
+  const sceneActEntries =
+    profile.sceneChapterBlueprints?.flatMap((chapter) =>
+      chapter.acts
+        .map((act) => {
+          const imageSrc = act.backgroundImageSrc?.trim() || '';
+          if (!imageSrc) {
+            return null;
+          }
+
+          return {
+            id: `scene-act:${chapter.id}:${act.id}`,
+            label: `${chapter.title || chapter.sceneId} / ${act.title}幕图`,
+            imageSrc,
+            kind: 'scene-act' as const,
+          };
+        })
+        .filter(isPresent),
+    ) ?? [];
+
+  return [
+    ...playableEntries,
+    ...storyEntries,
+    ...landmarkEntries,
+    ...sceneActEntries,
+  ];
+}
+
+function resolveAssetDebugStatusLabel(status: AssetDebugLoadStatus | undefined) {
+  if (status === 'loaded') {
+    return '已加载';
+  }
+  if (status === 'error') {
+    return '加载失败';
+  }
+  return '检测中';
+}
+
+function resolveAssetDebugSummary(profile: CustomWorldProfile) {
+  return [
+    {
+      label: '可扮演角色主图',
+      value: `${profile.playableNpcs.filter((role) => Boolean(role.imageSrc?.trim())).length}/${profile.playableNpcs.length}`,
+    },
+    {
+      label: '场景角色主图',
+      value: `${profile.storyNpcs.filter((role) => Boolean(role.imageSrc?.trim())).length}/${profile.storyNpcs.length}`,
+    },
+    {
+      label: '场景主图',
+      value: `${profile.landmarks.filter((landmark) => Boolean(landmark.imageSrc?.trim())).length}/${profile.landmarks.length}`,
+    },
+    {
+      label: '分幕图',
+      value: `${profile.sceneChapterBlueprints?.reduce(
+        (sum, chapter) =>
+          sum +
+          chapter.acts.filter((act) => Boolean(act.backgroundImageSrc?.trim()))
+            .length,
+        0,
+      ) ?? 0}/${
+        profile.sceneChapterBlueprints?.reduce(
+          (sum, chapter) => sum + chapter.acts.length,
+          0,
+        ) ?? 0
+      }`,
+    },
+  ];
+}
+
+export function RpgCreationAssetDebugPanel({
+  profile,
+}: {
+  profile: CustomWorldProfile;
+}) {
+  const assetDebugEntries = useMemo(
+    () => collectRpgCreationAssetDebugEntries(profile),
+    [profile],
+  );
+  const assetDebugSummary = useMemo(
+    () => resolveAssetDebugSummary(profile),
+    [profile],
+  );
+  const [assetDebugStatusMap, setAssetDebugStatusMap] = useState<
+    Record<string, AssetDebugLoadStatus>
+  >({});
+
+  useEffect(() => {
+    if (assetDebugEntries.length === 0) {
+      setAssetDebugStatusMap({});
+      return;
+    }
+
+    let cancelled = false;
+    const cleanupList: Array<() => void> = [];
+
+    setAssetDebugStatusMap(
+      Object.fromEntries(
+        assetDebugEntries.map((entry) => [entry.id, 'loading' as const]),
+      ),
+    );
+
+    assetDebugEntries.forEach((entry) => {
+      const image = new Image();
+      const updateStatus = (status: AssetDebugLoadStatus) => {
+        if (cancelled) {
+          return;
+        }
+
+        setAssetDebugStatusMap((current) => {
+          if (current[entry.id] === status) {
+            return current;
+          }
+
+          return {
+            ...current,
+            [entry.id]: status,
+          };
+        });
+      };
+
+      image.onload = () => updateStatus('loaded');
+      image.onerror = () => updateStatus('error');
+      image.src = entry.imageSrc;
+      cleanupList.push(() => {
+        image.onload = null;
+        image.onerror = null;
+      });
+    });
+
+    return () => {
+      cancelled = true;
+      cleanupList.forEach((cleanup) => cleanup());
+    };
+  }, [assetDebugEntries]);
+
+  return (
+    <div className="platform-surface platform-surface--soft mt-3 px-3.5 py-3">
+      <div className="flex items-start justify-between gap-3">
+        <div>
+          <div className="text-xs font-bold tracking-[0.16em] text-white">
+            资产诊断
+          </div>
+          <div className="mt-1 text-xs leading-6 text-zinc-500">
+            仅开发模式显示，用来核对结果页当前拿到的图片字段和实际加载状态。
+          </div>
+        </div>
+        <div className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
+          {assetDebugEntries.length}项
+        </div>
+      </div>
+      <div className="mt-3 grid grid-cols-2 gap-2 xl:grid-cols-4">
+        {assetDebugSummary.map((entry) => (
+          <div
+            key={entry.label}
+            className="platform-subpanel rounded-2xl px-3 py-2"
+          >
+            <div className="text-[11px] text-zinc-500">{entry.label}</div>
+            <div className="mt-1 text-sm font-semibold text-white">
+              {entry.value}
+            </div>
+          </div>
+        ))}
+      </div>
+      <div className="mt-3 space-y-2">
+        {assetDebugEntries.length > 0 ? (
+          assetDebugEntries.map((entry) => (
+            <div
+              key={entry.id}
+              className="platform-subpanel rounded-2xl px-3 py-2"
+            >
+              <div className="flex items-start justify-between gap-3">
+                <div className="min-w-0">
+                  <div className="text-sm font-semibold text-white">
+                    {entry.label}
+                  </div>
+                  <div className="mt-1 break-all text-[11px] leading-5 text-zinc-400">
+                    {entry.imageSrc}
+                  </div>
+                </div>
+                <div className="platform-pill platform-pill--neutral px-2.5 py-1 text-[10px]">
+                  {resolveAssetDebugStatusLabel(assetDebugStatusMap[entry.id])}
+                </div>
+              </div>
+              <div className="mt-2">
+                <a
+                  href={entry.imageSrc}
+                  target="_blank"
+                  rel="noreferrer"
+                  aria-label={`打开 ${entry.label}`}
+                  className="text-xs font-semibold text-amber-200 underline decoration-white/20 underline-offset-2"
+                >
+                  打开原图
+                </a>
+              </div>
+            </div>
+          ))
+        ) : (
+          <div className="platform-subpanel rounded-2xl px-3 py-3 text-sm text-zinc-400">
+            当前结果页 profile 里没有拿到任何可诊断的图片地址。
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}
+
+export default RpgCreationAssetDebugPanel;
diff --git a/src/components/rpg-creation-result/RpgCreationResultActionBar.tsx b/src/components/rpg-creation-result/RpgCreationResultActionBar.tsx
new file mode 100644
index 00000000..69213f8b
--- /dev/null
+++ b/src/components/rpg-creation-result/RpgCreationResultActionBar.tsx
@@ -0,0 +1,97 @@
+import type { ReactNode } from 'react';
+
+import type { CustomWorldProfile } from '../../types';
+
+function SmallButton({
+  children,
+  disabled = false,
+  onClick,
+  tone = 'default',
+}: {
+  children: ReactNode;
+  disabled?: boolean;
+  onClick: () => void;
+  tone?: 'default' | 'sky';
+}) {
+  return (
+    <button
+      type="button"
+      onClick={onClick}
+      disabled={disabled}
+      className={`${
+        tone === 'sky'
+          ? 'platform-button platform-button--primary'
+          : 'platform-button platform-button--ghost'
+      } min-h-0 rounded-full px-3 py-2 text-sm ${disabled ? 'cursor-not-allowed opacity-45' : ''}`}
+    >
+      {children}
+    </button>
+  );
+}
+
+interface RpgCreationResultActionBarProps {
+  editActionLabel: string;
+  enterWorldActionLabel: string;
+  isGenerating: boolean;
+  onContinueExpand?: () => void;
+  onEditSetting?: () => void;
+  onEnterWorld?: () => void;
+  onRegenerate?: () => void;
+  profile: CustomWorldProfile;
+  regenerateActionLabel: string;
+  publishReady: boolean;
+}
+
+export function RpgCreationResultActionBar({
+  editActionLabel,
+  enterWorldActionLabel,
+  isGenerating,
+  onContinueExpand,
+  onEditSetting,
+  onEnterWorld,
+  onRegenerate,
+  profile,
+  regenerateActionLabel,
+  publishReady,
+}: RpgCreationResultActionBarProps) {
+  return (
+    <div className="mt-4 flex flex-col gap-3">
+      {profile.generationStatus === 'key_only' ? (
+        <div className="platform-banner platform-banner--warning rounded-2xl text-sm leading-6">
+          当前世界处于快速预览模式，只生成了关键对象。继续补全后，系统会生成长尾场景角色与完整场景网络。
+        </div>
+      ) : null}
+      <div className="flex items-center justify-end gap-3">
+        {onEditSetting ? (
+          <SmallButton onClick={onEditSetting}>{editActionLabel}</SmallButton>
+        ) : null}
+        {onRegenerate ? (
+          <SmallButton onClick={onRegenerate} tone="sky">
+            {regenerateActionLabel}
+          </SmallButton>
+        ) : null}
+        {profile.generationStatus === 'key_only' && onContinueExpand ? (
+          <SmallButton
+            onClick={onContinueExpand}
+            tone="sky"
+            disabled={isGenerating}
+          >
+            继续补全世界
+          </SmallButton>
+        ) : null}
+        {onEnterWorld ? (
+          <button
+            type="button"
+            onClick={onEnterWorld}
+            disabled={isGenerating || !publishReady}
+            className={`platform-button platform-button--primary ${isGenerating ? 'opacity-55' : ''}`}
+          >
+            {enterWorldActionLabel}
+          </button>
+        ) : null}
+      </div>
+    </div>
+  );
+}
+
+export default RpgCreationResultActionBar;
diff --git a/src/components/rpg-creation-result/RpgCreationResultHeader.tsx b/src/components/rpg-creation-result/RpgCreationResultHeader.tsx
new file mode 100644
index 00000000..02069cfb
--- /dev/null
+++ b/src/components/rpg-creation-result/RpgCreationResultHeader.tsx
@@ -0,0 +1,59 @@
+interface RpgCreationResultHeaderProps {
+  autoSaveState: 'idle' | 'saving' | 'saved' | 'error';
+  backLabel: string;
+  isGenerating: boolean;
+  onBack: () => void;
+}
+
+function renderAutoSaveBadge(
+  autoSaveState: RpgCreationResultHeaderProps['autoSaveState'],
+) {
+  if (autoSaveState === 'saved') {
+    return (
+      <div className="platform-pill platform-pill--success px-3 py-1 text-[11px]">
+        已自动保存
+      </div>
+    );
+  }
+
+  if (autoSaveState === 'saving') {
+    return (
+      <div className="platform-pill platform-pill--warm px-3 py-1 text-[11px]">
+        保存中
+      </div>
+    );
+  }
+
+  if (autoSaveState === 'error') {
+    return (
+      <div className="platform-pill platform-pill--rose px-3 py-1 text-[11px]">
+        保存失败
+      </div>
+    );
+  }
+
+  return null;
+}
+
+export function RpgCreationResultHeader({
+  autoSaveState,
+  backLabel,
+  isGenerating,
+  onBack,
+}: RpgCreationResultHeaderProps) {
+  return (
+    <div className="mb-4 flex items-center justify-between gap-3">
+      <button
+        type="button"
+        onClick={onBack}
+        disabled={isGenerating}
+        className={`platform-button platform-button--ghost min-h-0 self-start px-3 py-1.5 text-[11px] ${isGenerating ? 'opacity-45' : ''}`}
+      >
+        {backLabel}
+      </button>
+      {renderAutoSaveBadge(autoSaveState)}
+    </div>
+  );
+}
+
+export default RpgCreationResultHeader;
diff --git a/src/components/rpg-creation-result/RpgCreationResultView.tsx b/src/components/rpg-creation-result/RpgCreationResultView.tsx
index fc15fe67..e5594a78 100644
--- a/src/components/rpg-creation-result/RpgCreationResultView.tsx
+++ b/src/components/rpg-creation-result/RpgCreationResultView.tsx
@@ -1,17 +1,17 @@
 import type { ComponentProps } from 'react';
 
-import { CustomWorldResultView } from '../CustomWorldResultView';
+import { RpgCreationResultView as RpgCreationResultViewImpl } from './RpgCreationResultViewImpl';
 
 /**
- * 工作包 A 先提供 RPG 创作结果页的新命名 façade。
- * 当前结果页行为仍由旧组件承载，后续工作包 C 会在此目录内继续拆分 header、action bar 和 section。
+ * 工作包 C 完成后，结果页入口统一桥接 RPG 创作目录下的真实实现。
+ * 旧 `CustomWorldResultView.tsx` 兼容入口已经删除，后续结果页细化继续在该目录内部推进。
  */
 export type RpgCreationResultViewProps = ComponentProps<
-  typeof CustomWorldResultView
+  typeof RpgCreationResultViewImpl
 >;
 
 export function RpgCreationResultView(props: RpgCreationResultViewProps) {
-  return <CustomWorldResultView {...props} />;
+  return <RpgCreationResultViewImpl {...props} />;
 }
 
 export default RpgCreationResultView;
diff --git a/src/components/rpg-creation-result/RpgCreationResultViewImpl.tsx b/src/components/rpg-creation-result/RpgCreationResultViewImpl.tsx
new file mode 100644
index 00000000..16269603
--- /dev/null
+++ b/src/components/rpg-creation-result/RpgCreationResultViewImpl.tsx
@@ -0,0 +1,229 @@
+import { useMemo, useState } from 'react';
+
+import type { Character, CustomWorldProfile } from '../../types';
+import {
+  CustomWorldEntityCatalog,
+  type ResultTab,
+} from '../CustomWorldEntityCatalog';
+import RpgCreationEntityEditorModal from '../rpg-creation-editor/RpgCreationEntityEditorModal';
+import RpgCreationAssetDebugPanel, {
+  shouldEnableRpgCreationAssetDebugPanel,
+} from './RpgCreationAssetDebugPanel';
+import RpgCreationResultActionBar from './RpgCreationResultActionBar';
+import RpgCreationResultHeader from './RpgCreationResultHeader';
+import { useRpgCreationResultActions } from './useRpgCreationResultActions';
+
+export interface RpgCreationResultViewProps {
+  profile: CustomWorldProfile;
+  previewCharacters: Character[];
+  isGenerating: boolean;
+  progress: number;
+  progressLabel: string;
+  error: string | null;
+  onBack: () => void;
+  onEditSetting?: () => void;
+  onRegenerate?: () => void;
+  onContinueExpand?: () => void;
+  onEnterWorld?: () => void;
+  onProfileChange: (profile: CustomWorldProfile) => void;
+  readOnly?: boolean;
+  backLabel?: string;
+  editActionLabel?: string;
+  regenerateActionLabel?: string;
+  enterWorldActionLabel?: string;
+  autoSaveState?: 'idle' | 'saving' | 'saved' | 'error';
+  compactAgentResultMode?: boolean;
+  publishReady?: boolean;
+  publishBlockers?: string[];
+  qualityFindings?: Array<{
+    id: string;
+    severity: 'info' | 'warning' | 'blocker';
+    code: string;
+    targetId?: string | null;
+    message: string;
+  }>;
+  previewSourceLabel?: string | null;
+}
+
+export function RpgCreationResultView({
+  profile,
+  previewCharacters,
+  isGenerating,
+  progress,
+  progressLabel,
+  error,
+  onBack,
+  onEditSetting,
+  onRegenerate: triggerRegenerate,
+  onContinueExpand,
+  onEnterWorld,
+  onProfileChange,
+  readOnly = false,
+  backLabel = '返回',
+  editActionLabel = '修改设定',
+  regenerateActionLabel = '重新生成',
+  enterWorldActionLabel = '进入世界',
+  autoSaveState = 'idle',
+  compactAgentResultMode = false,
+  publishReady = true,
+  publishBlockers = [],
+  qualityFindings = [],
+  previewSourceLabel = null,
+}: RpgCreationResultViewProps) {
+  const [activeTab, setActiveTab] = useState<ResultTab>('world');
+  const assetDebugEnabled = useMemo(
+    () => shouldEnableRpgCreationAssetDebugPanel(),
+    [],
+  );
+  const {
+    closeEditorTarget,
+    createLabel,
+    createTarget,
+    editorTarget,
+    handleDeleteLandmarks,
+    handleDeleteStoryNpcs,
+    handleGenerateEntity,
+    handleRegenerate,
+    localGenerationError,
+    pendingGeneratedEntity,
+    recentGeneratedIds,
+    setEditorTarget,
+  } = useRpgCreationResultActions({
+    activeTab,
+    isGenerating,
+    onProfileChange,
+    profile,
+    readOnly,
+    triggerRegenerate,
+  });
+
+  return (
+    <div className="flex h-full min-h-0 flex-col">
+      <RpgCreationResultHeader
+        autoSaveState={autoSaveState}
+        backLabel={backLabel}
+        isGenerating={isGenerating}
+        onBack={onBack}
+      />
+
+      <div className="min-h-0 flex-1 overflow-hidden">
+        <CustomWorldEntityCatalog
+          profile={profile}
+          previewCharacters={previewCharacters}
+          activeTab={activeTab}
+          onActiveTabChange={setActiveTab}
+          onEditTarget={setEditorTarget}
+          onProfileChange={onProfileChange}
+          onDeleteStoryNpcs={handleDeleteStoryNpcs}
+          onDeleteLandmarks={handleDeleteLandmarks}
+          createActionLabel={
+            readOnly || compactAgentResultMode ? undefined : createLabel
+          }
+          onCreateAction={
+            readOnly || compactAgentResultMode || !createTarget
+              ? undefined
+              : () => {
+                  if (activeTab === 'playable') {
+                    void handleGenerateEntity('playable');
+                    return;
+                  }
+                  if (activeTab === 'story') {
+                    void handleGenerateEntity('story');
+                    return;
+                  }
+                  if (activeTab === 'landmarks') {
+                    void handleGenerateEntity('landmark');
+                    return;
+                  }
+                  setEditorTarget(createTarget);
+                }
+          }
+          createActionDisabled={Boolean(
+            isGenerating || pendingGeneratedEntity,
+          )}
+          pendingGeneratedEntity={pendingGeneratedEntity}
+          recentGeneratedIds={recentGeneratedIds}
+          readOnly={readOnly}
+        />
+      </div>
+
+      {isGenerating && (
+        <div className="platform-banner platform-banner--info mt-3 rounded-2xl px-4 py-4">
+          <div className="flex items-center justify-between gap-3">
+            <div className="text-sm font-semibold text-[var(--platform-text-strong)]">
+              {progressLabel}
+            </div>
+            <div className="text-xs text-[var(--platform-text-base)]">
+              {Math.round(progress)}%
+            </div>
+          </div>
+          <div className="platform-progress-track mt-3 h-3 overflow-hidden rounded-full">
+            <div
+              className="h-full bg-[linear-gradient(90deg,#ff4f8b_0%,#ff8a73_48%,#ffd2a6_100%)] transition-[width] duration-300"
+              style={{ width: `${Math.max(0, Math.min(100, progress))}%` }}
+            />
+          </div>
+        </div>
+      )}
+
+      {error ? (
+        <div className="platform-banner platform-banner--danger mt-3 rounded-2xl text-sm leading-6">
+          {error}
+        </div>
+      ) : null}
+      {!error && compactAgentResultMode && previewSourceLabel ? (
+        <div className="platform-banner platform-banner--info mt-3 rounded-2xl text-sm leading-6">
+          当前结果页数据源：{previewSourceLabel}
+        </div>
+      ) : null}
+      {!error && compactAgentResultMode && publishBlockers.length > 0 ? (
+        <div className="platform-banner platform-banner--warning mt-3 rounded-2xl text-sm leading-6">
+          {publishReady
+            ? '当前世界已满足发布门槛。'
+            : `当前还有 ${publishBlockers.length} 个发布阻断项，请先补齐后再进入世界。`}
+          <div className="mt-2 space-y-1">
+            {publishBlockers.slice(0, 4).map((entry, index) => (
+              <div key={`publish-blocker-${index}-${entry}`}>
+                {index + 1}. {entry}
+              </div>
+            ))}
+          </div>
+        </div>
+      ) : null}
+      {!error &&
+      compactAgentResultMode &&
+      publishBlockers.length <= 0 &&
+      qualityFindings.some((entry) => entry.severity === 'warning') ? (
+        <div className="platform-banner platform-banner--info mt-3 rounded-2xl text-sm leading-6">
+          发布后仍有 {qualityFindings.filter((entry) => entry.severity === 'warning').length} 条 warning 可继续优化。
+        </div>
+      ) : null}
+      {!error && localGenerationError ? (
+        <div className="platform-banner platform-banner--danger mt-3 rounded-2xl text-sm leading-6">
+          {localGenerationError}
+        </div>
+      ) : null}
+      {assetDebugEnabled ? <RpgCreationAssetDebugPanel profile={profile} /> : null}
+
+      <RpgCreationResultActionBar
+        editActionLabel={editActionLabel}
+        enterWorldActionLabel={enterWorldActionLabel}
+        isGenerating={isGenerating}
+        onContinueExpand={onContinueExpand}
+        onEditSetting={onEditSetting}
+        onEnterWorld={onEnterWorld}
+        onRegenerate={triggerRegenerate ? handleRegenerate : undefined}
+        profile={profile}
+        regenerateActionLabel={regenerateActionLabel}
+        publishReady={publishReady}
+      />
+
+      <RpgCreationEntityEditorModal
+        profile={profile}
+        target={editorTarget}
+        onClose={closeEditorTarget}
+        onProfileChange={onProfileChange}
+      />
+    </div>
+  );
+}
diff --git a/src/components/rpg-creation-result/useRpgCreationResultActions.ts b/src/components/rpg-creation-result/useRpgCreationResultActions.ts
new file mode 100644
index 00000000..5e86e50f
--- /dev/null
+++ b/src/components/rpg-creation-result/useRpgCreationResultActions.ts
@@ -0,0 +1,318 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+
+import { normalizeCustomWorldLandmarks } from '../../data/customWorldSceneGraph';
+import { rpgCreationAssetClient } from '../../services/rpg-creation/rpgCreationAssetClient';
+import type {
+  CustomWorldLandmark,
+  CustomWorldNpc,
+  CustomWorldPlayableNpc,
+  CustomWorldProfile,
+} from '../../types';
+import type { ResultTab } from '../CustomWorldEntityCatalog';
+import type { RpgCreationEditorTarget } from '../rpg-creation-editor/RpgCreationEntityEditorModal';
+
+export type EntityGenerationKind = 'playable' | 'story' | 'landmark';
+
+export type PendingGeneratedEntity = {
+  id: string;
+  kind: EntityGenerationKind;
+  title: string;
+  progress: number;
+  phaseLabel: string;
+};
+
+export type RecentGeneratedIds = Record<EntityGenerationKind, string[]>;
+
+function getCreateTargetByTab(
+  activeTab: ResultTab,
+): RpgCreationEditorTarget | null {
+  if (activeTab === 'playable') return { kind: 'playable', mode: 'create' };
+  if (activeTab === 'story') return { kind: 'story', mode: 'create' };
+  if (activeTab === 'landmarks') return { kind: 'landmark', mode: 'create' };
+  return null;
+}
+
+function getCreateLabelByTab(activeTab: ResultTab) {
+  if (activeTab === 'playable') return '新增可扮演角色';
+  if (activeTab === 'story') return '新增场景角色';
+  if (activeTab === 'landmarks') return '新增场景';
+  return '';
+}
+
+function createPendingGeneratedEntity(
+  kind: EntityGenerationKind,
+): PendingGeneratedEntity {
+  return {
+    id: `pending-${kind}-${Date.now()}`,
+    kind,
+    title:
+      kind === 'playable'
+        ? '新可扮演角色'
+        : kind === 'story'
+          ? '新场景角色'
+          : '新场景',
+    progress: 8,
+    phaseLabel: '正在整理世界上下文',
+  };
+}
+
+function resolvePendingPhaseLabel(
+  kind: EntityGenerationKind,
+  progress: number,
+) {
+  if (progress < 28) {
+    return '正在整理世界上下文';
+  }
+  if (progress < 72) {
+    return kind === 'landmark' ? '正在推理场景结构' : '正在推理角色结构';
+  }
+  return '正在回写结果';
+}
+
+function prependPlayableNpc(
+  profile: CustomWorldProfile,
+  npc: CustomWorldPlayableNpc,
+) {
+  return {
+    ...profile,
+    playableNpcs: [npc, ...profile.playableNpcs],
+  } satisfies CustomWorldProfile;
+}
+
+function prependStoryNpc(profile: CustomWorldProfile, npc: CustomWorldNpc) {
+  return {
+    ...profile,
+    storyNpcs: [npc, ...profile.storyNpcs],
+  } satisfies CustomWorldProfile;
+}
+
+function prependLandmark(
+  profile: CustomWorldProfile,
+  landmark: CustomWorldLandmark,
+) {
+  return {
+    ...profile,
+    landmarks: normalizeCustomWorldLandmarks({
+      landmarks: [landmark, ...profile.landmarks],
+      storyNpcs: profile.storyNpcs,
+    }),
+  } satisfies CustomWorldProfile;
+}
+
+function removeStoryNpcsFromProfile(
+  profile: CustomWorldProfile,
+  ids: string[],
+) {
+  const idSet = new Set(ids);
+  const nextStoryNpcs = profile.storyNpcs.filter((npc) => !idSet.has(npc.id));
+
+  return {
+    ...profile,
+    storyNpcs: nextStoryNpcs,
+    landmarks: normalizeCustomWorldLandmarks({
+      landmarks: profile.landmarks.map((landmark) => ({
+        ...landmark,
+        sceneNpcIds: landmark.sceneNpcIds.filter((npcId) => !idSet.has(npcId)),
+      })),
+      storyNpcs: nextStoryNpcs,
+    }),
+  } satisfies CustomWorldProfile;
+}
+
+function removeLandmarksFromProfile(
+  profile: CustomWorldProfile,
+  ids: string[],
+) {
+  const idSet = new Set(ids);
+  const nextLandmarks = profile.landmarks.filter(
+    (landmark) => !idSet.has(landmark.id),
+  );
+
+  return {
+    ...profile,
+    landmarks: normalizeCustomWorldLandmarks({
+      landmarks: nextLandmarks.map((landmark) => ({
+        ...landmark,
+        connections: landmark.connections.filter(
+          (connection) => !idSet.has(connection.targetLandmarkId),
+        ),
+      })),
+      storyNpcs: profile.storyNpcs,
+    }),
+  } satisfies CustomWorldProfile;
+}
+
+export function useRpgCreationResultActions(params: {
+  activeTab: ResultTab;
+  isGenerating: boolean;
+  onProfileChange: (profile: CustomWorldProfile) => void;
+  profile: CustomWorldProfile;
+  readOnly: boolean;
+  triggerRegenerate?: () => void;
+}) {
+  const {
+    activeTab,
+    isGenerating,
+    onProfileChange,
+    profile,
+    readOnly,
+    triggerRegenerate,
+  } = params;
+  const [editorTarget, setEditorTarget] =
+    useState<RpgCreationEditorTarget | null>(null);
+  const [pendingGeneratedEntity, setPendingGeneratedEntity] =
+    useState<PendingGeneratedEntity | null>(null);
+  const [recentGeneratedIds, setRecentGeneratedIds] = useState<RecentGeneratedIds>(
+    {
+      playable: [],
+      story: [],
+      landmark: [],
+    },
+  );
+  const [localGenerationError, setLocalGenerationError] = useState<string | null>(
+    null,
+  );
+  const pendingProgressTimerRef = useRef<number | null>(null);
+
+  const createTarget = useMemo(
+    () => getCreateTargetByTab(activeTab),
+    [activeTab],
+  );
+  const createLabel = useMemo(
+    () => getCreateLabelByTab(activeTab),
+    [activeTab],
+  );
+
+  const stopPendingProgressTimer = () => {
+    if (pendingProgressTimerRef.current !== null) {
+      window.clearInterval(pendingProgressTimerRef.current);
+      pendingProgressTimerRef.current = null;
+    }
+  };
+
+  useEffect(() => () => stopPendingProgressTimer(), []);
+
+  const startPendingProgress = (kind: EntityGenerationKind) => {
+    stopPendingProgressTimer();
+    setPendingGeneratedEntity(createPendingGeneratedEntity(kind));
+    pendingProgressTimerRef.current = window.setInterval(() => {
+      setPendingGeneratedEntity((current) => {
+        if (!current || current.kind !== kind) {
+          return current;
+        }
+
+        const nextProgress = Math.min(
+          current.progress + (current.progress < 56 ? 11 : 5),
+          88,
+        );
+
+        return {
+          ...current,
+          progress: nextProgress,
+          phaseLabel: resolvePendingPhaseLabel(kind, nextProgress),
+        };
+      });
+    }, 520);
+  };
+
+  const finishPendingProgress = () => {
+    stopPendingProgressTimer();
+    setPendingGeneratedEntity(null);
+  };
+
+  const markGeneratedAsRecent = (
+    kind: EntityGenerationKind,
+    generatedId: string,
+  ) => {
+    setRecentGeneratedIds((current) => ({
+      ...current,
+      [kind]: [
+        generatedId,
+        ...current[kind].filter((id) => id !== generatedId),
+      ].slice(0, 6),
+    }));
+  };
+
+  const handleGenerateEntity = async (kind: EntityGenerationKind) => {
+    if (readOnly || isGenerating || pendingGeneratedEntity) {
+      return;
+    }
+
+    setLocalGenerationError(null);
+    startPendingProgress(kind);
+
+    try {
+      if (kind === 'playable') {
+        const nextNpc = await rpgCreationAssetClient.generatePlayableNpc({
+          profile,
+        });
+        onProfileChange(prependPlayableNpc(profile, nextNpc));
+        markGeneratedAsRecent('playable', nextNpc.id);
+      } else if (kind === 'story') {
+        const nextNpc = await rpgCreationAssetClient.generateStoryNpc({
+          profile,
+        });
+        onProfileChange(prependStoryNpc(profile, nextNpc));
+        markGeneratedAsRecent('story', nextNpc.id);
+      } else {
+        const nextLandmark = await rpgCreationAssetClient.generateLandmark({
+          profile,
+        });
+        onProfileChange(prependLandmark(profile, nextLandmark));
+        markGeneratedAsRecent('landmark', nextLandmark.id);
+      }
+    } catch (generationError) {
+      setLocalGenerationError(
+        generationError instanceof Error
+          ? generationError.message
+          : '生成失败，请稍后重试。',
+      );
+    } finally {
+      finishPendingProgress();
+    }
+  };
+
+  const handleRegenerate = () => {
+    if (isGenerating || !triggerRegenerate) {
+      return;
+    }
+
+    const confirmed = window.confirm(
+      `确认重新生成“${profile.name}”吗？\n\n重新生成会重新生成当前世界中的所有信息，包括你修改和新增的所有内容。`,
+    );
+    if (!confirmed) {
+      return;
+    }
+
+    triggerRegenerate();
+  };
+
+  const handleDeleteStoryNpcs = (ids: string[]) => {
+    if (ids.length === 0) {
+      return;
+    }
+    onProfileChange(removeStoryNpcsFromProfile(profile, ids));
+  };
+
+  const handleDeleteLandmarks = (ids: string[]) => {
+    if (ids.length === 0) {
+      return;
+    }
+    onProfileChange(removeLandmarksFromProfile(profile, ids));
+  };
+
+  return {
+    createLabel,
+    createTarget,
+    editorTarget,
+    handleDeleteLandmarks,
+    handleDeleteStoryNpcs,
+    handleGenerateEntity,
+    handleRegenerate,
+    localGenerationError,
+    pendingGeneratedEntity,
+    recentGeneratedIds,
+    setEditorTarget,
+    closeEditorTarget: () => setEditorTarget(null),
+  };
+}
diff --git a/src/components/game-shell/PlatformBrandLogo.tsx b/src/components/rpg-entry/RpgEntryBrandLogo.tsx
similarity index 66%
rename from src/components/game-shell/PlatformBrandLogo.tsx
rename to src/components/rpg-entry/RpgEntryBrandLogo.tsx
index e33a7d46..2cc0525d 100644
--- a/src/components/game-shell/PlatformBrandLogo.tsx
+++ b/src/components/rpg-entry/RpgEntryBrandLogo.tsx
@@ -1,10 +1,16 @@
-export function PlatformBrandLogo({
-  className = '',
-  decorative = false,
-}: {
+export interface RpgEntryBrandLogoProps {
   className?: string;
   decorative?: boolean;
-}) {
+}
+
+/**
+ * RPG 入口品牌标识真实入口。
+ * 第三批收口后，入口主链直接落在 `rpg-entry` 平台品牌组件。
+ */
+export function RpgEntryBrandLogo({
+  className = '',
+  decorative = false,
+}: RpgEntryBrandLogoProps) {
   return (
     <span
       className={`platform-brand-logo ${className}`.trim()}
diff --git a/src/components/game-shell/CharacterSelectionFlow.test.tsx b/src/components/rpg-entry/RpgEntryCharacterSelectView.test.tsx
similarity index 98%
rename from src/components/game-shell/CharacterSelectionFlow.test.tsx
rename to src/components/rpg-entry/RpgEntryCharacterSelectView.test.tsx
index 7f3be518..0e827ebc 100644
--- a/src/components/game-shell/CharacterSelectionFlow.test.tsx
+++ b/src/components/rpg-entry/RpgEntryCharacterSelectView.test.tsx
@@ -12,7 +12,7 @@ import {
   type CustomWorldProfile,
   WorldType,
 } from '../../types';
-import { CharacterSelectionFlow } from './CharacterSelectionFlow';
+import { RpgEntryCharacterSelectView } from './RpgEntryCharacterSelectView';
 
 vi.mock('../../data/characterPresets', () => ({
   ROLE_TEMPLATE_CHARACTERS: [],
@@ -115,7 +115,7 @@ test('custom world character selection stays stable when character ids are empty
     });
 
   render(
-    <CharacterSelectionFlow
+    <RpgEntryCharacterSelectView
       worldType={WorldType.CUSTOM}
       customWorldProfile={{
         attributeSchema: {
diff --git a/src/components/game-shell/CharacterSelectionFlow.tsx b/src/components/rpg-entry/RpgEntryCharacterSelectView.tsx
similarity index 92%
rename from src/components/game-shell/CharacterSelectionFlow.tsx
rename to src/components/rpg-entry/RpgEntryCharacterSelectView.tsx
index ef1d605d..511d15bf 100644
--- a/src/components/game-shell/CharacterSelectionFlow.tsx
+++ b/src/components/rpg-entry/RpgEntryCharacterSelectView.tsx
@@ -1,4 +1,4 @@
-import {useCallback, useEffect, useMemo, useRef, useState} from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 
 import {
   buildCharacterAttributeProfile,
@@ -11,11 +11,16 @@ import {
   buildCustomWorldPlayableCharacters,
   ROLE_TEMPLATE_CHARACTERS,
 } from '../../data/characterPresets';
-import {AnimationState, type Character, type CustomWorldProfile, WorldType} from '../../types';
-import {getNineSliceStyle, UI_CHROME} from '../../uiAssets';
-import {CharacterAnimator} from '../CharacterAnimator';
-import {CharacterDetailModal} from '../CharacterDetailModal';
-import {CharacterDraftModal} from '../SelectionCustomizationModals';
+import {
+  AnimationState,
+  type Character,
+  type CustomWorldProfile,
+  WorldType,
+} from '../../types';
+import { getNineSliceStyle, UI_CHROME } from '../../uiAssets';
+import { CharacterAnimator } from '../CharacterAnimator';
+import { CharacterDetailModal } from '../CharacterDetailModal';
+import { CharacterDraftModal } from '../SelectionCustomizationModals';
 
 type CharacterSelectionDraft = {
   name: string;
@@ -24,19 +29,47 @@ type CharacterSelectionDraft = {
 
 type CarouselOrientation = 'horizontal' | 'vertical';
 
-type CharacterSelectionFlowProps = {
+export type RpgEntryCharacterSelectViewProps = {
   worldType: WorldType;
   customWorldProfile: CustomWorldProfile | null;
   onBack: () => void;
   onConfirm: (character: Character) => void;
 };
 
-const CHARACTER_DISPLAY: Record<string, {name: string; title: string; role: string; tags: string[]}> = {
-  'sword-princess': {name: '剑姬', title: '皇家之刃', role: '先锋', tags: ['剑术', '压制', '突进']},
-  'archer-hero': {name: '弓手英雄', title: '风之射手', role: '远程', tags: ['射程', '齐射', '风筝']},
-  'girl-hero': {name: '双刃刺客', title: '暗影之牙', role: '刺客', tags: ['连击', '冲锋', '机动']},
-  'punch-hero': {name: '战拳', title: '近战大师', role: '战士', tags: ['爆发', '格斗', '仇恨']},
-  'fighter-4': {name: '装甲长矛手', title: '重装先锋', role: '前线', tags: ['守护', '稳定', '突破']},
+const CHARACTER_DISPLAY: Record<
+  string,
+  { name: string; title: string; role: string; tags: string[] }
+> = {
+  'sword-princess': {
+    name: '剑姬',
+    title: '皇家之刃',
+    role: '先锋',
+    tags: ['剑术', '压制', '突进'],
+  },
+  'archer-hero': {
+    name: '弓手英雄',
+    title: '风之射手',
+    role: '远程',
+    tags: ['射程', '齐射', '风筝'],
+  },
+  'girl-hero': {
+    name: '双刃刺客',
+    title: '暗影之牙',
+    role: '刺客',
+    tags: ['连击', '冲锋', '机动'],
+  },
+  'punch-hero': {
+    name: '战拳',
+    title: '近战大师',
+    role: '战士',
+    tags: ['爆发', '格斗', '仇恨'],
+  },
+  'fighter-4': {
+    name: '装甲长矛手',
+    title: '重装先锋',
+    role: '前线',
+    tags: ['守护', '稳定', '突破'],
+  },
 };
 
 function getGenderLabel(gender: Character['gender']) {
@@ -168,12 +201,12 @@ function getCharacterCardStyle(index: number, progress: number) {
   };
 }
 
-export function CharacterSelectionFlow({
+export function RpgEntryCharacterSelectView({
   worldType,
   customWorldProfile,
   onBack,
   onConfirm,
-}: CharacterSelectionFlowProps) {
+}: RpgEntryCharacterSelectViewProps) {
   const selectionCharacters = useMemo(
     () => (customWorldProfile ? buildCustomWorldPlayableCharacters(customWorldProfile) : ROLE_TEMPLATE_CHARACTERS),
     [customWorldProfile],
@@ -467,3 +500,5 @@ export function CharacterSelectionFlow({
     </>
   );
 }
+
+export const CharacterSelectionFlow = RpgEntryCharacterSelectView;
diff --git a/src/components/game-shell/PlatformCreationTypeModal.tsx b/src/components/rpg-entry/RpgEntryCreationTypeModal.tsx
similarity index 94%
rename from src/components/game-shell/PlatformCreationTypeModal.tsx
rename to src/components/rpg-entry/RpgEntryCreationTypeModal.tsx
index 4c75721f..0728111b 100644
--- a/src/components/game-shell/PlatformCreationTypeModal.tsx
+++ b/src/components/rpg-entry/RpgEntryCreationTypeModal.tsx
@@ -1,12 +1,12 @@
 import { ArrowRight, X } from 'lucide-react';
 
-type PlatformCreationTypeModalProps = {
+export interface RpgEntryCreationTypeModalProps {
   isOpen: boolean;
   isBusy: boolean;
   error: string | null;
   onClose: () => void;
   onSelectRpg: () => void;
-};
+}
 
 type CreationGameTypeCard = {
   id: 'rpg' | 'airp' | 'visual-novel';
@@ -89,13 +89,17 @@ function CreationTypeCard(props: {
   );
 }
 
-export function PlatformCreationTypeModal({
+/**
+ * RPG 入口创作类型弹层真实入口。
+ * 第三批收口后入口主链不再直接依赖旧 `PlatformCreationTypeModal` 命名。
+ */
+export function RpgEntryCreationTypeModal({
   isOpen,
   isBusy,
   error,
   onClose,
   onSelectRpg,
-}: PlatformCreationTypeModalProps) {
+}: RpgEntryCreationTypeModalProps) {
   if (!isOpen) {
     return null;
   }
diff --git a/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx b/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
similarity index 71%
rename from src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx
rename to src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
index 7416cca6..3dffbd6e 100644
--- a/src/components/game-shell/PreGameSelectionFlow.agent.interaction.test.tsx
+++ b/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
@@ -8,36 +8,38 @@ import { beforeEach, expect, test, vi } from 'vitest';
 import type { CustomWorldAgentSessionSnapshot } from '../../../packages/shared/src/contracts/customWorldAgent';
 import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
 import {
-  createCustomWorldAgentSession,
-  executeCustomWorldAgentAction,
-  getCustomWorldAgentOperation,
-  getCustomWorldAgentSession,
-  listCustomWorldWorks,
-  streamCustomWorldAgentMessage,
-} from '../../services/aiService';
+  createRpgCreationSession,
+  executeRpgCreationAction,
+  getRpgCreationOperation,
+  getRpgCreationSession,
+  listRpgCreationWorks,
+  streamRpgCreationMessage,
+  upsertRpgWorldProfile,
+} from '../../services/rpg-creation';
 import type { AuthUser } from '../../services/authService';
 import {
-  clearProfileBrowseHistory,
-  deleteCustomWorldProfile,
-  getCustomWorldGalleryDetail,
-  getProfileDashboard,
-  listCustomWorldGallery,
-  listCustomWorldLibrary,
-  listProfileBrowseHistory,
-  listProfileSaveArchives,
-  resumeProfileSaveArchive,
-  upsertCustomWorldProfile,
-  upsertProfileBrowseHistory,
-} from '../../services/storageService';
+  clearRpgProfileBrowseHistory as clearProfileBrowseHistory,
+  deleteRpgEntryWorldProfile,
+  getRpgEntryWorldGalleryDetail,
+  getRpgProfileDashboard as getProfileDashboard,
+  listRpgEntryWorldGallery,
+  listRpgEntryWorldLibrary,
+  listRpgProfileBrowseHistory as listProfileBrowseHistory,
+  listRpgProfileSaveArchives as listProfileSaveArchives,
+  publishRpgEntryWorldProfile,
+  resumeRpgProfileSaveArchive as resumeProfileSaveArchive,
+  unpublishRpgEntryWorldProfile,
+  upsertRpgProfileBrowseHistory as upsertProfileBrowseHistory,
+} from '../../services/rpg-entry';
 import type { GameState } from '../../types';
 import {
   AuthUiContext,
   type PlatformSettingsSection,
 } from '../auth/AuthUiContext';
 import {
-  PreGameSelectionFlow,
+  RpgEntryFlowShell,
   type SelectionStage,
-} from './PreGameSelectionFlow';
+} from './RpgEntryFlowShell';
 
 async function clickFirstButtonByName(
   user: ReturnType<typeof userEvent.setup>,
@@ -72,31 +74,30 @@ async function openNewRpgCreation(
   await user.click(screen.getByRole('button', { name: /角色扮演 RPG/u }));
 }
 
-vi.mock('../../services/aiService', () => ({
-  createCustomWorldAgentSession: vi.fn(),
-  executeCustomWorldAgentAction: vi.fn(),
-  generateCustomWorldProfile: vi.fn(),
-  getCustomWorldAgentOperation: vi.fn(),
-  getCustomWorldAgentSession: vi.fn(),
-  listCustomWorldWorks: vi.fn(),
-  streamCustomWorldAgentMessage: vi.fn(),
+vi.mock('../../services/rpg-creation', () => ({
+  createRpgCreationSession: vi.fn(),
+  executeRpgCreationAction: vi.fn(),
+  getRpgCreationOperation: vi.fn(),
+  getRpgCreationSession: vi.fn(),
+  listRpgCreationWorks: vi.fn(),
+  streamRpgCreationMessage: vi.fn(),
+  upsertRpgWorldProfile: vi.fn(),
 }));
 
-vi.mock('../../services/storageService', () => ({
-  clearProfileBrowseHistory: vi.fn(),
-  deleteCustomWorldProfile: vi.fn(),
-  getCustomWorldGalleryDetail: vi.fn(),
-  getProfileDashboard: vi.fn(),
-  listCustomWorldGallery: vi.fn(),
-  listCustomWorldLibrary: vi.fn(),
-  listProfileBrowseHistory: vi.fn(),
-  listProfileSaveArchives: vi.fn(),
-  publishCustomWorldProfile: vi.fn(),
-  resumeProfileSaveArchive: vi.fn(),
-  syncProfileBrowseHistory: vi.fn(),
-  unpublishCustomWorldProfile: vi.fn(),
-  upsertProfileBrowseHistory: vi.fn(),
-  upsertCustomWorldProfile: vi.fn(),
+vi.mock('../../services/rpg-entry', () => ({
+  clearRpgProfileBrowseHistory: vi.fn(),
+  deleteRpgEntryWorldProfile: vi.fn(),
+  getRpgEntryWorldGalleryDetail: vi.fn(),
+  getRpgProfileDashboard: vi.fn(),
+  listRpgEntryWorldGallery: vi.fn(),
+  listRpgEntryWorldLibrary: vi.fn(),
+  listRpgProfileBrowseHistory: vi.fn(),
+  listRpgProfileSaveArchives: vi.fn(),
+  publishRpgEntryWorldProfile: vi.fn(),
+  resumeRpgProfileSaveArchive: vi.fn(),
+  syncRpgProfileBrowseHistory: vi.fn(),
+  unpublishRpgEntryWorldProfile: vi.fn(),
+  upsertRpgProfileBrowseHistory: vi.fn(),
 }));
 
 vi.mock('../custom-world-agent/CustomWorldAgentWorkspace', () => ({
@@ -312,6 +313,72 @@ const compiledAgentDraftSession: CustomWorldAgentSessionSnapshot = {
       warningCount: 0,
     },
   ],
+  resultPreview: {
+    source: 'session_preview',
+    preview: {
+      id: 'agent-draft-custom-world-agent-session-1',
+      settingText: '被海雾吞没的旧航路群岛',
+      name: '潮雾列岛',
+      subtitle: '旧灯塔与失控航路',
+      summary: '第一版世界底稿已经整理完成。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清沉船与禁航区异动的真相。',
+      templateWorldType: 'WUXIA',
+      majorFactions: ['守灯会', '航运公会'],
+      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      playableNpcs: [
+        {
+          id: 'playable-1',
+          name: '沈砺',
+          title: '旧航路引路人',
+          role: '关键同行者',
+          description: '最熟悉旧航路的人。',
+          backstory: '曾在沉船夜里带着半支船队逃出海雾。',
+          personality: '表面沉稳，心里一直在算退路。',
+          motivation: '想赶在守灯会封航前查清真相。',
+          combatStyle: '借地形和潮路换位，先拉扯再压近。',
+          initialAffinity: 18,
+          relationshipHooks: ['旧友', '沉船旧案'],
+          tags: ['潮路', '引路'],
+        },
+      ],
+      storyNpcs: [
+        {
+          id: 'story-1',
+          name: '顾潮音',
+          title: '守灯会值夜人',
+          role: '场景关键角色',
+          description: '夜里巡灯与封锁禁航区的人。',
+          backstory: '在失控海雾第一次吞船那夜，她是最后一个还留在灯塔顶的人。',
+          personality: '冷静克制，但提到旧灯册时会显得过分警觉。',
+          motivation: '想守住灯塔记录，也想找到谁先改动了禁航信号。',
+          combatStyle: '借塔顶视角和风向压制，再用灯火错位扰乱。',
+          initialAffinity: 8,
+          relationshipHooks: ['禁航记录', '灯塔值夜'],
+          tags: ['守灯会', '灯塔'],
+        },
+      ],
+      items: [],
+      landmarks: [
+        {
+          id: 'landmark-1',
+          name: '回潮旧灯塔',
+          description: '旧灯塔是整片群岛最先看见异动的地方。',
+          dangerLevel: 'high',
+          sceneNpcIds: ['story-1'],
+          connections: [],
+        },
+      ],
+      generationMode: 'full',
+      generationStatus: 'complete',
+      sessionId: 'custom-world-agent-session-1',
+    },
+    generatedAt: '2026-04-14T12:00:00.000Z',
+    qualityFindings: [],
+    blockers: [],
+    publishReady: true,
+    canEnterWorld: false,
+  },
 };
 
 type TestAuthValue = {
@@ -362,7 +429,7 @@ function TestWrapper({
     useState<SelectionStage>('platform');
 
   const content = (
-    <PreGameSelectionFlow
+    <RpgEntryFlowShell
       selectionStage={selectionStage}
       setSelectionStage={setSelectionStage}
       gameState={{} as GameState}
@@ -398,8 +465,8 @@ beforeEach(() => {
     playedWorldCount: 0,
     updatedAt: '2026-04-16T12:00:00.000Z',
   });
-  vi.mocked(listCustomWorldLibrary).mockResolvedValue([]);
-  vi.mocked(listCustomWorldGallery).mockResolvedValue([]);
+  vi.mocked(listRpgEntryWorldLibrary).mockResolvedValue([]);
+  vi.mocked(listRpgEntryWorldGallery).mockResolvedValue([]);
   vi.mocked(listProfileBrowseHistory).mockResolvedValue([]);
   vi.mocked(listProfileSaveArchives).mockResolvedValue([]);
   vi.mocked(resumeProfileSaveArchive).mockResolvedValue({
@@ -424,8 +491,8 @@ beforeEach(() => {
   });
   vi.mocked(upsertProfileBrowseHistory).mockResolvedValue([]);
   vi.mocked(clearProfileBrowseHistory).mockResolvedValue([]);
-  vi.mocked(deleteCustomWorldProfile).mockResolvedValue([]);
-  vi.mocked(upsertCustomWorldProfile).mockResolvedValue({
+  vi.mocked(deleteRpgEntryWorldProfile).mockResolvedValue([]);
+  vi.mocked(upsertRpgWorldProfile).mockResolvedValue({
     entry: {
       ownerUserId: 'user-1',
       profileId: 'agent-draft-custom-world-agent-session-1',
@@ -447,11 +514,11 @@ beforeEach(() => {
     },
     entries: [],
   });
-  vi.mocked(createCustomWorldAgentSession).mockResolvedValue({
+  vi.mocked(createRpgCreationSession).mockResolvedValue({
     session: mockSession,
   });
-  vi.mocked(listCustomWorldWorks).mockResolvedValue([]);
-  vi.mocked(executeCustomWorldAgentAction).mockResolvedValue({
+  vi.mocked(listRpgCreationWorks).mockResolvedValue([]);
+  vi.mocked(executeRpgCreationAction).mockResolvedValue({
     operation: {
       operationId: 'operation-draft-foundation-1',
       type: 'draft_foundation',
@@ -462,7 +529,7 @@ beforeEach(() => {
       error: null,
     },
   });
-  vi.mocked(getCustomWorldAgentOperation).mockResolvedValue({
+  vi.mocked(getRpgCreationOperation).mockResolvedValue({
     operationId: 'operation-draft-foundation-1',
     type: 'draft_foundation',
     status: 'running',
@@ -471,8 +538,8 @@ beforeEach(() => {
     progress: 38,
     error: null,
   });
-  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(mockSession);
-  vi.mocked(streamCustomWorldAgentMessage).mockResolvedValue(mockSession);
+  vi.mocked(getRpgCreationSession).mockResolvedValue(mockSession);
+  vi.mocked(streamRpgCreationMessage).mockResolvedValue(mockSession);
 });
 
 test('create tab opens game type modal, keeps AIRP and visual novel locked, and enters agent workspace for RPG', async () => {
@@ -499,7 +566,7 @@ test('create tab opens game type modal, keeps AIRP and visual novel locked, and
   await user.click(screen.getByRole('button', { name: /角色扮演 RPG/u }));
 
   await waitFor(() => {
-    expect(createCustomWorldAgentSession).toHaveBeenCalledTimes(1);
+    expect(createRpgCreationSession).toHaveBeenCalledTimes(1);
   });
 
   expect(
@@ -510,7 +577,7 @@ test('create tab opens game type modal, keeps AIRP and visual novel locked, and
 test('create tab opens compiled agent draft in result refinement page', async () => {
   const user = userEvent.setup();
 
-  vi.mocked(listCustomWorldWorks).mockResolvedValue([
+  vi.mocked(listRpgCreationWorks).mockResolvedValue([
     {
       workId: 'draft:custom-world-agent-session-1',
       sourceType: 'agent_session',
@@ -536,7 +603,7 @@ test('create tab opens compiled agent draft in result refinement page', async ()
       canEnterWorld: false,
     },
   ]);
-  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(
+  vi.mocked(getRpgCreationSession).mockResolvedValue(
     compiledAgentDraftSession,
   );
 
@@ -561,7 +628,7 @@ test('create tab opens compiled agent draft in result refinement page', async ()
 test('create tab resumes agent workspace when draft has no compiled result yet', async () => {
   const user = userEvent.setup();
 
-  vi.mocked(listCustomWorldWorks).mockResolvedValue([
+  vi.mocked(listRpgCreationWorks).mockResolvedValue([
     {
       workId: 'draft:custom-world-agent-session-1',
       sourceType: 'agent_session',
@@ -606,7 +673,7 @@ test('clicking a public work while logged out routes through requireAuth', async
   const user = userEvent.setup();
   const requireAuth = vi.fn();
 
-  vi.mocked(listCustomWorldGallery).mockResolvedValue([
+  vi.mocked(listRpgEntryWorldGallery).mockResolvedValue([
     {
       ownerUserId: 'author-1',
       profileId: 'world-public-1',
@@ -640,7 +707,7 @@ test('clicking a public work while logged out routes through requireAuth', async
   await user.click(workCards[0]!);
 
   expect(requireAuth).toHaveBeenCalledTimes(1);
-  expect(getCustomWorldGalleryDetail).not.toHaveBeenCalled();
+  expect(getRpgEntryWorldGalleryDetail).not.toHaveBeenCalled();
 });
 
 test('selecting RPG creation while logged out routes through requireAuth', async () => {
@@ -659,7 +726,7 @@ test('selecting RPG creation while logged out routes through requireAuth', async
 
   await openNewRpgCreation(user);
   expect(requireAuth).toHaveBeenCalledTimes(1);
-  expect(createCustomWorldAgentSession).not.toHaveBeenCalled();
+  expect(createRpgCreationSession).not.toHaveBeenCalled();
 });
 
 test('restoring an agent workspace while logged out opens login modal before loading the protected session', async () => {
@@ -686,7 +753,7 @@ test('restoring an agent workspace while logged out opens login modal before loa
   });
 
   expect(openLoginModal).toHaveBeenCalledWith(expect.any(Function));
-  expect(getCustomWorldAgentSession).not.toHaveBeenCalled();
+  expect(getRpgCreationSession).not.toHaveBeenCalled();
 });
 
 test('starting draft generation leaves the agent workspace and shows the generation progress view', async () => {
@@ -703,7 +770,7 @@ test('starting draft generation leaves the agent workspace and shows the generat
   await user.click(screen.getByRole('button', { name: '开始生成草稿' }));
 
   await waitFor(() => {
-    expect(executeCustomWorldAgentAction).toHaveBeenCalledWith(
+    expect(executeRpgCreationAction).toHaveBeenCalledWith(
       'custom-world-agent-session-1',
       {
         action: 'draft_foundation',
@@ -724,7 +791,7 @@ test('starting draft generation leaves the agent workspace and shows the generat
 test('existing draft sessions open result page refinement instead of agent dialog', async () => {
   const user = userEvent.setup();
 
-  vi.mocked(getCustomWorldAgentOperation).mockResolvedValue({
+  vi.mocked(getRpgCreationOperation).mockResolvedValue({
     operationId: 'operation-draft-foundation-1',
     type: 'draft_foundation',
     status: 'completed',
@@ -733,7 +800,7 @@ test('existing draft sessions open result page refinement instead of agent dialo
     progress: 100,
     error: null,
   });
-  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(
+  vi.mocked(getRpgCreationSession).mockResolvedValue(
     compiledAgentDraftSession,
   );
 
@@ -745,7 +812,9 @@ test('existing draft sessions open result page refinement instead of agent dialo
     async () => {
       expect(await screen.findByText('世界档案')).toBeTruthy();
       expect(screen.getByText('已自动保存')).toBeTruthy();
-      expect(screen.getByRole('button', { name: /进入世界/u })).toBeTruthy();
+      expect(
+        screen.getByRole('button', { name: /发布并进入世界/u }),
+      ).toBeTruthy();
     },
     { timeout: 2500 },
   );
@@ -762,10 +831,167 @@ test('existing draft sessions open result page refinement instead of agent dialo
   expect(screen.getByRole('button', { name: /AI生成/u })).toBeTruthy();
 });
 
+test('agent result view shows publish blockers and disables publish-enter action when preview gate is not ready', async () => {
+  const user = userEvent.setup();
+
+  vi.mocked(getRpgCreationOperation).mockResolvedValue({
+    operationId: 'operation-draft-foundation-1',
+    type: 'draft_foundation',
+    status: 'completed',
+    phaseLabel: '世界底稿已生成',
+    phaseDetail: '第一版世界底稿和 4 张草稿卡已经整理完成。',
+    progress: 100,
+    error: null,
+  });
+  vi.mocked(getRpgCreationSession).mockResolvedValue({
+    ...compiledAgentDraftSession,
+    resultPreview: {
+      ...compiledAgentDraftSession.resultPreview!,
+      publishReady: false,
+      blockers: [
+        {
+          id: 'publish-role-assets-incomplete',
+          code: 'publish_role_assets_incomplete',
+          message: '仍有角色缺少正式主图或动作资产，发布前需要先补齐。',
+        },
+      ],
+    },
+  });
+
+  render(<TestWrapper withAuth />);
+
+  await openNewRpgCreation(user);
+
+  expect(
+    await screen.findByText(/当前还有 1 个发布阻断项/u),
+  ).toBeTruthy();
+  const actionButton = screen.getByRole('button', {
+    name: /发布并进入世界/u,
+  });
+  expect((actionButton as HTMLButtonElement).disabled).toBe(true);
+});
+
+test('agent draft result publishes before entering world and uses published preview profile', async () => {
+  const user = userEvent.setup();
+  const handleCustomWorldSelect = vi.fn();
+
+  const publishReadyDraftSession = {
+    ...compiledAgentDraftSession,
+    stage: 'ready_to_publish' as const,
+    resultPreview: {
+      ...compiledAgentDraftSession.resultPreview!,
+      publishReady: true,
+      canEnterWorld: false,
+      blockers: [],
+    },
+  } satisfies CustomWorldAgentSessionSnapshot;
+
+  const publishedSession = {
+    ...publishReadyDraftSession,
+    stage: 'published' as const,
+    resultPreview: {
+      ...publishReadyDraftSession.resultPreview!,
+      publishReady: true,
+      canEnterWorld: true,
+      blockers: [],
+      preview: {
+        ...publishReadyDraftSession.resultPreview!.preview,
+        id: 'agent-draft-custom-world-agent-session-1',
+        name: '潮雾列岛·已发布',
+        summary: '发布完成后应直接使用已发布预览进入世界。',
+      },
+    },
+  } satisfies CustomWorldAgentSessionSnapshot;
+
+  let hasPublishedWorld = false;
+  vi.mocked(getRpgCreationOperation).mockResolvedValueOnce({
+    operationId: 'operation-publish-world-1',
+    type: 'publish_world',
+    status: 'completed',
+    phaseLabel: '世界已发布',
+    phaseDetail: '正式世界档案已写入作品库。',
+    progress: 100,
+    error: null,
+  });
+  vi.mocked(executeRpgCreationAction).mockImplementation(async (_, payload) => {
+    if (payload.action === 'publish_world') {
+      hasPublishedWorld = true;
+    }
+
+    return {
+      operation: {
+        operationId: 'operation-publish-world-1',
+        type: 'publish_world',
+        status: 'queued',
+        phaseLabel: '执行发布校验',
+        phaseDetail: '正在检查角色资产、场景图和主线草稿是否满足发布门槛。',
+        progress: 28,
+        error: null,
+      },
+    };
+  });
+  vi.mocked(getRpgCreationSession).mockImplementation(async () =>
+    hasPublishedWorld ? publishedSession : publishReadyDraftSession,
+  );
+
+  function PublishFlowWrapper() {
+    const [selectionStage, setSelectionStage] =
+      useState<SelectionStage>('platform');
+
+    return (
+      <AuthUiContext.Provider value={createAuthValue()}>
+    <RpgEntryFlowShell
+          selectionStage={selectionStage}
+          setSelectionStage={setSelectionStage}
+          gameState={{} as GameState}
+          hasSavedGame={false}
+          savedSnapshot={null}
+          handleContinueGame={() => {}}
+          handleStartNewGame={() => {}}
+          handleCustomWorldSelect={handleCustomWorldSelect}
+        />
+      </AuthUiContext.Provider>
+    );
+  }
+
+  render(<PublishFlowWrapper />);
+
+  await openNewRpgCreation(user);
+
+  const actionButton = await screen.findByRole('button', {
+    name: /发布并进入世界/u,
+  });
+  await user.click(actionButton);
+
+  await waitFor(() => {
+    expect(executeRpgCreationAction).toHaveBeenCalledWith(
+      'custom-world-agent-session-1',
+      expect.objectContaining({
+        action: 'publish_world',
+      }),
+    );
+  });
+  expect(
+    vi.mocked(executeRpgCreationAction).mock.calls.some(
+      ([sessionId, payload]) =>
+        sessionId === 'custom-world-agent-session-1' &&
+        payload?.action === 'sync_result_profile',
+    ),
+  ).toBe(false);
+  await waitFor(() => {
+    expect(handleCustomWorldSelect).toHaveBeenCalledWith(
+      expect.objectContaining({
+        name: '潮雾列岛·已发布',
+        summary: '发布完成后应直接使用已发布预览进入世界。',
+      }),
+    );
+  });
+});
+
 test('agent draft result back button returns to creation hub without redundant sync when session is already latest', async () => {
   const user = userEvent.setup();
 
-  vi.mocked(executeCustomWorldAgentAction).mockResolvedValue({
+  vi.mocked(executeRpgCreationAction).mockResolvedValue({
     operation: {
       operationId: 'operation-sync-result-profile-1',
       type: 'sync_result_profile',
@@ -776,7 +1002,7 @@ test('agent draft result back button returns to creation hub without redundant s
       error: null,
     },
   });
-  vi.mocked(getCustomWorldAgentOperation).mockResolvedValue({
+  vi.mocked(getRpgCreationOperation).mockResolvedValue({
     operationId: 'operation-sync-result-profile-1',
     type: 'sync_result_profile',
     status: 'completed',
@@ -893,8 +1119,35 @@ test('agent draft result back button returns to creation hub without redundant s
         warningCount: 0,
       },
     ],
+    resultPreview: {
+      source: 'session_preview' as const,
+      preview: {
+        id: 'agent-draft-custom-world-agent-session-1',
+        settingText: '被海雾吞没的旧航路群岛',
+        name: '潮雾列岛·同步后',
+        subtitle: '旧灯塔与失控航路',
+        summary: '同步后的结果页快照已经回写到 session。',
+        tone: '压抑、潮湿、悬疑',
+        playerGoal: '查清沉船与禁航区异动的真相。',
+        templateWorldType: 'WUXIA',
+        majorFactions: ['守灯会', '航运公会'],
+        coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+        playableNpcs: [],
+        storyNpcs: [],
+        items: [],
+        landmarks: [],
+        generationMode: 'full',
+        generationStatus: 'complete',
+        sessionId: 'custom-world-agent-session-1',
+      },
+      generatedAt: '2026-04-20T12:00:00.000Z',
+      qualityFindings: [],
+      blockers: [],
+      publishReady: false,
+      canEnterWorld: false,
+    },
   } satisfies CustomWorldAgentSessionSnapshot;
-  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(resultSession);
+  vi.mocked(getRpgCreationSession).mockResolvedValue(resultSession);
 
   render(<TestWrapper withAuth />);
 
@@ -915,7 +1168,7 @@ test('agent draft result back button returns to creation hub without redundant s
   });
 
   expect(
-    vi.mocked(executeCustomWorldAgentAction).mock.calls.some(
+    vi.mocked(executeRpgCreationAction).mock.calls.some(
       ([sessionId, payload]) =>
         sessionId === 'custom-world-agent-session-1' &&
         payload?.action === 'sync_result_profile',
@@ -927,7 +1180,7 @@ test('agent draft result back button returns to creation hub without redundant s
 test('agent draft result auto-save persists the latest profile rebuilt from synced session', async () => {
   const user = userEvent.setup();
 
-  vi.mocked(executeCustomWorldAgentAction).mockResolvedValue({
+  vi.mocked(executeRpgCreationAction).mockResolvedValue({
     operation: {
       operationId: 'operation-sync-result-profile-2',
       type: 'sync_result_profile',
@@ -938,7 +1191,7 @@ test('agent draft result auto-save persists the latest profile rebuilt from sync
       error: null,
     },
   });
-  vi.mocked(getCustomWorldAgentOperation).mockResolvedValue({
+  vi.mocked(getRpgCreationOperation).mockResolvedValue({
     operationId: 'operation-sync-result-profile-2',
     type: 'sync_result_profile',
     status: 'completed',
@@ -1016,8 +1269,35 @@ test('agent draft result auto-save persists the latest profile rebuilt from sync
         warningCount: 0,
       },
     ],
+    resultPreview: {
+      source: 'session_preview' as const,
+      preview: {
+        id: 'agent-draft-custom-world-agent-session-1',
+        settingText: '被海雾吞没的旧航路群岛',
+        name: '潮雾列岛·session最新版',
+        subtitle: '旧灯塔与失控航路',
+        summary: '作品库应该保存这份同步后的最新快照。',
+        tone: '压抑、潮湿、悬疑',
+        playerGoal: '查清沉船与禁航区异动的真相。',
+        templateWorldType: 'WUXIA',
+        majorFactions: ['守灯会', '航运公会'],
+        coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+        playableNpcs: [],
+        storyNpcs: [],
+        items: [],
+        landmarks: [],
+        generationMode: 'full',
+        generationStatus: 'complete',
+        sessionId: 'custom-world-agent-session-1',
+      },
+      generatedAt: '2026-04-20T12:00:00.000Z',
+      qualityFindings: [],
+      blockers: [],
+      publishReady: false,
+      canEnterWorld: false,
+    },
   } satisfies CustomWorldAgentSessionSnapshot;
-  vi.mocked(getCustomWorldAgentSession).mockResolvedValue(syncedSession);
+  vi.mocked(getRpgCreationSession).mockResolvedValue(syncedSession);
 
   render(<TestWrapper withAuth />);
 
@@ -1032,16 +1312,74 @@ test('agent draft result auto-save persists the latest profile rebuilt from sync
   );
 
   await waitFor(() => {
-    expect(upsertCustomWorldProfile).toHaveBeenCalled();
+    expect(upsertRpgWorldProfile).toHaveBeenCalled();
   });
 
-  const latestSavedProfile = vi.mocked(upsertCustomWorldProfile).mock.calls.at(-1)?.[0];
+  const latestSavedProfile = vi.mocked(upsertRpgWorldProfile).mock.calls.at(-1)?.[0];
   expect(latestSavedProfile?.name).toBe('潮雾列岛·session最新版');
   expect(latestSavedProfile?.summary).toBe(
     '作品库应该保存这份同步后的最新快照。',
   );
 });
 
+test('agent draft result can open from server result preview without embedded legacyResultProfile', async () => {
+  const user = userEvent.setup();
+
+  const previewOnlySession = {
+    ...compiledAgentDraftSession,
+    draftProfile: {
+      ...compiledAgentDraftSession.draftProfile,
+      playableNpcs: [],
+      storyNpcs: [],
+      landmarks: [],
+    },
+    resultPreview: {
+      source: 'session_preview' as const,
+      preview: {
+        id: 'agent-draft-custom-world-agent-session-1',
+        settingText: '被海雾吞没的旧航路群岛',
+        name: '潮雾列岛·服务端预览',
+        subtitle: '结果页改为优先消费 session.resultPreview',
+        summary: '即使 draft 中没有 legacyResultProfile，也应该正常打开结果页。',
+        tone: '压抑、潮湿、悬疑',
+        playerGoal: '查清沉船与禁航区异动的真相。',
+        templateWorldType: 'WUXIA',
+        majorFactions: ['守灯会', '航运公会'],
+        coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+        playableNpcs: [],
+        storyNpcs: [],
+        items: [],
+        landmarks: [],
+        generationMode: 'full',
+        generationStatus: 'complete',
+        sessionId: 'custom-world-agent-session-1',
+      },
+      generatedAt: '2026-04-20T12:00:00.000Z',
+      qualityFindings: [],
+      blockers: [],
+    },
+  } satisfies CustomWorldAgentSessionSnapshot;
+
+  vi.mocked(getRpgCreationSession).mockResolvedValue(previewOnlySession);
+
+  render(<TestWrapper withAuth />);
+
+  await openNewRpgCreation(user);
+
+  await waitFor(
+    async () => {
+      expect(await screen.findByText('世界档案')).toBeTruthy();
+      expect(
+        screen.getByText('潮雾列岛·服务端预览'),
+      ).toBeTruthy();
+      expect(
+        screen.getByText('结果页改为优先消费 session.resultPreview'),
+      ).toBeTruthy();
+    },
+    { timeout: 2500 },
+  );
+});
+
 test('authenticated users with save archives default into the saves tab', async () => {
   vi.mocked(listProfileSaveArchives).mockResolvedValue([
     {
@@ -1172,13 +1510,13 @@ test('owned world detail can delete a work and return to the create tab list', a
     landmarkCount: 0,
   };
 
-  vi.mocked(listCustomWorldWorks)
+  vi.mocked(listRpgCreationWorks)
     .mockResolvedValueOnce([publishedWork])
     .mockResolvedValue([]);
-  vi.mocked(listCustomWorldLibrary)
+  vi.mocked(listRpgEntryWorldLibrary)
     .mockResolvedValueOnce([publishedLibraryEntry])
     .mockResolvedValue([]);
-  vi.mocked(deleteCustomWorldProfile).mockResolvedValue([]);
+  vi.mocked(deleteRpgEntryWorldProfile).mockResolvedValue([]);
 
   render(<TestWrapper withAuth />);
 
@@ -1187,7 +1525,7 @@ test('owned world detail can delete a work and return to the create tab list', a
   await user.click(await screen.findByRole('button', { name: '删除作品' }));
 
   await waitFor(() => {
-    expect(deleteCustomWorldProfile).toHaveBeenCalledWith('world-delete-1');
+    expect(deleteRpgEntryWorldProfile).toHaveBeenCalledWith('world-delete-1');
   });
 
   await waitFor(() => {
@@ -1201,7 +1539,7 @@ test('owned world detail can delete a work and return to the create tab list', a
 test('creation hub published work enters existing detail view', async () => {
   const user = userEvent.setup();
 
-  vi.mocked(listCustomWorldWorks).mockResolvedValue([
+  vi.mocked(listRpgCreationWorks).mockResolvedValue([
     {
       workId: 'published:world-public-1',
       sourceType: 'published_profile',
@@ -1227,7 +1565,7 @@ test('creation hub published work enters existing detail view', async () => {
       canEnterWorld: true,
     },
   ]);
-  vi.mocked(listCustomWorldLibrary).mockResolvedValue([
+  vi.mocked(listRpgEntryWorldLibrary).mockResolvedValue([
     {
       ownerUserId: 'user-1',
       profileId: 'world-public-1',
diff --git a/src/components/rpg-entry/RpgEntryFlowShell.tsx b/src/components/rpg-entry/RpgEntryFlowShell.tsx
new file mode 100644
index 00000000..82c98667
--- /dev/null
+++ b/src/components/rpg-entry/RpgEntryFlowShell.tsx
@@ -0,0 +1,20 @@
+import { RpgEntryFlowShellImpl } from './RpgEntryFlowShellImpl';
+import type { RpgEntryFlowShellProps } from './rpgEntryTypes';
+import type { SelectionStage } from './rpgEntryTypes';
+
+export type { RpgEntryFlowShellProps, SelectionStage };
+
+/**
+ * RPG 入口域真实壳层入口。
+ * 入口主链已收口到 `rpg-entry` 命名根，不再保留旧入口脚本。
+ */
+export function RpgEntryFlowShell(props: RpgEntryFlowShellProps) {
+  return <RpgEntryFlowShellImpl {...props} />;
+}
+
+/**
+ * 兼容创作链已经接入的旧组件命名，避免本轮迁移扩大影响面。
+ */
+export const RpgCreationShell = RpgEntryFlowShell;
+
+export default RpgEntryFlowShell;
diff --git a/src/components/rpg-entry/RpgEntryFlowShellImpl.tsx b/src/components/rpg-entry/RpgEntryFlowShellImpl.tsx
new file mode 100644
index 00000000..5b93f168
--- /dev/null
+++ b/src/components/rpg-entry/RpgEntryFlowShellImpl.tsx
@@ -0,0 +1,718 @@
+import { AnimatePresence, motion } from 'motion/react';
+import { lazy, Suspense, useCallback, useEffect, useMemo, useState } from 'react';
+
+import type { CustomWorldLibraryEntry } from '../../../packages/shared/src/contracts/runtime';
+import { buildCustomWorldPlayableCharacters } from '../../data/characterPresets';
+import { readCustomWorldAgentUiState } from '../../services/customWorldAgentUiState';
+import { getRpgProfileDashboard } from '../../services/rpg-entry';
+import { rpgCreationPreviewAdapter } from '../../services/rpg-creation/rpgCreationPreviewAdapter';
+import type { CustomWorldProfile } from '../../types';
+import { useAuthUi } from '../auth/AuthUiContext';
+import { CustomWorldCreationHub } from '../custom-world-home/CustomWorldCreationHub';
+import { RpgEntryCreationTypeModal } from './RpgEntryCreationTypeModal';
+import { RpgEntryHomeView } from './RpgEntryHomeView';
+import {
+  buildCreationHubFallbackItems,
+  normalizeAgentBackedProfile,
+  resolveRpgCreationErrorMessage,
+} from './rpgEntryShared';
+import type { RpgEntryFlowShellProps } from './rpgEntryTypes';
+import { RpgEntryWorldDetailView } from './RpgEntryWorldDetailView';
+import { useRpgCreationAgentOperationPolling } from './useRpgCreationAgentOperationPolling';
+import { useRpgCreationEnterWorld } from './useRpgCreationEnterWorld';
+import { useRpgCreationResultAutosave } from './useRpgCreationResultAutosave';
+import { useRpgCreationSessionController } from './useRpgCreationSessionController';
+import { useRpgEntryBootstrap } from './useRpgEntryBootstrap';
+import { useRpgEntryLibraryDetail } from './useRpgEntryLibraryDetail';
+import { useRpgEntryNavigation } from './useRpgEntryNavigation';
+
+const CustomWorldGenerationView = lazy(async () => {
+  const module = await import('../CustomWorldGenerationView');
+  return {
+    default: module.CustomWorldGenerationView,
+  };
+});
+
+const RpgCreationResultView = lazy(async () => {
+  const module = await import('../rpg-creation-result/RpgCreationResultView');
+  return {
+    default: module.RpgCreationResultView,
+  };
+});
+
+const CustomWorldAgentWorkspace = lazy(async () => {
+  const module = await import(
+    '../custom-world-agent/CustomWorldAgentWorkspace'
+  );
+  return {
+    default: module.CustomWorldAgentWorkspace,
+  };
+});
+
+function LazyPanelFallback({ label }: { label: string }) {
+  return (
+    <div className="flex h-full min-h-0 items-center justify-center">
+      <div className="platform-subpanel rounded-2xl px-5 py-4 text-sm text-[var(--platform-text-base)]">
+        {label}
+      </div>
+    </div>
+  );
+}
+
+export function RpgEntryFlowShellImpl({
+  selectionStage,
+  setSelectionStage,
+  hasSavedGame,
+  savedSnapshot,
+  handleContinueGame,
+  handleStartNewGame,
+  handleCustomWorldSelect,
+}: RpgEntryFlowShellProps) {
+  const authUi = useAuthUi();
+  const [showCreationTypeModal, setShowCreationTypeModal] = useState(false);
+  const [selectedDetailEntry, setSelectedDetailEntry] = useState<
+    CustomWorldLibraryEntry<CustomWorldProfile> | null
+  >(null);
+  const hasInitialAgentSession = Boolean(
+    readCustomWorldAgentUiState().activeSessionId,
+  );
+
+  const platformBootstrap = useRpgEntryBootstrap({
+    user: authUi?.user,
+    getProfileDashboard: getRpgProfileDashboard,
+    handleContinueGame,
+    hasInitialAgentSession,
+  });
+  const entryNavigation = useRpgEntryNavigation({
+    setSelectionStage,
+    setSelectedDetailEntry,
+  });
+
+  const enterCreateTab = useCallback(() => {
+    platformBootstrap.setPlatformTab('create');
+  }, [platformBootstrap]);
+
+  const sessionController = useRpgCreationSessionController({
+    userId: authUi?.user?.id,
+    openLoginModal: authUi?.openLoginModal,
+    selectionStage,
+    setSelectionStage,
+    enterCreateTab,
+    onSessionOpened: () => {
+      setShowCreationTypeModal(false);
+    },
+  });
+
+  useRpgCreationAgentOperationPolling({
+    activeAgentSessionId: sessionController.activeAgentSessionId,
+    activeAgentOperationId: sessionController.activeAgentOperationId,
+    userId: authUi?.user?.id,
+    setAgentOperation: sessionController.setAgentOperation,
+    persistAgentUiState: sessionController.persistAgentUiState,
+    syncAgentSessionSnapshot: sessionController.syncAgentSessionSnapshot,
+  });
+
+  const autosaveCoordinator = useRpgCreationResultAutosave({
+    selectionStage,
+    activeAgentSessionId: sessionController.activeAgentSessionId,
+    agentSession: sessionController.agentSession,
+    generatedCustomWorldProfile: sessionController.generatedCustomWorldProfile,
+    isAgentDraftResultView: sessionController.isAgentDraftResultView,
+    userId: authUi?.user?.id,
+    setGeneratedCustomWorldProfile:
+      sessionController.setGeneratedCustomWorldProfile,
+    setAgentOperation: sessionController.setAgentOperation,
+    setSavedCustomWorldEntries: platformBootstrap.setSavedCustomWorldEntries,
+    setSelectedDetailEntry,
+    refreshCustomWorldWorks: platformBootstrap.refreshCustomWorldWorks,
+    persistAgentUiState: sessionController.persistAgentUiState,
+    syncAgentSessionSnapshot: sessionController.syncAgentSessionSnapshot,
+    buildDraftResultProfile: (session) =>
+      rpgCreationPreviewAdapter.buildPreviewFromSession(session),
+  });
+
+  const detailNavigation = useRpgEntryLibraryDetail({
+    userId: authUi?.user?.id,
+    selectedDetailEntry,
+    setSelectedDetailEntry,
+    savedCustomWorldEntries: platformBootstrap.savedCustomWorldEntries,
+    setSavedCustomWorldEntries: platformBootstrap.setSavedCustomWorldEntries,
+    setGeneratedCustomWorldProfile:
+      sessionController.setGeneratedCustomWorldProfile,
+    setCustomWorldError: sessionController.setCustomWorldError,
+    setCustomWorldAutoSaveError: autosaveCoordinator.setCustomWorldAutoSaveError,
+    setCustomWorldAutoSaveState: autosaveCoordinator.setCustomWorldAutoSaveState,
+    setCustomWorldGenerationViewSource:
+      sessionController.setCustomWorldGenerationViewSource,
+    setCustomWorldResultViewSource:
+      sessionController.setCustomWorldResultViewSource,
+    setSelectionStage,
+    setPlatformTabToCreate: enterCreateTab,
+    setPlatformError: platformBootstrap.setPlatformError,
+    appendBrowseHistoryEntry: platformBootstrap.appendBrowseHistoryEntry,
+    refreshCustomWorldWorks: platformBootstrap.refreshCustomWorldWorks,
+    refreshPublishedGallery: platformBootstrap.refreshPublishedGallery,
+    persistAgentUiState: sessionController.persistAgentUiState,
+    syncAgentSessionSnapshot: sessionController.syncAgentSessionSnapshot,
+    buildDraftResultProfile: (session) =>
+      rpgCreationPreviewAdapter.buildPreviewFromSession(session),
+    suppressAgentDraftResultAutoOpen:
+      sessionController.suppressAgentDraftResultAutoOpen,
+    releaseAgentDraftResultAutoOpenSuppression:
+      sessionController.releaseAgentDraftResultAutoOpenSuppression,
+    resetAutoSaveTrackingToIdle: autosaveCoordinator.resetAutoSaveTrackingToIdle,
+    markAutoSavedProfile: autosaveCoordinator.markAutoSavedProfile,
+  });
+
+  const enterWorldCoordinator = useRpgCreationEnterWorld({
+    isAgentDraftResultView: sessionController.isAgentDraftResultView,
+    activeAgentSessionId: sessionController.activeAgentSessionId,
+    generatedCustomWorldProfile: sessionController.generatedCustomWorldProfile,
+    agentSessionProfile: sessionController.agentDraftResultProfile,
+    agentSession: sessionController.agentSession,
+    handleCustomWorldSelect,
+    executePublishWorld: () =>
+      autosaveCoordinator.executeAgentActionAndWait({
+        action: 'publish_world',
+      }),
+    syncAgentDraftResultProfile: autosaveCoordinator.syncAgentDraftResultProfile,
+    setGeneratedCustomWorldProfile:
+      sessionController.setGeneratedCustomWorldProfile,
+  });
+
+  const previewCustomWorldCharacters = useMemo(
+    () =>
+      sessionController.generatedCustomWorldProfile
+        ? buildCustomWorldPlayableCharacters(
+            sessionController.generatedCustomWorldProfile,
+          )
+        : [],
+    [sessionController.generatedCustomWorldProfile],
+  );
+  const agentResultPreview = sessionController.agentSession?.resultPreview ?? null;
+  const agentResultPreviewBlockers = useMemo(
+    () => agentResultPreview?.blockers?.map((entry) => entry.message) ?? [],
+    [agentResultPreview],
+  );
+  const agentResultPreviewQualityFindings = useMemo(
+    () => agentResultPreview?.qualityFindings ?? [],
+    [agentResultPreview],
+  );
+  const agentResultPreviewSourceLabel = useMemo(() => {
+    if (!agentResultPreview?.source) {
+      return null;
+    }
+    if (agentResultPreview.source === 'published_profile') {
+      return '已发布世界';
+    }
+    if (agentResultPreview.source === 'session_preview') {
+      return '会话预览';
+    }
+    return '服务端预览';
+  }, [agentResultPreview]);
+
+  const featuredGalleryEntries = useMemo(
+    () => platformBootstrap.publishedGalleryEntries.slice(0, 6),
+    [platformBootstrap.publishedGalleryEntries],
+  );
+
+  const creationHubItems =
+    platformBootstrap.customWorldWorkEntries.length > 0
+      ? platformBootstrap.customWorldWorkEntries
+      : buildCreationHubFallbackItems(platformBootstrap.savedCustomWorldEntries);
+  const resultViewError =
+    autosaveCoordinator.customWorldAutoSaveError ??
+    sessionController.customWorldError;
+
+  useEffect(() => {
+    if (
+      selectionStage === 'custom-world-result' &&
+      !sessionController.generatedCustomWorldProfile
+    ) {
+      setSelectionStage(selectedDetailEntry ? 'detail' : 'platform');
+    }
+  }, [
+    selectedDetailEntry,
+    selectionStage,
+    sessionController.generatedCustomWorldProfile,
+    setSelectionStage,
+  ]);
+
+  const runProtectedAction = useCallback(
+    (action: () => void) => {
+      if (!authUi?.requireAuth) {
+        action();
+        return;
+      }
+
+      authUi.requireAuth(action);
+    },
+    [authUi],
+  );
+
+  const openCreationTypePicker = useCallback(() => {
+    if (sessionController.isCreatingAgentSession) {
+      return;
+    }
+
+    if (!hasSavedGame) {
+      handleStartNewGame();
+    }
+
+    sessionController.setCreationTypeError(null);
+    setShowCreationTypeModal(true);
+  }, [
+    handleStartNewGame,
+    hasSavedGame,
+    sessionController,
+  ]);
+
+  const leaveAgentWorkspace = useCallback(() => {
+    enterCreateTab();
+    sessionController.resetSessionViewState();
+    sessionController.setGeneratedCustomWorldProfile(null);
+    autosaveCoordinator.resetAutoSaveTrackingToIdle();
+    sessionController.persistAgentUiState(
+      sessionController.activeAgentSessionId,
+      null,
+    );
+    setSelectionStage('platform');
+  }, [
+    autosaveCoordinator,
+    enterCreateTab,
+    sessionController,
+    setSelectionStage,
+  ]);
+
+  const leaveAgentDraftGeneration = useCallback(() => {
+    if (sessionController.isActiveGenerationRunning) {
+      return;
+    }
+
+    sessionController.setAgentDraftGenerationStartedAt(null);
+    sessionController.setCustomWorldGenerationViewSource(null);
+    setSelectionStage('agent-workspace');
+  }, [sessionController, setSelectionStage]);
+
+  const leaveAgentDraftResult = useCallback(() => {
+    sessionController.suppressAgentDraftResultAutoOpen();
+    sessionController.setGeneratedCustomWorldProfile(null);
+    sessionController.setCustomWorldError(null);
+    autosaveCoordinator.resetAutoSaveTrackingToIdle();
+    sessionController.setCustomWorldGenerationViewSource(null);
+    sessionController.setCustomWorldResultViewSource(null);
+    enterCreateTab();
+    setSelectionStage('platform');
+  }, [
+    autosaveCoordinator,
+    enterCreateTab,
+    sessionController,
+    setSelectionStage,
+  ]);
+
+  const leaveCustomWorldResult = useCallback(() => {
+    sessionController.setGeneratedCustomWorldProfile(null);
+    sessionController.setCustomWorldError(null);
+    autosaveCoordinator.resetAutoSaveTrackingToIdle();
+    sessionController.setCustomWorldGenerationViewSource(null);
+    sessionController.setCustomWorldResultViewSource(null);
+    setSelectionStage(selectedDetailEntry ? 'detail' : 'platform');
+  }, [
+    autosaveCoordinator,
+    selectedDetailEntry,
+    sessionController,
+    setSelectionStage,
+  ]);
+
+  const handleStartSelectedWorld = useCallback(() => {
+    if (!selectedDetailEntry) {
+      return;
+    }
+
+    runProtectedAction(() => {
+      handleCustomWorldSelect(selectedDetailEntry.profile);
+    });
+  }, [handleCustomWorldSelect, runProtectedAction, selectedDetailEntry]);
+
+  const creationHubContent = (
+    <CustomWorldCreationHub
+      items={creationHubItems}
+      loading={platformBootstrap.isLoadingPlatform}
+      error={
+        platformBootstrap.isLoadingPlatform
+          ? null
+          : platformBootstrap.platformError ?? sessionController.creationTypeError
+      }
+      onBack={() => {
+        platformBootstrap.setPlatformTab('home');
+      }}
+      onRetry={() => {
+        platformBootstrap.setPlatformError(null);
+        void platformBootstrap.refreshCustomWorldWorks().catch((error) => {
+          platformBootstrap.setPlatformError(
+            resolveRpgCreationErrorMessage(error, '读取创作作品列表失败。'),
+          );
+        });
+      }}
+      onCreateNew={openCreationTypePicker}
+      onOpenDraft={(item) => {
+        runProtectedAction(() => {
+          void detailNavigation.handleOpenCreationWork(item);
+        });
+      }}
+      onEnterPublished={(profileId) => {
+        runProtectedAction(() => {
+          const matchedWork = creationHubItems.find(
+            (entry) => entry.profileId === profileId,
+          );
+          if (!matchedWork) {
+            return;
+          }
+          void detailNavigation.handleOpenCreationWork(matchedWork);
+        });
+      }}
+    />
+  );
+
+  return (
+    <>
+      <AnimatePresence mode="wait">
+        {selectionStage === 'platform' && (
+          <motion.div
+            key="platform-home"
+            initial={{ opacity: 0, y: 12 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0, y: -12 }}
+            className="flex h-full min-h-0 flex-col"
+          >
+            <RpgEntryHomeView
+              activeTab={platformBootstrap.platformTab}
+              onTabChange={platformBootstrap.setPlatformTab}
+              hasSavedGame={hasSavedGame}
+              savedSnapshot={savedSnapshot}
+              saveEntries={platformBootstrap.saveEntries}
+              saveError={platformBootstrap.saveError}
+              featuredEntries={featuredGalleryEntries}
+              latestEntries={platformBootstrap.publishedGalleryEntries}
+              myEntries={platformBootstrap.savedCustomWorldEntries}
+              historyEntries={platformBootstrap.historyEntries}
+              profileDashboard={platformBootstrap.profileDashboard}
+              isLoadingPlatform={platformBootstrap.isLoadingPlatform}
+              isLoadingDashboard={platformBootstrap.isLoadingDashboard}
+              isResumingSaveWorldKey={platformBootstrap.isResumingSaveWorldKey}
+              platformError={
+                platformBootstrap.isLoadingPlatform
+                  ? null
+                  : platformBootstrap.platformError ??
+                    sessionController.creationTypeError
+              }
+              dashboardError={
+                platformBootstrap.isLoadingDashboard
+                  ? null
+                  : platformBootstrap.dashboardError
+              }
+              createTabContent={creationHubContent}
+              onContinueGame={handleContinueGame}
+              onResumeSave={(entry) => {
+                void platformBootstrap.handleResumeSaveEntry(entry);
+              }}
+              onOpenCreateWorld={openCreationTypePicker}
+              onOpenCreateTypePicker={openCreationTypePicker}
+              onOpenGalleryDetail={(entry) => {
+                runProtectedAction(() => {
+                  void detailNavigation.openGalleryDetail(entry);
+                });
+              }}
+              onOpenLibraryDetail={(entry) => {
+                runProtectedAction(() => {
+                  detailNavigation.openLibraryDetail(entry);
+                });
+              }}
+              onOpenProfileDashboardCard={() => {
+                if (platformBootstrap.dashboardError) {
+                  void platformBootstrap.refreshProfileDashboard();
+                }
+              }}
+            />
+          </motion.div>
+        )}
+
+        {selectionStage === 'detail' && (
+          <motion.div
+            key="platform-detail"
+            initial={{ opacity: 0, y: 12 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0, y: -12 }}
+            className="flex h-full min-h-0 flex-col"
+          >
+            {detailNavigation.isDetailLoading || !selectedDetailEntry ? (
+              <div className="flex h-full items-center justify-center">
+                <div className="platform-subpanel rounded-2xl px-5 py-4 text-sm text-[var(--platform-text-base)]">
+                  {detailNavigation.detailError || '正在读取作品详情...'}
+                </div>
+              </div>
+            ) : (
+              <RpgEntryWorldDetailView
+                entry={selectedDetailEntry}
+                isMutating={detailNavigation.isMutatingDetail}
+                error={detailNavigation.detailError}
+                onBack={() => {
+                  detailNavigation.setDetailError(null);
+                  entryNavigation.backToPlatformHome();
+                }}
+                onStartGame={handleStartSelectedWorld}
+                onContinueEdit={
+                  detailNavigation.isSelectedWorldOwned
+                    ? () => {
+                        runProtectedAction(() => {
+                          detailNavigation.openSavedCustomWorldEditor(
+                            selectedDetailEntry,
+                          );
+                        });
+                      }
+                    : null
+                }
+                onPublish={
+                  selectedDetailEntry.visibility === 'draft' &&
+                  detailNavigation.isSelectedWorldOwned
+                    ? () => {
+                        runProtectedAction(() => {
+                          void detailNavigation.handlePublishSelectedWorld();
+                        });
+                      }
+                    : null
+                }
+                onUnpublish={
+                  selectedDetailEntry.visibility === 'published' &&
+                  detailNavigation.isSelectedWorldOwned
+                    ? () => {
+                        runProtectedAction(() => {
+                          void detailNavigation.handleUnpublishSelectedWorld();
+                        });
+                      }
+                    : null
+                }
+                onDelete={
+                  detailNavigation.isSelectedWorldOwned
+                    ? () => {
+                        runProtectedAction(() => {
+                          void detailNavigation.handleDeleteSelectedWorld();
+                        });
+                      }
+                    : null
+                }
+              />
+            )}
+          </motion.div>
+        )}
+
+        {selectionStage === 'agent-workspace' && (
+          <motion.div
+            key="agent-workspace"
+            initial={{ opacity: 0, y: 12 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0, y: -12 }}
+            className="flex h-full min-h-0 flex-col"
+          >
+            <Suspense
+              fallback={
+                <LazyPanelFallback label="正在加载 Agent 共创工作区..." />
+              }
+            >
+              {sessionController.agentSession ? (
+                <CustomWorldAgentWorkspace
+                  session={sessionController.agentSession}
+                  activeOperation={sessionController.agentOperation}
+                  streamingReplyText={sessionController.streamingAgentReplyText}
+                  isStreamingReply={sessionController.isStreamingAgentReply}
+                  onBack={leaveAgentWorkspace}
+                  onSubmitMessage={(payload) => {
+                    void sessionController.submitAgentMessage(payload);
+                  }}
+                  onExecuteAction={(payload) => {
+                    void sessionController.executeAgentAction(payload);
+                  }}
+                />
+              ) : (
+                <div className="flex h-full items-center justify-center">
+                  <div className="platform-subpanel rounded-2xl px-5 py-4 text-sm text-[var(--platform-text-base)]">
+                    {sessionController.isLoadingAgentSession
+                      ? '正在准备 Agent 共创工作区...'
+                      : sessionController.creationTypeError || '正在恢复创作工作区...'}
+                  </div>
+                </div>
+              )}
+            </Suspense>
+          </motion.div>
+        )}
+
+        {selectionStage === 'custom-world-generating' && (
+          <motion.div
+            key="custom-world-generating"
+            initial={{ opacity: 0, y: 12 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0, y: -12 }}
+            className="flex h-full min-h-0 flex-col"
+          >
+            <Suspense
+              fallback={<LazyPanelFallback label="正在加载世界生成面板..." />}
+            >
+              <CustomWorldGenerationView
+                settingText={sessionController.agentDraftSettingPreview}
+                anchorEntries={sessionController.agentDraftAnchorPreviewEntries}
+                progress={sessionController.agentDraftGenerationProgress}
+                isGenerating={sessionController.isActiveGenerationRunning}
+                error={sessionController.activeGenerationError}
+                onBack={leaveAgentDraftGeneration}
+                onEditSetting={leaveAgentDraftGeneration}
+                onRetry={() => {
+                  void sessionController.executeAgentAction({
+                    action: 'draft_foundation',
+                  });
+                }}
+                onInterrupt={undefined}
+                backLabel="返回工作区"
+                settingActionLabel={null}
+                retryLabel="重新生成草稿"
+                settingTitle="当前世界信息"
+                settingDescription={null}
+                progressTitle="世界草稿生成进度"
+                activeBadgeLabel="草稿编译中"
+                pausedBadgeLabel="草稿生成已暂停"
+                idleBadgeLabel="等待返回工作区"
+              />
+            </Suspense>
+          </motion.div>
+        )}
+
+        {selectionStage === 'custom-world-result' &&
+          sessionController.generatedCustomWorldProfile && (
+            <motion.div
+              key="custom-world-result"
+              initial={{ opacity: 0, y: 12 }}
+              animate={{ opacity: 1, y: 0 }}
+              exit={{ opacity: 0, y: -12 }}
+              className="flex h-full min-h-0 flex-col"
+            >
+              <Suspense
+                fallback={<LazyPanelFallback label="正在加载世界编辑器..." />}
+              >
+                <RpgCreationResultView
+                  profile={sessionController.generatedCustomWorldProfile}
+                  previewCharacters={previewCustomWorldCharacters}
+                  isGenerating={false}
+                  progress={0}
+                  progressLabel=""
+                  error={resultViewError}
+                  onProfileChange={(profile) => {
+                    sessionController.setGeneratedCustomWorldProfile(
+                      normalizeAgentBackedProfile(profile),
+                    );
+                  }}
+                  onBack={
+                    sessionController.isAgentDraftResultView
+                      ? () => {
+                          void (async () => {
+                            const currentProfile =
+                              sessionController.generatedCustomWorldProfile;
+                            if (!currentProfile) {
+                              leaveAgentDraftResult();
+                              return;
+                            }
+
+                            await autosaveCoordinator.syncAgentDraftResultProfile(
+                              currentProfile,
+                            );
+                            leaveAgentDraftResult();
+                          })().catch((error) => {
+                            sessionController.setCustomWorldError(
+                              resolveRpgCreationErrorMessage(
+                                error,
+                                '返回创作前同步草稿失败。',
+                              ),
+                            );
+                          });
+                        }
+                      : leaveCustomWorldResult
+                  }
+                  onEditSetting={undefined}
+                  onRegenerate={undefined}
+                  onContinueExpand={undefined}
+                  onEnterWorld={() => {
+                    runProtectedAction(() => {
+                      void enterWorldCoordinator
+                        .enterWorldFromCurrentResult()
+                        .catch((error) => {
+                          sessionController.setCustomWorldError(
+                            resolveRpgCreationErrorMessage(
+                              error,
+                              '发布并进入世界失败。',
+                            ),
+                          );
+                        });
+                    });
+                  }}
+                  readOnly={false}
+                  compactAgentResultMode={sessionController.isAgentDraftResultView}
+                  backLabel={
+                    sessionController.isAgentDraftResultView
+                      ? '返回创作'
+                      : undefined
+                  }
+                  editActionLabel="继续调整设定"
+                  enterWorldActionLabel={
+                    sessionController.isAgentDraftResultView &&
+                    sessionController.agentSession?.stage !== 'published'
+                      ? '发布并进入世界'
+                      : '进入世界'
+                  }
+                  publishReady={
+                    sessionController.isAgentDraftResultView
+                      ? Boolean(agentResultPreview?.publishReady)
+                      : true
+                  }
+                  publishBlockers={
+                    sessionController.isAgentDraftResultView
+                      ? agentResultPreviewBlockers
+                      : []
+                  }
+                  qualityFindings={
+                    sessionController.isAgentDraftResultView
+                      ? agentResultPreviewQualityFindings
+                      : []
+                  }
+                  previewSourceLabel={
+                    sessionController.isAgentDraftResultView
+                      ? agentResultPreviewSourceLabel
+                      : null
+                  }
+                  autoSaveState={autosaveCoordinator.customWorldAutoSaveState}
+                />
+              </Suspense>
+            </motion.div>
+          )}
+      </AnimatePresence>
+
+      <RpgEntryCreationTypeModal
+        isOpen={showCreationTypeModal}
+        isBusy={sessionController.isCreatingAgentSession}
+        error={sessionController.creationTypeError}
+        onClose={() => {
+          if (sessionController.isCreatingAgentSession) {
+            return;
+          }
+          setShowCreationTypeModal(false);
+        }}
+        onSelectRpg={() => {
+          runProtectedAction(() => {
+            void sessionController.openRpgAgentWorkspace();
+          });
+        }}
+      />
+    </>
+  );
+}
+
+export const RpgCreationShellImpl = RpgEntryFlowShellImpl;
+
+export default RpgEntryFlowShellImpl;
diff --git a/src/components/game-shell/PlatformHomeView.tsx b/src/components/rpg-entry/RpgEntryHomeView.tsx
similarity index 99%
rename from src/components/game-shell/PlatformHomeView.tsx
rename to src/components/rpg-entry/RpgEntryHomeView.tsx
index 2c1fee68..38c24303 100644
--- a/src/components/game-shell/PlatformHomeView.tsx
+++ b/src/components/rpg-entry/RpgEntryHomeView.tsx
@@ -39,7 +39,7 @@ import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapsho
 import type { AuthUser } from '../../services/authService';
 import type { CustomWorldProfile } from '../../types';
 import { useAuthUi } from '../auth/AuthUiContext';
-import { PlatformBrandLogo } from './PlatformBrandLogo';
+import { RpgEntryBrandLogo } from './RpgEntryBrandLogo';
 import {
   buildPlatformWorldTags,
   describePlatformThemeLabel,
@@ -47,9 +47,37 @@ import {
   type PlatformWorldCardLike,
   resolvePlatformWorldCoverImage,
   resolvePlatformWorldLeadPortrait,
-} from './platformWorldPresentation';
+} from './rpgEntryWorldPresentation';
 
 export type PlatformHomeTab = 'home' | 'create' | 'saves' | 'profile';
+export interface RpgEntryHomeViewProps {
+  activeTab: PlatformHomeTab;
+  onTabChange: (tab: PlatformHomeTab) => void;
+  hasSavedGame: boolean;
+  savedSnapshot: HydratedSavedGameSnapshot | null;
+  saveEntries: ProfileSaveArchiveSummary[];
+  saveError: string | null;
+  featuredEntries: CustomWorldGalleryCard[];
+  latestEntries: CustomWorldGalleryCard[];
+  myEntries: CustomWorldLibraryEntry<CustomWorldProfile>[];
+  historyEntries: PlatformBrowseHistoryEntry[];
+  profileDashboard: ProfileDashboardSummary | null;
+  isLoadingPlatform: boolean;
+  isLoadingDashboard: boolean;
+  isResumingSaveWorldKey: string | null;
+  platformError: string | null;
+  dashboardError: string | null;
+  onContinueGame: (snapshot?: HydratedSavedGameSnapshot | null) => void;
+  onResumeSave: (entry: ProfileSaveArchiveSummary) => void;
+  onOpenCreateWorld: () => void;
+  onOpenCreateTypePicker: () => void;
+  onOpenGalleryDetail: (entry: CustomWorldGalleryCard) => void;
+  onOpenLibraryDetail: (
+    entry: CustomWorldLibraryEntry<CustomWorldProfile>,
+  ) => void;
+  onOpenProfileDashboardCard?: (cardKey: ProfileDashboardCardKey) => void;
+  createTabContent?: ReactNode;
+}
 
 const PANEL_SURFACE_CLASS = 'platform-surface platform-surface--soft';
 const HERO_SURFACE_CLASS =
@@ -676,7 +704,7 @@ function ProfileShortcutButton({
   );
 }
 
-export function PlatformHomeView({
+export function RpgEntryHomeView({
   activeTab,
   onTabChange,
   hasSavedGame,
@@ -701,34 +729,7 @@ export function PlatformHomeView({
   onOpenLibraryDetail,
   onOpenProfileDashboardCard,
   createTabContent,
-}: {
-  activeTab: PlatformHomeTab;
-  onTabChange: (tab: PlatformHomeTab) => void;
-  hasSavedGame: boolean;
-  savedSnapshot: HydratedSavedGameSnapshot | null;
-  saveEntries: ProfileSaveArchiveSummary[];
-  saveError: string | null;
-  featuredEntries: CustomWorldGalleryCard[];
-  latestEntries: CustomWorldGalleryCard[];
-  myEntries: CustomWorldLibraryEntry<CustomWorldProfile>[];
-  historyEntries: PlatformBrowseHistoryEntry[];
-  profileDashboard: ProfileDashboardSummary | null;
-  isLoadingPlatform: boolean;
-  isLoadingDashboard: boolean;
-  isResumingSaveWorldKey: string | null;
-  platformError: string | null;
-  dashboardError: string | null;
-  onContinueGame: (snapshot?: HydratedSavedGameSnapshot | null) => void;
-  onResumeSave: (entry: ProfileSaveArchiveSummary) => void;
-  onOpenCreateWorld: () => void;
-  onOpenCreateTypePicker: () => void;
-  onOpenGalleryDetail: (entry: CustomWorldGalleryCard) => void;
-  onOpenLibraryDetail: (
-    entry: CustomWorldLibraryEntry<CustomWorldProfile>,
-  ) => void;
-  onOpenProfileDashboardCard?: (cardKey: ProfileDashboardCardKey) => void;
-  createTabContent?: ReactNode;
-}) {
+}: RpgEntryHomeViewProps) {
   const authUi = useAuthUi();
   const isAuthenticated = Boolean(authUi?.user);
   const isDesktopLayout = usePlatformDesktopLayout();
@@ -1472,7 +1473,7 @@ export function PlatformHomeView({
     return (
       <div className="flex h-full min-h-0 flex-col">
         <div className="mb-4">
-          <PlatformBrandLogo />
+          <RpgEntryBrandLogo />
         </div>
 
         <div className="min-h-0 flex-1 overflow-y-auto pr-1 scrollbar-hide">
@@ -1523,7 +1524,7 @@ export function PlatformHomeView({
         <div className="platform-desktop-shell flex h-full min-h-0 flex-col p-5 xl:p-6">
           <div className="platform-desktop-topbar flex items-center gap-4 px-5 py-4">
             <div className="flex min-w-0 flex-1 items-center gap-5">
-              <PlatformBrandLogo className="shrink-0" decorative />
+              <RpgEntryBrandLogo className="shrink-0" decorative />
               <div className="platform-desktop-search flex min-w-0 max-w-[34rem] flex-1 items-center gap-3 px-4 py-3 text-[var(--platform-text-soft)]">
                 <Search className="h-4 w-4 shrink-0" />
                 <span className="truncate text-sm">
@@ -1604,3 +1605,5 @@ export function PlatformHomeView({
     </div>
   );
 }
+
+export const PlatformHomeView = RpgEntryHomeView;
diff --git a/src/components/game-shell/PlatformWorldDetailView.tsx b/src/components/rpg-entry/RpgEntryWorldDetailView.tsx
similarity index 96%
rename from src/components/game-shell/PlatformWorldDetailView.tsx
rename to src/components/rpg-entry/RpgEntryWorldDetailView.tsx
index bddeb6bc..14534e89 100644
--- a/src/components/game-shell/PlatformWorldDetailView.tsx
+++ b/src/components/rpg-entry/RpgEntryWorldDetailView.tsx
@@ -9,7 +9,19 @@ import {
   formatPlatformWorldTime,
   resolvePlatformWorldCoverImage,
   resolvePlatformWorldLeadPortrait,
-} from './platformWorldPresentation';
+} from './rpgEntryWorldPresentation';
+
+export interface RpgEntryWorldDetailViewProps {
+  entry: CustomWorldLibraryEntry<CustomWorldProfile>;
+  isMutating: boolean;
+  error: string | null;
+  onBack: () => void;
+  onStartGame: () => void;
+  onContinueEdit?: (() => void) | null;
+  onPublish?: (() => void) | null;
+  onDelete?: (() => void) | null;
+  onUnpublish?: (() => void) | null;
+}
 
 function ActionButton({
   label,
@@ -41,7 +53,7 @@ function ActionButton({
   );
 }
 
-export function PlatformWorldDetailView({
+export function RpgEntryWorldDetailView({
   entry,
   isMutating,
   error,
@@ -51,19 +63,10 @@ export function PlatformWorldDetailView({
   onPublish,
   onDelete,
   onUnpublish,
-}: {
-  entry: CustomWorldLibraryEntry<CustomWorldProfile>;
-  isMutating: boolean;
-  error: string | null;
-  onBack: () => void;
-  onStartGame: () => void;
-  onContinueEdit?: (() => void) | null;
-  onPublish?: (() => void) | null;
-  onDelete?: (() => void) | null;
-  onUnpublish?: (() => void) | null;
-}) {
+}: RpgEntryWorldDetailViewProps) {
   const coverImage = resolvePlatformWorldCoverImage(entry);
   const leadPortrait = resolvePlatformWorldLeadPortrait(entry);
+  const canStartGame = entry.visibility === 'published';
   const previewCharacters = buildCustomWorldPlayableCharacters(
     entry.profile,
   ).slice(0, 3);
@@ -238,9 +241,10 @@ export function PlatformWorldDetailView({
               </div>
               <div className="mt-4 flex flex-col gap-3">
                 <ActionButton
-                  label="开始游戏"
+                  label={canStartGame ? '开始游戏' : '请先发布作品'}
                   onClick={onStartGame}
                   tone="primary"
+                  disabled={!canStartGame || isMutating}
                 />
                 {onContinueEdit ? (
                   <ActionButton
@@ -286,3 +290,5 @@ export function PlatformWorldDetailView({
     </div>
   );
 }
+
+export const PlatformWorldDetailView = RpgEntryWorldDetailView;
diff --git a/src/components/rpg-entry/index.ts b/src/components/rpg-entry/index.ts
new file mode 100644
index 00000000..aa3975fb
--- /dev/null
+++ b/src/components/rpg-entry/index.ts
@@ -0,0 +1,27 @@
+export {
+  RpgEntryCharacterSelectView,
+  type RpgEntryCharacterSelectViewProps,
+} from './RpgEntryCharacterSelectView';
+export {
+  RpgEntryFlowShell,
+  type RpgEntryFlowShellProps,
+  type SelectionStage,
+} from './RpgEntryFlowShell';
+export {
+  type PlatformHomeTab,
+  RpgEntryHomeView,
+  type RpgEntryHomeViewProps,
+} from './RpgEntryHomeView';
+export {
+  RpgEntryWorldDetailView,
+  type RpgEntryWorldDetailViewProps,
+} from './RpgEntryWorldDetailView';
+export { useRpgCreationAgentOperationPolling } from './useRpgCreationAgentOperationPolling';
+export { useRpgCreationEnterWorld } from './useRpgCreationEnterWorld';
+export { useRpgCreationResultAutosave } from './useRpgCreationResultAutosave';
+export { useRpgCreationSessionController } from './useRpgCreationSessionController';
+export { useRpgEntryBootstrap } from './useRpgEntryBootstrap';
+export { useRpgEntryCharacterSelect } from './useRpgEntryCharacterSelect';
+export { useRpgEntryLibraryDetail } from './useRpgEntryLibraryDetail';
+export { useRpgEntryNavigation } from './useRpgEntryNavigation';
+export { useRpgEntrySaveResume } from './useRpgEntrySaveResume';
diff --git a/src/components/rpg-entry/rpgEntryShared.ts b/src/components/rpg-entry/rpgEntryShared.ts
new file mode 100644
index 00000000..fb4b2917
--- /dev/null
+++ b/src/components/rpg-entry/rpgEntryShared.ts
@@ -0,0 +1,110 @@
+import type {
+  CustomWorldAgentMessage,
+  CustomWorldAgentOperationRecord,
+  CustomWorldWorkSummary,
+} from '../../../packages/shared/src/contracts/customWorldAgent';
+import type { CustomWorldLibraryEntry } from '../../../packages/shared/src/contracts/runtime';
+import { buildCustomWorldCreatorIntentFoundationText } from '../../services/customWorldCreatorIntent';
+import type { CustomWorldProfile } from '../../types';
+
+export function resolveRpgEntryErrorMessage(
+  error: unknown,
+  fallback: string,
+) {
+  return error instanceof Error ? error.message : fallback;
+}
+
+export function createFailedRpgEntryAgentOperation(params: {
+  type: CustomWorldAgentOperationRecord['type'];
+  phaseLabel: string;
+  error: string;
+}): CustomWorldAgentOperationRecord {
+  return {
+    operationId: `local-failed-${Date.now()}`,
+    type: params.type,
+    status: 'failed',
+    phaseLabel: params.phaseLabel,
+    phaseDetail: params.error,
+    progress: 100,
+    error: params.error,
+  };
+}
+
+export function buildOptimisticRpgEntryAgentMessage(
+  payload: Pick<CustomWorldAgentMessage, 'id' | 'role' | 'kind' | 'text'>,
+): CustomWorldAgentMessage {
+  return {
+    ...payload,
+    createdAt: new Date().toISOString(),
+    relatedOperationId: null,
+  };
+}
+
+export function normalizeRpgEntryAgentBackedProfile(
+  profile: CustomWorldProfile,
+) {
+  const foundationText = buildCustomWorldCreatorIntentFoundationText(
+    profile.creatorIntent,
+  ).trim();
+
+  if (!foundationText || foundationText === profile.settingText.trim()) {
+    return profile;
+  }
+
+  return {
+    ...profile,
+    settingText: foundationText,
+  } satisfies CustomWorldProfile;
+}
+
+export function stringifyRpgEntryAgentBackedProfile(
+  profile: CustomWorldProfile,
+) {
+  return JSON.stringify(normalizeRpgEntryAgentBackedProfile(profile));
+}
+
+export function buildRpgEntryCreationHubFallbackItems(
+  entries: CustomWorldLibraryEntry<CustomWorldProfile>[],
+): CustomWorldWorkSummary[] {
+  return entries
+    .filter((entry) => entry.visibility === 'published')
+    .map((entry) => ({
+      workId: `fallback:${entry.profileId}`,
+      sourceType: 'published_profile',
+      status: 'published',
+      title: entry.worldName,
+      subtitle: entry.subtitle || '已发布作品',
+      summary: entry.summaryText || '继续补完这个世界的设定与游玩入口。',
+      coverImageSrc: entry.coverImageSrc,
+      coverRenderMode: 'image',
+      coverCharacterImageSrcs: [],
+      updatedAt: entry.updatedAt,
+      publishedAt: entry.publishedAt,
+      stage: null,
+      stageLabel: '已发布',
+      playableNpcCount: entry.playableNpcCount,
+      landmarkCount: entry.landmarkCount,
+      roleVisualReadyCount: 0,
+      roleAnimationReadyCount: 0,
+      roleAssetSummaryLabel: null,
+      sessionId: null,
+      profileId: entry.profileId,
+      canResume: false,
+      canEnterWorld: true,
+    }));
+}
+
+/**
+ * 兼容创作链工作包已经接入的旧 helper 命名，避免本轮迁移波及其他并行改动。
+ */
+export const resolveRpgCreationErrorMessage = resolveRpgEntryErrorMessage;
+export const createFailedAgentOperation =
+  createFailedRpgEntryAgentOperation;
+export const buildOptimisticAgentMessage =
+  buildOptimisticRpgEntryAgentMessage;
+export const normalizeAgentBackedProfile =
+  normalizeRpgEntryAgentBackedProfile;
+export const stringifyAgentBackedProfile =
+  stringifyRpgEntryAgentBackedProfile;
+export const buildCreationHubFallbackItems =
+  buildRpgEntryCreationHubFallbackItems;
diff --git a/src/components/rpg-entry/rpgEntryTypes.ts b/src/components/rpg-entry/rpgEntryTypes.ts
new file mode 100644
index 00000000..c418799d
--- /dev/null
+++ b/src/components/rpg-entry/rpgEntryTypes.ts
@@ -0,0 +1,39 @@
+import type {
+  CustomWorldAgentSessionSnapshot,
+} from '../../../packages/shared/src/contracts/customWorldAgent';
+import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
+import type { CustomWorldProfile, GameState } from '../../types';
+
+export type SelectionStage =
+  | 'platform'
+  | 'detail'
+  | 'agent-workspace'
+  | 'custom-world-generating'
+  | 'custom-world-result';
+
+export type CustomWorldGenerationViewSource = 'agent-draft-foundation' | null;
+
+export type CustomWorldResultViewSource = 'saved-profile' | 'agent-draft' | null;
+
+export type CustomWorldAutoSaveState = 'idle' | 'saving' | 'saved' | 'error';
+
+export type SyncedAgentDraftResult = {
+  session: CustomWorldAgentSessionSnapshot | null;
+  profile: CustomWorldProfile | null;
+};
+
+export type RpgEntryFlowShellProps = {
+  selectionStage: SelectionStage;
+  setSelectionStage: (stage: SelectionStage) => void;
+  gameState: GameState;
+  hasSavedGame: boolean;
+  savedSnapshot: HydratedSavedGameSnapshot | null;
+  handleContinueGame: (snapshot?: HydratedSavedGameSnapshot | null) => void;
+  handleStartNewGame: () => void;
+  handleCustomWorldSelect: (customWorldProfile: CustomWorldProfile) => void;
+};
+
+/**
+ * 兼容旧创作链入口的 props 命名，避免并行工作包在迁移期间断开引用。
+ */
+export type RpgCreationShellProps = RpgEntryFlowShellProps;
diff --git a/src/components/game-shell/platformWorldPresentation.ts b/src/components/rpg-entry/rpgEntryWorldPresentation.ts
similarity index 92%
rename from src/components/game-shell/platformWorldPresentation.ts
rename to src/components/rpg-entry/rpgEntryWorldPresentation.ts
index 639d0184..be5357e8 100644
--- a/src/components/game-shell/platformWorldPresentation.ts
+++ b/src/components/rpg-entry/rpgEntryWorldPresentation.ts
@@ -28,9 +28,7 @@ export function resolvePlatformWorldCoverImage(entry: PlatformWorldCardLike) {
   return '';
 }
 
-export function resolvePlatformWorldLeadPortrait(
-  entry: PlatformWorldCardLike,
-) {
+export function resolvePlatformWorldLeadPortrait(entry: PlatformWorldCardLike) {
   if (!isLibraryWorldEntry(entry)) {
     return '';
   }
@@ -72,7 +70,9 @@ export function formatPlatformWorldTime(value: string | null) {
   });
 }
 
-export function describePlatformThemeLabel(themeMode: PlatformWorldCardLike['themeMode']) {
+export function describePlatformThemeLabel(
+  themeMode: PlatformWorldCardLike['themeMode'],
+) {
   switch (themeMode) {
     case 'martial':
       return '江湖';
diff --git a/src/components/rpg-entry/useRpgCreationAgentOperationPolling.ts b/src/components/rpg-entry/useRpgCreationAgentOperationPolling.ts
new file mode 100644
index 00000000..8582c066
--- /dev/null
+++ b/src/components/rpg-entry/useRpgCreationAgentOperationPolling.ts
@@ -0,0 +1,109 @@
+import { useEffect } from 'react';
+
+import type {
+  CustomWorldAgentOperationRecord,
+  CustomWorldAgentSessionSnapshot,
+} from '../../../packages/shared/src/contracts/customWorldAgent';
+import {
+  getRpgCreationOperation,
+} from '../../services/rpg-creation';
+import {
+  createFailedAgentOperation,
+  resolveRpgCreationErrorMessage,
+} from './rpgEntryShared';
+
+type UseRpgCreationAgentOperationPollingParams = {
+  activeAgentSessionId: string | null;
+  activeAgentOperationId: string | null;
+  userId: string | null | undefined;
+  setAgentOperation: (
+    operation: CustomWorldAgentOperationRecord | null,
+  ) => void;
+  persistAgentUiState: (
+    sessionId: string | null,
+    operationId: string | null,
+  ) => void;
+  syncAgentSessionSnapshot: (
+    sessionId: string,
+  ) => Promise<CustomWorldAgentSessionSnapshot | null>;
+};
+
+/**
+ * 只负责当前 Agent operation 的轮询与完成态刷新。
+ * 壳层不再直接维护轮询 interval 与失败兜底细节。
+ */
+export function useRpgCreationAgentOperationPolling(
+  params: UseRpgCreationAgentOperationPollingParams,
+) {
+  const {
+    activeAgentSessionId,
+    activeAgentOperationId,
+    userId,
+    setAgentOperation,
+    persistAgentUiState,
+    syncAgentSessionSnapshot,
+  } = params;
+
+  useEffect(() => {
+    if (!activeAgentSessionId || !activeAgentOperationId || !userId) {
+      return;
+    }
+
+    let cancelled = false;
+
+    const pollOperation = async () => {
+      try {
+        const nextOperation = await getRpgCreationOperation(
+          activeAgentSessionId,
+          activeAgentOperationId,
+        );
+
+        if (cancelled) {
+          return;
+        }
+
+        setAgentOperation(nextOperation);
+
+        if (
+          nextOperation.status === 'completed' ||
+          nextOperation.status === 'failed'
+        ) {
+          persistAgentUiState(activeAgentSessionId, null);
+          await syncAgentSessionSnapshot(activeAgentSessionId).catch(
+            () => null,
+          );
+        }
+      } catch (error) {
+        if (cancelled) {
+          return;
+        }
+
+        setAgentOperation(
+          createFailedAgentOperation({
+            type: 'process_message',
+            phaseLabel: '读取操作状态失败',
+            error: resolveRpgCreationErrorMessage(error, '读取共创操作状态失败。'),
+          }),
+        );
+        persistAgentUiState(activeAgentSessionId, null);
+      }
+    };
+
+    void pollOperation();
+    const intervalId = window.setInterval(() => {
+      void pollOperation();
+    }, 1200);
+
+    return () => {
+      cancelled = true;
+      window.clearInterval(intervalId);
+    };
+  }, [
+    activeAgentOperationId,
+    activeAgentSessionId,
+    persistAgentUiState,
+    setAgentOperation,
+    syncAgentSessionSnapshot,
+    userId,
+  ]);
+}
diff --git a/src/components/rpg-entry/useRpgCreationEnterWorld.ts b/src/components/rpg-entry/useRpgCreationEnterWorld.ts
new file mode 100644
index 00000000..92beaccd
--- /dev/null
+++ b/src/components/rpg-entry/useRpgCreationEnterWorld.ts
@@ -0,0 +1,92 @@
+import { useCallback } from 'react';
+
+import type { CustomWorldAgentSessionSnapshot } from '../../../packages/shared/src/contracts/customWorldAgent';
+import { rpgCreationPreviewAdapter } from '../../services/rpg-creation/rpgCreationPreviewAdapter';
+import type { CustomWorldProfile } from '../../types';
+
+type UseRpgCreationEnterWorldParams = {
+  isAgentDraftResultView: boolean;
+  activeAgentSessionId: string | null;
+  generatedCustomWorldProfile: CustomWorldProfile | null;
+  agentSessionProfile: CustomWorldProfile | null;
+  agentSession: CustomWorldAgentSessionSnapshot | null;
+  handleCustomWorldSelect: (customWorldProfile: CustomWorldProfile) => void;
+  executePublishWorld: () => Promise<CustomWorldAgentSessionSnapshot | null>;
+  syncAgentDraftResultProfile: (
+    profile: CustomWorldProfile,
+  ) => Promise<{
+    profile: CustomWorldProfile | null;
+    session: CustomWorldAgentSessionSnapshot | null;
+  }>;
+  setGeneratedCustomWorldProfile: (profile: CustomWorldProfile | null) => void;
+};
+
+/**
+ * 统一“进入世界”前的最终同步策略。
+ * 非 Agent 草稿结果直接进入；Agent 草稿结果必须先把当前结果页并回 session。
+ */
+export function useRpgCreationEnterWorld(
+  params: UseRpgCreationEnterWorldParams,
+) {
+  const {
+    isAgentDraftResultView,
+    activeAgentSessionId,
+    generatedCustomWorldProfile,
+    agentSessionProfile,
+    agentSession,
+    handleCustomWorldSelect,
+    executePublishWorld,
+    syncAgentDraftResultProfile,
+    setGeneratedCustomWorldProfile,
+  } = params;
+
+  const enterWorldFromCurrentResult = useCallback(async () => {
+    if (!generatedCustomWorldProfile) {
+      return;
+    }
+
+    if (!isAgentDraftResultView || !activeAgentSessionId) {
+      handleCustomWorldSelect(generatedCustomWorldProfile);
+      return;
+    }
+
+    const latestResult = await syncAgentDraftResultProfile(
+      generatedCustomWorldProfile,
+    );
+    const latestProfile =
+      latestResult.profile ?? agentSessionProfile ?? generatedCustomWorldProfile;
+    setGeneratedCustomWorldProfile(latestProfile);
+
+    const latestSession = latestResult.session ?? agentSession;
+    const canEnterPublishedWorld =
+      latestSession?.stage === 'published' &&
+      latestSession.resultPreview?.canEnterWorld;
+
+    if (canEnterPublishedWorld) {
+      handleCustomWorldSelect(latestProfile);
+      return;
+    }
+
+    const publishedSession = await executePublishWorld();
+    const publishedProfile =
+      rpgCreationPreviewAdapter.buildPreviewFromSession(publishedSession) ??
+      latestProfile;
+
+    setGeneratedCustomWorldProfile(publishedProfile);
+    handleCustomWorldSelect(publishedProfile);
+  }, [
+    activeAgentSessionId,
+    agentSession,
+    agentSessionProfile,
+    executePublishWorld,
+    generatedCustomWorldProfile,
+    handleCustomWorldSelect,
+    isAgentDraftResultView,
+    setGeneratedCustomWorldProfile,
+    syncAgentDraftResultProfile,
+  ]);
+
+  return {
+    enterWorldFromCurrentResult,
+  };
+}
diff --git a/src/components/rpg-entry/useRpgCreationResultAutosave.ts b/src/components/rpg-entry/useRpgCreationResultAutosave.ts
new file mode 100644
index 00000000..bb571ce2
--- /dev/null
+++ b/src/components/rpg-entry/useRpgCreationResultAutosave.ts
@@ -0,0 +1,392 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+import type {
+  CustomWorldAgentOperationRecord,
+  CustomWorldAgentSessionSnapshot,
+} from '../../../packages/shared/src/contracts/customWorldAgent';
+import type {
+  CustomWorldLibraryEntry,
+} from '../../../packages/shared/src/contracts/runtime';
+import {
+  executeRpgCreationAction,
+  getRpgCreationOperation,
+  upsertRpgWorldProfile,
+} from '../../services/rpg-creation';
+import type { CustomWorldProfile } from '../../types';
+import {
+  normalizeAgentBackedProfile,
+  resolveRpgCreationErrorMessage,
+  stringifyAgentBackedProfile,
+} from './rpgEntryShared';
+import type {
+  CustomWorldAutoSaveState,
+  SelectionStage,
+  SyncedAgentDraftResult,
+} from './rpgEntryTypes';
+
+type UseRpgCreationResultAutosaveParams = {
+  selectionStage: SelectionStage;
+  activeAgentSessionId: string | null;
+  agentSession: CustomWorldAgentSessionSnapshot | null;
+  generatedCustomWorldProfile: CustomWorldProfile | null;
+  isAgentDraftResultView: boolean;
+  userId: string | null | undefined;
+  setGeneratedCustomWorldProfile: (profile: CustomWorldProfile | null) => void;
+  setAgentOperation: (
+    operation: CustomWorldAgentOperationRecord | null,
+  ) => void;
+  setSavedCustomWorldEntries: (
+    entries: CustomWorldLibraryEntry<CustomWorldProfile>[],
+  ) => void;
+  setSelectedDetailEntry: (
+    updater:
+      | CustomWorldLibraryEntry<CustomWorldProfile>
+      | null
+      | ((
+          current: CustomWorldLibraryEntry<CustomWorldProfile> | null,
+        ) => CustomWorldLibraryEntry<CustomWorldProfile> | null),
+  ) => void;
+  refreshCustomWorldWorks: () => Promise<unknown>;
+  persistAgentUiState: (
+    sessionId: string | null,
+    operationId: string | null,
+  ) => void;
+  syncAgentSessionSnapshot: (
+    sessionId: string,
+  ) => Promise<CustomWorldAgentSessionSnapshot | null>;
+  buildDraftResultProfile: (
+    session: CustomWorldAgentSessionSnapshot | null,
+  ) => CustomWorldProfile | null;
+};
+
+/**
+ * 协调结果页自动保存与 Agent 草稿同步。
+ * 这里统一维护去重签名、延时保存和“先同步 session 再落作品库”的顺序。
+ */
+export function useRpgCreationResultAutosave(
+  params: UseRpgCreationResultAutosaveParams,
+) {
+  const {
+    selectionStage,
+    activeAgentSessionId,
+    agentSession,
+    generatedCustomWorldProfile,
+    isAgentDraftResultView,
+    userId,
+    setGeneratedCustomWorldProfile,
+    setAgentOperation,
+    setSavedCustomWorldEntries,
+    setSelectedDetailEntry,
+    refreshCustomWorldWorks,
+    persistAgentUiState,
+    syncAgentSessionSnapshot,
+    buildDraftResultProfile,
+  } = params;
+
+  const customWorldAutoSaveTimeoutRef = useRef<number | null>(null);
+  const lastAutoSavedProfileSignatureRef = useRef<string | null>(null);
+  const latestAutoSaveRequestIdRef = useRef(0);
+  const latestAgentResultSyncSignatureRef = useRef<string | null>(null);
+  const isCustomWorldAutoSaveBusyRef = useRef(false);
+
+  const [customWorldAutoSaveState, setCustomWorldAutoSaveState] =
+    useState<CustomWorldAutoSaveState>('idle');
+  const [customWorldAutoSaveError, setCustomWorldAutoSaveError] = useState<
+    string | null
+  >(null);
+
+  const resetAutoSaveTrackingToIdle = useCallback(() => {
+    if (customWorldAutoSaveTimeoutRef.current !== null) {
+      window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
+      customWorldAutoSaveTimeoutRef.current = null;
+    }
+    lastAutoSavedProfileSignatureRef.current = null;
+    latestAgentResultSyncSignatureRef.current = null;
+    setCustomWorldAutoSaveState('idle');
+    setCustomWorldAutoSaveError(null);
+  }, []);
+
+  const markAutoSavedProfile = useCallback((profile: CustomWorldProfile) => {
+    lastAutoSavedProfileSignatureRef.current =
+      stringifyAgentBackedProfile(profile);
+  }, []);
+
+  const saveGeneratedCustomWorld = useCallback(
+    async (profile = generatedCustomWorldProfile) => {
+      if (!profile) {
+        return null;
+      }
+
+      const normalizedProfile = normalizeAgentBackedProfile(profile);
+      const profileSignature = stringifyAgentBackedProfile(normalizedProfile);
+      const requestId = latestAutoSaveRequestIdRef.current + 1;
+      latestAutoSaveRequestIdRef.current = requestId;
+      setCustomWorldAutoSaveState('saving');
+      setCustomWorldAutoSaveError(null);
+
+      try {
+        const mutation =
+          await upsertRpgWorldProfile(normalizedProfile);
+        if (latestAutoSaveRequestIdRef.current !== requestId) {
+          return mutation;
+        }
+
+        lastAutoSavedProfileSignatureRef.current = profileSignature;
+        setSavedCustomWorldEntries(mutation.entries);
+        if (userId) {
+          void refreshCustomWorldWorks().catch(() => {});
+        }
+        setSelectedDetailEntry((current) => {
+          if (!current || current.profileId === mutation.entry.profileId) {
+            return mutation.entry;
+          }
+
+          return current;
+        });
+        setCustomWorldAutoSaveState('saved');
+        setCustomWorldAutoSaveError(null);
+        return mutation;
+      } catch (error) {
+        if (latestAutoSaveRequestIdRef.current !== requestId) {
+          return null;
+        }
+
+        setCustomWorldAutoSaveState('error');
+        setCustomWorldAutoSaveError(
+          resolveRpgCreationErrorMessage(error, '保存自定义世界失败。'),
+        );
+        return null;
+      }
+    },
+    [
+      generatedCustomWorldProfile,
+      refreshCustomWorldWorks,
+      setSavedCustomWorldEntries,
+      setSelectedDetailEntry,
+      userId,
+    ],
+  );
+
+  const syncAgentDraftResultProfile = useCallback(
+    async (profile: CustomWorldProfile) => {
+      if (!activeAgentSessionId) {
+        return {
+          session: null,
+          profile: null,
+        } satisfies SyncedAgentDraftResult;
+      }
+
+      const normalizedProfile = normalizeAgentBackedProfile(profile);
+      const profileSignature = stringifyAgentBackedProfile(normalizedProfile);
+      const latestSessionProfile = buildDraftResultProfile(agentSession);
+      const latestSessionProfileSignature = latestSessionProfile
+        ? stringifyAgentBackedProfile(latestSessionProfile)
+        : '';
+
+      if (latestSessionProfileSignature === profileSignature) {
+        latestAgentResultSyncSignatureRef.current = profileSignature;
+        return {
+          session: agentSession,
+          profile: normalizeAgentBackedProfile(latestSessionProfile ?? profile),
+        } satisfies SyncedAgentDraftResult;
+      }
+
+      if (latestAgentResultSyncSignatureRef.current === profileSignature) {
+        return {
+          session: agentSession,
+          profile: normalizeAgentBackedProfile(latestSessionProfile ?? profile),
+        } satisfies SyncedAgentDraftResult;
+      }
+
+      const { operation } = await executeRpgCreationAction(
+        activeAgentSessionId,
+        {
+          action: 'sync_result_profile',
+          profile: normalizedProfile as unknown as Record<string, unknown>,
+        },
+      );
+      setAgentOperation(operation);
+      persistAgentUiState(activeAgentSessionId, operation.operationId);
+
+      for (let attempt = 0; attempt < 60; attempt += 1) {
+        const latestOperation = await getRpgCreationOperation(
+          activeAgentSessionId,
+          operation.operationId,
+        );
+        setAgentOperation(latestOperation);
+
+        if (latestOperation.status === 'failed') {
+          throw new Error(
+            latestOperation.error ||
+              latestOperation.phaseDetail ||
+              '同步结果页世界快照失败。',
+          );
+        }
+
+        if (latestOperation.status === 'completed') {
+          persistAgentUiState(activeAgentSessionId, null);
+          const latestSession = await syncAgentSessionSnapshot(
+            activeAgentSessionId,
+          );
+          const latestProfile = normalizeAgentBackedProfile(
+            buildDraftResultProfile(latestSession) ?? profile,
+          );
+          if (latestProfile) {
+            setGeneratedCustomWorldProfile(latestProfile);
+          }
+          latestAgentResultSyncSignatureRef.current = profileSignature;
+          return {
+            session: latestSession,
+            profile: latestProfile,
+          } satisfies SyncedAgentDraftResult;
+        }
+
+        await new Promise((resolve) => window.setTimeout(resolve, 200));
+      }
+
+      throw new Error('同步结果页世界快照超时。');
+    },
+    [
+      activeAgentSessionId,
+      agentSession,
+      buildDraftResultProfile,
+      persistAgentUiState,
+      setAgentOperation,
+      setGeneratedCustomWorldProfile,
+      syncAgentSessionSnapshot,
+    ],
+  );
+
+  const executeAgentActionAndWait = useCallback(
+    async (action: Parameters<typeof executeRpgCreationAction>[1]) => {
+      if (!activeAgentSessionId) {
+        return null;
+      }
+
+      const { operation } = await executeRpgCreationAction(
+        activeAgentSessionId,
+        action,
+      );
+      setAgentOperation(operation);
+      persistAgentUiState(activeAgentSessionId, operation.operationId);
+
+      for (let attempt = 0; attempt < 60; attempt += 1) {
+        const latestOperation = await getRpgCreationOperation(
+          activeAgentSessionId,
+          operation.operationId,
+        );
+        setAgentOperation(latestOperation);
+
+        if (latestOperation.status === 'failed') {
+          throw new Error(
+            latestOperation.error ||
+              latestOperation.phaseDetail ||
+              '执行共创操作失败。',
+          );
+        }
+
+        if (latestOperation.status === 'completed') {
+          persistAgentUiState(activeAgentSessionId, null);
+          return syncAgentSessionSnapshot(activeAgentSessionId);
+        }
+
+        await new Promise((resolve) => window.setTimeout(resolve, 200));
+      }
+
+      throw new Error('执行共创操作超时。');
+    },
+    [
+      activeAgentSessionId,
+      persistAgentUiState,
+      setAgentOperation,
+      syncAgentSessionSnapshot,
+    ],
+  );
+
+  useEffect(
+    () => () => {
+      if (customWorldAutoSaveTimeoutRef.current !== null) {
+        window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
+      }
+    },
+    [],
+  );
+
+  useEffect(() => {
+    if (!generatedCustomWorldProfile) {
+      resetAutoSaveTrackingToIdle();
+      return;
+    }
+
+    if (selectionStage !== 'custom-world-result') {
+      return;
+    }
+
+    if (isCustomWorldAutoSaveBusyRef.current) {
+      return;
+    }
+
+    const nextSignature = stringifyAgentBackedProfile(generatedCustomWorldProfile);
+    if (nextSignature === lastAutoSavedProfileSignatureRef.current) {
+      return;
+    }
+
+    setCustomWorldAutoSaveState('saving');
+    if (customWorldAutoSaveTimeoutRef.current !== null) {
+      window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
+    }
+
+    const profileToSave = generatedCustomWorldProfile;
+    customWorldAutoSaveTimeoutRef.current = window.setTimeout(() => {
+      void (async () => {
+        isCustomWorldAutoSaveBusyRef.current = true;
+        try {
+          let latestProfileToSave = normalizeAgentBackedProfile(profileToSave);
+          if (isAgentDraftResultView) {
+            const syncedResult =
+              await syncAgentDraftResultProfile(profileToSave);
+            // 作品库自动保存优先落同步后 session 重编译出的结果，避免继续保存旧的前端内存态。
+            latestProfileToSave = normalizeAgentBackedProfile(
+              syncedResult.profile ?? profileToSave,
+            );
+          }
+          await saveGeneratedCustomWorld(latestProfileToSave);
+        } catch (error) {
+          setCustomWorldAutoSaveState('error');
+          setCustomWorldAutoSaveError(
+            resolveRpgCreationErrorMessage(error, '保存自定义世界失败。'),
+          );
+        } finally {
+          isCustomWorldAutoSaveBusyRef.current = false;
+        }
+      })();
+      customWorldAutoSaveTimeoutRef.current = null;
+    }, 600);
+
+    return () => {
+      if (customWorldAutoSaveTimeoutRef.current !== null) {
+        window.clearTimeout(customWorldAutoSaveTimeoutRef.current);
+        customWorldAutoSaveTimeoutRef.current = null;
+      }
+    };
+  }, [
+    generatedCustomWorldProfile,
+    isAgentDraftResultView,
+    resetAutoSaveTrackingToIdle,
+    saveGeneratedCustomWorld,
+    selectionStage,
+    syncAgentDraftResultProfile,
+  ]);
+
+  return {
+    customWorldAutoSaveState,
+    setCustomWorldAutoSaveState,
+    customWorldAutoSaveError,
+    setCustomWorldAutoSaveError,
+    resetAutoSaveTrackingToIdle,
+    markAutoSavedProfile,
+    saveGeneratedCustomWorld,
+    syncAgentDraftResultProfile,
+    executeAgentActionAndWait,
+  };
+}
diff --git a/src/components/rpg-entry/useRpgCreationSessionController.ts b/src/components/rpg-entry/useRpgCreationSessionController.ts
new file mode 100644
index 00000000..3b65c4cf
--- /dev/null
+++ b/src/components/rpg-entry/useRpgCreationSessionController.ts
@@ -0,0 +1,570 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+
+import type {
+  CustomWorldAgentActionRequest,
+  CustomWorldAgentOperationRecord,
+  CustomWorldAgentSessionSnapshot,
+  SendCustomWorldAgentMessageRequest,
+} from '../../../packages/shared/src/contracts/customWorldAgent';
+import {
+  buildAgentDraftFoundationAnchorEntries,
+  buildAgentDraftFoundationGenerationProgress,
+  buildAgentDraftFoundationSettingText,
+  isDraftFoundationOperation,
+  isDraftFoundationOperationRunning,
+} from '../../services/customWorldAgentGenerationProgress';
+import {
+  readCustomWorldAgentUiState,
+  writeCustomWorldAgentUiState,
+} from '../../services/customWorldAgentUiState';
+import {
+  createRpgCreationSession,
+  executeRpgCreationAction,
+  getRpgCreationSession,
+  streamRpgCreationMessage,
+} from '../../services/rpg-creation';
+import { rpgCreationPreviewAdapter } from '../../services/rpg-creation/rpgCreationPreviewAdapter';
+import type { CustomWorldProfile } from '../../types';
+import {
+  buildOptimisticAgentMessage,
+  createFailedAgentOperation,
+  normalizeAgentBackedProfile,
+  resolveRpgCreationErrorMessage,
+} from './rpgEntryShared';
+import type {
+  CustomWorldGenerationViewSource,
+  CustomWorldResultViewSource,
+  SelectionStage,
+} from './rpgEntryTypes';
+
+type UseRpgCreationSessionControllerParams = {
+  userId: string | null | undefined;
+  openLoginModal?: ((postLoginAction?: (() => void) | null) => void) | undefined;
+  selectionStage: SelectionStage;
+  setSelectionStage: (stage: SelectionStage) => void;
+  enterCreateTab?: (() => void) | undefined;
+  onSessionOpened?: (() => void) | undefined;
+};
+
+export function useRpgCreationSessionController(
+  params: UseRpgCreationSessionControllerParams,
+) {
+  const {
+    userId,
+    openLoginModal,
+    selectionStage,
+    setSelectionStage,
+    enterCreateTab,
+    onSessionOpened,
+  } = params;
+  const initialAgentUiStateRef = useRef(readCustomWorldAgentUiState());
+  const hasAppliedInitialAgentWorkspaceRef = useRef(false);
+  const hasRequestedInitialAgentWorkspaceAuthRef = useRef(false);
+  const isAgentDraftResultAutoOpenSuppressedRef = useRef(false);
+
+  const [isCreatingAgentSession, setIsCreatingAgentSession] = useState(false);
+  const [activeAgentSessionId, setActiveAgentSessionId] = useState<
+    string | null
+  >(() => initialAgentUiStateRef.current.activeSessionId ?? null);
+  const [activeAgentOperationId, setActiveAgentOperationId] = useState<
+    string | null
+  >(() => initialAgentUiStateRef.current.activeOperationId ?? null);
+  const [agentSession, setAgentSession] =
+    useState<CustomWorldAgentSessionSnapshot | null>(null);
+  const [agentOperation, setAgentOperation] =
+    useState<CustomWorldAgentOperationRecord | null>(null);
+  const [streamingAgentReplyText, setStreamingAgentReplyText] = useState('');
+  const [isStreamingAgentReply, setIsStreamingAgentReply] = useState(false);
+  const [isLoadingAgentSession, setIsLoadingAgentSession] = useState(false);
+  const [creationTypeError, setCreationTypeError] = useState<string | null>(null);
+  const [generatedCustomWorldProfile, setGeneratedCustomWorldProfile] =
+    useState<CustomWorldProfile | null>(null);
+  const [customWorldError, setCustomWorldError] = useState<string | null>(null);
+  const [customWorldGenerationViewSource, setCustomWorldGenerationViewSource] =
+    useState<CustomWorldGenerationViewSource>(null);
+  const [customWorldResultViewSource, setCustomWorldResultViewSource] =
+    useState<CustomWorldResultViewSource>(null);
+  const [agentDraftGenerationStartedAt, setAgentDraftGenerationStartedAt] =
+    useState<number | null>(null);
+
+  const persistAgentUiState = useCallback(
+    (nextSessionId: string | null, nextOperationId: string | null) => {
+      setActiveAgentSessionId(nextSessionId);
+      setActiveAgentOperationId(nextOperationId);
+      writeCustomWorldAgentUiState({
+        activeSessionId: nextSessionId,
+        activeOperationId: nextOperationId,
+      });
+    },
+    [],
+  );
+
+  const syncAgentSessionSnapshot = useCallback(async (sessionId: string) => {
+    const nextSession = await getRpgCreationSession(sessionId);
+    setAgentSession(nextSession);
+    return nextSession;
+  }, []);
+
+  useEffect(() => {
+    const initialAgentSessionId = initialAgentUiStateRef.current.activeSessionId;
+
+    if (!initialAgentSessionId || hasAppliedInitialAgentWorkspaceRef.current) {
+      return;
+    }
+
+    enterCreateTab?.();
+
+    if (!userId) {
+      if (!hasRequestedInitialAgentWorkspaceAuthRef.current) {
+        hasRequestedInitialAgentWorkspaceAuthRef.current = true;
+        openLoginModal?.(() => {
+          setSelectionStage('agent-workspace');
+        });
+      }
+      return;
+    }
+
+    hasAppliedInitialAgentWorkspaceRef.current = true;
+    setSelectionStage('agent-workspace');
+  }, [enterCreateTab, openLoginModal, setSelectionStage, userId]);
+
+  useEffect(() => {
+    if (!activeAgentSessionId) {
+      setAgentSession(null);
+      setAgentOperation(null);
+      setIsLoadingAgentSession(false);
+      setStreamingAgentReplyText('');
+      setIsStreamingAgentReply(false);
+      return;
+    }
+
+    if (!userId) {
+      setAgentSession(null);
+      setAgentOperation(null);
+      setIsLoadingAgentSession(false);
+      setStreamingAgentReplyText('');
+      setIsStreamingAgentReply(false);
+      return;
+    }
+
+    let cancelled = false;
+    setIsLoadingAgentSession(true);
+
+    void syncAgentSessionSnapshot(activeAgentSessionId)
+      .then(() => {
+        if (!cancelled) {
+          setCreationTypeError(null);
+        }
+      })
+      .catch((error) => {
+        if (cancelled) {
+          return;
+        }
+
+        setCreationTypeError(
+          resolveRpgCreationErrorMessage(error, '读取 Agent 共创工作区失败。'),
+        );
+        setAgentSession(null);
+        setAgentOperation(null);
+        setStreamingAgentReplyText('');
+        setIsStreamingAgentReply(false);
+        persistAgentUiState(null, null);
+        enterCreateTab?.();
+        setSelectionStage('platform');
+      })
+      .finally(() => {
+        if (!cancelled) {
+          setIsLoadingAgentSession(false);
+        }
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [
+    activeAgentSessionId,
+    enterCreateTab,
+    persistAgentUiState,
+    setSelectionStage,
+    syncAgentSessionSnapshot,
+    userId,
+  ]);
+
+  useEffect(() => {
+    if (
+      !isDraftFoundationOperationRunning(agentOperation) ||
+      agentDraftGenerationStartedAt
+    ) {
+      return;
+    }
+
+    setAgentDraftGenerationStartedAt(Date.now());
+  }, [agentDraftGenerationStartedAt, agentOperation]);
+
+  useEffect(() => {
+    if (
+      selectionStage !== 'custom-world-generating' ||
+      customWorldGenerationViewSource !== 'agent-draft-foundation' ||
+      !isDraftFoundationOperation(agentOperation) ||
+      agentOperation.status !== 'completed'
+    ) {
+      return;
+    }
+
+    let cancelled = false;
+    const timeoutId = window.setTimeout(() => {
+      void (async () => {
+        const latestSession = activeAgentSessionId
+          ? await syncAgentSessionSnapshot(activeAgentSessionId).catch(
+              () => null,
+            )
+          : agentSession;
+
+        if (cancelled) {
+          return;
+        }
+
+        const draftResultProfile =
+          rpgCreationPreviewAdapter.buildPreviewFromSession(
+            latestSession ?? agentSession,
+          );
+        if (!draftResultProfile) {
+          setAgentDraftGenerationStartedAt(null);
+          setCustomWorldGenerationViewSource(null);
+          setSelectionStage('agent-workspace');
+          return;
+        }
+
+        setGeneratedCustomWorldProfile(
+          normalizeAgentBackedProfile(draftResultProfile),
+        );
+        setAgentDraftGenerationStartedAt(null);
+        setCustomWorldGenerationViewSource(null);
+        setCustomWorldResultViewSource('agent-draft');
+        setSelectionStage('custom-world-result');
+      })();
+    }, 900);
+
+    return () => {
+      cancelled = true;
+      window.clearTimeout(timeoutId);
+    };
+  }, [
+    activeAgentSessionId,
+    agentOperation,
+    agentSession,
+    customWorldGenerationViewSource,
+    selectionStage,
+    setSelectionStage,
+    syncAgentSessionSnapshot,
+  ]);
+
+  const agentDraftSettingPreview = useMemo(
+    () => buildAgentDraftFoundationSettingText(agentSession),
+    [agentSession],
+  );
+  const agentDraftAnchorPreviewEntries = useMemo(
+    () => buildAgentDraftFoundationAnchorEntries(agentSession),
+    [agentSession],
+  );
+  const agentDraftResultProfile = useMemo(
+    () => rpgCreationPreviewAdapter.buildPreviewFromSession(agentSession),
+    [agentSession],
+  );
+  const shouldAutoOpenAgentDraftResult = useMemo(
+    () =>
+      Boolean(
+        agentDraftResultProfile &&
+          agentSession &&
+          (agentSession.stage === 'object_refining' ||
+            agentSession.stage === 'visual_refining' ||
+            agentSession.stage === 'long_tail_review' ||
+            agentSession.stage === 'ready_to_publish' ||
+            agentSession.stage === 'published') &&
+          agentSession.draftCards.length > 0,
+      ),
+    [agentDraftResultProfile, agentSession],
+  );
+
+  const agentDraftGenerationProgress = useMemo(
+    () =>
+      buildAgentDraftFoundationGenerationProgress(
+        agentOperation,
+        agentDraftGenerationStartedAt,
+      ),
+    [agentDraftGenerationStartedAt, agentOperation],
+  );
+
+  const isAgentDraftGenerationView =
+    customWorldGenerationViewSource === 'agent-draft-foundation';
+  const isAgentDraftResultView = customWorldResultViewSource === 'agent-draft';
+  const isActiveGenerationRunning =
+    isDraftFoundationOperationRunning(agentOperation);
+  const activeGenerationError =
+    isDraftFoundationOperation(agentOperation) &&
+    agentOperation.status === 'failed'
+      ? agentOperation.error || agentOperation.phaseDetail
+      : null;
+
+  useEffect(() => {
+    if (!shouldAutoOpenAgentDraftResult || !agentDraftResultProfile) {
+      return;
+    }
+
+    if (isAgentDraftResultAutoOpenSuppressedRef.current) {
+      return;
+    }
+
+    if (selectionStage === 'agent-workspace') {
+      setGeneratedCustomWorldProfile(agentDraftResultProfile);
+      setCustomWorldResultViewSource('agent-draft');
+      isAgentDraftResultAutoOpenSuppressedRef.current = false;
+      setSelectionStage('custom-world-result');
+      return;
+    }
+
+    if (
+      selectionStage === 'custom-world-result' &&
+      !generatedCustomWorldProfile
+    ) {
+      setGeneratedCustomWorldProfile(agentDraftResultProfile);
+      setCustomWorldResultViewSource('agent-draft');
+      isAgentDraftResultAutoOpenSuppressedRef.current = false;
+    }
+  }, [
+    agentDraftResultProfile,
+    generatedCustomWorldProfile,
+    selectionStage,
+    setSelectionStage,
+    shouldAutoOpenAgentDraftResult,
+  ]);
+
+  const openRpgAgentWorkspace = useCallback(
+    async (seedText = '') => {
+      if (isCreatingAgentSession) {
+        return;
+      }
+
+      setIsCreatingAgentSession(true);
+      setCreationTypeError(null);
+      isAgentDraftResultAutoOpenSuppressedRef.current = false;
+
+      try {
+        const { session } = await createRpgCreationSession(
+          seedText ? { seedText } : {},
+        );
+        setAgentSession(session);
+        setAgentOperation(null);
+        setGeneratedCustomWorldProfile(null);
+        setCustomWorldError(null);
+        setAgentDraftGenerationStartedAt(null);
+        setCustomWorldGenerationViewSource(null);
+        setCustomWorldResultViewSource(null);
+        enterCreateTab?.();
+        onSessionOpened?.();
+        persistAgentUiState(session.sessionId, null);
+        setSelectionStage('agent-workspace');
+      } catch (error) {
+        setCreationTypeError(
+          resolveRpgCreationErrorMessage(error, '开启共创工作台失败。'),
+        );
+      } finally {
+        setIsCreatingAgentSession(false);
+      }
+    },
+    [
+      enterCreateTab,
+      isCreatingAgentSession,
+      onSessionOpened,
+      persistAgentUiState,
+      setSelectionStage,
+    ],
+  );
+
+  const submitAgentMessage = useCallback(
+    async (payload: SendCustomWorldAgentMessageRequest) => {
+      if (!activeAgentSessionId) {
+        return;
+      }
+
+      const optimisticUserMessage = buildOptimisticAgentMessage({
+        id: payload.clientMessageId,
+        role: 'user',
+        kind: 'chat',
+        text: payload.text.trim(),
+      });
+
+      setAgentOperation(null);
+      persistAgentUiState(activeAgentSessionId, null);
+      setStreamingAgentReplyText('');
+      setIsStreamingAgentReply(true);
+      setAgentSession((current) =>
+        current
+          ? {
+              ...current,
+              messages: [...current.messages, optimisticUserMessage],
+              updatedAt: optimisticUserMessage.createdAt,
+            }
+          : current,
+      );
+
+      try {
+        const nextSession = await streamRpgCreationMessage(
+          activeAgentSessionId,
+          payload,
+          {
+            onUpdate: (text) => {
+              setStreamingAgentReplyText(text);
+            },
+          },
+        );
+        setAgentSession(nextSession);
+        setAgentOperation(null);
+        setStreamingAgentReplyText('');
+      } catch (error) {
+        const errorMessage = resolveRpgCreationErrorMessage(
+          error,
+          '发送共创消息失败。',
+        );
+        setAgentSession((current) =>
+          current
+            ? {
+                ...current,
+                messages: [
+                  ...current.messages,
+                  buildOptimisticAgentMessage({
+                    id: `message-error-${Date.now()}`,
+                    role: 'assistant',
+                    kind: 'warning',
+                    text: errorMessage,
+                  }),
+                ],
+                updatedAt: new Date().toISOString(),
+              }
+            : current,
+        );
+        setStreamingAgentReplyText('');
+        persistAgentUiState(activeAgentSessionId, null);
+      } finally {
+        setIsStreamingAgentReply(false);
+      }
+    },
+    [activeAgentSessionId, persistAgentUiState],
+  );
+
+  const executeAgentAction = useCallback(
+    async (payload: CustomWorldAgentActionRequest) => {
+      if (!activeAgentSessionId) {
+        return;
+      }
+
+      const isDraftFoundationAction = payload.action === 'draft_foundation';
+
+      if (isDraftFoundationAction) {
+        isAgentDraftResultAutoOpenSuppressedRef.current = false;
+        setGeneratedCustomWorldProfile(null);
+        setCustomWorldError(null);
+        setCustomWorldGenerationViewSource('agent-draft-foundation');
+        setCustomWorldResultViewSource(null);
+        setAgentDraftGenerationStartedAt(Date.now());
+        setSelectionStage('custom-world-generating');
+      }
+
+      try {
+        const { operation } = await executeRpgCreationAction(
+          activeAgentSessionId,
+          payload,
+        );
+        setAgentOperation(operation);
+        persistAgentUiState(activeAgentSessionId, operation.operationId);
+      } catch (error) {
+        const errorMessage = resolveRpgCreationErrorMessage(
+          error,
+          '执行共创操作失败。',
+        );
+        setAgentOperation(
+          createFailedAgentOperation({
+            type:
+              payload.action === 'draft_foundation'
+                ? 'draft_foundation'
+                : payload.action,
+            phaseLabel: '执行操作失败',
+            error: errorMessage,
+          }),
+        );
+        persistAgentUiState(activeAgentSessionId, null);
+      }
+    },
+    [activeAgentSessionId, persistAgentUiState, setSelectionStage],
+  );
+
+  const setNormalizedGeneratedCustomWorldProfile = useCallback(
+    (profile: CustomWorldProfile | null) => {
+      setGeneratedCustomWorldProfile(
+        profile ? normalizeAgentBackedProfile(profile) : null,
+      );
+    },
+    [],
+  );
+
+  const resetSessionViewState = useCallback(() => {
+    setAgentOperation(null);
+    setStreamingAgentReplyText('');
+    setIsStreamingAgentReply(false);
+    setAgentDraftGenerationStartedAt(null);
+    setCustomWorldGenerationViewSource(null);
+    setCustomWorldResultViewSource(null);
+  }, []);
+
+  const suppressAgentDraftResultAutoOpen = useCallback(() => {
+    isAgentDraftResultAutoOpenSuppressedRef.current = true;
+  }, []);
+
+  const releaseAgentDraftResultAutoOpenSuppression = useCallback(() => {
+    isAgentDraftResultAutoOpenSuppressedRef.current = false;
+  }, []);
+
+  return {
+    initialAgentSessionId: initialAgentUiStateRef.current.activeSessionId ?? null,
+    isCreatingAgentSession,
+    activeAgentSessionId,
+    activeAgentOperationId,
+    agentSession,
+    setAgentSession,
+    agentOperation,
+    setAgentOperation,
+    resetSessionViewState,
+    streamingAgentReplyText,
+    isStreamingAgentReply,
+    isLoadingAgentSession,
+    creationTypeError,
+    setCreationTypeError,
+    customWorldError,
+    setCustomWorldError,
+    generatedCustomWorldProfile,
+    setGeneratedCustomWorldProfile: setNormalizedGeneratedCustomWorldProfile,
+    rawSetGeneratedCustomWorldProfile: setGeneratedCustomWorldProfile,
+    customWorldGenerationViewSource,
+    setCustomWorldGenerationViewSource,
+    customWorldResultViewSource,
+    setCustomWorldResultViewSource,
+    agentDraftGenerationStartedAt,
+    setAgentDraftGenerationStartedAt,
+    agentDraftSettingPreview,
+    agentDraftAnchorPreviewEntries,
+    agentDraftResultProfile,
+    agentDraftGenerationProgress,
+    isAgentDraftGenerationView,
+    isAgentDraftResultView,
+    isActiveGenerationRunning,
+    activeGenerationError,
+    isAgentDraftResultAutoOpenSuppressedRef,
+    suppressAgentDraftResultAutoOpen,
+    releaseAgentDraftResultAutoOpenSuppression,
+    persistAgentUiState,
+    syncAgentSessionSnapshot,
+    openRpgAgentWorkspace,
+    submitAgentMessage,
+    executeAgentAction,
+  };
+}
diff --git a/src/components/rpg-entry/useRpgEntryBootstrap.ts b/src/components/rpg-entry/useRpgEntryBootstrap.ts
new file mode 100644
index 00000000..462bb6e2
--- /dev/null
+++ b/src/components/rpg-entry/useRpgEntryBootstrap.ts
@@ -0,0 +1,346 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+import type {
+  CustomWorldWorkSummary,
+} from '../../../packages/shared/src/contracts/customWorldAgent';
+import type {
+  CustomWorldGalleryCard,
+  CustomWorldLibraryEntry,
+  PlatformBrowseHistoryEntry,
+  PlatformBrowseHistoryWriteEntry,
+  ProfileDashboardSummary,
+  ProfileSaveArchiveSummary,
+} from '../../../packages/shared/src/contracts/runtime';
+import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
+import type { AuthUser } from '../../services/authService';
+import { listRpgCreationWorks } from '../../services/rpg-creation/index';
+import {
+  listRpgEntryWorldGallery,
+  listRpgEntryWorldLibrary,
+  listRpgProfileBrowseHistory,
+  listRpgProfileSaveArchives,
+  resumeRpgProfileSaveArchive,
+  upsertRpgProfileBrowseHistory,
+} from '../../services/rpg-entry';
+import type { CustomWorldProfile } from '../../types';
+import type { PlatformHomeTab } from './RpgEntryHomeView';
+import { resolveRpgEntryErrorMessage } from './rpgEntryShared';
+
+type UseRpgEntryBootstrapParams = {
+  user: AuthUser | null | undefined;
+  getProfileDashboard: () => Promise<ProfileDashboardSummary | null>;
+  handleContinueGame: (
+    snapshot?: HydratedSavedGameSnapshot | null,
+  ) => void;
+  hasInitialAgentSession: boolean;
+};
+
+export function useRpgEntryBootstrap(
+  params: UseRpgEntryBootstrapParams,
+) {
+  const { user, getProfileDashboard, handleContinueGame, hasInitialAgentSession } =
+    params;
+  const isAuthenticated = Boolean(user);
+  const platformTabBootstrapUserIdRef = useRef<string | null | undefined>(
+    undefined,
+  );
+
+  const [savedCustomWorldEntries, setSavedCustomWorldEntries] = useState<
+    CustomWorldLibraryEntry<CustomWorldProfile>[]
+  >([]);
+  const [customWorldWorkEntries, setCustomWorldWorkEntries] = useState<
+    CustomWorldWorkSummary[]
+  >([]);
+  const [publishedGalleryEntries, setPublishedGalleryEntries] = useState<
+    CustomWorldGalleryCard[]
+  >([]);
+  const [historyEntries, setHistoryEntries] = useState<
+    PlatformBrowseHistoryEntry[]
+  >([]);
+  const [saveEntries, setSaveEntries] = useState<ProfileSaveArchiveSummary[]>([]);
+  const [platformTab, setPlatformTab] = useState<PlatformHomeTab>('home');
+  const [platformError, setPlatformError] = useState<string | null>(null);
+  const [dashboardError, setDashboardError] = useState<string | null>(null);
+  const [historyError, setHistoryError] = useState<string | null>(null);
+  const [saveError, setSaveError] = useState<string | null>(null);
+  const [isLoadingPlatform, setIsLoadingPlatform] = useState(false);
+  const [isLoadingDashboard, setIsLoadingDashboard] = useState(false);
+  const [isResumingSaveWorldKey, setIsResumingSaveWorldKey] = useState<
+    string | null
+  >(null);
+  const [profileDashboard, setProfileDashboard] =
+    useState<ProfileDashboardSummary | null>(null);
+
+  const refreshProfileDashboard = useCallback(async () => {
+    if (!user) {
+      setProfileDashboard(null);
+      setDashboardError(null);
+      setIsLoadingDashboard(false);
+      return;
+    }
+
+    setIsLoadingDashboard(true);
+    setDashboardError(null);
+
+    try {
+      setProfileDashboard(await getProfileDashboard());
+    } catch (error) {
+      setDashboardError(
+        resolveRpgEntryErrorMessage(error, '读取个人数据看板失败。'),
+      );
+    } finally {
+      setIsLoadingDashboard(false);
+    }
+  }, [getProfileDashboard, user]);
+
+  const refreshCustomWorldWorks = useCallback(async () => {
+    if (!user) {
+      setCustomWorldWorkEntries([]);
+      return [];
+    }
+
+    const nextItems = await listRpgCreationWorks();
+    setCustomWorldWorkEntries(nextItems);
+    return nextItems;
+  }, [user]);
+
+  const refreshPublishedGallery = useCallback(async () => {
+    const nextEntries = await listRpgEntryWorldGallery();
+    setPublishedGalleryEntries(nextEntries);
+    return nextEntries;
+  }, []);
+
+  const refreshSavedCustomWorldLibrary = useCallback(async () => {
+    if (!user) {
+      setSavedCustomWorldEntries([]);
+      return [];
+    }
+
+    const nextEntries = await listRpgEntryWorldLibrary();
+    setSavedCustomWorldEntries(nextEntries);
+    return nextEntries;
+  }, [user]);
+
+  const appendBrowseHistoryEntry = useCallback(
+    async (entry: PlatformBrowseHistoryWriteEntry) => {
+      setHistoryError(null);
+
+      try {
+        const syncedEntries = await upsertRpgProfileBrowseHistory(entry);
+        setHistoryEntries(syncedEntries);
+      } catch (error) {
+        setHistoryError(
+          resolveRpgEntryErrorMessage(error, '写入浏览历史失败。'),
+        );
+      }
+    },
+    [],
+  );
+
+  const handleResumeSaveEntry = useCallback(
+    async (entry: ProfileSaveArchiveSummary) => {
+      if (!user || isResumingSaveWorldKey) {
+        return;
+      }
+
+      setIsResumingSaveWorldKey(entry.worldKey);
+      setSaveError(null);
+
+      try {
+        const resumedArchive = await resumeRpgProfileSaveArchive(entry.worldKey);
+        setSaveEntries((currentEntries) =>
+          currentEntries.map((currentEntry) =>
+            currentEntry.worldKey === resumedArchive.entry.worldKey
+              ? resumedArchive.entry
+              : currentEntry,
+          ),
+        );
+        handleContinueGame(resumedArchive.snapshot);
+      } catch (error) {
+        setSaveError(resolveRpgEntryErrorMessage(error, '恢复存档失败。'));
+      } finally {
+        setIsResumingSaveWorldKey(null);
+      }
+    },
+    [handleContinueGame, isResumingSaveWorldKey, user],
+  );
+
+  useEffect(() => {
+    let isActive = true;
+
+    void (async () => {
+      setHistoryEntries([]);
+      setHistoryError(null);
+      setSaveError(null);
+      setIsLoadingPlatform(true);
+      setPlatformError(null);
+      setIsLoadingDashboard(isAuthenticated);
+      setDashboardError(null);
+      if (!isAuthenticated) {
+        setSavedCustomWorldEntries([]);
+        setCustomWorldWorkEntries([]);
+        setSaveEntries([]);
+        setProfileDashboard(null);
+      }
+
+      try {
+        const [
+          libraryEntriesResult,
+          workEntriesResult,
+          galleryEntriesResult,
+          dashboardResult,
+          historyResult,
+          saveArchivesResult,
+        ] = await Promise.allSettled([
+          isAuthenticated
+            ? listRpgEntryWorldLibrary()
+            : Promise.resolve([]),
+          isAuthenticated
+            ? listRpgCreationWorks()
+            : Promise.resolve([]),
+          listRpgEntryWorldGallery(),
+          isAuthenticated ? getProfileDashboard() : Promise.resolve(null),
+          isAuthenticated ? listRpgProfileBrowseHistory() : Promise.resolve([]),
+          isAuthenticated ? listRpgProfileSaveArchives() : Promise.resolve([]),
+        ]);
+
+        if (!isActive) {
+          return;
+        }
+
+        if (libraryEntriesResult.status === 'fulfilled') {
+          setSavedCustomWorldEntries(libraryEntriesResult.value);
+        } else {
+          setSavedCustomWorldEntries([]);
+        }
+
+        if (workEntriesResult.status === 'fulfilled') {
+          setCustomWorldWorkEntries(workEntriesResult.value);
+        } else {
+          setCustomWorldWorkEntries([]);
+        }
+
+        if (galleryEntriesResult.status === 'fulfilled') {
+          setPublishedGalleryEntries(galleryEntriesResult.value);
+        } else {
+          setPublishedGalleryEntries([]);
+        }
+
+        if (
+          (isAuthenticated && libraryEntriesResult.status === 'rejected') ||
+          (isAuthenticated && workEntriesResult.status === 'rejected') ||
+          galleryEntriesResult.status === 'rejected'
+        ) {
+          const platformFailure =
+            libraryEntriesResult.status === 'rejected'
+              ? libraryEntriesResult.reason
+              : workEntriesResult.status === 'rejected'
+                ? workEntriesResult.reason
+                : galleryEntriesResult.status === 'rejected'
+                  ? galleryEntriesResult.reason
+                  : null;
+          setPlatformError(
+            resolveRpgEntryErrorMessage(platformFailure, '读取平台数据失败。'),
+          );
+        }
+
+        if (dashboardResult.status === 'fulfilled') {
+          setProfileDashboard(dashboardResult.value);
+        } else if (isAuthenticated) {
+          setProfileDashboard(null);
+          setDashboardError(
+            resolveRpgEntryErrorMessage(
+              dashboardResult.reason,
+              '读取个人数据看板失败。',
+            ),
+          );
+        }
+
+        if (historyResult.status === 'fulfilled') {
+          setHistoryEntries(historyResult.value);
+        } else if (isAuthenticated) {
+          setHistoryError(
+            resolveRpgEntryErrorMessage(historyResult.reason, '读取浏览历史失败。'),
+          );
+        }
+
+        if (saveArchivesResult.status === 'fulfilled') {
+          setSaveEntries(saveArchivesResult.value);
+        } else if (isAuthenticated) {
+          setSaveEntries([]);
+          setSaveError(
+            resolveRpgEntryErrorMessage(
+              saveArchivesResult.reason,
+              '读取存档列表失败。',
+            ),
+          );
+        }
+
+        const nextPlatformBootstrapUserId = user?.id ?? null;
+        if (
+          platformTabBootstrapUserIdRef.current !== nextPlatformBootstrapUserId
+        ) {
+          platformTabBootstrapUserIdRef.current = nextPlatformBootstrapUserId;
+          if (!hasInitialAgentSession) {
+            setPlatformTab(
+              isAuthenticated &&
+                saveArchivesResult.status === 'fulfilled' &&
+                saveArchivesResult.value.length > 0
+                ? 'saves'
+                : 'home',
+            );
+          }
+        }
+      } finally {
+        if (isActive) {
+          setIsLoadingPlatform(false);
+          setIsLoadingDashboard(false);
+        }
+      }
+    })();
+
+    return () => {
+      isActive = false;
+    };
+  }, [getProfileDashboard, hasInitialAgentSession, isAuthenticated, user]);
+
+  return {
+    isAuthenticated,
+    platformTab,
+    setPlatformTab,
+    savedCustomWorldEntries,
+    setSavedCustomWorldEntries,
+    customWorldWorkEntries,
+    setCustomWorldWorkEntries,
+    publishedGalleryEntries,
+    setPublishedGalleryEntries,
+    historyEntries,
+    setHistoryEntries,
+    saveEntries,
+    setSaveEntries,
+    platformError,
+    setPlatformError,
+    dashboardError,
+    setDashboardError,
+    historyError,
+    setHistoryError,
+    saveError,
+    setSaveError,
+    isLoadingPlatform,
+    isLoadingDashboard,
+    isResumingSaveWorldKey,
+    profileDashboard,
+    setProfileDashboard,
+    refreshProfileDashboard,
+    refreshCustomWorldWorks,
+    refreshPublishedGallery,
+    refreshSavedCustomWorldLibrary,
+    appendBrowseHistoryEntry,
+    handleResumeSaveEntry,
+  };
+}
+
+/**
+ * 兼容旧创作链命名，避免并行工作包在本轮迁移后断开导入。
+ */
+export const useRpgCreationPlatformBootstrap = useRpgEntryBootstrap;
diff --git a/src/components/rpg-entry/useRpgEntryCharacterSelect.ts b/src/components/rpg-entry/useRpgEntryCharacterSelect.ts
new file mode 100644
index 00000000..4a118fd3
--- /dev/null
+++ b/src/components/rpg-entry/useRpgEntryCharacterSelect.ts
@@ -0,0 +1,46 @@
+import { useCallback } from 'react';
+
+import type { Character, CustomWorldProfile, GameState } from '../../types';
+
+type UseRpgEntryCharacterSelectParams = {
+  gameState: GameState;
+  handleBackToWorldSelect: () => void;
+  setSelectionStage: (stage: 'platform') => void;
+  handleCharacterSelect: (character: NonNullable<GameState['playerCharacter']>) => void;
+};
+
+/**
+ * 统一角色选择页的返回与确认动作，保持主阶段路由器里只做装配。
+ */
+export function useRpgEntryCharacterSelect(
+  params: UseRpgEntryCharacterSelectParams,
+) {
+  const {
+    gameState,
+    handleBackToWorldSelect,
+    setSelectionStage,
+    handleCharacterSelect,
+  } = params;
+
+  const customWorldProfile: CustomWorldProfile | null =
+    gameState.customWorldProfile;
+
+  const handleBack = useCallback(() => {
+    handleBackToWorldSelect();
+    setSelectionStage('platform');
+  }, [handleBackToWorldSelect, setSelectionStage]);
+
+  const handleConfirm = useCallback(
+    (character: Character) => {
+      handleCharacterSelect(character);
+    },
+    [handleCharacterSelect],
+  );
+
+  return {
+    worldType: gameState.worldType,
+    customWorldProfile,
+    handleBack,
+    handleConfirm,
+  };
+}
diff --git a/src/components/rpg-entry/useRpgEntryLibraryDetail.ts b/src/components/rpg-entry/useRpgEntryLibraryDetail.ts
new file mode 100644
index 00000000..e47c0cfb
--- /dev/null
+++ b/src/components/rpg-entry/useRpgEntryLibraryDetail.ts
@@ -0,0 +1,444 @@
+import { useCallback, useEffect, useState } from 'react';
+
+import type {
+  CustomWorldAgentSessionSnapshot,
+  CustomWorldWorkSummary,
+} from '../../../packages/shared/src/contracts/customWorldAgent';
+import type {
+  CustomWorldGalleryCard,
+  CustomWorldLibraryEntry,
+  PlatformBrowseHistoryWriteEntry,
+} from '../../../packages/shared/src/contracts/runtime';
+import {
+  deleteRpgEntryWorldProfile,
+  getRpgEntryWorldGalleryDetail,
+  listRpgEntryWorldLibrary,
+  publishRpgEntryWorldProfile,
+  unpublishRpgEntryWorldProfile,
+} from '../../services/rpg-entry';
+import type { CustomWorldProfile } from '../../types';
+import {
+  normalizeRpgEntryAgentBackedProfile,
+  resolveRpgEntryErrorMessage,
+} from './rpgEntryShared';
+import type {
+  CustomWorldAutoSaveState,
+  CustomWorldGenerationViewSource,
+  CustomWorldResultViewSource,
+  SelectionStage,
+} from './rpgEntryTypes';
+
+type UseRpgEntryLibraryDetailParams = {
+  userId: string | null | undefined;
+  selectedDetailEntry: CustomWorldLibraryEntry<CustomWorldProfile> | null;
+  setSelectedDetailEntry: (
+    entry:
+      | CustomWorldLibraryEntry<CustomWorldProfile>
+      | null
+      | ((
+          current: CustomWorldLibraryEntry<CustomWorldProfile> | null,
+        ) => CustomWorldLibraryEntry<CustomWorldProfile> | null),
+  ) => void;
+  savedCustomWorldEntries: CustomWorldLibraryEntry<CustomWorldProfile>[];
+  setSavedCustomWorldEntries: (
+    entries: CustomWorldLibraryEntry<CustomWorldProfile>[],
+  ) => void;
+  setGeneratedCustomWorldProfile: (
+    profile: CustomWorldProfile | null,
+  ) => void;
+  setCustomWorldError: (error: string | null) => void;
+  setCustomWorldAutoSaveError: (error: string | null) => void;
+  setCustomWorldAutoSaveState: (state: CustomWorldAutoSaveState) => void;
+  setCustomWorldGenerationViewSource: (
+    source: CustomWorldGenerationViewSource,
+  ) => void;
+  setCustomWorldResultViewSource: (
+    source: CustomWorldResultViewSource,
+  ) => void;
+  setSelectionStage: (stage: SelectionStage) => void;
+  setPlatformTabToCreate: () => void;
+  setPlatformError: (error: string | null) => void;
+  appendBrowseHistoryEntry: (
+    entry: PlatformBrowseHistoryWriteEntry,
+  ) => Promise<void>;
+  refreshCustomWorldWorks: () => Promise<unknown>;
+  refreshPublishedGallery: () => Promise<unknown>;
+  persistAgentUiState: (
+    sessionId: string | null,
+    operationId: string | null,
+  ) => void;
+  syncAgentSessionSnapshot: (
+    sessionId: string,
+  ) => Promise<CustomWorldAgentSessionSnapshot | null>;
+  buildDraftResultProfile: (
+    session: CustomWorldAgentSessionSnapshot | null,
+  ) => CustomWorldProfile | null;
+  suppressAgentDraftResultAutoOpen: () => void;
+  releaseAgentDraftResultAutoOpenSuppression: () => void;
+  resetAutoSaveTrackingToIdle: () => void;
+  markAutoSavedProfile: (profile: CustomWorldProfile) => void;
+};
+
+/**
+ * 负责平台详情、创作作品入口和结果页打开路径。
+ * 平台壳层只消费“打开哪个面板”的结果，不再自己拼接恢复流程细节。
+ */
+export function useRpgEntryLibraryDetail(
+  params: UseRpgEntryLibraryDetailParams,
+) {
+  const {
+    userId,
+    selectedDetailEntry,
+    setSelectedDetailEntry,
+    savedCustomWorldEntries,
+    setSavedCustomWorldEntries,
+    setGeneratedCustomWorldProfile,
+    setCustomWorldError,
+    setCustomWorldAutoSaveError,
+    setCustomWorldAutoSaveState,
+    setCustomWorldGenerationViewSource,
+    setCustomWorldResultViewSource,
+    setSelectionStage,
+    setPlatformTabToCreate,
+    setPlatformError,
+    appendBrowseHistoryEntry,
+    refreshCustomWorldWorks,
+    refreshPublishedGallery,
+    persistAgentUiState,
+    syncAgentSessionSnapshot,
+    buildDraftResultProfile,
+    suppressAgentDraftResultAutoOpen,
+    releaseAgentDraftResultAutoOpenSuppression,
+    resetAutoSaveTrackingToIdle,
+    markAutoSavedProfile,
+  } = params;
+
+  const [detailError, setDetailError] = useState<string | null>(null);
+  const [isDetailLoading, setIsDetailLoading] = useState(false);
+  const [isMutatingDetail, setIsMutatingDetail] = useState(false);
+
+  useEffect(() => {
+    if (!selectedDetailEntry) {
+      return;
+    }
+
+    const nextOwnedEntry = savedCustomWorldEntries.find(
+      (entry) =>
+        entry.ownerUserId === selectedDetailEntry.ownerUserId &&
+        entry.profileId === selectedDetailEntry.profileId,
+    );
+    if (nextOwnedEntry && nextOwnedEntry !== selectedDetailEntry) {
+      setSelectedDetailEntry(nextOwnedEntry);
+    }
+  }, [savedCustomWorldEntries, selectedDetailEntry, setSelectedDetailEntry]);
+
+  const openLibraryDetail = useCallback(
+    (entry: CustomWorldLibraryEntry<CustomWorldProfile>) => {
+      if (entry.visibility === 'published') {
+        void appendBrowseHistoryEntry({
+          ownerUserId: entry.ownerUserId,
+          profileId: entry.profileId,
+          worldName: entry.worldName,
+          subtitle: entry.subtitle,
+          summaryText: entry.summaryText,
+          coverImageSrc: entry.coverImageSrc,
+          themeMode: entry.themeMode,
+          authorDisplayName: entry.authorDisplayName,
+        });
+      }
+      setSelectedDetailEntry(entry);
+      setDetailError(null);
+      setSelectionStage('detail');
+    },
+    [appendBrowseHistoryEntry, setSelectedDetailEntry, setSelectionStage],
+  );
+
+  const openGalleryDetail = useCallback(
+    async (entry: CustomWorldGalleryCard) => {
+      setSelectionStage('detail');
+      setIsDetailLoading(true);
+      setDetailError(null);
+
+      try {
+        const detailEntry = await getRpgEntryWorldGalleryDetail(
+          entry.ownerUserId,
+          entry.profileId,
+        );
+        setSelectedDetailEntry(detailEntry);
+        void appendBrowseHistoryEntry({
+          ownerUserId: detailEntry.ownerUserId,
+          profileId: detailEntry.profileId,
+          worldName: detailEntry.worldName,
+          subtitle: detailEntry.subtitle,
+          summaryText: detailEntry.summaryText,
+          coverImageSrc: detailEntry.coverImageSrc,
+          themeMode: detailEntry.themeMode,
+          authorDisplayName: detailEntry.authorDisplayName,
+        });
+      } catch (error) {
+        setSelectedDetailEntry(null);
+        setDetailError(
+          resolveRpgEntryErrorMessage(error, '读取作品详情失败。'),
+        );
+      } finally {
+        setIsDetailLoading(false);
+      }
+    },
+    [appendBrowseHistoryEntry, setSelectedDetailEntry, setSelectionStage],
+  );
+
+  const openSavedCustomWorldEditor = useCallback(
+    (entry: CustomWorldLibraryEntry<CustomWorldProfile>) => {
+      setSelectedDetailEntry(entry);
+      const normalizedProfile = normalizeRpgEntryAgentBackedProfile(
+        entry.profile,
+      );
+      setGeneratedCustomWorldProfile(normalizedProfile);
+      markAutoSavedProfile(normalizedProfile);
+      setCustomWorldAutoSaveState('saved');
+      setCustomWorldAutoSaveError(null);
+      setCustomWorldError(null);
+      setCustomWorldGenerationViewSource(null);
+      setCustomWorldResultViewSource('saved-profile');
+      setSelectionStage('custom-world-result');
+    },
+    [
+      markAutoSavedProfile,
+      setCustomWorldAutoSaveError,
+      setCustomWorldAutoSaveState,
+      setCustomWorldError,
+      setCustomWorldGenerationViewSource,
+      setCustomWorldResultViewSource,
+      setGeneratedCustomWorldProfile,
+      setSelectedDetailEntry,
+      setSelectionStage,
+    ],
+  );
+
+  const handleOpenCreationWork = useCallback(
+    async (work: CustomWorldWorkSummary) => {
+      if (work.status === 'draft' && work.sessionId) {
+        persistAgentUiState(work.sessionId, null);
+        setCustomWorldError(null);
+        setCustomWorldAutoSaveError(null);
+        setCustomWorldAutoSaveState('idle');
+        setCustomWorldGenerationViewSource(null);
+        resetAutoSaveTrackingToIdle();
+
+        const shouldOpenAgentWorkspace =
+          work.playableNpcCount <= 0 && work.landmarkCount <= 0;
+
+        if (shouldOpenAgentWorkspace) {
+          // 仅八锚点未整理成底稿时才恢复 Agent 对话工作区。
+          suppressAgentDraftResultAutoOpen();
+          setGeneratedCustomWorldProfile(null);
+          setCustomWorldResultViewSource(null);
+          setPlatformTabToCreate();
+          setSelectionStage('agent-workspace');
+          return;
+        }
+
+        releaseAgentDraftResultAutoOpenSuppression();
+        const latestSession = await syncAgentSessionSnapshot(work.sessionId);
+        const nextProfile = buildDraftResultProfile(latestSession);
+        if (!nextProfile) {
+          setPlatformError('当前草稿还没有可编辑的结果页数据，请先继续补齐锚点。');
+          setPlatformTabToCreate();
+          setSelectionStage('agent-workspace');
+          return;
+        }
+
+        setGeneratedCustomWorldProfile(
+          normalizeRpgEntryAgentBackedProfile(nextProfile),
+        );
+        setCustomWorldResultViewSource('agent-draft');
+        setPlatformTabToCreate();
+        setSelectionStage('custom-world-result');
+        return;
+      }
+
+      if (!work.profileId) {
+        return;
+      }
+
+      try {
+        let matchedEntry = savedCustomWorldEntries.find(
+          (entry) => entry.profileId === work.profileId,
+        );
+
+        if (!matchedEntry && userId) {
+          const latestLibraryEntries = await listRpgEntryWorldLibrary();
+          setSavedCustomWorldEntries(latestLibraryEntries);
+          matchedEntry = latestLibraryEntries.find(
+            (entry) => entry.profileId === work.profileId,
+          );
+        }
+
+        if (matchedEntry) {
+          openLibraryDetail(matchedEntry);
+          return;
+        }
+
+        setPlatformError('未找到对应作品，请刷新后重试。');
+      } catch (error) {
+        setPlatformError(
+          resolveRpgEntryErrorMessage(error, '读取作品详情失败。'),
+        );
+      }
+    },
+    [
+      buildDraftResultProfile,
+      openLibraryDetail,
+      persistAgentUiState,
+      releaseAgentDraftResultAutoOpenSuppression,
+      resetAutoSaveTrackingToIdle,
+      savedCustomWorldEntries,
+      setCustomWorldAutoSaveError,
+      setCustomWorldAutoSaveState,
+      setCustomWorldError,
+      setCustomWorldGenerationViewSource,
+      setCustomWorldResultViewSource,
+      setGeneratedCustomWorldProfile,
+      setPlatformError,
+      setPlatformTabToCreate,
+      setSavedCustomWorldEntries,
+      setSelectionStage,
+      suppressAgentDraftResultAutoOpen,
+      syncAgentSessionSnapshot,
+      userId,
+    ],
+  );
+
+  const handlePublishSelectedWorld = useCallback(async () => {
+    if (!selectedDetailEntry || isMutatingDetail) {
+      return;
+    }
+
+    setIsMutatingDetail(true);
+    setDetailError(null);
+    try {
+      const mutation = await publishRpgEntryWorldProfile(
+        selectedDetailEntry.profileId,
+      );
+      setSavedCustomWorldEntries(mutation.entries);
+      await refreshCustomWorldWorks().catch(() => []);
+      setSelectedDetailEntry(mutation.entry);
+      await refreshPublishedGallery().catch(() => []);
+    } catch (error) {
+      setDetailError(
+        resolveRpgEntryErrorMessage(error, '发布自定义世界失败。'),
+      );
+    } finally {
+      setIsMutatingDetail(false);
+    }
+  }, [
+    isMutatingDetail,
+    refreshCustomWorldWorks,
+    refreshPublishedGallery,
+    selectedDetailEntry,
+    setSavedCustomWorldEntries,
+    setSelectedDetailEntry,
+  ]);
+
+  const handleUnpublishSelectedWorld = useCallback(async () => {
+    if (!selectedDetailEntry || isMutatingDetail) {
+      return;
+    }
+
+    setIsMutatingDetail(true);
+    setDetailError(null);
+    try {
+      const mutation = await unpublishRpgEntryWorldProfile(
+        selectedDetailEntry.profileId,
+      );
+      setSavedCustomWorldEntries(mutation.entries);
+      await refreshCustomWorldWorks().catch(() => []);
+      setSelectedDetailEntry(mutation.entry);
+      await refreshPublishedGallery().catch(() => []);
+    } catch (error) {
+      setDetailError(
+        resolveRpgEntryErrorMessage(error, '下架自定义世界失败。'),
+      );
+    } finally {
+      setIsMutatingDetail(false);
+    }
+  }, [
+    isMutatingDetail,
+    refreshCustomWorldWorks,
+    refreshPublishedGallery,
+    selectedDetailEntry,
+    setSavedCustomWorldEntries,
+    setSelectedDetailEntry,
+  ]);
+
+  const handleDeleteSelectedWorld = useCallback(async () => {
+    if (!selectedDetailEntry || isMutatingDetail) {
+      return;
+    }
+
+    const confirmed = window.confirm(
+      `确认删除作品《${selectedDetailEntry.worldName}》吗？删除后会从你的作品列表和公开广场中移除。`,
+    );
+    if (!confirmed) {
+      return;
+    }
+
+    setIsMutatingDetail(true);
+    setDetailError(null);
+    try {
+      const entries = await deleteRpgEntryWorldProfile(
+        selectedDetailEntry.profileId,
+      );
+      setSavedCustomWorldEntries(entries);
+      await refreshCustomWorldWorks().catch(() => []);
+      setSelectedDetailEntry(null);
+      setPlatformTabToCreate();
+      setSelectionStage('platform');
+      await refreshPublishedGallery().catch(() => []);
+    } catch (error) {
+      setDetailError(
+        resolveRpgEntryErrorMessage(error, '删除自定义世界失败。'),
+      );
+    } finally {
+      setIsMutatingDetail(false);
+    }
+  }, [
+    isMutatingDetail,
+    refreshCustomWorldWorks,
+    refreshPublishedGallery,
+    selectedDetailEntry,
+    setPlatformTabToCreate,
+    setSavedCustomWorldEntries,
+    setSelectedDetailEntry,
+    setSelectionStage,
+  ]);
+
+  const isSelectedWorldOwned = Boolean(
+    selectedDetailEntry &&
+      savedCustomWorldEntries.some(
+        (entry) =>
+          entry.ownerUserId === selectedDetailEntry.ownerUserId &&
+          entry.profileId === selectedDetailEntry.profileId,
+      ),
+  );
+
+  return {
+    detailError,
+    setDetailError,
+    isDetailLoading,
+    isMutatingDetail,
+    isSelectedWorldOwned,
+    openLibraryDetail,
+    openGalleryDetail,
+    openSavedCustomWorldEditor,
+    handleOpenCreationWork,
+    handlePublishSelectedWorld,
+    handleUnpublishSelectedWorld,
+    handleDeleteSelectedWorld,
+  };
+}
+
+/**
+ * 兼容旧创作链命名，避免并行工作包在本轮迁移后断开导入。
+ */
+export const useRpgCreationDetailNavigation = useRpgEntryLibraryDetail;
diff --git a/src/components/rpg-entry/useRpgEntryNavigation.ts b/src/components/rpg-entry/useRpgEntryNavigation.ts
new file mode 100644
index 00000000..1291f96c
--- /dev/null
+++ b/src/components/rpg-entry/useRpgEntryNavigation.ts
@@ -0,0 +1,55 @@
+import { useCallback } from 'react';
+
+import type { CustomWorldLibraryEntry } from '../../../packages/shared/src/contracts/runtime';
+import type { CustomWorldProfile } from '../../types';
+import type { SelectionStage } from './rpgEntryTypes';
+
+type UseRpgEntryNavigationParams = {
+  setSelectionStage: (stage: SelectionStage) => void;
+  setSelectedDetailEntry: (
+    entry: CustomWorldLibraryEntry<CustomWorldProfile> | null,
+  ) => void;
+};
+
+/**
+ * 收口 RPG 入口壳层的阶段跳转，避免页面内散落大量匿名 setState 回调。
+ */
+export function useRpgEntryNavigation(
+  params: UseRpgEntryNavigationParams,
+) {
+  const { setSelectionStage, setSelectedDetailEntry } = params;
+
+  const backToPlatformHome = useCallback(() => {
+    setSelectionStage('platform');
+  }, [setSelectionStage]);
+
+  const backToPlatformWithClearedDetail = useCallback(() => {
+    setSelectedDetailEntry(null);
+    setSelectionStage('platform');
+  }, [setSelectedDetailEntry, setSelectionStage]);
+
+  const openDetailStage = useCallback(() => {
+    setSelectionStage('detail');
+  }, [setSelectionStage]);
+
+  const openAgentWorkspaceStage = useCallback(() => {
+    setSelectionStage('agent-workspace');
+  }, [setSelectionStage]);
+
+  const openCustomWorldGenerationStage = useCallback(() => {
+    setSelectionStage('custom-world-generating');
+  }, [setSelectionStage]);
+
+  const openCustomWorldResultStage = useCallback(() => {
+    setSelectionStage('custom-world-result');
+  }, [setSelectionStage]);
+
+  return {
+    backToPlatformHome,
+    backToPlatformWithClearedDetail,
+    openDetailStage,
+    openAgentWorkspaceStage,
+    openCustomWorldGenerationStage,
+    openCustomWorldResultStage,
+  };
+}
diff --git a/src/components/rpg-entry/useRpgEntrySaveResume.ts b/src/components/rpg-entry/useRpgEntrySaveResume.ts
new file mode 100644
index 00000000..e13957c5
--- /dev/null
+++ b/src/components/rpg-entry/useRpgEntrySaveResume.ts
@@ -0,0 +1,28 @@
+import { useCallback } from 'react';
+
+import type { ProfileSaveArchiveSummary } from '../../../packages/shared/src/contracts/runtime';
+
+type UseRpgEntrySaveResumeParams = {
+  handleResumeSaveEntry: (entry: ProfileSaveArchiveSummary) => Promise<void>;
+};
+
+/**
+ * RPG 入口域里的“继续游戏”入口只负责转发恢复动作，
+ * 让壳层组件不直接知道具体的存档恢复实现细节。
+ */
+export function useRpgEntrySaveResume(
+  params: UseRpgEntrySaveResumeParams,
+) {
+  const { handleResumeSaveEntry } = params;
+
+  const resumeSelectedSave = useCallback(
+    async (entry: ProfileSaveArchiveSummary) => {
+      await handleResumeSaveEntry(entry);
+    },
+    [handleResumeSaveEntry],
+  );
+
+  return {
+    resumeSelectedSave,
+  };
+}
diff --git a/src/components/AdventurePanel.npcChat.test.tsx b/src/components/rpg-runtime-panels/RpgAdventurePanel.npcChat.test.tsx
similarity index 96%
rename from src/components/AdventurePanel.npcChat.test.tsx
rename to src/components/rpg-runtime-panels/RpgAdventurePanel.npcChat.test.tsx
index 9184807f..c53f0218 100644
--- a/src/components/AdventurePanel.npcChat.test.tsx
+++ b/src/components/rpg-runtime-panels/RpgAdventurePanel.npcChat.test.tsx
@@ -1,8 +1,8 @@
 import { renderToStaticMarkup } from 'react-dom/server';
 import { expect, test } from 'vitest';
 
-import { AdventurePanel } from './AdventurePanel';
-import { type Character, type StoryMoment, WorldType } from '../types';
+import { type Character, type StoryMoment, WorldType } from '../../types';
+import { RpgAdventurePanel } from './RpgAdventurePanel';
 
 function createCharacter(): Character {
   return {
@@ -39,7 +39,7 @@ test('adventure panel renders system turns without special relationship labels',
   };
 
   const html = renderToStaticMarkup(
-    <AdventurePanel
+    <RpgAdventurePanel
       aiError={null}
       currentStory={currentStory}
       isLoading={false}
@@ -58,7 +58,7 @@ test('adventure panel renders system turns without special relationship labels',
         claimQuestReward: () => null,
       }}
       npcChatQuestOfferUi={{
-        replacePendingOffer: async () => false,
+        replacePendingOffer: () => false,
         abandonPendingOffer: () => false,
         acceptPendingOffer: () => null,
       }}
@@ -130,7 +130,7 @@ test('adventure panel shows current act label and remaining turns for limited ho
   };
 
   const html = renderToStaticMarkup(
-    <AdventurePanel
+    <RpgAdventurePanel
       aiError={null}
       currentStory={currentStory}
       isLoading={false}
@@ -151,7 +151,7 @@ test('adventure panel shows current act label and remaining turns for limited ho
         claimQuestReward: () => null,
       }}
       npcChatQuestOfferUi={{
-        replacePendingOffer: async () => false,
+        replacePendingOffer: () => false,
         abandonPendingOffer: () => false,
         acceptPendingOffer: () => null,
       }}
diff --git a/src/components/AdventurePanel.test.tsx b/src/components/rpg-runtime-panels/RpgAdventurePanel.test.tsx
similarity index 98%
rename from src/components/AdventurePanel.test.tsx
rename to src/components/rpg-runtime-panels/RpgAdventurePanel.test.tsx
index c7d14cec..7d972a4f 100644
--- a/src/components/AdventurePanel.test.tsx
+++ b/src/components/rpg-runtime-panels/RpgAdventurePanel.test.tsx
@@ -1,8 +1,8 @@
 import { renderToStaticMarkup } from 'react-dom/server';
 import { expect, test } from 'vitest';
 
-import { AnimationState, type Character, type StoryMoment, type StoryOption, WorldType } from '../types';
-import { AdventurePanel } from './AdventurePanel';
+import { AnimationState, type Character, type StoryMoment, type StoryOption, WorldType } from '../../types';
+import { RpgAdventurePanel } from './RpgAdventurePanel';
 
 function createCharacter(): Character {
   return {
@@ -55,7 +55,7 @@ function renderPanel(
   } = {},
 ) {
   return renderToStaticMarkup(
-    <AdventurePanel
+    <RpgAdventurePanel
       aiError={null}
       currentStory={currentStory}
       isLoading={overrides.isLoading ?? false}
@@ -76,7 +76,7 @@ function renderPanel(
         claimQuestReward: () => null,
       }}
       npcChatQuestOfferUi={{
-        replacePendingOffer: async () => false,
+        replacePendingOffer: () => false,
         abandonPendingOffer: () => false,
         acceptPendingOffer: () => null,
       }}
diff --git a/src/components/AdventurePanel.tsx b/src/components/rpg-runtime-panels/RpgAdventurePanel.tsx
similarity index 60%
rename from src/components/AdventurePanel.tsx
rename to src/components/rpg-runtime-panels/RpgAdventurePanel.tsx
index fd1b6d1e..45e1d782 100644
--- a/src/components/AdventurePanel.tsx
+++ b/src/components/rpg-runtime-panels/RpgAdventurePanel.tsx
@@ -16,23 +16,23 @@ import {
 import { motion } from 'motion/react';
 import { lazy, Suspense, useEffect, useMemo, useRef, useState } from 'react';
 
-import { formatCurrency } from '../data/economy';
-import { getEquipmentSlotFromItem } from '../data/equipmentEffects';
+import { formatCurrency } from '../../data/economy';
+import { getEquipmentSlotFromItem } from '../../data/equipmentEffects';
 import {
   getFunctionDocumentationById,
   isContinueAdventureOption,
   NPC_CHAT_FUNCTION,
-} from '../data/functionCatalog';
-import { getHostileNpcPresetById } from '../data/hostileNpcPresets';
-import { resolveInventoryItemUseEffect } from '../data/inventoryEffects';
-import { isQuestReadyToClaim } from '../data/questFlow';
-import { getScenePresetById } from '../data/scenePresets';
-import { getOptionImpactSummary } from '../hooks/combatStoryUtils';
+} from '../../data/functionCatalog';
+import { getHostileNpcPresetById } from '../../data/hostileNpcPresets';
+import { resolveInventoryItemUseEffect } from '../../data/inventoryEffects';
+import { isQuestReadyToClaim } from '../../data/questFlow';
+import { getScenePresetById } from '../../data/scenePresets';
+import { getOptionImpactSummary } from '../../hooks/combatStoryUtils';
 import type {
   BattleRewardUi,
   NpcChatQuestOfferUi,
   QuestFlowUi,
-} from '../hooks/useStoryGeneration';
+} from '../../hooks/rpg-runtime-story';
 import type {
   ChapterState,
   Character,
@@ -46,18 +46,18 @@ import type {
   StoryMoment,
   StoryOption,
   WorldType,
-} from '../types';
+} from '../../types';
 import {
   CHROME_ICONS,
   getInventoryCategoryIcon,
   getNineSliceStyle,
   TAB_ICONS,
   UI_CHROME,
-} from '../uiAssets';
-import { HostileNpcAnimator } from './HostileNpcAnimator';
-import { PixelIcon } from './PixelIcon';
+} from '../../uiAssets';
+import { HostileNpcAnimator } from '../HostileNpcAnimator';
+import { PixelIcon } from '../PixelIcon';
 
-interface AdventurePanelProps {
+export interface RpgAdventurePanelProps {
   aiError: string | null;
   currentStory: StoryMoment;
   isLoading: boolean;
@@ -115,11 +115,11 @@ interface AdventurePanelProps {
   currentSceneActCount?: number | null;
 }
 
-const AdventurePanelOverlays = lazy(async () => {
-  const module = await import('./adventure-panel/AdventurePanelOverlays');
+const RpgAdventurePanelOverlays = lazy(async () => {
+  const module = await import('./RpgAdventurePanelOverlays');
 
   return {
-    default: module.AdventurePanelOverlays,
+    default: module.RpgAdventurePanelOverlays,
   };
 });
 
@@ -214,14 +214,14 @@ function getDialogueTurnLabel(
   }
 
   if (turn.speaker === 'player') {
-    return '\u4f60';
+    return '你';
   }
 
   if (turn.speaker === 'companion') {
-    return turn.speakerName?.trim() || '\u540c\u4f34';
+    return turn.speakerName?.trim() || '同伴';
   }
 
-  return turn.speakerName?.trim() || '\u5bf9\u65b9';
+  return turn.speakerName?.trim() || '对方';
 }
 
 function getQuestRewardItemIcon(item: InventoryItem) {
@@ -596,26 +596,477 @@ function QuestObjectiveCard({
           </div>
 
           <div className="rounded-xl border border-white/10 bg-black/25 px-3 py-3">
-            <div className="flex items-center justify-between gap-3 text-[10px] uppercase tracking-[0.18em] text-zinc-500">
-              <span>Progress</span>
-              <span className="text-white/70">
+            <div className="flex items-center justify-between gap-2">
+              <div className="text-[10px] uppercase tracking-[0.2em] text-zinc-500">
+                当前进度
+              </div>
+              <div className="text-xs text-zinc-400">
                 {quest.progress}/{quest.objective.requiredCount}
-              </span>
+              </div>
             </div>
             <div className="mt-3">
               <QuestProgressPips
                 progress={quest.progress}
                 total={quest.objective.requiredCount}
-                activeClassName="border-emerald-300/30 bg-emerald-400/85"
+                activeClassName="border-amber-200/40 bg-amber-400/75"
               />
             </div>
           </div>
+
+          <div className="rounded-xl border border-white/10 bg-black/25 px-3 py-3">
+            <div className="text-[10px] uppercase tracking-[0.2em] text-zinc-500">
+              任务描述
+            </div>
+            <div className="mt-2 text-sm leading-6 text-zinc-100">
+              {quest.description}
+            </div>
+          </div>
         </div>
       </div>
     </div>
   );
 }
 
+function RpgAdventureStorySection(props: {
+  currentSceneActTitle: string | null;
+  currentSceneActIndex: number | null;
+  currentSceneActCount: number | null;
+  limitedNpcChatRemainingTurns: number | null;
+  storyScrollContainerRef: React.RefObject<HTMLDivElement | null>;
+  isDialogueStory: boolean;
+  dialogueTurns: NonNullable<StoryMoment['dialogue']>;
+  isNpcChatMode: boolean;
+  isStoryStreaming: boolean;
+  currentStory: StoryMoment;
+}) {
+  const {
+    currentSceneActTitle,
+    currentSceneActIndex,
+    currentSceneActCount,
+    limitedNpcChatRemainingTurns,
+    storyScrollContainerRef,
+    isDialogueStory,
+    dialogueTurns,
+    isNpcChatMode,
+    isStoryStreaming,
+    currentStory,
+  } = props;
+
+  return (
+    <div
+      ref={storyScrollContainerRef}
+      className="pixel-nine-slice pixel-panel mb-2 min-h-0 flex-1 overflow-y-auto pr-1 scrollbar-hide"
+      style={getNineSliceStyle(UI_CHROME.storyPanel)}
+    >
+      {(currentSceneActTitle || limitedNpcChatRemainingTurns !== null) && (
+        <div className="mb-3 flex flex-wrap items-center gap-2 px-1">
+          {currentSceneActTitle ? (
+            <div className="inline-flex items-center gap-2 rounded-full border border-sky-300/18 bg-sky-500/10 px-3 py-1 text-[10px] tracking-[0.16em] text-sky-100">
+              <span>当前幕</span>
+              <span className="text-white/90">{currentSceneActTitle}</span>
+              {currentSceneActIndex && currentSceneActCount ? (
+                <span className="text-sky-100/65">
+                  {currentSceneActIndex}/{currentSceneActCount}
+                </span>
+              ) : null}
+            </div>
+          ) : null}
+          {limitedNpcChatRemainingTurns !== null ? (
+            <div className="inline-flex items-center gap-2 rounded-full border border-rose-300/18 bg-rose-500/10 px-3 py-1 text-[10px] tracking-[0.16em] text-rose-100">
+              <span>剩余交谈</span>
+              <span className="text-white/90">
+                {limitedNpcChatRemainingTurns} 轮
+              </span>
+            </div>
+          ) : null}
+        </div>
+      )}
+      {isDialogueStory ? (
+        <div className="space-y-3">
+          {dialogueTurns.length > 0 ? (
+            dialogueTurns.map((turn, index) => (
+              <div
+                key={`${turn.speaker}-${turn.speakerName ?? 'default'}-${index}-${turn.text}`}
+                className={`flex ${getDialogueTurnAlignmentClass(turn)}`}
+              >
+                <div
+                  className={`max-w-[88%] border px-3 py-2 text-sm leading-relaxed ${getDialogueTurnBubbleClass(turn)} ${getDialogueTurnBubbleShapeClass(turn)}`}
+                >
+                  <div className="sr-only">
+                    {turn.speaker === 'player' ? '你' : '对方'}
+                  </div>
+                  <div className="mb-1 text-[10px] tracking-[0.18em] text-zinc-400">
+                    {getDialogueTurnLabel(turn)}
+                  </div>
+                  {turn.text}
+                </div>
+              </div>
+            ))
+          ) : isNpcChatMode && !isStoryStreaming ? (
+            <div className="h-1" aria-hidden="true" />
+          ) : (
+            <div className="flex justify-start">
+              <div className="rounded-2xl border border-white/10 bg-black/20 px-3 py-2 text-sm text-zinc-400">
+                对话正在展开...
+              </div>
+            </div>
+          )}
+        </div>
+      ) : (
+        <p className="font-serif text-[15px] leading-7 text-zinc-200 sm:text-base">
+          {currentStory.text}
+        </p>
+      )}
+    </div>
+  );
+}
+
+function RpgAdventureChoiceSection(props: {
+  isNpcChatMode: boolean;
+  canRefreshOptions: boolean;
+  shouldHideChoiceUi: boolean;
+  onRefreshOptions: () => void;
+  onOpenCharacter: () => void;
+  onOpenInventory: () => void;
+  onExitNpcChat?: () => boolean;
+  isLoading: boolean;
+  isStoryStreaming: boolean;
+  displayedOptions: StoryOption[];
+  playerCharacter: Character;
+  playerHp: number;
+  playerMaxHp: number;
+  playerMana: number;
+  playerMaxMana: number;
+  playerSkillCooldowns: Record<string, number>;
+  currentNpcBattleMode: NpcBattleMode | null;
+  hasDeferredAdventureOptions: boolean;
+  handleOptionChoice: (option: StoryOption) => void;
+  isNpcQuestOfferMode: boolean;
+  npcChatDraft: string;
+  setNpcChatDraft: (value: string) => void;
+  npcChatPlaceholder: string;
+  submitNpcChatDraft: () => void;
+}) {
+  const {
+    isNpcChatMode,
+    canRefreshOptions,
+    shouldHideChoiceUi,
+    onRefreshOptions,
+    onOpenCharacter,
+    onOpenInventory,
+    onExitNpcChat,
+    isLoading,
+    isStoryStreaming,
+    displayedOptions,
+    playerCharacter,
+    playerHp,
+    playerMaxHp,
+    playerMana,
+    playerMaxMana,
+    playerSkillCooldowns,
+    currentNpcBattleMode,
+    hasDeferredAdventureOptions,
+    handleOptionChoice,
+    isNpcQuestOfferMode,
+    npcChatDraft,
+    setNpcChatDraft,
+    npcChatPlaceholder,
+    submitNpcChatDraft,
+  } = props;
+
+  return (
+    <div className="mt-auto shrink-0 pb-[calc(env(safe-area-inset-bottom,0px)+0.35rem)]">
+      <div className="mb-1.5 flex flex-wrap items-center justify-between gap-2">
+        <div className="flex min-w-0 flex-wrap items-center gap-2">
+          <button
+            type="button"
+            onClick={onOpenCharacter}
+            aria-label="打开队伍"
+            className="inline-flex h-8 shrink-0 items-center gap-1.5 rounded-md border border-white/10 bg-black/20 px-2 text-zinc-300 transition-colors hover:text-white"
+          >
+            <PixelIcon src={TAB_ICONS.character.active} className="h-4 w-4" />
+            <span className="text-xs leading-none">队伍</span>
+          </button>
+          <button
+            type="button"
+            onClick={onOpenInventory}
+            aria-label="打开背包"
+            className="inline-flex h-8 shrink-0 items-center gap-1.5 rounded-md border border-white/10 bg-black/20 px-2 text-zinc-300 transition-colors hover:text-white"
+          >
+            <PixelIcon src={TAB_ICONS.inventory.active} className="h-4 w-4" />
+            <span className="text-xs leading-none">背包</span>
+          </button>
+        </div>
+
+        {isNpcChatMode ? (
+          <button
+            type="button"
+            onClick={() => onExitNpcChat?.()}
+            aria-label="退出聊天"
+            className="inline-flex h-8 shrink-0 items-center gap-1.5 self-start rounded-md border border-rose-300/20 bg-rose-500/10 px-2 text-rose-100 transition-colors hover:bg-rose-500/15"
+          >
+            <span className="text-xs leading-none">退出聊天</span>
+          </button>
+        ) : canRefreshOptions && !shouldHideChoiceUi ? (
+          <button
+            type="button"
+            onClick={onRefreshOptions}
+            aria-label="换一换选项"
+            className="inline-flex h-8 shrink-0 items-center gap-1.5 self-start rounded-md border border-white/10 bg-black/20 px-2 text-zinc-300 transition-colors hover:text-white"
+          >
+            <PixelIcon
+              src={CHROME_ICONS.refreshOptions}
+              className="h-4 w-4"
+            />
+            <span className="text-xs leading-none">换一换</span>
+          </button>
+        ) : null}
+      </div>
+
+      <div className="space-y-1.5">
+        {isLoading && !isStoryStreaming ? (
+          <div className="flex items-center justify-center space-x-2 p-4 text-zinc-600">
+            <Loader2 className="h-4 w-4 animate-spin" />
+            <span className="text-xs uppercase tracking-widest">
+              剧情推演中...
+            </span>
+          </div>
+        ) : isStoryStreaming ? (
+          <div className="flex items-center justify-center p-4 text-[11px] tracking-[0.18em] text-zinc-500">
+            对话进行中
+          </div>
+        ) : shouldHideChoiceUi ? (
+          <div className="p-4" aria-hidden="true" />
+        ) : (
+          <>
+            {displayedOptions.map((option, index) => {
+              const optionImpactSummary = getOptionImpactSummary(
+                option,
+                playerCharacter,
+                playerHp,
+                playerMaxHp,
+                playerMana,
+                playerMaxMana,
+                playerSkillCooldowns,
+                currentNpcBattleMode,
+              );
+              const isDeferredContinueOption =
+                hasDeferredAdventureOptions &&
+                isContinueAdventureOption(option);
+              const optionDisabled = option.disabled === true;
+
+              if (isDeferredContinueOption) {
+                return (
+                  <motion.button
+                    key={`${option.functionId}-${option.actionText}-${index}`}
+                    type="button"
+                    initial={{ opacity: 0, y: 22 }}
+                    animate={{ opacity: 1, y: 0 }}
+                    transition={{ duration: 0.24, ease: 'easeOut' }}
+                    onClick={() => handleOptionChoice(option)}
+                    className="pixel-nine-slice pixel-pressable pixel-choice-button group w-full text-left"
+                    style={getNineSliceStyle(UI_CHROME.choiceButton)}
+                  >
+                    <div className="flex items-center justify-between">
+                      <span
+                        className={`text-sm sm:text-[15px] ${getOptionActionTextClass(option)}`}
+                      >
+                        {option.actionText}
+                      </span>
+                      <PixelIcon
+                        src={CHROME_ICONS.optionArrow}
+                        className="h-3 w-3 opacity-70 transition-opacity group-hover:opacity-100"
+                      />
+                    </div>
+                    <div className="mt-1 text-[10px] leading-relaxed text-zinc-500">
+                      剧情推理完成，继续后显示新的冒险选项
+                    </div>
+                  </motion.button>
+                );
+              }
+
+              return (
+                <button
+                  key={`${option.functionId}-${option.actionText}-${index}`}
+                  type="button"
+                  onClick={() => handleOptionChoice(option)}
+                  disabled={optionDisabled}
+                  className={`pixel-nine-slice pixel-choice-button group w-full text-left ${optionDisabled ? 'cursor-not-allowed opacity-55' : 'pixel-pressable'}`}
+                  style={getNineSliceStyle(UI_CHROME.choiceButton)}
+                >
+                  <div className="flex items-center justify-between">
+                    <span
+                      className={`text-sm sm:text-[15px] ${getOptionActionTextClass(option)}`}
+                    >
+                      {option.actionText}
+                    </span>
+                    <PixelIcon
+                      src={CHROME_ICONS.optionArrow}
+                      className="h-3 w-3 opacity-70 transition-opacity group-hover:opacity-100"
+                    />
+                  </div>
+                  {!isNpcChatMode && option.goalAffordance?.label && (
+                    <div
+                      className={`mt-1 text-[10px] ${getOptionGoalAffordanceClass(option)}`}
+                    >
+                      {option.goalAffordance.label}
+                    </div>
+                  )}
+                  {!isNpcChatMode && optionImpactSummary && !optionDisabled && (
+                    <div className="mt-1 text-[10px] text-zinc-500">
+                      {optionImpactSummary}
+                    </div>
+                  )}
+                </button>
+              );
+            })}
+            {isNpcChatMode && !isNpcQuestOfferMode ? (
+              <div className="pixel-nine-slice pixel-panel border border-white/10 bg-black/25 p-1.5">
+                <div className="flex min-w-0 items-center gap-2">
+                  <input
+                    value={npcChatDraft}
+                    onChange={(event) => setNpcChatDraft(event.target.value)}
+                    onKeyDown={(event) => {
+                      if (
+                        event.key === 'Enter' &&
+                        !event.nativeEvent.isComposing
+                      ) {
+                        event.preventDefault();
+                        submitNpcChatDraft();
+                      }
+                    }}
+                    placeholder={npcChatPlaceholder}
+                    className="h-9 min-w-0 flex-1 rounded-md border border-white/10 bg-black/35 px-3 text-sm text-zinc-100 outline-none placeholder:text-zinc-500 focus:border-amber-200/40"
+                    maxLength={80}
+                    disabled={isLoading}
+                  />
+                  <button
+                    type="button"
+                    onClick={submitNpcChatDraft}
+                    disabled={isLoading || !npcChatDraft.trim()}
+                    className="inline-flex h-9 shrink-0 items-center rounded-md border border-amber-300/20 bg-amber-500/10 px-2.5 text-[11px] text-amber-100 transition-colors disabled:cursor-not-allowed disabled:opacity-40 sm:px-3 sm:text-xs"
+                  >
+                    发送
+                  </button>
+                </div>
+              </div>
+            ) : null}
+          </>
+        )}
+      </div>
+    </div>
+  );
+}
+
+function RpgAdventureOverlaySection(props: {
+  shouldMountAdventureOverlays: boolean;
+  worldType: WorldType | null;
+  quests: QuestLogEntry[];
+  questUi: QuestFlowUi;
+  battleRewardUi: BattleRewardUi;
+  statistics: RpgAdventurePanelProps['statistics'];
+  statisticsCards: Array<{
+    key: string;
+    label: string;
+    value: string;
+    detail: string;
+    icon: typeof Clock3;
+  }>;
+  musicVolume: number;
+  onMusicVolumeChange: (value: number) => void;
+  onSaveAndExit: () => void;
+  saveAndExitDisabled: boolean;
+  isGoalPanelOpen: boolean;
+  setIsGoalPanelOpen: (value: boolean) => void;
+  isQuestPanelOpen: boolean;
+  setIsQuestPanelOpen: (value: boolean) => void;
+  isSettingsPanelOpen: boolean;
+  setIsSettingsPanelOpen: (value: boolean) => void;
+  isStatsPanelOpen: boolean;
+  setIsStatsPanelOpen: (value: boolean) => void;
+  chapterState: ChapterState | null;
+  journeyBeat: JourneyBeat | null;
+  goalStack: GoalStackState;
+  goalPulse: GoalPulseEvent | null;
+  onDismissGoalPulse: () => void;
+  selectedQuest: QuestLogEntry | null;
+  setSelectedQuestId: (questId: string | null) => void;
+  completionNoticeQuest: QuestLogEntry | null;
+  setCompletionNoticeQuestId: (questId: string | null) => void;
+  rewardQuest: QuestLogEntry | null;
+  setRewardQuestId: (questId: string | null) => void;
+  rewardQuestHandoff: GoalHandoff | null;
+  setRewardQuestHandoff: (handoff: GoalHandoff | null) => void;
+  selectedRewardItemQuestId: string | null;
+  setSelectedRewardItemQuestId: (questId: string | null) => void;
+  selectedRewardItemId: string | null;
+  setSelectedRewardItemId: (itemId: string | null) => void;
+  selectedBattleRewardItemId: string | null;
+  setSelectedBattleRewardItemId: (itemId: string | null) => void;
+  selectedRewardItem: InventoryItem | null;
+  selectedRewardUseEffect: ReturnType<typeof resolveInventoryItemUseEffect> | null;
+  selectedRewardEquipSlot: ReturnType<typeof getEquipmentSlotFromItem> | null;
+  selectedQuestSceneName: string;
+  getQuestStatusLabel: (status: QuestLogEntry['status']) => string;
+  pendingNpcQuestOffer: QuestLogEntry | null;
+  onAcceptPendingNpcQuestOffer: () => string | null;
+}) {
+  if (!props.shouldMountAdventureOverlays) {
+    return null;
+  }
+
+  return (
+      <Suspense fallback={<AdventurePanelOverlayLoadingFallback />}>
+        <RpgAdventurePanelOverlays
+        worldType={props.worldType}
+        quests={props.quests}
+        questUi={props.questUi}
+        battleRewardUi={props.battleRewardUi}
+        statistics={props.statistics}
+        statisticsCards={props.statisticsCards}
+        musicVolume={props.musicVolume}
+        onMusicVolumeChange={props.onMusicVolumeChange}
+        onSaveAndExit={props.onSaveAndExit}
+        saveAndExitDisabled={props.saveAndExitDisabled}
+        isGoalPanelOpen={props.isGoalPanelOpen}
+        setIsGoalPanelOpen={props.setIsGoalPanelOpen}
+        isQuestPanelOpen={props.isQuestPanelOpen}
+        setIsQuestPanelOpen={props.setIsQuestPanelOpen}
+        isSettingsPanelOpen={props.isSettingsPanelOpen}
+        setIsSettingsPanelOpen={props.setIsSettingsPanelOpen}
+        isStatsPanelOpen={props.isStatsPanelOpen}
+        setIsStatsPanelOpen={props.setIsStatsPanelOpen}
+        chapterState={props.chapterState}
+        journeyBeat={props.journeyBeat}
+        goalStack={props.goalStack}
+        goalPulse={props.goalPulse}
+        onDismissGoalPulse={props.onDismissGoalPulse}
+        selectedQuest={props.selectedQuest}
+        setSelectedQuestId={props.setSelectedQuestId}
+        completionNoticeQuest={props.completionNoticeQuest}
+        setCompletionNoticeQuestId={props.setCompletionNoticeQuestId}
+        rewardQuest={props.rewardQuest}
+        setRewardQuestId={props.setRewardQuestId}
+        rewardQuestHandoff={props.rewardQuestHandoff}
+        setRewardQuestHandoff={props.setRewardQuestHandoff}
+        selectedRewardItemQuestId={props.selectedRewardItemQuestId}
+        setSelectedRewardItemQuestId={props.setSelectedRewardItemQuestId}
+        selectedRewardItemId={props.selectedRewardItemId}
+        setSelectedRewardItemId={props.setSelectedRewardItemId}
+        selectedBattleRewardItemId={props.selectedBattleRewardItemId}
+        setSelectedBattleRewardItemId={props.setSelectedBattleRewardItemId}
+        selectedRewardItem={props.selectedRewardItem}
+        selectedRewardUseEffect={props.selectedRewardUseEffect}
+        selectedRewardEquipSlot={props.selectedRewardEquipSlot}
+        selectedQuestSceneName={props.selectedQuestSceneName}
+        getQuestStatusLabel={props.getQuestStatusLabel}
+        pendingNpcQuestOffer={props.pendingNpcQuestOffer}
+        onAcceptPendingNpcQuestOffer={props.onAcceptPendingNpcQuestOffer}
+      />
+    </Suspense>
+  );
+}
+
 const LEGACY_ADVENTURE_PANEL_HELPERS = {
   getQuestRewardItemIcon,
   getRewardItemFrameClass,
@@ -629,7 +1080,12 @@ const LEGACY_ADVENTURE_PANEL_HELPERS = {
 
 void LEGACY_ADVENTURE_PANEL_HELPERS;
 
-export function AdventurePanel({
+/**
+ * RPG 冒险主面板。
+ * 维持原有视觉与交互，只把真实实现迁到 `rpg-runtime-panels`，
+ * 并把 story / choice / overlay 三个主 section 显式拆开。
+ */
+export function RpgAdventurePanel({
   aiError,
   currentStory,
   isLoading,
@@ -666,7 +1122,7 @@ export function AdventurePanel({
   currentSceneActTitle = null,
   currentSceneActIndex = null,
   currentSceneActCount = null,
-}: AdventurePanelProps) {
+}: RpgAdventurePanelProps) {
   const isDialogueStory = currentStory.displayMode === 'dialogue';
   const dialogueTurns = currentStory.dialogue ?? [];
   const npcChatState = currentStory.npcChatState ?? null;
@@ -1045,312 +1501,102 @@ export function AdventurePanel({
         </div>
       )}
 
-      <div
-        ref={storyScrollContainerRef}
-        className="pixel-nine-slice pixel-panel mb-2 min-h-0 flex-1 overflow-y-auto pr-1 scrollbar-hide"
-        style={getNineSliceStyle(UI_CHROME.storyPanel)}
-      >
-        {(currentSceneActTitle || limitedNpcChatRemainingTurns !== null) && (
-          <div className="mb-3 flex flex-wrap items-center gap-2 px-1">
-            {currentSceneActTitle ? (
-              <div className="inline-flex items-center gap-2 rounded-full border border-sky-300/18 bg-sky-500/10 px-3 py-1 text-[10px] tracking-[0.16em] text-sky-100">
-                <span>当前幕</span>
-                <span className="text-white/90">{currentSceneActTitle}</span>
-                {currentSceneActIndex && currentSceneActCount ? (
-                  <span className="text-sky-100/65">
-                    {currentSceneActIndex}/{currentSceneActCount}
-                  </span>
-                ) : null}
-              </div>
-            ) : null}
-            {limitedNpcChatRemainingTurns !== null ? (
-              <div className="inline-flex items-center gap-2 rounded-full border border-rose-300/18 bg-rose-500/10 px-3 py-1 text-[10px] tracking-[0.16em] text-rose-100">
-                <span>剩余交谈</span>
-                <span className="text-white/90">
-                  {limitedNpcChatRemainingTurns} 轮
-                </span>
-              </div>
-            ) : null}
-          </div>
-        )}
-        {isDialogueStory ? (
-          <div className="space-y-3">
-            {dialogueTurns.length > 0 ? (
-              dialogueTurns.map((turn, index) => (
-                <div
-                  key={`${turn.speaker}-${turn.speakerName ?? 'default'}-${index}-${turn.text}`}
-                  className={`flex ${getDialogueTurnAlignmentClass(turn)}`}
-                >
-                  <div
-                    className={`max-w-[88%] border px-3 py-2 text-sm leading-relaxed ${getDialogueTurnBubbleClass(turn)} ${getDialogueTurnBubbleShapeClass(turn)}`}
-                  >
-                    <div className="sr-only">
-                      {turn.speaker === 'player' ? '你' : '对方'}
-                    </div>
-                    <div className="mb-1 text-[10px] tracking-[0.18em] text-zinc-400">
-                      {getDialogueTurnLabel(turn)}
-                    </div>
-                    {turn.text}
-                  </div>
-                </div>
-              ))
-            ) : isNpcChatMode && !isStoryStreaming ? (
-              <div className="h-1" aria-hidden="true" />
-            ) : (
-              <div className="flex justify-start">
-                <div className="rounded-2xl border border-white/10 bg-black/20 px-3 py-2 text-sm text-zinc-400">
-                  对话正在展开...
-                </div>
-              </div>
-            )}
-          </div>
-        ) : (
-          <p className="font-serif text-[15px] leading-7 text-zinc-200 sm:text-base">
-            {currentStory.text}
-          </p>
-        )}
-      </div>
+      <RpgAdventureStorySection
+        currentSceneActTitle={currentSceneActTitle}
+        currentSceneActIndex={currentSceneActIndex}
+        currentSceneActCount={currentSceneActCount}
+        limitedNpcChatRemainingTurns={limitedNpcChatRemainingTurns}
+        storyScrollContainerRef={storyScrollContainerRef}
+        isDialogueStory={isDialogueStory}
+        dialogueTurns={dialogueTurns}
+        isNpcChatMode={isNpcChatMode}
+        isStoryStreaming={isStoryStreaming}
+        currentStory={currentStory}
+      />
 
-      <div className="mt-auto shrink-0 pb-[calc(env(safe-area-inset-bottom,0px)+0.35rem)]">
-        <div className="mb-1.5 flex flex-wrap items-center justify-between gap-2">
-          <div className="flex min-w-0 flex-wrap items-center gap-2">
-            <button
-              type="button"
-              onClick={onOpenCharacter}
-              aria-label="打开队伍"
-              className="inline-flex h-8 shrink-0 items-center gap-1.5 rounded-md border border-white/10 bg-black/20 px-2 text-zinc-300 transition-colors hover:text-white"
-            >
-              <PixelIcon src={TAB_ICONS.character.active} className="h-4 w-4" />
-              <span className="text-xs leading-none">队伍</span>
-            </button>
-            <button
-              type="button"
-              onClick={onOpenInventory}
-              aria-label="打开背包"
-              className="inline-flex h-8 shrink-0 items-center gap-1.5 rounded-md border border-white/10 bg-black/20 px-2 text-zinc-300 transition-colors hover:text-white"
-            >
-              <PixelIcon src={TAB_ICONS.inventory.active} className="h-4 w-4" />
-              <span className="text-xs leading-none">背包</span>
-            </button>
-          </div>
+      <RpgAdventureChoiceSection
+        isNpcChatMode={isNpcChatMode}
+        canRefreshOptions={canRefreshOptions}
+        shouldHideChoiceUi={shouldHideChoiceUi}
+        onRefreshOptions={onRefreshOptions}
+        onOpenCharacter={onOpenCharacter}
+        onOpenInventory={onOpenInventory}
+        onExitNpcChat={onExitNpcChat}
+        isLoading={isLoading}
+        isStoryStreaming={isStoryStreaming}
+        displayedOptions={displayedOptions}
+        playerCharacter={playerCharacter}
+        playerHp={playerHp}
+        playerMaxHp={playerMaxHp}
+        playerMana={playerMana}
+        playerMaxMana={playerMaxMana}
+        playerSkillCooldowns={playerSkillCooldowns}
+        currentNpcBattleMode={currentNpcBattleMode}
+        hasDeferredAdventureOptions={hasDeferredAdventureOptions}
+        handleOptionChoice={handleOptionChoice}
+        isNpcQuestOfferMode={isNpcQuestOfferMode}
+        npcChatDraft={npcChatDraft}
+        setNpcChatDraft={setNpcChatDraft}
+        npcChatPlaceholder={
+          npcChatState?.customInputPlaceholder ?? '输入你想说的话'
+        }
+        submitNpcChatDraft={submitNpcChatDraft}
+      />
 
-          {isNpcChatMode ? (
-            <button
-              type="button"
-              onClick={() => onExitNpcChat?.()}
-              aria-label="退出聊天"
-              className="inline-flex h-8 shrink-0 items-center gap-1.5 self-start rounded-md border border-rose-300/20 bg-rose-500/10 px-2 text-rose-100 transition-colors hover:bg-rose-500/15"
-            >
-              <span className="text-xs leading-none">退出聊天</span>
-            </button>
-          ) : canRefreshOptions && !shouldHideChoiceUi ? (
-            <button
-              type="button"
-              onClick={onRefreshOptions}
-              aria-label="换一换选项"
-              className="inline-flex h-8 shrink-0 items-center gap-1.5 self-start rounded-md border border-white/10 bg-black/20 px-2 text-zinc-300 transition-colors hover:text-white"
-            >
-              <PixelIcon
-                src={CHROME_ICONS.refreshOptions}
-                className="h-4 w-4"
-              />
-              <span className="text-xs leading-none">换一换</span>
-            </button>
-          ) : null}
-        </div>
-
-        <div className="space-y-1.5">
-          {isLoading && !isStoryStreaming ? (
-            <div className="flex items-center justify-center space-x-2 p-4 text-zinc-600">
-              <Loader2 className="h-4 w-4 animate-spin" />
-              <span className="text-xs uppercase tracking-widest">
-                剧情推演中...
-              </span>
-            </div>
-          ) : isStoryStreaming ? (
-            <div className="flex items-center justify-center p-4 text-[11px] tracking-[0.18em] text-zinc-500">
-              对话进行中
-            </div>
-          ) : shouldHideChoiceUi ? (
-            <div className="p-4" aria-hidden="true" />
-          ) : (
-            <>
-              {displayedOptions.map((option, index) => {
-                const optionImpactSummary = getOptionImpactSummary(
-                  option,
-                  playerCharacter,
-                  playerHp,
-                  playerMaxHp,
-                  playerMana,
-                  playerMaxMana,
-                  playerSkillCooldowns,
-                  currentNpcBattleMode,
-                );
-                const isDeferredContinueOption =
-                  hasDeferredAdventureOptions &&
-                  isContinueAdventureOption(option);
-                const optionDisabled = option.disabled === true;
-
-                if (isDeferredContinueOption) {
-                  return (
-                    <motion.button
-                      key={`${option.functionId}-${option.actionText}-${index}`}
-                      type="button"
-                      initial={{ opacity: 0, y: 22 }}
-                      animate={{ opacity: 1, y: 0 }}
-                      transition={{ duration: 0.24, ease: 'easeOut' }}
-                      onClick={() => handleOptionChoice(option)}
-                      className="pixel-nine-slice pixel-pressable pixel-choice-button group w-full text-left"
-                      style={getNineSliceStyle(UI_CHROME.choiceButton)}
-                    >
-                      <div className="flex items-center justify-between">
-                        <span
-                          className={`text-sm sm:text-[15px] ${getOptionActionTextClass(option)}`}
-                        >
-                          {option.actionText}
-                        </span>
-                        <PixelIcon
-                          src={CHROME_ICONS.optionArrow}
-                          className="h-3 w-3 opacity-70 transition-opacity group-hover:opacity-100"
-                        />
-                      </div>
-                      <div className="mt-1 text-[10px] leading-relaxed text-zinc-500">
-                        剧情推理完成，继续后显示新的冒险选项
-                      </div>
-                    </motion.button>
-                  );
-                }
-
-                return (
-                  <button
-                    key={`${option.functionId}-${option.actionText}-${index}`}
-                    type="button"
-                    onClick={() => handleOptionChoice(option)}
-                    disabled={optionDisabled}
-                    className={`pixel-nine-slice pixel-choice-button group w-full text-left ${optionDisabled ? 'cursor-not-allowed opacity-55' : 'pixel-pressable'}`}
-                    style={getNineSliceStyle(UI_CHROME.choiceButton)}
-                  >
-                    <div className="flex items-center justify-between">
-                      <span
-                        className={`text-sm sm:text-[15px] ${getOptionActionTextClass(option)}`}
-                      >
-                        {option.actionText}
-                      </span>
-                      <PixelIcon
-                        src={CHROME_ICONS.optionArrow}
-                        className="h-3 w-3 opacity-70 transition-opacity group-hover:opacity-100"
-                      />
-                    </div>
-                    {!isNpcChatMode && option.goalAffordance?.label && (
-                      <div
-                        className={`mt-1 text-[10px] ${getOptionGoalAffordanceClass(option)}`}
-                      >
-                        {option.goalAffordance.label}
-                      </div>
-                    )}
-                    {!isNpcChatMode &&
-                      optionImpactSummary &&
-                      !optionDisabled && (
-                        <div className="mt-1 text-[10px] text-zinc-500">
-                          {optionImpactSummary}
-                        </div>
-                      )}
-                  </button>
-                );
-              })}
-              {isNpcChatMode && !isNpcQuestOfferMode ? (
-                <div className="pixel-nine-slice pixel-panel border border-white/10 bg-black/25 p-1.5">
-                  <div className="flex min-w-0 items-center gap-2">
-                    <input
-                      value={npcChatDraft}
-                      onChange={(event) => setNpcChatDraft(event.target.value)}
-                      onKeyDown={(event) => {
-                        if (
-                          event.key === 'Enter' &&
-                          !event.nativeEvent.isComposing
-                        ) {
-                          event.preventDefault();
-                          submitNpcChatDraft();
-                        }
-                      }}
-                      placeholder={
-                        npcChatState?.customInputPlaceholder ?? '输入你想说的话'
-                      }
-                      className="h-9 min-w-0 flex-1 rounded-md border border-white/10 bg-black/35 px-3 text-sm text-zinc-100 outline-none placeholder:text-zinc-500 focus:border-amber-200/40"
-                      maxLength={80}
-                      disabled={isLoading}
-                    />
-                    <button
-                      type="button"
-                      onClick={submitNpcChatDraft}
-                      disabled={isLoading || !npcChatDraft.trim()}
-                      className="inline-flex h-9 shrink-0 items-center rounded-md border border-amber-300/20 bg-amber-500/10 px-2.5 text-[11px] text-amber-100 transition-colors disabled:cursor-not-allowed disabled:opacity-40 sm:px-3 sm:text-xs"
-                    >
-                      发送
-                    </button>
-                  </div>
-                </div>
-              ) : null}
-            </>
-          )}
-        </div>
-      </div>
-
-      {shouldMountAdventureOverlays && (
-        <Suspense fallback={<AdventurePanelOverlayLoadingFallback />}>
-          <AdventurePanelOverlays
-            worldType={worldType}
-            quests={quests}
-            questUi={questUi}
-            battleRewardUi={battleRewardUi}
-            statistics={statistics}
-            statisticsCards={statisticsCards}
-            musicVolume={musicVolume}
-            onMusicVolumeChange={onMusicVolumeChange}
-            onSaveAndExit={onSaveAndExit}
-            saveAndExitDisabled={saveAndExitDisabled}
-            isGoalPanelOpen={isGoalPanelOpen}
-            setIsGoalPanelOpen={setIsGoalPanelOpen}
-            isQuestPanelOpen={isQuestPanelOpen}
-            setIsQuestPanelOpen={setIsQuestPanelOpen}
-            isSettingsPanelOpen={isSettingsPanelOpen}
-            setIsSettingsPanelOpen={setIsSettingsPanelOpen}
-            isStatsPanelOpen={isStatsPanelOpen}
-            setIsStatsPanelOpen={setIsStatsPanelOpen}
-            chapterState={chapterState}
-            journeyBeat={journeyBeat}
-            goalStack={goalStack}
-            goalPulse={goalPulse}
-            onDismissGoalPulse={handleDismissGoalPanel}
-            selectedQuest={selectedQuest}
-            setSelectedQuestId={setSelectedQuestId}
-            completionNoticeQuest={completionNoticeQuest}
-            setCompletionNoticeQuestId={setCompletionNoticeQuestId}
-            rewardQuest={rewardQuest}
-            setRewardQuestId={setRewardQuestId}
-            rewardQuestHandoff={rewardQuestHandoff}
-            setRewardQuestHandoff={setRewardQuestHandoff}
-            selectedRewardItemQuestId={selectedRewardItemQuestId}
-            setSelectedRewardItemQuestId={setSelectedRewardItemQuestId}
-            selectedRewardItemId={selectedRewardItemId}
-            setSelectedRewardItemId={setSelectedRewardItemId}
-            selectedBattleRewardItemId={selectedBattleRewardItemId}
-            setSelectedBattleRewardItemId={setSelectedBattleRewardItemId}
-            selectedRewardItem={selectedRewardItem}
-            selectedRewardUseEffect={selectedRewardUseEffect}
-            selectedRewardEquipSlot={selectedRewardEquipSlot}
-            selectedQuestSceneName={selectedQuestSceneName}
-            getQuestStatusLabel={getQuestStatusLabel}
-            pendingNpcQuestOffer={pendingNpcQuestOffer}
-            onAcceptPendingNpcQuestOffer={() => {
-              const acceptedQuestId = npcChatQuestOfferUi.acceptPendingOffer();
-              if (!acceptedQuestId) return null;
-              setSelectedQuestId(null);
-              return acceptedQuestId;
-            }}
-          />
-        </Suspense>
-      )}
+      <RpgAdventureOverlaySection
+        shouldMountAdventureOverlays={shouldMountAdventureOverlays}
+        worldType={worldType}
+        quests={quests}
+        questUi={questUi}
+        battleRewardUi={battleRewardUi}
+        statistics={statistics}
+        statisticsCards={statisticsCards}
+        musicVolume={musicVolume}
+        onMusicVolumeChange={onMusicVolumeChange}
+        onSaveAndExit={onSaveAndExit}
+        saveAndExitDisabled={saveAndExitDisabled}
+        isGoalPanelOpen={isGoalPanelOpen}
+        setIsGoalPanelOpen={setIsGoalPanelOpen}
+        isQuestPanelOpen={isQuestPanelOpen}
+        setIsQuestPanelOpen={setIsQuestPanelOpen}
+        isSettingsPanelOpen={isSettingsPanelOpen}
+        setIsSettingsPanelOpen={setIsSettingsPanelOpen}
+        isStatsPanelOpen={isStatsPanelOpen}
+        setIsStatsPanelOpen={setIsStatsPanelOpen}
+        chapterState={chapterState}
+        journeyBeat={journeyBeat}
+        goalStack={goalStack}
+        goalPulse={goalPulse}
+        onDismissGoalPulse={handleDismissGoalPanel}
+        selectedQuest={selectedQuest}
+        setSelectedQuestId={setSelectedQuestId}
+        completionNoticeQuest={completionNoticeQuest}
+        setCompletionNoticeQuestId={setCompletionNoticeQuestId}
+        rewardQuest={rewardQuest}
+        setRewardQuestId={setRewardQuestId}
+        rewardQuestHandoff={rewardQuestHandoff}
+        setRewardQuestHandoff={setRewardQuestHandoff}
+        selectedRewardItemQuestId={selectedRewardItemQuestId}
+        setSelectedRewardItemQuestId={setSelectedRewardItemQuestId}
+        selectedRewardItemId={selectedRewardItemId}
+        setSelectedRewardItemId={setSelectedRewardItemId}
+        selectedBattleRewardItemId={selectedBattleRewardItemId}
+        setSelectedBattleRewardItemId={setSelectedBattleRewardItemId}
+        selectedRewardItem={selectedRewardItem}
+        selectedRewardUseEffect={selectedRewardUseEffect}
+        selectedRewardEquipSlot={selectedRewardEquipSlot}
+        selectedQuestSceneName={selectedQuestSceneName}
+        getQuestStatusLabel={getQuestStatusLabel}
+        pendingNpcQuestOffer={pendingNpcQuestOffer}
+        onAcceptPendingNpcQuestOffer={() => {
+          const acceptedQuestId = npcChatQuestOfferUi.acceptPendingOffer();
+          if (!acceptedQuestId) return null;
+          setSelectedQuestId(null);
+          return acceptedQuestId;
+        }}
+      />
     </div>
   );
 }
+
+export default RpgAdventurePanel;
diff --git a/src/components/adventure-panel/AdventurePanelOverlays.tsx b/src/components/rpg-runtime-panels/RpgAdventurePanelOverlays.tsx
similarity index 99%
rename from src/components/adventure-panel/AdventurePanelOverlays.tsx
rename to src/components/rpg-runtime-panels/RpgAdventurePanelOverlays.tsx
index ab0f4e6d..ea40b04f 100644
--- a/src/components/adventure-panel/AdventurePanelOverlays.tsx
+++ b/src/components/rpg-runtime-panels/RpgAdventurePanelOverlays.tsx
@@ -27,7 +27,7 @@ import { getScenePresetById } from '../../data/scenePresets';
 import type {
   BattleRewardUi,
   QuestFlowUi,
-} from '../../hooks/useStoryGeneration';
+} from '../../hooks/rpg-runtime-story';
 import { sortQuestsForGoalPanel } from '../../services/storyEngine/goalDirector';
 import type {
   ChapterState,
@@ -73,7 +73,7 @@ type AdventureStatistics = {
   rosterCompanionCount: number;
 };
 
-interface AdventurePanelOverlaysProps {
+interface RpgAdventurePanelOverlaysProps {
   worldType: WorldType | null;
   quests: QuestLogEntry[];
   questUi: QuestFlowUi;
@@ -864,7 +864,7 @@ function QuestObjectiveCard({
   );
 }
 
-export function AdventurePanelOverlays({
+export function RpgAdventurePanelOverlays({
   worldType,
   quests,
   questUi,
@@ -909,7 +909,7 @@ export function AdventurePanelOverlays({
   getQuestStatusLabel,
   pendingNpcQuestOffer,
   onAcceptPendingNpcQuestOffer,
-}: AdventurePanelOverlaysProps) {
+}: RpgAdventurePanelOverlaysProps) {
   const battleReward = battleRewardUi.reward;
   const sortedQuests = sortQuestsForGoalPanel(quests, goalStack);
   const activeGoalQuest =
diff --git a/src/components/game-shell/GameShellStoryPanels.tsx b/src/components/rpg-runtime-panels/RpgRuntimePanelRouter.tsx
similarity index 93%
rename from src/components/game-shell/GameShellStoryPanels.tsx
rename to src/components/rpg-runtime-panels/RpgRuntimePanelRouter.tsx
index 0ca1474a..451b9824 100644
--- a/src/components/game-shell/GameShellStoryPanels.tsx
+++ b/src/components/rpg-runtime-panels/RpgRuntimePanelRouter.tsx
@@ -1,6 +1,6 @@
 import { lazy, Suspense } from 'react';
 
-import type { BottomTab } from '../../hooks/useGameFlow';
+import type { BottomTab } from '../../hooks/rpg-session';
 import type {
   BattleRewardUi,
   CharacterChatUi,
@@ -8,7 +8,7 @@ import type {
   InventoryFlowUi,
   NpcChatQuestOfferUi,
   QuestFlowUi,
-} from '../../hooks/useStoryGeneration';
+} from '../../hooks/rpg-runtime-story';
 import type {
   CompanionRenderState,
   GameState,
@@ -18,14 +18,16 @@ import type {
 import { getNineSliceStyle, TAB_ICONS, UI_CHROME } from '../../uiAssets';
 import type { GameCanvasEntitySelection } from '../GameCanvas';
 import { PixelIcon } from '../PixelIcon';
-import { PanelLoadingFallback } from './GameShellLoaders';
-import type { GameShellAdventureStatistics } from './types';
+import {
+  PanelLoadingFallback,
+  type RpgAdventureStatistics,
+} from '../rpg-runtime-shell';
 
-const AdventurePanel = lazy(async () => {
-  const module = await import('../AdventurePanel');
+const RpgAdventurePanel = lazy(async () => {
+  const module = await import('./RpgAdventurePanel');
 
   return {
-    default: module.AdventurePanel,
+    default: module.RpgAdventurePanel,
   };
 });
 
@@ -45,7 +47,42 @@ const InventoryPanel = lazy(async () => {
   };
 });
 
-export function GameShellStoryPanels({
+export interface RpgRuntimePanelRouterProps {
+  visibleGameState: GameState;
+  visibleCurrentStory: StoryMoment;
+  isLoading: boolean;
+  aiError: string | null;
+  bottomTab: BottomTab;
+  setBottomTab: (tab: BottomTab) => void;
+  displayedOptions: StoryOption[];
+  hideStoryOptions: boolean;
+  canRefreshOptions: boolean;
+  handleRefreshOptions: () => void;
+  handleSceneTransitionChoice: (option: StoryOption) => void;
+  handleNpcChatInput: (input: string) => boolean;
+  exitNpcChat: () => boolean;
+  characterChatUi: CharacterChatUi;
+  inventoryUi: InventoryFlowUi;
+  battleRewardUi: BattleRewardUi;
+  questUi: QuestFlowUi;
+  npcChatQuestOfferUi: NpcChatQuestOfferUi;
+  goalUi: GoalFlowUi;
+  companionRenderStates: CompanionRenderState[];
+  characterChatSummaries: Record<string, string>;
+  openOverlayPanel: (panel: 'character' | 'inventory') => void;
+  openCampModal: () => void;
+  openPartyMemberDetails: (selection: GameCanvasEntitySelection) => void;
+  adventureStatistics: RpgAdventureStatistics;
+  musicVolume: number;
+  onMusicVolumeChange: (value: number) => void;
+  onSaveAndExit: () => void;
+}
+
+/**
+ * RPG 运行态主面板路由器。
+ * 只负责冒险 / 角色 / 背包三个主标签的切换和装配。
+ */
+export function RpgRuntimePanelRouter({
   visibleGameState,
   visibleCurrentStory,
   isLoading,
@@ -74,36 +111,7 @@ export function GameShellStoryPanels({
   musicVolume,
   onMusicVolumeChange,
   onSaveAndExit,
-}: {
-  visibleGameState: GameState;
-  visibleCurrentStory: StoryMoment;
-  isLoading: boolean;
-  aiError: string | null;
-  bottomTab: BottomTab;
-  setBottomTab: (tab: BottomTab) => void;
-  displayedOptions: StoryOption[];
-  hideStoryOptions: boolean;
-  canRefreshOptions: boolean;
-  handleRefreshOptions: () => void;
-  handleSceneTransitionChoice: (option: StoryOption) => void;
-  handleNpcChatInput: (input: string) => boolean;
-  exitNpcChat: () => boolean;
-  characterChatUi: CharacterChatUi;
-  inventoryUi: InventoryFlowUi;
-  battleRewardUi: BattleRewardUi;
-  questUi: QuestFlowUi;
-  npcChatQuestOfferUi: NpcChatQuestOfferUi;
-  goalUi: GoalFlowUi;
-  companionRenderStates: CompanionRenderState[];
-  characterChatSummaries: Record<string, string>;
-  openOverlayPanel: (panel: 'character' | 'inventory') => void;
-  openCampModal: () => void;
-  openPartyMemberDetails: (selection: GameCanvasEntitySelection) => void;
-  adventureStatistics: GameShellAdventureStatistics;
-  musicVolume: number;
-  onMusicVolumeChange: (value: number) => void;
-  onSaveAndExit: () => void;
-}) {
+}: RpgRuntimePanelRouterProps) {
   const playerCharacter = visibleGameState.playerCharacter;
   if (!playerCharacter) {
     return null;
@@ -212,7 +220,7 @@ export function GameShellStoryPanels({
 
       {bottomTab === 'adventure' && (
         <Suspense fallback={<PanelLoadingFallback label="正在加载冒险面板" />}>
-          <AdventurePanel
+          <RpgAdventurePanel
             aiError={aiError}
             currentStory={visibleCurrentStory}
             isLoading={isLoading}
@@ -286,3 +294,5 @@ export function GameShellStoryPanels({
     </>
   );
 }
+
+export default RpgRuntimePanelRouter;
diff --git a/src/components/rpg-runtime-panels/index.ts b/src/components/rpg-runtime-panels/index.ts
new file mode 100644
index 00000000..5811805e
--- /dev/null
+++ b/src/components/rpg-runtime-panels/index.ts
@@ -0,0 +1,8 @@
+export {
+  RpgAdventurePanel,
+  type RpgAdventurePanelProps,
+} from './RpgAdventurePanel';
+export {
+  RpgRuntimePanelRouter,
+  type RpgRuntimePanelRouterProps,
+} from './RpgRuntimePanelRouter';
diff --git a/src/components/game-shell/GameShellCanvasStage.tsx b/src/components/rpg-runtime-shell/RpgRuntimeCanvasStage.tsx
similarity index 76%
rename from src/components/game-shell/GameShellCanvasStage.tsx
rename to src/components/rpg-runtime-shell/RpgRuntimeCanvasStage.tsx
index c35aacef..c9722d36 100644
--- a/src/components/game-shell/GameShellCanvasStage.tsx
+++ b/src/components/rpg-runtime-shell/RpgRuntimeCanvasStage.tsx
@@ -1,12 +1,29 @@
-import type {
-  CompanionRenderState,
-  GameState,
-} from '../../types';
+import type { CompanionRenderState, GameState } from '../../types';
 import type { GameCanvasEntitySelection } from '../GameCanvas';
-import type { GameShellDialogueIndicator } from './types';
 import { GameCanvas } from '../GameCanvas';
+import type { RpgRuntimeDialogueIndicator } from './types';
 
-export function GameShellCanvasStage({
+export interface RpgRuntimeCanvasStageProps {
+  gameState: GameState;
+  visibleGameState: GameState;
+  hideSelectionHero: boolean;
+  canvasCompanionRenderStates: CompanionRenderState[];
+  dialogueIndicator: RpgRuntimeDialogueIndicator | null;
+  sceneTransitionPhase: 'idle' | 'exiting' | 'entering';
+  sceneTransitionToken: number;
+  setSelectedSceneEntity: (selection: GameCanvasEntitySelection | null) => void;
+  setIsMapOpen: (open: boolean) => void;
+  setSceneTransitionDurations: (durations: {
+    exitMs: number;
+    entryMs: number;
+  }) => void;
+}
+
+/**
+ * RPG 运行态画布舞台真实入口。
+ * 第三批收口后，运行态主链不再依赖旧 `GameShellCanvasStage` 命名。
+ */
+export function RpgRuntimeCanvasStage({
   gameState,
   visibleGameState,
   hideSelectionHero,
@@ -17,20 +34,11 @@ export function GameShellCanvasStage({
   setSelectedSceneEntity,
   setIsMapOpen,
   setSceneTransitionDurations,
-}: {
-  gameState: GameState;
-  visibleGameState: GameState;
-  hideSelectionHero: boolean;
-  canvasCompanionRenderStates: CompanionRenderState[];
-  dialogueIndicator: GameShellDialogueIndicator | null;
-  sceneTransitionPhase: 'idle' | 'exiting' | 'entering';
-  sceneTransitionToken: number;
-  setSelectedSceneEntity: (selection: GameCanvasEntitySelection | null) => void;
-  setIsMapOpen: (open: boolean) => void;
-  setSceneTransitionDurations: (durations: { exitMs: number; entryMs: number }) => void;
-}) {
+}: RpgRuntimeCanvasStageProps) {
   return (
-    <div className={`relative ${hideSelectionHero ? 'h-0 border-b-0' : 'h-[36%] border-b border-white/5'}`}>
+    <div
+      className={`relative ${hideSelectionHero ? 'h-0 border-b-0' : 'h-[36%] border-b border-white/5'}`}
+    >
       {hideSelectionHero ? null : (
         <GameCanvas
           scrollWorld={visibleGameState.scrollWorld}
@@ -65,3 +73,5 @@ export function GameShellCanvasStage({
     </div>
   );
 }
+
+export default RpgRuntimeCanvasStage;
diff --git a/src/components/game-shell/GameShellOverlays.tsx b/src/components/rpg-runtime-shell/RpgRuntimeOverlayHost.tsx
similarity index 92%
rename from src/components/game-shell/GameShellOverlays.tsx
rename to src/components/rpg-runtime-shell/RpgRuntimeOverlayHost.tsx
index d4cb0445..48e3abc1 100644
--- a/src/components/game-shell/GameShellOverlays.tsx
+++ b/src/components/rpg-runtime-shell/RpgRuntimeOverlayHost.tsx
@@ -5,12 +5,15 @@ import type {
   CharacterChatUi,
   InventoryFlowUi,
   StoryGenerationNpcUi,
-} from '../../hooks/useStoryGeneration';
+} from '../../hooks/rpg-runtime-story';
 import type { CompanionRenderState, GameState } from '../../types';
 import { CHROME_ICONS, getNineSliceStyle, UI_CHROME } from '../../uiAssets';
 import type { GameCanvasEntitySelection } from '../GameCanvas';
 import { PixelIcon } from '../PixelIcon';
-import { ModalLoadingFallback, PanelLoadingFallback } from './GameShellLoaders';
+import {
+  ModalLoadingFallback,
+  PanelLoadingFallback,
+} from './rpgRuntimeLoaders';
 
 const AdventureEntityModal = lazy(async () => {
   const module = await import('../AdventureEntityModal');
@@ -68,33 +71,7 @@ const InventoryPanel = lazy(async () => {
   };
 });
 
-export function GameShellOverlays({
-  gameState,
-  isLoading,
-  isMapOpen,
-  setIsMapOpen,
-  npcUi,
-  characterChatUi,
-  inventoryUi,
-  companionRenderStates,
-  characterChatSummaries,
-  overlayPanel,
-  closeOverlayPanel,
-  openCampModal,
-  openPartyMemberDetails,
-  shouldMountAdventureEntityModal,
-  selectedSceneEntity,
-  closeAdventureEntityModal,
-  shouldMountCampModal,
-  showTeamModal,
-  closeCampModal,
-  onBenchCompanion,
-  onActivateRosterCompanion,
-  shouldMountMapModal,
-  handleMapTravelToScene,
-  shouldMountCharacterChatModal,
-  shouldMountNpcModals,
-}: {
+export interface RpgRuntimeOverlayHostProps {
   gameState: GameState;
   isLoading: boolean;
   isMapOpen: boolean;
@@ -120,7 +97,39 @@ export function GameShellOverlays({
   handleMapTravelToScene: (sceneId: string) => boolean;
   shouldMountCharacterChatModal: boolean;
   shouldMountNpcModals: boolean;
-}) {
+}
+
+/**
+ * RPG 运行态 overlay host。
+ * 这里保留原有弹窗与独立面板装配方式，只把实现位置迁到 RPG 域目录。
+ */
+export function RpgRuntimeOverlayHost({
+  gameState,
+  isLoading,
+  isMapOpen,
+  setIsMapOpen,
+  npcUi,
+  characterChatUi,
+  inventoryUi,
+  companionRenderStates,
+  characterChatSummaries,
+  overlayPanel,
+  closeOverlayPanel,
+  openCampModal,
+  openPartyMemberDetails,
+  shouldMountAdventureEntityModal,
+  selectedSceneEntity,
+  closeAdventureEntityModal,
+  shouldMountCampModal,
+  showTeamModal,
+  closeCampModal,
+  onBenchCompanion,
+  onActivateRosterCompanion,
+  shouldMountMapModal,
+  handleMapTravelToScene,
+  shouldMountCharacterChatModal,
+  shouldMountNpcModals,
+}: RpgRuntimeOverlayHostProps) {
   return (
     <>
       {shouldMountAdventureEntityModal && (
@@ -222,6 +231,15 @@ export function GameShellOverlays({
                       onCraftRecipe={inventoryUi.craftRecipe}
                       onDismantleItem={inventoryUi.dismantleItem}
                       onReforgeItem={inventoryUi.reforgeItem}
+                      continueGameDigest={
+                        gameState.storyEngineMemory?.continueGameDigest ?? null
+                      }
+                      narrativeCodex={
+                        gameState.storyEngineMemory?.narrativeCodex ?? []
+                      }
+                      narrativeQaReport={
+                        gameState.storyEngineMemory?.narrativeQaReport ?? null
+                      }
                     />
                   </Suspense>
                 )}
@@ -309,3 +327,5 @@ export function GameShellOverlays({
     </>
   );
 }
+
+export default RpgRuntimeOverlayHost;
diff --git a/src/components/game-shell/GameShellRuntime.tsx b/src/components/rpg-runtime-shell/RpgRuntimeShell.tsx
similarity index 89%
rename from src/components/game-shell/GameShellRuntime.tsx
rename to src/components/rpg-runtime-shell/RpgRuntimeShell.tsx
index 840f4861..5ae6ba34 100644
--- a/src/components/game-shell/GameShellRuntime.tsx
+++ b/src/components/rpg-runtime-shell/RpgRuntimeShell.tsx
@@ -3,30 +3,30 @@ import { lazy, Suspense } from 'react';
 import { normalizePlayerProgressionState } from '../../data/playerProgression';
 import { UI_CHROME } from '../../uiAssets';
 import { useAuthUi } from '../auth/AuthUiContext';
-import { GameShellMainContent } from './GameShellMainContent';
-import type { GameShellProps } from './types';
-import { useGameShellRuntimeViewModel } from './useGameShellRuntimeViewModel';
+import { RpgRuntimeCanvasStage } from './RpgRuntimeCanvasStage';
+import type { RpgRuntimeShellProps as RpgRuntimeShellComponentProps } from './types';
+import { RpgRuntimeStageRouter } from './RpgRuntimeStageRouter';
+import { useRpgRuntimeShellViewModel } from './useRpgRuntimeShellViewModel';
 
-const GameShellOverlays = lazy(async () => {
-  const module = await import('./GameShellOverlays');
+const RpgRuntimeOverlayHost = lazy(async () => {
+  const module = await import('./RpgRuntimeOverlayHost');
   return {
-    default: module.GameShellOverlays,
-  };
-});
-const GameShellCanvasStage = lazy(async () => {
-  const module = await import('./GameShellCanvasStage');
-  return {
-    default: module.GameShellCanvasStage,
+    default: module.RpgRuntimeOverlayHost,
   };
 });
 
-export function GameShellRuntime({
+/**
+ * RPG 运行态总外壳。
+ * 这里承接运行时主布局、画布舞台、主阶段路由和 overlay host，
+ * 保持原有 UI 结构不变，只把真实实现迁入 RPG 域目录。
+ */
+export function RpgRuntimeShell({
   session,
   story,
   entry,
   companions,
   audio,
-}: GameShellProps) {
+}: RpgRuntimeShellComponentProps) {
   const authUi = useAuthUi();
   const isPlatformShell = !session.gameState.worldType;
   const platformThemeClass =
@@ -102,7 +102,7 @@ export function GameShellRuntime({
     canvasCompanionRenderStates,
     adventureStatistics,
     handleSceneTransitionChoice,
-  } = useGameShellRuntimeViewModel({
+  } = useRpgRuntimeShellViewModel({
     session,
     story,
     companions,
@@ -133,7 +133,7 @@ export function GameShellRuntime({
       }}
     >
       <Suspense fallback={null}>
-        <GameShellCanvasStage
+        <RpgRuntimeCanvasStage
           gameState={gameState}
           visibleGameState={visibleGameState}
           hideSelectionHero={hideSelectionHero}
@@ -177,7 +177,7 @@ export function GameShellRuntime({
         </div>
       )}
 
-      <GameShellMainContent
+      <RpgRuntimeStageRouter
         gameState={gameState}
         visibleGameState={visibleGameState}
         visibleCurrentStory={visibleCurrentStory}
@@ -221,7 +221,7 @@ export function GameShellRuntime({
       />
 
       <Suspense fallback={null}>
-        <GameShellOverlays
+        <RpgRuntimeOverlayHost
           gameState={gameState}
           isLoading={isLoading}
           isMapOpen={isMapOpen}
@@ -252,3 +252,7 @@ export function GameShellRuntime({
     </div>
   );
 }
+
+export type RpgRuntimeShellProps = RpgRuntimeShellComponentProps;
+
+export default RpgRuntimeShell;
diff --git a/src/components/game-shell/GameShellMainContent.tsx b/src/components/rpg-runtime-shell/RpgRuntimeStageRouter.tsx
similarity index 85%
rename from src/components/game-shell/GameShellMainContent.tsx
rename to src/components/rpg-runtime-shell/RpgRuntimeStageRouter.tsx
index e62282ba..f6d77860 100644
--- a/src/components/game-shell/GameShellMainContent.tsx
+++ b/src/components/rpg-runtime-shell/RpgRuntimeStageRouter.tsx
@@ -1,7 +1,7 @@
 import { AnimatePresence, motion } from 'motion/react';
 import { lazy, Suspense } from 'react';
 
-import type { BottomTab } from '../../hooks/useGameFlow';
+import type { BottomTab } from '../../hooks/rpg-session';
 import type {
   BattleRewardUi,
   CharacterChatUi,
@@ -9,7 +9,7 @@ import type {
   InventoryFlowUi,
   NpcChatQuestOfferUi,
   QuestFlowUi,
-} from '../../hooks/useStoryGeneration';
+} from '../../hooks/rpg-runtime-story';
 import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
 import type {
   CompanionRenderState,
@@ -20,25 +20,27 @@ import type {
 } from '../../types';
 import { UI_CHROME } from '../../uiAssets';
 import type { GameCanvasEntitySelection } from '../GameCanvas';
-import type { SelectionStage } from './PreGameSelectionFlow';
-import type { GameShellAdventureStatistics } from './types';
+import type { SelectionStage } from '../rpg-entry';
+import type { RpgAdventureStatistics } from './types';
 
-const CharacterSelectionFlow = lazy(async () => {
-  const module = await import('./CharacterSelectionFlow');
+const RpgEntryCharacterSelectView = lazy(async () => {
+  const module = await import('../rpg-entry');
   return {
-    default: module.CharacterSelectionFlow,
+    default: module.RpgEntryCharacterSelectView,
   };
 });
-const PreGameSelectionFlow = lazy(async () => {
-  const module = await import('./PreGameSelectionFlow');
+
+const RpgEntryFlowShell = lazy(async () => {
+  const module = await import('../rpg-entry');
   return {
-    default: module.PreGameSelectionFlow,
+    default: module.RpgEntryFlowShell,
   };
 });
-const GameShellStoryPanels = lazy(async () => {
-  const module = await import('./GameShellStoryPanels');
+
+const RpgRuntimePanelRouter = lazy(async () => {
+  const module = await import('../rpg-runtime-panels');
   return {
-    default: module.GameShellStoryPanels,
+    default: module.RpgRuntimePanelRouter,
   };
 });
 
@@ -52,7 +54,54 @@ function MainContentLoadingFallback({ label }: { label: string }) {
   );
 }
 
-export function GameShellMainContent({
+export interface RpgRuntimeStageRouterProps {
+  gameState: GameState;
+  visibleGameState: GameState;
+  visibleCurrentStory: StoryMoment | null;
+  isLoading: boolean;
+  aiError: string | null;
+  bottomTab: BottomTab;
+  setBottomTab: (tab: BottomTab) => void;
+  selectionStage: SelectionStage;
+  setSelectionStage: (stage: SelectionStage) => void;
+  isCharacterSelectionStage: boolean;
+  hasSavedGame: boolean;
+  savedSnapshot: HydratedSavedGameSnapshot | null;
+  handleContinueGame: (snapshot?: HydratedSavedGameSnapshot | null) => void;
+  handleStartNewGame: () => void;
+  handleCustomWorldSelect: (customWorldProfile: CustomWorldProfile) => void;
+  handleBackToWorldSelect: () => void;
+  handleCharacterSelect: (character: NonNullable<GameState['playerCharacter']>) => void;
+  displayedOptions: StoryOption[];
+  hideStoryOptions: boolean;
+  canRefreshOptions: boolean;
+  handleRefreshOptions: () => void;
+  handleSceneTransitionChoice: (option: StoryOption) => void;
+  handleNpcChatInput: (input: string) => boolean;
+  exitNpcChat: () => boolean;
+  characterChatUi: CharacterChatUi;
+  inventoryUi: InventoryFlowUi;
+  battleRewardUi: BattleRewardUi;
+  questUi: QuestFlowUi;
+  npcChatQuestOfferUi: NpcChatQuestOfferUi;
+  goalUi: GoalFlowUi;
+  companionRenderStates: CompanionRenderState[];
+  characterChatSummaries: Record<string, string>;
+  openOverlayPanel: (panel: 'character' | 'inventory') => void;
+  openCampModal: () => void;
+  openPartyMemberDetails: (selection: GameCanvasEntitySelection) => void;
+  adventureStatistics: RpgAdventureStatistics;
+  musicVolume: number;
+  onMusicVolumeChange: (value: number) => void;
+  resetForSaveAndExit: () => void;
+  handleSaveAndExit: () => void;
+}
+
+/**
+ * RPG 运行态主阶段路由器。
+ * 这里只负责平台入口、角色选择、冒险运行态三个阶段的切换，不承接更细的面板实现。
+ */
+export function RpgRuntimeStageRouter({
   gameState,
   visibleGameState,
   visibleCurrentStory,
@@ -93,48 +142,7 @@ export function GameShellMainContent({
   onMusicVolumeChange,
   resetForSaveAndExit,
   handleSaveAndExit,
-}: {
-  gameState: GameState;
-  visibleGameState: GameState;
-  visibleCurrentStory: StoryMoment | null;
-  isLoading: boolean;
-  aiError: string | null;
-  bottomTab: BottomTab;
-  setBottomTab: (tab: BottomTab) => void;
-  selectionStage: SelectionStage;
-  setSelectionStage: (stage: SelectionStage) => void;
-  isCharacterSelectionStage: boolean;
-  hasSavedGame: boolean;
-  savedSnapshot: HydratedSavedGameSnapshot | null;
-  handleContinueGame: (snapshot?: HydratedSavedGameSnapshot | null) => void;
-  handleStartNewGame: () => void;
-  handleCustomWorldSelect: (customWorldProfile: CustomWorldProfile) => void;
-  handleBackToWorldSelect: () => void;
-  handleCharacterSelect: (character: NonNullable<GameState['playerCharacter']>) => void;
-  displayedOptions: StoryOption[];
-  hideStoryOptions: boolean;
-  canRefreshOptions: boolean;
-  handleRefreshOptions: () => void;
-  handleSceneTransitionChoice: (option: StoryOption) => void;
-  handleNpcChatInput: (input: string) => boolean;
-  exitNpcChat: () => boolean;
-  characterChatUi: CharacterChatUi;
-  inventoryUi: InventoryFlowUi;
-  battleRewardUi: BattleRewardUi;
-  questUi: QuestFlowUi;
-  npcChatQuestOfferUi: NpcChatQuestOfferUi;
-  goalUi: GoalFlowUi;
-  companionRenderStates: CompanionRenderState[];
-  characterChatSummaries: Record<string, string>;
-  openOverlayPanel: (panel: 'character' | 'inventory') => void;
-  openCampModal: () => void;
-  openPartyMemberDetails: (selection: GameCanvasEntitySelection) => void;
-  adventureStatistics: GameShellAdventureStatistics;
-  musicVolume: number;
-  onMusicVolumeChange: (value: number) => void;
-  resetForSaveAndExit: () => void;
-  handleSaveAndExit: () => void;
-}) {
+}: RpgRuntimeStageRouterProps) {
   const isPlatformShell = !gameState.worldType;
 
   return (
@@ -161,7 +169,7 @@ export function GameShellMainContent({
           <Suspense
             fallback={<MainContentLoadingFallback label="正在加载平台首页..." />}
           >
-            <PreGameSelectionFlow
+            <RpgEntryFlowShell
               selectionStage={selectionStage}
               setSelectionStage={setSelectionStage}
               gameState={gameState}
@@ -185,7 +193,7 @@ export function GameShellMainContent({
             <Suspense
               fallback={<MainContentLoadingFallback label="正在加载角色选择..." />}
             >
-              <CharacterSelectionFlow
+              <RpgEntryCharacterSelectView
                 worldType={gameState.worldType}
                 customWorldProfile={gameState.customWorldProfile}
                 onBack={() => {
@@ -199,11 +207,16 @@ export function GameShellMainContent({
         )}
 
         {visibleGameState.playerCharacter && visibleCurrentStory && (
-          <motion.div key="story-flow" initial={{ opacity: 0 }} animate={{ opacity: 1 }} className="flex h-full min-h-0 flex-col">
+          <motion.div
+            key="story-flow"
+            initial={{ opacity: 0 }}
+            animate={{ opacity: 1 }}
+            className="flex h-full min-h-0 flex-col"
+          >
             <Suspense
               fallback={<MainContentLoadingFallback label="正在加载冒险面板..." />}
             >
-              <GameShellStoryPanels
+              <RpgRuntimePanelRouter
                 visibleGameState={visibleGameState}
                 visibleCurrentStory={visibleCurrentStory}
                 isLoading={isLoading}
@@ -243,3 +256,5 @@ export function GameShellMainContent({
     </div>
   );
 }
+
+export default RpgRuntimeStageRouter;
diff --git a/src/components/rpg-runtime-shell/index.ts b/src/components/rpg-runtime-shell/index.ts
new file mode 100644
index 00000000..84f64ee2
--- /dev/null
+++ b/src/components/rpg-runtime-shell/index.ts
@@ -0,0 +1,36 @@
+export {
+  RpgRuntimeCanvasStage,
+  type RpgRuntimeCanvasStageProps,
+} from './RpgRuntimeCanvasStage';
+export {
+  RpgRuntimeOverlayHost,
+  type RpgRuntimeOverlayHostProps,
+} from './RpgRuntimeOverlayHost';
+export {
+  RpgRuntimeShell,
+  type RpgRuntimeShellProps,
+} from './RpgRuntimeShell';
+export {
+  RpgRuntimeStageRouter,
+  type RpgRuntimeStageRouterProps,
+} from './RpgRuntimeStageRouter';
+export {
+  type RpgAdventureStatistics,
+  type RpgRuntimeDialogueIndicator,
+} from './types';
+export {
+  ModalLoadingFallback,
+  PanelLoadingFallback,
+} from './rpgRuntimeLoaders';
+export {
+  useRpgRuntimeShellViewModel,
+  type RpgRuntimeShellViewModelResult,
+  type UseRpgRuntimeShellViewModelParams,
+} from './useRpgRuntimeShellViewModel';
+export { useRpgRuntimeOverlayState } from './useRpgRuntimeOverlayState';
+export {
+  SCENE_TRANSITION_FUNCTION_MODES,
+  useRpgSceneTransitionModel,
+  type SceneTransitionPhase,
+  type SceneTransitionTriggerMode,
+} from './useRpgSceneTransitionModel';
diff --git a/src/components/game-shell/GameShellLoaders.tsx b/src/components/rpg-runtime-shell/rpgRuntimeLoaders.tsx
similarity index 62%
rename from src/components/game-shell/GameShellLoaders.tsx
rename to src/components/rpg-runtime-shell/rpgRuntimeLoaders.tsx
index 88a67aba..3d86aa14 100644
--- a/src/components/game-shell/GameShellLoaders.tsx
+++ b/src/components/rpg-runtime-shell/rpgRuntimeLoaders.tsx
@@ -1,5 +1,9 @@
 import { getNineSliceStyle, UI_CHROME } from '../../uiAssets';
 
+/**
+ * RPG 运行态模态加载占位。
+ * 第三批收口后真实落点迁入 `rpg-runtime-shell`。
+ */
 export function ModalLoadingFallback({
   label,
   onClose,
@@ -15,7 +19,7 @@ export function ModalLoadingFallback({
       <div
         className="pixel-nine-slice pixel-modal-shell flex min-h-40 w-full max-w-md items-center justify-center px-6 py-8 text-center text-sm text-zinc-300 shadow-[0_24px_80px_rgba(0,0,0,0.55)]"
         style={getNineSliceStyle(UI_CHROME.modalPanel)}
-        onClick={event => event.stopPropagation()}
+        onClick={(event) => event.stopPropagation()}
       >
         {label}
       </div>
@@ -23,13 +27,20 @@ export function ModalLoadingFallback({
   );
 }
 
+/**
+ * RPG 运行态面板加载占位。
+ * 仅迁移命名落点，不改 UI 表现。
+ */
 export function PanelLoadingFallback({
   label,
 }: {
   label: string;
 }) {
   return (
-    <div className="pixel-nine-slice flex min-h-0 flex-1 items-center justify-center px-4 py-6 text-center text-xs uppercase tracking-[0.24em] text-zinc-500" style={getNineSliceStyle(UI_CHROME.modalPanel)}>
+    <div
+      className="pixel-nine-slice flex min-h-0 flex-1 items-center justify-center px-4 py-6 text-center text-xs uppercase tracking-[0.24em] text-zinc-500"
+      style={getNineSliceStyle(UI_CHROME.modalPanel)}
+    >
       {label}
     </div>
   );
diff --git a/src/components/game-shell/types.ts b/src/components/rpg-runtime-shell/types.ts
similarity index 80%
rename from src/components/game-shell/types.ts
rename to src/components/rpg-runtime-shell/types.ts
index 42486cfa..58be638d 100644
--- a/src/components/game-shell/types.ts
+++ b/src/components/rpg-runtime-shell/types.ts
@@ -1,4 +1,4 @@
-import type { BottomTab } from '../../hooks/useGameFlow';
+import type { BottomTab } from '../../hooks/rpg-session';
 import type {
   BattleRewardUi,
   CharacterChatUi,
@@ -7,7 +7,7 @@ import type {
   NpcChatQuestOfferUi,
   QuestFlowUi,
   StoryGenerationNpcUi,
-} from '../../hooks/useStoryGeneration';
+} from '../../hooks/rpg-runtime-story';
 import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
 import type {
   Character,
@@ -18,7 +18,7 @@ import type {
   StoryOption,
 } from '../../types';
 
-export interface GameShellSessionProps {
+export interface RpgRuntimeSessionProps {
   gameState: GameState;
   currentStory: StoryMoment | null;
   isLoading: boolean;
@@ -29,7 +29,7 @@ export interface GameShellSessionProps {
   setIsMapOpen: (open: boolean) => void;
 }
 
-export interface GameShellStoryProps {
+export interface RpgRuntimeStoryProps {
   displayedOptions: StoryOption[];
   canRefreshOptions: boolean;
   handleRefreshOptions: () => void;
@@ -46,7 +46,7 @@ export interface GameShellStoryProps {
   goalUi: GoalFlowUi;
 }
 
-export interface GameShellEntryProps {
+export interface RpgEntrySessionProps {
   hasSavedGame: boolean;
   savedSnapshot: HydratedSavedGameSnapshot | null;
   handleContinueGame: (snapshot?: HydratedSavedGameSnapshot | null) => void;
@@ -57,25 +57,25 @@ export interface GameShellEntryProps {
   handleCharacterSelect: (character: Character) => void;
 }
 
-export interface GameShellCompanionProps {
+export interface RpgRuntimeCompanionProps {
   companionRenderStates: CompanionRenderState[];
   buildCompanionRenderStates: (state: GameState) => CompanionRenderState[];
   onBenchCompanion: (npcId: string) => void;
   onActivateRosterCompanion: (npcId: string, swapNpcId?: string | null) => void;
 }
 
-export interface GameShellAudioProps {
+export interface RpgRuntimeAudioProps {
   musicVolume: number;
   onMusicVolumeChange: (value: number) => void;
 }
 
-export interface GameShellDialogueIndicator {
+export interface RpgRuntimeDialogueIndicator {
   showPlayer: boolean;
   showEncounter: boolean;
   activeSpeaker?: 'player' | 'npc' | null;
 }
 
-export interface GameShellAdventureStatistics {
+export interface RpgAdventureStatistics {
   playTimeMs: number;
   hostileNpcsDefeated: number;
   questsAccepted: number;
@@ -95,10 +95,10 @@ export interface GameShellAdventureStatistics {
   rosterCompanionCount: number;
 }
 
-export interface GameShellProps {
-  session: GameShellSessionProps;
-  story: GameShellStoryProps;
-  entry: GameShellEntryProps;
-  companions: GameShellCompanionProps;
-  audio: GameShellAudioProps;
+export interface RpgRuntimeShellProps {
+  session: RpgRuntimeSessionProps;
+  story: RpgRuntimeStoryProps;
+  entry: RpgEntrySessionProps;
+  companions: RpgRuntimeCompanionProps;
+  audio: RpgRuntimeAudioProps;
 }
diff --git a/src/components/game-shell/useGameShellViewModel.ts b/src/components/rpg-runtime-shell/useRpgRuntimeOverlayState.ts
similarity index 79%
rename from src/components/game-shell/useGameShellViewModel.ts
rename to src/components/rpg-runtime-shell/useRpgRuntimeOverlayState.ts
index dcecf9c6..48a70066 100644
--- a/src/components/game-shell/useGameShellViewModel.ts
+++ b/src/components/rpg-runtime-shell/useRpgRuntimeOverlayState.ts
@@ -2,7 +2,7 @@ import { useEffect, useState } from 'react';
 
 import type { GameState } from '../../types';
 import type { GameCanvasEntitySelection } from '../GameCanvas';
-import type { SelectionStage } from './PreGameSelectionFlow';
+import type { SelectionStage } from '../rpg-entry';
 
 type OverlayPanel = 'character' | 'inventory' | null;
 
@@ -18,7 +18,11 @@ function useLazyModalMount(active: boolean) {
   return shouldMount;
 }
 
-export function useGameShellViewModel(params: {
+/**
+ * RPG 运行态 overlay 与独立面板状态。
+ * 负责保留现有弹窗装配顺序，同时把壳层 UI 状态从旧 GameShell 命名迁出。
+ */
+export function useRpgRuntimeOverlayState(params: {
   gameState: GameState;
   isMapOpen: boolean;
   characterChatModalOpen: boolean;
@@ -32,17 +36,22 @@ export function useGameShellViewModel(params: {
   } = params;
   const [selectionStage, setSelectionStage] = useState<SelectionStage>('platform');
   const [overlayPanel, setOverlayPanel] = useState<OverlayPanel>(null);
-  const [selectedSceneEntity, setSelectedSceneEntity] = useState<GameCanvasEntitySelection | null>(null);
+  const [selectedSceneEntity, setSelectedSceneEntity] =
+    useState<GameCanvasEntitySelection | null>(null);
   const [showTeamModal, setShowTeamModal] = useState(false);
 
   useEffect(() => {
     setSelectedSceneEntity(null);
   }, [gameState.currentScenePreset?.id, gameState.playerCharacter?.id]);
 
-  const shouldMountAdventureEntityModal = useLazyModalMount(Boolean(selectedSceneEntity));
+  const shouldMountAdventureEntityModal = useLazyModalMount(
+    Boolean(selectedSceneEntity),
+  );
   const shouldMountCampModal = useLazyModalMount(showTeamModal);
   const shouldMountMapModal = useLazyModalMount(isMapOpen);
-  const shouldMountCharacterChatModal = useLazyModalMount(characterChatModalOpen);
+  const shouldMountCharacterChatModal = useLazyModalMount(
+    characterChatModalOpen,
+  );
   const shouldMountNpcModals = useLazyModalMount(hasNpcModalOpen);
 
   const openOverlayPanel = (panel: Exclude<OverlayPanel, null>) => {
@@ -51,7 +60,8 @@ export function useGameShellViewModel(params: {
   };
 
   const closeOverlayPanel = () => setOverlayPanel(null);
-  const openPartyMemberDetails = (selection: GameCanvasEntitySelection) => setSelectedSceneEntity(selection);
+  const openPartyMemberDetails = (selection: GameCanvasEntitySelection) =>
+    setSelectedSceneEntity(selection);
   const closeAdventureEntityModal = () => setSelectedSceneEntity(null);
   const openCampModal = () => setShowTeamModal(true);
   const closeCampModal = () => setShowTeamModal(false);
diff --git a/src/components/game-shell/useGameShellRuntimeViewModel.test.ts b/src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.test.ts
similarity index 95%
rename from src/components/game-shell/useGameShellRuntimeViewModel.test.ts
rename to src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.test.ts
index 5542ec03..796fa42d 100644
--- a/src/components/game-shell/useGameShellRuntimeViewModel.test.ts
+++ b/src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.test.ts
@@ -6,8 +6,8 @@ import {
   buildAdventureStatistics,
   buildCanvasCompanionRenderStates,
   buildCharacterChatSummaries,
-  buildGameShellDialogueIndicator,
-} from './useGameShellRuntimeViewModel';
+  buildRpgRuntimeDialogueIndicator,
+} from '../rpg-runtime-shell/useRpgRuntimeShellViewModel';
 
 function createBaseGameState(): GameState {
   return {
@@ -169,7 +169,7 @@ function createBaseGameState(): GameState {
   };
 }
 
-describe('useGameShellRuntimeViewModel helpers', () => {
+describe('useRpgRuntimeShellViewModel helpers', () => {
   it('builds a dialogue indicator only for active npc dialogue playback', () => {
     const state = {
       ...createBaseGameState(),
@@ -199,7 +199,7 @@ describe('useGameShellRuntimeViewModel helpers', () => {
     } satisfies StoryMoment;
 
     expect(
-      buildGameShellDialogueIndicator({
+      buildRpgRuntimeDialogueIndicator({
         isLoading: true,
         visibleGameState: state,
         visibleCurrentStory: story,
@@ -211,7 +211,7 @@ describe('useGameShellRuntimeViewModel helpers', () => {
     });
 
     expect(
-      buildGameShellDialogueIndicator({
+      buildRpgRuntimeDialogueIndicator({
         isLoading: false,
         visibleGameState: state,
         visibleCurrentStory: story,
@@ -280,6 +280,10 @@ describe('useGameShellRuntimeViewModel helpers', () => {
       scenesTraveled: 5,
       currentSceneName: '断桥旧哨',
       playerCurrency: 18,
+      playerLevel: 1,
+      playerCurrentLevelXp: 0,
+      playerXpToNextLevel: 60,
+      playerTotalXp: 0,
       inventoryItemCount: 5,
       inventoryStackCount: 2,
       activeCompanionCount: 2,
diff --git a/src/components/game-shell/useGameShellRuntimeViewModel.ts b/src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.ts
similarity index 87%
rename from src/components/game-shell/useGameShellRuntimeViewModel.ts
rename to src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.ts
index 91e87fbe..172cb950 100644
--- a/src/components/game-shell/useGameShellRuntimeViewModel.ts
+++ b/src/components/rpg-runtime-shell/useRpgRuntimeShellViewModel.ts
@@ -11,21 +11,21 @@ import type {
   StoryOption,
 } from '../../types';
 import type {
-  GameShellAdventureStatistics,
-  GameShellDialogueIndicator,
-  GameShellProps,
+  RpgAdventureStatistics,
+  RpgRuntimeDialogueIndicator,
+  RpgRuntimeShellProps,
 } from './types';
-import { useGameShellViewModel } from './useGameShellViewModel';
+import { useRpgRuntimeOverlayState } from './useRpgRuntimeOverlayState';
 import {
   SCENE_TRANSITION_FUNCTION_MODES,
-  useSceneTransitionModel,
-} from './useSceneTransitionModel';
+  useRpgSceneTransitionModel,
+} from './useRpgSceneTransitionModel';
 
-export function buildGameShellDialogueIndicator(params: {
+export function buildRpgRuntimeDialogueIndicator(params: {
   isLoading: boolean;
   visibleGameState: GameState;
   visibleCurrentStory: StoryMoment | null;
-}): GameShellDialogueIndicator | null {
+}): RpgRuntimeDialogueIndicator | null {
   const { isLoading, visibleGameState, visibleCurrentStory } = params;
   if (
     !isLoading ||
@@ -79,7 +79,7 @@ export function buildAdventureStatistics(params: {
   gameState: GameState;
   visibleGameState: GameState;
   livePlayTimeMs: number;
-}): GameShellAdventureStatistics {
+}): RpgAdventureStatistics {
   const { gameState, visibleGameState, livePlayTimeMs } = params;
   const playerProgression = normalizePlayerProgressionState(
     visibleGameState.playerProgression ?? null,
@@ -113,8 +113,17 @@ export function buildAdventureStatistics(params: {
   };
 }
 
-export function useGameShellRuntimeViewModel(
-  params: Pick<GameShellProps, 'session' | 'story' | 'companions'>,
+export type UseRpgRuntimeShellViewModelParams = Pick<
+  RpgRuntimeShellProps,
+  'session' | 'story' | 'companions'
+>;
+
+/**
+ * RPG 运行态视图模型。
+ * 负责拼装运行态 overlay 状态、过场可见态、画布 companion 数据和冒险统计。
+ */
+export function useRpgRuntimeShellViewModel(
+  params: UseRpgRuntimeShellViewModelParams,
 ) {
   const { session, story, companions } = params;
   const { gameState, currentStory, isLoading, isMapOpen } = session;
@@ -132,13 +141,13 @@ export function useGameShellRuntimeViewModel(
   const hasNpcModalOpen = Boolean(
     npcUi.tradeModal || npcUi.giftModal || npcUi.recruitModal,
   );
-  const shellViewModel = useGameShellViewModel({
+  const shellViewModel = useRpgRuntimeOverlayState({
     gameState,
     isMapOpen,
     characterChatModalOpen: Boolean(characterChatUi.modal),
     hasNpcModalOpen,
   });
-  const sceneTransitionModel = useSceneTransitionModel({
+  const sceneTransitionModel = useRpgSceneTransitionModel({
     gameState,
     currentStory,
     openingCampSceneId,
@@ -158,7 +167,7 @@ export function useGameShellRuntimeViewModel(
 
   const dialogueIndicator = useMemo(
     () =>
-      buildGameShellDialogueIndicator({
+      buildRpgRuntimeDialogueIndicator({
         isLoading,
         visibleGameState,
         visibleCurrentStory,
@@ -234,3 +243,7 @@ export function useGameShellRuntimeViewModel(
     handleSceneTransitionChoice,
   };
 }
+
+export type RpgRuntimeShellViewModelResult = ReturnType<
+  typeof useRpgRuntimeShellViewModel
+>;
diff --git a/src/components/rpg-runtime-shell/useRpgSceneTransitionModel.ts b/src/components/rpg-runtime-shell/useRpgSceneTransitionModel.ts
new file mode 100644
index 00000000..1ee62206
--- /dev/null
+++ b/src/components/rpg-runtime-shell/useRpgSceneTransitionModel.ts
@@ -0,0 +1,224 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+import type { GameState, StoryMoment } from '../../types';
+
+export type SceneTransitionPhase = 'idle' | 'exiting' | 'entering';
+export type SceneTransitionTriggerMode = 'scene-change' | 'content-change';
+
+type SceneTransitionRequest = {
+  mode: SceneTransitionTriggerMode;
+  baselineSceneId: string | null;
+  baselineContentKey: string;
+  exitComplete: boolean;
+};
+
+const DEFAULT_SCENE_SWITCH_EXIT_MS = 5000;
+const DEFAULT_SCENE_SWITCH_ENTRY_MS = 5930;
+
+export const SCENE_TRANSITION_FUNCTION_MODES: Partial<
+  Record<string, SceneTransitionTriggerMode>
+> = {
+  idle_travel_next_scene: 'scene-change',
+  camp_travel_home_scene: 'scene-change',
+  idle_explore_forward: 'content-change',
+  idle_follow_clue: 'content-change',
+};
+
+function buildSceneTransitionContentKey(
+  gameState: GameState,
+  currentStory: StoryMoment | null,
+) {
+  const sceneId = gameState.currentScenePreset?.id ?? 'scene:none';
+  const encounterKey = gameState.currentEncounter
+    ? `${gameState.currentEncounter.kind}:${gameState.currentEncounter.id ?? gameState.currentEncounter.npcName ?? 'unknown'}`
+    : 'encounter:none';
+  const monsterKey = gameState.sceneHostileNpcs
+    .map(
+      (monster) =>
+        `${monster.id}:${monster.renderKind}:${monster.xMeters}:${monster.animation}`,
+    )
+    .join('|');
+  const storyKey = currentStory
+    ? `${currentStory.displayMode ?? 'story'}:${currentStory.text ?? ''}:${currentStory.dialogue?.length ?? 0}`
+    : 'story:none';
+  return [sceneId, encounterKey, monsterKey, storyKey].join('::');
+}
+
+/**
+ * RPG 运行态场景过场模型真实入口。
+ * 第三批收口后，`rpg-runtime-shell` 直接承载场景过场状态。
+ */
+export function useRpgSceneTransitionModel(params: {
+  gameState: GameState;
+  currentStory: StoryMoment | null;
+  openingCampSceneId: string | null;
+}) {
+  const { gameState, currentStory, openingCampSceneId } = params;
+  const [renderGameState, setRenderGameState] = useState(gameState);
+  const [renderCurrentStory, setRenderCurrentStory] = useState(currentStory);
+  const [sceneTransitionPhase, setSceneTransitionPhase] =
+    useState<SceneTransitionPhase>('idle');
+  const [sceneTransitionToken, setSceneTransitionToken] = useState(0);
+  const [sceneTransitionDurations, setSceneTransitionDurations] = useState({
+    exitMs: DEFAULT_SCENE_SWITCH_EXIT_MS,
+    entryMs: DEFAULT_SCENE_SWITCH_ENTRY_MS,
+  });
+
+  const pendingScenePayloadRef = useRef<{
+    gameState: GameState;
+    currentStory: StoryMoment | null;
+  }>({
+    gameState,
+    currentStory,
+  });
+  const sceneTransitionTimerIdsRef = useRef<number[]>([]);
+  const sceneTransitionRequestRef = useRef<SceneTransitionRequest | null>(null);
+
+  useEffect(() => {
+    return () => {
+      sceneTransitionTimerIdsRef.current.forEach((timerId) =>
+        window.clearTimeout(timerId),
+      );
+      sceneTransitionTimerIdsRef.current = [];
+      sceneTransitionRequestRef.current = null;
+    };
+  }, []);
+
+  const startSceneEntering = useCallback(
+    (payload: { gameState: GameState; currentStory: StoryMoment | null }) => {
+      sceneTransitionTimerIdsRef.current.forEach((timerId) =>
+        window.clearTimeout(timerId),
+      );
+      sceneTransitionTimerIdsRef.current = [];
+      sceneTransitionRequestRef.current = null;
+      setRenderGameState(payload.gameState);
+      setRenderCurrentStory(payload.currentStory);
+      setSceneTransitionToken((current) => current + 1);
+      setSceneTransitionPhase('entering');
+
+      const entryTimerId = window.setTimeout(() => {
+        setSceneTransitionPhase('idle');
+      }, sceneTransitionDurations.entryMs);
+      sceneTransitionTimerIdsRef.current.push(entryTimerId);
+    },
+    [sceneTransitionDurations.entryMs],
+  );
+
+  const beginSceneTransition = useCallback(
+    (mode: SceneTransitionTriggerMode) => {
+      if (sceneTransitionPhase !== 'idle') return;
+
+      pendingScenePayloadRef.current = { gameState, currentStory };
+      sceneTransitionTimerIdsRef.current.forEach((timerId) =>
+        window.clearTimeout(timerId),
+      );
+      sceneTransitionTimerIdsRef.current = [];
+      sceneTransitionRequestRef.current = {
+        mode,
+        baselineSceneId:
+          renderGameState.currentScenePreset?.id ??
+          gameState.currentScenePreset?.id ??
+          null,
+        baselineContentKey: buildSceneTransitionContentKey(
+          renderGameState,
+          renderCurrentStory,
+        ),
+        exitComplete: false,
+      };
+      setSceneTransitionPhase('exiting');
+
+      const exitTimerId = window.setTimeout(() => {
+        const request = sceneTransitionRequestRef.current;
+        if (!request) return;
+        request.exitComplete = true;
+
+        const pendingPayload = pendingScenePayloadRef.current;
+        const isReady =
+          request.mode === 'scene-change'
+            ? (pendingPayload.gameState.currentScenePreset?.id ?? null) !==
+              request.baselineSceneId
+            : buildSceneTransitionContentKey(
+                pendingPayload.gameState,
+                pendingPayload.currentStory,
+              ) !== request.baselineContentKey;
+
+        if (isReady) {
+          startSceneEntering(pendingPayload);
+        }
+      }, sceneTransitionDurations.exitMs);
+      sceneTransitionTimerIdsRef.current.push(exitTimerId);
+    },
+    [
+      currentStory,
+      gameState,
+      renderCurrentStory,
+      renderGameState,
+      sceneTransitionDurations.exitMs,
+      sceneTransitionPhase,
+      startSceneEntering,
+    ],
+  );
+
+  useEffect(() => {
+    pendingScenePayloadRef.current = { gameState, currentStory };
+
+    const request = sceneTransitionRequestRef.current;
+    if (sceneTransitionPhase === 'exiting' && request?.exitComplete) {
+      const isReady =
+        request.mode === 'scene-change'
+          ? (gameState.currentScenePreset?.id ?? null) !== request.baselineSceneId
+          : buildSceneTransitionContentKey(gameState, currentStory) !==
+            request.baselineContentKey;
+      if (isReady) {
+        startSceneEntering({ gameState, currentStory });
+      }
+      return;
+    }
+
+    if (sceneTransitionPhase !== 'exiting') {
+      setRenderGameState(gameState);
+      setRenderCurrentStory(currentStory);
+    }
+  }, [currentStory, gameState, sceneTransitionPhase, startSceneEntering]);
+
+  useEffect(() => {
+    if (sceneTransitionPhase !== 'idle') {
+      return;
+    }
+    if (renderGameState.playerCharacter) {
+      return;
+    }
+    if (!gameState.playerCharacter || gameState.currentScene !== 'Story') {
+      return;
+    }
+    if (gameState.storyHistory.length > 0) {
+      return;
+    }
+    if (
+      !openingCampSceneId ||
+      gameState.currentScenePreset?.id !== openingCampSceneId
+    ) {
+      return;
+    }
+
+    startSceneEntering({ gameState, currentStory });
+  }, [
+    currentStory,
+    gameState,
+    openingCampSceneId,
+    renderGameState.playerCharacter,
+    sceneTransitionPhase,
+    startSceneEntering,
+  ]);
+
+  return {
+    visibleGameState:
+      sceneTransitionPhase === 'idle' ? gameState : renderGameState,
+    visibleCurrentStory:
+      sceneTransitionPhase === 'idle' ? currentStory : renderCurrentStory,
+    sceneTransitionPhase,
+    sceneTransitionToken,
+    setSceneTransitionDurations,
+    beginSceneTransition,
+  };
+}
diff --git a/src/data/functionCatalog/flow/campTravelHomeScene.ts b/src/data/functionCatalog/flow/campTravelHomeScene.ts
index 6804205c..72083224 100644
--- a/src/data/functionCatalog/flow/campTravelHomeScene.ts
+++ b/src/data/functionCatalog/flow/campTravelHomeScene.ts
@@ -51,7 +51,8 @@ export const CAMP_TRAVEL_HOME_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'special_travel',
     uiMode: 'none',
     visuals: CAMP_TRAVEL_HOME_OPTION_VISUALS,
-    executor: 'src/hooks/story/choiceActions.ts -> handleCampTravelHome',
+    executor:
+      'src/hooks/rpg-runtime-story/choiceActions.ts -> handleCampTravelHome',
     animationNote:
       '先播放营地离场的 run 演出，再切到正式场景并生成 encounter preview。',
     storyNote:
diff --git a/src/data/functionCatalog/flow/storyContinueAdventure.ts b/src/data/functionCatalog/flow/storyContinueAdventure.ts
index ccbc4734..07316a6e 100644
--- a/src/data/functionCatalog/flow/storyContinueAdventure.ts
+++ b/src/data/functionCatalog/flow/storyContinueAdventure.ts
@@ -52,7 +52,7 @@ export const CONTINUE_ADVENTURE_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'reveal_deferred_options',
     uiMode: 'none',
     visuals: CONTINUE_ADVENTURE_OPTION_VISUALS,
-    executor: 'src/hooks/story/choiceActions.ts -> handleChoice',
+    executor: 'src/hooks/rpg-runtime-story/choiceActions.ts -> handleChoice',
     animationNote: '按钮本身沿用轻量前进动画，但不驱动新的战斗或场景演出。',
     storyNote:
       '点击时直接把 deferredOptions 放回 currentStory.options，不再请求新的 generateNextStep。',
diff --git a/src/data/functionCatalog/flow/storyOpeningCampDialogue.ts b/src/data/functionCatalog/flow/storyOpeningCampDialogue.ts
index b9337db8..2cc00390 100644
--- a/src/data/functionCatalog/flow/storyOpeningCampDialogue.ts
+++ b/src/data/functionCatalog/flow/storyOpeningCampDialogue.ts
@@ -29,7 +29,8 @@ export const STORY_OPENING_CAMP_DIALOGUE_FUNCTION: FunctionDocumentationEntry =
     runtime: {
       storyMode: 'special_sequence',
       uiMode: 'none',
-      executor: 'src/hooks/story/openingAdventure.ts + src/services/prompt.ts',
+      executor:
+        'src/hooks/rpg-runtime-story/openingAdventure.ts + src/services/prompt.ts',
       animationNote: '重点在对白本身，不额外驱动独立战斗/位移动画。',
       storyNote: '会把 prompt 切到营地开场对白模式，并要求输出结构化对话行。',
       uiNote: '不弹 modal，直接进入对白流。',
diff --git a/src/data/functionCatalog/functionCatalog.test.ts b/src/data/functionCatalog/functionCatalog.test.ts
index 7d88a4f1..14046db9 100644
--- a/src/data/functionCatalog/functionCatalog.test.ts
+++ b/src/data/functionCatalog/functionCatalog.test.ts
@@ -1,6 +1,6 @@
 import { existsSync } from 'node:fs';
 
-import { SERVER_RUNTIME_FUNCTION_IDS } from '../../../packages/shared/src/contracts/story';
+import { SERVER_RUNTIME_FUNCTION_IDS } from '../../../packages/shared/src/contracts/rpgRuntimeStoryAction';
 import { describe, expect, it } from 'vitest';
 
 import {
diff --git a/src/data/functionCatalog/npc/npcChat.ts b/src/data/functionCatalog/npc/npcChat.ts
index 6373b3c8..c1b4b041 100644
--- a/src/data/functionCatalog/npc/npcChat.ts
+++ b/src/data/functionCatalog/npc/npcChat.ts
@@ -23,7 +23,8 @@ export const NPC_CHAT_FUNCTION: FunctionDocumentationEntry = {
   runtime: {
     storyMode: 'stream_then_defer',
     uiMode: 'none',
-    executor: 'src/hooks/story/npcEncounterActions.ts -> commitNpcChatState',
+    executor:
+      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> commitNpcChatState',
     animationNote: '重点在流式对白和轻量站场，不额外打开窗口。',
     storyNote:
       '先生成聊天正文，再把真正的新选项放入 deferredOptions，等待 continue adventure。',
diff --git a/src/data/functionCatalog/npc/npcFight.ts b/src/data/functionCatalog/npc/npcFight.ts
index 8a5f3bb4..7cb78e3d 100644
--- a/src/data/functionCatalog/npc/npcFight.ts
+++ b/src/data/functionCatalog/npc/npcFight.ts
@@ -22,7 +22,8 @@ export const NPC_FIGHT_FUNCTION: FunctionDocumentationEntry = {
   runtime: {
     storyMode: 'special_sequence',
     uiMode: 'none',
-    executor: 'src/hooks/story/npcEncounterActions.ts -> handleNpcInteraction',
+    executor:
+      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> handleNpcInteraction',
     animationNote: '切到 NPC 战斗模式后，由战斗播放链路驱动后续动画。',
     storyNote: '不会先弹窗，直接把当前 encounter 切成战斗态并进入后续结算。',
     uiNote: '不弹 modal，直接进入战斗。',
diff --git a/src/data/functionCatalog/npc/npcGift.ts b/src/data/functionCatalog/npc/npcGift.ts
index 9e08f277..2c86de21 100644
--- a/src/data/functionCatalog/npc/npcGift.ts
+++ b/src/data/functionCatalog/npc/npcGift.ts
@@ -1,4 +1,4 @@
-import type { GiftModalState } from '../../../hooks/story/uiTypes';
+import type { GiftModalState } from '../../../hooks/rpg-runtime-story/uiTypes';
 import type { Encounter, GameState } from '../../../types';
 import type { FunctionDocumentationEntry } from '../types';
 
@@ -46,7 +46,7 @@ export const NPC_GIFT_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'modal_then_generate',
     uiMode: 'gift_modal',
     executor:
-      'src/hooks/story/storyGenerationState.ts + src/hooks/story/npcInteraction.ts',
+      'src/hooks/rpg-runtime-story/storyGenerationState.ts + src/hooks/rpg-runtime-story/npcInteraction.ts',
     animationNote: '第一次点击不驱动额外演出，重点是切到礼物面板。',
     storyNote:
       '真正的剧情推进发生在 confirmGift 之后，届时才会写入好感变化与结果文本。',
diff --git a/src/data/functionCatalog/npc/npcHelp.ts b/src/data/functionCatalog/npc/npcHelp.ts
index c8f3b943..f04be5f1 100644
--- a/src/data/functionCatalog/npc/npcHelp.ts
+++ b/src/data/functionCatalog/npc/npcHelp.ts
@@ -21,7 +21,8 @@ export const NPC_HELP_FUNCTION: FunctionDocumentationEntry = {
   runtime: {
     storyMode: 'local_effect_then_generate',
     uiMode: 'none',
-    executor: 'src/hooks/story/npcEncounterActions.ts -> handleNpcInteraction',
+    executor:
+      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> handleNpcInteraction',
     animationNote: '不单独开窗口，直接在当前交互里结算帮助结果。',
     storyNote: '点击后立即按本地奖励规则结算，并继续生成新的故事状态。',
     uiNote: '不弹 modal，直接获得帮助反馈。',
diff --git a/src/data/functionCatalog/npc/npcLeave.ts b/src/data/functionCatalog/npc/npcLeave.ts
index 634a186c..16190117 100644
--- a/src/data/functionCatalog/npc/npcLeave.ts
+++ b/src/data/functionCatalog/npc/npcLeave.ts
@@ -20,7 +20,8 @@ export const NPC_LEAVE_FUNCTION: FunctionDocumentationEntry = {
   runtime: {
     storyMode: 'local_effect_then_generate',
     uiMode: 'none',
-    executor: 'src/hooks/story/npcEncounterActions.ts -> handleNpcInteraction',
+    executor:
+      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> handleNpcInteraction',
     animationNote: '通常只做轻量离场，不单独打开窗口。',
     storyNote: '点击后结束当前 NPC 交互，并回到新的探索剧情。',
     uiNote: '不弹 modal，直接退出互动。',
diff --git a/src/data/functionCatalog/npc/npcPreviewTalk.ts b/src/data/functionCatalog/npc/npcPreviewTalk.ts
index f2ea52d2..343ccbd2 100644
--- a/src/data/functionCatalog/npc/npcPreviewTalk.ts
+++ b/src/data/functionCatalog/npc/npcPreviewTalk.ts
@@ -60,7 +60,7 @@ export const NPC_PREVIEW_TALK_FUNCTION: FunctionDocumentationEntry = {
     uiMode: 'npc_interaction_entry',
     visuals: NPC_PREVIEW_TALK_OPTION_VISUALS,
     executor:
-      'src/hooks/story/choiceActions.ts + src/hooks/story/npcEncounterActions.ts',
+    'src/hooks/rpg-runtime-story/choiceActions.ts + src/hooks/rpg-runtime-story/npcEncounterActions.ts',
     animationNote:
       '保持轻量 idle 站场，不做额外位移，重点是把交互焦点切到 NPC 身上。',
     storyNote:
diff --git a/src/data/functionCatalog/npc/npcRecruit.ts b/src/data/functionCatalog/npc/npcRecruit.ts
index 43938904..db39857d 100644
--- a/src/data/functionCatalog/npc/npcRecruit.ts
+++ b/src/data/functionCatalog/npc/npcRecruit.ts
@@ -1,4 +1,4 @@
-import type { RecruitModalState } from '../../../hooks/story/uiTypes';
+import type { RecruitModalState } from '../../../hooks/rpg-runtime-story/uiTypes';
 import type { Encounter, GameState } from '../../../types';
 import type { FunctionDocumentationEntry } from '../types';
 
@@ -53,7 +53,7 @@ export const NPC_RECRUIT_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'special_sequence',
     uiMode: 'recruit_modal_or_sequence',
     executor:
-      'src/hooks/story/storyGenerationState.ts + src/hooks/story/npcInteraction.ts',
+      'src/hooks/rpg-runtime-story/storyGenerationState.ts + src/hooks/rpg-runtime-story/npcInteraction.ts',
     animationNote:
       '若直接进入招募，会先播放招募对话流；若队伍已满，先进入替换弹窗。',
     storyNote:
diff --git a/src/data/functionCatalog/npc/npcSpar.ts b/src/data/functionCatalog/npc/npcSpar.ts
index 4ad25782..a0b72bfa 100644
--- a/src/data/functionCatalog/npc/npcSpar.ts
+++ b/src/data/functionCatalog/npc/npcSpar.ts
@@ -20,7 +20,8 @@ export const NPC_SPAR_FUNCTION: FunctionDocumentationEntry = {
   runtime: {
     storyMode: 'special_sequence',
     uiMode: 'none',
-    executor: 'src/hooks/story/npcEncounterActions.ts -> handleNpcInteraction',
+    executor:
+      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> handleNpcInteraction',
     animationNote: '切到 spar 战斗模式后，由战斗播放链路驱动切磋演出。',
     storyNote: '不会先弹窗，直接进入点到为止的切磋流程。',
     uiNote: '不弹 modal，直接切磋。',
diff --git a/src/data/functionCatalog/npc/npcTrade.ts b/src/data/functionCatalog/npc/npcTrade.ts
index 8438ca8c..97f7f619 100644
--- a/src/data/functionCatalog/npc/npcTrade.ts
+++ b/src/data/functionCatalog/npc/npcTrade.ts
@@ -1,4 +1,4 @@
-import type { TradeModalState } from '../../../hooks/story/uiTypes';
+import type { TradeModalState } from '../../../hooks/rpg-runtime-story/uiTypes';
 import type { Encounter, GameState, InventoryItem } from '../../../types';
 import type { FunctionDocumentationEntry } from '../types';
 
@@ -54,7 +54,7 @@ export const NPC_TRADE_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'modal_then_generate',
     uiMode: 'trade_modal',
     executor:
-      'src/hooks/story/storyGenerationState.ts + src/hooks/story/npcInteraction.ts',
+      'src/hooks/rpg-runtime-story/storyGenerationState.ts + src/hooks/rpg-runtime-story/npcInteraction.ts',
     animationNote: '第一次点击不播额外战斗或位移动画，重点是切到交易窗口。',
     storyNote:
       '真正的剧情推进发生在 confirmTrade 之后，而不是打开 modal 的瞬间。',
diff --git a/src/hooks/story/characterChat.ts b/src/hooks/rpg-runtime-story/characterChat.ts
similarity index 99%
rename from src/hooks/story/characterChat.ts
rename to src/hooks/rpg-runtime-story/characterChat.ts
index facefaf7..3acb7f7f 100644
--- a/src/hooks/story/characterChat.ts
+++ b/src/hooks/rpg-runtime-story/characterChat.ts
@@ -1,4 +1,4 @@
-import {type Dispatch, type SetStateAction,useState} from 'react';
+import {type Dispatch, type SetStateAction,useState} from 'react';
 
 import {
   generateCharacterPanelChatSuggestions,
diff --git a/src/hooks/story/choiceActions.test.ts b/src/hooks/rpg-runtime-story/choiceActions.test.ts
similarity index 95%
rename from src/hooks/story/choiceActions.test.ts
rename to src/hooks/rpg-runtime-story/choiceActions.test.ts
index bf5f5d86..26ed5c67 100644
--- a/src/hooks/story/choiceActions.test.ts
+++ b/src/hooks/rpg-runtime-story/choiceActions.test.ts
@@ -1,23 +1,17 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 vi.mock('../../services/aiService', () => ({
   generateNextStep: vi.fn(),
 }));
 
 const {
-  isServerRuntimeFunctionIdMock,
-  resolveServerRuntimeChoiceMock,
+  isRpgRuntimeServerFunctionIdMock,
 } = vi.hoisted(() => ({
-  isServerRuntimeFunctionIdMock: vi.fn(() => false),
-  resolveServerRuntimeChoiceMock: vi.fn(),
+  isRpgRuntimeServerFunctionIdMock: vi.fn(() => false),
 }));
 
-vi.mock('./runtimeStoryCoordinator', () => ({
-  resolveServerRuntimeChoice: resolveServerRuntimeChoiceMock,
-}));
-
-vi.mock('../../services/runtimeStoryService', () => ({
-  isServerRuntimeFunctionId: isServerRuntimeFunctionIdMock,
+vi.mock('../../services/rpg-runtime', () => ({
+  isRpgRuntimeServerFunctionId: isRpgRuntimeServerFunctionIdMock,
 }));
 
 import { generateNextStep } from '../../services/aiService';
@@ -150,9 +144,8 @@ const neverNpcEncounter = (
 
 describe('createStoryChoiceActions', () => {
   beforeEach(() => {
-    isServerRuntimeFunctionIdMock.mockReset();
-    isServerRuntimeFunctionIdMock.mockReturnValue(false);
-    resolveServerRuntimeChoiceMock.mockReset();
+    isRpgRuntimeServerFunctionIdMock.mockReset();
+    isRpgRuntimeServerFunctionIdMock.mockReturnValue(false);
   });
 
   it('reveals deferred adventure options when story_continue_adventure is selected', async () => {
@@ -251,7 +244,6 @@ describe('createStoryChoiceActions', () => {
     });
     expect(generateStoryForState).not.toHaveBeenCalled();
     expect(handleNpcInteraction).not.toHaveBeenCalled();
-    expect(resolveServerRuntimeChoiceMock).not.toHaveBeenCalled();
   });
 
   it('keeps npc chat choices on the local UI path so chat mode can continue streaming locally', async () => {
@@ -261,7 +253,7 @@ describe('createStoryChoiceActions', () => {
     const setCurrentStory = vi.fn();
     const handleNpcInteraction = vi.fn(() => true);
 
-    isServerRuntimeFunctionIdMock.mockReturnValue(true);
+    isRpgRuntimeServerFunctionIdMock.mockReturnValue(true);
 
     const { handleChoice } = createStoryChoiceActions({
       gameState: {
@@ -324,7 +316,6 @@ describe('createStoryChoiceActions', () => {
         functionId: 'npc_chat',
       }),
     );
-    expect(resolveServerRuntimeChoiceMock).not.toHaveBeenCalled();
     expect(setGameState).not.toHaveBeenCalled();
     expect(setCurrentStory).not.toHaveBeenCalled();
   });
@@ -366,7 +357,7 @@ describe('createStoryChoiceActions', () => {
     };
     const handleNpcInteraction = vi.fn(() => true);
 
-    isServerRuntimeFunctionIdMock.mockReturnValue(true);
+    isRpgRuntimeServerFunctionIdMock.mockReturnValue(true);
 
     const { handleChoice } = createStoryChoiceActions({
       gameState: state,
@@ -410,7 +401,6 @@ describe('createStoryChoiceActions', () => {
     await handleChoice(option);
 
     expect(handleNpcInteraction).toHaveBeenCalledWith(option);
-    expect(resolveServerRuntimeChoiceMock).not.toHaveBeenCalled();
   });
 
   it('reopens npc chat instead of running generic follow-up after local npc victory', async () => {
diff --git a/src/hooks/story/choiceActions.ts b/src/hooks/rpg-runtime-story/choiceActions.ts
similarity index 98%
rename from src/hooks/story/choiceActions.ts
rename to src/hooks/rpg-runtime-story/choiceActions.ts
index aa483646..095630be 100644
--- a/src/hooks/story/choiceActions.ts
+++ b/src/hooks/rpg-runtime-story/choiceActions.ts
@@ -1,10 +1,10 @@
-import type {
+import type {
   Dispatch,
   SetStateAction,
 } from 'react';
 
 import type { StoryGenerationContext } from '../../services/aiTypes';
-import { isServerRuntimeFunctionId } from '../../services/runtimeStoryService';
+import { isRpgRuntimeServerFunctionId } from '../../services/rpg-runtime';
 import {
   type Character,
   type Encounter,
@@ -200,7 +200,7 @@ export function createStoryChoiceActions({
       return;
     }
 
-    if (isServerRuntimeFunctionId(option.functionId)) {
+    if (isRpgRuntimeServerFunctionId(option.functionId)) {
       await runServerRuntimeChoiceAction({
         gameState,
         currentStory,
diff --git a/src/hooks/story/goalFlow.ts b/src/hooks/rpg-runtime-story/goalFlow.ts
similarity index 97%
rename from src/hooks/story/goalFlow.ts
rename to src/hooks/rpg-runtime-story/goalFlow.ts
index 7c4c96d0..5d4bd5ee 100644
--- a/src/hooks/story/goalFlow.ts
+++ b/src/hooks/rpg-runtime-story/goalFlow.ts
@@ -1,4 +1,4 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 
 import {
   buildGoalStackState,
diff --git a/src/hooks/rpg-runtime-story/index.ts b/src/hooks/rpg-runtime-story/index.ts
new file mode 100644
index 00000000..321ac8c7
--- /dev/null
+++ b/src/hooks/rpg-runtime-story/index.ts
@@ -0,0 +1,52 @@
+export {
+  loadRpgRuntimeOptionCatalog,
+  resolveRpgRuntimeChoice,
+  resumeRpgRuntimeStory,
+  type LoadRpgRuntimeOptionCatalogParams,
+  type ResolveRpgRuntimeChoiceParams,
+} from './rpgRuntimeStoryGateway';
+export {
+  useRpgRuntimeInteractionFlow,
+  createRpgRuntimeInteractionUiResetter,
+  type RpgRuntimeInteractionFlowResult,
+  type UseRpgRuntimeInteractionFlowParams,
+} from './useRpgRuntimeInteractionFlow';
+export {
+  useRpgRuntimeNpcInteraction,
+  type RpgRuntimeNpcInteractionResult,
+  type UseRpgRuntimeNpcInteractionParams,
+} from './useRpgRuntimeNpcInteraction';
+export {
+  useRpgRuntimeStory,
+  type BattleRewardSummary,
+  type BattleRewardUi,
+  type CharacterChatModalState,
+  type CharacterChatTarget,
+  type CharacterChatUi,
+  type GiftModalState,
+  type GoalFlowUi,
+  type InventoryFlowUi,
+  type NpcChatQuestOfferUi,
+  type QuestFlowUi,
+  type RecruitModalState,
+  type RpgRuntimeStoryResult,
+  type StoryGenerationNpcUi,
+  type TradeModalState,
+  type UseRpgRuntimeStoryParams,
+} from './useRpgRuntimeStory';
+export {
+  useRpgRuntimeStoryController,
+  type RpgRuntimeStoryControllerResult,
+  type UseRpgRuntimeStoryControllerParams,
+} from './useRpgRuntimeStoryController';
+export {
+  useRpgRuntimeStoryFlow,
+  type RpgRuntimeStoryFlowResult,
+  type UseRpgRuntimeStoryFlowParams,
+} from './useRpgRuntimeStoryFlow';
+export {
+  createRpgRuntimeStoryUiResetter,
+  useRpgRuntimeStoryState,
+  type RpgRuntimeStoryStateResult,
+  type UseRpgRuntimeStoryStateParams,
+} from './useRpgRuntimeStoryState';
diff --git a/src/hooks/story/inventoryActions.ts b/src/hooks/rpg-runtime-story/inventoryActions.ts
similarity index 95%
rename from src/hooks/story/inventoryActions.ts
rename to src/hooks/rpg-runtime-story/inventoryActions.ts
index 86d458d7..3168fac5 100644
--- a/src/hooks/story/inventoryActions.ts
+++ b/src/hooks/rpg-runtime-story/inventoryActions.ts
@@ -1,4 +1,4 @@
-import { useMemo, type Dispatch, type SetStateAction } from 'react';
+import { useMemo, type Dispatch, type SetStateAction } from 'react';
 
 import {
   EQUIPMENT_EQUIP_FUNCTION,
@@ -10,7 +10,7 @@ import {
 } from '../../data/functionCatalog';
 import { getForgeRecipeViews } from '../../data/forgeSystem';
 import type { Character, GameState, StoryMoment } from '../../types';
-import { resolveServerRuntimeChoice } from './runtimeStoryCoordinator';
+import { resolveRpgRuntimeChoice } from '.';
 import type { InventoryFlowUi } from './uiTypes';
 
 type BuildFallbackStoryForState = (
@@ -69,7 +69,7 @@ export function useStoryInventoryActions({
     setIsLoading(true);
 
     try {
-      const { hydratedSnapshot, nextStory } = await resolveServerRuntimeChoice({
+      const { hydratedSnapshot, nextStory } = await resolveRpgRuntimeChoice({
         gameState,
         currentStory,
         option: {
diff --git a/src/hooks/story/npcEncounterActions.test.ts b/src/hooks/rpg-runtime-story/npcEncounterActions.test.ts
similarity index 99%
rename from src/hooks/story/npcEncounterActions.test.ts
rename to src/hooks/rpg-runtime-story/npcEncounterActions.test.ts
index f9e74e1a..e0676ba6 100644
--- a/src/hooks/story/npcEncounterActions.test.ts
+++ b/src/hooks/rpg-runtime-story/npcEncounterActions.test.ts
@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 const {
   resolveServerRuntimeChoiceMock,
@@ -8,8 +8,8 @@ const {
   streamNpcChatTurnMock: vi.fn(),
 }));
 
-vi.mock('./runtimeStoryCoordinator', () => ({
-  resolveServerRuntimeChoice: resolveServerRuntimeChoiceMock,
+vi.mock('./rpgRuntimeStoryGateway', () => ({
+  resolveRpgRuntimeChoice: resolveServerRuntimeChoiceMock,
 }));
 
 vi.mock('../../services/aiService', () => ({
@@ -1423,7 +1423,6 @@ describe('npcEncounterActions', () => {
       '更换任务',
       '放弃任务',
     ]);
-    expect(lastStory.text).toContain('断桥夜巡');
   });
 
   it('forwards pending quest offer acceptance to the server runtime resolver', async () => {
diff --git a/src/hooks/rpg-runtime-story/npcEncounterActions.ts b/src/hooks/rpg-runtime-story/npcEncounterActions.ts
new file mode 100644
index 00000000..f42ce3aa
--- /dev/null
+++ b/src/hooks/rpg-runtime-story/npcEncounterActions.ts
@@ -0,0 +1,6 @@
+export {
+  createRpgRuntimeNpcEncounterActions as createStoryNpcEncounterActions,
+  useRpgRuntimeNpcInteraction,
+  type RpgRuntimeNpcInteractionResult,
+  type UseRpgRuntimeNpcInteractionParams,
+} from './useRpgRuntimeNpcInteraction';
diff --git a/src/hooks/story/npcInteraction.ts b/src/hooks/rpg-runtime-story/npcInteraction.ts
similarity index 82%
rename from src/hooks/story/npcInteraction.ts
rename to src/hooks/rpg-runtime-story/npcInteraction.ts
index bcc29b24..6785b956 100644
--- a/src/hooks/story/npcInteraction.ts
+++ b/src/hooks/rpg-runtime-story/npcInteraction.ts
@@ -1,16 +1,12 @@
-import type {
+import type {
   Dispatch,
   SetStateAction,
 } from 'react';
 import { useState } from 'react';
 
-import { buildRelationState } from '../../data/attributeResolver';
 import {
-  buildCompanionState,
   getCharacterById,
-  resolveEncounterRecruitCharacter,
 } from '../../data/characterPresets';
-import { recruitCompanionToParty } from '../../data/companionRoster';
 import {
   getNpcBuybackPrice,
   getNpcPurchasePrice,
@@ -22,24 +18,17 @@ import {
 } from '../../data/functionCatalog';
 import {
   addInventoryItems,
-  applyStoryChoiceToStanceProfile,
   buildNpcGiftCommitActionText,
   buildNpcGiftResultText,
-  buildNpcRecruitResultText,
   buildNpcTradeTransactionActionText,
   buildNpcTradeTransactionResultText,
   getGiftCandidates,
   getPreferredGiftItemId,
-  markNpcFirstMeaningfulContactResolved,
   removeInventoryItem,
   syncNpcTradeInventory,
 } from '../../data/npcInteractions';
 import { streamNpcChatDialogue, streamNpcRecruitDialogue } from '../../services/aiService';
 import type { StoryGenerationContext } from '../../services/aiTypes';
-import {
-  appendStoryEngineCarrierMemory,
-  syncNpcNarrativeState,
-} from '../../services/storyEngine/echoMemory';
 import { createHistoryMoment } from '../../services/storyHistory';
 import type {
   Character,
@@ -49,8 +38,7 @@ import type {
   StoryMoment,
   StoryOption,
 } from '../../types';
-import type { CommitGeneratedState } from '../generatedState';
-import { resolveServerRuntimeChoice } from './runtimeStoryCoordinator';
+import { resolveRpgRuntimeChoice } from '.';
 import type {
   GiftModalState,
   RecruitModalState,
@@ -169,7 +157,6 @@ function normalizeRecruitDialogue(
 export function useStoryNpcInteractionFlow({
   gameState,
   setGameState,
-  commitGeneratedState,
   getNpcEncounterKey,
   getResolvedNpcState,
   updateNpcState,
@@ -178,7 +165,6 @@ export function useStoryNpcInteractionFlow({
 }: {
   gameState: GameState;
   setGameState: Dispatch<SetStateAction<GameState>>;
-  commitGeneratedState: CommitGeneratedState;
   getNpcEncounterKey: (encounter: Encounter) => string;
   getResolvedNpcState: (state: GameState, encounter: Encounter) => GameState['npcStates'][string];
   updateNpcState: (
@@ -375,142 +361,65 @@ export function useStoryNpcInteractionFlow({
     }
   };
 
-  const buildRecruitmentOutcome = (
-    encounter: Encounter,
-    releasedNpcId?: string | null,
-  ) => {
-    if (!gameState.playerCharacter) return null;
+  const resolveRecruitmentOnServer = async (params: {
+    encounter: Encounter;
+    actionText: string;
+    releasedNpcId?: string | null;
+    preludeText?: string | null;
+  }) => {
+    const playerCharacter = gameState.playerCharacter;
+    if (
+      !playerCharacter ||
+      !gameState.worldType ||
+      gameState.currentScene !== 'Story'
+    ) {
+      return false;
+    }
 
-    const npcState = getResolvedNpcState(gameState, encounter);
-    const recruitKey = getNpcEncounterKey(encounter);
-    let releasedCompanionName: string | null = null;
-
-    const nextNpcStates = {
-      ...gameState.npcStates,
-      [recruitKey]: {
-        ...syncNpcNarrativeState({
-          encounter,
-          npcState: {
-            ...markNpcFirstMeaningfulContactResolved(npcState),
-            recruited: true,
-            stanceProfile: applyStoryChoiceToStanceProfile(
-              npcState.stanceProfile,
-              'npc_recruit',
-              { recruited: true },
-            ),
+    try {
+      const { hydratedSnapshot, nextStory } = await resolveRpgRuntimeChoice({
+        gameState,
+        currentStory: runtime.currentStory,
+        option: {
+          functionId: 'npc_recruit',
+          actionText: params.actionText,
+          interaction: {
+            kind: 'npc',
+            npcId: params.encounter.id ?? getNpcEncounterKey(params.encounter),
+            action: 'recruit',
           },
-          customWorldProfile: gameState.customWorldProfile,
-          storyEngineMemory: gameState.storyEngineMemory,
-        }),
-      },
-    };
-
-    if (releasedNpcId) {
-      const releasedCompanion = gameState.companions.find(item => item.npcId === releasedNpcId);
-      releasedCompanionName = releasedCompanion?.characterId
-        ? getCharacterById(releasedCompanion.characterId)?.name ?? null
-        : null;
-    }
-
-    const recruitCharacter = resolveEncounterRecruitCharacter(encounter);
-    if (!recruitCharacter) return null;
-
-    const recruitedCompanion = buildCompanionState(
-      recruitKey,
-      recruitCharacter,
-      npcState.affinity,
-      gameState.worldType,
-      gameState.customWorldProfile,
-    );
-    const rosterState = recruitCompanionToParty(gameState, recruitedCompanion, releasedNpcId);
-
-    const nextState: GameState = {
-      ...rosterState,
-      npcStates: nextNpcStates,
-    currentEncounter: null,
-    npcInteractionActive: false,
-    sceneHostileNpcs: [],
-    playerX: 0,
-      playerFacing: 'right' as const,
-      animationState: gameState.animationState,
-      scrollWorld: false,
-      inBattle: false,
-      currentBattleNpcId: null,
-      currentNpcBattleMode: null,
-      currentNpcBattleOutcome: null,
-      sparReturnEncounter: null,
-      sparPlayerHpBefore: null,
-      sparPlayerMaxHpBefore: null,
-      sparStoryHistoryBefore: null,
-      ambientIdleMode: undefined,
-      activeCombatEffects: [],
-    };
-
-    return {
-      nextState,
-      releasedCompanionName,
-    };
-  };
-
-  const executeRecruitment = (
-    encounter: Encounter,
-    actionText: string,
-    releasedNpcId?: string | null,
-    preludeText?: string | null,
-  ) => {
-    if (!gameState.playerCharacter) return;
-
-    const outcome = buildRecruitmentOutcome(encounter, releasedNpcId);
-    if (!outcome) return;
-
-    const recruitResultText = buildNpcRecruitResultText(encounter, outcome.releasedCompanionName);
-    setRecruitModal(null);
-
-    if (!preludeText) {
-      void commitGeneratedState(
-        outcome.nextState,
-        gameState.playerCharacter,
-        actionText,
-        recruitResultText,
-        'npc_recruit',
-      );
-      return;
-    }
-
-    const nextHistory = [
-      ...gameState.storyHistory,
-      createHistoryMoment(actionText, 'action'),
-      createHistoryMoment(preludeText, 'result'),
-      createHistoryMoment(recruitResultText, 'result'),
-    ];
-    const stateWithHistory = {
-      ...outcome.nextState,
-      storyHistory: nextHistory,
-    };
-
-    setGameState(stateWithHistory);
-    runtime.setAiError(null);
-
-    void runtime.generateStoryForState({
-      state: stateWithHistory,
-      character: gameState.playerCharacter,
-      history: nextHistory,
-      choice: actionText,
-      lastFunctionId: 'npc_recruit',
-    })
-      .then(nextStory => {
-        runtime.setCurrentStory(nextStory);
-      })
-      .catch(error => {
-        console.error('Failed to continue recruit story:', error);
-        runtime.setAiError(error instanceof Error ? error.message : '未知智能生成错误');
-        runtime.setCurrentStory(
-          runtime.buildFallbackStoryForState(stateWithHistory, gameState.playerCharacter!, recruitResultText),
-        );
-      })
-      .finally(() => {
-        runtime.setIsLoading(false);
+        },
+        payload: {
+          ...(params.releasedNpcId
+            ? {
+                releaseNpcId: params.releasedNpcId,
+              }
+            : {}),
+          ...(params.preludeText
+            ? {
+                preludeText: params.preludeText,
+              }
+            : {}),
+        },
       });
+
+      setGameState(hydratedSnapshot.gameState);
+      runtime.setCurrentStory(nextStory);
+      return true;
+    } catch (error) {
+      console.error('Failed to resolve npc recruit action on the server:', error);
+      runtime.setAiError(
+        error instanceof Error ? error.message : 'NPC 招募执行失败',
+      );
+      if (!runtime.currentStory) {
+        runtime.setCurrentStory(
+          runtime.buildFallbackStoryForState(gameState, playerCharacter),
+        );
+      }
+      return false;
+    } finally {
+      runtime.setIsLoading(false);
+    }
   };
 
   const startRecruitmentSequence = async (
@@ -599,7 +508,12 @@ export function useStoryNpcInteractionFlow({
     );
     runtime.setCurrentStory(runtime.buildDialogueStoryMoment(encounter.npcName, finalDialogueText, [], false));
     await new Promise(resolve => window.setTimeout(resolve, 260));
-    executeRecruitment(encounter, actionText, releasedNpcId, finalDialogueText);
+    await resolveRecruitmentOnServer({
+      encounter,
+      actionText,
+      releasedNpcId,
+      preludeText: finalDialogueText,
+    });
   };
 
   const openTradeModal = (encounter: Encounter, actionText: string) => {
@@ -678,7 +592,7 @@ export function useStoryNpcInteractionFlow({
     runtime.setIsLoading(true);
 
     try {
-      const { hydratedSnapshot, nextStory } = await resolveServerRuntimeChoice({
+      const { hydratedSnapshot, nextStory } = await resolveRpgRuntimeChoice({
         gameState,
         currentStory: runtime.currentStory,
         option: {
diff --git a/src/hooks/story/openingAdventure.ts b/src/hooks/rpg-runtime-story/openingAdventure.ts
similarity index 99%
rename from src/hooks/story/openingAdventure.ts
rename to src/hooks/rpg-runtime-story/openingAdventure.ts
index 565cedbe..a60f482a 100644
--- a/src/hooks/story/openingAdventure.ts
+++ b/src/hooks/rpg-runtime-story/openingAdventure.ts
@@ -1,4 +1,4 @@
-import type { Dispatch, SetStateAction } from 'react';
+import type { Dispatch, SetStateAction } from 'react';
 
 import {
   hasEncounterEntity,
diff --git a/src/hooks/story/progressionActions.ts b/src/hooks/rpg-runtime-story/progressionActions.ts
similarity index 99%
rename from src/hooks/story/progressionActions.ts
rename to src/hooks/rpg-runtime-story/progressionActions.ts
index f5fac00b..bf6ef118 100644
--- a/src/hooks/story/progressionActions.ts
+++ b/src/hooks/rpg-runtime-story/progressionActions.ts
@@ -1,4 +1,4 @@
-import type { Dispatch, SetStateAction } from 'react';
+import type { Dispatch, SetStateAction } from 'react';
 
 import {
   acceptQuest,
diff --git a/src/hooks/story/runtimeStoryCoordinator.ts b/src/hooks/rpg-runtime-story/rpgRuntimeStoryGateway.ts
similarity index 67%
rename from src/hooks/story/runtimeStoryCoordinator.ts
rename to src/hooks/rpg-runtime-story/rpgRuntimeStoryGateway.ts
index 6d9075d8..5b86f6a4 100644
--- a/src/hooks/story/runtimeStoryCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/rpgRuntimeStoryGateway.ts
@@ -1,15 +1,15 @@
-import { rehydrateSavedSnapshot } from '../../persistence/runtimeSnapshot';
+import { rehydrateSavedSnapshot } from '../../persistence/runtimeSnapshot';
 import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
 import {
-  getRuntimeClientVersion,
-  getRuntimeSessionId,
-  getRuntimeStoryState,
-  resolveRuntimeStoryAction,
+  getRpgRuntimeClientVersion,
+  getRpgRuntimeSessionId,
+  getRpgRuntimeStoryState,
+  resolveRpgRuntimeStoryAction,
   type RuntimeStorySnapshotRequest,
-  resolveRuntimeStoryMoment,
+  resolveRpgRuntimeStoryMoment,
   type RuntimeStoryChoicePayload,
   type RuntimeStoryResponse,
-} from '../../services/runtimeStoryService';
+} from '../../services/rpg-runtime/rpgRuntimeStoryClient';
 import type { GameState, StoryMoment, StoryOption } from '../../types';
 
 function getRuntimeResponseOptions(response: RuntimeStoryResponse) {
@@ -21,24 +21,28 @@ function getRuntimeResponseOptions(response: RuntimeStoryResponse) {
 function buildRuntimeSnapshotRequest(
   gameState: GameState,
   currentStory: StoryMoment | null,
-) {
+): RuntimeStorySnapshotRequest {
   return {
     gameState,
     bottomTab: 'adventure',
     currentStory,
-  } satisfies RuntimeStorySnapshotRequest;
+  };
 }
 
+/**
+ * 前端访问服务端 runtime story 的统一网关。
+ * 统一处理 option catalog 拉取、继续游戏恢复与正式动作结算。
+ */
 export async function loadServerRuntimeOptionCatalog(params: {
   gameState: GameState;
   currentStory: StoryMoment | null;
 }) {
-  const response = await getRuntimeStoryState({
-    sessionId: getRuntimeSessionId(params.gameState),
-    clientVersion: getRuntimeClientVersion(params.gameState),
+  const response = await getRpgRuntimeStoryState({
+    sessionId: getRpgRuntimeSessionId(params.gameState),
+    clientVersion: getRpgRuntimeClientVersion(params.gameState),
     snapshot: buildRuntimeSnapshotRequest(params.gameState, params.currentStory),
   });
-  const options = resolveRuntimeStoryMoment({
+  const options = resolveRpgRuntimeStoryMoment({
     response,
     hydratedSnapshot: response.snapshot,
     fallbackGameState: params.gameState,
@@ -64,14 +68,14 @@ export async function resumeServerRuntimeStory(
     };
   }
 
-  const response = await getRuntimeStoryState({
-    sessionId: getRuntimeSessionId(hydratedSnapshot.gameState),
+  const response = await getRpgRuntimeStoryState({
+    sessionId: getRpgRuntimeSessionId(hydratedSnapshot.gameState),
   });
   const resumedSnapshot = rehydrateSavedSnapshot(response.snapshot);
   const runtimeOptions = getRuntimeResponseOptions(response);
   const nextStory =
     response.presentation.storyText || runtimeOptions.length > 0
-      ? resolveRuntimeStoryMoment({
+      ? resolveRpgRuntimeStoryMoment({
           response,
           hydratedSnapshot: resumedSnapshot,
           fallbackGameState: hydratedSnapshot.gameState,
@@ -96,9 +100,9 @@ export async function resolveServerRuntimeChoice(params: {
     Partial<Pick<StoryOption, 'interaction'>>;
   payload?: RuntimeStoryChoicePayload;
 }) {
-  const response = await resolveRuntimeStoryAction({
-    sessionId: getRuntimeSessionId(params.gameState),
-    clientVersion: getRuntimeClientVersion(params.gameState),
+  const response = await resolveRpgRuntimeStoryAction({
+    sessionId: getRpgRuntimeSessionId(params.gameState),
+    clientVersion: getRpgRuntimeClientVersion(params.gameState),
     option: params.option,
     targetId:
       params.option.interaction?.kind === 'npc'
@@ -112,7 +116,7 @@ export async function resolveServerRuntimeChoice(params: {
   return {
     response,
     hydratedSnapshot,
-    nextStory: resolveRuntimeStoryMoment({
+    nextStory: resolveRpgRuntimeStoryMoment({
       response,
       hydratedSnapshot,
       fallbackGameState: params.gameState,
@@ -123,3 +127,14 @@ export async function resolveServerRuntimeChoice(params: {
     }),
   };
 }
+
+export type LoadRpgRuntimeOptionCatalogParams = Parameters<
+  typeof loadServerRuntimeOptionCatalog
+>[0];
+export type ResolveRpgRuntimeChoiceParams = Parameters<
+  typeof resolveServerRuntimeChoice
+>[0];
+
+export const loadRpgRuntimeOptionCatalog = loadServerRuntimeOptionCatalog;
+export const resumeRpgRuntimeStory = resumeServerRuntimeStory;
+export const resolveRpgRuntimeChoice = resolveServerRuntimeChoice;
diff --git a/src/hooks/story/runtimeStoryCoordinator.test.ts b/src/hooks/rpg-runtime-story/runtimeStoryCoordinator.test.ts
similarity index 96%
rename from src/hooks/story/runtimeStoryCoordinator.test.ts
rename to src/hooks/rpg-runtime-story/runtimeStoryCoordinator.test.ts
index 57d79332..d5a35ecc 100644
--- a/src/hooks/story/runtimeStoryCoordinator.test.ts
+++ b/src/hooks/rpg-runtime-story/runtimeStoryCoordinator.test.ts
@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 const {
   getRuntimeStoryStateMock,
@@ -12,14 +12,20 @@ const {
   getRuntimeClientVersionMock: vi.fn(() => 0),
 }));
 
-vi.mock('../../services/runtimeStoryService', async () => {
+vi.mock('../../services/rpg-runtime/rpgRuntimeStoryClient', async () => {
   const actual =
-    await vi.importActual<typeof import('../../services/runtimeStoryService')>(
-      '../../services/runtimeStoryService',
+    await vi.importActual<
+      typeof import('../../services/rpg-runtime/rpgRuntimeStoryClient')
+    >(
+      '../../services/rpg-runtime/rpgRuntimeStoryClient',
     );
 
   return {
     ...actual,
+    getRpgRuntimeStoryState: getRuntimeStoryStateMock,
+    resolveRpgRuntimeStoryAction: resolveRuntimeStoryActionMock,
+    getRpgRuntimeSessionId: getRuntimeSessionIdMock,
+    getRpgRuntimeClientVersion: getRuntimeClientVersionMock,
     getRuntimeStoryState: getRuntimeStoryStateMock,
     resolveRuntimeStoryAction: resolveRuntimeStoryActionMock,
     getRuntimeSessionId: getRuntimeSessionIdMock,
diff --git a/src/hooks/rpg-runtime-story/runtimeStoryCoordinator.ts b/src/hooks/rpg-runtime-story/runtimeStoryCoordinator.ts
new file mode 100644
index 00000000..c7fe01b8
--- /dev/null
+++ b/src/hooks/rpg-runtime-story/runtimeStoryCoordinator.ts
@@ -0,0 +1,7 @@
+export {
+  loadRpgRuntimeOptionCatalog as loadServerRuntimeOptionCatalog,
+  resolveRpgRuntimeChoice as resolveServerRuntimeChoice,
+  resumeRpgRuntimeStory as resumeServerRuntimeStory,
+  type LoadRpgRuntimeOptionCatalogParams,
+  type ResolveRpgRuntimeChoiceParams,
+} from './rpgRuntimeStoryGateway';
diff --git a/src/hooks/story/sessionActions.test.ts b/src/hooks/rpg-runtime-story/sessionActions.test.ts
similarity index 99%
rename from src/hooks/story/sessionActions.test.ts
rename to src/hooks/rpg-runtime-story/sessionActions.test.ts
index 070bf68c..80f2b7c0 100644
--- a/src/hooks/story/sessionActions.test.ts
+++ b/src/hooks/rpg-runtime-story/sessionActions.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it } from 'vitest';
 
 import { buildInitialNpcState } from '../../data/npcInteractions';
 import {
diff --git a/src/hooks/story/sessionActions.ts b/src/hooks/rpg-runtime-story/sessionActions.ts
similarity index 99%
rename from src/hooks/story/sessionActions.ts
rename to src/hooks/rpg-runtime-story/sessionActions.ts
index 6ba0aaee..32b438bb 100644
--- a/src/hooks/story/sessionActions.ts
+++ b/src/hooks/rpg-runtime-story/sessionActions.ts
@@ -1,4 +1,4 @@
-import type {
+import type {
   Dispatch,
   SetStateAction,
 } from 'react';
diff --git a/src/hooks/story/storyCampCompanion.test.ts b/src/hooks/rpg-runtime-story/storyCampCompanion.test.ts
similarity index 99%
rename from src/hooks/story/storyCampCompanion.test.ts
rename to src/hooks/rpg-runtime-story/storyCampCompanion.test.ts
index eec9f07f..f133fbb8 100644
--- a/src/hooks/story/storyCampCompanion.test.ts
+++ b/src/hooks/rpg-runtime-story/storyCampCompanion.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 import { getWorldCampScenePreset } from '../../data/scenePresets';
 import {
diff --git a/src/hooks/story/storyCampCompanion.ts b/src/hooks/rpg-runtime-story/storyCampCompanion.ts
similarity index 99%
rename from src/hooks/story/storyCampCompanion.ts
rename to src/hooks/rpg-runtime-story/storyCampCompanion.ts
index 9cb6c9f6..c6713fc9 100644
--- a/src/hooks/story/storyCampCompanion.ts
+++ b/src/hooks/rpg-runtime-story/storyCampCompanion.ts
@@ -1,4 +1,4 @@
-import {
+import {
   getCharacterAdventureOpening,
   getCharacterHomeSceneId,
 } from '../../data/characterPresets';
diff --git a/src/hooks/story/storyChoiceContinuation.ts b/src/hooks/rpg-runtime-story/storyChoiceContinuation.ts
similarity index 99%
rename from src/hooks/story/storyChoiceContinuation.ts
rename to src/hooks/rpg-runtime-story/storyChoiceContinuation.ts
index 8302a1de..16e63e99 100644
--- a/src/hooks/story/storyChoiceContinuation.ts
+++ b/src/hooks/rpg-runtime-story/storyChoiceContinuation.ts
@@ -1,4 +1,4 @@
-import { addInventoryItems } from '../../data/npcInteractions';
+import { addInventoryItems } from '../../data/npcInteractions';
 import { applyQuestProgressFromHostileNpcDefeat } from '../../data/questFlow';
 import { applyStoryReasoningRecovery } from '../../data/storyRecovery';
 import { generateNextStep } from '../../services/aiService';
diff --git a/src/hooks/story/storyChoiceCoordinator.test.ts b/src/hooks/rpg-runtime-story/storyChoiceCoordinator.test.ts
similarity index 98%
rename from src/hooks/story/storyChoiceCoordinator.test.ts
rename to src/hooks/rpg-runtime-story/storyChoiceCoordinator.test.ts
index 4ef6c5b6..a4ae5702 100644
--- a/src/hooks/story/storyChoiceCoordinator.test.ts
+++ b/src/hooks/rpg-runtime-story/storyChoiceCoordinator.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 import type {
   Character,
diff --git a/src/hooks/story/storyChoiceCoordinator.ts b/src/hooks/rpg-runtime-story/storyChoiceCoordinator.ts
similarity index 99%
rename from src/hooks/story/storyChoiceCoordinator.ts
rename to src/hooks/rpg-runtime-story/storyChoiceCoordinator.ts
index f8d43d2e..abb46c41 100644
--- a/src/hooks/story/storyChoiceCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/storyChoiceCoordinator.ts
@@ -1,4 +1,4 @@
-import type { Dispatch, SetStateAction } from 'react';
+import type { Dispatch, SetStateAction } from 'react';
 
 import type {
   Character,
diff --git a/src/hooks/story/storyChoiceRuntime.test.ts b/src/hooks/rpg-runtime-story/storyChoiceRuntime.test.ts
similarity index 98%
rename from src/hooks/story/storyChoiceRuntime.test.ts
rename to src/hooks/rpg-runtime-story/storyChoiceRuntime.test.ts
index 01e6009e..ca8c1536 100644
--- a/src/hooks/story/storyChoiceRuntime.test.ts
+++ b/src/hooks/rpg-runtime-story/storyChoiceRuntime.test.ts
@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 const {
   rollHostileNpcLootMock,
@@ -20,8 +20,8 @@ vi.mock('../../data/hostileNpcPresets', async () => {
   };
 });
 
-vi.mock('./runtimeStoryCoordinator', () => ({
-  resolveServerRuntimeChoice: resolveServerRuntimeChoiceMock,
+vi.mock('.', () => ({
+  resolveRpgRuntimeChoice: resolveServerRuntimeChoiceMock,
 }));
 
 import type { Character, GameState, StoryMoment, StoryOption } from '../../types';
diff --git a/src/hooks/story/storyChoiceRuntime.ts b/src/hooks/rpg-runtime-story/storyChoiceRuntime.ts
similarity index 98%
rename from src/hooks/story/storyChoiceRuntime.ts
rename to src/hooks/rpg-runtime-story/storyChoiceRuntime.ts
index 88b09d7f..d8ce88f1 100644
--- a/src/hooks/story/storyChoiceRuntime.ts
+++ b/src/hooks/rpg-runtime-story/storyChoiceRuntime.ts
@@ -1,4 +1,4 @@
-import {
+import {
   buildEncounterEntryState,
   hasEncounterEntity,
 } from '../../data/encounterTransition';
@@ -17,7 +17,7 @@ import {
   StoryMoment,
   StoryOption,
 } from '../../types';
-import { resolveServerRuntimeChoice } from './runtimeStoryCoordinator';
+import { resolveRpgRuntimeChoice } from '.';
 import type { BattleRewardSummary } from './uiTypes';
 
 type RuntimeStatsIncrements = Partial<
@@ -302,7 +302,7 @@ export async function runServerRuntimeChoiceAction(params: {
   params.setIsLoading(true);
 
   try {
-    const { hydratedSnapshot, nextStory } = await resolveServerRuntimeChoice({
+    const { hydratedSnapshot, nextStory } = await resolveRpgRuntimeChoice({
       gameState: params.gameState,
       currentStory: params.currentStory,
       option: params.option,
diff --git a/src/hooks/story/storyContextBuilder.ts b/src/hooks/rpg-runtime-story/storyContextBuilder.ts
similarity index 99%
rename from src/hooks/story/storyContextBuilder.ts
rename to src/hooks/rpg-runtime-story/storyContextBuilder.ts
index 5a5a9303..433e27c4 100644
--- a/src/hooks/story/storyContextBuilder.ts
+++ b/src/hooks/rpg-runtime-story/storyContextBuilder.ts
@@ -1,4 +1,4 @@
-import { getCharacterById } from '../../data/characterPresets';
+import { getCharacterById } from '../../data/characterPresets';
 import {
   NPC_CHAT_FUNCTION,
   STORY_OPENING_CAMP_DIALOGUE_FUNCTION,
diff --git a/src/hooks/story/storyEncounterState.test.ts b/src/hooks/rpg-runtime-story/storyEncounterState.test.ts
similarity index 98%
rename from src/hooks/story/storyEncounterState.test.ts
rename to src/hooks/rpg-runtime-story/storyEncounterState.test.ts
index 7d1eb981..1a4c7b6e 100644
--- a/src/hooks/story/storyEncounterState.test.ts
+++ b/src/hooks/rpg-runtime-story/storyEncounterState.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 import {
   AnimationState,
diff --git a/src/hooks/story/storyEncounterState.ts b/src/hooks/rpg-runtime-story/storyEncounterState.ts
similarity index 98%
rename from src/hooks/story/storyEncounterState.ts
rename to src/hooks/rpg-runtime-story/storyEncounterState.ts
index 996a3710..eb277ac4 100644
--- a/src/hooks/story/storyEncounterState.ts
+++ b/src/hooks/rpg-runtime-story/storyEncounterState.ts
@@ -1,4 +1,4 @@
-import { buildNpcPreviewTalkOption } from '../../data/functionCatalog';
+import { buildNpcPreviewTalkOption } from '../../data/functionCatalog';
 import {
   getDefaultFunctionIdsForContext,
   resolveFunctionOption,
diff --git a/src/hooks/story/storyGenerationState.test.ts b/src/hooks/rpg-runtime-story/storyGenerationState.test.ts
similarity index 99%
rename from src/hooks/story/storyGenerationState.test.ts
rename to src/hooks/rpg-runtime-story/storyGenerationState.test.ts
index 7d9c7871..d0b0de57 100644
--- a/src/hooks/story/storyGenerationState.test.ts
+++ b/src/hooks/rpg-runtime-story/storyGenerationState.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 const { scenes } = vi.hoisted(() => ({
   scenes: [
diff --git a/src/hooks/story/storyGenerationState.ts b/src/hooks/rpg-runtime-story/storyGenerationState.ts
similarity index 99%
rename from src/hooks/story/storyGenerationState.ts
rename to src/hooks/rpg-runtime-story/storyGenerationState.ts
index bcfed90b..55fb415b 100644
--- a/src/hooks/story/storyGenerationState.ts
+++ b/src/hooks/rpg-runtime-story/storyGenerationState.ts
@@ -1,4 +1,4 @@
-import {
+import {
   buildNpcGiftModalState,
   buildNpcRecruitModalState,
   buildNpcTradeModalState,
diff --git a/src/hooks/story/storyInteractionCoordinator.test.ts b/src/hooks/rpg-runtime-story/storyInteractionCoordinator.test.ts
similarity index 98%
rename from src/hooks/story/storyInteractionCoordinator.test.ts
rename to src/hooks/rpg-runtime-story/storyInteractionCoordinator.test.ts
index c2af8b49..92143157 100644
--- a/src/hooks/story/storyInteractionCoordinator.test.ts
+++ b/src/hooks/rpg-runtime-story/storyInteractionCoordinator.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 import type { GameState, StoryMoment, StoryOption } from '../../types';
 import { createStoryInteractionCoordinatorConfig } from './storyInteractionCoordinator';
@@ -104,7 +104,6 @@ describe('storyInteractionCoordinator', () => {
       expect.objectContaining({
         gameState,
         setGameState,
-        commitGeneratedState,
         getNpcEncounterKey: runtimeSupport.getNpcEncounterKey,
         getResolvedNpcState: runtimeSupport.getResolvedNpcState,
         updateNpcState: runtimeSupport.updateNpcState,
diff --git a/src/hooks/story/storyInteractionCoordinator.ts b/src/hooks/rpg-runtime-story/storyInteractionCoordinator.ts
similarity index 84%
rename from src/hooks/story/storyInteractionCoordinator.ts
rename to src/hooks/rpg-runtime-story/storyInteractionCoordinator.ts
index 515082bc..300f7056 100644
--- a/src/hooks/story/storyInteractionCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/storyInteractionCoordinator.ts
@@ -1,4 +1,4 @@
-import type { Dispatch, SetStateAction } from 'react';
+import type { Dispatch, SetStateAction } from 'react';
 
 import type { StoryGenerationContext } from '../../services/aiTypes';
 import type {
@@ -9,7 +9,7 @@ import type {
   StoryOption,
 } from '../../types';
 import type { StoryRuntimeSupport } from './storyRuntimeSupport';
-import type { StoryRuntimeControllerResult } from './useStoryRuntimeController';
+import type { RpgRuntimeStoryControllerResult } from './useRpgRuntimeStoryController';
 
 type StoryInteractionCoordinatorParams = {
   gameState: GameState;
@@ -32,18 +32,18 @@ type StoryInteractionCoordinatorParams = {
     character: Character,
     fallbackText?: string,
   ) => StoryMoment;
-  buildDialogueStoryMoment: StoryRuntimeControllerResult['buildDialogueStoryMoment'];
-  generateStoryForState: StoryRuntimeControllerResult['generateStoryForState'];
-  getAvailableOptionsForState: StoryRuntimeControllerResult['getAvailableOptionsForState'];
+  buildDialogueStoryMoment: RpgRuntimeStoryControllerResult['buildDialogueStoryMoment'];
+  generateStoryForState: RpgRuntimeStoryControllerResult['generateStoryForState'];
+  getAvailableOptionsForState: RpgRuntimeStoryControllerResult['getAvailableOptionsForState'];
   getStoryGenerationHostileNpcs: (
     state: GameState,
   ) => GameState['sceneHostileNpcs'];
-  getTypewriterDelay: StoryRuntimeControllerResult['getTypewriterDelay'];
+  getTypewriterDelay: RpgRuntimeStoryControllerResult['getTypewriterDelay'];
   runtimeSupport: StoryRuntimeSupport;
-  commitGeneratedState: StoryRuntimeControllerResult['commitGeneratedState'];
-  commitGeneratedStateWithEncounterEntry: StoryRuntimeControllerResult['commitGeneratedStateWithEncounterEntry'];
-  appendHistory: StoryRuntimeControllerResult['appendHistory'];
-  buildOpeningCampChatContext: StoryRuntimeControllerResult['buildOpeningCampChatContext'];
+  commitGeneratedState: RpgRuntimeStoryControllerResult['commitGeneratedState'];
+  commitGeneratedStateWithEncounterEntry: RpgRuntimeStoryControllerResult['commitGeneratedStateWithEncounterEntry'];
+  appendHistory: RpgRuntimeStoryControllerResult['appendHistory'];
+  buildOpeningCampChatContext: RpgRuntimeStoryControllerResult['buildOpeningCampChatContext'];
   sortOptions: (options: StoryOption[]) => StoryOption[];
   buildContinueAdventureOption: () => StoryOption;
   sanitizeOptions: (
@@ -81,7 +81,6 @@ export function createStoryInteractionCoordinatorConfig(
     npcInteractionFlow: {
       gameState: params.gameState,
       setGameState: params.setGameState,
-      commitGeneratedState: params.commitGeneratedState,
       getNpcEncounterKey: params.runtimeSupport.getNpcEncounterKey,
       getResolvedNpcState: params.runtimeSupport.getResolvedNpcState,
       updateNpcState: params.runtimeSupport.updateNpcState,
diff --git a/src/hooks/story/storyPresentation.test.ts b/src/hooks/rpg-runtime-story/storyPresentation.test.ts
similarity index 98%
rename from src/hooks/story/storyPresentation.test.ts
rename to src/hooks/rpg-runtime-story/storyPresentation.test.ts
index 4b7c63fe..946fa8f4 100644
--- a/src/hooks/story/storyPresentation.test.ts
+++ b/src/hooks/rpg-runtime-story/storyPresentation.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it } from 'vitest';
 
 import {
   AnimationState,
diff --git a/src/hooks/story/storyPresentation.ts b/src/hooks/rpg-runtime-story/storyPresentation.ts
similarity index 98%
rename from src/hooks/story/storyPresentation.ts
rename to src/hooks/rpg-runtime-story/storyPresentation.ts
index a8fb06ef..443d7548 100644
--- a/src/hooks/story/storyPresentation.ts
+++ b/src/hooks/rpg-runtime-story/storyPresentation.ts
@@ -1,4 +1,4 @@
-import { sortStoryOptionsByPriority } from '../../data/stateFunctions';
+import { sortStoryOptionsByPriority } from '../../data/stateFunctions';
 import type {
   Character,
   GameState,
diff --git a/src/hooks/story/storyRenderingHelpers.ts b/src/hooks/rpg-runtime-story/storyRenderingHelpers.ts
similarity index 99%
rename from src/hooks/story/storyRenderingHelpers.ts
rename to src/hooks/rpg-runtime-story/storyRenderingHelpers.ts
index 4033d047..df66c321 100644
--- a/src/hooks/story/storyRenderingHelpers.ts
+++ b/src/hooks/rpg-runtime-story/storyRenderingHelpers.ts
@@ -1,4 +1,4 @@
-import type {
+import type {
   Character,
   GameState,
   StoryDialogueTurn,
diff --git a/src/hooks/story/storyRequestCoordinator.test.ts b/src/hooks/rpg-runtime-story/storyRequestCoordinator.test.ts
similarity index 98%
rename from src/hooks/story/storyRequestCoordinator.test.ts
rename to src/hooks/rpg-runtime-story/storyRequestCoordinator.test.ts
index d5e1a898..2d7e4526 100644
--- a/src/hooks/story/storyRequestCoordinator.test.ts
+++ b/src/hooks/rpg-runtime-story/storyRequestCoordinator.test.ts
@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 import type { StoryGenerationContext } from '../../services/aiService';
 import type { Character, GameState, StoryMoment, StoryOption } from '../../types';
diff --git a/src/hooks/story/storyRequestCoordinator.ts b/src/hooks/rpg-runtime-story/storyRequestCoordinator.ts
similarity index 92%
rename from src/hooks/story/storyRequestCoordinator.ts
rename to src/hooks/rpg-runtime-story/storyRequestCoordinator.ts
index df841027..c8dcf4df 100644
--- a/src/hooks/story/storyRequestCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/storyRequestCoordinator.ts
@@ -1,8 +1,8 @@
-import type {
+import type {
   StoryGenerationContext,
   StoryRequestOptions,
 } from '../../services/aiService';
-import { shouldUseServerRuntimeOptions } from '../../services/runtimeStoryService';
+import { shouldUseRpgRuntimeServerOptions } from '../../services/rpg-runtime';
 import type {
   AIResponse,
   Character,
@@ -12,7 +12,7 @@ import type {
   StoryOption,
   WorldType,
 } from '../../types';
-import { loadServerRuntimeOptionCatalog } from './runtimeStoryCoordinator';
+import { loadRpgRuntimeOptionCatalog } from '.';
 
 type BuildStoryContextFromState = (
   state: GameState,
@@ -54,7 +54,7 @@ type RequestNextStep = (
   requestOptions?: StoryRequestOptions,
 ) => Promise<AIResponse>;
 
-type LoadRuntimeOptionCatalog = typeof loadServerRuntimeOptionCatalog;
+type LoadRuntimeOptionCatalog = typeof loadRpgRuntimeOptionCatalog;
 
 export type ResolvedStoryRequestOptions = {
   availableOptions: StoryOption[] | null;
@@ -78,7 +78,7 @@ export async function resolveStoryRequestOptions(params: {
     ? null
     : params.getAvailableOptionsForState(params.state, params.character);
 
-  if (optionCatalog || !shouldUseServerRuntimeOptions(availableOptions)) {
+  if (optionCatalog || !shouldUseRpgRuntimeServerOptions(availableOptions)) {
     return {
       availableOptions,
       optionCatalog,
@@ -87,7 +87,7 @@ export async function resolveStoryRequestOptions(params: {
 
   try {
     const serverOptionCatalog = await (
-      params.loadRuntimeOptionCatalog ?? loadServerRuntimeOptionCatalog
+      params.loadRuntimeOptionCatalog ?? loadRpgRuntimeOptionCatalog
     )({
       gameState: params.state,
       currentStory: params.currentStory,
diff --git a/src/hooks/story/storyRequestRuntime.test.ts b/src/hooks/rpg-runtime-story/storyRequestRuntime.test.ts
similarity index 98%
rename from src/hooks/story/storyRequestRuntime.test.ts
rename to src/hooks/rpg-runtime-story/storyRequestRuntime.test.ts
index 71683663..ea637736 100644
--- a/src/hooks/story/storyRequestRuntime.test.ts
+++ b/src/hooks/rpg-runtime-story/storyRequestRuntime.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 import type {
   Character,
diff --git a/src/hooks/story/storyRequestRuntime.ts b/src/hooks/rpg-runtime-story/storyRequestRuntime.ts
similarity index 99%
rename from src/hooks/story/storyRequestRuntime.ts
rename to src/hooks/rpg-runtime-story/storyRequestRuntime.ts
index 247ae584..7fc2a03f 100644
--- a/src/hooks/story/storyRequestRuntime.ts
+++ b/src/hooks/rpg-runtime-story/storyRequestRuntime.ts
@@ -1,4 +1,4 @@
-import type {
+import type {
   Character,
   GameState,
   StoryMoment,
diff --git a/src/hooks/story/storyResponseOptions.test.ts b/src/hooks/rpg-runtime-story/storyResponseOptions.test.ts
similarity index 99%
rename from src/hooks/story/storyResponseOptions.test.ts
rename to src/hooks/rpg-runtime-story/storyResponseOptions.test.ts
index 09b5166a..8160e2f6 100644
--- a/src/hooks/story/storyResponseOptions.test.ts
+++ b/src/hooks/rpg-runtime-story/storyResponseOptions.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it } from 'vitest';
 
 import { AnimationState, type StoryOption } from '../../types';
 import { resolveStoryResponseOptions } from './storyResponseOptions';
diff --git a/src/hooks/story/storyResponseOptions.ts b/src/hooks/rpg-runtime-story/storyResponseOptions.ts
similarity index 97%
rename from src/hooks/story/storyResponseOptions.ts
rename to src/hooks/rpg-runtime-story/storyResponseOptions.ts
index b9ae54c2..d12c3dc3 100644
--- a/src/hooks/story/storyResponseOptions.ts
+++ b/src/hooks/rpg-runtime-story/storyResponseOptions.ts
@@ -1,4 +1,4 @@
-import { sortStoryOptionsByPriority } from '../../data/stateFunctions';
+import { sortStoryOptionsByPriority } from '../../data/stateFunctions';
 import type { StoryOption } from '../../types';
 
 type ResolveStoryResponseOptionsParams = {
diff --git a/src/hooks/story/storyRuntimeSupport.test.ts b/src/hooks/rpg-runtime-story/storyRuntimeSupport.test.ts
similarity index 98%
rename from src/hooks/story/storyRuntimeSupport.test.ts
rename to src/hooks/rpg-runtime-story/storyRuntimeSupport.test.ts
index a1be568e..1d7e7a34 100644
--- a/src/hooks/story/storyRuntimeSupport.test.ts
+++ b/src/hooks/rpg-runtime-story/storyRuntimeSupport.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it } from 'vitest';
 
 import type { GameState, InventoryItem } from '../../types';
 import {
diff --git a/src/hooks/story/storyRuntimeSupport.ts b/src/hooks/rpg-runtime-story/storyRuntimeSupport.ts
similarity index 99%
rename from src/hooks/story/storyRuntimeSupport.ts
rename to src/hooks/rpg-runtime-story/storyRuntimeSupport.ts
index 913c7f96..33af81e0 100644
--- a/src/hooks/story/storyRuntimeSupport.ts
+++ b/src/hooks/rpg-runtime-story/storyRuntimeSupport.ts
@@ -1,4 +1,4 @@
-import {
+import {
   buildInitialNpcState,
   buildNpcEncounterStoryMoment,
   normalizeNpcPersistentState,
diff --git a/src/hooks/story/uiTypes.ts b/src/hooks/rpg-runtime-story/uiTypes.ts
similarity index 99%
rename from src/hooks/story/uiTypes.ts
rename to src/hooks/rpg-runtime-story/uiTypes.ts
index 9b901fc4..cc3d5c0a 100644
--- a/src/hooks/story/uiTypes.ts
+++ b/src/hooks/rpg-runtime-story/uiTypes.ts
@@ -1,4 +1,4 @@
-import type {
+import type {
   Encounter,
   GoalHandoff,
   GoalPulseEvent,
diff --git a/src/hooks/story/useStoryInteractionCoordinator.test.ts b/src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.test.ts
similarity index 53%
rename from src/hooks/story/useStoryInteractionCoordinator.test.ts
rename to src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.test.ts
index 55672dd6..7e593a02 100644
--- a/src/hooks/story/useStoryInteractionCoordinator.test.ts
+++ b/src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.test.ts
@@ -1,11 +1,11 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
-import { createClearStoryInteractionUi } from './useStoryInteractionCoordinator';
+import { createRpgRuntimeInteractionUiResetter } from './useRpgRuntimeInteractionFlow';
 
-describe('useStoryInteractionCoordinator helpers', () => {
+describe('useRpgRuntimeInteractionFlow helpers', () => {
   it('clears interaction ui in the expected order', () => {
     const calls: string[] = [];
-    const clearStoryInteractionUi = createClearStoryInteractionUi({
+    const clearStoryInteractionUi = createRpgRuntimeInteractionUiResetter({
       clearStoryChoiceUi: vi.fn(() => calls.push('choice')),
       clearNpcInteractionUi: vi.fn(() => calls.push('npc')),
     });
diff --git a/src/hooks/story/useStoryInteractionCoordinator.ts b/src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.ts
similarity index 91%
rename from src/hooks/story/useStoryInteractionCoordinator.ts
rename to src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.ts
index 7a5f964d..cd8aec8c 100644
--- a/src/hooks/story/useStoryInteractionCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/useRpgRuntimeInteractionFlow.ts
@@ -1,4 +1,4 @@
-import { useCallback, useEffect } from 'react';
+import { useCallback, useEffect } from 'react';
 
 import type {
   Character,
@@ -11,7 +11,7 @@ import type { ResolvedChoiceState } from '../combat/resolvedChoice';
 import type { EscapePlaybackSync as ResolvedChoicePlaybackSync } from '../combat/escapeFlow';
 import { useTreasureFlow } from '../useTreasureFlow';
 import { useStoryInventoryActions } from './inventoryActions';
-import { createStoryNpcEncounterActions } from './npcEncounterActions';
+import { createRpgRuntimeNpcEncounterActions } from './useRpgRuntimeNpcInteraction';
 import { useStoryNpcInteractionFlow } from './npcInteraction';
 import type { StoryInteractionCoordinatorConfig } from './storyInteractionCoordinator';
 import type { StoryRuntimeSupport } from './storyRuntimeSupport';
@@ -22,7 +22,7 @@ import type {
 } from './storyChoiceCoordinator';
 import { useStoryChoiceCoordinator } from './useStoryChoiceCoordinator';
 
-type StoryInteractionCoordinatorParams = {
+type RpgRuntimeInteractionFlowParams = {
   gameState: GameState;
   isLoading: boolean;
   interactionConfig: StoryInteractionCoordinatorConfig;
@@ -67,7 +67,11 @@ export function createClearStoryInteractionUi(params: {
   };
 }
 
-export function useStoryInteractionCoordinator({
+/**
+ * RPG runtime 交互分发层。
+ * 统一串起宝箱、背包、NPC 交互与 story choice 的正式分发。
+ */
+export function useRpgRuntimeInteractionFlow({
   gameState,
   isLoading,
   interactionConfig,
@@ -84,7 +88,7 @@ export function useStoryInteractionCoordinator({
   npcPreviewTalkFunctionId,
   fallbackCompanionName,
   turnVisualMs,
-}: StoryInteractionCoordinatorParams) {
+}: RpgRuntimeInteractionFlowParams) {
   const { handleTreasureInteraction } = useTreasureFlow(
     interactionConfig.treasureFlow,
   );
@@ -104,7 +108,7 @@ export function useStoryInteractionCoordinator({
     replacePendingNpcQuestOffer,
     abandonPendingNpcQuestOffer,
     acceptPendingNpcQuestOffer,
-  } = createStoryNpcEncounterActions({
+  } = createRpgRuntimeNpcEncounterActions({
     ...interactionConfig.npcEncounterActions,
     buildNpcStory: runtimeSupport.buildNpcStory,
     npcInteractionFlow,
@@ -255,3 +259,13 @@ export function useStoryInteractionCoordinator({
     },
   };
 }
+
+export type UseRpgRuntimeInteractionFlowParams = Parameters<
+  typeof useRpgRuntimeInteractionFlow
+>[0];
+export type RpgRuntimeInteractionFlowResult = ReturnType<
+  typeof useRpgRuntimeInteractionFlow
+>;
+
+export const createRpgRuntimeInteractionUiResetter =
+  createClearStoryInteractionUi;
diff --git a/src/hooks/story/npcEncounterActions.ts b/src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts
similarity index 98%
rename from src/hooks/story/npcEncounterActions.ts
rename to src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts
index 7cefe20d..5ebaffd9 100644
--- a/src/hooks/story/npcEncounterActions.ts
+++ b/src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts
@@ -1,4 +1,4 @@
-import type { Dispatch, SetStateAction } from 'react';
+import type { Dispatch, SetStateAction } from 'react';
 
 import { buildRelationState } from '../../data/attributeResolver';
 import { NPC_FIGHT_FUNCTION } from '../../data/functionCatalog';
@@ -39,7 +39,7 @@ import type {
 } from '../../types';
 import { AnimationState } from '../../types';
 import type { CommitGeneratedState } from '../generatedState';
-import { resolveServerRuntimeChoice } from './runtimeStoryCoordinator';
+import { resolveRpgRuntimeChoice } from './rpgRuntimeStoryGateway';
 
 type CommitGeneratedStateWithEncounterEntry = (
   entryState: GameState,
@@ -103,6 +103,10 @@ const NPC_CHAT_QUEST_OFFER_FUNCTION_IDS = {
 type NpcChatQuestOfferPayloadAction =
   keyof typeof NPC_CHAT_QUEST_OFFER_FUNCTION_IDS;
 
+/**
+ * RPG runtime NPC 交互主链。
+ * 负责 NPC 对话、委托处理、战斗后续对话重开，以及需要服务端结算的正式动作派发。
+ */
 export function createStoryNpcEncounterActions({
   gameState,
   currentStory,
@@ -1535,7 +1539,7 @@ export function createStoryNpcEncounterActions({
     setIsLoading(true);
 
     try {
-      const { hydratedSnapshot, nextStory } = await resolveServerRuntimeChoice({
+      const { hydratedSnapshot, nextStory } = await resolveRpgRuntimeChoice({
         gameState,
         currentStory,
         option: params.option,
@@ -1801,3 +1805,19 @@ export function createStoryNpcEncounterActions({
     acceptPendingNpcQuestOffer,
   };
 }
+
+export type UseRpgRuntimeNpcInteractionParams = Parameters<
+  typeof createStoryNpcEncounterActions
+>[0];
+export type RpgRuntimeNpcInteractionResult = ReturnType<
+  typeof createStoryNpcEncounterActions
+>;
+
+export const createRpgRuntimeNpcEncounterActions =
+  createStoryNpcEncounterActions;
+
+export function useRpgRuntimeNpcInteraction(
+  params: UseRpgRuntimeNpcInteractionParams,
+) {
+  return createStoryNpcEncounterActions(params);
+}
diff --git a/src/hooks/useStoryGeneration.ts b/src/hooks/rpg-runtime-story/useRpgRuntimeStory.ts
similarity index 69%
rename from src/hooks/useStoryGeneration.ts
rename to src/hooks/rpg-runtime-story/useRpgRuntimeStory.ts
index 17d2aed6..70df271d 100644
--- a/src/hooks/useStoryGeneration.ts
+++ b/src/hooks/rpg-runtime-story/useRpgRuntimeStory.ts
@@ -1,33 +1,30 @@
-import type { Dispatch, SetStateAction } from 'react';
+import type { Dispatch, SetStateAction } from 'react';
 
 import {
   buildContinueAdventureOption,
   isCampTravelHomeOption,
   isContinueAdventureOption,
   NPC_PREVIEW_TALK_FUNCTION,
-} from '../data/functionCatalog';
-import { sortStoryOptionsByPriority } from '../data/stateFunctions';
-import type { GameState, StoryOption } from '../types';
-import type { EscapePlaybackSync as ResolvedChoicePlaybackSync } from './combat/escapeFlow';
-import type { ResolvedChoiceState } from './combat/resolvedChoice';
-import { useCharacterChatFlow } from './story/characterChat';
-import { buildStoryContextFromState } from './story/storyContextBuilder';
+} from '../../data/functionCatalog';
+import { sortStoryOptionsByPriority } from '../../data/stateFunctions';
+import type { GameState, StoryOption } from '../../types';
+import type { EscapePlaybackSync as ResolvedChoicePlaybackSync } from '../combat/escapeFlow';
+import type { ResolvedChoiceState } from '../combat/resolvedChoice';
+import { useCharacterChatFlow } from './characterChat';
+import { buildStoryContextFromState } from './storyContextBuilder';
 import {
   getResolvedSceneHostileNpcs,
   getStoryGenerationHostileNpcs,
   isNpcEncounter,
   isRegularNpcEncounter,
-} from './story/storyEncounterState';
+} from './storyEncounterState';
 import {
-  getNpcEncounterKey,
   resolveNpcInteractionDecision,
-} from './story/storyGenerationState';
-import {
-  storyRuntimeSupport,
-} from './story/storyRuntimeSupport';
-import { useStoryFlowCoordinator } from './story/useStoryFlowCoordinator';
-import { useStoryRuntimeController } from './story/useStoryRuntimeController';
-import type { BattleRewardUi, QuestFlowUi } from './story/uiTypes';
+} from './storyGenerationState';
+import { storyRuntimeSupport } from './storyRuntimeSupport';
+import { useRpgRuntimeStoryFlow } from './useRpgRuntimeStoryFlow';
+import { useRpgRuntimeStoryController } from './useRpgRuntimeStoryController';
+import type { BattleRewardUi, QuestFlowUi } from './uiTypes';
 
 const TURN_VISUAL_MS = 820;
 const NPC_PREVIEW_TALK_FUNCTION_ID = NPC_PREVIEW_TALK_FUNCTION.id;
@@ -37,7 +34,7 @@ export type {
   CharacterChatModalState,
   CharacterChatTarget,
   CharacterChatUi,
-} from './story/characterChat';
+} from './characterChat';
 export type {
   BattleRewardSummary,
   BattleRewardUi,
@@ -49,9 +46,14 @@ export type {
   RecruitModalState,
   StoryGenerationNpcUi,
   TradeModalState,
-} from './story/uiTypes';
+} from './uiTypes';
 
-export function useStoryGeneration({
+/**
+ * RPG runtime story 顶层装配入口。
+ * 这里负责收口角色聊天、story controller 与 story flow 三层能力，
+ * 让运行态主链直接消费 RPG 域命名，不再保留旧 story hook 入口。
+ */
+export function useRpgRuntimeStory({
   gameState,
   setGameState,
   buildResolvedChoiceState,
@@ -78,7 +80,7 @@ export function useStoryGeneration({
     buildStoryContextFromState,
   });
 
-  const runtimeController = useStoryRuntimeController({
+  const runtimeController = useRpgRuntimeStoryController({
     gameState,
     setGameState,
     buildStoryContextFromState,
@@ -100,7 +102,7 @@ export function useStoryGeneration({
     handleNpcChatInput,
     exitNpcChat,
     npcChatQuestOfferUi,
-  } = useStoryFlowCoordinator({
+  } = useRpgRuntimeStoryFlow({
     gameState,
     setGameState,
     buildResolvedChoiceState,
@@ -144,3 +146,6 @@ export function useStoryGeneration({
     npcChatQuestOfferUi,
   };
 }
+
+export type UseRpgRuntimeStoryParams = Parameters<typeof useRpgRuntimeStory>[0];
+export type RpgRuntimeStoryResult = ReturnType<typeof useRpgRuntimeStory>;
diff --git a/src/hooks/story/useStoryRuntimeController.ts b/src/hooks/rpg-runtime-story/useRpgRuntimeStoryController.ts
similarity index 86%
rename from src/hooks/story/useStoryRuntimeController.ts
rename to src/hooks/rpg-runtime-story/useRpgRuntimeStoryController.ts
index ed2ddce5..8d77113b 100644
--- a/src/hooks/story/useStoryRuntimeController.ts
+++ b/src/hooks/rpg-runtime-story/useRpgRuntimeStoryController.ts
@@ -1,4 +1,4 @@
-import { useCallback, useMemo, useState, type Dispatch, type SetStateAction } from 'react';
+import { useCallback, useMemo, useState, type Dispatch, type SetStateAction } from 'react';
 
 import { generateInitialStory, generateNextStep } from '../../services/aiService';
 import type { StoryGenerationContext } from '../../services/aiTypes';
@@ -25,7 +25,11 @@ type BuildStoryContextFromState = (
   extras?: StoryContextBuilderExtras,
 ) => StoryGenerationContext;
 
-export function useStoryRuntimeController(params: {
+/**
+ * RPG runtime story controller。
+ * 统一管理当前故事、AI 请求状态和生成后的状态提交。
+ */
+export function useRpgRuntimeStoryController(params: {
   gameState: GameState;
   setGameState: Dispatch<SetStateAction<GameState>>;
   buildStoryContextFromState: BuildStoryContextFromState;
@@ -74,7 +78,7 @@ export function useStoryRuntimeController(params: {
         requestNextStep: generateNextStep,
         onServerOptionCatalogLoadError: (error) => {
           console.warn(
-            '[useStoryGeneration] failed to load server runtime option catalog',
+            '[useRpgRuntimeStory] failed to load server runtime option catalog',
             error,
           );
         },
@@ -125,6 +129,9 @@ export function useStoryRuntimeController(params: {
   };
 }
 
-export type StoryRuntimeControllerResult = ReturnType<
-  typeof useStoryRuntimeController
+export type UseRpgRuntimeStoryControllerParams = Parameters<
+  typeof useRpgRuntimeStoryController
+>[0];
+export type RpgRuntimeStoryControllerResult = ReturnType<
+  typeof useRpgRuntimeStoryController
 >;
diff --git a/src/hooks/story/useStoryFlowCoordinator.ts b/src/hooks/rpg-runtime-story/useRpgRuntimeStoryFlow.ts
similarity index 85%
rename from src/hooks/story/useStoryFlowCoordinator.ts
rename to src/hooks/rpg-runtime-story/useRpgRuntimeStoryFlow.ts
index cbf6e0b8..e2ec64c6 100644
--- a/src/hooks/story/useStoryFlowCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/useRpgRuntimeStoryFlow.ts
@@ -1,4 +1,4 @@
-import type { Dispatch, SetStateAction } from 'react';
+import type { Dispatch, SetStateAction } from 'react';
 
 import type { Character, Encounter, GameState, StoryOption } from '../../types';
 import type { EscapePlaybackSync as ResolvedChoicePlaybackSync } from '../combat/escapeFlow';
@@ -7,11 +7,11 @@ import { createStoryInteractionCoordinatorConfig } from './storyInteractionCoord
 import { sanitizeStoryOptions } from './storyPresentation';
 import { useStoryGoalOptionCoordinator } from './useStoryGoalOptionCoordinator';
 import type { StoryRuntimeSupport } from './storyRuntimeSupport';
-import { useStoryGoalSessionCoordinator } from './useStoryGoalSessionCoordinator';
-import { useStoryInteractionCoordinator } from './useStoryInteractionCoordinator';
-import type { StoryRuntimeControllerResult } from './useStoryRuntimeController';
+import { useRpgRuntimeStoryState } from './useRpgRuntimeStoryState';
+import { useRpgRuntimeInteractionFlow } from './useRpgRuntimeInteractionFlow';
+import type { RpgRuntimeStoryControllerResult } from './useRpgRuntimeStoryController';
 
-type StoryFlowCoordinatorParams = {
+type RpgRuntimeStoryFlowParams = {
   gameState: GameState;
   setGameState: Dispatch<SetStateAction<GameState>>;
   buildResolvedChoiceState: (
@@ -32,7 +32,7 @@ type StoryFlowCoordinatorParams = {
   getResolvedSceneHostileNpcs: (
     state: GameState,
   ) => GameState['sceneHostileNpcs'];
-  runtimeController: StoryRuntimeControllerResult;
+  runtimeController: RpgRuntimeStoryControllerResult;
   runtimeSupport: StoryRuntimeSupport;
   sortOptions: (options: StoryOption[]) => StoryOption[];
   buildContinueAdventureOption: () => StoryOption;
@@ -54,7 +54,11 @@ type StoryFlowCoordinatorParams = {
   turnVisualMs: number;
 };
 
-export function useStoryFlowCoordinator({
+/**
+ * RPG runtime story 主编排层。
+ * 这里把 option 展示、正式交互分发和 story/session 状态动作收束成稳定出口。
+ */
+export function useRpgRuntimeStoryFlow({
   gameState,
   setGameState,
   buildResolvedChoiceState,
@@ -74,7 +78,7 @@ export function useStoryFlowCoordinator({
   npcPreviewTalkFunctionId,
   fallbackCompanionName,
   turnVisualMs,
-}: StoryFlowCoordinatorParams) {
+}: RpgRuntimeStoryFlowParams) {
   const {
     currentStory,
     setCurrentStory,
@@ -136,7 +140,7 @@ export function useStoryFlowCoordinator({
     handleNpcChatInput,
     exitNpcChat,
     npcChatQuestOfferUi,
-  } = useStoryInteractionCoordinator({
+  } = useRpgRuntimeInteractionFlow({
     gameState,
     isLoading,
     interactionConfig,
@@ -155,7 +159,7 @@ export function useStoryFlowCoordinator({
     turnVisualMs,
   });
   const { questUi, resetStoryState, hydrateStoryState, travelToSceneFromMap } =
-    useStoryGoalSessionCoordinator({
+    useRpgRuntimeStoryState({
       gameState,
       isLoading,
       setGameState,
@@ -188,3 +192,10 @@ export function useStoryFlowCoordinator({
     npcChatQuestOfferUi,
   };
 }
+
+export type UseRpgRuntimeStoryFlowParams = Parameters<
+  typeof useRpgRuntimeStoryFlow
+>[0];
+export type RpgRuntimeStoryFlowResult = ReturnType<
+  typeof useRpgRuntimeStoryFlow
+>;
diff --git a/src/hooks/story/useStoryGoalSessionCoordinator.test.ts b/src/hooks/rpg-runtime-story/useRpgRuntimeStoryState.test.ts
similarity index 74%
rename from src/hooks/story/useStoryGoalSessionCoordinator.test.ts
rename to src/hooks/rpg-runtime-story/useRpgRuntimeStoryState.test.ts
index 80a64ace..1e3c9b14 100644
--- a/src/hooks/story/useStoryGoalSessionCoordinator.test.ts
+++ b/src/hooks/rpg-runtime-story/useRpgRuntimeStoryState.test.ts
@@ -1,11 +1,11 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
-import { createClearStoryRuntimeUi } from './useStoryGoalSessionCoordinator';
+import { createRpgRuntimeStoryUiResetter } from './useRpgRuntimeStoryState';
 
-describe('useStoryGoalSessionCoordinator helpers', () => {
+describe('useRpgRuntimeStoryState helpers', () => {
   it('clears story runtime ui in the expected order', () => {
     const calls: string[] = [];
-    const clearStoryRuntimeUi = createClearStoryRuntimeUi({
+    const clearStoryRuntimeUi = createRpgRuntimeStoryUiResetter({
       clearStoryGoalOptionUi: vi.fn(() => calls.push('goal-option')),
       clearStoryInteractionUi: vi.fn(() => calls.push('interaction')),
       setAiError: vi.fn((value) => calls.push(`ai:${String(value)}`)),
diff --git a/src/hooks/story/useStoryGoalSessionCoordinator.ts b/src/hooks/rpg-runtime-story/useRpgRuntimeStoryState.ts
similarity index 84%
rename from src/hooks/story/useStoryGoalSessionCoordinator.ts
rename to src/hooks/rpg-runtime-story/useRpgRuntimeStoryState.ts
index ee13f478..900b400c 100644
--- a/src/hooks/story/useStoryGoalSessionCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/useRpgRuntimeStoryState.ts
@@ -1,4 +1,4 @@
-import { useCallback, type Dispatch, type SetStateAction } from 'react';
+import { useCallback, type Dispatch, type SetStateAction } from 'react';
 
 import type { StoryMoment, GameState, Character } from '../../types';
 import type { CommitGeneratedState } from '../generatedState';
@@ -28,7 +28,11 @@ export function createClearStoryRuntimeUi(params: {
   };
 }
 
-export function useStoryGoalSessionCoordinator(params: {
+/**
+ * RPG runtime story 状态层。
+ * 负责 story reset、hydration、地图跳转，以及 quest 领取/确认 UI 的收口。
+ */
+export function useRpgRuntimeStoryState(params: {
   gameState: GameState;
   isLoading: boolean;
   setGameState: Dispatch<SetStateAction<GameState>>;
@@ -89,6 +93,11 @@ export function useStoryGoalSessionCoordinator(params: {
   };
 }
 
-export type StoryGoalSessionCoordinatorResult = ReturnType<
-  typeof useStoryGoalSessionCoordinator
+export type UseRpgRuntimeStoryStateParams = Parameters<
+  typeof useRpgRuntimeStoryState
+>[0];
+export type RpgRuntimeStoryStateResult = ReturnType<
+  typeof useRpgRuntimeStoryState
 >;
+
+export const createRpgRuntimeStoryUiResetter = createClearStoryRuntimeUi;
diff --git a/src/hooks/story/useStoryChoiceCoordinator.test.ts b/src/hooks/rpg-runtime-story/useStoryChoiceCoordinator.test.ts
similarity index 88%
rename from src/hooks/story/useStoryChoiceCoordinator.test.ts
rename to src/hooks/rpg-runtime-story/useStoryChoiceCoordinator.test.ts
index 3bb6f49d..71a5c813 100644
--- a/src/hooks/story/useStoryChoiceCoordinator.test.ts
+++ b/src/hooks/rpg-runtime-story/useStoryChoiceCoordinator.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 import { createClearStoryChoiceUi } from './useStoryChoiceCoordinator';
 
diff --git a/src/hooks/story/useStoryChoiceCoordinator.ts b/src/hooks/rpg-runtime-story/useStoryChoiceCoordinator.ts
similarity index 98%
rename from src/hooks/story/useStoryChoiceCoordinator.ts
rename to src/hooks/rpg-runtime-story/useStoryChoiceCoordinator.ts
index 693ed3ce..8d72b590 100644
--- a/src/hooks/story/useStoryChoiceCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/useStoryChoiceCoordinator.ts
@@ -1,4 +1,4 @@
-import { useCallback, useState } from 'react';
+import { useCallback, useState } from 'react';
 
 import { createStoryChoiceActions } from './choiceActions';
 import {
diff --git a/src/hooks/story/useStoryGoalOptionCoordinator.test.ts b/src/hooks/rpg-runtime-story/useStoryGoalOptionCoordinator.test.ts
similarity index 90%
rename from src/hooks/story/useStoryGoalOptionCoordinator.test.ts
rename to src/hooks/rpg-runtime-story/useStoryGoalOptionCoordinator.test.ts
index 76b34553..ad7ac681 100644
--- a/src/hooks/story/useStoryGoalOptionCoordinator.test.ts
+++ b/src/hooks/rpg-runtime-story/useStoryGoalOptionCoordinator.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 import { createClearStoryGoalOptionUi } from './useStoryGoalOptionCoordinator';
 
diff --git a/src/hooks/story/useStoryGoalOptionCoordinator.ts b/src/hooks/rpg-runtime-story/useStoryGoalOptionCoordinator.ts
similarity index 96%
rename from src/hooks/story/useStoryGoalOptionCoordinator.ts
rename to src/hooks/rpg-runtime-story/useStoryGoalOptionCoordinator.ts
index d34eb331..6e2ae5b8 100644
--- a/src/hooks/story/useStoryGoalOptionCoordinator.ts
+++ b/src/hooks/rpg-runtime-story/useStoryGoalOptionCoordinator.ts
@@ -1,4 +1,4 @@
-import { useCallback } from 'react';
+import { useCallback } from 'react';
 
 import type { GameState, StoryMoment } from '../../types';
 import { useStoryOptions } from '../useStoryOptions';
diff --git a/src/hooks/rpg-session/index.ts b/src/hooks/rpg-session/index.ts
new file mode 100644
index 00000000..f64abe23
--- /dev/null
+++ b/src/hooks/rpg-session/index.ts
@@ -0,0 +1,12 @@
+export { type RpgSessionBootstrapResult, useRpgSessionBootstrap } from './useRpgSessionBootstrap';
+export type { BottomTab } from './rpgSessionTypes';
+export {
+  type RpgRuntimeSessionResult,
+  useRpgRuntimeSession,
+} from './useRpgRuntimeSession';
+export {
+  type RpgSessionPersistenceResult,
+  type UseRpgSessionPersistenceParams,
+  useRpgSessionPersistence,
+} from './useRpgSessionPersistence';
+export type { BottomTab as RpgBottomTab } from './rpgSessionTypes';
diff --git a/src/hooks/rpg-session/rpgSessionTypes.ts b/src/hooks/rpg-session/rpgSessionTypes.ts
new file mode 100644
index 00000000..4a4893a4
--- /dev/null
+++ b/src/hooks/rpg-session/rpgSessionTypes.ts
@@ -0,0 +1,3 @@
+import type { BottomTab } from '../../types/navigation';
+
+export type { BottomTab };
diff --git a/src/hooks/useGameShellRuntime.ts b/src/hooks/rpg-session/useRpgRuntimeSession.ts
similarity index 79%
rename from src/hooks/useGameShellRuntime.ts
rename to src/hooks/rpg-session/useRpgRuntimeSession.ts
index 74fbc4cb..72cba22f 100644
--- a/src/hooks/useGameShellRuntime.ts
+++ b/src/hooks/rpg-session/useRpgRuntimeSession.ts
@@ -1,19 +1,23 @@
 import { useEffect } from 'react';
 
-import { DEFAULT_MUSIC_VOLUME } from '../../packages/shared/src/contracts/runtime';
-import { useAuthUi } from '../components/auth/AuthUiContext';
-import type { GameShellProps } from '../components/game-shell/types';
-import { activateRosterCompanion, benchActiveCompanion } from '../data/companionRoster';
-import { syncGameStatePlayTime } from '../data/runtimeStats';
-import type { HydratedSavedGameSnapshot } from '../persistence/runtimeSnapshotTypes';
-import { useBackgroundMusic } from './useBackgroundMusic';
-import { useCombatFlow } from './useCombatFlow';
-import { useGameFlow } from './useGameFlow';
-import { useGamePersistence } from './useGamePersistence';
-import { useNpcInteractionFlow } from './useNpcInteractionFlow';
-import { useStoryGeneration } from './useStoryGeneration';
+import { DEFAULT_MUSIC_VOLUME } from '../../../packages/shared/src/contracts/runtime';
+import { useAuthUi } from '../../components/auth/AuthUiContext';
+import type { RpgRuntimeShellProps } from '../../components/rpg-runtime-shell';
+import { activateRosterCompanion, benchActiveCompanion } from '../../data/companionRoster';
+import { syncGameStatePlayTime } from '../../data/runtimeStats';
+import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
+import { useBackgroundMusic } from '../useBackgroundMusic';
+import { useCombatFlow } from '../useCombatFlow';
+import { useNpcInteractionFlow } from '../useNpcInteractionFlow';
+import { useRpgRuntimeStory } from '../rpg-runtime-story';
+import { useRpgSessionBootstrap } from './useRpgSessionBootstrap';
+import { useRpgSessionPersistence } from './useRpgSessionPersistence';
 
-export function useGameShellRuntime(): GameShellProps {
+/**
+ * RPG 主运行态装配器真实实现。
+ * 工作包 C 起主链改为组合 `rpg-session` 下的 bootstrap / persistence 新入口。
+ */
+export function useRpgRuntimeSession(): RpgRuntimeShellProps {
   const authUi = useAuthUi();
   const {
     gameState,
@@ -26,13 +30,13 @@ export function useGameShellRuntime(): GameShellProps {
     handleCustomWorldSelect: selectCustomWorld,
     handleBackToWorldSelect: backToWorldSelect,
     handleCharacterSelect: selectCharacter,
-  } = useGameFlow();
+  } = useRpgSessionBootstrap();
 
   const combatFlow = useCombatFlow({
     setGameState,
   });
 
-  const storyFlow = useStoryGeneration({
+  const storyFlow = useRpgRuntimeStory({
     gameState,
     setGameState,
     buildResolvedChoiceState: combatFlow.buildResolvedChoiceState,
@@ -41,7 +45,7 @@ export function useGameShellRuntime(): GameShellProps {
 
   const { companionRenderStates, buildCompanionRenderStates } =
     useNpcInteractionFlow(gameState);
-  const persistence = useGamePersistence({
+  const persistence = useRpgSessionPersistence({
     authenticatedUserId: authUi?.user?.id ?? null,
     gameState,
     bottomTab,
@@ -183,3 +187,5 @@ export function useGameShellRuntime(): GameShellProps {
     },
   };
 }
+
+export type RpgRuntimeSessionResult = ReturnType<typeof useRpgRuntimeSession>;
diff --git a/src/hooks/useGameFlow.ts b/src/hooks/rpg-session/useRpgSessionBootstrap.ts
similarity index 91%
rename from src/hooks/useGameFlow.ts
rename to src/hooks/rpg-session/useRpgSessionBootstrap.ts
index a6097199..48840f04 100644
--- a/src/hooks/useGameFlow.ts
+++ b/src/hooks/rpg-session/useRpgSessionBootstrap.ts
@@ -6,26 +6,26 @@ import {
   getCharacterMaxHp,
   getCharacterMaxMana,
   setRuntimeCharacterOverrides,
-} from '../data/characterPresets';
-import { setRuntimeCustomWorldProfile } from '../data/customWorldRuntime';
-import { getInitialPlayerCurrency } from '../data/economy';
+} from '../../data/characterPresets';
+import { setRuntimeCustomWorldProfile } from '../../data/customWorldRuntime';
+import { getInitialPlayerCurrency } from '../../data/economy';
 import {
   applyEquipmentLoadoutToState,
   buildInitialEquipmentLoadout,
   createEmptyEquipmentLoadout,
-} from '../data/equipmentEffects';
+} from '../../data/equipmentEffects';
 import {
   buildInitialNpcState,
   buildInitialPlayerInventory,
-} from '../data/npcInteractions';
-import { createInitialPlayerProgressionState } from '../data/playerProgression';
-import { createInitialGameRuntimeStats } from '../data/runtimeStats';
+} from '../../data/npcInteractions';
+import { createInitialPlayerProgressionState } from '../../data/playerProgression';
+import { createInitialGameRuntimeStats } from '../../data/runtimeStats';
 import {
   ensureSceneEncounterPreview,
   RESOLVED_ENTITY_X_METERS,
-} from '../data/sceneEncounterPreviews';
-import { getScenePreset, getWorldCampScenePreset } from '../data/scenePresets';
-import { createEmptyStoryEngineMemoryState } from '../services/storyEngine/visibilityEngine';
+} from '../../data/sceneEncounterPreviews';
+import { getScenePreset, getWorldCampScenePreset } from '../../data/scenePresets';
+import { createEmptyStoryEngineMemoryState } from '../../services/storyEngine/visibilityEngine';
 import {
   AnimationState,
   Character,
@@ -36,13 +36,11 @@ import {
   InventoryItem,
   SceneNpc,
   WorldType,
-} from '../types';
-import type { BottomTab } from '../types/navigation';
+} from '../../types';
+import type { BottomTab } from './rpgSessionTypes';
 
 const PLAYER_BASE_MAX_HP = 180;
 
-export type { BottomTab } from '../types/navigation';
-
 function mergeStarterInventoryItems<
   T extends { category: string; name: string },
 >(explicitItems: T[], fallbackItems: T[]) {
@@ -213,7 +211,11 @@ function createInitialGameState(): GameState {
   };
 }
 
-export function useGameFlow() {
+/**
+ * RPG session bootstrap 主实现。
+ * 工作包 C 起由新域 hook 承载世界选择、选角确认与新开局初始化。
+ */
+export function useRpgSessionBootstrap() {
   const [gameState, setGameState] = useState<GameState>(() =>
     createInitialGameState(),
   );
@@ -335,9 +337,9 @@ export function useGameFlow() {
             chapterState: null,
             campaignState: null,
             activeScenarioPackId:
-              gameState.customWorldProfile?.scenarioPackId ?? null,
+              prev.customWorldProfile?.scenarioPackId ?? null,
             activeCampaignPackId:
-              gameState.customWorldProfile?.campaignPackId ?? null,
+              prev.customWorldProfile?.campaignPackId ?? null,
             characterChats: {},
             currentEncounter: initialEncounter,
             npcInteractionActive: false,
@@ -408,3 +410,7 @@ export function useGameFlow() {
     handleCharacterSelect,
   };
 }
+
+export type RpgSessionBootstrapResult = ReturnType<
+  typeof useRpgSessionBootstrap
+>;
diff --git a/src/hooks/useGamePersistence.ts b/src/hooks/rpg-session/useRpgSessionPersistence.ts
similarity index 84%
rename from src/hooks/useGamePersistence.ts
rename to src/hooks/rpg-session/useRpgSessionPersistence.ts
index 12266eb4..3cf4d1b7 100644
--- a/src/hooks/useGamePersistence.ts
+++ b/src/hooks/rpg-session/useRpgSessionPersistence.ts
@@ -1,15 +1,11 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
 
-import type { HydratedSavedGameSnapshot } from '../persistence/runtimeSnapshotTypes';
-import { isAbortError } from '../services/apiClient';
-import {
-  deleteSaveSnapshot,
-  getSaveSnapshot,
-  putSaveSnapshot,
-} from '../services/storageService';
-import type { GameState, StoryMoment } from '../types';
-import { resumeServerRuntimeStory } from './story/runtimeStoryCoordinator';
-import type { BottomTab } from './useGameFlow';
+import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
+import { isAbortError } from '../../services/apiClient';
+import { rpgSnapshotClient } from '../../services/rpg-runtime';
+import type { GameState, StoryMoment } from '../../types';
+import { resumeServerRuntimeStory } from '../rpg-runtime-story/runtimeStoryCoordinator';
+import type { BottomTab } from './rpgSessionTypes';
 
 const AUTO_SAVE_DELAY_MS = 400;
 
@@ -38,17 +34,7 @@ function resolveRemoteSnapshotState(snapshot: HydratedSavedGameSnapshot) {
   };
 }
 
-export function useGamePersistence({
-  authenticatedUserId,
-  gameState,
-  bottomTab,
-  currentStory,
-  isLoading,
-  setGameState,
-  setBottomTab,
-  hydrateStoryState,
-  resetStoryState,
-}: {
+export type UseRpgSessionPersistenceParams = {
   authenticatedUserId: string | null;
   gameState: GameState;
   bottomTab: BottomTab;
@@ -58,7 +44,23 @@ export function useGamePersistence({
   setBottomTab: (tab: BottomTab) => void;
   hydrateStoryState: (story: StoryMoment | null) => void;
   resetStoryState: () => void;
-}) {
+};
+
+/**
+ * RPG session persistence 主实现。
+ * 工作包 C 起由新域 hook 负责自动存档、继续游戏恢复与运行态 story 恢复刷新。
+ */
+export function useRpgSessionPersistence({
+  authenticatedUserId,
+  gameState,
+  bottomTab,
+  currentStory,
+  isLoading,
+  setGameState,
+  setBottomTab,
+  hydrateStoryState,
+  resetStoryState,
+}: UseRpgSessionPersistenceParams) {
   const [hasSavedGame, setHasSavedGame] = useState(false);
   const [savedSnapshot, setSavedSnapshot] =
     useState<HydratedSavedGameSnapshot | null>(null);
@@ -98,7 +100,7 @@ export function useGamePersistence({
       setPersistenceError(null);
 
       try {
-        const snapshot = await putSaveSnapshot(
+        const snapshot = await rpgSnapshotClient.putSnapshot(
           {
             gameState: params.payload.gameState,
             bottomTab: params.payload.bottomTab,
@@ -124,7 +126,7 @@ export function useGamePersistence({
         if (saveRequestIdRef.current === requestId) {
           setPersistenceError(message);
         }
-        console.warn(`[useGamePersistence] ${params.logLabel}`, error);
+        console.warn(`[useRpgSessionPersistence] ${params.logLabel}`, error);
         return null;
       } finally {
         if (saveControllerRef.current === controller) {
@@ -153,7 +155,8 @@ export function useGamePersistence({
     hydrateControllerRef.current = controller;
     setIsHydratingSnapshot(true);
 
-    void getSaveSnapshot({ signal: controller.signal })
+    void rpgSnapshotClient
+      .getSnapshot({ signal: controller.signal })
       .then((snapshot) => {
         setSavedSnapshot(snapshot);
         setHasSavedGame(Boolean(snapshot));
@@ -167,7 +170,7 @@ export function useGamePersistence({
           error instanceof Error ? error.message : '读取远端存档失败';
         setPersistenceError(message);
         console.warn(
-          '[useGamePersistence] failed to load remote snapshot',
+          '[useRpgSessionPersistence] failed to load remote snapshot',
           error,
         );
       })
@@ -254,11 +257,11 @@ export function useGamePersistence({
     }
 
     try {
-      await deleteSaveSnapshot();
+      await rpgSnapshotClient.deleteSnapshot();
       setPersistenceError(null);
     } catch (error) {
       console.warn(
-        '[useGamePersistence] failed to delete remote snapshot',
+        '[useRpgSessionPersistence] failed to delete remote snapshot',
         error,
       );
     }
@@ -276,10 +279,10 @@ export function useGamePersistence({
       const snapshot =
         snapshotOverride ??
         savedSnapshot ??
-        (await getSaveSnapshot().catch((error) => {
+        (await rpgSnapshotClient.getSnapshot().catch((error) => {
           if (!isAbortError(error)) {
             console.warn(
-              '[useGamePersistence] failed to refetch remote snapshot',
+              '[useRpgSessionPersistence] failed to refetch remote snapshot',
               error,
             );
           }
@@ -298,7 +301,7 @@ export function useGamePersistence({
         (error) => {
           if (!isAbortError(error)) {
             console.warn(
-              '[useGamePersistence] failed to refresh runtime story state from server',
+              '[useRpgSessionPersistence] failed to refresh runtime story state from server',
               error,
             );
           }
@@ -339,3 +342,7 @@ export function useGamePersistence({
     clearSavedGame,
   };
 }
+
+export type RpgSessionPersistenceResult = ReturnType<
+  typeof useRpgSessionPersistence
+>;
diff --git a/src/hooks/runtimeAuthGuards.test.tsx b/src/hooks/runtimeAuthGuards.test.tsx
index d27e0074..42100d03 100644
--- a/src/hooks/runtimeAuthGuards.test.tsx
+++ b/src/hooks/runtimeAuthGuards.test.tsx
@@ -6,7 +6,7 @@ import { beforeEach, expect, test, vi } from 'vitest';
 import { readSavedSettings } from '../persistence/gameSettingsStorage';
 import type { GameState, StoryMoment } from '../types';
 import type { BottomTab } from '../types/navigation';
-import { useGamePersistence } from './useGamePersistence';
+import { useRpgSessionPersistence } from './rpg-session';
 import { useGameSettings } from './useGameSettings';
 
 const storageMocks = vi.hoisted(() => ({
@@ -17,16 +17,17 @@ const storageMocks = vi.hoisted(() => ({
   deleteSaveSnapshot: vi.fn(),
 }));
 
-vi.mock('../services/storageService', () => ({
-  getSettings: storageMocks.getSettings,
-  putSettings: storageMocks.putSettings,
-  getSaveSnapshot: storageMocks.getSaveSnapshot,
-  putSaveSnapshot: storageMocks.putSaveSnapshot,
-  deleteSaveSnapshot: storageMocks.deleteSaveSnapshot,
+vi.mock('../services/rpg-entry', () => ({
+  getRpgProfileSettings: storageMocks.getSettings,
+  putRpgProfileSettings: storageMocks.putSettings,
 }));
 
-vi.mock('./story/runtimeStoryCoordinator', () => ({
-  resumeServerRuntimeStory: vi.fn(),
+vi.mock('../services/rpg-runtime', () => ({
+  rpgSnapshotClient: {
+    getSnapshot: storageMocks.getSaveSnapshot,
+    putSnapshot: storageMocks.putSaveSnapshot,
+    deleteSnapshot: storageMocks.deleteSaveSnapshot,
+  },
 }));
 
 function SettingsHarness({ authenticatedUserId }: { authenticatedUserId: string | null }) {
@@ -52,7 +53,7 @@ function PersistenceHarness({
 }: {
   authenticatedUserId: string | null;
 }) {
-  const persistence = useGamePersistence({
+  const persistence = useRpgSessionPersistence({
     authenticatedUserId,
     gameState: {} as GameState,
     bottomTab: 'adventure' as BottomTab,
diff --git a/src/hooks/useGameFlow.customWorld.test.tsx b/src/hooks/useGameFlow.customWorld.test.tsx
index 20fc9c28..494bcd19 100644
--- a/src/hooks/useGameFlow.customWorld.test.tsx
+++ b/src/hooks/useGameFlow.customWorld.test.tsx
@@ -12,7 +12,7 @@ import {
 import { setRuntimeCustomWorldProfile } from '../data/customWorldRuntime';
 import { normalizeCustomWorldProfileRecord } from '../data/customWorldLibrary';
 import { WorldType } from '../types';
-import { useGameFlow } from './useGameFlow';
+import { useRpgSessionBootstrap } from './rpg-session';
 
 function buildBackstoryReveal(label: string) {
   return {
@@ -298,7 +298,7 @@ function GameFlowHarness() {
   );
   const selectedCharacter = playableCharacters[0] ?? null;
   const { gameState, handleCustomWorldSelect, handleCharacterSelect } =
-    useGameFlow();
+    useRpgSessionBootstrap();
 
   const snapshot = {
     worldType: gameState.worldType,
diff --git a/src/hooks/useGameSettings.ts b/src/hooks/useGameSettings.ts
index ed8bf5f5..db8c7e48 100644
--- a/src/hooks/useGameSettings.ts
+++ b/src/hooks/useGameSettings.ts
@@ -8,7 +8,10 @@ import {
   writeSavedSettings,
 } from '../persistence/gameSettingsStorage';
 import { isAbortError } from '../services/apiClient';
-import { getSettings, putSettings } from '../services/storageService';
+import {
+  getRpgProfileSettings,
+  putRpgProfileSettings,
+} from '../services/rpg-entry';
 
 const SETTINGS_SYNC_DELAY_MS = 180;
 
@@ -65,7 +68,7 @@ export function useGameSettings(authenticatedUserId: string | null = null) {
     setHasHydratedSettings(false);
     setIsHydratingSettings(true);
 
-    void getSettings({ signal: controller.signal })
+    void getRpgProfileSettings({ signal: controller.signal })
       .then((settings) => {
         const nextVolume = clampVolume(settings.musicVolume);
         const nextPlatformTheme = normalizePlatformTheme(settings.platformTheme);
@@ -130,7 +133,7 @@ export function useGameSettings(authenticatedUserId: string | null = null) {
       setIsPersistingSettings(true);
       setSettingsError(null);
 
-      void putSettings(
+      void putRpgProfileSettings(
         {
           musicVolume,
           platformTheme,
diff --git a/src/hooks/useTreasureFlow.ts b/src/hooks/useTreasureFlow.ts
index 8e2a635a..0d8036c5 100644
--- a/src/hooks/useTreasureFlow.ts
+++ b/src/hooks/useTreasureFlow.ts
@@ -1,6 +1,6 @@
 import { useCallback } from 'react';
 
-import { resolveServerRuntimeChoice } from './story/runtimeStoryCoordinator';
+import { resolveRpgRuntimeChoice } from './rpg-runtime-story';
 import { Character, GameState, StoryMoment, StoryOption } from '../types';
 
 export function useTreasureFlow({
@@ -36,7 +36,7 @@ export function useTreasureFlow({
 
       try {
         const { hydratedSnapshot, nextStory } =
-          await resolveServerRuntimeChoice({
+          await resolveRpgRuntimeChoice({
             gameState,
             currentStory: runtime.currentStory,
             option,
diff --git a/src/services/aiService.ts b/src/services/aiService.ts
index ba6cc75e..ff74d927 100644
--- a/src/services/aiService.ts
+++ b/src/services/aiService.ts
@@ -1,14 +1,3 @@
-import type {
-  CreateCustomWorldAgentSessionRequest,
-  CreateCustomWorldAgentSessionResponse,
-  CustomWorldAgentActionRequest,
-  CustomWorldAgentOperationRecord,
-  CustomWorldAgentSessionSnapshot,
-  CustomWorldDraftCardDetail,
-  GetCustomWorldAgentCardDetailResponse,
-  ListCustomWorldWorksResponse,
-  SendCustomWorldAgentMessageRequest,
-} from '../../packages/shared/src/contracts/customWorldAgent';
 import type {
   CustomWorldGenerationProgress,
   GenerateCustomWorldProfileInput,
@@ -18,22 +7,18 @@ import type {
   CharacterChatReplyRequest,
   CharacterChatSuggestionsRequest,
   CharacterChatSummaryRequest,
-  NpcChatDialogueRequest,
   NpcChatTurnDirective,
+  NpcChatDialogueRequest,
   NpcChatTurnRequest,
   NpcChatTurnResult,
   NpcRecruitDialogueRequest,
   PlainTextResponse,
-} from '../../packages/shared/src/contracts/story';
+} from '../../packages/shared/src/contracts/rpgRuntimeChat';
 import { parseApiErrorMessage } from '../../packages/shared/src/http';
 import type {
   AIResponse,
   Character,
   CharacterChatTurn,
-  CustomWorldLandmark,
-  CustomWorldNpc,
-  CustomWorldPlayableNpc,
-  CustomWorldProfile,
   Encounter,
   GameState,
   SceneHostileNpc,
@@ -41,18 +26,16 @@ import type {
   WorldType,
 } from '../types';
 import type {
-  CustomWorldSceneImageRequest,
-  CustomWorldSceneImageResult,
   StoryGenerationContext,
   StoryRequestOptions,
   TextStreamOptions,
+  CustomWorldSceneImageResult,
 } from './aiTypes';
 import { fetchWithApiAuth, requestJson } from './apiClient';
 import { type CharacterChatTargetStatus } from './characterChatPrompt';
 import { parseLineListContent } from './llmParsers';
 
 const RUNTIME_API_BASE = '/api/runtime';
-const CUSTOM_WORLD_API_BASE = '/api';
 
 type LegacyAiModule = typeof import('./ai');
 
@@ -66,12 +49,12 @@ async function loadLegacyAiModule() {
   return legacyAiModulePromise;
 }
 
-async function requestPostJson<T>(
+async function requestPlainText(
   url: string,
   payload: unknown,
   fallbackMessage: string,
 ) {
-  return requestJson<T>(
+  return requestJson<PlainTextResponse>(
     url,
     {
       method: 'POST',
@@ -82,14 +65,6 @@ async function requestPostJson<T>(
   );
 }
 
-async function requestPlainText(
-  url: string,
-  payload: unknown,
-  fallbackMessage: string,
-) {
-  return requestPostJson<PlainTextResponse>(url, payload, fallbackMessage);
-}
-
 async function requestPlainTextStream(
   url: string,
   payload: unknown,
@@ -349,326 +324,6 @@ export async function generateCharacterPanelChatSummary(
   return text.trim();
 }
 
-export async function generateCustomWorldProfile(
-  input: GenerateCustomWorldProfileInput | string,
-  options: GenerateCustomWorldProfileOptions = {},
-): Promise<CustomWorldProfile> {
-  const normalizedInput =
-    typeof input === 'string'
-      ? {
-          settingText: input,
-        }
-      : input;
-
-  if (typeof window === 'undefined') {
-    const aiClient = await loadLegacyAiModule();
-    return aiClient.generateCustomWorldProfile(normalizedInput, options);
-  }
-
-  if (options.signal?.aborted) {
-    throw options.signal.reason instanceof Error
-      ? options.signal.reason
-      : new Error('世界生成已中断。');
-  }
-
-  const profile = await requestPostJson<CustomWorldProfile>(
-    `${RUNTIME_API_BASE}/custom-world/profile`,
-    normalizedInput,
-    '生成自定义世界失败',
-  );
-
-  if (options.signal?.aborted) {
-    throw options.signal.reason instanceof Error
-      ? options.signal.reason
-      : new Error('世界生成已中断。');
-  }
-
-  return profile;
-}
-
-export async function generateCustomWorldSceneImage(
-  payload: CustomWorldSceneImageRequest,
-) {
-  return requestJson<CustomWorldSceneImageResult>(
-    `${CUSTOM_WORLD_API_BASE}/custom-world/scene-image`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    },
-    '生成自定义世界场景图失败',
-  );
-}
-
-export async function generateCustomWorldSceneNpc(payload: {
-  profile: CustomWorldProfile;
-  landmarkId: string;
-}) {
-  const response = await requestPostJson<{ npc: CustomWorldNpc }>(
-    `${CUSTOM_WORLD_API_BASE}/custom-world/scene-npc`,
-    payload,
-    '生成场景 NPC 失败',
-  );
-
-  return response.npc;
-}
-
-async function requestCustomWorldEntity<T>(
-  payload: {
-    profile: CustomWorldProfile;
-    kind: 'playable' | 'story' | 'landmark';
-  },
-  fallbackMessage: string,
-) {
-  return requestPostJson<{
-    kind: 'playable' | 'story' | 'landmark';
-    entity: T;
-  }>(`${CUSTOM_WORLD_API_BASE}/custom-world/entity`, payload, fallbackMessage);
-}
-
-export async function generateCustomWorldPlayableNpc(payload: {
-  profile: CustomWorldProfile;
-}) {
-  const response = await requestCustomWorldEntity<CustomWorldPlayableNpc>(
-    {
-      ...payload,
-      kind: 'playable',
-    },
-    '生成可扮演角色失败',
-  );
-
-  return response.entity;
-}
-
-export async function generateCustomWorldStoryNpc(payload: {
-  profile: CustomWorldProfile;
-}) {
-  const response = await requestCustomWorldEntity<CustomWorldNpc>(
-    {
-      ...payload,
-      kind: 'story',
-    },
-    '生成场景角色失败',
-  );
-
-  return response.entity;
-}
-
-export async function generateCustomWorldLandmark(payload: {
-  profile: CustomWorldProfile;
-}) {
-  const response = await requestCustomWorldEntity<CustomWorldLandmark>(
-    {
-      ...payload,
-      kind: 'landmark',
-    },
-    '生成场景失败',
-  );
-
-  return response.entity;
-}
-
-export async function listCustomWorldWorks() {
-  const response = await requestJson<ListCustomWorldWorksResponse>(
-    `${RUNTIME_API_BASE}/custom-world/works`,
-    {
-      method: 'GET',
-    },
-    '读取创作作品列表失败',
-  );
-
-  return Array.isArray(response?.items) ? response.items : [];
-}
-
-export async function createCustomWorldAgentSession(
-  payload: CreateCustomWorldAgentSessionRequest,
-) {
-  return requestJson<CreateCustomWorldAgentSessionResponse>(
-    `${RUNTIME_API_BASE}/custom-world/agent/sessions`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    },
-    '创建世界共创会话失败',
-  );
-}
-
-export async function getCustomWorldAgentSession(sessionId: string) {
-  return requestJson<CustomWorldAgentSessionSnapshot>(
-    `${RUNTIME_API_BASE}/custom-world/agent/sessions/${encodeURIComponent(sessionId)}`,
-    {
-      method: 'GET',
-    },
-    '读取世界共创会话失败',
-  );
-}
-
-export async function sendCustomWorldAgentMessage(
-  sessionId: string,
-  payload: SendCustomWorldAgentMessageRequest,
-) {
-  return requestJson<{ operation: CustomWorldAgentOperationRecord }>(
-    `${RUNTIME_API_BASE}/custom-world/agent/sessions/${encodeURIComponent(sessionId)}/messages`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    },
-    '发送共创消息失败',
-  );
-}
-
-export async function streamCustomWorldAgentMessage(
-  sessionId: string,
-  payload: SendCustomWorldAgentMessageRequest,
-  options: TextStreamOptions = {},
-) {
-  const response = await fetchWithApiAuth(
-    `${RUNTIME_API_BASE}/custom-world/agent/sessions/${encodeURIComponent(sessionId)}/messages/stream`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    },
-  );
-
-  if (!response.ok) {
-    const responseText = await response.text();
-    throw new Error(parseApiErrorMessage(responseText, '发送共创消息失败'));
-  }
-
-  if (!response.body) {
-    throw new Error('streaming response body is unavailable');
-  }
-
-  const reader = response.body.getReader();
-  const decoder = new TextDecoder('utf-8');
-  let buffer = '';
-  let finalSession: CustomWorldAgentSessionSnapshot | null = null;
-
-  for (;;) {
-    const { done, value } = await reader.read();
-    if (done) {
-      break;
-    }
-
-    buffer += decoder.decode(value, { stream: true });
-
-    while (buffer.includes('\n\n')) {
-      const boundary = buffer.indexOf('\n\n');
-      const eventBlock = buffer.slice(0, boundary);
-      buffer = buffer.slice(boundary + 2);
-
-      let eventName = 'message';
-      const dataLines: string[] = [];
-
-      for (const rawLine of eventBlock.split(/\r?\n/u)) {
-        const line = rawLine.trim();
-        if (line.startsWith('event:')) {
-          eventName = line.slice(6).trim() || 'message';
-          continue;
-        }
-        if (line.startsWith('data:')) {
-          dataLines.push(line.slice(5).trim());
-        }
-      }
-
-      if (dataLines.length === 0) {
-        continue;
-      }
-
-      const data = dataLines.join('\n');
-      let parsed: Record<string, unknown> | null = null;
-
-      try {
-        parsed = JSON.parse(data) as Record<string, unknown>;
-      } catch {
-        parsed = null;
-      }
-
-      if (eventName === 'reply_delta' && parsed) {
-        const text = parsed.text;
-        if (typeof text === 'string') {
-          options.onUpdate?.(text);
-        }
-        continue;
-      }
-
-      if (eventName === 'session' && parsed?.session) {
-        finalSession = parsed.session as CustomWorldAgentSessionSnapshot;
-        continue;
-      }
-
-      if (eventName === 'error' && parsed) {
-        const message =
-          typeof parsed.message === 'string' && parsed.message.trim()
-            ? parsed.message.trim()
-            : '发送共创消息失败';
-        throw new Error(message);
-      }
-    }
-  }
-
-  if (!finalSession) {
-    throw new Error('共创消息流式结果不完整');
-  }
-
-  return finalSession;
-}
-
-export async function executeCustomWorldAgentAction(
-  sessionId: string,
-  payload: CustomWorldAgentActionRequest,
-) {
-  return requestJson<{ operation: CustomWorldAgentOperationRecord }>(
-    `${RUNTIME_API_BASE}/custom-world/agent/sessions/${encodeURIComponent(sessionId)}/actions`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    },
-    '执行共创操作失败',
-  );
-}
-
-export async function getCustomWorldAgentOperation(
-  sessionId: string,
-  operationId: string,
-): Promise<CustomWorldAgentOperationRecord> {
-  const response = await requestJson<
-    {
-      operation?: CustomWorldAgentOperationRecord;
-      data?: CustomWorldAgentOperationRecord;
-    } & Partial<CustomWorldAgentOperationRecord>
-  >(
-    `${RUNTIME_API_BASE}/custom-world/agent/sessions/${encodeURIComponent(sessionId)}/operations/${encodeURIComponent(operationId)}`,
-    {
-      method: 'GET',
-    },
-    '读取共创操作状态失败',
-  );
-
-  return (response.operation ??
-    response.data ??
-    response) as CustomWorldAgentOperationRecord;
-}
-
-export async function getCustomWorldAgentCardDetail(
-  sessionId: string,
-  cardId: string,
-) {
-  const response = await requestJson<GetCustomWorldAgentCardDetailResponse>(
-    `${RUNTIME_API_BASE}/custom-world/agent/sessions/${encodeURIComponent(sessionId)}/cards/${encodeURIComponent(cardId)}`,
-    {
-      method: 'GET',
-    },
-    '读取草稿卡详情失败',
-  );
-
-  return response.card as CustomWorldDraftCardDetail;
-}
-
 export async function streamCharacterPanelChatReply(
   world: WorldType,
   playerCharacter: Character,
diff --git a/src/services/customWorldAgentDraftResult.test.ts b/src/services/customWorldAgentDraftResult.test.ts
deleted file mode 100644
index 4d6c8ddf..00000000
--- a/src/services/customWorldAgentDraftResult.test.ts
+++ /dev/null
@@ -1,861 +0,0 @@
-import { afterEach, expect, test } from 'vitest';
-
-import type { CustomWorldAgentSessionSnapshot } from '../../packages/shared/src/contracts/customWorldAgent';
-import { buildCustomWorldRuntimeCharacters } from '../data/characterPresets';
-import { setRuntimeCustomWorldProfile } from '../data/customWorldRuntime';
-import { getScenePresetsByWorld } from '../data/scenePresets';
-import { WorldType } from '../types';
-import { buildCustomWorldProfileFromAgentDraft } from './customWorldAgentDraftResult';
-
-afterEach(() => {
-  setRuntimeCustomWorldProfile(null);
-});
-
-const session: CustomWorldAgentSessionSnapshot = {
-  sessionId: 'session-1',
-  currentTurn: 6,
-  anchorContent: {
-    worldPromise: {
-      hook: '被海雾吞没的旧航路群岛',
-      differentiator: '灯塔与禁航令共同决定谁能活着穿过去。',
-      desiredExperience: '压抑、悬疑、潮湿',
-    },
-    playerFantasy: {
-      playerRole: '玩家回到群岛调查沉船真相。',
-      corePursuit: '找出失控航路背后的真相。',
-      fearOfLoss: '失去最后一个还能对上旧案的人。',
-    },
-    themeBoundary: null,
-    playerEntryPoint: null,
-    coreConflict: null,
-    keyRelationships: [],
-    hiddenLines: null,
-    iconicElements: {
-      iconicMotifs: ['会移动的海雾'],
-      institutionsOrArtifacts: ['旧灯塔'],
-      hardRules: [],
-    },
-  },
-  progressPercent: 100,
-  lastAssistantReply: '八锚点已经齐备，可以进入游戏设定草稿生成。',
-  stage: 'object_refining',
-  focusCardId: null,
-  creatorIntent: {
-    sourceMode: 'card',
-    worldHook: '被海雾吞没的旧航路群岛',
-    playerPremise: '玩家回到群岛调查沉船真相。',
-    themeKeywords: ['海雾', '旧航路'],
-    toneDirectives: ['压抑', '悬疑'],
-    openingSituation: '首夜就有陌生船只闯入禁航区。',
-    coreConflicts: ['航运公会与守灯会争夺航路控制权'],
-    keyFactions: [],
-    keyCharacters: [],
-    keyLandmarks: [],
-    iconicElements: ['会移动的海雾'],
-    forbiddenDirectives: [],
-    rawSettingText: '',
-  },
-  creatorIntentReadiness: {
-    isReady: true,
-    completedKeys: [],
-    missingKeys: [],
-  },
-  anchorPack: {},
-  lockState: {},
-  draftProfile: {
-    name: '潮雾列岛',
-    subtitle: '旧灯塔与失控航路',
-    summary: '第一版世界底稿已经整理完成。',
-    tone: '压抑、潮湿、悬疑',
-    playerGoal: '查清沉船与禁航区异动的真相。',
-    majorFactions: ['守灯会', '航运公会'],
-    coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
-    playableNpcs: [
-      {
-        id: 'playable-1',
-        name: '沈砺',
-        title: '旧航路引路人',
-        role: '关键同行者',
-        publicIdentity: '最熟悉旧航路的人。',
-        publicMask: '看上去像可靠旧友。',
-        currentPressure: '他必须在两股势力间站队。',
-        hiddenHook: '暗中替沉船商盟引路。',
-        relationToPlayer: '旧友兼潜在背叛者',
-        threadIds: ['thread-1'],
-        summary: '他像旧友，但也像一把始终没收回鞘的刀。',
-      },
-    ],
-    storyNpcs: [
-      {
-        id: 'story-1',
-        name: '顾潮音',
-        title: '守灯会值夜人',
-        role: '场景关键角色',
-        publicIdentity: '负责夜间巡灯与封锁。',
-        publicMask: '对外一直冷静克制。',
-        currentPressure: '她知道更多禁航区真相。',
-        hiddenHook: '曾亲眼见过失控海雾吞船。',
-        relationToPlayer: '最早愿意交换线索的人',
-        threadIds: ['thread-1'],
-        summary: '她总像比所有人更早知道海雾会往哪一侧压下来。',
-      },
-    ],
-    landmarks: [
-      {
-        id: 'landmark-1',
-        name: '回潮旧灯塔',
-        purpose: '观察雾潮与往来船只',
-        mood: '潮湿、压抑、风声不止',
-        importance: '开局核心场景',
-        characterIds: ['story-1'],
-        threadIds: ['thread-1'],
-        summary: '旧灯塔是整片群岛最先看见异动的地方。',
-      },
-    ],
-    factions: [],
-    threads: [],
-    chapters: [],
-    worldHook: '被海雾吞没的旧航路群岛',
-    playerPremise: '玩家回到群岛调查沉船真相。',
-    openingSituation: '首夜就有陌生船只闯入禁航区。',
-    iconicElements: ['会移动的海雾'],
-    sourceAnchorSummary: '海雾、旧灯塔、失控航路。',
-  },
-  messages: [],
-  draftCards: [],
-  pendingClarifications: [],
-  suggestedActions: [],
-  recommendedReplies: [],
-  qualityFindings: [],
-  assetCoverage: {
-    roleAssets: [],
-    sceneAssets: [],
-    allRoleAssetsReady: false,
-    allSceneAssetsReady: false,
-  },
-  updatedAt: '2026-04-15T10:00:00.000Z',
-};
-
-function buildBackstoryReveal(label: string) {
-  return {
-    publicSummary: `${label}的公开背景`,
-    privateChatUnlockAffinity: 40,
-    chapters: [
-      {
-        id: `${label}-surface`,
-        title: '表层来意',
-        affinityRequired: 15,
-        teaser: `${label}先只肯说表面的来意。`,
-        content: `${label}表面上只愿意谈当前局势。`,
-        contextSnippet: `${label}表面上还在收着话。`,
-      },
-      {
-        id: `${label}-scar`,
-        title: '旧事裂痕',
-        affinityRequired: 30,
-        teaser: `${label}背后还有一段旧伤。`,
-        content: `${label}曾在旧案里留下无法轻易揭开的伤口。`,
-        contextSnippet: `${label}和旧案之间有一段没说开的裂痕。`,
-      },
-      {
-        id: `${label}-hidden`,
-        title: '隐藏执念',
-        affinityRequired: 60,
-        teaser: `${label}真正想追的不是表面那件事。`,
-        content: `${label}真正挂着的是旧案里还没结的那条线。`,
-        contextSnippet: `${label}真正执念指向旧案深处。`,
-      },
-      {
-        id: `${label}-final`,
-        title: '最终底牌',
-        affinityRequired: 90,
-        teaser: `${label}手里还压着最后一张牌。`,
-        content: `${label}手里还握着能直接证明真相的关键证据。`,
-        contextSnippet: `${label}最后的底牌足以改写局势。`,
-      },
-    ],
-  };
-}
-
-function buildLegacyResultProfile() {
-  return {
-    id: 'legacy-profile-1',
-    settingText: '被海雾吞没的旧航路群岛',
-    name: '旧版完整结果',
-    subtitle: '直接展示',
-    summary: '优先使用服务端编译好的旧版 profile。',
-    tone: '压抑',
-    playerGoal: '查明真相',
-    templateWorldType: WorldType.WUXIA,
-    compatibilityTemplateWorldType: WorldType.WUXIA,
-    majorFactions: ['守灯会', '航运公会'],
-    coreConflicts: ['争夺航路控制权', '沉船真相'],
-    attributeSchema: {
-      id: 'schema:test',
-      worldId: 'CUSTOM',
-      schemaVersion: 1,
-      schemaName: '测试',
-      generatedFrom: {
-        worldType: WorldType.CUSTOM,
-        worldName: '旧版完整结果',
-        settingSummary: '测试',
-        tone: '测试',
-        conflictCore: '测试',
-      },
-      slots: [],
-    },
-    playableNpcs: [
-      {
-        id: 'playable-1',
-        name: '沈砺',
-        title: '旧航路引路人',
-        role: '关键同行者',
-        description: '最熟悉旧航路的人。',
-        backstory: '曾在沉船夜里带着半支船队逃出海雾。',
-        personality: '表面沉稳，心里一直在算退路。',
-        motivation: '想赶在守灯会封航前查清真相。',
-        combatStyle: '借地形和潮路换位，先拉扯再压近。',
-        initialAffinity: 18,
-        relationshipHooks: ['旧友', '沉船旧案'],
-        tags: ['潮路', '引路'],
-        backstoryReveal: buildBackstoryReveal('沈砺'),
-        skills: [
-          {
-            id: 'skill-playable-1',
-            name: '潮行引路',
-            summary: '踩着旧潮阶切线前压，替队伍打开角度。',
-            style: '机动周旋',
-          },
-          {
-            id: 'skill-playable-2',
-            name: '回雾折返',
-            summary: '借海雾遮住身位，再从侧线拉开。',
-            style: '起手压制',
-          },
-          {
-            id: 'skill-playable-3',
-            name: '旧图定标',
-            summary: '用旧潮图锁定退路和突入口。',
-            style: '爆发终结',
-          },
-        ],
-        initialItems: [
-          {
-            id: 'item-playable-1',
-            name: '旧潮短刃',
-            category: '武器',
-            quantity: 1,
-            rarity: 'rare',
-            description: '专门在湿滑甲板上近身换位用的短刃。',
-            tags: ['潮路', '近战'],
-          },
-          {
-            id: 'item-playable-2',
-            name: '雾盐药包',
-            category: '消耗品',
-            quantity: 2,
-            rarity: 'uncommon',
-            description: '压住寒潮后遗症的随身药包。',
-            tags: ['补给'],
-          },
-          {
-            id: 'item-playable-3',
-            name: '旧潮图残页',
-            category: '专属物品',
-            quantity: 1,
-            rarity: 'rare',
-            description: '只剩半页，但足够指向沉船夜的另一条线。',
-            tags: ['线索', '真相'],
-          },
-        ],
-        attributeProfile: {
-          schemaId: 'schema:test',
-          values: { axis_a: 48, axis_b: 72, axis_c: 78 },
-          topTraits: ['浪步', '舟识'],
-          evidence: [
-            {
-              slotId: 'axis_b',
-              reason: '长期依赖潮路换位与切线。',
-            },
-          ],
-        },
-        narrativeProfile: {
-          publicMask: '像个只想把旧路再走通一次的熟路人。',
-          firstContactMask: '先别问太深，至少今晚这条路我还认得。',
-          visibleLine: '他明面上只想护着队伍别再走错一次潮线。',
-          hiddenLine: '真正让他回来的是沉船夜里被人卖掉的那条航线。',
-          contradiction: '嘴上说只想带路，实际每一步都在找能对上旧案的证据。',
-          debtOrBurden: '背着半支船队没能活着回来的旧债。',
-          taboo: '最忌讳别人轻描淡写地提起那晚的失踪名单。',
-          immediatePressure: '守灯会封航在即，他必须赶在封口前找到证据。',
-          relatedThreadIds: ['thread-visible-1'],
-          relatedScarIds: ['scar-1'],
-          reactionHooks: ['沉船夜', '封航记录'],
-        },
-        templateCharacterId: 'archer-hero',
-      },
-    ],
-    storyNpcs: [
-      {
-        id: 'story-1',
-        name: '顾潮音',
-        title: '守灯会值夜人',
-        role: '场景关键角色',
-        description: '夜里巡灯与封锁禁航区的人。',
-        backstory: '在失控海雾第一次吞船那夜，她是最后一个还留在灯塔顶的人。',
-        personality: '冷静克制，但提到旧灯册时会显得过分警觉。',
-        motivation: '想守住灯塔记录，也想找到谁先改动了禁航信号。',
-        combatStyle: '借塔顶视角和风向压制，再用灯火错位扰乱。',
-        initialAffinity: 8,
-        relationshipHooks: ['禁航记录', '灯塔值夜'],
-        tags: ['守灯会', '灯塔'],
-        backstoryReveal: buildBackstoryReveal('顾潮音'),
-        skills: [
-          {
-            id: 'skill-story-1',
-            name: '夜潮灯语',
-            summary: '借灯语与潮声干扰对方判断。',
-            style: '起手压制',
-          },
-          {
-            id: 'skill-story-2',
-            name: '禁航暗潮',
-            summary: '封住错误航线，把人逼回她熟悉的区域。',
-            style: '机动周旋',
-          },
-          {
-            id: 'skill-story-3',
-            name: '回声巡线',
-            summary: '借塔顶回声迅速锁定异动方向。',
-            style: '爆发终结',
-          },
-        ],
-        initialItems: [
-          {
-            id: 'item-story-1',
-            name: '值夜灯尺',
-            category: '武器',
-            quantity: 1,
-            rarity: 'rare',
-            description: '兼作警械和测灯尺的长柄器具。',
-            tags: ['守灯会'],
-          },
-          {
-            id: 'item-story-2',
-            name: '防潮火折',
-            category: '消耗品',
-            quantity: 2,
-            rarity: 'uncommon',
-            description: '在潮雾里也能点亮的值夜火折。',
-            tags: ['值夜'],
-          },
-          {
-            id: 'item-story-3',
-            name: '封灯令副本',
-            category: '专属物品',
-            quantity: 1,
-            rarity: 'rare',
-            description: '一份被她私下截留下来的封灯令副本。',
-            tags: ['证据', '灯册'],
-          },
-        ],
-        imageSrc: '/custom/npcs/gu-chaoyin.png',
-        attributeProfile: {
-          schemaId: 'schema:test',
-          values: { axis_a: 54, axis_c: 82, axis_f: 61 },
-          topTraits: ['舟识', '回澜'],
-          evidence: [
-            {
-              slotId: 'axis_c',
-              reason: '长期依赖值夜观察和读灯判断局势。',
-            },
-          ],
-        },
-        narrativeProfile: {
-          publicMask: '守灯会值夜人，对外总像比别人更冷静一步。',
-          firstContactMask: '想进塔就按规矩来，今晚谁都别想乱闯禁航区。',
-          visibleLine: '她表面上只是在守灯和封线。',
-          hiddenLine: '她真正盯着的是那本被改过的原始灯册。',
-          contradiction: '越强调规矩，越像在掩住自己手里那份没上报的记录。',
-          debtOrBurden: '她扛着第一次海雾吞船夜里没能及时点亮备用灯的旧责。',
-          taboo: '最忌讳别人把那夜的失踪当成单纯天灾。',
-          immediatePressure: '新的封航令马上要落下来，她必须先把旧灯册转出去。',
-          relatedThreadIds: ['thread-visible-1'],
-          relatedScarIds: ['scar-1'],
-          reactionHooks: ['原始灯册', '封灯令'],
-        },
-        visual: {
-          race: 'human',
-          bodyColor: 'blue',
-          headIndex: 2,
-          hairColorIndex: 3,
-          hairStyleFrame: 4,
-          facialHairEnabled: false,
-          facialHairColorIndex: 0,
-          facialHairStyleFrame: 0,
-          offHand: {
-            type: 'magic',
-            file: 'lantern.png',
-            frameIndex: 1,
-          },
-        },
-      },
-    ],
-    items: [
-      {
-        id: 'item-world-1',
-        name: '潮雾罗盘',
-        category: '饰品',
-        rarity: 'rare',
-        description: '会在假航灯附近偏转的旧罗盘。',
-        tags: ['线索', '潮雾'],
-        attributeResonance: {
-          resonanceVector: { axis_c: 0.88, axis_e: 0.31 },
-          explanation: '它会把持有者的判断力牵到潮雾最异常的地方。',
-        },
-      },
-    ],
-    camp: {
-      name: '回潮暂栖所',
-      description: '能暂时收拢队伍、整理灯册与潮路线索的落脚点。',
-      dangerLevel: 'low',
-      imageSrc: '/custom/camp/huichao.png',
-    },
-    landmarks: [
-      {
-        id: 'landmark-1',
-        name: '回潮旧灯塔',
-        description: '被海雾啃旧的石塔仍在夜里维持着微弱灯火。',
-        dangerLevel: 'high',
-        imageSrc: '/custom/scenes/lighthouse.png',
-        sceneNpcIds: ['story-1'],
-        connections: [
-          {
-            targetLandmarkId: 'landmark-2',
-            relativePosition: 'forward',
-            summary: '沿着旧潮阶继续前压到雾栈尽头。',
-          },
-        ],
-        narrativeResidues: [
-          {
-            id: 'residue-1',
-            title: '潮痕',
-            visibleClue: '塔壁上有一圈不该出现在高处的潮痕。',
-            linkedFactIds: ['fact-1'],
-            linkedThreadIds: ['thread-visible-1'],
-          },
-        ],
-      },
-      {
-        id: 'landmark-2',
-        name: '雾栈尽头',
-        description: '旧栈桥尽头只剩断索、潮板和被抹掉的船名。',
-        dangerLevel: 'high',
-        imageSrc: '/custom/scenes/pier.png',
-        sceneNpcIds: [],
-        connections: [
-          {
-            targetLandmarkId: 'landmark-1',
-            relativePosition: 'back',
-            summary: '退回灯塔还能重新整理路线。',
-          },
-        ],
-      },
-    ],
-    themePack: {
-      id: 'theme-pack:tide',
-      displayName: '潮雾悬疑',
-      toneRange: ['压抑', '潮湿', '悬疑'],
-      institutionLexicon: ['守灯会', '航运公会'],
-      tabooLexicon: ['假航灯', '封灯令'],
-      artifactClasses: ['旧潮图', '灯册', '罗盘'],
-      actorArchetypes: ['引路人', '值夜人'],
-      conflictForms: ['封航争夺', '旧案追查'],
-      clueForms: ['灯册残页', '潮痕'],
-      namingPatterns: ['潮', '雾', '灯'],
-      revealStyles: ['试探式回应'],
-    },
-    storyGraph: {
-      visibleThreads: [
-        {
-          id: 'thread-visible-1',
-          title: '封航争夺',
-          visibility: 'visible',
-          summary: '守灯会与航运公会正在争夺旧航路的解释权。',
-          conflictType: '控制权争夺',
-          stakes: '谁能定义禁航区，就能决定谁能活着穿过去。',
-          involvedFactionIds: ['faction-guard', 'faction-guild'],
-          involvedActorIds: ['playable-1', 'story-1'],
-          relatedLocationIds: ['landmark-1', 'landmark-2'],
-        },
-      ],
-      hiddenThreads: [
-        {
-          id: 'thread-hidden-1',
-          title: '沉船旧案',
-          visibility: 'hidden',
-          summary: '沉船夜的航灯与灯册被人动过手脚。',
-          conflictType: '真相遮蔽',
-          stakes: '真相一旦坐实，守灯会内部会先崩。',
-          involvedFactionIds: ['faction-guard'],
-          involvedActorIds: ['playable-1', 'story-1'],
-          relatedLocationIds: ['landmark-1'],
-        },
-      ],
-      scars: [
-        {
-          id: 'scar-1',
-          title: '沉船夜',
-          pastEvent: '假航灯把整支船队引进了死潮区。',
-          publicResidue: '每逢潮夜，灯塔下总有人提起那晚的失踪名单。',
-          hiddenTruth: '禁航记录和灯册都在事后被篡改过。',
-          relatedActorIds: ['playable-1', 'story-1'],
-          relatedLocationIds: ['landmark-1'],
-        },
-      ],
-      motifs: [
-        {
-          id: 'motif-1',
-          label: '假航灯',
-          semanticRole: 'technology',
-          lexicalHints: ['假灯', '偏航', '禁航记录'],
-        },
-      ],
-    },
-    knowledgeFacts: [
-      {
-        id: 'fact-1',
-        title: '高处潮痕',
-        content: '回潮旧灯塔的高处潮痕说明那晚海面高度异常。',
-        ownerActorIds: ['story-1'],
-        relatedThreadIds: ['thread-visible-1'],
-        relatedScarIds: ['scar-1'],
-        sourceType: 'scene',
-        visibility: 'discoverable',
-        sayability: 'indirect',
-      },
-    ],
-    threadContracts: [
-      {
-        id: 'contract-1',
-        threadId: 'thread-visible-1',
-        issuerActorId: 'story-1',
-        narrativeType: 'investigation',
-        currentStepId: 'contract-step-1',
-        visibleStage: 1,
-        steps: [
-          {
-            id: 'contract-step-1',
-            title: '查灯塔',
-            revealText: '先查清灯塔顶上的高处潮痕。',
-            completionSignalIds: ['inspect_scene:landmark-1'],
-            optionalFactIds: ['fact-1'],
-          },
-        ],
-        followupThreadIds: ['thread-hidden-1'],
-      },
-    ],
-    scenarioPackId: 'scenario-pack:tide',
-    campaignPackId: 'campaign-pack:tide',
-    generationMode: 'fast',
-    generationStatus: 'key_only',
-  };
-}
-
-function buildProfileFromEmbeddedLegacyResult() {
-  return buildCustomWorldProfileFromAgentDraft({
-    ...session,
-    draftProfile: {
-      ...session.draftProfile,
-      legacyResultProfile: buildLegacyResultProfile(),
-    },
-  });
-}
-
-test('adapts agent draft profile into legacy custom world result profile', () => {
-  const profile = buildCustomWorldProfileFromAgentDraft(session);
-
-  expect(profile?.name).toBe('潮雾列岛');
-  expect(profile?.generationStatus).toBe('key_only');
-  expect(profile?.playableNpcs[0]?.name).toBe('沈砺');
-  expect(profile?.storyNpcs[0]?.name).toBe('顾潮音');
-  expect(profile?.landmarks[0]?.name).toBe('回潮旧灯塔');
-});
-
-test('agent draft result keeps generated role portraits and scene act backgrounds', () => {
-  const profile = buildCustomWorldProfileFromAgentDraft({
-    ...session,
-    draftProfile: {
-      ...session.draftProfile,
-      playableNpcs: [
-        {
-          ...session.draftProfile.playableNpcs[0],
-          imageSrc: '/generated-characters/playable-1/visual/asset-1/master.png',
-          generatedVisualAssetId: 'asset-1',
-        },
-      ],
-      storyNpcs: [
-        {
-          ...session.draftProfile.storyNpcs[0],
-          imageSrc: '/generated-characters/story-1/visual/asset-2/master.png',
-          generatedVisualAssetId: 'asset-2',
-        },
-      ],
-      sceneChapters: [
-        {
-          id: 'scene-chapter-1',
-          sceneId: 'landmark-1',
-          sceneName: '回潮旧灯塔',
-          title: '灯塔初章',
-          summary: '围绕灯塔推进的首个场景章节。',
-          linkedThreadIds: ['thread-1'],
-          linkedLandmarkIds: ['landmark-1'],
-          acts: [
-            {
-              id: 'scene-act-1',
-              title: '第一幕',
-              summary: '先接住回潮灯塔的入口压力。',
-              stageCoverage: ['opening'],
-              backgroundImageSrc:
-                '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
-              backgroundAssetId: 'scene-asset-1',
-              encounterNpcIds: ['story-1'],
-              primaryNpcId: 'story-1',
-              linkedThreadIds: ['thread-1'],
-              actGoal: '接住首幕入口',
-              transitionHook: '向第二幕推进。',
-              advanceRule: 'after_primary_contact',
-            },
-          ],
-        },
-      ],
-    },
-  });
-
-  expect(profile?.playableNpcs[0]?.imageSrc).toBe(
-    '/generated-characters/playable-1/visual/asset-1/master.png',
-  );
-  expect(profile?.playableNpcs[0]?.generatedVisualAssetId).toBe('asset-1');
-  expect(profile?.storyNpcs[0]?.imageSrc).toBe(
-    '/generated-characters/story-1/visual/asset-2/master.png',
-  );
-  expect(profile?.storyNpcs[0]?.generatedVisualAssetId).toBe('asset-2');
-  expect(profile?.sceneChapterBlueprints?.[0]?.acts[0]?.backgroundImageSrc).toBe(
-    '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
-  );
-  expect(profile?.sceneChapterBlueprints?.[0]?.acts[0]?.backgroundAssetId).toBe(
-    'scene-asset-1',
-  );
-});
-
-test('prefers embedded legacy result profile without dropping compiled runtime fields', () => {
-  const profile = buildProfileFromEmbeddedLegacyResult();
-
-  expect(profile?.name).toBe('旧版完整结果');
-  expect(profile?.majorFactions).toEqual(['守灯会', '航运公会']);
-  expect(profile?.coreConflicts).toEqual(['争夺航路控制权', '沉船真相']);
-  expect(profile?.themePack?.id).toBe('theme-pack:tide');
-  expect(profile?.storyGraph?.visibleThreads[0]?.id).toBe('thread-visible-1');
-  expect(profile?.knowledgeFacts?.[0]?.id).toBe('fact-1');
-  expect(profile?.threadContracts?.[0]?.id).toBe('contract-1');
-  expect(profile?.scenarioPackId).toBe('scenario-pack:tide');
-  expect(profile?.campaignPackId).toBe('campaign-pack:tide');
-  expect(profile?.playableNpcs[0]?.attributeProfile?.schemaId).toBe(
-    'schema:test',
-  );
-  expect(profile?.storyNpcs[0]?.narrativeProfile?.publicMask).toContain(
-    '守灯会值夜人',
-  );
-  expect(profile?.items[0]?.attributeResonance?.explanation).toContain('潮雾');
-  expect(profile?.landmarks[0]?.narrativeResidues?.[0]?.title).toBe('潮痕');
-});
-
-test('embedded legacy result profile merges latest draft asset fields for result view', () => {
-  const profile = buildCustomWorldProfileFromAgentDraft({
-    ...session,
-    draftProfile: {
-      ...session.draftProfile,
-      legacyResultProfile: buildLegacyResultProfile(),
-      playableNpcs: [
-        {
-          ...session.draftProfile.playableNpcs[0],
-          imageSrc: '/generated-characters/playable-1/visual/asset-runtime/master.png',
-          generatedVisualAssetId: 'asset-runtime-playable',
-        },
-      ],
-      storyNpcs: [
-        {
-          ...session.draftProfile.storyNpcs[0],
-          imageSrc: '/generated-characters/story-1/visual/asset-runtime/master.png',
-          generatedVisualAssetId: 'asset-runtime-story',
-        },
-      ],
-      landmarks: [
-        {
-          ...session.draftProfile.landmarks[0],
-          imageSrc: '/generated-custom-world-scenes/landmark-1/scene.png',
-        },
-      ],
-      sceneChapters: [
-        {
-          id: 'scene-chapter-1',
-          sceneId: 'landmark-1',
-          sceneName: '回潮旧灯塔',
-          title: '灯塔初章',
-          summary: '围绕灯塔推进的首个场景章节。',
-          linkedThreadIds: ['thread-1'],
-          linkedLandmarkIds: ['landmark-1'],
-          acts: [
-            {
-              id: 'scene-act-1',
-              title: '第一幕',
-              summary: '先接住回潮灯塔的入口压力。',
-              stageCoverage: ['opening'],
-              backgroundImageSrc:
-                '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
-              backgroundAssetId: 'scene-asset-runtime',
-              encounterNpcIds: ['story-1'],
-              primaryNpcId: 'story-1',
-              linkedThreadIds: ['thread-1'],
-              actGoal: '接住首幕入口',
-              transitionHook: '向第二幕推进。',
-              advanceRule: 'after_primary_contact',
-            },
-          ],
-        },
-      ],
-    },
-  });
-
-  expect(profile?.name).toBe('旧版完整结果');
-  expect(profile?.playableNpcs[0]?.imageSrc).toBe(
-    '/generated-characters/playable-1/visual/asset-runtime/master.png',
-  );
-  expect(profile?.playableNpcs[0]?.generatedVisualAssetId).toBe(
-    'asset-runtime-playable',
-  );
-  expect(profile?.storyNpcs[0]?.imageSrc).toBe(
-    '/generated-characters/story-1/visual/asset-runtime/master.png',
-  );
-  expect(profile?.storyNpcs[0]?.generatedVisualAssetId).toBe(
-    'asset-runtime-story',
-  );
-  expect(profile?.landmarks[0]?.imageSrc).toBe(
-    '/generated-custom-world-scenes/landmark-1/scene.png',
-  );
-  expect(profile?.sceneChapterBlueprints?.[0]?.acts[0]?.backgroundImageSrc).toBe(
-    '/generated-custom-world-scenes/landmark-1/scene-act-1/scene.png',
-  );
-  expect(profile?.sceneChapterBlueprints?.[0]?.acts[0]?.backgroundAssetId).toBe(
-    'scene-asset-runtime',
-  );
-});
-
-test('embedded legacy result profile keeps result-page settings in runtime characters and scenes', () => {
-  const profile = buildProfileFromEmbeddedLegacyResult();
-
-  expect(profile).toBeTruthy();
-
-  setRuntimeCustomWorldProfile(profile);
-
-  const runtimeCharacters = buildCustomWorldRuntimeCharacters(profile);
-  const leadCharacter = runtimeCharacters.find(
-    (character) => character.id === 'playable-1',
-  );
-  const lighthouseScene = getScenePresetsByWorld(WorldType.CUSTOM).find(
-    (scene) => scene.name === '回潮旧灯塔',
-  );
-  const guardNpc = lighthouseScene?.npcs.find((npc) => npc.id === 'story-1');
-
-  expect(leadCharacter?.skills[0]?.name).toBe('潮行引路');
-  expect(leadCharacter?.backstoryReveal?.publicSummary).toBe('沈砺的公开背景');
-  expect(lighthouseScene?.connections[0]?.summary).toBe(
-    '沿着旧潮阶继续前压到雾栈尽头。',
-  );
-  expect(lighthouseScene?.narrativeResidues?.[0]?.title).toBe('潮痕');
-  expect(guardNpc?.narrativeProfile?.publicMask).toBe(
-    '守灯会值夜人，对外总像比别人更冷静一步。',
-  );
-});
-
-test('embedded legacy result profile uses latest draft role collection when legacy role ids drift', () => {
-  const profile = buildCustomWorldProfileFromAgentDraft({
-    ...session,
-    draftProfile: {
-      ...session.draftProfile,
-      legacyResultProfile: buildLegacyResultProfile(),
-      storyNpcs: [
-        {
-          id: 'story-npc-latest-1',
-          name: '林教授',
-          title: '深海学院导师',
-          role: '场景关键角色',
-          publicIdentity: '研究古代海洋遗迹的资深学者。',
-          publicMask: '总是先观察，再给出判断。',
-          currentPressure: '必须在遗迹崩塌前带出关键样本。',
-          hiddenHook: '他知道遗迹深处那扇门为何会苏醒。',
-          relationToPlayer: '最早愿意共享海图的人',
-          threadIds: ['thread-1'],
-          summary: '他像学者，也像提前看见灾变的人。',
-          imageSrc:
-            '/generated-characters/story-npc-latest-1/visual/asset-latest/master.png',
-          generatedVisualAssetId: 'asset-latest-story',
-        },
-      ],
-      sceneChapters: [
-        {
-          id: 'scene-chapter-latest-1',
-          sceneId: 'landmark-1',
-          sceneName: '回潮旧灯塔',
-          title: '灯塔新章',
-          summary: '围绕林教授推进的新章节。',
-          linkedThreadIds: ['thread-1'],
-          linkedLandmarkIds: ['landmark-1'],
-          acts: [
-            {
-              id: 'scene-act-latest-1',
-              title: '第一幕',
-              summary: '先接林教授的入口信息。',
-              stageCoverage: ['opening'],
-              backgroundImageSrc:
-                '/generated-custom-world-scenes/landmark-1/scene-act-latest-1/scene.png',
-              backgroundAssetId: 'scene-asset-latest',
-              encounterNpcIds: ['story-npc-latest-1'],
-              primaryNpcId: 'story-npc-latest-1',
-              linkedThreadIds: ['thread-1'],
-              actGoal: '接住新的入口信息',
-              transitionHook: '向下一幕推进。',
-              advanceRule: 'after_primary_contact',
-            },
-          ],
-        },
-      ],
-      landmarks: [
-        {
-          ...session.draftProfile.landmarks[0],
-          imageSrc: '/generated-custom-world-scenes/landmark-1/latest-scene.png',
-        },
-      ],
-    },
-  });
-
-  expect(profile?.storyNpcs).toHaveLength(1);
-  expect(profile?.storyNpcs[0]?.id).toBe('story-npc-latest-1');
-  expect(profile?.storyNpcs[0]?.name).toBe('林教授');
-  expect(profile?.storyNpcs[0]?.imageSrc).toBe(
-    '/generated-characters/story-npc-latest-1/visual/asset-latest/master.png',
-  );
-  expect(profile?.storyNpcs[0]?.generatedVisualAssetId).toBe(
-    'asset-latest-story',
-  );
-  expect(profile?.storyNpcs[0]?.narrativeProfile).toBeFalsy();
-  expect(profile?.landmarks[0]?.imageSrc).toBe(
-    '/generated-custom-world-scenes/landmark-1/latest-scene.png',
-  );
-  expect(profile?.sceneChapterBlueprints?.[0]?.acts[0]?.primaryNpcId).toBe(
-    'story-npc-latest-1',
-  );
-  expect(profile?.sceneChapterBlueprints?.[0]?.acts[0]?.backgroundImageSrc).toBe(
-    '/generated-custom-world-scenes/landmark-1/scene-act-latest-1/scene.png',
-  );
-});
diff --git a/src/services/customWorldAgentDraftResult.ts b/src/services/customWorldAgentDraftResult.ts
deleted file mode 100644
index 1df6f997..00000000
--- a/src/services/customWorldAgentDraftResult.ts
+++ /dev/null
@@ -1,591 +0,0 @@
-import type { CustomWorldAgentSessionSnapshot } from '../../packages/shared/src/contracts/customWorldAgent';
-import { normalizeCustomWorldProfileRecord } from '../data/customWorldLibrary';
-import { type CustomWorldProfile, WorldType } from '../types';
-import { buildAgentDraftFoundationSettingText } from './customWorldAgentGenerationProgress';
-
-function toText(value: unknown, fallback = '') {
-  return typeof value === 'string' ? value.trim() : fallback;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-function toRecordArray(value: unknown) {
-  return Array.isArray(value)
-    ? value.filter((item): item is Record<string, unknown> => isRecord(item))
-    : [];
-}
-
-function toStringArray(value: unknown, max = 8) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-
-  return [...new Set(value.map((item) => toText(item)).filter(Boolean))].slice(
-    0,
-    max,
-  );
-}
-
-function inferTemplateWorldType(settingText: string) {
-  return /[仙灵修真飞升灵脉宗门法器天宫秘境道骨星舰]/u.test(settingText)
-    ? WorldType.XIANXIA
-    : WorldType.WUXIA;
-}
-
-function buildCharacterSummaryText(record: Record<string, unknown>) {
-  return (
-    toText(record.summary) ||
-    toText(record.publicIdentity) ||
-    toText(record.publicMask) ||
-    toText(record.currentPressure) ||
-    toText(record.relationToPlayer)
-  );
-}
-
-function buildCharacterBackstoryText(record: Record<string, unknown>) {
-  return [
-    toText(record.publicIdentity),
-    toText(record.currentPressure),
-    toText(record.hiddenHook) ? `暗线 ${toText(record.hiddenHook)}` : '',
-  ]
-    .filter(Boolean)
-    .join('；');
-}
-
-function buildRelationshipHooks(record: Record<string, unknown>) {
-  return [
-    toText(record.relationToPlayer),
-    toText(record.currentPressure),
-    toText(record.hiddenHook) ? `暗线 ${toText(record.hiddenHook)}` : '',
-  ].filter(Boolean);
-}
-
-function buildCharacterTags(
-  record: Record<string, unknown>,
-  roleKind: 'playable' | 'story',
-) {
-  const threadIds = toStringArray(record.threadIds, 4);
-  return [...threadIds, roleKind === 'playable' ? '草稿主角' : '草稿角色'];
-}
-
-type AdaptedDraftCharacter = {
-  id: string;
-  name: string;
-  title: string;
-  role: string;
-  description: string;
-  backstory: string;
-  personality: string;
-  motivation: string;
-  combatStyle: string;
-  initialAffinity: number;
-  relationshipHooks: string[];
-  tags: string[];
-  imageSrc?: string;
-  generatedVisualAssetId?: string;
-  generatedAnimationSetId?: string;
-  animationMap?: Record<string, unknown>;
-};
-
-function adaptDraftCharacters(value: unknown, roleKind: 'playable' | 'story') {
-  return toRecordArray(value)
-    .map((record, index) => {
-      const name = toText(record.name);
-      if (!name) {
-        return null;
-      }
-
-      const title =
-        toText(record.title) ||
-        toText(record.role) ||
-        (roleKind === 'playable' ? '关键角色' : '场景角色');
-      const role = toText(record.role) || title;
-      const description = buildCharacterSummaryText(record);
-      const relationshipHooks = buildRelationshipHooks(record);
-
-      return {
-        id: toText(record.id) || `${roleKind}-draft-${index + 1}`,
-        name,
-        title,
-        role,
-        description,
-        backstory: buildCharacterBackstoryText(record),
-        personality:
-          toText(record.publicMask) ||
-          toText(record.publicIdentity) ||
-          description,
-        motivation:
-          toText(record.relationToPlayer) ||
-          toText(record.currentPressure) ||
-          toText(record.hiddenHook),
-        combatStyle: role,
-        initialAffinity: roleKind === 'playable' ? 18 : 6,
-        relationshipHooks,
-        tags: buildCharacterTags(record, roleKind),
-        imageSrc: toText(record.imageSrc) || undefined,
-        generatedVisualAssetId:
-          toText(record.generatedVisualAssetId) || undefined,
-        generatedAnimationSetId:
-          toText(record.generatedAnimationSetId) || undefined,
-        animationMap: isRecord(record.animationMap)
-          ? record.animationMap
-          : undefined,
-      } satisfies AdaptedDraftCharacter;
-    })
-    .filter(Boolean) as AdaptedDraftCharacter[];
-}
-
-type AdaptedDraftLandmark = {
-  id: string;
-  name: string;
-  description: string;
-  dangerLevel: string;
-  imageSrc?: string;
-  sceneNpcIds: string[];
-  connections: never[];
-};
-
-type AdaptedDraftCamp = {
-  name: string;
-  description: string;
-  dangerLevel: string;
-  imageSrc?: string;
-};
-
-function adaptDraftLandmarks(value: unknown, storyNpcIdSet: Set<string>) {
-  return toRecordArray(value)
-    .map((record, index) => {
-      const name = toText(record.name);
-      if (!name) {
-        return null;
-      }
-
-      return {
-        id: toText(record.id) || `landmark-draft-${index + 1}`,
-        name,
-        description:
-          toText(record.description) ||
-          toText(record.summary) ||
-          [toText(record.purpose), toText(record.mood)]
-            .filter(Boolean)
-            .join('；'),
-        dangerLevel:
-          toText(record.dangerLevel) ||
-          toText(record.importance) ||
-          toText(record.mood),
-        imageSrc: toText(record.imageSrc) || undefined,
-        sceneNpcIds: toStringArray(record.characterIds).filter((id) =>
-          storyNpcIdSet.has(id),
-        ),
-        connections: [],
-      } satisfies AdaptedDraftLandmark;
-    })
-    .filter(Boolean) as AdaptedDraftLandmark[];
-}
-
-function adaptDraftCamp(value: unknown): AdaptedDraftCamp | null {
-  if (!isRecord(value)) {
-    return null;
-  }
-
-  const name = toText(value.name);
-  const description = toText(value.description);
-  if (!name && !description) {
-    return null;
-  }
-
-  return {
-    name: name || '开局据点',
-    description: description || '开局落脚点仍待继续精修。',
-    dangerLevel:
-      toText(value.dangerLevel) || toText(value.mood) || 'medium',
-    imageSrc: toText(value.imageSrc) || undefined,
-  } satisfies AdaptedDraftCamp;
-}
-
-function normalizeMatchText(value: unknown) {
-  return toText(value).toLocaleLowerCase();
-}
-
-function findRecordMatchIndex(
-  records: Record<string, unknown>[],
-  matcher: (record: Record<string, unknown>) => boolean,
-  usedIndexes: Set<number>,
-) {
-  const matchedIndex = records.findIndex(
-    (record, index) => !usedIndexes.has(index) && matcher(record),
-  );
-  if (matchedIndex >= 0) {
-    usedIndexes.add(matchedIndex);
-  }
-  return matchedIndex;
-}
-
-function mergeDraftRolesIntoProfileRecord(params: {
-  baseRoles: unknown;
-  draftRoles: AdaptedDraftCharacter[];
-}) {
-  const baseRoles = toRecordArray(params.baseRoles);
-  if (params.draftRoles.length <= 0) {
-    return baseRoles;
-  }
-
-  const usedIndexes = new Set<number>();
-
-  // 当前 draft 才是最新角色集合；legacy 只负责为同一对象补运行时富字段，
-  // 不能再让旧列表继续主导结果页，否则会把新角色主图和新对象列表吞掉。
-  return params.draftRoles.map((draftRole) => {
-    let matchedIndex = findRecordMatchIndex(
-      baseRoles,
-      (record) => toText(record.id) === draftRole.id,
-      usedIndexes,
-    );
-
-    if (matchedIndex < 0) {
-      matchedIndex = findRecordMatchIndex(
-        baseRoles,
-        (record) => normalizeMatchText(record.name) === normalizeMatchText(draftRole.name),
-        usedIndexes,
-      );
-    }
-
-    const baseRole = matchedIndex >= 0 ? baseRoles[matchedIndex] : null;
-    const baseImageSrc = toText(baseRole?.imageSrc) || undefined;
-    const baseGeneratedVisualAssetId =
-      toText(baseRole?.generatedVisualAssetId) || undefined;
-    const baseGeneratedAnimationSetId =
-      toText(baseRole?.generatedAnimationSetId) || undefined;
-    return {
-      ...(baseRole ?? {}),
-      ...draftRole,
-      imageSrc: draftRole.imageSrc ?? baseImageSrc,
-      generatedVisualAssetId:
-        draftRole.generatedVisualAssetId ?? baseGeneratedVisualAssetId,
-      generatedAnimationSetId:
-        draftRole.generatedAnimationSetId ?? baseGeneratedAnimationSetId,
-      animationMap:
-        draftRole.animationMap ??
-        (isRecord(baseRole?.animationMap) ? baseRole?.animationMap : undefined),
-    } satisfies Record<string, unknown>;
-  });
-}
-
-function mergeDraftLandmarksIntoProfileRecord(params: {
-  baseLandmarks: unknown;
-  draftLandmarks: AdaptedDraftLandmark[];
-}) {
-  const baseLandmarks = toRecordArray(params.baseLandmarks);
-  if (params.draftLandmarks.length <= 0) {
-    return baseLandmarks;
-  }
-
-  const usedIndexes = new Set<number>();
-  const mergedLandmarks = params.draftLandmarks.map((draftLandmark) => {
-    let matchedIndex = findRecordMatchIndex(
-      baseLandmarks,
-      (record) => toText(record.id) === draftLandmark.id,
-      usedIndexes,
-    );
-
-    if (matchedIndex < 0) {
-      matchedIndex = findRecordMatchIndex(
-        baseLandmarks,
-        (record) =>
-          normalizeMatchText(record.name) === normalizeMatchText(draftLandmark.name),
-        usedIndexes,
-      );
-    }
-
-    const baseLandmark = matchedIndex >= 0 ? baseLandmarks[matchedIndex] : null;
-    const baseImageSrc = toText(baseLandmark?.imageSrc) || undefined;
-    return {
-      ...(baseLandmark ?? {}),
-      id: draftLandmark.id,
-      name: draftLandmark.name,
-      description: draftLandmark.description,
-      dangerLevel: draftLandmark.dangerLevel,
-      imageSrc: draftLandmark.imageSrc ?? baseImageSrc,
-      sceneNpcIds:
-        draftLandmark.sceneNpcIds.length > 0
-          ? draftLandmark.sceneNpcIds
-          : toStringArray(baseLandmark?.sceneNpcIds),
-    } satisfies Record<string, unknown>;
-  });
-
-  const remainingLegacyLandmarks = baseLandmarks.filter(
-    (_entry, index) => !usedIndexes.has(index),
-  );
-
-  return [...mergedLandmarks, ...remainingLegacyLandmarks];
-}
-
-function mergeDraftSceneChaptersIntoProfileRecord(params: {
-  baseSceneChapters: unknown;
-  draftSceneChapters: CustomWorldProfile['sceneChapterBlueprints'];
-}) {
-  const baseSceneChapters = toRecordArray(params.baseSceneChapters);
-  const draftSceneChapters = params.draftSceneChapters ?? [];
-  if (draftSceneChapters.length <= 0) {
-    return baseSceneChapters;
-  }
-
-  const usedChapterIndexes = new Set<number>();
-  return draftSceneChapters.map((draftChapter) => {
-    let matchedChapterIndex = findRecordMatchIndex(
-      baseSceneChapters,
-      (record) => toText(record.sceneId) === draftChapter.sceneId,
-      usedChapterIndexes,
-    );
-
-    if (matchedChapterIndex < 0) {
-      matchedChapterIndex = findRecordMatchIndex(
-        baseSceneChapters,
-        (record) =>
-          normalizeMatchText(record.title) === normalizeMatchText(draftChapter.title),
-        usedChapterIndexes,
-      );
-    }
-
-    const baseChapter =
-      matchedChapterIndex >= 0 ? baseSceneChapters[matchedChapterIndex] : null;
-    const baseActs = toRecordArray(baseChapter?.acts);
-    const usedActIndexes = new Set<number>();
-    const mergedActs = draftChapter.acts.map((draftAct) => {
-      let matchedActIndex = findRecordMatchIndex(
-        baseActs,
-        (record) => toText(record.id) === draftAct.id,
-        usedActIndexes,
-      );
-
-      if (matchedActIndex < 0) {
-        matchedActIndex = findRecordMatchIndex(
-          baseActs,
-          (record) =>
-            normalizeMatchText(record.title) === normalizeMatchText(draftAct.title),
-          usedActIndexes,
-        );
-      }
-
-      const baseAct = matchedActIndex >= 0 ? baseActs[matchedActIndex] : null;
-      const baseBackgroundImageSrc =
-        toText(baseAct?.backgroundImageSrc) || undefined;
-      const baseBackgroundAssetId =
-        toText(baseAct?.backgroundAssetId) || undefined;
-      return {
-        ...(baseAct ?? {}),
-        ...draftAct,
-        backgroundImageSrc: draftAct.backgroundImageSrc ?? baseBackgroundImageSrc,
-        backgroundAssetId: draftAct.backgroundAssetId ?? baseBackgroundAssetId,
-      } satisfies Record<string, unknown>;
-    });
-
-    return {
-      ...(baseChapter ?? {}),
-      ...draftChapter,
-      acts: mergedActs,
-    } satisfies Record<string, unknown>;
-  });
-}
-
-function mergeDraftCampIntoProfileRecord(params: {
-  baseCamp: unknown;
-  draftCamp: AdaptedDraftCamp | null;
-}) {
-  if (!params.draftCamp) {
-    return isRecord(params.baseCamp) ? params.baseCamp : undefined;
-  }
-
-  const baseCamp = isRecord(params.baseCamp) ? params.baseCamp : null;
-  const baseImageSrc = toText(baseCamp?.imageSrc) || undefined;
-  return {
-    ...(baseCamp ?? {}),
-    ...params.draftCamp,
-    imageSrc: params.draftCamp.imageSrc ?? baseImageSrc,
-  } satisfies Record<string, unknown>;
-}
-
-function toStageCoverage(value: unknown) {
-  const stageCoverage = Array.isArray(value)
-    ? value
-        .filter((entry): entry is string => typeof entry === 'string')
-        .map((entry) => entry.trim())
-        .filter(Boolean)
-    : [];
-
-  return [...new Set(stageCoverage)];
-}
-
-function adaptDraftSceneChapters(
-  value: unknown,
-  storyNpcIdSet: Set<string>,
-  landmarkIdSet: Set<string>,
-) {
-  return toRecordArray(value)
-    .map((record, index) => {
-      const sceneId = toText(record.sceneId);
-      if (!sceneId) {
-        return null;
-      }
-
-      const acts = toRecordArray(record.acts)
-        .map((actRecord, actIndex) => {
-          const encounterNpcIds = toStringArray(
-            actRecord.encounterNpcIds,
-          ).filter((entry) => storyNpcIdSet.has(entry));
-          const primaryNpcId = toText(
-            actRecord.primaryNpcId,
-            encounterNpcIds[0] ?? '',
-          );
-
-          return {
-            id: toText(actRecord.id) || `scene-act-${sceneId}-${actIndex + 1}`,
-            sceneId,
-            title: toText(actRecord.title) || `第 ${actIndex + 1} 幕`,
-            summary:
-              toText(actRecord.summary) ||
-              toText(actRecord.actGoal) ||
-              `围绕${toText(record.sceneName, sceneId)}继续推进`,
-            stageCoverage:
-              toStageCoverage(actRecord.stageCoverage).length > 0
-                ? toStageCoverage(actRecord.stageCoverage)
-                : actIndex === 0
-                  ? ['opening']
-                  : ['climax', 'aftermath'],
-            backgroundImageSrc:
-              toText(actRecord.backgroundImageSrc) || undefined,
-            backgroundAssetId:
-              toText(actRecord.backgroundAssetId) || undefined,
-            encounterNpcIds,
-            primaryNpcId,
-            linkedThreadIds: toStringArray(actRecord.linkedThreadIds),
-            advanceRule:
-              toText(actRecord.advanceRule) || 'after_active_step_complete',
-            actGoal: toText(actRecord.actGoal),
-            transitionHook: toText(actRecord.transitionHook),
-          };
-        })
-        .filter(
-          (entry) =>
-            entry.encounterNpcIds.length > 0 || entry.backgroundImageSrc,
-        );
-
-      return {
-        id: toText(record.id) || `scene-chapter-${sceneId}-${index + 1}`,
-        sceneId,
-        title: toText(record.title) || toText(record.sceneName) || sceneId,
-        summary:
-          toText(record.summary) ||
-          toText(record.title) ||
-          toText(record.sceneName) ||
-          sceneId,
-        linkedThreadIds: toStringArray(record.linkedThreadIds, 8),
-        linkedLandmarkIds: toStringArray(record.linkedLandmarkIds, 8).filter(
-          (entry) => landmarkIdSet.has(entry),
-        ),
-        acts,
-      };
-    })
-    .filter(Boolean);
-}
-
-export function buildCustomWorldProfileFromAgentDraft(
-  session: CustomWorldAgentSessionSnapshot | null | undefined,
-): CustomWorldProfile | null {
-  if (!session || !isRecord(session.draftProfile)) {
-    return null;
-  }
-
-  const draftProfile = session.draftProfile;
-  const settingText = buildAgentDraftFoundationSettingText(session);
-  const templateWorldType = inferTemplateWorldType(settingText);
-  const playableNpcs = adaptDraftCharacters(
-    draftProfile.playableNpcs,
-    'playable',
-  );
-  const storyNpcs = adaptDraftCharacters(draftProfile.storyNpcs, 'story');
-  const storyNpcIdSet = new Set(
-    storyNpcs.map((entry) => toText(entry.id)).filter(Boolean),
-  );
-  const adaptedLandmarks = adaptDraftLandmarks(
-    draftProfile.landmarks,
-    storyNpcIdSet,
-  );
-  const landmarkIdSet = new Set(
-    adaptedLandmarks.map((entry) => toText(entry.id)).filter(Boolean),
-  );
-  const draftSceneChapterBlueprints = adaptDraftSceneChapters(
-    draftProfile.sceneChapters,
-    storyNpcIdSet,
-    landmarkIdSet,
-  );
-  const draftCamp = adaptDraftCamp(draftProfile.camp);
-  const legacyResultProfile = normalizeCustomWorldProfileRecord(
-    draftProfile.legacyResultProfile,
-  );
-  if (legacyResultProfile) {
-    const mergedProfile = normalizeCustomWorldProfileRecord({
-      ...legacyResultProfile,
-      playableNpcs: mergeDraftRolesIntoProfileRecord({
-        baseRoles: legacyResultProfile.playableNpcs,
-        draftRoles: playableNpcs,
-      }),
-      storyNpcs: mergeDraftRolesIntoProfileRecord({
-        baseRoles: legacyResultProfile.storyNpcs,
-        draftRoles: storyNpcs,
-      }),
-      landmarks: mergeDraftLandmarksIntoProfileRecord({
-        baseLandmarks: legacyResultProfile.landmarks,
-        draftLandmarks: adaptedLandmarks,
-      }),
-      camp: mergeDraftCampIntoProfileRecord({
-        baseCamp: legacyResultProfile.camp,
-        draftCamp,
-      }),
-      sceneChapterBlueprints: mergeDraftSceneChaptersIntoProfileRecord({
-        baseSceneChapters: legacyResultProfile.sceneChapterBlueprints,
-        draftSceneChapters: draftSceneChapterBlueprints,
-      }),
-    });
-
-    return mergedProfile ?? legacyResultProfile;
-  }
-
-  const normalized = normalizeCustomWorldProfileRecord({
-    id: `agent-draft-${session.sessionId}`,
-    settingText,
-    name: toText(draftProfile.name) || '未命名世界底稿',
-    subtitle: toText(draftProfile.subtitle) || '第一版世界底稿',
-    summary:
-      toText(draftProfile.summary) ||
-      settingText ||
-      '第一版世界底稿已经整理完成。',
-    tone: toText(draftProfile.tone) || '整体气质仍可继续精修',
-    playerGoal: toText(draftProfile.playerGoal) || '先站稳开局，再判断下一步',
-    templateWorldType,
-    compatibilityTemplateWorldType: templateWorldType,
-    majorFactions: toStringArray(draftProfile.majorFactions, 6),
-    coreConflicts: toStringArray(draftProfile.coreConflicts, 6),
-    playableNpcs,
-    storyNpcs,
-    landmarks: adaptedLandmarks,
-    camp: draftCamp
-      ? {
-          name: draftCamp.name,
-          description: draftCamp.description,
-          dangerLevel: draftCamp.dangerLevel,
-          imageSrc: draftCamp.imageSrc,
-        }
-      : undefined,
-    sceneChapterBlueprints: draftSceneChapterBlueprints,
-    anchorContent: session.anchorContent,
-    creatorIntent: session.creatorIntent,
-    anchorPack: session.anchorPack,
-    lockState: session.lockState,
-    generationMode: 'fast',
-    generationStatus: 'key_only',
-  });
-
-  return normalized;
-}
diff --git a/src/services/customWorldSceneActRuntime.ts b/src/services/customWorldSceneActRuntime.ts
index 8e99463a..9668fa4e 100644
--- a/src/services/customWorldSceneActRuntime.ts
+++ b/src/services/customWorldSceneActRuntime.ts
@@ -1,4 +1,4 @@
-import type { NpcChatTurnDirective } from '../../packages/shared/src/contracts/story';
+import type { NpcChatTurnDirective } from '../../packages/shared/src/contracts/rpgRuntimeChat';
 import type {
   CustomWorldProfile,
   GameState,
diff --git a/src/services/rpg-creation/index.ts b/src/services/rpg-creation/index.ts
index 005dda5c..b75f89e7 100644
--- a/src/services/rpg-creation/index.ts
+++ b/src/services/rpg-creation/index.ts
@@ -18,6 +18,15 @@ export {
   generateRpgWorldStoryNpc,
   uploadRpgWorldCoverImage,
 } from './rpgCreationAssetClient';
+export type {
+  CustomWorldGenerationProgress,
+  GenerateCustomWorldProfileInput,
+  GenerateCustomWorldProfileOptions,
+} from './rpgCreationGenerationClient';
+export {
+  generateCustomWorldProfile as generateLegacyCustomWorldProfile,
+  generateRpgWorldProfile,
+} from './rpgCreationGenerationClient';
 export {
   deleteRpgWorldProfile,
   getRpgWorldGalleryDetail,
@@ -29,7 +38,11 @@ export {
   upsertRpgWorldProfile,
 } from './rpgCreationLibraryClient';
 export {
-  buildRpgCreationPreviewFromAgentDraft,
+  buildRpgCreationPreviewFromResultPreview,
+  buildRpgCreationPreviewFromSession,
   rpgCreationPreviewAdapter,
 } from './rpgCreationPreviewAdapter';
-export { listRpgCreationWorks, rpgCreationWorkClient } from './rpgCreationWorkClient';
+export {
+  listRpgCreationWorks,
+  rpgCreationWorkClient,
+} from './rpgCreationWorkClient';
diff --git a/src/services/rpg-creation/rpgCreationAgentClient.ts b/src/services/rpg-creation/rpgCreationAgentClient.ts
index 07848212..6e957307 100644
--- a/src/services/rpg-creation/rpgCreationAgentClient.ts
+++ b/src/services/rpg-creation/rpgCreationAgentClient.ts
@@ -1,33 +1,208 @@
+import type {
+  CreateRpgAgentSessionRequest,
+  CreateRpgAgentSessionResponse,
+  GetRpgAgentCardDetailResponse,
+  RpgAgentDraftCardDetail,
+  RpgAgentOperationRecord,
+  RpgAgentSessionSnapshot,
+  SendRpgAgentMessageRequest,
+} from '../../../packages/shared/src';
+import type { RpgAgentActionRequest } from '../../../packages/shared/src';
+import type { TextStreamOptions } from '../aiTypes';
 import {
-  createCustomWorldAgentSession,
-  executeCustomWorldAgentAction,
-  getCustomWorldAgentCardDetail,
-  getCustomWorldAgentOperation,
-  getCustomWorldAgentSession,
-  sendCustomWorldAgentMessage,
-  streamCustomWorldAgentMessage,
-} from '../aiService';
+  openRpgCreationSsePost,
+  requestRpgCreationPostJson,
+} from './rpgCreationRequestHelpers';
+import { requestRpgCreationRuntimeJson } from './rpgCreationRuntimeClient';
+
+const RPG_AGENT_API_BASE = '/custom-world/agent/sessions';
+
+export async function createRpgCreationSession(
+  payload: CreateRpgAgentSessionRequest,
+) {
+  return requestRpgCreationRuntimeJson<CreateRpgAgentSessionResponse>(
+    RPG_AGENT_API_BASE,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '创建世界共创会话失败',
+  );
+}
+
+export async function getRpgCreationSession(sessionId: string) {
+  return requestRpgCreationRuntimeJson<RpgAgentSessionSnapshot>(
+    `${RPG_AGENT_API_BASE}/${encodeURIComponent(sessionId)}`,
+    {
+      method: 'GET',
+    },
+    '读取世界共创会话失败',
+  );
+}
+
+export async function sendRpgCreationMessage(
+  sessionId: string,
+  payload: SendRpgAgentMessageRequest,
+) {
+  return requestRpgCreationPostJson<{ operation: RpgAgentOperationRecord }>(
+    `/api/runtime${RPG_AGENT_API_BASE}/${encodeURIComponent(sessionId)}/messages`,
+    payload,
+    '发送共创消息失败',
+  );
+}
+
+export async function streamRpgCreationMessage(
+  sessionId: string,
+  payload: SendRpgAgentMessageRequest,
+  options: TextStreamOptions = {},
+) {
+  const response = await openRpgCreationSsePost(
+    `/api/runtime${RPG_AGENT_API_BASE}/${encodeURIComponent(sessionId)}/messages/stream`,
+    payload,
+    '发送共创消息失败',
+  );
+
+  const streamBody = response.body;
+  if (!streamBody) {
+    throw new Error('streaming response body is unavailable');
+  }
+
+  const reader = streamBody.getReader();
+  const decoder = new TextDecoder('utf-8');
+  let buffer = '';
+  let finalSession: RpgAgentSessionSnapshot | null = null;
+
+  for (;;) {
+    const { done, value } = await reader.read();
+    if (done) {
+      break;
+    }
+
+    buffer += decoder.decode(value, { stream: true });
+
+    while (buffer.includes('\n\n')) {
+      const boundary = buffer.indexOf('\n\n');
+      const eventBlock = buffer.slice(0, boundary);
+      buffer = buffer.slice(boundary + 2);
+
+      let eventName = 'message';
+      const dataLines: string[] = [];
+
+      for (const rawLine of eventBlock.split(/\r?\n/u)) {
+        const line = rawLine.trim();
+        if (line.startsWith('event:')) {
+          eventName = line.slice(6).trim() || 'message';
+          continue;
+        }
+        if (line.startsWith('data:')) {
+          dataLines.push(line.slice(5).trim());
+        }
+      }
+
+      if (dataLines.length === 0) {
+        continue;
+      }
+
+      const data = dataLines.join('\n');
+      let parsed: Record<string, unknown> | null = null;
+
+      try {
+        parsed = JSON.parse(data) as Record<string, unknown>;
+      } catch {
+        parsed = null;
+      }
+
+      if (eventName === 'reply_delta' && parsed) {
+        const text = parsed.text;
+        if (typeof text === 'string') {
+          options.onUpdate?.(text);
+        }
+        continue;
+      }
+
+      if (eventName === 'session' && parsed?.session) {
+        finalSession = parsed.session as RpgAgentSessionSnapshot;
+        continue;
+      }
+
+      if (eventName === 'error' && parsed) {
+        const message =
+          typeof parsed.message === 'string' && parsed.message.trim()
+            ? parsed.message.trim()
+            : '发送共创消息失败';
+        throw new Error(message);
+      }
+    }
+  }
+
+  if (!finalSession) {
+    throw new Error('共创消息流式结果不完整');
+  }
+
+  return finalSession;
+}
+
+export async function executeRpgCreationAction(
+  sessionId: string,
+  payload: RpgAgentActionRequest,
+) {
+  return requestRpgCreationRuntimeJson<{ operation: RpgAgentOperationRecord }>(
+    `${RPG_AGENT_API_BASE}/${encodeURIComponent(sessionId)}/actions`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '执行共创操作失败',
+  );
+}
+
+export async function getRpgCreationOperation(
+  sessionId: string,
+  operationId: string,
+): Promise<RpgAgentOperationRecord> {
+  const response = await requestRpgCreationRuntimeJson<
+    {
+      operation?: RpgAgentOperationRecord;
+      data?: RpgAgentOperationRecord;
+    } & Partial<RpgAgentOperationRecord>
+  >(
+    `${RPG_AGENT_API_BASE}/${encodeURIComponent(sessionId)}/operations/${encodeURIComponent(operationId)}`,
+    {
+      method: 'GET',
+    },
+    '读取共创操作状态失败',
+  );
+
+  return (response.operation ?? response.data ?? response) as RpgAgentOperationRecord;
+}
+
+export async function getRpgCreationCardDetail(
+  sessionId: string,
+  cardId: string,
+) {
+  const response = await requestRpgCreationRuntimeJson<GetRpgAgentCardDetailResponse>(
+    `${RPG_AGENT_API_BASE}/${encodeURIComponent(sessionId)}/cards/${encodeURIComponent(cardId)}`,
+    {
+      method: 'GET',
+    },
+    '读取草稿卡详情失败',
+  );
+
+  return response.card as RpgAgentDraftCardDetail;
+}
 
 /**
- * 工作包 A 先把 RPG 创作 Agent 请求聚合到独立 client 命名空间。
- * 当前仍直接透传旧实现，后续工作包 D 再逐步把 `aiService.ts` 中的相关接口迁出。
+ * 工作包 D 开始让 RPG 创作 Agent client 持有真实请求实现，
+ * 旧 `aiService.ts` 仅保留兼容导出，避免主链请求继续回流到通用服务文件。
  */
 export const rpgCreationAgentClient = {
-  createSession: createCustomWorldAgentSession,
-  getSession: getCustomWorldAgentSession,
-  sendMessage: sendCustomWorldAgentMessage,
-  streamMessage: streamCustomWorldAgentMessage,
-  executeAction: executeCustomWorldAgentAction,
-  getOperation: getCustomWorldAgentOperation,
-  getCardDetail: getCustomWorldAgentCardDetail,
-};
-
-export {
-  createCustomWorldAgentSession as createRpgCreationSession,
-  executeCustomWorldAgentAction as executeRpgCreationAction,
-  getCustomWorldAgentCardDetail as getRpgCreationCardDetail,
-  getCustomWorldAgentOperation as getRpgCreationOperation,
-  getCustomWorldAgentSession as getRpgCreationSession,
-  sendCustomWorldAgentMessage as sendRpgCreationMessage,
-  streamCustomWorldAgentMessage as streamRpgCreationMessage,
+  createSession: createRpgCreationSession,
+  getSession: getRpgCreationSession,
+  sendMessage: sendRpgCreationMessage,
+  streamMessage: streamRpgCreationMessage,
+  executeAction: executeRpgCreationAction,
+  getOperation: getRpgCreationOperation,
+  getCardDetail: getRpgCreationCardDetail,
 };
diff --git a/src/services/rpg-creation/rpgCreationAssetClient.ts b/src/services/rpg-creation/rpgCreationAssetClient.ts
index c8d47c59..0e6552b4 100644
--- a/src/services/rpg-creation/rpgCreationAssetClient.ts
+++ b/src/services/rpg-creation/rpgCreationAssetClient.ts
@@ -1,35 +1,116 @@
-import {
-  generateCustomWorldLandmark,
-  generateCustomWorldPlayableNpc,
-  generateCustomWorldSceneImage,
-  generateCustomWorldSceneNpc,
-  generateCustomWorldStoryNpc,
-} from '../aiService';
+import type { CustomWorldSceneImageRequest, CustomWorldSceneImageResult } from '../aiTypes';
 import {
   generateCustomWorldCoverImage,
   uploadCustomWorldCoverImage,
 } from '../customWorldCoverAssetService';
+import { requestJson } from '../apiClient';
+import type {
+  CustomWorldLandmark,
+  CustomWorldNpc,
+  CustomWorldPlayableNpc,
+  CustomWorldProfile,
+} from '../../types';
+import { requestRpgCreationPostJson } from './rpgCreationRequestHelpers';
+
+const RPG_CREATION_ASSET_API_BASE = '/api/custom-world';
+
+export async function generateRpgWorldSceneImage(
+  payload: CustomWorldSceneImageRequest,
+) {
+  return requestJson<CustomWorldSceneImageResult>(
+    `${RPG_CREATION_ASSET_API_BASE}/scene-image`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '生成自定义世界场景图失败',
+  );
+}
+
+export async function generateRpgWorldSceneNpc(payload: {
+  profile: CustomWorldProfile;
+  landmarkId: string;
+}) {
+  const response = await requestRpgCreationPostJson<{ npc: CustomWorldNpc }>(
+    `${RPG_CREATION_ASSET_API_BASE}/scene-npc`,
+    payload,
+    '生成场景 NPC 失败',
+  );
+
+  return response.npc;
+}
+
+async function requestRpgWorldEntity<T>(
+  payload: {
+    profile: CustomWorldProfile;
+    kind: 'playable' | 'story' | 'landmark';
+  },
+  fallbackMessage: string,
+) {
+  return requestRpgCreationPostJson<{
+    kind: 'playable' | 'story' | 'landmark';
+    entity: T;
+  }>(`${RPG_CREATION_ASSET_API_BASE}/entity`, payload, fallbackMessage);
+}
+
+export async function generateRpgWorldPlayableNpc(payload: {
+  profile: CustomWorldProfile;
+}) {
+  const response = await requestRpgWorldEntity<CustomWorldPlayableNpc>(
+    {
+      ...payload,
+      kind: 'playable',
+    },
+    '生成可扮演角色失败',
+  );
+
+  return response.entity;
+}
+
+export async function generateRpgWorldStoryNpc(payload: {
+  profile: CustomWorldProfile;
+}) {
+  const response = await requestRpgWorldEntity<CustomWorldNpc>(
+    {
+      ...payload,
+      kind: 'story',
+    },
+    '生成场景角色失败',
+  );
+
+  return response.entity;
+}
+
+export async function generateRpgWorldLandmark(payload: {
+  profile: CustomWorldProfile;
+}) {
+  const response = await requestRpgWorldEntity<CustomWorldLandmark>(
+    {
+      ...payload,
+      kind: 'landmark',
+    },
+    '生成场景失败',
+  );
+
+  return response.entity;
+}
 
 /**
- * 工作包 A 先把 RPG 创作资产相关请求收口到独立 client。
- * 当前仍桥接旧接口，后续工作包 C、D 会继续细分角色资产、场景资产和封面资产职责。
+ * 工作包 D 把结果页与编辑器依赖的资产请求迁入 RPG 创作域 client，
+ * 保留封面资产服务的既有边界，不把逻辑重新塞回 `aiService.ts`。
  */
 export const rpgCreationAssetClient = {
-  generateSceneImage: generateCustomWorldSceneImage,
-  generateSceneNpc: generateCustomWorldSceneNpc,
-  generatePlayableNpc: generateCustomWorldPlayableNpc,
-  generateStoryNpc: generateCustomWorldStoryNpc,
-  generateLandmark: generateCustomWorldLandmark,
+  generateSceneImage: generateRpgWorldSceneImage,
+  generateSceneNpc: generateRpgWorldSceneNpc,
+  generatePlayableNpc: generateRpgWorldPlayableNpc,
+  generateStoryNpc: generateRpgWorldStoryNpc,
+  generateLandmark: generateRpgWorldLandmark,
   generateCoverImage: generateCustomWorldCoverImage,
   uploadCoverImage: uploadCustomWorldCoverImage,
 };
 
 export {
   generateCustomWorldCoverImage as generateRpgWorldCoverImage,
-  generateCustomWorldLandmark as generateRpgWorldLandmark,
-  generateCustomWorldPlayableNpc as generateRpgWorldPlayableNpc,
-  generateCustomWorldSceneImage as generateRpgWorldSceneImage,
-  generateCustomWorldSceneNpc as generateRpgWorldSceneNpc,
-  generateCustomWorldStoryNpc as generateRpgWorldStoryNpc,
   uploadCustomWorldCoverImage as uploadRpgWorldCoverImage,
 };
diff --git a/src/services/rpg-creation/rpgCreationGenerationClient.test.ts b/src/services/rpg-creation/rpgCreationGenerationClient.test.ts
new file mode 100644
index 00000000..eeb13730
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationGenerationClient.test.ts
@@ -0,0 +1,54 @@
+/* @vitest-environment jsdom */
+
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const { requestJsonMock } = vi.hoisted(() => ({
+  requestJsonMock: vi.fn(),
+}));
+
+import { generateRpgWorldProfile } from './rpgCreationGenerationClient';
+
+vi.mock('../apiClient', () => ({
+  requestJson: requestJsonMock,
+}));
+
+describe('rpgCreationGenerationClient', () => {
+  beforeEach(() => {
+    requestJsonMock.mockReset();
+    requestJsonMock.mockResolvedValue({
+      id: 'custom-world-1',
+      name: '测试世界',
+      subtitle: '副标题',
+      summary: '概述',
+      tone: '基调',
+      playerGoal: '目标',
+      settingText: '设定',
+    });
+  });
+
+  it('posts world generation to the runtime custom world profile route', async () => {
+    await generateRpgWorldProfile('一个被灵潮反复改写地形的边境世界');
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/custom-world/profile',
+      expect.objectContaining({
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+      }),
+      '生成自定义世界失败',
+    );
+  });
+
+  it('rejects immediately when the caller aborts before sending', async () => {
+    const controller = new AbortController();
+    controller.abort(new Error('手动中断生成'));
+
+    await expect(
+      generateRpgWorldProfile('一个会被中断的世界', {
+        signal: controller.signal,
+      }),
+    ).rejects.toThrow('手动中断生成');
+
+    expect(requestJsonMock).not.toHaveBeenCalled();
+  });
+});
diff --git a/src/services/rpg-creation/rpgCreationGenerationClient.ts b/src/services/rpg-creation/rpgCreationGenerationClient.ts
new file mode 100644
index 00000000..ce2a8bc8
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationGenerationClient.ts
@@ -0,0 +1,68 @@
+import type {
+  CustomWorldGenerationProgress,
+  GenerateCustomWorldProfileInput,
+  GenerateCustomWorldProfileOptions,
+} from '../../../packages/shared/src/contracts/runtime';
+import type { CustomWorldProfile } from '../../types';
+import { requestJson } from '../apiClient';
+
+type LegacyAiModule = typeof import('../ai');
+
+let legacyAiModulePromise: Promise<LegacyAiModule> | null = null;
+
+async function loadLegacyAiModule() {
+  if (!legacyAiModulePromise) {
+    legacyAiModulePromise = import('../ai');
+  }
+
+  return legacyAiModulePromise;
+}
+
+export async function generateRpgWorldProfile(
+  input: GenerateCustomWorldProfileInput | string,
+  options: GenerateCustomWorldProfileOptions = {},
+): Promise<CustomWorldProfile> {
+  const normalizedInput =
+    typeof input === 'string'
+      ? {
+          settingText: input,
+        }
+      : input;
+
+  if (typeof window === 'undefined') {
+    const aiClient = await loadLegacyAiModule();
+    return aiClient.generateCustomWorldProfile(normalizedInput, options);
+  }
+
+  if (options.signal?.aborted) {
+    throw options.signal.reason instanceof Error
+      ? options.signal.reason
+      : new Error('世界生成已中断。');
+  }
+
+  const profile = await requestJson<CustomWorldProfile>(
+    '/api/runtime/custom-world/profile',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(normalizedInput),
+    },
+    '生成自定义世界失败',
+  );
+
+  if (options.signal?.aborted) {
+    throw options.signal.reason instanceof Error
+      ? options.signal.reason
+      : new Error('世界生成已中断。');
+  }
+
+  return profile;
+}
+
+export type {
+  CustomWorldGenerationProgress,
+  GenerateCustomWorldProfileInput,
+  GenerateCustomWorldProfileOptions,
+};
+
+export { generateRpgWorldProfile as generateCustomWorldProfile };
diff --git a/src/services/rpg-creation/rpgCreationLibraryClient.ts b/src/services/rpg-creation/rpgCreationLibraryClient.ts
index 56aa2b9b..f49ff078 100644
--- a/src/services/rpg-creation/rpgCreationLibraryClient.ts
+++ b/src/services/rpg-creation/rpgCreationLibraryClient.ts
@@ -1,33 +1,150 @@
+import type {
+  CustomWorldGalleryDetailResponse,
+  CustomWorldGalleryResponse,
+  CustomWorldLibraryMutationResponse,
+  CustomWorldLibraryResponse,
+} from '../../../packages/shared/src/contracts/runtime';
+import type { CustomWorldProfile } from '../../types';
 import {
-  deleteCustomWorldProfile,
-  getCustomWorldGalleryDetail,
-  listCustomWorldGallery,
-  listCustomWorldLibrary,
-  publishCustomWorldProfile,
-  unpublishCustomWorldProfile,
-  upsertCustomWorldProfile,
-} from '../storageService';
+  requestPublicRpgCreationRuntimeJson,
+  requestRpgCreationRuntimeJson,
+  type RpgCreationRuntimeRequestOptions,
+} from './rpgCreationRuntimeClient';
+
+export async function listRpgWorldLibrary(
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  const response = await requestRpgCreationRuntimeJson<
+    CustomWorldLibraryResponse<CustomWorldProfile>
+  >(
+    '/custom-world-library',
+    { method: 'GET' },
+    '读取自定义世界库失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function upsertRpgWorldProfile(
+  profile: CustomWorldProfile,
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  const response = await requestRpgCreationRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
+    `/custom-world-library/${encodeURIComponent(profile.id)}`,
+    {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        profile,
+      }),
+    },
+    '保存自定义世界失败',
+    options,
+  );
+
+  return {
+    entry: response.entry,
+    entries: Array.isArray(response?.entries) ? response.entries : [],
+  };
+}
+
+export async function deleteRpgWorldProfile(
+  profileId: string,
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  const response = await requestRpgCreationRuntimeJson<
+    CustomWorldLibraryResponse<CustomWorldProfile>
+  >(
+    `/custom-world-library/${encodeURIComponent(profileId)}`,
+    { method: 'DELETE' },
+    '删除自定义世界失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function publishRpgWorldProfile(
+  profileId: string,
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  const response = await requestRpgCreationRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
+    `/custom-world-library/${encodeURIComponent(profileId)}/publish`,
+    { method: 'POST' },
+    '发布自定义世界失败',
+    options,
+  );
+
+  return {
+    entry: response.entry,
+    entries: Array.isArray(response?.entries) ? response.entries : [],
+  };
+}
+
+export async function unpublishRpgWorldProfile(
+  profileId: string,
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  const response = await requestRpgCreationRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
+    `/custom-world-library/${encodeURIComponent(profileId)}/unpublish`,
+    { method: 'POST' },
+    '下架自定义世界失败',
+    options,
+  );
+
+  return {
+    entry: response.entry,
+    entries: Array.isArray(response?.entries) ? response.entries : [],
+  };
+}
+
+export async function listRpgWorldGallery(
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  const response = await requestPublicRpgCreationRuntimeJson<CustomWorldGalleryResponse>(
+    '/custom-world-gallery',
+    { method: 'GET' },
+    '读取作品广场失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function getRpgWorldGalleryDetail(
+  ownerUserId: string,
+  profileId: string,
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  const response = await requestPublicRpgCreationRuntimeJson<
+    CustomWorldGalleryDetailResponse<CustomWorldProfile>
+  >(
+    `/custom-world-gallery/${encodeURIComponent(ownerUserId)}/${encodeURIComponent(profileId)}`,
+    { method: 'GET' },
+    '读取作品详情失败',
+    options,
+  );
+
+  return response.entry;
+}
 
 /**
- * 工作包 A 先建立 RPG 世界作品库和广场相关请求的统一入口。
- * 当前实现仍透传旧 `storageService.ts`，后续工作包 D 会把作品链路彻底迁入这里。
+ * 工作包 D 把作品库与作品广场请求迁入 RPG 创作域 client，
+ * 后续前端调用优先从这里进入，不再反向依赖通用存储聚合层。
  */
 export const rpgCreationLibraryClient = {
-  listLibrary: listCustomWorldLibrary,
-  upsertProfile: upsertCustomWorldProfile,
-  deleteProfile: deleteCustomWorldProfile,
-  publishProfile: publishCustomWorldProfile,
-  unpublishProfile: unpublishCustomWorldProfile,
-  listGallery: listCustomWorldGallery,
-  getGalleryDetail: getCustomWorldGalleryDetail,
-};
-
-export {
-  deleteCustomWorldProfile as deleteRpgWorldProfile,
-  getCustomWorldGalleryDetail as getRpgWorldGalleryDetail,
-  listCustomWorldGallery as listRpgWorldGallery,
-  listCustomWorldLibrary as listRpgWorldLibrary,
-  publishCustomWorldProfile as publishRpgWorldProfile,
-  unpublishCustomWorldProfile as unpublishRpgWorldProfile,
-  upsertCustomWorldProfile as upsertRpgWorldProfile,
+  listLibrary: listRpgWorldLibrary,
+  upsertProfile: upsertRpgWorldProfile,
+  deleteProfile: deleteRpgWorldProfile,
+  publishProfile: publishRpgWorldProfile,
+  unpublishProfile: unpublishRpgWorldProfile,
+  listGallery: listRpgWorldGallery,
+  getGalleryDetail: getRpgWorldGalleryDetail,
 };
diff --git a/src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts b/src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts
new file mode 100644
index 00000000..7d5ad79d
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationPreviewAdapter.test.ts
@@ -0,0 +1,121 @@
+import { expect, test } from 'vitest';
+
+import type { CustomWorldAgentSessionSnapshot } from '../../../packages/shared/src/contracts/customWorldAgent';
+import {
+  buildRpgCreationPreviewFromResultPreview,
+  buildRpgCreationPreviewFromSession,
+} from './rpgCreationPreviewAdapter';
+
+const sessionWithPreview: CustomWorldAgentSessionSnapshot = {
+  sessionId: 'session-preview-1',
+  currentTurn: 3,
+  anchorContent: {
+    worldPromise: null,
+    playerFantasy: null,
+    themeBoundary: null,
+    playerEntryPoint: null,
+    coreConflict: null,
+    keyRelationships: [],
+    hiddenLines: null,
+    iconicElements: null,
+  },
+  progressPercent: 100,
+  lastAssistantReply: '第一版世界底稿已经准备好了。',
+  stage: 'object_refining',
+  focusCardId: null,
+  creatorIntent: null,
+  creatorIntentReadiness: {
+    isReady: true,
+    completedKeys: [],
+    missingKeys: [],
+  },
+  anchorPack: null,
+  lockState: null,
+  draftProfile: {
+    name: '只作为 fallback 的本地草稿名',
+    subtitle: 'fallback',
+    summary: 'fallback',
+    tone: 'fallback',
+    playerGoal: 'fallback',
+    playableNpcs: [],
+    storyNpcs: [],
+    landmarks: [],
+  },
+  messages: [],
+  draftCards: [
+    {
+      id: 'world-foundation',
+      kind: 'world',
+      title: '世界底稿',
+      subtitle: '阶段三预览',
+      summary: '测试服务端 result preview 优先级。',
+      status: 'warning',
+      linkedIds: [],
+      warningCount: 0,
+    },
+  ],
+  pendingClarifications: [],
+  suggestedActions: [],
+  recommendedReplies: [],
+  qualityFindings: [],
+  assetCoverage: {
+    roleAssets: [],
+    sceneAssets: [],
+    allRoleAssetsReady: false,
+    allSceneAssetsReady: false,
+  },
+  resultPreview: {
+    source: 'session_preview',
+    preview: {
+      id: 'preview-profile-1',
+      settingText: '被海雾吞没的旧航路群岛',
+      name: '服务端结果预览',
+      subtitle: '优先于前端 fallback',
+      summary: '结果页应该优先消费 session.resultPreview。',
+      tone: '压抑、潮湿、悬疑',
+      playerGoal: '查清沉船与禁航区异动的真相。',
+      templateWorldType: 'WUXIA',
+      majorFactions: ['守灯会', '航运公会'],
+      coreConflicts: ['守灯会与航运公会争夺旧航路控制权'],
+      playableNpcs: [],
+      storyNpcs: [],
+      items: [],
+      landmarks: [],
+      generationMode: 'full',
+      generationStatus: 'complete',
+      sessionId: 'session-preview-1',
+    },
+    generatedAt: '2026-04-21T10:00:00.000Z',
+    qualityFindings: [],
+    blockers: [],
+  },
+  updatedAt: '2026-04-21T10:00:00.000Z',
+};
+
+test('buildRpgCreationPreviewFromResultPreview normalizes server preview envelope', () => {
+  const profile = buildRpgCreationPreviewFromResultPreview(
+    sessionWithPreview.resultPreview,
+  );
+
+  expect(profile?.name).toBe('服务端结果预览');
+  expect(profile?.subtitle).toBe('优先于前端 fallback');
+  expect(profile?.id).toBe('preview-profile-1');
+  expect(profile?.settingText).toBe('被海雾吞没的旧航路群岛');
+});
+
+test('buildRpgCreationPreviewFromSession prefers server resultPreview over draft fallback', () => {
+  const profile = buildRpgCreationPreviewFromSession(sessionWithPreview);
+
+  expect(profile?.name).toBe('服务端结果预览');
+  expect(profile?.name).not.toBe('只作为 fallback 的本地草稿名');
+  expect(profile?.summary).toBe('结果页应该优先消费 session.resultPreview。');
+});
+
+test('buildRpgCreationPreviewFromSession returns null when server resultPreview is missing', () => {
+  const profile = buildRpgCreationPreviewFromSession({
+    ...sessionWithPreview,
+    resultPreview: null,
+  });
+
+  expect(profile).toBeNull();
+});
diff --git a/src/services/rpg-creation/rpgCreationPreviewAdapter.ts b/src/services/rpg-creation/rpgCreationPreviewAdapter.ts
index c33c2527..da13ac36 100644
--- a/src/services/rpg-creation/rpgCreationPreviewAdapter.ts
+++ b/src/services/rpg-creation/rpgCreationPreviewAdapter.ts
@@ -1,13 +1,39 @@
-import { buildCustomWorldProfileFromAgentDraft } from '../customWorldAgentDraftResult';
+import type { CustomWorldAgentSessionSnapshot } from '../../../packages/shared/src/contracts/customWorldAgent';
+import { normalizeCustomWorldProfileRecord } from '../../data/customWorldLibrary';
+import type { CustomWorldProfile } from '../../types';
+
+/**
+ * Phase 5 起结果页只消费服务端回传的 result preview。
+ * 前端不再承担 session draft -> runtime profile 的本地兼容编译职责。
+ */
+export function buildCustomWorldProfileFromResultPreview(
+  resultPreview: CustomWorldAgentSessionSnapshot['resultPreview'] | null | undefined,
+): CustomWorldProfile | null {
+  return normalizeCustomWorldProfileRecord(resultPreview?.preview ?? null);
+}
+
+/**
+ * 统一“从 session 取结果页 profile”的主入口。
+ * Phase 5 后主链没有 preview 就视为服务端未准备完成，而不是继续做前端本地编译。
+ */
+export function buildCustomWorldProfileFromAgentSession(
+  session: CustomWorldAgentSessionSnapshot | null | undefined,
+): CustomWorldProfile | null {
+  return buildCustomWorldProfileFromResultPreview(session?.resultPreview);
+}
 
 /**
  * 这是工作包 A 提供的新命名兼容层。
- * 当前仍复用旧的前端草稿编译逻辑，后续 Phase 3 会继续把结果预览编译后移到服务端。
+ * Phase 3 后该适配层只负责：
+ * 1. 把服务端 resultPreview 转成前端 view model
+ * 2. 保持前端 session 读模型入口稳定
  */
 export const rpgCreationPreviewAdapter = {
-  buildPreviewFromAgentDraft: buildCustomWorldProfileFromAgentDraft,
+  buildPreviewFromSession: buildCustomWorldProfileFromAgentSession,
+  buildPreviewFromResultPreview: buildCustomWorldProfileFromResultPreview,
 };
 
 export {
-  buildCustomWorldProfileFromAgentDraft as buildRpgCreationPreviewFromAgentDraft,
+  buildCustomWorldProfileFromAgentSession as buildRpgCreationPreviewFromSession,
+  buildCustomWorldProfileFromResultPreview as buildRpgCreationPreviewFromResultPreview,
 };
diff --git a/src/services/rpg-creation/rpgCreationRequestHelpers.ts b/src/services/rpg-creation/rpgCreationRequestHelpers.ts
new file mode 100644
index 00000000..ba4a1678
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationRequestHelpers.ts
@@ -0,0 +1,41 @@
+import { parseApiErrorMessage } from '../../../packages/shared/src/http';
+import { fetchWithApiAuth, requestJson } from '../apiClient';
+
+export async function requestRpgCreationPostJson<T>(
+  url: string,
+  payload: unknown,
+  fallbackMessage: string,
+) {
+  return requestJson<T>(
+    url,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    fallbackMessage,
+  );
+}
+
+export async function openRpgCreationSsePost(
+  url: string,
+  payload: unknown,
+  fallbackMessage: string,
+) {
+  const response = await fetchWithApiAuth(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+  });
+
+  if (!response.ok) {
+    const responseText = await response.text();
+    throw new Error(parseApiErrorMessage(responseText, fallbackMessage));
+  }
+
+  if (!response.body) {
+    throw new Error('streaming response body is unavailable');
+  }
+
+  return response;
+}
diff --git a/src/services/rpg-creation/rpgCreationRuntimeClient.ts b/src/services/rpg-creation/rpgCreationRuntimeClient.ts
new file mode 100644
index 00000000..e5d5f68c
--- /dev/null
+++ b/src/services/rpg-creation/rpgCreationRuntimeClient.ts
@@ -0,0 +1,60 @@
+import { type ApiRetryOptions, requestJson } from '../apiClient';
+
+const RUNTIME_API_BASE = '/api/runtime';
+const RUNTIME_READ_RETRY: ApiRetryOptions = {
+  maxRetries: 1,
+  baseDelayMs: 180,
+  maxDelayMs: 480,
+};
+const RUNTIME_WRITE_RETRY: ApiRetryOptions = {
+  maxRetries: 1,
+  baseDelayMs: 240,
+  maxDelayMs: 640,
+  retryUnsafeMethods: true,
+};
+
+export type RpgCreationRuntimeRequestOptions = {
+  signal?: AbortSignal;
+  retry?: ApiRetryOptions;
+  skipAuth?: boolean;
+  skipRefresh?: boolean;
+};
+
+export function requestRpgCreationRuntimeJson<T>(
+  path: string,
+  init: RequestInit,
+  fallbackMessage: string,
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  const method = (init.method ?? 'GET').toUpperCase();
+  const retry =
+    options.retry ??
+    (method === 'GET' ? RUNTIME_READ_RETRY : RUNTIME_WRITE_RETRY);
+
+  return requestJson<T>(
+    `${RUNTIME_API_BASE}${path}`,
+    {
+      ...init,
+      signal: options.signal,
+    },
+    fallbackMessage,
+    {
+      retry,
+      skipAuth: options.skipAuth,
+      skipRefresh: options.skipRefresh,
+    },
+  );
+}
+
+export function requestPublicRpgCreationRuntimeJson<T>(
+  path: string,
+  init: RequestInit,
+  fallbackMessage: string,
+  options: RpgCreationRuntimeRequestOptions = {},
+) {
+  return requestRpgCreationRuntimeJson<T>(path, init, fallbackMessage, {
+    ...options,
+    skipAuth: true,
+    skipRefresh: true,
+  });
+}
diff --git a/src/services/rpg-creation/rpgCreationWorkClient.ts b/src/services/rpg-creation/rpgCreationWorkClient.ts
index 0f023dd1..97ab9d6d 100644
--- a/src/services/rpg-creation/rpgCreationWorkClient.ts
+++ b/src/services/rpg-creation/rpgCreationWorkClient.ts
@@ -1,11 +1,19 @@
-import { listCustomWorldWorks } from '../storageService';
+import type { ListRpgCreationWorksResponse } from '../../../packages/shared/src';
+import { requestRpgCreationRuntimeJson } from './rpgCreationRuntimeClient';
+
+export async function listRpgCreationWorks() {
+  const response = await requestRpgCreationRuntimeJson<ListRpgCreationWorksResponse>(
+    '/custom-world/works',
+    { method: 'GET' },
+    '读取创作作品列表失败',
+  );
+
+  return Array.isArray(response?.items) ? response.items : [];
+}
 
 /**
- * 工作包 A 先建立 RPG 创作作品流的独立 client。
- * 当前作品列表仍复用旧存储服务，后续工作包 D 再切出真正的专属请求实现。
+ * 工作包 D 把作品列表请求正式迁入 RPG 创作域 client。
  */
 export const rpgCreationWorkClient = {
-  listWorks: listCustomWorldWorks,
+  listWorks: listRpgCreationWorks,
 };
-
-export { listCustomWorldWorks as listRpgCreationWorks };
diff --git a/src/services/rpg-entry/index.ts b/src/services/rpg-entry/index.ts
new file mode 100644
index 00000000..92378a56
--- /dev/null
+++ b/src/services/rpg-entry/index.ts
@@ -0,0 +1,25 @@
+export {
+  deleteRpgEntryWorldProfile,
+  getRpgEntryWorldGalleryDetail,
+  listRpgEntryWorldGallery,
+  listRpgEntryWorldLibrary,
+  publishRpgEntryWorldProfile,
+  rpgEntryLibraryClient,
+  type RuntimeRequestOptions,
+  unpublishRpgEntryWorldProfile,
+  upsertRpgEntryWorldProfile,
+} from './rpgEntryLibraryClient';
+export {
+  clearRpgProfileBrowseHistory,
+  getRpgProfileDashboard,
+  getRpgProfilePlayStats,
+  getRpgProfileSettings,
+  getRpgProfileWalletLedger,
+  listRpgProfileBrowseHistory,
+  listRpgProfileSaveArchives,
+  putRpgProfileSettings,
+  resumeRpgProfileSaveArchive,
+  rpgProfileClient,
+  syncRpgProfileBrowseHistory,
+  upsertRpgProfileBrowseHistory,
+} from './rpgProfileClient';
diff --git a/src/services/storageService.test.ts b/src/services/rpg-entry/rpgEntryClients.routing.test.ts
similarity index 84%
rename from src/services/storageService.test.ts
rename to src/services/rpg-entry/rpgEntryClients.routing.test.ts
index 41a4479d..2e6d3a43 100644
--- a/src/services/storageService.test.ts
+++ b/src/services/rpg-entry/rpgEntryClients.routing.test.ts
@@ -5,28 +5,30 @@ const { requestJsonMock } = vi.hoisted(() => ({
 }));
 
 import {
-  clearProfileBrowseHistory,
-  getCustomWorldGalleryDetail,
-  listCustomWorldGallery,
-  listProfileBrowseHistory,
-  listProfileSaveArchives,
-  resumeProfileSaveArchive,
-  syncProfileBrowseHistory,
-  upsertProfileBrowseHistory,
-} from './storageService';
+  clearRpgProfileBrowseHistory,
+  listRpgProfileBrowseHistory,
+  listRpgProfileSaveArchives,
+  resumeRpgProfileSaveArchive,
+  syncRpgProfileBrowseHistory,
+  upsertRpgProfileBrowseHistory,
+} from './rpgProfileClient';
+import {
+  getRpgEntryWorldGalleryDetail,
+  listRpgEntryWorldGallery,
+} from './rpgEntryLibraryClient';
 
-vi.mock('./apiClient', () => ({
+vi.mock('../apiClient', () => ({
   requestJson: requestJsonMock,
 }));
 
-describe('storageService browse history routes', () => {
+describe('rpgEntry profile browse history routes', () => {
   beforeEach(() => {
     requestJsonMock.mockReset();
     requestJsonMock.mockResolvedValue({ entries: [] });
   });
 
   it('reads browse history from the runtime profile route', async () => {
-    await listProfileBrowseHistory();
+    await listRpgProfileBrowseHistory();
 
     expect(requestJsonMock).toHaveBeenCalledWith(
       '/api/runtime/profile/browse-history',
@@ -39,7 +41,7 @@ describe('storageService browse history routes', () => {
   });
 
   it('writes browse history through the runtime profile route', async () => {
-    await upsertProfileBrowseHistory({
+    await upsertRpgProfileBrowseHistory({
       ownerUserId: 'user-1',
       profileId: 'profile-1',
       worldName: '测试世界',
@@ -67,7 +69,7 @@ describe('storageService browse history routes', () => {
   });
 
   it('syncs browse history through the runtime profile route', async () => {
-    await syncProfileBrowseHistory([
+    await syncRpgProfileBrowseHistory([
       {
         ownerUserId: 'user-1',
         profileId: 'profile-1',
@@ -92,7 +94,7 @@ describe('storageService browse history routes', () => {
   });
 
   it('clears browse history through the runtime profile route', async () => {
-    await clearProfileBrowseHistory();
+    await clearRpgProfileBrowseHistory();
 
     expect(requestJsonMock).toHaveBeenCalledWith(
       '/api/runtime/profile/browse-history',
@@ -108,14 +110,14 @@ describe('storageService browse history routes', () => {
   });
 });
 
-describe('storageService public custom world gallery routes', () => {
+describe('rpgEntry public custom world gallery routes', () => {
   beforeEach(() => {
     requestJsonMock.mockReset();
     requestJsonMock.mockResolvedValue({ entries: [] });
   });
 
   it('reads the public gallery without attaching auth or refresh coupling', async () => {
-    await listCustomWorldGallery();
+    await listRpgEntryWorldGallery();
 
     expect(requestJsonMock).toHaveBeenCalledWith(
       '/api/runtime/custom-world-gallery',
@@ -137,7 +139,7 @@ describe('storageService public custom world gallery routes', () => {
       },
     });
 
-    await getCustomWorldGalleryDetail('user-1', 'profile-1');
+    await getRpgEntryWorldGalleryDetail('user-1', 'profile-1');
 
     expect(requestJsonMock).toHaveBeenCalledWith(
       '/api/runtime/custom-world-gallery/user-1/profile-1',
@@ -152,14 +154,14 @@ describe('storageService public custom world gallery routes', () => {
   });
 });
 
-describe('storageService save archive routes', () => {
+describe('rpgEntry save archive routes', () => {
   beforeEach(() => {
     requestJsonMock.mockReset();
     requestJsonMock.mockResolvedValue({ entries: [] });
   });
 
   it('reads save archives from the runtime profile route', async () => {
-    await listProfileSaveArchives();
+    await listRpgProfileSaveArchives();
 
     expect(requestJsonMock).toHaveBeenCalledWith(
       '/api/runtime/profile/save-archives',
@@ -187,7 +189,7 @@ describe('storageService save archive routes', () => {
       },
     });
 
-    await resumeProfileSaveArchive('custom:world-1');
+    await resumeRpgProfileSaveArchive('custom:world-1');
 
     expect(requestJsonMock).toHaveBeenCalledWith(
       '/api/runtime/profile/save-archives/custom%3Aworld-1',
diff --git a/src/services/rpg-entry/rpgEntryLibraryClient.test.ts b/src/services/rpg-entry/rpgEntryLibraryClient.test.ts
new file mode 100644
index 00000000..cae94dc0
--- /dev/null
+++ b/src/services/rpg-entry/rpgEntryLibraryClient.test.ts
@@ -0,0 +1,165 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const { requestJsonMock } = vi.hoisted(() => ({
+  requestJsonMock: vi.fn(),
+}));
+
+import {
+  deleteRpgEntryWorldProfile,
+  getRpgEntryWorldGalleryDetail,
+  listRpgEntryWorldGallery,
+  listRpgEntryWorldLibrary,
+  publishRpgEntryWorldProfile,
+  unpublishRpgEntryWorldProfile,
+  upsertRpgEntryWorldProfile,
+} from './rpgEntryLibraryClient';
+
+vi.mock('../apiClient', () => ({
+  requestJson: requestJsonMock,
+}));
+
+describe('rpgEntryLibraryClient world library routes', () => {
+  beforeEach(() => {
+    requestJsonMock.mockReset();
+    requestJsonMock.mockResolvedValue({ entries: [] });
+  });
+
+  it('reads world library from the runtime entry route', async () => {
+    await listRpgEntryWorldLibrary();
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/custom-world-library',
+      expect.objectContaining({ method: 'GET' }),
+      '读取自定义世界库失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({ maxRetries: 1 }),
+      }),
+    );
+  });
+
+  it('reads world gallery from the public runtime entry route', async () => {
+    await listRpgEntryWorldGallery();
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/custom-world-gallery',
+      expect.objectContaining({ method: 'GET' }),
+      '读取作品广场失败',
+      expect.objectContaining({
+        skipAuth: true,
+        skipRefresh: true,
+      }),
+    );
+  });
+
+  it('reads gallery detail from the public runtime entry route', async () => {
+    requestJsonMock.mockResolvedValueOnce({
+      entry: {
+        ownerUserId: 'owner-1',
+        profileId: 'profile-1',
+      },
+    });
+
+    await getRpgEntryWorldGalleryDetail('owner-1', 'profile-1');
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/custom-world-gallery/owner-1/profile-1',
+      expect.objectContaining({ method: 'GET' }),
+      '读取作品详情失败',
+      expect.objectContaining({
+        skipAuth: true,
+        skipRefresh: true,
+      }),
+    );
+  });
+
+  it('writes world profile through the runtime entry route', async () => {
+    requestJsonMock.mockResolvedValueOnce({
+      entry: {
+        profileId: 'profile-1',
+      },
+      entries: [],
+    });
+
+    await upsertRpgEntryWorldProfile({
+      id: 'profile-1',
+      name: '测试世界',
+    } as never);
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/custom-world-library/profile-1',
+      expect.objectContaining({
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+      }),
+      '保存自定义世界失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+
+  it('deletes world profile through the runtime entry route', async () => {
+    await deleteRpgEntryWorldProfile('profile-1');
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/custom-world-library/profile-1',
+      expect.objectContaining({ method: 'DELETE' }),
+      '删除自定义世界失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+
+  it('publishes world profile through the runtime entry route', async () => {
+    requestJsonMock.mockResolvedValueOnce({
+      entry: {
+        profileId: 'profile-1',
+      },
+      entries: [],
+    });
+
+    await publishRpgEntryWorldProfile('profile-1');
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/custom-world-library/profile-1/publish',
+      expect.objectContaining({ method: 'POST' }),
+      '发布自定义世界失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+
+  it('unpublishes world profile through the runtime entry route', async () => {
+    requestJsonMock.mockResolvedValueOnce({
+      entry: {
+        profileId: 'profile-1',
+      },
+      entries: [],
+    });
+
+    await unpublishRpgEntryWorldProfile('profile-1');
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/custom-world-library/profile-1/unpublish',
+      expect.objectContaining({ method: 'POST' }),
+      '下架自定义世界失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+});
diff --git a/src/services/rpg-entry/rpgEntryLibraryClient.ts b/src/services/rpg-entry/rpgEntryLibraryClient.ts
new file mode 100644
index 00000000..b69a5ef9
--- /dev/null
+++ b/src/services/rpg-entry/rpgEntryLibraryClient.ts
@@ -0,0 +1,152 @@
+import {
+  type RuntimeRequestOptions,
+  requestPublicRpgRuntimeJson,
+  requestRpgRuntimeJson,
+} from '../rpg-runtime/rpgRuntimeRequest';
+import type {
+  CustomWorldGalleryDetailResponse,
+  CustomWorldGalleryResponse,
+  CustomWorldLibraryMutationResponse,
+  CustomWorldLibraryResponse,
+} from '../../../packages/shared/src/contracts/runtime';
+import type { CustomWorldProfile } from '../../types';
+
+export type { RuntimeRequestOptions };
+
+/**
+ * RPG 入口世界库 client 的真实实现。
+ * 第三批收口后，平台首页/详情页开始游戏链直接走 rpg-entry 域请求，不再反向穿旧 storageService 兼容层。
+ */
+export async function listRpgEntryWorldLibrary(
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<
+    CustomWorldLibraryResponse<CustomWorldProfile>
+  >(
+    '/custom-world-library',
+    { method: 'GET' },
+    '读取自定义世界库失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function listRpgEntryWorldGallery(
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestPublicRpgRuntimeJson<CustomWorldGalleryResponse>(
+    '/custom-world-gallery',
+    { method: 'GET' },
+    '读取作品广场失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function getRpgEntryWorldGalleryDetail(
+  ownerUserId: string,
+  profileId: string,
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestPublicRpgRuntimeJson<
+    CustomWorldGalleryDetailResponse<CustomWorldProfile>
+  >(
+    `/custom-world-gallery/${encodeURIComponent(ownerUserId)}/${encodeURIComponent(profileId)}`,
+    { method: 'GET' },
+    '读取作品详情失败',
+    options,
+  );
+
+  return response.entry;
+}
+
+export async function upsertRpgEntryWorldProfile(
+  profile: CustomWorldProfile,
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
+    `/custom-world-library/${encodeURIComponent(profile.id)}`,
+    {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        profile,
+      }),
+    },
+    '保存自定义世界失败',
+    options,
+  );
+
+  return {
+    entry: response.entry,
+    entries: Array.isArray(response?.entries) ? response.entries : [],
+  };
+}
+
+export async function deleteRpgEntryWorldProfile(
+  profileId: string,
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<
+    CustomWorldLibraryResponse<CustomWorldProfile>
+  >(
+    `/custom-world-library/${encodeURIComponent(profileId)}`,
+    { method: 'DELETE' },
+    '删除自定义世界失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function publishRpgEntryWorldProfile(
+  profileId: string,
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
+    `/custom-world-library/${encodeURIComponent(profileId)}/publish`,
+    { method: 'POST' },
+    '发布自定义世界失败',
+    options,
+  );
+
+  return {
+    entry: response.entry,
+    entries: Array.isArray(response?.entries) ? response.entries : [],
+  };
+}
+
+export async function unpublishRpgEntryWorldProfile(
+  profileId: string,
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
+    `/custom-world-library/${encodeURIComponent(profileId)}/unpublish`,
+    { method: 'POST' },
+    '下架自定义世界失败',
+    options,
+  );
+
+  return {
+    entry: response.entry,
+    entries: Array.isArray(response?.entries) ? response.entries : [],
+  };
+}
+
+export const rpgEntryLibraryClient = {
+  listWorldLibrary: listRpgEntryWorldLibrary,
+  listWorldGallery: listRpgEntryWorldGallery,
+  getWorldGalleryDetail: getRpgEntryWorldGalleryDetail,
+  upsertWorldProfile: upsertRpgEntryWorldProfile,
+  deleteWorldProfile: deleteRpgEntryWorldProfile,
+  publishWorldProfile: publishRpgEntryWorldProfile,
+  unpublishWorldProfile: unpublishRpgEntryWorldProfile,
+};
diff --git a/src/services/rpg-entry/rpgProfileClient.test.ts b/src/services/rpg-entry/rpgProfileClient.test.ts
new file mode 100644
index 00000000..ab000601
--- /dev/null
+++ b/src/services/rpg-entry/rpgProfileClient.test.ts
@@ -0,0 +1,158 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const { requestJsonMock } = vi.hoisted(() => ({
+  requestJsonMock: vi.fn(),
+}));
+
+import {
+  clearRpgProfileBrowseHistory,
+  listRpgProfileBrowseHistory,
+  listRpgProfileSaveArchives,
+  resumeRpgProfileSaveArchive,
+  syncRpgProfileBrowseHistory,
+  upsertRpgProfileBrowseHistory,
+} from './rpgProfileClient';
+
+vi.mock('../apiClient', () => ({
+  requestJson: requestJsonMock,
+}));
+
+describe('rpgProfileClient browse history routes', () => {
+  beforeEach(() => {
+    requestJsonMock.mockReset();
+    requestJsonMock.mockResolvedValue({ entries: [] });
+  });
+
+  it('reads browse history from the runtime profile route', async () => {
+    await listRpgProfileBrowseHistory();
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/profile/browse-history',
+      expect.objectContaining({ method: 'GET' }),
+      '读取浏览历史失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({ maxRetries: 1 }),
+      }),
+    );
+  });
+
+  it('writes browse history through the runtime profile route', async () => {
+    await upsertRpgProfileBrowseHistory({
+      ownerUserId: 'user-1',
+      profileId: 'profile-1',
+      worldName: '测试世界',
+      subtitle: '测试副标题',
+      summaryText: '测试摘要',
+      coverImageSrc: null,
+      themeMode: 'mythic',
+      authorDisplayName: '测试作者',
+    });
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/profile/browse-history',
+      expect.objectContaining({
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+      }),
+      '写入浏览历史失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+
+  it('syncs browse history through the runtime profile route', async () => {
+    await syncRpgProfileBrowseHistory([
+      {
+        ownerUserId: 'user-1',
+        profileId: 'profile-1',
+        worldName: '测试世界',
+        subtitle: '测试副标题',
+        summaryText: '测试摘要',
+        coverImageSrc: null,
+        themeMode: 'mythic',
+        authorDisplayName: '测试作者',
+      },
+    ]);
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/profile/browse-history',
+      expect.objectContaining({
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+      }),
+      '同步浏览历史失败',
+      expect.any(Object),
+    );
+  });
+
+  it('clears browse history through the runtime profile route', async () => {
+    await clearRpgProfileBrowseHistory();
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/profile/browse-history',
+      expect.objectContaining({ method: 'DELETE' }),
+      '清空浏览历史失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+});
+
+describe('rpgProfileClient save archive routes', () => {
+  beforeEach(() => {
+    requestJsonMock.mockReset();
+    requestJsonMock.mockResolvedValue({ entries: [] });
+  });
+
+  it('reads save archives from the runtime profile route', async () => {
+    await listRpgProfileSaveArchives();
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/profile/save-archives',
+      expect.objectContaining({ method: 'GET' }),
+      '读取存档列表失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({ maxRetries: 1 }),
+      }),
+    );
+  });
+
+  it('resumes a save archive through the runtime profile route', async () => {
+    requestJsonMock.mockResolvedValueOnce({
+      entry: {
+        worldKey: 'custom:world-1',
+      },
+      snapshot: {
+        version: 2,
+        savedAt: '2026-04-19T10:15:00.000Z',
+        bottomTab: 'adventure',
+        currentStory: null,
+        gameState: {
+          worldType: 'CUSTOM',
+        },
+      },
+    });
+
+    await resumeRpgProfileSaveArchive('custom:world-1');
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/profile/save-archives/custom%3Aworld-1',
+      expect.objectContaining({ method: 'POST' }),
+      '恢复存档失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+});
diff --git a/src/services/rpg-entry/rpgProfileClient.ts b/src/services/rpg-entry/rpgProfileClient.ts
new file mode 100644
index 00000000..3035543d
--- /dev/null
+++ b/src/services/rpg-entry/rpgProfileClient.ts
@@ -0,0 +1,187 @@
+import type {
+  PlatformBrowseHistoryBatchSyncRequest,
+  PlatformBrowseHistoryResponse,
+  PlatformBrowseHistoryWriteEntry,
+  ProfileDashboardSummary,
+  ProfilePlayStatsResponse,
+  ProfileSaveArchiveListResponse,
+  ProfileSaveArchiveResumeResponse,
+  ProfileWalletLedgerResponse,
+  RuntimeSettings,
+} from '../../../packages/shared/src/contracts/runtime';
+import { rehydrateSavedSnapshot } from '../../persistence/runtimeSnapshot';
+import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
+import {
+  requestRpgRuntimeJson,
+  type RuntimeRequestOptions,
+} from '../rpg-runtime/rpgRuntimeRequest';
+
+export type { RuntimeRequestOptions };
+
+/**
+ * RPG profile 域 client。
+ * 工作包 C 需要把继续游戏归档与资料读取收进新域目录，避免继续堆在 `storageService`。
+ */
+export function getRpgProfileSettings(options: RuntimeRequestOptions = {}) {
+  return requestRpgRuntimeJson<RuntimeSettings>(
+    '/settings',
+    { method: 'GET' },
+    '读取设置失败',
+    options,
+  );
+}
+
+export function putRpgProfileSettings(
+  settings: RuntimeSettings,
+  options: RuntimeRequestOptions = {},
+) {
+  return requestRpgRuntimeJson<RuntimeSettings>(
+    '/settings',
+    {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(settings),
+    },
+    '保存设置失败',
+    options,
+  );
+}
+
+export function getRpgProfileDashboard(options: RuntimeRequestOptions = {}) {
+  return requestRpgRuntimeJson<ProfileDashboardSummary>(
+    '/profile/dashboard',
+    { method: 'GET' },
+    '读取个人看板失败',
+    options,
+  );
+}
+
+export function getRpgProfileWalletLedger(
+  options: RuntimeRequestOptions = {},
+) {
+  return requestRpgRuntimeJson<ProfileWalletLedgerResponse>(
+    '/profile/wallet-ledger',
+    { method: 'GET' },
+    '读取资产流水失败',
+    options,
+  );
+}
+
+export function getRpgProfilePlayStats(options: RuntimeRequestOptions = {}) {
+  return requestRpgRuntimeJson<ProfilePlayStatsResponse>(
+    '/profile/play-stats',
+    { method: 'GET' },
+    '读取游玩统计失败',
+    options,
+  );
+}
+
+export async function listRpgProfileSaveArchives(
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<ProfileSaveArchiveListResponse>(
+    '/profile/save-archives',
+    { method: 'GET' },
+    '读取存档列表失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function resumeRpgProfileSaveArchive(
+  worldKey: string,
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<ProfileSaveArchiveResumeResponse>(
+    `/profile/save-archives/${encodeURIComponent(worldKey)}`,
+    { method: 'POST' },
+    '恢复存档失败',
+    options,
+  );
+
+  return {
+    entry: response.entry,
+    snapshot: rehydrateSavedSnapshot(
+      response.snapshot as HydratedSavedGameSnapshot,
+    ),
+  };
+}
+
+export async function listRpgProfileBrowseHistory(
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<PlatformBrowseHistoryResponse>(
+    '/profile/browse-history',
+    { method: 'GET' },
+    '读取浏览历史失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function upsertRpgProfileBrowseHistory(
+  entry: PlatformBrowseHistoryWriteEntry,
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<PlatformBrowseHistoryResponse>(
+    '/profile/browse-history',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(entry),
+    },
+    '写入浏览历史失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function syncRpgProfileBrowseHistory(
+  entries: PlatformBrowseHistoryWriteEntry[],
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<PlatformBrowseHistoryResponse>(
+    '/profile/browse-history',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        entries,
+      } satisfies PlatformBrowseHistoryBatchSyncRequest),
+    },
+    '同步浏览历史失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function clearRpgProfileBrowseHistory(
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRpgRuntimeJson<PlatformBrowseHistoryResponse>(
+    '/profile/browse-history',
+    { method: 'DELETE' },
+    '清空浏览历史失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export const rpgProfileClient = {
+  getDashboard: getRpgProfileDashboard,
+  getPlayStats: getRpgProfilePlayStats,
+  getWalletLedger: getRpgProfileWalletLedger,
+  getSettings: getRpgProfileSettings,
+  putSettings: putRpgProfileSettings,
+  listSaveArchives: listRpgProfileSaveArchives,
+  resumeSaveArchive: resumeRpgProfileSaveArchive,
+  listBrowseHistory: listRpgProfileBrowseHistory,
+  upsertBrowseHistory: upsertRpgProfileBrowseHistory,
+  syncBrowseHistory: syncRpgProfileBrowseHistory,
+  clearBrowseHistory: clearRpgProfileBrowseHistory,
+};
diff --git a/src/services/rpg-runtime/index.ts b/src/services/rpg-runtime/index.ts
new file mode 100644
index 00000000..bca22886
--- /dev/null
+++ b/src/services/rpg-runtime/index.ts
@@ -0,0 +1,32 @@
+export {
+  deleteRpgSaveSnapshot,
+  getRpgSaveSnapshot,
+  putRpgSaveSnapshot,
+  rpgSnapshotClient,
+  type RuntimeRequestOptions,
+} from './rpgSnapshotClient';
+export {
+  getRpgCharacterChatSuggestions,
+  getRpgCharacterChatSummary,
+  rpgRuntimeChatClient,
+  streamRpgCharacterChatReply,
+  streamRpgNpcChatDialogue,
+  streamRpgNpcChatTurn,
+  streamRpgNpcRecruitDialogue,
+} from './rpgRuntimeChatClient';
+export {
+  getRpgRuntimeActionSnapshot,
+  getRpgRuntimeClientVersion,
+  getRpgRuntimeSessionId,
+  getRpgRuntimeStoryState,
+  isRpgRuntimeServerFunctionId,
+  isRpgRuntimeTaskFunctionId,
+  resolveRpgRuntimeStoryAction,
+  resolveRpgRuntimeStoryMoment,
+  rpgRuntimeStoryClient,
+  shouldUseRpgRuntimeServerOptions,
+  type RuntimeStoryChoicePayload,
+  type RuntimeStoryResponse,
+  type RpgRuntimeStoryClientOptions,
+  type RuntimeStorySnapshotRequest,
+} from './rpgRuntimeStoryClient';
diff --git a/src/services/rpg-runtime/rpgRuntimeChatClient.ts b/src/services/rpg-runtime/rpgRuntimeChatClient.ts
new file mode 100644
index 00000000..4870714c
--- /dev/null
+++ b/src/services/rpg-runtime/rpgRuntimeChatClient.ts
@@ -0,0 +1,29 @@
+import {
+  generateCharacterPanelChatSuggestions,
+  generateCharacterPanelChatSummary,
+  streamCharacterPanelChatReply,
+  streamNpcChatDialogue,
+  streamNpcChatTurn,
+  streamNpcRecruitDialogue,
+} from '../aiService';
+
+/**
+ * RPG 运行时聊天相关 client 的兼容收口层。
+ * 当前仍桥接旧 `aiService`，避免工作包 A 提前改动聊天与 NPC 对话请求语义。
+ */
+export const getRpgCharacterChatSuggestions =
+  generateCharacterPanelChatSuggestions;
+export const getRpgCharacterChatSummary = generateCharacterPanelChatSummary;
+export const streamRpgCharacterChatReply = streamCharacterPanelChatReply;
+export const streamRpgNpcChatDialogue = streamNpcChatDialogue;
+export const streamRpgNpcChatTurn = streamNpcChatTurn;
+export const streamRpgNpcRecruitDialogue = streamNpcRecruitDialogue;
+
+export const rpgRuntimeChatClient = {
+  getCharacterChatSuggestions: getRpgCharacterChatSuggestions,
+  getCharacterChatSummary: getRpgCharacterChatSummary,
+  streamCharacterChatReply: streamRpgCharacterChatReply,
+  streamNpcChatDialogue: streamRpgNpcChatDialogue,
+  streamNpcChatTurn: streamRpgNpcChatTurn,
+  streamNpcRecruitDialogue: streamRpgNpcRecruitDialogue,
+};
diff --git a/src/services/rpg-runtime/rpgRuntimeRequest.ts b/src/services/rpg-runtime/rpgRuntimeRequest.ts
new file mode 100644
index 00000000..b2aa9faa
--- /dev/null
+++ b/src/services/rpg-runtime/rpgRuntimeRequest.ts
@@ -0,0 +1,66 @@
+import { type ApiRetryOptions, requestJson } from '../apiClient';
+
+const RUNTIME_API_BASE = '/api/runtime';
+const RUNTIME_READ_RETRY: ApiRetryOptions = {
+  maxRetries: 1,
+  baseDelayMs: 180,
+  maxDelayMs: 480,
+};
+const RUNTIME_WRITE_RETRY: ApiRetryOptions = {
+  maxRetries: 1,
+  baseDelayMs: 240,
+  maxDelayMs: 640,
+  retryUnsafeMethods: true,
+};
+
+export type RuntimeRequestOptions = {
+  signal?: AbortSignal;
+  retry?: ApiRetryOptions;
+  skipAuth?: boolean;
+  skipRefresh?: boolean;
+};
+
+/**
+ * 统一封装 RPG 运行时域的请求重试与鉴权透传，避免各 client 重复维护同一套规则。
+ */
+export function requestRpgRuntimeJson<T>(
+  path: string,
+  init: RequestInit,
+  fallbackMessage: string,
+  options: RuntimeRequestOptions = {},
+) {
+  const method = (init.method ?? 'GET').toUpperCase();
+  const retry =
+    options.retry ??
+    (method === 'GET' ? RUNTIME_READ_RETRY : RUNTIME_WRITE_RETRY);
+
+  return requestJson<T>(
+    `${RUNTIME_API_BASE}${path}`,
+    {
+      ...init,
+      signal: options.signal,
+    },
+    fallbackMessage,
+    {
+      retry,
+      skipAuth: options.skipAuth,
+      skipRefresh: options.skipRefresh,
+    },
+  );
+}
+
+/**
+ * 公共世界广场等匿名接口统一走公开请求入口，避免误附带鉴权状态。
+ */
+export function requestPublicRpgRuntimeJson<T>(
+  path: string,
+  init: RequestInit,
+  fallbackMessage: string,
+  options: RuntimeRequestOptions = {},
+) {
+  return requestRpgRuntimeJson<T>(path, init, fallbackMessage, {
+    ...options,
+    skipAuth: true,
+    skipRefresh: true,
+  });
+}
diff --git a/src/services/runtimeStoryService.test.ts b/src/services/rpg-runtime/rpgRuntimeStoryClient.test.ts
similarity index 89%
rename from src/services/runtimeStoryService.test.ts
rename to src/services/rpg-runtime/rpgRuntimeStoryClient.test.ts
index a7390aa7..421d2c00 100644
--- a/src/services/runtimeStoryService.test.ts
+++ b/src/services/rpg-runtime/rpgRuntimeStoryClient.test.ts
@@ -4,29 +4,29 @@ const { requestJsonMock } = vi.hoisted(() => ({
   requestJsonMock: vi.fn(),
 }));
 
-vi.mock('./apiClient', async () => {
+vi.mock('../apiClient', async () => {
   const actual =
-    await vi.importActual<typeof import('./apiClient')>('./apiClient');
+    await vi.importActual<typeof import('../apiClient')>('../apiClient');
   return {
     ...actual,
     requestJson: requestJsonMock,
   };
 });
 
-import { AnimationState } from '../types';
+import { AnimationState } from '../../types';
 import {
   buildStoryMomentFromRuntimeOptions,
-  getRuntimeClientVersion,
-  getRuntimeSessionId,
-  getRuntimeStoryState,
-  isServerRuntimeFunctionId,
-  isTask5RuntimeFunctionId,
-  resolveRuntimeStoryAction,
-  resolveRuntimeStoryMoment,
-  shouldUseServerRuntimeOptions,
-} from './runtimeStoryService';
+  getRpgRuntimeClientVersion,
+  getRpgRuntimeSessionId,
+  getRpgRuntimeStoryState,
+  isRpgRuntimeServerFunctionId,
+  isRpgRuntimeTaskFunctionId,
+  resolveRpgRuntimeStoryAction,
+  resolveRpgRuntimeStoryMoment,
+  shouldUseRpgRuntimeServerOptions,
+} from './rpgRuntimeStoryClient';
 
-describe('runtimeStoryService', () => {
+describe('rpgRuntimeStoryClient', () => {
   beforeEach(() => {
     requestJsonMock.mockReset();
   });
@@ -52,7 +52,7 @@ describe('runtimeStoryService', () => {
       },
     });
 
-    await resolveRuntimeStoryAction({
+    await resolveRpgRuntimeStoryAction({
       sessionId: 'runtime-custom',
       clientVersion: 9,
       option: {
@@ -105,7 +105,7 @@ describe('runtimeStoryService', () => {
       },
     });
 
-    await resolveRuntimeStoryAction({
+    await resolveRpgRuntimeStoryAction({
       option: {
         functionId: 'inventory_use',
         actionText: '使用凝神灵液',
@@ -176,7 +176,7 @@ describe('runtimeStoryService', () => {
       },
     });
 
-    await getRuntimeStoryState({
+    await getRpgRuntimeStoryState({
       sessionId: 'runtime-main',
       clientVersion: 7,
       snapshot: {
@@ -241,13 +241,13 @@ describe('runtimeStoryService', () => {
   });
 
   it('recognizes server-runtime option pools for server-side legality checks', () => {
-    expect(isTask5RuntimeFunctionId('npc_chat')).toBe(true);
-    expect(isTask5RuntimeFunctionId('battle_attack_basic')).toBe(true);
-    expect(isTask5RuntimeFunctionId('npc_trade')).toBe(false);
-    expect(isServerRuntimeFunctionId('npc_trade')).toBe(true);
-    expect(isServerRuntimeFunctionId('unknown_action')).toBe(false);
+    expect(isRpgRuntimeTaskFunctionId('npc_chat')).toBe(true);
+    expect(isRpgRuntimeTaskFunctionId('battle_attack_basic')).toBe(true);
+    expect(isRpgRuntimeTaskFunctionId('npc_trade')).toBe(false);
+    expect(isRpgRuntimeServerFunctionId('npc_trade')).toBe(true);
+    expect(isRpgRuntimeServerFunctionId('unknown_action')).toBe(false);
     expect(
-      shouldUseServerRuntimeOptions([
+      shouldUseRpgRuntimeServerOptions([
         {
           functionId: 'npc_chat',
           actionText: '继续交谈',
@@ -264,7 +264,7 @@ describe('runtimeStoryService', () => {
       ]),
     ).toBe(true);
     expect(
-      shouldUseServerRuntimeOptions([
+      shouldUseRpgRuntimeServerOptions([
         {
           functionId: 'npc_trade',
           actionText: '交易',
@@ -281,7 +281,7 @@ describe('runtimeStoryService', () => {
       ]),
     ).toBe(true);
     expect(
-      shouldUseServerRuntimeOptions([
+      shouldUseRpgRuntimeServerOptions([
         {
           functionId: 'unknown_action',
           actionText: '未知动作',
@@ -297,8 +297,10 @@ describe('runtimeStoryService', () => {
         },
       ]),
     ).toBe(false);
-    expect(getRuntimeSessionId({ runtimeSessionId: '' })).toBe('runtime-main');
-    expect(getRuntimeClientVersion({ runtimeActionVersion: 3 })).toBe(3);
+    expect(getRpgRuntimeSessionId({ runtimeSessionId: '' })).toBe(
+      'runtime-main',
+    );
+    expect(getRpgRuntimeClientVersion({ runtimeActionVersion: 3 })).toBe(3);
   });
 
   it('preserves runtime option interaction metadata from the server response', () => {
@@ -326,7 +328,7 @@ describe('runtimeStoryService', () => {
   });
 
   it('prefers the richer snapshot story when the server persisted dialogue mode', () => {
-    const story = resolveRuntimeStoryMoment({
+    const story = resolveRpgRuntimeStoryMoment({
       response: {
         sessionId: 'runtime-main',
         serverVersion: 4,
diff --git a/src/services/runtimeStoryService.ts b/src/services/rpg-runtime/rpgRuntimeStoryClient.ts
similarity index 78%
rename from src/services/runtimeStoryService.ts
rename to src/services/rpg-runtime/rpgRuntimeStoryClient.ts
index 4b121f08..f5f1ff8a 100644
--- a/src/services/runtimeStoryService.ts
+++ b/src/services/rpg-runtime/rpgRuntimeStoryClient.ts
@@ -1,24 +1,23 @@
 import type {
   RuntimeStoryActionRequest,
   RuntimeStoryActionResponse,
-  RuntimeStoryChoicePayload,
   RuntimeStoryOptionView,
   RuntimeStoryStateRequest,
+} from '../../../packages/shared/src/contracts/rpgRuntimeStoryState';
+import type {
+  RuntimeStoryChoicePayload,
   ServerRuntimeFunctionId,
   Task5RuntimeFunctionId,
-} from '../../packages/shared/src/contracts/story';
+} from '../../../packages/shared/src/contracts/rpgRuntimeStoryAction';
 import {
   SERVER_RUNTIME_FUNCTION_IDS,
   TASK5_RUNTIME_FUNCTION_IDS,
-} from '../../packages/shared/src/contracts/story';
-import { rehydrateSavedSnapshot } from '../persistence/runtimeSnapshot';
-import type {
-  HydratedGameState,
-  HydratedSavedGameSnapshot,
-} from '../persistence/runtimeSnapshotTypes';
-import type { GameState, StoryMoment, StoryOption } from '../types';
-import { AnimationState } from '../types';
-import { type ApiRetryOptions, requestJson } from './apiClient';
+} from '../../../packages/shared/src/contracts/rpgRuntimeStoryAction';
+import { rehydrateSavedSnapshot } from '../../persistence/runtimeSnapshot';
+import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
+import type { GameState, StoryMoment, StoryOption } from '../../types';
+import { AnimationState } from '../../types';
+import { type ApiRetryOptions, requestJson } from '../apiClient';
 
 const RUNTIME_STORY_API_BASE = '/api/runtime/story';
 const DEFAULT_SESSION_ID = 'runtime-main';
@@ -36,18 +35,18 @@ const SERVER_RUNTIME_FUNCTION_ID_SET = new Set<string>([
   ...SERVER_RUNTIME_FUNCTION_IDS,
 ]);
 
-export type RuntimeStoryServiceOptions = {
+export type RpgRuntimeStoryClientOptions = {
   signal?: AbortSignal;
   retry?: ApiRetryOptions;
 };
 
 export type RuntimeStoryResponse = RuntimeStoryActionResponse<
-  HydratedGameState,
+  GameState,
   StoryMoment
 >;
 export type { RuntimeStoryChoicePayload };
 export type RuntimeStorySnapshotRequest = RuntimeStoryStateRequest<
-  HydratedGameState,
+  GameState,
   StoryMoment
 >['snapshot'];
 
@@ -55,7 +54,7 @@ function requestRuntimeStoryJson<T>(
   path: string,
   init: RequestInit,
   fallbackMessage: string,
-  options: RuntimeStoryServiceOptions = {},
+  options: RpgRuntimeStoryClientOptions = {},
 ) {
   return requestJson<T>(
     `${RUNTIME_STORY_API_BASE}${path}`,
@@ -181,7 +180,7 @@ export async function getRuntimeStoryState(
     clientVersion?: number;
     snapshot?: RuntimeStorySnapshotRequest;
   },
-  options: RuntimeStoryServiceOptions = {},
+  options: RpgRuntimeStoryClientOptions = {},
 ) {
   const normalizedSessionId = params.sessionId || DEFAULT_SESSION_ID;
   const response = params.snapshot
@@ -194,7 +193,7 @@ export async function getRuntimeStoryState(
             sessionId: normalizedSessionId,
             clientVersion: params.clientVersion,
             snapshot: params.snapshot,
-          } satisfies RuntimeStoryStateRequest),
+          } satisfies RuntimeStoryStateRequest<GameState, StoryMoment>),
         },
         '读取运行时故事状态失败',
         options,
@@ -223,7 +222,7 @@ export async function resolveRuntimeStoryAction(
     payload?: RuntimeStoryChoicePayload;
     snapshot?: RuntimeStorySnapshotRequest;
   },
-  options: RuntimeStoryServiceOptions = {},
+  options: RpgRuntimeStoryClientOptions = {},
 ) {
   const response = await requestRuntimeStoryJson<RuntimeStoryResponse>(
     '/actions/resolve',
@@ -260,3 +259,23 @@ export async function resolveRuntimeStoryAction(
 export function getRuntimeActionSnapshot(response: RuntimeStoryResponse) {
   return rehydrateSavedSnapshot(response.snapshot as HydratedSavedGameSnapshot);
 }
+
+export const getRpgRuntimeActionSnapshot = getRuntimeActionSnapshot;
+export const getRpgRuntimeClientVersion = getRuntimeClientVersion;
+export const getRpgRuntimeSessionId = getRuntimeSessionId;
+export const getRpgRuntimeStoryState = getRuntimeStoryState;
+export const isRpgRuntimeServerFunctionId = isServerRuntimeFunctionId;
+export const isRpgRuntimeTaskFunctionId = isTask5RuntimeFunctionId;
+export const resolveRpgRuntimeStoryAction = resolveRuntimeStoryAction;
+export const resolveRpgRuntimeStoryMoment = resolveRuntimeStoryMoment;
+export const shouldUseRpgRuntimeServerOptions = shouldUseServerRuntimeOptions;
+
+export const rpgRuntimeStoryClient = {
+  getActionSnapshot: getRpgRuntimeActionSnapshot,
+  getClientVersion: getRpgRuntimeClientVersion,
+  getSessionId: getRpgRuntimeSessionId,
+  getState: getRpgRuntimeStoryState,
+  resolveAction: resolveRpgRuntimeStoryAction,
+  resolveMoment: resolveRpgRuntimeStoryMoment,
+  shouldUseServerOptions: shouldUseRpgRuntimeServerOptions,
+};
diff --git a/src/services/rpg-runtime/rpgSnapshotClient.test.ts b/src/services/rpg-runtime/rpgSnapshotClient.test.ts
new file mode 100644
index 00000000..f24dfedf
--- /dev/null
+++ b/src/services/rpg-runtime/rpgSnapshotClient.test.ts
@@ -0,0 +1,89 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const { requestJsonMock } = vi.hoisted(() => ({
+  requestJsonMock: vi.fn(),
+}));
+
+import {
+  deleteRpgSaveSnapshot,
+  getRpgSaveSnapshot,
+  putRpgSaveSnapshot,
+} from './rpgSnapshotClient';
+
+vi.mock('../apiClient', () => ({
+  requestJson: requestJsonMock,
+}));
+
+describe('rpgSnapshotClient routes', () => {
+  beforeEach(() => {
+    requestJsonMock.mockReset();
+  });
+
+  it('reads the current save snapshot from the runtime save route', async () => {
+    requestJsonMock.mockResolvedValueOnce(null);
+
+    await getRpgSaveSnapshot();
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/save/snapshot',
+      expect.objectContaining({ method: 'GET' }),
+      '读取存档失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({ maxRetries: 1 }),
+      }),
+    );
+  });
+
+  it('writes the current save snapshot through the runtime save route', async () => {
+    requestJsonMock.mockResolvedValueOnce({
+      version: 2,
+      savedAt: '2026-04-21T09:00:00.000Z',
+      bottomTab: 'adventure',
+      currentStory: null,
+      gameState: {
+        worldType: 'CUSTOM',
+      },
+    });
+
+    await putRpgSaveSnapshot({
+      bottomTab: 'adventure',
+      currentStory: null,
+      gameState: {
+        worldType: 'CUSTOM',
+      } as never,
+    });
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/save/snapshot',
+      expect.objectContaining({
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+      }),
+      '保存存档失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+
+  it('deletes the current save snapshot through the runtime save route', async () => {
+    requestJsonMock.mockResolvedValueOnce({ ok: true });
+
+    await deleteRpgSaveSnapshot();
+
+    expect(requestJsonMock).toHaveBeenCalledWith(
+      '/api/runtime/save/snapshot',
+      expect.objectContaining({ method: 'DELETE' }),
+      '删除存档失败',
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 1,
+          retryUnsafeMethods: true,
+        }),
+      }),
+    );
+  });
+});
diff --git a/src/services/rpg-runtime/rpgSnapshotClient.ts b/src/services/rpg-runtime/rpgSnapshotClient.ts
new file mode 100644
index 00000000..901807f6
--- /dev/null
+++ b/src/services/rpg-runtime/rpgSnapshotClient.ts
@@ -0,0 +1,60 @@
+import type { BasicOkResult } from '../../../packages/shared/src/contracts/runtime';
+import type { SavedGameSnapshotInput } from '../../persistence/gameSaveStorage';
+import { rehydrateSavedSnapshot } from '../../persistence/runtimeSnapshot';
+import type { HydratedSavedGameSnapshot } from '../../persistence/runtimeSnapshotTypes';
+import {
+  requestRpgRuntimeJson,
+  type RuntimeRequestOptions,
+} from './rpgRuntimeRequest';
+
+export type { RuntimeRequestOptions };
+
+/**
+ * RPG 运行时快照 client。
+ * 工作包 C 起由新域目录承载真实实现，旧 `storageService` 仅保留兼容转发。
+ */
+export async function getRpgSaveSnapshot(
+  options: RuntimeRequestOptions = {},
+) {
+  const snapshot = await requestRpgRuntimeJson<HydratedSavedGameSnapshot | null>(
+    '/save/snapshot',
+    { method: 'GET' },
+    '读取存档失败',
+    options,
+  );
+
+  return snapshot ? rehydrateSavedSnapshot(snapshot) : null;
+}
+
+export async function putRpgSaveSnapshot(
+  snapshot: SavedGameSnapshotInput,
+  options: RuntimeRequestOptions = {},
+) {
+  const savedSnapshot = await requestRpgRuntimeJson<HydratedSavedGameSnapshot>(
+    '/save/snapshot',
+    {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(snapshot),
+    },
+    '保存存档失败',
+    options,
+  );
+
+  return rehydrateSavedSnapshot(savedSnapshot);
+}
+
+export function deleteRpgSaveSnapshot(options: RuntimeRequestOptions = {}) {
+  return requestRpgRuntimeJson<BasicOkResult>(
+    '/save/snapshot',
+    { method: 'DELETE' },
+    '删除存档失败',
+    options,
+  );
+}
+
+export const rpgSnapshotClient = {
+  getSnapshot: getRpgSaveSnapshot,
+  putSnapshot: putRpgSaveSnapshot,
+  deleteSnapshot: deleteRpgSaveSnapshot,
+};
diff --git a/src/services/storageService.ts b/src/services/storageService.ts
deleted file mode 100644
index af335d9e..00000000
--- a/src/services/storageService.ts
+++ /dev/null
@@ -1,440 +0,0 @@
-import type { ListCustomWorldWorksResponse } from '../../packages/shared/src/contracts/customWorldAgent';
-import type {
-  BasicOkResult,
-  CustomWorldGalleryDetailResponse,
-  CustomWorldGalleryResponse,
-  CustomWorldLibraryEntry,
-  CustomWorldLibraryMutationResponse,
-  CustomWorldLibraryResponse,
-  PlatformBrowseHistoryBatchSyncRequest,
-  PlatformBrowseHistoryEntry,
-  PlatformBrowseHistoryResponse,
-  PlatformBrowseHistoryWriteEntry,
-  ProfileDashboardSummary,
-  ProfileSaveArchiveListResponse,
-  ProfileSaveArchiveResumeResponse,
-  ProfileSaveArchiveSummary,
-  ProfilePlayStatsResponse,
-  ProfileWalletLedgerResponse,
-  RuntimeSettings,
-} from '../../packages/shared/src/contracts/runtime';
-import type { SavedGameSnapshotInput } from '../persistence/gameSaveStorage';
-import { rehydrateSavedSnapshot } from '../persistence/runtimeSnapshot';
-import type { HydratedSavedGameSnapshot } from '../persistence/runtimeSnapshotTypes';
-import type { CustomWorldProfile } from '../types';
-import { type ApiRetryOptions, requestJson } from './apiClient';
-
-const RUNTIME_API_BASE = '/api/runtime';
-const RUNTIME_READ_RETRY: ApiRetryOptions = {
-  maxRetries: 1,
-  baseDelayMs: 180,
-  maxDelayMs: 480,
-};
-const RUNTIME_WRITE_RETRY: ApiRetryOptions = {
-  maxRetries: 1,
-  baseDelayMs: 240,
-  maxDelayMs: 640,
-  retryUnsafeMethods: true,
-};
-
-export type RuntimeRequestOptions = {
-  signal?: AbortSignal;
-  retry?: ApiRetryOptions;
-  skipAuth?: boolean;
-  skipRefresh?: boolean;
-};
-
-function requestRuntimeJson<T>(
-  path: string,
-  init: RequestInit,
-  fallbackMessage: string,
-  options: RuntimeRequestOptions = {},
-) {
-  const method = (init.method ?? 'GET').toUpperCase();
-  const retry =
-    options.retry ??
-    (method === 'GET' ? RUNTIME_READ_RETRY : RUNTIME_WRITE_RETRY);
-
-  return requestJson<T>(
-    `${RUNTIME_API_BASE}${path}`,
-    {
-      ...init,
-      signal: options.signal,
-    },
-    fallbackMessage,
-    {
-      retry,
-      skipAuth: options.skipAuth,
-      skipRefresh: options.skipRefresh,
-    },
-  );
-}
-
-function requestPublicRuntimeJson<T>(
-  path: string,
-  init: RequestInit,
-  fallbackMessage: string,
-  options: RuntimeRequestOptions = {},
-) {
-  return requestRuntimeJson<T>(path, init, fallbackMessage, {
-    ...options,
-    skipAuth: true,
-    skipRefresh: true,
-  });
-}
-
-export async function getSaveSnapshot(options: RuntimeRequestOptions = {}) {
-  const snapshot = await requestRuntimeJson<HydratedSavedGameSnapshot | null>(
-    '/save/snapshot',
-    { method: 'GET' },
-    '读取存档失败',
-    options,
-  );
-
-  return snapshot ? rehydrateSavedSnapshot(snapshot) : null;
-}
-
-export async function putSaveSnapshot(
-  snapshot: SavedGameSnapshotInput,
-  options: RuntimeRequestOptions = {},
-) {
-  const savedSnapshot = await requestRuntimeJson<HydratedSavedGameSnapshot>(
-    '/save/snapshot',
-    {
-      method: 'PUT',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(snapshot),
-    },
-    '保存存档失败',
-    options,
-  );
-
-  return rehydrateSavedSnapshot(savedSnapshot);
-}
-
-export async function deleteSaveSnapshot(options: RuntimeRequestOptions = {}) {
-  return requestRuntimeJson<BasicOkResult>(
-    '/save/snapshot',
-    { method: 'DELETE' },
-    '删除存档失败',
-    options,
-  );
-}
-
-export async function getSettings(options: RuntimeRequestOptions = {}) {
-  return requestRuntimeJson<RuntimeSettings>(
-    '/settings',
-    { method: 'GET' },
-    '读取设置失败',
-    options,
-  );
-}
-
-export async function getProfileDashboard(options: RuntimeRequestOptions = {}) {
-  return requestRuntimeJson<ProfileDashboardSummary>(
-    '/profile/dashboard',
-    { method: 'GET' },
-    '读取个人看板失败',
-    options,
-  );
-}
-
-export async function getProfileWalletLedger(
-  options: RuntimeRequestOptions = {},
-) {
-  return requestRuntimeJson<ProfileWalletLedgerResponse>(
-    '/profile/wallet-ledger',
-    { method: 'GET' },
-    '读取资产流水失败',
-    options,
-  );
-}
-
-export async function getProfilePlayStats(options: RuntimeRequestOptions = {}) {
-  return requestRuntimeJson<ProfilePlayStatsResponse>(
-    '/profile/play-stats',
-    { method: 'GET' },
-    '读取游玩统计失败',
-    options,
-  );
-}
-
-export async function listProfileSaveArchives(
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<ProfileSaveArchiveListResponse>(
-    '/profile/save-archives',
-    { method: 'GET' },
-    '读取存档列表失败',
-    options,
-  );
-
-  return Array.isArray(response?.entries) ? response.entries : [];
-}
-
-export async function resumeProfileSaveArchive(
-  worldKey: string,
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<
-    ProfileSaveArchiveResumeResponse
-  >(
-    `/profile/save-archives/${encodeURIComponent(worldKey)}`,
-    { method: 'POST' },
-    '恢复存档失败',
-    options,
-  );
-
-  return {
-    entry: response.entry,
-    snapshot: rehydrateSavedSnapshot(
-      response.snapshot as HydratedSavedGameSnapshot,
-    ),
-  };
-}
-
-export async function putSettings(
-  settings: RuntimeSettings,
-  options: RuntimeRequestOptions = {},
-) {
-  return requestRuntimeJson<RuntimeSettings>(
-    '/settings',
-    {
-      method: 'PUT',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(settings),
-    },
-    '保存设置失败',
-    options,
-  );
-}
-
-export async function listCustomWorldLibrary(
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<
-    CustomWorldLibraryResponse<CustomWorldProfile>
-  >(
-    '/custom-world-library',
-    { method: 'GET' },
-    '读取自定义世界库失败',
-    options,
-  );
-
-  return Array.isArray(response?.entries) ? response.entries : [];
-}
-
-export async function listCustomWorldWorks(
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<ListCustomWorldWorksResponse>(
-    '/custom-world/works',
-    { method: 'GET' },
-    '读取创作作品列表失败',
-    options,
-  );
-
-  return Array.isArray(response?.items) ? response.items : [];
-}
-
-export async function upsertCustomWorldProfile(
-  profile: CustomWorldProfile,
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<
-    CustomWorldLibraryMutationResponse<CustomWorldProfile>
-  >(
-    `/custom-world-library/${encodeURIComponent(profile.id)}`,
-    {
-      method: 'PUT',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        profile,
-      }),
-    },
-    '保存自定义世界失败',
-    options,
-  );
-
-  return {
-    entry: response.entry,
-    entries: Array.isArray(response?.entries) ? response.entries : [],
-  };
-}
-
-export async function deleteCustomWorldProfile(
-  profileId: string,
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<
-    CustomWorldLibraryResponse<CustomWorldProfile>
-  >(
-    `/custom-world-library/${encodeURIComponent(profileId)}`,
-    { method: 'DELETE' },
-    '删除自定义世界失败',
-    options,
-  );
-
-  return Array.isArray(response?.entries) ? response.entries : [];
-}
-
-export async function publishCustomWorldProfile(
-  profileId: string,
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<
-    CustomWorldLibraryMutationResponse<CustomWorldProfile>
-  >(
-    `/custom-world-library/${encodeURIComponent(profileId)}/publish`,
-    { method: 'POST' },
-    '发布自定义世界失败',
-    options,
-  );
-
-  return {
-    entry: response.entry,
-    entries: Array.isArray(response?.entries) ? response.entries : [],
-  };
-}
-
-export async function unpublishCustomWorldProfile(
-  profileId: string,
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<
-    CustomWorldLibraryMutationResponse<CustomWorldProfile>
-  >(
-    `/custom-world-library/${encodeURIComponent(profileId)}/unpublish`,
-    { method: 'POST' },
-    '下架自定义世界失败',
-    options,
-  );
-
-  return {
-    entry: response.entry,
-    entries: Array.isArray(response?.entries) ? response.entries : [],
-  };
-}
-
-export async function listCustomWorldGallery(
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestPublicRuntimeJson<CustomWorldGalleryResponse>(
-    '/custom-world-gallery',
-    { method: 'GET' },
-    '读取作品广场失败',
-    options,
-  );
-
-  return Array.isArray(response?.entries) ? response.entries : [];
-}
-
-export async function getCustomWorldGalleryDetail(
-  ownerUserId: string,
-  profileId: string,
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestPublicRuntimeJson<
-    CustomWorldGalleryDetailResponse<CustomWorldProfile>
-  >(
-    `/custom-world-gallery/${encodeURIComponent(ownerUserId)}/${encodeURIComponent(profileId)}`,
-    { method: 'GET' },
-    '读取作品详情失败',
-    options,
-  );
-
-  return response.entry;
-}
-
-export async function listProfileBrowseHistory(
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<PlatformBrowseHistoryResponse>(
-    '/profile/browse-history',
-    { method: 'GET' },
-    '读取浏览历史失败',
-    options,
-  );
-
-  return Array.isArray(response?.entries) ? response.entries : [];
-}
-
-export async function upsertProfileBrowseHistory(
-  entry: PlatformBrowseHistoryWriteEntry,
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<PlatformBrowseHistoryResponse>(
-    '/profile/browse-history',
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(entry),
-    },
-    '写入浏览历史失败',
-    options,
-  );
-
-  return Array.isArray(response?.entries) ? response.entries : [];
-}
-
-export async function syncProfileBrowseHistory(
-  entries: PlatformBrowseHistoryWriteEntry[],
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<PlatformBrowseHistoryResponse>(
-    '/profile/browse-history',
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        entries,
-      } satisfies PlatformBrowseHistoryBatchSyncRequest),
-    },
-    '同步浏览历史失败',
-    options,
-  );
-
-  return Array.isArray(response?.entries) ? response.entries : [];
-}
-
-export async function clearProfileBrowseHistory(
-  options: RuntimeRequestOptions = {},
-) {
-  const response = await requestRuntimeJson<PlatformBrowseHistoryResponse>(
-    '/profile/browse-history',
-    { method: 'DELETE' },
-    '清空浏览历史失败',
-    options,
-  );
-
-  return Array.isArray(response?.entries) ? response.entries : [];
-}
-
-export const runtimeStorageClient = {
-  getSaveSnapshot,
-  putSaveSnapshot,
-  deleteSaveSnapshot,
-  getSettings,
-  putSettings,
-  getProfileDashboard,
-  getProfileWalletLedger,
-  getProfilePlayStats,
-  listProfileSaveArchives,
-  resumeProfileSaveArchive,
-  listCustomWorldLibrary,
-  listCustomWorldWorks,
-  upsertCustomWorldProfile,
-  deleteCustomWorldProfile,
-  publishCustomWorldProfile,
-  unpublishCustomWorldProfile,
-  listCustomWorldGallery,
-  getCustomWorldGalleryDetail,
-  listProfileBrowseHistory,
-  upsertProfileBrowseHistory,
-  syncProfileBrowseHistory,
-  clearProfileBrowseHistory,
-};
-
-export type { CustomWorldLibraryEntry };
-export type { PlatformBrowseHistoryEntry };
-export type { ProfileSaveArchiveSummary };
diff --git a/src/types/core.ts b/src/types/core.ts
index bc859455..1db421db 100644
--- a/src/types/core.ts
+++ b/src/types/core.ts
@@ -84,7 +84,14 @@ export type QuestStatus =
   | 'turned_in'
   | 'failed'
   | 'expired';
-export type NpcInteractionAction = NpcFunctionType | 'leave' | 'quest_accept' | 'quest_turn_in';
+export type NpcInteractionAction =
+  | NpcFunctionType
+  | 'leave'
+  | 'quest_accept'
+  | 'quest_offer_abandon'
+  | 'quest_offer_replace'
+  | 'quest_offer_view'
+  | 'quest_turn_in';
 export type TreasureInteractionAction = 'secure' | 'inspect' | 'leave';
 export type NpcBattleMode = 'fight' | 'spar';
 export type NpcBattleOutcome = 'fight_victory' | 'spar_complete';
diff --git a/vitest.config.ts b/vitest.config.ts
index d4a811d1..e334d9c9 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -4,6 +4,11 @@ export default defineConfig({
   test: {
     environment: 'node',
     globals: true,
-    include: ['src/**/*.test.ts', 'src/**/*.test.tsx', 'scripts/**/*.test.ts'],
+    include: [
+      'src/**/*.test.ts',
+      'src/**/*.test.tsx',
+      'scripts/**/*.test.ts',
+      'packages/shared/src/**/*.test.ts',
+    ],
   },
 });

From 48957311bc832567ea23ba053e96a7676a9af2a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=AB=98=E7=89=A9?= <253518756@qq.com>
Date: Tue, 21 Apr 2026 19:18:26 +0800
Subject: [PATCH 6/6] 1

---
 ...NG_DEAD_CODE_CLEANUP_BATCH_E_2026-04-21.md | 117 +++++
 ...NG_DEAD_CODE_CLEANUP_BATCH_F_2026-04-21.md |  91 ++++
 docs/audits/engineering/README.md             |  28 +-
 docs/experience/AGENT_UI_CHANGELOG.md         |   9 +
 .../FUNCTION_SCRIPT_CATALOG_2026-04-04.md     |  23 +-
 ...DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md |  23 +
 .../src/contracts/rpgRuntimeContracts.test.ts |  16 +-
 scripts/smoke-content.ts                      |  22 +-
 .../src/bridges/legacyBuildRuntimeBridge.ts   |   6 -
 .../legacyRuntimeItemResolutionBridge.ts      |   8 -
 .../runtime-profile/runtimeProfileCompiler.ts |  13 -
 server-node/src/modules/inventory/index.ts    |   1 -
 server-node/src/modules/quest/index.ts        |   2 -
 .../src/modules/rpg-runtime-story/index.ts    |  35 --
 server-node/src/modules/runtime-item/index.ts |   2 -
 .../runtimeItemResolutionService.test.ts      |  96 ----
 .../runtimeItemResolutionService.ts           |  39 --
 .../src/repositories/rpg-entry/index.ts       |   8 -
 .../src/repositories/rpg-profile/index.ts     |   8 -
 .../src/repositories/rpg-runtime/index.ts     |   4 -
 server-node/src/routes/customWorldAgent.ts    |   4 +
 server-node/src/routes/rpg-entry/index.ts     |  11 -
 server-node/src/routes/rpg-profile/index.ts   |   4 -
 server-node/src/routes/rpg-runtime/index.ts   |   8 -
 .../src/routes/rpgCreationAgentRoutes.ts      |   1 -
 .../src/routes/rpgWorldGalleryRoutes.ts       |  14 -
 .../syncCustomWorldSavedProfileAssets.ts      | 233 ----------
 .../src/services/RpgAgentOrchestrator.ts      |   1 -
 .../src/services/RpgAgentSessionStore.ts      |   5 -
 .../services/customWorldAgentPhase2.test.ts   |  10 +-
 .../services/customWorldAgentPhase3.test.ts   |  10 +-
 .../services/customWorldAgentPhase4.test.ts   |  26 +-
 .../customWorldAgentPublishGateService.ts     | 141 ------
 .../customWorldAgentPublishService.ts         | 410 ------------------
 ...orldWorkSummaryService.integration.test.ts |  18 +-
 .../services/customWorldWorkSummaryService.ts |  20 -
 src/components/DeveloperTeamModal.tsx         |  65 ---
 src/components/LazySkillEffectPreview.tsx     |  33 --
 src/components/npcVisualEditorModel.ts        | 176 --------
 .../npcVisualEditorPersistence.test.ts        | 107 -----
 src/components/npcVisualEditorPersistence.ts  |  65 ---
 .../rpg-creation-asset-studio/index.ts        |   4 -
 .../CustomWorldSceneChapterEditorSection.tsx  |   1 -
 src/components/rpg-creation-editor/index.ts   |   4 -
 src/components/rpg-creation-result/index.ts   |   4 -
 ...gEntryFlowShell.agent.interaction.test.tsx |  63 +++
 .../rpg-entry/useRpgEntryLibraryDetail.ts     |  82 ++--
 src/data/editorValidation.ts                  | 254 -----------
 .../flow/storyOpeningCampDialogue.ts          |   2 +-
 src/data/functionCatalog/index.ts             |   1 +
 src/data/functionCatalog/npc/index.ts         |   8 +
 src/data/functionCatalog/npc/npcChat.ts       |   2 +-
 .../functionCatalog/npc/npcChatQuestOffer.ts  |  86 ++++
 src/data/functionCatalog/npc/npcFight.ts      |   2 +-
 src/data/functionCatalog/npc/npcHelp.ts       |   2 +-
 src/data/functionCatalog/npc/npcLeave.ts      |   2 +-
 .../functionCatalog/npc/npcPreviewTalk.ts     |   2 +-
 src/data/functionCatalog/npc/npcSpar.ts       |   2 +-
 .../state/battleAttackBasic.ts                |  35 ++
 .../functionCatalog/state/battleUseSkill.ts   |  36 ++
 src/data/functionCatalog/state/index.ts       |  10 +-
 src/data/sceneObservation.ts                  |  37 --
 src/editor/shared/EditorNotice.tsx            |  20 -
 src/editor/shared/FormFields.tsx              | 161 -------
 src/editor/shared/SectionCard.tsx             |  29 --
 .../npcEncounterActions.test.ts               |   2 +-
 .../rpg-runtime-story/npcEncounterActions.ts  |   6 -
 .../rpg-runtime-story/openingAdventure.ts     | 230 ----------
 .../storyCampCompanion.test.ts                | 356 ---------------
 .../rpg-runtime-story/storyCampCompanion.ts   | 293 -------------
 .../storyRenderingHelpers.ts                  | 241 ----------
 src/prompts/questPrompts.ts                   | 175 --------
 src/prompts/runtimeItemPrompts.ts             | 119 -----
 src/services/questDirector.ts                 | 139 ------
 src/services/questPrompt.ts                   |   1 -
 src/services/runtimeItemAiPrompt.ts           |   1 -
 .../contentDependencyGraph.test.ts            |  43 --
 .../storyEngine/contentDependencyGraph.ts     |  76 ----
 78 files changed, 643 insertions(+), 3801 deletions(-)
 create mode 100644 docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_E_2026-04-21.md
 create mode 100644 docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_F_2026-04-21.md
 delete mode 100644 server-node/src/bridges/legacyBuildRuntimeBridge.ts
 delete mode 100644 server-node/src/bridges/legacyRuntimeItemResolutionBridge.ts
 delete mode 100644 server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts
 delete mode 100644 server-node/src/modules/inventory/index.ts
 delete mode 100644 server-node/src/modules/quest/index.ts
 delete mode 100644 server-node/src/modules/rpg-runtime-story/index.ts
 delete mode 100644 server-node/src/modules/runtime-item/index.ts
 delete mode 100644 server-node/src/modules/runtime-item/runtimeItemResolutionService.test.ts
 delete mode 100644 server-node/src/modules/runtime-item/runtimeItemResolutionService.ts
 delete mode 100644 server-node/src/repositories/rpg-entry/index.ts
 delete mode 100644 server-node/src/repositories/rpg-profile/index.ts
 delete mode 100644 server-node/src/repositories/rpg-runtime/index.ts
 delete mode 100644 server-node/src/routes/rpg-entry/index.ts
 delete mode 100644 server-node/src/routes/rpg-profile/index.ts
 delete mode 100644 server-node/src/routes/rpg-runtime/index.ts
 delete mode 100644 server-node/src/routes/rpgCreationAgentRoutes.ts
 delete mode 100644 server-node/src/routes/rpgWorldGalleryRoutes.ts
 delete mode 100644 server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts
 delete mode 100644 server-node/src/services/RpgAgentOrchestrator.ts
 delete mode 100644 server-node/src/services/RpgAgentSessionStore.ts
 delete mode 100644 server-node/src/services/customWorldAgentPublishGateService.ts
 delete mode 100644 server-node/src/services/customWorldAgentPublishService.ts
 delete mode 100644 server-node/src/services/customWorldWorkSummaryService.ts
 delete mode 100644 src/components/DeveloperTeamModal.tsx
 delete mode 100644 src/components/LazySkillEffectPreview.tsx
 delete mode 100644 src/components/npcVisualEditorModel.ts
 delete mode 100644 src/components/npcVisualEditorPersistence.test.ts
 delete mode 100644 src/components/npcVisualEditorPersistence.ts
 delete mode 100644 src/components/rpg-creation-asset-studio/index.ts
 delete mode 100644 src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx
 delete mode 100644 src/components/rpg-creation-editor/index.ts
 delete mode 100644 src/components/rpg-creation-result/index.ts
 delete mode 100644 src/data/editorValidation.ts
 create mode 100644 src/data/functionCatalog/npc/npcChatQuestOffer.ts
 create mode 100644 src/data/functionCatalog/state/battleAttackBasic.ts
 create mode 100644 src/data/functionCatalog/state/battleUseSkill.ts
 delete mode 100644 src/data/sceneObservation.ts
 delete mode 100644 src/editor/shared/EditorNotice.tsx
 delete mode 100644 src/editor/shared/FormFields.tsx
 delete mode 100644 src/editor/shared/SectionCard.tsx
 delete mode 100644 src/hooks/rpg-runtime-story/npcEncounterActions.ts
 delete mode 100644 src/hooks/rpg-runtime-story/openingAdventure.ts
 delete mode 100644 src/hooks/rpg-runtime-story/storyCampCompanion.test.ts
 delete mode 100644 src/hooks/rpg-runtime-story/storyCampCompanion.ts
 delete mode 100644 src/hooks/rpg-runtime-story/storyRenderingHelpers.ts
 delete mode 100644 src/prompts/questPrompts.ts
 delete mode 100644 src/prompts/runtimeItemPrompts.ts
 delete mode 100644 src/services/questDirector.ts
 delete mode 100644 src/services/questPrompt.ts
 delete mode 100644 src/services/runtimeItemAiPrompt.ts
 delete mode 100644 src/services/storyEngine/contentDependencyGraph.test.ts
 delete mode 100644 src/services/storyEngine/contentDependencyGraph.ts

diff --git a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_E_2026-04-21.md b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_E_2026-04-21.md
new file mode 100644
index 00000000..01c2ff5f
--- /dev/null
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_E_2026-04-21.md
@@ -0,0 +1,117 @@
+# 工程死分支清理执行记录 E（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+本批次承接批次 D，继续清掉已经退出 RPG 游戏创作主流程、RPG 运行时玩法主流程、平台基本功能主流程的历史壳层。
+
+本批次不处理仍需后端 contract 先收口的对象，例如：
+
+1. `src/services/questDirector.ts`
+2. `src/services/runtimeItemAiDirector.ts`
+3. `src/hooks/rpg-runtime-story/runtimeStoryCoordinator.ts`
+4. `src/services/apiClient.ts`
+
+这些对象仍属于“前端越界逻辑继续后端化”的后续批次，不按无引用文件直接删除。
+
+---
+
+## 1. 删除判定口径
+
+本批只删除满足下面条件之一的对象：
+
+1. 无运行时入口、无脚本入口、无当前路由挂载。
+2. 已有现行正式实现，旧文件只剩 re-export / facade / 兼容命名。
+3. 只被测试验证旧壳自身，且该测试不再服务当前主流程门禁。
+4. 文档已明确该对象处于“后续只允许收缩、不再接新逻辑”的兼容残留状态。
+
+---
+
+## 2. 本批次已处理对象
+
+| 文件 | 判定 | 删除原因 | 替代路径 / 当前真相源 |
+| --- | --- | --- | --- |
+| `server-node/src/routes/rpgCreationAgentRoutes.ts` | 旧命名 re-export | 当前后端正式路由直接使用 `customWorldAgent.ts` | `server-node/src/routes/customWorldAgent.ts` |
+| `server-node/src/routes/rpgWorldGalleryRoutes.ts` | 空路由骨架 | 世界广场实际列表和详情已经进入世界库路由 | `server-node/src/routes/rpg-entry/rpgWorldLibraryRoutes.ts` |
+| `server-node/src/services/RpgAgentOrchestrator.ts` | 旧命名 re-export | 当前正式上下文直接使用 `CustomWorldAgentOrchestrator` | `server-node/src/services/customWorldAgentOrchestrator.ts` |
+| `server-node/src/services/RpgAgentSessionStore.ts` | 旧命名 re-export | 当前正式上下文直接使用 `CustomWorldAgentSessionStore` | `server-node/src/services/customWorldAgentSessionStore.ts` |
+| `server-node/src/services/customWorldWorkSummaryService.ts` | 旧兼容入口 | 测试和路由已改为直接使用 RPG 命名服务 | `server-node/src/services/RpgWorldWorkSummaryService.ts` |
+| `server-node/src/services/customWorldAgentPublishGateService.ts` | 旧发布门禁实现 | 当前 action executor 与作品库发布链已统一走 PublishingService | `server-node/src/services/customWorldAgentPublishingService.ts` |
+| `server-node/src/services/customWorldAgentPublishService.ts` | 旧发布实现 | 当前发布链不再编译旧 legacy result profile | `server-node/src/services/customWorldAgentPublishingService.ts` |
+| `server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts` | 旧 facade | runtime profile 已拆到目录模块并由 `index.ts` / `runtimeProfile.ts` 承接 | `server-node/src/modules/custom-world/runtime-profile/index.ts` |
+| `server-node/src/bridges/legacyBuildRuntimeBridge.ts` | 无引用旧桥 | 后端 runtime build / equipment 已直接在正式模块内使用 | `server-node/src/modules/runtime/**` |
+| `server-node/src/bridges/legacyRuntimeItemResolutionBridge.ts` | 旧桥 | runtime item 解析服务一并删除，正式运行时使用 `runtimeItemModule.ts` | `server-node/src/modules/runtime-item/runtimeItemModule.ts` |
+| `server-node/src/modules/runtime-item/runtimeItemResolutionService.ts` | 无正式入口 wrapper | 只被 barrel 和自身测试引用，未挂入 Express 运行时主链 | `server-node/src/modules/runtime-item/runtimeItemModule.ts` |
+| `server-node/src/modules/**/index.ts` | 无引用 barrel | 这些 barrel 没有被当前后端入口消费，反而制造“公共模块入口仍存在”的错觉 | 直接 import 具体正式模块 |
+| `server-node/src/routes/rpg-*/index.ts` | 无引用 barrel | 当前 Express app 直接 import 具体 route 文件 | `server-node/src/app.ts` 中的具体路由 |
+| `server-node/src/repositories/rpg-*/index.ts` | 无引用 barrel | 当前上下文直接 import 具体 repository | `server-node/src/server.ts` 中的具体仓储 |
+| `src/components/DeveloperTeamModal.tsx` | 无入口 UI | 平台主流程没有打开该弹窗的入口 | 无替代 UI，删除历史壳 |
+| `src/components/LazySkillEffectPreview.tsx` | 无入口 lazy 壳 | 正式技能预览直接使用 `SkillEffectPreview` | `src/components/SkillEffectPreview.tsx` |
+| `src/components/npcVisualEditorModel.ts` | 旧 NPC 形象写回模型 | 当前 RPG 创作编辑器使用 `CustomWorldNpcVisualEditor` 与结果页新入口 | `src/components/CustomWorldNpcVisualEditor.tsx`、`src/components/rpg-creation-editor/**` |
+| `src/components/npcVisualEditorPersistence.ts` | 旧 NPC 形象写回持久层 | 只被旧持久化测试引用，正式编辑入口已迁移 | `src/components/rpg-creation-editor/**` |
+| `src/components/rpg-creation-*/index.ts` | 无引用 barrel | 当前入口直接 import 具体 facade 文件，barrel 没有主流程消费 | 直接 import `RpgCreation*` 具体文件 |
+| `src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx` | 旧 facade | 当前编辑器 section 直接在 `RpgCreationEntityEditorShared.tsx` 中分发 | `src/components/rpg-creation-editor/RpgCreationEntityEditorShared.tsx` |
+| `src/data/editorValidation.ts` | 旧预设编辑器校验 | 当前主流程和内容门禁不再调用 | `scripts/validate-overrides.ts`、后端 editor API |
+| `src/editor/shared/EditorNotice.tsx` | 无入口共享 UI | 只被同批删除的 FormFields 使用 | 无替代 UI，删除历史编辑器壳 |
+| `src/editor/shared/FormFields.tsx` | 无入口共享 UI | 旧编辑器共享表单未接主流程 | 当前 RPG 编辑器组件内聚在 `rpg-creation-editor/**` |
+| `src/editor/shared/SectionCard.tsx` | 无入口共享 UI | 旧编辑器卡片未接主流程 | 当前 RPG 编辑器组件内聚在 `rpg-creation-editor/**` |
+| `src/hooks/rpg-runtime-story/npcEncounterActions.ts` | 旧 wrapper | 正式实现已在 `useRpgRuntimeNpcInteraction.ts`，测试已改到正式文件 | `src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts` |
+| `src/hooks/rpg-runtime-story/openingAdventure.ts` | 旧前端开局特殊流程 | 开局营地对白已由后端 `RpgRuntimeStoryActionDomain` 和当前 story context 承接 | `server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionDomain.ts` |
+| `src/hooks/rpg-runtime-story/storyCampCompanion.ts` | 旧前端营地同伴 helper | 只剩旧开局流程和自身测试引用，正式开局上下文已迁到当前 runtime story 链 | 后端 runtime story action domain 与 `storyContextBuilder.ts` |
+| `src/hooks/rpg-runtime-story/storyRenderingHelpers.ts` | 无入口旧渲染 helper | 当前正式 story presentation 不再 import | `src/hooks/rpg-runtime-story/storyPresentation.ts` |
+| `src/prompts/questPrompts.ts` | 前端 prompt 残留 | Quest prompt 真相已迁到后端 | `server-node/src/prompts/questPrompts.ts` |
+| `src/prompts/runtimeItemPrompts.ts` | 前端 prompt 残留 | Runtime item prompt 真相已迁到后端 | `server-node/src/prompts/runtimeItemPrompts.ts` |
+| `src/services/questPrompt.ts` | 前端 prompt re-export | 只指向同批删除的前端 prompt | `server-node/src/prompts/questPrompts.ts` |
+| `src/services/runtimeItemAiPrompt.ts` | 前端 prompt re-export | 只指向同批删除的前端 prompt | `server-node/src/prompts/runtimeItemPrompts.ts` |
+| `src/services/storyEngine/contentDependencyGraph.ts` | 实验性孤岛 | 只被自身测试引用，没有主流程消费 | 后续如需要重新设计到后端 story graph 服务 |
+
+---
+
+## 3. 同步调整
+
+1. `customWorldAgentPhase2/3/4` 测试改为直接实例化 `RpgWorldWorkSummaryService`。
+2. `customWorldWorkSummaryService.integration.test.ts` 改为直接覆盖 `RpgWorldWorkSummaryService`。
+3. `npcEncounterActions.test.ts` 改为直接覆盖 `useRpgRuntimeNpcInteraction.ts`，不再通过旧 wrapper。
+4. `story_opening_camp_dialogue` 的 function catalog 执行路径改为后端 runtime action domain，不再指向已删除旧前端文件。
+5. NPC function catalog 中 `npc_chat / npc_help / npc_leave / npc_fight / npc_spar / npc_preview_talk` 的 executor 路牌改到现行 `useRpgRuntimeNpcInteraction.ts`。
+
+---
+
+## 4. 本批次暂缓对象
+
+以下对象仍然保留，原因是它们不是“无引用死代码”，而是需要下一轮按 contract 或主链职责迁移：
+
+1. `src/services/questDirector.ts`
+2. `src/services/runtimeItemAiDirector.ts`
+3. `src/services/ai.ts`
+4. `src/data/sceneObservation.ts`
+5. `server-node/ecosystem.config.cjs`
+6. `server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts`
+
+其中 `ecosystem.config.cjs` 被部署脚本直接使用；`sceneObservation.ts` 被内容 smoke 脚本验证；`syncCustomWorldSavedProfileAssets.ts` 是一次性运维脚本，后续要单独按运维脚本治理口径确认是否归档。
+
+---
+
+## 5. 验证口径
+
+本批删除后建议验证：
+
+1. `npm run check:encoding`
+2. `npx tsx --test server-node/src/services/customWorldWorkSummaryService.integration.test.ts`
+3. `npx vitest run src/hooks/rpg-runtime-story/npcEncounterActions.test.ts`
+4. `npm run server-node:build`
+5. `npm run build`
+
+如果 `npm run build` 仍被既有 chunk warning 拦截，需要单独记录为既有门禁问题，不归因到本批删除。
+
+---
+
+## 6. 当前结论
+
+本批次进一步删除了“旧命名入口、旧 facade、旧 prompt 前端镜像、无入口编辑器壳层”这批容易误导后续开发的文件。
+
+后续清理不应继续按“静态无引用”直接推进，而应进入两类工作：
+
+1. 运行时 / 任务 / 物品 / AI 的后端 contract 收口。
+2. RPG 创作编辑器与运行时热点文件的职责拆分。
diff --git a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_F_2026-04-21.md b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_F_2026-04-21.md
new file mode 100644
index 00000000..5c26b54e
--- /dev/null
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_F_2026-04-21.md
@@ -0,0 +1,91 @@
+# 工程死分支清理执行记录 F（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+本批次承接批次 E 的验证结果，继续处理删除后暴露出的最后一组高置信残留：
+
+1. 已经没有任何代码入口引用的前端任务生成 director。
+2. 只被内容 smoke 牵住、但不再是正式运行时入口的旧观察文案 helper。
+3. 带有固定用户、固定 session、固定 profile 的一次性历史同步脚本。
+4. 清理后暴露出的 function catalog 契约覆盖缺口。
+
+本批次仍然不按文件名直接删除 `legacy` 命名对象。经核对，`server-node/src/bridges/legacyInventoryRuntimeBridge.ts`、`legacyNpcTask6Bridge.ts`、`legacyQuestProgressBridge.ts`、`legacyQuestRuntimeBridge.ts`、`legacyRuntimeItemBridge.ts`、`legacyTreasureRuntimeBridge.ts` 仍被后端战斗、背包、任务、宝藏主链直接引用，不能按历史命名硬删。
+
+---
+
+## 1. 删除判定口径
+
+本批删除对象必须同时满足：
+
+1. 修正 `.js -> .ts` 后端源码解析、前端懒加载入口解析后，仍不可从正式入口到达。
+2. 全仓库代码引用扫描没有正式入口引用。
+3. 如只被 smoke 或测试牵住，先把 smoke / 测试改到当前正式主链，再删除旧对象。
+4. 删除后通过对应门禁验证，没有新增悬空 import。
+
+---
+
+## 2. 本批次已处理对象
+
+| 文件 | 判定 | 删除 / 调整原因 | 替代路径 / 当前真相源 |
+| --- | --- | --- | --- |
+| `src/services/questDirector.ts` | 无代码入口残留 | 正式 quest 生成已由后端 `/api/runtime/quests/generate` 与 `questService.ts` 承接，前端当前没有任何 import | `server-node/src/services/questService.ts`、`server-node/src/modules/quest/runtimeQuestModule.ts` |
+| `src/data/sceneObservation.ts` | 旧观察文案 helper | 只被 `scripts/smoke-content.ts` 引用，正式观察动作已走 `idle_observe_signs` function 与运行时 story continuation | `src/data/functionCatalog/state/idleObserveSigns.ts`、`src/hooks/rpg-runtime-story/storyChoiceContinuation.ts` |
+| `server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts` | 一次性硬编码运维脚本 | 脚本内固定用户、session、profile，只服务历史补丁，没有 CLI 参数和当前运维入口 | 无替代；如未来需要，按参数化运维脚本重新设计 |
+
+---
+
+## 3. 同步调整
+
+1. `scripts/smoke-content.ts` 不再 import 旧 `sceneObservation.ts`，改为通过 `resolveFunctionOption('idle_observe_signs', ...)` 验证当前正式 function 目录。
+2. `packages/shared/src/contracts/rpgRuntimeContracts.test.ts` 不再验证已移除的旧 `story` façade，改为直接验证当前拆分契约。
+3. `src/data/functionCatalog/` 补齐仍在后端运行时契约中的 function 文档：
+   - `battle_attack_basic`
+   - `battle_use_skill`
+   - `npc_chat_quest_offer_view`
+   - `npc_chat_quest_offer_replace`
+   - `npc_chat_quest_offer_abandon`
+4. `battle_attack_basic` 与 `battle_use_skill` 只作为后端契约文档登记，不进入 `STATE_FUNCTION_DEFINITIONS`，避免前端本地候选池生成缺少 `runtimePayload.skillId` 的假技能 option。
+
+---
+
+## 4. 本批次暂缓对象
+
+以下对象经本批复核后继续保留：
+
+1. `server-node/src/services/customWorldAgentRepositoryTestHelpers.ts`
+2. `server-node/src/services/customWorldAgentTestHelpers.ts`
+3. `server-node/src/testFixtures/runtimeCharacter.ts`
+4. `server-node/src/testHttp.ts`
+
+这些文件不属于正式运行时入口，但当前被后端测试、smoke 与路由边界门禁使用。它们不是 RPG 创作 / 运行时玩法主流程代码，但仍是平台基本质量门禁的一部分，不能在“删除冗余业务代码”批次里直接硬删。
+
+另保留：
+
+1. `src/services/runtimeItemAiDirector.ts`
+2. `src/services/ai.ts`
+3. `src/services/apiClient.ts`
+
+这些文件仍被当前主链或前端 SDK 入口引用，后续如继续压缩，必须先完成对应 contract / SDK 拆分，不按无引用规则删除。
+
+---
+
+## 5. 验证结果
+
+本批已通过：
+
+1. `npx vitest run src/data/functionCatalog/functionCatalog.test.ts packages/shared/src/contracts/rpgRuntimeContracts.test.ts`
+2. `npx tsx scripts/smoke-content.ts`
+3. `npm run check:encoding`
+
+并额外确认：
+
+1. 全仓库代码中不再引用 `sceneObservation`、`questDirector`、`syncCustomWorldSavedProfileAssets`。
+2. `buildStateFunctionDefinitions()` 中不会出现 `battle_attack_basic` / `battle_use_skill`，这两个 function 只由后端运行时 option 池下发。
+
+---
+
+## 6. 当前结论
+
+本批次后，静态入口扫描中剩余的高置信“不可达源码”已经收敛为测试辅助、测试夹具和 smoke helper。继续删除前需要先重构测试基础设施或迁移剩余前端 SDK，而不应再按文件名或历史命名直接硬删。
diff --git a/docs/audits/engineering/README.md b/docs/audits/engineering/README.md
index 94efb4c8..0fd8f240 100644
--- a/docs/audits/engineering/README.md
+++ b/docs/audits/engineering/README.md
@@ -4,27 +4,31 @@
 
 ## 当前推荐入口
 
-1. [FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md](./FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md)
+1. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_F_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_F_2026-04-21.md)
+   这一版是第六批落地记录，聚焦删除无入口 `questDirector`、旧观察文案 helper、一次性硬编码同步脚本，并补齐后端运行时 function catalog 契约覆盖。
+2. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_E_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_E_2026-04-21.md)
+   这一版是第五批落地记录，聚焦旧命名 re-export、空路由骨架、旧发布服务、前端 prompt 镜像与无入口编辑器壳层的物理删除。
+3. [FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md](./FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md)
    这一版是本轮前端越界逻辑专项审计，专门汇总当前仍应继续迁到 Express 后端的运行时、鉴权、生成编排与本地真相残留。
-2. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md)
+4. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md)
    这一版是第四批落地记录，聚焦未接入业务的数据生成产物、测试专用 stub 与对应配置残留出清。
-3. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md)
+5. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md)
    这一版是第三批落地记录，聚焦鉴权真相收口，先移除前端保存自动登录用户名/密码的本地真相，并明确运行时快照前置写入为什么当前还不能硬砍。
-4. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md)
+6. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md)
    这一版是第二批落地记录，聚焦旧主流程壳层、旧 bootstrap 和旧 inventory / forge / equipment flow Hook 的正式出清。
-5. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md)
+7. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md)
    这一版是第一批落地记录，聚焦高置信度小型孤岛、prompt 壳子、stub 和无入口 modal 的首轮清理。
-6. [CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md](./CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md)
+8. [CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md](./CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md)
    这一版是面向当前仓库状态的优化点盘点，适合直接拿来排优先级和拆执行批次。
-7. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md)
+9. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md)
    这一版是对 `2026-04-19` 基线的当前仓库复核，明确哪些问题已经处理、哪些表述需要纠正、热点又迁移到了哪里。
-8. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md)
+10. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md)
    这一版保留原始问题快照和执行回填，适合回看“为什么会有这轮清理与边界收口”。
-9. [ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md)
+11. [ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md)
    这一版最适合作为当前工程基线，重点从“是否真正绿色”“门禁有没有覆盖真实风险”来判断仓库状态。
-10. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md)
+12. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md)
    适合回看运行时主链路、Story/Combat 边界、分层过渡期问题。
-11. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md)
+13. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md)
    适合看第一轮系统性工程扫描，了解最早的问题基线。
 
 ## 融合结论
@@ -34,6 +38,8 @@
 - 第二批已经开始清理旧主流程壳层与旧 flow Hook，当前主工程的“现行入口”和“历史入口”边界正在变得更清楚。
 - 第三批已经先完成鉴权真相收口的一段，前端不再保存自动登录用户名/密码；运行时快照链仍需先补后端 contract，再继续往前删。
 - 第四批已经继续收掉未接入业务的数据生成产物、测试专用 stub 与对应脚本/配置残留，主工程里的“假数据主源”进一步减少。
+- 第五批已经继续收掉旧命名 re-export、空路由骨架、旧发布 service、前端 prompt 镜像与无入口编辑器壳层，主工程里的“假入口”和“假 prompt 主源”进一步减少。
+- 第六批已经继续收掉无入口 `questDirector`、旧观察文案 helper、一次性硬编码同步脚本，并修复 function catalog 对后端运行时契约的覆盖缺口。
 - 当前仓库已经完成“旧 dev 插件链路删除、根目录噪音清理、`server-node -> src/**` 反向依赖切断”这批第一阶段任务。
 - 当前如果想直接判断“今天先优化什么”，优先看 `CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md`。
 - 当前的新重点已经进一步收敛到三类：未接线孤岛模块、前端残留的运行时/鉴权真相、热点向 prompt/runtime profile/平台入口壳层迁移。
diff --git a/docs/experience/AGENT_UI_CHANGELOG.md b/docs/experience/AGENT_UI_CHANGELOG.md
index 80c40c9f..16a87f01 100644
--- a/docs/experience/AGENT_UI_CHANGELOG.md
+++ b/docs/experience/AGENT_UI_CHANGELOG.md
@@ -163,4 +163,13 @@
 
 ---
 
+## 13. 2026-04-21 创作中心失效草稿恢复兜底
+
+- `src/components/rpg-entry/useRpgEntryLibraryDetail.ts` 现在会识别 `custom-world agent session` 的 `404 NOT_FOUND` 读取失败，不再把这类错误直接冒泡成未捕获 Promise。
+- 当用户在创作中心点击“继续创作”命中失效草稿时，前端会主动清空 `customWorldSessionId` 恢复参数，并刷新一次 works 列表，避免刷新页面后反复尝试恢复同一个坏会话。
+- 当前交互已收口成平台内可见提示：用户会停留在创作中心，并看到“这份共创草稿已失效，已为你返回创作中心，请重新开始创作。”，而不是卡在空白工作区或只在控制台看到英文异常。
+- 这次兜底只处理失效会话恢复，不改变正常草稿继续创作、结果页恢复和已发布作品进入世界的主链。
+
+---
+
 _文档目的：交接给下一个 Agent 时，优先读本文件 + `UI_CODING_STANDARD.md`，再改 `uiAssets.ts` / `App.tsx` / `index.css`。_
diff --git a/docs/reference/FUNCTION_SCRIPT_CATALOG_2026-04-04.md b/docs/reference/FUNCTION_SCRIPT_CATALOG_2026-04-04.md
index 6e99aaf6..e422d142 100644
--- a/docs/reference/FUNCTION_SCRIPT_CATALOG_2026-04-04.md
+++ b/docs/reference/FUNCTION_SCRIPT_CATALOG_2026-04-04.md
@@ -32,6 +32,14 @@
 
 ## 基础状态 Function
 
+- `battle_attack_basic`
+  脚本：`src/data/functionCatalog/state/battleAttackBasic.ts`
+  说明：后端单行为战斗模型中的普通攻击 function。它由后端战斗 option 池下发，前端只透传 functionId，不进入前端本地 `STATE_FUNCTION_DEFINITIONS` 候选池。
+
+- `battle_use_skill`
+  脚本：`src/data/functionCatalog/state/battleUseSkill.ts`
+  说明：后端单行为战斗模型中的技能释放 function。每个技能 option 必须携带 `runtimePayload.skillId`，因此只登记文档和契约，不作为前端本地泛用 state function 生成。
+
 - `battle_all_in_crush`
   脚本：`src/data/functionCatalog/state/battleAllInCrush.ts`
   说明：战斗中的正面强压动作，只在 `battle` 状态且有存活敌人时进入候选池。它会提高伤害与终结/爆发技能权重，同时抬高承伤，适合收头、压血和赌一波换血抢节奏。
@@ -110,6 +118,18 @@
   脚本：`src/data/functionCatalog/npc/npcChat.ts`
   说明：围绕当前话题与 NPC 继续交谈的 function。它会先生成对话正文，再把真正的新选项延迟到 `story_continue_adventure` 之后展示。
 
+- `npc_chat_quest_offer_view`
+  脚本：`src/data/functionCatalog/npc/npcChatQuestOffer.ts`
+  说明：聊天内待领取委托的查看入口，只查看 pending quest offer，不立即写入正式任务日志。
+
+- `npc_chat_quest_offer_replace`
+  脚本：`src/data/functionCatalog/npc/npcChatQuestOffer.ts`
+  说明：聊天内待领取委托的更换入口，重新走任务生成链替换当前 pending quest offer。
+
+- `npc_chat_quest_offer_abandon`
+  脚本：`src/data/functionCatalog/npc/npcChatQuestOffer.ts`
+  说明：聊天内待领取委托的放弃入口，只清空 pending quest offer，不影响已接任务。
+
 - `npc_gift`
   脚本：`src/data/functionCatalog/npc/npcGift.ts`
   说明：向 NPC 送礼的入口 function。第一次点击通常只打开礼物面板，确认礼物后才结算好感变化并继续剧情。
@@ -186,6 +206,7 @@
 
 ## 当前实现约定
 
-- `src/data/stateFunctions.ts` 现在只负责基础 state function 的聚合、override 合并、运行时过滤和 option 解析。
+- `src/data/stateFunctions.ts` 现在只负责前端本地基础 state function 的聚合、override 合并、运行时过滤和 option 解析。
+- `battle_attack_basic` / `battle_use_skill` 虽然属于后端运行时契约中的战斗 function，但不进入 `STATE_FUNCTION_DEFINITIONS`。它们由后端 runtime story / combat option 池生成，避免前端本地生成缺少 `runtimePayload` 的假选项。
 - 非 state function 目前仍由各自原有流程模块执行，但它们的 `id`、标题和详细说明已经统一收口到 `functionCatalog/`。
 - 后续新增 function 时，建议先补独立脚本，再把运行时调用接进来，最后同步这份目录文档。
diff --git a/docs/technical/AGENT_DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md b/docs/technical/AGENT_DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md
index 9079d0da..ac183414 100644
--- a/docs/technical/AGENT_DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md
+++ b/docs/technical/AGENT_DRAFT_RESULT_ASSET_MERGE_FIX_2026-04-21.md
@@ -94,3 +94,26 @@
 1. `legacyResultProfile` 继续长期作为结果页主列表来源风险很高
 2. 只做“按 id 回贴图片字段”在对象集合会漂移的链路里不够稳
 3. 后续如果继续推进后端单一真相源，应优先把结果页对象集合完全改为服务端最新 compile/preview 结果，而不是继续让前端桥接层承担最终裁决
+
+---
+
+## 8. 2026-04-21 补充：新建共创会话 500 根因
+
+后续联调里又发现一条与资产合并无关、但会直接阻断创作入口的后端问题：
+
+1. 点击“创建新 RPG 游戏”时，`POST /api/runtime/custom-world/agent/sessions` 返回 `500`
+2. 表面上前端只看到“服务器内部错误”，实际根因在路由层
+
+本次补查确认：
+
+1. `server-node/src/routes/customWorldAgent.ts` 这组路由内部直接使用 `request.userId!`
+2. 但路由文件本身在 `2026-04-21` 修复前没有挂 `requireJwtAuth(...)`
+3. 结果是 HTTP 请求虽然带了登录 token，但 `request.userId` 并不会被注入
+4. 后端继续拿 `undefined` 作为 `userId` 创建 / 读取 agent session，最终在仓储写库阶段触发 `500`
+
+修复方式：
+
+1. 在 `createCustomWorldAgentRoutes(...)` 顶部统一补上 `router.use(requireJwtAuth(context.config, context.userRepository))`
+2. 让 session 创建、读取、发消息、执行 action、读取 operation / card 详情全部走同一层鉴权注入
+
+这次补丁的意义不是新增功能，而是把 `custom-world agent` 路由和其他 `rpg-entry / rpg-profile / rpg-runtime` 受保护接口重新对齐，避免再出现“路由里依赖 `request.userId`，但入口没挂鉴权”的低层断线问题。
diff --git a/packages/shared/src/contracts/rpgRuntimeContracts.test.ts b/packages/shared/src/contracts/rpgRuntimeContracts.test.ts
index e1e8fff0..d402dcf8 100644
--- a/packages/shared/src/contracts/rpgRuntimeContracts.test.ts
+++ b/packages/shared/src/contracts/rpgRuntimeContracts.test.ts
@@ -1,17 +1,17 @@
 import { describe, expect, test } from 'vitest';
 
+import type { CharacterChatReplyRequest } from './rpgRuntimeChat';
+import { QUEST_NARRATIVE_TYPES } from './rpgRuntimeQuestAssist';
 import {
-  CharacterChatReplyRequest,
-  QUEST_NARRATIVE_TYPES,
-  RuntimeStoryActionRequest,
   SERVER_RUNTIME_FUNCTION_IDS,
+  TASK5_RUNTIME_OPTION_SCOPES,
   TASK6_RUNTIME_FUNCTION_IDS,
-} from './story';
-import { TASK5_RUNTIME_OPTION_SCOPES } from './rpgRuntimeStoryAction';
+  type RuntimeStoryActionRequest,
+} from './rpgRuntimeStoryAction';
 import type { RuntimeStoryStateRequest } from './rpgRuntimeStoryState';
 
-describe('RPG runtime shared contract façades', () => {
-  test('旧 story façade 继续导出 runtime story action 常量与类型', () => {
+describe('RPG runtime shared contracts', () => {
+  test('拆分后的 runtime story action 契约继续导出常量与类型', () => {
     expect(SERVER_RUNTIME_FUNCTION_IDS).toContain('npc_chat');
     expect(TASK6_RUNTIME_FUNCTION_IDS).toContain('npc_trade');
     expect(TASK5_RUNTIME_OPTION_SCOPES).toEqual(['story', 'combat', 'npc']);
@@ -27,7 +27,7 @@ describe('RPG runtime shared contract façades', () => {
     expect(request.action.functionId).toBe('npc_chat');
   });
 
-  test('旧 story façade 继续导出 chat 与 quest assist 契约', () => {
+  test('拆分后的 chat 与 quest assist 契约继续导出运行时类型', () => {
     const payload: CharacterChatReplyRequest = {
       worldType: 'WUXIA',
       playerCharacter: {},
diff --git a/scripts/smoke-content.ts b/scripts/smoke-content.ts
index 1eed50f0..0929a65d 100644
--- a/scripts/smoke-content.ts
+++ b/scripts/smoke-content.ts
@@ -25,8 +25,8 @@ import {
 } from '../src/data/questFlow.ts';
 import { createInitialGameRuntimeStats } from '../src/data/runtimeStats.ts';
 import { createSceneCallOutEncounter, createSceneEncounterPreview, ensureSceneEncounterPreview } from '../src/data/sceneEncounterPreviews.ts';
-import { buildSceneObserveSignsStoryText } from '../src/data/sceneObservation.ts';
 import { getSceneHostileNpcPresetIds, getScenePresetsByWorld } from '../src/data/scenePresets.ts';
+import { resolveFunctionOption } from '../src/data/stateFunctions.ts';
 import { buildTreasureEncounterStoryMoment, buildTreasureResultText, resolveTreasureReward } from '../src/data/treasureInteractions.ts';
 import { AnimationState, GameState, WorldType } from '../src/types.ts';
 
@@ -209,8 +209,24 @@ function smokeObserveAndCallOut() {
     assert(callOutResult.currentEncounter?.kind !== 'treasure', `[idle] treasure call_out should be disabled for ${worldType}`);
     assert(callOutResult.currentEncounter || callOutResult.sceneHostileNpcs.length > 0 || getSceneHostileNpcPresetIds(scene).length === 0, `[idle] call_out failed for ${scene.id}`);
 
-    const observeText = buildSceneObserveSignsStoryText(worldType, scene.id);
-    assert(observeText.length > 12, `[idle] observe_signs text too short for ${scene.id}`);
+    const observeOption = resolveFunctionOption(
+      'idle_observe_signs',
+      {
+        worldType,
+        playerCharacter: baseState.playerCharacter,
+        inBattle: false,
+        currentSceneId: scene.id,
+        currentSceneName: scene.name,
+        monsters: [],
+        playerHp: baseState.playerHp,
+        playerMaxHp: baseState.playerMaxHp,
+        playerMana: baseState.playerMana,
+        playerMaxMana: baseState.playerMaxMana,
+      },
+      '观察周围动静',
+    );
+    assert(observeOption?.functionId === 'idle_observe_signs', `[idle] observe_signs option missing for ${scene.id}`);
+    assert(Boolean(observeOption?.detailText?.trim()), `[idle] observe_signs detail missing for ${scene.id}`);
   }
 }
 
diff --git a/server-node/src/bridges/legacyBuildRuntimeBridge.ts b/server-node/src/bridges/legacyBuildRuntimeBridge.ts
deleted file mode 100644
index 63310ec3..00000000
--- a/server-node/src/bridges/legacyBuildRuntimeBridge.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-// Temporary bridge for legacy pure build calculation logic from src/**.
-export { getEquipmentBonuses } from '../modules/runtime/runtimeEquipmentModule.js';
-export {
-  getPlayerBuildDamageBreakdown,
-  resolvePlayerOutgoingDamageResult,
-} from '../modules/runtime/runtimeBuildModule.js';
diff --git a/server-node/src/bridges/legacyRuntimeItemResolutionBridge.ts b/server-node/src/bridges/legacyRuntimeItemResolutionBridge.ts
deleted file mode 100644
index 7e624643..00000000
--- a/server-node/src/bridges/legacyRuntimeItemResolutionBridge.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-// Temporary bridge for legacy pure runtime item resolution logic from src/**.
-export {
-  buildLooseRuntimeItemGenerationContext,
-  buildQuestRuntimeItemGenerationContext,
-  buildDirectedRuntimeReward,
-  buildRuntimeInventoryStock,
-  flattenDirectedRuntimeRewardItems,
-} from '../modules/runtime-item/runtimeItemModule.js';
diff --git a/server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts b/server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts
deleted file mode 100644
index 7a78cd49..00000000
--- a/server-node/src/modules/custom-world/runtime-profile/runtimeProfileCompiler.ts
+++ /dev/null
@@ -1,13 +0,0 @@
-/**
- * 兼容期 façade：
- * 旧的 runtimeProfileCompiler 文件名暂时保留，避免工作包 G 完整拆分后影响仍未迁移的局部导入。
- * 新实现已经拆到目录模块中，后续新增逻辑禁止继续回写到这个文件。
- */
-export * from './buildAttributeSchema.js';
-export * from './buildCompiledProfile.js';
-export * from './creatorIntentBridge.js';
-export * from './normalizeCamp.js';
-export * from './normalizeLandmark.js';
-export * from './normalizeRole.js';
-export * from './normalizeSceneChapter.js';
-export * from './normalizeShared.js';
diff --git a/server-node/src/modules/inventory/index.ts b/server-node/src/modules/inventory/index.ts
deleted file mode 100644
index 4db0479b..00000000
--- a/server-node/src/modules/inventory/index.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from './inventoryMutationService.js';
diff --git a/server-node/src/modules/quest/index.ts b/server-node/src/modules/quest/index.ts
deleted file mode 100644
index b06b5a3f..00000000
--- a/server-node/src/modules/quest/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export * from './questProgressionService.js';
-export { generateQuestForNpcEncounter } from '../../services/questService.js';
diff --git a/server-node/src/modules/rpg-runtime-story/index.ts b/server-node/src/modules/rpg-runtime-story/index.ts
deleted file mode 100644
index 9497cded..00000000
--- a/server-node/src/modules/rpg-runtime-story/index.ts
+++ /dev/null
@@ -1,35 +0,0 @@
-export {
-  buildRpgRuntimeAvailableOptions,
-  buildRpgRuntimeLegacyCurrentStory,
-  buildRpgRuntimeViewModel,
-} from './RpgRuntimeOptionCompiler.js';
-export {
-  appendStoryHistory,
-  getEncounterKey,
-  getEncounterNpcState,
-  getPlayerCharacter,
-  getPlayerSkillCooldowns,
-  isCombatFunctionId,
-  isNpcFunctionId,
-  isStoryFunctionId,
-  isTask5FunctionId,
-  isTask6RuntimeFunctionId,
-  MAX_TASK5_COMPANIONS,
-  setEncounterNpcState,
-  TASK6_DEFERRED_FUNCTION_IDS,
-  type RuntimeEncounter,
-  type RuntimeNpcState,
-  type RuntimeSession as RuntimeSessionPrimitives,
-} from './RpgRuntimeSessionPrimitives.js';
-export {
-  loadRpgRuntimeSession,
-  type RuntimeSession,
-} from './RpgRuntimeSessionLoader.js';
-export {
-  replaceRpgRuntimeSessionRawGameState,
-  syncRpgRuntimeSnapshot,
-} from './RpgRuntimeSnapshotSync.js';
-export {
-  resolveRpgRuntimeStoryAction,
-} from './RpgRuntimeStoryActionService.js';
-export { getRpgRuntimeStoryState } from './RpgRuntimeStoryStateService.js';
diff --git a/server-node/src/modules/runtime-item/index.ts b/server-node/src/modules/runtime-item/index.ts
deleted file mode 100644
index 5d4b46ca..00000000
--- a/server-node/src/modules/runtime-item/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export * from './runtimeItemResolutionService.js';
-export { generateRuntimeItemIntents } from '../../services/runtimeItemService.js';
diff --git a/server-node/src/modules/runtime-item/runtimeItemResolutionService.test.ts b/server-node/src/modules/runtime-item/runtimeItemResolutionService.test.ts
deleted file mode 100644
index 43dc64c1..00000000
--- a/server-node/src/modules/runtime-item/runtimeItemResolutionService.test.ts
+++ /dev/null
@@ -1,96 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-
-import {
-  buildLooseRuntimeItemGenerationContext,
-  buildQuestRuntimeItemGenerationContext,
-} from '../../bridges/legacyRuntimeItemResolutionBridge.js';
-import {
-  resolveDirectedReward,
-  resolveRuntimeInventoryStock,
-} from './runtimeItemResolutionService.js';
-
-const TEST_WUXIA_WORLD = 'WUXIA' as Parameters<
-  typeof buildLooseRuntimeItemGenerationContext
->[0]['worldType'];
-const TEST_XIANXIA_WORLD = 'XIANXIA' as NonNullable<
-  Parameters<typeof buildQuestRuntimeItemGenerationContext>[0]['context']['worldType']
->;
-
-test('resolveDirectedReward returns flattened runtime reward items on the server side', () => {
-  const context = buildLooseRuntimeItemGenerationContext({
-    worldType: TEST_WUXIA_WORLD,
-    scene: {
-      id: 'scene-ruins',
-      name: '断碑古道',
-      description: '碎碑与旧誓散落在路旁。',
-      treasureHints: ['残匣', '旧祭火'],
-    },
-    encounter: {
-      id: 'treasure-altar',
-      kind: 'treasure',
-      npcName: '断誓秘匣',
-      npcDescription: '匣盖上留着未熄的旧印。',
-      npcAvatar: '',
-      context: '古道祭坛',
-    },
-    playerCharacterId: 'hero',
-    playerBuildTags: ['快剑', '追击'],
-    generationChannel: 'treasure',
-  });
-
-  const result = resolveDirectedReward(context, {
-    seedKey: 'task6:treasure',
-    fixedKinds: ['relic', 'consumable'],
-    fixedPermanence: ['permanent', 'timed'],
-    itemCount: 2,
-  });
-
-  assert.equal(result.items.length, 2);
-  assert.equal(
-    result.reward.primaryItem?.runtimeMetadata?.generationChannel,
-    'treasure',
-  );
-  assert.equal(result.items[0]?.id, result.reward.primaryItem?.id);
-  assert.ok(result.reward.primaryItem?.description?.includes('构筑'));
-});
-
-test('resolveRuntimeInventoryStock builds quest-flavored stock without browser fallback', () => {
-  const context = buildQuestRuntimeItemGenerationContext({
-    context: {
-      worldType: TEST_XIANXIA_WORLD,
-      currentSceneId: 'scene-cloud',
-      currentSceneName: '云阙旧渡',
-      currentSceneDescription: '旧渡口残留着灵潮和巡守痕迹。',
-      issuerNpcId: 'npc-issuer',
-      issuerNpcName: '巡守使',
-      issuerNpcContext: '巡守',
-      issuerAffinity: 24,
-      recentStoryMoments: [],
-      playerCharacter: null,
-    },
-    issuerNpcId: 'npc-issuer',
-    issuerNpcName: '巡守使',
-    roleText: '巡守',
-    scene: {
-      id: 'scene-cloud',
-      name: '云阙旧渡',
-      description: '旧渡口残留着灵潮和巡守痕迹。',
-      treasureHints: ['旧印'],
-    },
-  });
-
-  const items = resolveRuntimeInventoryStock(context, {
-    seedKey: 'task6:quest',
-    fixedKinds: ['equipment', 'consumable'],
-    fixedPermanence: ['permanent', 'timed'],
-    itemCount: 2,
-  });
-
-  assert.equal(items.length, 2);
-  assert.equal(
-    items.every((item) => item.runtimeMetadata?.generationChannel === 'quest_reward'),
-    true,
-  );
-  assert.equal(items.some((item) => Boolean(item.buildProfile || item.useProfile)), true);
-});
diff --git a/server-node/src/modules/runtime-item/runtimeItemResolutionService.ts b/server-node/src/modules/runtime-item/runtimeItemResolutionService.ts
deleted file mode 100644
index 0f43c088..00000000
--- a/server-node/src/modules/runtime-item/runtimeItemResolutionService.ts
+++ /dev/null
@@ -1,39 +0,0 @@
-import {
-  buildDirectedRuntimeReward,
-  buildRuntimeInventoryStock,
-  flattenDirectedRuntimeRewardItems,
-} from '../../bridges/legacyRuntimeItemResolutionBridge.js';
-
-export type RuntimeItemGenerationContext = Parameters<
-  typeof buildDirectedRuntimeReward
->[0];
-export type RuntimeRewardOptions = Parameters<
-  typeof buildDirectedRuntimeReward
->[1];
-export type DirectedRuntimeReward = ReturnType<typeof buildDirectedRuntimeReward>;
-export type ResolvedRuntimeRewardItem = ReturnType<
-  typeof buildRuntimeInventoryStock
->[number];
-
-export type RuntimeRewardResolution = {
-  reward: DirectedRuntimeReward;
-  items: ResolvedRuntimeRewardItem[];
-};
-
-export function resolveDirectedReward(
-  context: RuntimeItemGenerationContext,
-  options: RuntimeRewardOptions,
-): RuntimeRewardResolution {
-  const reward = buildDirectedRuntimeReward(context, options);
-  return {
-    reward,
-    items: flattenDirectedRuntimeRewardItems(reward),
-  };
-}
-
-export function resolveRuntimeInventoryStock(
-  context: RuntimeItemGenerationContext,
-  options: RuntimeRewardOptions,
-): ResolvedRuntimeRewardItem[] {
-  return buildRuntimeInventoryStock(context, options);
-}
diff --git a/server-node/src/repositories/rpg-entry/index.ts b/server-node/src/repositories/rpg-entry/index.ts
deleted file mode 100644
index 674edd5b..00000000
--- a/server-node/src/repositories/rpg-entry/index.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-export {
-  RpgSaveArchiveRepository,
-  type RpgSaveArchiveRepositoryPort,
-} from './RpgSaveArchiveRepository.js';
-export {
-  RpgWorldLibraryRepository,
-  type RpgWorldLibraryRepositoryPort,
-} from './RpgWorldLibraryRepository.js';
diff --git a/server-node/src/repositories/rpg-profile/index.ts b/server-node/src/repositories/rpg-profile/index.ts
deleted file mode 100644
index 9abdcd25..00000000
--- a/server-node/src/repositories/rpg-profile/index.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-export {
-  RpgBrowseHistoryRepository,
-  type RpgBrowseHistoryRepositoryPort,
-} from './RpgBrowseHistoryRepository.js';
-export {
-  RpgProfileDashboardRepository,
-  type RpgProfileDashboardRepositoryPort,
-} from './RpgProfileDashboardRepository.js';
diff --git a/server-node/src/repositories/rpg-runtime/index.ts b/server-node/src/repositories/rpg-runtime/index.ts
deleted file mode 100644
index 759f002b..00000000
--- a/server-node/src/repositories/rpg-runtime/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-export {
-  RpgRuntimeSnapshotRepository,
-  type RpgRuntimeSnapshotRepositoryPort,
-} from './RpgRuntimeSnapshotRepository.js';
diff --git a/server-node/src/routes/customWorldAgent.ts b/server-node/src/routes/customWorldAgent.ts
index 7ae5c472..b862452c 100644
--- a/server-node/src/routes/customWorldAgent.ts
+++ b/server-node/src/routes/customWorldAgent.ts
@@ -9,6 +9,7 @@ import type {
 import type { AppContext } from '../context.js';
 import { badRequest, notFound } from '../errors.js';
 import { asyncHandler, prepareApiResponse, sendApiResponse } from '../http.js';
+import { requireJwtAuth } from '../middleware/auth.js';
 import { routeMeta } from '../middleware/routeMeta.js';
 
 const createSessionSchema = z.object({
@@ -98,6 +99,9 @@ function readParam(param: string | string[] | undefined) {
 
 export function createCustomWorldAgentRoutes(context: AppContext) {
   const router = Router();
+  const requireAuth = requireJwtAuth(context.config, context.userRepository);
+
+  router.use(requireAuth);
 
   router.post(
     '/sessions',
diff --git a/server-node/src/routes/rpg-entry/index.ts b/server-node/src/routes/rpg-entry/index.ts
deleted file mode 100644
index f5e9f05d..00000000
--- a/server-node/src/routes/rpg-entry/index.ts
+++ /dev/null
@@ -1,11 +0,0 @@
-export {
-  createRpgEntrySaveRoutes,
-  RPG_ENTRY_SAVE_ARCHIVE_ROUTE_BASE_PATH,
-  RPG_ENTRY_SAVE_ROUTE_BASE_PATH,
-} from './rpgEntrySaveRoutes.js';
-export {
-  createRpgWorldLibraryRoutes,
-  RPG_WORLD_GALLERY_ROUTE_BASE_PATH,
-  RPG_WORLD_LIBRARY_ROUTE_BASE_PATH,
-  RPG_WORLD_WORKS_ROUTE_BASE_PATH,
-} from './rpgWorldLibraryRoutes.js';
diff --git a/server-node/src/routes/rpg-profile/index.ts b/server-node/src/routes/rpg-profile/index.ts
deleted file mode 100644
index b1d2cc8f..00000000
--- a/server-node/src/routes/rpg-profile/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-export {
-  createRpgProfileRoutes,
-  RPG_PROFILE_ROUTE_BASE_PATH,
-} from './rpgProfileRoutes.js';
diff --git a/server-node/src/routes/rpg-runtime/index.ts b/server-node/src/routes/rpg-runtime/index.ts
deleted file mode 100644
index fe2a5b4f..00000000
--- a/server-node/src/routes/rpg-runtime/index.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-export {
-  createRpgRuntimeAiAssistRoutes,
-  RPG_RUNTIME_AI_ASSIST_ROUTE_BASE_PATH,
-} from './rpgRuntimeAiAssistRoutes.js';
-export {
-  createRpgRuntimeStoryRoutes,
-  RPG_RUNTIME_STORY_ROUTE_BASE_PATH,
-} from './rpgRuntimeStoryRoutes.js';
diff --git a/server-node/src/routes/rpgCreationAgentRoutes.ts b/server-node/src/routes/rpgCreationAgentRoutes.ts
deleted file mode 100644
index e8e923d3..00000000
--- a/server-node/src/routes/rpgCreationAgentRoutes.ts
+++ /dev/null
@@ -1 +0,0 @@
-export { createCustomWorldAgentRoutes as createRpgCreationAgentRoutes } from './customWorldAgent.js';
diff --git a/server-node/src/routes/rpgWorldGalleryRoutes.ts b/server-node/src/routes/rpgWorldGalleryRoutes.ts
deleted file mode 100644
index 81d135cd..00000000
--- a/server-node/src/routes/rpgWorldGalleryRoutes.ts
+++ /dev/null
@@ -1,14 +0,0 @@
-import { Router } from 'express';
-
-import type { AppContext } from '../context.js';
-
-/**
- * 工作包 A 先建立 RPG 世界广场路由的命名骨架。
- * 当前广场查询仍由旧 runtime 路由承载，后续工作包会再迁移实现。
- */
-export const RPG_WORLD_GALLERY_ROUTE_BASE_PATH =
-  '/runtime/custom-world-gallery';
-
-export function createRpgWorldGalleryRoutes(_context: AppContext) {
-  return Router();
-}
diff --git a/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts b/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts
deleted file mode 100644
index eabe111e..00000000
--- a/server-node/src/scripts/syncCustomWorldSavedProfileAssets.ts
+++ /dev/null
@@ -1,233 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-
-import sharp from 'sharp';
-
-import { createDatabase } from '../db.js';
-import { loadConfig } from '../config.js';
-import { RpgAgentSessionRepository } from '../repositories/RpgAgentSessionRepository.js';
-import { RpgWorldProfileRepository } from '../repositories/RpgWorldProfileRepository.js';
-import { CustomWorldAgentSessionStore } from '../services/customWorldAgentSessionStore.js';
-
-type RecordValue = Record<string, unknown>;
-
-function toText(value: unknown) {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-function isRecord(value: unknown): value is RecordValue {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-function toRecordArray(value: unknown) {
-  return Array.isArray(value)
-    ? value.filter((entry): entry is RecordValue => isRecord(entry))
-    : [];
-}
-
-function resolvePublicAssetPath(publicDir: string, imageSrc: unknown) {
-  const normalizedImageSrc = toText(imageSrc);
-  if (!normalizedImageSrc) {
-    return null;
-  }
-
-  return path.join(publicDir, normalizedImageSrc.replace(/^\/+/u, ''));
-}
-
-async function ensureSquareRoleImage(publicDir: string, imageSrc: unknown) {
-  const assetPath = resolvePublicAssetPath(publicDir, imageSrc);
-  if (!assetPath || !fs.existsSync(assetPath)) {
-    return null;
-  }
-
-  const metadata = await sharp(assetPath).metadata();
-  if (
-    typeof metadata.width === 'number' &&
-    typeof metadata.height === 'number' &&
-    metadata.width === metadata.height
-  ) {
-    return {
-      imageSrc: toText(imageSrc),
-      updated: false,
-      width: metadata.width,
-      height: metadata.height,
-    };
-  }
-
-  const squaredBuffer = await sharp(assetPath)
-    .resize(1024, 1024, {
-      fit: 'cover',
-      position: 'attention',
-    })
-    .png()
-    .toBuffer();
-  fs.writeFileSync(assetPath, squaredBuffer);
-
-  return {
-    imageSrc: toText(imageSrc),
-    updated: true,
-    width: 1024,
-    height: 1024,
-  };
-}
-
-async function main() {
-  const userId = 'user_02b1dea4e951b13fe53db236560bdf28';
-  const sessionId = 'custom-world-agent-session-019e192a4060d18b92df127f1dafe8ae';
-  const profileId = 'custom-world-mo744tca-深海奇境';
-  const config = loadConfig({
-    projectRoot: path.resolve(process.cwd(), '..'),
-  });
-  const db = await createDatabase(config);
-
-  try {
-    const rpgAgentSessionRepository = new RpgAgentSessionRepository(db);
-    const rpgWorldProfileRepository = new RpgWorldProfileRepository(db);
-    const sessionStore = new CustomWorldAgentSessionStore(
-      rpgAgentSessionRepository,
-    );
-    const session = await sessionStore.getSnapshot(userId, sessionId);
-    if (!session || !isRecord(session.draftProfile)) {
-      throw new Error('未找到目标世界草稿 session，无法同步历史保存档案。');
-    }
-
-    const savedProfileEntry = (
-      await rpgWorldProfileRepository.listOwnProfiles(userId)
-    ).find((entry) => entry.profileId === profileId);
-    if (!savedProfileEntry) {
-      throw new Error('未找到目标 saved profile，无法同步历史保存档案。');
-    }
-
-    const draftProfile = session.draftProfile;
-    const nextProfile = JSON.parse(
-      JSON.stringify(savedProfileEntry.profile),
-    ) as RecordValue;
-
-    const draftPlayableById = new Map(
-      toRecordArray(draftProfile.playableNpcs).map((entry) => [toText(entry.id), entry] as const),
-    );
-    const draftStoryById = new Map(
-      toRecordArray(draftProfile.storyNpcs).map((entry) => [toText(entry.id), entry] as const),
-    );
-    const draftLandmarkById = new Map(
-      toRecordArray(draftProfile.landmarks).map((entry) => [toText(entry.id), entry] as const),
-    );
-    const draftSceneChapterBySceneId = new Map(
-      toRecordArray(draftProfile.sceneChapters).map((entry) => [toText(entry.sceneId), entry] as const),
-    );
-
-    const playableNpcs = toRecordArray(nextProfile.playableNpcs).map((role) => {
-      const draftRole = draftPlayableById.get(toText(role.id));
-      if (!draftRole) {
-        return role;
-      }
-
-      return {
-        ...role,
-        imageSrc: toText(draftRole.imageSrc) || role.imageSrc,
-        generatedVisualAssetId:
-          toText(draftRole.generatedVisualAssetId) || role.generatedVisualAssetId,
-      };
-    });
-
-    const storyNpcs = toRecordArray(nextProfile.storyNpcs).map((role) => {
-      const draftRole = draftStoryById.get(toText(role.id));
-      if (!draftRole) {
-        return role;
-      }
-
-      return {
-        ...role,
-        imageSrc: toText(draftRole.imageSrc) || role.imageSrc,
-        generatedVisualAssetId:
-          toText(draftRole.generatedVisualAssetId) || role.generatedVisualAssetId,
-      };
-    });
-
-    const landmarks = toRecordArray(nextProfile.landmarks).map((landmark) => {
-      const draftLandmark = draftLandmarkById.get(toText(landmark.id));
-      const draftSceneChapter = draftSceneChapterBySceneId.get(toText(landmark.id));
-      const firstActImageSrc =
-        toRecordArray(draftSceneChapter?.acts)
-          .map((act) => toText(act.backgroundImageSrc))
-          .find(Boolean) || '';
-
-      return {
-        ...landmark,
-        imageSrc:
-          toText(draftLandmark?.imageSrc) ||
-          firstActImageSrc ||
-          toText(landmark.imageSrc) ||
-          undefined,
-      };
-    });
-
-    const sceneChapterBlueprints = toRecordArray(
-      nextProfile.sceneChapterBlueprints,
-    ).map((chapter) => {
-      const draftChapter = draftSceneChapterBySceneId.get(toText(chapter.sceneId));
-      if (!draftChapter) {
-        return chapter;
-      }
-
-      const draftActById = new Map(
-        toRecordArray(draftChapter.acts).map((act) => [toText(act.id), act] as const),
-      );
-
-      return {
-        ...chapter,
-        acts: toRecordArray(chapter.acts).map((act) => {
-          const draftAct = draftActById.get(toText(act.id));
-          if (!draftAct) {
-            return act;
-          }
-
-          return {
-            ...act,
-            backgroundImageSrc:
-              toText(draftAct.backgroundImageSrc) || act.backgroundImageSrc,
-            backgroundAssetId:
-              toText(draftAct.backgroundAssetId) || act.backgroundAssetId,
-          };
-        }),
-      };
-    });
-
-    const roleImageUpdates = await Promise.all(
-      [...playableNpcs, ...storyNpcs].map((role) =>
-        ensureSquareRoleImage(config.publicDir, role.imageSrc),
-      ),
-    );
-
-    nextProfile.playableNpcs = playableNpcs;
-    nextProfile.storyNpcs = storyNpcs;
-    nextProfile.landmarks = landmarks;
-    nextProfile.sceneChapterBlueprints = sceneChapterBlueprints;
-
-    const updatedEntry = await rpgWorldProfileRepository.upsertOwnProfile(
-      userId,
-      profileId,
-      nextProfile,
-      savedProfileEntry.authorDisplayName || '玩家',
-    );
-
-    const summary = {
-      profileId,
-      syncedPlayableCount: playableNpcs.length,
-      syncedStoryCount: storyNpcs.length,
-      syncedLandmarkCount: landmarks.length,
-      syncedSceneChapterCount: sceneChapterBlueprints.length,
-      squareRoleImagesUpdated: roleImageUpdates.filter((entry) => entry?.updated).length,
-      coverImageSrc: updatedEntry.entry.coverImageSrc,
-    };
-
-    console.log(JSON.stringify(summary, null, 2));
-  } finally {
-    await db.close();
-  }
-}
-
-void main().catch((error) => {
-  console.error(error);
-  process.exit(1);
-});
diff --git a/server-node/src/services/RpgAgentOrchestrator.ts b/server-node/src/services/RpgAgentOrchestrator.ts
deleted file mode 100644
index 60a68c71..00000000
--- a/server-node/src/services/RpgAgentOrchestrator.ts
+++ /dev/null
@@ -1 +0,0 @@
-export { CustomWorldAgentOrchestrator as RpgAgentOrchestrator } from './customWorldAgentOrchestrator.js';
diff --git a/server-node/src/services/RpgAgentSessionStore.ts b/server-node/src/services/RpgAgentSessionStore.ts
deleted file mode 100644
index 2075826c..00000000
--- a/server-node/src/services/RpgAgentSessionStore.ts
+++ /dev/null
@@ -1,5 +0,0 @@
-export type { CustomWorldAgentSessionRecord as RpgAgentSessionRecord } from './customWorldAgentSessionStore.js';
-export {
-  CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX as RPG_AGENT_SESSION_ID_PREFIX,
-  CustomWorldAgentSessionStore as RpgAgentSessionStore,
-} from './customWorldAgentSessionStore.js';
diff --git a/server-node/src/services/customWorldAgentPhase2.test.ts b/server-node/src/services/customWorldAgentPhase2.test.ts
index 46532ed1..f3087757 100644
--- a/server-node/src/services/customWorldAgentPhase2.test.ts
+++ b/server-node/src/services/customWorldAgentPhase2.test.ts
@@ -13,7 +13,7 @@ import { CustomWorldAgentOrchestrator } from './customWorldAgentOrchestrator.js'
 import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
 import { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
 import { createTestCustomWorldAgentSingleTurnLlmClient } from './customWorldAgentTestHelpers.js';
-import { listCustomWorldWorkSummaries } from './customWorldWorkSummaryService.js';
+import { RpgWorldWorkSummaryService } from './RpgWorldWorkSummaryService.js';
 
 async function waitForOperation(
   orchestrator: CustomWorldAgentOrchestrator,
@@ -217,10 +217,10 @@ test('phase2 work summaries compile draft title and summary from creator intent'
     update.operation.operationId,
   );
 
-  const items = await listCustomWorldWorkSummaries(userId, {
-    rpgWorldProfiles: rpgWorldProfileRepository,
-    customWorldAgentSessions: sessionStore,
-  });
+  const items = await new RpgWorldWorkSummaryService(
+    rpgWorldProfileRepository,
+    sessionStore,
+  ).list(userId);
   const draft = items.find(
     (item) => item.sessionId === createdSession.sessionId,
   );
diff --git a/server-node/src/services/customWorldAgentPhase3.test.ts b/server-node/src/services/customWorldAgentPhase3.test.ts
index 72384507..e572f998 100644
--- a/server-node/src/services/customWorldAgentPhase3.test.ts
+++ b/server-node/src/services/customWorldAgentPhase3.test.ts
@@ -11,7 +11,7 @@ import { CustomWorldAgentOrchestrator } from './customWorldAgentOrchestrator.js'
 import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
 import { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
 import { createTestCustomWorldAgentSingleTurnLlmClient } from './customWorldAgentTestHelpers.js';
-import { listCustomWorldWorkSummaries } from './customWorldWorkSummaryService.js';
+import { RpgWorldWorkSummaryService } from './RpgWorldWorkSummaryService.js';
 
 function createAutoAssetTestConfig(testName: string): AppConfig {
   const projectRoot = fs.mkdtempSync(
@@ -368,10 +368,10 @@ test('phase3 work summaries prefer compiled foundation draft fields', async () =
     response.operation.operationId,
   );
 
-  const items = await listCustomWorldWorkSummaries(userId, {
-    rpgWorldProfiles: rpgWorldProfileRepository,
-    customWorldAgentSessions: sessionStore,
-  });
+  const items = await new RpgWorldWorkSummaryService(
+    rpgWorldProfileRepository,
+    sessionStore,
+  ).list(userId);
   const draft = items.find((item) => item.sessionId === readySession.sessionId);
   const compiledProfile = normalizeFoundationDraftProfile(
     (
diff --git a/server-node/src/services/customWorldAgentPhase4.test.ts b/server-node/src/services/customWorldAgentPhase4.test.ts
index a03c5c48..b2b1453c 100644
--- a/server-node/src/services/customWorldAgentPhase4.test.ts
+++ b/server-node/src/services/customWorldAgentPhase4.test.ts
@@ -6,7 +6,7 @@ import { CustomWorldAgentOrchestrator } from './customWorldAgentOrchestrator.js'
 import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
 import { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
 import { createTestCustomWorldAgentSingleTurnLlmClient } from './customWorldAgentTestHelpers.js';
-import { listCustomWorldWorkSummaries } from './customWorldWorkSummaryService.js';
+import { RpgWorldWorkSummaryService } from './RpgWorldWorkSummaryService.js';
 
 async function waitForOperation(
   orchestrator: CustomWorldAgentOrchestrator,
@@ -552,10 +552,10 @@ test('phase4 generate_characters appends story npcs and updates work summary cou
       [...profile.playableNpcs, ...profile.storyNpcs].map((entry) => entry.id),
     ),
   ].length;
-  const workItems = await listCustomWorldWorkSummaries(userId, {
-    rpgWorldProfiles: rpgWorldProfileRepository,
-    customWorldAgentSessions: sessionStore,
-  });
+  const workItems = await new RpgWorldWorkSummaryService(
+    rpgWorldProfileRepository,
+    sessionStore,
+  ).list(userId);
   const draftItem = workItems.find((item) => item.sessionId === session.sessionId);
 
   assert.equal(operation?.status, 'completed');
@@ -641,10 +641,10 @@ test('phase4 work summaries exclude library draft entries after phase3 downgrade
     '玩家',
   );
 
-  const workItems = await listCustomWorldWorkSummaries(userId, {
-    rpgWorldProfiles: rpgWorldProfileRepository,
-    customWorldAgentSessions: sessionStore,
-  });
+  const workItems = await new RpgWorldWorkSummaryService(
+    rpgWorldProfileRepository,
+    sessionStore,
+  ).list(userId);
 
   assert.ok(workItems.some((item) => item.sessionId === session.sessionId));
   assert.equal(
@@ -688,10 +688,10 @@ test('phase4 work summaries hide published agent sessions from draft lane and ke
     '玩家',
   );
 
-  const workItems = await listCustomWorldWorkSummaries(userId, {
-    rpgWorldProfiles: rpgWorldProfileRepository,
-    customWorldAgentSessions: sessionStore,
-  });
+  const workItems = await new RpgWorldWorkSummaryService(
+    rpgWorldProfileRepository,
+    sessionStore,
+  ).list(userId);
   const draftItem = workItems.find((item) => item.sessionId === session.sessionId);
   const publishedItem = workItems.find(
     (item) => item.profileId === `agent-draft-${session.sessionId}`,
diff --git a/server-node/src/services/customWorldAgentPublishGateService.ts b/server-node/src/services/customWorldAgentPublishGateService.ts
deleted file mode 100644
index 64c9d1e0..00000000
--- a/server-node/src/services/customWorldAgentPublishGateService.ts
+++ /dev/null
@@ -1,141 +0,0 @@
-import type {
-  CustomWorldAgentSessionSnapshot,
-} from '../../../packages/shared/src/contracts/customWorldAgent.js';
-import { normalizeFoundationDraftProfile } from './customWorldAgentDraftCompiler.js';
-
-export type CustomWorldAgentPublishGateResult = {
-  blockers: CustomWorldAgentSessionSnapshot['qualityFindings'];
-  warnings: CustomWorldAgentSessionSnapshot['qualityFindings'];
-};
-
-function buildFinding(params: {
-  id: string;
-  code: string;
-  severity: 'warning' | 'blocker';
-  targetId?: string | null;
-  message: string;
-}) {
-  return {
-    id: params.id,
-    code: params.code,
-    severity: params.severity,
-    targetId: params.targetId ?? null,
-    message: params.message,
-  } satisfies CustomWorldAgentSessionSnapshot['qualityFindings'][number];
-}
-
-export class CustomWorldAgentPublishGateService {
-  evaluate(params: {
-    draftProfile: unknown;
-    qualityFindings: CustomWorldAgentSessionSnapshot['qualityFindings'];
-  }): CustomWorldAgentPublishGateResult {
-    const draftProfile = normalizeFoundationDraftProfile(params.draftProfile);
-    const blockers = params.qualityFindings.filter(
-      (entry) => entry.severity === 'blocker',
-    );
-    const warnings = params.qualityFindings.filter(
-      (entry) => entry.severity === 'warning',
-    );
-
-    if (!draftProfile) {
-      return {
-        blockers: [
-          ...blockers,
-          buildFinding({
-            id: 'publish-empty-draft',
-            code: 'publish_empty_draft',
-            severity: 'blocker',
-            message: '当前还没有可发布的世界底稿，请先整理世界骨架。',
-          }),
-        ],
-        warnings,
-      };
-    }
-
-    if ((draftProfile.chapters?.length ?? 0) <= 0) {
-      blockers.push(
-        buildFinding({
-          id: 'publish-missing-main-chapter',
-          code: 'publish_missing_main_chapter',
-          severity: 'blocker',
-          message: '发布前至少需要保留主线第一幕，当前世界还缺少章节草稿。',
-        }),
-      );
-    }
-
-    const missingRoleVisuals = [
-      ...draftProfile.playableNpcs,
-      ...draftProfile.storyNpcs,
-    ].filter(
-      (entry) =>
-        !entry.generatedVisualAssetId?.trim() ||
-        !entry.generatedAnimationSetId?.trim(),
-    );
-    if (missingRoleVisuals.length > 0) {
-      blockers.push(
-        buildFinding({
-          id: 'publish-role-assets-incomplete',
-          code: 'publish_role_assets_incomplete',
-          severity: 'blocker',
-          targetId: missingRoleVisuals[0]?.id ?? null,
-          message: '仍有角色缺少正式主图或动作资产，发布前需要先补齐。',
-        }),
-      );
-    }
-
-    if (
-      !draftProfile.camp?.imageSrc?.trim() ||
-      !(draftProfile.camp as Record<string, unknown> | null)?.generatedSceneAssetId
-    ) {
-      blockers.push(
-        buildFinding({
-          id: 'publish-camp-scene-missing',
-          code: 'publish_camp_scene_missing',
-          severity: 'blocker',
-          targetId: draftProfile.camp?.id ?? null,
-          message: '营地还缺少正式场景图资产，发布前需要先确认营地图。',
-        }),
-      );
-    }
-
-    const missingLandmarkScenes = draftProfile.landmarks.filter((entry) => {
-      const record = entry as Record<string, unknown>;
-      return (
-        !entry.imageSrc?.trim() || !String(record.generatedSceneAssetId ?? '').trim()
-      );
-    });
-    if (missingLandmarkScenes.length > 0) {
-      blockers.push(
-        buildFinding({
-          id: 'publish-landmark-scenes-missing',
-          code: 'publish_landmark_scenes_missing',
-          severity: 'blocker',
-          targetId: missingLandmarkScenes[0]?.id ?? null,
-          message: '仍有地点缺少正式场景图资产，发布前需要先补齐地点图。',
-        }),
-      );
-    }
-
-    const invalidSceneChapters = draftProfile.sceneChapters.filter(
-      (entry) =>
-        entry.linkedThreadIds.length <= 0 ||
-        entry.acts.every((act) => act.encounterNpcIds.length <= 0),
-    );
-    if (invalidSceneChapters.length > 0) {
-      blockers.push(
-        buildFinding({
-          id: 'publish-scene-chapter-unbound',
-          code: 'publish_scene_chapter_unbound',
-          severity: 'blocker',
-          targetId: invalidSceneChapters[0]?.id ?? null,
-          message: '场景章节还没有绑定足够的线程或角色，发布前请先补齐主线挂钩。',
-        }),
-      );
-    }
-
-    return {
-      blockers,
-      warnings,
-    };
-  }
-}
diff --git a/server-node/src/services/customWorldAgentPublishService.ts b/server-node/src/services/customWorldAgentPublishService.ts
deleted file mode 100644
index f3fa02ae..00000000
--- a/server-node/src/services/customWorldAgentPublishService.ts
+++ /dev/null
@@ -1,410 +0,0 @@
-import type {
-  CustomWorldAgentSessionRecord,
-} from './customWorldAgentSessionStore.js';
-import {
-  buildCompiledCustomWorldProfile,
-} from '../modules/custom-world/runtimeProfile.js';
-import type { CustomWorldProfile } from '../modules/custom-world/runtimeTypes.js';
-import type { RpgWorldProfileRepositoryPort } from '../repositories/RpgWorldProfileRepository.js';
-import type { CustomWorldProfileRecord } from '../../../packages/shared/src/contracts/runtime.js';
-
-function toText(value: unknown, fallback = '') {
-  return typeof value === 'string' ? value.trim() : fallback;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-function toRecordArray(value: unknown) {
-  return Array.isArray(value)
-    ? value.filter(
-        (item): item is Record<string, unknown> =>
-          Boolean(item) && typeof item === 'object' && !Array.isArray(item),
-      )
-    : [];
-}
-
-function toStringArray(value: unknown, max = 8) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-
-  return [...new Set(value.map((item) => toText(item)).filter(Boolean))].slice(
-    0,
-    max,
-  );
-}
-
-function buildSettingTextFromSession(session: CustomWorldAgentSessionRecord) {
-  const anchorContent = session.anchorContent;
-
-  const anchorLines = [
-    anchorContent.worldPromise
-      ? `世界承诺：${[
-          anchorContent.worldPromise.hook,
-          anchorContent.worldPromise.differentiator,
-          anchorContent.worldPromise.desiredExperience,
-        ]
-          .filter(Boolean)
-          .join('；')}`
-      : '',
-    anchorContent.playerFantasy
-      ? `玩家幻想：${[
-          anchorContent.playerFantasy.playerRole,
-          anchorContent.playerFantasy.corePursuit,
-          anchorContent.playerFantasy.fearOfLoss,
-        ]
-          .filter(Boolean)
-          .join('；')}`
-      : '',
-    anchorContent.coreConflict
-      ? `核心冲突：${[
-          anchorContent.coreConflict.surfaceConflicts.join('、'),
-          anchorContent.coreConflict.hiddenCrisis,
-          anchorContent.coreConflict.firstTouchedConflict,
-        ]
-          .filter(Boolean)
-          .join('；')}`
-      : '',
-    anchorContent.iconicElements
-      ? `标志元素：${[
-          anchorContent.iconicElements.iconicMotifs.join('、'),
-          anchorContent.iconicElements.institutionsOrArtifacts.join('、'),
-          anchorContent.iconicElements.hardRules.join('、'),
-        ]
-          .filter(Boolean)
-          .join('；')}`
-      : '',
-  ].filter(Boolean);
-
-  if (anchorLines.length > 0) {
-    return anchorLines.join('\n');
-  }
-
-  return session.seedText.trim() || '当前世界草稿已经进入发布阶段。';
-}
-
-function buildRuntimeRoleFromDraft(
-  draftRole: Record<string, unknown>,
-  roleKind: 'playable' | 'story',
-  index: number,
-) {
-  const name = toText(draftRole.name) || `角色 ${index + 1}`;
-  const title =
-    toText(draftRole.title) ||
-    toText(draftRole.role) ||
-    (roleKind === 'playable' ? '关键角色' : '场景角色');
-  const role = toText(draftRole.role) || title;
-
-  return {
-    id: toText(draftRole.id) || `${roleKind}-draft-${index + 1}`,
-    name,
-    title,
-    role,
-    description:
-      toText(draftRole.summary) ||
-      toText(draftRole.publicIdentity) ||
-      toText(draftRole.publicMask) ||
-      toText(draftRole.currentPressure),
-    backstory: [
-      toText(draftRole.publicIdentity),
-      toText(draftRole.currentPressure),
-      toText(draftRole.hiddenHook)
-        ? `暗线：${toText(draftRole.hiddenHook)}`
-        : '',
-    ]
-      .filter(Boolean)
-      .join('；'),
-    personality:
-      toText(draftRole.publicMask) ||
-      toText(draftRole.publicIdentity) ||
-      toText(draftRole.summary),
-    motivation:
-      toText(draftRole.relationToPlayer) ||
-      toText(draftRole.currentPressure) ||
-      toText(draftRole.hiddenHook),
-    combatStyle: role,
-    initialAffinity: roleKind === 'playable' ? 18 : 6,
-    relationshipHooks: [
-      toText(draftRole.relationToPlayer),
-      toText(draftRole.currentPressure),
-      toText(draftRole.hiddenHook),
-    ].filter(Boolean),
-    tags: [
-      ...toStringArray(draftRole.threadIds, 4),
-      roleKind === 'playable' ? '草稿主角' : '草稿角色',
-    ],
-    imageSrc: toText(draftRole.imageSrc) || undefined,
-    generatedVisualAssetId:
-      toText(draftRole.generatedVisualAssetId) || undefined,
-    generatedAnimationSetId:
-      toText(draftRole.generatedAnimationSetId) || undefined,
-    animationMap: isRecord(draftRole.animationMap)
-      ? draftRole.animationMap
-      : undefined,
-  } satisfies Record<string, unknown>;
-}
-
-function buildRuntimeLandmarkFromDraft(
-  draftLandmark: Record<string, unknown>,
-  storyNpcIdSet: Set<string>,
-  index: number,
-) {
-  return {
-    id: toText(draftLandmark.id) || `landmark-draft-${index + 1}`,
-    name: toText(draftLandmark.name) || `关键地点 ${index + 1}`,
-    description:
-      toText(draftLandmark.description) ||
-      toText(draftLandmark.summary) ||
-      [toText(draftLandmark.purpose), toText(draftLandmark.mood)]
-        .filter(Boolean)
-        .join('；'),
-    dangerLevel:
-      toText(draftLandmark.dangerLevel) ||
-      toText(draftLandmark.importance) ||
-      toText(draftLandmark.mood) ||
-      'medium',
-    imageSrc: toText(draftLandmark.imageSrc) || undefined,
-    generatedSceneAssetId:
-      toText(draftLandmark.generatedSceneAssetId) || undefined,
-    generatedScenePrompt:
-      toText(draftLandmark.generatedScenePrompt) || undefined,
-    generatedSceneModel:
-      toText(draftLandmark.generatedSceneModel) || undefined,
-    sceneNpcIds: toStringArray(draftLandmark.characterIds).filter((entry) =>
-      storyNpcIdSet.has(entry),
-    ),
-    connections: [],
-  } satisfies Record<string, unknown>;
-}
-
-function buildRuntimeCampFromDraft(draftCamp: Record<string, unknown> | null) {
-  if (!draftCamp) {
-    return null;
-  }
-
-  const name = toText(draftCamp.name);
-  const description = toText(draftCamp.description);
-  if (!name && !description) {
-    return null;
-  }
-
-  return {
-    id: toText(draftCamp.id) || 'camp-home',
-    name: name || '开局营地',
-    description: description || '当前世界的开局落脚点。',
-    dangerLevel:
-      toText(draftCamp.dangerLevel) || toText(draftCamp.mood) || 'low',
-    imageSrc: toText(draftCamp.imageSrc) || undefined,
-    generatedSceneAssetId:
-      toText(draftCamp.generatedSceneAssetId) || undefined,
-    generatedScenePrompt:
-      toText(draftCamp.generatedScenePrompt) || undefined,
-    generatedSceneModel:
-      toText(draftCamp.generatedSceneModel) || undefined,
-    sceneNpcIds: [],
-    connections: [],
-  } satisfies Record<string, unknown>;
-}
-
-function buildRuntimeSceneChaptersFromDraft(
-  draftProfile: Record<string, unknown>,
-  storyNpcIdSet: Set<string>,
-  landmarkIdSet: Set<string>,
-) {
-  return toRecordArray(draftProfile.sceneChapters)
-    .map((sceneChapter, chapterIndex) => {
-      const sceneId = toText(sceneChapter.sceneId);
-      if (!sceneId) {
-        return null;
-      }
-
-      const acts = toRecordArray(sceneChapter.acts)
-        .map((act, actIndex) => {
-          const encounterNpcIds = toStringArray(act.encounterNpcIds).filter(
-            (entry) => storyNpcIdSet.has(entry),
-          );
-          const primaryNpcId =
-            toText(act.primaryNpcId) || encounterNpcIds[0] || '';
-
-          return {
-            id: toText(act.id) || `scene-act-${sceneId}-${actIndex + 1}`,
-            sceneId,
-            title: toText(act.title) || `第 ${actIndex + 1} 幕`,
-            summary:
-              toText(act.summary) ||
-              toText(act.actGoal) ||
-              `围绕${toText(sceneChapter.sceneName, sceneId)}继续推进`,
-            stageCoverage:
-              toStringArray(act.stageCoverage).length > 0
-                ? toStringArray(act.stageCoverage)
-                : actIndex === 0
-                  ? ['opening']
-                  : ['climax', 'aftermath'],
-            backgroundImageSrc:
-              toText(act.backgroundImageSrc) || undefined,
-            backgroundAssetId: toText(act.backgroundAssetId) || undefined,
-            encounterNpcIds,
-            primaryNpcId,
-            linkedThreadIds: toStringArray(act.linkedThreadIds, 8),
-            advanceRule:
-              toText(act.advanceRule) || 'after_active_step_complete',
-            actGoal: toText(act.actGoal),
-            transitionHook: toText(act.transitionHook),
-          } satisfies Record<string, unknown>;
-        })
-        .filter(
-          (entry) =>
-            entry.encounterNpcIds.length > 0 || entry.backgroundImageSrc,
-        );
-
-      return {
-        id:
-          toText(sceneChapter.id) ||
-          `scene-chapter-${sceneId}-${chapterIndex + 1}`,
-        sceneId,
-        title:
-          toText(sceneChapter.title) ||
-          toText(sceneChapter.sceneName) ||
-          sceneId,
-        summary:
-          toText(sceneChapter.summary) ||
-          toText(sceneChapter.title) ||
-          toText(sceneChapter.sceneName) ||
-          sceneId,
-        linkedThreadIds: toStringArray(sceneChapter.linkedThreadIds, 8),
-        linkedLandmarkIds: toStringArray(
-          sceneChapter.linkedLandmarkIds,
-          8,
-        ).filter((entry) => landmarkIdSet.has(entry)),
-        acts,
-      } satisfies Record<string, unknown>;
-    })
-    .filter(Boolean);
-}
-
-function buildPublishRawProfile(
-  session: CustomWorldAgentSessionRecord,
-  profileId: string,
-) {
-  const draftProfile = isRecord(session.draftProfile) ? session.draftProfile : {};
-  const legacyResultProfile = isRecord(draftProfile.legacyResultProfile)
-    ? draftProfile.legacyResultProfile
-    : null;
-  const playableNpcs = toRecordArray(draftProfile.playableNpcs).map(
-    (entry, index) => buildRuntimeRoleFromDraft(entry, 'playable', index),
-  );
-  const storyNpcs = toRecordArray(draftProfile.storyNpcs).map((entry, index) =>
-    buildRuntimeRoleFromDraft(entry, 'story', index),
-  );
-  const storyNpcIdSet = new Set(
-    storyNpcs.map((entry) => toText(entry.id)).filter(Boolean),
-  );
-  const landmarks = toRecordArray(draftProfile.landmarks).map((entry, index) =>
-    buildRuntimeLandmarkFromDraft(entry, storyNpcIdSet, index),
-  );
-  const landmarkIdSet = new Set(
-    landmarks.map((entry) => toText(entry.id)).filter(Boolean),
-  );
-
-  return {
-    ...(legacyResultProfile ?? {}),
-    id: profileId,
-    settingText: buildSettingTextFromSession(session),
-    name:
-      toText(draftProfile.name) ||
-      toText(legacyResultProfile?.name) ||
-      '未命名世界底稿',
-    subtitle:
-      toText(draftProfile.subtitle) ||
-      toText(legacyResultProfile?.subtitle) ||
-      '已发布世界',
-    summary:
-      toText(draftProfile.summary) ||
-      toText(legacyResultProfile?.summary) ||
-      '当前世界已经进入发布态。',
-    tone:
-      toText(draftProfile.tone) ||
-      toText(legacyResultProfile?.tone) ||
-      '整体气质仍带着明显张力',
-    playerGoal:
-      toText(draftProfile.playerGoal) ||
-      toText(legacyResultProfile?.playerGoal) ||
-      '先站稳局势，再判断下一步',
-    majorFactions:
-      toStringArray(draftProfile.majorFactions, 6).length > 0
-        ? toStringArray(draftProfile.majorFactions, 6)
-        : Array.isArray(legacyResultProfile?.majorFactions)
-          ? legacyResultProfile.majorFactions
-          : [],
-    coreConflicts:
-      toStringArray(draftProfile.coreConflicts, 6).length > 0
-        ? toStringArray(draftProfile.coreConflicts, 6)
-        : Array.isArray(legacyResultProfile?.coreConflicts)
-          ? legacyResultProfile.coreConflicts
-          : [toText(draftProfile.summary) || '核心冲突仍待继续补强'],
-    playableNpcs,
-    storyNpcs,
-    landmarks,
-    camp: buildRuntimeCampFromDraft(
-      isRecord(draftProfile.camp) ? draftProfile.camp : null,
-    ),
-    sceneChapterBlueprints: buildRuntimeSceneChaptersFromDraft(
-      draftProfile,
-      storyNpcIdSet,
-      landmarkIdSet,
-    ),
-    anchorContent: session.anchorContent,
-    creatorIntent: session.creatorIntent,
-    anchorPack: session.anchorPack,
-    lockState: session.lockState,
-    generationMode: 'full',
-    generationStatus: 'complete',
-  } satisfies Record<string, unknown>;
-}
-
-export class CustomWorldAgentPublishService {
-  buildProfileId(sessionId: string) {
-    return `agent-draft-${sessionId}`;
-  }
-
-  compilePublishedProfile(
-    session: CustomWorldAgentSessionRecord,
-  ): CustomWorldProfile {
-    const profileId = this.buildProfileId(session.sessionId);
-    const rawProfile = buildPublishRawProfile(session, profileId);
-
-    return buildCompiledCustomWorldProfile(
-      rawProfile,
-      buildSettingTextFromSession(session),
-    );
-  }
-
-  async publish(params: {
-    session: CustomWorldAgentSessionRecord;
-    userId: string;
-    authorDisplayName: string;
-    profileRepository: RpgWorldProfileRepositoryPort;
-  }) {
-    const publishedProfile = this.compilePublishedProfile(params.session);
-    const profileId = this.buildProfileId(params.session.sessionId);
-    const mutation = await params.profileRepository.upsertOwnProfile(
-      params.userId,
-      profileId,
-      publishedProfile as unknown as CustomWorldProfileRecord,
-      params.authorDisplayName || '玩家',
-    );
-    const publishedMutation = await params.profileRepository.publishOwnProfile(
-      params.userId,
-      profileId,
-      params.authorDisplayName || '玩家',
-    );
-
-    return {
-      profileId,
-      publishedProfile,
-      mutation: publishedMutation ?? mutation,
-    };
-  }
-}
diff --git a/server-node/src/services/customWorldWorkSummaryService.integration.test.ts b/server-node/src/services/customWorldWorkSummaryService.integration.test.ts
index 9dde95cb..129ba6e9 100644
--- a/server-node/src/services/customWorldWorkSummaryService.integration.test.ts
+++ b/server-node/src/services/customWorldWorkSummaryService.integration.test.ts
@@ -8,11 +8,11 @@ import {
 } from '../../../packages/shared/src/contracts/rpgCreationFixtures.js';
 import type { CustomWorldSessionRecord } from '../../../packages/shared/src/contracts/runtime.js';
 import { createInMemoryRpgWorldRepositoryPorts } from './customWorldAgentRepositoryTestHelpers.js';
-import { listCustomWorldWorkSummaries } from './customWorldWorkSummaryService.js';
 import {
   CUSTOM_WORLD_AGENT_SESSION_ID_PREFIX,
   CustomWorldAgentSessionStore,
 } from './customWorldAgentSessionStore.js';
+import { RpgWorldWorkSummaryService } from './RpgWorldWorkSummaryService.js';
 
 test('work summary service can aggregate shared RPG fixtures into draft and published entries', async () => {
   const sessionFixture = createRpgAgentSessionFixture();
@@ -34,10 +34,10 @@ test('work summary service can aggregate shared RPG fixtures into draft and publ
   const sessionStore = new CustomWorldAgentSessionStore(
     rpgAgentSessionRepository,
   );
-  const summaries = await listCustomWorldWorkSummaries('fixture-user', {
-    rpgWorldProfiles: rpgWorldProfileRepository,
-    customWorldAgentSessions: sessionStore,
-  });
+  const summaries = await new RpgWorldWorkSummaryService(
+    rpgWorldProfileRepository,
+    sessionStore,
+  ).list('fixture-user');
   const expected = createRpgCreationWorksResponseFixture();
 
   assert.equal(summaries.length, expected.items.length);
@@ -97,10 +97,10 @@ test('published agent sessions are filtered out after works unify to published p
     rpgAgentSessionRepository,
   );
 
-  const summaries = await listCustomWorldWorkSummaries('fixture-user', {
-    rpgWorldProfiles: rpgWorldProfileRepository,
-    customWorldAgentSessions: sessionStore,
-  });
+  const summaries = await new RpgWorldWorkSummaryService(
+    rpgWorldProfileRepository,
+    sessionStore,
+  ).list('fixture-user');
 
   assert.equal(
     summaries.some((entry) => entry.sourceType === 'agent_session'),
diff --git a/server-node/src/services/customWorldWorkSummaryService.ts b/server-node/src/services/customWorldWorkSummaryService.ts
deleted file mode 100644
index f66fef77..00000000
--- a/server-node/src/services/customWorldWorkSummaryService.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-import type { RpgWorldProfileRepositoryPort } from '../repositories/RpgWorldProfileRepository.js';
-import type { CustomWorldAgentSessionStore } from './customWorldAgentSessionStore.js';
-import { RpgWorldWorkSummaryService } from './RpgWorldWorkSummaryService.js';
-
-/**
- * 兼容服务入口保留旧文件名，内部则改走 RPG works 组装器，便于后续继续迁到新命名。
- */
-export async function listCustomWorldWorkSummaries(
-  userId: string,
-  dependencies: {
-    rpgWorldProfiles: RpgWorldProfileRepositoryPort;
-    customWorldAgentSessions: CustomWorldAgentSessionStore;
-  },
-) {
-  const service = new RpgWorldWorkSummaryService(
-    dependencies.rpgWorldProfiles,
-    dependencies.customWorldAgentSessions,
-  );
-  return service.list(userId);
-}
diff --git a/src/components/DeveloperTeamModal.tsx b/src/components/DeveloperTeamModal.tsx
deleted file mode 100644
index 388f68c6..00000000
--- a/src/components/DeveloperTeamModal.tsx
+++ /dev/null
@@ -1,65 +0,0 @@
-import { AnimatePresence, motion } from 'motion/react';
-
-import { CHROME_ICONS, getNineSliceStyle, UI_CHROME } from '../uiAssets';
-import { PixelIcon } from './PixelIcon';
-
-interface DeveloperTeamModalProps {
-  isOpen: boolean;
-  message: string;
-  onClose: () => void;
-}
-
-export function DeveloperTeamModal({
-  isOpen,
-  message,
-  onClose,
-}: DeveloperTeamModalProps) {
-  return (
-    <AnimatePresence>
-      {isOpen && (
-        <motion.div
-          initial={{ opacity: 0 }}
-          animate={{ opacity: 1 }}
-          exit={{ opacity: 0 }}
-          className="fixed inset-0 z-[74] flex items-center justify-center bg-black/78 p-3 sm:p-4 backdrop-blur-sm"
-          onClick={onClose}
-        >
-          <motion.div
-            initial={{ opacity: 0, scale: 0.96, y: 10 }}
-            animate={{ opacity: 1, scale: 1, y: 0 }}
-            exit={{ opacity: 0, scale: 0.96, y: 10 }}
-            transition={{ duration: 0.18, ease: 'easeOut' }}
-            className="pixel-nine-slice pixel-modal-shell flex max-h-[min(92vh,48rem)] w-full max-w-[min(96vw,42rem)] flex-col overflow-hidden shadow-[0_28px_90px_rgba(0,0,0,0.58)]"
-            style={getNineSliceStyle(UI_CHROME.modalPanel)}
-            onClick={event => event.stopPropagation()}
-          >
-            <div className="flex items-center justify-between gap-3 border-b border-white/10 px-4 py-3 sm:px-5 sm:py-4">
-              <div className="min-w-0">
-                <div className="mt-1 text-sm font-semibold text-white">{'\u5f00\u53d1\u56e2\u961f'}</div>
-              </div>
-              <button
-                type="button"
-                onClick={onClose}
-                className="rounded-full border border-white/10 bg-black/20 p-2 text-zinc-400 transition-colors hover:text-white"
-                aria-label="关闭开发团队弹窗"
-              >
-                <PixelIcon src={CHROME_ICONS.close} className="h-4 w-4" />
-              </button>
-            </div>
-
-            <div className="min-h-0 flex-1 overflow-y-auto p-4 sm:p-5">
-              <div
-                className="pixel-nine-slice pixel-panel flex flex-col items-center gap-5"
-                style={getNineSliceStyle(UI_CHROME.panel, { paddingX: 16, paddingY: 16 })}
-              >
-                <div className="whitespace-pre-line text-center text-sm leading-7 text-zinc-100">
-                  {message}
-                </div>
-              </div>
-            </div>
-          </motion.div>
-        </motion.div>
-      )}
-    </AnimatePresence>
-  );
-}
diff --git a/src/components/LazySkillEffectPreview.tsx b/src/components/LazySkillEffectPreview.tsx
deleted file mode 100644
index c03ab1f3..00000000
--- a/src/components/LazySkillEffectPreview.tsx
+++ /dev/null
@@ -1,33 +0,0 @@
-import {lazy, Suspense} from 'react';
-
-import type {SkillEffectPreviewProps} from './SkillEffectPreview';
-
-const SkillEffectPreview = lazy(async () => {
-  const module = await import('./SkillEffectPreview');
-
-  return {
-    default: module.SkillEffectPreview,
-  };
-});
-
-function SkillEffectPreviewFallback() {
-  return (
-    <div className="rounded-2xl border border-white/10 bg-black/20 p-4">
-      <div className="mb-3 space-y-2">
-        <div className="h-4 w-28 rounded bg-white/10" />
-        <div className="h-3 w-40 rounded bg-white/5" />
-      </div>
-      <div className="overflow-hidden rounded-2xl border border-white/10 bg-black">
-        <div className="h-[300px] animate-pulse bg-[radial-gradient(circle_at_top,rgba(255,255,255,0.08),transparent_42%),linear-gradient(180deg,rgba(255,255,255,0.05),rgba(255,255,255,0.02))]" />
-      </div>
-    </div>
-  );
-}
-
-export function LazySkillEffectPreview(props: SkillEffectPreviewProps) {
-  return (
-    <Suspense fallback={<SkillEffectPreviewFallback />}>
-      <SkillEffectPreview {...props} />
-    </Suspense>
-  );
-}
diff --git a/src/components/npcVisualEditorModel.ts b/src/components/npcVisualEditorModel.ts
deleted file mode 100644
index b3fdf901..00000000
--- a/src/components/npcVisualEditorModel.ts
+++ /dev/null
@@ -1,176 +0,0 @@
-import {
-  buildBodyPath,
-  buildMedievalAtlasSpec,
-  buildRaceAssetPath,
-  clampMedievalAtlasFrame,
-  getMedievalAtlasOptions,
-  getMedievalPoseOptions,
-  MEDIEVAL_BODY_COLORS,
-  type MedievalAtlasSourceType,
-  type MedievalNpcVisualOverride,
-  type MedievalRace,
-} from '../data/medievalNpcVisuals';
-import type { Encounter } from '../types';
-import { type NpcLayoutConfig, type NpcLayoutPart } from './npcVisualShared';
-
-export type GearSourceType = 'none' | MedievalAtlasSourceType;
-
-export type EditableNpcVisualState = {
-  race: MedievalRace;
-  bodyColor: string;
-  headIndex: number;
-  hairColorIndex: number;
-  hairStyleFrame: number;
-  facialHairEnabled: boolean;
-  facialHairColorIndex: number;
-  facialHairStyleFrame: number;
-  headgearType: GearSourceType;
-  headgearFile: string;
-  headgearFrame: number;
-  mainHandType: GearSourceType;
-  mainHandFile: string;
-  mainHandFrame: number;
-  offHandType: GearSourceType;
-  offHandFile: string;
-  offHandFrame: number;
-};
-
-export type EditorNpcOption = {
-  encounter: Encounter;
-  sceneNames: string[];
-};
-
-const NPC_LAYOUT_PARTS: NpcLayoutPart[] = [
-  'body',
-  'head',
-  'facialHair',
-  'hair',
-  'headgear',
-  'hand',
-  'mainHand',
-  'offHand',
-];
-
-export function sanitizeFrameSelection(
-  type: GearSourceType,
-  file: string,
-  frame: number,
-  usage: 'headgear' | 'mainHand' | 'offHand',
-) {
-  if (type === 'none' || !file) return 0;
-  const poseOptions = getMedievalPoseOptions(type, file, usage);
-  if (poseOptions.length === 0) return 0;
-  if (poseOptions.some(option => option.value === frame)) {
-    return clampMedievalAtlasFrame(type, file, frame);
-  }
-  const firstOption = poseOptions[0];
-  return firstOption ? firstOption.value : 0;
-}
-
-export function getDefaultFileForType(type: GearSourceType) {
-  if (type === 'none') return '';
-  return getMedievalAtlasOptions(type)[0]?.file ?? '';
-}
-
-export function getDefaultFrameForSelection(
-  type: GearSourceType,
-  file: string,
-  usage: 'headgear' | 'mainHand' | 'offHand',
-) {
-  if (type === 'none' || !file) return 0;
-  return getMedievalPoseOptions(type, file, usage)[0]?.value ?? 0;
-}
-
-export function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-export function isNpcLayoutConfig(value: unknown): value is NpcLayoutConfig {
-  return (
-    isRecord(value)
-    && NPC_LAYOUT_PARTS.every(part => {
-      const coordinate = value[part];
-      return (
-        isRecord(coordinate)
-        && typeof coordinate.x === 'number'
-        && Number.isFinite(coordinate.x)
-        && typeof coordinate.y === 'number'
-        && Number.isFinite(coordinate.y)
-      );
-    })
-  );
-}
-
-export function buildOverrideFromEditorState(
-  state: EditableNpcVisualState,
-): MedievalNpcVisualOverride {
-  return {
-    race: state.race,
-    bodySrc: buildBodyPath(
-      state.bodyColor as (typeof MEDIEVAL_BODY_COLORS)[number],
-    ),
-    headSrc: buildRaceAssetPath(state.race, 'head', state.headIndex),
-    hairSrc: buildRaceAssetPath(state.race, 'hair', state.hairColorIndex),
-    handSrc: buildRaceAssetPath(state.race, 'hand', 1),
-    facialHairSrc: state.facialHairEnabled
-      ? buildRaceAssetPath(state.race, 'facialHair', state.facialHairColorIndex)
-      : undefined,
-    headgear:
-      state.headgearType === 'none'
-        ? undefined
-        : buildMedievalAtlasSpec(
-            state.headgearType,
-            state.headgearFile,
-            sanitizeFrameSelection(
-              state.headgearType,
-              state.headgearFile,
-              state.headgearFrame,
-              'headgear',
-            ),
-          ),
-    mainHand:
-      state.mainHandType === 'none'
-        ? undefined
-        : buildMedievalAtlasSpec(
-            state.mainHandType,
-            state.mainHandFile,
-            sanitizeFrameSelection(
-              state.mainHandType,
-              state.mainHandFile,
-              state.mainHandFrame,
-              'mainHand',
-            ),
-          ),
-    offHand:
-      state.offHandType === 'none'
-        ? undefined
-        : buildMedievalAtlasSpec(
-            state.offHandType,
-            state.offHandFile,
-            sanitizeFrameSelection(
-              state.offHandType,
-              state.offHandFile,
-              state.offHandFrame,
-              'offHand',
-            ),
-          ),
-    bodyFrames: [0, 1, 2, 3],
-    headFrame: 0,
-    hairFrame: state.hairStyleFrame,
-    handFrame: 0,
-    facialHairFrame: state.facialHairEnabled
-      ? state.facialHairStyleFrame
-      : undefined,
-  };
-}
-
-export function buildNpcVisualSavePayload(
-  overrideMap: Record<string, MedievalNpcVisualOverride>,
-  npcId: string,
-  editorState: EditableNpcVisualState,
-) {
-  return {
-    ...overrideMap,
-    [npcId]: buildOverrideFromEditorState(editorState),
-  };
-}
diff --git a/src/components/npcVisualEditorPersistence.test.ts b/src/components/npcVisualEditorPersistence.test.ts
deleted file mode 100644
index 47310f0c..00000000
--- a/src/components/npcVisualEditorPersistence.test.ts
+++ /dev/null
@@ -1,107 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-
-import type { MedievalNpcVisualOverride } from '../data/medievalNpcVisuals';
-import type { EditableNpcVisualState } from './npcVisualEditorModel';
-import {
-  NPC_LAYOUT_CONFIG_API_PATH,
-  NPC_VISUAL_OVERRIDES_API_PATH,
-  persistNpcLayoutConfig,
-  persistNpcVisualOverrides,
-} from './npcVisualEditorPersistence';
-import type { NpcLayoutConfig } from './npcVisualShared';
-
-function createEditorState(): EditableNpcVisualState {
-  return {
-    race: 'human',
-    bodyColor: 'black',
-    headIndex: 1,
-    hairColorIndex: 1,
-    hairStyleFrame: 0,
-    facialHairEnabled: false,
-    facialHairColorIndex: 1,
-    facialHairStyleFrame: 0,
-    headgearType: 'none',
-    headgearFile: '',
-    headgearFrame: 0,
-    mainHandType: 'none',
-    mainHandFile: '',
-    mainHandFrame: 0,
-    offHandType: 'none',
-    offHandFile: '',
-    offHandFrame: 0,
-  };
-}
-
-function createExistingOverride(): MedievalNpcVisualOverride {
-  return {
-    race: 'elf',
-    bodySrc: '/body.png',
-    headSrc: '/head.png',
-    hairSrc: '/hair.png',
-    handSrc: '/hand.png',
-    bodyFrames: [0, 1, 2, 3],
-    headFrame: 0,
-    hairFrame: 1,
-    handFrame: 0,
-  };
-}
-
-function createLayoutDraft(): NpcLayoutConfig {
-  return {
-    body: { x: 0, y: 0 },
-    head: { x: 1, y: 2 },
-    facialHair: { x: 3, y: 4 },
-    hair: { x: 5, y: 6 },
-    headgear: { x: 7, y: 8 },
-    hand: { x: 9, y: 10 },
-    mainHand: { x: 11, y: 12 },
-    offHand: { x: 13, y: 14 },
-  };
-}
-
-describe('npcVisualEditorPersistence', () => {
-  it('persists merged npc visual overrides and returns the writeback payload', async () => {
-    const saveJson = vi.fn(async () => undefined);
-    const result = await persistNpcVisualOverrides({
-      overrideMap: {
-        existing: createExistingOverride(),
-      },
-      npcId: 'npc-1',
-      editorState: createEditorState(),
-      saveJson,
-    });
-
-    expect(saveJson).toHaveBeenCalledWith(
-      NPC_VISUAL_OVERRIDES_API_PATH,
-      expect.objectContaining({
-        existing: createExistingOverride(),
-        'npc-1': expect.objectContaining({
-          race: 'human',
-          bodyFrames: [0, 1, 2, 3],
-        }),
-      }),
-      '保存角色形象覆盖配置失败',
-    );
-    expect(result.nextOverrideMap.existing).toEqual(createExistingOverride());
-    expect(result.nextOverrideMap['npc-1']).toEqual(expect.objectContaining({ race: 'human' }));
-    expect(result.saveMessage).toContain('npcVisualOverrides.json');
-  });
-
-  it('persists layout config with a cloned payload for local writeback', async () => {
-    const saveJson = vi.fn(async () => undefined);
-    const layoutDraft = createLayoutDraft();
-    const result = await persistNpcLayoutConfig({
-      layoutDraft,
-      saveJson,
-    });
-
-    expect(saveJson).toHaveBeenCalledWith(
-      NPC_LAYOUT_CONFIG_API_PATH,
-      expect.objectContaining(layoutDraft),
-      '保存角色布局配置失败',
-    );
-    expect(result.nextLayout).toEqual(layoutDraft);
-    expect(result.nextLayout).not.toBe(layoutDraft);
-    expect(result.saveMessage).toContain('角色布局');
-  });
-});
diff --git a/src/components/npcVisualEditorPersistence.ts b/src/components/npcVisualEditorPersistence.ts
deleted file mode 100644
index 7b9aecab..00000000
--- a/src/components/npcVisualEditorPersistence.ts
+++ /dev/null
@@ -1,65 +0,0 @@
-import type { MedievalNpcVisualOverride } from '../data/medievalNpcVisuals';
-import {
-  buildEditorJsonApiPath,
-  EDITOR_JSON_RESOURCE_IDS,
-} from '../editor/shared/editorApiClient';
-import { saveJsonObject } from '../editor/shared/jsonClient';
-import {
-  buildNpcVisualSavePayload,
-  type EditableNpcVisualState,
-} from './npcVisualEditorModel';
-import { cloneNpcLayoutConfig, type NpcLayoutConfig } from './npcVisualShared';
-
-export const NPC_VISUAL_OVERRIDES_API_PATH = buildEditorJsonApiPath(
-  EDITOR_JSON_RESOURCE_IDS.npcVisualOverrides,
-);
-export const NPC_LAYOUT_CONFIG_API_PATH = buildEditorJsonApiPath(
-  EDITOR_JSON_RESOURCE_IDS.npcLayoutConfig,
-);
-
-type SaveEditorJsonFn = typeof saveJsonObject;
-
-export async function persistNpcVisualOverrides(params: {
-  overrideMap: Record<string, MedievalNpcVisualOverride>;
-  npcId: string;
-  editorState: EditableNpcVisualState;
-  saveJson?: SaveEditorJsonFn;
-}) {
-  const {
-    overrideMap,
-    npcId,
-    editorState,
-    saveJson = saveJsonObject,
-  } = params;
-  const nextOverrideMap = buildNpcVisualSavePayload(overrideMap, npcId, editorState);
-
-  await saveJson(
-    NPC_VISUAL_OVERRIDES_API_PATH,
-    nextOverrideMap,
-    '保存角色形象覆盖配置失败',
-  );
-
-  return {
-    nextOverrideMap,
-    saveMessage: '已将角色形象覆盖配置保存到 src/data/npcVisualOverrides.json。',
-  };
-}
-
-export async function persistNpcLayoutConfig(params: {
-  layoutDraft: NpcLayoutConfig;
-  saveJson?: SaveEditorJsonFn;
-}) {
-  const { layoutDraft, saveJson = saveJsonObject } = params;
-  const nextLayout = cloneNpcLayoutConfig(layoutDraft);
-
-  await saveJson(
-    NPC_LAYOUT_CONFIG_API_PATH,
-    nextLayout,
-    '保存角色布局配置失败',
-  );
-
-  return {
-    nextLayout,
-    saveMessage: '已保存共享角色布局配置。',
-  };
-}
diff --git a/src/components/rpg-creation-asset-studio/index.ts b/src/components/rpg-creation-asset-studio/index.ts
deleted file mode 100644
index d382b4eb..00000000
--- a/src/components/rpg-creation-asset-studio/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-export {
-  RpgCreationRoleAssetStudioModal,
-  type RpgCreationRoleAssetStudioModalProps,
-} from './RpgCreationRoleAssetStudioModal';
diff --git a/src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx b/src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx
deleted file mode 100644
index eddeb37f..00000000
--- a/src/components/rpg-creation-editor/CustomWorldSceneChapterEditorSection.tsx
+++ /dev/null
@@ -1 +0,0 @@
-export { SectionPanel as default } from './RpgCreationEntityEditorShared';
diff --git a/src/components/rpg-creation-editor/index.ts b/src/components/rpg-creation-editor/index.ts
deleted file mode 100644
index 57c52ca0..00000000
--- a/src/components/rpg-creation-editor/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-export {
-  RpgCreationEntityEditorModal,
-  type RpgCreationEntityEditorModalProps,
-} from './RpgCreationEntityEditorModal';
diff --git a/src/components/rpg-creation-result/index.ts b/src/components/rpg-creation-result/index.ts
deleted file mode 100644
index 37fddfcf..00000000
--- a/src/components/rpg-creation-result/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-export {
-  RpgCreationResultView,
-  type RpgCreationResultViewProps,
-} from './RpgCreationResultView';
diff --git a/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx b/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
index 3dffbd6e..ae7e3bc1 100644
--- a/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
+++ b/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
@@ -17,6 +17,7 @@ import {
   upsertRpgWorldProfile,
 } from '../../services/rpg-creation';
 import type { AuthUser } from '../../services/authService';
+import { ApiClientError } from '../../services/apiClient';
 import {
   clearRpgProfileBrowseHistory as clearProfileBrowseHistory,
   deleteRpgEntryWorldProfile,
@@ -517,6 +518,7 @@ beforeEach(() => {
   vi.mocked(createRpgCreationSession).mockResolvedValue({
     session: mockSession,
   });
+  vi.mocked(getRpgCreationSession).mockResolvedValue(mockSession);
   vi.mocked(listRpgCreationWorks).mockResolvedValue([]);
   vi.mocked(executeRpgCreationAction).mockResolvedValue({
     operation: {
@@ -669,6 +671,67 @@ test('create tab resumes agent workspace when draft has no compiled result yet',
   expect(screen.queryByText('世界档案')).toBeNull();
 });
 
+test('opening a compiled draft with a missing agent session falls back to create hub', async () => {
+  const user = userEvent.setup();
+
+  vi.mocked(listRpgCreationWorks)
+    .mockResolvedValueOnce([
+      {
+        workId: 'draft:custom-world-agent-session-missing',
+        sourceType: 'agent_session',
+        status: 'draft',
+        title: '潮雾列岛',
+        subtitle: '世界底稿已生成',
+        summary: '这是一份已经整理过首版结果页的草稿。',
+        coverImageSrc: null,
+        coverRenderMode: 'image',
+        coverCharacterImageSrcs: [],
+        updatedAt: '2026-04-20T11:00:00.000Z',
+        publishedAt: null,
+        stage: 'object_refining',
+        stageLabel: '整理关键对象',
+        playableNpcCount: 1,
+        landmarkCount: 1,
+        roleVisualReadyCount: 0,
+        roleAnimationReadyCount: 0,
+        roleAssetSummaryLabel: null,
+        sessionId: 'custom-world-agent-session-missing',
+        profileId: null,
+        canResume: true,
+        canEnterWorld: false,
+      },
+    ])
+    .mockResolvedValueOnce([]);
+
+  vi.mocked(getRpgCreationSession).mockRejectedValueOnce(
+    new ApiClientError({
+      message: 'custom world agent session not found',
+      status: 404,
+      code: 'NOT_FOUND',
+    }),
+  );
+
+  render(<TestWrapper withAuth />);
+
+  await openCreationHub(user);
+  await user.click(screen.getByRole('button', { name: /继续完善/u }));
+
+  await waitFor(() => {
+    expect(
+      screen.getByText(
+        '这份共创草稿已失效，已为你返回创作中心，请重新开始创作。',
+      ),
+    ).toBeTruthy();
+  });
+
+  expect(window.location.search).toBe('');
+  expect(listRpgCreationWorks).toHaveBeenCalledTimes(2);
+  expect(screen.getByText('还没有作品')).toBeTruthy();
+  expect(
+    screen.queryByText('Agent工作区：custom-world-agent-session-missing'),
+  ).toBeNull();
+});
+
 test('clicking a public work while logged out routes through requireAuth', async () => {
   const user = userEvent.setup();
   const requireAuth = vi.fn();
diff --git a/src/components/rpg-entry/useRpgEntryLibraryDetail.ts b/src/components/rpg-entry/useRpgEntryLibraryDetail.ts
index e47c0cfb..d267c02e 100644
--- a/src/components/rpg-entry/useRpgEntryLibraryDetail.ts
+++ b/src/components/rpg-entry/useRpgEntryLibraryDetail.ts
@@ -16,6 +16,7 @@ import {
   publishRpgEntryWorldProfile,
   unpublishRpgEntryWorldProfile,
 } from '../../services/rpg-entry';
+import { ApiClientError } from '../../services/apiClient';
 import type { CustomWorldProfile } from '../../types';
 import {
   normalizeRpgEntryAgentBackedProfile,
@@ -79,6 +80,14 @@ type UseRpgEntryLibraryDetailParams = {
   markAutoSavedProfile: (profile: CustomWorldProfile) => void;
 };
 
+function isMissingRpgEntryAgentSessionError(error: unknown) {
+  return (
+    error instanceof ApiClientError &&
+    error.status === 404 &&
+    error.code === 'NOT_FOUND'
+  );
+}
+
 /**
  * 负责平台详情、创作作品入口和结果页打开路径。
  * 平台壳层只消费“打开哪个面板”的结果，不再自己拼接恢复流程细节。
@@ -218,7 +227,6 @@ export function useRpgEntryLibraryDetail(
   const handleOpenCreationWork = useCallback(
     async (work: CustomWorldWorkSummary) => {
       if (work.status === 'draft' && work.sessionId) {
-        persistAgentUiState(work.sessionId, null);
         setCustomWorldError(null);
         setCustomWorldAutoSaveError(null);
         setCustomWorldAutoSaveState('idle');
@@ -228,33 +236,57 @@ export function useRpgEntryLibraryDetail(
         const shouldOpenAgentWorkspace =
           work.playableNpcCount <= 0 && work.landmarkCount <= 0;
 
-        if (shouldOpenAgentWorkspace) {
-          // 仅八锚点未整理成底稿时才恢复 Agent 对话工作区。
-          suppressAgentDraftResultAutoOpen();
-          setGeneratedCustomWorldProfile(null);
-          setCustomWorldResultViewSource(null);
+        try {
+          if (shouldOpenAgentWorkspace) {
+            // 仅八锚点未整理成底稿时才恢复 Agent 对话工作区。
+            suppressAgentDraftResultAutoOpen();
+            persistAgentUiState(work.sessionId, null);
+            setGeneratedCustomWorldProfile(null);
+            setCustomWorldResultViewSource(null);
+            setPlatformTabToCreate();
+            setSelectionStage('agent-workspace');
+            return;
+          }
+
+          releaseAgentDraftResultAutoOpenSuppression();
+          const latestSession = await syncAgentSessionSnapshot(work.sessionId);
+          const nextProfile = buildDraftResultProfile(latestSession);
+          if (!nextProfile) {
+            persistAgentUiState(work.sessionId, null);
+            setPlatformError('当前草稿还没有可编辑的结果页数据，请先继续补齐锚点。');
+            setPlatformTabToCreate();
+            setSelectionStage('agent-workspace');
+            return;
+          }
+
+          persistAgentUiState(work.sessionId, null);
+          setGeneratedCustomWorldProfile(
+            normalizeRpgEntryAgentBackedProfile(nextProfile),
+          );
+          setCustomWorldResultViewSource('agent-draft');
           setPlatformTabToCreate();
-          setSelectionStage('agent-workspace');
+          setSelectionStage('custom-world-result');
+          return;
+        } catch (error) {
+          if (isMissingRpgEntryAgentSessionError(error)) {
+            // 失效会话不能继续保留在恢复状态里，否则刷新后会重复命中同一个坏 session。
+            persistAgentUiState(null, null);
+            setGeneratedCustomWorldProfile(null);
+            setCustomWorldResultViewSource(null);
+            await refreshCustomWorldWorks().catch(() => []);
+            setPlatformError(
+              '这份共创草稿已失效，已为你返回创作中心，请重新开始创作。',
+            );
+          } else {
+            setPlatformError(
+              resolveRpgEntryErrorMessage(error, '读取创作草稿失败。'),
+            );
+          }
+
+          setPlatformTabToCreate();
+          setSelectionStage('platform');
           return;
         }
-
-        releaseAgentDraftResultAutoOpenSuppression();
-        const latestSession = await syncAgentSessionSnapshot(work.sessionId);
-        const nextProfile = buildDraftResultProfile(latestSession);
-        if (!nextProfile) {
-          setPlatformError('当前草稿还没有可编辑的结果页数据，请先继续补齐锚点。');
-          setPlatformTabToCreate();
-          setSelectionStage('agent-workspace');
-          return;
-        }
-
-        setGeneratedCustomWorldProfile(
-          normalizeRpgEntryAgentBackedProfile(nextProfile),
-        );
-        setCustomWorldResultViewSource('agent-draft');
-        setPlatformTabToCreate();
-        setSelectionStage('custom-world-result');
-        return;
       }
 
       if (!work.profileId) {
diff --git a/src/data/editorValidation.ts b/src/data/editorValidation.ts
deleted file mode 100644
index afcd8c24..00000000
--- a/src/data/editorValidation.ts
+++ /dev/null
@@ -1,254 +0,0 @@
-import { Character, ItemCatalogOverride, WorldType } from '../types';
-import { CharacterPresetOverride } from './characterPresets';
-import { MonsterPreset, MonsterPresetOverride } from './hostileNpcPresets';
-import { SceneNpcPresetOverride, ScenePreset, ScenePresetOverride } from './scenePresets';
-
-function pushError(errors: string[], message: string) {
-  errors.push(message);
-}
-
-function isPositiveNumber(value: number | undefined) {
-  return typeof value === 'number' && Number.isFinite(value) && value > 0;
-}
-
-function isKnownGender(value: unknown): value is 'male' | 'female' {
-  return value === 'male' || value === 'female';
-}
-
-function isNonEmptyStringArray(value: unknown): value is string[] {
-  return Array.isArray(value) && value.every(item => typeof item === 'string' && item.trim().length > 0);
-}
-
-function validateBuildBuffs(errors: string[], ownerId: string, label: string, buffs: unknown) {
-  if (!Array.isArray(buffs)) {
-    pushError(errors, `${ownerId} ${label} must be an array.`);
-    return;
-  }
-
-  buffs.forEach((buff, index) => {
-    if (!buff || typeof buff !== 'object') {
-      pushError(errors, `${ownerId} ${label}[${index}] must be an object.`);
-      return;
-    }
-
-    const typedBuff = buff as {
-      name?: unknown;
-      tags?: unknown;
-      durationTurns?: unknown;
-    };
-
-    if (typeof typedBuff.name !== 'string' || !typedBuff.name.trim()) {
-      pushError(errors, `${ownerId} ${label}[${index}] is missing a valid name.`);
-    }
-
-    if (!isNonEmptyStringArray(typedBuff.tags)) {
-      pushError(errors, `${ownerId} ${label}[${index}].tags must be a non-empty string array.`);
-    }
-
-    if (typeof typedBuff.durationTurns !== 'number' || !Number.isFinite(typedBuff.durationTurns) || typedBuff.durationTurns <= 0) {
-      pushError(errors, `${ownerId} ${label}[${index}].durationTurns must be > 0.`);
-    }
-  });
-}
-
-export function validateCharacterOverrides(
-  overrideMap: Record<string, CharacterPresetOverride>,
-  characters: Character[],
-  scenesByWorld: Partial<Record<WorldType, Array<Pick<ScenePreset, 'id'>>>>,
-) {
-  const errors: string[] = [];
-  const validCharacterIds = new Set(characters.map(character => character.id));
-  const validSceneIdsByWorld = {
-    [WorldType.WUXIA]: new Set((scenesByWorld[WorldType.WUXIA] ?? []).map(scene => scene.id)),
-    [WorldType.XIANXIA]: new Set((scenesByWorld[WorldType.XIANXIA] ?? []).map(scene => scene.id)),
-    [WorldType.CUSTOM]: new Set((scenesByWorld[WorldType.CUSTOM] ?? []).map(scene => scene.id)),
-  };
-
-  Object.entries(overrideMap).forEach(([characterId, override]) => {
-    if (!validCharacterIds.has(characterId)) {
-      pushError(errors, `未知角色覆盖：${characterId}`);
-      return;
-    }
-
-    if (override.gender !== undefined && !isKnownGender(override.gender)) {
-      pushError(errors, `${characterId} gender must be "male" or "female".`);
-    }
-
-    if (override.combatTags !== undefined && !isNonEmptyStringArray(override.combatTags)) {
-      pushError(errors, `${characterId} combatTags must be a non-empty string array.`);
-    }
-
-    if (override.skills) {
-      override.skills.forEach((skill, index) => {
-        const skillLabel = `${characterId} skill ${skill.id || index + 1}`;
-        if (!skill.id?.trim()) pushError(errors, `${skillLabel} is missing id.`);
-        if (!skill.name?.trim()) pushError(errors, `${skillLabel} is missing name.`);
-        if (!isPositiveNumber(skill.range)) pushError(errors, `${skillLabel} range must be > 0.`);
-        if (typeof skill.damage !== 'number' || skill.damage < 0) pushError(errors, `${skillLabel} damage must be >= 0.`);
-        if (typeof skill.manaCost !== 'number' || skill.manaCost < 0) pushError(errors, `${skillLabel} manaCost must be >= 0.`);
-        if (typeof skill.cooldownTurns !== 'number' || skill.cooldownTurns < 0) pushError(errors, `${skillLabel} cooldownTurns must be >= 0.`);
-        if (skill.buildBuffs !== undefined) {
-          validateBuildBuffs(errors, characterId, `skill ${skill.id || index + 1} buildBuffs`, skill.buildBuffs);
-        }
-      });
-    }
-
-    if (override.sceneBindings) {
-      Object.entries(override.sceneBindings).forEach(([world, binding]) => {
-        if (!binding) return;
-        const worldType = world as WorldType;
-        const validSceneIds = validSceneIdsByWorld[worldType];
-
-        if (binding.homeSceneId && !validSceneIds.has(binding.homeSceneId)) {
-          pushError(errors, `${characterId} has invalid homeSceneId for ${worldType}: ${binding.homeSceneId}`);
-        }
-
-        (binding.npcSceneIds ?? []).forEach(sceneId => {
-          if (!validSceneIds.has(sceneId)) {
-            pushError(errors, `${characterId} has invalid npcSceneId for ${worldType}: ${sceneId}`);
-          }
-        });
-      });
-    }
-  });
-
-  return errors;
-}
-
-export function validateMonsterOverrides(
-  overrideMap: Record<string, MonsterPresetOverride>,
-  monsters: MonsterPreset[],
-) {
-  const errors: string[] = [];
-  const validMonsterIds = new Set(monsters.map(monster => monster.id));
-
-  Object.entries(overrideMap).forEach(([monsterId, override]) => {
-    if (!validMonsterIds.has(monsterId)) {
-      pushError(errors, `未知怪物覆盖：${monsterId}`);
-      return;
-    }
-
-    Object.entries(override.baseStats ?? {}).forEach(([key, value]) => {
-      const numericValue = typeof value === 'number' ? value : undefined;
-      if (!isPositiveNumber(numericValue)) {
-        pushError(errors, `${monsterId} baseStats.${key} must be > 0.`);
-      }
-    });
-
-    if (override.combatTags !== undefined && !isNonEmptyStringArray(override.combatTags)) {
-      pushError(errors, `${monsterId} combatTags must be a non-empty string array.`);
-    }
-
-    Object.entries(override.animations ?? {}).forEach(([animation, rawConfig]) => {
-      const config = rawConfig as { frames?: number; fps?: number } | undefined;
-      if (!config) return;
-      if (!isPositiveNumber(config.frames)) pushError(errors, `${monsterId} ${animation}.frames must be > 0.`);
-      if (!isPositiveNumber(config.fps)) pushError(errors, `${monsterId} ${animation}.fps must be > 0.`);
-    });
-  });
-
-  return errors;
-}
-
-export function validateSceneOverrides(
-  overrideMap: Record<string, ScenePresetOverride>,
-  scenes: ScenePreset[],
-  _monstersByWorld: Partial<Record<WorldType, MonsterPreset[]>>,
-) {
-  const errors: string[] = [];
-  const sceneById = new Map(scenes.map(scene => [scene.id, scene]));
-  const validSceneIds = new Set(scenes.map(scene => scene.id));
-
-  Object.entries(overrideMap).forEach(([sceneId, override]) => {
-    const scene = sceneById.get(sceneId);
-    if (!scene) {
-      pushError(errors, `未知场景覆盖：${sceneId}`);
-      return;
-    }
-
-    if (override.forwardSceneId && !validSceneIds.has(override.forwardSceneId)) {
-      pushError(errors, `${sceneId} has invalid forwardSceneId: ${override.forwardSceneId}`);
-    }
-
-    (override.connectedSceneIds ?? []).forEach(targetSceneId => {
-      if (!validSceneIds.has(targetSceneId)) {
-        pushError(errors, `${sceneId} has invalid connectedSceneId: ${targetSceneId}`);
-      }
-    });
-
-  });
-
-  return errors;
-}
-
-export function validateSceneNpcOverrides(
-  overrideMap: Record<string, SceneNpcPresetOverride>,
-  validNpcIds: string[],
-  characters: Character[],
-) {
-  const errors: string[] = [];
-  const npcIdSet = new Set(validNpcIds);
-  const characterIdSet = new Set(characters.map(character => character.id));
-
-  Object.entries(overrideMap).forEach(([npcId, override]) => {
-    if (!npcIdSet.has(npcId)) {
-      pushError(errors, `未知场景角色覆盖：${npcId}`);
-      return;
-    }
-
-    if (override.gender !== undefined && !isKnownGender(override.gender)) {
-      pushError(errors, `${npcId} gender must be "male" or "female".`);
-    }
-
-    if (override.characterId && !characterIdSet.has(override.characterId)) {
-      pushError(errors, `${npcId} has invalid characterId: ${override.characterId}`);
-    }
-  });
-
-  return errors;
-}
-
-export function validateItemOverrides(
-  overrideMap: Record<string, ItemCatalogOverride>,
-  validItemIds: string[],
-) {
-  const errors: string[] = [];
-  const itemIdSet = new Set(validItemIds);
-
-  Object.entries(overrideMap).forEach(([itemId, override]) => {
-    if (!itemIdSet.has(itemId)) {
-      pushError(errors, `未知物品覆盖：${itemId}`);
-      return;
-    }
-
-    if (override.name !== undefined && !override.name.trim()) {
-      pushError(errors, `${itemId} name cannot be empty.`);
-    }
-
-    if (override.category !== undefined && !override.category.trim()) {
-      pushError(errors, `${itemId} category cannot be empty.`);
-    }
-
-    if (override.description !== undefined && !override.description.trim()) {
-      pushError(errors, `${itemId} description cannot be empty.`);
-    }
-
-    if (override.tags !== undefined && !isNonEmptyStringArray(override.tags)) {
-      pushError(errors, `${itemId} tags must be a non-empty string array.`);
-    }
-
-    if (override.buildProfile?.tags !== undefined && !isNonEmptyStringArray(override.buildProfile.tags)) {
-      pushError(errors, `${itemId} buildProfile.tags must be a non-empty string array.`);
-    }
-
-    if (override.buildProfile?.craftTags !== undefined && !isNonEmptyStringArray(override.buildProfile.craftTags)) {
-      pushError(errors, `${itemId} buildProfile.craftTags must be a non-empty string array.`);
-    }
-
-    if (override.useProfile?.buildBuffs !== undefined) {
-      validateBuildBuffs(errors, itemId, 'useProfile.buildBuffs', override.useProfile.buildBuffs);
-    }
-  });
-
-  return errors;
-}
diff --git a/src/data/functionCatalog/flow/storyOpeningCampDialogue.ts b/src/data/functionCatalog/flow/storyOpeningCampDialogue.ts
index 2cc00390..f05d015e 100644
--- a/src/data/functionCatalog/flow/storyOpeningCampDialogue.ts
+++ b/src/data/functionCatalog/flow/storyOpeningCampDialogue.ts
@@ -30,7 +30,7 @@ export const STORY_OPENING_CAMP_DIALOGUE_FUNCTION: FunctionDocumentationEntry =
       storyMode: 'special_sequence',
       uiMode: 'none',
       executor:
-        'src/hooks/rpg-runtime-story/openingAdventure.ts + src/services/prompt.ts',
+        'server-node/src/modules/rpg-runtime-story/RpgRuntimeStoryActionDomain.ts + src/hooks/rpg-runtime-story/storyContextBuilder.ts',
       animationNote: '重点在对白本身，不额外驱动独立战斗/位移动画。',
       storyNote: '会把 prompt 切到营地开场对白模式，并要求输出结构化对话行。',
       uiNote: '不弹 modal，直接进入对白流。',
diff --git a/src/data/functionCatalog/index.ts b/src/data/functionCatalog/index.ts
index a554c40f..c5d78b89 100644
--- a/src/data/functionCatalog/index.ts
+++ b/src/data/functionCatalog/index.ts
@@ -14,6 +14,7 @@ export * from './flow/campTravelHomeScene';
 export * from './flow/storyContinueAdventure';
 export * from './flow/storyOpeningCampDialogue';
 export * from './npc/npcChat';
+export * from './npc/npcChatQuestOffer';
 export * from './npc/npcFight';
 export * from './npc/npcGift';
 export * from './npc/npcHelp';
diff --git a/src/data/functionCatalog/npc/index.ts b/src/data/functionCatalog/npc/index.ts
index ce075106..d372db24 100644
--- a/src/data/functionCatalog/npc/index.ts
+++ b/src/data/functionCatalog/npc/index.ts
@@ -1,5 +1,10 @@
 import type { FunctionDocumentationEntry } from '../types';
 import { NPC_CHAT_FUNCTION } from './npcChat';
+import {
+  NPC_CHAT_QUEST_OFFER_ABANDON_FUNCTION,
+  NPC_CHAT_QUEST_OFFER_REPLACE_FUNCTION,
+  NPC_CHAT_QUEST_OFFER_VIEW_FUNCTION,
+} from './npcChatQuestOffer';
 import { NPC_FIGHT_FUNCTION } from './npcFight';
 import { NPC_GIFT_FUNCTION } from './npcGift';
 import { NPC_HELP_FUNCTION } from './npcHelp';
@@ -18,6 +23,9 @@ export const NPC_FUNCTION_DOCUMENTATION: FunctionDocumentationEntry[] = [
   NPC_SPAR_FUNCTION,
   NPC_HELP_FUNCTION,
   NPC_CHAT_FUNCTION,
+  NPC_CHAT_QUEST_OFFER_VIEW_FUNCTION,
+  NPC_CHAT_QUEST_OFFER_REPLACE_FUNCTION,
+  NPC_CHAT_QUEST_OFFER_ABANDON_FUNCTION,
   NPC_GIFT_FUNCTION,
   NPC_RECRUIT_FUNCTION,
   NPC_QUEST_ACCEPT_FUNCTION,
diff --git a/src/data/functionCatalog/npc/npcChat.ts b/src/data/functionCatalog/npc/npcChat.ts
index c1b4b041..a0680b94 100644
--- a/src/data/functionCatalog/npc/npcChat.ts
+++ b/src/data/functionCatalog/npc/npcChat.ts
@@ -24,7 +24,7 @@ export const NPC_CHAT_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'stream_then_defer',
     uiMode: 'none',
     executor:
-      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> commitNpcChatState',
+      'src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts -> commitNpcChatState',
     animationNote: '重点在流式对白和轻量站场，不额外打开窗口。',
     storyNote:
       '先生成聊天正文，再把真正的新选项放入 deferredOptions，等待 continue adventure。',
diff --git a/src/data/functionCatalog/npc/npcChatQuestOffer.ts b/src/data/functionCatalog/npc/npcChatQuestOffer.ts
new file mode 100644
index 00000000..6c142c0a
--- /dev/null
+++ b/src/data/functionCatalog/npc/npcChatQuestOffer.ts
@@ -0,0 +1,86 @@
+import type { FunctionDocumentationEntry } from '../types';
+
+/**
+ * npc_chat_quest_offer_*
+ *
+ * NPC 聊天态里的临时委托处理 function。它们不是新的任务系统，
+ * 而是高好感聊天中 pending quest offer 的查看、更换和放弃入口。
+ */
+const QUEST_OFFER_SOURCE = 'src/data/functionCatalog/npc/npcChatQuestOffer.ts';
+const QUEST_OFFER_EXECUTOR =
+  'server-node/src/modules/quest/questStoryActionService.ts -> resolveQuestStoryAction';
+
+export const NPC_CHAT_QUEST_OFFER_VIEW_FUNCTION: FunctionDocumentationEntry = {
+  id: 'npc_chat_quest_offer_view',
+  domain: 'npc',
+  title: '查看委托',
+  source: QUEST_OFFER_SOURCE,
+  summary: '查看当前聊天中 NPC 刚提出但尚未领取的委托。',
+  detailedDescription:
+    '它用于 pending quest offer 阶段，只打开或返回当前待领取任务详情，不把任务写入正式 quest log。',
+  trigger: 'NPC 聊天触发待领取委托后，任务处理态选项中出现。',
+  execution:
+    '后端读取当前 pending quest offer，并返回可展示的任务详情与领取入口。',
+  result: '玩家可以查看任务目标和奖励，确认领取前不会改变正式任务日志。',
+  active: true,
+  runtime: {
+    storyMode: 'local_only',
+    uiMode: 'none',
+    executor: QUEST_OFFER_EXECUTOR,
+    animationNote: '不触发角色位移动画，重点是切换任务详情展示。',
+    storyNote: '只保留当前委托上下文，不生成新的聊天剧情。',
+    uiNote: '展示待领取任务详情，等待玩家领取、替换或返回聊天。',
+    compactDetailText: '查看这份委托',
+  },
+};
+
+export const NPC_CHAT_QUEST_OFFER_REPLACE_FUNCTION: FunctionDocumentationEntry =
+  {
+    id: 'npc_chat_quest_offer_replace',
+    domain: 'npc',
+    title: '更换委托',
+    source: QUEST_OFFER_SOURCE,
+    summary: '让 NPC 重新生成一份聊天内待领取委托。',
+    detailedDescription:
+      '它不会本地改写现有任务文案，而是重新走任务生成链，替换当前 pending quest offer。',
+    trigger: 'NPC 聊天任务处理态中，玩家不满意当前委托时出现。',
+    execution:
+      '后端调用任务生成链生成新 quest offer，并覆盖当前聊天态 pending offer。',
+    result:
+      '当前待领取委托被替换，聊天仍停留在任务处理态，正式 quest log 不变。',
+    active: true,
+    runtime: {
+      storyMode: 'local_effect_then_generate',
+      uiMode: 'none',
+      executor: QUEST_OFFER_EXECUTOR,
+      animationNote: '不触发战斗或移动演出，只追加轻量聊天反馈。',
+      storyNote: '重新生成 pending quest offer，并说明 NPC 换了一个委托。',
+      uiNote: '继续显示查看、更换、放弃这组任务处理选项。',
+      compactDetailText: '换一个委托',
+    },
+  };
+
+export const NPC_CHAT_QUEST_OFFER_ABANDON_FUNCTION: FunctionDocumentationEntry =
+  {
+    id: 'npc_chat_quest_offer_abandon',
+    domain: 'npc',
+    title: '放弃委托',
+    source: QUEST_OFFER_SOURCE,
+    summary: '丢弃当前聊天中尚未领取的委托。',
+    detailedDescription:
+      '它只清理 pending quest offer，不影响已经写入 quest log 的正式任务，也不会扣除奖励或结算任务失败。',
+    trigger: 'NPC 聊天任务处理态中，玩家暂时不想接这份委托时出现。',
+    execution:
+      '后端清空当前聊天态 pending quest offer，并恢复普通 NPC 聊天选项。',
+    result: '待领取委托消失，玩家回到自由聊天或离开 NPC 的正常流程。',
+    active: true,
+    runtime: {
+      storyMode: 'local_only',
+      uiMode: 'none',
+      executor: QUEST_OFFER_EXECUTOR,
+      animationNote: '不触发额外演出，只回到普通聊天态。',
+      storyNote: '追加玩家暂时不接委托的轻量反馈。',
+      uiNote: '恢复普通 npc_chat 建议和自定义输入。',
+      compactDetailText: '暂时不接',
+    },
+  };
diff --git a/src/data/functionCatalog/npc/npcFight.ts b/src/data/functionCatalog/npc/npcFight.ts
index 7cb78e3d..6986c8df 100644
--- a/src/data/functionCatalog/npc/npcFight.ts
+++ b/src/data/functionCatalog/npc/npcFight.ts
@@ -23,7 +23,7 @@ export const NPC_FIGHT_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'special_sequence',
     uiMode: 'none',
     executor:
-      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> handleNpcInteraction',
+      'src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts -> handleNpcInteraction',
     animationNote: '切到 NPC 战斗模式后，由战斗播放链路驱动后续动画。',
     storyNote: '不会先弹窗，直接把当前 encounter 切成战斗态并进入后续结算。',
     uiNote: '不弹 modal，直接进入战斗。',
diff --git a/src/data/functionCatalog/npc/npcHelp.ts b/src/data/functionCatalog/npc/npcHelp.ts
index f04be5f1..18f7b0ec 100644
--- a/src/data/functionCatalog/npc/npcHelp.ts
+++ b/src/data/functionCatalog/npc/npcHelp.ts
@@ -22,7 +22,7 @@ export const NPC_HELP_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'local_effect_then_generate',
     uiMode: 'none',
     executor:
-      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> handleNpcInteraction',
+      'src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts -> handleNpcInteraction',
     animationNote: '不单独开窗口，直接在当前交互里结算帮助结果。',
     storyNote: '点击后立即按本地奖励规则结算，并继续生成新的故事状态。',
     uiNote: '不弹 modal，直接获得帮助反馈。',
diff --git a/src/data/functionCatalog/npc/npcLeave.ts b/src/data/functionCatalog/npc/npcLeave.ts
index 16190117..e9157f68 100644
--- a/src/data/functionCatalog/npc/npcLeave.ts
+++ b/src/data/functionCatalog/npc/npcLeave.ts
@@ -21,7 +21,7 @@ export const NPC_LEAVE_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'local_effect_then_generate',
     uiMode: 'none',
     executor:
-      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> handleNpcInteraction',
+      'src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts -> handleNpcInteraction',
     animationNote: '通常只做轻量离场，不单独打开窗口。',
     storyNote: '点击后结束当前 NPC 交互，并回到新的探索剧情。',
     uiNote: '不弹 modal，直接退出互动。',
diff --git a/src/data/functionCatalog/npc/npcPreviewTalk.ts b/src/data/functionCatalog/npc/npcPreviewTalk.ts
index 343ccbd2..e6931b1c 100644
--- a/src/data/functionCatalog/npc/npcPreviewTalk.ts
+++ b/src/data/functionCatalog/npc/npcPreviewTalk.ts
@@ -60,7 +60,7 @@ export const NPC_PREVIEW_TALK_FUNCTION: FunctionDocumentationEntry = {
     uiMode: 'npc_interaction_entry',
     visuals: NPC_PREVIEW_TALK_OPTION_VISUALS,
     executor:
-    'src/hooks/rpg-runtime-story/choiceActions.ts + src/hooks/rpg-runtime-story/npcEncounterActions.ts',
+    'src/hooks/rpg-runtime-story/choiceActions.ts + src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts',
     animationNote:
       '保持轻量 idle 站场，不做额外位移，重点是把交互焦点切到 NPC 身上。',
     storyNote:
diff --git a/src/data/functionCatalog/npc/npcSpar.ts b/src/data/functionCatalog/npc/npcSpar.ts
index a0b72bfa..3875432d 100644
--- a/src/data/functionCatalog/npc/npcSpar.ts
+++ b/src/data/functionCatalog/npc/npcSpar.ts
@@ -21,7 +21,7 @@ export const NPC_SPAR_FUNCTION: FunctionDocumentationEntry = {
     storyMode: 'special_sequence',
     uiMode: 'none',
     executor:
-      'src/hooks/rpg-runtime-story/npcEncounterActions.ts -> handleNpcInteraction',
+      'src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts -> handleNpcInteraction',
     animationNote: '切到 spar 战斗模式后，由战斗播放链路驱动切磋演出。',
     storyNote: '不会先弹窗，直接进入点到为止的切磋流程。',
     uiNote: '不弹 modal，直接切磋。',
diff --git a/src/data/functionCatalog/state/battleAttackBasic.ts b/src/data/functionCatalog/state/battleAttackBasic.ts
new file mode 100644
index 00000000..acbdec3d
--- /dev/null
+++ b/src/data/functionCatalog/state/battleAttackBasic.ts
@@ -0,0 +1,35 @@
+import type { FunctionDocumentationEntry } from '../types';
+
+/**
+ * battle_attack_basic
+ *
+ * 后端单行为战斗模型的普通攻击入口。该 function 只登记文档和契约，
+ * 不进入前端本地 state function 候选池。
+ */
+export const BATTLE_ATTACK_BASIC_FUNCTION: FunctionDocumentationEntry = {
+  id: 'battle_attack_basic',
+  domain: 'state',
+  title: '普通攻击',
+  source: 'src/data/functionCatalog/state/battleAttackBasic.ts',
+  summary: '后端单行为战斗模型中的基础攻击 function。',
+  detailedDescription:
+    '这个 function 代表一次明确的普通攻击点击，后端直接结算伤害、敌方反击和下一轮战斗选项，不再请求 AI 续写整段战斗剧情。',
+  trigger: '仅在 battle 状态且场上仍有存活敌人时，由后端战斗 option 池下发。',
+  execution:
+    '前端透传 functionId，后端 combatResolutionService 直接按普通攻击规则结算本回合。',
+  result: '刷新 HP、战斗日志和下一轮战斗 options；若敌人被击败，再进入脱战剧情推理。',
+  state: 'battle',
+  category: 'battle',
+  active: true,
+  runtime: {
+    storyMode: 'local_only',
+    uiMode: 'none',
+    executor:
+      'server-node/src/modules/combat/combatResolutionService.ts -> resolveCombatAction',
+    animationNote: '播放一次基础攻击和受击反馈，不扩展成连续多段连击。',
+    storyNote:
+      '战斗未结束时只展示本次结算文本；战斗结束后才请求脱战剧情。',
+    uiNote: '由后端战斗 option 池生成，不进入前端本地 state function 候选。',
+    compactDetailText: '直接攻击眼前敌人',
+  },
+};
diff --git a/src/data/functionCatalog/state/battleUseSkill.ts b/src/data/functionCatalog/state/battleUseSkill.ts
new file mode 100644
index 00000000..47c1f87f
--- /dev/null
+++ b/src/data/functionCatalog/state/battleUseSkill.ts
@@ -0,0 +1,36 @@
+import type { FunctionDocumentationEntry } from '../types';
+
+/**
+ * battle_use_skill
+ *
+ * 后端单行为战斗模型的技能释放入口。每个技能 option 复用同一个
+ * functionId，具体技能必须由 runtimePayload.skillId 指定。
+ */
+export const BATTLE_USE_SKILL_FUNCTION: FunctionDocumentationEntry = {
+  id: 'battle_use_skill',
+  domain: 'state',
+  title: '释放技能',
+  source: 'src/data/functionCatalog/state/battleUseSkill.ts',
+  summary: '后端单行为战斗模型中的指定技能释放 function。',
+  detailedDescription:
+    '这个 functionId 可以对应多个技能 option 实例。前端只展示技能名和不可用原因，后端根据 runtimePayload.skillId 校验蓝量、冷却并结算本次技能效果。',
+  trigger: '仅在 battle 状态下由后端按角色技能列表生成，可能携带 disabled 状态。',
+  execution:
+    '前端透传 runtimePayload.skillId，后端 combatResolutionService 校验技能并完成一次技能动作结算。',
+  result:
+    '更新 MP、技能冷却、敌我 HP 和下一轮战斗 options；若战斗结束，再触发脱战剧情推理。',
+  state: 'battle',
+  category: 'battle',
+  active: true,
+  runtime: {
+    storyMode: 'local_only',
+    uiMode: 'none',
+    executor:
+      'server-node/src/modules/combat/combatResolutionService.ts -> resolveCombatAction',
+    animationNote: '根据技能 option 播放一次技能演出，不在本 function 内追加多回合动作。',
+    storyNote:
+      '战斗未结束时使用本次技能结算文本；只有战斗结束才请求新剧情。',
+    uiNote: '每个技能是一个后端下发的独立 option，必须携带 skillId。',
+    compactDetailText: '释放一个指定技能',
+  },
+};
diff --git a/src/data/functionCatalog/state/index.ts b/src/data/functionCatalog/state/index.ts
index 73b0a582..c4337f07 100644
--- a/src/data/functionCatalog/state/index.ts
+++ b/src/data/functionCatalog/state/index.ts
@@ -1,11 +1,13 @@
 import type { StateFunctionSource } from '../types';
 import { BATTLE_ALL_IN_CRUSH_FUNCTION_SOURCE } from './battleAllInCrush';
+import { BATTLE_ATTACK_BASIC_FUNCTION } from './battleAttackBasic';
 import { BATTLE_ESCAPE_BREAKOUT_FUNCTION_SOURCE } from './battleEscapeBreakout';
 import { BATTLE_FEINT_STEP_FUNCTION_SOURCE } from './battleFeintStep';
 import { BATTLE_FINISHER_WINDOW_FUNCTION_SOURCE } from './battleFinisherWindow';
 import { BATTLE_GUARD_BREAK_FUNCTION_SOURCE } from './battleGuardBreak';
 import { BATTLE_PROBE_PRESSURE_FUNCTION_SOURCE } from './battleProbePressure';
 import { BATTLE_RECOVER_BREATH_FUNCTION_SOURCE } from './battleRecoverBreath';
+import { BATTLE_USE_SKILL_FUNCTION } from './battleUseSkill';
 import { IDLE_CALL_OUT_FUNCTION_SOURCE } from './idleCallOut';
 import { IDLE_EXPLORE_FORWARD_FUNCTION_SOURCE } from './idleExploreForward';
 import { IDLE_FOLLOW_CLUE_FUNCTION_SOURCE } from './idleFollowClue';
@@ -40,7 +42,9 @@ export const STATE_FUNCTION_PROMPT_DESCRIPTIONS = Object.fromEntries(
   ]),
 ) as Record<string, string>;
 
-export const STATE_FUNCTION_DOCUMENTATION = STATE_FUNCTION_SOURCES.map(
-  (source) => source.documentation,
-);
+export const STATE_FUNCTION_DOCUMENTATION = [
+  BATTLE_ATTACK_BASIC_FUNCTION,
+  BATTLE_USE_SKILL_FUNCTION,
+  ...STATE_FUNCTION_SOURCES.map((source) => source.documentation),
+];
 
diff --git a/src/data/sceneObservation.ts b/src/data/sceneObservation.ts
deleted file mode 100644
index 1fbdecc6..00000000
--- a/src/data/sceneObservation.ts
+++ /dev/null
@@ -1,37 +0,0 @@
-import { WorldType } from '../types';
-import { getSceneFriendlyNpcs, getSceneHostileNpcs,getScenePresetById } from './scenePresets';
-
-export function buildSceneObserveSignsStoryText(
-  worldType: WorldType | null,
-  sceneId: string | null | undefined,
-) {
-  if (!worldType) {
-    return '你停下来倾听，但目前场景上下文不足，无法判断附近有什么。';
-  }
-
-  const scene = getScenePresetById(worldType, sceneId);
-  if (!scene) {
-    return '你停下来倾听，但这个区域还没有露出任何可靠的痕迹。';
-  }
-
-  const friendlyNpcs = getSceneFriendlyNpcs(scene);
-  const hostileNpcs = getSceneHostileNpcs(scene);
-  const npcSummary = friendlyNpcs.length > 0
-    ? `可能的角色：${friendlyNpcs.map(npc => `${npc.name}（${npc.role}）`).join('，')}`
-    : '可能的角色：暂无明确识别';
-  const hostileSummary = hostileNpcs.length > 0
-    ? `可能的敌对角色：${hostileNpcs.map(npc => npc.name).join('，')}`
-    : '可能的敌对角色：无明确威胁特征';
-  const treasureSummary = scene.treasureHints.length > 0
-    ? `可能的宝藏线索：${scene.treasureHints.slice(0, 2).join('，')}`
-    : '可能的宝藏线索：暂无发现';
-
-  const bossCandidate = hostileNpcs[0] ?? null;
-  const bossSummary = bossCandidate
-    ? hostileNpcs.length >= 3
-      ? `Boss线索：${bossCandidate.name} 感觉是这里最强的敌对存在。${bossCandidate.description}`
-      : `Boss线索：暂无明显首领，但${bossCandidate.name} 仍然是最需要警惕的危险威胁。`
-    : 'Boss线索：暂无迹象指向该区域有明确首领。';
-
-  return `你稳住队伍，梳理${scene.name}周围隐藏的迹象。${npcSummary}。${hostileSummary}。${treasureSummary}。${bossSummary}`;
-}
diff --git a/src/editor/shared/EditorNotice.tsx b/src/editor/shared/EditorNotice.tsx
deleted file mode 100644
index e733d8da..00000000
--- a/src/editor/shared/EditorNotice.tsx
+++ /dev/null
@@ -1,20 +0,0 @@
-type EditorNoticeTone = 'muted' | 'warning';
-
-const TONE_CLASS_NAMES: Record<EditorNoticeTone, string> = {
-  muted: 'text-xs text-zinc-400',
-  warning: 'text-xs text-amber-200/90',
-};
-
-export function EditorNotice({
-  message,
-  tone = 'muted',
-}: {
-  message: string | null;
-  tone?: EditorNoticeTone;
-}) {
-  if (!message) {
-    return null;
-  }
-
-  return <div className={TONE_CLASS_NAMES[tone]}>{message}</div>;
-}
diff --git a/src/editor/shared/FormFields.tsx b/src/editor/shared/FormFields.tsx
deleted file mode 100644
index be10a0ad..00000000
--- a/src/editor/shared/FormFields.tsx
+++ /dev/null
@@ -1,161 +0,0 @@
-import { Save } from 'lucide-react';
-
-import { EditorNotice } from './EditorNotice';
-
-function safeNumber(value: number) {
-  return Number.isFinite(value) ? value : 0;
-}
-
-function toNumber(value: string, fallback = 0) {
-  const next = Number(value);
-  return Number.isFinite(next) ? next : fallback;
-}
-
-export type SelectFieldOption = {
-  label: string;
-  value: string | number;
-};
-
-export function TextField({
-  label,
-  value,
-  onChange,
-  placeholder,
-  disabled = false,
-}: {
-  label: string;
-  value: string;
-  onChange: (value: string) => void;
-  placeholder?: string;
-  disabled?: boolean;
-}) {
-  return (
-    <label className="block">
-      <div className="mb-1 text-xs font-medium text-zinc-300">{label}</div>
-      <input
-        value={value}
-        onChange={(event) => onChange(event.target.value)}
-        placeholder={placeholder}
-        disabled={disabled}
-        className="w-full rounded-lg border border-white/10 bg-black/30 px-3 py-2 text-sm text-white outline-none transition focus:border-emerald-400/40 disabled:cursor-not-allowed disabled:opacity-60"
-      />
-    </label>
-  );
-}
-
-export function NumberField({
-  label,
-  value,
-  onChange,
-  min,
-  step = 1,
-}: {
-  label: string;
-  value: number;
-  onChange: (value: number) => void;
-  min?: number;
-  step?: number;
-}) {
-  return (
-    <label className="block">
-      <div className="mb-1 text-xs font-medium text-zinc-300">{label}</div>
-      <input
-        type="number"
-        value={safeNumber(value)}
-        min={min}
-        step={step}
-        onChange={(event) => onChange(toNumber(event.target.value, value))}
-        className="w-full rounded-lg border border-white/10 bg-black/30 px-3 py-2 text-sm text-white outline-none transition focus:border-emerald-400/40"
-      />
-    </label>
-  );
-}
-
-export function TextAreaField({
-  label,
-  value,
-  onChange,
-  rows = 4,
-  placeholder,
-  disabled = false,
-}: {
-  label: string;
-  value: string;
-  onChange: (value: string) => void;
-  rows?: number;
-  placeholder?: string;
-  disabled?: boolean;
-}) {
-  return (
-    <label className="block">
-      <div className="mb-1 text-xs font-medium text-zinc-300">{label}</div>
-      <textarea
-        rows={rows}
-        value={value}
-        onChange={(event) => onChange(event.target.value)}
-        placeholder={placeholder}
-        disabled={disabled}
-        className="w-full rounded-lg border border-white/10 bg-black/30 px-3 py-2 text-sm leading-relaxed text-white outline-none transition focus:border-emerald-400/40 disabled:cursor-not-allowed disabled:opacity-60"
-      />
-    </label>
-  );
-}
-
-export function SelectField({
-  label,
-  value,
-  onChange,
-  options,
-  disabled = false,
-}: {
-  label: string;
-  value: string | number;
-  onChange: (value: string) => void;
-  options: SelectFieldOption[];
-  disabled?: boolean;
-}) {
-  return (
-    <label className="block">
-      <div className="mb-1 text-xs font-medium text-zinc-300">{label}</div>
-      <select
-        value={String(value)}
-        onChange={(event) => onChange(event.target.value)}
-        disabled={disabled}
-        className="w-full rounded-lg border border-white/10 bg-black/30 px-3 py-2 text-sm text-white outline-none transition focus:border-emerald-400/40 disabled:cursor-not-allowed disabled:opacity-60"
-      >
-        {options.map((option) => (
-          <option key={`${label}-${option.value}`} value={String(option.value)}>
-            {option.label}
-          </option>
-        ))}
-      </select>
-    </label>
-  );
-}
-
-export function SaveBar({
-  saveLabel,
-  onSave,
-  isSaving,
-  saveMessage,
-}: {
-  saveLabel: string;
-  onSave: () => void;
-  isSaving: boolean;
-  saveMessage: string | null;
-}) {
-  return (
-    <div className="mt-5 flex flex-wrap items-center gap-3">
-      <button
-        type="button"
-        onClick={onSave}
-        disabled={isSaving}
-        className="inline-flex items-center gap-2 rounded-lg bg-emerald-500 px-4 py-2 text-sm font-medium text-black transition hover:bg-emerald-400 disabled:cursor-not-allowed disabled:opacity-60"
-      >
-        <Save className="h-4 w-4" />
-        <span>{isSaving ? '保存中...' : saveLabel}</span>
-      </button>
-      <EditorNotice message={saveMessage} />
-    </div>
-  );
-}
diff --git a/src/editor/shared/SectionCard.tsx b/src/editor/shared/SectionCard.tsx
deleted file mode 100644
index 34aec105..00000000
--- a/src/editor/shared/SectionCard.tsx
+++ /dev/null
@@ -1,29 +0,0 @@
-import type { ReactNode } from 'react';
-
-export function SectionCard({
-  title,
-  description,
-  children,
-  className = '',
-}: {
-  title: string;
-  description?: string;
-  children: ReactNode;
-  className?: string;
-}) {
-  return (
-    <section
-      className={`rounded-2xl border border-white/10 bg-black/20 p-5 ${className}`}
-    >
-      <div className="mb-4">
-        <div className="text-sm font-semibold text-white">{title}</div>
-        {description && (
-          <div className="mt-1 text-xs leading-relaxed text-zinc-400">
-            {description}
-          </div>
-        )}
-      </div>
-      {children}
-    </section>
-  );
-}
diff --git a/src/hooks/rpg-runtime-story/npcEncounterActions.test.ts b/src/hooks/rpg-runtime-story/npcEncounterActions.test.ts
index e0676ba6..f328b369 100644
--- a/src/hooks/rpg-runtime-story/npcEncounterActions.test.ts
+++ b/src/hooks/rpg-runtime-story/npcEncounterActions.test.ts
@@ -26,7 +26,7 @@ import {
   type StoryOption,
   WorldType,
 } from '../../types';
-import { createStoryNpcEncounterActions } from './npcEncounterActions';
+import { createStoryNpcEncounterActions } from './useRpgRuntimeNpcInteraction';
 
 function createCharacter(): Character {
   return {
diff --git a/src/hooks/rpg-runtime-story/npcEncounterActions.ts b/src/hooks/rpg-runtime-story/npcEncounterActions.ts
deleted file mode 100644
index f42ce3aa..00000000
--- a/src/hooks/rpg-runtime-story/npcEncounterActions.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-export {
-  createRpgRuntimeNpcEncounterActions as createStoryNpcEncounterActions,
-  useRpgRuntimeNpcInteraction,
-  type RpgRuntimeNpcInteractionResult,
-  type UseRpgRuntimeNpcInteractionParams,
-} from './useRpgRuntimeNpcInteraction';
diff --git a/src/hooks/rpg-runtime-story/openingAdventure.ts b/src/hooks/rpg-runtime-story/openingAdventure.ts
deleted file mode 100644
index a60f482a..00000000
--- a/src/hooks/rpg-runtime-story/openingAdventure.ts
+++ /dev/null
@@ -1,230 +0,0 @@
-import type { Dispatch, SetStateAction } from 'react';
-
-import {
-  hasEncounterEntity,
-  interpolateEncounterTransitionState,
-} from '../../data/encounterTransition';
-import { STORY_OPENING_CAMP_DIALOGUE_FUNCTION } from '../../data/functionCatalog';
-import {
-  CALL_OUT_ENTRY_X_METERS,
-  RESOLVED_ENTITY_X_METERS,
-} from '../../data/sceneEncounterPreviews';
-import { getWorldCampScenePreset } from '../../data/scenePresets';
-import { sortStoryOptionsByPriority } from '../../data/stateFunctions';
-import { generateNextStep } from '../../services/aiService';
-import type { StoryGenerationContext } from '../../services/aiTypes';
-import { createHistoryMoment } from '../../services/storyHistory';
-import type {
-  Character,
-  Encounter,
-  GameState,
-  StoryMoment,
-  StoryOption,
-} from '../../types';
-
-const ENCOUNTER_ENTRY_DURATION_MS = 1800;
-const ENCOUNTER_ENTRY_TICK_MS = 180;
-const OPENING_CAMP_DIALOGUE_FUNCTION_ID =
-  STORY_OPENING_CAMP_DIALOGUE_FUNCTION.id;
-
-export type PreparedOpeningAdventure = {
-  encounterKey: string;
-  actionText: string;
-  resultText: string;
-  fallbackText: string;
-  openingOptions: StoryOption[];
-};
-
-export function buildPreparedOpeningAdventure({
-  state,
-  character,
-  getNpcEncounterKey,
-  appendHistory,
-  buildCampCompanionOpeningOptions,
-  buildCampCompanionOpeningResultText,
-  buildInitialCompanionDialogueText,
-}: {
-  state: GameState;
-  character: Character;
-  getNpcEncounterKey: (encounter: Encounter) => string;
-  appendHistory: (
-    state: GameState,
-    actionText: string,
-    resultText: string,
-  ) => GameState['storyHistory'];
-  buildCampCompanionOpeningOptions: (
-    state: GameState,
-    character: Character,
-    encounter: Encounter,
-  ) => StoryOption[];
-  buildCampCompanionOpeningResultText: (
-    character: Character,
-    encounter: Encounter,
-    worldType: GameState['worldType'],
-  ) => string;
-  buildInitialCompanionDialogueText: (
-    character: Character,
-    encounter: Encounter,
-    worldType: GameState['worldType'],
-  ) => string;
-}): PreparedOpeningAdventure | null {
-  const encounter = state.currentEncounter;
-  if (
-    !encounter ||
-    encounter.kind !== 'npc' ||
-    encounter.specialBehavior !== 'initial_companion'
-  ) {
-    return null;
-  }
-
-  const campScene = state.worldType
-    ? getWorldCampScenePreset(state.worldType)
-    : null;
-  const actionText = '开始冒险';
-  const resultText = buildCampCompanionOpeningResultText(
-    character,
-    encounter,
-    state.worldType,
-  );
-  const dialogueText = buildInitialCompanionDialogueText(
-    character,
-    encounter,
-    state.worldType,
-  );
-  const resolvedEncounter: Encounter = {
-    ...encounter,
-    specialBehavior: 'camp_companion',
-    xMeters: RESOLVED_ENTITY_X_METERS,
-  };
-  const resolvedState: GameState = {
-    ...state,
-    currentScenePreset: campScene ?? state.currentScenePreset,
-    currentEncounter: resolvedEncounter,
-    npcInteractionActive: false,
-  };
-  const nextHistory = appendHistory(state, actionText, resultText);
-  const stateWithHistory: GameState = {
-    ...resolvedState,
-    storyHistory: nextHistory,
-  };
-
-  return {
-    encounterKey: getNpcEncounterKey(encounter),
-    actionText,
-    resultText,
-    fallbackText: dialogueText,
-    openingOptions: buildCampCompanionOpeningOptions(
-      stateWithHistory,
-      character,
-      resolvedEncounter,
-    ),
-  };
-}
-
-export async function playOpeningAdventureSequence({
-  gameState,
-  encounter,
-  preparedStory,
-  setGameState,
-  setCurrentStory,
-  setAiError,
-  setIsLoading,
-}: {
-  gameState: GameState;
-  character: Character;
-  encounter: Encounter;
-  preparedStory: PreparedOpeningAdventure;
-  setGameState: Dispatch<SetStateAction<GameState>>;
-  setCurrentStory: Dispatch<SetStateAction<StoryMoment | null>>;
-  setAiError: Dispatch<SetStateAction<string | null>>;
-  setIsLoading: Dispatch<SetStateAction<boolean>>;
-  buildDialogueStoryMoment: (
-    npcName: string,
-    text: string,
-    options: StoryOption[],
-    streaming?: boolean,
-  ) => StoryMoment;
-  buildStoryContextFromState: (
-    state: GameState,
-    extras?: { lastFunctionId?: string | null },
-  ) => StoryGenerationContext;
-  getStoryGenerationHostileNpcs: (
-    state: GameState,
-  ) => GameState['sceneHostileNpcs'];
-  hasRenderableDialogueTurns: (text: string, npcName: string) => boolean;
-  inferOpeningCampFollowupOptions: (
-    state: GameState,
-    character: Character,
-    baseOptions: StoryOption[],
-    openingBackground: string,
-    openingDialogue: string,
-  ) => Promise<StoryOption[]>;
-  getTypewriterDelay: (char: string) => number;
-}) {
-  const { fallbackText, openingOptions } = preparedStory;
-  const campScene = gameState.worldType
-    ? getWorldCampScenePreset(gameState.worldType)
-    : null;
-  const storyEncounter: Encounter = {
-    ...encounter,
-    xMeters: RESOLVED_ENTITY_X_METERS,
-    specialBehavior: 'camp_companion',
-  };
-  const resolvedState: GameState = {
-    ...gameState,
-    currentScenePreset: campScene ?? gameState.currentScenePreset,
-    currentEncounter: storyEncounter,
-    npcInteractionActive: true,
-  };
-
-  setAiError(null);
-  setIsLoading(false);
-
-  try {
-    setGameState(resolvedState);
-    setCurrentStory({
-      text: fallbackText,
-      options: sortStoryOptionsByPriority(openingOptions),
-      displayMode: 'dialogue',
-      dialogue: [
-        {
-          speaker: 'npc',
-          speakerName: encounter.npcName,
-          text: fallbackText,
-        },
-      ],
-      streaming: false,
-      npcChatState: {
-        npcId: storyEncounter.id ?? storyEncounter.npcName,
-        npcName: storyEncounter.npcName,
-        turnCount: 0,
-        customInputPlaceholder: '输入你想对 TA 说的话',
-      },
-    });
-  } catch (error) {
-    console.error('Failed to play opening adventure sequence:', error);
-    setAiError(error instanceof Error ? error.message : '未知智能生成错误');
-    setGameState(resolvedState);
-    setCurrentStory({
-      text: fallbackText,
-      options: sortStoryOptionsByPriority(openingOptions),
-      displayMode: 'dialogue',
-      dialogue: [
-        {
-          speaker: 'npc',
-          speakerName: encounter.npcName,
-          text: fallbackText,
-        },
-      ],
-      streaming: false,
-      npcChatState: {
-        npcId: storyEncounter.id ?? storyEncounter.npcName,
-        npcName: storyEncounter.npcName,
-        turnCount: 0,
-        customInputPlaceholder: '输入你想对 TA 说的话',
-      },
-    });
-  } finally {
-    setIsLoading(false);
-  }
-}
diff --git a/src/hooks/rpg-runtime-story/storyCampCompanion.test.ts b/src/hooks/rpg-runtime-story/storyCampCompanion.test.ts
deleted file mode 100644
index f133fbb8..00000000
--- a/src/hooks/rpg-runtime-story/storyCampCompanion.test.ts
+++ /dev/null
@@ -1,356 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-
-import { getWorldCampScenePreset } from '../../data/scenePresets';
-import {
-  AnimationState,
-  type Character,
-  type Encounter,
-  type GameState,
-  type StoryMoment,
-  type StoryOption,
-  WorldType,
-} from '../../types';
-import {
-  buildCampCompanionOpeningResultText,
-  buildInitialCompanionDialogueText,
-  createCampCompanionStoryHelpers,
-} from './storyCampCompanion';
-
-function createCharacter(): Character {
-  return {
-    id: 'sword-princess',
-    name: '测试同伴',
-    title: '试剑公主',
-    description: '在营地观察局势的试炼者。',
-    backstory: '她在旅途中始终保留自己的真正目标。',
-    avatar: '/hero.png',
-    portrait: '/hero-portrait.png',
-    assetFolder: 'hero',
-    assetVariant: 'default',
-    attributes: {
-      strength: 12,
-      agility: 10,
-      intelligence: 8,
-      spirit: 9,
-    },
-    personality: '谨慎冷静',
-    skills: [],
-    adventureOpenings: {
-      [WorldType.WUXIA]: {
-        reason: '调查旧路异动',
-        goal: '查清前方局势',
-        monologue: '风声里还藏着未说破的话。',
-        surfaceHook: '我来这里，是为了确认旧路尽头到底出了什么事。',
-        immediateConcern: '眼下的风向不对，我们不能直接把底牌亮出来。',
-        guardedMotive: '我真正要找的东西，还不能让更多人知道。',
-      },
-    },
-  };
-}
-
-function createOption(
-  functionId: string,
-  actionText = functionId,
-  interaction?: StoryOption['interaction'],
-): StoryOption {
-  return {
-    functionId,
-    actionText,
-    text: actionText,
-    interaction,
-    visuals: {
-      playerAnimation: AnimationState.IDLE,
-      playerMoveMeters: 0,
-      playerOffsetY: 0,
-      playerFacing: 'right',
-      scrollWorld: false,
-      monsterChanges: [],
-    },
-  };
-}
-
-function createEncounter(overrides: Partial<Encounter> = {}): Encounter {
-  return {
-    id: 'camp-companion',
-    kind: 'npc',
-    characterId: 'sword-princess',
-    npcName: '沈砺',
-    npcDescription: '正靠在营地灯火旁观察风向。',
-    npcAvatar: '/npc.png',
-    context: '营地夜谈',
-    specialBehavior: 'camp_companion',
-    ...overrides,
-  };
-}
-
-function createStory(text: string, options: StoryOption[] = []): StoryMoment {
-  return {
-    text,
-    options,
-  };
-}
-
-function createGameState(overrides: Partial<GameState> = {}): GameState {
-  return {
-    worldType: WorldType.WUXIA,
-    customWorldProfile: null,
-    playerCharacter: createCharacter(),
-    runtimeStats: {
-      playTimeMs: 0,
-      lastPlayTickAt: null,
-      hostileNpcsDefeated: 0,
-      questsAccepted: 0,
-      itemsUsed: 0,
-      scenesTraveled: 0,
-    },
-    currentScene: 'Story',
-    storyHistory: [],
-    characterChats: {},
-    animationState: AnimationState.IDLE,
-    currentEncounter: null,
-    npcInteractionActive: false,
-    currentScenePreset: getWorldCampScenePreset(WorldType.WUXIA),
-    sceneHostileNpcs: [],
-    playerX: 0,
-    playerOffsetY: 0,
-    playerFacing: 'right',
-    playerActionMode: 'idle',
-    scrollWorld: false,
-    inBattle: false,
-    playerHp: 100,
-    playerMaxHp: 100,
-    playerMana: 30,
-    playerMaxMana: 30,
-    playerSkillCooldowns: {},
-    activeCombatEffects: [],
-    playerCurrency: 0,
-    playerInventory: [],
-    playerEquipment: {
-      weapon: null,
-      armor: null,
-      relic: null,
-    },
-    npcStates: {},
-    quests: [],
-    roster: [],
-    companions: [],
-    currentBattleNpcId: null,
-    currentNpcBattleMode: null,
-    currentNpcBattleOutcome: null,
-    sparReturnEncounter: null,
-    sparPlayerHpBefore: null,
-    sparPlayerMaxHpBefore: null,
-    sparStoryHistoryBefore: null,
-    ...overrides,
-  } as GameState;
-}
-
-describe('storyCampCompanion', () => {
-  it('builds opening dialogue from the character adventure opening', () => {
-    const text = buildInitialCompanionDialogueText(
-      createCharacter(),
-      createEncounter(),
-      WorldType.WUXIA,
-    );
-
-    expect(text).toContain('先和你打个招呼。');
-    expect(text).toContain('我来这里，是为了确认旧路尽头到底出了什么事。');
-    expect(text).toContain('眼下的风向不对，我们不能直接把底牌亮出来。');
-    expect(text).toContain('我真正要找的东西，还不能让更多人知道。');
-    expect(text).not.toContain('像是在等你把话接下去');
-  });
-
-  it('summarizes the camp opening result with the current concern', () => {
-    const text = buildCampCompanionOpeningResultText(
-      createCharacter(),
-      createEncounter(),
-      WorldType.WUXIA,
-    );
-
-    expect(text).toContain('沈砺 在');
-    expect(text).toContain('眼下的风向不对');
-  });
-
-  it('keeps the opening camp options focused on继续交谈', () => {
-    const buildNpcStory = vi.fn(() =>
-      createStory('营地开场', [
-        createOption('npc_chat', '继续交谈'),
-        createOption('npc_recruit', '邀请同行'),
-        createOption('npc_trade', '查看货物'),
-      ]),
-    );
-    const helpers = createCampCompanionStoryHelpers({
-      buildNpcStory,
-      buildStoryContextFromState: vi.fn(),
-      getStoryGenerationHostileNpcs: vi.fn(() => []),
-      getNpcEncounterKey: vi.fn(() => 'camp-companion'),
-      generateNextStep: vi.fn(),
-    });
-
-    const options = helpers.buildCampCompanionOpeningOptions(
-      createGameState(),
-      createCharacter(),
-      createEncounter(),
-    );
-
-    expect(options.map((option) => option.functionId)).toEqual(['npc_chat']);
-  });
-
-  it('uses AI follow-up options when the camp follow-up request succeeds and falls back on errors', async () => {
-    const baseOptions = [
-      createOption('npc_chat', '继续交谈', {
-        kind: 'npc',
-        npcId: 'camp-companion',
-        action: 'chat',
-      }),
-      createOption('camp_travel_home_scene', '前往旧地点'),
-    ];
-    const generateNextStep = vi
-      .fn()
-      .mockResolvedValueOnce({
-        storyText: '继续营地交谈',
-        options: [
-          createOption('npc_chat', '顺着刚才的话继续问下去'),
-          createOption('camp_travel_home_scene', '先回云河渡'),
-        ],
-      })
-      .mockRejectedValueOnce(new Error('llm failed'));
-    const buildStoryContextFromState = vi.fn(() => ({
-      playerHp: 100,
-      playerMaxHp: 100,
-      playerMana: 30,
-      playerMaxMana: 30,
-      inBattle: false,
-      playerX: 0,
-      playerFacing: 'right' as const,
-      playerAnimation: AnimationState.IDLE,
-      skillCooldowns: {},
-      sceneId: 'camp',
-      sceneName: '营地',
-      sceneDescription: '营火微亮。',
-      pendingSceneEncounter: false,
-    }));
-    const helpers = createCampCompanionStoryHelpers({
-      buildNpcStory: vi.fn(),
-      buildStoryContextFromState,
-      getStoryGenerationHostileNpcs: vi.fn(() => []),
-      getNpcEncounterKey: vi.fn(() => 'camp-companion'),
-      generateNextStep,
-    });
-    const state = createGameState();
-    const character = createCharacter();
-    const consoleErrorSpy = vi
-      .spyOn(console, 'error')
-      .mockImplementation(() => undefined);
-
-    try {
-      const resolvedOptions = await helpers.inferOpeningCampFollowupOptions(
-        state,
-        character,
-        baseOptions,
-        '营地里风声微沉。',
-        '你们刚交换完第一轮判断。',
-      );
-      const fallbackOptions = await helpers.inferOpeningCampFollowupOptions(
-        state,
-        character,
-        baseOptions,
-        '营地里风声微沉。',
-        '你们刚交换完第一轮判断。',
-      );
-
-      expect(buildStoryContextFromState).toHaveBeenCalledWith(
-        state,
-        expect.objectContaining({
-          openingCampBackground: '营地里风声微沉。',
-          openingCampDialogue: '你们刚交换完第一轮判断。',
-        }),
-      );
-      expect(resolvedOptions).toEqual([
-        expect.objectContaining({
-          functionId: 'npc_chat',
-          actionText: '顺着刚才的话继续问下去',
-          interaction: {
-            kind: 'npc',
-            npcId: 'camp-companion',
-            action: 'chat',
-          },
-        }),
-        expect.objectContaining({
-          functionId: 'camp_travel_home_scene',
-          actionText: '先回云河渡',
-        }),
-      ]);
-      expect(fallbackOptions).toBe(baseOptions);
-    } finally {
-      consoleErrorSpy.mockRestore();
-    }
-  });
-
-  it('reconstructs the opening camp chat context from story history and filters idle camp options', () => {
-    const encounter = createEncounter();
-    const buildNpcStory = vi.fn(() =>
-      createStory('营地常态', [
-        createOption('npc_chat', '继续交谈'),
-        createOption('npc_leave', '结束对话'),
-        createOption('npc_fight', '直接切磋'),
-        createOption('npc_trade', '查看货物'),
-      ]),
-    );
-    const helpers = createCampCompanionStoryHelpers({
-      buildNpcStory,
-      buildStoryContextFromState: vi.fn(),
-      getStoryGenerationHostileNpcs: vi.fn(() => []),
-      getNpcEncounterKey: vi.fn(() => 'camp-companion'),
-      generateNextStep: vi.fn(),
-    });
-    const state = createGameState({
-      currentEncounter: encounter,
-      npcStates: {
-        'camp-companion': {
-          affinity: 16,
-          helpUsed: false,
-          chattedCount: 1,
-          giftsGiven: 0,
-          inventory: [],
-          recruited: false,
-        },
-      },
-      storyHistory: [
-        {
-          text: `在营地与 ${encounter.npcName} 交换开场判断`,
-          options: [],
-          historyRole: 'action',
-        },
-        {
-          text: '你们先对了一遍眼前局势。',
-          options: [],
-          historyRole: 'result',
-        },
-      ],
-    });
-
-    const chatContext = helpers.buildOpeningCampChatContext(
-      state,
-      createCharacter(),
-      encounter,
-    );
-    const idleStory = helpers.buildCampCompanionIdleStory(
-      state,
-      createCharacter(),
-      encounter,
-    );
-
-    expect(chatContext).toEqual(
-      expect.objectContaining({
-        openingCampBackground: expect.stringContaining('沈砺 在'),
-        openingCampDialogue: '你们先对了一遍眼前局势。',
-      }),
-    );
-    expect(idleStory.options.map((option) => option.functionId)).toEqual([
-      'npc_chat',
-      'npc_trade',
-      'camp_travel_home_scene',
-    ]);
-  });
-});
diff --git a/src/hooks/rpg-runtime-story/storyCampCompanion.ts b/src/hooks/rpg-runtime-story/storyCampCompanion.ts
deleted file mode 100644
index c6713fc9..00000000
--- a/src/hooks/rpg-runtime-story/storyCampCompanion.ts
+++ /dev/null
@@ -1,293 +0,0 @@
-import {
-  getCharacterAdventureOpening,
-  getCharacterHomeSceneId,
-} from '../../data/characterPresets';
-import {
-  buildCampTravelHomeOption,
-  NPC_CHAT_FUNCTION,
-  NPC_FIGHT_FUNCTION,
-  NPC_LEAVE_FUNCTION,
-} from '../../data/functionCatalog';
-import {
-  buildInitialNpcState,
-  buildNpcChatOpeningText,
-} from '../../data/npcInteractions';
-import {
-  getForwardScenePreset,
-  getScenePresetById,
-  getTravelScenePreset,
-  getWorldCampScenePreset,
-} from '../../data/scenePresets';
-import { sortStoryOptionsByPriority } from '../../data/stateFunctions';
-import type { StoryGenerationContext } from '../../services/aiService';
-import type {
-  Character,
-  Encounter,
-  GameState,
-  StoryMoment,
-  StoryOption,
-  WorldType,
-} from '../../types';
-import { resolveStoryResponseOptions } from './storyResponseOptions';
-
-type BuildNpcStory = (
-  state: GameState,
-  character: Character,
-  encounter: Encounter,
-  overrideText?: string,
-) => StoryMoment;
-
-type BuildStoryContextFromState = (
-  state: GameState,
-  extras?: {
-    openingCampBackground?: string | null;
-    openingCampDialogue?: string | null;
-  },
-) => StoryGenerationContext;
-
-type GetStoryGenerationHostileNpcs = (
-  state: GameState,
-) => GameState['sceneHostileNpcs'];
-
-type GetNpcEncounterKey = (encounter: Encounter) => string;
-
-type GenerateNextStep =
-  (typeof import('../../services/aiService'))['generateNextStep'];
-
-export function buildInitialCompanionDialogueText(
-  character: Character,
-  encounter: Encounter,
-  worldType: WorldType | null,
-) {
-  const resolvedEncounter =
-    encounter.characterId === character.id
-      ? encounter
-      : {
-          ...encounter,
-          characterId: encounter.characterId ?? character.id,
-        };
-  const initialNpcState = buildInitialNpcState(resolvedEncounter, worldType);
-  return buildNpcChatOpeningText(
-    resolvedEncounter,
-    initialNpcState,
-    worldType,
-    character,
-  );
-}
-
-export function buildCampCompanionOpeningResultText(
-  character: Character,
-  encounter: Encounter,
-  worldType: WorldType | null,
-) {
-  const opening = getCharacterAdventureOpening(character, worldType);
-  const campSceneName = worldType
-    ? (getWorldCampScenePreset(worldType)?.name ?? '归处')
-    : '归处';
-  if (!opening) {
-    return `${encounter.npcName} 已经来到你身边。在${campSceneName}，你稍作停顿，决定下一步去向何方。`;
-  }
-
-  return `${encounter.npcName} 在${campSceneName}来到你身边。你们首先就“${opening.immediateConcern ?? '前方不稳定的道路'}”交换了意见，而双方都暂时保留了部分真相。`;
-}
-
-function getCampCompanionHomeScene(state: GameState, character: Character) {
-  if (!state.worldType) return null;
-  const sceneId = getCharacterHomeSceneId(state.worldType, character.id);
-  return getScenePresetById(state.worldType, sceneId);
-}
-
-export function createCampCompanionStoryHelpers(params: {
-  buildNpcStory: BuildNpcStory;
-  buildStoryContextFromState: BuildStoryContextFromState;
-  getStoryGenerationHostileNpcs: GetStoryGenerationHostileNpcs;
-  getNpcEncounterKey: GetNpcEncounterKey;
-  generateNextStep: GenerateNextStep;
-}) {
-  const getCampCompanionTravelScene = (
-    state: GameState,
-    character: Character,
-  ) => {
-    if (!state.worldType) return null;
-
-    const campScene = getWorldCampScenePreset(state.worldType);
-    const homeScene = getCampCompanionHomeScene(state, character);
-    if (
-      homeScene &&
-      homeScene.id !== campScene?.id &&
-      homeScene.id !== state.currentScenePreset?.id
-    ) {
-      return homeScene;
-    }
-
-    const fallbackSceneId =
-      campScene?.id ?? state.currentScenePreset?.id ?? null;
-    return (
-      getForwardScenePreset(state.worldType, fallbackSceneId) ??
-      getTravelScenePreset(state.worldType, fallbackSceneId) ??
-      homeScene
-    );
-  };
-
-  const buildCampCompanionOpeningOptions = (
-    state: GameState,
-    character: Character,
-    encounter: Encounter,
-  ) => {
-    const baseOptions = params.buildNpcStory(
-      state,
-      character,
-      encounter,
-    ).options;
-    return baseOptions
-      .filter((option) => option.functionId === NPC_CHAT_FUNCTION.id)
-      .slice(0, 3);
-  };
-
-  const inferOpeningCampFollowupOptions = async (
-    state: GameState,
-    character: Character,
-    baseOptions: StoryOption[],
-    openingBackground: string,
-    openingDialogue: string,
-  ) => {
-    if (!state.worldType || baseOptions.length === 0) {
-      return baseOptions;
-    }
-
-    try {
-      const response = await params.generateNextStep(
-        state.worldType,
-        character,
-        params.getStoryGenerationHostileNpcs(state),
-        state.storyHistory,
-        '继续承接营地中的这段交谈，并整理出眼下最自然的后续行动。',
-        params.buildStoryContextFromState(state, {
-          openingCampBackground: openingBackground,
-          openingCampDialogue: openingDialogue,
-        }),
-        {
-          availableOptions: baseOptions,
-        },
-      );
-
-      return resolveStoryResponseOptions({
-        responseOptions: response.options,
-        availableOptions: baseOptions,
-        getSanitizedOptions: () => sortStoryOptionsByPriority(baseOptions),
-      });
-    } catch (error) {
-      console.error('Failed to infer opening camp follow-up options:', error);
-      return baseOptions;
-    }
-  };
-
-  const buildOpeningCampChatContext = (
-    state: GameState,
-    character: Character,
-    encounter: Encounter,
-  ) => {
-    if (encounter.specialBehavior !== 'camp_companion') {
-      return {};
-    }
-
-    const npcState =
-      state.npcStates[params.getNpcEncounterKey(encounter)] ??
-      buildInitialNpcState(encounter, state.worldType, state);
-    if (npcState.chattedCount > 2) {
-      return {};
-    }
-
-    const openingActionText = `在营地与 ${encounter.npcName} 交换开场判断`;
-    let openingDialogue: string | null = null;
-
-    for (let index = 0; index < state.storyHistory.length - 1; index += 1) {
-      const entry = state.storyHistory[index];
-      if (!entry) {
-        continue;
-      }
-      if (entry.historyRole !== 'action' || entry.text !== openingActionText) {
-        continue;
-      }
-
-      for (
-        let nextIndex = index + 1;
-        nextIndex < state.storyHistory.length;
-        nextIndex += 1
-      ) {
-        const nextEntry = state.storyHistory[nextIndex];
-        if (!nextEntry) {
-          continue;
-        }
-        if (nextEntry.historyRole === 'action') {
-          break;
-        }
-        if (nextEntry.text.trim()) {
-          openingDialogue = nextEntry.text;
-          break;
-        }
-      }
-
-      if (openingDialogue) {
-        break;
-      }
-    }
-
-    if (!openingDialogue) {
-      return {};
-    }
-
-    return {
-      openingCampBackground: buildCampCompanionOpeningResultText(
-        character,
-        encounter,
-        state.worldType,
-      ),
-      openingCampDialogue: openingDialogue,
-    };
-  };
-
-  const buildCampCompanionIdleStory = (
-    state: GameState,
-    character: Character,
-    encounter: Encounter,
-    overrideText?: string,
-  ): StoryMoment => {
-    const targetScene = getCampCompanionTravelScene(state, character);
-    const baseStory = params.buildNpcStory(
-      state,
-      character,
-      encounter,
-      overrideText,
-    );
-    const filteredOptions = baseStory.options.filter(
-      (option) =>
-        option.functionId !== NPC_LEAVE_FUNCTION.id &&
-        option.functionId !== NPC_FIGHT_FUNCTION.id,
-    );
-
-    if (!targetScene) {
-      return {
-        ...baseStory,
-        options: filteredOptions,
-      };
-    }
-
-    return {
-      ...baseStory,
-      options: [
-        ...filteredOptions.slice(0, 2),
-        buildCampTravelHomeOption(targetScene.name),
-        ...filteredOptions.slice(2),
-      ],
-    };
-  };
-
-  return {
-    getCampCompanionTravelScene,
-    buildCampCompanionOpeningOptions,
-    inferOpeningCampFollowupOptions,
-    buildOpeningCampChatContext,
-    buildCampCompanionIdleStory,
-  };
-}
diff --git a/src/hooks/rpg-runtime-story/storyRenderingHelpers.ts b/src/hooks/rpg-runtime-story/storyRenderingHelpers.ts
deleted file mode 100644
index df66c321..00000000
--- a/src/hooks/rpg-runtime-story/storyRenderingHelpers.ts
+++ /dev/null
@@ -1,241 +0,0 @@
-import type {
-  Character,
-  GameState,
-  StoryDialogueTurn,
-  StoryMoment,
-  StoryOption,
-} from '../../types';
-import {
-  buildFallbackStoryMoment,
-  normalizeSkillProbabilities,
-} from '../combatStoryUtils';
-
-const MIN_OPTION_POOL_SIZE = 6;
-
-export function dedupeStoryOptions(options: StoryOption[]) {
-  const seen = new Set<string>();
-
-  return options.filter((option) => {
-    const identity = `${option.functionId}::${option.actionText}::${option.text}`;
-    if (seen.has(identity)) return false;
-    seen.add(identity);
-    return true;
-  });
-}
-
-export function buildLocalCharacterChatSummary(
-  character: Character,
-  history: Array<{ speaker: 'player' | 'character'; text: string }>,
-  previousSummary: string,
-) {
-  const latestTurns = history
-    .slice(-4)
-    .map(
-      (turn) =>
-        `${turn.speaker === 'player' ? '玩家' : character.name}：${turn.text}`,
-    )
-    .join(' ');
-
-  const currentSummary = latestTurns
-    ? `${character.name}在私下交谈里变得更愿意坦率回应。最近交流：${latestTurns}`
-    : `${character.name}愿意继续私下交谈，对玩家的信任也在慢慢加深。`;
-  if (!previousSummary) {
-    return currentSummary.slice(0, 118);
-  }
-
-  return `${previousSummary} ${currentSummary}`.slice(0, 118);
-}
-
-export function buildLocalCharacterChatSuggestions(character: Character) {
-  return [
-    '我想听你把这件事再说得更明白一点。',
-    `${character.name}，你现在真正担心的是什么？`,
-    '先把外面的局势放一放，我想更了解你一些。',
-  ];
-}
-
-export function sanitizeOptions(
-  options: StoryOption[],
-  character: Character,
-  state: GameState,
-) {
-  const normalizedOptions = dedupeStoryOptions(
-    options.map((option) => normalizeSkillProbabilities(option, character)),
-  );
-
-  if (normalizedOptions.length === 0) {
-    return buildFallbackStoryMoment(state, character).options;
-  }
-
-  if (normalizedOptions.length >= MIN_OPTION_POOL_SIZE) {
-    return normalizedOptions;
-  }
-
-  return dedupeStoryOptions([
-    ...normalizedOptions,
-    ...buildFallbackStoryMoment(state, character).options,
-  ]).slice(0, MIN_OPTION_POOL_SIZE);
-}
-
-function escapeRegExp(value: string) {
-  const specialChars = [
-    '\\',
-    '^',
-    '$',
-    '*',
-    '+',
-    '?',
-    '.',
-    '(',
-    ')',
-    '|',
-    '[',
-    ']',
-    '{',
-    '}',
-  ];
-  return specialChars.reduce(
-    (escaped, char) => escaped.split(char).join('\\' + char),
-    value,
-  );
-}
-
-function normalizeDialogueSpeakerName(rawSpeakerName: string) {
-  return rawSpeakerName
-    .trim()
-    .replace(
-      /^[[\]{}()<>\u300a\u300b\u300c\u300d\u300e\u300f\u3010\u3011\uFF08\uFF09]+/u,
-      '',
-    )
-    .replace(
-      /[[\]{}()<>\u300a\u300b\u300c\u300d\u300e\u300f\u3010\u3011\uFF08\uFF09]+$/u,
-      '',
-    )
-    .replace(/^(?:\u540c\u4f34|\u961f\u53cb)\s*/u, '')
-    .trim();
-}
-
-function parseDialogueTurns(
-  text: string,
-  npcName: string,
-): StoryDialogueTurn[] {
-  const turns: StoryDialogueTurn[] = [];
-  const dialogueColonPattern = '(?:\\uFF1A|:)';
-  const playerPrefixPattern = new RegExp(
-    '^(?:\\\\u4f60|\\\\u73a9\\\\u5bb6|\\\\u4e3b\\\\u89d2)\\\\s*' +
-      dialogueColonPattern +
-      '\\\\s*(.+)$',
-    'u',
-  );
-  const npcPrefixPattern = new RegExp(
-    '^' +
-      escapeRegExp(npcName) +
-      '\\\\s*' +
-      dialogueColonPattern +
-      '\\\\s*(.+)$',
-    'u',
-  );
-  const namedSpeakerPattern = new RegExp(
-    '^(.{1,24}?)\\\\s*' + dialogueColonPattern + '\\\\s*(.+)$',
-    'u',
-  );
-  const lines = text
-    .replace(/\r/g, '')
-    .split('\n')
-    .map((line) => line.trim())
-    .filter(Boolean);
-
-  for (const line of lines) {
-    const playerMatch = line.match(playerPrefixPattern);
-    const playerText = playerMatch?.[1]?.trim();
-    if (playerText) {
-      turns.push({ speaker: 'player', text: playerText });
-      continue;
-    }
-
-    const npcMatch = line.match(npcPrefixPattern);
-    const npcText = npcMatch?.[1]?.trim();
-    if (npcText) {
-      turns.push({ speaker: 'npc', speakerName: npcName, text: npcText });
-      continue;
-    }
-
-    const namedSpeakerMatch = line.match(namedSpeakerPattern);
-    if (namedSpeakerMatch) {
-      const rawSpeakerName = namedSpeakerMatch[1];
-      const rawSpeakerText = namedSpeakerMatch[2];
-      if (!rawSpeakerName || !rawSpeakerText) {
-        continue;
-      }
-
-      const speakerName = normalizeDialogueSpeakerName(rawSpeakerName);
-      const speakerText = rawSpeakerText.trim();
-
-      if (speakerName && speakerText) {
-        turns.push({
-          speaker: speakerName === npcName ? 'npc' : 'companion',
-          speakerName,
-          text: speakerText,
-        });
-        continue;
-      }
-    }
-
-    if (line.startsWith('你:') || line.startsWith('你：')) {
-      turns.push({ speaker: 'player', text: line.slice(2).trim() });
-      continue;
-    }
-
-    if (line.startsWith(npcName + ':') || line.startsWith(npcName + '：')) {
-      turns.push({
-        speaker: 'npc',
-        text: line.slice(npcName.length + 1).trim(),
-      });
-      continue;
-    }
-
-    if (line.startsWith('主角:') || line.startsWith('主角：')) {
-      turns.push({ speaker: 'player', text: line.slice(3).trim() });
-      continue;
-    }
-
-    if (turns.length > 0) {
-      const lastTurnIndex = turns.length - 1;
-      const lastTurn = turns[lastTurnIndex];
-      if (lastTurn) {
-        turns[lastTurnIndex] = {
-          ...lastTurn,
-          text: lastTurn.text + line,
-        };
-      }
-    }
-  }
-
-  return turns.filter((turn) => turn.text.length > 0);
-}
-
-export function buildDialogueStoryMoment(
-  npcName: string,
-  text: string,
-  options: StoryOption[],
-  streaming = false,
-): StoryMoment {
-  return {
-    text,
-    options,
-    displayMode: 'dialogue',
-    dialogue: parseDialogueTurns(text, npcName),
-    streaming,
-  };
-}
-
-export function hasRenderableDialogueTurns(text: string, npcName: string) {
-  return parseDialogueTurns(text, npcName).length >= 2;
-}
-
-export function getTypewriterDelay(char: string) {
-  if (/[。！？!?]/u.test(char)) return 240;
-  if (/[，、；;:]/u.test(char)) return 150;
-  if (/\s/u.test(char)) return 45;
-  return 90;
-}
diff --git a/src/prompts/questPrompts.ts b/src/prompts/questPrompts.ts
deleted file mode 100644
index 9b6ac75d..00000000
--- a/src/prompts/questPrompts.ts
+++ /dev/null
@@ -1,175 +0,0 @@
-import type {QuestGenerationContext} from '../services/aiTypes';
-import type {QuestOpportunity, QuestSceneSnapshot} from '../services/questTypes';
-import { buildQuestVisibilitySlice } from '../services/storyEngine/visibilityEngine';
-
-function describeWorld(worldType: QuestGenerationContext['worldType']) {
-  switch (worldType) {
-    case 'WUXIA':
-      return '边城模板';
-    case 'XIANXIA':
-      return '灵潮模板';
-    case 'CUSTOM':
-      return '自定义世界';
-    default:
-      return '未知世界';
-  }
-}
-
-function summarizeRecentStoryMoments(context: QuestGenerationContext) {
-  const moments = context.recentStoryMoments
-    .slice(-4)
-    .map(moment => `- ${moment.text}`)
-    .join('\n');
-
-  return moments || '- 暂无近期剧情记录';
-}
-
-function summarizeCurrentQuests(context: QuestGenerationContext) {
-  const summary = context.currentQuestSummary?.map(quest =>
-    `- ${quest.title}（${quest.status}），发布者 ${quest.issuerNpcId}`,
-  ).join('\n');
-
-  return summary || '- 当前没有进行中的任务';
-}
-
-function summarizeCompanions(context: QuestGenerationContext) {
-  const active = context.activeCompanions?.map(companion => companion.characterId).join('、') || '无';
-  const roster = context.rosterCompanions?.map(companion => companion.characterId).join('、') || '无';
-  return `当前同行角色：${active}\n队伍名册：${roster}`;
-}
-
-function summarizePlayerState(context: QuestGenerationContext) {
-  const playerName = context.playerCharacter?.name ?? '未知角色';
-  const playerTitle = context.playerCharacter?.title ?? '未知称号';
-  const hp = `${context.playerHp ?? 0}/${context.playerMaxHp ?? 0}`;
-  const mana = `${context.playerMana ?? 0}/${context.playerMaxMana ?? 0}`;
-  const inventory = context.playerInventory?.slice(0, 8).map(item => item.name).join('、') || '无';
-
-  return [
-    `玩家：${playerName}（${playerTitle}）`,
-    `生命：${hp}`,
-    `灵力：${mana}`,
-    `背包快照：${inventory}`,
-  ].join('\n');
-}
-
-function summarizeScene(scene: QuestSceneSnapshot | null, context: QuestGenerationContext) {
-  const hostileNpcIds = context.currentSceneHostileNpcIds?.join('、') || '无';
-  const treasureHintCount = context.currentSceneTreasureHintCount ?? 0;
-
-  return [
-    `场景：${scene?.name ?? context.currentSceneName ?? '未知区域'}`,
-    `场景描述：${scene?.description ?? context.currentSceneDescription ?? '暂无'}`,
-    `敌对角色 ID：${hostileNpcIds}`,
-    `宝藏线索数量：${treasureHintCount}`,
-  ].join('\n');
-}
-
-function summarizeActiveThreads(context: QuestGenerationContext) {
-  if (!context.activeThreadIds?.length) {
-    return '暂无明确激活线程';
-  }
-
-  const storyGraph = context.customWorldProfile?.storyGraph;
-  const labels = context.activeThreadIds.map((threadId) =>
-    [...(storyGraph?.visibleThreads ?? []), ...(storyGraph?.hiddenThreads ?? [])]
-      .find((thread) => thread.id === threadId)?.title ?? threadId,
-  );
-
-  return labels.join('、');
-}
-
-function summarizeIssuerNarrativeProfile(context: QuestGenerationContext) {
-  const profile = context.issuerNarrativeProfile;
-  if (!profile) {
-    return '暂无额外叙事档案';
-  }
-
-  return [
-    `公开面：${profile.publicMask}`,
-    `表层线：${profile.visibleLine}`,
-    `当前压力：${profile.immediatePressure}`,
-    profile.reactionHooks.length > 0
-      ? `反应钩子：${profile.reactionHooks.join('、')}`
-      : null,
-  ]
-    .filter(Boolean)
-    .join('\n');
-}
-
-function summarizeQuestVisibility(context: QuestGenerationContext) {
-  const slice = buildQuestVisibilitySlice({
-    issuerNarrativeProfile: context.issuerNarrativeProfile,
-    activeThreadIds: context.activeThreadIds,
-  });
-
-  return [
-    `可直接披露：${slice.sayableFactIds.join('、') || '无'}`,
-    `只宜写成推测：${slice.inferredFactIds.join('、') || '无'}`,
-    `禁止直接说破：${slice.forbiddenFactIds.join('、') || '无'}`,
-  ].join('\n');
-}
-
-export const QUEST_INTENT_SYSTEM_PROMPT = `你是 AI 原生叙事 RPG 的任务导演。
-只返回 JSON，不要输出 Markdown。
-
-输出结构：
-{
-  "intent": {
-    "title": "中文任务标题",
-    "description": "中文任务描述",
-    "summary": "中文短摘要",
-    "narrativeType": "bounty|escort|investigation|retrieval|relationship|trial",
-    "dramaticNeed": "string",
-    "issuerGoal": "string",
-    "playerHook": "string",
-    "worldReason": "string",
-    "recommendedObjectiveKinds": ["defeat_hostile_npc" | "inspect_treasure" | "spar_with_npc" | "talk_to_npc" | "reach_scene" | "deliver_item"],
-    "urgency": "low|medium|high",
-    "intimacy": "transactional|cooperative|trust_based",
-    "rewardTheme": "currency|resource|relationship|intel|rare_item",
-    "followupHooks": ["string"]
-  }
-}
-
-规则：
-- 所有自然语言字段都必须使用中文。
-- 任务必须扎根于当前场景、发布者和近期剧情。
-- 不要编造奖励、ID、数量、状态或不受支持的规则变化。
-- recommendedObjectiveKinds 只是语义建议，不是硬编码结果。
-- 优先给出简洁、可玩的任务框架，不要堆砌华丽辞藻。
-- title 必须是 4 到 10 个中文字符左右的短任务名，不要写成长句。
-- description 解释任务为什么在当前剧情里成立，避免纯规则说明。
-- summary 必须是清晰达成条件，优先使用“击败 / 调查 / 返回 / 前往 / 交付 / 切磋”等明确动词，不要写“处理一下”“看看情况”这类模糊表达。`;
-
-export function buildQuestIntentPrompt(params: {
-  context: QuestGenerationContext;
-  scene: QuestSceneSnapshot | null;
-  opportunity: QuestOpportunity;
-}) {
-  const {context, scene, opportunity} = params;
-  const customWorldSummary = context.customWorldProfile
-    ? `${context.customWorldProfile.name}: ${context.customWorldProfile.summary}`
-    : '无';
-
-  return [
-    `世界：${describeWorld(context.worldType)}`,
-    `自定义世界摘要：${customWorldSummary}`,
-    `发布角色：${context.issuerNpcName ?? '未知'}（${context.issuerNpcId ?? '未知'}）`,
-    `发布者身份：${context.issuerNpcContext ?? '暂无'}`,
-    `发布者好感：${context.issuerAffinity ?? 0}`,
-    `发布者信息揭示阶段：${context.issuerDisclosureStage ?? '未知'}`,
-    `发布者亲疏阶段：${context.issuerWarmthStage ?? '未知'}`,
-    `当前激活线程：${summarizeActiveThreads(context)}`,
-    `发布者叙事档案：\n${summarizeIssuerNarrativeProfile(context)}`,
-    `任务可见性切片：\n${summarizeQuestVisibility(context)}`,
-    `当前遭遇类型：${context.encounterKind ?? '无'}`,
-    summarizeScene(scene, context),
-    summarizePlayerState(context),
-    summarizeCompanions(context),
-    `当前任务机会：${opportunity.reason}`,
-    `当前任务列表：\n${summarizeCurrentQuests(context)}`,
-    `近期剧情片段：\n${summarizeRecentStoryMoments(context)}`,
-    '现在请基于这次具体局势，生成一个自然生长出来的任务意图。',
-  ].join('\n\n');
-}
diff --git a/src/prompts/runtimeItemPrompts.ts b/src/prompts/runtimeItemPrompts.ts
deleted file mode 100644
index feff073a..00000000
--- a/src/prompts/runtimeItemPrompts.ts
+++ /dev/null
@@ -1,119 +0,0 @@
-import {
-  buildRuntimeItemAiIntent,
-  buildRuntimeItemAiPromptInput,
-} from '../data/runtimeItemNarrative';
-import type {
-  RuntimeItemGenerationContext,
-  RuntimeItemPlan,
-  RuntimeRelationAnchor,
-} from '../types';
-import { buildRuntimeItemStoryFingerprint } from '../services/storyEngine/carrierNarrativeCompiler';
-import { buildCarrierVisibilitySlice } from '../services/storyEngine/visibilityEngine';
-
-function describeRelationAnchor(anchor: RuntimeRelationAnchor) {
-  switch (anchor.type) {
-    case 'npc':
-      return `NPC:${anchor.npcName}`;
-    case 'scene':
-      return `场景:${anchor.sceneName}`;
-    case 'monster':
-      return `怪物:${anchor.monsterName}`;
-    case 'quest':
-      return `任务:${anchor.questName}`;
-    case 'faction':
-      return `势力:${anchor.factionName}`;
-    default:
-      return `地标:${anchor.landmarkName}`;
-  }
-}
-
-function describeCarrierFactId(factId: string) {
-  if (factId === 'visibleClue') return '可见线索';
-  if (factId === 'currentAppearanceReason') return '当前出现理由';
-  if (factId === 'witnessMark') return '见证痕';
-  if (factId === 'unresolvedQuestion') return '未完成问题';
-  if (factId.startsWith('thread:')) return `线程索引(${factId.slice('thread:'.length)})`;
-  return factId;
-}
-
-function describePlan(
-  context: RuntimeItemGenerationContext,
-  plan: RuntimeItemPlan,
-  index: number,
-) {
-  const promptInput = buildRuntimeItemAiPromptInput(context, plan);
-  const fallbackIntent = buildRuntimeItemAiIntent(context, plan);
-  const fallbackFingerprint = buildRuntimeItemStoryFingerprint({
-    context,
-    plan,
-    intent: fallbackIntent,
-  });
-  const visibilitySlice = buildCarrierVisibilitySlice({
-    activeThreadIds: context.activeThreadIds,
-    storyFingerprint: fallbackFingerprint,
-  });
-
-  return [
-    `物品 ${index + 1}`,
-    `- slot: ${plan.slot}`,
-    `- 物品类型: ${promptInput.desiredItemKind}`,
-    `- 持续性: ${promptInput.permanence}`,
-    `- 关系锚点: ${describeRelationAnchor(plan.relationAnchor)}`,
-    `- 世界摘要: ${promptInput.worldSummary}`,
-    `- 场景摘要: ${promptInput.sceneSummary || '无'}`,
-    `- 遭遇摘要: ${promptInput.encounterSummary || '无'}`,
-    `- 相关人物: ${promptInput.relatedNpcSummary}`,
-    `- 当前激活线程: ${promptInput.activeThreadSummary || '暂无'}`,
-    `- 近期剧情: ${promptInput.recentStorySummary}`,
-    `- 玩家当前 build: ${promptInput.playerBuildDirection.join('、') || '均衡'}`,
-    `- 玩家待补缺口: ${promptInput.playerBuildGaps.join('、') || '无明显缺口'}`,
-    `- 本次目标方向: ${plan.targetBuildDirection.join('、') || '均衡'}`,
-    `- 物件可直写线索: ${visibilitySlice.sayableFactIds.map(describeCarrierFactId).join('、') || '无'}`,
-    `- 物件只宜暗写: ${visibilitySlice.inferredFactIds.map(describeCarrierFactId).join('、') || '无'}`,
-  ].join('\n');
-}
-
-export const RUNTIME_ITEM_INTENT_SYSTEM_PROMPT = `你是 AI 原生叙事 RPG 的运行时物品导演。
-你只返回 JSON，不要输出 Markdown、解释或代码块。
-
-输出结构：
-{
-  "intents": [
-    {
-      "shortNameSeed": "中文短种子",
-      "sourcePhrase": "中文来源短语",
-      "reasonToAppear": "中文出现理由",
-      "relationHooks": ["中文关系钩子"],
-      "desiredBuildTags": ["中文 build 标签"],
-      "desiredFunctionalBias": ["heal|mana|cooldown|guard|damage"],
-      "tone": "grim|mysterious|martial|ritual|survival",
-      "visibleClue": "玩家第一眼能抓到的痕迹",
-      "witnessMark": "它见证过什么的使用痕",
-      "unfinishedBusiness": "背后仍未结清的问题",
-      "hiddenHook": "更深一层但别直接讲穿的钩子",
-      "reactionHooks": ["以后谁会对它起反应"],
-      "namingPattern": "命名范式建议"
-    }
-  ]
-}
-
-规则：
-- intents 数量必须与输入物品数量完全一致，顺序也必须一致。
-- 所有自然语言字段都必须使用中文。
-- 物品意图必须贴合当前场景、关系锚点、近期剧情和玩家当前 build。
-- visibleClue / witnessMark / unfinishedBusiness / hiddenHook 要优先围绕当前激活线程、相关角色压力和旧痕来写。
-- desiredBuildTags 要优先围绕玩家当前 build 与待补缺口，不要写空数组。
-- desiredFunctionalBias 只能从给定枚举里选 1 到 2 个。
-- reasonToAppear 必须解释为什么这件东西会在当前局势里出现，而不是泛泛描述。`;
-
-export function buildRuntimeItemIntentPrompt(params: {
-  context: RuntimeItemGenerationContext;
-  plans: RuntimeItemPlan[];
-}) {
-  return [
-    `生成渠道：${params.context.generationChannel}`,
-    `以下每个物品都需要给出一条可编译的运行时物品意图。`,
-    ...params.plans.map((plan, index) => describePlan(params.context, plan, index)),
-    '请严格返回 JSON。',
-  ].join('\n\n');
-}
diff --git a/src/services/questDirector.ts b/src/services/questDirector.ts
deleted file mode 100644
index 4015d741..00000000
--- a/src/services/questDirector.ts
+++ /dev/null
@@ -1,139 +0,0 @@
-import {
-  getNpcDisclosureStage,
-  getNpcWarmthStage,
-} from '../data/npcInteractions';
-import { evaluateQuestOpportunity } from '../data/questFlow';
-import type { Encounter, GameState, QuestLogEntry } from '../types';
-import type { QuestGenerationContext } from './aiTypes';
-import { requestJson } from './apiClient';
-import type { QuestPreviewRequest } from './questTypes';
-import {
-  buildFallbackActorNarrativeProfile,
-  normalizeActorNarrativeProfile,
-} from './storyEngine/actorNarrativeProfile';
-import { buildThemePackFromWorldProfile } from './storyEngine/themePack';
-import { buildFallbackWorldStoryGraph } from './storyEngine/worldStoryGraph';
-
-function resolveIssuerNarrativeProfile(state: GameState, encounter: Encounter) {
-  if (encounter.narrativeProfile) {
-    return encounter.narrativeProfile;
-  }
-  if (!state.customWorldProfile) {
-    return null;
-  }
-
-  const role =
-    state.customWorldProfile.storyNpcs.find(
-      (npc) => npc.id === encounter.id || npc.name === encounter.npcName,
-    ) ??
-    state.customWorldProfile.playableNpcs.find(
-      (npc) => npc.id === encounter.id || npc.name === encounter.npcName,
-    );
-  if (!role) {
-    return null;
-  }
-
-  const themePack =
-    state.customWorldProfile.themePack ??
-    buildThemePackFromWorldProfile(state.customWorldProfile);
-  const storyGraph =
-    state.customWorldProfile.storyGraph ??
-    buildFallbackWorldStoryGraph(state.customWorldProfile, themePack);
-
-  return normalizeActorNarrativeProfile(
-    role.narrativeProfile,
-    buildFallbackActorNarrativeProfile(role, storyGraph, themePack),
-  );
-}
-
-export function buildQuestGenerationContextFromState(params: {
-  state: GameState;
-  encounter: Encounter;
-}): QuestGenerationContext {
-  const { state, encounter } = params;
-  const issuerNpcId = encounter.id ?? encounter.npcName;
-  const issuerState = state.npcStates[issuerNpcId];
-  const issuerNarrativeProfile = resolveIssuerNarrativeProfile(
-    state,
-    encounter,
-  );
-
-  return {
-    worldType: state.worldType,
-    customWorldProfile: state.customWorldProfile ?? null,
-    actState: state.storyEngineMemory?.actState ?? null,
-    currentSceneId: state.currentScenePreset?.id ?? null,
-    currentSceneName: state.currentScenePreset?.name ?? null,
-    currentSceneDescription: state.currentScenePreset?.description ?? null,
-    issuerNpcId,
-    issuerNpcName: encounter.npcName,
-    issuerNpcContext: encounter.context,
-    issuerAffinity: issuerState?.affinity ?? 0,
-    issuerNarrativeProfile,
-    issuerDisclosureStage: getNpcDisclosureStage(issuerState?.affinity ?? 0),
-    issuerWarmthStage: getNpcWarmthStage(issuerState?.affinity ?? 0),
-    activeThreadIds:
-      state.storyEngineMemory?.activeThreadIds?.slice(0, 4) ??
-      issuerNarrativeProfile?.relatedThreadIds?.slice(0, 4) ??
-      [],
-    encounterKind: encounter.kind ?? 'npc',
-    currentSceneTreasureHintCount:
-      state.currentScenePreset?.treasureHints?.length ?? 0,
-    currentSceneHostileNpcIds: (state.currentScenePreset?.npcs ?? [])
-      .filter((npc) => Boolean(npc.hostile || npc.monsterPresetId))
-      .map((npc) => npc.id),
-    recentStoryMoments: state.storyHistory.slice(-6),
-    playerCharacter: state.playerCharacter,
-    playerProgression: state.playerProgression ?? null,
-    playerHp: state.playerHp,
-    playerMaxHp: state.playerMaxHp,
-    playerMana: state.playerMana,
-    playerMaxMana: state.playerMaxMana,
-    playerInventory: state.playerInventory,
-    playerEquipment: state.playerEquipment,
-    activeCompanions: state.companions,
-    rosterCompanions: state.roster,
-    currentQuestSummary: state.quests.map((quest) => ({
-      id: quest.id,
-      title: quest.title,
-      status: quest.status,
-      issuerNpcId: quest.issuerNpcId,
-    })),
-  };
-}
-
-export async function generateQuestForNpcEncounter(params: {
-  state: GameState;
-  encounter: Encounter;
-}): Promise<QuestLogEntry | null> {
-  const { state, encounter } = params;
-  const issuerNpcId = encounter.id ?? encounter.npcName;
-  const request: QuestPreviewRequest = {
-    issuerNpcId,
-    issuerNpcName: encounter.npcName,
-    roleText: encounter.context,
-    scene: state.currentScenePreset,
-    worldType: state.worldType,
-    currentQuests: state.quests.map((quest) => ({
-      id: quest.id,
-      issuerNpcId: quest.issuerNpcId,
-      status: quest.status,
-    })),
-    context: buildQuestGenerationContextFromState({ state, encounter }),
-    origin: 'ai_compiled',
-  };
-  const opportunity = evaluateQuestOpportunity(request);
-  if (!opportunity.shouldOffer) {
-    return null;
-  }
-
-  return requestJson<QuestLogEntry | null>(
-    '/api/runtime/quests/generate',
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(params),
-    },
-    '任务生成失败',
-  );
-}
diff --git a/src/services/questPrompt.ts b/src/services/questPrompt.ts
deleted file mode 100644
index 6a6b3454..00000000
--- a/src/services/questPrompt.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from '../prompts/questPrompts';
diff --git a/src/services/runtimeItemAiPrompt.ts b/src/services/runtimeItemAiPrompt.ts
deleted file mode 100644
index 5c03652b..00000000
--- a/src/services/runtimeItemAiPrompt.ts
+++ /dev/null
@@ -1 +0,0 @@
-export * from '../prompts/runtimeItemPrompts';
diff --git a/src/services/storyEngine/contentDependencyGraph.test.ts b/src/services/storyEngine/contentDependencyGraph.test.ts
deleted file mode 100644
index 0c9b979d..00000000
--- a/src/services/storyEngine/contentDependencyGraph.test.ts
+++ /dev/null
@@ -1,43 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { buildContentDependencyGraph } from './contentDependencyGraph';
-
-describe('contentDependencyGraph', () => {
-  it('connects scenario, campaign, world, companions, and threads', () => {
-    const graph = buildContentDependencyGraph({
-      scenarioPack: {
-        id: 'scenario-1',
-        title: 'Scenario',
-        version: '0.1.0',
-        worldPackIds: ['world-1'],
-        campaignIds: ['campaign-1'],
-        sharedConstraintPackIds: [],
-      },
-      campaignPack: {
-        id: 'campaign-1',
-        scenarioPackId: 'scenario-1',
-        title: 'Campaign',
-        authoringStyle: 'classic',
-        campaignStateSeed: {
-          id: 'campaign-state',
-          title: 'Campaign',
-          currentActId: 'act-1',
-          currentActIndex: 0,
-        },
-        actTemplates: [],
-        requiredCompanionIds: [],
-      },
-      profile: {
-        id: 'world-1',
-        name: 'World',
-        playableNpcs: [{ id: 'npc-1', name: 'A' }],
-        storyGraph: {
-          visibleThreads: [{ id: 'thread-1', title: 'T1' }],
-        },
-      } as never,
-    });
-
-    expect(graph.nodes.length).toBeGreaterThan(2);
-    expect(graph.edges.some((edge) => edge.from === 'campaign-1' && edge.to === 'world-1')).toBe(true);
-  });
-});
diff --git a/src/services/storyEngine/contentDependencyGraph.ts b/src/services/storyEngine/contentDependencyGraph.ts
deleted file mode 100644
index 5709593d..00000000
--- a/src/services/storyEngine/contentDependencyGraph.ts
+++ /dev/null
@@ -1,76 +0,0 @@
-import type {
-  CampaignPack,
-  CustomWorldProfile,
-  ScenarioPack,
-} from '../../types';
-
-export interface ContentDependencyNode {
-  id: string;
-  type: 'scenario' | 'campaign' | 'world' | 'thread' | 'companion' | 'constraint';
-  label: string;
-}
-
-export interface ContentDependencyEdge {
-  from: string;
-  to: string;
-  reason: string;
-}
-
-export function buildContentDependencyGraph(params: {
-  scenarioPack: ScenarioPack;
-  campaignPack: CampaignPack;
-  profile: CustomWorldProfile;
-}) {
-  const nodes: ContentDependencyNode[] = [
-    {
-      id: params.scenarioPack.id,
-      type: 'scenario',
-      label: params.scenarioPack.title,
-    },
-    {
-      id: params.campaignPack.id,
-      type: 'campaign',
-      label: params.campaignPack.title,
-    },
-    {
-      id: params.profile.id,
-      type: 'world',
-      label: params.profile.name,
-    },
-    ...params.profile.playableNpcs.map((npc) => ({
-      id: npc.id,
-      type: 'companion',
-      label: npc.name,
-    } as ContentDependencyNode)),
-    ...(params.profile.storyGraph?.visibleThreads ?? []).map((thread) => ({
-      id: thread.id,
-      type: 'thread',
-      label: thread.title,
-    } as ContentDependencyNode)),
-  ];
-
-  const edges: ContentDependencyEdge[] = [
-    {
-      from: params.scenarioPack.id,
-      to: params.campaignPack.id,
-      reason: 'scenario contains campaign',
-    },
-    {
-      from: params.campaignPack.id,
-      to: params.profile.id,
-      reason: 'campaign depends on world profile',
-    },
-    ...params.profile.playableNpcs.map((npc) => ({
-      from: params.campaignPack.id,
-      to: npc.id,
-      reason: 'campaign references companion',
-    })),
-    ...(params.profile.storyGraph?.visibleThreads ?? []).map((thread) => ({
-      from: params.campaignPack.id,
-      to: thread.id,
-      reason: 'campaign advances thread',
-    })),
-  ];
-
-  return { nodes, edges };
-}