輔導紀錄小幫手

把老師口語、零散的描述，整理成可以直接登錄到校務系統的正式輔導紀錄：

• 輔導內容重點：一段話簡述發生了什麼事
• 聯繫內容：一段話寫清楚事件經過、老師如何處理與引導、學生之後可以怎麼做

🔗 線上使用：https://cagoooo.github.io/counseling/

功能

功能	說明
姓名自動去識別化	送給 AI 前學生姓名換成「甲生」、同學換成「乙生、丙生…」，電話與身分證字號自動遮蔽；結果預設在本機換回真實姓名，可切換成全部用代號
輔導對象切換	只和學生談（不會寫出聯繫家長）／聯繫家長／學生＋家長／教師或輔導室
輔導類別、方式	人際、情緒、學習、常規…可複選；晤談、電話、聯絡簿、家訪…
快速範例	同儕衝突、上課分心、作業缺交、情緒低落、危險行為、遲到常規
常見狀況標籤庫	8 大類 40 個國小常見狀況，點一下就加入、自動勾選類別；只點標籤不寫敘述也能產生
教師處置標籤	傾聽同理、約定改善目標、轉介輔導室…；勾「聯絡家長」會自動把對象改成「學生＋家長」
通報提醒	點選自傷、疑似霸凌、疑似受虐等標籤時，提醒依學校流程完成法定通報
一鍵改寫	更溫和／更客觀／更精簡／更完整，不滿意可復原
批次補登（座號制）	點座號、勾狀況，一次最多 10 位依序產生，有進度條；只用座號不需輸入姓名
自動重試	Google 伺服器忙碌時自動等待重試；批次撞到每分鐘免費額度會倒數後自動繼續，可隨時停止
先看範例	沒有金鑰也能一鍵看到完整的示範結果
字數上限自動精簡	設定學校字數上限後，產生結果超過會自動精簡；也可一鍵「精簡到上限內」
登錄前自動檢查	標出診斷或標籤化字眼、AI 可能補造的細節（如電話、家長表示）、內部用語殘留，可一鍵選取該段
追蹤輔導、學校格式、名冊、備份	延續前次紀錄；自訂欄位名稱與字數上限；本機班級名冊；備份成檔案與還原
公用電腦模式	資料只存在分頁，關閉即清除
語音輸入	Chrome／Edge 可直接用說的
篇幅與語氣	精簡／標準／詳細；客觀中性／溫暖正向
兩種使用方式	① 填自己的 Gemini API 金鑰直接產生；② 不用金鑰，複製提示詞到 Gemini 網頁版，再把回覆貼回來自動拆段
紀錄本	存在自己的瀏覽器，可搜尋、載入、匯出 Excel（CSV）
學期輔導統計	依學期／學年統計輔導人次、學生數、聯繫家長、轉介、類別、方式、對象與各月人次；點學生可看完整紀錄；可複製不含姓名的摘要貼到輔導室報表
沒有網路時的提示	斷線時頁面上方顯示提示，按產生不會報錯；批次產生途中斷線會等網路恢復後自動繼續
列印	A4 紀錄表格式

隱私設計

• 沒有自己的伺服器，輔導資料只存在使用者的瀏覽器（localStorage）。
• API 金鑰只存在使用者自己的瀏覽器，並且只直接送到 Google。可選擇「不記住」，關掉分頁就會忘記。
• 免費方案的 Gemini API，輸入內容可能被 Google 用來改善服務，所以送出前一律去識別化。

技術

純靜態網頁（HTML + CSS + JavaScript，無打包工具），部署在 GitHub Pages。 Gemini 模型會依金鑰即時查詢可用清單（ListModels）自動挑選，模型停用時不用改程式。

• PWA：可「加到主畫面」，離線時也能開啟介面（AI 產生仍需網路）。
• 新版本通知：Service Worker 偵測到新版時，畫面會跳出「重新整理載入」通知列；另有 version.json 輪詢當備援。網址加 ?swdemo=1 可預覽通知列樣式。
• 社群分享卡片：og-image.png（1200×630），og:image 網址帶版本號，避免 LINE／Facebook 卡在舊圖。

改版發布流程

每次修改後，先跑自動測試、再升版、再提交，否則可能把功能改壞，或已開著網頁的人收不到更新通知：

npm test
powershell -ExecutionPolicy Bypass -File scripts/bump-version.ps1 -Notes "這次改了什麼"
git add -A; git commit -m "feat: ..."; git push

自動測試（Playwright，使用電腦上的 Microsoft Edge，不需另外下載瀏覽器）共 42 項，涵蓋去識別化與姓名顯示切換、AI 產生與改寫、逐步引導自動跳轉、給建議按鈕、登錄前自動檢查、學校格式、追蹤輔導、名冊、批次、備份還原、紀錄本篩選、學期統計、沒有網路時的提示、第一次開啟不自動重整、公用電腦模式、錯誤處理、列印，以及手機／電腦版面（無水平捲動、頁首不重疊、最小字級）。Gemini 回應全部以模擬取代，不需要金鑰、不花額度。第一次執行前先 npm install。

升版腳本會同步 version.json、sw.js、sw-register.js 與 index.html 裡所有 ?v= 版本號。

要重新產生圖示或分享圖：npm install 後執行 npm run gen:images（使用 Windows 微軟正黑體）。

本機預覽預設不啟用 Service Worker（避免快取干擾修改），網址加 ?sw=1 才會啟用測試，?sw=0 關閉。

---

Made with ❤️ by 阿凱老師

---

🔗 阿凱老師教育工具集

這個專案是阿凱老師教育工具集的 #132 輔導紀錄小幫手，由桃園市龍潭區石門國民小學阿凱老師開發。

• 工具介紹頁：https://cagoooo.github.io/Akai/tool/132/
• 線上使用：https://cagoooo.github.io/counseling/
• 教學情境文章：https://cagoooo.github.io/Akai/blog/counseling-record-132-deidentified-writing/
• 全部工具（上百個教育工具與原始碼）：https://cagoooo.github.io/Akai/

想改造成自己的版本？到上面的教學情境文章，按左下角「複製 AI 開發提示詞」，貼給 ChatGPT、Claude、Gemini 等 AI 助手，就能參考這份原始碼開始規劃。