Repository navigation
Releases
Releases · oficcejo/alphapilot
OKX AlphaPilot v1.3.0 5秒盘中阶梯止盈、保本与动态追踪止损、OKX错误智能诊断
⚡ OKX AlphaPilot v1.3.0 - 5秒级盘中阶梯止盈、双重保本与追踪止损、OKX错误智能诊断
🎯 核心新特性与增强
-
5 秒级盘中独立阶梯主动止盈 (Realtime Ladder Take Profit):
- 长短周期解耦:将阶梯主动止盈彻底解耦于 1H/4H 等长周期信号计算。在持仓生命周期内,启动独立的 5 秒高频行情监听协程;
- 毫秒级主动锁盈:标的价格浮盈冲高达到第一档(+2.5%)或第二档(+4.5%)阈值时,无需等待整点 K 线收盘,5 秒内立即向交易所发起市价减仓报单;
- 单向棘轮锁定:第一档主动减仓至 65%,第二档主动减仓至 30%,严格锁死持仓上限,杜绝大幅浮盈后遭盘中剧烈反弹回撤侵蚀。
-
阶梯保本止损与高水位动态追踪止损双重保护 (Breakeven SL & High-Water Trailing Stop):
- 保本止损联动 (Breakeven SL):触发第一档止盈(锁定 35% 利润)后,剩余 65% 底仓的止损位自动上抬至
开仓均价 + 0.15% 交易成本安全垫。若行情随后剧烈崩盘,系统在 5 秒内市价平仓,彻底消灭“由大赢变大输”,确保整笔交易在数学期望上保本退出; - 高水位动态追踪止损 (High-Water Trailing Stop):触发第二档止盈(累计锁定 70% 利润,保留 30% 趋势底仓)后,系统自动激活高水位动态追踪,持续记录开仓后的峰值最高价。当价格从峰值回撤达到 2.5% 时,5 秒内市价清空剩余 30% 仓位,彻底锁死超级大趋势大单边行情的波段暴利。
- 保本止损联动 (Breakeven SL):触发第一档止盈(锁定 35% 利润)后,剩余 65% 底仓的止损位自动上抬至
-
OKX 响应智能诊断与错误翻译 (OKX Error Diagnostics & Parse Response):
- 错误深度透传:解决原
requests.raise_for_status()吞没底层 HTTP 400/401 响应体的问题,即使 OKX 接口返回 HTTP 错误,也能优先解析 JSON 中的业务错误码; - 中文智能排查指南:自动将
50123(API Key 无对应币种交易权限)、50113(系统时间戳不同步/NTP偏差)、50111(IP 不在白名单)、50102(API 凭证或密码不正确)、51000(可用保证金不足)等常见错误转换为通俗易懂的中文解决方案。
- 错误深度透传:解决原
-
自动交易异常自愈机制与前端交互提升:
- 15秒快速自愈:后台自动执行遇到网络或权限异常时,重试间隔自动切换为 15 秒(而非原先的 3600 秒长周期),用户在交易所后台调整配置后 15 秒内即可无感恢复;
- 前端状态诊断徽标:修复前端状态渲染异常,当自动执行出错时,信号面板展示醒目的红色「异常」徽章,并提供点击弹窗查看完整诊断建议;
- 审计日志完善:新增
auto_trade_error、breakeven_stop_loss_trigger等风控事件的全程审计跟踪。
-
全套自动化测试覆盖:
- 新增 OKX 错误解析与响应诊断单元测试;
- 39 项全套测试用例全部通过(39/39 PASSED)。
📦 桌面端配置说明(开箱即用)
- 解压与配置:
- 解压
AlphaPilot-v1.3.0-windows-x64.zip; - 在
AlphaPilot.exe同级目录下找到.env.example,复制或重命名为.env;
- 解压
- 填写 API 凭据:
- 用文本编辑器打开
.env,填入您的 OKX 实盘凭证(OKX_API_KEY、OKX_API_SECRET、OKX_API_PASSPHRASE)及风控参数:TRADING_MODE=live OKX_API_KEY=你的API_KEY OKX_API_SECRET=你的API_SECRET OKX_API_PASSPHRASE=你的API_PASSPHRASE OKX_API_BASE=https://www.okx.com OKX_SIMULATED=0 MAX_POSITION_PCT=0.80 DEFAULT_LEVERAGE=5 ENABLE_LADDER_TP=1 ENABLE_BREAKEVEN_SL=1 ENABLE_TRAILING_SL=1
- 用文本编辑器打开
- 双击启动:
- 双击运行
AlphaPilot.exe,原生桌面窗口自动加载。
- 双击运行
OKX AlphaPilot v1.2.0 Windows 桌面客户端与功能增强
⚡ OKX AlphaPilot v1.2.0 Windows 桌面客户端与功能增强
🎯 核心新特性与增强
- 实盘交易 - 自动执行运行状态与策略实时可视化:
- 运行中策略卡片:自动执行启动后,在「自动执行」详情顶部高亮展示当前正在后台运行的策略文件名(如
best_ETH-USDT-SWAP.json),鼠标悬停可查看完整策略绝对路径; - 运行参数对齐:面板实时展示本次自动任务绑定的标的、K线周期、杠杆倍数、本金及阶梯止盈启用状态;
- 配置面板动态联动:左侧交易配置策略标签旁动态显示
● 自动运行中: xxx徽标,并在自动执行期间锁定执行间隔输入框; - 运行状态总览条:在页面底部的「运行状态」顶部新增自动执行全局总览横幅与下次执行倒计时。
- 运行中策略卡片:自动执行启动后,在「自动执行」详情顶部高亮展示当前正在后台运行的策略文件名(如
- 阶梯止盈减仓与可用保证金校验逻辑修复:
- 彻底修复分批止盈/减仓订单误被可用资金门禁拦截的关键缺陷;
- 明确判定减仓/平仓操作为释放保证金而非占用资金,保障高浮盈时阶梯主动止盈与单向棘轮机制 100% 顺畅执行。
- 社区生态与交互体验提升:
- Web 总览页面横幅以及左侧侧边栏导航均新增 Discord 社区讨论交流 直达链接(
https://discord.gg/jk4mnW53gK),方便量化开发者即时交流策略与反馈建议。
- Web 总览页面横幅以及左侧侧边栏导航均新增 Discord 社区讨论交流 直达链接(
- 系统健壮性与排版对齐修复:
- 修复交易配置面板标题栏布局对齐问题;
- 全套回归测试(覆盖自适应 Harness、无前瞻偏差、方差守卫、自进化引擎与交易执行)全部 100% 通过(31/31 PASSED)。
📦 桌面端配置说明(压缩包已内置 .env.example 模板)
压缩包内已直接打包预置了配置文件模板 .env.example,开箱即用:
- 解压与重命名:
- 解压
AlphaPilot-v1.2.0-windows-x64.zip; - 在
AlphaPilot.exe同级目录下找到.env.example,将其直接复制或重命名为.env; - (注:若 Windows 隐藏了已知文件扩展名,直接把文件名改为
.env即可)。
- 解压
- 填写 API 凭证:
- 用文本编辑器(如记事本)打开
.env文件,填入您的 OKX 实盘 API Key、Secret、Passphrase:# 交易模式:live 为实盘,paper 为模拟 TRADING_MODE=live # OKX API 凭证 (需在 OKX 官网申请并开通交易权限) OKX_API_KEY=你的API_KEY OKX_API_SECRET=你的API_SECRET OKX_API_PASSPHRASE=你的API_PASSPHRASE OKX_API_BASE=https://www.okx.com OKX_SIMULATED=0 # 默认风控与杠杆设置 MAX_POSITION_PCT=0.80 DEFAULT_LEVERAGE=5 ENABLE_LADDER_TP=1
- 用文本编辑器(如记事本)打开
- 双击启动:
- 双击运行
AlphaPilot.exe,原生桌面窗口自动加载,进入首页即可看到已连接的账户资产与实盘交易控制面板。
- 双击运行
OKX AlphaPilot v1.1.0 Windows 桌面客户端与功能增强
⚡ OKX AlphaPilot v1.1.0 Windows 独立桌面客户端
🎯 核心新特性与增强
-
阶梯主动止盈与单向棘轮机制 (Ladder Take-Profit & One-Way Ratchet):
-
两级阶梯主动兑现:持仓无杠杆纯价差浮盈达到
$+2.5%$ 时,持仓上限自动降至$65%$ (主动兑现$35%$ 利润);浮盈达到$+4.5%$ 时,持仓上限降至$30%$ (累计兑现$70%$ 利润); -
30% 趋势底仓:剩余
$30%$ 底仓零心理压力跟随 1H 周期主信号冲高,直至大级别翻空反转; - 单向棘轮 (One-Way Ratchet):高位减仓后锁死持仓上限,坚决不反向回补追买,彻底杜绝震荡行情的双向磨损与反复手续费消耗;减仓订单自动解除反向保护挂单冲突。
-
两级阶梯主动兑现:持仓无杠杆纯价差浮盈达到
-
Web 交易控制台交互与提示升级:
- 新增
[✓] 阶梯主动止盈 (Ladder TP)独立开关与实时状态徽标显示; - 优化操作按钮文案与悬浮提示:明确区分
执行信号 (手动单次)与平仓 (应急全平),新增底部详细操作说明卡片; - 修复单币种账户模式下顶层
upl(未实现盈亏)与margin(保证金占用)返回空导致 Web 界面显示0.00的问题,新增活跃持仓实时交叉对齐兜底。
- 新增
-
数据管理与下载体验优化:
- 默认 K 线下载数量调增为
8000根(上限扩展至20000根); - 品种发现卡片中「快速下载」默认数量同步更新为
8000根; - 增加推荐提示:“推荐训练数据下载 6000-8000 根 K 线,推荐 15m 以上周期”。
- 默认 K 线下载数量调增为
-
行情与系统稳定性提升:
- 优化 WebSocket 行情连接状态与断线自动重试机制;
- 完善一键平仓参数与撤销挂单逻辑。
📦 桌面端配置说明(压缩包已内置 .env.example 模板)
压缩包内已直接打包预置了配置文件模板 .env.example,开箱即用:
- 解压与重命名:
- 解压
AlphaPilot-v1.1.0-windows-x64.zip; - 在
AlphaPilot.exe同级目录下找到.env.example,将其直接重命名为.env; - (注:若 Windows 隐藏了已知扩展名,直接把文件名改为
.env即可)。
- 解压
- 填写 API 凭证:
- 用文本编辑器(如记事本)打开
.env文件,填入您的 OKX 实盘 API Key、Secret、Passphrase:# 交易模式:live 为实盘,paper 为模拟 TRADING_MODE=live # OKX API 凭证 (需开通交易权限) OKX_API_KEY=你的API_KEY OKX_API_SECRET=你的API_SECRET OKX_API_PASSPHRASE=你的API_PASSPHRASE OKX_API_BASE=https://www.okx.com OKX_SIMULATED=0 # 默认最大仓位比例与杠杆 (可按需调整) MAX_POSITION_PCT=0.80 DEFAULT_LEVERAGE=5 ENABLE_LADDER_TP=1
- 用文本编辑器(如记事本)打开
- 双击启动:
- 双击运行
AlphaPilot.exe,原生桌面窗口自动加载,进入首页即可看到已连接的账户资产与实盘交易控制面板。
- 双击运行
OKX AlphaPilot v1.0.0 Windows 桌面客户端
⚡ OKX AlphaPilot v1.0.0 Windows 独立桌面客户端
📦 特性与说明
- 原生独立窗口:基于 Edge WebView2 渲染的高性能原生桌面客户端,无需依赖外部浏览器;
- 开箱即用绿色版:解压即可直接双击 \AlphaPilot.exe\ 运行,启动只需 1~2 秒;
- 全链路量化闭环:内置完整的因果特征挖掘、遗传强化学习、回测审计以及 OKX 实盘 Delta 调仓与 3% 交易所硬止损风控体系;
- 数据与策略持久化:本地自动管理 \strategies/\ 策略目录与 \data/\ K 线存储。