fix(e2e): Playwright chromium禁用GPU，避免无显示环境下GPU初始化失败导致浏览器不稳定

fix(api+ci): DELETE 204响应体全修复 + isort/black整理 + CI环境兼容 + 测试修复

.gitea/workflows/ci-cd.yml

@@ -169,6 +169,10 @@ jobs:
 
     env:
       USE_IN_MEMORY_DB: "true"
+      OSS_ACCESS_KEY_ID: placeholder
+      OSS_ACCESS_KEY_SECRET: placeholder
+      OSS_BUCKET_NAME: xiaoxia-autocut
+      OSS_ENDPOINT: oss-cn-hangzhou.aliyuncs.com
 
     steps:
       - name: Checkout code
@@ -217,6 +221,32 @@ jobs:
                       tar.extract(member, '.')
           PY
 
+      - name: Install ffmpeg
+        shell: sh
+        run: |
+          set +e
+          if command -v ffmpeg > /dev/null 2>&1; then
+            echo "ffmpeg already installed: $(ffmpeg -version | head -1)"
+            exit 0
+          fi
+          if command -v apt-get > /dev/null 2>&1; then
+            apt-get update -qq && apt-get install -y -qq ffmpeg
+          elif command -v yum > /dev/null 2>&1; then
+            yum install -y -q epel-release 2>/dev/null
+            yum install -y -q ffmpeg 2>/dev/null
+            if [ $? -ne 0 ] && command -v dnf > /dev/null 2>&1; then
+              dnf install -y -q --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm 2>/dev/null
+              dnf install -y -q ffmpeg 2>/dev/null
+            fi
+          elif command -v dnf > /dev/null 2>&1; then
+            dnf install -y -q ffmpeg 2>/dev/null
+          fi
+          if command -v ffmpeg > /dev/null 2>&1; then
+            echo "ffmpeg installed successfully: $(ffmpeg -version | head -1)"
+          else
+            echo "Warning: ffmpeg installation failed or not available, some tests may be skipped"
+          fi
+
       - name: Install dependencies
         shell: sh
         run: |
@@ -260,6 +290,10 @@ jobs:
     env:
       DATABASE_URL: postgresql+psycopg://postgres:postgres@127.0.0.1:5432/xiaoxia_saas
       USE_IN_MEMORY_DB: "false"
+      OSS_ACCESS_KEY_ID: placeholder
+      OSS_ACCESS_KEY_SECRET: placeholder
+      OSS_BUCKET_NAME: xiaoxia-autocut
+      OSS_ENDPOINT: oss-cn-hangzhou.aliyuncs.com
 
     steps:
       - name: Checkout code
@@ -325,6 +359,32 @@ jobs:
           python3 -m pip install -q -r requirements-dev.txt
           pytest --version
 
+      - name: Install ffmpeg
+        shell: sh
+        run: |
+          set +e
+          if command -v ffmpeg > /dev/null 2>&1; then
+            echo "ffmpeg already installed: $(ffmpeg -version | head -1)"
+            exit 0
+          fi
+          if command -v apt-get > /dev/null 2>&1; then
+            apt-get update -qq && apt-get install -y -qq ffmpeg
+          elif command -v yum > /dev/null 2>&1; then
+            yum install -y -q epel-release 2>/dev/null
+            yum install -y -q ffmpeg 2>/dev/null
+            if [ $? -ne 0 ] && command -v dnf > /dev/null 2>&1; then
+              dnf install -y -q --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm 2>/dev/null
+              dnf install -y -q ffmpeg 2>/dev/null
+            fi
+          elif command -v dnf > /dev/null 2>&1; then
+            dnf install -y -q ffmpeg 2>/dev/null
+          fi
+          if command -v ffmpeg > /dev/null 2>&1; then
+            echo "ffmpeg installed successfully: $(ffmpeg -version | head -1)"
+          else
+            echo "Warning: ffmpeg installation failed or not available, some tests may be skipped"
+          fi
+
       - name: Start Redis
         shell: sh
         run: |
@@ -394,7 +454,7 @@ jobs:
         shell: sh
         run: |
           set -eu
-          pip install -q pytest-rerunfailures
+          python3 -m pip install -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/*" \

apps/api/app/api/routes/asset_libraries.py

@@ -12,7 +12,7 @@ from app.schemas.asset_library import (
     EnsureDefaultLibraryRequest,
     ListAssetLibrariesResponse,
 )
-from fastapi import APIRouter, Depends, HTTPException, Query, status
+from fastapi import APIRouter, Depends, HTTPException, Query, Response, status
 
 from packages.application import (
     CreateAssetLibraryCommand,
@@ -146,7 +146,7 @@ def ensure_default_library(
     return _to_asset_library_response(created)
 
 
-@router.delete("/{library_id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{library_id}", status_code=status.HTTP_204_NO_CONTENT, response_class=Response)
 def delete_asset_library(
     library_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),

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 (
@@ -19,7 +20,7 @@ from app.schemas.asset import (
     UpdateAssetReviewRequest,
 )
 from app.schemas.tag import TagAssetsRequest
-from fastapi import APIRouter, Depends, HTTPException, Query
+from fastapi import APIRouter, Depends, HTTPException, Query, Response
 
 from packages.application import (
     CreateAssetCommand,
@@ -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),
@@ -330,7 +328,7 @@ def update_asset(
     return _to_asset_response(updated)
 
 
-@router.delete("/{asset_id}", status_code=204)
+@router.delete("/{asset_id}", status_code=204, response_class=Response)
 def delete_asset(
     asset_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),
@@ -369,7 +367,7 @@ def tag_asset(
     return _to_asset_response(updated)
 
 
-@router.delete("/{asset_id}/tags/{tag_id}", status_code=204)
+@router.delete("/{asset_id}/tags/{tag_id}", status_code=204, response_class=Response)
 def untag_asset(
     asset_id: str,
     tag_id: str,

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/duplication.py

@@ -239,7 +239,7 @@ def get_duplication_detail(
     return _to_detail_response(record)
 
 
-@router.delete("/records/{record_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None)
+@router.delete("/records/{record_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 def delete_duplication_record(
     record_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),
@@ -257,7 +257,7 @@ def delete_duplication_record(
 
     use_case = DeleteDuplicationRecordUseCase(duplication_repository)
     use_case.execute(record_id)
-    return Response(status_code=204)
+    return
 
 
 @router.post("/records/{record_id}/retry", response_model=DuplicationUploadResponse)

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

@@ -25,14 +25,15 @@ from app.auth import AuthenticatedUser, get_current_user
 from app.dependencies import get_db_session, get_project_repository
 from app.schemas.generation_task import GenerationTaskResponse
 from app.services import EditPlanService
-from fastapi import APIRouter, Depends, HTTPException, Query, status
+from fastapi import APIRouter, Depends, HTTPException, Query, Response, status
 from pydantic import BaseModel, Field
 from sqlalchemy.orm import Session
 
-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()
@@ -421,7 +422,7 @@ def update_plan(
     return _to_response(result)
 
 
-@router.delete("/{plan_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None)
+@router.delete("/{plan_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 def delete_plan(
     plan_id: str,
     db: Session = Depends(get_db_session),

apps/api/app/api/routes/edit_plans_generation.py

@@ -15,8 +15,8 @@ from app.api.routes._helpers import check_project_access
 from app.api.routes.edit_plans import (
     ClipStatusItem,
     EditPlanGenerateResponse,
-    EditPlanGenerationStatusResponse,
     EditPlanGenerationsResponse,
+    EditPlanGenerationStatusResponse,
 )
 from app.auth import AuthenticatedUser, get_current_user
 from app.core.celery_app import celery_app

apps/api/app/api/routes/feature_flags.py

@@ -173,12 +173,12 @@ async def update_feature_flag(
         raise HTTPException(status_code=500, detail=f"Failed to update flag: {exc}")
 
 
-@router.delete("/{name}", status_code=status.HTTP_204_NO_CONTENT, response_class=Response)
+@router.delete("/{name}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 async def delete_feature_flag(
     name: str,
     _: bool = Depends(_verify_internal_api_key),
     store: RedisFeatureFlagStore = Depends(_get_feature_flag_store),
-) -> None:
+) :
     """删除 Feature Flag。
 
     只允许删除 ALLOWED_FLAGS 列表中的 flag。
@@ -188,7 +188,7 @@ async def delete_feature_flag(
     try:
         deleted = store.delete(name)
         logger.info("Feature flag deleted: name=%s deleted=%s", name, deleted)
-        return None
+        pass
     except Exception as exc:
         logger.error("Failed to delete feature flag %s: %s", name, exc)
         raise HTTPException(status_code=500, detail=f"Failed to delete flag: {exc}")

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/projects.py

@@ -7,7 +7,7 @@ from app.schemas.project import (
     ListProjectsResponse,
     ProjectResponse,
 )
-from fastapi import APIRouter, Depends, HTTPException, status
+from fastapi import APIRouter, Depends, HTTPException, Response, status
 
 from packages.application import (
     CreateProjectCommand,
@@ -72,7 +72,7 @@ def create_project(
     return _to_project_response(project)
 
 
-@router.delete("/{project_id}")
+@router.delete("/{project_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 def delete_project(
     project_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),
@@ -88,4 +88,4 @@ def delete_project(
         )
     if not deleted:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Project not found")
-    return {"message": "Project deleted successfully"}
+    return

apps/api/app/api/routes/tags.py

@@ -10,7 +10,7 @@ from app.schemas.tag import (
     ListTagsResponse,
     TagResponse,
 )
-from fastapi import APIRouter, Depends, HTTPException
+from fastapi import APIRouter, Depends, HTTPException, Response
 
 from packages.domain import Tag
 
@@ -52,7 +52,7 @@ def create_tag(
     return TagResponse(id=created.id, name=created.name, created_at=created.created_at)
 
 
-@router.delete("/{tag_id}", status_code=204)
+@router.delete("/{tag_id}", status_code=204, response_class=Response)
 def delete_tag(
     tag_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),

apps/api/app/api/routes/templates.py

@@ -206,7 +206,7 @@ def update_template(
     return _to_response(template)
 
 
-@router.delete("/{template_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None)
+@router.delete("/{template_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 def delete_template(
     template_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),
@@ -217,7 +217,7 @@ def delete_template(
     deleted = use_case.execute(template_id, user_id)
     if not deleted:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Template not found")
-    return Response(status_code=204)
+    return
 
 
 @router.post("/{template_id}/toggle-favorite", response_model=ToggleFavoriteResponse)
@@ -307,7 +307,7 @@ def create_category(
     )
 
 
-@router.delete("/categories/{category_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None)
+@router.delete("/categories/{category_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 def delete_category(
     category_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),
@@ -318,4 +318,4 @@ def delete_category(
     deleted = use_case.execute(category_id, user_id)
     if not deleted:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Category not found")
-    return Response(status_code=204)
+    return

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()
 
 
@@ -138,7 +137,7 @@ def update_title(
     return _to_response(item)
 
 
-@router.delete("/{title_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None)
+@router.delete("/{title_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 def delete_title(
     title_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),
@@ -149,4 +148,4 @@ def delete_title(
     deleted = use_case.execute(title_id, user_id)
     if not deleted:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Title not found")
-    return Response(status_code=204)
+    return

apps/api/app/api/routes/tts.py

@@ -241,7 +241,7 @@ def get_tts_job_status(
     )
 
 
-@router.delete("/jobs/{job_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None)
+@router.delete("/jobs/{job_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 def delete_tts_job(
     job_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),
@@ -253,7 +253,7 @@ def delete_tts_job(
     deleted = use_case.execute(job_id, user_id)
     if not deleted:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="TTS job not found")
-    return Response(status_code=204)
+    return
 
 
 @router.post(

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/voice_clones.py

@@ -172,6 +172,7 @@ def get_voice_clone_status(
     "/{clone_id}",
     status_code=status.HTTP_204_NO_CONTENT,
     response_model=None,
+    response_class=Response,
 )
 def delete_voice_clone(
     clone_id: str,
@@ -184,7 +185,7 @@ def delete_voice_clone(
     deleted = use_case.execute(clone_id, user_id)
     if not deleted:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Voice clone not found")
-    return Response(status_code=204)
+    return
 
 
 @router.post("/{clone_id}/retry", response_model=VoiceCloneProfileResponse)

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()
 
 
@@ -323,7 +322,7 @@ def update_voice(
     return _to_response(item, sign_url)
 
 
-@router.delete("/{voice_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None)
+@router.delete("/{voice_id}", status_code=status.HTTP_204_NO_CONTENT, response_model=None, response_class=Response)
 def delete_voice(
     voice_id: str,
     authenticated_user: AuthenticatedUser = Depends(get_current_user),
@@ -334,4 +333,4 @@ def delete_voice(
     deleted = use_case.execute(voice_id, user_id)
     if not deleted:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Voice not found")
-    return Response(status_code=204)
+    return

apps/api/app/core/storage.py

@@ -5,8 +5,8 @@ This module keeps old import paths working so existing code
 does not need to change.
 """
 
+from packages.shared.storage import SharedStorageService as OSSStorageService
 from packages.shared.storage import (
-    SharedStorageService as OSSStorageService,
     get_shared_storage_service,
     get_storage_service,
 )

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,

apps/web/playwright.config.ts

@@ -26,6 +26,9 @@ export default defineConfig({
           use: {
             ...devices["Desktop Chrome"],
             channel: process.env.E2E_BROWSER_CHANNEL || "msedge",
+            launchOptions: {
+              args: ["--disable-gpu", "--disable-software-rasterizer"],
+            },
           },
         },
         {
@@ -51,6 +54,9 @@ export default defineConfig({
           use: {
             ...devices["Desktop Chrome"],
             channel: process.env.E2E_BROWSER_CHANNEL || "msedge",
+            launchOptions: {
+              args: ["--disable-gpu", "--disable-software-rasterizer"],
+            },
           },
         },
       ],

apps/worker/video_processing/render_audio.py

@@ -16,15 +16,15 @@ import subprocess
 from dataclasses import dataclass, field
 from pathlib import Path
 
-from video_processing.ffmpeg_utils import FFMPEG_BIN, probe_has_audio, run_ffmpeg
-
 # 延迟导入避免循环依赖：unified_render_service 定义 ResolvedClip / RenderLayer，
 # 本模块提供音频函数供 unified_render_service 调用。
 # 使用 from __future__ import annotations + TYPE_CHECKING 解决类型引用。
 from typing import TYPE_CHECKING
 
+from video_processing.ffmpeg_utils import FFMPEG_BIN, probe_has_audio, run_ffmpeg
+
 if TYPE_CHECKING:
-    from video_processing.unified_render_service import ResolvedClip, RenderLayer
+    from video_processing.unified_render_service import RenderLayer, ResolvedClip
 
 logger = logging.getLogger(__name__)
 

apps/worker/video_processing/unified_render_service.py

@@ -244,9 +244,7 @@ class UnifiedRenderService:
                     video_duration=video_duration,
                 )
         else:
-            filter_complex, input_args = self._build_filter_complex(
-                layers, ass_path=ass_path
-            )
+            filter_complex, input_args = self._build_filter_complex(layers, ass_path=ass_path)
             self._execute_ffmpeg(filter_complex, input_args, video_only_path)
 
         t_video_end = time.time()
@@ -331,9 +329,7 @@ class UnifiedRenderService:
         if not main_layer or not main_layer.clips:
             return 0.0
 
-        total = sum(
-            UnifiedRenderService._clip_effective_duration(c) for c in main_layer.clips
-        )
+        total = sum(UnifiedRenderService._clip_effective_duration(c) for c in main_layer.clips)
 
         # 减去转场重叠时间（粗略估算）
         n_clips = len(main_layer.clips)
@@ -441,10 +437,7 @@ class UnifiedRenderService:
             return False, f"像素格式不是yuv420p: {info.get('pix_fmt', 'unknown')}"
 
         # 分辨率必须一致
-        if (
-            info.get("width", 0) != self.output_width
-            or info.get("height", 0) != self.output_height
-        ):
+        if info.get("width", 0) != self.output_width or info.get("height", 0) != self.output_height:
             return False, (
                 f"分辨率不匹配: "
                 f"{info.get('width', 0)}x{info.get('height', 0)} "
@@ -494,9 +487,7 @@ class UnifiedRenderService:
         role = layers[0].role
 
         # 判断是否满足 copy 条件
-        can_copy, reason = self._can_use_stream_copy(
-            clip, ass_path=ass_path, video_duration=video_duration
-        )
+        can_copy, reason = self._can_use_stream_copy(clip, ass_path=ass_path, video_duration=video_duration)
         if not can_copy:
             logger.info(
                 "[unified-render] stream_copy 跳过: plan_id=%s reason=%s",
@@ -524,9 +515,7 @@ class UnifiedRenderService:
 
         # 计算最终时长
         final_duration = effective_duration
-        if video_duration > 0 and (
-            final_duration <= 0 or final_duration > video_duration
-        ):
+        if video_duration > 0 and (final_duration <= 0 or final_duration > video_duration):
             final_duration = video_duration
         if final_duration > 0:
             command.extend(["-t", f"{final_duration:.3f}"])
@@ -563,9 +552,7 @@ class UnifiedRenderService:
                 )
                 return True
             else:
-                logger.warning(
-                    "[unified-render] stream_copy 输出为空: plan_id=%s", self.plan.id
-                )
+                logger.warning("[unified-render] stream_copy 输出为空: plan_id=%s", self.plan.id)
                 return False
         except (subprocess.CalledProcessError, subprocess.TimeoutExpired) as e:
             logger.warning(
@@ -628,10 +615,7 @@ class UnifiedRenderService:
             filters.append(f"scale={pip_w}:{pip_h}")
         else:
             # main / broll / background: 铺满裁剪
-            filters.append(
-                f"scale={self.output_width}:{self.output_height}"
-                ":force_original_aspect_ratio=increase"
-            )
+            filters.append(f"scale={self.output_width}:{self.output_height}" ":force_original_aspect_ratio=increase")
             filters.append(f"crop={self.output_width}:{self.output_height}")
 
         filters.append("setpts=PTS-STARTPTS")
@@ -647,9 +631,7 @@ class UnifiedRenderService:
 
         # 最终输出时长：取 clip 有效时长和 video_duration 的较小值
         final_duration = effective_duration
-        if video_duration > 0 and (
-            final_duration <= 0 or final_duration > video_duration
-        ):
+        if video_duration > 0 and (final_duration <= 0 or final_duration > video_duration):
             final_duration = video_duration
 
         command = [
@@ -748,9 +730,7 @@ class UnifiedRenderService:
         resolved.sort(key=lambda c: c.order)
         return resolved
 
-    def _group_clips_into_layers(
-        self, resolved_clips: list[ResolvedClip]
-    ) -> list[RenderLayer]:
+    def _group_clips_into_layers(self, resolved_clips: list[ResolvedClip]) -> list[RenderLayer]:
         """将 ResolvedClips 分组为 RenderLayers。
 
         分组规则见 _resolve_layer_role 函数文档。
@@ -840,16 +820,14 @@ class UnifiedRenderService:
                 filters.append(f"scale={pip_w}:{pip_h}")
             elif role == "background":
                 filters.append(
-                    f"scale={self.output_width}:{self.output_height}"
-                    ":force_original_aspect_ratio=increase"
+                    f"scale={self.output_width}:{self.output_height}" ":force_original_aspect_ratio=increase"
                 )
                 filters.append(f"crop={self.output_width}:{self.output_height}")
             else:
                 # main / broll: 铺满裁剪（scale to cover + center crop）
                 # 对齐链路A编辑器合成行为，与主流短视频平台一致
                 filters.append(
-                    f"scale={self.output_width}:{self.output_height}"
-                    ":force_original_aspect_ratio=increase"
+                    f"scale={self.output_width}:{self.output_height}" ":force_original_aspect_ratio=increase"
                 )
                 filters.append(f"crop={self.output_width}:{self.output_height}")
 
@@ -866,13 +844,8 @@ class UnifiedRenderService:
             layer_clip_indices = [all_clips.index(c) for c in layer.clips]
             layer_labels = [preprocessed_labels[i] for i in layer_clip_indices]
             # 使用 trim 后的有效时长，与 Step 1 的 trim=duration 保持一致
-            layer_durations = [
-                UnifiedRenderService._clip_effective_duration(all_clips[i])
-                for i in layer_clip_indices
-            ]
-            layer_transitions = [
-                all_clips[i].transition_effect for i in layer_clip_indices
-            ]
+            layer_durations = [UnifiedRenderService._clip_effective_duration(all_clips[i]) for i in layer_clip_indices]
+            layer_transitions = [all_clips[i].transition_effect for i in layer_clip_indices]
 
             if len(layer_labels) == 1:
                 # 单 clip 层，直接使用预处理标签
@@ -903,8 +876,7 @@ class UnifiedRenderService:
                     base_label = layer_output_labels[role]
                     combined_label = f"combined_{role}"
                     filter_parts.append(
-                        f"[{final_video_label}][{base_label}]"
-                        f"overlay=(W-w)/2:(H-h)/2[{combined_label}]"
+                        f"[{final_video_label}][{base_label}]" f"overlay=(W-w)/2:(H-h)/2[{combined_label}]"
                     )
                     final_video_label = combined_label
         else:
@@ -929,18 +901,13 @@ class UnifiedRenderService:
                     20,
                 )
                 combined_label = f"combined_{layer.role}"
-                filter_parts.append(
-                    f"[{final_video_label}][{overlay_label}]"
-                    f"overlay={x}:{y}[{combined_label}]"
-                )
+                filter_parts.append(f"[{final_video_label}][{overlay_label}]" f"overlay={x}:{y}[{combined_label}]")
                 final_video_label = combined_label
 
         # 叠加字幕（如有）+ 最终像素格式
         if ass_path is not None:
             ass_filter_path = str(ass_path).replace("\\", "/").replace(":", "\\:")
-            filter_parts.append(
-                f"[{final_video_label}]subtitles='{ass_filter_path}',format=yuv420p[final_video]"
-            )
+            filter_parts.append(f"[{final_video_label}]subtitles='{ass_filter_path}',format=yuv420p[final_video]")
         else:
             filter_parts.append(f"[{final_video_label}]format=yuv420p[final_video]")
 
@@ -1015,9 +982,5 @@ class UnifiedRenderService:
     def _clip_effective_duration(clip: ResolvedClip) -> float:
         """计算 clip 的有效时长."""
         if clip.duration > 0:
-            return (
-                min(clip.duration, clip.actual_duration)
-                if clip.actual_duration > 0
-                else clip.duration
-            )
+            return min(clip.duration, clip.actual_duration) if clip.actual_duration > 0 else clip.duration
         return clip.actual_duration if clip.actual_duration > 0 else 0.0

apps/worker/worker_app/tasks/generation.py

@@ -96,11 +96,7 @@ def _flush_logs(task_id: str, gen_task) -> None:
         try:
             from packages.adapters.sqlalchemy_impl.models import GenerationTaskModel
 
-            model = (
-                session.query(GenerationTaskModel)
-                .filter(GenerationTaskModel.id == task_id)
-                .first()
-            )
+            model = session.query(GenerationTaskModel).filter(GenerationTaskModel.id == task_id).first()
             if model:
                 model.logs = gen_task.logs
                 session.commit()
@@ -413,9 +409,7 @@ def _download_library_assets(
             else:
                 # 未指定 asset_ids：按 library 或 project 下载全部 ready 视频
                 if asset_library_id:
-                    query = query.filter(
-                        AssetModel.asset_library_id == asset_library_id
-                    )
+                    query = query.filter(AssetModel.asset_library_id == asset_library_id)
                     logger.info(
                         "下载素材库全部视频: asset_library_id=%s",
                         asset_library_id,
@@ -430,11 +424,7 @@ def _download_library_assets(
             assets = query.order_by(AssetModel.created_at).all()
 
             if not assets:
-                mode_desc = (
-                    f"素材库 {asset_library_id}"
-                    if asset_library_id
-                    else f"项目 {project_id}"
-                )
+                mode_desc = f"素材库 {asset_library_id}" if asset_library_id else f"项目 {project_id}"
                 msg = f"未找到视频素材: {mode_desc}, asset_ids={asset_ids or 'all'}"
                 logger.error(msg)
                 raise RuntimeError(msg)
@@ -489,9 +479,7 @@ def _download_library_assets(
                             duration=0.0,
                         )
                     if strict:
-                        raise RuntimeError(
-                            f"素材缺少 file_url: asset_id={asset.id}, name={asset.name}"
-                        )
+                        raise RuntimeError(f"素材缺少 file_url: asset_id={asset.id}, name={asset.name}")
                     continue
 
                 ext = Path(storage_key).suffix or ".mp4"
@@ -541,9 +529,7 @@ def _download_library_assets(
                             duration=round(asset_elapsed, 2),
                         )
                     if strict:
-                        raise RuntimeError(
-                            f"素材下载失败: asset_id={asset.id}, name={asset.name}"
-                        )
+                        raise RuntimeError(f"素材下载失败: asset_id={asset.id}, name={asset.name}")
 
             # 指定了 asset_ids 但全部下载失败 → 无论 strict 与否都报错
             if asset_ids and not downloaded:
@@ -852,9 +838,7 @@ def _render_video(
 
     # 选择渲染引擎
     engine = _resolve_render_engine(user_id) if user_id else ENGINE_UNIFIED
-    logger.info(
-        "[task_id=%s] [渲染] 引擎选择: %s (user_id=%s)", task_id, engine, user_id
-    )
+    logger.info("[task_id=%s] [渲染] 引擎选择: %s (user_id=%s)", task_id, engine, user_id)
 
     render_start = time.monotonic()
     render_output_path = temp_path / f"rendered-{task_id}.mp4"
@@ -898,9 +882,7 @@ def _render_video(
             _mux_audio_track(render_output_path, voice_path, final_path)
             output_path = final_path
         except Exception as mux_err:
-            logger.warning(
-                "[task_id=%s] [混音] 音频混合失败，使用无音频版本: %s", task_id, mux_err
-            )
+            logger.warning("[task_id=%s] [混音] 音频混合失败，使用无音频版本: %s", task_id, mux_err)
             output_path = render_output_path
     else:
         output_path = render_output_path
@@ -929,9 +911,7 @@ def _upload_and_record(
     file_url = upload_to_oss(output_path, storage_key)
     upload_elapsed = time.monotonic() - upload_start
     if not file_url:
-        raise RuntimeError(
-            f"OSS 上传失败: task_id={task_id}, storage_key={storage_key}"
-        )
+        raise RuntimeError(f"OSS 上传失败: task_id={task_id}, storage_key={storage_key}")
 
     # 校验 URL 可达性（P0-2: 私有 bucket 用预签名 + object_exists 降级）
     verify_url = get_signed_download_url(file_url, expires_seconds=300) or file_url
@@ -942,8 +922,7 @@ def _upload_and_record(
         key = normalize_storage_key(file_url)
         if not (bucket and bucket.object_exists(key)):
             raise RuntimeError(
-                f"OSS 上传后 URL 不可访问且 object_exists 失败: file_url={file_url}, "
-                f"storage_key={storage_key}"
+                f"OSS 上传后 URL 不可访问且 object_exists 失败: file_url={file_url}, " f"storage_key={storage_key}"
             )
         logger.info(
             "URL 校验失败但 object_exists 确认文件存在，视为上传成功: storage_key=%s",
@@ -1044,9 +1023,7 @@ def generate_video(self, task_id: str) -> dict:
     _update_task_status(task_id, "mark_processing")
 
     try:
-        editing_mode = (
-            EditingMode(mode) if (mode := task_info["mode"]) else EditingMode.ONE_TAKE
-        )
+        editing_mode = EditingMode(mode) if (mode := task_info["mode"]) else EditingMode.ONE_TAKE
     except ValueError:
         editing_mode = EditingMode.ONE_TAKE
 

scripts/build_release_images.sh

@@ -63,8 +63,8 @@ BRANCH_NAME="${GITHUB_REF_NAME:-${CI_COMMIT_BRANCH:-unknown}}"
 if [ "$USE_CACHE" -eq 1 ]; then
   docker buildx build \
     --build-arg APP_VERSION="$VERSION" \
-    --cache-from "type=registry,ref=${CACHE_REGISTRY}/api-cache:${CACHE_TAG},ignore-error=true" \
-    --cache-to "type=registry,ref=${CACHE_REGISTRY}/api-cache:${CACHE_TAG},mode=max" \
+    --cache-from "type=registry,ref=${CACHE_REGISTRY}/api-cache:${CACHE_TAG_PRIMARY},ignore-error=true" \
+    --cache-to "type=registry,ref=${CACHE_REGISTRY}/api-cache:${CACHE_TAG_PRIMARY},mode=max" \
     -f infra/docker/api.Dockerfile \
     -t "$API_IMAGE" -t "$API_LATEST" \
     --load \
@@ -123,8 +123,8 @@ echo "=== Building Worker image ==="
 if [ "$USE_CACHE" -eq 1 ]; then
   docker buildx build \
     --build-arg APP_VERSION="$VERSION" \
-    --cache-from "type=registry,ref=${CACHE_REGISTRY}/worker-cache:${CACHE_TAG},ignore-error=true" \
-    --cache-to "type=registry,ref=${CACHE_REGISTRY}/worker-cache:${CACHE_TAG},mode=max" \
+    --cache-from "type=registry,ref=${CACHE_REGISTRY}/worker-cache:${CACHE_TAG_PRIMARY},ignore-error=true" \
+    --cache-to "type=registry,ref=${CACHE_REGISTRY}/worker-cache:${CACHE_TAG_PRIMARY},mode=max" \
     -f infra/docker/worker.Dockerfile \
     -t "$WORKER_IMAGE" -t "$WORKER_LATEST" \
     --load \
@@ -152,8 +152,8 @@ test -f apps/web/dist/index.html
 
 if [ "$USE_CACHE" -eq 1 ]; then
   docker buildx build \
-    --cache-from "type=registry,ref=${CACHE_REGISTRY}/web-cache:${CACHE_TAG},ignore-error=true" \
-    --cache-to "type=registry,ref=${CACHE_REGISTRY}/web-cache:${CACHE_TAG},mode=max" \
+    --cache-from "type=registry,ref=${CACHE_REGISTRY}/web-cache:${CACHE_TAG_PRIMARY},ignore-error=true" \
+    --cache-to "type=registry,ref=${CACHE_REGISTRY}/web-cache:${CACHE_TAG_PRIMARY},mode=max" \
     -f infra/docker/web-artifact.Dockerfile \
     --build-arg "NGINX_CONF=$NGINX_CONF_FILE" \
     -t "$WEB_IMAGE" \

scripts/check_migration_safety.py

@@ -119,9 +119,7 @@ def get_new_migrations_via_diff(diff_target: str) -> List[Path]:
             text=True,
             check=True,
         )
-        files = [
-            line.strip() for line in result.stdout.strip().split("\n") if line.strip()
-        ]
+        files = [line.strip() for line in result.stdout.strip().split("\n") if line.strip()]
         return [REPO_ROOT / f for f in files]
     except subprocess.CalledProcessError as e:
         print(f"⚠️  git diff 失败（{diff_target}）：{e.stderr.strip()}")
@@ -129,9 +127,7 @@ def get_new_migrations_via_diff(diff_target: str) -> List[Path]:
         return sorted(ALEMBIC_VERSIONS_DIR.glob("*.py"))
 
 
-def find_new_migrations(
-    since_revision: str | None = None, diff_against: str | None = None
-) -> List[Path]:
+def find_new_migrations(since_revision: str | None = None, diff_against: str | None = None) -> List[Path]:
     """
     找出需要检查的迁移文件。
     优先级：diff_against > since_revision > 全部
@@ -183,9 +179,7 @@ def analyze_migration(file_path: Path) -> Tuple[List[str], List[str], List[str]]
 
 
 def main() -> int:
-    parser = argparse.ArgumentParser(
-        description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter
-    )
+    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
     parser.add_argument(
         "--since",
         default=os.getenv("MIGRATION_SINCE_REVISION"),
@@ -248,9 +242,7 @@ def main() -> int:
         print()
 
     print("=" * 60)
-    print(
-        f"检查结果：{len(all_safe)} 项安全 / {len(all_medium)} 项中风险 / {len(all_high)} 项高风险"
-    )
+    print(f"检查结果：{len(all_safe)} 项安全 / {len(all_medium)} 项中风险 / {len(all_high)} 项高风险")
     print()
 
     if all_high:

tests/integration/test_auth.py

@@ -308,7 +308,7 @@ class TestPasswordReset:
         )
 
         response = client.post(
-            "/api/v1/auth/password/forgot",
+            "/api/v1/auth/forgot-password",
             json={"email": test_email},
         )
 
@@ -318,7 +318,7 @@ class TestPasswordReset:
     def test_request_password_reset_nonexistent_user(self):
         """测试请求不存在的用户密码重置"""
         response = client.post(
-            "/api/v1/auth/password/forgot",
+            "/api/v1/auth/forgot-password",
             json={"email": "nonexistent@example.com"},
         )
 

tests/unit/test_asset_library_delete.py

@@ -219,7 +219,7 @@ class TestDeleteAssetLibrary:
 
         response = client.delete("/api/v1/asset-libraries/lib-1")
         assert response.status_code == 403
-        assert "Access denied" in response.json()["detail"]
+        assert "无权访问该项目" in response.json()["detail"]
 
         # 库未被删除
         assert lib_repo.find_by_id("lib-1") is not None

tests/unit/test_config_oss.py

@@ -37,7 +37,7 @@ def _fresh_settings(**env_overrides: dict[str, str]):
         "JWT_SECRET_KEY": "unit-test-secret-key-12345",
         **env_overrides,
     }
-    with patch.dict(os.environ, env, clear=False):
+    with patch.dict(os.environ, env, clear=True):
         Settings = _load_settings_class()
         return Settings()
 

tests/unit/test_edit_plan_generation_api.py

@@ -318,7 +318,7 @@ class TestGeneratePlan:
         clip = _make_clip(plan.id, order=1)
         clip_repo.create(clip)
 
-        with patch("app.api.routes.edit_plans.celery_app") as mock_celery:
+        with patch("app.api.routes.edit_plans_generation.celery_app") as mock_celery:
             mock_celery.send_task = MagicMock()
             resp = client.post(f"/api/v1/edit-plans/{plan.id}/generate")
 
@@ -406,7 +406,7 @@ class TestGeneratePlan:
         clip = _make_clip(plan.id, order=1, status=EditPlanClipStatus.READY)
         clip_repo.create(clip)
 
-        with patch("app.api.routes.edit_plans.celery_app") as mock_celery:
+        with patch("app.api.routes.edit_plans_generation.celery_app") as mock_celery:
             mock_celery.send_task = MagicMock()
             resp = client.post(f"/api/v1/edit-plans/{plan.id}/generate")
 
@@ -427,7 +427,7 @@ class TestGeneratePlan:
             clip = _make_clip(plan.id, order=i + 1)
             clip_repo.create(clip)
 
-        with patch("app.api.routes.edit_plans.celery_app") as mock_celery:
+        with patch("app.api.routes.edit_plans_generation.celery_app") as mock_celery:
             mock_celery.send_task = MagicMock()
             resp = client.post(f"/api/v1/edit-plans/{plan.id}/generate")
 
@@ -580,7 +580,7 @@ class TestResponseSchema:
         clip = _make_clip(plan.id, order=1)
         clip_repo.create(clip)
 
-        with patch("app.api.routes.edit_plans.celery_app") as mock_celery:
+        with patch("app.api.routes.edit_plans_generation.celery_app") as mock_celery:
             mock_celery.send_task = MagicMock()
             resp = client.post(f"/api/v1/edit-plans/{plan.id}/generate")
 
@@ -623,7 +623,7 @@ class TestGeneratePlanErrorHandling:
         clip = _make_clip(plan.id, order=1)
         clip_repo.create(clip)
 
-        with patch("app.api.routes.edit_plans.celery_app") as mock_celery:
+        with patch("app.api.routes.edit_plans_generation.celery_app") as mock_celery:
             # 模拟 Celery 调度失败
             mock_celery.send_task.side_effect = RuntimeError("Redis 连接超时")
             resp = client.post(f"/api/v1/edit-plans/{plan.id}/generate")
@@ -647,7 +647,7 @@ class TestGeneratePlanErrorHandling:
         clip = _make_clip(plan.id, order=1)
         clip_repo.create(clip)
 
-        with patch("app.api.routes.edit_plans.celery_app") as mock_celery:
+        with patch("app.api.routes.edit_plans_generation.celery_app") as mock_celery:
             mock_celery.send_task.side_effect = RuntimeError("调度失败")
             resp = client.post(f"/api/v1/edit-plans/{plan.id}/generate")
 
@@ -668,7 +668,7 @@ class TestGeneratePlanErrorHandling:
         clip = _make_clip(plan.id, order=1)
         clip_repo.create(clip)
 
-        with patch("app.api.routes.edit_plans.celery_app") as mock_celery:
+        with patch("app.api.routes.edit_plans_generation.celery_app") as mock_celery:
             mock_celery.send_task.side_effect = ConnectionError("Broker 不可达")
             resp = client.post(f"/api/v1/edit-plans/{plan.id}/generate")
 

tests/unit/test_feature_flag.py

@@ -7,7 +7,6 @@ from __future__ import annotations
 
 from unittest.mock import MagicMock
 
-
 from packages.adapters.redis.feature_flag_store import (
     FeatureFlagConfig,
     InMemoryFeatureFlagStore,

tests/unit/test_oss_direct_upload.py

@@ -8,9 +8,12 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[2] / "apps" / "api"))
 import app.config as app_config
 from app.core.storage import OSSStorageService
 
+import packages.shared.config as shared_config
+
 
 def _reset_settings() -> None:
     app_config._settings = None
+    shared_config._settings = None
 
 
 def test_create_direct_upload_post_limits_key_and_size(monkeypatch):

tests/unit/test_tts_oss_transfer.py

@@ -9,7 +9,6 @@ from __future__ import annotations
 from datetime import datetime, timezone
 from unittest.mock import MagicMock, patch
 
-
 from packages.application.cosyvoice_service import CosyVoiceService
 from packages.application.tts_job.workflow import TTSWorkflowService
 from packages.domain.tts_job import TTSJob, TTSJobStatus