升级的兼容性

[zhaoyang0618]

miners-api的接口能否提供和mineru 3兼容的接口呀？
每次升级在接口层面都是破坏性的，对于开发人员也太累了。miners-api这个层面都无法保持接口相对稳定吗？

[myhloli]

感谢反馈，理解接口变更会给已有项目带来适配成本。

MinerU 4 扩展了更多文档格式的支持，同时引入了基于文件 hash 校验的秒传机制：命中有效文件缓存时，可以跳过重复上传。这些能力需要对文件提交、上传和任务处理流程进行统一设计。

另外，新的 API 也面向未来的 SaaS 服务设计，自部署服务端与 SaaS 将共用一套接口协议，目的是让客户端能够复用同一套接入逻辑，便于在两种部署方式之间无缝切换。

基于这些变化，MinerU 4 需要重新设计完整的接口方案，因此我们通过大版本升级，将新接口与 MinerU 3 的接口明确隔离。此次升级确实需要调用方做一次迁移，但这也是为了给后续功能扩展和不同部署方式之间的切换建立统一基础。