Com o Replit, você nunca precisa se preocupar em perder seu trabalho. O sistema de checkpoints e rollbacks do Replit oferece controle de versão abrangente e gerenciamento de estado para todo o seu ambiente de desenvolvimento. Quando você usa o Replit Agent, os checkpoints capturam automaticamente o estado completo do seu projeto. Isso inclui não apenas as alterações de código, mas também os arquivos do projeto, o contexto da conversa com IA e os bancos de dados conectados.Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
O que são checkpoints?
Um checkpoint é um snapshot completo do estado do seu Replit App criado automaticamente pelo Agent em marcos-chave do desenvolvimento. Ao contrário do controle de versão tradicional que apenas rastreia alterações de código, os checkpoints do Replit capturam todo o seu contexto de desenvolvimento. Pense nos checkpoints como pontos de salvamento em um videogame — você sempre pode voltar a uma versão funcional do seu aplicativo.
Captura completa de estado
Cada checkpoint preserva:- Arquivos do projeto: Todos os arquivos, diretórios, pacotes instalados e configuração do projeto
- Contexto da conversa com IA: O histórico completo da conversa e o contexto que levou ao estado atual
- Configuração do ambiente: Configurações de runtime e configurações de publicação
- Memória do Agent: A compreensão da IA sobre a arquitetura do projeto, preferências e padrões
- Conteúdo do banco de dados: Os dados e o esquema do banco de dados no momento da criação do checkpoint
Como funcionam os rollbacks
A funcionalidade de rollback permite restaurar seu Replit App a qualquer estado de checkpoint anterior com um único clique. Isso é muito mais poderoso do que as operações tradicionais de reversão no Git.
- Pré-visualização não destrutiva: Algumas interfaces permitem pré-visualizar estados de checkpoint antes de realizar o rollback
- Limites claros: Cada checkpoint representa um marco lógico de desenvolvimento
- Continuidade da conversa: O contexto da IA é preservado, para que você possa continuar construindo a partir do estado restaurado
- Efeito imediato: Os rollbacks são aplicados instantaneamente em todo o ambiente de desenvolvimento
Realizando rollbacks
Quando você reverte para um checkpoint anterior, seu projeto retorna àquele estado anterior, incluindo:- Estado completo do projeto: Todos os arquivos do projeto retornam ao estado exato no checkpoint selecionado
- Contexto da conversa com IA: As conversas do Agent são restauradas ao ponto do checkpoint, mantendo a continuidade do contexto
- Configuração do projeto: Dependências, pacotes e configurações de runtime
- Ambiente de desenvolvimento: Configurações de ferramentas e configurações do Editor de Projetos
- Conteúdo do banco de dados (opcional): Quando selecionado, seu banco de dados será restaurado ao estado que tinha no momento do checkpoint
Por padrão, os rollbacks não alteram seu banco de dados. Para incluir seu banco de dados de desenvolvimento em um rollback, selecione “Banco de dados” em “Opções adicionais de rollback.”Observe que a restauração do seu banco de dados de produção não é realizada automaticamente por este recurso de rollback.
Para saber como restaurar seu banco de dados de produção a um momento anterior, consulte a documentação sobre como realizar uma restauração point-in-time.
Avançando no histórico
Os checkpoints no Replit funcionam bidirecionalmente — você pode avançar e retroceder no histórico do seu projeto. Isso oferece total flexibilidade para navegar pela sua linha do tempo de desenvolvimento sem medo de perder trabalho. Se você voltou longe demais ou quer recuperar alterações de um checkpoint posterior, pode avançar para se mover adiante no histórico de checkpoints. Isso permite navegar livremente pela linha do tempo do projeto sem perder trabalho. Para avançar, acesse a visualização de histórico na aba do Agent clicando no ícone de histórico
, e selecione um checkpoint que ocorra após sua posição atual.
Avançar só é possível se você tiver checkpoints à frente da sua posição atual na linha do tempo. Depois de fazer novas alterações após um rollback, esses checkpoints futuros se tornam parte de um ramo alternativo do histórico.
Criação de checkpoints
Os checkpoints são criados automaticamente pelas ferramentas de IA do Replit em momentos estratégicos durante o desenvolvimento.Checkpoints do Agent
O Replit Agent cria checkpoints quando:- Conclusão de funcionalidades: Após implementar com sucesso uma funcionalidade ou funcionalidade solicitada
- Marcos importantes: Quando um progresso significativo é feito em tarefas complexas
- Estados estáveis: Após testes e validação das alterações implementadas
- Recuperação de erros: Antes de tentar correções para problemas críticos
Características dos checkpoints
Cada checkpoint inclui:- Descrições geradas por IA: Resumos claros e descritivos do que foi realizado
- Informações de timestamp: Tempo preciso de criação para fácil identificação
- Escopo de alterações: Indicação de arquivos, funcionalidades ou sistemas modificados
- Informações de faturamento: Para o Agent, rastreamento transparente de custo por checkpoint
Usando checkpoints e rollbacks
Encontrando checkpoints
Os checkpoints aparecem em vários locais no Editor de Projetos: Aba do Agent: Veja todos os checkpoints criados pelo Agent com descrições e opções de rollback Painel Git: Veja os checkpoints como commits Git com integração completa de controle de versão Visualização de histórico: No chat do Agent, clique no ícone de histórico para acessar uma linha do tempo completa de todos os checkpoints e sua progressão
Realizando rollbacks
O processo de rollback varia ligeiramente dependendo de onde você o inicia:Da aba do Agent
Navegar para o Agent
Abra a aba Agent no Editor de Projetos para ver todos os checkpoints criados pelo Agent.
Confirmar rollback
Revise o aviso de rollback e confirme para restaurar seu aplicativo ao estado selecionado.
Melhores práticas
Use os checkpoints estrategicamente:- Teste seu aplicativo após cada checkpoint importante para garantir a estabilidade
- Crie commits Git manuais para rastreamento de versões de longo prazo junto com checkpoints automáticos
- Revise as descrições dos checkpoints para entender o que mudou
- Sempre verifique o escopo das alterações antes de realizar um rollback
- Considere o impacto no banco de dados e nas integrações externas
- Comunique os rollbacks aos colaboradores para manter a consciência da equipe
- Construa incrementalmente para aproveitar checkpoints frequentes
- Use rollbacks para explorar diferentes abordagens de implementação com segurança
- Aproveite a preservação do contexto de IA para continuar conversas após rollbacks
Integração com controle de versão
Os checkpoints funcionam perfeitamente com o ecossistema mais amplo de controle de versão do Replit:Integração com Git
- Geração de commits Git: Cada checkpoint cria um commit Git correspondente
- Compatibilidade com branches: Os checkpoints respeitam a estrutura de branches e os fluxos de trabalho de merge
- Sincronização remota: A integração com o GitHub mantém a sincronização dos checkpoints
- Acesso por linha de comando: A funcionalidade completa do Git permanece disponível junto com os checkpoints
Recursos de colaboração
- Visibilidade da equipe: Os checkpoints são visíveis para todos os colaboradores do projeto
- Prevenção de conflitos de merge: O tempo dos checkpoints reduz a probabilidade de conflitos
- Contexto compartilhado: O contexto da conversa com IA ajuda os membros da equipe a entender as alterações
- Atualizações em tempo real: Os colaboradores veem a criação de checkpoints em tempo real
Recursos avançados
Pré-visualizações de checkpoint
Algumas interfaces suportam funcionalidade de pré-visualização de checkpoint:- Comparação visual: Veja a aparência do seu aplicativo em diferentes estados de checkpoint
- Exploração não destrutiva: Pré-visualize sem realmente realizar o rollback
- Rastreamento de progresso: Entenda como seu aplicativo evoluiu ao longo do tempo
- Comparação de iterações: Compare diferentes abordagens de implementação
Rollbacks entre sessões
Para construtores avançados e administradores de equipe:- Histórico estendido: Acesse checkpoints em várias sessões de desenvolvimento
- Controle administrativo: Os administradores da equipe podem realizar rollbacks entre sessões de usuários
- Trilhas de auditoria: Histórico completo de criação de checkpoints e ações de rollback
Casos de uso
Desenvolvimento experimental
Os checkpoints permitem experimentação sem medo:- Tente novos recursos sabendo que pode reverter facilmente
- Teste diferentes abordagens arquiteturais
- Explore designs de UI alternativos ou fluxos de usuário
- Implemente integrações complexas com redes de segurança
Depuração e recuperação
Quando surgem problemas, os checkpoints fornecem recuperação confiável:- Reverta para estados funcionais quando bugs são introduzidos
- Isole problemas comparando estados de checkpoint
- Restaure a integridade do banco de dados após corrupção de dados
- Recupere-se de exclusões ou modificações acidentais
Aprendizado e iteração
Os checkpoints apoiam o desenvolvimento educacional:- Compare diferentes estratégias de implementação
- Aprenda com o processo de tomada de decisão da IA através da progressão de checkpoints
- Construa compreensão explorando como as funcionalidades evoluíram
- Pratique novas técnicas com a segurança do rollback
Próximos passos
Para saber mais sobre recursos relacionados do Replit, explore:- Replit Agent: Saiba mais sobre desenvolvimento de aplicativos com IA e criação de checkpoints
- Modos do Agent: Descubra Lite, Economy, Power e Turbo para builds direcionadas ou maiores
- Controle de Versão: Entenda a integração com Git e opções mais amplas de controle de versão
- Histórico de Arquivos: Explore o rastreamento granular de alterações no nível de arquivo
- Prompting Eficaz: Domine técnicas para desenvolvimento orientado por checkpoints