基於Google Gemini AI的Gmail和Outlook郵件分析瀏覽器擴充套件，協助使用者快速理解郵件的情緒、目的和內容類型。
「郵件情緒分析擴充套件」是一款透過AI技術分析電子郵件的瀏覽器擴充套件，能夠自動識別並呈現郵件的情緒傾向、內容類型和郵件目的，幫助使用者更有效率地管理收件匣。本擴充套件整合了Google Gemini人工智能技術，支援Gmail和Outlook網頁版郵件系統，並提供繁體中文和英文介面。
- 即時情緒辨識: 快速了解郵件的情感傾向，優先處理緊急或重要的信件
- 內容自動分類: 區分商業、個人、行銷或通知類信件，輕鬆整理收件匣
- 目的快速識別: 識別郵件的主要目的（問候、請求、通知等），提高回覆效率
- 輕量化整合: 無縫整合於Gmail和Outlook界面，不干擾正常使用體驗
- 郵件情緒分析: 識別郵件情緒為正面、負面、中性、急迫或友好等類型，並給出信心分數
- 內容類型辨識: 自動辨別郵件為商業、個人、行銷、通知或帳單等類型
- 郵件目的識別: 分析郵件目的是問候、請求、通知、提醒、銷售或確認等
- 多郵件服務支援: 同時支援Gmail和Outlook網頁版郵件系統
- 多語言分析: 支援繁體中文和英文郵件內容分析
- 批次分析: 可一次分析多封郵件，提高處理效率
- 使用者介面整合: 無縫嵌入Gmail和Outlook介面，提供直觀的分析結果顯示
- 客製化設定: 可調整分析顯示選項、通知規則等
擴充套件採用模組化設計，主要包含以下組件：
email-analyzer/
├── manifest.json # 擴充套件配置文件
├── background.js # 背景腳本，處理API請求與身份驗證
├── content-scripts/ # 內容腳本，整合郵件介面
│ ├── gmail.js # Gmail整合腳本
│ ├── gmail.css # Gmail樣式
│ ├── outlook.js # Outlook整合腳本
│ └── outlook.css # Outlook樣式
├── popup/ # 彈出視窗界面
│ ├── popup.html
│ ├── popup.css
│ └── popup.js
├── lib/ # 核心功能庫
│ ├── gemini-api.js # Gemini API整合
│ ├── email-parser.js # 郵件解析器
│ ├── email-parser.module.js # 郵件解析模組
│ └── analyzer.js # 情緒/內容分析模組
├── icons/ # 擴充套件圖示
└── _locales/ # 多語言支援
├── en/
│ └── messages.json
└── zh_TW/
└── messages.json
- 使用者在Gmail或Outlook中開啟郵件
- 擴充套件在郵件界面注入分析按鈕
- 使用者點擊分析按鈕後，擴充套件擷取郵件內容
- 郵件內容經過解析器淨化，移除HTML格式、引用內容等
- 背景腳本將處理過的內容發送至Gemini API
- Gemini API返回情緒、內容類型和目的分析結果
- 分析結果顯示在郵件界面上，並可選擇通知提醒
- 支援的瀏覽器：Chrome、Edge、Firefox或Safari
- 需要一個Gemini API金鑰（可在Google AI Studio申請）
- 訪問Chrome Web Store（或其他瀏覽器的擴充套件商店）
- 搜尋"郵件情緒分析"
- 點擊"加到Chrome"按鈕安裝
- 安裝後點擊工具列中的擴充套件圖示
- 在設定頁面輸入您的Gemini API金鑰
- 下載此倉庫的ZIP檔或使用git複製：
git clone [倉庫URL] - 開啟Chrome瀏覽器，前往
chrome://extensions - 開啟右上角的"開發者模式"
- 點擊"載入未封裝的擴充功能"
- 選取此專案中的
email-analyzer資料夾 - 安裝完成後，點擊擴充套件圖示並設定您的API金鑰
- 設定API金鑰：安裝後首次使用需在擴充套件彈出視窗設定您的Gemini API金鑰
- 分析單封郵件：
- 開啟Gmail或Outlook中的任一封郵件
- 在郵件工具列中點擊新增的"分析"按鈕
- 等待分析完成，結果將顯示在郵件上方
- 批次分析：
- 在郵件列表中選取多封郵件
- 點擊工具列的"批次分析"按鈕
- 分析結果將以標籤或圖示形式顯示在郵件列表中
- 情緒分析：顯示郵件的情緒傾向（正面、負面、中性等）及信心分數
- 內容類型：標示郵件為商業、個人、行銷或通知等類型
- 郵件目的：識別郵件的主要目的（問候、請求、通知等）
- 摘要：由AI自動生成的郵件內容簡短摘要
在擴充套件彈出視窗中，您可以：
- 切換自動分析功能
- 調整分析顯示方式（側邊欄、嵌入式、簡潔模式等）
- 設定通知規則（如當收到緊急或負面情緒郵件時通知）
- 切換語言（繁體中文或英文）
- 匯入/匯出設定
- 前端：HTML, CSS, JavaScript
- API整合：Google Gemini API
- 郵件整合：Gmail和Outlook網頁版DOM操作
- 數據處理：客戶端郵件解析與淨化
- 安全性：客戶端加密，無伺服器儲存郵件內容
本擴充套件使用Google的Gemini API進行郵件分析，主要流程：
- 郵件內容經過前處理，移除不必要的HTML和引用內容
- 構建結構化prompt，包含指示分析情緒、內容類型和目的
- 呼叫Gemini API並獲取JSON格式的分析結果
- 解析結果並以視覺化方式呈現
擴充套件採用專門的郵件解析算法：
- HTML標籤移除
- 引用內容識別與過濾
- 簽名檔偵測與移除
- 郵件主體提取
- 本地處理：郵件內容僅在本地瀏覽器中處理，不上傳至第三方伺服器
- API通訊：僅發送必要的郵件內容至Gemini API進行分析
- 無數據儲存：不永久儲存任何郵件內容或分析結果
- 匿名分析：若有功能使用統計，僅收集匿名使用數據，不包含郵件內容
- API金鑰儲存於瀏覽器的安全存儲中（chrome.storage.local）
- 建議使用者設定適當的API使用限制
擴充套件需要以下權限：
- storage：儲存使用者設定和API金鑰
- activeTab：讀取當前開啟的郵件內容
- cookies：用於識別使用者和保持登入狀態
- notifications：顯示分析結果通知
- 特定網站權限：只能在Gmail和Outlook相關網站運作
-
複製倉庫
git clone [倉庫URL] -
安裝依賴
cd mail-sentiment-AI-plugin npm install -
啟動開發環境
npm run dev
- 修改內容腳本：調整
content-scripts資料夾中的檔案以更改郵件界面整合 - 更新API整合：修改
lib/gemini-api.js以調整AI分析邏輯 - 自訂UI：編輯
popup資料夾中的檔案以更改彈出視窗界面
npm run build
建置後的檔案將位於dist資料夾，可用於發布。
Q: 擴充套件支援哪些瀏覽器？ A: 支援Chrome、Edge、Firefox和Safari等主流瀏覽器。
Q: 我需要付費使用此擴充套件嗎？ A: 擴充套件本身免費，但需要Gemini API金鑰，Google提供一定額度的免費使用量。
Q: 我的郵件內容會上傳到其他伺服器嗎？ A: 僅會將郵件內容發送到Google的Gemini API進行分析，不會儲存或發送到其他地方。
Q: 如何取得Gemini API金鑰？ A: 訪問Google AI Studio註冊並取得API金鑰。
Q: 擴充套件支援哪些語言的郵件分析？ A: 當前主要支援繁體中文和英文郵件分析。
- 初始版本發布
- Gmail和Outlook網頁版支援（Outlook網頁還沒測試...）
- 情緒、內容類型和目的分析
- 繁體中文和英文界面
本專案採用 Apache 授權 2.0。
開發者: [CT Yeh, jenda.yeh@gmail.com]