feat: 前端改为通过签名地址读取生成资源

src/hooks/useResolvedAssetReadUrl.ts

@@ -0,0 +1,64 @@
+import { useEffect, useState } from 'react';
+
+import {
+  isGeneratedLegacyPath,
+  resolveAssetReadUrl,
+} from '../services/assetReadUrlService';
+
+type UseResolvedAssetReadUrlOptions = {
+  enabled?: boolean;
+  expireSeconds?: number;
+};
+
+export function useResolvedAssetReadUrl(
+  source: string | null | undefined,
+  options: UseResolvedAssetReadUrlOptions = {},
+) {
+  const enabled = options.enabled !== false;
+  const normalizedSource = source?.trim() ?? '';
+  const shouldResolve =
+    enabled && Boolean(normalizedSource) && isGeneratedLegacyPath(normalizedSource);
+  const [resolvedUrl, setResolvedUrl] = useState(
+    shouldResolve ? '' : normalizedSource,
+  );
+
+  useEffect(() => {
+    if (!normalizedSource) {
+      setResolvedUrl('');
+      return;
+    }
+
+    if (!shouldResolve) {
+      setResolvedUrl(normalizedSource);
+      return;
+    }
+
+    let cancelled = false;
+    setResolvedUrl('');
+
+    void resolveAssetReadUrl(normalizedSource, {
+      expireSeconds: options.expireSeconds,
+    })
+      .then((nextUrl) => {
+        if (!cancelled) {
+          setResolvedUrl(nextUrl);
+        }
+      })
+      .catch(() => {
+        if (!cancelled) {
+          // 读取签名失败时回退原始路径，至少保持现有 UI 可见错误表象。
+          setResolvedUrl(normalizedSource);
+        }
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [normalizedSource, options.expireSeconds, shouldResolve]);
+
+  return {
+    resolvedUrl,
+    isResolving: shouldResolve && !resolvedUrl,
+    shouldResolve,
+  };
+}