修复拼图文字直创过早完成

修正拼图文字直创 compile 回包未出图时继续保持生成中

补充文字直创无正式图的回归测试

更新玩法链路文档和 Hermes 踩坑记录

src/components/platform-entry/PlatformEntryFlowShellImpl.tsx

@@ -2620,26 +2620,33 @@ function mergePuzzleSessionProgressIntoGenerationState(
   const isCompiledGenerationSession = Boolean(
     session.draft && !session.draft.formDraft,
   );
+  if (!isCompiledGenerationSession) {
+    return state;
+  }
 
-  const nextPhaseId = isCompiledGenerationSession
-    ? resolvePuzzlePhaseFromSessionProgress(state, session)
-    : state.metadata?.puzzleActivePhaseId;
+  const nextPhaseId = resolvePuzzlePhaseFromSessionProgress(state, session);
   const shouldResetActiveStepStart =
-    isCompiledGenerationSession &&
     nextPhaseId != null &&
     nextPhaseId !== state.metadata?.puzzleActivePhaseId;
+  const nextActiveStepStartedAtMs = shouldResetActiveStepStart
+    ? resolveMiniGameDraftGenerationStartedAtMs(session.updatedAt)
+    : state.metadata?.puzzleActiveStepStartedAtMs;
+
+  if (
+    state.metadata?.puzzleActivePhaseId === nextPhaseId &&
+    state.metadata?.puzzleActiveStepStartedAtMs === nextActiveStepStartedAtMs &&
+    state.metadata?.puzzleProgressPercent === session.progressPercent
+  ) {
+    return state;
+  }
 
   return {
     ...state,
     metadata: {
       ...state.metadata,
       puzzleActivePhaseId: nextPhaseId,
-      puzzleActiveStepStartedAtMs: shouldResetActiveStepStart
-        ? resolveMiniGameDraftGenerationStartedAtMs(session.updatedAt)
-        : state.metadata?.puzzleActiveStepStartedAtMs,
-      puzzleProgressPercent: isCompiledGenerationSession
-        ? session.progressPercent
-        : state.metadata?.puzzleProgressPercent,
+      puzzleActiveStepStartedAtMs: nextActiveStepStartedAtMs,
+      puzzleProgressPercent: session.progressPercent,
     },
   };
 }
@@ -7977,7 +7984,49 @@ export function PlatformEntryFlowShellImpl({
           actionPayload,
         );
         setPuzzleOperation(response.operation);
-        const openResult = isViewingPuzzleGeneration(nextSession.sessionId);
+        const openResult =
+          isViewingPuzzleGeneration(nextSession.sessionId) ||
+          isViewingPuzzleGeneration(response.session.sessionId);
+        if (!isPuzzleCompileActionReady(response.session)) {
+          // 中文注释：文字直创的同步 action 回包只代表后台生图任务已启动；
+          // 未拿到正式图前继续保持生成中，避免误弹完成或启动空草稿试玩。
+          const nextGenerationState = mergePuzzleSessionProgressIntoGenerationState(
+            generationState,
+            response.session,
+          );
+          activePuzzleGenerationSessionIdRef.current = response.session.sessionId;
+          setPuzzleBackgroundCompileTasks((current) => {
+            const next = { ...current };
+            if (nextSession.sessionId !== response.session.sessionId) {
+              delete next[nextSession.sessionId];
+            }
+            next[response.session.sessionId] = {
+              session: response.session,
+              payload,
+              generationState: nextGenerationState,
+              error: null,
+            };
+            return next;
+          });
+          puzzleFlow.setSession(response.session);
+          if (openResult) {
+            setPuzzleGenerationState(nextGenerationState);
+          }
+          markDraftGenerating('puzzle', [
+            response.session.sessionId,
+            buildPuzzleResultWorkId(response.session.sessionId),
+            response.session.publishedProfileId,
+            buildPuzzleResultProfileId(response.session.sessionId),
+          ]);
+          markPendingDraftGenerating(
+            'puzzle',
+            response.session.sessionId,
+            buildPendingPuzzleDraftMetadata(payload),
+          );
+          void refreshPuzzleShelf();
+          return;
+        }
+
         const readyGenerationState =
           resolveFinishedMiniGameDraftGenerationState(
             generationState,