3.7 KiB
3.7 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- 移动止损保护利润USE_UNICORN_WEBSOCKET- 是否使用Unicorn WebSocket
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 重新初始化配置。