44 lines
3.0 KiB
Markdown
44 lines
3.0 KiB
Markdown
# WhisperKey
|
|
|
|
Нативная глобальная диктовка для macOS:
|
|
|
|
- `F5` — локальный whisper.cpp с полной несжатой моделью large-v3-turbo;
|
|
- `Option+F5` — OpenAI Speech-to-Text API;
|
|
- модель постоянно загружена в фоновом локальном сервере, поэтому не перечитывается с диска после каждого F5;
|
|
- с системным источником ввода черновик появляется через 2–3 секунды и отображается как нативный подчёркнутый `marked text`;
|
|
- после остановки вся реплика распознаётся целиком и заменяет подчёркнутый черновик финальным текстом;
|
|
- если системный источник не включён, работает прежняя безопасная вставка фрагментами;
|
|
- короткой нарезки по 1,5 секунды нет: ей не хватало контекста, и Whisper начинал домысливать;
|
|
- после 5 секунд тишины запись завершается автоматически, повторное нажатие останавливает её вручную;
|
|
- результат очищается и вставляется в активное текстовое поле;
|
|
- OpenAI API key хранится в macOS Keychain.
|
|
|
|
## Установка
|
|
|
|
```bash
|
|
chmod +x scripts/*.sh
|
|
./scripts/setup-local-whisper.sh
|
|
./scripts/install-app.sh
|
|
```
|
|
|
|
При первом запуске разрешите:
|
|
|
|
1. доступ к микрофону;
|
|
2. управление компьютером в «Конфиденциальность и безопасность → Универсальный доступ».
|
|
|
|
Установщик регистрирует системный источник `WhisperKey`. При F5 он выбирается
|
|
только на время диктовки, а после фиксации текста автоматически возвращается
|
|
предыдущая раскладка. Если macOS не разрешила автоматическое включение, откройте
|
|
`Системные настройки → Клавиатура → Ввод текста → Изменить…` и один раз
|
|
добавьте `WhisperKey` вручную.
|
|
|
|
Отключите штатное действие F5:
|
|
|
|
`Системные настройки → Клавиатура → Диктовка → Сочетание клавиш`.
|
|
|
|
API-ключ добавляется через значок WhisperKey в строке меню → «Настройки».
|
|
|
|
## Данные
|
|
|
|
Локальный режим не отправляет запись в сеть. Облачный режим отправляет временный WAV-файл в OpenAI API; после ответа временные аудиофайлы удаляются.
|