模型管理档位范围设计¶
状态:已批准 日期: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;测试依赖使用独立的testextra。详见 当前档位说明。
项目仅提供 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.0standard: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 缺少模型文件时,补救措施指向:
Flash 不使用托管质量档位的模型就绪检查路径。
文档¶
模型安装与管理文档仅描述 Basic 和 Standard 模型集。Advanced 文档说明其复用 Standard extra 和模型准备命令。解析示例继续展示全部四个公共解析档位。
验证¶
测试涵盖:
advancedextra 不存在,且测试依赖使用mineru[standard]。- Basic 和 Standard 模型注册表映射。
- 注册表拒绝 Flash 和 Advanced。
models download和models verify拒绝 Flash 和 Advanced。models show输出仅包含 Basic 和 Standard 档位行。- Advanced 托管服务器就绪检查使用 Standard 模型集,并推荐 Standard 下载命令。
- 扫描文档与受跟踪文件中已移除命令和 extra 的残留。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU