rust-rpa 0.1.4-beta.4 → 0.1.5-beta.2

package/README.md

@@ -216,7 +216,7 @@ const windows = Window.all();
 - `getBounds(): WindowBounds` - 获取窗口边界（位置和大小）
 - `setBounds(bounds): Promise<void>` - 设置窗口边界（位置和大小）
 - `toJSON(): WindowToJson` - 转为 JSON 可序列化对象
-- `captureImage(options?: CaptureImageOptions): Promise<ImageData>` - 截取窗口图像；可选 `options.size` 指定目标宽高并自动缩放
+- `captureImage(options?: CaptureImageOptions): Promise<ImageData>` - 截取窗口图像；可选 `options.size` 指定目标宽高并自动缩放；`options.from` 为 `'screen'` 时截取窗口所在显示器整屏；`options.region` 指定仅截取逻辑像素区域；`options.auto_size` 为 true 时在 Windows 高 DPI 下自动缩放到逻辑像素尺寸
 
 ### Monitor 类
 
@@ -330,8 +330,20 @@ interface ImageMetadata {
 
 **captureImage 选项（Monitor / Window）：**
 ```typescript
+// 截取区域（逻辑像素），仅对 Window.captureImage 有效
+interface CaptureRegion {
+  x: number;      // 区域左上角 x（相对截图画布左上角）
+  y: number;      // 区域左上角 y
+  width: number;  // 区域宽度
+  height: number; // 区域高度
+}
+
 interface CaptureImageOptions {
   size?: { width: number; height: number };  // 可选，截取后缩放到指定宽高
+  // 以下仅对 Window.captureImage 有效：
+  from?: 'window' | 'screen';  // 默认 'window' 截窗口；'screen' 截窗口所在显示器整屏（可配合 getBounds 与 image.crop 裁剪出窗口）
+  region?: CaptureRegion | null;  // 仅截取该逻辑像素区域，不填则截全图
+  auto_size?: boolean | null;     // 为 true 时在 Windows 存在 DPI 缩放时自动将图像缩放到逻辑像素宽高（与 getSize/getBounds 一致）
 }
 ```
 
@@ -528,7 +540,9 @@ if (windows.length > 0) {
 }
 ```
 
-**截图选项**：`captureImage(options?)` 接受可选对象 `CaptureImageOptions`，其中 `size?: { width: number, height: number }` 表示截取后缩放到指定宽高，不传则返回原始尺寸。
+**截图选项**：`captureImage(options?)` 接受可选对象 `CaptureImageOptions`：
+- `size?: { width, height }`：截取后缩放到指定宽高，不传则返回原始尺寸。
+- **Window 专用**：`from?: 'window' | 'screen'` 默认截窗口，设为 `'screen'` 可截窗口所在显示器整屏再配合 `getBounds()` 与 `image.crop()` 裁剪；`region?: { x, y, width, height }` 仅截取该逻辑像素区域；`auto_size?: true` 在 Windows 高 DPI 下自动将图像缩放到逻辑像素宽高（与 `getSize`/`getBounds` 一致）。
 
 ### 输入自动化
 
@@ -729,6 +743,14 @@ npm test
 
 ## 更新日志
 
+### 0.1.5
+
+#### 功能
+- **Window.captureImage 选项 `from`**：新增 `'window'`（默认）与 `'screen'`。设为 `'screen'` 时先截取窗口所在显示器整屏，再自动裁剪为当前窗口与显示器的交集区域（超出显示器的部分忽略）。
+- **Window.captureImage 选项 `region`**：新增可选参数，仅截取指定逻辑像素区域 `{ x, y, width, height }`，不填则截取全图。
+- **Window.captureImage 选项 `auto_size`**：新增可选参数。为 `true` 时，在 Windows 存在 DPI 缩放的情况下自动将图像缩放到逻辑像素宽高（与 `getSize`/`getBounds` 一致）。
+- **CaptureImageOptions 处理顺序**：内部先执行 `auto_size`（缩放到逻辑像素），再执行 `region`（按逻辑像素裁剪），最后应用 `size`（若有）。启用 `auto_size` 后，`region` 与逻辑像素坐标一一对应。
+
 ### 0.1.4
 
 #### BREAKCHANGE

package/index.d.ts

@@ -56,10 +56,31 @@ export interface CaptureSize {
   /** 目标高度（像素） */
   height: number
 }
+/** 截取区域（逻辑像素），仅截取该矩形范围 */
+export interface CaptureRegion {
+  /** 区域左上角 x（相对截图画布左上角，逻辑像素） */
+  x: number
+  /** 区域左上角 y（逻辑像素） */
+  y: number
+  /** 区域宽度（逻辑像素） */
+  width: number
+  /** 区域高度（逻辑像素） */
+  height: number
+}
 /** captureImage 的选项对象，便于后续扩展更多参数 */
 export interface CaptureImageOptions {
   /** 目标尺寸，配置后会将截取到的图像缩放到指定宽高 */
   size?: CaptureSize | null
+  /**
+   * 图片来源（仅对 Window.captureImage 有效）：
+   * - `'window'`（默认）：截取当前窗口
+   * - `'screen'`：截取窗口所在显示器的整屏，可用 getBounds() 与显示器范围计算裁剪区域，再通过 image.crop() 得到窗口截图；超出当前显示器范围的部分不会出现在图中
+   */
+  from?: 'window' | 'screen' | null
+  /** 仅截取该区域（逻辑像素），不填则截取全图；仅对 Window.captureImage 有效 */
+  region?: CaptureRegion | null
+  /** 为 true 时，在 Windows 上若存在 DPI 缩放，则自动将图像缩放到逻辑像素宽高（与 getSize/getBounds 一致）；仅对 Window.captureImage 有效 */
+  auto_size?: boolean | null
 }
 /** 窗口尺寸信息 */
 export interface WindowSize {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rust-rpa",
-  "version": "0.1.4-beta.4",
+  "version": "0.1.5-beta.2",
   "description": "Rust-based RPA automation library for Node.js",
   "type": "commonjs",
   "main": "index.js",
@@ -32,6 +32,28 @@
   "engines": {
     "node": ">= 18"
   },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release --manifest-path crates/bindings/Cargo.toml && npm run postbuild",
+    "build:debug": "napi build --platform --manifest-path crates/bindings/Cargo.toml && npm run postbuild",
+    "build:macos-x64": "napi build --platform --release --target x86_64-apple-darwin --manifest-path crates/bindings/Cargo.toml && npm run postbuild",
+    "build:macos-arm64": "napi build --platform --release --target aarch64-apple-darwin --manifest-path crates/bindings/Cargo.toml && npm run postbuild",
+    "build:macos-universal": "npm run build:macos-x64 && npm run build:macos-arm64",
+    "build:windows-x64": "napi build --platform --release --target x86_64-pc-windows-msvc --cross-compile --manifest-path crates/bindings/Cargo.toml && npm run postbuild",
+    "build:windows-x86": "napi build --platform --release --target i686-pc-windows-msvc --cross-compile --manifest-path crates/bindings/Cargo.toml && npm run postbuild",
+    "build:windows-all": "npm run build:windows-x64 && npm run build:windows-x86",
+    "build:all": "npm run build:macos-universal && npm run build:windows-all",
+    "postbuild": "node scripts/postbuild.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "version": "napi version"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.5.1",
+    "node-screenshots": "^0.2.8",
+    "sharp": "^0.34.5",
+    "vitest": "^4.0.18"
+  },
   "files": [
     "index.js",
     "index.d.ts",
@@ -41,4 +63,4 @@
   "dependencies": {
     "commander": "^14.0.3"
   }
-}
+}