跳转至

E2E 模型栈对齐设计

日期:2026-08-14

目标

对齐 CLI 端到端测试文档与当前 README 中的模型栈契约,同时保持测试套件的确定性,并避免与本地解析无关的重复覆盖。

README 修正

启动配置的默认值是 model.stack=auto,而非 light。其有效值根据检测到的设备选择:

CPU -> light
accelerator -> full

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 配置档必须:

  1. 停止当前服务器。
  2. 使用 MINERU_MODEL_STACK=full 环境启动替代服务器。
  3. 等待托管 Parse Server 变为健康状态。
  4. 强制触发新的 Basic、Standard 和 Advanced 解析,并验证 privacy=local、via=local、请求的层级、completed 状态以及非空内容。
  5. 停止服务器,并在后续用例运行前恢复 light 配置档。

安装与模型

E2E 环境安装 .[full],因为强制配置档矩阵包含可选的 full 运行时。基础包已包含 light 运行时。

设置阶段会显式下载并验证两套 Standard 部署模型集:

standard/light
standard/full

每个 Standard 模型集也涵盖对应的 Basic 模型,并通过 Standard 托管服务器支持 Advanced 请求。模型准备仍属于设置工作,可以使用 mineru-kit;正式的 CLI 用例继续仅使用 mineru。

层级选择

隐式质量层级选择为:

standard -> basic -> error

Advanced 仅在显式请求时才可用。仅提供 Advanced 的远程服务器不提供隐式默认层级。缓存结果的选择仍为:

advanced -> standard -> basic -> flash

验证

文档验证必须确认:

  1. 没有任何 E2E 设置步骤引用已移除的 standard extra。
  2. 每个设置阶段的模型下载和验证命令都指定了 stack。
  3. 主测试套件和隔离的缺失模型用例都继承确定性的 light 配置档。
  4. 强制的 full 配置档会在后续用例之前恢复 light。
  5. 默认层级预期仅包含 Standard 和 Basic。
  6. README 示例使用受支持的启动配置机制。
  7. Markdown 不存在空白字符错误,且所有引用的 CLI 选项均存在。

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