rust-rpa 0.2.4 → 0.2.5

package/README.md

@@ -591,6 +591,36 @@ if (targetWindow) {
 
 ## 更新日志
 
+### 0.2.5
+
+#### 改进
+
+- **Window.watchChanges 优化**: `threshold` 参数默认值改为 `0.0`，并优化为 `0` 时跳过图像对比
+  - `threshold: 0`（默认）- 跳过像素对比，每次轮询直接触发回调，最低延迟
+  - `threshold > 0` - 执行降采样对比，变化比例超过阈值才触发回调
+  - 适用于已知窗口会变化、需要立即获取截图的场景
+
+### 0.2.5
+
+#### 新功能
+
+- **findText / waitText / clickText 新增 `index` 参数**: 支持选择第几个匹配的文字结果
+  - `index` 默认为 `0`，返回第一个匹配结果
+  - 正数表示第 n 个（从 0 开始）：`index: 1` 返回第二个
+  - 负数表示倒数第 n 个：`index: -1` 返回最后一个，`index: -2` 返回倒数第二个
+  - 超出匹配数量范围时返回 `null`
+  - 适用场景：页面中存在多个相同文字，需要点击特定位置
+  - 示例：`findText('确定', { index: 1 })` 查找第二个「确定」，`clickText('确定', { index: -2 })` 点击倒数第二个「确定」
+
+#### 类型定义更新
+
+- `FindTextOptions` 新增 `index?: number` 字段
+- `WindowFindTextOptions` 新增 `index?: number` 字段
+- `MonitorFindTextOptions` 新增 `index?: number` 字段
+- `WindowWaitOptions` 新增 `index?: number` 字段
+- `MonitorWaitOptions` 新增 `index?: number` 字段
+- `WaitOptions` 新增 `index?: number` 字段
+
 ### 0.2.4
 
 #### 新功能

package/index.d.ts

@@ -60,6 +60,8 @@ export interface FindTextOptions {
   regions?: Array<MatchRegion>
   /** 排除文字，若同一行中包含此文字则排除该匹配结果 */
   notText?: string
+  /** 匹配索引，默认为 0（第一个匹配）。负数表示倒数：-1 最后一个，-2 倒数第二个 */
+  index?: number
 }
 /** 文字查找选项（Window 专用） */
 export interface WindowFindTextOptions {
@@ -73,6 +75,8 @@ export interface WindowFindTextOptions {
    * - `'screen'`：截取窗口所在显示器的整屏
    */
   from?: 'window' | 'screen'
+  /** 匹配索引，默认为 0（第一个匹配）。负数表示倒数：-1 最后一个，-2 倒数第二个 */
+  index?: number
 }
 /** 文字查找选项（Monitor 专用） */
 export interface MonitorFindTextOptions {
@@ -80,6 +84,8 @@ export interface MonitorFindTextOptions {
   regions?: Array<MatchRegion>
   /** 排除文字，若同一行中包含此文字则排除该匹配结果 */
   notText?: string
+  /** 匹配索引，默认为 0（第一个匹配）。负数表示倒数：-1 最后一个，-2 倒数第二个 */
+  index?: number
 }
 /** 文字识别选项（ImageData 使用） */
 export interface RecognizeTextOptions {
@@ -118,6 +124,8 @@ export interface WindowWaitOptions {
    * - `'screen'`：截取窗口所在显示器的整屏
    */
   from?: 'window' | 'screen'
+  /** 匹配索引，默认为 0（第一个匹配）。负数表示倒数：-1 最后一个，-2 倒数第二个（仅用于 waitText/clickText） */
+  index?: number
 }
 /** 等待选项（Monitor 专用） */
 export interface MonitorWaitOptions {
@@ -129,6 +137,8 @@ export interface MonitorWaitOptions {
   threshold?: number
   /** 排除文字，若同一行中包含此文字则排除该匹配结果（仅用于 waitText/clickText） */
   notText?: string
+  /** 匹配索引，默认为 0（第一个匹配）。负数表示倒数：-1 最后一个，-2 倒数第二个（仅用于 waitText/clickText） */
+  index?: number
 }
 /** 等待选项（兼容旧代码，与 WindowWaitOptions 相同） */
 export interface WaitOptions {
@@ -146,6 +156,8 @@ export interface WaitOptions {
    * - `'screen'`：截取窗口所在显示器的整屏
    */
   from?: 'window' | 'screen'
+  /** 匹配索引，默认为 0（第一个匹配）。负数表示倒数：-1 最后一个，-2 倒数第二个（仅用于 waitText/clickText） */
+  index?: number
 }
 /** 图标匹配结果 */
 export interface MatchResult {
@@ -246,7 +258,12 @@ export interface CaptureSizeJs {
 }
 /** 窗口变化监听的选项 */
 export interface WindowWatchOptionsJs {
-  /** 变化检测的灵敏度阈值 (0.0-1.0)，默认 0.02 */
+  /**
+   * 变化检测的灵敏度阈值 (0.0-1.0)，默认 0.0
+   *
+   * - 0.0 表示跳过对比，每次轮询都触发回调（最敏感，最低延迟）
+   * - 大于 0.0 时，仅当像素变化比例超过阈值才触发回调
+   */
   threshold?: number
   /** 图片来源：'window'（默认）或 'screen' */
   from?: 'window' | 'screen'

package/package.json

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