3.6 KiB
3.6 KiB
配置管理使用指南
功能概述
前端配置界面允许您实时修改交易系统的所有配置参数，修改后的配置会自动保存到数据库，交易系统会在下次扫描时自动使用新配置。
配置分类
1. 市场扫描 (scan)
SCAN_INTERVAL- 扫描间隔（秒）KLINE_INTERVAL- K线周期PRIMARY_INTERVAL- 主周期CONFIRM_INTERVAL- 确认周期ENTRY_INTERVAL- 入场周期MIN_VOLUME_24H- 最小24小时成交量MIN_VOLATILITY- 最小波动率MIN_CHANGE_PERCENT- 最小涨跌幅阈值TOP_N_SYMBOLS- 选择前N个货币对
2. 仓位控制 (position)
MAX_POSITION_PERCENT- 单笔最大仓位（账户余额的百分比）MAX_TOTAL_POSITION_PERCENT- 总仓位上限（账户余额的百分比）MIN_POSITION_PERCENT- 单笔最小仓位（账户余额的百分比）
3. 风险控制 (risk)
STOP_LOSS_PERCENT- 止损百分比TAKE_PROFIT_PERCENT- 止盈百分比
4. 策略参数 (strategy)
MIN_SIGNAL_STRENGTH- 最小信号强度（0-10）LEVERAGE- 杠杆倍数USE_TRAILING_STOP- 是否使用移动止损TRAILING_STOP_ACTIVATION- 移动止损激活阈值TRAILING_STOP_PROTECT- 移动止损保护利润
5. API配置 (api)
BINANCE_API_KEY- 币安API密钥BINANCE_API_SECRET- 币安API密钥USE_TESTNET- 是否使用测试网
使用方法
访问配置界面
- 启动前端应用
- 访问 http://localhost:3000/config
- 或点击导航栏的"配置"链接
修改配置
-
数字输入框：
- 直接输入数值
- 百分比配置会自动显示为百分比（如 0.05 显示为 5.00）
- 失去焦点或按Enter键自动保存
-
下拉选择框：
- 时间周期配置（INTERVAL）：选择时间周期
- 布尔值配置：选择"是"或"否"
- 选择后立即保存
-
文本输入框：
- 用于API密钥等文本配置
- 失去焦点或按Enter键自动保存
配置验证
系统会自动验证配置值：
- 数字类型：必须是有效数字
- 百分比配置：必须在 0-1 之间（对应 0%-100%）
- 布尔值：自动转换为 true/false
配置生效
- 配置修改后立即保存到数据库
- 交易系统会在下次扫描时自动重新加载配置
- 无需重启交易系统
API接口
获取所有配置
GET /api/config/
获取单个配置
GET /api/config/{key}
更新配置
PUT /api/config/{key}
Body: {
"value": <新值>,
"type": "number|string|boolean",
"category": "scan|position|risk|strategy|api"
}
批量更新配置
POST /api/config/batch
Body: [
{
"key": "CONFIG_KEY",
"value": <值>,
"type": "number",
"category": "scan"
},
...
]
注意事项
- 百分比配置：前端显示为百分比（如 5.00%），但存储值为小数（0.05）
- 配置生效时间：修改后，交易系统会在下次扫描时使用新配置（默认1小时）
- API密钥安全：API密钥以明文存储在数据库中，请确保数据库安全
- 配置验证：无效的配置值会被拒绝，并显示错误信息
常见问题
Q: 修改配置后多久生效？
A: 交易系统会在下次扫描时（默认1小时后）自动使用新配置。
Q: 可以修改哪些配置？
A: 所有在数据库 trading_config 表中的配置都可以修改。
Q: 配置修改失败怎么办？
A: 检查错误提示，通常是：
- 数字类型配置输入了非数字
- 百分比配置超出了 0-100% 范围
- 网络连接问题
Q: 如何恢复默认配置？
A: 可以运行 python backend/init_config.py 重新初始化配置。