quickstart.md 2.4 KB

Quickstart 测试指南:多平台 Delta 中性控制平面

前置条件

  1. 已配置至少 2 个 Pacifica 账户与 1 个 Aster 账户,所有凭证通过代理可用。
  2. 行情服务已连接 WebSocket,且 HTTP 备份正常。
  3. 策略模块启用 Dry-run 模式以便验证。

场景 1:资金利用率低于 50% 自动补仓

  1. 启动控制平面与行情服务。
  2. 将 pacifica-1 账户的可用余额调高,使利用率 <0.5。
  3. 观察系统在 8 秒内生成限价买单,并通过对冲维持 Delta≈0。
  4. 验证仪表盘显示利用率回到 50% 附近,并记录 MonitoringEvent

验证

  • 日志中出现 utilization-low 告警与后续恢复记录。
  • HedgeExecution 结果成功且 Delta 偏差 < ±0.0005 BTC。

场景 2:行情主源失效 10 秒内回退

  1. 手动断开 pacifica WebSocket 连接。
  2. 确认 2 秒内触发 market-data-failover 事件,切换到 HTTP 拉取。
  3. 在 10 秒内恢复交易,并打印合成价格或备用价格。
  4. 重新连接 WebSocket,确保系统回归正常状态。

验证

  • 日志出现 market-data-failover-complete,用时 < 10000ms。
  • 交易模块暂停新订单期间未引发额外对冲。

场景 3:Delta 偏离自动对冲

  1. 人为向 pacifica-1 下达市价单,造成 Delta 偏离 0.001 BTC。
  2. 控制平面应立即生成跨账户对冲指令,将 Delta 拉回 0。
  3. 记录 HedgeExecution 成功,duration < 30 秒。
  4. 查看仪表盘,确认利用率未越界且止损策略保持有效。

验证

  • HedgeExecution 详情包含两笔对冲订单全部成交。
  • 监控事件记录 delta-breach 与恢复信息。

场景 4:策略模块沙箱验证

  1. 以 Dry-run 模式启动新策略模块(例如资金费率套利)。
  2. 向系统推送模拟资金费率信号,生成配对多空订单但仅写入虚拟撮合器。
  3. 验证模拟订单与真实行情一致,并在 quickstart 中记录收益计算。
  4. 完成后查看 Dry-run 报告与日志,确认无真实下单行为。

验证

  • 日志标记 sandbox-execution,订单状态保持虚拟。
  • Profit-after-fee 计算结果记录在报告中。

清理步骤

  1. 恢复所有代理与行情连接。
  2. 取消 Dry-run 模式并关闭策略模块。
  3. 将测试中下发的订单撤销,恢复账户余额。
  4. 汇总日志、监控事件以备审计或进一步分析。