@goodandready/dsh-tts 0.4.6 → 0.4.8

package/lib/client-src/40-editors.js

@@ -263,7 +263,8 @@
             onChange: (e) => set(r, { chime: e.target.value }),
           }),
           React.createElement('input', {
-            className: 'dts-input dts-grow', placeholder: 'ssml',
+            className: 'dts-input dts-grow', placeholder: t('ssmlStyle') || 'ssml',
+            title: t('ssmlStyleHint') || 'SSML tone style',
             value: (value[r] && value[r].ssmlStyle) || '', disabled: !props.writable,
             onChange: (e) => set(r, { ssmlStyle: e.target.value }),
           }),

package/lib/client-src/50-settings.js

@@ -293,6 +293,7 @@
         ),
         React.createElement('div', { className: 'dts-block' },
           React.createElement('div', { className: 'dts-h' }, t('rolesTitle')),
+          boolField('autoDetectSubagent', t('autoDetectSubagent'), t('autoDetectSubagent')),
           React.createElement(RolesEditor, {
             t: t, writable: writable, onPreview: onPreview,
             value: draft && draft.roles ? draft.roles : {},

package/lib/client-src/60-card-dock.js

@@ -53,6 +53,10 @@
           type: 'button', className: 'dts-link', title: '★',
           onClick: () => { recent.toggleFav(text); force() },
         }, starred ? '★' : '☆'),
+        React.createElement('button', {
+          type: 'button', className: 'dts-link', title: t('exportAudio') || 'Export',
+          onClick: () => exportAudioClip(text),
+        }, '⤓'),
       )
       return React.createElement('div', { style: { position: 'relative', display: 'inline-flex', gap: '4px', alignItems: 'center' } },
         React.createElement('button', {
@@ -81,6 +85,12 @@
           title: t('dockStop'),
           onClick: stopPlayback,
         }, '■'),
+        React.createElement('button', {
+          type: 'button',
+          className: 'dts-link',
+          title: t('exportAudio') || 'Export clip',
+          onClick: () => exportAudioClip(player.lastText),
+        }, '⤓'),
       )
     }
 
@@ -121,7 +131,7 @@
         }
       }
       ctx.effect(() => {
-        const undo = [addLocale('en', en), addLocale('ru', ru)]
+        const undo = [addLocale('en', en), addLocale('zh', zh)]
         return () => { for (const off of undo) off() }
       }, 'dsh-tts: locales')
     // The sidebar draws the section label, not our component: props.t never

package/lib/client.js

@@ -280,6 +280,7 @@ window.__ModuleLoader__.load({
           const { audio, url } = item.prepared
           audio.playbackRate = Math.max(0.5, Math.min(2, player.rate || 1))
           player.audio = audio
+          if (item.text) player.lastText = item.text
           playerChanged()
           prebufferNext()
           let doneCalled = false
@@ -461,11 +462,57 @@ window.__ModuleLoader__.load({
         .catch(() => { /* chime fetch failed or not found */ })
     }
 
+    function exportAudioClip(text) {
+      let phrase = text || player.lastText
+      if (!phrase) {
+        const list = recent.list()
+        if (list && list.items && list.items.length) phrase = list.items[0]
+      }
+      if (!phrase) return
+      fetch('/dsh-tts/speak', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ text: phrase }),
+      })
+        .then((r) => r.json())
+        .then((d) => {
+          if (!d || !d.ok || !d.audioBase64) return
+          const bin = atob(d.audioBase64)
+          const bytes = new Uint8Array(bin.length)
+          for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i)
+          const mime = d.mime || 'audio/mpeg'
+          const blob = new Blob([bytes], { type: mime })
+          const url = URL.createObjectURL(blob)
+          const a = document.createElement('a')
+          a.href = url
+          a.download = 'dsh-tts-' + Date.now() + (mime.indexOf('wav') !== -1 ? '.wav' : '.mp3')
+          document.body.appendChild(a)
+          a.click()
+          document.body.removeChild(a)
+          setTimeout(() => { try { URL.revokeObjectURL(url) } catch {} }, 2000)
+        })
+        .catch(() => {})
+    }
+
     function credOf(map, provider) {
       return (map && map[provider]) || { configured: false, writable: true, ref: '' }
     }
 
     const en = {
+      'dockLabel': 'Speech',
+      'dockPause': 'Pause',
+      'dockResume': 'Resume speech',
+      'dockStop': 'Stop speech',
+      'dockCurrent': 'Now speaking',
+      'dockNone': 'Waiting for speech',
+      'dockQueue': 'Queue',
+      'dockClearQueue': 'Clear queue',
+      'dockReplay': 'Replay',
+      'dockFavorite': 'Favorite',
+      'dockUnfavorite': 'Unfavorite',
+      'dockFavorites': 'Favorite clips',
+      'exportAudio': 'Export audio clip',
+      'exportSuccess': 'Audio exported',
       'statusOnline': 'Host online',
       'recent': 'Recent',
       'recentEmpty': 'No recent speech yet',
@@ -484,12 +531,10 @@ window.__ModuleLoader__.load({
       'queueLen': 'Queue',
       'sseState': 'SSE',
       'currentVoice': 'Voice',
-
       'statusOffline': 'Host unreachable',
       'cacheStats': 'Cache',
-
       'general': 'General',
-      'loading': 'Loading\u2026',
+      'loading': 'Loading…',
       'chainHintCard': 'Pick a provider, paste its API key, and Save (or leave the key field). The key is written to the host credentials store immediately. The browser never reads it back.',
       'speakRepliesHint': 'When on, each finished reply is synthesized on the host and played in this browser. Audio is not sent back to the model.',
       'chainHint': 'Top to bottom is the fallback order. Cloud keys are saved to the host credentials store, never into plugin settings.',
@@ -571,6 +616,8 @@ window.__ModuleLoader__.load({
       'roleReply': 'Reply',
       'roleApproval': 'Approval',
       'roleError': 'Error',
+      'ssmlStyle': 'SSML tone style',
+      'ssmlStyleHint': 'Expressive tone (e.g. cheerful, serious, empathetic).',
       'longReply': 'Long replies',
       'longReplyHint': 'truncate: cut at the limit; summarize: short retelling; full: read everything.',
       'summaryModel': 'Summary model',
@@ -583,9 +630,8 @@ window.__ModuleLoader__.load({
       'statHits': 'Cache hits',
       'statErrors': 'Errors',
       'statReset': 'Reset stats',
-
       'autoDetect': 'Auto language per piece',
-      'autoDetectHint': 'Guess ru/en per spoken piece instead of the language setting.',
+      'autoDetectHint': 'Guess zh/en per spoken piece instead of the language setting.',
       'narrateQuotesOnly': 'Only quotes',
       'narrateQuotesHint': 'Read only «quoted» fragments of a reply.',
       'skipActions': 'Skip *actions*',
@@ -596,7 +642,6 @@ window.__ModuleLoader__.load({
       'customBaseUrlHint': 'OpenAI-compatible origin, e.g. http://localhost:8880/v1; empty = off.',
       'customKeyEnv': 'Custom key env',
       'customKeyEnvHint': 'Credential name for the custom endpoint bearer key.',
-
       'localEnginesTitle': 'Local Engines (Offline)',
       'localEnginesHint': 'Run speech synthesis 100% offline without API keys.',
       'enableLocalEngines': 'Enable local engines',
@@ -613,7 +658,6 @@ window.__ModuleLoader__.load({
       'installKokoro': 'Install (350 MB)',
       'installF5': 'Install (2.1 GB)',
       'deleteModel': 'Delete',
-
       'voiceDuplexTitle': 'Voice Duplex (Voice-to-Voice)',
       'voiceDuplexHint': 'Interactive voice conversation integrated with dsh-voice.',
       'voiceNotInstalledTitle': 'Required plugin @goodandready/dsh-voice is not installed',
@@ -624,208 +668,207 @@ window.__ModuleLoader__.load({
       'vadBargeInHint': 'Mute speech synthesis immediately when user voice is detected.',
       'newSubagentRole': 'Subagent name (e.g. coder, reviewer)',
       'addSubagentRole': 'Add Subagent',
+      'autoDetectSubagent': 'Auto-detect subagent roles',
       'role_coder': 'Coder',
       'role_reviewer': 'Reviewer',
       'role_planner': 'Planner',
-
       'enableItDictionary': 'Built-in IT dictionary',
       'enableItDictionaryHint': 'Auto-correct pronunciation for SQL, Nginx, K8s, Docker, API, JSON, YAML, etc.',
       'loadItDictionary': 'Populate IT terms',
       'previewRule': 'Listen',
-
       'messengerIntegrationTitle': 'Messenger Integration (Telegram, Discord)',
       'messengerIntegrationHint': 'Voice replies and notes sent through @goodandready/dsh-messenger-gateway.',
       'messengerNotInstalledTitle': 'Required plugin @goodandready/dsh-messenger-gateway is not installed',
-      'messengerInstallHint': 'To enable voice notes in messengers, install the plugin with',
+      'messengerInstallHint': 'To enable voice replies in messengers, install the plugin with',
       'messengerTtsEnabled': 'Voice replies in messengers',
-      'messengerTtsEnabledHint': 'Allow messenger bridge to synthesize voice notes for agent replies.',
-
-      'dockLabel': 'Speech',
-      'dockPause': 'Pause',
-      'dockResume': 'Resume speech',
-      'dockStop': 'Stop speech',
-    }
-    const ru = {
-      'statusOnline': 'Хост на связи',
-      'recent': 'Недавние',
-      'recentEmpty': 'Пока нет реплик',
-      'retry': 'Повторить',
-      'advancedCollapsed': 'Дополнительно',
-      'confirmClearCache': 'Очистить кэш синтеза? Действие необратимо.',
-      'confirmDeleteModel': 'Удалить скачанные веса движка?',
-      'autoplayBlocked': 'Звук заблокирован — один раз кликните или коснитесь экрана',
-      'enableSound': 'Включить звук',
-      'runtimeNotBundled': 'Рантайм нейросинтеза не входит в пакет',
-      'runtimeNotBundledHint': 'Установка весов не включает речь. Для offline используйте Edge, Piper или eSpeak.',
-      'testProvider': 'Проверить провайдера',
-      'breakerOpen': 'Переключатель открыт',
-      'lastError': 'Последняя ошибка',
-      'activeProvider': 'Активный провайдер',
-      'queueLen': 'Очередь',
-      'sseState': 'SSE',
-      'currentVoice': 'Голос',
-
-      'statusOffline': 'Хост недоступен',
-      'cacheStats': 'Кэш',
-
-      'dockLabel': 'Чтение',
-      'dockPause': 'Пауза',
-      'dockResume': 'Продолжить чтение',
-      'dockStop': 'Прекратить чтение',
-
-      'general': 'Общее',
-      'loading': 'Загрузка…',
-      'chainHintCard': 'Выберите провайдера, вставьте ключ и нажмите «Сохранить» (или просто уйдите из поля). Ключ сразу попадает в хранилище учётных данных харнесса; браузер его обратно не читает.',
-      'speakRepliesHint': 'Каждый законченный ответ озвучивается на стороне харнесса и играет в этом браузере. Звук модели не отправляется.',
-      'chainHint': 'Порядок сверху вниз — порядок отката. Ключи облачных провайдеров попадают в хранилище учётных данных харнесса, а не в настройки плагина.',
-      'title': 'Озвучка',
-      'speakReplies': 'Читать ответы агента',
-      'speakAsItGoes': 'Читать по ходу',
-      'speakAsItGoesHint': 'Читать каждый ответ, как только он пришёл, предложениями, не дожидаясь конца хода.',
-      'rate': 'Скорость чтения',
-      'rateHint': 'От 0.5 до 2. Синтез не меняется — быстрее или медленнее играет браузер.',
-      'bargeIn': 'Замолкать, когда вы заговорили',
-      'bargeInHint': 'Прекращать чтение, как только открылся микрофон.',
-      'announce': 'Объявлять запрос подтверждения',
-      'announceHint': 'Говорить вслух и подавать сигнал, когда агент остановился ради подтверждения или задал вопрос.',
-      'approvalText': 'Что говорить о подтверждении',
-      'approvalHint': 'Произносится при запросе подтверждения; имя инструмента добавляется следом.',
-      'questionText': 'Что говорить о вопросе',
-      'questionHint': 'Произносится, когда агент задал вопрос. Пусто — не произносить.',
-      'chime': 'Сигнал',
-      'chimeHint': 'ding, beep или none.',
-      'language': 'Язык',
-      'languageHint': 'Подсказка для голосов, которым нужен язык (eSpeak, Azure SSML).',
-      'piperModel': 'Piper: путь к модели',
-      'piperModelHint': 'Абсолютный путь к модели ONNX. Пусто — Piper пропускается.',
-      'piperBin': 'Piper: бинарь',
-      'binHint': 'Ищется в PATH, если путь не абсолютный.',
-      'espeakBin': 'eSpeak: бинарь',
-      'espeakHint': 'Обычно espeak-ng.',
-      'edgeBin': 'edge-tts: бинарь',
-      'edgeHint': 'Консольная утилита из пакета edge-tts.',
-      'azureRegion': 'Azure: регион',
-      'azureHint': 'Нужен провайдеру azure, например eastus.',
-      'openaiBaseUrl': 'OpenAI base URL',
-      'openaiBaseUrlHint': 'OpenAI-совместимый origin для провайдера openai.',
-      'mimoBaseUrl': 'MiMo base URL',
-      'mimoBaseUrlHint': 'Корень API MiMo; синтез идёт через chat endpoint.',
-      'mimoFormat': 'Формат MiMo',
-      'mimoFormatHint': 'mp3 или wav.',
-      'minimaxBin': 'MiniMax CLI',
-      'minimaxBinHint': 'Ищется в PATH, если путь не абсолютный; вход в CLI — отдельно.',
-      'advancedTitle': 'Дополнительно',
-      'advancedHint': 'Лимиты и override endpoint. API-ключи — в редакторе цепочки; имена credential-слотов (*KeyEnv) — только в конфиге.',
-      'maxChars': 'Максимум символов',
-      'maxCharsHint': 'Жёсткий лимит до обработки длинных ответов; 0 — без лимита.',
-      'sentenceChars': 'Размер куска (символы)',
-      'sentenceCharsHint': 'Максимум символов в streaming-куске предложения.',
-      'timeoutMs': 'Таймаут провайдера (мс)',
-      'timeoutMsHint': 'Прервать попытку провайдера через столько миллисекунд.',
-      'maxQueue': 'Длина очереди',
-      'maxQueueHint': 'Отбрасывать самые старые куски сверх этого числа.',
-      'chainTitle': 'Цепочка провайдеров',
-      'addProvider': 'Добавить провайдера',
-      'localProvider': 'Локальный провайдер — ключ не нужен',
-      'configured': 'Ключ задан',
-      'notSet': 'Ключа нет',
-      'fromEnv': 'Задан в окружении',
-      'clear': 'Убрать',
-      'remove': 'Удалить',
-      'up': 'Выше',
-      'down': 'Ниже',
-      'save': 'Сохранить',
-      'saved': 'Сохранено',
-      'cardHint': 'Цепочка провайдеров, голоса и параметры чтения.',
-      'skipCode': 'Пропускать код',
-      'skipCodeHint': 'Вместо чтения кода вслух — короткая пометка.',
-      'cache': 'Кэш синтеза',
-      'cacheHint': 'Повторяющиеся фразы не синтезируются заново.',
-      'cacheMaxMb': 'Лимит кэша, МБ',
-      'cacheMaxMbHint': 'Сначала вытесняется самое давнее по использованию.',
-      'clearCache': 'Очистить кэш',
-      'pronTitle': 'Произношение',
-      'pronHint': 'Правила работают сверху вниз; /…/ в левой части — регулярка; Язк ограничивает правило.',
-      'pronFrom': 'Заменить',
-      'pronTo': 'На',
-      'pronWhole': 'Целое слово',
-      'pronLang': 'Язк',
-      'addRule': 'Добавить правило',
-      'rolesTitle': 'Голоса ролей',
-      'rolesHint': 'Пустые поля наследуют основную цепочку.',
-      'roleReply': 'Ответ',
-      'roleApproval': 'Подтверждение',
-      'roleError': 'Ошибка',
-      'longReply': 'Длинные ответы',
-      'longReplyHint': 'truncate: обрезать; summarize: короткий пересказ; full: читать целиком.',
-      'summaryModel': 'Модель пересказа',
-      'summaryModelHint': 'provider/model, пусто — как у разговора.',
-      'summarySentences': 'Длина пересказа',
-      'summarySentencesHint': 'Предложений в озвучиваемом пересказе.',
-      'preview': 'Проба',
-      'statsTitle': 'Статистика',
-      'statTotal': 'Всего',
-      'statHits': 'Кэш-хиты',
-      'statErrors': 'Ошибки',
-      'statReset': 'Сбросить',
-
-      'autoDetect': 'Автоязык по куску',
-      'autoDetectHint': 'Подсказывать провайдеру ru/en по каждому куску вместо общей настройки.',
-      'narrateQuotesOnly': 'Только цитаты',
-      'narrateQuotesHint': 'Читать только фрагменты в кавычках.',
-      'skipActions': 'Пропускать *действия*',
-      'skipActionsHint': 'Вырезать блоки в звёздочках.',
-      'removeRegex': 'Регулярка вырезания',
-      'removeRegexHint': 'Глобальная регулярка: совпадения удаляются перед синтезом.',
-      'customBaseUrl': 'Свой TTS endpoint',
-      'customBaseUrlHint': 'OpenAI-compatible base URL, e.g. http://localhost:8880/v1; empty disables it.',
-      'customKeyEnv': 'Имя ключа для endpoint',
-      'customKeyEnvHint': 'Имя credential для Bearer-ключа своего endpointа.',
-
-      'localEnginesTitle': 'Локальные движки (Offline)',
-      'localEnginesHint': 'Автономный синтез без API-ключей и интернета.',
-      'enableLocalEngines': 'Включить локальные движки',
-      'enableLocalEnginesHint': 'Использовать Kokoro или F5-TTS при наличии моделей.',
-      'streamingEnabled': 'Мгновенный потоковый звук (< 300 мс)',
-      'streamingEnabledHint': 'Воспроизводить звук через AudioWorklet и SSE без задержек.',
-      'useKokoro': 'Использовать Kokoro-82M (CPU)',
-      'useKokoroHint': 'Быстрый нейросинтез на процессоре.',
-      'useF5': 'Использовать F5-TTS (GPU)',
-      'useF5Hint': 'Высокоточный синтез на видеокарте NVIDIA.',
-      'installed': 'Установлена',
-      'notInstalled': 'Не установлена',
-      'downloading': 'Загрузка',
-      'installKokoro': 'Установить (350 МБ)',
-      'installF5': 'Установить (2.1 ГБ)',
-      'deleteModel': 'Удалить',
-
-      'voiceDuplexTitle': 'Голосовой диалог (Voice-to-Voice)',
-      'voiceDuplexHint': 'Интерактивный голосовой разговор при наличии плагина dsh-voice.',
-      'voiceNotInstalledTitle': 'Плагин @goodandready/dsh-voice не установлен',
-      'voiceInstallHint': 'Для включения голосового диалога установите плагин командой',
-      'voiceDuplex': 'Voice-to-Voice режим',
-      'voiceDuplexHintToggle': 'Автоматически отвечать голосом после завершения голосовой реплики.',
-      'vadBargeIn': 'VAD Barge-in',
-      'vadBargeInHint': 'Мгновенно глушить речь ассистента при обнаружении голоса пользователя.',
-      'newSubagentRole': 'Имя субагента (например, coder, reviewer)',
-      'addSubagentRole': 'Добавить субагента',
-      'role_coder': 'Кодер',
-      'role_reviewer': 'Ревьюер',
-      'role_planner': 'Планировщик',
-
-      'enableItDictionary': 'Предустановленный словарь IT-терминов',
-      'enableItDictionaryHint': 'Автоматически заменять SQL, Nginx, K8s, Docker, API, JSON, YAML и др. на правильное произношение.',
-      'loadItDictionary': 'Вставить IT-термины в таблицу',
-      'previewRule': 'Прослушать',
-
-      'messengerIntegrationTitle': 'Интеграция с мессенджерами (Telegram, Discord)',
-      'messengerIntegrationHint': 'Озвучивание ответов и голосовые заметки через @goodandready/dsh-messenger-gateway.',
-      'messengerNotInstalledTitle': 'Плагин @goodandready/dsh-messenger-gateway не установлен',
-      'messengerInstallHint': 'Для отправки голосовых сообщений в мессенджеры установите плагин командой',
-      'messengerTtsEnabled': 'Голосовые ответы в мессенджеры',
-      'messengerTtsEnabledHint': 'Разрешить мосту мессенджеров озвучивать ответы голосовыми заметками.',
+      'messengerTtsEnabledHint': 'Allow the messenger gateway to deliver replies as voice notes.',
     }
 
+    const zh = {
+      'dockLabel': '语音朗读',
+      'dockPause': '暂停朗读',
+      'dockResume': '继续朗读',
+      'dockStop': '停止朗读',
+      'dockCurrent': '当前朗读',
+      'dockNone': '等待语音',
+      'dockQueue': '队列',
+      'dockClearQueue': '清空队列',
+      'dockReplay': '重新朗读',
+      'dockFavorite': '收藏',
+      'dockUnfavorite': '取消收藏',
+      'dockFavorites': '收藏语音',
+      'exportAudio': '导出语音片段',
+      'exportSuccess': '音频已导出',
+      'statusOnline': '服务在线',
+      'recent': '最近朗读',
+      'recentEmpty': '暂无朗读记录',
+      'retry': '重试',
+      'advancedCollapsed': '高级设置',
+      'confirmClearCache': '确定清除语音合成缓存吗？此操作无法撤销。',
+      'confirmDeleteModel': '确定删除该引擎已下载的模型权重吗？',
+      'autoplayBlocked': '声音已受系统限制，请点击任意位置以激活音频',
+      'enableSound': '开启声音',
+      'runtimeNotBundled': '未捆绑神经推理运行时',
+      'runtimeNotBundledHint': '仅下载权重无法直接合成。建议使用 Edge、Piper 或 eSpeak 进行离线语音合成。',
+      'testProvider': '测试服务商',
+      'breakerOpen': '熔断中',
+      'lastError': '最近错误',
+      'activeProvider': '当前服务商',
+      'queueLen': '队列长度',
+      'sseState': 'SSE状态',
+      'currentVoice': '发音人',
+      'statusOffline': '服务不可达',
+      'cacheStats': '缓存统计',
+      'general': '常规设置',
+      'loading': '加载中…',
+      'chainHintCard': '选择服务商，粘贴 API Key 并保存。密钥将直接写入服务端安全凭证库，前端不会回显。',
+      'speakRepliesHint': '启用后，智能体回复将在服务端合成语音并在当前浏览器中播放。音频不会回传至模型。',
+      'chainHint': '从上到下为降级候选顺序。云端密钥直接保存在服务端凭证中心，绝不存入插件公开设置中。',
+      'title': '语音朗读 (TTS)',
+      'speakReplies': '朗读智能体回复',
+      'speakAsItGoes': '流式逐句朗读',
+      'speakAsItGoesHint': '模型输出时按句子即时流式朗读，无需等待整段内容生成完毕。',
+      'rate': '播放语速',
+      'rateHint': '0.5 到 2.0 倍速。服务端按标准速度合成，由浏览器调整播放速率。',
+      'bargeIn': '打断静音 (Barge-in)',
+      'bargeInHint': '当麦克风开启或检测到说话时立即中断朗读。',
+      'announce': '重要事件播报',
+      'announceHint': '当智能体等待用户审批或提出问题时，播放提示音并语音播报。',
+      'approvalText': '审批提示语',
+      'approvalHint': '请求审批时播报的短语，会自动附带工具名称。',
+      'questionText': '提问提示语',
+      'questionHint': '智能体提问时播报的前导短语。留空则直接读出问题。',
+      'chime': '提示音效',
+      'chimeHint': '可选 ding、beep 或无。',
+      'language': '语言选择',
+      'languageHint': '针对需要指定语言的服务商（如 eSpeak 或 Azure SSML）。',
+      'piperModel': 'Piper 模型路径',
+      'piperModelHint': 'ONNX 模型的绝对路径。留空则跳过 Piper。',
+      'piperBin': 'Piper 可执行文件',
+      'binHint': '默认从 PATH 查找，除非指定绝对路径。',
+      'espeakBin': 'eSpeak 可执行文件',
+      'espeakHint': '通常为 espeak-ng。',
+      'edgeBin': 'edge-tts 可执行文件',
+      'edgeHint': 'Python edge-tts 命令行工具。',
+      'azureRegion': 'Azure 区域',
+      'azureHint': 'Azure 语音服务所在区域，例如 eastus。',
+      'openaiBaseUrl': 'OpenAI API 地址',
+      'openaiBaseUrlHint': '兼容 OpenAI 的 TTS 接口地址。',
+      'mimoBaseUrl': 'MiMo API 地址',
+      'mimoBaseUrlHint': 'MiMo 接口根地址，通过其对话接口提取语音。',
+      'mimoFormat': 'MiMo 音频格式',
+      'mimoFormatHint': 'mp3 或 wav。',
+      'minimaxBin': 'MiniMax CLI 路径',
+      'minimaxBinHint': '默认从 PATH 查找，需提前安装并登录。',
+      'advancedTitle': '高级参数',
+      'advancedHint': '字符上限与接口重定向。API 密钥在候选链中维护，凭证环境变量仅在后台生效。',
+      'maxChars': '最大字符上限',
+      'maxCharsHint': '触发长文本截断或摘要的硬性上限；0 表示无限制。',
+      'sentenceChars': '单句切片大小',
+      'sentenceCharsHint': '流式语音合成中单句的最大字符长度。',
+      'timeoutMs': '服务商超时 (毫秒)',
+      'timeoutMsHint': '单次语音合成请求超时时间，超时后自动切换下一服务商。',
+      'maxQueue': '最大队列长度',
+      'maxQueueHint': '超出该长度时丢弃最旧的未播放语音片段。',
+      'chainTitle': '服务商降级链 (Fallback Chain)',
+      'addProvider': '添加服务商',
+      'localProvider': '本地 / CLI 服务商（无需 API 密钥）',
+      'configured': '已配置',
+      'notSet': '未设置',
+      'fromEnv': '来自环境变量',
+      'clear': '清空',
+      'remove': '移除',
+      'up': '上移',
+      'down': '下移',
+      'save': '保存设置',
+      'saved': '已保存',
+      'cardHint': '配置服务商降级顺序、发音人与朗读参数。',
+      'skipCode': '跳过代码块',
+      'skipCodeHint': '遇到代码块时朗读简短提示，而不逐行朗读代码字符。',
+      'cache': '合成音频缓存',
+      'cacheHint': '重复短语直接从本地缓存读取，无需重复合成。',
+      'cacheMaxMb': '缓存上限 (MB)',
+      'cacheMaxMbHint': '超出容量时优先淘汰最近最少使用 (LRU) 的音频。',
+      'clearCache': '清空缓存',
+      'pronTitle': '发音纠正字典',
+      'pronHint': '规则自上而下匹配。左侧支持 /…/ 正则表达式；支持按语言过滤。',
+      'pronFrom': '原词',
+      'pronTo': '替换为',
+      'pronWhole': '全词匹配',
+      'pronLang': '语言',
+      'addRule': '添加规则',
+      'rolesTitle': '角色专属音色',
+      'rolesHint': '留空项将自动继承主服务商配置。',
+      'roleReply': '普通回复',
+      'roleApproval': '操作审批',
+      'roleError': '系统错误',
+      'ssmlStyle': '情感语调 (SSML)',
+      'ssmlStyleHint': '情绪语调风格（如 cheerful、serious、empathetic 等）。',
+      'longReply': '长回复处理',
+      'longReplyHint': 'truncate: 截断超长部分; summarize: 智能生成简述; full: 完整朗读全文。',
+      'summaryModel': '摘要生成模型',
+      'summaryModelHint': 'provider/model 格式，留空则跟随当前对话模型。',
+      'summarySentences': '摘要句数',
+      'summarySentencesHint': '语音朗读所采用的摘要句子数量。',
+      'preview': '试听',
+      'statsTitle': '实时统计',
+      'statTotal': '总请求数',
+      'statHits': '缓存命中',
+      'statErrors': '合成失败',
+      'statReset': '重置统计',
+      'autoDetect': '按句自动识别语种',
+      'autoDetectHint': '每句根据字符特征自动推测语言，而非强制使用全局设定。',
+      'narrateQuotesOnly': '仅朗读引用内容',
+      'narrateQuotesHint': '仅朗读正文中用引号括起来的引用短语。',
+      'skipActions': '跳过 *星号动作*',
+      'skipActionsHint': '自动剔除 *动作说明* 文本。',
+      'removeRegex': '自定义正则过滤',
+      'removeRegexHint': '在合成前由全局正则表达式匹配并剔除匹配文本。',
+      'customBaseUrl': '自定义 TTS API 地址',
+      'customBaseUrlHint': '兼容 OpenAI 的接口地址，如 http://localhost:8880/v1；留空禁用。',
+      'customKeyEnv': '自定义接口凭据名',
+      'customKeyEnvHint': '用于存储自定义接口 Bearer Token 的凭证槽位名称。',
+      'localEnginesTitle': '本地离线引擎 (Offline)',
+      'localEnginesHint': '在本地离线运行语音合成，无需 API 密钥与互联网。',
+      'enableLocalEngines': '启用本地引擎',
+      'enableLocalEnginesHint': '检测并调用本地 Kokoro 或 F5-TTS 模型。',
+      'streamingEnabled': '毫秒级低延迟流式 (< 300 ms)',
+      'streamingEnabledHint': '利用 AudioWorklet 和 SSE 实时输出流式音频。',
+      'useKokoro': '启用 Kokoro-82M (CPU)',
+      'useKokoroHint': '基于 CPU 的轻量级快速神经语音合成。',
+      'useF5': '启用 F5-TTS (GPU)',
+      'useF5Hint': '基于 NVIDIA GPU 的高保真零样本克隆语音合成。',
+      'installed': '已就绪',
+      'notInstalled': '未安装',
+      'downloading': '下载中',
+      'installKokoro': '安装权重 (350 MB)',
+      'installF5': '安装权重 (2.1 GB)',
+      'deleteModel': '删除模型',
+      'voiceDuplexTitle': '双工语音对话 (Voice-to-Voice)',
+      'voiceDuplexHint': '与 dsh-voice 协同提供全双工交互式对话。',
+      'voiceNotInstalledTitle': '依赖插件 @goodandready/dsh-voice 尚未安装',
+      'voiceInstallHint': '如需启用语音对话，请通过以下命令安装该插件：',
+      'voiceDuplex': '语音双工模式',
+      'voiceDuplexHintToggle': '用户语音输入结束后，自动使用语音朗读回复。',
+      'vadBargeIn': 'VAD 语音打断',
+      'vadBargeInHint': '检测到人类语音时立即终止智能体当前语音输出。',
+      'newSubagentRole': '子智能体标识 (例如 coder, reviewer)',
+      'addSubagentRole': '添加子智能体',
+      'autoDetectSubagent': '自动感应会话中的子智能体角色',
+      'role_coder': '编码助手 (Coder)',
+      'role_reviewer': '代码评审 (Reviewer)',
+      'role_planner': '架构规划 (Planner)',
+      'enableItDictionary': '内置 IT 术语发音校正',
+      'enableItDictionaryHint': '自动纠正 SQL、Nginx、K8s、Docker、API、JSON、YAML 等专有名词发音。',
+      'loadItDictionary': '填入常用 IT 术语',
+      'previewRule': '试听发音',
+      'messengerIntegrationTitle': '即时通讯联动 (Telegram, Discord)',
+      'messengerIntegrationHint': '通过 @goodandready/dsh-messenger-gateway 向聊天群组发送语音回复。',
+      'messengerNotInstalledTitle': '依赖插件 @goodandready/dsh-messenger-gateway 尚未安装',
+      'messengerInstallHint': '如需向聊天软件发送语音回复，请运行：',
+      'messengerTtsEnabled': '群组语音回复',
+      'messengerTtsEnabledHint': '允许网关将回复以语音便签 (Voice Note) 形式发送。',
+    }
     function ChainEditor(props) {
       // Translator comes from the card: the slot passes props.t only to it.
       const t = props.t || ((key) => key)
@@ -1091,7 +1134,8 @@ window.__ModuleLoader__.load({
             onChange: (e) => set(r, { chime: e.target.value }),
           }),
           React.createElement('input', {
-            className: 'dts-input dts-grow', placeholder: 'ssml',
+            className: 'dts-input dts-grow', placeholder: t('ssmlStyle') || 'ssml',
+            title: t('ssmlStyleHint') || 'SSML tone style',
             value: (value[r] && value[r].ssmlStyle) || '', disabled: !props.writable,
             onChange: (e) => set(r, { ssmlStyle: e.target.value }),
           }),
@@ -1511,6 +1555,7 @@ window.__ModuleLoader__.load({
         ),
         React.createElement('div', { className: 'dts-block' },
           React.createElement('div', { className: 'dts-h' }, t('rolesTitle')),
+          boolField('autoDetectSubagent', t('autoDetectSubagent'), t('autoDetectSubagent')),
           React.createElement(RolesEditor, {
             t: t, writable: writable, onPreview: onPreview,
             value: draft && draft.roles ? draft.roles : {},
@@ -1669,6 +1714,10 @@ window.__ModuleLoader__.load({
           type: 'button', className: 'dts-link', title: '★',
           onClick: () => { recent.toggleFav(text); force() },
         }, starred ? '★' : '☆'),
+        React.createElement('button', {
+          type: 'button', className: 'dts-link', title: t('exportAudio') || 'Export',
+          onClick: () => exportAudioClip(text),
+        }, '⤓'),
       )
       return React.createElement('div', { style: { position: 'relative', display: 'inline-flex', gap: '4px', alignItems: 'center' } },
         React.createElement('button', {
@@ -1697,6 +1746,12 @@ window.__ModuleLoader__.load({
           title: t('dockStop'),
           onClick: stopPlayback,
         }, '■'),
+        React.createElement('button', {
+          type: 'button',
+          className: 'dts-link',
+          title: t('exportAudio') || 'Export clip',
+          onClick: () => exportAudioClip(player.lastText),
+        }, '⤓'),
       )
     }
 
@@ -1737,7 +1792,7 @@ window.__ModuleLoader__.load({
         }
       }
       ctx.effect(() => {
-        const undo = [addLocale('en', en), addLocale('ru', ru)]
+        const undo = [addLocale('en', en), addLocale('zh', zh)]
         return () => { for (const off of undo) off() }
       }, 'dsh-tts: locales')
     // The sidebar draws the section label, not our component: props.t never

package/lib/index.js

@@ -100,6 +100,8 @@ export const Config = z.object({
     .description('Mute speech synthesis immediately when voice activity is detected.'),
   messengerTtsEnabled: z.boolean().default(false)
     .description('Send synthesized voice notes to messengers via @goodandready/dsh-messenger-gateway.'),
+  autoDetectSubagent: z.boolean().default(true)
+    .description('Auto-detect subagent roles in multi-agent sessions and route to dedicated voice profiles.'),
   language: z.string().default('ru'),
   speakAsItGoes: z
     .boolean()
@@ -519,8 +521,12 @@ export function apply(ctx, config) {
 
     if (event.type === 'assistant/message') {
       const text = assistantText(event.data && event.data.message)
-      const agentName = (event.data && (event.data.agent || (event.data.message && event.data.message.agent) || (event.data.message && event.data.message.author && event.data.message.author.name))) || (session && session.agent) || ''
-      const activeRole = (agentName && cfg.roles && cfg.roles[agentName] && cfg.roles[agentName].provider) ? agentName : 'reply'
+      const agentName = (event.data && (
+        event.data.subagent ||
+        event.data.agent ||
+        (event.data.message && (event.data.message.subagent || event.data.message.agent || event.data.message.sender || (event.data.message.author && event.data.message.author.name)))
+      )) || (session && (session.subagent || session.agent)) || ''
+      const activeRole = (agentName && cfg.roles && cfg.roles[agentName] && (cfg.roles[agentName].provider || cfg.roles[agentName].voice)) ? agentName : 'reply'
 
       // Speak as it goes: each incoming chunk is spoken immediately
       // in sentence pieces; waiting for turn end means silence while the agent works.