全市场宏观态势自适应识别 ｜ 对冲基金投委会博弈 ｜ 17项 Fail-Closed 物理硬风控 ｜ 深度思考链 (CoT) 原生白盒透视
OKX / Binance / Gate 三所平权撮合 ｜ 策略全要素 100% 动态定制 ｜ 双官方旗舰预设体系 ｜ 全链路可观测性结构化审计
全景特性 · 前台操盘大屏 · 后台管理控制面 · 策略配置中心 · 多级日志系统 · 资金规模适配 · 架构索引 · 极速部署
R20 Quantum Trader 是一套面向专业交易团队与量化交易员打造的多交易所平权量化决策与自动化执行操作系统。在 v8.0.0 架构跃迁中，系统深度融合了大语言模型（LLM）的宏观推理能力、因果微积分动力学矩阵与对冲基金 Trading Desk 投委会协同博弈机制，彻底打通**「市场体制自适应识别 ➔ 策略套件动态挂载 ➔ 投委会交叉质询 ➔ 底层物理风控硬拦截 ➔ 毫秒级多所执行 ➔ 实盘台账自进化」**的完整自主操盘大闭环。
┌───────────────────────────────────────────────────────────┐
│ R20 v8.0.0 自主对冲基金操盘全链路架构 (End-to-End) │
└─────────────────────────────┬─────────────────────────────┘
│
┌────────────────────────────────────────────────────┼────────────────────────────────────────────────────┐
▼ ▼ ▼
┌──────────────────────────────┐ ┌──────────────────────────────┐ ┌──────────────────────────────┐
│ 1. 宏观体制自适应中枢 (Regime)│ │ 2. 投委会协同博弈 (Council) │ │ 3. 执行层物理风控 (Execution)│
├──────────────────────────────┤ ├──────────────────────────────┤ ├──────────────────────────────┤
│• 实时扫描全标的池 9 大币种 │ │• 进攻/防守/数理/宏观独立参谋 │ │• Fail-Closed 故障硬切断防线 │
│• 四态划分: 单边/宽幅/低波/冲击│ │• 独立绑定不同旗舰推理模型 │ │• 几何硬性盈亏比 R:R ≥ 2.0 │
│• 自适应推荐官方匹配预设套件 │ │• 双轮交叉质询辩论 + CIO 仲裁 │ │• 4H 宏观顺势单向否决门禁 │
│• 原生注入 {{market_regime}} │ │• 深度思考链 (CoT) 原始草稿透视│ │• 三所原生条件单与双向持仓适配│
└──────────────────────────────┘ └──────────────────────────────┘ └──────────────────────────────┘
- 认知决策归模型，物理风控归底座：大语言模型与投委会仅拥有交易意图的“提案权”。每一笔订单在触达交易所网关前，必须 100% 严格穿透底层 Python 物理硬门禁（订单几何合法性、真实盈亏比 R:R ≥ 2.0、4H 顺势否决、同向持仓配额等），彻底消灭模型幻觉可能导致的意外亏损；
-
全市场体制自适应（Market Regime Auto-Detection）：告别“震荡市跑单边被磨损、单边市跑网格被套牢”的量化宿命。系统根据微积分速度
$v$ 、加速度$a$ 、定积分能量$E$ 与波动率分布，自动研判当前大盘体制并匹配最优策略范式； - 三所平权对等撮合（Three-Venue Parity）：OKX、Binance（币安）、Gate（芝麻开门）三大主流交易所享有对等风控与执行地位，统一多所资产视图，自适应识别各所双向持仓与原生条件保护单；
- 全链路白盒可解释与台账自进化：全流程记录大模型原始思考推演链、席位交锋记录与选所证据链。每 6 小时自动穿透真实平仓台账，提炼黄金交易心法并注入长期记忆。
系统由前台双翼量化操盘工作台与后台机构级控制面共同构成，完美支持桌面 1080P/2K/4K 极客大屏沉浸式盯盘与移动端响应式触控：
整合资产总览舱、因果微积分动力学矩阵与 KLineChart v10 原生高性能 K 线交互引擎，毫秒级呈现多空力量对比：
前台抽屉原生集成宏观市场体制动态指示条（趋势分、波动分、震荡指数与主导方向），并对每一笔决策提供展开式 「🧠 深度思考链与数理依据 (CoT)」，完整折叠展现形态结构、微积分特征、概率期望与模型原始推演草稿：
全景监控系统运行健康度、三所连接状态、大模型推理时延、内存消耗与底层硬风控拦截事件：
“策略制定权永远属于交易员，而非写死的系统硬代码。”
传统量化软件往往将交易逻辑深埋在底层脚本中，调参极其困难且缺乏复盘能力。R20 量子交易系统彻底摒弃黑盒硬编码，将提示词、投委会、物理风控、认知自省、版本快照、风控阈值、模型路由与多所执行解耦为八大可视化策略配置模块：
彻底告别硬编码！支持交易员在前台可视化编排 「System 核心军规」 与 「User 市场特征组装模版」：
- 出厂双旗舰官方预设套件 (v8.0.0)：
- 🚀 「全维度波段强化版」(默认主策略)：基于 1H~4H 宏观多空趋势、因果微积分动能共振、概率期望优先定性，给足波段呼吸空间，让利润充分奔跑；
- 🛡️ 「宽幅震荡箱体收割版」(应对高波动无序洗盘)：针对高波动箱体震荡定制，严禁半山腰追价，在箱体上下轨边际高抛低吸，给足 2.2x ATR 宽止损隔绝假突破插针，浮盈 1.5R 稳固波段立即保本移损锁死胜率；
- 标准化 9 大语义变量插槽：内置
{{market_regime}}（全市场宏观体制）、{{market_matrix}}（行情数理矩阵）、{{risk_budget}}（自适应风险预算）、{{news_intelligence}}（舆情快讯）、{{trading_memory}}（自进化心法）、{{account_positions}}（实时在管仓位）等丰富数据插槽，点击一键注入； - 高保真预览与 JSON 方案导入导出：一键保存方案副本与历史版本回溯，内置白盒防投毒安全护栏（严禁要求取消硬止损或越权修改风控）。
模拟华尔街对冲基金 Trading Desk 协同运作机制，彻底终结单一大模型的认知盲区与幻觉风险：
- 参谋席位 100% 自由定义：
- 自由增删进攻官、风控官、量化数理官、宏观策略官或自定义专家席位；
- 每个席位可独立绑定大模型厂商（如进攻官配 Claude 3.7 Thinking，风控官配 DeepSeek-R1，数理官配 GPT-4o），独立指定系统提示词与推演温度；
- 双轮交叉质询模式 (Cross-Exam)：第一轮各席位独立研判提案 ➔ 第二轮同行交叉漏洞质询与辩论 ➔ 第三轮首席投资官（CIO）统筹终审发单；
- 长思考链超时解耦：针对长推演模型（如 DeepSeek-R1、o1/o3），支持 10~1800s 宽限思考预算，避免过早截断。
“认知决策归模型，物理风控归底座”。系统绝不把止损与风控寄托于 LLM 提示词本身的自律，而是在交易执行底层构筑了不可跳过的 Python 物理插件流水线：
- Fail-Closed 故障硬切断：任何拦截插件报错或超时，开仓动作一律无条件强制熔断拦截；
- 四大出厂核心物理门禁：
#1 4H 宏观顺势铁律(01_macro_trend_filter.py)：4H 多头通道严禁摸顶开空，空头承压严禁逆势抄底；#2 高置信度质量门禁(02_confidence_gatekeeper.py)：置信度门槛可自定义（默认低于 75% 强制降级观望）；#3 1H ADX 趋势杂波过滤(03_adx_volatility_filter.py)：过滤无序横盘震荡市场，低于门限严禁开仓；#4 真实 2.0R 盈亏比门禁(04_risk_reward_gatekeeper.py)：执行层严格几何校验，严禁亏损概率不对称的劣质交易；
- 在线沙箱单步测试：支持在界面现场输入模拟报价参数，单步测试每道拦截插件的通过/拒绝表现。
在实战中持续自省，绝不在回撤期情绪化乱改参数：
- 实盘台账自动穿透：系统每 6 小时自动读取全量实盘平仓台账进行闭环归因，精准剖析多空双杀、手续费磨损与执行偏差；
- 白盒黄金心法沉淀：提炼实战教训并动态维护
data/AI_TRADING_MEMORY.md黄金心法，在后续决策推演中自动注入； - 防偏见护栏 (Evolution Shield)：离群噪点剔除、宪法级防偏见红线；支持一键回滚至官方黄金基准；
- 心法敏锐半衰期 (7~14天)：动态评估历史心法时效，自动衰减淘汰过期经验，杜绝因旧周期杂波导致过度拟合。
针对多组件联动修改可能引发的“策略撕裂”与“无法复盘”难题，打造工业级快照回滚引擎：
- 四大策略单元聚合指纹：打包「提示词模版」、「物理拦截插件」、「投委会席位」与「标的池参数」，计算出全网唯一不可变的 SHA-256 策略版本标识（如
v8.0.0@a7f29b1c）； - 策略方案具名归档：支持将调试满意的全套策略一键保存为具名归档（如“宽幅震荡收割版”、“进取突破版”），随时调用；
- 0.5s 原子级秒级回滚：新策略表现不佳时，一键秒级恢复历史版本，前置自动快照备份并校验哈希，杜绝局部状态残留；
- 全链路台账 100% 溯源绑定：每一笔开仓与平仓订单，后台强制锁定记录当时的
policy_version与policy_hash。
全部执行层硬风控参数从源码中剥离，收拢至单一事实源（scripts/risk_constants.py）并在后台集中可视化配置：
- 17 项执行硬风控全量可调：最高持仓数、同向敞口上限、单笔保证金占比、单标的累计保证金封顶、杠杆上限、单笔 1R 风险额、最小盈亏比 R:R 硬底线、开仓 AI 置信度门禁、日亏熔断（比例+绝对双封顶）、最长持仓时效、止损冷静期等；
- 三套优质预设一键应用：
- 🛡️ 稳健防守：新账户首选，严禁加仓、3x 杠杆、85% 高置信门禁；
- ⚖️ 均衡波段：基线方案，攻守兼备；
- 🚀 进取猎手：单边大趋势市首选，允许同向 4 仓、2 次浮盈加仓、16h 大波段呼吸空间；
- 高危操作防呆确认：基线本金修改与紧急一键全平仓均受到严格的短语输入匹配保护。
全开放模型供应商直连矩阵与思考链预算管理，为推理型大模型与轻量极速模型提供工业级调度中枢：
- 多供应商自由接入：原生兼容 OpenAI、Claude、Gemini、DeepSeek、Qwen 等主流模型厂商 API；
- 全局思考推演超时配置 (10~1800s)：针对 DeepSeek-R1、o1/o3、Claude 3.7 Thinking、Gemini 3 等长思考链旗舰模型，自由调配思考等待预算，杜绝超时截断；
- 多模型故障自动熔断降级 (Failover Matrix)：主模型遭遇频控 429 或服务宕机时，秒级自动平滑切换至备选备份模型。
彻底打破传统量化软件单所绑定的架构局限，实现跨交易所流动性聚合与因果动力学分析：
- 三所原生直连：OKX、Binance（币安）、Gate（芝麻开门）三大交易所对等接入，独立维护各所 API 凭证与持仓模式；
- 原生保护单深度适配：币安 Conditional Algo 单（
reduceOnly=True）与 Gate 双向持仓模式全自动识别适配； - 统一宏观风控中枢：全所共享单日亏损熔断与最大同向敞口防线；
- 跨所因果微积分动力学矩阵：实时比对三所现货/合约点位价差、资金费率与动量加速度，辅助发现背离套利机会。
前台专属「AI 推演」大盘，完整记录历次 15 分钟主脑周期时序流、宏观研判总结、多币种买卖挂单指令与多模型博弈提案细节：
系统内置严密清晰的多级日志体系（Multi-Tier Logging System），实现从宏观决策推演到微观毫秒级报单的全生命周期监控：
| 日志标识 | 物理日志路径 | 写入主体 | 职责与记录范围 |
|---|---|---|---|
trader |
logs/ai_factor_trader.log |
量化交易主脑巡检进程 | 全市场 9 标的行情获取、大模型多席位辩论推演、置信度过滤、选所路由、保护单挂载与止损棘轮收紧 |
backend |
logs/uvicorn.log |
FastAPI / Uvicorn 异步服务 | 前后端 HTTP 请求/响应流水、中间件拦截、CORS 处理、异常堆栈与只读数据面报错 |
scheduler |
logs/r20_gateway.log |
R20 Gateway 调度守护进程 | 调度器单例锁抢占、定时任务触发（trader, factor_library, news 等）、心跳租约与碎片清理 |
audit |
logs/r20_admin_audit.jsonl |
安全审计子系统 (Append-Only) | 记录操作时间戳、IP、动作类型与结果（登录鉴权、改密、凭证编辑、风控调参、一键紧急全平仓） |
系统严格采用基于账户净值的比例推导机制，不预设写死的绝对金额门槛，小额资金（如 20U 模拟盘）与机构级资金（如 4000U+）均可自适应安全运行：
| 风控指标 | 计算规则（基线默认值） | 20U 资金池 | 4000U 资金池 |
|---|---|---|---|
| 单笔 1R 风险限额 | min(池内单标上限, 可用余额 × 2%) |
0.40 U | 15.0 U |
| 单笔保证金硬顶 | 可用余额 × 20% |
4.0 U | 800.0 U |
| 单标的累计保证金 | min(600, 可用余额 × 30%) |
6.0 U | 600.0 U |
| 单日最大亏损熔断 | min(150, 可用余额 × 5%) |
1.0 U | 150.0 U |
⚠️ 重要提示：本仓历史上从未存在过OPENCODE.md（请勿查找此空路径）。本系统已建立清晰完备的现代化工程架构与导航索引：
| 想了解 | 看这里 | 说明 |
|---|---|---|
| 后端分层体系 | r20_backend/README.md |
后端分层架构（L0 门面 / L1 装配 / L2 路由 / L3 领域 / L4 子包）、新模块抽取约定 |
| 运行时守护脚本 | scripts/README.md |
哪个是入口/守护、33 个根层模块用途、调度周期与双拼写 import 规范 |
| 前端组件与状态 | frontend/src/components/admin/README.md |
前端组件与 Composable 划分、Vue 3 后台与操盘看板状态机 |
| 独立部署环境 | STANDALONE.md |
本地独立部署、环境变量配置与服务拉起指南 |
| 应急故障恢复 | RECOVERY_GUIDE.md |
应急止损、冷备份数据恢复与进程重置预案 |
| 提示词工程攻略 | docs/PROMPT_GUIDE.md |
全量实时语义数据字典、波段呼吸编写军规与投委会实战指南 |
架构门禁保障机制：
- 子包模块全登记：
tests/audit/test_directory_docs_current.py强制检查受管子包新增模块必须写入各自__init__.py清单； - 根层模块全登记：
r20_backend/*.py与scripts/*.py根层模块必须登记在对应 README 表格中； - 文档数据防腐烂：
tests/core/test_readme_baseline_numbers.py强制要求基线测试数字与仓内真实用例数保持严格同量级对齐。
- 操作系统：Linux / macOS（推荐 Ubuntu 22.04 LTS 或更高版本）
- Python 环境：Python 3.10+
- 前端构建环境：Node.js 18+ / npm
git clone https://github.com/555cute/r20-quantum-trader.git
cd r20-quantum-trader
# 执行环境初始化脚本（创建 .venv 并安装核心依赖）
sh deploy/install.sh
# 配置环境变量（根据需要填入大模型 API Key，默认开启模拟盘）
vim .env# 1. 激活虚拟环境
source .venv/bin/activate
# 2. 编译构建现代化前端管理后台与操盘看板
cd frontend
npm install
npm run build
cd ..
# 3. 启动量化交易后端主引擎
python -m uvicorn r20_backend.app:app --host 0.0.0.0 --port 8080
# 或直接通过一键启动脚本运行：./start.sh- 🖥️ 前台量化操盘看板：
http://localhost:8080/ - ⚙️ 后台策略管理控制台：
http://localhost:8080/admin/login（默认用户名admin）
系统沉淀了覆盖底层物理风控几何拦截、策略版本快照、投委会博弈逻辑、多交易所鉴权和前后端契约的完整自动化测试保障：
# 1. 后端审计、量化模型与 UI 基础测试 (1205+ 全过)
.venv/bin/pytest tests/audit tests/llm tests/ui tests/venues -q
# 2. 前端类型检查、无障碍与契约测试 (392 项全过)
cd frontend
npm run build
npx vue-tsc --noEmit
node --test tests/*.test.mjs
cd ..- 本项目属于开源量化交易软件与量化算法研究框架，仅供技术研究、学习交流与模拟盘环境测试；
- 加密货币市场具有极高风险与不确定性，任何历史回测表现均无法预示未来收益；
- 使用者应当具备量化交易专业常识，在充分理解策略逻辑之前，请务必先于 DEMO 模拟盘 环境下完整验证；
- 开发者与开源社区不对任何使用本软件所造成的直接或间接投资损失承担法律责任。
本项目基于 MIT License 协议发布，自由开源。