剛好學 - Firebase 配置生成器

STEP 0 · 開始

貼上你的 Firebase 配置

快速上手：只需一個步驟！直接從 Firebase Console 複製配置代碼，貼上下方文本框，點擊生成即可下載您的專屬應用程式。

BUILD · 建置步驟

建置主程式資料庫設定 (Firebase)

本系統需要連接到 Google Firebase 資料庫才能運作，您需自行按照本說明完成建置後，才可正常使用。這能確保所有課堂資料（如學生答案）都保存在您自己的空間，確保資料的隱私與所有權。

注意：此為必要設定步驟，需要您具備基本的 Google Firebase 操作知識。若未完成此設定，系統將無法使用。

1 建立 Firebase 專案

前往 Firebase Console（超連結）
點擊「新增專案」並依照指示完成建立

2 啟用必要服務

Authentication (驗證)

在專案左側「建構」中找到「Authentication」，點擊「開始使用」，進入「登入方式」分頁，並「啟用」「匿名」登入方式。

Firestore Database (資料庫)

在專案左側「建構」中找到「Firestore Database」，點擊「建立資料庫」後點選「Standard版」，接著下一步位置改成「asia-east1 (Taiwan)」讀取資料才能非常快速，最後選擇以「測試模式」啟動。

3 修改 Firestore 安全性規則（非常重要！）

資料庫建立後，在專案左側「建構」中找到 Firestore Database 頁面，點擊上方的「規則」(Rules) 分頁。

將編輯器中的所有內容，替換為以下規則：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

這條規則的意思是「允許任何已登入的使用者（包含我們剛才啟用的匿名登入）對資料庫進行讀寫」。

修改完成後，點擊「發佈」(Publish) 來儲存您的新規則。

4 取得您的 Firebase 設定值

① 在 Firebase Console 中，點擊專案首頁左上角的齒輪圖示，選擇「專案設定」。

② 在「您的應用程式」區塊，點擊「新增應用程式」並選擇「網頁」圖示 (</>)。

③ 為您的應用程式命名後，點擊「註冊應用程式」按鈕，您會看到一組 firebaseConfig 設定值。請將它複製下來。

const firebaseConfig = {
  apiKey: "AIzaSy...",
  authDomain: "xxx.firebaseapp.com",
  projectId: "xxx",
  storageBucket: "xxx.appspot.com",
  messagingSenderId: "123456789",
  appId: "1:123456789:web:..."
};

將這段配置代碼複製後，貼到本頁面最上方的文本框，然後點擊「生成並下載」按鈕即可！

DEPLOY · 發布上線

下一步：發布到網路上

下載完成後，請將剛剛下載的 index.html 上傳到以下網站即可免費發布您的應用程式：

前往 GitHub Pages 發布工具

上傳後，您將獲得一個公開網址，學生可以直接透過瀏覽器使用您的教學工具！

AI · Gemini 金鑰

啟用 AI 自動出題功能

完全免費，📷 支援拍照/截圖辨識

使用 AI 出題功能前，請先準備您自己的 Gemini API Key

為確保每位老師都能穩定享用 AI 服務，透過本頁下載的 index.html 不內建共用金鑰。只要花 2 分鐘完成以下步驟即可永久免費使用：

點擊下方「前往 Google AI Studio」按鈕
用 Google 帳號登入後點 「Create API Key」，取得一組金鑰
打開您下載的 index.html → 教師模式 → AI 設定 → 貼上金鑰 → 儲存

💡 Gemini 個人免費配額：每分鐘 15 次、每日 1,500 次 — 整班 30 位學生的備課需求完全夠用。

✨ 想直接試用看看？線上版 (cagoooo.github.io/Akailao) 仍可免 Key 直接體驗（體驗帳號共用，正式授課請用自己下載的版本）。

前往 Google AI Studio 申請免費 API Key

設定完 API Key 後，AI 出題有三種使用方式：

📝 貼上文章：將課本或教材的文字內容貼入，AI 自動產生 PIRLS 四層次題組
💭 描述主題：只寫主題關鍵字（例如「台灣的地震」），AI 會自動生成文本 + 題目
📷 【V3.6.0 新功能】拍照/截圖辨識：直接拍課本、截圖 PDF 或講義（支援多張圖片、可 Ctrl+V 貼上剪貼簿）， Gemini Vision 自動辨識文字並產生 PIRLS 四層次題組 — 教師備課神器！

PIRLS 四層次自動配題：直接提取(3) + 直接推論(3) + 詮釋整合(2) + 比較評估(2) = 10 題

您的 API Key 只儲存在您自己的瀏覽器中（localStorage），絕不會外流或上傳到任何伺服器。