這個工具在做什麼？
把老師收回來的「第 8 節輔導課家長同意書」回條照片，用 AI 自動辨識每位學生的座號、姓名與是否同意參加，最後整理成一份 Excel 檔案，不用再一筆一筆手動輸入。
整體流程（由上往下照著做）
- 上傳學生名單（可省略，直接跳到第 3 步也可以）
- 選擇班級
- 上傳回條照片 → 開始辨識
- 確認辨識結果（可手動修正）
- 下載 Excel
步驟 1：上傳學生名單
先選擇「🆕 全新開始」或「📂 接續之前進度」：
- 全新開始：這個班級是第一次處理，還沒有任何回條紀錄。
- 接續之前進度：這個班級之前已經辨識過、但還有學生沒交回條（例如今天處理了 11 個人，明天要補剩下的 5 個人）。這時候請上傳「上次下載的那份 Excel 結果檔」，程式會自動把已經同意/不同意的資料讀回來，之後新辨識的結果會疊加上去，不會蓋掉舊資料。
接著上傳名單，兩種檔案都可以：
- .xlsx 名單檔案：學校提供的學生名單試算表，需要包含「學號、座號、姓名」欄位（性別欄位可有可無）。
- 名單照片：直接拍一張全班座號表（例如貼在教室的座位/名冊表）的照片上傳，AI 會自動辨識出班級、座號、姓名。
之後下載的 Excel 會沿用這份名單的班級與座號順序，所以請確認上傳的名單正確。
如果完全不想上傳名單，可以直接點右下角「跳過，直接辨識回條 →」，這樣班級與姓名都會直接從回條照片上的 AI 辨識結果來，不會跟任何名單比對。
步驟 2：選擇班級
如果有上傳名單，這裡選你要處理的那個班級；也可以選「🔍 全部班級」，這樣不管上傳哪個班的回條照片，AI 都會自動判斷歸到哪一班，適合一次處理好幾個班的照片。
步驟 3：上傳回條照片
- 可以一次選多張照片，或用手機拍照後上傳。
- 一張照片可以疊拍多份回條（例如把好幾張同意書疊在一起拍一張），AI 會自動找出照片裡的每一份回條分別辨識，不用一張一張拍。
- 上傳後縮圖會顯示在框框裡，縮圖右上角有 ✕ 可以刪掉不小心選錯的照片。
- 確認照片都對了之後，按「開始辨識」。
AI 辨識怎麼運作？
系統會呼叫 Google Gemini AI 讀取照片內容，判斷每張回條的年級、班級、座號、姓名，以及家長勾選的是「同意參加」「參加學習扶助課程」（這兩種都算同意）還是「不參加」。為了避免免費額度用完導致辨識失敗，系統準備了多組 API key 輪流使用，某一組額度用完時會自動切換下一組，一般不需要理會，除非畫面顯示辨識失敗才需要重新嘗試。
步驟 4：確認辨識結果
辨識完成後會列出一張表格，每一列是一位學生的座號、姓名跟「同意／不同意」判斷結果：
- 如果 AI 判斷錯誤，可以直接點該列的「是」「否」按鈕手動修正。
- 「清除」可以把這筆結果整個刪掉（例如辨識錯了一位不存在的學生）。
- 如果照片模糊、AI 辨識不出座號，會跳出一個小視窗讓你手動輸入座號跟選擇班級。
下載 Excel
點「下載 Excel」，檔案內容會照這個格式排列：回條上的活動標題（自動斷行對齊）、班級名稱、然後是「學號、座號、姓名、同意參加」的表格，並依座號由小到大排序。
如果是用 Chrome 或 Edge 瀏覽器開啟（且網址是 https 開頭，不是雙擊本機檔案），下載時會跳出「另存新檔」視窗讓你自己選要存到哪個資料夾，瀏覽器也會自動記住這個網站上次選過的資料夾位置，下次不用重選。如果瀏覽器不支援這個功能，會自動改用一般下載方式存到預設的下載資料夾。
常見問題
- Q：辨識一直失敗怎麼辦？ 通常是照片太模糊、太暗，或字跡潦草看不清楚。建議重新拍一張光線充足、正對著回條的照片再試一次。
- Q：座號重複或對不到名單怎麼辦？ 系統會跳出提示，讓你手動確認班級與座號，確認後才會存進結果。
- Q：可以中途離開，之後再繼續嗎？ 可以。先下載目前的 Excel 結果，之後重新打開系統時選「📂 接續之前進度」上傳同一份 Excel，就能接著補齊剩下的學生。
- Q：這些照片跟資料會不會外流？ 照片只會傳送到 Google Gemini AI 做辨識，不會另外儲存在其他伺服器；但仍建議不要上傳含有敏感個資（如電話、地址）特寫的照片。