修复：更早历史的世代号在渲染期推进，切换项目的守卫不等 effect

- 换项目时 historyLoadTokenRef 与 projectPathRef 同一处推进，复位 effect 不再推进 - 旧读取在「切换提交完成、复位 effect 未跑」的窗口落地时立刻失效，不再合并条目或写游标 - ADR 第 1 条与决策记录说明推进时机与其安全性依据（该窗口内不会新起带旧游标的读取） Co-authored-by: Junie <junie@jetbrains.com>
2026-10-02 22:27:33 +08:00
parent 2b01476891
commit 0ae94caf16
3 changed files with 12 additions and 4 deletions
@@ -22,7 +22,7 @@ DirectProject 聊天区（`apps/ai-game-creator-shell/src/view/project-developme
 - 两个触发都不越过既有的首屏订阅锚点 `lastCompletedItemId`；一次加载仍最多连拉 5 页（口径见 [`【ADR】DirectProject对话历史单一事实源-2026-09-16`](./【ADR】DirectProject对话历史单一事实源-2026-09-16.md)）。
 - 加载中在列表最上方（比最旧一条回合更靠上）挂载一行 `role="status"`、`aria-live="polite"` 的「正在加载更早的对话」，带旋转圈；延迟 150ms 才显示，加载结束即卸载。它按需挂载，靠位置补偿（见第 2 条）保证下面的消息不跳。
 - 失败：挂起自动加载，列表顶部保留一行内联错误行——`role="alert"` 只包住「加载更早对话失败」文案本身，重试是可聚焦按钮、留在 live region 之外（assertive + atomic 的 live region 里不放交互控件）；**不自动重试**，只有点重试（或切换项目）才重新开始；重试成功后错误行消失。
- 一次加载与它所属的**世代**绑定：切换项目或新起一次读取都推进世代号（`historyLoadTokenRef`），旧世代落地时整段失效——不合并条目、不写游标、不关加载态。只比项目路径不够：A→B→A 之后在飞的旧读取又落回同一个路径，原守卫放行，会把新一代的加载行与 `historyLoadingRef` 这道并发闸门一起改掉。
+- 一次加载与它所属的**世代**绑定：切换项目或新起一次读取都推进世代号（`historyLoadTokenRef`），旧世代落地时整段失效——不合并条目、不写游标、不关加载态。只比项目路径不够：A→B→A 之后在飞的旧读取又落回同一个路径，原守卫放行，会把新一代的加载行与 `historyLoadingRef` 这道并发闸门一起改掉。换项目的推进放在**渲染期**（与 `projectPathRef` 同一处），不放在复位 effect 里：passive effect 走宏任务、promise 续体走微任务，旧读取可能在「切换提交完成、复位 effect 还没跑」的窗口里落地，那时世代号还是旧的，守卫会放行。

 ### 2. 前插锚定：回合 key + 块身份 + 偏移，关掉浏览器原生锚定