Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

7.0 KB
Raw Blame

#5406:增强滚动测试与补修

后续继续定位、搜索与回底的补修以及最终三轮复测,见 NAVIGATION-VALIDATION.md。以下保留此前未通过的阶段记录。

2026-10-03,Windows Electron 41.10.3,真实 MessageStream、真实布局/字体/主题,合成数据, 独立 profile,无后端与用户数据。没有启动或替换正在运行的正式客户端。

本轮实际发现

上一轮“18 张稳定截图正常”不足以说明滚动过程没有瞬时异常。更密集的采样发现:

  1. 快速滚轮/滚动条拖动时,初版 hook 将挂载推迟到下一个 rAF,视口可先出现空占位。 6GROaj 共 3,061 次采样,其中 274 次含占位:96 次发生在快滚/真实拖动,178 次在强制脚本跳跃。
  2. 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。 代码未提交、推送或发布,仍需完整客户端验收;前一阶段的首帧性能数字未重新测量, 不能把它们当作同步滚动更新后的精确性能结论。