Cada alteração de um agente,mesmo no ficheiro.

Como verificar as correções de um agente num ficheiro Markdown

Quando um agente lê os seus comentários, o DotMD regista o ficheiro tal como está nesse momento. Tudo o que muda depois é mostrado no documento: o texto antigo riscado a vermelho, o novo a verde. Isso é a revisão. Não precisa de git para isso.

1. Abra a revisão

   Clique em Review na barra de ferramentas. Um aviso sobre a página diz de quem são as alterações e quantas há, por exemplo Review changes by Claude Code · 3 comments · 2 other changes.

2. Leia cada correção junto ao seu comentário

   Clique num comentário no painel e a página desloca-se até às suas alterações. A nota do agente sobre o que fez está no cartão.

3. Aceite-a ou reabra-a

   Accept mantém a alteração e move o comentário para Resolved. Reopen anula a alteração e devolve o comentário a Open, para que o agente o veja de novo. Edite primeiro o comentário se quiser dizer porquê.

4. Conclua

   Accept All mantém todas as alterações e termina a revisão. Decline All repõe o ficheiro como estava quando o agente leu os comentários. Done (⌘↩) fecha o painel e a revisão fica à espera: abra Review de novo para continuar, mesmo depois de sair do DotMD.

Alterações e comentários apontam um para o outro

Clique numa alteração na página e o seu comentário fica selecionado no painel. As alterações de um comentário incluem o local que indicou e todos os outros locais que o agente mudou por causa dele, como um plano de testes ou uma tabela-resumo que ajustou. Vê a correção inteira, não apenas uma linha.

Outras alterações

O aviso conta também as other changes: edições que nenhum comentário pediu. São coisas que o agente fez por conta própria, ou alterações ao ficheiro desde o início da revisão, incluindo as suas. Veja-as também. É aqui que se escondem as surpresas de um agente. Revert numa alteração anula apenas essa alteração.

Version History: comparar, reverter, restaurar

Prima ⌥⌘Y ou escolha File → Show Version History. As versões estão listadas por dia à direita, e a página mostra a selecionada com o que mudou em relação à anterior: o texto acrescentado a verde, o removido a vermelho.

• Restore repõe a versão selecionada. O texto atual é guardado antes como versão, por isso uma restauração pode ser anulada restaurando de novo.
• Reverter uma alteração. Na versão atual, clique em Revert no texto vermelho de um bloco e depois em Apply Reverts. O ficheiro é escrito apenas com essas alterações anuladas, e o resto fica.
• Cada anulação é guardada. Antes de Reopen, Revert ou Decline All alterarem o ficheiro, o seu texto é guardado como versão, por isso uma correção anulada pode ser recuperada.

Quando as versões são guardadas e durante quanto tempo se mantêm

O DotMD guarda uma versão sempre que alguém altera o ficheiro: você, um agente de IA, o git ou outra app, esteja o ficheiro aberto ou não. Guarda também uma quando abre um ficheiro, termina a edição ou sai, e de dois em dois minutos enquanto escreve. Um ficheiro criado por um agente mantém uma única versão até o abrir pela primeira vez, por isso nunca vê um histórico de rascunhos que não leu.

As versões antigas são aligeiradas como faz o Time Machine: tudo do último dia, depois uma por hora durante uma semana, uma por dia durante um mês e uma por semana a seguir, até 200 por ficheiro. Um ficheiro que outra app alterou recebe um ponto laranja na barra lateral. Abra-o e o DotMD vai direto ao que mudou.

Perguntas sobre a revisão de alterações

Mais perguntas