docs: record the chat streaming motion fix (BUG-1921)
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DbBXp2Vp62Ur3C7yRWQdSq
This commit is contained in:
@@ -25914,3 +25914,16 @@
|
||||
- 已知限制:在途计数、冷却和「上次调用被拒绝」存在 Web 进程内存里,重启清零,多容器不共享;用量账本不记录是哪一条 Key;编辑或替换第一条启用的 Key 后,下次发布要重新做连接测试。
|
||||
- 关联记录:BUG-147(admin_runtime 缺 SELECT policy)、BUG-1914(模型单价)。
|
||||
- 修复版本:`claude/provider-key-pool-1116`,待 staging 实测。
|
||||
|
||||
## BUG-1921 | 生成回答时「正在分析」的高光动画卡顿,正文边写边抖
|
||||
|
||||
- 状态:fixed-pending-verify(待 staging 真实对话实测)。
|
||||
- 首次发现 / 最近更新:2026-11-16 / 2026-11-16。
|
||||
- 触发与现象:对话里提问后,等待时状态文字上的高光一顿一顿;正文写出来的过程中整段上下跳,能看到没闭合的 `**` 和表格竖线,写完瞬间整段往上跳一截;以 `##` 标题开头的回答整轮不显示,结束时一次性出现。
|
||||
- 触发条件:任何流式回答;回答里有标题、加粗、表格时更重,手机上更重。
|
||||
- 根因:(1)高光用 `background-position` 配合文字裁切做动画,每帧在主线程重绘(6.8 秒等待里 805 次),流式提交时就卡住。(2)状态文字以文案作 key,每换一句就重新挂载,高光从头再扫。(3)步骤列表在正文上方,每遇到一个 `##` 标题加一行,把正文往下推 32px,写了一半的标题也算一步。(4)结束时步骤列表在两帧之间被拿掉,正文一次上跳 164px。(5)第一个 `##` 之后的内容在流式期间不渲染。(6)没写完的 Markdown 原样解析,`**` 和表格竖线露出来,表格成形时高度回缩。(7)跟随滚动等到下一帧才执行,每多一行先画在下面再拉回来。(8)每完成一段就把整段前缀重新解析一遍,写完时还换了组件类型,整段 DOM 重建。
|
||||
- 修复:高光改成只动 transform 的遮罩,同一时间只有一个相位,换文案不重来,减少动态偏好下不显示;正文一开始写,步骤列表收成「正在分析」一行(用户自己展开的照旧),结束时用 180 毫秒收起;写了一半的标题不算步骤;流式期间对没写完的 Markdown 先补齐再显示(未闭合的加粗先闭合,表格等分隔行到了再出,存下来的文本不动);正文按块渲染并记忆,流式和写完用同一个组件;标题开头的回答照常边写边出;跟随滚动改在尺寸变化回调里、绘制之前执行。
|
||||
- 验证与防复发:用临时页面挂真实的对话组件、滚动锚点和帧缓冲,脚本回放一轮步骤事件和 900 字回答,无头 Chrome 逐帧记录:等待期间重绘 805 → 77;结束时上跳 164px 一帧 → 35px 分约 6 帧;中途被步骤推下去 32px / 次 → 无;露出 `**` / 竖线的帧 43 / 16 → 0 / 0;跟随滚动回弹 23 → 0。测试:`frontend/tests/chat-stream-motion-20261116.test.tsx`(14 项)、`conversation-scroll-anchor-lifecycle.test.tsx` 新增 1 项;7 个旧测试文件里锁旧行为的断言改到新行为并注明原值、新值、原因。未验证:登录后的真实对话与真实模型流、Safari 与真机、生时纠正对话(共用组件,只跑了单元测试)。
|
||||
- 已知限制:6 倍 CPU 降速下仍有约 14% 的帧超过 25 毫秒;新标题或「判断依据」折叠出现时仍会一次增加约 66px;结束时正文仍上移约 35px。
|
||||
- 关联记录:BUG-725(按块记忆)、流式状态与正文同气泡的修复(见本文件「共享 ChatMessageRow」一条)。历史回答现在也按块渲染,范围比流式更大。
|
||||
- 修复版本:`claude/chat-motion-1116`,待 staging 实测。
|
||||
|
||||
Reference in New Issue
Block a user