Genarrative/backend-rewrite-tasklist/04_M5_CUSTOM_WORLD_AND_AGENT.md

M5：custom world / gallery / agent 任务清单

0. 当前执行基线

本阶段与当前仓库里的创作链重构直接对应，统一以以下文档为准：

1. ../docs/technical/CREATION_FLOW_CHAIN_REFACTOR_EXECUTION_PLAN_2026-04-21.md
2. ../docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md

当前逻辑层命名和职责边界应优先使用 rpgCreation / rpgAgent / rpgWorld 口径；本任务清单继续保留 custom world 文件名，只是为了和后端重写阶段文档编号保持一致。

本轮首批可编码表设计见：

3. ../docs/technical/SPACETIMEDB_CUSTOM_WORLD_AGENT_STAGE1_TABLE_DESIGN_2026-04-21.md
4. ../docs/technical/SPACETIMEDB_CUSTOM_WORLD_PUBLISH_WORLD_STAGE4_DESIGN_2026-04-21.md
5. ../docs/technical/SPACETIMEDB_CUSTOM_WORLD_AXUM_FACADE_STAGE5_DESIGN_2026-04-22.md
6. ../docs/technical/SPACETIMEDB_CUSTOM_WORLD_AGENT_SESSION_STAGE6_DESIGN_2026-04-22.md

1. SpacetimeDB custom world 表

• 设计 custom_world_profile
• 设计 custom_world_session
• 设计 custom_world_agent_session
• 设计 custom_world_agent_message
• 设计 custom_world_agent_operation
• 设计 custom_world_draft_card
• 设计 custom_world_asset_link
• 设计 custom_world_gallery_entry

2. 当前 RPG 创作主链

• 迁移 result preview compiler
• 迁移 published profile compile（Stage 3 已落地）
• 迁移 works 聚合读模型
• 迁移 library 存储与删除（Stage 2 设计已冻结，待继续接 Axum 兼容）
• 迁移 publish / unpublish（Stage 2 设计已冻结，待继续接 Agent publish gate）
• 迁移 publish_world 串联主链（Stage 4 设计已冻结，待继续接 Axum action / publish gate）
• 迁移 publish gate / enter-world gate
• 迁移 gallery 列表与详情（Stage 2 设计已冻结，待继续接 Axum 兼容）

3. RPG 创作 Agent 主链

• 迁移 session create（Stage 6 首批 Agent session skeleton）
• 迁移 session snapshot（Stage 6 首批 Agent session skeleton）
• 迁移 message submit（Stage 7 deterministic message / operation 最小闭环）
• 迁移 message stream（Stage 8 SSE facade 已落地）
• 迁移 operation query（Stage 7 deterministic message / operation 最小闭环）
• 迁移 card detail
• 迁移 card update
• 迁移 action registry / supportedActions
• 迁移 draft foundation
• 迁移 result preview 生成
• 迁移 entity generation
• 迁移 role / scene asset sync
• 迁移 checkpoint / blocker / quality findings 主链

4. Axum 编排层

• 接入 LLM 编排
• 接入世界草稿编译
• 接入服务端 result preview 编译
• 接入角色 / 地点 / 场景 NPC 生成
• 接入封面图生成
• 接入场景图生成
• 接入 OSS 对象写入与绑定
• 接入 SSE 事件分发

5. 当前正式接口与历史兼容台账

5.1 当前正式接口

• 兼容 /api/runtime/custom-world-library（Stage 5 首批 Axum facade）
• 兼容 /api/runtime/custom-world-library/:profileId（owner-only detail 查询已补齐）
• 兼容 /api/runtime/custom-world-library/:profileId/publish（Stage 5 首批 Axum facade）
• 兼容 /api/runtime/custom-world-library/:profileId/unpublish（Stage 5 首批 Axum facade）
• 兼容 /api/runtime/custom-world-gallery（Stage 5 首批 Axum facade）
• 兼容 /api/runtime/custom-world-gallery/:ownerUserId/:profileId（Stage 5 首批 Axum facade）
• 兼容 /api/runtime/custom-world/works
• 兼容 /api/runtime/custom-world/agent/sessions（Stage 6 首批 Axum facade）
• 兼容 /api/runtime/custom-world/agent/sessions/:sessionId（Stage 6 首批 Axum facade）
• 兼容 /api/runtime/custom-world/agent/sessions/:sessionId/messages（Stage 7 deterministic message submit）
• 兼容 /api/runtime/custom-world/agent/sessions/:sessionId/messages/stream（Stage 8 SSE facade）
• 兼容 /api/runtime/custom-world/agent/sessions/:sessionId/actions（Stage 5 仅支持 publish_world 显式 draft payload）
• 兼容 /api/runtime/custom-world/agent/sessions/:sessionId/operations/:operationId（Stage 7 deterministic operation query）
• 兼容 /api/runtime/custom-world/agent/sessions/:sessionId/cards/:cardId
• 兼容 /api/custom-world/entity
• 兼容 /api/runtime/custom-world/entity
• 兼容 /api/custom-world/scene-npc
• 兼容 /api/runtime/custom-world/scene-npc
• 兼容 /api/custom-world/scene-image
• 兼容 /api/custom-world/cover-image
• 兼容 /api/custom-world/cover-upload

5.2 历史兼容台账（非当前主链）

• 评估 /api/runtime/custom-world/sessions 是否仍需保留历史兼容映射
• 评估 /api/runtime/custom-world/sessions/:sessionId 是否仍需保留历史兼容映射
• 评估 /api/runtime/custom-world/sessions/:sessionId/answers 是否仍需保留历史兼容映射
• 评估 /api/runtime/custom-world/sessions/:sessionId/generate/stream 是否仍需保留历史兼容映射

6. 阶段验收

• RPG 创作主链可用：agent session -> result preview -> published profile
• works / library / gallery / publish / enter-world 主链可用
• RPG 创作 Agent 主链可用
• agent 会话、消息、卡片、操作不再依赖单大 JSON 会话体
• 旧 custom-world/sessions 问答流不再作为当前主链扩展目标