Visão Geral

O V8 Code Assistant é uma extensão poderosa para o Visual Studio Code que integra inteligência artificial para auxiliar desenvolvedores em suas tarefas de programação. A extensão oferece um chat inteligente com múltiplos provedores de IA, ferramentas MCP (Model Context Protocol), planejamento de tarefas e muito mais.

Recursos Principais

1. Chat Inteligente com Múltiplos Provedores

A extensão suporta três dos principais provedores de IA:

• OpenAI GPT - Acesso aos modelos GPT-4 e GPT-5
• Google Gemini - Integração com Gemini 2.5 Flash e Gemini Pro
• Anthropic Claude - Suporte aos modelos Claude Sonnet e Claude Haiku

2. Interface de Chat

O chat principal oferece uma interface intuitiva para interação com a IA:

Recursos do Chat:

• Histórico de conversas persistente
• Navegação com setas no histórico de mensagens
• Aplicação e reversão de mudanças no código
• Visualização de diffs com syntax highlighting
• Suporte a markdown e código

3. Histórico de Interações

Mantenha controle sobre suas conversas anteriores:

Funcionalidades:

• Navegação rápida entre mensagens anteriores
• Busca no histórico de conversas
• Persistência de contexto entre sessões

4. Sistema MCP (Model Context Protocol)

Configuração MCP

Configure servidores MCP para expandir as capacidades da extensão:

Recursos MCP:

• Conexão com servidores MCP externos
• Ferramentas customizadas
• Integração com APIs e serviços

Servidor MCP

Gerencie suas conexões MCP:

Funcionalidades:

• Status de conexão em tempo real
• Configuração de endpoints
• Gerenciamento de credenciais

Arquivo de Configuração MCP

Exemplo de configuração MCP:

Estrutura de Configuração:

{
  "mcpServers": {
    "servidor-exemplo": {
      "command": "node",
      "args": ["servidor.js"],
      "env": {
        "API_KEY": "sua-chave-aqui"
      }
    }
  }
}

Ferramentas MCP

Visualize e gerencie as ferramentas disponíveis:

Recursos:

• Lista de todas as ferramentas disponíveis
• Descrições detalhadas de cada ferramenta
• Status de disponibilidade

Modal de Descrições MCP

Acesse informações detalhadas sobre as ferramentas:

Informações Disponíveis:

• Parâmetros de entrada
• Tipo de retorno
• Exemplos de uso
• Documentação completa

5. Sistema de Planejamento

Modos de Planejamento

Escolha entre diferentes estratégias de planejamento:

Modos Disponíveis:

• Simples: Execução direta sem planejamento
• Complexo: Análise detalhada e planejamento em etapas
• Adaptativo: Ajusta a estratégia baseado na complexidade da tarefa

Modal de Modos de Planejamento

Configure detalhadamente o comportamento do planejador:

Configurações:

• Estratégia de execução
• Número máximo de tentativas
• Critérios de sucesso
• Tratamento de erros

6. Prompts Customizados

Prompt Customizado

Configure prompts personalizados para suas necessidades:

Recursos:

• Prompts específicos por projeto
• Templates reutilizáveis
• Integração com contexto do projeto

Modal de Prompt Customizado

Interface para edição avançada de prompts:

Funcionalidades:

• Editor com syntax highlighting
• Preview em tempo real
• Validação de sintaxe
• Histórico de versões

7. Gerenciamento de Contexto

Contexto do Projeto

Visualize e gerencie o contexto do seu projeto:

Recursos de Contexto:

• Estrutura do projeto
• Arquivos ativos
• Diagnósticos e erros
• Configurações do workspace

8. Configurações e Controles

Edição de Configurações

Acesse e modifique as configurações da extensão:

Configurações Disponíveis:

• Chaves de API dos provedores
• Modelos padrão
• Configurações de cache
• Parâmetros de performance

9. Controles de Sessão

Novo Chat

Inicie uma nova conversa:

Funcionalidades:

• Limpeza do histórico atual
• Reset do contexto
• Inicialização com prompt do sistema

Logout

Gerencie sua sessão:

Recursos:

• Logout seguro
• Limpeza de credenciais
• Reset de configurações

Configuração Inicial

1. Instalação

1. Instale a extensão no VS Code
2. Abra o painel V8 Code Assistant na barra lateral
3. Configure suas chaves de API

2. Configuração de Provedores

OpenAI

{
  "v8code.openaiApiKey": "sk-sua-chave-aqui",
  "v8code.openaiModel": "gpt-5"
}

Google Gemini

{
  "v8code.geminiApiKey": "sua-chave-aqui",
  "v8code.geminiModel": "gemini-2.5-flash"
}

Anthropic Claude

{
  "v8code.anthropicApiKey": "sua-chave-aqui",
  "v8code.anthropicModel": "claude-sonnet-4-20250514"
}

3. Configuração MCP (Opcional)

1. Crie um arquivo de configuração MCP
2. Configure os servidores desejados
3. Reinicie a extensão

Comandos Disponíveis

Comandos Principais

• V8 Code: Abrir Chat - Abre a interface principal do chat
• V8 Code: Atualizar Guia do Projeto - Atualiza o contexto do projeto

Atalhos de Teclado

• Ctrl+Alt+Y (Windows/Linux) ou Cmd+Alt+Y (Mac) - Abrir chat

Recursos Avançados

1. Cache Inteligente

• Cache de contexto do projeto
• Cache de respostas da IA
• Invalidação automática baseada em modificações

2. Processamento em Background

• Análise de código em background
• Coleta de contexto não bloqueante
• Otimização de performance

3. Integração com Terminal

• Execução de comandos
• Análise de erros
• Sugestões de correção

4. Sistema de Domínios

• ContextDomain: Gerenciamento de contexto do projeto
• TerminalDomain: Integração com terminal
• FileSystemDomain: Operações de arquivo

Troubleshooting

Problemas Comuns

1. Erro de API: Verifique suas chaves de API nas configurações
2. MCP não conecta: Verifique a configuração do servidor MCP
3. Performance lenta: Ajuste as configurações de cache e processamento

Logs e Debug

• Use o Developer Tools do VS Code para logs detalhados
• Verifique o console para mensagens de erro
• Configure o nível de log nas configurações

Suporte

Para suporte técnico ou dúvidas:

• Consulte a documentação oficial
• Entre em contato com a equipe V8.tech

---

Versão: 1.0.3
Desenvolvido por: V8.tech
Licença: MIT