Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
#5406:增强滚动测试与补修
后续继续定位、搜索与回底的补修以及最终三轮复测,见 NAVIGATION-VALIDATION.md。以下保留此前未通过的阶段记录。
2026-10-03,Windows Electron 41.10.3,真实 MessageStream、真实布局/字体/主题,合成数据, 独立 profile,无后端与用户数据。没有启动或替换正在运行的正式客户端。
本轮实际发现
上一轮“18 张稳定截图正常”不足以说明滚动过程没有瞬时异常。更密集的采样发现:
- 快速滚轮/滚动条拖动时,初版 hook 将挂载推迟到下一个 rAF,视口可先出现空占位。
6GROaj共 3,061 次采样,其中 274 次含占位:96 次发生在快滚/真实拖动,178 次在强制脚本跳跃。 - 1,000 条历史从较早的搜索结果返回最新位置时,回底按钮可停在最新消息之前。
bHB0fg的三种窗口尺寸均失败。原因是 React 尚未切回尾部窗口,就读取旧窗口的 scrollHeight。
补修:
- 在原生 scroll 事件里用
flushSync完成正文挂载,取消额外一帧延后;ResizeObserver 的合帧 回调也确保该帧更新提交。仍按视口挂载,没有改回常态全量渲染。 - 回底按钮切换
firstVisibleItemKey后先同步提交,再读取新尾窗高度启动滚动。 - 仅在偏差超过 1px 时写回 scrollTop,避免无效赋值打断平滑滚动。
- hook 单测增加“发出 scroll 后、不推进下一 rAF 就必须看到正文”的断言;新增
jumpToLatestLayout.test.tsx使用真实回底 callback 和 React commit,校验目标来自切换后的 DOM。
负载与方法
scroll-tests.cjs 在 1000×420、1000×760、620×1000 三种窗体尺寸运行,覆盖 Light / Dark:
- 每种尺寸 80 次慢上滚、80 次慢下滚、70 次快上滚、70 次快下滚、60 次方向反转。
- 真实 Electron mouseDown / mouseMove / mouseUp 操作滚动条,每种尺寸 40 次拖动位置改变; 同时验证实际 scrollTop 跨度,不能把没有拖中滑块当作通过。
- Home / End 和各 12 次 PageDown / PageUp;5 次搜索目标定位;回底按钮;停止后的阅读锚点。
- 注入正文增长、图片和新增消息,然后继续上/下滚动。
- 另有每种尺寸 60 次“rAF 中直接写 scrollTop”的独立边界压力项;保留其失败记录。
rAF 后的任务记录每帧视口、挂载数、空占位覆盖、行重叠;高速度阶段用
webContents.beginFrameSubscription 抓取真正绘制帧,不只在 450ms 停稳后截屏。
DOM 采样不等于每个显示器刷新;两种证据结合,仍不宣称能证明任意环境绝无闪动。
全量挂载对照通过当前组件既有 Tab 可访问性回退恢复所有已加载正文,保持同样正常布局, 不使用 content-visibility:auto,避免把引擎崩溃与滚动画面混在一起。
结果与未通过项
- 全量对照
zTJtVa:3,528 次采样,无空占位/重叠,176 张真实绘制帧。 - 同步挂载后
QNVzJW,500 条:4,782 次采样;真实操作和稳定阅读均通过,只有直接脚本跳跃 的 177 次空帧,完整脚本保留visual-failed。 - 1,000 条
bHB0fg:发现回底失败,未将其归为脚本问题;补修后NpZdyH的三种尺寸回底均通过。NpZdyH总共 4,773 次采样,仅剩直接脚本跳跃的 177 次空帧,其余阶段无空占位/重叠。 - 所有窗口均无 renderer JS 错误、无原生崩溃;停止后的阅读锚点误差不超过 2px。
- 未观察到真实用户输入路径上的新空白、重叠或停止后的跳动。但不能据此写成“全压力矩阵通过”。
后续 n5ZI7K 的重复运行还有搜索及回底失败,不能凭 NpZdyH 一轮正常就认定全部解决。
检查发现原搜索断言只等待 1 秒,而组件允许 2.5 秒落定;改为等待目标可见且停止滚动,
最多 3 秒,记录每次耗时。不过 390dwm 仍有 2 个目标在 3 秒后不可见,证实不只是计时问题。
随后实验“搜索定位时完整挂载逻辑窗口”,BoOG1r 仍有 2 次目标不可见。
始终全量挂载的 DorU2w 对照也在相同目标(490)失败,且没有空占位。
因此该额外挂载措施未保留;不能把尚未定位的搜索问题都解释为占位高度误差,
也不能仅凭这个对照就断言原始版本已存在相同 bug,因为对照仍运行当前组件的其他逻辑。
当前源码回到 iyoRWW 对应实现:同步滚动挂载、避免无效位置重写、先提交尾窗再量高度。
最终源码对应的记录
| 数据量 / 产物 | 总采样 | 非强制脚本阶段空占位 / 重叠 | 搜索未通过 | 强制脚本空帧 |
|---|---|---|---|---|
500 / 390dwm |
5,539 | 0 / 0 | 2 次,目标 420,在 760px 与 1000px 窗高下超出视口 | 177 |
1000,seed5408 / z1HM0d |
4,790 | 0 / 0 | 0 | 176 |
两轮合计 10,329 次采样,排除 720 次强制脚本阶段采样后,9,609 次采样没有空占位/重叠;
这不抵消搜索目标未命中的失败。两轮回底检查均通过;没有崩溃或 JS 错误。
三个生产文件(MessageStream、useMessageViewport、globals.css)的当前 SHA-256 与冻结构建
iyoRWW 的记录逐项一致。最后一轮结束后确认本次测试 Electron 已退出、临时 profile 已清理。
单文件图集:cindy-ax5406-z1HM0d/scroll-report.html。
相关测试通过:10 文件 106 项通过、1 项原有跳过;随后新增“零偏差不重写 scrollTop”用例,
该 hook 与回底用例合计 8 项定向复跑通过。Desktop 类型检查与 git diff --check 通过。
验收状态:未全通过。 普通滚轮/拖动的闪空已补修,但搜索落点问题仍未解决, 加上下面的直接脚本跳跃空帧,不能将当前候选标为无滚动画面异常或可直接发布。
仍存在的边界:直接在动画帧回调内强改 scrollTop,会在浏览器下一次派发 scroll 事件前 先绘制一个新位置,虚拟正文尚未就绪;真实绘制帧已看到整屏空白,停止后恢复。 当前测试覆盖的滚轮、真实拖动、键盘、搜索和回底路径没有复现该现象。 此项不删除、不豁免为绿色,也不代表已经找到了每一种生产程序化滚动的相同时序。 目前不应承诺“任何程序化跳跃绝无闪空”。
复跑
node apps/desktop/scripts/ax5406/run.mjs --scenario=component --workload=scroll-tests --rows=1000 --seed=5408 --ax=on --query=none --seconds=300
# 复用上述冻结构建,作全量挂载对照:
node apps/desktop/scripts/ax5406/run.mjs --scenario=component --component-build=<AX5406_ARTIFACTS> --workload=scroll-tests --mounting=full --rows=1000 --ax=on --query=none --seconds=300
测试图片与 JSON 均在 OS 临时目录;单文件 HTML 使用原始图片 data URI。 代码未提交、推送或发布,仍需完整客户端验收;前一阶段的首帧性能数字未重新测量, 不能把它们当作同步滚动更新后的精确性能结论。