Match3D & Puzzle: runtime UI, assets, drag fix

Backend: stop treating background music as a required draft asset and remove auto-submit/plan for background music; load persisted generated UI/assets into Match3D agent session responses (added helpers to resolve profile id and fetch existing generated assets). Frontend: make Match3D result preview reuse runtime UI styles, unify runtime settings entry, update PuzzleRuntime to apply immediate pointermove transforms (disable drag transition), use SVG clipPath for merged piece rounding, ensure PuzzleRuntimeShell supplies platform theme classes, and adjust related tests. Docs & logs: update decision log, pitfalls and product docs to reflect these changes.

src/components/match3d-runtime/Match3DRuntimeShell.test.tsx

@@ -1,6 +1,13 @@
 /* @vitest-environment jsdom */
 
-import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
+import {
+  act,
+  fireEvent,
+  render,
+  screen,
+  waitFor,
+  within,
+} from '@testing-library/react';
 import { useEffect } from 'react';
 import { afterEach, expect, test, vi } from 'vitest';
 
@@ -200,6 +207,33 @@ test('顶部 HUD 对齐拼图样式展示关卡名和倒计时', () => {
   expect(screen.getByText('第 1 关')).toBeTruthy();
   expect(screen.getByText('水果抓大鹅')).toBeTruthy();
   expect(screen.getByText('10:00')).toBeTruthy();
+  expect(screen.getByRole('button', { name: '打开抓大鹅设置' })).toBeTruthy();
+  expect(screen.queryByRole('button', { name: '重新开始' })).toBeNull();
+});
+
+test('抓大鹅右上角设置面板内置重新开始', () => {
+  const run = startLocalMatch3DRun(4);
+  const onRestart = vi.fn();
+  render(
+    <Match3DRuntimeShell
+      run={run}
+      levelName="水果抓大鹅"
+      onBack={vi.fn()}
+      onRestart={onRestart}
+      onOptimisticRunChange={vi.fn()}
+      onClickItem={vi.fn()}
+    />,
+  );
+
+  fireEvent.click(screen.getByRole('button', { name: '打开抓大鹅设置' }));
+
+  const dialog = screen.getByRole('dialog', { name: '抓大鹅设置' });
+  expect(within(dialog).getByText('水果抓大鹅')).toBeTruthy();
+  expect(within(dialog).getByText('已清除 0/12')).toBeTruthy();
+  fireEvent.click(within(dialog).getByRole('button', { name: '重新开始' }));
+
+  expect(onRestart).toHaveBeenCalledTimes(1);
+  expect(screen.queryByRole('dialog', { name: '抓大鹅设置' })).toBeNull();
 });
 
 test('推荐页抓大鹅运行态隐藏返回按钮和结算返回入口', () => {
@@ -991,7 +1025,7 @@ test('运行态会换签并渲染抓大鹅中心容器 UI 图', async () => {
   const containerImage = screen.getByTestId(
     'match3d-container-image',
   ) as HTMLImageElement;
-  expect(containerImage.className).toContain('w-[min(96vw,28rem)]');
+  expect(containerImage.className).toContain('w-[min(99vw,34rem)]');
   expect(containerImage.className).toContain('h-auto');
   expect(containerImage.className).toContain('left-1/2');
   expect(containerImage.className).toContain('-translate-x-1/2');