dsh-audiogen 0.4.0 → 0.4.1

package/src/client/studio-view.tsx

@@ -11,7 +11,7 @@ import { audioModelOptions } from './settings-scope.ts'
 import { tt } from './helpers.ts'
 import {
   HISTORY_API,
-  type AudioMode, type GeneratedAudio, type HistoryEntry, type LibraryEntry,
+  type AudioMode, type GenerateAudioRequest, type GeneratedAudio, type HistoryEntry, type LibraryEntry,
 } from '../protocol.ts'
 import { AudioPlayer } from './audio-player.tsx'
 import { LibrarySaveDialog, type SaveDialogContext } from './library-save-dialog.tsx'
@@ -26,6 +26,55 @@ export interface StudioReuse {
   voiceId?: string
 }
 
+/** 每模型可覆盖的参数行（留空 = 自动，沿用上方全局配置）。 */
+const OVERRIDE_ROWS: Array<{ key: string; label: string; type: 'text' | 'number' | 'select'; options?: string[]; placeholder?: string }> = [
+  { key: 'format', label: '输出格式', type: 'select', options: ['mp3', 'wav', 'pcm', 'flac', 'ogg'], placeholder: '自动' },
+  { key: 'duration', label: '时长(秒)', type: 'number', placeholder: '自动' },
+  { key: 'voice', label: '音色', type: 'text', placeholder: '自动' },
+  { key: 'speed', label: '语速', type: 'number', placeholder: '自动' },
+  { key: 'emotion', label: '情绪', type: 'text', placeholder: '自动' },
+  { key: 'sample_rate', label: '采样率', type: 'number', placeholder: '自动' },
+  { key: 'bitrate', label: '码率', type: 'number', placeholder: '自动' },
+  { key: 'lyrics', label: '歌词', type: 'text', placeholder: '自动' },
+  { key: 'seed', label: 'seed', type: 'number', placeholder: '自动' },
+  { key: 'steps', label: 'steps', type: 'number', placeholder: '自动' },
+  { key: 'cfg_scale', label: 'cfg_scale', type: 'number', placeholder: '自动' },
+]
+
+/** 每模型覆盖值 → 请求字段的数值/类型转换（空值跳过）。 */
+function overrideSpread(override: Record<string, string>): Partial<GenerateAudioRequest> {
+  const out: Partial<GenerateAudioRequest> = {}
+  const val = override.format?.trim() ?? ''
+  if (val !== '') out.format = val
+  const num = (key: string): number | undefined => {
+    const raw = (override[key] ?? '').trim()
+    if (raw === '') return undefined
+    const parsed = Number(raw)
+    return Number.isFinite(parsed) ? parsed : undefined
+  }
+  const duration = num('duration')
+  if (duration !== undefined) out.duration = duration
+  const voice = override.voice?.trim() ?? ''
+  if (voice !== '') out.voice = voice
+  const speed = num('speed')
+  if (speed !== undefined) out.speed = speed
+  const emotion = override.emotion?.trim() ?? ''
+  if (emotion !== '') out.emotion = emotion
+  const sampleRate = num('sample_rate')
+  if (sampleRate !== undefined) out.sampleRate = sampleRate
+  const bitrate = num('bitrate')
+  if (bitrate !== undefined) out.bitrate = bitrate
+  const lyrics = override.lyrics?.trim() ?? ''
+  if (lyrics !== '') out.lyrics = lyrics
+  const seed = num('seed')
+  if (seed !== undefined) out.seed = seed
+  const steps = num('steps')
+  if (steps !== undefined) out.steps = steps
+  const cfgScale = num('cfg_scale')
+  if (cfgScale !== undefined) out.cfgScale = cfgScale
+  return out
+}
+
 function useConfig(scope: AudiogenScope) {
   const [value, setValue] = useState(scope.getSnapshot().value)
   useEffect(() => scope.subscribe(() => { setValue(scope.getSnapshot().value) }), [scope])
@@ -121,6 +170,10 @@ export function StudioView(props: {
   const [prompt, setPrompt] = useState('')
   const [previewText, setPreviewText] = useState('')
   const [model, setModel] = useState('')
+  // 多模型对比：同一提示词逐模型生成
+  const [selectedModels, setSelectedModels] = useState<string[]>([])
+  // 每模型参数覆盖（留空 = 自动沿用全局配置）
+  const [overrides, setOverrides] = useState<Record<string, Record<string, string>>>({})
   const [voice, setVoice] = useState('')
   const [speed, setSpeed] = useState('')
   const [duration, setDuration] = useState('')
@@ -140,8 +193,9 @@ export function StudioView(props: {
   const [audioChannel, setAudioChannel] = useState('')
   const [subtitle, setSubtitle] = useState(false)
   const [loading, setLoading] = useState(false)
+  const [progress, setProgress] = useState('')
   const [error, setError] = useState<string | null>(null)
-  const [outputs, setOutputs] = useState<GeneratedAudio[]>([])
+  const [results, setResults] = useState<Array<{ model: string; outputs: GeneratedAudio[]; error?: string }>>([])
   // 资源库
   const [saveToLibrary, setSaveToLibrary] = useState(cfg?.autoSaveToLibrary === true)
   const [savedIds, setSavedIds] = useState<Set<string>>(new Set())
@@ -169,6 +223,33 @@ export function StudioView(props: {
       .map(entry => entry.alias)
   }, [modelOptions.models, mode])
 
+  useEffect(() => {
+    if (visibleModels.length === 0) return
+    setSelectedModels(current => {
+      const valid = current.filter(item => visibleModels.includes(item))
+      if (valid.length > 0) return valid
+      return [visibleModels[0]!]
+    })
+  }, [visibleModels])
+
+  // 每模型覆盖值随勾选模型收缩（保留仍在勾选中的覆盖）
+  useEffect(() => {
+    setOverrides(current => {
+      const next: Record<string, Record<string, string>> = {}
+      for (const alias of selectedModels) {
+        if (current[alias] !== undefined) next[alias] = current[alias]!
+      }
+      return next
+    })
+  }, [selectedModels])
+
+  const setOverrideValue = (model: string, key: string, value: string): void => {
+    setOverrides(current => ({
+      ...current,
+      [model]: { ...(current[model] ?? {}), [key]: value },
+    }))
+  }
+
   useEffect(() => {
     if (visibleModels.length > 0 && !visibleModels.includes(model)) {
       setModel(visibleModels[0]!)
@@ -180,7 +261,10 @@ export function StudioView(props: {
     if (reuse === undefined || reuse === null) return
     setMode(reuse.mode)
     if (reuse.voiceId !== undefined || reuse.voice !== undefined) setVoice(reuse.voiceId ?? reuse.voice ?? '')
-    if (reuse.model !== undefined && reuse.model !== '') setModel(reuse.model)
+    if (reuse.model !== undefined && reuse.model !== '') {
+      setModel(reuse.model)
+      setSelectedModels([reuse.model])
+    }
   }, [reuse?.nonce])
 
   const submit = async (): Promise<void> => {
@@ -188,49 +272,80 @@ export function StudioView(props: {
       setError(tt('prompt.required'))
       return
     }
+    // 待生成模型列表：音色设计单渠道；其余支持多模型（同一提示词逐一生成，供对比）。
+    const targets = mode === 'voice_design'
+      ? ['']
+      : selectedModels.length > 0
+        ? selectedModels
+        : (model !== '' ? [model] : visibleModels.length > 0 ? [visibleModels[0]!] : [])
+    if (targets.length === 0) {
+      setError('当前模式暂无可用模型')
+      return
+    }
     setLoading(true)
     setError(null)
+    setProgress('')
+    const gathered: Array<{ model: string; outputs: GeneratedAudio[]; error?: string }> = []
+    let anySaved = false
     try {
-      const response = await api.generate({
-        mode,
-        model: mode === 'voice_design' ? '' : (model || visibleModels[0]) ?? '',
-        prompt: prompt.trim(),
-        saveToLibrary,
-        ...(mode === 'voice_design' && designChannelId !== '' ? { channelId: designChannelId } : {}),
-        ...(previewText.trim() !== '' ? { previewText: previewText.trim() } : {}),
-        ...(voice.trim() !== '' ? { voice: voice.trim() } : {}),
-        ...(speed.trim() !== '' ? { speed: Number(speed) } : {}),
-        ...(duration.trim() !== '' ? { duration: Number(duration) } : {}),
-        ...(lyrics.trim() !== '' ? { lyrics: lyrics.trim() } : {}),
-        ...(instrumental ? { isInstrumental: true } : {}),
-        ...(loop ? { loop: true } : {}),
-        ...(promptInfluence.trim() !== '' ? { promptInfluence: Number(promptInfluence) } : {}),
-        ...(format.trim() !== '' ? { format: format.trim() } : {}),
-        ...(emotion.trim() !== '' ? { emotion: emotion.trim() } : {}),
-        ...(vol.trim() !== '' ? { vol: Number(vol) } : {}),
-        ...(pitch.trim() !== '' ? { pitch: Number(pitch) } : {}),
-        ...(toneText.trim() !== '' ? { pronunciationTone: toneText.split('\n').map(item => item.trim()).filter(item => item !== '') } : {}),
-        ...(sampleRate.trim() !== '' ? { sampleRate: Number(sampleRate) } : {}),
-        ...(bitrate.trim() !== '' ? { bitrate: Number(bitrate) } : {}),
-        ...(audioChannel.trim() !== '' ? { audioChannel: Number(audioChannel) } : {}),
-        ...(subtitle ? { subtitleEnable: true } : {}),
-      })
-      if (!response.ok) {
-        setError(response.message ?? '生成失败')
-        return
+      for (const [index, target] of targets.entries()) {
+        setProgress(`生成中 ${index + 1}/${targets.length}（${target || '音色设计'}）…`)
+        let response
+        try {
+          response = await api.generate({
+            mode,
+            model: target,
+            prompt: prompt.trim(),
+            saveToLibrary,
+            ...(mode === 'voice_design' && designChannelId !== '' ? { channelId: designChannelId } : {}),
+            ...(previewText.trim() !== '' ? { previewText: previewText.trim() } : {}),
+            ...(voice.trim() !== '' ? { voice: voice.trim() } : {}),
+            ...(speed.trim() !== '' ? { speed: Number(speed) } : {}),
+            ...(duration.trim() !== '' ? { duration: Number(duration) } : {}),
+            ...(lyrics.trim() !== '' ? { lyrics: lyrics.trim() } : {}),
+            ...(instrumental ? { isInstrumental: true } : {}),
+            ...(loop ? { loop: true } : {}),
+            ...(promptInfluence.trim() !== '' ? { promptInfluence: Number(promptInfluence) } : {}),
+            ...(format.trim() !== '' ? { format: format.trim() } : {}),
+            ...(emotion.trim() !== '' ? { emotion: emotion.trim() } : {}),
+            ...(vol.trim() !== '' ? { vol: Number(vol) } : {}),
+            ...(pitch.trim() !== '' ? { pitch: Number(pitch) } : {}),
+            ...(toneText.trim() !== '' ? { pronunciationTone: toneText.split('\n').map(item => item.trim()).filter(item => item !== '') } : {}),
+            ...(sampleRate.trim() !== '' ? { sampleRate: Number(sampleRate) } : {}),
+            ...(bitrate.trim() !== '' ? { bitrate: Number(bitrate) } : {}),
+            ...(audioChannel.trim() !== '' ? { audioChannel: Number(audioChannel) } : {}),
+            ...(subtitle ? { subtitleEnable: true } : {}),
+            // 每模型参数覆盖（后置覆盖全局；仅音色设计外生效）
+            ...(target === '' ? {} : overrideSpread(overrides[target] ?? {})),
+          })
+        } catch (err) {
+          gathered.push({ model: target, outputs: [], error: err instanceof Error ? err.message : String(err) })
+          continue
+        }
+        if (!response.ok) {
+          gathered.push({ model: target, outputs: [], error: response.message ?? '生成失败' })
+          continue
+        }
+        const generated = response.outputs ?? []
+        gathered.push({ model: target, outputs: generated })
+        if ((response.resources?.length ?? 0) > 0 && saveToLibrary) anySaved = true
       }
-      const generated = response.outputs ?? []
-      setOutputs(generated)
-      if ((response.resources?.length ?? 0) > 0 && saveToLibrary) {
-        setSavedIds(new Set(generated.map(item => item.id)))
+      setResults(gathered)
+      if (anySaved) {
+        setSavedIds(current => new Set([...current, ...gathered.flatMap(group => group.outputs.map(item => item.id))]))
         props.showToast('已保存到资源库')
         props.onLibraryChanged()
       }
+      const failed = gathered.filter(group => group.error !== undefined && group.outputs.length === 0)
+      if (failed.length > 0 && failed.length === gathered.length) {
+        setError(failed.map(group => `「${group.model || '音色设计'}」${group.error}`).join('；'))
+      }
       reload()
     } catch (err) {
       setError(err instanceof Error ? err.message : String(err))
     } finally {
       setLoading(false)
+      setProgress('')
     }
   }
 
@@ -301,14 +416,65 @@ export function StudioView(props: {
 
         {needModel ? (
           <label className={css.label}>
-            <span>{tt('model.label')}</span>
-            <select className={css.input} value={model} onChange={event => setModel(event.target.value)}>
-              {visibleModels.length === 0 ? <option value="">（当前模式暂无可用模型）</option> : null}
-              {visibleModels.map(item => <option key={item} value={item}>{item}</option>)}
-            </select>
+            <span>{tt('model.label')}（可多选，同一提示词逐个生成以对比）</span>
+            <div className={css.modelCheckList}>
+              {visibleModels.length === 0 ? <p className={css.hint}>（当前模式暂无可用模型）</p> : null}
+              {visibleModels.map(item => (
+                <label key={item} className={css.checkbox}>
+                  <input
+                    type="checkbox"
+                    checked={selectedModels.includes(item)}
+                    onChange={event => {
+                      const checked = event.target.checked
+                      setSelectedModels(current => checked ? [...new Set([...current, item])] : current.filter(alias => alias !== item))
+                      if (checked && (model === '' || !visibleModels.includes(model))) setModel(item)
+                    }}
+                  />
+                  <span title="点击生成对比">{item}</span>
+                </label>
+              ))}
+            </div>
           </label>
         ) : null}
 
+        {needModel && selectedModels.length > 0 ? (
+          <details className={css.advanced}>
+            <summary>每模型参数覆盖（默认自动：沿用上方相同配置，如输出格式均为 mp3）</summary>
+            <div className={css.overrideTable}>
+              <div className={css.overrideRow}>
+                <span className={`${css.overrideCell} ${css.overrideCellHead}`} />
+                {selectedModels.map(item => <span key={item} className={`${css.overrideCell} ${css.overrideCellHead}`}>{item}</span>)}
+              </div>
+              {OVERRIDE_ROWS.map(row => (
+                <div key={row.key} className={css.overrideRow}>
+                  <span className={css.overrideCell} title={row.label}>{row.label}</span>
+                  {selectedModels.map(item => {
+                    const value = overrides[item]?.[row.key] ?? ''
+                    return (
+                      <span key={item} className={css.overrideCell}>
+                        {row.type === 'select' ? (
+                          <select className={css.input} value={value} onChange={event => setOverrideValue(item, row.key, event.target.value)}>
+                            <option value="">自动</option>
+                            {row.options!.map(option => <option key={option} value={option}>{option}</option>)}
+                          </select>
+                        ) : (
+                          <input
+                            className={css.input}
+                            type={row.type === 'number' ? 'number' : 'text'}
+                            value={value}
+                            placeholder={row.placeholder ?? '自动'}
+                            onChange={event => setOverrideValue(item, row.key, event.target.value)}
+                          />
+                        )}
+                      </span>
+                    )
+                  })}
+                </div>
+              ))}
+            </div>
+          </details>
+        ) : null}
+
         {mode === 'tts' ? (
           <label className={css.label}>
             <span>{tt('voice.label')}</span>
@@ -448,13 +614,13 @@ export function StudioView(props: {
 
         {!connected && <p className={css.hint}>{tt('config.missing')}</p>}
         <button type="button" className={css.generate} disabled={loading || !connected || (needModel && visibleModels.length === 0)} onClick={() => void submit()}>
-          {loading ? tt('generating') : tt('generate')}
+          {loading ? (progress !== '' ? progress : tt('generating')) : tt('generate')}
         </button>
       </div>
 
       <div className={css.resultCol}>
         {error !== null ? <p className={css.error}>{error}</p> : null}
-        {outputs.length === 0 ? (
+        {results.length === 0 ? (
           <div className={css.resultEmpty}>
             <span className={css.resultEmptyIcon}>🎵</span>
             <p>{tt('result.empty')}</p>
@@ -463,59 +629,72 @@ export function StudioView(props: {
         ) : (
           <>
             <div className={css.resultMeta}>
-              <span>{tt('result.done', { count: outputs.length })}</span>
+              <span>{tt('result.done', { count: results.reduce((sum, group) => sum + group.outputs.length, 0) })}</span>
               <span className={css.resultModeChip}>{modeLabel}</span>
             </div>
-            <div className={css.audioList}>
-              {outputs.map((audio, index) => {
-                const saved = savedIds.has(audio.id)
-                return (
-                  <div className={css.audioCard} key={audio.id} data-saved={saved ? 'true' : 'false'}>
-                    <div className={css.audioCardHead}>
-                      {audio.voiceId !== undefined ? <span className={css.voiceIdChip} title="新音色 ID">新音色 {audio.voiceId}</span> : null}
-                      {saved ? (
-                        <span className={css.savedChip}><CheckIcon /> 已入库</span>
-                      ) : null}
-                      <span className={css.audioCardIndex}>#{index + 1}</span>
-                    </div>
-                    <AudioPlayer src={dataUrlOf(audio)} itemKey={audio.id} />
-                    <div className={css.audioCardActions}>
-                      <a className={css.ghostButton} href={dataUrlOf(audio)} download={`generated-${index + 1}.${audio.mime.split('/')[1]?.replace('mpeg', 'mp3') ?? 'mp3'}`}>
-                        <DownloadIcon /> 下载
-                      </a>
-                      {saved ? (
-                        <button type="button" className={css.ghostButton} onClick={() => props.showToast('该音频已加入资源库')}>
-                          <CheckIcon /> 已入库
-                        </button>
-                      ) : (
-                        <button
-                          type="button"
-                          className={css.ghostButton}
-                          onClick={() => openSaveDialog([audio], {
-                            mode,
-                            prompt: prompt.trim(),
-                            ...(voice.trim() !== '' ? { voice: voice.trim() } : {}),
-                            ...(audio.voiceId === undefined ? {} : { voiceId: audio.voiceId }),
-                            ...(model !== '' ? { model } : {}),
-                            ...(channels.length > 0 ? { channel: channels.find(candidate => candidate.id === (mode === 'voice_design' ? designChannelId : modelOptions.defaultChannelId))?.name ?? channels[0]?.name ?? '' } : {}),
-                            params: {
-                              mode,
-                              model: mode === 'voice_design' ? '' : (model || visibleModels[0]) ?? '',
-                              prompt: prompt.trim(),
-                              ...(voice.trim() !== '' ? { voice: voice.trim() } : {}),
-                              ...(speed.trim() !== '' ? { speed: Number(speed) } : {}),
-                              ...(duration.trim() !== '' ? { duration: Number(duration) } : {}),
-                              ...(format.trim() !== '' ? { format: format.trim() } : {}),
-                            },
-                          })}
-                        >
-                          <StarIcon /> 加入资源库
-                        </button>
-                      )}
-                    </div>
+            <div className={css.resultGroups}>
+              {results.map((group, groupIndex) => (
+                <div className={css.resultGroup} key={`${group.model}-${groupIndex}`}>
+                  <div className={css.resultGroupHead}>
+                    <span className={css.resultGroupChip}>{group.model || '音色设计'}</span>
+                    {group.error !== undefined ? <span className={css.resultGroupError}>生成失败：{group.error}</span> : null}
+                    {group.outputs.length > 0 ? <span className={css.resultGroupCount}>{group.outputs.length} 段</span> : null}
                   </div>
-                )
-              })}
+                  {group.outputs.length > 0 ? (
+                    <div className={css.audioList}>
+                      {group.outputs.map((audio, index) => {
+                        const saved = savedIds.has(audio.id)
+                        return (
+                          <div className={css.audioCard} key={audio.id} data-saved={saved ? 'true' : 'false'}>
+                            <div className={css.audioCardHead}>
+                              {audio.voiceId !== undefined ? <span className={css.voiceIdChip} title="新音色 ID">新音色 {audio.voiceId}</span> : null}
+                              {saved ? (
+                                <span className={css.savedChip}><CheckIcon /> 已入库</span>
+                              ) : null}
+                              <span className={css.audioCardIndex}>#{index + 1}</span>
+                            </div>
+                            <AudioPlayer src={dataUrlOf(audio)} itemKey={audio.id} />
+                            <div className={css.audioCardActions}>
+                              <a className={css.ghostButton} href={dataUrlOf(audio)} download={`generated-${groupIndex + 1}-${index + 1}.${audio.mime.split('/')[1]?.replace('mpeg', 'mp3') ?? 'mp3'}`}>
+                                <DownloadIcon /> 下载
+                              </a>
+                              {saved ? (
+                                <button type="button" className={css.ghostButton} onClick={() => props.showToast('该音频已加入资源库')}>
+                                  <CheckIcon /> 已入库
+                                </button>
+                              ) : (
+                                <button
+                                  type="button"
+                                  className={css.ghostButton}
+                                  onClick={() => openSaveDialog([audio], {
+                                    mode,
+                                    prompt: prompt.trim(),
+                                    ...(voice.trim() !== '' ? { voice: voice.trim() } : {}),
+                                    ...(audio.voiceId === undefined ? {} : { voiceId: audio.voiceId }),
+                                    ...(group.model !== '' ? { model: group.model } : {}),
+                                    ...(channels.length > 0 ? { channel: channels.find(candidate => candidate.id === (mode === 'voice_design' ? designChannelId : modelOptions.defaultChannelId))?.name ?? channels[0]?.name ?? '' } : {}),
+                                    params: {
+                                      mode,
+                                      model: mode === 'voice_design' ? '' : group.model,
+                                      prompt: prompt.trim(),
+                                      ...(voice.trim() !== '' ? { voice: voice.trim() } : {}),
+                                      ...(speed.trim() !== '' ? { speed: Number(speed) } : {}),
+                                      ...(duration.trim() !== '' ? { duration: Number(duration) } : {}),
+                                      ...(format.trim() !== '' ? { format: format.trim() } : {}),
+                                    },
+                                  })}
+                                >
+                                  <StarIcon /> 加入资源库
+                                </button>
+                              )}
+                            </div>
+                          </div>
+                        )
+                      })}
+                    </div>
+                  ) : null}
+                </div>
+              ))}
             </div>
           </>
         )}

package/src/index.ts

@@ -9,6 +9,9 @@
 
 import type { Context } from '@deepseek-ai/cordis'
 import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings'
+import { existsSync, mkdirSync, readdirSync, copyFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
 import z from 'schemastery'
 import type {} from '@deepseek-ai/dsh-host-webserver'
 import type {} from '@deepseek-ai/dsh-system-prompt'
@@ -81,6 +84,34 @@ function guidanceFor(channels: AudioChannel[], defaultChannelId: string): string
   return `${AUDIOGEN_GUIDANCE} 当前渠道与模型：${table}。`
 }
 
+/**
+ * 把随包分发的技能（skills/<id>/SKILL.md，含 frontmatter）同步到 DSH 用户技能根
+ * `~/.dsh/skills/<id>/SKILL.md` —— DSH web 会话的 skill-filesystem（standard 等
+ * preset 行）会扫描用户根，使会话可直接触发这些技能。仅创建缺失文件，绝不覆盖
+ * 用户已有内容；任何失败仅告警，不影响插件本身。
+ */
+function syncBundledSkills(): void {
+  try {
+    const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+    const sourceRoot = join(packageRoot, 'skills')
+    if (existsSync(sourceRoot) !== true) return
+    const dshHome = process.env.DSH_HOME ?? join(process.env.HOME ?? '', '.dsh')
+    const targetRoot = join(dshHome, 'skills')
+    for (const entry of readdirSync(sourceRoot, { withFileTypes: true })) {
+      if (entry.isDirectory() !== true) continue
+      const sourceFile = join(sourceRoot, entry.name, 'SKILL.md')
+      if (existsSync(sourceFile) !== true) continue
+      const targetDir = join(targetRoot, entry.name)
+      const targetFile = join(targetDir, 'SKILL.md')
+      if (existsSync(targetFile)) continue
+      mkdirSync(targetDir, { recursive: true })
+      copyFileSync(sourceFile, targetFile)
+    }
+  } catch {
+    // 技能同步为最佳努力：失败不阻断插件启动。
+  }
+}
+
 function normalizeChannels(value: unknown): ChannelConfig[] {
   if (!Array.isArray(value)) return []
   const out: ChannelConfig[] = []
@@ -122,6 +153,7 @@ export interface EffectiveConfig {
 }
 
 export function apply(ctx: Context, config?: Config): void {
+  syncBundledSkills()
   let current: () => Config = () => config ?? {}
 
   const resolve = (): EffectiveConfig => {

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.0'
+export const PLUGIN_VERSION = '0.4.1'
 
 /** Same-origin route family (loopback-only, mirroring dsh-imagegen). */
 export const SETTINGS_API = {