OKX 2PA Agent (Rust 高性能版)

1. 项目简介 #

OKX 2PA Agent (Rust 版) 专为加密货币及 OKX 衍生品量化交易者设计。系统通过纯 Rust 重构，摆脱了传统 Python/Node.js 量化项目复杂的环境依赖与高内存占用，运行内存小于 20MB，具备毫秒级指标计算与网络响应能力。

系统通过 rust-embed 将现代化 Web 控制台、静态资源与提示词工程规则库完全内嵌至单一二进制文件。无论是 Windows 单击 .exe 还是 Linux 服务器部署，均可实现真正的即开即用、零运行时依赖。

2. 核心亮点与架构特性 #

3. 实机界面全景展示 (图文并茂) #

以下截图均在已部署节点 https://2pa.zhongdu.net 上实机截取。点击任意图片可展开高清画廊视图。

https://2pa.zhongdu.net - 2PA 价格行为控制台

2PA 经典模式

点击查看高清原图

图 1：2PA 价格行为主界面 —— 包含实时 K 线行情图表、EMA20 / ATR14 动态指标、两阶段决策面板及顶部工具栏。

https://2pa.zhongdu.net - 🐕 遛狗系统 (SMA 14/170)

🐕 遛狗系统

点击查看高清原图

图 2：🐕 遛狗系统模式 —— 实时绘制 14 SMA（橙色狗绳） 与 170 SMA（蓝色主人均线），并动态展示双均线数值图例。

https://2pa.zhongdu.net - 📐 合约规格与张数换算

📐 合约换算器

点击查看高清原图

图 3：📐 合约换算工作台 —— 包含热门加密货币/美股/贵金属合约面值速查、实时市价、1张折合USDT价值及双向智能下单换算。

账户资产与一键全撤 账户面板

自动交易时段与策略调度 🤖 自动交易

图 4-5：左侧为账户总览（总权益、未实现盈亏、仓位列表与一键全撤）；右侧为自动交易调度器（时区过滤器、新 K 线闭合扫描与执行开关）。

系统配置向导 (Web Setup Wizard)

⚙️ 系统配置

点击查看高清原图

图 6：Web 智能配置向导 —— 支持随时修改大模型 API Key、模型名称、OKX 密钥并一键持久化至根目录 .env 文件。

4. 核心交易系统深度解析 #

📊 系统一：Al Brooks 2PA 经典价格行为系统

Al Brooks 价格行为学（Price Action）是华尔街专业日内交易员的核心理论之一。本系统通过纯 Rust 算法引擎结合 LLM，实现了经典形态的严谨几何提取：

• 市场八态周期识别：精确诊断当前市场处于 Spike（爆发突破）、Tight Channel（紧密通道）、Broad Channel（宽幅通道）还是 Trading Range（震荡交易区间）。
• 几何结构引擎：原生提取 EMA20 支撑与阻力位、二次入场信号（H2 做多 / L2 做空）、楔形三推反转（Wedge）、突破回踩测试（Breakout Test）及跳空缺口（Gap Bar）。
• 交易者方程（Trader's Equation）：严格要求入场胜率与盈亏比满足：
  胜率 × 止盈点数 > (1 - 胜率) × 止损点数，杜绝低盈亏比追涨杀跌。

🐕 系统二：遛狗系统 (SMA 14/170 均线偏离与回归)

遛狗系统是一种基于均值回归与趋势延续物理动力学的量化系统，使用 14 SMA 与 170 SMA 两条核心均线构建物理隐喻：

遛狗系统两大核心交易战法：

1. 战法一：偏离极限衰竭回归（Mean-Reversion）

   当小狗过度远离主人（偏离度 Dev% 达到统计极值）且动能衰竭拐头（跌破 14 均线 / 出现长影线 Pinbar 或吞没形态）时，绳索拉力迫使其发生向主人均线的快速回弹。止盈目标 TP2 强制锚定 SMA 170 均线！

2. 战法二：170 主人均线回踩顺势（Trend-Continuation）

   在平缓趋势运行中，当价格回踩 170 主人均线获得强支撑或阻力确认，且收出同向反转信号棒时，顺应长期大趋势跟进入场。

🤖 LLM 两阶段智能推理引擎

系统创新采用两阶段隔离推理架构（Two-Stage Pipeline），彻底解决单次提示词中大模型“既当裁判又当运动员”产生的幻觉与自圆其说问题：

5. 快速安装与部署指南 #

方式一：下载 Release 独立单文件运行（推荐新手）

单文件独立发布版已通过 rust-embed 将所有网页资源和 Prompt 规则内嵌，无需安装 Rust、Python 或 Node.js：

1. 前往 GitHub Releases 下载对应系统的最新发行包（例如 okx-2pa-agent-v0.3.0-windows-x64.zip 或 Linux 二进制）。
2. 解压后直接双击运行 okx-2pa-agent.exe（或 Linux 执行 ./okx-2pa-agent）。
3. 首次启动未检测到 .env 时，程序会自动弹出系统默认浏览器打开配置向导，填入 API 密钥保存后即可立即开始使用！

方式二：Docker & Docker Compose 极速部署（推荐服务器）

项目根目录自带生产级多阶段构建 Dockerfile 与 docker-compose.yml：

services:
  okx-2pa-agent:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: okx-2pa-agent
    restart: unless-stopped
    ports:
      - "8088:8088"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./.env:/app/.env
      - ./config:/app/config
      - ./records:/app/records

通过以下命令即可一键在后台启动容器化服务：

# 1. 启动容器并在后台运行
docker compose up -d

# 2. 查看实时运行日志
docker compose logs -f

# 3. 停止并释放容器
docker compose down

方式三：从 Rust 源码编译（开发者模式）

若需要二次开发或自定义修改，请确保已安装 Rust 工具链（1.75+）：

# 1. 克隆代码仓库
git clone https://github.com/oficcejo/2pa-agent-rust.git
cd 2pa-agent-rust

# 2. 一键快速启动（开发调试）
.\start.bat

# 3. 或者编译生产级单文件 Release 可执行程序
cargo build --release
# 编译产物位于: target\release\okx-2pa-agent.exe

# 1. 克隆代码仓库
git clone https://github.com/oficcejo/2pa-agent-rust.git
cd 2pa-agent-rust

# 2. 赋予启动脚本权限并执行
chmod +x start.sh
./start.sh

# 3. 或者使用 Makefile 一键编译发布
make release

一键启动脚本说明

6. 详细配置说明手册 #

⚙️ 方式一：在 Web 页面中随时配置（免改 .env，官方强烈推荐）

系统内置了图形化 Web 环境配置向导，无需登录服务器命令行或手动创建 .env 文件，支持在网页端直接配置并即时热生效：

Web 页面配置操作步骤分解：

1. 打开配置窗口：访问 Web 控制台（如 http://127.0.0.1:8088 或在线节点 https://2pa.zhongdu.net），点击顶部导航栏右上角「⚙️ 系统配置」按钮。
2. 配置交易系统：选择默认活跃系统 —— 2PA 价格行为系统（Al Brooks 八态）或 🐕 遛狗系统（SMA 14/170 均线偏离回归）。
3. 配置大语言模型 (LLM)：
   • API Key：填入大模型 API Key（支持 DeepSeek 官方、MiniMax、兼容 OpenAI 接口）。
   • 接口地址 (Base URL)：默认 https://api.deepseek.com（使用其他服务商时填写对应兼容端点）。
   • 模型名称 (Model)：默认 deepseek-v4-flash（高频交易推荐 MiniMax-M2.7-highspeed 或 deepseek-v4-flash）。
   • 思考模式 (Thinking)：默认关闭（推荐）。高频交易关闭思考模式可缩短 70% 响应时间。
4. 配置 OKX 交易所凭证 (选填，自动下单必须)：
   • 填入 OKX 的 API Key、Secret Key 及 Passphrase 密码口令。
   • 交易环境选择：首次测试务必选择 模拟盘 (Demo Trading)，确认策略稳定后再切换实盘。
5. 配置默认下单与风控参数 (核心)：
   • 默认下单量：现货填写基础币数（如 0.05 BTC）；合约填写张数（如 1 张 BTC、3 张 ETH，可参考下方换算方法）。
   • 默认杠杆：合约杠杆倍数（推荐默认 3x 稳健运行）。
   • 保证金模式：选择 全仓 (Cross)、逐仓 (Isolated) 或 普通现货 (Cash)。
6. 保存并生效：点击底部「💾 保存配置到 .env 并生效」按钮，弹窗提示保存成功后即可立即开始交易！

📊 现货 (SPOT) 与 永续合约 (SWAP) 配置对比与实战举例

在 OKX 交易体系中，现货（SPOT） 与 永续合约（SWAP） 的下单单位、杠杆机制与资金占用存在本质差异。在 Web 配置向导或 .env 中设置时请务必注意区分：

💡 实战配置案例演示：

# 现货 BTC 配置
OKX_DEFAULT_ORDER_SIZE=0.005       # 基础币数量 (0.005 BTC 约合 475 USDT)
OKX_DEFAULT_LEVERAGE=1             # 现货不加杠杆
OKX_TRADE_MODE=cash                # 普通现货模式 (或 cross)

# 永续合约 BTC 配置
OKX_DEFAULT_ORDER_SIZE=1           # 下单 1 张 (对应 0.01 BTC = 965 USDT 仓位)
OKX_DEFAULT_LEVERAGE=3             # 3倍杠杆 (仅需 321.67 USDT 保证金)
OKX_TRADE_MODE=cross               # 全仓合约模式

# 永续合约 ETH 配置
OKX_DEFAULT_ORDER_SIZE=3           # 下单 3 张 (对应 0.3 ETH = 840 USDT 仓位)
OKX_DEFAULT_LEVERAGE=3             # 3倍杠杆
OKX_TRADE_MODE=cross               # 全仓合约模式

# 永续合约 DOGE 配置
OKX_DEFAULT_ORDER_SIZE=4           # 下单 4 张 (对应 4000 DOGE = 1000 USDT 仓位)
OKX_DEFAULT_LEVERAGE=3             # 3倍杠杆 (仅需 333.33 USDT 保证金)
OKX_TRADE_MODE=cross               # 全仓合约模式

.env 环境变量全量参数速查表

系统参数文件 config/settings.json

除了环境变量，高级用户可在 config/settings.json 中精细调整模型重试与数据加载策略：

{
  "general": {
    "analysis_bar_count": 100,             // 单次分析向模型喂送的历史 K 线根数
    "decision_confidence_threshold": 40,   // 执行入场的最低信心阈值 (0-100)
    "decision_stance": "balanced",         // 决策立场: conservative / balanced / aggressive
    "enable_next_bar_prediction": false,
    "structure_flip_cooldown_bars": 3
  },
  "validation": {
    "normalization_mode": "lenient",       // JSON 解析模式: strict 或 lenient (宽容自愈)
    "retry_enabled": true,                 // 模型输出异常时自动重试
    "retry_max": 3                         // 最大重试次数
  }
}

安全与风控最佳实践

7. 功能操作与控制台指南 #

1. 行情图表与双均线动态叠加

进入 Web 控制台主工作区，可在顶部工具栏灵活配置行情展示：

• 产品类型：切换 SPOT（现货）或 SWAP（永续合约 / TradFi 美股黄金）。
• 交易品种：支持输入任意 OKX 支持的币对（如 BTC-USDT、ETH-USDT、SOL-USDT、DOGE-USDT 等），支持快捷下拉筛选。
• K 线周期：支持 1m、5m、15m、30m、1h、4h、1d 级别。
• 交易系统动态图表：
  • 选择 2PA 价格行为 时：图表自动计算并叠加 EMA 20（蓝线） 与下方的 ATR 14 真实波幅。
  • 选择 🐕 遛狗系统 时：图表自动计算并叠加 SMA 14（橙色狗绳） 与 SMA 170（蓝色主人中枢），图例实时显示当前双均线数值。

2. AI 决策面板与历史记录

点击右上角「运行 AI 分析」按钮，系统立即抓取最新 100 根 K 线与指标快照，启动两阶段 LLM 推理：

• 方向与置信度：显示 BUY（多） / SELL（空） / WAIT（观望） 及大模型打出的胜率估计与信心打分。
• 点位规划：清晰给出建议挂单类型（Limit / Stop）、精确入场价、保护性止损价、TP1 保守止盈目标、TP2 延伸止盈目标。
• 判断依据：展示大模型输出的完整 Al Brooks 价格行为分析或遛狗均线偏离度逻辑推导。
• 分析后按风控执行：勾选此项后，若决策满足置信度与风控门槛，系统将自动向 OKX 发送附带止盈止损的原子交易委托。

3. 账户面板与一键全撤

切换至「账户」标签页，系统实时从 OKX 抓取账户全貌：

• 核心 KPI：账户总权益（USD）、可用权益、未实现盈亏（UPL）。
• 总权益曲线：实时绘制账户资金随时间波动的历史净值走势折线图。
• 资产与仓位明细：列出各币种可用余额与冻结量、当前持仓品种、持仓数量、开仓均价、标记价格及浮动盈亏。
• 挂单管理与一键全撤：清晰展示当前未成交的限价单与条件触发单，提供「一键全撤」按钮秒级清空所有历史残留委托。

4. 📐 合约换算方法与张数计算（深入解析）

OKX 永续合约（SWAP）与传统现货最大的区别在于：必须以「张数（Contracts）」为最小委托单位进行下单。为了帮助交易者精确控制仓位与杠杆风险，系统总结了以下完整的合约换算方法与公式体系：

🔥 OKX 热门合约 1 张面值与价值对照表：

为方便交易者即时测算，我们在下方内置了实时合约换算演示工作台，您可以直接输入数字进行模拟计算：

5. 🤖 自动交易调度与多时段管理

在「自动交易」标签页中，用户可开启后台无缝自动化策略：

• 闭合 K 线触发：系统以后台轮询心跳持续监控 OKX 最新的 K 线状态，仅在 当前周期的 K 线正式收盘闭合 时触发一次两阶段分析，杜绝未收线假信号干扰。
• 多时区时段过滤器（Session Filter）：
  • always：全天候 24/7 不间断运行（适合加密货币）。
  • us_regular：美股常规交易时段（纽约时间 09:30 - 16:00）。
  • us_open：美股开盘黄金窗口（纽约时间 09:30 - 11:30）。
  • london：伦敦欧洲时段（08:00 - 16:30 UTC）。
  • asia：亚洲时段（00:00 - 08:00 UTC）。
  • custom：自定义时区、启闭时间与指定星期编号（周一=0 至 周日=6）。

6. 「撤旧换新」防堆积挂单机制

在自动化高频量化中，若行情发生剧烈波动，历史未成交的旧挂单若未及时清理，极易在后续意外成交造成严重风险。

OKX 2PA Agent 内置了「撤旧换新 (Cancel-Replace)」原子风控机制：在发出新的开仓委托前，交易引擎会自动识别并撤销当前交易品种此前所有的未成交挂单与突破单，保证账户在交易所中永远只有唯一最新、最优的有效挂单！

8. 常见问题与排错指南 (FAQ) #

9. 开发者与 REST API 参考 #

系统内置了完整的 RESTful API，方便第三方程序、监控脚本或外部系统进行集成控制：

自动化测试套件 (Test Suite)

项目内置了 19 项端到端单元测试与集成测试，覆盖算法指标、两阶段 Prompt 组装、JSON 自愈修复与时段过滤器：

# 运行全部 19 项单元测试
cargo test -- --nocapture

测试全部通过，保证了在极端行情与网络波动下的高可用性与数学一致性。

10. 社区交流与免责声明 #

欢迎加入官方社区交流群，与量化开发者及交易员共同探讨 Al Brooks 价格行为学策略、遛狗均线回归动力学与实盘心得：

本项目基于 MIT License 许可协议开源发布。