Skip to content

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

feat: add support for short spellings of boolean flags in webui command

myhloli44d408e06a55
diff --git a/mineru/kit/commands/webui.py b/mineru/kit/commands/webui.py
index 5fd0fdd9..8f790669 100644
--- a/mineru/kit/commands/webui.py
+++ b/mineru/kit/commands/webui.py
@@ -80,11 +80,12 @@ def webui_cmd(
),
api_server_disable_image_analysis: bool = typer.Option(
False,
- "--api-server-disable-image-analysis/--disable-image-analysis",
+ "--api-server-disable-image-analysis",
+ "--disable-image-analysis",
help=t("Disable managed server image analysis"),
),
api_server_preload_models: bool = typer.Option(
- False, "--api-server-preload-models/--preload-models", help=t("Preload managed server models")
+ False, "--api-server-preload-models", "--preload-models", help=t("Preload managed server models")
),
) -> None:
"""启动基于 MinerU V1 API 的 Gradio 文档解析界面。"""
diff --git a/tests/unittest/test_kit_commands.py b/tests/unittest/test_kit_commands.py
index d5994ad4..6870c221 100644
--- a/tests/unittest/test_kit_commands.py
+++ b/tests/unittest/test_kit_commands.py
@@ -61,6 +61,36 @@ def test_webui_console_script_targets_modern_command() -> None:
assert project["project"]["scripts"]["mineru-webui"] == "mineru.kit.commands.webui:main"
+ ("args", "expected"),
+ [
+ ([], {"api_server_preload_models": False, "api_server_disable_image_analysis": False}),
+ (["--preload-models"], {"api_server_preload_models": True}),
+ (["--api-server-preload-models"], {"api_server_preload_models": True}),
+ (["--disable-image-analysis"], {"api_server_disable_image_analysis": True}),
+ (["--api-server-disable-image-analysis"], {"api_server_disable_image_analysis": True}),
+ ],
+)
+def test_webui_managed_server_bool_flags_parse_short_spellings_on(
+ monkeypatch: pytest.MonkeyPatch, args: list[str], expected: dict[str, bool]
+) -> None:
+ """校验短拼写是正向别名而非斜杠反拼写,避免静默关闭托管 server 选项。"""
+ calls: list[dict[str, Any]] = []
+
+ def _fake_launch(**kwargs: Any) -> None:
+ """记录解析后的启动参数,不启动真实 Gradio。"""
+ calls.append(kwargs)
+
+ monkeypatch.setattr("mineru.kit.gradio.app.launch_gradio", _fake_launch)
+
+ result = runner.invoke(app, ["webui", *args])
+
+ assert result.exit_code == 0
+ assert len(calls) == 1
+ for key, value in expected.items():
+ assert calls[0][key] is value
+
+
def _invoke_standalone_command(
monkeypatch: pytest.MonkeyPatch,
entrypoint: Callable[[], None],