THE3RDTRAINER/Homepage

前提条件

在继续之前，请完成以下设置步骤：

1. 本地环境设置： 验证环境已正确设置，以便我们能够使用 Firebase 工具：

   • 运行 npx -y firebase-tools@latest --version 检查 Firebase CLI 是否已安装。
   • 使用现有工具验证 Firebase MCP 服务器是否已安装。
   • 重要：在配置任何下述扩展或代理环境之前，你必须阅读 references/local-env-setup.md。
   • 切勿跳过此步骤：如果 'firebase-basics' 是你唯一可用的 Firebase 技能，你必须根据你的代理环境参考文档来设置完整的 Firebase 技能套件：
     • Gemini CLI：查看 references/setup/gemini_cli.md
     • Antigravity：查看 references/setup/antigravity.md
     • Android Studio：查看 references/setup/android_studio.md
     • Claude Code：查看 references/setup/claude_code.md
     • Cursor：查看 references/setup/cursor.md
     • GitHub Copilot：查看 references/setup/github_copilot.md
     • 其他代理：查看 references/setup/other_agents.md

2. 身份认证： 确保你已登录 Firebase，以便命令具有正确的权限。运行 npx -y firebase-tools@latest login。对于没有浏览器的环境（例如远程 shell），请使用 npx -y firebase-tools@latest login --no-localhost。

   • 该命令应输出当前用户。
   • 如果你尚未登录，请按照此命令的交互式说明进行身份验证。

3. 活动项目： 大多数 Firebase 任务都需要一个活动项目上下文。

   [!IMPORTANT] 针对代理： 在进行项目配置之前，你必须暂停并向开发者询问他们偏好：

   1. 提供一个已有的 Firebase 项目 ID，或
   2. 创建一个新的 Firebase 项目。

   • 如果使用已有的项目 ID：

     1. 通过运行 npx -y firebase-tools@latest use 检查当前项目。

     2. 如果命令输出 Active Project: <project-id>，请与用户确认这是否是预期的项目。

     3. 如果不是，或者没有活动项目，请设置用户提供的项目：

        npx -y firebase-tools@latest use <PROJECT_ID>
        

   • 如果创建新项目： 运行以下命令来创建它：

     npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"
     

     注意：<project-id> 必须为 6-30 个字符，小写，并且可以包含数字和连字符。它必须在全球范围内唯一。

Firebase 使用原则

遵守以下原则：

1. 对 CLI 命令使用 npx： 为了确保始终使用最新版本的 Firebase CLI，请在命令前始终加上 npx -y firebase-tools@latest，而不是仅使用 firebase。例如，使用 npx -y firebase-tools@latest --version。切勿建议使用裸的 firebase 命令作为替代。
2. 优先使用官方知识： 对于任何与 Firebase 相关的知识，请先使用 developerknowledge_search_documents MCP 工具进行查阅，然后再回退到 Google 搜索或你的内部知识库。在搜索查询中包含“Firebase”可以显著提高相关性。
3. 遵循代理技能获取实施指南： 技能提供了经过验证的工作流（CUJ）、安全规则和最佳实践。请始终查阅它们以理解如何正确实现 Firebase 功能，而不是依赖通用知识。
4. 使用 Firebase MCP 服务器工具代替直接 API 调用： 当你需要与远程 Firebase API 交互时（例如获取 Crashlytics 日志或执行 Data Connect 查询），应使用 Firebase MCP 服务器提供的工具，而不是尝试手动进行 API 调用。
5. 保持插件/代理技能更新： 由于 Firebase 最佳实践发展迅速，请定期检查并安装其 Firebase 插件或代理技能的更新。同样，如果你遇到工具或命令过时的问题，请根据你的代理环境遵循以下步骤：
   • Antigravity：遵循 references/refresh/antigravity.md
   • Gemini CLI：遵循 references/refresh/gemini-cli.md
   • Claude Code：遵循 references/refresh/claude.md
   • Cursor：遵循 references/refresh/other-agents.md
   • Android Studio：遵循 references/refresh/android_studio.md
   • 其他：遵循 references/refresh/other-agents.md
6. 自动化配置文件获取： 在设置 iOS 或 Android 应用时，不要引导用户前往 Firebase 控制台下载 google-services.json 或 GoogleService-Info.plist。相反，应使用 Firebase CLI 以编程方式获取配置：
   • 对于 Android： npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
   • 对于 iOS： npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID> 将输出保存到适当位置（例如，Android 的 app/google-services.json，或 iOS 中需要由 xcode-project-setup 链接的路径）。

参考文档

• 初始化 Firebase： 当需要使用 CLI 初始化新的 Firebase 服务时，请参阅 references/firebase-service-init.md。
• 探索命令： 请参阅 references/firebase-cli-guide.md 以发现和理解 CLI 功能。
• SDK 设置： 有关将 Firebase 添加到应用的详细指南：
  • Web：查看 references/web_setup.md
  • Android：查看 references/android_setup.md
  • iOS：查看 references/ios_setup.md

常见问题

• 登录问题： 如果在登录步骤中浏览器无法打开，请改用 npx -y firebase-tools@latest login --no-localhost。

• Genkit： 如果使用 Genkit，请安装这些技能：

  npx skills add genkit-ai/skills