ms-types 0.9.39 → 0.9.41

package/package.json

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

package/types/hid.d.ts

@@ -93,7 +93,7 @@ declare namespace hid {
   function getDeviceVersion(): string;
 
   /**
-   * 复位坐标到左上角 只有相对鼠标需要
+   * 复位坐标到左下角 只有相对鼠标需要
    * @returns 操作是否成功
    */
   function resetPosition(): boolean;
@@ -104,6 +104,13 @@ declare namespace hid {
    */
   function restartDevice(): boolean;
 
+  /**
+   * 开关充电。当前连接的 HID 不支持时返回 false。
+   * @param on true 打开充电，false 关闭充电
+   * @returns 是否成功发送
+   */
+  function setCharging(on: boolean): boolean;
+
   /**
    * 设置动作抖动值
    * @param value 抖动值

package/types/image.d.ts

@@ -293,6 +293,33 @@ declare namespace image {
     /** 仅 method=99 返回：命中时模板的纵向缩放比例 */
     scaleY?: number;
   }[];
+  /**
+   * 按 kjst 模板找图
+   * @param imageId 图片id，通常为 `"screen"`
+   * @param kjstPath res 下的 kjst 文件名，不要带 `res/` 前缀
+   * @returns 矩形数组，坐标已换算到传入图片（`screen` 即屏幕）像素，可直接 click；OCR 命中额外含 `text`
+   * @example
+   * const hits = image.findImageEx("screen", "login.kjst")
+   * if (hits.length > 0) {
+   *   logi(hits[0].x, hits[0].y)
+   * }
+   */
+  function findImageEx(
+    imageId: string,
+    kjstPath: string,
+  ): {
+    index: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    confidence: number;
+    centerX: number;
+    centerY: number;
+    ex: number;
+    ey: number;
+    text?: string;
+  }[];
   /**
    * 裁剪图片
    * @param imageId 图片id

package/types/lua/hid.lua

@@ -77,7 +77,7 @@ function _HID.mouseUp() return true end
 --- @return boolean 成功
 function _HID.click(x, y, duration, jitter) return true end
 
---- 复位坐标到左上角（仅相对鼠标模式需要）
+--- 复位坐标到左下角（仅相对鼠标模式需要）
 --- @return boolean 成功
 function _HID.resetPosition() return true end
 
@@ -122,6 +122,11 @@ function _HID.getDeviceVersion() return '' end
 --- @return boolean 成功
 function _HID.restartDevice() return true end
 
+--- 开关充电。当前连接的 HID 不支持时返回 false。
+--- @param on boolean true 打开充电，false 关闭充电
+--- @return boolean 成功
+function _HID.setCharging(on) return true end
+
 --- 随机点击
 --- @param x1 integer
 --- @param y1 integer

package/types/lua/image.lua

@@ -23,6 +23,7 @@ local _Image = {}
 ---@field ey integer 右下角y坐标
 ---@field scaleX number|nil 仅 method=99：命中时模板横向缩放
 ---@field scaleY number|nil 仅 method=99：命中时模板纵向缩放
+---@field text string|nil OCR 命中文字
 
 ---@class FindImageOptions
 ---@field scaleFactors number[]|nil 仅 method=99：模板缩放比例列表
@@ -144,6 +145,12 @@ function _Image.cmpColor(id, points, threshold) return true end
 function _Image.findImage(id, templateImageId, x, y, ex, ey, threshold, limit,
                           method, rgb, options) return {} end
 
+--- 按 kjst 模板找图
+--- @param id string 图片ID，通常为 screen
+--- @param kjstPath string res 下的 kjst 文件名
+--- @return Rect[] 结果矩形，坐标已换算到传入图（screen 即屏幕）像素，可直接 click；OCR 命中含 text
+function _Image.findImageEx(id, kjstPath) return {} end
+
 --- 多点找色
 --- @param id string 图片ID
 --- @param firstColor string 首色 "#RRGGBB" 或 "#RRGGBB"

package/types/lua/yolo.lua

@@ -14,11 +14,11 @@ local _Yolo = {}
 ---@field confidence number 置信度
 ---@field classId integer 类别 ID
 
---- 加载 YOLO 模型（版本 8/11/26）
+--- 加载 YOLO 模型（版本 5/8/11/26）
 --- @param paramPath string ncnn param 路径
 --- @param binPath string ncnn bin 路径
 --- @param nc integer|nil 标签数量；传 0 或省略时按模型输出推断
---- @param version integer|nil 模型版本，缺省 0 按 v11 处理
+--- @param version integer|nil 模型版本，缺省 0 按 v11 处理；5 为官方 YOLOv5 6.0/6.2/7.0，兼容官方 export 单输出和三头原始特征
 --- @param useGpu boolean|nil 是否启用 GPU，默认 false
 --- @return string|nil 模型ID（失败返回 nil）
 function _Yolo.load(paramPath, binPath, nc, version, useGpu) return nil end

package/types/yolo.d.ts

@@ -52,7 +52,7 @@ declare namespace yolo {
    * @param paramPath ncnn模型的param文件的绝对路径
    * @param binPath ncnn模型的bin文件绝对路径
    * @param nc 模型的标签数量；传 0 或省略时根据模型输出自动推断，显式传入但不匹配时检测返回空数组
-   * @param version 模型版本，默认11, 支持 8 11 26
+   * @param version 模型版本，默认11, 支持 5 8 11 26。5 为官方 YOLOv5 6.0/6.2/7.0，兼容官方 export 单输出和三头原始特征
    * @param useGpu 是否使用 GPU 加载
    * @returns 加载成功返回模型ID字符串，失败返回null
    * @example

package/types/zh/HID/346/250/241/345/235/227.d.ts

@@ -95,7 +95,7 @@ declare namespace $HID {
   function 获取设备版本(): 字符串;
 
   /**
-   * 复位坐标到左上角 只有相对鼠标需要
+   * 复位坐标到左下角 只有相对鼠标需要
    * @returns 操作是否成功
    */
   function 复位坐标(): 布尔值;
@@ -106,6 +106,13 @@ declare namespace $HID {
    */
   function 重启设备(): 布尔值;
 
+  /**
+   * 开关充电。当前连接的 HID 不支持时返回 false。
+   * @param 打开 true 打开充电，false 关闭充电
+   * @returns 是否成功发送
+   */
+  function 设置充电(打开: 布尔值): 布尔值;
+
   /**
    * 设置动作抖动值
    * @param 抖动值

package/types/zh/YOLO/346/250/241/345/235/227.d.ts

@@ -55,7 +55,7 @@ declare namespace $YOLO {
    * @param ncnn模型的param文件路径 ncnn模型的param文件的绝对路径
    * @param ncnn模型的bin文件路径 ncnn模型的bin文件绝对路径
    * @param 标签数量 模型的标签数量；传 0 或省略时根据模型输出自动推断，显式传入但不匹配时检测返回空数组
-   * @param 模型版本 模型版本，默认11, 支持 8 11 26
+   * @param 模型版本 模型版本，默认11, 支持 5 8 11 26。5 为官方 YOLOv5 6.0/6.2/7.0，兼容官方 export 单输出和三头原始特征
    * @param useGpu 是否使用 GPU 加载
    * @returns 加载成功返回模型ID字符串，失败返回null
    * @example

package/types/zh//345/233/276/347/211/207/346/250/241/345/235/227.d.ts

@@ -291,6 +291,33 @@ declare namespace $图片 {
     /** 仅方法=99 返回：命中时模板的纵向缩放比例 */
     scaleY?: 数字;
   }[];
+  /**
+   * 按 kjst 模板找图
+   * @param 图片ID 图片id，通常为 `"screen"`
+   * @param kjst路径 res 下的 kjst 文件名，不要带 `res/` 前缀
+   * @returns 矩形数组，坐标已换算到传入图片（`screen` 即屏幕）像素，可直接点击；OCR 命中额外含 `text`
+   * @example
+   * const 命中 = $图片.找图Ex("screen", "login.kjst")
+   * if (命中.length > 0) {
+   *   $打印信息日志(命中[0].x, 命中[0].y)
+   * }
+   */
+  function 找图Ex(
+    图片ID: 字符串,
+    kjst路径: 字符串,
+  ): {
+    index: 数字;
+    x: 数字;
+    y: 数字;
+    width: 数字;
+    height: 数字;
+    confidence: 数字;
+    centerX: 数字;
+    centerY: 数字;
+    ex: 数字;
+    ey: 数字;
+    text?: 字符串;
+  }[];
   /**
    * 裁剪图片
    * @param 图片ID