ms-vite-plugin 1.4.58 → 1.4.60

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,13 +139,10 @@ 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")
-local imageId = image.captureFullScreen()
+local imageId = image.captureScreen()
 local c = cv.imread(imageId)
 image.release(imageId)
 cv.release(a)
@@ -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,8 +250,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)
@@ -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 })
 ```
@@ -501,14 +482,13 @@ 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 }`。
 
 **示例：**
 
 ```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,11 +1,14 @@
 # PaddleOCR 模块 (PaddleOCR)
 
+模块表是内置全局 `paddleocr`，直接调用即可。不要 `require` 宿主模块。
+
 PaddleOCR 模块基于百度飞桨 PaddleOCR 技术，提供强大的光学字符识别（OCR）功能，支持中英文文本识别，可用于屏幕截图、图片文件等多种输入源的文字识别。
 
 ## 功能概览
 
-- **自动加载**: 识别方法会自动加载所需模型，无需先手动加载
-- **PP-OCRv5**: 可通过 `loadV5` 手动加载 PP-OCRv5 模型
+- **自动加载**: 识别和查找方法会自动加载所需模型，无需先手动加载
+- **模型选择**: 同一时间只保留一个 active 模型，默认 `ppocr-v6-small`，可通过模型 ID 手动加载 `ppocr-v6-tiny` 或 `ppocr-v5`
+- **长边设置**: 可单独调整检测阶段最大边长，不需要重新加载已加载模型
 - **多源识别**: 支持屏幕截图、图片文件、URL 等多种输入源
 - **区域识别**: 支持指定区域的精确文字识别
 - **结构化结果**: 提供详细的文本位置、置信度和方向信息
@@ -49,40 +52,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`。
@@ -110,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))
@@ -141,56 +109,11 @@ function setMaxSideLen(maxSideLen) end
 **示例:**
 
 ```lua
-local paddleocr = require("paddleocr")
 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 识别，并将结果坐标映射为原图/全屏绝对坐标。
 
 传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
@@ -226,17 +149,15 @@ 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)
 end
 ```
 
-#### findText - 查找目标文本。
+#### findTextAbs - 查找目标文本，并将结果坐标映射为原图/全屏绝对坐标。
 
-传入裁剪区域时，返回坐标相对于裁剪区域。`targets` 可以是字符串数组或逗号分隔字符串。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。`targets` 也可以是逗号分隔字符串。
 
 ```lua
 ---@param input string
@@ -248,57 +169,31 @@ 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[]` | 匹配到的子串结果数组，坐标为原图或全屏绝对坐标 |
 
 **示例:**
 
 ```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)
@@ -316,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()