AlphaMate

AlphaMate 是一个面向中国A股市场的个人AI交易助手系统。采用多Agent协作架构，结合DeepSeek大模型实现智能化股票分析与交易决策。

功能特性

• 智能决策: 基于 LangGraph 的多 Agent 协作，Bull/Bear 辩论机制
• 实时行情: 接入 AkShare 获取A股实时数据
• 风控管理: 硬编码熔断规则、仓位控制、回撤限制
• T+1 交易: 完整支持A股 T+1 交收规则
• 模拟交易: Phase 1 模拟盘环境，安全验证策略

技术栈

后端

• Python 3.11+
• FastAPI + Uvicorn
• LangGraph (多Agent编排)
• SQLite + Redis
• AkShare (A股数据)

前端

• Next.js 14 (App Router)
• TypeScript
• Zustand (状态管理)
• Recharts (图表)
• Tailwind CSS

项目结构

AlphaMate/
├── backend/                  # Python 后端
│   ├── app/
│   │   ├── api/              # FastAPI 路由
│   │   ├── agents/           # LangGraph 多Agent
│   │   ├── models/           # 数据模型
│   │   ├── repositories/     # 数据访问层
│   │   ├── services/         # 业务服务
│   │   ├── memory/           # 工作记忆
│   │   └── websockets/       # WebSocket 实时推送
│   ├── tests/                # 测试用例
│   └── config/               # 配置文件
│
├── frontend/                 # Next.js 前端
│   └── src/
│       ├── app/              # 页面路由
│       ├── components/       # React 组件
│       ├── stores/           # Zustand 状态
│       ├── hooks/            # 自定义 Hooks
│       └── lib/              # 工具库
│
├── data/                     # 数据目录
│   └── alphamate.db          # SQLite 数据库
│
└── docs/                     # 文档
    ├── project.md            # 项目说明
    ├── architecture-plan.md  # 架构设计
    └── reference.md          # 参考资料

快速开始

环境要求

• Python 3.11+
• Node.js 18+
• Redis (可选，用于工作记忆)

1. 克隆项目

git clone <repository-url>
cd AlphaMate

2. 安装后端依赖

cd backend
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

3. 安装前端依赖

cd frontend
npm install

4. 启动服务

方式一：分别启动

启动后端 (端口 8000)

cd backend
source .venv/bin/activate
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

启动前端 (端口 3000)

cd frontend
npm run dev

方式二：一键启动 (推荐)

# 后端
cd backend && .venv/bin/uvicorn app.main:app --reload --port 8000 &

# 前端
cd frontend && npm run dev

5. 访问应用

• Dashboard: http://localhost:3000
• API 文档: http://localhost:8000/docs
• WebSocket: ws://localhost:8000/ws/realtime

API 接口

REST API

方法	端点	说明
GET	/api/portfolio	获取持仓与盈亏
GET	/api/portfolio/history	资产历史曲线
GET	/api/trades	交易记录列表
GET	/api/decisions	AI决策历史
POST	/api/decisions/{id}/approve	批准决策
POST	/api/decisions/{id}/reject	拒绝决策
GET	/api/quotes/{ticker}	获取实时行情
POST	/api/quotes/batch	批量获取行情

WebSocket

连接 /ws/realtime 后，可订阅以下事件类型：

• quote - 实时行情更新
• decision - AI 决策通知
• trade - 交易执行通知
• alert - 风控告警

运行测试

cd backend
source .venv/bin/activate

# 运行所有测试
python -m pytest tests/ -v

# 运行特定测试
python -m pytest tests/test_api.py -v
python -m pytest tests/test_trading.py -v
python -m pytest tests/test_agents.py -v

风控规则

规则	阈值	动作
单日亏损限额	净值回撤 > 2%	强制平仓，停止交易
单笔交易上限	单笔 > 总资产5%	拒绝执行
单只股票仓位	> 30%	拒绝加仓
总仓位上限	> 90%	拒绝开新仓

开发计划

• Phase 1: 基础框架（模拟盘）
  • 后端 API 层
  • WebSocket 实时推送
  • 前端 Dashboard
  • 风控规则引擎
• Phase 1.5: Bull/Bear 辩论机制
• Phase 2: 实盘接入
• Phase 3: 多市场支持

注意事项

1. 模拟盘模式: 当前为 Phase 1 模拟盘，不涉及真实交易
2. A股规则: 系统内置 T+1 交收、涨跌停板等A股特殊规则
3. 数据来源: 行情数据来自 AkShare，仅供学习研究使用

License

MIT License