dsh-audiogen 0.4.13 → 0.4.14

package/lib/index.js

@@ -332,7 +332,7 @@ async function openAITTS(channel, request, signal) {
 		fallbackMime: "audio/mpeg"
 	});
 }
-async function elevenLabs(channel, request, signal) {
+async function elevenLabsOfficial(channel, request, signal) {
 	const base = endpointBase(channel.apiUrl);
 	const model = (request.upstream ?? request.model) || "eleven_multilingual_v2";
 	const headers = {
@@ -377,12 +377,15 @@ async function elevenLabs(channel, request, signal) {
 	}
 	if (request.mode === "music") {
 		const endpoint = `${base}/music`;
+		const musicModel = (request.upstream ?? request.model) || "music_v1";
+		const lyrics = request.lyrics?.trim() ?? "";
+		const instrumental = request.isInstrumental === true || lyrics === "";
 		const body = {
-			model_id: (request.upstream ?? request.model) || "music_v1",
+			model_id: musicModel,
 			prompt: request.prompt,
 			...request.duration !== void 0 && Number.isFinite(request.duration) ? { music_length_ms: Math.round(Math.min(6e5, Math.max(3e3, request.duration * 1e3))) } : {},
-			...request.lyrics !== void 0 && request.lyrics.trim() !== "" ? { lyrics_text: request.lyrics.trim() } : {},
-			...request.isInstrumental !== void 0 ? { force_instrumental: request.isInstrumental } : {}
+			...lyrics === "" ? {} : { lyrics_text: lyrics },
+			...instrumental ? { force_instrumental: true } : {}
 		};
 		const response = await fetchWithTimeout(endpoint, {
 			method: "POST",
@@ -450,6 +453,120 @@ async function elevenLabs(channel, request, signal) {
 		fallbackMime: "audio/mpeg"
 	});
 }
+/**
+* 官方 ElevenLabs 请求被网关拒绝的信号:官方路径未映射(404 Invalid URL)或
+* 网关要求 Bearer 认证而非 xi-api-key(401/403 Invalid token / Invalid API key)。
+* New API 类中转(如 ai.farmmx.com)对 ElevenLabs 官方协议通常返回这类错误。
+*/
+function isGatewayRouteMiss(error) {
+	return error instanceof AudioGenError && error.code === "audio-api-error" && /\bHTTP (404|401|403)\b/.test(error.message) && /\bInvalid URL\b|\bInvalid token\b|\bInvalid API key\b/i.test(error.message);
+}
+/** 网关兼容形态的请求头:仅 Bearer(携带 xi-api-key 会被网关按官方协议校验而 401)。 */
+function gatewayHeaders(apiKey) {
+	return {
+		authorization: `Bearer ${apiKey.trim()}`,
+		"content-type": "application/json",
+		accept: "audio/mpeg, application/json"
+	};
+}
+/** /audio/speech 兼容端点:base 已以此结尾时直接复用,否则拼接。 */
+function speechGatewayEndpoint(base) {
+	return /\/audio\/speech(\?|$)/i.test(base) ? base : `${base}/audio/speech`;
+}
+/**
+* ElevenLabs 渠道的网关兼容形态(OpenAI 风格):路径用 /audio/speech(音效/TTS)
+* 或 /music(音乐),认证用 Bearer、模型用 `model` 字段。
+*
+* 适配未映射 ElevenLabs 官方端点(404 Invalid URL)或要求 Bearer 认证
+* (401 Invalid token)的 New API 类中转,如 ai.farmmx.com。
+*/
+async function elevenLabsGatewayCompat(channel, request, signal) {
+	const base = endpointBase(channel.apiUrl);
+	const headers = gatewayHeaders(channel.apiKey);
+	if (request.mode === "music") {
+		const endpoint = /\/music(\?|$)/i.test(base) ? base : `${base}/music`;
+		const musicModel = (request.upstream ?? request.model) || "music_v1";
+		const lyrics = request.lyrics?.trim() ?? "";
+		const instrumental = request.isInstrumental === true || lyrics === "";
+		const body = {
+			model: musicModel,
+			prompt: request.prompt,
+			...request.duration !== void 0 && Number.isFinite(request.duration) ? { music_length_ms: Math.round(Math.min(6e5, Math.max(3e3, request.duration * 1e3))) } : {},
+			...lyrics === "" ? {} : { lyrics_text: lyrics },
+			...instrumental ? { force_instrumental: true } : {}
+		};
+		const response = await fetchWithTimeout(endpoint, {
+			method: "POST",
+			redirect: "follow",
+			headers,
+			body: JSON.stringify(body),
+			signal
+		}, UPSTREAM_TIMEOUT_MS);
+		if (!response.ok) {
+			const detail = await response.text().catch(() => "");
+			throw new AudioGenError(`ElevenLabs music gateway-compatible API error (HTTP ${response.status})${detail === "" ? "" : `: ${detail.slice(0, 300)}`}`, "audio-api-error");
+		}
+		return normalizeAudioResponse(response, {
+			apiKey: channel.apiKey,
+			fallbackMime: "audio/mpeg"
+		});
+	}
+	if (request.mode === "voice_design") throw new AudioGenError("当前网关不支持 ElevenLabs 音色设计端点(POST /v1/text-to-voice/design);该模式请改用 MiniMax 渠道或 ElevenLabs 官方 API。", "voice-design-unsupported");
+	const endpoint = speechGatewayEndpoint(base);
+	const isSfx = request.mode === "sfx";
+	const model = (request.upstream ?? request.model) || (isSfx ? "eleven_text_to_sound_v2" : "eleven_multilingual_v2");
+	if (!isSfx) {
+		if ((request.voice?.trim() ?? "") === "") {
+			const suggestions = (channel.models ?? []).filter((entry) => {
+				const candidate = entry;
+				return candidate.category === "tts" && candidate.id.trim() !== "" && candidate.id !== candidate.alias;
+			}).map((entry) => `${entry.alias}（${entry.id}）`);
+			throw new AudioGenError(`ElevenLabs 网关渠道的 TTS 必须携带音色 voice_id（网关强制校验，缺失会返回 400 voice or voice_id is required）：请在「音色」字段填入官方音色 ID${suggestions.length === 0 ? "" : `，可选用以下音色：${suggestions.slice(0, 4).join("、")}`}。`, "voice-required");
+		}
+	}
+	const body = isSfx ? {
+		model,
+		input: request.prompt,
+		...request.duration !== void 0 && Number.isFinite(request.duration) ? { duration_seconds: Math.min(30, Math.max(.5, request.duration)) } : {},
+		...request.loop !== void 0 ? { loop: request.loop } : {},
+		...request.promptInfluence !== void 0 && Number.isFinite(request.promptInfluence) ? { prompt_influence: Math.min(1, Math.max(0, request.promptInfluence)) } : {}
+	} : {
+		model,
+		input: request.prompt,
+		voice: request.voice.trim(),
+		response_format: request.format ?? "mp3",
+		...request.speed !== void 0 ? { speed: request.speed } : {}
+	};
+	const response = await fetchWithTimeout(endpoint, {
+		method: "POST",
+		redirect: "follow",
+		headers,
+		body: JSON.stringify(body),
+		signal
+	}, UPSTREAM_TIMEOUT_MS);
+	if (!response.ok) {
+		const detail = await response.text().catch(() => "");
+		throw new AudioGenError(`ElevenLabs ${isSfx ? "sound effects" : "TTS"} gateway-compatible API error (HTTP ${response.status})${detail === "" ? "" : `: ${detail.slice(0, 300)}`}`, "audio-api-error");
+	}
+	return normalizeAudioResponse(response, {
+		apiKey: channel.apiKey,
+		fallbackMime: "audio/mpeg"
+	});
+}
+/**
+* ElevenLabs 渠道入口:官方端点优先;官方协议被网关(New API 类中转)拒绝时,
+* 自动改用 OpenAI 兼容形态重试,使同一渠道同时兼容 ElevenLabs 官方 API 与
+* ai.farmmx.com 类中转。官方地址(api.elevenlabs.io)直连不触发回退。
+*/
+async function elevenLabs(channel, request, signal) {
+	if (/elevenlabs\.io/i.test(channel.apiUrl)) return elevenLabsOfficial(channel, request, signal);
+	try {
+		return await elevenLabsOfficial(channel, request, signal);
+	} catch (error) {
+		if (!isGatewayRouteMiss(error)) throw error;
+	}
+	return elevenLabsGatewayCompat(channel, request, signal);
+}
 function minimaxApiBase(base) {
 	const trimmed = endpointBase(base);
 	return /\/v1$/i.test(trimmed) ? trimmed : `${trimmed}/v1`;
@@ -614,13 +731,13 @@ async function minimax(channel, request, signal) {
 			256e3
 		]);
 		const lyrics = request.lyrics?.trim() ?? "";
-		if (lyrics === "" && request.isInstrumental !== true) throw new AudioGenError("MiniMax 音乐生成需要歌词（lyrics 参数），或在「纯音乐」模式（is_instrumental=true）下生成；也可让面板/Agent 先为提示词创作一段歌词。", "lyrics-required");
+		const instrumental = request.isInstrumental === true || lyrics === "";
 		const endpoint = `${base}/music_generation`;
 		const body = {
 			model,
 			prompt: request.prompt,
 			...lyrics === "" ? {} : { lyrics },
-			...request.isInstrumental !== void 0 ? { is_instrumental: request.isInstrumental } : {},
+			...instrumental ? { is_instrumental: true } : {},
 			...request.duration !== void 0 ? { duration: request.duration } : {},
 			audio_setting: {
 				format: MUSIC_FORMATS.has(request.format ?? "mp3") ? request.format ?? "mp3" : "mp3",
@@ -2100,11 +2217,13 @@ function makeRoutes(deps) {
 							type: entry.type
 						}];
 					} catch {}
+					const note = request.mode === "music" && request.isInstrumental !== true && (request.lyrics === void 0 || request.lyrics.trim() === "") ? "未提供歌词，已按纯音乐生成" : void 0;
 					writeJson(res, 200, {
 						ok: true,
 						outputs: generated,
 						history,
-						...resources === void 0 ? {} : { resources }
+						...resources === void 0 ? {} : { resources },
+						...note === void 0 ? {} : { note }
 					});
 				} catch (error) {
 					writeJson(res, 200, {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-audiogen",
   "description": "AI audio generation plugin for the dsh web GUI: multi-vendor TTS/music/sound-effect channels (OpenAI-compatible, ElevenLabs, MiniMax, Stability AI and custom), per-channel model/voice catalogs, Agent tool and a sidebar AI 音频 panel.",
-  "version": "0.4.13",
+  "version": "0.4.14",
   "type": "module",
   "main": "lib/index.js",
   "exports": {

package/skills/sfx/SKILL.md

@@ -33,3 +33,9 @@ whenToUse: 用户请求生成音效、提示音、环境音、UI 音，或触发
 | prompt_influence | prompt_influence | 0-1，默认 0.3；越高越贴提示词，越低越多样 |
 
 > 响应为 audio/mpeg 二进制。请求同时携带 `xi-api-key` 与 `Authorization: Bearer`，兼容 New API 类网关。
+>
+> 网关自动回退：当渠道 API 地址不是 ElevenLabs 官方域名且官方协议被网关拒绝时
+> （404 Invalid URL / 401 Invalid token，例如 ai.farmmx.com 未映射 `/v1/sound-generation`），
+> 引擎自动改用 OpenAI 兼容形态重试：`POST {base}/audio/speech` + `Authorization: Bearer` +
+> `model=eleven_text_to_sound_v2` + `text/duration_seconds/prompt_influence/loop` 字段。
+> 官方地址（api.elevenlabs.io）直连时不触发回退。音色设计在网关无对应兼容端点，会明确报错不便死等。

package/src/audio-engine.ts

@@ -245,7 +245,7 @@ async function openAITTS(channel: AudioChannel, request: GenerateAudioRequest, s
   return normalizeAudioResponse(response, { apiKey: channel.apiKey, fallbackMime: 'audio/mpeg' })
 }
 
-async function elevenLabs(channel: AudioChannel, request: GenerateAudioRequest, signal?: AbortSignal): Promise<Array<{ data: Uint8Array; mime: string; voiceId?: string }>> {
+async function elevenLabsOfficial(channel: AudioChannel, request: GenerateAudioRequest, signal?: AbortSignal): Promise<Array<{ data: Uint8Array; mime: string; voiceId?: string }>> {
   const base = endpointBase(channel.apiUrl)
   const model = (request.upstream ?? request.model) || 'eleven_multilingual_v2'
   // 官方使用 xi-api-key；额外携带 Authorization Bearer 以兼容 New API 类网关。
@@ -299,17 +299,20 @@ async function elevenLabs(channel: AudioChannel, request: GenerateAudioRequest,
 
   // ------------- ElevenLabs Music（POST /v1/music） -------------
   // 模型：music_v1 / music_v2；prompt 与 composition_plan 二选一（引擎用 prompt）。
+  // 未提供歌词时按纯音乐处理（force_instrumental=true），不再要求必须有歌词。
   if (request.mode === 'music') {
     const endpoint = `${base}/music`
     const musicModel = (request.upstream ?? request.model) || 'music_v1'
+    const lyrics = request.lyrics?.trim() ?? ''
+    const instrumental = request.isInstrumental === true || lyrics === ''
     const body: Record<string, unknown> = {
       model_id: musicModel,
       prompt: request.prompt,
       ...(request.duration !== undefined && Number.isFinite(request.duration)
         ? { music_length_ms: Math.round(Math.min(600_000, Math.max(3_000, request.duration * 1000))) }
         : {}),
-      ...(request.lyrics !== undefined && request.lyrics.trim() !== '' ? { lyrics_text: request.lyrics.trim() } : {}),
-      ...(request.isInstrumental !== undefined ? { force_instrumental: request.isInstrumental } : {}),
+      ...(lyrics === '' ? {} : { lyrics_text: lyrics }),
+      ...(instrumental ? { force_instrumental: true } : {}),
     }
     const response = await fetchWithTimeout(endpoint, {
       method: 'POST',
@@ -379,6 +382,166 @@ async function elevenLabs(channel: AudioChannel, request: GenerateAudioRequest,
   return normalizeAudioResponse(response, { apiKey: channel.apiKey, fallbackMime: 'audio/mpeg' })
 }
 
+/**
+ * 官方 ElevenLabs 请求被网关拒绝的信号:官方路径未映射(404 Invalid URL)或
+ * 网关要求 Bearer 认证而非 xi-api-key(401/403 Invalid token / Invalid API key)。
+ * New API 类中转(如 ai.farmmx.com)对 ElevenLabs 官方协议通常返回这类错误。
+ */
+function isGatewayRouteMiss(error: unknown): boolean {
+  return error instanceof AudioGenError
+    && error.code === 'audio-api-error'
+    && /\bHTTP (404|401|403)\b/.test(error.message)
+    && /\bInvalid URL\b|\bInvalid token\b|\bInvalid API key\b/i.test(error.message)
+}
+
+/** 网关兼容形态的请求头:仅 Bearer(携带 xi-api-key 会被网关按官方协议校验而 401)。 */
+function gatewayHeaders(apiKey: string): Record<string, string> {
+  return {
+    authorization: `Bearer ${apiKey.trim()}`,
+    'content-type': 'application/json',
+    accept: 'audio/mpeg, application/json',
+  }
+}
+
+/** /audio/speech 兼容端点:base 已以此结尾时直接复用,否则拼接。 */
+function speechGatewayEndpoint(base: string): string {
+  return /\/audio\/speech(\?|$)/i.test(base) ? base : `${base}/audio/speech`
+}
+
+/**
+ * ElevenLabs 渠道的网关兼容形态(OpenAI 风格):路径用 /audio/speech(音效/TTS)
+ * 或 /music(音乐),认证用 Bearer、模型用 `model` 字段。
+ *
+ * 适配未映射 ElevenLabs 官方端点(404 Invalid URL)或要求 Bearer 认证
+ * (401 Invalid token)的 New API 类中转,如 ai.farmmx.com。
+ */
+async function elevenLabsGatewayCompat(
+  channel: AudioChannel,
+  request: GenerateAudioRequest,
+  signal?: AbortSignal,
+): Promise<Array<{ data: Uint8Array; mime: string; voiceId?: string }>> {
+  const base = endpointBase(channel.apiUrl)
+  const headers = gatewayHeaders(channel.apiKey)
+
+  // music → POST /music(Bearer + model;官方形态在此类网关上是 401 Invalid token)。
+  if (request.mode === 'music') {
+    const endpoint = /\/music(\?|$)/i.test(base) ? base : `${base}/music`
+    const musicModel = (request.upstream ?? request.model) || 'music_v1'
+    const lyrics = request.lyrics?.trim() ?? ''
+    const instrumental = request.isInstrumental === true || lyrics === ''
+    const body: Record<string, unknown> = {
+      model: musicModel,
+      prompt: request.prompt,
+      ...(request.duration !== undefined && Number.isFinite(request.duration)
+        ? { music_length_ms: Math.round(Math.min(600_000, Math.max(3_000, request.duration * 1000))) }
+        : {}),
+      ...(lyrics === '' ? {} : { lyrics_text: lyrics }),
+      ...(instrumental ? { force_instrumental: true } : {}),
+    }
+    const response = await fetchWithTimeout(endpoint, {
+      method: 'POST',
+      redirect: 'follow',
+      headers,
+      body: JSON.stringify(body),
+      signal,
+    }, UPSTREAM_TIMEOUT_MS)
+    if (!response.ok) {
+      const detail = await response.text().catch(() => '')
+      throw new AudioGenError(`ElevenLabs music gateway-compatible API error (HTTP ${response.status})${detail === '' ? '' : `: ${detail.slice(0, 300)}`}`, 'audio-api-error')
+    }
+    return normalizeAudioResponse(response, { apiKey: channel.apiKey, fallbackMime: 'audio/mpeg' })
+  }
+
+  // 音色设计在网关兼容层没有对应端点,直接给出可操作的错误说明。
+  if (request.mode === 'voice_design') {
+    throw new AudioGenError(
+      '当前网关不支持 ElevenLabs 音色设计端点(POST /v1/text-to-voice/design);该模式请改用 MiniMax 渠道或 ElevenLabs 官方 API。',
+      'voice-design-unsupported',
+    )
+  }
+
+  // sfx / tts → POST /audio/speech(OpenAI 兼容形态;网关把 model=eleven_text_to_sound_v2 映射到音效生成)。
+  // 音效必须传 OpenAI 标准的 `input`(实测 ai.farmmx.com 类 new-api 网关:input+duration_seconds
+  // 会走 ElevenLabs 音效生成;若传 ElevenLabs 官方字段 `text`,网关会把它当 TTS 文本朗读出来)。
+  const endpoint = speechGatewayEndpoint(base)
+  const isSfx = request.mode === 'sfx'
+  const model = (request.upstream ?? request.model)
+    || (isSfx ? 'eleven_text_to_sound_v2' : 'eleven_multilingual_v2')
+  // 网关(new-api 类中转)对 ElevenLabs TTS 强制校验 voice/voice_id,缺失直接 400;
+  // 在发送前拦截,给出可操作的提示,而不是把网关 400 原样抛给用户。
+  if (!isSfx) {
+    const voice = request.voice?.trim() ?? ''
+    if (voice === '') {
+      const voiceEntries = (channel.models ?? []).filter(entry => {
+        const candidate = entry as { alias: string; id: string; category?: string }
+        return candidate.category === 'tts' && candidate.id.trim() !== '' && candidate.id !== candidate.alias
+      })
+      const suggestions = voiceEntries.map(entry => `${entry.alias}（${entry.id}）`)
+      throw new AudioGenError(
+        `ElevenLabs 网关渠道的 TTS 必须携带音色 voice_id（网关强制校验，缺失会返回 400 voice or voice_id is required）：请在「音色」字段填入官方音色 ID${
+          suggestions.length === 0 ? '' : `，可选用以下音色：${suggestions.slice(0, 4).join('、')}`
+        }。`,
+        'voice-required',
+      )
+    }
+  }
+  const body: Record<string, unknown> = isSfx
+    ? {
+        model,
+        input: request.prompt,
+        ...(request.duration !== undefined && Number.isFinite(request.duration)
+          ? { duration_seconds: Math.min(30, Math.max(0.5, request.duration)) }
+          : {}),
+        ...(request.loop !== undefined ? { loop: request.loop } : {}),
+        ...(request.promptInfluence !== undefined && Number.isFinite(request.promptInfluence)
+          ? { prompt_influence: Math.min(1, Math.max(0, request.promptInfluence)) }
+          : {}),
+      }
+    : {
+        model,
+        input: request.prompt,
+        voice: request.voice!.trim(),
+        response_format: request.format ?? 'mp3',
+        ...(request.speed !== undefined ? { speed: request.speed } : {}),
+      }
+  const response = await fetchWithTimeout(endpoint, {
+    method: 'POST',
+    redirect: 'follow',
+    headers,
+    body: JSON.stringify(body),
+    signal,
+  }, UPSTREAM_TIMEOUT_MS)
+  if (!response.ok) {
+    const detail = await response.text().catch(() => '')
+    throw new AudioGenError(
+      `ElevenLabs ${isSfx ? 'sound effects' : 'TTS'} gateway-compatible API error (HTTP ${response.status})${detail === '' ? '' : `: ${detail.slice(0, 300)}`}`,
+      'audio-api-error',
+    )
+  }
+  return normalizeAudioResponse(response, { apiKey: channel.apiKey, fallbackMime: 'audio/mpeg' })
+}
+
+/**
+ * ElevenLabs 渠道入口:官方端点优先;官方协议被网关(New API 类中转)拒绝时,
+ * 自动改用 OpenAI 兼容形态重试,使同一渠道同时兼容 ElevenLabs 官方 API 与
+ * ai.farmmx.com 类中转。官方地址(api.elevenlabs.io)直连不触发回退。
+ */
+async function elevenLabs(
+  channel: AudioChannel,
+  request: GenerateAudioRequest,
+  signal?: AbortSignal,
+): Promise<Array<{ data: Uint8Array; mime: string; voiceId?: string }>> {
+  if (/elevenlabs\.io/i.test(channel.apiUrl)) {
+    return elevenLabsOfficial(channel, request, signal)
+  }
+  try {
+    return await elevenLabsOfficial(channel, request, signal)
+  } catch (error) {
+    if (!isGatewayRouteMiss(error)) throw error
+  }
+  return elevenLabsGatewayCompat(channel, request, signal)
+}
+
 function minimaxApiBase(base: string): string {
   const trimmed = endpointBase(base)
   return /\/v1$/i.test(trimmed) ? trimmed : `${trimmed}/v1`
@@ -551,22 +714,19 @@ async function minimax(channel: AudioChannel, request: GenerateAudioRequest, sig
     // audio_setting{format, sample_rate, bitrate}。音频输出配置为固定枚举：
     // format mp3|wav|pcm；sample_rate 16000|24000|32000|44100；
     // bitrate 32000|64000|128000|256000，超出枚举的值回退默认。
+    // 歌词为空时一律按纯音乐生成（is_instrumental=true）：面板/Agent 无论是否
+    // 显式勾选「纯音乐」都能出结果，不再因缺歌词报错。
     const MUSIC_FORMATS = new Set(['mp3', 'wav', 'pcm'])
     const MUSIC_SAMPLE_RATES = new Set([16000, 24000, 32000, 44100])
     const MUSIC_BITRATES = new Set([32000, 64000, 128000, 256000])
     const lyrics = request.lyrics?.trim() ?? ''
-    if (lyrics === '' && request.isInstrumental !== true) {
-      throw new AudioGenError(
-        'MiniMax 音乐生成需要歌词（lyrics 参数），或在「纯音乐」模式（is_instrumental=true）下生成；也可让面板/Agent 先为提示词创作一段歌词。',
-        'lyrics-required',
-      )
-    }
+    const instrumental = request.isInstrumental === true || lyrics === ''
     const endpoint = `${base}/music_generation`
     const body: Record<string, unknown> = {
       model,
       prompt: request.prompt,
       ...(lyrics === '' ? {} : { lyrics }),
-      ...(request.isInstrumental !== undefined ? { is_instrumental: request.isInstrumental } : {}),
+      ...(instrumental ? { is_instrumental: true } : {}),
       ...(request.duration !== undefined ? { duration: request.duration } : {}),
       audio_setting: {
         format: MUSIC_FORMATS.has(request.format ?? 'mp3') ? (request.format ?? 'mp3') : 'mp3',

package/src/client/api.ts

@@ -16,6 +16,8 @@ export interface GenerateResponse {
   historyError?: string
   /** Resource-library entries created by the generation (auto-save). */
   resources?: Array<{ id: string; name: string; type: string }>
+  /** 引擎兜底提示（如：未提供歌词时按纯音乐生成）。 */
+  note?: string
   code?: string
   message?: string
 }

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

@@ -1171,6 +1171,13 @@
   grid-column: 1 / -1;
 }
 
+/* 勾选纯音乐后禁用的歌词框 */
+.textarea:disabled {
+  opacity: 0.55;
+  cursor: not-allowed;
+  background: var(--dsw-alias-bg-layer-2, #f3f4f6);
+}
+
 /* 模式胶囊 */
 .modeIcon {
   font-size: 13px;

package/src/client/field-specs.ts

@@ -91,7 +91,7 @@ export function presetSupports(preset: string, key: FieldKey, mode: AudioMode):
 }
 
 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' },
+  duration: { label: '时长（秒）', type: 'number', min: 1, max: 200, 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' },

package/src/client/studio-view.tsx

@@ -424,6 +424,8 @@ export function StudioView(props: {
       props.showToast('已保存到资源库')
       props.onLibraryChanged()
     }
+    // 引擎兜底提示（如未提供歌词时自动按纯音乐生成），最后展示避免被覆盖。
+    if (response.note !== undefined && response.note.trim() !== '') props.showToast(response.note)
     reload()
     return generated
   }
@@ -756,7 +758,13 @@ export function StudioView(props: {
         return (
           <label className={css.label} key={spec.key} title={spec.hint}>
             <span>{spec.label}</span>
-            <textarea className={css.textarea} value={lyrics} onChange={event => setLyrics(event.target.value)} placeholder={'第一段歌词…\n\n第二段歌词…'} />
+            <textarea
+              className={css.textarea}
+              disabled={instrumental}
+              value={lyrics}
+              onChange={event => setLyrics(event.target.value)}
+              placeholder={instrumental ? '纯音乐模式无需填写歌词' : '第一段歌词…\n\n第二段歌词…'}
+            />
           </label>
         )
       case 'instrumental':

package/src/protocol.ts

@@ -8,7 +8,7 @@
 export const AUDIOGEN_SETTINGS_NAMESPACE = 'dsh-audiogen'
 
 /** Published package version shared by the host updater and the client UI. */
-export const PLUGIN_VERSION = '0.4.13'
+export const PLUGIN_VERSION = '0.4.14'
 
 /** Same-origin route family (loopback-only, mirroring dsh-imagegen). */
 export const SETTINGS_API = {

package/src/routes.ts

@@ -515,7 +515,12 @@ export function makeRoutes(deps: AudiogenRoutesDeps): WebRoute[] {
               // library-save is best-effort: generation and history already succeeded
             }
           }
-          writeJson(res, 200, { ok: true, outputs: generated, history, ...(resources === undefined ? {} : { resources }) })
+          // ---- 音乐兜底提示：未提供歌词时引擎按纯音乐生成，告知前端一声 ----
+          const instrumentalFallback = request.mode === 'music'
+            && request.isInstrumental !== true
+            && (request.lyrics === undefined || request.lyrics.trim() === '')
+          const note = instrumentalFallback ? '未提供歌词，已按纯音乐生成' : undefined
+          writeJson(res, 200, { ok: true, outputs: generated, history, ...(resources === undefined ? {} : { resources }), ...(note === undefined ? {} : { note }) })
         } catch (error) {
           const code = error instanceof AudioGenError ? error.code : 'generate-failed'
           writeJson(res, 200, { ok: false, code, message: messageOf(error) })