@goodandready/dsh-voice 0.9.33 → 0.9.34

package/lib/client.js

@@ -71,16 +71,10 @@ window.__ModuleLoader__.load({
       'webgpuStatus': 'Browser WebGPU Status',
       'webgpuAvailable': 'WebGPU Available (hardware acceleration ready)',
       'webgpuNotAvailable': 'WebGPU Not Detected (will fallback to server)',
-      'openaiHint': 'whisper-1 · key OPENAI_API_KEY',
-      'siliconflowHint': 'FunAudioLLM/SenseVoiceSmall · key SILICONFLOW_API_KEY',
-      'deepinfraHint': 'openai/whisper-large-v3-turbo · key DEEPINFRA_API_KEY',
-      'fireworksHint': 'whisper-v3-turbo · key FIREWORKS_API_KEY',
-      'mistralHint': 'voxtral-mini-latest · key MISTRAL_API_KEY',
-      'openrouterHint': 'google/gemini-2.5-flash · key OPENROUTER_API_KEY',
-      'localHint': 'set when the server is started',
-      'up': 'Up',
-      'down': 'Down',
-      'remove': 'Remove',
+      'openaiHint': 'whisper-1 · key OPENAI_API_KEY', 'siliconflowHint': 'FunAudioLLM/SenseVoiceSmall · key SILICONFLOW_API_KEY',
+      'deepinfraHint': 'openai/whisper-large-v3-turbo · key DEEPINFRA_API_KEY', 'fireworksHint': 'whisper-v3-turbo · key FIREWORKS_API_KEY',
+      'mistralHint': 'voxtral-mini-latest · key MISTRAL_API_KEY', 'openrouterHint': 'google/gemini-2.5-flash · key OPENROUTER_API_KEY',
+      'localHint': 'set when the server is started', 'up': 'Up', 'down': 'Down', 'remove': 'Remove',
       'addProvider': 'Add provider',
       'chainHint': 'Top to bottom is the order they are tried in',
       'customName': 'name used in the chain',
@@ -322,6 +316,12 @@ window.__ModuleLoader__.load({
       'wizardFinishSuccess': 'Setup & Verification Complete',
       'wizardSkip': 'Skip Wizard',
       'wizardStatusCompleted': 'Microphone and STT verified',
+      'exportDiagnosticsBtn': 'Export Diagnostics Report', 'exportingDiagnostics': 'Exporting report…',
+      'diagnosticsExportSuccess': 'Report downloaded', 'recentRecognitionsTitle': 'Recent Recognition Telemetry',
+      'noRecognitionsYet': 'No recent recognition records yet.', 'diagLatencyBreakdown': 'Latency breakdown:',
+      'diagVad': 'VAD: {ms}ms', 'diagStt': 'STT: {ms}ms', 'diagPolish': 'Polish: {ms}ms',
+      'diagTotal': 'Total: {ms}ms', 'diagBytes': 'Audio: {bytes} B', 'diagWords': 'Words: {count}',
+      'diagExportNotice': 'Exported JSON contains anonymized timings, provider chain, MIME format, and error codes without raw audio or speech transcripts.',
     }
 
     const zh = {
@@ -361,16 +361,10 @@ window.__ModuleLoader__.load({
       'webgpuStatus': '浏览器 WebGPU 状态',
       'webgpuAvailable': 'WebGPU 可用 (硬件加速就绪)',
       'webgpuNotAvailable': '未检测到 WebGPU (将自动回退到服务端)',
-      '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': '移除',
+      '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': '备用链中使用的名称',
@@ -612,6 +606,12 @@ window.__ModuleLoader__.load({
       'wizardFinishSuccess': '设置与验证已完成',
       'wizardSkip': '跳过向导',
       'wizardStatusCompleted': '麦克风与 STT 诊断已就绪',
+      'exportDiagnosticsBtn': '导出诊断报告', 'exportingDiagnostics': '正在导出报告…',
+      'diagnosticsExportSuccess': '诊断报告已下载', 'recentRecognitionsTitle': '近期识别遥测详情',
+      'noRecognitionsYet': '暂无近期识别记录。', 'diagLatencyBreakdown': '耗时分布：',
+      'diagVad': 'VAD：{ms}毫秒', 'diagStt': 'STT：{ms}毫秒', 'diagPolish': '后处理：{ms}毫秒',
+      'diagTotal': '总耗时：{ms}毫秒', 'diagBytes': '音频大小：{bytes} 字节', 'diagWords': '词数：{count}',
+      'diagExportNotice': '导出的 JSON 报告包含脱敏的耗时统计、备用链尝试、MIME 格式与错误码，不含任何原始音频或语音文本。',
     }
 
     // Strings are also needed outside components — in recording handlers and
@@ -3160,18 +3160,61 @@ function cycleDictationMode() {
         ),
       )
     }
-    // Provider Telemetry & Latency Dashboard
+    // Provider Telemetry & Latency Dashboard (#266)
     function ProviderDashboard(props) {
       const t = props.t || moduleT
       const statsData = props.statsData || {}
+      const recentDiagnostics = props.recentDiagnostics || []
+      const [exporting, setExporting] = React.useState(false)
+      const [exportMsg, setExportMsg] = React.useState('')
+
+      const exportReport = async () => {
+        setExporting(true)
+        setExportMsg('')
+        try {
+          const res = await fetch('/dsh-voice/diagnostics/export')
+          const data = await res.json()
+          if (!res.ok || !data || !data.ok) {
+            throw new Error((data && data.error && data.error.message) || `HTTP ${res.status}`)
+          }
+          const blob = new Blob([JSON.stringify(data.report || {}, null, 2)], { type: 'application/json' })
+          const url = URL.createObjectURL(blob)
+          const a = document.createElement('a')
+          a.href = url
+          a.download = `dsh-voice-diagnostics-${new Date().toISOString().replace(/[:.]/g, '-')}.json`
+          document.body.appendChild(a)
+          a.click()
+          document.body.removeChild(a)
+          URL.revokeObjectURL(url)
+          setExportMsg('✓ ' + t('diagnosticsExportSuccess'))
+        } catch (err) {
+          setExportMsg(String(err && err.message ? err.message : err))
+        } finally {
+          setExporting(false)
+        }
+      }
+
       return React.createElement('div', { className: 'cb-section-card' },
         React.createElement('div', { className: 'cb-section-title' },
           React.createElement('span', null, '📊 ' + t('providerDashboard')),
-          React.createElement('button', {
-            type: 'button', className: 'cb-btn', style: { fontSize: '12px', padding: '4px 8px' },
-            onClick: props.onRefresh,
-          }, '🔄 ' + t('refreshStats')),
+          React.createElement('div', { style: { display: 'flex', gap: '8px', alignItems: 'center' } },
+            React.createElement('button', {
+              type: 'button',
+              className: 'cb-btn',
+              style: { fontSize: '12px', padding: '4px 10px' },
+              disabled: exporting,
+              onClick: exportReport,
+            }, exporting ? t('exportingDiagnostics') : ('📥 ' + t('exportDiagnosticsBtn'))),
+            React.createElement('button', {
+              type: 'button', className: 'cb-btn', style: { fontSize: '12px', padding: '4px 8px' },
+              onClick: props.onRefresh,
+            }, '🔄 ' + t('refreshStats')),
+          ),
         ),
+        exportMsg ? React.createElement('div', {
+          className: exportMsg.startsWith('✓') ? 'dvs-ok' : 'cb-alert-err',
+          style: { fontSize: '12px' },
+        }, exportMsg) : null,
         React.createElement('div', { className: 'dvo-dash' },
           React.createElement('div', { className: 'dvo-dash-grid' },
             Object.keys(statsData).length === 0
@@ -3211,6 +3254,41 @@ function cycleDictationMode() {
                 }),
           ),
         ),
+        // Per-recognition telemetry breakdown list (#266)
+        React.createElement('div', { style: { marginTop: '12px', borderTop: '1px solid var(--dsw-alias-border-l2)', paddingTop: '10px' } },
+          React.createElement('div', { className: 'dvs-h', style: { marginBottom: '8px' } }, t('recentRecognitionsTitle')),
+          recentDiagnostics.length === 0
+            ? React.createElement('div', { className: 'dvs-sub' }, t('noRecognitionsYet'))
+            : React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: '8px' } },
+                recentDiagnostics.slice(-5).reverse().map((d) => React.createElement('div', {
+                  key: d.id,
+                  className: 'dvs-card',
+                  style: { padding: '8px 12px', fontSize: '12px' },
+                },
+                  React.createElement('div', { className: 'cb-row', style: { justifyContent: 'space-between', alignItems: 'center' } },
+                    React.createElement('div', { style: { display: 'flex', gap: '6px', alignItems: 'center' } },
+                      React.createElement('span', { className: 'cb-badge ' + (d.success ? 'cb-badge-ok' : 'cb-badge-err') },
+                        d.success ? '✓ ' + (d.provider || 'STT') : '✗ ' + (d.error ? d.error.slice(0, 30) : 'fail')
+                      ),
+                      React.createElement('span', { className: 'dvs-sub' }, `[${d.mode}/${d.subMode}]`),
+                      d.audioBytes ? React.createElement('span', { className: 'dvs-sub' }, t('diagBytes').replace('{bytes}', d.audioBytes)) : null,
+                    ),
+                    React.createElement('span', { style: { fontWeight: '600' } },
+                      t('diagTotal').replace('{ms}', d.totalTookMs)
+                    ),
+                  ),
+                  React.createElement('div', { className: 'cb-row', style: { gap: '12px', marginTop: '4px', fontSize: '11px', color: 'var(--dsw-alias-label-secondary)' } },
+                    React.createElement('span', null, t('diagVad').replace('{ms}', (d.breakdown && d.breakdown.vadMs) || 0)),
+                    React.createElement('span', null, t('diagStt').replace('{ms}', (d.breakdown && d.breakdown.sttMs) || 0)),
+                    d.breakdown && d.breakdown.polishMs ? React.createElement('span', null, t('diagPolish').replace('{ms}', d.breakdown.polishMs)) : null,
+                    typeof d.wordCount === 'number' ? React.createElement('span', null, t('diagWords').replace('{count}', d.wordCount)) : null,
+                  ),
+                ))
+              ),
+          React.createElement('div', { className: 'dvs-sub', style: { marginTop: '8px', fontStyle: 'italic' } },
+            t('diagExportNotice')
+          ),
+        ),
       )
     }
 // ------------------------------------------------------------------ 72-dictation-modes
@@ -4303,6 +4381,7 @@ function MacrosSection(props) {
         React.createElement('span', { className: 'dvs-sub' }, hint),
       )
       const statsData = (statusData && statusData.providerStats) || {}
+      const recentDiagnostics = (statusData && statusData.recentDiagnostics) || []
       const hostOnline = statusLatency !== null
       const whisperRunning = !!(statusData && statusData.whisperRunning)
       const providerCount = (statusData && Array.isArray(statusData.providers)) ? statusData.providers.length : chainOptions.length
@@ -4535,6 +4614,7 @@ function MacrosSection(props) {
         React.createElement(ProviderDashboard, {
           t: t,
           statsData: statsData,
+          recentDiagnostics: recentDiagnostics,
           onRefresh: fetchStatus,
         }),
         React.createElement(UpdaterCard, {

package/lib/host-routes.js

@@ -96,6 +96,7 @@ export function registerHostRoutes(ctx, deps) {
         dictationPrompts: cfg.dictationPrompts || {},
         voiceMacros: Array.isArray(cfg.voiceMacros) ? cfg.voiceMacros : [],
         providerStats: statsTracker.get(),
+        recentDiagnostics: typeof statsTracker.getDiagnostics === 'function' ? statsTracker.getDiagnostics() : [],
       })
     },
   }), 'dsh-voice: /status route')
@@ -133,6 +134,19 @@ export function registerHostRoutes(ctx, deps) {
     },
   }), 'dsh-voice: /polish route')
 
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-voice/diagnostics/export',
+    handler: async (req, res) => {
+      if (req.method !== 'GET') { writeJson(res, 405, { ok: false, error: { code: 'method', message: 'GET only' } }); return }
+      if (!isTrustedCaller(req)) { writeJson(res, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden source origin' } }); return }
+      const report = typeof statsTracker.exportAnonymizedReport === 'function'
+        ? statsTracker.exportAnonymizedReport({ version: '0.9.34', environment: 'production' })
+        : { summary: statsTracker.get(), recentDiagnostics: [] }
+      writeJson(res, 200, { ok: true, report })
+    },
+  }), 'dsh-voice: /diagnostics/export route')
+
   ctx.effect(() => ctx.webServer.register({
     kind: 'exact',
     path: '/dsh-voice/transcribe',
@@ -178,13 +192,31 @@ export function registerHostRoutes(ctx, deps) {
         await startSensevoice()
       }
 
+      const reqStart = Date.now()
       const controller = new AbortController()
       const timer = setTimeout(() => controller.abort(), cfg.timeoutMs)
+      let out = null
+      let polishTookMs = 0
       try {
-        const out = await transcribe(modeCfg, bytes, mime, controller.signal, payload.contextWords)
+        out = await transcribe(modeCfg, bytes, mime, controller.signal, payload.contextWords)
         if (payload.mode === 'message' && modeCfg.sessionCommands === true) {
           const cmd = sessionCommand(out.text)
-          if (cmd) { writeJson(res, 200, { ok: true, command: cmd, provider: out.provider, tookMs: out.tookMs }); return }
+          if (cmd) {
+            if (typeof statsTracker.recordDiagnostic === 'function') {
+              statsTracker.recordDiagnostic({
+                mode: payload.mode || 'dictation',
+                subMode: 'command',
+                mimeType: mime,
+                audioBytes: bytes.length,
+                provider: out.provider,
+                success: true,
+                totalTookMs: Date.now() - reqStart,
+                sttMs: out.tookMs || 0,
+                vadMs: Number(payload.vadMs) || 0,
+              })
+            }
+            writeJson(res, 200, { ok: true, command: cmd, provider: out.provider, tookMs: out.tookMs }); return
+          }
         }
         const subMode = payload.subMode || payload.dictationMode || cfg.dictationMode || 'clean'
         const rawText = out.text
@@ -192,7 +224,9 @@ export function registerHostRoutes(ctx, deps) {
 
         // Dictation modes & polish (#264): verbatim skips LLM entirely (0 LLM calls)
         if (subMode !== 'verbatim' && (modeCfg.polish === true || payload.polish === true)) {
+          const polishStart = Date.now()
           text = await polishText(rawText, { ...modeCfg, subMode, prompt: payload.prompt }, controller.signal)
+          polishTookMs = Date.now() - polishStart
         }
 
         // Voice action macros (#167)
@@ -211,8 +245,37 @@ export function registerHostRoutes(ctx, deps) {
             action = actionRes.action
           }
         }
-        writeJson(res, 200, { ok: true, text, rawText, subMode, action, provider: out.provider, tookMs: out.tookMs })
+        const totalTookMs = Date.now() - reqStart
+        if (typeof statsTracker.recordDiagnostic === 'function') {
+          statsTracker.recordDiagnostic({
+            mode: payload.mode || 'dictation',
+            subMode,
+            mimeType: mime,
+            audioBytes: bytes.length,
+            provider: out.provider,
+            success: true,
+            totalTookMs,
+            sttMs: out.tookMs || 0,
+            polishMs: polishTookMs,
+            vadMs: Number(payload.vadMs) || 0,
+            wordCount: text ? text.split(/\s+/).filter(Boolean).length : 0,
+          })
+        }
+        writeJson(res, 200, { ok: true, text, rawText, subMode, action, provider: out.provider, tookMs: out.tookMs, polishTookMs, totalTookMs })
       } catch (e) {
+        if (typeof statsTracker.recordDiagnostic === 'function') {
+          statsTracker.recordDiagnostic({
+            mode: payload.mode || 'dictation',
+            subMode: payload.subMode || 'clean',
+            mimeType: mime,
+            audioBytes: bytes.length,
+            provider: (out && out.provider) || 'unknown',
+            success: false,
+            totalTookMs: Date.now() - reqStart,
+            vadMs: Number(payload.vadMs) || 0,
+            error: String(e && e.message || e),
+          })
+        }
         writeJson(res, 502, { ok: false, error: { code: 'chain', message: String(e && e.message || e) } })
       } finally {
         clearTimeout(timer)

package/lib/stats.js

@@ -3,6 +3,55 @@
 
 export function createStatsTracker() {
   const stats = new Map()
+  const diagnostics = []
+  const MAX_DIAGNOSTICS = 50
+
+  function recordDiagnostic(entry = {}) {
+    diagnostics.push({
+      id: Math.random().toString(36).slice(2, 10),
+      timestamp: Date.now(),
+      mode: entry.mode || 'dictation',
+      subMode: entry.subMode || 'clean',
+      mimeType: entry.mimeType || 'audio/webm',
+      audioBytes: Number(entry.audioBytes) || 0,
+      provider: entry.provider || 'unknown',
+      success: !!entry.success,
+      totalTookMs: Number(entry.totalTookMs) || 0,
+      breakdown: {
+        vadMs: Number(entry.vadMs) || 0,
+        sttMs: Number(entry.sttMs) || 0,
+        polishMs: Number(entry.polishMs) || 0,
+      },
+      chainAttempts: Array.isArray(entry.chainAttempts) ? entry.chainAttempts.map((a) => ({
+        provider: a.provider || 'unknown',
+        ok: !!a.ok,
+        tookMs: Number(a.tookMs) || 0,
+        reason: a.reason ? String(a.reason).slice(0, 150) : undefined,
+      })) : [],
+      error: entry.error ? String(entry.error).slice(0, 200) : undefined,
+      wordCount: typeof entry.wordCount === 'number' ? entry.wordCount : undefined,
+    })
+    if (diagnostics.length > MAX_DIAGNOSTICS) {
+      diagnostics.shift()
+    }
+  }
+
+  function getDiagnostics() {
+    return diagnostics.slice()
+  }
+
+  function exportAnonymizedReport(appInfo = {}) {
+    return {
+      exportedAt: new Date().toISOString(),
+      app: {
+        name: '@goodandready/dsh-voice',
+        version: appInfo.version || '0.9.34',
+        environment: appInfo.environment || 'production',
+      },
+      summary: get(),
+      recentDiagnostics: getDiagnostics(),
+    }
+  }
 
   function record(key, res = {}) {
     if (!key) return
@@ -51,9 +100,10 @@ export function createStatsTracker() {
 
   function clear() {
     stats.clear()
+    diagnostics.length = 0
   }
 
-  return { record, get, clear }
+  return { record, get, clear, recordDiagnostic, getDiagnostics, exportAnonymizedReport }
 }
 
 export function mergeContextVocabulary(baseVocab = [], contextWords = [], maxWords = 50) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-voice",
-  "version": "0.9.33",
+  "version": "0.9.34",
   "description": "Voice input for DeepSeek Harness: dictation chunked by pauses and voice messages, each with its own provider fallback chain (Deepgram, Groq, HuggingFace, local whisper.cpp, plus any OpenAI-compatible API of your own).",
   "license": "MIT",
   "type": "module",