From 41075e41a210cb5e2c43ba78cc9c757c2674fb75 Mon Sep 17 00:00:00 2001
From: kdletters <61648117+kdletters@users.noreply.github.com>
Date: Thu, 21 May 2026 17:21:38 +0800
Subject: [PATCH] fix: stabilize rpg creation entry and opening cg

---
 .gitignore                                    |   1 +
 .hermes/shared-memory/decision-log.md         |  16 ++
 .hermes/shared-memory/pitfalls.md             |  24 ++
 ...„】server-rs与SpacetimeDBæ•°æ�®å¥‘约-2026-05-15.md |   5 +
 ...��维】本地开�验�与生产�维-2026-05-15.md |   4 +
 ...�玩法创作】平�入�与玩法链路-2026-05-15.md |  18 ++
 server-rs/crates/api-server/src/app.rs        |  25 ++
 server-rs/crates/api-server/src/config.rs     |  23 +-
 .../api-server/src/creation_agent_llm_turn.rs | 119 +++++++++-
 .../api-server/src/creation_entry_config.rs   |  28 +++
 .../crates/api-server/src/custom_world_ai.rs  |  90 +++++++-
 server-rs/crates/api-server/src/match3d.rs    |   5 +-
 .../api-server/src/match3d/item_assets.rs     |   4 +-
 .../crates/api-server/src/match3d/tests.rs    |   4 +-
 .../api-server/src/openai_image_generation.rs | 214 ++++++++++++++++--
 .../module-custom-world/src/application.rs    | 110 +++++++++
 .../crates/module-runtime/src/application.rs  |   4 +-
 server-rs/crates/module-runtime/src/lib.rs    |  17 ++
 .../spacetime-module/src/custom_world.rs      |  20 +-
 .../src/runtime/creation_entry_config.rs      |  31 +++
 src/components/CustomWorldResultView.test.tsx |  69 ++++++
 ...ustomWorldCreationHub.interaction.test.tsx |  17 +-
 .../CustomWorldCreationHub.test.tsx           |  14 +-
 ...gEntryFlowShell.agent.interaction.test.tsx |  15 +-
 src/data/customWorldLibrary.test.ts           |  31 +++
 src/data/customWorldLibrary.ts                |   5 +
 26 files changed, 866 insertions(+), 47 deletions(-)

diff --git a/.gitignore b/.gitignore
index 610ac88f..c90efe5c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -36,6 +36,7 @@ temp*build*/
 /.codex-temp
 /target/
 /logs
+/server-rs/crates/*/logs/
 .worktrees/
 .env.secrets.local
 spacetime.local.json
diff --git a/.hermes/shared-memory/decision-log.md b/.hermes/shared-memory/decision-log.md
index 783fabbd..8aef4e70 100644
--- a/.hermes/shared-memory/decision-log.md
+++ b/.hermes/shared-memory/decision-log.md
@@ -113,6 +113,14 @@
 - 验�方�：新增玩法 PRD 必须显�声明�图资产槽�和系列素�槽�；新增工作�测试确认没有默认�天� Agent 输入；skill 通过 `quick_validate.py`。
 - 关�文档：`docs/�玩法创作】平�入�与玩法链路-2026-05-15.md`�`.codex/skills/genarrative-play-type-integration/SKILL.md`�`.hermes/skills/genarrative-play-type-integration/SKILL.md`。
 
+## 2026-05-21 RPG publish_world 设定文本以�端�稿真相派生
+
+- 背景：RPG 结果页�布动作����交 `{ action: 'publish_world' }`；旧 agent 会��能没有 `seed_text`，但 `draft_profile_json` 已�通过 `publish_gate` 并��布。
+- 决策：�布正�世界时，`spacetime-module` ��把 `session.seed_text` 当作唯一 `setting_text` 兜底，而是调用 `module-custom-world::resolve_custom_world_publish_setting_text(...)` 从 payload�当��稿 profile 和 seed �次派生。
+- 影�范围：RPG / custom-world agent �布链路�`custom_world_profile` 编译入库�公开 gallery 投影。
+- 验�方�：`cargo test -p module-custom-world publish_setting_text --manifest-path server-rs\Cargo.toml`；`cargo check -p spacetime-module --manifest-path server-rs\Cargo.toml`；本地 api-server ���检查 `/healthz`。
+- 关�文档：`docs/�玩法创作】平�入�与玩法链路-2026-05-15.md`�`docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md`�`.hermes/shared-memory/pitfalls.md`。
+
 ## 2026-05-19 系列素� n*n 图集抽为 api-server 通用模�
 
 - 背景：抓大鹅物� sheet 已包� prompt 组装�固定网格切图�绿幕 / 近白底�明化�切片 PNG �久化和 prompt 追踪；继续留在 Match3D �有模�会让跳一跳��续地� / �具类玩法���制�一套算法和 OSS 元数��径。
@@ -349,6 +357,14 @@
 - 验�方�：执行入��置�创作 Hub�平�入�交互和 api-server 路由熔断定�测试，确认“视觉�说��出现在创作页且 `/api/creation/visual-novel/*` 默认被熔断。
 - 关�文档：`docs/design/PLATFORM_CREATE_TAB_CREATIVE_AGENT_HOME_2026-05-05.md`�`docs/technical/ADMIN_CREATION_ENTRY_SWITCH_CONFIG_2026-05-11.md`。
 
+## 2026-05-20 RPG 创作入�开放
+
+- 背景：RPG 文字冒险能力已�具备历� custom-world 创作和�行闭环，但入�默认��� `visible=false`，创作页�展示。
+- 决策：SpacetimeDB `creation_entry_type_config` 默认��中 `rpg.visible=true` 且 `open=true`，旧默认���置�在标题�subtitle�badge�图片�排�和开关完全匹�时�移为���创建。`airp` ��� AI RPG ��，�接管当� RPG 链路。结构化创作 / RPG JSON 链路默认关闭 Responses `web_search`，需��网增强时�通过 `GENARRATIVE_RPG_LLM_WEB_SEARCH_ENABLED=true` 或 `GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED=true` 显��用；未开通工具的上游会返回 `ToolNotOpen`，�能把这类失败暴露�“模型返回结果解�失败�。
+- 影�范围：创作入�默认���旧库入�纠��`api-server` 入�熔断�创作页模� Tab�创作 Hub 测试�玩法链路文档和�端路由文档。
+- 验�方�：执行入��置�api-server 路由熔断�创作 Hub 和平�入�交互定�测试，确认“文字冒险�出现在创作入�，`/api/runtime/custom-world*`�`/api/story/*`�`/api/runtime/chat/*` 都按 `rpg` 入�开关熔断。
+- 关�文档：`docs/�玩法创作】平�入�与玩法链路-2026-05-15.md`�`docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md`。
+
 ## 2026-05-10 �行�输入设备抽象层全项目通用化
 
 - 背景：拼图�行�接入 mocap �，鼠标/触控和 mocap �自维护输入逻辑会导致�并大��拖拽语义和�消会�行为�一致；�续其他玩法也需��用体感�摇��键盘等设备输入。
diff --git a/.hermes/shared-memory/pitfalls.md b/.hermes/shared-memory/pitfalls.md
index 0399e186..88b413fb 100644
--- a/.hermes/shared-memory/pitfalls.md
+++ b/.hermes/shared-memory/pitfalls.md
@@ -22,6 +22,14 @@
 - 验�：拼图入�测试��通过，且新组件�通过��页��用而�需��制上传�实现。
 - 关�：`src/components/common/CreativeImageInputPanel.tsx`�`src/components/puzzle-agent/PuzzleAgentWorkspace.tsx`。
 
+## RPG �布�能��赖 agent session seed_text
+
+- 现象：RPG 结果页 `publish_world` 返回 `UPSTREAM_ERROR`，details 为 `custom_world.setting_text �能为空`；�一 session 的 `result-view` 日志显示 `publish_ready=true`。
+- 原因：�端�布动作��交 `{ action: 'publish_world' }`，旧 agent 会�的 `seed_text` �能为空；如果�端�从 action payload 或 `seed_text` � `setting_text`，就会在最终 compile / publish 校验阶段失败。
+- 处�：`module-custom-world::resolve_custom_world_publish_setting_text(...)` 以当� `draft_profile_json` 为�稿真相，优先读� `settingText`�`creatorIntent.rawSettingText`�`creatorIntent.worldHook`�`worldHook`�`anchorContent.worldPromise(.hook)`�`summary`�`name/title`，最��回退 `seed_text`。
+- 验�：`cargo test -p module-custom-world publish_setting_text --manifest-path server-rs\Cargo.toml`；`cargo check -p spacetime-module --manifest-path server-rs\Cargo.toml`。
+- 关�：`server-rs/crates/module-custom-world/src/application.rs`�`server-rs/crates/spacetime-module/src/custom_world.rs`�`docs/�玩法创作】平�入�与玩法链路-2026-05-15.md`。
+
 ## Windows provision 下载截断�断点续传而�是回退目标机下载
 
 - 现象：`Genarrative-Server-Provision` 在 `Download Provision Tool Archives` 阶段出现 `curl: (18) end of response ... bytes missing`，常�于 `otelcol-contrib_0.151.0_linux_amd64.tar.gz` 等 GitHub release 大文件。
@@ -374,6 +382,22 @@
 - 验�：�行 `npm run test -- src/services/creation-agent/creationAgentClientFactory.test.ts src/services/apiClient.test.ts`�`cargo test -p api-server puzzle_vector_engine --manifest-path server-rs/Cargo.toml`，真实�调�� `npm run dev:api-server` �检查 `/healthz`。
 - 关�：`src/services/creation-agent/creationAgentClientFactory.ts`�`server-rs/crates/api-server/src/puzzle.rs`�`docs/technical/API_SERVER_EXTERNAL_SERVICE_ENV_CONFIG_2026-05-07.md`。
 
+## 开局 CG 故事�生图失败先查 VectorEngine 请求预算和旧进程
+
+- 现象：RPG 结果页点击开局 CG �，`POST /api/runtime/custom-world/opening-cg` 在较长等待�返回“开局 CG 故事�生�失败：创建图片生�任务失败：error sending request for url (https://api.vectorengine.ai/v1/images/generations)�。
+- 原因：该故事�会把角色图和首幕背景图作为�考图一起传给 VectorEngine `gpt-image-2-all`，请求体和上游生�耗时都比普通�图更大；若�行中的 `api-server` �沿用旧 `VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS`，或者�考图过大，会在请求��/等待阶段被 reqwest 截断。日志里 `timeout=false connect=false request=true body=false source=client error (SendRequest)` 表示还没拿到上游 HTTP �应，通常优先怀疑大 JSON 请求体�上游网关中断或 HTTP �议兼容，而�是业务�应解�失败。直接请求 VectorEngine 若无效 token �快速返回 401，�能�此判断真实生图�会超时。
+- 处�：开局 CG �考图入�先压到�边 768 的 JPEG；`/v1/images/generations` �� reqwest 默认 HTTP �商，�有 multipart `/v1/images/edits` �独强制 HTTP/1.1。�端图片 helper 将 `request_body_bytes`��张�考图 Data URL 长度�`timeout/connect/body/source/rootSource/sourceChain/endpoint` 分类写入日志和 `error.details`，�端优先展示 `details.reason`。修改 `.env.secrets.local` �必须�� `api-server`，`npm run dev` 终端用 `rs api-server`，�则旧进程�按旧超时�行。
+- 验�：分别�行 `cargo test -p api-server custom_world_ai --manifest-path server-rs/Cargo.toml` 和 `cargo test -p api-server openai_image_generation --manifest-path server-rs/Cargo.toml`；真实�调����触�开局 CG，若�失败看返回的 `details.reason/source/rootSource/sourceChain/timeout/connect/body/endpoint` 和 `logs/api-server/` �一 request_id。
+- 关�：`server-rs/crates/api-server/src/custom_world_ai.rs`�`server-rs/crates/api-server/src/custom_world_ai/opening_cg.rs`�`server-rs/crates/api-server/src/openai_image_generation.rs`�`docs/�开��维】本地开�验�与生产�维-2026-05-15.md`。
+
+## 开局 CG �功���空白��留 profile.openingCg
+
+- 现象：RPG 结果页里的开局 CG �功显示一瞬�，窗��退回空白��。
+- 原因：`openingCg` �存在于结果页 profile 槽�，如果父层在 `onProfileChange` ��新�步了 profile，��过 `normalizeCustomWorldProfileRecord` 或作�库写回时丢掉 `openingCg`，预览就会从视频 / 故事�回退为空白。
+- 处�：`src/data/customWorldLibrary.ts` 的 profile 归一化必须�传 `openingCg`；结果页和父层�续�步都应把它当作�控资产槽�，而�是临时 UI 状�。
+- 验�：`npm run test -- src/data/customWorldLibrary.test.ts src/components/CustomWorldResultView.test.tsx`，确认生���使父层�一次归一化回写，开局 CG �继续显示。
+- 关�：`src/data/customWorldLibrary.ts`�`src/components/rpg-creation-result/RpgCreationResultViewImpl.tsx`�`src/components/CustomWorldEntityCatalog.tsx`。
+
 ## 本地脚本调 VectorEngine 生图��先区分 fetch 首部超时
 
 - 现象：用 Node `fetch` 直接请求 `POST /v1/images/generations`，已�设置较长的 AbortController 超时，但�在约 180 到 300 秒�抛 `AbortError`�`TypeError: fetch failed` 或 `UND_ERR_HEADERS_TIMEOUT`；�一 prompt 改用原生 `https.request` �以在较短时间内�功返回图片。
diff --git a/docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md b/docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md
index 125fd0d0..0986e5db 100644
--- a/docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md
+++ b/docs/��端架构】server-rs与SpacetimeDB数�契约-2026-05-15.md
@@ -325,6 +325,7 @@ npm run check:server-rs-ddd
 
 - Rust 结构体：`CustomWorldAgentSession`
 - ��：`server-rs/crates/spacetime-module/src/custom_world.rs`
+- �布约�：`publish_world` 的 action payload ��求�带 `settingText`；`spacetime-module` 调用 `module-custom-world::resolve_custom_world_publish_setting_text(...)`，优先从当� `draft_profile_json` �稿真相派生正� `setting_text`，��旧会� `seed_text` 为空时在最终 compile / publish 阶段触� `custom_world.setting_text �能为空`。
 
 ### `custom_world_draft_card`
 
@@ -597,6 +598,10 @@ npm run check:server-rs-ddd
 
 `GET /api/creation-entry/config` 和入�熔断优先从订阅 cache 读�创作入��置；cache 缺失时使用最近一次�功读�的内存快照，�兜底调用 `get_creation_entry_config` procedure 完�空库��或旧库兼容。
 
+RPG 创作入�的�置 ID 是 `rpg`，当� `visible=true`�`open=true`；历� `custom-world` 路由�是 RPG 的工程域与�行��类型。入�熔断把 `/api/runtime/custom-world*`�`/api/story/*` 和 `/api/runtime/chat/*` 统一映射到 `rpg`，��新增平行 `airp` 路由或用 `airp` 接管当�文字冒险链路。
+
+结构化创作和 RPG 的 LLM JSON 链路默认��用 Responses `web_search`；�有在明确需��网增强时，�通过 `GENARRATIVE_RPG_LLM_WEB_SEARCH_ENABLED` 或 `GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED` 显�打开。�则未开通工具的上游会先�自然语言�返回 `ToolNotOpen`，这类失败�按上游工具��用处�，��误判�模型返回结果解�失败。
+
 未��选：若�现页�推��和�玩法广场需�统一给�览器�端直接订阅公开作�列表，�新增 / 统一专用 public read model，例如 `public_work_gallery_entry`。该 read model 必须是�端投影�的公开作��片契约，覆盖作�类型�公开作���标题�摘�����作者展示��排�键�公开统计和入�开关�的��性，�暴露玩法领域�表 row shape。�端�选择订阅这个稳定投影��少 HTTP 拉�，但�能订阅 `puzzle_work_profile`�`custom_world_profile` 等�表�自行拼装列表；BFF ��留首��SEO / 分享�旧客户端�订阅失败和�度期间的 HTTP fallback。
 
 ### `quest_log`
diff --git a/docs/�开��维】本地开�验�与生产�维-2026-05-15.md b/docs/�开��维】本地开�验�与生产�维-2026-05-15.md
index 42527230..460c1338 100644
--- a/docs/�开��维】本地开�验�与生产�维-2026-05-15.md
+++ b/docs/�开��维】本地开�验�与生产�维-2026-05-15.md
@@ -45,6 +45,8 @@ npm run dev:api-server
 
 �端日志默认写入 `logs/api-server/`。�端 API smoke 使用 `npm run dev:api-server` 并检查 `/healthz`；��使用旧 `api-server:maincloud` 或任何 `GENARRATIVE_SPACETIME_MAINCLOUD_*` �径。
 
+本地 `.env`�`.env.local` 或 `.env.secrets.local` 修改�必须�� `api-server` �会生效；若已�通过 `npm run dev` �动完整�调，�在该终端输入 `rs api-server`。排查 RPG / 拼图 / 抓大鹅等 VectorEngine 生图链路时，确认 `VECTOR_ENGINE_BASE_URL`�`VECTOR_ENGINE_API_KEY` 和 `VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS` �在本地或�务器密钥文件中�置，�能写入 Git。开局 CG 故事��首图�背景和图集都属于长耗时图片请求；�端默认会把 `VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS` 下�收�到 `1000000`，旧进程��能沿用���的短超时。若开局 CG 故事�在 `send()` 阶段失败且日志显示 `SendRequest`，先看�一 request_id 的 `request_body_bytes`�`reference_data_url_bytes`�`sourceChain` 和 `rootSource`；当�开局 CG 会把角色图与首幕背景图压到�边 768 的 JPEG ��作为 generations `image` 数组��，`/v1/images/generations` 使用默认 HTTP �商，�有 multipart `/v1/images/edits` �独强制 HTTP/1.1。
+
 查看本地 Rust / SpacetimeDB 日志：
 
 ```bash
@@ -213,6 +215,8 @@ OpenTelemetry 现阶段默认开� OTLP traces / metrics / logs，但本地日
 - `WECHAT_*`
 - `ALIYUN_OSS_*`
 
+结构化创作 / RPG 的 Responses JSON 链路默认�打开 `web_search`；本地和生产如需�网增强，必须显��置 `GENARRATIVE_RPG_LLM_WEB_SEARCH_ENABLED=true` 或 `GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED=true`。如果上游未开通工具，Responses �能先�自然语言�返回 `ToolNotOpen`，这类报错应按工具��用排查，��先当� JSON 解� bug。
+
 ### 手机验��短信
 
 手机验����走阿里云普通短信 `SendSms`，验��由 `module-auth` 在当� `api-server` 进程内生��哈希存储和校验，��调用阿里云托管验��的 `SendSmsVerifyCode` / `CheckSmsVerifyCode`。因此 `api-server` ���，已��但未校验的验��会失效。
diff --git a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
index f078760e..eb07fc54 100644
--- a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
+++ b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
@@ -34,6 +34,24 @@
 6. 点击 `generationStatus=generating` 的�稿�必须��对应玩法的生�进度页，�能进入空白结果页或普通工作区；��生�页的 `startedAtMs` 使用作�摘� `updatedAt` 推导。
 7. �有 generated 图片必须通过 `ResolvedAssetImage` / `/api/assets/read-url` �签读�。
 
+## RPG / 自定义世界
+
+当� RPG 创作入�使用 `playId = rpg`，工程域和�行��类型沿用历� `custom-world`。默认入�状�为 `visible=true`�`open=true`，对外展示为“文字冒险�；`airp` �是独立的“AI RPG���入�，�� `open=false`，��把它当作当� RPG 创作链路开放。
+
+当�链路为：
+
+```text
+创作入� -> RPG Agent 共创工作� -> 生�过程页 -> 结果页 -> 进入世界/试玩 -> �布 -> RPG �行�
+```
+
+RPG 是历�既有链路例外：当��使用对�� Agent 共创工作�和 RPG 资产编辑器体系，�作为新增玩法默认模��制。新增玩法继续�循本文默认的表�/图片输入工作��`CreativeImageInputPanel` �图槽�和通用系列素�图集生��程；如果�把 RPG �步�回默认模�，应先补 PRD 和�移方案，�改代�。
+
+RPG API �沿用历�命�空间：`/api/runtime/custom-world*`�`/api/story/*`�`/api/runtime/chat/*`。这些路由在 `api-server` 入�熔断中统一映射到 `rpg`，�按 `open` 判断是��许调用；`visible` �控制创作页入�展示和作�架��性。
+
+RPG Agent 结果页�布动作的�端契约����交 `{ action: 'publish_world' }`；�端�布时以当� `custom_world_agent_session.draft_profile_json` 为�稿真相，从 `settingText`�`creatorIntent.rawSettingText`�`creatorIntent.worldHook`�`worldHook`�`anchorContent.worldPromise(.hook)`�`summary`�`name/title` �次派生正� `setting_text`，最��回退 `seed_text`。��把 `seed_text` 当作唯一设定��，旧会��能为空。
+
+RPG 结果页开局 CG 是 `profile.openingCg` 资产槽�：`api-server` 负责 VectorEngine / OSS 副作用并返回故事�和视频引用，�端�把结果写回当� profile；`sync_result_profile`�作�库�存和 `normalizeCustomWorldProfileRecord` 都必须�留该槽�。若生��功�画�短暂显示��回空白，优先检查父层�新�步或 profile 归一化是�把 `openingCg` 丢掉，而�是先怀疑已生�资�本身失效。
+
 ## 拼图
 
 当�拼图链路：
diff --git a/server-rs/crates/api-server/src/app.rs b/server-rs/crates/api-server/src/app.rs
index d540f418..6560dd05 100644
--- a/server-rs/crates/api-server/src/app.rs
+++ b/server-rs/crates/api-server/src/app.rs
@@ -619,6 +619,31 @@ mod tests {
         assert_eq!(body["error"]["details"]["creationTypeId"], "visual-novel");
     }
 
+    #[tokio::test]
+    async fn disabled_rpg_route_returns_service_unavailable() {
+        let state = AppState::new(AppConfig::default()).expect("state should build");
+        state.set_test_creation_entry_route_enabled("rpg", false);
+        let app = build_router(state);
+
+        let response = app
+            .oneshot(
+                Request::builder()
+                    .uri("/api/runtime/custom-world/agent/sessions")
+                    .body(Body::empty())
+                    .expect("request should build"),
+            )
+            .await
+            .expect("request should succeed");
+
+        assert_eq!(response.status(), StatusCode::SERVICE_UNAVAILABLE);
+        let body = read_json_response(response).await;
+        assert_eq!(
+            body["error"]["details"]["reason"],
+            "creation_entry_disabled"
+        );
+        assert_eq!(body["error"]["details"]["creationTypeId"], "rpg");
+    }
+
     #[tokio::test]
     async fn healthz_returns_standard_envelope_when_requested() {
         let app = build_router(AppState::new(AppConfig::default()).expect("state should build"));
diff --git a/server-rs/crates/api-server/src/config.rs b/server-rs/crates/api-server/src/config.rs
index 0398c948..079f7b5a 100644
--- a/server-rs/crates/api-server/src/config.rs
+++ b/server-rs/crates/api-server/src/config.rs
@@ -260,8 +260,11 @@ impl Default for AppConfig {
             llm_request_timeout_ms: DEFAULT_REQUEST_TIMEOUT_MS,
             llm_max_retries: DEFAULT_MAX_RETRIES,
             llm_retry_backoff_ms: DEFAULT_RETRY_BACKOFF_MS,
-            rpg_llm_web_search_enabled: true,
-            creation_agent_llm_web_search_enabled: true,
+            // 中文注释：创作/RPG 的结构化 JSON 链路默认��用 Responses web_search。
+            // 未开通工具的上游会先�自然语言�返回 ToolNotOpen，容易污染严格 JSON 结果；
+            // 需��网增强时由部署环境显�打开对应开关。
+            rpg_llm_web_search_enabled: false,
+            creation_agent_llm_web_search_enabled: false,
             dashscope_base_url: "https://dashscope.aliyuncs.com/api/v1".to_string(),
             dashscope_api_key: None,
             dashscope_scene_image_model: String::new(),
@@ -1467,6 +1470,14 @@ mod tests {
         }
     }
 
+    #[test]
+    fn default_keeps_structured_llm_web_search_disabled() {
+        let config = AppConfig::default();
+
+        assert!(!config.rpg_llm_web_search_enabled);
+        assert!(!config.creation_agent_llm_web_search_enabled);
+    }
+
     #[test]
     fn from_env_reads_rpg_llm_web_search_switch() {
         let _guard = ENV_LOCK
@@ -1476,11 +1487,11 @@ mod tests {
 
         unsafe {
             std::env::remove_var("GENARRATIVE_RPG_LLM_WEB_SEARCH_ENABLED");
-            std::env::set_var("GENARRATIVE_RPG_LLM_WEB_SEARCH_ENABLED", "false");
+            std::env::set_var("GENARRATIVE_RPG_LLM_WEB_SEARCH_ENABLED", "true");
         }
 
         let config = AppConfig::from_env();
-        assert!(!config.rpg_llm_web_search_enabled);
+        assert!(config.rpg_llm_web_search_enabled);
 
         unsafe {
             std::env::remove_var("GENARRATIVE_RPG_LLM_WEB_SEARCH_ENABLED");
@@ -1496,11 +1507,11 @@ mod tests {
 
         unsafe {
             std::env::remove_var("GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED");
-            std::env::set_var("GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED", "false");
+            std::env::set_var("GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED", "true");
         }
 
         let config = AppConfig::from_env();
-        assert!(!config.creation_agent_llm_web_search_enabled);
+        assert!(config.creation_agent_llm_web_search_enabled);
 
         unsafe {
             std::env::remove_var("GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED");
diff --git a/server-rs/crates/api-server/src/creation_agent_llm_turn.rs b/server-rs/crates/api-server/src/creation_agent_llm_turn.rs
index 3a2cf825..86bbfa93 100644
--- a/server-rs/crates/api-server/src/creation_agent_llm_turn.rs
+++ b/server-rs/crates/api-server/src/creation_agent_llm_turn.rs
@@ -93,15 +93,74 @@ where
     F: FnMut(&str),
 {
     let mut latest_reply_text = String::new();
+    let turn_output = match request_stream_creation_agent_json_turn_once(
+        llm_client,
+        system_prompt.clone(),
+        user_prompt.clone(),
+        enable_web_search,
+        on_reply_update,
+        &mut latest_reply_text,
+        !enable_web_search,
+    )
+    .await
+    {
+        Ok(turn_output) => turn_output,
+        Err(CreationAgentJsonTurnFailure::Stream(error))
+            if enable_web_search && is_web_search_tool_unavailable(&error) =>
+        {
+            tracing::warn!(
+                error = %error,
+                "创作 Agent ���网�索�件��用，自动�级为无�网�索�试"
+            );
+            latest_reply_text.clear();
+            request_stream_creation_agent_json_turn_once(
+                llm_client,
+                system_prompt,
+                user_prompt,
+                false,
+                on_reply_update,
+                &mut latest_reply_text,
+                true,
+            )
+            .await?
+        }
+        Err(error) => return Err(error),
+    };
+
+    let reply_text = read_reply_text(&turn_output.parsed);
+    if let Some(reply_text) = reply_text.as_deref()
+        && reply_text != latest_reply_text
+    {
+        on_reply_update(reply_text);
+    }
+
+    Ok(turn_output)
+}
+
+async fn request_stream_creation_agent_json_turn_once<F>(
+    llm_client: &LlmClient,
+    system_prompt: String,
+    user_prompt: String,
+    enable_web_search: bool,
+    on_reply_update: &mut F,
+    latest_reply_text: &mut String,
+    emit_reply_updates: bool,
+) -> Result<CreationAgentJsonTurnOutput, CreationAgentJsonTurnFailure>
+where
+    F: FnMut(&str),
+{
     let response = llm_client
         .stream_text(
             build_creation_agent_llm_request(system_prompt, user_prompt, enable_web_search),
             |delta: &LlmStreamDelta| {
+                if !emit_reply_updates {
+                    return;
+                }
                 if let Some(reply_progress) =
                     extract_reply_text_from_partial_json(delta.accumulated_text.as_str())
-                    && reply_progress != latest_reply_text
+                    && reply_progress != *latest_reply_text
                 {
-                    latest_reply_text = reply_progress.clone();
+                    *latest_reply_text = reply_progress.clone();
                     on_reply_update(reply_progress.as_str());
                 }
             },
@@ -110,12 +169,6 @@ where
         .map_err(CreationAgentJsonTurnFailure::Stream)?;
     let parsed = parse_json_response_text(response.content.as_str())
         .map_err(|_| CreationAgentJsonTurnFailure::Parse)?;
-    let reply_text = read_reply_text(&parsed);
-    if let Some(reply_text) = reply_text.as_deref()
-        && reply_text != latest_reply_text
-    {
-        on_reply_update(reply_text);
-    }
 
     Ok(CreationAgentJsonTurnOutput { parsed })
 }
@@ -327,6 +380,7 @@ mod tests {
         let server = spawn_capturing_mock_server(vec![
             MockResponse {
                 body: concat!(
+                    "data: {\"type\":\"response.output_text.delta\",\"delta\":\"我需�先�索玩具王国资料。\"}\n\n",
                     "data: {\"type\":\"error\",\"code\":\"ToolNotOpen\",\"message\":\"Your account has not activated web search.\"}\n\n",
                     "data: [DONE]\n\n"
                 )
@@ -391,6 +445,55 @@ mod tests {
         }
     }
 
+    #[tokio::test]
+    async fn stream_turn_keeps_partial_updates_when_web_search_is_disabled() {
+        let server = spawn_capturing_mock_server(vec![MockResponse {
+            body: concat!(
+                "data: {\"type\":\"response.output_text.delta\",\"delta\":\"{\\\"replyText\\\":\\\"我先\"}\n\n",
+                "data: {\"type\":\"response.output_text.delta\",\"delta\":\"把玩具王国定�。\\\",\\\"progressPercent\\\":12}\"}\n\n",
+                "data: {\"type\":\"response.completed\"}\n\n",
+            )
+            .to_string(),
+        }]);
+        let config = LlmConfig::new(
+            LlmProvider::Ark,
+            server.base_url,
+            "test-key".to_string(),
+            "test-model".to_string(),
+            30_000,
+            0,
+            1,
+        )
+        .expect("LLM config should build");
+        let llm_client = platform_llm::LlmClient::new(config).expect("LLM client should build");
+        let mut visible_replies = Vec::new();
+
+        let output = stream_creation_agent_json_turn(
+            Some(&llm_client),
+            "系统�示".to_string(),
+            "用户�示",
+            false,
+            CreationAgentLlmTurnErrorMessages {
+                model_unavailable: "模型��用",
+                generation_failed: "生�失败",
+                parse_failed: "解�失败",
+            },
+            |text| visible_replies.push(text.to_string()),
+            |message| message,
+        )
+        .await
+        .expect("stream without web search should succeed");
+
+        assert_eq!(
+            output.parsed["replyText"].as_str(),
+            Some("我先把玩具王国定�。")
+        );
+        assert_eq!(
+            visible_replies,
+            vec!["我先".to_string(), "我先把玩具王国定�。".to_string()]
+        );
+    }
+
     struct MockResponse {
         body: String,
     }
diff --git a/server-rs/crates/api-server/src/creation_entry_config.rs b/server-rs/crates/api-server/src/creation_entry_config.rs
index c470beba..24e471d4 100644
--- a/server-rs/crates/api-server/src/creation_entry_config.rs
+++ b/server-rs/crates/api-server/src/creation_entry_config.rs
@@ -96,6 +96,14 @@ pub fn resolve_creation_entry_route_id(path: &str) -> Option<&'static str> {
     if normalized.starts_with("/api/runtime/big-fish") {
         return Some("big-fish");
     }
+    if normalized.starts_with("/api/runtime/custom-world")
+        || normalized.starts_with("/api/runtime/custom-world-library")
+        || normalized.starts_with("/api/runtime/custom-world-gallery")
+        || normalized.starts_with("/api/runtime/chat")
+        || normalized.starts_with("/api/story")
+    {
+        return Some("rpg");
+    }
     if normalized.starts_with("/api/runtime/visual-novel") {
         return Some("visual-novel");
     }
@@ -161,6 +169,26 @@ mod tests {
             resolve_creation_entry_route_id("/api/creation/visual-novel/sessions"),
             Some("visual-novel"),
         );
+        assert_eq!(
+            resolve_creation_entry_route_id("/api/runtime/custom-world/agent/sessions"),
+            Some("rpg"),
+        );
+        assert_eq!(
+            resolve_creation_entry_route_id("/api/runtime/custom-world-library/profile-1"),
+            Some("rpg"),
+        );
+        assert_eq!(
+            resolve_creation_entry_route_id("/api/runtime/custom-world-gallery/user-1/profile-1"),
+            Some("rpg"),
+        );
+        assert_eq!(
+            resolve_creation_entry_route_id("/api/story/sessions/runtime"),
+            Some("rpg"),
+        );
+        assert_eq!(
+            resolve_creation_entry_route_id("/api/runtime/chat/npc/turn/stream"),
+            Some("rpg"),
+        );
         assert_eq!(
             resolve_creation_entry_route_id("/api/runtime/bark-battle/works/work-1/config"),
             Some("bark-battle"),
diff --git a/server-rs/crates/api-server/src/custom_world_ai.rs b/server-rs/crates/api-server/src/custom_world_ai.rs
index 12280439..649999dd 100644
--- a/server-rs/crates/api-server/src/custom_world_ai.rs
+++ b/server-rs/crates/api-server/src/custom_world_ai.rs
@@ -10,7 +10,9 @@ use axum::{
     response::Response,
 };
 use base64::{Engine as _, engine::general_purpose::STANDARD as BASE64_STANDARD};
-use image::{DynamicImage, GenericImageView, imageops::FilterType};
+use image::{
+    DynamicImage, GenericImageView, ImageFormat, codecs::jpeg::JpegEncoder, imageops::FilterType,
+};
 use module_assets::{
     AssetObjectAccessPolicy, AssetObjectFieldError, build_asset_entity_binding_input,
     build_asset_object_upsert_input, generate_asset_binding_id, generate_asset_object_id,
@@ -375,6 +377,8 @@ const OPENING_CG_ENTITY_KIND: &str = "custom_world_profile";
 const OPENING_CG_STORYBOARD_SLOT: &str = "opening_cg_storyboard";
 const OPENING_CG_VIDEO_SLOT: &str = "opening_cg_video";
 const ARK_VIDEO_TASK_POLL_INTERVAL_MS: u64 = 5_000;
+const OPENING_CG_REFERENCE_MAX_EDGE: u32 = 768;
+const OPENING_CG_REFERENCE_JPEG_QUALITY: u8 = 82;
 
 struct CoverPromptContext {
     opening_act_title: String,
@@ -1025,6 +1029,16 @@ pub async fn generate_custom_world_opening_cg(
                 "openingSceneImageSrc",
             )
             .await?;
+            let player_role_reference = resize_image_reference_data_url(
+                player_role_reference,
+                OPENING_CG_REFERENCE_MAX_EDGE,
+                OPENING_CG_REFERENCE_JPEG_QUALITY,
+            )?;
+            let opening_scene_reference = resize_image_reference_data_url(
+                opening_scene_reference,
+                OPENING_CG_REFERENCE_MAX_EDGE,
+                OPENING_CG_REFERENCE_JPEG_QUALITY,
+            )?;
             let storyboard = generate_opening_cg_storyboard(
                 &state,
                 &owner_user_id,
@@ -1617,6 +1631,52 @@ async fn resolve_reference_image_as_data_url(
     ))
 }
 
+fn resize_image_reference_data_url(
+    data_url: String,
+    max_edge: u32,
+    jpeg_quality: u8,
+) -> Result<String, AppError> {
+    if max_edge == 0 {
+        return Ok(data_url);
+    }
+    let Some(parsed) = parse_image_data_url(data_url.as_str()) else {
+        return Ok(data_url);
+    };
+    let image = image::load_from_memory(parsed.bytes.as_slice()).map_err(|error| {
+        AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+            "provider": "custom-world-ai",
+            "message": format!("无法解��考图：{error}"),
+        }))
+    })?;
+    let (width, height) = image.dimensions();
+    let already_within_budget = width <= max_edge && height <= max_edge;
+    if already_within_budget && parsed.mime_type == "image/jpeg" {
+        return Ok(data_url);
+    }
+
+    // 中文注释：开局 CG 故事�会�时带角色和场景两张�考图；先压到较� JPEG，��大图 PNG Data URL 让 VectorEngine 网关在请求��阶段中断。
+    let resized = if already_within_budget {
+        image
+    } else {
+        image.resize(max_edge, max_edge, FilterType::Triangle)
+    };
+    let encoded_image = DynamicImage::ImageRgb8(resized.to_rgb8());
+    let mut encoded = Vec::new();
+    JpegEncoder::new_with_quality(&mut encoded, jpeg_quality)
+        .encode_image(&encoded_image)
+        .map_err(|error| {
+            AppError::from_status(StatusCode::INTERNAL_SERVER_ERROR).with_details(json!({
+                "provider": "custom-world-ai",
+                "message": format!("压缩�考图失败：{error}"),
+            }))
+        })?;
+
+    Ok(format!(
+        "data:image/jpeg;base64,{}",
+        BASE64_STANDARD.encode(encoded)
+    ))
+}
+
 async fn create_text_to_image_generation(
     http_client: &reqwest::Client,
     settings: &DashScopeSettings,
@@ -3065,6 +3125,34 @@ mod tests {
         assert_eq!(parsed.bytes, b"hello".to_vec());
     }
 
+    #[test]
+    fn opening_cg_reference_data_url_is_resized_to_request_budget() {
+        let image = DynamicImage::ImageRgb8(image::RgbImage::new(2048, 1152));
+        let mut cursor = std::io::Cursor::new(Vec::new());
+        image
+            .write_to(&mut cursor, ImageFormat::Png)
+            .expect("test image should encode");
+        let data_url = format!(
+            "data:image/png;base64,{}",
+            BASE64_STANDARD.encode(cursor.into_inner())
+        );
+
+        let resized = resize_image_reference_data_url(
+            data_url,
+            OPENING_CG_REFERENCE_MAX_EDGE,
+            OPENING_CG_REFERENCE_JPEG_QUALITY,
+        )
+        .expect("reference should resize");
+        let parsed = parse_image_data_url(resized.as_str()).expect("resized data url should parse");
+        let resized_image =
+            image::load_from_memory(parsed.bytes.as_slice()).expect("resized image should decode");
+        let (width, height) = resized_image.dimensions();
+
+        assert!(width <= OPENING_CG_REFERENCE_MAX_EDGE);
+        assert!(height <= OPENING_CG_REFERENCE_MAX_EDGE);
+        assert_eq!(parsed.mime_type, "image/jpeg");
+    }
+
     #[test]
     fn push_cover_reference_source_keeps_full_data_url() {
         let mut sources = Vec::new();
diff --git a/server-rs/crates/api-server/src/match3d.rs b/server-rs/crates/api-server/src/match3d.rs
index 75f731b3..3a599422 100644
--- a/server-rs/crates/api-server/src/match3d.rs
+++ b/server-rs/crates/api-server/src/match3d.rs
@@ -109,9 +109,8 @@ const MATCH3D_WORK_METADATA_LLM_MODEL: &str = "gpt-4o";
 const MATCH3D_ITEM_SIZE_LARGE: &str = "大";
 const MATCH3D_ITEM_SIZE_MEDIUM: &str = "中";
 const MATCH3D_ITEM_SIZE_SMALL: &str = "å°�";
-const MATCH3D_CONTAINER_REFERENCE_IMAGE_BYTES: &[u8] = include_bytes!(
-    "../../../../public/match3d-background-references/pot-fused-reference.png"
-);
+const MATCH3D_CONTAINER_REFERENCE_IMAGE_BYTES: &[u8] =
+    include_bytes!("../../../../public/match3d-background-references/pot-fused-reference.png");
 const MATCH3D_PUBLIC_REFERENCE_IMAGE_PATH_PREFIX: &str = "public/";
 const MATCH3D_QUESTION_THEME: &str = "你想创作什么题�";
 const MATCH3D_QUESTION_CLEAR_COUNT: &str = "需�消除多少次�能通关";
diff --git a/server-rs/crates/api-server/src/match3d/item_assets.rs b/server-rs/crates/api-server/src/match3d/item_assets.rs
index 87f86542..51c270ed 100644
--- a/server-rs/crates/api-server/src/match3d/item_assets.rs
+++ b/server-rs/crates/api-server/src/match3d/item_assets.rs
@@ -1,12 +1,12 @@
 use super::*;
+#[cfg(test)]
+use crate::generated_asset_sheets::crop_generated_asset_sheet_view_edge_matte;
 use crate::generated_asset_sheets::{
     GeneratedAssetSheetPersistInput, GeneratedAssetSheetPersistPrompt,
     GeneratedAssetSheetPromptInput, GeneratedAssetSheetSliceImage,
     build_generated_asset_sheet_prompt, persist_generated_asset_sheet_bytes,
     slice_generated_asset_sheet,
 };
-#[cfg(test)]
-use crate::generated_asset_sheets::crop_generated_asset_sheet_view_edge_matte;
 
 pub(super) async fn generate_match3d_item_assets(
     state: &AppState,
diff --git a/server-rs/crates/api-server/src/match3d/tests.rs b/server-rs/crates/api-server/src/match3d/tests.rs
index 04b93cbc..74417201 100644
--- a/server-rs/crates/api-server/src/match3d/tests.rs
+++ b/server-rs/crates/api-server/src/match3d/tests.rs
@@ -1164,7 +1164,9 @@ fn match3d_container_reference_image_is_embedded_for_api_only_deploy() {
     assert_eq!(reference.mime_type, "image/png");
     assert_eq!(reference.file_name, "match3d-container-reference.png");
     assert!(
-        reference.bytes.starts_with(&[137, 80, 78, 71, 13, 10, 26, 10]),
+        reference
+            .bytes
+            .starts_with(&[137, 80, 78, 71, 13, 10, 26, 10]),
         "container reference image should be PNG bytes"
     );
 }
diff --git a/server-rs/crates/api-server/src/openai_image_generation.rs b/server-rs/crates/api-server/src/openai_image_generation.rs
index 55554701..11b754f6 100644
--- a/server-rs/crates/api-server/src/openai_image_generation.rs
+++ b/server-rs/crates/api-server/src/openai_image_generation.rs
@@ -1,4 +1,4 @@
-use std::time::Duration;
+use std::{error::Error as _, time::Duration};
 
 use axum::http::StatusCode;
 use base64::{Engine as _, engine::general_purpose::STANDARD as BASE64_STANDARD};
@@ -82,8 +82,6 @@ pub(crate) fn build_openai_image_http_client(
 ) -> Result<reqwest::Client, AppError> {
     reqwest::Client::builder()
         .timeout(Duration::from_millis(settings.request_timeout_ms))
-        // 中文注释：�一客户端也会承载 `/v1/images/edits` multipart 图生图请求，强制 HTTP/1.1 ��开部分网关对 HTTP/2 multipart �的兼容问题。
-        .http1_only()
         .build()
         .map_err(|error| {
             AppError::from_status(StatusCode::INTERNAL_SERVER_ERROR).with_details(json!({
@@ -110,21 +108,46 @@ pub(crate) async fn create_openai_image_generation(
         candidate_count,
         reference_images,
     );
+    let request_body_bytes = serde_json::to_vec(&request_body).map_err(|error| {
+        map_openai_image_request_error(format!(
+            "{failure_context}：�列化图片生�请求失败：{error}"
+        ))
+    })?;
+    let normalized_size = request_body
+        .get("size")
+        .and_then(Value::as_str)
+        .unwrap_or(size);
+    let reference_lengths = summarize_reference_data_url_lengths(reference_images);
+    let request_url = vector_engine_images_generation_url(settings);
+    tracing::info!(
+        provider = VECTOR_ENGINE_PROVIDER,
+        endpoint = %request_url,
+        model = VECTOR_ENGINE_GPT_IMAGE_2_MODEL,
+        prompt_chars = prompt.chars().count(),
+        size = normalized_size,
+        candidate_count = candidate_count.clamp(1, 4),
+        reference_count = reference_images.len(),
+        reference_data_url_bytes = %reference_lengths,
+        request_body_bytes = request_body_bytes.len(),
+        "VectorEngine 图片生�请求已准备"
+    );
     let response = http_client
-        .post(vector_engine_images_generation_url(settings))
+        .post(request_url.as_str())
         .header(
             header::AUTHORIZATION,
             format!("Bearer {}", settings.api_key),
         )
         .header(header::ACCEPT, "application/json")
         .header(header::CONTENT_TYPE, "application/json")
-        .json(&request_body)
+        .body(request_body_bytes)
         .send()
         .await
         .map_err(|error| {
-            map_openai_image_request_error(format!(
-                "{failure_context}：创建图片生�任务失败：{error}"
-            ))
+            map_openai_image_reqwest_error(
+                format!("{failure_context}：创建图片生�任务失败").as_str(),
+                request_url.as_str(),
+                error,
+            )
         })?;
     let response_status = response.status();
     let response_text = response.text().await.map_err(|error| {
@@ -191,8 +214,11 @@ pub(crate) async fn create_openai_image_edit(
         )
         .text("n", "1")
         .text("size", normalize_image_size(size));
-    let response = http_client
-        .post(vector_engine_images_edit_url(settings).as_str())
+    let request_url = vector_engine_images_edit_url(settings);
+    // 中文注释：�对 multipart `/v1/images/edits` �独强制 HTTP/1.1；大 JSON generations ��默认�商，�� HTTP/1.1 网关在��大请求体时中断连接。
+    let edit_http_client = build_openai_image_edit_http_client(settings)?;
+    let response = edit_http_client
+        .post(request_url.as_str())
         .header(
             header::AUTHORIZATION,
             format!("Bearer {}", settings.api_key),
@@ -202,9 +228,11 @@ pub(crate) async fn create_openai_image_edit(
         .send()
         .await
         .map_err(|error| {
-            map_openai_image_request_error(format!(
-                "{failure_context}：创建图片编辑任务失败：{error}"
-            ))
+            map_openai_image_reqwest_error(
+                format!("{failure_context}：创建图片编辑任务失败").as_str(),
+                request_url.as_str(),
+                error,
+            )
         })?;
     let response_status = response.status();
     let response_text = response.text().await.map_err(|error| {
@@ -242,6 +270,21 @@ pub(crate) async fn create_openai_image_edit(
     )
 }
 
+fn build_openai_image_edit_http_client(
+    settings: &OpenAiImageSettings,
+) -> Result<reqwest::Client, AppError> {
+    reqwest::Client::builder()
+        .timeout(Duration::from_millis(settings.request_timeout_ms))
+        .http1_only()
+        .build()
+        .map_err(|error| {
+            AppError::from_status(StatusCode::INTERNAL_SERVER_ERROR).with_details(json!({
+                "provider": VECTOR_ENGINE_PROVIDER,
+                "message": format!("构造 VectorEngine 图片编辑 HTTP 客户端失败：{error}"),
+            }))
+        })
+}
+
 pub(crate) fn build_openai_image_request_body(
     prompt: &str,
     negative_prompt: Option<&str>,
@@ -402,6 +445,130 @@ fn map_openai_image_request_error(message: String) -> AppError {
     }))
 }
 
+fn map_openai_image_reqwest_error(
+    context: &str,
+    request_url: &str,
+    error: reqwest::Error,
+) -> AppError {
+    let message = format!(
+        "{context}：{}",
+        normalize_openai_reqwest_error_message(&error)
+    );
+    let source_chain = reqwest_error_source_chain(&error);
+    let root_source = source_chain.last().cloned().unwrap_or_default();
+    let source_chain_text = source_chain.join(" | ");
+    let is_timeout = error.is_timeout()
+        || is_openai_image_timeout_message(message.as_str())
+        || is_openai_image_timeout_message(source_chain_text.as_str());
+    let is_connect = error.is_connect();
+    let status = if is_timeout {
+        StatusCode::GATEWAY_TIMEOUT
+    } else {
+        StatusCode::BAD_GATEWAY
+    };
+    let source = source_chain.first().cloned().unwrap_or_default();
+    let reason = resolve_openai_image_request_failure_reason(&error, source_chain.as_slice());
+
+    tracing::warn!(
+        provider = VECTOR_ENGINE_PROVIDER,
+        endpoint = %request_url,
+        timeout = is_timeout,
+        connect = is_connect,
+        request = error.is_request(),
+        body = error.is_body(),
+        source = %source,
+        root_source = %root_source,
+        source_chain = ?source_chain,
+        message = %message,
+        "VectorEngine 图片请求��失败"
+    );
+
+    AppError::from_status(status).with_details(json!({
+        "provider": VECTOR_ENGINE_PROVIDER,
+        "message": message,
+        "reason": reason,
+        "endpoint": request_url,
+        "timeout": is_timeout,
+        "connect": is_connect,
+        "request": error.is_request(),
+        "body": error.is_body(),
+        "source": source,
+        "rootSource": root_source,
+        "sourceChain": source_chain,
+    }))
+}
+
+fn normalize_openai_reqwest_error_message(error: &reqwest::Error) -> String {
+    error
+        .to_string()
+        .split_whitespace()
+        .collect::<Vec<_>>()
+        .join(" ")
+}
+
+fn reqwest_error_source_chain(error: &reqwest::Error) -> Vec<String> {
+    let mut chain = Vec::new();
+    let mut current = error.source();
+    while let Some(source) = current {
+        chain.push(source.to_string());
+        current = source.source();
+        if chain.len() >= 8 {
+            break;
+        }
+    }
+    chain
+}
+
+fn resolve_openai_image_request_failure_reason(
+    error: &reqwest::Error,
+    source_chain: &[String],
+) -> &'static str {
+    let combined = std::iter::once(error.to_string())
+        .chain(source_chain.iter().cloned())
+        .collect::<Vec<_>>()
+        .join(" | ");
+    if error.is_timeout() || is_openai_image_timeout_message(combined.as_str()) {
+        return "VectorEngine 图片生�请求超时，请���试；如果多次�现，检查上游耗时并调大 VECTOR_ENGINE_IMAGE_REQUEST_TIMEOUT_MS";
+    }
+    if error.is_connect() {
+        return "无法连接 VectorEngine 图片生�接�，请检查�务器网络�DNS�防�墙或代��置";
+    }
+    if error.is_body() {
+        return "�� VectorEngine 图片生�请求体失败，请�试并检查�考图大�";
+    }
+    if is_openai_image_send_request_interrupted(combined.as_str()) {
+        return "VectorEngine 在接收图片生�请求时中断连接；请�试，若�续�现优先检查�考图体积�上游网关和 HTTP �议兼容";
+    }
+    "VectorEngine 图片生�请求��失败，请查看 source 字段中的底层网络错误"
+}
+
+fn is_openai_image_send_request_interrupted(message: &str) -> bool {
+    let lower = message.to_ascii_lowercase();
+    lower.contains("sendrequest")
+        || lower.contains("connection closed")
+        || lower.contains("connection reset")
+        || lower.contains("broken pipe")
+        || lower.contains("unexpected eof")
+        || lower.contains("stream error")
+        || lower.contains("body write aborted")
+}
+
+fn is_openai_image_timeout_message(message: &str) -> bool {
+    let lower = message.to_ascii_lowercase();
+    lower.contains("timed out")
+        || lower.contains("timeout")
+        || lower.contains("operation timed out")
+        || lower.contains("deadline has elapsed")
+}
+
+fn summarize_reference_data_url_lengths(reference_images: &[String]) -> String {
+    reference_images
+        .iter()
+        .map(|value| value.len().to_string())
+        .collect::<Vec<_>>()
+        .join(",")
+}
+
 fn map_openai_image_upstream_error(
     upstream_status: u16,
     raw_text: &str,
@@ -646,6 +813,27 @@ mod tests {
         );
     }
 
+    #[test]
+    fn vector_engine_reqwest_error_exposes_actionable_reason() {
+        let error = match reqwest::Client::new().get("http://[::1").build() {
+            Ok(_) => panic!("invalid url should fail request build"),
+            Err(error) => error,
+        };
+        let app_error = map_openai_image_reqwest_error(
+            "开局 CG 故事�生�失败：创建图片生�任务失败",
+            "https://api.vectorengine.ai/v1/images/generations",
+            error,
+        );
+
+        assert_eq!(app_error.status_code(), StatusCode::BAD_GATEWAY);
+        assert!(
+            app_error
+                .body_text()
+                .contains("开局 CG 故事�生�失败：创建图片生�任务失败")
+        );
+        assert!(format!("{app_error:?}").contains("sourceChain"));
+    }
+
     #[test]
     fn b64_json_response_decodes_png_image() {
         let images = images_from_base64(
diff --git a/server-rs/crates/module-custom-world/src/application.rs b/server-rs/crates/module-custom-world/src/application.rs
index 0cf077d7..a518b3d1 100644
--- a/server-rs/crates/module-custom-world/src/application.rs
+++ b/server-rs/crates/module-custom-world/src/application.rs
@@ -599,6 +599,37 @@ pub fn canonicalize_custom_world_profile_before_save(profile: &mut Value) -> boo
     true
 }
 
+pub fn resolve_custom_world_publish_setting_text(
+    payload: &Map<String, Value>,
+    draft_profile: &Map<String, Value>,
+    seed_text: &str,
+) -> String {
+    // 中文注释：�布按钮的�端契约����交动作�；正� settingText 必须从�稿真相补�，
+    // ��旧会� seed_text 为空时通过 publish gate，�在最终 compile/publish 阶段失败。
+    read_nested_text_field(payload, &["settingText"])
+        .or_else(|| {
+            read_nested_text_field(
+                draft_profile,
+                &[
+                    "settingText",
+                    "creatorIntent.rawSettingText",
+                    "creatorIntent.worldHook",
+                    "worldHook",
+                    "anchorContent.worldPromise",
+                    "anchorContent.worldPromise.hook",
+                    "summary",
+                    "name",
+                    "title",
+                ],
+            )
+        })
+        .or_else(|| {
+            let seed = seed_text.trim();
+            (!seed.is_empty()).then(|| seed.to_string())
+        })
+        .unwrap_or_default()
+}
+
 pub fn empty_agent_anchor_content_json() -> String {
     r#"{"worldPromise":null,"playerFantasy":null,"themeBoundary":null,"playerEntryPoint":null,"coreConflict":null,"keyRelationships":null,"hiddenLines":null,"iconicElements":null}"#.to_string()
 }
@@ -804,6 +835,32 @@ fn read_text(object: &Map<String, Value>, key: &str) -> Option<String> {
         .map(ToOwned::to_owned)
 }
 
+fn read_nested_text_field(object: &Map<String, Value>, keys: &[&str]) -> Option<String> {
+    for key in keys {
+        let mut current = Value::Object(object.clone());
+        let mut found = true;
+        for segment in key.split('.') {
+            if let Some(next) = current.get(segment) {
+                current = next.clone();
+            } else {
+                found = false;
+                break;
+            }
+        }
+        if found {
+            if let Some(value) = current
+                .as_str()
+                .map(str::trim)
+                .filter(|value| !value.is_empty())
+            {
+                return Some(value.to_string());
+            }
+        }
+    }
+
+    None
+}
+
 fn read_string_list(object: &Map<String, Value>, key: &str) -> Vec<String> {
     object
         .get(key)
@@ -955,3 +1012,56 @@ fn build_compiled_profile_payload_json(
     serde_json::to_string(&Value::Object(payload))
         .map_err(|_| CustomWorldFieldError::InvalidDraftProfileJson)
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use serde_json::json;
+
+    #[test]
+    fn publish_setting_text_falls_back_to_draft_profile_when_seed_is_empty() {
+        let payload = Map::new();
+        let draft_profile = json!({
+            "settingText": "海雾会�掉记错航线的人。",
+            "worldHook": "在失真的海图上追查一场被篡改的沉船事故。",
+            "summary": "守�人与群岛议会围绕沉船旧案对峙。"
+        })
+        .as_object()
+        .cloned()
+        .expect("draft profile should be object");
+
+        let setting_text =
+            resolve_custom_world_publish_setting_text(&payload, &draft_profile, "");
+
+        assert_eq!(setting_text, "海雾会�掉记错航线的人。");
+    }
+
+    #[test]
+    fn publish_setting_text_prefers_payload_then_draft_then_seed() {
+        let mut payload = Map::new();
+        payload.insert(
+            "settingText".to_string(),
+            Value::String("�布载�设定".to_string()),
+        );
+        let draft_profile = json!({
+            "worldHook": "�稿世界一��",
+            "summary": "�稿摘�"
+        })
+        .as_object()
+        .cloned()
+        .expect("draft profile should be object");
+
+        assert_eq!(
+            resolve_custom_world_publish_setting_text(&payload, &draft_profile, "用户原始设定"),
+            "�布载�设定"
+        );
+        assert_eq!(
+            resolve_custom_world_publish_setting_text(&Map::new(), &draft_profile, "用户原始设定"),
+            "�稿世界一��"
+        );
+        assert_eq!(
+            resolve_custom_world_publish_setting_text(&Map::new(), &Map::new(), "用户原始设定"),
+            "用户原始设定"
+        );
+    }
+}
diff --git a/server-rs/crates/module-runtime/src/application.rs b/server-rs/crates/module-runtime/src/application.rs
index c3ebf645..87002c8a 100644
--- a/server-rs/crates/module-runtime/src/application.rs
+++ b/server-rs/crates/module-runtime/src/application.rs
@@ -54,9 +54,9 @@ pub fn default_creation_entry_type_snapshots(
             "rpg",
             "文字冒险",
             "�典 RPG 体验",
-            "内测",
+            "�创建",
             "/creation-type-references/rpg.webp",
-            false,
+            true,
             true,
             10,
             updated_at_micros,
diff --git a/server-rs/crates/module-runtime/src/lib.rs b/server-rs/crates/module-runtime/src/lib.rs
index 3d182426..490a2def 100644
--- a/server-rs/crates/module-runtime/src/lib.rs
+++ b/server-rs/crates/module-runtime/src/lib.rs
@@ -236,6 +236,23 @@ mod tests {
         );
     }
 
+    #[test]
+    fn default_creation_entry_types_open_rpg_entry() {
+        let configs = default_creation_entry_type_snapshots(1);
+        let rpg = configs
+            .iter()
+            .find(|item| item.id == "rpg")
+            .expect("rpg creation entry should be seeded");
+
+        assert_eq!(rpg.title, "文字冒险");
+        assert_eq!(rpg.subtitle, "�典 RPG 体验");
+        assert!(rpg.visible);
+        assert!(rpg.open);
+        assert_eq!(rpg.badge, "�创建");
+        assert_eq!(rpg.sort_order, 10);
+        assert_eq!(rpg.image_src, "/creation-type-references/rpg.webp");
+    }
+
     #[test]
     fn default_creation_entry_types_include_bark_battle() {
         let configs = default_creation_entry_type_snapshots(1);
diff --git a/server-rs/crates/spacetime-module/src/custom_world.rs b/server-rs/crates/spacetime-module/src/custom_world.rs
index 36228bfe..c7d8eeca 100644
--- a/server-rs/crates/spacetime-module/src/custom_world.rs
+++ b/server-rs/crates/spacetime-module/src/custom_world.rs
@@ -2562,6 +2562,18 @@ fn upsert_nested_result_profile_id(
     }
 }
 
+fn resolve_publish_world_setting_text(
+    payload: &JsonMap<String, JsonValue>,
+    draft_profile: &JsonMap<String, JsonValue>,
+    session: &CustomWorldAgentSession,
+) -> String {
+    module_custom_world::resolve_custom_world_publish_setting_text(
+        payload,
+        draft_profile,
+        &session.seed_text,
+    )
+}
+
 fn is_same_agent_draft_profile_candidate(
     row: &CustomWorldProfile,
     owner_user_id: &str,
@@ -2608,13 +2620,7 @@ fn execute_publish_world_action(
         .filter(|value| !value.is_empty())
         .map(ToOwned::to_owned)
         .unwrap_or_else(|| gate.profile_id.clone());
-    let setting_text = payload
-        .get("settingText")
-        .and_then(JsonValue::as_str)
-        .map(str::trim)
-        .filter(|value| !value.is_empty())
-        .map(ToOwned::to_owned)
-        .unwrap_or_else(|| session.seed_text.clone());
+    let setting_text = resolve_publish_world_setting_text(payload, &draft_profile, session);
     let legacy_result_profile_json = payload
         .get("legacyResultProfile")
         .map(serialize_json_value)
diff --git a/server-rs/crates/spacetime-module/src/runtime/creation_entry_config.rs b/server-rs/crates/spacetime-module/src/runtime/creation_entry_config.rs
index 05c9db50..c0b47b2e 100644
--- a/server-rs/crates/spacetime-module/src/runtime/creation_entry_config.rs
+++ b/server-rs/crates/spacetime-module/src/runtime/creation_entry_config.rs
@@ -179,6 +179,7 @@ fn seed_creation_entry_config_if_missing(ctx: &ReducerContext) {
         }
     }
 
+    migrate_rpg_entry_from_old_hidden_default(ctx, now);
     migrate_visual_novel_entry_from_old_visible_default(ctx, now);
     migrate_coming_soon_entry_from_old_open_default(
         ctx,
@@ -204,6 +205,36 @@ fn seed_creation_entry_config_if_missing(ctx: &ReducerContext) {
     );
 }
 
+fn migrate_rpg_entry_from_old_hidden_default(ctx: &ReducerContext, now: Timestamp) {
+    let id = "rpg".to_string();
+    let Some(row) = ctx.db.creation_entry_type_config().id().find(&id) else {
+        return;
+    };
+
+    // 中文注释：�开放历�默认��的 RPG 入�，�覆盖��入�开关�续手动�置。
+    let still_old_hidden_default = row.title == "文字冒险"
+        && row.subtitle == "�典 RPG 体验"
+        && row.badge == "内测"
+        && row.image_src == "/creation-type-references/rpg.webp"
+        && !row.visible
+        && row.open
+        && row.sort_order == 10;
+    if !still_old_hidden_default {
+        return;
+    }
+
+    ctx.db
+        .creation_entry_type_config()
+        .id()
+        .update(CreationEntryTypeConfig {
+            badge: "�创建".to_string(),
+            visible: true,
+            open: true,
+            updated_at: now,
+            ..row
+        });
+}
+
 fn migrate_visual_novel_entry_from_old_visible_default(ctx: &ReducerContext, now: Timestamp) {
     let id = "visual-novel".to_string();
     let Some(row) = ctx.db.creation_entry_type_config().id().find(&id) else {
diff --git a/src/components/CustomWorldResultView.test.tsx b/src/components/CustomWorldResultView.test.tsx
index 2142efe8..cf381a5f 100644
--- a/src/components/CustomWorldResultView.test.tsx
+++ b/src/components/CustomWorldResultView.test.tsx
@@ -5,6 +5,7 @@ import userEvent from '@testing-library/user-event';
 import { useState } from 'react';
 import { expect, test, vi } from 'vitest';
 
+import { normalizeCustomWorldProfileRecord } from '../data/customWorldLibrary';
 import * as rpgCreationAssetClient from '../services/rpg-creation/rpgCreationAssetClient';
 import type { CustomWorldPlayableNpc, CustomWorldProfile } from '../types';
 import { RpgCreationResultView } from './rpg-creation-result/RpgCreationResultView';
@@ -286,6 +287,40 @@ function ResultViewHarness() {
   );
 }
 
+function ResultViewRehydratingHarness() {
+  const [profile, setProfile] = useState(baseProfile);
+  const [rehydrated, setRehydrated] = useState(false);
+
+  return (
+    <div>
+      <div data-testid="rehydrated">{rehydrated ? 'yes' : 'no'}</div>
+      <RpgCreationResultView
+        profile={profile}
+        previewCharacters={[]}
+        isGenerating={false}
+        progress={0}
+        progressLabel=""
+        error={null}
+        onBack={() => {}}
+        onProfileChange={(nextProfile) => {
+          setProfile(nextProfile);
+          if (!nextProfile.openingCg) {
+            return;
+          }
+
+          window.setTimeout(() => {
+            const normalized = normalizeCustomWorldProfileRecord(nextProfile);
+            if (normalized) {
+              setProfile(normalized);
+            }
+            setRehydrated(true);
+          }, 0);
+        }}
+      />
+    </div>
+  );
+}
+
 test('clicking新增�扮演角色 shows pending item, disables button, and marks result as new', async () => {
   const user = userEvent.setup();
 
@@ -385,6 +420,40 @@ test('world tab generates opening cg only after manual click and writes it back
   });
 });
 
+test('world tab keeps opening cg visible after parent rehydrates normalized profile', async () => {
+  const user = userEvent.setup();
+  mockedRpgCreationAssetClient.generateOpeningCg.mockResolvedValue({
+    id: 'opening-cg-1',
+    status: 'ready',
+    storyboardImageSrc: '/generated-custom-world-scenes/world/opening/storyboard.png',
+    storyboardAssetId: 'storyboard-1',
+    videoSrc: '/generated-custom-world-scenes/world/opening/opening.mp4',
+    videoAssetId: 'video-1',
+    imageModel: 'gpt-image-2',
+    videoModel: 'doubao-seedance-2-0-fast-260128',
+    aspectRatio: '16:9',
+    imageSize: '2k',
+    videoResolution: '480p',
+    durationSeconds: 15,
+    pointCost: 80,
+    estimatedWaitMinutes: 10,
+    updatedAt: '2026-05-03T00:00:00Z',
+  });
+
+  render(<ResultViewRehydratingHarness />);
+
+  await user.click(screen.getByRole('button', { name: '生�' }));
+
+  await waitFor(() => {
+    expect(screen.getByTestId('rehydrated').textContent).toBe('yes');
+  });
+  expect(
+    document.querySelector(
+      'video[src="/generated-custom-world-scenes/world/opening/opening.mp4"]',
+    ),
+  ).toBeTruthy();
+});
+
 test('playable tab prefers generated portrait over runtime preview placeholder', async () => {
   const user = userEvent.setup();
   const profile = {
diff --git a/src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx b/src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx
index 9c2d722e..dbd41fc3 100644
--- a/src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx
+++ b/src/components/custom-world-home/CustomWorldCreationHub.interaction.test.tsx
@@ -25,6 +25,17 @@ const testEntryConfig = {
     description: '先选玩法类型，�进入对应创作工作�。',
   },
   creationTypes: [
+    {
+      id: 'rpg',
+      title: '文字冒险',
+      subtitle: '�典 RPG 体验',
+      badge: '�创建',
+      imageSrc: '/creation-type-references/rpg.webp',
+      visible: true,
+      open: true,
+      sortOrder: 10,
+      updatedAtMicros: 1,
+    },
     {
       id: 'puzzle',
       title: '拼图',
@@ -253,14 +264,18 @@ test('creation hub reflects updated draft title summary and counts after rerende
   const match3dButton = screen.getByRole('button', {
     name: /抓大鹅.*3D 消除关�/u,
   });
+  const rpgButton = screen.getByRole('button', {
+    name: /文字冒险.*�典 RPG 体验/u,
+  });
   expect(puzzleButton).toBeTruthy();
   expect(match3dButton).toBeTruthy();
+  expect(rpgButton).toBeTruthy();
   expect((puzzleButton as HTMLButtonElement).disabled).toBe(false);
   expect((match3dButton as HTMLButtonElement).disabled).toBe(false);
+  expect((rpgButton as HTMLButtonElement).disabled).toBe(false);
   expect(screen.queryByRole('button', { name: /方洞挑战/u })).toBeNull();
   expect(screen.queryByText('�直觉形状分拣')).toBeNull();
   expect(screen.queryByRole('button', { name: /智能创作/u })).toBeNull();
-  expect(screen.queryByRole('button', { name: /文字冒险/u })).toBeNull();
   expect(screen.queryByRole('button', { name: /大鱼��鱼/u })).toBeNull();
 
   await user.click(match3dButton);
diff --git a/src/components/custom-world-home/CustomWorldCreationHub.test.tsx b/src/components/custom-world-home/CustomWorldCreationHub.test.tsx
index 8ece1b8b..ced0e82c 100644
--- a/src/components/custom-world-home/CustomWorldCreationHub.test.tsx
+++ b/src/components/custom-world-home/CustomWorldCreationHub.test.tsx
@@ -19,6 +19,17 @@ const testEntryConfig = {
     description: '先选玩法类型，�进入对应创作工作�。',
   },
   creationTypes: [
+    {
+      id: 'rpg',
+      title: '文字冒险',
+      subtitle: '�典 RPG 体验',
+      badge: '�创建',
+      imageSrc: '/creation-type-references/rpg.webp',
+      visible: true,
+      open: true,
+      sortOrder: 10,
+      updatedAtMicros: 1,
+    },
     {
       id: 'puzzle',
       title: '拼图',
@@ -124,7 +135,8 @@ test('creation hub draft card renders compiled work summary fields', () => {
   expect(html).toContain('拼图关�创作');
   expect(html).toContain('抓大鹅');
   expect(html).toContain('3D 消除关�');
-  expect(html).not.toContain('文字冒险');
+  expect(html).toContain('文字冒险');
+  expect(html).toContain('�典 RPG 体验');
   expect(html).not.toContain('大鱼��鱼');
 });
 
diff --git a/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx b/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
index 732dc6f6..053e09bb 100644
--- a/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
+++ b/src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
@@ -271,6 +271,17 @@ const testCreationEntryConfig = {
     description: '先选玩法类型，�进入对应创作工作�。',
   },
   creationTypes: [
+    {
+      id: 'rpg',
+      title: '文字冒险',
+      subtitle: '�典 RPG 体验',
+      badge: '�创建',
+      imageSrc: '/creation-type-references/rpg.webp',
+      visible: true,
+      open: true,
+      sortOrder: 10,
+      updatedAtMicros: 1,
+    },
     {
       id: 'puzzle',
       title: '拼图',
@@ -3205,8 +3216,8 @@ test('create tab shows template tabs and embeds puzzle form by default', async (
     screen.getByRole('tab', { name: '拼图' }).querySelector('img')?.src,
   ).toContain('/creation-type-references/puzzle.webp');
   expect(
-    screen.getByRole('tab', { name: 'AIRP' }).querySelector('img')?.src,
-  ).toContain('/creation-type-references/airp.webp');
+    screen.getByRole('tab', { name: '文字冒险' }).querySelector('img')?.src,
+  ).toContain('/creation-type-references/rpg.webp');
   expect(
     screen.getByRole('tab', { name: '抓大鹅' }).querySelector('img')?.src,
   ).toContain('/creation-type-references/match3d.webp');
diff --git a/src/data/customWorldLibrary.test.ts b/src/data/customWorldLibrary.test.ts
index e07f9e62..6643c7b2 100644
--- a/src/data/customWorldLibrary.test.ts
+++ b/src/data/customWorldLibrary.test.ts
@@ -165,4 +165,35 @@ describe('normalizeCustomWorldProfileRecord role asset descriptions', () => {
       '/generated-characters/story-yizhang/portrait.png',
     );
   });
+
+  it('�留结果页生�的开局 CG 槽�', () => {
+    const profile = normalizeCustomWorldProfileRecord({
+      name: '雾港归航',
+      settingText: '海雾旧案',
+      openingCg: {
+        id: 'opening-cg-1',
+        status: 'ready',
+        storyboardImageSrc: '/generated-custom-world-scenes/opening/storyboard.png',
+        storyboardAssetId: 'storyboard-1',
+        videoSrc: '/generated-custom-world-scenes/opening/opening.mp4',
+        videoAssetId: 'video-1',
+        imageModel: 'gpt-image-2',
+        videoModel: 'doubao-seedance-2-0-fast-260128',
+        aspectRatio: '16:9',
+        imageSize: '2k',
+        videoResolution: '480p',
+        durationSeconds: 15,
+        pointCost: 80,
+        estimatedWaitMinutes: 10,
+        updatedAt: '2026-05-21T00:00:00.000Z',
+      },
+    });
+
+    expect(profile?.openingCg?.videoSrc).toBe(
+      '/generated-custom-world-scenes/opening/opening.mp4',
+    );
+    expect(profile?.openingCg?.storyboardImageSrc).toBe(
+      '/generated-custom-world-scenes/opening/storyboard.png',
+    );
+  });
 });
diff --git a/src/data/customWorldLibrary.ts b/src/data/customWorldLibrary.ts
index e075867d..8b53f3e8 100644
--- a/src/data/customWorldLibrary.ts
+++ b/src/data/customWorldLibrary.ts
@@ -27,6 +27,7 @@ import {
   CustomWorldNpcVisualGear,
   CustomWorldNpcVisualGearType,
   CustomWorldNpcVisualRace,
+  CustomWorldOpeningCgProfile,
   CustomWorldPlayableNpc,
   CustomWorldProfile,
   CustomWorldRoleInitialItem,
@@ -1155,6 +1156,9 @@ function normalizeProfile(value: unknown): CustomWorldProfile | null {
         .map((entry, index) => normalizePlayableNpc(entry, index))
         .filter((entry): entry is CustomWorldPlayableNpc => Boolean(entry))
     : [];
+  const openingCg = preserveStructuredRecord<CustomWorldOpeningCgProfile>(
+    value.openingCg,
+  );
   const normalizedProfile = {
     id: toText(value.id, `saved-custom-world-${Date.now().toString(36)}`),
     settingText,
@@ -1180,6 +1184,7 @@ function normalizeProfile(value: unknown): CustomWorldProfile | null {
           .map((entry, index) => normalizeItem(entry, index))
           .filter((entry): entry is CustomWorldItem => Boolean(entry))
       : [],
+    openingCg,
     camp,
     landmarks: normalizeCustomWorldLandmarks({
       landmarks: landmarkDrafts,