1

docs/experience/PROJECT_DEVELOPMENT_EXPERIENCE.md

@@ -76,6 +76,19 @@
 - 流程层优先按“职责”拆，不按“文件长度”拆。
 - 状态修改逻辑尽量集中到 hook 内，不要散落在多个组件按钮回调里。
 
+## 3.1 AI 草稿数据进列表前，要先补本地稳定标识
+
+自定义世界、角色草稿、澄清问题、生成结果卡片这类数据，在草稿态或兼容旧数据时，`id` 可能为空。
+
+经验：
+
+- React 列表的 `key` 不要直接裸用这类可能为空的 `id`。
+- 当前选中态、草稿缓存、轮播焦点也不要直接绑空 `id`，否则会出现“点了第二张卡，结果还是第一张卡被选中”的错位。
+- 更稳的做法是：
+  - 业务数据层尽量补齐真实 id
+  - UI 层再补一层本地稳定 `selectionKey` / fallback render key
+  - fallback 至少带上 `index + 名称种子`，保证当前列表内唯一
+
 ## 4. AI 只适合生成叙事，不适合决定关键规则
 
 实践中最稳定的策略是：