# Диктовка

> Говорите агенту nsq вместо того, чтобы печатать, — речь распознаётся на вашем компьютере, текст вставляется, но не отправляется.

Source: https://docs.neurosquad.ai/ru/cli/dictation

Нажмите `v` в дашборде (или глобальную горячую клавишу `Ctrl Shift Space` — на
Mac `Cmd Shift Space`), говорите и остановите запись. Текст вставится в агента, открытого
на весь экран, а если такого нет — в выбранного.

- **Enter никогда не нажимается.** Прочитайте распознанное, поправьте, если нужно, и отправьте сами.
- **Звук не покидает ваш компьютер.** Речь распознаётся локально; аудио хранится в памяти только для
текущей фразы и никогда не пишется на диск.

## Настройка

Модель распознавания скачивается один раз — при первом использовании или заранее:

```sh
nsq dictation setup     # скачать модель (сверяется по SHA-256)
nsq dictation status    # модель, папка, горячая клавиша
```

| Модель | Размер | Языки |
| --- | --- | --- |
| `parakeet-tdt-0.6b-v3` (по умолчанию) — NVIDIA Parakeet TDT 0.6B v3, CC-BY-4.0 | ~670 МБ | 25 европейских языков |
| `whisper-large-v3-turbo` — OpenAI Whisper large-v3-turbo, MIT | ~1 ГБ | ~100, определяется автоматически |

Другую модель выберите флагом `--model whisper-large-v3-turbo` или в настройках (ниже).
`nsq dictation test <file.wav>` прогоняет запись через модель, чтобы проверить, что всё работает.

## Горячая клавиша

По умолчанию короткое нажатие начинает запись, следующее — останавливает; если клавишу удерживать,
запись идёт, пока вы её не отпустите. Клавиша глобальная — работает, даже когда терминал не на
переднем плане, — и не перехватывает нажатие, поэтому выберите сочетание, которое не занято в
вашем терминале.

```json
{
  "dictation": {
    "hotkey": "F9",
    "mode": "hold",
    "model": "whisper-large-v3-turbo"
  }
}
```

в `~/.neurosquad-cli/config.json`. `"mode"`: `"hold"` — запись, пока клавиша нажата, `"toggle"` —
каждое нажатие начинает или останавливает запись. `"enabled": false` выключает диктовку.

## Платформы

- **macOS:** приложению терминала нужно разрешение **Микрофон**, а для глобальной клавиши —
**Универсальный доступ / Мониторинг ввода** (Системные настройки → Конфиденциальность и
безопасность).
- **Linux:** глобальной клавише нужен X11; под Wayland пользуйтесь `v` в дашборде. На Linux
arm64 используется программа записи из `PATH` (`arecord`, `parecord`, `pw-record`, `sox` или
`ffmpeg`).
- **По SSH** на удалённой стороне нет ни микрофона, ни глобальной клавиши.

> Диктовка — необязательная часть nsq, на Windows arm64 её нет. Если она не установилась, остальной
> nsq работает как обычно, а `nsq dictation status` об этом скажет.