Open Codex: Ein Open-Source-KI-Tool zur Umwandlung natürlicher Sprache in Shell-Befehle

Allgemeine Einführung

Open Codex ist ein quelloffenes Kommandozeilen-KI-Tool für Entwickler, das Anweisungen in natürlicher Sprache in präzise Shell-Befehle umwandelt. Es verwendet ein natives Sprachmodell (z. B. phi-4-mini) und erfordert keine Netzwerke oder API-Schlüssel, alle Operationen werden lokal ausgeführt. Benutzer können Shell-Befehle oder Code mit einer einfachen Beschreibung generieren, was es für schnelle Programmieraufgaben geeignet macht. Das Projekt wird auf GitHub gehostet, ist einfach zu installieren und unterstützt macOS, Linux und Windows. open Codex legt großen Wert auf Sicherheit und erfordert eine Benutzerbestätigung, bevor Befehle ausgeführt werden können, um das System zu schützen.

Funktionsliste

• Natürliche Sprache zu Shell-BefehlenKonvertiert Eingaben des Benutzers in natürlicher Sprache in ausführbare Shell-Befehle.
• Lokale ModellläufeUnterstützt lokale Modelle wie phi-4-mini, ohne dass eine Internetverbindung erforderlich ist, und mit Schutz der Privatsphäre.
• CodegenerierungGenerieren von Codeschnipseln in mehreren Programmiersprachen auf der Grundlage von Beschreibungen.
• Mechanismus der Auftragsbestätigung: Nach der Erzeugung von Befehlen ist eine Benutzerbestätigung erforderlich, um Missbrauch zu verhindern.
• Geschichte der OperationSpeichern der Befehlshistorie, Unterstützung der Ansicht und der Funktionen zum teilweisen Rückgängigmachen.
• Plug-in-ErweiterungenUnterstützung für Entwickler zur Anpassung von Plug-ins, um die Funktionalität des Tools zu erweitern.
• Plattformübergreifende UnterstützungKompatibel mit macOS, Linux und Windows und geeignet für mehrere Endgeräte.

Hilfe verwenden

Einbauverfahren

Open Codex unterstützt mehrere Installationsmethoden, um verschiedenen Betriebssystemen und Benutzergewohnheiten gerecht zu werden. Nachfolgend finden Sie die detaillierten Schritte, die einen schnellen Start gewährleisten.

Installation über Homebrew (macOS/Linux)

1. Fügen Sie die Homebrew-Quelle für Open Codex hinzu:

   brew tap codingmoh/open-codex
   

2. Installationswerkzeuge:

   brew install open-codex
   

3. Verifizieren Sie die Installation und überprüfen Sie die Version:

   open-codex --version
   

Installation über pipx (plattformübergreifend)

1. Stellen Sie sicher, dass Python (3.8 oder höher) und pipx installiert sind.
2. Installieren Sie Open Codex weltweit:

   pipx install open-codex
   

3. Überprüfen Sie die Installation:

   open-codex --version
   

Installation über den Quellcode

1. Klonen Sie ein GitHub-Repository:

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

2. Rufen Sie den Projektkatalog auf:

   cd open-codex
   

3. Installieren Sie die Abhängigkeit:

   pip install .
   

4. Überprüfen Sie die Installation:

   open-codex --version
   

Grundlegende Verwendung

Nach der Installation kann Open Codex über die Kommandozeile aufgerufen werden. Im Folgenden finden Sie eine Anleitung zur Bedienung der Kernfunktionen.

Natürliche Sprache zu Shell-Befehlen

Die Hauptfunktion von Open Codex besteht darin, natürliche Sprache in Shell-Befehle umzuwandeln. Das Verfahren ist wie folgt:

1. Geben Sie am Terminal Befehle in natürlicher Sprache ein, zum Beispiel:

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

2. Tool, um die entsprechenden Shell-Befehle zu generieren, zum Beispiel:

   ls *.py
   

3. Das System fordert den Benutzer auf, eine Auswahl zu treffen:
   • y: Führen Sie den Befehl aus.
   • cKopieren: Befehl in die Zwischenablage kopieren.
   • nAbbrechen: Bricht den Vorgang ab.
4. Option yDer Befehl wird lokal ausgeführt und zeigt die Ergebnisse an, z. B. eine Liste aller .py Dokumentation.

Komplexe Shell-Befehle generieren

Für komplexe Aufgaben kann Open Codex auch mehrstufige Befehle erzeugen. Zum Beispiel:

1. Eingabe:

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

2. Werkzeuge generiert werden können:

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

3. Nach der Bestätigung durch den Benutzer wird der Befehl ausgeführt, wobei die Anzahl der Zeilen und die Gesamtzahl jeder txt-Datei angezeigt werden.

Code generieren

Zusätzlich zu den Shell-Befehlen unterstützt Open Codex auch die Codegenerierung:

1. Eingabe:

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

2. Das Tool gibt z. B. den Code zurück:

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

3. Vom Benutzer wählbar:
   • In Datei speichern: Eingabe open-codex --save backup.sh.
   • In die Zwischenablage kopieren: Wählen Sie c.
   • Direkte Ausführung: auswählen y(Sie müssen sicherstellen, dass das Skript ausführbar ist).

Geschichte ansehen

1. Zeigen Sie den Verlauf der erzeugten und ausgeführten Befehle an:

   open-codex --history
   

2. Der Verlauf ist nach Zeit sortiert und zeigt Befehle und Ausführungsstatus an.
3. Rückgängig machen (falls unterstützt):

   open-codex --undo
   

Kundenspezifische Modelle

Open Codex verwendet standardmäßig das Modell phi-4-mini. Schrittweiser Wechsel der Modelle:

1. Bearbeiten Sie die Konfigurationsdatei (die sich im Verzeichnis ~/.open-codex/config.yaml):

   model: phi-4-mini
   

2. Änderungen model Felder sind andere unterstützte lokale Modelle.
3. Speichern Sie und starten Sie das Terminal neu, damit die Änderung wirksam wird.

Featured Function Bedienung

Mechanismus zur Sicherheitsbestätigung

Um Missbrauch zu verhindern, müssen alle Befehle vor ihrer Ausführung vom Benutzer bestätigt werden:

1. Nach der Eingabe von Befehlen in natürlicher Sprache zeigt das Tool vorgeschlagene Befehle an.
2. Die Nutzer erhalten folgende Informationen y(Umsetzung),c(Vervielfältigung) oder n(Abgebrochen) Auswahl.
3. Option y Wenn der Befehl in einer Sandbox-Umgebung ausgeführt wird, gewährleistet er die Systemsicherheit.

Lokaler Betrieb garantiert Datenschutz

Open Codex arbeitet lokal und benötigt keine Internetverbindung. Benutzerdaten und generierte Inhalte werden nicht in die Cloud hochgeladen, was für Szenarien mit hohen Datenschutzanforderungen geeignet ist. Zum Beispiel:

• Generieren Sie Befehle oder Code in einer Offline-Umgebung.
• Vermeiden Sie Datenverluste bei der Bearbeitung sensibler Projekte.

Plug-in-Erweiterungen

Entwickler können Plug-in-Erweiterungen erstellen:

1. Erstellen Sie im Stammverzeichnis des Projekts die Datei plugins Mappe.
2. Schreiben Sie das Plugin gemäß der Dokumentation (siehe das GitHub-Repository für die CONTRIBUTING.md).
3. Starten Sie Open Codex neu und das Plugin wird automatisch geladen.

caveat

• Stellen Sie sicher, dass Python 3.8 oder höher installiert ist.
• Die Installation von Homebrew oder pipx erfordert ein stabiles Netzwerk.
• Die Installation des Quellcodes muss manuell aktualisiert werden, und es wird empfohlen, sie regelmäßig durchzuführen. git pull.
• Das Tool befindet sich in der Entwicklungsphase und kann noch unfertige Funktionen haben, daher empfehlen wir, die GitHub Issues im Auge zu behalten.
• Die Erzeugung komplexer Befehle kann durch die Fähigkeiten des Modells begrenzt sein, so dass der Benutzer die Genauigkeit der Befehle überprüfen muss.

Anwendungsszenario

1. Schnelle Befehlsgenerierung
   Der Entwickler vergisst den spezifischen Shell-Befehl (z. B. unzip tar.gz) und gibt open-codex "解压 tar.gz 文件"Siehe tar -xzf file.tar.gz und Umsetzung.
2. Offline-Entwicklung
   Entwickler verwenden Open Codex, um Shell-Skripte oder Python-Code in netzunabhängigen Umgebungen zu erstellen und so die Privatsphäre des Projekts zu schützen.
3. Systemverwaltung
   Eingaben des Administrators open-codex "查找占用磁盘空间最大的文件"Siehe du -ah | sort -rh | headfinden Sie das Problem schnell.
4. Shell-Scripting lernen
   Eingabe für Anfänger open-codex "用 Bash 写一个监控CPU的脚本"erhalten Sie Beispielcode und lernen Skripterstellung.
5. Entwicklung der Gemeinschaft
   Entwickler tragen über GitHub neue Funktionen bei, z. B. das Hinzufügen neuer Modelle oder die Optimierung der Befehlsgenerierungslogik.

QA

1. Wie genau ist die natürliche Sprache bei Shell-Befehlen?
   Die Genauigkeit hängt von den Fähigkeiten des Modells ab. phi-4-mini kann gewöhnliche Aufgaben bewältigen, und bei komplexen Befehlen wird dem Benutzer empfohlen, die generierten Ergebnisse zu überprüfen.
2. Werden andere Terminalbefehle unterstützt?
   Die Hauptunterstützung ist für Shell-Befehle (bash/zsh), mit möglichen zukünftigen Erweiterungen für PowerShell, usw. Siehe die GitHub Roadmap für Details.
3. Wie gehe ich mit dem Befehl Fehler generieren um?
   Nach der Überprüfung des Befehls wählen Sie n die Aufhebung der Zwangsvollstreckung, oder durch open-codex --history Überprüfen Sie die Historie und widerrufen Sie sie gegebenenfalls.
4. Unterstützt es mehrsprachige Eingaben?
   Derzeit optimiert für die chinesische und englische Eingabe, andere Sprachen erfordern möglicherweise genauere Beschreibungen.
5. Wie gebe ich Feedback zu einem Problem?
   Besuchen Sie das GitHub-Repository (https://github.com/codingmoh/open-codex), um Issues oder Pull Requests einzureichen.