Playwright 反检测环境配置

问题背景

用 Playwright 跑采集或回归测试时，Chromium 默认会带上 --enable-automation、navigator.webdriver === true 等特征；视口、UA、时区若长期固定，也容易被风控当成脚本流量。更麻烦的是部分站点会读 Canvas、WebGL、插件列表、Permissions 等 API——空实现或缺省值往往比「普通用户」还显眼。

技能做了什么

本技能把一套环境伪装拆成可组合的模块，思路来自 caijiqi-kaifa/electron/collector/stealth.ts：

• getRandomBrowserConfig(site)：按站点（US/UK/DE/FR/IT/ES/JP/CA/AU/IN/MX，缺省 US）生成自洽的 UA、视口、语言、时区，避免「分辨率写的是 1920×1080、视口却是 800×600」这类穿帮。
• STEALTH_ARGS / IGNORE_DEFAULT_ARGS：启动层去掉自动化相关标志、并处理后台节流等 Chromium 参数。
• injectStealthScripts(page) 与 createStealthContext(browser, site, proxy?)：在浏览器运行时向页面注入脚本，覆盖 webdriver 暴露、插件/Chrome 对象、Canvas/Audio/WebRTC/Permissions，并尽量保持与所选分辨率一致。

内置 UA 与分辨率只是精简样本；若要更大池子，可把 browser-fingerprint-pool 的数据替换进 RANDOM_UAS / RANDOM_RESOLUTIONS。

边界与注意

• injectStealthScripts、createStealthContext 必须在 Playwright 浏览器进程里执行，纯 Node 侧无法单测注入逻辑；getRandomBrowserConfig 与启动参数可在 Node 侧单独验证。
• 技能目标是让环境更接近真实用户，不保证绕过任意反爬；请遵守目标站点条款与适用法律，仅用于合规自动化与测试。
• 生产环境若需要 88+ UA、87 分辨率量级，建议与 browser-fingerprint-pool 搭配，而不是只依赖内置样本。