用途:flow-diff 用于对比流程(flow)的最新 walk 快照与之前运行,识别回归与改进,包括状态变化、耗时变化、新增或移除步骤,以及视觉差异。
主要能力:
- 查找快照:列出 .flowchad/snapshots/*-{flow-name} 并排序,至少需要 2 个快照才能对比;若只有 1 个,会提示用户修改后再次 walk。
- 加载结果:读取最近两个快照的 results.json,使用 --history N 时读取 N 个。
- 逐步对比:比较 status 字段(任何 pass↔fail、pass↔error 变化都会告警);比较 timing_ms,比上次慢超过 50% 视为耗时回归,快超过 25% 视为改进;新失败、已修复、新增步骤、移除步骤都会标注。
- 视觉对比:对状态变化或耗时差异显著的步骤,并排展示前后截图,并描述视觉差异,例如按钮被禁用、出现错误弹窗、加载动画卡住。
- 趋势分析:使用 --history 时跟踪耗时趋势与通过率趋势,例如 DEGRADING 或 UNSTABLE。
- 输出报告:打印 diff 报告,包含 Regressions、Improvements、Unchanged 和 Summary 表格,并建议使用 /flow-report <flow-name> 做详细分析。
使用方式: /flow-diff sign-up /flow-diff sign-up --history 5
适用场景:在修改流程后检查是否引入回归、观察多次运行的耗时与稳定性趋势、定位失败步骤并查看前后截图差异。
限制:需要至少两个快照才能进行对比;耗时回归与改进的阈值分别为 50% 和 25%;资料未提供安装方式、收费、平台支持或其他配置细节。