ms-vite-plugin 1.4.11 → 1.4.13

package/docs/api/appleocr.md

@@ -234,7 +234,7 @@ if (absNumberResults.length > 0) {
 
 #### findText
 
-执行指定文本查找，在识别结果中查找特定的文本内容。使用全字匹配模式，确保精确匹配目标文本。
+执行指定文本查找，在识别结果中查找目标子串，并返回目标子串的坐标。
 
 ```typescript
 function findText(
@@ -245,6 +245,7 @@ function findText(
   ex?: number,
   ey?: number,
   languages?: string[],
+  exactMatch?: boolean,
 ): OCRResult[];
 ```
 
@@ -253,24 +254,27 @@ function findText(
 | 参数名      | 类型     | 是否必填 | 默认值               | 描述                                                                                                                                 |
 | ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | `input`     | string   | 是       | -                    | 输入源，支持以下类型： <br>-`"screen"` 当前屏幕截图 <br>- `string` 图片文件路径或 URL <br>- `imageId` 图片 ID（通过 image 模块获取） |
-| `texts`     | string[] | 是       | -                    | 要查找的文本数组                                                                                                                     |
+| `texts`     | string[] | 是       | -                    | 要查找的目标文本数组，支持匹配识别结果中的子串                                                                                       |
 | `x`         | number   | 否       | -                    | 识别区域左上角 x 坐标                                                                                                                |
 | `y`         | number   | 否       | -                    | 识别区域左上角 y 坐标                                                                                                                |
 | `ex`        | number   | 否       | -                    | 识别区域右下角 x 坐标                                                                                                                |
 | `ey`        | number   | 否       | -                    | 识别区域右下角 y 坐标                                                                                                                |
 | `languages` | string[] | 否       | ["zh-Hans", "en-US"] | 可选，指定识别语言列表，如 ["zh-Hans", "en-US"]                                                                                      |
+| `exactMatch` | boolean | 否       | false                | 是否完整匹配；`false` 表示包含匹配，`true` 表示整条 OCR 识别结果文本必须等于目标文本                                                          |
 
 **返回值:**
 
 | 类型          | 描述                   |
 | ------------- | ---------------------- |
-| `OCRResult[]` | 匹配的文本识别结果数组 |
+| `OCRResult[]` | 命中子串的文本识别结果数组 |
 
 **使用示例:**
 
 ```javascript
-// 识别屏幕中的文本
-const textResults = appleOcr.findText("screen", ["123", "456"], 0, 0, 100, 100);
+// 在“开始执行”中查找“开始”，返回“开始”子串区域
+const textResults = appleOcr.findText("screen", ["开始"], 0, 0, 100, 100);
+// 不指定 languages 但启用完整匹配时，用 null 占位 languages
+const exactResults = appleOcr.findText("screen", ["开始"], 0, 0, 100, 100, null, true);
 logi(`识别到 ${textResults.length} 个文本区域`);
 textResults.forEach((result, index) => {
   logi(`文本 ${index + 1}: ${result.text} (置信度: ${result.confidence})`);
@@ -281,7 +285,7 @@ textResults.forEach((result, index) => {
 
 #### findTextAbs
 
-查找目标文本，并将结果坐标映射为原图/全屏绝对坐标。
+查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
 
 参数与 `findText` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
 
@@ -294,13 +298,14 @@ function findTextAbs(
   ex?: number,
   ey?: number,
   languages?: string[],
+  exactMatch?: boolean,
 ): OCRResult[];
 ```
 
 **示例:**
 
 ```javascript
-const absHits = appleOcr.findTextAbs("screen", ["确定"], 100, 100, 500, 400);
+const absHits = appleOcr.findTextAbs("screen", ["开始"], 100, 100, 500, 400);
 if (absHits.length > 0) {
   action.click(absHits[0].centerX, absHits[0].centerY);
 }

package/docs/api/global.md

@@ -48,6 +48,20 @@ declare const __debug__: boolean;
 logi(`调试模式: ${__debug__}`);
 ```
 
+#### **isRunning**
+
+当前脚本是否在运行。
+
+```typescript
+declare const __isRunning__: boolean;
+```
+
+**示例:**
+
+```javascript
+logi(`运行状态: ${__isRunning__}`);
+```
+
 ### 应用信息
 
 #### **platform**

package/docs/api/image.md

@@ -460,6 +460,58 @@ if (imageId) {
 }
 ```
 
+### countColor - 统计颜色数量
+
+统计指定区域内命中目标颜色的像素数量。`colors` 可以传入一个或多个候选颜色，多个颜色使用 `|` 分隔，支持 `主色-偏色` 格式，如 `#0A0A0A-#101010|#FFFFFF-#101010`。同一个像素同时命中多个候选颜色时只统计一次。
+
+```typescript
+function countColor(
+  imageId: string,
+  colors: string,
+  threshold: number,
+  x: number,
+  y: number,
+  ex: number,
+  ey: number,
+): number;
+```
+
+**参数：**
+
+| 参数名      | 类型   | 是否必填 | 默认值 | 描述                                                                                 |
+| ----------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------ |
+| `imageId`   | string | 是       | -      | 图片 ID，支持 `"screen"`、图片文件路径、HTTP 图片地址或已加载的图片 ID               |
+| `colors`    | string | 是       | -      | 颜色列表，支持 `主色-偏色\|主色-偏色` 格式，如 `#0A0A0A-#101010\|#FFFFFF-#101010` |
+| `threshold` | number | 是       | -      | 颜色匹配阈值 (0.0-1.0)，数值越大匹配越严格                                           |
+| `x, y`      | number | 是       | -      | 统计区域左上角坐标                                                                   |
+| `ex, ey`    | number | 是       | -      | 统计区域右下角坐标；传 `0` 表示延伸到图片右侧或底部边界                              |
+
+**返回值：**
+
+| 类型     | 描述                                                                                 |
+| -------- | ------------------------------------------------------------------------------------ |
+| `number` | 命中目标颜色的像素数量；图片加载失败、颜色为空、颜色格式无效或区域不合法时返回 `0` |
+
+**示例：**
+
+```javascript
+const imageId = image.captureFullScreen();
+if (imageId) {
+  const count = image.countColor(
+    imageId,
+    "#0A0A0A-#101010|#FFFFFF-#101010",
+    0.92,
+    100,
+    200,
+    500,
+    700,
+  );
+
+  logi(`目标区域命中颜色像素数量: ${count}`);
+  image.release(imageId);
+}
+```
+
 ### cmpColor - 多点比色
 
 ```typescript

package/docs/api/paddleocr.md

@@ -201,6 +201,7 @@ function findText(
   ex?: number,
   ey?: number,
   confidenceThreshold?: number,
+  exactMatch?: boolean,
 ): OCRResult[];
 ```
 
@@ -215,6 +216,7 @@ function findText(
 | `ex`                  | number   | 否       | 0      | 查找区域右下角 x 坐标                                                                                                                    |
 | `ey`                  | number   | 否       | 0      | 查找区域右下角 y 坐标                                                                                                                    |
 | `confidenceThreshold` | number   | 否       | 0.6    | 置信度阈值，默认值为 0.6                                                                                                                 |
+| `exactMatch`          | boolean  | 否       | false  | 是否完整匹配；`false` 表示包含匹配，`true` 表示整条 OCR 识别结果文本必须等于目标文本                                                               |
 
 **返回值:**
 
@@ -240,6 +242,7 @@ const hitResults = paddleOcr.findText(
   0,
   0,
   0.6,
+  false,
 );
 if (hitResults.length > 0) {
   hitResults.forEach((item, index) => {
@@ -269,13 +272,14 @@ function findTextAbs(
   ex?: number,
   ey?: number,
   confidenceThreshold?: number,
+  exactMatch?: boolean,
 ): OCRResult[];
 ```
 
 **示例:**
 
 ```javascript
-const absHits = paddleOcr.findTextAbs("screen", ["确定"], 100, 100, 500, 400, 0.6);
+const absHits = paddleOcr.findTextAbs("screen", ["确定"], 100, 100, 500, 400, 0.6, false);
 if (absHits.length > 0) {
   action.click(absHits[0].centerX, absHits[0].centerY);
 }

package/docs/api/pip.md

@@ -1,12 +1,14 @@
 # 悬浮窗模块 (PIP)
 
-悬浮窗模块提供画中画（Picture in Picture）日志窗口能力。
+悬浮窗模块提供 iOS 画中画（Picture in Picture）悬浮窗能力，可用于显示脚本日志、保活提示或脚本自定义文本。
 
 ## 功能特性
 
-- **模式切换**：切换日志、保活和关闭三种悬浮窗模式
+- **显示模式**：支持日志、保活和自定义三种显示模式
+- **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
-- **识别标记**：日志窗口左上角默认显示高对比标记，可用于截图识别悬浮窗位置
+- **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
+- **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
 ## API 方法
 
@@ -39,7 +41,7 @@ if (isActive) {
 function switchToLogMode(): boolean;
 ```
 
-切换到日志模式并尝试显示悬浮窗日志窗口。首次显示悬浮窗时 App 必须在前台。
+切换到日志模式并尝试显示悬浮窗日志窗口。首次显示悬浮窗时 App 必须在前台。日志模式会恢复最近一次保存的日志窗口尺寸。
 
 **返回值：**
 
@@ -60,7 +62,7 @@ const success = pip.switchToLogMode();
 function switchToKeepAliveMode(): boolean;
 ```
 
-切换到保活模式并尝试显示极小高度悬浮窗。首次显示悬浮窗时 App 必须在前台。
+切换到保活模式并尝试显示极小高度悬浮窗。首次显示悬浮窗时 App 必须在前台。保活模式不接受脚本尺寸设置。
 
 **返回值：**
 
@@ -75,13 +77,13 @@ takeMeToFront();
 const success = pip.switchToKeepAliveMode();
 ```
 
-### switchToOffMode - 切换到关闭模式
+### switchToCustomMode - 切换到自定义模式
 
 ```typescript
-function switchToOffMode(): boolean;
+function switchToCustomMode(): boolean;
 ```
 
-切换到关闭模式并关闭悬浮窗。
+切换到自定义模式并显示脚本设置的自定义文本。首次显示悬浮窗时 App 必须在前台。自定义模式会恢复最近一次保存的自定义窗口尺寸。
 
 **返回值：**
 
@@ -92,22 +94,195 @@ function switchToOffMode(): boolean;
 **示例：**
 
 ```typescript
-const success = pip.switchToOffMode();
+takeMeToFront();
+pip.switchToCustomMode();
+pip.setCustomText("运行中\n进度 1/3");
+pip.setCustomTextColor("#34c759");
+pip.setCustomTextSize(18);
+```
+
+### closeWindow - 关闭悬浮窗
+
+```typescript
+function closeWindow(): boolean;
+```
+
+关闭悬浮窗。
+
+**返回值：**
+
+| 类型      | 描述                   |
+| --------- | ---------------------- |
+| `boolean` | `true` 代表已提交请求 |
+
+**示例：**
+
+```typescript
+const success = pip.closeWindow();
+```
+
+### setContentSize - 设置内容尺寸
+
+```typescript
+function setContentSize(width: number, height: number): boolean;
+```
+
+设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+
+**参数：**
+
+| 参数     | 类型             | 必填 | 描述                                           |
+| -------- | ---------------- | ---- | ---------------------------------------------- |
+| `width`  | `number` | 是   | 目标内容宽度 |
+| `height` | `number` | 是   | 目标内容高度 |
+
+**返回值：**
+
+| 类型      | 描述                                                                 |
+| --------- | -------------------------------------------------------------------- |
+| `boolean` | `true` 代表尺寸已提交；`false` 代表当前模式不允许设置或宽高无效 |
+
+**示例：**
+
+```typescript
+pip.switchToLogMode();
+pip.setContentSize(280, 120);
+
+pip.switchToCustomMode();
+pip.setContentSize(120, 180);
+```
+
+### setCustomText - 设置自定义文本
+
+```typescript
+function setCustomText(text: string): boolean;
+```
+
+设置自定义模式显示的纯文本内容。该方法只更新自定义文本数据，不会自动切换到自定义模式。
+
+**参数：**
+
+| 参数   | 类型     | 必填 | 描述                                        |
+| ------ | -------- | ---- | ------------------------------------------- |
+| `text` | `string` | 是   | 要显示的文本，支持真实换行和字符串中的 `\n` |
+
+**返回值：**
+
+| 类型      | 描述                   |
+| --------- | ---------------------- |
+| `boolean` | `true` 代表文本已提交 |
+
+**示例：**
+
+```typescript
+pip.setCustomText("运行中\n进度 1/3");
+pip.switchToCustomMode();
+```
+
+### setCustomTextColor - 设置自定义文字颜色
+
+```typescript
+function setCustomTextColor(color: string): boolean;
+```
+
+设置自定义模式显示文本的文字颜色。该方法只更新文字颜色数据，不会自动切换到自定义模式。
+
+**参数：**
+
+| 参数    | 类型     | 必填 | 描述                                                        |
+| ------- | -------- | ---- | ----------------------------------------------------------- |
+| `color` | `string` | 是   | 文字颜色，支持 `RRGGBB`、`RRGGBBAA`，可带 `#` 前缀；末尾 AA 为透明度；无效值使用白色 |
+
+**返回值：**
+
+| 类型      | 描述                       |
+| --------- | -------------------------- |
+| `boolean` | `true` 代表文字颜色已提交 |
+
+**示例：**
+
+```typescript
+pip.setCustomTextColor("#34c759");
+pip.switchToCustomMode();
+```
+
+### setCustomTextSize - 设置自定义文字大小
+
+```typescript
+function setCustomTextSize(fontSize: number): boolean;
+```
+
+设置自定义模式显示文本的文字大小。该方法只更新文字大小数据，不会自动切换到自定义模式。
+
+**参数：**
+
+| 参数       | 类型     | 必填 | 描述                       |
+| ---------- | -------- | ---- | -------------------------- |
+| `fontSize` | `number` | 是   | 文字字号，必须是有效数字 |
+
+**返回值：**
+
+| 类型      | 描述                                                   |
+| --------- | ------------------------------------------------------ |
+| `boolean` | `true` 代表文字大小已提交；`false` 代表字号无效 |
+
+**示例：**
+
+```typescript
+pip.setCustomTextSize(18);
+pip.switchToCustomMode();
+```
+
+### setCustomBackgroundColor - 设置自定义背景色
+
+```typescript
+function setCustomBackgroundColor(color: string): boolean;
+```
+
+设置自定义模式显示区域的背景色。该方法只更新背景色数据，不会自动切换到自定义模式。
+
+**参数：**
+
+| 参数    | 类型     | 必填 | 描述                                                        |
+| ------- | -------- | ---- | ----------------------------------------------------------- |
+| `color` | `string` | 是   | 背景颜色，支持 `RRGGBB`、`RRGGBBAA`，可带 `#` 前缀；末尾 AA 为透明度；无效值使用黑色 |
+
+**返回值：**
+
+| 类型      | 描述                     |
+| --------- | ------------------------ |
+| `boolean` | `true` 代表背景色已提交 |
+
+**示例：**
+
+```typescript
+pip.setCustomBackgroundColor("#111111");
+pip.switchToCustomMode();
 ```
 
 ## 完整使用示例
 
 ```typescript
 takeMeToFront();
+
 pip.switchToLogMode();
+pip.setContentSize(280, 120);
+
+pip.setCustomText("任务运行中\n1/3");
+pip.setCustomTextColor("#34c759");
+pip.setCustomTextSize(18);
+pip.setCustomBackgroundColor("#111111");
+pip.switchToCustomMode();
+pip.setContentSize(120, 180);
 ```
 
 ## 注意事项
 
-1. **前台限制**：首次切换到日志模式或保活模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换日志/保活模式
+1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式或关闭悬浮窗
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
 3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
-4. **识别标记**：日志窗口左上角默认包含识别标记，便于通过截图识别悬浮窗位置
+4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸
+5. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
 
 ## 故障排除
 
@@ -116,3 +291,8 @@ pip.switchToLogMode();
 - 确认设备支持悬浮窗功能
 - 检查悬浮窗权限是否已开启
 - 确认应用当前在前台
+
+### setContentSize 返回 false
+
+- 确认当前模式是日志模式或自定义模式
+- 确认宽度和高度都传入了有效数字

package/docs/apicn/appleocr.md

@@ -234,7 +234,7 @@ if (绝对坐标数字结果.length > 0) {
 
 #### 查找文本
 
-执行指定文本查找，在识别结果中查找特定的文本内容。使用全字匹配模式，确保精确匹配目标文本。
+执行指定文本查找，在识别结果中查找目标子串，并返回目标子串的坐标。
 
 ```typescript
 function 查找文本(
@@ -245,6 +245,7 @@ function 查找文本(
   图片边界框右下角x坐标?: 数字,
   图片边界框右下角y坐标?: 数字,
   识别语言数组?: 数组<字符串>,
+  是否完整匹配?: 布尔值,
 ): 数组<OCR识别结果>;
 ```
 
@@ -253,24 +254,27 @@ function 查找文本(
 | 参数名                  | 类型         | 是否必填 | 默认值               | 描述                                                                                                                                 |
 | ----------------------- | ------------ | -------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | `输入源`                | string       | 是       | -                    | 输入源，支持以下类型： <br>-`"screen"` 当前屏幕截图 <br>- `string` 图片文件路径或 URL <br>- `imageId` 图片 ID（通过 image 模块获取） |
-| `要查找的文本数组`      | 数组<字符串> | 是       | -                    | 要查找的文本数组                                                                                                                     |
+| `要查找的文本数组`      | 数组<字符串> | 是       | -                    | 要查找的目标文本数组，支持匹配识别结果中的子串                                                                                       |
 | `图片边界框左上角x坐标` | number       | 否       | -                    | 识别区域左上角 x 坐标                                                                                                                |
 | `图片边界框左上角y坐标` | number       | 否       | -                    | 识别区域左上角 y 坐标                                                                                                                |
 | `图片边界框右下角x坐标` | number       | 否       | -                    | 识别区域右下角 x 坐标                                                                                                                |
 | `图片边界框右下角y坐标` | number       | 否       | -                    | 识别区域右下角 y 坐标                                                                                                                |
 | `识别语言数组`          | 数组<字符串> | 否       | ["zh-Hans", "en-US"] | 可选，指定识别语言列表，如 ["zh-Hans", "en-US"]                                                                                      |
+| `是否完整匹配`          | boolean      | 否       | false                | 是否完整匹配；`false` 表示包含匹配，`true` 表示整条 OCR 识别结果文本必须等于目标文本                                                          |
 
 **返回值:**
 
 | 类型                | 描述                   |
 | ------------------- | ---------------------- |
-| `数组<OCR识别结果>` | 匹配的文本识别结果数组 |
+| `数组<OCR识别结果>` | 命中子串的文本识别结果数组 |
 
 **使用示例:**
 
 ```javascript
-// 识别屏幕中的文本
-const 文本识别结果 = 查找文本("screen", ["123", "456"], 0, 0, 100, 100);
+// 在“开始执行”中查找“开始”，返回“开始”子串区域
+const 文本识别结果 = 查找文本("screen", ["开始"], 0, 0, 100, 100);
+// 不指定识别语言但启用完整匹配时，用 null 占位识别语言数组
+const 全字命中结果 = 查找文本("screen", ["开始"], 0, 0, 100, 100, null, true);
 $打印信息日志(`识别到 ${文本识别结果.length} 个文本区域`);
 文本识别结果.forEach((result, index) => {
   $打印信息日志(
@@ -285,7 +289,7 @@ $打印信息日志(`识别到 ${文本识别结果.length} 个文本区域`);
 
 #### 查找文本绝对坐标
 
-查找目标文本，并将结果坐标映射为原图/全屏绝对坐标。
+查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标。
 
 参数与 `查找文本` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
 
@@ -298,13 +302,14 @@ function 查找文本绝对坐标(
   图片边界框右下角x坐标?: 数字,
   图片边界框右下角y坐标?: 数字,
   识别语言数组?: 数组<字符串>,
+  是否完整匹配?: 布尔值,
 ): 数组<OCR识别结果>;
 ```
 
 **示例:**
 
 ```javascript
-const 绝对坐标命中 = $苹果OCR.查找文本绝对坐标("screen", ["确定"], 100, 100, 500, 400);
+const 绝对坐标命中 = $苹果OCR.查找文本绝对坐标("screen", ["开始"], 100, 100, 500, 400);
 if (绝对坐标命中.length > 0) {
   $点击(绝对坐标命中[0].centerX, 绝对坐标命中[0].centerY);
 }

package/docs/apicn/global.md

@@ -50,6 +50,20 @@ declare const $是否调试: 布尔值;
 $打印信息日志($是否调试);
 ```
 
+#### **$是否运行**
+
+当前脚本是否在运行。
+
+```typescript
+declare const $是否运行: 布尔值;
+```
+
+**示例:**
+
+```javascript
+$打印信息日志(`运行状态: ${$是否运行}`);
+```
+
 ### 应用信息
 
 #### **$平台**

package/docs/apicn/image.md

@@ -463,6 +463,60 @@ if (图片ID) {
 }
 ```
 
+### 统计颜色数量
+
+统计指定区域内命中目标颜色的像素数量。`颜色列表` 可以传入一个或多个候选颜色，多个颜色使用 `|` 分隔，支持 `主色-偏色` 格式，如 `#0A0A0A-#101010|#FFFFFF-#101010`。同一个像素同时命中多个候选颜色时只统计一次。
+
+```typescript
+function 统计颜色数量(
+  图片ID: 字符串,
+  颜色列表: 字符串,
+  阈值: 数字,
+  区域左上角x: 数字,
+  区域左上角y: 数字,
+  区域右下角x: 数字,
+  区域右下角y: 数字,
+): 数字;
+```
+
+**参数：**
+
+| 参数名        | 类型   | 是否必填 | 默认值 | 描述                                                                                  |
+| ------------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------- |
+| `图片ID`      | 字符串 | 是       | -      | 图片 ID，支持 `"screen"`、图片文件路径、HTTP 图片地址或已加载的图片 ID                |
+| `颜色列表`    | 字符串 | 是       | -      | 颜色列表，支持 `主色-偏色\|主色-偏色` 格式，如 `#0A0A0A-#101010\|#FFFFFF-#101010` |
+| `阈值`        | 数字   | 是       | -      | 颜色匹配阈值 (0.0-1.0)，数值越大匹配越严格                                            |
+| `区域左上角x` | 数字   | 是       | -      | 统计区域左上角坐标                                                                    |
+| `区域左上角y` | 数字   | 是       | -      | 统计区域左上角坐标                                                                    |
+| `区域右下角x` | 数字   | 是       | -      | 统计区域右下角坐标；传 `0` 表示延伸到图片右侧边界                                     |
+| `区域右下角y` | 数字   | 是       | -      | 统计区域右下角坐标；传 `0` 表示延伸到图片底部边界                                     |
+
+**返回值：**
+
+| 类型   | 描述                                                                                 |
+| ------ | ------------------------------------------------------------------------------------ |
+| `数字` | 命中目标颜色的像素数量；图片加载失败、颜色为空、颜色格式无效或区域不合法时返回 `0` |
+
+**示例：**
+
+```javascript
+const 图片ID = $图片.截取全屏();
+if (图片ID) {
+  const 数量 = $图片.统计颜色数量(
+    图片ID,
+    "#0A0A0A-#101010|#FFFFFF-#101010",
+    0.92,
+    100,
+    200,
+    500,
+    700,
+  );
+
+  $打印信息日志(`目标区域命中颜色像素数量: ${数量}`);
+  $图片.释放图片(图片ID);
+}
+```
+
 ### 多点比色
 
 ```typescript

package/docs/apicn/paddleocr.md

@@ -202,6 +202,7 @@ function 查找文本(
   图片边界框右下角x坐标?: 数字,
   图片边界框右下角y坐标?: 数字,
   置信度阈值?: 数字,
+  是否完整匹配?: 布尔值,
 ): 数组<OCR识别结果>;
 ```
 
@@ -216,6 +217,7 @@ function 查找文本(
 | `图片边界框右下角x坐标` | number   | 否       | 0      | 查找区域右下角 x 坐标                                                                                                                    |
 | `图片边界框右下角y坐标` | number   | 否       | 0      | 查找区域右下角 y 坐标                                                                                                                    |
 | `置信度阈值`            | number   | 否       | 0.6    | 置信度阈值，默认值为 0.6                                                                                                                 |
+| `是否完整匹配`          | boolean  | 否       | false  | 是否完整匹配；`false` 表示包含匹配，`true` 表示整条 OCR 识别结果文本必须等于目标文本                                                              |
 
 **返回值:**
 
@@ -242,6 +244,7 @@ const 命中结果 = $PaddleOCR.查找文本(
   0,
   0,
   0.6,
+  false,
 );
 if (命中结果.length > 0) {
   命中结果.forEach((item, index) => {
@@ -278,6 +281,7 @@ function 查找文本绝对坐标(
   图片边界框右下角x坐标?: 数字,
   图片边界框右下角y坐标?: 数字,
   置信度阈值?: 数字,
+  是否完整匹配?: 布尔值,
 ): 数组<OCR识别结果>;
 ```