Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Python ai4sciencedocument-analysisdocxextract-datalayout-analysisocrparserpdfpdf-converterpdf-extractor-llmpdf-extractor-pretrainpdf-extractor-ragpdf-parserpptxpythonxlsx
Serve API documentation assets offline with proxy-aware authorization; Refs #5341
myhloli2ce1df8719b9
diff --git a/mineru/parser/api_server.py b/mineru/parser/api_server.pyindex 44c846dd..a43049ba 100644--- a/mineru/parser/api_server.py+++ b/mineru/parser/api_server.py@@ -30,8 +30,11 @@ import uvicornfrom docvortex.assets import validate_image_sidecar_pathfrom fastapi import APIRouter, Body, Depends, FastAPI, HTTPException, Path, Query, Request, Response, statusfrom fastapi.exceptions import RequestValidationError+from fastapi.openapi.docs import get_swagger_ui_html, get_swagger_ui_oauth2_redirect_html+from fastapi_offline import FastAPIOfflinefrom fastapi.middleware.gzip import GZipMiddlewarefrom fastapi.responses import JSONResponse+from fastapi.security import HTTPBearerfrom pydantic import BaseModel, ConfigDict, Fieldfrom starlette.datastructures import State@@ -723,8 +726,13 @@ class FileStore:# sha256sum dedupif req.sha256sum and self.blob_exists(req.sha256sum):if self._blob_abs(req.sha256sum).stat().st_size != req.bytes:- _raise_api_error(400, error_type="invalid_request_error", code="upload_size_mismatch",- message="Declared size does not match the cached file", param="bytes")+ _raise_api_error(+ 400,+ error_type="invalid_request_error",+ code="upload_size_mismatch",+ message="Declared size does not match the cached file",+ param="bytes",+ )file_id = self._new_file_id()self._files[file_id] = _FileRecord(id=file_id,@@ -2440,16 +2448,39 @@ def create_app(enable_docs = _env_flag("MINERU_API_ENABLE_FASTAPI_DOCS", default=True)- application = FastAPI(+ app_factory = FastAPIOffline if enable_docs else FastAPI+ application = app_factory(+ **({"static_url": "/docs/assets"} if enable_docs else {}),title="MinerU API",description=_FASTAPI_DESCRIPTION,version="1.0.0",openapi_tags=_OPENAPI_TAGS,+ dependencies=[Depends(HTTPBearer(auto_error=False, description="Bearer API key when configured"))],openapi_url="/openapi.json" if enable_docs else None,- docs_url="/docs" if enable_docs else None,+ docs_url=None,redoc_url="/redoc" if enable_docs else None,lifespan=_lifespan,)+ if enable_docs:++ @application.get("/docs", include_in_schema=False)+ async def _offline_swagger(request: Request) -> Response:+ """使用安装包内资源,并为反向代理补全 OAuth 回调的路径前缀。"""+ root = request.scope.get("root_path", "").rstrip("/")+ return get_swagger_ui_html(+ openapi_url=f"{root}/openapi.json",+ title="MinerU API - Swagger UI",+ swagger_js_url=f"{root}/docs/assets/swagger-ui-bundle.js",+ swagger_css_url=f"{root}/docs/assets/swagger-ui.css",+ swagger_favicon_url=f"{root}/docs/assets/favicon.png",+ oauth2_redirect_url=f"{root}/docs/oauth2-redirect",+ )++ @application.get("/docs/oauth2-redirect", include_in_schema=False)+ async def _offline_oauth_redirect() -> Response:+ """保留 Swagger 的本地 OAuth 授权回调页。"""+ return get_swagger_ui_oauth2_redirect_html()+application.state.upload_dir = _upload_dirapplication.state.tier = tierapplication.state.default_tier = default_tier@@ -2511,6 +2542,9 @@ def create_app(async def _auth_middleware(request: Request, call_next: Callable[[Request], Awaitable[Response]]) -> Response:path = request.url.path+ root = request.scope.get("root_path", "").rstrip("/")+ if root and path.startswith(root + "/"):+ path = path[len(root) :]if path in _PUBLIC_PATHS or any(path.startswith(p) for p in _PUBLIC_PREFIXES) or path.startswith("/v1/models/"):return await call_next(request)api_key = (request.app.state.api_key or "").strip()diff --git a/pyproject.toml b/pyproject.tomlindex 8a19cc50..76b01041 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -64,6 +64,7 @@ dependencies = ["aiosqlite>=0.20.0,<1","watchfiles>=1.0.0,<2","fastapi",+ "fastapi-offline>=1.7.7,<2","python-multipart","uvicorn","pydantic>=2.12.5,<3",diff --git a/tests/unittest/test_api_offline_docs.py b/tests/unittest/test_api_offline_docs.pynew file mode 100644index 00000000..e05d5fbe--- /dev/null+++ b/tests/unittest/test_api_offline_docs.py@@ -0,0 +1,39 @@+"""离线文档资源、访问控制和代理路径回归。"""++from pathlib import Path++import pytest+from fastapi.testclient import TestClient++from mineru.parser import api_server++[email protected]("root", ["", "/mineru"])+def test_offline_docs_resources_and_proxy_paths(tmp_path: Path, monkeypatch: pytest.MonkeyPatch, root: str) -> None:+ """断言 Swagger/ReDoc 全部使用本地资源,授权回调遵守代理前缀。"""+ monkeypatch.setattr(api_server, "_preflight_tier_dependencies", lambda *args: None)+ app = api_server.create_app(upload_dir=str(tmp_path), tier="flash", api_key="secret")+ with TestClient(app, root_path=root) as client:+ for page in ("/docs", "/redoc"):+ response = client.get(root + page)+ assert response.status_code == 200+ assert f"{root}/docs/assets/" in response.text+ assert "cdn.jsdelivr" not in response.text and "fonts.googleapis" not in response.text+ assert f"{root}/docs/oauth2-redirect" in client.get(root + "/docs").text+ assert client.get(root + "/docs/oauth2-redirect").status_code == 200+ for asset in ("swagger-ui-bundle.js", "swagger-ui.css", "redoc.standalone.js", "favicon.png"):+ assert client.get(f"{root}/docs/assets/{asset}").status_code == 200+ schema = client.get(root + "/openapi.json").json()+ assert schema["components"]["securitySchemes"]["HTTPBearer"]["scheme"] == "bearer"+ assert client.get(root + "/v1/files").status_code == 401+ assert client.get(root + "/v1/files", headers={"Authorization": "Bearer secret"}).status_code == 200+++def test_disabled_docs_mount_no_resources(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:+ """关闭文档时不挂载静态资源,三个既有文档入口全部不可访问。"""+ monkeypatch.setattr(api_server, "_preflight_tier_dependencies", lambda *args: None)+ monkeypatch.setenv("MINERU_API_ENABLE_FASTAPI_DOCS", "false")+ app = api_server.create_app(upload_dir=str(tmp_path), tier="flash")+ with TestClient(app) as client:+ for path in ("/docs", "/redoc", "/openapi.json", "/docs/assets/favicon.png"):+ assert client.get(path).status_code == 404