dsh-audiogen 0.4.0 → 0.4.2

package/src/client/SettingsCard.tsx

@@ -28,6 +28,7 @@ export interface AudioGenSettings {
   allowAgentAudioGeneration?: boolean
   defaultModel?: string
   autoSaveToLibrary?: boolean
+  maxConcurrentGenerations?: number
 }
 
 export interface AudioGenSettingsCardState extends CardShell {
@@ -37,6 +38,7 @@ export interface AudioGenSettingsCardState extends CardShell {
   allowAgentAudioGeneration: CardFieldState
   defaultModel: CardFieldState
   autoSaveToLibrary: CardFieldState
+  maxConcurrentGenerations: CardFieldState
 }
 
 export interface AudioGenSettingsCardFace extends CardActions {
@@ -57,6 +59,7 @@ export class AudioGenSettingsCardController {
       booleanField('allowAgentAudioGeneration'),
       textField('defaultModel'),
       booleanField('autoSaveToLibrary'),
+      textField('maxConcurrentGenerations'),
     ])
     this.channelsForm = new ChannelsForm(scope)
   }
@@ -72,6 +75,7 @@ export class AudioGenSettingsCardController {
       allowAgentAudioGeneration: this.form.field('allowAgentAudioGeneration'),
       defaultModel: this.form.field('defaultModel'),
       autoSaveToLibrary: this.form.field('autoSaveToLibrary'),
+      maxConcurrentGenerations: this.form.field('maxConcurrentGenerations'),
     }
   }
 
@@ -723,6 +727,20 @@ export function AudioGenSettingsCard(props: AudioGenSettingsCardProps) {
               <input type="checkbox" checked={state.autoSaveToLibrary.text === 'true'} disabled={!state.writable} onChange={event => props.edit('autoSaveToLibrary', String(event.target.checked))} /> {t('settings.autoSaveLibrary')}
             </label>
           </div>
+          <div className={css.field}>
+            <label className={css.label}>
+              <span>{t('settings.maxConcurrent')}</span>
+              <input
+                type="number"
+                min="1"
+                max="20"
+                className={css.input}
+                value={state.maxConcurrentGenerations.text}
+                disabled={!state.writable}
+                onChange={event => props.edit('maxConcurrentGenerations', event.target.value)}
+              />
+            </label>
+          </div>
           <div className={css.footer}>
             {state.failed ? <p className={css.failed}>保存失败</p> : null}
             <button type="button" className={css.discard} disabled={!state.dirty || state.saving} onClick={() => props.discard()}>{t('settings.discard')}</button>

package/src/client/api.ts

@@ -4,7 +4,7 @@
  */
 
 import {
-  GENERATE_API, HISTORY_API, LIBRARY_API,
+  GENERATE_API, HISTORY_API, LIBRARY_API, TASK_API,
   type GenerateAudioRequest, type GeneratedAudio, type HistoryEntry,
   type LibraryEntry, type LibrarySaveRequest, type LibraryUpdateRequest,
 } from '../protocol.ts'
@@ -20,59 +20,58 @@ export interface GenerateResponse {
   message?: string
 }
 
+/** POST helper: the host API requires the JSON content type on every POST. */
+function postJson(path: string, body: unknown, signal?: AbortSignal): Promise<Response> {
+  return fetch(path, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify(body),
+    ...(signal === undefined ? {} : { signal }),
+  })
+}
+
 export class AudiogenApi {
-  async generate(request: GenerateAudioRequest): Promise<GenerateResponse> {
-    const response = await fetch(GENERATE_API, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify(request),
-    })
+  async generate(request: GenerateAudioRequest, signal?: AbortSignal): Promise<GenerateResponse> {
+    const response = await postJson(GENERATE_API, { ...request, taskId: request.taskId }, signal)
     const body = await response.json() as GenerateResponse
     return body
   }
 
+  /** 取消进行中的任务：宿主侧中断全部在途上游调用，剩余模型跳过。 */
+  async cancelTask(taskId: string): Promise<void> {
+    await postJson(TASK_API.cancel, { taskId }).catch(() => { /* best-effort */ })
+  }
+
   async history(): Promise<HistoryEntry[]> {
-    const response = await fetch(HISTORY_API.list, { method: 'POST' })
+    const response = await postJson(HISTORY_API.list, {})
     const body = await response.json() as { ok?: boolean; history?: HistoryEntry[] }
     return body.ok === true ? (body.history ?? []) : []
   }
 
   async clearHistory(): Promise<void> {
-    await fetch(HISTORY_API.clear, { method: 'POST' })
+    await postJson(HISTORY_API.clear, {})
   }
 
   async libraryList(): Promise<LibraryEntry[]> {
-    const response = await fetch(LIBRARY_API.list, { method: 'POST' })
+    const response = await postJson(LIBRARY_API.list, {})
     const body = await response.json() as { ok?: boolean; entries?: LibraryEntry[] }
     return body.ok === true ? (body.entries ?? []) : []
   }
 
   async librarySave(request: LibrarySaveRequest): Promise<{ ok: boolean; entry?: LibraryEntry; message?: string }> {
-    const response = await fetch(LIBRARY_API.save, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify(request),
-    })
+    const response = await postJson(LIBRARY_API.save, request)
     const body = await response.json() as { ok?: boolean; entry?: LibraryEntry; message?: string }
     return { ok: body.ok === true, ...(body.entry === undefined ? {} : { entry: body.entry }), ...(body.message === undefined ? {} : { message: body.message }) }
   }
 
   async libraryUpdate(request: LibraryUpdateRequest): Promise<{ ok: boolean; entry?: LibraryEntry; message?: string }> {
-    const response = await fetch(LIBRARY_API.update, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify(request),
-    })
+    const response = await postJson(LIBRARY_API.update, request)
     const body = await response.json() as { ok?: boolean; entry?: LibraryEntry; message?: string }
     return { ok: body.ok === true, ...(body.entry === undefined ? {} : { entry: body.entry }), ...(body.message === undefined ? {} : { message: body.message }) }
   }
 
   async libraryRemove(ids: string[]): Promise<{ ok: boolean }> {
-    const response = await fetch(LIBRARY_API.remove, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ ids }),
-    })
+    const response = await postJson(LIBRARY_API.remove, { ids })
     const body = await response.json() as { ok?: boolean }
     return { ok: body.ok === true }
   }

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

@@ -425,6 +425,116 @@
   background: color-mix(in srgb, var(--dsw-alias-brand-primary, #2563eb) 8%, transparent);
 }
 
+/* ---------------------------------------------------------- model compare */
+
+.compareBox {
+  display: flex;
+  flex-direction: column;
+  gap: 7px;
+  padding: 9px 11px;
+  border: 1px dashed var(--dsw-alias-brand-primary, #2563eb);
+  border-radius: 10px;
+  background: color-mix(in srgb, var(--dsw-alias-brand-primary, #2563eb) 4%, var(--dsw-alias-bg-layer-1, #fff));
+}
+
+.compareChips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+
+.compareChip {
+  display: inline-flex;
+  align-items: center;
+  min-height: 27px;
+  padding: 0 11px;
+  border: 1px solid var(--dsw-alias-border-l2, #d1d5db);
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-layer-1, #fff);
+  color: var(--dsw-alias-label-secondary, #6b7280);
+  font-family: inherit;
+  font-size: 12px;
+  cursor: pointer;
+  transition: color 0.12s, border-color 0.12s, background 0.12s;
+}
+
+.compareChip:hover {
+  color: var(--dsw-alias-label-primary, #1f2328);
+  border-color: var(--dsw-alias-label-dimmed, #9ca3af);
+}
+
+.compareChip[data-active='true'] {
+  color: var(--dsw-alias-brand-primary, #2563eb);
+  border-color: var(--dsw-alias-brand-primary, #2563eb);
+  background: color-mix(in srgb, var(--dsw-alias-brand-primary, #2563eb) 9%, transparent);
+  font-weight: 600;
+}
+
+.compareBoard {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.compareGroup {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 11px;
+  border: 1px solid var(--dsw-alias-border-l1, #e5e7eb);
+  border-radius: 12px;
+  background: var(--dsw-alias-bg-layer-2, #f7f7f8);
+}
+
+.compareGroup[data-state='running'] {
+  border-color: color-mix(in srgb, var(--dsw-alias-brand-primary, #2563eb) 45%, var(--dsw-alias-border-l1, #e5e7eb));
+}
+
+.compareGroup[data-state='done'] {
+  border-color: color-mix(in srgb, #10b981 45%, var(--dsw-alias-border-l1, #e5e7eb));
+}
+
+.compareGroup[data-state='error'] {
+  border-color: color-mix(in srgb, var(--dsw-alias-label-error, #b91c1c) 45%, var(--dsw-alias-border-l1, #e5e7eb));
+}
+
+.compareGroupHead {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+}
+
+.compareModelName {
+  overflow: hidden;
+  padding: 3px 10px;
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-layer-1, #fff);
+  border: 1px solid var(--dsw-alias-border-l1, #e5e7eb);
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font-size: 12px;
+  font-weight: 600;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.compareState {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  font-size: 11px;
+  color: var(--dsw-alias-label-tertiary, #9ca3af);
+  white-space: nowrap;
+}
+
+.compareGroup[data-state='running'] .compareState { color: var(--dsw-alias-brand-primary, #2563eb); }
+.compareGroup[data-state='done'] .compareState { color: #059669; }
+.compareGroup[data-state='error'] .compareState { color: var(--dsw-alias-label-error, #b91c1c); }
+
+.hint[data-error] {
+  color: var(--dsw-alias-label-error, #b91c1c);
+}
+
 /* --------------------------------------------------------------- history */
 
 .historyCol {
@@ -805,3 +915,221 @@
 @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;
+}
+
+/* 任务列表 */
+.taskList {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+
+.taskCard {
+  border: 1px solid var(--dsw-alias-border-l2, #d1d5db);
+  border-radius: 10px;
+  padding: 10px 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  background: var(--dsw-alias-bg-layer-2, #fafafa);
+}
+
+.taskCard[data-state='failed'] {
+  border-color: #dc2626;
+}
+
+.taskCard[data-state='cancelled'] {
+  opacity: 0.75;
+}
+
+.taskHead {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.taskLabel {
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--dsw-alias-label-primary, #1f2328);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  max-width: 200px;
+}
+
+.taskStatus {
+  font-size: 12px;
+  color: var(--dsw-alias-label-secondary, #6b7280);
+}
+
+.taskStatus[data-state='done'] {
+  color: #16a34a;
+}
+
+.taskStatus[data-state='failed'] {
+  color: #dc2626;
+}
+
+.taskActions {
+  margin-left: auto;
+  display: flex;
+  gap: 6px;
+}
+
+/* 历史记录分类 */
+.historyTabs {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-bottom: 10px;
+}
+
+.historyTab {
+  border: 1px solid var(--dsw-alias-border-l2, #d1d5db);
+  border-radius: 999px;
+  padding: 3px 10px;
+  font-size: 12px;
+  cursor: pointer;
+  background: var(--dsw-alias-bg-layer-3, #fff);
+  color: var(--dsw-alias-label-secondary, #6b7280);
+}
+
+.historyTab[data-active='true'] {
+  background: var(--dsw-alias-bg-hover, #f3f4f6);
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font-weight: 600;
+}
+
+.historyTabCount {
+  margin-left: 4px;
+  font-size: 11px;
+  color: var(--dsw-alias-label-tertiary, #9ca3af);
+}
+
+/* 对比任务卡 */
+.historyCompareSummary {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  cursor: pointer;
+  flex-wrap: wrap;
+}
+
+.historyCompareBadge {
+  font-size: 11px;
+  font-weight: 600;
+  color: #7c3aed;
+  border: 1px solid #ddd6fe;
+  border-radius: 999px;
+  padding: 1px 8px;
+  background: #f5f3ff;
+  white-space: nowrap;
+}
+
+.historyModelRow {
+  margin-top: 8px;
+  padding-top: 8px;
+  border-top: 1px dashed var(--dsw-alias-border-l1, #e5e7eb);
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.overrideOnly {
+  font-size: 10px;
+  color: var(--dsw-alias-label-tertiary, #9ca3af);
+  font-weight: 500;
+}
+
+.overrideDash {
+  color: var(--dsw-alias-label-tertiary, #9ca3af);
+  padding: 0 6px;
+}

package/src/client/field-specs.ts

@@ -0,0 +1,186 @@
+/**
+ * 厂商感知的字段规格表：按（渠道 preset × 模式）声明面板该显示哪些参数，
+ * 以及每个参数适用于哪些渠道。引擎不变——引擎本来就按渠道消费字段；
+ * 这里只负责「该显示什么、标签/枚举/校验按渠道」。
+ */
+
+import type { AudioMode } from '../protocol.ts'
+
+/** 与面板表单 state 对应的一组字段键。 */
+export type FieldKey =
+  | 'duration'
+  | 'format'
+  | 'lyrics'
+  | 'instrumental'
+  | 'sampleRate'
+  | 'bitrate'
+  | 'audioChannel'
+  | 'voice'
+  | 'speed'
+  | 'emotion'
+  | 'vol'
+  | 'pitch'
+  | 'toneText'
+  | 'subtitle'
+  | 'loop'
+  | 'promptInfluence'
+  | 'seed'
+  | 'steps'
+  | 'cfgScale'
+
+export interface FieldSpec {
+  key: FieldKey
+  label: string
+  type: 'text' | 'number' | 'select' | 'checkbox'
+  options?: string[]
+  placeholder?: string
+  min?: number
+  max?: number
+  step?: number
+  /** 官方字段名/说明（tooltip）。 */
+  hint?: string
+  /** 放在折叠「高级参数」里。 */
+  advanced?: boolean
+  /** 适用的渠道 preset；undefined 表示通用。 */
+  presets?: string[]
+}
+
+const PRESET_MINIMAX = 'minimax'
+const PRESET_ELEVENLABS = 'elevenlabs'
+const PRESET_STABILITY = 'stability-audio'
+
+/** 各 preset 支持的音乐输出格式（交集用于全局字段）。 */
+const MUSIC_FORMATS: Record<string, string[]> = {
+  [PRESET_MINIMAX]: ['mp3', 'wav', 'pcm'],
+  [PRESET_ELEVENLABS]: ['mp3', 'wav'],
+  [PRESET_STABILITY]: ['mp3', 'wav'],
+}
+
+const MUSIC_KEYS: FieldKey[] = ['duration', 'format', 'lyrics', 'instrumental', 'sampleRate', 'bitrate']
+const TTS_KEYS: FieldKey[] = ['voice', 'speed', 'format', 'emotion', 'vol', 'pitch', 'toneText', 'sampleRate', 'bitrate', 'audioChannel', 'subtitle']
+const SFX_KEYS: FieldKey[] = ['duration', 'format', 'loop', 'promptInfluence', 'seed', 'steps', 'cfgScale']
+
+export function presetSupports(preset: string, key: FieldKey, mode: AudioMode): boolean {
+  const p = preset.toLowerCase()
+  const K = MUSIC_KEYS.includes(key) ? MUSIC_KEYS : TTS_KEYS.includes(key) ? TTS_KEYS : SFX_KEYS
+  if (!K.includes(key)) return true
+  switch (key) {
+    case 'lyrics':
+    case 'instrumental':
+      return p === PRESET_MINIMAX || p === PRESET_ELEVENLABS
+    case 'sampleRate':
+    case 'bitrate':
+    case 'audioChannel':
+      return p === PRESET_MINIMAX
+    case 'emotion':
+    case 'vol':
+    case 'pitch':
+    case 'toneText':
+    case 'subtitle':
+      return p === PRESET_MINIMAX
+    case 'loop':
+    case 'promptInfluence':
+      return p === PRESET_ELEVENLABS
+    case 'seed':
+    case 'steps':
+    case 'cfgScale':
+      return p === PRESET_STABILITY
+    default:
+      return true
+  }
+}
+
+const SPECS: Record<FieldKey, Omit<FieldSpec, 'key' | 'presets'>> = {
+  duration: { label: '时长（秒）', type: 'number', min: 1, max: 120, placeholder: '30', hint: 'duration；MiniMax 音乐 ≤190、ElevenLabs 音乐 3-600（转 ms）、Stability 按模型 190/380' },
+  format: { label: '输出格式', type: 'select', options: ['mp3', 'wav', 'pcm', 'flac', 'ogg'], hint: 'format / output_format / response_format' },
+  lyrics: { label: '歌词（纯音乐模式可留空；多段用空行分隔）', type: 'text', placeholder: '第一段歌词…\n\n第二段歌词…', hint: 'MiniMax lyrics / ElevenLabs lyrics_text' },
+  instrumental: { label: '纯音乐（无歌词/人声）', type: 'checkbox', hint: 'MiniMax is_instrumental / ElevenLabs force_instrumental' },
+  sampleRate: { label: '采样率', type: 'select', options: ['16000', '24000', '32000', '44100'], placeholder: '默认（44100）', hint: 'audio_setting.sample_rate：16000-44100' },
+  bitrate: { label: '码率 bps', type: 'select', options: ['32000', '64000', '128000', '256000'], placeholder: '默认（256000）', hint: 'audio_setting.bitrate：32000-256000' },
+  audioChannel: { label: '声道', type: 'select', options: ['1', '2'], placeholder: '默认(1)', hint: 'audio_setting.channel（TTS）' },
+  voice: { label: '音色', type: 'text', placeholder: '自定义音色', hint: 'voice_id（MiniMax 必填）/ voice（ElevenLabs）' },
+  speed: { label: '语速', type: 'number', min: 0.5, max: 2, step: 0.1, placeholder: '1.0', hint: 'speed（MiniMax 0.5-2）' },
+  emotion: { label: '情绪 emotion', type: 'text', placeholder: 'happy / sad / angry / nervous…', hint: 'voice_setting.emotion', advanced: true },
+  vol: { label: '音量 vol (0-10)', type: 'number', min: 0, max: 10, step: 0.5, placeholder: '1', hint: 'voice_setting.vol', advanced: true },
+  pitch: { label: '音调 pitch (-12~12)', type: 'number', min: -12, max: 12, placeholder: '0', hint: 'voice_setting.pitch', advanced: true },
+  toneText: { label: '发音词典（每行一条："文字/读音"）', type: 'text', placeholder: '处理/(chu3)(li3)\n危险/dangerous', hint: 'pronunciation_dict.tone', advanced: true },
+  subtitle: { label: '生成字幕 subtitle_enable', type: 'checkbox', hint: 'subtitle_enable', advanced: true },
+  loop: { label: '循环音效 loop（无缝循环）', type: 'checkbox', hint: 'ElevenLabs loop（仅 eleven_text_to_sound_v2）' },
+  promptInfluence: { label: '提示词影响度 prompt_influence (0-1)', type: 'number', min: 0, max: 1, step: 0.1, placeholder: '0.3', hint: 'prompt_influence：越高越贴提示词' },
+  seed: { label: 'seed', type: 'number', min: 0, max: 4294967294, placeholder: '默认（随机）', hint: 'Stable Audio seed（同参数可复现）' },
+  steps: { label: 'steps', type: 'number', min: 4, max: 100, placeholder: '默认', hint: 'Stable Audio 采样步数（2: 30-100；2.5/3: 4-8）' },
+  cfgScale: { label: 'cfg_scale', type: 'number', min: 1, max: 25, placeholder: '默认', hint: 'Stable Audio 提示词遵循度（2 默认 7，2.5/3 默认 1）' },
+}
+
+function specOf(key: FieldKey, presets?: string[]): FieldSpec {
+  return { key, ...SPECS[key], ...(presets === undefined ? {} : { presets }) }
+}
+
+/** 当前模式 + 所选模型集合（渠道集合）对应的「全局字段」清单。 */
+export function globalFieldSpecs(mode: AudioMode, presets: string[]): FieldSpec[] {
+  const list: FieldSpec[] = []
+  const all = (key: FieldKey, keys: FieldKey[]): boolean => keys.includes(key) && presets.every(preset => presetSupports(preset, key, mode))
+  if (mode === 'tts') {
+    list.push(specOf('voice'), specOf('speed'))
+    list.push({ ...specOf('format'), options: ['mp3', 'wav', 'flac', 'ogg', 'pcm'] })
+    const advanced = (['emotion', 'vol', 'pitch', 'toneText', 'sampleRate', 'bitrate', 'audioChannel', 'subtitle'] as FieldKey[]).filter(key => all(key, TTS_KEYS) && presets.length > 0)
+    for (const key of advanced) list.push(specOf(key))
+  } else if (mode === 'music') {
+    list.push(specOf('duration'))
+    // 格式选项取所有选中渠道支持的交集（无交集则回退 mp3/wav）
+    const supported: string[][] = presets.length === 0 ? [['mp3', 'wav', 'pcm']] : presets.map(preset => MUSIC_FORMATS[preset.toLowerCase()] ?? ['mp3', 'wav'])
+    const intersect: string[] = supported.reduce<string[]>((acc, cur) => acc.filter(item => cur.includes(item)), supported[0] ?? ['mp3', 'wav'])
+    list.push({ ...specOf('format'), options: intersect.length > 0 ? intersect : ['mp3', 'wav'] })
+    if (all('lyrics', MUSIC_KEYS) && presets.length > 0) list.push(specOf('lyrics'))
+    if (all('instrumental', MUSIC_KEYS) && presets.length > 0) list.push(specOf('instrumental'))
+    if (all('sampleRate', MUSIC_KEYS) && presets.length > 0) list.push(specOf('sampleRate'))
+    if (all('bitrate', MUSIC_KEYS) && presets.length > 0) list.push(specOf('bitrate'))
+  } else if (mode === 'sfx') {
+    list.push(specOf('duration'))
+    list.push({ ...specOf('format'), options: ['mp3', 'wav', 'pcm'] })
+    if (all('loop', SFX_KEYS) && presets.length > 0) list.push(specOf('loop'))
+    if (all('promptInfluence', SFX_KEYS) && presets.length > 0) list.push(specOf('promptInfluence'))
+    if (all('seed', SFX_KEYS) && presets.length > 0) list.push(specOf('seed'), specOf('steps'), specOf('cfgScale'))
+  }
+  return list
+}
+
+/** 「每模型参数覆盖」矩阵的字段全集（含适用渠道标注）。 */
+export function overrideRowSpecs(mode: AudioMode): Array<FieldSpec & { presets: string[] }> {
+  const rows: Array<FieldSpec & { presets: string[] }> = []
+  const presets: Array<[FieldKey, string[]]> = [
+    ['format', [PRESET_MINIMAX, PRESET_ELEVENLABS, PRESET_STABILITY]],
+    ['duration', [PRESET_MINIMAX, PRESET_ELEVENLABS, PRESET_STABILITY]],
+    ['voice', [PRESET_MINIMAX, PRESET_ELEVENLABS]],
+    ['speed', [PRESET_MINIMAX, PRESET_ELEVENLABS]],
+    ['lyrics', [PRESET_MINIMAX, PRESET_ELEVENLABS]],
+    ['instrumental', [PRESET_MINIMAX, PRESET_ELEVENLABS]],
+    ['sampleRate', [PRESET_MINIMAX]],
+    ['bitrate', [PRESET_MINIMAX]],
+    ['audioChannel', [PRESET_MINIMAX]],
+    ['emotion', [PRESET_MINIMAX]],
+    ['vol', [PRESET_MINIMAX]],
+    ['pitch', [PRESET_MINIMAX]],
+    ['toneText', [PRESET_MINIMAX]],
+    ['subtitle', [PRESET_MINIMAX]],
+    ['loop', [PRESET_ELEVENLABS]],
+    ['promptInfluence', [PRESET_ELEVENLABS]],
+    ['seed', [PRESET_STABILITY]],
+    ['steps', [PRESET_STABILITY]],
+    ['cfgScale', [PRESET_STABILITY]],
+  ]
+  for (const [key, applicable] of presets) {
+    const spec = specOf(key, applicable)
+    rows.push({ ...spec, presets: applicable })
+  }
+  return rows
+}
+
+/** 渠道 preset 的展示名。 */
+export function presetLabel(preset: string): string {
+  if (preset === PRESET_MINIMAX) return 'MiniMax'
+  if (preset === PRESET_ELEVENLABS) return 'ElevenLabs'
+  if (preset === PRESET_STABILITY) return 'Stability'
+  if (preset === 'openai-tts') return 'OpenAI'
+  return '自定义'
+}

package/src/client/library-view.tsx

@@ -319,7 +319,12 @@ export function LibraryView(props: {
       </div>
 
       {loading ? <p className={css.stateNote}>加载中…</p> : null}
-      {error !== null ? <p className={css.stateNote} data-error>{error}</p> : null}
+      {error !== null ? (
+        <div className={css.stateNote} data-error>
+          <p>{error}</p>
+          <p>若提示 not found / 404：插件宿主尚未加载新代码，请重启 `dsh web` 后在浏览器强制刷新（Cmd+Shift+R）。</p>
+        </div>
+      ) : null}
       {!loading && error === null && filtered.length === 0 ? (
         <div className={css.empty}>
           <span className={css.emptyIcon}>🎧</span>