统一推荐页游客运行态与切换队列

统一推荐页各玩法正式 runtime 的游客鉴权透传。

收口推荐页首页展示队列和嵌入运行态切换队列。

补齐未登录读档、签名资产和个人数据读取的游客态处理。

新增运行态 HUD 小尺寸 logo 资源并更新拼图与抓鹅展示。

补充推荐切换、runtime guest 启动和客户端请求回归测试。

更新玩法链路、后端契约和团队记忆文档。

src/services/puzzle-runtime/puzzleRuntimeClient.ts

@@ -8,10 +8,7 @@ import type {
   UpdatePuzzleRuntimePauseRequest,
   UsePuzzleRuntimePropRequest,
 } from '../../../packages/shared/src/contracts/puzzleRuntimeSession';
-import {
-  type ApiRetryOptions,
-  requestJson,
-} from '../apiClient';
+import { type ApiRetryOptions } from '../apiClient';
 import { type RuntimeGuestRequestOptions } from '../runtimeGuestAuth';
 import { buildRuntimeApiPath, requestRuntimeJson } from '../runtimeRequest';
 
@@ -52,11 +49,15 @@ export async function startPuzzleRun(
 /**
  * 读取拼图运行态快照。
  */
-export async function getPuzzleRun(runId: string) {
+export async function getPuzzleRun(
+  runId: string,
+  options: PuzzleRuntimeRequestOptions = {},
+) {
   return requestRuntimeJson<PuzzleRunResponse>({
     url: buildRuntimeApiPath(PUZZLE_RUNTIME_API_BASE, runId),
     fallbackMessage: '读取拼图运行快照失败',
     retry: PUZZLE_RUNTIME_READ_RETRY,
+    requestOptions: options,
   });
 }
 
@@ -66,6 +67,7 @@ export async function getPuzzleRun(runId: string) {
 export async function swapPuzzlePieces(
   runId: string,
   payload: SwapPuzzlePiecesRequest,
+  options: PuzzleRuntimeRequestOptions = {},
 ) {
   return requestRuntimeJson<PuzzleRunResponse>({
     url: buildRuntimeApiPath(PUZZLE_RUNTIME_API_BASE, runId, 'swap'),
@@ -73,6 +75,7 @@ export async function swapPuzzlePieces(
     jsonBody: payload,
     fallbackMessage: '交换拼图块失败',
     retry: PUZZLE_RUNTIME_WRITE_RETRY,
+    requestOptions: options,
   });
 }
 
@@ -82,6 +85,7 @@ export async function swapPuzzlePieces(
 export async function dragPuzzlePieceOrGroup(
   runId: string,
   payload: DragPuzzlePieceRequest,
+  options: PuzzleRuntimeRequestOptions = {},
 ) {
   return requestRuntimeJson<PuzzleRunResponse>({
     url: buildRuntimeApiPath(PUZZLE_RUNTIME_API_BASE, runId, 'drag'),
@@ -89,6 +93,7 @@ export async function dragPuzzlePieceOrGroup(
     jsonBody: payload,
     fallbackMessage: '拖动拼图块失败',
     retry: PUZZLE_RUNTIME_WRITE_RETRY,
+    requestOptions: options,
   });
 }
 
@@ -141,22 +146,14 @@ export async function updatePuzzleRunPause(
   payload: UpdatePuzzleRuntimePauseRequest,
   options: PuzzleRuntimeRequestOptions = {},
 ) {
-  return requestJson<PuzzleRunResponse>(
-    buildRuntimeApiPath(PUZZLE_RUNTIME_API_BASE, runId, 'pause'),
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    },
-    '更新拼图计时状态失败',
-    {
-      retry: PUZZLE_RUNTIME_WRITE_RETRY,
-      authImpact: options.authImpact,
-      skipRefresh: options.skipRefresh,
-      notifyAuthStateChange: options.notifyAuthStateChange,
-      clearAuthOnUnauthorized: options.clearAuthOnUnauthorized,
-    },
-  );
+  return requestRuntimeJson<PuzzleRunResponse>({
+    url: buildRuntimeApiPath(PUZZLE_RUNTIME_API_BASE, runId, 'pause'),
+    method: 'POST',
+    jsonBody: payload,
+    fallbackMessage: '更新拼图计时状态失败',
+    retry: PUZZLE_RUNTIME_WRITE_RETRY,
+    requestOptions: options,
+  });
 }
 
 /**
@@ -167,22 +164,14 @@ export async function usePuzzleRuntimeProp(
   payload: UsePuzzleRuntimePropRequest,
   options: PuzzleRuntimeRequestOptions = {},
 ) {
-  return requestJson<PuzzleRunResponse>(
-    buildRuntimeApiPath(PUZZLE_RUNTIME_API_BASE, runId, 'props'),
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    },
-    '使用拼图道具失败',
-    {
-      retry: PUZZLE_RUNTIME_WRITE_RETRY,
-      authImpact: options.authImpact,
-      skipRefresh: options.skipRefresh,
-      notifyAuthStateChange: options.notifyAuthStateChange,
-      clearAuthOnUnauthorized: options.clearAuthOnUnauthorized,
-    },
-  );
+  return requestRuntimeJson<PuzzleRunResponse>({
+    url: buildRuntimeApiPath(PUZZLE_RUNTIME_API_BASE, runId, 'props'),
+    method: 'POST',
+    jsonBody: payload,
+    fallbackMessage: '使用拼图道具失败',
+    retry: PUZZLE_RUNTIME_WRITE_RETRY,
+    requestOptions: options,
+  });
 }
 
 export const puzzleRuntimeClient = {