health tool：MinerU + Ollama 双服务探活。

注意：其余 7 个工具均为 async handler；FastMCP 1.29 对同步 handler 会在 running loop 内直接同步调用，内部再 asyncio.run 会嵌套报错， 故此处统一为 async + await（health_service.check 仍保留同步兜底）。

parse_text tool：MinerU 文本路单跑。

V2.0（additive）：新增可选 verify_pages —— 调用级显式指定 OvisOCR2 校验页（信号②；未指定/未启用 → 触发规则自行判定，默认零调用）。

Args: pdf_path: PDF 路径（必填）。 pages: 页号（int | list[int] | None；1-based）。 verify_pages: 页号（int | list[int] | None；1-based；OvisOCR2 校验页）。

Returns: 结构化 JSON 文本（ParseTextOutput）。

vision_extract tool：视觉路单跑。

V1.3：新增 image_path 参数（独立图片输入，与 pdf_path 互斥二选一）。

Args: pdf_path: PDF 路径（与 image_path 互斥；二者必传其一）。 fields: 字段键（str | list[str] | dict；必填）。 pages: 页号（int | list[int] | None；1-based；图片输入忽略）。 model: 模型名（可选，默认 Settings.ollama_model）。 image_path: 独立图片文件路径（PNG/JPG 等，V1.3 新增）。

Returns: 结构化 JSON 文本（VisionExtractOutput）。

dual_extract tool：双路融合主入口（M3，T03）。

V2.0（additive）：新增可选 verify_pages —— 调用级显式指定 OvisOCR2 校验页（信号②；未指定/未启用 → 触发规则自行判定，默认零调用）。

Args: pdf_path: PDF 路径（必填）。 fields: 字段键（str | list[str] | dict；必填，禁止空）。 pages: 页号（int | list[int] | None；1-based）。 model: 视觉模型名（可选，默认 Settings.ollama_model）。 think: 视觉路 thinking 开关（bool | None；None → Settings.ollama_think）。 field_types: {字段键: 字段类型}（可选；未指定按值形态推断）。 verify_pages: 页号（int | list[int] | None；1-based；OvisOCR2 校验页）。

Returns: 结构化 JSON 文本（ExtractionOutput）。

extract_table tool：表格抽取（跨页 + 大表分层，M4，T04）。

Args: pdf_path: PDF 路径（必填）。 pages: 页号（int | list[int] | None；1-based）。 cross_page: 是否跨页合并（bool，默认 true）。 format: 导出格式（str | list[str]；json/csv/xlsx 多选；默认 "json"）。 render: 是否渲染页图（bool，默认 true）。

Returns: 结构化 JSON 文本（tables.json 汇总）。

extract_formulas tool：公式抽取（LaTeX + PNG，M5，T04）。

Args: pdf_path: PDF 路径（必填）。 pages: 页号（int | list[int] | None；1-based）。 render: 是否渲染 PNG（bool，默认 true）。 tex: 是否落盘 formulas.tex（bool，默认 false）。 sympy: 是否做 SymPy 校验（bool，默认 false）。

Returns: 结构化 JSON 文本（formulas.json 汇总）。

inspect_document tool：文档探查（M6，P1，轻量）。

Args: pdf_path: PDF 路径（必填）。

Returns: 结构化 JSON 文本（PRD §4.6：pages/tables/images/formulas/text_chars）。

validate_output tool：输出结构校验（M6，C1）。

Args: output_dir: 待校验目录（绝对或相对路径；必须位于输出根内）。

Returns: 结构化 JSON 文本（{ok, errors, manifest_ok}）。