Zi

Управляйте плагинами Zsh, сниппетами и инструментами командной строки.

Быстрый старт  ·  Документация  ·  Релизы  ·  Обсуждения

Zi — менеджер плагинов экосистемы Z-Shell, ранее известный как zplugin и zinit.

Возможности

• Отзывчивый запуск: отложите загрузку плагинов до появления первого приглашения с помощью режима Turbo.
• Гибкие источники: загружайте плагины, скрипты, дополнения и артефакты релизов.
• Контроль загрузки: используйте модификаторы ice для настройки загрузок, сборок и обновлений.
• Управление инструментами: устанавливайте инструменты командной строки без прав root.
• Расширения: добавляйте возможности с помощью аннексов Zi.

Требования

Используйте Zsh с доступным в PATH Git. Установщик быстрого старта также использует curl и POSIX-совместимую оболочку. Устанавливаемые плагины и инструменты могут иметь собственные зависимости.

Быстрый старт

1. Установите Zi

Официальный установщик устанавливает Zi с профилем загрузчика по умолчанию и добавляет одну короткую управляемую запись источника в .zshrc (см. каноническую страницу установки):

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

[!IMPORTANT] Перед запуском скрипта удалённой установки ознакомьтесь с исходным кодом установщика и его опубликованной контрольной суммой SHA-256.

2. Добавьте первые плагины

Добавьте эти команды в .zshrc после управляемой записи источника установщика. Этот пример загружает сниппет Oh My Zsh, подсказки команд и быстрое подсвечивание синтаксиса:

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

snippet загружает отдельный скрипт. light загружает плагин. При первой загрузке скачиваются все отсутствующие репозитории или сниппеты.

3. Перезагрузите Zsh

exec zsh -il

Выполните zi -h, чтобы изучить доступные команды. Об альтернативных установщиках, ручной настройке, дополнениях и шагах после установки см. полное руководство по установке.

Обучение по задачам

• Загрузка плагинов и сниппетов: общий обзор.
• Выбор способа загрузки зависимостей: модификаторы ice.
• Настройка путей и поведения: руководство по конфигурации.
• Обновление, просмотр и выгрузка: справочник команд.
• Поиск плагинов и аннексов: каталог экосистемы.
• Понимание запуска оболочки: официальный справочник по стартовым файлам Zsh.

Для автоматизированных установщиков и терминальных интерфейсов используйте контракт интеграции установки, включая фазы plan/apply, результаты и обработку событий.

Сообщество и поддержка

• Задавайте вопросы по использованию в Z-Shell Discussions.
• Сообщайте о воспроизводимых дефектах через issues Zi.
• Просматривайте релизы и списки изменений на странице релизов.
• Изучите более широкую организацию Z-Shell.

Участие в разработке

Мы приветствуем вклад. Прочитайте руководство по участию о модели веток и процессе релизов, прежде чем открывать issue или pull request. См. рабочий процесс Zsh для проверок синтаксиса и целевых регрессионных тестов, используемых для проверки рабочей копии. Разработка ведётся в ветке next, тогда как main содержит production-релизы.

Безопасность

Пожалуйста, следуйте политике безопасности Z-Shell, чтобы сообщать об уязвимостях приватно. Не раскрывайте уязвимость в публичном issue до появления исправления.

Лицензия

Zi доступен под лицензией MIT.