AlphaTerminal

高性能 · 高密度 · 可联动 · 完全免费 · 完全开源

Python Vue.js FastAPI License Release Tests

"让每一位个人投资者,都拥有一座专业的投研数据堡垒。"

🚀 快速启动(一键启动)

方式一:一键启动脚本(推荐)

Linux / macOS

# 1. 克隆仓库
git clone https://github.com/deancyl/AlphaTerminal.git
cd AlphaTerminal
# 2. 一键启动(自动安装依赖 + 启动前后端)
./start-services.sh all
# 3. 访问 http://localhost:60100

Windows

# 1. 克隆仓库
git clone https://github.com/deancyl/AlphaTerminal.git
cd AlphaTerminal
# 2. 一键启动(自动安装依赖 + 启动前后端)
.\start-services.ps1 all
# 3. 访问 http://localhost:60100

常用命令

服务架构

用户浏览器 → 前端服务器(60100) → [API代理] → 后端服务器(8002)
 → [静态文件] → dist/

方式二:手动启动

# 1. 安装后端依赖
cd backend
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
pip install psutil # 额外依赖
# 2. 安装前端依赖
cd ../frontend
npm install
# 3. 启动后端(端口 8002)
cd ../backend
python start_backend.py
# 4. 启动前端(端口 60100,另一终端窗口)
cd ../frontend
npm run dev -- --host 0.0.0.0 --port 60100
# 5. 访问 http://localhost:60100

环境要求

常见问题

1. Python externally-managed-environment 错误

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Node.js / npm 未找到

3. 端口被占用

# Linux/macOS
lsof -ti:8002 | xargs kill -9 # 后端端口
lsof -ti:60100 | xargs kill -9 # 前端端口
# Windows
Get-Process -Id (Get-NetTCPConnection -LocalPort 8002).OwningProcess | Stop-Process

4. 宏观经济面板显示错误

5. 前端请求直接访问localhost:8002导致连接失败

6. 数据接口连接失败

export HTTP_PROXY=http://你的代理IP:端口
export HTTPS_PROXY=http://你的代理IP:端口

5. Rollup native module 错误(Linux)

cd frontend
mkdir -p node_modules/@rollup
cd node_modules/@rollup
curl -L -o rollup-linux-x64-gnu.tgz https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.34.8.tgz
tar xzf rollup-linux-x64-gnu.tgz
mv package rollup-linux-x64-gnu
rm rollup-linux-x64-gnu.tgz

🎯 核心功能

市场数据

债券分析(Phase 8–9)

期货分析(Phase 8)

行业板块

新闻快讯

交互界面

回测实验室(v0.5.54+)

Debug 诊断控制台(v0.6.7+)

F9 深度资料(v0.6.16+)

🏗 技术架构

┌─────────────────────────────────────────────────────────┐
│ 前端 (Vite Dev Server) │
│ http://localhost:60100 (Web UI) │
│ Vue 3 + TailwindCSS + GridStack + ECharts │
└─────────────────────┬───────────────────────────────────┘
 │ proxy /api/* → :8002
┌─────────────────────▼───────────────────────────────────┐
│ 后端 (FastAPI) │
│ http://0.0.0.0:8002 (API Only) │
│ │
│ /api/v1/market/overview /api/v1/news/flash │
│ /api/v1/bond/curve /api/v1/futures/term_structure │
│ /api/v1/news/force_refresh /api/v1/market/sectors │
│ /api/v1/portfolio/ /api/v1/backtest/run │
│ /api/v1/copilot/status /api/v1/market/stocks/search │
│ /api/v1/f9/{symbol}/financial /api/v1/f9/{symbol}/institution │
│ /api/v1/f9/{symbol}/margin /api/v1/f9/{symbol}/forecast │
│ /api/v1/f9/{symbol}/shareholder /api/v1/f9/{symbol}/announcements│
│ /api/v1/f9/{symbol}/peers /api/v1/f9/health │
│ │
│ APScheduler 调度任务(后台线程) │
│ ├── NewsRefresh (每 5 分钟) ←─ 东方财富实时新闻 │
│ ├── AkShareDataFetch (每 3 分钟) │
│ └── SentimentFetch (每 3 分钟) │
└─────────────────────────────────────────────────────────┘
 │
 ▼
 ┌─────────────────────────────────┐
 │ AkShare / 东方财富 / 新浪财经 │
 │ HTTP_PROXY: 环境变量或 start_backend.py 配置
 └─────────────────────────────────┘

📂 项目结构

AlphaTerminal/
├── backend/
│ ├── app/
│ │ ├── main.py # FastAPI 入口 + CORS + lifespan
│ │ ├── routers/
│ │ │ ├── market.py # 行情 / 板块 / 个股搜索
│ │ │ ├── news.py # 快讯 / force_refresh
│ │ │ ├── bond.py # 债券收益率曲线 / 信用利差
│ │ │ ├── futures.py # 期货行情 / 期限结构
│ │ │ ├── sentiment.py # 市场情绪
│ │ │ ├── portfolio.py # 投资组合 CRUD / PnL / 快照
│ │ │ ├── backtest.py # 回测引擎
│ │ │ ├── copilot.py # AI Copilot
│ │ │ └── f9_deep.py # F9 深度资料 API
│ │ └── services/
│ │ ├── data_fetcher.py # AkShare / httpx 数据获取
│ │ ├── news_engine.py # 新闻缓存引擎
│ │ ├── sentiment_engine.py
│ │ ├── scheduler.py # APScheduler 调度
│ │ └── sectors_cache.py # 行业/概念板块缓存
│ ├── requirements.txt
│ └── start_backend.py # 后端启动入口
├── frontend/
│ └── src/
│ ├── App.vue # 主布局 + Navbar
│ ├── utils/
│ │ ├── chartDataBuilder.js # K线数据计算引擎(MA/BOLL/MACD/KDJ/RSI/ΔOI)
│ │ ├── indicators.js # 技术指标纯函数
│ │ └── symbols.js # 符号工具函数
│ └── components/
│ ├── DashboardGrid.vue # GridStack 网格
│ ├── NewsFeed.vue # 快讯面板
│ ├── QuotePanel.vue # 行情卡片
│ ├── DrawingCanvas.vue # 画线工具
│ ├── BaseKLineChart.vue # 统一K线哑组件(数据驱动)
│ ├── AdvancedKlinePanel.vue # 高级K线面板(Controller层)
│ ├── FullscreenKline.vue # 全屏K线
│ ├── FuturesPanel.vue # 期货面板(K线+ΔOI+期限结构)
│ ├── TermStructureChart.vue # 期限结构图(Forward Curve)
│ ├── BondDashboard.vue # 债券看板(利率矩阵+历史曲线对比)
│ ├── YieldCurveChart.vue # 收益率曲线(含历史截面对比)
│ ├── BacktestDashboard.vue # 回测实验室
│ ├── PortfolioDashboard.vue # 投资组合面板
│ ├── StockScreener.vue # 条件选股
│ ├── SentimentGauge.vue # 市场情绪仪表
│ ├── FundFlowPanel.vue # 资金流向面板
│ ├── StockDetail.vue # F9 深度资料面板
│ └── f9/ # F9 共享组件
│ ├── DataTable.vue # 数据表格
│ ├── InfoCard.vue # 信息卡片
│ ├── LoadingSpinner.vue # 加载指示器
│ ├── ErrorDisplay.vue # 错误显示
│ └── TrendChart.vue # 趋势图表
├── scripts/
│ ├── init_env.sh # ✅ 环境初始化脚本(克隆后运行)
│ ├── init_database.py # 数据库初始化
│ └── fetch_historical_data.py # 历史数据回填
├── docs/
├── KNOWN_ISSUES_TODO.md # 缺陷追踪 + 路线图
└── README.md

🧪 测试覆盖

后端测试

Copilot 模块测试详情

运行测试

# 运行所有后端测试
cd backend && pytest tests/ -v
# 运行 Copilot 测试
cd backend && pytest tests/unit/test_routers/test_copilot.py -v
# 运行带覆盖率
cd backend && pytest tests/ --cov=app --cov-report=html

🔧 常见问题

📜 许可