Gemini Web Translator

一個強大且靈活的 Chrome 擴充功能，利用 Google Gemini AI 的強大能力，為您提供即時的網頁翻譯、摘要與內容分析服務。

✨ 核心功能 (Features)

1. 🚀 智慧內容識別 (Smart Context)

不再需要手動反白選取文字！

• 有選取時：直接處理您反白的文字。
• 沒選取時：在任何段落、文章或連結上按右鍵，系統會自動智慧抓取該區塊的完整內容進行分析。
• 連結處理：即使在連結上按右鍵，也會優先提取其周圍的文本內容，確保 AI 能讀取到實際資訊，而不是僅僅傳送一個網址。

2. 🎨 無限自訂選單 (Custom Prompts)

打造您專屬的 AI 助手！

• 自由新增：在設定頁面中新增任意數量的自訂選單（例如：「解釋程式碼」、「修飾語氣」、「提取關鍵字」）。
• 靈活配置：為每個選單設定專屬的 前綴 (Prefix) 與 後綴 (Suffix) 指令。
• 即時生效：設定完成後，右鍵選單立即更新，無需重啟。

3. 💾 設定管理

• 匯出設定：將您精心設計的 Prompt 備份為 JSON 檔案。
• 匯入設定：一鍵還原或分享您的設定檔給朋友。
• 拖曳排序：在設定頁面中自由調整選單順序，將常用的功能排在最前面。

---

🛠 安裝說明 (Installation)

1. 下載或 Clone 此專案到本地目錄。
2. 開啟 Chrome 瀏覽器，進入擴充功能管理頁面 (chrome://extensions/)。
3. 開啟右上角的 "開發人員模式" (Developer mode)。
4. 點擊左上角的 "載入未封裝項目" (Load unpacked)。
5. 選擇本專案的資料夾即可完成安裝。

---

📖 使用指南 (How to Use)

基本操作

1. 翻譯/摘要：

   • 選取網頁上的文字（或直接在文章段落上按右鍵）。
   • 選擇 Gemini Web Translator > Send to Gemini Translate... (翻譯) 或 Summarize with Gemini... (摘要)。
   • 擴充功能會自動開啟 Gemini 網頁並貼上您的內容與指令。

2. 全頁翻譯：

   • 在網頁空白處按右鍵，選擇 Translate Page... 即可抓取整頁內容進行翻譯。

自訂選單設定

1. 點擊瀏覽器工具列上的 Gemini Web Translator 圖示 開啟設定頁面。
2. 在「自訂選單」區塊點擊 "+ 新增選單"。
3. 輸入選單名稱（顯示在右鍵選單上），以及您希望 AI 執行的指令前綴/後綴。
   • 範例前綴：請幫我分析這段程式碼的邏輯：
   • 範例後綴：並指出可以優化的地方。
4. 完成後，右鍵選單就會出現您剛剛新增的功能！

備份與還原

• 在設定頁面點擊 "匯出" 按鈕，即可下載目前的選單設定檔 (.json)。
• 點擊 "匯入" 按鈕並選擇設定檔，即可還原所有自訂選單。

---

🤖 技術機制 (Under the Hood)

本擴充功能採用了先進的 DOM 遍歷演算法來實現「智慧區塊抓取」：

• 當未選取文字時，系統會從點擊的元素開始向上遍歷 DOM 樹。
• 智慧評分系統會根據 HTML 標籤 (<article>, <p>, <div>)、類別名稱與內容結構進行權重計算。
• 自動過濾廣告、導航列與側邊欄等干擾元素，確保送給 Gemini 的是乾淨、高品質的內容。

---

License

MIT License