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. 使用 npx 執行 CLI 指令： 為確保您始終使用最新版本的 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。
• 探索指令： 若要探索和了解 CLI 功能，請參閱 references/firebase-cli-guide.md。
• 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