Introdução
Quando você trabalha em uma sessão interativa CLI do Copilot , Copilot pode fazer alterações em arquivos, executar comandos do shell e modificar seu repositório. Se o resultado não for o esperado, você poderá retroceder para um ponto anterior na sessão para desfazer essas alterações.
Você pode disparar um retrocesso pressionando Esc duas vezes ou usando o /undo comando de barra (ou seu alias /rewind).
CLI do Copilot dá suporte a dois comportamentos de retrocesso:
- Reversão baseada em Git: reverte para um instantâneo do espaço de trabalho capturado no início de uma solicitação.
- Retrocesso baseado em ferramentas: permite retroceder somente o histórico de conversas ou retroceder o histórico de conversas e restaurar arquivos que Copilot foram alterados.
Observação
O retrocesso baseado em ferramentas atualmente é um recurso experimental e só estará disponível se você tiver usado o /experimental on comando de barra ou a opção de --experimental linha de comando.
CLI do Copilot escolhe automaticamente um desses comportamentos de retroceder com base em seu ambiente para fornecer a melhor experiência de retrocesso possível.
Para saber qual dos comportamentos de retrocesso está ativo:
- Se o seletor mostrar imediatamente as capturas instantâneas e selecionar uma delas fizer a reversão, você estará usando a reversão baseada em Git.
- Se, ao selecionar um ponto de retrocesso, for aberto um menu de ação com Somente conversa e Conversa + arquivos, você está usando retrocesso com base em ferramentas.
Este artigo explica como reverter as alterações. Para obter informações mais conceituais sobre como retroceder para um ponto anterior em uma sessão, consulte Cancelando uma CLI do GitHub Copilot operação e revertendo alterações.
Pré-requisitos
- Um ponto de retrocesso deve existir. Você não pode reverter antes do primeiro prompt em uma sessão.
- Somente para retrocesso baseado em Git: você deve estar em um repositório Git com pelo menos um commit.
- Para retroceder com base em ferramentas: a restauração de arquivos pode ser ignorada para arquivos que foram alterados após Copilot a última vez que eles tocaram neles.
Reverter com um pressionamento duplo da tecla Esc
Aviso
- O retrocesso não pode ser desfeito. Depois de reverter, o histórico das sessões posteriores será removido permanentemente.
- Na reversão baseada em Git, reverter restaura todo o espaço de trabalho ao estado em que estava no snapshot selecionado. Isso reverte todas as alterações feitas após esse ponto , não apenas as alterações feitas por Copilot, mas também as edições manuais e alterações dos comandos do shell. Todos os novos arquivos criados no workspace depois que o instantâneo foi tirado são excluídos, independentemente do status do Git.
- Na reversão baseada em ferramentas, você pode escolher se deseja restaurar arquivos. Se você optar pela restauração de arquivos, os arquivos alterados depois de Copilot podem permanecer inalterados para evitar sobrescrever suas edições mais recentes.
Quando Copilot terminar de responder a um prompt inserido por você:
-
Verifique se a área de entrada está vazia. Se houver texto na área de entrada, pressionar Esc duas vezes em sucessão rápida limpará o texto.
-
Pressione Esc duas vezes em sequência rápida para abrir o seletor de retrocesso.
O seletor lista os pontos de reversão disponíveis para a sessão atual, com o mais recente primeiro. Os dez pontos mais recentes são exibidos ao mesmo tempo. Se houver mais de dez, use a tecla ↓ seta para rolar para baixo até os pontos anteriores. Para cada ponto de retorno, o início do prompt que você inseriu é exibido, com a indicação de há quanto tempo você o enviou.
-
Escolha um ponto de retrocesso.
- Na reversão baseada em Git, selecionar um instantâneo restaura o espaço de trabalho ao estado em que estava no início desse prompt.
- No retrocesso baseado em ferramentas, após escolher um ponto de retrocesso, você pode selecionar:
-
Somente conversa (recuperação de histórico, arquivos inalterados) ou
-
Conversa + arquivos (o histórico é revertido e os arquivos restauráveis alterados por Copilot são restaurados).
-
Observação
Na reversão baseada em Git, o repositório é revertido ao estado em que estava imediatamente antes de Copilot começar a trabalhar no prompt, não imediatamente depois que ele terminou de trabalhar no prompt.
O prompt selecionado é mostrado na área de entrada, para que você possa editá-lo e reenviá-lo, se necessário.
Reverter com o comando de barra /undo
O comando de barra /undo e seu alias /rewind fornecem uma maneira alternativa de abrir o seletor de retrocesso.
Ambos os comandos produzem o mesmo resultado obtido pressionando Esc duas vezes quando Copilot está ocioso e não há texto na área de entrada.
Verificando a reversão
Depois de reverter, você pode usar comandos Git para verificar o estado do seu repositório e confirmar se está de acordo com suas expectativas.
Digitar ! permite executar comandos de shell diretamente do CLI do Copilot prompt de entrada, portanto, você não precisa sair da CLI para verificar o estado do repositório.
| Para fazer isso | Insira este comando |
|---|---|
| Verifique quais arquivos são mostrados como modificados, preparados ou não rastreados. | ! git status |
| Mostrar o SHA e a mensagem do commit atual. | ! git log --oneline -1 |
| Revise as alterações não preparadas. | ! git diff |