修复重复键问题

2026-04-24 10:58:10 +08:00
parent 61f999eba9
commit 091accae9b
4 changed files with 33 additions and 16 deletions
--- a/docs/technical/SPACETIMEDB_CUSTOM_WORLD_AGENT_STAGE1_TABLE_DESIGN_2026-04-21.md
+++ b/docs/technical/SPACETIMEDB_CUSTOM_WORLD_AGENT_STAGE1_TABLE_DESIGN_2026-04-21.md
@@ -261,6 +261,12 @@
 | `created_at` | `Timestamp` | 是 | 创建时间 |
 | `updated_at` | `Timestamp` | 是 | 更新时间 |

+### 主键约束
+
+1. `card_id` 是 SpacetimeDB 表级全局主键，不能只使用 `world-foundation` 这类跨会话固定值。
+2. Agent 自动生成的世界底稿卡统一使用 `custom-world:{session_id}:world-foundation`，确保同一会话内稳定 upsert、不同会话间不会发生唯一键冲突。
+3. 不保留历史 `world-foundation` 主键兼容逻辑；线上旧脏数据如需清理，应通过一次性运维脚本处理，不进入 reducer 主链。
+
 ### 索引

 1. `session_id`