老師手冊：出題、班級與成績

PART A · 概念

系統概念：三種用法、四種介面

四種作答介面、三條學習路線

四種介面共用同一套題庫與測資。三條路線的獎牌、學習積分和全國排行各自計算（C++ 有自己的排行榜）；同一題用第二種語言再完成，遊戲幣給一半。

PART B · 出題

用題庫編輯器出題

出題工具是「題庫編輯器」，用瀏覽器打開就能用，不需要登入。

1. 填題組資訊：題組名稱（目錄顯示用）、分類（可從學習地圖標籤下拉，或自己打，如「S1 迴圈」）、檔名（決定匯出的檔名）。
2. （選用）載入標籤字典：開頁會自動讀同資料夾的 tag-dictionary.json，當分類與知識點的下拉選單。
3. 新增題目：每題填標題、知識點標籤、說明，再加測資。
4. 每筆測資：輸入（多行，每行是一次輸入）、預期輸出、分數，可以勾「範例（公開）」。同一份題目可以用 Blockly、Scratch、Python、C++ 任一介面作答，不用另外出 C++ 版。
5. 組卷與匯出：從題庫挑題組成一份試卷，匯出 .txt（明碼）或 .txt.enc（加密）。這個檔案可以直接上傳到「教師管理」的試卷庫，變成班級測驗（見 PART G）。

PART C · 格式

題目檔 .txt 格式

題庫編輯器匯出的就是這個格式。要手改也可以：

題目：計算兩數相加
說明：輸入兩個整數，輸出它們的和。

筆數：2

輸入1_1：5
輸入1_2：3
輸出1：8
分數1：50
範例1：1

輸入2_1：100
輸入2_2：150
輸出2：250
分數2：50
（下一題從「題目：」再開始…）

PART D · 帳號

申請教師帳號與登入

1. 首頁按「🏫 教師管理」，切到「申請帳號」，填姓名、學校、Email、密碼（8 字以上）送出。系統會給一組申請編號（記在這台電腦）。
2. 等管理員審核。可以在「查詢申請」用申請編號查看狀態。
3. 核准後用 Email＋密碼登入。登入有效 14 天；右上可以「改密碼」。

PART E · 班級

建立班級、學生加入

建立班級

1. 在班級列表頁「➕ 建立班級」填班級名稱、座位數（1～40），選加入方式：
   ・簡易模式（預設）：學生輸入班級代碼＋座號＋自己設定的 4 位數密碼。
   ・座位卡模式：每個座位多一組加入碼，老師列印座位卡發給學生，可以防止有人冒用別人的座號。
2. 建立後會得到 6 碼的班級代碼，寫在黑板上給學生；或到「👥 座位與加入」按「📱 學生登入 QR code／連結」，讓學生掃描登入（見下方）。

學生怎麼加入

• 首頁「🏫 登入班級」，或答題頁左下角「🏫 加入班級」，或遊戲大廳「🏫 我的班級」。
• 📱 掃 QR code：用平板或手機相機掃老師投影或列印的 QR code，班級代碼會自動填好，學生只要輸入座號和密碼。
• 輸入班級代碼、座號、4 位數密碼。第一次輸入的密碼就是他的密碼，之後在任何電腦都用同一組登入。
• 「這是學校共用電腦」預設勾選：關閉瀏覽器就自動登出，進度先存回雲端，下一位同學不會用到上一位的資料。
• 用完請學生按「登出」。

「👥 座位與加入」分頁

🤝 協同老師（協同教學）

1. 班主（建立班級的老師）在「👥 座位與加入」分頁最下方「🤝 協同老師」按「➕ 產生邀請碼」。
2. 把邀請碼給要協同的老師（不限學校，必須是核准過的老師帳號）。對方在教師管理首頁「🤝 協同教學邀請碼」輸入，就會成為協同老師。邀請碼用一次就失效；每班最多 5 位協同老師。
3. 協同班級會出現在協同老師的班級列表，標示「🤝 協同」與班主姓名，不占協同老師的名額。

PART E-2 · 參考解答

參考解答開放方式

學生很容易一卡住就直接看參考解答。老師可以依班級決定學生什麼時候能看。設定位置：班級頁「👥 座位與加入」分頁的「📖 參考解答開放方式」卡片，按一下就切換；班級頂端的統計列也會顯示目前的狀態。

• 設定在學生端 15 秒內生效，不用請學生重新登入。
• 只影響 Blockly／Scratch 的「參考解答」分頁；設為「僅教師」時，小白板流程圖也無法選「參考解答」當來源。Python、C++ 介面沒有參考解答分頁，評分未過時會顯示「💡 想一想」，再沒過一次顯示「🔑 進一步提示」（第一筆沒通過的預期輸出與實際輸出）。
• 在「通過後才開放」和「未過 2 次解鎖」模式，示範題的「🧭 指引」仍然保留，當作教學鷹架。
• 老師用「👀 預覽學生答題介面」時，一律可以直接看參考解答。
• 班級測驗中本來就看不到參考解答與指引，不受這個設定影響；作業則依這個設定。

PART F · 進度與作答

看進度與作答

學生每次在答題頁按「評分」，成績和當下的程式（或積木）就會自動傳上來。教師管理每分鐘自動更新，也可以按「🔄 重新整理」。

Python、C++ 和積木（Blockly／Scratch）分開計算，上方的「全部／🐍 Python／⚙️ C++／🧩 積木」可以切換。按「看程式」時，C++ 作答會以 C++ 程式碼顯示。

作答旁的標記

PART F-2 · 學生回報

學生回報問題與測驗舉手

學生在答題頁左下角按「🙋 回報問題」（測驗中是底部的「🙋 舉手」），選類型（看不懂題目／測資好像有錯／系統出錯／其他）、寫下問題送出。系統會自動附上題組、第幾題、介面，學生也可以勾選附上程式和最近一次評分結果。

1. 在哪裡看：班級列表的班級卡片、班級頁的「💬 學生回報」分頁都會顯示未處理的數量。
2. 處理：每則回報可以看說明、展開評分結果、按「看程式／看積木」；在輸入框寫回覆按「回覆」（會自動標為已處理），或直接「標為已處理」、刪除。
3. 學生看到回覆：學生下次打開答題頁會跳出通知，「🏫 我的班級」也會顯示；回覆後可以看到「學生已讀」。
4. 同一題多人回報測資有錯：分頁上方會集中提醒「某題：N 人回報測資有錯」，請檢查題目或測資。
5. 測驗中舉手：測驗成績表該生座號旁出現 🙋，點一下就能回覆；學生的作答畫面約 30 秒內會跳出你的回覆。

PART G · 測驗

班級測驗與試卷庫

組好的試卷存進試卷庫，就能一次發佈到多個班級，也能用分享碼分享給其他學校的老師。發佈時可以選「📝 測驗」或「📘 作業」。學生不用輸入題組網址，從選單按「開始」就作答。

1. 存入試卷庫

1. 教師管理的班級列表頁，找到「📚 我的試卷庫」。
2. 選擇題庫編輯器匯出的 .txt 或 .txt.enc，系統會先顯示幾題、滿分多少。
3. 填試卷名稱，按「📥 存入試卷庫」。每位老師最多 100 份；可以改名、下載原檔、刪除。

2. 發佈到班級

1. 按試卷旁的「📤 發佈到班級」，勾選一個或多個班級。
2. 設定測驗名稱、作答介面、作答時間、是否立即開放、是否允許自行重考，按「📤 發佈」。有班級沒發成功（例如已有同名測驗）會列出原因。
3. 也可以在班級裡的「📝 測驗」分頁，從「試卷來源」選試卷庫的試卷；或選「上傳新的題組檔」，預設會同時存入試卷庫。

測驗的防作弊選項

• 每人題目順序隨機：每位學生看到的題目順序不同（同一人重新整理不會變）。
• 隨機抽題：例如 10 題抽 5 題，每人抽到的題目不完全相同；成績表中沒抽到的題目是灰底，總分顯示「得分／該生滿分」。
• 離開畫面偵測：測驗中切換到其他分頁、視窗或縮小瀏覽器會記一次，成績表顯示「離開畫面 N 次」（3 次以上標紅）。只是提醒，不會擋學生。

3. 學生作答時

• 學生登入班級後，首頁和遊戲大廳「🏫 我的班級」會出現「📝 本班測驗」，按「▶ 開始」就計時。
• 畫面底部顯示剩餘時間和「✅ 交卷」。時間到自動交卷；不小心重新整理會接續作答，計時不會重來。
• 測驗中看不到參考解答與指引，不能換題組，也不會拿遊戲幣。
• 只有按過「評分」的題目才有成績。考前提醒學生：每題寫好就按評分，可以多次評分，取最高分。
• 評分由伺服器進行，測驗時電腦要能連網。

4. 看成績與管理

• 在「📝 測驗」分頁按「看成績」：座號 × 題目的分數表，每人的狀態（未開始／作答中／已交卷／時間到未交卷）、總分、全班平均、最高最低、每題通過人數。
• 分數顏色：綠＝滿分、橘＝部分、紅＝0 分；點分數可以看學生的程式或積木。⚠️ 表示寫死答案或匯入／貼上，滑鼠移上去看原因。
• 可以匯出 CSV、列印。
• 📺 即時排名：成績表上方按「📺 即時排名」開啟投影用的大字畫面，每 10 秒自動更新；依總分排名（同分時先達到的在前），顯示名次變化 ▲、每題完成情況和作答狀態。預設只顯示座號，可以勾「顯示姓名」或只顯示前 5／10 名，按「⛶ 全螢幕」投影到教室螢幕。
• 單一學生要重考：按該列的「重考」，他可以重新開始（重新計時），成績取最高分。
• 個別延長：按該列的「延長」輸入分鐘數（負數可減少），作答中的學生約 30 秒內生效，畫面會提示「老師延長了你的作答時間」。也可以在學生開始前先設定（例如特教生）。
• 📊 公布成績：在測驗清單按「公布成績」，學生交卷（或時間到）後，可以在「我的班級」按「📊 看成績」，看到每題分數和每筆測資的 ✓／✗（隱藏測資只顯示對錯，不顯示內容）。可以隨時「取消公布」。
• 作業按「看進度」：每人的完成題數、全部完成、遲交（截止後才完成）；可以「改截止」。用預設題庫出的作業，學生之前練過的題目也算完成。
• 測驗清單可以關閉／開放、改時間、切換是否允許重考、刪除（可選擇要不要連成績一起刪）。關閉後學生看不到也不能開始，但已在作答的同學仍可在時限內交卷。
• 刪除試卷庫的試卷，不影響已經發佈到班級的測驗。

5. 和其他老師分享試卷（分享碼）

1. 在試卷旁按「🔗 分享」→「產生分享碼」，會得到一組 8 碼分享碼（例如 QX7K-29PM）。可以選擇有效期限（不限、1／7／30 天）和使用次數上限。
2. 把分享碼傳給其他老師，不限學校。對方在自己的「📚 我的試卷庫」→「🔑 分享碼」輸入，就會複製一份到他的試卷庫，可以直接發佈到他的班級。
3. 你看得到「加入過的老師」（學校、姓名、時間）；隨時可以「停止分享」或「重新產生」，舊的分享碼立刻失效。

• 只有核准過的老師帳號能用分享碼，學生拿到也無法使用，隱藏測資的答案不會外流到學生手上。
• 對方拿到的是複製的一份：你之後修改或刪除，不影響對方；停止分享也不會收回已經加入的。
• 試卷會標示「來自：學校 老師」，對方再分享出去，仍然保留原出題者。

PART H · 分析與報告

知識點分析與學習報告

🧠 知識點

班級頁「🧠 知識點」分頁依題目說明裡的「標籤：迴圈・累加累乘」統計：每個知識點的題數、作答人數、通過率（綠≥80%、黃≥50%、紅<50%）與平均次數，通過率最低的排最上面，方便決定上課要加強什麼。下方「熱力圖」是學生 × 知識點，一眼看出誰卡在哪裡。「個別學生」分頁也會列出該生的強項與建議加強的知識點。

🖨 學習報告

• 「個別學生」分頁按「🖨 學習報告」，或「⤓ 匯出」分頁按「🖨 產生全班學習報告」（每人一頁）。
• 內容：學習摘要（通過題數、銀牌金牌、理解值、匯入次數）、近 8 週每週通過題數、主題進度、知識點強弱、測驗成績、作業完成、老師評語欄。
• 在新視窗按「列印 / 存成 PDF」。姓名來自這台電腦的座號姓名對照，伺服器不會有學生姓名。

PART I · 備份

備份與還原

1. 下載完整備份：班級裡「⤓ 匯出」分頁 →「💾 下載完整備份」。一個 .json 檔，包含班級設定、所有作答紀錄與程式、學生雲端進度（遊戲幣、獎牌、寵物、學習地圖）、班級測驗，以及這台電腦上的座號姓名對照。
2. 還原：班級列表頁「⤒ 從備份還原班級」選備份檔，會建立一個新班級（新的班級代碼）。學生用新代碼＋原座號＋原密碼登入即可；還原的測驗預設是關閉的。

每年 1、6、7 月，教師管理首頁會提醒「30 天內沒有下載過完整備份」的班級，點一下就到下載頁；可以按「7 天內不再提醒」。系統也會自動清理過舊的資料（已處理超過半年的學生回報、失效的邀請碼與分享碼），學生作答和班級不會被清掉。

PART J · 防作弊

防作弊機制與限制

PART K · 排解

常見問題