Диктовка заметки на Mac локально: Handy и Whisper Small

Что подготовить перед диктовкой?

Нужен Mac с Apple Silicon (процессором серии M), работающий микрофон и текстовое поле, например новый локальный документ в TextEdit. Для этой инструкции выбран официальный установщик Handy_0.9.8_aarch64.dmg и Whisper Small без пометки «English» из каталога Handy. Карточка именно этого варианта перечисляет русский среди языков; вариант «Whisper Small (English)» для русской заметки не подходит. Handy и модель нужно предварительно скачать через интернет. s1 s2 s5

В каталоге v0.9.8 стандартная загрузка многоязычной Whisper Small — файл whisper-small-Q8_0.gguf (GGUF — формат файла модели, Q8_0 — обозначение варианта) размером 269 751 136 байт. Это размер файла, не требование к оперативной или видеопамяти. Документированного минимума RAM и полного свободного места для сочетания Handy + эта модель редакция не нашла; на конкретном Mac заранее проверьте доступное место и возможность запуска, не выводя требования из размера файла. Handy распространяет код по MIT, карточка точной GGUF-модели указывает Apache-2.0; мы не распространяем ни приложение, ни веса. s2 s5 s6

Как получить текст в поле?

1. Откройте релиз Handy v0.9.8, скачайте установщик aarch64.dmg и установите приложение. Запустите Handy и разрешите macOS доступ к микрофону и Accessibility / Универсальному доступу для вставки текста в другое приложение. Ожидаемый признак готовности: открываются настройки Handy, приложение видит микрофон. s1 s4
2. В настройках моделей Handy найдите Whisper Small без «(English)», загрузите и выберите её; дождитесь признака, что модель скачана. При наличии переключателя языка выберите Russian / Русский, а перевод в английский оставьте выключенным. Список загрузки v0.9.8 содержит GGUF-модель: старый ggml-small.bin из README относится к legacy-файлам и при отсутствии на диске не показывается для загрузки в этом интерфейсе. s2 s3 s4
3. Откройте новый документ TextEdit, поставьте курсор в поле и посмотрите комбинацию для записи в настройках установленного Handy. Нажмите её по выбранному там режиму — удержание или переключение, произнесите: «В субботу купить батарейки», затем остановите запись тем же предусмотренным в настройках способом. Ожидаемый результат для вашей проверки: распознанные слова появились там, где стоял курсор. Не полагайтесь на универсальную комбинацию из чужой версии инструкции: в Handy сочетание настраивается. s4
4. Прочитайте вставленный текст и сравните со сказанным. Если вместо «в субботу» появились другие слова, исправьте их вручную. Не считайте точное написание, числа, имена и знаки препинания гарантированными: это критерий пользовательской сверки, а не реально полученный Modelium транскрипт. s4

Как проверить локальность и что делать при ошибке?

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

Если звука нет, сначала проверьте системное разрешение на микрофон и выбранный вход. Если речь распознана, но слова не вставились, поставьте курсор в редактируемое поле и проверьте разрешение Accessibility для Handy. Если русский язык распознаётся неверно, убедитесь, что выбрана многоязычная Whisper Small, а не «(English)», и сверьте выбор языка. На Mac редакция эти действия не воспроизводила; если после проверок шаг не работает, не называйте результат успешным. s4 s2

Есть уже записанный файл? Откройте отдельный гайд по расшифровке аудиозаписи в TXT: диктовка Handy в поле не заменяет проверку готовой записи.