Zi

أدر إضافات Zsh والمقتطفات وأدوات سطر الأوامر الخاصة بك.

بداية سريعة  ·  التوثيق  ·  الإصدارات  ·  المناقشات

Zi هو مدير الإضافات الخاص بمنظومة Z-Shell، وكان يُعرف سابقًا باسم zplugin و zinit.

الميزات

• بدء تشغيل سريع الاستجابة: أجّل تحميل الإضافات حتى بعد ظهور الموجّه الأول باستخدام وضع Turbo.
• مصادر مرنة: حمّل الإضافات والسكربتات والإكمالات ومخرجات الإصدارات.
• التحكم في التحميل: استخدم معدّلات ice لضبط التنزيلات والبناء والتحديثات.
• إدارة الأدوات: ثبّت أدوات سطر الأوامر دون صلاحيات الجذر.
• الامتدادات: أضف قدرات عبر ملاحق Zi.

المتطلبات

استخدم Zsh مع توفر Git في PATH. كما يستخدم مثبّت البداية السريعة 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 الرسمي.

للمثبّتات الآلية والواجهات الطرفية، استخدم عقد تكامل الإعداد، بما في ذلك مراحل التخطيط/التطبيق والنتائج ومعالجة الأحداث.

المجتمع والدعم

• اطرح أسئلة الاستخدام في Z-Shell Discussions.
• أبلغ عن العيوب القابلة لإعادة الإنتاج عبر مشكلات Zi.
• تصفّح الإصدارات وسجلات التغييرات على صفحة الإصدارات.
• استكشف منظمة Z-Shell الأوسع.

المساهمة

المساهمات مرحّب بها. اقرأ دليل المساهمة للاطلاع على نموذج الفروع وعملية الإصدار قبل فتح مشكلة أو طلب سحب. راجع سير عمل Zsh لفحوصات الصياغة والاختبارات الانحدارية المركزة المستخدمة للتحقق من نسخة مستخرجة. تستهدف أعمال التطوير فرع next، بينما يحتوي main على إصدارات الإنتاج.

الأمان

يرجى اتباع سياسة أمان Z-Shell للإبلاغ عن الثغرات بشكل خاص. لا تفصح عن ثغرة في مشكلة عامة قبل توفر إصلاح.

الترخيص

Zi متاح بموجب ترخيص MIT.