@goodandready/dsh-tts 0.3.23 → 0.4.0

package/README.md

@@ -29,7 +29,7 @@
 
 **`dsh-tts`** provides robust, lifelike spoken voice synthesis for assistant replies in the **DeepSeek Harness** Web UI. When **Speak agent replies** is enabled, each finished assistant turn or real-time streaming chunk is synthesized on the host and streamed directly to the browser.
 
-API keys never reach client browsers: synthesis is executed entirely on the host backend across **independent multi-provider fallback chains**, including completely offline neural models (Kokoro-82M and F5-TTS).
+API keys never reach client browsers: synthesis is executed entirely on the host backend across **independent multi-provider fallback chains**, including local system engines (Edge TTS, Piper, eSpeak). Kokoro-82M and F5-TTS weights can be downloaded for future runtime support, but neural inference is **not bundled** in this package — those providers fail honestly and the chain continues.
 
 ```mermaid
 graph LR
@@ -49,10 +49,10 @@ graph LR
 
     subgraph Fallback [TTS Provider Fallback Chain]
         LRU -->|Cache Miss| Chain{Active Chain}
-        Chain -->|Priority 1| P1[Kokoro / F5-TTS Local Offline]
-        Chain -.->|Cloud Neural| P2[ElevenLabs / OpenAI / CosyVoice]
-        Chain -.->|Free Cloud / Edge| P3[EdgeTTS / SiliconFlow]
-        Chain -.->|System Fallback| P4[Local Piper / eSpeak NG]
+        Chain -->|Offline| P1[Edge TTS / Piper / eSpeak]
+        Chain -.->|Cloud Neural| P2[OpenAI / ElevenLabs / Google / Azure / Groq]
+        Chain -.->|OpenAI-compatible| P3[SiliconFlow / DeepInfra / Fireworks / OpenRouter]
+        Chain -.->|Other| P4[MiMo / MiniMax / Custom]
     end
 
     subgraph Output [Delivery & Integrations]
@@ -75,9 +75,9 @@ graph LR
 
 ## 🚀 Key Features
 
-### 1. 📴 Offline Local Neural Engines (Kokoro CPU & F5-TTS GPU)
-* **Kokoro-82M (CPU)**: 82M-parameter lightweight neural model running locally on CPU via ONNX Runtime. High-speed synthesis with zero cloud dependencies.
-* **F5-TTS (GPU)**: Zero-shot diffusion transformer voice synthesis running on NVIDIA GPUs via a local inference daemon.
+### 1. 📴 Offline system engines + optional future neural runtimes
+* **Edge TTS / Piper / eSpeak**: fully offline or free local/system synthesis without cloud API keys (Edge needs the `edge-tts` CLI).
+* **Kokoro-82M / F5-TTS**: weight download and status UI only. **Neural inference is not bundled** in this package — those providers fail with a clear reason and the fallback chain continues. Do not enable them expecting speech until a supported runtime is wired.
 * **ModelManager UI**: Direct manual installation in settings with real-time download progress bar, SHA-256 validation, and deletion. No silent or automatic multi-gigabyte downloads.
 
 ### 2. ⚡ Real-Time Streaming Audio (< 300 ms Latency)
@@ -112,8 +112,8 @@ graph LR
 
 | Provider Key | Service Backend | Default Model | Default Voice | Credential Ref | Features & Notes |
 |---|---|---|---|---|---|
-| `kokoro` | Local Kokoro-82M ONNX | `hexgrad/Kokoro-82M` | `af_bella` | *None* | **100% offline CPU neural synthesis** |
-| `f5` | Local F5-TTS GPU Daemon | `F5-TTS` | Default | *None* | **High-fidelity GPU zero-shot voice synthesis** |
+| `kokoro` | Local Kokoro-82M ONNX | `hexgrad/Kokoro-82M` | `af_bella` | *None* | Weights downloadable; **ONNX inference not bundled** — fails honestly |
+| `f5` | Local F5-TTS GPU Daemon | `F5-TTS` | Default | *None* | Daemon ping only; **GPU inference not bundled** — fails honestly |
 | `elevenlabs` | ElevenLabs API | `eleven_multilingual_v2` | `Rachel` | `ELEVENLABS_API_KEY` | Ultra-realistic, emotional nuance |
 | `openai` | OpenAI Audio | `gpt-4o-mini-tts` / `tts-1` | `alloy` | `OPENAI_API_KEY` | High-quality industry standard |
 | `edge` | Microsoft Edge Online | `ru-RU-SvetlanaNeural` | `ru-RU-SvetlanaNeural` | *None* | **Free, high-fidelity neural TTS without API keys** |
@@ -170,8 +170,8 @@ dsh-tts:
   cacheMaxMb: 150
   autoDetect: true
   chain:
-    - provider: kokoro
     - provider: edge
+    - provider: espeak
       voice: ru-RU-SvetlanaNeural
     - provider: openai
       model: tts-1
@@ -192,7 +192,7 @@ dsh-tts:
 * `GET /dsh-tts/stream` — Real-time Server-Sent Events (SSE) audio streaming.
 * `POST /dsh-tts/speak` — `{ text, voice?, model? }` → Returns synthesized audio.
 * `POST /dsh-tts/preview` — `{ provider, model, voice, text? }` → Test voice playback in UI.
-* `GET /dsh-tts/models/status` — Reports local Kokoro and F5-TTS model installation states.
+* `GET /dsh-tts/models/status` — Reports Kokoro/F5 weight installation states (download only; inference not bundled).
 * `POST /dsh-tts/models/install` — `{ engine: 'kokoro' | 'f5' }` → Starts HuggingFace model download.
 * `DELETE /dsh-tts/models/delete` — `{ engine: 'kokoro' | 'f5' }` → Removes local model files.
 * `GET /dsh-tts/integrations` — Status of sibling plugins (`dsh-voice`, `dsh-messenger-gateway`).

package/README.ru.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-<h3>Многопровайдерная озвучка ответов агента с локальными нейродвижками, потоковым звуком (<300 мс), IT-словарём и интеграцией с мессенджерами для DeepSeek Harness</h3>
+<h3>Многопровайдерная озвучка ответов агента: облачные и системные offline-движки, потоковый звук, IT-словарь и интеграция с мессенджерами для DeepSeek Harness</h3>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@goodandready/dsh-tts"><img src="https://img.shields.io/npm/v/@goodandready/dsh-tts.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
@@ -27,9 +27,12 @@
 
 ## ⚡ Обзор
 
+> **Честно про локальные нейросети:** Kokoro/F5 — только статус и загрузка весов. Inference **не входит** в пакет; эти провайдеры падают с понятной причиной, цепочка идёт дальше. Рабочий offline: Edge TTS, Piper, eSpeak.
+
+
 **`dsh-tts`** обеспечивает качественное голосовое озвучивание ответов ассистента в веб-интерфейсе **DeepSeek Harness**. При включённой опции **«Читать ответы агента»**, каждая готовая реплика или потоковый фрагмент синтезируется на хосте и мгновенно воспроизводится в браузере.
 
-API-ключи никогда не передаются в браузер: синтез аудио выполняется на стороне хоста через **независимые цепочки отказоустойчивости (фолбеков)**, включая полностью локальные оффлайн-нейросети (Kokoro-82M и F5-TTS).
+API-ключи никогда не передаются в браузер: синтез аудио выполняется на стороне хоста через **независимые цепочки отказоустойчивости (фолбеков)**, включая системные offline-движки (Edge TTS, Piper, eSpeak). Kokoro/F5 — только загрузка весов; inference не входит в пакет.
 
 ```mermaid
 graph LR
@@ -49,8 +52,8 @@ graph LR
 
     subgraph Fallback [Цепочка фолбеков TTS]
         LRU -->|Промах кэша| Chain{Активная цепочка}
-        Chain -->|1-й приоритет| P1[Kokoro / F5-TTS Локально]
-        Chain -.->|Облачные нейросети| P2[ElevenLabs / OpenAI / CosyVoice]
+        Chain -->|Offline| P1[Edge TTS / Piper / eSpeak]
+        Chain -.->|Cloud| P2[OpenAI / ElevenLabs / Google / Azure / Groq]
         Chain -.->|Бесплатные облака| P3[EdgeTTS / SiliconFlow]
         Chain -.->|Системный фолбек| P4[Локальный Piper / eSpeak NG]
     end
@@ -75,9 +78,9 @@ graph LR
 
 ## 🚀 Ключевые возможности
 
-### 1. 📴 Полностью локальные оффлайн-движки (Kokoro CPU и F5-TTS GPU)
-* **Kokoro-82M (CPU)**: Компактная нейросетевая модель (82 млн параметров), работающая локально на CPU через ONNX Runtime. Быстрый синтез без внешних API и интернета.
-* **F5-TTS (GPU)**: Диффузионный трансформер нулевого выстрела (zero-shot) на видеокартах NVIDIA через выделенный локальный демон инференса.
+### 1. 📴 Offline-системные движки и честный статус нейросетей
+* **Edge TTS / Piper / eSpeak**: рабочий offline/системный синтез без облачных API-ключей.
+* **Kokoro-82M / F5-TTS**: только UI и загрузка весов. **Inference не входит в пакет** — провайдер падает с понятной причиной, цепочка идёт дальше.
 * **ModelManager в UI**: Ручная загрузка моделей прямо из настроек плагина с отображением процентов и прогресс-бара, проверкой SHA-256 и кнопкой удаления. Никаких скрытых или автозагрузок гигабайтных весов.
 
 ### 2. ⚡ Потоковое воспроизведение звука с задержкой < 300 мс
@@ -112,8 +115,8 @@ graph LR
 
 | Ключ провайдера | Сервис | Модель по умолчанию | Голос по умолчанию | Имя ключа (credential) | Особенности |
 |---|---|---|---|---|---|
-| `kokoro` | Локальный Kokoro-82M ONNX | `hexgrad/Kokoro-82M` | `af_bella` | *Не требуется* | **100% локальный нейросинтез на CPU** |
-| `f5` | Локальный F5-TTS GPU | `F5-TTS` | По умолчанию | *Не требуется* | **Качественный zero-shot синтез на NVIDIA GPU** |
+| `kokoro` | Веса Kokoro-82M (ONNX) | `hexgrad/Kokoro-82M` | `af_bella` | *Не требуется* | Веса скачать можно; **inference не bundled** — честный fail |
+| `f5` | Демон F5 (ping) | `F5-TTS` | По умолчанию | *Не требуется* | Только ping; **GPU inference не bundled** — честный fail |
 | `elevenlabs` | ElevenLabs API | `eleven_multilingual_v2` | `Rachel` | `ELEVENLABS_API_KEY` | Реалистичный эмоциональный синтез |
 | `openai` | OpenAI Audio | `gpt-4o-mini-tts` / `tts-1` | `alloy` | `OPENAI_API_KEY` | Эталонное качество индустрии |
 | `edge` | Microsoft Edge Online | `ru-RU-SvetlanaNeural` | `ru-RU-SvetlanaNeural` | *Не требуется* | **Бесплатный нейросинтез без API-ключей** |
@@ -182,7 +185,7 @@ dsh-tts:
 * `GET /dsh-tts/stream` — Потоковая передача аудио по SSE в реальном времени.
 * `POST /dsh-tts/speak` — `{ text, voice?, model? }` → Возвращает аудиофайл для воспроизведения.
 * `POST /dsh-tts/preview` — `{ provider, model, voice, text? }` → Тестовое прослушивание голоса в UI.
-* `GET /dsh-tts/models/status` — Статус установленных локальных моделей (Kokoro, F5-TTS).
+* `GET /dsh-tts/models/status` — Статус загрузки весов Kokoro/F5 (inference не в комплекте).
 * `POST /dsh-tts/models/install` — `{ engine: 'kokoro' | 'f5' }` → Запуск загрузки модели с HuggingFace.
 * `DELETE /dsh-tts/models/delete` — `{ engine: 'kokoro' | 'f5' }` → Удаление локальной модели.
 * `GET /dsh-tts/integrations` — Проверка статуса связанных плагинов (`dsh-voice`, `dsh-messenger-gateway`).

package/README.zh.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-<h3>DeepSeek Harness 多引擎语音合成：本地离线神经网络引擎、低延迟流式音频（<300ms）、IT术语词典与即时通讯集成</h3>
+<h3>DeepSeek Harness 多引擎语音合成：云端与系统离线引擎、流式音频、IT 术语词典与即时通讯集成</h3>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@goodandready/dsh-tts"><img src="https://img.shields.io/npm/v/@goodandready/dsh-tts.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
@@ -29,7 +29,7 @@
 
 **`dsh-tts`** 为 **DeepSeek Harness** Web 界面提供高保真智能体回复语音朗读服务。开启 **朗读智能体回复** 后，每条生成的助手回复或实时流式片段均由服务端合成并即时推流至浏览器播放。
 
-API 密钥绝不暴露给前端：音频合成全程在服务端通过**多服务商独立备用链**执行，包括完全离线的本地神经网络模型（Kokoro-82M 和 F5-TTS）。
+API 密钥绝不暴露给前端：音频合成全程在服务端通过**多服务商独立备用链**执行，包括系统离线引擎（Edge TTS、Piper、eSpeak）。Kokoro/F5 仅可下载权重，**推理未捆绑**。
 
 ```mermaid
 graph LR
@@ -49,8 +49,8 @@ graph LR
 
     subgraph Fallback [TTS 引擎备用链]
         LRU -->|未命中| Chain{生效备用链}
-        Chain -->|首选| P1[Kokoro / F5-TTS 本地离线]
-        Chain -.->|云端神经网络| P2[ElevenLabs / OpenAI / CosyVoice]
+        Chain -->|离线| P1[Edge TTS / Piper / eSpeak]
+        Chain -.->|云端| P2[OpenAI / ElevenLabs / Google / Azure / Groq]
         Chain -.->|免费云端| P3[EdgeTTS / SiliconFlow]
         Chain -.->|系统兜底| P4[本地 Piper / eSpeak NG]
     end
@@ -75,9 +75,9 @@ graph LR
 
 ## 🚀 核心功能
 
-### 1. 📴 完全离线本地神经网络引擎（Kokoro CPU 与 F5-TTS GPU）
-* **Kokoro-82M (CPU)**：8200万参数轻量级神经网络模型，通过 ONNX Runtime 在 CPU 上本地运行，零云端依赖。
-* **F5-TTS (GPU)**：零样本扩散 Transformer 语音合成，通过本地推理守护进程运行于 NVIDIA GPU。
+### 1. 📴 离线系统引擎与诚实的神经引擎状态
+* **Edge TTS / Piper / eSpeak**：可用的离线/系统合成，无需云 API Key。
+* **Kokoro-82M / F5-TTS**：仅权重下载与状态展示。**推理未捆绑在本包中**，provider 会明确失败并继续 fallback。
 * **ModelManager 管理界面**：在设置中手动安装模型，实时显示下载进度条、SHA-256 校验和一键删除。无任何静默或自动下载。
 
 ### 2. ⚡ 实时流式音频播放（延迟 < 300ms）
@@ -107,8 +107,8 @@ graph LR
 
 | 服务商 Key | 对应引擎 | 默认模型 | 默认发音人 | 凭证变量名 | 说明与亮点 |
 |---|---|---|---|---|---|
-| `kokoro` | 本地 Kokoro-82M ONNX | `hexgrad/Kokoro-82M` | `af_bella` | *无需密钥* | **100% 离线 CPU 神经网络合成** |
-| `f5` | 本地 F5-TTS GPU 守护进程 | `F5-TTS` | 默认 | *无需密钥* | **高保真 GPU 零样本语音合成** |
+| `kokoro` | Kokoro 权重（ONNX） | `hexgrad/Kokoro-82M` | `af_bella` | *无需密钥* | 可下载权重；**推理未捆绑** — 明确失败 |
+| `f5` | F5 守护进程（ping） | `F5-TTS` | 默认 | *无需密钥* | 仅 ping；**GPU 推理未捆绑** — 明确失败 |
 | `elevenlabs` | ElevenLabs API | `eleven_multilingual_v2` | `Rachel` | `ELEVENLABS_API_KEY` | 极致拟人情感音色 |
 | `openai` | OpenAI Audio | `gpt-4o-mini-tts` / `tts-1` | `alloy` | `OPENAI_API_KEY` | 经典高清发音 |
 | `edge` | 微软 Edge 在线 | `zh-CN-XiaoxiaoNeural` | `zh-CN-XiaoxiaoNeural` | *无需密钥* | **免费免 Key 高保真神经网络语音** |
@@ -177,7 +177,7 @@ dsh-tts:
 * `GET /dsh-tts/stream` — 实时 SSE 音频流推送。
 * `POST /dsh-tts/speak` — `{ text, voice?, model? }` → 返回合成音频。
 * `POST /dsh-tts/preview` — `{ provider, model, voice, text? }` → UI 中试听语音。
-* `GET /dsh-tts/models/status` — 查询本地模型安装状态（Kokoro、F5-TTS）。
+* `GET /dsh-tts/models/status` — 查询 Kokoro/F5 权重下载状态（推理未捆绑）。
 * `POST /dsh-tts/models/install` — `{ engine: 'kokoro' | 'f5' }` → 启动模型下载。
 * `DELETE /dsh-tts/models/delete` — `{ engine: 'kokoro' | 'f5' }` → 删除本地模型。
 * `GET /dsh-tts/integrations` — 查询关联插件状态（`dsh-voice`、`dsh-messenger-gateway`）。

package/lib/cache.js

@@ -1,7 +1,6 @@
-// Кэш синтеза на диске: ключ — хеш (текст, провайдер, модель, голос),
-// значение — ответ провайдера как есть (байты + MIME). Вытеснение самых
-// давних по времени последнего обращения; ограничение задаётся настройкой
-// cacheMaxMb и может меняться на живую, поэтому приходит функцией.
+// Disk speech cache: key is a hash of (text, provider, model, voice),
+// value is the provider response as-is (bytes + MIME). LRU eviction;
+// cacheMaxMb is live config so the limit is passed as a function.
 import { createHash } from 'node:crypto'
 import fs from 'node:fs'
 import path from 'node:path'
@@ -68,7 +67,7 @@ export function createSpeechCache({ root, maxBytes }) {
       try {
         const meta = JSON.parse(await fs.promises.readFile(path.join(dir, key + '.json'), 'utf8'))
         const audio = await fs.promises.readFile(path.join(dir, key + AUDIO_EXT))
-        // Последнее обращение двигаем асинхронно: чтение тормозить нельзя.
+        // Touch LRU asynchronously so reads are never blocked.
         fs.promises.writeFile(path.join(dir, key + '.json'), JSON.stringify({ mime: meta.mime, at: Date.now() })).catch(() => {})
         return { mime: meta.mime || 'audio/mpeg', audio }
       } catch (miss) {

package/lib/client.js

@@ -5,9 +5,8 @@ window.__ModuleLoader__.load({
     var exports = module.exports
     const React = require('react')
 
-    // Значок раскрытия — ядровый; свой SVG только как фолбэк для сборок
-    // без набора примитивов. Иконка всегда смотрит вниз, раскрытие
-    // поворачивает её классом.
+    // Chevron comes from core UI primitives; local SVG is a fallback for
+    // builds without the package. Icon always points down; open state rotates.
     let ChevronIcon = null
     try {
       const primitives = require('@deepseek-ai/dsh-client-ui-primitives')
@@ -23,25 +22,27 @@ window.__ModuleLoader__.load({
     const CLOUD = {
       openai: 1, elevenlabs: 1, google: 1, azure: 1, groq: 1, deepgram: 1, openrouter: 1, custom: 1,
     }
+    // Hints stay generic: concrete provider model IDs rot quickly.
     const MODEL_HINT = {
-      openai: 'gpt-4o-mini-tts',
-      elevenlabs: 'eleven_multilingual_v2',
-      google: 'gemini-2.5-flash-preview-tts',
-      azure: 'region voice, e.g. en-US-JennyNeural',
-      groq: 'playai-tts',
-      deepgram: 'aura-asteria-en (no Russian)',
-      openrouter: 'openai/gpt-4o-mini-tts-2025-12-15',
-      edge: 'ru-RU-SvetlanaNeural',
+      openai: 'provider default',
+      elevenlabs: 'provider default',
+      google: 'provider default',
+      azure: 'region voice name',
+      groq: 'provider default',
+      deepgram: 'provider default (English-only voices)',
+      openrouter: 'provider/model id',
+      edge: 'BCP-47 voice, e.g. ru-RU-SvetlanaNeural',
       piper: 'path to .onnx',
-      espeak: 'ru',
+      espeak: 'language code, e.g. ru',
+      kokoro: 'not bundled — offline neural runtime unavailable',
+      f5: 'not bundled — offline neural runtime unavailable',
     }
 
     const SET_CSS =
       '.dts-wrap{display:flex;flex-direction:column;gap:22px;padding:4px 0;max-width:720px}' +
       '.dts-block{display:flex;flex-direction:column;gap:10px}' +
       '.dts-h{font-size:14px;font-weight:600;color:var(--dsw-alias-label-primary)}' +
-      // Единый вид карточки «Настройки плагинов»: значения из канона
-      // (issue #19), цвета только переменными темы.
+      // Plugin-settings card matches the core card pattern; theme variables only.
       '.dts-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none}' +
       '.dts-head{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;display:flex;align-items:center;gap:12px;padding:14px 16px}' +
       '.dts-headText{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}' +
@@ -54,7 +55,7 @@ window.__ModuleLoader__.load({
       '.dts-input{height:34px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px}' +
       '.dts-foot{border-top:1px solid var(--dsw-alias-border-l2);display:flex;justify-content:flex-end;align-items:center;gap:8px;padding:12px 0 4px}' +
       '.dts-save{appearance:none;font:inherit;cursor:pointer;border:1px solid transparent;border-radius:8px;padding:5px 14px;font-size:13px;background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}' +
-      // Помощники внутренней формы (цепочка провайдеров).
+      // Provider-chain form helpers.
       '.dts-entry{display:flex;flex-direction:column;gap:8px;padding:10px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px}' +
       '.dts-row{display:flex;gap:8px;align-items:center;flex-wrap:wrap}' +
       '.dts-row .dts-model{flex:1;min-width:120px}' +
@@ -67,20 +68,19 @@ window.__ModuleLoader__.load({
       '.dts-link{background:none;border:none;color:var(--dsw-alias-label-secondary);cursor:pointer;font-size:12px;padding:0}'
 
     const setCssId = 'dsh-tts/settings.module.css'
-    if (typeof document !== 'undefined' && !document.querySelector('style[data-plugin-css="' + setCssId + '"]')) {
+    if (typeof document !== 'undefined' && !document.querySelector('style[data-dsh-plugin="dsh-tts"]')) {
       const tag = document.createElement('style')
       tag.textContent = SET_CSS
-      tag.setAttribute('data-plugin', 'dsh-tts')
+      tag.setAttribute('data-dsh-plugin', 'dsh-tts')
       tag.dataset.pluginCss = setCssId
       document.head.appendChild(tag)
     }
 
-    // Проигрыватель.
+    // Player.
     //
-    // Раньше каждый пришедший кусок немедленно вытеснял предыдущий: при чтении
-    // ответа целиком это было незаметно, а при чтении по ходу слышался бы
-    // только последний. Теперь это очередь: следующее начинается, когда
-    // закончилось предыдущее.
+    // Each incoming chunk used to replace the previous one immediately; while reading
+    // For full replies this was invisible; with speak-as-it-goes only the last
+    // chunk would be heard. Now items queue: the next starts after the previous ends.
     const player = {
       audio: null,
       after: '',
@@ -111,8 +111,7 @@ window.__ModuleLoader__.load({
       return player
     }
 
-    // Короткий сигнал рисуем сами: файл не нужен, значит нечего качать,
-    // хранить и настраивать.
+    // Short chime is synthesized in-browser: no file to download, store, or configure.
     function playChime(kind) {
       return new Promise((resolve) => {
         try {
@@ -139,8 +138,8 @@ window.__ModuleLoader__.load({
       })
     }
 
-    // Провайдер не смог — читаем голосом браузера. Хуже по звучанию, но
-    // молчание хуже вдвойне: человек не узнает, что ответ готов.
+    // Provider failed — fall back to the browser voice. Worse quality, but silence
+    // is worse: the user would not know the reply is ready.
     function speakInBrowser(text) {
       return new Promise((resolve) => {
         try {
@@ -203,8 +202,7 @@ window.__ModuleLoader__.load({
           audio.onended = done
           audio.onerror = done
           audio.play().catch(() => {
-            // Браузер не даёт играть без действия человека — не считаем это
-            // поломкой, просто ничего не звучит.
+    // Autoplay without a user gesture is blocked — not a bug; just no sound.
             done()
           })
         } catch (cannotDecode) {
@@ -272,11 +270,10 @@ window.__ModuleLoader__.load({
       }
     }
 
-    // Человек заговорил — замолкаем.
+    // User started talking — stop playback.
     //
-    // Событие приходит из плагина голосового ввода, но никакой связи с ним
-    // нет: если его не установили, событие просто никогда не придёт. Слушаем
-    // окно, а не чужую службу, ровно поэтому.
+    // The event may come from a voice-input plugin, but there is no hard dependency:
+    // without that plugin the event simply never fires. We listen on window on purpose.
     function listenForVoice() {
       if (typeof window === 'undefined') return () => {}
       const onSpeaking = (event) => {
@@ -306,8 +303,8 @@ window.__ModuleLoader__.load({
         const data = await res.json()
         const items = data && Array.isArray(data.items) ? data.items : []
         for (const item of items) {
-          // Место в очереди занято, но синтез ещё идёт — подождём следующего
-          // опроса, иначе порядок фраз рассыплется.
+    // Queue slot reserved but synthesis still running — wait for the next poll
+    // or phrase order would break.
           if (item.kind === 'reserved') break
           player.after = item.id
           if (seenIds.has(item.id)) continue
@@ -323,7 +320,7 @@ window.__ModuleLoader__.load({
       } catch (hostRestarting) { /* хост перезапускается */ }
     }
 
-    // Недавние озвучки: тексты последних реплик и избранное (localStorage).
+    // Recent utterances: last reply texts and favorites (localStorage).
     function recentStore() {
       const KEY = 'dsh-tts/recent'
       let st
@@ -349,7 +346,7 @@ window.__ModuleLoader__.load({
     }
     const recent = recentStore()
 
-    // Разовое проигрывание вне очереди: реплай из списка недавних.
+    // One-shot playback outside the queue: replay from recents.
     function playStandalone(text) {
       fetch('/dsh-tts/speak', {
         method: 'POST',
@@ -370,7 +367,7 @@ window.__ModuleLoader__.load({
     }
 
     function ChainEditor(props) {
-      // Переводчик приходит от карточки: слот отдаёт props.t только ей.
+      // Translator comes from the card: the slot passes props.t only to it.
       const t = props.t || ((key) => key)
       const rows = Array.isArray(props.value) ? props.value : []
       const change = (i, patch) => {
@@ -437,9 +434,8 @@ window.__ModuleLoader__.load({
       )
     }
 
-    // Строки карточки живут в реестре локалей: так их переводит отдельный
-    // пакет, не трогая код этого плагина. Английский — язык по умолчанию,
-    // на него же приходится откат, если перевода нет.
+    // Card strings live in the locale registry so a separate package can translate
+    // them without touching this plugin. English is the source language and fallback.
     const en = {
       'general': 'General',
       'loading': 'Loading\u2026',
@@ -673,7 +669,7 @@ window.__ModuleLoader__.load({
       'removeRegex': 'Регулярка вырезания',
       'removeRegexHint': 'Глобальная регулярка: совпадения удаляются перед синтезом.',
       'customBaseUrl': 'Свой TTS endpoint',
-      'customBaseUrlHint': 'OpenAI-совместимый адрес, например http://localhost:8880/v1; пусто = выключен.',
+      'customBaseUrlHint': 'OpenAI-compatible base URL, e.g. http://localhost:8880/v1; empty disables it.',
       'customKeyEnv': 'Имя ключа для endpoint',
       'customKeyEnvHint': 'Имя credential для Bearer-ключа своего endpointа.',
 
@@ -804,7 +800,7 @@ window.__ModuleLoader__.load({
     }
 
     function TtsSection(props) {
-      // Переводчик приходит от слота, потому что в его записи указан locale.
+      // Translator comes from the slot because its registration sets locale.
       const t = (props && props.t) || ((key) => key)
       const [draft, setDraft] = React.useState(null)
       const [credentials, setCredentials] = React.useState({})
@@ -830,12 +826,12 @@ window.__ModuleLoader__.load({
         return () => { alive = false }
       }, [scope])
 
-      // Статус снимка настроек важнее самого значения:
-      //   loading      — ответа хоста ещё нет;
-      //   unavailable  — хост ответил, но пространство настроек пока не готово;
-      //   ready        — значения на месте.
-      // При unavailable поле writable берётся из документа и остаётся true,
-      // поэтому без проверки статуса карточка рисует пустую, но с виду рабочую форму.
+    // Snapshot status matters more than the value:
+    //   loading     — host has not answered yet;
+    //   unavailable — host answered but the settings namespace is not ready;
+    //   ready       — values are present.
+    // On unavailable, writable defaults true; without a status check the card
+    // looks like a working empty form.
       const ready = !scope || (!!snap && snap.status === 'ready')
       const writable = !scope ? true : (ready && snap.writable !== false)
 
@@ -975,7 +971,7 @@ window.__ModuleLoader__.load({
         }),
         React.createElement('span', { className: 'dts-sub' }, hint))
 
-      // В карточке заголовок рисует шапка — свой блок не дублируем.
+      // The card header draws the title — do not duplicate a second title block.
       const titleLine = props && props.compact ? null : React.createElement('div', { className: 'dts-h' }, t('title'))
       return React.createElement('div', { className: 'dts-wrap' },
         React.createElement('div', { className: 'dts-block' },
@@ -1125,7 +1121,7 @@ window.__ModuleLoader__.load({
       { from: 'RAM', to: 'рам', whole: true, lang: 'ru' },
     ]
 
-    // Редактор словаря произношения: таблица правил сверху вниз.
+    // Pronunciation dictionary editor: rules apply top-down.
     function PronEditor(props) {
       const t = props.t || ((key) => key)
       const rows = Array.isArray(props.value) ? props.value : []
@@ -1258,7 +1254,7 @@ window.__ModuleLoader__.load({
           style: {
             padding: '10px 14px',
             borderRadius: '8px',
-            border: '1px solid var(--dsw-alias-state-warning-primary, #eab308)',
+            border: '1px solid var(--dsw-alias-state-warning-primary)',
             background: 'var(--dsw-alias-bg-layer-2)',
             display: 'flex',
             flexDirection: 'column',
@@ -1266,7 +1262,7 @@ window.__ModuleLoader__.load({
             fontSize: '13px',
           },
         },
-          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary, #eab308)' } },
+          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary)' } },
             '⚠️ ' + t('voiceNotInstalledTitle')
           ),
           React.createElement('span', { className: 'dts-sub' },
@@ -1300,7 +1296,7 @@ window.__ModuleLoader__.load({
           style: {
             padding: '10px 14px',
             borderRadius: '8px',
-            border: '1px solid var(--dsw-alias-state-warning-primary, #eab308)',
+            border: '1px solid var(--dsw-alias-state-warning-primary)',
             background: 'var(--dsw-alias-bg-layer-2)',
             display: 'flex',
             flexDirection: 'column',
@@ -1308,7 +1304,7 @@ window.__ModuleLoader__.load({
             fontSize: '13px',
           },
         },
-          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary, #eab308)' } },
+          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary)' } },
             '⚠️ ' + t('messengerNotInstalledTitle')
           ),
           React.createElement('span', { className: 'dts-sub' },
@@ -1330,7 +1326,7 @@ window.__ModuleLoader__.load({
       )
     }
 
-    // Панель статистики синтеза: живые счётчики хоста.
+    // Synthesis stats panel: live host counters.
     function StatsPanel(props) {
       const t = props.t || ((key) => key)
       const [data, setData] = React.useState(null)
@@ -1351,9 +1347,8 @@ window.__ModuleLoader__.load({
       )
     }
 
-    // Карточка во вкладке «Настройки плагинов» — разметка и стили по
-    // единому канону (issue #19): li в списке ядра, шапка со сбросом темы,
-    // тело с чертой-разделителем. Шеврон — наш, ядро его не даёт.
+    // Plugin-settings tab card follows the shared card pattern: li in the core list,
+    // theme-reset header, body with a divider. Chevron is ours; core does not provide it.
     function TtsCard(props) {
       const t = (props && props.t) || ((key) => key)
       const [open, setOpen] = React.useState(false)
@@ -1386,12 +1381,10 @@ window.__ModuleLoader__.load({
       )
     }
 
-    // Кнопка в строке ввода: видно, что сейчас читается, можно остановить и
-    // открыть недавние озвучки для реплая.
+    // Input-dock button: shows what is playing, stop control, and recents for replay.
     function SpeakerControl(props) {
-      // Слот с `locale` кладёт перевод в props; запасной путь — привязка,
-      // сделанная при регистрации. Второй нужен на случай, если слот перевод
-      // не донесёт: без него кнопки остались бы без подписей вовсе.
+    // A slot with `locale` injects translations into props; the fallback is the
+    // binder created at registration, in case the slot drops translations.
       const t = (props && props.t) || fallbackDockText
       const p = usePlayer()
       const [showList, setShowList] = React.useState(false)
@@ -1450,8 +1443,8 @@ window.__ModuleLoader__.load({
     let fallbackDockText = (key) => key
 
     function registerSpeaker(ctx) {
-      // `locale` в описании слота — то, чем ядро кладёт перевод в props
-      // компонента. Без него внутри дока не было бы ничего, кроме ключей.
+    // `locale` in the slot descriptor is how core injects translations into props.
+    // Without it the dock would show raw keys only.
       fallbackDockText = ctx.locale.bind(NS)
       ctx.slots.inject('conversation.input.dock', () => ctx.slots.register(
         {
@@ -1466,14 +1459,10 @@ window.__ModuleLoader__.load({
     }
 
     function registerSettings(ctx) {
-      // Язык может принести не только плагин: словарные пакеты объявляют
-      // русский для чужих пространств. Ядро на повторное объявление той же
-      // пары «пространство + язык» бросает исключение, и незащищённый вызов
-      // уносил с собой весь плагин — в интерфейсе это выглядело как «Failed to
-      // load plugins» с перечнем ни в чём не повинных соседей.
-      //
-      // Поэтому каждый язык объявляется отдельно и по-хорошему: заняли до нас —
-      // уступаем, свой английский при этом всё равно встаёт на место.
+    // Dictionary packages may also register languages for other namespaces.
+    // Core throws on duplicate namespace+language; an unguarded call used to
+    // take down the whole plugin ("Failed to load plugins"). Register each
+    // language separately: skip if taken; English still lands.
       const addLocale = (locale, dictionary) => {
         try {
           return ctx.locale.register(NS, locale, dictionary)
@@ -1485,13 +1474,12 @@ window.__ModuleLoader__.load({
         const undo = [addLocale('en', en), addLocale('ru', ru)]
         return () => { for (const off of undo) off() }
       }, 'dsh-tts: словари')
-      // Подпись раздела рисует боковой список, а не наш компонент: props.t
-      // туда не доходит, поэтому берём переводчик, привязанный к namespace.
+    // The sidebar draws the section label, not our component: props.t never
+    // reaches it, so bind the translator to the namespace ourselves.
       const t = ctx.locale.bind(NS)
-      // Штатное место настроек — карточка во вкладке «Настройки плагинов».
-      // Вкладка перебирает пространства настроек и ищет слот по entryKey,
-      // равному имени пространства: ключ обязан равняться NS, иначе карточка
-      // не появится молча, без единой ошибки в журнале.
+    // Primary settings home is the plugin-settings tab card. The tab looks up
+    // a slot by entryKey equal to the namespace name: key must equal NS or
+    // the card never appears, with no log error.
       const tryPluginItem = () => {
         try {
           const res = ctx.slots.inject('settings.plugin.item', () => ctx.slots.register(
@@ -1510,8 +1498,8 @@ window.__ModuleLoader__.load({
         }
       }
       if (tryPluginItem()) return
-      // Запасной путь для сборок без settings.plugin.item: прежний раздел
-      // в боковом списке, чтобы настройки не пропали.
+    // Fallback for builds without settings.plugin.item: keep the sidebar section
+    // so settings cannot disappear.
       ctx.slots.inject('settings.section', () => ctx.slots.register(
         {
           name: 'settings.section',