Codwhat BR
Explicador de codigo, configuracoes e dados em Portugues para o Visual Studio Code, com suporte nativo ao GitHub Copilot, dialetos Portugol (VisualG e Portugol Studio) e analise tecnica sob demanda.
Como Funciona
O Codwhat BR opera de forma direta e sem atalhos de teclado:
- Selecao direta com o mouse: Basta selecionar qualquer trecho de codigo, arquivo
.env, estrutura JSON ou documento Markdown com o botao esquerdo do mouse.
- Atualizacao automatica: O painel lateral processa a selecao e exibe a explicacao estruturada instantaneamente.
- Card no Hover: Ao manter o cursor do mouse sobre o texto selecionado, um card flutuante sintetiza o objetivo, a logica interna e a traducao em pseudocodigo.
Provedores de Inteligencia Artificial
O Codwhat BR suporta integracao com os principais motores de modelo de linguagem do mercado:
- GitHub Copilot (Nativo): Utiliza a Language Model API oficial do VS Code (
vscode.lm). Funciona diretamente com a sua conta do GitHub Copilot ativa, sem necessidade de configurar chaves de API externas.
- Google Gemini: Modelos
gemini-2.5-flash e gemini-1.5-flash via requisicao direta.
- Groq Cloud: Inferencias de baixa latencia com
llama-3.3-70b-versatile.
- OpenAI: Modelos
gpt-4o-mini e gpt-4o.
- Ollama (Offline): Execucao de modelos locais na sua propria maquina (ex:
llama3, qwen2.5-coder) sem trafego de dados externo.
- Modo Local: Analisador estatico e heuristico integrado que opera sem conexao de rede.
Para alternar o provedor, utilize o comando Codwhat BR: Configurar Provedor de IA / Copilot pelo Command Palette (Ctrl + Shift + P).
Tipos de Arquivos e Linguagens Suportadas
O Codwhat BR analisa tanto codigo executavel quanto arquivos de infraestrutura, dados e documentacao:
Arquivos de Configuracao e Dados
- Variaveis de Ambiente (
.env, .env.*): Analisa chaves, finalidade de portas e URLs, alertando sobre exposicao indevida de credenciais e segredos em repositorios.
- JSON (
.json, .jsonc): Explica estruturas de configuracao (como package.json, tsconfig.json), tipos de campos, regras de sintaxe e formatos de comunicacao de APIs REST.
- Markdown (
.md): Interpreta documentacoes tecnicas, organizacao de cabecalhos, tabelas e marcacoes de formato.
- YAML (
.yml, .yaml): Pipelines de CI/CD (GitHub Actions), Docker Compose e manifestos de configuracao.
- Docker / Infraestrutura (
Dockerfile, Containerfile): Comandos de imagem, estagios de build e definicoes de portas.
- SQL (
.sql): Consultas relacionais, agregacoes, juncoes e criacao de esquemas.
Linguagens de Programacao e Algoritmos
- Python
- JavaScript / TypeScript
- C e C++
- Java e C#
- Go e Rust
- PHP e Ruby
- Portugol / VisualG
Ao selecionar codigos executaveis dessas linguagens, a extensao fornece:
- Resumo do objetivo da rotina.
- Passo a passo da execucao logica.
- Analise de complexidade assintotica (Notacao Big-O para tempo e memoria).
- Conversao automatica para pseudocodigo Portugol Studio ou VisualG.
Configuracoes Disponiveis
No arquivo de configuracoes do VS Code (settings.json) ou na interface de preferencias:
codwhat.provider: Provedor ativo (copilot, gemini, groq, openai, ollama, demo). Padrao: copilot.codwhat.apiKey: Chave de API para Gemini, Groq ou OpenAI.codwhat.autoExplainOnSelect: Se verdadeiro, atualiza a analise imediatamente ao selecionar texto com o mouse (padrao: true).codwhat.enableHover: Exibe explicacoes em card flutuante ao pairar o mouse sobre selecoes (padrao: true).codwhat.portugolDialect: Dialeto padrao para conversoes (portugol-studio ou visualg).codwhat.cacheExplanations: Armazena consultas recentes em memoria para resposta instantanea (padrao: true).
Licenca
Distribuido sob a licenca MIT. Consulte o arquivo LICENSE para termos de uso.
| |
