> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edição de arquivos

> Diffs de IA inline, aceitar e rejeitar por edição, snapshots e desfazer.

O editor de arquivos do Kazzle tem duas camadas: um editor de texto normal para suas alterações e uma sobreposição de diff para alterações de IA.

## Como as edições de IA aparecem

Quando a IA edita um arquivo, as alterações aparecem como linhas verdes (adicionadas) e vermelhas (removidas) no editor. Cada região alterada é uma edição na qual você pode agir.

Enquanto a IA está transmitindo, você vê a edição em tempo real com destaque de sintaxe. Após a conclusão, a visualização muda para um diff completo.

## Aceitar e rejeitar edições

Cada edição tem uma barra flutuante com botões **Manter** e **Desfazer**.

* **Manter** aceita a alteração. A decoração desaparece e o conteúdo permanece.
* **Desfazer** reverte a alteração. O texto da IA é substituído pelo original.

As edições são independentes. Você pode manter algumas alterações e desfazer outras no mesmo arquivo. Quando todas as edições em um arquivo são resolvidas, a edição do arquivo é resolvida automaticamente.

As regiões de diff pendentes são somente leitura até que você escolha Manter ou Desfazer. Isso evita edições dentro de uma região que a IA acabou de alterar, o que quebraria o Desfazer.

## Aceitar e rejeitar em lote

O painel **Edições de arquivo** da thread permite aceitar ou rejeitar todas as edições pendentes dessa thread de uma vez.

## Desfazer por mensagem

Cada resposta de IA tem um botão **Reverter**. Clicar nele restaura todos os arquivos para seu estado antes dessa resposta e exclui mensagens subsequentes.

Se outras threads tiverem alterações pendentes nos mesmos arquivos, você verá um aviso antes de prosseguir.

## Snapshots

Antes de cada turno de IA, o Kazzle salva o conteúdo anterior do arquivo no armazenamento em nuvem. Esses snapshots alimentam o desfazer por mensagem: clicar em Reverter lê o conteúdo antigo do snapshot e o escreve novamente.

Os snapshots são eficientes em armazenamento. Eles cobrem apenas os arquivos da máquina em nuvem, não alterações de banco de dados, aplicativos implantados ou chamadas de API externas.

## Sobreposição entre threads

Quando uma nova edição de IA se sobrepõe a edições pendentes existentes de outra thread, as edições sobrepostas são aceitas automaticamente. Isso evita edições obsoletas que não podem ser desfeitas de forma significativa, pois o texto já foi sobrescrito. As edições não sobrepostas de outras threads permanecem pendentes.

## Tratamento de conflitos

Múltiplas threads compartilham a mesma máquina em nuvem. Quando duas threads editam o mesmo arquivo:

1. A thread A edita uma região. O arquivo muda no disco.
2. A thread B tenta editar a mesma região. Sua edição falha porque o texto antigo não corresponde.
3. A thread B relê o arquivo e se adapta.

A IA lida com isso automaticamente. Você não precisa gerenciar conflitos manualmente.