Contextos de trabalho e worktrees
Está a meio de uma correção quando chega um pedido de revisão. Um contexto ajuda a voltar à mesma vista e ao rascunho. Uma worktree dá à outra tarefa os seus próprios ficheiros e área de staging. Escolha conforme o que precisa de manter separado.
Escolher como alternar tarefas
| Necessidade | Recurso |
|---|---|
| Voltar à seleção, aos filtros, à posição de deslocamento e ao rascunho de commit do separador durante a sessão | Fechar e retomar o contexto. |
| Trabalhar noutra revisão mantendo a cópia original intacta | Criar uma worktree noutra pasta. |
| Guardar edições temporariamente na mesma cópia | Guardar um stash com nome e restaurá-lo quando necessário. Consulte a rede de segurança. |
Fechar e retomar um contexto
Abra os contextos de trabalho para ver repositórios abertos, contextos fechados recentemente e worktrees encontradas. Confira o ramo, o pull request associado, as alterações pendentes e o rascunho de commit. Se a inspeção estiver indisponível ou incompleta, abra o repositório e confira o estado antes de agir.
Selecione um contexto aberto e escolha Fechar contexto. Leia a confirmação, sobretudo se houver uma operação Git em curso. Fechar preserva o repositório, o ramo e os ficheiros no disco. Não conclui nem cancela merge, rebase ou outra operação Git, e não cria nem aplica stash.
Escolha Retomar contexto para voltar ao estado disponível do separador. O Riff mantém até dez contextos fechados recentes na memória do workspace atual. Seleção, filtros, deslocamento e rascunhos são estado da sessão: reiniciar o Riff ou mudar de workspace não preserva esta cache. Isto é separado da ordem guardada dos separadores e da sincronização do workspace.
Criar uma worktree separada
- Selecione um repositório nos contextos de trabalho e escolha Nova worktree.
- Escolha uma pasta vazia ou nova fora dos metadados do Git. Selecione a revisão inicial e, quando necessário, um nome de ramo novo que respeite as regras da equipa.
- Confira as opções e crie a worktree. Sem um ramo novo, abre com HEAD destacado. Crie um ramo antes de fazer commits que pretende manter.
- Abra a pasta criada no Riff. Tem os seus próprios ficheiros e index, partilhando o histórico Git do repositório. O limite do plano ou do modo de convidado pode impedir a abertura de outro repositório acompanhado mesmo quando o Git criou a worktree; confira o resultado antes de repetir a criação.
Para um pull request, use Abrir em worktree na revisão para preparar o commit exato examinado. Alternar contextos não publica commits nem altera a cópia original.
Remover a worktree ao terminar
Faça commit ou guarde o trabalho necessário antes de escolher Remover na worktree adicional. O Riff recusa a remoção se encontrar alterações pendentes, ficheiros ignorados, operação em curso, worktree bloqueada ou a árvore de trabalho principal. Examine os resultados de build ignorados e outros ficheiros antes de decidir o que remover.
Se o HEAD estiver destacado, preserve primeiro o commit num ramo ou tag local. Remover não elimina automaticamente o ramo nem envia commits. Fechar um contexto apenas oculta o seu separador; remover uma worktree remove a pasta de trabalho. Tenha esta diferença em conta ao concluir a tarefa.