page-action-cache 1.0.1

package/dist/types.d.ts

@@ -0,0 +1,336 @@
+/**
+ * Page Action Cache Extension - Type Definitions
+ * Version: 1.0.0
+ *
+ * 完全对齐 Playwright API 的类型定义
+ */
+/**
+ * 页面视口尺寸
+ */
+export interface PageViewport {
+    width: number;
+    height: number;
+}
+/**
+ * 变量映射
+ */
+export type VariableMap = Record<string, string>;
+/**
+ * 原子化操作类型
+ */
+export type AtomicActionType = "navigate" | "screenshot" | "click" | "type" | "press" | "hover" | "scroll" | "wait" | "select" | "focus" | "drag" | "upload" | "composite";
+/**
+ * Playwright 支持的按钮类型
+ */
+export type PlaywrightButton = "left" | "right" | "middle";
+/**
+ * Playwright 支持的修饰符
+ */
+export type PlaywrightModifier = "Alt" | "Control" | "ControlOrMeta" | "Meta" | "Shift";
+/**
+ * Playwright 导航策略
+ */
+export interface NavigationPolicy {
+    waitUntil?: "load" | "domcontentloaded" | "networkidle";
+    timeout?: number;
+}
+/**
+ * Evaluate 操作参数
+ */
+export interface EvaluateParams {
+    code: string;
+    args?: any[];
+}
+/**
+ * 原子化操作基类
+ */
+export interface BaseAtomicAction {
+    type: AtomicActionType;
+    cdpUrl?: string;
+    targetId?: string;
+    ref?: string;
+    variable?: string;
+    order: number;
+    description?: string;
+}
+/**
+ * 导航操作
+ */
+export interface NavigateAction extends BaseAtomicAction {
+    type: "navigate";
+    url: string;
+    navigationPolicy?: NavigationPolicy;
+}
+/**
+ * 点击操作
+ */
+export interface ClickAction extends BaseAtomicAction {
+    type: "click";
+    ref: string;
+    button?: PlaywrightButton;
+    doubleClick?: boolean;
+    modifiers?: PlaywrightModifier[];
+    timeoutMs?: number;
+}
+/**
+ * 输入操作
+ */
+export interface TypeAction extends BaseAtomicAction {
+    type: "type";
+    ref: string;
+    text: string;
+    submit?: boolean;
+    slowly?: boolean;
+    timeoutMs?: number;
+}
+/**
+ * 按键操作
+ */
+export interface PressAction extends BaseAtomicAction {
+    type: "press";
+    key: string;
+    delayMs?: number;
+}
+/**
+ * 悬停操作
+ */
+export interface HoverAction extends BaseAtomicAction {
+    type: "hover";
+    ref: string;
+    timeoutMs?: number;
+}
+/**
+ * 截图操作
+ */
+export interface ScreenshotAction extends BaseAtomicAction {
+    type: "screenshot";
+    screenshotPath?: string;
+}
+/**
+ * Evaluate 操作（scroll, wait, select, focus, drag, upload）
+ */
+export type EvaluateActionType = "scroll" | "wait" | "select" | "focus" | "drag" | "upload";
+export interface EvaluateAction extends BaseAtomicAction {
+    type: EvaluateActionType;
+    evaluate: EvaluateParams;
+    delay?: number;
+}
+/**
+ * 复合操作
+ */
+export interface CompositeAction extends BaseAtomicAction {
+    type: "composite";
+    actions: AtomicAction[];
+    atomic?: boolean;
+    rollback?: AtomicAction[];
+    label?: string;
+}
+/**
+ * 原子化操作联合类型
+ */
+export type AtomicAction = NavigateAction | ClickAction | TypeAction | PressAction | HoverAction | ScreenshotAction | EvaluateAction | CompositeAction;
+/**
+ * 操作类型（包含复合操作）
+ */
+export type Action = AtomicAction;
+/**
+ * 缓存层级
+ */
+export type CacheLevel = "L3" | "L2" | "L1";
+/**
+ * 页面类型
+ */
+export type PageType = "static" | "dynamic" | "mixed";
+/**
+ * 缓存来源
+ */
+export type CacheSource = "llm" | "manual" | "learned";
+/**
+ * DOM hash 特征
+ */
+export interface DOMHashFeatures {
+    formCount: number;
+    buttonCount: number;
+    linkCount: number;
+    scriptCount: number;
+    headingCount: number;
+}
+/**
+ * 页面变化检测结果
+ */
+export interface PageChangeDetection {
+    hasChanged: boolean;
+    changeType: "structure" | "content" | "none";
+    confidence: number;
+    domHash: string;
+    structureHash?: string;
+    lastCheckedAt: number;
+    details?: string;
+}
+/**
+ * 页面操作缓存条目
+ */
+export interface PageActionCacheEntry {
+    key: string;
+    url: string;
+    viewport: PageViewport;
+    cacheLevel: CacheLevel;
+    scenario: string;
+    description: string;
+    variables?: VariableMap;
+    urlPattern?: string;
+    actions: AtomicAction[];
+    screenshotPath?: string;
+    createdAt: number;
+    lastAccessTime: number;
+    accessCount: number;
+    expiresAt: number;
+    pageChangeDetection: PageChangeDetection;
+    source: CacheSource;
+    version?: number;
+    tags?: string[];
+    variant?: string;
+    successCount: number;
+    failCount: number;
+    avgExecutionTime: number;
+    pageType?: PageType;
+}
+/**
+ * 场景识别规则
+ */
+export interface ScenarioRule {
+    scenario: string;
+    keywords: string[];
+    urlPatterns: string[];
+    priority: number;
+    cacheLevel: CacheLevel;
+    confidence: number;
+}
+/**
+ * 场景匹配结果
+ */
+export interface ScenarioMatch {
+    scenario: string;
+    confidence: number;
+    method: "keyword" | "url" | "llm" | "history" | "learned";
+    matchedPattern?: string;
+}
+/**
+ * 缓存统计
+ */
+export interface CacheStats {
+    totalEntries: number;
+    totalHits: number;
+    totalMisses: number;
+    hitRate: number;
+    l3Hits: number;
+    l2Hits: number;
+    l1Hits: number;
+    scenarioMatches: number;
+    llmClassifications: number;
+    learnedAssociations: number;
+    savedTokens: number;
+    savedTime: number;
+    avgExecutionTime: number;
+    userConfirmations: number;
+    userForcedRefreshes: number;
+    cacheErrors: number;
+}
+/**
+ * 页面操作缓存存储
+ */
+export interface PageActionCacheStore {
+    version: number;
+    entries: Record<string, PageActionCacheEntry>;
+    scenarios: Map<string, ScenarioMatch>;
+    stats: CacheStats;
+}
+/**
+ * 缓存配置
+ */
+export interface CacheConfig {
+    enabled: boolean;
+    autoUseCache: boolean;
+    scenarioRecognitionEnabled: boolean;
+    llmClassificationThreshold: number;
+    cacheLevelStrategy: "auto" | "l3-only" | "l2-only" | "l1-only";
+    defaultCacheLevel: string;
+    pageChangeDetectionEnabled: boolean;
+    changeInvalidationThreshold: number;
+    invalidationStrategy: "soft" | "hard";
+    maxVersionsPerEntry: number;
+    variableExtractionEnabled: boolean;
+    allowUserConfirmVariables: boolean;
+    encryptSensitiveCache: boolean;
+    accessControlEnabled: boolean;
+    allowedUserIds: string[];
+    logSanitizationEnabled: boolean;
+    showCacheStatusToUser: boolean;
+    enableUserCacheConfirmation: boolean;
+    enableUserForcedRefresh: boolean;
+    enableUserCacheErrorReport: boolean;
+    trackExecutionStats: boolean;
+    statsUpdateInterval: number;
+}
+/**
+ * 操作执行结果
+ */
+export interface ExecutionResult {
+    action: string;
+    success: boolean;
+    error?: string;
+    duration: number;
+}
+/**
+ * Playwright 客户端接口
+ */
+export interface PwAi {
+    navigateViaPlaywright(opts: {
+        cdpUrl: string;
+        targetId?: string;
+        url: string;
+        waitUntil?: "load" | "domcontentloaded" | "networkidle";
+        timeout?: number;
+    }): Promise<void>;
+    clickViaPlaywright(opts: {
+        cdpUrl: string;
+        targetId?: string;
+        ref: string;
+        doubleClick?: boolean;
+        button?: "left" | "right" | "middle";
+        modifiers?: Array<"Alt" | "Control" | "ControlOrMeta" | "Meta" | "Shift">;
+        timeoutMs?: number;
+    }): Promise<void>;
+    typeViaPlaywright(opts: {
+        cdpUrl: string;
+        targetId?: string;
+        ref: string;
+        text: string;
+        submit?: boolean;
+        slowly?: boolean;
+        timeoutMs?: number;
+    }): Promise<void>;
+    pressKeyViaPlaywright(opts: {
+        cdpUrl: string;
+        targetId?: string;
+        key: string;
+        delayMs?: number;
+    }): Promise<void>;
+    hoverViaPlaywright(opts: {
+        cdpUrl: string;
+        targetId?: string;
+        ref: string;
+        timeoutMs?: number;
+    }): Promise<void>;
+    screenshotViaPlaywright(opts: {
+        cdpUrl: string;
+        targetId?: string;
+    }): Promise<string>;
+    evaluateViaPlaywright(opts: {
+        cdpUrl: string;
+        targetId?: string;
+        code: string;
+        args?: any[];
+    }): Promise<any>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAMjD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,YAAY,GACZ,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,KAAK,GACL,SAAS,GACT,eAAe,GACf,MAAM,GACN,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,IAAI,EAAE,YAAY,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,cAAc,GACd,WAAW,GACX,UAAU,GACV,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,cAAc,GACd,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,YAAY,CAAC;AAMlC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAEnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,YAAY,CAAC;IAGvB,UAAU,EAAE,UAAU,CAAC;IAGvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IAGpB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,mBAAmB,CAAC;IAGzC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IAEzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAGhB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IAGf,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC9C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,KAAK,EAAE,UAAU,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IAGtB,0BAA0B,EAAE,OAAO,CAAC;IACpC,0BAA0B,EAAE,MAAM,CAAC;IAGnC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/D,iBAAiB,EAAE,MAAM,CAAC;IAG1B,0BAA0B,EAAE,OAAO,CAAC;IACpC,2BAA2B,EAAE,MAAM,CAAC;IACpC,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAG5B,yBAAyB,EAAE,OAAO,CAAC;IACnC,yBAAyB,EAAE,OAAO,CAAC;IAGnC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;IAGhC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,2BAA2B,EAAE,OAAO,CAAC;IACrC,uBAAuB,EAAE,OAAO,CAAC;IACjC,0BAA0B,EAAE,OAAO,CAAC;IAGpC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,qBAAqB,CAAC,IAAI,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;QACxD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,kBAAkB,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QACrC,SAAS,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,GAAG,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;QAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,iBAAiB,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,qBAAqB,CAAC,IAAI,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,kBAAkB,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,uBAAuB,CAAC,IAAI,EAAE;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpB,qBAAqB,CAAC,IAAI,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;KACd,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Page Action Cache Extension - Type Definitions
+ * Version: 1.0.0
+ *
+ * 完全对齐 Playwright API 的类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/ux-enhancer.d.ts

@@ -0,0 +1,60 @@
+/**
+ * UX Enhancer
+ * 用户体验增强 - 缓存状态展示、用户确认、错误反馈
+ */
+import type { PageActionCacheEntry, ExecutionResult } from "./types.js";
+/**
+ * 用户体验增强器
+ */
+export declare class UXEnhancer {
+    private cacheStore;
+    /**
+     * 展示缓存状态
+     */
+    showCacheStatus(entry: PageActionCacheEntry, match?: {
+        confidence: number;
+        method: string;
+    }): string;
+    /**
+     * 格式化操作列表（简要版）
+     */
+    private formatActionsBrief;
+    /**
+     * 生成缓存使用确认提示
+     */
+    generateCacheConfirmationPrompt(entry: PageActionCacheEntry): string;
+    /**
+     * 生成试运行结果
+     */
+    generateDryRunResult(actions: any[]): string;
+    /**
+     * 生成执行结果报告
+     */
+    generateExecutionReport(results: ExecutionResult[], force?: boolean): string;
+    /**
+     * 生成缓存失效通知
+     */
+    generateInvalidationNotification(changeType: "structure" | "content", confidence: number): string;
+    /**
+     * 生成统计报告
+     */
+    generateStatsReport(): string;
+    /**
+     * 计算成功率
+     */
+    private calculateSuccessRate;
+    /**
+     * 记录用户确认
+     */
+    recordUserConfirmation(): void;
+    /**
+     * 记录用户强制刷新
+     */
+    recordUserForcedRefresh(): void;
+    /**
+     * 记录缓存错误
+     */
+    recordCacheError(): void;
+}
+export declare function getUXEnhancer(): UXEnhancer;
+//# sourceMappingURL=ux-enhancer.d.ts.map

package/dist/ux-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ux-enhancer.d.ts","sourceRoot":"","sources":["../src/ux-enhancer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOxE;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAmB;IAErC;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,CAAC,EAAE;QACnD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,MAAM;IAmCV;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,+BAA+B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM;IAYpE;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM;IAU5C;;OAEG;IACH,uBAAuB,CACrB,OAAO,EAAE,eAAe,EAAE,EAC1B,KAAK,GAAE,OAAe,GACrB,MAAM;IAkCT;;OAEG;IACH,gCAAgC,CAC9B,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,UAAU,EAAE,MAAM,GACjB,MAAM;IAaT;;OAEG;IACH,mBAAmB,IAAI,MAAM;IA8C7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAK9B;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAK/B;;OAEG;IACH,gBAAgB,IAAI,IAAI;CAIzB;AAQD,wBAAgB,aAAa,IAAI,UAAU,CAK1C"}

package/dist/ux-enhancer.js

@@ -0,0 +1,218 @@
+/**
+ * UX Enhancer
+ * 用户体验增强 - 缓存状态展示、用户确认、错误反馈
+ */
+import { getCacheStore } from "./cache-store.js";
+// ============================================================================
+// UX Enhancer 类
+// ============================================================================
+/**
+ * 用户体验增强器
+ */
+export class UXEnhancer {
+    cacheStore = getCacheStore();
+    /**
+     * 展示缓存状态
+     */
+    showCacheStatus(entry, match) {
+        const stats = this.cacheStore.getStats();
+        let message = `
+【缓存命中信息】
+
+`;
+        message += `场景：${entry.scenario}\n`;
+        message += `描述：${entry.description}\n`;
+        message += `缓存层级：${entry.cacheLevel}\n`;
+        message += `URL：${entry.url}\n`;
+        if (match) {
+            message += `匹配置信度：${match.confidence}%\n`;
+            message += `匹配方式：${match.method}\n`;
+        }
+        message += `访问次数：${entry.accessCount}\n`;
+        message += `成功率：${this.calculateSuccessRate(entry)}%\n`;
+        message += `平均执行时间：${entry.avgExecutionTime}ms\n`;
+        message += `创建时间：${new Date(entry.createdAt).toLocaleString()}\n`;
+        message += `\n【缓存统计】\n`;
+        message += `总条目：${stats.totalEntries}\n`;
+        message += `总命中：${stats.totalHits}\n`;
+        message += `命中率：${stats.hitRate.toFixed(1)}%\n`;
+        message += `节省 Token：${stats.savedTokens}\n`;
+        message += `节省时间：${(stats.savedTime / 1000).toFixed(1)}s\n`;
+        message += `\n【操作序列】\n`;
+        message += this.formatActionsBrief(entry.actions);
+        return message;
+    }
+    /**
+     * 格式化操作列表（简要版）
+     */
+    formatActionsBrief(actions) {
+        return actions
+            .map((action, i) => {
+            switch (action.type) {
+                case "navigate":
+                    return `  ${i + 1}. 导航到 ${action.url}`;
+                case "click":
+                    return `  ${i + 1}. 点击 ${action.ref}`;
+                case "type":
+                    return `  ${i + 1}. 输入 ${action.ref}`;
+                case "press":
+                    return `  ${i + 1}. 按键 ${action.key}`;
+                default:
+                    return `  ${i + 1}. ${action.type}`;
+            }
+        })
+            .join("\n");
+    }
+    /**
+     * 生成缓存使用确认提示
+     */
+    generateCacheConfirmationPrompt(entry) {
+        return `
+检测到缓存的操作序列（${entry.cacheLevel} 级）：
+
+场景：${entry.scenario}
+操作数：${entry.actions.length}
+命中率：${this.cacheStore.getStats().hitRate.toFixed(1)}%
+
+是否使用缓存的操作序列？（这将跳过 LLM 分析，大幅降低 token 消耗）
+`;
+    }
+    /**
+     * 生成试运行结果
+     */
+    generateDryRunResult(actions) {
+        return `
+【试运行模式】将执行 ${actions.length} 个操作：
+
+${this.formatActionsBrief(actions)}
+
+实际执行时不会执行这些操作。
+`;
+    }
+    /**
+     * 生成执行结果报告
+     */
+    generateExecutionReport(results, force = false) {
+        const successCount = results.filter((r) => r.success).length;
+        const failCount = results.length - successCount;
+        const totalTime = results.reduce((sum, r) => sum + r.duration, 0);
+        let message = "\n【执行完成】\n";
+        message += `成功：${successCount}/${results.length} 个操作\n`;
+        message += `失败：${failCount} 个操作\n`;
+        message += `总耗时：${totalTime}ms\n`;
+        message += `平均耗时：${(totalTime / results.length).toFixed(0)}ms\n`;
+        if (failCount > 0) {
+            message += `\n【失败的操作】\n`;
+            results
+                .filter((r) => !r.success)
+                .forEach((r, i) => {
+                message += `${i + 1}. ${r.action}: ${r.error}\n`;
+            });
+        }
+        message += "\n【详细结果】\n";
+        results.forEach((r, i) => {
+            const icon = r.success ? "✅" : "❌";
+            const time = r.duration ? `(${r.duration}ms)` : "";
+            message += `${icon} 操作 ${i + 1}: ${r.action} ${time}\n`;
+        });
+        if (force) {
+            message += "\n⚠️  注意：这是强制执行模式，可能执行了过期的缓存操作。\n";
+        }
+        return message;
+    }
+    /**
+     * 生成缓存失效通知
+     */
+    generateInvalidationNotification(changeType, confidence) {
+        const typeText = changeType === "structure" ? "结构变化" : "内容变化";
+        return `
+【缓存已失效】
+
+检测到页面${typeText}（置信度：${confidence}%）
+缓存已自动失效，下次操作将重新分析页面。
+
+如需立即执行，可使用强制刷新选项。
+`;
+    }
+    /**
+     * 生成统计报告
+     */
+    generateStatsReport() {
+        const stats = this.cacheStore.getStats();
+        const entries = this.cacheStore.listEntries();
+        let message = "\n【缓存统计报告】\n\n";
+        message += "=== 基本统计 ===\n";
+        message += `总条目数：${stats.totalEntries}\n`;
+        message += `总命中：${stats.totalHits}\n`;
+        message += `总未命中：${stats.totalMisses}\n`;
+        message += `命中率：${stats.hitRate.toFixed(1)}%\n\n`;
+        message += "=== 分层统计 ===\n";
+        message += `L3（场景级）命中：${stats.l3Hits}\n`;
+        message += `L2（流程级）命中：${stats.l2Hits}\n`;
+        message += `L1（原子级）命中：${stats.l1Hits}\n\n`;
+        message += "=== 效果统计 ===\n";
+        message += `节省 Token：${stats.savedTokens}\n`;
+        message += `节省时间：${(stats.savedTime / 1000).toFixed(1)}s\n`;
+        message += `平均执行时间：${stats.avgExecutionTime}ms\n\n`;
+        message += "=== 场景识别 ===\n";
+        message += `场景匹配次数：${stats.scenarioMatches}\n`;
+        message += `LLM 分类次数：${stats.llmClassifications}\n`;
+        message += `历史学习次数：${stats.learnedAssociations}\n\n`;
+        message += "=== 用户反馈 ===\n";
+        message += `用户确认次数：${stats.userConfirmations}\n`;
+        message += `用户强制刷新次数：${stats.userForcedRefreshes}\n`;
+        message += `缓存执行错误：${stats.cacheErrors}\n\n`;
+        if (entries.length > 0) {
+            message += "=== 热门场景 ===\n";
+            message += this.cacheStore.getTopScenarios(5) + "\n\n";
+            message += "=== 最近访问 ===\n";
+            const recent = entries.slice(0, 10);
+            recent.forEach((entry, i) => {
+                message += `${i + 1}. ${entry.scenario} (${entry.cacheLevel}) - ${new Date(entry.lastAccessTime).toLocaleString()}\n`;
+            });
+        }
+        return message;
+    }
+    /**
+     * 计算成功率
+     */
+    calculateSuccessRate(entry) {
+        const total = entry.successCount + entry.failCount;
+        return total > 0 ? (entry.successCount / total) * 100 : 100;
+    }
+    // -------------------------------------------------------------------------
+    // 用户反馈记录
+    // -------------------------------------------------------------------------
+    /**
+     * 记录用户确认
+     */
+    recordUserConfirmation() {
+        const stats = this.cacheStore.getStats();
+        stats.userConfirmations++;
+    }
+    /**
+     * 记录用户强制刷新
+     */
+    recordUserForcedRefresh() {
+        const stats = this.cacheStore.getStats();
+        stats.userForcedRefreshes++;
+    }
+    /**
+     * 记录缓存错误
+     */
+    recordCacheError() {
+        const stats = this.cacheStore.getStats();
+        stats.cacheErrors++;
+    }
+}
+// ============================================================================
+// 单例
+// ============================================================================
+let uxEnhancerInstance = null;
+export function getUXEnhancer() {
+    if (!uxEnhancerInstance) {
+        uxEnhancerInstance = new UXEnhancer();
+    }
+    return uxEnhancerInstance;
+}
+//# sourceMappingURL=ux-enhancer.js.map

package/dist/ux-enhancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ux-enhancer.js","sourceRoot":"","sources":["../src/ux-enhancer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,UAAU;IACb,UAAU,GAAG,aAAa,EAAE,CAAC;IAErC;;OAEG;IACH,eAAe,CAAC,KAA2B,EAAE,KAG5C;QACC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAEzC,IAAI,OAAO,GAAG;;;CAGjB,CAAC;QACE,OAAO,IAAI,MAAM,KAAK,CAAC,QAAQ,IAAI,CAAC;QACpC,OAAO,IAAI,MAAM,KAAK,CAAC,WAAW,IAAI,CAAC;QACvC,OAAO,IAAI,QAAQ,KAAK,CAAC,UAAU,IAAI,CAAC;QACxC,OAAO,IAAI,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC;QAEhC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,SAAS,KAAK,CAAC,UAAU,KAAK,CAAC;YAC1C,OAAO,IAAI,QAAQ,KAAK,CAAC,MAAM,IAAI,CAAC;QACtC,CAAC;QAED,OAAO,IAAI,QAAQ,KAAK,CAAC,WAAW,IAAI,CAAC;QACzC,OAAO,IAAI,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC;QACxD,OAAO,IAAI,UAAU,KAAK,CAAC,gBAAgB,MAAM,CAAC;QAClD,OAAO,IAAI,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC;QAElE,OAAO,IAAI,YAAY,CAAC;QACxB,OAAO,IAAI,OAAO,KAAK,CAAC,YAAY,IAAI,CAAC;QACzC,OAAO,IAAI,OAAO,KAAK,CAAC,SAAS,IAAI,CAAC;QACtC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAChD,OAAO,IAAI,YAAY,KAAK,CAAC,WAAW,IAAI,CAAC;QAC7C,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAE5D,OAAO,IAAI,YAAY,CAAC;QACxB,OAAO,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAElD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,OAAc;QACvC,OAAO,OAAO;aACX,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACjB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,UAAU;oBACb,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,CAAC;gBACzC,KAAK,OAAO;oBACV,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,GAAG,EAAE,CAAC;gBACxC,KAAK,MAAM;oBACT,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,GAAG,EAAE,CAAC;gBACxC,KAAK,OAAO;oBACV,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,GAAG,EAAE,CAAC;gBACxC;oBACE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YACxC,CAAC;QACH,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,+BAA+B,CAAC,KAA2B;QACzD,OAAO;aACE,KAAK,CAAC,UAAU;;KAExB,KAAK,CAAC,QAAQ;MACb,KAAK,CAAC,OAAO,CAAC,MAAM;MACpB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;;;CAGlD,CAAC;IACA,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,OAAc;QACjC,OAAO;aACE,OAAO,CAAC,MAAM;;EAEzB,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;;;CAGjC,CAAC;IACA,CAAC;IAED;;OAEG;IACH,uBAAuB,CACrB,OAA0B,EAC1B,QAAiB,KAAK;QAEtB,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC;QAChD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAElE,IAAI,OAAO,GAAG,YAAY,CAAC;QAC3B,OAAO,IAAI,MAAM,YAAY,IAAI,OAAO,CAAC,MAAM,QAAQ,CAAC;QACxD,OAAO,IAAI,MAAM,SAAS,QAAQ,CAAC;QACnC,OAAO,IAAI,OAAO,SAAS,MAAM,CAAC;QAClC,OAAO,IAAI,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAEjE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,aAAa,CAAC;YACzB,OAAO;iBACJ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;iBACzB,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAChB,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;YACnD,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,IAAI,YAAY,CAAC;QACxB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,IAAI,IAAI,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,mCAAmC,CAAC;QACjD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,gCAAgC,CAC9B,UAAmC,EACnC,UAAkB;QAElB,MAAM,QAAQ,GAAG,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAE9D,OAAO;;;OAGJ,QAAQ,QAAQ,UAAU;;;;CAIhC,CAAC;IACA,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,OAAO,GAAG,gBAAgB,CAAC;QAE/B,OAAO,IAAI,gBAAgB,CAAC;QAC5B,OAAO,IAAI,QAAQ,KAAK,CAAC,YAAY,IAAI,CAAC;QAC1C,OAAO,IAAI,OAAO,KAAK,CAAC,SAAS,IAAI,CAAC;QACtC,OAAO,IAAI,QAAQ,KAAK,CAAC,WAAW,IAAI,CAAC;QACzC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAElD,OAAO,IAAI,gBAAgB,CAAC;QAC5B,OAAO,IAAI,aAAa,KAAK,CAAC,MAAM,IAAI,CAAC;QACzC,OAAO,IAAI,aAAa,KAAK,CAAC,MAAM,IAAI,CAAC;QACzC,OAAO,IAAI,aAAa,KAAK,CAAC,MAAM,MAAM,CAAC;QAE3C,OAAO,IAAI,gBAAgB,CAAC;QAC5B,OAAO,IAAI,YAAY,KAAK,CAAC,WAAW,IAAI,CAAC;QAC7C,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,OAAO,IAAI,UAAU,KAAK,CAAC,gBAAgB,QAAQ,CAAC;QAEpD,OAAO,IAAI,gBAAgB,CAAC;QAC5B,OAAO,IAAI,UAAU,KAAK,CAAC,eAAe,IAAI,CAAC;QAC/C,OAAO,IAAI,YAAY,KAAK,CAAC,kBAAkB,IAAI,CAAC;QACpD,OAAO,IAAI,UAAU,KAAK,CAAC,mBAAmB,MAAM,CAAC;QAErD,OAAO,IAAI,gBAAgB,CAAC;QAC5B,OAAO,IAAI,UAAU,KAAK,CAAC,iBAAiB,IAAI,CAAC;QACjD,OAAO,IAAI,YAAY,KAAK,CAAC,mBAAmB,IAAI,CAAC;QACrD,OAAO,IAAI,UAAU,KAAK,CAAC,WAAW,MAAM,CAAC;QAE7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,gBAAgB,CAAC;YAC5B,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;YAEvD,OAAO,IAAI,gBAAgB,CAAC;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBAC1B,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,UAAU,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC;YACxH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,KAA2B;QACtD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC;QACnD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9D,CAAC;IAED,4EAA4E;IAC5E,SAAS;IACT,4EAA4E;IAE5E;;OAEG;IACH,sBAAsB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzC,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzC,KAAK,CAAC,mBAAmB,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzC,KAAK,CAAC,WAAW,EAAE,CAAC;IACtB,CAAC;CACF;AAED,+EAA+E;AAC/E,KAAK;AACL,+EAA+E;AAE/E,IAAI,kBAAkB,GAAsB,IAAI,CAAC;AAEjD,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,IAAI,UAAU,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/variable-resolver.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Variable Resolver
+ * 变量解析器 - 从用户输入提取变量
+ */
+import type { VariableMap } from "./types.js";
+/**
+ * 变量解析器
+ */
+export declare class VariableResolver {
+    /**
+     * 从用户输入提取变量
+     */
+    resolveVariables(userInput: string, scenario: string): VariableMap;
+    /**
+     * 根据场景获取对应的解析器
+     */
+    private getResolver;
+    /**
+     * 验证变量
+     */
+    validateVariables(variables: VariableMap, scenario: string): boolean;
+    /**
+     * 合并变量（后覆盖前）
+     */
+    mergeVariables(base: VariableMap, override: VariableMap): VariableMap;
+}
+export declare function getVariableResolver(): VariableResolver;
+//# sourceMappingURL=variable-resolver.d.ts.map

package/dist/variable-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-resolver.d.ts","sourceRoot":"","sources":["../src/variable-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4K9C;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW;IAKlE;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWpE;;OAEG;IACH,cAAc,CACZ,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,WAAW,GACpB,WAAW;CAWf;AAQD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}