Bridge não liga em Linux Snap/Flatpak

Em resumo: um Thunderbird em sandbox (Snap ou Flatpak) não consegue iniciar o auxiliar do atbridge.ai, pelo que a extensão não liga. Execute o auxiliar como serviço em segundo plano (atbridge bridge service install && atbridge bridge service start) e emparelhe a extensão por loopback com o token de atbridge bridge pair — ou reinstale o Thunderbird a partir de thunderbird.net.

No Linux, se o atbridge.ai “funcionou e depois parou”, a extensão @bridge não consegue ligar ou a ativação falha com um erro vago (e o ~/.atbridge não tem license.json), a causa é quase sempre a forma como o Thunderbird foi instalado — não a sua licença.

Porque é que isto acontece

O atbridge.ai comunica com o Thunderbird através de um pequeno auxiliar local (um native-messaging host). Normalmente é o Thunderbird que inicia esse auxiliar. O Snap e o Flatpak executam o Thunderbird dentro de uma sandbox de segurança que o impede de lançar um programa externo — pelo que o auxiliar nunca arranca e a extensão não consegue ligar-se. Isto afeta sobretudo os utilizadores de Ubuntu: o Ubuntu App Center instala o Thunderbird como Snap por predefinição.

Boas notícias: não precisa de reinstalar o Thunderbird. Um Thunderbird em sandbox consegue na mesma estabelecer ligações de rede locais, por isso o atbridge.ai inclui um fallback de loopback — executa o auxiliar você mesmo como um pequeno serviço em segundo plano, e a extensão liga-se a ele por 127.0.0.1. Configure uma vez; fica configurado.

Dica

Esta página é a correção oficial para o Thunderbird Snap/Flatpak. No Windows, no macOS e num Thunderbird de Linux sem sandbox a configuração predefinida não precisa de nada disto — funciona simplesmente.

Passo 1 — Verifique como o Thunderbird está instalado

1. Execute o seguinte num terminal:

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

2. Se o Thunderbird aparecer em snap ou flatpak, use o fallback de loopback abaixo. (Um caminho simples como /usr/bin/thunderbird do pacote da sua distribuição ou do tarball da Mozilla não precisa de nada disto.)

Nota

O atbridge bridge tb-check também deteta um Thunderbird Snap/Flatpak e imprime estes mesmos passos.

Passo 2 — Execute o bridge como serviço em segundo plano

Isto executa o auxiliar de forma autónoma (um serviço systemd --user) para que o Thunderbird em sandbox o consiga alcançar por loopback, em vez de ter de o lançar.

1. Instale e inicie o serviço:

   atbridge bridge service install
   atbridge bridge service start

2. Confirme que está a funcionar:

   atbridge bridge service status

   Pretende active. (Também arranca automaticamente quando inicia sessão.)

Passo 3 — Emparelhe a extensão com o serviço

Como a extensão não consegue ler ficheiros na sua máquina, entrega-lhe um token único para que só ela possa comunicar com o serviço (nenhuma página web aleatória consegue).

1. Imprima o token:

   atbridge bridge pair

   Copie o valor token que mostra.

2. No Thunderbird, abra atbridge.ai → Definições → Avançado → Bridge local (Snap/Flatpak). Cole o token, marque Ativar fallback de loopback e clique em Guardar. (Deixe a porta em 45678, a menos que a tenha alterado.)

Verificar

atbridge bridge ping
atbridge connect status

Uma resposta do bridge ping significa que o Thunderbird e o atbridge.ai estão a comunicar por loopback. Depois ative o seu plano se ainda não o fez.

Dica

Não precisa de reinstalar o Thunderbird. O bridge de loopback acima é uma configuração de primeira classe e suportada — mantenha o seu Thunderbird Snap/Flatpak. (Se preferir saltar a configuração única do serviço, um Thunderbird normal de thunderbird.net ou de um pacote da distribuição usa o bridge nativo predefinido sem nada do acima — mas isso é totalmente opcional.)

Para onde ir a seguir

• Quando a ativação falha
• Quando a IA diz “no tools”
• Quando a sua IA não encontra nada