Open Codex: uma ferramenta de IA de código aberto para converter linguagem natural em comandos de shell

Introdução geral

O Open Codex é uma ferramenta de IA de linha de comando de código aberto criada para que os desenvolvedores convertam instruções de linguagem natural em comandos de shell precisos. Ele usa um modelo de linguagem nativa (por exemplo, phi-4-mini) e não requer rede ou chaves de API, todas as operações são executadas localmente. Os usuários podem gerar comandos ou códigos de shell com uma descrição simples, o que o torna adequado para tarefas rápidas de programação. O projeto está hospedado no GitHub, é fácil de instalar e é compatível com macOS, Linux e Windows. O open Codex enfatiza a segurança e exige a confirmação do usuário antes que os comandos possam ser executados para proteger o sistema.

Lista de funções

• Linguagem natural para comandos de shellComando shell: converte a entrada de linguagem natural do usuário em comandos executáveis do shell.
• Execuções de modelos locaisSuporte a modelos locais, como o phi-4-mini, sem a necessidade de uma conexão com a Internet e com proteção de privacidade.
• geração de códigoGeração de trechos de código em várias linguagens de programação com base em descrições.
• Mecanismo de confirmação de pedidosConfirmação do usuário: A confirmação do usuário é necessária após a geração de comandos para evitar o uso indevido.
• Histórico de operaçõesHistórico de comandos: salva o histórico de comandos, suporta as funções de visualização e desfazer parcial.
• Extensões de plug-inSuporte para que os desenvolvedores personalizem plug-ins para ampliar a funcionalidade da ferramenta.
• Suporte a várias plataformasCompatível com macOS, Linux e Windows, e adequado para vários terminais.

Usando a Ajuda

Processo de instalação

O Open Codex suporta vários métodos de instalação para se adequar a diferentes sistemas operacionais e hábitos de usuário. Veja abaixo as etapas detalhadas para garantir um início rápido.

Instalação via Homebrew (macOS/Linux)

1. Adicione a fonte Homebrew para o Open Codex:

   brew tap codingmoh/open-codex
   

2. Ferramentas de instalação:

   brew install open-codex
   

3. Verifique a instalação e verifique a versão:

   open-codex --version
   

Instalação via pipx (multiplataforma)

1. Certifique-se de que o Python (3.8 ou superior) e o pipx estejam instalados.
2. Instale o Open Codex globalmente:

   pipx install open-codex
   

3. Verifique a instalação:

   open-codex --version
   

Instalação via código-fonte

1. Clonar um repositório do GitHub:

   git clone https://github.com/codingmoh/open-codex.git
   

2. Vá para o catálogo de projetos:

   cd open-codex
   

3. Instale a dependência:

   pip install .
   

4. Verifique a instalação:

   open-codex --version
   

Uso básico

Após a instalação, o Open Codex pode ser chamado a partir da linha de comando. Veja a seguir as instruções para operar as funções principais.

Linguagem natural para comandos de shell

A principal função do Open Codex é converter a linguagem natural em comandos do shell. O procedimento é o seguinte:

1. Digite comandos de linguagem natural no terminal, por exemplo:

   open-codex "列出当前目录下所有Python文件"
   

2. para gerar os comandos de shell correspondentes, por exemplo:

   ls *.py
   

3. O sistema solicita que o usuário escolha:
   • yExecutar o comando.
   • cCopiar comando para a área de transferência.
   • nCancelamento da operação: cancela a operação.
4. opção yO comando é executado localmente e exibe os resultados, por exemplo, lista todos os .py Documentação.

Geração de comandos complexos do shell

Para tarefas complexas, o Open Codex também pode gerar comandos de várias etapas. Por exemplo:

1. Entrada:

   open-codex "查找所有txt文件并统计行数"
   

2. ferramentas podem ser geradas:

   find . -name "*.txt" -exec wc -l {} \;
   

3. Depois que o usuário confirma, o comando é executado, exibindo o número de linhas e o número total de cada arquivo txt.

Gerar código

Além dos comandos do shell, o Open Codex oferece suporte à geração de código:

1. Entrada:

   open-codex "用 Bash 写一个备份文件夹的脚本"
   

2. A ferramenta retorna o código, por exemplo:

   #!/bin/bash
   tar -czf backup_$(date +%F).tar.gz /path/to/folder
   

3. Selecionável pelo usuário:
   • Salvar em arquivo: Enter open-codex --save backup.sh.
   • Copiar para a área de transferência: selecione c.
   • Execução direta: selecione y(É necessário garantir que o script seja executável).

Ver histórico

1. Visualizar o histórico de comandos gerados e executados:

   open-codex --history
   

2. O histórico é classificado por tempo, mostrando comandos e status de execução.
3. Operação de desfazer (se suportada):

   open-codex --undo
   

Modelos personalizados

O Open Codex usa o modelo phi-4-mini por padrão. Mudança de modelos passo a passo:

1. Edite o arquivo de configuração (localizado no diretório ~/.open-codex/config.yaml):

   model: phi-4-mini
   

2. modificações model são outros modelos locais compatíveis.
3. Salve e reinicie o terminal para que a mudança tenha efeito.

Operação da função em destaque

Mecanismo de confirmação de segurança

Para evitar o uso indevido, todos os comandos exigem a confirmação do usuário antes da execução:

1. Depois de inserir comandos de linguagem natural, a ferramenta exibe comandos sugeridos.
2. Os usuários recebem y(Implementação),c(Reprodução) ou nSeleção (cancelada).
3. opção y Quando o comando é executado em um ambiente de sandbox, ele garante a segurança do sistema.

A operação local garante a privacidade

O Open Codex opera localmente e não requer conexão com a Internet. Os dados do usuário e o conteúdo gerado não são carregados na nuvem, o que é adequado para cenários com altos requisitos de privacidade. Por exemplo:

• Gerar comandos ou códigos em um ambiente off-line.
• Evite o vazamento de dados ao lidar com projetos confidenciais.

Extensões de plug-in

Os desenvolvedores podem criar aprimoramentos de plug-in:

1. No diretório raiz do projeto, crie o arquivo plugins Pasta.
2. Escreva o plug-in de acordo com a documentação (consulte o repositório do GitHub para obter o arquivo CONTRIBUTING.md).
3. Reinicie o Open Codex e o plug-in será carregado automaticamente.

advertência

• Certifique-se de que o Python 3.8 ou superior esteja instalado.
• A instalação do Homebrew ou do pipx requer uma rede estável.
• A instalação do código-fonte precisa ser atualizada manualmente, e é recomendável executá-la regularmente. git pull.
• A ferramenta está em fase de desenvolvimento e pode ter recursos inacabados, por isso recomendamos que você fique de olho nos problemas do GitHub.
• A geração de comandos complexos pode ser limitada pelos recursos do modelo, exigindo que o usuário verifique a precisão dos comandos.

cenário do aplicativo

1. Geração rápida de comandos
   O desenvolvedor esquece o comando específico do shell (por exemplo, unzip tar.gz) e digita open-codex "解压 tar.gz 文件"Obter tar -xzf file.tar.gz e implementação.
2. Desenvolvimento off-line
   Os desenvolvedores usam o Open Codex para gerar scripts de shell ou código Python em ambientes sem rede, protegendo a privacidade do projeto.
3. gerenciamento do sistema
   Entrada do administrador open-codex "查找占用磁盘空间最大的文件"Obter du -ah | sort -rh | headLocalize rapidamente o problema.
4. Aprendendo Shell Scripting
   Entrada para iniciantes open-codex "用 Bash 写一个监控CPU的脚本"Obtenha exemplos de código e aprenda a criar scripts.
5. Desenvolvimento comunitário
   Os desenvolvedores contribuem com novos recursos por meio do GitHub, como a adição de suporte a novos modelos ou a otimização da lógica de geração de comandos.

QA

1. Qual é a precisão da linguagem natural em relação aos comandos do shell?
   A precisão depende dos recursos do modelo. O phi-4-mini pode lidar com tarefas comuns, e os comandos complexos sugerem que o usuário verifique os resultados gerados.
2. Há suporte para outros comandos de terminal?
   O suporte principal é para comandos shell (bash/zsh), com possíveis extensões futuras para o PowerShell, etc. Consulte o roteiro do GitHub para obter detalhes.
3. Como faço para lidar com o comando Generate Error?
   Depois de verificar o comando, selecione n cancelamento da execução, ou por open-codex --history Verifique o histórico e revogue-o, se necessário.
4. Ele suporta entrada em vários idiomas?
   Atualmente otimizado para entrada em chinês e inglês, outros idiomas podem exigir descrições mais precisas.
5. Como faço para dar feedback sobre um problema?
   Visite o repositório do GitHub (https://github.com/codingmoh/open-codex) para enviar problemas ou pull requests.