通过 MinerU OCR、标题映射和原页面校对

yanouyuan-bit/scanned-pdf-to-docx

通过 MinerU OCR、标题映射和原页面校对,将中文扫描书籍重建为有结构的 Word 文档。

最近更新于:

查看 GitHub 项目
git clone https://github.com/yanouyuan-bit/scanned-pdf-to-docx.git .claude/skills/scanned-pdf-to-docx
19Stars1Forks仓库最近推送

关于这个 Skill

针对没有可用文字层的扫描件:拆分书籍、运行 MinerU OCR、映射章节标题、生成 DOCX,再将可疑文字与原页面核对。附带转换脚本包含《易经》样例的修正规则及 Windows OCR 路径,处理其它书籍或平台前需要调整,不能当作通用一键转换器。

为什么推荐

面向中文与古籍扫描件,将 OCR 修正、章节重建拆为可核对的步骤,同时明确环境和样例规则的适配要求。

适合用来做什么

  • 从中文或古籍扫描书籍恢复可编辑 Word 文本。
  • 重建缺失章节标题,并维护经过核对的修正表。
  • 复用已有 MinerU Markdown,反复完善 DOCX。

工作流程

拆分并 OCR

按可处理的章节规模拆分文件,保留 MinerU 的页面索引数据。

映射标题并生成 Word

编写标题映射及文档修正规则,再由 OCR Markdown 生成 DOCX。

对照扫描件校对

定位可疑标记,对照原图、修正并重新生成,同时随文档交付未解决问题。

作者维护的 Skill 指令

安装与运行环境

先安装 Skill 指令,再按文档配置运行时依赖后执行任务。

命令用途与使用时机
python scripts/convert.py part.pdf -o output.docx --md ocr.md --toc toc.py复用经过核对的 OCR Markdown 与标题映射。
python scripts/check.py output.docx检查生成文档中的已知错误标记。

作者维护的 Skill 指令项目官方 README

适用范围与限制

工作流面向中文扫描书籍;已有干净文字层的 PDF 更适合直接提取。样例中的专属修正规则需要调整。

作者维护的 Skill 指令项目官方 README

许可证与来源

项目采用 MIT 许可证;Agent 订阅、外部服务和可选集成另有各自要求。

MIT 许可证

使用前需要了解

  • 需要 Python 3.10–3.12、MinerU、python-docx 和 PyMuPDF;OCR 模型下载与运行成本较高。
  • 文档中的 OCR 环境采用 Windows 与 PowerShell;其它平台需调整路径和字体,--md 可复用已有 OCR 输出。
  • 按实际书籍调整样例修正表、标题映射和领域符号,并人工核对不确定段落。

支持的 Agent

Claude Code

资料与来源

原始资料见下方链接;文中的上手建议由 SkillHey 编辑整理。