合并主分支并修复画布快速编辑冲突

同步主分支的共享画布、游戏创作资源编辑与完美像素合同。\n保留图片快速编辑业务引用、正向白名单与任务快照门禁。\n修复共享画布普通图片类型、完美像素幂等和游戏创作特例融合回归。\n合并后端契约与项目决策记录，并通过本地完整 CI。

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

@@ -3284,7 +3284,7 @@
               "none",
               "pixelArt"
             ],
-            "description": "可选生成风格，当前识别 none 与 pixelArt。省略、null、空字符串或 none 按无风格处理，提交给 provider 的提示词与未带该字段时逐字一致；pixelArt 仅支持普通图片（kind 省略）和 character，会在提示词末尾追加一行像素风约束（普通图片为「画面为像素风格」，character 为「角色主体为像素风格」）并在回图后执行像素规整。未知字符串或不支持该风格的 kind 按 none 继续生成并返回 unsupported-image-style 告警；非字符串值返回 400。"
+            "description": "可选生成风格，当前识别 none 与 pixelArt。省略、null、空字符串或 none 按无风格处理，提交给 provider 的提示词与未带该字段时逐字一致；pixelArt 仅支持普通图片（kind 省略）和 character，会在提示词末尾追加一行像素风约束（普通图片为「画面为像素风格」，character 为「角色主体为像素风格」）并在回图后执行像素规整。规整成功时直接持久化一格一像素的逻辑分辨率 PNG，不恢复到 size、imageSize、provider 回图或 canvasCompletion.placeholder 的尺寸；width/height 及关联 resource/asset 尺寸均为最终 PNG 的实际值。未知字符串或不支持该风格的 kind 按 none 继续生成并返回 unsupported-image-style 告警；非字符串值返回 400。"
           },
           "size": {
             "type": "string",
@@ -3396,7 +3396,7 @@
                 "type": "null"
               }
             ],
-            "description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
+            "description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。placeholder 只参与占位与完成落点，不约束最终媒体像素尺寸；pixelArt 规整成功时结果图层使用最终逻辑分辨率 PNG 的实际尺寸。"
           }
         },
         "additionalProperties": false
@@ -3579,11 +3579,13 @@
           },
           "width": {
             "type": "integer",
-            "minimum": 1
+            "minimum": 1,
+            "description": "最终持久化 PNG 的实际像素宽度；pixelArt 规整成功时为逻辑网格宽度，不保证等于 size、imageSize、provider 回图或画布 placeholder 宽度。"
           },
           "height": {
             "type": "integer",
-            "minimum": 1
+            "minimum": 1,
+            "description": "最终持久化 PNG 的实际像素高度；pixelArt 规整成功时为逻辑网格高度，不保证等于 size、imageSize、provider 回图或画布 placeholder 高度。"
           },
           "sourceType": {
             "type": "string",
@@ -3699,7 +3701,7 @@
               "none",
               "pixelArt"
             ],
-            "description": "可选生成风格，当前识别 none 与 pixelArt。省略、null、空字符串或 none 按无风格处理，提交给 provider 的提示词与未带该字段时逐字一致；pixelArt 会在提示词末尾追加一行「每个图标素材均为像素风格」并启用图标图集像素规整。未知字符串按 none 继续生成并返回 unsupported-image-style 告警；非字符串值返回 400。"
+            "description": "可选生成风格，当前识别 none 与 pixelArt。省略、null、空字符串或 none 按无风格处理，提交给 provider 的提示词与未带该字段时逐字一致；pixelArt 会在提示词末尾追加一行「每个图标素材均为像素风格」并启用图标图集像素规整。规整成功时直接持久化一格一像素的逻辑分辨率透明 PNG，不恢复到 imageSize、provider 回图或 canvasCompletion.placeholder 的尺寸；spritesheetWidth/spritesheetHeight 及关联 resource/asset 尺寸均为最终 PNG 的实际值。未知字符串按 none 继续生成并返回 unsupported-image-style 告警；非字符串值返回 400。"
           },
           "model": {
             "type": "string",
@@ -3757,7 +3759,7 @@
                 "type": "null"
               }
             ],
-            "description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
+            "description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。placeholder 只参与占位与完成落点，不约束最终媒体像素尺寸；pixelArt 规整成功时结果图层使用最终逻辑分辨率 PNG 的实际尺寸。"
           }
         },
         "additionalProperties": false
@@ -3920,7 +3922,7 @@
               "unsupported-image-style",
               "multiple-generation-warnings"
             ],
-            "description": "生成成功但后处理发生非阻断降级时的稳定原因码。"
+            "description": "生成成功但后处理发生非阻断降级时的稳定原因码。dimension-restore-fallback 只描述进入可选 pixelArt 处理前的交付尺寸归一结果：无法安全归一时，在该处理边界保留 provider 回图尺寸；它不描述或约束 pixelArt 成功后的最终尺寸，最终产物尺寸仍以逻辑分辨率 PNG 为准。"
           },
           "reason": {
             "type": "string",
@@ -3946,11 +3948,13 @@
           },
           "spritesheetWidth": {
             "type": "integer",
-            "minimum": 1
+            "minimum": 1,
+            "description": "最终持久化 spritesheet PNG 的实际像素宽度；pixelArt 规整成功时为逻辑网格宽度，不保证等于 imageSize、provider 回图或画布 placeholder 宽度。"
           },
           "spritesheetHeight": {
             "type": "integer",
-            "minimum": 1
+            "minimum": 1,
+            "description": "最终持久化 spritesheet PNG 的实际像素高度；pixelArt 规整成功时为逻辑网格高度，不保证等于 imageSize、provider 回图或画布 placeholder 高度。"
           },
           "iconImageSrcs": {
             "type": "array",
@@ -4949,7 +4953,7 @@
           }
         },
         "additionalProperties": true,
-        "description": "其它生成类型或历史结果的兼容 compact result。背景音乐（audioKind=background-music）与不带 audioKind 的图片、视频、图标序列帧、角色动作和 UI 拆解结果都落在这里。该 fallback 明确排除 audioKind=sound-effect，避免吞掉 SFX 专用分支。"
+        "description": "其它生成类型或历史结果的兼容 compact result。背景音乐（audioKind=background-music）与不带 audioKind 的图片、视频、图标序列帧、角色动作和 UI 拆解结果都落在这里。pixelArt 图片的 width/height、图标结果的 spritesheetWidth/spritesheetHeight 及关联 resource/asset 尺寸均表示最终逻辑分辨率 PNG 的实际值，不保证等于请求档位、provider 回图或画布 placeholder。该 fallback 明确排除 audioKind=sound-effect，避免吞掉 SFX 专用分支。"
       },
       "ExternalEditorGenerationCompletedResult": {
         "oneOf": [