auto_trade_sys/QUICK_START.md
薇薇安 e5cea19b6a a
2026-01-13 20:43:43 +08:00

170 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 快速开始指南
## 1. 数据库初始化
```bash
# 创建数据库
mysql -u root -p < backend/database/init.sql
# 或手动执行
mysql -u root -p
source backend/database/init.sql;
```
## 2. 初始化配置到数据库
```bash
cd backend
python init_config.py
```
这将把 `config.py` 中的配置迁移到数据库。
## 3. 启动后端服务
```bash
cd backend
# 安装依赖
pip install -r requirements.txt
# 配置数据库方式1使用.env文件推荐
cp .env.example .env
# 编辑 .env 文件,设置数据库连接信息
# 或方式2使用环境变量
export DB_HOST=localhost
export DB_PORT=3306
export DB_USER=root
export DB_PASSWORD=your_password
export DB_NAME=auto_trade_sys
# 启动
uvicorn api.main:app --host 0.0.0.0 --port 8000 --reload
# 或使用启动脚本
chmod +x start.sh
./start.sh
```
访问 API 文档http://localhost:8000/docs
## 4. 启动前端
```bash
cd frontend
# 安装依赖
npm install
# 启动开发服务器
npm run dev
```
访问前端http://localhost:3000
## 5. 安装交易系统依赖
### 方式1使用安装脚本推荐
```bash
cd trading_system
./setup.sh
```
### 方式2使用项目根目录虚拟环境
```bash
# 如果项目根目录已有虚拟环境
source .venv/bin/activate # 从项目根目录
cd trading_system
pip install -r requirements.txt
```
### 方式3手动创建虚拟环境
```bash
cd trading_system
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```
## 6. 启动交易系统
```bash
# 确保虚拟环境已激活
source .venv/bin/activate # 从项目根目录
# 或 source ../.venv/bin/activate # 从trading_system目录
# 进入trading_system目录
cd trading_system
python main.py
# 或从项目根目录运行
python -m trading_system.main
```
## 配置说明
### 1小时主周期配置
配置已更新为1小时主周期
- **主周期**: 1小时
- **确认周期**: 4小时
- **入场周期**: 15分钟
- **扫描间隔**: 1小时
### 通过前端修改配置
1. 访问 http://localhost:3000/config
2. 修改任意配置项
3. 配置会自动保存到数据库
4. 交易系统会在下次扫描时读取新配置
### 配置分类
- **市场扫描**: 扫描间隔、K线周期等
- **仓位控制**: 单笔仓位、总仓位限制
- **风险控制**: 止损、止盈
- **策略参数**: 信号强度、杠杆等
- **API配置**: API密钥、测试网设置
## 数据统计
访问前端查看:
- **仪表板**: 实时账户和持仓信息
- **交易记录**: 历史交易和统计
- **配置管理**: 可视化配置界面
## 注意事项
1. **数据库连接**: 确保MySQL服务运行数据库已创建
2. **API密钥**: 在配置界面设置API密钥或使用环境变量
3. **端口冲突**: 确保8000后端和3000前端端口未被占用
4. **配置同步**: 前端修改配置后,交易系统需要重启或等待下次扫描
## 故障排查
### 后端无法连接数据库
检查环境变量:
```bash
echo $DB_HOST
echo $DB_NAME
```
### 前端无法连接后端
检查 `frontend/.env` 文件:
```
VITE_API_URL=http://localhost:8000
```
### 交易系统无法读取配置
确保:
1. 数据库已初始化
2. 已运行 `python backend/init_config.py`
3. `backend/` 目录存在