更新斐波那契md

crypto_monitor_gate/更新文档.md

@@ -14,6 +14,38 @@
 - 标题去掉「5m」；规则条从 `.env` 读取（周期、确认K、量能、自动开仓盈亏比、日成交量排名）。
 - 左列：活跃关键位，**pos-card** 样式展示现价/距上沿/距下沿/门控。
 - 右列：关键位历史（失效/结案），与左列等高滚动。
+- 监控类型新增：**斐波回调0.618**、**斐波回调0.786**（与 Binance 主站同一套规则，计算逻辑见仓库根目录 `fib_key_monitor_lib.py`）。
+
+### 斐波关键位监控（方案 A：交易所限价）
+
+| 项 | 说明 |
+|----|------|
+| 同币互斥 | 每个币种只能有一条斐波监控（0.618 与 0.786 不可并存） |
+| 上下沿 | 上沿 **H**、下沿 **L**（须 H > L） |
+| 挂单价 E | `E = L + ratio × (H − L)`（0.618 或 0.786） |
+| 做多 | 限价 @ E，止损 L，止盈 H |
+| 做空 | 限价 @ E，止损 H，止盈 L |
+| 添加后 | **立即**在 Gate 挂限价单；卡片显示 **挂E**、限价单 ID |
+| 失效 | 以**标记价**判断：做多且标记价 ≥ H、做空且标记价 ≤ L，且限价**未成交** → 撤销该限价单并结案（不写历史开仓） |
+| 成交后 | 按仓位挂交易所 TP/SL → 写入 **实盘下单监控**（`monitor_type=关键位监控`，`key_signal_type=斐波回调0.618/0.786`）→ 从关键位列表移除 |
+| 撤单 | 仅撤本条斐波的 `fib_limit_order_id`，**不会** `cancel_all`，避免误伤其他委托 |
+| 盈亏比 | 计划 RR 须 > `KEY_AUTO_MIN_PLANNED_RR`（与箱体/收敛一致）；0.618 理论约 1.6:1，0.786 约 3.7:1 |
+| 日成交量 | 与箱体/收敛相同，须在前 `KEY_DAILY_VOLUME_RANK_MAX` 名内方可添加 |
+
+后台轮询：`check_fib_key_monitors()`（标记价失效 / 成交检测）；箱体/收敛仍走 `check_key_monitors()`，互不干扰。
+
+手动删除关键位时，若斐波限价尚未成交，会先撤交易所限价再删库记录。
+
+### 箱体 / 收敛自动开仓（来源标注）
+
+- 自动开仓写入 `order_monitors.key_signal_type`：`箱体突破` 或 `收敛突破`。
+- 持仓卡片、交易记录列表会显示「来源 · 信号类型」。
+
+## 交易记录与复盘
+
+- 平仓记录可同步交易所已实现盈亏（Gate 仓位历史等）；列表盈亏列优先显示交易所数据，标注 **所** / **估**。
+- 记录页提供 **立即同步**（`POST /api/sync_exchange_pnl`），用于补全或刷新 `exchange_realized_pnl` 等字段。
+- 未做人工复盘时，展示以交易所盈亏为准（有同步数据时）。
 
 ## 实盘下单页
 
@@ -36,9 +68,16 @@
 - 定时：`scripts/install_backup_cron.sh` → 每天 **北京时间 0:00**，目录 **`/root/backups/<实例名>/YYYY-MM-DD/`**，保留 **30** 天
 - 详见 `部署文档.md` 第 5.3 节
 
+## 数据库（启动时自动迁移）
+
+`key_monitors` 新增斐波字段（示例）：`fib_limit_order_id`、`fib_entry_price`、`fib_stop_loss`、`fib_take_profit`、`fib_order_amount`、`fib_margin_capital`、`fib_leverage`。
+
+`trade_records` / `order_monitors` 新增或沿用：`key_signal_type`、`exchange_realized_pnl`、`exchange_opened_at`、`exchange_closed_at`、`exchange_sync_key`。
+
 ## 升级步骤
 
 1. `git pull` 后对比 `.env.example`，把新增变量合并进本地 `.env`。
 2. 在 VPS 上为 Binance / Gate / Gate Bot **各执行一次** `bash scripts/install_backup_cron.sh`（若尚未安装）。
-3. 重启 Gate 实例服务（如 `pm2 restart`）。
+3. 重启 Gate 实例服务（如 `pm2 restart crypto_gate`）；首次启动会自动 `ALTER TABLE` 斐波与交易所盈亏相关列。
 4. 浏览器强刷（Ctrl+F5）避免旧版 `index.html` 缓存。
+5. 建议在测试币上先添加一条斐波监控，确认：限价已挂出、标记价失效会撤单、成交后出现持仓监控且 TP/SL 已挂上。