fix(backend): P0 前端#1911 删除模板选择UI后自动创建默认模板兜底

- list_templates(valid_only=true)：用户无任何有效模板时自动创建默认 voice_over 模板（含1个通用片段），避免前端selectedTemplate永远为空导致卡死
- POST /generation/variant-plans：放宽 schema 校验（template_id/source_edit_plan_id 均可不传），路由层自动为用户查找/创建默认模板
- 新增2个单测：schema允许空template_id、空参时自动创建默认模板并继续选片
- Refs #1899

apps/api/app/api/routes/generation_variant_plans.py

@@ -30,6 +30,74 @@ logger = logging.getLogger(__name__)
 router = APIRouter()
 
 
+def _get_or_create_default_template_id(db: Session, user_id: str) -> str | None:
+    """为用户查找一个有效模板；若不存在则自动创建默认配音模板。
+
+    前端 #1911 删除了模板选择 UI，当调用方未传 template_id/source_edit_plan_id
+    时（如剪辑页首次进入直接选片），后端兜底查找/创建默认模板，避免 400。
+
+    Returns:
+        template_id（字符串）；失败时返回 None。
+    """
+    from packages.adapters.sqlalchemy_impl.models import TemplateClipConfigModel, TemplateModel
+    from packages.adapters.sqlalchemy_impl.template_repository import SQLAlchemyTemplateRepository
+    from packages.application.template.commands import CreateTemplateCommand, SegmentCommand
+    from packages.application.template.use_cases import CreateTemplateUseCase
+    import uuid
+
+    # 1. 先查已有有效模板（is_active=True 且存在片段配置）
+    existing = (
+        db.query(TemplateModel)
+        .filter(
+            TemplateModel.user_id == user_id,
+            TemplateModel.is_active.is_(True),
+        )
+        .order_by(TemplateModel.created_at.asc())
+        .first()
+    )
+    if existing is not None:
+        # 验证该模板是否有片段配置；若没有继续尝试创建默认
+        has_seg = (
+            db.query(TemplateClipConfigModel.id).filter(TemplateClipConfigModel.template_id == existing.id).first()
+        )
+        if has_seg:
+            return existing.id
+
+    # 2. 无有效模板 → 自动创建默认配音模板
+    try:
+        repo = SQLAlchemyTemplateRepository(db)
+        cmd = CreateTemplateCommand(
+            user_id=user_id,
+            name="默认配音模板",
+            mode="voice_over",
+            category="default",
+            tags=[],
+            title_config={},
+            subtitle_config={},
+            bgm_config={},
+            estimated_duration=0.0,
+            segments=[
+                SegmentCommand(
+                    segment_order=0,
+                    duration_min=1.0,
+                    duration_max=30.0,
+                    material_type=None,
+                ),
+            ],
+        )
+        use_case = CreateTemplateUseCase(repo)
+        tpl = use_case.execute(cmd)
+        logger.info(
+            "[variant-plans] 自动创建默认模板: user=%s tpl=%s",
+            user_id,
+            tpl.id,
+        )
+        return tpl.id
+    except Exception:
+        logger.exception("[variant-plans] 自动创建默认模板失败: user=%s", user_id)
+        return None
+
+
 class VariantPlanRequest(BaseModel):
     """轻量选片请求体（与前端 variantPlans.ts 契约一致）。"""
 
@@ -43,8 +111,8 @@ class VariantPlanRequest(BaseModel):
 
     @model_validator(mode="after")
     def _validate(self) -> "VariantPlanRequest":
-        if not self.template_id.strip() and not self.source_edit_plan_id.strip():
-            raise ValueError("template_id 与 source_edit_plan_id 至少需要提供一个")
+        # 不再强制要求 template_id / source_edit_plan_id：
+        # 后端在路由内会自动查找/创建默认模板兜底（#1911 后前端不再显式选模板）。
         try:
             resolve_variant_voice_ids(
                 count=self.count,
@@ -94,8 +162,15 @@ def create_variant_plans(
     from app.services.generation_common import resolve_latest_plan_by_template
 
     source_plan_id = request.source_edit_plan_id.strip()
-    if not source_plan_id and request.template_id.strip():
-        source_plan_id = resolve_latest_plan_by_template(db, template_id=request.template_id, user_id=user_id) or ""
+    template_id = request.template_id.strip()
+
+    # P0 兜底：前端 #1911 已删除模板选择 UI，调用方可能不传 template_id；
+    # 此时自动为该用户查找/创建默认模板。
+    if not source_plan_id and not template_id:
+        template_id = _get_or_create_default_template_id(db, user_id) or ""
+
+    if not source_plan_id and template_id:
+        source_plan_id = resolve_latest_plan_by_template(db, template_id=template_id, user_id=user_id) or ""
 
     if not source_plan_id:
         raise HTTPException(

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

@@ -95,6 +95,49 @@ def _to_response(template, usage_count: int = 0) -> TemplateResponse:
     )
 
 
+def _ensure_default_template(
+    user_id: str,
+    template_repository: SQLAlchemyTemplateRepository,
+):
+    """当用户无任何有效模板时，自动创建一个默认 voice_over 模式模板。
+
+    前端 #1911 删除了模板选择 UI（6步→5步），改为后台自动选第一个有效模板。
+    为避免新用户/无模板用户在剪辑页卡死在"独立选片中..."，当 valid_only 查询
+    结果为空时自动创建一条默认配音模板（含 1 个 order=0 的通用片段配置），
+    让 from-assets 能正常分配片段。
+
+    Returns:
+        创建的默认 Template 实体；创建失败返回 None。
+    """
+    try:
+        cmd = CreateTemplateCommand(
+            user_id=user_id,
+            name="默认配音模板",
+            mode="voice_over",
+            category="default",
+            tags=[],
+            title_config={},
+            subtitle_config={},
+            bgm_config={},
+            estimated_duration=0.0,
+            segments=[
+                SegmentCommand(
+                    segment_order=0,
+                    duration_min=1.0,
+                    duration_max=30.0,
+                    material_type=None,
+                ),
+            ],
+        )
+        use_case = CreateTemplateUseCase(template_repository)
+        tpl = use_case.execute(cmd)
+        logger.info("[template] 自动创建默认模板: user=%s tpl=%s", user_id, tpl.id)
+        return tpl
+    except Exception:
+        logger.exception("自动创建默认模板失败: user_id=%s", user_id)
+        return None
+
+
 # ── Template CRUD ──
 
 
@@ -127,6 +170,14 @@ def list_templates(
         count_use_case = CountTemplatesUseCase(template_repository)
         total = count_use_case.execute(user_id, filter=tpl_filter)
 
+        # P0 兜底：剪辑页（valid_only=true）首次访问且用户无任何有效模板时，
+        # 自动创建一条默认配音模板，避免前端 selectedTemplate 永远为空导致卡死。
+        if valid_only and total == 0 and skip == 0:
+            default_tpl = _ensure_default_template(user_id, template_repository)
+            if default_tpl is not None:
+                templates = [default_tpl]
+                total = 1
+
         # 批量查询使用次数
         items = []
         for t in templates: