Reference OS v8 5 دقائق قراءة ٢٨ مايو ٢٠٢٦ شرح مشروع GitHub حديث وطريقة تركيبه واستخدامه عملياً للجمهور العربي snow-cli: دليل تركيب واستخدام وكيل AI برمجي في الطرفية يدعم OpenAI وGemini وClaude في…
Agentic coding in your terminal,Simultaneously compatible with OpenAI, Gemini, and Claude.运行在终端的 AI 编程智能体，同时兼容 Deepseek、OpenAI、Gemini和Claude。
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تظن أن أدوات AI البرمجية معقدة وتحتاج خبرة؟ snow-cli مصمم للمبتدئين: أمر واحد في الطرفية يمنحك وكيلاً ذكياً يدعم أشهر النماذج.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت مطوراً عربياً تبحث عن أداة AI برمجية تعمل في الطرفية وتدعم أكثر من مزود، فـ snow-cli هو ما تحتاجه. هذه الأداة تتيح لك التفاعل مع نماذج OpenAI وGemini وClaude مباشرة من سطر الأوامر، دون الحاجة إلى واجهة معقدة. في هذا الدليل، سنأخذك من الصفر إلى أول نتيجة عملية في أقل من 15 دقيقة.
لا تقلق إذا كنت جديداً في استخدام الطرفية أو لم تتعامل مع أدوات CLI من قبل. سنشرح كل خطوة بالتفصيل، مع أمثلة واقعية وأخطاء شائعة وحلولها. هدفنا أن تجرب الأداة بنفسك وتقرر إن كانت تناسب احتياجاتك.
snow-cli هو أداة طرفية (CLI) مفتوحة المصدر، مكتوبة بلغة TypeScript، تتيح لك استخدام نماذج AI متعددة (OpenAI، Gemini، Claude، Deepseek) لمساعدتك في مهام البرمجة. بدلاً من فتح متصفح والذهاب إلى ChatGPT، يمكنك البقاء في الطرفية والحصول على مساعدة فورية.
يناسبك إذا:
لا يناسبك إذا:
node -v و npm -v.npm install -g snow-aisnow --version، يجب أن يظهر رقم الإصدار.إذا واجهت مشكلة في التثبيت العالمي، يمكنك استنساخ المستودع وتثبيته محلياً:
git clone https://GitHub.com/MayDay-wpf/snow-cli.git
cd snow-cli
npm install
npm linkللاستخدام، تحتاج إلى تعيين مفتاح API لمزود واحد على الأقل. أنشئ ملفاً اسمه .env في المجلد الرئيسي للمشروع (أو في مجلد المستخدم) وأضف:
# اختر مزوداً واحداً على الأقل
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# أو
GEMINI_API_KEY=AIzaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# أو
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxيمكنك أيضاً تعيين المتغيرات مباشرة في الطرفية (مؤقتاً):
export OPENAI_API_KEY=sk-xxx # Linux/Mac
set OPENAI_API_KEY=sk-xxx # Windows CMDبعد إعداد المفتاح، جرب أمراً بسيطاً:
snow "اكتب دالة JavaScript تجمع رقمين"إذا ظهر رد، فالأداة تعمل. يمكنك تحديد المزود بوسيط --provider:
snow --provider gemini "اشرح هذا الكود: console.log('hello')"snow "اكتب دالة تأخذ مصفوفة أرقام وتُرجع مجموعها"النتيجة المتوقعة: كود JavaScript جاهز للنسخ.
snow --provider claude "اكتب سكريبت Bash يحذف الملفات المؤقتة (.tmp) من المجلد الحالي"snow --provider gemini "اشرح هذا الكود: const x = 5; console.log(x * 2);"نعم، خاصة إذا كنت تبحث عن أداة خفيفة ومجانية (باستثناء تكلفة API) تدعم نماذج متعددة. لكنها ليست بديلاً عن Copilot إذا كنت تريد تكاملاً عميقاً مع IDE. جربها لمدة أسبوع وقرر.
الأداة نفسها مجانية ومفتوحة المصدر، لكن استخدام API يتطلب اشتراكاً مدفوعاً لدى مزود AI (لكل مزود حد مجاني قد يكون كافياً للبدء).
OpenAI (GPT-4, GPT-3.5)، Gemini (Pro)، Claude (Sonnet, Haiku)، Deepseek.
لا، لأنه يعتمد على API خارجي.
تأكد من تثبيت snow-cli عالمياً (npm install -g snow-ai) أو استخدم npx snow.
أعد تشغيل أمر التثبيت: npm install -g snow-ai@latest.
نعم، لكن لا تشارك مفاتيح API. الأداة لا ترسل الكود المحلي لأي جهة غير مزود AI.
Copilot مدمج في IDE ويقترح كوداً أثناء الكتابة. snow-cli يعمل في الطرفية ويحتاج إلى أمر صريح.
يدعم النصوص العربية كمدخلات ومخرجات، لكن الوثائق بالإنكليزية.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ snow-cli يعتمد على Node.js، وnpm يأتي معه لإدارة الحزم.
كيف؟ حمل من nodejs.org، ثم تحقق بـ node -v و npm -v.
الناتج: ظهور رقم الإصدار لكليهما.
لماذا؟ التثبيت العالمي يتيح استخدام الأمر snow من أي مجلد.
كيف؟ شغّل: npm install -g snow-ai (قد تحتاج sudo على Linux/Mac).
الناتج: رسالة نجاح التثبيت.
لماذا؟ للتأكد من أن الأمر snow متاح.
كيف؟ شغّل: snow --version
الناتج: رقم الإصدار مثل 1.0.0.
لماذا؟ الأداة تحتاج مفتاح API للتواصل مع مزود AI.
كيف؟ أنشئ ملف .env في مجلد المستخدم أو المشروع، وأضف OPENAI_API_KEY=sk-... أو GEMINI_API_KEY=... أو ANTHROPIC_API_KEY=...
الناتج: ملف .env بمفتاح واحد على الأقل.
لماذا؟ لاختبار أن كل شيء يعمل.
كيف؟ شغّل: snow "اكتب دالة JavaScript تجمع رقمين"
الناتج: رد من AI يحتوي على الكود المطلوب.
حوّل القراءة إلى تنفيذ سريع
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx GEMINI_API_KEY=AIzaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
snow --provider gemini "اشرح هذا الكود: console.log('hello')"اعرف أين يتعثر الناس وكيف تتجنب ذلك
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تبحث عن أداة CLI خفيفة تدعم نماذج متعددة
إذن: استخدم snow-cli.
إذا: إذا كنت تريد تكاملاً عميقاً مع IDE
إذن: استخدم GitHub Copilot أو أدوات مشابهة.
إذا: إذا لم يكن لديك مفتاح API
إذن: احصل على مفتاح من مزود AI (معظمهم يوفر حداً مجانياً).
إذا: إذا ظهر خطأ command not found
إذن: أعد التثبيت عالمياً أو استخدم npx.
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
1. snow-cli مكتوب بلغة TypeScript.
2. يدعم OpenAI (GPT-4, GPT-3.5)، Gemini، Claude، Deepseek.
3. التثبيت عبر npm install -g snow-ai.
4. يتطلب Node.js 14+.
5. مفتوح المصدر على GitHub (MayDay-wpf/snow-cli).
6. مجتمع نشط على Telegram وQQ.
7. لا يعمل بدون اتصال إنترنت.
8. الأداة مجانية لكن استخدام API قد يكون مدفوعاً.
إجابات مباشرة على ما يبحث عنه الزائر
تعريفات مختصرة تمنع الالتباس
واجهة سطر الأوامر، تتيح التفاعل مع البرنامج عبر كتابة أوامر نصية.
مفتاح سري يمنحك صلاحية الوصول إلى خدمة AI عبر الإنترنت.
مدير حزم Node.js، يستخدم لتثبيت الحزم البرمجية مثل snow-cli.
شركة تقدم نماذج AI مثل GPT-4 وGPT-3.5.
نموذج AI من Google، متاح عبر API.
نموذج AI من Anthropic، يركز على الأمان والتحليل.
استخدمها كمسارات متابعة داخل نفس الموضوع
تحول القارئ: من مبتدئ يظن أن أدوات AI CLI معقدة إلى مستخدم قادر على تركيب وتشغيل snow-cli واستخدامه في مهام برمجية يومية.
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
snow-cli أداة بسيطة لكنها قوية لمن يعمل في الطرفية. باتباع هذا الدليل، تكون قد قطعت شوطاً كبيراً في فهم كيفية تركيبها واستخدامها. الآن، جربها بنفسك، وشارك تجربتك مع زملائك. تذكر أن الممارسة هي المفتاح.
هل لديك سؤال أو مشكلة؟ اترك تعليقاً أو انضم إلى مجتمع snow-cli على Telegram. ولا تنسَ متابعة المستودع على GitHub للحصول على آخر التحديثات.
حتى يبقى المرجع صالحاً مع الوقت
FAQ
استمر في القراءة
