@solazah/solazah-runtime 0.2.29 → 0.2.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solazah/solazah-runtime",
-  "version": "0.2.29",
+  "version": "0.2.30",
   "main": "index.cjs",
   "module": "index.js",
   "types": "types/index.d.ts",

package/types/SystemScreen.d.ts

@@ -1,5 +1,13 @@
 import { default as IpcRenderer } from './IpcRenderer';
 import { Point } from '@computer-use/nut-js';
+/** 原始位图:BGRA、自顶向下、每像素 4 字节,与截图流 raw 帧同一格式。手里已经是像素时直接给它,省掉编码与解码。 */
+export interface RawImage {
+    width: number;
+    height: number;
+    data: Uint8Array;
+}
+/** 一张图:Data URL、本机绝对路径,或原始位图。 */
+export type ImageSource = string | RawImage;
 /** 屏幕原生坐标系里的矩形。 */
 export interface ScreenRect {
     x: number;
@@ -364,12 +372,12 @@ export default class SystemScreen {
     /**
      * 在一张给定图片(而不是当前屏幕)里做模板匹配,给「用采集时的截图验证模板唯一性」用。
      *
-     * @param haystack 被搜索图片的 Base64。
-     * @param needle   模板图片的 Base64。
+     * @param haystack 被搜索的图片:Data URL、本机绝对路径或原始位图。
+     * @param needle   模板图片:Data URL、本机绝对路径或原始位图。
      * @param options  `{maxResults?, scale?, minScore?, region?}`。
      * @returns `[{x, y, width, height, score, scale}]`,按分数降序,第一个是全图最佳。
      */
-    matchTemplate: (haystack: string, needle: string, options?: {
+    matchTemplate: (haystack: ImageSource, needle: ImageSource, options?: {
         maxResults?: number;
         scale?: number;
         minScore?: number;
@@ -382,15 +390,16 @@ export default class SystemScreen {
      * 对一帧给定图片做一批分析:若干模板各自匹配、若干区域各自 OCR,图片只解码一次,同一区域只 OCR 一次。
      * 每一拍截一帧、拿这一帧判断全部条件的循环靠它把 IPC 压到每拍一次。
      *
-     * @param frame   被分析图片的 Base64(整个显示器的截图)。
+     * @param frame   被分析的图片(通常是一帧截图)。
      * @param request `{templates?: [{id, image, region?, scale?, minScore?, maxResults?}], texts?: [{id, region?, detRatio?, zoom?}]}`,region 相对图片左上角。
-     *   frame 与 templates[].image 都可以给 Data URL 或本机绝对路径;反复分析同一批图时给路径,同一张只解码一次。
+     *   frame 与 templates[].image 都可以给 Data URL、本机绝对路径或原始位图;反复分析同一批图时给路径,同一张只解码一次;
+     *   手里已经是像素的(截图流 raw 帧)给原始位图。
      * @returns `{templates: {id: [{x, y, width, height, score, scale}]}, texts: {id: [{text, score, x, y, width, height}]}}`,坐标相对图片左上角。
      */
-    analyzeFrame: (frame: string, request?: {
+    analyzeFrame: (frame: ImageSource, request?: {
         templates?: Array<{
             id: string;
-            image: string;
+            image: ImageSource;
             region?: ScreenRect;
             scale?: number;
             minScore?: number;