@skrillex1224/playwright-toolkit 2.0.1 → 2.0.3

package/dist/index.cjs

@@ -0,0 +1,380 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.js
+var index_exports = {};
+__export(index_exports, {
+  usePlaywrightToolKit: () => usePlaywrightToolKit
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/apify-kit.js
+var import_crawlee = require("crawlee");
+var import_apify = require("apify");
+
+// src/constants.js
+var constants_exports = {};
+__export(constants_exports, {
+  ErrorKeygen: () => ErrorKeygen,
+  FAILED_KEY_SEPARATOR: () => FAILED_KEY_SEPARATOR,
+  PresetOfLiveViewKey: () => PresetOfLiveViewKey,
+  Status: () => Status,
+  StatusCode: () => StatusCode
+});
+var ErrorKeygen = {
+  NotLogin: 30000001,
+  Chaptcha: 30000002
+};
+var Status = {
+  Success: "SUCCESS",
+  Failed: "FAILED"
+};
+var StatusCode = {
+  Success: 0,
+  Failed: -1
+};
+var FAILED_KEY_SEPARATOR = "::<@>::";
+var PresetOfLiveViewKey = "LIVE_VIEW_SCREENSHOT";
+
+// src/apify-kit.js
+var 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);
+    import_crawlee.log.info(`\u{1F504} [\u6B63\u5728\u6267\u884C] ${stepName}...`);
+    try {
+      const result = await actionFn();
+      import_crawlee.log.info(`\u2705 [\u6267\u884C\u6210\u529F] ${stepName}`);
+      return result;
+    } catch (error) {
+      import_crawlee.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) {
+        import_crawlee.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 import_apify.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 import_apify.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 import_apify.Actor.pushData({
+      code: StatusCode.Failed,
+      status: Status.Failed,
+      // 这里可能带其他错误信息
+      error,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...meta
+    });
+  }
+};
+
+// src/utils.js
+var 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;
+  }
+};
+
+// src/stealth.js
+var import_crawlee2 = require("crawlee");
+var 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
+      });
+      import_crawlee2.log.info(`[Stealth] Viewport synced to fingerprint: ${screen.width}x${screen.height}`);
+    } catch (e) {
+      import_crawlee2.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' 
+    ];
+  }
+};
+
+// src/humanize.js
+var import_delay = __toESM(require("delay"), 1);
+var import_crawlee3 = require("crawlee");
+var Humanize = {
+  /**
+   * 随机延迟一段毫秒数 (API Wrapper for 'delay' package)
+   * @param {number} min - 最小毫秒
+   * @param {number} max - 最大毫秒
+   */
+  async randomSleep(min, max) {
+    const ms = typeof max === "number" ? import_delay.default.range(min, max) : (0, import_delay.default)(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 import_delay.default.range(200, 800);
+    }
+  }
+};
+
+// src/launch.js
+var 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 兼容容器
+    };
+  }
+};
+
+// src/live-view.js
+var import_express = __toESM(require("express"), 1);
+var import_crawlee4 = require("crawlee");
+var import_apify2 = require("apify");
+async function startLiveViewServer(liveViewKey) {
+  const app = (0, import_express.default)();
+  app.get("/", async (req, res) => {
+    try {
+      const screenshotBuffer = await import_apify2.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) {
+      import_crawlee4.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, () => {
+    import_crawlee4.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 import_apify2.Actor.setValue(liveViewKey, buffer, { contentType: "image/png" });
+    if (logMessage) {
+      import_crawlee4.log.info(`(\u622A\u56FE): ${logMessage}`);
+    }
+  } catch (e) {
+    import_crawlee4.log.warning(`\u65E0\u6CD5\u6355\u83B7 Live View \u5C4F\u5E55\u622A\u56FE: ${e.message}`);
+  }
+}
+var useLiveView = (liveViewKey = PresetOfLiveViewKey) => {
+  return {
+    takeLiveScreenshot: async (page, logMessage) => {
+      return await takeLiveScreenshot(liveViewKey, page, logMessage);
+    },
+    startLiveViewServer: async () => {
+      return await startLiveViewServer(liveViewKey);
+    }
+  };
+};
+var LiveView = {
+  useLiveView
+};
+
+// index.js
+var usePlaywrightToolKit = () => {
+  return {
+    ApifyKit,
+    Stealth,
+    Humanize,
+    Launch,
+    LiveView,
+    Constants: constants_exports,
+    Utils
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  usePlaywrightToolKit
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../index.js", "../src/apify-kit.js", "../src/constants.js", "../src/utils.js", "../src/stealth.js", "../src/humanize.js", "../src/launch.js", "../src/live-view.js"],
+  "sourcesContent": ["import { ApifyKit } from './src/apify-kit.js';\nimport { Utils } from './src/utils.js';\nimport { Stealth } from './src/stealth.js';\nimport { Humanize } from './src/humanize.js';\nimport { Launch } from './src/launch.js';\nimport { LiveView } from './src/live-view.js';\nimport * as Constants from './src/constants.js';\n\n// Unified Entry Point\nexport const usePlaywrightToolKit = () => {\n    return {\n        ApifyKit,\n        Stealth,\n        Humanize,\n        Launch,\n        LiveView,\n        Constants,\n        Utils\n    };\n};\n", "import { log } from 'crawlee';\nimport { Actor } from 'apify';\nimport { Status, FAILED_KEY_SEPARATOR, StatusCode } from './constants.js';\n\nexport const ApifyKit = {\n\n    /**\n     * \u5305\u88C5 Step Name\n     */\n    wrapStepNameWithFailedKey(key, stepName) {\n        return `${key}${FAILED_KEY_SEPARATOR}${stepName}`;\n    },\n\n    /**\n     * \u89E3\u5305 Step Name\n     */\n    unwrapStepName(stepName) {\n        const splitIndex = stepName.indexOf(FAILED_KEY_SEPARATOR);\n        if (splitIndex === -1) {\n            return ['-', stepName];\n        }\n        const key = stepName.substring(0, splitIndex);\n        const value = stepName.substring(splitIndex + FAILED_KEY_SEPARATOR.length);\n        return [key, value];\n    },\n\n    /**\n     * \u6838\u5FC3\u5C01\u88C5\uFF1A\u6267\u884C\u6B65\u9AA4\uFF0C\u5E26\u81EA\u52A8\u65E5\u5FD7\u786E\u8BA4\u548C\u5931\u8D25\u622A\u56FE\u5904\u7406\n     */\n    async runStep(pendingStepName, page, actionFn, options = {}) {\n        const { failActor = true } = options;  // \u9ED8\u8BA4\u8C03\u7528 Actor.fail\n        const [failedKey, stepName] = this.unwrapStepName(pendingStepName);\n\n        log.info(`\uD83D\uDD04 [\u6B63\u5728\u6267\u884C] ${stepName}...`);\n\n        try {\n            const result = await actionFn();\n            log.info(`\u2705 [\u6267\u884C\u6210\u529F] ${stepName}`);\n            return result;\n        } catch (error) {\n            log.error(`\u274C [\u6267\u884C\u5931\u8D25] ${stepName}: ${error.message}`);\n\n            let screenshotBase64 = '\u622A\u56FE\u5931\u8D25';\n            try {\n                if (page) {\n                    const buffer = await page.screenshot({ fullPage: true, type: 'jpeg', quality: 60 });\n                    screenshotBase64 = `data:image/jpeg;base64,${buffer.toString('base64')}`;\n                }\n            } catch (snapErr) {\n                log.warning(`\u622A\u56FE\u751F\u6210\u5931\u8D25: ${snapErr.message}`);\n            }\n\n            // \u4F7F\u7528 pushFailed \u65B9\u6CD5\u63A8\u9001\u5931\u8D25\u6570\u636E\uFF08\u79C1\u6709\u4F7F\u7528\uFF09\n            await this.pushFailed(error, {\n                failedStep: stepName,\n                failedKey: failedKey,\n                errorMessage: error.message,\n                errorStack: error.stack,\n                screenshotBase64: screenshotBase64\n            });\n\n            // \u6839\u636E failActor \u51B3\u5B9A\u662F\u5426\u8C03\u7528 Actor.fail\n            if (failActor) {\n                await Actor.fail(`Run Step ${stepName} \u5931\u8D25: ${error.message}`);\n            } else {\n                // \u4E0D\u8C03\u7528 Actor.fail\uFF0C\u76F4\u63A5\u629B\u51FA\u9519\u8BEF\n                throw error;\n            }\n        }\n    },\n\n    /**\n     * \u5BBD\u677E\u7248runStep\uFF1A\u5931\u8D25\u65F6\u4E0D\u8C03\u7528Actor.fail\uFF0C\u53EA\u629B\u51FA\u5F02\u5E38\n     */\n    async runStepLoose(stepName, page, fn) {\n        return await this.runStep(stepName, page, fn, { failActor: false });\n    },\n\n    /**\n     * \u63A8\u9001\u6210\u529F\u6570\u636E\u7684\u901A\u7528\u65B9\u6CD5\n     * @param {Object} data - \u8981\u63A8\u9001\u7684\u6570\u636E\u5BF9\u8C61\n     */\n    async pushSuccess(data) {\n        await Actor.pushData({\n            code: StatusCode.Success,\n            status: Status.Success,\n            timestamp: new Date().toISOString(),\n            ...data\n        });\n    },\n\n    /**\n     * \u63A8\u9001\u5931\u8D25\u6570\u636E\u7684\u901A\u7528\u65B9\u6CD5\uFF08\u79C1\u6709\u65B9\u6CD5\uFF0C\u4EC5\u4F9BrunStep\u5185\u90E8\u4F7F\u7528\uFF09\n     * @param {Error|Object} error - \u9519\u8BEF\u5BF9\u8C61\uFF08\u53EF\u5305\u542B\u5176\u4ED6\u7684\u9519\u8BEF/\u6216\u90E8\u5206\u5904\u7406\u6210\u529F\u7684\u989D\u5916\u4FE1\u606F\uFF09\n     * @param {Object} [meta] - \u989D\u5916\u7684\u6570\u636E\uFF08\u5982failedStep, screenshotBase64\u7B49\uFF0C\u4EC5runStep\u4F7F\u7528\uFF09\n     * @private\n     */\n    async pushFailed(error, meta = {}) {\n        await Actor.pushData({\n            code: StatusCode.Failed,\n            status: Status.Failed,\n            // \u8FD9\u91CC\u53EF\u80FD\u5E26\u5176\u4ED6\u9519\u8BEF\u4FE1\u606F\n            error,\n            timestamp: new Date().toISOString(),\n            ...meta\n        });\n    }\n}\n", "export const ErrorKeygen = {\n    NotLogin: 30000001,\n    Chaptcha: 30000002,\n}\n\nexport const Status = {\n    Success: 'SUCCESS',\n    Failed: 'FAILED'\n}\n\nexport const StatusCode = {\n    Success: 0,\n    Failed: -1\n}\n\nexport const FAILED_KEY_SEPARATOR = '::<@>::';\n\nexport const PresetOfLiveViewKey = 'LIVE_VIEW_SCREENSHOT';\n", "export const Utils = {\n    /**\n    * \u89E3\u6790 SSE \u6D41\u6587\u672C\n    */\n    parseSseStream(sseStreamText) {\n        const events = [];\n        const lines = sseStreamText.split('\\n');\n        for (const line of lines) {\n            if (line.startsWith('data: ')) {\n                try {\n                    const jsonContent = line.substring(6).trim();\n                    if (jsonContent && jsonContent !== '[DONE]') {\n                        events.push(JSON.parse(jsonContent));\n                    }\n                } catch (e) {\n                    // Ignore lines that are not valid JSON\n                }\n            }\n        }\n        return events;\n    }\n}\n", "import { log } from 'crawlee';\n\nexport const Stealth = {\n    /**\n     * \u5173\u952E\u4FEE\u590D\uFF1A\u5C06 Page \u89C6\u53E3\u8C03\u6574\u4E3A\u4E0E\u6D4F\u89C8\u5668\u6307\u7EB9 (window.screen) \u4E00\u81F4\u3002\n     * \u9632\u6B62 \"Viewport Mismatch\" \u7C7B\u578B\u7684\u53CD\u722C\u68C0\u6D4B\u3002\n     * @param {import('playwright').Page} page \n     */\n    async syncViewportWithScreen(page) {\n        try {\n            // \u83B7\u53D6\u6307\u7EB9\u4E2D\u7684\u5C4F\u5E55\u5C3A\u5BF8\n            const screen = await page.evaluate(() => ({\n                width: window.screen.width,\n                height: window.screen.height,\n                availWidth: window.screen.availWidth,\n                availHeight: window.screen.availHeight,\n            }));\n\n            // \u8C03\u6574\u89C6\u53E3\n            await page.setViewportSize({\n                width: screen.width,\n                height: screen.height\n            });\n\n            log.info(`[Stealth] Viewport synced to fingerprint: ${screen.width}x${screen.height}`);\n        } catch (e) {\n            log.warning(`[Stealth] Failed to sync viewport: ${e.message}. Fallback to 1920x1080.`);\n            await page.setViewportSize({ width: 1920, height: 1080 });\n        }\n    },\n\n    /**\n     * \u786E\u4FDD navigator.webdriver \u9690\u85CF (\u901A\u5E38 Playwright Stealth \u63D2\u4EF6\u5DF2\u5904\u7406\uFF0C\u4F46\u53CC\u91CD\u4FDD\u9669)\n     */\n    async hideWebdriver(page) {\n        await page.addInitScript(() => {\n            Object.defineProperty(navigator, 'webdriver', {\n                get: () => false,\n            });\n        });\n    },\n\n    /**\n     * \u901A\u7528\u7684 Playwright \u8D44\u6E90\u62E6\u622A\u5668\uFF0C\u7528\u4E8E\u5C4F\u853D\u4E0D\u5FC5\u8981\u7684\u8D44\u6E90\u4EE5\u52A0\u901F\u52A0\u8F7D\n     * @param {import('playwright').Page} page\n     * @param {string[]} [resourceTypes] - \u8981\u5C4F\u853D\u7684\u8D44\u6E90\u7C7B\u578B\uFF0C\u9ED8\u8BA4\u4E3A ['font', 'image', 'media']\n     */\n    async setupBlockingResources(page, resourceTypes = ['font', 'image', 'media']) {\n        await page.route('**/*', (route) => {\n            const request = route.request();\n            const type = request.resourceType();\n            if (resourceTypes.includes(type)) {\n                return route.abort();\n            }\n            return route.continue();\n        });\n    },\n\n    /**\n     * \u83B7\u53D6\u63A8\u8350\u7684 Stealth \u542F\u52A8\u53C2\u6570\n     */\n    getStealthLaunchArgs() {\n        return [\n            '--disable-blink-features=AutomationControlled',\n            '--no-sandbox',\n            '--disable-setuid-sandbox',\n            '--disable-infobars',\n            '--window-position=0,0',\n            '--ignore-certificate-errors',\n            '--disable-web-security',\n            // \u6CE8\u610F\uFF1A\u4E0D\u5EFA\u8BAE\u8FD9\u91CC\u5F3A\u5236\u6307\u5B9A window-size\uFF0C\u8BA9 syncViewportWithScreen \u53BB\u52A8\u6001\u8C03\u6574\n            // '--window-size=1920,1080' \n        ];\n    }\n}\n", "import delay from 'delay';\nimport { log } from 'crawlee';\n\nexport const Humanize = {\n    /**\n     * \u968F\u673A\u5EF6\u8FDF\u4E00\u6BB5\u6BEB\u79D2\u6570 (API Wrapper for 'delay' package)\n     * @param {number} min - \u6700\u5C0F\u6BEB\u79D2\n     * @param {number} max - \u6700\u5927\u6BEB\u79D2\n     */\n    async randomSleep(min, max) {\n        const ms = typeof max === 'number'\n            ? delay.range(min, max)\n            : delay(min); // \u5982\u679C\u53EA\u4F20\u4E00\u4E2A\u53C2\u6570\uFF0C\u89C6\u4E3A\u56FA\u5B9A\u5EF6\u8FDF\u6216\u6700\u5C0F\u5EF6\u8FDF\n\n        // log.debug(`[Humanize] Sleeping for ${await ms} ms...`); // delay return promise acts like number somewhat but best await it\n        // The delay package returns a promise that resolves after the delay.\n        // delay.range() returns a promise too.\n\n        await ms;\n    },\n\n    /**\n     * \u6A21\u62DF\u4EBA\u7C7B\u201C\u6CE8\u89C6\u201D\u6216\u201C\u9605\u8BFB\u201D\u884C\u4E3A\uFF1A\u9F20\u6807\u5728\u9875\u9762\u4E0A\u968F\u673A\u5FAE\u52A8\u3002\n     * @param {import('ghost-cursor-playwright').GhostCursor} cursor \n     * @param {number} durationMs - \u6301\u7EED\u65F6\u95F4\n     */\n    async simulateGaze(cursor, durationMs = 2000) {\n        const startTime = Date.now();\n        while (Date.now() - startTime < durationMs) {\n            // \u968F\u673A\u5C0F\u5E45\u5EA6\u79FB\u52A8\n            const x = Math.random() * 800;\n            const y = Math.random() * 600;\n            await cursor.moveTo({ x, y });\n            await delay.range(200, 800);\n        }\n    }\n}\n", "// \u96C6\u4E2D\u7BA1\u7406\u542F\u52A8\u914D\u7F6E\uFF0C\u6682\u65F6\u4E3B\u8981\u7531 Stealth \u6A21\u5757\u63D0\u4F9B Args\uFF0C\u8FD9\u91CC\u4F5C\u4E3A\u6269\u5C55\u70B9\nimport { Stealth } from './stealth.js';\n\nexport const Launch = {\n    getLaunchOptions(customArgs = []) {\n        return {\n            args: [\n                ...Stealth.getStealthLaunchArgs(),\n                ...customArgs\n            ],\n            ignoreDefaultArgs: ['--enable-automation'],\n        };\n    },\n\n    /**\n     * \u63A8\u8350\u7684 Fingerprint Generator \u9009\u9879\n     * \u786E\u4FDD\u751F\u6210\u7684\u662F\u684C\u9762\u7AEF\u3001\u8F83\u65B0\u7684 Chrome\uFF0C\u4EE5\u5339\u914D\u6211\u4EEC\u7684\u811A\u672C\u903B\u8F91\n     */\n    getFingerprintGeneratorOptions() {\n        return {\n            browsers: [{ name: 'chrome', minVersion: 110 }],\n            devices: ['desktop'],\n            operatingSystems: ['windows', 'linux'], // \u5305\u542B Linux \u517C\u5BB9\u5BB9\u5668\n        };\n    }\n}\n", "import express from 'express';\nimport { log } from 'crawlee';\nimport { Actor } from 'apify';\nimport { PresetOfLiveViewKey } from './constants';\n\n/**\n * \u542F\u52A8\u4E00\u4E2A Web \u670D\u52A1\u5668\u4EE5\u5728 Live View \u9009\u9879\u5361\u4E2D\u663E\u793A\u6700\u65B0\u7684\u5C4F\u5E55\u622A\u56FE\u3002\n */\nasync function startLiveViewServer(liveViewKey) {\n    const app = express();\n\n    app.get('/', async (req, res) => {\n        try {\n            // \u4ECE\u9ED8\u8BA4\u7684 Key-Value Store \u4E2D\u8BFB\u53D6\u6700\u65B0\u7684\u5C4F\u5E55\u622A\u56FE\n            const screenshotBuffer = await Actor.getValue(liveViewKey);\n\n            if (!screenshotBuffer) {\n                // \u5982\u679C\u8FD8\u6CA1\u6709\u622A\u56FE\uFF0C\u53D1\u9001\u4E00\u4E2A\u81EA\u52A8\u5237\u65B0\u7684\u5360\u4F4D\u9875\u9762\n                res.send('<html><head><meta http-equiv=\"refresh\" content=\"2\"></head><body>\u7B49\u5F85\u7B2C\u4E00\u4E2A\u5C4F\u5E55\u622A\u56FE...</body></html>');\n                return;\n            }\n\n            // \u5C06 Buffer \u8F6C\u6362\u4E3A Base64 \u5B57\u7B26\u4E32\n            const screenshotBase64 = screenshotBuffer.toString('base64');\n\n            // \u53D1\u9001\u4E00\u4E2A HTML \u9875\u9762\uFF0C\u8BE5\u9875\u9762\u6BCF 1 \u79D2\u81EA\u52A8\u5237\u65B0\u4E00\u6B21\uFF0C\u5E76\u663E\u793A\u622A\u56FE\n            res.send(`\n                <html>\n                    <head>\n                        <title>Live View (\u622A\u56FE)</title>\n                        <meta http-equiv=\"refresh\" content=\"1\">\n                    </head>\n                    <body style=\"margin:0; padding:0;\">\n                        <img src=\"data:image/png;base64,${screenshotBase64}\" \n                             alt=\"Live View Screenshot\" \n                             style=\"width: 100%; height: auto;\" />\n                    </body>\n                </html>\n            `);\n        } catch (error) {\n            log.error(`Live View \u670D\u52A1\u5668\u9519\u8BEF: ${error.message}`);\n            res.status(500).send(`\u65E0\u6CD5\u52A0\u8F7D\u5C4F\u5E55\u622A\u56FE: ${error.message}`);\n        }\n    });\n\n    // \u76D1\u542C Apify \u5BB9\u5668\u7AEF\u53E3 \n    const port = process.env.APIFY_CONTAINER_PORT || 4321;\n    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`); });\n}\n\n/**\n * \u62CD\u6444\u5F53\u524D\u9875\u9762\u7684\u5C4F\u5E55\u622A\u56FE\u5E76\u5C06\u5176\u4FDD\u5B58\u5230 Key-Value Store\u3002\n * @param {import('playwright').Page} page\n * @param {string} [logMessage] - \u53EF\u9009\u7684\u65E5\u5FD7\u6D88\u606F\u3002\n */\nasync function takeLiveScreenshot(liveViewKey, page, logMessage) {\n    try {\n        const buffer = await page.screenshot({ type: 'png' });\n        await Actor.setValue(liveViewKey, buffer, { contentType: 'image/png' });\n        if (logMessage) {\n            log.info(`(\u622A\u56FE): ${logMessage}`);\n        }\n    } catch (e) {\n        log.warning(`\u65E0\u6CD5\u6355\u83B7 Live View \u5C4F\u5E55\u622A\u56FE: ${e.message}`);\n    }\n}\n\nconst useLiveView = (liveViewKey = PresetOfLiveViewKey) => {\n    return {\n        takeLiveScreenshot: async (page, logMessage) => {\n            return await takeLiveScreenshot(liveViewKey, page, logMessage)\n        },\n        startLiveViewServer: async () => {\n            return await startLiveViewServer(liveViewKey);\n        }\n    }\n}\n\nexport const LiveView = {\n    useLiveView,\n};\n"],
+  "mappings": "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",
+  "names": ["import_crawlee", "import_crawlee", "delay", "import_crawlee", "import_apify", "express"]
+}

package/dist/index.js

@@ -0,0 +1,350 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/apify-kit.js
+import { log } from "crawlee";
+import { Actor } from "apify";
+
+// src/constants.js
+var constants_exports = {};
+__export(constants_exports, {
+  ErrorKeygen: () => ErrorKeygen,
+  FAILED_KEY_SEPARATOR: () => FAILED_KEY_SEPARATOR,
+  PresetOfLiveViewKey: () => PresetOfLiveViewKey,
+  Status: () => Status,
+  StatusCode: () => StatusCode
+});
+var ErrorKeygen = {
+  NotLogin: 30000001,
+  Chaptcha: 30000002
+};
+var Status = {
+  Success: "SUCCESS",
+  Failed: "FAILED"
+};
+var StatusCode = {
+  Success: 0,
+  Failed: -1
+};
+var FAILED_KEY_SEPARATOR = "::<@>::";
+var PresetOfLiveViewKey = "LIVE_VIEW_SCREENSHOT";
+
+// src/apify-kit.js
+var 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
+    });
+  }
+};
+
+// src/utils.js
+var 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;
+  }
+};
+
+// src/stealth.js
+import { log as log2 } from "crawlee";
+var 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
+      });
+      log2.info(`[Stealth] Viewport synced to fingerprint: ${screen.width}x${screen.height}`);
+    } catch (e) {
+      log2.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' 
+    ];
+  }
+};
+
+// src/humanize.js
+import delay from "delay";
+import { log as log3 } from "crawlee";
+var 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);
+    }
+  }
+};
+
+// src/launch.js
+var 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 兼容容器
+    };
+  }
+};
+
+// src/live-view.js
+import express from "express";
+import { log as log4 } from "crawlee";
+import { Actor as Actor2 } from "apify";
+async function startLiveViewServer(liveViewKey) {
+  const app = express();
+  app.get("/", async (req, res) => {
+    try {
+      const screenshotBuffer = await Actor2.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) {
+      log4.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, () => {
+    log4.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 Actor2.setValue(liveViewKey, buffer, { contentType: "image/png" });
+    if (logMessage) {
+      log4.info(`(\u622A\u56FE): ${logMessage}`);
+    }
+  } catch (e) {
+    log4.warning(`\u65E0\u6CD5\u6355\u83B7 Live View \u5C4F\u5E55\u622A\u56FE: ${e.message}`);
+  }
+}
+var useLiveView = (liveViewKey = PresetOfLiveViewKey) => {
+  return {
+    takeLiveScreenshot: async (page, logMessage) => {
+      return await takeLiveScreenshot(liveViewKey, page, logMessage);
+    },
+    startLiveViewServer: async () => {
+      return await startLiveViewServer(liveViewKey);
+    }
+  };
+};
+var LiveView = {
+  useLiveView
+};
+
+// index.js
+var usePlaywrightToolKit = () => {
+  return {
+    ApifyKit,
+    Stealth,
+    Humanize,
+    Launch,
+    LiveView,
+    Constants: constants_exports,
+    Utils
+  };
+};
+export {
+  usePlaywrightToolKit
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/apify-kit.js", "../src/constants.js", "../src/utils.js", "../src/stealth.js", "../src/humanize.js", "../src/launch.js", "../src/live-view.js", "../index.js"],
+  "sourcesContent": ["import { log } from 'crawlee';\nimport { Actor } from 'apify';\nimport { Status, FAILED_KEY_SEPARATOR, StatusCode } from './constants.js';\n\nexport const ApifyKit = {\n\n    /**\n     * \u5305\u88C5 Step Name\n     */\n    wrapStepNameWithFailedKey(key, stepName) {\n        return `${key}${FAILED_KEY_SEPARATOR}${stepName}`;\n    },\n\n    /**\n     * \u89E3\u5305 Step Name\n     */\n    unwrapStepName(stepName) {\n        const splitIndex = stepName.indexOf(FAILED_KEY_SEPARATOR);\n        if (splitIndex === -1) {\n            return ['-', stepName];\n        }\n        const key = stepName.substring(0, splitIndex);\n        const value = stepName.substring(splitIndex + FAILED_KEY_SEPARATOR.length);\n        return [key, value];\n    },\n\n    /**\n     * \u6838\u5FC3\u5C01\u88C5\uFF1A\u6267\u884C\u6B65\u9AA4\uFF0C\u5E26\u81EA\u52A8\u65E5\u5FD7\u786E\u8BA4\u548C\u5931\u8D25\u622A\u56FE\u5904\u7406\n     */\n    async runStep(pendingStepName, page, actionFn, options = {}) {\n        const { failActor = true } = options;  // \u9ED8\u8BA4\u8C03\u7528 Actor.fail\n        const [failedKey, stepName] = this.unwrapStepName(pendingStepName);\n\n        log.info(`\uD83D\uDD04 [\u6B63\u5728\u6267\u884C] ${stepName}...`);\n\n        try {\n            const result = await actionFn();\n            log.info(`\u2705 [\u6267\u884C\u6210\u529F] ${stepName}`);\n            return result;\n        } catch (error) {\n            log.error(`\u274C [\u6267\u884C\u5931\u8D25] ${stepName}: ${error.message}`);\n\n            let screenshotBase64 = '\u622A\u56FE\u5931\u8D25';\n            try {\n                if (page) {\n                    const buffer = await page.screenshot({ fullPage: true, type: 'jpeg', quality: 60 });\n                    screenshotBase64 = `data:image/jpeg;base64,${buffer.toString('base64')}`;\n                }\n            } catch (snapErr) {\n                log.warning(`\u622A\u56FE\u751F\u6210\u5931\u8D25: ${snapErr.message}`);\n            }\n\n            // \u4F7F\u7528 pushFailed \u65B9\u6CD5\u63A8\u9001\u5931\u8D25\u6570\u636E\uFF08\u79C1\u6709\u4F7F\u7528\uFF09\n            await this.pushFailed(error, {\n                failedStep: stepName,\n                failedKey: failedKey,\n                errorMessage: error.message,\n                errorStack: error.stack,\n                screenshotBase64: screenshotBase64\n            });\n\n            // \u6839\u636E failActor \u51B3\u5B9A\u662F\u5426\u8C03\u7528 Actor.fail\n            if (failActor) {\n                await Actor.fail(`Run Step ${stepName} \u5931\u8D25: ${error.message}`);\n            } else {\n                // \u4E0D\u8C03\u7528 Actor.fail\uFF0C\u76F4\u63A5\u629B\u51FA\u9519\u8BEF\n                throw error;\n            }\n        }\n    },\n\n    /**\n     * \u5BBD\u677E\u7248runStep\uFF1A\u5931\u8D25\u65F6\u4E0D\u8C03\u7528Actor.fail\uFF0C\u53EA\u629B\u51FA\u5F02\u5E38\n     */\n    async runStepLoose(stepName, page, fn) {\n        return await this.runStep(stepName, page, fn, { failActor: false });\n    },\n\n    /**\n     * \u63A8\u9001\u6210\u529F\u6570\u636E\u7684\u901A\u7528\u65B9\u6CD5\n     * @param {Object} data - \u8981\u63A8\u9001\u7684\u6570\u636E\u5BF9\u8C61\n     */\n    async pushSuccess(data) {\n        await Actor.pushData({\n            code: StatusCode.Success,\n            status: Status.Success,\n            timestamp: new Date().toISOString(),\n            ...data\n        });\n    },\n\n    /**\n     * \u63A8\u9001\u5931\u8D25\u6570\u636E\u7684\u901A\u7528\u65B9\u6CD5\uFF08\u79C1\u6709\u65B9\u6CD5\uFF0C\u4EC5\u4F9BrunStep\u5185\u90E8\u4F7F\u7528\uFF09\n     * @param {Error|Object} error - \u9519\u8BEF\u5BF9\u8C61\uFF08\u53EF\u5305\u542B\u5176\u4ED6\u7684\u9519\u8BEF/\u6216\u90E8\u5206\u5904\u7406\u6210\u529F\u7684\u989D\u5916\u4FE1\u606F\uFF09\n     * @param {Object} [meta] - \u989D\u5916\u7684\u6570\u636E\uFF08\u5982failedStep, screenshotBase64\u7B49\uFF0C\u4EC5runStep\u4F7F\u7528\uFF09\n     * @private\n     */\n    async pushFailed(error, meta = {}) {\n        await Actor.pushData({\n            code: StatusCode.Failed,\n            status: Status.Failed,\n            // \u8FD9\u91CC\u53EF\u80FD\u5E26\u5176\u4ED6\u9519\u8BEF\u4FE1\u606F\n            error,\n            timestamp: new Date().toISOString(),\n            ...meta\n        });\n    }\n}\n", "export const ErrorKeygen = {\n    NotLogin: 30000001,\n    Chaptcha: 30000002,\n}\n\nexport const Status = {\n    Success: 'SUCCESS',\n    Failed: 'FAILED'\n}\n\nexport const StatusCode = {\n    Success: 0,\n    Failed: -1\n}\n\nexport const FAILED_KEY_SEPARATOR = '::<@>::';\n\nexport const PresetOfLiveViewKey = 'LIVE_VIEW_SCREENSHOT';\n", "export const Utils = {\n    /**\n    * \u89E3\u6790 SSE \u6D41\u6587\u672C\n    */\n    parseSseStream(sseStreamText) {\n        const events = [];\n        const lines = sseStreamText.split('\\n');\n        for (const line of lines) {\n            if (line.startsWith('data: ')) {\n                try {\n                    const jsonContent = line.substring(6).trim();\n                    if (jsonContent && jsonContent !== '[DONE]') {\n                        events.push(JSON.parse(jsonContent));\n                    }\n                } catch (e) {\n                    // Ignore lines that are not valid JSON\n                }\n            }\n        }\n        return events;\n    }\n}\n", "import { log } from 'crawlee';\n\nexport const Stealth = {\n    /**\n     * \u5173\u952E\u4FEE\u590D\uFF1A\u5C06 Page \u89C6\u53E3\u8C03\u6574\u4E3A\u4E0E\u6D4F\u89C8\u5668\u6307\u7EB9 (window.screen) \u4E00\u81F4\u3002\n     * \u9632\u6B62 \"Viewport Mismatch\" \u7C7B\u578B\u7684\u53CD\u722C\u68C0\u6D4B\u3002\n     * @param {import('playwright').Page} page \n     */\n    async syncViewportWithScreen(page) {\n        try {\n            // \u83B7\u53D6\u6307\u7EB9\u4E2D\u7684\u5C4F\u5E55\u5C3A\u5BF8\n            const screen = await page.evaluate(() => ({\n                width: window.screen.width,\n                height: window.screen.height,\n                availWidth: window.screen.availWidth,\n                availHeight: window.screen.availHeight,\n            }));\n\n            // \u8C03\u6574\u89C6\u53E3\n            await page.setViewportSize({\n                width: screen.width,\n                height: screen.height\n            });\n\n            log.info(`[Stealth] Viewport synced to fingerprint: ${screen.width}x${screen.height}`);\n        } catch (e) {\n            log.warning(`[Stealth] Failed to sync viewport: ${e.message}. Fallback to 1920x1080.`);\n            await page.setViewportSize({ width: 1920, height: 1080 });\n        }\n    },\n\n    /**\n     * \u786E\u4FDD navigator.webdriver \u9690\u85CF (\u901A\u5E38 Playwright Stealth \u63D2\u4EF6\u5DF2\u5904\u7406\uFF0C\u4F46\u53CC\u91CD\u4FDD\u9669)\n     */\n    async hideWebdriver(page) {\n        await page.addInitScript(() => {\n            Object.defineProperty(navigator, 'webdriver', {\n                get: () => false,\n            });\n        });\n    },\n\n    /**\n     * \u901A\u7528\u7684 Playwright \u8D44\u6E90\u62E6\u622A\u5668\uFF0C\u7528\u4E8E\u5C4F\u853D\u4E0D\u5FC5\u8981\u7684\u8D44\u6E90\u4EE5\u52A0\u901F\u52A0\u8F7D\n     * @param {import('playwright').Page} page\n     * @param {string[]} [resourceTypes] - \u8981\u5C4F\u853D\u7684\u8D44\u6E90\u7C7B\u578B\uFF0C\u9ED8\u8BA4\u4E3A ['font', 'image', 'media']\n     */\n    async setupBlockingResources(page, resourceTypes = ['font', 'image', 'media']) {\n        await page.route('**/*', (route) => {\n            const request = route.request();\n            const type = request.resourceType();\n            if (resourceTypes.includes(type)) {\n                return route.abort();\n            }\n            return route.continue();\n        });\n    },\n\n    /**\n     * \u83B7\u53D6\u63A8\u8350\u7684 Stealth \u542F\u52A8\u53C2\u6570\n     */\n    getStealthLaunchArgs() {\n        return [\n            '--disable-blink-features=AutomationControlled',\n            '--no-sandbox',\n            '--disable-setuid-sandbox',\n            '--disable-infobars',\n            '--window-position=0,0',\n            '--ignore-certificate-errors',\n            '--disable-web-security',\n            // \u6CE8\u610F\uFF1A\u4E0D\u5EFA\u8BAE\u8FD9\u91CC\u5F3A\u5236\u6307\u5B9A window-size\uFF0C\u8BA9 syncViewportWithScreen \u53BB\u52A8\u6001\u8C03\u6574\n            // '--window-size=1920,1080' \n        ];\n    }\n}\n", "import delay from 'delay';\nimport { log } from 'crawlee';\n\nexport const Humanize = {\n    /**\n     * \u968F\u673A\u5EF6\u8FDF\u4E00\u6BB5\u6BEB\u79D2\u6570 (API Wrapper for 'delay' package)\n     * @param {number} min - \u6700\u5C0F\u6BEB\u79D2\n     * @param {number} max - \u6700\u5927\u6BEB\u79D2\n     */\n    async randomSleep(min, max) {\n        const ms = typeof max === 'number'\n            ? delay.range(min, max)\n            : delay(min); // \u5982\u679C\u53EA\u4F20\u4E00\u4E2A\u53C2\u6570\uFF0C\u89C6\u4E3A\u56FA\u5B9A\u5EF6\u8FDF\u6216\u6700\u5C0F\u5EF6\u8FDF\n\n        // log.debug(`[Humanize] Sleeping for ${await ms} ms...`); // delay return promise acts like number somewhat but best await it\n        // The delay package returns a promise that resolves after the delay.\n        // delay.range() returns a promise too.\n\n        await ms;\n    },\n\n    /**\n     * \u6A21\u62DF\u4EBA\u7C7B\u201C\u6CE8\u89C6\u201D\u6216\u201C\u9605\u8BFB\u201D\u884C\u4E3A\uFF1A\u9F20\u6807\u5728\u9875\u9762\u4E0A\u968F\u673A\u5FAE\u52A8\u3002\n     * @param {import('ghost-cursor-playwright').GhostCursor} cursor \n     * @param {number} durationMs - \u6301\u7EED\u65F6\u95F4\n     */\n    async simulateGaze(cursor, durationMs = 2000) {\n        const startTime = Date.now();\n        while (Date.now() - startTime < durationMs) {\n            // \u968F\u673A\u5C0F\u5E45\u5EA6\u79FB\u52A8\n            const x = Math.random() * 800;\n            const y = Math.random() * 600;\n            await cursor.moveTo({ x, y });\n            await delay.range(200, 800);\n        }\n    }\n}\n", "// \u96C6\u4E2D\u7BA1\u7406\u542F\u52A8\u914D\u7F6E\uFF0C\u6682\u65F6\u4E3B\u8981\u7531 Stealth \u6A21\u5757\u63D0\u4F9B Args\uFF0C\u8FD9\u91CC\u4F5C\u4E3A\u6269\u5C55\u70B9\nimport { Stealth } from './stealth.js';\n\nexport const Launch = {\n    getLaunchOptions(customArgs = []) {\n        return {\n            args: [\n                ...Stealth.getStealthLaunchArgs(),\n                ...customArgs\n            ],\n            ignoreDefaultArgs: ['--enable-automation'],\n        };\n    },\n\n    /**\n     * \u63A8\u8350\u7684 Fingerprint Generator \u9009\u9879\n     * \u786E\u4FDD\u751F\u6210\u7684\u662F\u684C\u9762\u7AEF\u3001\u8F83\u65B0\u7684 Chrome\uFF0C\u4EE5\u5339\u914D\u6211\u4EEC\u7684\u811A\u672C\u903B\u8F91\n     */\n    getFingerprintGeneratorOptions() {\n        return {\n            browsers: [{ name: 'chrome', minVersion: 110 }],\n            devices: ['desktop'],\n            operatingSystems: ['windows', 'linux'], // \u5305\u542B Linux \u517C\u5BB9\u5BB9\u5668\n        };\n    }\n}\n", "import express from 'express';\nimport { log } from 'crawlee';\nimport { Actor } from 'apify';\nimport { PresetOfLiveViewKey } from './constants';\n\n/**\n * \u542F\u52A8\u4E00\u4E2A Web \u670D\u52A1\u5668\u4EE5\u5728 Live View \u9009\u9879\u5361\u4E2D\u663E\u793A\u6700\u65B0\u7684\u5C4F\u5E55\u622A\u56FE\u3002\n */\nasync function startLiveViewServer(liveViewKey) {\n    const app = express();\n\n    app.get('/', async (req, res) => {\n        try {\n            // \u4ECE\u9ED8\u8BA4\u7684 Key-Value Store \u4E2D\u8BFB\u53D6\u6700\u65B0\u7684\u5C4F\u5E55\u622A\u56FE\n            const screenshotBuffer = await Actor.getValue(liveViewKey);\n\n            if (!screenshotBuffer) {\n                // \u5982\u679C\u8FD8\u6CA1\u6709\u622A\u56FE\uFF0C\u53D1\u9001\u4E00\u4E2A\u81EA\u52A8\u5237\u65B0\u7684\u5360\u4F4D\u9875\u9762\n                res.send('<html><head><meta http-equiv=\"refresh\" content=\"2\"></head><body>\u7B49\u5F85\u7B2C\u4E00\u4E2A\u5C4F\u5E55\u622A\u56FE...</body></html>');\n                return;\n            }\n\n            // \u5C06 Buffer \u8F6C\u6362\u4E3A Base64 \u5B57\u7B26\u4E32\n            const screenshotBase64 = screenshotBuffer.toString('base64');\n\n            // \u53D1\u9001\u4E00\u4E2A HTML \u9875\u9762\uFF0C\u8BE5\u9875\u9762\u6BCF 1 \u79D2\u81EA\u52A8\u5237\u65B0\u4E00\u6B21\uFF0C\u5E76\u663E\u793A\u622A\u56FE\n            res.send(`\n                <html>\n                    <head>\n                        <title>Live View (\u622A\u56FE)</title>\n                        <meta http-equiv=\"refresh\" content=\"1\">\n                    </head>\n                    <body style=\"margin:0; padding:0;\">\n                        <img src=\"data:image/png;base64,${screenshotBase64}\" \n                             alt=\"Live View Screenshot\" \n                             style=\"width: 100%; height: auto;\" />\n                    </body>\n                </html>\n            `);\n        } catch (error) {\n            log.error(`Live View \u670D\u52A1\u5668\u9519\u8BEF: ${error.message}`);\n            res.status(500).send(`\u65E0\u6CD5\u52A0\u8F7D\u5C4F\u5E55\u622A\u56FE: ${error.message}`);\n        }\n    });\n\n    // \u76D1\u542C Apify \u5BB9\u5668\u7AEF\u53E3 \n    const port = process.env.APIFY_CONTAINER_PORT || 4321;\n    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`); });\n}\n\n/**\n * \u62CD\u6444\u5F53\u524D\u9875\u9762\u7684\u5C4F\u5E55\u622A\u56FE\u5E76\u5C06\u5176\u4FDD\u5B58\u5230 Key-Value Store\u3002\n * @param {import('playwright').Page} page\n * @param {string} [logMessage] - \u53EF\u9009\u7684\u65E5\u5FD7\u6D88\u606F\u3002\n */\nasync function takeLiveScreenshot(liveViewKey, page, logMessage) {\n    try {\n        const buffer = await page.screenshot({ type: 'png' });\n        await Actor.setValue(liveViewKey, buffer, { contentType: 'image/png' });\n        if (logMessage) {\n            log.info(`(\u622A\u56FE): ${logMessage}`);\n        }\n    } catch (e) {\n        log.warning(`\u65E0\u6CD5\u6355\u83B7 Live View \u5C4F\u5E55\u622A\u56FE: ${e.message}`);\n    }\n}\n\nconst useLiveView = (liveViewKey = PresetOfLiveViewKey) => {\n    return {\n        takeLiveScreenshot: async (page, logMessage) => {\n            return await takeLiveScreenshot(liveViewKey, page, logMessage)\n        },\n        startLiveViewServer: async () => {\n            return await startLiveViewServer(liveViewKey);\n        }\n    }\n}\n\nexport const LiveView = {\n    useLiveView,\n};\n", "import { ApifyKit } from './src/apify-kit.js';\nimport { Utils } from './src/utils.js';\nimport { Stealth } from './src/stealth.js';\nimport { Humanize } from './src/humanize.js';\nimport { Launch } from './src/launch.js';\nimport { LiveView } from './src/live-view.js';\nimport * as Constants from './src/constants.js';\n\n// Unified Entry Point\nexport const usePlaywrightToolKit = () => {\n    return {\n        ApifyKit,\n        Stealth,\n        Humanize,\n        Launch,\n        LiveView,\n        Constants,\n        Utils\n    };\n};\n"],
+  "mappings": "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",
+  "names": ["log", "log", "log", "Actor", "Actor", "log"]
+}

package/package.json

@@ -1,12 +1,27 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
-  "main": "index.js",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
   "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
   "scripts": {
+    "build": "node build.js",
+    "release": "npm run build && npm publish",
+    "prepublishOnly": "npm run build",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
+  "files": [
+    "dist/",
+    "docs/",
+    "README.md"
+  ],
   "keywords": [
     "apify",
     "crawlee",
@@ -24,5 +39,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;
-    }
-}