Use Editor para visualizar e gerenciar os arquivos-fonte no seu projeto Atoms. Você pode encontrar arquivos, visualizar formatos compatíveis, comparar alterações, adicionar código ao Chat como contexto e baixar arquivos individuais, pastas ou o projeto completo.

Este guia cobre apenas os arquivos armazenados no workspace do projeto. Arquivos enviados no Chat, mídia gerada, dados na nuvem, versões publicadas e arquivos de serviços conectados são gerenciados separadamente.

Antes de começar

• Use um navegador em um computador. A experiência do Editor é limitada em dispositivos móveis.
• Aguarde o Agente terminar antes de fazer alterações manuais nos mesmos arquivos.
• Abra a versão mais recente do projeto. Se você estiver visualizando uma versão anterior, selecione Restore nos controles de versão, confirme Restore e aguarde a restauração terminar antes de editar.
• Editar ou baixar um projeto pode exigir um plano pago elegível.

Nunca coloque senhas, chaves de API, tokens de acesso ou outros segredos diretamente nos arquivos-fonte ou no Chat.

Abrir o Editor

1. Abra um projeto existente.
2. Selecione Editor na barra de ferramentas do projeto.
3. Aguarde o carregamento da árvore de arquivos e do visualizador de arquivos.

A árvore de arquivos aparece à esquerda. O arquivo selecionado é aberto à direita em um editor de código ou visualização. As ferramentas mostradas para um arquivo dependem do formato dele e do estado atual do projeto.

Encontrar e visualizar arquivos

Pesquisar por nome de arquivo ou pasta

1. Selecione Search acima da árvore de arquivos.
2. Digite parte do nome de um arquivo ou pasta.
3. Selecione um resultado correspondente para abri-lo.

A pesquisa encontra correspondências em nomes de arquivos e pastas. Ela não pesquisa o texto dentro dos arquivos. Se você não conseguir encontrar um item, encurte o termo de pesquisa, limpe a pesquisa e expanda manualmente as pastas relevantes.

Pesquise na árvore de arquivos do Editor por nome de arquivo ou pasta.

Visualizar um arquivo

Selecione um arquivo na árvore. O Atoms pode visualizar arquivos comuns de código e texto, arquivos HTML, Markdown, DOCX e XLSX, imagens, áudio e vídeo compatíveis, PDFs, arquivos CSV e notebooks Jupyter. A visualização disponível depende do tipo de arquivo.

Se um arquivo ou pasta não puder ser visualizado, baixe-o e abra-o em um aplicativo compatível.

Editar o código do projeto

1. Abra um arquivo de código ou texto compatível.
2. Faça suas alterações no editor.
3. Aguarde o indicador de salvamento terminar. Salvar sincroniza sua sessão de edição atual, mas ainda não aplica a sessão inteira.
4. Selecione Preview para verificar o resultado, quando houver uma visualização disponível.
5. Selecione Submit all para aplicar a sessão ou Discard all para reverter as edições dessa sessão.

Edições manuais e alterações geradas pelo Agente podem afetar os mesmos arquivos. Envie ou descarte suas edições atuais antes de pedir ao Agente para alterar o projeto e use o histórico do projeto antes de fazer uma alteração grande.

Visualize, descarte ou envie uma sessão de edição do Editor.

Se o Editor estiver somente leitura

O Editor pode impedir alterações temporariamente enquanto o Agente estiver trabalhando, enquanto um salvamento estiver em andamento ou enquanto você estiver visualizando uma versão anterior do projeto. Ele também pode ficar somente leitura em um projeto não compatível ou em uma conta sem o acesso necessário.

Aguarde a operação atual terminar, abra a versão mais recente e atualize a página. Se você estiver visualizando uma versão antiga, selecione Restore nos controles de versão, confirme Restore, aguarde a restauração terminar e reabra a versão mais recente. Confirme que o indicador Read only não está mais sendo exibido antes de editar.

Usar código no Chat e comparar alterações

Adicionar um arquivo inteiro ao Chat

Abra o arquivo, clique nos ... verticais e em Select file quando a ação estiver disponível. Você também pode digitar # no Chat e escolher um arquivo do projeto. O arquivo é adicionado como contexto para sua próxima solicitação.

Abra as ações do arquivo atual e selecione Select file.

Comparar uma alteração

Selecione Diff quando estiver disponível para comparar as versões original e modificada de um arquivo antes de aplicar a alteração.

Gerenciar arquivos e pastas

Use ... ao lado de um item na árvore de arquivos para ver as ações disponíveis para esse arquivo ou pasta. Dependendo do item e do estado do projeto, você pode criar, enviar, renomear, baixar ou excluir arquivos e pastas.

1. Localize o arquivo ou a pasta na árvore.
2. Selecione ....
3. Escolha a ação necessária e siga a instrução na tela.

Excluir um arquivo ou pasta não pode ser desfeito. Antes de excluir arquivos importantes do projeto, crie uma versão segura do projeto ou baixe uma cópia.

Algumas ações de arquivo ficam indisponíveis enquanto o Agente estiver alterando o projeto ou enquanto uma sessão de edição estiver sendo salva. Aguarde a operação atual terminar e tente novamente.

Baixar código e arquivos

Baixar o arquivo atual

1. Abra o arquivo no Editor.
2. Selecione Download nas ações do arquivo atual.
3. Abra o local de downloads do seu navegador e verifique o arquivo.

Baixar uma pasta

1. Selecione ... ao lado da pasta.
2. Selecione Download. O Atoms empacota a pasta como um arquivo ZIP.
3. Abra o arquivo e verifique o conteúdo.

Baixar o projeto atual

1. No Editor, selecione Download Project abaixo da árvore de arquivos.
2. Mantenha a página aberta enquanto o Atoms prepara o arquivo.
3. Abra o ZIP baixado e verifique os arquivos de que você precisa.

Você precisa estar conectado. Baixar o código-fonte do projeto atual pode exigir um plano pago elegível. O download pelo Editor também pode não estar disponível em uma visualização compartilhada do projeto em modo somente leitura.

Exportar em Share

Você também pode abrir Share e selecionar Export. Isso oferece outra forma de exportar o projeto como ZIP. Revise o arquivo baixado antes de usá-lo como entrega ou backup.

Abra Share e selecione Export para baixar o projeto.