NYCU E3 Helper

優化 NYCU E3 使用體驗：作業倒數、成績分析、檔案下載（教材/影片/公告）、AI 智能翻譯與摘要、智能通知徽章等功能

====================================== Chrome Web Store 擴充功能說明 v1.9 ====================================== NYCU E3 Helper - 讓 E3 學習平台更好用！ 專為陽明交通大學（NYCU）學生設計的 E3 學習平台優化工具，全新 1.9 版本帶來穩定性修復與使用體驗優化！ ========== 主要功能 ========== 🤖 AI 智能翻譯與摘要（NEW!） ・AI 翻譯：支援公告、信件、課程內容翻譯為繁體中文 ・AI 摘要：快速總結長篇公告或信件重點 ・格式保留：翻譯後保留原始段落格式、連結、附件 ・點擊即用：翻譯與摘要功能整合在公告詳細頁面 ・Powered by Google Gemini 2.5 Flash 🔔 智能通知徽章（NEW!） ・浮動按鈕徽章：顯示未繳交作業數量，24 小時內到期的作業以紅色警示 ・擴充功能圖示徽章：即時顯示重要通知數量 ・通知內容包含：未繳交作業、未讀公告、未讀信件 ・一目了然掌握所有重要資訊 📱 側邊欄助手 ・浮動按鈕：任何網頁都能快速開啟側邊欄 ・響應式設計：美觀的漸層介面，支援滑動展開/收合 ・多分頁切換：作業、公告、成績、設定一目了然 ・跨網頁使用：不限於 E3 網站，任何網頁都能使用 📝 作業倒數與管理（NEW!） ・手動新增作業：自行新增課外作業或專題截止時間 ・編輯與刪除：所有作業（包括 E3 同步作業）皆可編輯或刪除 ・課程選單：智能選單整合 E3 課程列表與自訂課程名稱 ・即時倒數：顯示作業截止時間倒數（天/小時/分鐘） ・自動檢測繳交狀態：同步時自動檢測 E3 作業是否已繳交（NEW!） ・狀態標記：手動標記作業為「已繳交」或「待處理」 ・視覺化提示： - 🔴 已逾期（紅色） - 🟡 即將到期（黃色，3 天內） - 🟢 充裕時間（綠色） ・快速連結：點擊作業直接進入繳交頁面 ・課程顯示：自動顯示作業所屬課程名稱 ・智能合併：手動作業與 E3 同步作業統一管理 ・自動保留：已標記為「已繳交」的作業不會被自動刪除 📢 公告與信件整合 ・公告聚合：整合所有課程的最新公告 ・信件整合：支援 dcpcmail 系統的課程信件 ・統一介面：公告與信件合併顯示，方便管理 ・篩選功能： - 按類型：全部/公告/信件 - 按狀態：全部/未讀/已讀 ・詳細預覽：點擊查看完整內容 ・AI 功能：支援一鍵翻譯與摘要（NEW!） ・已讀追蹤：自動記錄已讀狀態 ・新分頁開啟：預覽中的連結自動在新分頁開啟 📊 成績查詢 ・快速查詢：一鍵查看所有課程成績 ・詳細資訊： - 作業成績與比重 - 考試成績與比重 - 總成績計算 ・視覺化呈現：清楚的分數顯示與百分比 ・即時更新：支援手動重新載入 📥 快速下載教材 ・批次下載：一鍵下載課程所有檔案 ・ZIP 打包：自動打包成 ZIP 檔案 ・自動命名：檔案名稱包含課程名稱 ・進度提示：下載過程中顯示進度 ・支援影片、公告附件批次下載 🔄 自動同步功能 ・背景同步：每小時自動同步一次 ・手動同步：點擊按鈕立即同步 ・同步內容： - 作業列表與截止時間 - 作業繳交狀態自動檢測（NEW!） - 課程列表 - 公告與信件（手動） ・智能檢測：HTML 解析技術自動檢測已繳交作業 ・同步狀態：顯示最後同步時間 ・登入檢查：自動檢測登入狀態 ・錯誤處理：網路錯誤時友好提示 🎯 一鍵前往作業 ・快速按鈕：在 E3 頁面的作業旁新增「📝 前往作業」按鈕 ・直接進入：點擊直接進入作業繳交頁面，跳過日曆頁面 ・支援位置： - ✅ 首頁時間軸 - ✅ 日曆頁面 - ✅ 通知中心 - ✅ 課程總覽 ・動態監聽：自動偵測新增的作業元素 ========== 使用方式 ========== 【第一次使用】 1. 安裝擴充功能 2. 訪問 https://e3p.nycu.edu.tw/ 3. 使用學號密碼登入 4. 開啟任何網頁，點擊右側浮動的「📚 E3小助手」按鈕 5. 點擊側邊欄中的「🔄 同步」按鈕進行首次同步 6. 等待同步完成（約 10-30 秒） 7. 開始使用！ 【管理作業】 ・開啟側邊欄 → 作業分頁 ・查看作業截止時間倒數 ・點擊「➕ 手動新增作業」新增自訂作業 ・選擇課程名稱（支援下拉選單或自行輸入） ・設定截止日期與時間 ・點擊作業可進入繳交頁面 ・完成作業後點擊「已繳交」標記 ・使用「✏️ 編輯」修改作業資訊 ・使用「🗑️ 刪除」移除不需要的作業 【查看公告與信件】 ・開啟側邊欄 → 公告分頁 ・點擊「載入公告」或「載入信件」按鈕 ・使用篩選功能（類型/狀態） ・點擊「查看內容」查看詳細資訊 ・使用 AI 翻譯與摘要功能（需設定 Gemini API 金鑰） 【使用 AI 功能】 ・前往設定分頁 → AI 設定 ・輸入 Google Gemini API 金鑰（免費申請：https://ai.google.dev） ・在公告詳細頁面點擊「AI 翻譯」或「AI 摘要」 ・翻譯支援繁體中文，保留原始格式與連結 【查詢成績】 ・開啟側邊欄 → 成績分頁 ・選擇要查詢的課程 ・點擊「查詢成績」 ・查看作業、考試、總成績 【下載教材】 ・前往 E3 課程頁面 ・開啟側邊欄 ・點擊「📥 下載教材」按鈕 ・等待打包完成並自動下載 【自動同步】 ・擴充功能會每小時自動同步一次 ・可隨時點擊「🔄 同步」手動同步 ・同步狀態會顯示在側邊欄底部 ========== 隱私保護 ========== ・所有資料儲存在本地瀏覽器 ・不收集任何個人資訊 ・不追蹤使用者行為 ・僅訪問 NYCU E3 官方 API ・不連接任何第三方伺服器 ・開源透明，可在 GitHub 查看程式碼 ========== 技術特色 ========== ・Chrome Extension Manifest V3 規範 ・Service Worker 背景同步架構 ・整合 Moodle REST API ・HTML 解析技術自動檢測繳交狀態（NEW!） ・支援 dcpcmail 信件系統 ・JSZip 函式庫支援批次下載 ・Google Gemini 2.5 Flash AI 模型 ・智能 HTML 翻譯引擎（保留格式與連結） ・本地資料快取機制 ・響應式 UI 設計 ・智能通知徽章系統 ========== 資料來源 ========== 所有課程資料來自 NYCU E3 學習平台官方 API (https://e3p.nycu.edu.tw/)，包含： ・作業列表 API (core_calendar_get_action_events_by_timesort) ・課程列表 API (core_course_get_enrolled_courses_by_timeline_classification) ・Moodle Forum API（公告） ・dcpcmail 系統（課程信件） 確保資訊準確即時，與官方系統同步。 ========== 更新日誌 ========== v1.9 (2025-12-05) - 穩定性與體驗優化 🐛 修復重複函數定義導致的時間顯示問題 🐛 修復作業儲存競態條件（加入 debounce 機制） 🎨 將所有彈窗提示改為非阻塞式 Toast 通知 🎨 同步超時時加入重試按鈕 🎨 優化日誌系統效能（throttling） 🎨 改善信件載入的使用者回饋 v1.8 (2025-11-25) - 自動檢測繳交狀態 ✨ 新增作業繳交狀態自動檢測功能 ✨ 使用 HTML 解析技術智能判斷作業是否已繳交 ✨ 擴大同步範圍從 7 天到 30 天，確保較舊作業也能正確檢測 🐛 修復手動改變狀態後作業可能消失的問題 🐛 修復已繳交作業在同步後不被保留的問題 🎨 優化作業保留邏輯（未過期作業全部保留，已過期只保留已繳交） v1.7 (2025-11-25) - 作業管理增強 ✨ 新增手動新增作業功能（支援自訂課程、截止時間） ✨ 所有作業（包括 E3 同步作業）支援編輯和刪除 ✨ 課程欄位改為智能選單（整合 E3 課程與自訂輸入） ✨ 新增臨時訊息提示系統 ✨ 自動收集課程名稱作為選項 🎨 優化作業管理流程與使用體驗 🐛 刪除同步作業時顯示警告提示 v1.6 (2025-11-24) - AI 智能更新 ✨ 新增 AI 智能翻譯功能（支援繁體中文，保留格式與連結） ✨ 新增 AI 智能摘要功能 ✨ 新增智能通知徽章系統（浮動按鈕與擴充功能圖示） ✨ 新增 24 小時緊急作業通知（紅色警示） ✨ 整合 Google Gemini 2.5 Flash API ✨ 新增 AI 設定頁面（API 金鑰管理） ✨ 支援影片與公告附件批次下載 🐛 修復未讀卡片對齊問題 🐛 修復翻譯後連結與附件無法點擊問題 🐛 修復非 E3 網站重新載入郵件按鈕錯誤 🎨 優化使用說明文件 v1.1 (2025-01-17) - 重大更新 ✨ 新增側邊欄介面，支援跨網頁使用 ✨ 新增作業倒數與狀態管理功能 ✨ 新增公告與信件整合（支援 dcpcmail） ✨ 新增成績查詢功能 ✨ 新增快速下載教材功能 ✨ 新增自動同步功能（每小時） 🐛 修復作業課程名稱顯示問題 🐛 修復 Extension Context Invalidated 錯誤 🎨 改進 UI/UX 設計，更加美觀易用 v1.0 (2025-01-14) ✨ 新增一鍵前往作業按鈕 ✨ 支援動態載入的內容（MutationObserver） ✨ 紫色漸層按鈕設計 ========== 開源資訊 ========== 開源專案：https://github.com/CBJ0519/portal_e3_helper 問題回報：https://github.com/CBJ0519/portal_e3_helper/issues 授權：MIT License 歡迎提交 Issue 和 Pull Request！ ========== 注意事項 ========== ・首次使用需登入 E3 平台並進行同步 ・作業倒數功能需要先同步資料 ・自動檢測功能會在每次同步時檢測作業繳交狀態（NEW!） ・公告與信件需手動載入（避免流量過大） ・AI 功能需設定 Gemini API 金鑰（免費申請） ・下載大型教材可能需要較長時間 ・擴充功能會每小時自動同步一次 ・建議定期同步以獲取最新資訊 ・已標記為「已繳交」的作業會保留在列表中 ・未過期的作業會全部保留，已過期只保留已繳交的（NEW!） ・API 金鑰僅儲存在本地瀏覽器，不會上傳 讓 NYCU E3 學習平台更智能、更高效！