# ext2-py-cv-api

**Repository Path**: mind-plus/ext2-py-cv-api

## Basic Information

- **Project Name**: ext2-py-cv-api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-26
- **Last Updated**: 2026-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI课程工具箱 - 计算机视觉（aicoursetoolscv）

`aicoursetoolscv` 是一个适用于 Mind+ V2 Python 积木模式的扩展，由爱方思（AiFangSi）同名 Mind+ V1.8 用户库 `ai_course_tools_cv`（计算机视觉）转换而来，配合 AIToolkit2（默认安装于 `C:/AIToolkit2/primary`）与 AI 课程使用。

该扩展提供摄像头调用、图像分类 / 姿态 / 手势 / 人脸 / 图像分割等 MediaPipe 系列模型、YOLO 目标检测训练与推理、OCR 文字识别、二维码编解码、颜色与多边形识别等计算机视觉积木。

本扩展无硬件 SKU，运行依赖本机 AIToolkit2 Python 环境中的 `aitoolkit` 包及 opencv、mediapipe、ultralytics 等库（由 AIToolkit2 安装提供，扩展本身不声明 pip 依赖，与 V1 行为一致）。

## 积木

扩展共 55 个积木，按功能分组（括号内为分组名）：

- 基础组件（Basic）：指定 Python 解释器路径、摄像头接口初始化、摄像头捕获帧事件（帽子积木）、启动简易照相机、显示帧、翻转图像、图像叠加
- 图像分类（Classification）：导入 / 预测 / 获取结果、创建分类数据集、迁移学习训练
- 姿态（Pose）：导入人体姿态模型、姿态检测、求点距
- 手势（Gesture）：手势识别、手部关键点检测
- 人脸（Face）：人脸分析模型加载、人脸库初始化、识别阈值、人脸识别、情绪 / 年龄性别 / 完整分析、人脸检测与对齐
- 图像分割（Segmentation）：分割模型加载与分割、前景背景提取与合并
- YOLO（YOLO）：数据集准备、训练、模型加载、预测、指定类别预测、跟踪、类别与推理信息
- 标注（Annotation）：启动标注工具 LabelImg
- OCR（OCR）：OCR 初始化与识别、完整结果获取
- 二维码（QRCode）：二维码编码与解码
- 颜色（Color）：颜色识别（ROI 与模式可选）
- 多边形（Polygon）：指定边数多边形检测

英文积木文本与中文翻译分别见 `extension/locales/en.json` 与 `extension/locales/zh-cn.json`；下拉菜单含目标类别（人、飞机、自行车等 20 类）、YOLO 模型规格（yolo11n/s/m）、跟踪器（bytetrack/botsort）、是否渲染在白底（True/False）。

## 更新日志

### V2.0.6

- 由 Mind+ V1 用户库 `ai_course_tools_cv` 2.0.6 完整转换为 Mind+ V2 扩展；积木名称、参数、菜单值与生成代码行为保持一致（`compatibilityId: 爱方思-ai_course_tools_cv-thirdex`）

- 更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)