Improve local auth env handling and fallbacks

Allow local env files to reliably override authentication feature flags (SMS/WeChat) by whitelisting keys in scripts/dev-utils.mjs and adding a unit test. Add SMS checks to scripts/check-api-server-env.mjs. Make server config.parse_bool tolerant of shell-wrapped quoted values (e.g. '"true"') and add tests so SMS_AUTH_ENABLED is parsed correctly when shells supply quotes. Update docs to clarify SMS env behaviour, restart requirements, and add guidance + a CSS fallback for old mobile browsers (QQ/X5) so public cover images render even when aspect-ratio is unsupported. Also include related frontend test and component adjustments and add puzzle onboarding handlers/endpoints in server-rs/crates/api-server/src/puzzle.rs.

src/components/rpg-entry/RpgEntryFlowShell.agent.interaction.test.tsx

@@ -3432,6 +3432,73 @@ test('running match3d persisted draft reopens progress instead of unfinished res
   );
 });
 
+test('persisted generating match3d draft opens generation progress after refresh', async () => {
+  const user = userEvent.setup();
+  const persistedGeneratingWork: Match3DWorkSummary = {
+    workId: 'match3d-work-generating',
+    profileId: 'match3d-profile-generating',
+    ownerUserId: 'user-1',
+    sourceSessionId: 'match3d-session-generating',
+    gameName: '生成中抓鹅',
+    themeText: '霓虹水果摊',
+    summary: '刷新后仍应回到抓大鹅生成面板。',
+    tags: ['水果', '抓大鹅'],
+    coverImageSrc: null,
+    referenceImageSrc: null,
+    clearCount: 12,
+    difficulty: 4,
+    publicationStatus: 'draft',
+    playCount: 0,
+    updatedAt: '2026-05-18T12:05:00.000Z',
+    publishedAt: null,
+    publishReady: false,
+    generationStatus: 'generating',
+    generatedItemAssets: [],
+  };
+
+  vi.mocked(listMatch3DWorks).mockResolvedValue({
+    items: [persistedGeneratingWork],
+  });
+  vi.mocked(match3dCreationClient.getSession).mockResolvedValueOnce({
+    session: buildMockMatch3DAgentSession({
+      sessionId: 'match3d-session-generating',
+      draft: {
+        profileId: 'match3d-profile-generating',
+        gameName: '生成中抓鹅',
+        themeText: '霓虹水果摊',
+        summary: '刷新后仍应回到抓大鹅生成面板。',
+        tags: ['水果', '抓大鹅'],
+        coverImageSrc: null,
+        referenceImageSrc: null,
+        clearCount: 12,
+        difficulty: 4,
+        generatedItemAssets: [],
+      },
+      stage: 'draft_ready',
+      lastAssistantReply: '正在生成抓大鹅素材。',
+      updatedAt: '2026-05-18T12:05:00.000Z',
+    }),
+  });
+
+  render(<TestWrapper withAuth />);
+
+  await openDraftHub(user);
+  await user.click(
+    await screen.findByRole('button', { name: /继续创作《生成中抓鹅》/u }),
+  );
+
+  await waitFor(() => {
+    expect(match3dCreationClient.getSession).toHaveBeenCalledWith(
+      'match3d-session-generating',
+    );
+  });
+  expect(await screen.findByText('抓大鹅草稿生成进度')).toBeTruthy();
+  expect(screen.queryByText('抓大鹅结果页')).toBeNull();
+  expect(getMatch3DWorkDetail).not.toHaveBeenCalledWith(
+    'match3d-profile-generating',
+  );
+});
+
 test('running match3d form generation keeps other creation templates available', async () => {
   const user = userEvent.setup();
   const runningSession = buildMockMatch3DAgentSession({
@@ -6410,6 +6477,59 @@ test('puzzle draft result back button returns to creation hub', async () => {
   expect(screen.queryByText('拼图结果页')).toBeNull();
 });
 
+test('persisted generating puzzle draft opens generation progress after refresh', async () => {
+  const user = userEvent.setup();
+
+  vi.mocked(listPuzzleWorks).mockResolvedValue({
+    items: [
+      {
+        workId: 'puzzle-work-session-generating',
+        profileId: 'puzzle-profile-session-generating',
+        ownerUserId: 'user-1',
+        sourceSessionId: 'puzzle-session-generating',
+        authorDisplayName: '测试玩家',
+        workTitle: '生成中拼图',
+        workDescription: '刷新后仍应回到生成面板。',
+        levelName: '生成中拼图',
+        summary: '刷新后仍应回到生成面板。',
+        themeTags: ['雨夜'],
+        coverImageSrc: null,
+        coverAssetId: null,
+        publicationStatus: 'draft',
+        updatedAt: '2026-05-18T12:00:00.000Z',
+        publishedAt: null,
+        playCount: 0,
+        remixCount: 0,
+        likeCount: 0,
+        publishReady: false,
+        generationStatus: 'generating',
+      },
+    ],
+  });
+  vi.mocked(getPuzzleAgentSession).mockResolvedValueOnce({
+    session: buildMockPuzzleAgentSession({
+      sessionId: 'puzzle-session-generating',
+      stage: 'collecting_anchors',
+      progressPercent: 42,
+      lastAssistantReply: '正在生成拼图草稿。',
+      updatedAt: '2026-05-18T12:00:00.000Z',
+    }),
+  });
+
+  render(<TestWrapper withAuth />);
+
+  await openDraftHub(user);
+  await user.click(await screen.findByRole('button', { name: /继续创作/u }));
+
+  await waitFor(() => {
+    expect(getPuzzleAgentSession).toHaveBeenCalledWith(
+      'puzzle-session-generating',
+    );
+  });
+  expect(await screen.findByText('拼图草稿生成进度')).toBeTruthy();
+  expect(screen.queryByText('拼图结果页')).toBeNull();
+});
+
 test('published puzzle work card restores its source session for editing', async () => {
   const user = userEvent.setup();