ms-vite-plugin 1.4.58 → 1.4.60

package/docs/apilua/image.md

@@ -1,5 +1,7 @@
 # 图片模块 (Image)
 
+模块表是内置全局 `image`，直接调用即可。不要 `require` 宿主模块。
+
 图片模块提供了强大的图像处理功能，包括截图、图像识别、模板匹配、颜色查找、图像变换等。
 
 注意所有的 `imageId` 都需要在使用后释放，否则会导致内存泄漏。
@@ -18,8 +20,6 @@
 
 ### captureScreen - 截取屏幕。
 
-坐标缺省 `0` 表示全屏。四个坐标都传 `0` 时与 `captureFullScreen` 相同。
-
 ```lua
 ---@param x number?
 ---@param y number?
@@ -47,8 +47,6 @@ function captureScreen(x, y, ex, ey) end
 **示例：**
 
 ```lua
-local image = require("image")
-local file = require("file")
 local dir = file.getInternalDir("documents")
 
 -- 全屏截图
@@ -66,77 +64,6 @@ if rectId then
 end
 ```
 
-### captureFullScreen - 截取全屏。
-
-```lua
----@return string|nil
-function captureFullScreen() end
-```
-
-**返回值：**
-
-| 类型            | 描述                             |
-| --------------- | -------------------------------- |
-| `string \| nil` | 截图的图片 ID，失败时返回 `nil` |
-
-**示例：**
-
-```lua
-local image = require("image")
-local file = require("file")
-local imageId = image.captureFullScreen()
-local dir = file.getInternalDir("documents")
-if imageId then
-  print("截图成功")
-  image.saveTo(imageId, dir .. "/screenshot.jpg")
-  image.release(imageId)
-else
-  print("截图失败")
-end
-```
-
-### captureRect - 截取指定区域。
-
-```lua
----@param x number?
----@param y number?
----@param ex number?
----@param ey number?
----@return string|nil
-function captureRect(x, y, ex, ey) end
-```
-
-**参数：**
-
-| 参数名 | 类型   | 是否必填 | 默认值 | 描述              |
-| ------ | ------ | -------- | ------ | ----------------- |
-| `x`    | number | 否       | 0      | 区域左上角 X 坐标 |
-| `y`    | number | 否       | 0      | 区域左上角 Y 坐标 |
-| `ex`   | number | 否       | 0      | 区域右下角 X 坐标 |
-| `ey`   | number | 否       | 0      | 区域右下角 Y 坐标 |
-
-**返回值：**
-
-| 类型            | 描述                             |
-| --------------- | -------------------------------- |
-| `string \| nil` | 截图的图片 ID，失败时返回 `nil` |
-
-**示例：**
-
-```lua
-local image = require("image")
-local file = require("file")
-local imageId = image.captureRect(100, 100, 200, 200)
-local dir = file.getInternalDir("documents")
-if imageId then
-  print("截图成功")
-  image.saveTo(imageId, dir .. "/screenshot.jpg")
-  image.release(imageId)
-else
-  print("截图失败")
-end
-```
-
 ### readImage - 从文件路径或imageId读取图片。
 
 ```lua
@@ -160,7 +87,6 @@ function readImage(path) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.readImage("template.jpg")
 if imageId then
   print("图片读取成功")
@@ -196,8 +122,7 @@ function saveTo(imageId, filePath) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
 if imageId then
@@ -250,8 +175,7 @@ function isRelease(imageId) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
   print("释放前: " .. tostring(image.isRelease(imageId))); -- false
   image.release(imageId)
@@ -284,8 +208,7 @@ function getSize(imageId) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
   local size = image.getSize(imageId)
   if size then
@@ -322,8 +245,7 @@ function pixel(imageId, x, y) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
   local color = image.pixel(imageId, 100, 100)
   local colorHex = image.argb(color)
@@ -391,8 +313,7 @@ function findColor(imageId, color, threshold, x, y, ex, ey, limit, orz) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
 -- 查找蓝色按钮
   local points = image.findColor(
@@ -456,8 +377,7 @@ function findMultiColor(imageId, firstColor, threshold, points, x, y, ex, ey, li
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
 -- 查找特定的颜色组合（如按钮的特征颜色）
   local points = image.findMultiColor(
@@ -517,8 +437,7 @@ function countColor(imageId, colors, threshold, x, y, ex, ey) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
   local count = image.countColor(
     imageId,
@@ -562,8 +481,7 @@ function cmpColor(imageId, points, threshold) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
 -- 检查特定区域是否为预期颜色
   local isMatch = image.cmpColor(
@@ -805,7 +723,6 @@ local scaleFactors = buildScaleFactors(baseScale)
 **示例：**
 
 ```lua
-local image = require("image")
 -- 1) 同分辨率标准找图（最常用，模板就是本机截的）
 local matches = image.findImage(
   "screen",
@@ -918,8 +835,7 @@ function clip(imageId, x, y, ex, ey) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
 if imageId then
@@ -961,7 +877,6 @@ function rotateImage(imageId, degree) end
 **示例：**
 
 ```lua
-local image = require("image")
 local imageId = image.readImage("photo.jpg")
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
@@ -998,8 +913,7 @@ function gray(imageId) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
 if imageId then
@@ -1035,8 +949,7 @@ function binaryzation(imageId, threshold) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
 if imageId then
@@ -1073,11 +986,10 @@ function drawRect(imageId, x, y, ex, ey, color, thickness) end
 **示例：**
 
 ```lua
-local image = require("image")
 -- 获取手机文档目录
 local dir = file.getInternalDir("documents")
 
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
   image.drawRect(imageId, 100, 100, 200, 100, "#FF0000", 2)
   image.saveTo(imageId, tostring(dir) .. "/test.jpg")
@@ -1108,8 +1020,7 @@ function scanCode(imageId) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
   local result = image.scanCode(imageId)
   if result then
@@ -1146,7 +1057,6 @@ function base64ToImage(base64) end
 **示例：**
 
 ```lua
-local image = require("image")
 local base64Data =
   "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+P+/HgAFhAJ/wlseKgAAAABJRU5ErkJggg=="
 local imageId = image.base64ToImage(base64Data)
@@ -1185,8 +1095,7 @@ function toBase64Format(imageId, format, q) end
 **示例：**
 
 ```lua
-local image = require("image")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 if imageId then
   local base64 = image.toBase64Format(imageId, "jpg", 90)
   print("Base64 数据: " .. tostring(base64.substring(0, 100)) .. "...")

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("剪贴板设置成功")

package/docs/apilua/logger.md

@@ -1,5 +1,7 @@
 # 日志模块 (Logger)
 
+模块表是内置全局 `logger`，直接调用即可。不要 `require` 宿主模块。
+
 日志模块提供了完整的日志记录功能，支持不同的日志级别、文件输出、日志管理等。
 
 - **日志级别** 开发环境默认 `debug`，打包环境默认 `info`。如需自定义日志级别，可使用 `setLoggerLevel` 方法。
@@ -14,7 +16,7 @@
 
 - **关闭存储日志** 可使用 `setLogToFile(false)` 关闭将日志输出到文件的功能。
 
-- **全局别名** `logd` / `logi` / `logw` / `loge` 是裸全局，分别等同 `logger.debug` / `logger.info` / `logger.warn` / `logger.error`，无需 `require("logger")`。
+- **全局别名** `logd` / `logi` / `logw` / `loge` 是裸全局，分别等同 `logger.debug` / `logger.info` / `logger.warn` / `logger.error`，无需再取模块表。
 
 ## 日志级别
 
@@ -49,7 +51,6 @@ function setLoggerLevel(level) end
 **示例：**
 
 ```lua
-local logger = require("logger")
 -- 设置为调试级别（输出所有日志）
 logger.setLoggerLevel("debug")
 -- 设置为信息级别（不输出调试日志）
@@ -79,7 +80,6 @@ function setLogToFile(enabled) end
 **示例：**
 
 ```lua
-local logger = require("logger")
 -- 启用文件日志（默认）
 logger.setLogToFile(true)
 -- 禁用文件日志（只在控制台输出）
@@ -110,7 +110,6 @@ function setMaxLogFileCount(count) end
 **示例：**
 
 ```lua
-local logger = require("logger")
 -- 设置最大日志文件数量为 5 个文件
 logger.setMaxLogFileCount(5)
 ```
@@ -136,7 +135,6 @@ function setMaxLogFileSize(size) end
 **示例：**
 
 ```lua
-local logger = require("logger")
 -- 设置最大日志文件大小为 5MB
 logger.setMaxLogFileSize(5)
 ```
@@ -156,7 +154,6 @@ function resetLogFile() end
 **示例：**
 
 ```lua
-local logger = require("logger")
 logger.resetLogFile()
 logger.info("日志文件已重置")
 
@@ -244,8 +241,6 @@ function warn(...args) end
 **示例：**
 
 ```lua
-local logger = require("logger")
-local device = require("device")
 logger.warn("电池电量低于 20%")
 logger.warn("网络连接不稳定")
 logger.warn("使用了已废弃的 API")
@@ -288,7 +283,6 @@ function error(...args) end
 **示例：**
 
 ```lua
-local logger = require("logger")
 logger.error("网络请求失败")
 logger.error("文件读取错误")
 logger.error("数据库连接失败")

package/docs/apilua/media.md

@@ -1,5 +1,7 @@
 # 媒体模块 (Media)
 
+模块表是内置全局 `media`，直接调用即可。不要 `require` 宿主模块。
+
 媒体模块提供了丰富的媒体操作功能，包括图片和视频的相册管理，以及音频播放控制等功能。
 
 ## 功能概览
@@ -35,7 +37,6 @@ function saveImageToAlbum(imageId) end
 **示例:**
 
 ```lua
-local media = require("media")
 -- 保存截图到相册
 media.saveImageToAlbum("screen")
 
@@ -75,7 +76,6 @@ function saveVideoToAlbumPath(path) end
 **示例:**
 
 ```lua
-local media = require("media")
 -- 保存视频到相册 （从 documents 目录读取）
 local documentsDir = file.getInternalDir("documents")
 local videoName = "video.mp4"
@@ -104,7 +104,6 @@ function deleteAllPhotos() end
 **示例:**
 
 ```lua
-local media = require("media")
 -- 清空相册图片
 local deleted = media.deleteAllPhotos()
 if deleted then
@@ -130,7 +129,6 @@ function deleteAllVideos() end
 **示例:**
 
 ```lua
-local media = require("media")
 -- 清空相册视频
 local deleted = media.deleteAllVideos()
 if deleted then
@@ -150,7 +148,6 @@ function deleteAllScreenshots() end
 **示例:**
 
 ```lua
-local media = require("media")
 local deleted = media.deleteAllScreenshots()
 if deleted then
   print("相册截图已清空")
@@ -184,7 +181,6 @@ function playMp3(path, loop) end
 **示例:**
 
 ```lua
-local media = require("media")
 -- 播放背景音乐（循环）
 local played = media.playMp3("/path/to/background.mp3", true)
 if played then
@@ -213,7 +209,6 @@ function stopMp3() end
 **示例:**
 
 ```lua
-local media = require("media")
 -- 停止音乐播放
 local stopped = media.stopMp3()
 if stopped then
@@ -246,7 +241,6 @@ function playMp3WaitEnd(path) end
 **示例:**
 
 ```lua
-local media = require("media")
 -- 同步播放音频，等待播放完成
 print("开始播放音频...")
 local played = media.playMp3WaitEnd("/path/to/notification.mp3")
@@ -274,7 +268,6 @@ function isMp3Playing() end
 **示例:**
 
 ```lua
-local media = require("media")
 if media.isMp3Playing() then
   print("正在播放")
 else

package/docs/apilua/mysql.md

@@ -1,5 +1,7 @@
 # MySQL 数据库模块 (MySQL)
 
+模块表是内置全局 `mysql`，直接调用即可。不要 `require` 宿主模块。
+
 MySQL 模块提供了完整的 MySQL 数据库连接和操作功能，支持连接管理、查询执行、事务处理等核心数据库操作。
 
 ## 功能概览
@@ -91,7 +93,6 @@ function connect(config) end
 **示例:**
 
 ```lua
-local mysql = require("mysql")
 local success = mysql.connect({
   host = "localhost",
   port = 3306,
@@ -119,7 +120,6 @@ function disconnect() end
 **示例:**
 
 ```lua
-local mysql = require("mysql")
 mysql.disconnect()
 print("数据库连接已断开")
 ```
@@ -140,7 +140,6 @@ function isConnected() end
 **示例:**
 
 ```lua
-local mysql = require("mysql")
 if mysql.isConnected() then
   print("数据库已连接")
 else
@@ -177,7 +176,6 @@ function query(sql, params) end
 **示例:**
 
 ```lua
-local mysql = require("mysql")
 -- 简单查询
 local result1 = mysql.query("SELECT * FROM users")
 if result1.success then
@@ -225,7 +223,6 @@ function execute(sql, params) end
 **示例:**
 
 ```lua
-local mysql = require("mysql")
 -- 创建表
 local createTableResult = mysql.execute("
   CREATE TABLE IF NOT EXISTS users (
@@ -284,7 +281,6 @@ function beginTransaction() end
 **示例:**
 
 ```lua
-local mysql = require("mysql")
 if mysql.beginTransaction() then
   print("事务开始")
 else
@@ -308,7 +304,6 @@ function commit() end
 **示例:**
 
 ```lua
-local mysql = require("mysql")
 if mysql.commit() then
   print("事务提交成功")
 else
@@ -332,7 +327,6 @@ function rollback() end
 **示例:**
 
 ```lua
-local mysql = require("mysql")
 if mysql.rollback() then
   print("事务回滚成功")
 else
@@ -345,7 +339,6 @@ end
 ### 基本数据库操作
 
 ```lua
-local mysql = require("mysql")
 -- 1. 创建连接配置
 local dbConfig = {
   host = "localhost",
@@ -381,7 +374,6 @@ end
 ### 事务处理示例
 
 ```lua
-local mysql = require("mysql")
 -- 转账操作示例
 local function transferMoney(fromUserId, toUserId, amount)
   if not mysql.beginTransaction() then

package/docs/apilua/netCard.md

@@ -1,5 +1,7 @@
 # 卡密模块 (NetCard)
 
+模块表是内置全局 `netcard`，直接调用即可。不要 `require` 宿主模块。
+
 卡密模块提供了卡密验证、备注设置以及键值对存储功能，用于管理网络卡密相关的操作。
 
 ## 功能概览
@@ -29,7 +31,6 @@ function isAuthCardMode() end
 **示例:**
 
 ```lua
-local netcard = require("netcard")
 if netcard.isAuthCardMode() then
   print("当前为授权卡密模式，不需要重复调用 verify")
 end
@@ -64,7 +65,6 @@ function verify(cardNo) end
 **示例 1：普通卡密模式**
 
 ```lua
-local netcard = require("netcard")
 -- 验证卡密
 local cardNo = "ABC123456789"
 local isValid = netcard.verify(cardNo)
@@ -105,7 +105,6 @@ function getCardInfo() end
 **示例：**
 
 ```lua
-local netcard = require("netcard")
 -- 获取卡密信息
 local cardInfo = netcard.getCardInfo()
 print(ToJsonString(cardInfo))
@@ -136,7 +135,6 @@ function setCardRemark(remark) end
 **示例：**
 
 ```lua
-local netcard = require("netcard")
 -- 设置卡密备注
 local remark = "测试用户卡密"
 local success = netcard.setCardRemark(remark)
@@ -175,7 +173,6 @@ function setValue(key, value) end
 **示例：**
 
 ```lua
-local netcard = require("netcard")
 -- 设置键值对
 local key = "userConfig"
 local value = "enableNotification"
@@ -211,7 +208,6 @@ function getValue(key) end
 **示例：**
 
 ```lua
-local netcard = require("netcard")
 -- 获取键值对
 local key = "userConfig"
 local value = netcard.getValue(key)

package/docs/apilua/node.md

@@ -1,5 +1,7 @@
 # 节点模块 (Node)
 
+模块表是内置全局 `node`，直接调用即可。不要 `require` 宿主模块。
+
 用于查找和操作当前界面上的控件节点。
 
 **注意**
@@ -203,7 +205,6 @@ btn:setValue("hello")
 | `clickRandom()` | 范围内随机点，不自动滚动 |
 
 ```lua
-local node = require("node")
 local selector <close> = node.createNodeSelector()
 local btn = selector:label("确定"):type("XCUIElementTypeButton"):getOneNodeInfo(3000)
 
@@ -267,7 +268,6 @@ end
 ### 登录
 
 ```lua
-local node = require("node")
 local selector <close> = node.createNodeSelector()
 
 local user = selector:type("XCUIElementTypeTextField"):getOneNodeInfo(5000)
@@ -298,7 +298,6 @@ end
 ### 列表里靠后的项
 
 ```lua
-local node = require("node")
 local selector <close> = node.createNodeSelector({ mode = 2 })
 local item = selector:label("第 30 项"):getOneNodeInfo(5000)
 if item then