ms-vite-plugin 1.4.57 → 1.4.59

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/api/media.md

@@ -245,3 +245,25 @@ if (played) {
   logi("播放失败或被系统音频中断");
 }
 ```
+
+#### isMp3Playing - 当前是否正在播放 MP3。
+
+```typescript
+function isMp3Playing(): boolean;
+```
+
+**返回值:**
+
+| 类型      | 描述                             |
+| --------- | -------------------------------- |
+| `boolean` | 正在播放返回 `true`，否则 `false` |
+
+**示例:**
+
+```javascript
+if (media.isMp3Playing()) {
+  logi("正在播放");
+} else {
+  logi("未播放");
+}
+```

package/docs/apicn/media.md

@@ -249,3 +249,25 @@ if (是否播放成功) {
   $打印错误日志("播放失败或被系统音频中断");
 }
 ```
+
+#### 查询MP3音乐是否正在播放 - 当前是否正在播放 MP3。
+
+```typescript
+function 查询MP3音乐是否正在播放(): 布尔值;
+```
+
+**返回值:**
+
+| 类型     | 描述                               |
+| -------- | ---------------------------------- |
+| `布尔值` | 正在播放返回 `true`，否则 `false` |
+
+**示例:**
+
+```javascript
+if ($媒体.查询MP3音乐是否正在播放()) {
+  $打印信息日志("正在播放");
+} else {
+  $打印信息日志("未播放");
+}
+```

package/docs/apilua/appleocr.md

@@ -59,9 +59,10 @@ AppleOCR 模块基于 Apple Vision 框架，提供原生的光学字符识别（
 
 ### 文字识别
 
-#### recognize - 执行 OCR 识别。
+#### recognizeAbs - 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
 
-执行 OCR 识别。传入裁剪区域时，返回坐标相对于裁剪区域。全屏识别时 `x/y/ex/ey` 传 `0`。
+执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
 
 ```lua
 ---@param input string
@@ -71,7 +72,7 @@ AppleOCR 模块基于 Apple Vision 框架，提供原生的光学字符识别（
 ---@param ey number?
 ---@param languages string[]?
 ---@return OCRResult[]
-function recognize(input, x, y, ex, ey, languages) end
+function recognizeAbs(input, x, y, ex, ey, languages) end
 ```
 
 **参数:**
@@ -87,38 +88,9 @@ function recognize(input, x, y, ex, ey, languages) end
 
 **返回值:**
 
-| 类型          | 描述                                           |
-| ------------- | ---------------------------------------------- |
-| `OCRResult[]` | 识别结果数组，坐标相对于裁剪区域               |
-
-**示例:**
-
-```lua
-local appleocr = require("appleocr")
-local action = require("action")
-
-local results = appleocr.recognize("screen", 100, 100, 500, 300)
-if #results > 0 then
-  action.click(results[1].centerX, results[1].centerY)
-end
-```
-
-#### recognizeAbs - 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
-
-传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
-
-```lua
----@param input string
----@param x number?
----@param y number?
----@param ex number?
----@param ey number?
----@param languages string[]?
----@return OCRResult[]
-function recognizeAbs(input, x, y, ex, ey, languages) end
-```
-
-**参数:** 与 `recognize` 相同；返回坐标为原图或全屏绝对坐标。
+| 类型          | 描述                                   |
+| ------------- | -------------------------------------- |
+| `OCRResult[]` | 识别结果数组，坐标为原图或全屏绝对坐标 |
 
 **示例:**
 
@@ -133,9 +105,10 @@ end
 
 ### 数字识别
 
-#### recognizeNumbers - 执行数字 OCR 识别。
+#### recognizeNumbersAbs - 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
 
-执行数字 OCR 识别。传入裁剪区域时，返回坐标相对于裁剪区域。
+执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
 
 **支持字符**: 0-9 数字、逗号(,)、小数点(.)、加号(+)、减号(-)
 
@@ -146,69 +119,46 @@ end
 ---@param ex number?
 ---@param ey number?
 ---@return OCRResult[]
-function recognizeNumbers(input, x, y, ex, ey) end
+function recognizeNumbersAbs(input, x, y, ex, ey) end
 ```
 
 **参数:**
 
-| 参数名  | 类型   | 是否必填 | 默认值 | 描述                                                |
-| ------- | ------ | -------- | ------ | --------------------------------------------------- |
+| 参数名  | 类型   | 是否必填 | 默认值 | 描述                                                        |
+| ------- | ------ | -------- | ------ | ----------------------------------------------------------- |
 | `input` | string | 是       |        | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId |
-| `x`     | number | 否       | 0      | 裁剪区域左上角 x 坐标；全屏识别传 0                 |
-| `y`     | number | 否       | 0      | 裁剪区域左上角 y 坐标；全屏识别传 0                 |
-| `ex`    | number | 否       | 0      | 裁剪区域右下角 x 坐标；全屏识别传 0                 |
-| `ey`    | number | 否       | 0      | 裁剪区域右下角 y 坐标；全屏识别传 0                 |
+| `x`     | number | 否       | 0      | 裁剪区域左上角 x 坐标；全屏识别传 0                         |
+| `y`     | number | 否       | 0      | 裁剪区域左上角 y 坐标；全屏识别传 0                         |
+| `ex`    | number | 否       | 0      | 裁剪区域右下角 x 坐标；全屏识别传 0                         |
+| `ey`    | number | 否       | 0      | 裁剪区域右下角 y 坐标；全屏识别传 0                         |
 
 **返回值:**
 
 | 类型          | 描述                                           |
 | ------------- | ---------------------------------------------- |
-| `OCRResult[]` | 数字识别结果数组，坐标相对于裁剪区域           |
+| `OCRResult[]` | 数字识别结果数组，坐标为原图或全屏绝对坐标     |
 
 **示例:**
 
 ```lua
 local appleocr = require("appleocr")
 local action = require("action")
-
-local numberResults = appleocr.recognizeNumbers("screen", 100, 100, 500, 300)
-if #numberResults > 0 then
-  action.click(numberResults[1].centerX, numberResults[1].centerY)
-end
-```
-
-#### recognizeNumbersAbs - 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
-
-**支持字符**: 0-9 数字、逗号(,)、小数点(.)、加号(+)、减号(-)
-
-```lua
----@param input string
----@param x number?
----@param y number?
----@param ex number?
----@param ey number?
----@return OCRResult[]
-function recognizeNumbersAbs(input, x, y, ex, ey) end
-```
-
-**参数:** 与 `recognizeNumbers` 相同；返回坐标为原图或全屏绝对坐标。
-
-**示例:**
-
-```lua
-local appleocr = require("appleocr")
 local absNumberResults = appleocr.recognizeNumbersAbs("screen", 100, 100, 500, 300)
+if #absNumberResults > 0 then
+  action.click(absNumberResults[1].centerX, absNumberResults[1].centerY)
+end
 ```
 
 ### 文本查找
 
-#### findText - 查找目标子串。
+#### findTextAbs - 查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
 
-在整段识别文本中查找指定子串。传入裁剪区域时，返回坐标相对于裁剪区域。
+查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。`texts` 也可以是逗号分隔字符串。
 
 ```lua
 ---@param input string
----@param texts string[]
+---@param texts string[]|string
 ---@param x number?
 ---@param y number?
 ---@param ex number?
@@ -216,58 +166,27 @@ local absNumberResults = appleocr.recognizeNumbersAbs("screen", 100, 100, 500, 3
 ---@param languages string[]?
 ---@param exactMatch boolean?
 ---@return OCRResult[]
-function findText(input, texts, x, y, ex, ey, languages, exactMatch) end
+function findTextAbs(input, texts, x, y, ex, ey, languages, exactMatch) end
 ```
 
 **参数:**
 
-| 参数名       | 类型     | 是否必填 | 默认值                  | 描述                                                                                                  |
-| ------------ | -------- | -------- | ----------------------- | ----------------------------------------------------------------------------------------------------- |
-| `input`      | string   | 是       |                         | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId                                           |
-| `texts`      | string[] | 是       |                         | 要查找的目标文本数组，可匹配识别结果中的子串                                                          |
-| `x`          | number   | 否       | 0                       | 裁剪区域左上角 x 坐标；全屏识别传 0                                                                   |
-| `y`          | number   | 否       | 0                       | 裁剪区域左上角 y 坐标；全屏识别传 0                                                                   |
-| `ex`         | number   | 否       | 0                       | 裁剪区域右下角 x 坐标；全屏识别传 0                                                                   |
-| `ey`         | number   | 否       | 0                       | 裁剪区域右下角 y 坐标；全屏识别传 0                                                                   |
-| `languages`  | string[] | 否       | `{"zh-Hans", "en-US"}` | 识别语言数组                                                                                          |
-| `exactMatch` | boolean  | 否       | false                   | 是否完整匹配；`false` 表示包含匹配，`true` 要求整条 OCR 识别结果文本等于目标文本                       |
+| 参数名       | 类型               | 是否必填 | 默认值                  | 描述                                                                                                  |
+| ------------ | ------------------ | -------- | ----------------------- | ----------------------------------------------------------------------------------------------------- |
+| `input`      | string             | 是       |                         | 输入源，支持 `"screen"`、图片文件路径、URL 字符串或 imageId                                           |
+| `texts`      | string[] \| string | 是       |                         | 要查找的目标文本数组，可匹配识别结果中的子串；也可以是逗号分隔字符串                                  |
+| `x`          | number             | 否       | 0                       | 裁剪区域左上角 x 坐标；全屏识别传 0                                                                   |
+| `y`          | number             | 否       | 0                       | 裁剪区域左上角 y 坐标；全屏识别传 0                                                                   |
+| `ex`         | number             | 否       | 0                       | 裁剪区域右下角 x 坐标；全屏识别传 0                                                                   |
+| `ey`         | number             | 否       | 0                       | 裁剪区域右下角 y 坐标；全屏识别传 0                                                                   |
+| `languages`  | string[]           | 否       | `{"zh-Hans", "en-US"}` | 识别语言数组                                                                                          |
+| `exactMatch` | boolean            | 否       | false                   | 是否完整匹配；`false` 表示包含匹配，`true` 要求整条 OCR 识别结果文本等于目标文本                       |
 
 **返回值:**
 
-| 类型          | 描述                                           |
-| ------------- | ---------------------------------------------- |
-| `OCRResult[]` | 命中子串的识别结果数组，坐标相对于裁剪区域     |
-
-**示例:**
-
-```lua
-local appleocr = require("appleocr")
-local action = require("action")
-
-local hits = appleocr.findText("screen", { "开始" }, 100, 100, 500, 400)
-if #hits > 0 then
-  action.click(hits[1].centerX, hits[1].centerY)
-end
-```
-
-#### findTextAbs - 查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
-
-传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。`texts` 也可以是逗号分隔字符串。
-
-```lua
----@param input string
----@param texts string[]|string
----@param x number?
----@param y number?
----@param ex number?
----@param ey number?
----@param languages string[]?
----@param exactMatch boolean?
----@return OCRResult[]
-function findTextAbs(input, texts, x, y, ex, ey, languages, exactMatch) end
-```
-
-**参数:** 与 `findText` 相同；返回坐标为原图或全屏绝对坐标。
+| 类型          | 描述                                               |
+| ------------- | -------------------------------------------------- |
+| `OCRResult[]` | 命中子串的识别结果数组，坐标为原图或全屏绝对坐标   |
 
 **示例:**
 

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/image.md

@@ -18,8 +18,6 @@
 
 ### captureScreen - 截取屏幕。
 
-坐标缺省 `0` 表示全屏。四个坐标都传 `0` 时与 `captureFullScreen` 相同。
-
 ```lua
 ---@param x number?
 ---@param y number?
@@ -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
@@ -197,7 +124,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
@@ -251,7 +178,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)
@@ -285,7 +212,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
@@ -323,7 +250,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)
@@ -392,7 +319,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(
@@ -457,7 +384,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(
@@ -518,7 +445,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,
@@ -563,7 +490,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(
@@ -919,7 +846,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
@@ -999,7 +926,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
@@ -1036,7 +963,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
@@ -1077,7 +1004,7 @@ 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")
@@ -1109,7 +1036,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
@@ -1186,7 +1113,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/logger.md

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

package/docs/apilua/opencv.md

@@ -148,7 +148,7 @@ local image = require("image")
 local a = cv.imread("template.png")
 local dir = file.getInternalDir("documents")
 local b = cv.imread(dir .. "/shot.jpg")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 local c = cv.imread(imageId)
 image.release(imageId)
 cv.release(a)
@@ -261,7 +261,7 @@ function fromImageId(imageId) end
 
 ```lua
 local cv = require("cv")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 local mat = cv.fromImageId(imageId)
 image.release(imageId)
 local outId = cv.toImageId(mat)
@@ -501,7 +501,7 @@ local half = cv.resize(src, { fx = 0.5, fy = 0.5, interpolation = cv.INTER_AREA
 function crop(mat, options) end
 ```
 
-参数与 `cv.capture` / `image.captureFullScreen` 一致，使用左上角与右下角。
+参数与 `cv.capture` / `image.captureScreen` 一致，使用左上角与右下角。
 
 参数为 `{ x, y, ex, ey }`。
 

package/docs/apilua/paddleocr.md

@@ -4,8 +4,9 @@ PaddleOCR 模块基于百度飞桨 PaddleOCR 技术，提供强大的光学字
 
 ## 功能概览
 
-- **自动加载**: 识别方法会自动加载所需模型，无需先手动加载
-- **PP-OCRv5**: 可通过 `loadV5` 手动加载 PP-OCRv5 模型
+- **自动加载**: 识别和查找方法会自动加载所需模型，无需先手动加载
+- **模型选择**: 同一时间只保留一个 active 模型，默认 `ppocr-v6-small`，可通过模型 ID 手动加载 `ppocr-v6-tiny` 或 `ppocr-v5`
+- **长边设置**: 可单独调整检测阶段最大边长，不需要重新加载已加载模型
 - **多源识别**: 支持屏幕截图、图片文件、URL 等多种输入源
 - **区域识别**: 支持指定区域的精确文字识别
 - **结构化结果**: 提供详细的文本位置、置信度和方向信息
@@ -49,40 +50,6 @@ PaddleOCR 模块基于百度飞桨 PaddleOCR 技术，提供强大的光学字
 
 ### 模型管理
 
-#### loadV5 - 手动加载 PP-OCRv5 模型。
-
-识别方法默认自动加载模型。只有需要切换到 PP-OCRv5 或指定 GPU 参数时才调用 `loadV5`。PaddleOCR 同一时间只保留一个 active 模型，`loadV5` 加载成功后会替换已加载模型。
-
-```lua
----@param maxSideLen number?
----@param useGpu boolean?
----@return boolean
-function loadV5(maxSideLen, useGpu) end
-```
-
-**参数:**
-
-| 参数名       | 类型    | 是否必填 | 默认值 | 描述                         |
-| ------------ | ------- | -------- | ------ | ---------------------------- |
-| `maxSideLen` | number  | 否       | 640    | 检测阶段输入最大边长         |
-| `useGpu`     | boolean | 否       | false  | 是否启用 GPU 加速            |
-
-**返回值:**
-
-| 类型    | 描述                                                        |
-| ------- | ----------------------------------------------------------- |
-| boolean | 加载成功或模型已加载返回 `true`，失败返回 `false`           |
-
-**示例:**
-
-```lua
-local paddleocr = require("paddleocr")
-
--- 手动加载 PP-OCRv5 模型
-local loaded = paddleocr.loadV5(640, false)
-print("PP-OCRv5 加载结果: " .. tostring(loaded))
-```
-
 #### loadModel - 按模型 ID 手动加载内置 PaddleOCR 模型。
 
 识别和查找方法默认自动加载 `ppocr-v6-small`。只有需要切换模型或指定 GPU 参数时才调用 `loadModel`。同一时间只保留一个 active 模型；检测长边请使用 `setMaxSideLen`。
@@ -147,50 +114,6 @@ paddleocr.setMaxSideLen(960)
 
 ### 文字识别
 
-#### recognize - 执行 OCR 识别。
-
-传入裁剪区域时，返回坐标相对于裁剪区域。全屏识别时 `x/y/ex/ey` 传 `0`。
-
-```lua
----@param input string
----@param x number?
----@param y number?
----@param ex number?
----@param ey number?
----@param confidenceThreshold number?
----@return OCRResult[]
-function recognize(input, x, y, ex, ey, confidenceThreshold) end
-```
-
-**参数:**
-
-| 参数名                | 类型   | 是否必填 | 默认值 | 描述                                                        |
-| --------------------- | ------ | -------- | ------ | ----------------------------------------------------------- |
-| `input`               | string | 是       |        | 输入源，支持 imageId、URL 字符串、文件路径或 `"screen"`      |
-| `x`                   | number | 否       | 0      | 裁剪区域左上角 x 坐标；全屏识别传 0                         |
-| `y`                   | number | 否       | 0      | 裁剪区域左上角 y 坐标；全屏识别传 0                         |
-| `ex`                  | number | 否       | 0      | 裁剪区域右下角 x 坐标；全屏识别传 0                         |
-| `ey`                  | number | 否       | 0      | 裁剪区域右下角 y 坐标；全屏识别传 0                         |
-| `confidenceThreshold` | number | 否       | 0.6    | 置信度阈值，低于该值的识别结果会被过滤                      |
-
-**返回值:**
-
-| 类型          | 描述                               |
-| ------------- | ---------------------------------- |
-| `OCRResult[]` | 识别结果数组，坐标相对于裁剪区域   |
-
-**示例:**
-
-```lua
-local paddleocr = require("paddleocr")
-local action = require("action")
-
-local results = paddleocr.recognize("screen", 100, 100, 500, 300)
-if #results > 0 then
-  action.click(results[1].centerX, results[1].centerY)
-end
-```
-
 #### recognizeAbs - 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
 
 传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
@@ -234,9 +157,9 @@ if #absResults > 0 then
 end
 ```
 
-#### findText - 查找目标文本。
+#### findTextAbs - 查找目标文本，并将结果坐标映射为原图/全屏绝对坐标。
 
-传入裁剪区域时，返回坐标相对于裁剪区域。`targets` 可以是字符串数组或逗号分隔字符串。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。`targets` 也可以是逗号分隔字符串。
 
 ```lua
 ---@param input string
@@ -248,51 +171,27 @@ end
 ---@param confidenceThreshold number?
 ---@param exactMatch boolean?
 ---@return OCRResult[]
-function findText(input, targets, x, y, ex, ey, confidenceThreshold, exactMatch) end
+function findTextAbs(input, targets, x, y, ex, ey, confidenceThreshold, exactMatch) end
 ```
 
 **参数:**
 
-| 参数名                | 类型              | 是否必填 | 默认值 | 描述                                                                     |
-| --------------------- | ----------------- | -------- | ------ | ------------------------------------------------------------------------ |
-| `input`               | string            | 是       |        | 输入源，支持 imageId、URL 字符串、文件路径或 `"screen"`                   |
+| 参数名                | 类型               | 是否必填 | 默认值 | 描述                                                                     |
+| --------------------- | ------------------ | -------- | ------ | ------------------------------------------------------------------------ |
+| `input`               | string             | 是       |        | 输入源，支持 imageId、URL 字符串、文件路径或 `"screen"`                   |
 | `targets`             | string[] \| string | 是       |        | 目标文本数组或逗号分隔字符串                                             |
-| `x`                   | number            | 否       | 0      | 裁剪区域左上角 x 坐标；全屏识别传 0                                      |
-| `y`                   | number            | 否       | 0      | 裁剪区域左上角 y 坐标；全屏识别传 0                                      |
-| `ex`                  | number            | 否       | 0      | 裁剪区域右下角 x 坐标；全屏识别传 0                                      |
-| `ey`                  | number            | 否       | 0      | 裁剪区域右下角 y 坐标；全屏识别传 0                                      |
-| `confidenceThreshold` | number            | 否       | 0.6    | 置信度阈值，低于该值的识别结果会被过滤                                   |
-| `exactMatch`          | boolean           | 否       | false  | 是否完整匹配；`false` 表示包含匹配，`true` 要求整条 OCR 文本等于目标文本 |
+| `x`                   | number             | 否       | 0      | 裁剪区域左上角 x 坐标；全屏识别传 0                                      |
+| `y`                   | number             | 否       | 0      | 裁剪区域左上角 y 坐标；全屏识别传 0                                      |
+| `ex`                  | number             | 否       | 0      | 裁剪区域右下角 x 坐标；全屏识别传 0                                      |
+| `ey`                  | number             | 否       | 0      | 裁剪区域右下角 y 坐标；全屏识别传 0                                      |
+| `confidenceThreshold` | number             | 否       | 0.6    | 置信度阈值，低于该值的识别结果会被过滤                                   |
+| `exactMatch`          | boolean            | 否       | false  | 是否完整匹配；`false` 表示包含匹配，`true` 要求整条 OCR 文本等于目标文本 |
 
 **返回值:**
 
-| 类型          | 描述                                 |
-| ------------- | ------------------------------------ |
-| `OCRResult[]` | 匹配到的结果数组，坐标相对于裁剪区域 |
-
-**示例:**
-
-```lua
-local paddleocr = require("paddleocr")
-local hits = paddleocr.findText("screen", { "确定" }, 100, 100, 500, 400, 0.6, false)
-```
-
-#### findTextAbs - 查找目标文本，并将结果坐标映射为原图/全屏绝对坐标。
-
-```lua
----@param input string
----@param targets string[]|string
----@param x number?
----@param y number?
----@param ex number?
----@param ey number?
----@param confidenceThreshold number?
----@param exactMatch boolean?
----@return OCRResult[]
-function findTextAbs(input, targets, x, y, ex, ey, confidenceThreshold, exactMatch) end
-```
-
-**参数:** 与 `findText` 相同；返回坐标为原图或全屏绝对坐标。
+| 类型          | 描述                                           |
+| ------------- | ---------------------------------------------- |
+| `OCRResult[]` | 匹配到的子串结果数组，坐标为原图或全屏绝对坐标 |
 
 **示例:**
 

package/docs/apilua/system.md

@@ -149,23 +149,6 @@ else
 end
 ```
 
-#### foregroundAppInfos - 获取前台运行的应用列表。
-
-```lua
----@return table[]
-function foregroundAppInfos() end
-```
-
-**示例:**
-
-```lua
-local system = require("system")
-local apps = system.foregroundAppInfos()
-if #apps > 0 then
-  print(apps[1].name, apps[1].bundleId)
-end
-```
-
 #### backgroundAppInfos - 获取后台运行的应用列表。
 
 ```lua

package/docs/apilua/ui.md

@@ -85,19 +85,6 @@ local ui = require("ui")
 ui.show()
 ```
 
-### hide - 隐藏 WebView。
-
-```lua
-function hide() end
-```
-
-**示例：**
-
-```lua
-local ui = require("ui")
-ui.hide()
-```
-
 ### eval - 在 WebView 中执行 JavaScript 代码。
 
 ```lua

package/docs/apilua/yolo.md

@@ -8,7 +8,7 @@ YOLO 模块基于 YOLOV8/YOLO11/YOLO26 算法和 NCNN 框架，提供高性能
 
 ## 功能概览
 
-- **模型管理**: YOLO 模型加载和资源管理
+- **模型管理**: YOLOV8/YOLOV11/YOLOV26 模型加载和资源管理
 - **目标检测**: 实时物体检测和位置识别
 - **多源输入**: 支持屏幕截图、图片文件、URL 等多种输入源
 - **结果处理**: 完整的检测结果信息和坐标数据
@@ -79,7 +79,7 @@ function load(paramPath, binPath, nc, version, useGpu) end
 | `paramPath` | string  | 是       |        | NCNN 模型的 param 文件绝对路径                                              |
 | `binPath`   | string  | 是       |        | NCNN 模型的 bin 文件绝对路径                                                |
 | `nc`        | number  | 否       | 0      | 模型的标签数量；传 `0` 或省略时根据模型输出自动推断，显式传入但不匹配时检测返回空数组 |
-| `version`   | number  | 否       | 0      | 模型版本；传 `0` 或省略时按 v11 处理，显式传入支持 8/11/26                  |
+| `version`   | number  | 否       | 11     | YOLO 模型版本号（仅支持 8/11/26）                                       |
 | `useGpu`    | boolean | 否       | false  | 是否启用 GPU 加速                                                           |
 
 **返回值:**
@@ -101,79 +101,45 @@ local modelId = yolo.load(
 )
 ```
 
-#### loadV11 - 加载 YOLO 模型。
-
-加载模型是使用目标检测功能的前提。兼容 YOLOV8 / YOLO11 的 NCNN 模型。
-
-```lua
----@param paramPath string
----@param binPath string
----@param nc number?
----@param useGpu boolean?
----@return string|nil
-function loadV11(paramPath, binPath, nc, useGpu) end
-```
-
-**参数:**
-
-| 参数名      | 类型    | 是否必填 | 默认值 | 描述                                                                        |
-| ----------- | ------- | -------- | ------ | --------------------------------------------------------------------------- |
-| `paramPath` | string  | 是       |        | NCNN 模型的 param 文件绝对路径                                              |
-| `binPath`   | string  | 是       |        | NCNN 模型的 bin 文件绝对路径                                                |
-| `nc`        | number  | 否       | 0      | 模型的标签数量；传 `0` 或省略时根据模型输出自动推断，显式传入但不匹配时检测返回空数组 |
-| `useGpu`    | boolean | 否       | false  | 是否启用 GPU 加速                                                           |
-
-**返回值:**
-
-| 类型            | 描述                                      |
-| --------------- | ----------------------------------------- |
-| `string \| nil` | 加载成功返回模型 ID 字符串，失败返回 nil  |
-
-**示例:**
-
-```lua
-local yolo = require("yolo")
-
--- 加载 YOLO 模型
-local modelId = yolo.loadV11(
-  "yolo11n_ncnn_model/model.ncnn.param",
-  "yolo11n_ncnn_model/model.ncnn.bin",
-  0,
-  false
-)
-```
-
 ### 目标检测
 
-#### detect - 对输入图像执行目标检测。
+#### detectAbs - 对指定区域执行目标检测，并将结果坐标映射为原图/全屏绝对坐标。
 
-执行目标检测，识别图像中的物体并返回检测结果。
+执行目标检测，识别图像中的物体并返回检测结果。传入裁剪区域时，结果坐标会映射回原图或全屏坐标，可直接用于点击；全屏检测时 `x/y/ex/ey` 传 `0`。
 
 ```lua
 ---@param modelId string
 ---@param img string
+---@param x number?
+---@param y number?
+---@param ex number?
+---@param ey number?
 ---@param targetSize number?
 ---@param threshold number?
 ---@param nmsThreshold number?
 ---@return YoloResult[]
-function detect(modelId, img, targetSize, threshold, nmsThreshold) end
+function detectAbs(modelId, img, x, y, ex, ey, targetSize, threshold, nmsThreshold) end
 ```
 
 **参数:**
 
 | 参数名         | 类型   | 是否必填 | 默认值 | 描述                                                               |
 | -------------- | ------ | -------- | ------ | ------------------------------------------------------------------ |
-| `modelId`      | string | 是       |        | 模型 ID，通过 `loadV11` 获取                                       |
+| `modelId`      | string | 是       |        | 模型 ID，通过 `load` 获取                                          |
 | `img`          | string | 是       |        | 图像输入源，支持 `"screen"`、图片文件路径、HTTP 图片地址或 imageId |
+| `x`            | number | 否       | 0      | 裁剪区域左上角 x 坐标；全屏检测传 0                                |
+| `y`            | number | 否       | 0      | 裁剪区域左上角 y 坐标；全屏检测传 0                                |
+| `ex`           | number | 否       | 0      | 裁剪区域右下角 x 坐标；全屏检测传 0                                |
+| `ey`           | number | 否       | 0      | 裁剪区域右下角 y 坐标；全屏检测传 0                                |
 | `targetSize`   | number | 否       | 640    | 模型推理输入边长，通常为 640（与模型训练时一致）                   |
 | `threshold`    | number | 否       | 0.4    | 置信度阈值，低于此值的检测结果会被过滤                             |
 | `nmsThreshold` | number | 否       | 0.5    | 非极大值抑制阈值，用于去除重叠检测框                               |
 
 **返回值:**
 
-| 类型           | 描述           |
-| -------------- | -------------- |
-| `YoloResult[]` | 检测结果数组   |
+| 类型           | 描述                                   |
+| -------------- | -------------------------------------- |
+| `YoloResult[]` | 检测结果数组，坐标为原图或全屏绝对坐标 |
 
 **示例:**
 
@@ -181,10 +147,11 @@ function detect(modelId, img, targetSize, threshold, nmsThreshold) end
 local yolo = require("yolo")
 
 -- 首先加载模型
-local modelId = yolo.loadV11(
+local modelId = yolo.load(
   "/yolo11n_ncnn_model/model.ncnn.param",
   "/yolo11n_ncnn_model/model.ncnn.bin",
   0,
+  11,
   false
 )
 
@@ -194,7 +161,7 @@ if not modelId then
 end
 
 -- 检测当前屏幕
-local screenResults = yolo.detect(modelId, "screen", 640, 0.4, 0.5)
+local screenResults = yolo.detectAbs(modelId, "screen", 0, 0, 0, 0, 640, 0.4, 0.5)
 print("屏幕检测到 " .. tostring(#screenResults) .. " 个物体")
 
 for index, result in ipairs(screenResults) do
@@ -206,80 +173,21 @@ for index, result in ipairs(screenResults) do
   print("  尺寸: " .. tostring(result.width) .. " x " .. tostring(result.height))
 end
 
--- 检测图片文件
-local imageResults = yolo.detect(modelId, "/path/to/test_image.jpg", 640, 0.3, 0.5)
+-- 检测图片文件的指定区域
+local imageResults = yolo.detectAbs(modelId, "/path/to/test_image.jpg", 100, 100, 500, 400, 640, 0.3, 0.5)
 if #imageResults > 0 then
   print("图片中检测到 " .. tostring(#imageResults) .. " 个物体")
-  for _, result in ipairs(imageResults) do
-    print("检测到类别 " .. tostring(result.classId) .. "，置信度: " .. tostring(result.confidence))
-  end
 else
   print("图片中未检测到任何物体")
 end
 
 -- 检测网络图片
-local urlResults = yolo.detect(modelId, "https://example.com/test_image.jpg", 640, 0.5, 0.4)
+local urlResults = yolo.detectAbs(modelId, "https://example.com/test_image.jpg", 0, 0, 0, 0, 640, 0.5, 0.4)
 print("网络图片检测结果: " .. tostring(#urlResults) .. " 个物体")
 
 yolo.free(modelId)
 ```
 
-#### detectAbs - 对指定区域执行目标检测，并将结果坐标映射为原图/全屏绝对坐标。
-
-传入裁剪区域时，结果坐标会映射回原图或全屏坐标，可直接用于点击；全屏检测时 `x/y/ex/ey` 传 `0`。
-
-```lua
----@param modelId string
----@param img string
----@param x number
----@param y number
----@param ex number
----@param ey number
----@param targetSize number?
----@param threshold number?
----@param nmsThreshold number?
----@return YoloResult[]
-function detectAbs(modelId, img, x, y, ex, ey, targetSize, threshold, nmsThreshold) end
-```
-
-**参数:**
-
-| 参数名         | 类型   | 是否必填 | 默认值 | 描述                                                               |
-| -------------- | ------ | -------- | ------ | ------------------------------------------------------------------ |
-| `modelId`      | string | 是       |        | 模型 ID，通过 `load` 或 `loadV11` 获取                             |
-| `img`          | string | 是       |        | 图像输入源，支持 `"screen"`、图片文件路径、HTTP 图片地址或 imageId |
-| `x`            | number | 是       |        | 裁剪区域左上角 x 坐标；全屏检测传 0                                |
-| `y`            | number | 是       |        | 裁剪区域左上角 y 坐标；全屏检测传 0                                |
-| `ex`           | number | 是       |        | 裁剪区域右下角 x 坐标；全屏检测传 0                                |
-| `ey`           | number | 是       |        | 裁剪区域右下角 y 坐标；全屏检测传 0                                |
-| `targetSize`   | number | 否       | 640    | 模型推理输入边长，通常为 640（与模型训练时一致）                   |
-| `threshold`    | number | 否       | 0.4    | 置信度阈值，低于此值的检测结果会被过滤                             |
-| `nmsThreshold` | number | 否       | 0.5    | 非极大值抑制阈值，用于去除重叠检测框                               |
-
-**返回值:**
-
-| 类型           | 描述                                   |
-| -------------- | -------------------------------------- |
-| `YoloResult[]` | 检测结果数组，坐标为原图或全屏绝对坐标 |
-
-**示例:**
-
-```lua
-local yolo = require("yolo")
-local modelId = yolo.load(
-  "/yolo11n_ncnn_model/model.ncnn.param",
-  "/yolo11n_ncnn_model/model.ncnn.bin",
-  0,
-  11,
-  false
-)
-local results = yolo.detectAbs(modelId, "screen", 0, 0, 0, 0, 640, 0.4, 0.5)
-if #results > 0 then
-  print(results[1].classId, results[1].centerX, results[1].centerY)
-end
-yolo.free(modelId)
-```
-
 ### 资源管理
 
 #### free - 释放指定模型的资源。

package/docs/apipython/media.md

@@ -218,3 +218,23 @@ print("开始播放音频...")
 played = media.playMp3WaitEnd("/var/mobile/Media/notification.mp3")
 print("音频播放完成" if played else "播放失败或被系统音频中断")
 ```
+
+#### isMp3Playing - 当前是否正在播放 MP3。
+
+```python
+def isMp3Playing() -> bool
+```
+
+**返回值:**
+
+| 类型   | 描述                             |
+| ------ | -------------------------------- |
+| `bool` | 正在播放返回 `True`，否则 `False` |
+
+**示例:**
+
+```python
+from kuaijs import media
+
+print("正在播放" if media.isMp3Playing() else "未播放")
+```

package/package.json

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