- 
- 
(null);
+ const {
+ resolvedUrl: resolvedBackdropImageSrc,
+ shouldResolve: shouldResolveBackdropImage,
+ } = useResolvedAssetReadUrl(currentScenePreset?.imageSrc);
const connectedScenes = useMemo(
() =>
@@ -186,7 +191,10 @@ export function MapModal({
return buildFallbackConnectionEntries(currentScenePreset, connectedScenes);
}, [connectedScenes, currentScenePreset]);
- const sceneBackdropStyle = buildSceneBackdropStyle(currentScenePreset?.imageSrc);
+ const sceneBackdropStyle = buildSceneBackdropStyle(
+ resolvedBackdropImageSrc
+ || (!shouldResolveBackdropImage ? currentScenePreset?.imageSrc : ''),
+ );
const destinationStackHeightPx = getMapDestinationStackHeight(connectionEntries.length);
useEffect(() => {
diff --git a/src/components/ResolvedAssetImage.tsx b/src/components/ResolvedAssetImage.tsx
new file mode 100644
index 00000000..bc550e80
--- /dev/null
+++ b/src/components/ResolvedAssetImage.tsx
@@ -0,0 +1,27 @@
+import type { ImgHTMLAttributes } from 'react';
+
+import { useResolvedAssetReadUrl } from '../hooks/useResolvedAssetReadUrl';
+
+type ResolvedAssetImageProps = Omit<
+ ImgHTMLAttributes,
+ 'src'
+> & {
+ src?: string | null;
+ fallbackSrc?: string | null;
+};
+
+export function ResolvedAssetImage({
+ src,
+ fallbackSrc,
+ alt,
+ ...rest
+}: ResolvedAssetImageProps) {
+ const { resolvedUrl } = useResolvedAssetReadUrl(src);
+ const finalSrc = resolvedUrl || fallbackSrc?.trim() || '';
+
+ if (!finalSrc) {
+ return null;
+ }
+
+ return 
;
+}
diff --git a/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx b/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx
index 85e1c001..5409ef88 100644
--- a/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx
+++ b/src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx
@@ -1,4 +1,5 @@
import type { CustomWorldDraftCardDetail } from '../../../packages/shared/src/contracts/customWorldAgent';
+import { ResolvedAssetImage } from '../ResolvedAssetImage';
import { CustomWorldDraftEditPanel } from './CustomWorldDraftEditPanel';
type CustomWorldAgentDraftDetailPanelProps = {
@@ -179,7 +180,7 @@ export function CustomWorldAgentDraftDetailPanel({
{section.label}
{shouldRenderImagePreview(detail.kind, section.id, section.value) ? (
- 
{encounter.kind === 'treasure' ? (
-
{imageSrc ? (
- 
- 
{src ? (
- 
+
) : role.imageSrc ? (
-
{fallbackLabel}
@@ -1427,7 +1432,7 @@ export function CustomWorldEntityCatalog({
}
media={
role.imageSrc?.trim() ? (
-
) : previewImageSrc ? (
-
- {src ? (
+ {displaySrc ? (
) : role.imageSrc ? (
-
- 
{preferredImageSrc ? (
- 
({
default: () => null,
}));
+vi.mock('../services/assetReadUrlService', () => ({
+ resolveAssetReadUrl: vi.fn(async (source: string | null | undefined) => {
+ const value = source?.trim() ?? '';
+ return value ? `https://signed.example${value}` : '';
+ }),
+ isGeneratedLegacyPath: vi.fn((source: string | null | undefined) => {
+ const value = source?.trim() ?? '';
+ return /^\/generated-[^/?#]+\/.+/u.test(value);
+ }),
+}));
+
async function loadAiService() {
return import('../services/aiService');
}
@@ -315,9 +326,13 @@ test('clicking新增可扮演角色 shows pending item, disables button, and mar
expect(screen.getAllByText('新').length).toBeGreaterThan(0);
});
-test('world basic setting renders eight anchor fields and hides legacy parsed/source copy', () => {
+test('world basic setting renders eight anchor fields and hides legacy parsed/source copy', async () => {
render(
>({});
+ const [assetDebugResolvedImageMap, setAssetDebugResolvedImageMap] = useState<
+ Record
+ >({});
+ const assetDebugResolvedEntries = useMemo(
+ () =>
+ assetDebugEntries.map((entry) => ({
+ ...entry,
+ hasResolvedImageSrc: Object.prototype.hasOwnProperty.call(
+ assetDebugResolvedImageMap,
+ entry.id,
+ ),
+ resolvedImageSrc: assetDebugResolvedImageMap[entry.id] || entry.imageSrc,
+ })),
+ [assetDebugEntries, assetDebugResolvedImageMap],
+ );
+ const assetDebugDetectableEntries = useMemo(
+ () =>
+ assetDebugResolvedEntries.filter(
+ (entry) =>
+ entry.hasResolvedImageSrc && Boolean(entry.resolvedImageSrc.trim()),
+ ),
+ [assetDebugResolvedEntries],
+ );
const createTarget = useMemo(
() => getCreateTargetByTab(activeTab),
@@ -425,11 +449,42 @@ export function CustomWorldResultView({
useEffect(() => {
if (!assetDebugEnabled) {
- setAssetDebugStatusMap({});
+ setAssetDebugResolvedImageMap({});
return;
}
if (assetDebugEntries.length === 0) {
+ setAssetDebugResolvedImageMap({});
+ return;
+ }
+
+ let cancelled = false;
+
+ void Promise.all(
+ assetDebugEntries.map(async (entry) => [
+ entry.id,
+ await resolveAssetReadUrl(entry.imageSrc),
+ ] as const),
+ ).then((resolvedEntries) => {
+ if (cancelled) {
+ return;
+ }
+
+ setAssetDebugResolvedImageMap(Object.fromEntries(resolvedEntries));
+ });
+
+ return () => {
+ cancelled = true;
+ };
+ }, [assetDebugEnabled, assetDebugEntries]);
+
+ useEffect(() => {
+ if (!assetDebugEnabled) {
+ setAssetDebugStatusMap({});
+ return;
+ }
+
+ if (assetDebugDetectableEntries.length === 0) {
setAssetDebugStatusMap({});
return;
}
@@ -437,13 +492,14 @@ export function CustomWorldResultView({
let cancelled = false;
const cleanupList: Array<() => void> = [];
+ // 诊断面板只根据已解析地址做探测，避免状态流里反复访问原始 generated-* 路径。
setAssetDebugStatusMap(
Object.fromEntries(
- assetDebugEntries.map((entry) => [entry.id, 'loading' as const]),
+ assetDebugDetectableEntries.map((entry) => [entry.id, 'loading' as const]),
),
);
- assetDebugEntries.forEach((entry) => {
+ assetDebugDetectableEntries.forEach((entry) => {
const image = new Image();
const updateStatus = (status: AssetDebugLoadStatus) => {
if (cancelled) {
@@ -463,7 +519,7 @@ export function CustomWorldResultView({
image.onload = () => updateStatus('loaded');
image.onerror = () => updateStatus('error');
- image.src = entry.imageSrc;
+ image.src = entry.resolvedImageSrc;
cleanupList.push(() => {
image.onload = null;
image.onerror = null;
@@ -474,7 +530,7 @@ export function CustomWorldResultView({
cancelled = true;
cleanupList.forEach((cleanup) => cleanup());
};
- }, [assetDebugEnabled, assetDebugEntries]);
+ }, [assetDebugDetectableEntries, assetDebugEnabled]);
const startPendingProgress = (kind: EntityGenerationKind) => {
stopPendingProgressTimer();
@@ -679,7 +735,7 @@ export function CustomWorldResultView({
- {assetDebugEntries.length}项
+ {assetDebugResolvedEntries.length}项
@@ -696,8 +752,8 @@ export function CustomWorldResultView({
))}
- {assetDebugEntries.length > 0 ? (
- assetDebugEntries.map((entry) => (
+ {assetDebugResolvedEntries.length > 0 ? (
+ assetDebugResolvedEntries.map((entry) => (
))
diff --git a/src/components/CustomWorldRoleAssetStudioModal.tsx b/src/components/CustomWorldRoleAssetStudioModal.tsx
index 41a37471..739bd413 100644
--- a/src/components/CustomWorldRoleAssetStudioModal.tsx
+++ b/src/components/CustomWorldRoleAssetStudioModal.tsx
@@ -34,6 +34,7 @@ import { buildDefaultRolePromptBundle } from './asset-studio/customWorldRoleProm
import { buildProjectPixelStyleReferenceBoard } from './asset-studio/projectPixelStyleReference';
import { useAuthUi } from './auth/AuthUiContext';
import { CharacterAnimator } from './CharacterAnimator';
+import { ResolvedAssetImage } from './ResolvedAssetImage';
type EditableCustomWorldRole = {
id: string;
@@ -1173,13 +1174,13 @@ export function CustomWorldRoleAssetStudioModal({
{previewImageSrc ? (
-
) : selectedTemplate ? (
- 
) : previewImageSrc ? (
-
- 
- {!backgroundLoadFailed ? (
+ {!backgroundLoadFailed && displayBackgroundSrc ? (
;
+ }
+
+ if (displayEncounterImageSrc) {
return (
})
) : (
-
+ 
+ );
+}
+
function SectionHeader({ title, detail }: { title: string; detail: string }) {
return (
@@ -91,7 +122,7 @@ function SaveArchivePreview({
className={`platform-remap-surface relative shrink-0 overflow-hidden rounded-[1.35rem] border border-white/12 bg-black/18 shadow-[var(--platform-desktop-hover-shadow)] ${className}`}
>
{entry.coverImageSrc ? (
- 
{coverImage ? (
- 
) : null}
{leadPortrait ? (
-
{coverImage ? (
-
) : null}
{leadPortrait ? (
-
{coverImage ? (
-
{desktopHeroCover ? (
-
{coverImage ? (
-
{coverImage ? (
-
) : null}
{leadPortrait ? (
- ({
+ resolveAssetReadUrl: vi.fn(async (source: string | null | undefined) => {
+ const value = source?.trim() ?? '';
+ return value ? `https://signed.example${value}` : '';
+ }),
+ isGeneratedLegacyPath: vi.fn((source: string | null | undefined) => {
+ const value = source?.trim() ?? '';
+ return /^\/generated-[^/?#]+\/.+/u.test(value);
+ }),
+}));
+
async function clickFirstButtonByName(
user: ReturnType,
name: string | RegExp,
@@ -434,6 +445,39 @@ test('clicking a public work while logged out routes through requireAuth', async
expect(getCustomWorldGalleryDetail).not.toHaveBeenCalled();
});
+test('platform home cards resolve generated cover images through signed read urls', async () => {
+ vi.mocked(listCustomWorldGallery).mockResolvedValue([
+ {
+ ownerUserId: 'author-1',
+ profileId: 'world-public-1',
+ visibility: 'published',
+ publishedAt: '2026-04-16T12:00:00.000Z',
+ updatedAt: '2026-04-16T12:00:00.000Z',
+ worldName: '潮雾列岛',
+ subtitle: '旧灯塔与失控航路',
+ summaryText: '最近公开发布的世界。',
+ coverImageSrc: '/generated-custom-world-covers/world-public-1/cover.webp',
+ themeMode: 'tide',
+ authorDisplayName: '潮汐作者',
+ playableNpcCount: 3,
+ landmarkCount: 4,
+ },
+ ]);
+
+ render(();
+const pendingSignedReadUrlRequests = new Map>();
+
+export function isGeneratedLegacyPath(value: string) {
+ return /^\/generated-[^/?#]+\/.+/u.test(value.trim());
+}
+
+function normalizeLegacyPublicPath(value: string) {
+ return `/${value.trim().replace(/^\/+/u, '')}`;
+}
+
+function buildCacheKey(request: AssetReadUrlRequest) {
+ if (request.objectKey?.trim()) {
+ return `object:${request.objectKey.trim().replace(/^\/+/u, '')}`;
+ }
+
+ if (request.legacyPublicPath?.trim()) {
+ return `legacy:${normalizeLegacyPublicPath(request.legacyPublicPath)}`;
+ }
+
+ return '';
+}
+
+function resolveSignedReadPayload(response: AssetReadUrlResponse) {
+ const read = response.read ?? response;
+ const signedUrl = typeof read.signedUrl === 'string' ? read.signedUrl.trim() : '';
+ const expiresAt = typeof read.expiresAt === 'string' ? read.expiresAt.trim() : '';
+ const objectKey = typeof read.objectKey === 'string' ? read.objectKey.trim() : '';
+
+ if (!signedUrl) {
+ throw new Error('资源访问地址缺失');
+ }
+
+ return {
+ signedUrl,
+ expiresAt,
+ objectKey,
+ };
+}
+
+function parseExpiresAtMs(expiresAt: string) {
+ if (!expiresAt) {
+ return 0;
+ }
+
+ const parsed = Date.parse(expiresAt);
+ return Number.isFinite(parsed) ? parsed : 0;
+}
+
+function shouldReuseCachedReadUrl(entry: CachedReadUrlEntry | undefined) {
+ if (!entry) {
+ return false;
+ }
+
+ return entry.expiresAtMs - DEFAULT_CACHE_SAFETY_WINDOW_MS > Date.now();
+}
+
+export async function getSignedAssetReadUrl(
+ request: AssetReadUrlRequest,
+ signal?: AbortSignal,
+) {
+ const cacheKey = buildCacheKey(request);
+ const cached = cacheKey ? signedReadUrlCache.get(cacheKey) : undefined;
+ if (cached && shouldReuseCachedReadUrl(cached)) {
+ return cached.signedUrl;
+ }
+
+ if (cacheKey) {
+ const pendingRequest = pendingSignedReadUrlRequests.get(cacheKey);
+ if (pendingRequest) {
+ return pendingRequest;
+ }
+ }
+
+ const requestPromise = (async () => {
+ const searchParams = new URLSearchParams();
+ if (request.objectKey?.trim()) {
+ searchParams.set('objectKey', request.objectKey.trim().replace(/^\/+/u, ''));
+ }
+ if (request.legacyPublicPath?.trim()) {
+ searchParams.set(
+ 'legacyPublicPath',
+ normalizeLegacyPublicPath(request.legacyPublicPath),
+ );
+ }
+ if (
+ typeof request.expireSeconds === 'number' &&
+ Number.isFinite(request.expireSeconds) &&
+ request.expireSeconds > 0
+ ) {
+ searchParams.set('expireSeconds', String(Math.floor(request.expireSeconds)));
+ }
+
+ const response = await requestJson(
+ `${ASSET_READ_URL_API_PATH}?${searchParams.toString()}`,
+ {
+ method: 'GET',
+ signal,
+ },
+ '获取资源访问地址失败',
+ );
+ const payload = resolveSignedReadPayload(response);
+ const expiresAtMs = parseExpiresAtMs(payload.expiresAt);
+
+ if (cacheKey && expiresAtMs > 0) {
+ signedReadUrlCache.set(cacheKey, {
+ signedUrl: payload.signedUrl,
+ expiresAtMs,
+ });
+ }
+
+ return payload.signedUrl;
+ })();
+
+ if (cacheKey) {
+ pendingSignedReadUrlRequests.set(cacheKey, requestPromise);
+ }
+
+ try {
+ return await requestPromise;
+ } finally {
+ if (cacheKey) {
+ pendingSignedReadUrlRequests.delete(cacheKey);
+ }
+ }
+}
+
+// 兼容层：普通 http(s)/data/blob 路径原样返回；历史 generated-* 路径自动换签名读 URL。
+export async function resolveAssetReadUrl(
+ source: string | null | undefined,
+ options: {
+ signal?: AbortSignal;
+ expireSeconds?: number;
+ } = {},
+) {
+ const value = source?.trim() ?? '';
+ if (!value) {
+ return '';
+ }
+
+ if (
+ /^(?:https?:)?\/\//u.test(value) ||
+ value.startsWith('data:') ||
+ value.startsWith('blob:')
+ ) {
+ return value;
+ }
+
+ if (isGeneratedLegacyPath(value)) {
+ return getSignedAssetReadUrl(
+ {
+ legacyPublicPath: value,
+ expireSeconds: options.expireSeconds,
+ },
+ options.signal,
+ );
+ }
+
+ return value;
+}
+
+export function clearSignedAssetReadUrlCache() {
+ signedReadUrlCache.clear();
+ pendingSignedReadUrlRequests.clear();
+}
diff --git a/src/tools/QwenSpriteSheetTool.tsx b/src/tools/QwenSpriteSheetTool.tsx
index 264742a7..c6993817 100644
--- a/src/tools/QwenSpriteSheetTool.tsx
+++ b/src/tools/QwenSpriteSheetTool.tsx
@@ -18,6 +18,7 @@ import {
GENERATED_FRAME_WIDTH,
} from '../components/asset-studio/characterAssetWorkflowModel';
import { generateCharacterAnimationDraft } from '../components/asset-studio/characterAssetWorkflowPersistence';
+import { ResolvedAssetImage } from '../components/ResolvedAssetImage';
import {
NumberField,
SelectField,
@@ -124,7 +125,7 @@ function DraftStrip({
}`}
>
- 
-