Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
#5406:视口挂载方案与画面验收
后续逐帧滚动压力测试发现了稳定截图未覆盖的瞬时闪空,以及长历史回底目标过期问题。 已补修真实滚动/回底路径;直接在 rAF 中改 scrollTop 的诊断负载仍有空帧。 当前结论以 增强滚动测试 为准,不应将本文旧结果解读为任意滚动时序无异常。
2026-10-03,基线 d656b0fc1ec3e04548cd018654cbd6486f6cf839。
本报告接续 首次止崩验证,后者的 236ms 是上一阶段方案的代价。
实现
采用视口挂载与普通布局,根据消息条目和状态生命周期管理正文挂载范围:
useMessageViewport只挂载视口上下各 600px 范围内的历史普通消息正文; 其他正文使用实测高度占位,未测量时估计 240px。占位保留稳定条目 key 与定位 id。- 沿用既有逻辑尾窗、向前扩窗、搜索定位与滚动快照。恢复时读取已有高度缓存; 正文与占位切换时按阅读锚点补偿;贴底时保持尾部位置。
- 工具/计划等复杂卡片、系统卡、流式消息、搜索目标保持挂载。 点击或获得焦点的消息在本次 MessageStream 生命周期内保留,保护展开、编辑与媒体状态。
- 分享选择模式挂载当前逻辑窗口的全部正文。Tab、Ctrl/Cmd+A 或非空文本选择也会保留全部 已加载正文,直到组件重挂载,优先保证键盘遍历与选择;因此并非任何操作后都维持低挂载数。
- 消息行仍使用
content-visibility: visible/contain-intrinsic-size: none。 没有关闭无障碍、更新 Electron 或缩减存储/加载的消息数量。
复杂卡片保留挂载,已交互消息也不会回收; 长时间浏览时的挂载数量可以增加。浏览器原生全文查找不能依赖已卸载的正文; 应用自身基于消息数据的搜索定位继续将目标挂载。
画面和交互
visual.cjs 驱动真实 Electron 中的正式 MessageStream / UserMessage / AssistantMessage,
使用真实主题、字体及 CSS,输入 200 条合成消息;没有后端、账号或真实用户消息。
这属于真实组件集成验收,不等同于完整已安装客户端的验收。
运行命令:
node apps/desktop/scripts/ax5406/run.mjs --scenario=component --workload=visual --rows=200 --ax=off --query=none --seconds=120
node apps/desktop/scripts/ax5406/visual-gallery.mjs <AX5406_ARTIFACTS>
通过的覆盖项:
- 首次进入贴底、滚动至历史;正文挂载 2–9 条,不计算占位壳。
- 连续五次大幅滚动,在每次滚动后的两帧检查视口,没有剩余空白占位。
- 异步正文增高、图片实际解码成功;当前阅读条目偏移误差不超过 2px。
- 顶部扩窗、搜索目标落入视口、宽窄窗口切换、Light / Dark。
- 组件重挂载、阅读时追加消息保持位置;此处重挂载没有模拟完整任务数据恢复。
- 长用户消息展开,滚离后仍展开,返回后状态保留。
- 点击返回底部、继续追加消息,底部误差不超过 2px。
- 键盘全选前恢复逻辑窗口全部正文,保持贴底。
逐阶段验证没有空视口、可见占位、行重叠或 renderer JavaScript 错误,保存原始截图与坐标。 人工查看浅色正文/图片、深色窄窗、展开长消息与深色尾部,没有发现新增的文字重叠、 异常裁切或错位。截图中的黄色/棕色背景是既有搜索定位高亮。 450ms 后的稳定截图不证明任意中间帧都没有闪动;快速滚动另有两帧检查。
初轮增强脚本曾未触发图片/展开操作:增长后的助手正文占满视口、选中的用户正文不够长。
修正为先定位图片所在消息、显式增长用户正文后点击真实展开按钮,保留失败产物 KOk7uy,
没有删除断言。修正后 sneAxU、D4TDRW、rmaKWj 均通过;最终图集另记录于交付结果。
最终源码重新构建的 izEs2v 再次通过全部检查,共 18 张稳定状态截图和五次快速滚动检查。
component-sources.json 中 hook SHA-256 与工作区文件一致:
842e124233eb2b95933824b3b4a9594154ec55ff6a3ba669c085740de5f57360。
单文件图集位于该产物目录的 visual-report.html。
原生崩溃压力验证
以下均为修复后的真实组件冻结构建 KOk7uy,AX 开启、消息行样式来自生产 CSS。
相比最终代码,此构建仅缺少“首帧范围已吻合时,首次滚动仍补偿锚点”的边界修正及注释调整;
该边界另有 hook 回归测试和最终截图复跑。
| 负载 | 时长 | 文本更新 | 查询 | 结果/产物后缀 |
|---|---|---|---|---|
| 流式/结束循环、随机滚动、UIA + CDP | 121,277ms | 11,760 | 194 次 CDP;1,001 次原生行范围查询 | 未崩溃,无 dump / JS 错误;Bulsr3 |
| 持续更新助手正文、随机滚动、无主动查询 | 120,548ms | 10,296 | 正常 AX 生命周期 | 未崩溃,无 dump / JS 错误;w0DrUP |
共 22,056 次更新。第一轮 UIA 还记录 47 次“模式不可用”:它先枚举支持 TextPattern 的节点, 再取模式,期间列表正在动态挂载/卸载。保留这些记录,不能宣称零查询错误或完整读屏功能验收。 旧版同签名阳性对照见 组件复现 与 选择性 auto 实验。 有界压力验证不能证明所有负载永不崩溃;原 Issue 0.1.96 现场 dump 仍缺失。
最终源码 izEs2v 冻结构建又跑了 60,263ms 的 AX + UIA + CDP 循环压力测试,
5,728 次更新、105 次 CDP、613 次原生行范围查询,无崩溃、dump 或 JS 错误,产物 BaJeGL。
UIA 模式不可用记录 27 次,限制同上。三轮累计 27,784 次文本更新。
首帧对照
benchmark-component.mjs BwfjZy KOk7uy,同机交替三轮,AX 均关闭,200 条数据、尾窗 80 条,
只更新最后一条助手消息,不滚动。此前 fixture 把 40 条历史助手消息都标为 streaming,
新方案会保留它们;因此该基准的新方案实际仍挂载约 42 条正文,不是正常浏览的 2–9 条。
旧冻结构建与新版共享消息生成和 steady 负载;新版 fixture 另加入视觉操作分支和深色主题导入,
属于组件方案对照,不能视为只有 hook 指令不同的微基准。
| 方案 | 三轮首次内容绘制(ms) | 中位数 |
|---|---|---|
| 第一阶段:普通布局、全部 80 条正文挂载 | 1004 / 1072 / 1012 | 1012 |
| 本阶段:普通布局、按视口挂载并保留 streaming | 848 / 848 / 888 | 848 |
减少 164ms,约 16.2%。这个数包含独立页模块、字体和首次组件加载,不是客户端任务切换延迟。
六轮均正常退出,原始数据在 cindy-ax5406-benchmark-b0v9PS/results.json。
滚动锚点最后的小修正在这组测量之后;未将不同阶段的数字混称最终源码精确性能门禁。
自动检查和范围
- 9 个相关测试文件共 105 项通过,1 项原有 focused-only 50k 压测跳过。 新增 hook 用例覆盖挂载范围、占位高度、阅读恢复、首次滚动补偿、交互保留、分享与键盘选择。
- Desktop 类型检查、dump 签名解析器、脚本语法检查、
git diff --check。 - 原始截图/dump/构建产物放在 OS 临时目录,不提交到工程;图集是内嵌截图的单文件 HTML。
- 未验证完整客户端账号流程、复杂工具卡各自的完整交互、macOS 或移动端原生页面。
- 本次未提交、推送或发布;正在运行的正式 Cindy 不会因 worktree 改动自动生效。
- 测试结束后确认本次 AX5406 Electron 进程已全部退出,独立 profile 已清理。