技能介绍

解决什么问题

手写 Playwright 脚本时，只要站点启用反爬，常见问题会立刻出现：无头浏览器指纹被识别、登录前弹出验证码、多个 Chromium 会话各自维护一套中间件。每换一个目标站点，就要把 stealth 参数、验证码处理、请求拦截重写一遍，代码重复且难以维护。这个技能的价值在于把这些能力从业务脚本里剥离出来，作为可复用的插件层，让 agent 不必每次从零拼装。

它是怎么做的

核心是在 Microsoft Playwright 之上加一层插件架构，能力以插件形式注册，多个 Chromium 会话共享同一套中间件：

Stealth 对抗：提供现成的指纹规避能力，覆盖常见的无头检测点
CAPTCHA 处理：把验证码识别与处置封装成插件，而不是散落在各脚本里
自定义浏览器钩子：在浏览器生命周期的关键节点插入逻辑，统一处理请求、响应与页面行为

关键步骤大致是：继承插件基类，实现需要的钩子或能力，再挂载到浏览器自动化实例上；后续会话直接复用同一套配置。插件 API 沿用 puppeteer-extra 的设计，熟悉 PuppeteerExtraPlugin 基类文档的人可以很快上手，也欢迎提交新的插件。

适用边界与注意点

它不是万能的反爬方案。指纹规避只是提高被识别的成本，站点策略升级后插件同样可能失效；验证码插件通常依赖第三方服务，需要考虑可用性与成本。插件基类与 API 源自 puppeteer-extra 生态，迁移到 Playwright 时行为细节可能不一致，建议先在小范围真实目标上验证。涉及登录态、付费内容的场景，还要自行确认合规边界。