Update Match3D/image-generation docs & code

Adds/updates documentation, assets and implementation for Match3D and puzzle image generation workflows. Key changes: decision logs and pitfalls updated to prefer VectorEngine Gemini for Match3D material sheets and to require edits (multipart) for 1:1 container reference images; guidance added for when to use APIMart vs VectorEngine. .env.example clarified APIMart/Responses config. Many new public assets and PPT visuals added. Code changes across frontend and backend: updated shared contracts, server-rs match3d/puzzle/image-generation handlers, VectorEngine/OpenAI image generation clients, and multiple React components/tests to handle UI/background/container image signing, edits workflow, and puzzle UI background resolution. Added src/services/puzzle-runtime/puzzleUiBackgroundSource.ts and related test updates. Includes notes about multipart HTTP/1.1 requirement and test/verification commands in docs.

src/services/match3d-works/match3dWorksClient.ts

@@ -1,6 +1,8 @@
 import type {
   GenerateMatch3DBackgroundImageRequest,
   GenerateMatch3DBackgroundImageResponse,
+  GenerateMatch3DContainerImageRequest,
+  GenerateMatch3DContainerImageResponse,
   GenerateMatch3DCoverImageRequest,
   GenerateMatch3DCoverImageResponse,
   GenerateMatch3DItemAssetsRequest,
@@ -177,6 +179,28 @@ export function generateMatch3DBackgroundImage(
   );
 }
 
+/**
+ * 按画面描述重新生成并保存抓大鹅局内容器形象。
+ */
+export function generateMatch3DContainerImage(
+  profileId: string,
+  payload: GenerateMatch3DContainerImageRequest,
+) {
+  return requestJson<GenerateMatch3DContainerImageResponse>(
+    `${MATCH3D_WORKS_API_BASE}/${encodeURIComponent(profileId)}/container-image`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '生成抓大鹅容器形象失败',
+    {
+      retry: MATCH3D_WORKS_WRITE_RETRY,
+      timeoutMs: 240_000,
+    },
+  );
+}
+
 /**
  * 按名称批量生成抓大鹅 2D 五视角物品图片。
  */
@@ -244,6 +268,7 @@ export function deleteMatch3DWork(profileId: string) {
 export const match3dWorksClient = {
   delete: deleteMatch3DWork,
   generateBackgroundImage: generateMatch3DBackgroundImage,
+  generateContainerImage: generateMatch3DContainerImage,
   generateCoverImage: generateMatch3DCoverImage,
   generateItemAssets: generateMatch3DItemAssets,
   generateTags: generateMatch3DWorkTags,