ms-vite-plugin 1.4.58 → 1.4.60

package/docs/apilua/appleocr.md

@@ -1,5 +1,7 @@
 # AppleOCR 模块
 
+模块表是内置全局 `appleocr`，直接调用即可。不要 `require` 宿主模块。
+
 AppleOCR 模块基于 Apple Vision 框架，提供原生的光学字符识别（OCR）功能。该模块利用 iOS 系统内置的机器学习能力，无需额外模型文件，具有高效、准确的特点。
 
 <span style="color: red;">此模块仅支持 iOS 系统。</span>
@@ -59,9 +61,10 @@ AppleOCR 模块基于 Apple Vision 框架，提供原生的光学字符识别（
 
 ### 文字识别
 
-#### recognize - 执行 OCR 识别。
+#### recognizeAbs - 执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
 
-执行 OCR 识别。传入裁剪区域时，返回坐标相对于裁剪区域。全屏识别时 `x/y/ex/ey` 传 `0`。
+执行 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
 
 ```lua
 ---@param input string
@@ -71,7 +74,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,44 +90,13 @@ function recognize(input, x, y, ex, ey, languages) end
 
 **返回值:**
 
-| 类型          | 描述                                           |
-| ------------- | ---------------------------------------------- |
-| `OCRResult[]` | 识别结果数组，坐标相对于裁剪区域               |
+| 类型          | 描述                                   |
+| ------------- | -------------------------------------- |
+| `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` 相同；返回坐标为原图或全屏绝对坐标。
-
-**示例:**
-
-```lua
-local appleocr = require("appleocr")
-local action = require("action")
 local absResults = appleocr.recognizeAbs("screen", 100, 100, 500, 300)
 if #absResults > 0 then
   action.click(absResults[1].centerX, absResults[1].centerY)
@@ -133,9 +105,10 @@ end
 
 ### 数字识别
 
-#### recognizeNumbers - 执行数字 OCR 识别。
+#### recognizeNumbersAbs - 执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
 
-执行数字 OCR 识别。传入裁剪区域时，返回坐标相对于裁剪区域。
+执行数字 OCR 识别，并将结果坐标映射为原图/全屏绝对坐标。
+传入裁剪区域时，返回坐标会映射回原图或全屏坐标，可直接用于点击。
 
 **支持字符**: 0-9 数字、逗号(,)、小数点(.)、加号(+)、减号(-)
 
@@ -146,69 +119,44 @@ 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[]` | 数字识别结果数组，坐标相对于裁剪区域           |
-
-**示例:**
-
-```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` 相同；返回坐标为原图或全屏绝对坐标。
+| `OCRResult[]` | 数字识别结果数组，坐标为原图或全屏绝对坐标     |
 
 **示例:**
 
 ```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,64 +164,31 @@ 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[]` | 命中子串的识别结果数组，坐标为原图或全屏绝对坐标   |
 
 **示例:**
 
 ```lua
-local appleocr = require("appleocr")
-local action = require("action")
 local absHits = appleocr.findTextAbs("screen", { "开始" }, 100, 100, 500, 400)
 if #absHits > 0 then
   action.click(absHits[1].centerX, absHits[1].centerY)

package/docs/apilua/cloud.md

@@ -1,5 +1,7 @@
 # 云控模块 (Cloud)
 
+模块表是内置全局 `cloud`，直接调用即可。不要 `require` 宿主模块。
+
 云控模块用于在主脚本中使用内置云控 WebSocket 连接。脚本可以主动连接云控服务器、判断连接状态、断开连接、上报事件数据，并监听服务器事件数据。
 
 ## 注意事项
@@ -64,7 +66,6 @@ function connect(url, deviceNo) end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 local accepted = cloud.connect("wss = //example.com/control", "device-001")
 print("云控连接请求:", accepted)
 ```
@@ -85,7 +86,6 @@ function isConnected() end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 if cloud.isConnected() then
   cloud.report("status", { value = "ready" })
 end
@@ -102,7 +102,6 @@ function disconnect() end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 cloud.disconnect()
 ```
 
@@ -131,7 +130,6 @@ function report(event, data) end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 local ok = cloud.report("taskFinished", {
   taskId = "A-1001",
   success = true,
@@ -147,7 +145,6 @@ print("上报结果:", ok)
 `data` 的 key 必须使用云控端已经配置好的设备总览自定义字段名。上报了云控端未配置的多余字段时，协议仍可发送，但云控端设备总览不会显示这些字段。
 
 ```lua
-local cloud = require("cloud")
 cloud.report("cloud = status", {
   taskName = "巡检任务",
   progress = 80,
@@ -174,7 +171,6 @@ function onEvent(callback) end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 cloud.onEvent(function(event, data)
   if event == "startTask" then
     print("任务参数:", data)

package/docs/apilua/config.md

@@ -1,5 +1,7 @@
 # 配置模块 (Config)
 
+模块表是内置全局 `config`，直接调用即可。不要 `require` 宿主模块。
+
 配置模块提供了读取、更新和删除应用配置的功能。
 
 网页的 ms.setConfig 对应 config.set
@@ -28,7 +30,6 @@ function all() end
 **示例:**
 
 ```lua
-local config = require("config")
 local allConfigs = config.all()
 print("所有配置: " .. tostring(ToJsonString(allConfigs, nil, 2)))
 ```
@@ -56,7 +57,6 @@ function setAll(config) end
 **示例:**
 
 ```lua
-local config = require("config")
 local success = config.setAll({ maxRetries = 5, debugEnabled = true })
 if success then
   print("所有配置已更新")
@@ -88,7 +88,6 @@ function set(key, value) end
 **示例:**
 
 ```lua
-local config = require("config")
 -- 更新不同类型的配置
 local success1 = config.set("maxRetries", 5)
 local success2 = config.set("apiBaseUrl", "https://api.example.com")
@@ -122,7 +121,6 @@ function get(key) end
 **示例:**
 
 ```lua
-local config = require("config")
 local maxRetries = config.get("maxRetries")
 if maxRetries ~= nil then
   print("最大重试次数: " .. tostring(maxRetries))
@@ -145,7 +143,6 @@ function getKuiConfig() end
 **示例:**
 
 ```lua
-local config = require("config")
 local kuiConfig = config.getKuiConfig()
 print("KUI 配置: " .. tostring(ToJsonString(kuiConfig, nil, 2)))
 ```
@@ -173,7 +170,6 @@ function remove(key) end
 **示例:**
 
 ```lua
-local config = require("config")
 local deleted = config.remove("temporaryConfig")
 if deleted then
   print("临时配置已删除")

package/docs/apilua/cryptoUtils.md

@@ -1,5 +1,7 @@
 # 加密模块 (CryptoUtils)
 
+模块表是内置全局 `cryptoUtils`，直接调用即可。不要 `require` 宿主模块。
+
 加密模块提供了常用的加密和解密功能，支持 AES、RSA 以及 MD5、SHA1、SHA256 等哈希算法。
 
 ## 功能概览
@@ -41,7 +43,6 @@ function encryptWithAES_ECB(data, aesKey, noPadding) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "Hello World"
 local key = "1234567890123456"; -- 16位密钥
 local encrypted = cryptoUtils.encryptWithAES_ECB(data, key)
@@ -77,7 +78,6 @@ function decryptWithAES_ECB(data, aesKey, noPadding) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local encryptedData = "Base64EncodedString..."
 local key = "1234567890123456"
 local decrypted = cryptoUtils.decryptWithAES_ECB(encryptedData, key)
@@ -113,7 +113,6 @@ function encryptWithRSA(data, rsaPublicKey) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "123456"
 local publicKey = "-----BEGIN PUBLIC KEY-----
 公钥内容
@@ -150,7 +149,6 @@ function decryptWithRSA(data, rsaPrivateKey) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local encryptedData = "加密后字符串"
 local privateKey = "-----BEGIN PRIVATE KEY-----
 私钥内容
@@ -184,7 +182,6 @@ function md5(data) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "123456"
 local hash = cryptoUtils.md5(data)
 print("MD5 = " .. tostring(hash)); -- e10adc3949ba59abbe56e057f20f883e
@@ -215,7 +212,6 @@ function sha1(data, key) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "123456"
 local hash = cryptoUtils.sha1(data)
 print("SHA1 = " .. tostring(hash))
@@ -246,7 +242,6 @@ function sha256(data, key) end
 **示例:**
 
 ```lua
-local cryptoUtils = require("cryptoUtils")
 local data = "123456"
 local hash = cryptoUtils.sha256(data)
 print("SHA256 = " .. tostring(hash))

package/docs/apilua/device.md

@@ -1,5 +1,7 @@
 # 设备模块 (Device)
 
+模块表是内置全局 `device`，直接调用即可。不要 `require` 宿主模块。
+
 设备模块提供了获取设备信息和设备操作的功能，包括电池信息、设备标识、屏幕信息、系统信息等。
 
 ## 电池信息
@@ -21,7 +23,6 @@ function getBatteryInfo() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取电池信息
 local battery = device.getBatteryInfo()
 print("电池电量: " .. tostring(battery.level) .. "%")
@@ -48,7 +49,6 @@ function getStorageSpace() end
 **示例：**
 
 ```lua
-local device = require("device")
 local storage = device.getStorageSpace()
 print("总存储: " .. tostring(storage.total) .. tostring(storage.unit))
 print("剩余存储: " .. tostring(storage.free) .. tostring(storage.unit))
@@ -77,7 +77,6 @@ function getDeviceID() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取设备ID
 local uuid = device.getDeviceID()
 print("设备ID = " .. tostring(uuid))
@@ -104,7 +103,6 @@ function getServerDeviceId() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取服务器设备ID
 local serverDeviceId = device.getServerDeviceId()
 print("服务器设备ID = " .. tostring(serverDeviceId))
@@ -126,7 +124,6 @@ function getECID() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取ECID
 local ecid = device.getECID()
 print("ECID = " .. tostring(ecid))
@@ -148,7 +145,6 @@ function getUDID() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取UDID
 local udid = device.getUDID()
 print("UDID = " .. tostring(udid))
@@ -170,7 +166,6 @@ function getDeviceName() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取设备名称
 local deviceName = device.getDeviceName()
 print("设备名称: " .. tostring(deviceName))
@@ -192,7 +187,6 @@ function getDeviceModel() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取设备型号
 local model = device.getDeviceModel()
 print("设备型号: " .. tostring(model))
@@ -222,7 +216,6 @@ function getScreenSize() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕尺寸
 local screenSize = device.getScreenSize()
 print("屏幕尺寸: " .. tostring(screenSize.width) .. " x " .. tostring(screenSize.height))
@@ -250,7 +243,6 @@ function getScreenRealSize() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕实际尺寸
 local screenRealSize = device.getScreenRealSize()
 print("屏幕实际尺寸: " .. tostring(screenRealSize.width) .. " x " .. tostring(screenRealSize.height))
@@ -272,7 +264,6 @@ function getScreenScale() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕缩放比例
 local scale = device.getScreenScale()
 print("屏幕缩放比例: " .. tostring(scale))
@@ -294,7 +285,6 @@ function getScreenBrightness() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕亮度
 local brightness = device.getScreenBrightness()
 print("屏幕亮度: " .. tostring(brightness))
@@ -325,7 +315,6 @@ function setScreenBrightness(brightness) end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 设置屏幕亮度到 50%
 device.setScreenBrightness(0.5)
 ```
@@ -346,7 +335,6 @@ function getVolume() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取系统音量
 local volume = device.getVolume()
 print("系统音量: " .. tostring(volume))
@@ -377,7 +365,6 @@ function setVolume(volume) end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 设置系统音量到 50%
 device.setVolume(0.5)
 ```
@@ -403,7 +390,6 @@ function getOrientation() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取屏幕方向
 local orientation = device.getOrientation()
 print("屏幕方向: " .. tostring(orientation))
@@ -427,7 +413,6 @@ function getOSVersion() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取系统版本
 local osVersion = device.getOSVersion()
 print("系统版本: iOS " .. tostring(osVersion))
@@ -449,7 +434,6 @@ function getLanIp() end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 获取局域网IP
 local lanIp = device.getLanIp()
 print("局域网IP = " .. tostring(lanIp))
@@ -475,7 +459,6 @@ function vibrate(duration, intensity) end
 **示例：**
 
 ```lua
-local device = require("device")
 -- 基础振动
 device.vibrate(500, 0.5); -- 振动500ms，中等强度
 -- 不同强度的振动

package/docs/apilua/dotocr.md

@@ -1,5 +1,7 @@
 # 点阵 OCR 模块 (dotocr)
 
+模块表是内置全局 `dotocr`，直接调用即可。不要 `require` 宿主模块。
+
 点阵 OCR 模块基于图色工具生成的固定像素点阵字库，提供精确的文字识别与查找功能。字库保存在项目的 `res/fonts` 目录，使用前需先加载字库取得字库 ID，再复用该 ID 进行识别，使用完毕后释放。
 
 点阵模板按照制作时的原始像素尺寸匹配，不会自动缩放到其他分辨率。目标文字的字号、缩放比例或像素形状发生变化时，应制作对应的字库特征。
@@ -73,7 +75,6 @@ function loadFont(fontPath) end
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 local fontId = dotocr.loadFont("/fonts/default.json")
 if not fontId then
   print("字库加载失败")
@@ -121,7 +122,6 @@ function recognizeAbs(fontId, input, x, y, ex, ey, confidenceThreshold) end
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 local chars = dotocr.recognizeAbs(fontId, "screen", 100, 200, 600, 280, 0.95)
 print("识别数量: " .. tostring(#chars))
 if #chars > 0 then
@@ -173,7 +173,6 @@ function findTextAbs(fontId, input, targetTexts, x, y, ex, ey, confidenceThresho
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 local hits = dotocr.findTextAbs(
   fontId,
   "screen",
@@ -208,7 +207,6 @@ function free(fontId) end
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 if fontId then
   dotocr.free(fontId)
   print("字库 " .. tostring(fontId) .. " 资源已释放")
@@ -224,7 +222,6 @@ function freeAll() end
 **示例:**
 
 ```lua
-local dotocr = require("dotocr")
 dotocr.freeAll()
 print("所有点阵字库资源已释放")
 ```