💡 集群版本: 如需更高处理能力，可使用 集群版，支持 macOS 主控 + iOS 设备集群，设备自动发现和弹性扩展。
基于 macOS Vision Framework 的 HTTP OCR 服务，使用 Swift Vapor 框架构建。
- 🔥 原生 macOS Vision Framework OCR 引擎
- 🚀 高性能 Vapor HTTP 服务器
- 📱 支持多种图片格式 (JPG, PNG, TIFF, BMP)
- 🌍 多语言识别支持 (中文、英文等)
- 📊 返回置信度和边界框信息
- 🍺 Homebrew 集成支持
- ⚙️ 系统服务自动管理
- macOS 12.0 (Monterey) 或更高版本
- Xcode Command Line Tools
- Swift 6.0
git clone https://github.com/EnjoyWT/ocrl.git
cd ocrl推荐方式：Homebrew 安装
brew install --build-from-source Formula/ocrs.rb
brew services start ocrs或 脚本安装（仅限本地开发/调试）
chmod +x scripts/install.sh
./scripts/install.sh
ocrs-start两种安装方式任选其一，无需同时执行。
# 健康检查
curl http://localhost:7321/health
# 服务信息
curl http://localhost:7321/api/v1/ocr/info
# OCR 识别 (multipart 上传)
curl -X POST -F "image=@test.jpg" http://localhost:7321/api/v1/ocr
# OCR 识别 (二进制上传)
curl -X POST -H "Content-Type: application/octet-stream" \
--data-binary "@test.jpg" \
"http://localhost:7321/api/v1/ocr?language=zh-CN"GET /health
返回服务状态信息。
GET /api/v1/ocr/info
返回服务配置和支持的功能。
POST /api/v1/ocr
支持的上传方式：
-
Multipart Form Upload
curl -X POST -F "image=@image.jpg" -F "language=zh-CN" \ http://localhost:7321/api/v1/ocr
-
Binary Upload
curl -X POST -H "Content-Type: application/octet-stream" \ --data-binary "@image.jpg" \ "http://localhost:7321/api/v1/ocr?language=zh-CN"
-
JSON Upload
curl -X POST -H "Content-Type: application/json" \ -d '{ "image": "<base64字符串>", "language": "zh-CN", "recognitionLevel": "accurate", "confidence": 0.8 }' \ http://localhost:7321/api/v1/ocr
参数说明：
| 参数 | 类型 | 说明 | 是否必需 |
|---|---|---|---|
| image | 文件/字符串 | 图片文件（multipart/binary）或 base64 字符串（json） | 必需 |
| language | 字符串 | 识别语言，如 zh-CN, en-US | 可选 |
| recognitionLevel | 字符串 | 识别精度（仅 JSON），如 accurate/fast | 可选 |
| confidence | 浮点数 | 置信度阈值（仅 JSON），如 0.8 | 可选 |
响应格式：
{
"status": "success",
"data": {
"text": "识别的文字内容",
"confidence": 0.95,
"processingTime": 120,
"boundingBoxes": [
{
"text": "文字片段",
"confidence": 0.92,
"x": 0.1,
"y": 0.2,
"width": 0.3,
"height": 0.1
}
]
}
}错误响应：
{
"status": "error",
"error": "Invalid image format"
}brew services start ocrs
brew services stop ocrs
brew services list | grep ocrsocrs-start # 启动服务
ocrs-stop # 停止服务
ocrs-status # 检查状态# 标准输出日志
cat /usr/local/var/log/ocrs.log
# 错误日志
cat /usr/local/var/log/ocrs.error.log# 安装依赖
swift package resolve
# 编译
swift build
# 运行
.build/debug/App
# 或者直接运行
swift run Appocrl/
├── Package.swift # Swift Package 配置
├── Sources/App/
│ ├── main.swift # 应用入口
│ ├── configure.swift # 应用配置
│ ├── Controllers/
│ │ └── OCRController.swift # OCR API 控制器
│ ├── Models/
│ │ └── OCRModels.swift # 数据模型
│ └── Services/
│ └── VisionOCRService.swift # Vision OCR 服务
├── scripts/
│ └── install.sh # 安装脚本
└── Formula/
└── ocrs.rb # Homebrew Formula
本项目自带 Homebrew Formula（Formula/ocrs.rb），用于一键安装和注册系统服务。
- 服务名称：
ocrs（所有 brew 命令均用 ocrs） - 安装路径：可执行文件安装为
/usr/local/bin/ocrs - 配置文件：
/usr/local/etc/ocrs/config.json，可自定义 host、port、log_level、max_file_size 等参数 - 日志路径：
- 标准日志：
/usr/local/var/log/ocrs.log - 错误日志：
/usr/local/var/log/ocrs.error.log
- 标准日志：
- 数据目录：
/usr/local/var/ocrs - 服务管理：通过
brew services管理，支持自动重启 - 测试：brew 安装后自动运行健康检查（
/health）
desc/homepage/url/sha256/license：描述、主页、源码包、校验和、许可证depends_on：依赖 macOS Monterey 及 Xcode 13+install：编译并安装可执行文件，生成默认配置service do ... end：定义服务启动命令、工作目录、日志、自动重启test do ... end：安装后自动健康检查
如需修改端口、日志路径等，可编辑 /usr/local/etc/ocrs/config.json，修改后重启服务：
brew services restart ocrs- 查看服务状态：
brew services list | grep ocrs - 查看日志：
cat /usr/local/var/log/ocrs.log cat /usr/local/var/log/ocrs.error.log
- 手动测试服务：
curl http://localhost:7321/health
- 重新安装/修复权限：
brew services stop ocrs brew uninstall ocrs brew install --build-from-source Formula/ocrs.rb brew services start ocrs
欢迎提交 Issue 和 Pull Request！
- 代码遵循 Swift 官方规范
- 提交前运行测试
- 更新相关文档
MIT License
如有问题请提交 GitHub Issue 或联系维护者。
注意： 此服务仅在 macOS 上运行，因为依赖于 Apple 的 Vision Framework。