在工作区中配置 Gemini in Firebase

Firebase Studio 通过以下 AI 辅助代码功能帮助您简化开发工作流：

  • 输入时显示代码补全建议。

  • 聊天 AI 辅助功能，可感知工作区并与您的代码完全集成。它可以生成、转换和解释代码。在您审核并批准后，Gemini in Firebase 可以直接与您的工作区互动，以更新文件、运行终端命令、解释命令输出以及确定后续步骤。如需了解详情，请参阅尝试与 Gemini 聊天。

  • 您可以对所选代码执行的内嵌操作。例如，您可以让 Gemini 使所选代码更易于阅读。

  • 内嵌代码辅助。

您可以通过调整 Gemini in Firebase 设置和添加 AI 规则文件，自定义其提供帮助的方式：

在工作区中使用 Gemini in Firebase

使用 Gemini in Firebase，通过聊天面板或内嵌代码辅助功能提高编码效率。

  1. 在工作区中，您可以选择使用聊天或内嵌代码辅助功能：

    • 如需使用聊天功能，请在打开的工作区中，点击工作区底部的 星光图标 Gemini。

    • 如需使用内嵌代码辅助功能，请开始输入代码，然后按 Tab 接受建议。

  2. 请注意，以下两个选项默认已启用：

    • 输入时提供建议，可提供内嵌代码补全功能。
    • 代码库索引编制，可提升自定义能力并提供更有用的响应。

    如需日后更改工作区设置的这些选项，请执行以下操作：

    您还可以将特定文件和目录排除在 AI 索引编制之外。请参阅使用 .aiexclude 文件排除 Gemini 中的文件。

Gemini in Firebase 快捷键

如需快速打开 Gemini 聊天界面，请按 Ctrl+Shift+Space（在 macOS 上为 Cmd+Shift+Space）。

如需在命令面板中查看 Gemini 命令，请执行以下操作：

  1. 按 Ctrl+Shift+P（在 macOS 上，按 Cmd+Shift+P）打开命令面板。

  2. 搜索 Gemini。

    系统会显示 Gemini 命令列表。

调整代码补全设置

为了帮助您编写代码，Firebase Studio 提供了 AI 代码补全功能，该功能可在您开始输入内容时预测并自动填充任何打开文件中的代码。

请注意，代码补全功能默认开启。

如需开启或关闭代码补全功能，请使用以下任一方法调整代码补全设置：

  • 如果您使用的是 settings.json 文件，请将 "IDX.aI.enableInlineCompletion" 设置为 true 或 false。

  • 如需更新 Firebase Studio 工作区中的设置，请执行以下操作：

    1. 点击 齿轮图标 管理（位于工作区左下角），然后选择“设置”，或按 Ctrl+,（在 Mac 上按 Cmd+,）。

      如果您在 Prototyper view, click Code switch icon Switch to Code to open Code view. 中使用 App Prototyping agent

    2. 选择工作区标签页，然后搜索 Firebase Studio > AI > 启用内嵌补全设置。

    3. 如需停用代码补全功能，请取消选择启用输入时内嵌代码补全选项。

调整代码库索引编制设置

您可以控制 Gemini 是否对您的代码进行索引编制。为代码编制索引可在使用聊天或内嵌 AI 辅助功能时提供更有帮助的结果。

请注意，代码库索引编制功能默认开启。

。

如需开启或关闭代码索引编制，请使用以下任一方法调整代码库索引编制设置：

  • 如果您使用的是 settings.json 文件，请将 "IDX.aI.enableCodebaseIndexing" 设置为 true 或 false。

  • 如需更新 Firebase Studio 工作区中的设置，请执行以下操作：

    1. 点击 齿轮图标 管理（位于工作区左下角），然后选择“设置”，或按 Ctrl+,（在 Mac 上按 Cmd+,）。

      如果您在 Prototyper view, click Code switch icon Switch to Code to open Code view. 中使用 App Prototyping agent

    2. 选择工作区标签页，然后搜索 Firebase Studio > AI > 启用内嵌补全设置。

    3. 依次选择 Firebase Studio > AI：启用代码库索引编制。

    4. 如需停用代码索引编制，请取消选择 AI：启用代码库索引编制。您必须为每个工作区分别更新代码索引编制设置。

使用 AI 规则文件为 Gemini in Firebase 自定义说明

您可以通过创建 AI 规则文件 (.idx/airules.md) 来添加上下文和系统提示信息。Gemini in Firebase 会将您的规则用作系统指令和上下文，以确保其回答能够根据您的用例进行自定义。

使用 AI 规则文件，通过 Gemini 共享自定义提示、最佳实践，以及项目的关键背景信息，以实现以下目标：

  • 塑造 Gemini 的角色定位并强化其专业领域能力。
  • 应用项目范围的标准，例如编码风格、规范和技术偏好。
  • 通过提供项目的关键信息，减少您在代码或聊天中需要显式说明的内容。

您配置的规则会在聊天中由 Gemini 使用。

创建并测试 AI 规则文件

如需创建并测试 AI 规则文件，请执行以下操作：

  1. 在 Firebase Studio 工作区中的 .idx/airules.md 中创建一个新文件（与 dev.nix 文件位于同一目录中）。您可以使用以下任一选项：

    • 在浏览器 (Ctrl+Shift+E) 中，右键点击 .idx，然后选择新建文件。将文件命名为 airules.md，然后按 Enter 键。
    • 在终端中，使用首选文本编辑器打开 .idx/airules.md。

  2. 向文件添加内容。您可以添加 Gemini 角色设定（例如“您是一位精通 Next.js 的专家开发者和乐于助人的助手”）、编码规范、对话标准和项目背景信息。如需查看 AI 规则文件示例，请参阅以下示例。

  3. 保存文件，然后打开 Gemini in Firebase。

  4. 如需开始使用 AI 规则，您可以执行以下任一操作：

    • 通过刷新页面重建工作区。重新构建后，Gemini in Firebase 将使用聊天中的规则文件。对 AI 规则文件的更改应立即在聊天中生效。
    • 如果您不想重建工作区，可以通过聊天向 Gemini 发送 load airules.md 请求。如果您在当前会话期间对该文件进行了更改，则可能需要重新提示 Gemini 以重新加载规则文件。

  5. 询问有关代码的问题。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.

使用 .aiexclude 文件将特定文件排除在 Gemini 之外

您可以通过在项目中添加 .aiexclude 文件，控制哪些代码库文件不被 Gemini 访问。这样，您就可以精细地控制与 Gemini 共享的项目上下文。

与 .gitignore 文件非常相似，.aiexclude 文件会跟踪不应与 Gemini 共享的文件，包括聊天体验以及在编辑器中运行的 AI 功能。.aiexclude 文件适用于其所在目录及其子目录中的所有文件。

启用代码库索引编制后，.aiexclude 涵盖的文件不会被 Gemini 编入索引。此外，.aiexclude 还会对涵盖的文件的内嵌辅助产生以下影响：

  • 聊天辅助：Gemini 将无法回答有关 .aiexclude 涵盖的文件的问题或提供建议。
  • 代码补全：编辑涵盖的文件时，系统将无法提供代码补全建议。
  • 内嵌辅助：编辑排除的文件时，您可以生成新代码，但无法对现有代码进行修改。

其他开发环境（例如 Android Studio）也可能支持 .aiexclude 文件。

如何编写 .aiexclude 文件

.aiexclude 文件遵循与 .gitignore 文件相同的语法，但存在以下差异：

  • 空的 .aiexclude 文件会屏蔽其目录和所有子目录中的所有文件。这与包含 **/* 的文件相同。
  • .aiexclude 文件不支持否定（使用 ! 前缀修饰模式）。

示例

以下是一些 .aiexclude 文件配置示例：

  • 在包含 .aiexclude 文件的目录或该目录下，屏蔽所有名为 apikeys.txt 的文件：

    apikeys.txt

  • 在包含 .aiexclude 文件的目录或该目录下，屏蔽所有文件扩展名为 .key 的文件：

    *.key

  • 仅屏蔽与 .aiexclude 位于同一目录中的 apikeys.txt 文件，但不屏蔽任何子目录：

    /apikeys.txt

  • 屏蔽目录 my/sensitive/dir 及其所有子目录中的所有文件。路径应相对于包含 .aiexclude 文件的目录：

    my/sensitive/dir/

自带密钥：在聊天中使用其他 Gemini 模型

您可以配置 Gemini in Firebase 聊天使用的 Gemini 模型。您可以选择内置模型、在聊天窗口中配置的模型（包括 Gemini 2.5 模型）或您有权访问的任何 Gemini 模型。

如需查看所有可用模型的列表，请参阅 Gemini 模型。

如需配置密钥并选择其他 Gemini 模型，请执行以下操作：

  1. 在打开的工作区中，点击工作区（或 Gemini 标签页）底部的星光图标 Gemini。

  2. 在 Gemini in Firebase 聊天窗口中，点击模型名称下拉菜单，然后点击 Gemini API 密钥链接。此时会显示用户设置。

  3. 在 IDX > AI：Gemini API 密钥字段中，输入您的 Gemini API 密钥。

您现在可以在聊天中选择任何预配置的 Gemini 模型。

如需配置下拉菜单中未列出的 Gemini 模型，请执行以下操作：

  1. 从 Gemini 模型列表中找到您要在聊天中使用的 Gemini 模型。例如，您可以输入 gemini-2.0-flash-lite 以使用最新的稳定版 Gemini 2.0 Flash‑Lite 模型。

  2. 在 Gemini in Firebase 聊天窗口中，点击模型选择器，然后选择自定义模型 ID。此时会打开用户设置。

  3. 将您选择的模型名称复制到 IDX > AI：Gemini 模型字段中。

  4. 关闭聊天窗口，然后点击工作区底部的 星光图标 Gemini 重新打开它，以刷新模型列表。

后续步骤