通用自动化交易框架 v1

以下字段允许在计划层（PlanModule）按单覆盖，其他字段一律不可在运行时修改：

• take_profit_strategy_default → 止盈策略类型
• entry_style → 入场方式（左侧/右侧）；覆盖后在 M4 与 entry_timing.side 比对（见模块4）

position_classification（短线/中线）由模块4根据趋势阶段自动评分得出，不源自 SystemConfig，不在覆盖范围内。

{
  direction:           "涨势",
  stage:               "中期",
  trend_origin_price:  58000,
  extreme_price:       72000,
  pullback_depth:      0.26,        // (72000-68400)÷(72000-58000)
  favorable_factors:   ["EMA多头排列", "高点高低点结构完整", "H4收于隧道上轨"],
  unfavorable_factors: ["RSI接近超买70区间"]
}

direction == 震荡 → 整条流水线立即停止。
震荡时无明确趋势方向，顺势/逆势均无法判断做单方向，直接短路。

输出是一个列表，不是单个关键位。系统同时维护多个活跃关键位，每个关键位独立判断，信号模块对列表中每一个 ACTIVE 关键位逐一检测信号。关键位越多（例如多个支撑位叠加），信号模块触发的机会也越多，各自独立走流水线。

key_levels: [
  {
    level_id:   "a3f2c1d0-...",   // 首次识别时生成，跨图关联用
    price_low:  68200,            // 区间下沿（支撑底部）
    price_high: 68500,            // 区间上沿（支撑顶部）
    role:       "支撑",
    timeframes: ["M15","H1","H4"],// 三周期共振
    reasons:    ["前期低点密集区", "H1支撑压力互换", "整数关口68000附近"],
    estimated_rr: 5.7,
    status:     "ACTIVE"
  },
  {
    level_id:   "b7e9a2f1-...",   // 不同ID，不同关键位
    price_low:  65800,            // 第二个支撑区间，价格更低
    price_high: 66100,
    role:       "支撑",
    timeframes: ["M15"],          // 仅主周期识别
    reasons:    ["M15前低反弹点"],
    estimated_rr: 8.2,
    status:     "ACTIVE"
  }
  // 信号模块对以上两个关键位分别独立检测，各自走完整流水线
]

所有关键位过滤后列表为空 → 流水线停止。有多个关键位时，各自独立进入信号检测，任一产出合格信号即可继续。

做单方向推导：模块1 direction × SystemConfig trade_direction_policy  →  涨势+顺势=做多 · 跌势+顺势=做空 · 涨势+逆势=做空 · 跌势+逆势=做多
做单方向确定后只搜索对应方向形态：做多→看涨形态（启明星、看涨吞没、看涨Pinbar等）；做空→看跌形态

// 看涨Pinbar（单K，左侧）
{
  signal_type:          "Pinbar",
  signal_subtype:       "看涨Pinbar",
  trade_direction:      "做多",
  pattern_candle_count: 1,
  pattern_start_time:   "2024-05-15T06:15:00Z",
  pattern_end_time:     "2024-05-15T06:15:00Z",
  pattern_prices:       { low: 67820, high: 68650, close: 68350 },
  entry_timing:         { side: "左侧", attempt: 1, prev_times: [] }
}

// 启明星（3K，右侧）
{
  signal_type:          "启明星",
  signal_subtype:       "启明星",
  trade_direction:      "做多",
  pattern_candle_count: 3,
  pattern_start_time:   "2024-05-15T05:45:00Z",  // 第1根阴K
  pattern_end_time:     "2024-05-15T06:15:00Z",  // 第3根阳K收盘
  pattern_prices:       { low: 67750, high: 68620, close: 68400 },
  entry_timing: {
    side: "右侧", attempt: 2,
    prev_times: ["2024-05-15T04:15:00Z"]          // 第1次信号时间
  }
}

未识别到合格信号 → 流水线停止。

注：入场时机校验（entry_timing.side vs entry_style）已下沉至模块4，在计划层覆盖 entry_style 后执行，避免 M3 提前短路掉计划层本会接受的信号。

// 步骤①：市价试算
// entry=68350(close), stop=67820(low), RR=(71200-68350)÷(68350-67820)=5.4 ≥ 2.0 ✓ 通过，无需降级
{
  trade_direction:      "做多",
  take_profit_strategy: "关键位止盈",  // 先确定策略
  entry_price:          68350,         // ①市价入场：pattern_prices.close
  stop_loss_price:      67820,         // pattern_prices.low（形态最低价）
  t1_price:             71200,         // 关键位止盈→最近压力位近端
  risk_reward:          5.4,           // (71200-68350)÷(68350-67820)=5.4
  position_size:        0.15,          // 愿亏 80 USDT ÷ 530 点/BTC
  entry_mode:           "一次性",
  reasons: [
    "涨势中期，EMA多头排列",
    "三周期共振支撑区间 [68200, 68500]",
    "看涨Pinbar（左侧入场）"
  ]
}

// 步骤②示例（做多，假设t1=69200，步骤①RR不足时降级限价）
// entry=67820+(68350-67820)×50%=68085, stop=67820, RR=(69200-68085)÷(68085-67820)=4.2 ≥ 2.0 ✓
// entry_price=68085, order_type="限价单"

// 做空示例：pattern {high:68650, close:68200, low:67900}
// 步骤①：entry=68200(close), stop=68650(high), RR=(68200-65500)÷(68650-68200)=6.0 ≥ 2.0 ✓
// stop_loss_price=68650（形态最高价）, order_type="市价单"

两步入场价试算后盈亏比仍不足 / 理由不足 → 流水线停止。

entry_timing.side ≠ entry_style → 流水线停止，原因：信号时机不匹配（如系统限定右侧，但本次信号为左侧）。

{
  order_id:     "OKX-BTC-20240515-0042",
  order_type:   "市价单",              // 步骤①通过，市价成交
  status:       "FILLED",
  filled_size:  0.15,
  filled_price: 68350,
  cancel_reason: null
}

PENDING（已挂单未成交）
  ├─ FILLED（完全成交） → 用 filled_price 重校 RR；移交 PositionMonitor
  ├─ PARTIAL（部分成交）→ 立即为已成交数量（filled_size）挂 reduce-only 止损保护单；剩余继续等待；记录 partial_protection_order_id
  ├─ CANCELLED（撤单） → 记录原因，结束
  ├─ EXPIRED（超时） → 超出 order_cancel_timeout_hours（默认 4 小时）未成交，自动撤
  └─ REJECTED（交易所拒绝） → ① 重试一次（原参数）；② 仍失败 → 触发告警；若已有持仓则立即市价 reduce-only 平仓（emergency_flatten）；记录 reject_reason、failed_leg

{
  position_id:  "POS-20240515-0042",
  status:       "CLOSED",
  close_price:  71520,
  close_reason: "止盈",
  pnl:          317.2,   // (71520−68348)×0.1
  pnl_ratio:    6.0      // 317.2 ÷ ((68348−67820)×0.1) = 317.2÷52.8 ≈ 6.0
}

{
  symbol:         "BTCUSDT",
  trade_direction: "做多",
  signal_type:    "Pinbar",
  signal_subtype: "看涨Pinbar",
  key_level_tier: "三周期共振",   // len(timeframes)==3
  is_batch_entry: false,
  pnl:            317.2,
  pnl_ratio:      5.78,
  entry_slippage: -2,             // 计划 68350，实际 68348
  emotion_tag:    "平稳",
  watch_duration: 45              // 分钟
}

• 单笔记录（结构化字段，落库或日志）
• 周期性统计报告（胜率、盈亏比、关键位有效性、信号有效性等）