Open Codex: una herramienta de AI de código abierto para convertir lenguaje natural en comandos de shell

Introducción general

Open Codex es una herramienta de IA de línea de comandos de código abierto diseñada para que los desarrolladores conviertan instrucciones de lenguaje natural en comandos de shell precisos. Utiliza un modelo de lenguaje nativo (por ejemplo, phi-4-mini) y no requiere redes ni claves API, todas las operaciones se ejecutan localmente. Los usuarios pueden generar comandos shell o código con una simple descripción, lo que lo hace adecuado para tareas rápidas de programación. El proyecto está alojado en GitHub, es fácil de instalar y es compatible con macOS, Linux y Windows. open Codex hace hincapié en la seguridad y exige la confirmación del usuario antes de ejecutar los comandos para proteger el sistema.

Lista de funciones

• Lenguaje natural a comandos de shellConvierte la entrada de lenguaje natural del usuario en comandos de shell ejecutables.
• Modelos locales: Admite modelos locales como phi-4-mini sin necesidad de conexión a Internet y con protección de la privacidad.
• generación de códigoGenerar fragmentos de código en varios lenguajes de programación a partir de descripciones.
• Mecanismo de confirmación de pedidos: Se requiere la confirmación del usuario después de generar los comandos para evitar usos indebidos.
• Historia de la operación: Guarda el historial de comandos, soporta las funciones de vista y deshacer parcial.
• Extensiones Plug-in: Soporte para que los desarrolladores personalicen los plug-ins para ampliar la funcionalidad de la herramienta.
• Soporte multiplataformaCompatible con macOS, Linux y Windows, y apto para múltiples terminales.

Utilizar la ayuda

Proceso de instalación

Open Codex admite varios métodos de instalación para adaptarse a los distintos sistemas operativos y hábitos de los usuarios. A continuación se detallan los pasos para garantizar un inicio rápido.

Instalación mediante Homebrew (macOS/Linux)

1. Añade la fuente Homebrew para Open Codex:

   brew tap codingmoh/open-codex
   

2. Herramientas de instalación:

   brew install open-codex
   

3. Verifique la instalación y compruebe la versión:

   open-codex --version
   

Instalación mediante pipx (multiplataforma)

1. Asegúrese de que Python (3.8 o superior) y pipx están instalados.
2. Instale Open Codex globalmente:

   pipx install open-codex
   

3. Verifica la instalación:

   open-codex --version
   

Instalación mediante código fuente

1. Clonar un repositorio GitHub:

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

2. Vaya al catálogo de proyectos:

   cd open-codex
   

3. Instale la dependencia:

   pip install .
   

4. Verifica la instalación:

   open-codex --version
   

Uso básico

Tras la instalación, Open Codex puede invocarse desde la línea de comandos. A continuación se ofrecen instrucciones para utilizar las funciones básicas.

Lenguaje natural a comandos de shell

La función principal de Open Codex es convertir el lenguaje natural en comandos de shell. El procedimiento es el siguiente:

1. Introduzca comandos de lenguaje natural en el terminal, por ejemplo:

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

2. genera los comandos shell correspondientes, por ejemplo:

   ls *.py
   

3. El sistema pide al usuario que elija:
   • yEjecuta el comando.
   • c: Comando de copia al portapapeles.
   • n: Cancela la operación.
4. opción yEl comando se ejecuta localmente y muestra los resultados, por ejemplo, lista todos los .py Documentación.

Generación de comandos Shell complejos

Para tareas complejas, Open Codex también puede generar comandos de varios pasos. Por ejemplo:

1. Entrada:

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

2. pueden generarse herramientas:

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

3. Después de que el usuario confirme, el comando se ejecuta, mostrando el número de líneas y el número total de cada archivo txt.

Generar código

Además de los comandos de shell, Open Codex admite la generación de código:

1. Entrada:

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

2. La herramienta devuelve el código, por ejemplo:

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

3. Seleccionable por el usuario:
   • Guardar en archivo: Intro open-codex --save backup.sh.
   • Copiar en el portapapeles: seleccione c.
   • Ejecución directa: seleccionar y(Es necesario asegurarse de que el script es ejecutable).

Ver historial

1. Ver el historial de comandos generados y ejecutados:

   open-codex --history
   

2. El historial se ordena por tiempo, mostrando los comandos y el estado de ejecución.
3. Operación de deshacer (si se admite):

   open-codex --undo
   

Modelos personalizados

Open Codex utiliza por defecto el modelo phi-4-mini. Cambiando de modelo paso a paso:

1. Edite el archivo de configuración (ubicado en el directorio ~/.open-codex/config.yaml):

   model: phi-4-mini
   

2. modificaciones model son otros modelos locales compatibles.
3. Guarde y reinicie el terminal para que el cambio surta efecto.

Función destacada Operación

Mecanismo de confirmación de seguridad

Para evitar usos indebidos, todos los comandos requieren la confirmación del usuario antes de su ejecución:

1. Tras introducir comandos en lenguaje natural, la herramienta muestra comandos sugeridos.
2. Los usuarios disponen de y(Aplicación),c(Reproducción) o n(Cancelado) Selección.
3. opción y Cuando el comando se ejecuta en un entorno aislado, garantiza la seguridad del sistema.

El funcionamiento local garantiza la privacidad

Open Codex funciona localmente y no requiere conexión a Internet. Los datos de los usuarios y los contenidos generados no se suben a la nube, lo que resulta adecuado para escenarios con elevados requisitos de privacidad. Por ejemplo:

• Genere comandos o código en un entorno sin conexión.
• Evite la fuga de datos al gestionar proyectos delicados.

Extensiones Plug-in

Los desarrolladores pueden crear mejoras para los plug-ins:

1. En el directorio raíz del proyecto, cree el archivo plugins Carpeta.
2. Escriba el plugin de acuerdo con la documentación (consulte el repositorio de GitHub para el archivo CONTRIBUTING.md).
3. Reinicie Open Codex y el plugin se cargará automáticamente.

advertencia

• Asegúrese de que Python 3.8 o superior está instalado.
• La instalación homebrew o pipx requiere una red estable.
• La instalación del código fuente debe actualizarse manualmente, y se recomienda ejecutarla con regularidad. git pull.
• La herramienta está en fase de desarrollo y puede tener características inacabadas, por lo que recomendamos seguir los Temas de GitHub.
• La generación de comandos complejos puede estar limitada por las capacidades del modelo, lo que obliga al usuario a comprobar la precisión de los comandos.

escenario de aplicación

1. Generación rápida de comandos
   El desarrollador olvida el comando shell específico (por ejemplo, descomprimir tar.gz) y teclea open-codex "解压 tar.gz 文件"Visite tar -xzf file.tar.gz y aplicación.
2. Desarrollo offline
   En entornos sin red, los desarrolladores utilizan Open Codex para generar shell scripts o código Python, protegiendo la privacidad de sus proyectos.
3. gestión del sistema
   Entrada del administrador open-codex "查找占用磁盘空间最大的文件"Visite du -ah | sort -rh | headlocalizar rápidamente el problema.
4. Aprender Shell Scripting
   Entrada para principiantes open-codex "用 Bash 写一个监控CPU的脚本"Obtén ejemplos de código y aprende a programar.
5. Desarrollo comunitario
   Los desarrolladores contribuyen con nuevas funciones a través de GitHub, como la incorporación de nuevos modelos o la optimización de la lógica de generación de comandos.

CONTROL DE CALIDAD

1. ¿Hasta qué punto es preciso el lenguaje natural para los comandos del shell?
   La precisión depende de las capacidades del modelo. phi-4-mini puede manejar tareas comunes, y los comandos complejos sugieren que el usuario compruebe los resultados generados.
2. ¿Se admiten otros comandos de terminal?
   El soporte principal es para comandos shell (bash/zsh), con posibles extensiones futuras a PowerShell, etc. Consulte la hoja de ruta de GitHub para más detalles.
3. ¿Cómo se gestiona el comando Generar error?
   Después de comprobar el comando seleccione n cancelación de la ejecución, o por open-codex --history Compruebe el historial y revoque si es necesario.
4. ¿Es compatible con la entrada multilingüe?
   Actualmente está optimizado para chino e inglés, pero otros idiomas pueden requerir descripciones más precisas.
5. ¿Cómo puedo dar mi opinión sobre un problema?
   Visite el repositorio de GitHub (https://github.com/codingmoh/open-codex) para enviar Issues o Pull Requests.