ms-types 0.9.25 → 0.9.27

package/package.json

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

package/types/image.d.ts

@@ -21,15 +21,15 @@ declare namespace image {
     ex?: number,
     ey?: number,
   ): string | null;
-  /**
-   * 截图
-   * @returns 截图的imageId ，如果截图失败则返回null
-   * @deprecated 请改用 captureScreen()。
-   * @example
-   * const imageId = image.captureScreen()
-   * if (imageId) {
-   *   image.saveTo(imageId, "screen.jpg")
-   * }
+  /**
+   * 截图
+   * @returns 截图的imageId ，如果截图失败则返回null
+   * @deprecated 请改用 captureScreen()。
+   * @example
+   * const imageId = image.captureScreen()
+   * if (imageId) {
+   *   image.saveTo(imageId, "screen.jpg")
+   * }
    */
   function captureFullScreen(): string | null;
   /**
@@ -37,14 +37,14 @@ declare namespace image {
    * @param x 截图区域左上角x坐标
    * @param y 截图区域左上角y坐标
    * @param ex 截图区域右下角x坐标
-   * @param ey 截图区域右下角y坐标
-   * @returns 截图的imageId ，如果截图失败则返回null
-   * @deprecated 请改用 captureScreen(x, y, ex, ey)。
-   * @example
-   * const imageId = image.captureScreen(0, 0, 100, 100)
-   * if (imageId) {
-   *   image.saveTo(imageId, "screen.jpg")
-   * }
+   * @param ey 截图区域右下角y坐标
+   * @returns 截图的imageId ，如果截图失败则返回null
+   * @deprecated 请改用 captureScreen(x, y, ex, ey)。
+   * @example
+   * const imageId = image.captureScreen(0, 0, 100, 100)
+   * if (imageId) {
+   *   image.saveTo(imageId, "screen.jpg")
+   * }
    */
   function captureRect(
     x: number,
@@ -63,11 +63,11 @@ declare namespace image {
   /**
    * 图片是否已释放
    * @param imageId 图片id
-   * @returns true 已释放 false 未释放
-   * @example
-   * const imageId = image.captureScreen()
-   * if (imageId) {
-   *   image.saveTo(imageId, "screen.jpg")
+   * @returns true 已释放 false 未释放
+   * @example
+   * const imageId = image.captureScreen()
+   * if (imageId) {
+   *   image.saveTo(imageId, "screen.jpg")
    *   image.isRelease(imageId) // false
    *   image.release(imageId)
    *   image.isRelease(imageId) // true
@@ -249,8 +249,10 @@ declare namespace image {
    * @param method 方法
    * @param rgb 是否使用RGB找图，默认false
    * @param options 选项
-   * @param options.scaleFactors 缩放匹配法缩放因子数组，默认[1.0, 0.9, 1.1, 0.8, 1.2]
-   * @returns 图片数组
+   * @param options.scaleFactors 仅 method=99 生效。模板缩放比例列表（不是屏幕 scale）。
+   *   应围绕 baseScale=当前设备宽/截模板设备宽 生成，例如 baseScale 附近 ±0.05~0.1 共 3~7 档；
+   *   默认 [1.0, 0.9, 1.1, 0.8, 1.2] 只适合尺寸接近时的盲扫，跨大分辨率请按设备动态计算。
+   * @returns 图片数组；method=99 时结果额外含 scaleX/scaleY
    * @example
    * const points = image.findImage("screen", "template.jpg", 0, 0, 100, 100, 0.9, 1, 5, false)
    * if (points.length > 0) {
@@ -282,6 +284,10 @@ declare namespace image {
     centerY: number;
     ex: number;
     ey: number;
+    /** 仅 method=99 返回：命中时模板的横向缩放比例 */
+    scaleX?: number;
+    /** 仅 method=99 返回：命中时模板的纵向缩放比例 */
+    scaleY?: number;
   }[];
   /**
    * 裁剪图片

package/types/lua/README.md

@@ -0,0 +1,13 @@
+# Lua EmmyLua 类型提示
+
+随 `ms-types` npm 包发布。安装依赖后，在项目 `.vscode/settings.json` 写入：
+
+```json
+{
+  "Lua.workspace.library": ["./node_modules/ms-types/types/lua"],
+  "Lua.runtime.version": "Lua 5.4",
+  "Lua.workspace.checkThirdParty": false
+}
+```
+
+不要把本目录复制进脚本项目根目录。`Sleep`、`HidKey` 等裸全局会随 library 自动加载。

package/types/lua/action.lua

@@ -0,0 +1,232 @@
+---@meta action
+---@class Action
+local _Action = {}
+
+--- 设置动作抖动值
+--- @param value integer 抖动值
+function _Action.setJitterValue(value) end
+
+--- 点击
+--- @param x integer
+--- @param y integer
+--- @param duration integer|nil 按下持续时间，默认20ms
+--- @param jitter boolean|nil 是否抖动，默认false
+--- @return boolean 成功与否
+function _Action.click(x, y, duration, jitter) return true end
+
+--- 随机点击
+--- @param x1 integer
+--- @param y1 integer
+--- @param x2 integer
+--- @param y2 integer
+--- @param duration integer|nil 按下持续时间
+--- @return boolean 成功与否
+function _Action.clickRandom(x1, y1, x2, y2, duration) return true end
+
+--- 双击
+--- @param x integer
+--- @param y integer
+--- @param duration integer|nil 按下持续时间，默认20ms
+--- @param interval integer|nil 双击间隔，默认20ms
+--- @param jitter boolean|nil 是否抖动
+--- @return boolean 成功与否
+function _Action.doubleClick(x, y, duration, interval, jitter) return true end
+
+--- 随机双击
+--- @param x1 integer
+--- @param y1 integer
+--- @param x2 integer
+--- @param y2 integer
+--- @param duration integer|nil 持续时间
+--- @param interval integer|nil 间隔时间
+--- @return boolean 成功与否
+function _Action.doubleClickRandom(x1, y1, x2, y2, duration, interval)
+    return true
+end
+
+--- 直线滑动
+--- @param startX integer
+--- @param startY integer
+--- @param endX integer
+--- @param endY integer
+--- @param duration integer|nil 总持续时间
+--- @param jitter boolean|nil 是否抖动
+--- @param steps integer|nil 步数
+--- @return boolean 成功与否
+function _Action.swipe(startX, startY, endX, endY, duration, jitter, steps)
+    return true
+end
+
+--- 长按并滑动
+--- @param startX integer
+--- @param startY integer
+--- @param endX integer
+--- @param endY integer
+--- @param touchDown integer|nil 按下时长
+--- @param touchMove integer|nil 移动时长
+--- @param touchUp integer|nil 抬起时长
+--- @param jitter boolean|nil 是否抖动
+--- @param steps integer|nil 步数
+--- @return boolean 成功与否
+function _Action.pressAndSwipe(startX, startY, endX, endY, touchDown, touchMove,
+                               touchUp, jitter, steps) return true end
+
+--- 曲线滑动
+--- @param startX integer
+--- @param startY integer
+--- @param midX integer
+--- @param midY integer
+--- @param endX integer
+--- @param endY integer
+--- @param duration integer 总时长
+--- @return boolean 成功与否
+function _Action.swipeCurve(startX, startY, midX, midY, endX, endY, duration)
+    return true
+end
+
+--- 输入文本
+--- @param text string 文本
+--- @return boolean 成功与否
+function _Action.input(text) return true end
+
+--- 基础文本输入（不支持中文，走键盘按键）
+--- @param text string ASCII 文本
+--- @return boolean 成功与否
+function _Action.inputSimple(text) return true end
+
+--- 删除文本
+--- @param count integer|nil 删除数量，默认1
+--- @return boolean 成功与否
+function _Action.backspace(count) return true end
+
+--- 回车
+--- @return boolean 成功与否
+function _Action.enter() return true end
+
+--- 回到主页
+--- @return boolean 成功与否
+function _Action.homeScreen() return true end
+
+--- 按键
+--- @param name string 按键名称
+--- @return boolean 成功与否
+function _Action.pressButton(name) return true end
+
+--- 发送键盘组合键（标准 USB HID usage）
+--- @param keys (string|integer)[] 按键数组
+--- @return boolean 成功与否
+function _Action.sendKey(keys) return true end
+
+--- 执行 W3C Actions JSON
+--- @param json table W3C Actions 请求体
+--- @return boolean 成功与否
+function _Action.w3cActions(json) return true end
+
+---@class TapPoint
+---@field x integer 坐标X
+---@field y integer 坐标Y
+
+---@class ActionBuilder
+local _ActionBuilder = {}
+
+--- 添加手指
+--- @param id integer 指针编号
+--- @return Pointer 返回指针对象
+function _ActionBuilder:addPointer(id)
+    ---@type Pointer
+    local ret
+    return ret
+end
+
+--- 单指点击
+--- @param x integer
+--- @param y integer
+--- @param duration integer|nil 按下持续时间，默认20ms
+--- @return ActionBuilder self
+function _ActionBuilder:singleTap(x, y, duration)
+    ---@type ActionBuilder
+    local ret
+    return ret
+end
+
+--- 多指同时点击
+--- @param points TapPoint[] 坐标数组
+--- @param duration integer|nil 按下持续时间，默认20ms
+--- @return ActionBuilder self
+function _ActionBuilder:multiTap(points, duration)
+    ---@type ActionBuilder
+    local ret
+    return ret
+end
+
+--- 执行动作
+--- @return boolean 成功与否
+function _ActionBuilder:execute() return true end
+
+---@class Pointer
+local _Pointer = {}
+
+--- 移动到
+--- @param x integer
+--- @param y integer
+--- @param duration integer|nil 持续时间
+--- @return Pointer self
+function _Pointer:moveTo(x, y, duration)
+    ---@type Pointer
+    local ret
+    return ret
+end
+
+--- 按下
+--- @return Pointer self
+function _Pointer:down()
+    ---@type Pointer
+    local ret
+    return ret
+end
+
+--- 抬起
+--- @return Pointer self
+function _Pointer:up()
+    ---@type Pointer
+    local ret
+    return ret
+end
+
+--- 停留
+--- @param duration integer 停留时间，默认20ms
+--- @return Pointer self
+function _Pointer:stay(duration)
+    ---@type Pointer
+    local ret
+    return ret
+end
+
+--- 点击
+--- @param x integer
+--- @param y integer
+--- @param duration integer|nil 按下持续时间，默认20ms
+--- @return Pointer self
+function _Pointer:tap(x, y, duration)
+    ---@type Pointer
+    local ret
+    return ret
+end
+
+--- 完成，返回构建器
+--- @return ActionBuilder builder
+function _Pointer:done()
+    ---@type ActionBuilder
+    local ret
+    return ret
+end
+
+--- 创建构建器
+--- @return ActionBuilder builder
+function _Action.createBuilder()
+    ---@type ActionBuilder
+    local ret
+    return ret
+end
+
+return _Action

package/types/lua/alias/cv.lua

@@ -0,0 +1,2 @@
+---@meta cv
+return require("opencv")

package/types/lua/alias/dotOcr.lua

@@ -0,0 +1,2 @@
+---@meta dotOcr
+return require("dotocr")

package/types/lua/alias/yoloCls.lua

@@ -0,0 +1,2 @@
+---@meta yoloCls
+return require("yolocls")

package/types/lua/appleocr.lua

@@ -0,0 +1,115 @@
+---@meta appleocr
+---@class AppleOCR
+local _AppleOCR = {}
+
+---@class AppleOCRResult
+---@field text string 识别的文本内容
+---@field confidence number 识别置信度 (0-1)
+---@field x integer 文本区域左上角 x 坐标
+---@field y integer 文本区域左上角 y 坐标
+---@field ex integer 文本区域右下角 x 坐标
+---@field ey integer 文本区域右下角 y 坐标
+---@field width integer 文本区域宽度
+---@field height integer 文本区域高度
+---@field centerX integer 文本区域中心点 x 坐标
+---@field centerY integer 文本区域中心点 y 坐标
+
+--- 识别文本
+--- @param input string 图像ID或路径
+--- @param x integer|nil 区域X，默认0
+--- @param y integer|nil 区域Y，默认0
+--- @param ex integer|nil 区域右下角 X，默认0
+--- @param ey integer|nil 区域右下角 Y，默认0
+--- @param langs string[]|nil 语言数组
+--- @return AppleOCRResult[] 结果数组
+function _AppleOCR.recognize(input, x, y, ex, ey, langs)
+    x = x or 0;
+    y = y or 0;
+    ex = ex or 0;
+    ey = ey or 0
+    ---@type AppleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 识别文本，坐标映射为原图/全屏绝对坐标
+--- @param input string 图像ID或路径
+--- @param x integer|nil 区域X，默认0
+--- @param y integer|nil 区域Y，默认0
+--- @param ex integer|nil 区域右下角 X，默认0
+--- @param ey integer|nil 区域右下角 Y，默认0
+--- @param langs string[]|nil 语言数组
+--- @return AppleOCRResult[] 结果数组
+function _AppleOCR.recognizeAbs(input, x, y, ex, ey, langs)
+    ---@type AppleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 识别数字
+--- @param input string 图像ID或路径
+--- @param x integer|nil 区域X，默认0
+--- @param y integer|nil 区域Y，默认0
+--- @param ex integer|nil 区域右下角 X，默认0
+--- @param ey integer|nil 区域右下角 Y，默认0
+--- @return AppleOCRResult[] 结果数组
+function _AppleOCR.recognizeNumbers(input, x, y, ex, ey)
+    x = x or 0;
+    y = y or 0;
+    ex = ex or 0;
+    ey = ey or 0
+    ---@type AppleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 识别数字，坐标映射为原图/全屏绝对坐标
+--- @param input string 图像ID或路径
+--- @param x integer|nil 区域X，默认0
+--- @param y integer|nil 区域Y，默认0
+--- @param ex integer|nil 区域右下角 X，默认0
+--- @param ey integer|nil 区域右下角 Y，默认0
+--- @return AppleOCRResult[] 结果数组
+function _AppleOCR.recognizeNumbersAbs(input, x, y, ex, ey)
+    ---@type AppleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 查找文本
+--- @param input string 图像ID或路径
+--- @param targets string[]|string 目标文本数组或逗号分隔字符串
+--- @param x integer|nil 区域X，默认0
+--- @param y integer|nil 区域Y，默认0
+--- @param ex integer|nil 区域右下角 X，默认0
+--- @param ey integer|nil 区域右下角 Y，默认0
+--- @param langs string[]|nil 语言数组
+--- @param exactMatch boolean|nil 是否完整匹配，默认 false
+--- @return AppleOCRResult[] 结果数组
+function _AppleOCR.findText(input, targets, x, y, ex, ey, langs, exactMatch)
+    x = x or 0;
+    y = y or 0;
+    ex = ex or 0;
+    ey = ey or 0
+    ---@type AppleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 查找文本，坐标映射为原图/全屏绝对坐标
+--- @param input string 图像ID或路径
+--- @param targets string[]|string 目标文本数组或逗号分隔字符串
+--- @param x integer|nil 区域X，默认0
+--- @param y integer|nil 区域Y，默认0
+--- @param ex integer|nil 区域右下角 X，默认0
+--- @param ey integer|nil 区域右下角 Y，默认0
+--- @param langs string[]|nil 语言数组
+--- @param exactMatch boolean|nil 是否完整匹配，默认 false
+--- @return AppleOCRResult[] 结果数组
+function _AppleOCR.findTextAbs(input, targets, x, y, ex, ey, langs, exactMatch)
+    ---@type AppleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+return _AppleOCR

package/types/lua/cloud.lua

@@ -0,0 +1,32 @@
+---@meta cloud
+---@class Cloud
+local _Cloud = {}
+
+--- 云控 WebSocket；仅主脚本注册 onEvent
+
+--- connect
+---@param url string
+---@param deviceNo string|nil
+---@return boolean
+function _Cloud.connect(url, deviceNo) return false end
+
+--- isConnected
+---@return boolean
+function _Cloud.isConnected() return false end
+
+--- disconnect
+
+function _Cloud.disconnect() end
+
+--- report
+---@param event string
+---@param data table
+---@return boolean
+function _Cloud.report(event, data) return false end
+
+--- onEvent
+---@param callback fun(event:string, data:table)|nil
+function _Cloud.onEvent(callback) end
+
+package.loaded['cloud'] = _Cloud
+return _Cloud

package/types/lua/config.lua

@@ -0,0 +1,34 @@
+---@meta config
+---@class Config
+local _Config = {}
+
+--- 获取所有配置
+---@return table<string, any>
+function _Config.all() return {} end
+
+--- 用完整表覆盖配置
+---@param config table<string, any>
+---@return boolean
+function _Config.setAll(config) return true end
+
+--- 设置单个配置
+---@param key string
+---@param value any
+---@return boolean
+function _Config.set(key, value) return true end
+
+--- 读取配置
+---@param key string
+---@return any|nil
+function _Config.get(key) return nil end
+
+--- 获取 KUI_CONFIG 表；不存在时返回空表
+---@return table<string, any>
+function _Config.getKuiConfig() return {} end
+
+--- 删除配置
+---@param key string
+---@return boolean
+function _Config.remove(key) return true end
+
+return _Config

package/types/lua/cryptoUtils.lua

@@ -0,0 +1,47 @@
+---@meta cryptoUtils
+---@class CryptoUtils
+local _CryptoUtils = {}
+
+--- encryptWithAES_ECB
+---@param data string
+---@param aesKey string
+---@param noPadding boolean
+---@return string
+function _CryptoUtils.encryptWithAES_ECB(data, aesKey, noPadding) return "" end
+
+--- decryptWithAES_ECB
+---@param data string
+---@param aesKey string
+---@param noPadding boolean
+---@return string
+function _CryptoUtils.decryptWithAES_ECB(data, aesKey, noPadding) return "" end
+
+--- encryptWithRSA
+---@param data string
+---@param publicKeyBase64 string
+---@return string
+function _CryptoUtils.encryptWithRSA(data, publicKeyBase64) return "" end
+
+--- decryptWithRSA
+---@param encryptedData string
+---@param privateKeyBase64 string
+---@return string
+function _CryptoUtils.decryptWithRSA(encryptedData, privateKeyBase64) return "" end
+
+--- md5
+---@param data string
+---@return string
+function _CryptoUtils.md5(data) return "" end
+
+--- sha1
+---@param data string
+---@return string
+function _CryptoUtils.sha1(data) return "" end
+
+--- sha256
+---@param data string
+---@return string
+function _CryptoUtils.sha256(data) return "" end
+
+package.loaded['cryptoUtils'] = _CryptoUtils
+return _CryptoUtils

package/types/lua/device.lua

@@ -0,0 +1,105 @@
+---@meta device
+---@class Device
+local _Device = {}
+
+---@class ScreenSize
+---@field width number 屏幕宽度
+---@field height number 屏幕高度
+
+---@class BatteryInfo
+---@field level integer 电池电量百分比 (0-100)
+---@field isCharging boolean 是否充电中
+
+---@class StorageSpaceInfo
+---@field total number 总容量（GB，十进制）
+---@field free number 剩余容量（GB，十进制）
+---@field unit string 单位，固定 "GB"
+
+--- 获取电池信息
+---@return BatteryInfo
+function _Device.getBatteryInfo()
+    return { level = 0, isCharging = false }
+end
+
+--- 获取存储空间（GB，十进制）
+---@return StorageSpaceInfo
+function _Device.getStorageSpace()
+    return { total = 0, free = 0, unit = 'GB' }
+end
+
+--- 设备 ID（卸载重装会变）
+---@return string
+function _Device.getDeviceID() return '' end
+
+--- 服务器设备 ID（签名不变则卸载重装仍保持）
+---@return string
+function _Device.getServerDeviceId() return '' end
+
+--- ECID
+---@return string
+function _Device.getECID() return '' end
+
+--- UDID
+---@return string
+function _Device.getUDID() return '' end
+
+--- 设备名
+---@return string
+function _Device.getDeviceName() return '' end
+
+--- 设备型号
+---@return string
+function _Device.getDeviceModel() return '' end
+
+--- 屏幕逻辑尺寸
+---@return ScreenSize
+function _Device.getScreenSize()
+    return { width = 0, height = 0 }
+end
+
+--- 屏幕实际尺寸
+---@return ScreenSize
+function _Device.getScreenRealSize()
+    return { width = 0, height = 0 }
+end
+
+--- 屏幕缩放比例
+---@return number
+function _Device.getScreenScale() return 1 end
+
+--- 屏幕亮度 0.0-1.0
+---@return number
+function _Device.getScreenBrightness() return 0 end
+
+--- 设置屏幕亮度 0.0-1.0
+---@param brightness number
+---@return boolean
+function _Device.setScreenBrightness(brightness) return true end
+
+--- 系统音量 0.0-1.0
+---@return number
+function _Device.getVolume() return 0 end
+
+--- 设置系统音量 0.0-1.0
+---@param volume number
+---@return boolean
+function _Device.setVolume(volume) return true end
+
+--- 屏幕方向
+---@return string
+function _Device.getOrientation() return 'PORTRAIT' end
+
+--- 系统版本
+---@return string
+function _Device.getOSVersion() return '' end
+
+--- 局域网 IP
+---@return string
+function _Device.getLanIp() return '' end
+
+--- 震动
+---@param duration integer 毫秒
+---@param intensity number 0.0-1.0
+function _Device.vibrate(duration, intensity) end
+
+return _Device