中央层级类型与常量设计¶
日期:2026-07-21
目标¶
使 mineru/types.py 成为请求、服务器和部署层级类型及其有限值集合的唯一可信来源。移除重复定义,并用一致的公共名称替换内部/私有名称。
规范定义¶
在 mineru/types.py 中保留 Tier 和 ServerTier,为托管服务器配置和模型准备添加共享的 DeploymentTier,并在相应类型旁边定义以下显式常量:
SERVER_TIERS: tuple[ServerTier, ...] = ("flash", "basic", "standard")DEPLOYMENT_TIERS: tuple[DeploymentTier, ...] = ("basic", "standard")TIERS: tuple[Tier, ...] = ("flash", "basic", "standard", "advanced")TIER_ORDER: dict[Tier, int] = {"flash": 0, "basic": 1, "standard": 2, "advanced": 3}TIERS_BY_SERVER_TIER: dict[ServerTier, tuple[Tier, ...]]
请求层级映射保持不变:
- Flash 服务器:Flash 请求;
- Basic 服务器:Flash 和 Basic 请求;
- Standard 服务器:Flash、Basic、Standard 和 Advanced 请求。
元组和映射定义保持显式,而不是动态派生。TIER_ORDER 中少量重复的顺序是有意为之:它使排名语义对静态源码分析可见,同时保留可读的比较、排序以及容错的 .get(..., -1) 查找。
迁移¶
托管服务器配置和模型仓库选择层都使用 DeploymentTier 和 DEPLOYMENT_TIERS。Basic 和 Standard 是部署配置:Flash 不需要托管部署或模型包,而 Advanced 复用 Standard 部署。
移除托管服务器层级与模型层级之间冗余的恒等转换。经过验证的部署层级可以直接传递给模型仓库选择。
不再保留兼容别名或旧模块再导出。这是一次内部源码迁移,不打算改变行为、API 负载、CLI 选项、错误消息或层级顺序。
导入边界¶
mineru/types.py 保持轻量依赖,不导入 parser、doclib、kit、config 或 model-registry 模块。消费者依赖 types.py,因此该迁移不会引入反向依赖或导入循环。
验证¶
测试和静态检查验证:
- 所有五个规范常量和显式
TIER_ORDER映射都具有预期的有序值。 - API 服务器启动验证和请求层级扩展保持不变。
- 托管服务器配置仅接受 Basic 和 Standard 部署层级。
- 模型命令和模型仓库选择使用相同的部署层级。
- 被取代的标识符不再出现在受跟踪的代码或文档中。
- Ruff、导入检查和受跟踪的单元测试套件保持通过。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU