Visão geral da interface do usuário
Entenda os componentes da interface e a navegação do Verdent
Verdent for VS Code apresenta uma interface limpa em três partes, projetada para minimizar distrações. Todas as interações acontecem dentro da barra lateral do Visual Studio Code, mantendo você perto do seu código.
Acessando o Verdent
Abra o Verdent usando qualquer um destes métodos:
- Ícone da barra lateral - Clique no ícone do Verdent na barra de atividades do Visual Studio Code (barra lateral esquerda)
- Atalho de teclado - Pressione
Cmd+L(macOS) ouCtrl+L(Windows/Linux) - Paleta de comandos - Pressione
Cmd+Shift+P/Ctrl+Shift+Pe busque por "Verdent"
O painel abre na barra lateral do Visual Studio Code e pode ser redimensionado, movido ou encaixado conforme necessário.
Redimensione o painel do Verdent arrastando sua borda para ver mais histórico de conversas ou dar mais espaço ao seu editor.
Componentes da interface
Acesso rápido a funcionalidades essenciais:
| Botão | Função |
|---|---|
| Nova sessão | Inicie uma nova conversa com contexto limpo |
| Histórico do projeto | Navegue e restaure sessões anteriores |
| Central do usuário | Veja informações da conta e saldo de créditos |
| Feedback | Envie feedback e relate problemas |
| Configurações | Configure servidores MCP, subagentes, regras e predefinições de modelo |
A área principal de conversa exibe:
- Respostas da IA - Texto formatado com blocos de código com destaque de sintaxe
- Diffs de código - Comparações interativas de antes/depois para alterações em arquivos
- Planos - Divisões estruturadas de tarefas ao usar o Plan Mode
- Resultados de verificação - Saída de execução de testes e informações de depuração
- Operações de arquivo - Confirmação de criações, edições ou exclusões de arquivos
- Saídas de subagentes - Resultados de tarefas delegadas
A Visão de chat mantém o histórico completo da conversa, permitindo que você role para revisar interações anteriores.
A área de entrada na parte inferior com controles para compor solicitações:
Área de entrada de texto: Campo de texto principal para digitar prompts em linguagem natural
Botões de ação:
| Botão | Função |
|---|---|
| Adicionar contexto | Referencie arquivos com @-menções ou invoque subagentes |
| Adicionar imagens ou arquivos | Inclua capturas de tela, diagramas ou documentos para análise |
| Adicionar subagente | Delegue tarefas a subagentes especializados |
| Switch Mode | Alterne entre os modos Agent, Plan e Chat |
| Trocar/Personalizar modelo de IA | Selecione predefinições Performance, Balance, Efficiency ou modelos específicos |
| Think Hard Mode | Ative o orçamento máximo de raciocínio para reflexões complexas |
| Trocar permissão | Mude o modo de permissão (Manual Accept, Auto-Run, Plan, Skip Permissions) |
| Enviar | Submeta seu prompt ao modelo de IA |
Indicadores de status
Verdent comunica o estado do sistema por meio de indicadores visuais:
A Visão de chat comunica o status por meio de pistas visuais em vez de rótulos explícitos:
- Indicador de processamento - Um indicador visual aparece quando o Verdent está trabalhando ativamente. Isso mostra quando a IA está lendo arquivos, analisando código ou se preparando para responder.
- Texto sendo gerado - Você verá a resposta do Verdent aparecendo em tempo real à medida que a IA compõe explicações, sugestões de código ou planos. O texto em streaming indica que o modelo está gerando saída ativamente.
- Nada acontecendo - Quando a Visão de chat está estática, sem atividade, o Verdent está aguardando. Isso significa que você precisa aprovar alterações em arquivos, responder perguntas de esclarecimento ou fazer sua próxima solicitação.
O cursor de texto na Caixa de entrada indica se o Verdent está pronto para aceitar novas solicitações:
- Cursor piscando - A Caixa de entrada está ativa e pronta para entrada de texto. Você pode digitar sua solicitação e pressionar Enviar. Isso aparece quando o Verdent concluiu o processamento e está aguardando seu próximo prompt.
- Sem cursor/desabilitado - A Caixa de entrada fica desabilitada enquanto o Verdent processa uma solicitação. Isso evita interrupções na tarefa atual e garante que cada solicitação seja concluída antes de iniciar outra.
Padrão de fluxo de trabalho: Quando você envia uma solicitação, o cursor desaparece (a entrada fica desabilitada). Assim que o Verdent conclui a tarefa, o cursor reaparece, sinalizando que você pode digitar sua próxima solicitação.
A Caixa de entrada exibe indicadores mostrando sua configuração atual:
- Botão Trocar permissão - Mostra seu modo de permissão atual como um rótulo no próprio botão. Você verá "Manual", "Auto", "Plan" ou "Skip" exibido. Isso permite confirmar qual modo de execução está ativo antes de enviar sua solicitação. Clique no botão para alternar entre os modos disponíveis.
- Botão Trocar/Personalizar modelo de IA - Exibe o modelo ou predefinição atualmente selecionado. Você verá "Performance", "Balance" ou "Efficiency" para predefinições, ou nomes de modelos específicos como "Claude 4.5 Sonnet" se você tiver selecionado um modelo individual. Isso confirma qual modelo de IA processará sua próxima solicitação.
Esses indicadores fornecem uma confirmação rápida de suas configurações atuais, ajudando você a garantir a configuração correta antes de enviar prompts.
Os indicadores de status são atualizados em tempo real para mostrar exatamente o que o Verdent está fazendo, ajudando você a entender a atividade do agente.
Padrões de navegação
Diferentes elementos de navegação usam métodos diferentes para retornar à Visão de chat principal:
A partir de páginas (Histórico do projeto, Configurações):
- Clique no botão X no canto superior da página
- Isso retorna você à Visão de chat de onde você parou
A partir de popups (Central do usuário, Feedback):
- Clique no botão X no canto do popup, ou
- Clique em qualquer lugar fora da sobreposição do popup
- A Visão de chat sempre esteve visível atrás do popup, então fechar o popup imediatamente devolve o foco
A partir de menus suspensos:
- Os menus fecham automaticamente quando você faz uma seleção
- Clique em qualquer lugar fora do menu para fechar sem selecionar
- Você nunca sai da Visão de chat, então não há nada para "retornar"
Filosofia de navegação: A maioria das interações acontece por meio de menus suspensos que mantêm você na Visão de chat. Histórico do projeto e opções de Configurações navegam para páginas separadas, enquanto Central do usuário e Feedback usam popups sobrepostos que não escondem sua conversa.
Use @-menções e comandos de barra para guiar a navegação. Isso ajuda o Verdent a entender sua intenção e escolher as ferramentas certas.
Personalizando com regras
Acesse Configurações → Regras para personalizar o comportamento do Verdent usando arquivos Markdown:
Arquivo: VERDENT.md
Escopo: Preferências globais aplicadas em todos os projetos
Propósito: Defina suas preferências pessoais de uso que o Verdent aplicará durante os chats em todos os espaços de trabalho. Essas são configurações globais que persistem em todas as sessões, independentemente de em qual projeto você esteja trabalhando.
Casos de uso comuns:
- Idioma de saída padrão (por exemplo, "Sempre responda em espanhol")
- Preferências de comentários de código (por exemplo, "Inclua comentários detalhados no código gerado")
- Formatação de respostas (por exemplo, "Use TypeScript para todos os exemplos de JavaScript")
- Preferências pessoais de estilo de código
Como editar:
Abra as configurações
Clique em Configurações na Barra superior
Selecione Regras
Escolha Regras no menu suspenso
Edite as Regras de usuário
Selecione Regras de usuário para criar ou editar o VERDENT.md no formato Markdown
Arquivo: AGENTS.md
Escopo: Regras específicas do projeto apenas para o espaço de trabalho atual
Propósito: Defina padrões de codificação, padrões arquiteturais e fluxos de trabalho de desenvolvimento que se aplicam especificamente ao projeto atual. Essas regras substituem as Regras de usuário ao trabalhar neste espaço de trabalho e ajudam o Verdent a entender os requisitos únicos do seu projeto.
Casos de uso comuns:
- Padrões de codificação específicos do projeto (por exemplo, "Use kebab-case para todos os nomes de arquivos")
- Padrões arquiteturais (por exemplo, "Siga o padrão repository para acesso a dados")
- Requisitos de stack tecnológica (por exemplo, "Use React Hooks, não componentes de classe")
- Convenções de equipe (por exemplo, "Todas as respostas API devem incluir códigos de erro")
Como editar:
Abra as configurações
Clique em Configurações na Barra superior
Selecione Regras
Escolha Regras no menu suspenso
Edite as Regras de projeto
Selecione Regras de projeto para criar ou editar o AGENTS.md na raiz do seu espaço de trabalho
Este arquivo é específico do projeto e geralmente é versionado no controle de versão.
Arquivo: Plan.md
Escopo: Controla o formato e o conteúdo de saída do Plan Mode
Propósito: Personalize quais informações aparecem nos planos, quão detalhados eles são e qual formato seguem ao usar o Plan Mode. Essas regras determinam a estrutura e o conteúdo dos planos que o Verdent gera antes de executar tarefas complexas.
Casos de uso comuns:
- Nível de detalhe do plano (por exemplo, "Inclua estimativas de tempo para cada etapa")
- Estrutura do plano (por exemplo, "Sempre inclua uma seção 'Riscos'")
- Requisitos de conteúdo (por exemplo, "Liste todos os arquivos que serão modificados")
- Formato de saída (por exemplo, "Use listas numeradas para etapas sequenciais")
Como editar:
Abra as configurações
Clique em Configurações na Barra superior
Selecione Regras
Escolha Regras no menu suspenso
Edite as Regras de plano
Selecione Regras de plano para criar ou editar o plan_rules.md no formato Markdown