Spaces:
Running
Running
zhengyi Copilot commited on
Commit ·
f625cb5
1
Parent(s): 0fcc913
docs: 新增 HF Spaces 配置和完整 README
Browse files- 新增 README.md 含 HF Spaces 前置配置 (YAML front matter)
- 記錄應用功能、用法和技術架構
- 包含深色模式使用指南連結
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
README.md
ADDED
|
@@ -0,0 +1,123 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
title: AI 股票分析師
|
| 3 |
+
emoji: 📈
|
| 4 |
+
colorFrom: blue
|
| 5 |
+
colorTo: green
|
| 6 |
+
sdk: gradio
|
| 7 |
+
sdk_version: "5.49.1"
|
| 8 |
+
python_version: "3.10"
|
| 9 |
+
app_file: app_batch.py
|
| 10 |
+
pinned: false
|
| 11 |
+
---
|
| 12 |
+
|
| 13 |
+
# 📈 AI 股票分析師
|
| 14 |
+
|
| 15 |
+
使用 AI 和機器學習進行智能股票分析的 Gradio 應用。
|
| 16 |
+
|
| 17 |
+
## ✨ 核心功能
|
| 18 |
+
|
| 19 |
+
- 📊 **完整技術指標**：MA、RSI、MACD、布林通道分析
|
| 20 |
+
- 🧠 **AI 情感分析**：使用 FinBERT 模型分析市場情緒
|
| 21 |
+
- 🎯 **機率預測**：提供上漲/下跌/盤整機率百分比
|
| 22 |
+
- 📈 **智能建議**：根據機率給出個性化投資策略
|
| 23 |
+
- 🖼️ **互動圖表**：動態視覺化技術指標走勢
|
| 24 |
+
- 📁 **批次分析**：一次分析多支股票並匯出 CSV 報告
|
| 25 |
+
- 🌙 **深色模式**：支援亮色和深色主題切換，保護眼睛
|
| 26 |
+
|
| 27 |
+
## 🚀 快速開始
|
| 28 |
+
|
| 29 |
+
### 本地執行
|
| 30 |
+
|
| 31 |
+
```bash
|
| 32 |
+
# 安裝依賴
|
| 33 |
+
pip install -r requirements.txt
|
| 34 |
+
|
| 35 |
+
# 執行批次分析版本（推薦）
|
| 36 |
+
python app_batch.py
|
| 37 |
+
|
| 38 |
+
# 或執行單股分析版本
|
| 39 |
+
python app.py
|
| 40 |
+
```
|
| 41 |
+
|
| 42 |
+
應用將在 http://localhost:7860 啟動。
|
| 43 |
+
|
| 44 |
+
### Hugging Face Spaces
|
| 45 |
+
|
| 46 |
+
直接訪問：[AI 股票分析師 Space](https://huggingface.co/spaces/54justin/StockRecommander)
|
| 47 |
+
|
| 48 |
+
## 📋 使用方法
|
| 49 |
+
|
| 50 |
+
### 單支股票分析
|
| 51 |
+
1. 在 "Single Stock Analysis" 標籤中輸入股票代碼（如 AAPL、TSLA、0050.TW）
|
| 52 |
+
2. 選擇分析時期（1-12 個月）
|
| 53 |
+
3. 點擊 "分析" 按鈕
|
| 54 |
+
4. 查看技術指標、情感分析和預測結果
|
| 55 |
+
|
| 56 |
+
### 批次股票分析
|
| 57 |
+
1. 在 "Batch Stock Analysis" 標籤中輸入多個股票代碼
|
| 58 |
+
- 方式 1：文字框逗號分隔（如 `AAPL,MSFT,GOOGL`）
|
| 59 |
+
- 方式 2：上傳 Excel 檔案
|
| 60 |
+
2. 點擊 "分析" 按鈕
|
| 61 |
+
3. 下載 CSV 報告
|
| 62 |
+
|
| 63 |
+
## 🌙 深色模式
|
| 64 |
+
|
| 65 |
+
點擊標題欄右側的 **🌙 深色模式** 按鈕切換主題。
|
| 66 |
+
|
| 67 |
+
**功能特性**：
|
| 68 |
+
- ✅ 立即切換，無需重新加載
|
| 69 |
+
- ✅ 主題偏好自動儲存
|
| 70 |
+
- ✅ 支援系統深色模式偵測
|
| 71 |
+
- ✅ WCAG AA 無障礙標準
|
| 72 |
+
|
| 73 |
+
詳見 [DARK_MODE_GUIDE.md](DARK_MODE_GUIDE.md)。
|
| 74 |
+
|
| 75 |
+
## 🏗️ 技術架構
|
| 76 |
+
|
| 77 |
+
### 後端
|
| 78 |
+
- **Python 3.10+**
|
| 79 |
+
- **Gradio 5.x**：Web 框架
|
| 80 |
+
- **yfinance**：股票數據
|
| 81 |
+
- **pandas / numpy**：數據處理
|
| 82 |
+
- **scikit-learn**：機器學習
|
| 83 |
+
|
| 84 |
+
### AI 模型
|
| 85 |
+
- **FinBERT**：財務情感分析
|
| 86 |
+
- **BART**：文本摘要
|
| 87 |
+
- **PyTorch**：深度學習支援
|
| 88 |
+
|
| 89 |
+
### 前端
|
| 90 |
+
- **Gradio UI**：互動式介面
|
| 91 |
+
- **Plotly**：互動圖表
|
| 92 |
+
- **CSS 變數**：深色模式實現
|
| 93 |
+
- **JavaScript**：主題管理
|
| 94 |
+
|
| 95 |
+
## 📦 依賴清單
|
| 96 |
+
|
| 97 |
+
主要依賴（詳見 `requirements.txt`）：
|
| 98 |
+
- gradio>=5.0.0
|
| 99 |
+
- yfinance>=0.2.18
|
| 100 |
+
- pandas>=1.5.0
|
| 101 |
+
- numpy>=1.21.0
|
| 102 |
+
- plotly>=5.0.0
|
| 103 |
+
- transformers>=4.21.0
|
| 104 |
+
- torch>=2.0.0
|
| 105 |
+
- scikit-learn>=1.1.0
|
| 106 |
+
|
| 107 |
+
## 🤝 貢獻
|
| 108 |
+
|
| 109 |
+
歡迎提交 Issue 和 Pull Request！
|
| 110 |
+
|
| 111 |
+
## 📄 授權
|
| 112 |
+
|
| 113 |
+
本項目遵循 MIT 授權。
|
| 114 |
+
|
| 115 |
+
## 📞 聯絡方式
|
| 116 |
+
|
| 117 |
+
- 📧 Email: zhengyi@cht.com.tw
|
| 118 |
+
- 🐙 GitHub: [StockRecommender](https://github.com/yourusername/StockRecommender)
|
| 119 |
+
|
| 120 |
+
---
|
| 121 |
+
|
| 122 |
+
**更新日期**：2026-03-10
|
| 123 |
+
**版本**：1.0.0 (深色模式功能發布)
|