跳转至

模型管理档位范围设计

状态:已批准 日期:2026-07-21

目标

保留四个公共解析档位(flash、basic、standard 和 advanced),同时将模型安装与管理缩减为实际存在的两个不同模型集:Basic 和 Standard。

打包

历史说明:本节按 tier 划分 extras 的方案已被当前按后端安装的方案替代,下文保留设计历史,不作为安装指引。当前基础包提供 ONNX/llama.cpp,Torch 使用 mineru[torch],Linux vLLM / Windows LMDeploy 使用 mineru[full],显式 MLX 单独安装 mlx-vlm>=0.7.0,<0.8.0。basic、standard 和 advanced 均不是当前安装 extra;测试依赖使用独立的 test extra。详见 当前档位说明。

项目仅提供 basic 和 standard 两种模型运行时 extra。advanced extra 已被移除,因为 Advanced 使用与 Standard 相同的依赖。测试依赖使用 mineru[standard]。

准备进行 Advanced 解析的用户安装 mineru[standard];不再保留单独的 Advanced 兼容 extra。

模型注册表

REPOS_FOR_TIER 和 model_repos_for_tier() 仅涵盖:

  • basic:PDF-Extract-Kit-1.0
  • standard:PDF-Extract-Kit-1.0 和 MinerU2.5-Pro-2605-1.2B

Flash 从不参与模型查找,因为它不使用模型。Advanced 调用方在调用注册表之前显式复用 Standard 模型集。直接将 flash、advanced 或无关值传给 model_repos_for_tier() 属于错误用法。

mineru-kit models

download、verify 和 show 子命令仅处理 Basic 和 Standard 模型档位。

  • download --tier 仅接受 basic 和 standard。
  • verify --tier 仅接受 basic 和 standard。
  • show 仅列出 Basic 和 Standard 模型集。
  • 传入 Flash 或 Advanced 会返回 invalid_request 错误,其支持值为 basic, standard。

直接传递模型仓库参数仍受支持且保持不变。

托管 Parse Server

托管 Parse Server 的模型就绪检查仍适用于 Basic、Standard 和 Advanced 解析档位:

  • Basic 检查 Basic 模型集。
  • Standard 检查 Standard 模型集。
  • Advanced 显式检查 Standard 模型集。

当 Advanced 缺少模型文件时,补救措施指向:

mineru-kit models download --tier standard

Flash 不使用托管质量档位的模型就绪检查路径。

文档

模型安装与管理文档仅描述 Basic 和 Standard 模型集。Advanced 文档说明其复用 Standard extra 和模型准备命令。解析示例继续展示全部四个公共解析档位。

验证

测试涵盖:

  1. advanced extra 不存在,且测试依赖使用 mineru[standard]。
  2. Basic 和 Standard 模型注册表映射。
  3. 注册表拒绝 Flash 和 Advanced。
  4. models download 和 models verify 拒绝 Flash 和 Advanced。
  5. models show 输出仅包含 Basic 和 Standard 档位行。
  6. Advanced 托管服务器就绪检查使用 Standard 模型集,并推荐 Standard 下载命令。
  7. 扫描文档与受跟踪文件中已移除命令和 extra 的残留。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU