Skip to content

v1.4.7 — 案件查詢存取控制、Gemini 模型更新與文件稽核 (Case-Lookup Access Control, Gemini Model Refresh & Docs Audit)

Latest

Choose a tag to compare

@chinglin-k chinglin-k released this 22 Oct 15:42
47edc6b

v1.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

  1. GitHub Pages 前端:合併至 main 後自動更新。
  2. GAS 後端須手動部署:將 gas/Code.gs 全文貼入 GAS 專案 → 部署 → 管理部署 → 編輯 → 新版本。在此之前,SEC-QUERY-01 防護不會生效。
  3. 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 the x-goog-api-key header.
  • Gemini fallback list 6 → 5 models (removed deprecated gemini-3.5-flash, gemini-3-flash-preview; added gemini-3.8-flash).
  • Dev dependencies patched (npm audit: 0 vulnerabilities); docs audited; tests 55 → 60.
  • Redeploy gas/Code.gs manually; the frontend updates automatically via GitHub Pages.