Первый релиз WhisperKey

README.md

@@ -0,0 +1,36 @@
+# WhisperKey
+
+Нативная глобальная диктовка для macOS:
+
+- `F5` — локальный whisper.cpp с полной несжатой моделью large-v3-turbo;
+- `Option+F5` — OpenAI Speech-to-Text API;
+- модель постоянно загружена в фоновом локальном сервере, поэтому не перечитывается с диска после каждого F5;
+- во время длинной диктовки готовые фразы вставляются после паузы около секунды, но не позднее 4 секунд непрерывной речи;
+- технические четырёхсекундные фрагменты склеиваются без искусственной точки и заглавной буквы;
+- короткой нарезки по 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. управление компьютером в «Конфиденциальность и безопасность → Универсальный доступ».
+
+Отключите штатное действие F5:
+
+`Системные настройки → Клавиатура → Диктовка → Сочетание клавиш`.
+
+API-ключ добавляется через значок WhisperKey в строке меню → «Настройки».
+
+## Данные
+
+Локальный режим не отправляет запись в сеть. Облачный режим отправляет временный WAV-файл в OpenAI API; после ответа временные аудиофайлы удаляются.