重构图标规范与图集生成链路

新增图标规范独立队列任务并将参数补全纳入统一计费操作
将图标图集生成和手工拆分迁入独立图标模块并复用公共生图能力
将图标规范引用收紧为项目资源或素材 ID
同步 SpacetimeDB 引用解析契约、External OpenAPI、前端与 Agent 提交链路
补充相关回归测试和长期架构约定

src/services/image-editor/editorProjectClient.test.ts

@@ -900,7 +900,7 @@ describe('editorProjectClient', () => {
     ).rejects.toThrow('生成参考图最多允许 5 张');
     await expect(
       generateEditorIconSpritesheet({
-        referenceImageSrc: '/generated-images/editor/spec.png',
+        referenceId: 'editor-resource-spec',
         referenceImageSrcs: references.slice(0, 5),
         iconDescriptions: ['返回按钮'],
         model: 'gpt-image-2',
@@ -935,7 +935,7 @@ describe('editorProjectClient', () => {
     );
 
     await generateEditorIconSpritesheet({
-      referenceImageSrc: '/generated-images/editor/icon-spec.png',
+      referenceId: 'editor-resource-icon-spec',
       referenceImageSrcs: references,
       iconDescriptions: ['返回按钮'],
     });
@@ -1118,7 +1118,7 @@ describe('editorProjectClient', () => {
     });
 
     const result = await generateEditorIconSpritesheet({
-      referenceImageSrc: '/generated-images/editor/spec.png',
+      referenceId: 'editor-resource-spec',
       referenceImageSrcs: ['/generated-images/editor/icon-ref.png'],
       iconDescriptions: ['返回按钮', '设置按钮'],
       assetLabel: '冒险游戏图标',
@@ -1135,7 +1135,7 @@ describe('editorProjectClient', () => {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
-          referenceImageSrc: '/generated-images/editor/spec.png',
+          referenceId: 'editor-resource-spec',
           referenceImageSrcs: ['/generated-images/editor/icon-ref.png'],
           iconDescriptions: ['返回按钮', '设置按钮'],
           model: 'gemini-3.1-flash-image-preview',
@@ -1164,7 +1164,7 @@ describe('editorProjectClient', () => {
     });
 
     await generateEditorIconSpritesheet({
-      referenceImageSrc: '/generated-images/editor/spec.png',
+      referenceId: 'editor-resource-spec',
       iconDescriptions: ['返回按钮'],
       model: 'gpt-image-2',
       screenColor: '#E6D8FF',
@@ -1186,7 +1186,7 @@ describe('editorProjectClient', () => {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
-          referenceImageSrc: '/generated-images/editor/spec.png',
+          referenceId: 'editor-resource-spec',
           iconDescriptions: ['返回按钮'],
           model: 'gpt-image-2',
           screenColor: '#E6D8FF',
@@ -1452,20 +1452,6 @@ describe('editorProjectClient', () => {
     expect(requestJsonMock).not.toHaveBeenCalled();
   });
 
-  it('rejects excess icon spec references before dispatch', async () => {
-    await expect(
-      generateEditorIconSpec({
-        playSetting: '回合制占点',
-        artStyle: '低多边形',
-        referenceImageSrcs: Array.from(
-          { length: 6 },
-          (_, index) => `resource-reference-${index + 1}`,
-        ),
-      }),
-    ).rejects.toThrow('图标规范参考图最多允许 5 张，当前选择 6 张');
-    expect(requestJsonMock).not.toHaveBeenCalled();
-  });
-
   it('submits icon spec business fields without a client prompt or image kind', async () => {
     requestJsonMock.mockResolvedValueOnce({
       imageSrc: 'data:image/png;base64,spec',
@@ -1476,7 +1462,7 @@ describe('editorProjectClient', () => {
     await generateEditorIconSpec({
       playSetting: '回合制占点',
       artStyle: '低多边形',
-      referenceImageSrcs: ['resource-reference-1'],
+      referenceId: 'resource-reference-1',
       projectId: 'editor-project-1',
       generationInputs: {
         fields: [],
@@ -1498,7 +1484,7 @@ describe('editorProjectClient', () => {
     expect(body).toEqual({
       playSetting: '回合制占点',
       artStyle: '低多边形',
-      referenceImageSrcs: ['resource-reference-1'],
+      referenceId: 'resource-reference-1',
       projectId: 'editor-project-1',
       generationInputs: {
         fields: [],