小桃子 2.0 系統白皮書｜國中＋國小雙學制五科分類架構完整功能總覽

👨‍🎓 學生端功能 (Frontend)

登入與身分系統

Google 帳號綁定（電腦版 Popup + 手機版 Redirect 雙軌無縫切換）。
手動輸入班級/座號/姓名登入（支援無 Google 帳號的離線情境）。
座號衝突即時檢測：精準阻擋佔用他人座號。
NEW 班級選單只列老師設定的「使用中的班級」，最近用過的置頂；未設定時依年級分組——不必從 101 捲到 910。
NEW 老師專用登入：只需教師代碼，不必為了讓按鈕亮起來亂填班級座號。
跨裝置資料恢復：換裝置登入時，自動從雲端合併錯題本與答題紀錄。
NEW 多科目動態適配：國中國文十全戰力（10 維度）、國小 PIRLS 閱讀歷程（4 層次）、英文（6 維度）、自然（7 維度）、社會（6 維度）。切換依據＝題庫裡實際存在哪一科的分類（getActiveCats() 掃描題庫判定），沒有「切換科目」的按鈕；新科目由老師以透視鏡 6 碼或 CSV 匯入帶進來，學生出題只能從題庫已有的科目分類中選。兩科以上並存時分類會合併列出。

四大陣營系統 (RPG 化)

破曉之鋒 / 蒼穹逐日 / 龍影之銳 / 浪峰破軍，一經選定不可更改。
NEW 陣營記憶綁「班級-座號」上雲：換平板、清快取、共用平板都不必重選（教室平板是輪流共用的）。
NEW 教主分數改成三格＋平衡獎金：✏️ 出題（出題×5、被挑戰×1）＋ 🧠 練習（記牢×5）＋ 💬 助人（寫解析×2、獲讚×2、糾錯被接受×3、老師精選×10），三格加總後再加「最弱那一格×3」。
舊公式答題 0 分、而「被挑戰」是永久複利 → 最優解就是一直出題、不回來練習。新公式沒有上限、做任何事都不會扣分（單調性有測試釘住），但獎金由最弱那格決定，只猛攻一種贏不了。學生首頁直接標出最弱是哪一格。
🧠 練習格算的是記牢題數（間隔後仍答對），亂點刷不出來。
NEW 陣營戰與教主一律以「班」為單位：不然累積久的班會包辦全部陣營的教主，新班永遠排不上。
NEW 教主特權真的開通：班內積分最高者自動加冕，可在首頁直接改本班陣營名稱、全班同步；每次改名記錄操作者，老師可覆寫或重置。

出題工作坊 (UGC 創造)

內建國文 10 維度＋PIRLS 4 維度＋英文 6 維度＋自然 7 維度＋社會 6 維度；學生只能從「題庫目前已有的科目」中選分類（新科目由老師匯入帶進來，學生不會誤送錯科目的題）。
三種署名模式：真名 / 匿名 / 自訂江湖化名。
NEW 支援圖表多媒體出題：支援學生上傳圖片輔助說明。內建「Canvas 智慧壓縮引擎」，自動將大圖瘦身並無感上傳至 Firebase 雲端圖床，確保大廳瀑布流載入毫秒級順暢，且搭配「U10 鐵壁防禦」完美解決多頁列印跑版問題！
NEW 防手滑草稿引擎：即時存入 localStorage，跳出頁面也能完美還原進度。
NEW 連續出題鎖定模式：勾選「📌 鎖定分類與來源」後，送出題目僅清空題幹與選項，保留分類、來源等設定，連出同一課的題目效率翻倍。
NEW 🎤 語音輸入雙軌：電腦端（Chrome/Edge）題目與解析欄位內建 Web Speech API 語音辨識按鈕；行動端自動提示使用鍵盤內建麥克風，打字與口說零死角切換。
來源追蹤（課本/考題/辭典等），支援多重細部欄位。
NEW 🤖 「用 AI 幫忙想的」誠實標記：勾選不扣分、不刁難，只是讓老師知道這題要多查一次。注音／字形／成語本義／典故出處這類答案唯一、可查證的題目正是 AI 最會用肯定語氣講錯的地方，而會去問 AI 的同學多半正因為自己不熟、沒能力判斷——錯的答案進了題庫就是全班一起背錯的。
防洗版機制：出題過程即時比對題庫相似度並顯示百分比，NEW 可展開看相似題全文；送出前再確認一次。
NEW 送出後表單完整重設、被退回的題目「改一下」時題幹／選項／解析／答案／分類整份帶回（不必重打）。

闖關挑戰與互動

隨機 5 題快速挑戰，支援 TTS 語音朗讀（Web Speech API，具備防中斷修復）。
NEW 題目圖片完美渲染，支援鎖死高度防止版面破壞。
NEW 📊 圖表題 Chart.js 視覺化：AI 生成的圖表題自動偵測表格數據，渲染為長條圖/折線圖/圓餅圖，支援「📊 表格 ↔ 📈 圖表」一鍵切換。
連擊特效：連續答對 3 題觸發畫面震動慶祝。
NEW 🎯 實測難度：以全班真實答對率自動分級（≥80% 簡單／50–79% 中等／<50% 困難，答過不足 5 人不下判斷）。闖關大廳新增「挑戰度」分頁，另可直接練「被最多人收藏」與「同學說讓我學到東西」的題目。
NEW 🧠 記憶型題目的間隔複習：字音／字形／字義／成語／語文常識／國學常識答對後不會永久消失，而是排到 1→3→7→14→30 天後再回來，答錯打回第一格。首頁出現「今天該複習 N 題」主動敲門。閱讀理解類不進排程（懂了就是懂了）。排程跟著「班級-座號」上雲，換平板不會忘記該複習什麼。
NEW 🏅 「記牢」用答對證明，不是用勾的：要間隔拉開之後還連續答對，系統才標記牢。弱點特訓對記憶型改讀這份排程——不再「答對過就永久排除」（那等於在他答對的那一刻放棄複習他）。
NEW ⭐ 收藏：私人書籤，綁「班級-座號」上雲，首頁一鍵重練；題目只記收藏人數、不記名單。
NEW 💡 同儕肯定「這題讓我學到東西」：答過該題才出現按鈕、一人一次可收回、作者不能按自己、學生端不顯示數字與排行。
NEW 多解判定：老師接受的替代答案在闖關與 Live 都會標綠打勾（不再出現「分數算對、畫面標紅」的矛盾）。
社群解題與投票：「我也來解」共創解析，按讚機制寫入雲端 Transaction 防衝突。

墨香錯題本 & 出版引擎

自動收集錯題，內建「康乃爾筆記法」雙欄排版。
Retina 級手寫畫布：支援二次貝茲曲線平滑、自訂顏色與橡皮擦。
NEW 📷 紙本筆記拍照上傳：一鍵拍下手寫講義或測驗卷，自動壓縮上傳至雲端，完美嵌入該錯題下方，數位與紙本學習軌跡無縫融合。
NEW ☁️ 手寫畫布雲端儲存：畫布筆記自動上傳至 Firebase Storage（僅存 URL），大幅降低 Firestore 文件大小與 localStorage 佔用，支援離線降級。
NEW 艾賓浩斯盲盒不再漏題：舊版只在第 1／3／7 天各開 24 小時的窗，錯過就永遠不再出現（放個週末那題就消失了）。現在改成「還沒證明記牢、且距離上次至少一天」就該回來，最久沒碰的排前面，沒有上限。判斷「記牢了沒」跟複習排程共用同一個標準，畫面不會再自相矛盾。
列印出版引擎：自訂標題、主題色、一鍵「遮蔽答案」，原生支援 iOS 完美多頁列印。
NEW 刪除錯題確認機制：防止誤觸垃圾桶圖示遺失手寫筆記。

個人戰情室 & 家長報表

近 7 次答題折線圖與學習戰力雷達圖。
AI 弱點指引：自動偵測並提示最弱分類（國中十維度 / 國小 PIRLS 四層次）。
三軌成就徽章：出題 / 闖關 / 解題（分數量與質量雙指標）。
家長安心報表：生成專屬唯讀連結，內建 AI 親師增強指南（含具體稱讚與生活化策略，國小 PIRLS 模式提供閱讀歷程維度建議）。
NEW 🔐 家長連結隨機化：報表連結改用 12 位隨機 token（62¹² 種組合），取代可猜測的班級座號格式，防止學生資料被逐一列舉。
NEW 🔬 落地版 AI 診斷系統：錯題解剖（拆解思考盲區）、弱點特訓（直擊最弱維度，自動過濾已答對題目）、強項訣竅（鞏固優勢方法），搭配答題趨勢折線圖追蹤每週進步幅度。
NEW 📈 答題趨勢折線圖：依週統計正確率 + 答題量雙軸圖表，學習節奏與進步軌跡一目了然。
NEW ⚔️ 五科戰力分析：國中十維度、國小 PIRLS 四層次、英文/自然/社會各科維度，自動計算各維度正確率並生成戰力雷達圖。

離線與 PWA 支援

Service Worker 離線快取：核心頁面與 CDN 資源預先載入，斷網也能使用基本功能。
離線佇列：斷網時出題/答題操作自動暫存，恢復連線後無感同步至雲端。
PWA 安裝支援：可直接加入手機桌面，擁有原生 App 般的全螢幕體驗。

無障礙與操作體驗

View Transitions API 頁面轉場動畫：畫面切換絲滑不閃爍。
鍵盤快捷鍵：ESC 關閉所有 Modal、Enter 鍵快速下一題。
ARIA 語意標籤：所有主要視圖與 Modal 均具備無障礙標記。
XSS 防護：所有使用者輸入內容均經 escapeHTML 過濾，防止惡意注入。
行動裝置優化：支援 iOS safe-area、44px 觸控熱區、`prefers-reduced-motion` 減動畫模式。

👩‍🏫 教師總監後台 (Admin)

存取控制與隱身術

嚴格白名單信箱驗證（僅限指定總監登入）。
NEW 總監隱身術：老師登入時自動指派虛擬身份 (Admin, 00號)，完美解決佔用學生座號與 Live 測驗發射的衝突。

審核與糾錯中心

逐題核准/退回，或一鍵批次處理全部待審題。
NEW 🔎 待審四個篩選 chip：全部／ ⚠️ 要查證／ 🤖 有用 AI ／ 🔁 疑似重複（數字為 0 的不出現）。「要查證」＝ AI × 記憶型——最危險的交集。批次核准前會指名「其中 N 題是用 AI 出的記憶型題」並建議先逐題看；批次按鈕文案跟著篩選走（「核准這 7 題」而非「全部」）。
NEW 退回一律附理由：8 項快捷勾選（題幹錯字／選項不合理／答案有誤／解析不清楚／重複／與課程無關／圖片沒標來源／太簡單）＋自由補充，理由直接顯示在學生的「我出的題目」，並在「改一下重送」時再提醒一次。
NEW 撞題全文對照：待審卡片可攤開與題庫既有題目逐項並排比對（題幹／四選項／正解），完全相同的欄位標紅底——不必再靠片段猜要不要退。
NEW 審核與糾錯畫面全面支援圖片預覽。
NEW 糾錯處理四選一：採用（記給回報者 +3）／接受多解／改內容／駁回；另可把整題退回給作者重寫，不必刪題。
NEW 老師可自訂多解：任一題直接點選「哪些選項也算對」，不必等學生在回報裡指定；接受多解後全班之後答那個選項都給分。
NEW 狀態／退回理由／糾錯記分同一次寫入一起成功或一起還原，不會出現「題目退回了但同學沒記到分」。
NEW 雲端同步狀態列：顯示最後同步時間與待審／糾錯筆數，切分頁自動抓、45 秒背景抓、隨時手動抓；Google 登入失效會轉紅字警告並提供一鍵重新登入。
段考封存機制：自訂封存標籤，題目自大廳下架但保留所有數據。

題庫全能編輯器

支援關鍵字即時搜尋（內建防抖動效能優化）。
無限制編輯題幹、選項、正解、解析與狀態，修改後自動同步更新首篇解答。
NEW 📥 CSV 批次匯入引擎：一鍵上傳 CSV 檔案，瞬間灌入數十題至題庫，狀態直接為「已核准」，支援中英文欄位名稱與引號內逗號，自動辨識國中/國小分類模式，新班級暖機零成本。
NEW 🚪 透視鏡 6 碼傳送門：與《試題透視鏡》生態系連動，輸入 6 碼即可將 AI 題卷一鍵匯入題庫——國中國文、國小國語（PIRLS）、英文、自然、社會五科全面支援，題目分類自動對應，含獨立閱讀素材展開框，支援超長文本與表格自動渲染。
NEW 🔬 會考仿生題六碼匯入：透視鏡的「會考仿生類題」現已完整支援六碼管線——仿生題可合卷分享、Word 教用／學用匯出，並透過六碼直接匯入小桃子題庫，文言文註釋（notes）完整保留。
NEW 🤖 AI 快捷微調 + 對話式微調：在編輯器內一鍵呼叫 Claude AI 調整題目——降低難度、提高難度、改寫選項、換題幹、加長解析五大快捷指令，或開啟對話模式用自然語言指示 AI 精修（如「選項 B 換個說法」「題幹改成反面問法」），修改結果即時回填欄位，老師微調零門檻。

AI 寫作命題助手

NEW ✍️ 六種寫作題型生成：議論型（情境兩難＋正反觀點）、情境型（生活場景描述）、圖表型（統計數據分析）、多文本型（2-3 篇短文對照）、引導式（名言／短詩延伸）、圖像敘事型（六格漫畫分鏡腳本）。
NEW 📝 會考六級分評分規準：自動對齊官方四大面向（立意取材、結構組織、遣詞造句、錯別字格式標點），含六級分～零級分完整判準。
NEW 👩‍🏫 教師備課筆記：每題自動生成預期論點 3-4 個、常見偏誤 2-3 個、教學切入點，以及學生思考鷹架（4-5 個腦力激盪問題）。
NEW 📄 Word 教用卷／學用卷匯出：教師版含評分規準與備課筆記，學生版僅含題目與回答空間。支援列印版一鍵輸出。
支援 9 大主題：校園生活、家庭關係、社會議題、科技與生活、自然與環境、成長與自我、文化與傳統、倫理與價值、自訂主題。
支援國七、國八、國九（會考）三年級適配。

學生狀態監視器

五維度核心數據：出題/答題/正確率/解題/獲讚。
真實雷達圖：強制拉取 Firebase 雲端真實數據，非本機快取。
完整出題足跡追蹤：揭露匿名/化名背後的真實姓名與信箱。
一鍵列印獨立學生 A4 戰報，防破版技術支援。

數據分析儀表板

單班 / 全年級 / 全校三段式範圍切換。
分類與來源分佈長條圖。
全班參與度交叉排行，以及「最難 TOP 5 殺手題」自動盤點。
陣營教主管理：每班各自一份名單，可強制覆寫/重置不雅的陣營名稱。
NEW 💚 同儕肯定統計：列出被同學按最多「這題讓我學到東西」的題目與出題者。學生端完全看不到這些數字——設計上刻意不做公開排行，避免變成人氣比賽，統計只給老師當精選與表揚的依據。
NEW 🔬 全班盲點分析：AI 自動彙整全班高錯誤率題目，識別共同知識盲區，生成精準補救教學建議。
NEW 🎯 結構化陷阱分析（trapTypes）：AI 自動萃取每題的誘答陷阱類型（如字形混淆、語境誤判、數據誤讀等），老師可精準掌握哪些陷阱類型最常絆倒學生。
NEW 📊 真實會考 ABC 群數據：透視鏡匯入的仿生題攜帶原題 ABC 群選答分佈與鑑別度指標，老師可直接比對仿生題與原題的難度對標情況。

Live 即時競技場

勾選題目建立自訂題卷，設定倒數計時（10-120秒）。
NEW 題型篩選＋整批勾選：全選／全不選／反向選取／隨機 5 題／隨機 10 題／清空；整批只作用在目前篩選看得到的題目，並保留其他題型已勾好的。
NEW 跨班級發射器改用可點選的班級標籤（手機上的多選下拉只會顯示「0 個項目」，等於不能用）。
一鍵發布，全班畫面瞬間切換為全螢幕同步測驗。
NEW 發射前先確認雲端真的收到才切換畫面，失敗當場說明原因——不再出現「老師這台跳出題目、全班平板卻沒反應」。
NEW 題目內容內嵌於 session：平板題庫快照較舊也能正常出題。
即時監控作答人數，測驗結束自動生成全班分數長條圖與錯誤率排行榜。
NEW 💓 心跳偵測機制：老師端每 15 秒更新 heartbeat，學生端自動偵測超過 2 分鐘無心跳的孤兒 session，避免老師關閉瀏覽器後學生被困住。
NEW 教師答題隔離：老師預覽 Live 測驗時的作答不計入學生統計。

✍️ Live 手寫收答（非選擇題）

NEW 老師出一題（例：寫出「ㄆㄤˊㄅㄛˊ」的國字），全班畫面跳出全螢幕手寫板；學生用手指或觸控筆寫，送出後縮圖即時長在老師的收答牆上——誰交了、誰還沒交一眼看完。
NEW 圈改：老師點縮圖放大，紅筆直接圈在學生的字的筆畫上；判 ❌ 時另開「正確寫法」框，手寫示範一次跟著批改一起存起來。
NEW 匿名共學：可以全部放、只放勾選的、或排除某幾位；一次一張放大或 4／6／9 宮格。放出去的資料裡沒有座號姓名（不是畫面上不顯示，是資料層根本沒有），圖片檔名也是隨機的。
NEW 收卷與結束分開：收卷後學生不能再交，但老師還能繼續圈改、繼續投影講解。
NEW 沒改完不會消失：待改清單住雲端，下課換一台裝置登入點開就繼續改；進度顯示「已批改 N／M」，可只看沒改的。
NEW 學生收得到批改：登入看到「老師改好了 N 題」，看得到自己的字＋紅圈＋正確寫法；寫錯的自動進重寫排程（1／3／7／14／30 天回來找他，到期後寫對才算熟練）。
NEW 計分誠實：未交是空位不是答錯，沒改完的不冒充對或錯；「最多人錯的字」只給老師看，可一鍵複製成下次的錯字清單。
斷網不掉件：送出失敗會自動重送，學生畫的字不會消失；學校網路擋掉圖片儲存時自動改走縮圖內嵌，課照上。

進階演算法

學習一致性演算法：計算登入活躍日與間距標準差，評估「規律度」。
爆發力演算法：滑動視窗計算「3天內最大產出」，精準捕捉學習狂熱期。

報表匯出與引導

學生個人報表一鍵匯出 PDF（html2pdf.js 按需動態載入，首次使用才下載，不拖慢頁面）。
空題庫智慧引導：當班級尚無題目時，自動顯示友善引導提示，降低師生焦慮。