Threads AI 智慧回覆助手 (開源版)

一個注重隱私的 Chrome 擴充功能，使用 Google Gemini API 為 Threads 平台生成智慧回覆。包含完整的批次回覆功能和隨機風格選擇。

🌟 特色功能

• 隱私優先: 完全在本地運行，不會收集或傳輸任何個人資料
• 自帶 API Key: 使用您自己的 Google Gemini API Key，確保數據安全
• 多種風格: 提供 7 種不同的回覆風格（附和贊同、幽默風趣、提出疑問等）
• 批次回覆: 可一次對頁面上多個貼文進行回覆
• 隨機風格: 支援隨機選擇風格，讓回覆更自然多樣
• 自動開啟回覆: 智能打開 Threads 回覆輸入框
• 無縫整合: 在 Threads 頁面自然融入，一鍵生成回覆
• 即時生成: 快速生成相關且有意義的回覆內容

🚀 安裝步驟

1. 建置專案

# 安裝依賴
npm install

# 建置專案
npm run build

2. 載入到 Chrome

1. 開啟 Chrome 瀏覽器
2. 前往 chrome://extensions/
3. 開啟右上角的「開發人員模式」
4. 點擊「載入未封裝項目」
5. 選擇專案的 dist 資料夾

3. 設定 API Key

1. 安裝完成後，點擊工具列中的 ✨ 圖示
2. 點擊「前往設定」
3. 點擊「獲取 API Key」前往 Google AI Studio
4. 建立您的免費 Gemini API Key
5. 回到設定頁面，貼上您的 API Key 並儲存

📱 使用方法

單一回覆

1. 前往 Threads
2. 找到您想回覆的貼文
3. 點擊貼文下方的 ✨ 按鈕
4. 從彈出選單中選擇您偏好的回覆風格
5. AI 會自動生成回覆並填入留言框
6. 您可以直接發布或稍作修改後發布

批次回覆

1. 在任一貼文的 ✨ 按鈕彈出選單中點擊「批次回覆」
2. 選擇要回覆的貼文（可複選）
3. 選擇回覆風格：
   • 固定風格：所有回覆使用同一風格
   • 隨機風格：每個回覆隨機選擇風格，讓回覆更自然
4. 點擊「開始批次回覆」
5. 系統會自動逐一處理每個貼文，生成並填入回覆

🎨 回覆風格

• 附和贊同: 表達支持和認同
• 幽默風趣: 輕鬆幽默的回應
• 提出疑問: 好奇詢問更多細節
• 專業分析: 提供專業見解
• 暖心鼓勵: 給予溫暖的鼓勵
• 分享經驗: 分享相關的個人經驗
• 深度思考: 提供深入的思考和見解

🛡️ 隱私保障

• ✅ 完全本地運行: 不設有任何開發者伺服器
• ✅ API Key 安全: 僅儲存在您的瀏覽器本地
• ✅ 數據直傳: 所有請求直接發送到 Google 伺服器
• ✅ 零追蹤: 不收集任何使用者資料或分析

🔧 技術架構

• 前端: Svelte + TypeScript + Tailwind CSS
• 打包工具: Vite
• AI 模型: Google Gemini API
• 儲存: Chrome Extension Storage API

📋 系統需求

• Chrome 瀏覽器 (最新版本)
• Google Gemini API Key (免費)
• 網路連接

🤝 貢獻

歡迎提交 Issue 和 Pull Request！

📄 授權

MIT License

🆘 疑難排解

API Key 相關問題

• 確保 API Key 正確且有效
• 檢查 Google AI Studio 中的額度限制
• 確認網路連接正常

功能無法正常運作

• 重新載入 Threads 頁面
• 檢查瀏覽器控制台是否有錯誤訊息
• 確認擴充功能已正確安裝並啟用

找不到 ✨ 按鈕

• 確認您在 threads.com 網站上
• 嘗試重新整理頁面
• 檢查擴充功能是否已啟用
• 開啟瀏覽器開發者工具 (F12) 查看 Console 是否有「🤖 Threads AI Assistant 已載入」訊息
• 如果有載入訊息但仍看不到按鈕，請查看 Console 中的貼文偵測訊息

---

🎉 感謝使用 Threads AI 智慧回覆助手！