ms-types 0.0.25 → 0.0.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "type": "module",
   "license": "MIT",
   "publishConfig": {

package/types/action.d.ts

@@ -55,6 +55,42 @@ declare namespace action {
     y2: number,
     duration?: number
   ): boolean;
+  /**
+   * 双击
+   * @param x 坐标x
+   * @param y 坐标y
+   * @param duration 持续时间 默认20ms
+   * @param interval 双击间隔时间 默认20ms
+   * @param jitter 抖动 开启抖动，会在像素范围随机偏移 点击 默认false
+   * @returns 双击是否成功
+   * @example action.doubleClick(100, 100, 20, 20, true)
+   */
+  function doubleClick(
+    x: number,
+    y: number,
+    duration?: number,
+    interval?: number,
+    jitter?: boolean
+  ): boolean;
+  /**
+   * 随机双击
+   * @param x1 区域左上角x坐标
+   * @param y1 区域左上角y坐标
+   * @param x2 区域右下角x坐标
+   * @param y2 区域右下角y坐标
+   * @param duration 持续时间 默认20ms
+   * @param interval 双击间隔时间 默认20ms
+   * @returns 随机双击是否成功
+   * @example action.doubleClickRandom(100, 100, 200, 200, 20, 20)  
+   */
+  function doubleClickRandom(
+    x1: number,
+    y1: number,
+    x2: number,
+    y2: number,
+    duration?: number,
+    interval?: number
+  ): boolean;
   /**
    * 长按滑动
    * @param startX 起始坐标x

package/types/appleOcr.d.ts

@@ -4,7 +4,7 @@
 declare namespace appleOcr {
   /**
    * 执行OCR识别（使用Apple Vision框架）
-   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，null表示使用当前屏幕）
+   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
    * @param x 边界框左上角x坐标
    * @param y 边界框左上角y坐标
    * @param ex 边界框右下角x坐标
@@ -18,7 +18,7 @@ declare namespace appleOcr {
    * })
    */
   function recognize(
-    input: string | null,
+    input: string,
     x: number,
     y: number,
     ex: number,
@@ -28,7 +28,7 @@ declare namespace appleOcr {
 
   /**
    * 执行快速OCR识别（仅返回文本内容）
-   * @param input 输入源
+   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
    * @param x 边界框左上角x坐标
    * @param y 边界框左上角y坐标
    * @param ex 边界框右下角x坐标
@@ -42,7 +42,7 @@ declare namespace appleOcr {
    * }
    */
   function recognizeText(
-    input: string | null,
+    input: string,
     x: number,
     y: number,
     ex: number,

package/types/paddleOcr.d.ts

@@ -15,7 +15,7 @@ declare namespace paddleOcr {
   function loadV5(useGpu: boolean): boolean;
   /**
    * 执行OCR识别
-   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，nil表示使用当前屏幕）
+   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
    * @param x 边界框左上角x坐标
    * @param y 边界框左上角y坐标
    * @param ex 边界框右下角x坐标
@@ -28,7 +28,7 @@ declare namespace paddleOcr {
    * }
    */
   function recognize(
-    input: string | null,
+    input: string,
     x: number,
     y: number,
     ex: number,

package/types/system.d.ts

@@ -132,15 +132,16 @@ declare namespace system {
   function notify(msg: string, title: string, id: string): void;
   /**
    * 获取内存使用信息
-   * @returns 内存使用信息，包含已使用内存、可用内存和总内存（单位：MB）
+   * @returns 内存使用信息，包含已使用内存、可用内存、总内存和使用率（单位：MB）
    * @example
    * const memInfo = system.getMemoryInfo()
-   * logger.info(`已使用: ${memInfo.used}MB, 可用: ${memInfo.available}MB, 总计: ${memInfo.total}MB`)
+   * logger.info(`已使用: ${memInfo.used}MB, 可用: ${memInfo.available}MB, 总计: ${memInfo.total}MB, 使用率: ${memInfo.usagePercentage}%`)
    */
   function getMemoryInfo(): {
     used: number;
     available: number;
     total: number;
+    usagePercentage: number;
   };
   /**
    * 获取已使用内存
@@ -168,4 +169,16 @@ declare namespace system {
    * }
    */
   function startWDA(): boolean;
+  /**
+   * 获取 WDA 状态
+   * @returns WDA 是否正在运行
+   * @example
+   * const isRunning = system.getWDAStatus()
+   * if (isRunning) {
+   *   logger.info("WDA 服务正在运行")
+   * } else {
+   *   logger.info("WDA 服务未运行")
+   * }
+   */
+  function getWDAStatus(): boolean;
 }

package/types/tomatoOcr.d.ts

@@ -6,15 +6,15 @@ declare namespace tomatoOcr {
   /**
    * 初始化TomatoOCR并设置基本配置
    * @param mode 运行模式 debug：调试模型；删除或传别的任何值为正式模式
-   * @param licenseData 许可证数据
+   * @param licenseData 授权码 请传入你在 TomatoOCR 官网申请的授权码
    * @param remark 备注信息（可选）
    * @returns 设置结果
    * @example
    * ```typescript
    * // 不带备注
-   * const result1 = tomatoOcr.initializeWithConfig("online", "your_license_data");
+   * const result1 = tomatoOcr.initializeWithConfig("online", "授权码");
    * // 带备注
-   * const result2 = tomatoOcr.initializeWithConfig("online", "your_license_data", "测试环境");
+   * const result2 = tomatoOcr.initializeWithConfig("online", "授权码", "测试环境");
    * logger.info(result1, result2);
    * ```
    */
@@ -140,7 +140,7 @@ declare namespace tomatoOcr {
 
   /**
    * 对图像执行 OCR 识别
-   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，null表示使用当前屏幕）
+   * @param input 输入源（imageId、URL字符串、文件路径或"screen"，"screen"表示使用当前屏幕）
    * @param type 识别类型 默认3: 检测 + 识别；0: 只检测；1: 方向分类+识别；2: 只识别；3: 检测+识别
    * @param x 边界框左上角x坐标
    * @param y 边界框左上角y坐标
@@ -150,7 +150,7 @@ declare namespace tomatoOcr {
    * @example
    * ```typescript
    * // 识别屏幕
-   * const result1 = tomatoOcr.ocrImage(null, 0, 0, 0, 0, 0);
+   * const result1 = tomatoOcr.ocrImage("screen", 0, 0, 0, 0, 0);
    * logger.info(`识别屏幕结果：${result1}`);
    *
    * // 识别文件
@@ -163,7 +163,7 @@ declare namespace tomatoOcr {
    * ```
    */
   function ocrImage(
-    input: string | null,
+    input: string,
     type: number,
     x: number,
     y: number,

package/types/yolo.d.ts

@@ -68,17 +68,17 @@ declare namespace yolo {
   /**
    * 目标检测
    * @param modelId 模型ID
-   * @param img 图像ID，默认null用当前屏幕检测，可以填入图像ID或者http图片地址或文件地址
+   * @param img 图像ID，"screen"用当前屏幕检测，可以填入图像ID或者http图片地址或文件地址
    * @param targetSize 图像进入后缩放的检测大小，模型训练一般都用640，因此这里的640一般不要改
    * @param threshold 置信度，默认0.4，小于这个值的会被过滤掉
    * @param nmsThreshold 重叠阈值，一般是0.5不需要更改
    * @returns 检测结果数组
    * @example
-   * const results = yolo.detect(modelId, null, 640, 0.4, 0.5)
+   * const results = yolo.detect(modelId, "screen", 640, 0.4, 0.5)
    */
   function detect(
     modelId: string,
-    img: string | null,
+    img: string,
     targetSize?: number,
     threshold?: number,
     nmsThreshold?: number