ms-vite-plugin 1.4.59 → 1.4.60

package/docs/apilua/system.md

@@ -1,5 +1,7 @@
 # 系统模块 (System)
 
+模块表是内置全局 `system`，直接调用即可。不要 `require` 宿主模块。
+
 系统模块提供了与操作系统交互的核心功能，包括应用管理、锁屏控制、剪贴板操作、URL 打开和系统通知等功能。
 
 ## 功能概览
@@ -50,7 +52,6 @@ function startApp(bundleId) end
 **示例:**
 
 ```lua
-local system = require("system")
 -- 启动应用
 local started = system.startApp("com.example.app")
 if started then
@@ -81,7 +82,6 @@ function stopApp(bundleId) end
 **示例:**
 
 ```lua
-local system = require("system")
 local stopped = system.stopApp("com.example.app")
 if stopped then
   print("应用关闭成功")
@@ -113,7 +113,6 @@ function activateApp(bundleId) end
 **示例:**
 
 ```lua
-local system = require("system")
 local activated = system.activateApp("com.apple.Safari")
 if activated then
   print("Safari 已激活")
@@ -138,7 +137,6 @@ function activateAppInfo() end
 **示例:**
 
 ```lua
-local system = require("system")
 local appInfo = system.activateAppInfo()
 if appInfo then
   print("当前前台应用: " .. tostring(appInfo.name))
@@ -159,7 +157,6 @@ function backgroundAppInfos() end
 **示例:**
 
 ```lua
-local system = require("system")
 local apps = system.backgroundAppInfos()
 if #apps > 0 then
   print(apps[1].name)
@@ -176,7 +173,6 @@ function getInstalledAppList() end
 **示例:**
 
 ```lua
-local system = require("system")
 local apps = system.getInstalledAppList()
 if #apps > 0 then
   print(apps[1].appName)
@@ -193,7 +189,6 @@ function recent() end
 **示例:**
 
 ```lua
-local system = require("system")
 local opened = system.recent()
 if opened then
   print("打开成功")
@@ -222,7 +217,6 @@ function isLocked() end
 **示例:**
 
 ```lua
-local system = require("system")
 if system.isLocked() then
   print("系统已锁屏")
 else
@@ -246,7 +240,6 @@ function lock() end
 **示例:**
 
 ```lua
-local system = require("system")
 local locked = system.lock()
 if locked then
   print("系统已锁屏")
@@ -271,7 +264,6 @@ function unlock() end
 **示例:**
 
 ```lua
-local system = require("system")
 local unlocked = system.unlock()
 if unlocked then
   print("系统已解锁")
@@ -305,7 +297,6 @@ function setClipboard(text) end
 **示例:**
 
 ```lua
-local system = require("system")
 local set = system.setClipboard("Hello, World!")
 if set then
   print("剪贴板内容已设置")
@@ -330,7 +321,6 @@ function getClipboard() end
 **示例:**
 
 ```lua
-local system = require("system")
 local clipboardText = system.getClipboard()
 if clipboardText then
   print("剪贴板内容: " .. tostring(clipboardText))
@@ -368,7 +358,6 @@ function openURL(url) end
 **示例:**
 
 ```lua
-local system = require("system")
 -- 打开网页
 local webOpened = system.openURL("https://www.apple.com")
 if webOpened then
@@ -408,7 +397,6 @@ function notify(msg, title, id) end
 **示例:**
 
 ```lua
-local system = require("system")
 -- 发送基础通知
 system.notify("任务已完成", "提醒", "task_complete")
 -- 发送进度通知（会覆盖之前的通知）
@@ -442,7 +430,6 @@ function getMemoryInfo() end
 **示例:**
 
 ```lua
-local system = require("system")
 local memInfo = system.getMemoryInfo()
 print("应用占用: " .. tostring(memInfo.used) .. "MB")
 print("系统内存: " .. tostring(memInfo.systemUsed) .. "/" .. tostring(memInfo.total) .. "MB")
@@ -473,7 +460,6 @@ function getUsedMemory() end
 **示例:**
 
 ```lua
-local system = require("system")
 -- 获取已使用内存
 local usedMemory = system.getUsedMemory()
 print("已使用内存: " .. tostring(usedMemory) .. "MB")
@@ -503,7 +489,6 @@ function getAvailableMemory() end
 **示例:**
 
 ```lua
-local system = require("system")
 -- 获取可用内存
 local availableMemory = system.getAvailableMemory()
 print("可用内存: " .. tostring(availableMemory) .. "MB")
@@ -533,7 +518,6 @@ function getTotalMemory() end
 **示例:**
 
 ```lua
-local system = require("system")
 -- 获取系统总内存
 local totalMemory = system.getTotalMemory()
 print("系统总内存: " .. tostring(totalMemory) .. "MB")
@@ -556,7 +540,6 @@ function getSystemUsedMemory() end
 **示例:**
 
 ```lua
-local system = require("system")
 print(system.getSystemUsedMemory())
 ```
 
@@ -570,7 +553,6 @@ function getCpuUsage() end
 **示例:**
 
 ```lua
-local system = require("system")
 print(system.getCpuUsage())
 ```
 
@@ -602,7 +584,6 @@ function startAgent() end
 **示例:**
 
 ```lua
-local system = require("system")
 -- 启动 Agent 服务
 local started = system.startAgent()
 if started then
@@ -632,7 +613,6 @@ function getAgentStatus() end
 **示例:**
 
 ```lua
-local system = require("system")
 -- 检查 快点 Agent 服务状态
 local isRunning = system.getAgentStatus()
 if isRunning then
@@ -661,7 +641,6 @@ function stopAgent() end
 **示例:**
 
 ```lua
-local system = require("system")
 local stopped = system.stopAgent()
 if stopped then
   print("已停止 Agent")

package/docs/apilua/tomatoocr.md

@@ -1,5 +1,7 @@
 # TomatoOCR 模块
 
+模块表是内置全局 `tomatoocr`，直接调用即可。不要 `require` 宿主模块。
+
 TomatoOCR 模块提供基于 TomatoOCR 框架的文字识别和 YOLO 目标检测功能，支持多种识别模式和配置选项。
 
 该 ocr 为付费插件, 具体资费请联系https://www.52tomato.com, 如果购买请选择插件版-快点 JS-IOS
@@ -50,7 +52,6 @@ function initializeWithConfig(mode, licenseData, remark) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 -- 不带备注
 local result1 = tomatoocr.initializeWithConfig(
   "online",
@@ -85,7 +86,6 @@ function setHttpIntervalTime(second) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.setHttpIntervalTime(3600)
 ```
 
@@ -107,7 +107,6 @@ function setRecType(recType) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 -- 普通中英文识别，3.0版模型
 tomatoocr.setRecType("ch-3.0")
 -- 普通中英文识别，2.0版模型
@@ -142,7 +141,6 @@ function setDetBoxType(detBoxType) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 -- 矩形文本
 tomatoocr.setDetBoxType("rect")
 -- 倾斜文本
@@ -167,7 +165,6 @@ function setDetScaleRatio(detScaleRatio) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.setDetScaleRatio(0.5)
 ```
 
@@ -189,7 +186,6 @@ function setDetUnclipRatio(detUnclipRatio) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.setDetUnclipRatio(1.9)
 ```
 
@@ -211,7 +207,6 @@ function setRecScoreThreshold(recScoreThreshold) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.setRecScoreThreshold(0.1)
 ```
 
@@ -233,7 +228,6 @@ function setReturnType(returnType) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.setReturnType("json")
 ```
 
@@ -255,7 +249,6 @@ function setBinaryThresh(binaryThresh) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.setBinaryThresh(0)
 ```
 
@@ -277,7 +270,6 @@ function setRunMode(runMode) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.setRunMode("fast")
 ```
 
@@ -301,7 +293,6 @@ function setFilterColor(filterColor, backgroundColor) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.setFilterColor("#41917A,38,38", "black")
 tomatoocr.setFilterColor("#41917A,38,38|#E091A8,50,50", "white")
 ```
@@ -343,7 +334,6 @@ function ocrImage(input, type, x, y, ex, ey) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 -- 识别屏幕
 local result1 = tomatoocr.ocrImage("screen", 0, 0, 0, 0, 0)
 print("识别屏幕结果：" .. tostring(result1))
@@ -382,7 +372,6 @@ function findTapPoint(data) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 local result = tomatoocr.findTapPoint(“确定”)
 print(result)
 ```
@@ -412,7 +401,6 @@ function findTapPoints(data) end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 local result = tomatoocr.findTapPoints(“确定”)
 print(result)
 ```
@@ -428,14 +416,12 @@ function release() end
 **示例:**
 
 ```lua
-local tomatoocr = require("tomatoocr")
 tomatoocr.release()
 ```
 
 ## 完整示例
 
 ```lua
-local tomatoocr = require("tomatoocr")
 -- 初始化 TomatoOCR 并设置基本配置
 local initResult = tomatoocr.initializeWithConfig(
   "online",

package/docs/apilua/tts.md

@@ -1,5 +1,7 @@
 # TTS 模块 (Text-to-Speech)
 
+模块表是内置全局 `tts`，直接调用即可。不要 `require` 宿主模块。
+
 TTS（文本转语音）模块提供了语音合成、播放控制等功能，支持多种语言和语音设置。
 
 ## 接口定义
@@ -58,7 +60,6 @@ function speak(text, rate, pitch, volume, language) end
 **示例：**
 
 ```lua
-local tts = require("tts")
 -- 使用简化参数播放中文文本
 tts.speak("欢迎使用 TTS 功能")
 -- 使用完整参数播放中文语音
@@ -90,7 +91,6 @@ function waitEnd() end
 **示例：**
 
 ```lua
-local tts = require("tts")
 -- 播放一段文本
 tts.speak("这是一段需要等待播放完成的文本")
 -- 等待播放完成
@@ -110,7 +110,6 @@ function stop() end
 **示例：**
 
 ```lua
-local tts = require("tts")
 -- 开始播放
 tts.speak("这是一段很长的文本内容...")
 -- 在某个条件下停止播放
@@ -138,7 +137,6 @@ function isSpeaking() end
 **示例：**
 
 ```lua
-local tts = require("tts")
 -- 检查播放状态
 if tts.isSpeaking() then
   print("正在播放语音")
@@ -172,7 +170,6 @@ function getAvailableVoices() end
 **示例：**
 
 ```lua
-local tts = require("tts")
 -- 获取并显示所有可用语音
 local voices = tts.getAvailableVoices()
 print("找到 " .. tostring(#voices) .. " 个可用语音：")
@@ -217,7 +214,6 @@ function setVoice(voiceIdentifier) end
 **示例：**
 
 ```lua
-local tts = require("tts")
 -- 获取可用语音并设置第一个中文语音
 local voices = tts.getAvailableVoices()
 local chineseVoice = voices.find((voice) => voice.language.startsWith("zh"))
@@ -258,7 +254,6 @@ function free() end
 **示例：**
 
 ```lua
-local tts = require("tts")
 tts.free()
 ```
 
@@ -267,7 +262,6 @@ tts.free()
 ### 语音提醒功能
 
 ```lua
-local tts = require("tts")
 local function voiceAlert(message, urgent)
   if urgent then
 -- 紧急提醒：快速、高音调
@@ -285,7 +279,6 @@ voiceAlert("发现错误，请立即处理", true)
 ### 多语言播报
 
 ```lua
-local tts = require("tts")
 local function speakInLanguage(text, language)
 -- 根据语言选择合适的语音
   local voices = tts.getAvailableVoices()

package/docs/apilua/ui.md

@@ -1,5 +1,7 @@
 # UI 模块 (UI)
 
+模块表是内置全局 `ui`，直接调用即可。不要 `require` 宿主模块。
+
 UI 模块提供了 WebView 相关功能，支持事件通信和 JavaScript 交互。该模块使用共享的 WebView 实例，通过静态方法进行操作。
 
 ## UI 设计器
@@ -9,7 +11,7 @@ UI 模块提供了 WebView 相关功能，支持事件通信和 JavaScript 交
 ## 注意事项
 
 - UI 相关方法仅 app 在前台可用
-- Lua 脚本 API 用 `require("ui")`；网页里的 `ms.*` 是 JavaScript
+- Lua 脚本 API 用全局 `ui`；网页里的 `ms.*` 是 JavaScript
 
 ## 配置
 
@@ -81,7 +83,6 @@ function show() end
 **示例：**
 
 ```lua
-local ui = require("ui")
 ui.show()
 ```
 
@@ -101,7 +102,6 @@ function eval(code) end
 **示例：**
 
 ```lua
-local ui = require("ui")
 ui.eval("document.title = 'KuaiJS'")
 ```
 
@@ -124,7 +124,6 @@ function onEvent(onEvent) end
 **示例：**
 
 ```lua
-local ui = require("ui")
 -- 设置事件回调
 ui.onEvent(function(event, data)
   print("收到事件: " .. tostring(event) .. ", 数据: " .. tostring(ToJsonString(data)))
@@ -149,7 +148,6 @@ function call(key, data) end
 **示例：**
 
 ```lua
-local ui = require("ui")
 -- 调用网页中的方法
 ui.call("updateStatus", { status = "running", progress = 50 })
 ui.call("loadData", {
@@ -174,7 +172,6 @@ function showToast(message) end
 **示例：**
 
 ```lua
-local ui = require("ui")
 -- 显示成功提示
 ui.showToast("操作成功")
 -- 显示错误提示
@@ -208,7 +205,6 @@ function confirm(title, message) end
 **示例：**
 
 ```lua
-local ui = require("ui")
 -- 显示确认对话框
 local result = ui.confirm("确认删除", "是否确定要删除这个文件？")
 if result then
@@ -250,7 +246,6 @@ function confirmInput(title, message) end
 **示例：**
 
 ```lua
-local ui = require("ui")
 -- 获取用户输入
 local username = ui.confirmInput("用户登录", "请输入您的用户名：")
 if username then
@@ -285,7 +280,6 @@ function alert(title, message) end
 **示例：**
 
 ```lua
-local ui = require("ui")
 -- 显示错误警告
 ui.alert("错误", "网络连接失败，请检查网络设置")
 -- 显示重要提示

package/docs/apilua/utils.md

@@ -1,5 +1,7 @@
 # 工具模块 (Utils)
 
+模块表是内置全局 `utils`，直接调用即可。不要 `require` 宿主模块。
+
 工具模块提供了一系列实用的工具函数，包括时间格式化、随机数生成、应用前台切换等常用功能。
 
 ## 功能概览
@@ -36,7 +38,6 @@ function timeFormat(format) end
 **示例:**
 
 ```lua
-local utils = require("utils")
 
 -- 标准日期时间格式
 local dateTime = utils.timeFormat("yyyy-MM-dd HH:mm:ss")
@@ -86,7 +87,6 @@ function random(min, max) end
 **示例:**
 
 ```lua
-local utils = require("utils")
 
 -- 生成1-10之间的随机数
 local randomNum = utils.random(1, 10)
@@ -123,7 +123,6 @@ function takeMeToFront() end
 **示例:**
 
 ```lua
-local utils = require("utils")
 
 -- 将应用切换到前台
 utils.takeMeToFront()
@@ -142,7 +141,6 @@ function randomUUID() end
 **示例:**
 
 ```lua
-local utils = require("utils")
 print(utils.randomUUID())
 ```
 
@@ -157,7 +155,6 @@ function hexString(source) end
 **示例:**
 
 ```lua
-local utils = require("utils")
 print(utils.hexString("hello"))
 ```
 
@@ -172,7 +169,6 @@ function base64Encoded(source) end
 **示例:**
 
 ```lua
-local utils = require("utils")
 print(utils.base64Encoded("hello"))
 ```
 
@@ -187,7 +183,6 @@ function base64Decoded(source) end
 **示例:**
 
 ```lua
-local utils = require("utils")
 print(utils.base64Decoded("aGVsbG8="))
 ```
 
@@ -202,7 +197,6 @@ function hexStringBase64Encoded(hexString) end
 **示例:**
 
 ```lua
-local utils = require("utils")
 print(utils.hexStringBase64Encoded("68656c6c6f"))
 ```
 
@@ -217,6 +211,5 @@ function hexStringBase64Decoded(base64HexString) end
 **示例:**
 
 ```lua
-local utils = require("utils")
 print(utils.hexStringBase64Decoded("aGVsbG8="))
 ```

package/docs/apilua/yolo.md

@@ -1,5 +1,7 @@
 # YOLO 目标检测模块 (YOLO)
 
+模块表是内置全局 `yolo`，直接调用即可。不要 `require` 宿主模块。
+
 YOLO 模块基于 YOLOV8/YOLO11/YOLO26 算法和 NCNN 框架，提供高性能的实时目标检测功能，支持多种输入源和自定义模型，可用于物体识别、位置定位等应用场景。
 
 ## 数据标注
@@ -91,7 +93,6 @@ function load(paramPath, binPath, nc, version, useGpu) end
 **示例:**
 
 ```lua
-local yolo = require("yolo")
 local modelId = yolo.load(
   "yolov8n_ncnn_model/model.ncnn.param",
   "yolov8n_ncnn_model/model.ncnn.bin",
@@ -144,7 +145,6 @@ function detectAbs(modelId, img, x, y, ex, ey, targetSize, threshold, nmsThresho
 **示例:**
 
 ```lua
-local yolo = require("yolo")
 
 -- 首先加载模型
 local modelId = yolo.load(
@@ -206,7 +206,6 @@ function free(modelId) end
 **示例:**
 
 ```lua
-local yolo = require("yolo")
 
 -- 释放特定模型
 if modelId then
@@ -224,7 +223,6 @@ function freeAll() end
 **示例:**
 
 ```lua
-local yolo = require("yolo")
 
 -- 释放所有模型资源
 yolo.freeAll()

package/docs/apilua/yolocls.md

@@ -1,5 +1,7 @@
 # YOLO 图像分类模块 (YoloCls)
 
+模块表是内置全局 `yolocls`，直接调用即可。不要 `require` 宿主模块。
+
 YOLO 图像分类模块基于 YOLOv8-cls / YOLO11-cls / YOLO26-cls 分类模型和 NCNN 框架，提供整图分类、区域分类和模型资源管理能力。
 
 ## 功能概览
@@ -82,7 +84,6 @@ function load(paramPath, binPath, nc, useGpu) end
 **示例:**
 
 ```lua
-local yolocls = require("yolocls")
 -- 模型文件通常放在 res 目录
 local modelId = yolocls.load(
   "yolo11n_cls_ncnn_model/model.ncnn.param",
@@ -129,7 +130,6 @@ function classify(modelId, img, targetSize) end
 **示例:**
 
 ```lua
-local yolocls = require("yolocls")
 local modelId = yolocls.load(
   "yolo11n_cls_ncnn_model/model.ncnn.param",
   "yolo11n_cls_ncnn_model/model.ncnn.bin",
@@ -206,7 +206,6 @@ function classifyRegion(modelId, img, x, y, ex, ey, targetSize) end
 **示例:**
 
 ```lua
-local yolocls = require("yolocls")
 local regionProbs = yolocls.classifyRegion(
   modelId,
   "screen",
@@ -244,7 +243,6 @@ function free(modelId) end
 **示例:**
 
 ```lua
-local yolocls = require("yolocls")
 if modelId then
   yolocls.free(modelId)
   print("YOLO 分类模型 " .. tostring(modelId) .. " 资源已释放")
@@ -262,7 +260,6 @@ function freeAll() end
 **示例:**
 
 ```lua
-local yolocls = require("yolocls")
 yolocls.freeAll()
 print("所有 YOLO 分类模型资源已释放")
 ```

package/docs/mcp-agent-description.md

@@ -15,7 +15,7 @@
 - 不要把快点JS Python 脚本当成普通 CPython 脚本。
 - 不要对快点JS Python 脚本运行 `python -m py_compile`、`py_compile` 或类似 CPython 编译校验。
 - 不要创建、保留或同步 `__pycache__`、`.pyc` 作为项目改动。
-- Lua 用户模块请用 `require("foo")` / `require("lib.bar")`。Release 打包默认会把 `scripts` 下除 `main.lua` 外的用户 `.lua` 合并进单个 `main.lua`；不要用 `dofile` / `loadfile` 按路径加载这些文件。
+- Lua 宿主模块是内置全局表（如 `device`），不要 `require`。用户模块请用 `require("foo")` / `require("lib.bar")`。Release 打包默认会把 `scripts` 下除 `main.lua` 外的用户 `.lua` 合并进单个 `main.lua`；不要用 `dofile` / `loadfile` 按路径加载这些文件。
 - 文档未确认的能力必须明确说明无法确认，不要凭经验补全。
 
 ## 允许的执行方式

package/docs/quick/vscode/createProject.md

@@ -17,7 +17,7 @@
 - 选择一个文件目录，输入项目名称，回车创建项目
 - 快点 JS-JS 引擎使用 `ES6` 语法，支持 import 别的 js 文件
 - 快点 JS-Python 引擎使用 `Python3.14`, 打包需要安装 `Python3.14`
-- 快点 JS-Lua 引擎入口为 `scripts/main.lua`，模块通过 `require("device")` 加载，全局函数如 `Sleep` 可直接调用
+- 快点 JS-Lua 引擎入口为 `scripts/main.lua`，宿主模块是内置全局表（如 `device`），不要 `require`；全局函数如 `Sleep` 可直接调用
 - 项目创建完成后，会自动打开项目，项目结构如下：
 
 ### 项目结构

package/docs/quick/vscode/packProject.md

@@ -11,7 +11,7 @@
 - 输入在开发者后台->网络验证管理->软件列表 中获取的 `AppId` 字段
 - JS / Lua 项目可编辑根目录 `obfuscator.json` 决定打包行为；Python 打包编译为 `.pyc`，没有该配置
 - JS：Vite 把入口打成单文件后再按 `enabled` 混淆
-- Lua：Release 默认把 `scripts` 下用户模块合并为单个 `scripts/main.lua`（`bundle`，缺省 `true`），再按 `enabled` / `preset` 用 Prometheus 混淆该文件。`enabled: false` 时仍可合并。宿主 `require("device")` 等不受影响。不要用 `dofile` / `loadfile` 去读会被删掉的其它 `.lua`
+- Lua：Release 默认把 `scripts` 下用户模块合并为单个 `scripts/main.lua`（`bundle`，缺省 `true`），再按 `enabled` / `preset` 用 Prometheus 混淆该文件。`enabled: false` 时仍可合并。宿主全局模块（如 `device`）不受影响。不要用 `dofile` / `loadfile` 去读会被删掉的其它 `.lua`
 - 注意：上传到快点JS热更新服务后，可通过开发者后台->网络验证管理->软件列表的软件编号进行分发
 - 注意：快点JS上可通过软件面板，输入软件编号进行搜索加载应用
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.4.59",
+  "version": "1.4.60",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {