Open Codex : un outil d'IA open source pour convertir le langage naturel en commandes Shell

Introduction générale

Open Codex est un outil d'IA en ligne de commande open source conçu pour les développeurs afin de convertir des instructions en langage naturel en commandes shell précises. Il utilise un modèle de langage natif (par exemple phi-4-mini) et ne nécessite pas de réseau ou de clés API, toutes les opérations étant exécutées localement. Les utilisateurs peuvent générer des commandes shell ou du code avec une simple description, ce qui le rend adapté à des tâches de programmation rapides. Le projet est hébergé sur GitHub, il est facile à installer et prend en charge macOS, Linux et Windows. open Codex met l'accent sur la sécurité et exige une confirmation de l'utilisateur avant que les commandes puissent être exécutées afin de protéger le système.

Liste des fonctions

• Du langage naturel aux commandes ShellLe langage de commande : convertit les données en langage naturel de l'utilisateur en commandes exécutables du shell.
• Modèles locauxLa protection de la vie privée : elle prend en charge les modèles locaux tels que le phi-4-mini sans qu'une connexion Internet soit nécessaire et avec une protection de la vie privée.
• génération de codesLes services d'aide à la décision : Générer des extraits de code dans plusieurs langages de programmation sur la base de descriptions.
• Mécanisme de confirmation des commandesLa confirmation de l'utilisateur est requise après la génération des commandes afin d'éviter toute utilisation abusive.
• Historique de l'opérationLes fonctions de sauvegarde de l'historique des commandes, de visualisation et d'annulation partielle sont prises en charge.
• Extensions du plug-inLes outils d'aide à la décision : ils permettent aux développeurs de personnaliser les plug-ins afin d'étendre les fonctionnalités de l'outil.
• Support multiplateformeCompatible avec macOS, Linux et Windows, et adapté à plusieurs terminaux.

Utiliser l'aide

Processus d'installation

Open Codex prend en charge plusieurs méthodes d'installation pour s'adapter aux différents systèmes d'exploitation et aux habitudes des utilisateurs. Vous trouverez ci-dessous les étapes détaillées qui vous permettront de démarrer rapidement.

Installation via Homebrew (macOS/Linux)

1. Ajouter la source Homebrew pour Open Codex :

   brew tap codingmoh/open-codex
   

2. Outils d'installation :

   brew install open-codex
   

3. Vérifiez l'installation et la version :

   open-codex --version
   

Installation via pipx (multiplateforme)

1. Assurez-vous que Python (3.8 ou supérieur) et pipx sont installés.
2. Installer Open Codex globalement :

   pipx install open-codex
   

3. Vérifier l'installation :

   open-codex --version
   

Installation via le code source

1. Cloner un dépôt GitHub :

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

2. Accédez au catalogue de projets :

   cd open-codex
   

3. Installer la dépendance :

   pip install .
   

4. Vérifier l'installation :

   open-codex --version
   

Utilisation de base

Après l'installation, Open Codex peut être appelé à partir de la ligne de commande. Les instructions suivantes permettent d'utiliser les fonctions de base.

Du langage naturel aux commandes Shell

La fonction principale d'Open Codex est de convertir le langage naturel en commandes shell. La procédure est la suivante :

1. Saisir des commandes en langage naturel sur le terminal, par exemple :

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

2. génère les commandes shell correspondantes, par exemple :

   ls *.py
   

3. Le système invite l'utilisateur à choisir :
   • y: Exécutez la commande.
   • cCopier : Copier la commande dans le presse-papiers.
   • n: Annule l'opération.
4. option yLa commande s'exécute localement et affiche les résultats, par exemple la liste de tous les .py Documentation.

Générer des commandes Shell complexes

Pour les tâches complexes, Open Codex peut également générer des commandes en plusieurs étapes. Par exemple :

1. Entrée :

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

2. peuvent être générés :

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

3. Après confirmation de l'utilisateur, la commande s'exécute et affiche le nombre de lignes et le nombre total de chaque fichier txt.

Générer le code

Outre les commandes shell, Open Codex prend en charge la génération de code :

1. Entrée :

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

2. L'outil renvoie le code, par exemple :

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

3. Sélectionnable par l'utilisateur :
   • Enregistrer dans le fichier : Entrer open-codex --save backup.sh.
   • Copier dans le presse-papiers : sélectionner c.
   • Exécution directe : sélectionner y(Il faut s'assurer que le script est exécutable).

Voir l'historique

1. Visualiser l'historique des commandes générées et exécutées :

   open-codex --history
   

2. L'historique est classé par ordre chronologique, indiquant les commandes et leur état d'exécution.
3. Opération d'annulation (si elle est prise en charge) :

   open-codex --undo
   

Modèles personnalisés

Open Codex utilise par défaut le modèle phi-4-mini. Changer de modèle étape par étape :

1. Modifier le fichier de configuration (situé dans le répertoire ~/.open-codex/config.yaml) :

   model: phi-4-mini
   

2. modifications model sont d'autres modèles locaux soutenus.
3. Sauvegardez et redémarrez le terminal pour que le changement prenne effet.

Fonction en vedette Fonctionnement

Mécanisme de confirmation de sécurité

Pour éviter les abus, toutes les commandes doivent être confirmées par l'utilisateur avant d'être exécutées :

1. Après avoir saisi des commandes en langage naturel, l'outil affiche des suggestions de commandes.
2. Les utilisateurs reçoivent y(Mise en œuvre),c(Reproduction) ou n(Annulé) Sélection.
3. option y Lorsque la commande est exécutée dans un environnement "sandbox", elle garantit la sécurité du système.

Les opérations locales garantissent le respect de la vie privée

Open Codex fonctionne localement et ne nécessite pas de connexion Internet. Les données de l'utilisateur et le contenu généré ne sont pas téléchargés dans le nuage, ce qui convient aux scénarios exigeant le respect de la vie privée. C'est le cas, par exemple :

• Générer des commandes ou du code dans un environnement hors ligne.
• Évitez les fuites de données lorsque vous traitez des projets sensibles.

Extensions du plug-in

Les développeurs peuvent créer des modules d'extension :

1. Dans le répertoire racine du projet, créez le fichier plugins Dossier.
2. Ecrire le plugin en suivant la documentation (se référer au dépôt GitHub pour le plugin CONTRIBUTING.md).
3. Redémarrez Open Codex et le plugin se chargera automatiquement.

mise en garde

• Assurez-vous que Python 3.8 ou supérieur est installé.
• L'installation de Homebrew ou de pipx nécessite un réseau stable.
• L'installation du code source doit être mise à jour manuellement et il est recommandé de l'exécuter régulièrement. git pull.
• L'outil est en cours de développement et peut présenter des fonctionnalités non finalisées. Nous vous recommandons donc de garder un œil sur GitHub Issues.
• La génération de commandes complexes peut être limitée par les capacités du modèle, ce qui oblige l'utilisateur à vérifier l'exactitude des commandes.

scénario d'application

1. Génération rapide de commandes
   Le développeur oublie la commande spécifique de l'interpréteur de commandes (par exemple, unzip tar.gz) et tape open-codex "解压 tar.gz 文件"Obtenir tar -xzf file.tar.gz et la mise en œuvre.
2. Développement hors ligne
   Les développeurs utilisent Open Codex pour générer des scripts shell ou du code Python dans des environnements sans réseau, en protégeant la confidentialité des projets.
3. gestion du système
   Contribution de l'administrateur open-codex "查找占用磁盘空间最大的文件"Obtenir du -ah | sort -rh | headLe système permet de localiser rapidement le problème.
4. Apprendre les scripts Shell
   Entrée pour les débutants open-codex "用 Bash 写一个监控CPU的脚本"Le site Web de la Commission européenne permet d'obtenir des exemples de code et d'apprendre l'écriture de scripts.
5. Développement communautaire
   Les développeurs apportent de nouvelles fonctionnalités via GitHub, comme l'ajout d'un nouveau modèle ou l'optimisation de la logique de génération des commandes.

QA

1. Quelle est la précision du langage naturel par rapport aux commandes shell ?
   La précision dépend des capacités du modèle. phi-4-mini peut gérer des tâches courantes, et les commandes complexes suggèrent à l'utilisateur de vérifier les résultats générés.
2. D'autres commandes de terminal sont-elles prises en charge ?
   Le support principal est pour les commandes shell (bash/zsh), avec des extensions futures possibles pour PowerShell, etc. Voir la feuille de route GitHub pour plus de détails.
3. Comment gérer la commande Generate Error ?
   Après avoir vérifié la commande, sélectionnez n l'annulation de l'exécution, ou par open-codex --history Vérifier les antécédents et révoquer si nécessaire.
4. Prend-il en charge la saisie multilingue ?
   Actuellement optimisé pour le chinois et l'anglais, d'autres langues peuvent nécessiter des descriptions plus précises.
5. Comment puis-je donner mon avis sur un problème ?
   Visitez le dépôt GitHub (https://github.com/codingmoh/open-codex) pour soumettre des problèmes ou des demandes d'extraction.