ms-types 0.9.31 → 0.9.33

package/package.json

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

package/types/lua/README.md

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

package/types/lua/appleocr.lua

@@ -14,7 +14,8 @@ local _AppleOCR = {}
 ---@field centerX integer 文本区域中心点 x 坐标
 ---@field centerY integer 文本区域中心点 y 坐标
 
---- 识别文本
+--- 识别文本（兼容旧接口，请改用 recognizeAbs）
+--- @deprecated 请改用 recognizeAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param x integer|nil 区域X，默认0
 --- @param y integer|nil 区域Y，默认0
@@ -46,7 +47,8 @@ function _AppleOCR.recognizeAbs(input, x, y, ex, ey, langs)
     return ret
 end
 
---- 识别数字
+--- 识别数字（兼容旧接口，请改用 recognizeNumbersAbs）
+--- @deprecated 请改用 recognizeNumbersAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param x integer|nil 区域X，默认0
 --- @param y integer|nil 区域Y，默认0
@@ -76,7 +78,8 @@ function _AppleOCR.recognizeNumbersAbs(input, x, y, ex, ey)
     return ret
 end
 
---- 查找文本
+--- 查找文本（兼容旧接口，请改用 findTextAbs）
+--- @deprecated 请改用 findTextAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param targets string[]|string 目标文本数组或逗号分隔字符串
 --- @param x integer|nil 区域X，默认0

package/types/lua/global.lua

@@ -120,3 +120,19 @@ end
 function GetCpuThrottleDelay()
     return { minMs = 3, maxMs = 30 }
 end
+
+--- 打印调试日志，等同 `logger.debug(...)`；可变参按空格拼接
+---@param ... any
+function logd(...) end
+
+--- 打印信息日志，等同 `logger.info(...)`；可变参按空格拼接
+---@param ... any
+function logi(...) end
+
+--- 打印警告日志，等同 `logger.warn(...)`；可变参按空格拼接
+---@param ... any
+function logw(...) end
+
+--- 打印错误日志，等同 `logger.error(...)`；可变参按空格拼接
+---@param ... any
+function loge(...) end

package/types/lua/image.lua

@@ -30,11 +30,13 @@ local _Image = {}
 --- @return string|nil 图片ID
 function _Image.captureScreen(x, y, ex, ey) return '' end
 
---- 全屏截屏
+--- 全屏截屏（兼容旧接口，请改用 captureScreen）
+--- @deprecated 请改用 captureScreen()。
 --- @return string|nil 图片ID
 function _Image.captureFullScreen() return '' end
 
---- 区域截屏
+--- 区域截屏（兼容旧接口，请改用 captureScreen）
+--- @deprecated 请改用 captureScreen(x, y, ex, ey)。
 --- @param x integer|nil
 --- @param y integer|nil
 --- @param ex integer|nil 右下角x

package/types/lua/paddleocr.lua

@@ -16,7 +16,8 @@ local _PaddleOCR = {}
 ---@field angle number 文本旋转角度 (度)
 ---@field orientation integer 文本方向 (0=水平,1=垂直 等)
 
---- 加载 V5 模型
+--- 加载 V5 模型（兼容旧接口，请改用 loadModel）
+--- @deprecated 请改用 loadModel("ppocr-v5", useGpu)；检测长边请使用 setMaxSideLen 单独设置。
 --- @param maxSideLen integer|nil 目标边长，默认 640
 --- @param useGpu boolean|nil 是否启用 GPU，默认 false
 --- @return boolean 成功
@@ -33,7 +34,8 @@ function _PaddleOCR.loadModel(modelId, useGpu) return true end
 --- @return boolean 成功
 function _PaddleOCR.setMaxSideLen(maxSideLen) return true end
 
---- 识别文本
+--- 识别文本（兼容旧接口，请改用 recognizeAbs）
+--- @deprecated 请改用 recognizeAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param x integer|nil 默认0
 --- @param y integer|nil 默认0
@@ -61,7 +63,8 @@ function _PaddleOCR.recognizeAbs(input, x, y, ex, ey, confidenceThreshold)
     return ret
 end
 
---- 查找目标文本
+--- 查找目标文本（兼容旧接口，请改用 findTextAbs）
+--- @deprecated 请改用 findTextAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param targets string[]|string 目标文本数组或逗号分隔字符串
 --- @param x integer|nil 默认0

package/types/lua/yolo.lua

@@ -23,7 +23,8 @@ local _Yolo = {}
 --- @return string|nil 模型ID（失败返回 nil）
 function _Yolo.load(paramPath, binPath, nc, version, useGpu) return nil end
 
---- 加载 YOLOv11 模型
+--- 加载 YOLOv11 模型（兼容旧接口，请改用 load）
+--- @deprecated 请改用 load(paramPath, binPath, nc, 11, useGpu)。
 --- @param paramPath string ncnn param 路径
 --- @param binPath string ncnn bin 路径
 --- @param nc integer|nil 标签数量；传 0 或省略时按模型输出推断
@@ -31,7 +32,8 @@ function _Yolo.load(paramPath, binPath, nc, version, useGpu) return nil end
 --- @return string|nil 模型ID（失败返回 nil）
 function _Yolo.loadV11(paramPath, binPath, nc, useGpu) return nil end
 
---- 检测
+--- 检测（兼容旧接口，请改用 detectAbs）
+--- @deprecated 请改用 detectAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param id string 模型ID
 --- @param input string 图像ID或路径
 --- @param target integer 目标边长（默认 640）

package/types/system.d.ts

@@ -58,6 +58,11 @@ declare namespace system {
    * }
    */
   function activateAppInfo(): AppInfo;
+  /**
+   * 获取前台运行的应用列表
+   * @returns 包含应用信息的字典数组，每个字典包含应用的Bundle ID和显示名称
+   */
+  function foregroundAppInfos(): AppInfo[];
   /**
    * 获取后台运行的应用列表
    * @returns 包含应用信息的字典数组，每个字典包含应用的Bundle ID和显示名称

package/types/ui.d.ts

@@ -116,6 +116,11 @@ declare namespace ui {
    */
   function show(): void;
 
+  /**
+   * 隐藏WebView
+   */
+  function hide(): void;
+
   /**
    * 设置事件回调函数（仅主线程调用，不能在线程脚本中调用）
    * @param onEvent 事件回调函数，传入 null 会取消监听

package/types/zh//347/263/273/347/273/237/346/250/241/345/235/227.d.ts

@@ -58,6 +58,11 @@ declare namespace $系统 {
    * }
    */
   function 获取当前运行的应用(): APP信息;
+  /**
+   * 获取前台运行的应用列表
+   * @returns 包含应用信息的字典数组，每个字典包含应用的Bundle ID和显示名称
+   */
+  function 获取前台运行的应用列表(): APP信息[];
   /**
    * 获取后台运行的应用列表
    * @returns 包含应用信息的字典数组，每个字典包含应用的Bundle ID和显示名称

package/types/zh//350/247/206/345/233/276/346/250/241/345/235/227.d.ts

@@ -9,6 +9,11 @@ declare namespace $视图 {
    */
   function 显示(): 无返回值;
 
+  /**
+   * 隐藏WebView
+   */
+  function 隐藏(): 无返回值;
+
   /**
    * 设置事件回调函数（仅主线程调用，不能在线程脚本中调用）
    * @param onEvent 事件回调函数，传入 null 会取消监听