ms-vite-plugin 1.4.57 → 1.4.58

package/docs/AGENTS.md

@@ -13,7 +13,7 @@
 - Lua 项目使用 Lua 文档与写法。
 - 不要混用 JavaScript、Python 与 Lua API。
 - Lua 只提供英文方法，没有中文别名。
-- Lua 模块通过 `require("device")` 加载；`Sleep`、`StartThread` 等是裸全局。
+- Lua 模块通过 `require("device")` 加载；`Sleep`、`StartThread`、`logd` / `logi` / `logw` / `loge` 等是裸全局。
 - 不要把快点JS Python 脚本当成普通 CPython 脚本。
 - 不要对快点JS Python 脚本运行 `python -m py_compile`、`py_compile` 或类似 CPython 编译校验。
 - 不要创建、保留或同步 `__pycache__`、`.pyc` 作为项目改动。

package/docs/SKILL.md

@@ -20,7 +20,7 @@ description: 快点JS专用开发助手。用于快点JS项目开发、本地 AP
 - Lua 项目使用 Lua 文档与写法。
 - 不要混用 JavaScript、Python 与 Lua API。
 - Lua 只提供英文方法，没有中文别名。
-- Lua 模块通过 `require("device")` 加载；`Sleep`、`StartThread` 等是裸全局。
+- Lua 模块通过 `require("device")` 加载；`Sleep`、`StartThread`、`logd` / `logi` / `logw` / `loge` 等是裸全局。
 - Lua 用户模块请用 `require("foo")` / `require("lib.bar")`。Release 打包默认会把 `scripts` 下除 `main.lua` 外的用户 `.lua` 合并进单个 `main.lua`；不要用 `dofile` / `loadfile` 按路径加载这些文件。
 - 文档未确认的能力必须明确说明无法确认，并给出保守方案。
 - 快点JS Python 脚本不使用 CPython 编译校验；不要运行 `python -m py_compile`、`py_compile` 或类似命令。

package/docs/apilua/global.md

@@ -18,6 +18,7 @@
 - **时间工具**: 获取时间戳
 - **应用控制**: 切换应用到前台
 - **Agent 设置**: 读取和设置 Agent 触控模式
+- **日志输出**: 全局 `logd` / `logi` / `logw` / `loge`，等同 `logger` 对应方法
 
 ## 全局常量
 
@@ -652,3 +653,97 @@ function ToJsonString(data) end
 print(ToJsonString({ a = 1, b = 2 }))
 ```
 
+## 全局日志函数
+
+全局日志函数是 `logger` 模块对应方法的便捷别名，可以直接调用而无需 `require("logger")`。可变参会按空格拼接为一行。级别和是否写文件仍由 `logger.setLoggerLevel` / `logger.setLogToFile` 控制。
+
+`print` 仍可用，默认走信息级别；需要调试 / 警告 / 错误级别时用下面这些函数。
+
+### logd
+
+输出调试级别的日志，等同于 `logger.debug(...)`。
+
+```lua
+---@param ... any
+function logd(...) end
+```
+
+**参数:**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述             |
+| ------ | ---- | -------- | ------ | ---------------- |
+| `...`  | any  | 是       | -      | 要输出的日志内容 |
+
+**示例:**
+
+```lua
+logd("程序开始执行")
+logd("当前用户:", username)
+```
+
+### logi
+
+输出信息级别的日志，等同于 `logger.info(...)`。
+
+```lua
+---@param ... any
+function logi(...) end
+```
+
+**参数:**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述             |
+| ------ | ---- | -------- | ------ | ---------------- |
+| `...`  | any  | 是       | -      | 要输出的日志内容 |
+
+**示例:**
+
+```lua
+logi("应用程序启动成功")
+logi("处理了", count, "条记录")
+```
+
+### logw
+
+输出警告级别的日志，等同于 `logger.warn(...)`。
+
+```lua
+---@param ... any
+function logw(...) end
+```
+
+**参数:**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述             |
+| ------ | ---- | -------- | ------ | ---------------- |
+| `...`  | any  | 是       | -      | 要输出的日志内容 |
+
+**示例:**
+
+```lua
+logw("电池电量低于 20%")
+logw("网络连接不稳定")
+```
+
+### loge
+
+输出错误级别的日志，等同于 `logger.error(...)`。
+
+```lua
+---@param ... any
+function loge(...) end
+```
+
+**参数:**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述             |
+| ------ | ---- | -------- | ------ | ---------------- |
+| `...`  | any  | 是       | -      | 要输出的日志内容 |
+
+**示例:**
+
+```lua
+loge("网络请求失败")
+loge("文件读取错误")
+```
+

package/docs/apilua/logger.md

@@ -14,6 +14,8 @@
 
 - **关闭存储日志** 可使用 `setLogToFile(false)` 关闭将日志输出到文件的功能。
 
+- **全局别名** `logd` / `logi` / `logw` / `loge` 是裸全局，分别等同 `logger.debug` / `logger.info` / `logger.warn` / `logger.error`，无需 `require("logger")`。
+
 ## 日志级别
 
 日志模块支持以下级别（按严重程度排序）：

package/package.json

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