bridge не подключается на Snap/Flatpak Linux

Коротко: Thunderbird в песочнице (Snap или Flatpak) не может запустить вспомогательную службу atbridge.ai, поэтому дополнение не подключается. Запустите службу как фоновую (atbridge bridge service install && atbridge bridge service start) и свяжите дополнение через loopback с помощью токена из atbridge bridge pair — либо переустановите Thunderbird с thunderbird.net.

На Linux, если atbridge.ai «работал, а потом перестал», дополнение atbridge не может подключиться или активация завершается невнятной ошибкой (а в ~/.atbridge нет файла license.json), причина почти всегда в том, как был установлен Thunderbird — а не в вашей лицензии.

Почему так происходит

atbridge.ai общается с Thunderbird через крошечную локальную вспомогательную службу (хост native-messaging). Обычно Thunderbird запускает эту службу сам. Snap и Flatpak запускают Thunderbird внутри защитной песочницы, которая запрещает ему порождать внешние программы — поэтому служба не стартует и дополнение не подключается. Особенно это бьёт по пользователям Ubuntu: Ubuntu App Center по умолчанию устанавливает Thunderbird как Snap.

Хорошая новость: переустанавливать Thunderbird не нужно. Thunderbird в песочнице всё же может устанавливать локальные сетевые соединения, поэтому atbridge.ai поставляет резервное подключение через loopback — вы сами запускаете службу как небольшой фоновый процесс, а дополнение подключается к ней через 127.0.0.1. Настройте один раз — и это сохранится.

Совет

Эта страница — официальное решение для Thunderbird из Snap/Flatpak. На Windows, macOS и Linux с Thunderbird без песочницы стандартная настройка не требует ничего из этого — всё просто работает.

Шаг 1 — Проверьте, как установлен Thunderbird

1. Выполните это в терминале:

   snap list 2>/dev/null | grep -i thunderbird
   flatpak list 2>/dev/null | grep -i thunder
   which thunderbird

2. Если Thunderbird появляется под snap или flatpak, используйте резервное подключение через loopback ниже. (Обычный путь вроде /usr/bin/thunderbird из пакета вашего дистрибутива или tarball от Mozilla ничего из этого не требует.)

Заметка

atbridge bridge tb-check тоже определяет Thunderbird из Snap/Flatpak и выводит эти же шаги.

Шаг 2 — Запустите bridge как фоновую службу

Это запускает вспомогательную службу автономно (служба systemd --user), чтобы Thunderbird в песочнице мог достучаться до неё через loopback, а не запускать её сам.

1. Установите и запустите службу:

   atbridge bridge service install
   atbridge bridge service start

2. Проверьте, что она работает:

   atbridge bridge service status

   Вам нужен статус active. (Служба также запускается автоматически при входе в систему.)

Шаг 3 — Свяжите дополнение со службой

Поскольку дополнение не может читать файлы на вашей машине, вы передаёте ему одноразовый токен, чтобы только оно могло общаться со службой (никакая случайная веб-страница не сможет).

1. Выведите токен:

   atbridge bridge pair

   Скопируйте значение token, которое оно показывает.

2. В Thunderbird откройте atbridge.ai → Настройки → Дополнительно → Локальный bridge (Snap/Flatpak). Вставьте токен, отметьте Включить резервное подключение через loopback и нажмите Сохранить. (Оставьте порт 45678, если вы его не меняли.)

Проверка

atbridge bridge ping
atbridge connect status

Ответ от bridge ping означает, что Thunderbird и atbridge.ai общаются через loopback. После этого активируйте свой тариф, если вы ещё этого не сделали.

Совет

Переустанавливать Thunderbird не нужно. Loopback-bridge выше — это полноценный поддерживаемый вариант настройки, оставьте свой Thunderbird из Snap/Flatpak. (Если вы предпочтёте обойтись без разовой настройки службы, обычный Thunderbird с thunderbird.net или из пакета дистрибутива использует стандартный нативный bridge без всего вышеперечисленного — но это полностью на ваше усмотрение.)

Куда двигаться дальше

• Когда активация не проходит
• Когда ИИ говорит «нет инструментов»
• Когда ваш ИИ ничего не находит

Быстрее: спросите сообщество

На вопросы «как мне…» вы обычно получите более быстрый ответ — и поможете следующему человеку с тем же вопросом — в Discord. Всё, что связано с вашей учётной записью, оплатой или ошибкой, лучше оформить как обращение в поддержку, где мы отвечаем по электронной почте.