Для администраторов сервера

YATB — это приватный бот. Если он есть на твоем сервере, вот как его настроить. Все команды находятся в /yatb и видны только администраторам.

Настройка в 5 шагов

Проверь права доступа. В каждом связанном канале YATB нужны: View Channel, Read Message History, Manage Webhooks, Create Public Threads, Send Messages in Threads, Manage Threads.
Свяжи каналы. Каналы с одинаковым именем Bridge переводятся друг в друга:
/yatb bridge add chat #english English
/yatb bridge add chat #deutsch German
Добавь API-ключи (необязательно). Без ключей YATB использует LibreTranslate. Для лучшего качества добавь ключи с помощью /yatb keys add — см. API-ключи.
Установи канал логов. /yatb log set — YATB будет сообщать туда о предупреждениях использования, проблемах с ключами и изменениях.
Проинформируй участников. Дай ссылку на руководство для участников или добавь краткое правило, например:
Перевод (YATB): В связанных каналах бот YATB автоматически переводит сообщения и публикует их от твоего имени. Для этого они могут отправляться во внешние сервисы (например, ИИ-провайдеры, Google). Тексты сообщений не сохраняются. Перевод «Только локально»: /yatb-user privacy

/yatb status показывает цепочку перевода твоего сервера и состояние каждого сервиса.

Цепочка перевода

Для каждого сообщения YATB пробует сервисы в этом порядке и берет первый успешный результат:

ИИ-провайдеры с твоими ключами — сначала группа с лучшим качеством, бесплатные ключи перед платными
Google Translate
Azure Translator
LibreTranslate на нашем сервере — всегда доступен
[Raw] — исходный текст, если ничего другое не сработало

Каждый ответ проверяется (упоминания, ссылки, форматирование). Неудачный ответ, ошибка или исчерпанный лимит переводят запрос к следующему сервису; неработающий сервис временно пропускается. Участники с настройкой Только локально всегда получают LibreTranslate.

Использование, лимиты и бюджет

Бесплатные ключи: YATB учитывает использование в рамках бесплатных лимитов провайдера в минуту, день и месяц.
Платные ключи: ты устанавливаешь ежемесячный бюджет в USD или EUR. YATB оценивает стоимость по прейскуранту — установи лимит расходов также и у самого провайдера.
Дневные лимиты сбрасываются в 00:00 UTC, месячные — 1-го числа в 00:00 UTC.
Предупреждения при достижении 90, 95 и 100 % отправляются в канал логов. Когда ключ исчерпан, управление переходит к следующему сервису.
Если один и тот же ключ используется на нескольких серверах, использование суммируется. Другие серверы никогда не называются.
/yatb keys list показывает использование по ключу, /yatb keys edit меняет план, бюджет и лимит.

Как защищены ключи

Ключи вводятся в приватной форме Discord, а не как аргумент команды. Они хранятся в зашифрованном виде (AES-256-GCM, отдельно для каждого сервера) и никогда не отображаются снова — только последние 4 символа. Этот сайт никогда не показывает и не принимает ключи.

Все команды

Команда	Описание
`/yatb info`	Руководство по настройке и обзор всех команд
`/yatb guide`	Как получить API-ключ для сервиса перевода
`/yatb status`	Цепочка перевода, использование и состояние сервисов этого сервера
`/yatb bridge add`	Добавить канал в мост перевода
`/yatb bridge remove`	Удалить канал из его моста
`/yatb bridge list`	Список всех мостов этого сервера
`/yatb keys add`	Добавить API-ключ (вводится в приватной форме, хранится в зашифрованном виде)
`/yatb keys edit`	Изменить настройки ключа (сам ключ никогда не отображается)
`/yatb keys list`	Показать API-ключи этого сервера и их использование (сами ключи не отображаются)
`/yatb keys remove`	Удалить API-ключ с этого сервера
`/yatb log set`	Установить канал для уведомлений (предупреждения об использовании, проблемы с ключами, изменения)
`/yatb log clear`	Отключить канал уведомлений
`/yatb reset`	Удалить все мосты, ключи и настройки этого сервера
`/yatb uninstall`	Удалить все данные этого сервера и заставить бота покинуть его
`/yatb-user privacy`	Выбрать, кто может переводить твои сообщения (применяется на всех серверах)
`/yatb-user help`	Что этот бот делает с твоими сообщениями

Удаление YATB

/yatb reset удаляет все Bridge, ключи и настройки твоего сервера. /yatb uninstall удаляет все данные твоего сервера, и бот покидает его.