@goodandready/dsh-tts 0.4.6 → 0.4.8

package/README.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>If you like this plugin, please star it on GitHub</strong> — it shows me that the plugin is useful to you and motivates me to keep developing it.
+      <br><br>
+      🐛 <strong>If you find a bug or would like to request a feature</strong>, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -100,12 +110,21 @@ graph LR
 
 ### 5. 👥 Multi-Agent Personas & Subagent Voice Overrides
 * Assign distinct voices, providers, models, and audio chimes to individual subagents (e.g. `coder`, `reviewer`, `planner`, `tester`).
-* Automatically matches incoming assistant turn events (`session.agent` or `message.agent`).
+* **Subagent Auto-Detection**: With `autoDetectSubagent` enabled, incoming turns automatically match subagents by message metadata (`subagent`, `agent`, `author`, `name`) and dynamically apply voice, rate, and SSML style presets.
+
+### 6. 💾 Audio Clip Export & Speech History
+* Export any spoken utterance directly to an audio file (`.wav` / `.mp3`) via `exportAudioClip(text)`.
+* Instant download buttons (`⤓`) integrated directly into the input dock speaker control and recent utterances dropdown list.
 
-### 6. 💬 Messenger Voice Notes Integration (with `@goodandready/dsh-messenger-gateway`)
+### 7. 💬 Messenger Voice Notes Integration (with `@goodandready/dsh-messenger-gateway`)
 * Generates voice audio for Telegram and Discord bot replies via `POST /dsh-tts/speak`.
 * Protective dependency check with installation hint when gateway plugin is missing.
 
+### 8. 🌐 Canonical English & Chinese Localization (EN + ZH)
+* Complete built-in English (`en`) and Chinese (`zh`) UI and speech template dictionaries.
+* Centralized Russian localization provided via `@goodandready/dsh-russian-lang` through Gitea issue tracking.
+* Smart boundary tokenizer supporting CJK full-width punctuation (`。！？`), abbreviations, file extensions, and IP/version numbers.
+
 ---
 
 ## 🛠️ Complete Supported Providers Matrix (18 Backends)

package/README.ru.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -29,7 +39,6 @@
 
 > **Честно про локальные нейросети:** Kokoro/F5 — только статус и загрузка весов. Inference **не входит** в пакет; эти провайдеры падают с понятной причиной, цепочка идёт дальше. Рабочий offline: Edge TTS, Piper, eSpeak.
 
-
 **`dsh-tts`** обеспечивает качественное голосовое озвучивание ответов ассистента в веб-интерфейсе **DeepSeek Harness**. При включённой опции **«Читать ответы агента»**, каждая готовая реплика или потоковый фрагмент синтезируется на хосте и мгновенно воспроизводится в браузере.
 
 API-ключи никогда не передаются в браузер: синтез аудио выполняется на стороне хоста через **независимые цепочки отказоустойчивости (фолбеков)**, включая системные offline-движки (Edge TTS, Piper, eSpeak). Kokoro/F5 — только загрузка весов; inference не входит в пакет.

package/README.zh.md

@@ -21,6 +21,16 @@
   <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。
+      <br><br>
+      🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -93,14 +103,23 @@ graph LR
 * **预配置词汇表**：为常见技术缩写和开发者术语提供正确语音替换（SQL、Nginx、Kubernetes/K8s、Docker、API、JSON、YAML、GUI、CLI、CI/CD 等 25 个术语）。
 * **交互式编辑器**：编辑规则，逐条点击 **▶ 试听** 按钮预听效果，一键加载全部 IT 术语。
 
-### 5. 👥 多智能体角色个性化语音
-* 为不同子智能体（`coder`、`reviewer`、`planner`、`tester` 等）分配独立的语音、服务商、模型和提示音。
-* 自动从会话事件中识别智能体名称。
+### 5. 👥 多智能体角色个性化语音与自动识别
+* 为不同子智能体（`coder`、`reviewer`、`planner`、`tester` 等）分配独立的语音、服务商、模型、提示音与 SSML 风格。
+* **智能体自动识别**：开启 `autoDetectSubagent` 后，自动根据消息元数据（`subagent`、`agent`、`author`、`name`）匹配对应的专属音色与语速。
+
+### 6. 💾 音频片段导出与历史回放
+* 任意朗读过的回复均可通过 `exportAudioClip(text)` 导出为标准音频文件（`.wav` / `.mp3`）。
+* 输入框控制栏及最近朗读列表中内置即时下载按钮（`⤓`）。
 
-### 6. 💬 即时通讯语音消息集成（配合 `@goodandready/dsh-messenger-gateway`）
+### 7. 💬 即时通讯语音消息集成（配合 `@goodandready/dsh-messenger-gateway`）
 * 通过 `POST /dsh-tts/speak` 为 Telegram 和 Discord 机器人回复生成语音消息。
 * 缺少网关插件时自动显示安装提示，防护性依赖检查。
 
+### 8. 🌐 深度中文本土化支持与智能断句分词器
+* 完整内置英文 (`en`) 与中文 (`zh`) 双语界面及全量语音模版。
+* 针对 CJK 中文全角标点（`。！？`）与自适应分词长度特别优化，避免长句卡顿。
+* 保护缩写、文件名（`package.json`）、网址域名（`goodandready.app`）及 IP / 版本号不被误切。
+
 ---
 
 ## 🛠️ 支持的 18 大服务商矩阵

package/lib/client-src/20-player.js

@@ -141,6 +141,7 @@
           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
@@ -322,6 +323,38 @@
         .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: '' }
     }

package/lib/client-src/30-locales.js

@@ -1,4 +1,18 @@
     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',
@@ -17,12 +31,10 @@
       '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.',
@@ -104,6 +116,8 @@
       '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',
@@ -116,9 +130,8 @@
       '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*',
@@ -129,7 +142,6 @@
       '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',
@@ -146,7 +158,6 @@
       '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',
@@ -157,205 +168,204 @@
       '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',
+      'messengerTtsEnabledHint': 'Allow the messenger gateway to deliver replies as voice notes.',
     }
-    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': 'Разрешить мосту мессенджеров озвучивать ответы голосовыми заметками.',
+    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) 形式发送。',
     }
-