合并主分支

同步主线图标规范、生成参数恢复与统一画布生成链路

保留快速编辑的权威引用 ID、素材类型门禁与目标对象一致性校验

补齐 SpacetimeDB 引用解析、V2 引用槽位与相关测试门禁

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

@@ -3651,29 +3651,32 @@
       "EditorIconSpritesheetGenerationRequest": {
         "type": "object",
         "required": [
-          "referenceImageSrc",
+          "referenceId",
           "iconDescriptions"
         ],
         "properties": {
-          "referenceImageSrc": {
+          "referenceId": {
             "type": "string",
-            "description": "图标规范的稳定引用：当前账号的 objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。"
+            "description": "当前账号中已登记为 icon-spec 的项目资源 ID 或素材 ID。只接受 ID，不接受 objectKey、图片 URL、Data URL 或 Blob URL。"
           },
           "referenceImageSrcs": {
             "type": "array",
             "items": {
               "type": "string",
-              "description": "额外图标素材参考图的稳定引用：objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。referenceImageSrc 占用 1 张 provider 容量，因此 gpt-image-2 最多再提交 4 张、nanobanana2 最多再提交 8 张；超限返回 400，不会静默截断。"
+              "description": "额外图标素材参考图的稳定引用：objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。referenceId 占用 1 张 provider 容量，因此 gpt-image-2 最多再提交 4 张、nanobanana2 最多再提交 8 张；超限返回 400，不会静默截断。"
             },
             "maxItems": 8
           },
           "iconDescriptions": {
             "type": "array",
-            "description": "图标生成需求文本数组，供 prompt 组装使用；数组长度不控制自动切片数量。画布前端把完整用户提示词作为唯一数组元素提交；其它调用方可继续提交 1 到 100 条非空文本。",
+            "description": "图标生成需求文本数组，供 prompt 组装使用；数组长度不控制自动切片数量。画布前端把完整用户提示词作为唯一数组元素提交；其它调用方可继续提交 1 到 100 条非空文本。服务端去空并以换行拼接后，单条最多 200 个 Unicode 字符，合计最多 2000 个 Unicode 字符且不超过 6144 个 UTF-8 字节；超限同步返回 400，不会入队或计费。",
             "minItems": 1,
             "maxItems": 100,
+            "x-genarrative-maxTotalCharacters": 2000,
+            "x-genarrative-maxTotalUtf8Bytes": 6144,
             "items": {
-              "type": "string"
+              "type": "string",
+              "maxLength": 200
             }
           },
           "screenColor": {