fix(cover): 模板缩略图渲染 + 自动生成封面404修复
CI/CD Pipeline / Check push changed paths (pull_request) Has been skipped
CI/CD Pipeline / Dedup Check - skip PR tests when covered by push pipeline (pull_request) Successful in 1s
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 2s
CI/CD Pipeline / PR Build Worker Image (pull_request) Successful in 1m4s
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Retag skipped Staging API Image (pull_request) Has been skipped
CI/CD Pipeline / Retag skipped Staging Web Image (pull_request) Has been skipped
CI/CD Pipeline / Retag skipped Staging Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped
CI/CD Pipeline / PR Build Web Image (pull_request) Successful in 1m47s
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 1m57s
CI/CD Pipeline / Frontend Unit Tests (pull_request) Successful in 1m54s
CI/CD Pipeline / Unit Tests (pull_request) Failing after 2m12s
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 2m17s
CI/CD Pipeline / Integration Tests (pull_request) Successful in 2m35s
CI/CD Pipeline / Validate - Python (mypy + alembic) (pull_request) Successful in 2m43s
CI/CD Pipeline / Validate - Style (pull_request) Successful in 3m2s
PR Automation / Auto Approve on CI Green (pull_request) Successful in 3m7s
AI Code Review / AI Code Review (pull_request) Successful in 6m35s
CI/CD Pipeline / Validate - Security (pull_request) Successful in 8m12s
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
CI/CD Pipeline / Canary Release to Production (pull_request) Has been skipped
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
CI/CD Pipeline / PR Build API Image (pull_request) Failing after 9m12s
CI/CD Pipeline / CI Gate (pull_request) Failing after 0s
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 6m14s

问题1:模板卡片不显示预览图
- 之前写死渐变色+🖼️emoji,完全没用 thumbnail_url 字段
- 新增 TemplateThumb 子组件:优先渲染 tpl.thumbnail_url(object-fit:cover),
  图片加载失败或无URL时回退到按模板id哈希的柔和渐变色占位
- 选中态✓覆盖在图片上层

问题2:自动生成封面 POST /generation/generate-cover 返回404
根因:前端用魔法字符串 "default" 作为 template_id 发给后端,但后端
模板库中不存在 id="default" 的记录,resolve_draft_plan_id 返回404。

修复:
1. 前端 useSharedCover:挂载时拉模板列表,把初始 "default" 占位符自动
   解析为第一个系统模板的真实id;用户未选模板时传空串给API层
2. 前端 api/generation/cover.ts:templateId 为空或 "default" 时不传
   template_id query 参数(而非传 "default")
3. 后端 generation_cover.py:
   - template_id Query 改为可选(默认空串)
   - 移除原来强依赖 get_draft_plan_id(auto_create_default=False) 的 Depends
   - 在函数体内手动 resolve:空串时 auto_create_default=True 自动兜底到
     用户默认模板;非空时走原校验逻辑
4. useBatchCovers:批量一键生成同样不传 "default"
5. Step6CoverSettings:透传原始 selectedTemplateId 给 useBatchCovers
6. 保留 selectedTemplateId==="default" 的UI展示分支("默认模板"文案)
   用于首次挂载模板列表加载完成前的过渡态

验证:
- tsc --noEmit ✅
- eslint --max-warnings=0 ✅
- prettier ✅
- vite build ✅
- 后端 Python 语法检查 ✅
- 未修改 CI 配置
This commit is contained in:
xiaoxia
2026-09-26 16:12:57 +08:00
parent 8a396303b8
commit 0a6473e5d7
6 changed files with 159 additions and 75 deletions
+24 -4
View File
@@ -30,7 +30,7 @@ from packages.domain.config_schemas import normalize_plan_config
from packages.middleware.points_gate import points_gate
from packages.shared.storage import get_shared_storage_service
from .templates_editor.dependencies import get_draft_plan_id, get_editor_services
from .templates_editor.dependencies import get_editor_services
logger = logging.getLogger(__name__)
router = APIRouter(tags=["Generation"])
@@ -349,8 +349,8 @@ def _is_trusted_media_url(url: str) -> bool:
@points_gate("ai_cover")
def generate_cover(
body: GenerateCoverRequest,
template_id: str = Query(..., description="模板 ID"),
plan_id: str = Depends(get_draft_plan_id),
template_id: str = Query("", description="模板 ID,为空时使用用户默认模板"),
plan_id: str = "",
services: tuple[EditTemplateService, EditPlanService] = Depends(get_editor_services),
db: Session = Depends(get_db_session),
current_user: AuthenticatedUser = Depends(get_current_user),
@@ -366,7 +366,27 @@ def generate_cover(
MediaKit 的调用方式(strategy / max_frames / 轮询 / 重试 / 降级)不变。
"""
_, plan_svc = services
tpl_svc, plan_svc = services
# template_id 为空时自动创建/获取用户默认模板,保证 ai_frame 无模板也能抽帧
if not template_id:
from app.api.routes.templates_editor.dependencies import resolve_draft_plan_id
plan_id = resolve_draft_plan_id(
template_id="",
services=services,
current_user=current_user,
db=db,
auto_create_default=True,
)
else:
# 校验模板存在且可访问(原 Depends 逻辑)
from app.api.routes.templates_editor.dependencies import resolve_draft_plan_id
plan_id = resolve_draft_plan_id(
template_id=template_id,
services=services,
current_user=current_user,
db=db,
auto_create_default=False,
)
plan = plan_svc.get_plan_or_raise(plan_id)
# ── upload 类型:直接保存前端上传的封面图片,不需要预览视频 ──────