ms-types 0.9.38 → 0.9.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.9.38",
+  "version": "0.9.40",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -18,6 +18,6 @@
   "devDependencies": {
     "vitepress": "^1.6.4",
     "vitepress-theme-teek": "^1.6.2",
-    "wrangler": "^4.118.0"
+    "wrangler": "^4.125.0"
   }
 }

package/types/hid.d.ts

@@ -117,6 +117,13 @@ declare namespace hid {
    */
   function setActionDelay(milliseconds: number): boolean;
 
+  /**
+   * 设置移动完成后的等待毫秒。不调用时固件默认 40ms。
+   * @param milliseconds 0 关闭等待，大于 0 覆盖为指定毫秒，小于 0 恢复默认
+   * @returns 操作是否成功
+   */
+  function setMoveDelay(milliseconds: number): boolean;
+
   /**
    * 移动指定坐标
    * @param x 移动坐标的X轴

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

@@ -50,6 +50,11 @@ function _HID.setJitterValue(value) end
 --- @return boolean 成功
 function _HID.setActionDelay(milliseconds) return true end
 
+--- 设置移动完成后的等待毫秒。不调用时固件默认 40ms。
+--- @param milliseconds integer 0 关闭等待，大于 0 覆盖毫秒，小于 0 恢复默认
+--- @return boolean 成功
+function _HID.setMoveDelay(milliseconds) return true end
+
 --- 移动
 --- @param x integer
 --- @param y 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

@@ -119,6 +119,13 @@ declare namespace $HID {
    */
   function 设置动作延迟(毫秒: 数字): 布尔值;
 
+  /**
+   * 设置移动完成后的等待毫秒。不调用时固件默认 40ms。
+   * @param 毫秒 0 关闭等待，大于 0 覆盖毫秒，小于 0 恢复默认
+   * @returns 操作是否成功
+   */
+  function 设置移动延迟(毫秒: 数字): 布尔值;
+
   /**
    * 移动指定坐标
    * @param 坐标x 移动坐标的X轴

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