用途:在 UI 变更发布前进行自动化视觉验证。该技能在检测到 static/* 文件修改后触发,捕获截图、与基线对比,并交由 AI 评估,判断界面是否出现视觉回归,避免仅凭人工目测确认。
主要能力:使用 Peekaboo 捕获像素级截图,支持全屏与指定窗口两种模式并支持 Retina;将新截图与 ~/.maggy/visual-verify/ 下最近的基线(上一次 after-*.png)进行前后对比;由 Gemini Flash 分析截图并给出 CLEAN 或 REGRESSION_DETECTED 报告及具体问题;与 auto-review-hook、E2E testkit(POST /api/testkit/run)、build-in-public 插件集成,后者用真实截图替代 AI 生成图片。
使用方式:安装命令为 brew install steipete/tap/peekaboo。全屏截图:peekaboo image --mode screen --retina --path /tmp/screen.png;指定窗口截图:peekaboo image --mode window --app "Google Chrome" --path /tmp/window.png。修改 static/ 文件后的流程为:git add maggy/maggy/static/ 并查看差异,重启服务 lsof -ti :8080 | xargs kill && python3 -m maggy.main &,用 curl -s http://localhost:8080/api/health 等待健康检查,再捕获带时间戳的截图并对比基线,最后执行 ~/bin/gemini-api --flash "Analyze this screenshot for visual regressions"。也可一键验证:curl -s http://localhost:8080/api/health && peekaboo image --mode screen --path ~/.maggy/visual-verify/verify.png && echo "✓ Dashboard verified — screenshot at ~/.maggy/visual-verify/verify.png"。
适用场景:static/ 变更后、提交 UI 改动前、审查仪表盘、跨浏览器检查(如 --app "Safari"),以及 build-in-public 发帖配图。
限制:资料未提供 Gemini Flash 的评估阈值细节、准确率、价格与支持平台等信息;对比依赖已有基线截图,首次运行缺少历史基线,且像素差异阈值仅在 E2E testkit 处提及但未给出具体数值,均暂未提供。