SuperAPI AI 工具集

meticulous-simulate-and-diff

测试与质量

查看项目

更新于 10-15 17:12

技能介绍

用途:对指定线上 URL 运行一次 Meticulous 会话模拟,并对结果进行视觉分析,定位界面变化及其原因。

主要能力:支持两种模式。提供 baseReplayId 时进入 diff 模式,逐张截图报告像素不匹配率并与阈值比较(PASS/FAIL),可在本地 diffs 目录查看高亮差异图;不提供时进入 quick-check 模式,仅存储截图供人工目视检查,无法做差异分析。输出中会给出云端查看模拟与对比的链接。

使用方式:先准备 sessionId 与 appUrl(本地开发服务器,或留空使用原始录制 URL),可选提供 baseReplayId。运行前建议先执行 meticulous-cli-update 技能确保 CLI 与技能为最新(同一对话中已执行则跳过)。diff 模式命令:meticulous simulate --sessionId=<sessionId> --appUrl=<url> --baseReplayId=<baseReplayId> --headless;quick-check 模式省略 --baseReplayId。随后从 stdout 的 View simulation 链接提取 headReplayId,用 ls -lt ~/.meticulous/replays/ | head -5 定位最新回放目录,检查 diffs 目录中的差异图与 screenshots 下 .metadata.json 中的 before.dom、before.routeData.url 字段,对比 DOM 增删、class 与文本变化,并判断是结构性还是纯视觉变化。

适用场景:验证某次改动是否造成界面回归,快速定位受影响的页面路由与组件,并在最后通过 meticulous agent submit-feedback 提交反馈。

限制:缺少 baseReplayId 时无法做差异对比,只能目视检查,后续可重跑并指定基础回放补齐;无基础回放时步骤 3–5 不适用。其他细节资料未提供。