NYCU E3 Helper

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

====================================== Chrome Web Store 擴充功能說明 v2.0 ====================================== NYCU E3 Helper - 讓 E3 學習平台更好用！ 專為陽明交通大學（NYCU）學生設計的 E3 學習平台優化工具，全新 2.0 版本新增評分通知、公告通知，成績與下載功能現在在任何網頁都可使用！ ========== 主要功能 ========== 🤖 AI 智能翻譯與摘要（NEW!） ・AI 翻譯：支援公告、信件、課程內容翻譯為繁體中文 ・AI 摘要：快速總結長篇公告或信件重點 ・格式保留：翻譯後保留原始段落格式、連結、附件 ・點擊即用：翻譯與摘要功能整合在公告詳細頁面 ・Powered by Google Gemini 2.5 Flash-Lite 🔔 智能通知系統（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-Lite 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 系統（課程信件） 確保資訊準確即時，與官方系統同步。 ========== 更新日誌 ========== v2.0 (2026-03-21) - 通知強化與全功能跨頁支援 ✨ 新增作業評分通知：自動偵測已評分狀態，首次偵測時通知 ✨ 新增新公告通知：公告同步時自動比對新舊資料，有新公告立即通知 ✨ 成績查詢、檔案下載 tab 現在在任何網頁都可使用 🐛 修復已登入 E3 但仍顯示「未登入」警告的誤判問題 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 學習平台更智能、更高效！