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.7 KB
Raw Blame

#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>

通过的覆盖项:

  1. 首次进入贴底、滚动至历史;正文挂载 2–9 条,不计算占位壳。
  2. 连续五次大幅滚动,在每次滚动后的两帧检查视口,没有剩余空白占位。
  3. 异步正文增高、图片实际解码成功;当前阅读条目偏移误差不超过 2px。
  4. 顶部扩窗、搜索目标落入视口、宽窄窗口切换、Light / Dark。
  5. 组件重挂载、阅读时追加消息保持位置;此处重挂载没有模拟完整任务数据恢复。
  6. 长用户消息展开,滚离后仍展开,返回后状态保留。
  7. 点击返回底部、继续追加消息,底部误差不超过 2px。
  8. 键盘全选前恢复逻辑窗口全部正文,保持贴底。

逐阶段验证没有空视口、可见占位、行重叠或 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 已清理。