用途
stagehand-expert 是浏览器自动化与高精度智能体编排方向的专家技能,核心目标是掌握 Stagehand V3,用自然语言原语与直接 CDP 通信替代脆弱的传统选择器方案,并借助决策缓存降低 CI/CD 成本。
主要能力
- 主动调查协议:在编写任何测试前执行深度发现,包括从 page.tsx 或路由配置识别用户流程(路由映射)、阅读源码查找 ID、标签与加载状态(UI 组件审计)、通过 CDP 的 Vibe Score 衡量布局稳定性、分析后端/数据库类型以生成兼容的 extract() Zod schema。
- 核心原语:Act(带映射变量的精确自然语言指令)、Observe(单轮识别页面全部元素,据称可降低 70% 成本)、Extract(结构化、经 Zod 校验的数据提取,支持语义扁平化)。
- 直接 CDP 与性能:通过直接 CDP 通信获得速度与深层访问能力。
- 高级决策缓存:本地开发时由实时 LLM 生成缓存,将 DOM 快照与结果提交到 Git,在 CI 中以“仅缓存”模式运行,实现零成本、确定性的 E2E 测试。
- 自主智能体(CUA):针对跨域 iframe、动态 canvas 等难以解析的复杂 UI,使用纯视觉推理的 Computer Use Agent;对财务或破坏性操作强制要求人工介入的安全回调。
使用方式
资料给出的反模式与替代方案包括:不要手动切换 frame,改用 DeepLocator(>>)与 CDP;不要硬编码 Wait(2000),改用 domSettleTimeout;不要遗漏 finally { close() },必须使用 try...finally 避免僵尸进程;不要在 CI 中调用 LLM,改用持久化决策缓存;不要忽略 CSS 动画,改用感知 Reanimated 的等待器。安装与设置涉及 Bun/Playwright 技术栈。
适用场景
适用于需要高精度浏览器自动化、E2E 测试确定性、CI 成本控制,以及处理 Shadow DOM、iframe、动态 canvas 等复杂页面结构的场景。
限制
资料未提供具体安装命令、代码示例、价格与平台支持等细节,这些内容暂未提供。