page-action-cache 1.0.4 → 2.0.1

package/dist/hooks.js

@@ -1,277 +0,0 @@
-/**
- * Hooks Integration
- * Hooks 集成 - 注册 OpenClaw Hooks 来拦截和增强浏览器操作
- */
-import { getCacheStore } from "./cache-store.js";
-import { getScenarioRecognizer } from "./scenario-recognizer.js";
-import { getVariableResolver } from "./variable-resolver.js";
-// ============================================================================
-// 默认配置
-// ============================================================================
-const DEFAULT_CONFIG = {
-    // === 全局开关 ===
-    enabled: true,
-    autoUseCache: true,
-    // === 场景识别 ===
-    scenarioRecognitionEnabled: true,
-    llmClassificationThreshold: 70,
-    // === 缓存策略 ===
-    cacheLevelStrategy: "auto",
-    defaultCacheLevel: "L3",
-    // === 缓存失效 ===
-    pageChangeDetectionEnabled: true,
-    changeInvalidationThreshold: 80,
-    invalidationStrategy: "soft",
-    maxVersionsPerEntry: 3,
-    // === 变量系统 ===
-    variableExtractionEnabled: true,
-    allowUserConfirmVariables: false,
-    // === 安全 ===
-    encryptSensitiveCache: false,
-    accessControlEnabled: false,
-    allowedUserIds: [],
-    logSanitizationEnabled: true,
-    // === 用户体验 ===
-    showCacheStatusToUser: true,
-    enableUserCacheConfirmation: false,
-    enableUserForcedRefresh: true,
-    enableUserCacheErrorReport: true,
-    // === 统计 ===
-    trackExecutionStats: true,
-    statsUpdateInterval: 60,
-};
-// ============================================================================
-// Hooks 注册
-// ============================================================================
-/**
- * 注册页面操作缓存扩展的 Hooks
- */
-export function registerPageActionCacheHooks(api, config) {
-    const finalConfig = { ...DEFAULT_CONFIG, ...config };
-    if (!finalConfig.enabled) {
-        console.log("[PageActionCache] Extension disabled");
-        return;
-    }
-    const cacheStore = getCacheStore();
-    const scenarioRecognizer = getScenarioRecognizer();
-    const variableResolver = getVariableResolver();
-    // UX enhancer for future use
-    // const uxEnhancer = getUXEnhancer();
-    // -------------------------------------------------------------------------
-    // before_tool_call hook - 场景识别和缓存拦截
-    // -------------------------------------------------------------------------
-    api.registerHook({
-        name: "before_tool_call",
-        priority: 100,
-        description: "页面操作缓存 - 场景识别和缓存拦截",
-        async handler(event, ctx) {
-            if (event.tool.name !== "browser") {
-                return { block: false };
-            }
-            const params = event.params;
-            const url = params.url;
-            const action = params.action;
-            // 只缓存特定操作
-            const cacheActions = ["navigate", "click", "type", "press", "hover"];
-            if (!cacheActions.includes(action)) {
-                return { block: false };
-            }
-            // 提取用户输入
-            const userInput = extractUserInput(ctx);
-            const currentUrl = url || ctx.currentUrl || "";
-            // 场景识别
-            if (finalConfig.scenarioRecognitionEnabled) {
-                const match = await scenarioRecognizer.recognize(userInput, currentUrl);
-                if (match && match.confidence >= 80) {
-                    // 高置信度匹配，返回 cacheInfo
-                    return {
-                        block: false,
-                        result: {
-                            cacheInfo: {
-                                exists: true,
-                                scenario: match.scenario,
-                                confidence: match.confidence,
-                                method: match.method,
-                                matchedPattern: match.matchedPattern,
-                            },
-                        },
-                    };
-                }
-            }
-            // 检查缓存
-            const viewport = extractViewport(ctx, params);
-            const entry = cacheStore.get(url, viewport);
-            if (entry) {
-                const stats = cacheStore.getStats();
-                // L3 缓存命中，返回 cacheInfo
-                return {
-                    block: false,
-                    result: {
-                        cacheInfo: {
-                            exists: true,
-                            cacheLevel: entry.cacheLevel,
-                            scenario: entry.scenario,
-                            actions: entry.actions,
-                            variables: entry.variables,
-                            cacheKey: entry.key,
-                        },
-                        stats: {
-                            hitRate: stats.hitRate,
-                            savedTokens: stats.savedTokens,
-                        },
-                    },
-                };
-            }
-            return { block: false };
-        },
-    });
-    // -------------------------------------------------------------------------
-    // after_tool_call hook - 保存 LLM 分析结果到缓存
-    // -------------------------------------------------------------------------
-    api.registerHook({
-        name: "after_tool_call",
-        priority: 100,
-        description: "页面操作缓存 - 保存 LLM 分析结果",
-        async handler(event, ctx) {
-            if (event.tool.name !== "browser") {
-                return;
-            }
-            const params = event.params;
-            const url = params.url;
-            const action = params.action;
-            // 只缓存特定操作
-            const cacheActions = ["navigate", "click", "type", "press", "hover"];
-            if (!cacheActions.includes(action)) {
-                return;
-            }
-            // 检查 LLM 是否返回了场景类型
-            const result = event.result;
-            const llmScenario = result.scenario;
-            if (!llmScenario) {
-                // 没有 LLM 标记的场景，不保存
-                return;
-            }
-            // 识别场景并获取变量
-            const userInput = extractUserInput(ctx);
-            const scenarioMatch = await scenarioRecognizer.recognize(userInput, url);
-            // 决定缓存层级
-            let cacheLevel = "L3";
-            if (finalConfig.cacheLevelStrategy === "auto" && scenarioMatch) {
-                cacheLevel =
-                    scenarioMatch.confidence >= 85
-                        ? "L3"
-                        : scenarioMatch.confidence >= 70
-                            ? "L2"
-                            : "L1";
-            }
-            else {
-                cacheLevel = finalConfig.defaultCacheLevel;
-            }
-            // 解析变量
-            let variables;
-            if (finalConfig.variableExtractionEnabled && scenarioMatch) {
-                variables = variableResolver.resolveVariables(userInput, scenarioMatch.scenario);
-            }
-            // 保存到缓存
-            const viewport = extractViewport(ctx, params);
-            const actions = result.actions || [];
-            if (actions.length > 0) {
-                cacheStore.set(url, viewport, actions, {
-                    scenario: scenarioMatch?.scenario || llmScenario,
-                    cacheLevel,
-                    variables,
-                    description: result.description || `Cached ${llmScenario} actions`,
-                    pageType: result.pageType || "mixed",
-                });
-                console.log(`[PageActionCache] Saved cache entry: ${scenarioMatch?.scenario || llmScenario} (${cacheLevel})`);
-            }
-        },
-    });
-    // -------------------------------------------------------------------------
-    // before_prompt_build hook - 注入缓存使用指南
-    // -------------------------------------------------------------------------
-    api.registerHook({
-        name: "before_prompt_build",
-        priority: 50,
-        description: "页面操作缓存 - 注入缓存使用指南",
-        async handler(_event, _ctx) {
-            if (!finalConfig.autoUseCache) {
-                return;
-            }
-            const stats = cacheStore.getStats();
-            // 只在命中率较高时注入
-            if (stats.hitRate < 30) {
-                return;
-            }
-            // 构建缓存使用指南
-            const guide = `
-【页面操作缓存系统】
-
-当前缓存统计：
-- 总条目数：${stats.totalEntries}
-- 总命中：${stats.totalHits}
-- 命中率：${stats.hitRate.toFixed(1)}%
-
-已缓存的场景：
-${cacheStore.getTopScenarios(5)}
-
-使用方式：
-1. 如果工具返回 cacheInfo 信息，优先使用 execute_cached 工具
-2. 执行缓存操作可以大幅降低 token 消耗和操作延迟
-3. 如果页面结构变化，缓存会自动失效
-
-支持的场景：login, logout, search, checkout, settings, form_fill, navigate, screenshot
-
-缓存层级：
-- L3: 场景级缓存（包含变量模板）- 高置信度时直接使用
-- L2: 流程级缓存 - 中置信度时使用
-- L1: 原子级缓存 - 低置信度或无场景时使用
-
-可用的缓存工具：
-- execute_cached: 执行缓存的操作序列
-- cache_stats: 查看缓存统计
-- cache_list: 列出所有缓存
-- cache_clear: 清空缓存
-- scenario_list: 列出所有场景
-- force_refresh: 强制刷新指定缓存
-`;
-            return { prependContext: guide };
-        },
-    });
-    console.log("[PageActionCache] Hooks registered successfully");
-}
-// ============================================================================
-// 辅助函数
-// ============================================================================
-/**
- * 从上下文提取用户输入
- */
-function extractUserInput(ctx) {
-    // 尝试从上下文中提取用户输入
-    if (ctx.message?.content) {
-        return ctx.message.content;
-    }
-    if (ctx.userInput) {
-        return ctx.userInput;
-    }
-    if (ctx.prompt) {
-        return ctx.prompt;
-    }
-    return "";
-}
-/**
- * 从上下文和参数提取视口尺寸
- */
-function extractViewport(ctx, params) {
-    // 优先从参数获取
-    if (params.viewport) {
-        return params.viewport;
-    }
-    // 其次从上下文获取
-    if (ctx.viewport) {
-        return ctx.viewport;
-    }
-    // 默认值
-    return { width: 1920, height: 1080 };
-}
-//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/security-policy.d.ts

@@ -1,62 +0,0 @@
-/**
- * Security Policy
- * 安全策略 - 敏感变量检测、加密存储、访问控制
- */
-import type { AtomicAction, PageActionCacheEntry, VariableMap } from "./types.js";
-/**
- * 安全策略
- */
-export declare class SecurityPolicy {
-    private allowedUserIds;
-    constructor(allowedUserIds?: string[]);
-    /**
-     * 检查操作是否包含敏感变量
-     */
-    isSensitiveAction(action: AtomicAction): boolean;
-    /**
-     * 检查变量映射是否包含敏感数据
-     */
-    hasSensitiveData(variables: VariableMap): boolean;
-    /**
-     * 获取敏感字段列表
-     */
-    getSensitiveFields(): string[];
-    /**
-     * 加密数据
-     */
-    encrypt(data: string): string;
-    /**
-     * 解密数据
-     */
-    decrypt(encrypted: string): string;
-    /**
-     * 加密缓存条目中的敏感变量
-     */
-    encryptCacheEntry(entry: PageActionCacheEntry): PageActionCacheEntry;
-    /**
-     * 解密缓存条目中的敏感变量
-     */
-    decryptCacheEntry(entry: PageActionCacheEntry): PageActionCacheEntry;
-    /**
-     * 检查是否允许访问
-     */
-    canAccessCache(userId?: string): boolean;
-    /**
-     * 添加允许的用户 ID
-     */
-    addAllowedUserId(userId: string): void;
-    /**
-     * 移除允许的用户 ID
-     */
-    removeAllowedUserId(userId: string): void;
-    /**
-     * 脱敏处理（用于日志输出）
-     */
-    sanitizeForLogging(data: any): any;
-    /**
-     * 脱敏处理操作列表
-     */
-    sanitizeActions(actions: AtomicAction[]): AtomicAction[];
-}
-export declare function getSecurityPolicy(allowedUserIds?: string[]): SecurityPolicy;
-//# sourceMappingURL=security-policy.d.ts.map

package/dist/security-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuBlF;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAc;gBAExB,cAAc,GAAE,MAAM,EAAO;IAQzC;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAQhD;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO;IASjD;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAQ9B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAoB7B;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IA4BlC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,oBAAoB;IAoBpE;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,oBAAoB;IAwBpE;;OAEG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAYxC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQzC;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG;IAsBlC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;CAYzD;AAQD,wBAAgB,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,CAK3E"}

package/dist/security-policy.js

@@ -1,219 +0,0 @@
-/**
- * Security Policy
- * 安全策略 - 敏感变量检测、加密存储、访问控制
- */
-import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
-// ============================================================================
-// 配置
-// ============================================================================
-const SENSITIVE_FIELDS = new Set([
-    "password",
-    "pwd",
-    "token",
-    "secret",
-    "key",
-    "code",
-    "otp",
-]);
-const ENCRYPTION_KEY = "default-key-change-in-production"; // 生产环境应从配置读取
-const ENCRYPTION_ALGORITHM = "aes-256-gcm";
-// ============================================================================
-// Security Policy 类
-// ============================================================================
-/**
- * 安全策略
- */
-export class SecurityPolicy {
-    allowedUserIds;
-    constructor(allowedUserIds = []) {
-        this.allowedUserIds = new Set(allowedUserIds);
-    }
-    // -------------------------------------------------------------------------
-    // 敏感字段检测
-    // -------------------------------------------------------------------------
-    /**
-     * 检查操作是否包含敏感变量
-     */
-    isSensitiveAction(action) {
-        if (!action.variable) {
-            return false;
-        }
-        return SENSITIVE_FIELDS.has(action.variable.toLowerCase());
-    }
-    /**
-     * 检查变量映射是否包含敏感数据
-     */
-    hasSensitiveData(variables) {
-        for (const key of Object.keys(variables)) {
-            if (SENSITIVE_FIELDS.has(key.toLowerCase())) {
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * 获取敏感字段列表
-     */
-    getSensitiveFields() {
-        return Array.from(SENSITIVE_FIELDS);
-    }
-    // -------------------------------------------------------------------------
-    // 加密/解密
-    // -------------------------------------------------------------------------
-    /**
-     * 加密数据
-     */
-    encrypt(data) {
-        try {
-            const iv = randomBytes(16);
-            const cipher = createCipheriv(ENCRYPTION_ALGORITHM, Buffer.from(ENCRYPTION_KEY), iv);
-            let encrypted = cipher.update(data, "utf8", "hex");
-            encrypted += cipher.final("hex");
-            const authTag = cipher.getAuthTag();
-            return `${iv.toString("hex")}:${authTag.toString("hex")}:${encrypted}`;
-        }
-        catch (error) {
-            console.error("[SecurityPolicy] Encryption failed:", error);
-            return data; // 失败时返回原数据
-        }
-    }
-    /**
-     * 解密数据
-     */
-    decrypt(encrypted) {
-        try {
-            const [ivHex, authTagHex, data] = encrypted.split(":");
-            if (!ivHex || !authTagHex || !data) {
-                return encrypted; // 格式错误，返回原数据
-            }
-            const iv = Buffer.from(ivHex, "hex");
-            const authTag = Buffer.from(authTagHex, "hex");
-            const decipher = createDecipheriv(ENCRYPTION_ALGORITHM, Buffer.from(ENCRYPTION_KEY), iv);
-            decipher.setAuthTag(authTag);
-            let decrypted = decipher.update(data, "hex", "utf8");
-            decrypted += decipher.final("utf8");
-            return decrypted;
-        }
-        catch (error) {
-            console.error("[SecurityPolicy] Decryption failed:", error);
-            return encrypted; // 失败时返回原数据
-        }
-    }
-    /**
-     * 加密缓存条目中的敏感变量
-     */
-    encryptCacheEntry(entry) {
-        if (!entry.variables) {
-            return entry;
-        }
-        const encrypted = { ...entry };
-        encrypted.variables = {};
-        for (const [key, value] of Object.entries(entry.variables)) {
-            if (SENSITIVE_FIELDS.has(key.toLowerCase()) && typeof value === "string") {
-                // 敏感字段加密
-                encrypted.variables[key] = this.encrypt(value);
-            }
-            else {
-                encrypted.variables[key] = value;
-            }
-        }
-        return encrypted;
-    }
-    /**
-     * 解密缓存条目中的敏感变量
-     */
-    decryptCacheEntry(entry) {
-        if (!entry.variables) {
-            return entry;
-        }
-        const decrypted = { ...entry };
-        decrypted.variables = {};
-        for (const [key, value] of Object.entries(entry.variables)) {
-            if (SENSITIVE_FIELDS.has(key.toLowerCase()) && typeof value === "string") {
-                // 敏感字段解密
-                decrypted.variables[key] = this.decrypt(value);
-            }
-            else {
-                decrypted.variables[key] = value;
-            }
-        }
-        return decrypted;
-    }
-    // -------------------------------------------------------------------------
-    // 访问控制
-    // -------------------------------------------------------------------------
-    /**
-     * 检查是否允许访问
-     */
-    canAccessCache(userId) {
-        if (this.allowedUserIds.size === 0) {
-            return true; // 没有限制，允许所有用户
-        }
-        if (!userId) {
-            return false; // 没有用户 ID，拒绝访问
-        }
-        return this.allowedUserIds.has(userId);
-    }
-    /**
-     * 添加允许的用户 ID
-     */
-    addAllowedUserId(userId) {
-        this.allowedUserIds.add(userId);
-    }
-    /**
-     * 移除允许的用户 ID
-     */
-    removeAllowedUserId(userId) {
-        this.allowedUserIds.delete(userId);
-    }
-    // -------------------------------------------------------------------------
-    // 日志脱敏
-    // -------------------------------------------------------------------------
-    /**
-     * 脱敏处理（用于日志输出）
-     */
-    sanitizeForLogging(data) {
-        if (typeof data !== "object" || data === null) {
-            return data;
-        }
-        const sanitized = Array.isArray(data) ? [] : {};
-        for (const [key, value] of Object.entries(data)) {
-            if (SENSITIVE_FIELDS.has(key.toLowerCase())) {
-                // 敏感字段脱敏
-                sanitized[key] = "***REDACTED***";
-            }
-            else if (typeof value === "object") {
-                // 递归处理嵌套对象
-                sanitized[key] = this.sanitizeForLogging(value);
-            }
-            else {
-                sanitized[key] = value;
-            }
-        }
-        return sanitized;
-    }
-    /**
-     * 脱敏处理操作列表
-     */
-    sanitizeActions(actions) {
-        return actions.map((action) => {
-            const sanitized = { ...action };
-            // 脱敏操作中的敏感文本
-            if (sanitized.type === "type" && this.isSensitiveAction(action)) {
-                sanitized.text = "***REDACTED***";
-            }
-            return sanitized;
-        });
-    }
-}
-// ============================================================================
-// 单例
-// ============================================================================
-let securityPolicyInstance = null;
-export function getSecurityPolicy(allowedUserIds) {
-    if (!securityPolicyInstance) {
-        securityPolicyInstance = new SecurityPolicy(allowedUserIds);
-    }
-    return securityPolicyInstance;
-}
-//# sourceMappingURL=security-policy.js.map

package/dist/security-policy.js.map

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