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.

public/match3d-background-references/pot-fused-reference-candidate-v5.prompt.txt

@@ -0,0 +1 @@
+生成一张 1024x1024 的 1:1 抓大鹅中心容器 UI 参考图。只允许一个完整容器。不要多个容器、不要备选方案、不要物品、不要角色、不要手、不要文字、不要红色标注线。核心比例：开口是绝对主体，桶身只是装饰。可见桶身高度必须只有开口椭圆高度的约 1/8（12.5%），不要高桶身，不要深桶。开口必须极大：正前方轻俯视的巨大横向椭圆开口，外开口椭圆宽度占画布 94%-98%，开口椭圆高度占画布 78%-84%。开口上缘接近 y=45，开口下缘接近 y=850。桶身必须极矮：从前沿下缘到容器底部只保留一圈薄木质装饰桶身，高度约 90-110 像素；底部接近 y=960-990。整体看起来像一个超大开口的低矮木质竞技圈，不像深木桶。前方装饰边必须连续闭合，没有缺口、门洞或围栏断口。前沿是一圈厚实圆润的木质环，桶身只是这圈环下面的一小段装饰外壁。内部必须空且干净：只有平滑金色木质内底、内壁圆弧和柔和阴影；不要发光、不要食物、不要水、不要纹章、不要格子、不要棋盘、不要物品槽。视角：正前方轻俯视，yaw=0，不要左右斜向 3/4 侧视。能看到超大开口内部和很矮的前方外壁。造型：高品质休闲游戏 2D UI 资产，暖金木质或竹质，清晰轮廓，柔和体积光影，边缘干净，适合覆盖在移动端抓大鹅中心棋盘。背景必须完全平整统一纯绿色 #00FF00 色键背景，用于后续抠透明；背景无纹理、无渐变、无阴影、无地面、无反射。容器本体不要使用 #00FF00 或接近纯绿色。强制避免：高桶身、深锅、深木桶、桶身高度超过开口高度 1/6、浅盘、小托盘、低矮盘子、正俯视扁圆盘、侧视碗、左右斜视、前沿缺口、画布大量留白、内部图案、红线、文字、水印、logo。