1

src/services/match3dGeneratedModelCache.ts

@@ -1,5 +1,5 @@
 import type { Match3DGeneratedItemAsset } from '../../packages/shared/src/contracts/match3dWorks';
-import { readAssetBytes } from './assetReadUrlService';
+import { readAssetBytes, resolveAssetReadUrl } from './assetReadUrlService';
 
 type CachedMatch3DModelBytes = {
   accessedAt: number;
@@ -117,6 +117,14 @@ export function getMatch3DGeneratedImageAssetSources(
   ];
 }
 
+export function hasMatch3DGeneratedImageAsset(
+  assets: readonly Match3DGeneratedItemAsset[] | null | undefined,
+) {
+  return Boolean(
+    assets?.some((asset) => getMatch3DGeneratedImageViewSources(asset).length > 0),
+  );
+}
+
 export function getMatch3DGeneratedModelAssetSources(
   assets: readonly Match3DGeneratedItemAsset[] = [],
 ) {
@@ -198,6 +206,28 @@ export function preloadMatch3DGeneratedModelAssets(
   );
 }
 
+export async function preloadMatch3DGeneratedImageAssets(
+  assets: readonly Match3DGeneratedItemAsset[] = [],
+  options: Omit<Match3DModelBytesOptions, 'signal'> = {},
+) {
+  const sources = getMatch3DGeneratedImageAssetSources(assets);
+  await Promise.allSettled(
+    sources.map((source) =>
+      resolveAssetReadUrl(source, {
+        expireSeconds: options.expireSeconds,
+      }),
+    ),
+  );
+}
+
+export async function preloadMatch3DGeneratedRuntimeAssets(
+  assets: readonly Match3DGeneratedItemAsset[] = [],
+  options: Omit<Match3DModelBytesOptions, 'signal'> = {},
+) {
+  // 中文注释：新抓大鹅运行态以 2D 图片为主；3D 模型只作为历史草稿预览兼容。
+  await preloadMatch3DGeneratedImageAssets(assets, options);
+}
+
 export function clearMatch3DGeneratedModelBytesCache() {
   match3dModelBytesCache.clear();
 }