# speech.cpp 0.10.0: подсказки для японских имён при расшифровке

Источник: https://modelium.tech/zhurnal/speech-cpp-0-10-0-haas-custom-vocabulary/

31 октября вышел speech.cpp 0.10.0. При расшифровке японской записи модель Haas-ja-v1.0 теперь можно направлять списком редких имён и терминов: функция появилась в 0.9.4, а в 0.10.0 получила параметр keywords. Это не гарантия правильного текста: подсказки иногда добавляют слово, которого не было в записи. Modelium сверил документацию, но модель не запускал.

speech.cpp 0.10.0: подсказки для японских имён при расшифровке

В японской записи имя человека или название компании иногда распознаётся не так, как пишется. В выпусках speech.cpp **0.9.4 и 0.10.0 от 31 октября 2026 года** для модели Haas-ja-v1.0 появился способ заранее перечислить такие слова и нужное написание. Это обновление программы для локальной расшифровки, а **не новая исходная модель**. Документация и файлы проверены 31 октября; Modelium не запускал распознавание самостоятельно. [s1](#src-s1) [s2](#src-s2) [s5](#src-s5)

## Что изменилось после версии 0.9.3

В 0.9.4 разработчик добавил пользовательский словарь для Haas-ja-v1.0. В 0.10.0 параметр переименовали в `keywords`, чтобы он совпадал с названием подсказок в интерфейсе приёма аудио; прежнее имя `words` использовать с этой версией не следует. Для разработчиков изменился и номер интерфейса библиотеки: C API 4.0, протокол worker 4. Если приложение подключается к speech.cpp как к библиотеке или worker, совместимость с ним нужно проверять отдельно. [s1](#src-s1) [s6](#src-s6)

Для обычного пользователя смысл проще: при расшифровке короткого японского фрагмента можно передать имя и его чтение, например `Haas=ハース`. В документации для терминала показан параметр `--keywords`; в запросе к локальному серверу используются поля `keywords[]`. Программа старается чаще узнавать перечисленные имена и писать их заданным образом, но не обещает исправить все ошибки записи. [s2](#src-s2) [s6](#src-s6)

## Что понадобится и где проверить результат

Нужны speech.cpp 0.10.0, звуковой файл и веса Haas-ja-v1.0 для **speech.cpp**; автор разместил пять вариантов GGUF. Это файлы модели, но их формат внутри этого проекта не подходит автоматически для Ollama или LM Studio. Готовые архивы программы есть для Mac с Apple Silicon, Windows x64 и Linux x86-64; на Windows требуется драйвер с Vulkan, а для Linux указаны отдельные системные требования и вариант без видеокарты. Интернет нужен для первоначальной загрузки программы и весов. [s1](#src-s1) [s3](#src-s3) [s4](#src-s4)

Если Haas уже скачан через speech.cpp **0.9.3**, старый файл не содержит данных для словаря: автор просит загрузить модель заново командой `speech pull haas-ja-v1.0`. После этого сравните небольшой знакомый фрагмент записи без подсказки и с одним именем: само слово должно быть произнесено в аудио, а написание следует сверить вручную. Это инструкция по документации, не воспроизведённый тест Modelium. [s2](#src-s2) [s4](#src-s4)

## Что учитывать до обновления

Список подсказок может усилить и ошибочное срабатывание: иногда модель напишет указанное слово, которого в звуке нет. Словарь работает только с Haas; совместно с ним нельзя запросить временные отметки слов и фрагментов. Длинную запись разработчик рекомендует делить на участки речи. Поэтому для субтитров с точной привязкой ко времени и для непроверяемых на слух имён этот режим не стоит считать готовым решением. [s2](#src-s2)

Код speech.cpp распространяется по MIT. Карточка оригинальной модели Haas и отдельная лицензия GGUF-пакета указывают Apache 2.0; это отдельные условия для весов, а не следствие лицензии программы. Результаты точности и скорости, которые приводит автор, редакция не воспроизводила. [s4](#src-s4) [s5](#src-s5) [s7](#src-s7)

Начать можно с [предыдущей заметки о запуске Haas-ja-v1.0 в speech.cpp 0.9.3](/zhurnal/speech-cpp-0-9-3-haas-ja-local-japanese-asr/), затем сверить обновлённый раздел словаря в официальной документации 0.10.0. [s2](#src-s2)

## Источники

1. [speech.cpp v0.10.0 — официальный релиз 31 октября](https://github.com/nyosegawa/speech.cpp/releases/tag/v0.10.0) — получено 2026-10-31
2. [speech.cpp v0.10.0 — FastConformer: словарь Haas и ограничения](https://github.com/nyosegawa/speech.cpp/blob/v0.10.0/docs/models/fastconformer.md) — получено 2026-10-31
3. [speech.cpp v0.10.0 — установка и поддерживаемые ОС](https://github.com/nyosegawa/speech.cpp/blob/v0.10.0/docs/install.md) — получено 2026-10-31
4. [Haas-ja-v1.0 GGUF — закреплённая ревизия весов и LICENSE](https://huggingface.co/sakasegawa/Haas-ja-v1.0-GGUF/tree/6b965d5007ba780585de51549d57a8c1c0d67c7e) — получено 2026-10-31
5. [Third Intelligence — исходная Haas-ja-v1.0](https://huggingface.co/third-intelligence/Haas-ja-v1.0/tree/660728d39019e5e065046154beca44ac9a66a540) — получено 2026-10-31
6. [speech.cpp PR #202 — переименование параметров keywords и C API 4](https://github.com/nyosegawa/speech.cpp/pull/202) — получено 2026-10-31
7. [speech.cpp v0.10.0 — лицензия кода MIT](https://github.com/nyosegawa/speech.cpp/blob/v0.10.0/LICENSE) — получено 2026-10-31