补齐抠图参数透传与验收

修复flat自动识别门禁并严格校验模式和颜色

保持旧请求幂等指纹并区分客户端抠图意图

同步工具说明和Skill契约并补充定向测试

记录真实BgFilter验证及本地数据库阻塞的待验收项

docs/openapi/genarrative-external-v1.openapi.json

@@ -3215,12 +3215,12 @@
             "type": ["string", "null"],
             "enum": ["complex", "flat", null],
             "default": "complex",
-            "description": "抠图模式。不填按 complex 处理；complex 使用语义分割识别前景，flat 用于纯色背景抠图。确定背景为纯色时优先使用 flat。"
+            "description": "抠图模式。省略或 null 按 complex 处理；complex 使用语义分割识别前景，flat 用于纯色背景抠图。确定背景为纯色时优先使用 flat。"
           },
           "screenColor": {
             "type": ["string", "null"],
             "pattern": "^(auto|#[0-9A-Fa-f]{6})$",
-            "description": "仅 flat 模式使用。可传 auto、#RRGGBB 或省略；auto 和省略由服务自动检测背景色。complex 搭配此字段返回 400。"
+            "description": "仅 flat 模式使用。可传 auto、#RRGGBB 或省略；null 等同省略。auto 和省略由服务自动检测背景色。模式省略或 complex 时提供非 null 颜色返回 400；空字符串或非法颜色返回 400。"
           },
           "projectId": {
             "type": ["string", "null"],
@@ -3260,6 +3260,14 @@
             "description": "画布生成占位完成指令。提供时优先按生成完成链路写入结果，targetLayerId 不参与原位替换。"
           }
         },
+        "if": {
+          "required": ["screenColor"],
+          "properties": { "screenColor": { "type": "string" } }
+        },
+        "then": {
+          "required": ["backgroundMode"],
+          "properties": { "backgroundMode": { "const": "flat" } }
+        },
         "additionalProperties": false
       },
       "EditorImageGenerationResponse": {