# 关键位突破监控

## 功能定位

- **GEMMA 漏斗**：仅作人工参考（结构/量/空间/阻力），不自动下单。
- **关键位突破监控**：在面板录入币种、方向、上沿/下沿与突破类型；系统按 **5m 闭合 K** 做硬门控，通过后推送企业微信，并可向 **gate_order_executor** 转发 **单一** 止盈/止损（无 A/B 双区间）。

逻辑自 `crypto_monitor_gate` 内化至本仓库，**不跨目录读对方数据库或代码**。

## 类型矩阵（2×2）

|  | 标准突破 | 趋势突破 |
|--|---------|---------|
| **箱体突破** | 止损：突破 K 极值外 **0.3%**；止盈：确认收盘 E **± 1×H** | 止损：突破 K 外 **1%**；止盈：**手填** |
| **收敛突破** | 同上 | 同上 |

`H = |上沿 − 下沿|`。不包含「箱体 1R·止盈 1.5H」方案。

## 5m 硬门控（与 gate 版一致）

- 突破 K / 确认 K：倒数第 2 / 第 1 根**已闭合** 5m
- 量能：突破 K 量 > 前 20 均量 × 1.3（可配置）
- 突破 K 实体幅度：0.03% ~ 0.5%
- 突破收盘越过录入上沿（多）或下沿（空）；确认 K 收盘仍在关键位外侧
- 日成交额排名：前 30（可配置）
- 计划 RR（按确认收盘 E）：须 **>** `key_monitor.min_planned_rr`（默认 1.5）

## 触发后

1. 企业微信：关键位突破确认（含硬条件与单一 SL/TP/RR）
2. 若 `key_monitor.forward_executor: true` 且执行器总开关开启：POST `/v1/signal`
3. 本条写入 `key_monitor_history`，从 `key_monitors` 删除（一次性，不重复触发）

## 配置（config.yaml · `key_monitor`）

| 字段 | 说明 |
|------|------|
| `enabled` | 是否启用轮询 |
| `poll_interval_seconds` | 轮询间隔（默认 5 秒） |
| `push_wecom` | 是否发企微 |
| `forward_executor` | 是否转发执行器 |
| `standard_stop_outside_pct` | 标准突破止损外扩（默认 0.3） |
| `trend_stop_outside_pct` | 趋势突破止损外扩（默认 1.0） |
| `min_planned_rr` | 最低计划 RR |
| `auto_scan_forward_executor` | 全市场 5m TRIGGER 是否仍转发（默认 **false**） |

## 复盘导出

登录后访问：

`/export/key_monitor_history.csv?days=30`

## 与全市场扫描的关系

- **策略寄存器 · 5m**：仍可作全市场「雷达」；企微文案已改为参考计划（非关键位录入）。
- **执行器**：默认仅 **关键位** 转发；勿与自动扫描 TRIGGER 重复开仓（`auto_scan_forward_executor: false`）。