Checkpointing

O Qwen Code inclui um recurso de Checkpointing que salva automaticamente um snapshot do estado do seu projeto antes que qualquer modificação de arquivo seja feita por ferramentas com IA. Isso permite que você experimente e aplique alterações de código com segurança, sabendo que pode reverter instantaneamente para o estado anterior à execução da ferramenta.

Como Funciona

Quando você aprova uma ferramenta que modifica o sistema de arquivos (como write_file ou edit), o CLI cria automaticamente um “checkpoint”. Esse checkpoint inclui:

1. Um Snapshot Git: Um commit é feito em um repositório Git especial e oculto localizado no seu diretório home (~/.qwen/history/<project_hash>). Esse snapshot captura o estado completo dos arquivos do seu projeto naquele momento. Ele não interfere no repositório Git do seu próprio projeto.
2. Histórico da Conversa: A conversa inteira que você teve com o agente até aquele ponto é salva.
3. A Chamada da Ferramenta: A chamada específica da ferramenta que estava prestes a ser executada também é armazenada.

Se você quiser desfazer a alteração ou simplesmente voltar, pode usar o comando /restore. Restaurar um checkpoint irá:

• Reverter todos os arquivos do seu projeto para o estado capturado no snapshot.
• Restaurar o histórico da conversa no CLI.
• Repropor a chamada original da ferramenta, permitindo que você a execute novamente, a modifique ou simplesmente a ignore.

Todos os dados do checkpoint, incluindo o snapshot Git e o histórico da conversa, são armazenados localmente na sua máquina. O snapshot Git é armazenado no repositório oculto, enquanto o histórico da conversa e as chamadas das ferramentas são salvos em um arquivo JSON no diretório temporário do seu projeto, normalmente localizado em ~/.qwen/tmp/<project_hash>/checkpoints.

Habilitando o Recurso

O recurso de Checkpointing vem desabilitado por padrão. Para habilitá-lo, você pode usar uma flag na linha de comando ou editar seu arquivo settings.json.

Usando a Flag na Linha de Comando

Você pode habilitar o checkpointing para a sessão atual usando a flag --checkpointing ao iniciar o Qwen Code:

qwen --checkpointing

Usando o Arquivo settings.json

Para habilitar o checkpointing por padrão em todas as sessões, você precisa editar seu arquivo settings.json.

Adicione a seguinte chave ao seu settings.json:

{
  "general": {
    "checkpointing": {
      "enabled": true
    }
  }
}

Usando o Comando /restore

Uma vez habilitado, os checkpoints são criados automaticamente. Para gerenciá-los, utilize o comando /restore.

Listar Checkpoints Disponíveis

Para ver uma lista de todos os checkpoints salvos para o projeto atual, basta executar:

/restore

O CLI irá exibir uma lista dos arquivos de checkpoint disponíveis. Esses nomes de arquivo são normalmente compostos por um timestamp, o nome do arquivo que estava sendo modificado e o nome da ferramenta que estava prestes a ser executada (por exemplo, 2025-06-22T10-00-00_000Z-my-file.txt-write_file).

Restaurar um Checkpoint Específico

Para restaurar seu projeto a partir de um checkpoint específico, utilize o arquivo de checkpoint da lista:

/restore <checkpoint_file>

Por exemplo:

/restore 2025-06-22T10-00-00_000Z-my-file.txt-write_file

Após executar o comando, seus arquivos e a conversa serão imediatamente restaurados ao estado em que estavam quando o checkpoint foi criado, e o prompt original da ferramenta reaparecerá.