Local STT Worker

Local STT Worker для macOS: подключение к MikoPBX, локальная транскрибация, история, модели, диагностика, настройки и обновление Worker API.

Local STT Worker — приложение для локального распознавания записей звонков из MikoPBX. Оно скачивает одно назначенное задание, подготавливает аудио встроенными ffmpeg и ffprobe, запускает выбранный в MikoPBX движок Parakeet или WhisperKit с Core ML-моделью и отправляет в PBX сегменты с таймкодами и техническую диагностику.

Вкладка "Обзор" в обработчике STT

Требования

• Mac с Apple Silicon.

• macOS 14.0 или новее.

• MikoPBX 2025.1.1 или новее.

• Доступ к PBX по сети.

• Доступ в интернет для первой загрузки выбранной модели и ее служебных файлов.

Для распознавания Worker использует WhisperKit или FluidAudio в зависимости от модели в задании. ffmpeg и ffprobe уже включены в сборку Worker и отдельно устанавливать их не требуется.

Движки и модели

Модель выбирается только в MikoPBX. Worker получает вместе с заданием идентификаторы движка, модели, репозитория и типа артефакта, проверяет их совместимость и автоматически запускает нужный движок.

• Parakeet TDT 0.6B v3 работает через FluidAudio и является моделью по умолчанию. Она предназначена для длинной речи и поддерживает 25 европейских языков, включая русский и украинский.

• Whisper Large V3 Turbo, Whisper Podlodka Turbo и Whisper Large V3 работают через WhisperKit.

• Произвольные пользовательские модели не поддерживаются. Worker принимает только модели из текущего каталога MikoPBX.

Термины для распознавания передаются обоим движкам. WhisperKit использует их как контекст, а Parakeet компилирует их в локальную подсказку декодеру.

Первый запуск

Подробнее про онбоардинг можно прочитать здесь.

Онбоардинг состоит из трех шагов:

1. Выбор языка - русский или английский интерфейс. После смены языка приложение может предложить перезапуск и продолжит настройку после запуска.

2. Подключение к MikoPBX - адрес https://..., имя Worker и токен с вкладки Обработчики. В дополнительных настройках находятся проверка TLS, собственный CA и UID.

3. Завершение - проверка готовности MikoPBX и Speech to Text, настройка запуска при входе и переход в приложение.

Навигация

Раздел	Назначение
Обзор	Состояние Worker, подключение, текущая работа, готовность системы и последние звонки.
История	Локальная история заданий этого Mac с фильтрами и поиском.
Модели	Локально загруженные Core ML-модели WhisperKit и Parakeet и размер хранилища.
Диагностика	Проверка подключения, UID, heartbeat и локальные события.
Настройки	Подключение к MikoPBX и параметры, относящиеся только к этому Mac.

Раздел «Обзор»

Верхний блок показывает одно из основных состояний:

Состояние	Значение
Все работает	Worker подключен и автоматически проверяет очередь.
Расшифровка звонка	Выполняется активное задание.
Требуется внимание	Возникла ошибка подключения, совместимости или обработки.
Готов к запуску	Подключение настроено, но Worker остановлен.
Требуется настройка	Не хватает адреса PBX, токена или регистрации.

Основная кнопка меняется в зависимости от состояния: Запустить обработчик, Остановить обработчик или Открыть настройки. При остановке новые звонки остаются в очереди MikoPBX.

Сводка показывает количество обработанных сегодня звонков, долю успешно завершенных заданий и время последнего звонка. Ниже находятся текущая активность, готовность подключения, выбранная модель, автозапуск и три последних задания. Название выбранной модели поступает из MikoPBX вместе с централизованными настройками; отдельной локальной модели по умолчанию в интерфейсе Worker нет.

Во время активной работы отображается текущий этап и прогресс:

1. проверка контракта и регистрация;

2. получение lease задания;

3. скачивание записи;

4. анализ и подготовка аудио;

5. выбор движка, загрузка или открытие модели;

6. локальная транскрибация через Parakeet или WhisperKit;

7. отправка результата или ошибки;

8. удаление временных файлов.

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

Раздел «История»

История содержит задания, которые получил именно этот Mac. Это не общий список расшифровок PBX.

Доступны периоды 24 часа, 7 дней и 30 дней, фильтры по завершенным, проблемным и активным заданиям, а также поиск по call_id. Строку можно раскрыть для просмотра этапов и технических данных; из проблемного задания можно перейти в Диагностика.

Локальная история сохраняется между запусками приложения. Готовая расшифровка и запись разговора по-прежнему хранятся и управляются на стороне MikoPBX.

Раздел "История" в STT обработчике

Раздел «Модели»

Модель для новых заданий выбирается в MikoPBX на вкладке Каталог моделей. Worker синхронизирует выбранную модель с PBX и автоматически скачивает требуемые файлы при первом задании.

Раздел показывает:

• количество моделей и общий размер;

• размер служебных данных;

• список локально загруженных моделей;

• расположение модели в Finder.

Для Parakeet раздел может показывать два набора файлов: ASR с Core ML-моделью для распознавания и Tokenizer, который используется при подготовке подсказок из списка терминов. Оба набора относятся к одной модели.

Кнопки Обновить и Открыть папку перечитывают хранилище и открывают его в Finder. Ненужную локальную копию можно удалить только после остановки Worker. Если модель снова понадобится, она будет загружена повторно.

Первая обработка новой модели занимает больше времени из-за загрузки и подготовки кэша. Не отключайте интернет до окончания загрузки.

Раздел "Модели" в STT обработчике

Раздел «Диагностика»

Диагностика объединяет состояние подключения, автоматического восстановления и локальный журнал.

В верхней части доступны:

• общая оценка состояния;

• кнопка Проверить соединение;

• кнопка Открыть папку логов.

Техническая сводка показывает адрес MikoPBX, состояние подключения, UID и время последнего успешного heartbeat. UID можно скопировать для сопоставления с таблицей обработчиков на PBX.

Локальные события можно ограничить по времени (Все, 1 час, Сегодня) и уровню (Все, Предупреждения, Ошибки), найти по тексту, скопировать или экспортировать. На экране показываются последние 250 подходящих событий.

Раздел "Диагностика" в STT обработчике

Раздел «Настройки»

Подключение к MikoPBX

Поле	Назначение
Адрес MikoPBX	Адрес PBX, с которой работает Worker.
Токен Worker	Ограниченный токен модуля, сохраненный в macOS Keychain.
Имя Worker	Понятное имя Mac в таблице обработчиков.
UID Worker	Стабильный технический идентификатор этого Mac.

Кнопка Зарегистрировать этот Mac проверяет подключение и создает или обновляет регистрацию.

Общие настройки

Настройка	Назначение
Язык приложения	Русский, английский или системный язык. Для применения требуется перезапуск.
Запуск вместе с macOS	Запускать приложение после входа пользователя.
Поддерживать работу обработчика	Сохранять намерение работать и автоматически восстанавливаться после потери сети, сна или временной ошибки.
Временные файлы	Папка загруженных записей и промежуточных WAV-сегментов.
Проверка TLS	Проверять HTTPS-сертификат MikoPBX.
Собственный CA	Необязательный PEM/CRT/CER-файл для частного сертификата.

Кнопка Запустить настройку заново повторно открывает онбоардинг.

Раздел "Настройки" в STT обработчике

Статус в строке меню

Значок Local STT Worker в строке меню показывает, работает ли STT, выполняется ли транскрибация или требуется внимание. Меню содержит состояние, текущий этап или время последнего контакта и кнопку Открыть приложение.

Состояние обработчика в строке меню

Локальные данные и безопасность

Данные	Расположение
Модели	~/Library/Application Support/Local STT Worker/Models
Временные файлы	~/Library/Application Support/Local STT Worker/Temporary
Журналы	~/Library/Logs/Local STT Worker
Пароли/Токены	Keychain service LocalSTTWorker.PBX
Настройки	UserDefaults приложения com.mikopbx.LocalSTTWorker

Worker принимает запись только от авторизованной MikoPBX и сохраняет ее в безопасную временную директорию. После завершения задания временные аудиофайлы удаляются.

Для Parakeet Worker проверяет ожидаемую модель и репозиторий, загружает компоненты только по HTTPS, проверяет служебные файлы и не использует символические ссылки внутри каталога модели. Локальные пути к модели не включаются в сообщения об ошибках, отправляемые в PBX.

Что настраивается в MikoPBX, а что на Mac

Где	Параметры
MikoPBX / модуль	Период обработки, срок хранения, максимальная длительность записи, движок и модель, язык задания, словарь терминов, профиль обработки, очередь, ключи, расшифровки и журнал модуля.
Local STT Worker	Параметры подключения, UID и имя Mac, запуск и восстановление Worker, локальный кэш моделей, временная папка, TLS/CA, локальная история и диагностика.