ms-vite-plugin 1.4.59 → 1.4.61

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

package/docs/apilua/opencv.md

@@ -1,7 +1,7 @@
 # OpenCV 模块 (cv)
 
 提供图像读写、颜色与阈值、滤波、几何变换、绘制、模板/特征匹配、轮廓、形态学、直方图、霍夫、扫码等能力。
-可通过 `require("cv")` 获取。无中文别名。方法与常量对齐 JS `cv`。
+模块表是内置全局 `cv`，直接调用即可。不要 `require` 宿主模块。无中文别名。方法与常量对齐 JS `cv`。
 
 注意：
 
@@ -51,8 +51,6 @@ Mat：`Mat` · `zeros` · `ones` · `clone` · `empty` · `isRelease` · `releas
 霍夫/连通域/直方图/扫码：`HoughLinesP` · `HoughCircles` · `connectedComponents` · `connectedComponentsWithStats` · `distanceTransform` · `floodFill` · `goodFeaturesToTrack` · `cornerHarris` · `cornerSubPix` · `calcHist` · `compareHist` · `calcBackProject` · `encodeQRCode` · `detectQRCode` · `detectBarcode`
 
 ```lua
-local cv = require("cv")
-local file = require("file")
 
 local src = cv.capture()
 local gray = cv.cvtColor(src, { code = cv.COLOR_BGR2GRAY })
@@ -97,7 +95,6 @@ function capture(x, y, ex, ey) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local full = cv.capture()
 local roi = cv.capture(100, 100, 300, 300)
 cv.release(full)
@@ -142,9 +139,6 @@ function imread(path) end
 **示例：**
 
 ```lua
-local cv = require("cv")
-local file = require("file")
-local image = require("image")
 local a = cv.imread("template.png")
 local dir = file.getInternalDir("documents")
 local b = cv.imread(dir .. "/shot.jpg")
@@ -177,7 +171,6 @@ function imdecode(data) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local m = cv.imread("template.png")
 local b64 = cv.imencode(".png", m)
 local again = cv.imdecode(b64)
@@ -206,8 +199,6 @@ function imwrite(path, mat) end
 **示例：**
 
 ```lua
-local cv = require("cv")
-local file = require("file")
 local src = cv.capture()
 cv.imwrite(file.getInternalDir("documents") .. "/out.png", src)
 cv.release(src)
@@ -236,7 +227,6 @@ function imencode(ext, mat, quality) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local b64 = cv.imencode(".jpg", mat, { quality = 85 })
 ```
 
@@ -260,7 +250,6 @@ function fromImageId(imageId) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local imageId = image.captureScreen()
 local mat = cv.fromImageId(imageId)
 image.release(imageId)
@@ -288,7 +277,6 @@ function Mat(options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local z = cv.zeros({ rows = 100, cols = 100, type = cv.CV_8UC3 })
 local filled = cv.Mat({ rows = 10, cols = 10, type = cv.CV_8UC1, scalar = [255] })
 cv.release(z)
@@ -313,7 +301,6 @@ function clone(mat) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local a = cv.capture()
 local b = cv.clone(a)
 cv.release(a)
@@ -360,7 +347,6 @@ function threshold(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local bin = cv.threshold(gray, { thresh = 127, maxval = 255, type = cv.THRESH_BINARY })
 local otsu = cv.threshold(gray, { type = cv.THRESH_BINARY | cv.THRESH_OTSU })
 ```
@@ -387,7 +373,6 @@ function adaptiveThreshold(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local bin = cv.adaptiveThreshold(gray, {
   maxValue = 255,
   adaptiveMethod = cv.ADAPTIVE_THRESH_GAUSSIAN_C,
@@ -411,7 +396,6 @@ function inRange(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local hsv = cv.cvtColor(src, { code = cv.COLOR_BGR2HSV })
 local mask = cv.inRange(hsv, { lower = [0, 80, 80], upper = [20, 255, 255] })
 ```
@@ -440,7 +424,6 @@ function GaussianBlur(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local g = cv.GaussianBlur(src, { ksize = 5, sigmaX = 1.5 })
 local m = cv.medianBlur(src, { ksize = 5 })
 local b = cv.bilateralFilter(src, { d = 9, sigmaColor = 75, sigmaSpace = 75 })
@@ -467,7 +450,6 @@ function Canny(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local edges = cv.Canny(gray, { threshold1 = 50, threshold2 = 150 })
 local sx = cv.Sobel(gray, { dx = 1, dy = 0, ksize = 3 })
 local histEq = cv.equalizeHist(gray)
@@ -487,7 +469,6 @@ function resize(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local small = cv.resize(src, { width = 360, height = 640 })
 local half = cv.resize(src, { fx = 0.5, fy = 0.5, interpolation = cv.INTER_AREA })
 ```
@@ -508,7 +489,6 @@ function crop(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local roi = cv.crop(src, { x = 10, y = 10, ex = 110, ey = 110 })
 ```
 
@@ -532,7 +512,6 @@ function getRotationMatrix2D(options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local M = cv.getRotationMatrix2D({ center = { x = 100, y = 100 }, angle = 30, scale = 1 })
 local out = cv.warpAffine(src, { M, width = 200, height = 200 })
 cv.release(M)
@@ -555,7 +534,6 @@ function rectangle(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 cv.rectangle(src, {
   pt1 = { x = 10, y = 10 },
   pt2 = { x = 100, y = 80 },
@@ -588,7 +566,6 @@ function fillPoly(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 cv.polylines(src, {
   pts = { { x = 0, y = 0 }, { x = 100, y = 0 }, { x = 100, y = 80 }, { x = 0, y = 80 } },
   isClosed = true,
@@ -622,7 +599,6 @@ function matchTemplate(image, templ, methodOrOptions) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local loc = cv.matchTemplateLoc(src, templ, { method = cv.TM_CCOEFF_NORMED })
 print(string.format("best=(%s,%s) max=%s", loc.x, loc.y, loc.maxVal))
 cv.rectangle(src, {
@@ -655,7 +631,6 @@ function findContours(mat, options) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 local ret = cv.findContours(bin, { mode = cv.RETR_TREE, method = cv.CHAIN_APPROX_SIMPLE })
 print("count=" .. tostring(#ret.contours))
 ```
@@ -671,7 +646,6 @@ function boundingRect(matOrPoints) end
 **示例：**
 
 ```lua
-local cv = require("cv")
 for _, c in ipairs(contours) do
   local area = cv.contourArea(c)
   if (area < 100) continue

package/docs/apilua/paddleocr.md

@@ -1,5 +1,7 @@
 # PaddleOCR 模块 (PaddleOCR)
 
+模块表是内置全局 `paddleocr`，直接调用即可。不要 `require` 宿主模块。
+
 PaddleOCR 模块基于百度飞桨 PaddleOCR 技术，提供强大的光学字符识别（OCR）功能，支持中英文文本识别，可用于屏幕截图、图片文件等多种输入源的文字识别。
 
 ## 功能概览
@@ -77,7 +79,6 @@ function loadModel(modelId, useGpu) end
 **示例:**
 
 ```lua
-local paddleocr = require("paddleocr")
 paddleocr.loadModel("ppocr-v6-tiny", false)
 local loaded = paddleocr.loadModel("ppocr-v6-small", false)
 print("PP-OCRv6 small 加载结果: " .. tostring(loaded))
@@ -108,7 +109,6 @@ function setMaxSideLen(maxSideLen) end
 **示例:**
 
 ```lua
-local paddleocr = require("paddleocr")
 paddleocr.setMaxSideLen(960)
 ```
 
@@ -149,8 +149,6 @@ function recognizeAbs(input, x, y, ex, ey, confidenceThreshold) end
 **示例:**
 
 ```lua
-local paddleocr = require("paddleocr")
-local action = require("action")
 local absResults = paddleocr.recognizeAbs("screen", 100, 100, 500, 300)
 if #absResults > 0 then
   action.click(absResults[1].centerX, absResults[1].centerY)
@@ -196,8 +194,6 @@ function findTextAbs(input, targets, x, y, ex, ey, confidenceThreshold, exactMat
 **示例:**
 
 ```lua
-local paddleocr = require("paddleocr")
-local action = require("action")
 local absHits = paddleocr.findTextAbs("screen", { "确定" }, 100, 100, 500, 400, 0.6, false)
 if #absHits > 0 then
   action.click(absHits[1].centerX, absHits[1].centerY)
@@ -215,7 +211,6 @@ function free() end
 **示例:**
 
 ```lua
-local paddleocr = require("paddleocr")
 
 -- 使用完毕后释放资源
 paddleocr.free()

package/docs/apilua/pip.md

@@ -1,5 +1,7 @@
 # 悬浮窗模块 (PIP)
 
+模块表是内置全局 `pip`，直接调用即可。不要 `require` 宿主模块。
+
 悬浮窗模块提供 iOS 画中画（Picture in Picture）悬浮窗能力，可用于显示脚本日志、保活提示或脚本自定义文本。
 
 ## 功能特性
@@ -31,7 +33,6 @@ function isPipActive() end
 **示例：**
 
 ```lua
-local pip = require("pip")
 local isActive = pip.isPipActive()
 if isActive then
   print("悬浮窗当前已打开")
@@ -56,7 +57,6 @@ function switchToLogMode() end
 **示例：**
 
 ```lua
-local pip = require("pip")
 takeMeToFront()
 local success = pip.switchToLogMode()
 pip.setLogFontSize(10)
@@ -80,7 +80,6 @@ function switchToKeepAliveMode() end
 **示例：**
 
 ```lua
-local pip = require("pip")
 takeMeToFront()
 local success = pip.switchToKeepAliveMode()
 ```
@@ -103,7 +102,6 @@ function switchToCustomMode() end
 **示例：**
 
 ```lua
-local pip = require("pip")
 takeMeToFront()
 pip.switchToCustomMode()
 pip.setCustomText("运行中\n进度 1/3")
@@ -129,7 +127,6 @@ function closeWindow() end
 **示例：**
 
 ```lua
-local pip = require("pip")
 local success = pip.closeWindow()
 ```
 
@@ -160,7 +157,6 @@ function setContentSize(width, height) end
 **示例：**
 
 ```lua
-local pip = require("pip")
 pip.switchToLogMode()
 pip.setContentSize(280, 120)
 
@@ -193,7 +189,6 @@ function setLogFontSize(fontSize) end
 **示例：**
 
 ```lua
-local pip = require("pip")
 pip.setLogFontSize(10)
 pip.switchToLogMode()
 ```
@@ -223,7 +218,6 @@ function setCustomText(text) end
 **示例：**
 
 ```lua
-local pip = require("pip")
 pip.setCustomText("运行中\n进度 1/3")
 pip.switchToCustomMode()
 ```
@@ -253,7 +247,6 @@ function setCustomTextColor(color) end
 **示例：**
 
 ```lua
-local pip = require("pip")
 pip.setCustomTextColor("#34c759")
 pip.switchToCustomMode()
 ```
@@ -283,7 +276,6 @@ function setCustomTextSize(fontSize) end
 **示例：**
 
 ```lua
-local pip = require("pip")
 pip.setCustomTextSize(18)
 pip.switchToCustomMode()
 ```
@@ -313,7 +305,6 @@ function setCustomBackgroundColor(color) end
 **示例：**
 
 ```lua
-local pip = require("pip")
 pip.setCustomBackgroundColor("#111111")
 pip.switchToCustomMode()
 ```
@@ -321,7 +312,6 @@ pip.switchToCustomMode()
 ## 完整使用示例
 
 ```lua
-local pip = require("pip")
 takeMeToFront()
 
 pip.switchToLogMode()