清理后端编译警告

删除后端未使用的历史 helper、mapper、handler 和 re-export

将仅测试使用的导入、常量和辅助函数收口到 cfg(test)

补齐 Jump Hop 测试构造体字段并对齐 Match3D 当前素材表测试契约

验证后端 workspace cargo check 与 Match3D、Puzzle 相关测试

server-rs/crates/api-server/src/match3d.rs

@@ -74,10 +74,9 @@ use crate::{
     generated_asset_sheets::apply_generated_asset_sheet_green_screen_alpha,
     http_error::AppError,
     openai_image_generation::{
-        DownloadedOpenAiImage, OpenAiGeneratedImages, OpenAiReferenceImage,
-        build_openai_image_http_client, create_openai_image_edit,
-        create_openai_image_edit_with_references, create_openai_image_generation,
-        require_openai_image_settings,
+        DownloadedOpenAiImage, OpenAiReferenceImage, build_openai_image_http_client,
+        create_openai_image_edit, create_openai_image_edit_with_references,
+        create_openai_image_generation, require_openai_image_settings,
     },
     platform_errors::map_oss_error,
     request_context::RequestContext,
@@ -87,7 +86,6 @@ use crate::{
     },
     work_play_tracking::{WorkPlayTrackingDraft, record_work_play_start_after_success},
 };
-
 const MATCH3D_AGENT_PROVIDER: &str = "match3d-agent";
 const MATCH3D_WORKS_PROVIDER: &str = "match3d-works";
 const MATCH3D_RUNTIME_PROVIDER: &str = "match3d-runtime";
@@ -101,7 +99,9 @@ const MATCH3D_MATERIAL_ITEM_BATCH_SIZE: usize = 20;
 const MATCH3D_ITEM_VIEW_COUNT: usize = 5;
 const MATCH3D_MATERIAL_GRID_SIZE: u32 = 10;
 const MATCH3D_MAX_GENERATED_ITEM_COUNT: usize = 20;
+#[cfg(test)]
 const MATCH3D_MATERIAL_VECTOR_ENGINE_GEMINI_MODEL: &str = "gemini-3-pro-image-preview";
+#[cfg(test)]
 const MATCH3D_MATERIAL_VECTOR_ENGINE_GEMINI_ASPECT_RATIO: &str = "1:1";
 const MATCH3D_LEGACY_MODEL_DOWNLOAD_TIMEOUT_MS: u64 = 3 * 60_000;
 const MATCH3D_OSS_PUT_TIMEOUT_MS: u64 = 3 * 60_000;
@@ -509,7 +509,9 @@ use self::runtime::*;
 mod item_assets;
 use self::item_assets::*;
 
+#[cfg(test)]
 mod vector_engine_gemini;
+#[cfg(test)]
 use self::vector_engine_gemini::*;
 
 fn ensure_non_empty(
@@ -528,6 +530,16 @@ fn ensure_non_empty(
     Ok(())
 }
 
+fn match3d_mime_to_extension(mime_type: &str) -> &str {
+    match mime_type {
+        "image/png" => "png",
+        "image/webp" => "webp",
+        "image/gif" => "gif",
+        "image/jpeg" | "image/jpg" => "jpg",
+        _ => "png",
+    }
+}
+
 fn match3d_json<T>(
     payload: Result<Json<T>, JsonRejection>,
     request_context: &RequestContext,