📖 #87 PIRLS Pro QuestionCraft：把舊版 HTML 單檔砍掉重練成 Next.js + Cloud Functions 的閱讀素養出題神器
#87 PIRLS QuestionCraft 是舊版 #4 PIRLS 的完全重寫版。Next.js 15 + Gemini 2.5 Flash + Firestore，月費 < 0.25 美金的 serverless 架構，PaGamO 題組批量上傳 + 學生 QR 即時作答 + 班級儀表板一條龍。
PIRLS 是什麼？為什麼國小老師都在追？
PIRLS（Progress in International Reading Literacy Study）是國際閱讀素養評量，5 年一次，台灣國小四年級學生全國抽測。
考的是 四個層次的閱讀理解力：
- 訊息提取（文章字面找答案）
- 直接推論（連接兩個段落推結論）
- 詮釋整合（理解作者意圖、人物動機）
- 評估批判（評論寫作技巧、提出觀點）
108 課綱把這四層次寫進國語教學目標。國小老師現在出題不再只是「課文第三段哪一句」，而是要 四層次比例平衡。
老師的真實痛點
我自己改了 8 年國語，每次出段考題：
- 要找文章 → 翻課本、翻補充教材、找網路文章
- 要分配層次 → 8 題裡哪幾題是「訊息提取」哪幾題是「評估批判」
- 避免洩答 → 解說欄不能透露答案在第幾段
- 格式打字 → Word 排版、列印、答案卷
- 不同平台 → 段考紙本、平時 PaGamO、補救教學用簡單版
一篇文章出 8 題完整題組要 1.5-2 小時。
#87 QuestionCraft 怎麼解？（真實技術細節）
這個工具是阿凱把舊版 #4 PIRLS（純 HTML 單檔站）完全砍掉重練的 Pro 版。看 repo 就知道有多硬：
架構升級：
- 舊版：純 HTML 單檔 + client 端塞 API Key + 要自己掛 VM
- 新版：Next.js 15 + React 19 + Cloud Functions v2（Node 22）+ GitHub Pages
- 月費實測 < 0.25 美金
功能 A：雙輸入模式
- 圖片 OCR：拖放最多 4 張、支援 Ctrl+V 直接貼截圖（拍課本一頁就行）
- 自動壓縮到 1600px / JPEG 0.85 再送 Gemini，省流量
- 文字模式：直接貼純文字，server-side 強制
articleContent = input.text覆蓋回去，AI 偷改原文也沒用
功能 B：AI 自動分層出題
- 用 Gemini 2.5 Flash + Genkit 編排（從 1.5 → 2.0 → 2.5-lite → 2.5 一路追模型）
- Handlebars 模板做 prompt engineering
- Zod schema 強制 JSON 結構
- 8 題模式：四層次各 2 題；10 題模式：3/3/2/2
- 規定每題的 question + explanation 都要 「引用文章關鍵字」，老師可驗證
功能 C：6 種匯出格式（殺手鐧）
- PDF（嵌入 Noto Sans TC 6 種字重）
- Excel 題庫
- PaGamO 單題格式
- PaGamO 題組格式（真的對到平台批量上傳範本，這個熟悉 PaGamO 的老師會尖叫）
- 站內測驗模式
- 學生作答 PDF
功能 D：學生 QR 即時作答
- 老師按「分享」→ Firestore 開 1 小時 TTL 的測驗連結
- 學生掃 QR + 填班級座號姓名 → 即時答
- 老師
/dashboard/?id=xxx看全班成績 - 隱私 + 成本雙保險：1 小時自動清資料
功能 E：三層成本護欄
- Cloudflare Turnstile（無感人機驗證）
- 5 RPM / IP 速率限制
- Cloud Functions
maxInstances=10 - 實測月費 < 7 元台幣，200x 安全餘量
功能 F：老師後台 /admin/
- Bearer auth + 5 RPM
- 看使用次數 / Gemini 花費
- LINE Messaging 每週日 21:00 自動推週報
實測數字
| 指標 | 傳統手工出題 | 用 #87 QuestionCraft |
|---|---|---|
| 一篇文章出 8 題時間 | 1.5-2 小時 | 3 分鐘 |
| 四層次比例 | 憑感覺（常常失衡） | 嚴格 2/2/2/2 自動分配 |
| PaGamO 上傳 | 手動 key 一題一題 | 一鍵題組匯出 |
| 學生即時作答 | 印紙本 + 改 | 掃 QR 即時看儀表板 |
| 成本 | 紙張 + 影印機 + 改作業時間 | < 7 元台幣/月 |
老師回饋
「我把六上康軒第 7 課拍成 4 張照片貼進去，3 分鐘出 10 題 PIRLS 平衡題組，直接送 PaGamO 給孩子當回家功課」
— 桃園市某國小六年級導師
「以前我們補救教學沒題目，現在我用 #87 出簡單版題組，學生回家用手機掃 QR 答，我隔天進度一目了然」
— 補救教學老師
「OG 域名是
pirlss.smes.tyc.edu.tw— 連阿凱老師都把工具掛自己學校網域，這真的是老師寫給老師的」— Facebook 教師社團網友
配對工具推薦
- #4 PIRLS 閱讀理解生成 — 舊版（單檔 HTML，輕量初試水溫適用）
- #12 PIRLS 閱讀理解網 — 中介版
- #87 PIRLS QuestionCraft Pro — 本篇主角，完全 serverless 重構
適用對象
- 國小三到六年級國語老師（PIRLS 四層次完全對應）
- 國中國文老師（會考閱讀理解題型相通）
- 補救教學老師（出簡單版題組超快）
- 用 PaGamO 的所有老師（題組匯出格式直接吃）
- 對閱讀素養課程設計有興趣的研究者
想試試？
→ 前往 #87 PIRLS QuestionCraft Pro
第一次用建議從 「拍課本兩頁照片」 開始 — 3 分鐘讓你看到完整 8 題 PIRLS 四層次題組吐出來，會回不去手寫了。