MinerU项目从magic-pdf到mineru的版本升级指南

在MinerU项目的发展过程中，项目组对核心组件进行了重大升级，将原有的magic-pdf包更名为mineru，并实现了架构上的优化。这一变更带来了安装流程的简化和依赖管理的改进，特别是移除了对第三方wheel镜像站的依赖。

版本变更背景

MinerU项目早期版本（1.x系列）使用magic-pdf作为核心包名，在安装过程中需要依赖detectron2等计算机视觉库。由于这些库的特殊构建需求，项目曾推荐使用特定的wheel镜像站来获取预编译的二进制包。但随着项目发展到2.0版本，技术团队对架构进行了重构，不仅更改了包名，还优化了依赖关系。

新版本安装方法

最新版的MinerU（2.0及以上版本）安装变得更为简单直接。用户只需执行标准的pip安装命令即可完成部署：

pip install mineru[core]

如果需要完整功能，可以安装full版本：

pip install mineru[full]

旧版本兼容方案

对于仍需使用magic-pdf 1.2.2等旧版本的特殊情况，用户需要注意以下几点：

1. 原wheel镜像站已不可用，不再推荐依赖该渠道
2. detectron2等特殊依赖需要手动安装
3. 建议从可信源获取预编译的wheel包进行安装

手动安装detectron2的示例命令：

pip install 下载的detectron2-wheel文件名.whl

升级建议

技术团队强烈建议用户迁移至mineru新版本，主要优势包括：

1. 更简单的安装流程
2. 更好的维护支持
3. 更稳定的依赖管理
4. 持续的功能更新

对于从magic-pdf迁移的用户，项目文档提供了详细的升级指南和API变更说明，建议在升级前仔细阅读。新版本在设计上保持了高度的向后兼容性，同时提供了更现代化的接口和更优的性能表现。

通过这次升级，MinerU项目展现了技术架构的持续演进，为用户提供了更可靠、更易用的文本处理解决方案。