跳转至

默认层级选择设计

日期:2026-07-21

目标

简化隐式解析层级选择,以匹配新的服务器能力契约。提供 Advanced 的符合规范服务器也提供 Standard,因此 Advanced 不再需要作为隐式回退。

选择规则

当用户提交未指定层级的质量解析请求时,选择:

standard -> basic -> error

Advanced 仍然是有效的质量层级,但必须显式请求。Flash 仍然是普通请求的显式预览层级。

后台解析规则可以回退到 Flash,因此选择:

standard -> basic -> flash

缓存结果选择保持不变:

advanced -> standard -> basic -> flash

已创建的 Advanced 结果仍然是最高质量的可复用缓存,尽管 Advanced 不会为新工作隐式选择。

类型常量

将默认选择顺序与质量层级成员资格分离:

  • DEFAULT_QUALITY_TIER_SELECTION_ORDER 包含 Standard 和 Basic。
  • QUALITY_TIERS 包含 Basic、Standard 和 Advanced。
  • PARSING_RULE_TIER_SELECTION_ORDER 在默认顺序后追加 Flash。
  • CACHED_TIER_SELECTION_ORDER 保持不变。

当 Advanced 从默认顺序中移除时,这可以防止将其从文件类型验证和显式请求处理中移除。

兼容性边界

当前第一方 API 服务器不会在没有 Standard 的情况下声明 Advanced。外部或过时的仅 Advanced 服务器不被视为具有隐式默认质量层级。这是有意为之,并且不影响针对符合规范的 Standard 服务器的显式 --tier advanced 请求。

验证

测试验证:

  1. Standard 优先于 Basic。
  2. 当 Standard 不可用时选择 Basic,即使 Advanced 被声明。
  3. 单独的 Advanced 不会成为隐式默认。
  4. Advanced 仍然是 QUALITY_TIERS 的成员。
  5. 解析规则使用 Standard、Basic,然后 Flash。
  6. 缓存结果选择仍然优先 Advanced。
  7. API-server、Doclib、Gradio、CLI 以及受跟踪的单元测试保持通过。

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