page-action-cache 1.0.1

package/src/cache-strategy.ts

@@ -0,0 +1,327 @@
+/**
+ * Cache Strategy
+ * 缓存策略 - 缓存层级策略和匹配策略
+ */
+
+import type { CacheLevel, ScenarioMatch, PageActionCacheEntry } from "./types.js";
+
+// ============================================================================
+// 缓存策略接口
+// ============================================================================
+
+/**
+ * 缓存策略接口
+ */
+export interface CacheStrategy {
+  /**
+   * 决定缓存层级
+   */
+  decideCacheLevel(match: ScenarioMatch | null): CacheLevel;
+
+  /**
+   * 判断是否应该使用缓存
+   */
+  shouldUseCache(
+    entry: PageActionCacheEntry,
+    match: ScenarioMatch | null
+  ): boolean;
+
+  /**
+   * 计算缓存得分
+   */
+  calculateScore(entry: PageActionCacheEntry): number;
+}
+
+// ============================================================================
+// 自动策略
+// ============================================================================
+
+/**
+ * 自动缓存策略
+ */
+export class AutoCacheStrategy implements CacheStrategy {
+  decideCacheLevel(match: ScenarioMatch | null): CacheLevel {
+    if (!match) {
+      return "L1"; // 无匹配，使用 L1
+    }
+
+    // 根据置信度决定层级
+    if (match.confidence >= 85) {
+      return "L3"; // 高置信度，场景级
+    } else if (match.confidence >= 70) {
+      return "L2"; // 中等置信度，流程级
+    } else {
+      return "L1"; // 低置信度，原子级
+    }
+  }
+
+  shouldUseCache(
+    entry: PageActionCacheEntry,
+    match: ScenarioMatch | null
+  ): boolean {
+    // 检查过期
+    if (Date.now() > entry.expiresAt) {
+      return false;
+    }
+
+    // 检查成功率
+    const total = entry.successCount + entry.failCount;
+    if (total > 5 && entry.successCount / total < 0.6) {
+      return false; // 成功率太低
+    }
+
+    // 检查访问次数
+    if (entry.accessCount === 0) {
+      return true; // 新缓存，可以使用
+    }
+
+    // L3 缓存直接使用
+    if (entry.cacheLevel === "L3") {
+      return true;
+    }
+
+    // L2 缓存需要匹配
+    if (entry.cacheLevel === "L2" && match && match.confidence >= 70) {
+      return true;
+    }
+
+    // L1 缓存谨慎使用
+    if (entry.cacheLevel === "L1" && match && match.confidence >= 50) {
+      return true;
+    }
+
+    return false;
+  }
+
+  calculateScore(entry: PageActionCacheEntry): number {
+    // 计算缓存得分（0-100）
+    let score = 0;
+
+    // 层级权重
+    switch (entry.cacheLevel) {
+      case "L3":
+        score += 40;
+        break;
+      case "L2":
+        score += 25;
+        break;
+      case "L1":
+        score += 10;
+        break;
+    }
+
+    // 访问次数权重
+    score += Math.min(entry.accessCount * 2, 20);
+
+    // 成功率权重
+    const total = entry.successCount + entry.failCount;
+    if (total > 0) {
+      score += (entry.successCount / total) * 30;
+    }
+
+    // 平均执行时间权重（越快越好）
+    if (entry.avgExecutionTime > 0) {
+      score += Math.max(0, 10 - entry.avgExecutionTime / 100);
+    }
+
+    return Math.min(score, 100);
+  }
+}
+
+// ============================================================================
+// L3 优先策略
+// ============================================================================
+
+/**
+ * L3 优先策略
+ */
+export class L3OnlyCacheStrategy implements CacheStrategy {
+  decideCacheLevel(_match: ScenarioMatch | null): CacheLevel {
+    return "L3";
+  }
+
+  shouldUseCache(
+    entry: PageActionCacheEntry,
+    match: ScenarioMatch | null
+  ): boolean {
+    // 只使用 L3 缓存
+    if (entry.cacheLevel !== "L3") {
+      return false;
+    }
+
+    // 检查过期
+    if (Date.now() > entry.expiresAt) {
+      return false;
+    }
+
+    // 检查匹配
+    if (!match || match.confidence < 85) {
+      return false;
+    }
+
+    return true;
+  }
+
+  calculateScore(entry: PageActionCacheEntry): number {
+    // L3 缓存才有得分
+    if (entry.cacheLevel !== "L3") {
+      return 0;
+    }
+
+    let score = 50; // 基础分
+
+    // 访问次数
+    score += Math.min(entry.accessCount * 3, 30);
+
+    // 成功率
+    const total = entry.successCount + entry.failCount;
+    if (total > 0) {
+      score += (entry.successCount / total) * 20;
+    }
+
+    return Math.min(score, 100);
+  }
+}
+
+// ============================================================================
+// L2 优先策略
+// ============================================================================
+
+/**
+ * L2 优先策略
+ */
+export class L2OnlyCacheStrategy implements CacheStrategy {
+  decideCacheLevel(match: ScenarioMatch | null): CacheLevel {
+    if (match && match.confidence >= 70) {
+      return "L2";
+    }
+    return "L1";
+  }
+
+  shouldUseCache(
+    entry: PageActionCacheEntry,
+    _match: ScenarioMatch | null
+  ): boolean {
+    // 使用 L2 或 L1 缓存
+    if (entry.cacheLevel === "L3") {
+      return false;
+    }
+
+    // 检查过期
+    if (Date.now() > entry.expiresAt) {
+      return false;
+    }
+
+    return true;
+  }
+
+  calculateScore(entry: PageActionCacheEntry): number {
+    // L2 和 L1 缓存才有得分
+    if (entry.cacheLevel === "L3") {
+      return 0;
+    }
+
+    let score = entry.cacheLevel === "L2" ? 40 : 20;
+
+    // 访问次数
+    score += Math.min(entry.accessCount * 2, 25);
+
+    // 成功率
+    const total = entry.successCount + entry.failCount;
+    if (total > 0) {
+      score += (entry.successCount / total) * 35;
+    }
+
+    return Math.min(score, 100);
+  }
+}
+
+// ============================================================================
+// L1 优先策略
+// ============================================================================
+
+/**
+ * L1 优先策略
+ */
+export class L1OnlyCacheStrategy implements CacheStrategy {
+  decideCacheLevel(_match: ScenarioMatch | null): CacheLevel {
+    return "L1";
+  }
+
+  shouldUseCache(
+    entry: PageActionCacheEntry,
+    _match: ScenarioMatch | null
+  ): boolean {
+    // 只使用 L1 缓存
+    if (entry.cacheLevel !== "L1") {
+      return false;
+    }
+
+    // 检查过期
+    if (Date.now() > entry.expiresAt) {
+      return false;
+    }
+
+    return true;
+  }
+
+  calculateScore(entry: PageActionCacheEntry): number {
+    // L1 缓存才有得分
+    if (entry.cacheLevel !== "L1") {
+      return 0;
+    }
+
+    let score = 20; // 基础分
+
+    // 访问次数
+    score += Math.min(entry.accessCount * 2, 40);
+
+    // 成功率
+    const total = entry.successCount + entry.failCount;
+    if (total > 0) {
+      score += (entry.successCount / total) * 40;
+    }
+
+    return Math.min(score, 100);
+  }
+}
+
+// ============================================================================
+// 策略工厂
+// ============================================================================
+
+/**
+ * 缓存策略工厂
+ */
+export class CacheStrategyFactory {
+  /**
+   * 创建缓存策略
+   */
+  createStrategy(strategy: "auto" | "l3-only" | "l2-only" | "l1-only"): CacheStrategy {
+    switch (strategy) {
+      case "auto":
+        return new AutoCacheStrategy();
+      case "l3-only":
+        return new L3OnlyCacheStrategy();
+      case "l2-only":
+        return new L2OnlyCacheStrategy();
+      case "l1-only":
+        return new L1OnlyCacheStrategy();
+      default:
+        return new AutoCacheStrategy();
+    }
+  }
+}
+
+// ============================================================================
+// 单例
+// ============================================================================
+
+let strategyFactoryInstance: CacheStrategyFactory | null = null;
+
+export function getCacheStrategyFactory(): CacheStrategyFactory {
+  if (!strategyFactoryInstance) {
+    strategyFactoryInstance = new CacheStrategyFactory();
+  }
+  return strategyFactoryInstance;
+}

package/src/hooks-entry.ts

@@ -0,0 +1,114 @@
+/**
+ * Page Action Cache Extension - Entry Point
+ * 页面操作缓存扩展 - 入口点
+ */
+
+import { registerPageActionCacheHooks } from "./hooks.js";
+
+/**
+ * Plugin config interface
+ */
+interface PageActionCacheConfig {
+  enabled?: boolean;
+  autoUseCache?: boolean;
+  scenarioRecognitionEnabled?: boolean;
+  llmClassificationThreshold?: number;
+  cacheLevelStrategy?: "auto" | "l3-only" | "l2-only" | "l1-only";
+  defaultCacheLevel?: "L3" | "L2" | "L1";
+  pageChangeDetectionEnabled?: boolean;
+  changeInvalidationThreshold?: number;
+  invalidationStrategy?: "soft" | "hard";
+  variableExtractionEnabled?: boolean;
+  allowUserConfirmVariables?: boolean;
+  encryptSensitiveCache?: boolean;
+  accessControlEnabled?: boolean;
+  logSanitizationEnabled?: boolean;
+  showCacheStatusToUser?: boolean;
+  enableUserCacheConfirmation?: boolean;
+  enableUserForcedRefresh?: boolean;
+  enableUserCacheErrorReport?: boolean;
+  trackExecutionStats?: boolean;
+  statsUpdateInterval?: number;
+}
+
+/**
+ * Default plugin configuration
+ */
+const DEFAULT_CONFIG: Required<PageActionCacheConfig> = {
+  enabled: true,
+  autoUseCache: true,
+  scenarioRecognitionEnabled: true,
+  llmClassificationThreshold: 70,
+  cacheLevelStrategy: "auto",
+  defaultCacheLevel: "L3",
+  pageChangeDetectionEnabled: true,
+  changeInvalidationThreshold: 80,
+  invalidationStrategy: "soft",
+  variableExtractionEnabled: true,
+  allowUserConfirmVariables: false,
+  encryptSensitiveCache: false,
+  accessControlEnabled: false,
+  logSanitizationEnabled: true,
+  showCacheStatusToUser: true,
+  enableUserCacheConfirmation: false,
+  enableUserForcedRefresh: true,
+  enableUserCacheErrorReport: true,
+  trackExecutionStats: true,
+  statsUpdateInterval: 60,
+};
+
+/**
+ * Plugin definition - OpenClaw plugin API format
+ */
+const pageActionCachePlugin = {
+  id: "page-action-cache",
+  name: "Page Action Cache",
+  version: "1.0.0",
+  description:
+    "Browser operation cache extension - caches common page action sequences to reduce token consumption and operation latency",
+  author: "OpenClaw",
+  license: "MIT",
+
+  /**
+   * Register the plugin with OpenClaw
+   */
+  register(api: any) {
+    try {
+      // Get plugin config from OpenClaw config
+      const pluginConfig = api.config?.plugins?.entries?.["page-action-cache"]?.config || {};
+
+      // Merge with defaults
+      const config = { ...DEFAULT_CONFIG, ...pluginConfig };
+
+      // Register hooks and initialize extension
+      if (config.enabled) {
+        registerPageActionCacheHooks(api, config);
+        console.log("[PageActionCache] Extension initialized successfully");
+      } else {
+        console.log("[PageActionCache] Extension disabled");
+      }
+    } catch (error) {
+      console.error("[PageActionCache] Failed to initialize extension:", error);
+    }
+  },
+};
+
+/**
+ * Default export - OpenClaw plugin format (function)
+ */
+export default function (api: any) {
+  pageActionCachePlugin.register(api);
+}
+
+/**
+ * Named export - direct initialization for manual use
+ */
+export { pageActionCachePlugin };
+export function initializePageActionCache(api: any, config?: any): void {
+  try {
+    registerPageActionCacheHooks(api, config);
+    console.log("[PageActionCache] Extension initialized successfully");
+  } catch (error) {
+    console.error("[PageActionCache] Failed to initialize extension:", error);
+  }
+}