zoxide

إذا كنت تنتقل يوميًا بين مجلدات مشاريع طويلة الأسماء، فقد تقضي وقتًا في كتابة المسار أكثر من بدء المهمة نفسها. zoxide أداة صغيرة تتعلم المجلدات التي تزورها، وتتيح العودة إليها بكلمات قصيرة. قيمتها في التنقل التفاعلي داخل الطرفية؛ لا تستبدل معرفة مكان تنفيذ الأمر، خصوصًا قبل تغيير ملفات أو تشغيل نشر.

🧭 ما zoxide؟

يصفها مطورها Ajeet D'Souza بأنها بديل أذكى لأمر cd. تتكامل مع الصدفة وتحتفظ بسجل للمجلدات التي تستخدمها، ثم تختار وجهة مطابقة لاستعلامك. الأمر المعتاد هو z، ويمكن استخدام zi للاختيار التفاعلي عند توفر fzf. التفاصيل في المستودع الرسمي، الذي راجعناه في 28 أكتوبر 2026.

الرسوم هنا توضيحية أصلية، وليست لقطات منتج أو نتائج تجربة فعلية.

🌟 كيف تختار المجلد المطلوب؟

1. كلمات قليلة بدل المسار الكامل

بعد زيارة مجلد بالطريقة المعتادة، تستطيع استخدام z foo للانتقال إلى أعلى مجلد مطابق ترتيبًا. ومع z foo bar تضيق البحث إلى مسار يحتوي الكلمتين. توضح خوارزمية المطابقة الرسمية أن ترتيب الكلمات داخل المسار مهم، وأن ترتيب النتائج يعتمد على تكرار الاستخدام وحداثته.

هذا ليس بحثًا شاملًا في كل ملفات القرص. إن كان المجلد جديدًا ولم يدخل السجل، فابدأ بزيارته بالمسار الصحيح. وفي مثال تعليمي، لو كان لديك مشروعان متشابهان، لا تفترض أن أقصر كلمة ستختار ما تقصده دائمًا. أضف كلمة تميّز المسار، ثم افحص الوجهة.

2. استخدم الاختيار التفاعلي عند التشابه

يعرض zi foo اختيارًا تفاعليًا باستخدام fzf. يفيد عندما تتشابه أسماء مشاريع أو توجد نسخ عمل متعددة. راجع اسم المسار الذي تختاره بدل الاعتماد على موضعه في القائمة؛ ترتيب الاستخدام قد يتغير مع الوقت.

في حالة توضيحية، لديك نسخة تجارب ونسخة عمل من مشروع واحد. ابحث بالاسم، واختر النسخة المقصودة، ثم نفّذ pwd قبل أمر حساس. هذه قاعدة استخدام نقترحها، وليست وعدًا بأن الأداة تمنع اختيار مجلد غير مقصود.

3. تحكّم في السجل المحلي

يمكن تحديد مكان قاعدة البيانات عبر _ZO_DATA_DIR، واستبعاد مسارات عبر _ZO_EXCLUDE_DIRS، وإظهار الوجهة قبل الانتقال عبر _ZO_ECHO. توضع متغيرات الإعداد قبل استدعاء التهيئة؛ يشرحها قسم Configuration في المستودع. الاستبعاد ينظم ما يُسجَّل، لكنه ليس وسيلة للتحكم في أذونات الملفات أو حمايتها.

🚀 التثبيت والتهيئة

يوثق المصدر تثبيت macOS عبر Homebrew. الأوامر التالية أمثلة تعليمية؛ لم نثبّت الأداة أو نغيّر إعداد الطرفية على جهازك:

brew install zoxide
zoxide --version

على Zsh، أضف سطر التهيئة التالي مرة واحدة إلى ملف إعدادك، عادة ~/.zshrc، وفق التعليمات الرسمية. هذا السطر يشغّل الشفرة التي يولدها برنامج zoxide المثبّت عند بدء الصدفة؛ راجع مصدر الحزمة ولا تنسخ تهيئة من جهة مجهولة.

eval "$(zoxide init zsh)"

إذا كنت تستخدم إكمال Zsh، تذكر الوثائق وضع التهيئة بعد compinit. لا تحتاج إلى حذف ملفات إعدادك أو إعادة بنائها بالكامل من أجل إضافة هذا السطر. افتح جلسة جديدة وتأكد أن الأمر متاح. أما Bash وFish وPowerShell وغيرها فلها أسطر تهيئة مختلفة؛ اختر قسم صدفتك بالاسم بدل نسخ سطر Zsh.

الخيار التفاعلي يحتاج fzf؛ الحد الأدنى المذكور في README وقت المراجعة هو v0.51.0. استعمال z العادي لا يتطلب اعتماد نفس واجهة الاختيار التفاعلية. وتوثق الصفحة تثبيت Windows عبر winget install ajeetdsouza.zoxide وخيارات أخرى للأنظمة المختلفة؛ راجع نسخ الحزم المتاحة لنظامك.

🪜 مثال متكامل: الرجوع إلى مشروع معروف

هذا سيناريو مقترح، لا تجربة منفّذة. افترض أنك تعمل على مجلد تجريبي اسمه docs-sandbox تحت مجلد المشاريع. استبدل المسار باسم موجود عندك؛ لا تنشئ مجلدًا أو تحذف شيئًا لمجرد مطابقة المثال:

cd ~/projects/docs-sandbox
pwd
cd ~
z docs-sandbox
pwd

السطر الأول يزور المجلد المعروف، والأخير يساعدك في التأكد من أنك عدت إلى الوجهة المقصودة. إذا لم تتطابق النتيجة، لا تكمل أوامر البناء أو التعديل: استخدم cd بالمسار الصريح أولًا، ثم راجع التهيئة ونطاق المطابقة. وإن كان الاسم ملتبسًا، استخدم اختيار zi بعد تثبيت متطلبه.

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

⚖️ متى تفيد مقارنة بالأسماء المستعارة؟

هذه مقارنة استخدام مقترحة، بلا نسبة توفير وقت أو اختبار أداء. في سكربت نشر أو مهمة آلية تحتاج وجهة ثابتة، نوصي بمسار صريح والتحقق منه؛ سجل استعمال شخص واحد ليس عقدًا مناسبًا لتحديد مشروع على كل أجهزة الفريق.

🔗 التوافق والتكامل مع مساعد برمجي

دعم الصدف لا يعني أن كل جلسة طرفية تملك إعدادك. قد يعمل أمر z في طرفيتك بينما لا يكون معرّفًا في جلسة غير تفاعلية يستدعيها مساعد. عند توجيه مساعد إلى مشروع، أعطه المسار الصريح وتحقق من مجلد عمله؛ لا تفترض أن تثبيت zoxide يضيف أداة MCP أو يمنح صلاحية جديدة.

يعرض المستودع تكاملات إضافية من أطراف أخرى، لكنها ليست جزءًا واحدًا تضمنه هذه البطاقة. لم نختبر تكاملًا مع محرر أو مدير ملفات. ابدأ بالأمر الأساسي، ثم قيّم التكامل الذي تحتاجه وصلاحياته منفصلًا.

💰 التكلفة والخصوصية والحدود

zoxide مفتوح المصدر بترخيص MIT. التنقل والسجل محليان، ولا يحتاجان اشتراك نموذج أو API مدفوعًا. التثبيت والتحديث قد يحتاجان شبكة. قاعدة البيانات تحتوي مسارات يمكن أن تكشف أسماء مشاريع أو عملاء؛ لا تضعها في مستودع عام أو تنقلها إلى خدمة لمجرد أنها ليست محتويات الملفات.

لا تنقل الأداة الملفات، ولا تدير نسخ Git، ولا تكتشف تلقائيًا أن نسختين من مشروع تستهدفان بيئتين مختلفتين. ميزتها هي الوصول إلى مجلد؛ سلامة الأوامر التي تنفذها بعد ذلك تبقى مسؤوليتك. وإذا كنت تستخدم مجلدات قليلة ثابتة فقط، قد تكفي أوامر cd والأسماء المستعارة دون أداة إضافية.

📚 المصادر وتاريخ التحقق

• المستودع والتثبيت والإعداد.
• خوارزمية المطابقة والترتيب.
• الإصدارات: الإصدار الظاهر v0.10.0 وقت الفحص.

تاريخ الاطلاع 28 أكتوبر 2026. رصد GitHub أظهر 40334 نجمة و934 تفرعًا، وآخر دفع 24 أكتوبر؛ ليست هذه الأرقام تقييمًا للجودة. تحققنا من الوثائق ومصادر الإصدار، ولم نُجرِ تجربة تثبيت أو قبول عملي على نظام معين.