@skrillex1224/playwright-toolkit 2.0.18 → 2.0.19

package/README.md

@@ -1,56 +1,51 @@
-# Playwright Toolkit - Tools (Utilities)
+# Playwright Toolkit
 
-> **类型**: Tools (通用工具库)
-> **用途**: 面向 Apify/Crawlee Actor 开发者的实用工具库。
-
-
-一个面向 Apify/Crawlee Actor 开发者的实用工具库，提供实时截图展示（Live View）、健壮的步骤执行封装、以及常用的 Playwright 优化工具。
+> 面向 Apify/Crawlee Actor 开发者的实用工具库，提供反检测、拟人化操作、实时截图等功能。
 
 ## 📦 安装
 
 ```bash
 npm install @skrillex1224/playwright-toolkit
-```
-
-## 🛡️ 反检测功能 (Anti-Detection)
-
-本工具库提供多层次的反检测能力，帮助绕过常见的爬虫检测机制。
-
-### 反检测层次架构
 
-| 层次 | 问题 | 解决方案 | 相关库 |
-|------|------|----------|--------|
-| **指纹层 (JS)** | navigator.webdriver, plugins, webgl | Stealth 插件 | `puppeteer-extra-plugin-stealth` |
-| **行为层** | 机械输入/点击/滚动 | 人类化模拟 | `ghost-cursor-playwright` |
-| **页面层** | 验证码/风控检测 | 监控器 | toolkit 内置 |
-
-> **注意**: `rebrowser-playwright` 与 `playwright-extra` 不兼容，如需要 CDP 层反检测，需要选择其一。
+# 反检测所需的依赖
+npm install playwright-extra puppeteer-extra-plugin-stealth ghost-cursor-playwright
+```
 
-### 快速开始
+## 🚀 快速开始
 
 ```javascript
+import { Actor } from 'apify';
+import { PlaywrightCrawler } from 'crawlee';
 import { chromium } from 'playwright-extra';
 import stealthPlugin from 'puppeteer-extra-plugin-stealth';
 import { createCursor } from 'ghost-cursor-playwright';
 import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
 
-const { Launch, Humanize, Captcha, Stealth } = usePlaywrightToolKit();
+await Actor.init();
 
-// 1. 创建 Stealth 浏览器
+// 初始化工具箱
+const { ApifyKit: KitHook, Launch, Stealth, Humanize, Captcha, LiveView, Constants } = usePlaywrightToolKit();
+
+// ⚠️ ApifyKit 需要异步初始化
+const ApifyKit = await KitHook.useApifyKit();
+
+// 创建 Stealth 浏览器
 const stealthChromium = Launch.createStealthChromium(chromium, stealthPlugin);
 
-// 2. 在 Crawler 中使用
+// LiveView
+const { startLiveViewServer, takeLiveScreenshot } = LiveView.useLiveView();
+
 const crawler = new PlaywrightCrawler({
     launchContext: {
         launcher: stealthChromium,
-        launchOptions: Launch.getAdvancedLaunchOptions(), // 增强版启动参数
+        launchOptions: Launch.getAdvancedLaunchOptions(),
     },
     preNavigationHooks: [
         async ({ page }) => {
-            // 3. 同步视口 (防指纹检测)
+            // 同步视口 (防指纹检测)
             await Stealth.syncViewportWithScreen(page);
             
-            // 4. 启动验证码监控
+            // 验证码监控
             Captcha.useCaptchaMonitor(page, {
                 domSelector: '#captcha_container',
                 onDetected: async () => { /* 处理验证码 */ }
@@ -58,226 +53,139 @@ const crawler = new PlaywrightCrawler({
         }
     ],
     requestHandler: async ({ page }) => {
-        // 5. 创建 Ghost Cursor
+        // 创建 Ghost Cursor
         const cursor = await Launch.createGhostCursor(page, createCursor);
         
-        // 6. 页面预热 (模拟人类浏览)
+        // 页面预热 (模拟人类浏览)
         await Humanize.warmUpBrowsing(page, cursor, 3000);
         
-        // 7. 人类化输入
-        await Humanize.humanType(page, 'input', '搜索内容');
+        // 执行步骤 (失败时自动截图并调用 Actor.fail)
+        await ApifyKit.runStep('输入搜索', page, async () => {
+            await Humanize.humanType(page, 'input', '搜索内容');
+            await Humanize.humanClick(page, cursor, '#submit-btn');
+        });
         
-        // 8. 人类化点击
-        await Humanize.humanClick(page, cursor, '#submit-btn');
+        // 推送成功数据
+        await ApifyKit.pushSuccess({ result: 'data' });
     }
 });
-```
-
-### 反检测 API 一览
-
-| 模块 | 方法 | 说明 |
-|------|------|------|
-| `Launch` | `createStealthChromium(chromium, stealthPlugin)` | 创建已注册 Stealth 的 Chromium |
-| `Launch` | `createGhostCursor(page, createCursor)` | 创建 Ghost Cursor 实例 |
-| `Launch` | `getAdvancedLaunchOptions()` | 获取增强版反检测启动参数 |
-| `Stealth` | `syncViewportWithScreen(page)` | 同步视口与屏幕指纹 |
-| `Stealth` | `hideWebdriver(page)` | 隐藏 navigator.webdriver |
-| `Humanize` | `humanType(page, selector, text)` | 人类化输入 (节奏变化) |
-| `Humanize` | `humanClick(page, cursor, selector)` | 人类化点击 (贝塞尔曲线) |
-| `Humanize` | `warmUpBrowsing(page, cursor, durationMs)` | 页面预热浏览 |
-| `Humanize` | `naturalScroll(page, direction, distance)` | 自然滚动 (带惯性) |
-| `Captcha` | `useCaptchaMonitor(page, options)` | 验证码监控 (DOM/URL) |
-
 
+await startLiveViewServer();
+await crawler.run(['https://example.com']);
+await Actor.exit();
+```
 
-### 1. Live View (实时截图展示)
-
-启动一个本地 Express 服务器，在 Apify 平台的 "Live View" 选项卡中实时查看浏览器当前状态。
-
-```javascript
-import { useLiveView } from '@skrillex1224/visitor-tools';
-
-const liveView = useLiveView();
+---
 
-// 启动 Live View 服务器
-await liveView.startLiveViewServer();
+## 🛡️ 反检测功能
 
-// 在循环或步骤中捕获截图
-await liveView.takeLiveScreenshot(page, "正在处理步骤 1...");
-```
+### 架构
 
-**工作原理**：
-- 截图保存到 Apify Key-Value Store
-- Express 服务器从 Store 读取最新截图
-- 页面每 1 秒自动刷新，展示实时状态
+| 层次 | 问题 | 解决方案 |
+|------|------|----------|
+| **指纹层** | navigator.webdriver, plugins, webgl | `puppeteer-extra-plugin-stealth` |
+| **行为层** | 机械输入/点击/滚动 | `ghost-cursor-playwright` + Humanize |
+| **页面层** | 验证码/风控检测 | Captcha 监控器 |
 
-### 2. 健壮的步骤执行 (`runStep`)
+### API 一览
 
-将你的逻辑包装在 `runStep` 中，自动处理日志记录和失败截图。如果步骤失败，会自动捕获全页截图并将错误详情推送到 Dataset。
+| 模块 | 方法 | 说明 |
+|------|------|------|
+| `Launch` | `createStealthChromium(chromium, stealthPlugin)` | 注册 Stealth 插件 |
+| `Launch` | `createGhostCursor(page, createCursor)` | 创建 Ghost Cursor |
+| `Launch` | `getAdvancedLaunchOptions()` | 增强版启动参数 |
+| `Launch` | `getLaunchOptions()` | 基础启动参数 |
+| `Launch` | `getFingerprintGeneratorOptions()` | 指纹生成器选项 |
+| `Stealth` | `syncViewportWithScreen(page)` | 同步视口与屏幕 |
+| `Stealth` | `hideWebdriver(page)` | 隐藏 webdriver |
+| `Stealth` | `setupBlockingResources(page, types?)` | 资源拦截 |
+| `Humanize` | `humanType(page, selector, text, options?)` | 人类化输入 |
+| `Humanize` | `humanClick(page, cursor, selector, options?)` | 人类化点击 |
+| `Humanize` | `warmUpBrowsing(page, cursor, durationMs?)` | 页面预热 |
+| `Humanize` | `naturalScroll(page, direction?, distance?, steps?)` | 自然滚动 |
+| `Humanize` | `simulateGaze(cursor, durationMs?)` | 模拟注视 |
+| `Humanize` | `randomSleep(min, max)` | 随机延迟 |
+| `Captcha` | `useCaptchaMonitor(page, options)` | 验证码监控 |
+
+---
+
+## 📦 模块详解
+
+### ApifyKit
+
+**⚠️ 需要异步初始化**
 
 ```javascript
-import { Utils } from '@skrillex1224/visitor-tools';
+const { ApifyKit: KitHook } = usePlaywrightToolKit();
+const ApifyKit = await KitHook.useApifyKit();
 
-await Utils.runStep('登录步骤', page, async () => {
-    await page.click('#login');
-    await page.fill('#username', 'user');
+// 执行步骤 (失败时自动截图 + 推送 Dataset + 调用 Actor.fail)
+await ApifyKit.runStep('步骤名', page, async () => {
+    // 你的逻辑
 });
-```
 
-**失败输出示例**：
-```json
-{
-  "status": "FAILED",
-  "failedStep": "登录步骤",
-  "errorMessage": "Timeout 30000ms exceeded",
-  "errorStack": "...",
-  "screenshotBase64": "data:image/jpeg;base64,...",
-  "timestamp": "2025-12-15T03:00:00.000Z"
-}
-```
+// 宽松版 (失败时只抛出异常，不调用 Actor.fail)
+await ApifyKit.runStepLoose('步骤名', page, async () => {
+    // 你的逻辑
+});
 
-### 3. Playwright 优化工具
+// 推送成功数据
+await ApifyKit.pushSuccess({ key: 'value' });
 
-#### 资源拦截 - 加速页面加载
+// 步骤名包装 (用于失败分类追踪)
+const wrappedName = ApifyKit.wrapStepNameWithFailedKey(30000001, '等待登录');
+const [failedKey, stepName] = ApifyKit.unwrapStepName(wrappedName);
+```
 
-通过屏蔽字体、图片、媒体等资源来加快爬取速度：
+### LiveView
 
 ```javascript
-// 默认屏蔽 font, image, media
-await Utils.setupBlockingResources(page);
+const { LiveView } = usePlaywrightToolKit();
+const { startLiveViewServer, takeLiveScreenshot } = LiveView.useLiveView();
 
-// 自定义屏蔽类型
-await Utils.setupBlockingResources(page, ['stylesheet', 'font', 'image']);
+await startLiveViewServer();
+await takeLiveScreenshot(page, '当前状态');
 ```
 
-#### 视口设置
+### Captcha
 
 ```javascript
-await Utils.setupViewport(page, 1920, 1080);
-```
-
-### 4. SSE 解析工具
+const { Captcha } = usePlaywrightToolKit();
 
-解析 Server-Sent Events (SSE) 流式数据的辅助函数：
+// DOM 监控模式
+Captcha.useCaptchaMonitor(page, {
+    domSelector: '#captcha_container',
+    onDetected: async () => { await Actor.fail('检测到验证码'); }
+});
 
-```javascript
-const events = Utils.parseSseStream(responseText);
-// 返回一个数组，包含所有解析后的 JSON 对象
+// URL 监控模式
+Captcha.useCaptchaMonitor(page, {
+    urlPattern: '/captcha',
+    onDetected: async () => { await Actor.fail('检测到验证码'); }
+});
 ```
 
-### 5. 失败键包装 (Failed Key Wrapping)
-
-为步骤名称添加自定义的失败标识符，方便在失败时进行分类和追踪：
+### Constants
 
 ```javascript
-import { wrapStepNameWithFailedKey, unwrapStepName, ErrorKeygen } from '@skrillex1224/visitor-tools';
-
-// 包装步骤名称
-const wrappedName = wrapStepNameWithFailedKey(ErrorKeygen.NotLogin, '等待登录');
+const { Constants } = usePlaywrightToolKit();
+const { ErrorKeygen, Status, StatusCode } = Constants;
 
-// 解包
-const [failedKey, stepName] = unwrapStepName(wrappedName);
-// failedKey: 30000001
-// stepName: '等待登录'
+// ErrorKeygen: { NotLogin: 30000001, Chaptcha: 30000002 }
+// Status: { Success: 'SUCCESS', Failed: 'FAILED' }
+// StatusCode: { Success: 0, Failed: -1 }
 ```
 
-## 📚 完整示例
+### Utils
 
 ```javascript
-import { Actor } from 'apify';
-import { PlaywrightCrawler } from 'crawlee';
-import { useLiveView, Utils } from '@skrillex1224/visitor-tools';
+const { Utils } = usePlaywrightToolKit();
 
-await Actor.init();
-
-const { startLiveViewServer, takeLiveScreenshot } = useLiveView();
-
-const crawler = new PlaywrightCrawler({
-    preNavigationHooks: [
-        async ({ page }) => {
-            await Utils.setupViewport(page);
-            await Utils.setupBlockingResources(page);
-        },
-    ],
-    requestHandler: async ({ page }) => {
-        await takeLiveScreenshot(page, '页面加载完成');
-        
-        await Utils.runStep('点击登录按钮', page, async () => {
-            await page.click('#login-btn');
-        });
-        
-        await takeLiveScreenshot(page, '登录成功');
-    },
-});
-
-await startLiveViewServer();
-await crawler.run(['https://example.com']);
-await Actor.exit();
+// 解析 SSE 流文本
+const events = Utils.parseSseStream(sseText);
 ```
 
-## 🛠️ API 文档
-
-### `useLiveView(liveViewKey?)`
-
-创建 Live View 实例。
-
-- **参数**：
-  - `liveViewKey` (可选): Key-Value Store 中的键名，默认为 `'LIVE_VIEW_SCREENSHOT'`
-  
-- **返回对象**：
-  - `startLiveViewServer()`: 启动 Express 服务器
-  - `takeLiveScreenshot(page, logMessage?)`: 捕获截图并保存
-
-### `Utils.runStep(stepName, page, actionFn)`
-
-执行一个步骤并自动处理失败。## 模块文档
-
-详细文档请参阅 `docs/` 目录：
-
-- [ApifyKit](./docs/apify-kit.md): Apify Actor 流程控制与数据全
-- [Stealth](./docs/stealth.md): 反爬虫与指纹隐身
-- [Humanize](./docs/humanize.md): 拟人化操作模拟
-- [LiveView](./docs/live-view.md): 实时屏幕截图预览
-- [Launch](./docs/launch.md): 浏览器启动配置
-- [Utils](./docs/utils.md): 通用工具函数
-- [Constants](./docs/constants.md): 常量定义
-
-- **参数**：
-  - `stepName`: 步骤名称 (支持使用 `wrapStepNameWithFailedKey` 包装)
-  - `page`: Playwright Page 对象
-  - `actionFn`: 要执行的异步函数
-
-### `Utils.setupBlockingResources(page, resourceTypes?)`
-
-设置资源拦截器。
-
-- **参数**：
-  - `page`: Playwright Page 对象
-  - `resourceTypes` (可选): 要屏蔽的资源类型数组，默认为 `['font', 'image', 'media']`
-
-### `Utils.setupViewport(page, width?, height?)`
-
-设置浏览器视口大小。
-
-- **参数**：
-  - `page`: Playwright Page 对象
-  - `width` (可选): 宽度，默认 1920
-  - `height` (可选): 高度，默认 1080
-
-### `Utils.parseSseStream(sseStreamText)`
-
-解析 SSE 流文本为 JSON 对象数组。
-
-- **参数**：
-  - `sseStreamText`: SSE 格式的文本
-  
-- **返回**: JSON 对象数组
-
-## 📝 注意事项
-
-- Live View 仅在 Apify 平台运行时可见（通过 Live View 选项卡）
-- `runStep` 捕获的截图是全页截图（JPEG 格式，质量 60），用于减少数据量
-- 资源拦截会显著提升加载速度，但可能影响需要图片/样式的页面
+---
 
 ## 📄 License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "2.0.18",
+  "version": "2.0.19",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -19,7 +19,6 @@
   },
   "files": [
     "dist/",
-    "docs/",
     "README.md"
   ],
   "keywords": [

package/docs/apify-kit.md

@@ -1,59 +0,0 @@
-# ApifyKit
-
-`ApifyKit` 提供了一组用于简化 Apify Actor 开发的实用函数，核心是 `runStep` 机制和数据推送。
-
-## 引入
-
-```javascript
-import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
-const { ApifyKit } = usePlaywrightToolKit();
-```
-
-## 方法
-
-### `runStep(stepName, page, stepFunction)`
-
-执行一个封装的步骤。会自动记录开始日志、执行函数，并捕获错误。
-如果步骤失败，会自动：
-1. 打印带颜色的错误日志。
-2. 拍摄错误截图。
-3. 将错误信息和截图保存到 Default Dataset 中。
-
-**参数:**
-- `stepName` (string): 步骤名称，用于日志和错误报告。
-- `page` (Page): Playwright Page 对象，用于截图。
-- `stepFunction` (function): 包含实际逻辑的异步函数。
-
-**示例:**
-```javascript
-await ApifyKit.runStep('填写登录表单', page, async () => {
-    await page.fill('#username', 'user');
-    await page.fill('#password', 'pass');
-    await page.click('#login');
-});
-```
-
-### `pushSuccess(data)`
-
-将成功的数据推送到 Default Dataset。会自动添加 `status: 'SUCCESS'` 和时间戳。
-
-**参数:**
-- `data` (object): 要推送的数据对象。
-
-**示例:**
-```javascript
-await ApifyKit.pushSuccess({
-    title: 'Product A',
-    price: 99.9
-});
-```
-
-### `pushFailed(stepName, errorMessage, screenshotBase64, kvStoreKey)`
-
-(通常由 `runStep` 内部调用) 将失败信息推送到 Default Dataset。
-
-### `wrapStepNameWithFailedKey(failedKey, stepName)`
-将错误 Key (例如错误码) 绑定到步骤名称上，用于在失败时提取该 Key。
-
-### `unwrapStepName(stepName)`
-解包步骤名称，获取绑定的 Key (如果有)。

package/docs/constants.md

@@ -1,25 +0,0 @@
-# Constants
-
-`Constants` 模块定义了项目中共用的常量、枚举和键名映射。
-
-## 引入
-
-```javascript
-import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
-const { Constants } = usePlaywrightToolKit();
-```
-
-## 导出
-
-### `ErrorKeygen`
-
-常用的错误代码 Key 枚举，用于 standardized error handling。
-
-- `NotLogin`: 'not_login'
-- `CaptchaDetected`: 'captcha_detected'
-- `RegionRestricted`: 'region_restricted'
-- `RateLimited`: 'rate_limited'
-
-### `FAILED_KEY_SEPARATOR`
-
-用于 `ApifyKit.wrapStepNameWithFailedKey` 的分隔符。

package/docs/humanize.md

@@ -1,40 +0,0 @@
-# Humanize
-
-`Humanize` 模块用于模拟人类操作行为，如随机延迟和鼠标移动。
-
-## 引入
-
-```javascript
-import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
-const { Humanize } = usePlaywrightToolKit();
-```
-
-## 方法
-
-### `randomSleep(min, max)`
-
-随机等待一段毫秒数。基于 `delay` 库。
-
-**参数:**
-- `min` (number): 最小延迟 (ms)。
-- `max` (number): (可选) 最大延迟 (ms)。如果未提供，则等待固定的 `min` 时间。
-
-**示例:**
-```javascript
-await Humanize.randomSleep(1000, 3000); // 等待 1-3 秒
-```
-
-### `simulateGaze(cursor, durationMs)`
-
-模拟人类“注视”或“阅读”行为：控制鼠标在页面上进行随机的小幅度移动。需要配合 `ghost-cursor` 使用。
-
-**参数:**
-- `cursor` (GhostCursor): `ghost-cursor` 对象。
-- `durationMs` (number): 持续时间 (ms)，默认为 2000。
-
-**示例:**
-```javascript
-import { createCursor } from 'ghost-cursor-playwright';
-const cursor = await createCursor(page);
-await Humanize.simulateGaze(cursor, 5000);
-```

package/docs/launch.md

@@ -1,32 +0,0 @@
-# Launch
-
-`Launch` 模块提供与浏览器启动和指纹生成相关的辅助配置。
-
-## 引入
-
-```javascript
-import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
-const { Launch } = usePlaywrightToolKit();
-```
-
-## 方法
-
-### `getFingerprintGeneratorOptions(options)`
-
-返回配置好的能够通过检测的指纹生成器选项。
-
-**参数:**
-- `options` (object): (可选) 覆盖默认配置。
-
-**默认配置:**
-- `devices`: ['desktop']
-- `operatingSystems`: ['windows', 'macos']
-- `browsers`: ['chrome', 'edge']
-- `locales`: ['zh-CN', 'en-US']
-
-### `getLaunchOptions(extraArgs)`
-
-返回合并了 Stealth 参数的 Playwright 启动选项。
-
-**参数:**
-- `extraArgs` (string[]): (可选) 额外的启动参数。

package/docs/live-view.md

@@ -1,38 +0,0 @@
-# LiveView
-
-`LiveView` 模块使得在 Apify 平台上运行 Playwright 爬虫（尤其是有头模式）时，能够实时查看浏览器的屏幕截图。
-
-## 引入
-
-```javascript
-import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
-const { LiveView } = usePlaywrightToolKit();
-const { startLiveViewServer, takeLiveScreenshot } = LiveView.useLiveView();
-```
-
-## 方法
-
-### `startLiveViewServer()`
-
-启动一个轻量级的 Express 服务器，用于展示最新的屏幕截图。
-通常在 Actor 启动时调用。
-
-**注意:** 仅在 Apify 平台上且需要 Live View 功能时调用。
-
-### `takeLiveScreenshot(page, logMessage)`
-
-拍摄当前页面的截图，并将其保存到 Key-Value Store 中供 Live Server 展示。
-
-**参数:**
-- `page` (Page): Playwright Page 对象。
-- `logMessage` (string): (可选) 日志消息。
-
-**示例:**
-```javascript
-// 定时截图
-setInterval(() => takeLiveScreenshot(page), 5000);
-```
-
-## 配置
-
-默认使用的 Key 为 `LIVE_VIEW_SCREENSHOT`。可以通过 `useLiveView(customKey)` 自定义。

package/docs/stealth.md

@@ -1,55 +0,0 @@
-# Stealth
-
-`Stealth` 模块提供了一组反爬虫和隐身技术，旨在提高爬虫的存活率和稳定性。
-
-## 引入
-
-```javascript
-import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
-const { Stealth } = usePlaywrightToolKit();
-```
-
-## 方法
-
-### `syncViewportWithScreen(page)`
-
-**关键功能**。将 Playwright 的 Page 视口大小调整为与浏览器指纹 (window.screen) 一致。
-这可以有效防止 "Viewport Mismatch" 类型的反爬检测（例如 Akamai, Datadome 等）。
-
-**参数:**
-- `page` (Page): Playwright Page 对象。
-
-**示例:**
-```javascript
-// 在 preNavigationHooks 中使用
-preNavigationHooks: [
-    async ({ page }) => {
-        await Stealth.syncViewportWithScreen(page);
-    }
-]
-```
-
-### `hideWebdriver(page)`
-
-确保 `navigator.webdriver` 属性被隐藏或设置为 false。虽然 `puppeteer-extra-plugin-stealth` 已经做了这个，但这是一个双重保险。
-
-### `setupBlockingResources(page, resourceTypes)`
-
-拦截并屏蔽指定类型的资源请求，以加速页面加载并节省带宽。
-
-**参数:**
-- `page` (Page): Playwright Page 对象。
-- `resourceTypes` (string[]): (可选) 默认为 `['font', 'image', 'media']`。
-
-### `getStealthLaunchArgs()`
-
-返回一组推荐的 Chrome 启动参数，用于隐藏自动化特征。
-
-**示例:**
-```javascript
-launchContext: {
-    launchOptions: {
-        args: Stealth.getStealthLaunchArgs()
-    }
-}
-```

package/docs/utils.md

@@ -1,28 +0,0 @@
-# Utils
-
-`Utils` 模块包含通用的工具函数，不依赖于 Apify 或特定的爬虫逻辑。
-
-## 引入
-
-```javascript
-import { usePlaywrightToolKit } from '@skrillex1224/playwright-toolkit';
-const { Utils } = usePlaywrightToolKit();
-```
-
-## 方法
-
-### `parseSseStream(sseStreamText)`
-
-解析 Server-Sent Events (SSE) 格式的文本流。常用于处理 AI 模型的流式响应。
-
-**参数:**
-- `sseStreamText` (string): 完整的 SSE 文本。
-
-**返回:**
-- `Array<Object>`: 解析后的 JSON 对象数组。会自动过滤掉非 JSON 行和空行。
-
-**示例:**
-```javascript
-const events = Utils.parseSseStream(responseText);
-console.log(events[0].data);
-```