Arquitetura do Ecossistema de Desenvolvimento

Requisitos e Preparação do Ambiente

A compatibilidade com a extensão requer versões específicas do ambiente Microsoft. O funcionamento estável é garantido nas edições 2019 e 2022, sendo a última a opção recomendada para acesso irrestrito a todos os recursos de inferência.

Verificação de Versão Instalada

Navegue pelo menu principal: Ajuda → Sobre Microsoft Visual Studio. A janela exibida conterá a versão exata da compilação. Recomenda-se atualizar para a versão 2022 caso a edição 2019 apresente limitações na interface da barra lateral de IA.

Configuração de Cargas de Trabalho (Workloads)

Durante a instalação ou modificação via Visual Studio Installer, certifique-se de marcar os seguintes pacotes para habilitar o suporte necessário:

• Desenvolvimento .NET para Desktop: Requerido para WinForms e WPF.
• Desenvolvimento Web e ASP.NET: Fundamental para APIs REST e MVC.
• Desenvolvimento Multiplataforma .NET: Necessário para versões .NET 5 a 8.

Nota: Mantenha o componente IntelliCode ativo durante a seleção de recursos.

Ativação do Assistente Nativo (IntelliCode)

O módulo de inteligência artificial já vem embarcado na IDE. Para garantir seu funcionamento, acesse Ferramentas → Opções → IntelliCode → Geral e valide se os checkboxes para C#, C++, XAML e JavaScript/TypeScript estão habilitados.

Ao iniciar um novo projeto do tipo Aplicativo de Console, observe as sugestões marcadas com o símbolo ⭐. Elas indicam as chamadas de método mais frequentes baseadas em milhões de repositórios públicos. A confirmação é realizada pressionando a tecla Tab.

Integração e Instalação do CodeGeeX

1. Abra o gerenciador de extensões: Extensões → Gerenciar Extensões → Online.
2. Utilize a barra de pesquisa e digite o nome da ferramenta. Localize a publicação oficial da Zhipu AI e inicie o download.
3. Feche completamente a IDE. O instalador de pacotes VSIX será executado automaticamente. Reabra o programa para finalizar o processo.
4. Uma nova aba lateral aparecerá. Clique em autenticar e siga o fluxo de cadastro via e-mail ou número de contato.

Caso a versão 2019 não localize o pacote no repositório online, efetue o download direto do arquivo .vsix pelo portal oficial e execute-o manualmente.

Funcionalidades Operacionais

Geração de Lógica e Preenchimento Contextual

O sistema responde a descrições em linguagem natural ou ativa automaticamente sugestões em cinza durante a digitação. O atalho Alt + / força a geração imediata.

Exemplo de instrução e resposta reestruturada:

// Inserir um algoritmo de ordenação por divisão e conquista em C#

public static void OrganizarElementos(IList<int> colecao)
{
    if (colecao == null || colecao.Count <= 1) return;
    ProcessarDivisao(colecao, 0, colecao.Count - 1, new int[colecao.Count]);
}

private static void ProcessarDivisao(IList<int> origem, int limiteInf, int limiteSup, int[] bufferAux)
{
    if (limiteInf < limiteSup)
    {
        int pontoMedio = limiteInf + (limiteSup - limiteInf) / 2;
        ProcessarDivisao(origem, limiteInf, pontoMedio, bufferAux);
        ProcessarDivisao(origem, pontoMedio + 1, limiteSup, bufferAux);
        UnirSegmentos(origem, limiteInf, pontoMedio, limiteSup, bufferAux);
    }
}

private static void UnirSegmentos(IList<int> origem, int inicio, int meio, int fim, int[] buffer)
{
    int p1 = inicio;
    int p2 = meio + 1;
    int idx = inicio;

    while (p1 <= meio && p2 <= fim)
    {
        buffer[idx++] = (origem[p1] <= origem[p2]) ? origem[p1++] : origem[p2++];
    }
    while (p1 <= meio) buffer[idx++] = origem[p1++];
    while (p2 <= fim) buffer[idx++] = origem[p2++];
    
    for (int k = inicio; k <= fim; k++) origem[k] = buffer[k];
}

Documentação Automatizada

Selecione um trecho de código, clique com o botão direito e escolha Gerar Comentários. O plugin insere automaticamente tags XML padrão da documentação .NET.

/// <summary>
/// Aplica um percentual de desconto sobre o valor base
/// </summary>
/// <param name="valorTabela">Preço original do produto</param>
/// <param name="percentualReducao">Taxa de desconto entre 0 e 100</param>
/// <returns>Novo valor calculado</returns>
public decimal CalcularPrecoFinal(decimal valorTabela, double percentualReducao)
{
    decimal fator = 1M - (decimal)(percentualReducao / 100);
    return Math.Max(0, valorTabela * fator);
}

Transpilação entre Linguagens

A ferramenta converte blocos selecionados mantendo a semântica da operação original. Ao selecionar um método C# e solicitar tradução para Python, o resultado é adaptado às convenções da linguagem alvo.

// Código Original C#
public IEnumerable<int> ExtrairPares(IEnumerable<int> entrada)
{
    return entrada.Where(x => x % 2 == 0);
}

# Resultado Traduzido para Python
def filtrar_pares(sequencia):
    return [n for n in sequencia if n % 2 == 0]

Suporte a Consultas Técnicas

A interface lateral contém um terminal de chat especializado. É possível questionar sobre padrões de projeto, otimizar expressões LINQ ou solicitar explicações sobre mensagens de exceção, recebendo respostas contextualizadas ao projeto aberto.

Criação de Suítes de Teste Unitários

Com o cursor sobre um método, utilize Gerar Testes. A extensão produz uma classe de testes estruturada com o framework MSTest, incluindo arranjos e asserções automáticas.

// Método alvo
public long ObterFatorial(int valorBase)
{
    long acumulado = 1;
    for (int i = 2; i <= valorBase; i++)
        acumulado *= i;
    return acumulado;
}

// Classe de validação gerada
[TestClass]
public class TestesValidacao
{
    [TestMethod]
    public void ObterFatorial_Cinco_RetornaCentoEVinte()
    {
        var sut = new CalculadoraMatematica();
        var retorno = sut.ObterFatorial(5);
        Assert.AreEqual(120L, retorno);
    }

    [TestMethod]
    public void ObterFatorial_Zero_RetornaUm()
    {
        var sut = new CalculadoraMatematica();
        Assert.AreEqual(1L, sut.ObterFatorial(0));
    }
}

Roteiro de Trabalho Padrão

┌──────────────────────────────────────────────────────────┐
│ 1. Inicialização da IDE e carregamento do projeto        │
│    ↓                                                     │
│ 2. Preenchimento contínuo via IntelliCode (contexto local)│
│    ↓                                                     │
│ 3. Acionamento do CodeGeeX para estruturas complexas:     │
│    • Comentários → Algoritmo                               │
│    • Seleção → Tradução / Testes / Documentação            │
│    • Chat → Dúvidas arquiteturais                          │
│    ↓                                                     │
│ 4. Execução de Depuração (Debug) → Validação Unitária      │
│    ↓                                                     │
│ 5. Commit (Git) → Deploy (IIS / Cloud)                    │
└──────────────────────────────────────────────────────────┘

Diagnóstico de Imprevistos

• Aba lateral ausente: Ative através de Exibir → Outras Janelas → CodeGeeX ou redefina o layout pela opção Janela → Redefinir Layout de Janela.
• Latência nas respostas: Verifique a estabilidade da conexão de rede. O processamento depende de chamadas HTTP para os modelos hospedados. Evite horários de pico ou utilize uma rede estável.
• Sintaxe incorreta gerada: Utilize o recurso de revisão automática, descreva o erro no chat para obter correções e aceite as sugestões progressivamente (linha a linha) em vez de confirmar o bloco completo.
• Limitações na versão 2019: Interfaces mais recentes e modelos de inferência avançados podem ser bloqueados por incompatibilidade de APIs. A atualização para a versão 2022 resolve a maioria das restrições de UI.

Análise Comparativa de Recursos

Referência de Atalhos