📚 课程目录第1章课程导入

1. 课程导入

在量化交易与程序化策略开发中，最危险的时刻往往不是策略逻辑写错，而是“回测很美、模拟能跑、实盘一上就亏”的环境落差。Paper Trading（模拟盘/纸上交易）与实盘环境切换，正是连接研究世界与真实资金世界的那道闸门。本课程的目标，不是教你写一个能下单的脚本，而是让你建立一套可验证、可回滚、可监控的环境切换工程能力。

一、学习目标：从“能跑”到“敢上”

完成本课程后，你应当具备以下四层能力：

认知层：理解Paper Trading与实盘在撮合机制、滑点、手续费、流动性、延迟、风控约束上的本质差异，而不是把模拟盘当成“免费实盘”。
工程层：能够用同一套策略代码，通过配置切换Paper与Live环境，避免复制粘贴导致的逻辑分叉。
验证层：掌握从回测→Paper→小资金实盘→全量实盘的渐进式验证流程，并定义每一关的通过标准。
运维层：能够设计环境切换的检查清单、熔断条件、日志审计与回滚方案，在异常发生时快速降级。

核心判断标准只有一句话：当Paper环境的成交结果与实盘环境的偏差稳定在可解释范围内时，才具备切换资格。偏差不可解释，就不要切。

二、核心价值：为什么必须专门学“切换”

很多开发者把Paper Trading当作“跑通接口”的测试，这是最大的误区。Paper环境的价值在于用零资金成本暴露策略在真实市场微结构下的行为。而实盘环境切换的价值，在于把这种暴露转化为可控的资金风险。

具体来说，本课程要解决三类高频事故：

接口语义漂移：Paper返回“已成交”，实盘返回“部分成交”或“已拒绝”，策略状态机直接错乱。
参数未同步：Paper用taker费率、实盘用maker返佣，或滑点模型不同，导致盈亏归因完全失真。
风控缺失：Paper没有仓位上限和日内亏损熔断，实盘一开就突破风险敞口。

本课程贯穿一个工程原则：环境是配置，不是代码分支。策略逻辑只写一份，环境差异全部下沉到配置层与适配层。

三、整体课程框架：30章的四段式路线

课程按“认知→搭建→验证→切换→运维”推进，可归纳为四个阶段：

阶段	核心任务	关键产出	典型章节
认知与建模	理解Paper与实盘差异，建立环境抽象	环境差异清单、配置Schema	第1–6章
工程搭建	统一策略入口、适配器、订单状态机	可切换的策略骨架	第7–14章
验证与压测	Paper回放、偏差分析、故障注入	偏差报告、通过标准	第15–22章
切换与运维	灰度切量、熔断回滚、监控告警	切换SOP、回滚预案	第23–30章

四、实战路线图：一次可复现的环境切换

下面这张图展示了从策略代码到实盘资金的完整信号与决策路径。注意：Paper与Live共享同一策略核心，差异只在适配层与风控层。

对应的最小配置骨架如下，环境差异全部收敛到env字段：

{
  "env": "paper",
  "broker": {
    "paper": { "endpoint": "https://paper.api.local", "slippage_bps": 2, "fee_bps": 1 },
    "live":  { "endpoint": "https://live.api.local",  "slippage_bps": 0, "fee_bps": 2 }
  },
  "risk": {
    "max_position_pct": 0.2,
    "daily_loss_limit_pct": 0.03,
    "auto_downgrade": true
  }
}

五、常见误区与复盘要点

误区一：Paper成交即实盘成交。Paper通常按最新价全额成交，实盘可能部分成交、排队甚至拒单。必须用订单状态机统一处理PARTIALLY_FILLED与REJECTED。
误区二：切换只改URL。费率、滑点、最小下单量、交易时段、限频规则都可能不同，必须逐项核对。
误区三：没有回滚预案。切换后一旦偏差超阈值，必须能在一分钟内降级回Paper，而不是手动改代码。

建议在每章结束后做一次“偏差复盘”：记录Paper与Live在同一信号下的成交价、成交量、手续费与最终盈亏，计算偏差率。偏差率持续低于你设定的阈值（例如5%），才进入下一阶段。这套复盘习惯，比任何单一策略都更能保护你的资金。

现在，你已经有了本课程的地图：一份策略核心、两个适配器、一层风控、一套监控。接下来要做的，是把这张图变成可运行、可验证、可回滚的工程系统。