page-action-cache 1.0.4 → 2.0.1

package/dist/multi-level-cache.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Multi-Level Cache - Page Action Cache
+ * 多级缓存管理器 - L3/L2/L1 缓存层次
+ */
+import type { CacheEntry, ScenarioType, CacheActionType } from './types.js';
+/**
+ * 缓存级别
+ */
+export type CacheLevel = 'L3' | 'L2' | 'L1';
+/**
+ * 缓存条目扩展
+ */
+interface ExtendedCacheEntry extends CacheEntry {
+    level: CacheLevel;
+    createdAt: number;
+    lastAccessed: number;
+    accessCount: number;
+    expiresAt: number;
+    llmClassificationScore?: number;
+}
+/**
+ * 缓存策略
+ */
+type CacheStrategy = 'auto' | 'l3-only' | 'l2-only' | 'l1-only';
+/**
+ * 多级缓存管理器
+ */
+export declare class MultiLevelCache {
+    private levels;
+    private levelConfigs;
+    private strategy;
+    private llmThreshold;
+    constructor();
+    /**
+     * 初始化缓存级别
+     */
+    private initializeLevels;
+    /**
+     * 设置缓存策略
+     */
+    setStrategy(strategy: CacheStrategy): void;
+    /**
+     * 设置 LLM 分类阈值
+     */
+    setLLMThreshold(threshold: number): void;
+    /**
+     * 添加缓存条目
+     */
+    addCache(url: string, viewport: string, actions: Array<{
+        type: CacheActionType;
+        params?: any;
+        successCount: number;
+        failCount: number;
+    }>, scenario?: ScenarioType, llmScore?: number): string;
+    /**
+     * 确定缓存级别
+     */
+    private determineCacheLevel;
+    /**
+     * 查询缓存
+     */
+    queryCache(url: string, viewport: string): ExtendedCacheEntry | null;
+    /**
+     * 判断是否应该提升缓存级别
+     */
+    private shouldPromote;
+    /**
+     * 提升缓存条目到更高级别
+     */
+    private promoteEntry;
+    /**
+     * 确保缓存容量
+     */
+    private ensureCapacity;
+    /**
+     * 驱逐缓存条目（LRU 策略）
+     */
+    private evictEntry;
+    /**
+     * 删除缓存条目
+     */
+    deleteCache(url: string, viewport: string): boolean;
+    /**
+     * 删除 URL 相关的所有缓存
+     */
+    deleteCacheByUrl(url: string): void;
+    /**
+     * 清空指定级别的缓存
+     */
+    clearLevel(level: CacheLevel): void;
+    /**
+     * 清空所有缓存
+     */
+    clearAll(): void;
+    /**
+     * 获取缓存统计
+     */
+    getStats(): {
+        totalEntries: number;
+        totalHits: number;
+        hitRate: number;
+        levelStats: Record<CacheLevel, {
+            size: number;
+            maxCapacity: number;
+            usageRate: number;
+            avgAccessCount: number;
+        }>;
+    };
+    /**
+     * 获取查询计数（用于统计）
+     */
+    private getQueryCount;
+    /**
+     * 生成缓存键
+     */
+    private getCacheKey;
+    /**
+     * 清理过期条目
+     */
+    cleanupExpired(): number;
+}
+/**
+ * 单例导出
+ */
+export declare const multiLevelCache: MultiLevelCache;
+export {};
+//# sourceMappingURL=multi-level-cache.d.ts.map

package/dist/multi-level-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-level-cache.d.ts","sourceRoot":"","sources":["../src/multi-level-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAa5C;;GAEG;AACH,UAAU,kBAAmB,SAAQ,UAAU;IAC7C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,KAAK,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhE;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA+D;IAC7E,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,YAAY,CAAe;;IAMnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI1C;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,QAAQ,CACN,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,eAAe,CAAC;QACtB,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,EACF,QAAQ,CAAC,EAAE,YAAY,EACvB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAgCT;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAsCpE;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAcnD;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAoBnC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IASnC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;YAC7B,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,MAAM,CAAC;YAClB,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC,CAAC;KACJ;IAsCD;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,cAAc,IAAI,MAAM;CAyBzB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/multi-level-cache.js

@@ -0,0 +1,362 @@
+/**
+ * Multi-Level Cache - Page Action Cache
+ * 多级缓存管理器 - L3/L2/L1 缓存层次
+ */
+/**
+ * 多级缓存管理器
+ */
+export class MultiLevelCache {
+    levels = new Map();
+    levelConfigs = new Map();
+    strategy = 'auto';
+    llmThreshold = 0.8;
+    constructor() {
+        this.initializeLevels();
+    }
+    /**
+     * 初始化缓存级别
+     */
+    initializeLevels() {
+        // L3: 持久化缓存，最大容量，最长 TTL
+        this.levelConfigs.set('L3', {
+            level: 'L3',
+            maxSize: 1000,
+            ttl: 30 * 24 * 60 * 60 * 1000, // 30 天
+            hitPriority: 1,
+            description: '持久化缓存，适合稳定的重复操作'
+        });
+        // L2: 内存缓存，中等容量，中等 TTL
+        this.levelConfigs.set('L2', {
+            level: 'L2',
+            maxSize: 200,
+            ttl: 7 * 24 * 60 * 60 * 1000, // 7 天
+            hitPriority: 2,
+            description: '内存缓存，适合频繁访问的操作'
+        });
+        // L1: 热点缓存，小容量，短 TTL
+        this.levelConfigs.set('L1', {
+            level: 'L1',
+            maxSize: 50,
+            ttl: 1 * 24 * 60 * 60 * 1000, // 1 天
+            hitPriority: 3,
+            description: '热点缓存，适合当前会话的操作'
+        });
+        // 初始化各级缓存
+        this.levels.set('L3', new Map());
+        this.levels.set('L2', new Map());
+        this.levels.set('L1', new Map());
+    }
+    /**
+     * 设置缓存策略
+     */
+    setStrategy(strategy) {
+        this.strategy = strategy;
+    }
+    /**
+     * 设置 LLM 分类阈值
+     */
+    setLLMThreshold(threshold) {
+        this.llmThreshold = Math.max(0, Math.min(1, threshold));
+    }
+    /**
+     * 添加缓存条目
+     */
+    addCache(url, viewport, actions, scenario, llmScore) {
+        const key = this.getCacheKey(url, viewport);
+        const level = this.determineCacheLevel(scenario, llmScore);
+        const entry = {
+            id: Date.now().toString(),
+            url,
+            viewport,
+            actions,
+            scenario: scenario || 'unknown',
+            timestamp: Date.now(),
+            hitRate: 0,
+            savedActions: 0,
+            savedTime: 0,
+            level,
+            createdAt: Date.now(),
+            lastAccessed: Date.now(),
+            accessCount: 0,
+            expiresAt: Date.now() + this.levelConfigs.get(level).ttl,
+            llmClassificationScore: llmScore
+        };
+        // 确保不超过容量限制
+        this.ensureCapacity(level);
+        const cache = this.levels.get(level);
+        cache.set(key, entry);
+        console.log(`[MultiLevelCache] Added entry to ${level}: ${key}`);
+        return entry.id;
+    }
+    /**
+     * 确定缓存级别
+     */
+    determineCacheLevel(scenario, llmScore) {
+        // 如果指定了特定策略
+        if (this.strategy === 'l3-only')
+            return 'L3';
+        if (this.strategy === 'l2-only')
+            return 'L2';
+        if (this.strategy === 'l1-only')
+            return 'L1';
+        // 自动策略：根据场景和 LLM 分类分数确定级别
+        if (llmScore !== undefined) {
+            if (llmScore >= this.llmThreshold) {
+                return 'L3'; // 高置信度使用 L3
+            }
+            else if (llmScore >= 0.5) {
+                return 'L2'; // 中等置信度使用 L2
+            }
+        }
+        // 根据场景确定级别
+        switch (scenario) {
+            case 'login':
+            case 'payment':
+                return 'L3'; // 敏感操作使用 L3
+            case 'search':
+            case 'checkout':
+                return 'L2'; // 重要操作使用 L2
+            default:
+                return 'L1'; // 一般操作使用 L1
+        }
+    }
+    /**
+     * 查询缓存
+     */
+    queryCache(url, viewport) {
+        const key = this.getCacheKey(url, viewport);
+        // 按优先级从高到低查询
+        const levelsToCheck = ['L1', 'L2', 'L3'];
+        for (const level of levelsToCheck) {
+            if (this.strategy !== 'auto' && !this.strategy.includes(level)) {
+                continue;
+            }
+            const cache = this.levels.get(level);
+            if (!cache)
+                continue;
+            const entry = cache.get(key);
+            if (entry) {
+                // 检查是否过期
+                if (Date.now() > entry.expiresAt) {
+                    cache.delete(key);
+                    continue;
+                }
+                // 更新访问统计
+                entry.lastAccessed = Date.now();
+                entry.accessCount++;
+                // 如果不是当前最高级别，考虑提升
+                if (this.shouldPromote(entry, level)) {
+                    this.promoteEntry(entry, level);
+                }
+                return entry;
+            }
+        }
+        return null;
+    }
+    /**
+     * 判断是否应该提升缓存级别
+     */
+    shouldPromote(entry, currentLevel) {
+        if (currentLevel === 'L3')
+            return false;
+        // 访问次数超过阈值则提升
+        const accessThreshold = currentLevel === 'L1' ? 5 : 10;
+        if (entry.accessCount >= accessThreshold) {
+            return true;
+        }
+        // 成功率高且场景重要则提升
+        const totalAttempts = entry.actions.reduce((sum, a) => sum + a.successCount + a.failCount, 0);
+        if (totalAttempts > 0) {
+            const successRate = entry.actions.reduce((sum, a) => sum + a.successCount, 0) / totalAttempts;
+            if (successRate > 0.9 && (entry.scenario === 'login' || entry.scenario === 'payment')) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 提升缓存条目到更高级别
+     */
+    promoteEntry(entry, fromLevel) {
+        const targetLevel = fromLevel === 'L1' ? 'L2' : 'L3';
+        const sourceCache = this.levels.get(fromLevel);
+        const targetCache = this.levels.get(targetLevel);
+        if (!sourceCache || !targetCache) {
+            return;
+        }
+        const key = this.getCacheKey(entry.url, entry.viewport || '');
+        sourceCache.delete(key);
+        entry.level = targetLevel;
+        entry.expiresAt = Date.now() + this.levelConfigs.get(targetLevel).ttl;
+        this.ensureCapacity(targetLevel);
+        targetCache.set(key, entry);
+        console.log(`[MultiLevelCache] Promoted entry from ${fromLevel} to ${targetLevel}: ${key}`);
+    }
+    /**
+     * 确保缓存容量
+     */
+    ensureCapacity(level) {
+        const config = this.levelConfigs.get(level);
+        if (!config)
+            return;
+        const cache = this.levels.get(level);
+        if (!cache)
+            return;
+        while (cache.size >= config.maxSize) {
+            this.evictEntry(level);
+        }
+    }
+    /**
+     * 驱逐缓存条目（LRU 策略）
+     */
+    evictEntry(level) {
+        const cache = this.levels.get(level);
+        if (!cache || cache.size === 0)
+            return;
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of cache.entries()) {
+            if (entry.lastAccessed < oldestTime) {
+                oldestTime = entry.lastAccessed;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            cache.delete(oldestKey);
+            console.log(`[MultiLevelCache] Evicted entry from ${level}: ${oldestKey}`);
+        }
+    }
+    /**
+     * 删除缓存条目
+     */
+    deleteCache(url, viewport) {
+        const key = this.getCacheKey(url, viewport);
+        let deleted = false;
+        for (const [level, cache] of this.levels.entries()) {
+            if (cache.delete(key)) {
+                deleted = true;
+                console.log(`[MultiLevelCache] Deleted entry from ${level}: ${key}`);
+            }
+        }
+        return deleted;
+    }
+    /**
+     * 删除 URL 相关的所有缓存
+     */
+    deleteCacheByUrl(url) {
+        const urlPrefix = `${url}:`;
+        for (const [_level, cache] of this.levels.entries()) {
+            const keysToDelete = [];
+            for (const key of cache.keys()) {
+                if (key.startsWith(urlPrefix)) {
+                    keysToDelete.push(key);
+                }
+            }
+            for (const key of keysToDelete) {
+                cache.delete(key);
+            }
+        }
+        console.log(`[MultiLevelCache] Deleted cache entries for URL: ${url}`);
+    }
+    /**
+     * 清空指定级别的缓存
+     */
+    clearLevel(level) {
+        const cache = this.levels.get(level);
+        if (cache) {
+            const count = cache.size;
+            cache.clear();
+            console.log(`[MultiLevelCache] Cleared ${count} entries from ${level}`);
+        }
+    }
+    /**
+     * 清空所有缓存
+     */
+    clearAll() {
+        for (const [level, cache] of this.levels.entries()) {
+            const count = cache.size;
+            cache.clear();
+            console.log(`[MultiLevelCache] Cleared ${count} entries from ${level}`);
+        }
+    }
+    /**
+     * 获取缓存统计
+     */
+    getStats() {
+        let totalEntries = 0;
+        let totalHits = 0;
+        const levelStats = {};
+        for (const [level, cache] of this.levels.entries()) {
+            const config = this.levelConfigs.get(level);
+            totalEntries += cache.size;
+            let levelHits = 0;
+            let totalAccess = 0;
+            for (const entry of cache.values()) {
+                totalHits += entry.accessCount;
+                levelHits += entry.accessCount;
+                totalAccess += entry.accessCount;
+            }
+            levelStats[level] = {
+                size: cache.size,
+                maxCapacity: config.maxSize,
+                usageRate: cache.size / config.maxSize,
+                avgAccessCount: cache.size > 0 ? levelHits / cache.size : 0
+            };
+        }
+        // 计算命中率
+        const totalQueries = this.getQueryCount();
+        const hitRate = totalQueries > 0 ? (totalHits / totalQueries) * 100 : 0;
+        return {
+            totalEntries,
+            totalHits,
+            hitRate: Math.round(hitRate * 100) / 100,
+            levelStats
+        };
+    }
+    /**
+     * 获取查询计数（用于统计）
+     */
+    getQueryCount() {
+        let count = 0;
+        for (const cache of this.levels.values()) {
+            for (const entry of cache.values()) {
+                count += entry.accessCount;
+            }
+        }
+        return count || 1; // 避免除以零
+    }
+    /**
+     * 生成缓存键
+     */
+    getCacheKey(url, viewport) {
+        return `${url}:${viewport}`;
+    }
+    /**
+     * 清理过期条目
+     */
+    cleanupExpired() {
+        let cleaned = 0;
+        const now = Date.now();
+        for (const [_level, cache] of this.levels.entries()) {
+            const expiredKeys = [];
+            for (const [key, entry] of cache.entries()) {
+                if (now > entry.expiresAt) {
+                    expiredKeys.push(key);
+                }
+            }
+            for (const key of expiredKeys) {
+                cache.delete(key);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            console.log(`[MultiLevelCache] Cleaned up ${cleaned} expired entries`);
+        }
+        return cleaned;
+    }
+}
+/**
+ * 单例导出
+ */
+export const multiLevelCache = new MultiLevelCache();
+//# sourceMappingURL=multi-level-cache.js.map

package/dist/multi-level-cache.js.map

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

package/dist/scenario-recognizer.d.ts

@@ -1,45 +1,35 @@
 /**
- * Scenario Recognizer
- * 场景识别器 - 多层匹配策略
+ * Scenario Recognizer - Page Action Cache
+ * 场景识别器 - 识别用户操作场景
  */
-import type { ScenarioRule, ScenarioMatch } from "./types.js";
+import type { ScenarioType } from './types.js';
 /**
  * 场景识别器
  */
 export declare class ScenarioRecognizer {
-    private cacheStore;
     /**
-     * 多层匹配策略
+     * 通过 URL 识别场景
      */
-    recognize(userInput: string, currentUrl: string): Promise<ScenarioMatch | null>;
+    recognizeByUrl(url: string): ScenarioType;
     /**
-     * 精确规则匹配
+     * 通过页面内容识别场景
      */
-    private matchExactRules;
+    recognizeByContent(content: string): ScenarioType;
     /**
-     * LLM 分类
+     * 综合识别（URL + 内容）
      */
-    private matchWithLLM;
+    recognize(url: string, content?: string): ScenarioType;
     /**
-     * 历史匹配
+     * 添加自定义场景规则
      */
-    private matchHistory;
+    addCustomRule(pattern: RegExp, scenario: ScenarioType): void;
     /**
-     * 计算 Jaccard 相似度
+     * 添加内容关键词
      */
-    private calculateJaccardSimilarity;
-    /**
-     * 获取所有规则
-     */
-    getRules(): ScenarioRule[];
-    /**
-     * 添加自定义规则
-     */
-    addRule(rule: ScenarioRule): void;
-    /**
-     * 获取建议的缓存层级
-     */
-    getRecommendedCacheLevel(scenario: string): "L3" | "L2" | "L1";
+    addContentKeyword(scenario: ScenarioType, keywords: string[]): void;
 }
-export declare function getScenarioRecognizer(): ScenarioRecognizer;
+/**
+ * 单例导出
+ */
+export declare const scenarioRecognizer: ScenarioRecognizer;
 //# sourceMappingURL=scenario-recognizer.d.ts.map

package/dist/scenario-recognizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenario-recognizer.d.ts","sourceRoot":"","sources":["../src/scenario-recognizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AA8EpB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAmB;IAErC;;OAEG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsBhC;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;OAEG;YACW,YAAY;IAY1B;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAclC;;OAEG;IACH,QAAQ,IAAI,YAAY,EAAE;IAI1B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIjC;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI;CAI/D;AAQD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D"}
+{"version":3,"file":"scenario-recognizer.d.ts","sourceRoot":"","sources":["../src/scenario-recognizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0C/C;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IASzC;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAiBjD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY;IActD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI5D;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;CAKpE;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}