bot增加保本

crypto_monitor_gate_bot/趋势回调策略说明.md

@@ -27,6 +27,12 @@
 
 ## 3. 执行流程（时间顺序）
 
+### 3.0 列表时间窗（交易记录 / 计划历史）
+
+- **交易记录**、**计划历史**（含预览快照）列表与 **交易记录 CSV 导出** 支持 **UTC** 时间筛选（默认 UTC 当日；可选近 24h、近 7d、自定义起止）。
+- 查询参数：`win_preset`（`utc_today` / `utc_last24h` / `utc_last7d` / `custom`）、自定义时另传 `from_utc`、`to_utc`。
+- **统计分析**页仍按北京时间 `TRADING_DAY_RESET_HOUR` 切日，不受列表窗影响。
+
 ### 3.1 预览阶段（不下单）
 
 1. **风控**：与「机器人下单监控」**互斥**——存在活跃机器人持仓或运行中趋势计划时，不可生成预览。
@@ -41,6 +47,7 @@
 5. 再次校验：预览未过期；**当前可用余额**与预览快照相对偏差 ≤ `TREND_PREVIEW_MAX_BALANCE_DRIFT_PCT`（默认 **5%**），否则拒绝执行并要求重新预览。  
 6. **首仓**：**立即市价** 开立 **总计划张数 × 50%**（不附带交易所止盈单）。  
 7. **止损**：撤销旧条件单后，挂 **仅止损** 的仓位触发单；之后每次补仓成交会 **刷新** 止损挂单。  
+7b. **手动保本**（可选）：首仓完成且交易所有持仓后，可在运行中计划卡片点击「应用保本止损」——将止损移至 **持仓均价 ± 偏移%**（默认 **+0.3%** 多 / **−0.3%** 空）；仅当新止损 **优于** 当前止损时生效，并同步 Gate 仓位止损单。  
 8. **补仓**：当价格 **穿越** 下一档触发价（做多为自上向下穿越，做空为自下向上穿越）时，按该档张数 **市价加仓**；直至 `N` 档执行完毕或计划结束。  
 9. **止盈监控**：后台线程若发现价格触及止盈，则 **市价全平**。  
 10. **止损触发**：若仓位被交易所止损打光，本地检测到 **持仓为 0** 后记账为 **止损** 并结束计划。  
@@ -58,7 +65,8 @@
   - 每行提供 **删除**：删除该计划行，并删除 `trade_records` 中 **`trend_plan_id` 与之相同** 且类型为「趋势回调」的记录（用于与计划一一对应的新数据；历史旧行若无 `trend_plan_id` 则不会随删）。  
 - **运行中的计划（交易执行页）**  
   - 在计划摘要下方展示 **浮盈亏（交易所）**：来自 Gate 当前持仓接口的 **未实现盈亏**（及标记价，若可得）；与本地按均价估算可能略有差异，以交易所为准便于对照。  
-  - **补仓边界**按方向显示「补仓上沿」或「补仓下沿」（数值仍为 `add_upper` 字段）。
+  - **补仓边界**按方向显示「补仓上沿」或「补仓下沿」（数值仍为 `add_upper` 字段）。  
+  - **手动保本**：表单可改偏移 %（默认见 `TREND_PULLBACK_MANUAL_BREAKEVEN_OFFSET_PCT`）；成功后显示「已保本」时间与原止损（若与当前不同）。
 
 ### 3.5 交易记录与交易所「已实现盈亏」对齐
 
@@ -78,7 +86,7 @@
 | 开仓 | 单次市价 + 条件止盈+止损 | 首仓 50% 市价 + 多档补仓 + **仅止损在交易所** |
 | 止盈 | 条件单 + 本地监控 | **仅本地监控市价止盈** |
 | 仓位基数 | 以损定仓（表单/会话基数） | **可用余额快照 × 风险比例** 推导 |
-| 移动保本 | 支持 | **不支持**（未实现） |
+| 移动保本 | 支持（按 R 自动上移） | **手动保本**（首仓后有持仓即可点；默认均价 +0.3%，可改偏移；同步 Gate 止损单；**无**自动 R 保本） |
 
 ---
 
@@ -95,6 +103,7 @@
 
 | 变量 | 说明 | 默认 |
 |------|------|------|
+| `TREND_PULLBACK_MANUAL_BREAKEVEN_OFFSET_PCT` | 手动保本默认偏移（相对持仓均价，%） | `0.3` |
 | `TREND_PULLBACK_DCA_LEGS` | 剩余 50% 拆档数量上限 | `5` |
 | `TREND_PULLBACK_PREVIEW_TTL_SECONDS` | 预览有效时间（秒） | `120` |
 | `TREND_PREVIEW_MAX_BALANCE_DRIFT_PCT` | 确认执行时允许「当前可用 / 预览快照」最大相对偏差（%） | `5` |