ms-vite-plugin 1.4.12 → 1.4.14

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

@@ -8,6 +8,7 @@
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
+- **日志显示**：日志模式支持设置日志文字大小
 - **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
 ## API 方法
@@ -54,6 +55,7 @@ function switchToLogMode(): boolean;
 ```typescript
 takeMeToFront();
 const success = pip.switchToLogMode();
+pip.setLogFontSize(10);
 ```
 
 ### switchToKeepAliveMode - 切换到保活模式
@@ -152,6 +154,33 @@ pip.switchToCustomMode();
 pip.setContentSize(120, 180);
 ```
 
+### setLogFontSize - 设置日志文字大小
+
+```typescript
+function setLogFontSize(fontSize: number): boolean;
+```
+
+设置日志模式显示文本的文字大小。该方法只更新日志字号，不会自动切换到日志模式。
+
+**参数：**
+
+| 参数       | 类型     | 必填 | 描述                     |
+| ---------- | -------- | ---- | ------------------------ |
+| `fontSize` | `number` | 是   | 日志字号，必须是有效数字 |
+
+**返回值：**
+
+| 类型      | 描述                                                       |
+| --------- | ---------------------------------------------------------- |
+| `boolean` | `true` 代表日志文字大小已提交；`false` 代表字号无效 |
+
+**示例：**
+
+```typescript
+pip.setLogFontSize(10);
+pip.switchToLogMode();
+```
+
 ### setCustomText - 设置自定义文本
 
 ```typescript
@@ -267,6 +296,7 @@ takeMeToFront();
 
 pip.switchToLogMode();
 pip.setContentSize(280, 120);
+pip.setLogFontSize(10);
 
 pip.setCustomText("任务运行中\n1/3");
 pip.setCustomTextColor("#34c759");
@@ -282,7 +312,8 @@ pip.setContentSize(120, 180);
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
 3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
 4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸
-5. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
+5. **日志字号**：日志字号只影响日志模式，保活模式和自定义模式不受影响
+6. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
 
 ## 故障排除
 

package/docs/api/tomatoocr.md

@@ -396,6 +396,30 @@ const result = tomatoOcr.findTapPoints(“确定”);
 logi(result);
 ```
 
+### 资源释放方法
+
+#### `release`
+
+释放 TomatoOCR SDK 已加载的 OCR 模型和内部资源。
+
+```typescript
+function release(): void;
+```
+
+**参数:**
+
+无
+
+**返回值:**
+
+无
+
+**示例:**
+
+```typescript
+tomatoOcr.release();
+```
+
 ## 完整示例
 
 ```typescript
@@ -417,6 +441,9 @@ logi("识别结果:" + ocrResult);
 // 查找点击点
 const tapResult = tomatoOcr.findTapPoint("登录");
 logi("点击点坐标:" + tapResult);
+
+// 释放 TomatoOCR 资源
+tomatoOcr.release();
 ```
 
 ## 注意事项

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识别结果>;
 ```
 

package/docs/apicn/pip.md

@@ -8,6 +8,7 @@
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
+- **日志显示**：日志模式支持设置日志文字大小
 - **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
 ## API 方法
@@ -54,6 +55,7 @@ function 切换到日志模式(): 布尔值;
 ```typescript
 $APP切入前台();
 const 是否成功 = $悬浮窗.切换到日志模式();
+$悬浮窗.设置日志文字大小(10);
 ```
 
 ### 切换到保活模式
@@ -152,6 +154,33 @@ $悬浮窗.切换到自定义模式();
 $悬浮窗.设置内容尺寸(120, 180);
 ```
 
+### 设置日志文字大小
+
+```typescript
+function 设置日志文字大小(字号: 数字): 布尔值;
+```
+
+设置日志模式显示文本的文字大小。该方法只更新日志字号，不会自动切换到日志模式。
+
+**参数：**
+
+| 参数   | 类型   | 必填 | 描述                     |
+| ------ | ------ | ---- | ------------------------ |
+| `字号` | `数字` | 是   | 日志字号，必须是有效数字 |
+
+**返回值：**
+
+| 类型     | 描述                                                     |
+| -------- | -------------------------------------------------------- |
+| `布尔值` | `true` 代表日志文字大小已提交；`false` 代表字号无效 |
+
+**示例：**
+
+```typescript
+$悬浮窗.设置日志文字大小(10);
+$悬浮窗.切换到日志模式();
+```
+
 ### 设置自定义文本
 
 ```typescript
@@ -267,6 +296,7 @@ $APP切入前台();
 
 $悬浮窗.切换到日志模式();
 $悬浮窗.设置内容尺寸(280, 120);
+$悬浮窗.设置日志文字大小(10);
 
 $悬浮窗.设置自定义文本("任务运行中\n1/3");
 $悬浮窗.设置自定义文字颜色("#34c759");
@@ -282,7 +312,8 @@ $悬浮窗.设置内容尺寸(120, 180);
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
 3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
 4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸
-5. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
+5. **日志字号**：日志字号只影响日志模式，保活模式和自定义模式不受影响
+6. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
 
 ## 故障排除
 

package/docs/apipython/appleocr.md

@@ -227,7 +227,7 @@ if abs_number_results:
 
 #### findText
 
-执行指定文本查找，在识别结果中查找特定的文本内容。使用全字匹配模式，确保精确匹配目标文本。
+执行指定文本查找，在识别结果中查找目标子串，并返回目标子串的坐标。
 
 ```python
 def findText(
@@ -237,7 +237,8 @@ def findText(
     y: int = 0,
     ex: int = 0,
     ey: int = 0,
-    languages: Optional[List[str]] = ["zh-Hans", "en-US"]
+    languages: Optional[List[str]] = ["zh-Hans", "en-US"],
+    exactMatch: bool = False
 ) -> List[OCRResult]
 ```
 
@@ -246,26 +247,29 @@ def findText(
 | 参数名      | 类型      | 是否必填 | 默认值               | 描述                                                                                                                              |
 | ----------- | --------- | -------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
 | `input`     | str       | 是       | -                    | 输入源，支持以下类型： <br>-`"screen"` 当前屏幕截图 <br>- `str` 图片文件路径或 URL <br>- `imageId` 图片 ID（通过 image 模块获取） |
-| `texts`     | List[str] | 是       | -                    | 要查找的文本数组                                                                                                                  |
+| `texts`     | List[str] | 是       | -                    | 要查找的目标文本数组，支持匹配识别结果中的子串                                                                                    |
 | `x`         | int       | 否       | 0                    | 识别区域左上角 x 坐标                                                                                                             |
 | `y`         | int       | 否       | 0                    | 识别区域左上角 y 坐标                                                                                                             |
 | `ex`        | int       | 否       | 0                    | 识别区域右下角 x 坐标                                                                                                             |
 | `ey`        | int       | 否       | 0                    | 识别区域右下角 y 坐标                                                                                                             |
 | `languages` | List[str] | 否       | ["zh-Hans", "en-US"] | 可选，指定识别语言列表，如 `["zh-Hans", "en-US"]`                                                                                 |
+| `exactMatch` | bool     | 否       | False                | 是否完整匹配；`False` 表示包含匹配，`True` 表示整条 OCR 识别结果文本必须等于目标文本                                                       |
 
 **返回值:**
 
 | 类型              | 描述                   |
 | ----------------- | ---------------------- |
-| `List[OCRResult]` | 匹配的文本识别结果数组 |
+| `List[OCRResult]` | 命中子串的文本识别结果数组 |
 
 **使用示例:**
 
 ```python
 from kuaijs import appleocr
 
-# 识别屏幕中的文本
-text_results = appleocr.findText("screen", ["123", "456"], 0, 0, 100, 100)
+# 在“开始执行”中查找“开始”，返回“开始”子串区域
+text_results = appleocr.findText("screen", ["开始"], 0, 0, 100, 100)
+# 启用完整匹配时，只有整条 OCR 识别结果文本等于“开始”才返回结果
+exact_results = appleocr.findText("screen", ["开始"], 0, 0, 100, 100, None, True)
 print(f"识别到 {len(text_results)} 个文本区域")
 
 for i, result in enumerate(text_results):
@@ -274,7 +278,7 @@ for i, result in enumerate(text_results):
     print(f"中心点: ({result.centerX}, {result.centerY})")
 ```
 
-#### `findTextAbs` - 查找目标文本，并将结果坐标映射为原图/全屏绝对坐标
+#### `findTextAbs` - 查找目标子串，并将子串结果坐标映射为原图/全屏绝对坐标
 
 参数与 `findText` 相同。传入裁剪区域时，返回坐标可直接用于全屏点击。
 
@@ -286,7 +290,8 @@ def findTextAbs(
     y: int = 0,
     ex: int = 0,
     ey: int = 0,
-    languages: Optional[List[str]] = None
+    languages: Optional[List[str]] = None,
+    exactMatch: bool = False
 ) -> List[OCRResult]
 ```
 
@@ -295,7 +300,7 @@ def findTextAbs(
 ```python
 from kuaijs import appleocr, action
 
-abs_hits = appleocr.findTextAbs("screen", ["确定"], 100, 100, 500, 400)
+abs_hits = appleocr.findTextAbs("screen", ["开始"], 100, 100, 500, 400)
 if abs_hits:
     action.click(abs_hits[0]["centerX"], abs_hits[0]["centerY"])
 ```

package/docs/apipython/image.md

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

package/docs/apipython/paddleocr.md

@@ -172,7 +172,8 @@ def findText(
     y: int = 0,
     ex: int = 0,
     ey: int = 0,
-    confidenceThreshold: float = 0.6
+    confidenceThreshold: float = 0.6,
+    exactMatch: bool = False
 ) -> List[OCRResult]
 ```
 
@@ -187,6 +188,7 @@ def findText(
 | `ex`                  | int       | 否       | 0      | 查找区域右下角 x 坐标                                                                                                         |
 | `ey`                  | int       | 否       | 0      | 查找区域右下角 y 坐标                                                                                                         |
 | `confidenceThreshold` | float     | 否       | 0.6    | 置信度阈值，默认值为 0.6                                                                                                      |
+| `exactMatch`          | bool      | 否       | False  | 是否完整匹配；`False` 表示包含匹配，`True` 表示整条 OCR 识别结果文本必须等于目标文本                                                   |
 
 **返回值：**
 
@@ -204,7 +206,7 @@ if not paddleocr.loadV5():
     print("模型加载失败")
 else:
     # 在整个屏幕中查找目标文本
-    hit_results = paddleocr.findText("screen", ["登录", "确定"], 0, 0, 0, 0, 0.6)
+    hit_results = paddleocr.findText("screen", ["登录", "确定"], 0, 0, 0, 0, 0.6, False)
     if hit_results:
         for i, r in enumerate(hit_results, 1):
             print(f"命中{i}: {r.text}, 中心点=({r.centerX}, {r.centerY}), 置信度={r.confidence}")
@@ -228,14 +230,15 @@ def findTextAbs(
     y: int = 0,
     ex: int = 0,
     ey: int = 0,
-    confidenceThreshold: float = 0.6
+    confidenceThreshold: float = 0.6,
+    exactMatch: bool = False
 ) -> List[OCRResult]
 ```
 
 **示例：**
 
 ```python
-abs_hits = paddleocr.findTextAbs("screen", ["确定"], 100, 100, 500, 400, 0.6)
+abs_hits = paddleocr.findTextAbs("screen", ["确定"], 100, 100, 500, 400, 0.6, False)
 if abs_hits:
     print(f"绝对坐标中心点: ({abs_hits[0].centerX}, {abs_hits[0].centerY})")
 ```

package/docs/apipython/pip.md

@@ -8,6 +8,7 @@
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
+- **日志显示**：日志模式支持设置日志文字大小
 - **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
 ## API 参考
@@ -56,6 +57,7 @@ from kuaijs import pip, utils
 
 utils.takeMeToFront()
 success = pip.switchToLogMode()
+pip.setLogFontSize(10)
 ```
 
 ### switchToKeepAliveMode - 切换到保活模式
@@ -162,6 +164,35 @@ pip.switchToCustomMode()
 pip.setContentSize(120, 180)
 ```
 
+### setLogFontSize - 设置日志文字大小
+
+设置日志模式显示文本的文字大小。该方法只更新日志字号，不会自动切换到日志模式。
+
+```python
+def setLogFontSize(fontSize: float) -> bool
+```
+
+**参数：**
+
+| 参数       | 类型    | 必填 | 描述                     |
+| ---------- | ------- | ---- | ------------------------ |
+| `fontSize` | `float` | 是   | 日志字号，必须是有效数字 |
+
+**返回值：**
+
+| 类型   | 描述                                                    |
+| ------ | ------------------------------------------------------- |
+| `bool` | `True` 代表日志文字大小已提交；`False` 代表字号无效 |
+
+**示例：**
+
+```python
+from kuaijs import pip
+
+pip.setLogFontSize(10)
+pip.switchToLogMode()
+```
+
 ### setCustomText - 设置自定义文本
 
 设置自定义模式显示的纯文本内容。该方法只更新自定义文本数据，不会自动切换到自定义模式。
@@ -287,6 +318,7 @@ utils.takeMeToFront()
 
 pip.switchToLogMode()
 pip.setContentSize(280, 120)
+pip.setLogFontSize(10)
 
 pip.setCustomText("任务运行中\n1/3")
 pip.setCustomTextColor("#34c759")
@@ -302,7 +334,8 @@ pip.setContentSize(120, 180)
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
 3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
 4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸
-5. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
+5. **日志字号**：日志字号只影响日志模式，保活模式和自定义模式不受影响
+6. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
 
 ## 故障排除
 

package/docs/apipython/tomatoocr.md

@@ -413,6 +413,31 @@ result = tomatoocr.findTapPoints("确定")
 print(result)
 ```
 
+### 资源释放方法
+
+#### `release`
+
+释放 TomatoOCR SDK 已加载的 OCR 模型和内部资源。
+
+```python
+def release() -> None
+```
+
+**参数：**
+
+无
+
+**返回值：**
+
+无
+
+**示例：**
+
+```python
+from kuaijs import tomatoocr
+tomatoocr.release()
+```
+
 ## 完整示例
 
 ```python
@@ -436,6 +461,9 @@ print("识别结果:" + ocr_result)
 # 查找点击点
 tap_result = tomatoocr.findTapPoint("登录")
 print("点击点坐标:" + tap_result)
+
+# 释放 TomatoOCR 资源
+tomatoocr.release()
 ```
 
 ## 注意事项

package/package.json

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