SuperCoder: assistente de código inteligente para execução em terminal de linha de comando

Introdução geral

O SuperCoder é uma ferramenta inteligente que é executada no terminal e foi projetada para programadores. Ele usa a tecnologia de IA para ajudar os usuários a procurar códigos, visualizar a estrutura do projeto, editar arquivos e corrigir bugs. O projeto tem código aberto por huytd no GitHub e é compatível com Linux, MacOS e Windows. Em sua essência, o SuperCoder permite que os desenvolvedores concluam tarefas complexas na linha de comando por meio de comandos de linguagem natural. Ele pode usar a API da OpenAI, mas também oferece suporte a modelos locais ou é compatível com outras APIs da OpenAI. As ferramentas para pessoas que gostam de operação em terminal podem melhorar significativamente a eficiência do desenvolvimento.

Lista de funções

• Pesquisa de códigoPesquisa de padrões de código específicos em projetos para localizar rapidamente funções ou variáveis.
• Visualização da estrutura do projetoExiba o layout de pastas e arquivos do projeto para facilitar a navegação.
• editor de códigoModificação do conteúdo de um arquivo diretamente por meio de comandos de linguagem natural.
• Correções de bugsCom base nas solicitações dos usuários, a IA analisa e corrige automaticamente os problemas de código.
• leitura de arquivosArquivo: lê e exibe o conteúdo do arquivo especificado.
• execução de comandosExecutar comandos do shell conforme necessário.
• Suporte às regras do cursor: em conjunto com Cursor Regras, identificação e modificação de código.

Usando a Ajuda

O SuperCoder é uma ferramenta de terminal que depende de arquivos pré-compilados fornecidos oficialmente ou da compilação do código-fonte para instalação e uso. Abaixo estão as etapas e instruções detalhadas.

Processo de instalação

Método 1: Use arquivos pré-compilados

1. Baixar arquivo
   Acesse https://github.com/huytd/supercoder/releases para encontrar a versão mais recente. Clique para fazer o download do arquivo ZIP para seu sistema (por exemplo, versão para Linux, MacOS ou Windows).
2. Descompacte o arquivo
   Extraia o arquivo ZIP para uma pasta em seu computador, por exemplo C:\SuperCoder(Windows) ou /home/user/supercoder(Linux/MacOS).
3. Configuração do PATH
   Certifique-se de que o arquivo descompactado bin/supercoder(Linux/MacOS) ou bin/supercoder.bat(Windows) para o caminho do arquivo PATH do sistema.
   • Windows: adicione o caminho à variável de ambiente.
   • Linux/MacOS: é executado no terminal:

     export PATH=$PATH:/path/to/supercoder/bin
     

4. execução de teste
   Abra um terminal e digite:

supercoder

Se a mensagem de boas-vindas for exibida, a instalação foi bem-sucedida.

Método 2: Compilação do código-fonte

1. Preparação do ambiente
   Certifique-se de que o Java 8 ou superior esteja instalado, bem como o SBT (Scala Build Tool). Verifique a versão:

java -version
sbt about

2. armazém de clones
   Digite-o no terminal:

git clone https://github.com/huytd/supercoder.git
cd supercoder

3. Compilação de projetos
   Em execução:

sbt compile

4. teste operacional
   Entrada:

sbt test

Disponível após a aprovação no teste sbt run Lançamento.

Configuração de modelos de IA

O SuperCoder exige que um modelo de IA seja configurado para funcionar e oferece suporte a duas abordagens:

Abordagem 1: usando a API da OpenAI

1. Registre-se e obtenha a chave da API em https://platform.openai.com/.
2. Defina as variáveis de ambiente no terminal:

export OPENAI_API_KEY=<你的API密钥>
export OPENAI_MODEL=o3-mini  # 默认模型，可改成其他

Abordagem 2: Use modelos nativos ou APIs compatíveis

1. Configuração de variáveis de ambiente:

export SUPERCODER_BASE_URL=<模型地址>
export SUPERCODER_API_KEY=<密钥>
export SUPERCODER_MODEL=<模型名>

2. Se estiver usando o Google Gemini, configurações adicionais:

export SUPERCODER_GEMINI_MODE=true

Observação: O modelo precisa suportar a função de chamada da ferramenta.

Como usar os principais recursos

Depois de iniciar o SuperCoder, você pode inserir comandos de linguagem natural no terminal para operá-lo.

Pesquisa de código

Entrada:

Search for usage of function print

O SuperCoder listará todos os locais do projeto em que "print" é usado, por exemplo:

main.py:10: print("Hello")
utils/helper.py:5: print(x)

Visualização da estrutura do projeto

Entrada:

Show me the project structure

O resultado é semelhante:

project/
├── main.py
├── utils/
│   └── helper.py
└── README.md

editor de código

fantasia main.py Adicione um novo método, input:

Edit file main.py to add a new method

O SuperCoder solicitará os detalhes do método e modificará automaticamente o arquivo após a entrada.

Correções de bugs

Entrada:

Fix bugs in main.py

A análise de IA pode sugerir isso:

第15行可能无限循环，建议改为 while x < 100
是否应用？(y/n)

importação y Agradecimentos.

leitura de arquivos

Entrada:

Read file main.py

O SuperCoder exibe o conteúdo do arquivo.

execução de comandos

Entrada:

Run shell command ls

Para listar diretórios no Linux/MacOS, o Windows usa o comando dir Alternativa.

Exemplo de fluxo de operação

Supondo que o bug será alterado:

1. importação Show me the project structureLocalizar main.py.
2. importação Search for usage of errorLocalize o código do problema.
3. importação Edit file main.py to fix errorSiga as instruções para fazer alterações.
4. importação Fix bugs in main.pyA recomendação da IA é confirmada.
5. importação Read file main.pyverifique os resultados.

Tudo isso é feito por meio do terminal, o que é simples e intuitivo. Consulte o README no repositório do GitHub para obter mais informações sobre o uso.

cenário do aplicativo

1. Localizar rapidamente o problema
   Não consegue encontrar o código de um grande projeto? Use os recursos de pesquisa e de visualização de estrutura para fazer isso em segundos.
2. Correção de bugs complexos
   A IA analisa automaticamente o código e fornece recomendações de correções, economizando tempo e esforço.
3. Desenvolvimento de terminais
   Não gosta de interfaces gráficas, o SuperCoder permite que você faça tudo a partir da linha de comando.

QA

1. Quais linguagens de programação são compatíveis?
   Não há restrições oficiais, principalmente arquivos de texto são suportados, e o efeito varia de acordo com o modelo de IA.
2. Preciso trabalhar em rede?
   A rede não é necessária com modelos locais e é necessária com a API OpenAI.
3. Como faço para atualizar a ferramenta?
   Acesse a página Releases para fazer download da versão mais recente ou recompilar o código-fonte.