# HyRead 電子書館藏查詢助手 (Chrome 擴充功能)

本擴充功能可為 `HBSearch85.html`、`HBSearch73G.html` 提供純瀏覽器端跨域查詢支援，徹底解決 HyRead 官方 Cloudflare 防火牆對雲端機房 IP (Cloudflare Pages / Vercel) 回應 **HTTP 403 (Turnstile 驗證)** 的問題。

---

## 為什麼需要本擴充功能？

1. **HyRead 官方 Cloudflare WAF 限制**：
   HyRead 近期加強防禦，任何來自雲端主機、資料中心（例如 Cloudflare Workers、Cloudflare Pages Functions、Vercel 等）的連線，都會直接被阻擋並要求 Turnstile 人機驗證（HTTP 403）。
2. **瀏覽器端發送請求**：
   透過本擴充套件，所有對 HyRead 的請求直接由您本機的瀏覽器發出（使用您家中的家用寬頻或手機網路 IP），符合正常瀏覽器指紋，**完全不會觸發 Cloudflare 403 機房阻擋**。
3. **搭配網頁端智慧節流保護**：
   查詢頁面已內建「低併發節流（每次 2~3 館）」、「隨機延遲（800ms）」與「24 小時本地快取」，從根本上保護您的 IP 不會因為頻繁查詢而被封鎖。

---

## 30 秒安裝步驟 (Chrome / Edge / Brave)

1. **下載或解壓縮本專案**至您的電腦資料夾。
2. 開啟瀏覽器擴充功能頁面：
   - Chrome：在網址列輸入 `chrome://extensions/`
   - Edge：在網址列輸入 `edge://extensions/`
3. 在右上角開啟 **「開發人員模式 (Developer mode)」** 開關。
4. 點擊左上角的 **「載入未封裝項目 (Load unpacked)」** 按鈕。
5. 選擇本專案的 `chrome-extension` 資料夾。
6. 安裝完成！重新整理查詢網頁（`HBSearch85.html` 或 `HBSearch73G.html`），頁面將自動偵測並切換為「🟢 瀏覽器助手直連模式」。

---

> 💡 **不想安裝擴充功能？**
> 您也可以改用更簡單的 **Tampermonkey 油猴腳本**：
> 安裝 Tampermonkey 後，在專案中點擊 `hyread-companion.user.js` 即可一鍵安裝。
