page-action-cache 2.0.8 → 2026.2.0

package/src/cache-invalidation.ts

@@ -1,338 +0,0 @@
-/**
- * Cache Invalidation - Page Action Cache
- * 缓存失效管理器 - 页面变化检测和缓存失效
- */
-
-/**
- * 页面变化类型
- */
-type ChangeType = 'major' | 'minor' | 'none';
-
-/**
- * 页面快照
- */
-interface PageSnapshot {
-  url: string;
-  viewport: string;
-  timestamp: number;
-  htmlHash?: string;
-  structureHash?: string;
-  contentHash?: string;
-}
-
-/**
- * 缓存失效策略
- */
-type InvalidationStrategy = 'soft' | 'hard';
-
-/**
- * 页面变化检测结果
- */
-interface ChangeDetectionResult {
-  changed: boolean;
-  changeType: ChangeType;
-  changeScore: number;
-  confidence: number;
-}
-
-/**
- * 缓存失效管理器
- */
-export class CacheInvalidation {
-  private snapshots: Map<string, PageSnapshot> = new Map();
-  private changeHistory: Map<string, number[]> = new Map();
-  private strategy: InvalidationStrategy = 'soft';
-  private changeThreshold: number = 0.5;
-
-  constructor(strategy: InvalidationStrategy = 'soft', changeThreshold: number = 0.5) {
-    this.strategy = strategy;
-    this.changeThreshold = changeThreshold;
-  }
-
-  /**
-   * 设置失效策略
-   */
-  setStrategy(strategy: InvalidationStrategy): void {
-    this.strategy = strategy;
-  }
-
-  /**
-   * 设置变化阈值
-   */
-  setChangeThreshold(threshold: number): void {
-    this.changeThreshold = Math.max(0, Math.min(1, threshold));
-  }
-
-  /**
-   * 创建页面快照
-   */
-  createSnapshot(url: string, viewport: string, html?: string): PageSnapshot {
-    const snapshot: PageSnapshot = {
-      url,
-      viewport,
-      timestamp: Date.now()
-    };
-
-    if (html) {
-      snapshot.htmlHash = this.generateHash(html);
-      snapshot.structureHash = this.generateStructureHash(html);
-      snapshot.contentHash = this.generateContentHash(html);
-    }
-
-    return snapshot;
-  }
-
-  /**
-   * 保存页面快照
-   */
-  saveSnapshot(url: string, viewport: string, html?: string): void {
-    const key = this.getSnapshotKey(url, viewport);
-    const snapshot = this.createSnapshot(url, viewport, html);
-    this.snapshots.set(key, snapshot);
-  }
-
-  /**
-   * 检测页面变化
-   */
-  detectChanges(url: string, viewport: string, currentHtml: string): ChangeDetectionResult {
-    const key = this.getSnapshotKey(url, viewport);
-    const previousSnapshot = this.snapshots.get(key);
-
-    if (!previousSnapshot) {
-      return {
-        changed: true,
-        changeType: 'major',
-        changeScore: 1.0,
-        confidence: 0.8
-      };
-    }
-
-    const currentSnapshot = this.createSnapshot(url, viewport, currentHtml);
-    const changeScore = this.calculateChangeScore(previousSnapshot, currentSnapshot);
-    const changeType = this.determineChangeType(changeScore);
-
-    // 记录变化历史
-    this.recordChangeHistory(key, changeScore);
-
-    return {
-      changed: changeScore > this.changeThreshold,
-      changeType,
-      changeScore,
-      confidence: this.calculateConfidence(previousSnapshot, currentSnapshot)
-    };
-  }
-
-  /**
-   * 计算变化分数
-   */
-  private calculateChangeScore(previous: PageSnapshot, current: PageSnapshot): number {
-    let totalScore = 0;
-    let weightSum = 0;
-
-    // HTML 变化 (权重 0.4)
-    if (previous.htmlHash && current.htmlHash) {
-      const htmlChanged = previous.htmlHash !== current.htmlHash ? 1 : 0;
-      totalScore += htmlChanged * 0.4;
-      weightSum += 0.4;
-    }
-
-    // 结构变化 (权重 0.35)
-    if (previous.structureHash && current.structureHash) {
-      const structureChanged = previous.structureHash !== current.structureHash ? 1 : 0;
-      totalScore += structureChanged * 0.35;
-      weightSum += 0.35;
-    }
-
-    // 内容变化 (权重 0.25)
-    if (previous.contentHash && current.contentHash) {
-      const contentChanged = previous.contentHash !== current.contentHash ? 1 : 0;
-      totalScore += contentChanged * 0.25;
-      weightSum += 0.25;
-    }
-
-    return weightSum > 0 ? totalScore / weightSum : 0;
-  }
-
-  /**
-   * 确定变化类型
-   */
-  private determineChangeType(changeScore: number): ChangeType {
-    if (changeScore >= 0.7) return 'major';
-    if (changeScore >= 0.3) return 'minor';
-    return 'none';
-  }
-
-  /**
-   * 计算置信度
-   */
-  private calculateConfidence(previous: PageSnapshot, current: PageSnapshot): number {
-    // 时间越近，置信度越高
-    const timeDiff = current.timestamp - previous.timestamp;
-    const timeFactor = Math.max(0, 1 - timeDiff / (24 * 60 * 60 * 1000)); // 24小时内
-
-    return timeFactor * 0.8 + 0.2; // 基础置信度 0.2
-  }
-
-  /**
-   * 记录变化历史
-   */
-  private recordChangeHistory(key: string, changeScore: number): void {
-    if (!this.changeHistory.has(key)) {
-      this.changeHistory.set(key, []);
-    }
-
-    const history = this.changeHistory.get(key)!;
-    history.push(changeScore);
-
-    // 只保留最近 10 次记录
-    if (history.length > 10) {
-      history.shift();
-    }
-  }
-
-  /**
-   * 判断是否应该失效缓存
-   */
-  shouldInvalidate(url: string, viewport: string, currentHtml: string): boolean {
-    const detection = this.detectChanges(url, viewport, currentHtml);
-
-    if (this.strategy === 'hard') {
-      // 硬失效：任何变化都失效
-      return detection.changed;
-    } else {
-      // 软失效：根据变化类型和阈值判断
-      const key = this.getSnapshotKey(url, viewport);
-      const history = this.changeHistory.get(key) || [];
-
-      // 如果是重大变化，立即失效
-      if (detection.changeType === 'major') {
-        return true;
-      }
-
-      // 如果连续 3 次检测到变化，失效
-      const recentChanges = history.slice(-3);
-      if (recentChanges.length === 3 && recentChanges.every(s => s > this.changeThreshold)) {
-        return true;
-      }
-
-      return detection.changed && detection.confidence > 0.7;
-    }
-  }
-
-  /**
-   * 失效缓存条目
-   */
-  invalidate(url: string, viewport: string): void {
-    const key = this.getSnapshotKey(url, viewport);
-    this.snapshots.delete(key);
-    this.changeHistory.delete(key);
-  }
-
-  /**
-   * 批量失效 URL 相关的所有缓存
-   */
-  invalidateByUrl(url: string): void {
-    for (const key of this.snapshots.keys()) {
-      if (key.startsWith(`${url}:`)) {
-        this.snapshots.delete(key);
-        this.changeHistory.delete(key);
-      }
-    }
-  }
-
-  /**
-   * 获取失效统计
-   */
-  getInvalidationStats(): {
-    totalSnapshots: number;
-    activeSnapshots: number;
-    invalidationRate: number;
-  } {
-    const totalSnapshots = this.changeHistory.size;
-    let activeInvalidations = 0;
-
-    for (const history of this.changeHistory.values()) {
-      if (history.length > 0 && history[history.length - 1] > this.changeThreshold) {
-        activeInvalidations++;
-      }
-    }
-
-    return {
-      totalSnapshots,
-      activeSnapshots: this.snapshots.size,
-      invalidationRate: totalSnapshots > 0 ? activeInvalidations / totalSnapshots : 0
-    };
-  }
-
-  /**
-   * 清理过期快照
-   */
-  cleanup(maxAge: number = 7 * 24 * 60 * 60 * 1000): void { // 默认 7 天
-    const now = Date.now();
-    const expiredKeys: string[] = [];
-
-    for (const [key, snapshot] of this.snapshots.entries()) {
-      if (now - snapshot.timestamp > maxAge) {
-        expiredKeys.push(key);
-      }
-    }
-
-    for (const key of expiredKeys) {
-      this.snapshots.delete(key);
-      this.changeHistory.delete(key);
-    }
-
-    console.log(`[CacheInvalidation] Cleaned up ${expiredKeys.length} expired snapshots`);
-  }
-
-  /**
-   * 生成哈希
-   */
-  private generateHash(str: string): string {
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-      const char = str.charCodeAt(i);
-      hash = ((hash << 5) - hash) + char;
-      hash = hash & hash; // Convert to 32bit integer
-    }
-    return Math.abs(hash).toString(16);
-  }
-
-  /**
-   * 生成结构哈希
-   */
-  private generateStructureHash(html: string): string {
-    // 移除文本内容，只保留标签结构
-    const structure = html.replace(/>[^<]*</g, '><').replace(/\s+/g, '');
-    return this.generateHash(structure);
-  }
-
-  /**
-   * 生成内容哈希
-   */
-  private generateContentHash(html: string): string {
-    // 移除 HTML 标签，只保留文本内容
-    const content = html.replace(/<[^>]*>/g, '').replace(/\s+/g, ' ').trim();
-    return this.generateHash(content);
-  }
-
-  /**
-   * 生成快照键
-   */
-  private getSnapshotKey(url: string, viewport: string): string {
-    return `${url}:${viewport}`;
-  }
-
-  /**
-   * 重置
-   */
-  reset(): void {
-    this.snapshots.clear();
-    this.changeHistory.clear();
-  }
-}
-
-/**
- * 单例导出
- */
-export const cacheInvalidation = new CacheInvalidation();

package/src/cache-manager.ts

@@ -1,211 +0,0 @@
-/**
- * Cache Manager - Page Action Cache Core
- * 缓存管理器 - 页面操作缓存管理器
- */
-
-import type { CacheEntry, CacheStats, ScenarioType } from './types.js';
-import { clearInterval, setInterval } from 'node:timers';
-
-/**
- * 缓存管理器
- */
-class CacheManager {
-  private cache: Map<string, CacheEntry> = new Map();
-  private stats: CacheStats = {
-    totalEntries: 0,
-    totalActions: 0,
-    hitRate: 0,
-    savedActions: 0,
-    savedTime: 0
-  };
-  private autoSaveInterval: NodeJS.Timeout | null = null;
-  private totalQueries: number = 0;
-  private totalHits: number = 0;
-
-  constructor() {
-    this.loadCache();
-    this.startAutoSave();
-  }
-
-  /**
-   * 加载缓存
-   */
-  private loadCache(): void {
-    try {
-      const cacheFile = process.env.PAGE_ACTION_CACHE_FILE || '/tmp/page-action-cache.json';
-      const fs = require('fs');
-      if (fs.existsSync(cacheFile)) {
-        const data = fs.readFileSync(cacheFile, 'utf8');
-        this.cache = new Map(JSON.parse(data));
-      }
-      console.log(`[CacheManager] Loaded ${this.cache.size} cache entries`);
-    } catch (error: any) {
-      console.error(`[CacheManager] Failed to load cache: ${error.message}`);
-    }
-  }
-
-  /**
-   * 保存缓存
-   */
-  private saveCache(): void {
-    try {
-      const cacheFile = process.env.PAGE_ACTION_CACHE_FILE || '/tmp/page-action-cache.json';
-      const fs = require('fs');
-      const data = Array.from(this.cache.entries());
-      fs.writeFileSync(cacheFile, JSON.stringify(data, null, 2));
-      console.log(`[CacheManager] Saved ${data.length} cache entries`);
-    } catch (error: any) {
-      console.error(`[CacheManager] Failed to save cache: ${error.message}`);
-    }
-  }
-
-  /**
-   * 自动保存
-   */
-  private startAutoSave(): void {
-    setInterval(() => this.saveCache(), 60000); // 每分钟保存一次
-  }
-
-  /**
-   * 查询缓存
-   */
-  query(url: string, viewport?: string): CacheEntry | null {
-    const key = this.getCacheKey(url, viewport);
-
-    if (!key) {
-      return null;
-    }
-
-    this.totalQueries++;
-    const entry = this.cache.get(key);
-    if (entry) {
-      this.totalHits++;
-      return entry;
-    }
-    return null;
-  }
-
-  /**
-   * 更新缓存状态
-   */
-  updateCacheStatus(id: string, success: boolean): void {
-    const entry = this.cache.get(id);
-    if (!entry) {
-      return;
-    }
-
-    // CacheEntry doesn't have successCount/failCount, so we skip this
-    // This is a compatibility method for older API
-    console.log(`[CacheManager] Cache status update requested for ${id}: ${success}`);
-  }
-
-  /**
-   * 生成缓存键
-   */
-  private getCacheKey(url: string, viewport?: string | { width?: number; height?: number }): string {
-    let viewportStr = 'default';
-    if (viewport) {
-      if (typeof viewport === 'string') {
-        viewportStr = viewport;
-      } else if (viewport.width && viewport.height) {
-        viewportStr = `${viewport.width}x${viewport.height}`;
-      }
-    }
-    return `${url}:${viewportStr}`;
-  }
-
-  /**
-   * 添加缓存条目
-   */
-  addCache(params: {
-    url: string;
-    actions: Array<{ type: 'navigate' | 'click' | 'screenshot' | 'type' | 'script'; params?: any; successCount?: number; failCount?: number }>;
-    scenario?: ScenarioType;
-    viewport?: string | { width?: number; height?: number };
-  }): string {
-    const key = this.getCacheKey(params.url, params.viewport);
-    const entry: CacheEntry = {
-      id: Date.now().toString(),
-      url: params.url,
-      viewport: typeof params.viewport === 'string' ? params.viewport : (params.viewport ? `${params.viewport.width}x${params.viewport.height}` : '1920x1080'),
-      actions: params.actions.map(action => ({
-        ...action,
-        successCount: action.successCount || 0,
-        failCount: action.failCount || 0
-      })),
-      scenario: params.scenario || 'unknown',
-      timestamp: Date.now(),
-      hitRate: 0,
-      savedActions: 0,
-      savedTime: 0
-    };
-
-    this.cache.set(key, entry);
-    this.stats.totalEntries = this.cache.size;
-    this.stats.totalActions += params.actions.length;
-
-    return entry.id;
-  }
-
-  /**
-   * 获取缓存
-   */
-  getCache(id: string): CacheEntry | null {
-    return this.cache.get(id) || null;
-  }
-
-  /**
-   * 清空缓存
-   */
-  clearCache(): void {
-    this.cache.clear();
-    this.stats = {
-      totalEntries: 0,
-      totalActions: 0,
-      hitRate: 0,
-      savedActions: 0,
-      savedTime: 0
-    };
-    this.totalQueries = 0;
-    this.totalHits = 0;
-    console.log('[CacheManager] Cache cleared');
-  }
-
-  /**
-   * 获取统计
-   */
-  getStats(): CacheStats & {
-    totalQueries: number;
-    totalHits: number;
-    savedTimeFormatted: string;
-  } {
-    const hitRate = this.totalQueries > 0 ? (this.totalHits / this.totalQueries) * 100 : 0;
-    const savedTimePerMin = this.stats.savedTime > 0 ? this.stats.savedTime / 60000 : 0; // 转换为分钟
-
-    return {
-      ...this.stats,
-      hitRate: Math.round(hitRate * 100) / 100,
-      totalQueries: this.totalQueries,
-      totalHits: this.totalHits,
-      savedTimeFormatted: savedTimePerMin > 0
-          ? `${savedTimePerMin > 60 ? Math.floor(savedTimePerMin) : savedTimePerMin.toFixed(2)} 分钟`
-          : '0 分钟'
-    };
-  }
-
-  /**
-   * 销毁
-   */
-  destroy(): void {
-    this.cache.clear();
-    if (this.autoSaveInterval) {
-      clearInterval(this.autoSaveInterval);
-      this.autoSaveInterval = null;
-    }
-  }
-}
-
-/**
- * 单例导出
- */
-export const cacheManager = new CacheManager();

package/src/index.ts

@@ -1,58 +0,0 @@
-/**
- * Page Action Cache - OpenClaw Extension
- * 页面操作缓存扩展 - OpenClaw 扩展
- */
-
-import type { OpenClawPluginApi } from './types-mock.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));
-
-  // 检查配置对象是否有效
-  if (!rawConfig || typeof rawConfig !== 'object') {
-    console.log('[PageActionCache] Invalid config object type:', typeof rawConfig);
-    // 配置无效，使用空对象继续
-    rawConfig = {};
-  }
-
-  const pluginConfig = rawConfig?.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...');
-
-  // 注册缓存执行工具
-  api.registerTool({
-    name: 'browser_cache_execute',
-    description: '执行缓存的页面操作序列，支持自动缓存匹配、场景识别和变量提取',
-    async execute(ctx: 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;