Skip to content

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

Rename 'gradio' command to 'webui' and update related references

myhlolibf52708fd7e8
diff --git a/.github/workflows/gradio.yml b/.github/workflows/gradio.yml
index 5bb67d98..5951d727 100644
--- a/.github/workflows/gradio.yml
+++ b/.github/workflows/gradio.yml
@@ -5,7 +5,7 @@ on:
pull_request:
paths:
- "mineru/kit/gradio/**"
- - "mineru/kit/commands/gradio.py"
+ - "mineru/kit/commands/webui.py"
- "mineru/resources/gradio*"
- "mineru/resources/pdf_preview/**"
- "tests/unittest/test_kit_gradio*"
diff --git a/docs/next/cli/mineru-kit-gradio.md b/docs/next/cli/mineru-kit-webui.md
similarity index 95%
rename from docs/next/cli/mineru-kit-gradio.md
rename to docs/next/cli/mineru-kit-webui.md
index 857e05b7..871a6de4 100644
--- a/docs/next/cli/mineru-kit-gradio.md
+++ b/docs/next/cli/mineru-kit-webui.md
@@ -1,4 +1,4 @@
-# mineru-kit gradio
+# mineru-kit webui
页码规范与历史结果兼容说明见 [PDF 页码范围规范](../page-ranges.md)。
@@ -23,7 +23,7 @@ Gradio 6.26 的 `huggingface-hub>=1.16` 与当前 Transformers 4 的依赖范围
构建后使用 `python scripts/verify_pdfjs_distribution.py dist/*.whl dist/*.tar.gz` 检查资源和许可证是否完整。
浏览器样本可用 `python tests/browser/gradio_pdf_fixtures.py output/playwright/pdfjs-fixtures` 生成。
-`mineru-kit gradio` 提供一个基于 MinerU V1 API 的文档解析界面。它不直接调用旧 `/file_parse` 或 `/tasks` 接口,也不使用 `doclib` 缓存。
+`mineru-kit webui` 提供一个基于 MinerU V1 API 的文档解析界面。它不直接调用旧 `/file_parse` 或 `/tasks` 接口,也不使用 `doclib` 缓存。
## 启动
@@ -36,13 +36,13 @@ pip install mineru
自动启动本地 V1 API server:
```bash
-mineru-kit gradio
+mineru-kit webui
```
连接已有 self-hosted 或 remote V1 API server:
```bash
-mineru-kit gradio \
+mineru-kit webui \
--api-url http://127.0.0.1:16580 \
--api-key "$MINERU_API_KEY"
```
@@ -95,7 +95,7 @@ OCR 模式由每次 V1 解析任务决定;API Server 不再提供启动时的
仅在已上传原始 PDF 且 tier 不是 `flash` 时显示页码双滑块。轨道范围由 `pypdfium2` 读取的实际页数确定,为 `1~n`,两端对应包含首尾页的连续选区。Flash 和其他文件格式隐藏控件,并始终全部解析。
-默认选择全部页;配置 `mineru-kit gradio --max-pages 20` 后,100 页 PDF 的初始选区为 `[1-20]`,轨道仍为 `1~100`。选区最多 20 页,允许缩小;只有超限时才联动另一端。例如将右端拖到 40 得到 `[21-40]`,再把左端拖到 15 得到 `[15-34]`,随后把左端拖到 20 得到 `[20-34]`。
+默认选择全部页;配置 `mineru-kit webui --max-pages 20` 后,100 页 PDF 的初始选区为 `[1-20]`,轨道仍为 `1~100`。选区最多 20 页,允许缩小;只有超限时才联动另一端。例如将右端拖到 40 得到 `[21-40]`,再把左端拖到 15 得到 `[15-34]`,随后把左端拖到 20 得到 `[20-34]`。
两个滑块可以互相越过并实时交换起止角色,拖动过程中始终抓住同一个滑块,不需要松手。显示和提交的范围始终从小到大排列。例如从 `[20-35]` 把原左滑块拖到 40,得到 `[35-40]`;同一滑块继续到 60,按上限联动为 `[41-60]`;不松手退到 30,则得到 `[30-41]`。两端重合表示单页,此时保留原来的角色,直到严格越过才交换;键盘操作遵循相同规则。
@@ -145,4 +145,4 @@ Office 转换开始、失败及成功后都保留已挂载的源预览。“忽
PDF 和图片会生成与解析范围一致的 `origin.pdf`;布局预览使用 schema 2.0 顶层 block/bbox 生成语义 overlay。无法生成 overlay 时仍保留 origin PDF 预览。
-`mineru-gradio` 保留为 `mineru-kit gradio` 的兼容命令名,参数与行为完全相同;旧 HTTP 协议和旧 Gradio 专属参数不再提供。
+`mineru-webui` 提供为 `mineru-kit webui` 的独立命令名,参数与行为完全相同;旧 HTTP 协议和旧 Gradio 专属参数不再提供。
diff --git a/docs/next/cli/mineru-kit.md b/docs/next/cli/mineru-kit.md
index 8cd9d492..6911070d 100644
--- a/docs/next/cli/mineru-kit.md
+++ b/docs/next/cli/mineru-kit.md
@@ -23,7 +23,7 @@
|--------|------|------|
| `mineru-kit models` | 下载、查看和校验本地模型配置 | [mineru-kit models](mineru-kit-models.md) |
| `mineru-kit parse` | 无状态文件/目录批处理解析 | [mineru-kit parse](mineru-kit-parse.md) |
-| `mineru-kit gradio` | 基于 V1 API 的本地文档解析 Web UI | [mineru-kit gradio](mineru-kit-gradio.md) |
+| `mineru-kit webui` | 基于 V1 API 的本地文档解析 Web UI | [mineru-kit webui](mineru-kit-webui.md) |
| `mineru-kit api-server` | 启动兼容统一 API 的本地解析服务 | [mineru-kit api-server](mineru-kit-api-server.md) |
| `mineru-kit vlm-server` | 本地 VLM 服务,兼容 OpenAI Chat Completions 协议 | [mineru-kit vlm-server](mineru-kit-vlm-server.md) |
| `mineru-kit router` | 启动 V1 路由服务,转发到已有 upstream 或管理本地 worker | 仅暴露 `/v1/*` |
@@ -64,7 +64,7 @@ mineru-api --host 127.0.0.1 --port 8000 --tier standard
`mineru-kit` 参数暂不划分 `stable` / `experimental` 等稳定性等级。第一阶段保持参数体系简单,后续只有在兼容性压力明确出现时再引入分级。
-`mineru-kit gradio` 是无状态的 V1 API 客户端界面。未指定 `--api-url` 时,它会自动托管一个 loopback `mineru-kit api-server`;指定 URL 时只连接已有的 V1 服务,不会静默改连官方远程服务。`mineru-gradio` 保留为同一新版命令的兼容别名,不再提供旧 HTTP 协议或旧参数。
+`mineru-kit webui` 是无状态的 V1 API 客户端界面。未指定 `--api-url` 时,它会自动托管一个 loopback `mineru-kit api-server`;指定 URL 时只连接已有的 V1 服务,不会静默改连官方远程服务。`mineru-webui` 提供为同一新版命令的独立入口,不再提供旧 HTTP 协议或旧参数。
当前 `mineru-kit parse` 已确定:
diff --git a/mineru/kit/commands/__init__.py b/mineru/kit/commands/__init__.py
index ca3da3f9..01f43505 100644
--- a/mineru/kit/commands/__init__.py
+++ b/mineru/kit/commands/__init__.py
@@ -1,5 +1,5 @@
"""mineru-kit command modules."""
-from . import api_server, gradio, models, parse, router, vlm_server
+from . import api_server, models, parse, router, vlm_server, webui
-__all__ = ["api_server", "gradio", "models", "parse", "router", "vlm_server"]
+__all__ = ["api_server", "models", "parse", "router", "vlm_server", "webui"]
diff --git a/mineru/kit/commands/gradio.py b/mineru/kit/commands/webui.py
similarity index 94%
rename from mineru/kit/commands/gradio.py
rename to mineru/kit/commands/webui.py
index 591b0b2d..e873eade 100644
--- a/mineru/kit/commands/gradio.py
+++ b/mineru/kit/commands/webui.py
@@ -1,4 +1,4 @@
-"""`mineru-kit gradio` 的轻量命令门面。"""
+"""`mineru-kit webui` 的轻量命令门面。"""
from __future__ import annotations
@@ -55,14 +55,14 @@ def _validate_server_port(value: int) -> int:
return value
-def gradio_cmd(
+def webui_cmd(
api_url: str | None = typer.Option(None, "--api-url", help="External MinerU V1 API base URL"),
api_key: str | None = typer.Option(None, "--api-key", help="Bearer API key; falls back to MINERU_API_KEY"),
- server_name: str = typer.Option("127.0.0.1", "--server-name", help="Gradio bind host"),
+ server_name: str = typer.Option("127.0.0.1", "--server-name", help="Web UI bind host"),
server_port: int | None = typer.Option(
- None, "--server-port", help="Gradio bind port; omitted: auto-select from 7860 or GRADIO_SERVER_PORT"
+ None, "--server-port", help="Web UI bind port; omitted: auto-select from 7860 or GRADIO_SERVER_PORT"
),
- output_dir: str = typer.Option("./output", "--output-dir", help="Directory for Gradio artifacts"),
+ output_dir: str = typer.Option("./output", "--output-dir", help="Directory for Web UI artifacts"),
max_pages: int | None = typer.Option(
None, "--max-pages", help="Maximum pages per non-Flash PDF conversion; omitted: unlimited"
),
@@ -123,9 +123,9 @@ def gradio_cmd(
def main() -> None:
- """以独立 console script 运行新版 Gradio 命令。"""
+ """以独立 console script 运行Web UI 命令。"""
configure_standard_streams()
- typer.run(gradio_cmd)
+ typer.run(webui_cmd)
-__all__ = ["gradio_cmd", "main"]
+__all__ = ["webui_cmd", "main"]
diff --git a/mineru/kit/main.py b/mineru/kit/main.py
index 1779f2ed..8c4cbfe5 100644
--- a/mineru/kit/main.py
+++ b/mineru/kit/main.py
@@ -8,11 +8,11 @@ from typer.core import TyperGroup
from ..cli.version_command import show_version, version_cmd
from ..utils.stdio import configure_standard_streams
-from .commands import api_server, gradio, models, parse, router, vlm_server
+from .commands import api_server, models, parse, router, vlm_server, webui
TOP_LEVEL_COMMAND_ORDER = [
"parse",
- "gradio",
+ "webui",
"api-server",
"vlm-server",
"router",
@@ -51,7 +51,7 @@ def root(
app.add_typer(models.app, name="models")
app.command("parse")(parse.parse_cmd)
-app.command("gradio")(gradio.gradio_cmd)
+app.command("webui")(webui.webui_cmd)
app.command("api-server")(api_server.api_server_cmd)
app.command("vlm-server", context_settings=vlm_server.FORWARD_CONTEXT_SETTINGS)(vlm_server.vlm_server_cmd)
app.command("router")(router.router_cmd)
diff --git a/tests/unittest/test_kit_commands.py b/tests/unittest/test_kit_commands.py
index 20d0f773..c545526d 100644
--- a/tests/unittest/test_kit_commands.py
+++ b/tests/unittest/test_kit_commands.py
@@ -18,7 +18,7 @@ from typer.testing import CliRunner
import mineru.kit.main as kit_main
from mineru.cli.main import app as mineru_app
from mineru.cli.version_command import version_cmd
-from mineru.kit.commands import api_server, gradio, models, parse, router, vlm_server
+from mineru.kit.commands import api_server, models, parse, router, vlm_server, webui
from mineru.kit.main import app
from mineru.kit.vlm_server import mlx_vlm_server
from mineru.parser.base import ParseResult
@@ -41,22 +41,23 @@ def test_kit_main_configures_standard_streams_before_running_app(monkeypatch: py
assert calls == ["configure", "app"]
-def test_gradio_compatibility_main_runs_modern_command(monkeypatch: pytest.MonkeyPatch) -> None:
- """校验独立兼容入口复用新版 Gradio 命令且先配置标准流。"""
+def test_webui_main_runs_modern_command(monkeypatch: pytest.MonkeyPatch) -> None:
+ """校验独立入口复用 Web UI 命令且先配置标准流。"""
calls: list[object] = []
- monkeypatch.setattr(gradio, "configure_standard_streams", lambda: calls.append("configure"))
- monkeypatch.setattr(gradio.typer, "run", lambda command: calls.append(command))
+ monkeypatch.setattr(webui, "configure_standard_streams", lambda: calls.append("configure"))
+ monkeypatch.setattr(webui.typer, "run", lambda command: calls.append(command))
- gradio.main()
+ webui.main()
- assert calls == ["configure", gradio.gradio_cmd]
+ assert calls == ["configure", webui.webui_cmd]
-def test_gradio_console_script_targets_modern_command() -> None:
- """校验兼容命令不再通过已删除的旧 CLI 包启动。"""
+def test_webui_console_script_targets_modern_command() -> None:
+ """校验独立 Web UI 入口及旧命令移除。"""
project = tomllib.loads((Path(__file__).resolve().parents[2] / "pyproject.toml").read_text(encoding="utf-8"))
- assert project["project"]["scripts"]["mineru-gradio"] == "mineru.kit.commands.gradio:main"
+ assert "mineru-gradio" not in project["project"]["scripts"]
+ assert project["project"]["scripts"]["mineru-webui"] == "mineru.kit.commands.webui:main"
def _invoke_standalone_command(
@@ -130,7 +131,7 @@ def test_standalone_vlm_main_configures_streams_and_forwards_extra_args(monkeypa
@pytest.mark.parametrize(
("script", "entrypoint", "expected_options"),
[
- ("mineru-gradio", gradio.main, ("--api-url", "--api-server-tier")),
+ ("mineru-webui", webui.main, ("--api-url", "--api-server-tier")),
("mineru-openai-server", vlm_server.main, ("--engine",)),
(
"mineru-models-download",
@@ -325,7 +326,7 @@ def test_top_level_commands_register_implementation_callbacks_directly() -> None
callbacks = {command.name: command.callback for command in app.registered_commands}
assert callbacks["parse"] is parse.parse_cmd
- assert callbacks["gradio"] is gradio.gradio_cmd
+ assert callbacks["webui"] is webui.webui_cmd
assert callbacks["api-server"] is api_server.api_server_cmd
assert callbacks["vlm-server"] is vlm_server.vlm_server_cmd
assert callbacks["router"] is router.router_cmd
@@ -336,7 +337,7 @@ def test_top_level_commands_register_implementation_callbacks_directly() -> None
("command", "expected_options"),
[
("parse", ("--output", "--format", "--tier")),
- ("gradio", ("--api-url", "--server-name", "--api-server-tier")),
+ ("webui", ("--api-url", "--server-name", "--api-server-tier")),
("api-server", ("--host", "--port", "--tier", "--no-flash", "--no-advanced", "--preload-models")),
("vlm-server", ("--engine",)),
("router", ("--host", "--upstream-url", "--local-gpus")),
@@ -365,7 +366,7 @@ def test_kit_root_commands_keep_product_order() -> None:
assert command.list_commands(None) == [
"parse",
- "gradio",
+ "webui",
"api-server",
"vlm-server",
"router",
@@ -583,7 +584,7 @@ def test_api_server_rejects_backend_and_effort_options() -> None:
@pytest.mark.parametrize(
("command", "option"),
- [("api-server", "--ocr-mode"), ("gradio", "--ocr-mode"), ("gradio", "--api-server-ocr-mode")],
+ [("api-server", "--ocr-mode"), ("webui", "--ocr-mode"), ("webui", "--api-server-ocr-mode")],
)
def test_server_commands_reject_startup_ocr_configuration(command: str, option: str) -> None:
"""服务启动命令不再接受或展示 OCR 配置,单次解析命令继续提供该参数。"""
diff --git a/tests/unittest/test_kit_gradio.py b/tests/unittest/test_kit_gradio.py
index dd79ff5b..acec15eb 100644
--- a/tests/unittest/test_kit_gradio.py
+++ b/tests/unittest/test_kit_gradio.py
@@ -24,7 +24,7 @@ from typer.testing import CliRunner
from mineru.filetypes import FLASH_ONLY_PARSE_EXTENSIONS, IMAGE_EXTENSIONS, PARSEABLE_EXTENSIONS
from mineru.integrations.docvortex import build_metadata
-from mineru.kit.commands import gradio as gradio_command
+from mineru.kit.commands import webui as webui_command
from mineru.kit.gradio import app as gradio_app
from mineru.kit.gradio import client as gradio_client
from mineru.kit.gradio.app import build_gradio_app
@@ -171,13 +171,17 @@ def _httpx_proxy_for_test_client(
)
-def test_gradio_command_is_registered_and_help_is_available() -> None:
- """验证 mineru-kit 根命令注册 Gradio 且帮助不启动服务。"""
+def test_webui_command_is_registered_and_help_is_available() -> None:
+ """验证 mineru-kit 根命令注册 Web UI 且帮助不启动服务。"""
result = runner.invoke(app, ["--help"])
- gradio_result = runner.invoke(app, ["gradio", "--help"])
+ gradio_result = runner.invoke(app, ["webui", "--help"])
assert result.exit_code == 0
assert gradio_result.exit_code == 0
- assert "gradio" in result.output
+ assert "webui" in result.output
+ assert "gradio" not in result.output
+ removed_result = runner.invoke(app, ["gradio"])
+ assert removed_result.exit_code == 2
+ assert "No such command" in removed_result.output
# CI 强制彩色输出时,Rich 会在参数名内部插入 ANSI 样式码。
help_text = unstyle(gradio_result.output)
assert "--api-url" in help_text
@@ -189,7 +193,7 @@ def test_gradio_command_is_registered_and_help_is_available() -> None:
def test_gradio_managed_tier_disable_option_names_are_removed() -> None:
"""验证禁用档位的参数完整删除,不仅从帮助中隐藏。"""
root_command = get_command(app)
- command = root_command.get_command(None, "gradio")
+ command = root_command.get_command(None, "webui")
assert command is not None
options = {parameter.name: tuple(parameter.opts) for parameter in command.params}
@@ -217,37 +221,37 @@ def test_gradio_rejects_removed_tier_disable_options(
monkeypatch.setattr(gradio_app, "launch_gradio", launch)
if standalone:
- monkeypatch.setattr(sys, "argv", ["mineru-gradio", flag])
+ monkeypatch.setattr(sys, "argv", ["mineru-webui", flag])
with pytest.raises(SystemExit) as error:
- gradio_command.main()
+ webui_command.main()
assert error.value.code == 2
else:
- result = runner.invoke(app, ["gradio", flag])
+ result = runner.invoke(app, ["webui", flag])
assert result.exit_code == 2, result.output
assert "No such option" in result.output
launch.assert_not_called()
@pytest.mark.parametrize(("port_args", "expected_port"), [([], None), (["--server-port", "7861"], 7861)])
-def test_gradio_command_preserves_automatic_or_explicit_port(
+def test_webui_command_preserves_automatic_or_explicit_port(
monkeypatch: pytest.MonkeyPatch, port_args: list[str], expected_port: int | None
) -> None:
"""验证省略端口时保留 Gradio 原生自动选择,显式端口则优先于环境变量。"""
launch = Mock()
monkeypatch.setenv("GRADIO_SERVER_PORT", "17860")
monkeypatch.setattr(gradio_app, "launch_gradio", launch)
- result = runner.invoke(app, ["gradio", *port_args])
+ result = runner.invoke(app, ["webui", *port_args])
assert result.exit_code == 0, result.output
launch.assert_called_once()
assert launch.call_args.kwargs["server_port"] == expected_port
@pytest.mark.parametrize("port", [0, -1, 65536])
-def test_gradio_command_rejects_invalid_explicit_port(monkeypatch: pytest.MonkeyPatch, port: int) -> None:
+def test_webui_command_rejects_invalid_explicit_port(monkeypatch: pytest.MonkeyPatch, port: int) -> None:
"""验证显式端口仍遵循 TCP 范围约束,并在启动服务前报错。"""
launch = Mock()
monkeypatch.setattr(gradio_app, "launch_gradio", launch)
- result = runner.invoke(app, ["gradio", "--server-port", str(port)])
+ result = runner.invoke(app, ["webui", "--server-port", str(port)])
assert result.exit_code == 1
assert "server_port must be between 1 and 65535" in result.output
launch.assert_not_called()
@@ -268,9 +272,9 @@ def test_importing_kit_cli_does_not_import_optional_gradio_runtime() -> None:
assert completed.returncode == 0, completed.stderr
-def test_gradio_command_reports_optional_dependency_error(monkeypatch: pytest.MonkeyPatch) -> None:
+def test_webui_command_reports_optional_dependency_error(monkeypatch: pytest.MonkeyPatch) -> None:
"""验证未安装 Gradio 时命令给出可执行安装建议。"""
- original_find_spec = gradio_command.importlib.util.find_spec
+ original_find_spec = webui_command.importlib.util.find_spec
def fake_find_spec(name: str) -> Any:
"""只模拟 Gradio 相关模块缺失,保留其他模块探测。"""
@@ -278,8 +282,8 @@ def test_gradio_command_reports_optional_dependency_error(monkeypatch: pytest.Mo
return None
return original_find_spec(name)
- monkeypatch.setattr(gradio_command.importlib.util, "find_spec", fake_find_spec)
- result = runner.invoke(app, ["gradio"])
+ monkeypatch.setattr(webui_command.importlib.util, "find_spec", fake_find_spec)
+ result = runner.invoke(app, ["webui"])
assert result.exit_code == 1
assert "pip install" in result.output
assert "mineru[gradio]" not in result.output
diff --git a/tests/unittest/test_kit_gradio_page_range.py b/tests/unittest/test_kit_gradio_page_range.py
index d4816808..c4a966a1 100644
--- a/tests/unittest/test_kit_gradio_page_range.py
+++ b/tests/unittest/test_kit_gradio_page_range.py
@@ -43,11 +43,11 @@ def test_command_forwards_max_pages(monkeypatch: pytest.MonkeyPatch, args: list[
"""验证省略或显式配置上限时的启动参数透传。"""
launch = Mock()
monkeypatch.setattr(gradio_app, "launch_gradio", launch)
- result = CliRunner().invoke(app, ["gradio", *args])
+ result = CliRunner().invoke(app, ["webui", *args])
assert result.exit_code == 0, result.output
assert launch.call_args.kwargs["max_pages"] == expected
# 比较可见文本,避免终端颜色设置影响参数名断言。
- assert "--max-pages" in unstyle(CliRunner().invoke(app, ["gradio", "--help"]).output)
+ assert "--max-pages" in unstyle(CliRunner().invoke(app, ["webui", "--help"]).output)
@pytest.mark.parametrize("value", ["0", "-1", "1.5", "invalid"])
@@ -55,7 +55,7 @@ def test_command_rejects_invalid_max_pages(monkeypatch: pytest.MonkeyPatch, valu
"""验证非正整数配置在启动任何服务前报错。"""
launch = Mock()
monkeypatch.setattr(gradio_app, "launch_gradio", launch)
- result = CliRunner().invoke(app, ["gradio", "--max-pages", value])
+ result = CliRunner().invoke(app, ["webui", "--max-pages", value])
assert result.exit_code != 0
launch.assert_not_called()
diff --git a/tests/unittest/test_kit_gradio_pdf_preview.py b/tests/unittest/test_kit_gradio_pdf_preview.py
index 0f6305ed..bcd326f2 100644
--- a/tests/unittest/test_kit_gradio_pdf_preview.py
+++ b/tests/unittest/test_kit_gradio_pdf_preview.py
@@ -17,7 +17,7 @@ from fastapi import FastAPI
from fastapi.testclient import TestClient
from gradio.data_classes import FileData
-from mineru.kit.commands import gradio as gradio_command
+from mineru.kit.commands import webui as webui_command
from mineru.kit.gradio.app import build_gradio_app
from mineru.kit.gradio.client import V1ServerCapabilities
from mineru.kit.gradio.pdf_preview import register_pdf_preview_resources
@@ -109,11 +109,11 @@ def test_pdfjs_manifest_matches_bundled_files() -> None:
@pytest.mark.parametrize("version", ["5.49.1", "5.50.0", "6.7.0", "7.0.0"])
-def test_gradio_command_rejects_unsupported_version(monkeypatch: pytest.MonkeyPatch, version: str) -> None:
+def test_webui_command_rejects_unsupported_version(monkeypatch: pytest.MonkeyPatch, version: str) -> None:
"""即使用户跳过安装器检查,启动时仍明确拒绝旧版或未支持的主版本。"""
- monkeypatch.setattr(gradio_command, "version", Mock(return_value=version))
+ monkeypatch.setattr(webui_command, "version", Mock(return_value=version))
with pytest.raises(typer.Exit) as error:
- gradio_command._require_gradio_dependencies()
+ webui_command._require_gradio_dependencies()
assert getattr(error.value, "exit_code", None) == 1
diff --git a/tests/unittest/test_v1_router.py b/tests/unittest/test_v1_router.py
index 0615290c..e410e67d 100644
--- a/tests/unittest/test_v1_router.py
+++ b/tests/unittest/test_v1_router.py
@@ -907,7 +907,7 @@ def test_compose_router_healthcheck_uses_v1_path() -> None:
"""验证 Router Compose profile 只探测正式 `/v1/health`。"""
repo_root = Path(__file__).resolve().parents[2]
compose_text = (repo_root / "docker/compose.yaml").read_text(encoding="utf-8")
- router_section = compose_text.split(" mineru-router:", 1)[1].split(" mineru-gradio:", 1)[0]
+ router_section = compose_text.split(" mineru-router:", 1)[1].split(" mineru-webui:", 1)[0]
assert "http://localhost:8002/v1/health" in router_section
assert "http://localhost:8002/health" not in router_section