用途:连接正在运行的原型,使用 CDP、Puppeteer 或 Playwright 做视觉与功能检查,产出 DISCOVERY_REPORT.md,记录当前布局、样式与行为。
主要能力与流程:
- 建立环境与连接:探测工作区或向用户询问本地 URL(如 http://localhost:3000、http://localhost:5173),确认服务在指定端口运行,启动本地 Playwright/Puppeteer 脚本或 CDP 工具;若未预配置,可在插件 scripts/ 或 temp/ 目录搭建简单的 Python Playwright 爬取脚本。
- 视觉 UX 审计:遍历各页面、标签、模态与抽屉;梳理关键 HTML 结构、表单输入、按钮类与容器层级;记录设计令牌(Tailwind 类、CSS 变量、布局模式、响应式断点);编目图片路径、自定义 SVG 图标与字体。
- 功能与行为审计:触发输入、点击、切换标签与模态;记录 HTTP 请求、API 端点、请求体、响应头与响应格式;追踪前端状态变化(React state、localStorage、session token);记录控制台日志、警告与错误。另含代码抢救审计:识别应保留的业务逻辑、领域模型、公式与正确 UI 布局,以及硬编码、模拟端点、不安全存储、未处理错误、架构瓶颈等需重构项。
- 报告:将 DISCOVERY_REPORT.md 写入 exploration/captures/ 或当前会话目录,内容含核心逻辑抢救与技术债分析、视觉布局与组件审计、行为与交互流日志、网络与 API 拦截、状态载荷结构、控制台与加载警告及延迟/性能。
适用场景:对原型或本地运行的前端应用做系统性 UI/UX 与行为盘点。
限制:需目标服务先行运行;实际脚本与运行环境未随资料提供,暂未提供默认配置;报告内容依赖实际爬取结果。