charieswei
/
TradingAgents
mirror of https://github.com/TauricResearch/TradingAgents.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

This commit is contained in:
MarkLo 2025-12-13 16:48:12 +08:00
parent bddcca3ebb
commit 0bddce0cdc
3 changed files with 219 additions and 599 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

792
README.md
View File

@ -1,8 +1,8 @@
# TradingAgentsX - 多代理交易分析系統
# TradingAgentsX - 多代理智能交易分析系統
<div align="center">
**基於 LangGraph 的智能股票交易分析平台，結合多個 AI 代理進行協作決策**
**基於 LangGraph 的 AI 股票交易分析平台，結合多個專業 AI 代理進行協作決策**
[![GitHub](https://img.shields.io/badge/GitHub-MarkLo127/TradingAgentsX-blue?logo=github)](https://github.com/MarkLo127/TradingAgentsX)
[![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python)](https://www.python.org/)
@ -14,228 +14,121 @@
</div>
---
## 📖 簡介
**TradingAgentsX** 是一個先進的多代理 AI 交易分析系統，模擬真實世界的交易公司運作模式。透過 LangGraph 編排多個專業化的 AI 代理（分析師、研究員、交易員、風險管理者），系統能夠從不同角度分析股票市場，並通過結構化的辯論與協作流程產生高質量的交易決策。
> 💡 **致敬原作**: 本專案基於 [TauricResearch/TradingAgents](https://github.com/TauricResearch/TradingAgents) 進行改進和擴展，加入了完整的 Web 前端介面、RESTful API、Docker 部署支援等功能。並且支援台股上市櫃資料，感謝原作者的卓越工作和開源貢獻！
> 💡 **致敬原作**: 本專案基於 [TauricResearch/TradingAgents](https://github.com/TauricResearch/TradingAgents) 進行改進和擴展。
### 🎯 核心特色
- 🤖 **多代理協作架構** - 專業化的 AI 代理團隊協同工作
- 🌐 **多模型靈活支援** - 支援 OpenAI、Anthropic、Gemini、Grok、DeepSeek、Qwen 等多家 LLM 提供商
- 🔧 **自訂端點配置** - 完整支援自訂 API 端點，可連接任何 OpenAI 兼容的服務
- 📊 **全方位市場分析** - 完整支援**美股**與**台股**(FinMind)技術面、基本面、情緒面、新聞面分析
- 🔄 **結構化決策流程** - 透過看漲/看跌辯論機制減少偏見
- 🧠 **長期記憶系統** - 使用 ChromaDB 向量數據庫儲存歷史決策
- 🎨 **現代化 Web 介面** - 基於 Next.js 16 的響應式 UI
- 🔌 **RESTful API** - 完整的後端 API 支援
- 🐳 **一鍵部署** - 支援 Docker Compose 部署
- 🔑 **BYOK (Bring Your Own Key)** - 使用者自帶 API 金鑰，保障隱私與成本控制
- 💰 **JSON 轉 Toon 優化** - 將 JSON 數據轉換為 Toon 格式，大幅降低 API 調用開支 [TOON](https://github.com/toon-format/toon)
- ⬇️ **一鍵下載報告** - 支援將分析結果匯出為 JSON 檔案，方便保存與分享
---
## 🤖 LLM 模型支援
TradingAgentsX 支援業界領先的多家 LLM 提供商，並為每個模型配置**獨立的 API Key 和 Base URL**，實現最大靈活性。
<div align="center">
<p>
<img src="llm_logo/openai.svg" alt="OpenAI" height="50" style="margin: 10px;"/>
<img src="llm_logo/claude-color.svg" alt="Anthropic Claude" height="50" style="margin: 10px;"/>
<img src="llm_logo/gemini-color.svg" alt="Google Gemini" height="50" style="margin: 10px;"/>
<img src="llm_logo/grok.svg" alt="xAI Grok" height="50" style="margin: 10px;"/>
<img src="llm_logo/deepseek-color.svg" alt="DeepSeek" height="50" style="margin: 10px;"/>
<img src="llm_logo/qwen-color.svg" alt="Alibaba Qwen" height="50" style="margin: 10px;"/>
</p>
</div>
### 📋 支援的 LLM 提供商矩陣
| 提供商 | 支援模型 | Base URL | 是否支援自訂端點 |
| ------------------ | ------------------------------------------------------------------------------------------------ | --------------------------------------------------------- | ---------------- |
| **OpenAI** | GPT-5.1, GPT-5 Mini/Nano, GPT-4.1 Mini/Nano, o4-mini | `https://api.openai.com/v1` | ✅ 是 |
| **Anthropic** | Claude Haiku 4.5, Claude Sonnet 4.5/4.0, Claude 3.5 Haiku, Claude 3 Haiku | `https://api.anthropic.com/v1` | ✅ 是 |
| **Gemini** | Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash Lite, Gemini 2.0 Flash, Gemini 2.0 Flash Lite | `https://generativelanguage.googleapis.com/v1beta/openai` | ✅ 是 |
| **Grok (xAI)** | Grok-4.1 Fast, Grok-4 Fast, Grok-4, Grok-3, Grok-3 Mini | `https://api.x.ai/v1` | ✅ 是 |
| **DeepSeek** | DeepSeek Reasoner, DeepSeek Chat | `https://api.deepseek.com/v1` | ✅ 是 |
| **Qwen (Alibaba)** | Qwen3-Max, Qwen-Plus, Qwen Flash | `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` | ✅ 是 |
| **自訂端點** | 上述列表中的模型 | 使用者自訂 | ✅ 完全支援 |
### 🔧 三層獨立配置
系統支援**三個獨立的 LLM 配置點**，每個都可使用不同的提供商和 API Key：
#### 1️⃣ 快速思維模型 (Quick Thinking)
用於快速分析和即時回應（市場分析師、情緒分析師等）
#### 2️⃣ 深層思維模型 (Deep Thinking)
用於複雜推理和深度分析（研究團隊辯論、風險管理等）
#### 3️⃣ 嵌入模型 (Embedding)
用於向量記憶體系統（ChromaDB 嵌入生成）
**配置示例：**
```yaml
快速思維: OpenAI GPT-5 Mini @ api.openai.com
深層思維: Anthropic Claude Sonnet 4.5 @ api.anthropic.com/v1
嵌入模型: 自訂端點 @ your-custom-endpoint.com
```
### 🌍 自訂端點支援
**完整支援自訂 API 端點**，任何實現 OpenAI Chat Completions API 規範的服務都可以使用：
✅ **支援場景：**
- 私有化部署的 LLM 服務
- 第三方 OpenAI 兼容代理
**配置方式：**
1. 在前端表單的 Base URL 輸入框直接輸入自訂 URL
2. 填入對應的 API Key
3. 系統自動使用您的端點進行推理
| 功能 | 說明 |
|------|------|
| 🤖 **多代理協作架構** | 12 個專業化 AI 代理（分析師、研究員、交易員、風險管理）協同工作 |
| 🌐 **多模型支援** | OpenAI、Anthropic、Gemini、Grok、DeepSeek、Qwen 等 LLM 提供商 |
| 🔒 **Google OAuth 登入** | 雲端同步 API 設定與歷史報告，支援多裝置同步 |
| 📊 **美股與台股支援** | 完整支援美股（Yahoo Finance）與台股（FinMind）資料 |
| 🔑 **BYOK 模式** | 使用者自帶 API 金鑰，前端加密儲存，保障隱私 |
| 🛡️ **安全防護** | Rate Limiting、Security Headers、API Key 遮罩 |
| 📱 **響應式設計** | 支援桌面與手機瀏覽器 |
| 🐳 **Docker 部署** | 一鍵啟動前後端服務 |
---
## 🏗️ 系統架構
TradingAgentsX 採用前後端分離架構，後端使用 FastAPI 提供 RESTful API，前端使用 Next.js 打造現代化的使用者介面。
### 📂 專案結構概覽
```
TradingAgentsX/
├── backend/ # FastAPI 後端服務
│ ├── __main__.py # 後端應用入口
│ ├── requirements.txt # Python 依賴列表
│ └── app/
│ ├── main.py # FastAPI 應用主程式
│ ├── api/ # API 路由層
│ │ ├── routes.py # API 端點定義
│ │ └── dependencies.py # 依賴注入
│ ├── core/ # 核心配置
│ │ ├──config.py # 環境變數與設定
│ │ └── cors.py # CORS 中間件配置
│ ├── models/ # 資料模型
│ │ └── schemas.py # Pydantic 資料結構
│ └── services/ # 業務邏輯層
│ ├── trading_service.py # TradingAgentsX 核心整合
│ └── task_manager.py # 異步任務管理
├── frontend/ # Next.js 前端應用
│ ├── app/ # Next.js App Router
│ │ ├── layout.tsx # 根佈局組件
├── frontend/ # Next.js 16 前端應用
│ ├── app/ # App Router 頁面
│ │ ├── page.tsx # 首頁
│ │ └── analysis/ # 分析功能模組
│ │ ├── page.tsx # 分析配置頁面
│ │ └── results/ # 分析結果展示頁面
│ ├── components/ # React 組件庫
│ │ ├── analysis/ # 分析功能
│ │ ├── history/ # 歷史報告
│ │ ├── auth/ # OAuth 回調
│ │ └── api/ # API 路由（config, auth）
│ ├── components/ # React 組件
│ │ ├── analysis/ # 分析相關組件
│ │ │ ├── AnalysisForm.tsx # 參數配置表單
│ │ │ ├── TradingDecision.tsx # 交易決策卡片
│ │ │ ├── AnalystReport.tsx # 分析師報告展示
│ │ │ └── PriceChart.tsx # 股價圖表組件
│ │ ├── layout/ # 佈局組件
│ │ │ ├── Header.tsx # 頂部導航欄
│ │ │ └── Footer.tsx # 頁腳
│ │ ├── auth/ # 登入按鈕、登入提示
│ │ ├── layout/ # Header、Footer
│ │ ├── settings/ # API 設定對話框
│ │ └── ui/ # shadcn/ui 基礎組件
│ ├── hooks/ # 自定義 React Hooks
│ │ ├── useAnalysis.ts # 分析請求管理
│ │ └── useConfig.ts # 配置資料獲取
│ └── lib/ # 工具函式庫
│ ├── api.ts # API 客戶端封裝
│ ├── types.ts # TypeScript 型別定義
│ └── utils.ts # 通用輔助函式
└── tradingagents/ # 核心 Python 套件
│ ├── contexts/ # React Context（認證狀態）
│ ├── hooks/ # 自定義 Hooks
│ └── lib/ # 工具函式（API、加密、儲存）
│
├── backend/ # FastAPI 後端服務
│ └── app/
│ ├── main.py # 應用入口（中間件、路由）
│ ├── api/ # API 路由
│ │ ├── routes.py # 分析 API
│ │ ├── auth.py # Google OAuth
│ │ └── user.py # 使用者資料同步
│ ├── core/ # 配置、CORS
│ ├── db/ # PostgreSQL 資料庫
│ ├── models/ # Pydantic 模型
│ └── services/ # 業務邏輯
│
└── tradingagents/ # 核心 AI 代理套件
├── agents/ # AI 代理定義
├── dataflows/ # 資料流處理
│ ├── analysts/ # 分析師團隊
│ ├── researchers/ # 研究團隊
│ ├── trader/ # 交易員
│ ├── risk_mgmt/ # 風險管理團隊
│ └── managers/ # 經理決策者
├── dataflows/ # 資料獲取與處理
├── graph/ # LangGraph 工作流
└── default_config.py # 預設配置
```
### 🔧 後端技術棧
---
| 技術 | 用途 | 版本 |
| ----------------- | ---------------------- | -------- |
| **FastAPI** | 現代化異步 Web 框架 | ≥0.104.0 |
| **Pydantic** | 資料驗證與序列化 | ≥2.9.0 |
| **LangGraph** | 多代理工作流編排引擎 | ≥0.4.8 |
| **LangChain** | LLM 應用開發框架 | Latest |
| **ChromaDB** | 向量資料庫（記憶系統） | ≥1.0.12 |
| **yfinance** | 股票市場資料獲取 | ≥0.2.63 |
| **Uvicorn** | ASGI 伺服器 | ≥0.24.0 |
| **python-dotenv** | 環境變數管理 | 1.0.0 |
| **Redis** | 任務隊列與緩存 | Latest |
## 🤖 AI 代理團隊
#### 其他整合
### 分析師團隊 (4 位)
| 代理 | 職責 | 輸出 |
|------|------|------|
| 市場分析師 | 技術分析 | RSI、MACD、布林通道、支撐阻力位 |
| 社群媒體分析師 | 情緒評估 | Reddit/Twitter 情緒指標、投資者信心 |
| 新聞分析師 | 新聞分析 | 最新新聞摘要、事件影響評估 |
| 基本面分析師 | 財務分析 | 財報數據、P/E、P/B、盈利能力 |
- **stockstats**: 技術指標計算
- **feedparser**: RSS 新聞抓取
- **praw**: Reddit 社群情緒分析
- **finnhub-python**: 金融資料 API
- **beautifulsoup4**: 網頁內容解析
### 研究團隊 (3 位)
| 代理 | 職責 |
|------|------|
| 看漲研究員 | 多頭觀點論證、上漲催化劑分析 |
| 看跌研究員 | 空頭觀點論證、下跌風險警告 |
| 研究經理 | 綜合看漲與看跌觀點的決策 |
### 🎨 前端技術棧
| 技術 | 用途 | 版本 |
| ------------------- | -------------------------- | ------ |
| **Next.js** | React 全端框架 | 16.x |
| **TypeScript** | 靜態型別檢查 | Latest |
| **Tailwind CSS** | 實用優先的 CSS 框架 | Latest |
| **shadcn/ui** | 可高度客製化的 UI 組件庫 | Latest |
| **React Hook Form** | 高效能表單管理 | Latest |
| **Zod** | TypeScript 優先的結構驗證 | Latest |
| **Recharts** | 資料視覺化圖表庫 | Latest |
| **Axios** | Promise 基礎的 HTTP 客戶端 | Latest |
| **react-markdown** | Markdown 內容渲染 | Latest |
### 交易與風險團隊 (5 位)
| 代理 | 職責 |
|------|------|
| 交易員 | 整合所有報告，制定交易計劃 |
| 激進分析師 | 高風險高回報策略分析 |
| 保守分析師 | 穩健保守策略與風險控制 |
| 中立分析師 | 中立平衡策略評估 |
| 風險經理 | 風險管理綜合決策與最終建議 |
---
## 🚀 快速開始
### 📋 前置要求
### 前置要求
在開始之前，請確保您的系統已安裝以下軟體：
- **Python** 3.10+
- **Node.js** 18.x+
- **pnpm** 或 npm
- **Python** 3.10 或更高版本
- **Node.js** 18.x 或更高版本
- **pnpm** 最新版本（推薦）或 npm
- **Conda** (可選，但強烈推薦用於 Python 環境管理)
- **Git** 用於克隆專案
### 必要的 API 金鑰
#### 必要的 API 金鑰
| API | 用途 | 申請網址 |
|-----|------|----------|
| OpenAI | GPT 模型 | https://platform.openai.com/api-keys |
| Alpha Vantage（選填） | 美股基本面資料 | https://www.alphavantage.co/support/#api-key |
| FinMind（選填） | 台股資料 | https://finmindtrade.com/ |
根據您選擇的 LLM 提供商，準備相應的 API 金鑰：
- **OpenAI API Key** - GPT 系列模型
- 申請網址: https://platform.openai.com/api-keys
- **Anthropic API Key** - Claude 系列模型
- 申請網址: https://console.anthropic.com
- **Grok API Key** - Grok 系列模型
- 申請網址: https://console.x.ai
- **DeepSeek API Key** - DeepSeek 系列模型
- 申請網址: https://platform.deepseek.com
- **Qwen API Key** - Qwen 系列模型
- 申請網址: https://www.alibabacloud.com
- **Alpha Vantage API Key** (必需) - 美股基本面資料
- 申請網址: https://www.alphavantage.co/support/#api-key
- **FinMind API Key** (選填) - 台股上市櫃資料
- 申請網址: https://finmindtrade.com/
> 💡 **提示**: 本系統採用 BYOK (Bring Your Own Key) 模式，您可以在前端介面直接輸入 API 金鑰，無需設定環境變數（適合快速測試）。
### 📥 安裝步驟
### 安裝步驟
#### 1️⃣ 克隆專案
@ -246,449 +139,175 @@ cd TradingAgentsX
#### 2️⃣ 後端設置
##### 2.1 創建 Python 虛擬環境
**使用 Conda (推薦)**
```bash
# 創建虛擬環境
conda create -n tradingagents python=3.13
conda activate tradingagents
```
**或使用 venv**
```bash
python3 -m venv tradingagents
source tradingagents/bin/activate # macOS/Linux
# 或
tradingagents\Scripts\activate # Windows
```
##### 2.2 安裝 Python 依賴
```bash
# 安裝 TradingAgentsX 核心套件
# 安裝依賴
pip install -e .
# 安裝後端 API 依賴
pip install -r backend/requirements.txt
```
##### 2.3 配置環境變數（可選）
複製範例環境變數檔案並編輯：
```bash
# 配置環境變數
cp .env.example .env
```
# 編輯 .env 填入 API 金鑰
編輯 `.env` 檔案，填入您的 API 金鑰：
```bash
# ============ LLM API 金鑰配置 ============
# OpenAI (可選 - 可在前端直接輸入)
OPENAI_API_KEY=sk-your-openai-api-key-here
# Anthropic Claude (可選)
ANTHROPIC_API_KEY=sk-ant-your-claude-key
# Grok / xAI (可選)
XAI_API_KEY=your-grok-key
# DeepSeek (可選)
DEEPSEEK_API_KEY=your-deepseek-key
# Qwen / Alibaba Cloud (可選)
DASHSCOPE_API_KEY=your-qwen-key
# Alpha Vantage (建議配置)
ALPHA_VANTAGE_API_KEY=
# FinMind (選填 - 用於台股)
FINMIND_API_KEY=
# ============ 後端服務配置 ============
BACKEND_HOST=0.0.0.0
BACKEND_PORT=8000
# ============ CORS 配置 ============
CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000
# ============ 資料儲存配置 ============
TRADINGAGENTS_RESULTS_DIR=./results
```
> 📝 **注意**: 環境變數中的 API Key 為可選配置。您可以在前端表單中直接輸入，系統會優先使用前端輸入的 Key。
##### 2.4 啟動後端服務
```bash
# 從專案根目錄執行（開發模式，啟用 hot reload）
# 啟動後端
python -m backend
# 生產模式（停用 hot reload，避免任務丟失）
python -m backend --reload false
```
✅ 後端服務成功啟動後，您可以訪問：
- **應用根目錄**: http://localhost:8000
- **API 互動式文檔 (Swagger UI)**: http://localhost:8000/docs
- **API 文檔 (ReDoc)**: http://localhost:8000/redoc
- **健康檢查端點**: http://localhost:8000/api/health
後端服務：
- API: http://localhost:8000
- Swagger 文檔: http://localhost:8000/docs
#### 3️⃣ 前端設置
##### 3.1 安裝前端依賴
```bash
# 使用 pnpm (推薦)
# 安裝依賴
pnpm -C frontend install
# 或使用 npm
npm --prefix frontend install
```
##### 3.2 配置前端環境變數 (可選)
如果您需要自訂 API 端點，可以建立 `frontend/.env.local`：
```bash
NEXT_PUBLIC_API_URL=http://localhost:8000
```
> 💡 預設情況下，前端會自動連接到 `http://localhost:8000`
##### 3.3 啟動前端開發伺服器
```bash
# 使用 pnpm (推薦)
# 啟動開發伺服器
pnpm -C frontend dev
# 或使用 npm
npm --prefix frontend run dev
```
✅ 前端應用成功啟動後，訪問：
- **應用首頁**: http://localhost:3000
前端應用: http://localhost:3000
---
## 🐳 部署方案
### Docker Compose 本地部署
最簡單的部署方式，一鍵啟動前後端服務：
**前置要求：**
- Docker Engine 20.10+
- Docker Compose V2
**部署步驟：**
## 🐳 Docker 部署
```bash
# 1. 確保 .env 文件已配置（至少包含 Alpha Vantage API Key）
# 配置環境變數
cp .env.example .env
# 編輯 .env，填入必要的 API 金鑰
# 2. 啟動所有服務（首次執行會自動構建映像）
# 啟動服務
docker compose up -d --build
# 3. 查看服務運行狀態
docker compose ps
# 4. 查看即時日誌
# 查看日誌
docker compose logs -f
# 5. 查看特定服務日誌
docker compose logs -f backend
docker compose logs -f frontend
# 停止服務
docker compose down
# 停止服務並清除資料卷
docker compose down -v
```
**Docker Compose 配置說明**：
服務端口：
- 後端: http://localhost:8000
- 前端: http://localhost:3000
- 後端服務運行於: `http://localhost:8000`
- 前端服務運行於: `http://localhost:3000`
- 分析結果會持久化儲存在 `./results` 目錄
- 環境變數從 `.env` 文件自動載入
---
## 🔒 安全特性
### 本地開發 vs 生產環境
| 功能 | 本地開發 (localhost) | 生產環境 (Railway 等) |
|------|----------------------|----------------------|
| Google 登入 | 選用（可不設定） | 建議啟用 |
| 資料自動清除 | ❌ 不會清除 | ✅ 未登入時離開會清除 |
| PostgreSQL | 選用 | 必需 |
| API 設定儲存 | 永久保留 | 登入後雲端同步 |
| 歷史報告儲存 | 永久保留 | 登入後雲端同步 |
### 前端安全
- **API Key 加密儲存** - 使用 AES-GCM 加密 localStorage 中的敏感資料
- **自動清除（僅生產環境）** - 未登入用戶離開頁面時自動清除本地資料
- **Safari 觸控優化** - 修復 iOS Safari 的觸控事件問題
### 後端安全
- **Rate Limiting** - 每分鐘 30 次請求限制
- **Security Headers** - X-Content-Type-Options、X-Frame-Options 等
- **敏感資料遮罩** - API Key 在日誌中自動遮罩
- **CORS 配置** - 限制跨域請求來源
### 雲端同步
- **Google OAuth 2.0** - 安全的第三方登入
- **JWT Token** - 無狀態認證
- **雲端備份** - API 設定與歷史報告同步到伺服器
---
## 📱 使用指南
### 基本工作流程
### 1. 配置 API 金鑰
點擊右上角「設定」按鈕，輸入您的 API 金鑰。
1. **訪問首頁**
### 2. 選擇分析參數
- **市場類型**: 美股 / 台股上市 / 台股上櫃
- **股票代碼**: 如 NVDA、2330
- **分析師團隊**: 選擇需要的分析師
- **研究深度**: 淺層（快速）/ 中等 / 深層（詳細）
- **LLM 模型**: 快速思維模型 + 深層思維模型
- 開啟瀏覽器，訪問 http://localhost:3000
- 查看系統介紹與功能說明
### 3. 執行分析
點擊「執行分析」，等待 1-5 分鐘（依研究深度而定）。
2. **進入分析頁面**
### 4. 查看結果
- **交易決策摘要** - BUY / SELL / HOLD 建議
- **股價走勢圖** - 折線圖 / K 線圖切換
- **12 位代理報告** - 點擊標籤查看詳細分析
- 點擊首頁的「開始分析」按鈕
- 或直接訪問 http://localhost:3000/analysis
3. **配置分析參數**
#### 📊 基本設定
- **選擇分析師團隊**: 勾選您需要的分析師類型
- ✅ 市場分析師 (Market Analyst) - 技術分析與價格走勢
- ✅ 情緒分析師 (Sentiment Analyst) - 社交媒體情緒評估
- ✅ 新聞分析師 (News Analyst) - 新聞事件影響分析
- ✅ 基本面分析師 (Fundamental Analyst) - 財務數據與估值分析
- **輸入股票代碼**: 例如 `NVDA`, `AAPL`, `TSLA`, `GOOGL`
- 支援美股股票代號
- **選擇分析日期**: 選擇要分析的特定日期
- 預設為當前日期
- **設定研究深度**:
- 🟢 **淺層 (Shallow)**: 快速分析，適合即時決策
- 🟡 **中等 (Medium)**: 平衡速度與深度
- 🔴 **深層 (Deep)**: 全面深入分析，耗時較長
#### 🤖 LLM 模型配置
系統提供**三個獨立的 LLM 配置選項**，每個都可使用不同的提供商：
**1. 快速思維模型配置**
- **模型選擇**: 從下拉選單選擇模型（OpenAI, Anthropic, Grok, DeepSeek, Qwen）
- **Base URL**: 直接輸入自訂端點 URL（例如：`https://api.your-custom-endpoint.com/v1`）
- **API Key**: 輸入對應的 API 金鑰
**2. 深層思維模型配置**
- **模型選擇**: 可選擇與快速思維不同的模型
- **Base URL**: 支援不同的端點
- **API Key**: 支援不同的金鑰
**3. 嵌入模型配置**
- **Base URL**: 下拉選擇 OpenAI 或自訂端點
- **API Key**: 若留空則使用環境變數 `OPENAI_API_KEY`
**配置示例：**
```
快速思維模型: gpt-5-mini
快速思維 Base URL: https://api.openai.com/v1
快速思維 API Key: sk-your-openai-key
深層思維模型: claude-sonnet-4-5
深層思維 Base URL: https://api.anthropic.com/v1
深層思維 API Key: sk-ant-your-claude-key
嵌入模型 Base URL: 自訂 → https://api.your-embedding-service.com/v1
嵌入模型 API Key: your-embedding-key
```
> 💡 **靈活性**: 您可以混合使用不同提供商的模型，例如用 OpenAI 做快速分析，用 Claude 做深度推理，用自訂端點做嵌入生成。
#### 🔑 API 金鑰配置
- **Alpha Vantage API Key** (必填): 用於獲取美股基本面數據
- **FinMind API Key** (選填): 用於獲取台股數據
- 如未在環境變數中配置 LLM API Key，需在此填入
4. **執行分析**
- 檢查所有參數無誤後，點擊「執行分析」按鈕
- 系統會顯示載入動畫，處理時間依研究深度而定（1-5 分鐘）
5. **查看分析結果**
- 分析完成後自動跳轉至結果頁面
- 結果包含以下內容：
**📊 交易決策摘要**
- 最終決策: BUY / SELL / HOLD
- 建議倉位大小
- 風險等級評估
- 核心理由總結
**📈 股價走勢圖表**
- 互動式價格圖表（支援折線圖/K 線圖切換）
- 交易量變化
- 關鍵技術指標
**📄 各分析師詳細報告**
系統提供 **12 個專業代理** 的完整分析報告，分為四大團隊：
**分析師團隊 (4)**
- 市場分析師: 技術面分析與趨勢判斷
- 社群媒體分析師: 社群媒體情緒指標
- 新聞分析師: 最新新聞事件影響評估
- 基本面分析師: 財務健康度與估值分析
**研究團隊 (3)**
- 看漲研究員: 多頭觀點論證與上漲催化劑分析
- 看跌研究員: 空頭觀點論證與下跌風險警告
- 研究經理: 綜合看漲與看跌觀點的研究決策
**交易團隊 (1)**
- 交易員: 整合所有報告的交易執行計劃
**風險管理團隊 (4)**
- 激進分析師: 高風險高回報策略分析
- 保守分析師: 穩健保守策略與風險控制
- 中立分析師: 中立平衡策略評估
- 風險經理: 風險管理綜合決策與最終建議
### API 使用範例
如果您想要透過 API 整合 TradingAgentsX，可以參考以下範例：
#### 健康檢查
```bash
curl http://localhost:8000/api/health
```
#### 執行股票分析（使用自訂端點）
```bash
curl -X POST http://localhost:8000/api/analyze \
-H "Content-Type: application/json" \
-d '{
"ticker": "NVDA",
"analysis_date": "2024-01-15",
"research_depth": 2,
"deep_think_llm": "claude-sonnet-4-5",
"quick_think_llm": "gpt-5-mini",
"analysts": ["market", "sentiment", "news", "fundamental"],
"quick_think_base_url": "https://api.openai.com/v1",
"deep_think_base_url": "https://api.anthropic.com/v1",
"embedding_base_url": "https://api.openai.com/v1",
"quick_think_api_key": "sk-your-openai-key",
"deep_think_api_key": "sk-ant-your-claude-key",
"embedding_api_key": "sk-your-embedding-key",
"alpha_vantage_api_key": "your-alpha-vantage-key"
}'
```
#### 獲取股價資料
```bash
curl "http://localhost:8000/api/price-data/NVDA?start_date=2024-01-01&end_date=2024-01-31"
```
完整的 API 文檔請訪問: http://localhost:8000/docs
### 5. 儲存與下載
- **儲存報告** - 保存到本地 / 雲端
- **下載報告** - 匯出為 JSON 檔案
---
## 🧠 核心功能詳解
## 🔌 API 文檔
### 多代理協作系統
TradingAgentsX 模擬真實交易公司的組織架構，每個代理都有其專業職責：
| 代理角色 | 主要職責 | 輸出內容 |
| ---------------- | -------- | ----------------------------------------------------- |
| **市場分析師** | 技術分析 | 技術指標（RSI, MACD, 布林通道）、價格走勢、支撐阻力位 |
| **情緒分析師** | 情緒評估 | Reddit/Twitter 情緒指標、熱度趨勢、投資者信心指數 |
| **新聞分析師** | 新聞分析 | 最新新聞摘要、事件影響評估、市場反應預測 |
| **基本面分析師** | 財務分析 | 財報數據、估值指標（P/E, P/B）、盈利能力評估 |
| **看漲研究員** | 多頭論證 | 看漲理由、上漲催化劑、目標價位 |
| **看跌研究員** | 空頭論證 | 看跌理由、下跌風險、防守策略 |
| **交易員** | 決策整合 | 綜合所有報告，制定交易計劃 |
| **風險管理** | 風險控制 | 風險評估、倉位建議、止損止盈設定 |
| **投資組合經理** | 最終決策 | 最終交易決定（批准/拒絕），執行指令 |
### 工作流程圖
```
┌─────────────────┐
│ 使用者輸入參數 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 資料收集階段 │ ◄── yfinance, Reddit, RSS
└────────┬────────┘
│
▼
┌──────────────────────────────┐
│ 分析師團隊平行分析 │
│ ┌────┬────┬────┬────────┐ │
│ │市場│情緒│新聞│基本面│ │
│ └────┴────┴────┴────────┘ │
└────────┬─────────────────────┘
│
▼
┌─────────────────┐
│ 研究團隊辯論 │
│ 看漲 vs 看跌 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 交易員整合分析 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 風險管理評估 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 投資組合經理決策 │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 輸出最終報告 │
└─────────────────┘
### 健康檢查
```bash
GET /api/health
```
### 智能特性
### 執行分析
```bash
POST /api/analyze
Content-Type: application/json
#### 1. 動態研究深度調整
{
"ticker": "NVDA",
"market_type": "us",
"analysis_date": "2024-01-15",
"research_depth": 2,
"analysts": ["market", "social", "news", "fundamentals"],
"quick_think_llm": "gpt-5-mini",
"deep_think_llm": "claude-sonnet-4-5",
"quick_think_api_key": "sk-...",
"deep_think_api_key": "sk-ant-...",
"embedding_api_key": "sk-...",
"alpha_vantage_api_key": "..."
}
```
- **Shallow (1)**: 每個代理進行 1 輪分析，適合快速決策
- **Medium (2)**: 每個代理進行 2 輪分析，平衡深度與速度
- **Deep (3+)**: 每個代理進行 3+ 輪分析，全面深入研究
### 查詢任務狀態
```bash
GET /api/task/{task_id}
```
#### 2. 長期記憶系統
完整文檔: http://localhost:8000/docs
- 使用 ChromaDB 向量資料庫儲存歷史決策
- 代理可以參考過去類似情況的決策
- 持續學習與改進分析品質
---
#### 3. 結構化輸出
## 🛠️ 技術棧
- 所有報告均採用 Markdown 格式
- 清晰的章節結構
- 支援表格、列表、程式碼區塊等豐富格式
### 後端
| 技術 | 用途 |
|------|------|
| FastAPI | 異步 Web 框架 |
| LangGraph | 多代理工作流編排 |
| LangChain | LLM 應用開發 |
| ChromaDB | 向量資料庫（記憶系統）|
| PostgreSQL | 使用者資料儲存 |
| SQLAlchemy + asyncpg | 異步資料庫 ORM |
| Pydantic | 資料驗證 |
#### 4. 實時資料整合
- yfinance: 即時股價與歷史資料
- Reddit API: 社群情緒分析
- RSS Feeds: 財經新聞抓取
- Alpha Vantage: 美股詳細財務資料（必需）
- FinMind: 台股上市櫃資料 integration (https://finmindtrade.com)
### 前端
| 技術 | 用途 |
|------|------|
| Next.js 16 | React 全端框架 |
| TypeScript | 靜態型別 |
| Tailwind CSS | 樣式框架 |
| shadcn/ui | UI 組件庫 |
| Dexie.js | IndexedDB 封裝 |
| Recharts | 資料視覺化 |
---
@ -843,21 +462,12 @@ TradingAgentsX 模擬真實交易公司的組織架構，每個代理都有其
## 🙏 致謝
### 特別感謝
本專案基於 [TauricResearch/TradingAgents](https://github.com/TauricResearch/TradingAgents) 的原始專案進行改進和擴展。衷心感謝原作者創建了如此優秀的多代理交易分析框架，為我們提供了堅實的基礎。
### 使用的開源專案
本專案使用了以下優秀的開源專案：
- [LangChain](https://github.com/langchain-ai/langchain) - LLM 應用開發框架
- [LangGraph](https://github.com/langchain-ai/langgraph) - 多代理工作流編排
- [FastAPI](https://github.com/tiangolo/fastapi) - 現代化 Python Web 框架
- [Next.js](https://github.com/vercel/next.js) - React 全端框架
- [shadcn/ui](https://github.com/shadcn/ui) - 精美的 React 組件庫
- [ChromaDB](https://github.com/chroma-core/chroma) - AI 原生向量資料庫
- [yfinance](https://github.com/ranaroussi/yfinance) - Yahoo Finance 資料下載工具
- [TauricResearch/TradingAgents](https://github.com/TauricResearch/TradingAgents) - 原始專案
- [LangChain](https://github.com/langchain-ai/langchain) - LLM 應用框架
- [LangGraph](https://github.com/langchain-ai/langgraph) - 多代理編排
- [FastAPI](https://github.com/tiangolo/fastapi) - Web 框架
- [Next.js](https://github.com/vercel/next.js) - React 框架
- [shadcn/ui](https://github.com/shadcn/ui) - UI 組件庫
---

10
backend/app/main.py
View File

@ -165,13 +165,9 @@ async def startup_event():
@app.get("/")
async def root():
"""Root endpoint"""
return {
"message": "Welcome to TradingAgentsX API",
"version": settings.app_version,
"docs": "/docs",
"health": "/api/health",
}
"""Root endpoint - redirect to API documentation"""
from fastapi.responses import RedirectResponse
return RedirectResponse(url="/docs")
@app.exception_handler(Exception)

16
frontend/contexts/auth-context.tsx
View File

@ -111,11 +111,25 @@ export function AuthProvider({ children }: { children: ReactNode }) {
}, [parseToken, isTokenExpired]);
// Auto-clear local data when unauthenticated user leaves the page
// Only applies in production environment (not localhost)
useEffect(() => {
if (typeof window === "undefined") return;
// Check if running in local development mode
const isLocalDevelopment =
window.location.hostname === "localhost" ||
window.location.hostname === "127.0.0.1" ||
window.location.hostname.startsWith("192.168.") ||
window.location.hostname.startsWith("10.");
// Skip auto-clear in local development to preserve data
if (isLocalDevelopment) {
console.log("Local development mode: data will be preserved on page leave");
return;
}
const handleBeforeUnload = () => {
// Only clear data if user is not authenticated
// Only clear data if user is not authenticated (production only)
const currentToken = localStorage.getItem(TOKEN_KEY);
if (!currentToken) {
// Clear API settings (synchronous)