ms-vite-plugin 1.4.10 → 1.4.12

package/docs/apicn/pip.md

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

package/docs/apicn/yolo.md

@@ -67,8 +67,9 @@ interface Yolo检测结果 {
 function 加载模型(
   ncnn模型的param文件路径: 字符串,
   ncnn模型的bin文件路径: 字符串,
-  标签数量: 数字,
-  模型版本?: 数字
+  标签数量?: 数字,
+  模型版本?: 数字,
+  useGpu?: 布尔值
 ): 字符串 | null;
 ```
 
@@ -78,8 +79,9 @@ function 加载模型(
 | ------------------------- | ------ | -------- | ------ | ------------------------------------------- |
 | `ncnn模型的param文件路径` | 字符串 | 是       |        | NCNN 模型的 param 文件绝对路径              |
 | `ncnn模型的bin文件路径`   | 字符串 | 是       |        | NCNN 模型的 bin 文件绝对路径                |
-| `标签数量`                | 数字   | 是       |        | 模型的标签数量，可在标签集 data.yaml 中查看 |
+| `标签数量`                | 数字   | 否       | 0      | 模型的标签数量；传 `0` 或省略时根据模型输出自动推断，显式传入但不匹配时检测返回空数组 |
 | `模型版本`                | 数字   | 否       | 11     | YOLO 模型版本号（仅支持 8/11/26）           |
+| `useGpu`                  | 布尔值 | 否       | false  | 是否启用 GPU 加速                           |
 
 **返回值:**
 
@@ -94,8 +96,9 @@ function 加载模型(
 const 模型ID = $YOLO.加载模型(
   "yolov8n_ncnn_model/model.ncnn.param",
   "yolov8n_ncnn_model/model.ncnn.bin",
-  80,
-  8
+  0,
+  8,
+  false
 );
 ```
 
@@ -105,7 +108,8 @@ const 模型ID = $YOLO.加载模型(
 function 加载YOLOv11模型(
   ncnn模型的param文件路径: 字符串,
   ncnn模型的bin文件路径: 字符串,
-  标签数量: 数字
+  标签数量?: 数字,
+  useGpu?: 布尔值
 ): 字符串 | null;
 ```
 
@@ -115,7 +119,8 @@ function 加载YOLOv11模型(
 | ------------------------- | ------ | -------- | ------ | ------------------------------------------- |
 | `ncnn模型的param文件路径` | 字符串 | 是       |        | NCNN 模型的 param 文件绝对路径              |
 | `ncnn模型的bin文件路径`   | 字符串 | 是       |        | NCNN 模型的 bin 文件绝对路径                |
-| `标签数量`                | 数字   | 是       |        | 模型的标签数量，可在标签集 data.yaml 中查看 |
+| `标签数量`                | 数字   | 否       | 0      | 模型的标签数量；传 `0` 或省略时根据模型输出自动推断，显式传入但不匹配时检测返回空数组 |
+| `useGpu`                  | 布尔值 | 否       | false  | 是否启用 GPU 加速                           |
 
 **返回值:**
 
@@ -131,7 +136,8 @@ function 加载YOLOv11模型(
 const 模型ID = $YOLO.加载YOLOv11模型(
   "yolo11n_ncnn_model/model.ncnn.param",
   "yolo11n_ncnn_model/model.ncnn.bin",
-  80 // COCO 数据集有 80 个类别
+  0, // 自动根据模型输出推断类别数量
+  false
 );
 
 if (模型ID) {
@@ -179,7 +185,7 @@ function 目标检测(
 const 模型ID = $YOLO.加载YOLOv11模型(
   "/yolo11n_ncnn_model/model.ncnn.param",
   "/yolo11n_ncnn_model/model.ncnn.bin",
-  80
+  0
 );
 
 if (!模型ID) {
@@ -265,6 +271,41 @@ const fastResults = $YOLO.目标检测(
 $打印信息日志(`快速检测结果: ${fastResults.length} 个物体`);
 ```
 
+#### 目标检测绝对坐标 - 对指定区域执行目标检测，并将结果坐标映射为原图/全屏绝对坐标。
+
+```typescript
+function 目标检测绝对坐标(
+  模型ID: 字符串,
+  图片ID: 字符串,
+  裁剪区域左上角x坐标?: 数字,
+  裁剪区域左上角y坐标?: 数字,
+  裁剪区域右下角x坐标?: 数字,
+  裁剪区域右下角y坐标?: 数字,
+  目标检测输入大小?: 数字,
+  置信度?: 数字,
+  重叠阈值?: 数字
+): 数组<Yolo检测结果>;
+```
+
+**示例:**
+
+```javascript
+const 绝对坐标结果 = $YOLO.目标检测绝对坐标(
+  模型ID,
+  "screen",
+  100,
+  100,
+  500,
+  400,
+  640,
+  0.4,
+  0.5
+);
+if (绝对坐标结果.length > 0) {
+  $点击(绝对坐标结果[0].centerX, 绝对坐标结果[0].centerY);
+}
+```
+
 ### 资源管理
 
 #### 释放模型资源

package/docs/apicn/yolocls.md

@@ -0,0 +1,272 @@
+# YOLO 图像分类模块 ($YOLO分类)
+
+YOLO 图像分类模块基于 YOLOv8-cls / YOLO11-cls / YOLO26-cls 分类模型和 NCNN 框架，提供整图分类、区域分类和模型资源管理能力。
+
+## 功能概览
+
+- **模型管理**: 加载和释放 YOLOv8-cls / YOLO11-cls / YOLO26-cls NCNN 模型
+- **图像分类**: 对屏幕截图、图片文件、HTTP 图片或图片 ID 执行整图分类
+- **区域分类**: 先裁剪指定区域，再对裁剪结果执行分类
+- **结果处理**: 返回 Ultralytics `Probs` 风格的完整概率、top1、top5 和对应置信度
+- **资源控制**: 支持释放单个模型或释放全部已加载模型
+
+## 适用场景
+
+- 判断当前屏幕或图片属于哪个业务类别
+- 对截图中的固定区域进行状态识别
+- 对自定义 YOLO-cls 模型导出的 NCNN 模型执行端侧推理
+
+## 数据结构
+
+### Yolo分类概率结果
+
+YOLO 分类概率结果，字段命名与 Ultralytics `Probs` 保持一致。
+
+```typescript
+interface Yolo分类概率结果 {
+  data: 数组<数字>; // 所有类别概率，下标即类别 ID
+  top1: 数字 | null; // 概率最高的类别 ID
+  top5: 数组<数字>; // 概率最高的 5 个类别 ID
+  top1conf: 数字 | null; // top1 对应的概率
+  top5conf: 数组<数字>; // top5 对应的概率
+}
+```
+
+**字段说明:**
+
+| 字段名     | 类型             | 描述                                                       |
+| ---------- | ---------------- | ---------------------------------------------------------- |
+| `data`     | `数组<数字>`     | 所有类别概率数组，下标即类别 ID                            |
+| `top1`     | `数字 \| null`   | 概率最高的类别 ID；分类失败时为 `null`                     |
+| `top5`     | `数组<数字>`     | 概率最高的 5 个类别 ID，按概率从高到低排序                 |
+| `top1conf` | `数字 \| null`   | `top1` 对应的概率；分类失败时为 `null`                     |
+| `top5conf` | `数组<数字>`     | `top5` 对应的概率，顺序与 `top5` 一致                      |
+
+**结果说明:**
+
+- `top1` 等于 `top5[0]`，`top1conf` 等于 `data[top1]`。
+- 当模型类别数少于 5 时，`top5` 和 `top5conf` 的长度会小于 5。
+- 分类失败时返回空结果：`data`、`top5`、`top5conf` 为空数组，`top1` 和 `top1conf` 为 `null`。
+
+## API 参考
+
+### 模型管理
+
+#### 加载模型 - 加载 YOLO 分类模型（支持 YOLOv8-cls / YOLO11-cls / YOLO26-cls）
+
+加载模型是使用图像分类能力的前提。支持 Ultralytics 官方 YOLOv8-cls、YOLO11-cls、YOLO26-cls 导出的 NCNN 分类模型，常见模型名使用 `-cls` 后缀，例如 `yolov8n-cls`、`yolo11n-cls`、`yolo26n-cls`。
+
+```typescript
+function 加载模型(
+  ncnn模型的param文件路径: 字符串,
+  ncnn模型的bin文件路径: 字符串,
+  类别数量?: 数字,
+  useGpu?: 布尔值
+): 字符串 | null;
+```
+
+**参数:**
+
+| 参数名                    | 类型   | 是否必填 | 默认值 | 描述                                      |
+| ------------------------- | ------ | -------- | ------ | ----------------------------------------- |
+| `ncnn模型的param文件路径` | 字符串 | 是       |        | NCNN 模型的 param 文件路径                |
+| `ncnn模型的bin文件路径`   | 字符串 | 是       |        | NCNN 模型的 bin 文件路径                  |
+| `类别数量`                | 数字   | 否       | 0      | 模型类别数量；传 `0` 或省略时按模型输出自动推断，显式传入但不匹配时分类返回空结果 |
+| `useGpu`                  | 布尔值 | 否       | false  | 是否使用 GPU 推理                         |
+
+**返回值:**
+
+| 类型             | 描述                                      |
+| ---------------- | ----------------------------------------- |
+| `字符串 \| null` | 加载成功返回模型 ID 字符串，失败返回 null |
+
+**示例:**
+
+```javascript
+// 模型文件通常放在 res 目录
+const 模型ID = $YOLO分类.加载模型(
+  "yolo11n_cls_ncnn_model/model.ncnn.param",
+  "yolo11n_cls_ncnn_model/model.ncnn.bin",
+  1000, // ImageNet 分类模型通常为 1000 类
+  false
+);
+
+if (模型ID) {
+  $打印信息日志(`YOLO 分类模型加载成功，ID: ${模型ID}`);
+} else {
+  $打印信息日志("YOLO 分类模型加载失败，请检查模型文件路径和格式");
+}
+```
+
+### 图像分类
+
+#### 图像分类 - 对输入图像执行分类
+
+对整张输入图像执行分类，返回完整概率数组和 top1/top5 结果。
+
+```typescript
+function 图像分类(
+  模型ID: 字符串,
+  图片ID: 字符串,
+  分类输入大小?: 数字
+): Yolo分类概率结果;
+```
+
+**参数:**
+
+| 参数名         | 类型   | 是否必填 | 默认值 | 描述                                                                                                                                         |
+| -------------- | ------ | -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `模型ID`       | 字符串 | 是       |        | 模型 ID（通过 `加载模型` 获取）                                                                                                              |
+| `图片ID`       | 字符串 | 是       |        | 图像输入源：<br>- `"screen"` - 使用当前屏幕截图<br>- `字符串` - 图片文件路径或 HTTP 图片地址<br>- `imageId` - 图片 ID（通过 image 模块获取） |
+| `分类输入大小` | 数字   | 否       | 224    | 分类输入大小，应与模型训练或导出时的输入尺寸一致                                                                                             |
+
+**返回值:**
+
+| 类型                 | 描述                                                |
+| -------------------- | --------------------------------------------------- |
+| `Yolo分类概率结果`   | Ultralytics `Probs` 风格分类结果，包含 top1/top5 等 |
+
+**示例:**
+
+```javascript
+const 模型ID = $YOLO分类.加载模型(
+  "yolo11n_cls_ncnn_model/model.ncnn.param",
+  "yolo11n_cls_ncnn_model/model.ncnn.bin",
+  1000,
+  false
+);
+
+if (!模型ID) {
+  $打印信息日志("模型加载失败");
+  return;
+}
+
+const 概率结果 = $YOLO分类.图像分类(
+  模型ID,
+  "screen", // 使用当前屏幕
+  224 // 分类模型常用输入尺寸
+);
+
+if (概率结果.top1 !== null) {
+  $打印信息日志(`top1 类别ID: ${概率结果.top1}`);
+  $打印信息日志(`top1 置信度: ${(概率结果.top1conf * 100).toFixed(2)}%`);
+} else {
+  $打印信息日志("分类失败或无有效结果");
+}
+
+for (let i = 0; i < 概率结果.top5.length; i++) {
+  $打印信息日志(
+    `top${i + 1}: 类别ID=${概率结果.top5[i]}, 置信度=${概率结果.top5conf[i].toFixed(4)}`
+  );
+}
+
+// 如需读取某个类别的原始概率，可直接访问 data[classId]
+const 类别ID = 0;
+if (概率结果.data.length > 类别ID) {
+  $打印信息日志(`类别 ${类别ID} 概率: ${概率结果.data[类别ID].toFixed(4)}`);
+}
+
+$YOLO分类.释放模型资源(模型ID);
+```
+
+#### 区域分类 - 对指定区域执行分类
+
+先从输入图像中裁剪指定区域，再对裁剪结果执行分类。适合只关心屏幕某个固定区域状态的场景。
+
+```typescript
+function 区域分类(
+  模型ID: 字符串,
+  图片ID: 字符串,
+  裁剪区域左上角x坐标?: 数字,
+  裁剪区域左上角y坐标?: 数字,
+  裁剪区域右下角x坐标?: 数字,
+  裁剪区域右下角y坐标?: 数字,
+  分类输入大小?: 数字
+): Yolo分类概率结果;
+```
+
+**参数:**
+
+| 参数名                   | 类型   | 是否必填 | 默认值 | 描述                                                                                                                                         |
+| ------------------------ | ------ | -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `模型ID`                 | 字符串 | 是       |        | 模型 ID（通过 `加载模型` 获取）                                                                                                              |
+| `图片ID`                 | 字符串 | 是       |        | 图像输入源：<br>- `"screen"` - 使用当前屏幕截图<br>- `字符串` - 图片文件路径或 HTTP 图片地址<br>- `imageId` - 图片 ID（通过 image 模块获取） |
+| `裁剪区域左上角x坐标`   | 数字   | 否       | 0      | 裁剪区域左上角 x 坐标                                                                                                                        |
+| `裁剪区域左上角y坐标`   | 数字   | 否       | 0      | 裁剪区域左上角 y 坐标                                                                                                                        |
+| `裁剪区域右下角x坐标`   | 数字   | 否       | 0      | 裁剪区域右下角 x 坐标                                                                                                                        |
+| `裁剪区域右下角y坐标`   | 数字   | 否       | 0      | 裁剪区域右下角 y 坐标                                                                                                                        |
+| `分类输入大小`           | 数字   | 否       | 224    | 分类输入大小，应与模型训练或导出时的输入尺寸一致                                                                                             |
+
+**返回值:**
+
+| 类型               | 描述                                                |
+| ------------------ | --------------------------------------------------- |
+| `Yolo分类概率结果` | Ultralytics `Probs` 风格分类结果，包含 top1/top5 等 |
+
+**示例:**
+
+```javascript
+const 区域概率结果 = $YOLO分类.区域分类(
+  模型ID,
+  "screen",
+  100,
+  100,
+  500,
+  400,
+  224
+);
+
+if (区域概率结果.top1 !== null) {
+  $打印信息日志(
+    `区域分类 top1=${区域概率结果.top1}, 置信度=${区域概率结果.top1conf.toFixed(4)}`
+  );
+}
+```
+
+### 资源管理
+
+#### 释放模型资源
+
+释放指定分类模型占用的资源。
+
+```typescript
+function 释放模型资源(模型ID: 字符串): 无返回值;
+```
+
+**参数:**
+
+| 参数名   | 类型   | 是否必填 | 默认值 | 描述            |
+| -------- | ------ | -------- | ------ | --------------- |
+| `模型ID` | 字符串 | 是       |        | 要释放的模型 ID |
+
+**示例:**
+
+```javascript
+if (模型ID) {
+  $YOLO分类.释放模型资源(模型ID);
+  $打印信息日志(`YOLO 分类模型 ${模型ID} 资源已释放`);
+}
+```
+
+#### 释放所有模型资源
+
+释放所有已加载的 YOLO 分类模型资源。
+
+```typescript
+function 释放所有模型资源(): 无返回值;
+```
+
+**示例:**
+
+```javascript
+$YOLO分类.释放所有模型资源();
+$打印信息日志("所有 YOLO 分类模型资源已释放");
+```
+
+## 使用注意事项
+
+- `分类输入大小` 默认值为 224，常见 YOLO-cls 模型使用该尺寸；自定义模型请填写训练或导出时使用的输入尺寸。
+- `类别数量` 传 `0` 或省略时会根据模型输出自动推断；显式传入但和模型输出不匹配时返回空结果。
+- `区域分类` 中四个裁剪坐标全部为 `0` 时表示不裁剪，直接对整张图分类。
+- 裁剪区域必须位于图像范围内，并且右下角坐标必须大于左上角坐标。
+- 分类结果中的类别 ID 需要结合训练时的类别列表解释；本模块只返回类别 ID 和概率。