Zi

Gestisci i tuoi plugin Zsh, gli snippet e gli strumenti da riga di comando.

Avvio rapido  ·  Documentazione  ·  Release  ·  Discussioni

Zi è il plugin manager dell'ecosistema Z-Shell, precedentemente noto come zplugin e zinit.

Funzionalità

• Avvio reattivo: rimanda il caricamento dei plugin a dopo il primo prompt con la modalità Turbo.
• Sorgenti flessibili: carica plugin, script, completamenti e artefatti di release.
• Controllo sul caricamento: usa i modificatori ice per configurare download, build e aggiornamenti.
• Gestione degli strumenti: installa strumenti da riga di comando senza accesso root.
• Estensioni: aggiungi funzionalità tramite le annex di Zi.

Requisiti

Usa Zsh con Git disponibile nel PATH. L'installer di avvio rapido utilizza anche curl e una shell POSIX. I plugin e gli strumenti che installi possono avere dipendenze proprie.

Avvio rapido

1. Installa Zi

L'installer ufficiale installa Zi con il profilo loader predefinito e aggiunge una breve voce di sorgente gestita a .zshrc (vedi la pagina di installazione canonica):

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

[!IMPORTANT] Esamina il sorgente dell'installer e il suo checksum SHA-256 pubblicato prima di eseguire uno script di installazione remoto.

2. Aggiungi i tuoi primi plugin

Aggiungi questi comandi a .zshrc dopo la voce di sorgente gestita dall'installer. Questo esempio carica uno snippet di Oh My Zsh, i suggerimenti dei comandi e l'evidenziazione sintattica veloce:

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

snippet carica uno script autonomo. light carica un plugin. Il primo caricamento scarica eventuali repository o snippet mancanti.

3. Ricarica Zsh

exec zsh -il

Esegui zi -h per esplorare i comandi disponibili. Per installer alternativi, configurazione manuale, completamenti e passaggi post-installazione, consulta la guida all'installazione completa.

Impara con le attività

• Carica plugin e snippet: panoramica generale.
• Scegli come caricare le dipendenze: modificatori ice.
• Configura percorsi e comportamento: guida alla configurazione.
• Aggiorna, ispeziona e scarica: riferimento dei comandi.
• Trova plugin e annex: catalogo dell'ecosistema.
• Comprendi l'avvio della shell: riferimento ufficiale ai file di avvio di Zsh.

Per installer automatizzati e interfacce terminale, usa il contratto di integrazione del setup, incluse le fasi di pianificazione/applicazione, i risultati e la gestione degli eventi.

Community e supporto

• Fai domande sull'utilizzo nelle Discussioni Z-Shell.
• Segnala difetti riproducibili tramite le issue di Zi.
• Sfoglia release e changelog nella pagina delle release.
• Esplora la più ampia organizzazione Z-Shell.

Contribuire

I contributi sono benvenuti. Leggi la guida ai contributi per il modello di branch e il processo di rilascio prima di aprire una issue o una pull request. Consulta il workflow Zsh per i controlli di sintassi e regressione mirati utilizzati per verificare un checkout. Il lavoro di sviluppo è indirizzato al branch next, mentre main contiene le release di produzione.

Sicurezza

Segui la politica di sicurezza Z-Shell per segnalare vulnerabilità in privato. Non divulgare una vulnerabilità in una issue pubblica prima che sia disponibile una correzione.

Licenza

Zi è disponibile sotto la Licenza MIT.