files 能力增强与 vision 校验修复；落盘 rpa-core 抽离改造任务清单与开发规范

resources/catalog-overrides.json

@@ -231,24 +231,67 @@
   "Image_Move_V2": {
     "fields": {
       "window_obj": {
-        "description": "目标窗口对象；留空则作用于当前活动窗口"
+        "label": "窗口标题/对象",
+        "description": "查找范围为「指定窗口」时必填：可填窗口完整标题、标题关键字或进程名；点「选窗口」从可见窗口列表中选择。",
+        "placeholder": "选择窗口或填写标题/进程名"
       },
       "action": {
-        "description": "区域坐标 JSON；点右侧「屏幕框选」在屏幕上框选生成",
+        "label": "查找区域",
+        "description": "查找范围为「指定屏幕范围」时使用：点右侧「屏幕框选」生成区域坐标 JSON。",
         "placeholder": "{\"x\":0,\"y\":0,\"width\":100,\"height\":50}"
       },
       "shot_position": {
-        "description": "区域坐标 JSON；点右侧「屏幕框选」在屏幕上框选生成",
+        "label": "查找区域",
+        "description": "查找范围为「指定屏幕范围」时使用：点右侧「屏幕框选」生成区域坐标 JSON。",
         "placeholder": "{\"x\":0,\"y\":0,\"width\":100,\"height\":50}"
       },
       "image": {
-        "description": "图片文件的完整路径，用于匹配或识别；点右侧按钮选择文件"
+        "description": "要查找的小图模板路径；建议只框选按钮、图标或文字块等目标图案，不要框整屏大图。"
       },
       "position": {
-        "description": "相对目标的点击位置（中心、左上角等）"
+        "description": "命中目标图像后，鼠标移动到目标区域的哪个位置。",
+        "options": [
+          {
+            "label": "左上",
+            "value": "leftTop"
+          },
+          {
+            "label": "右上",
+            "value": "rightTop"
+          },
+          {
+            "label": "左下",
+            "value": "leftBottom"
+          },
+          {
+            "label": "右下",
+            "value": "rightBottom"
+          },
+          {
+            "label": "中心",
+            "value": "center"
+          }
+        ]
       },
       "show_track": {
-        "description": "勾选后运行时显示鼠标移动轨迹动画，便于观察执行过程"
+        "description": "开启后鼠标按轨迹移动到目标位置；关闭后直接跳到目标位置。"
+      },
+      "find_range": {
+        "description": "选择模板图片的查找范围：整个屏幕、指定窗口，或先框选一块屏幕区域后只在该区域内查找。",
+        "options": [
+          {
+            "label": "整个屏幕",
+            "value": "1"
+          },
+          {
+            "label": "指定窗口",
+            "value": "2"
+          },
+          {
+            "label": "指定屏幕范围",
+            "value": "3"
+          }
+        ]
       }
     }
   },
@@ -294,18 +337,43 @@
   "Image_Wait_V1": {
     "fields": {
       "window_obj": {
-        "description": "目标窗口对象；留空则作用于当前活动窗口"
+        "label": "窗口标题/对象",
+        "description": "查找范围为「指定窗口」时必填：可填窗口完整标题、标题关键字或进程名；点「选窗口」从可见窗口列表中选择。",
+        "placeholder": "选择窗口或填写标题/进程名"
       },
       "action": {
-        "description": "区域坐标 JSON；点右侧「屏幕框选」在屏幕上框选生成",
+        "label": "查找区域",
+        "description": "查找范围为「指定屏幕范围」时使用：点右侧「屏幕框选」生成区域坐标 JSON。",
         "placeholder": "{\"x\":0,\"y\":0,\"width\":100,\"height\":50}"
       },
       "position": {
-        "description": "区域坐标 JSON；点右侧「屏幕框选」在屏幕上框选生成",
+        "label": "查找区域",
+        "description": "查找范围为「指定屏幕范围」时使用：点右侧「屏幕框选」生成区域坐标 JSON。",
         "placeholder": "{\"x\":0,\"y\":0,\"width\":100,\"height\":50}"
       },
       "image": {
-        "description": "图片文件的完整路径，用于匹配或识别；点右侧按钮选择文件"
+        "description": "要查找的小图模板路径；建议只框选按钮、图标或文字块等目标图案，不要框整屏大图。"
+      },
+      "find_range": {
+        "description": "选择模板图片的查找范围：整个屏幕、指定窗口，或先框选一块屏幕区域后只在该区域内查找。",
+        "options": [
+          {
+            "label": "整个屏幕",
+            "value": "1"
+          },
+          {
+            "label": "指定窗口",
+            "value": "2"
+          },
+          {
+            "label": "指定屏幕范围",
+            "value": "3"
+          }
+        ]
+      },
+      "time_out": {
+        "description": "等待目标图像出现的秒数；默认 20 秒。",
+        "placeholder": "20"
       }
     }
   },
@@ -1229,5 +1297,54 @@
         "description": "使用的识别引擎类型"
       }
     }
+  },
+  "File_CompressFile": {
+    "fields": {
+      "file_type": {
+        "label": "待压缩内容",
+        "description": "选择要压缩的对象类型：单个文件或文件夹。"
+      },
+      "file_path": {
+        "label": "待压缩文件",
+        "description": "待压缩的单个文件完整路径；仅在「待压缩内容=文件」时使用。",
+        "placeholder": "选择或输入待压缩文件，例如 C:\\desktop\\report.docx"
+      },
+      "folder_path": {
+        "label": "待压缩文件夹",
+        "description": "待压缩的文件夹完整路径；仅在「待压缩内容=文件夹」时使用。",
+        "placeholder": "选择或输入待压缩文件夹，例如 C:\\desktop\\reports"
+      },
+      "direct_type": {
+        "label": "压缩包保存位置",
+        "description": "「源文件路径」表示自动保存到待压缩对象所在目录；「其他路径」表示使用下方指定的输出位置。同名压缩包不会覆盖，会自动生成副本。"
+      },
+      "out_path": {
+        "label": "压缩包输出位置",
+        "description": "选择输出文件夹，或填写以 .zip 结尾的完整压缩包路径；仅在「压缩包保存位置=其他路径」时使用。",
+        "placeholder": "选择输出目录，或输入 C:\\desktop\\result.zip"
+      }
+    }
+  },
+  "File_DecompressFile": {
+    "fields": {
+      "folder_path": {
+        "label": "压缩包路径",
+        "description": "要解压的 .zip 文件完整路径。",
+        "placeholder": "选择或输入 C:\\desktop\\archive.zip"
+      },
+      "direct_type": {
+        "label": "解压目标位置",
+        "description": "「源文件路径」表示解压到压缩包所在目录；「其他路径」表示解压到下方指定的文件夹。"
+      },
+      "out_path": {
+        "label": "解压目标目录",
+        "description": "选择或输入解压结果保存的文件夹；仅在「解压目标位置=其他路径」时使用。",
+        "placeholder": "选择或输入 C:\\desktop\\archive-output"
+      },
+      "compress_tool": {
+        "label": "解压方式",
+        "description": "选择解压使用的执行方式；不确定时保持默认。"
+      }
+    }
   }
 }

resources/catalog.json

@@ -10,7 +10,7 @@
     "vendor": 997,
     "native": 16,
     "triggers": 3,
-    "fields": 4296
+    "fields": 4298
   },
   "groups": [
     {
@@ -58963,8 +58963,8 @@
           "displayType": "selectFile",
           "required": true,
           "defaultValue": "",
-          "placeholder": "请选择或输入压缩包路径",
-          "description": "选择或输入压缩包路径，例如 C:\\desktop\\实在智能.zip",
+          "placeholder": "选择或输入 C:\\desktop\\archive.zip",
+          "description": "要解压的 .zip 文件完整路径。",
           "advanced": false,
           "valueTypes": [
             "rpa_str_file",
@@ -58973,14 +58973,14 @@
         },
         {
           "key": "direct_type",
-          "label": "解压至",
+          "label": "解压目标位置",
           "widget": "radio",
           "type": "string",
           "displayType": "radioGroup",
           "required": false,
           "defaultValue": "1",
           "placeholder": "",
-          "description": "",
+          "description": "「源文件路径」表示解压到压缩包所在目录；「其他路径」表示解压到下方指定的文件夹。",
           "advanced": false,
           "valueTypes": [],
           "options": [
@@ -58996,14 +58996,14 @@
         },
         {
           "key": "out_path",
-          "label": "out_path",
+          "label": "解压目标目录",
           "widget": "folder",
           "type": "object",
           "displayType": "selectFile",
           "required": false,
           "defaultValue": "",
-          "placeholder": "请选择解压文件存放路径",
-          "description": "",
+          "placeholder": "选择或输入 C:\\desktop\\archive-output",
+          "description": "选择或输入解压结果保存的文件夹；仅在「解压目标位置=其他路径」时使用。",
           "advanced": false,
           "valueTypes": [
             "rpa_str_folder",
@@ -59041,14 +59041,14 @@
         },
         {
           "key": "compress_tool",
-          "label": "解压工具",
+          "label": "解压方式",
           "widget": "radio",
           "type": "string",
           "displayType": "radioGroup",
           "required": false,
           "defaultValue": "default",
           "placeholder": "",
-          "description": "",
+          "description": "选择解压使用的执行方式；不确定时保持默认。",
           "advanced": true,
           "valueTypes": [],
           "options": [
@@ -62112,7 +62112,7 @@
           "required": false,
           "defaultValue": "openFile",
           "placeholder": "",
-          "description": "选择或输入待压缩文件/文件夹路径，例如 C:\\desktop\\实在智能",
+          "description": "选择要压缩的对象类型：单个文件或文件夹。",
           "advanced": false,
           "valueTypes": [],
           "options": [
@@ -62128,14 +62128,14 @@
         },
         {
           "key": "file_path",
-          "label": "file_path",
+          "label": "待压缩文件",
           "widget": "file",
           "type": "object",
           "displayType": "multiSelectFileOrDir",
           "required": true,
           "defaultValue": "",
-          "placeholder": "请选择或输入压缩包路径",
-          "description": "请选择或输入压缩包路径。",
+          "placeholder": "选择或输入待压缩文件，例如 C:\\desktop\\report.docx",
+          "description": "待压缩的单个文件完整路径；仅在「待压缩内容=文件」时使用。",
           "advanced": false,
           "valueTypes": [
             "rpa_str"
@@ -62143,14 +62143,14 @@
         },
         {
           "key": "folder_path",
-          "label": "folder_path",
+          "label": "待压缩文件夹",
           "widget": "folder",
           "type": "object",
           "displayType": "multiSelectFileOrDir",
           "required": true,
           "defaultValue": "",
-          "placeholder": "请选择或输入压缩包路径",
-          "description": "请选择或输入压缩包路径。",
+          "placeholder": "选择或输入待压缩文件夹，例如 C:\\desktop\\reports",
+          "description": "待压缩的文件夹完整路径；仅在「待压缩内容=文件夹」时使用。",
           "advanced": false,
           "valueTypes": [
             "rpa_str"
@@ -62158,14 +62158,14 @@
         },
         {
           "key": "direct_type",
-          "label": "压缩至",
+          "label": "压缩包保存位置",
           "widget": "radio",
           "type": "string",
           "displayType": "radioGroup",
           "required": false,
           "defaultValue": "1",
           "placeholder": "",
-          "description": "默认压缩至当前待压缩文件所在目录，如果压缩文件已存在将生成副本。",
+          "description": "「源文件路径」表示自动保存到待压缩对象所在目录；「其他路径」表示使用下方指定的输出位置。同名压缩包不会覆盖，会自动生成副本。",
           "advanced": false,
           "valueTypes": [],
           "options": [
@@ -62181,14 +62181,14 @@
         },
         {
           "key": "out_path",
-          "label": "out_path",
+          "label": "压缩包输出位置",
           "widget": "folder",
           "type": "object",
           "displayType": "selectFile",
           "required": false,
           "defaultValue": "",
-          "placeholder": "请选择或输入压缩至路径",
-          "description": "",
+          "placeholder": "选择输出目录，或输入 C:\\desktop\\result.zip",
+          "description": "选择输出文件夹，或填写以 .zip 结尾的完整压缩包路径；仅在「压缩包保存位置=其他路径」时使用。",
           "advanced": false,
           "valueTypes": [
             "rpa_str_folder",
@@ -66894,7 +66894,7 @@
           "required": false,
           "defaultValue": "1",
           "placeholder": "",
-          "description": "请选择查找目标图像的范围",
+          "description": "选择模板图片的查找范围：整个屏幕、指定窗口，或先框选一块屏幕区域后只在该区域内查找。",
           "advanced": false,
           "valueTypes": [],
           "options": [
@@ -66903,29 +66903,25 @@
               "value": "1"
             },
             {
-              "label": "当前激活窗口",
+              "label": "指定窗口",
               "value": "2"
             },
-            {
-              "label": "指定窗口对象",
-              "value": "3"
-            },
             {
               "label": "指定屏幕范围",
-              "value": "4"
+              "value": "3"
             }
           ]
         },
         {
           "key": "window_obj",
-          "label": "窗口对象",
+          "label": "窗口标题/对象",
           "widget": "text",
           "type": "string",
           "displayType": "text-expression",
           "required": true,
           "defaultValue": "",
-          "placeholder": "",
-          "description": "目标窗口对象；留空则作用于当前活动窗口",
+          "placeholder": "选择窗口或填写标题/进程名",
+          "description": "查找范围为「指定窗口」时必填：可填窗口完整标题、标题关键字或进程名；点「选窗口」从可见窗口列表中选择。",
           "advanced": false,
           "valueTypes": [
             "rpa_window_new"
@@ -66933,27 +66929,27 @@
         },
         {
           "key": "action",
-          "label": "action",
+          "label": "查找区域",
           "widget": "region",
           "type": "object",
           "displayType": "getScreenShot",
           "required": false,
           "defaultValue": "",
           "placeholder": "{\"x\":0,\"y\":0,\"width\":100,\"height\":50}",
-          "description": "区域坐标 JSON；点右侧「屏幕框选」在屏幕上框选生成",
+          "description": "查找范围为「指定屏幕范围」时使用：点右侧「屏幕框选」生成区域坐标 JSON。",
           "advanced": false,
           "valueTypes": []
         },
         {
           "key": "shot_position",
-          "label": "shot_position",
+          "label": "查找区域",
           "widget": "region",
           "type": "object",
           "displayType": "screenShotValue",
           "required": false,
           "defaultValue": "",
           "placeholder": "{\"x\":0,\"y\":0,\"width\":100,\"height\":50}",
-          "description": "区域坐标 JSON；点右侧「屏幕框选」在屏幕上框选生成",
+          "description": "查找范围为「指定屏幕范围」时使用：点右侧「屏幕框选」生成区域坐标 JSON。",
           "advanced": false,
           "valueTypes": []
         },
@@ -66966,7 +66962,7 @@
           "required": true,
           "defaultValue": "",
           "placeholder": "截取或选择图像",
-          "description": "图片文件的完整路径，用于匹配或识别；点右侧按钮选择文件",
+          "description": "要查找的小图模板路径；建议只框选按钮、图标或文字块等目标图案，不要框整屏大图。",
           "advanced": false,
           "valueTypes": [
             "rpa_str"
@@ -66981,28 +66977,28 @@
           "required": false,
           "defaultValue": "center",
           "placeholder": "",
-          "description": "相对目标的点击位置（中心、左上角等）",
+          "description": "命中目标图像后，鼠标移动到目标区域的哪个位置。",
           "advanced": false,
           "valueTypes": [],
           "options": [
             {
               "label": "左上",
-              "value": "left-top"
+              "value": "leftTop"
             },
             {
               "label": "右上",
-              "value": "right-top"
+              "value": "rightTop"
             },
             {
               "label": "左下",
-              "value": "left-bottom"
+              "value": "leftBottom"
             },
             {
               "label": "右下",
-              "value": "right-bottom"
+              "value": "rightBottom"
             },
             {
-              "label": "中间",
+              "label": "中心",
               "value": "center"
             }
           ]
@@ -67031,7 +67027,7 @@
           "required": false,
           "defaultValue": "1",
           "placeholder": "",
-          "description": "勾选后运行时显示鼠标移动轨迹动画，便于观察执行过程",
+          "description": "开启后鼠标按轨迹移动到目标位置；关闭后直接跳到目标位置。",
           "advanced": true,
           "valueTypes": []
         }
@@ -67540,7 +67536,7 @@
           "required": false,
           "defaultValue": "1",
           "placeholder": "",
-          "description": "请选择查找目标图像的范围",
+          "description": "选择模板图片的查找范围：整个屏幕、指定窗口，或先框选一块屏幕区域后只在该区域内查找。",
           "advanced": false,
           "valueTypes": [],
           "options": [
@@ -67549,29 +67545,25 @@
               "value": "1"
             },
             {
-              "label": "当前激活窗口",
+              "label": "指定窗口",
               "value": "2"
             },
-            {
-              "label": "指定窗口对象",
-              "value": "3"
-            },
             {
               "label": "指定屏幕范围",
-              "value": "4"
+              "value": "3"
             }
           ]
         },
         {
           "key": "window_obj",
-          "label": "窗口对象",
+          "label": "窗口标题/对象",
           "widget": "text",
           "type": "string",
           "displayType": "text-expression",
           "required": true,
           "defaultValue": "",
-          "placeholder": "",
-          "description": "目标窗口对象；留空则作用于当前活动窗口",
+          "placeholder": "选择窗口或填写标题/进程名",
+          "description": "查找范围为「指定窗口」时必填：可填窗口完整标题、标题关键字或进程名；点「选窗口」从可见窗口列表中选择。",
           "advanced": false,
           "valueTypes": [
             "rpa_window_new"
@@ -67579,27 +67571,27 @@
         },
         {
           "key": "action",
-          "label": "action",
+          "label": "查找区域",
           "widget": "region",
           "type": "object",
           "displayType": "getScreenShot",
           "required": false,
           "defaultValue": "",
           "placeholder": "{\"x\":0,\"y\":0,\"width\":100,\"height\":50}",
-          "description": "区域坐标 JSON；点右侧「屏幕框选」在屏幕上框选生成",
+          "description": "查找范围为「指定屏幕范围」时使用：点右侧「屏幕框选」生成区域坐标 JSON。",
           "advanced": false,
           "valueTypes": []
         },
         {
           "key": "position",
-          "label": "position",
+          "label": "查找区域",
           "widget": "region",
           "type": "object",
           "displayType": "screenShotValue",
           "required": false,
           "defaultValue": "",
           "placeholder": "{\"x\":0,\"y\":0,\"width\":100,\"height\":50}",
-          "description": "区域坐标 JSON；点右侧「屏幕框选」在屏幕上框选生成",
+          "description": "查找范围为「指定屏幕范围」时使用：点右侧「屏幕框选」生成区域坐标 JSON。",
           "advanced": false,
           "valueTypes": []
         },
@@ -67612,7 +67604,7 @@
           "required": true,
           "defaultValue": "",
           "placeholder": "截取或选择图像",
-          "description": "图片文件的完整路径，用于匹配或识别；点右侧按钮选择文件",
+          "description": "要查找的小图模板路径；建议只框选按钮、图标或文字块等目标图案，不要框整屏大图。",
           "advanced": false,
           "valueTypes": [
             "rpa_str"
@@ -67641,8 +67633,8 @@
           "displayType": "text-expression",
           "required": true,
           "defaultValue": "20",
-          "placeholder": "请输入超时等待的时间（秒）",
-          "description": "输入超时等待的时间，单位：秒，默认20秒，非必填",
+          "placeholder": "20",
+          "description": "等待目标图像出现的秒数；默认 20 秒。",
           "advanced": false,
           "valueTypes": [
             "rpa_num"
@@ -125582,4 +125574,4 @@
       "slots": []
     }
   ]
-}
+}