NYCU 選課助手

====================================== Chrome Web Store 擴充功能說明 v3.1.2 ====================================== NYCU 選課助手 v3.1.2 - 讓選課更輕鬆！ 專為陽明交通大學（NYCU）學生設計的選課輔助工具，3.1.2 版本修正軍訓、學分學程等課程無法載入的問題，並新增軍訓課程篩選功能！ ========== 主要功能 ========== 🤖 AI 智能搜尋（NEW!） ・自然語言搜尋：用自然語言描述需求，AI 自動幫你找到合適的課程 ・搜尋範例：「我想找週一下午的資工系課程」、「推薦不用考試的通識課」 ・智能分析：AI 會分析課程內容、評分方式、時間地點等因素 ・主動學習：啟動時自動提取所有課程關鍵字，支援暫停/繼續，越用越聰明 ・Powered by Google Gemini 2.5 Flash 📅 課表製作與管理（NEW!） ・視覺化課表：自動生成美觀的課表，清楚顯示每週課程安排 ・拖曳添加：搜尋結果可直接拖曳到課表上 ・衝堂檢查：自動提示時間衝突的課程 ・課表匯出：支援 PNG 格式匯出，方便分享與保存 🔍 智能搜尋功能 ・支援課程名稱、代碼、系所、學院、教師、時間、教室多條件搜尋 ・智能簡稱識別：輸入「邏設」找到「邏輯設計」，輸入「線代」找到「線性代數」 ・多關鍵字搜尋：用空格分隔多個條件（例如：「資工 演算法」、「邏設 一年級」） ・即時顯示搜尋結果 ⭐ 書籤管理 ・收藏常用課程到書籤 ・專屬書籤分頁，快速存取收藏的課程 ・批次管理功能，一鍵清空所有書籤 ・書籤資料永久儲存在本地 📋 詳細資訊查詢 ・完整課程資訊：時間地點、學分、必選修 ・授課教師與聯絡方式 ・先修科目或先備能力 ・課程概述與教學目標 ・評量方式與配分細節 ・教科書與教學方法 ・師生晤談時間 ・整合官方 API，資訊最完整準確 📂 選課路徑顯示 ・顯示所有可用的選課途徑 ・結構化資訊：類型 / 類別 / 學院 / 系所 / 年級 ・支援多路徑課程，全部列出 📄 課程綱要連結（NEW!） ・一鍵開啟官方課程綱要頁面 ・快速查看完整官方課程綱要 💾 本地資料儲存 ・課程資料本地儲存 7 天 ・自動更新提示 ・快速查詢，無需重複載入 ・智能快取機制 ========== 使用方式 ========== 【第一次使用】 1. 安裝擴充功能 2. 點擊擴充功能圖示開啟側邊欄 3. 閱讀歡迎引導，了解主要功能 4. 訪問 https://timetable.nycu.edu.tw/ 5. 等待約 5 分鐘自動載入課程資料 6. 開始搜尋！ 【使用 AI 智能搜尋】 ・切換到「🤖 AI 搜尋」分頁 ・前往設定輸入 Google Gemini API 金鑰（免費申請：https://ai.google.dev） ・用自然語言描述需求，例如：「我想找週一下午的資工系課程」 ・AI 會自動分析並推薦合適的課程 【搜尋課程】 ・在「🔍 搜尋」分頁的搜尋框輸入關鍵字 ・點擊「查看完整資訊」查看課程詳細內容 ・點擊「📄 開啟課程綱要」查看官方課程綱要 ・拖曳課程卡片到課表上快速添加 【製作課表】 ・切換到「📅 課表」分頁 ・從搜尋結果或書籤點擊「+ 加入課表」 ・系統會自動檢查時間衝突 ・點擊課表中的課程可選擇「查看詳細資料」或「查看此時段課程」 ・點擊「📸 匯出圖片」儲存為 PNG 圖片 ・點擊「📅 匯出日曆」匯出到 Google Calendar 【使用書籤】 ・在課程卡片右上角點擊 ☆ 星號圖示加入書籤 ・切換到「⭐ 我的書籤」分頁查看收藏 ・再次點擊星號可移除書籤 ・點擊「清空所有書籤」批次刪除 【搜尋範例】 ・課程名稱：「微積分」 ・課程簡稱：「邏設」「線代」「計組」 ・課程代碼：「DCP1192」 ・教師：「王禹超」 ・系所：「資工系」「資訊工程」 ・學院：「電機學院」「理學院」 ・時間：「M」(星期一)「M3」(星期一第3節)「T56」(星期二5-6節)「R34」(星期四3-4節) ・教室：「EC015」「EC114」 ・多條件：「邏設 資工」「M56 資工」「微積分 王禹超」「M3 微積分」 時間代碼說明： ・星期：M(一) T(二) W(三) R(四) F(五) S(六) U(日) ・節次：1-9, a-d ========== 隱私保護 ========== ・課程搜尋資料儲存在本地瀏覽器 ・不收集任何個人資訊 ・僅訪問 NYCU 官方課程 API ・書籤資料完全本地化 ・API 金鑰僅儲存在本地瀏覽器，不會上傳 ・AI 搜尋需使用 Gemini API（可選功能） ・開源透明，可在 GitHub 查看程式碼 ========== 技術特色 ========== ・原生 JavaScript，無框架依賴 ・Chrome Extension Manifest V3 規範 ・整合 NYCU 課程時間表官方 API ・Google Gemini 2.5 Flash AI 模型 ・html2canvas 課表截圖技術 ・側邊欄（Side Panel）技術 ・本地資料快取，搜尋速度快 ・響應式設計，介面清晰易用 ・拖曳式互動設計 ========== 資料來源 ========== 所有課程資料來自 NYCU 課程時間表系統官方 API (https://timetable.nycu.edu.tw/)，包含： ・課程基本資料 API (get_cos_list) ・課程綱要基礎資訊 API (getCrsOutlineBase) ・課程綱要詳細描述 API (getCrsOutlineDescription) 確保資訊準確即時，與官方系統同步。 ========== 更新日誌 ========== v3.1.2 (2026-03-20) - 課程載入修正 🔧 修正軍訓（全民國防教育）課程無法載入的問題 🔧 修正學分學程、跨域學程課程無法載入的問題 🔧 修正特定系所 API 500 錯誤（自動跳過，不影響整體載入） ✨ 新增軍訓課程類型篩選與專屬顏色（軍綠色） 🎨 改進資料載入進度顯示（移除不準確的百分比） v3.1.0 (2025-12-05) - 使用體驗優化 ✨ 新增課程點擊選單（查看詳細資料 / 查看此時段課程） ✨ 新增首次使用歡迎引導 ✨ 新增 ESC 快捷鍵關閉彈窗 ✨ 新增搜尋結果分頁功能 ✨ 新增 API Key 安全提示 🔧 修正學分計算邏輯（僅計算完整顯示的課程） 🔧 修正課表匯出圖片問題 🔧 移除冗餘 console.log 🎨 更新使用說明文件 v3.0.2 (2025-11-24) - AI 主動學習優化 ✨ 新增主動關鍵字學習功能（啟動時自動提取） ✨ 新增學習進度實時顯示 ✨ 新增暫停/繼續學習控制 🔧 添加 API 請求超時機制（避免卡住） 🔧 優化批次處理性能（10門課/批次，1秒延遲） 🎨 簡化進度條設計（頂部低調顯示） v3.0.1 (2025-11-24) - 權限優化 🔧 移除未使用的 AI API 權限（僅保留 Gemini） 📝 更新文件說明 v3.0.0 (2025-11-24) - AI 智能更新 ✨ 新增 AI 智能搜尋功能（自然語言搜尋） ✨ 新增課表製作與管理功能 ✨ 新增課表匯出功能（PNG 格式） ✨ 整合 Google Gemini 2.5 Flash API ✨ 新增拖曳式課程添加功能 ✨ 新增課程時間衝突檢查 ✨ 新增 AI 設定頁面 ✨ 整合 html2canvas 技術 🐛 修復課程列表參與人數對齊問題 🎨 優化課程卡片佈局 v2.0 (2025-01-17) - 重大更新 ✨ 新增書籤系統 ✨ 新增詳細資訊頁面 ✨ 整合官方 API 獲取完整課程資訊 ✨ 顯示選課路徑完整列表 ✨ 添加課程綱要快速連結 🎨 全新 UI 設計 🎨 優化視覺效果與互動體驗 📝 延長資料有效期至 7 天 v1.0 (2025-01-14) 🎉 首次發布 🔍 基本搜尋功能 💾 本地資料儲存 📊 顯示課程基本資訊 ========== 開源資訊 ========== 開源專案：https://github.com/CBJ0519/portal_course_registration 問題回報：https://github.com/CBJ0519/portal_course_registration/issues 授權：MIT License 歡迎提交 Issue 和 Pull Request！ ========== 注意事項 ========== ・首次使用需載入課程資料（約 5 分鐘） ・資料每 7 天自動更新一次 ・AI 搜尋功能需設定 Gemini API 金鑰（免費申請） ・課表匯出支援 PNG 圖片和 .ics 日曆格式 ・支援所有課程類型（學士班、碩士班、博士班等） ・建議定期更新以獲取最新課程資訊 ・書籤與課表資料永久保存，除非手動清空 ・API 金鑰僅儲存在本地瀏覽器，不會上傳 ・按 ESC 鍵可快速關閉任何彈出視窗 讓 NYCU 選課更聰明、更輕鬆！