From 2d31e19791cc8d7807f8a9286119ab6bc930167b Mon Sep 17 00:00:00 2001
From: kdletters <61648117+kdletters@users.noreply.github.com>
Date: Tue, 26 May 2026 17:37:40 +0800
Subject: [PATCH] hide frontend image model names
---
.hermes/shared-memory/decision-log.md | 8 ++++++++
docs/【玩法创作】平台入口与玩法链路-2026-05-15.md | 3 ++-
.../BabyObjectMatchResultView.test.tsx | 2 +-
.../edutainment-result/BabyObjectMatchResultView.tsx | 2 +-
.../platform-entry/PlatformEntryFlowShellImpl.tsx | 6 +++---
.../PuzzleAgentWorkspace.interaction.test.tsx | 8 ++++----
src/components/puzzle-agent/PuzzleImageModelPicker.tsx | 4 ++--
src/components/puzzle-agent/puzzleImageModelOptions.ts | 6 +++---
src/components/puzzle-result/PuzzleResultView.test.tsx | 9 ++++++---
.../edutainment-baby-object/babyObjectMatchClient.ts | 2 +-
src/services/miniGameDraftGenerationProgress.test.ts | 2 +-
src/services/miniGameDraftGenerationProgress.ts | 10 +++++-----
12 files changed, 37 insertions(+), 25 deletions(-)
diff --git a/.hermes/shared-memory/decision-log.md b/.hermes/shared-memory/decision-log.md
index 840846b4..5500afdd 100644
--- a/.hermes/shared-memory/decision-log.md
+++ b/.hermes/shared-memory/decision-log.md
@@ -992,3 +992,11 @@
- 影响范围：`WoodenFishWorkspace`、`WoodenFishResultView`、`PlatformEntryFlowShellImpl`、敲木鱼 PRD 和平台入口链路文档。
- 验证方式：工作台首屏不再出现标题 / 简介 / 标签输入；结果页修改后点试玩或发布会先写回当前作品信息。
- 关联文档：`docs/prd/【玩法创作】敲木鱼玩法模板PRD-2026-05-20.md`、`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
+
+## 2026-05-26 前端不外露图片模型名
+
+- 背景：拼图与相关结果页、生成进度和错误提示里直接显示 `gpt-image-2`、`gemini-3.1-flash-image-preview`、`image-2` 等名称，会把内部模型路由暴露给普通用户。
+- 决策：前端展示层统一改用产品化名称，如“标准模式”“创意模式”，以及“素材”“图片生成模式”等中性文案；内部 `imageModel`、`generationProvider` 和后端契约值保留不变，只改 UI 文案与错误提示。
+- 影响范围：拼图图片模型选择器、拼图结果页关卡重生成面板、拼图生成进度文案、宝贝识物结果页占位提示和相关错误提示。
+- 验证方式：前端可见文本中不再出现 `gpt-image-2` / `gemini-3.1-flash-image-preview` / `image-2 资源`；相关交互测试改为断言产品化模式名，但提交 payload 仍保持原有模型 ID。
+- 关联文档：`docs/【玩法创作】平台入口与玩法链路-2026-05-15.md`。
diff --git a/docs/【玩法创作】平台入口与玩法链路-2026-05-15.md b/docs/【玩法创作】平台入口与玩法链路-2026-05-15.md
index 226211b9..923e8756 100644
--- a/docs/【玩法创作】平台入口与玩法链路-2026-05-15.md
+++ b/docs/【玩法创作】平台入口与玩法链路-2026-05-15.md
@@ -90,7 +90,8 @@ RPG / 拼图等运行态存档仍以 `/api/profile/save-archives` 的后端列
- 支持画面描述生图、多参考图生图、上传或历史生成主图后 AI 重绘、上传或历史生成主图后不重绘；主链要求浏览器先经 `/api/assets/direct-upload-tickets` 直传 OSS 并确认 `asset_object`，创作 action 只提交 `referenceImageAssetObjectId(s)`，由后端校验 owner / bucket / kind / MIME / size 后签发 OSS 只读 URL 并下载为 VectorEngine `/v1/images/edits` 的 multipart `image` part。本地上传 Data URL 与历史 `/generated-*` 图片路径仅保留为旧草稿、旧入口或未迁移客户端的兼容输入；关闭 AI 重绘时，后端统一解析为首关或当前关卡正式图后再持久化，不调用第一段拼图首图生成。
- 草稿生成会先持久化 `generationStatus=generating` 的作品摘要，生成完成并回写关卡拼图画面、关卡画面参考图、UI spritesheet 和关卡背景图后再变为 `ready`；当前不自动生成背景音乐。生成页步骤推进必须跟随后端 session `progressPercent` 的真实里程碑：`88` 表示草稿编译完成并进入出图步骤，`94` 表示生成图已保存并进入 UI / 背景步骤，`96` 表示正式图与 UI 背景已确认并进入写入步骤，最终 action 成功或发布才进入完成态；每个步骤内部可以按实际等待时间使用假进度平滑推进，总进度按 `0-88`、`88-94`、`94-96`、`96-98` 的真实里程碑区间平滑推进。任一同步 action 回包到达时立即以真实完成/失败结果冻结进度。
- 作品架拼图草稿的“生成中”遮罩只表示初始草稿还没有可查看结果；只要作品摘要、首关封面或任一关卡候选图已经可用，后续 UI 背景重生成和追加关卡生图都必须作为结果页局部生成态处理，不能阻止打开草稿结果页。
-- 拼图草稿编译是长耗时 action，前端 action 请求默认等待 `1_800_000ms`（30 分钟）且不自动重试。每次 `gpt-image-2` 调用的预期用时按 90 秒计算，但 `生成拼图首图` 单独按 4 分钟展示；完整 AI 重绘路径为 `编译首关草稿` 8 秒、`生成关卡名称` 10 秒、`生成拼图首图` 4 分钟、`生成关卡画面` 90 秒、`生成UI与背景` 90 秒、`写入正式草稿` 10 秒，合计约 448 秒。上传图且关闭 AI 重绘时必须跳过 `生成拼图首图`，直接进入 `生成关卡画面` 和 `生成UI与背景`，合计约 208 秒。生成页恢复时必须使用进入生成页的当前时间作为原始 `startedAtMs`；失败/完成态用 `finishedAtMs` 冻结耗时。未收到对应后端里程碑前，后续步骤保持待处理；即使当前步骤预计时长耗尽，也只能让当前步骤内部进度停在 `98%` 内，不能自动完成当前步骤或跳到后续步骤。生成页每个步骤只展示标题和进度，不展示步骤详细描述。
+- 拼图草稿编译是长耗时 action，前端 action 请求默认等待 `1_800_000ms`（30 分钟）且不自动重试。每次图片生成调用的预期用时按 90 秒计算，但 `生成拼图首图` 单独按 4 分钟展示；完整 AI 重绘路径为 `编译首关草稿` 8 秒、`生成关卡名称` 10 秒、`生成拼图首图` 4 分钟、`生成关卡画面` 90 秒、`生成UI与背景` 90 秒、`写入正式草稿` 10 秒，合计约 448 秒。上传图且关闭 AI 重绘时必须跳过 `生成拼图首图`，直接进入 `生成关卡画面` 和 `生成UI与背景`，合计约 208 秒。生成页恢复时必须使用进入生成页的当前时间作为原始 `startedAtMs`；失败/完成态用 `finishedAtMs` 冻结耗时。未收到对应后端里程碑前，后续步骤保持待处理；即使当前步骤预计时长耗尽，也只能让当前步骤内部进度停在 `98%` 内，不能自动完成当前步骤或跳到后续步骤。生成页每个步骤只展示标题和进度，不展示步骤详细描述。
+- 前端创作、结果页、生成页和错误提示不展示 GPT / Gemini 等具体模型名称；如需在内部保留模型路由，UI 只使用“标准模式”“创意模式”等产品化名称。
- 若浏览器锁屏、息屏或网络切换导致 compile 请求失败，前端在标记失败前必须先复读 `getPuzzleAgentSession(sessionId)`；只有最新 session 仍缺 `draft.coverImageSrc`、首关 `coverImageSrc` 或候选图时才展示失败，复读到已生成草稿时按成功收尾、刷新作品架并继续自动试玩/结果页链路。
- 拼图参考图 AI 重绘走 VectorEngine `/v1/images/edits`；无参考图时走 `/v1/images/generations`。两者模型都使用 `gpt-image-2`，参考图由后端作为 multipart `image` part 传入编辑接口。
- 每次新建关卡生成或重新生成关卡图都必须由 `api-server` 串起当前关卡资产包：AI 重绘开启时第一段沿用草稿生成第一关的拼图主图提示词配置和模型 / 尺寸 / 参考图规则生成 `coverImageSrc/coverAssetId` 作为关卡拼图画面和结果页预览图，提示词来源同样按显式画面描述、关卡画面描述、草稿摘要顺序回退，且固定要求输出画面比例为 `1:1`；上传图且关闭 AI 重绘时跳过这一段，把上传图或历史图持久化为 `sourceType=uploaded` 的正式候选。随后用正式候选图作为参考，`9:16` 生成完整拼图游戏关卡画面并写入 `levelSceneImageSrc/levelSceneImageObjectKey`，提示词必须要求道具按钮上不要显示次数标注，且返回按钮和设置按钮旁禁止标注文字；UI spritesheet 与关卡纯背景在关卡画面完成后并发生成，spritesheet 用 `1:1`、`1k` 先生成纯绿色绿幕背景图，后端上传 OSS 前必须把绿幕扣成透明 PNG，再写入 `uiSpritesheetImageSrc/uiSpritesheetImageObjectKey`，按钮顺序固定为返回、设置、下一关、提示、原图、冻结，按钮素材自身保留对应中文文字，返回和设置按钮不得额外生成白色外圈、白底圆环或浮雕外框；纯背景用 `9:16`、`1k` 写入 `levelBackgroundImageSrc/levelBackgroundImageObjectKey`，提示词必须包含“禁止在背景中出现人像或和拼图画面中主体一致的内容”。运行态不直接使用第二段完整关卡画面，但必须持久化它用于追踪和后续再生成。结果页局部关卡生成进度按 AI 重绘开启约 270 秒、关闭 AI 重绘约 180 秒展示。
diff --git a/src/components/edutainment-result/BabyObjectMatchResultView.test.tsx b/src/components/edutainment-result/BabyObjectMatchResultView.test.tsx
index cef47414..e5a37ba0 100644
--- a/src/components/edutainment-result/BabyObjectMatchResultView.test.tsx
+++ b/src/components/edutainment-result/BabyObjectMatchResultView.test.tsx
@@ -174,7 +174,7 @@ test('baby object result blocks placeholder assets and exposes regeneration', as
);
expect(
- screen.getByText('当前作品仍是占位资源，请重新生成 image-2 资源后再试玩或发布。'),
+ screen.getByText('当前作品仍是占位资源，请重新生成素材后再试玩或发布。'),
).toBeTruthy();
expect(
(screen.getByRole('button', { name: '试玩' }) as HTMLButtonElement)
diff --git a/src/components/edutainment-result/BabyObjectMatchResultView.tsx b/src/components/edutainment-result/BabyObjectMatchResultView.tsx
index 5c3e8bd0..cec5e306 100644
--- a/src/components/edutainment-result/BabyObjectMatchResultView.tsx
+++ b/src/components/edutainment-result/BabyObjectMatchResultView.tsx
@@ -158,7 +158,7 @@ export function BabyObjectMatchResultView({
{!hasGeneratedAssets ? (
- 当前作品仍是占位资源，请重新生成 image-2 资源后再试玩或发布。
+ 当前作品仍是占位资源，请重新生成素材后再试玩或发布。
) : null}
diff --git a/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx b/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
index 01a81b32..6720e92c 100644
--- a/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
+++ b/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
@@ -7441,7 +7441,7 @@ export function PlatformEntryFlowShellImpl({
setBabyObjectMatchError(
resolvePuzzleErrorMessage(
error,
- '重新生成宝贝识物 image-2 资源失败。',
+ '重新生成宝贝识物素材失败。',
),
);
} finally {
@@ -7474,7 +7474,7 @@ export function PlatformEntryFlowShellImpl({
setBabyObjectMatchError(
resolvePuzzleErrorMessage(
error,
- '生成宝贝识物 image-2 资源失败，请重试后再发布。',
+ '生成宝贝识物素材失败，请重试后再发布。',
),
);
} finally {
@@ -7525,7 +7525,7 @@ export function PlatformEntryFlowShellImpl({
} catch (error) {
const message = resolvePuzzleErrorMessage(
error,
- '生成宝贝识物 image-2 资源失败，请重试后再试玩。',
+ '生成宝贝识物素材失败，请重试后再试玩。',
);
setBabyObjectMatchError(message);
if (options.embedded) {
diff --git a/src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx b/src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx
index 3785425c..cd58b666 100644
--- a/src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx
+++ b/src/components/puzzle-agent/PuzzleAgentWorkspace.interaction.test.tsx
@@ -411,7 +411,7 @@ test('puzzle workspace falls back to compile action for restored sessions', () =
});
});
-test('puzzle workspace switches the image model from the description box', () => {
+test('puzzle workspace switches image mode without exposing model names', () => {
const onCreateFromForm = vi.fn();
render(
@@ -427,9 +427,9 @@ test('puzzle workspace switches the image model from the description box', () =>
fireEvent.change(screen.getByLabelText('画面描述'), {
target: { value: '一只猫在雨夜灯牌下回头。' },
});
- fireEvent.click(screen.getByRole('button', { name: '图片模型' }));
- expect(screen.queryByRole('menuitemradio', { name: '原模型' })).toBeNull();
- fireEvent.click(screen.getByRole('menuitemradio', { name: 'nanobanana2' }));
+ fireEvent.click(screen.getByRole('button', { name: '图片生成模式' }));
+ expect(screen.queryByText(/gpt|nanobanana|gemini/u)).toBeNull();
+ fireEvent.click(screen.getByRole('menuitemradio', { name: '创意模式' }));
fireEvent.click(screen.getByRole('button', { name: /生成拼图游戏草稿/u }));
confirmPuzzlePointCost();
diff --git a/src/components/puzzle-agent/PuzzleImageModelPicker.tsx b/src/components/puzzle-agent/PuzzleImageModelPicker.tsx
index c8cb4e31..3cefe328 100644
--- a/src/components/puzzle-agent/PuzzleImageModelPicker.tsx
+++ b/src/components/puzzle-agent/PuzzleImageModelPicker.tsx
@@ -45,8 +45,8 @@ export function PuzzleImageModelPicker({
className={`inline-flex min-h-8 max-w-[10rem] items-center rounded-full border border-[var(--platform-subpanel-border)] bg-white/96 px-3 text-[11px] font-bold text-[var(--platform-text-strong)] shadow-sm transition hover:bg-[var(--platform-subpanel-fill)] ${disabled ? 'cursor-not-allowed opacity-55' : ''}`}
aria-haspopup="menu"
aria-expanded={isOpen}
- aria-label="图片模型"
- title="图片模型"
+ aria-label="图片生成模式"
+ title="图片生成模式"
>
{getPuzzleImageModelLabel(normalizedValue)}
diff --git a/src/components/puzzle-agent/puzzleImageModelOptions.ts b/src/components/puzzle-agent/puzzleImageModelOptions.ts
index 12498083..147685f1 100644
--- a/src/components/puzzle-agent/puzzleImageModelOptions.ts
+++ b/src/components/puzzle-agent/puzzleImageModelOptions.ts
@@ -9,8 +9,8 @@ export const PUZZLE_IMAGE_MODEL_OPTIONS: Array<{
id: PuzzleImageModelId;
label: string;
}> = [
- { id: PUZZLE_IMAGE_MODEL_GPT_IMAGE_2, label: 'gpt-image-2' },
- { id: PUZZLE_IMAGE_MODEL_NANOBANANA2, label: 'nanobanana2' },
+ { id: PUZZLE_IMAGE_MODEL_GPT_IMAGE_2, label: '标准模式' },
+ { id: PUZZLE_IMAGE_MODEL_NANOBANANA2, label: '创意模式' },
];
export function normalizePuzzleImageModel(
@@ -25,6 +25,6 @@ export function normalizePuzzleImageModel(
export function getPuzzleImageModelLabel(model: PuzzleImageModelId) {
return (
PUZZLE_IMAGE_MODEL_OPTIONS.find((option) => option.id === model)?.label ??
- 'gpt-image-2'
+ '标准模式'
);
}
diff --git a/src/components/puzzle-result/PuzzleResultView.test.tsx b/src/components/puzzle-result/PuzzleResultView.test.tsx
index 8bd79844..018ce784 100644
--- a/src/components/puzzle-result/PuzzleResultView.test.tsx
+++ b/src/components/puzzle-result/PuzzleResultView.test.tsx
@@ -1305,7 +1305,7 @@ describe('PuzzleResultView', () => {
expect(screen.queryByPlaceholderText('参考图链接或资产ID')).toBeNull();
});
- test('passes the selected image model when regenerating a level image', () => {
+ test('passes the selected image mode without exposing model names', () => {
const onExecuteAction = vi.fn();
render(
@@ -1319,9 +1319,12 @@ describe('PuzzleResultView', () => {
openPuzzleLevelsTab();
fireEvent.click(screen.getByText('雨夜猫街'));
const dialog = screen.getByRole('dialog', { name: '关卡详情' });
- fireEvent.click(within(dialog).getByRole('button', { name: '图片模型' }));
fireEvent.click(
- within(dialog).getByRole('menuitemradio', { name: 'gpt-image-2' }),
+ within(dialog).getByRole('button', { name: '图片生成模式' }),
+ );
+ expect(within(dialog).queryByText(/gpt|nanobanana|gemini/u)).toBeNull();
+ fireEvent.click(
+ within(dialog).getByRole('menuitemradio', { name: '标准模式' }),
);
fireEvent.click(
within(dialog).getByRole('button', { name: /重新生成画面/u }),
diff --git a/src/services/edutainment-baby-object/babyObjectMatchClient.ts b/src/services/edutainment-baby-object/babyObjectMatchClient.ts
index d74623e7..27fccefe 100644
--- a/src/services/edutainment-baby-object/babyObjectMatchClient.ts
+++ b/src/services/edutainment-baby-object/babyObjectMatchClient.ts
@@ -279,7 +279,7 @@ async function generateBabyObjectMatchAssets(
const assets = normalizeGeneratedAssets(response.assets, itemNames);
const visualPackage = normalizeGeneratedVisualPackage(response.visualPackage);
if (!assets || !visualPackage) {
- throw new Error('宝贝识物 image-2 资源生成结果不完整，请重试。');
+ throw new Error('宝贝识物素材生成结果不完整，请重试。');
}
return { assets, visualPackage };
diff --git a/src/services/miniGameDraftGenerationProgress.test.ts b/src/services/miniGameDraftGenerationProgress.test.ts
index 7344963f..e1aeb76a 100644
--- a/src/services/miniGameDraftGenerationProgress.test.ts
+++ b/src/services/miniGameDraftGenerationProgress.test.ts
@@ -37,7 +37,7 @@ describe('miniGameDraftGenerationProgress', () => {
'建立可恢复草稿，整理首关描述与关卡结构，约 8 秒。',
);
expect(progress?.steps[2]?.detail).toBe(
- '调用 gpt-image-2 生成 1:1 拼图首图，预计 4 分钟。',
+ '生成 1:1 拼图首图，预计 4 分钟。',
);
expect(progress?.estimatedRemainingMs).toBe(446_500);
expect(progress?.overallProgress).toBe(0);
diff --git a/src/services/miniGameDraftGenerationProgress.ts b/src/services/miniGameDraftGenerationProgress.ts
index 08bab687..58232ee9 100644
--- a/src/services/miniGameDraftGenerationProgress.ts
+++ b/src/services/miniGameDraftGenerationProgress.ts
@@ -167,7 +167,7 @@ function buildPuzzleTimedSteps(state: MiniGameDraftGenerationState) {
steps.push({
id: 'puzzle-cover-image',
label: '生成拼图首图',
- detail: '调用 gpt-image-2 生成 1:1 拼图首图，预计 4 分钟。',
+ detail: '生成 1:1 拼图首图，预计 4 分钟。',
durationMs: PUZZLE_COVER_IMAGE_GENERATION_EXPECTED_MS,
});
}
@@ -177,15 +177,15 @@ function buildPuzzleTimedSteps(state: MiniGameDraftGenerationState) {
id: 'puzzle-level-scene',
label: '生成关卡画面',
detail: shouldSkipPuzzleCoverGeneration(state)
- ? '直接使用上传图作为参考，调用 gpt-image-2 生成 9:16 完整关卡画面，预计 90 秒。'
- : '使用拼图首图作为参考，调用 gpt-image-2 生成 9:16 完整关卡画面，预计 90 秒。',
+ ? '直接使用上传图作为参考，生成 9:16 完整关卡画面，预计 90 秒。'
+ : '使用拼图首图作为参考，生成 9:16 完整关卡画面，预计 90 秒。',
durationMs: PUZZLE_IMAGE_GENERATION_EXPECTED_MS,
},
{
id: 'puzzle-ui-assets',
label: '生成UI与背景',
detail:
- '用关卡画面作参考，并发生成 UI spritesheet 与 9:16 纯背景；两次 gpt-image-2 并发，预计 90 秒。',
+ '用关卡画面作参考，并发生成 UI spritesheet 与 9:16 纯背景，预计 90 秒。',
durationMs: PUZZLE_IMAGE_GENERATION_EXPECTED_MS,
},
{
@@ -305,7 +305,7 @@ const MATCH3D_STEPS = [
{
id: 'match3d-level-scene',
label: '生成关卡整图',
- detail: '调用 gpt-image-2 生成 9:16 完整抓大鹅关卡画面。',
+ detail: '生成 9:16 完整抓大鹅关卡画面。',
weight: 28,
},
{