Documentation

Cofre e Busca de Texto Completo

Tudo o que o XWX Backup salva vai para o cofre — arquivos Markdown simples no seu disco, sustentados por um índice de busca instantâneo. Esta página explica como o cofre é organizado e como encontrar qualquer coisa que você tenha arquivado.

Onde o cofre fica

Por padrão, o cofre fica no seu diretório de usuário (~/.xwx-backup/vault). Mude em Configurações → Cofre se preferir outra unidade ou uma pasta sincronizada.

  • Um arquivo Markdown por conversa, nomeado pelo título da conversa
  • Frontmatter YAML em cada arquivo: título, plataforma, modelo, timestamps de criação/atualização, tags, contagem de palavras e URL de origem
  • O layout dos arquivos é propositalmente simples: qualquer editor, script ou ferramenta PKM consegue ler

Use Reescanear depois de editar arquivos externamente — ele reconstrói o banco de dados de busca a partir dos arquivos no disco.

Página de visão geral do cofre listando conversas arquivadas
Página de visão geral do cofre listando conversas arquivadas

A barra de busca consulta o texto completo de cada mensagem do seu cofre — não só os títulos — com um índice FTS do SQLite que devolve resultados em milissegundos.

  • A busca encontra conteúdo de mensagens em todas as plataformas de uma vez
  • Os resultados mostram título, plataforma, data e trecho correspondente
  • Clique em um resultado para ler a conversa numa visualização limpa com código destacado
Resultados de busca com trechos em várias plataformas
Resultados de busca com trechos em várias plataformas
note: A busca nativa das plataformas cobre só títulos e, muitas vezes, apenas chats recentes — e não enxerga entre serviços de forma alguma. A busca local de texto completo é a razão de o cofre existir.

Filtros, tags e favoritos

Combine a busca com filtros para refinar o arquivo:

  • Plataforma — ChatGPT, Claude, Gemini, …
  • Conta — para plataformas multi-conta
  • Período — pela data de atualização da conversa
  • Tag — edite tags livremente em qualquer conversa
  • Favoritas — marque conversas importantes e filtre por elas

Tags e favoritos são gravados de volta no frontmatter do Markdown, então sobrevivem fora do aplicativo também.

Barra de filtros do cofre com filtros de plataforma, tag e favorito
Barra de filtros do cofre com filtros de plataforma, tag e favorito

Manutenção: reescanear, limpar, zip

  • Reescanear o cofre — relê todos os arquivos e reconstrói o índice de busca (execute após edições externas ou restaurações)
  • Empacotar como ZIP — reúne a seleção filtrada atual num arquivo ZIP para armazenamento externo ou compartilhamento
  • Limpar o arquivo — apaga o conteúdo do cofre e o índice. Destrutivo; o grafo de conhecimento e as configurações são mantidos

Frequently Asked Questions

+

+

+

Related Articles