PART A · 概念
系統概念:三種用法、四種介面
👀老師預覽
老師登入「教師管理」後,在班級列表下方的「👀 預覽學生答題介面」按 Blockly/Scratch/Python/C++,會在新分頁開啟學生的畫面,可以試做內建題庫,不會產生學生紀錄。沒有登入的人看不到這個入口。
🏫加入班級練習
學生用「班級代碼+座號+自設 4 位數密碼」登入。按「評分」的成績和程式會自動傳給老師,遊戲幣、獎牌等進度存在雲端,換電腦也能接著做。
📝班級測驗
老師把組好的試卷發佈到班級。學生從選單按「開始」就作答,限時、不能看解答,由伺服器評分。
四種作答介面、三條學習路線
| 介面 | 學習路線 | 說明 |
| 🧩 Blockly、🐱 Scratch | 🧩 積木 | 拖拉積木;有示範題的「🧭 指引」與「參考解答」分頁。 |
| 🐍 Python | 🐍 Python | 文字寫程式;沒有參考解答分頁,評分未過顯示提示。 |
| ⚙️ C++ | ⚙️ C++ | 瀏覽器內編譯執行(clang,C++17),不用安裝軟體、不用評測伺服器;銜接 APCS 與程式競賽。沒有參考解答分頁,評分未過顯示提示。 |
四種介面共用同一套題庫與測資。三條路線的獎牌、學習積分和全國排行各自計算(C++ 有自己的排行榜);同一題用第二種語言再完成,遊戲幣給一半。
C++ 介面須知
學生第一次開啟要下載約 19 MB 的編譯器,之後瀏覽器會快取;上課第一次使用前,建議先讓每台電腦開一次 C++ 介面。支援 bits/stdc++.h 與 STL;不支援 try/throw、thread、讀寫檔案。每筆測資執行上限 3 秒。評分只忽略行尾空白,中間空白或換行不同會判錯(和 Python 相同)。
🧪 教學工具:程式模擬器
教師管理首頁的「🧪 教學工具:程式模擬器」卡片有 🐍 Python 模擬器 和 ⚙️ C++ 模擬器,上課講解、示範除錯用,不需登入、不計分。內建教學範例與程式片段,可放大字體投影;Python 可按「👣 逐步執行」一步一步播放,看目前執行到哪一行、變數與函式呼叫堆疊怎麼變化。學生面板「📚 開始練習」也有入口。
PART B · 出題
用題庫編輯器出題
出題工具是「題庫編輯器」,用瀏覽器打開就能用,不需要登入。
- 填題組資訊:題組名稱(目錄顯示用)、分類(可從學習地圖標籤下拉,或自己打,如「S1 迴圈」)、檔名(決定匯出的檔名)。
- (選用)載入標籤字典:開頁會自動讀同資料夾的
tag-dictionary.json,當分類與知識點的下拉選單。
- 新增題目:每題填標題、知識點標籤、說明,再加測資。
- 每筆測資:輸入(多行,每行是一次輸入)、預期輸出、分數,可以勾「範例(公開)」。同一份題目可以用 Blockly、Scratch、Python、C++ 任一介面作答,不用另外出 C++ 版。
- 組卷與匯出:從題庫挑題組成一份試卷,匯出 .txt(明碼)或 .txt.enc(加密)。這個檔案可以直接上傳到「教師管理」的試卷庫,變成班級測驗(見 PART G)。
「範例(公開)」勾與不勾
勾了:這筆會出現在學生的「自行測試」,顯示輸入與預期輸出。不勾:只用來評分,學生看不到(隱藏測資)。建議留 1~2 筆公開當示範,其餘設隱藏。班級測驗中,隱藏測資的預期輸出只存在伺服器,學生在瀏覽器裡找不到。
明碼 .txt 還是加密 .enc?
放在公開網路(例如 GitHub)的練習題庫建議用 .enc,避免學生直接翻到答案;老師發佈作業選「題組網址」時,填同名的 .txt 網址即可,系統會自動找 .enc 解密。上傳到試卷庫兩種都可以。
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
(下一題從「題目:」再開始…)
| 欄位 | 意義 |
| 題目: | 一題的開始,也是題目名稱(同一份試卷裡不要重複)。 |
| 筆數:N | 這一題有幾筆測資。 |
| 輸入N_1、輸入N_2… | 第 N 筆測資的輸入;每行代表程式的一次輸入。 |
| 輸出N | 第 N 筆的預期輸出。 |
| 分數N | 第 N 筆通過可得的分數;一題的滿分=各筆分數加總。 |
| 範例N:1 | 把第 N 筆設為公開範例(不寫就是隱藏測資)。 |
PART D · 帳號
申請教師帳號與登入
- 首頁按「🏫 教師管理」,切到「申請帳號」,填姓名、學校、Email、密碼(8 字以上)送出。系統會給一組申請編號(記在這台電腦)。
- 等管理員審核。可以在「查詢申請」用申請編號查看狀態。
- 核准後用 Email+密碼登入。登入有效 14 天;右上可以「改密碼」。
名額
每位老師有學生名額(座位總數)和班級數上限,登入後顯示在最上方。不夠時請洽管理員調整。
PART E · 班級
建立班級、學生加入
建立班級
- 在班級列表頁「➕ 建立班級」填班級名稱、座位數(1~40),選加入方式:
・簡易模式(預設):學生輸入班級代碼+座號+自己設定的 4 位數密碼。
・座位卡模式:每個座位多一組加入碼,老師列印座位卡發給學生,可以防止有人冒用別人的座號。
- 建立後會得到 6 碼的班級代碼,寫在黑板上給學生;或到「👥 座位與加入」按「📱 學生登入 QR code/連結」,讓學生掃描登入(見下方)。
學生怎麼加入
- 首頁「🏫 登入班級」,或答題頁左下角「🏫 加入班級」,或遊戲大廳「🏫 我的班級」。
- 📱 掃 QR code:用平板或手機相機掃老師投影或列印的 QR code,班級代碼會自動填好,學生只要輸入座號和密碼。
- 輸入班級代碼、座號、4 位數密碼。第一次輸入的密碼就是他的密碼,之後在任何電腦都用同一組登入。
- 「這是學校共用電腦」預設勾選:關閉瀏覽器就自動登出,進度先存回雲端,下一位同學不會用到上一位的資料。
- 用完請學生按「登出」。
「👥 座位與加入」分頁
| 功能 | 說明 |
| 📱 學生登入 QR code/連結 | 顯示這個班級的 QR code、班級代碼和登入連結。可以「📋 複製連結」貼到 Google Classroom 或班級群組,或按「🖨️ 列印/投影用大圖」開出大字版,投影到教室螢幕或列印貼在教室。班主和協同老師都可以使用。 |
| 🔒 關閉加入 | 全班加入後建議關閉,避免有人冒用空座號。已加入的學生照常登入。 |
| 📖 參考解答開放方式 | 設定學生什麼時候能看 Blockly/Scratch 的參考解答(見 E-2)。班主和協同老師都可以設定。 |
| 重設密碼 | 學生忘記密碼、或座位被冒用時使用。作答紀錄保留,學生重新加入並設定新密碼。 |
| 清空座位 | 換學生時使用,刪除這個座位所有作答紀錄。 |
| 增加座位/改名/刪除班級 | 刪除班級要輸入班級代碼確認,所有紀錄一併刪除且無法復原(建議先備份)。 |
| 座號姓名對照 | 伺服器只記座號。姓名只存在老師這台電腦,可以匯出/匯入 CSV;換電腦時記得帶過去(完整備份也會包含)。 |
QR code/連結等同班級代碼
拿到連結的人都能用空座號加入,所以可以貼在班級群組,但不要公開貼在網路上。全班加入後按「🔒 關閉加入」,即使有連結也無法再認領空座號。
🤝 協同老師(協同教學)
- 班主(建立班級的老師)在「👥 座位與加入」分頁最下方「🤝 協同老師」按「➕ 產生邀請碼」。
- 把邀請碼給要協同的老師(不限學校,必須是核准過的老師帳號)。對方在教師管理首頁「🤝 協同教學邀請碼」輸入,就會成為協同老師。邀請碼用一次就失效;每班最多 5 位協同老師。
- 協同班級會出現在協同老師的班級列表,標示「🤝 協同」與班主姓名,不占協同老師的名額。
| 功能 | 班主 | 協同老師 |
| 看進度、題目分析、個別學生、看程式、匯出 CSV | ✅ | ✅ |
| 發佈測驗、看成績、開關測驗、讓學生重考 | ✅ | ✅(可用自己試卷庫的試卷) |
| 開放/關閉加入、學生重設密碼、學生登入 QR code/連結 | ✅ | ✅ |
| 清空座位、增加座位、改班名、刪除班級 | ✅ | ❌ |
| 完整備份、還原 | ✅ | ❌ |
| 邀請/移除協同老師 | ✅ | ❌(可以自己「退出協同」) |
座號姓名對照不會自動共享
姓名只存在各自的電腦。班主可以按「⤓ 匯出對照表」,把 CSV 給協同老師「⤒ 匯入對照表」。協同老師退出或被移除後,他發佈過的測驗和學生成績都會保留。
PART E-2 · 參考解答
參考解答開放方式
學生很容易一卡住就直接看參考解答。老師可以依班級決定學生什麼時候能看。設定位置:班級頁「👥 座位與加入」分頁的「📖 參考解答開放方式」卡片,按一下就切換;班級頂端的統計列也會顯示目前的狀態。
| 設定 | 學生端 | 適合 |
| ✅ 通過後才開放(預設、建議) | 這題評分拿到滿分後才能看參考解答,用來對照不同寫法。還沒通過前,評分未過會顯示提示卡。 | 平常練習。舊班級也自動套用這個設定。 |
| 🔓 評分未過 2 次解鎖 | 原本的做法:評分沒通過 2 次就能看。學生容易亂按兩次評分就直接看答案。 | 剛入門、需要多一點鷹架的班級。 |
| 🔒 僅教師 | 學生完全看不到參考解答(伺服器直接拒絕下載解答檔),示範題的「🧭 指引」也一併關閉;提示照常顯示。 | 段考前、想讓學生獨立解題時。 |
- 設定在學生端 15 秒內生效,不用請學生重新登入。
- 只影響 Blockly/Scratch 的「參考解答」分頁;設為「僅教師」時,小白板流程圖也無法選「參考解答」當來源。Python、C++ 介面沒有參考解答分頁,評分未過時會顯示「💡 想一想」,再沒過一次顯示「🔑 進一步提示」(第一筆沒通過的預期輸出與實際輸出)。
- 在「通過後才開放」和「未過 2 次解鎖」模式,示範題的「🧭 指引」仍然保留,當作教學鷹架。
- 老師用「👀 預覽學生答題介面」時,一律可以直接看參考解答。
- 班級測驗中本來就看不到參考解答與指引,不受這個設定影響;作業則依這個設定。
限制
「通過後才開放」由學生的瀏覽器判斷,懂開發者工具(F12)的學生理論上可以繞過;要確實擋住,請改用「🔒 僅教師」(由伺服器把關)。
PART F · 進度與作答
看進度與作答
學生每次在答題頁按「評分」,成績和當下的程式(或積木)就會自動傳上來。教師管理每分鐘自動更新,也可以按「🔄 重新整理」。
🏅學習進度
每位學生的通過題數、綜合驗證題、銀牌金牌、匯入次數,以及每個主題的進度。點一列看該生的作答。
📊題目分析
每題的作答人數、通過率、平均次數、自己完成人數。通過率低、次數高的題目,代表全班卡關,可以上課講解。
🙋個別學生
選座號看他每一題的最高分、最近一次分數、次數、通過時間,按「看程式/看積木」檢視作答。
⤓匯出
匯出 CSV(Excel 可開),可只匯出 Python、C++ 或積木;也可以下載完整備份。
Python、C++ 和積木(Blockly/Scratch)分開計算,上方的「全部/🐍 Python/⚙️ C++/🧩 積木」可以切換。按「看程式」時,C++ 作答會以 C++ 程式碼顯示。
作答旁的標記
| 標記 | 意思 |
| 自己完成 | 通過,而且大部分是學生自己打字或拖積木完成的。 |
| 匯入/貼上 | 通過,但程式大多是匯入或貼上的(可能是抄別人的)。這種情況學生不會拿到遊戲幣和獎牌。 |
| 寫死答案 | 程式裡直接寫出測資的答案(例如 Python 的 if n==10: print(55)、C++ 的 cout << 55;),不是真的算出來。同樣不發遊戲幣。 |
看程式時顯示的是哪一版?
已通過的題目,保存的是通過時的版本;還沒通過的,是最近一次評分的版本。
PART F-2 · 學生回報
學生回報問題與測驗舉手
學生在答題頁左下角按「🙋 回報問題」(測驗中是底部的「🙋 舉手」),選類型(看不懂題目/測資好像有錯/系統出錯/其他)、寫下問題送出。系統會自動附上題組、第幾題、介面,學生也可以勾選附上程式和最近一次評分結果。
- 在哪裡看:班級列表的班級卡片、班級頁的「💬 學生回報」分頁都會顯示未處理的數量。
- 處理:每則回報可以看說明、展開評分結果、按「看程式/看積木」;在輸入框寫回覆按「回覆」(會自動標為已處理),或直接「標為已處理」、刪除。
- 學生看到回覆:學生下次打開答題頁會跳出通知,「🏫 我的班級」也會顯示;回覆後可以看到「學生已讀」。
- 同一題多人回報測資有錯:分頁上方會集中提醒「某題:N 人回報測資有錯」,請檢查題目或測資。
- 測驗中舉手:測驗成績表該生座號旁出現 🙋,點一下就能回覆;學生的作答畫面約 30 秒內會跳出你的回覆。
限制與自學學生
每位學生每 10 分鐘最多回報 3 次(測驗舉手另計)、每天 20 次,內容 300 字以內;回報都綁座號,不是匿名。沒有登入班級的自學學生只能回報「測資好像有錯」,會送給系統管理員處理預設題庫,不會回覆。
PART G · 測驗
班級測驗與試卷庫
組好的試卷存進試卷庫,就能一次發佈到多個班級,也能用分享碼分享給其他學校的老師。發佈時可以選「📝 測驗」或「📘 作業」。學生不用輸入題組網址,從選單按「開始」就作答。
| 📝 測驗 | 📘 作業 |
| 時間 | 限時,時間到自動交卷 | 不限時,有截止日 |
| 參考解答/遊戲幣 | 沒有 | 有(參考解答需用預設題庫或題組網址出題,並依班級的參考解答開放方式) |
| 評分 | 伺服器評分(看不到隱藏答案) | 和平常練習一樣 |
| 題目來源 | 試卷庫、上傳題組檔 | 試卷庫、上傳題組檔、預設題庫、題組網址 |
| 其他選項 | 每人順序隨機、隨機抽 N 題、允許重考、個別延長、公布成績 | 改截止時間;老師看完成度與遲交 |
1. 存入試卷庫
- 教師管理的班級列表頁,找到「📚 我的試卷庫」。
- 選擇題庫編輯器匯出的
.txt 或 .txt.enc,系統會先顯示幾題、滿分多少。
- 填試卷名稱,按「📥 存入試卷庫」。每位老師最多 100 份;可以改名、下載原檔、刪除。
2. 發佈到班級
- 按試卷旁的「📤 發佈到班級」,勾選一個或多個班級。
- 設定測驗名稱、作答介面、作答時間、是否立即開放、是否允許自行重考,按「📤 發佈」。有班級沒發成功(例如已有同名測驗)會列出原因。
- 也可以在班級裡的「📝 測驗」分頁,從「試卷來源」選試卷庫的試卷;或選「上傳新的題組檔」,預設會同時存入試卷庫。
| 作答介面 | 說明 |
| Blockly 或 Scratch | 學生開始時自選,作答中可以切換(各介面的積木各自保留)。 |
| 只用 Blockly/只用 Scratch/只用 Python/只用 C++ | 限定介面,不能切換。「只用 C++」由伺服器用 C++ 規則評分,成績記在 C++ 路線。 |
| 都可以 | 學生開始時從 Blockly、Scratch、Python、C++ 四種中選。 |
測驗的防作弊選項
- 每人題目順序隨機:每位學生看到的題目順序不同(同一人重新整理不會變)。
- 隨機抽題:例如 10 題抽 5 題,每人抽到的題目不完全相同;成績表中沒抽到的題目是灰底,總分顯示「得分/該生滿分」。
- 離開畫面偵測:測驗中切換到其他分頁、視窗或縮小瀏覽器會記一次,成績表顯示「離開畫面 N 次」(3 次以上標紅)。只是提醒,不會擋學生。
3. 學生作答時
- 學生登入班級後,首頁和遊戲大廳「🏫 我的班級」會出現「📝 本班測驗」,按「▶ 開始」就計時。
- 畫面底部顯示剩餘時間和「✅ 交卷」。時間到自動交卷;不小心重新整理會接續作答,計時不會重來。
- 測驗中看不到參考解答與指引,不能換題組,也不會拿遊戲幣。
- 只有按過「評分」的題目才有成績。考前提醒學生:每題寫好就按評分,可以多次評分,取最高分。
- 評分由伺服器進行,測驗時電腦要能連網。
4. 看成績與管理
- 在「📝 測驗」分頁按「看成績」:座號 × 題目的分數表,每人的狀態(未開始/作答中/已交卷/時間到未交卷)、總分、全班平均、最高最低、每題通過人數。
- 分數顏色:綠=滿分、橘=部分、紅=0 分;點分數可以看學生的程式或積木。⚠️ 表示寫死答案或匯入/貼上,滑鼠移上去看原因。
- 可以匯出 CSV、列印。
- 📺 即時排名:成績表上方按「📺 即時排名」開啟投影用的大字畫面,每 10 秒自動更新;依總分排名(同分時先達到的在前),顯示名次變化 ▲、每題完成情況和作答狀態。預設只顯示座號,可以勾「顯示姓名」或只顯示前 5/10 名,按「⛶ 全螢幕」投影到教室螢幕。
- 單一學生要重考:按該列的「重考」,他可以重新開始(重新計時),成績取最高分。
- 個別延長:按該列的「延長」輸入分鐘數(負數可減少),作答中的學生約 30 秒內生效,畫面會提示「老師延長了你的作答時間」。也可以在學生開始前先設定(例如特教生)。
- 📊 公布成績:在測驗清單按「公布成績」,學生交卷(或時間到)後,可以在「我的班級」按「📊 看成績」,看到每題分數和每筆測資的 ✓/✗(隱藏測資只顯示對錯,不顯示內容)。可以隨時「取消公布」。
- 作業按「看進度」:每人的完成題數、全部完成、遲交(截止後才完成);可以「改截止」。用預設題庫出的作業,學生之前練過的題目也算完成。
- 測驗清單可以關閉/開放、改時間、切換是否允許重考、刪除(可選擇要不要連成績一起刪)。關閉後學生看不到也不能開始,但已在作答的同學仍可在時限內交卷。
- 刪除試卷庫的試卷,不影響已經發佈到班級的測驗。
5. 和其他老師分享試卷(分享碼)
- 在試卷旁按「🔗 分享」→「產生分享碼」,會得到一組 8 碼分享碼(例如
QX7K-29PM)。可以選擇有效期限(不限、1/7/30 天)和使用次數上限。
- 把分享碼傳給其他老師,不限學校。對方在自己的「📚 我的試卷庫」→「🔑 分享碼」輸入,就會複製一份到他的試卷庫,可以直接發佈到他的班級。
- 你看得到「加入過的老師」(學校、姓名、時間);隨時可以「停止分享」或「重新產生」,舊的分享碼立刻失效。
- 只有核准過的老師帳號能用分享碼,學生拿到也無法使用,隱藏測資的答案不會外流到學生手上。
- 對方拿到的是複製的一份:你之後修改或刪除,不影響對方;停止分享也不會收回已經加入的。
- 試卷會標示「來自:學校 老師」,對方再分享出去,仍然保留原出題者。
測驗成績也會出現在其他分頁
測驗的作答會以題組名稱「【測驗】測驗名稱」出現在「題目分析」「個別學生」和匯出的 CSV 裡。
PART G-2 · 演算法遊戲
演算法遊戲(團體賽題型)
九個用 Scratch 積木控制角色的遊戲,題型仿照程式設計團體賽,另有一個不寫程式的「🧮 動態規劃練習」。每個遊戲都有「🌱 練習關」循序學習,再挑戰「🏆 挑戰關」(正式題目)。學生登入班級後,一般闖關的最高分會自動上傳(坦克只收自動控制結果;隊伍對戰另行提交),老師也可以自己出題,發佈成班級作業或限時測驗。
| 遊戲 | 題型 | 主要訓練 |
| 🍓 草莓園彈力兔 | 路線規劃 | 事先規劃路線、迴圈與重複、成本(電力)計算、兩個角色分工 |
| 🤖 掃地機器人 | 覆蓋與路徑 | 條件反應、最近的先做、最短路徑、電量規劃、效率比較 |
| 🚌 敬老專車 | 派遣排程 | 資料查詢、找最小值、排序與優先序、時間窗口、多台車指派 |
| 🛗 電梯調度 | 線上排程 | 順路服務、同方向先走完、最急的先接、待命位置 |
| 🚛 資源回收車 | 容量與路線 | 容量限制、可行性判斷(裝得下、來得及)、最近/效率、兩台車分工 |
| 🪜 爬樓梯挑戰(國小組) | 貪心與看兩步 | 條件判斷 → 貪心法 → 多看一步(只用「往上第 1~4 階的分數」)→ 步數規則;不需要清單 |
| 🪜 爬樓梯 進階(國中組) | 動態規劃 | 用清單從頂端倒推的一維動態規劃;步數上限時用二維動態規劃 |
| 💎 尋寶怪盜 | 動態規劃 | 貪心法 → 多看一步 → 動態規劃、二維清單(金幣版,每格 0~3 枚) |
| 🛡️ 坦克自動控制 | 感測與合作 | 循序動作、條件判斷、目標選擇、雙車分工;另有學生隊伍對戰 |
| 🧮 動態規劃練習 | 紙筆演算 | 填「累積最高分表」、倒推最高分路線;老師可指定四種走法,檢查學生是否真的理解;另有一維爬樓梯題(最高分、有幾種走法) |
建議順序:彈力兔 → 掃地機器人 → 敬老專車 → 電梯調度、資源回收車 → 爬樓梯挑戰 → 尋寶怪盜(國中以上再接爬樓梯 進階)。掃地機器人、電梯調度、資源回收車、爬樓梯挑戰、尋寶怪盜各有 8 個練習關與 5 個挑戰關;這五個遊戲是「每個時間單位執行一次程式」的寫法,程式只要決定「這一刻要做什麼」。
入口
- 老師:教師管理首頁的「🏆 演算法遊戲(團體賽題型)」卡片 →「📊 成績與出題」或「🎮 遊戲入口」;練習版首頁的教師區也有「🏆 演算法遊戲:成績與出題」。
- 學生:練習版首頁的「🏆 演算法遊戲」。學生沿用平台的班級登入,不用另外登入。
看全班成績
- 打開「📊 成績與出題」。已經在教師管理登入的話會自動登入;否則用教師帳號(Email+密碼)登入。
- 選班級與遊戲。表格每一列是一位學生,每一格是該關的最高分,右側有練習過關數與合計。頁面每 30 秒自動更新,也可以按「🔄 重新整理」。
- 點任一格可以看這位學生的程式,並在遊戲畫面重播當時的過程。
- 「⤓ 匯出 CSV」下載成績;「👤 匯入座號姓名」載入姓名對照(這台電腦在教師管理匯入過的姓名會直接沿用,姓名不會上傳)。
- 學期結束或要重新開始時,可以按「🗑 清除本班此遊戲紀錄」。
🛡 成績怎麼驗證
學生上傳的是每個時間單位的控制紀錄,班級伺服器用和遊戲同一套規則重算分數,改過的分數會被拒絕。成績表上有標記的格子是未經伺服器驗證的成績。用「🛠️ 編輯關卡」改過的地圖不會上傳成績。
出題:班級關卡(作業/限時測驗)
- 在成績頁登入後,按「✏️ 出新題目(開啟遊戲編輯器)」;或在同一台電腦直接打開任一遊戲,工具列會出現「🛠️ 編輯關卡」。
- 以某一關為基礎修改地圖、資料與時間,先按「▶ 執行」用自己的程式試玩,確認題目做得出來,再按「✅ 完成編輯」。
- 按「☁️ 發佈到班級」,選擇方式:📝 作業(可設截止時間,開放期間可以重複挑戰,取最高分)或 ⏱ 限時測驗(設定分鐘數)。
- 學生在遊戲的「關卡」選單看到「📝 班級關卡(老師出題)」。限時測驗要按「⏱ 開始測驗」才會看到題目並開始計時;時間內可以多次執行,按「📤 交卷」送出最近一次執行的結果,時間到會自動交卷。
- 成績頁的「📝 班級關卡」表可以「開放/關閉」「預覽」「刪除」。要修改題目,在遊戲中把這個班級關卡載入編輯器,改好後按「☁️ 更新這個班級關卡」。測驗中點學生的格子可以「🔁 讓這位學生重考」。
📋 考卷:多題、可以混搭不同遊戲
班級關卡一次是一題。要出一份好幾題的考卷(例如彈力兔 1 題+尋寶怪盜 2 題+動態規劃練習 1 題),先把每一題發佈成班級關卡,再組成考卷:
- 在各遊戲用「🛠️ 編輯關卡」出題,「☁️ 發佈到班級」。不要勾「立即開放」,這些題目就只會出現在考卷裡,學生不會在遊戲選單先看到。
- 成績頁下方「📋 考卷」區按「➕ 新增考卷」:左邊列出本班所有遊戲的班級關卡,按「加入 →」放到右邊(最多 20 題,用 ↑↓ 調整題號;👁 可以預覽)。填名稱、說明,選 📝 作業(可設截止時間)或 ⏱ 限時測驗(設定分鐘數),再「☁️ 儲存考卷」並開放。
- 學生從「📋 班級考卷」(演算法遊戲入口的第一張卡片,或遊戲右上角的「📋 考卷」)進入。限時測驗按一次「⏱ 開始測驗」就拿到全部題目,所有題目共用一個計時;點「作答 ▶」會打開那個遊戲並自動選好題目,畫面左下角顯示剩餘時間和「⬅ 回到考卷」。
- 考卷裡每一題每次執行都會上傳,保留最高分;學生在考卷頁按「📤 交卷」結束,時間到會自動交卷,之後就不再收成績。動態規劃練習的題目在限時測驗中一律不能「檢查」。
- 在考卷列按「📊 成績」:每位學生各題分數+總分(限時測驗另有交卷狀態),點格子可以重播學生程式,「重考」會清除這位學生整份考卷的成績讓他重新開始,也可以「⤓ 匯出 CSV」。
- 已經有學生作答的考卷不能再更動題目(名稱、說明、時間仍可修改,或用「另存成新考卷」);考卷用到的班級關卡要先從考卷移除才能刪除。
🛡️ 坦克:闖關、自動控制與雙車合作
坦克有兩種不同的任務,請先向學生說明交作業的方式:
| 模式 | 學生怎麼操作 | 老師在哪裡看結果 |
| 16 關闖關 | 選關、寫積木、執行;登入後自動控制結果可上傳。手動與手動+程式隊友只記錄本機。 | 「成績與出題」選坦克;作業取最高分,單題限時測驗以交卷結果計分。 |
| 隊伍對戰 | 老師指定學生後,每人提交一輛車的程式;學生不必同時在線。 | 獨立的「坦克隊伍對戰」頁,鎖定版本後評測與重播;不加入闖關總分或遊戲幣。 |
闖關的建議教學進度:第 1~8 關為單車基礎,第 9~10 關為限彈與兩波敵人,第 11~13 關為分區、集火及牽制側攻訓練,第 14~16 關為多敵雙車合作。雙車合作須清除所有敵人,且兩車都存活。
動作依序完成,不再互相覆蓋
直接接「控制戰車 1 → 前進一格 → 右轉 15 度 → 射擊」即可:走完才轉向,轉完再射擊。感測器在執行到時讀取現況;整串完成後會再從起點判斷,變數保留,不必再包無限迴圈。射擊會等裝填,但不會等砲彈命中。停止、重置、切關或換模式會取消剩餘指令;重新執行從頭開始。
手動體驗使用 WASD/方向鍵與空白鍵。學生可比較手動和程式的通關時間、命中率與生命;正式闖關評測只收自動控制結果。闖關滿分 100:擊破比例 60,通關後加計生命 20、時間效率 10、命中率 10。
🛠️ 坦克教師編題:地圖、敵人與增援
- 在同一網站登入教師帳號後開啟坦克,選一個內建關卡,再按「教師出題」改編;也可按「新增地圖」。若這台電腦已登入學生,請先登出學生,才能進入教師模式。
- 設定地圖寬高(5~16 格)、單/雙車、作戰秒數、共用彈藥、巡邏與射擊間隔,再按「套用地圖與任務設定」。桌面寬度足夠時,左側是編輯面板、右側保留戰場。
- 選牆壁、橡皮擦、1/2 號起點或敵人筆刷,直接點地圖。起點可設朝向;初始敵人可選砲塔、巡邏或追擊,並設定裝甲。牆壁與橡皮擦可拖曳,按「復原」可退回上一步。
- 要增加敵人波次,按「+增援波次」,選該波後再放敵人。最多 3 波增援、每波最多 20 敵;清完前一波 2 秒後增援,增援裝甲固定 40。新增波次不可留空。
- 按「完成編輯」,用自己的積木執行試玩,確認題目可解。修復與正面裝甲等進階設定可能讓題目過難,請先驗證,再回到編輯面板填名稱、任務說明及發布方式。
- 選班級,以「作業」或「限時測驗」發布;要加入跨遊戲考卷,先發布為班級關卡,再到成績頁組卷。要改已發布的題目,先在「關卡」選該題並按「載入」,改好後按「更新這個班級關卡」。
題目 JSON 與程式 XML 是不同檔案
「存草稿」只存在這台電腦;「匯出題目」保存名稱、說明與地圖 JSON,方便老師交換題目。學生的 XML 則是控制程式。載入草稿或匯入題目後,發布預設回到新關卡;若要更新舊題,請重新選擇目標。格式與重疊檢查不代表題目一定可解,發布前仍應試玩。
⚔ 坦克隊伍對戰:1 對 1、2 對 2、3 對 3
- 從演算法遊戲首頁、遊戲成績頁或坦克頁開啟「坦克隊伍對戰」。教師登入後選班級;學生沿用原有班級登入。
- 選每隊 1~3 人,指定紅、藍兩隊座號,設定名稱、對稱地圖、每局 10~120 秒、每車彈藥與提交截止。兩隊人數須相同,座號不能重複;建立後名單與規則固定,要換人請另建一場。
- 學生可在 tank.html 寫程式,再按上方「⚔ 提交對戰」。若工作區有兩車,先選提交哪一車;系統會轉成單車起點並保留函式與資料,原工作區不變。視窗內選場次、試跑場地,再確認提交;視窗內修改需另存檔,不會回寫原工作區。也可直接到對戰頁編寫一車,系統會分配隊伍與車號。按「提交我的程式」才算交件;「試跑對戰」使用範例隊友與對手,不是正式成績。
- 交齊後,按「鎖定版本並正式評測」。系統以鎖定的程式執行兩局,第二局交換出生側。老師可在截止前提早開賽,請先告知學生;鎖定後不能再改交。
- 查看兩局積分、各局勝負與動畫重播。程式超出執行限制時,該車會被判負並顯示原因。老師可查看提交程式;學生只能讀取自己的程式及對戰重播。
- 使用「匯出對戰紀錄」另存 JSON,包含設定、提交程式與結果。每班最多保留 20 場;刪除前請先封存。現有班級備份格式尚未包含對戰,匯出的對戰 JSON 目前也沒有還原匯入介面。
- 勝負規則:每車 100 生命,每發傷害 20;無復活、無友軍傷害,但隊友會擋車、擋彈。消滅對方全隊獲勝;時間到依存活車數、全隊剩餘生命比較,仍相同則平手。同幀傷害同時結算,可同歸於盡。
- 兩局積分:每局勝方 3 分,平手雙方各 1 分;比較兩局總積分,總積分相同仍判平手。
- 合作策略:可鎖定指定敵車、跟隨隊友目標,讀取最近存活隊友的位置、生命與訊號。「傳送隊伍訊號」為 -999~999 的整數,學生自行約定集合、集火或求援代碼。
- 場地與結果:提供開放戰場、四柱掩體、中央障礙及「教師自訂地圖」。自訂圖可設 5~16 格寬高、牆壁、各隊出生點與朝向,預設旋轉對稱編輯,須通過重疊與出生點連通檢查;可匯入/匯出地圖並試跑草稿。建立場次時保存地圖快照,後續改稿不影響既有場次;對戰結果與闖關成績分開。
正式使用前請確認網站與班級服務版本
坦克闖關會由伺服器重播控制紀錄驗分;隊伍對戰則由伺服器的受限積木執行器跑雙方程式,不採用本機聲稱的勝負。正式對戰需要配套更新對戰頁、相關 JS 與班級 Worker;新版服務會自動建立兩張對戰資料表。若只更新網頁,可能只能本機試跑,無法正式建立或提交。請管理員部署後先以測試班級驗收。
🛡️ 開啟坦克闖關/教師編題 ⚔ 開啟坦克隊伍對戰
🧮 動態規劃練習(取代原本的 Google 試算表作業)
- 學生三個步驟:看地圖 → 填「累積最高分表」 → 寫倒推路線與移動清單,按「📤 提交作答」就交到班級(不用再填姓名、不用 Apps Script 網址)。
- 得分=累積分表答對格數+倒推正確步數+移動正確步數;路線只要是任何一條最高分路線都算對。
- 出題時先選題型:方格地圖(四種走法)、爬樓梯:最高分(每步 1 或 2 階,可放破損階梯 X)、爬樓梯:有幾種走法(費波那契數列)。
- 老師登入後打開「動態規劃練習」,按右上角「🛠️ 出題」:方格題選走法(左下→右上、左上→右下、右下→左上、右上→左下)、大小(最大 12×12)、填數字或 🎲 隨機,可「👁 預覽答案」「▶ 用這題試做」,再發佈成作業或限時測驗。
- 作業可以勾選「學生可以按『檢查』即時對答案」;不勾的話學生交出去才知道對錯,適合檢查是否真的懂。限時測驗一律不能檢查。
- 成績頁選「動態規劃練習」,點格子會顯示學生填的表格和路線,對錯標顏色。
📂 教師解答
掃地機器人、電梯調度、資源回收車、尋寶怪盜、爬樓梯挑戰、爬樓梯 進階、坦克每關都有解答積木(XML)和解答 PDF,放在「團體賽\教師解答\演算法遊戲」。在遊戲選好關卡後,用「📂 讀檔」載入同名 XML(例如 V1.xml;坦克為 T1.xml~T16.xml,請搭配新版解答 PDF)就能直接執行。請勿把這個資料夾放到學生拿得到的地方。
⚠ 需要新版班級伺服器
演算法遊戲的成績上傳、班級關卡與驗證要用新版的班級 Worker(含目前遊戲規則與坦克隊伍對戰介面)。學生出現「⚠️ 成績上傳」錯誤時,請管理員依「班級Worker\部署說明.md」重新部署。
PART H · 分析與報告
知識點分析與學習報告
🧠 知識點
班級頁「🧠 知識點」分頁依題目說明裡的「標籤:迴圈・累加累乘」統計:每個知識點的題數、作答人數、通過率(綠≥80%、黃≥50%、紅<50%)與平均次數,通過率最低的排最上面,方便決定上課要加強什麼。下方「熱力圖」是學生 × 知識點,一眼看出誰卡在哪裡。「個別學生」分頁也會列出該生的強項與建議加強的知識點。
標籤從哪來
出題時在題目說明第一行寫「標籤:S1・迴圈・累加累乘」(題庫編輯器的知識點標籤)。S1 這類階段代碼不計入。只統計這項功能上線後的作答紀錄。
🖨 學習報告
- 「個別學生」分頁按「🖨 學習報告」,或「⤓ 匯出」分頁按「🖨 產生全班學習報告」(每人一頁)。
- 內容:學習摘要(通過題數、銀牌金牌、理解值、匯入次數)、近 8 週每週通過題數、主題進度、知識點強弱、測驗成績、作業完成、老師評語欄。
- 在新視窗按「列印 / 存成 PDF」。姓名來自這台電腦的座號姓名對照,伺服器不會有學生姓名。
PART I · 備份
備份與還原
- 下載完整備份:班級裡「⤓ 匯出」分頁 →「💾 下載完整備份」。一個 .json 檔,包含班級設定、所有作答紀錄與程式、學生雲端進度(遊戲幣、獎牌、寵物、學習地圖)、班級測驗,以及這台電腦上的座號姓名對照。
- 還原:班級列表頁「⤒ 從備份還原班級」選備份檔,會建立一個新班級(新的班級代碼)。學生用新代碼+原座號+原密碼登入即可;還原的測驗預設是關閉的。
每年 1、6、7 月,教師管理首頁會提醒「30 天內沒有下載過完整備份」的班級,點一下就到下載頁;可以按「7 天內不再提醒」。系統也會自動清理過舊的資料(已處理超過半年的學生回報、失效的邀請碼與分享碼),學生作答和班級不會被清掉。
⚠ 學期結束建議
先下載完整備份,存到隨身碟或雲端硬碟,再刪除班級,釋放雲端空間。備份檔包含學生作答與密碼雜湊,請妥善保管。
PART J · 防作弊
防作弊機制與限制
| 機制 | 擋什麼 | 限制 |
| 匯入/貼上偵測 | 直接貼上或匯入別人的程式就通過。 | 只看「自己打的字/拖的積木」比例,不是百分之百準確。 |
| 寫死答案偵測 | 程式直接印出測資答案。 | 把答案拆開算(如 print(50*101))偵測不到;只檢查 2 位數以上的數字答案。C++ 檢查 cout/printf 的輸出。 |
| 伺服器評分(班級測驗) | 隱藏測資的答案只在伺服器,學生拿不到,也無法自己捏造分數。 | 測驗要連網。 |
| 加密題庫(.enc) | 學生直接瀏覽 GitHub 等公開位置看到答案。 | 平常練習與作業在瀏覽器評分,懂技術的學生仍可能取得測資;重要考試請用班級測驗。 |
| 座位卡、關閉加入 | 冒用別人的座號。 | 學生把密碼告訴別人就擋不住。 |
| 參考解答「🔒 僅教師」 | 學生直接看解答。 | 「通過後才開放」只在瀏覽器判斷;要確實擋住請用「僅教師」。 |
建議
標記是提醒,不是定罪。看到「匯入/貼上」或「寫死答案」,點開程式看一下,再找學生聊聊。
PART K · 排解
常見問題
學生說已經評分了,老師端卻看不到
確認學生左下角顯示「🙋 班級 座號」而且是「☁️ 已同步」。如果顯示「待上傳」,通常是網路不穩,連線後會自動補傳;顯示「請重新登入」代表座位被重設過。老師端每分鐘自動更新,也可以按「🔄 重新整理」。
學生忘記 4 位數密碼
在「座位與加入」按該座號的「重設密碼」,學生重新加入並設定新密碼,作答紀錄會保留。如果已「關閉加入」,要先暫時開放。
學生掃 QR code 後顯示「這台電腦目前登入的是別的班級」
這台電腦還登入著別班(或別的座號)的學生。請學生先按「登出」,再重新掃描或打開老師的連結登入。
有人佔了別人的座號
對該座位按「重設密碼」,請正確的學生重新加入,然後「關閉加入」。常有這種情形的班級可以改用座位卡模式。
協同老師看不到學生姓名
姓名只存在各自的電腦。請班主在「座位與加入」按「⤓ 匯出對照表」,協同老師在同一處「⤒ 匯入對照表」。
學生說看不到參考解答
先看班級的「📖 參考解答開放方式」:預設「通過後才開放」,學生要把這題評分到滿分才看得到;「僅教師」則完全不開放。另外,參考解答只在 Blockly/Scratch、而且用題庫目錄(或預設題庫出的作業)載入時才有,Python、C++ 介面沒有參考解答分頁。
C++ 介面打開很久,或顯示「編譯器尚未就緒」
第一次要下載約 19 MB 的編譯器,全班同時下載會比較慢。建議課前先在每台電腦開一次 C++ 介面讓瀏覽器快取;載入失敗可按工具列「🔄 載入編譯器」重試。
學生的 C++ 程式在 Dev-C++ 能跑,這裡卻不行
這裡不支援 try/throw、thread、讀寫檔案;每筆測資執行超過 3 秒會被停止。編譯錯誤會附中文提示(💡),可以請學生先看提示。
學生看不到班級測驗
確認:學生已登入這個班級、測驗是「開放中」。學生端清單約 20 秒更新一次,可以請學生重新整理首頁。
測驗中學生按評分出現「評分失敗」
測驗由伺服器評分,需要連網。請學生確認網路後再按一次評分;分數不會因為失敗被記成 0。
學生說畫面跳出「離開畫面」或被記次數
測驗中切換分頁、開其他視窗、縮小瀏覽器都會記一次。電腦跳出系統通知也可能被記到,所以這只是提醒,請參考次數多寡再判斷。
學生交卷後還想再寫
在測驗成績表按該生的「重考」,或對整份測驗「允許重考」。重考會重新計時,成績取最高分。
輸入分享碼說「不正確、已過期或次數已滿」
請分享的老師打開該試卷的「🔗 分享」確認分享碼還有效;過期或次數用完時,按「重新產生」再給你新的分享碼。
上傳試卷時說「找不到題目」
請用題庫編輯器組卷匯出的 .txt 或 .txt.enc。手寫的檔案每一題都要用「題目:」開頭,檔案用 UTF-8 存檔。
出現「今天全班的上傳量已滿」
為了公平使用免費額度,每班每天有上傳上限。學生的紀錄會先存在電腦裡,隔天自動補傳;常遇到請洽管理員。
換了一台電腦,座號姓名不見了
姓名只存在原本那台電腦。到原電腦「座位與加入」匯出對照表,再到新電腦匯入;或從完整備份還原。
學生玩了演算法遊戲,成績頁卻沒有分數
請學生確認:已登入這個班級(遊戲右上角會顯示)、玩的不是用「🛠️ 編輯關卡」改過的地圖。每次執行完,遊戲的訊息列會顯示「☁️ 成績已上傳」;顯示「⚠️ 成績上傳」錯誤時,多半是班級 Worker 還沒更新到含演算法遊戲的版本。
演算法遊戲的限時測驗,學生交卷後還想再做
在「📊 成績與出題」的班級關卡成績中,點該生的格子按「🔁 讓這位學生重考」。如果是「📋 考卷」,在考卷的「📊 成績」表按那位學生的「重考」,會清除整份考卷的成績與開始時間。
坦克隊伍對戰為什麼沒有加入闖關分數?
對戰採獨立場次與兩局積分,請到「坦克隊伍對戰」看提交狀態、正式結果及重播;不列入闖關最高分或遊戲幣。坦克手動模式也不會上傳闖關成績。
對戰分配到 2/3 號車,要改用「控制戰車 2」嗎?
不用。每位學生只提交一個「控制戰車 1」起點,由系統分配隊伍車號。「控制戰車 2」用於單人編寫雙車合作闖關。
試跑贏了,正式對戰卻輸了?
試跑使用範例隊友與對手;正式評測使用老師鎖定時各位學生已提交的程式,並交換出生側打兩局。修改草稿後要再提交,鎖定或截止後不能改交。
坦克沒有出現教師出題功能?
請在同一網站登入教師帳號;若同時保留學生登入,先登出學生再開坦克。正式發布與對戰還需要新版班級 Worker,僅更新 tank.html 不足以完成部署。