Gstack

核心用法

gstack 是一个基于持久化 headless Chromium 的浏览器自动化工具，专为 QA 测试和站点验证设计。首次启动约 3 秒，后续每条命令仅 100-200ms。通过 $B <command> 调用已编译二进制文件，支持导航、表单交互、元素断言、截图对比、响应式布局测试等完整工作流。

关键命令：

• 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 测试场景下的双向风险

gstack是一款面向Claude Code环境的浏览器自动化技能，基于Playwright构建持久化无头Chromium实例，主打~100ms指令响应速度。核心功能涵盖页面导航、元素交互（点击/填充/悬停）、可视化断言（visible/enabled/checked等）、diff对比、响应式截图及文件上传测试。

显著优点：①极速响应，首次启动约3秒后进入100-200ms指令延迟，支持复杂多步流程的chain批量执行；②开发者体验优秀，snapshot系统通过@e引用机制消除CSS选择器猜测，-D差分模式直观展示操作前后变化，-a注解截图自动生成带红框标注的证据图；③真实场景适配强，支持从Chrome/Arc/Brave等浏览器导入cookies实现免登录测试，对话框自动接受避免阻塞，responsive命令一键生成三端截图。

潜在局限：①依赖本地Chromium二进制，首次setup需10秒且要求bun运行时环境；②状态持久化设计（30分钟空闲自动关闭）在长时间跨会话测试中需关注cookie/session过期；③T3社区来源等级，虽经CLS认证A级无安全威胁，但企业敏感环境建议评估供应链风险；④无内置重试与等待策略的显式封装，复杂异步加载页面需手动组合wait命令。

适合人群：前端开发者进行部署验证、QA工程师构建回归测试流、产品经理dogfood新功能、技术支持快速复现用户bug。特别适合需要"导航→交互→截图→断言"标准化证据链的敏捷团队。

常规风险：①测试目标网站的XSS/恶意脚本可能通过浏览器实例影响本地环境（Playwright沙箱已缓解）；②cookie-import-browser功能涉及敏感凭证处理，建议在受信任设备使用；③截图与页面内容可能包含用户隐私数据，需遵循GDPR/CCPA合规要求。