references/ppocrv6-guide.md
4.3 KB查看排版效果| 1 | # PP-OCRv6 完整指南 |
| 2 | |
| 3 | > 来源: pdf-ocr-md v3.3.0 SKILL.md F 节 | 更新: 2026-07-30(补充官方版 v3.7.0 + 社区项目新功能) |
| 4 | |
| 5 | ## 概述 |
| 6 | |
| 7 | PaddleOCR 最新 v6 模型家族(官方 v3.7.0, 2026-06-11),使用 ONNX Runtime + DirectML/CoreML 本地推理。 |
| 8 | 三档可选:**Tiny (1.5MB) / Small (7.7MB) / Medium (34.5MB)**。 |
| 9 | |
| 10 | **新特性(vs v3.3.0 知识库)**: |
| 11 | - 🔥 **统一 50 语言模型**:中文/英文/日文 + 46 种拉丁语言,无需切换模型 |
| 12 | - 🔥 **Apple Silicon CoreML 加速**:M 系列芯片自动启用(安装 `onnxruntime-silicon`) |
| 13 | - 🔥 **浏览器端运行**:Tiny 模型通过 ONNX Runtime Web 零依赖运行 |
| 14 | - 🔥 **Web 工作台**:FastAPI + 单页 UI,拖拽上传、批量处理、结果导出(CSV/Markdown/Excel) |
| 15 | |
| 16 | ## 模型来源 |
| 17 | |
| 18 | | 来源 | 链接 | 用途 | |
| 19 | |------|------|------| |
| 20 | | PaddleOCR 官方 | https://github.com/PaddlePaddle/PaddleOCR | 模型研发、论文、v3.7.0 API | |
| 21 | | HuggingFace | https://huggingface.co/collections/PaddlePaddle/pp-ocrv6 | 模型下载 | |
| 22 | | ModelScope | https://www.modelscope.cn/collections/PaddlePaddle/PP-OCRv6 | 模型下载(国内镜像) | |
| 23 | | ppocrv6-studio | https://github.com/andyhuo520/ppocrv6-studio | 本地工作台、Web UI、CoreML 加速 | |
| 24 | |
| 25 | ## 安装 |
| 26 | |
| 27 | ```bash |
| 28 | # 创建虚拟环境并安装 |
| 29 | python3 -m venv ~/.venvs/ppocrv6 |
| 30 | ~/.venvs/ppocrv6/bin/pip install onnxruntime opencv-python-headless numpy Pillow pdf2image |
| 31 | |
| 32 | # macOS Apple Silicon 用户:替换为标准 onnxruntime |
| 33 | ~/.venvs/ppocrv6/bin/pip install onnxruntime-silicon |
| 34 | |
| 35 | # 下载模型(从 ppocrv6-studio GitHub Releases) |
| 36 | bash scripts/download_models.sh all |
| 37 | # 或只下载指定档位: tiny / small / medium |
| 38 | ``` |
| 39 | |
| 40 | ## CLI 命令 |
| 41 | |
| 42 | ```bash |
| 43 | # Tiny 模型(极速,1.5MB,可浏览器运行) |
| 44 | python scripts/pdf_ocr_v6.py input.jpg --tier tiny -o output.txt |
| 45 | |
| 46 | # Small 模型(均衡,7.7MB) |
| 47 | python scripts/pdf_ocr_v6.py input.jpg --tier small -o output.txt |
| 48 | |
| 49 | # Medium 模型(高精度,34.5MB) |
| 50 | python scripts/pdf_ocr_v6.py input.pdf --tier medium -o ./output |
| 51 | |
| 52 | # 指定最低置信度 |
| 53 | python scripts/pdf_ocr_v6.py input.jpg --tier medium --min-conf 0.6 -o output.txt |
| 54 | ``` |
| 55 | |
| 56 | ## 输出 |
| 57 | |
| 58 | ``` |
| 59 | output/ |
| 60 | ├── input.txt ← 纯文本(每页分段) |
| 61 | └── input.json ← 完整结果(含置信度、文本框坐标) |
| 62 | ``` |
| 63 | |
| 64 | ## 模型档位对比 |
| 65 | |
| 66 | | 档位 | 参数量 | 模型大小 | 适用场景 | |
| 67 | |------|--------|---------|---------| |
| 68 | | Tiny | 极轻量 | **1.5 MB** | 快速预览、浏览器端运行、批量处理 | |
| 69 | | Small | 轻量 | **7.7 MB** | 日常使用,性能均衡 | |
| 70 | | Medium | 标准 | **34.5 MB** | 高精度场景(合同/发票/复杂文档) | |
| 71 | |
| 72 | ## 性能参考 |
| 73 | |
| 74 | | 平台 | Tiny | Small | Medium | |
| 75 | |------|------|-------|--------| |
| 76 | | Apple M4 (CoreML) | ~3s | ~8s | ~15s | |
| 77 | | Intel CPU (OpenVINO, 5.2x) | ~6s | ~15s | ~30s | |
| 78 | | Intel CPU (标准) | ~8s | ~15s | ~30s | |
| 79 | | 浏览器 (WASM) | ~12s | — | — | |
| 80 | |
| 81 | > 官方数据:medium 模型在 A100 GPU 上仅需 0.13 秒。 |
| 82 | |
| 83 | ## 文档类型建议 |
| 84 | |
| 85 | | 文档类型 | 推荐档位 | 理由 | |
| 86 | |---------|---------|------| |
| 87 | | 平整扫描件 | Tiny 或 Small | 速度优先 | |
| 88 | | 手机拍照件 | Small | 平衡速度与准确率 | |
| 89 | | 复杂文档/小字 | **Medium** | 精度优先 | |
| 90 | | 点阵字体/轮胎压印 | **Medium** | 边缘场景需最高精度 | |
| 91 | | 多语言文档 | Medium | 统一 50 语言模型需要 medium 档位 | |
| 92 | | 批量处理 | Tiny | 优先速度 | |
| 93 | |
| 94 | ## Web 工作台(新增) |
| 95 | |
| 96 | ppocrv6-studio 提供 FastAPI Web 工作台,适合交互式 OCR: |
| 97 | |
| 98 | ```bash |
| 99 | # 启动 Web 工作台(端口 8765) |
| 100 | python webapp/server.py |
| 101 | ``` |
| 102 | |
| 103 | 功能:拖拽上传、批量处理、剪贴板粘贴、历史记录网格、结果导出(CSV/Markdown/Excel)、模型档位切换、CoreML 开关。 |
| 104 | |
| 105 | ## 浏览器 Demo(新增) |
| 106 | |
| 107 | Tiny 模型可完全在浏览器内运行,无需服务器: |
| 108 | - `ppocrv6_browser.html` — 通过 ONNX Runtime Web 加载,零依赖 |
| 109 | |
| 110 | ## 迁移说明 |
| 111 | |
| 112 | > PP-OCRv6 是比 PP-OCRv4 更轻量、效果更好的新一代模型。 |
| 113 | > 默认 GPU 加速(DirectML / CoreML),CPU 5-6x 提速。无 GPU 时自动回退 CPU。 |
| 114 | > 官方 v3.7.0 (2026-06-11) 发布,旧版 PaddleOCR(PP-OCRv4)管线保留为备选。 |
| 115 | > 准确率参考:OmniDocBench 文本块编辑距离 Medium 0.425 / Small 0.443 / Tiny 0.446(越低越好)。 |
文件内容是平台检查时读出的文本,只供查看。平台不会运行包里的任何脚本或程序。

