歡迎使用「老師輔導小幫手」

先完成班級基本設定;學生名單可直接貼上,也可先留空,之後到「設定」連結既有 Google 試算表還原雲端資料。

目前班級:115學年度|五年六班

老師輔導小幫手

新增輔導紀錄
快速記錄事件,整理成校務紀錄與家長訊息
快速通知家長
受傷、碰撞、身體不適,快速產生可複製通知
最近紀錄

新增輔導紀錄

快速記錄事件,整理後可複製至校務系統並保存
共同事件只輸入一次;每位學生可填不同角色/情況與個別補充,AI 會一次產生各自內容。
隱私設計:多當事人模式只會把 A/B/C 等匿名代號、角色與老師輸入的事實送給 AI;不傳送學生姓名、座號或班級。
輔導內容要點
聯絡事項
家長溝通訊息
個別輔導內容可逐位修改後再一次儲存

快速通知家長

適合小擦傷、碰撞、身體不適等突發小事件
例如碰撞、爭執或同一事件中多人受影響;AI 會一次產生每位學生不同的家長通知。
隱私設計:多當事人模式只傳 A/B/C 匿名代號與老師輸入的事實,不傳送學生姓名、座號或班級。
家長通知
個別家長通知可逐位修改與複製

學生

V2.7 Phase 3.0.9|首次使用設定簡化版
目前班級準備中
V2.7 Phase 3 保留已驗收的班級生命週期與多當事人事件,並新增「班級/學生班級歷程」Google Sheet 雙向同步。一般轉出仍只停用班級歷程,不會刪除學生或既有紀錄。
歷年班級0 班

歷史紀錄

切換查看輔導紀錄或快速通知,依學生、班級與事件類型查找

輔導紀錄

查看、複製、編輯或刪除這筆紀錄

快速通知

查看這筆通知的事件、處理情形與家長通知內容

設定

本機資料、AI 與 Google 雲端設定
V2.7 Phase 3 資料架構已啟用
AI 服務 已就緒

AI 已預先設定完成,一般使用不需要輸入任何網址。直接回首頁新增輔導紀錄或快速通知即可。

預設 AI 服務已載入。
AI 請求不傳送學生姓名、座號、班級與 Google 帳號;只傳送老師輸入的事件內容、所選事件類型及必要的處理資訊。
進階/開發者設定:AI Worker

一般老師不需要修改。只有開發者要切換 AI Worker 時才使用這裡;清空後會自動恢復官方預設服務。

Google 雲端 未連結
第一次使用只要完成兩步:
① 連結自己的 Google 帳號 → ② 建立自己的試算表。
每位老師都會有自己的 Google Sheet,資料彼此獨立;一般首次使用不需要貼任何網址。
換裝置/還原資料:連結既有 Google 試算表

只有換裝置或要還原原本資料時才使用。第一次建立自己的資料時請不要填這裡。

查看同步詳細狀態
V2.6.1 持久授權+自動同步 準備中

Google Refresh Token 與短期 Access Token 都由 Cloudflare 後端處理,不放進 localStorage。這台裝置只保存一個隨機 Session Token;它不是 Google Token,而且後端只允許它操作已連結的那一份試算表。第一次完成持久授權後,重新整理或重開 App 都可自動恢復。

班級+學生班級歷程同步 尚未同步

V2.7 Phase 3 會把歷年班級、目前班級、原班升級來源,以及每位學生的座號/加入/轉出/畢業歷程同步到 Google Sheet。同步以 classId/enrollmentId 合併;更新時間較新的資料優先,時間相同時以 Google Sheet 為準。 Phase 3.0.6 起會自動清理 studentId 已不存在於學生資料庫的孤兒班級歷程;Phase 3.0.7 再加入新裝置連結既有 Sheet 的唯讀還原與安全寫入保護,避免空白本機或網路中斷覆蓋雲端正式資料。正常轉出、畢業與歷年學生因 studentId 仍保留,不會被誤刪。

班級:classId|學年度|年級|班號|班級代碼|狀態|開始日期|結束日期|promotedFromClassId|目前班級|建立時間|更新時間
學生班級歷程:enrollmentId|studentId|classId|座號|加入日期|離開日期|狀態|離開原因|建立時間|更新時間
學生名單同步 尚未同步

按一次會讀取 Google Sheet「學生名單」,以 studentId 合併本機與雲端資料,再把合併結果寫回兩邊。一般同步仍會保留任一端獨有的學生;只有老師經「安全刪除誤建學生」明確確認的 studentId,才會在下次同步從 Google Sheet 一併移除。

欄位:studentId|座號|姓名|班級|年級|啟用狀態|建立時間|更新時間
輔導紀錄同步 尚未同步

按一次會讀取 Google Sheet「輔導紀錄」,以 recordId 合併本機與雲端資料,再把合併結果寫回兩邊。新增與修改都不會重複建立;App 內刪除的紀錄會在下次同步時從 Sheet 移除。

欄位:recordId|studentId|座號|姓名|日期|班級|年級|訪談方式|事件類型|原始紀錄|輔導內容要點|聯絡事項|家長溝通訊息|後續追蹤|建立時間|更新時間
座號與姓名是方便老師閱讀的顯示欄位;紀錄與學生的正式關聯仍以 studentId 為準。
快速通知同步 尚未同步

按一次會讀取 Google Sheet「快速通知」,以 noticeId 合併本機與雲端資料,再把合併結果寫回兩邊。新增與修改不會重複建立;同步不會因單一裝置缺少資料就直接刪除雲端通知。

欄位:noticeId|studentId|座號|姓名|日期|班級|年級|事件|部位|簡要情況|已處理|目前狀況|家長通知內容|建立時間|更新時間
座號與姓名只供老師閱讀;快速通知與學生的正式關聯仍以 studentId 為準。
V2.6.1 不在前端保存 Google Refresh Token 或長期 Google Access Token。Google Refresh Token 會加密保存在 Cloudflare D1;本機只保存一個隨機裝置 Session Token。後端會限制 Session 只能操作已連結的單一試算表。Google 資料不會送給 Gemini。
開發者設定:Google 持久授權 Worker

V2.6.1 的 Google Client Secret 與 Refresh Token 都只存在 Cloudflare 後端,不放在 PWA。

Google Sheet 結構

V2.7 Phase 3 新增「班級」與「學生班級歷程」兩個 Google Sheet 分頁。班級生命週期現在可與雲端雙向同步;多當事人事件仍沿用既有 incidentId/participantId/participantRole/participantFacts 欄位,不改動已驗收的單人與多人紀錄格式。