SuperAPI AI 工具集

playwright-stealth-setup

测试与质量

查看项目

更新于 10-16 03:14

技能介绍

用途:在机器上幂等地安装并验证 CloakBrowser 隐身浏览工具链。CloakBrowser 是在 C++ 源码层应用指纹补丁的 Chromium 分支,通过 Playwright 驱动;需先装 pip 包装器,再单独下载补丁浏览器二进制。仅限授权使用:自动化自有或获授权测试的资产,遵守服务条款与 robots.txt,不得用于欺诈、凭据滥用、批量注册或绕过无权绕过的访问控制。

适用与不适用:环境缺失或损坏时使用,如 cloakbrowser 无法导入、二进制未下载、启动测试失败、macOS 拒绝打开、需添加许可证密钥。不用于执行浏览任务、创建身份或恢复会话,那属于 playwright-stealth 技能。

工作流:先探测,不做改动:python3 "${CLAUDE_SKILL_DIR}/scripts/setup_check.py"。查看 STATUS 行与 RESULT:。python、cloakbrowser_pkg、binary、launch 为必需,geoip_extra 为建议项。--json 输出机器可读结果;--quick 离线快速但跳过启动测试,不能返回 ok。仅在 RESULT: fail 时安装:python3 "${CLAUDE_SKILL_DIR}/scripts/setup_check.py" --install,会执行 pip install -U 'cloakbrowser[geoip]'、python -m cloakbrowser install(首次约 200 MB)、清除 macOS 隔离并重新探测。可选许可证:python3 -m cloakbrowser login,或导出 CLOAKBROWSER_LICENSE_KEY;不要把密钥写入仓库文件或作为可见命令行参数。完成后重跑探测,要求 RESULT: ok,并报告包装器版本、实际启动的 Chromium 版本与许可证层级。

限制与注意:cloakbrowser info 即使未安装也退出 0,需读 JSON 而非退出码。二进制受许可证限制,包装器为 MIT。Chromium 沙箱被禁用,--no-sandbox 是默认隐身参数的一部分。macOS 二进制被隔离,首次启动可能报“app is damaged”,--fix-quarantine 在签名验证后清除。无需 playwright install chromium,Linux 可能需 playwright install-deps chromium。要求 Python ≥ 3.11。厂商基准声明未复现,只报告诊断结果。升级后指纹漂移属正常,需重新基线。详见 references/toolchain.md。