Merge branch 'codex/feature-1'

# Conflicts:
#	docs/【玩法创作】平台入口与玩法链路-2026-05-15.md
#	src/components/platform-entry/PlatformEntryFlowShellImpl.tsx
#	src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx
#	src/services/miniGameDraftGenerationProgress.ts

src/services/miniGameDraftGenerationProgress.ts

@@ -809,7 +809,54 @@ function resolveElapsedActiveStepProgressRatio(
                 ? WOODEN_FISH_ESTIMATED_WAIT_MS
                 : 1;
 
-  return Math.max(0, Math.min(0.98, elapsedMs / Math.max(1, estimatedWaitMs)));
+  return Math.max(
+    0,
+    Math.min(0.98, elapsedMs / Math.max(1, estimatedWaitMs)),
+  );
+}
+
+/** 计算拼图生成总进度，后端里程碑决定跨步骤，当前步骤内使用平滑假进度。 */
+function resolvePuzzleOverallProgress(
+  state: MiniGameDraftGenerationState,
+  activeStepProgressRatio: number,
+) {
+  const backendProgressPercent = resolvePuzzleBackendProgressPercent(state);
+  // 中文注释：88 以下的后端进度只保留为会话事实，不参与首帧总进度抬升。
+  // 生成页恢复时必须先从 0% 起步，再由当前步骤内的假进度平滑推进。
+  const backendProgressFloor =
+    backendProgressPercent != null &&
+    backendProgressPercent >= PUZZLE_COMPILE_MILESTONE_PROGRESS
+      ? backendProgressPercent
+      : 0;
+  const range =
+    state.phase === 'puzzle-select-image'
+      ? {
+          start: PUZZLE_UI_MILESTONE_PROGRESS,
+          end: PUZZLE_NON_READY_MAX_PROGRESS,
+        }
+      : state.phase === 'puzzle-ui-assets'
+        ? {
+            start: PUZZLE_IMAGE_MILESTONE_PROGRESS,
+            end: PUZZLE_UI_MILESTONE_PROGRESS,
+          }
+        : state.phase === 'puzzle-cover-image' ||
+            state.phase === 'puzzle-level-scene'
+          ? {
+              start: PUZZLE_COMPILE_MILESTONE_PROGRESS,
+              end: PUZZLE_IMAGE_MILESTONE_PROGRESS,
+            }
+          : {
+              start: 0,
+              end: PUZZLE_COMPILE_MILESTONE_PROGRESS,
+            };
+  const fakeProgress =
+    range.start + (range.end - range.start) * activeStepProgressRatio;
+  const nextProgress = Math.min(
+    PUZZLE_NON_READY_MAX_PROGRESS,
+    Math.max(range.start, backendProgressFloor, fakeProgress),
+  );
+
+  return nextProgress;
 }
 
 export function buildMiniGameDraftGenerationProgress(