默认层级选择设计¶
日期:2026-07-21
目标¶
简化隐式解析层级选择,以匹配新的服务器能力契约。提供 Advanced 的符合规范服务器也提供 Standard,因此 Advanced 不再需要作为隐式回退。
选择规则¶
当用户提交未指定层级的质量解析请求时,选择:
Advanced 仍然是有效的质量层级,但必须显式请求。Flash 仍然是普通请求的显式预览层级。
后台解析规则可以回退到 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 请求。
验证¶
测试验证:
- Standard 优先于 Basic。
- 当 Standard 不可用时选择 Basic,即使 Advanced 被声明。
- 单独的 Advanced 不会成为隐式默认。
- Advanced 仍然是
QUALITY_TIERS的成员。 - 解析规则使用 Standard、Basic,然后 Flash。
- 缓存结果选择仍然优先 Advanced。
- API-server、Doclib、Gradio、CLI 以及受跟踪的单元测试保持通过。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU