feat(park-desktop): admin 后台新 UI + vision_yolo 手势接入（merge 自旧仓库 4e73a6b）

backend/app/main.py

@@ -14,7 +14,7 @@ from pathlib import Path
 
 from fastapi import FastAPI, Request
 from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import FileResponse, JSONResponse
+from fastapi.responses import FileResponse, JSONResponse, RedirectResponse
 from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel
 
@@ -108,8 +108,8 @@ app.add_api_route("/admin/logout", admin_logout, methods=["GET"], include_in_sch
 _DOWNLOAD_ROOT = Path(__file__).resolve().parent.parent  # backend/
 
 
-@app.get("/download", include_in_schema=False)
-@app.get("/11", include_in_schema=False)
+@app.get("/download")
+@app.get("/11")
 async def download_installer():
     """下载 Windows 客户端安装包（backend/ 下 *.setup.exe，如 云超服..._x64-setup.exe）。"""
     for f in sorted(_DOWNLOAD_ROOT.glob("*setup.exe")):
@@ -146,7 +146,7 @@ class UpdateCheckBody(BaseModel):
     current: str = ""   # 前端上报的当前版本，如 0.1.0
 
 
-@app.post("/api/update/check", include_in_schema=False)
+@app.post("/api/update/check")
 async def update_check(body: UpdateCheckBody):
     """检测更新：返回最新版本号、安装包下载地址、是否需要更新（仅 Windows）。"""
     inst = _latest_installer()
@@ -171,17 +171,7 @@ async def update_check(body: UpdateCheckBody):
 # ---------- 前端静态托管 + SPA 回退（浏览器直接访问 :8000 即可） ----------
 
 @app.get("/{path:path}", include_in_schema=False)
-async def spa_fallback(path: str):
-    if not DIST.exists():
-        return JSONResponse({"detail": "前端未构建（dist 目录不存在）"}, status_code=404)
-    dist = DIST.resolve()
-    if not path:
-        target = dist / "index.html"
-    else:
-        target = (dist / path).resolve()
-    if target.is_file() and target.is_relative_to(dist):
-        return FileResponse(target)
-    index = dist / "index.html"
-    if index.exists():
-        return FileResponse(index)
-    return JSONResponse({"detail": "Not Found"}, status_code=404)
+async def spa_fallback(request: Request):
+    """默认导向管理后台：屏蔽通过后端地址直接访问大屏前端（含首页 / 及 /twin /ai /screen 等）。
+       /api、/admin、/static、/file 等已在更早路由/挂载处理，不会走到这里。"""
+    return RedirectResponse(url="/admin", status_code=307)