🚀 快速上手：AI 智能題庫生成流程
「AI 題庫生成及管理工具」是一個基於 Firebase 儲存的普普風 (Pop Art) 題庫工具。它讓您可以輕鬆地將教材內容轉換為多種難度與層次的選擇題，並匯出成多種線上測驗或遊戲格式。
本系統所有資料皆儲存於您個人的 Firebase 空間，確保資料的私密性。以下三步驟將引導您快速開始使用：
1 設定 Firebase 數據連線
點擊右上角的「⚙️ 設定」按鈕，貼上您的 Firebase Config 內容並儲存。這是系統持久化儲存和即時測驗功能的基礎。若尚未擁有 Firebase 專案，請參考本手冊的「🔧 建置資料庫與規則」章節。
提示：若要分享給其他裝置使用，請在設定面板點擊「🔗 生成跨裝置分享連結」。
2 新增教材並生成題庫
點擊「📚 新增教材」或「✍️ 批次新增」按鈕。
- 新增教材：：上傳 PDF/文字檔或貼上文字，設定需要的題目類型（知識點/閱讀理解）和數量，點擊「生成題庫」。
- 批次新增：：貼上符合「書商格式」（題目/答案/選項以 Tab 分隔）的文字，快速匯入大量現有題目。
3 產生練習與匯出
在左側的「📚 我的題庫」列表中選擇您要使用的題庫（可複選，但不能混合「知識點」和「閱讀理解」兩種類型），然後在右側的「🎯 生成練習與匯出」區塊選擇生成模式（自動或手動選題），即可預覽練習題，並匯出成您需要的格式（如 Wordwall、Google 表單或遊戲 HTML）。
💡 核心功能：題庫生成與管理
A. 新增教材 (AI 智能生成)
透過上傳 PDF/TXT 檔案或貼上純文字內容，系統可呼叫 AI 智能生成選擇題。
- 教材來源：支援檔案上傳、貼上文字、或從「教材庫」選用歷史內容。
- 知識點生成：：可設定生成「簡單 (Easy)」、「中等 (Medium)」、「困難 (Hard)」三個難度的題目數量。
- 閱讀理解生成：：：可依據 PISA/PIRLS 層次模型，設定「提取訊息」、「文意推論」、「詮釋整合」、「反思評價」四個層次的題目數量。
教學情境：：上傳一章節的教科書 PDF，設定生成 5 題中等知識點和 3 題反思評價的題目，快速產出整合性評量。
B. 批次新增 (書商格式匯入)
允許教師快速將既有題庫（如書商提供的電子檔）匯入系統，並將其建立為新的題庫分類。
格式要求：每一行代表一題，使用 Tab 鍵分隔欄位，格式為：題目 (Tab) 正確答案選項數字 (Tab) 選項A (Tab) 選項B (Tab) 選項C (Tab) 選項D。
教學情境：將 Excel 或 Word 中已整理好的題庫內容直接貼入，快速建立大量標準化題目，並指定其難度/層次。
C. 我的題庫管理與編輯
所有透過 AI 或批次新增建立的題庫都會顯示在「我的題庫」列表中，並可依類型篩選（📚 知識點 / 📖 閱讀理解）。
- 選題原則：可同時選擇多個題庫，但不能跨類型（例如：不能同時選知識點題庫和閱讀理解題庫）。
- 預覽/編輯：：點擊「預覽/編輯」按鈕，可對題庫名稱、題目內容、選項、正確答案及難度標籤進行微調後儲存。
- 刪除：：可隨時刪除不再需要的題庫。
✨ 進階應用：測驗建立與多格式匯出
練習題生成與選題模式
在選定題庫後，右側的「生成練習與匯出」區塊提供兩種方式產生練習題：
- 自動生成：：設定「總題數」和「難度/層次偏好」（多選），系統會從所有選定的題庫中隨機抽選題目。
- 手動選題：：彈出視窗，列出所有選定題庫中的題目，您可以逐題勾選想要加入練習題的題目。
多格式快速匯出
練習題生成後，您可以快速將其匯出成多種線上教學工具和格式，以便於評量或遊戲化教學：
匯出 Google 表單提示：：系統會生成一段 Google Apps Script (GAS) 程式碼。您需要將此程式碼貼到新的 Google 表單的「指令碼編輯器」中並執行，表單將會自動建立選擇題並設定好答案與分數。
遊戲 HTML 下載與派送
點擊「下載遊戲 HTML」按鈕，您可以將當前生成的練習題直接填充到多種遊戲的 HTML 原始碼中，讓學生透過遊戲進行複習。
- 遊戲類型：：包含賽車遊戲、打怪升級、貓狗大戰、答題打磚塊、大屏搶答等多種互動遊戲。
建立即時測驗 (Live Quiz)
點擊「📱 建立即時測驗」按鈕，系統會將當前練習題發佈到您的 Firebase 資料庫，並生成一個獨特的 6 碼 ID。
- 分享方式：：提供 QR Code、完整網址，並嘗試生成短網址供分享。
- 學生端：：學生可透過網址參數
?t={quizId}進入測驗畫面，輸入姓名後作答，作答完畢即可看到即時得分。 - 選用功能：：可勾選「在測驗畫面顯示教材文本」，讓學生在作答時能參考原始教材內容。
📊 數據分析：即時測驗結果統計
透過「📋 測驗列表」功能，您可以隨時查看已建立的即時測驗清單，並追蹤學生的作答結果和統計數據。
測驗結果概覽與統計摘要
進入測驗結果頁面後，頂部會顯示統計摘要：
- 核心數據：：答題人數、平均分數、最高分、最低分。
- 數據即時性：：：學生提交答案後，統計數據會立即更新，方便教師掌握全班學習狀態。
各題答對率圖表
系統會為每道題目生成視覺化的答對率長條圖，讓教師快速識別教學盲點。
- 視覺化指標：：：以百分比和分數/總人數的形式顯示答對率。
- 答錯學生追蹤：：點擊圖表或懸停，可查看哪些學生答錯了該題，方便課後進行一對一輔導。
學生答題記錄列表
下方列表按時間順序顯示每位學生的作答記錄，包含：
- 學生姓名、提交時間、得分。
- 正確題數與錯誤題數的快速總結。
- 注意：：學生端提交答案時，系統會將記錄寫入 Firebase 的
answers子集合。
⚙️ 系統配置與 AI 來源設定
點擊右上角的「⚙️ 設定」按鈕進入配置面板，您可以調整數據連接和 AI 模型來源。
Firebase 整合
- 配置輸入：：貼上 Firebase 專案的六行設定值 (
apiKey,authDomain, etc.)。 - 分享連結：：點擊「生成跨裝置分享連結」，可產生一個包含您的配置資訊的 URL，方便在不同瀏覽器或裝置間同步使用。
- 資料管理：：透過「
💾 資料管理」按鈕，您可以匯出或匯入整個題庫（JSON 格式）進行備份和還原。
重要：：匯入資料將會覆蓋您 Firebase 中的所有題庫，操作前請務必確認。
選擇 AI 來源
您可以選擇用於生成題目的 AI 模型來源：
- 預設 Gemini：：使用內建的 Gemini 模型 (如有提供)。
- Gemini API Key：：使用您個人申請的 Google AI Gemini API 金鑰進行生成。
- 本地 Ollama：：連接到您在本地端運行的 Ollama 服務，實現本地化 AI 應用（需設定 URL 和模型名稱）。
配置提示：：若選擇 Gemini API Key 或 Ollama，請務必填寫相應的 Key 或 URL 資訊，以確保 AI 服務能正常連線。
🔧 建置主程式資料庫設定 (Firebase)
本系統需要連接到 Google Firebase 資料庫才能運作，您需自行按照本說明完成建置後，才可正常使用。所有題庫資料、測驗記錄和即時測驗狀態皆儲存在此。
注意：：這是啟用所有功能（尤其是題庫儲存和即時測驗）的必要步驟。
1. 建立 Firebase 專案並啟用服務
- 前往 Firebase Console，建立一個新專案。
- 啟用 Firestore Database：：選擇「建立資料庫」，並選擇在「測試模式」中啟動。
2. 取得您的 Firebase 設定值
- 在「專案設定」中，點擊「新增應用程式」並選擇「網頁」圖示 (
</>)。 - 複製
firebaseConfig物件中的六行內容 (不含大括號{}和const firebaseConfig =)。
apiKey: "AIzaSy...",
authDomain: "your-project-id.firebaseapp.com",
projectId: "your-project-id",
storageBucket: "your-project-id.appspot.com",
messagingSenderId: "1234567890",
appId: "1:1234567890:web:abcdef123456"將這六行內容貼到本工具「⚙️ 設定」中的「Firebase Config」欄位。
3. 設定 Firestore 安全性規則 (開放讀寫)
- 在 Firestore Database 頁面，點擊上方的「規則」(Rules) 分頁。
- 將編輯器中的內容替換為以下規則：
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /{document=**} {
allow read, write: if true;
}
}
}此規則允許任何人讀取和寫入您的資料庫，方便個人工具使用。請點擊「發佈」(Publish) 儲存。
❓ 常見問題
Q: 為什麼我不能同時選擇「知識點」和「閱讀理解」題庫？
A: 由於兩種題庫的「難度/層次」標籤體系不同（知識點為 Easy/Medium/Hard，閱讀理解為提取/推論/詮釋/反思），為了確保生成的練習題具備一致的篩選邏輯，系統限制每次只能選擇同類型的題庫進行生成。
Q: Google 表單的 GAS 程式碼要怎麼用？
A: 請在 Google 表單編輯介面，進入「指令碼編輯器」（通常在右上角三點選單）。將程式碼貼入並執行 createQuizForm 函式。第一次執行時，您需要完成授權，之後程式碼就會自動在您開啟的表單中建立所有題目、選項、正確答案和分數。
Q: 我可以混合使用不同的 AI 來源嗎？
A: 系統設計為單一 AI 來源。在「⚙️ 設定」中，您必須且只能選擇一種 AI 來源（預設 Gemini、Gemini API Key 或 Ollama）並進行配置。如果需要更換，請回到設定面板進行切換。