1

docs/technical/CUSTOM_WORLD_RESULT_ENTITY_GENERATION_FIX_2026-04-24.md

@@ -38,3 +38,16 @@ LLM 扩展提示词为了草稿卡片简洁，只要求返回角色的 `publicMa
 - `generate_landmarks` 的 payload 中新增场景必须包含非空 `description`，并能把 `characterIds` 落为 `sceneNpcIds`。
 - 结果页继续只消费 `resultPreview.preview`，不新增前端本地编译分支。
 - 结果页点击新增实体后，如果服务端没有回传新增内容，必须展示错误提示。
+
+## 2026-04-24 追加：可扮演角色结果页空刷新修复
+
+新增可扮演角色报“生成请求已完成，但结果页未收到新增内容”的根因是：`api-server` 已经把 LLM 生成结果注入 `generatedCharacters`，但 `spacetime-module` 缺少 `generate_characters / generate_landmarks` 的真实落库 executor，action 会进入分派却无法把新增内容写入 `draft_profile_json` 与 `result_preview_json`。
+
+本次补齐 SpacetimeDB module executor：
+
+1. `generate_characters(roleType=playable)` 写入 `draftProfile.playableNpcs`。
+2. `generate_characters(roleType=story)` 写入 `draftProfile.storyNpcs`。
+3. `generate_landmarks` 写入 `draftProfile.landmarks`。
+4. 每个新增实体同步生成 draft card，并刷新 `publish_gate_json / result_preview_json / checkpoints_json / operation / message`。
+
+结果页仍只消费服务端 `resultPreview.preview`；前端不会本地伪造新增角色。