@goodandready/dsh-voice 0.9.31 → 0.9.32

package/lib/client.js

@@ -248,6 +248,27 @@ window.__ModuleLoader__.load({
       'voiceActionsLabel': 'Voice action commands ("send", "cancel", "clear", "new line")',
       'liveInterimPreview': 'Live speech preview (ghost text preview)',
       'structuredPromptVoice': 'Spoken answers for interactive choice prompts',
+      'modeVerbatim': 'Verbatim',
+      'modeClean': 'Clean Text',
+      'modeTask': 'Agent Task',
+      'modeNote': 'Note',
+      'dictationModeTitle': 'Dictation Post-Processing Mode',
+      'dictationModeDesc': 'Select how dictated speech is processed before insertion: Verbatim (0 LLM calls), Clean text (formatting & filler removal), Agent task (structured prompt), or Note (key points & actions).',
+      'dictationPromptsTitle': 'Dictation Prompt Templates',
+      'dictationPromptsDesc': 'Custom prompt templates for dictation post-processing. Use {text} as placeholder for recognized speech.',
+      'promptClean': 'Clean text prompt',
+      'promptTask': 'Agent task prompt',
+      'promptNote': 'Note prompt',
+      'resetPrompts': 'Reset to defaults',
+      'voiceMacrosTitle': 'Voice Action Macros',
+      'voiceMacrosDesc': 'Spoken trigger phrases automatically expanded into structured prompt templates.',
+      'addMacro': 'Add macro',
+      'macroTrigger': 'Spoken trigger phrase',
+      'macroTemplate': 'Expanded prompt template',
+      'macroDelete': 'Delete',
+      'rawTab': 'Raw STT',
+      'resultTab': 'Result',
+      'llmUnavailableFallback': 'LLM unavailable, showing raw transcript',
       'jargonTitle': 'Developer Lexicon & IT Jargon',
       'techJargonCorrection': 'Auto-correct technical jargon (GitHub, Docker, pnpm, Kubernetes, etc.)',
       'jargonAdd': 'Add replacement',
@@ -474,6 +495,27 @@ window.__ModuleLoader__.load({
       'voiceActionsLabel': '语音动作指令 ("发送", "取消", "清空", "换行")',
       'liveInterimPreview': '实时语音文本预览 (幽灵文本)',
       'structuredPromptVoice': '语音应答交互式选择提示',
+      'modeVerbatim': '逐字直录',
+      'modeClean': '清爽文本',
+      'modeTask': '智能体任务',
+      'modeNote': '便签备忘',
+      'dictationModeTitle': '听写后处理模式',
+      'dictationModeDesc': '选择听写文本后处理方式：逐字直录（零LLM调用）、清爽文本（整理标点去除语气词）、智能体任务（结构化提示词）或便签（要点与行动项）。',
+      'dictationPromptsTitle': '听写提示词模板',
+      'dictationPromptsDesc': '自定义听写后处理提示词模板。使用 {text} 作为识别语音的占位符。',
+      'promptClean': '清爽文本提示词',
+      'promptTask': '智能体任务提示词',
+      'promptNote': '便签提示词',
+      'resetPrompts': '恢复默认模板',
+      'voiceMacrosTitle': '语音动作宏',
+      'voiceMacrosDesc': '语音触发词自动展开为结构化提示词模板。',
+      'addMacro': '添加动作宏',
+      'macroTrigger': '语音触发短语',
+      'macroTemplate': '展开提示词模板',
+      'macroDelete': '删除',
+      'rawTab': '原始识别',
+      'resultTab': '处理结果',
+      'llmUnavailableFallback': 'LLM不可用，已保留原始识别文本',
       'jargonTitle': '开发者词汇与 IT 术语',
       'techJargonCorrection': '自动校正开发术语 (GitHub, Docker, pnpm, Kubernetes 等)',
       'jargonAdd': '添加替换项',
@@ -547,7 +589,7 @@ window.__ModuleLoader__.load({
       '.dvo-preview-input:focus{border-color:var(--dsw-alias-state-info-primary)}' +
       '.dvo-btn-send{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:none;background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-1);transition:opacity 150ms ease}' +
       '.dvo-btn-send:hover{opacity:0.9}' +
-      '.dvo-warn-banner{font-size:12px;color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent);border:1px solid var(--dsw-alias-state-error-primary);padding:4px 8px;border-radius:6px;margin-top:4px}'
+      '.dvo-warn-banner{font-size:12px;color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent);border:1px solid var(--dsw-alias-state-error-primary);padding:4px 8px;border-radius:6px;margin-top:4px}' + '.dvo-mode-pill-btn{display:inline-flex;align-items:center;justify-content:center;height:28px;padding:0 8px;font-size:11px;font-weight:600;border-radius:14px;cursor:pointer;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-secondary);user-select:none;touch-action:manipulation;transition:all 150ms ease}' + '.dvo-mode-pill-btn:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-primary)}' + '.dvo-mode-badge{font-size:11px;font-weight:600;padding:2px 6px;border-radius:6px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);margin-right:4px}' + '.dvo-macro-item{display:flex;flex-direction:column;gap:6px;padding:8px 10px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;margin-top:6px}' + '.dvo-macro-actions{display:flex;justify-content:flex-end;gap:6px}' + '.dvo-fallback-badge{font-size:11px;padding:2px 6px;border-radius:4px;color:var(--dsw-alias-state-warning-primary);background:color-mix(in srgb, var(--dsw-alias-state-warning-primary) 12%, transparent);border:1px solid var(--dsw-alias-state-warning-primary)}'
     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')
@@ -743,7 +785,26 @@ window.__ModuleLoader__.load({
 
     function extractContextKeywords() {
       if (!voice.settings || voice.settings.contextGlossary === false) return []
-      const text = (voice.input && typeof voice.input.draft === 'string') ? voice.input.draft : ''
+      const chunks = []
+      const draft = (voice.input && typeof voice.input.draft === 'string') ? voice.input.draft : ''
+      if (draft && draft.length >= 3) chunks.push(draft)
+      if (voice.session && Array.isArray(voice.session.messages)) {
+        const msgs = voice.session.messages.slice(-5)
+        for (const m of msgs) {
+          const t = (m && typeof m.content === 'string') ? m.content : ((m && typeof m.text === 'string') ? m.text : '')
+          if (t && t.length >= 3) chunks.push(t)
+        }
+      }
+      if (typeof document !== 'undefined') {
+        try {
+          const nodes = document.querySelectorAll('.message-content code, .dsh-message-body code, pre code')
+          for (let i = 0; i < Math.min(nodes.length, 10); i++) {
+            const ct = nodes[i].textContent
+            if (ct && ct.length < 100) chunks.push(ct)
+          }
+        } catch (_) {}
+      }
+      const text = chunks.join(' ')
       if (!text || text.length < 3) return []
       const matches = text.match(/[A-Za-zА-Яа-яЁё_][A-Za-zА-Яа-яЁё0-9_]{2,29}/g) || []
       // Linguistic filter: functional stop-word dictionary for vocabulary keyword extraction.
@@ -775,7 +836,11 @@ window.__ModuleLoader__.load({
 
       const tryHost = async (chainOverride) => {
         const dataBase64 = await blobToBase64(blob)
-        const payload = { dataBase64, mimeType: mime, mode }
+        const subMode = (voice._activeTarget && voice._activeTarget.dictationMode)
+          || voice.selectedDictationMode
+          || (voice.settings && voice.settings.dictationMode)
+          || 'clean'
+        const payload = { dataBase64, mimeType: mime, mode, subMode }
         if (Array.isArray(chainOverride)) {
           payload.chain = chainOverride.map((p) => (typeof p === 'string' ? { provider: p, model: modelMap[p] } : p))
         }
@@ -1491,7 +1556,10 @@ voice._chainsPromise = null
       const targetSession = voice.session || (targetInput && targetInput.session)
       const sessionId = (targetSession && (targetSession.sessionId || targetSession.id))
         || voice.currentSessionId || ''
-      const target = { actions: targetActions, input: targetInput, session: targetSession, span, initialDraft, sessionId }
+      const snapshotSubMode = voice.selectedDictationMode
+        || (voice.settings && voice.settings.dictationMode)
+        || 'clean'
+      const target = { actions: targetActions, input: targetInput, session: targetSession, span, initialDraft, sessionId, dictationMode: snapshotSubMode }
       voice._activeTarget = target
 
       if (voice.isTtsSpeaking) {
@@ -1738,7 +1806,15 @@ voice._chainsPromise = null
       if (v.phase !== 'idle' && v.phase !== 'error' && !hold.armed) return null
       const err = v.phase === 'error'
       const hk = voice.hotkey ? ` (${voice.hotkey})` : ''
+      const curMode = voice.selectedDictationMode || (voice.settings && voice.settings.dictationMode) || 'clean'
       return React.createElement(React.Fragment, null,
+        React.createElement('button', {
+          type: 'button',
+          className: 'dvo-mode-pill-btn',
+          title: t('dictationModeTitle') + ': ' + getDictationModeLabel(curMode, t),
+          'aria-label': t('dictationModeTitle') + ': ' + getDictationModeLabel(curMode, t),
+          onClick: cycleDictationMode,
+        }, getDictationModeLabel(curMode, t)),
         React.createElement('button', {
           type: 'button', className: 'dvo-btn', 'data-err': err ? '1' : '0',
           title: err ? v.error : t('dictationBtn'),
@@ -2208,6 +2284,25 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
       ? React.createElement('div', { className: 'dvo-warn-banner' }, t('sessionMismatch'))
       : null,
   )
+}
+// ------------------------------------------------------------------ 45-dictation
+// Dictation modes UI helper, mode cycler and labels (#264)
+
+const DICTATION_MODES = ['clean', 'task', 'note', 'verbatim']
+
+function getDictationModeLabel(m, t) {
+  const trans = t || moduleT
+  if (m === 'verbatim') return trans('modeVerbatim')
+  if (m === 'task') return trans('modeTask')
+  if (m === 'note') return trans('modeNote')
+  return trans('modeClean')
+}
+
+function cycleDictationMode() {
+  const cur = voice.selectedDictationMode || (voice.settings && voice.settings.dictationMode) || 'clean'
+  const nextIdx = (DICTATION_MODES.indexOf(cur) + 1) % DICTATION_MODES.length
+  voice.selectedDictationMode = DICTATION_MODES[nextIdx]
+  voice.notify()
 }
     // ----------------------------------------------------------- visualizers
     let _accentColorCache = { color: '', expires: 0 }
@@ -2530,7 +2625,12 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         // Live caption of what is heard right now. Until the browser emits a
         // final chunk the text is interim and changes on screen.
         const caption = voice.caption || (inBrowser ? '' : null)
+        const activeSubMode = (voice._activeTarget && voice._activeTarget.dictationMode)
+          || voice.selectedDictationMode
+          || (voice.settings && voice.settings.dictationMode)
+          || 'clean'
         return React.createElement('div', { className: 'dvo-pill', role: 'region', 'aria-label': t('title') },
+          React.createElement('span', { className: 'dvo-mode-badge' }, getDictationModeLabel(activeSubMode, t)),
           React.createElement('button', {
             type: 'button', className: 'dvo-pbtn', title: t('cancel'),
             'aria-label': t('cancel'),
@@ -2559,8 +2659,16 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
       }
 
       if (v.phase === 'processing') {
+        const activeSubMode = (voice._activeTarget && voice._activeTarget.dictationMode)
+          || voice.selectedDictationMode
+          || (voice.settings && voice.settings.dictationMode)
+          || 'clean'
         return React.createElement('div', { className: 'dvo-pill', role: 'region', 'aria-label': t('title') },
-          React.createElement('span', { className: 'dvo-status', 'aria-live': 'polite', 'aria-atomic': 'true' }, spinIcon(), t('transcribing')))
+          React.createElement('span', { className: 'dvo-status', 'aria-live': 'polite', 'aria-atomic': 'true' },
+            spinIcon(),
+            React.createElement('span', { className: 'dvo-mode-badge' }, getDictationModeLabel(activeSubMode, t)),
+            t('transcribing'),
+          ))
       }
 
       if (v.phase === 'pending') {
@@ -2677,6 +2785,9 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
                 voiceCommands: !!(data && data.voiceCommands),
                 vadSilenceMs: Number(data && data.modes && data.modes.dictation && data.modes.dictation.vadSilenceMs) || 700,
                 autoSendMs: Number(data && data.modes && data.modes.message && data.modes.message.autoSendMs) || 4000,
+                dictationMode: String((data && data.dictationMode) || 'clean'),
+                dictationPrompts: (data && data.dictationPrompts) || {},
+                voiceMacros: Array.isArray(data && data.voiceMacros) ? data.voiceMacros : [],
                 sendDelayMs: Number(data && data.modes && data.modes.dictation && data.modes.dictation.sendDelayMs) || 0,
                 stream: !!(data && data.modes && data.modes.dictation && data.modes.dictation.stream),
                 streamChunkMs: Number(data && data.modes && data.modes.dictation && data.modes.dictation.streamChunkMs) || 1200,
@@ -3016,6 +3127,93 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         ),
       )
     }
+// ------------------------------------------------------------------ 72-dictation-modes
+// Dictation modes configuration card and prompt template editors (#264)
+
+function DictationModesSection(props) {
+  const { t, draft, setTop, writable } = props
+  const prompts = (draft && draft.dictationPrompts) || {}
+  const currentMode = (draft && draft.dictationMode) || 'clean'
+
+  const setPrompt = (key, val) => {
+    const updated = { ...prompts, [key]: val }
+    setTop('dictationPrompts', updated)
+  }
+
+  const resetPrompts = () => {
+    setTop('dictationPrompts', { clean: '', task: '', note: '' })
+  }
+
+  return React.createElement('div', { className: 'cb-section-card' },
+    React.createElement('div', { className: 'cb-section-title' },
+      React.createElement('span', null, '🎙️ ' + t('dictationModeTitle')),
+    ),
+    React.createElement('div', { className: 'cb-field-desc' }, t('dictationModeDesc')),
+    React.createElement('div', { className: 'cb-grid-2', style: { marginTop: '8px' } },
+      ['clean', 'task', 'note', 'verbatim'].map((m) =>
+        React.createElement('label', { key: m, className: 'cb-check-label' },
+          React.createElement('input', {
+            type: 'radio',
+            name: 'dictationMode',
+            value: m,
+            checked: currentMode === m,
+            disabled: !writable,
+            onChange: () => setTop('dictationMode', m),
+          }),
+          getDictationModeLabel(m, t),
+        ),
+      ),
+    ),
+    React.createElement('div', { style: { marginTop: '12px', borderTop: '1px solid var(--dsw-alias-border-l1)', paddingTop: '10px' } },
+      React.createElement('div', { className: 'cb-section-title', style: { fontSize: '13px' } },
+        React.createElement('span', null, t('dictationPromptsTitle')),
+        React.createElement('button', {
+          type: 'button',
+          className: 'cb-btn cb-btn-secondary',
+          style: { fontSize: '11px', padding: '2px 8px' },
+          disabled: !writable,
+          onClick: resetPrompts,
+        }, t('resetPrompts')),
+      ),
+      React.createElement('div', { className: 'cb-field-desc' }, t('dictationPromptsDesc')),
+      React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: '8px', marginTop: '8px' } },
+        React.createElement('div', null,
+          React.createElement('label', { className: 'cb-label' }, t('promptClean')),
+          React.createElement('textarea', {
+            className: 'cb-input',
+            style: { minHeight: '48px', resize: 'vertical' },
+            value: prompts.clean || '',
+            placeholder: 'Default: punctuation & filler-word cleanup',
+            disabled: !writable,
+            onChange: (e) => setPrompt('clean', e.target.value),
+          }),
+        ),
+        React.createElement('div', null,
+          React.createElement('label', { className: 'cb-label' }, t('promptTask')),
+          React.createElement('textarea', {
+            className: 'cb-input',
+            style: { minHeight: '48px', resize: 'vertical' },
+            value: prompts.task || '',
+            placeholder: 'Default: structured problem/outcome/constraints/criteria',
+            disabled: !writable,
+            onChange: (e) => setPrompt('task', e.target.value),
+          }),
+        ),
+        React.createElement('div', null,
+          React.createElement('label', { className: 'cb-label' }, t('promptNote')),
+          React.createElement('textarea', {
+            className: 'cb-input',
+            style: { minHeight: '48px', resize: 'vertical' },
+            value: prompts.note || '',
+            placeholder: 'Default: key points & action items summary',
+            disabled: !writable,
+            onChange: (e) => setPrompt('note', e.target.value),
+          }),
+        ),
+      ),
+    ),
+  )
+}
     // 5. Hardware & Audio Engines Card
     function HardwareOptionsCard(props) {
       const t = props.t || moduleT
@@ -3499,6 +3697,78 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         ),
       )
     }
+// ------------------------------------------------------------------ 72-macros
+// Voice action macros configuration card (#167)
+
+function MacrosSection(props) {
+  const { t, draft, setTop, writable } = props
+  const macros = Array.isArray(draft && draft.voiceMacros) ? draft.voiceMacros : []
+
+  const addMacro = () => {
+    const next = [...macros, { trigger: '', template: '' }]
+    setTop('voiceMacros', next)
+  }
+
+  const updateMacro = (idx, field, val) => {
+    const next = macros.map((item, i) => (i === idx ? { ...item, [field]: val } : item))
+    setTop('voiceMacros', next)
+  }
+
+  const removeMacro = (idx) => {
+    const next = macros.filter((_, i) => i !== idx)
+    setTop('voiceMacros', next)
+  }
+
+  return React.createElement('div', { className: 'cb-section-card' },
+    React.createElement('div', { className: 'cb-section-title' },
+      React.createElement('span', null, '⚡ ' + t('voiceMacrosTitle')),
+      React.createElement('button', {
+        type: 'button',
+        className: 'cb-btn cb-btn-secondary',
+        style: { fontSize: '11px', padding: '2px 8px' },
+        disabled: !writable,
+        onClick: addMacro,
+      }, '+ ' + t('addMacro')),
+    ),
+    React.createElement('div', { className: 'cb-field-desc' }, t('voiceMacrosDesc')),
+    macros.length === 0
+      ? React.createElement('div', { style: { fontStyle: 'italic', color: 'var(--dsw-alias-label-tertiary)', fontSize: '12px', marginTop: '6px' } },
+          'No macros configured.',
+        )
+      : React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: '8px', marginTop: '6px' } },
+          macros.map((m, idx) =>
+            React.createElement('div', { key: idx, className: 'dvo-macro-item' },
+              React.createElement('div', { style: { display: 'flex', gap: '8px', alignItems: 'center' } },
+                React.createElement('input', {
+                  type: 'text',
+                  className: 'cb-input',
+                  style: { flex: '1', height: '28px', fontSize: '12px' },
+                  placeholder: t('macroTrigger'),
+                  value: m.trigger || '',
+                  disabled: !writable,
+                  onChange: (e) => updateMacro(idx, 'trigger', e.target.value),
+                }),
+                React.createElement('button', {
+                  type: 'button',
+                  className: 'cb-btn cb-btn-secondary',
+                  style: { padding: '2px 6px', fontSize: '11px', color: 'var(--dsw-alias-state-error-primary)' },
+                  disabled: !writable,
+                  onClick: () => removeMacro(idx),
+                }, t('macroDelete')),
+              ),
+              React.createElement('textarea', {
+                className: 'cb-input',
+                style: { minHeight: '38px', resize: 'vertical', fontSize: '12px' },
+                placeholder: t('macroTemplate') + ' (use {text} for argument)',
+                value: m.template || '',
+                disabled: !writable,
+                onChange: (e) => updateMacro(idx, 'template', e.target.value),
+              }),
+            ),
+          ),
+        ),
+  )
+}
     // SenseVoice Local ASR (1-Click Setup)
     function SensevoiceSection(props) {
       const t = props.t || moduleT
@@ -3652,7 +3922,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
       const [serverConfig, setServerConfig] = React.useState(null)
       const [configLoading, setConfigLoading] = React.useState(true)
       const [revision, setRevision] = React.useState(null)
-
       React.useEffect(() => {
         let alive = true
         fetch('/dsh-voice/config', { cache: 'no-store' })
@@ -3670,7 +3939,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           })
         return () => { alive = false }
       }, [])
-
       // Hotkey picker: not a name field — press the key you want.
       const [catching, setCatching] = React.useState(false)
       const [jargonInput, setJargonInput] = React.useState(null)
@@ -3693,7 +3961,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         document.addEventListener('keydown', onKey, true)
         return () => document.removeEventListener('keydown', onKey, true)
       }, [catching, ctx])
-
       React.useEffect(() => {
         let alive = true
         const render = () => { if (alive && scope && typeof scope.getSnapshot === 'function') setSnap(scope.getSnapshot()) }
@@ -3701,7 +3968,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         const off = (scope && typeof scope.subscribe === 'function') ? scope.subscribe(render) : () => {}
         return () => { alive = false; off() }
       }, [scope])
-
       const [devices, setDevices] = React.useState([])
       React.useEffect(() => {
         if (!navigator.mediaDevices || !navigator.mediaDevices.enumerateDevices) return
@@ -3709,11 +3975,9 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           .then((list) => setDevices(list.filter((d) => d.kind === 'audioinput')))
           .catch(() => {})
       }, [])
-
       const ready = !!serverConfig || (!!snap && snap.status === 'ready')
       const value = (snap && snap.status === 'ready' && snap.value) ? snap.value : (serverConfig || {})
       const writable = ready
-
       React.useEffect(() => {
         if (ready) return undefined
         let tries = 0
@@ -3730,14 +3994,12 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         }, 1000)
         return () => clearInterval(timer)
       }, [ready])
-
       const deepClone = (obj) => {
         if (typeof structuredClone === 'function') {
           try { return structuredClone(obj) } catch (e) { /* fallback */ }
         }
         try { return JSON.parse(JSON.stringify(obj)) } catch (e) { return Object.assign({}, obj) }
       }
-
       const setTop = (key, val) => {
         setDraft((d) => Object.assign({}, d || {}, { [key]: val }))
       }
@@ -3758,9 +4020,7 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         }),
         hint ? React.createElement('span', { className: 'dvs-sub' }, hint) : null,
       )
-
       React.useEffect(() => { if (ready && draft === null) setDraft(deepClone(value)) }, [ready, draft, value])
-
       React.useEffect(() => {
         if (!ready) return
         const val = value || {}
@@ -3792,10 +4052,12 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           techJargonCorrection: val.techJargonCorrection !== false,
           liveInterimPreview: val.liveInterimPreview !== false,
           structuredPromptVoice: val.structuredPromptVoice !== false,
+          dictationMode: val.dictationMode || 'clean',
+          dictationPrompts: val.dictationPrompts || {},
+          voiceMacros: Array.isArray(val.voiceMacros) ? val.voiceMacros : [],
           webgpuModel: String(val.webgpuModel || (voice.settings && voice.settings.webgpuModel) || 'onnx-community/whisper-tiny'),
         })
       }, [ready, value])
-
       const [statusData, setStatusData] = React.useState(null)
       const [statusLatency, setStatusLatency] = React.useState(null)
       const fetchStatus = React.useCallback(() => {
@@ -3819,17 +4081,12 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
             setStatusLatency(null)
           })
       }, [])
-
       React.useEffect(() => {
         fetchStatus()
       }, [fetchStatus])
-
       const { sensevoiceState, installingSensevoice, triggerInstallSensevoice } = useSensevoiceInstaller(fetchStatus)
-
       const { testingMic, testLevel, toggleTestMic, gateDbVal, gateThresholdPercent } = useMicTester(draft, value, setErr)
-
       const { updaterStatus, updating, updaterMsg, updaterMsgKind, updaterLoading, checkUpdater, onUpdateNow } = usePluginUpdater()
-
       const save = async () => {
         setErr(''); setSaved(false)
         if (!draft) return
@@ -3848,7 +4105,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
             .filter(Boolean)
           draft.jargonDictionary = parsed
         }
-
         let httpOk = false
         let httpError = null
         try {
@@ -3870,7 +4126,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         } catch (e) {
           httpError = e?.message || String(e)
         }
-
         if (httpOk && scope && typeof scope.set === 'function') {
           for (const k of Object.keys(draft)) {
             try {
@@ -3880,12 +4135,10 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
             }
           }
         }
-
         if (!httpOk) {
           setErr(t('saveFailed') + ': ' + httpError)
           return
         }
-
         const d = draft || {}
         voice.hotkey = d.hotkey || ''
         if (voice.hotkey) {
@@ -3917,23 +4170,19 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           structuredPromptVoice: d.structuredPromptVoice !== false,
         })
         try { window.dispatchEvent(new CustomEvent('dsh-voice:settings-saved')) } catch (noEvents) { /* nobody */ }
-
         setSaved(true); setJargonInput(null)
         setTimeout(() => setSaved(false), 2000)
         fetchStatus()
       }
-
       const modeVal = (mode, key, fallback) => {
         const m = draft && draft[mode]
         return m && m[key] !== undefined ? m[key] : fallback
       }
-
       const chainOptions = BUILTIN.concat(
         (draft && Array.isArray(draft.customProviders) ? draft.customProviders : [])
           .map((c) => String(c && c.key || '').trim())
           .filter((k) => k && BUILTIN.indexOf(k) < 0),
       )
-
       const langField = (mode) => {
         const val = modeVal(mode, 'language', '')
         const opts = SUPPORTED_LANGS.slice()
@@ -3950,7 +4199,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           ))),
         )
       }
-
       const numField = (mode, key, label, hint) => React.createElement('div', { className: 'cb-field' },
         React.createElement('label', null, label),
         React.createElement('input', {
@@ -3959,15 +4207,11 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
         }),
         React.createElement('span', { className: 'dvs-sub' }, hint),
       )
-
-
       const statsData = (statusData && statusData.providerStats) || {}
       const hostOnline = statusLatency !== null
       const whisperRunning = !!(statusData && statusData.whisperRunning)
       const providerCount = (statusData && Array.isArray(statusData.providers)) ? statusData.providers.length : chainOptions.length
-
       return React.createElement('div', { className: 'cb-page dvo-settings-root' },
-        // 1. Connection & Engine Status Card
         React.createElement(ConnectionStatusCard, {
           t: t,
           hostOnline: hostOnline,
@@ -3976,8 +4220,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           providerCount: providerCount,
           onRefresh: fetchStatus,
         }),
-
-        // 2. Dictation Mode Card
         React.createElement('div', { className: 'cb-section-card' },
           React.createElement('div', { className: 'cb-section-title' },
             React.createElement('span', null, '🎙️ ' + t('dictationBtn')),
@@ -4021,8 +4263,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           ),
           textField('wakeWord', t('wakeWord'), t('wakeWordHint')),
         ),
-
-        // 3. Voice Message Card
         React.createElement('div', { className: 'cb-section-card' },
           React.createElement('div', { className: 'cb-section-title' },
             React.createElement('span', null, '💬 ' + t('messageTitle')),
@@ -4061,8 +4301,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
             ),
           ),
         ),
-
-        // 4. Custom Providers Card
         React.createElement('div', { className: 'cb-section-card' },
           React.createElement('div', { className: 'cb-section-title' },
             React.createElement('span', null, '⚙️ ' + t('customTitle')),
@@ -4074,8 +4312,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
             onChange: (v) => setTop('customProviders', v),
           }),
         ),
-
-        // 5. Hardware & Audio Engines Card
         React.createElement(HardwareOptionsCard, {
           t: t,
           draft: draft,
@@ -4095,8 +4331,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
             clearGlobalHotkey()
           },
         }),
-
-        // 6. SenseVoice Local ASR (1-Click Setup)
         React.createElement(SensevoiceSection, {
           t: t,
           sensevoiceState: sensevoiceState,
@@ -4104,8 +4338,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           writable: writable,
           onInstall: triggerInstallSensevoice,
         }),
-
-        // 7. Turn-Taking & Audio Coordination
         React.createElement('div', { className: 'cb-section-card' },
           React.createElement('div', { className: 'cb-section-title' },
             React.createElement('span', null, '🎙️ ' + t('turnTakingTitle')),
@@ -4132,8 +4364,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
             ),
           ),
         ),
-
-        // 8. Hands-free & Smart Actions
         React.createElement('div', { className: 'cb-section-card' },
           React.createElement('div', { className: 'cb-section-title' },
             React.createElement('span', null, '✨ ' + t('smartActionsTitle')),
@@ -4177,8 +4407,20 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
             ),
           ),
         ),
-
-        // 9. Developer Lexicon & IT Jargon
+        // Dictation Modes & Prompts (#264)
+        React.createElement(DictationModesSection, {
+          t: t,
+          draft: draft,
+          setTop: setTop,
+          writable: writable,
+        }),
+        // Voice Action Macros (#167)
+        React.createElement(MacrosSection, {
+          t: t,
+          draft: draft,
+          setTop: setTop,
+          writable: writable,
+        }),
         React.createElement(JargonEditor, {
           t: t,
           draft: draft,
@@ -4187,15 +4429,11 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           jargonInput: jargonInput,
           setJargonInput: setJargonInput,
         }),
-
-        // 10. Provider Telemetry & Latency Dashboard
         React.createElement(ProviderDashboard, {
           t: t,
           statsData: statsData,
           onRefresh: fetchStatus,
         }),
-
-        // 7. Plugin Version & Updates Card
         React.createElement(UpdaterCard, {
           t: t,
           updaterStatus: updaterStatus,
@@ -4206,8 +4444,6 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
           onCheck: checkUpdater,
           onUpdateNow: onUpdateNow,
         }),
-
-        // Action bar (Save)
         React.createElement('div', { className: 'cb-row' },
           React.createElement('button', { type: 'button', className: 'cb-btn cb-btn-primary', disabled: !writable, onClick: save }, t('save')),
           saved ? React.createElement('span', { className: 'dvs-ok' }, t('saved')) : null,
@@ -4320,6 +4556,9 @@ function renderEditablePreviewPill(voice, v, isPlaying, setIsPlaying, audioRef)
       isAllowedInEditable,
       isHotkeyRelease,
       extractContextKeywords,
+      DICTATION_MODES,
+      getDictationModeLabel,
+      cycleDictationMode,
       resolveBrowserRecognitionLang,
       VoiceSection,
       cutPhrase,