From cb57e59ec4516a60bd68f487ebd9640874310598 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Wed, 7 Oct 2026 14:16:44 +0800
Subject: [PATCH] =?UTF-8?q?=E5=9B=BE=E7=89=87=E9=A2=84=E8=A7=88=E6=96=87?=
 =?UTF-8?q?=E6=A1=88=E6=8C=89=E5=B0=81=E9=9D=A2/=E6=88=AA=E5=9B=BE?=
 =?UTF-8?q?=E8=AF=AD=E5=A2=83=E5=8C=BA=E5=88=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- IconPreview 增加可选 labels，缺省仍是小红书「图标」文案
- FormCard 的封面与截图预览各自传入封面/截图语义的 alt、title 与 aria
---
 .../export/tabs/taonier/FormCard.tsx          | 17 ++++++++++-
 .../export/tabs/xiaohongshu/IconPreview.tsx   | 30 ++++++++++++++++---
 2 files changed, 42 insertions(+), 5 deletions(-)

diff --git a/apps/ai-game-creator-shell/src/view/project-development/export/tabs/taonier/FormCard.tsx b/apps/ai-game-creator-shell/src/view/project-development/export/tabs/taonier/FormCard.tsx
index 3ea025aa4..e3803cec6 100644
--- a/apps/ai-game-creator-shell/src/view/project-development/export/tabs/taonier/FormCard.tsx
+++ b/apps/ai-game-creator-shell/src/view/project-development/export/tabs/taonier/FormCard.tsx
@@ -252,6 +252,12 @@ export function FormCard({
               <IconPreview
                 projectPath={projectPath}
                 relativePath={form.coverPath}
+                labels={{
+                  alt: '封面预览',
+                  failedTitle: '读不到这张图，用「选择封面」导入一张就能预览',
+                  failedAria: '封面读不到',
+                  emptyAria: '还没有选封面',
+                }}
               />
             ) : (
               <span className="grid size-24 shrink-0 place-items-center overflow-hidden rounded-xl border border-dashed border-(--platform-surface-border) bg-(--platform-input-fill) text-center text-xs text-(--platform-text-soft)">
@@ -315,7 +321,16 @@ export function FormCard({
             <div className="flex flex-wrap gap-2">
               {form.screenshotPaths.map((path, index) => (
                 <div key={`${path}-${index}`} className="grid gap-1">
-                  <IconPreview projectPath={projectPath} relativePath={path} />
+                  <IconPreview
+                    projectPath={projectPath}
+                    relativePath={path}
+                    labels={{
+                      alt: `第 ${index + 1} 张截图预览`,
+                      failedTitle: '读不到这张图，重新选择截图就能预览',
+                      failedAria: `第 ${index + 1} 张截图读不到`,
+                      emptyAria: `第 ${index + 1} 张截图`,
+                    }}
+                  />
                   <PaneButton
                     variant="ghost"
                     ariaLabel={`移除第 ${index + 1} 张截图`}
diff --git a/apps/ai-game-creator-shell/src/view/project-development/export/tabs/xiaohongshu/IconPreview.tsx b/apps/ai-game-creator-shell/src/view/project-development/export/tabs/xiaohongshu/IconPreview.tsx
index ef1d96f4d..2abf0e683 100644
--- a/apps/ai-game-creator-shell/src/view/project-development/export/tabs/xiaohongshu/IconPreview.tsx
+++ b/apps/ai-game-creator-shell/src/view/project-development/export/tabs/xiaohongshu/IconPreview.tsx
@@ -11,7 +11,18 @@ import {
 type ImagePreviewResponse = { dataUrl: string };
 
 /**
- * 图标缩略图：把项目里那张图读成 dataUrl 直接显示。
+ * 无障碍与占位文案；缺省是小红书「图标」语境。封面/截图等复用方按自己的语义覆盖，
+ * 避免读图失败时对用户说成「选择图标」。
+ */
+type IconPreviewLabels = {
+  alt?: string;
+  failedTitle?: string;
+  failedAria?: string;
+  emptyAria?: string;
+};
+
+/**
+ * 图片缩略图：把项目里那张图读成 dataUrl 直接显示。
  *
  * 走 UI Editor 同一套 `read_local_project_image_preview`——越界、符号链接、敏感路径的门禁在宿主
  * 那边，而且宿主只允许预览「已登记资源」。用户手填一条没登记过的路径时这里读不到，退回占位符并
@@ -20,9 +31,11 @@ type ImagePreviewResponse = { dataUrl: string };
 export function IconPreview({
   projectPath,
   relativePath,
+  labels,
 }: {
   projectPath: string | null;
   relativePath: string;
+  labels?: IconPreviewLabels;
 }) {
   const [dataUrl, setDataUrl] = useState<string | null>(null);
   const [failed, setFailed] = useState(false);
@@ -71,15 +84,24 @@ export function IconPreview({
     <span
       className="grid size-24 shrink-0 place-items-center overflow-hidden rounded-xl border border-(--platform-surface-border) bg-(--platform-input-fill)"
       title={
-        failed ? '读不到这张图，用「选择图标」导入一张就能预览' : undefined
+        failed
+          ? (labels?.failedTitle ??
+            '读不到这张图，用「选择图标」导入一张就能预览')
+          : undefined
       }
       role={dataUrl ? undefined : 'img'}
-      aria-label={dataUrl ? undefined : failed ? '图标读不到' : '还没有选图标'}
+      aria-label={
+        dataUrl
+          ? undefined
+          : failed
+            ? (labels?.failedAria ?? '图标读不到')
+            : (labels?.emptyAria ?? '还没有选图标')
+      }
     >
       {dataUrl ? (
         <img
           src={dataUrl}
-          alt="图标预览"
+          alt={labels?.alt ?? '图标预览'}
           className="size-full object-contain"
         />
       ) : (