rust-rpa 0.2.5 → 0.2.6-beta.1

package/README.md

@@ -205,7 +205,7 @@ main();
 - `setBounds(bounds)` - 设置窗口边界
 - `toJSON()` - 转为 JSON 对象
 - `captureImage(options?)` - 截图
-- `watchChanges(options?, callback)` - 监听窗口内容变化；返回 `WindowWatcher`（`stop()` / `isRunning()`），回调收到变化后的 `ImageData` 或 `null`（见 `sendImage` 选项）
+- `watchChanges(options?, callback)` - 监听窗口内容变化；返回 `WindowWatcher`（`stop()` / `isRunning()`），回调收到变化后的 `ImageData` 或 `null`（见 `sendImage` 选项）；`stableFrames` 选项可过滤光标闪烁等瞬态变化
 - `recognizeText(options?)` - OCR 识别文字
 - `findText(text, options?)` - 查找文字
 - `findIcon(template, options?)` - 查找图标
@@ -591,6 +591,17 @@ if (targetWindow) {
 
 ## 更新日志
 
+### 0.2.6
+
+#### 新功能
+
+- **Window.watchChanges 新增 `stableFrames` 选项**: 支持过滤光标闪烁等瞬态变化，仅检测真实内容变化
+  - `stableFrames: 0`（默认）- 检测到变化即触发回调，最快响应
+  - `stableFrames: N` - 需连续 N 帧与上一帧相比均有变化才触发回调
+  - 过滤光标闪烁原理：光标闪烁 ON→OFF 一次变化、OFF→OFF 无变化则计数重置，无法连续 N 帧；而真实内容变化（新消息出现）会持续与旧基线不同，连续 N 帧均有变化
+  - 推荐 `stableFrames: 2` 可过滤大多数光标闪烁
+  - 示例：`window.watchChanges({ threshold: 0.02, stableFrames: 2 }, callback)`
+
 ### 0.2.5
 
 #### 改进

package/index.d.ts

@@ -273,6 +273,19 @@ export interface WindowWatchOptionsJs {
   captureSize?: CaptureSizeJs | null
   /** 是否在回调中传递截图图像，默认 true */
   sendImage?: boolean
+  /**
+   * 变化确认帧数，默认 0
+   *
+   * - 0 表示检测到变化即触发回调（最快响应）
+   * - 大于 0 时，需连续 N 帧与上一帧相比均有变化才触发回调
+   *
+   * 适用于过滤光标闪烁等瞬态变化：光标闪烁在 ON/OFF 间交替，
+   * ON→OFF 一次变化、OFF→OFF 无变化则计数重置，无法连续 N 帧；
+   * 而真实内容变化（如新消息出现）会持续与旧基线不同，
+   * 连续 N 帧均有变化，通过确认。
+   * 推荐 stableFrames=2 可过滤大多数光标闪烁。
+   */
+  stableFrames?: number
 }
 /** 窗口内容变化监听的回调函数签名 */
 export type WindowChangeCallback = (image: ImageData | null) => void
@@ -1347,6 +1360,17 @@ export declare class Window {
    *   watcher.stop();
    * }, 60000);
    * ```
+   * 
+   * @example
+   * ```javascript
+   * // 场景 4：忽略光标闪烁，仅检测真实内容变化
+   * const watcher = targetWindow.watchChanges(
+   *   { threshold: 0.02, stableFrames: 2 },
+   *   (image) => {
+   *     console.log('窗口内容发生持久变化');
+   *   }
+   * );
+   * ```
    */
   watchChanges(
     options: WindowWatchOptionsJs | null | undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rust-rpa",
-  "version": "0.2.5",
+  "version": "0.2.6-beta.1",
   "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.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"
+    "@alibot/rust-rpa-win32-x64-msvc": "0.2.6-beta.1",
+    "@alibot/rust-rpa-win32-ia32-msvc": "0.2.6-beta.1",
+    "@alibot/rust-rpa-darwin-x64": "0.2.6-beta.1",
+    "@alibot/rust-rpa-darwin-arm64": "0.2.6-beta.1"
   }
 }