核心用法
OKX Competition Manager 是一个基于进化算法的多代理加密货币量化交易系统。系统同时运行5个采用不同策略的AI交易代理，在OKX Demo环境（真实价格、零风险）或Live环境（实盘交易）中24/7自动竞赛。
用户通过配置 agents_config.json 定义5个代理的策略参数、交易资产和风险敞口，系统每5分钟执行一次完整交易循环：获取实时价格 → 计算技术指标信号 → 通过OKX API下单。每个订单均绑定交易所原生止损（Exchange-Level SL），确保代理进程崩溃时持仓仍受保护。
每日07:00自动触发进化机制：evolve_agents.js 根据24小时P&L排名执行优胜劣汰——前2名策略存活，第3名保留策略但替换亏损资产，后2名则从 best_strategies/ 池中被全新策略取代。该设计实现了策略的自动迭代优化，无需人工干预即可持续进化。
显著优点
1. 多层安全防护体系
- 交易所级止损：每笔订单通过
slTriggerPx和slOrdPx: -1绑定OKX原生止损，代理崩溃不影响仓位安全 - 三层仓位控制：未知CT_VALS资产跳过交易、单代理单笔最大50%权益、单笔$500硬顶
- 模拟优先原则：强制要求7天盈利+15%收益+30笔交易+最大回撤<10%方可转实盘
2. 进化式策略优化
- 每日自动淘汰制确保策略库持续向高利润因子（Profit Factor）进化
- 与
strategy-researcher技能联动，夜间回测数百种策略组合，日间将最优策略注入进化池 - KISS设计哲学：拒绝过度优化，RSI Fast Confirm等简单策略已实现DOGE PF=4.90、LTC PF=2.90
3. 生产级运维支持
- Windows Task Scheduler + VBS guardian 脚本实现99%+系统可用性
- PID锁文件机制防止重复启动
- 完整的JSON格式排行榜（
leaderboard_okx.json）支持实时Dashboard可视化
潜在缺点与局限性
1. 中心化交易所依赖
- 仅支持OKX单一平台，无法跨所套利或对冲
- API限流、服务中断等OKX侧风险直接影响系统运行
- 需严格维护CT_VALS配置，合约面值错误将直接导致仓位计算偏差
2. 策略同质化风险
- 当前5个代理均基于RSI和Supply/Demand两类指标变体，缺乏真正异构策略（如机器学习、订单流、跨市场信号等）
- 进化池若长期收敛，可能导致策略多样性丧失
3. 操作门槛与维护成本
- 需要Node.js 18+、OKX API密钥管理、Task Scheduler配置等技术背景
- Windows VBS脚本自动化方案对非Windows用户不友好
- 每日07:00的进化需人工审核
pending_evolution.json后手动执行apply_evolution.js，无法实现完全无人值守
4. 回测与实盘差异
- Demo模式使用OKX模拟盘，滑点、流动性、API延迟可能与实盘存在差异
- 策略在极端行情（如2020年3月或2022年11月）下的表现未经充分验证
适合的目标群体
- 量化交易研究者：需要快速验证多策略并行效果、进化算法在交易领域的应用
- 算法交易员：已有OKX账户，寻求自动化策略框架替代手动交易
- 交易 Bot 开发者：学习交易所API集成、止损设计、多进程锁机制等工程实践
- 策略孵化器团队：需要标准化的策略竞赛平台，以数据驱动方式筛选优质策略
不适合：完全无编程/交易经验的普通投资者、寻求100%被动收益且不愿监控系统的用户。
常规使用风险
1. 配置风险
CT_VALS（合约面值）配置错误是最大人为失误源。建议在 helpers_okx.js 中通过OKX官方API /api/v5/public/instruments 动态校验而非硬编码，或增加启动时的CT_VALS自检逻辑。
2. 性能与依赖风险
- Node.js 单进程事件循环在极端行情下可能出现处理延迟
- 依赖OKX API稳定性，建议增加指数退避重试机制和备用数据源
competition.lock文件残留可能导致假死，需定期清理
3. 密钥安全风险
虽文档建议使用 .secrets/okx.env，但仍存在文件权限配置不当、意外提交至Git等风险。建议配合密钥管理服务（如AWS Secrets Manager）或OKX子账户隔离。
4. 进化机制风险
- 手动审核
pending_evolution.json的设计虽安全但降低自动化程度 - 若连续多日未审核，进化池可能堆积或策略老化
- 建议增加进化队列的自动回退机制（如超过48小时未审核则自动应用安全策略）