assistsx-js 0.1.23 → 0.1.25

package/dist/AssistsXAsync.d.ts

@@ -118,6 +118,23 @@ export declare class AssistsXAsync {
         overlayHiddenScreenshotDelayMillis?: number;
         timeout?: number;
     }): Promise<string>;
+    /**
+     * 保存截图到文件（支持多个节点）
+     * @param options 截图保存选项
+     * @param options.nodes 要截图的节点数组（可选，不提供则保存全屏截图）
+     * @param options.filePath 文件路径（可选，不提供则自动生成。多个节点时会自动添加索引后缀）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @returns 保存的文件路径数组
+     */
+    static takeScreenshotToFile(options?: {
+        nodes?: Node[];
+        filePath?: string;
+        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
+        overlayHiddenScreenshotDelayMillis?: number;
+        timeout?: number;
+    }): Promise<string[]>;
     /**
      * 截图识别文本
      * @param param0 识别参数

package/dist/AssistsXAsync.js

@@ -146,6 +146,34 @@ export class AssistsXAsync {
         const data = response.getDataOrDefault({ file: "" });
         return data.file;
     }
+    /**
+     * 保存截图到文件（支持多个节点）
+     * @param options 截图保存选项
+     * @param options.nodes 要截图的节点数组（可选，不提供则保存全屏截图）
+     * @param options.filePath 文件路径（可选，不提供则自动生成。多个节点时会自动添加索引后缀）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @returns 保存的文件路径数组
+     */
+    static async takeScreenshotToFile(options = {}) {
+        const { nodes, filePath, format = "PNG", overlayHiddenScreenshotDelayMillis = 250, timeout, } = options;
+        const response = await this.asyncCall(CallMethod.takeScreenshotToFile, {
+            nodes,
+            args: {
+                filePath,
+                format,
+                overlayHiddenScreenshotDelayMillis,
+            },
+            timeout,
+        });
+        const data = response.getDataOrDefault({ files: [] });
+        if (!Array.isArray(data.files)) {
+            throw new Error(`AssistsXAsync.takeScreenshotToFile: Expected files array, but got ${typeof data.files}. ` +
+                `Value: ${JSON.stringify(data.files)}`);
+        }
+        return data.files;
+    }
     /**
      * 截图识别文本
      * @param param0 识别参数

package/dist/CallMethod.d.ts

@@ -1,6 +1,7 @@
 export declare const CallMethod: {
     readonly takeScreenshot: "takeScreenshot";
     readonly takeScreenshotSave: "takeScreenshotSave";
+    readonly takeScreenshotToFile: "takeScreenshotToFile";
     readonly overlayToast: "overlayToast";
     readonly setNodeText: "setNodeText";
     readonly findByTags: "findByTags";

package/dist/CallMethod.js

@@ -2,6 +2,7 @@
 export const CallMethod = {
     takeScreenshot: "takeScreenshot",
     takeScreenshotSave: "takeScreenshotSave",
+    takeScreenshotToFile: "takeScreenshotToFile",
     overlayToast: "overlayToast",
     setNodeText: "setNodeText",
     findByTags: "findByTags",

package/dist/Node.d.ts

@@ -219,6 +219,19 @@ export declare class Node {
      * @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 要设置的文本

package/dist/Node.js

@@ -4,6 +4,7 @@
  */
 import { Bounds } from "./Bounds";
 import { AssistsX } from "./AssistsX";
+import { AssistsXAsync } from "./AssistsXAsync";
 import { Step } from "./Step";
 import { NodeAsync } from "./NodeAsync";
 // 将接口改造为类
@@ -208,6 +209,23 @@ export class Node {
         Step.assert(this.stepId);
         return result[0];
     }
+    /**
+     * 保存节点截图到文件
+     * @param options 截图保存选项
+     * @param options.filePath 文件路径（可选，不提供则自动生成）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @returns 保存的文件路径
+     */
+    async takeScreenshotToFile(options = {}) {
+        Step.assert(this.stepId);
+        const result = await AssistsXAsync.takeScreenshotToFile({
+            nodes: [this],
+            ...options,
+        });
+        Step.assert(this.stepId);
+        return result[0];
+    }
     /**
      * 设置节点文本
      * @param text 要设置的文本

package/dist/network/http.d.ts

@@ -23,6 +23,7 @@ export interface HttpDownloadResponse {
     statusMessage: string;
     savePath: string;
     fileSize: number;
+    saveToGallerySuccess?: boolean;
     headers: Record<string, string>;
 }
 /**
@@ -94,10 +95,11 @@ export declare class Http {
      * @param url 下载 URL
      * @param savePath 保存路径
      * @param headers 请求头
+     * @param saveToGallery 是否保存到系统相册（仅支持图片和视频文件），默认 false
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<下载响应>
      */
-    httpDownload(url: string, savePath: string, headers?: Record<string, string>, timeout?: number): Promise<HttpDownloadResponse>;
+    httpDownload(url: string, savePath: string, headers?: Record<string, string>, saveToGallery?: boolean, timeout?: number): Promise<HttpDownloadResponse>;
     /**
      * 配置 OkHttpClient
      * @param config 配置选项

package/dist/network/http.js

@@ -144,12 +144,13 @@ export class Http {
      * @param url 下载 URL
      * @param savePath 保存路径
      * @param headers 请求头
+     * @param saveToGallery 是否保存到系统相册（仅支持图片和视频文件），默认 false
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<下载响应>
      */
-    async httpDownload(url, savePath, headers, timeout) {
+    async httpDownload(url, savePath, headers, saveToGallery, timeout) {
         var _a;
-        const response = await this.asyncCall("httpDownload", { url, savePath, headers }, timeout);
+        const response = await this.asyncCall("httpDownload", { url, savePath, headers, saveToGallery }, timeout);
         if (!response.isSuccess()) {
             throw new Error(((_a = response.data) === null || _a === void 0 ? void 0 : _a.message) || "HTTP download failed");
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "assistsx-js",
-    "version": "0.1.23",
+    "version": "0.1.25",
     "description": "assistsx-js自动化开发SDK",
     "main": "dist/index.js",
     "module": "dist/index.js",

package/src/AssistsXAsync.ts

@@ -254,6 +254,52 @@ export class AssistsXAsync {
         return data.file;
     }
 
+    /**
+     * 保存截图到文件（支持多个节点）
+     * @param options 截图保存选项
+     * @param options.nodes 要截图的节点数组（可选，不提供则保存全屏截图）
+     * @param options.filePath 文件路径（可选，不提供则自动生成。多个节点时会自动添加索引后缀）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @returns 保存的文件路径数组
+     */
+    public static async takeScreenshotToFile(
+        options: {
+            nodes?: Node[];
+            filePath?: string;
+            format?: "PNG" | "JPEG" | "JPG" | "WEBP";
+            overlayHiddenScreenshotDelayMillis?: number;
+            timeout?: number;
+        } = {}
+    ): Promise<string[]> {
+        const {
+            nodes,
+            filePath,
+            format = "PNG",
+            overlayHiddenScreenshotDelayMillis = 250,
+            timeout,
+        } = options;
+
+        const response = await this.asyncCall(CallMethod.takeScreenshotToFile, {
+            nodes,
+            args: {
+                filePath,
+                format,
+                overlayHiddenScreenshotDelayMillis,
+            },
+            timeout,
+        });
+        const data = response.getDataOrDefault({ files: [] });
+        if (!Array.isArray(data.files)) {
+            throw new Error(
+                `AssistsXAsync.takeScreenshotToFile: Expected files array, but got ${typeof data.files}. ` +
+                `Value: ${JSON.stringify(data.files)}`
+            );
+        }
+        return data.files;
+    }
+
     /**
      * 截图识别文本
      * @param param0 识别参数

package/src/CallMethod.ts

@@ -2,6 +2,7 @@
 export const CallMethod = {
     takeScreenshot: "takeScreenshot",
     takeScreenshotSave: "takeScreenshotSave",
+    takeScreenshotToFile: "takeScreenshotToFile",
     overlayToast: "overlayToast",
     setNodeText: "setNodeText",
     findByTags: "findByTags",

package/src/Node.ts

@@ -4,6 +4,7 @@
  */
 import { Bounds } from "./Bounds";
 import { AssistsX } from "./AssistsX";
+import { AssistsXAsync } from "./AssistsXAsync";
 import { Step } from "./Step";
 import { NodeAsync } from "./NodeAsync";
 
@@ -401,6 +402,29 @@ export class Node {
         Step.assert(this.stepId);
         return result[0];
     }
+    /**
+     * 保存节点截图到文件
+     * @param options 截图保存选项
+     * @param options.filePath 文件路径（可选，不提供则自动生成）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @returns 保存的文件路径
+     */
+    public async takeScreenshotToFile(
+        options: {
+            filePath?: string;
+            format?: "PNG" | "JPEG" | "JPG" | "WEBP";
+            overlayHiddenScreenshotDelayMillis?: number;
+        } = {}
+    ): Promise<string> {
+        Step.assert(this.stepId);
+        const result = await AssistsXAsync.takeScreenshotToFile({
+            nodes: [this],
+            ...options,
+        });
+        Step.assert(this.stepId);
+        return result[0];
+    }
     /**
      * 设置节点文本
      * @param text 要设置的文本

package/src/network/http.ts

@@ -32,6 +32,7 @@ export interface HttpDownloadResponse {
     statusMessage: string;
     savePath: string;
     fileSize: number;
+    saveToGallerySuccess?: boolean;
     headers: Record<string, string>;
 }
 
@@ -223,6 +224,7 @@ export class Http {
      * @param url 下载 URL
      * @param savePath 保存路径
      * @param headers 请求头
+     * @param saveToGallery 是否保存到系统相册（仅支持图片和视频文件），默认 false
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<下载响应>
      */
@@ -230,11 +232,12 @@ export class Http {
         url: string,
         savePath: string,
         headers?: Record<string, string>,
+        saveToGallery?: boolean,
         timeout?: number
     ): Promise<HttpDownloadResponse> {
         const response = await this.asyncCall(
             "httpDownload",
-            { url, savePath, headers },
+            { url, savePath, headers, saveToGallery },
             timeout
         );
         if (!response.isSuccess()) {