# 界面与风控更新说明（Binance 实例）

## 顶栏导航（4 项）

| 顺序 | 名称 | 路由 | 说明 |
|------|------|------|------|
| 1 | 关键位监控 | `/key_monitor` | 关键位添加、实时门控、历史 |
| 2 | 实盘下单 | `/trade` | 人工开仓、划转、实时持仓（**默认首页** `/` → `/trade`） |
| 3 | 交易记录与复盘 | `/records` | 未改动 |
| 4 | 统计分析 | `/stats` | 未改动 |

## 关键位监控页

- 标题去掉「5m」；规则条从 `.env` 读取（周期、确认K、量能、自动开仓盈亏比、日成交量排名）。
- 左列：活跃关键位，**pos-card** 样式展示现价/距上沿/距下沿/门控。
- 右列：关键位历史（失效/结案），与左列等高滚动。
- 监控类型新增：**斐波回调0.618**、**斐波回调0.786**（与 Gate 主站同一套规则，计算逻辑见仓库根目录 `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 |
| 添加后 | **立即**在 Binance U 本位挂限价单；卡片显示 **挂E**、限价单 ID |
| 失效 | 以**标记价**判断：做多且标记价 ≥ H、做空且标记价 ≤ L，且限价**未成交** → 撤销该限价单并结案 |
| 成交后 | 挂交易所 TP/SL（含 Algo 通道条件单）→ 写入 **实盘下单监控**（`monitor_type=关键位监控`，`key_signal_type=斐波回调…`）→ 从关键位列表移除 |
| 撤单 | 仅撤本条斐波的订单 ID，**不会**对该合约 `cancel_all_orders` / 全撤 Algo，避免误伤其他委托 |
| 盈亏比 | 计划 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`：`箱体突破` 或 `收敛突破`。
- 持仓与交易记录展示「来源 · 信号类型」。

## 交易记录与复盘

- 支持从交易所收入流水等同步已实现盈亏；盈亏列标注 **所** / **估**。
- 记录页 **立即同步**（`POST /api/sync_exchange_pnl`）。
- 未人工复盘时优先展示交易所盈亏（已同步时）。

## 实盘下单页

- 左列：实盘下单监控（表单、划转、规则）。
- 右列：实时持仓（独立模块）。
- **人工开仓门控**：计划盈亏比 < `MANUAL_MIN_PLANNED_RR`（默认 **1.4**）时前端弹窗 + 后端拒绝。

## 持仓与计仓

- `MAX_ACTIVE_POSITIONS` 默认 **1**（可在 `.env` 调大）。
- 关键位自动开仓：在已有持仓时，若 `KEY_SIZING_USE_ZERO_POSITION_SNAPSHOT=true`，按**首笔开仓前**交易账户资金快照计仓（字段 `trading_sessions.key_sizing_capital_snapshot`）。

## 配置

详见 `.env.example` 中「关键位门控」「交易执行 / 人工风控」注释段。

## 自动备份（服务器）

- 脚本：`scripts/backup_data.sh`（`crypto.db` + `static/images`）
- 定时：`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. 重启 Binance 实例（如 `pm2 restart crypto_binance`）；SQLite 会自动 `ALTER` 新列。
4. 浏览器强刷（Ctrl+F5）避免旧版 `index.html` 缓存。
5. 建议先用测试币验证斐波：限价挂出、标记价失效撤单、成交后 TP/SL 与订单监控是否正常。