🎓 DoraAImon 智慧助教

DoraAImon 是一個基於 Gradio 與 Google Gemini 2.5 Flash API 開發的智慧學習教練應用程式。它融合了脫口秀天后 Oprah Winfrey 溫暖激勵但精煉權威的對話風格，能快速解析您上傳的學術檔案並立即給出最高效率的知識回饋與讀書規劃。

🌟 核心特色 (Features)

• 📚 多格式文檔解析：支援上傳 .pdf, .docx, .txt, .md 格式的筆記與考題文件，並自動轉換為 AI 參考上下文。
• 🔖 主題式書籤管理：將上傳的多份文件分門別類存入書籤，讓您可以一鍵切換上下文，輕鬆管理不同學科或專案的知識庫。
• 👨‍🏫 高效極簡版 Oprah 人設：助教化身為一隻名為「哆啦AI夢」的無毛機器貓，移除多餘的 AI 廢話與閒聊，直接提供最犀利、最具啟發性的知識指導。
• 💾 動態匯出對話紀錄：一鍵將精彩的對答摘要匯出為 Markdown 檔案。系統會自動利用 AI 幫您的對話進行重點命名，並賦予專屬的時間戳記，完美保留學習筆記。
• 🛡️ 內建斷線重試機制：自帶自動重試策略 (Auto-Retry)，有效克服熱門模型尖峰時段的高負載斷線問題 (503 Unavailable)。

🚀 快速開始 (Quick Start)

1. 安裝套件

請確保您的環境已經安裝 Python (建議 >= 3.10)，然後執行：

pip install -r requirements.txt

2. 環境變數設定

請在專案根目錄建立一個 .env 檔案，並填入您的 Google API Key：

GOOGLE_API_KEY=您的_GEMINI_API_KEY_放在這裡

注意：.env 已經在 .gitignore 排除追蹤名單中，請絕對不要將含有 API Key 的檔案上傳至任何公開平台！

3. 一鍵啟動

我們準備了快速啟動腳本。只要雙擊桌面上的 start.bat，系統就會在背景自動載入伺服器並且為您開啟瀏覽器進入互動網頁。 或者，您也可以直接從終端機執行：

python app.py

🛠️ 技術庫 (Tech Stack)

• Gradio 6.0+：用於快速搭建穩定優美的聊天室與操作介面 (UI)
• Google GenAI SDK：串接強大的 gemini-2.5-flash 大語言模型
• PyPDF2 / python-docx：負責擷取外部文本的底層解析