Skip to content

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

docs(next): reference effort_for_tier() instead of renamed mapping

myhloli7ac43b362b35
diff --git a/docs/next/pitfalls.md b/docs/next/pitfalls.md
index 51a9428b..cc56f2a3 100644
--- a/docs/next/pitfalls.md
+++ b/docs/next/pitfalls.md
@@ -13,7 +13,7 @@
历史过渡层 `resolve_tier_and_backend(tier, backend)` 与 `mineru-kit parse --backend` 专家参数(含 `pipeline`/`vlm-*` 等别名)已移除:backend 只用于推断 tier,推断后即被丢弃,没有独立作用。`backend_for_tier` 派生链与 `ParserRuntimeOptions.backend` 内部字段也已删除。
-- 新代码只走 `tier`;basic/standard/advanced 共用同一个 hybrid-engine,仅 effort 不同(`HYBRID_EFFORT_BY_TIER`,`parser/tier.py` 的 `ParserRuntimeOptions(tier, effort)`)。
+- 新代码只走 `tier`;basic/standard/advanced 共用同一个 hybrid-engine,仅 effort 不同(`effort_for_tier()`,`parser/tier.py` 的 `ParserRuntimeOptions(tier, effort)`)。
- 不要在任何 CLI / SDK / API 入口重新引入 `backend` 入参,也不要恢复 backend 派生函数或内部字段。
### 1.2 共享文档协议与缓存必须同步
diff --git a/docs/next/workflows.md b/docs/next/workflows.md
index 6c30aabf..4fa5bf3d 100644
--- a/docs/next/workflows.md
+++ b/docs/next/workflows.md
@@ -50,7 +50,7 @@
2. **质量优先**: 用户或 Agent 主动读取 PDF/image 文档时,默认使用默认选择策略,且不会解析为 `flash`。
3. **发现与阅读分离**: watch 可以自动使用 `flash`;PDF/image 主动阅读不能静默使用 `flash`。
4. **结果记录实际 tier**: 默认选择是请求时选择逻辑,任务、缓存、产物和 metadata 记录实际使用的实体 tier。
-5. **tier 是唯一入参**: 所有入口只接受 `tier`;Tool SDK 的 `parse()` 只接受 `tier`。运行差异由 tier 派生的 effort 表达(`HYBRID_EFFORT_BY_TIER`),没有 backend 派生层。API-backed parser、Doclib SDK、doclib server API 和 v1 API 只面向 `tier`,不暴露 `backend`。
+5. **tier 是唯一入参**: 所有入口只接受 `tier`;Tool SDK 的 `parse()` 只接受 `tier`。运行差异由 tier 派生的 effort 表达(`effort_for_tier()`),没有 backend 派生层。API-backed parser、Doclib SDK、doclib server API 和 v1 API 只面向 `tier`,不暴露 `backend`。
6. **缓存按内容和 tier 隔离**: 同一 `sha256 + tier` 的解析结果可以复用;不同 tier 的结果不能互相覆盖。
7. **fallback 不扩大隐私边界**: local 失败不能自动改成 remote;remote 失败可以 fallback 到 local。
8. **Flash 既是档位也是实现名**: `flash` 同时是解析档位,也是快速 CPU PDF 解析实现的名称。