fix(ci): 修复pip --break-system-packages兼容性问题

旧Runner使用pip 22.0.2不支持--break-system-packages参数。
动态检测pip版本，兼容新旧Runner环境。

.gitea/workflows/ci-cd.yml

@@ -91,10 +91,16 @@ jobs:
       - name: Install dependencies
         shell: sh
         run: |
+          # Detect pip --break-system-packages support (pip >= 23.0 / PEP 668)
+          PIP_BREAK_FLAG=""
+          if python3 -m pip install --help 2>/dev/null | grep -q "break-system-packages"; then
+            PIP_BREAK_FLAG="--break-system-packages"
+          fi
+          echo "PIP_BREAK_FLAG=$PIP_BREAK_FLAG" >> "$GITHUB_ENV"
           set -eu
-          python3 -m pip install --break-system-packages -q -r requirements-base.txt
-          python3 -m pip install --break-system-packages -q -r requirements.txt
-          python3 -m pip install --break-system-packages -q -r requirements-dev.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements-base.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements-dev.txt
           python3 -m black --version
           python3 -m isort --version-number
           python3 -m flake8 --version
@@ -220,10 +226,16 @@ jobs:
       - name: Install dependencies
         shell: sh
         run: |
+          # Detect pip --break-system-packages support (pip >= 23.0 / PEP 668)
+          PIP_BREAK_FLAG=""
+          if python3 -m pip install --help 2>/dev/null | grep -q "break-system-packages"; then
+            PIP_BREAK_FLAG="--break-system-packages"
+          fi
+          echo "PIP_BREAK_FLAG=$PIP_BREAK_FLAG" >> "$GITHUB_ENV"
           set -eu
-          python3 -m pip install --break-system-packages -q -r requirements-base.txt
-          python3 -m pip install --break-system-packages -q -r requirements.txt
-          python3 -m pip install --break-system-packages -q -r requirements-dev.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements-base.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements-dev.txt
           pytest --version
 
       - name: Run unit tests with coverage
@@ -319,10 +331,16 @@ jobs:
       - name: Install dependencies
         shell: sh
         run: |
+          # Detect pip --break-system-packages support (pip >= 23.0 / PEP 668)
+          PIP_BREAK_FLAG=""
+          if python3 -m pip install --help 2>/dev/null | grep -q "break-system-packages"; then
+            PIP_BREAK_FLAG="--break-system-packages"
+          fi
+          echo "PIP_BREAK_FLAG=$PIP_BREAK_FLAG" >> "$GITHUB_ENV"
           set -eu
-          python3 -m pip install --break-system-packages -q -r requirements-base.txt
-          python3 -m pip install --break-system-packages -q -r requirements.txt
-          python3 -m pip install --break-system-packages -q -r requirements-dev.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements-base.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements.txt
+          python3 -m pip install $PIP_BREAK_FLAG -q -r requirements-dev.txt
           pytest --version
 
       - name: Start Redis
@@ -394,7 +412,7 @@ jobs:
         shell: sh
         run: |
           set -eu
-          pip install --break-system-packages -q pytest-rerunfailures
+          pip install $PIP_BREAK_FLAG -q pytest-rerunfailures
           PYTHONPATH="$PWD/apps/api:$PWD" python3 -m coverage run --append \
             --source=apps/api/app,packages \
             --omit="*/migrations/*,*/tests/*,*/test_*.py,*/site-packages/*" \
@@ -536,6 +554,12 @@ jobs:
       - name: Install dependencies
         shell: sh
         run: |
+          # Detect pip --break-system-packages support (pip >= 23.0 / PEP 668)
+          PIP_BREAK_FLAG=""
+          if python3 -m pip install --help 2>/dev/null | grep -q "break-system-packages"; then
+            PIP_BREAK_FLAG="--break-system-packages"
+          fi
+          echo "PIP_BREAK_FLAG=$PIP_BREAK_FLAG" >> "$GITHUB_ENV"
           set -eu
           docker run --rm \
             -v "$PWD:/workspace" \

apps/api/app/api/routes/assets.py

@@ -1,6 +1,7 @@
 import logging
 from typing import Any, Optional
 
+from app.api.routes._helpers import check_project_access
 from app.auth import AuthenticatedUser, get_current_user
 from app.core.storage import get_storage_service
 from app.dependencies import (
@@ -27,8 +28,6 @@ from packages.application import (
 )
 from packages.domain import AssetStatus, ClassificationStatus
 
-from app.api.routes._helpers import check_project_access
-
 logger = logging.getLogger(__name__)
 
 router = APIRouter()
@@ -74,7 +73,6 @@ def _to_asset_response(item, storage_service=None) -> AssetResponse:
     )
 
 
-
 @router.get("", response_model=ListAssetsResponse)
 def list_assets(
     library_id: Optional[str] = Query(None),

apps/api/app/api/routes/chunked_upload.py

@@ -13,6 +13,7 @@ from pathlib import Path
 from typing import Any
 from uuid import uuid4
 
+from app.api.routes._helpers import require_project_and_library
 from app.auth import AuthenticatedUser, get_current_user
 from app.core.celery_app import celery_app
 from app.core.storage import OSSStorageService, get_storage_service
@@ -34,8 +35,6 @@ from fastapi.params import File
 
 from packages.application import GetProjectUseCase, SubmitIngestJobCommand, SubmitIngestJobUseCase
 
-from app.api.routes._helpers import require_project_and_library
-
 router = APIRouter()
 logger = logging.getLogger(__name__)
 

apps/api/app/api/routes/edit_plans.py

@@ -45,11 +45,11 @@ from packages.application.generation_tasks import (
     CreateGenerationTaskCommand,
     CreateGenerationTaskUseCase,
 )
-
-from ._helpers import check_project_access
 from packages.domain.config_schemas import normalize_plan_config
 from packages.domain.edit_plan import EditPlan, EditPlanStatus
 
+from ._helpers import check_project_access
+
 logger = logging.getLogger(__name__)
 
 router = APIRouter()

apps/api/app/api/routes/generation_tasks.py

@@ -3,6 +3,7 @@ import random
 import uuid
 from typing import Any
 
+from app.api.routes._helpers import check_project_access
 from app.auth import AuthenticatedUser, get_current_user
 from app.core.storage import OSSStorageService, get_storage_service
 from app.core.task_enqueue import (
@@ -31,8 +32,6 @@ from app.schemas.generation_task import (
 )
 from fastapi import APIRouter, Depends, HTTPException
 
-from app.api.routes._helpers import check_project_access
-
 from packages.application import (
     CreateGenerationTaskCommand,
     CreateGenerationTaskUseCase,

apps/api/app/api/routes/titles.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 from typing import Optional
 
+from app.api.routes._helpers import get_user_plan
 from app.auth import AuthenticatedUser, get_current_user
 from app.dependencies import get_db_session, get_user_repository
 from app.schemas.title_library import (
@@ -28,8 +29,6 @@ from packages.application.title_library.use_cases import (
 )
 from packages.ports.user_repository import UserRepository
 
-from app.api.routes._helpers import get_user_plan
-
 router = APIRouter()
 
 

apps/api/app/api/routes/upload.py

@@ -2,6 +2,7 @@ import logging
 from typing import Any
 from uuid import uuid4
 
+from app.api.routes._helpers import require_project_and_library
 from app.auth import AuthenticatedUser, get_current_user
 from app.config import get_settings
 from app.core.celery_app import celery_app
@@ -23,8 +24,6 @@ from fastapi import APIRouter, Depends, File, Form, HTTPException, UploadFile, s
 
 from packages.application import SubmitIngestJobCommand, SubmitIngestJobUseCase
 
-from app.api.routes._helpers import require_project_and_library
-
 logger = logging.getLogger(__name__)
 
 router = APIRouter()

apps/api/app/api/routes/voices.py

@@ -7,6 +7,7 @@ from __future__ import annotations
 
 from typing import Literal, Optional
 
+from app.api.routes._helpers import get_user_plan
 from app.auth import AuthenticatedUser, get_current_user
 from app.dependencies import get_audio_url_signer, get_db_session, get_user_repository
 from app.schemas.voice import (
@@ -39,8 +40,6 @@ from packages.application.voice_library.use_cases import (
 from packages.domain.preset_voices import PRESET_VOICES
 from packages.ports.user_repository import UserRepository
 
-from app.api.routes._helpers import get_user_plan
-
 router = APIRouter()
 
 

apps/api/app/services/job_service.py

@@ -13,7 +13,6 @@ from __future__ import annotations
 import logging
 from typing import Any
 
-
 from packages.application.jobs import (
     CancelJobUseCase,
     CompleteJobCommand,

scripts/check_migration_safety.py

@@ -247,4 +247,3 @@ def main() -> int:
 
 if __name__ == "__main__":
     sys.exit(main())
-