update readme

Author: as6325400

README.md

@@ -1,25 +1,100 @@
-## Usage
+# 📅 Moodle to Google Calendar Extension
 
-```
+這是一個用於將 CCU（中正大學）Moodle 上的作業或行事曆事件，一鍵匯出至 Google Calendar 的 Chrome/Edge 擴充功能。  
+可選擇匯出 `.ics` 檔案下載，或直接自動授權後匯入 Google 行事曆。
+
+> 幫助學生更有效管理 Moodle 上的課業與繳交時程。
+
+---
+
+## 🚀 功能特色
+
+- 🔍 自動抓取 Moodle 課程中的行事曆事件（需登入）
+- 📥 支援下載 `.ics` 檔案，可匯入至任何行事曆 App
+- 📆 可直接登入 Google 帳戶，將事件自動新增至 Google Calendar
+- 🖱️ 操作簡單，一鍵完成
+
+---
+
+## 🛠 技術架構
+
+- Chrome Extension (Manifest V3)
+- Content Script + Popup UI
+- Tailwind CSS for styling
+- Vite 作為打包工具
+- Google OAuth（`chrome.identity` + `launchWebAuthFlow`）
+- ESLint + Prettier 做為開發輔助
+
+---
+
+## 📦 安裝與使用
+
+### 安裝依賴套件
+
+```bash
 npm install
 ```
 
-```
+---
+
+### 建置專案
+
+```bash
 npm run build
 ```
 
-## Tailwind hotfix
+產出可安裝的 extension 專案在 `dist/` 目錄中，可透過 Chrome 擴充功能手動載入。
 
-```
+---
+
+### Tailwind 修復樣式（可選）
+
+```bash
 npm run hotfixcss
 ```
 
-## eslint
-```
-npm run lint
-```
+在樣式未正常更新或 Tailwind 出現異常時手動執行。
+
+---
+
+### 程式碼檢查與格式化
 
-## format
+```bash
+npm run lint      # 使用 ESLint 檢查語法
+npm run format    # 使用 Prettier 自動格式化程式碼
 ```
-npm run format
-```
+
+---
+
+## 📚 使用說明
+
+1. 登入 Moodle（目前支援中正大學 https://ecourse2.ccu.edu.tw/）
+2. 點擊瀏覽器右上角 Extension 圖示，開啟插件視窗
+3. 選擇年份與月份，點擊：
+   - 「📥 取得行事曆」：下載 `.ics` 檔案
+   - 「📤 匯入行事曆」：登入 Google 並自動新增至 Google Calendar
+
+---
+
+## 🔐 授權與隱私
+
+- 本插件僅在使用者當前登入 Moodle 且主動點擊下操作才會擷取資料
+- Google OAuth 權限僅限寫入行事曆事件，不會存取其他個資
+- 資料僅存在本地，無傳送至第三方伺服器
+
+---
+
+## 🧪 瀏覽器支援狀況
+
+| 瀏覽器 | 支援情況 | 備註 |
+|--------|----------|------|
+| Chrome | ✅ 完整支援 | 使用 `getAuthToken()` 快速登入 |
+| Edge   | ✅ 部分支援 | 改用 `launchWebAuthFlow()`，需初次登入後允許 |
+| Brave / Others | ⚠️ 未測試 | 如有需求可補充支援判斷邏輯 |
+
+---
+
+## 🙌 貢獻與反饋
+
+歡迎 issue/PR！  
+如果你是 CCU 學生，覺得這個擴充功能有幫助，也歡迎幫我按星 🌟 或留言回饋 🙏