refactor(core): 实现统一参数架构并修复运行时参数丢失问题

## 核心变更

### 🔧 关键Bug修复
- 修复LLM/Image服务运行时自定义参数丢失问题
- prepareRuntimeConfig()现在支持customParamOverrides向后兼容
- 确保用户配置的自定义API头、私有开关等参数不会在运行时丢失

### 🏗️ 统一参数架构
- 新增parameter-schema.ts: 统一参数定义与安全验证
- 新增parameter-utils.ts: 参数合并、验证、拆分工具
- 实现优先级参数合并: requestOverrides > customOverrides > builtInOverrides > defaults
- 安全过滤危险参数键(__proto__, apiKey, secret等)

### 📦 服务层改进
- llm/service.ts: 添加prepareRuntimeConfig()方法支持参数迁移
- image/service.ts: 同步实现参数迁移逻辑
- model/manager.ts: 添加读时迁移和弃用警告
- 所有Adapter统一使用UnifiedParameterDefinition

### 🎨 UI组件更新
- 新增ModelParameterEditor.vue: 统一参数编辑器
- 新增ModelAdvancedSection.vue: 高级参数折叠面板
- 简化TextModelEditModal和ImageModelEditModal逻辑
- 支持类型安全的参数编辑(number, boolean, string, select等)

### ✅ 测试覆盖
- 新增parameter-schema.test.ts: 参数定义验证测试
- 新增parameter-utils.test.ts: 参数工具函数测试
- 新增custom-params-migration.test.ts: 参数迁移全流程测试
- 修复anthropic-adapter和gemini-adapter测试以匹配新架构
- 所有582个测试通过(100%通过率)

## 向后兼容性
- 完全兼容旧格式配置(customParamOverrides独立字段)
- 读时自动迁移,写时清理已弃用字段
- 保留customParamOverrides以防版本回退

## 破坏性变更
- 无(完全向后兼容)

## 文档更新
- advancedParameterDefinitions.ts添加弃用说明
- 标注v3.0弃用,v4.0移除计划

Author: linshenkx

packages/core/src/index.ts

@@ -41,6 +41,8 @@ export * from './services/llm/errors'
 export { ModelManager, createModelManager } from './services/model/manager'
 export * from './services/model/types'
 export * from './services/model/defaults'
+export * from './services/model/parameter-schema'
+export * from './services/model/parameter-utils'
 export * from './services/model/advancedParameterDefinitions'
 export { ElectronModelManagerProxy } from './services/model/electron-proxy'
 export { ElectronConfigManager, isElectronRenderer } from './services/model/electron-config'

packages/core/src/services/image-model/defaults.ts

@@ -46,7 +46,8 @@ export function getDefaultImageModels(registry: IImageAdapterRegistry): Record<s
       modelId,
       enabled,
       connectionConfig,
-      paramOverrides,
+      paramOverrides: paramOverrides ?? {},
+      customParamOverrides: {},
       provider,
       model
     }

packages/core/src/services/image-model/manager.ts

@@ -92,14 +92,20 @@ export class ImageModelManager implements IImageModelManager {
     const completeConfig = this.ensureSelfContained(config)
     this.validateConfig(completeConfig)
 
+    // 保存时移除 customParamOverrides（已合并到 paramOverrides）
+    const toStore = {
+      ...completeConfig,
+      customParamOverrides: undefined
+    }
+
     await this.storage.updateData<Record<string, ImageModelConfig>>(
       this.storageKey,
       (current) => {
         const data = current || {}
-        if (data[completeConfig.id]) {
-          throw new Error(`Configuration with id '${completeConfig.id}' already exists`)
+        if (data[toStore.id]) {
+          throw new Error(`Configuration with id '${toStore.id}' already exists`)
         }
-        return { ...data, [completeConfig.id]: { ...completeConfig } }
+        return { ...data, [toStore.id]: toStore }
       }
     )
   }
@@ -122,7 +128,14 @@ export class ImageModelManager implements IImageModelManager {
         // 确保更新后的配置是自包含的
         const completeConfig = this.ensureSelfContained(updated)
         this.validateConfig(completeConfig)
-        return { ...data, [id]: completeConfig }
+
+        // 保存时移除 customParamOverrides（已合并到 paramOverrides）
+        const toStore = {
+          ...completeConfig,
+          customParamOverrides: undefined
+        }
+
+        return { ...data, [id]: toStore }
       }
     )
   }
@@ -160,13 +173,16 @@ export class ImageModelManager implements IImageModelManager {
       ;(cfg as any).id = id
     }
 
+    // 读时迁移：合并 customParamOverrides 到 paramOverrides
+    const migrated = this.migrateConfig(cfg)
+
     // 尝试修复损坏的配置，确保能够正常读取和删除
     try {
-      return this.ensureSelfContained(cfg)
+      return this.ensureSelfContained(migrated)
     } catch (error) {
       // 即使修复失败，也返回配置（已在ensureSelfContained中标记为disabled）
       console.warn(`[ImageModelManager] Failed to fully repair config ${id}, but returning for deletion:`, error)
-      return cfg
+      return migrated
     }
   }
 
@@ -183,14 +199,17 @@ export class ImageModelManager implements IImageModelManager {
       // 始终使用存储键作为公开的 id，保持删除等操作一致
       ;(cfg as any).id = key
 
+      // 读时迁移：合并 customParamOverrides 到 paramOverrides
+      const migrated = this.migrateConfig(cfg)
+
       // 尝试修复配置，如果失败则返回占位配置（标记为disabled）
       try {
-        return this.ensureSelfContained(cfg)
+        return this.ensureSelfContained(migrated)
       } catch (error) {
         console.warn(`[ImageModelManager] Failed to repair config ${key}, returning placeholder:`, error)
         // 返回最小占位配置，确保能在UI中显示和删除
         return {
-          ...cfg,
+          ...migrated,
           id: key,
           enabled: false
         } as ImageModelConfig
@@ -273,6 +292,27 @@ export class ImageModelManager implements IImageModelManager {
 
   // === 私有辅助方法 ===
 
+  /**
+   * 迁移配置：合并 customParamOverrides 到 paramOverrides
+   * 用于向后兼容读取旧数据格式
+   */
+  private migrateConfig(config: ImageModelConfig): ImageModelConfig {
+    // 如果没有 customParamOverrides，直接返回
+    if (!config.customParamOverrides || Object.keys(config.customParamOverrides).length === 0) {
+      return config
+    }
+
+    // 合并 customParamOverrides 到 paramOverrides
+    return {
+      ...config,
+      paramOverrides: {
+        ...(config.paramOverrides || {}),
+        ...(config.customParamOverrides || {})
+      }
+      // 保留 customParamOverrides 字段以防版本回退，但新代码不再使用
+    }
+  }
+
   // 确保配置是自包含的（包含完整的provider和model信息）
   private ensureSelfContained(config: ImageModelConfig): ImageModelConfig {
     // 如果已经有完整的自包含字段，直接返回
@@ -297,7 +337,8 @@ export class ImageModelManager implements IImageModelManager {
       return {
         ...config,
         provider,
-        model
+        model,
+        paramOverrides: config.paramOverrides ?? {}
       }
     } catch (error) {
       // 对于无法修复的旧配置，创建占位数据并禁用，允许用户查看和删除
@@ -326,7 +367,8 @@ export class ImageModelManager implements IImageModelManager {
           },
           parameterDefinitions: [],
           defaultParameterValues: {}
-        }
+        },
+        paramOverrides: config.paramOverrides ?? {}
       } as ImageModelConfig
     }
   }
@@ -373,6 +415,12 @@ export class ImageModelManager implements IImageModelManager {
       }
     }
 
+    if (config.customParamOverrides !== undefined) {
+      if (typeof config.customParamOverrides !== 'object' || config.customParamOverrides === null) {
+        errors.push('customParamOverrides must be an object')
+      }
+    }
+
     // 验证提供商是否存在
     try {
       this.registry.getAdapter(config.providerId)

packages/core/src/services/image/service.ts

@@ -1,6 +1,7 @@
 import { IImageModelManager, ImageRequest, ImageResult, IImageService, IImageAdapterRegistry, ImageModelConfig, ImageModel } from './types'
 import { createImageAdapterRegistry } from './adapters/registry'
 import { RequestConfigError } from '../llm/errors'
+import { mergeOverrides } from '../model/parameter-utils'
 
 export class ImageService implements IImageService {
   private readonly registry: IImageAdapterRegistry
@@ -94,10 +95,12 @@ export class ImageService implements IImageService {
 
     // 获取适配器
     const adapter = this.registry.getAdapter(config.providerId)
+    const runtimeConfig = this.prepareRuntimeConfig(config)
+    const runtimeRequest = this.prepareRuntimeRequest(request, runtimeConfig)
 
     try {
       // 调用适配器生成
-      const result = await adapter.generate(request, config)
+      const result = await adapter.generate(runtimeRequest, runtimeConfig)
 
       // 确保返回结果包含完整的元数据
       if (!result.metadata) {
@@ -125,18 +128,58 @@ export class ImageService implements IImageService {
   async testConnection(config: ImageModelConfig): Promise<ImageResult> {
     // 构造一个最小的请求（根据模型能力选择文本或图像测试）
     const adapter = this.registry.getAdapter(config.providerId)
+    const runtimeConfig = this.prepareRuntimeConfig(config)
     const caps = (config.model?.capabilities) || this.registry.getStaticModels(config.providerId).find(m => m.id === config.modelId)?.capabilities || { text2image: true }
     const testType: 'text2image' | 'image2image' = caps.text2image ? 'text2image' : 'image2image'
     const baseReq: any = (adapter as any).getTestImageRequest ? (adapter as any).getTestImageRequest(testType) : { prompt: 'hello', count: 1 }
     const request: ImageRequest = { ...baseReq, configId: config.id || 'test' }
+    const runtimeRequest = this.prepareRuntimeRequest(request, runtimeConfig)
     // 直接调用适配器，绕过 imageModelManager 的存储查找
-    return await adapter.generate(request, config)
+    return await adapter.generate(runtimeRequest, runtimeConfig)
   }
 
   // 新增：获取动态模型
   async getDynamicModels(providerId: string, connectionConfig: Record<string, any>): Promise<ImageModel[]> {
     return await this.registry.getDynamicModels(providerId, connectionConfig)
   }
+
+  private prepareRuntimeConfig(config: ImageModelConfig): ImageModelConfig {
+    const schema = config.model?.parameterDefinitions ?? []
+
+    // 合并参数：支持旧格式的 customParamOverrides（向后兼容）
+    // 优先级：requestOverrides > customOverrides
+    const mergedOverrides = mergeOverrides({
+      schema,
+      includeDefaults: false,
+      customOverrides: config.customParamOverrides,  // 🔧 兼容旧格式：自定义参数
+      requestOverrides: config.paramOverrides        // 当前参数（包含内置 + 可能已合并的自定义）
+    })
+
+    return {
+      ...config,
+      paramOverrides: mergedOverrides
+    }
+  }
+
+  private prepareRuntimeRequest(request: ImageRequest, config: ImageModelConfig): ImageRequest {
+    const schema = config.model?.parameterDefinitions ?? []
+
+    // 请求级别的参数覆盖，同样需要考虑旧格式
+    const sanitized = mergeOverrides({
+      schema,
+      includeDefaults: false,
+      customOverrides: (request as any).customParamOverrides, // 兼容旧字段（向后兼容）
+      requestOverrides: request.paramOverrides
+    })
+
+    const normalizedOverrides =
+      Object.keys(sanitized).length > 0 ? sanitized : undefined
+
+    return {
+      ...request,
+      paramOverrides: normalizedOverrides
+    }
+  }
 }
 
 export const createImageService = (imageModelManager: IImageModelManager, registry?: IImageAdapterRegistry) => new ImageService(imageModelManager, registry)

packages/core/src/services/image/types.ts

@@ -1,21 +1,12 @@
 import { IImportExportable } from '../../interfaces/import-export'
+import type { UnifiedParameterDefinition } from '../model/parameter-schema'
 
 // === 图像参数定义 ===
 
-export interface ImageParameterDefinition {
-  name: string                    // SDK 参数名，如 "size", "guidance_scale"
-  labelKey: string               // UI 文案 i18n key，如 "params.size.label"
-  descriptionKey: string         // UI 描述 i18n key，如 "params.size.description"
-  type: 'number' | 'integer' | 'boolean' | 'string'
-  defaultValue?: unknown
-  minValue?: number
-  maxValue?: number
-  step?: number
-  allowedValues?: string[]       // 枚举值，如 ["1024x1024", "768x1024"]
+export interface ImageParameterDefinition extends UnifiedParameterDefinition {
+  labelKey: string                // UI 文案 i18n key，如 "params.size.label"
+  descriptionKey: string          // UI 描述 i18n key，如 "params.size.description"
   allowedValueLabelKeys?: string[] // 枚举值的 i18n keys
-  unit?: string                  // 单位，如 "px", "steps"
-  unitKey?: string              // 单位的 i18n key
-  required?: boolean            // 是否必填
 }
 
 // === 核心架构类型（三层分离：Provider → Model → Configuration） ===
@@ -74,8 +65,15 @@ export interface ImageModelConfig {
     [key: string]: any                   // 支持其他连接参数（如 organization, region 等）
   }
 
-  // 参数覆盖（可选）
-  paramOverrides?: Record<string, unknown> // 覆盖模型默认参数
+  // 参数覆盖（统一字段）
+  paramOverrides?: Record<string, unknown> // 覆盖模型默认参数（包含内置和自定义参数）
+
+  /**
+   * @deprecated 已废弃，将在 v3.0 移除
+   * 旧版本的自定义参数字段，现已合并到 paramOverrides
+   * 仅用于向后兼容读取旧数据，新代码不应使用此字段
+   */
+  customParamOverrides?: Record<string, unknown>
 
   // 自包含数据（新增）
   provider: ImageProvider              // 完整的提供商信息副本