用途:为项目创建或刷新视觉测试清单(YAML manifest)。适用于首次视觉测试前、UI 路由变更后,或 sg-visual-run 报告缺少清单时。
主要能力:检测前端框架(Next.js App Router/Pages、React Router、Vue、Angular 等,无框架时回退静态 HTML 扫描);收集路由定义、导航结构、功能开关、表单/弹窗/上传/聊天等交互组件、测试数据与开发凭据;生成 visual-tests/_config.yaml、_shared/login.yaml 及各路由清单,并镜像导航层级建立目录。
用法:/sg-visual-discover 交互式检测变更并询问范围;/sg-visual-discover <path> 指定项目路径;--diff=<ref> 仅生成受影响路由;--all 跳过范围询问;--refresh-existing 刷新可刷新清单;--all --refresh-existing 全量发现并刷新。--all 与 --diff 不可同时使用。运行前需确认 agent-browser --version 可用。
限制:仅覆盖带 auto-generated 标签且 generated_by: sg-visual-discover 的清单,手写清单永不覆盖;不删除清单,路由消失时标记 deprecated: true;刷新前写 .bak 备份。动态路由需具体参数值,否则生成导航步骤或标记 todo。推荐使用 Sonnet 4.6 模型。具体收费、平台与效果资料暂未提供。