ms-types 0.9.29 → 0.9.31

package/package.json

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

package/types/image.d.ts

@@ -252,6 +252,9 @@ declare namespace image {
    * @param options.scaleFactors 仅 method=99 生效。模板缩放比例列表（不是屏幕 scale）。
    *   应围绕 baseScale=当前设备宽/截模板设备宽 生成，例如 baseScale 附近 ±0.05~0.1 共 3~7 档；
    *   默认 [1.0, 0.9, 1.1, 0.8, 1.2] 只适合尺寸接近时的盲扫，跨大分辨率请按设备动态计算。
+   * @param options.orz 查找方向 1-8，与 findColor 的 orz 相同。不传或非 1-8 时仍按相似度从高到低返回；
+   *   传入 1-8 时按该方向取前 limit 个达标结果。limit=1 时只返回该方向第一个，不必把其余命中都找出来。
+   *   method 0（SIFT）会先完成匹配再按方向排序截取。
    * @returns 图片数组；method=99 时结果额外含 scaleX/scaleY
    * @example
    * const points = image.findImage("screen", "template.jpg", 0, 0, 100, 100, 0.9, 1, 5, false)
@@ -272,6 +275,7 @@ declare namespace image {
     rgb?: boolean,
     options?: {
       scaleFactors?: number[];
+      orz?: number;
     },
   ): {
     index: number;

package/types/lua/README.md

@@ -10,4 +10,4 @@
 }
 ```
 
-不要把本目录复制进脚本项目根目录。`Sleep`、`HidKey` 等裸全局会随 library 自动加载。
+不要把本目录复制进脚本项目根目录。每个模块文件用 `---@meta <require名>` 和 `package.loaded['<require名>']` 对齐运行时 `require`，例如 `require("cv")`、`require("dotocr")`、`require("yolocls")`。`Sleep`、`HidKey` 等裸全局会随 library 自动加载。

package/types/lua/action.lua

@@ -229,4 +229,5 @@ function _Action.createBuilder()
     return ret
 end
 
+package.loaded['action'] = _Action
 return _Action

package/types/lua/appleocr.lua

@@ -112,4 +112,5 @@ function _AppleOCR.findTextAbs(input, targets, x, y, ex, ey, langs, exactMatch)
     return ret
 end
 
+package.loaded['appleocr'] = _AppleOCR
 return _AppleOCR

package/types/lua/config.lua

@@ -31,4 +31,5 @@ function _Config.getKuiConfig() return {} end
 ---@return boolean
 function _Config.remove(key) return true end
 
+package.loaded['config'] = _Config
 return _Config

package/types/lua/device.lua

@@ -102,4 +102,5 @@ function _Device.getLanIp() return '' end
 ---@param intensity number 0.0-1.0
 function _Device.vibrate(duration, intensity) end
 
+package.loaded['device'] = _Device
 return _Device

package/types/lua/file.lua

@@ -93,4 +93,5 @@ function _File.copy(src, dest) return true end
 --- @return string|nil MD5值
 function _File.fileMD5(path) return '' end
 
+package.loaded['file'] = _File
 return _File

package/types/lua/hid.lua

@@ -271,4 +271,5 @@ function _HID.currentAppInfo()
     return ret
 end
 
+package.loaded['hid'] = _HID
 return _HID

package/types/lua/hotupdate.lua

@@ -20,4 +20,5 @@ function _HotUpdate.downloadAndInstall() return {updated = true, error = nil} en
 --- @return integer 版本号
 function _HotUpdate.getCurrentVersion() return 0 end
 
+package.loaded['hotupdate'] = _HotUpdate
 return _HotUpdate

package/types/lua/http.lua

@@ -141,4 +141,5 @@ function _WebSocket.onBinary(fn) end
 --- @param fn fun(error:string)
 function _WebSocket.onError(fn) end
 
+package.loaded['http'] = _Http
 return _Http

package/types/lua/image.lua

@@ -129,11 +129,12 @@ function _Image.cmpColor(id, points, threshold) return true end
 --- @param ey integer|nil 右下y
 --- @param threshold number 相似度 0.0-1.0
 --- @param limit integer|nil 限制个数
---- @param method integer|nil 匹配方法 1|3|5
+--- @param method integer|nil 匹配方法 0|1|3|5|99
 --- @param rgb boolean|nil 是否使用RGB
+--- @param options table|nil 选项。scaleFactors 仅 method=99；orz 为查找方向 1-8（与 findColor 相同）
 --- @return Rect[] 结果矩形列表
 function _Image.findImage(id, templateImageId, x, y, ex, ey, threshold, limit,
-                          method, rgb) return {} end
+                          method, rgb, options) return {} end
 
 --- 多点找色
 --- @param id string 图片ID
@@ -202,4 +203,5 @@ function _Image.drawRect(id, x, y, ex, ey, color, thickness) end
 --- 释放所有图片
 function _Image.releaseAll() end
 
+package.loaded['image'] = _Image
 return _Image

package/types/lua/ime.lua

@@ -45,4 +45,5 @@ function _Ime.getClipboard() return '' end
 --- @return boolean 成功
 function _Ime.setClipboard(text) return true end
 
+package.loaded['ime'] = _Ime
 return _Ime

package/types/lua/logger.lua

@@ -45,4 +45,5 @@ function _Logger.warn(...) end
 --- @return nil
 function _Logger.error(...) end
 
+package.loaded['logger'] = _Logger
 return _Logger

package/types/lua/media.lua

@@ -43,4 +43,5 @@ function _Media.deleteAllVideos() return true end
 --- @return boolean 成功
 function _Media.deleteAllScreenshots() return true end
 
+package.loaded['media'] = _Media
 return _Media

package/types/lua/mysql.lua

@@ -61,4 +61,5 @@ function _MySQL.commit() return true end
 --- @return boolean 成功
 function _MySQL.rollback() return true end
 
+package.loaded['mysql'] = _MySQL
 return _MySQL

package/types/lua/netcard.lua

@@ -42,4 +42,5 @@ function _NetCard.setValue(key, value) return '' end
 --- @return string 值
 function _NetCard.getValue(key) return '' end
 
+package.loaded['netcard'] = _NetCard
 return _NetCard

package/types/lua/node.lua

@@ -82,4 +82,5 @@ function _Node.createNodeSelector(params)
     return ret
 end
 
+package.loaded['node'] = _Node
 return _Node

package/types/lua/paddleocr.lua

@@ -96,4 +96,5 @@ end
 --- 释放资源
 function _PaddleOCR.free() end
 
+package.loaded['paddleocr'] = _PaddleOCR
 return _PaddleOCR

package/types/lua/pip.lua

@@ -53,4 +53,5 @@ function _Pip.setCustomTextSize(fontSize) return true end
 ---@return boolean
 function _Pip.setCustomBackgroundColor(color) return true end
 
+package.loaded['pip'] = _Pip
 return _Pip

package/types/lua/system.lua

@@ -136,4 +136,5 @@ function _System.getAgentStatus() return false end
 --- @return boolean 成功
 function _System.stopAgent() return true end
 
+package.loaded['system'] = _System
 return _System

package/types/lua/tomatoocr.lua

@@ -80,4 +80,5 @@ function _TomatoOCR.findTapPoints(js) return '' end
 --- 释放已加载的 OCR 模型和内部资源
 function _TomatoOCR.release() end
 
+package.loaded['tomatoocr'] = _TomatoOCR
 return _TomatoOCR

package/types/lua/tts.lua

@@ -39,4 +39,5 @@ function _TTS.getAvailableVoices() return {} end
 --- 释放 TTS 资源
 function _TTS.free() end
 
+package.loaded['tts'] = _TTS
 return _TTS

package/types/lua/ui.lua

@@ -43,4 +43,5 @@ function _UI.call(key, data) end
 --- @param code string 代码
 function _UI.eval(code) end
 
+package.loaded['ui'] = _UI
 return _UI

package/types/lua/utils.lua

@@ -46,4 +46,5 @@ function _Utils.hexStringBase64Encoded(hexString) return '' end
 --- @return string hex
 function _Utils.hexStringBase64Decoded(base64HexString) return '' end
 
+package.loaded['utils'] = _Utils
 return _Utils

package/types/lua/yolo.lua

@@ -60,4 +60,5 @@ function _Yolo.free(id) end
 --- 释放全部模型
 function _Yolo.freeAll() end
 
+package.loaded['yolo'] = _Yolo
 return _Yolo

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

@@ -250,6 +250,9 @@ declare namespace $图片 {
    * @param 选项.scaleFactors 仅方法=99 生效。模板缩放比例列表（不是屏幕 scale）。
    *   应围绕 baseScale=当前设备宽/截模板设备宽 生成，例如 baseScale 附近 ±0.05~0.1 共 3~7 档；
    *   默认 [1.0, 0.9, 1.1, 0.8, 1.2] 只适合尺寸接近时的盲扫，跨大分辨率请按设备动态计算。
+   * @param 选项.orz 查找方向 1-8，与单点找色的查找方向相同。不传或非 1-8 时仍按相似度从高到低返回；
+   *   传入 1-8 时按该方向取前限制数量个达标结果。限制数量=1 时只返回该方向第一个，不必把其余命中都找出来。
+   *   方法 0（SIFT）会先完成匹配再按方向排序截取。
    * @returns 图片数组；方法=99 时结果额外含 scaleX/scaleY
    * @example
    * const 图片数组 = $图片.找图("screen", "template.jpg", 0, 0, 100, 100, 0.9, 1, 5, false)
@@ -270,6 +273,7 @@ declare namespace $图片 {
     是否使用RGB找图?: 布尔值,
     选项?: {
       scaleFactors?: 数字[];
+      orz?: 数字;
     },
   ): {
     index: 数字;