page-action-cache 2.0.9 → 2026.2.0

package/src/index.ts

@@ -1,468 +0,0 @@
-/**
- * Page Action Cache - OpenClaw Extension
- * 页面操作缓存扩展 - OpenClaw 扩展
- */
-
-import type { OpenClawPluginApi } from './types-mock.js';
-import type { ScenarioType } from './types.js';
-import { scenarioRecognizer } from './scenario-recognizer.js';
-import { multiLevelCache } from './multi-level-cache.js';
-import { cacheInvalidation } from './cache-invalidation.js';
-import { browserActionExecutor } from './browser-action-executor.js';
-
-/**
- * 主扩展入口
- */
-export function register(api: OpenClawPluginApi): void {
-  console.log('[PageActionCache] Initializing extension...');
-
-  // 获取插件配置 - 详细日志
-  const rawConfig = api.getConfig?.();
-  console.log('[PageActionCache] Raw config object:', JSON.stringify(rawConfig, null, 2));
-
-  // 检查配置对象是否有效
-  let config = rawConfig;
-  if (!config || typeof config !== 'object') {
-    console.log('[PageActionCache] Invalid config object type:', typeof rawConfig);
-    // 配置无效，使用空对象继续
-    config = {};
-  }
-
-  const pluginConfig = config?.plugins?.entries?.['page-action-cache'] ?? {};
-  console.log('[PageActionCache] Plugin config for page-action-cache:', JSON.stringify(pluginConfig, null, 2));
-
-  const pageActionCacheConfig = pluginConfig ?? {};
-  console.log('[PageActionCache] Parsed pageActionCacheConfig:', JSON.stringify(pageActionCacheConfig, null, 2));
-
-  const enabled = pageActionCacheConfig.enabled !== false;
-  console.log('[PageActionCache] Enabled status:', enabled);
-
-  if (!enabled) {
-    console.log('[PageActionCache] Extension disabled by configuration');
-    return;
-  }
-
-  console.log('[PageActionCache] Extension enabled, proceeding with tool registration...');
-
-  // 应用配置
-  if (pageActionCacheConfig.cacheLevelStrategy) {
-    multiLevelCache.setStrategy(pageActionCacheConfig.cacheLevelStrategy);
-    console.log('[PageActionCache] Set cache level strategy:', pageActionCacheConfig.cacheLevelStrategy);
-  }
-
-  if (pageActionCacheConfig.llmClassificationThreshold !== undefined) {
-    multiLevelCache.setLLMThreshold(pageActionCacheConfig.llmClassificationThreshold);
-    console.log('[PageActionCache] Set LLM classification threshold:', pageActionCacheConfig.llmClassificationThreshold);
-  }
-
-  if (pageActionCacheConfig.invalidationStrategy) {
-    cacheInvalidation.setStrategy(pageActionCacheConfig.invalidationStrategy);
-    console.log('[PageActionCache] Set invalidation strategy:', pageActionCacheConfig.invalidationStrategy);
-  }
-
-  if (pageActionCacheConfig.changeInvalidationThreshold !== undefined) {
-    cacheInvalidation.setChangeThreshold(pageActionCacheConfig.changeInvalidationThreshold);
-    console.log('[PageActionCache] Set change invalidation threshold:', pageActionCacheConfig.changeInvalidationThreshold);
-  }
-
-  // 注册缓存执行工具
-  api.registerTool({
-    name: 'browser_cache_execute',
-    description: '执行缓存的页面操作序列，支持自动缓存匹配、场景识别和变量提取',
-    async execute(ctx: { config?: any; params?: any }) {
-      try {
-        console.log('[PageActionCache] browser_cache_execute called');
-        console.log('[PageActionCache] Context type:', typeof ctx);
-        console.log('[PageActionCache] Context config:', ctx.config ? JSON.stringify(ctx.config, null, 2) : 'null');
-        console.log('[PageActionCache] Context params:', ctx.params ? JSON.stringify(ctx.params, null, 2) : 'null');
-
-        // 从插件配置中读取 enabled 状态
-        const pluginConfig = ctx.config?.plugins?.entries?.['page-action-cache'] ?? {};
-        const enabled = pluginConfig.enabled !== false;
-
-        if (!enabled) {
-          console.log('[PageActionCache] Extension disabled by context config');
-          return {
-            success: false,
-            message: 'Extension is disabled',
-            executedActions: 0,
-            skippedActions: 0,
-            failedActions: 0,
-            savedTime: 0
-          };
-        }
-
-        const params = ctx.params || {};
-        const url = params.url;
-        const viewport = params.viewport || '1920x1080';
-        const scenario = params.scenario;
-        const actions = params.actions;
-        const useCache = params.useCache !== false; // 默认使用缓存
-        const forceRefresh = params.forceRefresh === true;
-        const llmClassificationScore = params.llmClassificationScore;
-
-        console.log('[PageActionCache] Parsed params:', { url, viewport, scenario, useCache, forceRefresh, llmClassificationScore });
-
-        if (!url) {
-          return {
-            success: false,
-            message: 'Missing required parameter: url',
-            executedActions: 0,
-            skippedActions: 0,
-            failedActions: 0,
-            savedTime: 0
-          };
-        }
-
-        // 识别场景
-        let recognizedScenario: string = scenario || scenarioRecognizer.recognize(url);
-        console.log('[PageActionCache] Recognized scenario:', recognizedScenario);
-
-        let cachedEntry = null;
-        let isCacheHit = false;
-        let executedActions = 0;
-        let skippedActions = 0;
-        let failedActions = 0;
-        let savedTime = 0;
-        let cacheId = '';
-
-        // 尝试从缓存中查找
-        if (useCache && !forceRefresh) {
-          console.log('[PageActionCache] Checking cache...');
-          cachedEntry = multiLevelCache.queryCache(url, viewport);
-
-          if (cachedEntry) {
-            console.log('[PageActionCache] Cache hit found:', cachedEntry.id);
-            isCacheHit = true;
-            cacheId = cachedEntry.id;
-
-            // 检查页面是否发生变化（如果提供了 HTML）
-            if (pageActionCacheConfig.pageChangeDetectionEnabled && params.html) {
-              const shouldInvalidate = cacheInvalidation.shouldInvalidate(url, viewport, params.html);
-              if (shouldInvalidate) {
-                console.log('[PageActionCache] Page changed, cache invalidated');
-                multiLevelCache.deleteCache(url, viewport);
-                cachedEntry = null;
-                isCacheHit = false;
-              } else {
-                console.log('[PageActionCache] Page unchanged, cache valid');
-              }
-            }
-          } else {
-            console.log('[PageActionCache] Cache miss');
-          }
-        }
-
-        // 如果没有缓存或需要强制刷新，执行新的操作
-        if (!cachedEntry) {
-          console.log('[PageActionCache] Executing new actions...');
-          if (!actions || actions.length === 0) {
-            return {
-              success: false,
-              message: 'No actions provided and no cache found',
-              executedActions: 0,
-              skippedActions: 0,
-              failedActions: 0,
-              savedTime: 0
-            };
-          }
-
-          // 执行操作
-          const actionResults: any[] = [];
-          for (let i = 0; i < actions.length; i++) {
-            const action: any = actions[i];
-            console.log('[PageActionCache] Executing action', i + 1, ':', action.type);
-
-            try {
-              const startTime = Date.now();
-              let result: any;
-
-              switch (action.type) {
-                case 'navigate':
-                  if (!action.params?.url) {
-                    result = { success: false, message: 'Missing URL' };
-                  } else {
-                    // 模拟导航操作
-                    console.log('[PageActionCache] Navigating to:', action.params.url);
-                    result = { success: true, message: `Navigated to ${action.params.url}` };
-                  }
-                  break;
-
-                case 'click':
-                  if (!action.params?.selector) {
-                    result = { success: false, message: 'Missing selector' };
-                  } else {
-                    console.log('[PageActionCache] Clicking:', action.params.selector);
-                    result = { success: true, message: `Clicked ${action.params.selector}` };
-                  }
-                  break;
-
-                case 'type':
-                  if (!action.params?.selector || action.params?.text === undefined) {
-                    result = { success: false, message: 'Missing selector or text' };
-                  } else {
-                    console.log('[PageActionCache] Typing:', action.params.text);
-                    result = { success: true, message: `Typed text` };
-                  }
-                  break;
-
-                case 'screenshot':
-                  console.log('[PageActionCache] Taking screenshot');
-                  result = { success: true, message: 'Screenshot taken' };
-                  break;
-
-                case 'script':
-                  if (!action.params?.script) {
-                    result = { success: false, message: 'Missing script' };
-                  } else {
-                    console.log('[PageActionCache] Executing script');
-                    result = { success: true, message: 'Script executed' };
-                  }
-                  break;
-
-                default:
-                  result = { success: false, message: `Unknown action type: ${action.type}` };
-              }
-
-              const executionTime = Date.now() - startTime;
-              result.executionTime = executionTime;
-              actionResults.push(result);
-
-              if (result.success) {
-                executedActions++;
-              } else {
-                failedActions++;
-              }
-
-            } catch (error) {
-              console.error('[PageActionCache] Action execution error:', error);
-              failedActions++;
-              actionResults.push({
-                success: false,
-                message: `Error: ${error instanceof Error ? error.message : String(error)}`
-              });
-            }
-          }
-
-          // 保存到缓存
-          const processedActions = actions.map((action: any, index: number) => ({
-            type: action.type,
-            params: action.params,
-            successCount: actionResults[index]?.success ? 1 : 0,
-            failCount: actionResults[index]?.success ? 0 : 1
-          }));
-
-          cacheId = multiLevelCache.addCache(
-            url,
-            viewport,
-            processedActions,
-            recognizedScenario as ScenarioType,
-            llmClassificationScore
-          );
-
-          // 保存页面快照（如果提供了 HTML）
-          if (params.html) {
-            cacheInvalidation.saveSnapshot(url, viewport, params.html);
-          }
-
-          console.log('[PageActionCache] Saved to cache with ID:', cacheId);
-          savedTime = 0; // 首次执行不节省时间
-        } else {
-          // 使用缓存执行
-          console.log('[PageActionCache] Using cached entry...');
-          const result = await browserActionExecutor.executeCacheEntry(cachedEntry as any);
-          executedActions = result.executedActions;
-          skippedActions = result.skippedActions;
-          failedActions = result.failedActions;
-          savedTime = result.savedTime;
-          console.log('[PageActionCache] Cache execution result:', result);
-        }
-
-        // 生成返回消息
-        let message = isCacheHit ? 'Cached Execution' : 'New Execution';
-        message += '\n\n';
-        message += `Execution completed ${isCacheHit ? 'from cache' : 'successfully'}\n\n`;
-        message += `- Executed Actions: ${executedActions}\n`;
-        message += `- Skipped Actions: ${skippedActions}\n`;
-        message += `- Failed Actions: ${failedActions}\n`;
-        message += `- Saved Time: ${savedTime}ms\n\n`;
-        message += `Cache ID: ${cacheId}\n`;
-        message += `URL: ${url}\n`;
-        message += `Scenario: ${recognizedScenario}\n`;
-
-        if (isCacheHit && cachedEntry) {
-          message += `Cache Level: ${cachedEntry.level}\n`;
-          message += `Access Count: ${cachedEntry.accessCount}\n`;
-        }
-
-        console.log('[PageActionCache] Returning result:', message);
-
-        return {
-          success: failedActions === 0,
-          message,
-          executedActions,
-          skippedActions,
-          failedActions,
-          savedTime,
-          cacheId,
-          url,
-          scenario: recognizedScenario,
-          isCacheHit,
-          cacheLevel: cachedEntry?.level
-        };
-
-      } catch (error) {
-        console.error('[PageActionCache] Error in browser_cache_execute:', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-          success: false,
-          message: `Error: ${errorMessage}`,
-          executedActions: 0,
-          skippedActions: 0,
-          failedActions: 0,
-          savedTime: 0
-        };
-      }
-    }
-  });
-
-  // 注册缓存统计工具
-  api.registerTool({
-    name: 'browser_cache_stats',
-    description: '查看页面操作缓存的统计信息',
-    async execute(ctx: { config?: any; params?: any }) {
-      try {
-        console.log('[PageActionCache] browser_cache_stats called');
-
-        const pluginConfig = ctx.config?.plugins?.entries?.['page-action-cache'] ?? {};
-        const enabled = pluginConfig.enabled !== false;
-
-        if (!enabled) {
-          return {
-            success: false,
-            message: 'Extension is disabled'
-          };
-        }
-
-        const stats = multiLevelCache.getStats();
-        const invalidationStats = cacheInvalidation.getInvalidationStats();
-
-        console.log('[PageActionCache] Stats:', stats);
-        console.log('[PageActionCache] Invalidation stats:', invalidationStats);
-
-        // 生成统计报告
-        let message = '## Page Action Cache Statistics\n\n';
-        message += '### Overall Performance\n';
-        message += `- Total Cache Entries: ${stats.totalEntries}\n`;
-        message += `- Total Cache Hits: ${stats.totalHits}\n`;
-        message += `- Cache Hit Rate: ${stats.hitRate.toFixed(2)}%\n\n`;
-
-        message += '### Multi-Level Cache Distribution\n';
-        for (const [level, levelStats] of Object.entries(stats.levelStats)) {
-          message += `#### ${level} Cache\n`;
-          message += `- Size: ${levelStats.size}/${levelStats.maxCapacity} (${(levelStats.usageRate * 100).toFixed(1)}% full)\n`;
-          message += `- Average Access Count: ${levelStats.avgAccessCount.toFixed(1)}\n\n`;
-        }
-
-        message += '### Cache Invalidation\n';
-        message += `- Total Snapshots: ${invalidationStats.totalSnapshots}\n`;
-        message += `- Active Snapshots: ${invalidationStats.activeSnapshots}\n`;
-        message += `- Invalidation Rate: ${(invalidationStats.invalidationRate * 100).toFixed(2)}%\n`;
-
-        return {
-          success: true,
-          message,
-          stats,
-          invalidationStats
-        };
-
-      } catch (error) {
-        console.error('[PageActionCache] Error in browser_cache_stats:', error);
-        return {
-          success: false,
-          message: `Error: ${error instanceof Error ? error.message : String(error)}`
-        };
-      }
-    }
-  });
-
-  // 注册缓存清空工具
-  api.registerTool({
-    name: 'browser_cache_clear',
-    description: '清空页面操作缓存',
-    async execute(ctx: { config?: any; params?: any }) {
-      try {
-        console.log('[PageActionCache] browser_cache_clear called');
-        console.log('[PageActionCache] Context params:', ctx.params ? JSON.stringify(ctx.params, null, 2) : 'null');
-
-        const pluginConfig = ctx.config?.plugins?.entries?.['page-action-cache'] ?? {};
-        const enabled = pluginConfig.enabled !== false;
-
-        if (!enabled) {
-          return {
-            success: false,
-            message: 'Extension is disabled'
-          };
-        }
-
-        const params = ctx.params || {};
-        const level = params.level || 'all'; // 'all', 'L3', 'L2', 'L1'
-        const url = params.url;
-        const viewport = params.viewport;
-
-        console.log('[PageActionCache] Clear params:', { level, url, viewport });
-
-        let cleared = 0;
-
-        if (level === 'all') {
-          if (url) {
-            // 清空特定 URL 的所有缓存
-            multiLevelCache.deleteCacheByUrl(url);
-            cacheInvalidation.invalidateByUrl(url);
-            cleared = 1;
-          } else {
-            // 清空所有缓存
-            multiLevelCache.clearAll();
-            cacheInvalidation.reset();
-            cleared = 1;
-          }
-        } else if (level === 'L3' || level === 'L2' || level === 'L1') {
-          if (url && viewport) {
-            multiLevelCache.deleteCache(url, viewport);
-            cacheInvalidation.invalidate(url, viewport);
-            cleared = 1;
-          } else {
-            multiLevelCache.clearLevel(level);
-            cleared = 1;
-          }
-        }
-
-        console.log('[PageActionCache] Cleared cache entries');
-
-        const levelText = level === 'all' ? 'all caches' : `${level} cache`;
-        const urlText = url ? ` for ${url}` : '';
-        const message = `Cleared ${levelText}${urlText}`;
-
-        return {
-          success: true,
-          message,
-          level,
-          url,
-          cleared
-        };
-
-      } catch (error) {
-        console.error('[PageActionCache] Error in browser_cache_clear:', error);
-        return {
-          success: false,
-          message: `Error: ${error instanceof Error ? error.message : String(error)}`
-        };
-      }
-    }
-  });
-
-  console.log('[PageActionCache] All tools registered successfully');
-}
-
-// Export register as registerTools for backward compatibility with tests
-export const registerTools = register;