@goodandready/dsh-voice 0.9.32 → 0.9.33

package/lib/client.js

@@ -279,6 +279,49 @@ window.__ModuleLoader__.load({
       'assistantSpeakingGated': 'Assistant speaking (gated mode)',
       'jargonFormatHint': ' (spoken -> replacement)',
       'errorPrefix': 'Error',
+      'wizardTitle': 'First-Run Setup & Diagnostics Wizard',
+      'wizardDesc': 'Step-by-step diagnostic test: check secure context, microphone permissions, audio level, and STT round-trip.',
+      'wizardBtnLaunch': 'Launch Mic & STT Wizard',
+      'wizardClose': 'Close Wizard',
+      'wizardStep1': '1. Audio & Environment',
+      'wizardStep2': '2. Live Signal Test',
+      'wizardStep3': '3. STT Transcription Test',
+      'wizardSecureContextOk': 'Secure context / HTTPS verified',
+      'wizardSecureContextBad': 'Insecure context (HTTPS or localhost required)',
+      'wizardMediaDevicesOk': 'Browser mediaDevices API supported',
+      'wizardMediaDevicesBad': 'Browser mediaDevices API missing',
+      'wizardMediaRecorderOk': 'MediaRecorder API supported',
+      'wizardMediaRecorderBad': 'MediaRecorder API unsupported in this browser',
+      'wizardMicPermissionOk': 'Microphone permission granted',
+      'wizardMicPermissionPrompt': 'Microphone permission not yet granted',
+      'wizardMicPermissionBad': 'Microphone permission denied',
+      'wizardRequestMic': 'Request Microphone Access',
+      'wizardMicLabel': 'Microphone input device:',
+      'wizardStartSignalCheck': 'Start Audio Level Test',
+      'wizardStopSignalCheck': 'Stop Audio Test',
+      'wizardSignalOk': 'Audio signal detected (RMS: {level}%)',
+      'wizardSignalZero': 'Zero audio level detected - speak into microphone or select correct device',
+      'wizardSignalTesting': 'Listening for audio signal… speak into your microphone',
+      'wizardProviderLabel': 'Active STT engine & model:',
+      'wizardProcessingArea': 'Processing area:',
+      'wizardAreaBrowser': 'In-browser (WebGPU / WebSpeech)',
+      'wizardAreaServer': 'Local MiniPC server (SenseVoice / Whisper)',
+      'wizardAreaCloud': 'Remote cloud provider',
+      'wizardStartTestRecord': 'Record 3-Second Test Phrase',
+      'wizardRecordingTest': 'Recording test phrase… speak now ({left}s)',
+      'wizardTranscribingTest': 'Transcribing test phrase…',
+      'wizardTestResult': 'STT Test Result:',
+      'wizardTestSuccess': 'STT round-trip verified successfully! Latency: {latency}ms',
+      'wizardTestEmpty': 'No speech detected in test recording. Please speak clearly and try again.',
+      'wizardTestFailed': 'STT test failed: {error}',
+      'wizardNextStepHint': 'Next step: {hint}',
+      'wizardHintPermission': 'Click "Request Microphone Access" and allow browser permission prompt.',
+      'wizardHintDevice': 'Check microphone connection or select a different input device.',
+      'wizardHintHttps': 'Open DeepSeek Harness via HTTPS or localhost address.',
+      'wizardHintProvider': 'Configure STT engine credentials or install SenseVoice model below.',
+      'wizardFinishSuccess': 'Setup & Verification Complete',
+      'wizardSkip': 'Skip Wizard',
+      'wizardStatusCompleted': 'Microphone and STT verified',
     }
 
     const zh = {
@@ -526,6 +569,49 @@ window.__ModuleLoader__.load({
       'assistantSpeakingGated': '助手正在发言（门控模式）',
       'jargonFormatHint': ' (口语 -> 替换文本)',
       'errorPrefix': '错误',
+      'wizardTitle': '首次启动与麦克风诊断向导',
+      'wizardDesc': '分步诊断检查：安全上下文、麦克风权限、音频信号电平及实时 STT 回环测试。',
+      'wizardBtnLaunch': '启动麦克风与 STT 诊断向导',
+      'wizardClose': '关闭向导',
+      'wizardStep1': '1. 音频与运行环境',
+      'wizardStep2': '2. 实时信号测试',
+      'wizardStep3': '3. STT 识别回环测试',
+      'wizardSecureContextOk': '安全上下文 / HTTPS 已验证',
+      'wizardSecureContextBad': '非安全上下文（需 HTTPS 或 localhost）',
+      'wizardMediaDevicesOk': '浏览器 mediaDevices API 支持正常',
+      'wizardMediaDevicesBad': '浏览器缺少 mediaDevices API 支持',
+      'wizardMediaRecorderOk': 'MediaRecorder API 支持正常',
+      'wizardMediaRecorderBad': '当前浏览器不支持 MediaRecorder API',
+      'wizardMicPermissionOk': '麦克风权限已授予',
+      'wizardMicPermissionPrompt': '尚未获得麦克风授权',
+      'wizardMicPermissionBad': '麦克风权限被拒绝',
+      'wizardRequestMic': '请求麦克风权限',
+      'wizardMicLabel': '麦克风输入设备：',
+      'wizardStartSignalCheck': '开始音频电平测试',
+      'wizardStopSignalCheck': '停止音频测试',
+      'wizardSignalOk': '检测到音频信号 (RMS: {level}%)',
+      'wizardSignalZero': '未检测到声音信号 — 请对着麦克风说话或选择正确设备',
+      'wizardSignalTesting': '正在监听声音信号… 请对着麦克风发声',
+      'wizardProviderLabel': '当前语音引擎与模型：',
+      'wizardProcessingArea': '处理区域：',
+      'wizardAreaBrowser': '浏览器端处理 (WebGPU / WebSpeech)',
+      'wizardAreaServer': '本地服务器处理 (SenseVoice / Whisper)',
+      'wizardAreaCloud': '远程云端服务',
+      'wizardStartTestRecord': '录制 3 秒测试语句',
+      'wizardRecordingTest': '正在录制测试音频… 请说话 ({left}秒)',
+      'wizardTranscribingTest': '正在请求语音识别…',
+      'wizardTestResult': 'STT 测试结果：',
+      'wizardTestSuccess': 'STT 链路验证成功！耗时：{latency}毫秒',
+      'wizardTestEmpty': '录音中未检测到有效语音，请清晰发音后重试。',
+      'wizardTestFailed': 'STT 测试失败：{error}',
+      'wizardNextStepHint': '建议下一步：{hint}',
+      'wizardHintPermission': '点击“请求麦克风权限”并在浏览器弹窗中允许访问。',
+      'wizardHintDevice': '检查麦克风硬件连接或切换选择其他输入设备。',
+      'wizardHintHttps': '请通过 HTTPS 或 localhost 访问 DeepSeek Harness。',
+      'wizardHintProvider': '请在下方配置 STT 密钥凭据或一键安装 SenseVoice 本地模型。',
+      'wizardFinishSuccess': '设置与验证已完成',
+      'wizardSkip': '跳过向导',
+      'wizardStatusCompleted': '麦克风与 STT 诊断已就绪',
     }
 
     // Strings are also needed outside components — in recording handlers and
@@ -3823,14 +3909,21 @@ function MacrosSection(props) {
       const whisperRunning = props.whisperRunning
       const providerCount = props.providerCount
       const onRefresh = props.onRefresh
+      const onOpenWizard = props.onOpenWizard
 
       return React.createElement('div', { className: 'cb-section-card' },
         React.createElement('div', { className: 'cb-section-title' },
           React.createElement('span', null, t('statusTitle')),
-          React.createElement('button', {
-            type: 'button', className: 'cb-btn', style: { fontSize: '12px', padding: '4px 8px' },
-            onClick: onRefresh,
-          }, '🔄 ' + t('refreshStats')),
+          React.createElement('div', { style: { display: 'flex', gap: '8px', alignItems: 'center' } },
+            onOpenWizard ? React.createElement('button', {
+              type: 'button', className: 'cb-btn cb-btn-primary', style: { fontSize: '12px', padding: '4px 10px' },
+              onClick: onOpenWizard,
+            }, '✨ ' + t('wizardBtnLaunch')) : null,
+            React.createElement('button', {
+              type: 'button', className: 'cb-btn', style: { fontSize: '12px', padding: '4px 8px' },
+              onClick: onRefresh,
+            }, '🔄 ' + t('refreshStats')),
+          ),
         ),
         React.createElement('div', { className: 'cb-row', style: { alignItems: 'center', gap: '12px', flexWrap: 'wrap' } },
           React.createElement('span', { className: 'cb-badge ' + (hostOnline ? 'cb-badge-ok' : 'cb-badge-err') },
@@ -3931,6 +4024,7 @@ function MacrosSection(props) {
               setServerConfig(data.config)
               if (typeof data.revision === 'number') setRevision(data.revision)
               setDraft((curr) => curr || deepClone(data.config))
+              if (data.config.wizardCompleted !== true) setShowWizard(true)
             }
           })
           .catch(() => {})
@@ -3942,6 +4036,7 @@ function MacrosSection(props) {
       // Hotkey picker: not a name field — press the key you want.
       const [catching, setCatching] = React.useState(false)
       const [jargonInput, setJargonInput] = React.useState(null)
+      const [showWizard, setShowWizard] = React.useState(false)
       React.useEffect(() => {
         if (!catching) return undefined
         const onKey = (event) => {
@@ -4219,7 +4314,15 @@ function MacrosSection(props) {
           whisperRunning: whisperRunning,
           providerCount: providerCount,
           onRefresh: fetchStatus,
+          onOpenWizard: () => setShowWizard((v) => !v),
         }),
+        showWizard ? React.createElement(FirstRunWizard, {
+          t: t,
+          draft: draft,
+          setTop: setTop,
+          writable: writable,
+          onClose: () => setShowWizard(false),
+        }) : null,
         React.createElement('div', { className: 'cb-section-card' },
           React.createElement('div', { className: 'cb-section-title' },
             React.createElement('span', null, '🎙️ ' + t('dictationBtn')),
@@ -4451,6 +4554,395 @@ function MacrosSection(props) {
         ),
       )
     }
+    // ------------------------------------------------------- first-run wizard (#265)
+    function FirstRunWizard(props) {
+      const t = props.t || moduleT
+      const draft = props.draft
+      const setTop = props.setTop
+      const writable = props.writable
+      const onClose = props.onClose
+
+      const isSecure = typeof window !== 'undefined' ? (window.isSecureContext || window.location.protocol === 'https:' || window.location.hostname === 'localhost' || window.location.hostname === '127.0.0.1') : true
+      const hasMediaDevices = typeof navigator !== 'undefined' && !!navigator.mediaDevices && typeof navigator.mediaDevices.getUserMedia === 'function'
+      const hasMediaRecorder = typeof MediaRecorder !== 'undefined'
+
+      const [micPermission, setMicPermission] = React.useState('prompt')
+      const [devices, setDevices] = React.useState([])
+      const [selectedDev, setSelectedDev] = React.useState((draft && draft.micDeviceId) || '')
+      const [signalTesting, setSignalTesting] = React.useState(false)
+      const [currentRms, setCurrentRms] = React.useState(0)
+      const [peakRms, setPeakRms] = React.useState(0)
+      const [testingStt, setTestingStt] = React.useState(false)
+      const [testCountdown, setTestCountdown] = React.useState(0)
+      const [testResult, setTestResult] = React.useState(null)
+      const [testError, setTestError] = React.useState('')
+      const [testLatency, setTestLatency] = React.useState(null)
+
+      const signalStreamRef = React.useRef(null)
+      const audioCtxRef = React.useRef(null)
+      const animFrameRef = React.useRef(null)
+
+      React.useEffect(() => {
+        if (typeof navigator !== 'undefined' && navigator.permissions && navigator.permissions.query) {
+          navigator.permissions.query({ name: 'microphone' })
+            .then((p) => {
+              if (p) {
+                setMicPermission(p.state)
+                p.onchange = () => setMicPermission(p.state)
+              }
+            })
+            .catch(() => {})
+        }
+      }, [])
+
+      const refreshDevices = () => {
+        if (!navigator.mediaDevices || !navigator.mediaDevices.enumerateDevices) return
+        navigator.mediaDevices.enumerateDevices()
+          .then((list) => {
+            const audioInputs = list.filter((d) => d.kind === 'audioinput')
+            setDevices(audioInputs)
+          })
+          .catch(() => {})
+      }
+
+      React.useEffect(() => {
+        refreshDevices()
+      }, [])
+
+      const stopSignalTest = () => {
+        if (animFrameRef.current) {
+          cancelAnimationFrame(animFrameRef.current)
+          animFrameRef.current = null
+        }
+        if (signalStreamRef.current) {
+          try { signalStreamRef.current.getTracks().forEach((trk) => trk.stop()) } catch (_) {}
+          signalStreamRef.current = null
+        }
+        if (audioCtxRef.current) {
+          try { audioCtxRef.current.close() } catch (_) {}
+          audioCtxRef.current = null
+        }
+        setSignalTesting(false)
+        setCurrentRms(0)
+      }
+
+      React.useEffect(() => {
+        return () => {
+          stopSignalTest()
+        }
+      }, [])
+
+      const requestPermissionAndTestSignal = async () => {
+        stopSignalTest()
+        setTestError('')
+        try {
+          const constraints = {
+            audio: selectedDev ? { deviceId: { exact: selectedDev } } : true,
+          }
+          const stream = await navigator.mediaDevices.getUserMedia(constraints)
+          signalStreamRef.current = stream
+          setMicPermission('granted')
+          refreshDevices()
+
+          const AC = typeof AudioContext !== 'undefined' ? AudioContext
+            : (typeof webkitAudioContext !== 'undefined' ? webkitAudioContext : null)
+          if (!AC) return
+          const actx = new AC()
+          audioCtxRef.current = actx
+          if (actx.state === 'suspended') { actx.resume().catch(() => {}) }
+          const src = actx.createMediaStreamSource(stream)
+          const analyser = actx.createAnalyser()
+          analyser.fftSize = 128
+          src.connect(analyser)
+
+          setSignalTesting(true)
+          const buf = new Uint8Array(analyser.frequencyBinCount)
+
+          const checkLevel = () => {
+            if (!signalStreamRef.current) return
+            analyser.getByteFrequencyData(buf)
+            let sum = 0
+            for (let i = 0; i < buf.length; i++) sum += buf[i]
+            const rms = Math.min(100, Math.round((sum / buf.length / 255) * 100 * 2.2))
+            setCurrentRms(rms)
+            setPeakRms((prev) => Math.max(prev, rms))
+            animFrameRef.current = requestAnimationFrame(checkLevel)
+          }
+          animFrameRef.current = requestAnimationFrame(checkLevel)
+        } catch (err) {
+          setMicPermission('denied')
+          setTestError(String(err && err.message ? err.message : err))
+          stopSignalTest()
+        }
+      }
+
+      const runSttTest = async () => {
+        stopSignalTest()
+        setTestError('')
+        setTestResult(null)
+        setTestLatency(null)
+        setTestingStt(true)
+        setTestCountdown(3)
+
+        let testStream = null
+        let recorder = null
+        const chunks = []
+
+        try {
+          const constraints = {
+            audio: selectedDev ? { deviceId: { exact: selectedDev } } : true,
+          }
+          testStream = await navigator.mediaDevices.getUserMedia(constraints)
+          let mime = 'audio/webm;codecs=opus'
+          if (!MediaRecorder.isTypeSupported(mime)) mime = ''
+          recorder = mime ? new MediaRecorder(testStream, { mimeType: mime }) : new MediaRecorder(testStream)
+          recorder.ondataavailable = (e) => {
+            if (e.data && e.data.size > 0) chunks.push(e.data)
+          }
+          recorder.start()
+
+          let left = 3
+          const countdownTimer = setInterval(() => {
+            left -= 1
+            setTestCountdown(left)
+            if (left <= 0) {
+              clearInterval(countdownTimer)
+              if (recorder.state !== 'inactive') recorder.stop()
+            }
+          }, 1000)
+
+          await new Promise((resolve) => recorder.addEventListener('stop', resolve, { once: true }))
+
+          try { testStream.getTracks().forEach((trk) => trk.stop()) } catch (_) {}
+
+          const blob = new Blob(chunks, { type: mime || 'audio/webm' })
+          if (blob.size < 400) {
+            setTestError(t('wizardTestEmpty'))
+            setTestingStt(false)
+            return
+          }
+
+          setTestCountdown(0)
+          const startMs = Date.now()
+          const dataBase64 = await blobToBase64(blob)
+          const payload = {
+            dataBase64,
+            mimeType: mime || recorder.mimeType || 'audio/webm',
+            mode: 'dictation',
+            subMode: 'clean',
+          }
+
+          const res = await fetch('/dsh-voice/transcribe', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(payload),
+          })
+          const data = await res.json()
+          const latency = Date.now() - startMs
+          setTestLatency(latency)
+
+          if (!res.ok || !data || !data.ok) {
+            const msg = (data && data.error && data.error.message) || `HTTP ${res.status}`
+            setTestError(msg)
+          } else {
+            const recognized = String(data.text || '').trim()
+            if (recognized) {
+              setTestResult(recognized)
+              if (typeof setTop === 'function') {
+                setTop('wizardCompleted', true)
+              }
+            } else {
+              setTestError(t('wizardTestEmpty'))
+            }
+          }
+        } catch (err) {
+          setTestError(String(err && err.message ? err.message : err))
+        } finally {
+          if (testStream) {
+            try { testStream.getTracks().forEach((trk) => trk.stop()) } catch (_) {}
+          }
+          setTestingStt(false)
+        }
+      }
+
+      // Determine active chain info
+      const dictationChain = (draft && draft.dictation && draft.dictation.chain) || []
+      const activeProvider = (dictationChain[0] && (dictationChain[0].provider || dictationChain[0])) || 'sensevoice'
+      let areaLabel = t('wizardAreaServer')
+      if (activeProvider === 'browser' || activeProvider === 'browser-webgpu') {
+        areaLabel = t('wizardAreaBrowser')
+      } else if (activeProvider !== 'sensevoice' && activeProvider !== 'local-whisper') {
+        areaLabel = t('wizardAreaCloud')
+      }
+
+      let nextStepHint = ''
+      if (!isSecure) {
+        nextStepHint = t('wizardHintHttps')
+      } else if (micPermission === 'denied') {
+        nextStepHint = t('wizardHintPermission')
+      } else if (peakRms === 0 && signalTesting) {
+        nextStepHint = t('wizardHintDevice')
+      } else if (testError) {
+        nextStepHint = t('wizardHintProvider')
+      }
+
+      return React.createElement('div', { className: 'cb-section-card', style: { borderColor: 'var(--dsw-alias-state-brand-primary)' } },
+        React.createElement('div', { className: 'cb-section-title' },
+          React.createElement('span', null, '✨ ' + t('wizardTitle')),
+          React.createElement('div', { style: { display: 'flex', gap: '8px' } },
+            testResult ? React.createElement('span', { className: 'cb-badge cb-badge-ok' }, '✓ ' + t('wizardStatusCompleted')) : null,
+            onClose ? React.createElement('button', {
+              type: 'button', className: 'cb-btn cb-btn-mini', onClick: onClose, title: t('wizardClose'),
+            }, '✕') : null,
+          ),
+        ),
+        React.createElement('div', { className: 'cb-section-desc' }, t('wizardDesc')),
+
+        // Step 1: Environment & Permissions
+        React.createElement('div', { className: 'dvs-card' },
+          React.createElement('div', { className: 'dvs-h' }, t('wizardStep1')),
+          React.createElement('div', { className: 'cb-row' },
+            React.createElement('span', { className: 'cb-badge ' + (isSecure ? 'cb-badge-ok' : 'cb-badge-err') },
+              isSecure ? ('✓ ' + t('wizardSecureContextOk')) : ('✗ ' + t('wizardSecureContextBad'))
+            ),
+            React.createElement('span', { className: 'cb-badge ' + (hasMediaDevices ? 'cb-badge-ok' : 'cb-badge-err') },
+              hasMediaDevices ? ('✓ ' + t('wizardMediaDevicesOk')) : ('✗ ' + t('wizardMediaDevicesBad'))
+            ),
+            React.createElement('span', { className: 'cb-badge ' + (hasMediaRecorder ? 'cb-badge-ok' : 'cb-badge-err') },
+              hasMediaRecorder ? ('✓ ' + t('wizardMediaRecorderOk')) : ('✗ ' + t('wizardMediaRecorderBad'))
+            ),
+            React.createElement('span', { className: 'cb-badge ' + (micPermission === 'granted' ? 'cb-badge-ok' : (micPermission === 'denied' ? 'cb-badge-err' : 'cb-badge-warn')) },
+              micPermission === 'granted' ? ('✓ ' + t('wizardMicPermissionOk')) : (micPermission === 'denied' ? ('✗ ' + t('wizardMicPermissionBad')) : ('· ' + t('wizardMicPermissionPrompt')))
+            ),
+          ),
+          React.createElement('div', { className: 'cb-field', style: { marginTop: '8px' } },
+            React.createElement('label', null, t('wizardMicLabel')),
+            React.createElement('div', { className: 'cb-row' },
+              React.createElement('select', {
+                value: selectedDev,
+                style: { flex: 1, minWidth: '240px' },
+                onChange: (e) => {
+                  setSelectedDev(e.target.value)
+                  if (typeof setTop === 'function') setTop('micDeviceId', e.target.value)
+                  stopSignalTest()
+                },
+              },
+                React.createElement('option', { value: '' }, 'Default System Microphone'),
+                devices.map((d) => React.createElement('option', { key: d.deviceId, value: d.deviceId }, d.label || `Microphone ${d.deviceId.slice(0, 8)}…`))
+              ),
+              React.createElement('button', {
+                type: 'button',
+                className: 'cb-btn',
+                onClick: requestPermissionAndTestSignal,
+              }, t('wizardRequestMic')),
+            ),
+          ),
+        ),
+
+        // Step 2: Live Audio Signal Test
+        React.createElement('div', { className: 'dvs-card' },
+          React.createElement('div', { className: 'dvs-h' }, t('wizardStep2')),
+          React.createElement('div', { className: 'cb-row', style: { alignItems: 'center' } },
+            React.createElement('button', {
+              type: 'button',
+              className: 'cb-btn ' + (signalTesting ? 'cb-btn-danger' : 'cb-btn-primary'),
+              onClick: signalTesting ? stopSignalTest : requestPermissionAndTestSignal,
+            }, signalTesting ? t('wizardStopSignalCheck') : t('wizardStartSignalCheck')),
+            signalTesting ? React.createElement('span', { className: 'dvs-sub' }, t('wizardSignalTesting')) : null,
+          ),
+          signalTesting ? React.createElement('div', { style: { marginTop: '8px', display: 'flex', flexDirection: 'column', gap: '6px' } },
+            React.createElement('div', {
+              style: {
+                height: '14px',
+                borderRadius: '7px',
+                background: 'var(--dsw-alias-bg-layer-1)',
+                border: '1px solid var(--dsw-alias-border-l1)',
+                overflow: 'hidden',
+                position: 'relative',
+              },
+            },
+              React.createElement('div', {
+                style: {
+                  width: `${currentRms}%`,
+                  height: '100%',
+                  background: currentRms > 5 ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-label-dimmed)',
+                  transition: 'width 0.05s linear',
+                },
+              }),
+            ),
+            React.createElement('span', { className: currentRms > 5 ? 'dvs-ok' : 'dvs-sub' },
+              currentRms > 5
+                ? t('wizardSignalOk').replace('{level}', currentRms)
+                : t('wizardSignalZero')
+            ),
+          ) : null,
+        ),
+
+        // Step 3: Transcription Round-Trip Test
+        React.createElement('div', { className: 'dvs-card' },
+          React.createElement('div', { className: 'dvs-h' }, t('wizardStep3')),
+          React.createElement('div', { className: 'cb-row' },
+            React.createElement('span', { className: 'dvs-sub' }, `${t('wizardProviderLabel')} ${activeProvider}`),
+            React.createElement('span', { className: 'cb-badge' }, `${t('wizardProcessingArea')} ${areaLabel}`),
+          ),
+          React.createElement('div', { className: 'cb-row', style: { marginTop: '8px' } },
+            React.createElement('button', {
+              type: 'button',
+              className: 'cb-btn cb-btn-primary',
+              disabled: testingStt || micPermission === 'denied',
+              onClick: runSttTest,
+            }, testingStt
+              ? (testCountdown > 0 ? t('wizardRecordingTest').replace('{left}', testCountdown) : t('wizardTranscribingTest'))
+              : t('wizardStartTestRecord')
+            ),
+          ),
+          testResult ? React.createElement('div', { style: { marginTop: '8px', display: 'flex', flexDirection: 'column', gap: '4px' } },
+            React.createElement('div', { className: 'dvs-ok' },
+              '✓ ' + t('wizardTestSuccess').replace('{latency}', testLatency || 0)
+            ),
+            React.createElement('blockquote', {
+              style: {
+                margin: '4px 0 0 0',
+                padding: '8px 12px',
+                borderRadius: '6px',
+                background: 'var(--dsw-alias-bg-layer-3)',
+                borderLeft: '4px solid var(--dsw-alias-state-success-primary)',
+                color: 'var(--dsw-alias-label-primary)',
+                fontStyle: 'italic',
+              },
+            }, `“${testResult}”`),
+          ) : null,
+          testError ? React.createElement('div', { className: 'cb-alert-err', style: { marginTop: '8px' } },
+            t('wizardTestFailed').replace('{error}', testError)
+          ) : null,
+        ),
+
+        // Next Step Hint / Feedback
+        nextStepHint ? React.createElement('div', { className: 'dvs-wait', style: { fontStyle: 'italic' } },
+          t('wizardNextStepHint').replace('{hint}', nextStepHint)
+        ) : null,
+
+        // Wizard Bottom Actions
+        React.createElement('div', { className: 'cb-row', style: { justifyContent: 'space-between', marginTop: '6px' } },
+          React.createElement('button', {
+            type: 'button',
+            className: 'cb-btn',
+            onClick: () => {
+              if (typeof setTop === 'function') setTop('wizardCompleted', true)
+              if (onClose) onClose()
+            },
+          }, t('wizardSkip')),
+          testResult ? React.createElement('button', {
+            type: 'button',
+            className: 'cb-btn cb-btn-primary',
+            onClick: () => {
+              if (typeof setTop === 'function') setTop('wizardCompleted', true)
+              if (onClose) onClose()
+            },
+          }, '✓ ' + t('wizardFinishSuccess')) : null,
+        ),
+      )
+    }
     // Card in Settings → Plugins → Plugin settings (#18)
     function PluginCard(props) {
       const page = !!(props && props.view === 'page')

package/lib/updater.js

@@ -18,15 +18,82 @@ function header(request, name) {
   return Array.isArray(value) ? value[0] : value;
 }
 
-function isPrivateLan(value) {
-  const address = value?.toLowerCase().replace(/^\[|\]$/g, '');
+function parseIPv4(ip) {
+  const parts = ip.split('.');
+  if (parts.length !== 4) return null;
+  let num = 0;
+  for (const p of parts) {
+    if (!/^\d+$/.test(p)) return null;
+    const n = Number(p);
+    if (n < 0 || n > 255) return null;
+    num = (num << 8) | n;
+  }
+  return (num >>> 0);
+}
+
+function parseIPv6(ip) {
+  const str = ip.toLowerCase();
+  if (str.includes('.')) {
+    const lastColon = str.lastIndexOf(':');
+    if (lastColon === -1) return null;
+    const v4Part = str.slice(lastColon + 1);
+    const v4Num = parseIPv4(v4Part);
+    if (v4Num === null) return null;
+    const v6Prefix = str.slice(0, lastColon);
+    const hiHex = ((v4Num >>> 16) & 0xffff).toString(16);
+    const loHex = (v4Num & 0xffff).toString(16);
+    return parseIPv6(v6Prefix + ':' + hiHex + ':' + loHex);
+  }
+  const parts = str.split('::');
+  if (parts.length > 2) return null;
+  let groups = [];
+  if (parts.length === 2) {
+    const left = parts[0] ? parts[0].split(':') : [];
+    const right = parts[1] ? parts[1].split(':') : [];
+    const missing = 8 - (left.length + right.length);
+    if (missing < 1) return null;
+    groups = [...left, ...Array(missing).fill('0'), ...right];
+  } else {
+    groups = str.split(':');
+  }
+  if (groups.length !== 8) return null;
+  let hi = 0n;
+  for (let i = 0; i < 8; i++) {
+    if (!/^[0-9a-f]{1,4}$/.test(groups[i])) return null;
+    hi = (hi << 16n) | BigInt(parseInt(groups[i], 16));
+  }
+  return hi;
+}
+
+export function isPrivateLan(value) {
+  const address = value?.toLowerCase().replace(/^\[|\]$/g, '').trim();
   if (!address) return false;
-  const ipv4 = address.startsWith('::ffff:') ? address.slice(7) : address;
-  return (
-    ipv4.startsWith('192.168.') ||
-    ipv4.startsWith('10.') ||
-    /^172\.(1[6-9]|2[0-9]|3[0-1])\./.test(ipv4)
-  );
+  const slashIdx = address.indexOf('/');
+  const ipPart = slashIdx !== -1 ? address.slice(0, slashIdx) : address;
+
+  const ipv4 = ipPart.startsWith('::ffff:') ? ipPart.slice(7) : ipPart;
+
+  const v4Num = parseIPv4(ipv4);
+  if (v4Num !== null) {
+    if ((v4Num >>> 24) === 10) return true;
+    if ((v4Num >>> 20) === ((172 << 4) | 1)) return true;
+    if ((v4Num >>> 16) === ((192 << 8) | 168)) return true;
+    if ((v4Num >>> 16) === ((169 << 8) | 254)) return true;
+    return false;
+  }
+
+  const v6Num = parseIPv6(ipPart);
+  if (v6Num !== null) {
+    // fc00::/7 ULA (covers fc00::/8 and fd00::/8)
+    const first7Bits = Number(v6Num >> 121n);
+    if (first7Bits === 0b1111110) return true;
+    // fe80::/10 Link-Local
+    const first10Bits = Number(v6Num >> 118n);
+    if (first10Bits === 0b1111111010) return true;
+    return false;
+  }
+
+  return false;
 }
 
 function isLoopback(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-voice",
-  "version": "0.9.32",
+  "version": "0.9.33",
   "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",