增加关键位人工输入

onchain_scout_gate/docs/关键位突破监控说明.md

@@ -0,0 +1,56 @@
+# 关键位突破监控
+
+## 功能定位
+
+- **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`）。

onchain_scout_gate/docs/多执行器与信号转发归档.md

@@ -8,7 +8,7 @@
 
 | 目标 | 说明 |
 |------|------|
-| **一套信号** | 扫描端在企微突破推送成功后，构造 **一份** 方案 A 止盈/止损 payload |
+| **一套信号** | **关键位** 5m 门控通过后，按录入方案构造 **一份** 单一止盈/止损 payload 并广播 |
 | **多套账户** | 可向多个执行器进程广播，各绑不同 Gate API，用于盈亏比等规则的对照实验 |
 | **规则在执行器** | 最低盈亏比、仓位、移动保本等 **不在扫描端** 区分，由各执行器自行配置 |
 | **统一 Webhook** | 全系统使用 **同一个** `webhook_secret` |
@@ -66,10 +66,11 @@ flowchart LR
 
 ### 3.4 转发逻辑
 
-1. `build_order_executor_payload()` 仍只构建 **一次**（与企微方案 A 一致）。
-2. 对 `enabled=true` 的列表项 **并行** `POST {base_url}/v1/signal`。
-3. **同一 `signal_id`** 发往所有目标。
-4. 部分失败只记日志，不阻断其他执行器。
+1. **关键位**：`build_key_executor_payload()` 使用录入上下沿与标准/趋势规则计算的 SL/TP（确认收盘 E 为 `reference_price`）。
+2. **全市场 TRIGGER**：默认 **不** 转发（`key_monitor.auto_scan_forward_executor: false`）；若开启则仍用扫描箱体 metrics 构造 payload。
+3. 对 `enabled=true` 的列表项 **并行** `POST {base_url}/v1/signal`。
+4. **同一 `signal_id`** 发往所有目标。
+5. 部分失败只记日志，不阻断其他执行器。
 
 ### 3.5 Web 面板