Zi

Verwalte deine Zsh-Plugins, Snippets und Kommandozeilen-Tools.

Schnellstart  ·  Dokumentation  ·  Releases  ·  Diskussionen

Zi ist der Plugin-Manager des Z-Shell-Ökosystems, früher bekannt als zplugin und zinit.

Funktionen

• Reaktionsschneller Start: Verzögere das Laden von Plugins bis nach dem ersten Prompt mit dem Turbo-Modus.
• Flexible Quellen: Lade Plugins, Skripte, Vervollständigungen und Release-Artefakte.
• Kontrolle über das Laden: Verwende Ice-Modifikatoren, um Downloads, Builds und Updates zu konfigurieren.
• Tool-Verwaltung: Installiere Kommandozeilen-Tools ohne Root-Zugriff.
• Erweiterungen: Füge Funktionen durch Zi-Annexe hinzu.

Voraussetzungen

Verwende Zsh mit Git, das im PATH verfügbar ist. Der Schnellstart-Installer verwendet außerdem curl und eine POSIX-Shell. Plugins und Tools, die du installierst, können eigene Abhängigkeiten haben.

Schnellstart

1. Zi installieren

Der offizielle Installer installiert Zi mit dem Standard-Loader-Profil und fügt einen kurzen verwalteten Quelleneintrag zu .zshrc hinzu (siehe die kanonische Installationsseite):

sh -c "$(curl -fsSL get.zshell.dev)" --

[!IMPORTANT] Überprüfe die Installer-Quelle und ihre veröffentlichte SHA-256-Prüfsumme, bevor du ein Remote-Installationsskript ausführst.

2. Deine ersten Plugins hinzufügen

Füge diese Befehle nach dem verwalteten Quelleneintrag des Installers zu .zshrc hinzu. Dieses Beispiel lädt ein Oh My Zsh-Snippet, Befehlvorschläge und schnelles Syntax-Highlighting:

# ~/.zshrc
zi snippet OMZ::plugins/git/git.plugin.zsh
zi light zsh-users/zsh-autosuggestions
zi light z-shell/F-Sy-H

snippet lädt ein eigenständiges Skript. light lädt ein Plugin. Beim ersten Laden werden alle fehlenden Repositories oder Snippets heruntergeladen.

3. Zsh neu laden

exec zsh -il

Führe zi -h aus, um die verfügbaren Befehle zu erkunden. Für alternative Installer, manuelle Einrichtung, Vervollständigungen und Schritte nach der Installation siehe die vollständige Installationsanleitung.

Nach Aufgaben lernen

• Plugins und Snippets laden: allgemeine Übersicht.
• Wählen, wie Abhängigkeiten geladen werden: Ice-Modifikatoren.
• Pfade und Verhalten konfigurieren: Konfigurationsanleitung.
• Aktualisieren, inspizieren und entladen: Befehlsreferenz.
• Plugins und Annexe finden: Ökosystem-Katalog.
• Shell-Start verstehen: offizielle Zsh-Referenz zu Startdateien.

Für automatisierte Installer und Terminal-Oberflächen verwende den Setup-Integrationsvertrag, einschließlich Plan-/Apply-Phasen, Ergebnissen und Ereignisbehandlung.

Community und Support

• Stelle Nutzungsfragen in den Z-Shell-Diskussionen.
• Melde reproduzierbare Defekte über Zi-Issues.
• Durchsuche Releases und Changelogs auf der Release-Seite.
• Erkunde die größere Z-Shell-Organisation.

Mitwirken

Beiträge sind willkommen. Lies den Beitragsleitfaden für das Branch-Modell und den Release-Prozess, bevor du ein Issue oder einen Pull-Request öffnest. Siehe den Zsh-Workflow für die Syntax- und fokussierten Regressionstests, die zur Überprüfung eines Checkouts verwendet werden. Entwicklungsarbeit zielt auf den next-Branch ab, während main Produktions-Releases enthält.

Sicherheit

Bitte befolge die Z-Shell-Sicherheitsrichtlinie, um Schwachstellen privat zu melden. Offenbare eine Schwachstelle nicht in einem öffentlichen Issue, bevor ein Fix verfügbar ist.

Lizenz

Zi ist unter der MIT-Lizenz verfügbar.