assistsx-js 0.2.1 → 0.2.3

package/dist/index.d.mts

@@ -1,1954 +1,818 @@
+import { N as Node, a as NodeLookupScope, B as Bounds } from './step-DnFA4DEb.mjs';
+export { b as NODE_LOOKUP_SCOPE_ACTIVE_WINDOW, c as NODE_LOOKUP_SCOPE_ALL_WINDOWS, d as NodeAsync, S as Step, e as StepAsync, f as StepData, g as StepError, h as StepImpl, i as StepInterceptor, j as StepResult, k as StepStopError } from './step-DnFA4DEb.mjs';
 import * as pinia from 'pinia';
 
-declare class Bounds {
-    readonly left: number;
-    readonly top: number;
-    readonly right: number;
-    readonly bottom: number;
-    readonly width: number;
-    readonly height: number;
-    readonly centerX: number;
-    readonly centerY: number;
-    readonly exactCenterX: number;
-    readonly exactCenterY: number;
-    readonly isEmpty: boolean;
-    constructor(left: number, top: number, right: number, bottom: number, width: number, height: number, centerX: number, centerY: number, exactCenterX: number, exactCenterY: number, isEmpty: boolean);
-    /**
-     * 判断该 Bounds 是否在屏幕内（满足基本几何有效性）
-     * @returns {boolean}
-     */
-    isInScreen(): boolean;
-    static from(data: {
-        left: number;
-        top: number;
-        right: number;
-        bottom: number;
-        width: number;
-        height: number;
-        centerX: number;
-        centerY: number;
-        exactCenterX: number;
-        exactCenterY: number;
-        isEmpty: boolean;
-    }): Bounds;
-    static fromJSON(json: string): Bounds;
-    static fromData(data: any): Bounds;
-    toJSON(): {
-        left: number;
-        top: number;
-        right: number;
-        bottom: number;
-        width: number;
-        height: number;
-        centerX: number;
-        centerY: number;
-        exactCenterX: number;
-        exactCenterY: number;
-        isEmpty: boolean;
-    };
-    clone(): Bounds;
+declare class CallResponse {
+    readonly code: number;
+    readonly data: any | null;
+    readonly callbackId: string | null;
+    constructor(code: number, data: any | null, callbackId: string | null);
+    isSuccess(): boolean;
+    getData(): any | null;
+    getDataOrNull(): any | null;
+    getDataOrDefault(defaultValue: any): any;
 }
 
 /**
- * 节点类
- * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
+ * AccessibilityEvent过滤配置接口
+ * 用于配置AccessibilityEvent的处理方式和过滤条件
  */
-
-declare class NodeAsync {
-    private node;
+interface AccessibilityEventFilterConfig {
     /**
-     * 构造函数
-     * @param node Node实例
+     * 包名过滤
+     * 如果为空或null，则处理所有包的事件
+     * 如果指定包名，则只处理该包的事件
      */
-    constructor(node: Node);
+    packageName?: string | null;
     /**
-     * 查找第一个匹配标签的父节点
-     * @param className 类名
-     * @returns 父节点
+     * 是否在子线程中处理AccessibilityEvent
+     * true: 在子线程中处理，避免阻塞主线程
+     * false: 在主线程中处理
      */
-    findFirstParentByTags(className: string): Promise<Node>;
+    processInBackground?: boolean;
     /**
-     * 对节点执行点击手势
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @returns 是否点击成功
+     * 是否获取节点信息
+     * true: 获取并解析AccessibilityNodeInfo节点信息
+     * false: 不获取节点信息，提高处理性能
      */
-    clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, }?: {
-        offsetX?: number;
-        offsetY?: number;
-        switchWindowIntervalDelay?: number;
-        clickDuration?: number;
-    }): Promise<boolean>;
+    fetchNodeInfo?: boolean;
     /**
-     * 对节点执行双击手势
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param clickInterval 点击间隔
-     * @returns 是否双击成功
+     * 是否启用日志输出
+     * true: 输出AccessibilityEvent处理日志
+     * false: 不输出日志
      */
-    doubleClickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, }?: {
-        offsetX?: number;
-        offsetY?: number;
-        switchWindowIntervalDelay?: number;
-        clickDuration?: number;
-        clickInterval?: number;
-    }): Promise<boolean>;
-    longPressNodeByGestureAutoPaste(text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
-        matchedPackageName?: string;
-        matchedText?: string;
-        timeoutMillis?: number;
-        longPressDuration?: number;
-    }): Promise<boolean>;
+    enableLogging?: boolean;
     /**
-     * 在当前节点范围内通过标签查找节点
-     * @param className 类名
-     * @param filterText 文本过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
+     * 事件类型过滤
+     * 如果为空，则处理所有类型的事件
+     * 如果指定类型，则只处理指定类型的事件
      */
-    findByTags(className: string, { filterText, filterViewId, filterDes, }?: {
-        filterText?: string;
-        filterViewId?: string;
-        filterDes?: string;
-    }): Promise<Node[]>;
+    eventTypes?: number[] | null;
     /**
-     * 在当前节点范围内通过ID查找节点
-     * @param id 节点ID
-     * @param filterClass 类名过滤
-     * @param filterText 文本过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
+     * 是否启用事件去重
+     * true: 启用去重，避免重复处理相同事件
+     * false: 不启用去重
      */
-    findById(id: string, { filterClass, filterText, filterDes, }?: {
-        filterClass?: string;
-        filterText?: string;
-        filterDes?: string;
-    }): Promise<Node[]>;
+    enableDeduplication?: boolean;
+}
+/**
+ * AccessibilityEvent过滤配置类
+ * 用于配置AccessibilityEvent的处理方式和过滤条件
+ */
+declare class AccessibilityEventFilter {
     /**
-     * 在当前节点范围内通过文本查找节点
-     * @param text 要查找的文本
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
+     * 包名过滤
      */
-    findByText(text: string, { filterClass, filterViewId, filterDes, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-    }): Promise<Node[]>;
+    readonly packageName: string | null;
     /**
-     * 向前滚动节点
-     * @returns 是否滚动成功
+     * 是否在子线程中处理AccessibilityEvent
      */
-    scrollForward(): Promise<boolean>;
+    readonly processInBackground: boolean;
     /**
-     * 向后滚动节点
-     * @returns 是否滚动成功
+     * 是否获取节点信息
      */
-    scrollBackward(): Promise<boolean>;
+    readonly fetchNodeInfo: boolean;
     /**
-     * 检查节点是否可见
-     * @param compareNode 比较节点
-     * @param isFullyByCompareNode 是否完全可见
-     * @returns 是否可见
+     * 是否启用日志输出
      */
-    isVisible({ compareNode, isFullyByCompareNode, }?: {
-        compareNode?: Node;
-        isFullyByCompareNode?: boolean;
-    }): Promise<boolean>;
+    readonly enableLogging: boolean;
     /**
-     * 对节点进行截图
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @returns 截图路径
+     * 事件类型过滤
      */
-    takeScreenshot(overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
+    readonly eventTypes?: number[] | null;
     /**
-     * 设置节点文本
-     * @param text 要设置的文本
-     * @returns 是否设置成功
+     * 是否启用事件去重
      */
-    setNodeText(text: string): Promise<boolean>;
-    paste(text: string): Promise<boolean>;
-    focus(): Promise<boolean>;
+    readonly enableDeduplication: boolean;
+    constructor(config?: AccessibilityEventFilterConfig);
     /**
-     * 点击节点
-     * @returns 是否点击成功
+     * 检查是否应该处理指定包的事件
+     * @param targetPackageName 目标包名
+     * @returns true表示应该处理，false表示应该过滤
      */
-    click(): Promise<boolean>;
+    shouldProcessPackage(targetPackageName: string | null): boolean;
     /**
-     * 长按节点
-     * @returns 是否长按成功
+     * 检查是否应该处理指定类型的事件
+     * @param eventType 事件类型
+     * @returns true表示应该处理，false表示应该过滤
      */
-    longClick(): Promise<boolean>;
+    shouldProcessEventType(eventType: number): boolean;
     /**
-     * 查找第一个可点击的父节点
-     * @returns 可点击的父节点
+     * 创建默认的过滤配置
+     * 所有包名，子线程处理，获取节点信息，启用日志
      */
-    findFirstParentClickable(): Promise<Node>;
+    static createDefault(): AccessibilityEventFilter;
     /**
-     * 获取节点在屏幕中的边界
-     * @returns 边界对象
+     * 创建高性能配置
+     * 不获取节点信息，不启用日志，启用去重
      */
-    getBoundsInScreen(): Promise<Bounds>;
+    static createHighPerformance(): AccessibilityEventFilter;
     /**
-     * 获取节点的所有子节点
-     * @returns 子节点数组
+     * 创建调试配置
+     * 启用所有功能，便于调试
      */
-    getNodes(): Promise<Node[]>;
+    static createDebug(): AccessibilityEventFilter;
     /**
-     * 获取节点的直接子节点
-     * @returns 子节点数组
-     */
-    getChildren(): Promise<Node[]>;
-    /**
-     * 从JSON字符串创建节点实例
-     * @param json JSON字符串
-     * @returns 节点实例
-     */
-    static fromJSON(json: string): Node;
-    /**
-     * 从普通对象创建节点实例
-     * @param data 对象数据
-     * @returns 节点实例
-     */
-    static from(data: any): Node;
-    /**
-     * JSON.parse的reviver函数，用于将解析的JSON对象转换为Node实例
-     * @param key 属性键
-     * @param value 属性值
-     * @returns 转换后的值
-     */
-    static reviver(key: string, value: any): any;
-    /**
-     * 创建新的节点实例
-     * @param params 节点参数对象
-     * @returns 节点实例
-     */
-    static create(params: {
-        nodeId: string;
-        text: string;
-        des: string;
-        viewId: string;
-        className: string;
-        isScrollable: boolean;
-        isClickable: boolean;
-        isEnabled: boolean;
-        stepId: string | undefined;
-        hintText: string;
-        isCheckable: boolean;
-        isChecked: boolean;
-        isFocusable: boolean;
-        isFocused: boolean;
-        isLongClickable: boolean;
-        isPassword: boolean;
-        isSelected: boolean;
-        isVisibleToUser: boolean;
-        drawingOrder: number;
-        bounds?: Bounds;
-        /** @deprecated 请使用 bounds 替代 */
-        boundsInScreen?: Bounds;
-    }): Node;
-    /**
-     * 从JSON数组创建节点数组
-     * @param array JSON数组
-     * @returns 节点数组
+     * 创建指定包名的过滤配置
+     * @param targetPackageName 目标包名
      */
-    static fromJSONArray(array: Array<any>): Node[];
+    static createForPackage(targetPackageName: string): AccessibilityEventFilter;
 }
 
 /**
- * 节点类
- * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
+ * 应用信息实体类
  */
-
-declare class Node {
-    /**
-     * 节点唯一标识
-     */
-    nodeId: string;
+declare class AppInfo {
     /**
-     * 节点文本内容
+     * 是否为系统应用
      */
-    text: string;
+    isSystem: boolean;
     /**
-     * 节点描述信息
+     * 最低SDK版本
      */
-    des: string;
+    minSdkVersion: number;
     /**
-     * 节点视图ID
+     * 应用名称
      */
-    viewId: string;
+    name: string;
     /**
-     * 节点类名
+     * 应用包名
      */
-    className: string;
+    packageName: string;
     /**
-     * 是否可滚动
+     * 目标SDK版本
      */
-    isScrollable: boolean;
+    targetSdkVersion: number;
     /**
-     * 是否可点击
+     * 版本号
      */
-    isClickable: boolean;
+    versionCode: number;
     /**
-     * 是否启用
+     * 版本名称
      */
-    isEnabled: boolean;
+    versionName: string;
+    constructor(isSystem?: boolean, minSdkVersion?: number, name?: string, packageName?: string, targetSdkVersion?: number, versionCode?: number, versionName?: string);
     /**
-     * 所属步骤ID
+     * 从JSON对象创建AppInfo实例
+     * @param data JSON对象
+     * @returns AppInfo实例
      */
-    stepId: string | undefined;
+    static fromJSON(data: any): AppInfo;
     /**
-     * 提示文本
+     * 转换为JSON对象
+     * @returns JSON对象
      */
-    hintText: string;
+    toJSON(): any;
+}
+
+/**
+ * 设备信息实体类
+ */
+declare class DeviceInfo {
     /**
-     * 是否可选择
+     * 设备唯一标识
      */
-    isCheckable: boolean;
+    uniqueDeviceId: string;
     /**
-     * 是否已选中
+     * Android ID
      */
-    isChecked: boolean;
+    androidID: string;
     /**
-     * 是否可聚焦
+     * MAC地址
      */
-    isFocusable: boolean;
+    macAddress: string;
     /**
-     * 是否已聚焦
+     * 是否已Root
      */
-    isFocused: boolean;
+    isDeviceRooted: boolean;
     /**
-     * 是否可长按
+     * 制造商
      */
-    isLongClickable: boolean;
+    manufacturer: string;
     /**
-     * 是否为密码字段
+     * 设备型号
      */
-    isPassword: boolean;
+    model: string;
     /**
-     * 是否已选中
+     * SDK版本号
      */
-    isSelected: boolean;
+    sdkVersionCode: number;
     /**
-     * 是否对用户可见
+     * SDK版本名称
      */
-    isVisibleToUser: boolean;
+    sdkVersionName: string;
     /**
-     * 绘制顺序
+     * ABI列表
      */
-    drawingOrder: number;
+    abiList: string[];
     /**
-     * 节点在屏幕中的边界
+     * 是否启用ADB调试
      */
-    bounds: Bounds;
+    isAdbEnabled: boolean;
     /**
-     * 节点在屏幕中的边界
-     * @deprecated 请使用 bounds 字段替代
+     * 是否启用开发者选项
      */
-    get boundsInScreen(): Bounds;
+    isDevelopmentSettingsEnabled: boolean;
     /**
-     * 构造函数
-     * @param params 节点参数对象
+     * 是否为模拟器
      */
-    constructor(params: {
-        nodeId: string;
-        text: string;
-        des: string;
-        viewId: string;
-        className: string;
-        isScrollable: boolean;
-        isClickable: boolean;
-        isEnabled: boolean;
-        stepId: string | undefined;
-        hintText: string;
-        isCheckable: boolean;
-        isChecked: boolean;
-        isFocusable: boolean;
-        isFocused: boolean;
-        isLongClickable: boolean;
-        isPassword: boolean;
-        isSelected: boolean;
-        isVisibleToUser: boolean;
-        drawingOrder: number;
-        /** @deprecated 请使用 bounds 替代 */
-        boundsInScreen?: Bounds | any;
-        bounds?: Bounds | any;
-    });
-    get async(): NodeAsync;
+    isEmulator: boolean;
     /**
-     * 查找第一个匹配标签的父节点
-     * @param className 类名
-     * @returns 父节点
+     * 是否为平板
      */
-    findFirstParentByTags(className: string): Node;
+    isTablet: boolean;
+    constructor(uniqueDeviceId?: string, androidID?: string, macAddress?: string, isDeviceRooted?: boolean, manufacturer?: string, model?: string, sdkVersionCode?: number, sdkVersionName?: string, abiList?: string[], isAdbEnabled?: boolean, isDevelopmentSettingsEnabled?: boolean, isEmulator?: boolean, isTablet?: boolean);
     /**
-     * 对节点执行点击手势
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @returns 是否点击成功
+     * 从JSON对象创建DeviceInfo实例
+     * @param data JSON对象
+     * @returns DeviceInfo实例
      */
-    clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, }?: {
-        offsetX?: number;
-        offsetY?: number;
-        switchWindowIntervalDelay?: number;
-        clickDuration?: number;
-    }): Promise<boolean>;
+    static fromJSON(data: any): DeviceInfo;
     /**
-     * 对节点执行双击手势
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param clickInterval 点击间隔
-     * @returns 是否双击成功
+     * 转换为JSON对象
+     * @returns JSON对象
      */
-    doubleClickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, }?: {
-        offsetX?: number;
-        offsetY?: number;
-        switchWindowIntervalDelay?: number;
-        clickDuration?: number;
-        clickInterval?: number;
-    }): Promise<boolean>;
-    longPressNodeByGestureAutoPaste(text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
-        matchedPackageName?: string;
-        matchedText?: string;
-        timeoutMillis?: number;
-        longPressDuration?: number;
-    }): Promise<boolean>;
-    /**
-     * 在当前节点范围内通过标签查找节点
-     * @param className 类名
-     * @param filterText 文本过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
-     */
-    findByTags(className: string, { filterText, filterViewId, filterDes, }?: {
-        filterText?: string;
-        filterViewId?: string;
-        filterDes?: string;
-    }): Node[];
-    /**
-     * 在当前节点范围内通过ID查找节点
-     * @param id 节点ID
-     * @param filterClass 类名过滤
-     * @param filterText 文本过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
-     */
-    findById(id: string, { filterClass, filterText, filterDes, }?: {
-        filterClass?: string;
-        filterText?: string;
-        filterDes?: string;
-    }): Node[];
-    /**
-     * 在当前节点范围内通过文本查找节点
-     * @param text 要查找的文本
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
-     */
-    findByText(text: string, { filterClass, filterViewId, filterDes, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-    }): Node[];
-    /**
-     * 向前滚动节点
-     * @returns 是否滚动成功
-     */
-    scrollForward(): boolean;
-    /**
-     * 向后滚动节点
-     * @returns 是否滚动成功
-     */
-    scrollBackward(): boolean;
-    /**
-     * 检查节点是否可见
-     * @param compareNode 比较节点
-     * @param isFullyByCompareNode 是否完全可见
-     * @returns 是否可见
-     */
-    isVisible({ compareNode, isFullyByCompareNode, }?: {
-        compareNode?: Node;
-        isFullyByCompareNode?: boolean;
-    }): boolean;
-    /**
-     * 对节点进行截图
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @returns 截图路径
-     */
-    takeScreenshot(overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
-    /**
-     * 保存节点截图到文件
-     * @param options 截图保存选项
-     * @param options.filePath 文件路径（可选，不提供则自动生成）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
-     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
-     * @returns 保存的文件路径
-     */
-    takeScreenshotToFile(options?: {
-        filePath?: string;
-        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
-        overlayHiddenScreenshotDelayMillis?: number;
-    }): Promise<string>;
-    /**
-     * 设置节点文本
-     * @param text 要设置的文本
-     * @returns 是否设置成功
-     */
-    setNodeText(text: string): boolean;
-    paste(text: string): boolean;
-    focus(): boolean;
-    /**
-     * 点击节点
-     * @returns 是否点击成功
-     */
-    click(): boolean;
-    /**
-     * 长按节点
-     * @returns 是否长按成功
-     */
-    longClick(): boolean;
-    /**
-     * 查找第一个可点击的父节点
-     * @returns 可点击的父节点
-     */
-    findFirstParentClickable(): Node;
-    /**
-     * 获取节点在屏幕中的边界
-     * @returns 边界对象
-     */
-    getBoundsInScreen(): Bounds;
-    /**
-     * 获取节点的所有子节点
-     * @returns 子节点数组
-     */
-    getNodes(): Node[];
-    /**
-     * 获取节点的直接子节点
-     * @returns 子节点数组
-     */
-    getChildren(): Node[];
-    /**
-     * 从JSON字符串创建节点实例
-     * @param json JSON字符串
-     * @returns 节点实例
-     */
-    static fromJSON(json: string): Node;
-    /**
-     * 从普通对象创建节点实例
-     * @param data 对象数据
-     * @returns 节点实例
-     */
-    static from(data: any): Node;
-    /**
-     * JSON.parse的reviver函数，用于将解析的JSON对象转换为Node实例
-     * @param key 属性键
-     * @param value 属性值
-     * @returns 转换后的值
-     */
-    static reviver(key: string, value: any): any;
-    /**
-     * 创建新的节点实例
-     * @param params 节点参数对象
-     * @returns 节点实例
-     */
-    static create(params: {
-        nodeId: string;
-        text: string;
-        des: string;
-        viewId: string;
-        className: string;
-        isScrollable: boolean;
-        isClickable: boolean;
-        isEnabled: boolean;
-        stepId: string | undefined;
-        hintText: string;
-        isCheckable: boolean;
-        isChecked: boolean;
-        isFocusable: boolean;
-        isFocused: boolean;
-        isLongClickable: boolean;
-        isPassword: boolean;
-        isSelected: boolean;
-        isVisibleToUser: boolean;
-        drawingOrder: number;
-        bounds?: Bounds;
-        /** @deprecated 请使用 bounds 替代 */
-        boundsInScreen?: Bounds;
-    }): Node;
-    /**
-     * 从JSON数组创建节点数组
-     * @param array JSON数组
-     * @returns 节点数组
-     */
-    static fromJSONArray(array: Array<any>): Node[];
+    toJSON(): any;
 }
 
-declare class CallResponse {
-    readonly code: number;
-    readonly data: any | null;
-    readonly callbackId: string | null;
-    constructor(code: number, data: any | null, callbackId: string | null);
-    isSuccess(): boolean;
-    getData(): any | null;
-    getDataOrNull(): any | null;
-    getDataOrDefault(defaultValue: any): any;
-}
+/**
+ * AssistsX 类
+ * 提供与移动应用程序界面交互的工具类，包括节点查找、手势操作、屏幕操作等功能
+ */
 
 /**
- * AccessibilityEvent过滤配置接口
- * 用于配置AccessibilityEvent的处理方式和过滤条件
+ * 无障碍事件数据结构
  */
-interface AccessibilityEventFilterConfig {
+interface AccessibilityEventData {
+    packageName: string;
+    className: string;
+    eventType: number;
+    action: number;
+    texts: string[];
+    node: Node | null;
+}
+/**
+ * 无障碍事件完整结构
+ */
+interface AccessibilityEvent {
+    callbackId: string;
+    code: number;
+    data: AccessibilityEventData;
+    message: string;
+}
+/**
+ * 无障碍事件监听器类型
+ */
+type AccessibilityEventListener = (event: AccessibilityEvent) => void;
+/**
+ * Web浮动窗口选项接口定义
+ */
+interface WebFloatingWindowOptions {
+    initialWidth?: number;
+    initialHeight?: number;
+    /** Initial window X position (default 0) */
+    initialX?: number;
+    /** Initial window Y position (default 0) */
+    initialY?: number;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    initialCenter?: boolean;
+    /** Whether to show top operation area (title bar, close button, etc.) */
+    showTopOperationArea?: boolean;
+    /** Whether to show bottom operation area (zoom, back/forward/refresh, etc.) */
+    showBottomOperationArea?: boolean;
+    /** Background color: hex string (e.g. "#ffffff") or Android color int */
+    backgroundColor?: string | number;
+}
+declare const callbacks: Map<string, (data: string) => void>;
+declare const accessibilityEventListeners: AccessibilityEventListener[];
+/**
+ * 屏幕尺寸类型（width/height 为整型像素值）
+ */
+interface Screen {
+    width: number;
+    height: number;
+}
+/** 全局屏幕尺寸，在 assistsxCallback 初始化后自动加载 */
+declare let screen: Screen;
+declare class AssistsX {
     /**
-     * 包名过滤
-     * 如果为空或null，则处理所有包的事件
-     * 如果指定包名，则只处理该包的事件
+     * 屏幕尺寸（与全局变量 screen 同源）
+     * @deprecated 已过时，请使用全局变量 {@link screen}
      */
-    packageName?: string | null;
+    static get screenSize(): any;
     /**
-     * 是否在子线程中处理AccessibilityEvent
-     * true: 在子线程中处理，避免阻塞主线程
-     * false: 在主线程中处理
+     * 执行同步调用
+     * @param method 方法名
+     * @param args 参数对象
+     * @returns 调用响应
      */
-    processInBackground?: boolean;
+    static call(method: string, { args, node }?: {
+        args?: any;
+        node?: Node;
+    }): CallResponse;
     /**
-     * 是否获取节点信息
-     * true: 获取并解析AccessibilityNodeInfo节点信息
-     * false: 不获取节点信息，提高处理性能
+     * 执行异步调用
+     * @param method 方法名
+     * @param args 参数对象
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns Promise<调用响应>
      */
-    fetchNodeInfo?: boolean;
+    static asyncCall(method: string, { args, node, nodes, timeout, }?: {
+        args?: any;
+        node?: Node;
+        nodes?: Node[];
+        timeout?: number;
+    }): Promise<CallResponse>;
     /**
-     * 是否启用日志输出
-     * true: 输出AccessibilityEvent处理日志
-     * false: 不输出日志
+     * 设置悬浮窗标志
+     * @param flags 标志
+     * @returns 是否设置成功
      */
-    enableLogging?: boolean;
+    static setOverlayFlags(flags: number): boolean;
     /**
-     * 事件类型过滤
-     * 如果为空，则处理所有类型的事件
-     * 如果指定类型，则只处理指定类型的事件
+     * 设置悬浮窗标志
+     * @param flags 标志
+     * @returns 是否设置成功
      */
-    eventTypes?: number[] | null;
+    static setOverlayFlagList(flags: number[]): boolean;
     /**
-     * 是否启用事件去重
-     * true: 启用去重，避免重复处理相同事件
-     * false: 不启用去重
+     * 获取所有符合条件的节点
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param filterText 文本过滤
+     * @returns 节点数组
      */
-    enableDeduplication?: boolean;
-}
-/**
- * AccessibilityEvent过滤配置类
- * 用于配置AccessibilityEvent的处理方式和过滤条件
- */
-declare class AccessibilityEventFilter {
+    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        filterText?: string;
+        scope?: NodeLookupScope;
+    }): Node[];
     /**
-     * 包名过滤
+     * 设置节点文本
+     * @param node 目标节点
+     * @param text 要设置的文本
+     * @returns 是否设置成功
      */
-    readonly packageName: string | null;
+    static setNodeText(node: Node, text: string): boolean;
     /**
-     * 是否在子线程中处理AccessibilityEvent
+     * 获取剪贴板最新文本
+     * @returns 剪贴板最新文本
      */
-    readonly processInBackground: boolean;
+    static getClipboardLatestText(): any;
     /**
-     * 是否获取节点信息
+     * 获取剪贴板文本内容（异步）
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 剪贴板文本内容，如果获取失败则返回空字符串
      */
-    readonly fetchNodeInfo: boolean;
+    static getClipboardText(timeout?: number): Promise<string>;
     /**
-     * 是否启用日志输出
-     */
-    readonly enableLogging: boolean;
-    /**
-     * 事件类型过滤
-     */
-    readonly eventTypes?: number[] | null;
-    /**
-     * 是否启用事件去重
-     */
-    readonly enableDeduplication: boolean;
-    constructor(config?: AccessibilityEventFilterConfig);
-    /**
-     * 检查是否应该处理指定包的事件
-     * @param targetPackageName 目标包名
-     * @returns true表示应该处理，false表示应该过滤
-     */
-    shouldProcessPackage(targetPackageName: string | null): boolean;
-    /**
-     * 检查是否应该处理指定类型的事件
-     * @param eventType 事件类型
-     * @returns true表示应该处理，false表示应该过滤
-     */
-    shouldProcessEventType(eventType: number): boolean;
-    /**
-     * 创建默认的过滤配置
-     * 所有包名，子线程处理，获取节点信息，启用日志
-     */
-    static createDefault(): AccessibilityEventFilter;
-    /**
-     * 创建高性能配置
-     * 不获取节点信息，不启用日志，启用去重
-     */
-    static createHighPerformance(): AccessibilityEventFilter;
-    /**
-     * 创建调试配置
-     * 启用所有功能，便于调试
-     */
-    static createDebug(): AccessibilityEventFilter;
-    /**
-     * 创建指定包名的过滤配置
-     * @param targetPackageName 目标包名
-     */
-    static createForPackage(targetPackageName: string): AccessibilityEventFilter;
-}
-
-/**
- * 应用信息实体类
- */
-declare class AppInfo {
-    /**
-     * 是否为系统应用
-     */
-    isSystem: boolean;
-    /**
-     * 最低SDK版本
-     */
-    minSdkVersion: number;
-    /**
-     * 应用名称
-     */
-    name: string;
-    /**
-     * 应用包名
-     */
-    packageName: string;
-    /**
-     * 目标SDK版本
-     */
-    targetSdkVersion: number;
-    /**
-     * 版本号
-     */
-    versionCode: number;
-    /**
-     * 版本名称
-     */
-    versionName: string;
-    constructor(isSystem?: boolean, minSdkVersion?: number, name?: string, packageName?: string, targetSdkVersion?: number, versionCode?: number, versionName?: string);
-    /**
-     * 从JSON对象创建AppInfo实例
-     * @param data JSON对象
-     * @returns AppInfo实例
-     */
-    static fromJSON(data: any): AppInfo;
-    /**
-     * 转换为JSON对象
-     * @returns JSON对象
-     */
-    toJSON(): any;
-}
-
-/**
- * 设备信息实体类
- */
-declare class DeviceInfo {
-    /**
-     * 设备唯一标识
-     */
-    uniqueDeviceId: string;
-    /**
-     * Android ID
-     */
-    androidID: string;
-    /**
-     * MAC地址
-     */
-    macAddress: string;
-    /**
-     * 是否已Root
-     */
-    isDeviceRooted: boolean;
-    /**
-     * 制造商
-     */
-    manufacturer: string;
-    /**
-     * 设备型号
-     */
-    model: string;
-    /**
-     * SDK版本号
-     */
-    sdkVersionCode: number;
-    /**
-     * SDK版本名称
-     */
-    sdkVersionName: string;
-    /**
-     * ABI列表
-     */
-    abiList: string[];
-    /**
-     * 是否启用ADB调试
-     */
-    isAdbEnabled: boolean;
-    /**
-     * 是否启用开发者选项
-     */
-    isDevelopmentSettingsEnabled: boolean;
-    /**
-     * 是否为模拟器
-     */
-    isEmulator: boolean;
-    /**
-     * 是否为平板
-     */
-    isTablet: boolean;
-    constructor(uniqueDeviceId?: string, androidID?: string, macAddress?: string, isDeviceRooted?: boolean, manufacturer?: string, model?: string, sdkVersionCode?: number, sdkVersionName?: string, abiList?: string[], isAdbEnabled?: boolean, isDevelopmentSettingsEnabled?: boolean, isEmulator?: boolean, isTablet?: boolean);
-    /**
-     * 从JSON对象创建DeviceInfo实例
-     * @param data JSON对象
-     * @returns DeviceInfo实例
-     */
-    static fromJSON(data: any): DeviceInfo;
-    /**
-     * 转换为JSON对象
-     * @returns JSON对象
-     */
-    toJSON(): any;
-}
-
-/**
- * AssistsX 类
- * 提供与移动应用程序界面交互的工具类，包括节点查找、手势操作、屏幕操作等功能
- */
-
-/**
- * 无障碍事件数据结构
- */
-interface AccessibilityEventData {
-    packageName: string;
-    className: string;
-    eventType: number;
-    action: number;
-    texts: string[];
-    node: Node | null;
-}
-/**
- * 无障碍事件完整结构
- */
-interface AccessibilityEvent {
-    callbackId: string;
-    code: number;
-    data: AccessibilityEventData;
-    message: string;
-}
-/**
- * 无障碍事件监听器类型
- */
-type AccessibilityEventListener = (event: AccessibilityEvent) => void;
-/**
- * Web浮动窗口选项接口定义
- */
-interface WebFloatingWindowOptions {
-    initialWidth?: number;
-    initialHeight?: number;
-    /** Initial window X position (default 0) */
-    initialX?: number;
-    /** Initial window Y position (default 0) */
-    initialY?: number;
-    minWidth?: number;
-    minHeight?: number;
-    maxWidth?: number;
-    maxHeight?: number;
-    initialCenter?: boolean;
-    /** Whether to show top operation area (title bar, close button, etc.) */
-    showTopOperationArea?: boolean;
-    /** Whether to show bottom operation area (zoom, back/forward/refresh, etc.) */
-    showBottomOperationArea?: boolean;
-    /** Background color: hex string (e.g. "#ffffff") or Android color int */
-    backgroundColor?: string | number;
-}
-declare const callbacks: Map<string, (data: string) => void>;
-declare const accessibilityEventListeners: AccessibilityEventListener[];
-/**
- * 屏幕尺寸类型（width/height 为整型像素值）
- */
-interface Screen {
-    width: number;
-    height: number;
-}
-/** 全局屏幕尺寸，在 assistsxCallback 初始化后自动加载 */
-declare let screen: Screen | null;
-declare class AssistsX {
-    /**
-     * 屏幕尺寸（与全局变量 screen 同源）
-     * @deprecated 已过时，请使用全局变量 {@link screen}
-     */
-    static get screenSize(): any;
-    /**
-     * 执行同步调用
-     * @param method 方法名
-     * @param args 参数对象
-     * @returns 调用响应
-     */
-    static call(method: string, { args, node }?: {
-        args?: any;
-        node?: Node;
-    }): CallResponse;
-    /**
-     * 执行异步调用
-     * @param method 方法名
-     * @param args 参数对象
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<调用响应>
-     */
-    static asyncCall(method: string, { args, node, nodes, timeout, }?: {
-        args?: any;
-        node?: Node;
-        nodes?: Node[];
-        timeout?: number;
-    }): Promise<CallResponse>;
-    /**
-     * 设置悬浮窗标志
-     * @param flags 标志
-     * @returns 是否设置成功
-     */
-    static setOverlayFlags(flags: number): boolean;
-    /**
-     * 设置悬浮窗标志
-     * @param flags 标志
-     * @returns 是否设置成功
-     */
-    static setOverlayFlagList(flags: number[]): boolean;
-    /**
-     * 获取所有符合条件的节点
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param filterText 文本过滤
-     * @returns 节点数组
-     */
-    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        filterText?: string;
-    }): Node[];
-    /**
-     * 设置节点文本
-     * @param node 目标节点
-     * @param text 要设置的文本
-     * @returns 是否设置成功
-     */
-    static setNodeText(node: Node, text: string): boolean;
-    /**
-     * 获取剪贴板最新文本
-     * @returns 剪贴板最新文本
-     */
-    static getClipboardLatestText(): any;
-    /**
-     * 获取剪贴板文本内容（异步）
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 剪贴板文本内容，如果获取失败则返回空字符串
-     */
-    static getClipboardText(timeout?: number): Promise<string>;
-    /**
-     * 在浏览器中打开URL
-     * @param url 要打开的URL
-     * @returns 是否成功打开
-     */
-    static openUrlInBrowser(url: string): boolean;
-    /**
-     * 保持屏幕常亮
-     * @param tip 提示文本
-     * @returns 是否保持屏幕常亮成功
-     */
-    static keepScreenOn(tip?: string): boolean;
-    static clearKeepScreenOn(): boolean;
-    static isAppInstalled(packageName: string): boolean;
-    /**
-     * 对指定节点进行截图
-     * @param nodes 要截图的节点数组
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 截图路径数组
-     */
-    static takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number, timeout?: number): Promise<string[]>;
-    static scanQR(timeout?: number): Promise<string>;
-    static loadWebViewOverlay(url: string, options?: WebFloatingWindowOptions & {
-        timeout?: number;
-    }): Promise<any>;
-    /**
-     * 点击节点
-     * @param node 要点击的节点
-     * @returns 是否点击成功
-     */
-    static click(node: Node): boolean;
-    /**
-     * 长按节点
-     * @param node 要长按的节点
-     * @returns 是否长按成功
-     */
-    static longClick(node: Node): boolean;
-    /**
-     * 启动应用
-     * @param packageName 应用包名
-     * @returns 是否启动成功
-     */
-    static launchApp(packageName: string): boolean;
-    /**
-     * 获取当前应用包名
-     * @returns 包名
-     */
-    static getPackageName(): string;
-    /**
-     * 显示悬浮提示
-     * @param text 提示文本
-     * @param delay 显示时长(毫秒)
-     * @returns 是否显示成功
-     */
-    static overlayToast(text: string, delay?: number): boolean;
-    /**
-     * 通过ID查找节点
-     * @param id 节点ID
-     * @param filterClass 类名过滤
-     * @param filterText 文本过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @returns 节点数组
-     */
-    static findById(id: string, { filterClass, filterText, filterDes, node, }?: {
-        filterClass?: string;
-        filterText?: string;
-        filterDes?: string;
-        node?: Node;
-    }): Node[];
-    /**
-     * 通过文本查找节点
-     * @param text 要查找的文本
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @returns 节点数组
-     */
-    static findByText(text: string, { filterClass, filterViewId, filterDes, node, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        node?: Node;
-    }): Node[];
-    /**
-     * 通过标签查找节点
-     * @param className 类名
-     * @param filterText 文本过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param node 父节点范围
-     * @returns 节点数组
-     */
-    static findByTags(className: string, { filterText, filterViewId, filterDes, node, }?: {
-        filterText?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        node?: Node;
-    }): Node[];
-    /**
-     * 查找所有匹配文本的节点
-     * @param text 要查找的文本
-     * @returns 节点数组
-     */
-    static findByTextAllMatch(text: string): Node[];
-    /**
-     * 检查是否包含指定文本
-     * @param text 要检查的文本
-     * @returns 是否包含
-     */
-    static containsText(text: string): boolean;
-    /**
-     * 获取所有文本
-     * @returns 文本数组
-     */
-    static getAllText(): string[];
-    /**
-     * 查找第一个匹配标签的父节点
-     * @param className 类名
-     * @returns 父节点
-     */
-    static findFirstParentByTags(node: Node, className: string): Node;
-    /**
-     * 获取节点的所有子节点
-     * @param node 父节点
-     * @returns 子节点数组
-     */
-    static getNodes(node: Node): Node[];
-    /**
-     * 获取节点的直接子节点
-     * @param node 父节点
-     * @returns 子节点数组
-     */
-    static getChildren(node: Node): Node[];
-    /**
-     * 查找第一个可点击的父节点
-     * @param node 起始节点
-     * @returns 可点击的父节点
-     */
-    static findFirstParentClickable(node: Node): Node;
-    /**
-     * 获取节点在屏幕中的边界
-     * @param node 目标节点
-     * @returns 边界对象
-     */
-    static getBoundsInScreen(node: Node): Bounds;
-    /**
-     * 检查节点是否可见
-     * @param node 目标节点
-     * @param compareNode 比较节点
-     * @param isFullyByCompareNode 是否完全可见
-     * @returns 是否可见
-     */
-    static isVisible(node: Node, { compareNode, isFullyByCompareNode, }?: {
-        compareNode?: Node;
-        isFullyByCompareNode?: boolean;
-    }): boolean;
-    /**
-     * 执行点击手势
-     * @param x 横坐标
-     * @param y 纵坐标
-     * @param duration 持续时间
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static clickByGesture(x: number, y: number, duration: number, timeout?: number): Promise<boolean>;
-    /**
-     * 返回操作
-     * @returns 是否成功
-     */
-    static back(): boolean;
-    /**
-     * 回到主页
-     * @returns 是否成功
-     */
-    static home(): boolean;
-    /**
-     * 打开通知栏
-     * @returns 是否成功
-     */
-    static notifications(): boolean;
-    /**
-     * 显示最近应用
-     * @returns 是否成功
-     */
-    static recentApps(): boolean;
-    /**
-     * 在节点中粘贴文本
-     * @param node 目标节点
-     * @param text 要粘贴的文本
-     * @returns 是否成功
-     */
-    static paste(node: Node, text: string): boolean;
-    static focus(node: Node): boolean;
-    /**
-     * 选择文本
-     * @param node 目标节点
-     * @param selectionStart 选择起始位置
-     * @param selectionEnd 选择结束位置
-     * @returns 是否成功
-     */
-    static selectionText(node: Node, selectionStart: number, selectionEnd: number): boolean;
-    /**
-     * 向前滚动
-     * @param node 可滚动节点
-     * @returns 是否成功
-     */
-    static scrollForward(node: Node): boolean;
-    /**
-     * 向后滚动
-     * @param node 可滚动节点
-     * @returns 是否成功
-     */
-    static scrollBackward(node: Node): boolean;
-    /**
-     * 对节点执行点击手势
-     * @param node 目标节点
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static clickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, timeout, }?: {
-        offsetX?: number;
-        offsetY?: number;
-        switchWindowIntervalDelay?: number;
-        clickDuration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * 对节点执行双击手势
-     * @param node 目标节点
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param clickInterval 点击间隔
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 是否成功
-     */
-    static doubleClickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, timeout, }?: {
-        offsetX?: number;
-        offsetY?: number;
-        switchWindowIntervalDelay?: number;
-        clickDuration?: number;
-        clickInterval?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    /**
-     * 执行线型手势
-     * @param startPoint
-     * @param endPoint
-     * @param param2
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns
-     */
-    static performLinearGesture(startPoint: {
-        x: number;
-        y: number;
-    }, endPoint: {
-        x: number;
-        y: number;
-    }, { duration, timeout }?: {
-        duration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    static longPressNodeByGestureAutoPaste(node: Node, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, }?: {
-        matchedPackageName?: string;
-        matchedText?: string;
-        timeoutMillis?: number;
-        longPressDuration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    static longPressGestureAutoPaste(point: {
-        x: number;
-        y: number;
-    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, }?: {
-        matchedPackageName?: string;
-        matchedText?: string;
-        timeoutMillis?: number;
-        longPressDuration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    static getAppInfo(packageName: string, timeout?: number): Promise<AppInfo>;
-    static getUniqueDeviceId(): any;
-    static getAndroidID(): any;
-    static getMacAddress(timeout?: number): Promise<any>;
-    static getDeviceInfo(timeout?: number): Promise<DeviceInfo>;
-    static getNetworkType(timeout?: number): Promise<any>;
-    /**
-     * 播放系统电话铃声
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 播放结果消息
-     */
-    static audioPlayRingtone(timeout?: number): Promise<string>;
-    /**
-     * 停止播放系统电话铃声
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 停止结果消息
-     */
-    static audioStopRingtone(timeout?: number): Promise<string>;
-    static setAccessibilityEventFilters(value: AccessibilityEventFilter[]): Promise<any>;
-    static addAccessibilityEventFilter(value: AccessibilityEventFilter): Promise<any>;
-    /**
-     * 获取屏幕尺寸
-     * @returns 屏幕尺寸对象（width, height）
-     */
-    static getScreenSize(): Screen | null;
-    /**
-     * 获取应用窗口尺寸
-     * @returns 应用窗口尺寸对象
-     */
-    static getAppScreenSize(): any;
-    /**
-     * 添加无障碍事件监听器
-     * @param listener 监听器函数
-     */
-    static addAccessibilityEventListener(listener: AccessibilityEventListener): void;
-    /**
-     * 判断是否包含无障碍事件监听器
-     * @param listener 监听器函数
-     * @returns 是否包含
-     */
-    static containsAccessibilityEventListener(listener: AccessibilityEventListener): boolean;
-    /**
-     * 移除无障碍事件监听器
-     * @param listener 要移除的监听器函数
-     * @returns 是否移除成功
-     */
-    static removeAccessibilityEventListener(listener: AccessibilityEventListener): boolean;
-    /**
-     * 移除所有无障碍事件监听器
-     */
-    static removeAllAccessibilityEventListeners(): void;
-    /**
-     * 获取当前注册的无障碍事件监听器数量
-     * @returns 监听器数量
-     */
-    static getAccessibilityEventListenerCount(): number;
-}
-
-declare const CallMethod: {
-    readonly takeScreenshot: "takeScreenshot";
-    readonly takeScreenshotSave: "takeScreenshotSave";
-    readonly takeScreenshotToFile: "takeScreenshotToFile";
-    readonly overlayToast: "overlayToast";
-    readonly setNodeText: "setNodeText";
-    readonly findByTags: "findByTags";
-    readonly findById: "findById";
-    readonly findByText: "findByText";
-    readonly findByTextAllMatch: "findByTextAllMatch";
-    readonly containsText: "containsText";
-    readonly getAllText: "getAllText";
-    readonly findFirstParentByTags: "findFirstParentByTags";
-    readonly getAllNodes: "getAllNodes";
-    readonly getNodes: "getNodes";
-    readonly findFirstParentClickable: "findFirstParentClickable";
-    readonly getChildren: "getChildren";
-    readonly getBoundsInScreen: "getBoundsInScreen";
-    readonly isVisible: "isVisible";
-    readonly click: "click";
-    readonly longClick: "longClick";
-    readonly back: "back";
-    readonly home: "home";
-    readonly notifications: "notifications";
-    readonly recentApps: "recentApps";
-    readonly paste: "paste";
-    readonly focus: "focus";
-    readonly selectionText: "selectionText";
-    readonly scrollForward: "scrollForward";
-    readonly launchApp: "launchApp";
-    readonly getPackageName: "getPackageName";
-    readonly getScreenSize: "getScreenSize";
-    readonly getAppScreenSize: "getAppScreenSize";
-    readonly scrollBackward: "scrollBackward";
-    readonly setOverlayFlags: "setOverlayFlags";
-    readonly scanQR: "scanQR";
-    readonly loadWebViewOverlay: "loadWebViewOverlay";
-    readonly closeOverlay: "closeOverlay";
-    readonly recognizeTextInScreenshot: "recognizeTextInScreenshot";
-    readonly clickByGesture: "clickByGesture";
-    readonly clickNodeByGesture: "clickNodeByGesture";
-    readonly doubleClickNodeByGesture: "doubleClickNodeByGesture";
-    readonly performLinearGesture: "performLinearGesture";
-    readonly longPressGestureAutoPaste: "longPressGestureAutoPaste";
-    readonly getAppInfo: "getAppInfo";
-    readonly getMacAddress: "getMacAddress";
-    readonly getAndroidID: "getAndroidID";
-    readonly getUniqueDeviceId: "getUniqueDeviceId";
-    readonly addAccessibilityEventFilter: "addAccessibilityEventFilter";
-    readonly setAccessibilityEventFilters: "setAccessibilityEventFilters";
-    readonly httpRequest: "httpRequest";
-    readonly getDeviceInfo: "getDeviceInfo";
-    readonly getNetworkType: "getNetworkType";
-    readonly isAppInstalled: "isAppInstalled";
-    readonly getClipboardLatestText: "getClipboardLatestText";
-    readonly getClipboardText: "getClipboardText";
-    readonly openUrlInBrowser: "openUrlInBrowser";
-    readonly keepScreenOn: "keepScreenOn";
-    readonly clearKeepScreenOn: "clearKeepScreenOn";
-    readonly download: "download";
-    readonly audioPlayFromFile: "audioPlayFromFile";
-    readonly audioStop: "audioStop";
-    readonly audioPlayRingtone: "audioPlayRingtone";
-    readonly audioStopRingtone: "audioStopRingtone";
-    readonly addContact: "addContact";
-    readonly getAllContacts: "getAllContacts";
-    readonly saveRootNodeTreeJson: "saveRootNodeTreeJson";
-};
-type CallMethodType = (typeof CallMethod)[keyof typeof CallMethod];
-
-/**
- * Android 视图类型常量
- */
-declare const NodeClassValue: {
-    readonly ImageView: "android.widget.ImageView";
-    readonly TextView: "android.widget.TextView";
-    readonly LinearLayout: "android.widget.LinearLayout";
-    readonly RelativeLayout: "android.widget.RelativeLayout";
-    readonly Button: "android.widget.Button";
-    readonly ImageButton: "android.widget.ImageButton";
-    readonly EditText: "android.widget.EditText";
-    readonly View: "android.view.View";
-    readonly ViewGroup: "android.view.ViewGroup";
-    readonly FrameLayout: "android.widget.FrameLayout";
-};
-
-declare function sleep(ms: number): Promise<void>;
-declare function generateUUID(): string;
-declare function decodeBase64UTF8(base64: string): string;
-
-/**
- * 步骤执行错误类
- * 用于携带步骤执行过程中的错误信息和当前步骤对象
- * 支持传入可选数据：message，data任何类型的数据
- */
-declare class StepError extends Error {
-    /**
-     * 步骤实现函数名
-     */
-    readonly impl?: string;
-    /**
-     * 步骤标签
-     */
-    readonly tag?: string | undefined;
-    /**
-     * 步骤数据，可以是任何类型
-     */
-    readonly data?: any;
-    /**
-     * 原始错误
-     */
-    readonly originalError?: any;
-    /**
-     * 当前步骤对象
-     */
-    readonly currentStep?: any;
-    constructor(message?: string, data?: any, impl?: string, tag?: string | undefined, originalError?: any, currentStep?: any | undefined);
-}
-/**
- * 主动停止异常类
- * 用于表示步骤被主动停止执行
- */
-declare class StepStopError extends StepError {
-    constructor(message?: string, data?: any);
-}
-
-declare class StepAsync {
-    private step;
-    /**
-     * 构造函数
-     * @param step Step实例
+     * 在浏览器中打开URL
+     * @param url 要打开的URL
+     * @returns 是否成功打开
      */
-    constructor(step: Step);
+    static openUrlInBrowser(url: string): boolean;
     /**
-     * 对单个节点进行截图
-     * @param node 目标节点
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @returns 截图路径
+     * 保持屏幕常亮
+     * @param tip 提示文本
+     * @returns 是否保持屏幕常亮成功
      */
-    takeScreenshotByNode(node: Node, overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
+    static keepScreenOn(tip?: string): boolean;
+    static clearKeepScreenOn(): boolean;
+    static isAppInstalled(packageName: string): boolean;
     /**
-     * 对多个节点进行截图
-     * @param nodes 目标节点数组
+     * 对指定节点进行截图
+     * @param nodes 要截图的节点数组
      * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @param timeout 超时时间(秒)，默认30秒
      * @returns 截图路径数组
      */
-    takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number): Promise<string[]>;
+    static takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number, timeout?: number): Promise<string[]>;
+    static scanQR(timeout?: number): Promise<string>;
+    static loadWebViewOverlay(url: string, options?: WebFloatingWindowOptions & {
+        timeout?: number;
+    }): Promise<any>;
     /**
-     * 获取所有符合条件的节点
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param filterText 文本过滤
-     * @returns 节点数组
+     * 点击节点
+     * @param node 要点击的节点
+     * @returns 是否点击成功
      */
-    getAllNodes({ filterClass, filterViewId, filterDes, filterText, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        filterText?: string;
-    }): Promise<Node[]>;
+    static click(node: Node): boolean;
+    /**
+     * 长按节点
+     * @param node 要长按的节点
+     * @returns 是否长按成功
+     */
+    static longClick(node: Node): boolean;
     /**
      * 启动应用
      * @param packageName 应用包名
      * @returns 是否启动成功
      */
-    launchApp(packageName: string): Promise<boolean>;
+    static launchApp(packageName: string): boolean;
     /**
      * 获取当前应用包名
      * @returns 包名
      */
-    getPackageName(): Promise<string>;
+    static getPackageName(options?: {
+        scope?: NodeLookupScope;
+    }): string;
+    /**
+     * 显示悬浮提示
+     * @param text 提示文本
+     * @param delay 显示时长(毫秒)
+     * @returns 是否显示成功
+     */
+    static overlayToast(text: string, delay?: number): boolean;
     /**
      * 通过ID查找节点
      * @param id 节点ID
      * @param filterClass 类名过滤
      * @param filterText 文本过滤
      * @param filterDes 描述过滤
+     * @param node 父节点范围
      * @returns 节点数组
      */
-    findById(id: string, { filterClass, filterText, filterDes, }?: {
+    static findById(id: string, { filterClass, filterText, filterDes, node, scope, }?: {
         filterClass?: string;
         filterText?: string;
         filterDes?: string;
-    }): Promise<Node[]>;
+        node?: Node;
+        scope?: NodeLookupScope;
+    }): Node[];
     /**
      * 通过文本查找节点
      * @param text 要查找的文本
      * @param filterClass 类名过滤
      * @param filterViewId 视图ID过滤
      * @param filterDes 描述过滤
+     * @param node 父节点范围
      * @returns 节点数组
      */
-    findByText(text: string, { filterClass, filterViewId, filterDes, }?: {
+    static findByText(text: string, { filterClass, filterViewId, filterDes, node, scope, }?: {
         filterClass?: string;
         filterViewId?: string;
         filterDes?: string;
-    }): Promise<Node[]>;
+        node?: Node;
+        scope?: NodeLookupScope;
+    }): Node[];
     /**
      * 通过标签查找节点
      * @param className 类名
      * @param filterText 文本过滤
      * @param filterViewId 视图ID过滤
      * @param filterDes 描述过滤
+     * @param node 父节点范围
      * @returns 节点数组
      */
-    findByTags(className: string, { filterText, filterViewId, filterDes, }?: {
+    static findByTags(className: string, { filterText, filterViewId, filterDes, node, scope, }?: {
         filterText?: string;
         filterViewId?: string;
         filterDes?: string;
-    }): Promise<Node[]>;
+        node?: Node;
+        scope?: NodeLookupScope;
+    }): Node[];
     /**
      * 查找所有匹配文本的节点
      * @param text 要查找的文本
-     * @returns 节点数组
+     * @param options.scope 节点查找范围（可选）
      */
-    findByTextAllMatch(text: string): Promise<Node[]>;
+    static findByTextAllMatch(text: string, { scope }?: {
+        scope?: NodeLookupScope;
+    }): Node[];
     /**
      * 检查是否包含指定文本
      * @param text 要检查的文本
      * @returns 是否包含
      */
-    containsText(text: string): Promise<boolean>;
+    static containsText(text: string): boolean;
     /**
      * 获取所有文本
      * @returns 文本数组
      */
-    getAllText(): Promise<string[]>;
-    /**
-     * 执行点击手势
-     * @param x 横坐标
-     * @param y 纵坐标
-     * @param duration 持续时间(毫秒)
-     * @returns 是否成功
-     */
-    clickByGesture(x: number, y: number, duration: number): Promise<boolean>;
-    longPressGestureAutoPaste(point: {
-        x: number;
-        y: number;
-    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
-        matchedPackageName?: string;
-        matchedText?: string;
-        timeoutMillis?: number;
-        longPressDuration?: number;
-    }): Promise<boolean>;
-    getAppInfo(packageName: string): Promise<any>;
-    performLinearGesture(startPoint: {
-        x: number;
-        y: number;
-    }, endPoint: {
-        x: number;
-        y: number;
-    }, { duration }?: {
-        duration?: number;
-    }): Promise<boolean>;
-    /**
-     * 返回操作
-     * @returns 是否成功
-     */
-    back(): Promise<boolean>;
-    /**
-     * 回到主页
-     * @returns 是否成功
-     */
-    home(): Promise<boolean>;
-    /**
-     * 打开通知栏
-     * @returns 是否成功
-     */
-    notifications(): Promise<boolean>;
-    /**
-     * 显示最近应用
-     * @returns 是否成功
-     */
-    recentApps(): Promise<boolean>;
-    /**
-     * 获取屏幕尺寸
-     * @returns 屏幕尺寸对象
-     */
-    getScreenSize(): Promise<any>;
-    /**
-     * 获取应用窗口尺寸
-     * @returns 应用窗口尺寸对象
-     */
-    getAppScreenSize(): Promise<any>;
-}
-
-type StepResult = Step | undefined;
-type StepImpl = (step: Step) => Promise<StepResult>;
-type StepInterceptor = (step: Step) => StepResult | Promise<StepResult>;
-declare class Step {
-    static delayMsDefault: number;
-    static readonly repeatCountInfinite: number;
-    static repeatCountMaxDefault: number;
-    static showLog: boolean;
-    static exceptionRetryCountMaxDefault: number;
-    /**
-     * 当前执行步骤的ID
-     */
-    private static _stepId;
-    /**
-     * 步骤拦截器列表
-     */
-    private static _interceptors;
-    /**
-     * 步骤异常变量，默认为空
-     */
-    static exception: StepError | undefined;
-    /**
-     * 运行步骤实现
-     * @param impl 步骤实现函数
-     * @param tag 步骤标签
-     * @param data 步骤数据
-     * @param delayMs 步骤延迟时间(毫秒)
-     */
-    static run(impl: StepImpl, { stepId, tag, data, delayMs, exceptionRetryCountMax, }?: {
-        stepId?: string | undefined;
-        tag?: string | undefined;
-        data?: any | undefined;
-        delayMs?: number;
-        exceptionRetryCountMax?: number;
-    }): Promise<Step | undefined>;
-    /**
-     * 获取当前步骤ID
-     */
-    static get stepId(): string | undefined;
-    /**
-     * 验证步骤ID是否匹配，如果不匹配则表示停止
-     * @param stepId 要验证的步骤ID
-     */
-    static assert(stepId: string | undefined): void;
-    /**
-     * 为节点数组分配步骤ID
-     * @param nodes 节点数组
-     * @param stepId 步骤ID
-     */
-    static assignIdsToNodes(nodes: Node[], stepId: string | undefined): void;
-    /**
-     * 停止当前步骤执行
-     * @param exception 可选的异常对象，如果传入则使用该异常，否则使用默认的StepStopError
-     */
-    static stop(exception?: StepError): void;
-    /**
-     * 添加步骤拦截器
-     * @param interceptor 拦截器函数
-     */
-    static addInterceptor(interceptor: StepInterceptor): void;
-    /**
-     * 移除步骤拦截器
-     * @param interceptor 要移除的拦截器函数
-     * @returns 是否成功删除
-     */
-    static removeInterceptor(interceptor: StepInterceptor): boolean;
-    /**
-     * 按索引移除步骤拦截器
-     * @param index 要移除的拦截器索引
-     * @returns 是否成功删除
-     */
-    static removeInterceptorByIndex(index: number): boolean;
-    /**
-     * 移除所有匹配的步骤拦截器
-     * @param interceptor 要移除的拦截器函数
-     * @returns 删除的拦截器数量
-     */
-    static removeAllInterceptors(interceptor: StepInterceptor): number;
-    /**
-     * 按条件移除步骤拦截器
-     * @param predicate 判断是否删除的条件函数
-     * @returns 删除的拦截器数量
-     */
-    static removeInterceptorByPredicate(predicate: (interceptor: StepInterceptor, index: number) => boolean): number;
-    /**
-     * 清空所有拦截器
-     */
-    static clearInterceptors(): void;
-    /**
-     * 获取所有拦截器
-     * @returns 拦截器数组
-     */
-    static getInterceptors(): StepInterceptor[];
-    /**
-     * 步骤ID
-     */
-    stepId: string;
-    /**
-     * 步骤重复执行次数
-     */
-    repeatCount: number;
-    /**
-     * 步骤重复执行最大次数,默认15次
-     */
-    repeatCountMax: number;
-    /**
-     * 异常重试次数
-     */
-    exceptionRetryCount: number;
-    /**
-     * 异常重试最大次数,默认3次
-     */
-    exceptionRetryCountMax: number;
-    /**
-     * 步骤标签
-     */
-    tag: string | undefined;
-    isEnd: boolean;
-    /**
-     * 步骤数据
-     */
-    data: any | undefined;
-    /**
-     * 步骤延迟时间(毫秒)
-     */
-    delayMs: number;
-    /**
-     * 步骤实现函数
-     */
-    impl: StepImpl | undefined;
+    static getAllText(): string[];
     /**
-     * 构造函数
-     * @param stepId 步骤ID
-     * @param impl 步骤实现函数
-     * @param tag 步骤标签
-     * @param data 步骤数据
-     * @param delayMs 步骤延迟时间(毫秒)
+     * 查找第一个匹配标签的父节点
+     * @param className 类名
+     * @returns 父节点
      */
-    constructor({ stepId, impl, tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, isEnd, }: {
-        stepId: string;
-        impl: StepImpl | undefined;
-        tag?: string | undefined;
-        data?: any | undefined;
-        delayMs?: number;
-        repeatCountMax?: number;
-        exceptionRetryCountMax?: number;
-        isEnd?: boolean;
-    });
-    get async(): StepAsync;
+    static findFirstParentByTags(node: Node, className: string): Node;
     /**
-     * 创建下一个步骤
-     * @param impl 下一步骤实现函数
-     * @param tag 步骤标签
-     * @param data 步骤数据
-     * @param delayMs 步骤延迟时间(毫秒)
-     * @returns 新的步骤实例
+     * 获取节点的所有子节点
+     * @param node 父节点
+     * @returns 子节点数组
      */
-    next(impl: StepImpl, { tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
-        tag?: string | undefined;
-        data?: any | undefined;
-        delayMs?: number;
-        repeatCountMax?: number;
-        exceptionRetryCountMax?: number;
-    }): Step;
-    end({ tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
-        tag?: string | undefined;
-        data?: any | undefined;
-        delayMs?: number;
-        repeatCountMax?: number;
-        exceptionRetryCountMax?: number;
-    }): Step;
+    static getNodes(node: Node): Node[];
     /**
-     * 重复当前步骤
-     * @param stepId 步骤ID
-     * @param tag 步骤标签
-     * @param data 步骤数据
-     * @param delayMs 步骤延迟时间(毫秒)
-     * @returns 当前步骤实例
+     * 获取节点的直接子节点
+     * @param node 父节点
+     * @returns 子节点数组
      */
-    repeat({ stepId, tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
-        stepId?: string;
-        tag?: string | undefined;
-        data?: any | undefined;
-        delayMs?: number;
-        repeatCountMax?: number;
-        exceptionRetryCountMax?: number;
-    }): Step;
+    static getChildren(node: Node): Node[];
     /**
-     * 延迟执行
-     * @param ms 延迟时间(毫秒)
-     * @returns Promise
+     * 查找第一个可点击的父节点
+     * @param node 起始节点
+     * @returns 可点击的父节点
      */
-    delay(ms: number): Promise<void>;
+    static findFirstParentClickable(node: Node): Node;
     /**
-     * 等待异步方法执行完成
-     * @param method 异步方法
-     * @returns Promise<T>
+     * 获取节点在屏幕中的边界
+     * @param node 目标节点
+     * @returns 边界对象
      */
-    await<T>(method: () => Promise<T>): Promise<T>;
+    static getBoundsInScreen(node: Node): Bounds;
     /**
-     * 对单个节点进行截图
+     * 检查节点是否可见
      * @param node 目标节点
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @returns 截图路径
+     * @param compareNode 比较节点
+     * @param isFullyByCompareNode 是否完全可见
+     * @returns 是否可见
      */
-    takeScreenshotByNode(node: Node, overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
+    static isVisible(node: Node, { compareNode, isFullyByCompareNode, }?: {
+        compareNode?: Node;
+        isFullyByCompareNode?: boolean;
+    }): boolean;
     /**
-     * 对多个节点进行截图
-     * @param nodes 目标节点数组
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @returns 截图路径数组
+     * 执行点击手势
+     * @param x 横坐标
+     * @param y 纵坐标
+     * @param duration 持续时间
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 是否成功
      */
-    takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number): Promise<string[]>;
+    static clickByGesture(x: number, y: number, duration: number, timeout?: number): Promise<boolean>;
     /**
-     * 获取所有符合条件的节点
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param filterText 文本过滤
-     * @returns 节点数组
+     * 返回操作
+     * @returns 是否成功
      */
-    getAllNodes({ filterClass, filterViewId, filterDes, filterText, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        filterText?: string;
-    }): Node[];
+    static back(): boolean;
     /**
-     * 启动应用
-     * @param packageName 应用包名
-     * @returns 是否启动成功
+     * 回到主页
+     * @returns 是否成功
      */
-    launchApp(packageName: string): boolean;
+    static home(): boolean;
     /**
-     * 获取当前应用包名
-     * @returns 包名
+     * 打开通知栏
+     * @returns 是否成功
      */
-    getPackageName(): string;
+    static notifications(): boolean;
     /**
-     * 通过ID查找节点
-     * @param id 节点ID
-     * @param filterClass 类名过滤
-     * @param filterText 文本过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
+     * 显示最近应用
+     * @returns 是否成功
      */
-    findById(id: string, { filterClass, filterText, filterDes, }?: {
-        filterClass?: string;
-        filterText?: string;
-        filterDes?: string;
-    }): Node[];
+    static recentApps(): boolean;
     /**
-     * 通过文本查找节点
-     * @param text 要查找的文本
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
+     * 在节点中粘贴文本
+     * @param node 目标节点
+     * @param text 要粘贴的文本
+     * @returns 是否成功
      */
-    findByText(text: string, { filterClass, filterViewId, filterDes, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-    }): Node[];
-    /**
-     * 通过标签查找节点
-     * @param className 类名
-     * @param filterText 文本过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
+    static paste(node: Node, text: string): boolean;
+    static focus(node: Node): boolean;
+    /**
+     * 选择文本
+     * @param node 目标节点
+     * @param selectionStart 选择起始位置
+     * @param selectionEnd 选择结束位置
+     * @returns 是否成功
      */
-    findByTags(className: string, { filterText, filterViewId, filterDes, }?: {
-        filterText?: string;
-        filterViewId?: string;
-        filterDes?: string;
-    }): Node[];
+    static selectionText(node: Node, selectionStart: number, selectionEnd: number): boolean;
     /**
-     * 查找所有匹配文本的节点
-     * @param text 要查找的文本
-     * @returns 节点数组
+     * 向前滚动
+     * @param node 可滚动节点
+     * @returns 是否成功
      */
-    findByTextAllMatch(text: string): Node[];
+    static scrollForward(node: Node): boolean;
     /**
-     * 检查是否包含指定文本
-     * @param text 要检查的文本
-     * @returns 是否包含
+     * 向后滚动
+     * @param node 可滚动节点
+     * @returns 是否成功
      */
-    containsText(text: string): boolean;
+    static scrollBackward(node: Node): boolean;
     /**
-     * 获取所有文本
-     * @returns 文本数组
+     * 对节点执行点击手势
+     * @param node 目标节点
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 是否成功
      */
-    getAllText(): string[];
+    static clickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, timeout, }?: {
+        offsetX?: number;
+        offsetY?: number;
+        switchWindowIntervalDelay?: number;
+        clickDuration?: number;
+        timeout?: number;
+    }): Promise<boolean>;
     /**
-     * 执行点击手势
-     * @param x 横坐标
-     * @param y 纵坐标
-     * @param duration 持续时间(毫秒)
+     * 对节点执行双击手势
+     * @param node 目标节点
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @param clickInterval 点击间隔
+     * @param timeout 超时时间(秒)，默认30秒
      * @returns 是否成功
      */
-    clickByGesture(x: number, y: number, duration: number): Promise<boolean>;
-    longPressGestureAutoPaste(point: {
+    static doubleClickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, timeout, }?: {
+        offsetX?: number;
+        offsetY?: number;
+        switchWindowIntervalDelay?: number;
+        clickDuration?: number;
+        clickInterval?: number;
+        timeout?: number;
+    }): Promise<boolean>;
+    /**
+     * 执行线型手势
+     * @param startPoint
+     * @param endPoint
+     * @param param2
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns
+     */
+    static performLinearGesture(startPoint: {
+        x: number;
+        y: number;
+    }, endPoint: {
         x: number;
         y: number;
-    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
+    }, { duration, timeout }?: {
+        duration?: number;
+        timeout?: number;
+    }): Promise<boolean>;
+    static longPressNodeByGestureAutoPaste(node: Node, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, }?: {
         matchedPackageName?: string;
         matchedText?: string;
         timeoutMillis?: number;
         longPressDuration?: number;
+        timeout?: number;
     }): Promise<boolean>;
-    getAppInfo(packageName: string): Promise<any>;
-    performLinearGesture(startPoint: {
-        x: number;
-        y: number;
-    }, endPoint: {
+    static longPressGestureAutoPaste(point: {
         x: number;
         y: number;
-    }, { duration }?: {
-        duration?: number;
+    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, }?: {
+        matchedPackageName?: string;
+        matchedText?: string;
+        timeoutMillis?: number;
+        longPressDuration?: number;
+        timeout?: number;
     }): Promise<boolean>;
+    static getAppInfo(packageName: string, timeout?: number): Promise<AppInfo>;
+    static getUniqueDeviceId(): any;
+    static getAndroidID(): any;
+    static getMacAddress(timeout?: number): Promise<any>;
+    static getDeviceInfo(timeout?: number): Promise<DeviceInfo>;
+    static getNetworkType(timeout?: number): Promise<any>;
     /**
-     * 返回操作
-     * @returns 是否成功
+     * 播放系统电话铃声
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 播放结果消息
      */
-    back(): boolean;
+    static audioPlayRingtone(timeout?: number): Promise<string>;
     /**
-     * 回到主页
-     * @returns 是否成功
+     * 停止播放系统电话铃声
+     * @param timeout 超时时间(秒)，默认30秒
+     * @returns 停止结果消息
      */
-    home(): boolean;
+    static audioStopRingtone(timeout?: number): Promise<string>;
+    static setAccessibilityEventFilters(value: AccessibilityEventFilter[]): Promise<any>;
+    static addAccessibilityEventFilter(value: AccessibilityEventFilter): Promise<any>;
     /**
-     * 打开通知栏
-     * @returns 是否成功
+     * 获取屏幕尺寸
+     * @returns 屏幕尺寸对象（width, height）
      */
-    notifications(): boolean;
+    static getScreenSize(): Screen | null;
     /**
-     * 显示最近应用
-     * @returns 是否成功
+     * 获取应用窗口尺寸
+     * @returns 应用窗口尺寸对象
      */
-    recentApps(): boolean;
+    static getAppScreenSize(): any;
     /**
-     * 获取屏幕尺寸
-     * @returns 屏幕尺寸对象
+     * 添加无障碍事件监听器
+     * @param listener 监听器函数
      */
-    getScreenSize(): any;
+    static addAccessibilityEventListener(listener: AccessibilityEventListener): void;
     /**
-     * 获取应用窗口尺寸
-     * @returns 应用窗口尺寸对象
+     * 判断是否包含无障碍事件监听器
+     * @param listener 监听器函数
+     * @returns 是否包含
+     */
+    static containsAccessibilityEventListener(listener: AccessibilityEventListener): boolean;
+    /**
+     * 移除无障碍事件监听器
+     * @param listener 要移除的监听器函数
+     * @returns 是否移除成功
+     */
+    static removeAccessibilityEventListener(listener: AccessibilityEventListener): boolean;
+    /**
+     * 移除所有无障碍事件监听器
+     */
+    static removeAllAccessibilityEventListeners(): void;
+    /**
+     * 获取当前注册的无障碍事件监听器数量
+     * @returns 监听器数量
      */
-    getAppScreenSize(): any;
+    static getAccessibilityEventListenerCount(): number;
 }
 
+declare const CallMethod: {
+    readonly takeScreenshot: "takeScreenshot";
+    readonly takeScreenshotSave: "takeScreenshotSave";
+    readonly takeScreenshotToFile: "takeScreenshotToFile";
+    readonly overlayToast: "overlayToast";
+    readonly setNodeText: "setNodeText";
+    readonly findByTags: "findByTags";
+    readonly findById: "findById";
+    readonly findByText: "findByText";
+    readonly findByTextAllMatch: "findByTextAllMatch";
+    readonly containsText: "containsText";
+    readonly getAllText: "getAllText";
+    readonly findFirstParentByTags: "findFirstParentByTags";
+    readonly getAllNodes: "getAllNodes";
+    readonly getNodes: "getNodes";
+    readonly findFirstParentClickable: "findFirstParentClickable";
+    readonly getChildren: "getChildren";
+    readonly getBoundsInScreen: "getBoundsInScreen";
+    readonly isVisible: "isVisible";
+    readonly click: "click";
+    readonly longClick: "longClick";
+    readonly back: "back";
+    readonly home: "home";
+    readonly notifications: "notifications";
+    readonly recentApps: "recentApps";
+    readonly paste: "paste";
+    readonly focus: "focus";
+    readonly selectionText: "selectionText";
+    readonly scrollForward: "scrollForward";
+    readonly launchApp: "launchApp";
+    readonly getPackageName: "getPackageName";
+    readonly getScreenSize: "getScreenSize";
+    readonly getAppScreenSize: "getAppScreenSize";
+    readonly scrollBackward: "scrollBackward";
+    readonly setOverlayFlags: "setOverlayFlags";
+    readonly scanQR: "scanQR";
+    readonly loadWebViewOverlay: "loadWebViewOverlay";
+    readonly closeOverlay: "closeOverlay";
+    readonly recognizeTextInScreenshot: "recognizeTextInScreenshot";
+    readonly clickByGesture: "clickByGesture";
+    readonly clickNodeByGesture: "clickNodeByGesture";
+    readonly doubleClickNodeByGesture: "doubleClickNodeByGesture";
+    readonly performLinearGesture: "performLinearGesture";
+    readonly longPressGestureAutoPaste: "longPressGestureAutoPaste";
+    readonly getAppInfo: "getAppInfo";
+    readonly getMacAddress: "getMacAddress";
+    readonly getAndroidID: "getAndroidID";
+    readonly getUniqueDeviceId: "getUniqueDeviceId";
+    readonly addAccessibilityEventFilter: "addAccessibilityEventFilter";
+    readonly setAccessibilityEventFilters: "setAccessibilityEventFilters";
+    readonly httpRequest: "httpRequest";
+    readonly getDeviceInfo: "getDeviceInfo";
+    readonly getNetworkType: "getNetworkType";
+    readonly isAppInstalled: "isAppInstalled";
+    readonly getClipboardLatestText: "getClipboardLatestText";
+    readonly getClipboardText: "getClipboardText";
+    readonly openUrlInBrowser: "openUrlInBrowser";
+    readonly keepScreenOn: "keepScreenOn";
+    readonly clearKeepScreenOn: "clearKeepScreenOn";
+    readonly download: "download";
+    readonly audioPlayFromFile: "audioPlayFromFile";
+    readonly audioStop: "audioStop";
+    readonly audioPlayRingtone: "audioPlayRingtone";
+    readonly audioStopRingtone: "audioStopRingtone";
+    readonly addContact: "addContact";
+    readonly getAllContacts: "getAllContacts";
+    readonly saveRootNodeTreeJson: "saveRootNodeTreeJson";
+};
+type CallMethodType = (typeof CallMethod)[keyof typeof CallMethod];
+
+/**
+ * Android 视图类型常量
+ */
+declare const NodeClassValue: {
+    readonly ImageView: "android.widget.ImageView";
+    readonly TextView: "android.widget.TextView";
+    readonly LinearLayout: "android.widget.LinearLayout";
+    readonly RelativeLayout: "android.widget.RelativeLayout";
+    readonly Button: "android.widget.Button";
+    readonly ImageButton: "android.widget.ImageButton";
+    readonly EditText: "android.widget.EditText";
+    readonly View: "android.view.View";
+    readonly ViewGroup: "android.view.ViewGroup";
+    readonly FrameLayout: "android.widget.FrameLayout";
+};
+
+declare function sleep(ms: number): Promise<void>;
+declare function generateUUID(): string;
+declare function decodeBase64UTF8(base64: string): string;
+
 type StepStatus = 'idle' | 'running' | 'completed' | 'error';
 interface StepState {
     status: StepStatus;
@@ -1964,6 +828,8 @@ declare const useStepStore: pinia.StoreDefinition<"step", StepState, {}, {
     reset(): void;
 }>;
 
+declare function ensureAssistsXPinia(): void;
+
 /**
  * 窗口标志位常量类
  * 定义了各种窗口行为和属性的标志位
@@ -2118,12 +984,13 @@ declare class AssistsXAsync {
      * @param timeout 超时时间(秒)，默认30秒
      * @returns 节点数组
      */
-    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, timeout, }?: {
+    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, timeout, scope, }?: {
         filterClass?: string;
         filterViewId?: string;
         filterDes?: string;
         filterText?: string;
         timeout?: number;
+        scope?: NodeLookupScope;
     }): Promise<Node[]>;
     /**
      * 设置节点文本
@@ -2219,9 +1086,17 @@ declare class AssistsXAsync {
     /**
      * 获取当前应用包名
      * @param timeout 超时时间(秒)，默认30秒
-     * @returns 包名
      */
     static getPackageName(timeout?: number): Promise<string>;
+    /**
+     * 获取当前应用包名
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @param options.scope 节点查找范围（可选）
+     */
+    static getPackageName(options: {
+        timeout?: number;
+        scope?: NodeLookupScope;
+    }): Promise<string>;
     /**
      * 显示悬浮提示
      * @param text 提示文本
@@ -2240,12 +1115,13 @@ declare class AssistsXAsync {
      * @param timeout 超时时间(秒)，默认30秒
      * @returns 节点数组
      */
-    static findById(id: string, { filterClass, filterText, filterDes, node, timeout, }?: {
+    static findById(id: string, { filterClass, filterText, filterDes, node, timeout, scope, }?: {
         filterClass?: string;
         filterText?: string;
         filterDes?: string;
         node?: Node;
         timeout?: number;
+        scope?: NodeLookupScope;
     }): Promise<Node[]>;
     /**
      * 通过文本查找节点
@@ -2257,12 +1133,13 @@ declare class AssistsXAsync {
      * @param timeout 超时时间(秒)，默认30秒
      * @returns 节点数组
      */
-    static findByText(text: string, { filterClass, filterViewId, filterDes, node, timeout, }?: {
+    static findByText(text: string, { filterClass, filterViewId, filterDes, node, timeout, scope, }?: {
         filterClass?: string;
         filterViewId?: string;
         filterDes?: string;
         node?: Node;
         timeout?: number;
+        scope?: NodeLookupScope;
     }): Promise<Node[]>;
     /**
      * 通过标签查找节点
@@ -2274,20 +1151,30 @@ declare class AssistsXAsync {
      * @param timeout 超时时间(秒)，默认30秒
      * @returns 节点数组
      */
-    static findByTags(className: string, { filterText, filterViewId, filterDes, node, timeout, }?: {
+    static findByTags(className: string, { filterText, filterViewId, filterDes, node, timeout, scope, }?: {
         filterText?: string;
         filterViewId?: string;
         filterDes?: string;
         node?: Node;
         timeout?: number;
+        scope?: NodeLookupScope;
     }): Promise<Node[]>;
     /**
      * 查找所有匹配文本的节点
      * @param text 要查找的文本
      * @param timeout 超时时间(秒)，默认30秒
-     * @returns 节点数组
      */
     static findByTextAllMatch(text: string, timeout?: number): Promise<Node[]>;
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @param options.scope 节点查找范围（可选）
+     */
+    static findByTextAllMatch(text: string, options: {
+        timeout?: number;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
     /**
      * 检查是否包含指定文本
      * @param text 要检查的文本
@@ -2554,12 +1441,14 @@ declare class AssistsXAsync {
      * @param options.filePath 文件路径（可选，不提供则自动生成）
      * @param options.prettyPrint 是否格式化输出，默认为 true
      * @param options.timeout 超时时间(秒)，默认30秒
+     * @param options.scope 节点查找范围（可选）
      * @returns 保存的文件路径
      */
     static saveRootNodeTreeJson(options?: {
         filePath?: string;
         prettyPrint?: boolean;
         timeout?: number;
+        scope?: NodeLookupScope;
     }): Promise<string>;
     /**
      * 获取剪贴板文本内容
@@ -4198,6 +3087,16 @@ declare class Log {
     appendLine(line: string, maxLength?: number, timeout?: number): Promise<boolean>;
     /** 追加带时间戳的条目 */
     appendTimestampedEntry(message: string, timeout?: number): Promise<boolean>;
+    /**
+     * 追加日志（appendTimestampedEntry / appendLine 简写）。
+     * 默认带时间戳；`timestamped: false` 时走 appendLine。
+     */
+    append(text: string, options?: {
+        /** @default true */
+        timestamped?: boolean;
+        maxLength?: number;
+        timeout?: number;
+    }): Promise<boolean>;
     /** 替换全部内容 */
     replaceAll(content: string, timeout?: number): Promise<boolean>;
     /**
@@ -4228,4 +3127,4 @@ declare class Log {
 /** 默认单例，用法与 floatingwindow 模块导出的 float 一致 */
 declare const log: Log;
 
-export { type AccessibilityEvent, type AccessibilityEventData, AccessibilityEventFilter, type AccessibilityEventFilterConfig, type AccessibilityEventListener, AppInfo, AssistsX, AssistsXAsync, BarUtils, BarUtilsCallMethod, type BarUtilsCallMethodType, Bounds, CallMethod, type CallMethodType, CallResponse, type Contact, DeviceInfo, FileIO, type FileInfo, type FileListItem, type FileUploadInfo, FileUtils, Float, FloatCallMethod, type FloatCallMethodType, Gallery, type GalleryDeleteResponse, type GalleryResponse, Http, type HttpConfig, type HttpDownloadResponse, type HttpResponse, type ImageProcessResult, type ImageRotateDegree, type ImageSaveResult, type ImageSize, type ImageType, ImageUtils, Ime, ImeAction, type IsCurrentInputMethodResponse, type IsInputMethodEnabledResponse, Log, LogCallMethod, type LogCallMethodType, LogStream, type LogStreamType, type LogSubscribeUpdatePayload, type LogUpdateData, type LogUpdateEvent, type LogUploadOptions, type LogUploadResult, Mlkit, MlkitCallMethod, type MlkitCallMethodType, type MlkitRegion, Node, NodeAsync, NodeClassValue, type OpenInputMethodSettingsResponse, Path, type PerformEditorActionResponse, type RecognizeTextInScreenshotPosition, type RecognizeTextInScreenshotResult, type RecognizeTextRegion, type Screen, type ScreenTextJsonResult, type ScreenTextRecognitionResult, Step, StepAsync, StepError, type StepImpl, type StepInterceptor, type StepResult, type StepState, type StepStatus, StepStopError, type TextPosition, type WebFloatingWindowOptions, WindowFlags, accessibilityEventListeners, barUtils, callbacks, decodeBase64UTF8, fileIO, fileUtils, float, gallery, generateUUID, http, imageUtils, ime, log, logUpdateListeners, mlkit, pathUtils, screen, sleep, useStepStore };
+export { type AccessibilityEvent, type AccessibilityEventData, AccessibilityEventFilter, type AccessibilityEventFilterConfig, type AccessibilityEventListener, AppInfo, AssistsX, AssistsXAsync, BarUtils, BarUtilsCallMethod, type BarUtilsCallMethodType, Bounds, CallMethod, type CallMethodType, CallResponse, type Contact, DeviceInfo, FileIO, type FileInfo, type FileListItem, type FileUploadInfo, FileUtils, Float, FloatCallMethod, type FloatCallMethodType, Gallery, type GalleryDeleteResponse, type GalleryResponse, Http, type HttpConfig, type HttpDownloadResponse, type HttpResponse, type ImageProcessResult, type ImageRotateDegree, type ImageSaveResult, type ImageSize, type ImageType, ImageUtils, Ime, ImeAction, type IsCurrentInputMethodResponse, type IsInputMethodEnabledResponse, Log, LogCallMethod, type LogCallMethodType, LogStream, type LogStreamType, type LogSubscribeUpdatePayload, type LogUpdateData, type LogUpdateEvent, type LogUploadOptions, type LogUploadResult, Mlkit, MlkitCallMethod, type MlkitCallMethodType, type MlkitRegion, Node, NodeClassValue, NodeLookupScope, type OpenInputMethodSettingsResponse, Path, type PerformEditorActionResponse, type RecognizeTextInScreenshotPosition, type RecognizeTextInScreenshotResult, type RecognizeTextRegion, type Screen, type ScreenTextJsonResult, type ScreenTextRecognitionResult, type StepState, type StepStatus, type TextPosition, type WebFloatingWindowOptions, WindowFlags, accessibilityEventListeners, barUtils, callbacks, decodeBase64UTF8, ensureAssistsXPinia, fileIO, fileUtils, float, gallery, generateUUID, http, imageUtils, ime, log, logUpdateListeners, mlkit, pathUtils, screen, sleep, useStepStore };