1

docs/experience/AGENT_UI_CHANGELOG.md

@@ -113,4 +113,12 @@
 
 ---
 
+## 8. 2026-04-18 补充记录
+
+- `GameShellRuntime` 进入游戏壳时，会主动隐藏认证层提供的右上角全局账号信息条。
+- 原因不是账号功能下线，而是这个悬浮条会遮挡冒险主场景内容，移动端更明显。
+- 账号相关入口保留在平台首页 / 个人页内部按钮与账号弹窗，不再占用游戏 HUD 区域。
+
+---
+
 *文档目的：交接给下一个 Agent 时，优先读本文件 + `UI_CODING_STANDARD.md`，再改 `uiAssets.ts` / `App.tsx` / `index.css`。*

docs/experience/MOBILE_UI_DEV_EXPERIENCE.md

@@ -89,6 +89,12 @@
 - 在底部工具区，队伍/背包改成 icon 后更紧凑。
 - 但必须保留 `aria-label`，保证语义清晰、后续也方便测试。
 
+### 4.5 冒险主场景不要挂右上角账号悬浮条
+- 冒险页右上角属于画面演出和战斗/剧情信息的高频观察区。
+- 全局账号信息条挂在这里，会直接压住场景、敌人血条或顶部提示，手机端尤其明显。
+- 结论：
+  账号入口应收回平台首页、个人页或设置面板，不要在实际冒险主场景常驻悬浮显示。
+
 ## 5. 队伍面板经验
 
 ### 5.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 只适合生成叙事，不适合决定关键规则
 
 实践中最稳定的策略是：