@goodandready/dsh-voice 0.6.0 → 0.7.0

package/lib/client.js

@@ -125,6 +125,39 @@ window.__ModuleLoader__.load({
       actions.setDraft(draft ? draft + ' ' + text : text)
     }
 
+    // Как клавиша называется на человеческом языке.
+    const KEY_LABELS = {
+      Control: 'Ctrl', Alt: 'Alt', Shift: 'Shift', Meta: 'Win',
+      Space: 'Пробел', Escape: 'Esc',
+    }
+
+    function keyLabel(name) {
+      if (!name) return 'не задана'
+      if (KEY_LABELS[name]) return KEY_LABELS[name]
+      // Коды вида KeyR и Digit5 показываем без служебной приставки.
+      return String(name).replace(/^Key/, '').replace(/^Digit/, '')
+    }
+
+    // Что записать в настройку по нажатию. Чистый модификатор запоминаем по
+    // имени: код у левого и правого разный, а человек нажимает «какой-нибудь».
+    function keyFromEvent(event) {
+      if (['Control', 'Alt', 'Shift', 'Meta'].includes(event.key)) return event.key
+      if (event.code) return event.code
+      return event.key || ''
+    }
+
+    // Объявление о том, что человек заговорил.
+    //
+    // Нужно, чтобы озвучка немедленно замолчала: слушать ответ и говорить
+    // одновременно невозможно, а перекрикивать собственный плагин — глупо.
+    // Связи между плагинами нет: голос кричит в окно, кто хочет — слышит.
+    // Поэтому оба плагина работают и поодиночке.
+    function announceVoice(phase) {
+      try {
+        window.dispatchEvent(new CustomEvent('dsh-voice:speaking', { detail: { phase } }))
+      } catch (noEvents) { /* окна нет — значит и слушать некому */ }
+    }
+
     // ------------------------------------------------- распознавание в браузере
     //
     // Отдельная нога, не похожая на все остальные: речь распознаёт сам браузер,
@@ -318,6 +351,9 @@ window.__ModuleLoader__.load({
 
     function startRecording(mode) {
       if (voice.phase !== 'idle' && voice.phase !== 'error') return
+      // Кричим до открытия микрофона, а не после: чем раньше замолчит
+      // озвучка, тем меньше её попадёт в запись.
+      announceVoice('start')
       voice.set({ phase: 'recording', mode, error: '', levels: [], caption: '' })
       modeChain(mode).then((info) => {
         // Браузерная нога — только если её прямо поставили первой в цепочке.
@@ -399,6 +435,7 @@ window.__ModuleLoader__.load({
     }
 
     function cancelCurrent() {
+      announceVoice('end')
       if (voice.browser) {
         voice.browser.abort()
         voice.browser = null
@@ -418,6 +455,7 @@ window.__ModuleLoader__.load({
     // Останов по второму нажатию: диктовка досылает хвост, голосовое —
     // отправляет всю запись и открывает окно отмены.
     function stopCurrent() {
+      announceVoice('end')
       if (voice.browser) {
         const mode = voice.mode
         const said = (voice.browserFinals || []).join(' ').trim()
@@ -612,17 +650,32 @@ window.__ModuleLoader__.load({
 
     // --------------------------------------------------------------- slots
     function registerComposer(ctx) {
-      // Горячая клавиша живёт всё время, пока плагин применён.
+      // Горячая клавиша живёт всё время, пока плагин применён, и меняется без
+      // перезапуска: карточка настроек кричит в окно, композер перечитывает.
       ctx.effect(() => {
         let dispose = () => {}
-        fetch('/dsh-voice/status', { cache: 'no-store' })
-          .then((res) => res.json())
-          .then((data) => {
-            const key = data && data.hotkey
-            if (key) dispose = installHotkey(ctx, key, 'message')
-          })
-          .catch(() => { /* без подсказки хоста горячей клавиши просто не будет */ })
-        return () => dispose()
+        let alive = true
+
+        const reload = () => {
+          fetch('/dsh-voice/status', { cache: 'no-store' })
+            .then((res) => res.json())
+            .then((data) => {
+              if (!alive) return
+              dispose()
+              dispose = () => {}
+              const key = data && data.hotkey
+              if (key) dispose = installHotkey(ctx, key, 'message')
+            })
+            .catch(() => { /* без подсказки хоста клавиши просто не будет */ })
+        }
+
+        reload()
+        window.addEventListener('dsh-voice:settings-saved', reload)
+        return () => {
+          alive = false
+          window.removeEventListener('dsh-voice:settings-saved', reload)
+          dispose()
+        }
       }, 'dsh-voice: горячая клавиша удержания')
 
       ctx.slots.inject('conversation.input.right', () => ctx.slots.register(
@@ -784,6 +837,27 @@ window.__ModuleLoader__.load({
       const [saved, setSaved] = React.useState(false)
       const [err, setErr] = React.useState('')
 
+      // Выбор клавиши: не поле для ввода имени, а «нажмите ту, которую хотите».
+      // Имена вроде KeyR человек знать не обязан.
+      //
+      // Хуки объявлены здесь, выше всех возвратов: если объявить их ниже, при
+      // неготовых настройках карточка вернётся раньше, хуков окажется меньше,
+      // и React снимет весь раздел с ошибкой.
+      const [catching, setCatching] = React.useState(false)
+      React.useEffect(() => {
+        if (!catching) return undefined
+        const onKey = (event) => {
+          event.preventDefault()
+          event.stopPropagation()
+          if (event.key === 'Escape') { setCatching(false); return }
+          const chosen = keyFromEvent(event)
+          setDraft((d) => Object.assign({}, d || {}, { hotkey: chosen }))
+          setCatching(false)
+        }
+        document.addEventListener('keydown', onKey, true)
+        return () => document.removeEventListener('keydown', onKey, true)
+      }, [catching])
+
       React.useEffect(() => {
         let alive = true
         const render = () => { if (alive) setSnap(scope.getSnapshot()) }
@@ -860,6 +934,9 @@ window.__ModuleLoader__.load({
             vadSilenceMs: Number(draft.dictation && draft.dictation.vadSilenceMs) || 700,
             autoSendMs: Number(draft.message && draft.message.autoSendMs) || 4000,
           }
+          // Композер держит обработчик клавиши: пусть перечитает настройку,
+          // иначе новая клавиша заработает только после перезагрузки страницы.
+          try { window.dispatchEvent(new CustomEvent('dsh-voice:settings-saved')) } catch (noEvents) { /* некому */ }
           setSaved(true); setTimeout(() => setSaved(false), 2000)
         } catch (e) { setErr(String(e && e.message ? e.message : e)) }
       }
@@ -877,6 +954,22 @@ window.__ModuleLoader__.load({
           .filter((k) => k && BUILTIN.indexOf(k) < 0),
       )
 
+      const hotkeyField = () => React.createElement('label', { className: 'dvs-field' },
+        'Клавиша для голосового сообщения',
+        React.createElement('div', { className: 'dvs-row' },
+          React.createElement('button', {
+            type: 'button', className: 'dvs-save', disabled: !writable,
+            onClick: () => setCatching(true),
+          }, catching ? 'Нажмите клавишу…' : keyLabel(draft && draft.hotkey)),
+          React.createElement('button', {
+            type: 'button', className: 'dvs-mini', title: 'Убрать клавишу',
+            disabled: !writable, onClick: () => setDraft((d) => Object.assign({}, d || {}, { hotkey: '' })),
+          }, '×'),
+        ),
+        React.createElement('span', { className: 'dvs-sub' },
+          'Держите её — идёт запись, отпустите — уйдёт агенту, Esc — отмена. '
+          + 'Можно любую: буква, F-клавиша или модификатор.'))
+
       const langField = (mode) => React.createElement('label', { className: 'dvs-field' }, 'Язык',
         React.createElement('select', {
           value: modeVal(mode, 'language', 'ru'), disabled: !writable,
@@ -931,6 +1024,7 @@ window.__ModuleLoader__.load({
         ),
         React.createElement('div', { className: 'dvs-block' },
           React.createElement('div', { className: 'dvs-h' }, 'Общее'),
+          hotkeyField(),
           textField('whisperUrl', 'Локальный whisper: endpoint', 'POST /inference сервера whisper.cpp'),
           textField('whisperBin', 'Локальный whisper: бинарь', 'используется при автозапуске'),
           textField('whisperModel', 'Локальный whisper: модель', 'используется при автозапуске'),

package/package.json

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