rust-rpa 0.2.0 → 0.2.1-beta.1

package/README.md

@@ -213,11 +213,11 @@ const windows = Window.all();
 - `captureImage(options?: CaptureImageOptions): Promise<ImageData>` - 截取窗口图像；可选 `options.size` 指定目标宽高并自动缩放；`options.from` 为 `'screen'` 时截取窗口所在显示器整屏；`options.region` 指定仅截取逻辑像素区域；`options.autoSize` 默认为 `true`，在 Windows 高 DPI 下自动缩放到逻辑像素尺寸
 - `findIcon(template, options?): Promise<MatchResult | null>` - 在窗口截图中查找模板图标（先截图 autoSize=true，再执行模板匹配），找到返回 MatchResult，未找到返回 null
 - `recognizeText(): Promise<TextRecognitionResult[]>` - 识别窗口截图中的文字（先截图 autoSize=true，再执行 OCR）
-- `findText(text, options?): Promise<TextRecognitionResult | null>` - 在窗口截图中查找指定文字，找到返回位置信息，未找到返回 null（先截图 autoSize=true，再执行 OCR）；`options.regions` 可指定查找区域列表以提升性能
-- `waitText(text, options?): Promise<TextRecognitionResult>` - 等待指定文字出现，超时抛出错误；`options.timeout` 指定等待时间（默认 3000ms），`options.regions` 可指定查找区域
+- `findText(text, options?): Promise<TextRecognitionResult | null>` - 在窗口截图中查找指定文字，找到返回位置信息，未找到返回 null（先截图 autoSize=true，再执行 OCR）；`options.regions` 可指定查找区域列表以提升性能；`options.notText` 可排除同一行中包含特定文字的匹配结果
+- `waitText(text, options?): Promise<TextRecognitionResult>` - 等待指定文字出现，超时抛出错误；`options.timeout` 指定等待时间（默认 3000ms），`options.regions` 可指定查找区域，`options.notText` 可排除同一行中包含特定文字的匹配结果
 - `waitIcon(template, options?): Promise<MatchResult>` - 等待指定图标出现，超时抛出错误；`options.timeout` 指定等待时间（默认 3000ms），`options.regions` 可指定查找区域，`options.threshold` 可指定匹配阈值（默认 0.8）
-- `clickText(text, options?): Promise<void>` - 点击指定文字，先等待文字出现，然后点击文字中心点
-- `clickIcon(template, options?): Promise<void>` - 点击指定图标，先等待图标出现，然后点击图标中心点；`options.threshold` 可指定匹配阈值（默认 0.8）
+- `clickText(text, options?): Promise<ClickResult>` - 点击指定文字，先等待文字出现，然后点击文字中心点；返回点击坐标 `{x, y, relX, relY}`；`options.notText` 可排除同一行中包含特定文字的匹配结果
+- `clickIcon(template, options?): Promise<ClickResult>` - 点击指定图标，先等待图标出现，然后点击图标中心点；返回点击坐标 `{x, y, relX, relY}`；`options.threshold` 可指定匹配阈值（默认 0.8）
 
 ### Monitor 类
 
@@ -247,11 +247,11 @@ const primary = monitors.find(m => m.isPrimary());
 - `captureImage(options?: CaptureImageOptions): Promise<ImageData>` - 截取显示器图像；可选 `options.size` 指定目标宽高并自动缩放；`options.autoSize` 默认为 `true`，在 Windows 高 DPI 下自动缩放到逻辑像素尺寸
 - `findIcon(template, options?): Promise<MatchResult | null>` - 在显示器截图中查找模板图标（先截图 autoSize=true，再执行模板匹配），找到返回 MatchResult，未找到返回 null
 - `recognizeText(): Promise<TextRecognitionResult[]>` - 识别显示器截图中的文字（先截图 autoSize=true，再执行 OCR）
-- `findText(text, options?): Promise<TextRecognitionResult | null>` - 在显示器截图中查找指定文字，找到返回位置信息，未找到返回 null（先截图 autoSize=true，再执行 OCR）；`options.regions` 可指定查找区域列表以提升性能
-- `waitText(text, options?): Promise<TextRecognitionResult>` - 等待指定文字出现，超时抛出错误；`options.timeout` 指定等待时间（默认 3000ms），`options.regions` 可指定查找区域
+- `findText(text, options?): Promise<TextRecognitionResult | null>` - 在显示器截图中查找指定文字，找到返回位置信息，未找到返回 null（先截图 autoSize=true，再执行 OCR）；`options.regions` 可指定查找区域列表以提升性能；`options.notText` 可排除同一行中包含特定文字的匹配结果
+- `waitText(text, options?): Promise<TextRecognitionResult>` - 等待指定文字出现，超时抛出错误；`options.timeout` 指定等待时间（默认 3000ms），`options.regions` 可指定查找区域，`options.notText` 可排除同一行中包含特定文字的匹配结果
 - `waitIcon(template, options?): Promise<MatchResult>` - 等待指定图标出现，超时抛出错误；`options.timeout` 指定等待时间（默认 3000ms），`options.regions` 可指定查找区域，`options.threshold` 可指定匹配阈值（默认 0.8）
-- `clickText(text, options?): Promise<void>` - 点击指定文字，先等待文字出现，然后点击文字中心点
-- `clickIcon(template, options?): Promise<void>` - 点击指定图标，先等待图标出现，然后点击图标中心点；`options.threshold` 可指定匹配阈值（默认 0.8）
+- `clickText(text, options?): Promise<ClickResult>` - 点击指定文字，先等待文字出现，然后点击文字中心点；返回点击坐标 `{x, y, relX, relY}`；`options.notText` 可排除同一行中包含特定文字的匹配结果
+- `clickIcon(template, options?): Promise<ClickResult>` - 点击指定图标，先等待图标出现，然后点击图标中心点；返回点击坐标 `{x, y, relX, relY}`；`options.threshold` 可指定匹配阈值（默认 0.8）
 
 ### ImageData 类
 
@@ -282,8 +282,8 @@ const primary = monitors.find(m => m.isPrimary());
 - `resize(width, height): Promise<ImageData>` - 缩放图像
 - `grayscale(): Promise<ImageData>` - 转换为灰度图
 - `findIcon(template, options?): Promise<MatchResult | null>` - 查找模板图标，找到返回 MatchResult，未找到返回 null
-- `recognizeText(): Promise<TextRecognitionResult[]>` - 识别图片中的文字
-- `findText(text): Promise<TextRecognitionResult | null>` - 查找指定文字
+- `recognizeText(options?): Promise<TextRecognitionResult[]>` - 识别图片中的文字；`options.regions` 可指定识别区域列表
+- `findText(text, options?): Promise<TextRecognitionResult | null>` - 查找指定文字；`options.regions` 可指定查找区域列表；`options.notText` 可排除同一行中包含特定文字的匹配结果
 
 **数据访问**
 
@@ -702,6 +702,17 @@ if (targetWindow) {
   if (windowFound) {
     console.log(`在窗口中找到"搜索": (${windowFound.x}, ${windowFound.y})`);
   }
+  
+  // 使用 notText 排除同一行的干扰文字
+  // 场景：同一行有"确定"和"取消"两个按钮，需要点击"确定"但排除"取消"所在行
+  const confirmBtn = await targetWindow.findText('确定', { notText: '取消' });
+  if (confirmBtn) {
+    console.log(`找到不与"取消"同行的"确定": (${confirmBtn.x}, ${confirmBtn.y})`);
+  }
+  
+  // clickText 也支持 notText 参数
+  const clickResult = await targetWindow.clickText('发送', { notText: '草稿', timeout: 5000 });
+  console.log(`点击位置: (${clickResult.x}, ${clickResult.y})`);
 }
 ```
 
@@ -719,6 +730,34 @@ interface TextRecognitionResult {
 }
 ```
 
+**ClickResult 类型：**
+```typescript
+interface ClickResult {
+  x: number;            // 点击的 x 坐标（屏幕坐标）
+  y: number;            // 点击的 y 坐标（屏幕坐标）
+  relX: number;         // 相对于当前窗口/屏幕左上角的 x 坐标
+  relY: number;         // 相对于当前窗口/屏幕左上角的 y 坐标
+}
+```
+
+**FindTextOptions 类型：**
+```typescript
+interface FindTextOptions {
+  regions?: Array<{ x: number, y: number, width: number, height: number }>;  // 查找区域列表
+  notText?: string;     // 排除文字，若同一行中包含此文字则排除该匹配结果
+}
+```
+
+**WaitOptions 类型：**
+```typescript
+interface WaitOptions {
+  regions?: Array<{ x: number, y: number, width: number, height: number }>;  // 查找区域列表
+  timeout?: number;     // 等待超时时间（毫秒），默认 3000
+  threshold?: number;   // 匹配阈值（仅用于 waitIcon/clickIcon），默认 0.8
+  notText?: string;     // 排除文字（仅用于 waitText/clickText）
+}
+```
+
 ## 平台支持
 
 | 平台 | 架构 | 状态 | 备注 |
@@ -762,6 +801,29 @@ interface TextRecognitionResult {
 
 ## 更新日志
 
+### 0.2.1
+
+#### 新功能
+
+- **findText / waitText / clickText 增强**: 新增 `notText` 参数，用于排除同一行中包含特定文字的匹配结果
+  - `findText(text, { notText: '排除文字' })` - 查找文字时，如果同一行中包含 `notText` 指定的文字，则排除该匹配结果
+  - `waitText(text, { notText: '排除文字' })` - 等待文字时同样支持排除逻辑
+  - `clickText(text, { notText: '排除文字' })` - 点击文字时同样支持排除逻辑
+  - 适用场景：同一行内可能有多个相似文字，需要精确排除干扰项
+  - 同一行判断标准：两个文字区域的垂直方向有超过较小区域高度 50% 的重叠
+
+- **clickText / clickIcon 返回值增强**: 返回点击坐标信息 `ClickResult`
+  - 返回 `{ x, y, relX, relY }`，包含屏幕坐标和相对坐标
+  - 便于调试和验证点击位置
+
+- **ImageData.recognizeText 增强**: 新增 `options.regions` 参数，可指定识别区域列表
+
+#### 类型定义更新
+
+- `FindTextOptions` 新增 `notText?: string` 字段
+- `WaitOptions` 新增 `notText?: string` 字段
+- `ClickResult` 类型：`{ x: number, y: number, relX: number, relY: number }`
+
 ### 0.2.0
 
 #### 新功能

package/index.d.ts

@@ -38,6 +38,8 @@ export interface MatchOptionsJs {
 export interface FindTextOptions {
   /** 查找区域列表，若为空则在全图查找 */
   regions?: Array<MatchRegion>
+  /** 排除文字，若同一行中包含此文字则排除该匹配结果 */
+  notText?: string
 }
 /** 文字识别选项 */
 export interface RecognizeTextOptions {
@@ -52,6 +54,8 @@ export interface WaitOptions {
   timeout?: number
   /** 匹配阈值 (0.0-1.0)，低于此值视为未找到，默认 0.8（仅用于 waitIcon/clickIcon） */
   threshold?: number
+  /** 排除文字，若同一行中包含此文字则排除该匹配结果（仅用于 waitText/clickText） */
+  notText?: string
 }
 /** 图标匹配结果 */
 export interface MatchResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rust-rpa",
-  "version": "0.2.0",
+  "version": "0.2.1-beta.1",
   "description": "Rust-based RPA automation library for Node.js",
   "type": "commonjs",
   "main": "index.js",
@@ -69,9 +69,9 @@
     "commander": "^14.0.3"
   },
   "optionalDependencies": {
-    "@alibot/rust-rpa-win32-x64-msvc": "0.2.0",
-    "@alibot/rust-rpa-win32-ia32-msvc": "0.2.0",
-    "@alibot/rust-rpa-darwin-x64": "0.2.0",
-    "@alibot/rust-rpa-darwin-arm64": "0.2.0"
+    "@alibot/rust-rpa-win32-x64-msvc": "0.2.1-beta.1",
+    "@alibot/rust-rpa-win32-ia32-msvc": "0.2.1-beta.1",
+    "@alibot/rust-rpa-darwin-x64": "0.2.1-beta.1",
+    "@alibot/rust-rpa-darwin-arm64": "0.2.1-beta.1"
   }
 }