# Sincronização na Nuvem
A Sincronização na Nuvem do Voyager faz backup das suas pastas, da biblioteca de prompts, das mensagens marcadas com estrela e das configurações compatíveis. Escolha o Google Drive em qualquer navegador compatível, ou o iCloud no Safari. Os dados são transferidos diretamente entre o Voyager e a conta de nuvem pessoal que você selecionar; o Voyager não opera nenhum servidor de sincronização.
## O que é sincronizado
| Tipo de dado | Sincronizado | Detalhes |
| ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Estrutura de pastas | Sim | Pastas do Gemini, AI Studio, ChatGPT, Claude, DeepSeek e Kimi: aninhamento, cores e atribuições de conversas |
| Biblioteca de prompts | Sim | Todos os prompts salvos, com tags e organização em pastas |
| Mensagens com estrela | Sim | Marcadores da linha do tempo de qualquer conversa |
| Linha do tempo em outros sites | Sim | Favoritos e níveis da linha do tempo no ChatGPT, Claude e DeepSeek |
| Configurações da extensão | Sim | `gemini-voyager-settings.json`: preferências que valem em todos os dispositivos, como ordenação, cores e comportamento da entrada |
| Configuração de plugins | Sim | `gemini-voyager-plugins.json`: estado de instalação/ativação e configurações do plugin; as permissões de sites continuam por dispositivo |
| Respostas do modelo | Não | Os backups de estrelas contêm prompts do usuário, não respostas do modelo |
**Enable Hard Isolation** não vai mais no arquivo de configurações da nuvem. A sincronização do próprio navegador (a do Chrome, por exemplo) continua levando essa opção entre computadores conectados ao mesmo perfil do navegador.
## Dados com estrela e limites de sincronização
Os backups na nuvem incluem o **texto completo dos prompts de usuário que você marca com estrela** (até 16 KiB UTF-8 por prompt) no seu próprio Google Drive ou iCloud. Os backups de estrelas não armazenam respostas do modelo. O backup v1 mantém apenas prévias; o novo v2 inclui o texto e os registros de exclusão.
Os registros de exclusão são mantidos por 180 dias. Versões antigas do Voyager os ignoram e podem exibir ou reenviar estrelas excluídas; as novas bloqueiam cópias antigas com o mesmo carimbo de data e hora. Marcar novamente com uma data posterior, ou a expiração do registro, pode restaurar uma estrela. Longos períodos offline e diferenças nos relógios dos dispositivos também afetam as exclusões.
A sincronização mescla e verifica as gravações, com no máximo três tentativas, mas não é uma transação atômica entre dispositivos: uploads simultâneos ainda podem sobrescrever outras gravações. Uma sincronização posterior de um dispositivo que conserva os dados ausentes pode repará-los; sem ela, a recuperação não é garantida. Falhas parciais mantêm as gravações aceitas; sincronize novamente para concluir o reparo.
## Recursos
- **Sincronização entre dispositivos**: Mantenha suas configurações sincronizadas em vários dispositivos.
- **Privacidade de dados**: Os dados são armazenados diretamente no seu próprio Google Drive ou no banco de dados privado do iCloud, garantindo a privacidade sem nenhum servidor do Voyager.
- **Sincronização flexível**: Suporte para upload manual e download/mesclagem de dados.
::: info
Identificadores de dispositivo, tokens de acesso, caches, coordenadas da janela, posição do painel, posição do botão de exportação e estados temporários de execução não são sincronizados de propósito, pois são considerados personalização.
:::
## Como usar
1. Abra uma aba do Gemini, AI Studio, ChatGPT, Claude, DeepSeek ou Kimi e clique no ícone do Voyager na barra de ferramentas do navegador para abrir o popup. A seção **Sincronização na Nuvem** só aparece nesses sites, e as pastas de cada site são sincronizadas separadamente.
2. Localize a seção **Sincronização na Nuvem**.
3. No Safari, escolha **Google Drive** ou **iCloud**. Os outros navegadores usam o Google Drive.
4. Defina **Modo Sincr.** como **Manual**. O padrão é **Desativado**, e os botões de sincronização só aparecem no modo Manual.
5. Para o Google Drive no Safari, clique em **Conectar ao Google Drive** para entrar pelo app Voyager. Nos outros navegadores não há um botão de login separado: a janela de autorização do Google abre na primeira vez que você clica em **Enviar** ou **Mesclar**. Para o iCloud, verifique se o Mac está conectado ao iCloud.
6. Clique em **Enviar** para sincronizar seus dados locais com a nuvem, ou em **Mesclar** para trazer os dados da nuvem para este navegador. **Sobrescrever** pede confirmação e depois substitui só os dados que a nuvem tem e o Voyager consegue ler; o que estiver faltando ou ilegível na nuvem fica como está, e o resultado mostra isso. Você pode desfazer logo em seguida.
No iCloud, **Excluir backup do iCloud** remove todos os backups do Voyager no iCloud; os dados locais no Mac permanecem como estão.
## Sincronizar pelo painel
O ícone de nuvem na barra superior do [painel do Voyager](/pt/guide/panel) abre **Sincronização na Nuvem**, para sincronizar pelo Google Drive sem sair do chat. Enquanto o Drive não estiver conectado, clique em **Conectar ao Google Drive**; a primeira sincronização depois de conectar mescla a nuvem e este dispositivo, e nada é sobrescrito.
- **Escolher sites**: **Comum** (Prompts · Configurações · Plugins) e cada site têm uma linha. Desative uma linha e este dispositivo a ignora ao sincronizar; um site compatível ao qual você dá acesso entra automaticamente.
- **Status**: cada linha mostra **Sincronizado**, **Mais recente aqui**, **Mais recente na nuvem**, **Não enviado** ou **Não foi possível verificar**. O botão principal, **Sincronizar** seguido de um número, processa de uma vez todas as linhas pendentes.
- **Na nuvem**: um site desativado neste dispositivo, mas com dados na nuvem, ganha uma linha própria; **Ativar** leva você à aba **Sites** para ativá-lo.
- **Mais**: o menu tem **Enviar tudo**, **Mesclar tudo da nuvem**, **Restaurar versão anterior** e **Desconectar o Google Drive**. **Restaurar versão anterior** pede confirmação e depois devolve na nuvem cada linha ativada à versão anterior.
### 💡 Sincronização rápida
A maneira mais fácil é clicar no ícone de nuvem no cabeçalho da área de pastas, na barra lateral esquerda, e escolher **"Enviar para nuvem"** ou **"Sincronizar da nuvem"** no menu.
::: warning
**Recomendação de segurança: Proteção dupla**\
Embora a sincronização na nuvem ofereça grande conveniência, recomendamos enfaticamente que você também faça backups periódicos dos seus dados principais usando **arquivos locais**.
1. **Pastas**: Abra o menu da área de pastas, escolha **Importar/Exportar pastas** e depois **Exportar pastas** para salvar todas as suas pastas e as atribuições de conversas.
2. **Prompts**: No Gerenciador de Prompts, clique em **Exportar** para salvar a sua biblioteca de prompts.
:::
## Proteção da sincronização
Se um envio deixaria um arquivo da nuvem bem menor (este dispositivo não tem nada de algo que a nuvem tem, ou tem menos da metade quando a nuvem tem pelo menos 4) ou o Voyager não consegue ler o arquivo da nuvem, ele pergunta antes: **Mesclar da nuvem**, **Enviar mesmo assim** ou **Cancelar**. Mesclar só é oferecido quando o arquivo da nuvem pode ser lido.
**Sobrescrever** mantém qualquer tipo de dado que falte na nuvem ou que o Voyager não consiga ler, e mostra isso no resultado. Uma lista de plugins vazia na nuvem nunca apaga seus plugins.
Depois de **Mesclar** ou **Sobrescrever**, a linha de resultado do popup oferece **Desfazer** enquanto o popup estiver aberto. O aviso da nuvem na área de pastas oferece isso por cerca de 10 segundos e espera enquanto o ponteiro estiver sobre ele. Desfazer restaura o que aquele download mudou e mantém o que você mudou depois. Só o download mais recente pode ser desfeito.
Antes de um envio substituir um arquivo, o Voyager guarda a versão substituída ao lado dele, na pasta do Drive, como `.backup-.json`, por exemplo `gemini-voyager-folders.backup-2026-10-29-031100.json`. Ele mantém as 3 mais recentes de cada arquivo e move as mais antigas para a lixeira do Drive. **Restaurar versão anterior**, no menu de Sincronização na Nuvem do painel, devolve a nuvem à versão anterior. O iCloud também mantém as 3 versões substituídas mais recentes de cada tipo de dado.
Com **Enable Hard Isolation** ativado, o Voyager atual nomeia os arquivos do Drive de cada conta pelo e-mail da conta. Um dispositivo ainda no Voyager 2.2.1 que viu a conta pela primeira vez em um endereço numerado (gemini.google.com/u/1) não verá o que as versões novas enviarem até ser atualizado. As atualizações da Chrome Web Store chegam em poucos dias; o Safari demora mais.
## Sincronização na nuvem versus backup manual
| Aspecto | Backup manual (Exportar/Importar) | Sincronização na Nuvem |
| -------------------------- | ----------------------------------- | ---------------------------------------------------- |
| Frequência | Quando você lembrar | Sob demanda, com um clique |
| Local dos dados | Arquivo local no seu computador | Seu Google Drive ou banco de dados privado do iCloud |
| Entre dispositivos | Exige transferir arquivos | Dispositivos conectados à conta de nuvem escolhida |
| Comportamento de mesclagem | Substitui ou exige mesclagem manual | Mesclagem inteligente, sem duplicar |
| Privacidade | O arquivo fica na sua máquina | Armazenado na sua conta de nuvem pessoal |
## Como funciona
1. **Provedor**: O Google Drive usa a permissão limitada `drive.file`, então o Voyager só consegue acessar os arquivos que ele mesmo criou. No Safari, o iCloud usa o banco de dados CloudKit privado do app e não expõe ao Voyager nenhum token de ID da Apple.
2. **Envio**: Ao clicar em **Enviar**, o Voyager grava no provedor escolhido arquivos de backup separados para pastas, prompts, estrelas, forks, hierarquia da linha do tempo, configurações de personalização e configuração de plugins. Os dados de destaques são incluídos quando a sincronização de destaques está ativada.
3. **Baixar e mesclar**: Ao clicar em **Mesclar** em outro dispositivo, o Voyager lê esses arquivos e os mescla por tipo de dado. Novas pastas e prompts são adicionados sem duplicação, as preferências da nuvem são restauradas e as entradas de plugins são mescladas pelo ID do plugin.
4. **Sem sincronização em segundo plano**: A sincronização é manual e sob demanda. O Voyager nunca sincroniza sem a sua ação explícita.
Trocar de provedor não copia dados entre eles nem grava em ambos. Depois de trocar, envie uma vez se quiser que os dados locais atuais fiquem no novo provedor escolhido.
## Plataformas compatíveis
A sincronização com o Google Drive funciona no Chrome, Edge, Firefox e Safari no computador, e em navegadores Android com login do Google, como o Edge. Ela não está disponível no Firefox para Android, que não consegue abrir a janela de login do Google. A sincronização com o iCloud está disponível apenas no app do Safari distribuído diretamente e usa a conta do iCloud conectada no Mac.