ms-vite-plugin 1.4.59 → 1.4.61

package/docs/apilua/config.md

@@ -1,5 +1,7 @@
 # 配置模块 (Config)
 
+模块表是内置全局 `config`，直接调用即可。不要 `require` 宿主模块。
+
 配置模块提供了读取、更新和删除应用配置的功能。
 
 网页的 ms.setConfig 对应 config.set
@@ -28,7 +30,6 @@ function all() end
 **示例:**
 
 ```lua
-local config = require("config")
 local allConfigs = config.all()
 print("所有配置: " .. tostring(ToJsonString(allConfigs, nil, 2)))
 ```
@@ -56,7 +57,6 @@ function setAll(config) end
 **示例:**
 
 ```lua
-local config = require("config")
 local success = config.setAll({ maxRetries = 5, debugEnabled = true })
 if success then
   print("所有配置已更新")
@@ -88,7 +88,6 @@ function set(key, value) end
 **示例:**
 
 ```lua
-local config = require("config")
 -- 更新不同类型的配置
 local success1 = config.set("maxRetries", 5)
 local success2 = config.set("apiBaseUrl", "https://api.example.com")
@@ -122,7 +121,6 @@ function get(key) end
 **示例:**
 
 ```lua
-local config = require("config")
 local maxRetries = config.get("maxRetries")
 if maxRetries ~= nil then
   print("最大重试次数: " .. tostring(maxRetries))
@@ -145,7 +143,6 @@ function getKuiConfig() end
 **示例:**
 
 ```lua
-local config = require("config")
 local kuiConfig = config.getKuiConfig()
 print("KUI 配置: " .. tostring(ToJsonString(kuiConfig, nil, 2)))
 ```
@@ -173,7 +170,6 @@ function remove(key) end
 **示例:**
 
 ```lua
-local config = require("config")
 local deleted = config.remove("temporaryConfig")
 if deleted then
   print("临时配置已删除")

package/docs/apilua/cryptoUtils.md

@@ -1,5 +1,7 @@
 # 加密模块 (CryptoUtils)
 
+模块表是内置全局 `cryptoUtils`，直接调用即可。不要 `require` 宿主模块。
+
 加密模块提供了常用的加密和解密功能，支持 AES、RSA 以及 MD5、SHA1、SHA256 等哈希算法。
 
 ## 功能概览
@@ -41,7 +43,6 @@ function encryptWithAES_ECB(data, aesKey, noPadding) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "Hello World"
 local key = "1234567890123456"; -- 16位密钥
 local encrypted = cryptoUtils.encryptWithAES_ECB(data, key)
@@ -77,7 +78,6 @@ function decryptWithAES_ECB(data, aesKey, noPadding) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local encryptedData = "Base64EncodedString..."
 local key = "1234567890123456"
 local decrypted = cryptoUtils.decryptWithAES_ECB(encryptedData, key)
@@ -113,7 +113,6 @@ function encryptWithRSA(data, rsaPublicKey) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "123456"
 local publicKey = "-----BEGIN PUBLIC KEY-----
 公钥内容
@@ -150,7 +149,6 @@ function decryptWithRSA(data, rsaPrivateKey) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local encryptedData = "加密后字符串"
 local privateKey = "-----BEGIN PRIVATE KEY-----
 私钥内容
@@ -184,7 +182,6 @@ function md5(data) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "123456"
 local hash = cryptoUtils.md5(data)
 print("MD5 = " .. tostring(hash)); -- e10adc3949ba59abbe56e057f20f883e
@@ -215,7 +212,6 @@ function sha1(data, key) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "123456"
 local hash = cryptoUtils.sha1(data)
 print("SHA1 = " .. tostring(hash))
@@ -246,7 +242,6 @@ function sha256(data, key) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "123456"
 local hash = cryptoUtils.sha256(data)
 print("SHA256 = " .. tostring(hash))

package/docs/apilua/device.md

@@ -1,5 +1,7 @@
 # 设备模块 (Device)
 
+模块表是内置全局 `device`，直接调用即可。不要 `require` 宿主模块。
+
 设备模块提供了获取设备信息和设备操作的功能，包括电池信息、设备标识、屏幕信息、系统信息等。
 
 ## 电池信息
@@ -21,7 +23,6 @@ function getBatteryInfo() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取电池信息
 local battery = device.getBatteryInfo()
 print("电池电量: " .. tostring(battery.level) .. "%")
@@ -48,7 +49,6 @@ function getStorageSpace() end
 **示例：**
 
 ```lua
-local device = require("device")
 local storage = device.getStorageSpace()
 print("总存储: " .. tostring(storage.total) .. tostring(storage.unit))
 print("剩余存储: " .. tostring(storage.free) .. tostring(storage.unit))
@@ -77,7 +77,6 @@ function getDeviceID() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取设备ID
 local uuid = device.getDeviceID()
 print("设备ID = " .. tostring(uuid))
@@ -104,7 +103,6 @@ function getServerDeviceId() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取服务器设备ID
 local serverDeviceId = device.getServerDeviceId()
 print("服务器设备ID = " .. tostring(serverDeviceId))
@@ -126,7 +124,6 @@ function getECID() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取ECID
 local ecid = device.getECID()
 print("ECID = " .. tostring(ecid))
@@ -148,7 +145,6 @@ function getUDID() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取UDID
 local udid = device.getUDID()
 print("UDID = " .. tostring(udid))
@@ -170,7 +166,6 @@ function getDeviceName() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取设备名称
 local deviceName = device.getDeviceName()
 print("设备名称: " .. tostring(deviceName))
@@ -192,7 +187,6 @@ function getDeviceModel() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取设备型号
 local model = device.getDeviceModel()
 print("设备型号: " .. tostring(model))
@@ -222,7 +216,6 @@ function getScreenSize() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕尺寸
 local screenSize = device.getScreenSize()
 print("屏幕尺寸: " .. tostring(screenSize.width) .. " x " .. tostring(screenSize.height))
@@ -250,7 +243,6 @@ function getScreenRealSize() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕实际尺寸
 local screenRealSize = device.getScreenRealSize()
 print("屏幕实际尺寸: " .. tostring(screenRealSize.width) .. " x " .. tostring(screenRealSize.height))
@@ -272,7 +264,6 @@ function getScreenScale() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕缩放比例
 local scale = device.getScreenScale()
 print("屏幕缩放比例: " .. tostring(scale))
@@ -294,7 +285,6 @@ function getScreenBrightness() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕亮度
 local brightness = device.getScreenBrightness()
 print("屏幕亮度: " .. tostring(brightness))
@@ -325,7 +315,6 @@ function setScreenBrightness(brightness) end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 设置屏幕亮度到 50%
 device.setScreenBrightness(0.5)
 ```
@@ -346,7 +335,6 @@ function getVolume() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取系统音量
 local volume = device.getVolume()
 print("系统音量: " .. tostring(volume))
@@ -377,7 +365,6 @@ function setVolume(volume) end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 设置系统音量到 50%
 device.setVolume(0.5)
 ```
@@ -403,7 +390,6 @@ function getOrientation() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕方向
 local orientation = device.getOrientation()
 print("屏幕方向: " .. tostring(orientation))
@@ -427,7 +413,6 @@ function getOSVersion() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取系统版本
 local osVersion = device.getOSVersion()
 print("系统版本: iOS " .. tostring(osVersion))
@@ -449,7 +434,6 @@ function getLanIp() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取局域网IP
 local lanIp = device.getLanIp()
 print("局域网IP = " .. tostring(lanIp))
@@ -475,7 +459,6 @@ function vibrate(duration, intensity) end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 基础振动
 device.vibrate(500, 0.5); -- 振动500ms，中等强度
 -- 不同强度的振动

package/docs/apilua/dotocr.md

@@ -1,5 +1,7 @@
 # 点阵 OCR 模块 (dotocr)
 
+模块表是内置全局 `dotocr`，直接调用即可。不要 `require` 宿主模块。
+
 点阵 OCR 模块基于图色工具生成的固定像素点阵字库，提供精确的文字识别与查找功能。字库保存在项目的 `res/fonts` 目录，使用前需先加载字库取得字库 ID，再复用该 ID 进行识别，使用完毕后释放。
 
 点阵模板按照制作时的原始像素尺寸匹配，不会自动缩放到其他分辨率。目标文字的字号、缩放比例或像素形状发生变化时，应制作对应的字库特征。
@@ -73,7 +75,6 @@ function loadFont(fontPath) end
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 local fontId = dotocr.loadFont("/fonts/default.json")
 if not fontId then
   print("字库加载失败")
@@ -121,7 +122,6 @@ function recognizeAbs(fontId, input, x, y, ex, ey, confidenceThreshold) end
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 local chars = dotocr.recognizeAbs(fontId, "screen", 100, 200, 600, 280, 0.95)
 print("识别数量: " .. tostring(#chars))
 if #chars > 0 then
@@ -173,7 +173,6 @@ function findTextAbs(fontId, input, targetTexts, x, y, ex, ey, confidenceThresho
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 local hits = dotocr.findTextAbs(
   fontId,
   "screen",
@@ -208,7 +207,6 @@ function free(fontId) end
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 if fontId then
   dotocr.free(fontId)
   print("字库 " .. tostring(fontId) .. " 资源已释放")
@@ -224,7 +222,6 @@ function freeAll() end
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 dotocr.freeAll()
 print("所有点阵字库资源已释放")
 ```

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` 仍可用，默认走信息级别；需要调试 / 警告 / 错误级别时用下面这些函数。