From e500c2d6a0d2cef020d90006b3efd248db40f2f4 Mon Sep 17 00:00:00 2001
From: seaislee1209 <seaislee129@gmail.com>
Date: Fri, 15 May 2026 17:23:56 +0800
Subject: [PATCH] =?UTF-8?q?feat(assets):=203=20=E4=B8=AA=E8=B5=84=E4=BA=A7?=
 =?UTF-8?q?=E9=A1=B5=E8=A7=86=E9=A2=91=E4=B9=9F=E5=8A=A0=20poster=20?=
 =?UTF-8?q?=E9=A6=96=E5=B8=A7=20=E2=80=94=20batch=20B=20=E6=BC=8F=E7=9A=84?=
 =?UTF-8?q?=E8=A1=A5=E5=85=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

v0.20.1 batch B 只给生成页 GenerationCard + 消费记录 RecordDetailModal +
视频详情 VideoDetailModal 加了 poster,3 个资产页漏了:
- 用户资产页 (AssetsPage.tsx)
- 超管内容资产 (AdminAssetsPage.tsx)
- 团管内容资产 (TeamAssetsPage.tsx)

用户实测:消费记录详情能看到首帧海报 + 加载圈;打开内容资产页 / 生成页面
其他位置的视频卡片黑底硬等加载,没首帧 — 体验不一致。

修法:
- 后端 admin_assets_user_videos / team_assets_member_videos view 各加一行
  'thumbnail_url': r.thumbnail_url or '' (batch B 的 3 个 records view 已有)
- AssetVideo 类型加 thumbnail_url?: string
- 3 个资产页 <video> 加 poster={... ? rewriteTosUrl(...) : undefined}
  (跟 GenerationCard/RecordDetailModal/VideoDetailModal 写法一致)

GenerationCard.tsx 已在 batch B 加过 poster — 用户感觉"生成页面也没"是因为本地
ARK_API_KEY 未配生不了新视频,老 record thumbnail_url 字段是空。新生成的视频
会有(后端 tasks.py:_handle_completed ffmpeg 已经写入)。

测试:tsc 0 error, v0.20.1-smoke 11/11 + modal-interaction 8/8 + announcement 17/17

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 backend/apps/generation/views.py  | 2 ++
 web/src/pages/AdminAssetsPage.tsx | 2 +-
 web/src/pages/AssetsPage.tsx      | 1 +
 web/src/pages/TeamAssetsPage.tsx  | 2 +-
 web/src/types/index.ts            | 1 +
 5 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/backend/apps/generation/views.py b/backend/apps/generation/views.py
index 39f578b..29d3e52 100644
--- a/backend/apps/generation/views.py
+++ b/backend/apps/generation/views.py
@@ -3022,6 +3022,7 @@ def admin_assets_user_videos(request, user_id):
             'task_id': str(r.task_id),
             'prompt': r.prompt,
             'result_url': r.result_url or '',
+            'thumbnail_url': r.thumbnail_url or '',
             'duration': r.duration,
             'seconds_consumed': r.seconds_consumed,
             'aspect_ratio': r.aspect_ratio,
@@ -3104,6 +3105,7 @@ def team_assets_member_videos(request, member_id):
             'task_id': str(r.task_id),
             'prompt': r.prompt,
             'result_url': r.result_url or '',
+            'thumbnail_url': r.thumbnail_url or '',
             'duration': r.duration,
             'seconds_consumed': r.seconds_consumed,
             'aspect_ratio': r.aspect_ratio,
diff --git a/web/src/pages/AdminAssetsPage.tsx b/web/src/pages/AdminAssetsPage.tsx
index 7cbc1b3..dda82cf 100644
--- a/web/src/pages/AdminAssetsPage.tsx
+++ b/web/src/pages/AdminAssetsPage.tsx
@@ -21,7 +21,7 @@ function VideoThumbnail({ video, onClick }: { video: AssetVideo; onClick: () =>
       onClick={onClick}
     >
       {video.result_url ? (
-        <video ref={videoRef} src={rewriteTosUrl(video.result_url)} className={styles.thumbVideo} muted loop preload="metadata" />
+        <video ref={videoRef} src={rewriteTosUrl(video.result_url)} poster={video.thumbnail_url ? rewriteTosUrl(video.thumbnail_url) : undefined} className={styles.thumbVideo} muted loop preload="metadata" />
       ) : (
         <div className={styles.thumbPlaceholder} />
       )}
diff --git a/web/src/pages/AssetsPage.tsx b/web/src/pages/AssetsPage.tsx
index b8d8451..e89ebed 100644
--- a/web/src/pages/AssetsPage.tsx
+++ b/web/src/pages/AssetsPage.tsx
@@ -72,6 +72,7 @@ function VideoThumbnail({
         <video
           ref={videoRef}
           src={rewriteTosUrl(task.resultUrl)}
+          poster={task.thumbnailUrl ? rewriteTosUrl(task.thumbnailUrl) : undefined}
           className={styles.thumbVideo}
           muted
           loop
diff --git a/web/src/pages/TeamAssetsPage.tsx b/web/src/pages/TeamAssetsPage.tsx
index 4af7ae2..a2afcf3 100644
--- a/web/src/pages/TeamAssetsPage.tsx
+++ b/web/src/pages/TeamAssetsPage.tsx
@@ -21,7 +21,7 @@ function VideoThumbnail({ video, onClick }: { video: AssetVideo; onClick: () =>
       onClick={onClick}
     >
       {video.result_url ? (
-        <video ref={videoRef} src={rewriteTosUrl(video.result_url)} className={styles.thumbVideo} muted loop preload="metadata" />
+        <video ref={videoRef} src={rewriteTosUrl(video.result_url)} poster={video.thumbnail_url ? rewriteTosUrl(video.thumbnail_url) : undefined} className={styles.thumbVideo} muted loop preload="metadata" />
       ) : (
         <div className={styles.thumbPlaceholder} />
       )}
diff --git a/web/src/types/index.ts b/web/src/types/index.ts
index 9c4541e..c1427bf 100644
--- a/web/src/types/index.ts
+++ b/web/src/types/index.ts
@@ -414,6 +414,7 @@ export interface AssetVideo {
   task_id: string;
   prompt: string;
   result_url: string;
+  thumbnail_url?: string;
   duration: number;
   seconds_consumed: number;
   cost_amount?: number;