E2E 模型栈对齐设计¶
日期:2026-08-14
目标¶
对齐 CLI 端到端测试文档与当前 README 中的模型栈契约,同时保持测试套件的确定性,并避免与本地解析无关的重复覆盖。
README 修正¶
启动配置的默认值是 model.stack=auto,而非 light。其有效值根据检测到的设备选择:
model.stack 属于启动配置,不是 mineru config set 支持的键。README 必须将 MINERU_MODEL_STACK=<stack> 和 config.yaml 记录为受支持的覆盖方式。在准备托管 Parse Server 时,模型下载与验证示例必须显式传入 --stack <stack>。
E2E 配置档¶
完整的 E2E 套件以 MINERU_MODEL_STACK=light 运行。此配置档在各类硬件上均具有确定性,并覆盖所有 CLI 行为,包括本地 Basic、Standard 和 Advanced PDF 解析。
一个有针对性的强制 full 配置档则仅针对 Basic、Standard 和 Advanced 执行本地 PDF 解析。它不会重复远程解析、watch、scan、CRUD、遥测或维护用例,因为这些行为不依赖于模型运行时栈。
full 配置档必须:
- 停止当前服务器。
- 使用
MINERU_MODEL_STACK=full环境启动替代服务器。 - 等待托管 Parse Server 变为健康状态。
- 强制触发新的 Basic、Standard 和 Advanced 解析,并验证
privacy=local、via=local、请求的层级、completed 状态以及非空内容。 - 停止服务器,并在后续用例运行前恢复
light配置档。
安装与模型¶
E2E 环境安装 .[full],因为强制配置档矩阵包含可选的 full 运行时。基础包已包含 light 运行时。
设置阶段会显式下载并验证两套 Standard 部署模型集:
每个 Standard 模型集也涵盖对应的 Basic 模型,并通过 Standard 托管服务器支持 Advanced 请求。模型准备仍属于设置工作,可以使用 mineru-kit;正式的 CLI 用例继续仅使用 mineru。
层级选择¶
隐式质量层级选择为:
Advanced 仅在显式请求时才可用。仅提供 Advanced 的远程服务器不提供隐式默认层级。缓存结果的选择仍为:
验证¶
文档验证必须确认:
- 没有任何 E2E 设置步骤引用已移除的
standardextra。 - 每个设置阶段的模型下载和验证命令都指定了 stack。
- 主测试套件和隔离的缺失模型用例都继承确定性的 light 配置档。
- 强制的 full 配置档会在后续用例之前恢复 light。
- 默认层级预期仅包含 Standard 和 Basic。
- README 示例使用受支持的启动配置机制。
- Markdown 不存在空白字符错误,且所有引用的 CLI 选项均存在。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU