dsh-audiogen 0.4.0 → 0.4.1

package/src/agent-audio-tools.ts

@@ -33,6 +33,14 @@ interface SavedAudioRef extends AgentAudioRef {
   file: string
 }
 
+/** Per-model group in a multi-model comparison result. */
+interface AgentAudioGroup {
+  model: string
+  audio: AgentAudioRef[]
+  resources?: string[]
+  error?: string
+}
+
 interface AgentAudioResult {
   status: string
   message: string
@@ -41,6 +49,8 @@ interface AgentAudioResult {
   audio: AgentAudioRef[]
   /** Resource-library entry ids when the audio was saved to the library. */
   resources?: string[]
+  /** Per-model results when several models were generated with the same prompt. */
+  groups?: AgentAudioGroup[]
   error?: string
 }
 
@@ -56,6 +66,17 @@ const audioRefSchema = {
   },
 } as const
 
+const groupSchema = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    model: { type: 'string', required: true },
+    audio: { type: 'array', required: true, items: audioRefSchema },
+    resources: { type: 'array', items: { type: 'string' } },
+    error: { type: 'string' },
+  },
+} as const
+
 const resultSchema = {
   type: 'object',
   additionalProperties: false,
@@ -66,6 +87,7 @@ const resultSchema = {
     model: { type: 'string', required: true },
     audio: { type: 'array', required: true, items: audioRefSchema },
     resources: { type: 'array', items: { type: 'string' } },
+    groups: { type: 'array', items: groupSchema },
     error: { type: 'string' },
   },
 } as const
@@ -120,6 +142,16 @@ export function registerAgentAudioTools(ctx: Context, resolve: () => AgentAudioT
       prompt: { type: 'string', required: true, description: 'For tts, the text to speak. For music/sfx, a descriptive prompt.' },
       mode: { type: 'string', enum: ['tts', 'music', 'sfx', 'voice_design'], description: 'Generation mode. Defaults to tts.' },
       model: { type: 'string', description: 'One of the configured audio models/voices. Defaults to the first configured model.' },
+      models: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'Optional: several configured model aliases to generate the SAME prompt with each one, sequentially, for comparison (e.g. ["speech-2.8-hd","speech-2.6-hd"]). Cannot be combined with model; when present, models wins.',
+      },
+      model_params: {
+        type: 'object',
+        additionalProperties: true,
+        description: 'Optional per-model parameter overrides used with "models" (automatic by default = all models share the global params). Keys are model aliases; values are partial param objects using the same param names (format, duration, voice, speed, emotion, vol, pitch, sample_rate, bitrate, lyrics, is_instrumental, loop, prompt_influence, seed, steps, cfg_scale, subtitle_enable, aigc_watermark, language_boost, pronunciation_tone, voice_modify, timbre_weights). Unset fields fall back to the global values.',
+      },
       voice: { type: 'string', description: 'Optional voice id/name for TTS providers. Required for MiniMax TTS (e.g. male-qn-qingse, female-shaonv); fetch the account voices in Settings > Plugins > AI Audio.' },
       preview_text: { type: 'string', description: 'Optional preview text for voice_design.' },
       speed: { type: 'number', description: 'Optional speaking rate / speed multiplier where supported. MiniMax range 0.5-2.0 (default 1).' },
@@ -163,10 +195,9 @@ export function registerAgentAudioTools(ctx: Context, resolve: () => AgentAudioT
           type: 'object',
           additionalProperties: false,
           properties: {
-            voice_id: { type: 'string' },
-            weight: { type: 'integer' },
+            voice_id: { type: 'string', required: true },
+            weight: { type: 'integer', required: true },
           },
-          required: ['voice_id', 'weight'],
         },
         description: 'MiniMax TTS dual-voice blend weights (timbre_weights).',
       },
@@ -185,170 +216,245 @@ export function registerAgentAudioTools(ctx: Context, resolve: () => AgentAudioT
     async execute(args, exec) {
       const config = resolve()
       ensureConfigured(config)
-      const mode = args.mode === 'music' ? 'music' : args.mode === 'sfx' ? 'sfx' : args.mode === 'voice_design' ? 'voice_design' : 'tts'
-      const picked = mode === 'voice_design'
-        ? (() => {
-          const usable = config.channels.filter(channel => channel.apiUrl.trim() !== '' && channel.apiKey.trim() !== '')
-          const target = usable.find(channel => channel.id === config.defaultChannelId) ?? usable[0]
-          if (target === undefined) throw new AudioGenError('No usable audio channel is configured for voice design.', 'no-channel-available')
-          return { channel: target, alias: '', upstream: '' }
-        })()
-        : resolveModel(config, args.model)
-      const voiceModify = typeof args.voice_modify === 'object' && args.voice_modify !== null
-        ? (() => {
-          const raw = args.voice_modify as Record<string, unknown>
-          const out: { pitch?: number; intensity?: number; timbre?: number; soundEffects?: string } = {}
-          if (typeof raw.pitch === 'number') out.pitch = raw.pitch
-          if (typeof raw.intensity === 'number') out.intensity = raw.intensity
-          if (typeof raw.timbre === 'number') out.timbre = raw.timbre
-          if (typeof raw.sound_effects === 'string' && raw.sound_effects.trim() !== '') out.soundEffects = raw.sound_effects.trim()
-          return Object.keys(out).length > 0 ? out : undefined
-        })()
-        : undefined
-      const timbreWeights = Array.isArray(args.timbre_weights)
-        ? args.timbre_weights
-          .filter((item): item is { voice_id: string; weight: number } => typeof item === 'object' && item !== null && typeof (item as { voice_id?: unknown }).voice_id === 'string' && typeof (item as { weight?: unknown }).weight === 'number')
-          .map(item => ({ voiceId: (item.voice_id as string).trim(), weight: item.weight as number }))
-          .filter(item => item.voiceId !== '')
-        : undefined
-      const request: GenerateAudioRequest = {
-        mode,
-        model: picked.alias,
-        upstream: picked.upstream,
-        channelId: picked.channel.id,
-        channel: picked.channel.name,
-        prompt: args.prompt.trim(),
-        ...(typeof args.voice === 'string' && args.voice.trim() !== '' ? { voice: args.voice.trim() } : {}),
-        ...(typeof args.preview_text === 'string' && args.preview_text.trim() !== '' ? { previewText: args.preview_text.trim() } : {}),
-        ...(typeof args.speed === 'number' ? { speed: args.speed } : {}),
-        ...(typeof args.duration === 'number' ? { duration: args.duration } : {}),
-        ...(typeof args.lyrics === 'string' && args.lyrics.trim() !== '' ? { lyrics: args.lyrics.trim() } : {}),
-        ...(typeof args.is_instrumental === 'boolean' ? { isInstrumental: args.is_instrumental } : {}),
-        ...(typeof args.loop === 'boolean' ? { loop: args.loop } : {}),
-        ...(typeof args.prompt_influence === 'number' && Number.isFinite(args.prompt_influence) ? { promptInfluence: args.prompt_influence } : {}),
-        ...(typeof args.seed === 'number' && Number.isFinite(args.seed) ? { seed: args.seed } : {}),
-        ...(typeof args.steps === 'number' && Number.isFinite(args.steps) ? { steps: args.steps } : {}),
-        ...(typeof args.cfg_scale === 'number' && Number.isFinite(args.cfg_scale) ? { cfgScale: args.cfg_scale } : {}),
-        ...(typeof args.format === 'string' && args.format.trim() !== '' ? { format: args.format.trim() } : {}),
-        // ---- MiniMax TTS 专属字段 ----
-        ...(typeof args.emotion === 'string' && args.emotion.trim() !== '' ? { emotion: args.emotion.trim() } : {}),
-        ...(typeof args.vol === 'number' && Number.isFinite(args.vol) ? { vol: args.vol } : {}),
-        ...(typeof args.pitch === 'number' && Number.isFinite(args.pitch) ? { pitch: args.pitch } : {}),
-        ...(typeof args.text_normalization === 'boolean' ? { textNormalization: args.text_normalization } : {}),
-        ...(typeof args.latex_read === 'boolean' ? { latexRead: args.latex_read } : {}),
-        ...(Array.isArray(args.pronunciation_tone) && args.pronunciation_tone.length > 0
-          ? { pronunciationTone: args.pronunciation_tone.filter((item): item is string => typeof item === 'string' && item.trim() !== '').map((item: string) => item.trim()) }
-          : {}),
-        ...(typeof args.sample_rate === 'number' && Number.isFinite(args.sample_rate) ? { sampleRate: args.sample_rate } : {}),
-        ...(typeof args.bitrate === 'number' && Number.isFinite(args.bitrate) ? { bitrate: args.bitrate } : {}),
-        ...(typeof args.channel === 'number' && Number.isFinite(args.channel) ? { audioChannel: args.channel } : {}),
-        ...(typeof args.force_cbr === 'boolean' ? { forceCbr: args.force_cbr } : {}),
-        ...(typeof args.subtitle_enable === 'boolean' ? { subtitleEnable: args.subtitle_enable } : {}),
-        ...(typeof args.aigc_watermark === 'boolean' ? { aigcWatermark: args.aigc_watermark } : {}),
-        ...(typeof args.language_boost === 'string' && args.language_boost.trim() !== '' ? { languageBoost: args.language_boost.trim() } : {}),
-        ...(voiceModify !== undefined ? { voiceModify } : {}),
-        ...(timbreWeights !== undefined && timbreWeights.length > 0 ? { timbreWeights } : {}),
+      const mode: AudioMode = args.mode === 'music' ? 'music' : args.mode === 'sfx' ? 'sfx' : args.mode === 'voice_design' ? 'voice_design' : 'tts'
+      /** 把生成参数（snake_case 入参或 model_params 片段）映射为请求字段。 */
+      const mapParams = (raw: Record<string, unknown>): Partial<GenerateAudioRequest> => {
+        const voiceModify = typeof raw.voice_modify === 'object' && raw.voice_modify !== null
+          ? (() => {
+            const src = raw.voice_modify as Record<string, unknown>
+            const out: { pitch?: number; intensity?: number; timbre?: number; soundEffects?: string } = {}
+            if (typeof src.pitch === 'number') out.pitch = src.pitch
+            if (typeof src.intensity === 'number') out.intensity = src.intensity
+            if (typeof src.timbre === 'number') out.timbre = src.timbre
+            if (typeof src.sound_effects === 'string' && src.sound_effects.trim() !== '') out.soundEffects = src.sound_effects.trim()
+            return Object.keys(out).length > 0 ? out : undefined
+          })()
+          : undefined
+        const timbreWeights = Array.isArray(raw.timbre_weights)
+          ? raw.timbre_weights
+            .filter((item): item is { voice_id: string; weight: number } => typeof item === 'object' && item !== null && typeof (item as { voice_id?: unknown }).voice_id === 'string' && typeof (item as { weight?: unknown }).weight === 'number')
+            .map(item => ({ voiceId: (item.voice_id as string).trim(), weight: item.weight as number }))
+            .filter(item => item.voiceId !== '')
+          : undefined
+        const stringOrEmpty = (key: string): string | undefined => {
+          const value = raw[key]
+          return typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined
+        }
+        const finiteOrUndefined = (key: string): number | undefined => {
+          const value = raw[key]
+          return typeof value === 'number' && Number.isFinite(value) ? value : undefined
+        }
+        return {
+          ...(stringOrEmpty('voice') !== undefined ? { voice: stringOrEmpty('voice')! } : {}),
+          ...(stringOrEmpty('preview_text') !== undefined ? { previewText: stringOrEmpty('preview_text')! } : {}),
+          ...(finiteOrUndefined('speed') !== undefined ? { speed: finiteOrUndefined('speed')! } : {}),
+          ...(finiteOrUndefined('duration') !== undefined ? { duration: finiteOrUndefined('duration')! } : {}),
+          ...(stringOrEmpty('lyrics') !== undefined ? { lyrics: stringOrEmpty('lyrics')! } : {}),
+          ...(typeof raw.is_instrumental === 'boolean' ? { isInstrumental: raw.is_instrumental } : {}),
+          ...(typeof raw.loop === 'boolean' ? { loop: raw.loop } : {}),
+          ...(finiteOrUndefined('prompt_influence') !== undefined ? { promptInfluence: finiteOrUndefined('prompt_influence')! } : {}),
+          ...(finiteOrUndefined('seed') !== undefined ? { seed: finiteOrUndefined('seed')! } : {}),
+          ...(finiteOrUndefined('steps') !== undefined ? { steps: finiteOrUndefined('steps')! } : {}),
+          ...(finiteOrUndefined('cfg_scale') !== undefined ? { cfgScale: finiteOrUndefined('cfg_scale')! } : {}),
+          ...(stringOrEmpty('format') !== undefined ? { format: stringOrEmpty('format')! } : {}),
+          // ---- MiniMax / ElevenLabs / Stability 专属字段 ----
+          ...(stringOrEmpty('emotion') !== undefined ? { emotion: stringOrEmpty('emotion')! } : {}),
+          ...(finiteOrUndefined('vol') !== undefined ? { vol: finiteOrUndefined('vol')! } : {}),
+          ...(finiteOrUndefined('pitch') !== undefined ? { pitch: finiteOrUndefined('pitch')! } : {}),
+          ...(typeof raw.text_normalization === 'boolean' ? { textNormalization: raw.text_normalization } : {}),
+          ...(typeof raw.latex_read === 'boolean' ? { latexRead: raw.latex_read } : {}),
+          ...(Array.isArray(raw.pronunciation_tone) && raw.pronunciation_tone.length > 0
+            ? { pronunciationTone: raw.pronunciation_tone.filter((item): item is string => typeof item === 'string' && item.trim() !== '').map((item: string) => item.trim()) }
+            : {}),
+          ...(finiteOrUndefined('sample_rate') !== undefined ? { sampleRate: finiteOrUndefined('sample_rate')! } : {}),
+          ...(finiteOrUndefined('bitrate') !== undefined ? { bitrate: finiteOrUndefined('bitrate')! } : {}),
+          ...(finiteOrUndefined('channel') !== undefined ? { audioChannel: finiteOrUndefined('channel')! } : {}),
+          ...(typeof raw.force_cbr === 'boolean' ? { forceCbr: raw.force_cbr } : {}),
+          ...(typeof raw.subtitle_enable === 'boolean' ? { subtitleEnable: raw.subtitle_enable } : {}),
+          ...(typeof raw.aigc_watermark === 'boolean' ? { aigcWatermark: raw.aigc_watermark } : {}),
+          ...(stringOrEmpty('language_boost') !== undefined ? { languageBoost: stringOrEmpty('language_boost')! } : {}),
+          ...(voiceModify !== undefined ? { voiceModify } : {}),
+          ...(timbreWeights !== undefined && timbreWeights.length > 0 ? { timbreWeights } : {}),
+        }
       }
-      try {
-        const outputs = await generateAudio(picked.channel, request, exec.signal)
-        const audio: AgentAudioRef[] = []
-        const saved: SavedAudioRef[] = []
-        for (const [index, output] of outputs.entries()) {
-          const stored = await saveAudioFile(output.data, output.mime, `generated-${index + 1}`)
-          saved.push({
-            id: stored.id,
-            url: `/api/dsh-audiogen/audio/${encodeURIComponent(stored.file)}`,
-            file: stored.file,
-            mime: stored.mime,
-            bytes: stored.bytes,
-            ...(output.voiceId === undefined ? {} : { voiceId: output.voiceId }),
-          })
-          audio.push({
-            id: stored.id,
-            url: `/api/dsh-audiogen/audio/${encodeURIComponent(stored.file)}`,
-            mime: stored.mime,
-            bytes: stored.bytes,
-            ...(output.voiceId === undefined ? {} : { voiceId: output.voiceId }),
-          })
+      const buildRequest = (picked: { channel: AudioChannel; alias: string; upstream: string }): GenerateAudioRequest => {
+        const base = mapParams(args as unknown as Record<string, unknown>)
+        // 每模型参数覆盖（model_params[alias]）；缺省 = 自动沿用全局配置
+        let override: Partial<GenerateAudioRequest> = {}
+        if (typeof args.model_params === 'object' && args.model_params !== null) {
+          const perModel = (args.model_params as Record<string, unknown>)[picked.alias]
+          if (typeof perModel === 'object' && perModel !== null) override = mapParams(perModel as Record<string, unknown>)
         }
+        return {
+          mode,
+          model: picked.alias,
+          upstream: picked.upstream,
+          channelId: picked.channel.id,
+          channel: picked.channel.name,
+          prompt: typeof args.prompt === 'string' ? args.prompt.trim() : '',
+          ...base,
+          ...override,
+        }
+      }
+      /** 单模型执行：生成 + 保存文件 + 历史 + 可选资源库；错误收敛为分组结果。 */
+      const runOne = async (picked: { channel: AudioChannel; alias: string; upstream: string }): Promise<AgentAudioGroup> => {
+        const request = buildRequest(picked)
         try {
-          await appendHistory({
-            id: randomUUID(),
-            createdAt: Date.now(),
-            mode: request.mode,
-            model: picked.alias,
-            prompt: request.prompt,
-            ...(request.voice === undefined ? {} : { voice: request.voice }),
-            ...(request.speed === undefined ? {} : { speed: request.speed }),
-            ...(request.duration === undefined ? {} : { duration: request.duration }),
-            ...(request.format === undefined ? {} : { format: request.format }),
-            audio: outputs.map((output, index) => ({
-              id: saved[index]!.id,
-              file: saved[index]!.file,
-              b64: Buffer.from(output.data).toString('base64'),
-              mime: saved[index]!.mime,
-              bytes: saved[index]!.bytes,
-              url: saved[index]!.url,
+          const outputs = await generateAudio(picked.channel, request, exec.signal)
+          const audio: AgentAudioRef[] = []
+          const saved: SavedAudioRef[] = []
+          for (const [index, output] of outputs.entries()) {
+            const stored = await saveAudioFile(output.data, output.mime, `generated-${index + 1}`)
+            saved.push({
+              id: stored.id,
+              url: `/api/dsh-audiogen/audio/${encodeURIComponent(stored.file)}`,
+              file: stored.file,
+              mime: stored.mime,
+              bytes: stored.bytes,
               ...(output.voiceId === undefined ? {} : { voiceId: output.voiceId }),
-            })),
-            channelId: picked.channel.id,
-            channel: picked.channel.name,
-            params: { ...request },
-          })
-        } catch {
-          // History is best-effort and must not fail the agent tool.
-        }
-        // ---- 资源库保存：显式参数优先；设置自动入库时可用 false 跳过 ----
-        const wantSave = args.save_to_library === true || (config.autoSaveToLibrary && args.save_to_library !== false)
-        let resources: string[] | undefined
-        if (wantSave) {
+            })
+            audio.push({
+              id: stored.id,
+              url: `/api/dsh-audiogen/audio/${encodeURIComponent(stored.file)}`,
+              mime: stored.mime,
+              bytes: stored.bytes,
+              ...(output.voiceId === undefined ? {} : { voiceId: output.voiceId }),
+            })
+          }
           try {
-            const entry = await saveToLibrary({
-              audioFiles: saved.map(item => ({
-                id: item.id,
-                file: item.file,
-                mime: item.mime,
-                ...(item.voiceId === undefined ? {} : { voiceId: item.voiceId }),
+            await appendHistory({
+              id: randomUUID(),
+              createdAt: Date.now(),
+              mode: request.mode,
+              model: picked.alias,
+              prompt: request.prompt,
+              ...(request.voice === undefined ? {} : { voice: request.voice }),
+              ...(request.speed === undefined ? {} : { speed: request.speed }),
+              ...(request.duration === undefined ? {} : { duration: request.duration }),
+              ...(request.format === undefined ? {} : { format: request.format }),
+              audio: outputs.map((output, index) => ({
+                id: saved[index]!.id,
+                file: saved[index]!.file,
+                b64: Buffer.from(output.data).toString('base64'),
+                mime: saved[index]!.mime,
+                bytes: saved[index]!.bytes,
+                url: saved[index]!.url,
+                ...(output.voiceId === undefined ? {} : { voiceId: output.voiceId }),
               })),
-              type: libraryTypeOf(request.mode, args.library_type),
-              ...(typeof args.library_name === 'string' && args.library_name.trim() !== '' ? { name: args.library_name.trim() } : {}),
-              ...(Array.isArray(args.library_tags) ? { tags: args.library_tags.filter((tag): tag is string => typeof tag === 'string' && tag.trim() !== '').map(tag => tag.trim()) } : {}),
-              provenance: {
-                mode: request.mode,
-                prompt: request.prompt,
-                channel: picked.channel.name,
-                channelId: picked.channel.id,
-                apiUrl: picked.channel.apiUrl,
-                model: picked.alias,
-                upstream: picked.upstream,
-                ...(request.voice === undefined ? {} : { voice: request.voice }),
-                params: { ...request },
-              },
+              channelId: picked.channel.id,
+              channel: picked.channel.name,
+              params: { ...request },
             })
-            resources = [entry.id]
           } catch {
-            // library-save is best-effort; generation already succeeded.
+            // History is best-effort and must not fail the agent tool.
+          }
+          // ---- 资源库保存：显式参数优先；设置自动入库时可用 false 跳过 ----
+          const wantSave = args.save_to_library === true || (config.autoSaveToLibrary && args.save_to_library !== false)
+          let resources: string[] | undefined
+          if (wantSave) {
+            try {
+              const entry = await saveToLibrary({
+                audioFiles: saved.map(item => ({
+                  id: item.id,
+                  file: item.file,
+                  mime: item.mime,
+                  ...(item.voiceId === undefined ? {} : { voiceId: item.voiceId }),
+                })),
+                type: libraryTypeOf(request.mode, args.library_type),
+                ...(typeof args.library_name === 'string' && args.library_name.trim() !== '' ? { name: args.library_name.trim() } : {}),
+                ...(Array.isArray(args.library_tags) ? { tags: args.library_tags.filter((tag): tag is string => typeof tag === 'string' && tag.trim() !== '').map(tag => tag.trim()) } : {}),
+                provenance: {
+                  mode: request.mode,
+                  prompt: request.prompt,
+                  channel: picked.channel.name,
+                  channelId: picked.channel.id,
+                  apiUrl: picked.channel.apiUrl,
+                  model: picked.alias,
+                  upstream: picked.upstream,
+                  ...(request.voice === undefined ? {} : { voice: request.voice }),
+                  params: { ...request },
+                },
+              })
+              resources = [entry.id]
+            } catch {
+              // library-save is best-effort; generation already succeeded.
+            }
+          }
+          return {
+            model: picked.alias,
+            audio,
+            ...(resources === undefined ? {} : { resources }),
+          }
+        } catch (error) {
+          if (exec.signal?.aborted === true) throw error
+          return {
+            model: picked.alias,
+            audio: [],
+            error: error instanceof Error ? error.message : String(error),
           }
         }
+      }
+      // ---- 多模型对比：同一 prompt 依次生成 ----
+      const requestedModels = Array.isArray(args.models)
+        ? [...new Set(args.models.filter((item: unknown): item is string => typeof item === 'string' && item.trim() !== '').map((item: string) => item.trim()))]
+        : []
+      if (requestedModels.length > 0 && mode !== 'voice_design') {
+        const groups: AgentAudioGroup[] = []
+        let succeeded = 0
+        for (const alias of requestedModels) {
+          let picked
+          try {
+            picked = resolveModel(config, alias)
+          } catch (error) {
+            groups.push({ model: alias, audio: [], error: error instanceof Error ? error.message : String(error) })
+            continue
+          }
+          const group = await runOne(picked)
+          groups.push(group)
+          if (group.error === undefined) succeeded++
+        }
         return {
-          status: 'completed',
-          message: 'Audio generation completed. The audio files can be played/downloaded from the returned URLs.',
-          mode: request.mode,
-          model: picked.alias,
-          audio,
-          ...(resources === undefined ? {} : { resources }),
+          status: succeeded > 0 ? 'completed' : 'failed',
+          message: succeeded > 0
+            ? `Generated ${succeeded}/${groups.length} model(s) with the same prompt for comparison. The audio files can be played/downloaded from the returned URLs.`
+            : 'All model generations failed.',
+          mode,
+          model: groups[0]?.model ?? requestedModels[0]!,
+          audio: groups.flatMap(group => group.audio),
+          groups,
+          ...(succeeded === 0
+            ? { error: groups.map(group => `${group.model}: ${group.error ?? ''}`).filter(item => !item.endsWith(': ')).join('；') }
+            : {}),
         }
-      } catch (error) {
-        if (exec.signal?.aborted === true) throw error
+      }
+      // ---- 单模型（含音色设计） ----
+      const picked = mode === 'voice_design'
+        ? (() => {
+          const usable = config.channels.filter(channel => channel.apiUrl.trim() !== '' && channel.apiKey.trim() !== '')
+          const target = usable.find(channel => channel.id === config.defaultChannelId) ?? usable[0]
+          if (target === undefined) throw new AudioGenError('No usable audio channel is configured for voice design.', 'no-channel-available')
+          return { channel: target, alias: '', upstream: '' }
+        })()
+        : resolveModel(config, args.model)
+      const one = await runOne(picked)
+      if (one.error !== undefined) {
         return {
           status: 'failed',
           message: 'Audio generation failed.',
-          mode: request.mode,
-          model: picked.alias,
+          mode,
+          model: one.model,
           audio: [],
-          error: error instanceof Error ? error.message : String(error),
+          error: one.error,
         }
       }
+      return {
+        status: 'completed',
+        message: 'Audio generation completed. The audio files can be played/downloaded from the returned URLs.',
+        mode,
+        model: one.model,
+        audio: one.audio,
+        ...(one.resources === undefined ? {} : { resources: one.resources }),
+      }
     },
   }))
 

package/src/client/audio-panel.module.css

@@ -805,3 +805,90 @@
 @media (prefers-reduced-motion: reduce) {
   .toast { animation-duration: 1ms; }
 }
+
+/* 多模型对比 */
+.modelCheckList {
+  max-height: 180px;
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 8px;
+  border: 1px solid var(--dsw-alias-border-l2, #d1d5db);
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-layer-3, #fff);
+}
+
+.resultGroups {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+
+.resultGroup {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.resultGroupHead {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.resultGroupChip {
+  font-size: 12px;
+  font-weight: 600;
+  padding: 3px 10px;
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-hover, #f3f4f6);
+  border: 1px solid var(--dsw-alias-border-l2, #d1d5db);
+  color: var(--dsw-alias-label-primary, #1f2328);
+}
+
+.resultGroupError {
+  font-size: 12px;
+  color: #dc2626;
+}
+
+.resultGroupCount {
+  font-size: 11px;
+  color: var(--dsw-alias-label-tertiary, #9ca3af);
+}
+
+/* 每模型参数覆盖矩阵 */
+.overrideTable {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.overrideRow {
+  display: flex;
+  gap: 6px;
+  align-items: center;
+}
+
+.overrideCell {
+  flex: 1;
+  min-width: 0;
+  font-size: 12px;
+  font-weight: 500;
+  color: var(--dsw-alias-label-secondary, #6b7280);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.overrideCell .input {
+  min-height: 30px;
+  padding: 5px 8px;
+}
+
+.overrideCellHead {
+  font-weight: 700;
+  color: var(--dsw-alias-label-primary, #1f2328);
+  white-space: normal;
+}