A sua pasta, levada para o seu cofre.

Uma pasta conectada é o original. Seu cofre guarda uma cópia dela. A sincronização leva uma até a outra sempre que você aperta o botão, movendo só o que mudou desde a última vez — então uma pasta de alguns milhares de ficheiros com três edições novas sincroniza num instante.

Três coisas continuam verdadeiras, use como usar. O 1Presence lê os seus ficheiros — ele nunca reescreve, renomeia nem elimina nada que você guarda no seu computador. Nada roda em segundo plano — uma sincronização acontece quando você aperta Sincronizar, e em nenhum outro momento. E nada volta para baixo — um documento que você edita no 1Presence fica no seu cofre; a sua cópia local é deixada exatamente como estava.

A única coisa que o 1Presence chega a escrever no seu disco é uma marca pequena, própria dele, para a pasta conseguir se reconhecer depois. É isso que são os vínculos, e você pode desligá-los.

Daí em diante, sincronizar é um aperto em Sincronizar na linha da pasta. O destino e o nível de memória ficam guardados; você pode mudar qualquer um dos dois pela mesma caixa de diálogo.

O seu navegador conta muito pouco ao 1Presence sobre uma pasta que você conecta — só o nome dela, de propósito, para um site não conseguir aprender o formato do seu disco. Deixado assim, uma pasta reconectada depois de um reset do navegador, renomeada ou aberta num segundo computador parece uma pasta novinha: todo ficheiro é copiado de novo e, sem registo do que já foi mandado, uma mudança posterior de qualquer um dos lados não pode ser percebida.

Um vínculo é um ficheiro pequeno que o 1Presence escreve dentro da sua pasta local, para que, se você mover a pasta para outra máquina, ele ainda consiga dizer o que foi sincronizado e quando. A pasta é reconhecida de novo em outro computador, em outro navegador, ou depois de você reconectá-la, e nada é copiado duas vezes. Com os vínculos ligados, cada sincronização escreve uma pasta oculta no topo da sua pasta local, chamada .1presence, guardando um ficheiro chamado sync.json — para onde esta pasta sincroniza, e uma impressão digital de cada ficheiro como ele foi mandado pela última vez.

O que a marca guarda, e o que ela nunca faz

• Nenhum segredo. Nenhum login, nenhum endereço de e-mail, nenhum conteúdo do cofre — só o destino, um id aleatório e as impressões digitais por ficheiro. Dá para versionar, fazer backup ou entregar a outra pessoa junto com a pasta.
• Ela fica fora do controle de versão. A pasta oculta carrega o próprio ficheiro de ignorar, então uma pasta que também é um repositório de código nunca mostra a marca como uma mudança.
• Ela é a única coisa escrita. Exatamente uma parte do 1Presence tem permissão de escrever no seu disco, e ela só consegue escrever dentro daquela pasta oculta — um limite que é imposto, e não prometido.

Por que o aviso do navegador diz “Editar ficheiros”

Os navegadores não têm uma permissão que signifique “escrever um ficheiro oculto”. A menor permissão que escreve qualquer coisa é a que deixa um site editar ficheiros na pasta, então é essa que o aviso mostra. O 1Presence pede mais do que usa e se prende à promessa mais estreita: a única coisa que ele chega a escrever no seu disco é a marca dele.

A ligar ou desligando os vínculos

Os vínculos vêm ligados por padrão. Se você recusar o aviso, a pasta conecta sem eles e tudo continua funcionando — neste computador, neste navegador, até você limpar os dados do site ou reconectar a pasta. O que você abre mão é do reconhecimento em qualquer outro lugar: outro computador trata a pasta como nova, copia tudo de novo e pergunta sobre quaisquer ficheiros que já estejam no destino.

Uma pasta sem vínculos mostra vínculos desligados na linha dela, com um link de ative ao lado. Ligar pede a permissão uma vez, e a escolha fica guardada — ela nunca é pedida de novo sem provocação. Pastas conectadas antes de os vínculos existirem mostram o mesmo link.

Mais uma coisa que a marca torna possível: se você conectar uma cópia de uma pasta que já sincroniza — um clone, ou um backup que você restaurou —, o 1Presence reconhece a marca partilhada e pergunta se é para sincronizar como uma pasta separada ou usar esta cópia no lugar, em vez de deixar duas pastas tocarem um destino.

Cada sincronização copia só o que mudou. Um ficheiro que está novo ou diferente no seu computador sobe. Um inalterado é pulado sem nem ser lido. Um ficheiro que você eliminou localmente fica no seu cofre — a sincronização acrescenta e atualiza; ela nunca elimina.

Sincronizar para uma pasta que já tem ficheiros

Você pode apontar uma pasta para qualquer pasta do cofre, inclusive uma que você já usa. Ficheiros que já estão lá e que a sua pasta não tem nunca são tocados. A sua pasta se mescla ao lado deles, e uma subpasta com nome igual se mescla em vez de duplicar.

Mesmo nome, mesmo lugar, e sem registo de ter mandado — esse é o único caso que precisa do seu aval. O 1Presence não consegue dizer se um documento desses é uma cópia que ele fez antes ou trabalho que você ou um agente fizeram no cofre, então ele para antes de escrever qualquer coisa e pergunta. A caixa de diálogo lista os ficheiros e diz quais foram escritos por último no 1Presence, e depois oferece três escolhas:

• Manter o que está no meu cofre — a escolha segura, e a padrão. Os outros ficheiros são copiados; estes ficam exatamente como estão.
• Usar as minhas cópias locais — substitui por eles os ficheiros do seu computador. As versões anteriores ficam no histórico de cada ficheiro por um tempo.
• Escolher outra pasta — de volta ao seletor de destino, sem nada escrito.

Seja qual for a escolha, as duas cópias ficam guardadas daí em diante. A pergunta é feita uma vez por pasta, e não a cada sincronização — e uma mudança posterior de qualquer um dos lados é percebida direito.

Mudou nos dois lugares

Depois que o 1Presence tem um registo de um ficheiro, ele consegue ver quando a cópia do cofre mudou desde a última vez em que ele a escreveu. Se a sua cópia local mudou também, o ficheiro é deixado em paz e listado no resumo como alterado no seu cofre desde a última sincronização, com um botão Usar as minhas cópias locais se você quiser que a sua versão ganhe. O ficheiro do seu computador fica intocado nos dois casos. Se só a cópia do cofre mudou, não acontece nada — a sua edição no 1Presence prevalece.

O documento diz de onde veio

Abra um documento sincronizado no seu cofre e uma linha no alto nomeia a pasta de onde ele veio e quando. Se ele tiver sido editado no 1Presence desde então — por você ou por um agente —, ela diz isso também, e o que a próxima sincronização vai fazer: substituir esta versão, com a atual guardada no histórico do ficheiro. Nada está quebrado quando você vê essa linha; a cópia do cofre estar à frente é um resultado normal de uma sincronização de sentido único.

Não há horário e não há processo em segundo plano. Uma sincronização roda quando você aperta Sincronizar, na janela de navegador em que você apertou, e para se você fechar aquela janela. Entre sincronizações, nada é vigiado e nada se move.

Como a conexão vive no seu navegador, a sincronização acontece a partir do computador em que a pasta está. A linha da pasta em Conectar pastas mostra quando ela sincronizou pela última vez e para onde. No seu telefone, os ficheiros sincronizados simplesmente estão ali no seu cofre — legíveis, buscáveis e editáveis como qualquer outra coisa.

Os navegadores reconferem o acesso às pastas de tempos em tempos, então, depois de um intervalo longo, você pode ser convidado a reconectar a pasta antes de sincronizar. Com os vínculos ligados, isso não custa nada: a pasta é reconhecida e a sincronização retoma de onde parou.

O nível de memória que você escolhe na caixa de diálogo de sincronização é definido na pasta de destino, dentro do seu cofre, e não na pasta do seu computador. É o mesmo botão que toda pasta do cofre tem: abra a pasta de destino no seu cofre depois e você pode mudar por lá, e o que quer que a próxima sincronização traga segue o ajuste da pasta.

• Lembrar todos os ficheiros — os factos dentro de cada ficheiro são destilados em memória e voltam sozinhos. Melhor para uma pasta pequena e focada.
• Lembrar a essência — os seus agentes seguram a pasta como um todo e te apontam para dentro dela quando importa. A escolha confortável para uma pasta grande.
• Manter como ficheiros buscáveis — nada é levantado sem provocação, mas o conteúdo completo é achado no momento em que você pedir.
• Só guardar — mantidos em segurança, fora da memória e da busca. Abertos só quando você nomear um.

A sugestão vem do que o 1Presence achou na pasta: um punhado de documentos sugere lembrar todos os ficheiros; centenas sugerem a essência; uma pasta de fotos e vídeo sugere só guardar, já que não há texto para destilar. Qualquer subpasta à qual você já tenha dado um nível próprio o mantém — a sua escolha é aplicada em volta dela, e o resumo diz quais.

O trecho Como ela volta do guia de memória explica o botão por inteiro.

Para decidir o que mudou, o 1Presence primeiro compara a data de modificação e o tamanho de cada ficheiro com o que ele registou da última vez. Os dois estão disponíveis sem abrir o ficheiro, e é isso que deixa uma pasta grande sincronizar em segundos. Só quando eles diferem é que ele lê o ficheiro e compara o conteúdo — então um ficheiro cuja data se mexeu mas cujo conteúdo não, como um restaurado de um backup, é reconhecido como inalterado e não é mandado de novo.

Esse atalho confia numa coisa: que um ficheiro com a mesma data de modificação e o mesmo tamanho tem o mesmo conteúdo. A sincronização estrita não confia nisso. Ela lê todo ficheiro e compara por conteúdo, o que leva mais tempo em proporção ao tamanho da pasta. Ligue quando um ficheiro puder ter mudado sem a data de modificação se mexer — algumas ferramentas preservam as datas quando escrevem — ou quando você simplesmente quiser a certeza de que o cofre bate. A caixa de marcar está na caixa de diálogo de sincronização, e o ajuste fica guardado para aquela pasta.

Remova uma pasta pela página dela no seu cofre. Desconectar vale só para este computador e é reversível reconectando — a marca fica no disco, então a pasta continua reconhecida se você mudar de ideia. Você também pode limpar o que as sincronizações dela colocaram no cofre: as cópias que batem com o que a sincronização escreveu vêm pré-selecionadas; qualquer coisa editada no 1Presence desde então é mantida a menos que você marque; ficheiros naquela pasta que a sincronização nunca escreveu nunca são tocados. Os ficheiros removidos vão para a lixeira.

• Navegador. Chrome, Edge e outros navegadores baseados em Chromium, num computador. Safari e Firefox ainda não oferecem o acesso a pastas por baixo, e os navegadores de telefone não o expõem.
• Tamanho de ficheiro. Ficheiros acima de 10 MB são pulados em vez de copiados pela metade. Uma sincronização dá conta de até 5.000 ficheiros por execução; sincronize de novo para continuar a partir dali.
• O que é pulado. Ficheiros e pastas ocultos, e as pastas de ferramentas que um projeto arrasta consigo — saída de compilação, caches de dependências, tripas de controle de versão — ficam de fora.
• Um computador sincroniza. A conexão vive no navegador de onde você a conectou, então é ali que o Sincronizar roda. Tudo o que ele traz está no seu cofre em todo lugar.