# Espaço de trabalho — App e CLI do AI Game Dev · AI Game Developer Wiki

O espaço de trabalho desktop do AI Game Dev: janelas de projeto, sessões em painéis, previews de texturas, modelos 3D e áudio, Explorer, Search e Git.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/app/workspace).

O app desktop é um espaço de trabalho de game dev construído em torno do ciclo que você repete o dia todo com um agente de IA: enviar um pedido, olhar o resultado, conferir as mudanças. Esta página descreve janelas de projeto, sessões e painéis, previews de arquivos, o painel direito com Explorer, Search e Source Control, e como deixar o espaço de trabalho do seu jeito.

## Uma janela por projeto

Cada projeto fica em sua própria janela, como no VS Code. Ao reiniciar o app, toda janela de projeto que estava aberta volta com seu próprio tamanho, posição, painéis laterais e layout de painéis.

Uma janela vazia é um launcher com projetos recentes, **Open folder…** e **Create new project**. Ctrl-clique (Windows, Linux) ou Cmd-clique (macOS) abre um projeto em uma nova janela em vez de substituir a atual. Veja [Projetos e engines](https://ai-game.dev/pt-br/docs/wiki/app/projects-and-engines) para abrir e criar projetos.

## Sessões em painéis

O centro da janela é um layout de painéis. Você pode:

- manter várias sessões abertas como abas, ou dividi-las lado a lado, na vertical ou na horizontal;
- maximizar um painel, ou deixá-lo flutuando sobre o layout;
- arrastar uma sessão da lista de sessões direto para o layout.

Sessões em segundo plano continuam recebendo streaming, e o layout é salvo por projeto. Cada painel mantém seu próprio modelo, esforço de raciocínio e agente, então um painel pode planejar uma funcionalidade com um modelo grande enquanto outro responde perguntas rápidas com um modelo veloz. Veja [Agentes e modelos](https://ai-game.dev/pt-br/docs/wiki/app/agents-and-models).

### Grupos de sessões

A barra lateral organiza as sessões em grupos que você pode criar, renomear, colorir e reordenar. O agrupamento é commitado junto com o projeto, então um colega que clona o repositório vê o mesmo layout. Cada linha mostra o que a IA está fazendo e há quanto tempo está trabalhando, e um campo de busca filtra sessões por nome ou grupo. Sessões marcadas como concluídas podem ser restauradas ou removidas permanentemente.

Para conversas longas, um navegador de prompts permite voltar a mensagens anteriores, com previews ao passar o mouse.

## Pré-visualize arquivos ao lado do chat

Quando o agente cria ou altera um arquivo, abra-o em um painel de preview ao lado das suas sessões. Caminhos de arquivo nas mensagens do chat são clicáveis: um clique abre o arquivo e vai até a linha quando a mensagem informa uma.

| Tipo de arquivo | O que o preview mostra |
| --- | --- |
| Código e Markdown | Destaque de sintaxe, Markdown renderizado |
| Imagens e texturas | PNG, JPEG e outros, além de TGA, TIFF, PSD, HDR, EXR, DDS, KTX e SVG |
| Modelos 3D | O modelo com suas texturas, iluminação e sombras alternáveis, um gizmo de orientação |
| Áudio | Uma forma de onda, a taxa de amostragem real, codec, profundidade de bits e canais, um botão de loop |
| Vídeo, fontes, CSV | Reprodução, glifos, uma tabela |
| Qualquer outra coisa | Uma visualização hexadecimal |

Um clique abre um preview temporário, um clique duplo o mantém aberto. Os previews recarregam quando o arquivo muda no disco, então, se você pedir uma textura mais escura, o preview aberto é atualizado assim que o agente grava o arquivo. Pacotes podem adicionar seus próprios previews e editores para outros tipos de arquivo.

## O painel direito: Explorer, Search, Source Control

O painel direito tem três abas:

- **Explorer**: os arquivos do projeto como uma árvore ao vivo com decoração do Git, renomear e criar inline, e arrastar e soltar arquivos no campo de composição do chat.
- **Search**: busca de conteúdo com globs de inclusão e exclusão, e substituição para todas as correspondências.
- **Source Control**: o branch, as contagens ahead e behind e um diffstat; faça commit e pull daqui.

Clique em um arquivo alterado em Source Control para abri-lo como diff. Para imagens, o diff é uma comparação lado a lado, para você ver exatamente como uma textura mudou antes de fazer o commit.

Pacotes podem adicionar suas próprias abas aos painéis laterais; o pacote Knowledge Base, por exemplo, adiciona uma visão Knowledge Base.

A CLI tem as mesmas operações como comandos: `/git` para status, stage, commit, discard, pull e push, `/search` e `/replace` para busca no projeto, `/file` para mudanças em arquivos e `/files` para os arquivos que o chat mencionou. Veja a [referência da CLI](https://ai-game.dev/pt-br/docs/wiki/app/cli#slash-commands).

## O ciclo: pedir, visualizar, revisar

1. Envie um pedido, por exemplo: "Troque Meadow Isle para a textura de grama noturna e deixe a queda do planeio um pouco mais lenta."
2. Veja os resultados ao lado do chat: a textura em um preview de imagem, um personagem em um preview 3D, a música no preview de áudio.
3. Abra Source Control, compare a textura antiga e a nova, e leia o diff do código.
4. Faça commit quando estiver satisfeito, ou peça outra mudança.

**Dica**

Faça commits com frequência. Commits pequenos facilitam voltar atrás quando um experimento não funciona, e o histórico mostra qual sessão fez qual mudança.

## Ferramentas, barra de status e paleta de comandos

- A **linha de ferramentas** acima do campo de composição liga e desliga as ferramentas da sessão: Blender, Music, Knowledge Base, Image Gen, Video, Tripo, Cloud generation e as ferramentas de outros pacotes que você instalar.
- A **barra de status** na parte inferior mostra itens de pacotes, como a contagem de notas do Knowledge Base, e o ícone de pacotes que abre a janela Packages.
- A **paleta de comandos** lista comandos do app e de pacotes.
- Pacotes podem adicionar botões à barra de ferramentas do campo de composição e itens aos menus de clique com o botão direito.

## Deixe do seu jeito

O espaço de trabalho vem com seis temas, do preto neutro Dark ao carvão Carbon e temas claros; escolha um em **Settings**, **Appearance**. À medida que a janela estreita, o campo de composição esconde seus controles em uma ordem fixa, então até uma divisão pequena continua utilizável. Dicas curtas dentro do app apresentam recursos na primeira vez que são úteis; você pode redefini-las em **Settings**, **General**.

## Saiba mais

- O post [um único espaço de trabalho para painéis, previews e Git](https://ai-game.dev/pt-br/blog/ai-game-dev-workspace-panes-previews-git) mostra o ciclo inteiro em um jogo de demonstração.
- [Packages](https://ai-game.dev/pt-br/docs/wiki/app/packages) explica como adicionar painéis, previews e ferramentas.

---

Source (HTML): https://ai-game.dev/pt-br/docs/wiki/app/workspace

Machine-translated (pt-BR) from the English page: https://ai-game.dev/docs/wiki/app/workspace