ms-types 0.9.24 → 0.9.26

package/types/lua/dotocr.lua

@@ -0,0 +1,46 @@
+---@meta dotocr
+---@class DotOCR
+local _DotOCR = {}
+
+--- 点阵 OCR；require("dotocr") 或 require("dotOcr")
+
+--- loadFont
+---@param fontPath string
+---@return string|nil
+function _DotOCR.loadFont(fontPath) return nil end
+
+--- free
+---@param fontId string
+function _DotOCR.free(fontId) end
+
+--- freeAll
+
+function _DotOCR.freeAll() end
+
+--- recognizeAbs
+---@param fontId string
+---@param input string
+---@param x integer|nil
+---@param y integer|nil
+---@param ex integer|nil
+---@param ey integer|nil
+---@param confidenceThreshold number|nil
+---@return table[]
+function _DotOCR.recognizeAbs(fontId, input, x, y, ex, ey, confidenceThreshold) return {} end
+
+--- findTextAbs
+---@param fontId string
+---@param input string
+---@param targetTexts string[]
+---@param x integer|nil
+---@param y integer|nil
+---@param ex integer|nil
+---@param ey integer|nil
+---@param confidenceThreshold number|nil
+---@param exactMatch boolean|nil
+---@return table[]
+function _DotOCR.findTextAbs(fontId, input, targetTexts, x, y, ex, ey, confidenceThreshold, exactMatch) return {} end
+
+package.loaded['dotocr'] = _DotOCR
+package.loaded['dotOcr'] = _DotOCR
+return _DotOCR

package/types/lua/file.lua

@@ -0,0 +1,96 @@
+---@meta file
+---@class File
+local _File = {}
+
+--- 获取内部目录
+--- @param key string 目录类型：documents / library / temp / libraryCaches
+--- @return string 目录
+function _File.getInternalDir(key) return '' end
+
+--- 创建文件
+--- @param path string 路径
+--- @return boolean 成功
+function _File.create(path) return true end
+
+--- 创建目录
+--- @param path string 路径
+--- @return boolean 成功
+function _File.mkdirs(path) return true end
+
+--- 读取文件
+--- @param path string 路径
+--- @return string 内容
+function _File.readFile(path) return '' end
+
+--- 写入文件
+--- @param path string 路径
+--- @param content string 内容
+--- @return boolean 成功
+function _File.writeFile(path, content) return true end
+
+--- 是否存在
+--- @param path string 路径
+--- @return boolean 存在
+function _File.exists(path) return true end
+
+--- 删除所有文件/目录
+--- @param path string 路径
+--- @return boolean 成功
+function _File.deleteAllFile(path) return true end
+
+--- 读取资源文件（res 目录）
+--- @param name string 文件名
+--- @return string|nil 内容
+function _File.readResFile(name) return '' end
+
+--- 获取 res 资源的本地文件路径；用完后应调用 cleanupResFile
+--- @param name string 相对 res 的路径
+--- @return string|nil 本地绝对路径
+function _File.getResFile(name) return nil end
+
+--- 清理由 getResFile 得到的本地临时文件
+--- @param path string getResFile 返回的路径
+function _File.cleanupResFile(path) end
+
+--- 删除指定行或包含内容的行
+--- @param path string 路径
+--- @param line integer 行号（>=0 生效）
+--- @param contains string 包含的内容（为 'null' 或 'undefined' 视为不启用）
+--- @return boolean 成功
+function _File.deleteLine(path, line, contains) return true end
+
+--- 列出目录
+--- @param path string 路径
+--- @param recursion boolean 是否递归
+--- @return string[] 路径列表
+function _File.listDir(path, recursion) return {} end
+
+--- 追加一行
+--- @param path string 路径
+--- @param data string 内容
+--- @return boolean 成功
+function _File.appendLine(path, data) return true end
+
+--- 读取指定行
+--- @param path string 路径
+--- @param lineNo integer 行号
+--- @return string|nil 内容
+function _File.readLine(path, lineNo) return '' end
+
+--- 读取所有行
+--- @param path string 路径
+--- @return string[] 行列表
+function _File.readAllLines(path) return {} end
+
+--- 复制文件
+--- @param src string 源路径
+--- @param dest string 目标路径
+--- @return boolean 成功
+function _File.copy(src, dest) return true end
+
+--- 计算文件MD5
+--- @param path string 路径
+--- @return string|nil MD5值
+function _File.fileMD5(path) return '' end
+
+return _File

package/types/lua/global.lua

@@ -0,0 +1,122 @@
+---@meta
+--- 是否调试模式
+---@type boolean
+IsDebug = false
+
+--- 运行模式："agent" 或 "hid"
+---@type string
+RunMode = ''
+
+--- 平台："ios" 或 "android"
+---@type string
+Platform = ''
+
+--- 应用版本号
+---@type string
+AppVersion = ''
+
+--- 应用构建号
+---@type integer
+AppBuildNumber = 0
+
+--- 应用名称
+---@type string
+AppName = ''
+
+--- 应用包名
+---@type string
+AppBundleId = ''
+
+--- 脚本 package.json 内容（表）
+---@type table
+PackageJson = {}
+
+---@class CpuThrottleDelay
+---@field minMs integer
+---@field maxMs integer
+
+--- 切入前台
+---@return boolean
+function TakeMeToFront() return false end
+
+--- 重启脚本；延迟不足 2000ms 时按 2000ms
+---@param delay integer|nil
+function RestartScript(delay) end
+
+--- 退出当前脚本（单 VM，等价于收到停止信号）
+function Exit() end
+
+--- 设置停止回调；status 为 "success" | "error" | "stopped"。传入非函数则清除
+---@param callback fun(status: string)|nil
+function SetStopCallback(callback) end
+
+--- 设置异常停止回调。传入非函数则清除
+---@param callback fun()|nil
+function SetExceptionCallback(callback) end
+
+--- 可中断等待（毫秒）；期间调度 StartThread 协程
+---@param ms integer
+function Sleep(ms) end
+
+--- 当前时间戳（毫秒）
+---@return integer
+function Time() return 0 end
+
+--- 将表转为 JSON 字符串
+---@param data table
+---@return string
+function ToJsonString(data) return '' end
+
+--- 启动同 VM 协作协程（不是 OS 线程），返回协程名
+---@param func function
+---@return string
+function StartThread(func) return '' end
+
+--- 请求停止指定协作协程
+---@param threadName string
+function StopThread(threadName) end
+
+--- 当前协作协程是否应退出。主脚本收到停止后由引擎 hook / Sleep 直接中断，不必轮询本函数。
+---@return boolean
+function ShouldInterruptThread() return false end
+
+--- 设置 Agent 快速模式（兼容接口）
+---@param enabled boolean
+---@return boolean
+function SetAgentFastMode(enabled) return false end
+
+--- 获取 Agent 快速模式
+---@return boolean
+function GetAgentFastMode() return false end
+
+--- 设置 Agent 触控模式：0 标准 / 1 快速 / 2 真实点击
+---@param mode integer
+---@return integer
+function SetAgentTouchMode(mode) return 1 end
+
+--- 获取 Agent 触控模式
+---@return integer
+function GetAgentTouchMode() return 1 end
+
+--- 设置 CPU 自动限流
+---@param enabled boolean
+---@return boolean
+function SetCpuAutoThrottle(enabled) return true end
+
+--- 获取 CPU 自动限流
+---@return boolean
+function GetCpuAutoThrottle() return true end
+
+--- 设置 CPU 限流延迟范围（毫秒），默认 3 和 30
+---@param minMs integer|nil
+---@param maxMs integer|nil
+---@return CpuThrottleDelay
+function SetCpuThrottleDelay(minMs, maxMs)
+    return { minMs = 3, maxMs = 30 }
+end
+
+--- 获取 CPU 限流延迟范围
+---@return CpuThrottleDelay
+function GetCpuThrottleDelay()
+    return { minMs = 3, maxMs = 30 }
+end

package/types/lua/hid.lua

@@ -0,0 +1,274 @@
+---@meta hid
+---@type table<string, integer>
+HidKey = {
+    COMMAND = 0x83,
+    LEFT_CTRL = 0x80,
+    LEFT_SHIFT = 0x81,
+    LEFT_ALT = 0x82,
+    RIGHT_CTRL = 0x84,
+    RIGHT_SHIFT = 0x85,
+    RIGHT_ALT = 0x86,
+    UP_ARROW = 0xDA,
+    DOWN_ARROW = 0xD9,
+    LEFT_ARROW = 0xD8,
+    RIGHT_ARROW = 0xD7,
+    SPACE = 0x20,
+    BACKSPACE = 0xB2,
+    TAB = 0xB3,
+    RETURN = 0xB0,
+    ESC = 0xB1,
+    INSERT = 0xD1,
+    DELETE = 0xD4,
+    PAGE_UP = 0xD3,
+    PAGE_DOWN = 0xD6,
+    HOME = 0xD2,
+    END = 0xD5,
+    CAPS_LOCK = 0xC1,
+    F1 = 0xC2,
+    F2 = 0xC3,
+    F3 = 0xC4,
+    F4 = 0xC5,
+    F5 = 0xC6,
+    F6 = 0xC7,
+    F7 = 0xC8,
+    F8 = 0xC9,
+    F9 = 0xCA,
+    F10 = 0xCB,
+    F11 = 0xCC,
+    F12 = 0xCD
+}
+
+---@class HID
+local _HID = {}
+
+--- 设置抖动值
+--- @param value integer 抖动值
+function _HID.setJitterValue(value) end
+
+--- 移动
+--- @param x integer
+--- @param y integer
+--- @return boolean 成功
+function _HID.move(x, y) return true end
+
+--- 按下鼠标左键（不自动抬起）
+--- @return boolean 成功
+function _HID.mouseDown() return true end
+
+--- 抬起鼠标左键
+--- @return boolean 成功
+function _HID.mouseUp() return true end
+
+--- 点击
+--- @param x integer
+--- @param y integer
+--- @param duration integer|nil
+--- @param jitter boolean|nil
+--- @return boolean 成功
+function _HID.click(x, y, duration, jitter) return true end
+
+--- 复位坐标到左上角（仅相对鼠标模式需要）
+--- @return boolean 成功
+function _HID.resetPosition() return true end
+
+--- 打开系统录屏选择器
+--- @return boolean 是否成功拉起界面
+function _HID.openRecordScreen() return true end
+
+--- 录屏是否已开启
+--- @return boolean 是否开启
+function _HID.isRecording() return false end
+
+--- 是否已连接蓝牙 HID
+--- @return boolean 已连接
+function _HID.isBLEConnected() return false end
+
+--- 是否已连接 USB HID
+--- @return boolean 已连接
+function _HID.isUSBConnected() return false end
+
+--- 获取蓝牙 HID 设备名称
+--- @return string 名称
+function _HID.getBLEHIDDeviceName() return '' end
+
+--- 设置蓝牙 HID 设备名称
+--- @param name string 名称
+--- @return boolean 成功
+function _HID.setBLEHIDDeviceName(name) return true end
+
+--- 获取 HID 设备 MAC 字符串
+--- @return string MAC
+function _HID.getDeviceMac() return '' end
+
+--- 获取 HID 设备型号
+--- @return string 型号
+function _HID.getDeviceModel() return '' end
+
+--- 获取 HID 设备版本
+--- @return string 版本
+function _HID.getDeviceVersion() return '' end
+
+--- 重启当前 HID 设备
+--- @return boolean 成功
+function _HID.restartDevice() return true end
+
+--- 随机点击
+--- @param x1 integer
+--- @param y1 integer
+--- @param x2 integer
+--- @param y2 integer
+--- @param duration integer|nil
+--- @return boolean 成功
+function _HID.clickRandom(x1, y1, x2, y2, duration) return true end
+
+--- 双击
+--- @param x integer
+--- @param y integer
+--- @param duration integer|nil
+--- @param interval integer|nil
+--- @param jitter boolean|nil
+--- @return boolean 成功
+function _HID.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 _HID.doubleClickRandom(x1, y1, x2, y2, duration, interval) return true end
+
+--- 滑动
+--- @param startX integer
+--- @param startY integer
+--- @param endX integer
+--- @param endY integer
+--- @param jitter boolean|nil 是否抖动
+--- @param steps integer|nil 步数
+--- @return boolean 成功
+function _HID.swipe(startX, startY, endX, endY, jitter, steps) return true end
+
+--- 曲线滑动（3点）
+--- @param startX integer
+--- @param startY integer
+--- @param midX integer
+--- @param midY integer
+--- @param endX integer
+--- @param endY integer
+--- @return boolean 成功
+function _HID.swipeCurve(startX, startY, midX, midY, endX, endY) return true end
+
+--- 长按并滑动
+--- @param startX integer
+--- @param startY integer
+--- @param endX integer
+--- @param endY integer
+--- @param duration integer|nil 长按时间 默认500ms
+--- @param jitter boolean|nil 是否开启抖动
+--- @param steps integer|nil 抖动步数 默认6
+--- @return boolean 成功
+function _HID.pressAndSwipe(startX, startY, endX, endY, duration, jitter, steps)
+    return true
+end
+
+--- 打开URL
+--- @param url string 链接
+--- @return boolean 成功
+function _HID.openURL(url) return true end
+
+--- 打开App
+--- @param bundle string 包名
+--- @return boolean 成功
+function _HID.openApp(bundle) return true end
+
+--- 关闭App（不会关闭当前快点 JS）
+--- @param name string 应用名称或包名
+--- @return boolean 成功
+function _HID.closeApp(name) return true end
+
+--- 获取剪贴板
+--- @return string 内容
+function _HID.getClipboard() return '' end
+
+--- 设置剪贴板
+--- @param s string 内容
+--- @return boolean 成功
+function _HID.setClipboard(s) return true end
+
+--- 回到主页
+--- @return boolean 成功
+function _HID.homeScreen() return true end
+
+--- 按下系统按钮
+--- @param name string home / volumeup / volumedown / mute / playpause / next / prev / eject / globe / search / brightnessup / brightnessdown / power / snapshot
+--- @return boolean 成功
+function _HID.pressButton(name) return true end
+
+--- 输入文本（优先输入法，否则剪贴板粘贴，可输中文）
+--- @param text string 文本
+--- @return boolean 成功
+function _HID.input(text) return true end
+
+--- 简单键盘输入（英文）
+--- @param data string 数据
+--- @return boolean 成功
+function _HID.inputSimple(data) return true end
+
+--- 空格键
+--- @return boolean 成功
+function _HID.space() return true end
+
+--- 退格键
+--- @param count integer|nil 次数，默认 1
+--- @return boolean 成功
+function _HID.backspace(count) return true end
+
+--- 回车键
+--- @return boolean 成功
+function _HID.enter() return true end
+
+--- 发送组合按键（支持字符串和数值）
+--- @alias SendHIDKey string|integer
+--- @param keys SendHIDKey[] 按键数组
+--- @return boolean 成功
+function _HID.sendKey(keys) return true end
+
+--- 复制
+--- @return boolean 成功
+function _HID.copyText() return true end
+
+--- 粘贴
+--- @return boolean 成功
+function _HID.pasteText() return true end
+
+--- 返回
+--- @return boolean 成功
+function _HID.back() return true end
+
+--- 最近应用
+--- @return boolean 成功
+function _HID.recent() return true end
+
+--- 锁屏
+--- @return boolean 成功
+function _HID.lock() return true end
+
+--- 解锁
+--- @return boolean 成功
+function _HID.unlock() return true end
+
+--- 切入前台
+--- @return boolean 成功
+function _HID.takeMeToFront() return true end
+
+--- 当前打开应用信息（iOS18+）
+--- @return {name: string, bundleId: string} 信息；无前台应用时为空表
+function _HID.currentAppInfo()
+    ---@type table
+    local ret
+    return ret
+end
+
+return _HID

package/types/lua/hotupdate.lua

@@ -0,0 +1,23 @@
+---@meta hotupdate
+---@class HotUpdate
+local _HotUpdate = {}
+
+--- 检查更新
+--- @param options {url: string|nil, version: integer|nil, timeout: integer|nil}|nil 
+--- @return {needUpdate: boolean, data?: table, error?: string} 结果
+function _HotUpdate.checkUpdate(options)
+    return {
+        needUpdate = true,
+        data = {version = 1, url = "https://example.com/update.zip"}
+    }
+end
+
+--- 下载并安装
+--- @return {updated: boolean, error?: string} 结果
+function _HotUpdate.downloadAndInstall() return {updated = true, error = nil} end
+
+--- 当前版本
+--- @return integer 版本号
+function _HotUpdate.getCurrentVersion() return 0 end
+
+return _HotUpdate

package/types/lua/http.lua

@@ -0,0 +1,144 @@
+---@meta http
+---@class Http
+local _Http = {}
+
+---@class HttpRequestOptions
+---@field url string         @请求地址
+---@field timeout integer|nil @请求超时（毫秒）
+---@field method string|nil   @请求方法 GET/POST/...
+---@field proxy {host:string, port:integer}|nil @代理服务器
+---@field followRedirects boolean|nil @是否跟随重定向
+---@field requestBody string|nil @请求体（POST等）
+---@field userAgent string|nil @UA
+---@field ignoreContentType boolean|nil @是否忽略内容类型（false时非文本/JSON以Base64返回）
+---@field ignoreHttpErrors boolean|nil @忽略HTTP错误
+---@field maxBodySize integer|nil @最大响应体（默认10MB）
+---@field referrer string|nil @引用来源
+---@field header table<string,string>|nil @请求头
+---@field cookie table<string,string>|nil @Cookie
+---@field data table<string,any>|nil @表单/查询参数
+---@field file table<string,string>|nil @文件参数（multipart）
+---@field responseCharset string|nil @响应字符集
+
+---@class HttpResponse
+---@field header table<string,string>
+---@field cookie table<string,string>
+---@field statusCode integer
+---@field statusMessage string
+---@field charset string
+---@field contentType string
+---@field body string
+
+--- 通用请求
+--- @param options HttpRequestOptions
+--- @return HttpResponse|nil
+function _Http.request(options)
+    return {
+        header = {},
+        cookie = {},
+        statusCode = 200,
+        statusMessage = "OK",
+        charset = "utf-8",
+        contentType = "text/plain",
+        body = ""
+    }
+end
+
+--- GET 请求（同名：httpGet）
+--- @param url string
+--- @param params table<string,string>|nil
+--- @param timeout integer|nil
+--- @param headers table<string,string>|nil
+--- @return string|nil
+function _Http.httpGet(url, params, timeout, headers) return '' end
+
+--- POST 表单请求（同名：httpPost）
+--- @param url string
+--- @param params table<string,string>|nil
+--- @param files table<string,string>|nil
+--- @param timeout integer|nil
+--- @param headers table<string,string>|nil
+--- @return string|nil
+function _Http.httpPost(url, params, files, timeout, headers) return '' end
+
+--- POST JSON 请求
+--- @param url string
+--- @param json table|nil
+--- @param timeout integer|nil
+--- @param headers table<string,string>|nil
+--- @return string|nil
+function _Http.postJSON(url, json, timeout, headers) return '' end
+
+--- 下载文件（同名：downloadFile）
+--- @param url string
+--- @param file string
+--- @param timeout integer|nil
+--- @param headers table<string,string>|nil
+--- @return boolean
+function _Http.downloadFile(url, file, timeout, headers) return true end
+
+---@class WebSocket
+local _WebSocket = {}
+
+--- 创建 WebSocket（同名：newWebsocket）
+--- @param url string
+--- @param header table<string,string>|nil
+--- @return WebSocket
+function _Http.newWebsocket(url, header)
+    ---@type WebSocket
+    local ws
+    return ws
+end
+
+--- 连接
+function _WebSocket.connect() end
+--- 关闭
+function _WebSocket.close() end
+--- 重置
+--- @return boolean
+function _WebSocket.reset() return true end
+--- 是否已关闭
+--- @return boolean
+function _WebSocket.isClosed() return true end
+--- 是否已连接
+--- @return boolean
+function _WebSocket.isConnected() return false end
+--- 发送文本
+--- @param data string
+function _WebSocket.sendText(data) end
+--- 发送二进制（base64 字符串）
+--- @param data string
+function _WebSocket.sendBinary(data) end
+--- 设置连接超时
+--- @param timeout number
+function _WebSocket.setConnectionTimeout(timeout) end
+--- 设置写入超时
+--- @param timeout number
+function _WebSocket.setWriteTimeout(timeout) end
+--- 启动心跳（可选回调返回心跳文本）
+--- @param interval number
+--- @param fn fun():string|nil
+function _WebSocket.startHeartbeatInterval(interval, fn) end
+--- 停止心跳
+function _WebSocket.stopHeartbeatInterval() end
+--- 自动重连
+--- @param autoReconnect boolean
+function _WebSocket.setAutoReconnect(autoReconnect) end
+
+--- 监听打开
+--- @param fn fun()
+function _WebSocket.onOpen(fn) end
+--- 监听关闭
+--- @param fn fun()
+function _WebSocket.onClose(fn) end
+--- 监听文本
+--- @param fn fun(text:string)
+function _WebSocket.onText(fn) end
+--- 监听二进制（base64 字符串）
+--- @param fn fun(data:string)
+function _WebSocket.onBinary(fn) end
+--- 监听错误
+--- @param fn fun(error:string)
+function _WebSocket.onError(fn) end
+
+return _Http