SuperAPI AI 工具集

control-ui

通用与其它

查看项目

更新于 10-16 09:51

技能介绍

用途:用本地浏览器自动化来验证 UI 行为,并留下可核查的证据。适用于复现依赖真实浏览器焦点、键盘输入、滚动、缩放或渲染的 UI 缺陷;用截图与快照核对视觉或无障碍改动;在发布前检查本地 Web、IDE 或 Electron 的行为;采集控制台日志、网络日志、CPU 性能剖析、trace 或堆快照;为 verify-this 制作前后对比证据。

主要能力:优先复用仓库自带的 Playwright、浏览器或 Electron 测试工具;若不存在,则在应用 dev server 或 Chromium 调试端口周围临时搭建本地工具。可通过 CDP 使用性能分析(CPU 剖析、trace、绘制闪烁、帧率、布局偏移)、内存(堆快照、强制 GC)、网络(请求拦截、限速、禁用缓存、请求日志)、渲染(视口调整、配色方案模拟、减弱动效、无障碍检查)与调试(控制台流、异常捕获、DOM 快照)等底层能力。

使用方式:先用仓库文档中的开发命令在本地启动应用;查找已有测试工具(Playwright 测试、Cypress 规范、Storybook、浏览器脚本、Electron 启动脚本或快照工具)。Web 应用用现有浏览器工具连接本地 URL;Electron/Chromium 在支持时开启远程调试端口,通过 chromuim.connectOverCDP 连接。按稳定应用标记而非标签顺序选择页面,优先使用无障碍角色、标签和稳定的 data-* 选择器而非坐标。交互遵循单步循环:先截图/快照,选目标,执行一次结构操作,再重新截图,验证状态变化,必要时保存前后对比产物。

限制:不要仅为探测而把 Playwright 加为项目依赖,除非用户要求;不要在导航或结构变化后依赖过期的元素引用;除非点击前刚截图,避免坐标点击;测试数据保持本地可丢弃;未经用户明确同意,不要保存隐私敏感工作区的截图或堆快照;不要硬编码其他仓库的选择器、端口或脚本路径,应发现当前仓库的本地标记;完成后清理开发服务器、调试会话和临时配置。仅当高层浏览器 API 不足时才使用原始 CDP。