555cute/r20-quantum-trader · 上手攻略
- 仓库：555cute/r20-quantum-trader
- 链接：https://github.com/555cute/r20-quantum-trader
- 分类：ai-trading · llm-native-quant
- 作者：Tom
- 更新：2026-09-06
是什么
r20-quantum-trader 是一个 LLM-Native 自进化量化交易终端，集成了 Bloomberg 风格暗色界面与 6 资产 AI 决策大脑。它用 DeepSeek / Claude / GPT / Gemini 等大模型担任全权量化决策核心，结合微积分行情动力学、聪明钱雷达和确定性硬门禁，在 OKX 交易所执行实盘交易（目前仅支持 OKX）。
核心定位：把大模型的推理能力变成可执行的量化策略，而非传统的规则指标策略。
解决什么问题
传统量化策略依赖僵硬的技术指标参数，容易在市场结构突变时失效。该项目用大模型替代指标规则，实现：
- 策略自进化：6 小时定时调度，自动淘汰旧策略（TTL 半衰期），始终用最新的 prompt 心法做决策
- 多资产覆盖：6 种资产（推测为 BTC/ETH 等主流加密货币，官方未明文列出）
- 趋势爆发力量化：微积分行情动力学将价格时间序列转化为可比较的物理量（速度/加速度/动能）
- 主力行为感知：Top 100 聪明钱雷达追踪全网大户的真实多空方向与建仓成本
- 硬止损保护：确定性拦截器确保策略不会在极端行情下穿仓
快速安装
⚠️ 本项目涉及真实资金操作与 OKX API 密钥配置，克隆前请确保熟悉 Docker/Python/Node.js 基础。
环境要求
- Python 3.10+
- Node.js 18+
- Docker（可选，用于容器化部署）
- OKX 交易所账户 + API Key + API Secret
步骤
# 1. 克隆仓库并切换至最新正式发布版（推荐，避免开发版不稳定）
git clone https://github.com/555cute/r20-quantum-trader.git
cd r20-quantum-trader
git checkout $(git describe --tags --abbrev=0)
# 或直接下载最新 Release：https://github.com/555cute/r20-quantum-trader/releases/latest
# 2. 创建并激活 Python 虚拟环境
python3 -m venv venv
source venv/bin/activate # Linux/macOS
# .\venv\Scripts\activate # Windows
# 3. 安装 Python 后端核心依赖
pip install -r requirements.txt
# 4. 配置 OKX API 凭证（必填）
cp env.example .env
# 编辑 .env，填入：
# OKX_API_KEY=你的API Key
# OKX_API_SECRET=你的API Secret
# OKX_PASSPHRASE=你的API Passphrase
# 以及大模型 API Key（如 DeepSeek/Claude）
# 5. 安装前端依赖并构建
cd frontend
npm install
npm run build
cd ..
# 6. 启动后端服务（监听 0.0.0.0:8080）
python3 -m uvicorn r20_backend.app:app --host 0.0.0.0 --port 8080 --reload
访问地址
- 实盘监控终端：http://localhost:8080/
- 管理控制面：http://localhost:8080/admin/
- API 交互文档（Swagger UI）：http://localhost:8080/api/docs
测试
# 运行全套单元测试（116 个测试用例）
python3 -m unittest discover -s tests/
# 期望输出：Ran 116 tests ... OK（100% 通过）
核心用法
决策权重体系
系统的核心是 LLM-Native 70% 权重决策——大模型拥有最终决策主导权。具体参数可在管理控制面调整。
核心模块
① 微积分行情动力学 实时计算 15M/1H 价格时间序列的： - 一阶导数（速度 $v$）—— 趋势强度 - 二阶导数（加速度 $a$）—— 趋势加速/减速 - 定积分动能（做功 $E$）—— 趋势持续性
② Top 100 聪明钱雷达 全天候扫描全网持仓前 100 名主力账户： - 真实多空持仓方向 - 平均建仓成本 - 资金净流向
③ 确定性硬门禁（Deterministic Interceptors） 入场前必须同时满足： - 置信度 ≥ 75% - 盈亏比 R:R ≥ 2.0 - 2.0× ATR 宽止损（防插针） - 保本移损（TP/SL 自动跟踪）
④ 交易所原生 OCO 委托 所有策略发单强制绑定 OKX 云端条件单，即使后端离线断网，交易所撮合引擎仍执行防穿仓兜底。
自进化引擎（v7.4.1 修复）
定时调度升级为 ["02:00", "08:00", "14:00", "20:00"] 标准列表，每 6 小时自动：
1. 评估当前策略表现
2. 生成新 prompt 心法
3. 用 TTL 半衰期淘汰 7 天以上旧策略
4. 保持 Top 8 策略容量上限
策略版本控制
管理控制面支持：
- 策略快照（四大单元不可变指纹 v7.4.1@4aa048db）
- 一键秒级原子回滚
- 废弃具名策略归档删除
⚠️ 手动平仓注意：v7.4.1 修复了 OKX 手动平仓 502 报错；平仓前系统会自动扫描并清理同标的在途云端 OCO 策略委托，避免交易所撮合冲突。
典型适用场景
| 场景 | 推荐度 | 说明 |
|---|---|---|
| 加密货币多空趋势跟踪 | ⭐⭐⭐⭐ | 6 资产 + 聪明钱雷达适合捕捉主流币趋势 |
| LLM 原生量化策略研究 | ⭐⭐⭐⭐ | 自进化 prompt 心法是业界少见的实验框架 |
| 日内波段操作 | ⭐⭐⭐ | 15M/1H 粒度 + 硬门禁适合短线 |
| 跨资产宏观对冲 | ⭐⭐ | 目前仅 OKX，资产覆盖有限 |
| 传统股票/期货 | ❌ | 目前仅支持 OKX 加密货币交易 |
坑与注意
- 必须使用 Release 版：作者明确建议不要直接拉 main 分支（可能含未发布改动），请用最新 tag。
- API 密钥安全：
.env中的 OKX API Key 和大模型 API Key 切勿提交到公网仓库；建议加入.gitignore。 - OKX WAF 拦截：旧版本手动平仓曾被 OKX Cloudflare WAF 误杀（502），v7.4.1 已修复，但仍建议关注 OKX 账户安全设置。
- 策略回滚有风险：策略版本控制工作台支持秒级回滚，但回滚到亏损策略可能导致连续亏损，请谨慎操作。
- 大模型输出解析：v7.4.1 修复了大模型输出字典/字符串类型混杂导致的崩溃，低版本可能频繁崩溃。
- asset_multipliers 配置：v7.4.1 之前该参数空转，配置后需确认复盘结果已持久化。
- 免责声明：MIT 协议开源，但作者在 README 明确声明不构成投资建议，实盘亏损由用户自负。
与同类对比
| 特性 | r20-quantum-trader | Backtrader | QuantConnect |
|---|---|---|---|
| LLM 决策 | ✅ 原生 | ❌ 规则指标 | ❌ 规则指标 |
| 自进化 | ✅ 6h 自动调度 | ❌ | ❌ |
| 交易所 | 仅 OKX | 多交易所 | 多交易所 |
| 前端界面 | Bloomberg 风格 Vue3 | 无内置 | Web IDE |
| 开源协议 | MIT | MIT | AGPL |
| 成熟度 | v7.x（活跃开发） | 成熟稳定 | 企业级 |
核心差异：r20-quantum-trader 是目前少数将 LLM 作为量化决策核心的项目，而非辅助工具。传统量化框架（Backtrader, QuantConnect）本质是回测/执行引擎，策略仍依赖人工规则。
一句话推荐结论
如果你想把大模型的推理能力直接变成可执行的量化策略，且主要交易加密货币，r20-quantum-trader 是一个值得研究的有趣实验——尤其是它的自进化 prompt 心法框架在业内相当少见；但请务必先用模拟盘验证，实盘风险自负。