style/优化聊天历史页 #590

Merged

k88936 merged 27 commits from feat/smoother-dialog-history into master 2026-10-02 23:22:32 +08:00

Conversation 3 Commits 27 Files Changed 27

+2816 -68

27 Commits

Author	SHA1	Message	Date
k88936	1874a6e9ec	注释：为会话滚动锚点的全表量测补 TODO 性能分析 ... - conversationScrollAnchor.ts 的 readTopVisibleTurnAnchor 循环上方新增 // TODO(perf): 注释，仅注释、无行为变化 - 记录量测口径：最坏 O(锚点之前的块数) 次 getBoundingClientRect，同帧首次调用后布局已干净、后续不再各自触发 reflow，属 low，不是振荡源 - 记录 rAF 节流与「只在补偿前才读」都省不掉这次遍历，故不采纳 - 记录二分 / 续扫被收起 <details> 的 0 矩形打断单调性，需先定「隐藏块怎么参与」 - 首选后续方向：缓存上次命中的块身份并从附近续扫，不破坏单调性假设 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 22:34:07 +08:00
k88936	0ae94caf16	修复：更早历史的世代号在渲染期推进，切换项目的守卫不等 effect ... - 换项目时 historyLoadTokenRef 与 projectPathRef 同一处推进，复位 effect 不再推进 - 旧读取在「切换提交完成、复位 effect 未跑」的窗口落地时立刻失效，不再合并条目或写游标 - ADR 第 1 条与决策记录说明推进时机与其安全性依据（该窗口内不会新起带旧游标的读取） Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 22:27:33 +08:00
k88936	2b01476891	修复：动画期间内容变高时把回到底部动画重新对准新底部 ... - 程序化平滑滚动期间布局补偿不再直接跳过：内容变高时以新的 scrollHeight 重发平滑滚动 - 避免动画停在旧目标后 programmaticScrollRef 等不到贴底事件、跟随与补偿整段挂起 - hook 用例断言动画目标从 [1200] 变为 [1200,1500] 且仍能交还控制权 - ADR 第 3 条补一条口径，决策记录补齐本条与错误行结构两条 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 22:25:47 +08:00
k88936	8f91227d17	修复：历史加载错误行的重试按钮移出断言式 live region ... - 内联错误行由 <p role=alert> 改为普通容器，role=alert 只包住错误文案本身 - 重试按钮留在 live region 之外，避免被卷进 assertive + atomic 的整体播报 - 组件用例断言 alert 不包含重试按钮，重试仍是可点击的唯一手动出路 - ADR 同步错误行的无障碍结构 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 22:24:21 +08:00
k88936	ff88ad9210	Merge remote-tracking branch 'origin/master' into feat/smoother-dialog-history	2026-10-02 20:19:53 +08:00
k88936	429557ea6a	修复：会话滚动锚点改用稳定块身份定位 ... 锚点从「回合 key + 块序号」改为「回合 key + 块身份」，findTurnBlock 按 data-block-key 定位：回合收口时过程块被折进 details，块序号会整体后移，原实现会解析到隔壁块并按错误基准写 scrollTop。 收集选择器收敛为 [data-turn-key][data-block-key]，只把可定位的块计入候选。 锚点块没有布局盒（被折进收起的 details）时读锚点跳过它、restoreTurnAnchor 判失败并放弃这次补偿，调用方拿当前位置重新起锚。 用例补齐：块序号后移后按块身份仍还原到同一块、收起的 details 里的块不参与读取也不参与还原、只收集带块身份的块。 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 20:18:08 +08:00
k88936	42de1b4c39	展示：可锚定块带上稳定块身份 data-block-key ... DirectProjectTurn 给正文块写 data-block-key={block.key}，「执行过程」包装块与终态文案各给一个回合内唯一的字面量块身份。 ToolCallGroup 与 AgentReasoning 新增可选 blockKey 并透传到 data-block-key，turnKey 的注释改成「按回合 key + 块身份定位」。 组件用例断言每个可锚定块都有块身份且同回合内唯一，并用 running→finished 前后对照钉住「块序号会整体后移、块身份不变」。 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 20:15:07 +08:00
k88936	9f7c2e318c	文档：前插锚点改用稳定块身份 ... 锚点契约从「回合 key + 块序号 + 偏移」改为「回合 key + 块身份（data-block-key）+ 偏移」，写明 running→finished 收口后块序号整体后移、序号锚点会解析到隔壁块的原因。 补记锚点块没有布局盒（被折进收起的 details）时读锚点跳过、还原判失败并放弃这次补偿的规则。 备选方案补记被否掉的「锚点存块序号」与「改找同回合其它可见块」，验收清单补「长回合收口时视口不跳」。 决策记录同步同一条决策与测试口径。 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 20:12:35 +08:00
k88936	a589dad003	文档：同步 review 修正后的会话滚动契约 ... - ADR 第 1 条补「一次加载与它所属的世代绑定」，第 2 条补块集合缓存与失效信号 - 决策记录追加两处内部缺陷的症状、修正与验证口径 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 19:59:34 +08:00
k88936	1caf8ae8b0	优化：会话滚动锚点复用块集合缓存 ... collectTurnBlocks 结果按列表缓存（WeakMap），读锚点与还原锚点在同一帧内不再各查一遍整份列表 useConversationScroll 的 MutationObserver 在子元素增删时调 invalidateTurnBlocks，失效信号与重订阅共用同一处 新增两例纯函数用例：连续收集只查一次 DOM、子元素变化并失效后重新收集 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 19:58:19 +08:00
k88936	e3c3091ec4	修复：更早历史读取按世代号失效旧请求 ... loadEarlierHistory 的成功 / 失败 / finally 守卫从「项目路径相等」改成「世代号相等」，A→B→A 之后在飞的旧读取不会再清掉新一代的加载态 新增 historyLoadTokenRef，切项目与每次读取各推进一格，旧世代落地时整段丢弃：不合并条目、不写游标、不关并发闸门 新增一例控制器用例驱动 A→B→A 与同路径新读取在飞，修正前在「旧读取落地」处确实红 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 19:57:04 +08:00
k88936	97e8f1b652	Merge remote-tracking branch 'origin/master' into feat/smoother-dialog-history	2026-10-02 19:20:53 +08:00
k88936	ccc9b776d1	修复：切项目时复位 DirectProject 对话滚动所有权 ... useConversationScroll 新增 conversationKey 身份信号，身份变化时复位跟随最新 / 贴底 / 有新回复 / 前插锚点 / 折叠头 / 程序化滚动标记 复位时把终态指纹同步成新会话内容并重新贴底，避免同一次提交里的内容变化被算成「有新回复」 DirectProjectConversation 透传身份键，DirectProjectChatView 传项目路径，不重建列表 DOM 新增 3 条换会话用例与 1 条组件用例，组件用例抽成 conversationElement 以便 rerender Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 19:13:07 +08:00
k88936	95a32a316f	文档：换会话时复位 DirectProject 滚动所有权 ... - ADR 新增第 6 条：会话身份作为显式信号复位跟随最新/锚点/胶囊状态，并记录「key 重建列表」的取舍 - 决策记录追加换会话复位的症状、决策与验证口径 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 19:08:54 +08:00
k88936	986136171e	修复控制器回归测试的 invoke 替身类型 ... - vi.fn 返回固定签名，装不进 window.__TAURI__.core.invoke 的泛型签名，显式转成 TauriInvoke - tsc 不再报 TS2322；用例行为与断言不变 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 18:57:43 +08:00
k88936	9cff7bf049	修复更早历史读取失败消息为空时挂起态与错误行一起消失 ... - 失败消息统一收口成非空兜底文案，空 message 不再让 historyError 变 falsy - 新增控制器回归用例：宿主抛 new Error() 时挂起态仍成立 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 18:53:51 +08:00
k88936	77401adfe8	修复更早历史加载被旧项目读取提前关闭加载态 ... - loadEarlierHistory 的 finally 补上项目归属守卫，旧项目在飞的读取落地时不再清掉新项目的加载态与并发闸门 - 新增控制器回归用例：切项目后旧读取落地，新项目的加载态保持到它自己收口 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 18:52:33 +08:00
k88936	238c3c60d7	修复：点回到底部后平滑滚动不再被自身补偿打断 ... - 新增 programmaticScrollRef：动画在飞时滚动事件不翻转跟随、布局补偿整段跳过 - 只有真的还要走一段距离才接管滚动位置；滚到贴底或滚轮 / 触摸 / 键盘接手即交还 - 补齐 hook 用例：动画途中胶囊不闪回、不写 scrollTop、落位后与被打断后照常判定 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 18:18:34 +08:00
k88936	ecb84f1e70	修复：展开折叠块时把新展开的正文露出来 ... - 新增纯函数 toggleRevealDelta：折叠头冻结与露出正文合成一次 scrollTop 位移 - 正文底边超出视口只补超出量，正文比视口还高才对齐正文顶边，收起不额外滚动 - 补齐用例：纯函数六例与 freezeToggleHead 两条真机行为 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 18:18:26 +08:00
k88936	e82070098c	文档：修订 DirectProject 对话滚动契约 ... - 补充程序化平滑滚动独占滚动位置的规则：动画期间滚动事件与布局补偿都不得写 scrollTop - 补充折叠展开「刚好露出新展开正文」的最小位移规则，并明确收起不额外滚动 - 决策记录追加两个真机缺陷的根因、修正与 Chromium 复验结论 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 18:18:20 +08:00
k88936	5092412d89	文档：同步 DirectProject 对话滚动契约与旧口径 ... - ADR 修正样式删除口径：.message-history-more 因策划对话仍在用而保留，后续项一并说明 - 历史技术方案去掉「必须显示显示更早的对话按钮」的过期要求，改为引用新 ADR 的入口形态 - 决策记录新增本次滚动契约、边界与验证口径 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:54:15 +08:00
k88936	65b90ed43e	测试：覆盖更早历史自动加载、前插锚点与回到底部胶囊 ... - 新增与实现同目录的 5 组用例：阈值与加载门、锚点读取/还原、折叠头冻结与正文对齐、hook 状态机、组件层按钮移除与重试行 - 根 vitest.config.ts 补一条 include，同目录用例才进得了门禁 - 既有断言同步：消息列表类名加上 overflow-anchor 工具类，DirectProjectConversation 用例改用新的加载状态入参 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:54:10 +08:00
k88936	0aa9dad3c7	功能：DirectProject 对话自动加载更早历史并支持回到底部 ... - 删掉常驻的「显示更早的对话」按钮，改由触顶与填充视口两条触发自动加载，失败即挂起并留内联重试行 - 新增 useConversationScroll：列表唯一滚动所有权（跟随最新、ResizeObserver 补偿、前插锚点冻结、胶囊显隐） - 新增顶部加载行与底部居中 sticky 胶囊两个表现组件，文案与阈值取自 conversationScrollPolicy - 列表追加 overflow-anchor:none 关掉原生锚定；「有新回复」按最后一轮终态内容指纹判定 - DirectProjectChatView 交出 messagesRef / shouldFollowLatestRef / handleScroll，只传加载状态与回调 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:54:03 +08:00
k88936	1653a2be6e	功能：DirectProject 回合块标记 data-turn-key 供滚动锚点定位 ... - DirectProjectTurn 的正文块、执行过程折叠块与终态文案块写上 data-turn-key - ToolCallGroup 与 AgentReasoning 新增可选 turnKey 透传，工具组与思考块也带回合身份 - 锚点按「回合 key + 块内序号 + 偏移」定位，不新增 DOM 包裹层 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:53:53 +08:00
k88936	72ad9b8cdb	功能：DirectProject 聊天控制器暴露更早历史的加载态、失败态与重试入口 ... 控制器新增 historyLoading / historyError 两个可渲染状态，与并发判据用的 ref 同步镜像。 loadEarlierHistory 失败时写入 historyError 并挂起自动加载，成功路径清掉失败记录。 新增 retryEarlierHistory：先解挂起再走同一条加载入口，供内联错误行的重试按钮调用。 加载失败不再写顶部状态行（状态行留给首屏读取失败等其它用途）。 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:42:14 +08:00
k88936	f0ae0bd5d7	重构：抽出 DirectProject 对话滚动判据、锚点与折叠补偿纯函数 ... 新增 conversationScrollPolicy.ts：滚动/自动加载阈值、加载门、胶囊文案与填充视口判据集中在一处。 新增 conversationScrollAnchor.ts：回合 key + 块序号 + 偏移的锚点读取与还原，供前插补偿使用。 新增 conversationToggleReveal.ts：折叠头解析、头部冻结与超长正文对齐，覆盖 details 与 aria-expanded 两种折叠。 新增 useDelayedFlag.ts：延迟显示开关位，避免本地读取瞬间返回时闪一下加载行。 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:41:55 +08:00
k88936	c68531b0aa	文档：新增 DirectProject 对话滚动与历史自动加载 ADR ... 新增 ADR，记录更早历史自动加载、内联加载/错误行、回合 key 锚点前插、回到底部胶囊与折叠展开的滚动契约。 在旧「对话历史单一事实源」ADR 的分页条目上补充指向新 ADR 的引用，保留原分页锚点口径。 docs/README.md 登记新 ADR。 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:27:49 +08:00