背多分 (Vocab Master)

這是一個功能強大的個人單字學習系統，結合了 AI 輔助生成與智慧複習功能，幫助您更有效率地累積詞彙量。

✨ 主要功能

📚 單字管理

• 新增單字：手動輸入單字、定義與例句。
• 批量新增：支援一次輸入多個單字（格式：單字 | 定義 | 例句）。
• AI 智慧生成：只需輸入單字列表，AI 自動幫您生成中文定義與例句（需設定 OpenRouter API Key）。
• 單字集管理：可建立不同主題的單字集（如：多益、托福、日常會話），方便分類管理。

🧠 測驗模式

• 學習模式：無限刷題，適合零碎時間練習。
• 考試模式：50 題計分測驗，模擬真實考試壓力。
• 多種題型：
  • 標準模式：看英文單字選中文定義。
  • 克漏字模式 (Cloze)：看例句填空，選擇正確的單字（答題後顯示正確定義）。

📉 錯題追蹤系統

• 自動記錄：測驗中答錯的單字會自動加入「錯題本」。
• 錯題複習：可選擇專門練習錯題本中的單字。
• AI 錯誤分析：考試結束後，AI 可針對您的錯題提供詳細分析與學習建議。
• 一鍵清空：當您掌握了所有錯題後，可一鍵清空錯題本。

🚀 安裝與執行

前置需求

• Python 3.8+
• pip

1. 安裝依賴套件

pip install -r requirements.txt

2. 啟動應用程式

python main.py

3. 開啟瀏覽器

應用程式預設執行於 http://localhost:5000。

⚙️ 設定說明

為了使用 AI 自動生成單字與錯誤分析功能，請至網頁右上角的「設定」頁面配置：

1. OpenRouter API Key：輸入您的 OpenRouter API 金鑰。
2. AI Model：設定欲使用的模型 ID（預設為 google/gemini-2.0-flash-lite-preview-02-05:free）。

🛠️ 技術堆疊

• Backend: Python, Flask, SQLite
• Frontend: HTML5, CSS3, JavaScript (Vanilla)
• AI Integration: OpenRouter API

📝 注意事項

• 資料庫檔案為 vocab.db，請定期備份以免資料遺失。
• 本專案為本地端應用程式，資料皆儲存於本地。