Umi-OCR 双层PDF转换实战指南五步把扫描件变成可搜索文档【免费下载链接】Umi-OCROCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片PDF文档识别排除水印/页眉页脚扫描/生成二维码。内置多国语言库。项目地址: https://gitcode.com/GitHub_Trending/um/Umi-OCR你是否遇到过这样的困境手里有一份几十页的扫描版PDF想复制其中一段文字得到的却是一张张看不懂的图片想用关键词搜索某个条款CtrlF 按了半天毫无反应。把扫描件发给同事对方也只能一页页肉眼翻阅。传统的OCR工具往往只给你一段纯文本排版乱了、图表丢了改起来比重新打一遍还费劲。Umi-OCR是一款免费、开源、完全离线的OCR软件它的双层PDF转换功能恰好解决了这个痛点生成一种同时包含原始扫描图像层和透明可搜索文本层的PDF既保留原件的视觉还原度又让文字可复制、可检索、可批注。本文将以完整的操作流程为主线带你把扫描件一键变成可搜索文档再深入拆解它背后的实现原理。图1Umi-OCR 批量识别界面支持拖入多个文档并行处理进度一目了然一、痛点切入扫描PDF为什么中看不中用先还原一个真实场景。行政部门的同事收到一份上级下发的红头文件扫描件需要提取其中的联系人信息录入系统。她打开PDF选中、复制、粘贴——粘贴出来是空白。用截图软件截下来丢给在线OCR网站十几页传完弹出一个弹窗今日免费额度已用完。这就是扫描版PDF的三大痛点不可检索整份文档本质是一张张大图CtrlF 形同虚设找一句话要翻遍几十页不可复制文字无法选中更不能直接引用到文档或邮件中隐私与效率风险把涉密或商业文件上传到云端OCR服务既担心数据安全又受限于网速和额度。而双层PDF也叫可搜索PDF正是为这类场景而生。它像一个数字三明治底层是原始扫描图像保证视觉上和原件一模一样顶层是透明文字肉眼看不见却能被搜索、选中和复制。两层共享同一套坐标体系所以文字位置和图像内容严丝合缝。二、快速上手一分钟跑通你的第一份双层PDF在深入了解原理之前先建立信心。整个流程只需要四步解压即用从项目发布页下载Umi-OCR_Rapid_v2.1.5.7z并解压如需从源码自行构建可 clonehttps://gitcode.com/GitHub_Trending/um/Umi-OCR仓库运行主程序切换到批量文档标签页把扫描版PDF直接拖进窗口确认保存格式为默认的双层可搜索PDF点击开始任务等待处理完成在输出目录找到文件名形如xxx.layered.pdf的新文件用PDF阅读器打开按下 CtrlF 输入任意关键词——能搜到了。没错默认配置下你甚至不需要改任何参数。这份文档的文本层已经被嵌入可以复制、搜索、批注而外观和原扫描件几乎完全一致。三、实战演示五步完成专业级批量转换快速跑通之后我们来处理一份真实的、混合了图文、页眉页脚、甚至带旋转页面的复杂文档。按以下五步操作能显著提升转换质量。第一步准备与导入在批量文档标签页点击添加文件或直接拖入文档。Umi-OCR 的文档识别支持pdf、xps、epub、mobi、fb2、cbz等多种格式见 UmiOCR-data/py_src/mission/mission_doc.py可以多选批量导入。如果PDF有密码可以在任务参数中填写程序会自动尝试解密。第二步定制识别模式在右侧设置面板中选择识别内容模式这是影响结果的关键参数模式适用场景混合OCR/拷贝文本默认普通扫描件已有文字层则直接复用图片区域单独OCR整页强制OCR全部重新识别适合纯扫描、无文字层的文档仅OCR图片只要文档中的插图、截图里的文字仅拷贝原有文本电子版PDF直接提取文字速度快、零识别误差同时设置识别语言如中文英文和段落合并模式建议智能合并或自然段合并避免换行处被拆成碎片。第三步处理干扰内容扫描件常见的干扰是页眉、页脚、水印、页码。在忽略区域中框选这些区域并指定生效的页码范围如第1页到第50页识别时这些区域的文字会被自动过滤避免污染正文。第四步执行任务与监控确认输出目录建议选择非系统盘避免权限问题点击开始任务。通过进度条和实时日志观察文本层生成与PDF合成阶段。v2.1.5 版本新增了日志机制任务中的异常会写入UmiOCR-data/logs目录方便事后排查见 CHANGE_LOG.md。第五步结果验证打开生成的xxx.layered.pdf从三个维度验收可搜索性CtrlF 搜索正文关键词能命中并定位格式保真对比原扫描件图像清晰度、版面位置应基本一致文本准确随机抽取5~10处文字与原件人工比对。图2全局设置界面可配置引擎内存上限等参数为大型PDF转换留出资源空间四、技术拆解双层PDF是怎么叠出来的了解完操作我们来回答为什么能这样。整个过程可以概括为一条流水线解析文档 → 提取图像与文本 → OCR补全 → 排版解析 → 写入双层PDF。4.1 三大核心组件PyMuPDFfitz负责PDF的解析、渲染、写入是整个流程的骨架PaddleOCR 引擎离线深度学习模型负责把图像中的文字识别为带坐标的文本块TBPU 文本块后处理模块位于 UmiOCR-data/py_src/ocr/tbpu/负责段落合并、忽略区域过滤等排版理解工作。4.2 页面处理流水线以默认的混合模式为例每一页的处理流程如下对应 mission_doc.py解析页面元素用page.get_text()遍历页面把内容分成图片区块和文本区块两类复用原有文字如果PDF本身带有文字层电子版转存而来直接提取其文字和坐标标记来源为from: text不重复识别又快又准OCR补全图像把扫描的图片区块提交给OCR引擎得到识别文字及其坐标框再将坐标从图片相对坐标系换算回页面绝对坐标系旋转校正页面有旋转角度时通过变换矩阵提取旋转角对文字框和图片做逆向校正——这正是 v2.1.2 修复的坐标旋转、比例适配问题排版解析TBPU 模块对文本块做段落合并、忽略区域过滤输出结构化的文本块列表。4.3 双层写入的数字三明治最后一步写入由 output_pdf_layered.py 完成。核心逻辑可以浓缩为如下伪代码# 双层PDF写入核心逻辑简化自 output_pdf_layered.py for page in pdf: for tb in 文本块列表: # 双层模式下跳过直接提取的文本只写入OCR文本避免重复 if 透明模式 and tb来自原有文本: continue w, h 文本框的宽和高 # 自动计算字号先假设等于行高再反复微调让文字刚好填满文本框 fontsize 计算适配字号(text, w, h) # 在文本框左下角插入透明文字opacity0肉眼不可见但可选中 page.insert_text( 旋转后的插入点, text, fontsizefontsize, fontnamecjk, # 内置CJK字体支持中英文 rotate页面旋转角, stroke_opacity0, # 描边透明度 0 fill_opacity0, # 填充透明度 0 )几个值得注意的工程细节透明文本opacity0让文本层完全不可见用户看到的是底层图像但选中工具仍能抓住顶层的文字内置CJK字体加载fitz.Font(cjk)中文字体并嵌入页面确保中文不乱码、跨平台可显示字号自适配_calculateFontSize()以文本框高度为初值通过二分逼近找出刚好填满框宽的字号让文字位置和视觉图像精准对齐字体子集化任务结束时调用subset_fonts()仅保留用到的字符显著压缩文件体积再以deflate压缩保存平衡清晰度与大小。4.4 版本演进时间轴双层PDF功能并非一蹴而就从 CHANGE_LOG.md 可以看到清晰的迭代脉络v2.1.0 (2024.2) 新增批量文档识别支持 pdf/epub/mobi 等格式 v2.1.1 (2024.3) 优化保存双层PDF时无新文本写入的处理逻辑 v2.1.2 (2024.6) 修复文档提取/写入的坐标旋转与比例适配问题 新增单层纯文本PDF保存格式 v2.1.3 (2024.7) 优化单栏-单行排版解析相邻文本块自动补空格 v2.1.5 (2025.3) 修复提取PDF自带文本时未考虑页面旋转的问题 修复单层PDF未写入原PDF自带文本的问题每一个小版本都在修正同一个核心矛盾让文本层的坐标、字号、旋转与底层图像严丝合缝。五、避坑指南常见问题与解决策略实际使用中以下几类问题出现频率最高按下面的诊断分支处理基本都能解决开始诊断 │ ├─ 文字与图像错位 │ ├─ 版本检查 → 低于 v2.1.5 请先更新旋转坐标问题已在v2.1.5修复 │ ├─ 改用整页强制OCR模式跳过原有文字层的坐标换算 │ └─ 确认文档页面的旋转角度未被阅读器临时设置 │ ├─ 生成的文件体积过大 │ ├─ 检查是否嵌入了完整字体 → 程序已自动子集化若仍偏大 │ └─ 用其他工具降低底层图像的分辨率后再转换 │ ├─ 识别准确率不理想 │ ├─ 语言设置 → 确认勾选了正确的语言组合如中文英文 │ ├─ 倾斜/暗角扫描件 → 先用图像预处理工具增强对比度 │ └─ 页面复杂 → 换用智能合并段落模式减少断句 │ └─ 转换失败或卡住 ├─ 文件检查 → 验证PDF是否加密损坏、密码是否正确 ├─ 资源监控 → 关闭其他高占用程序并在全局设置中调低OCR引擎内存上限 └─ 日志分析 → 查看 UmiOCR-data/logs 目录中的错误日志定位原因两个容易被忽略的高频坑加密文档带打开密码的PDF会直接报错务必在任务参数中填写密码只限制了复制/打印权限的文档则一般不受影响仅提取文本模式下的卡顿v2.1.x 中仅拷贝原有文本模式处理极快频繁回调可能拖慢界面程序会故意引入最小间隔来保护UI属正常现象不是卡死。六、发散延展双层PDF的进阶玩法与演进方向掌握了基础转换双层PDF的可搜索能力还能撬动更多场景。6.1 构建个人知识库把积攒多年的纸质书扫描件、合同、票据统一转成双层PDF再用支持全文搜索的阅读器或网盘工具索引。从此找资料不再是翻箱倒柜而是秒级定位。教育场景下教师可以把教材扫描件转成双层PDF保留原始排版与图表同时支持学生搜索、批注不破坏原版内容。6.2 用命令行与HTTP接口自动化Umi-OCR 不只是图形软件。参考官方文档 docs/README_CLI.md 和 docs/http/api_doc.md可以通过命令行或HTTP接口批量提交文档识别任务默认保存格式即为双层可搜索PDF。这对需要定时处理大量扫描件的企业场景尤为实用——例如把法律合同或历史档案扫描件批量入库保留原始签章的同时实现关键条款的快速检索与多版本比对。6.3 未来方向从更新日志看项目仍在持续打磨识别精度、布局解析与多语言支持。可以期待的方向包括更智能的版面分析如多栏报纸、表格结构、更细粒度的忽略区域控制以及对手写体、复杂混合排版的识别优化。无论是个人还是团队提前掌握双层PDF这项技能都能让数字化办公的效率迈上一个台阶。总结Umi-OCR 的双层PDF转换用底层图像 透明文本的双图层架构化解了扫描文档看得见却摸不着的世纪难题。本文带你走完了从导入、配置、执行到验收的完整流程也剖析了其背后 PyMuPDF、PaddleOCR 与 TBPU 三大组件如何协作并给出了常见问题的排查路径。如果你想获取更多技术细节或跟进新功能官方更新日志 CHANGE_LOG.md 是了解版本演进的最佳入口动手试一次你就能体会到扫描件秒变可搜索文档的畅快。【免费下载链接】Umi-OCROCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片PDF文档识别排除水印/页眉页脚扫描/生成二维码。内置多国语言库。项目地址: https://gitcode.com/GitHub_Trending/um/Umi-OCR创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/8/16 12:24:50 · 阅读 1.2k Umi-OCR 双层PDF转换实战指南：五步把扫描件变成可搜索文档
Umi-OCR 双层PDF转换实战指南五步把扫描件变成可搜索文档【免费下载链接】Umi-OCROCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片PDF文档识别排除水印/页眉页脚扫描/生成二维码。内置多国语言库。项目地址: https://gitcode.com/GitHub_Trending/um/Umi-OCR你是否遇到过这样的困境手里有一份几十页的扫描版PDF想复制其中一段文字得到的却是一张张看不懂的图片想用关键词搜索某个条款CtrlF 按了半天毫无反应。把扫描件发给同事对方也只能一页页肉眼翻阅。传统的OCR工具往往只给你一段纯文本排版乱了、图表丢了改起来比重新打一遍还费劲。Umi-OCR是一款免费、开源、完全离线的OCR软件它的双层PDF转换功能恰好解决了这个痛点生成一种同时包含原始扫描图像层和透明可搜索文本层的PDF既保留原件的视觉还原度又让文字可复制、可检索、可批注。本文将以完整的操作流程为主线带你把扫描件一键变成可搜索文档再深入拆解它背后的实现原理。图1Umi-OCR 批量识别界面支持拖入多个文档并行处理进度一目了然一、痛点切入扫描PDF为什么中看不中用先还原一个真实场景。行政部门的同事收到一份上级下发的红头文件扫描件需要提取其中的联系人信息录入系统。她打开PDF选中、复制、粘贴——粘贴出来是空白。用截图软件截下来丢给在线OCR网站十几页传完弹出一个弹窗今日免费额度已用完。这就是扫描版PDF的三大痛点不可检索整份文档本质是一张张大图CtrlF 形同虚设找一句话要翻遍几十页不可复制文字无法选中更不能直接引用到文档或邮件中隐私与效率风险把涉密或商业文件上传到云端OCR服务既担心数据安全又受限于网速和额度。而双层PDF也叫可搜索PDF正是为这类场景而生。它像一个数字三明治底层是原始扫描图像保证视觉上和原件一模一样顶层是透明文字肉眼看不见却能被搜索、选中和复制。两层共享同一套坐标体系所以文字位置和图像内容严丝合缝。二、快速上手一分钟跑通你的第一份双层PDF在深入了解原理之前先建立信心。整个流程只需要四步解压即用从项目发布页下载Umi-OCR_Rapid_v2.1.5.7z并解压如需从源码自行构建可 clonehttps://gitcode.com/GitHub_Trending/um/Umi-OCR仓库运行主程序切换到批量文档标签页把扫描版PDF直接拖进窗口确认保存格式为默认的双层可搜索PDF点击开始任务等待处理完成在输出目录找到文件名形如xxx.layered.pdf的新文件用PDF阅读器打开按下 CtrlF 输入任意关键词——能搜到了。没错默认配置下你甚至不需要改任何参数。这份文档的文本层已经被嵌入可以复制、搜索、批注而外观和原扫描件几乎完全一致。三、实战演示五步完成专业级批量转换快速跑通之后我们来处理一份真实的、混合了图文、页眉页脚、甚至带旋转页面的复杂文档。按以下五步操作能显著提升转换质量。第一步准备与导入在批量文档标签页点击添加文件或直接拖入文档。Umi-OCR 的文档识别支持pdf、xps、epub、mobi、fb2、cbz等多种格式见 UmiOCR-data/py_src/mission/mission_doc.py可以多选批量导入。如果PDF有密码可以在任务参数中填写程序会自动尝试解密。第二步定制识别模式在右侧设置面板中选择识别内容模式这是影响结果的关键参数模式适用场景混合OCR/拷贝文本默认普通扫描件已有文字层则直接复用图片区域单独OCR整页强制OCR全部重新识别适合纯扫描、无文字层的文档仅OCR图片只要文档中的插图、截图里的文字仅拷贝原有文本电子版PDF直接提取文字速度快、零识别误差同时设置识别语言如中文英文和段落合并模式建议智能合并或自然段合并避免换行处被拆成碎片。第三步处理干扰内容扫描件常见的干扰是页眉、页脚、水印、页码。在忽略区域中框选这些区域并指定生效的页码范围如第1页到第50页识别时这些区域的文字会被自动过滤避免污染正文。第四步执行任务与监控确认输出目录建议选择非系统盘避免权限问题点击开始任务。通过进度条和实时日志观察文本层生成与PDF合成阶段。v2.1.5 版本新增了日志机制任务中的异常会写入UmiOCR-data/logs目录方便事后排查见 CHANGE_LOG.md。第五步结果验证打开生成的xxx.layered.pdf从三个维度验收可搜索性CtrlF 搜索正文关键词能命中并定位格式保真对比原扫描件图像清晰度、版面位置应基本一致文本准确随机抽取5~10处文字与原件人工比对。图2全局设置界面可配置引擎内存上限等参数为大型PDF转换留出资源空间四、技术拆解双层PDF是怎么叠出来的了解完操作我们来回答为什么能这样。整个过程可以概括为一条流水线解析文档 → 提取图像与文本 → OCR补全 → 排版解析 → 写入双层PDF。4.1 三大核心组件PyMuPDFfitz负责PDF的解析、渲染、写入是整个流程的骨架PaddleOCR 引擎离线深度学习模型负责把图像中的文字识别为带坐标的文本块TBPU 文本块后处理模块位于 UmiOCR-data/py_src/ocr/tbpu/负责段落合并、忽略区域过滤等排版理解工作。4.2 页面处理流水线以默认的混合模式为例每一页的处理流程如下对应 mission_doc.py解析页面元素用page.get_text()遍历页面把内容分成图片区块和文本区块两类复用原有文字如果PDF本身带有文字层电子版转存而来直接提取其文字和坐标标记来源为from: text不重复识别又快又准OCR补全图像把扫描的图片区块提交给OCR引擎得到识别文字及其坐标框再将坐标从图片相对坐标系换算回页面绝对坐标系旋转校正页面有旋转角度时通过变换矩阵提取旋转角对文字框和图片做逆向校正——这正是 v2.1.2 修复的坐标旋转、比例适配问题排版解析TBPU 模块对文本块做段落合并、忽略区域过滤输出结构化的文本块列表。4.3 双层写入的数字三明治最后一步写入由 output_pdf_layered.py 完成。核心逻辑可以浓缩为如下伪代码# 双层PDF写入核心逻辑简化自 output_pdf_layered.py for page in pdf: for tb in 文本块列表: # 双层模式下跳过直接提取的文本只写入OCR文本避免重复 if 透明模式 and tb来自原有文本: continue w, h 文本框的宽和高 # 自动计算字号先假设等于行高再反复微调让文字刚好填满文本框 fontsize 计算适配字号(text, w, h) # 在文本框左下角插入透明文字opacity0肉眼不可见但可选中 page.insert_text( 旋转后的插入点, text, fontsizefontsize, fontnamecjk, # 内置CJK字体支持中英文 rotate页面旋转角, stroke_opacity0, # 描边透明度 0 fill_opacity0, # 填充透明度 0 )几个值得注意的工程细节透明文本opacity0让文本层完全不可见用户看到的是底层图像但选中工具仍能抓住顶层的文字内置CJK字体加载fitz.Font(cjk)中文字体并嵌入页面确保中文不乱码、跨平台可显示字号自适配_calculateFontSize()以文本框高度为初值通过二分逼近找出刚好填满框宽的字号让文字位置和视觉图像精准对齐字体子集化任务结束时调用subset_fonts()仅保留用到的字符显著压缩文件体积再以deflate压缩保存平衡清晰度与大小。4.4 版本演进时间轴双层PDF功能并非一蹴而就从 CHANGE_LOG.md 可以看到清晰的迭代脉络v2.1.0 (2024.2) 新增批量文档识别支持 pdf/epub/mobi 等格式 v2.1.1 (2024.3) 优化保存双层PDF时无新文本写入的处理逻辑 v2.1.2 (2024.6) 修复文档提取/写入的坐标旋转与比例适配问题 新增单层纯文本PDF保存格式 v2.1.3 (2024.7) 优化单栏-单行排版解析相邻文本块自动补空格 v2.1.5 (2025.3) 修复提取PDF自带文本时未考虑页面旋转的问题 修复单层PDF未写入原PDF自带文本的问题每一个小版本都在修正同一个核心矛盾让文本层的坐标、字号、旋转与底层图像严丝合缝。五、避坑指南常见问题与解决策略实际使用中以下几类问题出现频率最高按下面的诊断分支处理基本都能解决开始诊断 │ ├─ 文字与图像错位 │ ├─ 版本检查 → 低于 v2.1.5 请先更新旋转坐标问题已在v2.1.5修复 │ ├─ 改用整页强制OCR模式跳过原有文字层的坐标换算 │ └─ 确认文档页面的旋转角度未被阅读器临时设置 │ ├─ 生成的文件体积过大 │ ├─ 检查是否嵌入了完整字体 → 程序已自动子集化若仍偏大 │ └─ 用其他工具降低底层图像的分辨率后再转换 │ ├─ 识别准确率不理想 │ ├─ 语言设置 → 确认勾选了正确的语言组合如中文英文 │ ├─ 倾斜/暗角扫描件 → 先用图像预处理工具增强对比度 │ └─ 页面复杂 → 换用智能合并段落模式减少断句 │ └─ 转换失败或卡住 ├─ 文件检查 → 验证PDF是否加密损坏、密码是否正确 ├─ 资源监控 → 关闭其他高占用程序并在全局设置中调低OCR引擎内存上限 └─ 日志分析 → 查看 UmiOCR-data/logs 目录中的错误日志定位原因两个容易被忽略的高频坑加密文档带打开密码的PDF会直接报错务必在任务参数中填写密码只限制了复制/打印权限的文档则一般不受影响仅提取文本模式下的卡顿v2.1.x 中仅拷贝原有文本模式处理极快频繁回调可能拖慢界面程序会故意引入最小间隔来保护UI属正常现象不是卡死。六、发散延展双层PDF的进阶玩法与演进方向掌握了基础转换双层PDF的可搜索能力还能撬动更多场景。6.1 构建个人知识库把积攒多年的纸质书扫描件、合同、票据统一转成双层PDF再用支持全文搜索的阅读器或网盘工具索引。从此找资料不再是翻箱倒柜而是秒级定位。教育场景下教师可以把教材扫描件转成双层PDF保留原始排版与图表同时支持学生搜索、批注不破坏原版内容。6.2 用命令行与HTTP接口自动化Umi-OCR 不只是图形软件。参考官方文档 docs/README_CLI.md 和 docs/http/api_doc.md可以通过命令行或HTTP接口批量提交文档识别任务默认保存格式即为双层可搜索PDF。这对需要定时处理大量扫描件的企业场景尤为实用——例如把法律合同或历史档案扫描件批量入库保留原始签章的同时实现关键条款的快速检索与多版本比对。6.3 未来方向从更新日志看项目仍在持续打磨识别精度、布局解析与多语言支持。可以期待的方向包括更智能的版面分析如多栏报纸、表格结构、更细粒度的忽略区域控制以及对手写体、复杂混合排版的识别优化。无论是个人还是团队提前掌握双层PDF这项技能都能让数字化办公的效率迈上一个台阶。总结Umi-OCR 的双层PDF转换用底层图像 透明文本的双图层架构化解了扫描文档看得见却摸不着的世纪难题。本文带你走完了从导入、配置、执行到验收的完整流程也剖析了其背后 PyMuPDF、PaddleOCR 与 TBPU 三大组件如何协作并给出了常见问题的排查路径。如果你想获取更多技术细节或跟进新功能官方更新日志 CHANGE_LOG.md 是了解版本演进的最佳入口动手试一次你就能体会到扫描件秒变可搜索文档的畅快。【免费下载链接】Umi-OCROCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片PDF文档识别排除水印/页眉页脚扫描/生成二维码。内置多国语言库。项目地址: https://gitcode.com/GitHub_Trending/um/Umi-OCR创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考