扩展AGC抠图客户端参数

支持complex与flat模式及auto背景色

保留旧客户端参数调用兼容性

apps/ai-game-creator-shell/src-tauri/src/agent/direct_tool_bridge.rs

@@ -1887,7 +1887,15 @@ async fn bridge_create_or_derive_resource(
 
 async fn bridge_remove_background(state: &DirectToolBridgeState, arguments: &Value) -> Value {
     let result = async {
-        bridge_reject_unknown_fields(arguments, &["sourceLocalAssetId", "assetName"])?;
+        bridge_reject_unknown_fields(
+            arguments,
+            &[
+                "sourceLocalAssetId",
+                "assetName",
+                "backgroundMode",
+                "screenColor",
+            ],
+        )?;
         enforce_project_permission_policy(&state.root, "canvas.asset_generate")?;
         enforce_project_permission_policy(&state.root, "asset.register")?;
         let source_asset_id = bridge_bounded_string(arguments, "sourceLocalAssetId", 80)?;
@@ -1896,6 +1904,26 @@ async fn bridge_remove_background(state: &DirectToolBridgeState, arguments: &Val
             "assetName",
             DIRECT_TOOL_BRIDGE_MAX_RESOURCE_NAME_CHARS,
         )?;
+        let background_mode = bridge_optional_bounded_string(arguments, "backgroundMode", 16)?;
+        let screen_color = bridge_optional_bounded_string(arguments, "screenColor", 16)?;
+        if let Some(mode) = background_mode.as_deref() {
+            if mode != "complex" && mode != "flat" {
+                return Err("backgroundMode 必须是 complex 或 flat".to_string());
+            }
+        }
+        if let Some(color) = screen_color.as_deref() {
+            let valid_hex = color.len() == 7
+                && color.starts_with('#')
+                && color[1..]
+                    .chars()
+                    .all(|character| character.is_ascii_hexdigit());
+            if color != "auto" && !valid_hex {
+                return Err("screenColor 必须是 auto 或 #RRGGBB".to_string());
+            }
+            if background_mode.as_deref() == Some("complex") {
+                return Err("complex 模式不能传 screenColor".to_string());
+            }
+        }
         let manifest = read_existing_manifest_for_project(&state.root)?;
         let source_asset = manifest
             .assets
@@ -1935,6 +1963,8 @@ async fn bridge_remove_background(state: &DirectToolBridgeState, arguments: &Val
                     "assetFolderId": context.asset_folder_id,
                     "assetLabel": asset_name,
                     "sourceResourceId": source_resource_id,
+                    "backgroundMode": background_mode,
+                    "screenColor": screen_color,
                 })),
         )
         .send()

apps/ai-game-creator-shell/src-tauri/src/agent/direct_tools_mcp.rs

@@ -449,6 +449,16 @@ fn direct_tools_mcp_specs_for(controlled_web_search: bool, _cocos_editor_availab
                             "type": "string",
                             "minLength": 1,
                             "maxLength": DIRECT_TOOLS_MCP_MAX_RESOURCE_NAME_CHARS
+                        },
+                        "backgroundMode": {
+                            "type": "string",
+                            "enum": ["complex", "flat"],
+                            "description": "可选抠图模式；省略时兼容旧行为并使用 complex"
+                        },
+                        "screenColor": {
+                            "type": "string",
+                            "pattern": "^(auto|#[0-9A-Fa-f]{6})$",
+                            "description": "flat 模式可选背景色；传 auto 或 #RRGGBB，省略由 BgFilter 自动检测"
                         }
                     },
                     "required": ["sourceLocalAssetId", "assetName"],
@@ -882,13 +892,45 @@ fn validate_resource_generation_arguments(arguments: &Value) -> Result<(), Strin
 }
 
 fn validate_remove_background_arguments(arguments: &Value) -> Result<(), String> {
-    validate_tool_object_fields(arguments, &["sourceLocalAssetId", "assetName"])?;
+    validate_tool_object_fields(
+        arguments,
+        &[
+            "sourceLocalAssetId",
+            "assetName",
+            "backgroundMode",
+            "screenColor",
+        ],
+    )?;
     bounded_tool_string(arguments, "sourceLocalAssetId", 80)?;
     bounded_tool_string(
         arguments,
         "assetName",
         DIRECT_TOOLS_MCP_MAX_RESOURCE_NAME_CHARS,
     )?;
+    if let Some(mode) = arguments.get("backgroundMode") {
+        let mode = mode
+            .as_str()
+            .ok_or_else(|| "backgroundMode 必须是 complex 或 flat".to_string())?;
+        if mode != "complex" && mode != "flat" {
+            return Err("backgroundMode 必须是 complex 或 flat".to_string());
+        }
+    }
+    if let Some(color) = arguments.get("screenColor") {
+        let color = color
+            .as_str()
+            .ok_or_else(|| "screenColor 必须是 auto 或 #RRGGBB".to_string())?;
+        let valid_hex = color.len() == 7
+            && color.starts_with('#')
+            && color[1..]
+                .chars()
+                .all(|character| character.is_ascii_hexdigit());
+        if color != "auto" && !valid_hex {
+            return Err("screenColor 必须是 auto 或 #RRGGBB".to_string());
+        }
+        if arguments.get("backgroundMode").and_then(Value::as_str) == Some("complex") {
+            return Err("complex 模式不能传 screenColor".to_string());
+        }
+    }
     Ok(())
 }