assistsx-js 0.2.3 → 0.2.4

package/dist/index.js

@@ -149,6 +149,7 @@ var CallMethod = {
   performLinearGesture: "performLinearGesture",
   longPressGestureAutoPaste: "longPressGestureAutoPaste",
   getAppInfo: "getAppInfo",
+  getCurrentPlugin: "getCurrentPlugin",
   getMacAddress: "getMacAddress",
   getAndroidID: "getAndroidID",
   getUniqueDeviceId: "getUniqueDeviceId",
@@ -269,6 +270,52 @@ var AppInfo = class _AppInfo {
   }
 };
 
+// src/plugin-info.ts
+var PluginInfo = class _PluginInfo {
+  constructor(id = "", name = "", packageName = "", versionName = "", versionCode = 0, description = "", path = "", index = "", port = 0, needScreenCapture = false) {
+    this.id = id;
+    this.name = name;
+    this.packageName = packageName;
+    this.versionName = versionName;
+    this.versionCode = versionCode;
+    this.description = description;
+    this.path = path;
+    this.index = index;
+    this.port = port;
+    this.needScreenCapture = needScreenCapture;
+  }
+  static fromJSON(data) {
+    var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    const record = data != null ? data : {};
+    return new _PluginInfo(
+      String((_a2 = record.id) != null ? _a2 : ""),
+      String((_b = record.name) != null ? _b : ""),
+      String((_c = record.packageName) != null ? _c : ""),
+      String((_d = record.versionName) != null ? _d : ""),
+      Number((_e = record.versionCode) != null ? _e : 0),
+      String((_f = record.description) != null ? _f : ""),
+      String((_g = record.path) != null ? _g : ""),
+      String((_h = record.index) != null ? _h : ""),
+      Number((_i = record.port) != null ? _i : 0),
+      Boolean((_j = record.needScreenCapture) != null ? _j : false)
+    );
+  }
+  toJSON() {
+    return {
+      id: this.id,
+      name: this.name,
+      packageName: this.packageName,
+      versionName: this.versionName,
+      versionCode: this.versionCode,
+      description: this.description,
+      path: this.path,
+      index: this.index,
+      port: this.port,
+      needScreenCapture: this.needScreenCapture
+    };
+  }
+};
+
 // src/device-info.ts
 var DeviceInfo = class _DeviceInfo {
   constructor(uniqueDeviceId = "", androidID = "", macAddress = "", isDeviceRooted = false, manufacturer = "", model = "", sdkVersionCode = 0, sdkVersionName = "", abiList = [], isAdbEnabled = false, isDevelopmentSettingsEnabled = false, isEmulator = false, isTablet = false) {
@@ -332,6 +379,137 @@ var DeviceInfo = class _DeviceInfo {
   }
 };
 
+// src/window-flags.ts
+var _WindowFlags = class _WindowFlags {
+  // 0x1000000
+  /**
+   * 获取标志位的十六进制表示
+   * @param flag 标志位值
+   * @returns 十六进制字符串
+   */
+  static toHex(flag) {
+    return `0x${flag.toString(16).toUpperCase()}`;
+  }
+  /**
+   * 检查是否包含指定标志位
+   * @param flags 当前标志位组合
+   * @param flag 要检查的标志位
+   * @returns 是否包含该标志位
+   */
+  static hasFlag(flags, flag) {
+    return (flags & flag) === flag;
+  }
+  /**
+   * 添加标志位
+   * @param flags 当前标志位组合
+   * @param flag 要添加的标志位
+   * @returns 新的标志位组合
+   */
+  static addFlag(flags, flag) {
+    return flags | flag;
+  }
+  /**
+   * 移除标志位
+   * @param flags 当前标志位组合
+   * @param flag 要移除的标志位
+   * @returns 新的标志位组合
+   */
+  static removeFlag(flags, flag) {
+    return flags & ~flag;
+  }
+  /** 输入框获取焦点时使用的悬浮窗 flag 组合（不含 FLAG_NOT_FOCUSABLE） */
+  static getOverlayInputFocusFlagList() {
+    return [
+      _WindowFlags.FLAG_WATCH_OUTSIDE_TOUCH,
+      _WindowFlags.FLAG_NOT_TOUCH_MODAL,
+      _WindowFlags.FLAG_LAYOUT_NO_LIMITS,
+      _WindowFlags.FLAG_LAYOUT_IN_SCREEN
+    ];
+  }
+  /** 输入框失去焦点时使用的悬浮窗 flag 组合（含 FLAG_NOT_FOCUSABLE） */
+  static getOverlayInputBlurFlagList() {
+    return [
+      _WindowFlags.FLAG_WATCH_OUTSIDE_TOUCH,
+      _WindowFlags.FLAG_NOT_TOUCH_MODAL,
+      _WindowFlags.FLAG_LAYOUT_NO_LIMITS,
+      _WindowFlags.FLAG_NOT_FOCUSABLE,
+      _WindowFlags.FLAG_LAYOUT_IN_SCREEN
+    ];
+  }
+  /**
+   * 获取所有标志位的描述信息
+   * @returns 标志位描述对象数组
+   */
+  static getAllFlags() {
+    return [
+      { name: "FLAG_NOT_FOCUSABLE", value: this.FLAG_NOT_FOCUSABLE, hex: this.toHex(this.FLAG_NOT_FOCUSABLE), description: "\u4E0D\u83B7\u53D6\u7126\u70B9" },
+      { name: "FLAG_NOT_TOUCHABLE", value: this.FLAG_NOT_TOUCHABLE, hex: this.toHex(this.FLAG_NOT_TOUCHABLE), description: "\u4E0D\u54CD\u5E94\u89E6\u6478" },
+      { name: "FLAG_NOT_TOUCH_MODAL", value: this.FLAG_NOT_TOUCH_MODAL, hex: this.toHex(this.FLAG_NOT_TOUCH_MODAL), description: "\u4E0D\u62E6\u622A\u89E6\u6478" },
+      { name: "FLAG_WATCH_OUTSIDE_TOUCH", value: this.FLAG_WATCH_OUTSIDE_TOUCH, hex: this.toHex(this.FLAG_WATCH_OUTSIDE_TOUCH), description: "\u76D1\u542C\u7A97\u5916\u70B9\u51FB" },
+      { name: "FLAG_LAYOUT_NO_LIMITS", value: this.FLAG_LAYOUT_NO_LIMITS, hex: this.toHex(this.FLAG_LAYOUT_NO_LIMITS), description: "\u53EF\u7ED8\u5236\u8D85\u51FA\u5C4F\u5E55" },
+      { name: "FLAG_LAYOUT_IN_SCREEN", value: this.FLAG_LAYOUT_IN_SCREEN, hex: this.toHex(this.FLAG_LAYOUT_IN_SCREEN), description: "\u5C4F\u5E55\u5168\u533A\u57DF\u5E03\u5C40" },
+      { name: "FLAG_FULLSCREEN", value: this.FLAG_FULLSCREEN, hex: this.toHex(this.FLAG_FULLSCREEN), description: "\u5168\u5C4F\u663E\u793A" },
+      { name: "FLAG_DIM_BEHIND", value: this.FLAG_DIM_BEHIND, hex: this.toHex(this.FLAG_DIM_BEHIND), description: "\u80CC\u666F\u53D8\u6697" },
+      { name: "FLAG_SECURE", value: this.FLAG_SECURE, hex: this.toHex(this.FLAG_SECURE), description: "\u9632\u5F55\u5C4F\u9632\u622A\u56FE" },
+      { name: "FLAG_KEEP_SCREEN_ON", value: this.FLAG_KEEP_SCREEN_ON, hex: this.toHex(this.FLAG_KEEP_SCREEN_ON), description: "\u4FDD\u6301\u5E38\u4EAE" },
+      { name: "FLAG_SHOW_WHEN_LOCKED", value: this.FLAG_SHOW_WHEN_LOCKED, hex: this.toHex(this.FLAG_SHOW_WHEN_LOCKED), description: "\u9501\u5C4F\u65F6\u53EF\u89C1" },
+      { name: "FLAG_DISMISS_KEYGUARD", value: this.FLAG_DISMISS_KEYGUARD, hex: this.toHex(this.FLAG_DISMISS_KEYGUARD), description: "\u89E3\u9501\u5C4F\u5E55" },
+      { name: "FLAG_TURN_SCREEN_ON", value: this.FLAG_TURN_SCREEN_ON, hex: this.toHex(this.FLAG_TURN_SCREEN_ON), description: "\u70B9\u4EAE\u5C4F\u5E55" },
+      { name: "FLAG_ALLOW_LOCK_WHILE_SCREEN_ON", value: this.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON, hex: this.toHex(this.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON), description: "\u81EA\u52A8\u9501\u5C4F\uFF08\u4E0D\u5E38\u7528\uFF09" },
+      { name: "FLAG_SHOW_WALLPAPER", value: this.FLAG_SHOW_WALLPAPER, hex: this.toHex(this.FLAG_SHOW_WALLPAPER), description: "\u663E\u793A\u5899\u7EB8" },
+      { name: "FLAG_HARDWARE_ACCELERATED", value: this.FLAG_HARDWARE_ACCELERATED, hex: this.toHex(this.FLAG_HARDWARE_ACCELERATED), description: "\u5F3A\u5236\u786C\u4EF6\u52A0\u901F" }
+    ];
+  }
+};
+/** 不获取焦点 */
+_WindowFlags.FLAG_NOT_FOCUSABLE = 8;
+// 0x08
+/** 不响应触摸 */
+_WindowFlags.FLAG_NOT_TOUCHABLE = 16;
+// 0x10
+/** 不拦截触摸 */
+_WindowFlags.FLAG_NOT_TOUCH_MODAL = 32;
+// 0x20
+/** 监听窗外点击 */
+_WindowFlags.FLAG_WATCH_OUTSIDE_TOUCH = 4;
+// 0x04
+/** 可绘制超出屏幕 */
+_WindowFlags.FLAG_LAYOUT_NO_LIMITS = 512;
+// 0x200
+/** 屏幕全区域布局 */
+_WindowFlags.FLAG_LAYOUT_IN_SCREEN = 256;
+// 0x100
+/** 全屏显示 */
+_WindowFlags.FLAG_FULLSCREEN = 1024;
+// 0x400
+/** 背景变暗 */
+_WindowFlags.FLAG_DIM_BEHIND = 2;
+// 0x02
+/** 防录屏防截图 */
+_WindowFlags.FLAG_SECURE = 8192;
+// 0x2000
+/** 保持常亮 */
+_WindowFlags.FLAG_KEEP_SCREEN_ON = 128;
+// 0x80
+/** 锁屏时可见 */
+_WindowFlags.FLAG_SHOW_WHEN_LOCKED = 524288;
+// 0x80000
+/** 解锁屏幕 */
+_WindowFlags.FLAG_DISMISS_KEYGUARD = 4194304;
+// 0x400000
+/** 点亮屏幕 */
+_WindowFlags.FLAG_TURN_SCREEN_ON = 2097152;
+// 0x200000
+/** 自动锁屏（不常用） */
+_WindowFlags.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON = 128;
+// 0x80
+/** 显示墙纸 */
+_WindowFlags.FLAG_SHOW_WALLPAPER = 1048576;
+// 0x100000
+/** 强制硬件加速 */
+_WindowFlags.FLAG_HARDWARE_ACCELERATED = 16777216;
+var WindowFlags = _WindowFlags;
+
 // src/assistsx-async.ts
 var AssistsXAsync = class {
   /**
@@ -403,6 +581,18 @@ var AssistsXAsync = class {
     });
     return response.getDataOrDefault(false);
   }
+  /**
+   * 设置悬浮窗可获取焦点（WebView 内输入框 focus 时调用）
+   */
+  static async setOverlayInputFocus(timeout) {
+    return this.setOverlayFlagList(WindowFlags.getOverlayInputFocusFlagList(), timeout);
+  }
+  /**
+   * 取消悬浮窗焦点（WebView 内输入框 blur 时调用）
+   */
+  static async clearOverlayInputFocus(timeout) {
+    return this.setOverlayFlagList(WindowFlags.getOverlayInputBlurFlagList(), timeout);
+  }
   /**
    * 获取所有符合条件的节点
    * @param filterClass 类名过滤
@@ -1168,6 +1358,22 @@ var AssistsXAsync = class {
     });
     return AppInfo.fromJSON(response.getDataOrDefault({}));
   }
+  /**
+   * 获取当前运行的 AssistsX 插件信息（仅 AssistsX 宿主有效，否则返回 null）
+   */
+  static async getCurrentPlugin(timeout) {
+    const response = await this.asyncCall(CallMethod.getCurrentPlugin, {
+      timeout
+    });
+    if (!response.isSuccess()) {
+      return null;
+    }
+    const data = response.getDataOrNull();
+    if (!data) {
+      return null;
+    }
+    return PluginInfo.fromJSON(data);
+  }
   static async getUniqueDeviceId(timeout) {
     const response = await this.asyncCall(CallMethod.getUniqueDeviceId, {
       timeout
@@ -3376,6 +3582,20 @@ var AssistsX2 = class {
     });
     return response.getDataOrDefault(false);
   }
+  /**
+   * 设置悬浮窗可获取焦点（WebView 内输入框 focus 时调用）
+   * @returns 是否设置成功
+   */
+  static setOverlayInputFocus() {
+    return this.setOverlayFlagList(WindowFlags.getOverlayInputFocusFlagList());
+  }
+  /**
+   * 取消悬浮窗焦点（WebView 内输入框 blur 时调用）
+   * @returns 是否设置成功
+   */
+  static clearOverlayInputFocus() {
+    return this.setOverlayFlagList(WindowFlags.getOverlayInputBlurFlagList());
+  }
   /**
    * 获取所有符合条件的节点
    * @param filterClass 类名过滤
@@ -4021,6 +4241,20 @@ var AssistsX2 = class {
     });
     return AppInfo.fromJSON(response.getDataOrDefault({}));
   }
+  /**
+   * 获取当前运行的 AssistsX 插件信息（仅 AssistsX 宿主有效，否则返回 null）
+   */
+  static getCurrentPlugin() {
+    const response = this.call(CallMethod.getCurrentPlugin);
+    if (!response.isSuccess()) {
+      return null;
+    }
+    const data = response.getDataOrNull();
+    if (!data) {
+      return null;
+    }
+    return PluginInfo.fromJSON(data);
+  }
   static getUniqueDeviceId() {
     const response = this.call(CallMethod.getUniqueDeviceId);
     return response.getDataOrDefault("");
@@ -4172,117 +4406,6 @@ var NodeClassValue = {
   FrameLayout: "android.widget.FrameLayout"
 };
 
-// src/window-flags.ts
-var WindowFlags = class {
-  // 0x1000000
-  /**
-   * 获取标志位的十六进制表示
-   * @param flag 标志位值
-   * @returns 十六进制字符串
-   */
-  static toHex(flag) {
-    return `0x${flag.toString(16).toUpperCase()}`;
-  }
-  /**
-   * 检查是否包含指定标志位
-   * @param flags 当前标志位组合
-   * @param flag 要检查的标志位
-   * @returns 是否包含该标志位
-   */
-  static hasFlag(flags, flag) {
-    return (flags & flag) === flag;
-  }
-  /**
-   * 添加标志位
-   * @param flags 当前标志位组合
-   * @param flag 要添加的标志位
-   * @returns 新的标志位组合
-   */
-  static addFlag(flags, flag) {
-    return flags | flag;
-  }
-  /**
-   * 移除标志位
-   * @param flags 当前标志位组合
-   * @param flag 要移除的标志位
-   * @returns 新的标志位组合
-   */
-  static removeFlag(flags, flag) {
-    return flags & ~flag;
-  }
-  /**
-   * 获取所有标志位的描述信息
-   * @returns 标志位描述对象数组
-   */
-  static getAllFlags() {
-    return [
-      { name: "FLAG_NOT_FOCUSABLE", value: this.FLAG_NOT_FOCUSABLE, hex: this.toHex(this.FLAG_NOT_FOCUSABLE), description: "\u4E0D\u83B7\u53D6\u7126\u70B9" },
-      { name: "FLAG_NOT_TOUCHABLE", value: this.FLAG_NOT_TOUCHABLE, hex: this.toHex(this.FLAG_NOT_TOUCHABLE), description: "\u4E0D\u54CD\u5E94\u89E6\u6478" },
-      { name: "FLAG_NOT_TOUCH_MODAL", value: this.FLAG_NOT_TOUCH_MODAL, hex: this.toHex(this.FLAG_NOT_TOUCH_MODAL), description: "\u4E0D\u62E6\u622A\u89E6\u6478" },
-      { name: "FLAG_WATCH_OUTSIDE_TOUCH", value: this.FLAG_WATCH_OUTSIDE_TOUCH, hex: this.toHex(this.FLAG_WATCH_OUTSIDE_TOUCH), description: "\u76D1\u542C\u7A97\u5916\u70B9\u51FB" },
-      { name: "FLAG_LAYOUT_NO_LIMITS", value: this.FLAG_LAYOUT_NO_LIMITS, hex: this.toHex(this.FLAG_LAYOUT_NO_LIMITS), description: "\u53EF\u7ED8\u5236\u8D85\u51FA\u5C4F\u5E55" },
-      { name: "FLAG_LAYOUT_IN_SCREEN", value: this.FLAG_LAYOUT_IN_SCREEN, hex: this.toHex(this.FLAG_LAYOUT_IN_SCREEN), description: "\u5C4F\u5E55\u5168\u533A\u57DF\u5E03\u5C40" },
-      { name: "FLAG_FULLSCREEN", value: this.FLAG_FULLSCREEN, hex: this.toHex(this.FLAG_FULLSCREEN), description: "\u5168\u5C4F\u663E\u793A" },
-      { name: "FLAG_DIM_BEHIND", value: this.FLAG_DIM_BEHIND, hex: this.toHex(this.FLAG_DIM_BEHIND), description: "\u80CC\u666F\u53D8\u6697" },
-      { name: "FLAG_SECURE", value: this.FLAG_SECURE, hex: this.toHex(this.FLAG_SECURE), description: "\u9632\u5F55\u5C4F\u9632\u622A\u56FE" },
-      { name: "FLAG_KEEP_SCREEN_ON", value: this.FLAG_KEEP_SCREEN_ON, hex: this.toHex(this.FLAG_KEEP_SCREEN_ON), description: "\u4FDD\u6301\u5E38\u4EAE" },
-      { name: "FLAG_SHOW_WHEN_LOCKED", value: this.FLAG_SHOW_WHEN_LOCKED, hex: this.toHex(this.FLAG_SHOW_WHEN_LOCKED), description: "\u9501\u5C4F\u65F6\u53EF\u89C1" },
-      { name: "FLAG_DISMISS_KEYGUARD", value: this.FLAG_DISMISS_KEYGUARD, hex: this.toHex(this.FLAG_DISMISS_KEYGUARD), description: "\u89E3\u9501\u5C4F\u5E55" },
-      { name: "FLAG_TURN_SCREEN_ON", value: this.FLAG_TURN_SCREEN_ON, hex: this.toHex(this.FLAG_TURN_SCREEN_ON), description: "\u70B9\u4EAE\u5C4F\u5E55" },
-      { name: "FLAG_ALLOW_LOCK_WHILE_SCREEN_ON", value: this.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON, hex: this.toHex(this.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON), description: "\u81EA\u52A8\u9501\u5C4F\uFF08\u4E0D\u5E38\u7528\uFF09" },
-      { name: "FLAG_SHOW_WALLPAPER", value: this.FLAG_SHOW_WALLPAPER, hex: this.toHex(this.FLAG_SHOW_WALLPAPER), description: "\u663E\u793A\u5899\u7EB8" },
-      { name: "FLAG_HARDWARE_ACCELERATED", value: this.FLAG_HARDWARE_ACCELERATED, hex: this.toHex(this.FLAG_HARDWARE_ACCELERATED), description: "\u5F3A\u5236\u786C\u4EF6\u52A0\u901F" }
-    ];
-  }
-};
-/** 不获取焦点 */
-WindowFlags.FLAG_NOT_FOCUSABLE = 8;
-// 0x08
-/** 不响应触摸 */
-WindowFlags.FLAG_NOT_TOUCHABLE = 16;
-// 0x10
-/** 不拦截触摸 */
-WindowFlags.FLAG_NOT_TOUCH_MODAL = 32;
-// 0x20
-/** 监听窗外点击 */
-WindowFlags.FLAG_WATCH_OUTSIDE_TOUCH = 4;
-// 0x04
-/** 可绘制超出屏幕 */
-WindowFlags.FLAG_LAYOUT_NO_LIMITS = 512;
-// 0x200
-/** 屏幕全区域布局 */
-WindowFlags.FLAG_LAYOUT_IN_SCREEN = 256;
-// 0x100
-/** 全屏显示 */
-WindowFlags.FLAG_FULLSCREEN = 1024;
-// 0x400
-/** 背景变暗 */
-WindowFlags.FLAG_DIM_BEHIND = 2;
-// 0x02
-/** 防录屏防截图 */
-WindowFlags.FLAG_SECURE = 8192;
-// 0x2000
-/** 保持常亮 */
-WindowFlags.FLAG_KEEP_SCREEN_ON = 128;
-// 0x80
-/** 锁屏时可见 */
-WindowFlags.FLAG_SHOW_WHEN_LOCKED = 524288;
-// 0x80000
-/** 解锁屏幕 */
-WindowFlags.FLAG_DISMISS_KEYGUARD = 4194304;
-// 0x400000
-/** 点亮屏幕 */
-WindowFlags.FLAG_TURN_SCREEN_ON = 2097152;
-// 0x200000
-/** 自动锁屏（不常用） */
-WindowFlags.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON = 128;
-// 0x80
-/** 显示墙纸 */
-WindowFlags.FLAG_SHOW_WALLPAPER = 1048576;
-// 0x100000
-/** 强制硬件加速 */
-WindowFlags.FLAG_HARDWARE_ACCELERATED = 16777216;
-
 // src/accessibility-event-filter.ts
 var AccessibilityEventFilter = class _AccessibilityEventFilter {
   constructor(config = {}) {
@@ -7075,6 +7198,342 @@ var Mlkit = class {
 };
 var mlkit = new Mlkit();
 
+// src/screenshot/screenshot-call-method.ts
+var ScreenshotCallMethod = {
+  /** 截取全屏并返回 Base64 */
+  takeScreenshotBase64: "takeScreenshotBase64",
+  /** 截取指定节点区域并返回 Base64，需传 node.nodeId */
+  takeNodeScreenshotBase64: "takeNodeScreenshotBase64",
+  /** 批量截取节点区域并返回 Base64 数组，nodes 为空时返回全屏 */
+  takeScreenshotNodesBase64: "takeScreenshotNodesBase64"
+};
+
+// src/screenshot/screenshot.ts
+var callbacks10 = /* @__PURE__ */ new Map();
+if (typeof window !== "undefined" && !window.assistsxScreenshotCallback) {
+  window.assistsxScreenshotCallback = (data) => {
+    let callbackId;
+    try {
+      const json = decodeBase64UTF8(data);
+      const response = JSON.parse(json);
+      callbackId = response.callbackId;
+      if (callbackId) {
+        const callback = callbacks10.get(callbackId);
+        if (callback) {
+          callback(json);
+        }
+      }
+    } catch (e) {
+      console.error("Screenshot callback error:", e);
+    } finally {
+      if (callbackId) {
+        callbacks10.delete(callbackId);
+      }
+    }
+  };
+}
+function createNodeStub(nodeId) {
+  return { nodeId };
+}
+function parseScreenshotBase64Data(data) {
+  if (!data || typeof data !== "object") {
+    return null;
+  }
+  const record = data;
+  const base64 = typeof record.base64 === "string" ? record.base64 : "";
+  const mimeType = typeof record.mimeType === "string" ? record.mimeType : "image/png";
+  const dataUrl = typeof record.dataUrl === "string" ? record.dataUrl : `data:${mimeType};base64,${base64}`;
+  if (!base64) {
+    return null;
+  }
+  return { base64, dataUrl, mimeType };
+}
+var Screenshot = class {
+  /**
+   * 执行异步调用
+   */
+  async asyncCall(method, {
+    args,
+    node,
+    nodes,
+    timeout = 30
+  } = {}) {
+    const uuid = generateUUID();
+    const params = {
+      method,
+      arguments: args ? args : void 0,
+      node: node ? node : void 0,
+      nodes: nodes ? nodes : void 0,
+      callbackId: uuid
+    };
+    const promise = new Promise((resolve) => {
+      callbacks10.set(uuid, (data) => {
+        resolve(data);
+      });
+      setTimeout(() => {
+        callbacks10.delete(uuid);
+        resolve(JSON.stringify(new CallResponse(0, null, uuid)));
+      }, timeout * 1e3);
+    });
+    window.assistsxScreenshot.call(JSON.stringify(params));
+    const promiseResult = await promise;
+    if (typeof promiseResult === "string") {
+      const responseData = JSON.parse(promiseResult);
+      return new CallResponse(
+        responseData.code,
+        responseData.data,
+        responseData.callbackId
+      );
+    }
+    throw new Error("Screenshot call failed");
+  }
+  buildScreenshotArgs(options = {}) {
+    const {
+      overlayHiddenScreenshotDelayMillis = 250,
+      format = "PNG",
+      withDataUrlPrefix = true
+    } = options;
+    return {
+      overlayHiddenScreenshotDelayMillis,
+      format,
+      withDataUrlPrefix
+    };
+  }
+  /**
+   * 截取全屏并返回 Base64
+   */
+  async takeScreenshotBase64(options = {}) {
+    const { timeout = 30, ...rest } = options;
+    const response = await this.asyncCall(ScreenshotCallMethod.takeScreenshotBase64, {
+      args: this.buildScreenshotArgs(rest),
+      timeout
+    });
+    if (!response.isSuccess()) {
+      return null;
+    }
+    return parseScreenshotBase64Data(response.getDataOrNull());
+  }
+  /**
+   * 截取指定节点区域并返回 Base64
+   */
+  async takeNodeScreenshotBase64(nodeId, options = {}) {
+    if (!nodeId) {
+      throw new Error("nodeId is required");
+    }
+    const { timeout = 30, ...rest } = options;
+    const response = await this.asyncCall(ScreenshotCallMethod.takeNodeScreenshotBase64, {
+      args: this.buildScreenshotArgs(rest),
+      node: createNodeStub(nodeId),
+      timeout
+    });
+    if (!response.isSuccess()) {
+      return null;
+    }
+    return parseScreenshotBase64Data(response.getDataOrNull());
+  }
+  /**
+   * 批量截取节点区域；nodeIds 为空时返回全屏截图
+   */
+  async takeScreenshotNodesBase64(nodeIds = [], options = {}) {
+    const { timeout = 30, ...rest } = options;
+    const nodes = nodeIds.map((nodeId) => createNodeStub(nodeId));
+    const response = await this.asyncCall(ScreenshotCallMethod.takeScreenshotNodesBase64, {
+      args: this.buildScreenshotArgs(rest),
+      nodes,
+      timeout
+    });
+    if (!response.isSuccess()) {
+      return [];
+    }
+    const data = response.getDataOrNull();
+    return Array.isArray(data == null ? void 0 : data.images) ? data.images : [];
+  }
+};
+var screenshot = new Screenshot();
+
+// src/db/db-call-method.ts
+var DbCallMethod = {
+  exec: "exec",
+  query: "query",
+  execBatch: "execBatch",
+  close: "close"
+};
+
+// src/db/db.ts
+var callbacks11 = /* @__PURE__ */ new Map();
+if (typeof window !== "undefined" && !window.assistsxDbCallback) {
+  window.assistsxDbCallback = (data) => {
+    let callbackId;
+    try {
+      const json = decodeBase64UTF8(data);
+      const response = JSON.parse(json);
+      callbackId = response.callbackId;
+      if (callbackId) {
+        const callback = callbacks11.get(callbackId);
+        if (callback) {
+          callback(json);
+        }
+      }
+    } catch (e) {
+      console.error("Db callback error:", e);
+    } finally {
+      if (callbackId) {
+        callbacks11.delete(callbackId);
+      }
+    }
+  };
+}
+function buildDbArguments(target, extra) {
+  const args = { ...extra };
+  if (target.dbPath) {
+    args.dbPath = target.dbPath;
+  }
+  if (target.dbName) {
+    args.dbName = target.dbName;
+  }
+  return args;
+}
+function normalizeBindArgs(bindArgs) {
+  if (!bindArgs || bindArgs.length === 0) {
+    return void 0;
+  }
+  return bindArgs.map((value) => {
+    if (value === null) {
+      return null;
+    }
+    return String(value);
+  });
+}
+function parseExecResult(data) {
+  var _a2, _b;
+  const record = data != null ? data : {};
+  return {
+    rowsAffected: Number((_a2 = record.rowsAffected) != null ? _a2 : 0),
+    lastInsertRowId: Number((_b = record.lastInsertRowId) != null ? _b : 0)
+  };
+}
+function parseQueryResult(data) {
+  var _a2;
+  const record = data != null ? data : {};
+  const columns = Array.isArray(record.columns) ? record.columns.map((item) => String(item)) : [];
+  const rows = Array.isArray(record.rows) ? record.rows : [];
+  return {
+    columns,
+    rows,
+    rowCount: Number((_a2 = record.rowCount) != null ? _a2 : rows.length)
+  };
+}
+function parseExecBatchResult(data) {
+  var _a2;
+  const record = data != null ? data : {};
+  const results = Array.isArray(record.results) ? record.results.map((item) => parseExecResult(item)) : [];
+  return {
+    count: Number((_a2 = record.count) != null ? _a2 : results.length),
+    results
+  };
+}
+var Db = class {
+  /**
+   * 执行异步调用
+   */
+  async asyncCall(method, args, timeout = 30) {
+    const uuid = generateUUID();
+    const params = {
+      method,
+      arguments: args ? args : void 0,
+      callbackId: uuid
+    };
+    const promise = new Promise((resolve) => {
+      callbacks11.set(uuid, (data) => {
+        resolve(data);
+      });
+      setTimeout(() => {
+        callbacks11.delete(uuid);
+        resolve(JSON.stringify(new CallResponse(0, null, uuid)));
+      }, timeout * 1e3);
+    });
+    window.assistsxDb.call(JSON.stringify(params));
+    const promiseResult = await promise;
+    if (typeof promiseResult !== "string") {
+      throw new Error("Db call failed");
+    }
+    const responseData = JSON.parse(promiseResult);
+    if (responseData.code !== 0) {
+      throw new Error(responseData.message || "Db call failed");
+    }
+    return new CallResponse(
+      responseData.code,
+      responseData.data,
+      responseData.callbackId
+    );
+  }
+  /**
+   * 将 query 结果中的 Base64 BLOB 字段解码为 Uint8Array
+   */
+  decodeBlobBase64(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+  }
+  /**
+   * 执行非查询 SQL
+   */
+  async exec(sql, options) {
+    const { timeout = 30, bindArgs, ...target } = options;
+    const response = await this.asyncCall(
+      DbCallMethod.exec,
+      buildDbArguments(target, {
+        sql,
+        bindArgs: normalizeBindArgs(bindArgs)
+      }),
+      timeout
+    );
+    return parseExecResult(response.getDataOrNull());
+  }
+  /**
+   * 执行查询 SQL
+   */
+  async query(sql, options) {
+    const { timeout = 30, bindArgs, ...target } = options;
+    const response = await this.asyncCall(
+      DbCallMethod.query,
+      buildDbArguments(target, {
+        sql,
+        bindArgs: normalizeBindArgs(bindArgs)
+      }),
+      timeout
+    );
+    return parseQueryResult(response.getDataOrNull());
+  }
+  /**
+   * 事务内批量执行多条 SQL
+   */
+  async execBatch(statements, options) {
+    const { timeout = 30, ...target } = options;
+    const response = await this.asyncCall(
+      DbCallMethod.execBatch,
+      buildDbArguments(target, { statements }),
+      timeout
+    );
+    return parseExecBatchResult(response.getDataOrNull());
+  }
+  /**
+   * 关闭并释放指定数据库连接
+   */
+  async close(options) {
+    const { timeout = 30, ...target } = options;
+    await this.asyncCall(
+      DbCallMethod.close,
+      buildDbArguments(target),
+      timeout
+    );
+  }
+};
+var db = new Db();
+
 // src/barutils/bar-utils-call-method.ts
 var BarUtilsCallMethod = {
   // Status bar
@@ -7100,7 +7559,7 @@ var BarUtilsCallMethod = {
 };
 
 // src/barutils/bar-utils.ts
-var callbacks10 = /* @__PURE__ */ new Map();
+var callbacks12 = /* @__PURE__ */ new Map();
 if (typeof window !== "undefined" && !window.assistsxBarUtilsCallback) {
   window.assistsxBarUtilsCallback = (data) => {
     let callbackId;
@@ -7109,7 +7568,7 @@ if (typeof window !== "undefined" && !window.assistsxBarUtilsCallback) {
       const response = JSON.parse(json);
       callbackId = response.callbackId;
       if (callbackId) {
-        const callback = callbacks10.get(callbackId);
+        const callback = callbacks12.get(callbackId);
         if (callback) {
           callback(json);
         }
@@ -7118,7 +7577,7 @@ if (typeof window !== "undefined" && !window.assistsxBarUtilsCallback) {
       console.error("BarUtils callback error:", e);
     } finally {
       if (callbackId) {
-        callbacks10.delete(callbackId);
+        callbacks12.delete(callbackId);
       }
     }
   };
@@ -7132,11 +7591,11 @@ var BarUtils = class {
       callbackId: uuid
     };
     const promise = new Promise((resolve) => {
-      callbacks10.set(uuid, (data) => {
+      callbacks12.set(uuid, (data) => {
         resolve(data);
       });
       setTimeout(() => {
-        callbacks10.delete(uuid);
+        callbacks12.delete(uuid);
         resolve(
           JSON.stringify(
             new CallResponse(-1, { message: "Timeout" }, uuid)
@@ -7417,7 +7876,7 @@ var FloatCallMethod = {
 };
 
 // src/floatingwindow/float.ts
-var callbacks11 = /* @__PURE__ */ new Map();
+var callbacks13 = /* @__PURE__ */ new Map();
 if (typeof window !== "undefined" && !window.assistsxFloatCallback) {
   window.assistsxFloatCallback = (data) => {
     let callbackId;
@@ -7426,7 +7885,7 @@ if (typeof window !== "undefined" && !window.assistsxFloatCallback) {
       const response = JSON.parse(json);
       callbackId = response.callbackId;
       if (callbackId) {
-        const callback = callbacks11.get(callbackId);
+        const callback = callbacks13.get(callbackId);
         if (callback) {
           callback(json);
         }
@@ -7435,7 +7894,7 @@ if (typeof window !== "undefined" && !window.assistsxFloatCallback) {
       console.error("Float callback error:", e);
     } finally {
       if (callbackId) {
-        callbacks11.delete(callbackId);
+        callbacks13.delete(callbackId);
       }
     }
   };
@@ -7449,11 +7908,11 @@ var Float = class {
       callbackId: uuid
     };
     const promise = new Promise((resolve) => {
-      callbacks11.set(uuid, (data) => {
+      callbacks13.set(uuid, (data) => {
         resolve(data);
       });
       setTimeout(() => {
-        callbacks11.delete(uuid);
+        callbacks13.delete(uuid);
         resolve(
           JSON.stringify(
             new CallResponse(-1, { message: "Timeout" }, uuid)
@@ -7615,7 +8074,9 @@ var LogCallMethod = {
   unsubscribe: "unsubscribe",
   uploadLogs: "uploadLogs",
   /** 获取日志服务当前域名（origin，无路径；与上传、管理后台同源），对应 AssistsLogDiagnostics.adminWebBaseUrl() */
-  getLogServiceBaseUrl: "getLogServiceBaseUrl"
+  getLogServiceBaseUrl: "getLogServiceBaseUrl",
+  /** 解析日志文件绝对路径（不创建文件） */
+  resolveLogPath: "resolveLogPath"
 };
 var LogStream = {
   latestLine: "latestLine",
@@ -7626,6 +8087,26 @@ var LogStream = {
 var pendingCallbacks = /* @__PURE__ */ new Map();
 var streamHandlers = /* @__PURE__ */ new Map();
 var subscriptionIdToCallbackId = /* @__PURE__ */ new Map();
+function buildLogArguments(target, extra) {
+  const args = { ...extra };
+  if ((target == null ? void 0 : target.dirPath) !== void 0) {
+    args.dirPath = target.dirPath;
+  }
+  if ((target == null ? void 0 : target.fileName) !== void 0) {
+    args.fileName = target.fileName;
+  }
+  return Object.keys(args).length > 0 ? args : void 0;
+}
+function resolveTimeout(timeoutOrOptions, fallback = 30) {
+  var _a2;
+  if (typeof timeoutOrOptions === "number") {
+    return { timeout: timeoutOrOptions };
+  }
+  return {
+    timeout: (_a2 = timeoutOrOptions == null ? void 0 : timeoutOrOptions.timeout) != null ? _a2 : fallback,
+    target: timeoutOrOptions
+  };
+}
 if (typeof window !== "undefined" && !window.assistsxLogCallback) {
   window.assistsxLogCallback = (data) => {
     try {
@@ -7701,11 +8182,12 @@ var Log = class {
     throw new Error("Log bridge call failed");
   }
   /** 读取当前日志全文 */
-  async readAllText(timeout) {
+  async readAllText(timeoutOrOptions) {
     var _a2;
+    const { timeout, target } = resolveTimeout(timeoutOrOptions);
     const res = await this.asyncCall(
       LogCallMethod.readAllText,
-      void 0,
+      buildLogArguments(target),
       timeout
     );
     const d = res.getDataOrNull();
@@ -7725,42 +8207,69 @@ var Log = class {
     const d = res.getDataOrNull();
     return (_a2 = d == null ? void 0 : d.baseUrl) != null ? _a2 : "";
   }
+  /**
+   * 解析日志文件绝对路径（不创建文件）。
+   * AssistsX 插件环境下会经原生拦截追加 log-{packageName} 子目录。
+   */
+  async resolveLogPath(targetOrOptions) {
+    var _a2;
+    const { timeout, target } = resolveTimeout(targetOrOptions);
+    const res = await this.asyncCall(
+      LogCallMethod.resolveLogPath,
+      buildLogArguments(target),
+      timeout
+    );
+    const d = res.getDataOrNull();
+    return (_a2 = d == null ? void 0 : d.logFilePath) != null ? _a2 : "";
+  }
   /** 清空日志 */
-  async clear(timeout) {
+  async clear(timeoutOrOptions) {
+    const { timeout, target } = resolveTimeout(timeoutOrOptions);
     const res = await this.asyncCall(
       LogCallMethod.clear,
-      void 0,
+      buildLogArguments(target),
       timeout
     );
     return res.isSuccess();
   }
   /** 从文件重新加载到内存 Flow */
-  async refreshFromFile(timeout) {
+  async refreshFromFile(timeoutOrOptions) {
+    const { timeout, target } = resolveTimeout(timeoutOrOptions);
     const res = await this.asyncCall(
       LogCallMethod.refreshFromFile,
-      void 0,
+      buildLogArguments(target),
       timeout
     );
     return res.isSuccess();
   }
   /** 追加一行 */
-  async appendLine(line, maxLength, timeout) {
-    const args = { line };
-    if (maxLength !== void 0) {
-      args.maxLength = maxLength;
+  async appendLine(line, maxLengthOrOptions, timeout) {
+    var _a2;
+    let options;
+    if (typeof maxLengthOrOptions === "number") {
+      options = { maxLength: maxLengthOrOptions, timeout };
+    } else {
+      options = maxLengthOrOptions;
+    }
+    const args = (_a2 = buildLogArguments(options, { line })) != null ? _a2 : { line };
+    if ((options == null ? void 0 : options.maxLength) !== void 0) {
+      args.maxLength = options.maxLength;
     }
     const res = await this.asyncCall(
       LogCallMethod.appendLine,
       args,
-      timeout
+      options == null ? void 0 : options.timeout
     );
     return res.isSuccess();
   }
   /** 追加带时间戳的条目 */
-  async appendTimestampedEntry(message, timeout) {
+  async appendTimestampedEntry(message, timeoutOrOptions) {
+    var _a2;
+    const { timeout, target } = resolveTimeout(timeoutOrOptions);
+    const args = (_a2 = buildLogArguments(target, { message })) != null ? _a2 : { message };
     const res = await this.asyncCall(
       LogCallMethod.appendTimestampedEntry,
-      { message },
+      args,
       timeout
     );
     return res.isSuccess();
@@ -7770,17 +8279,20 @@ var Log = class {
    * 默认带时间戳；`timestamped: false` 时走 appendLine。
    */
   async append(text, options) {
-    const { timestamped = true, maxLength, timeout } = options != null ? options : {};
+    const { timestamped = true, maxLength, timeout, ...target } = options != null ? options : {};
     if (timestamped) {
-      return this.appendTimestampedEntry(text, timeout);
+      return this.appendTimestampedEntry(text, { ...target, timeout });
     }
-    return this.appendLine(text, maxLength, timeout);
+    return this.appendLine(text, { ...target, maxLength, timeout });
   }
   /** 替换全部内容 */
-  async replaceAll(content, timeout) {
+  async replaceAll(content, timeoutOrOptions) {
+    var _a2;
+    const { timeout, target } = resolveTimeout(timeoutOrOptions);
+    const args = (_a2 = buildLogArguments(target, { content })) != null ? _a2 : { content };
     const res = await this.asyncCall(
       LogCallMethod.replaceAll,
-      { content },
+      args,
       timeout
     );
     return res.isSuccess();
@@ -7790,10 +8302,11 @@ var Log = class {
    * resolve 后请保留 dispose 或调用 unsubscribe(subscriptionId) 以释放原生协程与 JS 回调。
    */
   async subscribe(stream, onUpdate, options) {
-    var _a2;
+    var _a2, _b;
     const self = this;
     const callbackId = generateUUID();
     const timeoutSec = (_a2 = options == null ? void 0 : options.timeout) != null ? _a2 : 30;
+    const subscribeArgs = (_b = buildLogArguments(options, { stream })) != null ? _b : { stream };
     return new Promise((resolve, reject) => {
       let settled = false;
       const timer = setTimeout(() => {
@@ -7804,7 +8317,7 @@ var Log = class {
         }
       }, timeoutSec * 1e3);
       streamHandlers.set(callbackId, (raw) => {
-        var _a3, _b, _c;
+        var _a3, _b2, _c;
         let response;
         try {
           response = JSON.parse(raw);
@@ -7843,9 +8356,10 @@ var Log = class {
         }
         if ((data == null ? void 0 : data.event) === "update" && data.subscriptionId) {
           onUpdate({
-            text: (_b = data.text) != null ? _b : "",
+            text: (_b2 = data.text) != null ? _b2 : "",
             stream: (_c = data.stream) != null ? _c : stream,
-            subscriptionId: data.subscriptionId
+            subscriptionId: data.subscriptionId,
+            logFilePath: data.logFilePath
           });
         }
       });
@@ -7853,7 +8367,7 @@ var Log = class {
         this.getBridge().call(
           JSON.stringify({
             method: LogCallMethod.subscribe,
-            arguments: { stream },
+            arguments: subscribeArgs,
             callbackId
           })
         );
@@ -7897,6 +8411,12 @@ var Log = class {
     if (args.uploadKey !== void 0) {
       payload.uploadKey = args.uploadKey;
     }
+    if (args.dirPath !== void 0) {
+      payload.dirPath = args.dirPath;
+    }
+    if (args.fileName !== void 0) {
+      payload.fileName = args.fileName;
+    }
     const uuid = generateUUID();
     const params = {
       method: LogCallMethod.uploadLogs,
@@ -7951,6 +8471,8 @@ export {
   Bounds,
   CallMethod,
   CallResponse,
+  Db,
+  DbCallMethod,
   DeviceInfo,
   FileIO,
   FileUtils,
@@ -7972,6 +8494,9 @@ export {
   NodeAsync,
   NodeClassValue,
   Path,
+  PluginInfo,
+  Screenshot,
+  ScreenshotCallMethod,
   Step,
   StepAsync,
   StepError,
@@ -7980,6 +8505,7 @@ export {
   accessibilityEventListeners,
   barUtils,
   callbacks,
+  db,
   decodeBase64UTF8,
   ensureAssistsXPinia,
   fileIO,
@@ -7995,6 +8521,7 @@ export {
   mlkit,
   pathUtils,
   screen,
+  screenshot,
   sleep,
   useStepStore
 };