SDK 的档位与错误边界

核对入口：mineru/parser/tier.py、mineru/parser/mineru_parser.py、mineru/kit/commands/parse.py、 mineru/types.py、mineru/doclib/services/parse_queue_svc.py。

默认值按入口区分

入口	PDF／图片	原生 Office、HTML/MHTML、CSV/TSV、EPUB、OFD
Python parse() / MinerUParser	默认 standard；tier 必须是合法四档值	原生实现记录 flash/txt，合法质量档位不切换原生实现
mineru-kit parse 本地单文件	未指定为 standard	未指定为 flash；显式质量档位报错
mineru-kit parse 本地批量	未指定为 standard	每个原生文件归一为 flash
Tasks / MinerUApiParser / file-parse	省略后由服务按 standard → basic → flash → advanced 选择	固定 flash，忽略合法显式档位
Doclib 主动解析	结合规则与服务能力选择 standard → basic；不静默用 flash 替代质量解析	原生 Flash；Doclib 请求约束独立于 Tasks

Tasks 只有在 Advanced 是唯一可用档位时才自动选择它。显式不支持的 PDF/图片档位返回错误。 MinerUApiParser(tier=None) 表示省略 HTTP 字段；直接本地 parse(tier=None) 不具有这个语义。 档位与硬件推荐不是同一件事，见 产品档位说明。

错误与恢复

直接本地解析可能抛出 FileNotFoundError、ValueError、MineruError 或底层依赖异常， 不能承诺所有失败都属于一个 SDK 异常基类。 MinerUApiParser 对 HTTP/任务错误使用 API 错误对象；Doclib 通过自身错误映射保留本地产品分类。 具体边界见 错误说明。

任务创建结果未知时不要自动重放；保存 task_id/request_id，查询原任务。 等待超时不表示取消，取消需显式调用对应接口。上传重试应先查询是否仍有有效上传动作。 不要把 retryable/user_action/docs_url 等历史扩展提案当作当前响应字段。

没有 backend 公开解析参数，也没有 mineru-kit parse --backend 专家覆盖。 小模型后端和 VLM 引擎分别由 model.small_backend、model.vlm 配置。