# Versão na nuvem e cache local

> Qual cópia é a principal, a ordem de salvamento e envio, como as imagens sobem e o que resta quando você está desconectado.

Source: https://loomworld.ai/pt-br/docs/sync-model

## Qual cópia é a principal

Os projetos em contas gratuitas normais permanecem no seu dispositivo; entrar na conta não faz o envio deles. Todos os três planos de assinatura ativos permitem projetos ilimitados na nuvem. Com uma assinatura ativa ou acesso legado Global registrado, o projeto atual inicia a sincronização automaticamente quando você o cria, importa ou abre, incluindo o manuscrito completo, imagens e registros do projeto. Uma cópia local permanece no seu dispositivo. Outros projetos não abertos não são verificados nem enviados. O aplicativo web utiliza o IndexedDB no navegador atual; o aplicativo desktop utiliza uma pasta local do projeto e um banco de dados SQLite. O número ilimitado de projetos não significa capacidade de armazenamento ilimitada: os limites individuais de arquivo e tamanho de envio continuam vigentes.

Ao abrir um projeto vinculado, esta sequência de verificações é executada:

- Compara primeiro com o resumo na lista de projetos: se a nuvem não mudou e não há alterações pendentes no dispositivo, não há download completo—comece a escrever imediatamente.
- Se a nuvem tiver uma versão mais recente e sua cópia local estiver sem pendências, ela é baixada e substitui o cache local; o aplicativo desktop então atualiza o arquivo de design e a memória derivada.
- Se houver edições locais pendentes de envio (incluindo o intervalo de 350 ms de amortecimento de salvamento) e a nuvem também tiver avançado, ocorre um conflito, e ambas as cópias são preservadas.

A sincronização automática e a checagem de versão antes do uso de IA no projeto aplicam-se ao aplicativo web atual. O aplicativo desktop exige um cliente compatível com esses recursos; versões mais antigas podem se comportar de forma diferente.

## A ordem de salvamento e envio

Toda edição é salva primeiro no dispositivo, sem depender da conexão de rede. Com acesso válido à nuvem, as alterações salvas são agrupadas e enviadas em segundo plano; as teclas digitadas no dia a dia não são enviadas a cada pressionamento. Falhas de rede nunca desfazem um salvamento local. Quando a conexão volta, o rascunho mais recente é reenviado enquanto o acesso for válido. A expiração ou falha na checagem de acesso pausa os envios, mas a escrita no dispositivo continua normalmente.

- Os avisos de salvamento diferenciam Salvo localmente de Sincronizado na nuvem. Um salvamento local bem-sucedido não significa que o envio terminou. Salvamentos automáticos rotineiros e sincronizações em segundo plano não exibem avisos repetidos; falhas e retomadas de status são informadas separadamente.
- Um projeto vinculado aberto faz uma reconciliação ao retomar o foco da janela e por um sinal de pulso de resumo a cada 60 segundos; abas em segundo plano não executam temporizadores, e sair do projeto ou fechá-lo interrompe a checagem. Os pulsos nunca alteram seu manuscrito enquanto você estiver digitando.
- Cada rodada de conversa no projeto, habilidade pontual, reescrita, tarefa de imagem, análise de importação e manutenção verifica o acesso à nuvem e confirma se o conteúdo local mais recente já foi sincronizado. Trabalhar offline, conflitos pendentes ou falhas de sincronização bloqueiam essa tarefa de IA. Pacotes de créditos não concedem acesso à nuvem. O fluxo inicial antes da existência de um projeto e as estimativas de custo são tratados separadamente.

## Como as imagens são enviadas

No envio, imagens longas em formato data-URL presentes no manuscrito e nos registros são desmembradas em blocos indexados pelo conteúdo: imagens idênticas dentro do mesmo projeto compartilham um único arquivo armazenado, e o arquivo JSON do projeto guarda apenas uma referência leve. A abertura e a reconciliação restauram as imagens a partir dessas referências antes de entregar o rascunho ao cache local. O primeiro envio segue o mesmo caminho—se as imagens não terminarem de subir, o projeto recém-criado na nuvem é movido para a lixeira e nenhum vínculo local é estabelecido, impedindo que projetos incompletos fiquem no sistema.

- Uma referência cuja imagem não possa ser baixada permanece inalterada no manuscrito, marcada com um erro de sincronização; ela nunca é excluída silenciosamente.
- Uma única imagem que ultrapasse 20 MB em dados brutos, ou um manuscrito que continue acima de 32 MB após a extração das imagens, é sinalizado com erro e o envio desse conteúdo não é repetido em loop. Nesses casos, divida ou compacte as imagens.

## Desconectado ou offline

Projetos desconectados ou em contas gratuitas normais não são enviados automaticamente. Projetos no navegador dependem do armazenamento do navegador atual; limpar os dados de navegação apaga projetos exclusivos daquele dispositivo e alterações não enviadas. Exporte um pacote de projeto antes de trocar de navegador ou dispositivo. O aplicativo desktop utiliza uma pasta local que você pode copiar para fazer backup.

A escrita offline salva localmente e realiza o envio ao reconectar, desde que o acesso à nuvem continue válido. A expiração da assinatura não apaga seu trabalho: a edição local, o salvamento e a exportação continuam funcionando, e os projetos existentes na nuvem permanecem acessíveis para leitura, exportação ou exclusão. A renovação verifica as versões em ambos os lados antes de retomar a sincronização. Se o projeto na nuvem for excluído, o vínculo local é desfeito e a obra permanece no seu dispositivo.

## Limites e solução de problemas

- A sincronização reconcilia versões completas de conteúdo, sem realizar mesclagens automáticas em três vias campo a campo—por isso um conflito preserva ambos os lados em vez de misturar os textos.
- Ao encontrar um erro de sincronização, mantenha a página e o projeto local abertos; nunca limpe os dados do site. Uma falha recorrente permanece visível como “Falha na sincronização” acompanhada do motivo.
- Antes de trocar de dispositivo, confirme se o projeto atual foi sincronizado e abra sua versão na nuvem com a mesma conta. Exporte previamente um pacote .quill.json para projetos locais ou alterações que ainda não foram enviadas; não tente migrar copiando o armazenamento do navegador.

Recuperação após um conflito: [Cópias em conflito](https://loomworld.ai/pt-br/docs/conflict-copies); backup e migração: [Exportar e importar um pacote de projeto](https://loomworld.ai/pt-br/docs/export-quill).
