Firebase Studio يسهّل سير عملك في مجال التطوير باستخدام ميزات الرموز البرمجية التالية المستنِدة إلى الذكاء الاصطناعي:
اقتراحات إكمال الرمز أثناء الكتابة
مساعدة الذكاء الاصطناعي في المحادثة أو من خلال واجهة سطر الأوامر (CLI)، التي تكون على دراية بمساحة العمل ومدمجة بالكامل مع الرمز البرمجي يمكنها إنشاء الرمز البرمجي وترجمته وشرحه. وبعد مراجعته والموافقة عليه، يمكن أن يتفاعل Gemini مباشرةً مع مساحة عملك لتعديل الملفات وتشغيل أوامر المحطة وتفسير ناتج الأوامر وتحديد الخطوات التالية. مزيد من المعلومات في تجربة المحادثة مع Gemini في Firebase Studio.
إجراءات مضمّنة يمكنك اتّخاذها بشأن أجزاء محدّدة من الرمز البرمجي على سبيل المثال، يمكنك أن تطلب من Gemini جعل الرمز البرمجي المحدّد أكثر قابلية للقراءة.
مساعدة مضمّنة في كتابة الرموز البرمجية
يمكنك تخصيص طريقة مساعدة Gemini لك من خلال تعديل إعداداته وإضافة ملفات قواعد الذكاء الاصطناعي:
- تعديل إعدادات إكمال الرمز البرمجي.
- تعديل إعدادات فهرسة قاعدة الرموز البرمجية.
- تخصيص التعليمات لـ Gemini باستخدام ملف قواعد الذكاء الاصطناعي الخاص.
- استبعاد الملفات من Gemini باستخدام
.aiexcludeملفات. - استخدام مفتاحك الخاص: استخدام نماذج Gemini أخرى في المحادثة
- تعديل طريقة اقتراح Gemini للتغييرات في الرمز البرمجي أو تطبيقها.
استخدام Gemini في مساحة عملك
يمكنك استخدام Gemini لتعزيز إنتاجيتك في كتابة الرموز البرمجية من خلال لوحة المحادثة، المحطة، أو المساعدة المضمّنة في كتابة الرموز البرمجية.
استخدِم المحادثة أو المساعدة المضمّنة في كتابة الرموز البرمجية في مساحة عملك:
لاستخدام المحادثة: في مساحة العمل المفتوحة، انقر على رمز الشرارة Gemini في أسفل مساحة العمل.
لاستخدام Gemini CLI: افتح المحطة وأدخِل
geminiلواجهة Gemini CLI، أو استخدِم الأمرgemini -pلاستخدام Gemini CLI في الوضع غير التفاعلي.لاستخدام المساعدة المضمّنة في كتابة الرموز البرمجية: ابدأ بكتابة الرمز البرمجي واضغط على
Tabلقبول الاقتراحات.
ضَع في اعتبارك أنّ الخيارَين التاليَين مفعّلان تلقائيًا:
- اقتراحات أثناء الكتابة، التي توفّر إكمال الرمز البرمجي المضمّن
- فهرسة قاعدة الرموز البرمجية، التي توفّر تخصيصًا أفضل وردودًا أكثر فائدة.
لتغيير هذه الخيارات لإعدادات مساحة عملك في المستقبل:
- لتعديل إعدادات إكمال الرمز البرمجي، يُرجى الاطّلاع على مقالة تعديل إعدادات إكمال الرمز البرمجي.
- لتعديل إعدادات فهرسة الرمز البرمجي، يُرجى الاطّلاع على مقالة تعديل إعدادات فهرسة الرمز البرمجي.
يمكنك أيضًا استبعاد ملفات وأدلة معيّنة من فهرسة الذكاء الاصطناعي. يُرجى الاطّلاع على مقالة استبعاد الملفات من Gemini باستخدام ملفات
.aiexclude.
Gemini اختصارات
لفتح المحادثة مع Gemini بسرعة، اضغط على
Ctrl+Shift+Space (أو Cmd+Shift+Space على نظام التشغيل MacOS).
لعرض أوامر Gemini من لوحة الأوامر:
افتح لوحة الأوامر بالضغط على
Ctrl+Shift+P(أوCmd+Shift+Pعلى نظام التشغيل MacOS).ابحث عن Gemini.
ستظهر قائمة بأوامر Gemini.
تعديل إعدادات إكمال الرمز البرمجي
لمساعدتك في كتابة الرمز البرمجي، يوفّر Firebase Studio ميزة إكمال الرمز البرمجي المستنِدة إلى الذكاء الاصطناعي التي تتوقّع الرمز البرمجي وتملأه تلقائيًا في أي ملف مفتوح بمجرد البدء في الكتابة.
يُرجى العلم أنّ ميزة إكمال الرمز البرمجي مفعّلة تلقائيًا.
لتفعيل ميزة إكمال الرمز البرمجي أو إيقافها، عدِّل إعدادات إكمال الرمز البرمجي باستخدام إحدى الطريقتَين التاليتَين:
إذا كنت تستخدم ملف
settings.json، اضبط"IDX.aI.enableInlineCompletion"علىtrueأوfalse.لتعديل الإعدادات في مساحة عمل Firebase Studio:
انقر على
إدارة (في أسفل يمين مساحة العمل)، ثمّ اختَر
الإعدادات، أو اضغط على Ctrl+,(Cmd+,على نظام التشغيل Mac).إذا كنت تستخدم App Prototyping agent في Prototyper عرض، انقر على
التبديل إلى الرمز البرمجي لفتح Code عرض.انقر على علامة التبويب مساحة العمل ، ثمّ ابحث عن الإعداد Firebase Studio > الذكاء الاصطناعي > تفعيل الإكمال المضمّن.
لإيقاف ميزة إكمال الرمز البرمجي، أزِل العلامة من الخيار تفعيل إكمال الرمز البرمجي المضمّن أثناء الكتابة.
تعديل إعدادات فهرسة قاعدة الرموز البرمجية
يمكنك التحكّم في ما إذا كان Gemini يفهرس الرمز البرمجي. توفّر فهرسة الرمز البرمجي نتائج أكثر فائدة عند استخدام المحادثة أو المساعدة المضمّنة المستنِدة إلى الذكاء الاصطناعي.
يُرجى العلم أنّ فهرسة قاعدة الرموز البرمجية مفعّلة تلقائيًا.
Geminiلتفعيل فهرسة الرمز البرمجي أو إيقافها، عدِّل إعدادات فهرسة قاعدة الرموز البرمجية باستخدام إحدى الطريقتَين التاليتَين:
إذا كنت تستخدم ملف
settings.json، اضبط"IDX.aI.enableCodebaseIndexing"علىtrueأوfalse.لتعديل الإعدادات في مساحة عمل Firebase Studio:
انقر على
إدارة (في أسفل يمين مساحة العمل)، ثمّ اختَر
الإعدادات، أو اضغط على Ctrl+,(Cmd+,على نظام التشغيل Mac).إذا كنت تستخدم App Prototyping agent في Prototyper عرض، انقر على
التبديل إلى الرمز البرمجي لفتح Code عرض.انقر على علامة التبويب مساحة العمل ، ثمّ ابحث عن الإعداد Firebase Studio > الذكاء الاصطناعي > تفعيل الإكمال المضمّن.
انقر على Firebase Studio > الذكاء الاصطناعي: تفعيل فهرسة قاعدة الرموز البرمجية .
لإيقاف فهرسة الرمز البرمجي، أزِل العلامة من الذكاء الاصطناعي: تفعيل فهرسة قاعدة الرموز البرمجية. عليك تعديل إعدادات فهرسة الرمز البرمجي لكل مساحة عمل من مساحات عملك.
تخصيص التعليمات لـ Gemini باستخدام ملف قواعد الذكاء الاصطناعي
يمكنك إضافة معلومات السياق والطلب من النظام من خلال إنشاء ملف قواعد الذكاء الاصطناعي:
- Gemini CLI تستخدم
GEMINI.mdفقط. - تعطي محادثة Gemini الأولوية لـ
.idx/airules.md، ولكنّها ستستخدمGEMINI.mdإذا لم يكن.idx/airules.mdمتوفرًا.
Gemini يستخدم قواعدك كتعليمات وسياق للنظام، ويخصّص ردوده لحالة استخدامك.
استخدِم ملف قواعد الذكاء الاصطناعي لمشاركة الطلبات المخصّصة وأفضل الممارسات وحتى السياق المهم حول مشروعك مع Gemini لتحقيق أهداف مثل:
- التأثير في شخصية Gemini's وتخصيص خبرته
- تطبيق معايير على مستوى المشروع، مثل نمط الترميز والاصطلاحات وخيارات التكنولوجيا المفضّلة
- تقليل مقدار المعلومات التي تحتاج إلى مشاركتها بشكلٍ صريح في الرمز البرمجي أو المحادثة من خلال توفير سياق أساسي حول مشروعك
إنشاء ملف قواعد الذكاء الاصطناعي واختباره
لإنشاء ملف قواعد الذكاء الاصطناعي واختباره:
أنشِئ ملفًا جديدًا في
~/GEMINI.md(لـ Gemini CLI) أو.idx/airules.md(لمحادثة Gemini) في مساحة عمل Firebase Studio. يمكنك استخدام أحد الخيارَين التاليَين:- من المستكشف (
Ctrl+Shift+E)، انقر بزر الماوس الأيمن على الدليل الرئيسي واختَر ملف جديد. أدخِل اسم الملف واضغط على Enter. - من المحطة، استخدِم محرِّر النصوص المفضّل لفتح
GEMINI.mdأو.idx/airules.md.
- من المستكشف (
أضِف المحتوى إلى الملف. قد تحتاج إلى إضافة معلومات عن الشخصية التي يجب أن يستخدمها Gemini (مثل "أنت مطوّر خبير ومساعد مفيد يعرف كل شيء عن Next.js") ومعايير الترميز و المحادثة والسياق حول المشروع. يُرجى الاطّلاع على الـ مثال التالي للحصول على مثال على ملف قواعد الذكاء الاصطناعي.
احفظ الملف وافتح Gemini CLI أو Gemini.
لبدء استخدام قواعد الذكاء الاصطناعي، يمكنك اتّباع أحد الإجراءَين التاليَين:
- أعِد إنشاء مساحة العمل من خلال إعادة تحميل الصفحة. بعد إعادة الإنشاء، سيستخدم Gemini ملف القواعد في المحادثة. يجب أن تظهر التغييرات التي يتم إجراؤها على ملف قواعد الذكاء الاصطناعي على الفور.
- إذا كنت لا تريد إعادة إنشاء مساحة عملك، يمكنك أن تطلب من
Gemini إلى
load GEMINI.mdأوload airules.md. إذا أجريت تغييرات على الملف خلال الجلسة الحالية، قد تحتاج إلى إعادة مطالبة Geminiبتحميل ملف القواعد مرة أخرى.
اطرح أسئلة حول الرمز البرمجي. Gemini يردّ باستخدام المعلومات التي أدرجتها في ملف القواعد كسياق.
مثال
في ما يلي مثال أساسي على ملف قواعد يمكنك استخدامه للعبة عادية تم تطويرها باستخدام Next.js:
# Persona
You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.
You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.
# Coding-specific guidelines
- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
Google developer documentation style guide
(https://developers.google.com/style).
# Overall guidelines
- Assume that the user is a junior developer.
- Always think through problems step-by-step.
# Project context
- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.
استبعاد الملفات من Gemini باستخدام ملفات .aiexclude
يمكنك التحكّم في الملفات التي يجب إخفاؤها عن
Gemini في قاعدة الرموز البرمجية من خلال تضمين .aiexclude في مشروعك.
يتيح لك ذلك التحكّم بشكلٍ دقيق في سياق المشروع الذي تشاركه مع
Gemini.
على غرار ملف .gitignore، يتتبّع ملف .aiexclude الملفات التي
لا يجب مشاركتها مع Gemini، بما في ذلك تجربة المحادثة
وميزات الذكاء الاصطناعي التي تعمل في المحرِّر. يعمل ملف .aiexclude على الملفات في الدليل الذي يحتوي عليه أو تحته.
لن يفهرس Gemini الملفات التي يغطيها .aiexclude عندما تكون ميزة
فهرسة قاعدة الرموز البرمجية مفعّلة. بالإضافة إلى ذلك، سيؤثر .aiexclude في المساعدة المضمّنة للملفات التي يغطيها بالطرق التالية:
- المساعدة في المحادثة: لن يتمكّن Gemini من الإجابة عن
الأسئلة أو تقديم اقتراحات حول الملفات التي يغطيها
.aiexclude. - إكمال الرمز البرمجي: لن تكون اقتراحات إكمال الرمز البرمجي متاحة عند تعديل الملفات التي يغطيها.
- المساعدة المضمّنة: ستتمكّن من إنشاء رمز برمجي جديد، ولكن لن تتمكّن من تعديل الرمز البرمجي الحالي عند تعديل الملفات التي يغطيها.
قد تحترم بيئات التطوير الأخرى، مثل استوديو Android، ملفات .aiexclude أيضًا.
كيفية كتابة ملفات .aiexclude
يتبع ملف .aiexclude البنية نفسها لملف .gitignore، مع الاختلافات التالية:
- يحظر ملف
.aiexcludeفارغ جميع الملفات في دليله وجميع الأدلة الفرعية. وينطبق ذلك على ملف يحتوي على**/*. - لا تتوافق ملفات
.aiexcludeمع النفي (إضافة!قبل الأنماط).
أمثلة
في ما يلي بعض الأمثلة على إعدادات ملف .aiexclude:
حظر جميع الملفات التي تحمل الاسم
apikeys.txtفي الدليل الذي يحتوي على ملف.aiexcludeأو تحته:apikeys.txtحظر جميع الملفات التي تحتوي على امتداد الملف
.keyفي الدليل الذي يحتوي على ملف.aiexcludeأو تحته:*.keyحظر ملف
apikeys.txtفقط في الدليل نفسه الذي يحتوي على.aiexclude، ولكن ليس أي أدلة فرعية:/apikeys.txtحظر جميع الملفات في الدليل
my/sensitive/dirوجميع الأدلة الفرعية. يجب أن يكون المسار نسبيًا للدليل الذي يحتوي على ملف.aiexclude:my/sensitive/dir/
استخدام مفتاحك الخاص: استخدام نماذج Gemini الأخرى في المحادثة
يمكنك ضبط نموذج Gemini الذي تستخدمه Gemini chat. يمكنك الاختيار من بين النموذج المضمّن، النماذج التي تم ضبطها في نافذة المحادثة، أو أي Gemini نموذج يمكنك الوصول إليه.
للاطّلاع على قائمة بجميع النماذج المتاحة، يُرجى الانتقال إلى Gemini نماذج.
لضبط مفتاحك واختيار نموذج Gemini مختلف:
في مساحة العمل المفتوحة، انقر على رمز الشرارة Gemini في أسفل مساحة العمل (أو علامة التبويب Gemini).
من نافذة محادثة Gemini، انقر على
إعدادات
الذكاء الاصطناعي. ستظهر إعدادات المستخدم.في الحقل IDX > الذكاء الاصطناعي: مفتاح Gemini API، أدخِل مفتاح Gemini API.
من القائمة المنسدلة IDX > الذكاء الاصطناعي: مزوّد النموذج ، اختَر Gemini API.
يمكنك الآن اختيار أي من نماذج Gemini التي تم ضبطها مسبقًا في المحادثة.
لضبط نموذج Gemini غير مدرَج في القائمة المنسدلة:
حدِّد نموذج Gemini الذي تريد استخدامه في المحادثة من القائمة في Gemini نماذج. على سبيل المثال، عليك إدخال
gemini-3-pro-previewمن نافذة المحادثة Gemini، انقر على أداة اختيار النموذج، ثمّ اختَر رقم تعريف النموذج المخصّص. سيتم فتح إعدادات المستخدم.
انسخ اسم النموذج الذي اخترته في الحقل IDX > الذكاء الاصطناعي: نموذج Gemini.
أغلِق نافذة المحادثة، ثمّ أعِد فتحها بالنقر على رمز الشرارة Gemini في أسفل مساحة العمل لإعادة تحميل قائمة النماذج.
تخصيص Gemini CLI
- الإعدادات: أنشِئ ملف
.gemini/settings.jsonلتغيير المظهر، وتفعيل جمع إحصاءات الاستخدام أو إيقافه وتعديل الأدوات التي يمكن أن تصل إليها Gemini CLI وضبط ميزة إنشاء نقاط التحقق وغير ذلك. - الإعدادات: راجِع مستندات Gemini CLI لمزيد من المعلومات حول كيفية تعديل الإعدادات.
- متغيّرات البيئة: Gemini CLI تحمّل تلقائيًا متغيّرات
البيئة من ملف
.env. هذا هو المكان الذي يجب تخزينGEMINI_API_KEY(مطلوب) فيه، بالإضافة إلى نموذج Gemini الذي تريد استخدامه ورقم تعريف مشروعك Google Cloud وغير ذلك (اختياري). - التعليمات: لتعديل السياق الذي تستخدمه Gemini CLI عند اتّباع
التعليمات، أنشِئ ملف
GEMINI.md. يتيح لك ذلك تقديم تعليمات خاصة بالمشروع أو أدلة نمط الترميز أو معلومات أساسية ذات صلة إلى Gemini، ما يجعل ردوده أكثر تخصيصًا ودقةً لتلبية احتياجاتك. يُرجى العِلم أنّ إنشاء هذا الملف سيقدّم التعليمات نفسها إلى Gemini، ما لم تنشئ ملف.idx/airules.mdأيضًا (في هذه الحالة، ستستخدم Gemini CLI ملفGEMINI.mdوسيستخدم Gemini ملفairules.md).
راجِع مستندات Gemini CLI لمزيد من المعلومات حول كيفية تعديل الإعدادات ومتغيّرات البيئة و التعليمات.