@goodandready/dsh-voice 0.8.24 → 0.8.26

package/lib/client.js

@@ -132,7 +132,7 @@ window.__ModuleLoader__.load({
       'whisperAutostart': 'Autostart the local whisper',
       'save': 'Save',
       'saved': 'Saved ✓',
-      'openrouterWarning': 'OpenRouter has no /audio/transcriptions \u2014 use the openai-chat-audio template there',
+      'openrouterWarning': 'OpenRouter has no /audio/transcriptions — use the openai-chat-audio template there',
       'noiseSuppression': 'Hardware noise suppression',
       'noiseSuppressionHint': 'Enable browser noise suppression, echo cancellation, and auto gain control',
       'contextGlossary': 'Context glossary injection',
@@ -177,20 +177,188 @@ window.__ModuleLoader__.load({
       'hardwareDesc': 'Microphone device, local whisper.cpp and SenseVoice runtime settings.',
       'uiError': 'Voice UI Error:',
       'retry': 'Retry',
+      'testMic': 'Test Mic',
+      'stopTest': 'Stop Test',
+      'micLevel': 'Mic level',
+      'noiseGate': 'Noise Gate (dB)',
+      'noiseGateHint': 'Mute background fan hum and keyboard clicks below threshold. Off = disabled',
+      'noiseGateOff': 'Off',
+    }
+
+    const zh = {
+      'saveFailed': '部分字段未保存 —',
+      'cardHint': '听写与语音消息：服务商、备用链、本地 whisper',
+      'expand': '展开',
+      'collapse': '收起',
+      'composerUnavailable': '输入框不可用',
+      'keySpace': '空格',
+      'keyUnset': '未设置',
+      'recognitionError': '识别失败',
+      'micUnavailable': '麦克风不可用：需要 HTTPS 或 localhost',
+      'noRecorder': '当前浏览器不支持 MediaRecorder',
+      'browserFailed': '浏览器未能识别：',
+      'nothingHeard': '未识别到任何内容',
+      'dictationBtn': '语音输入',
+      'messageBtn': '语音消息 — 点击或按住',
+      'dictationPill': '听写 — 文本将追加至输入框',
+      'messagePill': '正在录制语音消息',
+      'cancel': '取消',
+      'holdHint': '按住录音 — 松开即发送',
+      'listening': '浏览器正在倾听…',
+      'stop': '停止',
+      'transcribing': '正在转写…',
+      'sendingIn': '发送至智能体倒计时',
+      'secondsShort': ' 秒',
+      'keepPending': '不发送',
+      'hide': '隐藏',
+      'title': '语音',
+      'recordSlot': '语音录制',
+      'browserHint': '浏览器直接识别，无需密钥',
+      'openaiHint': 'whisper-1 · 密钥 OPENAI_API_KEY',
+      'siliconflowHint': 'FunAudioLLM/SenseVoiceSmall · 密钥 SILICONFLOW_API_KEY',
+      'deepinfraHint': 'openai/whisper-large-v3-turbo · 密钥 DEEPINFRA_API_KEY',
+      'fireworksHint': 'whisper-v3-turbo · 密钥 FIREWORKS_API_KEY',
+      'mistralHint': 'voxtral-mini-latest · 密钥 MISTRAL_API_KEY',
+      'openrouterHint': 'google/gemini-2.5-flash · 密钥 OPENROUTER_API_KEY',
+      'localHint': '服务器启动时配置',
+      'up': '上移',
+      'down': '下移',
+      'remove': '移除',
+      'addProvider': '添加服务商',
+      'chainHint': '自上而下为故障转移尝试顺序',
+      'customName': '备用链中使用的名称',
+      'customModel': '模型',
+      'customKeyName': '密钥名称',
+      'customModelHint': '请求的模型（留空使用内置默认值）',
+      'addCustom': '添加自定义服务商',
+      'loadingSettings': '正在加载设置…',
+      'notReady1': 'Harness 尚未同步此插件的设置。如果刚重启，',
+      'notReady2': '设置项将在数秒内自动呈现。',
+      'hotkey': '语音消息快捷键',
+      'pressKey': '请按下按键…',
+      'clearKey': '清除按键',
+      'hotkeyHint1': '按住录音，松开发送给智能体，按 Esc 取消。',
+      'hotkeyHint2': '支持任意按键：字母键、功能键 (F1-F12) 或修饰键。',
+      'language': '识别语言',
+      'dictationHint': '语音按停顿自动切句，文字实时追加至输入框。',
+      'pauseMs': '断句静音停顿时长（毫秒）',
+      'pauseHint': '数值越小切分越频繁、出字越快，但可能切断未说完的词',
+      'speaking': '正在说话…',
+      'silence': '停顿…',
+      'normalizeTranscript': '规范化转写文本',
+      'undo': '撤销上次插入',
+      'undone': '插入已撤销',
+      'nothingToUndo': '没有可撤销的内容',
+      'beep': '启停提示音',
+      'localOnly': '仅使用本地 whisper',
+      'localOnlyHint': '将双链限制为仅使用本地 whisper.cpp 服务：纯离线运行。',
+      'sendDelay': '听写延迟追加 (ms)',
+      'sendDelayHint': '追加听写文本前的缓冲等待时间，允许撤回。0 为关闭',
+      'mic': '麦克风设备',
+      'micDefault': '系统默认',
+      'vocabulary': '自定义词汇表（每行一个词）',
+      'polish': '模型润色转写文本',
+      'polishHint': '插入前通过模型修正标点符号并消除语气口头禅',
+      'stream': '连续流式听写',
+      'streamHint': '说话期间按定时器切分短句，无需等待长时间停顿',
+      'streamChunkMs': '流式切片时长 (ms)',
+      'vadAdapt': '自适应静音阈值',
+      'vadAdaptHint': '根据语速动态调整停顿静音阈值。0 为固定阈值',
+      'wakeWord': '语音唤醒词',
+      'wakeWordHint': '说话以此短语开头时自动触发录音。留空为关闭',
+      'bargeIn': '语音插话打断 (Barge-in)',
+      'polishSend': '发送前润色整篇草稿',
+      'polishSendHint': '发送给智能体前对整个输入框草稿进行一次整体润色',
+      'sessionCommands': '会话语音控制指令',
+      'sessionCommandsHint': '"send"、"cancel"、"stop"、"continue" 执行操作而非转为文本',
+      'polishBaseUrl': '离线润色服务端点',
+      'polishBaseUrlHint': '兼容 OpenAI /chat/completions 的基础地址（如本地 Ollama）。留空使用 harness 模型',
+      'polishModel': '离线润色模型',
+      'polishKeyEnv': '离线润色密钥凭据名',
+      'voiceCommandsLabel': '语音编辑指令（"换行"、"段落"）',
+      'normalizeTranscriptHint': 'transcribe_audio：口语数字转阿拉伯数字，整理标点符号',
+      'messageTitle': '语音消息',
+      'messageHint': '录制单条完整语音，转写完成后自动发送给智能体。',
+      'undoMs': '撤回窗口时长（毫秒）',
+      'undoHint': '转写完成后多久以内可以随时取消发送',
+      'customTitle': '自定义语音服务商',
+      'customHint': '兼容 OpenAI 的任意音频 API。配置名称将出现在上方备用链中。',
+      'general': '通用设置',
+      'whisperEndpoint': '本地 whisper：端点地址',
+      'whisperEndpointHint': 'whisper.cpp 服务器的 POST /inference 接口',
+      'deepgramEndpoint': 'Deepgram：基础地址',
+      'deepgramEndpointHint': 'Deepgram 或私有化部署的基础地址（默认 https://api.deepgram.com）',
+      'whisperBin': '本地 whisper：可执行文件',
+      'whisperBinHint': '开启自动启动时使用',
+      'whisperModel': '本地 whisper：模型文件',
+      'whisperModelHint': 'ggml 模型文件的绝对路径',
+      'whisperAutostart': '自动启动本地 whisper',
+      'save': '保存',
+      'saved': '已保存 ✓',
+      'openrouterWarning': 'OpenRouter 无 /audio/transcriptions 端点 — 请选用 openai-chat-audio 模板',
+      'noiseSuppression': '硬件级降噪',
+      'noiseSuppressionHint': '启用浏览器硬件降噪、回声消除与自动增益控制',
+      'contextGlossary': '上下文专业词汇注入',
+      'contextGlossaryHint': '自动从输入草稿提取代码变量名与术语以提升语音识别准确率',
+      'providerDashboard': '服务商延迟与健康监控',
+      'avgLatency': '平均延迟',
+      'successRate': '成功率',
+      'fast': '极速',
+      'normal': '正常',
+      'slow': '较慢',
+      'error': '异常',
+      'idle': '无调用记录',
+      'play': '播放',
+      'pause': '暂停',
+      'listenBack': '试听回放',
+      'lastRecording': '最近一条语音记录',
+      'sensevoiceHint': 'SenseVoice-ONNX / Sherpa-ONNX · 极速本地语音识别 (~50ms)',
+      'sensevoiceEndpoint': 'SenseVoice：端点地址',
+      'sensevoiceEndpointHint': 'sherpa-onnx 或兼容服务器的 POST 端点',
+      'sensevoiceBin': 'SenseVoice：可执行文件',
+      'sensevoiceBinHint': '开启自动启动时使用',
+      'sensevoiceModel': 'SenseVoice：模型路径',
+      'sensevoiceModelHint': 'SenseVoice / sherpa-onnx 模型的绝对路径或标识符',
+      'sensevoiceAutostart': '自动启动 SenseVoice 服务',
+      'visualizerStyle': '音频动态波形样式',
+      'visualizerStyleHint': '录音胶囊面板内的动态音频波形动画效果',
+      'visLiquidWave': '流体水波 (Liquid Wave)',
+      'visDynamicOrb': '动态脉冲球体 (Dynamic Orb)',
+      'visBars': '经典频条 (Classic Bars)',
+      'visOff': '关闭',
+      'statusTitle': '连接与引擎状态看板',
+      'statusDesc': '当前语音后端与识别服务的实时网络与进程就绪状态。',
+      'badgeHostOnline': '服务端在线 ({ms} ms)',
+      'badgeHostOffline': '服务端不可达',
+      'badgeWhisperActive': 'Whisper 就绪',
+      'badgeWhisperInactive': 'Whisper 未就绪',
+      'badgeSenseVoiceActive': 'SenseVoice 就绪',
+      'badgeSenseVoiceInactive': 'SenseVoice 未就绪',
+      'badgeProviders': '{count} 个服务商已就绪',
+      'refreshStats': '刷新状态',
+      'hardwareTitle': '硬件与本地引擎',
+      'hardwareDesc': '麦克风输入设备、本地 whisper.cpp 与 SenseVoice 运行时配置。',
+      'uiError': '语音界面错误：',
+      'retry': '重试',
+      'testMic': '测试麦克风',
+      'stopTest': '停止测试',
+      'micLevel': '麦克风电平',
+      'noiseGate': '噪声门 (dB)',
+      'noiseGateHint': '静音切除低于阈值的风扇嗡嗡声与机械键盘敲击声。Off = 关闭',
+      'noiseGateOff': '关闭',
     }
 
     // Strings are also needed outside components — in recording handlers and
     // slot labels — so the translator is module-level, not only via props.
     let moduleT = (key) => key
     const t = (key) => moduleT(key)
-
     // ------------------------------------------------------------------ css
     const CSS =
-      '.dvo-btn{display:flex;align-items:center;justify-content:center;width:30px;height:30px;border-radius:50%;border:1px solid var(--dsw-alias-border-l1);background:transparent;color:var(--dsw-alias-label-secondary);cursor:pointer;padding:0;box-sizing:border-box}' +
+      '.dvo-btn{display:flex;align-items:center;justify-content:center;width:30px;height:30px;border-radius:50%;border:1px solid var(--dsw-alias-border-l1);background:transparent;color:var(--dsw-alias-label-secondary);cursor:pointer;padding:0;box-sizing:border-box;user-select:none;-webkit-user-select:none;touch-action:manipulation}' +
       '.dvo-btn:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-border-l2)}' +
       '.dvo-btn[data-err="1"]{color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary)}' +
-      '.dvo-pill{display:flex;align-items:center;gap:10px;height:52px;border-radius:26px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);padding:0 14px;width:100%;max-width:720px;margin:0 auto;box-shadow:0 8px 24px rgba(0,0,0,.18);box-sizing:border-box}' +
-      '.dvo-pbtn{display:flex;align-items:center;justify-content:center;width:34px;height:34px;border-radius:50%;cursor:pointer;padding:0;flex:none;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary)}' +
+      '.dvo-pill{display:flex;align-items:center;gap:10px;height:52px;border-radius:26px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);padding:0 14px;width:100%;max-width:720px;margin:0 auto;box-shadow:0 8px 24px rgba(0,0,0,.18);box-sizing:border-box;user-select:none;-webkit-user-select:none}' +
+      '.dvo-pbtn{display:flex;align-items:center;justify-content:center;width:34px;height:34px;border-radius:50%;cursor:pointer;padding:0;flex:none;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary);user-select:none;-webkit-user-select:none;touch-action:manipulation}' +
       '.dvo-pbtn:hover{background:var(--dsw-alias-bg-layer-2)}' +
       '.dvo-wave{flex:1;min-width:0;max-width:100%;height:40px;width:100%;color:var(--dsw-alias-label-primary)}' +
       '.dvo-status{display:flex;align-items:center;gap:8px;color:var(--dsw-alias-label-secondary);font-size:13px;flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}' +
@@ -213,7 +381,11 @@ window.__ModuleLoader__.load({
       '.dvo-badge-norm{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-state-warning-primary);border:1px solid var(--dsw-alias-state-warning-primary)}' +
       '.dvo-badge-slow{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-state-warning-primary);border:1px solid var(--dsw-alias-border-l2)}' +
       '.dvo-badge-err{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-state-error-primary);border:1px solid var(--dsw-alias-state-error-primary)}' +
-      '.dvo-badge-idle{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-tertiary)}'
+      '.dvo-badge-idle{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-tertiary)}' +
+      '.dvo-mic-test{display:flex;align-items:center;gap:10px;margin-top:8px;padding:6px 12px;background:var(--dsw-alias-bg-layer-2);border-radius:8px;border:1px solid var(--dsw-alias-border-l1)}' +
+      '.dvo-meter-bar{flex:1;height:8px;background:var(--dsw-alias-bg-layer-3);border-radius:4px;overflow:hidden;position:relative}' +
+      '.dvo-meter-fill{height:100%;background:var(--dsw-alias-state-success-primary);border-radius:4px;transition:width 60ms ease-out}' +
+      '.dvo-meter-gate{position:absolute;top:0;bottom:0;width:2px;background:var(--dsw-alias-state-warning-primary);box-shadow:0 0 4px var(--dsw-alias-state-warning-primary);z-index:2;pointer-events:none}'
     const cssId = 'dsh-voice/client.module.css'
     if (typeof document !== 'undefined' && !document.querySelector('style[data-dsh-plugin="dsh-voice"][data-plugin-css="' + cssId + '"]')) {
       const tag = document.createElement('style')
@@ -222,7 +394,6 @@ window.__ModuleLoader__.load({
       tag.dataset.pluginCss = cssId
       document.head.appendChild(tag)
     }
-
     // ---------------------------------------------------------------- store
     const voice = {
       phase: 'idle',      // idle | recording | processing | pending | error
@@ -351,7 +522,7 @@ window.__ModuleLoader__.load({
     function applyVoiceCommands(text) {
       let s = text
       for (const [re, to] of VOICE_COMMANDS) s = s.replace(re, to)
-      return s.replace(/[ \t]+/g, ' ').trim()
+      return s.replace(/[ \t]*\n[ \t]*/g, '\n').replace(/[ \t]+/g, ' ').trim()
     }
 
     // Insert history for undo (#29-9). Browser-only storage.
@@ -507,6 +678,8 @@ window.__ModuleLoader__.load({
     }
 
     // Fetch the mode chain from the host once. Only needed to decide whether
+
+    voice._core = { tidyPhrase, applyVoiceCommands, VOICE_COMMANDS, undoLastInsert, insertHistory }
     // to use browser recognition or record a file.
     let chainsPromise = null
     if (typeof window !== 'undefined') {
@@ -532,6 +705,7 @@ window.__ModuleLoader__.load({
     function teardown(rec) {
       if (!rec) return
       try { rec.stream.getTracks().forEach((t) => t.stop()) } catch (e) { /* already stopped */ }
+      if (rec.srcNode) { try { rec.srcNode.disconnect() } catch (e) { /* already disconnected */ } }
       if (rec.audioCtx) { try { rec.audioCtx.close() } catch (e) { /* already closed */ } }
     }
 
@@ -569,10 +743,24 @@ window.__ModuleLoader__.load({
         : (typeof webkitAudioContext !== 'undefined' ? webkitAudioContext : null)
       if (AC) {
         rec.audioCtx = new AC()
+        if (rec.audioCtx.state === 'suspended') { rec.audioCtx.resume().catch(() => {}) }
         const src = rec.audioCtx.createMediaStreamSource(stream)
+        rec.srcNode = src
+
+        let lastNode = src
+        try {
+          const filter = rec.audioCtx.createBiquadFilter()
+          filter.type = 'highpass'
+          filter.frequency.value = 80
+          filter.Q.value = 0.707
+          src.connect(filter)
+          lastNode = filter
+          rec.filterNode = filter
+        } catch (e) {}
+
         rec.analyser = rec.audioCtx.createAnalyser()
         rec.analyser.fftSize = 128
-        src.connect(rec.analyser)
+        lastNode.connect(rec.analyser)
       }
       // No timeslice: only then each stop() yields a standalone webm file.
       recorder.start()
@@ -585,11 +773,20 @@ window.__ModuleLoader__.load({
       rec.analyser.getByteFrequencyData(data)
       let sum = 0
       for (let i = 0; i < data.length; i++) sum += data[i]
-      return Math.min(1, (sum / data.length / 255) * 2.2)
+      const raw = Math.min(1, (sum / data.length / 255) * 2.2)
+
+      const gateDb = Number(voice.settings && voice.settings.noiseGateDb !== undefined ? voice.settings.noiseGateDb : -45)
+      if (gateDb > -90) {
+        const gateAmp = Math.pow(10, gateDb / 20) * 2.2
+        if (raw < gateAmp) return 0
+      }
+      return raw
     }
 
     // Cut the current phrase: stop the recorder, send the finished file and
     // immediately start a new recording with the same recorder.
+    let dictationQueue = Promise.resolve()
+
     function cutPhrase() {
       const rec = voice.rec
       if (!rec || rec.cutting || rec.closing) return
@@ -606,7 +803,8 @@ window.__ModuleLoader__.load({
           try { rec.recorder.start() } catch (e) { /* stream already closed */ }
         }
         rec.cutting = false
-        if (blob.size < 1200) return       // too short — not speech
+        if (blob.size < 600) return       // too short — not speech
+        dictationQueue = dictationQueue.then(async () => {
         try {
           const out = await sendAudio(blob, rec.mime, 'dictation')
           const text = out && out.text ? out.text : ''
@@ -622,6 +820,7 @@ window.__ModuleLoader__.load({
         } catch (e) {
           voice.set({ error: String(e && e.message ? e.message : e) })
         }
+        })
       })
     }
 
@@ -680,6 +879,7 @@ window.__ModuleLoader__.load({
       // Announce before opening the mic: the sooner playback mutes, the less
       // of it ends up in the recording.
       announceVoice('start')
+      dictationQueue = Promise.resolve()
       voice.set({ phase: 'recording', mode, error: '', levels: [], caption: '' })
       modeChain(mode).then((info) => {
         // Browser leg only when it is explicitly first in the chain.
@@ -901,6 +1101,7 @@ window.__ModuleLoader__.load({
       voice.input = props.input
       if (v.phase !== 'idle' && v.phase !== 'error') return null
       const err = v.phase === 'error'
+      const hk = voice.hotkey ? ` (${voice.hotkey})` : ''
       return React.createElement(React.Fragment, null,
         React.createElement('button', {
           type: 'button', className: 'dvo-btn', 'data-err': err ? '1' : '0',
@@ -908,7 +1109,7 @@ window.__ModuleLoader__.load({
         }, micIcon()),
         React.createElement('button', {
           type: 'button', className: 'dvo-btn', 'data-err': err ? '1' : '0',
-          title: err ? v.error : t('messageBtn'),
+          title: err ? v.error : (t('messageBtn') + hk),
           // Hold: record while pressed; leaving the control cancels.
           onPointerDown: (e) => { e.preventDefault(); beginHold('message') },
           onPointerUp: () => endHold(false),
@@ -1097,45 +1298,67 @@ window.__ModuleLoader__.load({
         return () => dispose()
       }, [v.phase])
 
-      // Waveform / visualizer animation.
+      // Waveform / visualizer animation: requestAnimationFrame with HiDPI scaling
       React.useEffect(() => {
         if (v.phase !== 'recording') return
         let frame = 0
-        const dispose = ctx.interval(() => {
+        let animId = null
+        let running = true
+
+        const render = () => {
+          if (!running) return
           const canvas = canvasRef.current
-          if (!canvas) return
-          const g = canvas.getContext('2d')
-          const w = canvas.width, h = canvas.height
-          g.clearRect(0, 0, w, h)
-          if (!voice.waveColor) {
-            try { voice.waveColor = getComputedStyle(canvas).color || '#fff' } catch (e) { voice.waveColor = '#fff' }
-          }
-          const levels = voice.levels
-          const style = (voice.settings && voice.settings.visualizerStyle) || 'liquid-wave'
-          frame++
-
-          if (style === 'off') {
-            g.beginPath()
-            g.globalAlpha = 0.25
-            g.strokeStyle = voice.waveColor
-            g.lineWidth = 1
-            g.moveTo(10, h / 2)
-            g.lineTo(w - 10, h / 2)
-            g.stroke()
-            g.globalAlpha = 1
-            return
-          }
+          if (canvas) {
+            const g = canvas.getContext('2d')
+            const dpr = typeof window !== 'undefined' ? (window.devicePixelRatio || 1) : 1
+            const rect = canvas.getBoundingClientRect()
+            const cssW = rect.width || 720
+            const cssH = rect.height || 40
+            const targetW = Math.max(1, Math.round(cssW * dpr))
+            const targetH = Math.max(1, Math.round(cssH * dpr))
+
+            if (canvas.width !== targetW || canvas.height !== targetH) {
+              canvas.width = targetW
+              canvas.height = targetH
+            }
 
-          if (style === 'dynamic-orb') {
-            drawDynamicOrb(g, w, h, levels, voice.waveColor, frame)
-          } else if (style === 'bars') {
-            drawClassicBars(g, w, h, levels, voice.waveColor)
-          } else {
-            // default: liquid-wave
-            drawLiquidWave(g, w, h, levels, voice.waveColor, frame)
+            g.save()
+            g.scale(dpr, dpr)
+            g.clearRect(0, 0, cssW, cssH)
+
+            if (!voice.waveColor) {
+              try { voice.waveColor = getComputedStyle(canvas).color || '#fff' } catch (e) { voice.waveColor = '#fff' }
+            }
+            const levels = voice.levels
+            const style = (voice.settings && voice.settings.visualizerStyle) || 'liquid-wave'
+            frame++
+
+            if (style === 'off') {
+              g.beginPath()
+              g.globalAlpha = 0.25
+              g.strokeStyle = voice.waveColor
+              g.lineWidth = 1
+              g.moveTo(10, cssH / 2)
+              g.lineTo(cssW - 10, cssH / 2)
+              g.stroke()
+              g.globalAlpha = 1
+            } else if (style === 'dynamic-orb') {
+              drawDynamicOrb(g, cssW, cssH, levels, voice.waveColor, frame)
+            } else if (style === 'bars') {
+              drawClassicBars(g, cssW, cssH, levels, voice.waveColor)
+            } else {
+              drawLiquidWave(g, cssW, cssH, levels, voice.waveColor, frame)
+            }
+            g.restore()
           }
-        }, 33)
-        return () => dispose()
+          animId = requestAnimationFrame(render)
+        }
+
+        animId = requestAnimationFrame(render)
+        return () => {
+          running = false
+          if (animId) cancelAnimationFrame(animId)
+        }
       }, [v.phase])
 
       // Message-mode cancel window.
@@ -1288,6 +1511,7 @@ window.__ModuleLoader__.load({
               dispose()
               dispose = () => {}
               const key = data && data.hotkey
+              voice.hotkey = key || ''
               if (key) dispose = installHotkey(ctx, key, 'message')
               // The composer needs fresh settings without opening the card.
               Object.assign(voice.settings, {
@@ -1620,23 +1844,85 @@ window.__ModuleLoader__.load({
         voice.settings = Object.assign({}, voice.settings, {
           vadSilenceMs: Number(value && value.dictation && value.dictation.vadSilenceMs) || 700,
           autoSendMs: Number(value && value.message && value.message.autoSendMs) || 4000,
-          beep: !!(snap && snap.beep),
-          micDeviceId: String((snap && snap.micDeviceId) || ''),
-          historyLimit: Number(snap && snap.historyLimit),
-          voiceCommands: !!(snap && snap.voiceCommands),
+          beep: !!(value && value.beep),
+          micDeviceId: String((value && value.micDeviceId) || ''),
+          historyLimit: Number(value && value.historyLimit) || 20,
+          voiceCommands: !!(value && value.voiceCommands),
           sendDelayMs: Number(value && value.dictation && value.dictation.sendDelayMs) || 0,
           stream: !!(value && value.dictation && value.dictation.stream),
           streamChunkMs: Number(value && value.dictation && value.dictation.streamChunkMs) || 1200,
           vadAdapt: Number(value && value.dictation && value.dictation.vadAdapt) || 0,
-          wakeWord: String((snap && snap.wakeWord) || ''),
-          bargeIn: !!(snap && snap.bargeIn),
+          wakeWord: String((value && value.wakeWord) || ''),
+          bargeIn: !!(value && value.bargeIn),
           polishSend: !!(value && value.message && value.message.polishSend),
           sessionCommands: !!(value && value.message && value.message.sessionCommands),
-          polishBaseUrl: String((snap && snap.polishBaseUrl) || ''),
+          polishBaseUrl: String((value && value.polishBaseUrl) || ''),
           noiseSuppression: value.noiseSuppression !== false,
+          noiseGateDb: Number((value && value.noiseGateDb) !== undefined ? value.noiseGateDb : -45),
           contextGlossary: value.contextGlossary !== false,
+          visualizerStyle: (value && value.visualizerStyle) || 'liquid-wave',
         })
-      }, [ready, value, snap])
+      }, [ready, value])
+
+      // Interactive microphone tester
+      const [testingMic, setTestingMic] = React.useState(false)
+      const [testLevel, setTestLevel] = React.useState(0)
+      const testRef = React.useRef(null)
+
+      const toggleTestMic = async () => {
+        if (testingMic) {
+          if (testRef.current) {
+            testRef.current.active = false
+            try { testRef.current.stream.getTracks().forEach((t) => t.stop()) } catch (e) {}
+            if (testRef.current.audioCtx) { try { testRef.current.audioCtx.close() } catch (e) {} }
+            testRef.current = null
+          }
+          setTestingMic(false)
+          setTestLevel(0)
+          return
+        }
+        try {
+          const devId = (draft && draft.micDeviceId) || (value && value.micDeviceId) || ''
+          const audio = { echoCancellation: true, noiseSuppression: true, autoGainControl: true }
+          if (devId) audio.deviceId = { exact: devId }
+          const stream = await navigator.mediaDevices.getUserMedia({ audio })
+          const AC = typeof AudioContext !== 'undefined' ? AudioContext : (typeof webkitAudioContext !== 'undefined' ? webkitAudioContext : null)
+          if (!AC) return
+          const audioCtx = new AC()
+          if (audioCtx.state === 'suspended') await audioCtx.resume().catch(() => {})
+          const src = audioCtx.createMediaStreamSource(stream)
+          const analyser = audioCtx.createAnalyser()
+          analyser.fftSize = 128
+          src.connect(analyser)
+          testRef.current = { stream, audioCtx, analyser, active: true }
+          setTestingMic(true)
+
+          const check = () => {
+            if (!testRef.current || !testRef.current.active) return
+            const data = new Uint8Array(analyser.frequencyBinCount)
+            analyser.getByteFrequencyData(data)
+            let sum = 0
+            for (let i = 0; i < data.length; i++) sum += data[i]
+            const lvl = Math.min(100, Math.round((sum / data.length / 255) * 220))
+            setTestLevel(lvl)
+            requestAnimationFrame(check)
+          }
+          requestAnimationFrame(check)
+        } catch (e) {
+          setErr(String(e && e.message ? e.message : e))
+        }
+      }
+
+      React.useEffect(() => {
+        return () => {
+          if (testRef.current) {
+            testRef.current.active = false
+            try { testRef.current.stream.getTracks().forEach((t) => t.stop()) } catch (e) {}
+            if (testRef.current.audioCtx) { try { testRef.current.audioCtx.close() } catch (e) {} }
+            testRef.current = null
+          }
+        }
+      }, [])
 
       const [statusData, setStatusData] = React.useState(null)
       const [statusLatency, setStatusLatency] = React.useState(null)
@@ -1706,6 +1992,7 @@ window.__ModuleLoader__.load({
           streamChunkMs: Number(draft.dictation && draft.dictation.streamChunkMs) || 1200,
           vadAdapt: Number(draft.dictation && draft.dictation.vadAdapt) || 0,
           noiseSuppression: draft.noiseSuppression !== false,
+          noiseGateDb: Number(draft.noiseGateDb !== undefined ? draft.noiseGateDb : -45),
           contextGlossary: draft.contextGlossary !== false,
           visualizerStyle: draft.visualizerStyle || 'liquid-wave',
         })
@@ -1742,16 +2029,51 @@ window.__ModuleLoader__.load({
         React.createElement('span', { className: 'dvs-sub' }, t('hotkeyHint1') + t('hotkeyHint2')),
       )
 
+      const gateDbVal = Number((draft && draft.noiseGateDb) !== undefined ? draft.noiseGateDb : (value && value.noiseGateDb) !== undefined ? value.noiseGateDb : -45)
+      const gateThresholdPercent = gateDbVal <= -90 ? 0 : Math.min(100, Math.max(0, Math.round(((gateDbVal + 60) / 40) * 100)))
+
       const micField = () => React.createElement('div', { className: 'cb-field' },
         React.createElement('label', null, t('mic')),
-        React.createElement('select', {
-          value: String((snap && snap.micDeviceId) || ''), disabled: !writable,
-          onChange: (e) => setTop('micDeviceId', e.target.value),
-        },
-          React.createElement('option', { value: '' }, t('micDefault')),
-          devices.map((d) => React.createElement('option', { key: d.deviceId, value: d.deviceId },
-            d.label || d.deviceId.slice(0, 12))),
+        React.createElement('div', { className: 'cb-row' },
+          React.createElement('select', {
+            value: String((draft && draft.micDeviceId) ?? (value && value.micDeviceId) ?? ''), disabled: !writable || testingMic,
+            onChange: (e) => setTop('micDeviceId', e.target.value),
+            style: { flex: 1 },
+          },
+            React.createElement('option', { value: '' }, t('micDefault')),
+            devices.map((d) => React.createElement('option', { key: d.deviceId, value: d.deviceId },
+              d.label || d.deviceId.slice(0, 12))),
+          ),
+          React.createElement('button', {
+            type: 'button',
+            className: 'cb-btn ' + (testingMic ? 'cb-btn-primary' : 'cb-btn-secondary'),
+            onClick: toggleTestMic,
+            style: { flex: 'none' },
+          }, testingMic ? t('stopTest') : t('testMic')),
+        ),
+        testingMic ? React.createElement('div', { className: 'dvo-mic-test' },
+          React.createElement('span', { style: { fontSize: '11px', color: 'var(--dsw-alias-label-secondary)' } }, t('micLevel') + ':'),
+          React.createElement('div', { className: 'dvo-meter-bar' },
+            React.createElement('div', { className: 'dvo-meter-fill', style: { width: `${testLevel}%` } }),
+            gateThresholdPercent > 0 ? React.createElement('div', { className: 'dvo-meter-gate', style: { left: `${gateThresholdPercent}%` }, title: `${gateDbVal} dB` }) : null,
+          ),
+          React.createElement('span', { style: { fontSize: '11px', fontVariantNumeric: 'tabular-nums', width: '32px', textAlign: 'right' } }, `${testLevel}%`),
+        ) : null,
+        React.createElement('div', { className: 'cb-row', style: { marginTop: '6px' } },
+          React.createElement('span', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)', minWidth: '120px' } }, t('noiseGate') + ':'),
+          React.createElement('select', {
+            value: String(gateDbVal), disabled: !writable,
+            onChange: (e) => setTop('noiseGateDb', Number(e.target.value)),
+            style: { flex: 1 },
+          },
+            React.createElement('option', { value: '-999' }, t('noiseGateOff')),
+            React.createElement('option', { value: '-50' }, '-50 dB (Low / Gentle)'),
+            React.createElement('option', { value: '-45' }, '-45 dB (Standard Default)'),
+            React.createElement('option', { value: '-35' }, '-35 dB (Medium Room)'),
+            React.createElement('option', { value: '-25' }, '-25 dB (High / Mechanical Clicks)'),
+          ),
         ),
+        React.createElement('span', { className: 'dvs-sub' }, t('noiseGateHint')),
       )
 
       const langField = (mode) => React.createElement('div', { className: 'cb-field' },
@@ -2063,7 +2385,6 @@ window.__ModuleLoader__.load({
         ),
       )
     }
-
     // Card in Settings → Plugins → Plugin settings (#18)
     function PluginCard(props) {
       const [open, setOpen] = React.useState(false)
@@ -2104,9 +2425,9 @@ window.__ModuleLoader__.load({
 
     exports.inject = ['timer', 'slots', 'settingsScope', 'locale']
     exports.apply = function apply(ctx) {
-      // English is the source language. Other languages come from the
-      // separate translation plugin at runtime. Re-registering the same
-      // namespace+language throws, so tolerate a pre-registered dictionary.
+      // English is the source and fallback language; Chinese is the built-in
+      // localized user dictionary. Other languages (like Russian) come from
+      // the separate translation plugin at runtime.
       const addLocale = (locale, dictionary) => {
         try {
           return ctx.locale.register(NS, locale, dictionary)
@@ -2115,7 +2436,7 @@ window.__ModuleLoader__.load({
         }
       }
       ctx.effect(() => {
-        const undo = [addLocale('en', en)]
+        const undo = [addLocale('en', en), addLocale('zh', zh)]
         return () => { for (const off of undo) off() }
       }, 'dsh-voice: locale dictionaries')
       moduleT = ctx.locale.bind(NS)