QuantDinger 实战：自托管 AI 交易操作系统 · 第 5 章 策略开发

QuantDinger 实战：自托管 AI 交易操作系统 · 第 5 章 策略开发

章节摘要：本章把前两章的原料组装成策略：数据层供 K 线（第 3 章），指标层供信号（第 4 章），Strategy API V2 提供骨架。5.1 节总览骨架——一个策略类按「数据到达 → 产生 intent 意图 → sizing 定仓位 → risk 校验 → 下单 → 运行时钩子」的生命周期组织，intent 表达「想做什么」而非「下哪张单」，这是回测与实盘共用同一份策略代码的关键。5.2 节展开前两环：intent 的四种语义（开、平、调仓、观望）与 sizing 的三档进阶（固定手数、波动率反比、波动率目标仓位），并给出完整可改的示例。5.3 节收尾两环：单笔与组合两层风控如何拦截 intent，运行时钩子（开盘前、收盘后、定时）承担什么，以及状态最小化与幂等两条纪律。本章策略将在第 6 章进回测、第 7 章进 paper，同一份代码走完全程。

学习目标

• 按 Strategy API V2 的生命周期复述一个 intent 从产生到成交的路径。
• 区分 intent 与订单：为什么「表达意图」是回测实盘一致性的支点。
• 实现三档 sizing：固定手数、波动率反比、波动率目标，并说出各自的适用阶段。
• 配置单笔与组合两层风控，说明拦截发生时的降级次序。
• 用运行时钩子安放对账、日报与数据预热，而不是塞进交易主循环。
• 践行状态最小化与幂等两条策略纪律。

核心概念速览

Strategy API V2 生命周期（接口写法示意，以官方文档为准）

 ┌──────────── 数据到达（第 3 章 K 线 / 第 4 章指标）────────────┐
 │                                                              ▼
 │   ┌──────────────┐   ┌──────────────┐   ┌──────────────┐   ┌──────────────┐
 │   │ intent 产生    │──▶│ sizing 定仓   │──▶│ risk 两层校验 │──▶│ 订单（回测/   │
 │   │ 开/平/调仓/观望 │   │ 三档进阶      │   │ 单笔+组合     │   │ paper/实盘）  │
 │   └──────────────┘   └──────────────┘   └──────────────┘   └──────────────┘
 │         ▲                                       │拦截→降级或丢弃
 │   ┌─────┴───────┬───────────────┬───────────────┴──────────────────────────┐
 │   │ 开盘前钩子    │ 定时钩子        │ 收盘后钩子：对账/日报/状态落盘             │
 │   │ 数据预热      │ 仓位再平衡      │                                          │
 │   └─────────────┴───────────────┴──────────────────────────────────────────┘
​

一句话金句：策略只表达意图，成交交给运行时——意图是回测与实盘唯一能共享的东西。

（文字流程图）K 线到达 ──▶ 指标更新 ──▶ intent ──▶ sizing ──▶ risk 校验 ──▶ 订单或拦截 ──▶ 钩子收尾。

子章节导航

• 第 5.1 节《Strategy API V2 总览》：策略类骨架、生命周期、intent 与订单的分界、状态最小化。
• 第 5.2 节《intents 与 sizing》：四种意图语义、三档仓位算法与完整示例。
• 第 5.3 节《risk 与运行时》：两层风控的拦截次序、三类运行时钩子、幂等与恢复。

三节按数据流顺序读：先有骨架（5.1），再填前半段（5.2），最后收后半段（5.3）。本章产物 squeeze_breakout.py 将在第 6 章直接进回测。

子章节之间的逻辑关系

┌──────────────────┐  骨架定了前后环    ┌──────────────────┐  前环产物待校验   ┌──────────────────┐
│ 5.1 API 总览      │ ──────────────▶ │ 5.2 intents/sizing│ ──────────────▶ │ 5.3 risk/运行时   │
│ 生命周期+纪律     │                  │ 意图与仓位        │                  │ 拦截与收尾        │
└────────┬─────────┘                  └────────┬─────────┘                  └────────┬─────────┘
         │ 第 4 章指标是 intent 的来源            │ sizing 三档的超参进第 6 章             │ 风控参数同样要进
         ▼                                       ▼                                      ▼
   第 4.2 节收缩事件                       第 6 章回测与 walk-forward                  第 6.1 节回测报告
​

前置知识与后续延伸

• 前置：第 3 章数据层（K 线从哪来、质量如何）、第 4 章指标（4.2 节的收缩事件是本章示例策略的触发条件）、第 2 章 v5 架构（策略跑在 trading-worker 的长循环里，不跑在 HTTP 进程里）。
• 后续：第 6 章回测与实验（本章策略的第一个考场）、第 7 章 paper（第二个考场）。
• 延伸阅读：《量化投资方法论》第 13 章《仓位管理：ATR、凯利与风险预算》（sizing 三档的方法论根基）与第 14 章《风险控制与绩效度量》（两层风控的度量口径）。

免责声明：本书仅供研究与教育用途，不构成任何投资建议；实盘交易风险自担，建议长期停留在 paper 模式。