ms-vite-plugin 1.4.58 → 1.4.60

package/docs/apilua/file.md

@@ -1,5 +1,7 @@
 # 文件模块 (File)
 
+模块表是内置全局 `file`，直接调用即可。不要 `require` 宿主模块。
+
 文件模块提供了完整的文件和目录操作功能，包括文件的创建、读写、删除、复制等操作，以及目录的管理和遍历功能。
 
 ## 功能概览
@@ -41,7 +43,6 @@ function getInternalDir(type) end
 **示例:**
 
 ```lua
-local file = require("file")
 local documentsDir = file.getInternalDir("documents")
 local tempDir = file.getInternalDir("temp")
 print("文档目录: " .. tostring(documentsDir))
@@ -71,7 +72,6 @@ function mkdirs(path) end
 **示例:**
 
 ```lua
-local file = require("file")
 local success = file.mkdirs("/path/to/nested/directory")
 if success then
   print("目录创建成功")
@@ -103,7 +103,6 @@ function listDir(path, recursion) end
 **示例:**
 
 ```lua
-local file = require("file")
 -- 列出目录内容（不递归）
 local files = file.listDir("/path/to/directory", false)
 print("目录内容: " .. tostring(ToJsonString(files)))
@@ -137,7 +136,6 @@ function create(path) end
 **示例:**
 
 ```lua
-local file = require("file")
 local created = file.create("/path/to/newfile.txt")
 if created then
   print("文件创建成功")
@@ -167,7 +165,6 @@ function exists(path) end
 **示例:**
 
 ```lua
-local file = require("file")
 if file.exists("/path/to/file.txt") then
   print("文件存在")
 else
@@ -200,7 +197,6 @@ function copy(src, dest) end
 **示例:**
 
 ```lua
-local file = require("file")
 local copied = file.copy("/path/to/source.txt", "/path/to/destination.txt")
 if copied then
   print("文件复制成功")
@@ -230,7 +226,6 @@ function deleteAllFile(path) end
 **示例:**
 
 ```lua
-local file = require("file")
 local deleted = file.deleteAllFile("/path/to/file.txt")
 if deleted then
   print("文件删除成功")
@@ -262,7 +257,6 @@ function readFile(path) end
 **示例:**
 
 ```lua
-local file = require("file")
 local content = file.readFile("/path/to/file.txt")
 if content ~= nil then
   print("文件内容: " .. tostring(content))
@@ -299,7 +293,6 @@ function readResFile(fileName) end
 **示例:**
 
 ```lua
-local file = require("file")
 -- 读取配置文件
 local config = file.readResFile("config.json")
 if config ~= "" then
@@ -322,7 +315,6 @@ function getResFile(fileName) end
 **示例:**
 
 ```lua
-local file = require("file")
 local path = file.getResFile("model.bin")
 if path then
   file.cleanupResFile(path)
@@ -345,7 +337,6 @@ function cleanupResFile(path) end
 **示例:**
 
 ```lua
-local file = require("file")
 file.cleanupResFile(path)
 ```
 
@@ -374,7 +365,6 @@ function writeFile(path, content) end
 **示例:**
 
 ```lua
-local file = require("file")
 local success = file.writeFile("/path/to/file.txt", "Hello, World!")
 if success then
   print("文件写入成功")
@@ -406,7 +396,6 @@ function appendLine(path, content) end
 **示例:**
 
 ```lua
-local file = require("file")
 local appended = file.appendLine("/path/to/log.txt", "新的日志条目")
 if appended then
   print("内容追加成功")
@@ -440,7 +429,6 @@ function readLine(path, lineNo) end
 **示例:**
 
 ```lua
-local file = require("file")
 local firstLine = file.readLine("/path/to/file.txt", 1)
 if firstLine ~= nil then
   print("第一行内容: " .. tostring(firstLine))
@@ -472,7 +460,6 @@ function readAllLines(path) end
 **示例:**
 
 ```lua
-local file = require("file")
 local lines = file.readAllLines("/path/to/file.txt")
 if lines ~= nil then
   for index, line in ipairs(lines) do
@@ -510,7 +497,6 @@ function deleteLine(path, line, contains) end
 **示例:**
 
 ```lua
-local file = require("file")
 -- 删除第3行
 file.deleteLine("/path/to/file.txt", 3, nil)
 -- 删除包含"error"的行
@@ -544,7 +530,6 @@ function fileMD5(path) end
 **示例:**
 
 ```lua
-local file = require("file")
 local md5 = file.fileMD5("/path/to/file.txt")
 if md5 then
   print("文件MD5 = " .. tostring(md5))

package/docs/apilua/global.md

@@ -655,7 +655,7 @@ print(ToJsonString({ a = 1, b = 2 }))
 
 ## 全局日志函数
 
-全局日志函数是 `logger` 模块对应方法的便捷别名，可以直接调用而无需 `require("logger")`。可变参会按空格拼接为一行。级别和是否写文件仍由 `logger.setLoggerLevel` / `logger.setLogToFile` 控制。
+全局日志函数是 `logger` 模块对应方法的便捷别名，可以直接调用而无需再取模块表。可变参会按空格拼接为一行。级别和是否写文件仍由 `logger.setLoggerLevel` / `logger.setLogToFile` 控制。
 
 `print` 仍可用，默认走信息级别；需要调试 / 警告 / 错误级别时用下面这些函数。
 

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,7 +254,6 @@ function setJitterValue(value) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 设置抖动值为5像素
 hid.setJitterValue(5)
 ```
@@ -300,7 +289,6 @@ function click(x, y, duration, jitter) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 简单点击
 hid.click(100, 200)
 -- 带持续时间和抖动的点击
@@ -338,7 +326,6 @@ function clickRandom(x1, y1, x2, y2, duration) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 在区域内随机点击
 hid.clickRandom(100, 100, 200, 200, 20)
 ```
@@ -368,7 +355,6 @@ function move(x, y) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 移动到 (100, 200)
 hid.move(100, 200)
 ```
@@ -385,7 +371,6 @@ function mouseDown() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.mouseDown()
 ```
 
@@ -401,7 +386,6 @@ function mouseUp() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.mouseUp()
 ```
 
@@ -436,7 +420,6 @@ function doubleClick(x, y, duration, interval, jitter) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 带抖动的双击
 hid.doubleClick(100, 100, 20, 20, true)
 ```
@@ -474,7 +457,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 +496,6 @@ function swipe(x, y, ex, ey, jitter, steps) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 简单滑动
 hid.swipe(100, 100, 200, 200)
 -- 带抖动和自定义步数的滑动
@@ -556,7 +537,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 +576,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 +599,6 @@ function homeScreen() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 回到主屏幕
 hid.homeScreen()
 ```
@@ -645,7 +623,6 @@ function input(text) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.input("Hello World")
 hid.input("测试")
 ```
@@ -673,7 +650,6 @@ function inputSimple(text) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 输入英文与数字
 hid.inputSimple("hello_123")
 ```
@@ -697,7 +673,6 @@ function space() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.space()
 ```
 
@@ -725,7 +700,6 @@ function backspace(count) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.backspace()
 hid.backspace(3)
 ```
@@ -747,7 +721,6 @@ function enter() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.enter()
 ```
 
@@ -768,7 +741,6 @@ function pressButton(button) end
 **示例：**
 
 ```lua
-local hid = require("hid")
 hid.pressButton("home")
 hid.pressButton("volumeup")
 hid.pressButton("snapshot")
@@ -799,7 +771,6 @@ function sendKey(key) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 发送Cmd+C
 hid.sendKey({ HidKey.COMMAND, "c" })
 -- 发送Ctrl+Alt+Delete
@@ -823,7 +794,6 @@ function copyText() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.copyText()
 ```
 
@@ -844,7 +814,6 @@ function pasteText() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.pasteText()
 ```
 
@@ -867,7 +836,6 @@ function back() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.back()
 ```
 
@@ -888,7 +856,6 @@ function recent() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.recent()
 ```
 
@@ -909,7 +876,6 @@ function lock() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.lock()
 ```
 
@@ -930,7 +896,6 @@ function unlock() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.unlock()
 ```
 
@@ -959,7 +924,6 @@ function openURL(url) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 打开网站
 hid.openURL("https://www.example.com")
 -- 使用自定义scheme打开应用
@@ -989,7 +953,6 @@ function openApp(name) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 -- 打开Safari
 hid.openApp("Safari")
 -- 打开设置
@@ -1016,7 +979,6 @@ function closeApp(name) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.closeApp("Safari")
 hid.closeApp("com.example.myapp")
 ```
@@ -1038,7 +1000,6 @@ function takeMeToFront() end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.takeMeToFront()
 ```
 
@@ -1065,7 +1026,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 +1057,6 @@ function setClipboard(text) end
 **示例:**
 
 ```lua
-local hid = require("hid")
 hid.setClipboard("你好，世界！")
 ```
 
@@ -1118,7 +1077,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", {