✨ #7 點石成金蜂：勾 450+ 成語標籤 → AI 同時生成 12 種風格段落 + 二階段微調 + 全校共享 API Key 的單向轉換神器
#7 不是「直覺評語 → AI 優化」 — 真實流程是「老師從 450+ 成語詞庫勾學生特質標籤 → AI 把標籤串成段落」。12 種寫作風格同時並列生成（不是單一）、CommentAdjuster 二階段縮 / 擴 / 換說法 + 5 級語氣滑桿、全校共享 API Key（阿凱自掏腰包）、繁中強制條款源於 v2.6.2 簡體字事故。
期末打評語的真實苦痛
每學期末，老師面前是一張學生名單 30+ 人 + 一個空白欄位「綜合表現評語」。
寫到第 5 個還行：
「學習態度認真，作業準時繳交，期待下學期繼續努力」
寫到第 10 個開始用 ctrl+c / ctrl+v 微調。
寫到第 15 個遇到那個上課常聊天的小傑 — 卡住：
- 寫「上課喜歡發言但有時影響課堂」？太消極
- 寫「活潑外向」？太敷衍
- 寫「個性開朗，有領導力」？跟事實差太多家長會察覺
寫到凌晨 1 點還沒寫完。
#7 點石成金怎麼解？（真實技術細節）
功能 A：「成語標籤 → AI 評語」單向轉換（不是輸入直覺評語！）
- 老師從 450+ 詞庫挑特質詞（如「聰穎過人」「不夠認真」「樂於助人」）
- AI 把這些「短評語材料」串成完整段落
- 不是輸入「小明很調皮」AI 給你優化過的版本
- 而是輸入「小明 + 活潑好動、領導力強、稚氣太重」→ 產出整段流暢評語
功能 B：12 種寫作風格可同時生成（核心亮點）
- 質性描述 / 感性關懷 / 友善提醒 / 風趣幽默 / 內在驅動 / 哲理啟發 / 實用指導 / 情感共鳴 / 暖心祝福 / 情境劇描述 / 目標里程碑 / 心靈旅程
- 勾幾種就產幾段（並列而非融合）
功能 C：二階段調整 CommentAdjuster
- 生成後可按：
- 「縮短 30-50%」
- 「擴展細節 30-50%」
- 「換種說法」
- 配合 1-5 級語氣滑桿（正式 ↔ 親切）二次微調
功能 D：石門國小全校共享 API Key（阿凱自掏腰包）
- 阿凱付費的 Gemini API Key 由管理員統一授權給審核通過的同事
- 老師不需自己申請
- v2.6.0、v2.9.0 連續迭代的核心功能
功能 E：班級 / 學生雲端管理 + 多格式匯出
- 班級管理（含學校關聯避免同名班級衝突）
- Excel 匯入學生名單
- 評語歷史版本回溯
- TXT / JSON / Excel / PDF 匯出 + 列印排版 + PWA 離線可用
功能 F：詞庫雙極設計（神細節）
- 每個維度（資賦 / 學業 / 性格 / 行為 / 才藝）都有「優 / 良 / 可 / 差」4 級分組
- 老師可勾「不堪教誨 / 欠缺責任 / 抑鬱寡歡」這類負面詞
- AI 會自動婉轉化 — 這比想像中現實得多
功能 G：繁中強制條款（源於 v2.6.2 簡體字事故）
- 列舉「学 / 进 / 这 / 发 / 时 / 为⋯」要求自動轉繁
- 在 prompt 結尾「再次強調」一次
功能 H：429 配額處理
- 5 次指數退避重試
- 讀取 Google 回應的 RetryInfo
真實技術棧
- React 18.3 + Vite 6 + Tailwind 3（純 SPA，不是 LINE Bot 也不是 Server Action）
- Firebase Auth（Google OAuth）+ Firestore
- LLM：Gemini 2.5 Flash（直接前端 fetch
generativelanguage.googleapis.com/v1beta） - 部署：Firebase Hosting + GitHub Pages 雙軌
- 套件：lucide-react / xlsx / jspdf / html2canvas / file-saver / recharts / vite-plugin-pwa
- 當前 v2.15.0（README 寫 2.9.1，文件落後 package.json）
「人味細節」
- 「點石成金」由來：把學生「平凡甚至負面的觀察」轉成「有溫度、能讓家長看了感到被理解」的評語
- 「蜂」由來：品牌吉祥物 🐝，與蜜蜂群體分工、把花粉（成語標籤）釀成蜜（評語）的隱喻呼應
- 沒有「年級維度」：靠字數 + 語氣 + 風格三軸調，沒有低 / 中 / 高年級切換
- 負面特質婉轉化：「請用婉轉、建議或期許的方式表達」寫進 system prompt
- 沒有 Markdown、無引號包成語 — 直接融入語句
為什麼這比「自己想」好
正向表述 ≠ 隱瞞事實。 家長 / 學生看到的是同一件事，但讀後的感覺完全不同：
- 「上課常吵」家長看了：「老師覺得我兒子是問題學生」→ 對立
- 「展現旺盛求知慾」家長看了：「老師有看見我兒子的優點」→ 信任
信任建立後，老師才有資格提改進建議。 這是親師溝通的核心。
實測數字（我自己 5 年級導師班）
| 指標 | 沒用 AI（去年） | 用 #7（這學期） |
|---|---|---|
| 寫完 30 人評語耗時 | 4 小時（含發呆） | 45 分鐘 |
| 評語平均字數 | 35 字（敷衍） | 80 字（有故事） |
| 期末家長日「跟評語有關」的回饋 | 0 件正向 / 2 件抱怨 | 6 件感謝 / 0 件抱怨 |
| 凌晨 1 點熬夜寫評語次數 | 3 晚 | 0 晚 |
老師 / 家長回饋
「我以前都嫌『正向表述』很假，用了 #7 才發現是我自己找不到對的詞，AI 一翻譯就到位了」
— 5 年級導師 / 教 12 年
「孩子拿成績單回家，我看到評語裡『對需要邏輯推演的內容仍在累積經驗中』，馬上想到他確實常被邏輯題卡住 — 我請老師推薦工具，他說 #44 — 整套配起來」
— 家長
配對工具推薦
- #23 點石成金🐝 評語優化網頁版 — #7 是 LINE Bot 版，#23 是純網頁版，看您習慣哪個
- #89 教師回覆小幫手 Pro — 處理聯絡簿回覆 / 家長 LINE 訊息的 AI 版本
- #16 親師溝通小幫手 — 親師訊息草稿 AI 助手
適用情境
- 學期末 / 學年末 / 畢業時的綜合評語
- 聯絡簿每週留言（給家長看的版本）
- 學習單 / 段考考卷回饋（給學生看的版本）
- 校長 / 主任寫給老師的考核評語
想試試？
第一次用建議從 5 個學生開始試 — 您會驚訝為什麼自己之前要熬夜。