极速无头浏览器 · QA测试利器

Fast headless Chromium (~100ms/command) for QA testing, site dogfooding and end-to-end automation with screenshots, diffs, and assertions.

基本信息

• 技能名称?Gstack
• 中文名称?极速无头浏览器 · QA测试利器
• 作者?ovyeddeno
• 分类?其他
• 版本?1.0.0
• 标签?browser-automation, qa-testing, headless-chromium, screenshot, e2e-testing, dogfooding, devtools

使用方法

使用说明
核心用法
gstack 是一个基于持久化 headless Chromium 的浏览器自动化工具，专为 QA 测试和站点验证设计。首次启动约 3 秒，后续每条命令仅 100-200ms。通过 $B 调用已编译二进制文件，支持导航、表单交互、元素断言、截图对比、响应式布局测试等完整工作流。
关键命令：
goto / snapshot / screenshot — 导航与页面捕获
snapshot -i — 生成交互元素索引（@e1, @e2 等），后续可用 @eN 直接操作
snapshot -D — diff 对比，验证操作前后变化
is visible/enabled/checked — 状态断言
fill / click / upload / select — 表单与文件交互
responsive — 一键生成移动端/平板/桌面三尺寸截图
chain — JSON 管道批量执行，适合长流程
显著优点
极速 ：~100ms/命令，远超传统 Puppeteer/Playwright 脚本
状态持久 ：cookies、登录会话、标签页跨调用保留
智能索引 ： snapshot -i 自动生成可引用编号，告别脆弱 CSS 选择器
内置断言 ： is 命令直接验证元素状态，无需解析文本
证据链完整 ：标注截图 + diff + 控制台日志，Bug 报告一站式产出
响应式测试 ：内置 viewport 切换和多尺寸截图
真实浏览器 cookies ：支持从 Chrome/Arc/Brave/Edge 直接导入登录态
潜在缺点与局限
初始构建依赖 ：首次使用需 bun 环境和 ~10 秒编译
CLI 而非代码 ：适合快速验证，复杂逻辑需配合 chain 或外部脚本
无录制回放 ：相比 Playwright codegen，需手动编写命令序列
单会话限制 ：30 分钟闲置自动关闭，超长测试需设计断点
dialog 默认自动接受 ：虽防锁死，但可能错过关键确认交互的测试覆盖
适合人群
需要快速验证部署的前端/全栈开发者
负责回归测试的 QA 工程师
需要截图证据提交 Bug 的产品或设计人员
进行站点 dogfooding 的团队成员
常规风险
敏感信息泄露 ： header 命令虽自动脱敏，但截图和 HTML 导出仍可能含 PII
生产环境误操作 ：自动化点击/填写可能触发真实订单或删除，建议在 staging 执行
Cookie 同步风险 ：从真实浏览器导入 cookies 可能携带未预期的登录态或追踪标识
JS 执行安全 ： js 和 eval 命令直接执行页面上下文代码，需警惕 XSS 测试场景下的双向风险