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.

server-rs/crates/api-server/src/prompt/puzzle/level_name.rs

@@ -1,29 +1,34 @@
-/// 拼图首关关卡名生成提示词。
+/// 拼图首关关卡名与 UI 背景提示词生成提示词。
 ///
-/// 模型只负责把画面描述压缩成可直接展示的中文关卡名；写回草稿和作品卡由业务路由处理。
+/// 模型只负责把画面描述压缩成可直接展示的中文关卡名，并产出运行态 UI 背景的正向视觉提示词；
+/// 写回草稿和作品卡由业务路由处理。
 pub(crate) const PUZZLE_FIRST_LEVEL_NAME_SYSTEM_PROMPT: &str = r#"你是一个中文拼图关卡命名编辑。
 
-你会收到拼图第一关的画面描述，部分请求还会附带已经生成完成的正式图片。请综合图片内容和画面描述，生成 1 个适合直接展示在游戏关卡卡片上的中文关卡名。
+你会收到拼图第一关的画面描述，部分请求还会附带已经生成完成的正式图片。请综合图片内容和画面描述，同时生成：
+- 1 个适合直接展示在游戏关卡卡片上的中文关卡名。
+- 1 段用于生成 9:16 拼图运行态 UI 纯背景图的中文正向视觉提示词。
 
 硬约束：
 1. 只输出 JSON，不要输出 Markdown、解释或代码块。
-2. JSON 格式必须是 {"levelName":"关卡名"}。
+2. JSON 格式必须是 {"levelName":"关卡名","uiBackgroundPrompt":"提示词"}。
 3. levelName 必须是 2 到 8 个中文字符为主。
 4. 不要输出“第一关”“画面”“拼图”“作品”等泛词。
 5. 不要输出标点、引号、编号、英文、emoji 或空白。
 6. 关卡名要抓住画面主体、场景和氛围，读起来像一个具体可玩的关卡。
+7. uiBackgroundPrompt 必须是 30 到 160 个中文字符，描述题材氛围、环境、色彩、光影和空间层次。
+8. uiBackgroundPrompt 只写正向画面描述，不要写规则说明，不要出现拼图槽、棋盘、HUD、按钮、文字、水印、数字、拼图碎片、完整拼图图像或教程浮层。
 "#;
 
 pub(crate) fn build_puzzle_first_level_name_user_prompt(picture_description: &str) -> String {
     format!(
-        "画面描述：{picture_description}\n\n请生成第一关关卡名。",
+        "画面描述：{picture_description}\n\n请生成第一关关卡名和 UI 背景提示词。",
         picture_description = picture_description.trim(),
     )
 }
 
 pub(crate) fn build_puzzle_first_level_name_vision_user_text(picture_description: &str) -> String {
     format!(
-        "画面描述：{picture_description}\n\n请观察随消息附带的正式拼图图片，生成第一关关卡名。",
+        "画面描述：{picture_description}\n\n请观察随消息附带的正式拼图图片，生成第一关关卡名和 UI 背景提示词。",
         picture_description = picture_description.trim(),
     )
 }
@@ -38,6 +43,7 @@ mod tests {
 
         assert!(prompt.contains("画面描述：一只猫在雨夜灯牌下回头。"));
         assert!(prompt.contains("第一关关卡名"));
+        assert!(prompt.contains("UI 背景提示词"));
     }
 
     #[test]
@@ -46,5 +52,6 @@ mod tests {
 
         assert!(prompt.contains("画面描述：一只猫在雨夜灯牌下回头。"));
         assert!(prompt.contains("正式拼图图片"));
+        assert!(prompt.contains("UI 背景提示词"));
     }
 }