ms-types 0.9.24 → 0.9.26

package/types/lua/paddleocr.lua

@@ -0,0 +1,99 @@
+---@meta paddleocr
+---@class PaddleOCR
+local _PaddleOCR = {}
+
+---@class PaddleOCRResult
+---@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 坐标
+---@field angle number 文本旋转角度 (度)
+---@field orientation integer 文本方向 (0=水平,1=垂直 等)
+
+--- 加载 V5 模型
+--- @param maxSideLen integer|nil 目标边长，默认 640
+--- @param useGpu boolean|nil 是否启用 GPU，默认 false
+--- @return boolean 成功
+function _PaddleOCR.loadV5(maxSideLen, useGpu) return true end
+
+--- 按内置模型 ID 加载
+--- @param modelId string `"ppocr-v6-tiny"` / `"ppocr-v6-small"` / `"ppocr-v5"`
+--- @param useGpu boolean|nil 是否启用 GPU，默认 false
+--- @return boolean 成功
+function _PaddleOCR.loadModel(modelId, useGpu) return true end
+
+--- 设置检测长边；0 或负数时使用 768
+--- @param maxSideLen integer|nil
+--- @return boolean 成功
+function _PaddleOCR.setMaxSideLen(maxSideLen) return true end
+
+--- 识别文本
+--- @param input string 图像ID或路径
+--- @param x integer|nil 默认0
+--- @param y integer|nil 默认0
+--- @param ex integer|nil 默认0
+--- @param ey integer|nil 默认0
+--- @param confidenceThreshold number|nil 置信阈值 默认0.6
+--- @return PaddleOCRResult[] 结果数组
+function _PaddleOCR.recognize(input, x, y, ex, ey, confidenceThreshold)
+    ---@type PaddleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 识别文本，坐标映射为原图/全屏绝对坐标
+--- @param input string 图像ID或路径
+--- @param x integer|nil 默认0
+--- @param y integer|nil 默认0
+--- @param ex integer|nil 默认0
+--- @param ey integer|nil 默认0
+--- @param confidenceThreshold number|nil 置信阈值 默认0.6
+--- @return PaddleOCRResult[] 结果数组
+function _PaddleOCR.recognizeAbs(input, x, y, ex, ey, confidenceThreshold)
+    ---@type PaddleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 查找目标文本
+--- @param input string 图像ID或路径
+--- @param targets string[]|string 目标文本数组或逗号分隔字符串
+--- @param x integer|nil 默认0
+--- @param y integer|nil 默认0
+--- @param ex integer|nil 默认0
+--- @param ey integer|nil 默认0
+--- @param confidenceThreshold number|nil 置信阈值 默认0.6
+--- @param exactMatch boolean|nil 是否完整匹配，默认 false
+--- @return PaddleOCRResult[] 结果数组
+function _PaddleOCR.findText(input, targets, x, y, ex, ey, confidenceThreshold, exactMatch)
+    ---@type PaddleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 查找目标文本，坐标映射为原图/全屏绝对坐标
+--- @param input string 图像ID或路径
+--- @param targets string[]|string 目标文本数组或逗号分隔字符串
+--- @param x integer|nil 默认0
+--- @param y integer|nil 默认0
+--- @param ex integer|nil 默认0
+--- @param ey integer|nil 默认0
+--- @param confidenceThreshold number|nil 置信阈值 默认0.6
+--- @param exactMatch boolean|nil 是否完整匹配，默认 false
+--- @return PaddleOCRResult[] 结果数组
+function _PaddleOCR.findTextAbs(input, targets, x, y, ex, ey, confidenceThreshold, exactMatch)
+    ---@type PaddleOCRResult[]
+    local ret = {}
+    return ret
+end
+
+--- 释放资源
+function _PaddleOCR.free() end
+
+return _PaddleOCR

package/types/lua/pip.lua

@@ -0,0 +1,56 @@
+---@meta pip
+---@class Pip
+local _Pip = {}
+
+--- 悬浮窗是否打开
+---@return boolean
+function _Pip.isPipActive() return false end
+
+--- 切换到日志模式（首次显示时 App 须在前台）
+---@return boolean
+function _Pip.switchToLogMode() return true end
+
+--- 切换到保活模式（首次显示时 App 须在前台）
+---@return boolean
+function _Pip.switchToKeepAliveMode() return true end
+
+--- 切换到自定义模式（首次显示时 App 须在前台）
+---@return boolean
+function _Pip.switchToCustomMode() return true end
+
+--- 关闭悬浮窗
+---@return boolean
+function _Pip.closeWindow() return true end
+
+--- 设置日志/自定义模式内容宽高比（不是最终像素）
+---@param width number
+---@param height number
+---@return boolean
+function _Pip.setContentSize(width, height) return true end
+
+--- 设置日志字号；缺省 8
+---@param fontSize number|nil
+---@return boolean
+function _Pip.setLogFontSize(fontSize) return true end
+
+--- 设置自定义文本（不自动切模式）
+---@param text string
+---@return boolean
+function _Pip.setCustomText(text) return true end
+
+--- 设置自定义文字颜色，支持 RRGGBB / RRGGBBAA
+---@param color string
+---@return boolean
+function _Pip.setCustomTextColor(color) return true end
+
+--- 设置自定义文字大小；缺省 12
+---@param fontSize number|nil
+---@return boolean
+function _Pip.setCustomTextSize(fontSize) return true end
+
+--- 设置自定义背景色
+---@param color string
+---@return boolean
+function _Pip.setCustomBackgroundColor(color) return true end
+
+return _Pip

package/types/lua/system.lua

@@ -0,0 +1,139 @@
+---@meta system
+---@class System
+local _System = {}
+
+---@class ProcessArguments
+---@field env table<string, any> 环境变量映射（键为字符串，值为任意类型）
+---@field args string[] 启动参数列表
+
+---@class ActivateAppInfo
+---@field name string 应用名称
+---@field pid integer 进程 ID
+---@field bundleId string 应用 Bundle ID
+---@field processArguments ProcessArguments 启动参数信息
+
+---@class MemoryInfo
+---@field used integer 已使用内存（MB）
+---@field available integer 可用内存（MB）
+---@field total integer 系统总内存（MB）
+---@field usagePercentage integer 使用率（0-100）
+
+--- 启动应用
+--- @param bundleId string 应用 Bundle ID
+--- @param args string[]|nil 启动参数
+--- @param env table<string, any>|nil 环境变量
+--- @return boolean 成功
+function _System.startApp(bundleId, args, env) return true end
+
+--- 停止应用
+--- @param bundleId string 应用 Bundle ID
+--- @return boolean 成功
+function _System.stopApp(bundleId) return true end
+
+--- 激活应用到前台（未启动则启动）
+--- @param bundleId string 应用 Bundle ID
+--- @return boolean 成功
+function _System.activateApp(bundleId) return true end
+
+--- 获取当前运行的应用信息（可能为 nil）
+--- @return ActivateAppInfo|nil 信息
+function _System.activateAppInfo()
+    ---@type ActivateAppInfo
+    local info
+    return info
+end
+
+--- 前台运行的应用列表
+--- @return ActivateAppInfo[] 列表
+function _System.foregroundAppInfos() return {} end
+
+---@class InstalledAppInfo
+---@field bundleVersion string 版本
+---@field appName string 应用名
+---@field bundleIdentifier string Bundle ID
+
+--- 后台运行的应用列表
+--- @return ActivateAppInfo[] 列表
+function _System.backgroundAppInfos() return {} end
+
+--- 已安装应用列表
+--- @return InstalledAppInfo[] 列表
+function _System.getInstalledAppList() return {} end
+
+--- 打开 App 切换器
+--- @return boolean 成功
+function _System.recent() return true end
+
+--- 使用系统浏览器打开 URL
+--- @param url string 链接
+--- @return boolean 成功
+function _System.openURL(url) return true end
+
+--- 发送系统通知（后台生效）
+--- @param msg string 内容
+--- @param title string|nil 标题，空或 "undefined" 使用应用名称
+--- @param id string|nil 通知 ID，相同 ID 覆盖
+function _System.notify(msg, title, id) end
+
+--- 设置剪贴板文本（仅前台有效）
+--- @param s string 内容
+--- @return boolean 成功
+function _System.setClipboard(s) return true end
+
+--- 获取剪贴板文本（仅前台有效）
+--- @return string 内容
+function _System.getClipboard() return '' end
+
+--- 是否锁屏
+--- @return boolean 锁定
+function _System.isLocked() return false end
+
+--- 锁屏
+--- @return boolean 成功
+function _System.lock() return true end
+
+--- 解锁
+--- @return boolean 成功
+function _System.unlock() return true end
+
+--- 获取内存使用信息（MB）
+--- @return MemoryInfo 信息
+function _System.getMemoryInfo()
+    ---@type MemoryInfo
+    local ret
+    return ret
+end
+
+--- 获取已使用内存（MB）
+--- @return integer MB
+function _System.getUsedMemory() return 0 end
+
+--- 获取可用内存（MB）
+--- @return integer MB
+function _System.getAvailableMemory() return 0 end
+
+--- 获取系统总内存（MB）
+--- @return integer MB
+function _System.getTotalMemory() return 0 end
+
+--- 获取系统已用内存（MB）
+--- @return number MB
+function _System.getSystemUsedMemory() return 0 end
+
+--- 获取 CPU 使用率
+--- @return number 使用率
+function _System.getCpuUsage() return 0 end
+
+--- 启动 Agent 服务
+--- @return boolean 成功
+function _System.startAgent() return true end
+
+--- 获取 Agent 状态（是否正在运行）
+--- @return boolean 运行中
+function _System.getAgentStatus() return false end
+
+--- 停止 Agent 服务
+--- @return boolean 成功
+function _System.stopAgent() return true end
+
+return _System

package/types/lua/tomatoocr.lua

@@ -0,0 +1,83 @@
+---@meta tomatoocr
+---@class TomatoOCR
+local _TomatoOCR = {}
+
+---@class TomatoInitResult
+---@field deviceId string 设备 ID
+---@field expiryTime string 过期时间
+---@field message string 信息
+---@field status string 状态
+---@field versionName string 版本名称
+
+--- 初始化 TomatoOCR 并设置基本配置
+--- @param mode string 运行模式（例如 "fast"）
+--- @param licenseData string 许可证数据
+--- @param remark string|nil 备注（nil/"" 为不传）
+--- @return TomatoInitResult|nil 初始化结果（表），失败返回 nil
+function _TomatoOCR.initializeWithConfig(mode, licenseData, remark) return nil end
+
+--- 设置HTTP间隔
+--- @param v number 秒
+function _TomatoOCR.setHttpIntervalTime(v) end
+
+--- 设置识别类型
+--- @param s string 类型
+function _TomatoOCR.setRecType(s) end
+
+--- 设置检测框类型
+--- @param s string 类型（rect/quad）
+function _TomatoOCR.setDetBoxType(s) end
+
+--- 设置检测框展开比例
+--- @param v number 比例（建议 1.6-2.5）
+function _TomatoOCR.setDetUnclipRatio(v) end
+
+--- 设置检测框缩放比例
+--- @param v number 缩放比例
+function _TomatoOCR.setDetScaleRatio(v) end
+
+--- 设置识别分数阈值
+--- @param v number 阈值（默认 0.1）
+function _TomatoOCR.setRecScoreThreshold(v) end
+
+--- 设置返回类型
+--- @param s string 类型
+function _TomatoOCR.setReturnType(s) end
+
+--- 设置二值化阈值
+--- @param v number 阈值（0-255）
+function _TomatoOCR.setBinaryThresh(v) end
+
+--- 设置运行模式
+--- @param s string 模式（如 fast）
+function _TomatoOCR.setRunMode(s) end
+
+--- 设置图像滤色参数
+--- @param filterColor string 过滤颜色（多色用 | 连接）
+--- @param backgroundColor string 背景颜色
+function _TomatoOCR.setFilterColor(filterColor, backgroundColor) end
+
+--- OCR识别
+--- @param input string 图像ID或路径
+--- @param type integer 类型
+--- @param x integer
+--- @param y integer
+--- @param ex integer
+--- @param ey integer
+--- @return string JSON结果
+function _TomatoOCR.ocrImage(input, type, x, y, ex, ey) return '' end
+
+--- 查找点击点
+--- @param js string JSON配置
+--- @return string JSON结果
+function _TomatoOCR.findTapPoint(js) return '' end
+
+--- 查找多个点击点
+--- @param js string JSON配置
+--- @return string JSON结果
+function _TomatoOCR.findTapPoints(js) return '' end
+
+--- 释放已加载的 OCR 模型和内部资源
+function _TomatoOCR.release() end
+
+return _TomatoOCR

package/types/lua/tts.lua

@@ -0,0 +1,42 @@
+---@meta tts
+---@class TTS
+local _TTS = {}
+
+---@class VoiceInfo
+---@field identifier string 语音标识符
+---@field name string 名称
+---@field language string 语言代码
+---@field quality integer 质量等级
+
+--- 说话
+--- @param text string 文本
+--- @param rate number|nil 语速（0.0-1.0，默认 0.5）
+--- @param pitch number|nil 音调（0.5-2.0，默认 1.0）
+--- @param volume number|nil 音量（0.0-1.0，默认 1.0）
+--- @param lang string|nil 语言
+--- @return boolean 成功
+function _TTS.speak(text, rate, pitch, volume, lang) return true end
+
+--- 等待结束
+function _TTS.waitEnd() end
+
+--- 停止
+function _TTS.stop() end
+
+--- 是否正在说话
+--- @return boolean speaking
+function _TTS.isSpeaking() return false end
+
+--- 设置声音
+--- @param voice string 声音标识
+--- @return boolean 成功
+function _TTS.setVoice(voice) return true end
+
+--- 获取可用的语音列表
+--- @return VoiceInfo[] 语音列表
+function _TTS.getAvailableVoices() return {} end
+
+--- 释放 TTS 资源
+function _TTS.free() end
+
+return _TTS

package/types/lua/ui.lua

@@ -0,0 +1,46 @@
+---@meta ui
+---@class UI
+local _UI = {}
+
+--- 显示WebView
+function _UI.show() end
+
+--- 隐藏WebView
+function _UI.hide() end
+
+--- 显示Toast
+--- @param message string 文本
+function _UI.showToast(message) end
+
+--- 确认框
+--- @param title string 标题
+--- @param message string 内容
+--- @return boolean 确认
+function _UI.confirm(title, message) return false end
+
+--- 输入框
+--- @param title string 标题
+--- @param message string 内容
+--- @return string 输入内容
+function _UI.confirmInput(title, message) return '' end
+
+--- 警告框
+--- @param title string 标题
+--- @param message string 内容
+function _UI.alert(title, message) end
+
+--- 事件监听
+--- @alias UIEventCallback fun(event: string, data: table<string, any>): nil
+--- @param callback UIEventCallback 回调函数（data 为表，来自 WebView 的对象已转换）
+function _UI.onEvent(callback) end
+
+--- 调用已注册函数
+--- @param key string 函数名
+--- @param data table<string, any> 参数（可选，表会在原生层保持为字典）
+function _UI.call(key, data) end
+
+--- 执行JS代码
+--- @param code string 代码
+function _UI.eval(code) end
+
+return _UI

package/types/lua/utils.lua

@@ -0,0 +1,49 @@
+---@meta utils
+---@class Utils
+local _Utils = {}
+
+--- 时间格式化
+--- @param fmt string 格式
+--- @return string 文本
+function _Utils.timeFormat(fmt) return '' end
+
+--- 随机数
+--- @param min integer 最小
+--- @param max integer 最大
+--- @return integer 随机值
+function _Utils.random(min, max) return 0 end
+
+--- 把应用带到前台
+--- @return boolean 是否成功
+function _Utils.takeMeToFront() return false end
+
+--- 生成随机 UUID
+--- @return string UUID
+function _Utils.randomUUID() return '' end
+
+--- 字符串转小写 hex
+--- @param source string 源字符串
+--- @return string hex
+function _Utils.hexString(source) return '' end
+
+--- 字符串转 Base64
+--- @param source string 源字符串
+--- @return string Base64
+function _Utils.base64Encoded(source) return '' end
+
+--- Base64 转字符串
+--- @param source string Base64
+--- @return string 文本
+function _Utils.base64Decoded(source) return '' end
+
+--- hex 字符串转 Base64
+--- @param hexString string hex
+--- @return string Base64
+function _Utils.hexStringBase64Encoded(hexString) return '' end
+
+--- Base64 转 hex 字符串
+--- @param base64HexString string Base64
+--- @return string hex
+function _Utils.hexStringBase64Decoded(base64HexString) return '' end
+
+return _Utils

package/types/lua/yolo.lua

@@ -0,0 +1,63 @@
+---@meta yolo
+---@class Yolo
+local _Yolo = {}
+
+---@class YoloResult
+---@field x integer 左上角 X
+---@field y integer 左上角 Y
+---@field ex integer 右下角 X
+---@field ey integer 右下角 Y
+---@field centerX integer 中心点 X
+---@field centerY integer 中心点 Y
+---@field width integer 宽度
+---@field height integer 高度
+---@field confidence number 置信度
+---@field classId integer 类别 ID
+
+--- 加载 YOLO 模型（版本 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 useGpu boolean|nil 是否启用 GPU，默认 false
+--- @return string|nil 模型ID（失败返回 nil）
+function _Yolo.load(paramPath, binPath, nc, version, useGpu) return nil end
+
+--- 加载 YOLOv11 模型
+--- @param paramPath string ncnn param 路径
+--- @param binPath string ncnn bin 路径
+--- @param nc integer|nil 标签数量；传 0 或省略时按模型输出推断
+--- @param useGpu boolean|nil 是否启用 GPU，默认 false
+--- @return string|nil 模型ID（失败返回 nil）
+function _Yolo.loadV11(paramPath, binPath, nc, useGpu) return nil end
+
+--- 检测
+--- @param id string 模型ID
+--- @param input string 图像ID或路径
+--- @param target integer 目标边长（默认 640）
+--- @param thr number 置信阈值（默认 0.4）
+--- @param nms number NMS 阈值（默认 0.5）
+--- @return YoloResult[] 结果数组
+function _Yolo.detect(id, input, target, thr, nms) return {} end
+
+--- 区域检测，坐标映射为原图/全屏绝对坐标
+--- @param id string 模型ID
+--- @param input string 图像ID或路径
+--- @param x integer 区域左上角 X
+--- @param y integer 区域左上角 Y
+--- @param ex integer 区域右下角 X
+--- @param ey integer 区域右下角 Y
+--- @param target integer|nil 目标边长（默认 640）
+--- @param thr number|nil 置信阈值（默认 0.4）
+--- @param nms number|nil NMS 阈值（默认 0.5）
+--- @return YoloResult[] 结果数组
+function _Yolo.detectAbs(id, input, x, y, ex, ey, target, thr, nms) return {} end
+
+--- 释放模型
+--- @param id string 模型ID
+function _Yolo.free(id) end
+
+--- 释放全部模型
+function _Yolo.freeAll() end
+
+return _Yolo

package/types/lua/yolocls.lua

@@ -0,0 +1,41 @@
+---@meta yolocls
+---@class YoloCls
+local _YoloCls = {}
+
+--- load
+---@param paramPath string
+---@param binPath string
+---@param nc integer|nil
+---@param useGpu boolean|nil
+---@return string|nil
+function _YoloCls.load(paramPath, binPath, nc, useGpu) return nil end
+
+--- classify
+---@param modelId string
+---@param img string
+---@param targetSize integer|nil
+---@return table
+function _YoloCls.classify(modelId, img, targetSize) return { data = {}, top1 = nil, top5 = {}, top1conf = nil, top5conf = {} } end
+
+--- classifyRegion
+---@param modelId string
+---@param img string
+---@param x integer|nil
+---@param y integer|nil
+---@param ex integer|nil
+---@param ey integer|nil
+---@param targetSize integer|nil
+---@return table
+function _YoloCls.classifyRegion(modelId, img, x, y, ex, ey, targetSize) return { data = {}, top1 = nil, top5 = {}, top1conf = nil, top5conf = {} } end
+
+--- free
+---@param modelId string
+function _YoloCls.free(modelId) end
+
+--- freeAll
+
+function _YoloCls.freeAll() end
+
+package.loaded['yolocls'] = _YoloCls
+package.loaded['yoloCls'] = _YoloCls
+return _YoloCls