# ext2-ul-UmiOCR-Live

**Repository Path**: mind-plus/ext2-ul-umi-ocr-live

## Basic Information

- **Project Name**: ext2-ul-UmiOCR-Live
- **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-13
- **Last Updated**: 2026-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# UmiOCR文字识别

![cover](extension/public/cover.png)

`UmiOCRLive` 是一个适用于 Mind+ V2 实时模式的扩展（通过 HTTP 接口调用本机或行空板 M10 上的 Umi-OCR 服务，实现离线文字识别）。
该扩展共提供 5 个积木，运行环境要求见下方“运行环境”。

## 源码仓库

V1 原始仓库：（与 V2 一同发布，发布后补充链接）

## 运行环境

- Umi-OCR 桌面程序：从[官方发布页](https://github.com/hiroi-sora/Umi-OCR/releases)获取（本仓库不附带，体积与授权原因），并在其设置中开启 HTTP 服务（默认端口 1224）。
- 本机服务默认 `http://127.0.0.1:1224/api/ocr`；行空板 M10 服务默认 `http://10.1.2.101:1224/api/ocr`，可用对应积木切换。

## 积木

| 类型 | 积木功能 |
|---|---|
| 命令 | 设置本机OCR服务器 [URLADR] |
| 命令 | 设置行空板M10 OCR服务器 [URLADRR] |
| 命令 | OCR识别文件 [IMGPATH] |
| 命令 | OCR识别base64图片 [BASE64DATA] |
| 数值 | 识别结果 |

## 示例程序

1. 启动 Umi-OCR 并在其设置中开启 HTTP 服务（默认端口 1224）。
2. 在 Mind+ V2 实时模式的扩展库中加载本扩展，点击扩展卡片启用分类。
3. 如使用行空板 M10 上的服务，先用「设置行空板M10 OCR服务器」切换地址。
4. 用「OCR识别文件」传入图片完整路径，或用「OCR识别base64图片」传入图片数据，再用「识别结果」读取文字。

> 注意：以上步骤基于积木定义与 Umi-OCR HTTP 接口整理，实际识别效果需连上服务后实测。

## 本地构建

```bash
npm ci
npm run build
```

构建产物在 `build/ext-wyh-UmiOCRLive@2.0.0/`，可在 Mind+ V2 开发者模式直接加载其中的 `config.json`。

## 更新日志

### V2.0.0

- 迁移到 Mind+ V2 实时模式，积木 opcode、参数与默认值与 V1 保持一致。
- 补充 `compatibilityId` 兼容字段，统一积木配色。

## 开发指南

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

## V1 原始库来源

本库迁移自 Mind+ V1（1.x）用户库，保留 `compatibilityId` 字段以兼容旧版工程。

- compatibilityId：`wyh-umiocr-live-thirdex`
- 原作者：wyh
- 原始仓库：https://gitee.com/mind-plus/ext-umi-ocr-live