@skrillex1224/playwright-toolkit 2.0.0 → 2.0.2

package/dist/index.js

@@ -0,0 +1,21 @@
+import { ApifyKit } from "./src/apify-kit.js";
+import { Utils } from "./src/utils.js";
+import { Stealth } from "./src/stealth.js";
+import { Humanize } from "./src/humanize.js";
+import { Launch } from "./src/launch.js";
+import { LiveView } from "./src/live-view.js";
+import * as Constants from "./src/constants.js";
+const usePlaywrightToolKit = () => {
+  return {
+    ApifyKit,
+    Stealth,
+    Humanize,
+    Launch,
+    LiveView,
+    Constants,
+    Utils
+  };
+};
+export {
+  usePlaywrightToolKit
+};

package/dist/src/apify-kit.js

@@ -0,0 +1,96 @@
+import { log } from "crawlee";
+import { Actor } from "apify";
+import { Status, FAILED_KEY_SEPARATOR, StatusCode } from "./constants.js";
+const ApifyKit = {
+  /**
+   * 包装 Step Name
+   */
+  wrapStepNameWithFailedKey(key, stepName) {
+    return `${key}${FAILED_KEY_SEPARATOR}${stepName}`;
+  },
+  /**
+   * 解包 Step Name
+   */
+  unwrapStepName(stepName) {
+    const splitIndex = stepName.indexOf(FAILED_KEY_SEPARATOR);
+    if (splitIndex === -1) {
+      return ["-", stepName];
+    }
+    const key = stepName.substring(0, splitIndex);
+    const value = stepName.substring(splitIndex + FAILED_KEY_SEPARATOR.length);
+    return [key, value];
+  },
+  /**
+   * 核心封装：执行步骤，带自动日志确认和失败截图处理
+   */
+  async runStep(pendingStepName, page, actionFn, options = {}) {
+    const { failActor = true } = options;
+    const [failedKey, stepName] = this.unwrapStepName(pendingStepName);
+    log.info(`\u{1F504} [\u6B63\u5728\u6267\u884C] ${stepName}...`);
+    try {
+      const result = await actionFn();
+      log.info(`\u2705 [\u6267\u884C\u6210\u529F] ${stepName}`);
+      return result;
+    } catch (error) {
+      log.error(`\u274C [\u6267\u884C\u5931\u8D25] ${stepName}: ${error.message}`);
+      let screenshotBase64 = "\u622A\u56FE\u5931\u8D25";
+      try {
+        if (page) {
+          const buffer = await page.screenshot({ fullPage: true, type: "jpeg", quality: 60 });
+          screenshotBase64 = `data:image/jpeg;base64,${buffer.toString("base64")}`;
+        }
+      } catch (snapErr) {
+        log.warning(`\u622A\u56FE\u751F\u6210\u5931\u8D25: ${snapErr.message}`);
+      }
+      await this.pushFailed(error, {
+        failedStep: stepName,
+        failedKey,
+        errorMessage: error.message,
+        errorStack: error.stack,
+        screenshotBase64
+      });
+      if (failActor) {
+        await Actor.fail(`Run Step ${stepName} \u5931\u8D25: ${error.message}`);
+      } else {
+        throw error;
+      }
+    }
+  },
+  /**
+   * 宽松版runStep：失败时不调用Actor.fail，只抛出异常
+   */
+  async runStepLoose(stepName, page, fn) {
+    return await this.runStep(stepName, page, fn, { failActor: false });
+  },
+  /**
+   * 推送成功数据的通用方法
+   * @param {Object} data - 要推送的数据对象
+   */
+  async pushSuccess(data) {
+    await Actor.pushData({
+      code: StatusCode.Success,
+      status: Status.Success,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...data
+    });
+  },
+  /**
+   * 推送失败数据的通用方法（私有方法，仅供runStep内部使用）
+   * @param {Error|Object} error - 错误对象（可包含其他的错误/或部分处理成功的额外信息）
+   * @param {Object} [meta] - 额外的数据（如failedStep, screenshotBase64等，仅runStep使用）
+   * @private
+   */
+  async pushFailed(error, meta = {}) {
+    await Actor.pushData({
+      code: StatusCode.Failed,
+      status: Status.Failed,
+      // 这里可能带其他错误信息
+      error,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...meta
+    });
+  }
+};
+export {
+  ApifyKit
+};

package/dist/src/constants.js

@@ -0,0 +1,21 @@
+const ErrorKeygen = {
+  NotLogin: 30000001,
+  Chaptcha: 30000002
+};
+const Status = {
+  Success: "SUCCESS",
+  Failed: "FAILED"
+};
+const StatusCode = {
+  Success: 0,
+  Failed: -1
+};
+const FAILED_KEY_SEPARATOR = "::<@>::";
+const PresetOfLiveViewKey = "LIVE_VIEW_SCREENSHOT";
+export {
+  ErrorKeygen,
+  FAILED_KEY_SEPARATOR,
+  PresetOfLiveViewKey,
+  Status,
+  StatusCode
+};

package/dist/src/humanize.js

@@ -0,0 +1,30 @@
+import delay from "delay";
+import { log } from "crawlee";
+const Humanize = {
+  /**
+   * 随机延迟一段毫秒数 (API Wrapper for 'delay' package)
+   * @param {number} min - 最小毫秒
+   * @param {number} max - 最大毫秒
+   */
+  async randomSleep(min, max) {
+    const ms = typeof max === "number" ? delay.range(min, max) : delay(min);
+    await ms;
+  },
+  /**
+   * 模拟人类“注视”或“阅读”行为：鼠标在页面上随机微动。
+   * @param {import('ghost-cursor-playwright').GhostCursor} cursor 
+   * @param {number} durationMs - 持续时间
+   */
+  async simulateGaze(cursor, durationMs = 2e3) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < durationMs) {
+      const x = Math.random() * 800;
+      const y = Math.random() * 600;
+      await cursor.moveTo({ x, y });
+      await delay.range(200, 800);
+    }
+  }
+};
+export {
+  Humanize
+};

package/dist/src/launch.js

@@ -0,0 +1,27 @@
+import { Stealth } from "./stealth.js";
+const Launch = {
+  getLaunchOptions(customArgs = []) {
+    return {
+      args: [
+        ...Stealth.getStealthLaunchArgs(),
+        ...customArgs
+      ],
+      ignoreDefaultArgs: ["--enable-automation"]
+    };
+  },
+  /**
+   * 推荐的 Fingerprint Generator 选项
+   * 确保生成的是桌面端、较新的 Chrome，以匹配我们的脚本逻辑
+   */
+  getFingerprintGeneratorOptions() {
+    return {
+      browsers: [{ name: "chrome", minVersion: 110 }],
+      devices: ["desktop"],
+      operatingSystems: ["windows", "linux"]
+      // 包含 Linux 兼容容器
+    };
+  }
+};
+export {
+  Launch
+};

package/dist/src/live-view.js

@@ -0,0 +1,64 @@
+import express from "express";
+import { log } from "crawlee";
+import { Actor } from "apify";
+import { PresetOfLiveViewKey } from "./constants";
+async function startLiveViewServer(liveViewKey) {
+  const app = express();
+  app.get("/", async (req, res) => {
+    try {
+      const screenshotBuffer = await Actor.getValue(liveViewKey);
+      if (!screenshotBuffer) {
+        res.send('<html><head><meta http-equiv="refresh" content="2"></head><body>\u7B49\u5F85\u7B2C\u4E00\u4E2A\u5C4F\u5E55\u622A\u56FE...</body></html>');
+        return;
+      }
+      const screenshotBase64 = screenshotBuffer.toString("base64");
+      res.send(`
+                <html>
+                    <head>
+                        <title>Live View (\u622A\u56FE)</title>
+                        <meta http-equiv="refresh" content="1">
+                    </head>
+                    <body style="margin:0; padding:0;">
+                        <img src="data:image/png;base64,${screenshotBase64}" 
+                             alt="Live View Screenshot" 
+                             style="width: 100%; height: auto;" />
+                    </body>
+                </html>
+            `);
+    } catch (error) {
+      log.error(`Live View \u670D\u52A1\u5668\u9519\u8BEF: ${error.message}`);
+      res.status(500).send(`\u65E0\u6CD5\u52A0\u8F7D\u5C4F\u5E55\u622A\u56FE: ${error.message}`);
+    }
+  });
+  const port = process.env.APIFY_CONTAINER_PORT || 4321;
+  app.listen(port, () => {
+    log.info(`Live View \u670D\u52A1\u5668\u5DF2\u542F\u52A8\uFF0C\u76D1\u542C\u7AEF\u53E3 ${port}\u3002\u8BF7\u6253\u5F00 "Live View" \u9009\u9879\u5361\u67E5\u770B\u3002`);
+  });
+}
+async function takeLiveScreenshot(liveViewKey, page, logMessage) {
+  try {
+    const buffer = await page.screenshot({ type: "png" });
+    await Actor.setValue(liveViewKey, buffer, { contentType: "image/png" });
+    if (logMessage) {
+      log.info(`(\u622A\u56FE): ${logMessage}`);
+    }
+  } catch (e) {
+    log.warning(`\u65E0\u6CD5\u6355\u83B7 Live View \u5C4F\u5E55\u622A\u56FE: ${e.message}`);
+  }
+}
+const useLiveView = (liveViewKey = PresetOfLiveViewKey) => {
+  return {
+    takeLiveScreenshot: async (page, logMessage) => {
+      return await takeLiveScreenshot(liveViewKey, page, logMessage);
+    },
+    startLiveViewServer: async () => {
+      return await startLiveViewServer(liveViewKey);
+    }
+  };
+};
+const LiveView = {
+  useLiveView
+};
+export {
+  LiveView
+};

package/dist/src/stealth.js

@@ -0,0 +1,70 @@
+import { log } from "crawlee";
+const Stealth = {
+  /**
+   * 关键修复：将 Page 视口调整为与浏览器指纹 (window.screen) 一致。
+   * 防止 "Viewport Mismatch" 类型的反爬检测。
+   * @param {import('playwright').Page} page 
+   */
+  async syncViewportWithScreen(page) {
+    try {
+      const screen = await page.evaluate(() => ({
+        width: window.screen.width,
+        height: window.screen.height,
+        availWidth: window.screen.availWidth,
+        availHeight: window.screen.availHeight
+      }));
+      await page.setViewportSize({
+        width: screen.width,
+        height: screen.height
+      });
+      log.info(`[Stealth] Viewport synced to fingerprint: ${screen.width}x${screen.height}`);
+    } catch (e) {
+      log.warning(`[Stealth] Failed to sync viewport: ${e.message}. Fallback to 1920x1080.`);
+      await page.setViewportSize({ width: 1920, height: 1080 });
+    }
+  },
+  /**
+   * 确保 navigator.webdriver 隐藏 (通常 Playwright Stealth 插件已处理，但双重保险)
+   */
+  async hideWebdriver(page) {
+    await page.addInitScript(() => {
+      Object.defineProperty(navigator, "webdriver", {
+        get: () => false
+      });
+    });
+  },
+  /**
+   * 通用的 Playwright 资源拦截器，用于屏蔽不必要的资源以加速加载
+   * @param {import('playwright').Page} page
+   * @param {string[]} [resourceTypes] - 要屏蔽的资源类型，默认为 ['font', 'image', 'media']
+   */
+  async setupBlockingResources(page, resourceTypes = ["font", "image", "media"]) {
+    await page.route("**/*", (route) => {
+      const request = route.request();
+      const type = request.resourceType();
+      if (resourceTypes.includes(type)) {
+        return route.abort();
+      }
+      return route.continue();
+    });
+  },
+  /**
+   * 获取推荐的 Stealth 启动参数
+   */
+  getStealthLaunchArgs() {
+    return [
+      "--disable-blink-features=AutomationControlled",
+      "--no-sandbox",
+      "--disable-setuid-sandbox",
+      "--disable-infobars",
+      "--window-position=0,0",
+      "--ignore-certificate-errors",
+      "--disable-web-security"
+      // 注意：不建议这里强制指定 window-size，让 syncViewportWithScreen 去动态调整
+      // '--window-size=1920,1080' 
+    ];
+  }
+};
+export {
+  Stealth
+};

package/dist/src/utils.js

@@ -0,0 +1,24 @@
+const Utils = {
+  /**
+  * 解析 SSE 流文本
+  */
+  parseSseStream(sseStreamText) {
+    const events = [];
+    const lines = sseStreamText.split("\n");
+    for (const line of lines) {
+      if (line.startsWith("data: ")) {
+        try {
+          const jsonContent = line.substring(6).trim();
+          if (jsonContent && jsonContent !== "[DONE]") {
+            events.push(JSON.parse(jsonContent));
+          }
+        } catch (e) {
+        }
+      }
+    }
+    return events;
+  }
+};
+export {
+  Utils
+};

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
-  "main": "index.js",
+  "main": "dist/index.js",
   "type": "module",
   "scripts": {
+    "build": "node build.js",
+    "prepublishOnly": "npm run build",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
+  "files": [
+    "dist/",
+    "docs/",
+    "README.md"
+  ],
   "keywords": [
     "apify",
     "crawlee",
@@ -24,5 +31,8 @@
     "apify": "*",
     "crawlee": "*",
     "playwright": "*"
+  },
+  "devDependencies": {
+    "esbuild": "^0.24.2"
   }
 }

package/index.js

@@ -1,21 +0,0 @@
-import { ApifyKit } from './src/apify-kit.js';
-import { Utils } from './src/utils.js';
-import { Stealth } from './src/stealth.js';
-import { Humanize } from './src/humanize.js';
-import { Launch } from './src/launch.js';
-import { LiveView } from './src/live-view.js';
-import * as Constants from './src/constants.js';
-
-// Unified Entry Point
-export const usePlaywrightToolKit = () => {
-    return {
-        ApifyKit,
-
-        Stealth,
-        Humanize,
-        Launch,
-        LiveView,
-        Constants,
-        Utils
-    };
-};

package/src/apify-kit.js

@@ -1,108 +0,0 @@
-import { log } from 'crawlee';
-import { Actor } from 'apify';
-import { Status, FAILED_KEY_SEPARATOR, StatusCode } from './constants.js';
-
-export const ApifyKit = {
-
-    /**
-     * 包装 Step Name
-     */
-    wrapStepNameWithFailedKey(key, stepName) {
-        return `${key}${FAILED_KEY_SEPARATOR}${stepName}`;
-    },
-
-    /**
-     * 解包 Step Name
-     */
-    unwrapStepName(stepName) {
-        const splitIndex = stepName.indexOf(FAILED_KEY_SEPARATOR);
-        if (splitIndex === -1) {
-            return ['-', stepName];
-        }
-        const key = stepName.substring(0, splitIndex);
-        const value = stepName.substring(splitIndex + FAILED_KEY_SEPARATOR.length);
-        return [key, value];
-    },
-
-    /**
-     * 核心封装：执行步骤，带自动日志确认和失败截图处理
-     */
-    async runStep(pendingStepName, page, actionFn, options = {}) {
-        const { failActor = true } = options;  // 默认调用 Actor.fail
-        const [failedKey, stepName] = this.unwrapStepName(pendingStepName);
-
-        log.info(`🔄 [正在执行] ${stepName}...`);
-
-        try {
-            const result = await actionFn();
-            log.info(`✅ [执行成功] ${stepName}`);
-            return result;
-        } catch (error) {
-            log.error(`❌ [执行失败] ${stepName}: ${error.message}`);
-
-            let screenshotBase64 = '截图失败';
-            try {
-                if (page) {
-                    const buffer = await page.screenshot({ fullPage: true, type: 'jpeg', quality: 60 });
-                    screenshotBase64 = `data:image/jpeg;base64,${buffer.toString('base64')}`;
-                }
-            } catch (snapErr) {
-                log.warning(`截图生成失败: ${snapErr.message}`);
-            }
-
-            // 使用 pushFailed 方法推送失败数据（私有使用）
-            await this.pushFailed(error, {
-                failedStep: stepName,
-                failedKey: failedKey,
-                errorMessage: error.message,
-                errorStack: error.stack,
-                screenshotBase64: screenshotBase64
-            });
-
-            // 根据 failActor 决定是否调用 Actor.fail
-            if (failActor) {
-                await Actor.fail(`Run Step ${stepName} 失败: ${error.message}`);
-            } else {
-                // 不调用 Actor.fail，直接抛出错误
-                throw error;
-            }
-        }
-    },
-
-    /**
-     * 宽松版runStep：失败时不调用Actor.fail，只抛出异常
-     */
-    async runStepLoose(stepName, page, fn) {
-        return await this.runStep(stepName, page, fn, { failActor: false });
-    },
-
-    /**
-     * 推送成功数据的通用方法
-     * @param {Object} data - 要推送的数据对象
-     */
-    async pushSuccess(data) {
-        await Actor.pushData({
-            code: StatusCode.Success,
-            status: Status.Success,
-            timestamp: new Date().toISOString(),
-            ...data
-        });
-    },
-
-    /**
-     * 推送失败数据的通用方法（私有方法，仅供runStep内部使用）
-     * @param {Error|Object} error - 错误对象（可包含其他的错误/或部分处理成功的额外信息）
-     * @param {Object} [meta] - 额外的数据（如failedStep, screenshotBase64等，仅runStep使用）
-     * @private
-     */
-    async pushFailed(error, meta = {}) {
-        await Actor.pushData({
-            code: StatusCode.Failed,
-            status: Status.Failed,
-            // 这里可能带其他错误信息
-            error,
-            timestamp: new Date().toISOString(),
-            ...meta
-        });
-    }
-}

package/src/constants.js

@@ -1,18 +0,0 @@
-export const ErrorKeygen = {
-    NotLogin: 30000001,
-    Chaptcha: 30000002,
-}
-
-export const Status = {
-    Success: 'SUCCESS',
-    Failed: 'FAILED'
-}
-
-export const StatusCode = {
-    Success: 0,
-    Failed: -1
-}
-
-export const FAILED_KEY_SEPARATOR = '::<@>::';
-
-export const PresetOfLiveViewKey = 'LIVE_VIEW_SCREENSHOT';

package/src/humanize.js

@@ -1,37 +0,0 @@
-import delay from 'delay';
-import { log } from 'crawlee';
-
-export const Humanize = {
-    /**
-     * 随机延迟一段毫秒数 (API Wrapper for 'delay' package)
-     * @param {number} min - 最小毫秒
-     * @param {number} max - 最大毫秒
-     */
-    async randomSleep(min, max) {
-        const ms = typeof max === 'number'
-            ? delay.range(min, max)
-            : delay(min); // 如果只传一个参数，视为固定延迟或最小延迟
-
-        // log.debug(`[Humanize] Sleeping for ${await ms} ms...`); // delay return promise acts like number somewhat but best await it
-        // The delay package returns a promise that resolves after the delay.
-        // delay.range() returns a promise too.
-
-        await ms;
-    },
-
-    /**
-     * 模拟人类“注视”或“阅读”行为：鼠标在页面上随机微动。
-     * @param {import('ghost-cursor-playwright').GhostCursor} cursor 
-     * @param {number} durationMs - 持续时间
-     */
-    async simulateGaze(cursor, durationMs = 2000) {
-        const startTime = Date.now();
-        while (Date.now() - startTime < durationMs) {
-            // 随机小幅度移动
-            const x = Math.random() * 800;
-            const y = Math.random() * 600;
-            await cursor.moveTo({ x, y });
-            await delay.range(200, 800);
-        }
-    }
-}

package/src/launch.js

@@ -1,26 +0,0 @@
-// 集中管理启动配置，暂时主要由 Stealth 模块提供 Args，这里作为扩展点
-import { Stealth } from './stealth.js';
-
-export const Launch = {
-    getLaunchOptions(customArgs = []) {
-        return {
-            args: [
-                ...Stealth.getStealthLaunchArgs(),
-                ...customArgs
-            ],
-            ignoreDefaultArgs: ['--enable-automation'],
-        };
-    },
-
-    /**
-     * 推荐的 Fingerprint Generator 选项
-     * 确保生成的是桌面端、较新的 Chrome，以匹配我们的脚本逻辑
-     */
-    getFingerprintGeneratorOptions() {
-        return {
-            browsers: [{ name: 'chrome', minVersion: 110 }],
-            devices: ['desktop'],
-            operatingSystems: ['windows', 'linux'], // 包含 Linux 兼容容器
-        };
-    }
-}

package/src/live-view.js

@@ -1,81 +0,0 @@
-import express from 'express';
-import { log } from 'crawlee';
-import { Actor } from 'apify';
-import { PresetOfLiveViewKey } from './constants';
-
-/**
- * 启动一个 Web 服务器以在 Live View 选项卡中显示最新的屏幕截图。
- */
-async function startLiveViewServer(liveViewKey) {
-    const app = express();
-
-    app.get('/', async (req, res) => {
-        try {
-            // 从默认的 Key-Value Store 中读取最新的屏幕截图
-            const screenshotBuffer = await Actor.getValue(liveViewKey);
-
-            if (!screenshotBuffer) {
-                // 如果还没有截图，发送一个自动刷新的占位页面
-                res.send('<html><head><meta http-equiv="refresh" content="2"></head><body>等待第一个屏幕截图...</body></html>');
-                return;
-            }
-
-            // 将 Buffer 转换为 Base64 字符串
-            const screenshotBase64 = screenshotBuffer.toString('base64');
-
-            // 发送一个 HTML 页面，该页面每 1 秒自动刷新一次，并显示截图
-            res.send(`
-                <html>
-                    <head>
-                        <title>Live View (截图)</title>
-                        <meta http-equiv="refresh" content="1">
-                    </head>
-                    <body style="margin:0; padding:0;">
-                        <img src="data:image/png;base64,${screenshotBase64}" 
-                             alt="Live View Screenshot" 
-                             style="width: 100%; height: auto;" />
-                    </body>
-                </html>
-            `);
-        } catch (error) {
-            log.error(`Live View 服务器错误: ${error.message}`);
-            res.status(500).send(`无法加载屏幕截图: ${error.message}`);
-        }
-    });
-
-    // 监听 Apify 容器端口 
-    const port = process.env.APIFY_CONTAINER_PORT || 4321;
-    app.listen(port, () => { log.info(`Live View 服务器已启动，监听端口 ${port}。请打开 "Live View" 选项卡查看。`); });
-}
-
-/**
- * 拍摄当前页面的屏幕截图并将其保存到 Key-Value Store。
- * @param {import('playwright').Page} page
- * @param {string} [logMessage] - 可选的日志消息。
- */
-async function takeLiveScreenshot(liveViewKey, page, logMessage) {
-    try {
-        const buffer = await page.screenshot({ type: 'png' });
-        await Actor.setValue(liveViewKey, buffer, { contentType: 'image/png' });
-        if (logMessage) {
-            log.info(`(截图): ${logMessage}`);
-        }
-    } catch (e) {
-        log.warning(`无法捕获 Live View 屏幕截图: ${e.message}`);
-    }
-}
-
-const useLiveView = (liveViewKey = PresetOfLiveViewKey) => {
-    return {
-        takeLiveScreenshot: async (page, logMessage) => {
-            return await takeLiveScreenshot(liveViewKey, page, logMessage)
-        },
-        startLiveViewServer: async () => {
-            return await startLiveViewServer(liveViewKey);
-        }
-    }
-}
-
-export const LiveView = {
-    useLiveView,
-};

package/src/stealth.js

@@ -1,75 +0,0 @@
-import { log } from 'crawlee';
-
-export const Stealth = {
-    /**
-     * 关键修复：将 Page 视口调整为与浏览器指纹 (window.screen) 一致。
-     * 防止 "Viewport Mismatch" 类型的反爬检测。
-     * @param {import('playwright').Page} page 
-     */
-    async syncViewportWithScreen(page) {
-        try {
-            // 获取指纹中的屏幕尺寸
-            const screen = await page.evaluate(() => ({
-                width: window.screen.width,
-                height: window.screen.height,
-                availWidth: window.screen.availWidth,
-                availHeight: window.screen.availHeight,
-            }));
-
-            // 调整视口
-            await page.setViewportSize({
-                width: screen.width,
-                height: screen.height
-            });
-
-            log.info(`[Stealth] Viewport synced to fingerprint: ${screen.width}x${screen.height}`);
-        } catch (e) {
-            log.warning(`[Stealth] Failed to sync viewport: ${e.message}. Fallback to 1920x1080.`);
-            await page.setViewportSize({ width: 1920, height: 1080 });
-        }
-    },
-
-    /**
-     * 确保 navigator.webdriver 隐藏 (通常 Playwright Stealth 插件已处理，但双重保险)
-     */
-    async hideWebdriver(page) {
-        await page.addInitScript(() => {
-            Object.defineProperty(navigator, 'webdriver', {
-                get: () => false,
-            });
-        });
-    },
-
-    /**
-     * 通用的 Playwright 资源拦截器，用于屏蔽不必要的资源以加速加载
-     * @param {import('playwright').Page} page
-     * @param {string[]} [resourceTypes] - 要屏蔽的资源类型，默认为 ['font', 'image', 'media']
-     */
-    async setupBlockingResources(page, resourceTypes = ['font', 'image', 'media']) {
-        await page.route('**/*', (route) => {
-            const request = route.request();
-            const type = request.resourceType();
-            if (resourceTypes.includes(type)) {
-                return route.abort();
-            }
-            return route.continue();
-        });
-    },
-
-    /**
-     * 获取推荐的 Stealth 启动参数
-     */
-    getStealthLaunchArgs() {
-        return [
-            '--disable-blink-features=AutomationControlled',
-            '--no-sandbox',
-            '--disable-setuid-sandbox',
-            '--disable-infobars',
-            '--window-position=0,0',
-            '--ignore-certificate-errors',
-            '--disable-web-security',
-            // 注意：不建议这里强制指定 window-size，让 syncViewportWithScreen 去动态调整
-            // '--window-size=1920,1080' 
-        ];
-    }
-}

package/src/utils.js

@@ -1,22 +0,0 @@
-export const Utils = {
-    /**
-    * 解析 SSE 流文本
-    */
-    parseSseStream(sseStreamText) {
-        const events = [];
-        const lines = sseStreamText.split('\n');
-        for (const line of lines) {
-            if (line.startsWith('data: ')) {
-                try {
-                    const jsonContent = line.substring(6).trim();
-                    if (jsonContent && jsonContent !== '[DONE]') {
-                        events.push(JSON.parse(jsonContent));
-                    }
-                } catch (e) {
-                    // Ignore lines that are not valid JSON
-                }
-            }
-        }
-        return events;
-    }
-}