assistsx-js 0.2.3 → 0.2.4

package/dist/index.d.ts

@@ -1,448 +1,1937 @@
-import { N as Node, a as NodeLookupScope, B as Bounds } from './step-DnFA4DEb.js';
-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.js';
 import * as pinia from 'pinia';
 
-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;
+/**
+ * 与 Android AssistsCore.NodeLookupScope / HTTP scope 查询参数一致的字符串取值。
+ */
+type NodeLookupScope = "active_window" | "all_windows";
+/** 与 AssistsCore.NodeLookupScope.ActiveWindow 对应 */
+declare const NODE_LOOKUP_SCOPE_ACTIVE_WINDOW: NodeLookupScope;
+/** 与 AssistsCore.NodeLookupScope.AllWindows 对应 */
+declare const NODE_LOOKUP_SCOPE_ALL_WINDOWS: NodeLookupScope;
+
+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;
 }
 
 /**
- * AccessibilityEvent过滤配置接口
- * 用于配置AccessibilityEvent的处理方式和过滤条件
+ * 节点类
+ * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
  */
-interface AccessibilityEventFilterConfig {
+
+declare class NodeAsync {
+    private node;
     /**
-     * 包名过滤
-     * 如果为空或null，则处理所有包的事件
-     * 如果指定包名，则只处理该包的事件
+     * 构造函数
+     * @param node Node实例
      */
-    packageName?: string | null;
+    constructor(node: Node);
     /**
-     * 是否在子线程中处理AccessibilityEvent
-     * true: 在子线程中处理，避免阻塞主线程
-     * false: 在主线程中处理
+     * 查找第一个匹配标签的父节点
+     * @param className 类名
+     * @returns 父节点
      */
-    processInBackground?: boolean;
+    findFirstParentByTags(className: string): Promise<Node>;
     /**
-     * 是否获取节点信息
-     * true: 获取并解析AccessibilityNodeInfo节点信息
-     * false: 不获取节点信息，提高处理性能
+     * 对节点执行点击手势
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @returns 是否点击成功
      */
-    fetchNodeInfo?: boolean;
+    clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, }?: {
+        offsetX?: number;
+        offsetY?: number;
+        switchWindowIntervalDelay?: number;
+        clickDuration?: number;
+    }): Promise<boolean>;
     /**
-     * 是否启用日志输出
-     * true: 输出AccessibilityEvent处理日志
-     * false: 不输出日志
+     * 对节点执行双击手势
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @param clickInterval 点击间隔
+     * @returns 是否双击成功
      */
-    enableLogging?: boolean;
+    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 节点数组
      */
-    eventTypes?: number[] | null;
+    findByTags(className: string, { filterText, filterViewId, filterDes, }?: {
+        filterText?: string;
+        filterViewId?: string;
+        filterDes?: string;
+    }): Promise<Node[]>;
     /**
-     * 是否启用事件去重
-     * true: 启用去重，避免重复处理相同事件
-     * false: 不启用去重
+     * 在当前节点范围内通过ID查找节点
+     * @param id 节点ID
+     * @param filterClass 类名过滤
+     * @param filterText 文本过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
      */
-    enableDeduplication?: boolean;
-}
-/**
- * AccessibilityEvent过滤配置类
- * 用于配置AccessibilityEvent的处理方式和过滤条件
- */
-declare class AccessibilityEventFilter {
+    findById(id: string, { filterClass, filterText, filterDes, }?: {
+        filterClass?: string;
+        filterText?: string;
+        filterDes?: string;
+    }): Promise<Node[]>;
     /**
-     * 包名过滤
+     * 在当前节点范围内通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
      */
-    readonly packageName: string | null;
+    findByText(text: string, { filterClass, filterViewId, filterDes, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+    }): Promise<Node[]>;
     /**
-     * 是否在子线程中处理AccessibilityEvent
+     * 向前滚动节点
+     * @returns 是否滚动成功
      */
-    readonly processInBackground: boolean;
+    scrollForward(): Promise<boolean>;
     /**
-     * 是否获取节点信息
+     * 向后滚动节点
+     * @returns 是否滚动成功
      */
-    readonly fetchNodeInfo: boolean;
+    scrollBackward(): Promise<boolean>;
     /**
-     * 是否启用日志输出
+     * 检查节点是否可见
+     * @param compareNode 比较节点
+     * @param isFullyByCompareNode 是否完全可见
+     * @returns 是否可见
      */
-    readonly enableLogging: boolean;
+    isVisible({ compareNode, isFullyByCompareNode, }?: {
+        compareNode?: Node;
+        isFullyByCompareNode?: boolean;
+    }): Promise<boolean>;
     /**
-     * 事件类型过滤
+     * 对节点进行截图
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径
      */
-    readonly eventTypes?: number[] | null;
+    takeScreenshot(overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
     /**
-     * 是否启用事件去重
+     * 设置节点文本
+     * @param text 要设置的文本
+     * @returns 是否设置成功
      */
-    readonly enableDeduplication: boolean;
-    constructor(config?: AccessibilityEventFilterConfig);
+    setNodeText(text: string): Promise<boolean>;
+    paste(text: string): Promise<boolean>;
+    focus(): Promise<boolean>;
     /**
-     * 检查是否应该处理指定包的事件
-     * @param targetPackageName 目标包名
-     * @returns true表示应该处理，false表示应该过滤
+     * 点击节点
+     * @returns 是否点击成功
      */
-    shouldProcessPackage(targetPackageName: string | null): boolean;
+    click(): Promise<boolean>;
     /**
-     * 检查是否应该处理指定类型的事件
-     * @param eventType 事件类型
-     * @returns true表示应该处理，false表示应该过滤
+     * 长按节点
+     * @returns 是否长按成功
      */
-    shouldProcessEventType(eventType: number): boolean;
+    longClick(): Promise<boolean>;
     /**
-     * 创建默认的过滤配置
-     * 所有包名，子线程处理，获取节点信息，启用日志
+     * 查找第一个可点击的父节点
+     * @returns 可点击的父节点
      */
-    static createDefault(): AccessibilityEventFilter;
+    findFirstParentClickable(): Promise<Node>;
     /**
-     * 创建高性能配置
-     * 不获取节点信息，不启用日志，启用去重
+     * 获取节点在屏幕中的边界
+     * @returns 边界对象
      */
-    static createHighPerformance(): AccessibilityEventFilter;
+    getBoundsInScreen(): Promise<Bounds>;
     /**
-     * 创建调试配置
-     * 启用所有功能，便于调试
+     * 获取节点的所有子节点
+     * @returns 子节点数组
      */
-    static createDebug(): AccessibilityEventFilter;
+    getNodes(): Promise<Node[]>;
     /**
-     * 创建指定包名的过滤配置
-     * @param targetPackageName 目标包名
+     * 获取节点的直接子节点
+     * @returns 子节点数组
      */
-    static createForPackage(targetPackageName: string): AccessibilityEventFilter;
+    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 节点数组
+     */
+    static fromJSONArray(array: Array<any>): Node[];
 }
 
 /**
- * 应用信息实体类
+ * 节点类
+ * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
  */
-declare class AppInfo {
+
+declare class Node {
     /**
-     * 是否为系统应用
+     * 节点唯一标识
      */
-    isSystem: boolean;
+    nodeId: string;
     /**
-     * 最低SDK版本
+     * 节点文本内容
      */
-    minSdkVersion: number;
+    text: string;
     /**
-     * 应用名称
+     * 节点描述信息
      */
-    name: string;
+    des: string;
     /**
-     * 应用包名
+     * 节点视图ID
      */
-    packageName: string;
+    viewId: string;
     /**
-     * 目标SDK版本
+     * 节点类名
      */
-    targetSdkVersion: number;
+    className: string;
     /**
-     * 版本号
+     * 是否可滚动
      */
-    versionCode: number;
+    isScrollable: boolean;
     /**
-     * 版本名称
+     * 是否可点击
      */
-    versionName: string;
-    constructor(isSystem?: boolean, minSdkVersion?: number, name?: string, packageName?: string, targetSdkVersion?: number, versionCode?: number, versionName?: string);
+    isClickable: boolean;
     /**
-     * 从JSON对象创建AppInfo实例
-     * @param data JSON对象
-     * @returns AppInfo实例
+     * 是否启用
      */
-    static fromJSON(data: any): AppInfo;
+    isEnabled: boolean;
     /**
-     * 转换为JSON对象
-     * @returns JSON对象
+     * 所属步骤ID
      */
-    toJSON(): any;
-}
-
-/**
- * 设备信息实体类
- */
-declare class DeviceInfo {
+    stepId: string | undefined;
     /**
-     * 设备唯一标识
+     * 提示文本
      */
-    uniqueDeviceId: string;
+    hintText: string;
     /**
-     * Android ID
+     * 是否可选择
      */
-    androidID: string;
+    isCheckable: boolean;
     /**
-     * MAC地址
+     * 是否已选中
      */
-    macAddress: string;
+    isChecked: boolean;
     /**
-     * 是否已Root
+     * 是否可聚焦
      */
-    isDeviceRooted: boolean;
+    isFocusable: boolean;
     /**
-     * 制造商
+     * 是否已聚焦
      */
-    manufacturer: string;
+    isFocused: boolean;
     /**
-     * 设备型号
+     * 是否可长按
      */
-    model: string;
+    isLongClickable: boolean;
     /**
-     * SDK版本号
+     * 是否为密码字段
      */
-    sdkVersionCode: number;
+    isPassword: boolean;
     /**
-     * SDK版本名称
+     * 是否已选中
      */
-    sdkVersionName: string;
+    isSelected: boolean;
     /**
-     * ABI列表
+     * 是否对用户可见
      */
-    abiList: string[];
+    isVisibleToUser: boolean;
     /**
-     * 是否启用ADB调试
+     * 绘制顺序
      */
-    isAdbEnabled: boolean;
+    drawingOrder: number;
     /**
-     * 是否启用开发者选项
+     * 节点在屏幕中的边界
      */
-    isDevelopmentSettingsEnabled: boolean;
+    bounds: Bounds;
     /**
-     * 是否为模拟器
+     * 节点在屏幕中的边界
+     * @deprecated 请使用 bounds 字段替代
      */
-    isEmulator: boolean;
+    get boundsInScreen(): Bounds;
     /**
-     * 是否为平板
+     * 构造函数
+     * @param params 节点参数对象
      */
-    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);
+    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;
     /**
-     * 从JSON对象创建DeviceInfo实例
-     * @param data JSON对象
-     * @returns DeviceInfo实例
+     * 查找第一个匹配标签的父节点
+     * @param className 类名
+     * @returns 父节点
      */
-    static fromJSON(data: any): DeviceInfo;
+    findFirstParentByTags(className: string): Node;
     /**
-     * 转换为JSON对象
-     * @returns JSON对象
+     * 对节点执行点击手势
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @returns 是否点击成功
      */
-    toJSON(): any;
-}
-
-/**
- * AssistsX 类
- * 提供与移动应用程序界面交互的工具类，包括节点查找、手势操作、屏幕操作等功能
- */
-
-/**
- * 无障碍事件数据结构
- */
-interface AccessibilityEventData {
-    packageName: string;
-    className: string;
-    eventType: number;
-    action: number;
-    texts: string[];
-    node: Node | null;
-}
+    clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, }?: {
+        offsetX?: number;
+        offsetY?: number;
+        switchWindowIntervalDelay?: number;
+        clickDuration?: number;
+    }): Promise<boolean>;
+    /**
+     * 对节点执行双击手势
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @param clickInterval 点击间隔
+     * @returns 是否双击成功
+     */
+    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[];
+}
+
+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的处理方式和过滤条件
  */
-interface AccessibilityEvent {
-    callbackId: string;
-    code: number;
-    data: AccessibilityEventData;
-    message: string;
+interface AccessibilityEventFilterConfig {
+    /**
+     * 包名过滤
+     * 如果为空或null，则处理所有包的事件
+     * 如果指定包名，则只处理该包的事件
+     */
+    packageName?: string | null;
+    /**
+     * 是否在子线程中处理AccessibilityEvent
+     * true: 在子线程中处理，避免阻塞主线程
+     * false: 在主线程中处理
+     */
+    processInBackground?: boolean;
+    /**
+     * 是否获取节点信息
+     * true: 获取并解析AccessibilityNodeInfo节点信息
+     * false: 不获取节点信息，提高处理性能
+     */
+    fetchNodeInfo?: boolean;
+    /**
+     * 是否启用日志输出
+     * true: 输出AccessibilityEvent处理日志
+     * false: 不输出日志
+     */
+    enableLogging?: boolean;
+    /**
+     * 事件类型过滤
+     * 如果为空，则处理所有类型的事件
+     * 如果指定类型，则只处理指定类型的事件
+     */
+    eventTypes?: number[] | null;
+    /**
+     * 是否启用事件去重
+     * true: 启用去重，避免重复处理相同事件
+     * false: 不启用去重
+     */
+    enableDeduplication?: boolean;
+}
+/**
+ * AccessibilityEvent过滤配置类
+ * 用于配置AccessibilityEvent的处理方式和过滤条件
+ */
+declare class AccessibilityEventFilter {
+    /**
+     * 包名过滤
+     */
+    readonly packageName: string | null;
+    /**
+     * 是否在子线程中处理AccessibilityEvent
+     */
+    readonly processInBackground: boolean;
+    /**
+     * 是否获取节点信息
+     */
+    readonly fetchNodeInfo: boolean;
+    /**
+     * 是否启用日志输出
+     */
+    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;
+}
+
+/**
+ * AssistsX 当前运行插件信息（由宿主拦截 getCurrentPlugin 返回）
+ */
+declare class PluginInfo {
+    id: string;
+    name: string;
+    packageName: string;
+    versionName: string;
+    versionCode: number;
+    description: string;
+    path: string;
+    index: string;
+    port: number;
+    needScreenCapture: boolean;
+    constructor(id?: string, name?: string, packageName?: string, versionName?: string, versionCode?: number, description?: string, path?: string, index?: string, port?: number, needScreenCapture?: boolean);
+    static fromJSON(data: unknown): PluginInfo;
+    toJSON(): Record<string, unknown>;
+}
+
+/**
+ * 设备信息实体类
+ */
+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;
+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;
+    /**
+     * 设置悬浮窗可获取焦点（WebView 内输入框 focus 时调用）
+     * @returns 是否设置成功
+     */
+    static setOverlayInputFocus(): boolean;
+    /**
+     * 取消悬浮窗焦点（WebView 内输入框 blur 时调用）
+     * @returns 是否设置成功
+     */
+    static clearOverlayInputFocus(): boolean;
+    /**
+     * 获取所有符合条件的节点
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param filterText 文本过滤
+     * @returns 节点数组
+     */
+    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        filterText?: string;
+        scope?: NodeLookupScope;
+    }): 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(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 节点数组
+     */
+    static findById(id: string, { filterClass, filterText, filterDes, node, scope, }?: {
+        filterClass?: string;
+        filterText?: string;
+        filterDes?: string;
+        node?: Node;
+        scope?: NodeLookupScope;
+    }): Node[];
+    /**
+     * 通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param node 父节点范围
+     * @returns 节点数组
+     */
+    static findByText(text: string, { filterClass, filterViewId, filterDes, node, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        node?: Node;
+        scope?: NodeLookupScope;
+    }): Node[];
+    /**
+     * 通过标签查找节点
+     * @param className 类名
+     * @param filterText 文本过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param node 父节点范围
+     * @returns 节点数组
+     */
+    static findByTags(className: string, { filterText, filterViewId, filterDes, node, scope, }?: {
+        filterText?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        node?: Node;
+        scope?: NodeLookupScope;
+    }): Node[];
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @param options.scope 节点查找范围（可选）
+     */
+    static findByTextAllMatch(text: string, { scope }?: {
+        scope?: NodeLookupScope;
+    }): 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>;
+    /**
+     * 获取当前运行的 AssistsX 插件信息（仅 AssistsX 宿主有效，否则返回 null）
+     */
+    static getCurrentPlugin(): PluginInfo | null;
+    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 getCurrentPlugin: "getCurrentPlugin";
+    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 视图类型常量
  */
-type AccessibilityEventListener = (event: AccessibilityEvent) => void;
+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;
+
 /**
- * Web浮动窗口选项接口定义
+ * 步骤执行错误类
+ * 用于携带步骤执行过程中的错误信息和当前步骤对象
+ * 支持传入可选数据：message，data任何类型的数据
  */
-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 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 const callbacks: Map<string, (data: string) => void>;
-declare const accessibilityEventListeners: AccessibilityEventListener[];
 /**
- * 屏幕尺寸类型（width/height 为整型像素值）
+ * 主动停止异常类
+ * 用于表示步骤被主动停止执行
  */
-interface Screen {
-    width: number;
-    height: number;
+declare class StepStopError extends StepError {
+    constructor(message?: string, data?: any);
 }
-/** 全局屏幕尺寸，在 assistsxCallback 初始化后自动加载 */
-declare let screen: Screen;
-declare class AssistsX {
+
+declare class StepAsync {
+    private step;
+    /**
+     * 构造函数
+     * @param step Step实例
+     */
+    constructor(step: Step);
+    /**
+     * 对单个节点进行截图
+     * @param node 目标节点
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径
+     */
+    takeScreenshotByNode(node: Node, overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
+    /**
+     * 对多个节点进行截图
+     * @param nodes 目标节点数组
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径数组
+     */
+    takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number): Promise<string[]>;
+    /**
+     * 获取所有符合条件的节点
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param filterText 文本过滤
+     * @returns 节点数组
+     */
+    getAllNodes({ filterClass, filterViewId, filterDes, filterText, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        filterText?: string;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 启动应用
+     * @param packageName 应用包名
+     * @returns 是否启动成功
+     */
+    launchApp(packageName: string): Promise<boolean>;
+    /**
+     * 获取当前应用包名
+     * @param timeout 超时时间(秒)，默认30秒
+     */
+    getPackageName(timeout?: number): Promise<string>;
+    /**
+     * 获取当前应用包名
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @param options.scope 节点查找范围（可选）
+     */
+    getPackageName(options: {
+        timeout?: number;
+        scope?: NodeLookupScope;
+    }): Promise<string>;
+    /**
+     * 通过ID查找节点
+     * @param id 节点ID
+     * @param filterClass 类名过滤
+     * @param filterText 文本过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findById(id: string, { filterClass, filterText, filterDes, scope, }?: {
+        filterClass?: string;
+        filterText?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByText(text: string, { filterClass, filterViewId, filterDes, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 通过标签查找节点
+     * @param className 类名
+     * @param filterText 文本过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByTags(className: string, { filterText, filterViewId, filterDes, scope, }?: {
+        filterText?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @param timeout 超时时间(秒)，默认30秒
+     */
+    findByTextAllMatch(text: string, timeout?: number): Promise<Node[]>;
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @param options.scope 节点查找范围（可选）
+     */
+    findByTextAllMatch(text: string, options: {
+        timeout?: number;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 检查是否包含指定文本
+     * @param text 要检查的文本
+     * @returns 是否包含
+     */
+    containsText(text: string): Promise<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 StepData = Record<string, 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;
+    /**
+     * 判断步骤数据是否有效（非空且为普通对象）
+     */
+    private static isValidStepData;
+    /**
+     * 解析步骤数据：优先使用传入值，否则使用当前值，均无效时返回空对象
+     */
+    private static resolveStepData;
+    /**
+     * 当前执行步骤的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?: StepData;
+        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;
     /**
-     * 屏幕尺寸（与全局变量 screen 同源）
-     * @deprecated 已过时，请使用全局变量 {@link screen}
+     * 步骤重复执行最大次数,默认15次
      */
-    static get screenSize(): any;
+    repeatCountMax: number;
     /**
-     * 执行同步调用
-     * @param method 方法名
-     * @param args 参数对象
-     * @returns 调用响应
+     * 异常重试次数
      */
-    static call(method: string, { args, node }?: {
-        args?: any;
-        node?: Node;
-    }): CallResponse;
+    exceptionRetryCount: number;
     /**
-     * 执行异步调用
-     * @param method 方法名
-     * @param args 参数对象
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns Promise<调用响应>
+     * 异常重试最大次数,默认3次
      */
-    static asyncCall(method: string, { args, node, nodes, timeout, }?: {
-        args?: any;
-        node?: Node;
-        nodes?: Node[];
-        timeout?: number;
-    }): Promise<CallResponse>;
+    exceptionRetryCountMax: number;
     /**
-     * 设置悬浮窗标志
-     * @param flags 标志
-     * @returns 是否设置成功
+     * 步骤标签
      */
-    static setOverlayFlags(flags: number): boolean;
+    tag: string | undefined;
+    isEnd: boolean;
     /**
-     * 设置悬浮窗标志
-     * @param flags 标志
-     * @returns 是否设置成功
+     * 步骤数据
      */
-    static setOverlayFlagList(flags: number[]): boolean;
+    data: StepData;
     /**
-     * 获取所有符合条件的节点
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @param filterText 文本过滤
-     * @returns 节点数组
+     * 步骤延迟时间(毫秒)
      */
-    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, scope, }?: {
-        filterClass?: string;
-        filterViewId?: string;
-        filterDes?: string;
-        filterText?: string;
-        scope?: NodeLookupScope;
-    }): Node[];
+    delayMs: number;
     /**
-     * 设置节点文本
-     * @param node 目标节点
-     * @param text 要设置的文本
-     * @returns 是否设置成功
+     * 步骤实现函数
      */
-    static setNodeText(node: Node, text: string): boolean;
+    impl: StepImpl | undefined;
     /**
-     * 获取剪贴板最新文本
-     * @returns 剪贴板最新文本
+     * 构造函数
+     * @param stepId 步骤ID
+     * @param impl 步骤实现函数
+     * @param tag 步骤标签
+     * @param data 步骤数据
+     * @param delayMs 步骤延迟时间(毫秒)
      */
-    static getClipboardLatestText(): any;
+    constructor({ stepId, impl, tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, isEnd, }: {
+        stepId: string;
+        impl: StepImpl | undefined;
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        repeatCountMax?: number;
+        exceptionRetryCountMax?: number;
+        isEnd?: boolean;
+    });
+    get async(): StepAsync;
     /**
-     * 获取剪贴板文本内容（异步）
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 剪贴板文本内容，如果获取失败则返回空字符串
+     * 创建下一个步骤
+     * @param impl 下一步骤实现函数
+     * @param tag 步骤标签
+     * @param data 步骤数据
+     * @param delayMs 步骤延迟时间(毫秒)
+     * @returns 新的步骤实例
      */
-    static getClipboardText(timeout?: number): Promise<string>;
+    next(impl: StepImpl, { tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        repeatCountMax?: number;
+        exceptionRetryCountMax?: number;
+    }): Step;
+    end({ tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        repeatCountMax?: number;
+        exceptionRetryCountMax?: number;
+    }): Step;
     /**
-     * 在浏览器中打开URL
-     * @param url 要打开的URL
-     * @returns 是否成功打开
+     * 重复当前步骤
+     * @param stepId 步骤ID
+     * @param tag 步骤标签
+     * @param data 步骤数据
+     * @param delayMs 步骤延迟时间(毫秒)
+     * @returns 当前步骤实例
      */
-    static openUrlInBrowser(url: string): boolean;
+    repeat({ stepId, tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
+        stepId?: string;
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        repeatCountMax?: number;
+        exceptionRetryCountMax?: number;
+    }): Step;
     /**
-     * 保持屏幕常亮
-     * @param tip 提示文本
-     * @returns 是否保持屏幕常亮成功
+     * 延迟执行
+     * @param ms 延迟时间(毫秒)
+     * @returns Promise
      */
-    static keepScreenOn(tip?: string): boolean;
-    static clearKeepScreenOn(): boolean;
-    static isAppInstalled(packageName: string): boolean;
+    delay(ms: number): Promise<void>;
     /**
-     * 对指定节点进行截图
-     * @param nodes 要截图的节点数组
+     * 等待异步方法执行完成
+     * @param method 异步方法
+     * @returns Promise<T>
+     */
+    await<T>(method: () => Promise<T>): Promise<T>;
+    /**
+     * 对单个节点进行截图
+     * @param node 目标节点
      * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns 截图路径数组
+     * @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>;
+    takeScreenshotByNode(node: Node, overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
     /**
-     * 点击节点
-     * @param node 要点击的节点
-     * @returns 是否点击成功
+     * 对多个节点进行截图
+     * @param nodes 目标节点数组
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径数组
      */
-    static click(node: Node): boolean;
+    takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number): Promise<string[]>;
     /**
-     * 长按节点
-     * @param node 要长按的节点
-     * @returns 是否长按成功
+     * 获取所有符合条件的节点
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param filterText 文本过滤
+     * @returns 节点数组
      */
-    static longClick(node: Node): boolean;
+    getAllNodes({ filterClass, filterViewId, filterDes, filterText, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        filterText?: string;
+        scope?: NodeLookupScope;
+    }): Node[];
     /**
      * 启动应用
      * @param packageName 应用包名
      * @returns 是否启动成功
      */
-    static launchApp(packageName: string): boolean;
+    launchApp(packageName: string): boolean;
     /**
      * 获取当前应用包名
-     * @returns 包名
+     * @param options.scope 节点查找范围（可选）
      */
-    static getPackageName(options?: {
+    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 节点数组
      */
-    static findById(id: string, { filterClass, filterText, filterDes, node, scope, }?: {
+    findById(id: string, { filterClass, filterText, filterDes, scope, }?: {
         filterClass?: string;
         filterText?: string;
         filterDes?: string;
-        node?: Node;
         scope?: NodeLookupScope;
     }): Node[];
     /**
@@ -451,14 +1940,12 @@ declare class AssistsX {
      * @param filterClass 类名过滤
      * @param filterViewId 视图ID过滤
      * @param filterDes 描述过滤
-     * @param node 父节点范围
      * @returns 节点数组
      */
-    static findByText(text: string, { filterClass, filterViewId, filterDes, node, scope, }?: {
+    findByText(text: string, { filterClass, filterViewId, filterDes, scope, }?: {
         filterClass?: string;
         filterViewId?: string;
         filterDes?: string;
-        node?: Node;
         scope?: NodeLookupScope;
     }): Node[];
     /**
@@ -467,14 +1954,12 @@ declare class AssistsX {
      * @param filterText 文本过滤
      * @param filterViewId 视图ID过滤
      * @param filterDes 描述过滤
-     * @param node 父节点范围
      * @returns 节点数组
      */
-    static findByTags(className: string, { filterText, filterViewId, filterDes, node, scope, }?: {
+    findByTags(className: string, { filterText, filterViewId, filterDes, scope, }?: {
         filterText?: string;
         filterViewId?: string;
         filterDes?: string;
-        node?: Node;
         scope?: NodeLookupScope;
     }): Node[];
     /**
@@ -482,337 +1967,79 @@ declare class AssistsX {
      * @param text 要查找的文本
      * @param options.scope 节点查找范围（可选）
      */
-    static findByTextAllMatch(text: string, { scope }?: {
+    findByTextAllMatch(text: string, { scope }?: {
         scope?: NodeLookupScope;
     }): 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 是否成功
+    /**
+     * 检查是否包含指定文本
+     * @param text 要检查的文本
+     * @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>;
+    containsText(text: string): boolean;
     /**
-     * 执行线型手势
-     * @param startPoint
-     * @param endPoint
-     * @param param2
-     * @param timeout 超时时间(秒)，默认30秒
-     * @returns
+     * 获取所有文本
+     * @returns 文本数组
      */
-    static performLinearGesture(startPoint: {
-        x: number;
-        y: number;
-    }, endPoint: {
+    getAllText(): string[];
+    /**
+     * 执行点击手势
+     * @param x 横坐标
+     * @param y 纵坐标
+     * @param duration 持续时间(毫秒)
+     * @returns 是否成功
+     */
+    clickByGesture(x: number, y: number, duration: number): Promise<boolean>;
+    longPressGestureAutoPaste(point: {
         x: number;
         y: number;
-    }, { duration, timeout }?: {
-        duration?: number;
-        timeout?: number;
-    }): Promise<boolean>;
-    static longPressNodeByGestureAutoPaste(node: Node, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, }?: {
+    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
         matchedPackageName?: string;
         matchedText?: string;
         timeoutMillis?: number;
         longPressDuration?: number;
-        timeout?: number;
     }): Promise<boolean>;
-    static longPressGestureAutoPaste(point: {
+    getAppInfo(packageName: string): Promise<any>;
+    performLinearGesture(startPoint: {
         x: number;
         y: number;
-    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, timeout, }?: {
-        matchedPackageName?: string;
-        matchedText?: string;
-        timeoutMillis?: number;
-        longPressDuration?: number;
-        timeout?: number;
+    }, endPoint: {
+        x: number;
+        y: number;
+    }, { duration }?: {
+        duration?: 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 应用窗口尺寸对象
+     * 返回操作
+     * @returns 是否成功
      */
-    static getAppScreenSize(): any;
+    back(): boolean;
     /**
-     * 添加无障碍事件监听器
-     * @param listener 监听器函数
+     * 回到主页
+     * @returns 是否成功
      */
-    static addAccessibilityEventListener(listener: AccessibilityEventListener): void;
+    home(): boolean;
     /**
-     * 判断是否包含无障碍事件监听器
-     * @param listener 监听器函数
-     * @returns 是否包含
+     * 打开通知栏
+     * @returns 是否成功
      */
-    static containsAccessibilityEventListener(listener: AccessibilityEventListener): boolean;
+    notifications(): boolean;
     /**
-     * 移除无障碍事件监听器
-     * @param listener 要移除的监听器函数
-     * @returns 是否移除成功
+     * 显示最近应用
+     * @returns 是否成功
      */
-    static removeAccessibilityEventListener(listener: AccessibilityEventListener): boolean;
+    recentApps(): boolean;
     /**
-     * 移除所有无障碍事件监听器
+     * 获取屏幕尺寸
+     * @returns 屏幕尺寸对象
      */
-    static removeAllAccessibilityEventListeners(): void;
+    getScreenSize(): any;
     /**
-     * 获取当前注册的无障碍事件监听器数量
-     * @returns 监听器数量
+     * 获取应用窗口尺寸
+     * @returns 应用窗口尺寸对象
      */
-    static getAccessibilityEventListenerCount(): number;
+    getAppScreenSize(): any;
 }
 
-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;
@@ -894,6 +2121,10 @@ declare class WindowFlags {
      * @returns 新的标志位组合
      */
     static removeFlag(flags: number, flag: number): number;
+    /** 输入框获取焦点时使用的悬浮窗 flag 组合（不含 FLAG_NOT_FOCUSABLE） */
+    static getOverlayInputFocusFlagList(): number[];
+    /** 输入框失去焦点时使用的悬浮窗 flag 组合（含 FLAG_NOT_FOCUSABLE） */
+    static getOverlayInputBlurFlagList(): number[];
     /**
      * 获取所有标志位的描述信息
      * @returns 标志位描述对象数组
@@ -975,6 +2206,14 @@ declare class AssistsXAsync {
      * @returns 是否设置成功
      */
     static setOverlayFlagList(flags: number[], timeout?: number): Promise<boolean>;
+    /**
+     * 设置悬浮窗可获取焦点（WebView 内输入框 focus 时调用）
+     */
+    static setOverlayInputFocus(timeout?: number): Promise<boolean>;
+    /**
+     * 取消悬浮窗焦点（WebView 内输入框 blur 时调用）
+     */
+    static clearOverlayInputFocus(timeout?: number): Promise<boolean>;
     /**
      * 获取所有符合条件的节点
      * @param filterClass 类名过滤
@@ -1373,6 +2612,10 @@ declare class AssistsXAsync {
         timeout?: number;
     }): Promise<boolean>;
     static getAppInfo(packageName: string, timeout?: number): Promise<AppInfo>;
+    /**
+     * 获取当前运行的 AssistsX 插件信息（仅 AssistsX 宿主有效，否则返回 null）
+     */
+    static getCurrentPlugin(timeout?: number): Promise<PluginInfo | null>;
     static getUniqueDeviceId(timeout?: number): Promise<any>;
     static getAndroidID(timeout?: number): Promise<any>;
     static getMacAddress(timeout?: number): Promise<any>;
@@ -2884,6 +4127,134 @@ declare const MlkitCallMethod: {
 };
 type MlkitCallMethodType = (typeof MlkitCallMethod)[keyof typeof MlkitCallMethod];
 
+type ScreenshotImageFormat = "PNG" | "JPEG" | "JPG" | "WEBP";
+/** takeScreenshotBase64 / takeNodeScreenshotBase64 返回数据 */
+interface ScreenshotBase64Data {
+    base64: string;
+    dataUrl: string;
+    mimeType: string;
+}
+interface TakeScreenshotBase64Options {
+    overlayHiddenScreenshotDelayMillis?: number;
+    format?: ScreenshotImageFormat;
+    withDataUrlPrefix?: boolean;
+    timeout?: number;
+}
+interface TakeScreenshotNodesBase64Options extends TakeScreenshotBase64Options {
+}
+declare class Screenshot {
+    /**
+     * 执行异步调用
+     */
+    private asyncCall;
+    private buildScreenshotArgs;
+    /**
+     * 截取全屏并返回 Base64
+     */
+    takeScreenshotBase64(options?: TakeScreenshotBase64Options): Promise<ScreenshotBase64Data | null>;
+    /**
+     * 截取指定节点区域并返回 Base64
+     */
+    takeNodeScreenshotBase64(nodeId: string, options?: TakeScreenshotBase64Options): Promise<ScreenshotBase64Data | null>;
+    /**
+     * 批量截取节点区域；nodeIds 为空时返回全屏截图
+     */
+    takeScreenshotNodesBase64(nodeIds?: string[], options?: TakeScreenshotNodesBase64Options): Promise<string[]>;
+}
+declare const screenshot: Screenshot;
+
+/**
+ * 截图相关的 JavascriptInterface 方法常量
+ */
+declare const ScreenshotCallMethod: {
+    /** 截取全屏并返回 Base64 */
+    readonly takeScreenshotBase64: "takeScreenshotBase64";
+    /** 截取指定节点区域并返回 Base64，需传 node.nodeId */
+    readonly takeNodeScreenshotBase64: "takeNodeScreenshotBase64";
+    /** 批量截取节点区域并返回 Base64 数组，nodes 为空时返回全屏 */
+    readonly takeScreenshotNodesBase64: "takeScreenshotNodesBase64";
+};
+type ScreenshotCallMethodType = (typeof ScreenshotCallMethod)[keyof typeof ScreenshotCallMethod];
+
+/** 数据库定位，dbPath 与 dbName 二选一 */
+interface DbTarget {
+    dbPath?: string;
+    dbName?: string;
+}
+/** exec 成功返回 */
+interface DbExecResult {
+    rowsAffected: number;
+    lastInsertRowId: number;
+}
+/** query 单行记录；BLOB 字段为 Base64 字符串 */
+type DbRow = Record<string, string | number | null>;
+/** query 成功返回 */
+interface DbQueryResult {
+    columns: string[];
+    rows: DbRow[];
+    rowCount: number;
+}
+/** execBatch 单条结果 */
+interface DbBatchItemResult {
+    rowsAffected: number;
+    lastInsertRowId: number;
+}
+/** execBatch 成功返回 */
+interface DbExecBatchResult {
+    count: number;
+    results: DbBatchItemResult[];
+}
+/** 公共调用选项 */
+interface DbCallOptions extends DbTarget {
+    bindArgs?: (string | number | boolean | null)[];
+    /** 超时时间（秒），默认 30 */
+    timeout?: number;
+}
+interface DbExecBatchOptions extends DbTarget {
+    /** 超时时间（秒），默认 30 */
+    timeout?: number;
+}
+declare class Db {
+    /**
+     * 执行异步调用
+     */
+    private asyncCall;
+    /**
+     * 将 query 结果中的 Base64 BLOB 字段解码为 Uint8Array
+     */
+    decodeBlobBase64(base64: string): Uint8Array;
+    /**
+     * 执行非查询 SQL
+     */
+    exec(sql: string, options: DbCallOptions): Promise<DbExecResult>;
+    /**
+     * 执行查询 SQL
+     */
+    query(sql: string, options: DbCallOptions): Promise<DbQueryResult>;
+    /**
+     * 事务内批量执行多条 SQL
+     */
+    execBatch(statements: string[], options: DbExecBatchOptions): Promise<DbExecBatchResult>;
+    /**
+     * 关闭并释放指定数据库连接
+     */
+    close(options: DbTarget & {
+        timeout?: number;
+    }): Promise<void>;
+}
+declare const db: Db;
+
+/**
+ * SQLite 数据库桥接方法名常量
+ */
+declare const DbCallMethod: {
+    readonly exec: "exec";
+    readonly query: "query";
+    readonly execBatch: "execBatch";
+    readonly close: "close";
+};
+type DbCallMethodType = (typeof DbCallMethod)[keyof typeof DbCallMethod];
+
 declare class BarUtils {
     private asyncCall;
     private errorMessage;
@@ -3015,6 +4386,8 @@ declare const LogCallMethod: {
     readonly uploadLogs: "uploadLogs";
     /** 获取日志服务当前域名（origin，无路径；与上传、管理后台同源），对应 AssistsLogDiagnostics.adminWebBaseUrl() */
     readonly getLogServiceBaseUrl: "getLogServiceBaseUrl";
+    /** 解析日志文件绝对路径（不创建文件） */
+    readonly resolveLogPath: "resolveLogPath";
 };
 /** 与 ASWebView / AssistsLogJavascriptInterface companion 对齐 */
 declare const LogStream: {
@@ -3024,6 +4397,15 @@ declare const LogStream: {
 type LogStreamType = (typeof LogStream)[keyof typeof LogStream];
 type LogCallMethodType = (typeof LogCallMethod)[keyof typeof LogCallMethod];
 
+/** 日志文件定位：dirPath 为绝对路径目录，fileName 不含 .txt 后缀 */
+interface LogTarget {
+    dirPath?: string;
+    fileName?: string;
+}
+interface LogCallOptions extends LogTarget {
+    /** 超时时间（秒），默认 30 */
+    timeout?: number;
+}
 /**
  * onAssistsLogUpdate 推送的监听器列表（与 accessibilityEventListeners 风格一致）。
  * 在页面加载本模块后，向此数组 push，或使用 log.addLogUpdateListener。
@@ -3031,7 +4413,7 @@ type LogCallMethodType = (typeof LogCallMethod)[keyof typeof LogCallMethod];
  */
 declare const logUpdateListeners: Array<(payload: LogUpdateEvent) => void>;
 /**
- * Base64 解码后的 CallResponse，data 含 stream / text
+ * Base64 解码后的 CallResponse，data 含 stream / text / logFilePath
  */
 interface LogUpdateEvent {
     code: number;
@@ -3042,13 +4424,15 @@ interface LogUpdateEvent {
 interface LogUpdateData {
     stream: LogStreamType;
     text: string;
+    logFilePath?: string;
 }
 interface LogSubscribeUpdatePayload {
     text: string;
     stream: string;
     subscriptionId: string;
+    logFilePath?: string;
 }
-interface LogUploadOptions {
+interface LogUploadOptions extends LogTarget {
     baseUrl?: string;
     /** PNG（默认）| JPEG | JPG | WEBP */
     format?: "PNG" | "JPEG" | "JPG" | "WEBP" | string;
@@ -3073,39 +4457,45 @@ declare class Log {
     private getBridge;
     private asyncCall;
     /** 读取当前日志全文 */
-    readAllText(timeout?: number): Promise<string>;
+    readAllText(timeoutOrOptions?: number | LogCallOptions): Promise<string>;
     /**
      * 获取日志服务当前域名（origin，无路径；与上传、管理后台同源）。
      * 与 Kotlin getLogServiceBaseUrl / adminWebBaseUrl 对齐。
      */
     getLogServiceBaseUrl(timeout?: number): Promise<string>;
+    /**
+     * 解析日志文件绝对路径（不创建文件）。
+     * AssistsX 插件环境下会经原生拦截追加 log-{packageName} 子目录。
+     */
+    resolveLogPath(targetOrOptions?: LogTarget | LogCallOptions): Promise<string>;
     /** 清空日志 */
-    clear(timeout?: number): Promise<boolean>;
+    clear(timeoutOrOptions?: number | LogCallOptions): Promise<boolean>;
     /** 从文件重新加载到内存 Flow */
-    refreshFromFile(timeout?: number): Promise<boolean>;
+    refreshFromFile(timeoutOrOptions?: number | LogCallOptions): Promise<boolean>;
     /** 追加一行 */
-    appendLine(line: string, maxLength?: number, timeout?: number): Promise<boolean>;
+    appendLine(line: string, maxLengthOrOptions?: number | (LogTarget & {
+        maxLength?: number;
+        timeout?: number;
+    }), timeout?: number): Promise<boolean>;
     /** 追加带时间戳的条目 */
-    appendTimestampedEntry(message: string, timeout?: number): Promise<boolean>;
+    appendTimestampedEntry(message: string, timeoutOrOptions?: number | LogCallOptions): Promise<boolean>;
     /**
      * 追加日志（appendTimestampedEntry / appendLine 简写）。
      * 默认带时间戳；`timestamped: false` 时走 appendLine。
      */
-    append(text: string, options?: {
+    append(text: string, options?: LogTarget & {
         /** @default true */
         timestamped?: boolean;
         maxLength?: number;
         timeout?: number;
     }): Promise<boolean>;
     /** 替换全部内容 */
-    replaceAll(content: string, timeout?: number): Promise<boolean>;
+    replaceAll(content: string, timeoutOrOptions?: number | LogCallOptions): Promise<boolean>;
     /**
      * 订阅 Flow：先收到 subscribed，再多次 update。
      * resolve 后请保留 dispose 或调用 unsubscribe(subscriptionId) 以释放原生协程与 JS 回调。
      */
-    subscribe(stream: LogStreamType, onUpdate: (payload: LogSubscribeUpdatePayload) => void, options?: {
-        timeout?: number;
-    }): Promise<{
+    subscribe(stream: LogStreamType, onUpdate: (payload: LogSubscribeUpdatePayload) => void, options?: LogCallOptions): Promise<{
         subscriptionId: string;
         dispose: () => Promise<void>;
     }>;
@@ -3127,4 +4517,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, 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 };
+export { type AccessibilityEvent, type AccessibilityEventData, AccessibilityEventFilter, type AccessibilityEventFilterConfig, type AccessibilityEventListener, AppInfo, AssistsX, AssistsXAsync, BarUtils, BarUtilsCallMethod, type BarUtilsCallMethodType, Bounds, CallMethod, type CallMethodType, CallResponse, type Contact, Db, type DbBatchItemResult, DbCallMethod, type DbCallMethodType, type DbCallOptions, type DbExecBatchOptions, type DbExecBatchResult, type DbExecResult, type DbQueryResult, type DbRow, type DbTarget, 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, type LogCallOptions, LogStream, type LogStreamType, type LogSubscribeUpdatePayload, type LogTarget, type LogUpdateData, type LogUpdateEvent, type LogUploadOptions, type LogUploadResult, Mlkit, MlkitCallMethod, type MlkitCallMethodType, type MlkitRegion, NODE_LOOKUP_SCOPE_ACTIVE_WINDOW, NODE_LOOKUP_SCOPE_ALL_WINDOWS, Node, NodeAsync, NodeClassValue, type NodeLookupScope, type OpenInputMethodSettingsResponse, Path, type PerformEditorActionResponse, PluginInfo, type RecognizeTextInScreenshotPosition, type RecognizeTextInScreenshotResult, type RecognizeTextRegion, type Screen, type ScreenTextJsonResult, type ScreenTextRecognitionResult, Screenshot, type ScreenshotBase64Data, ScreenshotCallMethod, type ScreenshotCallMethodType, type ScreenshotImageFormat, Step, StepAsync, type StepData, StepError, type StepImpl, type StepInterceptor, type StepResult, type StepState, type StepStatus, StepStopError, type TakeScreenshotBase64Options, type TakeScreenshotNodesBase64Options, type TextPosition, type WebFloatingWindowOptions, WindowFlags, accessibilityEventListeners, barUtils, callbacks, db, decodeBase64UTF8, ensureAssistsXPinia, fileIO, fileUtils, float, gallery, generateUUID, http, imageUtils, ime, log, logUpdateListeners, mlkit, pathUtils, screen, screenshot, sleep, useStepStore };