后端服务化

docutranslate/app.py

@@ -1,5 +1,3 @@
-# 文件名: main.py (或您使用的任何文件名)
-
 import asyncio
 import base64
 import io
@@ -10,7 +8,6 @@ import time
 from contextlib import asynccontextmanager, closing
 from pathlib import Path
 from typing import List, Dict, Any, Optional
-import re
 from urllib.parse import quote
 
 import httpx
@@ -18,22 +15,23 @@ import uvicorn
 from fastapi import FastAPI, File, Form, UploadFile, Request, HTTPException, Query, APIRouter, Body
 from fastapi.responses import HTMLResponse, JSONResponse, StreamingResponse, FileResponse
 from fastapi.staticfiles import StaticFiles
+from pydantic import BaseModel, Field
+
 from docutranslate import FileTranslater, __version__
 from docutranslate.logger import translater_logger
 from docutranslate.translater import default_params
 from docutranslate.utils.resource_utils import resource_path
 from docutranslate.global_values import available_packages
 
-httpx_client = httpx.AsyncClient()
+# --- 全局配置 ---
-
-# --- 全局配置 (无修改) ---
 tasks_state: Dict[str, Dict[str, Any]] = {}
 tasks_log_queues: Dict[str, asyncio.Queue] = {}
 tasks_log_histories: Dict[str, List[str]] = {}
 MAX_LOG_HISTORY = 200
+httpx_client: httpx.AsyncClient
 
 
-# --- 辅助函数 (无修改) ---
+# --- 辅助函数 ---
 def _create_default_task_state() -> Dict[str, Any]:
     return {
         "is_processing": False, "status_message": "空闲", "error_flag": False,
@@ -71,10 +69,12 @@ class QueueAndHistoryHandler(logging.Handler):
                 print(f"Error putting log to queue for task: {e}. Log: {log_entry}")
 
 
-# --- 应用生命周期事件 (无修改) ---
+# --- 应用生命周期事件 ---
 @asynccontextmanager
 async def lifespan(app: FastAPI):
+    global httpx_client
     app.state.main_event_loop = asyncio.get_running_loop()
+    httpx_client = httpx.AsyncClient()
     tasks_state.clear()
     tasks_log_queues.clear()
     tasks_log_histories.clear()
@@ -84,9 +84,11 @@ async def lifespan(app: FastAPI):
     translater_logger.setLevel(logging.INFO)
     print("应用启动完成，多任务状态已初始化。")
     yield
+    await httpx_client.aclose()
+    print("应用关闭，资源已清理。")
 
 
-# --- Background Task Logic (无修改) ---
+# --- Background Task Logic (核心业务逻辑, 仅由服务层调用) ---
 async def _perform_translation(task_id: str, params: Dict[str, Any], file_contents: bytes, original_filename: str):
     task_state = tasks_state[task_id]
     log_queue = tasks_log_queues[task_id]
@@ -157,13 +159,13 @@ async def _perform_translation(task_id: str, params: Dict[str, Any], file_conten
         translater_logger.removeHandler(task_handler)
 
 
-# --- 核心任务启动与取消逻辑 (新增辅助函数，避免代码重复) ---
+# --- 核心任务启动与取消逻辑 (仅由服务层调用) ---
 async def _start_translation_task(
         task_id: str,
         params: Dict[str, Any],
-        file: UploadFile
+        file_contents: bytes,
+        original_filename: str
 ):
-    """通用任务启动逻辑"""
     if task_id not in tasks_state:
         tasks_state[task_id] = _create_default_task_state()
         tasks_log_queues[task_id] = asyncio.Queue()
@@ -171,17 +173,13 @@ async def _start_translation_task(
     task_state = tasks_state[task_id]
 
     if task_state["is_processing"] and task_state["current_task_ref"] and not task_state["current_task_ref"].done():
-        raise HTTPException(
+        raise HTTPException(status_code=429, detail=f"任务ID '{task_id}' 正在进行中，请稍后再试。")
-            status_code=429,
-            detail=f"任务ID '{task_id}' 正在进行中，请稍后再试。"
-        )
 
     task_state["is_processing"] = True
-    original_filename_for_init = file.filename or "uploaded_file"
     task_state.update({
         "status_message": "任务初始化中...", "error_flag": False, "download_ready": False,
         "markdown_content": None, "md_zip_content": None, "html_content": None,
-        "original_filename_stem": Path(original_filename_for_init).stem,
+        "original_filename_stem": Path(original_filename).stem,
         "task_start_time": time.time(), "task_end_time": 0, "current_task_ref": None,
     })
 
@@ -194,32 +192,23 @@ async def _start_translation_task(
         except asyncio.QueueEmpty:
             break
 
-    initial_log_msg = f"收到新的翻译请求: {original_filename_for_init}"
+    initial_log_msg = f"收到新的翻译请求: {original_filename}"
     print(f"[{task_id}] {initial_log_msg}")
     log_history.append(initial_log_msg)
     await log_queue.put(initial_log_msg)
 
     try:
-        file_contents = await file.read()
-        original_filename = file.filename
-        await file.close()
-
         loop = asyncio.get_running_loop()
-        task = loop.create_task(
+        task = loop.create_task(_perform_translation(task_id, params, file_contents, original_filename))
-            _perform_translation(task_id, params, file_contents, original_filename)
-        )
         task_state["current_task_ref"] = task
         return {"task_started": True, "task_id": task_id, "message": "翻译任务已成功启动，请稍候..."}
     except Exception as e:
-        task_state.update({
+        task_state.update({"is_processing": False, "status_message": f"启动任务失败: {e}", "error_flag": True,
-            "is_processing": False, "status_message": f"启动任务失败: {e}",
+                           "current_task_ref": None})
-            "error_flag": True, "current_task_ref": None
-        })
         raise HTTPException(status_code=500, detail=f"启动翻译任务时出错: {e}")
 
 
 def _cancel_translation_logic(task_id: str):
-    """通用任务取消逻辑"""
     task_state = tasks_state.get(task_id)
     if not task_state or not task_state["is_processing"] or not task_state["current_task_ref"]:
         raise HTTPException(status_code=400, detail=f"任务ID '{task_id}' 没有正在进行的翻译任务可取消。")
@@ -246,160 +235,58 @@ app.mount("/static", StaticFiles(directory=STATIC_DIR), name="static")
 
 
 # ===================================================================
-# --- API Endpoints for Frontend (/backend) ---
+# --- Pydantic Models for Service API ---
 # ===================================================================
-
+class TranslateServiceRequest(BaseModel):
-@backend_router.post("/translate")
+    task_id: str = Field("0", description="任务ID，用于跟踪，默认为'0'")
-async def handle_translate_for_frontend(
+    base_url: str
-        task_id: str = Form("0"), base_url: str = Form(...), apikey: str = Form(...),
+    apikey: str
-        model_id: str = Form(...), to_lang: str = Form("中文"), formula_ocr: bool = Form(False),
+    model_id: str
-        code_ocr: bool = Form(False), refine_markdown: bool = Form(False),
+    to_lang: str = "中文"
-        convert_engin: str = Form(...), mineru_token: Optional[str] = Form(None),
+    formula_ocr: bool = False
-        chunk_size: int = Form(...), concurrent: int = Form(...),
+    code_ocr: bool = False
-        temperature: float = Form(...), custom_prompt_translate: Optional[str] = Form(None),
+    refine_markdown: bool = False
-        file: UploadFile = File(...)
+    convert_engin: str
-):
+    mineru_token: Optional[str] = None
-    task_params = locals().copy()
+    chunk_size: int
-    task_params.pop('file')
+    concurrent: int
-    task_params.pop('task_id')
+    temperature: float
-    try:
+    custom_prompt_translate: Optional[str] = None
-        response_data = await _start_translation_task(task_id, task_params, file)
+    file_name: str = Field(..., description="上传的原始文件名")
-        return JSONResponse(content=response_data)
+    file_content: str = Field(..., description="Base64编码的文件内容")
-    except HTTPException as e:
-        return JSONResponse(status_code=e.status_code, content={"task_started": False, "message": e.detail})
-
-
-@backend_router.post("/cancel-translate")
-async def cancel_translate_for_frontend(task_id: str = Form("0")):
-    try:
-        response_data = _cancel_translation_logic(task_id)
-        return JSONResponse(content=response_data)
-    except HTTPException as e:
-        return JSONResponse(status_code=e.status_code, content={"cancelled": False, "message": e.detail})
-
-
-@backend_router.get("/get-status")
-async def get_status_for_frontend(task_id: str = Query("0")):
-    task_state = tasks_state.get(task_id, _create_default_task_state())
-
-    def generate_url(path_prefix, filename_stem, extension):
-        if task_state["download_ready"] and filename_stem:
-            # 关键修改：在URL前添加 /backend 前缀
-            return f"/backend/download/{path_prefix}/{filename_stem}_translated.{extension}?task_id={task_id}"
-        return None
-
-    return JSONResponse(content={
-        "is_processing": task_state["is_processing"],
-        "status_message": task_state["status_message"],
-        "error_flag": task_state["error_flag"],
-        "download_ready": task_state["download_ready"],
-        "original_filename_stem": task_state["original_filename_stem"],
-        "markdown_url": generate_url("markdown", task_state["original_filename_stem"], "md"),
-        "markdown_zip_url": generate_url("markdown_zip", task_state["original_filename_stem"], "zip"),
-        "html_url": generate_url("html", task_state["original_filename_stem"], "html"),
-        "task_start_time": task_state["task_start_time"],
-        "task_end_time": task_state["task_end_time"],
-    })
-
-
-@backend_router.get("/download/{file_type}/{filename_with_ext}")
-async def download_file_for_frontend(
-        file_type: str, filename_with_ext: str, task_id: str = Query(...)
-):
-    task_state = tasks_state.get(task_id)
-    if not task_state:
-        raise HTTPException(status_code=404, detail=f"找不到任务ID '{task_id}'。")
-    if not task_state["download_ready"] or not task_state["original_filename_stem"]:
-        raise HTTPException(status_code=404, detail="内容尚未准备好或不可用。")
-    if Path(filename_with_ext).stem != f"{task_state['original_filename_stem']}_translated":
-        raise HTTPException(status_code=404, detail="请求的文件名与当前结果不符。")
-
-    content_map = {
-        "markdown": (task_state["markdown_content"], "text/markdown",
-                     f"{task_state['original_filename_stem']}_translated.md"),
-        "markdown_zip": (task_state["markdown_zip_content"], "application/zip",
-                         f"{task_state['original_filename_stem']}_translated.zip"),
-        "html": (task_state["html_content"], "text/html", f"{task_state['original_filename_stem']}_translated.html"),
-    }
-    if file_type not in content_map:
-        raise HTTPException(status_code=404, detail="无效的文件类型。")
-    content, media_type, actual_filename = content_map[file_type]
-    if content is None:
-        raise HTTPException(status_code=404, detail=f"{file_type.capitalize()} 内容不可用。")
-
-    headers = {
-        "Content-Disposition": f"attachment; filename*=UTF-8''{quote(actual_filename, safe='', encoding='utf-8')}"}
-    if file_type == "html":
-        return HTMLResponse(content=content, media_type=media_type, headers=headers)
-    elif file_type == "markdown_zip":
-        return StreamingResponse(io.BytesIO(content), media_type=media_type, headers=headers)
-    else:
-        return StreamingResponse(io.StringIO(content), media_type=media_type, headers=headers)
-
-
-@backend_router.get("/get-logs")
-async def get_logs_from_queue_for_frontend(task_id: str = Query("0")):
-    log_queue = tasks_log_queues.get(task_id)
-    new_logs = []
-    if log_queue:
-        while not log_queue.empty():
-            try:
-                new_logs.append(log_queue.get_nowait())
-                log_queue.task_done()
-            except asyncio.QueueEmpty:
-                break
-    return JSONResponse(content={"logs": new_logs})
-
-
-@backend_router.get("/get-engin-list")
-async def get_engin_list_for_frontend():
-    engin_list = ["mineru"]
-    if available_packages.get("docling"):
-        engin_list.append("docling")
-    return JSONResponse(content=engin_list)
-
-
-@backend_router.get("/translate/default_param")
-def get_default_param_for_frontend():
-    return JSONResponse(content=default_params)
-
-
-@backend_router.get("/meta")
-async def get_app_version_for_frontend():
-    return JSONResponse(content={"version": __version__})
 
 
 # ===================================================================
-# --- API Endpoints for Service (/service) ---
+# --- Service Endpoints (/service) ---
 # ===================================================================
 
-@service_router.post("/translate", summary="提交翻译任务")
+@service_router.post("/translate", summary="提交翻译任务 (JSON/Base64)")
-async def handle_translate_for_service(
+async def service_translate(request: TranslateServiceRequest = Body(...)):
-        file: UploadFile = File(..., description="要翻译的文档文件"),
-        task_id: str = Form("0", description="任务ID，用于跟踪，默认为'0'"),
-        base_url: str = Form(...), apikey: str = Form(...), model_id: str = Form(...),
-        to_lang: str = Form("中文"), formula_ocr: bool = Form(False), code_ocr: bool = Form(False),
-        refine_markdown: bool = Form(False), convert_engin: str = Form(...),
-        mineru_token: Optional[str] = Form(None), chunk_size: int = Form(...),
-        concurrent: int = Form(...), temperature: float = Form(...),
-        custom_prompt_translate: Optional[str] = Form(None),
-):
     """
     提交一个文件进行翻译，并启动一个后台任务。
+    文件内容需以Base64编码。
     返回任务ID，后续可凭此ID查询状态和下载结果。
     """
-    task_params = locals().copy()
-    task_params.pop('file')
-    task_params.pop('task_id')
     try:
-        response_data = await _start_translation_task(task_id, task_params, file)
+        file_contents = base64.b64decode(request.file_content)
+    except (base64.binascii.Error, TypeError) as e:
+        raise HTTPException(status_code=400, detail=f"无效的Base64文件内容: {e}")
+
+    params = request.dict(exclude={'file_name', 'file_content', 'task_id'})
+    try:
+        response_data = await _start_translation_task(
+            task_id=request.task_id,
+            params=params,
+            file_contents=file_contents,
+            original_filename=request.file_name
+        )
         return JSONResponse(content=response_data)
     except HTTPException as e:
         return JSONResponse(status_code=e.status_code, content={"task_started": False, "message": e.detail})
 
 
 @service_router.post("/cancel/{task_id}", summary="取消翻译任务")
-async def cancel_translate_for_service(task_id: str):
+async def service_cancel_translate(task_id: str):
     """根据任务ID取消一个正在进行的翻译任务。"""
     try:
         response_data = _cancel_translation_logic(task_id)
@@ -409,17 +296,14 @@ async def cancel_translate_for_service(task_id: str):
 
 
 @service_router.get("/status/{task_id}", summary="获取任务状态")
-async def get_status_for_service(task_id: str):
+async def service_get_status(task_id: str):
     """根据任务ID获取任务的当前状态和结果下载链接。"""
     task_state = tasks_state.get(task_id)
     if not task_state:
         raise HTTPException(status_code=404, detail=f"找不到任务ID '{task_id}'。")
 
     def generate_service_url(file_type):
-        if task_state["download_ready"]:
+        return f"/service/download/{task_id}/{file_type}" if task_state["download_ready"] else None
-            # 关键修改：生成 /service 的下载链接
-            return f"/service/download/{task_id}/{file_type}"
-        return None
 
     return JSONResponse(content={
         "task_id": task_id,
@@ -427,8 +311,9 @@ async def get_status_for_service(task_id: str):
         "status_message": task_state["status_message"],
         "error_flag": task_state["error_flag"],
         "download_ready": task_state["download_ready"],
-        "task_duration_seconds": (task_state["task_end_time"] - task_state["task_start_time"]) if task_state[
+        "original_filename_stem": task_state["original_filename_stem"],
-                                                                                                      "task_end_time"] > 0 else 0,
+        "task_start_time": task_state["task_start_time"],
+        "task_end_time": task_state["task_end_time"],
         "downloads": {
             "markdown": generate_service_url("markdown"),
             "markdown_zip": generate_service_url("markdown_zip"),
@@ -438,7 +323,7 @@ async def get_status_for_service(task_id: str):
 
 
 @service_router.get("/logs/{task_id}", summary="获取任务日志")
-async def get_logs_for_service(task_id: str):
+async def service_get_logs(task_id: str):
     """获取指定任务ID自上次查询以来的新日志。"""
     if task_id not in tasks_log_queues:
         raise HTTPException(status_code=404, detail=f"找不到任务ID '{task_id}' 的日志队列。")
@@ -454,16 +339,154 @@ async def get_logs_for_service(task_id: str):
 
 
 @service_router.get("/download/{task_id}/{file_type}", summary="下载结果文件")
-async def download_file_for_service(task_id: str, file_type: str):
+async def service_download_file(task_id: str, file_type: str):
     """根据任务ID和文件类型下载翻译结果。"""
-    # 此接口直接复用前端的下载逻辑，因为它们本质上是相同的
     task_state = tasks_state.get(task_id)
-    if not task_state or not task_state["download_ready"]:
+    if not task_state: raise HTTPException(status_code=404, detail=f"找不到任务ID '{task_id}'。")
-        raise HTTPException(status_code=404, detail="任务不存在或结果尚未就绪。")
+    if not task_state["download_ready"]: raise HTTPException(status_code=404, detail="内容尚未准备好。")
 
-    filename_with_ext = f"{task_state['original_filename_stem']}_translated.{'md' if file_type == 'markdown' else 'zip' if file_type == 'markdown_zip' else 'html'}"
+    content_map = {
+        "markdown": (task_state["markdown_content"], "text/markdown",
+                     f"{task_state['original_filename_stem']}_translated.md"),
+        "markdown_zip": (task_state["markdown_zip_content"], "application/zip",
+                         f"{task_state['original_filename_stem']}_translated.zip"),
+        "html": (task_state["html_content"], "text/html", f"{task_state['original_filename_stem']}_translated.html"),
+    }
+    if file_type not in content_map: raise HTTPException(status_code=404, detail="无效的文件类型。")
 
-    return await download_file_for_frontend(file_type, filename_with_ext, task_id)
+    content, media_type, filename = content_map[file_type]
+    if content is None: raise HTTPException(status_code=404, detail=f"{file_type.capitalize()} 内容不可用。")
+
+    headers = {"Content-Disposition": f"attachment; filename*=UTF-8''{quote(filename, safe='', encoding='utf-8')}"}
+    if isinstance(content, str): return StreamingResponse(io.StringIO(content), media_type=media_type, headers=headers)
+    return StreamingResponse(io.BytesIO(content), media_type=media_type, headers=headers)
+
+
+@service_router.get("/engin-list", summary="获取可用引擎列表")
+async def service_get_engin_list():
+    engin_list = ["mineru"]
+    if available_packages.get("docling"): engin_list.append("docling")
+    return JSONResponse(content=engin_list)
+
+
+@service_router.get("/default-params", summary="获取默认翻译参数")
+def service_get_default_params():
+    return JSONResponse(content=default_params)
+
+
+@service_router.get("/meta", summary="获取应用版本信息")
+async def service_get_app_version():
+    return JSONResponse(content={"version": __version__})
+
+
+# ===================================================================
+# --- Backend Endpoints for Frontend (/backend) ---
+# --- (Calls /service endpoints) ---
+# ===================================================================
+
+async def _proxy_request(request: Request, method: str, service_path: str, **kwargs):
+    """Helper to proxy requests to the service layer."""
+    service_url = f"{str(request.base_url).rstrip('/')}{service_path}"
+    try:
+        response = await httpx_client.request(method, service_url, timeout=30.0, **kwargs)
+        response.raise_for_status()
+        if "application/json" in response.headers.get("content-type", ""):
+            return JSONResponse(content=response.json(), status_code=response.status_code)
+        # For streaming downloads
+        return StreamingResponse(response.aiter_bytes(), status_code=response.status_code, headers=response.headers)
+    except httpx.HTTPStatusError as e:
+        content = e.response.json() if "application/json" in e.response.headers.get("content-type", "") else {
+            "detail": e.response.text}
+        return JSONResponse(content=content, status_code=e.response.status_code)
+    except httpx.RequestError as e:
+        return JSONResponse(status_code=503, content={"detail": f"服务调用失败: {e}"})
+
+
+@backend_router.post("/translate")
+async def handle_translate_for_frontend(
+        request: Request, task_id: str = Form("0"), base_url: str = Form(...), apikey: str = Form(...),
+        model_id: str = Form(...), to_lang: str = Form("中文"), formula_ocr: bool = Form(False),
+        code_ocr: bool = Form(False), refine_markdown: bool = Form(False), convert_engin: str = Form(...),
+        mineru_token: Optional[str] = Form(None), chunk_size: int = Form(...), concurrent: int = Form(...),
+        temperature: float = Form(...), custom_prompt_translate: Optional[str] = Form(None),
+        file: UploadFile = File(...)
+):
+    file_contents = await file.read()
+    await file.close()
+    file_base64 = base64.b64encode(file_contents).decode('utf-8')
+
+    payload = {
+        "task_id": task_id, "base_url": base_url, "apikey": apikey, "model_id": model_id,
+        "to_lang": to_lang, "formula_ocr": formula_ocr, "code_ocr": code_ocr,
+        "refine_markdown": refine_markdown, "convert_engin": convert_engin, "mineru_token": mineru_token,
+        "chunk_size": chunk_size, "concurrent": concurrent, "temperature": temperature,
+        "custom_prompt_translate": custom_prompt_translate, "file_name": file.filename, "file_content": file_base64,
+    }
+    return await _proxy_request(request, "POST", "/service/translate", json=payload)
+
+
+@backend_router.post("/cancel-translate")
+async def cancel_translate_for_frontend(request: Request, task_id: str = Form("0")):
+    return await _proxy_request(request, "POST", f"/service/cancel/{task_id}")
+
+
+@backend_router.get("/get-status")
+async def get_status_for_frontend(request: Request, task_id: str = Query("0")):
+    service_url = f"{str(request.base_url).rstrip('/')}/service/status/{task_id}"
+    try:
+        response = await httpx_client.get(service_url)
+        if response.status_code == 404:
+            return JSONResponse(content=_create_default_task_state())  # Return default state for UI
+        response.raise_for_status()
+        service_data = response.json()
+    except httpx.RequestError as e:
+        return JSONResponse(status_code=503, content={"detail": f"服务调用失败: {e}"})
+
+    # Adapt service response for the frontend (generate frontend-specific URLs)
+    filename_stem = service_data.get("original_filename_stem")
+
+    def generate_frontend_url(path_prefix, ext):
+        if service_data["download_ready"] and filename_stem:
+            return f"/backend/download/{path_prefix}/{filename_stem}_translated.{ext}?task_id={task_id}"
+        return None
+
+    return JSONResponse(content={
+        "is_processing": service_data["is_processing"], "status_message": service_data["status_message"],
+        "error_flag": service_data["error_flag"], "download_ready": service_data["download_ready"],
+        "original_filename_stem": filename_stem,
+        "markdown_url": generate_frontend_url("markdown", "md"),
+        "markdown_zip_url": generate_frontend_url("markdown_zip", "zip"),
+        "html_url": generate_frontend_url("html", "html"),
+        "task_start_time": service_data.get("task_start_time", 0),
+        "task_end_time": service_data.get("task_end_time", 0),
+    })
+
+
+@backend_router.get("/download/{file_type}/{filename_with_ext}")
+async def download_file_for_frontend(request: Request, file_type: str, filename_with_ext: str,
+                                     task_id: str = Query(...)):
+    # filename_with_ext is for vanity, real identifiers are task_id and file_type
+    return await _proxy_request(request, "GET", f"/service/download/{task_id}/{file_type}")
+
+
+@backend_router.get("/get-logs")
+async def get_logs_from_queue_for_frontend(request: Request, task_id: str = Query("0")):
+    return await _proxy_request(request, "GET", f"/service/logs/{task_id}")
+
+
+@backend_router.get("/get-engin-list")
+async def get_engin_list_for_frontend(request: Request):
+    return await _proxy_request(request, "GET", "/service/engin-list")
+
+
+@backend_router.get("/translate/default_param")
+async def get_default_param_for_frontend(request: Request):
+    return await _proxy_request(request, "GET", "/service/default-params")
+
+
+@backend_router.get("/meta")
+async def get_app_version_for_frontend(request: Request):
+    return await _proxy_request(request, "GET", "/service/meta")
 
 
 # ===================================================================
@@ -473,15 +496,11 @@ async def download_file_for_service(task_id: str, file_type: str):
 @app.get("/", response_class=HTMLResponse, include_in_schema=False)
 async def main_page():
     index_path = Path(STATIC_DIR) / "index.html"
-    if not index_path.exists():
+    if not index_path.exists(): raise HTTPException(status_code=404, detail="index.html not found")
-        raise HTTPException(status_code=404, detail="index.html not found")
+    no_cache_headers = {"Cache-Control": "no-store, no-cache, must-revalidate, max-age=0", "Pragma": "no-cache",
-    no_cache_headers = {
+                        "Expires": "0"}
-        "Cache-Control": "no-store, no-cache, must-revalidate, max-age=0",
-        "Pragma": "no-cache", "Expires": "0",
-    }
     return FileResponse(index_path, headers=no_cache_headers)
 
-
 @app.post("/temp/translate")
 async def temp_translate(base_url: str = Body(...),
                          api_key: str = Body(...),
@@ -514,6 +533,7 @@ async def temp_translate(base_url: str = Body(...),
             print(f"翻译出现错误：{e.__repr__()}")
             return  {"success":False,"reason":{e.__repr__()}}
 
+
 # 包含两个路由组
 app.include_router(backend_router)
 app.include_router(service_router)
@@ -524,8 +544,7 @@ def find_free_port(start_port):
     port = start_port
     while True:
         with closing(socket.socket(socket.AF_INET, socket.SOCK_STREAM)) as sock:
-            if sock.connect_ex(('127.0.0.1', port)) != 0:
+            if sock.connect_ex(('127.0.0.1', port)) != 0: return port
-                return port
             port += 1
 
 
@@ -533,12 +552,9 @@ def run_app(port: int | None = None):
     initial_port = port or int(os.environ.get("DOCUTRANSLATE_PORT", 8010))
     try:
         port_to_use = find_free_port(initial_port)
-        if port_to_use != initial_port:
+        if port_to_use != initial_port: print(f"端口 {initial_port} 被占用，将使用端口 {port_to_use} 代替")
-            print(f"端口 {initial_port} 被占用，将使用端口 {port_to_use} 代替")
         print(f"正在启动 DocuTranslate WebUI 版本号：{__version__}")
         print(f"请用浏览器访问 http://127.0.0.1:{port_to_use}")
-        print("API文档 (Swagger UI):")
-        print(f"  接口文档: http://127.0.0.1:{port_to_use}/docs")
         uvicorn.run(app, host=None, port=port_to_use, workers=1)
     except Exception as e:
         print(f"启动失败: {e}")