PhysMaker AI 作業批改助教

PM 批改精靈

嗨，我是批改精靈。我會幫你收學生作業，然後按照你教我的「評分規準」批改、打分數、並給學生建議。不限實驗報告，作文、學習單、閱讀心得、探究報告、專題報告都可以，只要你能寫出明確的規準，我都能幫上忙。

只要你有Google帳號，就可以用複製產生另一個我。但「這個我」只有軀體，需要注入靈魂：你的 Gemini API Key，之後住在你google雲端幹活。而我的複製體到你家後，就是專屬於你的精靈…他沒有辦法跟我聯繫喔。任何學生資料或你的評分規準都是你私人的，他產生的報告也都會留在你家。

適用哪些作業？

這套流程一開始是為了物理實驗報告批改開發的，但場景和評分規準都是你自己寫的。所以作文、學習單、閱讀心得、申論題、探究報告、專題報告，只要能寫出明確的場景和評分規準，都能套用同一套「上傳 → 精靈批改 → 未達標退件」流程。

實驗報告作文學習單閱讀心得申論題探究報告專題報告其他有明確規準的作業

詳細運作流程

  1. 1

    學生登入表單，填姓名學號班級、把作業（PDF、圖片或 Word 文件）上傳到老師的雲端。

  2. 2

    我依照你設定的評分規準批改，並依照場景給予分數、具體修改建議，並寫進你的試算表。我不是收到就馬上回，而是每隔幾分鐘批次處理一輪（大約5min~10min）。避免截止日前大家一起交，導致我被 AI 服務的用量限制卡住。

  3. 3

    如果學生及格，我會直接寄信告訴學生他通過了，並給予鼓勵。沒及格，我會附上修改建議跟重新提交連結，讓學生自己再交一次，不用你出手。

  4. 4

    如果學生退件退到你設定的次數，就可使用「申請人工複核」。我會轉手寄Email給你，並附上連結，你直接在網頁上看作業、打分數，我再把結果回傳給學生。

資料安全與隱私

精確講清楚每一種資料實際上存在哪裡、經過誰：

  • · 學生繳交紀錄、AI 批改分數與回饋，全部寫進你自己的 Google 試算表，存在你自己的雲端硬碟——不會傳到 PhysMaker 的任何伺服器。
  • · 批改當下，學生作業的內容（檔案本身或轉出的文字）只會送到Google 的 Gemini API 進行分析批改。這段傳輸只發生在「你的 Google 帳號」和「Gemini API」之間，PhysMaker 完全不會經手、也看不到內容。Gemini API 如何保存與使用這段資料，依 Google 官方的服務條款為準，不是 PhysMaker 能保證或修改的範圍。
  • · 批改邏輯是一段 Google Apps Script 程式碼，執行在你自己的 Google 帳號裡，不是 PhysMaker 代管的後端。
  • · Gemini API Key 由你自己申請、自己填入，存在你自己試算表的設定分頁裡；AI 批改費用（目前有免費額度）也由這組 Key 支付，PhysMaker 不會看到 Key，也不代收代付任何費用。
  • · 即使將來網站關閉或改版，你已經裝好的批改系統仍會正常運作——因為它本來就不依賴 PhysMaker 運作。

一句話總結：PhysMaker 不會接觸、傳輸或保存任何學生資料、批改結果或你的 API Key。唯一會看到作業內容的第三方，是你自己設定用來批改的 Gemini API。

裝機教學

大約需要 10–15 分鐘，跟著下面步驟點按鈕就好，一次設定好之後就是自動運作。

步驟 1・複製表單

點下面的按鈕，Google 會問你要不要複製這份表單——選「建立副本」，表單就會出現在你自己的 Google 雲端硬碟裡。

複製完打開副本，如果看到「找不到『檔案上傳』資料夾」的錯誤畫面——這是 Google 複製含檔案上傳題型的表單時常見的狀況，不是你操作錯誤。直接點畫面右上角的「還原」，再點「繼續」確認檔案上傳設定，就會恢復正常。

表單裡負責交作業的檔案上傳題目，可以自由命名成「上傳作文」「上傳學習單」等符合這次作業的名稱——系統是靠題目的「類型」（檔案上傳）辨識，不是靠題目名稱比對。

只有「姓名」「我要申請人工複核」這兩題名稱不能改，系統靠這兩題的文字完全比對才能運作（姓名用來寄退件重新提交連結，申請人工複核用來判斷要不要跳過 AI 直接進人工複核），改了名字系統會找不到、存檔失敗。「學號」「班級」則完全自由——想改名、想刪掉、想換成「座號」之類都可以，不用去任何地方同步設定：保留原文字「學號」「班級」，內容就會自動存進批改總表；改了名字，那一欄批改總表就是空的，不會擋住儲存，也不會影響其他功能。如果只是想額外收集跟批改無關的資訊，一樣可以自由新增新題目（例如座號、導師），新增的題目系統會直接忽略，只留在表單回覆裡給你自己看。

複製表單 →

步驟 2・複製試算表

同樣點下面的按鈕建立副本。這份試算表已經包含批改邏輯的程式碼，複製時 Google 會提示「系統也會複製附加的 Apps Script 檔案」——這是正常的，直接繼續。

複製試算表 →

步驟 3・把表單和試算表接起來（容易漏掉的一步）

Google 的「製作副本」不會保留表單和試算表原本的連結關係，所以複製完之後，你的表單和試算表其實還沒接上——這一步就是把它們接起來：

  1. 開啟剛剛複製出來的表單，切到「回覆」分頁
  2. 點右上角的綠色試算表圖示
  3. 選「選取現有試算表」
  4. 選剛剛複製出來的那份試算表

接好之後，試算表裡會多出一個新的「表單回覆 1」分頁（跟複製帶過來的舊分頁同名但不是同一個，Google 通常會自動編號區隔），這個新分頁才是真正接上表單的。舊的那個是複製時帶過來的靜態資料，留著不影響功能，想清乾淨的話可以直接刪除。

步驟 4・第一次授權

開啟試算表 →「擴充功能」→「Apps Script」，打開編輯器後，先點左側檔案列表裡的「程式碼.gs」，再看編輯器最上方工具列(「執行」按鈕左邊)有一個函式下拉選單——這跟左側檔案列表是兩個不同的東西，點開下拉選單選 getGlobalSettings，再按「執行」。（這步驟只是要觸發授權，選這個函式不會出錯；如果選到別的函式跑出紅字錯誤，不用擔心，重新選 getGlobalSettings 再執行一次就好。）

會跳出「這個應用程式未經 Google 驗證」的警告畫面——這是正常現象，因為這是你自己複製、自己在自己帳號裡執行的程式碼，不是任何第三方在背後操作。點「進階」→「前往（不安全）」→「允許」即可繼續。

這是在授權什麼？ 你複製回來的雖然是自己的程式碼，但對 Google 來說，程式碼跟「你本人」還是兩回事——任何程式要動用你帳號裡的東西，Google 都會先跳出來問一次，這是所有 Apps Script 專案的通用規則，不是這套系統特別可疑。實際被授權的是這幾件事：讀寫這份試算表（存設定和批改結果）、讀取表單題目與回覆、讀取雲端硬碟裡學生上傳的檔案、用你自己的 Gmail 寄出批改結果信、對外連線把作業內容送到 Google 的 Gemini AI 分析、以及設定自動排程。這些權限全部只在你自己的帳號裡運作，不會經過 PhysMaker。

步驟 5・啟用 Drive API 進階服務（不要跳過）

還在 Apps Script 編輯器裡，點左側「服務」旁的「+」→ 找到「Drive API」→ 版本選 v2 → 新增。這步不只是規準檔案匯入用得到——學生交 Word 檔（.doc/.docx）時，批改系統也要靠這個功能才能讀出作業內容，漏掉這步會讓學生交 Word 檔時批改失敗。

務必選 v2，不要選 v3——程式碼裡轉檔用的是 v2 專屬的寫法，選 v3 會導致轉檔功能失效。

步驟 6・部署 Web App（人工複核用）

Apps Script 編輯器右上角「部署」→「新增部署作業」→ 類型選「網頁應用程式」→ 執行身分選「我」、誰可以存取選「僅限我自己」→ 部署。部署完成後複製出現的網址，等一下設定時要貼回去。

如果按下去跳出紅色「發生錯誤，請重新載入網頁」的視窗，這是編輯器暫時性小狀況，不是你操作錯誤——點「重新載入」，等頁面刷新完再重新部署一次就會成功。

步驟 7・填寫設定

回到試算表，重新整理頁面，選單列會出現「批改精靈設定」→ 開啟設定側邊欄，先填「全域設定」（這部分只需要填一次，不會因為班級或作業次數變動）:Gemini API Key（免費申請）、Web App 網址（貼上步驟 6 複製的那個網址），按「儲存全域設定」。

接著在下方「作業管理」點「+ 新增作業」，把這份表單登記成第一個作業，填「作業名稱」、「表單網址」（複製表單編輯畫面網址列的網址，不是工具列「複製表單連結」按鈕那個）、「評分規準」、「及格分數」、「申訴門檻」，還有幾個選填欄位（情境敘述、是否告知分數、批改口吻、同時 CC 老師）。填完按「儲存這個作業」，批改功能就正式啟用了。

各欄位詳細怎麼填、常見的卡關訊息，整理在裝機教學最後的「補充・設定欄位與常見問題」，設定卡住或想確認欄位意義再回去看即可，不影響你先把流程走完。

步驟 8・發布表單

回到表單編輯畫面，右上角如果顯示「這份表單不接受回覆」，點旁邊的「發布表單」完成發布。

步驟 9・自己先測試一次，再給學生（強烈建議）

在把表單連結分享出去之前，用自己的帳號當一次「學生」：填寫表單、上傳一份測試用的作業檔案（建議測一份 PDF、一份 Word 檔，兩種都測）、送出。

等 5 分鐘左右，檢查有沒有收到批改結果信。如果沒收到，回到試算表側邊欄「作業管理」，確認剛剛登記的表單網址跟你送出測試的那份表單是同一份——這是裝機過程中最容易出錯、但完全看不出徵兆的一步，唯一能確認的方法就是真的送一次測試。

確認測試信正常收到後，才把表單連結分享給學生。

補充・設定欄位與常見問題

以下是步驟7各個欄位比較細節的說明，設定卡住或想確認欄位意義再回來看即可，不影響你先把裝機流程走完。

  • 表單網址怎麼拿、常見錯誤——複製表單編輯畫面網址列的網址（長相是 `https://docs.google.com/forms/d/一串英數字/edit`），不要用工具列「複製表單連結」按鈕拿到的那種網址（長相是 `.../forms/d/e/一串英數字/viewform`）——那種格式系統認不得，貼進去儲存會失敗，出現的錯誤訊息通常長這樣：「儲存失敗：Exception: 找不到指定 ID 的項目」，看到這個錯誤就是網址貼錯格式，換成編輯畫面的網址重貼就會解決。放心，這裡貼編輯網址不代表學生會看到編輯畫面，寄給學生的重新提交連結是系統另外產生的公開作答連結。
  • 及格分數——AI 打的分數達到這個數字（含）以上就算通過，目前只接受數字，還不能填 A/B/C 這種等第。
  • 申訴門檻——學生被退件到第幾次，會出現「申請人工複核」的選項，改由你親自看過打分數（詳見上面「詳細運作流程」第4步）。
  • 情境敘述——這次作業的背景說明（例如「作文課，題目是我的志願」），批改時會一併提供給 AI 參考，讓評語更貼合實際情境。
  • 是否告知分數——關閉的話，學生只會收到「通過」或「未通過」，不會看到實際分數，修改建議仍照常附上。
  • 批改口吻——選「助教」或「老師本人」，決定 AI 回饋文字讀起來的語氣。
  • 同時 CC 一份給我——勾選後，每一封寄給學生的批改結果信（通過、退件、人工複核完成），都會同時副本寄一份到你自己的信箱，方便你掌握全班批改狀況。
  • API Key 安全提醒——公開示範或截圖教學畫面時，記得先把 API Key 遮起來或事後換一把新的——免費額度被別人拿去用，不一定會扣到你的錢，但很可能會把你當天的額度用光，變成自己批改作業時卡住。到 Google AI Studio 重新產生一把 Key 幾分鐘就能完成，不需要的舊 Key 留著也是風險。

評分規準可以直接打字、上傳 .md / .txt / .pdf / .docx 檔案自動帶入，或者複製這份規準範例 Google 文件直接在文件裡編輯（表格解析最準確），改完把文件網址貼進去匯入就好。

同時教好幾個班？每學期有好幾次作業？

這兩種情況不一樣，處理方式也不同。

  1. 複製一份新表單（表單本身很輕量，不用複製整套試算表）
  2. 新表單的「回覆」設定連結到同一份試算表（跟步驟 3 一樣的做法）
  3. 側邊欄「作業管理」→「+ 新增作業」，貼表單網址、取名字、填規準跟及格分數

所有作業的批改紀錄一樣會統一存在同一份「批改總表」，多一欄「作業名稱」方便篩選查看。不用開好幾份試算表分開管理。

目前的限制

  • · AI 判定通過的分數，老師無法再覆核（只有退件/申訴的案件才會進入人工複核）。
  • · Gemini API 有每日/每分鐘的免費額度限制，用量大時可能需要等待或升級方案。 細節請參考 Gemini API 官方文件。

為什麼會做這個工具

現在用 Gem、GPTs 等 AI 工具，已經可以協助批改學生作業。但真正麻煩的，往往不是「怎麼讓 AI 批改」，而是前後一大堆重複工作：收作業、下載檔案、一份一份丟給 AI、整理結果，再一個一個回覆學生。等老師有時間處理，可能已經是下一堂課，學生也錯過了最需要回饋的時機。

所以我一直有一個願望：學生交作業之後，能不能先有一個「小精靈」幫老師做初審？像是錯字太多、缺少圖片、表格沒有單位、內容不完整、前後邏輯不通……這些有明確規則的問題，就由小精靈先檢查。沒有達到標準，就直接退回，並給學生正向、具體、可以立刻修改的建議。學生修改、重新繳交，小精靈再批改，直到通過為止。這整個過程，老師都不需要介入。

而真正需要教師專業的部分——作品的美感、內容深度、專業核心與整體品質——最後再由老師把關。

AI 不需要取代老師。它更適合先接手那些有規則、重複，而且很花時間的工作。

← 回教育頁面