From 224a26d318b38cebeae69aca5f3c38b0bae15c8b Mon Sep 17 00:00:00 2001
From: kdletters <61648117+kdletters@users.noreply.github.com>
Date: Thu, 21 May 2026 17:49:07 +0800
Subject: [PATCH] fix: tolerate null legacy custom-world profile

---
 .hermes/shared-memory/pitfalls.md             |  8 +++
 ...�玩法创作】平�入�与玩法链路-2026-05-15.md |  2 +
 .../module-custom-world/src/application.rs    | 51 ++++++++++++++++++-
 3 files changed, 60 insertions(+), 1 deletion(-)

diff --git a/.hermes/shared-memory/pitfalls.md b/.hermes/shared-memory/pitfalls.md
index 88b413fb..9c47745c 100644
--- a/.hermes/shared-memory/pitfalls.md
+++ b/.hermes/shared-memory/pitfalls.md
@@ -398,6 +398,14 @@
 - 验�：`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`。
 
+## RPG �布报 legacy_result_profile_json �法先查 null 兼容
+
+- 现象：RPG 结果页�布动作返回 `UPSTREAM_ERROR`，SpacetimeDB details 里是 `custom_world.compile.legacy_result_profile_json �是�法 JSON object`。
+- 原因：`publish_world` �端契约��求 `{ action: 'publish_world' }`；`ExecuteCustomWorldAgentActionRequest.legacy_result_profile` 是�选字段，� HTTP / serde / SpacetimeDB payload 传递时�能显��为 JSON `null`。旧的编译器�接� object 或缺�，把 `Some("null")` 当��法 legacy JSON。
+- 处�：`module-custom-world` 的 optional JSON object 解��把 `null` 视为未�供，�拒�数组�字符串�数字和� JSON；正��布继续以 session `draft_profile_json` 为�稿真相。
+- 验�：`cargo test -p module-custom-world published_profile_compile --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`。
+
 ## 本地脚本调 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/�玩法创作】平�入�与玩法链路-2026-05-15.md b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
index eb07fc54..2584be6b 100644
--- a/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
+++ b/docs/�玩法创作】平�入�与玩法链路-2026-05-15.md
@@ -50,6 +50,8 @@ RPG API �沿用历�命�空间：`/api/runtime/custom-world*`�`/api/story
 
 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` 当作唯一设定��，旧会��能为空。
 
+`legacyResultProfile` �作为历�结果页 profile 兼容兜底；`publish_world` 请求缺�或显�为 `null` 时等价于未�供，编译正� profile 时�得因此报 `custom_world.compile.legacy_result_profile_json �是�法 JSON object`。真正的数组�字符串�数字等� object legacy 载��应拒�。
+
 RPG 结果页开局 CG 是 `profile.openingCg` 资产槽�：`api-server` 负责 VectorEngine / OSS 副作用并返回故事�和视频引用，�端�把结果写回当� profile；`sync_result_profile`�作�库�存和 `normalizeCustomWorldProfileRecord` 都必须�留该槽�。若生��功�画�短暂显示��回空白，优先检查父层�新�步或 profile 归一化是�把 `openingCg` 丢掉，而�是先怀疑已生�资�本身失效。
 
 ## 拼图
diff --git a/server-rs/crates/module-custom-world/src/application.rs b/server-rs/crates/module-custom-world/src/application.rs
index a518b3d1..57f8f41c 100644
--- a/server-rs/crates/module-custom-world/src/application.rs
+++ b/server-rs/crates/module-custom-world/src/application.rs
@@ -694,7 +694,13 @@ fn parse_optional_json_object(
     error: CustomWorldFieldError,
 ) -> Result<Map<String, Value>, CustomWorldFieldError> {
     match normalize_optional_json_slice(value) {
-        Some(value) => parse_required_json_object(&value, error),
+        Some(value) => match serde_json::from_str::<Value>(&value) {
+            Ok(Value::Object(object)) => Ok(object),
+            // 中文注释：跨层�选字段� serde 结构体�列化��能显��� null；
+            // 对 optional JSON object 而言 null 等价于未�供，�能阻断�布链路。
+            Ok(Value::Null) => Ok(Map::new()),
+            _ => Err(error),
+        },
         None => Ok(Map::new()),
     }
 }
@@ -1018,6 +1024,49 @@ mod tests {
     use super::*;
     use serde_json::json;
 
+    fn build_test_compile_input(
+        legacy_result_profile_json: Option<String>,
+    ) -> CustomWorldPublishedProfileCompileInput {
+        CustomWorldPublishedProfileCompileInput {
+            session_id: "session-1".to_string(),
+            profile_id: "cwprof_001".to_string(),
+            owner_user_id: "user-1".to_string(),
+            draft_profile_json: json!({
+                "name": "潮雾列岛",
+                "summary": "群岛与旧�塔之间的沉船疑案。",
+                "playableNpcs": [],
+                "storyNpcs": [],
+                "landmarks": []
+            })
+            .to_string(),
+            legacy_result_profile_json,
+            setting_text: "海图会在�夜改写群岛航路。".to_string(),
+            author_display_name: "创作者".to_string(),
+            updated_at_micros: 1,
+        }
+    }
+
+    #[test]
+    fn published_profile_compile_treats_null_legacy_result_profile_as_absent() {
+        let snapshot = build_custom_world_published_profile_compile_snapshot(
+            build_test_compile_input(Some("null".to_string())),
+        )
+        .expect("null legacy result profile should be treated as absent");
+
+        assert_eq!(snapshot.profile_id, "cwprof_001");
+        assert_eq!(snapshot.world_name, "潮雾列岛");
+    }
+
+    #[test]
+    fn published_profile_compile_rejects_non_object_legacy_result_profile() {
+        let error = build_custom_world_published_profile_compile_snapshot(
+            build_test_compile_input(Some("[]".to_string())),
+        )
+        .expect_err("array legacy result profile should still be invalid");
+
+        assert_eq!(error, CustomWorldFieldError::InvalidLegacyResultProfileJson);
+    }
+
     #[test]
     fn publish_setting_text_falls_back_to_draft_profile_when_seed_is_empty() {
         let payload = Map::new();