# 关键位止盈止损方案 & 移动保本开关 — 更新说明

**版本日期:** 2026-05-21  
**影响实例:** `crypto_monitor_binance`(币安),`crypto_monitor_gate`(Gate),`crypto_monitor_okx`(OKX)  
**共用库:** 仓库根目录 `key_sl_tp_lib.py`(计算逻辑),`fib_key_monitor_lib.py`(斐波 SL/TP 不变)

---

## 1. 变更摘要

| 项 | 变更前 | 变更后 |
|----|--------|--------|
| 箱体/收敛 SL/TP | 仅一种(标准突破) | 添加时可三选一 |
| 移动保本(关键位) | 自动单写死开启 | 添加时可勾选,**默认关闭** |
| 斐波 SL/TP | H/L 限价方案 | **不变**;仅增加移动保本开关 |
| 历史 `key_monitors` | 无新字段 | 缺字段视为 **标准方案 + 保本关** |

---

## 2. 数据库(`key_monitors` 新增列)

启动时自动 `ALTER TABLE`(已有库兼容):

| 字段 | 类型 | 默认 | 说明 |
|------|------|------|------|
| `sl_tp_mode` | TEXT | `standard` | `standard` / `box_1p5` / `trend_manual` |
| `manual_take_profit` | REAL | NULL | 仅 `trend_manual` 使用 |
| `breakeven_enabled` | INTEGER | `0` | 0=关,1=开 |

旧记录无上述列时,读取逻辑按 **`standard` + 保本关** 处理.

---

## 3. 三种止盈止损方案(仅箱体突破 / 收敛突破)

计划价 **E** = 确认 K(倒数第 1 根已闭合 5m)收盘价;**H** = \|上沿 − 下沿\|.  
自动开仓(币安/Gate)前仍须:**计划 RR(按 E)> `KEY_AUTO_MIN_PLANNED_RR`**(默认 1.5).

### 3.1 标准突破 `standard`(原逻辑)

| 方向 | 止损 SL | 止盈 TP |
|------|---------|---------|
| 多 | 突破 K 最低价 × (1 − `KEY_STOP_OUTSIDE_BREAKOUT_PCT`/100) | E + 1×H |
| 空 | 突破 K 最高价 × (1 + 外侧%) | E − 1×H |

默认外侧:**0.5%**(`KEY_STOP_OUTSIDE_BREAKOUT_PCT`).

### 3.2 箱体 1R / 止盈 1.5H `box_1p5`

以 **E 为当前价**,风险距离 = 1×H,止盈距离 = 1.5×H,**计划 RR 固定约 1.5:1**.

| 方向 | 止损 SL | 止盈 TP |
|------|---------|---------|
| 多 | E − H | E + 1.5×H |
| 空 | E + H | E − 1.5×H |

### 3.3 趋势单 + 自填止盈 `trend_manual`

| 方向 | 止损 SL | 止盈 TP |
|------|---------|---------|
| 多 | 突破 K 最低价 × (1 − `KEY_TREND_STOP_OUTSIDE_PCT`/100) | 添加时录入的 `manual_take_profit` |
| 空 | 突破 K 最高价 × (1 + 外侧%) | 同上 |

- 环境变量 **`KEY_TREND_STOP_OUTSIDE_PCT`**,默认 **1**(即 1%).
- 添加时校验:做多止盈 > 上沿;做空止盈 < 下沿.

---

## 4. 斐波回调 0.618 / 0.786

- **SL/TP**:仍为 `calc_fib_plan`(多:SL=L,TP=H;空:SL=H,TP=L),**无**三方案下拉.
- **移动保本**:添加时可勾选;成交写入 `order_monitors` 时带入该勾选状态(默认关).

---

## 5. 移动保本

| 场景 | 行为 |
|------|------|
| 关键位添加 | 复选框「移动保本」,**默认不勾选** |
| 箱体/收敛自动开仓成功 | `order_monitors.breakeven_enabled` = 添加时的选择 |
| 斐波限价成交后 | 同上 |
| 人工「实盘下单」 | **不变**:仍为表单勾选,默认仍可按原页面逻辑 |

触发参数仍用全局 `.env`:`BREAKEVEN_RR_TRIGGER`,`BREAKEVEN_STEP_R`,`BREAKEVEN_OFFSET_PCT`.

---

## 6. 前端(关键位添加表单)

在「上沿 / 下沿」后增加:

1. **止盈止损方案**(仅类型为箱体突破,收敛突破时显示)
2. **趋势单止盈价**(仅选「趋势单·自填止盈」时显示且必填)
3. **移动保本**(箱体/收敛/斐波显示;默认不勾)

活跃列表卡片展示:**方案**,**保本:开/关**.

---

## 7. 环境变量

```env
# 标准方案:突破 K 极值外侧 %
KEY_STOP_OUTSIDE_BREAKOUT_PCT=0.5

# 趋势单方案:突破 K 极值外侧 %
KEY_TREND_STOP_OUTSIDE_PCT=1
```

已写入各实例 `.env.example`(Binance / Gate / OKX).

---

## 8. 交易所差异

| 实例 | 箱体/收敛触发后 |
|------|----------------|
| **Binance / Gate** | 门控通过 → 按方案算 SL/TP → 市价开仓 → 挂交易所 TP/SL → 写入下单监控 |
| **OKX** | 门控通过 → **自动市价开仓**(与 Gate/Binance 相同;须 `LIVE_TRADING_ENABLED=true`) |

OKX 用户按推送中的计划价自行下单;斐波仍为限价 + 成交后挂 TP/SL(与原先一致).

---

## 9. 涉及文件清单

| 路径 | 说明 |
|------|------|
| `key_sl_tp_lib.py` | **新建**,三方案计算与文案 |
| `crypto_monitor_binance/app.py` | 门控触发,开仓,斐波,add_key |
| `crypto_monitor_binance/templates/index.html` | 表单 + JS + 列表展示 |
| `crypto_monitor_binance/.env.example` | `KEY_TREND_STOP_OUTSIDE_PCT` |
| `crypto_monitor_gate/app.py` | 同 Binance |
| `crypto_monitor_gate/templates/index.html` | 同 Binance |
| `crypto_monitor_gate/.env.example` | 同上 |
| `crypto_monitor_okx/app.py` | add_key,提醒文案,斐波保本 |
| `crypto_monitor_okx/templates/index.html` | 表单 + JS |
| `crypto_monitor_okx/.env.example` | 注释项 |

---

## 10. 部署与验证建议

1. `git pull` 后重启三个实例的 Flask 进程(会自动迁移 `key_monitors` 列).
2. 在 `.env` 中按需设置 `KEY_TREND_STOP_OUTSIDE_PCT`(不配则用默认 1).
3. **验证 Binance/Gate**
   - 添加箱体突破,选「箱体1R·止盈1.5H」,不勾保本 → 触发后微信应显示方案名,保本关,SL/TP 符合 E±H / E±1.5H.
   - 添加趋势单,填止盈,勾保本 → 成交后持仓卡片「移动保本:开」.
4. **验证 OKX**:门控通过且 RR 达标时应自动市价开仓;失败时微信说明 `exchange_failed` / `rr_insufficient`.
5. 旧关键位条目:列表应显示「方案:标准突破」「保本:关」(除非库中已有新字段值).

---

## 11. 代码入口(便于二次开发)

| 功能 | 符号 |
|------|------|
| 计划 SL/TP | `plan_key_sl_tp()` in `key_sl_tp_lib.py` |
| 按监控行计算 | `_key_plan_sl_tp_for_row()` in各 `app.py` |
| 添加关键位 | `add_key()` |
| 箱体/收敛轮询 | `check_key_monitors()`(三所共用自动开仓逻辑) |
| 斐波添加 | `_add_fib_key_monitor(..., breakeven_enabled=)` |
| 自动开仓写监控 | `_market_open_for_key_monitor(..., breakeven_enabled=)` |
