workerclaw 0.8.2 → 0.9.0

package/dist/sandbox/browser-session.js

@@ -0,0 +1,250 @@
+/**
+ * 浏览器会话管理器
+ *
+ * 管理 Playwright Browser 实例和 BrowserContext 池，实现：
+ * - 全局共享 Browser 进程（节省 ~400MB 内存）
+ * - 按 taskId 隔离 BrowserContext（Cookie/Storage/Session 独立）
+ * - 同一任务的多次浏览器操作复用同一 Context（保持登录态）
+ * - 任务结束后自动销毁 Context 释放资源
+ * - 超时自动清理防泄漏
+ */
+import { createLogger } from '../core/logger.js';
+// ==================== 会话管理器 ====================
+export class BrowserSessionManager {
+    logger;
+    config;
+    /** 共享 Browser 实例（懒初始化） */
+    sharedBrowser = null;
+    browserInitializing = null;
+    /** 会话池：taskId → BrowserSession */
+    sessions = new Map();
+    /** 超时清理定时器 */
+    cleanupTimer = null;
+    constructor(config) {
+        this.config = {
+            maxIdleMs: config?.maxIdleMs ?? 10 * 60 * 1000, // 10 分钟
+            maxSessions: config?.maxSessions ?? 5,
+            launchArgs: config?.launchArgs ?? [
+                '--no-sandbox',
+                '--disable-setuid-sandbox',
+                '--disable-dev-shm-usage',
+                '--disable-gpu',
+                '--disable-extensions',
+                '--no-first-run',
+                '--disable-default-apps',
+            ],
+            userAgent: config?.userAgent || undefined,
+            proxyUrl: config?.proxyUrl || undefined,
+        };
+        this.logger = createLogger('BrowserSession');
+        // 每 5 分钟清理一次超时会话
+        this.cleanupTimer = setInterval(() => this.cleanupIdleSessions(), 5 * 60 * 1000);
+        this.cleanupTimer.unref(); // 不阻止进程退出
+    }
+    /**
+     * 获取或创建指定任务的浏览器会话
+     *
+     * - 如果 taskId 已有会话且未过期，直接返回（复用 Context，保持登录态）
+     * - 否则创建新 Context（全新隔离环境）
+     */
+    async getOrCreate(taskId) {
+        // 检查已有会话
+        const existing = this.sessions.get(taskId);
+        if (existing) {
+            existing.lastUsedAt = Date.now();
+            this.logger.debug(`复用已有会话 [${taskId}]`, {
+                ageMs: Date.now() - existing.createdAt,
+                idleMs: Date.now() - existing.lastUsedAt,
+            });
+            return existing;
+        }
+        // 检查并发上限
+        if (this.sessions.size >= this.config.maxSessions) {
+            // 尝试清理最老的空闲会话
+            const evicted = await this.evictOldestIdle();
+            if (!evicted) {
+                throw new Error(`浏览器会话已满 (${this.config.maxSessions})，请等待其他任务完成后再试`);
+            }
+        }
+        // 获取/创建共享 Browser
+        const browser = await this.getSharedBrowser();
+        // 创建新 Context（按任务隔离）
+        const contextConfig = {
+            userAgent: this.config.userAgent || 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+            javaScriptEnabled: true,
+            ignoreHTTPSErrors: true,
+            viewport: { width: 1280, height: 720 },
+        };
+        if (this.config.proxyUrl) {
+            contextConfig.proxy = { server: this.config.proxyUrl };
+        }
+        const context = await browser.newContext(contextConfig);
+        const session = {
+            browser,
+            context,
+            createdAt: Date.now(),
+            lastUsedAt: Date.now(),
+            pageCount: 0,
+        };
+        this.sessions.set(taskId, session);
+        this.logger.info(`创建新浏览器会话 [${taskId}]`, {
+            totalSessions: this.sessions.size,
+        });
+        return session;
+    }
+    /**
+     * 销毁指定任务的会话
+     */
+    async destroy(taskId) {
+        const session = this.sessions.get(taskId);
+        if (!session)
+            return;
+        try {
+            // 关闭所有 page
+            const pages = session.context.pages();
+            for (const page of pages) {
+                await page.close().catch(() => { });
+            }
+            // 关闭 context
+            await session.context.close().catch(() => { });
+        }
+        catch (err) {
+            this.logger.debug(`关闭会话 context 异常 [${taskId}]`, {
+                error: err.message,
+            });
+        }
+        this.sessions.delete(taskId);
+        this.logger.debug(`销毁会话 [${taskId}]`, { remaining: this.sessions.size });
+    }
+    /**
+     * 销毁所有会话（关闭共享浏览器）
+     */
+    async destroyAll() {
+        // 关闭所有 context
+        for (const [taskId] of this.sessions) {
+            await this.destroy(taskId);
+        }
+        // 关闭共享浏览器
+        if (this.sharedBrowser) {
+            try {
+                await this.sharedBrowser.close().catch(() => { });
+            }
+            catch { }
+            this.sharedBrowser = null;
+        }
+        // 清理定时器
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.logger.info('浏览器会话管理器已完全关闭');
+    }
+    /**
+     * 获取当前会话统计
+     */
+    getStats() {
+        return {
+            totalSessions: this.sessions.size,
+            maxSessions: this.config.maxSessions,
+            sessions: Array.from(this.sessions.entries()).map(([id, s]) => ({
+                taskId: id,
+                ageMs: Date.now() - s.createdAt,
+                idleMs: Date.now() - s.lastUsedAt,
+                pageCount: s.context?.pages()?.length ?? 0,
+            })),
+        };
+    }
+    // ==================== 私有方法 ====================
+    /**
+     * 获取共享 Browser 实例（懒初始化，单例）
+     */
+    async getSharedBrowser() {
+        // 已初始化
+        if (this.sharedBrowser) {
+            try {
+                // 检查是否仍然连接
+                if (this.sharedBrowser.isConnected()) {
+                    return this.sharedBrowser;
+                }
+            }
+            catch {
+                // 已断开，重新初始化
+            }
+        }
+        // 防止并发初始化
+        if (this.browserInitializing) {
+            return this.browserInitializing;
+        }
+        this.browserInitializing = this.launchBrowser();
+        try {
+            this.sharedBrowser = await this.browserInitializing;
+            return this.sharedBrowser;
+        }
+        finally {
+            this.browserInitializing = null;
+        }
+    }
+    /**
+     * 启动 Chromium 浏览器
+     */
+    async launchBrowser() {
+        let chromium;
+        try {
+            const pw = await import('playwright');
+            chromium = pw.chromium;
+        }
+        catch {
+            throw new Error('playwright 未安装或 Chromium 不可用。请运行: npx playwright install chromium');
+        }
+        const browser = await chromium.launch({
+            headless: true,
+            args: this.config.launchArgs,
+        });
+        this.logger.info('Chromium 浏览器已启动（共享实例）');
+        // 监听断开事件
+        browser.on('disconnected', () => {
+            this.logger.warn('Chromium 浏览器已断开连接');
+            this.sharedBrowser = null;
+            // 清理所有会话引用
+            this.sessions.clear();
+        });
+        return browser;
+    }
+    /**
+     * 清理超时空闲会话
+     */
+    async cleanupIdleSessions() {
+        const now = Date.now();
+        const toDestroy = [];
+        for (const [taskId, session] of this.sessions) {
+            const idleMs = now - session.lastUsedAt;
+            if (idleMs > this.config.maxIdleMs) {
+                toDestroy.push(taskId);
+            }
+        }
+        for (const taskId of toDestroy) {
+            this.logger.info(`清理超时会话 [${taskId}]（空闲超过 ${this.config.maxIdleMs / 1000}s）`);
+            await this.destroy(taskId);
+        }
+    }
+    /**
+     * 驱逐最老的空闲会话（用于并发上限控制）
+     */
+    async evictOldestIdle() {
+        let oldestTaskId = null;
+        let oldestLastUsed = Infinity;
+        for (const [taskId, session] of this.sessions) {
+            if (session.lastUsedAt < oldestLastUsed) {
+                oldestLastUsed = session.lastUsedAt;
+                oldestTaskId = taskId;
+            }
+        }
+        if (oldestTaskId) {
+            this.logger.info(`驱逐最老空闲会话 [${oldestTaskId}]`);
+            await this.destroy(oldestTaskId);
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=browser-session.js.map

package/dist/sandbox/browser-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session.js","sourceRoot":"","sources":["../../src/sandbox/browser-session.ts"],"names":[],"mappings":"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"}

package/dist/skills/browser-skill.d.ts

@@ -3,17 +3,23 @@
  *
  * 基于 Playwright 的网页浏览技能，为 Agent 提供安全上网能力。
  *
- * 提供 3 个工具：
+ * 提供 6 个工具：
  *   1. browser_navigate - 导航到 URL 并提取页面文本内容
  *   2. browser_extract - 提取页面结构化数据（链接/图片/元数据）
  *   3. browser_screenshot - 截取页面截图
+ *   4. browser_click - 点击页面元素
+ *   5. browser_fill - 在输入框中填写内容
+ *   6. browser_wait - 等待页面元素出现
+ *
+ * 会话隔离：
+ *   - 同一 taskId 的多次操作共享 BrowserContext（保持 Cookie/登录态）
+ *   - 不同 taskId 之间 Context 完全隔离
  *
  * 安全策略：
  *   - 权限级别：elevated（需要较高权限才能使用浏览器）
  *   - URL 验证：阻止内网/localhost/file:// 等危险地址
  *   - 页面大小限制：防止超大页面消耗资源
  *   - 截图大小限制：防止截图过大
- *   - Cookie 隔离：每次操作独立浏览器上下文
  *   - 弹窗拦截：阻止恶意弹窗
  *   - 超时控制：防止页面加载卡死
  */
@@ -23,6 +29,9 @@ import type { BrowserSandboxConfig } from '../core/config.js';
 export declare class BrowserSkill implements Skill {
     private logger;
     private sandbox;
+    private sessionManager;
+    /** 每个任务的活跃 page（用于交互式操作） */
+    private activePages;
     readonly metadata: {
         name: string;
         displayName: string;
@@ -41,8 +50,20 @@ export declare class BrowserSkill implements Skill {
     getSystemPromptAddon(): string;
     init(): Promise<void>;
     dispose(): Promise<void>;
+    /**
+     * 销毁指定任务的会话（由 AgentEngine 在任务结束时调用）
+     */
+    destroyTaskSession(taskId: string): Promise<void>;
+    /**
+     * 获取或创建任务的活跃 page
+     * 用于交互式操作（click/fill/wait），需要先 navigate 才能使用
+     */
+    private getActivePage;
     private executeNavigate;
     private executeExtract;
     private executeScreenshot;
+    private executeClick;
+    private executeFill;
+    private executeWait;
 }
 //# sourceMappingURL=browser-skill.d.ts.map

package/dist/skills/browser-skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-skill.d.ts","sourceRoot":"","sources":["../../src/skills/browser-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAsE9D,qBAAa,YAAa,YAAW,KAAK;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAiB;IAEhC,QAAQ,CAAC,QAAQ;;;;;;;uBAOc,eAAe;;;MAG5C;gBAEU,aAAa,CAAC,EAAE,oBAAoB;IAKhD,QAAQ,CAAC,KAAK,mBAAiB;IAE/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAUpD;IAEI,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAW1D,oBAAoB,IAAI,MAAM;IAkBxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAMhB,eAAe;YA4Cf,cAAc;YA0Ed,iBAAiB;CA8BhC"}
+{"version":3,"file":"browser-skill.d.ts","sourceRoot":"","sources":["../../src/skills/browser-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAmI9D,qBAAa,YAAa,YAAW,KAAK;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,cAAc,CAAwB;IAE9C,4BAA4B;IAC5B,OAAO,CAAC,WAAW,CAA0B;IAE7C,QAAQ,CAAC,QAAQ;;;;;;;uBAOc,eAAe;;;MAG5C;gBAEU,aAAa,CAAC,EAAE,oBAAoB;IAMhD,QAAQ,CAAC,KAAK,mBAAiB;IAE/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAmBpD;IAEI,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAS1D,oBAAoB,IAAI,MAAM;IA2BxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD;;;OAGG;YACW,aAAa;YAiBb,eAAe;YAwEf,cAAc;YA2Ed,iBAAiB;YAgCjB,YAAY;YAkDZ,WAAW;YA0CX,WAAW;CAiC1B"}