用途:在启动开发服务器后,用 agent-browser 做浏览器端验证,确认页面真正可用,而不是仅凭进程启动就继续后续工作。
主要能力:打开本地地址并等待网络空闲;截图做视觉检查;读取控制台错误;检查框架错误浮层(Next.js、Vite、webpack-dev-server);判断页面是否空白;快照交互元素;在页面卡住时结合服务端日志排查。
基本用法: agent-browser open http://localhost:3000 agent-browser wait --load networkidle agent-browser screenshot --annotate agent-browser eval 'JSON.stringify(window.__consoleErrors || [])' agent-browser snapshot -i
验证清单包括:页面加载无超时、非空白、无错误浮层、无控制台错误、关键元素渲染、导航可用。失败时截图错误状态、记录浮层或控制台输出、关闭浏览器、修代码后重试,最多两轮以免死循环。
卡住排查:截图卡住状态,检查未完成的网络请求与控制台,再查看服务端日志(如 vercel logs --follow、npx workflow inspect runs、npx workflow health),将浏览器现象与服务端证据对应,例如一直转圈但无函数调用、函数超时 504、缺少环境变量等。
限制:资料未提供安装方式、支持平台、收费与价格信息;验证依赖 agent-browser 与本地开发服务器,重试次数有限。