新增图片生成像素艺术后处理

新增确定性像素网格规整模块并保留第三方 MIT 许可证。

为普通图片、角色和图标图集接入像素艺术选项、并发预算和失败降级。

同步前端交互、请求契约、OpenAPI、项目文档与测试。

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

@@ -2561,6 +2561,21 @@
             ],
             "description": "纯色抠像背景色。可传画布支持的纯色背景 hex（如 #CFEFFF）指定；传 \"auto\"、null 或省略则由服务端自动决策。"
           },
+          "style": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "examples": [
+              "none",
+              "pixelArt"
+            ],
+            "description": "可选生成后处理风格，当前识别 none 与 pixelArt。省略、null、空字符串或 none 按无风格处理；pixelArt 仅支持普通图片（kind 省略）和 character。未知字符串或不支持该风格的 kind 按 none 继续生成并返回 unsupported-image-style 告警；非字符串值返回 400。"
+          },
           "size": {
             "type": "string",
             "description": "兼容旧 size 入参；未传 aspectRatio/imageSize 时生效。",
@@ -2585,7 +2600,7 @@
               "ui-design",
               "publication-material"
             ],
-            "default": "spec"
+            "description": "省略时生成普通图片；其它值选择对应的专用生成流程。"
           },
           "model": {
             "type": "string",
@@ -2963,6 +2978,21 @@
             ],
             "description": "纯色抠像背景色。可传画布支持的纯色背景 hex（如 #CFEFFF）指定；传 \"auto\"、null 或省略则由服务端自动决策。"
           },
+          "style": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "examples": [
+              "none",
+              "pixelArt"
+            ],
+            "description": "可选生成后处理风格，当前识别 none 与 pixelArt。省略、null、空字符串或 none 按无风格处理；pixelArt 启用图标图集像素规整。未知字符串按 none 继续生成并返回 unsupported-image-style 告警；非字符串值返回 400。"
+          },
           "model": {
             "type": "string",
             "default": "gemini-3.1-flash-image-preview"
@@ -3176,8 +3206,13 @@
         "properties": {
           "code": {
             "type": "string",
-            "const": "postprocess-failed-source-preserved",
-            "description": "透明背景处理最终失败并保留 provider 原图时的稳定原因码。"
+            "enum": [
+              "postprocess-failed-source-preserved",
+              "dimension-restore-fallback",
+              "unsupported-image-style",
+              "multiple-generation-warnings"
+            ],
+            "description": "生成成功但后处理发生非阻断降级时的稳定原因码。"
           },
           "reason": {
             "type": "string",
@@ -3226,7 +3261,7 @@
                 "type": "null"
               }
             ],
-            "description": "图集已成功持久化，但自动拆分未完成时返回；此时 iconImageSrcs 为空，调用方仍应使用整张图集。与通用 warning 互斥。"
+            "description": "图集已成功持久化，但自动拆分未完成时返回；此时 iconImageSrcs 为空，调用方仍应使用整张图集。透明背景最终失败时不会进入拆分；风格归一化或像素规整产生通用 warning 时，两者可以并存。"
           },
           "prompt": {
             "type": "string"
@@ -3290,14 +3325,8 @@
                 "type": "null"
               }
             ],
-            "description": "透明背景处理最终失败、provider 原图作为主结果时返回的非阻断告警。与 sliceWarning 互斥。"
+            "description": "生成成功但风格归一化、尺寸恢复、透明背景处理或像素规整发生非阻断降级时返回。透明背景最终失败时不会进入拆分；其它通用告警可以与 sliceWarning 并存。"
           }
-        },
-        "not": {
-          "required": [
-            "warning",
-            "sliceWarning"
-          ]
         }
       },
       "EditorCharacterAnimationGenerationRequest": {