1

docs/technical/RPG_CREATION_PROFILE_GENERATION_BACKEND_MIGRATION_2026-04-28.md

@@ -0,0 +1,51 @@
+# RPG 创作 profile 生成后端迁移（2026-04-28）
+
+## 1. 背景
+
+`docs/audits/engineering/RPG_FRONTEND_SCRIPT_BACKEND_MIGRATION_AUDIT_2026-04-28.md` 的 5.3 指出，`src/services/rpg-creation/rpgCreationGenerationClient.ts` 在非浏览器环境仍会动态 `import('../ai')`，让 RPG 创作 profile 生成继续保留前端 legacy AI 后门。
+
+这与当前边界冲突：
+
+1. 前端只负责表现和 API client。
+2. RPG 创作 prompt 与 LLM 编排只能在 `server-rs/crates/api-server/src/prompt/rpg/` 与 `api-server` 侧出现。
+3. 外部 LLM 调用不能进入 SpacetimeDB reducer，必须由 Axum / `platform-llm` 完成后再把确定结果交给后续持久化链。
+
+## 2. 本轮落地
+
+### 2.1 前端
+
+`src/services/rpg-creation/rpgCreationGenerationClient.ts` 现在不再判断 `typeof window`，也不再动态导入 `src/services/ai.ts`。
+
+无论浏览器、SSR 还是 Vitest node 环境，`generateRpgWorldProfile(...)` 都只调用：
+
+```text
+POST /api/runtime/custom-world/profile
+```
+
+测试如需离线运行，应 mock `requestJson`，不能恢复本地 AI 生成链。
+
+### 2.2 后端
+
+`server-rs/crates/api-server/src/app.rs` 新增：
+
+```text
+POST /api/runtime/custom-world/profile
+```
+
+handler 落在 `server-rs/crates/api-server/src/custom_world.rs`：
+
+1. 校验 `settingText`。
+2. 要求 Bearer 鉴权。
+3. 要求 `platform-llm` 可用。
+4. 复用 `generate_custom_world_foundation_draft(...)` 生成 profile 草稿。
+5. 补齐结果页需要的 `id / settingText / templateWorldType / compatibilityTemplateWorldType / items / generationMode / generationStatus / creatorIntent`。
+6. 直接返回 `CustomWorldProfile` JSON，保持前端旧 client contract 不变。
+
+本轮不新增 SpacetimeDB 表，不修改 `migration.rs`。
+
+## 3. 验收
+
+1. `src/services/rpg-creation/**` 不再出现 `import('../ai')`、`LegacyAiModule`、`loadLegacyAiModule`。
+2. `src/services/rpg-creation/index.ts` 不再导出 `generateLegacyCustomWorldProfile`。
+3. node 环境测试确认 profile 生成只走 `requestJson` mock。
+4. Rust `api-server` 测试确认 `/api/runtime/custom-world/profile` 未登录返回 `401`。