Repository navigation
v1.4.7 — 案件查詢存取控制、Gemini 模型更新與文件稽核 (Case-Lookup Access Control, Gemini Model Refresh & Docs Audit)
Latestv1.4.7 — 案件查詢存取控制、Gemini 模型更新與文件稽核
發布日期 / Release Date:2026-10-22
上一版本 / Previous:v1.4.6
完整比對 / Full Diff:v1.4.6...v1.4.7
內容與
CHANGELOG.md的[v1.4.7]條目一致,另加上「升級須知」供部署參考。
🔑 重點摘要 / TL;DR
- 🔒 案件查詢須「學號+手機末 4 碼」並通過 reCAPTCHA,修復任何人只要猜學號就能查到他人房號、床號與問題描述的個資外洩(SEC-QUERY-01)
- 🔗 查詢結果不再能被塞入釣魚連結(SEC-QUERY-02)
- 🔑 Gemini API Key 改以 header 傳送,不再出現在 URL(SEC-GEMINI-01)
- 🤖 Gemini 備援模型 6 → 5 個:移除已棄用模型,新增
gemini-3.8-flash - 📦 開發依賴 2 個 high 等級弱點已修補(
npm audit:0 vulnerabilities) - 📄 全站文件與程式碼逐項比對修正,移除 2 個過時檔案,版本號統一為 v1.4.7
- ✅ 單元測試 55 → 60 項全數通過,ESLint 0 error / 0 warning
🔒 資安修正
SEC-QUERY-01:查詢案件須學號+手機末 4 碼+reCAPTCHA
| 修正前 | 修正後 | |
|---|---|---|
| 查詢條件 | 只要學號 | 學號+報修時填寫的手機末 4 碼 |
| 機器人防護 | 無(僅依前端可偽造的 clientId 限流) |
reCAPTCHA v3(action query_report,門檻 0.5) |
| 學號不存在 vs 末 4 碼錯誤 | — | 回傳完全相同的空結果,不洩漏學號是否存在 |
學號格式可預測(1 英文字母 + 7 位數字),舊版等於提供一個可列舉全體住宿生房號與報修內容的介面。
SEC-QUERY-02:查詢結果 Markdown 連結注入
查詢結果經 _renderMarkdown() 渲染,報修描述填入 [點我](https://…) 會變成機器人訊息中可點擊的連結。js/query.js 的 _esc() 現另轉義 [ ] ( ) * _。
SEC-GEMINI-01:API Key 改以 header 傳送
classifyIntent() 改用 x-goog-api-key header,避免 Key 出現在 URL 被代理或存取記錄留存。
開發依賴
npm audit fix:brace-expansion 1.1.20 → 1.1.21(GHSA-q2hr-2g5m-vwhr、GHSA-qhr7-859c-m2p7、GHSA-6j4f-fj2g-mc7p)、js-yaml 4.3.1 → 4.3.2(GHSA-2883-xcg3-v3hh)。皆為 ESLint 間接依賴,不會部署至線上。
🤖 Gemini 模型清單(依官方 deprecations 頁面,2026-10)
| 變更 | 模型 | 原因 |
|---|---|---|
| ➖ 移除 | gemini-3.5-flash |
已棄用,API 請求自動導向 gemini-3.6-flash(留著只會重複呼叫) |
| ➖ 移除 | gemini-3-flash-preview |
官方建議改用 gemini-3.6-flash |
| ➕ 新增 | gemini-3.8-flash |
最新 Stable Flash 模型 |
| ⏳ 保留 | gemini-3.1-flash-lite |
官方預告 2027-05-07 下架,屆時移除 |
新清單:gemini-3.5-flash-lite → gemini-3.1-flash-lite → gemini-3.8-flash → gemini-3.6-flash → gemini-3.1-pro-preview
📄 文件稽核
- 修正 reCAPTCHA 適用範圍、模型數、測試數、
UNKNOWN子主題(應為NONE)、去重程式碼片段、CI 觸發條件、Pages 部署方式等過時描述 gas/Code.gs部署步驟補上RECAPTCHA_SECRET_KEY- README 新增「測試」章節(各測試檔項數與涵蓋範圍)
- 移除
VIBECODING_PROMPT_v1.4.6.md、RELEASE_NOTES_v1.4.6.md(發布說明改以 GitHub Release 為準)
⚠️ 升級須知 / Upgrade Notes
- GitHub Pages 前端:合併至
main後自動更新。 - GAS 後端須手動部署:將
gas/Code.gs全文貼入 GAS 專案 → 部署 → 管理部署 → 編輯 → 新版本。在此之前,SEC-QUERY-01 防護不會生效。 - Script Properties 不需新增項目(沿用
GEMINI_API_KEY、SPREADSHEET_ID、RECAPTCHA_SECRET_KEY)。
English Summary
- SEC-QUERY-01: case lookup now requires the student ID plus the last 4 digits of the mobile number on the report, and reCAPTCHA v3 (
query_report). An unknown ID and a wrong last-4 return the identical empty result. - SEC-QUERY-02: Markdown characters are escaped in query results, so report descriptions can no longer render as phishing links.
- SEC-GEMINI-01: Gemini API key moved from the
?key=URL parameter to thex-goog-api-keyheader. - Gemini fallback list 6 → 5 models (removed deprecated
gemini-3.5-flash,gemini-3-flash-preview; addedgemini-3.8-flash). - Dev dependencies patched (
npm audit: 0 vulnerabilities); docs audited; tests 55 → 60. - Redeploy
gas/Code.gsmanually; the frontend updates automatically via GitHub Pages.