Firebase Studio گردش کار توسعه شما را با ویژگی‌های کد با کمک هوش مصنوعی زیر تسهیل می‌کند:
تکمیل کد پیشنهادی درحین تایپ کردن.
کمک هوش مصنوعی با گپ، که از فضای کاری آگاه است و کاملاً با کد شما ادغام شده است. می‌تواند کد تولید کند، ترجمه کند، و توضیح دهد. و با بازبینی و تأیید شما، Gemini می‌تواند مستقیماً با فضای کاری شما تعامل داشته باشد تا فایل‌ها را به‌روز کند، فرمان‌های پایانه را اجرا کند، خروجی فرمان را تفسیر کند، و مراحل بعدی را تعیین کند. در امتحان کردن گپ با Gemini در Firebase Studio بیشتر بدانید.
کنش‌های درون‌خطی که می‌توانید روی قطعه‌های کد انتخاب‌شده انجام دهید. برای مثال، می‌توانید از Gemini بخواهید کد انتخاب‌شده را خواناتر کند.
دستیار کدنویسی به‌خط.
می‌توانید با تغییر دادن تنظیمات Gemini و افزودن فایل‌های قوانین هوش مصنوعی، نحوه کمک کردن آن را سفارشی‌سازی کنید:
- تنظیمات تکمیل کد را تنظیم کنید.
- تنظیمات نمایه‌سازی پایگاه کد را تنظیم کنید.
- دستورالعمل‌های Gemini را با فایل قوانین هوش مصنوعی سفارشی‌سازی کنید.
- فایل‌های Gemini را با
.aiexcludeفایل مستثنی کنید. - کلید خودتان را بیاورید: از مدل‌های Gemini دیگر در گپ استفاده کنید
- نحوه پیشنهاد یا اعمال تغییرات کد توسط Gemini را تنظیم کنید.
استفاده از Gemini در فضای کاری
از Gemini برای افزایش بهره‌وری کدنویسی‌تان ازطریق پانل گپ، پایانه، یا دستیار کد به‌خط استفاده کنید.
از گپ یا دستیار کد به‌خط در فضای کاری‌تان استفاده کنید:
برای استفاده از گپ: در فضای کاری باز، روی جرقه Gemini در پایین فضای کاری کلیک کنید.
برای استفاده از دستیار کد به‌خط: تایپ کردن کد را شروع کنید و برای پذیرفتن پیشنهادها،
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 کدتان را نمایه کند یا نه. نمایه‌سازی کد شما باعث می‌شود هنگام استفاده از گپ یا کمک هوش مصنوعی درون‌خطی، نتایج مفیدتری ارائه شود.
توجه داشته باشید که نمایه‌سازی پایگاه کد به‌طور پیش‌فرض روشن است.
برای روشن یا خاموش کردن نمایه‌سازی کد، تنظیمات نمایه‌سازی پایگاه کد را بااستفاده از یکی از روش‌های زیر تغییر دهید:
اگر از فایل
settings.jsonاستفاده می‌کنید،"IDX.aI.enableCodebaseIndexing"را رویtrueیاfalseتنظیم کنید.برای به‌روزرسانی تنظیمات در فضای کاری Firebase Studio:
روی
مدیریت (واقع در پایین سمت راست فضای کاری) کلیک کنید، سپس
«تنظیمات» را انتخاب کنید، یا Ctrl+,(Cmd+,در Mac) را فشار دهید.اگر از App Prototyping agent در نمای Prototyper استفاده می‌کنید، روی
رفتن به کد کلیک کنید تا نمای Code باز شود.برگه فضای کاری را انتخاب کنید، سپس تنظیم Firebase Studio > هوش مصنوعی > فعال کردن تکمیل کد را جستجو کنید.
Firebase Studio > هوش مصنوعی: فعال کردن نمایه‌سازی پایگاه کد را انتخاب کنید.
برای خاموش کردن نمایه‌سازی کد، هوش مصنوعی: فعال کردن نمایه‌سازی پایگاه کد را لغو انتخاب کنید. باید تنظیمات نمایه‌سازی کد را برای هریک از فضاهای کاری‌تان به‌روز کنید.
دستورالعمل‌های Gemini را با فایل قوانین هوش مصنوعی سفارشی‌سازی کنید
با ایجاد فایل قوانین هوش مصنوعی می‌توانید بافت و اطلاعات پیام‌واره سیستم را اضافه کنید:
گپ Gemini .idx/airules.md را در اولویت قرار می‌دهد اما اگر .idx/airules.md وجود نداشته باشد، از GEMINI.md استفاده خواهد کرد.
Gemini از قوانین شما به‌عنوان دستورالعمل‌های سیستم و بافت استفاده می‌کند، و پاسخ‌هایش را برای مورد استفاده شما سفارشی‌سازی می‌کند.
از فایل قوانین هوش مصنوعی برای هم‌رسانی پیام‌واره‌های سفارشی، روال‌های مطلوب، و حتی بافت مهم درباره پروژه‌تان با Gemini استفاده کنید تا به اهدافی مثل موارد زیر دست یابید:
- تأثیرگذاری بر شخصیت Gemini و تخصصی کردن مهارت آن.
- اعمال استانداردهای سراسری پروژه، مانند سبک کدنویسی، قراردادها، و اولویت‌های فناوری.
- کاهش مقدار اطلاعاتی که باید به‌طور صریح در کد یا گپ هم‌رسانی کنید، ازطریق ارائه بافت ضروری درباره پروژه‌تان.
ایجاد و آزمایش فایل قوانین هوش مصنوعی
برای ایجاد و آزمایش کردن فایل قوانین هوش مصنوعی:
فایل جدیدی در
.idx/airules.md(یاGEMINI.md) در فضای کاری Firebase Studio ایجاد کنید. می‌توانید از یکی از گزینه‌های زیر استفاده کنید:- از کاوشگر (
Ctrl+Shift+E)، روی دایرکتوری والد کلیک راست کنید و فایل جدید را انتخاب کنید. فایل را نام‌گذاری کنید و کلید ورود را فشار دهید. - از پایانه، از ویرایشگر نوشتار ترجیحی‌تان برای باز کردن
GEMINI.mdیا.idx/airules.mdاستفاده کنید.
- از کاوشگر (
محتوا به فایل اضافه کنید. شاید بخواهید اطلاعاتی درباره شخصیتی که Gemini باید استفاده کند (مانند «شما یک توسعه‌دهنده متخصص و دستیار مفیدی هستید که همه چیز را درباره Next.js می‌داند»)، استانداردهای کدنویسی و مکالمه، و بافت پروژه اضافه کنید. برای دیدن نمونه فایل قوانین هوش مصنوعی، نمونه زیر را ببینید.
فایل را ذخیره کنید و Gemini را باز کنید.
برای شروع استفاده از قوانین هوش مصنوعی، می‌توانید یکی از کارهای زیر را انجام دهید:
- با بازآوری کردن صفحه، فضای کاری را بازسازی کنید. پس‌از بازسازی، Gemini از فایل قوانین در گپ استفاده خواهد کرد. تغییرات در فایل قوانین هوش مصنوعی باید فوراً منعکس شود.
- اگر نمی‌خواهید فضای کاری‌تان را بازسازی کنید، می‌توانید از
Gemini بخواهید
load GEMINI.mdیاload airules.md. اگر درطول جلسه فعلی تغییراتی در فایل ایجاد کنید، ممکن است لازم باشد دوباره به Gemini پیام‌واره بدهید تا فایل قوانین را دوباره بار کند.
درباره کدتان سؤال بپرسید. Gemini بااستفاده از اطلاعاتی که در فایل قوانین به‌عنوان بافت اضافه کرده‌اید پاسخ می‌دهد.
Gemini (به‌ترتیب اولویت) از
.idx/airules.md،GEMINI.md،.gemini/styleguide.md،AGENTS.md، یاcursorrulesاستفاده خواهد کرد.
مثال
در زیر نمونه‌ای ساده از فایل قوانین آورده شده است که می‌توانید برای بازی تفننی توسعه‌یافته با 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 فایل
با گنجاندن فایل‌های .aiexclude در پروژه‌تان، می‌توانید کنترل کنید کدام فایل‌ها در پایگاه کد شما از
Gemini پنهان بمانند.
این کار به شما امکان می‌دهد بافت پروژه را که با Gemini هم‌رسانی می‌کنید به‌طور دقیق کنترل کنید.
درست مثل فایل .gitignore، فایل .aiexclude فایل‌هایی را که نباید با Gemini هم‌رسانی شوند ردیابی می‌کند، ازجمله تجربه گپ و همچنین ویژگی‌های هوش مصنوعی که در ویرایشگر عمل می‌کنند. فایل .aiexclude
روی فایل‌های موجود در فهرست راهنمای حاوی آن یا زیر آن عمل می‌کند.
وقتی نمایه‌سازی پایگاه کد فعال باشد، فایل‌های تحت پوشش .aiexclude توسط Gemini نمایه‌سازی نخواهند شد. علاوه‌براین، .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 گپ استفاده می‌کند پیکربندی کنید. می‌توانید از بین مدل داخلی، مدل‌های پیکربندی‌شده در پنجره گپ، یا هر مدل Gemini که به آن دسترسی دارید انتخاب کنید.
برای مشاهده فهرست همه مدل‌های دردسترس، به Gemini مدل‌های مراجعه کنید.
برای پیکربندی کلید و انتخاب مدل Gemini دیگر:
در فضای کاری باز، روی spark Gemini در پایین فضای کاری (یا برگه Gemini) کلیک کنید.
از پنجره گپ Gemini، روی
تنظیمات
هوش مصنوعی کلیک کنید. تنظیمات کاربر نشان داده می‌شود.در فیلد IDX > AI: Gemini Api Key، کلید Gemini API را وارد کنید.
از منو کرکره‌ای IDX > AI: Model Provider، Gemini API را انتخاب کنید.
اکنون می‌توانید هرکدام از مدل‌های ازپیش‌پیکربندی‌شده Gemini را در گپ انتخاب کنید.
برای پیکربندی مدل Gemini که در منو کرکره‌ای نیست:
مدل Gemini موردنظرتان را برای استفاده در گپ از فهرست موجود در مدل‌های Gemini شناسایی کنید. برای مثال، برای استفاده از مدل پیش‌نمایش Gemini 3 Pro Preview،
gemini-3-pro-previewاز پنجره گپ Gemini، روی گزینشگر مدل کلیک کنید، سپس شناسه مدل سفارشی را انتخاب کنید. تنظیمات کاربر باز می‌شود.
نام مدل انتخابی را در فیلد IDX > هوش مصنوعی: مدل Gemini کپی کنید.
پنجره گپ را ببندید، سپس با کلیک کردن روی spark Gemini در پایین فضای کاری، آن را دوباره باز کنید تا فهرست مدل بازآوری شود.