1

2026-04-25 22:38:03 +08:00
parent 8404081d7b 7d6963980f
commit f68f4914ec
29 changed files with 1988 additions and 121 deletions
--- a/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
+++ b/src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
@@ -1,4 +1,5 @@
-import { AnimatePresence, motion } from 'motion/react';
+import { Loader2 } from 'lucide-react';
+import { AnimatePresence, motion } from 'motion/react';
 import {
  lazy,
  Suspense,
@@ -9,6 +10,7 @@ import {
  useState,
 } from 'react';

+import type { PublicUserSummary } from '../../../packages/shared/src/contracts/auth';
 import type {
  BigFishRuntimeSnapshotResponse,
  BigFishSessionSnapshotResponse,
@@ -31,7 +33,6 @@ import type {
  CustomWorldGalleryCard,
  CustomWorldLibraryEntry,
 } from '../../../packages/shared/src/contracts/runtime';
-import type { PublicUserSummary } from '../../../packages/shared/src/contracts/auth';
 import { buildCustomWorldPlayableCharacters } from '../../data/characterPresets';
 import {
  getPublicAuthUserByCode,
@@ -43,15 +44,22 @@ import {
  getBigFishCreationSession,
  streamBigFishCreationMessage,
 } from '../../services/big-fish-creation';
-import {
-  deleteBigFishWork,
-  listBigFishWorks,
-} from '../../services/big-fish-works';
 import {
  startBigFishRuntimeRun,
  submitBigFishRuntimeInput,
 } from '../../services/big-fish-runtime';
+import {
+  deleteBigFishWork,
+  listBigFishWorks,
+} from '../../services/big-fish-works';
 import { readCustomWorldAgentUiState } from '../../services/customWorldAgentUiState';
+import {
+  buildBigFishGenerationAnchorEntries,
+  buildMiniGameDraftGenerationProgress,
+  buildPuzzleGenerationAnchorEntries,
+  createMiniGameDraftGenerationState,
+  type MiniGameDraftGenerationState,
+} from '../../services/miniGameDraftGenerationProgress';
 import { getPlatformProfileDashboard } from '../../services/platform-entry';
 import {
  createPuzzleAgentSession,
@@ -60,17 +68,17 @@ import {
  streamPuzzleAgentMessage,
 } from '../../services/puzzle-agent';
 import { getPuzzleGalleryDetail, listPuzzleGallery } from '../../services/puzzle-gallery';
+import { advanceLocalPuzzleNextLevel } from '../../services/puzzle-runtime';
 import {
-  advanceLocalPuzzleLevel,
  dragLocalPuzzlePiece,
  startLocalPuzzleRun,
  swapLocalPuzzlePieces,
 } from '../../services/puzzle-runtime/puzzleLocalRuntime';
 import { deletePuzzleWork, listPuzzleWorks } from '../../services/puzzle-works';
-import { deleteRpgEntryWorldProfile } from '../../services/rpg-entry';
-import { getRpgEntryWorldGalleryDetailByCode } from '../../services/rpg-entry/rpgEntryLibraryClient';
 import { deleteRpgCreationAgentSession } from '../../services/rpg-creation';
 import { rpgCreationPreviewAdapter } from '../../services/rpg-creation/rpgCreationPreviewAdapter';
+import { deleteRpgEntryWorldProfile } from '../../services/rpg-entry';
+import { getRpgEntryWorldGalleryDetailByCode } from '../../services/rpg-entry/rpgEntryLibraryClient';
 import type { CustomWorldProfile } from '../../types';
 import { useAuthUi } from '../auth/AuthUiContext';
 import { CustomWorldCreationHub } from '../custom-world-home/CustomWorldCreationHub';
@@ -88,13 +96,13 @@ import {
  type PlatformPublicGalleryCard,
 } from '../rpg-entry/rpgEntryWorldPresentation';
 import { PlatformEntryCreationTypeModal } from './PlatformEntryCreationTypeModal';
+import type { PlatformCreationTypeId } from './platformEntryCreationTypes';
 import { PlatformEntryHomeView } from './PlatformEntryHomeView';
 import {
  buildCreationHubFallbackItems,
  normalizeAgentBackedProfile,
  resolveRpgCreationErrorMessage,
 } from './platformEntryShared';
-import type { PlatformCreationTypeId } from './platformEntryCreationTypes';
 import type { PlatformEntryFlowShellProps } from './platformEntryTypes';
 import { PlatformEntryWorldDetailView } from './PlatformEntryWorldDetailView';
 import { usePlatformEntryBootstrap } from './usePlatformEntryBootstrap';
@@ -341,6 +349,8 @@ export function PlatformEntryFlowShellImpl({
  const [bigFishRun, setBigFishRun] =
    useState<BigFishRuntimeSnapshotResponse | null>(null);
  const [isBigFishLoadingLibrary, setIsBigFishLoadingLibrary] = useState(false);
+  const [bigFishGenerationState, setBigFishGenerationState] =
+    useState<MiniGameDraftGenerationState | null>(null);
  const bigFishInputInFlightRef = useRef(false);
  const [puzzleOperation, setPuzzleOperation] =
    useState<PuzzleAgentOperationRecord | null>(null);
@@ -352,6 +362,10 @@ export function PlatformEntryFlowShellImpl({
    useState<PuzzleWorkSummary | null>(null);
  const [puzzleRun, setPuzzleRun] = useState<PuzzleRunSnapshot | null>(null);
  const [isPuzzleLoadingLibrary, setIsPuzzleLoadingLibrary] = useState(false);
+  const [puzzleGenerationState, setPuzzleGenerationState] =
+    useState<MiniGameDraftGenerationState | null>(null);
+  const [isPuzzleNextLevelGenerating, setIsPuzzleNextLevelGenerating] =
+    useState(false);
  const [isSearchingPublicCode, setIsSearchingPublicCode] = useState(false);
  const [publicSearchError, setPublicSearchError] = useState<string | null>(null);
  const [searchedPublicUser, setSearchedPublicUser] =
@@ -773,8 +787,44 @@ export function PlatformEntryFlowShellImpl({
    onSessionOpened: () => {
      setShowCreationTypeModal(false);
    },
-    onActionComplete: ({ response, setSession }) => {
+    onActionComplete: ({ payload, response, setSession }) => {
      setSession(response.session);
+      if (payload.action !== 'big_fish_compile_draft') {
+        return;
+      }
+      setBigFishGenerationState((current) =>
+        current
+          ? {
+              ...current,
+              phase: 'ready',
+              completedAssetCount: response.session.assetSlots.filter(
+                (slot) => slot.status === 'ready',
+              ).length,
+              totalAssetCount: response.session.assetSlots.length,
+            }
+          : current,
+      );
+    },
+    beforeExecuteAction: ({ payload }) => {
+      if (payload.action !== 'big_fish_compile_draft') {
+        return;
+      }
+      setSelectionStage('big-fish-generating');
+      setBigFishGenerationState(createMiniGameDraftGenerationState('big-fish'));
+    },
+    onActionError: ({ payload, errorMessage }) => {
+      if (payload.action !== 'big_fish_compile_draft') {
+        return;
+      }
+      setBigFishGenerationState((current) =>
+        current
+          ? {
+              ...current,
+              phase: 'failed',
+              error: errorMessage,
+            }
+          : current,
+      );
    },
  });

@@ -784,7 +834,7 @@ export function PlatformEntryFlowShellImpl({
    { session: PuzzleAgentSessionSnapshot },
    SendPuzzleAgentMessageRequest,
    PuzzleAgentActionRequest,
-    { operation: PuzzleAgentOperationRecord }
+    { operation: PuzzleAgentOperationRecord; session: PuzzleAgentSessionSnapshot }
  >({
    client: {
      createSession: createPuzzleAgentSession,
@@ -811,8 +861,9 @@ export function PlatformEntryFlowShellImpl({
    onSessionOpened: () => {
      setShowCreationTypeModal(false);
    },
-    onActionComplete: async ({ payload, response, session, setSession }) => {
+    onActionComplete: async ({ payload, response, setSession }) => {
      setPuzzleOperation(response.operation);
+      setSession(response.session);

      if (payload.action === 'publish_puzzle_work') {
        await Promise.allSettled([
@@ -821,21 +872,51 @@ export function PlatformEntryFlowShellImpl({
        ]);
      }

-      const latestResponse = await getPuzzleAgentSession(session.sessionId);
-      const latestSession = latestResponse.session;
-      setSession(latestSession);
+      if (payload.action === 'compile_puzzle_draft') {
+        setPuzzleGenerationState((current) =>
+          current
+            ? {
+                ...current,
+                phase: 'ready',
+                completedAssetCount: 1,
+                totalAssetCount: 1,
+              }
+            : current,
+        );
+      }

      if (
        payload.action === 'publish_puzzle_work' &&
-        latestSession.publishedProfileId
+        response.session.publishedProfileId
      ) {
        const galleryDetail = await getPuzzleGalleryDetail(
-          latestSession.publishedProfileId,
+          response.session.publishedProfileId,
        );
        setSelectedPuzzleDetail(galleryDetail.item);
        setSelectionStage('puzzle-gallery-detail');
      }
    },
+    beforeExecuteAction: ({ payload }) => {
+      if (payload.action !== 'compile_puzzle_draft') {
+        return;
+      }
+      setSelectionStage('puzzle-generating');
+      setPuzzleGenerationState(createMiniGameDraftGenerationState('puzzle'));
+    },
+    onActionError: ({ payload, errorMessage }) => {
+      if (payload.action !== 'compile_puzzle_draft') {
+        return;
+      }
+      setPuzzleGenerationState((current) =>
+        current
+          ? {
+              ...current,
+              phase: 'failed',
+              error: errorMessage,
+            }
+          : current,
+      );
+    },
  });

  const bigFishSession = bigFishFlow.session;
@@ -906,12 +987,15 @@ export function PlatformEntryFlowShellImpl({

  const leaveBigFishFlow = useCallback(() => {
    setBigFishRun(null);
+    setBigFishGenerationState(null);
    bigFishFlow.leaveFlow();
  }, [bigFishFlow]);

  const leavePuzzleFlow = useCallback(() => {
    setPuzzleOperation(null);
    setPuzzleRun(null);
+    setPuzzleGenerationState(null);
+    setIsPuzzleNextLevelGenerating(false);
    puzzleFlow.leaveFlow();
  }, [puzzleFlow]);

@@ -1039,9 +1123,35 @@ export function PlatformEntryFlowShellImpl({
      return;
    }

+    const currentLevel = puzzleRun.currentLevel;
+    if (!currentLevel || currentLevel.status !== 'cleared') {
+      return;
+    }
+
+    setIsPuzzleBusy(true);
+    setIsPuzzleNextLevelGenerating(true);
    setPuzzleError(null);
-    setPuzzleRun(advanceLocalPuzzleLevel(puzzleRun));
-  }, [isPuzzleBusy, puzzleRun]);
+
+    try {
+      const { run } = await advanceLocalPuzzleNextLevel({
+        run: puzzleRun,
+        sourceSessionId:
+          selectedPuzzleDetail?.sourceSessionId ?? puzzleSession?.sessionId ?? null,
+      });
+      setPuzzleRun(run);
+    } catch (error) {
+      setPuzzleError(resolvePuzzleErrorMessage(error, '准备下一关失败。'));
+    } finally {
+      setIsPuzzleNextLevelGenerating(false);
+      setIsPuzzleBusy(false);
+    }
+  }, [
+    isPuzzleBusy,
+    puzzleRun,
+    puzzleSession,
+    resolvePuzzleErrorMessage,
+    selectedPuzzleDetail,
+  ]);

  const leaveAgentWorkspace = useCallback(() => {
    enterCreateTab();
@@ -1713,6 +1823,49 @@ export function PlatformEntryFlowShellImpl({
          </motion.div>
        )}

+        {selectionStage === 'big-fish-generating' && (
+          <motion.div
+            key="big-fish-generating"
+            initial={{ opacity: 0, y: 12 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0, y: -12 }}
+            className="flex h-full min-h-0 flex-col"
+          >
+            <Suspense
+              fallback={<LazyPanelFallback label="正在加载大鱼吃小鱼生成面板..." />}
+            >
+              <CustomWorldGenerationView
+                settingText={
+                  bigFishSession?.lastAssistantReply ?? '正在整理当前玩法草稿。'
+                }
+                anchorEntries={buildBigFishGenerationAnchorEntries(bigFishSession)}
+                progress={buildMiniGameDraftGenerationProgress(
+                  bigFishGenerationState,
+                )}
+                isGenerating={isBigFishBusy}
+                error={bigFishError}
+                onBack={leaveBigFishFlow}
+                onEditSetting={() => {
+                  setSelectionStage('big-fish-agent-workspace');
+                }}
+                onRetry={() => {
+                  void executeBigFishAction({ action: 'big_fish_compile_draft' });
+                }}
+                onInterrupt={undefined}
+                backLabel="返回创作中心"
+                settingActionLabel={null}
+                retryLabel="重新生成草稿"
+                settingTitle="当前玩法信息"
+                settingDescription={null}
+                progressTitle="大鱼吃小鱼草稿生成进度"
+                activeBadgeLabel="草稿生成中"
+                pausedBadgeLabel="草稿生成已暂停"
+                idleBadgeLabel="等待返回工作区"
+              />
+            </Suspense>
+          </motion.div>
+        )}
+
        {selectionStage === 'big-fish-result' && bigFishSession?.draft && (
          <motion.div
            key="big-fish-result"
@@ -1796,6 +1949,49 @@ export function PlatformEntryFlowShellImpl({
          </motion.div>
        )}

+        {selectionStage === 'puzzle-generating' && (
+          <motion.div
+            key="puzzle-generating"
+            initial={{ opacity: 0, y: 12 }}
+            animate={{ opacity: 1, y: 0 }}
+            exit={{ opacity: 0, y: -12 }}
+            className="flex h-full min-h-0 flex-col"
+          >
+            <Suspense
+              fallback={<LazyPanelFallback label="正在加载拼图生成面板..." />}
+            >
+              <CustomWorldGenerationView
+                settingText={
+                  puzzleSession?.lastAssistantReply ?? '正在整理当前拼图草稿。'
+                }
+                anchorEntries={buildPuzzleGenerationAnchorEntries(puzzleSession)}
+                progress={buildMiniGameDraftGenerationProgress(
+                  puzzleGenerationState,
+                )}
+                isGenerating={isPuzzleBusy}
+                error={puzzleError}
+                onBack={leavePuzzleFlow}
+                onEditSetting={() => {
+                  setSelectionStage('puzzle-agent-workspace');
+                }}
+                onRetry={() => {
+                  void executePuzzleAction({ action: 'compile_puzzle_draft' });
+                }}
+                onInterrupt={undefined}
+                backLabel="返回创作中心"
+                settingActionLabel={null}
+                retryLabel="重新生成草稿"
+                settingTitle="当前拼图信息"
+                settingDescription={null}
+                progressTitle="拼图草稿生成进度"
+                activeBadgeLabel="草稿生成中"
+                pausedBadgeLabel="草稿生成已暂停"
+                idleBadgeLabel="等待返回工作区"
+              />
+            </Suspense>
+          </motion.div>
+        )}
+
        {selectionStage === 'puzzle-result' && puzzleSession?.draft && (
          <motion.div
            key="puzzle-result"
@@ -1852,7 +2048,7 @@ export function PlatformEntryFlowShellImpl({
          >
            <PuzzleRuntimeShell
              run={puzzleRun}
-              isBusy={isPuzzleBusy}
+              isBusy={isPuzzleBusy || isPuzzleNextLevelGenerating}
              error={puzzleError}
              onBack={() => {
                setSelectionStage('puzzle-gallery-detail');
@@ -1867,6 +2063,17 @@ export function PlatformEntryFlowShellImpl({
                void advancePuzzleLevel();
              }}
            />
+            {isPuzzleNextLevelGenerating ? (
+              <div className="fixed inset-0 z-[120] flex items-center justify-center bg-slate-950/62 px-5 backdrop-blur-sm">
+                <div className="flex max-w-[18rem] flex-col items-center gap-3 rounded-[1.5rem] border border-white/12 bg-slate-950/92 px-6 py-5 text-center text-white shadow-[0_28px_80px_rgba(0,0,0,0.35)]">
+                  <Loader2 className="h-6 w-6 animate-spin text-amber-200" />
+                  <div className="text-sm font-bold">正在准备下一关</div>
+                  <div className="text-xs leading-5 text-white/68">
+                    广场暂无可接续作品，正在生成新的候选图。
+                  </div>
+                </div>
+              </div>
+            ) : null}
          </motion.div>
        )}

--- a/src/components/platform-entry/platformEntryTypes.ts
+++ b/src/components/platform-entry/platformEntryTypes.ts
@@ -9,9 +9,11 @@ export type SelectionStage =
  | 'detail'
  | 'agent-workspace'
  | 'big-fish-agent-workspace'
+  | 'big-fish-generating'
  | 'big-fish-result'
  | 'big-fish-runtime'
  | 'puzzle-agent-workspace'
+  | 'puzzle-generating'
  | 'puzzle-result'
  | 'puzzle-gallery-detail'
  | 'puzzle-runtime'
--- a/src/components/platform-entry/usePlatformCreationAgentFlowController.ts
+++ b/src/components/platform-entry/usePlatformCreationAgentFlowController.ts
@@ -81,6 +81,15 @@ type PlatformCreationAgentFlowControllerOptions<
    session: TSession;
    setSession: (session: TSession) => void;
  }) => Promise<void> | void;
+  beforeExecuteAction?: (params: {
+    payload: TActionPayload;
+    session: TSession;
+  }) => void;
+  onActionError?: (params: {
+    payload: TActionPayload;
+    error: unknown;
+    errorMessage: string;
+  }) => void;
 };

 function buildOptimisticMessage<TMessagePayload extends CreationAgentMessageLike>(
@@ -235,6 +244,7 @@ export function usePlatformCreationAgentFlowController<
      setError(null);

      try {
+        options.beforeExecuteAction?.({ payload, session });
        const response = await options.client.executeAction(
          session.sessionId,
          payload,
@@ -249,9 +259,16 @@ export function usePlatformCreationAgentFlowController<
          options.setSelectionStage(options.resultStage);
        }
      } catch (caughtError) {
-        setError(
-          options.resolveErrorMessage(caughtError, options.errorMessages.execute),
+        const errorMessage = options.resolveErrorMessage(
+          caughtError,
+          options.errorMessages.execute,
        );
+        setError(errorMessage);
+        options.onActionError?.({
+          payload,
+          error: caughtError,
+          errorMessage,
+        });
      } finally {
        setIsBusy(false);
      }
--- a/src/components/rpg-creation-editor/RpgCreationEntityEditorShared.tsx
+++ b/src/components/rpg-creation-editor/RpgCreationEntityEditorShared.tsx
@@ -361,12 +361,14 @@ function buildDefaultSceneActBlueprint(params: {
    primaryNpcId: encounterNpcIds[0] ?? '',
    linkedThreadIds: dedupeTextValues(params.linkedThreadIds ?? []),
    advanceRule: buildSceneActAdvanceRule(params.index, params.actCount),
+    oppositeNpcId: '',
    actGoal:
      params.index === 0
        ? `先在${sceneLabel}接住当前局面`
        : params.index >= params.actCount - 1
          ? `把${sceneLabel}这一章收束并抛出下一步`
          : `继续推进${sceneLabel}的核心矛盾`,
+    eventDescription: sceneSummary,
    transitionHook:
      params.index === 0
        ? '和主角色完成首次有效接触后，局势会继续加压。'
@@ -396,6 +398,7 @@ function buildDefaultSceneChapterBlueprint(params: {
    sceneId: params.landmark.id,
    title: params.chapterTitle?.trim() || params.landmark.name.trim() || '场景章节',
    summary: params.chapterSummary?.trim() || params.landmark.description.trim(),
+    sceneTaskDescription: params.landmark.description.trim(),
    linkedThreadIds: dedupeTextValues(params.linkedThreadIds ?? []),
    linkedLandmarkIds: dedupeTextValues([
      params.landmark.id,
--- a/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx
+++ b/src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx
@@ -99,12 +99,13 @@ function renderProfileView(onRechargeSuccess = vi.fn()) {
      value={{
        user: {
          id: 'user-1',
+          publicUserCode: '100001',
          username: 'tester',
          displayName: '测试玩家',
+          phoneNumberMasked: null,
          loginMethod: 'password',
          bindingStatus: 'active',
-          phone: null,
-          createdAt: null,
+          wechatBound: false,
        },
        canAccessProtectedData: true,
        openLoginModal: vi.fn(),
--- a/src/services/customWorldCover.test.ts
+++ b/src/services/customWorldCover.test.ts
@@ -79,6 +79,7 @@ function createBaseProfile(): CustomWorldProfile {
        sceneId: 'landmark-1',
        title: '潮汐码头',
        summary: '第一章开局场景。',
+        sceneTaskDescription: '追查潮汐码头失踪案的第一条线索。',
        linkedThreadIds: [],
        linkedLandmarkIds: ['landmark-1'],
        acts: [
@@ -92,6 +93,8 @@ function createBaseProfile(): CustomWorldProfile {
            backgroundAssetId: 'asset-scene-act-1',
            encounterNpcIds: [],
            primaryNpcId: 'playable-1',
+            oppositeNpcId: 'playable-1',
+            eventDescription: '玩家第一次进入港口，发现涨潮后的异常痕迹。',
            linkedThreadIds: [],
            advanceRule: 'after_primary_contact',
            actGoal: '拿到第一句真话。',
--- a/src/services/miniGameDraftGenerationProgress.ts
+++ b/src/services/miniGameDraftGenerationProgress.ts
@@ -0,0 +1,283 @@
+import type { BigFishSessionSnapshotResponse } from '../../packages/shared/src/contracts/bigFish';
+import type { PuzzleAgentSessionSnapshot } from '../../packages/shared/src/contracts/puzzleAgentSession';
+import type {
+  CustomWorldGenerationProgress,
+  CustomWorldGenerationStep,
+} from '../../packages/shared/src/contracts/runtime';
+import type { CustomWorldStructuredAnchorEntry } from './customWorldAgentGenerationProgress';
+
+export type MiniGameDraftGenerationKind = 'puzzle' | 'big-fish';
+
+export type MiniGameDraftGenerationPhase =
+  | 'idle'
+  | 'compile'
+  | 'puzzle-images'
+  | 'puzzle-select-image'
+  | 'big-fish-main-images'
+  | 'big-fish-motions'
+  | 'big-fish-background'
+  | 'ready'
+  | 'failed';
+
+export type MiniGameDraftGenerationState = {
+  kind: MiniGameDraftGenerationKind;
+  phase: MiniGameDraftGenerationPhase;
+  startedAtMs: number;
+  completedAssetCount: number;
+  totalAssetCount: number;
+  error: string | null;
+};
+
+type MiniGameStepDefinition = {
+  id: MiniGameDraftGenerationPhase;
+  label: string;
+  detail: string;
+  weight: number;
+};
+
+type MiniGameAnchorSource = {
+  key: string;
+  label: string;
+  value: string;
+};
+
+const PUZZLE_STEPS = [
+  {
+    id: 'compile',
+    label: '编译拼图草稿',
+    detail: '整理主题、主体、构图与标签。',
+    weight: 34,
+  },
+  {
+    id: 'puzzle-images',
+    label: '生成拼图图片',
+    detail: '根据草稿生成候选图。',
+    weight: 33,
+  },
+  {
+    id: 'puzzle-select-image',
+    label: '确认正式图片',
+    detail: '选择候选图写入结果页。',
+    weight: 33,
+  },
+] as const satisfies ReadonlyArray<MiniGameStepDefinition>;
+
+const BIG_FISH_STEPS = [
+  {
+    id: 'compile',
+    label: '编译玩法草稿',
+    detail: '生成关卡角色描述、生态背景与运行参数。',
+    weight: 25,
+  },
+  {
+    id: 'big-fish-main-images',
+    label: '生成角色图片',
+    detail: '为每个成长阶段生成主形象。',
+    weight: 30,
+  },
+  {
+    id: 'big-fish-motions',
+    label: '生成动作素材',
+    detail: '补齐漂浮与游动动作素材。',
+    weight: 30,
+  },
+  {
+    id: 'big-fish-background',
+    label: '生成场地背景',
+    detail: '生成玩法场地背景图。',
+    weight: 15,
+  },
+] as const satisfies ReadonlyArray<MiniGameStepDefinition>;
+
+function clampProgress(value: number) {
+  return Math.max(0, Math.min(100, Math.round(value)));
+}
+
+function getStepDefinitions(kind: MiniGameDraftGenerationKind) {
+  return kind === 'puzzle' ? PUZZLE_STEPS : BIG_FISH_STEPS;
+}
+
+function getActiveStepIndex(
+  steps: ReadonlyArray<MiniGameStepDefinition>,
+  phase: MiniGameDraftGenerationPhase,
+) {
+  if (phase === 'ready') {
+    return steps.length - 1;
+  }
+  const index = steps.findIndex((step) => step.id === phase);
+  return index >= 0 ? index : 0;
+}
+
+function buildMiniGameProgressSteps(
+  steps: ReadonlyArray<MiniGameStepDefinition>,
+  activeStepIndex: number,
+  state: MiniGameDraftGenerationState,
+) {
+  return steps.map((step, index) => {
+    const isCompleted = state.phase === 'ready' || index < activeStepIndex;
+    const isActive = state.phase !== 'failed' && !isCompleted && index === activeStepIndex;
+    const isAssetStep = step.id === state.phase && state.totalAssetCount > 0;
+
+    return {
+      id: step.id,
+      label: step.label,
+      detail: step.detail,
+      completed: isCompleted
+        ? 1
+        : isAssetStep
+          ? state.completedAssetCount
+          : 0,
+      total: isAssetStep ? state.totalAssetCount : 1,
+      status: isCompleted ? 'completed' : isActive ? 'active' : 'pending',
+    } satisfies CustomWorldGenerationStep;
+  });
+}
+
+export function createMiniGameDraftGenerationState(
+  kind: MiniGameDraftGenerationKind,
+): MiniGameDraftGenerationState {
+  return {
+    kind,
+    phase: 'compile',
+    startedAtMs: Date.now(),
+    completedAssetCount: 0,
+    totalAssetCount: 0,
+    error: null,
+  };
+}
+
+export function buildMiniGameDraftGenerationProgress(
+  state: MiniGameDraftGenerationState | null,
+  nowMs = Date.now(),
+): CustomWorldGenerationProgress | null {
+  if (!state) {
+    return null;
+  }
+
+  const steps = getStepDefinitions(state.kind);
+  const activeStepIndex = getActiveStepIndex(steps, state.phase);
+  const completedWeight = steps
+    .slice(0, state.phase === 'ready' ? steps.length : activeStepIndex)
+    .reduce((sum, step) => sum + step.weight, 0);
+  const activeStep = steps[activeStepIndex] ?? steps[0];
+  const assetRatio =
+    state.totalAssetCount > 0
+      ? Math.min(1, state.completedAssetCount / state.totalAssetCount)
+      : state.phase === 'ready'
+        ? 1
+        : 0;
+  const overallProgress =
+    state.phase === 'failed'
+      ? Math.max(1, completedWeight)
+      : state.phase === 'ready'
+        ? 100
+        : completedWeight + activeStep.weight * assetRatio;
+
+  return {
+    phaseId: state.phase,
+    phaseLabel:
+      state.phase === 'failed'
+        ? '生成失败'
+        : state.phase === 'ready'
+          ? '生成完成'
+          : activeStep.label,
+    phaseDetail:
+      state.error ??
+      (state.phase === 'ready'
+        ? '完整草稿与资产已准备完成。'
+        : activeStep.detail),
+    batchLabel: activeStep.label,
+    overallProgress: clampProgress(overallProgress),
+    completedWeight: clampProgress(overallProgress),
+    totalWeight: 100,
+    elapsedMs: Math.max(0, nowMs - state.startedAtMs),
+    estimatedRemainingMs: state.phase === 'ready' ? 0 : null,
+    activeStepIndex,
+    steps: buildMiniGameProgressSteps(steps, activeStepIndex, state),
+  };
+}
+
+export function buildPuzzleGenerationAnchorEntries(
+  session: PuzzleAgentSessionSnapshot | null | undefined,
+): CustomWorldStructuredAnchorEntry[] {
+  if (!session) {
+    return [];
+  }
+
+  const draft = session.draft;
+  const entries: Array<MiniGameAnchorSource | null> = [
+    session.anchorPack.themePromise,
+    session.anchorPack.visualSubject,
+    session.anchorPack.visualMood,
+    session.anchorPack.compositionHooks,
+    session.anchorPack.tagsAndForbidden,
+    draft
+      ? {
+          key: 'draft-summary',
+          label: '草稿摘要',
+          value: draft.summary,
+        }
+      : null,
+    draft?.coverImageSrc
+      ? {
+          key: 'cover-image',
+          label: '正式图片',
+          value: '已生成并应用',
+        }
+      : null,
+  ];
+
+  return entries
+    .filter((entry): entry is MiniGameAnchorSource => Boolean(entry))
+    .map((entry) => ({
+      id: entry.key,
+      label: entry.label,
+      value: entry.value,
+    }))
+    .filter((entry) => entry.value.trim());
+}
+
+export function buildBigFishGenerationAnchorEntries(
+  session: BigFishSessionSnapshotResponse | null | undefined,
+): CustomWorldStructuredAnchorEntry[] {
+  if (!session) {
+    return [];
+  }
+
+  const draft = session.draft;
+  const assetReadyCount = session.assetSlots.filter(
+    (slot) => slot.status === 'ready',
+  ).length;
+
+  const entries: Array<MiniGameAnchorSource | null> = [
+    session.anchorPack.gameplayPromise,
+    session.anchorPack.ecologyVisualTheme,
+    session.anchorPack.growthLadder,
+    session.anchorPack.riskTempo,
+    draft
+      ? {
+          key: 'level-characters',
+          label: '角色描述',
+          value: draft.levels
+            .map((level) => `Lv.${level.level} ${level.name}：${level.oneLineFantasy}`)
+            .join('\n'),
+        }
+      : null,
+    draft
+      ? {
+          key: 'asset-coverage',
+          label: '图片与动作',
+          value: `已生成 ${assetReadyCount}/${session.assetSlots.length} 个资产`,
+        }
+      : null,
+  ];
+
+  return entries
+    .filter((entry): entry is MiniGameAnchorSource => Boolean(entry))
+    .map((entry) => ({
+      id: entry.key,
+      label: entry.label,
+      value: entry.value,
+    }))
+    .filter((entry) => entry.value.trim());
+}
--- a/src/services/puzzle-runtime/index.ts
+++ b/src/services/puzzle-runtime/index.ts
@@ -1,4 +1,5 @@
 export {
+  advanceLocalPuzzleNextLevel,
  advancePuzzleNextLevel,
  dragPuzzlePieceOrGroup,
  getPuzzleRun,
--- a/src/services/puzzle-runtime/puzzleLocalRuntime.ts
+++ b/src/services/puzzle-runtime/puzzleLocalRuntime.ts
@@ -112,13 +112,13 @@ function buildLocalNextProfileId(entryProfileId: string, levelIndex: number) {
  return `${entryProfileId}::local-level-${levelIndex}`;
 }

-// 第一版单机玩法没有后端推荐池，本地沿用当前作品图片并生成可推进的临时关卡名。
+// 第一版单机兜底没有后端推荐池时，才沿用当前作品图片生成可推进的临时关卡名。
 function buildLocalLevelName(previousLevelName: string, levelIndex: number) {
  return `${previousLevelName.replace(/ · 第 \d+ 关$/, '')} · 第 ${levelIndex} 关`;
 }

-// 本地运行态只保证单次游玩闭环：通关后立即重建下一关棋盘，不写回后端。
-function buildNextLocalLevel(run: PuzzleRunSnapshot): PuzzleRunSnapshot {
+// 本地兜底只保证单次游玩闭环：通关后立即重建下一关棋盘，不写回后端。
+function buildFallbackLocalLevel(run: PuzzleRunSnapshot): PuzzleRunSnapshot {
  const currentLevel = run.currentLevel;
  if (!currentLevel || currentLevel.status !== 'cleared') {
    return run;
@@ -240,5 +240,5 @@ export function dragLocalPuzzlePiece(
 }

 export function advanceLocalPuzzleLevel(run: PuzzleRunSnapshot): PuzzleRunSnapshot {
-  return buildNextLocalLevel(run);
+  return buildFallbackLocalLevel(run);
 }
--- a/src/services/puzzle-runtime/puzzleRuntimeClient.ts
+++ b/src/services/puzzle-runtime/puzzleRuntimeClient.ts
@@ -1,4 +1,5 @@
 import type {
+  AdvanceLocalPuzzleNextLevelRequest,
  DragPuzzlePieceRequest,
  PuzzleRunResponse,
  StartPuzzleRunRequest,
@@ -111,7 +112,28 @@ export async function advancePuzzleNextLevel(runId: string) {
  );
 }

+/**
+ * 单机运行态进入下一关，图片来源选择全部由后端裁决。
+ */
+export async function advanceLocalPuzzleNextLevel(
+  payload: AdvanceLocalPuzzleNextLevelRequest,
+) {
+  return requestJson<PuzzleRunResponse>(
+    `${PUZZLE_RUNTIME_API_BASE}/local-next-level`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '进入下一关失败',
+    {
+      retry: PUZZLE_RUNTIME_WRITE_RETRY,
+    },
+  );
+}
+
 export const puzzleRuntimeClient = {
+  advanceLocalNextLevel: advanceLocalPuzzleNextLevel,
  advanceNextLevel: advancePuzzleNextLevel,
  drag: dragPuzzlePieceOrGroup,
  getRun: getPuzzleRun,