Voyager Web 自动化探索与端到端测试驾驶舱

Voyager Web 自动化探索与端到端测试驾驶舱

@nagi-ovo/voyager·v2.2.0·tools

基于 Playwright 深度封装的浏览器交互与 Web 自动化套件。赋予智能体真实浏览网页、表单输入、按钮点击、多标签管理与视觉回归捕获能力,支持无人值守端到端测试。

Web自动化 · Playwright · 端到端测试 · RPA机器人

GitHubNPM
快速安装与集成
bash
manager:
$ pnpm add @nagi-ovo/voyager

架构解析

「Voyager Suite」是智能体连接动态现代 Web 应用的强力外骨骼。面对复杂的企业内部中台、需要登录验证的 SaaS 系统或具备复杂拖拽交互的前端页面,纯 HTTP 请求完全无法模拟真实行为。 本套件通过在 Cordis 中挂载专用的浏览器控制总线,支持智能体像真人一样观察网页可交互元素。插件不仅会自动计算 DOM 元素的无歧义定位器(CSS / XPath / ARIA),还支持多页面并发操作、网络流量拦截监控以及自动录制端到端测试用例,让全自动化 Web 巡检轻松实现。

核心特性

01

Playwright 工业级自动化内核:稳定驱动 Chromium、WebKit 与 Firefox 浏览器

02

无障碍 ARIA 语义化定位:优先采用屏幕阅读器语义选择器,抗前端重构变动

03

全流程 Trace 录制与回溯:自动化保存操作录屏、网络包与控制台错误堆栈

04

并发多标签与多窗口调度:支持跨页面跳转、第三方 OAuth 登录弹窗平滑处理

核心机制

01

浏览器沙箱拉起

启动隔离的 Chromium/Firefox 进程,初始化干净的上下文会话。

02

可操作元素定位

分析页面无障碍树,计算稳固的语义定位器并高亮目标控件。

03

拟人化交互执行

按需触发点击、文本键入、滚动页面与多文件选择上传动作。

04

页面状态断言

捕获页面截屏并断言网络响应状态码,记录完整回放链路。

配置参数参考 (YAML / JSON)

参数名类型默认值说明
headlessbooleantrue是否以无界面无头模式启动浏览器
recordVideobooleanfalse是否开启交互动作全屏高清视频录制
viewportWidthnumber1280浏览器视口默认宽度(像素)