fix

app.py

@@ -15,21 +15,25 @@ from config import (
     IMAGES_DIR,
     YOLO_AVAILABLE,
     ENABLE_LOGGING,
+    HUGGINGFACE_SYNC_ENABLED,
 )
 from database import close_mysql_pool, init_mysql_pool
 from utils import ensure_bos_resources, ensure_huggingface_models
 
 logger.info("Starting to import api_routes module...")
 
-try:
-    t_hf_start = time.perf_counter()
-    if not ensure_huggingface_models():
-        raise RuntimeError("无法从 HuggingFace 同步模型，请检查配置与网络")
-    hf_time = time.perf_counter() - t_hf_start
-    logger.info(f"HuggingFace models synchronized successfully, time: {hf_time:.3f}s")
-except Exception as exc:
-    logger.error(f"HuggingFace model preparation failed: {exc}")
-    raise
+if HUGGINGFACE_SYNC_ENABLED:
+    try:
+        t_hf_start = time.perf_counter()
+        if not ensure_huggingface_models():
+            raise RuntimeError("无法从 HuggingFace 同步模型，请检查配置与网络")
+        hf_time = time.perf_counter() - t_hf_start
+        logger.info("HuggingFace 模型同步完成，用时 %.3fs", hf_time)
+    except Exception as exc:
+        logger.error(f"HuggingFace model preparation failed: {exc}")
+        raise
+else:
+    logger.info("已关闭 HuggingFace 模型同步开关，跳过启动阶段的同步步骤")
 
 try:
     t_bos_start = time.perf_counter()

build.sh

@@ -0,0 +1 @@
+python -m compileall -q -f -b .

config.py

@@ -228,6 +228,9 @@ MODELS_DOWNLOAD_DIR = os.path.abspath(
     os.path.expanduser(os.environ.get("MODELS_DOWNLOAD_DIR", MODELS_PATH))
 )
 # HuggingFace 仓库配置
+HUGGINGFACE_SYNC_ENABLED = os.environ.get(
+    "HUGGINGFACE_SYNC_ENABLED", "true"
+).lower() in ("1", "true", "on")
 HUGGINGFACE_REPO_ID = os.environ.get(
     "HUGGINGFACE_REPO_ID", "ethonmax/facescore"
 ).strip()

utils.py

@@ -33,6 +33,7 @@ from config import (
     BOS_UPLOAD_ENABLED,
     BOS_DOWNLOAD_TARGETS,
     HUGGINGFACE_REPO_ID,
+    HUGGINGFACE_SYNC_ENABLED,
     HUGGINGFACE_REVISION,
     HUGGINGFACE_ALLOW_PATTERNS,
     HUGGINGFACE_IGNORE_PATTERNS,
@@ -256,6 +257,10 @@ def _get_background_executor() -> ThreadPoolExecutor:
 
 def ensure_huggingface_models(force_download: bool = False) -> bool:
     """确保 HuggingFace 模型仓库同步到本地 MODELS_PATH。"""
+    if not HUGGINGFACE_SYNC_ENABLED:
+        logger.info("HuggingFace 模型同步开关已关闭，跳过同步流程")
+        return True
+
     repo_id = (HUGGINGFACE_REPO_ID or "").strip()
     if not repo_id:
         logger.info("未配置 HuggingFace 仓库，跳过模型下载")