快速開始與環境設定

📋 環境需求

系統需求

• 作業系統：Windows / macOS / Linux
• Python 版本：3.8 或以上
• 硬碟空間：至少 500 MB
• 記憶體：建議 4 GB 以上
• 網路連線：必須（用於 API 呼叫）

瀏覽器支援

• ✅ Google Chrome 90+
• ✅ Microsoft Edge 90+
• ✅ Mozilla Firefox 88+
• ✅ Safari 14+

📦 安裝步驟

1. 下載專案檔案
   從 GitHub 下載或 Clone 專案到本地資料夾
2. 建立虛擬環境（建議）

   python -m venv venv
   venv\Scripts\activate  # Windows
   source venv/bin/activate  # macOS/Linux

3. 安裝依賴套件

   pip install -r requirements.txt

4. 啟動應用程式

   python app.py

5. 開啟瀏覽器
   前往 http://localhost:5000

📚 所需套件

Flask==3.0.0
Flask-CORS==4.0.0
pandas==2.1.4
requests==2.31.0
feedparser
FinMind
ta==0.11.0
Werkzeug==3.0.1

🔑 API 金鑰申請

🚀 啟動系統

執行 python app.py 後，您會看到：

🚀 AI 智慧助理啟動中...
📱 請開啟瀏覽器前往: http://localhost:5000
⚙️  設定頁面: http://localhost:5000/#settings

⚙️ 系統設定

1. 開啟瀏覽器前往 http://localhost:5000
2. 點擊右上角「⚙️ 設定」圖示
3. 選擇 AI 提供者（OpenAI 或 Google）
4. 填入對應的 API 金鑰
5. 點擊「測試 API 連線」確認設定正確
6. 點擊「儲存設定」

🧪 功能測試

測試 AI 聊天

輸入「你好，請介紹一下你自己」驗證 AI 連線

測試智慧記帳

輸入 記帳：午餐便當 85 元，AI 會自動解析並儲存

測試行程管理

輸入 行程：明天下午 3 點開會，自動新增到行事曆

📌 Part 2 小結