# Sincronização na nuvem com o Dropbox

Faça backup dos projetos da sua biblioteca e das suas configurações no seu próprio Dropbox e abra-os nos seus outros computadores. O que é sincronizado, como conflitos e exclusões são tratados e o que cada mensagem significa.

A sincronização na nuvem mantém uma cópia dos projetos da sua biblioteca e das suas configurações no seu próprio Dropbox. Conecte o mesmo Dropbox em outro computador, baixe seus projetos lá, e os dois computadores os mantêm em sincronia.

Abra **Configurações → Armazenamento de dados → Sincronização na nuvem** para configurá-la.

## Antes de começar

- Você precisa de uma conta do Dropbox. Uma conta gratuita do Dropbox Basic tem 2 GB.
- A sincronização na nuvem funciona no macOS, no Windows e no Linux.
- O Oleafly só sincroniza enquanto está aberto, inclusive quando está minimizado ou com a janela oculta. Nada é sincronizado enquanto o Oleafly está fechado.
- O Oleafly conversa diretamente com o Dropbox. Não há nenhum servidor do Oleafly no meio.

## Conecte o Dropbox

1. Abra **Configurações → Armazenamento de dados → Sincronização na nuvem** e selecione **Conectar o Dropbox**.
2. Seu navegador abre a página de login e de aprovação do Dropbox. Faça login ali e aprove o Oleafly.
3. O Oleafly termina de se conectar e, em seguida, o navegador mostra “Você está conectado”. Se algo der errado depois que você aprova, o navegador diz que o login não foi concluído, e o Oleafly mostra o que aconteceu.

Você faz login na página do próprio Dropbox, então o Oleafly nunca vê a sua senha do Dropbox.

### Se o navegador não consegue devolver o controle ao Oleafly

Depois que você aprova, o Dropbox envia o seu navegador a um endereço local no seu computador (127.0.0.1), e o Oleafly recebe o login a partir dele. Se isso não funcionar, selecione **Problemas para entrar? Cole um código**. O Dropbox mostra um código. Copie-o e cole no Oleafly.

### A que o Oleafly tem acesso

- O Oleafly só consegue abrir a própria pasta de aplicativo no seu Dropbox, `Apps/Oleafly`. Ele não enxerga nenhum dos seus outros arquivos do Dropbox.
- Ele pede ao Dropbox quatro permissões e nenhuma outra. `account_info.read` mostra o seu endereço de e-mail e quanto espaço você usou. `files.metadata.read`, `files.content.read` e `files.content.write` permitem listar, ler e gravar os arquivos da própria pasta dele.
- O login usa OAuth com PKCE.
- No macOS e no Windows, o token de login fica no chaveiro do sistema operacional. No Linux, ou quando o chaveiro não está disponível, ele fica em um arquivo criptografado na pasta de dados do Oleafly.
- O token nunca é sincronizado. Cada computador se conecta por conta própria.

### O cartão Sincronização na nuvem

Depois que você se conecta, o cartão mostra:

- O endereço de e-mail da conta do Dropbox.
- Um anel que mostra quanto do seu Dropbox está em uso. Ele passa de verde para amarelo, laranja e vermelho conforme o Dropbox enche, e fica vermelho a partir de 80%.
- **Sincronizar neste computador**, a chave que liga ou desliga a sincronização aqui.
- **Sincronizar automaticamente**, a chave que deixa o Oleafly sincronizar por conta própria.
- O nome deste computador. Clique nele para renomear o computador.
- A lista **Projetos**.
- **Avançado**, com **Desconectar**.

## O que é sincronizado

### Projetos

Todo projeto da sua biblioteca é sincronizado, com os arquivos dele, incluindo a pasta em que o seu documento principal é compilado. O Oleafly deixa de fora, sem avisar, o seguinte em todos os projetos:

- A saída da compilação, como os arquivos `.aux` e `.log` e o PDF principal compilado. Um arquivo de compilação que você acompanha no Git, como um log de resultados, continua com backup no seu Dropbox.
- As pastas `__pycache__` do Python
- A pasta `.git`
- As pastas de trabalho do próprio Oleafly
- Arquivos temporários de editores
- Arquivos do sistema como `.DS_Store`

Algumas outras coisas também não são sincronizadas, e a linha do projeto as lista como ignoradas, com o motivo: links simbólicos, pastas `node_modules` e `.venv`, arquivos maiores que 16 GB e arquivos com [nomes que não funcionam em todos os computadores](#renames-and-file-names).

Os projetos que você abriu a partir de uma pasta em outro lugar do seu computador ([pastas abertas no local](/docs/library/#folders-opened-in-place)) não são sincronizados. A lista Projetos diz quantos são.

O histórico do Git e os [pontos de verificação](/docs/checkpoints/) não são sincronizados.

### Detalhes do projeto

O `project.json` de cada projeto também é sincronizado, então o nome, o documento principal, o motor, a cor da capa e outros detalhes dele o acompanham. Alguns detalhes pertencem a um só computador e ficam nele:

- Os caminhos de exportação
- Se o projeto está oculto
- A especificação de pacotes TeX
- A política de captura de pontos de verificação
- De qual projeto ele foi derivado (fork)

### Notas

Cada [nota](/docs/notes/) pessoal é sincronizada como um projeto da biblioteca, e uma nota dentro de um projeto é sincronizada com os arquivos desse projeto. Se uma nota pessoal mudou em dois computadores, a versão do outro computador é salva na pasta da nota como uma cópia de conflito, como `note (Laptop 2026-10-14).md`, e **Comparar a cópia de conflito**, no menu da nota, permite manter uma das versões. Uma nota dentro de um projeto recebe a cópia de conflito ao lado dela, na pasta `notes` do projeto, como qualquer outro arquivo do projeto.

### Configurações

As configurações do seu aplicativo são sincronizadas, incluindo as instruções de IA, as personas de IA e o seu dicionário personalizado. Algumas configurações ficam em cada computador, como se **Sincronizar automaticamente** está ligado, o **Motor de compilação padrão** do LaTeX, o **Shell** e o **Caminho do shell** do terminal, **Computer Use** em Integrações, a chave **Tarefas de pesquisa** em Experimentação e **Permitir a rede para os comandos das tarefas por padrão** em Pesquisa. Assim, um agente nunca ganha os seus aplicativos de desktop em um computador só porque você os ativou em outro, e um computador sem instalação do TeX continua com o Tectonic quando outro usa o latexmk.

Chats de IA, senhas, chaves de API e outros segredos nunca são sincronizados.

## O que há no seu Dropbox

Tudo fica na pasta `Apps/Oleafly`:

```text
Apps/Oleafly/
├── projects/
│   └── <project id>/
│       ├── files/          the project's files, under their own names
│       └── version.json    which version of each file belongs to the project
└── settings/
    └── settings.json       your synced settings
```

Os arquivos do projeto mantêm os próprios nomes, então você pode abri-los pelo Dropbox. Editar ou mover arquivos em `Apps/Oleafly` à mão não é compatível. O Oleafly trata tudo o que está nessa pasta como não confiável e confere.

## Como funciona uma rodada de sincronização

Cada rodada passa pelas mesmas etapas:

1. O Oleafly pergunta ao Dropbox quais projetos mudaram desde a última rodada. Quando nada mudou, isso leva uma requisição.
2. Ele examina os arquivos de cada projeto neste computador. Reconhece rapidamente os arquivos que não mudaram, sem lê-los de novo.
3. Para cada arquivo, compara três versões: a deste computador, a do Dropbox e a última versão em que os dois concordaram. Isso diz de que lado houve a mudança.
4. Baixa as alterações dos seus outros computadores para um lugar temporário e confere cada arquivo com a impressão digital (hash) registrada para ele. Só então o arquivo entra no projeto. Se você mudou esse arquivo neste computador depois do exame, o Oleafly não mexe nele até a próxima rodada.
5. Envia as alterações deste computador e depois compara a soma de verificação do próprio Dropbox com o que enviou.
6. Salva o registro de versão do projeto, conferindo que nenhum outro computador salvou um nesse meio-tempo. Se salvou, a rodada roda de novo com o registro mais novo, para que o trabalho de nenhum dos computadores se perca.
7. Por fim, remove do Dropbox os arquivos que você excluiu neste computador.

## Quando o Oleafly sincroniza

**Sincronizar automaticamente** fica ligado, a menos que você o desligue. Enquanto está ligado, o Oleafly sincroniza alguns segundos depois que você salva um arquivo e logo depois que outro computador muda o seu Dropbox. Entre um momento e outro, ele confere a cada 5 minutos, ou a cada 15 minutos enquanto a janela do Oleafly está oculta. A primeira rodada acontece cerca de 20 segundos depois que o Oleafly inicia, e as mudanças nas suas configurações são sincronizadas cerca de 3 segundos depois que você as faz. Com **Sincronizar automaticamente** desligado, o Oleafly sincroniza quando você seleciona **Sincronizar agora**, e uma vez quando você se conecta, liga **Sincronizar neste computador** de novo ou liga de novo a chave de um projeto.

Se uma rodada falha, por exemplo porque você está offline, o Oleafly tenta de novo depois de 30 segundos e espera mais a cada falha, até 5 minutos, ou 15 minutos enquanto a janela está oculta. Ele volta ao ritmo normal assim que uma rodada dá certo. Ele também sincroniza quando o seu computador volta a ficar online.

**Sincronizar agora** executa uma rodada na hora e mostra uma mensagem com o resultado. As rodadas automáticas nunca mostram pop-ups. O status delas aparece na seção Projetos: “Última sincronização” com uma hora, “Sincronizando seus projetos” ou uma linha que descreve um problema.

Quando algo precisa de você, como um Dropbox cheio, um projeto em pausa, uma cópia de conflito ou uma escolha de configurações, um pequeno ponto âmbar aparece no botão Configurações. As Configurações então abrem em Sincronização na nuvem, para você ver primeiro o que está errado.

## Conflitos

Se o mesmo arquivo mudou em dois computadores entre sincronizações, o Oleafly mantém as duas versões. A versão deste computador fica com o nome original. A versão do outro computador é salva ao lado, com o nome do computador que a gravou e a data, como `ch1 (Laptop 2026-10-14).tex`. Um segundo conflito no mesmo dia acrescenta um número ao nome. A linha do projeto lista as cópias de conflito até você selecionar **Dispensar**.

Abra os dois arquivos, fique com o que quiser e exclua a cópia de que não precisa.

O `project.json` nunca recebe uma cópia de conflito. Os campos dele são mesclados. As mudanças de cada computador são mantidas e, se os dois computadores mudaram o mesmo campo, vale o valor deste computador.

### Edições não salvas ficam seguras

A sincronização nunca sobrescreve um arquivo aberto no editor com alterações não salvas. As mudanças dos seus outros computadores esperam. Depois que você salva, a próxima rodada trata a sua edição como qualquer outra, então, se os dois lados mudaram o arquivo, você recebe uma cópia de conflito.

Um arquivo aberto que você não alterou é atualizado no editor assim que chega uma mudança de outro computador. Se uma mudança chega enquanto você está editando, o editor avisa que o arquivo mudou no disco, e você escolhe **Recarregar** ou **Manter minha versão**. Os arquivos novos e as cópias de conflito aparecem na árvore de arquivos, e um arquivo excluído em outro computador é fechado aqui.

### Renomeações e nomes de arquivos

Mudar só as letras maiúsculas e minúsculas do nome de um arquivo conta como renomeação, não como exclusão.

O Oleafly ignora estes arquivos e os lista sob a linha do projeto:

- Arquivos com nomes que não funcionam em todos os computadores, como nomes com `:` ou nomes como `CON.tex`
- Arquivos cujos nomes diferem de outro nome na mesma pasta só pelas letras maiúsculas e minúsculas. O arquivo que já é sincronizado continua sendo sincronizado.

A lista também mostra os arquivos que o Oleafly não conseguiu ler aqui ou não conseguiu baixar ou enviar. Um arquivo que falha ao ser baixado é tentado de novo depois de uma hora, ou antes se ele mudar.

## Exclusão de arquivos

Quando você exclui um arquivo em um computador, ele também é excluído nos seus outros computadores. Lá, o arquivo vai para a Lixeira do sistema ou, se o sistema não tiver uma, para a pasta de lixeira do próprio Oleafly. Você pode recuperá-lo dali.

Um registro ausente do Dropbox nunca exclui arquivos em um computador. Se alguém excluir à mão a pasta de um projeto no Dropbox, o Oleafly envia o projeto de novo. Se o registro de um projeto no Dropbox não tiver o `project.json`, o Oleafly envia o arquivo de novo em vez de excluí-lo.

### Proteção contra a exclusão de muitos arquivos

Se mais da metade dos arquivos de um projeto for excluída de uma vez em um computador, e isso for mais de 20 arquivos, o Oleafly não repassa a exclusão. O mesmo acontece se todos os arquivos do projeto forem excluídos. Mover ou renomear uma pasta não conta, porque os arquivos continuam existindo. O projeto mostra “Em pausa para proteger seus arquivos” com duas escolhas:

- **Restaurar os arquivos** restaura os arquivos a partir do Dropbox.
- **Excluir também do Dropbox** os exclui do Dropbox, depois que você confirma. Seus outros computadores então os perdem também.

A mesma verificação vale no sentido contrário. Se muitos arquivos de repente somem do registro de um projeto no Dropbox, por exemplo porque o registro foi restaurado a partir de uma versão mais antiga, o Oleafly não os exclui neste computador. O projeto mostra “Em pausa para proteger seus arquivos” com duas escolhas:

- **Colocar de volta no Dropbox** envia de novo os arquivos deste computador.
- **Excluir aqui também** os move para a Lixeira deste computador, depois que você confirma.

## A lista Projetos

Cada projeto da sua biblioteca tem uma linha que mostra o tamanho dele e quando foi sincronizado pela última vez.

- A chave dele sincroniza o projeto neste computador ou o pausa aqui.
- Um projeto que existe só no Dropbox tem um botão de download. **Baixar tudo** baixa todos eles, exceto os projetos que estão na Lixeira deste computador. Um projeto baixado aparece na sua biblioteca.
- Se o projeto está na Lixeira deste computador, baixá-lo o restaura da Lixeira em vez de criar uma segunda cópia. A próxima sincronização traz as mudanças feitas em outro lugar.
- Um projeto baixado do Dropbox abre em modo restrito até você confiar nele naquele computador. Você recebe o mesmo pedido de confiança de uma [pasta que você abre no local](/docs/library/#folders-opened-in-place).

### Remova um projeto do Dropbox

Para liberar espaço, escolha **Remover do Dropbox** no menu **…** da linha de um projeto. Isso exclui a cópia do projeto no Dropbox. O projeto continua neste computador e deixa de ser sincronizado aqui. Seus outros computadores mantêm as cópias deles e mostram “Removido do Dropbox no computador” seguido do nome deste computador.

Ligue de novo a chave do projeto para enviá-lo outra vez.

Os projetos que existem só no Dropbox também têm **Remover do Dropbox** no menu. Isso os exclui do seu Dropbox, então você não poderá baixá-los neste computador depois. Os computadores que já os têm mantêm as cópias deles.

Se o Dropbox não consegue excluir a pasta na hora, o projeto ainda aparece como removido, e o Oleafly termina de excluí-lo em uma sincronização posterior.

## Armazenamento e um Dropbox cheio

O anel no cartão Sincronização na nuvem mostra quanto do seu Dropbox está em uso e fica vermelho a partir de 80%. Uma conta gratuita do Dropbox Basic tem 2 GB.

Quando o seu Dropbox está cheio, os envios param, mas os downloads continuam funcionando. Um aviso informa isso, e cada projeto que não conseguiu enviar também mostra. Enquanto está cheio, o Oleafly confere quanto espaço resta antes de enviar, para nunca mandar um arquivo que não cabe. Para abrir espaço, faça uma destas coisas:

- Desative a sincronização de projetos grandes.
- Remova projetos do Dropbox.
- Libere espaço no Dropbox.

A sincronização continua sozinha quando houver espaço.

## Sincronizações offline e interrompidas

Quando você está offline, suas edições ficam no seu computador e nada se perde. A sincronização retoma quando a conexão volta.

Se uma rodada para no meio, por exemplo porque a rede caiu ou você fechou o Oleafly, a próxima rodada termina o trabalho. Um primeiro backup longo salva o progresso a cada 200 arquivos ou 256 MB, para não recomeçar do zero. Desativar **Sincronizar neste computador** interrompe uma rodada em andamento.

Enquanto um comando do Git está alterando os arquivos do projeto, como um checkout ou um pull no terminal, a rodada espera e tenta de novo na vez seguinte. No Windows, um arquivo que outro programa mantém aberto é tentado de novo alguns minutos depois.

Quando o Dropbox pede ao Oleafly que desacelere ou tem um erro temporário, o Oleafly tenta de novo sozinho.

Se este computador está com pouco espaço em disco, os downloads esperam até você liberar algum. Os envios continuam.

## Sincronização das configurações

Na primeira vez que um computador se conecta, o Oleafly compara as configurações dele com as que estão no seu Dropbox. Se forem diferentes, ele pergunta uma vez: “Quais configurações o Oleafly deve usar?” Escolha **Usar as configurações do Dropbox** ou **Manter as configurações deste computador**. Se você fechar a caixa de diálogo, ela não volta sozinha. As mesmas duas escolhas ficam esperando no cartão Sincronização na nuvem, e nada é sobrescrito até você escolher uma.

Depois disso, as configurações são mescladas sozinhas:

- As mudanças em configurações diferentes em computadores diferentes são todas mantidas.
- Se a mesma configuração mudou nos dois, vale o valor deste computador.
- As listas, como as palavras do seu dicionário, são combinadas. As personas de IA são mescladas uma a uma, então uma persona editada em dois computadores continua sendo uma só persona.

Para carregar você mesmo as configurações do Dropbox, abra **Configurações → Geral → Importar** e escolha **Importar da nuvem**. Você recebe a mesma etapa de revisão de quando importa um arquivo de configurações.

## Computadores e contas

### Dê um nome a este computador

Cada computador tem um nome. Ele começa como o nome de host do computador. Clique no nome no cartão Sincronização na nuvem para mudá-lo. Seus outros computadores o mostram nas cópias de conflito e nas notas “Removido do Dropbox”.

### Desconectar

Abra **Avançado**, selecione **Desconectar** e confirme. A sincronização para neste computador, e o acesso do Oleafly ao seu Dropbox é removido. Seus projetos continuam neste computador e no seu Dropbox. Se o Oleafly não conseguir alcançar o Dropbox nesse momento, ele se desconecta aqui mesmo assim e avisa você, e você mesmo pode remover o Oleafly dos aplicativos conectados do Dropbox.

### Mude para outra conta do Dropbox

Conectar uma conta diferente do Dropbox começa do zero. Nada é comparado com a conta antiga, e nada é excluído por causa disso.

### Quando o acesso termina

Se o acesso do Oleafly termina, por exemplo porque você removeu o Oleafly dos aplicativos conectados do Dropbox, o cartão diz “O acesso ao Dropbox terminou. Conecte novamente para continuar sincronizando.” Selecione **Conectar novamente**.

### Um Oleafly mais novo em outro computador

Se outro computador usa uma versão mais nova do Oleafly que salvou um projeto em um formato mais novo, as versões mais antigas deixam de sincronizar esse projeto e pedem que você [atualize o Oleafly](/docs/updates/).

## Verificações de segurança

- Todo arquivo vindo do Dropbox é conferido com a impressão digital registrada antes de substituir qualquer coisa.
- Nada do Dropbox é gravado em `.git`, fora da pasta do projeto ou por meio de um link simbólico.
- Um `project.json` do Dropbox que esta versão do Oleafly não consegue abrir nunca substitui o que está neste computador.
- Um projeto em que você confiou para executar comandos de shell durante a compilação pergunta de novo antes da próxima compilação depois que chegam arquivos do Dropbox, como acontece após um pull do Git.
- O Oleafly trata tudo o que está em `Apps/Oleafly` como não confiável e confere.
- O Oleafly não acrescenta criptografia de ponta a ponta aos seus arquivos no Dropbox. Eles ficam armazenados no seu Dropbox como quaisquer outros arquivos.

## Solução de problemas

| Mensagem ou sintoma | O que fazer |
| --- | --- |
| O navegador não devolve o controle ao Oleafly | Selecione **Problemas para entrar? Cole um código** e cole o código que o Dropbox mostra. |
| “O acesso ao Dropbox terminou. Conecte novamente para continuar sincronizando.” | Selecione **Conectar novamente** e aprove o Oleafly no navegador. |
| “Quais configurações o Oleafly deve usar?” | Escolha **Usar as configurações do Dropbox** ou **Manter as configurações deste computador**. Feche a caixa de diálogo para decidir depois no cartão Sincronização na nuvem. Nada é sobrescrito. |
| “Em pausa para proteger seus arquivos” | Muitos arquivos foram excluídos de uma vez, aqui ou no Dropbox. Escolha **Restaurar os arquivos** ou **Colocar de volta no Dropbox** para mantê-los, ou **Excluir também do Dropbox** ou **Excluir aqui também** se eles devem sumir. |
| Aparece um arquivo como `ch1 (Laptop 2026-10-14).tex` | É uma cópia de conflito do computador que dá nome a ela. Compare os dois arquivos, fique com o que quiser e exclua o outro. |
| A linha de um projeto diz que arquivos foram ignorados | Abra a lista para ver cada arquivo e o motivo. Renomeie os arquivos cujos nomes não funcionam em todos os computadores ou entram em conflito com outro nome. |
| Um ponto âmbar no botão Configurações | A sincronização na nuvem precisa da sua atenção. Abra as Configurações e leia o cartão Sincronização na nuvem. |
| “O Oleafly não consegue ler a cópia no seu Dropbox, então este projeto não está sendo sincronizado.” | Selecione **Substituir pela cópia deste computador**. Tudo o que existe só na cópia do Dropbox é perdido, então confira antes os seus outros computadores. |
| “O Oleafly não consegue ler as configurações no seu Dropbox.” | Selecione **Usar as configurações deste computador** para substituí-las. |
| “Este computador está ficando sem espaço em disco.” | Libere espaço em disco. A sincronização continua sozinha. |
| “Este projeto tem mais de 100.000 arquivos. São arquivos demais para sincronizar.” | Tire da pasta do projeto os arquivos de que ele não precisa. |
| “Removido do Dropbox no computador” e o nome de um computador | Esse computador removeu o projeto do Dropbox. Sua cópia aqui está segura. Ligue a chave do projeto para enviá-lo de novo. |
| “Seu Dropbox está cheio.” | Desative a sincronização de projetos grandes, remova projetos do Dropbox ou libere espaço no Dropbox. Os downloads continuam funcionando, e a sincronização continua quando houver espaço. |
| “Seu Dropbox atingiu o limite de envio deste mês.” | O Dropbox limita quanto algumas contas enviam por mês. Suas alterações ficam neste computador e são enviadas quando o Dropbox voltar a permitir. |
| “Não foi possível alcançar o Dropbox. O Oleafly vai tentar de novo.” | Verifique sua conexão. Suas edições ficam neste computador, e o Oleafly sincroniza quando você voltar a ficar online. |
| “Este projeto foi sincronizado por uma versão mais recente do Oleafly. Atualize o Oleafly para continuar sincronizando este projeto.” | [Atualize o Oleafly](/docs/updates/) neste computador. |
| Um projeto baixado abre em modo restrito | Confie nele neste computador quando souber o que há nele. |
| Nada é sincronizado | Confira se **Sincronizar neste computador** está ativado e se a chave do projeto está ligada. O Oleafly só sincroniza enquanto está aberto. Se **Sincronizar automaticamente** estiver desligado, selecione **Sincronizar agora**. |

Prefere mover projetos com o Git? Veja [Sincronização com o GitHub](/docs/github-sync/). Para tudo o que o Oleafly guarda no seu computador, veja [Seus arquivos e dados](/docs/where-your-data-lives/).
