ms-vite-plugin 1.4.59 → 1.4.61

package/docs/apilua/hid.md

@@ -1,5 +1,7 @@
 # HID 模块
 
+模块表是内置全局 `hid`，直接调用即可。不要 `require` 宿主模块。
+
 HID 模块提供基于 HID 设备的触控与按键能力，包括点击、滑动、系统导航、文本输入、组合键以及剪贴板与应用控制。
 
 ## 常量
@@ -51,7 +53,6 @@ HidKey = {}
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.sendKey({ HidKey.COMMAND, "c" })
 hid.sendKey({ HidKey.HOME })
 ```
@@ -68,7 +69,6 @@ function isBLEConnected() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.isBLEConnected())
 ```
 
@@ -82,7 +82,6 @@ function isUSBConnected() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.isUSBConnected())
 ```
 
@@ -96,7 +95,6 @@ function getBLEHIDDeviceName() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.getBLEHIDDeviceName())
 ```
 
@@ -116,7 +114,6 @@ function setBLEHIDDeviceName(name) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.setBLEHIDDeviceName("KuaiJS-HID"))
 ```
 
@@ -130,7 +127,6 @@ function getDeviceMac() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.getDeviceMac())
 ```
 
@@ -144,7 +140,6 @@ function getDeviceModel() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.getDeviceModel())
 ```
 
@@ -158,7 +153,6 @@ function getDeviceVersion() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.getDeviceVersion())
 ```
 
@@ -181,7 +175,6 @@ function resetPosition() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 复位坐标到左上角
 local ok = hid.resetPosition()
 print(ok) -- 输出: true 或 false
@@ -204,7 +197,6 @@ function restartDevice() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.restartDevice())
 ```
 
@@ -222,7 +214,6 @@ function openRecordScreen() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.openRecordScreen()
 ```
 
@@ -241,7 +232,6 @@ function isRecording() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 print(hid.isRecording())
 ```
 
@@ -264,11 +254,33 @@ function setJitterValue(value) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 设置抖动值为5像素
 hid.setJitterValue(5)
 ```
 
+### setActionDelay - 设置动作延迟
+
+设置连续点击/滑动之间的等待毫秒。不调用时用固件默认（相对 200ms / 绝对 100ms）。
+
+```lua
+---@param milliseconds number
+---@return boolean
+function setActionDelay(milliseconds) end
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `milliseconds` | number | 是 | `-1` | `0` 关闭，`>0` 覆盖毫秒，`-1` 恢复默认 |
+
+**示例:**
+
+```lua
+hid.setActionDelay(0)
+hid.click(100, 200)
+hid.click(300, 400)
+```
+
 ## 基础触摸操作
 
 ### click - 点击操作
@@ -300,7 +312,6 @@ function click(x, y, duration, jitter) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 简单点击
 hid.click(100, 200)
 -- 带持续时间和抖动的点击
@@ -338,7 +349,6 @@ function clickRandom(x1, y1, x2, y2, duration) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 在区域内随机点击
 hid.clickRandom(100, 100, 200, 200, 20)
 ```
@@ -368,7 +378,6 @@ function move(x, y) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 移动到 (100, 200)
 hid.move(100, 200)
 ```
@@ -385,7 +394,6 @@ function mouseDown() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.mouseDown()
 ```
 
@@ -401,7 +409,6 @@ function mouseUp() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.mouseUp()
 ```
 
@@ -436,7 +443,6 @@ function doubleClick(x, y, duration, interval, jitter) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 带抖动的双击
 hid.doubleClick(100, 100, 20, 20, true)
 ```
@@ -474,7 +480,6 @@ function doubleClickRandom(x1, y1, x2, y2, duration, interval) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 在区域内随机双击
 hid.doubleClickRandom(100, 100, 200, 200, 20, 20)
 ```
@@ -514,7 +519,6 @@ function swipe(x, y, ex, ey, jitter, steps) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 简单滑动
 hid.swipe(100, 100, 200, 200)
 -- 带抖动和自定义步数的滑动
@@ -556,7 +560,6 @@ function swipe(x, y, ex, ey, duration, jitter, steps) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 长按 1 秒后滑动
 hid.pressAndSwipe(100, 100, 200, 200, 1000)
 -- 长按 1 秒后带抖动和自定义步数的滑动
@@ -596,7 +599,6 @@ function swipeCurve(startX, startY, midX, midY, endX, endY) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 通过三个点的曲线滑动
 hid.swipeCurve(100, 100, 150, 50, 200, 100)
 ```
@@ -620,7 +622,6 @@ function homeScreen() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 回到主屏幕
 hid.homeScreen()
 ```
@@ -645,7 +646,6 @@ function input(text) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.input("Hello World")
 hid.input("测试")
 ```
@@ -673,7 +673,6 @@ function inputSimple(text) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 输入英文与数字
 hid.inputSimple("hello_123")
 ```
@@ -697,7 +696,6 @@ function space() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.space()
 ```
 
@@ -725,7 +723,6 @@ function backspace(count) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.backspace()
 hid.backspace(3)
 ```
@@ -747,7 +744,6 @@ function enter() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.enter()
 ```
 
@@ -768,7 +764,6 @@ function pressButton(button) end
 **示例：**
 
 ```lua
-local hid = require("hid")
 hid.pressButton("home")
 hid.pressButton("volumeup")
 hid.pressButton("snapshot")
@@ -799,7 +794,6 @@ function sendKey(key) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 发送Cmd+C
 hid.sendKey({ HidKey.COMMAND, "c" })
 -- 发送Ctrl+Alt+Delete
@@ -823,7 +817,6 @@ function copyText() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.copyText()
 ```
 
@@ -844,7 +837,6 @@ function pasteText() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.pasteText()
 ```
 
@@ -867,7 +859,6 @@ function back() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.back()
 ```
 
@@ -888,7 +879,6 @@ function recent() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.recent()
 ```
 
@@ -909,7 +899,6 @@ function lock() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.lock()
 ```
 
@@ -930,7 +919,6 @@ function unlock() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.unlock()
 ```
 
@@ -959,7 +947,6 @@ function openURL(url) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 打开网站
 hid.openURL("https://www.example.com")
 -- 使用自定义scheme打开应用
@@ -989,7 +976,6 @@ function openApp(name) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 打开Safari
 hid.openApp("Safari")
 -- 打开设置
@@ -1016,7 +1002,6 @@ function closeApp(name) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.closeApp("Safari")
 hid.closeApp("com.example.myapp")
 ```
@@ -1038,7 +1023,6 @@ function takeMeToFront() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.takeMeToFront()
 ```
 
@@ -1065,7 +1049,6 @@ function currentAppInfo() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 local appInfo = hid.currentAppInfo()
 if appInfo then
   print("当前应用: " .. tostring(appInfo.name) .. " (" .. tostring(appInfo.bundleId) .. ")")
@@ -1097,7 +1080,6 @@ function setClipboard(text) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.setClipboard("你好，世界！")
 ```
 
@@ -1118,7 +1100,6 @@ function getClipboard() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 local clipboardText = hid.getClipboard()
 if clipboardText then
   print("剪贴板内容:", clipboardText)

package/docs/apilua/hotUpdate.md

@@ -1,5 +1,7 @@
 # 热更新模块 (HotUpdate)
 
+模块表是内置全局 `hotupdate`，直接调用即可。不要 `require` 宿主模块。
+
 热更新模块提供了完整的应用热更新功能，支持检查更新、下载更新包、MD5 校验、对话框展示等核心功能。
 
 ## 自动检查更新
@@ -78,7 +80,6 @@ function checkUpdate() end
 **示例:**
 
 ```lua
-local hotupdate = require("hotupdate")
 -- 检查更新
 local result = hotupdate.checkUpdate()
 
@@ -121,7 +122,6 @@ function downloadAndInstall() end
 **示例:**
 
 ```lua
-local hotupdate = require("hotupdate")
 -- 先检查更新，再手动下载安装
 local result = hotupdate.checkUpdate()
 
@@ -161,7 +161,6 @@ function getCurrentVersion() end
 **示例:**
 
 ```lua
-local hotupdate = require("hotupdate")
 local version = hotupdate.getCurrentVersion()
 print("当前版本:", version)
 ```

package/docs/apilua/http.md

@@ -1,5 +1,7 @@
 # HTTP 模块 (HTTP)
 
+模块表是内置全局 `http`，直接调用即可。不要 `require` 宿主模块。
+
 HTTP 模块提供了完整的网络请求功能，包括 HTTP 请求、文件下载、WebSocket 连接等。
 
 ## 通用 HTTP 请求
@@ -48,7 +50,6 @@ function request(params) end
 **示例：**
 
 ```lua
-local http = require("http")
 -- GET 请求
 local response = http.request({
   url = "https://api.example.com/users",
@@ -117,7 +118,6 @@ function httpGet(url, params, timeout, headers) end
 **示例：**
 
 ```lua
-local http = require("http")
 -- 简单 GET 请求
 local html = http.httpGet("https://www.example.com")
 print(html)
@@ -162,7 +162,6 @@ function httpPost(url, params, files, timeout, headers) end
 **示例：**
 
 ```lua
-local http = require("http")
 -- 发送表单数据
 local response = http.httpPost("https://api.example.com/submit", {
   username = "admin",
@@ -209,7 +208,6 @@ function postJSON(url, json, timeout, headers) end
 **示例：**
 
 ```lua
-local http = require("http")
 -- 发送 JSON 数据
 local response = http.postJSON(
   "https://api.example.com/api/users",
@@ -255,8 +253,6 @@ function downloadFile(url, file, timeout, headers) end
 **示例：**
 
 ```lua
-local http = require("http")
-local file = require("file")
 local documentsDir = file.getInternalDir("documents")
 -- 下载文件
 local success = http.downloadFile(
@@ -379,7 +375,6 @@ function stopHeartbeatInterval() end
 **WebSocket 完整示例：**
 
 ```lua
-local http = require("http")
 
 local function createWebSocketConnection()
   local ws = http.newWebsocket("wss://echo.websocket.org", {

package/docs/apilua/image.md

@@ -1,5 +1,7 @@
 # 图片模块 (Image)
 
+模块表是内置全局 `image`，直接调用即可。不要 `require` 宿主模块。
+
 图片模块提供了强大的图像处理功能，包括截图、图像识别、模板匹配、颜色查找、图像变换等。
 
 注意所有的 `imageId` 都需要在使用后释放，否则会导致内存泄漏。
@@ -45,8 +47,6 @@ function captureScreen(x, y, ex, ey) end
 **示例：**
 
 ```lua
-local image = require("image")
-local file = require("file")
 local dir = file.getInternalDir("documents")
 
 -- 全屏截图
@@ -87,7 +87,6 @@ function readImage(path) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.readImage("template.jpg")
 if imageId then
   print("图片读取成功")
@@ -123,7 +122,6 @@ function saveTo(imageId, filePath) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
@@ -177,7 +175,6 @@ function isRelease(imageId) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
   print("释放前: " .. tostring(image.isRelease(imageId))); -- false
@@ -211,7 +208,6 @@ function getSize(imageId) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
   local size = image.getSize(imageId)
@@ -249,7 +245,6 @@ function pixel(imageId, x, y) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
   local color = image.pixel(imageId, 100, 100)
@@ -318,7 +313,6 @@ function findColor(imageId, color, threshold, x, y, ex, ey, limit, orz) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
 -- 查找蓝色按钮
@@ -383,7 +377,6 @@ function findMultiColor(imageId, firstColor, threshold, points, x, y, ex, ey, li
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
 -- 查找特定的颜色组合（如按钮的特征颜色）
@@ -444,7 +437,6 @@ function countColor(imageId, colors, threshold, x, y, ex, ey) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
   local count = image.countColor(
@@ -489,7 +481,6 @@ function cmpColor(imageId, points, threshold) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
 -- 检查特定区域是否为预期颜色
@@ -732,7 +723,6 @@ local scaleFactors = buildScaleFactors(baseScale)
 **示例：**
 
 ```lua
-local image = require("image")
 -- 1) 同分辨率标准找图（最常用，模板就是本机截的）
 local matches = image.findImage(
   "screen",
@@ -845,7 +835,6 @@ function clip(imageId, x, y, ex, ey) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
@@ -888,7 +877,6 @@ function rotateImage(imageId, degree) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.readImage("photo.jpg")
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
@@ -925,7 +913,6 @@ function gray(imageId) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
@@ -962,7 +949,6 @@ function binaryzation(imageId, threshold) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
@@ -1000,7 +986,6 @@ function drawRect(imageId, x, y, ex, ey, color, thickness) end
 **示例：**
 
 ```lua
-local image = require("image")
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
 
@@ -1035,7 +1020,6 @@ function scanCode(imageId) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
   local result = image.scanCode(imageId)
@@ -1073,7 +1057,6 @@ function base64ToImage(base64) end
 **示例：**
 
 ```lua
-local image = require("image")
 local base64Data =
   "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+P+/HgAFhAJ/wlseKgAAAABJRU5ErkJggg=="
 local imageId = image.base64ToImage(base64Data)
@@ -1112,7 +1095,6 @@ function toBase64Format(imageId, format, q) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.captureScreen()
 if imageId then
   local base64 = image.toBase64Format(imageId, "jpg", 90)

package/docs/apilua/ime.md

@@ -1,5 +1,7 @@
 # 输入法模块 (IME)
 
+模块表是内置全局 `ime`，直接调用即可。不要 `require` 宿主模块。
+
 输入法模块提供了文本输入、剪贴板操作、键盘控制等功能，支持模拟用户的文本输入行为。
 
 ## 前提条件
@@ -27,7 +29,6 @@ function isOk() end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 检查输入法状态，只有键盘弹出后面的方法才能调用
 if ime.isOk() then
   print("输入法键盘已弹出")
@@ -55,7 +56,6 @@ function getText() end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 获取当前输入框文本
 local currentText = ime.getText()
 print("当前文本: " .. tostring(currentText))
@@ -77,7 +77,6 @@ function clearText() end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 清空输入框
 if ime.clearText() then
   print("文本清除成功")
@@ -111,7 +110,6 @@ function input(text) end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 基础文本输入
 local textAfter = ime.input("Hello World")
 print("输入后文本: " .. tostring(textAfter))
@@ -143,7 +141,6 @@ function paste(content) end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 基础粘贴操作（使用剪贴板内容）
 local pasted = ime.paste()
 print("粘贴后文本: " .. tostring(pasted))
@@ -170,7 +167,6 @@ function pressDel() end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 删除一个字符
 local remaining = ime.pressDel()
 print("删除后剩余文本: " .. tostring(remaining))
@@ -192,7 +188,6 @@ function pressEnter() end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 按下回车键
 if ime.pressEnter() then
   print("回车键按下成功")
@@ -217,7 +212,6 @@ function dismiss() end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 隐藏键盘
 if ime.dismiss() then
   print("键盘隐藏成功")
@@ -244,7 +238,6 @@ function getClipboard() end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 获取剪贴板内容
 local clipboardText = ime.getClipboard()
 print("剪贴板内容: " .. tostring(clipboardText))
@@ -273,7 +266,6 @@ function setClipboard(text) end
 **示例：**
 
 ```lua
-local ime = require("ime")
 -- 设置剪贴板内容
 if ime.setClipboard("要复制的文本") then
   print("剪贴板设置成功")