iEMPT考題圖片自動下載與 PDF 合併助手 (iEMPT_Exam_Fetcher)

這是一個 Chrome 瀏覽器擴充功能 (Extension)，專為解決線上學習平台需「逐一下載考題圖片」的不便而設計。它能自動偵測網頁上的考題連結，將所有圖片下載並自動合併成一份 A4 格式的 PDF 檔案，大幅節省整理筆記的時間。

✨ 主要功能 (Features)

• 自動偵測：智慧辨識頁面上包含 "exam" 關鍵字的連結。
• 批量下載：一鍵抓取所有相關的 JPG/PNG 考題圖片。
• PDF 合併：使用 pdf-lib 技術，將多張圖片依序排列並合併。
• 格式優化：自動將圖片縮放並置中於 A4 頁面，保留適當邊距，方便列印或閱讀。

🛠️ 技術棧 (Tech Stack)

• Manifest V3：符合最新 Chrome 擴充功能規範。
• JavaScript (ES6+)：核心邏輯處理。
• pdf-lib.js：強大的前端 PDF 處理函式庫 (用於合併圖片)。

📦 安裝教學 (Installation)

由於本插件未上架至 Chrome Web Store，請依照以下步驟手動安裝：

1. 下載程式碼：

   • 點擊本頁面綠色的 <> Code 按鈕，選擇 Download ZIP。
   • 將下載的檔案解壓縮，你會看到一個包含 manifest.json、popup.js 等檔案的資料夾。

2. 開啟 Chrome 擴充功能管理頁面：

   • 在瀏覽器網址列輸入：chrome://extensions/
   • 開啟右上角的 「開發人員模式」 (Developer mode) 開關。

3. 載入插件：

   • 點擊左上角的 「載入未封裝項目」 (Load unpacked)。
   • 選擇剛剛解壓縮的資料夾。
   • 安裝完成！瀏覽器右上角會出現拼圖圖示，點開即可看到插件。

📖 使用說明 (Usage)

1. 前往含有考題圖片連結的目標網頁 (例如：電磁學線上學習平台 https://em.emedu.org.tw/exam01.aspx)。
2. 點擊 Chrome 瀏覽器右上角的插件圖示。
3. 按下 「開始偵測並合併」 按鈕。
4. 等待進度條跑完 (請勿關閉視窗)，完成後會自動彈出視窗儲存 PDF 檔案。

⚠️ 注意事項與限制

• 適用範圍：本工具主要針對特定架構的教學網站設計，若網站結構不同可能需要自行修改代碼。
• 檔案格式：僅支援直接連結為 JPG 或 PNG 的圖片檔。若連結指向 HTML 頁面或 PDF 檔，合併將會失敗。
• 關鍵字：預設僅抓取連結文字包含 exam 的項目。若需抓取其他檔名，請修改 popup.js 中的 includes('exam') 條件。

📄 授權 (License)

本專案使用開源庫 pdf-lib (Apache-2.0 License)。 本專案程式碼供學習與教育用途交流。

---

Made with ❤️ for better learning efficiency.