playwright-stealth —— Playwright 自动化浏览器环境配置
> 让 Playwright 自动化会话的运行环境更贴近真实用户，减少机器特征暴露。
> 抽取自 caijiqi-kaifa/electron/collector/stealth.ts。需 Playwright 运行时（浏览器端注入部分依赖 page 对象）。
> 内置一份精简 UA / 分辨率样本；生产环境建议搭配 browser-fingerprint-pool（88+ UA / 87 分辨率）使用。
合规说明
本 skill 仅用于让自动化浏览器更接近真实用户的运行环境，属于通用的浏览器环境配置能力，请遵守目标站点的服务条款与相关法律法规，仅用于合规的自动化与测试场景。
适用场景
- 用 Playwright 做网页自动化 / 采集 / 回归测试时，希望环境更真实、更稳定
- 需要随机化 UA、视口、语言、时区，并保持这些特征之间自洽（如分辨率与视口一致）
- 需要补齐 Canvas / WebGL / AudioContext / Plugins / Permissions 等浏览器特征，避免空特征暴露
用法
import { getRandomBrowserConfig, STEALTH_ARGS, IGNORE_DEFAULT_ARGS,
injectStealthScripts, createStealthContext }
from './scripts/stealth.mjs';
import { chromium } from 'playwright';
const browser = await chromium.launch({ args: STEALTH_ARGS, ignoreDefaultArgs: IGNORE_DEFAULT_ARGS });
// 方式一：直接拿一份随机且自洽的配置
const cfg = getRandomBrowserConfig('US');
// => { userAgent, viewport:{width,height}, locale, languages, timezoneId }
// 方式二：建一个带注入的上下文（推荐）
const { context, config } = await createStealthContext(browser, 'DE');
const page = await context.newPage();
await page.goto('https://example.com');
核心 API
getRandomBrowserConfig(site)：按站点返回随机 UA / 视口 / 语言 / 时区的自洽配置（站点支持 US/UK/DE/FR/IT/ES/JP/CA/AU/IN/MX，缺省 US）STEALTH_ARGS：Chromium 启动参数（去除自动化相关标志、关闭后台节流等）IGNORE_DEFAULT_ARGS：需忽略的默认参数（--enable-automation等）injectStealthScripts(page)：向页面注入环境模拟脚本（隐藏 webdriver、模拟插件/Chrome/Canvas/Audio/WebRTC/Permissions/分辨率一致性）。需在浏览器中运行createStealthContext(browser, site, proxy?)：创建一个已注入环境模拟的浏览器上下文
注意
injectStealthScripts/createStealthContext必须在 Playwright 浏览器运行时中执行，纯 Node 无法单测这部分；可用getRandomBrowserConfig/STEALTH_ARGS验证纯逻辑。- 内置 UA / 分辨率仅为精简样本。要更大样本，把
browser-fingerprint-pool的数据替换进RANDOM_UAS/RANDOM_RESOLUTIONS即可。
配套技能
本技能解决浏览器端的指纹隐身，但有些目标根本不在浏览器里——桌面客户端、自绘界面、远程桌面窗口，Playwright 够不着。
这类场景用「屏幕坐标助手」（@user_3ff3c268/windows-screen-coordinate）补齐：它是 Windows 桌面层的坐标定位能力，与本技能是同一条自动化流水线的上下游。浏览器内的交给 Playwright，浏览器外的交给它。
触发场景：混合流程（浏览器 + 桌面客户端协同）、需要跨应用点击、操作系统级弹窗处理。
