• 计算机视觉
• OCR
• 多模态
• 本地部署
• 模型量化
• 大模型
• 人工智能

MiniCPM-OCR-1.0-gguf是 MiniCPM-OCR 1.0（1.3B 参数文档解析大模型）的 GGUF 量化版本，专为 llama.cpp 推理引擎构建。它能将文档、PDF 中的文本、表格、公式、图表、印章一次性解析成结构化内容，同时支持中英文。本文用官方实测数据对比GPU 与 CPU 的速度差距（1 秒 vs 21 秒），并给出量化档位选择、上下文压缩、GPU 卸载层数等显存优化完整攻略，让新手也能快速把 OCR 文档解析跑起来、跑得快。

📦 为什么选择 GGUF 格式的 OCR 模型？

MiniCPM-OCR 1.0 是一款轻量多模态 OCR 模型，核心能力包括：

• 📄文档解析：正文、标题、段落转 Markdown
• 📊表格识别：复杂表格还原为 HTML 结构
• ➗公式识别：行内与独立公式转 LaTeX
• 🔍关键信息抽取：从票据、证件中提取字段

选择 GGUF 格式的核心好处：

本仓库所有量化文件都基于 MiniCPM-OCR 1.0 原始权重转换而来，Apache 2.0 协议，可自由商用。

🗂️ 模型文件清单：量化档位与体积一览

克隆仓库后即可在根目录拿到全部模型文件：

git clone https://gitcode.com/OpenBMB/MiniCPM-OCR-1.0-gguf

各档位文件与体积如下（每档都必须搭配视觉投影器mmproj使用）：

💡 完整档位建议见 README.md：表格/密集文本/代码密集的 XML 页面优先选Q8_0；Q4_K_M 表格无损，但密集文本有轻微退化，代码密集文档中可能丢失闭合标签斜杠。

🚀 快速上手：两种推理方式

方式一：llama-server 启动本地服务

llama-server \ --model ./MiniCPM-OCR-1_0-Q8_0.gguf \ --mmproj ./mmproj-model-f16-4x.gguf \ --host 0.0.0.0 --port 18499 \ --ctx-size 40960 \ --n-gpu-layers 999

• --n-gpu-layers 999：所有层卸载到 GPU（最快）
• --n-gpu-layers 0：纯 CPU 推理（无显卡时用）

方式二：llama-mtmd-cli 命令行单图识别

llama-mtmd-cli \ -m ./MiniCPM-OCR-1_0-Q8_0.gguf \ --mmproj ./mmproj-model-f16-4x.gguf \ --image page.png -p "Text Recognition:" \ --jinja -ngl 99 -c 8192 --temp 0

常用 Prompt 速查

ℹ️ 内置 chat template 已关闭思考模式，无需额外参数；若自行转换权重，请用--chat-template-kwargs '{"enable_thinking": false}'启动服务。

⚡ GPU vs CPU 性能实测：1 秒对 21 秒

官方在单一 GPU 与纯 CPU 环境下的实测数据如下（引自 README.md 性能章节）：

结论很直观：

1. 🏆 有 GPU 时速度优势巨大——单张表格识别从 21 秒级降到 1 秒级，提速约 20 倍
2. 💻 没有 GPU 也能用，48 线程 CPU 端到端 21 秒完成一张表格图，适合离线批处理
3. ⚠️ F16 精度 + 40960 上下文吃 26 GB 显存，中小显存显卡必须做下面的优化

🎯 显存优化完整攻略

想从 26 GB 压到更低？按优先级做这三件事：

1️⃣ 选对量化档位（收益最大）

从 F16 换到 Q8_0，模型本体直接省约 700 MB，且对表格识别基本无损。

2️⃣ 按需求调小--ctx-size

KV Cache 随上下文长度线性增长。实测数据基于--ctx-size 40960；如果你的页面不大，降到8192甚至4096可以省下大量显存（llama-mtmd-cli示例中-c 8192即为该做法）。

3️⃣ 灵活设置--n-gpu-layers卸载层数

另外注意：视觉投影器 mmproj-model-f16-4x.gguf（0.901 GB）只此一个版本且必须加载，这部分显存是固定开销，选型时要把这 0.9 GB 计入预算。

🚀 进阶加速：DSpark 投机解码

官方还提供 DSpark 草稿模型（GGUF 版），在 llama.cpp 中通过--spec-type draft-dspark启用投机解码，可在不损失质量的前提下进一步降低单页解析延迟。草稿模型需从基础模型仓库的相关 checkpoints 章节获取。

📌 实用小贴士

• ⏳llama-server默认一次只处理一个请求，接 SDK 时请保持queue_mode=serial与max_workers=1
• 📑 整页 PDF 批量解析可使用 SDK 的 llamacpp 后端直连本地服务，输入 PDF、输出 Markdown
• 🧮 代码 / XML 密集的页面请优先 Q8_0，避免低量化档位丢失闭合标签

✅ 总结

MiniCPM-OCR-1.0-gguf 让 1.3B 的文档解析大模型在 llama.cpp 生态里"想怎么跑就怎么跑"：GPU 上 1 秒识别一张表格图，CPU 上 21 秒兜底可用，配合量化档位与上下文优化，显存压力也能压到 8 GB 级别。

• 计算机视觉
• OCR
• 多模态
• 本地部署
• 模型量化
• 大模型
• 人工智能