Skip to content

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

feat: configure global log level before rendering and parsing operations

myhlolie37919c8ebbc
diff --git a/mineru/parser/api_server.py b/mineru/parser/api_server.py
index 6960193b..8f387064 100644
--- a/mineru/parser/api_server.py
+++ b/mineru/parser/api_server.py
@@ -1480,6 +1480,7 @@ async def _run_job(
source_uri=extracted.source_uri,
local_resource_root=extracted.local_resource_root,
transport_encoding=extracted.transport_encoding,
+ fetch_remote_images=True,
)
result = await parse_async(
str(tmp_path),
diff --git a/mineru/parser/mineru_parser.py b/mineru/parser/mineru_parser.py
index ba8cd683..bceaec71 100644
--- a/mineru/parser/mineru_parser.py
+++ b/mineru/parser/mineru_parser.py
@@ -18,6 +18,7 @@ from ..errors import InvalidRequestError
from ..filetypes import IMAGE_EXTENSIONS, PAGE_RANGE_PARSE_EXTENSIONS
from ..integrations.docvortex import read_source_properties
from ..utils.async_utils import run_sync
+from ..utils.logger import configure_global_log_level
from ..types import FILE_SUFFIXES, FileSuffix, MiddleJson, ModelJson, PageInfo, Tier
from .base import DocumentParser, ParseResult
from .tier import effort_for_tier
@@ -71,6 +72,7 @@ class MinerUParser(DocumentParser):
source_context: HtmlSourceContext | None = None,
) -> ParseResult:
"""解析本地路径,并允许内部调用方覆盖 HTML 原始来源上下文。"""
+ configure_global_log_level()
path = Path(path)
if not path.exists():
raise FileNotFoundError(path)
@@ -93,6 +95,7 @@ class MinerUParser(DocumentParser):
source_context: HtmlSourceContext | None = None,
) -> ParseResult:
"""异步解析本地路径,并保留 HTML 下载来源或本地资源根。"""
+ configure_global_log_level()
path = Path(path)
if not path.exists():
raise FileNotFoundError(path)
@@ -190,6 +193,7 @@ class MinerUParser(DocumentParser):
resolved_source_context = HtmlSourceContext(
source_uri=resolved_path.as_uri(),
local_resource_root=resolved_path.parent,
+ fetch_remote_images=True,
)
source_properties = (
DocumentProperties()
diff --git a/mineru/render/api.py b/mineru/render/api.py
index acfcd6ad..70f80abb 100644
--- a/mineru/render/api.py
+++ b/mineru/render/api.py
@@ -6,6 +6,7 @@ from __future__ import annotations
from typing import Any, Literal, overload
from ..types import MiddleJson
+from ..utils.logger import configure_global_log_level
from .contracts import (
ContentListRenderOptions,
@@ -138,6 +139,7 @@ def render(
options: RenderOptions | None = None,
) -> RenderOutput:
"""按严格目标格式和对应选项把 MiddleJson 渲染为原生结果。"""
+ configure_global_log_level()
if not isinstance(middle_json, MiddleJson):
raise TypeError("render expects a MiddleJson instance")
if not isinstance(output_format, RenderFormat):
diff --git a/tests/unittest/test_global_log_level.py b/tests/unittest/test_global_log_level.py
index a1296978..aece0323 100644
--- a/tests/unittest/test_global_log_level.py
+++ b/tests/unittest/test_global_log_level.py
@@ -125,3 +125,51 @@ def test_helper_module_has_no_runtime_side_effect() -> None:
)
assert json.loads(completed.stdout) == [0]
+
+
+def test_parser_entry_configures_before_docvortex(monkeypatch: pytest.MonkeyPatch, tmp_path) -> None:
+ """验证直接实例化 MinerUParser 时,日志配置先于 prepare 阶段的 docvortex 调用。"""
+ import mineru.parser.mineru_parser as mineru_parser_module
+
+ calls: list[str] = []
+ monkeypatch.setattr(
+ mineru_parser_module,
+ "configure_global_log_level",
+ lambda: calls.append("configure"),
+ )
+
+ def fake_read_source_properties(*args: object, **kwargs: object) -> None:
+ calls.append("docvortex")
+
+ monkeypatch.setattr(mineru_parser_module, "read_source_properties", fake_read_source_properties)
+
+ def stop_after_prepare(*args: object, **kwargs: object) -> None:
+ raise RuntimeError("stop-after-prepare")
+
+ monkeypatch.setattr(mineru_parser_module, "doc_analyze", stop_after_prepare)
+
+ source = tmp_path / "sample.csv"
+ source.write_text("a,b\n1,2\n", encoding="utf-8")
+ parser = mineru_parser_module.MinerUParser()
+
+ with pytest.raises(RuntimeError, match="stop-after-prepare"):
+ parser.parse(source)
+
+ assert calls == ["configure", "docvortex"]
+
+
+def test_render_entry_configures_global_log_level(monkeypatch: pytest.MonkeyPatch) -> None:
+ """验证 render 统一入口在任何渲染分发前完成日志配置。"""
+ import mineru.render.api as render_api_module
+
+ calls: list[str] = []
+ monkeypatch.setattr(
+ render_api_module,
+ "configure_global_log_level",
+ lambda: calls.append("configure"),
+ )
+
+ with pytest.raises(TypeError):
+ render_api_module.render(object(), render_api_module.RenderFormat.MARKDOWN)
+
+ assert calls == ["configure"]
diff --git a/tools/validate_docvortex_boundary.py b/tools/validate_docvortex_boundary.py
index df305d1c..a4650c4e 100644
--- a/tools/validate_docvortex_boundary.py
+++ b/tools/validate_docvortex_boundary.py
@@ -23,7 +23,9 @@ def capture(args: argparse.Namespace) -> None:
from mineru.backend.analyze import doc_analyze
from mineru.config import config
from mineru.render import RenderFormat, render
+ from mineru.utils.logger import configure_global_log_level
+ configure_global_log_level()
config.llm_aided.features.title_leveling = False
config.llm_aided.features.cross_page_table_cell_merge = False
args.output.mkdir(parents=True, exist_ok=True)