@skrillex1224/playwright-toolkit 2.1.24 → 2.1.26

package/README.md

@@ -23,7 +23,7 @@ import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
 await Actor.init();
 
 // 初始化工具箱
-const { ApifyKit: KitHook, Launch, AntiDetect, Humanize, Captcha, LiveView, Constants } = usePlaywrightToolKit();
+const { ApifyKit: KitHook, Launch, AntiCheat, Humanize, Captcha, LiveView, Constants } = usePlaywrightToolKit();
 
 // ⚠️ ApifyKit 需要异步初始化
 const ApifyKit = await KitHook.useApifyKit();
@@ -39,7 +39,7 @@ const crawler = new PlaywrightCrawler({
     preNavigationHooks: [
         async ({ page }) => {
             // 统一反爬：时区/语言/权限/视口
-            await AntiDetect.applyPage(page);
+            await AntiCheat.applyPage(page);
             
             // 验证码监控
             Captcha.useCaptchaMonitor(page, {
@@ -77,32 +77,32 @@ await Actor.exit();
 
 ### 架构
 
-| 层次 | 问题 | 解决方案 |
-|------|------|----------|
-| **指纹层** | UA/屏幕/语言/时区一致性 | Crawlee `useFingerprints` + `AntiDetect` |
-| **行为层** | 机械输入/点击/滚动 | `ghost-cursor-playwright` + Humanize |
-| **页面层** | 验证码/风控检测 | Captcha 监控器 |
+| 层次       | 问题                    | 解决方案                                |
+| ---------- | ----------------------- | --------------------------------------- |
+| **指纹层** | UA/屏幕/语言/时区一致性 | Crawlee `useFingerprints` + `AntiCheat` |
+| **行为层** | 机械输入/点击/滚动      | `ghost-cursor-playwright` + Humanize    |
+| **页面层** | 验证码/风控检测         | Captcha 监控器                          |
 
 ### API 一览
 
-| 模块 | 方法 | 说明 |
-|------|------|------|
-| `Launch` | `getAdvancedLaunchOptions()` | 增强版启动参数 |
-| `Launch` | `getLaunchOptions()` | 基础启动参数 |
-| `Launch` | `getFingerprintGeneratorOptions()` | 指纹生成器选项 |
-| `AntiDetect` | `applyPage(page, options?)` | 应用时区/语言/权限/视口 |
-| `AntiDetect` | `applyContext(context, options?)` | 仅应用 Context 设置 |
-| `AntiDetect` | `syncViewportWithScreen(page)` | 同步视口与屏幕 |
-| `AntiDetect` | `getTlsFingerprintOptions(userAgent?)` | got-scraping TLS 指纹 |
-| `Humanize` | `initializeCursor(page)` | 初始化 Cursor (必须先调用) |
-| `Humanize` | `jitterMs(base, jitterPercent?)` | 生成带抖动的毫秒数 (同步，返回 number) |
-| `Humanize` | `humanType(page, selector, text, options?)` | 人类化输入 (baseDelay=180ms ±40%) |
-| `Humanize` | `humanClick(page, selector, options?)` | 人类化点击 (reactionDelay=250ms ±40%) |
-| `Humanize` | `warmUpBrowsing(page, baseDuration?)` | 页面预热 (3500ms ±40%) |
-| `Humanize` | `naturalScroll(page, direction?, distance?, steps?)` | 自然滚动 (带惯性+抖动) |
-| `Humanize` | `simulateGaze(page, baseDurationMs?)` | 模拟注视 (2500ms ±40%) |
-| `Humanize` | `randomSleep(baseMs, jitterPercent?)` | 随机延迟 (±30% 抖动) |
-| `Captcha` | `useCaptchaMonitor(page, options)` | 验证码监控 |
+| 模块        | 方法                                                 | 说明                                   |
+| ----------- | ---------------------------------------------------- | -------------------------------------- |
+| `Launch`    | `getAdvancedLaunchOptions()`                         | 增强版启动参数                         |
+| `Launch`    | `getLaunchOptions()`                                 | 基础启动参数                           |
+| `Launch`    | `getFingerprintGeneratorOptions()`                   | 指纹生成器选项                         |
+| `AntiCheat` | `applyPage(page, options?)`                          | 应用时区/语言/权限/视口                |
+| `AntiCheat` | `applyContext(context, options?)`                    | 仅应用 Context 设置                    |
+| `AntiCheat` | `syncViewportWithScreen(page)`                       | 同步视口与屏幕                         |
+| `AntiCheat` | `getTlsFingerprintOptions(userAgent?)`               | got-scraping TLS 指纹                  |
+| `Humanize`  | `initializeCursor(page)`                             | 初始化 Cursor (必须先调用)             |
+| `Humanize`  | `jitterMs(base, jitterPercent?)`                     | 生成带抖动的毫秒数 (同步，返回 number) |
+| `Humanize`  | `humanType(page, selector, text, options?)`          | 人类化输入 (baseDelay=180ms ±40%)      |
+| `Humanize`  | `humanClick(page, selector, options?)`               | 人类化点击 (reactionDelay=250ms ±40%)  |
+| `Humanize`  | `warmUpBrowsing(page, baseDuration?)`                | 页面预热 (3500ms ±40%)                 |
+| `Humanize`  | `naturalScroll(page, direction?, distance?, steps?)` | 自然滚动 (带惯性+抖动)                 |
+| `Humanize`  | `simulateGaze(page, baseDurationMs?)`                | 模拟注视 (2500ms ±40%)                 |
+| `Humanize`  | `randomSleep(baseMs, jitterPercent?)`                | 随机延迟 (±30% 抖动)                   |
+| `Captcha`   | `useCaptchaMonitor(page, options)`                   | 验证码监控                             |
 
 ---
 

package/dist/index.cjs

@@ -351,8 +351,8 @@ var Utils = {
   }
 };
 
-// src/stealth.js
-var logger3 = createLogger("AntiDetect");
+// src/anti-cheat.js
+var logger3 = createLogger("AntiCheat");
 var BASE_CONFIG = Object.freeze({
   locale: "zh-CN",
   acceptLanguage: "zh-CN,zh;q=0.9",
@@ -474,7 +474,7 @@ function resolveConfig(overrides = {}) {
     geolocation: overrides.geolocation === null ? null : overrides.geolocation || BASE_CONFIG.geolocation
   };
 }
-var AntiDetect = {
+var AntiCheat = {
   /**
    * 获取统一的基础配置（中国、桌面端、中文语言）。
    */
@@ -1076,7 +1076,7 @@ var Launch = {
   getLaunchOptions(customArgs = []) {
     return {
       args: [
-        ...AntiDetect.getLaunchArgs(),
+        ...AntiCheat.getLaunchArgs(),
         ...customArgs
       ],
       ignoreDefaultArgs: ["--enable-automation"]
@@ -1088,7 +1088,7 @@ var Launch = {
   getAdvancedLaunchOptions(customArgs = []) {
     return {
       args: [
-        ...AntiDetect.getAdvancedLaunchArgs(),
+        ...AntiCheat.getAdvancedLaunchArgs(),
         ...customArgs
       ],
       ignoreDefaultArgs: ["--enable-automation"]
@@ -1099,7 +1099,7 @@ var Launch = {
    * 确保生成的是桌面端、较新的 Chrome，以匹配我们的脚本逻辑
    */
   getFingerprintGeneratorOptions() {
-    return AntiDetect.getFingerprintGeneratorOptions();
+    return AntiCheat.getFingerprintGeneratorOptions();
   }
 };
 
@@ -1628,7 +1628,7 @@ var Interception = {
             const reqHeaders = await request.allHeaders();
             delete reqHeaders["host"];
             const currentAcceptLanguage = reqHeaders["accept-language"] || "";
-            AntiDetect.applyLocaleHeaders(reqHeaders, currentAcceptLanguage);
+            AntiCheat.applyLocaleHeaders(reqHeaders, currentAcceptLanguage);
             const resolvedAcceptLanguage = reqHeaders["accept-language"] || "";
             const userAgent = reqHeaders["user-agent"] || "";
             const method = request.method();
@@ -1643,7 +1643,7 @@ var Interception = {
               responseType: "buffer",
               // 强制获取 Buffer
               // 模拟浏览器 TLS 指纹
-              headerGeneratorOptions: AntiDetect.getTlsFingerprintOptions(userAgent, resolvedAcceptLanguage),
+              headerGeneratorOptions: AntiCheat.getTlsFingerprintOptions(userAgent, resolvedAcceptLanguage),
               // 使用共享的 Agent 单例（keepAlive: false，不会池化连接）
               agent: {
                 http: SHARED_HTTP_AGENT,
@@ -1727,7 +1727,7 @@ function isIgnorableError(error) {
 var usePlaywrightToolKit = () => {
   return {
     ApifyKit,
-    AntiDetect,
+    AntiCheat,
     Humanize,
     Launch,
     LiveView,