feat(#1714): 前端 prepare 短路（后端 skip_transfer 命中时跳过 OSS 直传） (#1729)

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com> Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>
2026-09-06 11:43:59 +08:00
parent 06b0bacce1
commit ff60fdf956
5 changed files with 170 additions and 0 deletions
@@ -139,6 +139,17 @@ export interface DirectUploadPrepareResult {
   * 旧后端不返回该字段，前端降级为无预建卡片的原有行为。
   */
  asset_id?: string
+  /**
+   * 后端 file_hash 命中素材库已有相同文件时为 true，前端应跳过 transfer + complete 阶段
+   * 直接按「去重命中」处理（不调 transfer、不调 complete、立即刷新素材列表）。
+   * 旧后端不返回该字段，前端降级为走老流程。
+   */
+  duplicated?: boolean
+  /**
+   * 与 duplicated 语义一致：true 表示跳过传输，前端据此短路。
+   * 两个字段是同一语义的别名（后端可能只返回其一），前端任意为 true 即视为命中去重。
+   */
+  skip_transfer?: boolean
 }

 /** 直传完成确认返回 */
@@ -179,6 +179,16 @@ export const uploadAssetDirect = async (data: {
    fileHash,
    clientUploadId,
  })
+  // prepare 阶段后端 file_hash 命中素材库已有相同文件：跳过 transfer + complete
+  if (handle.prepared.skip_transfer || handle.prepared.duplicated) {
+    return {
+      storage_key: handle.prepared.storage_key,
+      ingest_job_id: "",
+      url: "",
+      duplicated: true,
+      asset_id: handle.prepared.asset_id,
+    }
+  }
  await handle.transfer(data.onProgress)
  return handle.complete()
 }