Fluxos de trabalho do Git
Revise alterações, trabalhe com ramificações e use Worktrees do Git no Dream.
Abra o Git na barra lateral direita para as guias Alterações, Histórico e Pull request. O menu de Ações do Git abaixo da conversa oferece os próximos passos para a branch atual.
Antes de começar#
Para commits, seu repositório precisa ter uma identidade de autor Git configurada. Para push, é necessário um remoto e credenciais que possam acessá-lo. A criação de pull request utiliza o GitHub CLI, que deve estar instalado e autenticado para o repositório de destino.
Você pode digitar os mensagens de commit e o texto do PR por si. Para gerá-los, habilite um modelo de provedor e escolha Configurações → Geral → Modelos → Modelo de geração de texto.
Revise as alterações#
- Aberto Git → Alterações para inspecionar arquivos modificados, adicionados e excluídos.
- Expandir um arquivo para revisar sua diferença.
- Escolha Diff unificado ou Diff dividido no cabeçalho, e habilite o wrap de palavras na seção Alterações se necessário.
- Use Ações de Alterações → Atualizar se as alterações realizadas fora do Dream ainda não foram refletidas.
Para diffs muito grandes, o Dream pode exibir Diferença muito grande para renderizar. Use Renderizar mesmo assim apenas quando quiser carregar essa visualização maior ou inspecionar o arquivo no seu editor ou terminal.
Use a ação Reverter alterações no arquivo para descartar alterações de trabalho indesejadas. A ação Reverter todas as alterações se aplica de forma mais ampla; revise seu escopo antes de confirmar. Reverter código é distinto de arquivar a conversa que o gerou. Para desfazer apenas o que uma resposta específica alterou, use o ponto de verificação dessa resposta.
Para pedir a um agente sobre linhas específicas, arraste entre os números de linha em uma diff ou clique no controle + de uma linha, depois digite um comentário. O Dream envia com o caminho do arquivo e as linhas selecionadas. Veja Enviar feedback para um chat.
Commitar seu trabalho#
- Abra Git → Alterações, ou escolha Confirmar no menu Ações do Git do rodapé.
- Revise as diferenças de arquivo abaixo do commit composer.
- Verifique Incluir não preparado. Ela está habilitada por padrão e inclui mudanças não marcadas no commit.
- Revise Gerar mensagem automaticamente, que está ativada por padrão. Para escrever sua própria mensagem, desative-a e insira o texto; desativá-la apaga a mensagem gerada.
- Escolha Confirmar, ou Confirmar e enviar se você estiver pronto para publicar o commit no remoto.
Para commitar apenas um subconjunto selecionado, estagie esses arquivos usando Git em um terminal ou em um editor externo e desative Incluir não preparado. O Painel de alterações não fornece controles individuais de estagio.
O Dream rejeita commits quando há mudanças staged fora do diretório ativo do projeto. Faça o commit separadamente antes de continuar com esta ação.
Revise os arquivos incluídos bem como a mensagem. Com "Incluir não estagial" habilitado, um commit pode conter trabalho de várias conversas compartilhando este checkout.
Empurrar uma ramificação#
Use Publicar branch para uma branch sem upstream, ou Enviar para enviar commits pendentes. Essas ações no rodapé fazem o envio imediatamente. Confira primeiro a branch, o remoto e os commits em Histórico; quando há um upstream, o rodapé mostra quantos commits estão à frente e atrás.
Se o empurrar falhar, verifique o erro e confirme o acesso remoto. Um commit local bem-sucedido permanece comitado mesmo se um empurrar posterior falhe; verifique o estado da ramificação antes de repetir a ação combinada.
Criar um pull request#
- Trabalhe em uma ramificação de recurso cujo nome difere do nome da base da solicitação de alteração.
- Escolha Criar PR no rodapé, ou Ações do Git → Criar solicitação pull.
- Revise as branches de origem e base e as mudanças propostas.
- Insira um título e uma descrição, ou use Gerar automaticamente detalhes de PR e revise o texto gerado.
- Em Próximas etapas, selecione a ação que corresponde ao estado da ramificação.
- Ligue o Rascunho se o PR não estiver pronto para revisão, em seguida, submeta.
| Próximo passo | O que acontece |
|---|---|
| Criar PR | Cria uma solicitação de pull para trabalho já empurrado |
| Empurrar e criar solicitação de alteração | Envia commits antes de criar a solicitação de alteração |
| Commit, empurre e crie um pedido de alteração | Commita alterações em andamento, envia e cria a solicitação de alteração |
O diálogo inicia com Rascunho desativado. Ative-o para criar um PR em rascunho. A criação de um PR exige uma ramificação, e não um HEAD desacoplado; fonte e base não podem ser a mesma ramificação.
Se uma ação combinada falhar, etapas anteriores podem ter sido concluídas já. Verifique o commit, a ramificação remota ou a solicitação de alteração antes de tentar novamente.
Revise e融e um pedido de pull#
Abra Git → Pull request para ver a solicitação de pull da atual branch. Use Resumo para sua descrição, verificações e discussão, ou Código para inspecionar as diferenças e deixar comentários inline. Pode editar o título e a descrição quando permitido e use Mesclar para escolher um método de mesclagem. Veja Revisar solicitações de pull para o fluxo completo.
Alternar ou criar ramificações#
Abra o switcher de ramo abaixo do chat, procure ramos locais e selecione um para saí-lo. Use Criar e checkout de novo ramo… para nomear e criar um ramo. Atualize a lista se um ramo criado fora do Dream estiver faltando.
Mudar de ramo altera os arquivos usados por cada chat nesse projeto. Revise o trabalho não finalizado antes de fazer a mudança. Para tarefas paralelas com checkouts independentes, use Worktrees do Git. Quando um worktree for concluído, use seu rodapé para mesclar no ramo principal, criar um pull request ou remover o checkout. Veja Conclua um worktree.
Navegar pelo histórico de commits#
Abra Git → Histórico ou Ações do Git → Ver histórico para acompanhar commits e mesclagens no gráfico colorido. Use Pesquisar commits para filtrar os commits carregados por mensagem, autor, prefixo de hash ou referência. Carregar mais inclui commits anteriores; apague a busca para exibir novamente o gráfico.
Posicione o ponteiro do mouse sobre um commit ou foque nele com o teclado para usar Copiar hash do commit.