# onchain_scout_gate 更新说明

## 2026-05-22 · 关键位突破监控（定稿）

### 新增

- **面板「关键位突破监控」**（位于 GEMMA 漏斗下方）：人工录入币种、方向、上沿/下沿。
- **结构类型**：箱体突破 / 收敛突破；各支持 **标准突破**、**趋势突破**（已移除「箱体 1R·止盈 1.5H」）。
- **止盈止损规则**：
  - 标准：突破 K 极值外 **0.3%** 止损，止盈 **1× 箱体高度 H**
  - 趋势：突破 K 极值外 **1%** 止损，止盈 **手填**
- **5m 硬门控**：量能、突破幅度、破线、二根确认、日成交额 Top30、计划 RR > 1.5（均可 `config.yaml` → `key_monitor` 调整）。
- **触发后**：企业微信（单一 SL/TP/RR 文案）+ 可选 `POST /v1/signal` 转发执行器；结案进 `key_monitor_history`。
- **复盘导出**：`/export/key_monitor_history.csv?days=30`（需登录）。

### 调整

- **执行器转发**：默认仅 **关键位** 触发转发（`key_monitor.forward_executor`）；全市场 5m TRIGGER 默认 **不再** 转发（`monitor` 侧 `key_monitor.auto_scan_forward_executor: false`）。
- **企微 · 自动扫描突破**：去掉 A/B 双区间，改为参考计划说明；正式下单以关键位录入为准。
- **执行器 payload**：关键位使用录入方案计算的 **单一** `take_profit` / `stop_loss` / `reference_price`（确认收盘 E）。

### 数据

- SQLite 新表：`key_monitors`、`key_monitor_history`（与 `crypto_monitor` 独立，不共用对方库）。

### 配置示例

见 `config.example.yaml` 中 `key_monitor` 段；详见 `docs/关键位突破监控说明.md`。

### 升级注意

1. 拉代码后重启 `onchain-scout`（或 PM2），启动时会自动建表。
2. 在面板录入关键位前，确认 **下单执行器** 总开关、Webhook 密钥与各执行器 `security.webhook_secret` 一致。
3. 若仅需关键位半自动，请保持 `auto_scan_forward_executor: false`。