修复无项目角色动作血缘与导出提示

无项目生成返回正式账号素材时沿用素材记录的直接来源资源。序列帧导出失败提示只按帧源是否存在分类，不把可选时长误报为缺帧。补充账号素材独立返回时的动作血缘回归测试和角色动作方案说明。
2026-08-04 11:41:48 +08:00
parent f5b13915e0
commit 7b1adbd5a2
4 changed files with 62 additions and 6 deletions
@@ -183,7 +183,7 @@
 - BgFilter、阿里云或本地键色返回透明结果后，父流程继续通过现有最终帧 finalizer 转为 RGBA8，按宽高比居中放入最终目标尺寸，并使用 `RGBA(0,0,0,0)` 补边；最终帧 OSS 与业务写回仍由父流程完成。上述样例最终输出必须为 `323×480 RGBA8 PNG`，顶部和底部各 `23px` 透明 padding，内容区域完整保留抠图结果。
 - 全部 `32 / 40 / 48` 帧以覆盖本次所有帧的无序在途集合向内部 worker 提交，允许乱序完成并最终按后端内部 `frame_index` 排序；该索引只服务并发收口、OSS 命名、日志和错误定位，不写入正式 asset / resource 帧对象。BgFilter provider 的实际在途请求受唯一 worker 的 `N / Q` 限制。任一帧最终失败时先排空全部已启动 Future，再让整项任务失败退款，不发布缺帧动画。
 - 抽帧结果写入 OSS，并返回帧路径、帧尺寸、帧数、fps、预览视频路径、模型、价格和实际 prompt。
- 画板前端回填角色动作结果时，以正式 resource / asset 的 `assetKind: "character-animation"` 选择序列帧播放器并以首帧作为图层主图；带项目上下文的生成必须返回正式 project resource，图层直接使用其 `resourceId`。无项目放置只允许绑定响应中的正式账号素材，不从生成结果 `frames` 构造自包含 `local-resource-character-animation-*`。预览视频作为独立 `assetKind: "video"` 资源保存，但不复制进最终动作 layout。
+- 画板前端回填角色动作结果时，以正式 resource / asset 的 `assetKind: "character-animation"` 选择序列帧播放器并以首帧作为图层主图；带项目上下文的生成必须返回正式 project resource，图层直接使用其 `resourceId`。无项目放置只允许绑定响应中的正式账号素材，不从生成结果 `frames` 构造自包含 `local-resource-character-animation-*`；此时图层的 `sourceResourceId` 继续使用正式账号素材记录的直接来源，不回退成请求中的原角色资源。预览视频作为独立 `assetKind: "video"` 资源保存，但不复制进最终动作 layout。
 - 角色动作图层在画布中循环展示透明 PNG 帧；刷新恢复只从 project resource 的 `imageSequenceFrames/imageSequenceDurationMs` 读取正式结果。动作 layer layout 只保存 `layerId/resourceId` 和几何、层级、可见性等放置信息，不保存 `mediaType`、动作帧、时长、预览、生成输入或资源元数据副本；资源缺字段时按损坏数据失败关闭。
 - 点击角色动作图层下载时，必须打包下载序列帧 ZIP；画布素材 ZIP 导出时，角色动作写入 `sequences/<编号-标题>/frames/`，而不是导出预览视频。
 - 角色动作生成 BFF 在同一请求内保存两类账号素材：上游预览 MP4 使用 `assetKind=video` 并承载生成成本，最终透明帧集使用 `assetKind=character-animation` 且派生成本为 0；响应中的 `resource` / `asset` 固定指向最终透明帧集对应的项目资源与账号素材。调用方必须直接使用它们，不得再以第一帧调用资源或素材创建接口。
@@ -733,4 +733,59 @@ describe('ImageCanvasGenerationLayerModel', () => {
      imageSequenceDurationMs: 4_000,
    });
  });
+
+  it('keeps persisted animation lineage when generation returns only an asset', () => {
+    const frames = [
+      {
+        imageSrc: '/generated-character-drafts/editor/frame1.png',
+        width: 512,
+        height: 768,
+      },
+      {
+        imageSrc: '/generated-character-drafts/editor/frame2.png',
+        width: 512,
+        height: 768,
+      },
+    ];
+    const layer = createCharacterAnimationResultLayer({
+      generated: {
+        taskId: 'character-animation-task-asset-only',
+        model: 'seedance2.0-fast',
+        prompt: '跳跃动作',
+        previewVideoPath: '/generated-character-drafts/editor/preview.mp4',
+        frames,
+        frameCount: 2,
+        durationSeconds: 4,
+        fps: 8,
+        priceMudPoints: 40,
+        asset: {
+          assetId: 'asset-character-animation-final',
+          folderId: 'user-1:asset-folder:project',
+          label: '角色跳跃',
+          imageSrc: frames[0]!.imageSrc,
+          width: 512,
+          height: 768,
+          sourceType: 'generated',
+          sourceResourceId: 'resource-character-animation-preview',
+          assetKind: 'character-animation',
+          imageSequenceFrames: frames,
+          imageSequenceDurationMs: 4_000,
+        },
+      },
+      generatedIndex: 17,
+      title: '角色跳跃',
+      canvasSize: { width: 900, height: 640 },
+      viewport: { x: 0, y: 0, scale: 1 },
+      generationInputs: createGenerationInputs(),
+      sourceLayer: createSourceLayer({
+        resourceId: 'resource-original-character',
+      }),
+    });
+
+    expect(layer).toMatchObject({
+      resourceId: 'local-resource-asset-character-animation-final',
+      sourceResourceId: 'resource-character-animation-preview',
+      sourceAssetId: 'asset-character-animation-final',
+    });
+  });
 });
@@ -593,7 +593,10 @@ export function createCharacterAnimationResultLayer({
    objectKey: persisted?.objectKey,
    assetObjectId: persisted?.assetObjectId,
    sourceAssetId: asset?.assetId,
-    sourceResourceId: resource?.sourceResourceId ?? sourceLayer?.resourceId,
+    sourceResourceId:
+      resource?.sourceResourceId ??
+      asset?.sourceResourceId ??
+      sourceLayer?.resourceId,
    groupId: sourceLayer?.groupId,
    generationInputs: persisted?.generationInputs ?? generationInputs,
    generatedAssetSnapshot: asset,
@@ -302,12 +302,10 @@ export function useImageCanvasAssetExportWorkflow({
            }
          })
          .catch(() => {
-            const hasUsableFrameSource =
-              (layer.imageSequenceFrames?.length ?? 0) > 0 &&
-              (layer.imageSequenceDurationMs ?? 0) > 0;
+            const hasFrameSource = (layer.imageSequenceFrames?.length ?? 0) > 0;
            setAssetExportStatus({
              tone: 'error',
-              message: hasUsableFrameSource
+              message: hasFrameSource
                ? '序列帧导出失败'
                : `角色动作素材“${layer.title}”不完整：缺少可用序列帧。`,
            });