# ext-UmiOCR-Live

**Repository Path**: mind-plus/ext-umi-ocr-live

## Basic Information

- **Project Name**: ext-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**: None

## README

# UmiOCR文字识别 — Mind+ V1 实时模式

基于 Mind+ V1 官方构建模板的独立源码工程。库作者 `wyh`，版本 `0.1.0`。V1 发布包标识：`wyh-umiocr-live-thirdex`（文件名全小写）。

## 快速开始

建议使用 Node.js 16（更高版本需设置 `NODE_OPTIONS=--openssl-legacy-provider`）；在仓库根目录运行：

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

构建产物在 `build/template/`（`config.json` + `javascript/main.js` + 图标）。将该目录打包为 ZIP（根目录直接是 `config.json` 和 `javascript/`，扩展名改为 `.mpext`），即可在 Mind+ V1 实时模式的扩展库中导入。

## 工程目录

`src/index.js`（积木逻辑）、`src/extension-support/`（V1 模板接口）、`template/config.json`（库身份）、`template/javascript/`（图标和语言资源）；`scripts/` 与 `webpack.config.js` 来自 V1 构建模板。`build/` 为本地构建产物，已被 Git 忽略。

## 积木

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

## 使用条件（第三方工具）

- 需自行获取 **Umi-OCR** 桌面程序：[官方发布页](https://github.com/hiroi-sora/Umi-OCR/releases)；因体积原因本仓库不附带。
- 使用前在 Umi-OCR 设置中开启 HTTP 服务（默认端口 1224）；本机服务默认 `http://127.0.0.1:1224/api/ocr`。
- 行空板 M10 上的服务默认 `http://10.1.2.101:1224/api/ocr`，用「设置行空板M10 OCR服务器」积木切换。

## 开发参考

- 开发文档：https://mindplus.dfrobot.com.cn/ext-js
- V1 构建模板：`DFRobot/MindPlusOnlineExtensionDevelopPackage`
- 对应 V2 仓库的 `compatibilityId`（`wyh-umiocr-live-thirdex`）与本库发布包标识一致；两版 `config.json` 不要混用。