Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

تجربة استخدام Gemini CLI

1. مقدمة

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

ما ستتعلمه

تثبيت Gemini CLI وضبط إعداداته
استكشاف الأدوات والأوامر المضمّنة وإعداد خوادم MCP في Gemini CLI
تخصيص Gemini CLI من خلال ملف GEMINI.md
استكشاف بعض حالات الاستخدام مع Gemini CLI

المتطلبات

يمكن تنفيذ هذا الدرس التطبيقي حول الترميز بالكامل في Google Cloud Shell، الذي يأتي مثبَّتًا مسبقًا مع Gemini CLI.

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

ستحتاج إلى ما يلي:

متصفّح الويب Chrome
حساب Gmail

تم تصميم هذا الدرس التطبيقي حول الترميز للمستخدمين والمطوّرين من جميع المستويات (بما في ذلك المبتدئين). تم تصنيف حالات الاستخدام في الدرس التطبيقي حول الترميز إلى مهام للمطوّرين ومهام لغير المطوّرين. توضّح حالات استخدام المطوّرين كيفية كتابة الرمز البرمجي باستخدام Gemini CLI والعمل مع مستودع GitHub لتنفيذ مهام تطوير شائعة، مثل شرح الرمز البرمجي وفهمه وإنشاء المستندات وإصلاح المشاكل وغير ذلك. ننصحك بإكمال حالات الاستخدام هذه في الدرس التطبيقي حول الترميز. يتوفّر في النهاية قسم اختياري يتناول العديد من المهام اليومية التي لا تركّز على المطوّرين.

2. قبل البدء

إنشاء مشروع

في Google Cloud Console، ضمن صفحة اختيار المشروع، اختَر أو أنشِئ مشروعًا على Google Cloud.
تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. تعرَّف على كيفية التحقّق مما إذا كانت الفوترة مفعَّلة في مشروع.
ستستخدم Cloud Shell، وهي بيئة سطر أوامر تعمل في Google Cloud ومحمّلة مسبقًا بأداة bq. انقر على "تفعيل Cloud Shell" في أعلى "وحدة تحكّم Google Cloud".

صورة زر تفعيل Cloud Shell

بعد الاتصال بـ Cloud Shell، يمكنك التأكّد من إكمال عملية المصادقة وأنّ المشروع مضبوط على رقم تعريف مشروعك باستخدام الأمر التالي:

gcloud auth list

نفِّذ الأمر التالي في Cloud Shell للتأكّد من أنّ أمر gcloud يعرف مشروعك.

gcloud config list project

إذا لم يتم ضبط مشروعك، استخدِم الأمر التالي لضبطه:

gcloud config set project <YOUR_PROJECT_ID>

3- تثبيت

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

أنشئ مجلدًا نموذجيًا (gemini-cli-projects) وانتقِل إليه باستخدام الأوامر الموضّحة أدناه. إذا كنت تفضّل استخدام اسم مجلد آخر، يمكنك ذلك.

mkdir gemini-cli-projects

لننتقل إلى هذا المجلد:

cd gemini-cli-projects

يمكنك تشغيل Gemini CLI مباشرةً من خلال الأمر gemini.

يُرجى الانتقال مباشرةً إلى القسم التالي (ضبط إعدادات Gemini CLI من خلال ملف settings.json).

إذا أردت تثبيت Gemini CLI على جهازك، اتّبِع التعليمات الواردة أدناه. يُرجى العِلم أنّ Gemini CLI مثبّت مسبقًا على Cloud Shell ومحطات عمل Cloud.

الخطوة الأولى هي تثبيت Node 20+ على جهازك. بعد اكتمال ذلك، يمكنك تثبيت Gemini CLI وتشغيله باستخدام أيّ من الطرق التالية:

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

# option 1: install Gemini CLI

npm install -g @google/gemini-cli

# .. and then run
gemini

نفِّذها باستخدام الأمر التالي:

# option 2: run without installing Gemini CLI

npx https://github.com/google-gemini/gemini-cli

يمكنك التأكّد من تثبيت واجهة سطر الأوامر من خلال تنفيذ الأمر التالي:

gemini --version

بافتراض أنّك شغّلت Gemini CLI باستخدام أي من الطرق المذكورة أعلاه، قد يُطلب منك عند التشغيل الأول اختيار مظهر. إذا كان الأمر كذلك، يمكنك إما استخدام المظهر التلقائي أو اختيار مظهر من اختيارك.

الأمر المهم التالي هو المصادقة. سيُطلب منك تحديد طريقة المصادقة. ننصحك باستخدام حساب Google شخصي وليس حسابات غير تابعة لـ Google أو Google Workspace في هذه التجربة.

إذا بلغت الحدود القصوى للحصة المجانية الحالية الممنوحة لحسابات Google، يمكنك اختيار استخدام مفتاح Gemini API أو حتى Google Cloud Vertex AI، حيث ستحتاج إلى معرّف المشروع واسم الموقع الجغرافي لهذا المشروع. يُرجى الرجوع إلى قسم المصادقة في المستندات إذا كنت تخطّط لاستخدام طرق مصادقة أخرى.

انقر على "إدخال". سيؤدي ذلك إلى فتح صفحة "مصادقة Google" في المتصفّح. تابِع عملية المصادقة باستخدام حساب Google، واقبل البنود، وبعد إتمام عملية المصادقة بنجاح، ستلاحظ أنّ واجهة سطر الأوامر في Gemini جاهزة وتنتظر أمرك.

في ما يلي نموذج للقطة شاشة:

في هذه الحالة، اخترنا خيار Vertex AI، ولكن يمكن أن يكون الحساب الشخصي في حالتك. ستلاحظ أنّنا اخترنا نموذج Gemini 2.5 (يظهر في أسفل يسار الصفحة). يمكنك اختيار النموذج المحدّد في أي وقت باستخدام الأمر /model.

4. ضبط إعدادات Gemini CLI من خلال ملف settings.json

إذا اخترت Cloud Shell لتشغيل Gemini، سيتم تلقائيًا اختيار مظهر تلقائي لـ Gemini CLI وطريقة المصادقة وإعدادهما لك.

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

بعد ذلك، لن يُطلب منك اختيار مظهر وطريقة مصادقة مرة أخرى عند تشغيل Gemini CLI في المرات اللاحقة. هذا يعني أنّه يتم حفظه في مكان ما، ويُطلق على الملف الذي يستخدمه اسم settings.json، وهو الطريقة المتاحة لتخصيص Gemini CLI.

يتم تطبيق الإعدادات حسب الأولوية التالية (لا يتيح Cloud Shell سوى إعدادات المستخدم):

النظام: /etc/gemini-cli/settings.json (ينطبق على جميع المستخدمين، ويتجاهل إعدادات المستخدم والمساحة).
‫Workspace: .gemini/settings.json (تتجاوز إعدادات المستخدم).
المستخدم: ~/.gemini/settings.json

مستخدم Windows: %USERPROFILE%.gemini\settings.json (الذي يتم توسيعه عادةً إلى C:\Users<YourUsername>.gemini\settings.json)

النظام: %ProgramData%\gemini-cli\settings.json (الذي يتم توسيعه عادةً إلى C:\ProgramData\gemini-cli\settings.json)

مستخدم Mac: ‎~/.gemini/settings.json (الذي يتوسّع إلى ‎ /Users/<YourUsername>/.gemini/settings.json)

النظام: /etc/gemini-cli/settings.json

إذا تذكّرت، عند اختيار المظهر، اخترت حفظ الإعدادات في "إعدادات المستخدم". لذا، انتقِل إلى ~/.gemini folder وستلاحظ الملف settings.json.

يظهر ملف settings.json أدناه. إذا كنت قد اخترت مظهرًا آخر، سيظهر لك اسمه هناك.

{
  "security": {
    "auth": {
      "selectedType": "oauth-personal" or "cloud-shell"
    }
  },
  "ui": {
    "theme": "Default"
  }
}

5- تفاعلنا الأول مع Gemini CLI

لنبدأ باستخدام Gemini CLI ونكتب طلب البحث الأول كما هو موضّح أدناه:

Give me a famous quote on Artificial Intelligence and who said that?

تظهر الاستجابة المتوقّعة أدناه:

 > Give me a famous quote on Artificial Intelligence and who said that?                 
✦ "The only way to do great work is to love what you do." - Steve Jobs (While not directly about AI, it's a famous quote related to technology and innovation, which underpins AI development.)
Alternatively:
  "The development of full artificial intelligence could spell the end of the human race." - Stephen Hawking

للتعرّف بسرعة على Gemini CLI والأوامر المختلفة التي يتيحها، اكتب /help (شرطة مائلة للأمام) وستظهر لك مجموعة متنوعة من الأوامر واختصارات لوحة المفاتيح.

لنتوقف عن استخدام Gemini CLI في الوقت الحالي. يمكنك إجراء ذلك من خلال الأمر /quit أو من خلال تنفيذ الأمر Ctrl-C مرتين في جلسة طرفية تفاعلية في Gemini CLI. عند الخروج من Gemini CLI، ستظهر لك إحصاءات الجلسة التي تقدّم لك بعض المعلومات عن جلستك واستخدام النموذج والمقاييس الأخرى.

6. ‫Gemini CLI - مَعلمات الأوامر

هناك بعض مَعلمات سطر الأوامر التي يمكن تقديمها عند بدء استخدام Gemini CLI. للحصول على قائمة كاملة بالخيارات، يمكنك استخدام --help كما هو موضّح أدناه.

gemini --help

من المفترض أن يعرض هذا الخيار النطاق الكامل للخيارات المتاحة. ننصحك بالاطّلاع على المستندات هنا.

لنلقِ نظرة على بعضها. الخيار الأول هو ضبط إعدادات Gemini CLI لاستخدام وضع Gemini معيّن. في وقت تعديل هذه التجربة، إليك قائمة بالطُرز المتوافقة. لاستخدام نموذج معيّن، يمكنك إجراء ذلك عند بدء Gemini CLI من خلال المَعلمة -m كما هو موضّح أدناه:

gemini -m "gemini-2.5-flash"

ستلاحظ أنّه في حال البدء بالطريقة الموضّحة أعلاه، يمكنك التحقّق من النموذج في أسفل يسار نافذة أوامر Gemini CLI.

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

الوضع غير التفاعلي

من الخيارات المثيرة للاهتمام تشغيل Gemini CLI في وضع غير تفاعلي. وهذا يعني أنّك تقدّم الطلب مباشرةً وسيردّ عليه، بدون فتح نافذة الأوامر التفاعلية في Gemini CLI. يكون ذلك مفيدًا جدًا إذا كنت تخطّط لاستخدام Gemini CLI بطريقة آلية كجزء من النص البرمجي أو أي عملية أخرى تتم آليًا. يمكنك استخدام المَعلمة -p لتقديم الطلب إلى Gemini CLI كما هو موضّح أدناه:

gemini -p "What is the gcloud command to deploy to Cloud Run"

يُرجى العِلم أنّه لا يمكن مواصلة المحادثة من خلال طرح أسئلة متابعة. لا يسمح لك هذا الوضع أيضًا بمنح الإذن للأدوات (بما في ذلك WriteFile) أو بتنفيذ أوامر shell.

تذكَّر أنّه في حال عدم تضمين المَعلمة -p والاكتفاء بما يلي، سيتم فتح Gemini CLI مع الطلب والمتابعة داخل هذا التطبيق.

gemini "What is the gcloud command to deploy to Cloud Run"

7. ‫Gemini CLI - أدوات مدمجة

يتضمّن Gemini CLI مجموعة من الأدوات المضمّنة، وتنص مستندات الأدوات على أنّ "نموذج Gemini يستخدم هذه الأدوات للتفاعل مع بيئتك المحلية والوصول إلى المعلومات وتنفيذ الإجراءات. تعزّز هذه الأدوات إمكانات واجهة سطر الأوامر، ما يتيح لها تجاوز إنشاء النصوص والمساعدة في مجموعة كبيرة من المهام".

للحصول على قائمة بالأدوات المضمّنة الحالية، استخدِم الأمر /tools كما هو موضّح أدناه:

Available Gemini CLI tools:
  - Activate Skill (activate_skill)
  - Ask User (ask_user)
  - Edit (replace)
  - Enter Plan Mode (enter_plan_mode)
  - FindFiles (glob)
  - GoogleSearch (google_web_search)
  - Invoke Subagent (invoke_agent)
  - List Background Processes (list_background_processes)
  - Read Background Output (read_background_output)
  - ReadFile (read_file)
  - ReadFolder (list_directory)
  - SearchText (grep_search)
  - Shell (run_shell_command)
  - Update Topic Context (update_topic)
  - WebFetch (web_fetch)
  - WriteFile (write_file)

أحد الأسئلة التي يجب أن تطرحها على نفسك على الفور هو ما إذا كان بإمكان Gemini CLI ببساطة استدعاء هذه الأدوات عندما يريد ذلك. الإجابة التلقائية هي لا، وذلك عندما يتعلّق الأمر بعمليات حساسة قد تتضمّن الكتابة إلى النظام المحلي أو القراءة من نظام خارجي أو الانتقال إلى الشبكة الخارجية وما إلى ذلك.

على الرغم من توفّر --yolo عند بدء استخدام واجهة سطر الأوامر (لا يُنصح بذلك عادةً)، سيطلب منك Gemini CLI الإذن بتشغيل الأداة التي اختارها. يمكنك رفض الإذن أو السماح بتشغيل التطبيق مرة واحدة أو منحه إذنًا شاملاً بالتشغيل دائمًا. يجب أن تكون أنت المتحكّم بشكل كامل في كل شيء.

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

لنفترض أنّك تريد الحصول على معلومات حول آخر الأخبار المالية في جميع أنحاء العالم وحفظها في ملف في دليل العمل المحلي الذي شغّلت منه Gemini CLI. استخدِم الطلب التالي:

Search for the latest headlines today in the world of finance and save them in a file named finance-news-today.txt

لنفترض للحظة ما يجب أن تفعله. من المفترض أن تبحث على Google للحصول على أخبار من بعض مصادر المعلومات ذات الصلة التي يمكنها تقديم أخبار مالية. بعد ذلك، يجب إنشاء ملف باسم finance-news-today.txt (عملية كتابة على نظامك المحلي تتطلّب إذنك) يتضمّن محتواه.

لنلاحظ ما سيحدث (عليك اتّباع الخطوات نفسها على جهازك).

أول ما تفعله هو استدعاء أداة GoogleSearch للبحث على الويب واسترداد النتائج، كما هو موضّح أدناه:

 Searching for Finance News: 
  I will first search for the latest finance headlines and then save them to a file.
  ✓  GoogleSearch  Searching the web for: "latest finance headlines"
   → Search results for "latest finance headlines" returned.
  Saving Finance News: I will now save the finance headlines to the file 'finance-news-today.txt'.

بعد ذلك، يصبح جاهزًا لكتابة هذا المحتوى في الملف وسيستخدم أداة WriteFile، ولكن بما أنّ هذه العملية حساسة (كتابة)، سيطلب منك الإذن. يمكنك تحديد نوع الإذن، أي السماح مرة واحدة أو السماح دائمًا وما إلى ذلك. اختَر "السماح مرة واحدة" في الوقت الحالي.

سيؤدي ذلك إلى كتابة المعلومات في الملف وستظهر رسالة نجاح على النحو التالي:

✦ I have saved the latest finance news to finance-news-today.txt.
  Finance News Saved: The task is complete.

كيف يمكن التحقّق ممّا إذا كان الملف مكتوبًا أم لا؟ يمكنك استخدام @file لطلب قراءة المحتوى. أثناء كتابة @، ستظهر قائمة بالملفات في المجلد الحالي، وسيظهر الملف الذي تم إنشاؤه للتو. اختَر ذلك الخيار وأرسِل الطلب. يظهر طلبي أدناه:

read the contents of @finance-news-today.txt

يؤدي ذلك إلى استدعاء الأدوات المطلوبة (ReadManyFiles وReadFile) ويتم عرض المحتوى كما هو موضّح أدناه:

  ✓  ReadManyFiles  Attempting to read files from finance-news-today.txt → Read 1 file(s)
  Topic: Summarizing the financial news headlines.
✦ The latest finance headlines as of May 15, 2026, include:
  Global Markets & Economy:
   * The Dow Jones Industrial Average surpassed 50,000 for the first time, driven by strong earnings from Cisco
     Systems and a 2% rise in Nasdaq due to tech stocks.
   * Inflation concerns are growing, hinting at potential Fed interest rate hikes.
   * Kevin Warsh has been confirmed as the new Federal Reserve head.
   * A "constructive" U.S.-China summit took place in Beijing between President Trump and President Xi, with
     markets watching for impacts from proposed tariffs.
  Corporate & Tech News:
   
<REST OF THE CONTENT>

8. ‫Gemini CLI - وضع Shell

هذا هو الوقت المناسب للتعرّف على كيفية استخدام Shell مباشرةً من داخل Gemini CLI. يمكنك الانتقال إلى وضع الصدفة من خلال الضغط على ! في مربّع الرسالة. سيؤدي ذلك إلى التبديل إلى وضع Shell. يمكنك الرجوع إلى الصفحة السابقة بالضغط على ! مرة أخرى أو على المفتاح ESC.

عندما تكون في وضع shell، سترى ! في بداية الطلب كما هو موضّح أدناه:

يمكنك التحقّق مباشرةً باستخدام الأوامر العادية، مثل pwd وls كما هو موضّح أدناه. يُرجى العِلم أنّ الأوامر تفترض استخدام نظام تشغيل من نوع Linux. إذا كنت تستخدم نظام تشغيل آخر (Windows)، يُرجى استخدام الأوامر المكافئة، مثل (cd وdir وtype). يُرجى العلم أنّ ناتج هذه الطلبات مضمّن في قدرة استيعاب النموذج.

يمكنك أيضًا طباعة محتوى الملف باستخدام الأمر cat، أي cat finance-news-today.txt.

تمرين: إليك تمرينًا قصيرًا لتجربته. اختَر خلاصة RSS التي تريدها. قدِّم طلبًا إلى Gemini CLI لجلب محتوى خلاصة RSS وتنسيق النتائج بطريقة محدّدة. هذه طريقة جيدة لأتمتة إجراء معيّن في بداية اليوم. يمكنك حتى أن تطلب من Gemini CLI معرفة ما إذا كان هناك خلاصة RSS لمنطقة معيّنة، مثل ملاحظات إصدار Google Cloud Platform.

في ما يلي نموذج لطلب:

Get the latest release notes for Google Cloud from its RSS Feed and display the key points in a well-formatted list.

يجب أن يطلب هذا الطلب من الأداة GoogleSearch العثور على خلاصة RSS الخاصة بمنصة Google Cloud Platform، ثم تستخدم الأداة WebFetch للحصول على محتوى خلاصة RSS وعرضه. قد يُطلب منك منح أذونات لاستخدام هذه الأدوات، لذا يُرجى الموافقة على ذلك.

9- إضافات Gemini CLI

كما توضّح المستندات، تجمّع إضافات Gemini CLI الطلبات وخوادم MCP والأوامر المخصّصة في تنسيق مألوف وسهل الاستخدام. باستخدام الإضافات، يمكنك توسيع إمكانات Gemini CLI ومشاركتها مع الآخرين. وهي الآلية الأساسية لتوسيع وظائف Gemini CLI إلى ما هو أبعد من أدواته المضمّنة.

الإضافة هي حزمة مستقلة وقابلة للتحديث ويمكن توزيعها بسهولة. يمكنك اعتبارها "حاوية الشحن" لتخصيصات Gemini CLI، فهي تجمع كل ما يلزم لسير عمل محدّد في حزمة واحدة منظّمة.

يمكن أن تتضمّن الإضافة أي مجموعة من العناصر التالية:

أوامر مخصّصة تبدأ بشرطة مائلة (ملفات ‎ .toml).
إعدادات خادم MCP (التي كانت متوفّرة سابقًا في ملف settings.json)
ملفات السياق (GEMINI.md) لتقديم تعليمات وإرشادات محدّدة للنموذج
قيود الأدوات (excludeTools) لإنشاء بيئة أكثر أمانًا وتركيزًا

استكشاف "معرض الإضافات"

معرض الإضافات هو السوق المركزي لاستكشاف جميع الإضافات الرسمية التي أنشأتها Google وتلك التي أنشأتها جهات خارجية:

افتح عنوان URL التالي في المتصفّح: https://geminicli.com/extensions/
هذا المعرض هو محرك البحث عن التطبيقات في النظام المتكامل. يمكنك الاطّلاع على "الإضافات" من شركات مثل GitHub وRedis وDynaTrace، ما يوضّح مدى توفّر الأدوات.
مرِّر للأسفل وابحث عن بطاقة إضافة Cloud Run أو يمكنك الانتقال إلى هذا الرابط.
لاحظ أنّ البطاقة تقدّم وصفًا والمؤلف (Google) وزرّ أمر Copy بنقرة واحدة. هذه هي أبسط طريقة للحصول على أمر تثبيت إضافة.

إضافات Gemini CLI - أوامر الإدارة

الأمر gemini extensions هو نقطة الدخول لإدارة الإضافات المحلية.

شغِّله في الوحدة الطرفية للاطّلاع على قائمة الأوامر المتاحة.

gemini extensions <command>
Manage Gemini CLI extensions.
Commands:
  gemini extensions install <source> [--auto-update] [--pre-release]
    Installs an extension from a git repository URL or a local path.
  gemini extensions uninstall [names..]                      
    Uninstalls one or more extensions.
  gemini extensions list                                     
    Lists installed extensions.
  gemini extensions update [<name>] [--all]                  
    Updates all extensions or a named extension to the latest version.
  gemini extensions disable [--scope] <name>                 
    Disables an extension.
  gemini extensions enable [--scope] <name>                  
    Enables an extension.
  gemini extensions link <path>                              
    Links an extension from a local path. Updates made to the local path 
    will always be reflected.
  gemini extensions new <path> [template]                    
    Create a new extension from a boilerplate example.
  gemini extensions validate <path>                          
    Validates an extension from a local path.
  gemini extensions config [name] [setting]                  
    Configure extension settings.
Options:

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

التحقّق من قائمة الإضافات الحالية

قبل تثبيت أي شيء، لنراجع "اللوحة البيضاء".

نفِّذ الأمر gemini extensions list:
من المفترض أن تظهر لك النتيجة التالية التي تؤكّد أنّه لم يتم تثبيت أي إضافات بعد.

No extensions installed.

ضبط إعدادات خادم MCP على Cloud Run

إضافة Cloud Run المتوفّرة في معرض إضافات Gemini CLI هي MCP Server يتيح لنا نشر تطبيقاتنا على Cloud Run.

في ما يلي بطاقة "إضافة Cloud Run" من معرض "الإضافات":

لنبدأ أولاً بتثبيت إضافة Cloud Run من خلال النقر على نسخ أمر التثبيت كما هو موضّح أعلاه. بعد ذلك، الصِق هذا الأمر في وحدة Cloud Shell الطرفية (يجب أن يكون مشابهًا لما يلي):

gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp

عند تنفيذ الأمر أعلاه، سيظهر لك طلب تأكيد. يُرجى الموافقة على ذلك. سيطلب منك إضافة Cloud Run إدخال معرّف مشروعك على Google وموقع مشروعك على Google. يجب تقديم ذلك. بعد ذلك، من المفترض أن يتم تثبيت إضافة Cloud Run بنجاح.

إذا نفّذت الآن الأمر gemini extensions list، من المفترض أن ترى إضافة Cloud Run مثبَّتة كما هو موضّح أدناه:

✓ cloud-run (1.0.0)
 ID: 3c1a38909b6d7d90b6acc8ca1e80d97b4a867253a3cd12d841b2aab4e556a58f
 name: 0b1820c1f0c043bbb3b54f496d862c02172424c930eb965d61f468be52e6f127
 Path: /Users/romin/.gemini/extensions/cloud-run
 Source: https://github.com/GoogleCloudPlatform/cloud-run-mcp (Type: github-release)
 Release tag: v1.10.0
 Enabled (User): true
 Enabled (Workspace): true
 Context files:
  /Users/romin/.gemini/extensions/cloud-run/gemini-extension/GEMINI.md
 MCP servers:
  cloud-run
 Settings:
  Project ID: YOUR_GCP_PROJEC_ID (User - /Users/romin/.gemini/extensions/cloud-run/.env)
  Region: YOUR_GCP_PROJECT_LOCATION (User - /Users/romin/.gemini/extensions/cloud-run/.env)

إذا شغّلت Gemini CLI الآن ونفّذت الأمر /mcp list، سيظهر لك ما يلي. لاحظ الأدوات والطلبات في خادم MCP على Cloud Run.

Configured MCP servers:
🟢 cloud-run (from cloud-run) - Ready (8 tools, 2 prompts)
  Tools:
  - mcp_cloud-run_create_project
  - mcp_cloud-run_deploy_container_image
  - mcp_cloud-run_deploy_file_contents
  - mcp_cloud-run_deploy_local_folder
  - mcp_cloud-run_get_service
  - mcp_cloud-run_get_service_log
  - mcp_cloud-run_list_projects
  - mcp_cloud-run_list_services
  Prompts:
  - deploy
  - logs

هذا مجرد مثال واحد على إضافات Gemini CLI التي شرحنا كيفية ضبط إعداداتها. يمكنك الاطّلاع على معرض الإضافات لاستكشاف المزيد منها.

10. حالات استخدام يمكنك تجربتها

يمكن استخدام Gemini CLI في مجموعة كبيرة من حالات الاستخدام التي تنطبق على المطوّرين وغير المطوّرين على حد سواء. في ما يلي بعض السيناريوهات، ويمكنك تجربة أيّ منها أو جميعها حسب مجال اهتمامك.

في كلّ من هذه الحالات، يتم تقديم الطلب. يمكنك تجربة ذلك في الوضع التفاعلي أو غير التفاعلي في Gemini CLI من خلال المَعلمة -p عند تشغيل Gemini CLI.

البرمجة الوصفية باستخدام Gemini CLI

لنستخدم Gemini CLI لإنشاء تطبيق باستخدام Vibe Code. في هذه المهمة، ستطلب من Gemini CLI إنشاء تطبيق ثم نقل الإصدار الأولي إلى مستودع GitHub.

المتطلّبات الأساسية

لإجراء المهام في هذا القسم، يجب استيفاء بعض الشروط المسبقة:

Git
Gemini CLI
إعداد gh ( أداة GitHub CLI)
الإلمام بأساسيات Git ومعرفة بعض المعلومات عن البرمجة

سنفترض أنّك شغّلت Gemini CLI في مجلد محدّد من اختيارك. في حالتنا، أطلقنا Gemini CLI من مجلد الصفحة الرئيسية الأولي gemini-cli-projects ومجلد آخر event-website بداخله.

ابدأ بطلب أولي. يمكنك اعتبارها مواصفات لتطبيقك. يمكنك تعديله بالطريقة التي تناسبك. يُرجى العِلم أنّ Gemini CLI سيطلب منك الحصول على أذونات لإنشاء الملفات وما إلى ذلك خلال الجلسة، لذا عليك منح الأذونات المطلوبة.

في هذه المهمة، لا نريد أن ينفّذ Gemini CLI التطبيق أو يختبره نيابةً عنّا لأنّنا نريد المزيد من التحكّم. ولكنّ القرار يعود إليك تمامًا.

Generate a website for a 1-day event filled with technical talks. There are going to be 6 talks in a single track of 1 hour each. Each talk has the following information: title, 1 or maximum of 2 speakers, category (1 or maximum of 3 keywords), duration and a description. The website has a single page where users can see the schedule for the entire day with the timings. There will be one lunch break of an hour and the event starts at 10:00 AM. Keep a 10 minute transition between talks. I would like to use Node.js on the server side and standard HTML, JavaScript and CSS on the front-end. The users should be able to search the talks based on category.

I would like you to proceed in the following way: 
1. Plan out how you would design and code this application.
2. Ask me for any clarifications along the way.
3. Once I am fine with it, do generate the code and provide me instructions to run and test locally.

الطلبات والردود القليلة التالية هي نموذج لتدفق تمت ملاحظته. سيضع Gemini CLI خطة ويطلب منك تقديم أي تأكيدات أو توضيحات أو المتابعة. يُرجى اتّباع التعليمات. في ما يلي عيّنة من سلسلة المحادثات:

   ✦ Of course. I will start by creating a plan for the application.
  Plan:
   1. Backend (Node.js):
       * I'll set up a simple Node.js server using the Express.js framework.
       * This server will have two main purposes:
           1. Serve the static frontend files (HTML, CSS, JavaScript).
           2. Provide an API endpoint (e.g., /api/talks) that will send the event schedule data to the frontend as a JSON object.
       * The talk data will be stored in a separate talks.json file for easy management.
   2. Frontend (HTML, CSS, JS):
       * HTML: A single index.html file will define the structure of the page, including a container for the schedule and a search input field for filtering by category.
       * CSS: A style.css file will be used to style the website for a clean and professional look, ensuring the schedule is easy to read.
       * JavaScript: A script.js file will handle the dynamic aspects of the site:
           1. It will fetch the talk data from the backend API when the page loads.
           2. It will dynamically render the schedule on the page based on the fetched data.
           3. It will implement the search functionality. As the user types in the search box, it will filter the displayed talks based on the category keywords.
   3. Project Structure:
      I will organize the project with a clear and standard structure:
   1     /
   2     ├── public/
   3     │   ├── index.html
   4     │   ├── style.css
   5     │   └── script.js
   6     ├── talks.json
   7     └── server.js
   8     └── package.json
  Before I proceed with generating the code, I have a few questions to ensure the final product meets your expectations:

حتى أنّه يطرح عليّ بعض الأسئلة (الموضّحة أدناه والتي أجيب عنها):

بعد ذلك، يبدأ بإنشاء الرمز البرمجي، ويطلب مني تأكيدًا في عدة مواضع، وأمنحه الإذن اللازم للمتابعة.

وأخيرًا، بدأ تشغيل الخادم وطلب مني المتابعة وفحص الصفحة:

The server is now running in the background.
  3. View Your Website
  You can now open your web browser and navigate to the following address to see your website:
  http://localhost:3000 (http://localhost:3000)
  4. Test the Search Functionality
  Once the page is loaded, you can test the search functionality by typing a category into the search bar (e.g., "AI", "Frontend", "Cybersecurity"). The list of talks
  will filter in real-time.
  This completes the setup and implementation of your event website. Let me know if you have any other questions.

في ما يلي نموذج الصفحة التي أنشأها:

يمكنك مواصلة إجراء المزيد من التغييرات بمساعدة Gemini CLI. بعد أن تصبح راضيًا عن التغييرات، يمكنك إرسالها إلى مستودع GitHub.

أولاً، لننشئ ملف ‎ .gitignore، ويمكنك الاستعانة بأداة Gemini CLI.

Create a .gitignore file for this project.

الخطوة التالية هي تقديم تعليمات إلى Gemini CLI لنقل هذا المستودع إلى حسابنا على GitHub، ما سيؤدي إلى استخدام أدوات خادم GitHub MCP في الخلفية.

أدخِل طلبًا مشابهًا لما يلي:

Great! I would now like to push all of this to a new repository in my GitHub account. I would like to name this repository <Your-Name>-event-talks-app

سيتم تنفيذ عدد من الأوامر هنا:

أنشِئ المستودع.
سيستخدم عدة أوامر Git، مثل init وadd وcommit، لإدارة مستودع Git المحلي.
سيتم بعد ذلك إعداد Git عن بُعد وتنفيذ عملية دفع

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

إذا سارت الأمور بدون مشاكل، من المفترض أن يكون لديك مستودع على GitHub. في ما يلي نموذج لقطة شاشة:

يُرجى العِلم أنّك لم تنشئ README.md لهذا المشروع، وهذا تمرين جيد للقسم التالي، حيث سنتعامل الآن مع هذا المستودع الذي أنشأته للتو.

استخدام Gemini CLI للعمل على مستودع GitHub

في حالة الاستخدام هذه، عليك استخدام Gemini CLI للعمل مع مستودع GitHub. ستنفّذ مهام متعددة تشمل ما يلي:

فهم قاعدة الرموز البرمجية
إنشاء مستندات
تنفيذ ميزة جديدة
تنفيذ التغييرات وإرسالها إلى المستودع
العمل على مشكلة في GitHub وتنفيذ التغييرات المقترَحة

من المفترض أن يمنحك ذلك أساسًا جيدًا للعمل مع مستودعاتك واستخدام Gemini CLI كمساعد في ما يتعلق بمهام المطوّرين المحددة هذه.

المتطلّبات الأساسية

لتنفيذ المهام في هذا القسم، عليك إجراء ما يلي:

Git
‫Gemini CLI وgh ( أداة GitHub CLI)
الإلمام بأساسيات Git ومعرفة بسيطة بالبرمجة (سنستخدم Node.js في هذا المثال لأنّه من المحتمل أن تكون البيئة جاهزة على جهازك بسبب تثبيت Gemini CLI). ولكن يمكنك في وقت لاحق اختيار مستودع من اختيارك باستخدام لغة برمجة وإطار عمل مختلفَين.
يجب أن تكون قد أكملت القسم السابق وأن يكون لديك المستودع جاهزًا، حيث أنشأنا موقعًا إلكترونيًا باسم Event Talks.

لنواصل استخدام Gemini CLI من المجلد/الدليل الذي استخدمته لإنشاء تطبيق Event Talks، أو يمكنك استنساخ المستودع إلى جهازك المحلي ثم بدء Gemini CLI من هذا الدليل إذا لزم الأمر. جرِّب السيناريوهات التالية كما هو موضّح أدناه:

فهم قاعدة الرموز البرمجية

أريد فهم هذا المشروع بالتفصيل. أريد فهم الميزات الرئيسية ثم تقسيمها إلى جهة الخادم وجهة العميل. أريد مثالاً على مسار عمل وكيفية عمل الطلب والاستجابة.
Explain @server.js

إنشاء ملف README

أنشئ ملف README لهذا المشروع.

تنفيذ ميزة جديدة

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

من المفترض أن يقدّم لك خطة يمكنك الموافقة عليها. عند الموافقة، سيُجري Gemini CLI هذه التغييرات. جرِّب التغييرات التي أجريتها، وإذا ظهرت أخطاء (وهذا محتمل)، اطلب من Gemini CLI إصلاحها.

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

إنشاء مشاكل استنادًا إلى الميزات المقترَحة

لنجرّب شيئًا مثيرًا للاهتمام هنا. ستطرح على Gemini CLI سؤالاً حول كيفية تحسين تجربة المستخدم لهذا التطبيق، وبناءً على تقييمه، يمكنه إنشاء هذه الاقتراحات كمشاكل في مستودع GitHub نفسه. سيتم استخدام أداة "create_issue" من خادم GitHub MCP.

جرِّب الطلب التالي:

أريد منك تقييم التطبيق من وجهة نظر تجربة المستخدم. سهولة الاستخدام والاستجابة والرسائل المفيدة وغير ذلك يُرجى تقديم قائمة بالتحسينات، وأريد منك بعد ذلك إنشاءها كمشاكل في مستودع GitHub.

من المفترض أن يشارك معك التحسينات أولاً، ثم يتابع بإذن منك لإنشاء المشاكل في مستودع GitHub. في ما يلي لقطة شاشة نموذجية من عملية التشغيل:

العمل على مشكلة في GitHub وتنفيذ التغييرات المقترَحة

يمكنك الآن اختيار إحدى المشاكل التي تم إنشاؤها سابقًا وطلب تنفيذها من Gemini CLI.

في ما يلي مثال على مشكلة تم إنشاؤها:

خذ عنوان URL الكامل للمشكلة وقدِّم طلبًا مثل هذا:

يُرجى الاطّلاع على المشكلة: <YOUR_ISSUE_URL> وفهم التغييرات التي يجب إجراؤها. ناقِش الخطة أولاً، ثم اعرض التغييرات المقترَحة في الرمز البرمجي.

يمكنك الموافقة على التغييرات ونقلها إلى المستودع. يمكنك حتى أن تطلب منه إغلاق المشكلة.

(اختياري) المهام اليومية

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

يمكنك استكشاف أي من حالات الاستخدام التي تعجبك.

تنظيم الملفات/المجلدات

يمكنك استخدام Gemini CLI لتنظيم الملفات حسب أنواعها في مجلدات مختلفة حسب الحاجة. انتقِل إلى مجلد على جهازك يحتوي على عدة ملفات بتنسيقات ‎ .txt و‎.png و‎.jpg و‎.pdf و‎.mp4 وغيرها. من المحتمل أن يكون هذا هو سطح المكتب أو مجلد "عمليات التنزيل".

في ما يلي نموذج مجلد ويظهر محتوى المجلد أدناه (قد تتضمّن مجلداتك ملفات أخرى):

انتقِل إلى هذا المجلد وابدأ Gemini CLI. ستطلب من Gemini CLI إنشاء بعض المجلدات أولاً: "الصور" و"المستندات" و"الفيديوهات"، ثم ستطلب من Gemini CLI تنظيم الملفات في المجلدات.

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

Create the following folders "Images","Documents","Videos"

بعد ذلك، وجِّه الطلب التالي:

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

في ما يلي مثال على الشكل النهائي للمجلد. من المفترض أن تظهر لك مجلدات فرعية جديدة تم إنشاؤها ونقل الملفات إلى المجلدات الفرعية المعنية حسب نوعها.

في ما يلي بعض سيناريوهات التنظيم الأخرى (يتم تقديم الطلبات بجانب كل سيناريو):

التلخيص: لكل مستند في مجلد "المستندات"، أنشئ ملف txt في المجلد نفسه باسم "summary_ORIGINAL_FILENAME.txt" يتضمّن ملخّصًا من 3 جمل للنقاط الرئيسية في المستند.
التصنيف حسب النوع: يتم فحص جميع ملفات PDF وDOCX في هذا الدليل. انقل جميع الملفات التي تتضمّن كلمة "فاتورة" في اسمها أو محتواها إلى المجلد "الشؤون المالية/الفواتير". نقل الملفات التي تتضمّن كلمة "إيصال" إلى مجلد "المستندات المالية/الإيصالات" يتم نقل أي ملفات docx .أخرى إلى مجلد "التقارير".
استخراج المعلومات الأساسية (و"وضع العلامات"): بالنسبة إلى كل ملف PDF في المجلد "المستندات المالية/الفواتير"، يتم قراءة محتواه. إذا عثرت على تاريخ، أعِد تسمية الملف لتضمين هذا التاريخ بالتنسيق YYYY-MM-DD، مثلاً، "invoice_2025-07-26_original_name.pdf".