auto_trade_sys/docs/QUICK_START.md

快速开始指南

1. 数据库初始化

# 创建数据库
mysql -u root -p < backend/database/init.sql

# 或手动执行
mysql -u root -p
source backend/database/init.sql;

2. 初始化配置到数据库

cd backend
python init_config.py

这将把 config.py 中的配置迁移到数据库。

3. 启动后端服务

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. 启动前端

cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

访问前端：http://localhost:3000

5. 安装交易系统依赖

方式1：使用安装脚本（推荐）

cd trading_system
./setup.sh

方式2：使用项目根目录虚拟环境

# 如果项目根目录已有虚拟环境
source .venv/bin/activate  # 从项目根目录
cd trading_system
pip install -r requirements.txt

方式3：手动创建虚拟环境

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

6. 启动交易系统

# 确保虚拟环境已激活
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. 配置同步: 前端修改配置后，交易系统需要重启或等待下次扫描

故障排查

后端无法连接数据库

检查环境变量：

echo $DB_HOST
echo $DB_NAME

前端无法连接后端

检查 frontend/.env 文件：

VITE_API_URL=http://localhost:8000

交易系统无法读取配置

确保：

1. 数据库已初始化
2. 已运行 python backend/init_config.py
3. backend/ 目录存在