Словарь и замены в superwhisper: как научить его своим словам и не навредить
Текст: Ryleigh Newman · Опубликовано
В superwhisper есть два инструмента для слов, которые он путает, и работают они противоположным образом. Слова словаря (Vocabulary) это подсказки, которые отправляются вместе с аудио, так что модель с большей вероятностью услышит имя или термин. Замены (Replacements) срабатывают, когда текст уже получен, и подменяют одну строку другой в точности так, как вы задали. Неверный выбор инструмента или слишком много подсказок нередко и есть причина, по которой superwhisper начинает работать хуже, а не лучше.
Я разрабатываю YapToText, другое приложение для диктовки на Mac, поэтому читайте мои слова о superwhisper с учётом этого. Все сведения о superwhisper здесь взяты из его собственной документации, прочитанной 10 октября 2026 года.
Бесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на GitHub.
Это руководство на других языках: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
На этой странице: 12 разделов
Два инструмента рядом
Из документации superwhisper, раздел Vocabulary, прочитанной 10 октября 2026 года.
| Слова словаря | Замены | |
|---|---|---|
| Когда работает | До расшифровки, отправляется вместе с аудио как подсказка | После расшифровки, на готовом тексте |
| Что делает | Повышает вероятность, что модель распознает слово | Подменяет одну строку другой, без участия ИИ |
| Гарантия | Нет. Это лишь подталкивает модель, и эффект зависит от модели | Да. Каждый раз один и тот же результат, какой бы ни была модель |
| Подходит для | Имён, аббревиатур, названий компаний, жаргона, слов из других языков | Ошибок, которые повторяются, символов, адресов электронной почты, фраз, которые нужно раскрывать |
| Риск | Длинный список может запутать модель и изменить пунктуацию | Небольшой. При сопоставлении регистр не учитывается |
Держите словарь коротким
Документация говорит об этом прямо. Слишком много слов в словаре может запутать модель расшифровки, слова из других языков могут ухудшить точность и автоматическое определение языка, а словарь влияет на пунктуацию и форматирование, а не только на написание. Её совет: держать список коротким, а для исправлений, которые должны быть постоянными, использовать замены.
Если после того, как вы добавили много слов в словарь, superwhisper стал добавлять слова или повторять текст, этот случай разбирает страница о добавленных и повторяющихся словах.
Как ведут себя замены
- При сопоставлении регистр не важен. Замена для todo ловит и ToDo, и TODO, и Todo.
- В результате регистр важен. Текст выходит в точности так, как вы напечатали его в замене.
- Одно неверное слово, много написаний. Если слово слышится по-разному, добавьте замену для каждого варианта и направьте их все на верное написание.
- Не зависят от модели. Они работают одинаково, какая бы голосовая модель ни расшифровала текст.
Символы и адреса электронной почты
Голосовые модели настроены на речь, поэтому знак @ или косая черта редко выходят символом. Документация предлагает для этого набор замен:
Из документации superwhisper, раздел Vocabulary, прочитанной 10 октября 2026 года. В документации есть ещё и dash.
| Говорите | Получаете |
|---|---|
| at sign (знак @) | @ |
| dot com | .com |
| dot net | .net |
| dot org | .org |
| hashtag | # |
| slash (косая черта) | / |
| underscore (нижнее подчёркивание) | _ |
Эти слова произносит англоговорящий человек, а свои фразы для замен вы задаёте сами. Для адресов, которые вы вводите часто, добавьте каждый как отдельную замену, например фразу my work email (мой рабочий адрес), которая превращается в сам адрес. Для разового адреса назовите его по частям: имя, at sign, домен, dot com, а остальное сделают замены символов.
Где их найти
Оба инструмента находятся в Settings (настройки), в разделе Vocabulary приложения для Mac, в одном списке. Чтобы удалить элемент, нажмите значок корзины рядом с ним. В терминале у CLI superwhisper есть команда superwhisper vocab для слов словаря и superwhisper snippets для замен, которые документация CLI описывает как те же пары From и To, что и в приложении.
Переезжаете на новый Mac? Словарь переезжает вместе с остальными настройками, как объясняет страница о резервной копии, а остальные команды разобраны на странице о CLI.
Один приём со словарём для определения языка
Если язык выбран как Automatic, а диктовка упорно выходит по-английски, документация superwhisper советует добавить в словарь одну фразу на вашем языке как подсказку или задать конкретный язык. Подсказка действует через модель, поэтому эффект зависит от модели. Шаги описаны на странице о смене языка.
Как с той же задачей справляется YapToText
superwhisper по его документации, прочитанной 10 октября 2026 года. YapToText по его собственным настройкам.
| superwhisper | YapToText | |
|---|---|---|
| Подсказки модели речи | Слова словаря | Слова вашего словаря настраивают модель Whisper |
| Постоянные подмены после | Замены | Substitutions, с параметрами Whole word и Case |
| Больше одного списка | В документации не описано | Несколько словарей, каждый можно отключить, не удаляя |
| Обучение по вашим правкам | В документации не описано | Исправьте одно слово дважды, и приложение предложит закрепить правку |
| Для каждой задачи | В документации не описано | Каждый режим может использовать все включённые словари или выбранные |
YapToText также предлагает исправления на основе ваших диктовок, на Mac. Быстрее всего выделить верное написание в любом месте, нажать клавишу Quick Edit и сказать add this to my dictionary (добавь это в мой словарь). Об этом рассказывает справочная страница о словарях, а руководство по собственному словарю сравнивает варианты на Mac.
Бесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на GitHub.
Коротко
- Имя, которое он никак не слышит верно. Добавьте его как слово словаря.
- Слово, которое он всегда пишет неверно. Добавьте замену, по одной на каждое неверное написание.
- Символы и адреса почты. Замены, например at sign и dot com.
- Результат стал хуже. Сократите словарь.
- Терминал. superwhisper vocab и superwhisper snippets.
Если superwhisper изменит их работу, создайте issue на GitHub, и я обновлю страницу. Читаю каждое.
Бесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на GitHub.
Руководства
Другие руководства, на английском
Источники
- https://superwhisper.com/docs/get-started/interface-vocabulary (проверено 10.10.2026)
- https://superwhisper.com/docs/get-started/cli (проверено 10.10.2026)
- https://superwhisper.com/docs/common-issues/language-detection (проверено 10.10.2026)
- https://github.com/ryleighnewman/YapToText (проверено 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (проверено 10.10.2026)
Вопросы
Чем в superwhisper слова словаря отличаются от замен?
Слова словаря это подсказки, которые отправляются вместе с аудио, чтобы модель узнала термин. Замены срабатывают после расшифровки и подменяют текст в точности так, как вы задали.
Почему superwhisper работает хуже, если добавить слова в словарь?
В его документации сказано, что слишком много слов в словаре может запутать модель и повлиять на пунктуацию и определение языка. Держите список коротким, а для постоянных исправлений используйте замены.
Учитывают ли замены в superwhisper регистр?
При сопоставлении нет, так что todo совпадёт и с TODO. В результате используются те заглавные буквы, которые вы напечатали в замене.
Как продиктовать адрес электронной почты в superwhisper?
Добавьте замены, например at sign для @ и dot com для .com, или добавьте весь адрес как отдельную замену.
Можно ли править словарь superwhisper из терминала?
Да. В CLI superwhisper есть vocab для слов словаря и snippets для замен.