assistsx-js 0.0.3009 → 0.1.2

package/dist/AssistsXAsync.d.ts

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

package/dist/AssistsXAsync.js

@@ -124,6 +124,28 @@ export class AssistsXAsync {
         const data = response.getDataOrDefault({ images: [] });
         return data.images;
     }
+    /**
+     * 保存全屏截图到文件
+     * @param options 截图保存选项
+     * @param options.filePath 文件路径（可选，不提供则自动生成）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @returns 保存的文件路径
+     */
+    static async takeScreenshotSave(options = {}) {
+        const { filePath, format = "PNG", overlayHiddenScreenshotDelayMillis = 250, timeout, } = options;
+        const response = await this.asyncCall(CallMethod.takeScreenshotSave, {
+            args: {
+                filePath,
+                format,
+                overlayHiddenScreenshotDelayMillis,
+            },
+            timeout,
+        });
+        const data = response.getDataOrDefault({ file: "" });
+        return data.file;
+    }
     /**
      * 截图识别文本
      * @param param0 识别参数

package/dist/CallMethod.d.ts

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

package/dist/CallMethod.js

@@ -1,6 +1,7 @@
 // CallMethod 常量对象
 export const CallMethod = {
     takeScreenshot: "takeScreenshot",
+    takeScreenshotSave: "takeScreenshotSave",
     overlayToast: "overlayToast",
     setNodeText: "setNodeText",
     findByTags: "findByTags",

package/dist/network/http.d.ts

@@ -25,6 +25,15 @@ export interface HttpDownloadResponse {
     fileSize: number;
     headers: Record<string, string>;
 }
+/**
+ * 文件上传信息接口定义
+ */
+export interface FileUploadInfo {
+    filePath: string;
+    fieldName?: string;
+    fileName?: string;
+    contentType?: string;
+}
 export declare class Http {
     /**
      * 执行异步调用
@@ -53,16 +62,33 @@ export declare class Http {
     httpPost(url: string, body: string, headers?: Record<string, string>, timeout?: number): Promise<HttpResponse>;
     /**
      * 执行文件上传 POST 请求
-     * @param url 请求 URL
-     * @param filePath 文件路径
-     * @param fieldName 表单字段名，默认为 "file"
-     * @param fileName 文件名，如果不提供则使用文件路径中的文件名
-     * @param formData 其他表单数据
-     * @param headers 请求头
+     * 支持单个文件和多文件上传，同时支持多个表单字段
+     *
+     * @param url 请求 URL（必需）
+     * @param files 文件数组（必需），每个文件对象包含：
+     *   - filePath: 文件路径（必需）
+     *   - fieldName: 字段名（可选，默认 "file"）
+     *   - fileName: 文件名（可选，默认使用文件原名）
+     *   - contentType: 文件类型（可选，默认 "application/octet-stream"）
+     * @param formData 表单字段（可选），支持字符串值或字符串数组（同名字段多个值）
+     * @param headers 请求头（可选）
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<HTTP响应>
+     *
+     * @example
+     * // 单文件上传
+     * await http.httpPostFile("https://example.com/upload", [
+     *   { filePath: "/path/to/file.jpg", fieldName: "file" }
+     * ]);
+     *
+     * @example
+     * // 多文件上传
+     * await http.httpPostFile("https://example.com/upload", [
+     *   { filePath: "/path/to/file1.jpg", fieldName: "file1" },
+     *   { filePath: "/path/to/file2.jpg", fieldName: "file2" }
+     * ], { description: "My files" });
      */
-    httpPostFile(url: string, filePath: string, fieldName?: string, fileName?: string, formData?: Record<string, string>, headers?: Record<string, string>, timeout?: number): Promise<HttpResponse>;
+    httpPostFile(url: string, files: FileUploadInfo[], formData?: Record<string, string | string[]>, headers?: Record<string, string>, timeout?: number): Promise<HttpResponse>;
     /**
      * 下载文件
      * @param url 下载 URL

package/dist/network/http.js

@@ -96,18 +96,44 @@ export class Http {
     }
     /**
      * 执行文件上传 POST 请求
-     * @param url 请求 URL
-     * @param filePath 文件路径
-     * @param fieldName 表单字段名，默认为 "file"
-     * @param fileName 文件名，如果不提供则使用文件路径中的文件名
-     * @param formData 其他表单数据
-     * @param headers 请求头
+     * 支持单个文件和多文件上传，同时支持多个表单字段
+     *
+     * @param url 请求 URL（必需）
+     * @param files 文件数组（必需），每个文件对象包含：
+     *   - filePath: 文件路径（必需）
+     *   - fieldName: 字段名（可选，默认 "file"）
+     *   - fileName: 文件名（可选，默认使用文件原名）
+     *   - contentType: 文件类型（可选，默认 "application/octet-stream"）
+     * @param formData 表单字段（可选），支持字符串值或字符串数组（同名字段多个值）
+     * @param headers 请求头（可选）
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<HTTP响应>
+     *
+     * @example
+     * // 单文件上传
+     * await http.httpPostFile("https://example.com/upload", [
+     *   { filePath: "/path/to/file.jpg", fieldName: "file" }
+     * ]);
+     *
+     * @example
+     * // 多文件上传
+     * await http.httpPostFile("https://example.com/upload", [
+     *   { filePath: "/path/to/file1.jpg", fieldName: "file1" },
+     *   { filePath: "/path/to/file2.jpg", fieldName: "file2" }
+     * ], { description: "My files" });
      */
-    async httpPostFile(url, filePath, fieldName = "file", fileName, formData, headers, timeout) {
+    async httpPostFile(url, files, formData, headers, timeout) {
         var _a;
-        const response = await this.asyncCall("httpPostFile", { url, filePath, fieldName, fileName, formData, headers }, timeout);
+        if (!files || files.length === 0) {
+            throw new Error("files参数不能为空，至少需要上传一个文件");
+        }
+        // 验证每个文件对象
+        for (const file of files) {
+            if (!file.filePath) {
+                throw new Error("files数组中的filePath参数不能为空");
+            }
+        }
+        const response = await this.asyncCall("httpPostFile", { url, files, formData, headers }, timeout);
         if (!response.isSuccess()) {
             throw new Error(((_a = response.data) === null || _a === void 0 ? void 0 : _a.message) || "HTTP POST file request failed");
         }

package/package.json

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

package/src/AssistsXAsync.ts

@@ -217,6 +217,43 @@ export class AssistsXAsync {
         const data = response.getDataOrDefault({ images: [] });
         return data.images;
     }
+
+    /**
+     * 保存全屏截图到文件
+     * @param options 截图保存选项
+     * @param options.filePath 文件路径（可选，不提供则自动生成）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @returns 保存的文件路径
+     */
+    public static async takeScreenshotSave(
+        options: {
+            filePath?: string;
+            format?: "PNG" | "JPEG" | "JPG" | "WEBP";
+            overlayHiddenScreenshotDelayMillis?: number;
+            timeout?: number;
+        } = {}
+    ): Promise<string> {
+        const {
+            filePath,
+            format = "PNG",
+            overlayHiddenScreenshotDelayMillis = 250,
+            timeout,
+        } = options;
+
+        const response = await this.asyncCall(CallMethod.takeScreenshotSave, {
+            args: {
+                filePath,
+                format,
+                overlayHiddenScreenshotDelayMillis,
+            },
+            timeout,
+        });
+        const data = response.getDataOrDefault({ file: "" });
+        return data.file;
+    }
+
     /**
      * 截图识别文本
      * @param param0 识别参数

package/src/CallMethod.ts

@@ -1,6 +1,7 @@
 // CallMethod 常量对象
 export const CallMethod = {
     takeScreenshot: "takeScreenshot",
+    takeScreenshotSave: "takeScreenshotSave",
     overlayToast: "overlayToast",
     setNodeText: "setNodeText",
     findByTags: "findByTags",

package/src/network/http.ts

@@ -35,6 +35,16 @@ export interface HttpDownloadResponse {
     headers: Record<string, string>;
 }
 
+/**
+ * 文件上传信息接口定义
+ */
+export interface FileUploadInfo {
+    filePath: string;
+    fieldName?: string;
+    fileName?: string;
+    contentType?: string;
+}
+
 // 回调函数存储对象
 const callbacks: Map<string, (data: string) => void> = new Map();
 
@@ -153,27 +163,53 @@ export class Http {
 
     /**
      * 执行文件上传 POST 请求
-     * @param url 请求 URL
-     * @param filePath 文件路径
-     * @param fieldName 表单字段名，默认为 "file"
-     * @param fileName 文件名，如果不提供则使用文件路径中的文件名
-     * @param formData 其他表单数据
-     * @param headers 请求头
+     * 支持单个文件和多文件上传，同时支持多个表单字段
+     * 
+     * @param url 请求 URL（必需）
+     * @param files 文件数组（必需），每个文件对象包含：
+     *   - filePath: 文件路径（必需）
+     *   - fieldName: 字段名（可选，默认 "file"）
+     *   - fileName: 文件名（可选，默认使用文件原名）
+     *   - contentType: 文件类型（可选，默认 "application/octet-stream"）
+     * @param formData 表单字段（可选），支持字符串值或字符串数组（同名字段多个值）
+     * @param headers 请求头（可选）
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<HTTP响应>
+     * 
+     * @example
+     * // 单文件上传
+     * await http.httpPostFile("https://example.com/upload", [
+     *   { filePath: "/path/to/file.jpg", fieldName: "file" }
+     * ]);
+     * 
+     * @example
+     * // 多文件上传
+     * await http.httpPostFile("https://example.com/upload", [
+     *   { filePath: "/path/to/file1.jpg", fieldName: "file1" },
+     *   { filePath: "/path/to/file2.jpg", fieldName: "file2" }
+     * ], { description: "My files" });
      */
     async httpPostFile(
         url: string,
-        filePath: string,
-        fieldName: string = "file",
-        fileName?: string,
-        formData?: Record<string, string>,
+        files: FileUploadInfo[],
+        formData?: Record<string, string | string[]>,
         headers?: Record<string, string>,
         timeout?: number
     ): Promise<HttpResponse> {
+        if (!files || files.length === 0) {
+            throw new Error("files参数不能为空，至少需要上传一个文件");
+        }
+
+        // 验证每个文件对象
+        for (const file of files) {
+            if (!file.filePath) {
+                throw new Error("files数组中的filePath参数不能为空");
+            }
+        }
+
         const response = await this.asyncCall(
             "httpPostFile",
-            { url, filePath, fieldName, fileName, formData, headers },
+            { url, files, formData, headers },
             timeout
         );
         if (!response.isSuccess()) {