新增图集连通域与可配置网格切分

增加 connected-components 与 grid 切分模式

支持 gridX/gridY 并同步 API、MCP、Skill、AGC 客户端

移除固定 2x2 图集切分契约与文档

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

@@ -3370,16 +3370,32 @@
               "maxLength": 200
             }
           },
-          "sliceLayout": {
+          "sliceMode": {
             "type": "string",
-            "deprecated": true,
-            "description": "历史兼容字段，新的调用请使用 sliceCount。"
+            "enum": [
+              "connected-components",
+              "grid"
+            ],
+            "default": "connected-components",
+            "description": "图集切分模式。connected-components 按透明像素 alpha 连通域识别独立素材；grid 按用户提供的 gridX/gridY 划分网格槽。省略时使用 connected-components。"
+          },
+          "gridX": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 32,
+            "description": "grid 模式的横向网格数量。"
+          },
+          "gridY": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 32,
+            "description": "grid 模式的纵向网格数量。"
           },
           "sliceCount": {
             "type": "integer",
             "minimum": 1,
             "maximum": 100,
-            "description": "可选的目标切片数量；省略时按图像内容自动识别。"
+            "description": "connected-components 模式下可选的目标切片数量；省略时按图像内容自动识别。grid 模式的切片数量由 gridX×gridY 决定。"
           },
           "screenColor": {
             "type": ["string", "null"],
@@ -3603,15 +3619,28 @@
           },
           "iconImageSrcs": {
             "type": "array",
-            "description": "识别图集中有效 alpha 连通域并持久化的独立素材，按视觉阅读顺序命名为“素材 N”；可通过 sliceCount 指定目标数量。",
+            "description": "按 sliceMode 识别或裁切并持久化的独立素材，按视觉阅读顺序命名为“素材 N”；connected-components 模式可通过 sliceCount 指定目标数量。",
             "items": {
               "$ref": "#/components/schemas/EditorIconSpritesheetIconResult"
             }
           },
-          "sliceLayout": {
+          "sliceMode": {
             "type": "string",
-            "deprecated": true,
-            "description": "历史兼容字段。"
+            "enum": [
+              "connected-components",
+              "grid"
+            ],
+            "description": "实际采用的图集切分模式。"
+          },
+          "gridX": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 32
+          },
+          "gridY": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 32
           },
           "sliceCount": {
             "type": "integer",
@@ -3628,7 +3657,7 @@
                 "type": "null"
               }
             ],
-            "description": "可信透明图集已成功持久化，但全连通域自动拆分未完成时返回；此时 iconImageSrcs 为空，调用方仍应使用整张图集。原始连通域、输出数量或 CPU 预算超限不会产生切片 PUT、资源或画布切片。透明处理、Alpha/尺寸恢复、provider 原图修复性回读或透明图完整解码失败时走 provider 原图 source-only，sliceWarning 为 null。"
+            "description": "可信透明图集已成功持久化，但所选 sliceMode 的自动拆分未完成时返回；此时 iconImageSrcs 为空，调用方仍应使用整张图集。原始连通域、输出数量、网格裁切或 CPU 预算超限不会产生切片 PUT、资源或画布切片。透明处理、Alpha/尺寸恢复、provider 原图修复性回读或透明图完整解码失败时走 provider 原图 source-only，sliceWarning 为 null。"
           },
           "prompt": {
             "type": "string"

docs/【编辑器】画板图标素材生成入口设计-2026-06-15.md

@@ -40,6 +40,7 @@
 ## 生成契约
 
 - 前端提交到 `POST /api/editor/icon-spritesheets/generations`。
+- 图集拆分通过 `sliceMode` 显式选择：`connected-components` 按透明像素连通域切分（默认），`grid` 按用户提供的 `gridX × gridY` 网格切分。
 - 图标规范生成在 inline 模式下也必须先建立带稳定请求指纹的 generation operation，并由编辑器生成 durable billing 边界包住共享执行器；不得在 `operation=None` 时调用 provider 后再进入原子结果持久化。
 - 图标 spritesheet 的入队与实际执行路径都必须在引用解析、generation input 重建、定价和 provider / OSS 副作用之前预检 owner、项目和最终素材目录，并将返回的 canonical `projectId + assetFolderId` 回写到后续流程；请求省略目录时按实际写入的 owner 默认目录预检，worker 不得只信任入队时的旧校验结果。
 - queued 图标规范生成由共享原子结果持久化使用 worker caller 中的 lease 一并完成任务并清理 lease；共享执行器返回成功后 worker 只能返回 `Ok(())`，不得再次调用 job completion。